@esmalley/ts-utils 6.4.5 → 7.0.0

package/dist/types/Textor.d.ts

@@ -1,4 +1,14 @@
 export declare class Textor {
+    /**
+     * Convert camelCase or PascalCase to kebab-case.
+     *
+     * Used to turn CSS-in-JS property names into real CSS properties, but it is
+     * general purpose.
+     *
+     * @example
+     * Textor.toKebabCase('backgroundColor'); // 'background-color'
+     */
+    static toKebabCase(str: string): string;
     static levenshtein(a: string, b: string): number;
     static toSentenceCase(str: string): string;
     /**

package/dist/types/Textor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Textor.d.ts","sourceRoot":"","sources":["../../src/Textor.ts"],"names":[],"mappings":"AAcA,qBAAa,MAAM;WACH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;WAgCzC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAYjD;;OAEG;WACW,kBAAkB,CAC9B,UAAU,SAAI,EACd,qBAAqB,SAAI,EACzB,cAAc,UAAO,GACpB,MAAM;CA+DV"}
+{"version":3,"file":"Textor.d.ts","sourceRoot":"","sources":["../../src/Textor.ts"],"names":[],"mappings":"AAcA,qBAAa,MAAM;IACjB;;;;;;;;OAQG;WACW,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;WAIhC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;WAqCzC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAYjD;;OAEG;WACW,kBAAkB,CAC9B,UAAU,SAAI,EACd,qBAAqB,SAAI,EACzB,cAAc,UAAO,GACpB,MAAM;CA+DV"}

package/dist/types/Toaster.d.ts

@@ -8,10 +8,35 @@ export type ToastListener = (toasts: ToastItem[]) => void;
 export declare class Toaster {
     private listeners;
     private toasts;
+    private nextId;
+    static readonly EXIT_ANIMATION_MS = 500;
+    static readonly AUTO_DISMISS_MS = 4000;
+    /**
+     * The current toasts.
+     *
+     * Returns a copy, so callers cannot mutate the internal list.
+     */
+    getToasts(): ToastItem[];
     subscribe(listener: ToastListener): () => void;
     notify(): void;
+    /**
+     * Start a toast's exit: flag it so the UI can animate, then drop it once the
+     * animation has had time to play.
+     *
+     * Calling this twice for the same toast does not schedule a second removal.
+     */
     requestClose(id: number): void;
-    add(message: string, type?: string): void;
+    /**
+     * Add a toast and return its id, so callers can dismiss it early.
+     */
+    add(message: string, type?: string): number;
+    /**
+     * Remove a toast immediately, without waiting for an exit animation.
+     *
+     * Removing an id that is not present is silent: it broadcasts nothing, so a
+     * consumer that has already removed the toast itself does not get a
+     * redundant re-render from the safety-net removal in `requestClose`.
+     */
     remove(id: number): void;
 }
 export declare const toaster: Toaster;

