feat(dedupe): new package

packages/dedupe/README.md

@@ -0,0 +1,11 @@
+# Dedupe
+
+A global package manager for defining and managing package versions across different parts of applications to prevent version conflicts.
+
+## Example usage
+
+```ts
+import {definePackage} from '@alwatr/dedupe';
+
+definePackage('@alwatr/logger', '2.0.0');
+```

packages/dedupe/demo/dedupe.mjs

@@ -0,0 +1,14 @@
+import {definePackage, definedPackageList} from '@alwatr/dedupe';
+
+// Must throw an error
+
+console.log('define test1 package')
+definePackage('@scope/test1');
+
+console.log('define test2 package')
+definePackage('@scope/test2', 'v1.0.0');
+
+console.log('definedPackageList:', definedPackageList)
+
+console.log('redefine test2 package')
+definePackage('@scope/test2');

packages/dedupe/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@alwatr/dedupe",
+  "version": "2.4.1",
+  "description": "A global package manager for defining and managing package versions across different parts of applications to prevent version conflicts.",
+  "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
+  "keywords": [
+    "dedupe",
+    "define-package",
+    "deduplicate",
+    "package",
+    "cross-platform",
+    "ECMAScript",
+    "typescript",
+    "javascript",
+    "node",
+    "nodejs",
+    "esm",
+    "module",
+    "utility",
+    "util",
+    "utils",
+    "nanolib",
+    "alwatr"
+  ],
+  "type": "module",
+  "main": "./dist/main.cjs",
+  "module": "./dist/main.mjs",
+  "types": "./dist/main.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/main.mjs",
+      "require": "./dist/main.cjs",
+      "types": "./dist/main.d.ts"
+    }
+  },
+  "license": "MIT",
+  "files": [
+    "**/*.{js,mjs,cjs,map,d.ts,html,md}",
+    "!demo/**/*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Alwatr/nanolib",
+    "directory": "packages/dedupe"
+  },
+  "homepage": "https://github.com/Alwatr/nanolib/tree/next/packages/dedupe#readme",
+  "bugs": {
+    "url": "https://github.com/Alwatr/nanolib/issues"
+  },
+  "prettier": "@alwatr/prettier-config",
+  "scripts": {
+    "b": "yarn run build",
+    "w": "yarn run watch",
+    "c": "yarn run clean",
+    "cb": "yarn run clean && yarn run build",
+    "d": "yarn run build:es && DEBUG=1 yarn node",
+    "build": "yarn run build:ts & yarn run build:es",
+    "build:es": "nano-build --preset=module",
+    "build:ts": "tsc --build",
+    "watch": "yarn run watch:ts & yarn run watch:es",
+    "watch:es": "yarn run build:es --watch",
+    "watch:ts": "yarn run build:ts --watch --preserveWatchOutput",
+    "clean": "rm -rfv dist *.tsbuildinfo"
+  },
+  "devDependencies": {
+    "@alwatr/nano-build": "workspace:^",
+    "@alwatr/prettier-config": "workspace:^",
+    "@alwatr/tsconfig-base": "workspace:^",
+    "@alwatr/type-helper": "workspace:^",
+    "@types/node": "^20.10.6",
+    "typescript": "^5.3.3"
+  }
+}

packages/dedupe/src/main.ts

@@ -0,0 +1,37 @@
+import type {Dictionary} from '@alwatr/type-helper'
+
+declare global {
+  // eslint-disable-next-line no-var
+  var __dedupe__: true;
+
+  // eslint-disable-next-line no-var
+  var __package_version__: string;
+}
+
+if (typeof __dedupe__ !== 'undefined') {
+  throw new Error('duplicate_dedupe');
+}
+
+export const definedPackageList: Dictionary<string> = {};
+
+/**
+ * Global define package for managing package versions to prevent version conflicts.
+ * @param packageName package name including scope. e.g. `@scope/package-name`
+ * @param version package version (optional)
+ *
+ * @example
+ * ```typescript
+ * definePackage('@scope/package-name', '2.0.1');
+ * ```
+ */
+export function definePackage (packageName: string, version = 'v?'): void {
+  if (packageName in definedPackageList) {
+    throw new Error('duplicate_package', {
+      cause: packageName,
+    });
+  }
+
+  definedPackageList[packageName] = version;
+}
+
+definePackage('@alwatr/dedupe', __package_version__);

