@gershy/clearing 0.0.8 → 0.0.10

package/cmp/cjs/main.js

@@ -9,7 +9,7 @@ const applyClearing = (() => {
         return;
     global[memSym] = true;
     const symNames = [
-        // <SYMBOLS>
+        // <SYMBOLS> :: definitions :: /[']([a-zA-Z0-9]+)[']/
         'add',
         'allArr',
         'allObj',

package/cmp/mjs/main.js

@@ -7,7 +7,7 @@ const applyClearing = (() => {
         return;
     global[memSym] = true;
     const symNames = [
-        // <SYMBOLS>
+        // <SYMBOLS> :: definitions :: /[']([a-zA-Z0-9]+)[']/
         'add',
         'allArr',
         'allObj',

package/cmp/types/global.d.ts

@@ -63,7 +63,7 @@ declare global {
     
   };
   
-  // <SYMBOLS>
+  // <SYMBOLS> :: declarations :: /const ([a-zA-Z0-9]+)[ ]*[:][ ]*unique symbol;/
   const add:       unique symbol;
   const allArr:    unique symbol;
   const allObj:    unique symbol;
@@ -114,10 +114,66 @@ declare global {
   const upper:     unique symbol;
   // </SYMBOLS>
   
+  // Adding symbol properties to Object.prototype will cause typescript to think these properties
+  // are also available for extending types, e.g. Array - to avoid this we merge in an object which
+  // defines every symbol as `undefined`!
+  type SymbolsProto = {
+    // <SYMBOLS> :: SymbolsProto :: /\[([a-zA-Z0-9]+)\][ ]*[:][ ]*undefined
+    [add]:       undefined,
+    [allArr]:    undefined,
+    [allObj]:    undefined,
+    [at]:        undefined,
+    [assert]:    undefined,
+    [base32]:    undefined,
+    [base36]:    undefined,
+    [base62]:    undefined,
+    [base64Std]: undefined,
+    [base64Url]: undefined,
+    [baseline]:  undefined,
+    [bind]:      undefined,
+    [bits]:      undefined,
+    [char]:      undefined,
+    [charset]:   undefined,
+    [code]:      undefined,
+    [count]:     undefined,
+    [cut]:       undefined,
+    [dive]:      undefined,
+    [empty]:     undefined,
+    [find]:      undefined,
+    [fire]:      undefined,
+    [group]:     undefined,
+    [has]:       undefined,
+    [hasHead]:   undefined,
+    [hasTail]:   undefined,
+    [indent]:    undefined,
+    [int32]:     undefined,
+    [int64]:     undefined,
+    [isInt]:     undefined,
+    [later]:     undefined,
+    [limn]:      undefined,
+    [lower]:     undefined,
+    [map]:       undefined,
+    [mapk]:      undefined,
+    [merge]:     undefined,
+    [mod]:       undefined,
+    [padHead]:   undefined,
+    [padTail]:   undefined,
+    [rem]:       undefined,
+    [slash]:     undefined,
+    [slice]:     undefined,
+    [suppress]:  undefined,
+    [toArr]:     undefined,
+    [toNum]:     undefined,
+    [toObj]:     undefined,
+    [toStr]:     undefined,
+    [upper]:     undefined
+    // </SYMBOLS>
+  };
+  
   interface ErrorConstructor {
     [assert]: <V = any>(args: V, fn: (args: V) => boolean) => void
   }
-  interface Error {
+  interface Error extends SymbolsProto {
     [mod]:      (props: { [K: string]: any }) => Error,
     [fire]:     (props?: { [K: string]: any }) => never,
     [suppress]: () => Error,
@@ -130,7 +186,7 @@ declare global {
   }
   
   interface ArrayConstructor {}
-  interface Array<T> {
+  interface Array<T> extends SymbolsProto {
     [has]: (val: unknown) => boolean,
     [map]: <Fn extends (v: T, i: number) => any>(fn: Fn) => Exclude<ReturnType<Fn>, Skip>[],
     [add]: <TT extends T>(val: TT) => TT,
@@ -143,7 +199,7 @@ declare global {
   }
   
   interface FunctionConstructor {}
-  interface Function {
+  interface Function extends SymbolsProto {
     [bind]: <Fn extends (...args: any[]) => any, To>(this: Fn, to: To) => ((...args: Parameters<Fn> extends [ infer A0, ...infer AM ] ? AM : never) => ReturnType<Fn>)
   }
   
@@ -151,7 +207,7 @@ declare global {
     [int32]: number,
     [int64]: number
   }
-  interface Number {
+  interface Number extends SymbolsProto {
     [char]: () => string,
     [isInt]: () => boolean,
     [toStr]: (str: string | CharSet, len?: number) => string,
@@ -162,7 +218,7 @@ declare global {
   }
   
   interface BigIntConstructor {}
-  interface BigInt {
+  interface BigInt extends SymbolsProto {
     [toStr]: (str: string | CharSet, len?: number) => string
   }
   
@@ -194,7 +250,7 @@ declare global {
   }
   
   interface SetConstructor {}
-  interface Set<T> {
+  interface Set<T> extends SymbolsProto {
     [count]: () => number,
     [empty]: () => boolean,
     [find]: (fn: (val: T) => any) => ({ found: true, val: T } | { found: false, val: null }),
@@ -205,7 +261,7 @@ declare global {
   }
 
   interface MapConstructor {}
-  interface Map<K, V> {
+  interface Map<K, V> extends SymbolsProto {
     [add]: (k: K, v: V) => void,
     [count]: () => number,
     [empty]: () => boolean,
@@ -225,7 +281,7 @@ declare global {
     [baseline]:  (str: string) => string,
     [charset]:   (str: string) => CharSet,
   }
-  interface String {
+  interface String extends SymbolsProto {
     [code]: (ind?: number) => number,
     [count]: () => number,
     [has]: (s: string) => boolean,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gershy/clearing",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "Adds the features you always wish javascript had!",
   "keywords": [
     "clearing",
@@ -17,31 +17,29 @@
   },
   "homepage": "https://github.com/gershy/clearing#readme",
   "license": "ISC",
-  "types": "./cmp/types/global.d.ts",
-  "exports": {
-    ".": {
-      "import": "./cmp/mjs/main.js",
-      "require": "./cmp/cjs/main.js",
-      "types": "./cmp/types/global.d.ts"
-    }
-  },
   "devDependencies": {
     "@types/node": "^24.10.1",
-    "cpx": "^1.5.0",
-    "rimraf": "^6.1.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
   "files": [
     "cmp"
   ],
+  "exports": {
+    ".": {
+      "import": "./cmp/mjs/main.js",
+      "require": "./cmp/cjs/main.js",
+      "types": "./cmp/types/global.d.ts"
+    }
+  },
+  "types": "./cmp/types/global.d.ts",
   "scripts": {
     "test": "npx tsx ./src/main.test.mts",
     "ts.check": "npx tsc --noEmit",
     "build.cjs": "tsc -p ts/tsconfig.cjs.json",
     "build.mjs": "tsc -p ts/tsconfig.mjs.json",
-    "build.types": "cpx src/global.d.ts cmp/types",
-    "build": "rimraf cmp && npm run build.cjs && npm run build.mjs && npm run build.types",
+    "build.types": "node build.js copyGlobalTypes",
+    "build": "node build.js removeCmp && npm run build.cjs && npm run build.mjs && npm run build.types",
     "git.pub": "npm run test && git add --all && git commit -m \"automated\" && git push",
     "npm.login": "npm login",
     "npm.pub": "npm run test && npm run build && npm publish --access public"