react-hooks-global-states 15.0.6 → 15.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-hooks-global-states",
-  "version": "15.0.6",
+  "version": "15.0.8",
   "description": "This is a package to easily handling global-state across your react-components using hooks.",
   "main": "./bundle.js",
   "types": "./index.d.ts",
@@ -143,8 +143,8 @@
   },
   "peerDependencies": {
     "json-storage-formatter": "^3.0.2",
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
   },
   "peerDependenciesMeta": {
     "react": {

package/uniqueId.d.ts

@@ -1,31 +1,76 @@
+export declare const __brand: unique symbol;
 /**
- * A branded unique identifier type
+ * Branded unique identifier
  */
 export type BrandedId<T extends string | undefined> = `${T extends string ? T : ''}${string}` & {
-    __brand: T;
+    [__brand]: T;
 };
-/**
- * Generates a unique identifier string, optionally prefixed.
- * @param prefix - Optional string to prefix the unique ID
- * @returns A unique identifier string
- *
- * @example
- * uniqueId(); // e.g., "k9j3n5x8q2"
- * uniqueId('user:'); // e.g., "user:k9j3n5x8q2"
- *
- * // Creating a reusable unique ID generator for a specific prefix
- * const makeOrderId = uniqueId.for('order:');
- * makeOrderId(); // e.g., "order:k9j3n5x8q2"
- * makeOrderId.assert('order:k9j3n5x8q2'); // true
- * makeOrderId.assert('user:k9j3n5x8q2
- */
-export declare const uniqueId: {
+interface UniqueId {
+    /**
+     * Generates a unique identifier string, optionally prefixed.
+     *
+     * @example
+     * uniqueId();           // "k9j3n5x8q2"
+     * type Id1 = `${string}` & { [__brand]: undefined };
+     *
+     * uniqueId('user:');    // "user:k9j3n5x8q2"
+     * type Id2 = `user:${string}` & { [__brand]: 'user:' };
+     */
     <T extends string | undefined>(prefix?: T): BrandedId<T>;
+    /**
+     * Creates a reusable unique ID generator for a specific prefix.
+     *
+     * @example
+     * const makeOrderId = uniqueId.for('order:');
+     * const id = makeOrderId(); // "order:k9j3n5x8q2"
+     * type OrderId = `order:${string}` & { [__brand]: 'order:' };
+     */
     for<T extends string>(prefix: T): {
-        (): BrandedId<T>;
-        is(value: unknown): value is BrandedId<T>;
-        assert(value: unknown): asserts value is BrandedId<T>;
+        (): `${T}${string}` & {
+            [__brand]: T;
+        };
+        /**
+         * Checks if the given value matches the branded ID for this prefix.
+         */
+        is(value: unknown): value is `${T}${string}` & {
+            [__brand]: T;
+        };
+        /**
+         * Asserts that the value matches this branded ID, throws otherwise.
+         */
+        assert(value: unknown): asserts value is `${T}${string}` & {
+            [__brand]: T;
+        };
+        /**
+         * Returns a strictly branded generator using a custom symbol brand.
+         */
+        strict<Brand extends symbol>(): {
+            (): `${T}${string}` & {
+                [__brand]: Brand;
+            };
+            is(value: unknown): value is `${T}${string}` & {
+                [__brand]: Brand;
+            };
+            assert(value: unknown): asserts value is `${T}${string}` & {
+                [__brand]: Brand;
+            };
+        };
     };
-    of<T extends string>(): () => BrandedId<T>;
-};
+    /**
+     * Creates a reusable unique ID generator without a prefix.
+     */
+    of<T extends string>(): () => string & {
+        [__brand]: T;
+    };
+    /**
+     * Creates a strictly branded unique ID generator without a prefix.
+     */
+    strict<Brand extends symbol>(): () => string & {
+        [__brand]: Brand;
+    };
+}
+/**
+ * Generates a unique identifier string, optionally prefixed.
+ */
+export declare const uniqueId: UniqueId;
 export default uniqueId;

package/uniqueId.js

@@ -1 +1 @@
-var t;t=()=>(()=>{"use strict";var t={};return((t,e)=>{var r,n,o;Object.defineProperty(e,"__esModule",{value:!0}),e.uniqueId=void 0,e.uniqueId=(r=0,n=function(t,e){return t+Date.now().toString(36)+e.toString(36)},(o=function(t){return r===Number.MAX_SAFE_INTEGER&&(r=0),n(t,r++)}).for=function(t){var e=0,r=function(){return e===Number.MAX_SAFE_INTEGER&&(e=0),n(t,e++)};return r.is=function(e){return"string"==typeof e&&e.startsWith(t)},r.assert=function(e){if(!r.is(e))throw new Error('The value "'.concat(String(e),'" does not match the expected prefix "').concat(String(t),'"'))},r},o.of=function(){return function(){return o()}},o),e.default=e.uniqueId})(0,t),t})(),"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["react-hooks-global-states"]=t():this["react-hooks-global-states"]=t();
+var t;t=()=>(()=>{"use strict";var t={};return((t,e)=>{var n,r,o,u;Object.defineProperty(e,"__esModule",{value:!0}),e.uniqueId=void 0,e.uniqueId=(n=0,r=function(){return n===Number.MAX_SAFE_INTEGER&&(n=0),n++},o=function(t,e){return(null!=t?t:"")+Date.now().toString(36)+e.toString(36)},(u=function(t){return o(t,r())}).for=function(t){var e=function(){return o(t,r())};return e.is=function(e){return"string"==typeof e&&e.startsWith(t)},e.assert=function(n){if(!e.is(n))throw new Error('The value "'.concat(String(n),'" does not match the expected prefix "').concat(String(t),'"'))},e.strict=function(){return e},e},u.of=function(){return u.for("")},u.strict=function(){return u},u),e.default=e.uniqueId})(0,t),t})(),"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["react-hooks-global-states"]=t():this["react-hooks-global-states"]=t();