packages/dedupe/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@alwatr/tsconfig-base/tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "emitDeclarationOnly": true,
+    "composite": true,
+  },
+  "include": ["src/**/*.ts"],
+  "references": []
+}

packages/logger/README.md

@@ -1,4 +1,4 @@
-# Alwatr Logger - `@alwatr/logger`
+# Logger
 
 Fancy colorful console debugger with custom scope written in tiny TypeScript, ES module.
 

packages/logger/package.json

@@ -65,14 +65,15 @@
     "watch:ts": "yarn run build:ts --watch --preserveWatchOutput",
     "clean": "rm -rfv dist *.tsbuildinfo"
   },
+  "dependencies": {
+    "@alwatr/dedupe": "workspace:^",
+    "@alwatr/platform-info": "workspace:^"
+  },
   "devDependencies": {
     "@alwatr/nano-build": "workspace:^",
     "@alwatr/prettier-config": "workspace:^",
     "@alwatr/tsconfig-base": "workspace:^",
     "@types/node": "^20.10.6",
     "typescript": "^5.3.3"
-  },
-  "dependencies": {
-    "@alwatr/platform-info": "workspace:^"
   }
 }

packages/logger/src/main.ts

@@ -1,7 +1,10 @@
+import {definePackage} from '@alwatr/dedupe';
 import {platformInfo} from '@alwatr/platform-info';
 
 import type {AlwatrLogger} from './type.js';
 
+definePackage('@alwatr/dedupe', __package_version__);
+
 export const debugMode = platformInfo.development || platformInfo.isCli
   ? process.env.DEBUG !== undefined && process.env.DEBUG !== ''
   : typeof localStorage !== 'undefined' && localStorage.getItem('debug') === '1';

packages/nano-build/README.md

@@ -43,7 +43,7 @@ Add the following scripts to your `package.json`:
     js: "/* @package_name v@package_version */"
   },
   define: {
-    __package_version: `'@package_version'`,
+    __package_version__: `'@package_version'`,
   },
 }
 ```

packages/nano-build/global.d.ts

@@ -0,0 +1,5 @@
+export {};
+
+declare global {
+  var __package_version__: string;
+}

packages/nano-build/nano-build.cjs

@@ -36,7 +36,7 @@ const defaultOptions = {
     js: '/* ' + packageJson.name + ' v' + packageJson.version + ' */',
   },
   define: {
-    __package_version: `'${packageJson.version}'`,
+    __package_version__: `'${packageJson.version}'`,
   },
 };
 

packages/nano-build/package.json

@@ -24,6 +24,8 @@
   ],
   "type": "commonjs",
   "bin": "./nano-build.cjs",
+  "main": "",
+  "types": "./global.d.ts",
   "license": "MIT",
   "files": [
     "**/*.{js,mjs,cjs,map,d.ts,html,md}",

yarn.lock

@@ -26,6 +26,19 @@ __metadata:
   languageName: unknown
   linkType: soft
 
+"@alwatr/dedupe@workspace:^, @alwatr/dedupe@workspace:packages/dedupe":
+  version: 0.0.0-use.local
+  resolution: "@alwatr/dedupe@workspace:packages/dedupe"
+  dependencies:
+    "@alwatr/nano-build": "workspace:^"
+    "@alwatr/prettier-config": "workspace:^"
+    "@alwatr/tsconfig-base": "workspace:^"
+    "@alwatr/type-helper": "workspace:^"
+    "@types/node": "npm:^20.10.6"
+    typescript: "npm:^5.3.3"
+  languageName: unknown
+  linkType: soft
+
 "@alwatr/deep-clone@workspace:packages/deep-clone":
   version: 0.0.0-use.local
   resolution: "@alwatr/deep-clone@workspace:packages/deep-clone"
@@ -110,6 +123,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "@alwatr/logger@workspace:packages/logger"
   dependencies:
+    "@alwatr/dedupe": "workspace:^"
     "@alwatr/nano-build": "workspace:^"
     "@alwatr/platform-info": "workspace:^"
     "@alwatr/prettier-config": "workspace:^"