package/dist/types/Toaster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toaster.d.ts","sourceRoot":"","sources":["../../src/Toaster.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;AAE1D,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAuB;IAExC,OAAO,CAAC,MAAM,CAAmB;IAGjC,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAO9C,MAAM,IAAI,IAAI;IAId,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAU9B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAS,GAAG,IAAI;IAWzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAIzB;AAED,eAAO,MAAM,OAAO,EAAE,OAAuB,CAAC;AAE9C,eAAO,MAAM,KAAK,EAAE;IAClB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAKhC,CAAC"}
+{"version":3,"file":"Toaster.d.ts","sourceRoot":"","sources":["../../src/Toaster.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;AAE1D,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAuB;IAExC,OAAO,CAAC,MAAM,CAAmB;IAKjC,OAAO,CAAC,MAAM,CAAK;IAInB,gBAAuB,iBAAiB,OAAO;IAG/C,gBAAuB,eAAe,QAAQ;IAE9C;;;;OAIG;IACH,SAAS,IAAI,SAAS,EAAE;IAKxB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAO9C,MAAM,IAAI,IAAI;IAId;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAyB9B;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAS,GAAG,MAAM;IAc3C;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAUzB;AAED,eAAO,MAAM,OAAO,EAAE,OAAuB,CAAC;AAE9C,eAAO,MAAM,KAAK,EAAE;IAClB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAKhC,CAAC"}

package/dist/types/UuidService.d.ts

@@ -4,16 +4,23 @@
 declare class UuidService {
     private lastTimestamp;
     private seqCounter;
+    /**
+     * Whether a string is a well-formed UUID, dashed or bare.
+     *
+     * @example
+     * uuidService.isValid('01234567-89ab-7cde-8f01-23456789abcd'); // true
+     */
+    isValid(uuid: string): boolean;
     private getRandomBytes;
     generateUUIDv7Bytes(): Uint8Array;
     /**
      * Convert a UUID string to binary Uint8Array
      */
-    static uuidToBin(uuid: string): Uint8Array;
+    uuidToBin(uuid: string): Uint8Array;
     /**
      * Convert binary Uint8Array/Buffer to formatted UUID string
      */
-    static binToUuid(buffer: Uint8Array): string;
+    binToUuid(buffer: Uint8Array): string;
 }
 export declare const uuidService: UuidService;
 export {};

package/dist/types/UuidService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UuidService.d.ts","sourceRoot":"","sources":["../../src/UuidService.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,cAAM,WAAW;IACf,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO,CAAC,cAAc;IAUf,mBAAmB,IAAI,UAAU;IAiDxC;;OAEG;WACW,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAWjD;;OAEG;WACW,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;CAQpD;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC"}
+{"version":3,"file":"UuidService.d.ts","sourceRoot":"","sources":["../../src/UuidService.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,cAAM,WAAW;IACf,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,UAAU,CAAK;IAEvB;;;;;OAKG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC,OAAO,CAAC,cAAc;IAUf,mBAAmB,IAAI,UAAU;IAiDxC;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAkB1C;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;CAW7C;AAED,eAAO,MAAM,WAAW,EAAE,WAA+B,CAAC"}

package/dist/types/index.d.ts

@@ -6,9 +6,11 @@ export * from './Dates.js';
 export * from './Kontororu/Socket.js';
 export * from './Kontororu/Store.js';
 export * from './Kontororu.js';
+export * from './Numbers.js';
 export * from './Objector.js';
 export * from './Sorter.js';
 export * from './Style.js';
+export * from './Tasker.js';
 export * from './Textor.js';
 export * from './Theme.js';
 export * from './Timezones.js';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esmalley/ts-utils",
-  "version": "6.4.5",
+  "version": "7.0.0",
   "description": "A modular collection of TypeScript utilities for modern web development.",
   "private": false,
   "type": "module",
@@ -10,13 +10,17 @@
     "dist"
   ],
   "scripts": {
-    "clean": "rm -rf dist",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "prebuild": "node scripts/generate-tz.js && node scripts/generate-exports.js",
     "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist/types",
     "build:js": "node build.mjs",
     "build": "npm run clean && npm run build:types && npm run build:js && npm run fix:cjs",
     "fix:cjs": "node -e \"require('fs').writeFileSync('dist/cjs/package.json', JSON.stringify({type:'commonjs'}))\"",
+    "typecheck": "tsc --noEmit",
+    "pretest": "npm run typecheck",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "bench": "node bench/run.js",
+    "bench:save": "node bench/run.js --save",
     "prepublishOnly": "npm run build",
     "publish:jsr": "node scripts/jsr-config.js && npx jsr publish --allow-dirty"
   },
@@ -64,6 +68,7 @@
     "eslint-plugin-react": "^7.37.3",
     "eslint-plugin-react-hooks": "^5.1.0",
     "globals": "^16.0.0",
+    "tinybench": "^6.2.0",
     "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
     "typescript": "^5.5.3",