@studiometa/js-toolkit 3.5.0 → 3.6.0-beta.1

package/utils/storage/createStorage.js

@@ -0,0 +1,96 @@
+import { hasWindow } from "../has.js";
+import { localStorageProvider } from "./providers.js";
+import { jsonSerializer } from "./serializers.js";
+function createStorage(options = {}) {
+  const { provider = localStorageProvider, serializer = jsonSerializer, prefix = "" } = options;
+  const listeners = /* @__PURE__ */ new Map();
+  function resolveKey(key) {
+    return `${prefix}${key}`;
+  }
+  function syncHandler(event) {
+    if (event instanceof StorageEvent) {
+      if (provider.storageArea && event.storageArea !== provider.storageArea) {
+        return;
+      }
+      const rawKey = event.key;
+      for (const [listenerKey, callbacks] of listeners) {
+        if (resolveKey(listenerKey) === rawKey) {
+          const newValue = event.newValue ? serializer.deserialize(event.newValue) : void 0;
+          callbacks.forEach((callback) => callback(newValue));
+          break;
+        }
+      }
+      return;
+    }
+    listeners.forEach((callbacks, key) => {
+      const value = provider.get(resolveKey(key));
+      const newValue = value !== null ? serializer.deserialize(value) : void 0;
+      callbacks.forEach((callback) => callback(newValue));
+    });
+  }
+  if (hasWindow() && provider.syncEvent) {
+    window.addEventListener(provider.syncEvent, syncHandler);
+  }
+  return {
+    get(key, defaultValue) {
+      const storedValue = provider.get(resolveKey(key));
+      if (storedValue !== null) {
+        const deserialized = serializer.deserialize(storedValue);
+        if (deserialized !== void 0) {
+          return deserialized;
+        }
+      }
+      return defaultValue;
+    },
+    set(key, value) {
+      provider.set(resolveKey(key), serializer.serialize(value));
+      listeners.get(key)?.forEach((callback) => callback(value));
+    },
+    delete(key) {
+      provider.remove(resolveKey(key));
+      listeners.get(key)?.forEach((callback) => callback(void 0));
+    },
+    has(key) {
+      return provider.has(resolveKey(key));
+    },
+    keys() {
+      const allKeys = provider.keys();
+      if (!prefix) {
+        return allKeys;
+      }
+      return allKeys.filter((key) => key.startsWith(prefix)).map((key) => key.slice(prefix.length));
+    },
+    clear() {
+      if (prefix) {
+        provider.keys().filter((key) => key.startsWith(prefix)).forEach((key) => provider.remove(key));
+      } else {
+        provider.clear();
+      }
+      listeners.forEach((callbacks) => {
+        callbacks.forEach((callback) => callback(void 0));
+      });
+    },
+    subscribe(key, callback) {
+      if (!listeners.has(key)) {
+        listeners.set(key, /* @__PURE__ */ new Set());
+      }
+      listeners.get(key)?.add(callback);
+      return () => {
+        listeners.get(key)?.delete(callback);
+        if (listeners.get(key)?.size === 0) {
+          listeners.delete(key);
+        }
+      };
+    },
+    destroy() {
+      listeners.clear();
+      if (hasWindow() && provider.syncEvent) {
+        window.removeEventListener(provider.syncEvent, syncHandler);
+      }
+    }
+  };
+}
+export {
+  createStorage
+};
+//# sourceMappingURL=createStorage.js.map

package/utils/storage/createStorage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/storage/createStorage.ts"],
+  "sourcesContent": ["import { hasWindow } from '../has.js';\nimport { localStorageProvider } from './providers.js';\nimport { jsonSerializer } from './serializers.js';\nimport type { StorageInstance, StorageOptions } from './types.js';\n\nexport function createStorage<T extends Record<string, any> = Record<string, any>>(\n  options: StorageOptions = {},\n): StorageInstance<T> {\n  const { provider = localStorageProvider, serializer = jsonSerializer, prefix = '' } = options;\n\n  const listeners = new Map<keyof T, Set<(value: any) => void>>();\n\n  function resolveKey(key: string): string {\n    return `${prefix}${key}`;\n  }\n\n  function syncHandler(event: Event): void {\n    if (event instanceof StorageEvent) {\n      if (provider.storageArea && event.storageArea !== provider.storageArea) {\n        return;\n      }\n\n      const rawKey = event.key;\n      for (const [listenerKey, callbacks] of listeners) {\n        if (resolveKey(listenerKey as string) === rawKey) {\n          const newValue = event.newValue ? serializer.deserialize(event.newValue) : undefined;\n          callbacks.forEach((callback) => callback(newValue));\n          break;\n        }\n      }\n      return;\n    }\n\n    listeners.forEach((callbacks, key) => {\n      const value = provider.get(resolveKey(key as string));\n      const newValue = value !== null ? serializer.deserialize(value) : undefined;\n      callbacks.forEach((callback) => callback(newValue));\n    });\n  }\n\n  if (hasWindow() && provider.syncEvent) {\n    window.addEventListener(provider.syncEvent, syncHandler);\n  }\n\n  return {\n    get(key, defaultValue?) {\n      const storedValue = provider.get(resolveKey(key as string));\n      if (storedValue !== null) {\n        const deserialized = serializer.deserialize(storedValue);\n        if (deserialized !== undefined) {\n          return deserialized;\n        }\n      }\n      return defaultValue;\n    },\n    set(key, value) {\n      provider.set(resolveKey(key as string), serializer.serialize(value));\n      listeners.get(key)?.forEach((callback) => callback(value));\n    },\n    delete(key) {\n      provider.remove(resolveKey(key as string));\n      listeners.get(key)?.forEach((callback) => callback(undefined));\n    },\n    has(key) {\n      return provider.has(resolveKey(key as string));\n    },\n    keys() {\n      const allKeys = provider.keys();\n      if (!prefix) {\n        return allKeys as (keyof T)[];\n      }\n\n      return allKeys\n        .filter((key) => key.startsWith(prefix))\n        .map((key) => key.slice(prefix.length) as keyof T);\n    },\n    clear() {\n      if (prefix) {\n        provider\n          .keys()\n          .filter((key) => key.startsWith(prefix))\n          .forEach((key) => provider.remove(key));\n      } else {\n        provider.clear();\n      }\n\n      listeners.forEach((callbacks) => {\n        callbacks.forEach((callback) => callback(undefined));\n      });\n    },\n    subscribe(key, callback) {\n      if (!listeners.has(key)) {\n        listeners.set(key, new Set());\n      }\n\n      listeners.get(key)?.add(callback);\n\n      return () => {\n        listeners.get(key)?.delete(callback);\n        if (listeners.get(key)?.size === 0) {\n          listeners.delete(key);\n        }\n      };\n    },\n    destroy() {\n      listeners.clear();\n      if (hasWindow() && provider.syncEvent) {\n        window.removeEventListener(provider.syncEvent, syncHandler);\n      }\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/utils/storage/createUrlSearchParamsInHashProvider.d.ts

@@ -0,0 +1,2 @@
+import type { StorageProvider, UrlProviderOptions } from './types.js';
+export declare function createUrlSearchParamsInHashProvider(options?: UrlProviderOptions): StorageProvider;

package/utils/storage/createUrlSearchParamsInHashProvider.js

@@ -0,0 +1,57 @@
+import { createNoopProvider } from "./createNoopProvider.js";
+import { getBrowserContext } from "./getBrowserContext.js";
+function createUrlSearchParamsInHashProvider(options = {}) {
+  const browserContext = getBrowserContext();
+  if (!browserContext) {
+    return createNoopProvider();
+  }
+  const { push = false } = options;
+  const { location, history } = browserContext;
+  function getParamsFromHash() {
+    return new URLSearchParams(location.hash.slice(1));
+  }
+  return {
+    syncEvent: "hashchange",
+    get(key) {
+      return getParamsFromHash().get(key);
+    },
+    set(key, value) {
+      const params = getParamsFromHash();
+      params.set(key, value);
+      const newHash = params.toString();
+      if (push) {
+        location.hash = newHash;
+      } else {
+        history.replaceState({}, "", `${location.pathname}${location.search}#${newHash}`);
+      }
+    },
+    remove(key) {
+      const params = getParamsFromHash();
+      params.delete(key);
+      const newHash = params.toString();
+      if (push) {
+        location.hash = newHash;
+      } else {
+        const url = newHash ? `${location.pathname}${location.search}#${newHash}` : `${location.pathname}${location.search}`;
+        history.replaceState({}, "", url);
+      }
+    },
+    has(key) {
+      return getParamsFromHash().has(key);
+    },
+    keys() {
+      return [...getParamsFromHash().keys()];
+    },
+    clear() {
+      if (push) {
+        location.hash = "";
+      } else {
+        history.replaceState({}, "", `${location.pathname}${location.search}`);
+      }
+    }
+  };
+}
+export {
+  createUrlSearchParamsInHashProvider
+};
+//# sourceMappingURL=createUrlSearchParamsInHashProvider.js.map

package/utils/storage/createUrlSearchParamsInHashProvider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/storage/createUrlSearchParamsInHashProvider.ts"],
+  "sourcesContent": ["import { createNoopProvider } from './createNoopProvider.js';\nimport { getBrowserContext } from './getBrowserContext.js';\nimport type { StorageProvider, UrlProviderOptions } from './types.js';\n\nexport function createUrlSearchParamsInHashProvider(\n  options: UrlProviderOptions = {},\n): StorageProvider {\n  const browserContext = getBrowserContext();\n\n  if (!browserContext) {\n    return createNoopProvider();\n  }\n\n  const { push = false } = options;\n  const { location, history } = browserContext;\n\n  function getParamsFromHash(): URLSearchParams {\n    return new URLSearchParams(location.hash.slice(1));\n  }\n\n  return {\n    syncEvent: 'hashchange',\n    get(key) {\n      return getParamsFromHash().get(key);\n    },\n    set(key, value) {\n      const params = getParamsFromHash();\n      params.set(key, value);\n      const newHash = params.toString();\n\n      if (push) {\n        location.hash = newHash;\n      } else {\n        history.replaceState({}, '', `${location.pathname}${location.search}#${newHash}`);\n      }\n    },\n    remove(key) {\n      const params = getParamsFromHash();\n      params.delete(key);\n      const newHash = params.toString();\n\n      if (push) {\n        location.hash = newHash;\n      } else {\n        const url = newHash\n          ? `${location.pathname}${location.search}#${newHash}`\n          : `${location.pathname}${location.search}`;\n        history.replaceState({}, '', url);\n      }\n    },\n    has(key) {\n      return getParamsFromHash().has(key);\n    },\n    keys() {\n      return [...getParamsFromHash().keys()];\n    },\n    clear() {\n      if (push) {\n        location.hash = '';\n      } else {\n        history.replaceState({}, '', `${location.pathname}${location.search}`);\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AACnC,SAAS,yBAAyB;AAG3B,SAAS,oCACd,UAA8B,CAAC,GACd;AACjB,QAAM,iBAAiB,kBAAkB;AAEzC,MAAI,CAAC,gBAAgB;AACnB,WAAO,mBAAmB;AAAA,EAC5B;AAEA,QAAM,EAAE,OAAO,MAAM,IAAI;AACzB,QAAM,EAAE,UAAU,QAAQ,IAAI;AAE9B,WAAS,oBAAqC;AAC5C,WAAO,IAAI,gBAAgB,SAAS,KAAK,MAAM,CAAC,CAAC;AAAA,EACnD;AAEA,SAAO;AAAA,IACL,WAAW;AAAA,IACX,IAAI,KAAK;AACP,aAAO,kBAAkB,EAAE,IAAI,GAAG;AAAA,IACpC;AAAA,IACA,IAAI,KAAK,OAAO;AACd,YAAM,SAAS,kBAAkB;AACjC,aAAO,IAAI,KAAK,KAAK;AACrB,YAAM,UAAU,OAAO,SAAS;AAEhC,UAAI,MAAM;AACR,iBAAS,OAAO;AAAA,MAClB,OAAO;AACL,gBAAQ,aAAa,CAAC,GAAG,IAAI,GAAG,SAAS,QAAQ,GAAG,SAAS,MAAM,IAAI,OAAO,EAAE;AAAA,MAClF;AAAA,IACF;AAAA,IACA,OAAO,KAAK;AACV,YAAM,SAAS,kBAAkB;AACjC,aAAO,OAAO,GAAG;AACjB,YAAM,UAAU,OAAO,SAAS;AAEhC,UAAI,MAAM;AACR,iBAAS,OAAO;AAAA,MAClB,OAAO;AACL,cAAM,MAAM,UACR,GAAG,SAAS,QAAQ,GAAG,SAAS,MAAM,IAAI,OAAO,KACjD,GAAG,SAAS,QAAQ,GAAG,SAAS,MAAM;AAC1C,gBAAQ,aAAa,CAAC,GAAG,IAAI,GAAG;AAAA,MAClC;AAAA,IACF;AAAA,IACA,IAAI,KAAK;AACP,aAAO,kBAAkB,EAAE,IAAI,GAAG;AAAA,IACpC;AAAA,IACA,OAAO;AACL,aAAO,CAAC,GAAG,kBAAkB,EAAE,KAAK,CAAC;AAAA,IACvC;AAAA,IACA,QAAQ;AACN,UAAI,MAAM;AACR,iBAAS,OAAO;AAAA,MAClB,OAAO;AACL,gBAAQ,aAAa,CAAC,GAAG,IAAI,GAAG,SAAS,QAAQ,GAAG,SAAS,MAAM,EAAE;AAAA,MACvE;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/utils/storage/createUrlSearchParamsProvider.d.ts

@@ -0,0 +1,2 @@
+import type { StorageProvider, UrlProviderOptions } from './types.js';
+export declare function createUrlSearchParamsProvider(options?: UrlProviderOptions): StorageProvider;

package/utils/storage/createUrlSearchParamsProvider.js

@@ -0,0 +1,41 @@
+import { createNoopProvider } from "./createNoopProvider.js";
+import { getBrowserContext } from "./getBrowserContext.js";
+function createUrlSearchParamsProvider(options = {}) {
+  const browserContext = getBrowserContext();
+  if (!browserContext) {
+    return createNoopProvider();
+  }
+  const { push = false } = options;
+  const method = push ? "pushState" : "replaceState";
+  const { location, history } = browserContext;
+  return {
+    syncEvent: "popstate",
+    get(key) {
+      return new URLSearchParams(location.search).get(key);
+    },
+    set(key, value) {
+      const params = new URLSearchParams(location.search);
+      params.set(key, value);
+      history[method]({}, "", `${location.pathname}?${params.toString()}${location.hash}`);
+    },
+    remove(key) {
+      const params = new URLSearchParams(location.search);
+      params.delete(key);
+      const search = params.toString();
+      history[method]({}, "", `${location.pathname}${search ? `?${search}` : ""}${location.hash}`);
+    },
+    has(key) {
+      return new URLSearchParams(location.search).has(key);
+    },
+    keys() {
+      return [...new URLSearchParams(location.search).keys()];
+    },
+    clear() {
+      history[method]({}, "", `${location.pathname}${location.hash}`);
+    }
+  };
+}
+export {
+  createUrlSearchParamsProvider
+};
+//# sourceMappingURL=createUrlSearchParamsProvider.js.map

package/utils/storage/createUrlSearchParamsProvider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/storage/createUrlSearchParamsProvider.ts"],
+  "sourcesContent": ["import { createNoopProvider } from './createNoopProvider.js';\nimport { getBrowserContext } from './getBrowserContext.js';\nimport type { StorageProvider, UrlProviderOptions } from './types.js';\n\nexport function createUrlSearchParamsProvider(options: UrlProviderOptions = {}): StorageProvider {\n  const browserContext = getBrowserContext();\n\n  if (!browserContext) {\n    return createNoopProvider();\n  }\n\n  const { push = false } = options;\n  const method = push ? 'pushState' : 'replaceState';\n  const { location, history } = browserContext;\n\n  return {\n    syncEvent: 'popstate',\n    get(key) {\n      return new URLSearchParams(location.search).get(key);\n    },\n    set(key, value) {\n      const params = new URLSearchParams(location.search);\n      params.set(key, value);\n      history[method]({}, '', `${location.pathname}?${params.toString()}${location.hash}`);\n    },\n    remove(key) {\n      const params = new URLSearchParams(location.search);\n      params.delete(key);\n      const search = params.toString();\n      history[method]({}, '', `${location.pathname}${search ? `?${search}` : ''}${location.hash}`);\n    },\n    has(key) {\n      return new URLSearchParams(location.search).has(key);\n    },\n    keys() {\n      return [...new URLSearchParams(location.search).keys()];\n    },\n    clear() {\n      history[method]({}, '', `${location.pathname}${location.hash}`);\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AACnC,SAAS,yBAAyB;AAG3B,SAAS,8BAA8B,UAA8B,CAAC,GAAoB;AAC/F,QAAM,iBAAiB,kBAAkB;AAEzC,MAAI,CAAC,gBAAgB;AACnB,WAAO,mBAAmB;AAAA,EAC5B;AAEA,QAAM,EAAE,OAAO,MAAM,IAAI;AACzB,QAAM,SAAS,OAAO,cAAc;AACpC,QAAM,EAAE,UAAU,QAAQ,IAAI;AAE9B,SAAO;AAAA,IACL,WAAW;AAAA,IACX,IAAI,KAAK;AACP,aAAO,IAAI,gBAAgB,SAAS,MAAM,EAAE,IAAI,GAAG;AAAA,IACrD;AAAA,IACA,IAAI,KAAK,OAAO;AACd,YAAM,SAAS,IAAI,gBAAgB,SAAS,MAAM;AAClD,aAAO,IAAI,KAAK,KAAK;AACrB,cAAQ,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,QAAQ,IAAI,OAAO,SAAS,CAAC,GAAG,SAAS,IAAI,EAAE;AAAA,IACrF;AAAA,IACA,OAAO,KAAK;AACV,YAAM,SAAS,IAAI,gBAAgB,SAAS,MAAM;AAClD,aAAO,OAAO,GAAG;AACjB,YAAM,SAAS,OAAO,SAAS;AAC/B,cAAQ,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,QAAQ,GAAG,SAAS,IAAI,MAAM,KAAK,EAAE,GAAG,SAAS,IAAI,EAAE;AAAA,IAC7F;AAAA,IACA,IAAI,KAAK;AACP,aAAO,IAAI,gBAAgB,SAAS,MAAM,EAAE,IAAI,GAAG;AAAA,IACrD;AAAA,IACA,OAAO;AACL,aAAO,CAAC,GAAG,IAAI,gBAAgB,SAAS,MAAM,EAAE,KAAK,CAAC;AAAA,IACxD;AAAA,IACA,QAAQ;AACN,cAAQ,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,QAAQ,GAAG,SAAS,IAAI,EAAE;AAAA,IAChE;AAAA,EACF;AACF;",
+  "names": []
+}

package/utils/storage/getBrowserContext.d.ts

@@ -0,0 +1 @@
+export declare function getBrowserContext(): Pick<Window, 'location' | 'history'> | undefined;

package/utils/storage/getBrowserContext.js

@@ -0,0 +1,17 @@
+function getBrowserContext() {
+  if (typeof globalThis === "undefined" || !("window" in globalThis)) {
+    return void 0;
+  }
+  const { window } = globalThis;
+  if (!window || !window.location || !window.history) {
+    return void 0;
+  }
+  return {
+    location: window.location,
+    history: window.history
+  };
+}
+export {
+  getBrowserContext
+};
+//# sourceMappingURL=getBrowserContext.js.map

package/utils/storage/getBrowserContext.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/storage/getBrowserContext.ts"],
+  "sourcesContent": ["export function getBrowserContext(): Pick<Window, 'location' | 'history'> | undefined {\n  if (typeof globalThis === 'undefined' || !('window' in globalThis)) {\n    return undefined;\n  }\n\n  const { window } = globalThis;\n\n  if (!window || !window.location || !window.history) {\n    return undefined;\n  }\n\n  return {\n    location: window.location,\n    history: window.history,\n  };\n}\n"],
+  "mappings": "AAAO,SAAS,oBAAsE;AACpF,MAAI,OAAO,eAAe,eAAe,EAAE,YAAY,aAAa;AAClE,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,OAAO,IAAI;AAEnB,MAAI,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,OAAO,SAAS;AAClD,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,UAAU,OAAO;AAAA,IACjB,SAAS,OAAO;AAAA,EAClB;AACF;",
+  "names": []
+}

package/utils/storage/getGlobalStorage.d.ts

@@ -0,0 +1 @@
+export declare function getGlobalStorage(name: 'localStorage' | 'sessionStorage'): Storage | undefined;

package/utils/storage/getGlobalStorage.js

@@ -0,0 +1,7 @@
+function getGlobalStorage(name) {
+  return typeof globalThis !== "undefined" && name in globalThis ? globalThis[name] : void 0;
+}
+export {
+  getGlobalStorage
+};
+//# sourceMappingURL=getGlobalStorage.js.map

package/utils/storage/getGlobalStorage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/storage/getGlobalStorage.ts"],
+  "sourcesContent": ["export function getGlobalStorage(name: 'localStorage' | 'sessionStorage'): Storage | undefined {\n  return typeof globalThis !== 'undefined' && name in globalThis ? globalThis[name] : undefined;\n}\n"],
+  "mappings": "AAAO,SAAS,iBAAiB,MAA8D;AAC7F,SAAO,OAAO,eAAe,eAAe,QAAQ,aAAa,WAAW,IAAI,IAAI;AACtF;",
+  "names": []
+}

package/utils/storage/getStorageKeys.d.ts

@@ -0,0 +1 @@
+export declare function getStorageKeys(storage: Storage | undefined): string[];

package/utils/storage/getStorageKeys.js

@@ -0,0 +1,12 @@
+function getStorageKeys(storage) {
+  if (!storage) {
+    return [];
+  }
+  return Array.from({ length: storage.length }, (_, index) => storage.key(index)).filter(
+    (key) => key !== null
+  );
+}
+export {
+  getStorageKeys
+};
+//# sourceMappingURL=getStorageKeys.js.map

package/utils/storage/getStorageKeys.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/storage/getStorageKeys.ts"],
+  "sourcesContent": ["export function getStorageKeys(storage: Storage | undefined): string[] {\n  if (!storage) {\n    return [];\n  }\n\n  return Array.from({ length: storage.length }, (_, index) => storage.key(index)).filter(\n    (key): key is string => key !== null,\n  );\n}\n"],
+  "mappings": "AAAO,SAAS,eAAe,SAAwC;AACrE,MAAI,CAAC,SAAS;AACZ,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,MAAM,KAAK,EAAE,QAAQ,QAAQ,OAAO,GAAG,CAAC,GAAG,UAAU,QAAQ,IAAI,KAAK,CAAC,EAAE;AAAA,IAC9E,CAAC,QAAuB,QAAQ;AAAA,EAClC;AACF;",
+  "names": []
+}

package/utils/storage/index.d.ts

@@ -0,0 +1,8 @@
+export type { StorageInstance, StorageOptions, StorageProvider, StorageSerializer, UrlProviderOptions, } from './types.js';
+export { createLocalStorageProvider, createMemoryStorageProvider, createNoopProvider, createSessionStorageProvider, createUrlSearchParamsInHashProvider, createUrlSearchParamsProvider, localStorageProvider, memoryStorageProvider, sessionStorageProvider, urlSearchParamsInHashProvider, urlSearchParamsProvider, } from './providers.js';
+export { createStorage } from './createStorage.js';
+import type { StorageInstance, StorageOptions, UrlProviderOptions } from './types.js';
+export declare function createLocalStorage<T extends Record<string, any> = Record<string, any>>(options?: Omit<StorageOptions, 'provider'>): StorageInstance<T>;
+export declare function createSessionStorage<T extends Record<string, any> = Record<string, any>>(options?: Omit<StorageOptions, 'provider'>): StorageInstance<T>;
+export declare function createUrlSearchParamsStorage<T extends Record<string, any> = Record<string, any>>(options?: Omit<StorageOptions, 'provider'> & UrlProviderOptions): StorageInstance<T>;
+export declare function createUrlSearchParamsInHashStorage<T extends Record<string, any> = Record<string, any>>(options?: Omit<StorageOptions, 'provider'> & UrlProviderOptions): StorageInstance<T>;

package/utils/storage/index.js

@@ -0,0 +1,62 @@
+import {
+  createLocalStorageProvider,
+  createMemoryStorageProvider,
+  createNoopProvider,
+  createSessionStorageProvider,
+  createUrlSearchParamsInHashProvider,
+  createUrlSearchParamsProvider,
+  localStorageProvider,
+  memoryStorageProvider,
+  sessionStorageProvider,
+  urlSearchParamsInHashProvider,
+  urlSearchParamsProvider
+} from "./providers.js";
+import { createStorage } from "./createStorage.js";
+import { createStorage as createStorage2 } from "./createStorage.js";
+import {
+  createUrlSearchParamsInHashProvider as createUrlSearchParamsInHashProvider2,
+  createUrlSearchParamsProvider as createUrlSearchParamsProvider2,
+  localStorageProvider as localStorageProvider2,
+  sessionStorageProvider as sessionStorageProvider2,
+  urlSearchParamsInHashProvider as urlSearchParamsInHashProvider2,
+  urlSearchParamsProvider as urlSearchParamsProvider2
+} from "./providers.js";
+function createLocalStorage(options) {
+  return createStorage2({ ...options, provider: localStorageProvider2 });
+}
+function createSessionStorage(options) {
+  return createStorage2({ ...options, provider: sessionStorageProvider2 });
+}
+function createUrlSearchParamsStorage(options) {
+  const { push, ...storageOptions } = options ?? {};
+  return createStorage2({
+    ...storageOptions,
+    provider: push ? createUrlSearchParamsProvider2({ push }) : urlSearchParamsProvider2
+  });
+}
+function createUrlSearchParamsInHashStorage(options) {
+  const { push, ...storageOptions } = options ?? {};
+  return createStorage2({
+    ...storageOptions,
+    provider: push ? createUrlSearchParamsInHashProvider2({ push }) : urlSearchParamsInHashProvider2
+  });
+}
+export {
+  createLocalStorage,
+  createLocalStorageProvider,
+  createMemoryStorageProvider,
+  createNoopProvider,
+  createSessionStorage,
+  createSessionStorageProvider,
+  createStorage,
+  createUrlSearchParamsInHashProvider,
+  createUrlSearchParamsInHashStorage,
+  createUrlSearchParamsProvider,
+  createUrlSearchParamsStorage,
+  localStorageProvider,
+  memoryStorageProvider,
+  sessionStorageProvider,
+  urlSearchParamsInHashProvider,
+  urlSearchParamsProvider
+};
+//# sourceMappingURL=index.js.map

package/utils/storage/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/storage/index.ts"],
+  "sourcesContent": ["export type {\n  StorageInstance,\n  StorageOptions,\n  StorageProvider,\n  StorageSerializer,\n  UrlProviderOptions,\n} from './types.js';\n\nexport {\n  createLocalStorageProvider,\n  createMemoryStorageProvider,\n  createNoopProvider,\n  createSessionStorageProvider,\n  createUrlSearchParamsInHashProvider,\n  createUrlSearchParamsProvider,\n  localStorageProvider,\n  memoryStorageProvider,\n  sessionStorageProvider,\n  urlSearchParamsInHashProvider,\n  urlSearchParamsProvider,\n} from './providers.js';\nexport { createStorage } from './createStorage.js';\n\nimport type { StorageInstance, StorageOptions, UrlProviderOptions } from './types.js';\nimport { createStorage } from './createStorage.js';\nimport {\n  createUrlSearchParamsInHashProvider,\n  createUrlSearchParamsProvider,\n  localStorageProvider,\n  sessionStorageProvider,\n  urlSearchParamsInHashProvider,\n  urlSearchParamsProvider,\n} from './providers.js';\n\nexport function createLocalStorage<T extends Record<string, any> = Record<string, any>>(\n  options?: Omit<StorageOptions, 'provider'>,\n): StorageInstance<T> {\n  return createStorage({ ...options, provider: localStorageProvider });\n}\n\nexport function createSessionStorage<T extends Record<string, any> = Record<string, any>>(\n  options?: Omit<StorageOptions, 'provider'>,\n): StorageInstance<T> {\n  return createStorage({ ...options, provider: sessionStorageProvider });\n}\n\nexport function createUrlSearchParamsStorage<T extends Record<string, any> = Record<string, any>>(\n  options?: Omit<StorageOptions, 'provider'> & UrlProviderOptions,\n): StorageInstance<T> {\n  const { push, ...storageOptions } = options ?? {};\n  return createStorage({\n    ...storageOptions,\n    provider: push ? createUrlSearchParamsProvider({ push }) : urlSearchParamsProvider,\n  });\n}\n\nexport function createUrlSearchParamsInHashStorage<\n  T extends Record<string, any> = Record<string, any>,\n>(options?: Omit<StorageOptions, 'provider'> & UrlProviderOptions): StorageInstance<T> {\n  const { push, ...storageOptions } = options ?? {};\n  return createStorage({\n    ...storageOptions,\n    provider: push ? createUrlSearchParamsInHashProvider({ push }) : urlSearchParamsInHashProvider,\n  });\n}\n"],
+  "mappings": "AAQA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,qBAAqB;AAG9B,SAAS,iBAAAA,sBAAqB;AAC9B;AAAA,EACE,uCAAAC;AAAA,EACA,iCAAAC;AAAA,EACA,wBAAAC;AAAA,EACA,0BAAAC;AAAA,EACA,iCAAAC;AAAA,EACA,2BAAAC;AAAA,OACK;AAEA,SAAS,mBACd,SACoB;AACpB,SAAON,eAAc,EAAE,GAAG,SAAS,UAAUG,sBAAqB,CAAC;AACrE;AAEO,SAAS,qBACd,SACoB;AACpB,SAAOH,eAAc,EAAE,GAAG,SAAS,UAAUI,wBAAuB,CAAC;AACvE;AAEO,SAAS,6BACd,SACoB;AACpB,QAAM,EAAE,MAAM,GAAG,eAAe,IAAI,WAAW,CAAC;AAChD,SAAOJ,eAAc;AAAA,IACnB,GAAG;AAAA,IACH,UAAU,OAAOE,+BAA8B,EAAE,KAAK,CAAC,IAAII;AAAA,EAC7D,CAAC;AACH;AAEO,SAAS,mCAEd,SAAqF;AACrF,QAAM,EAAE,MAAM,GAAG,eAAe,IAAI,WAAW,CAAC;AAChD,SAAON,eAAc;AAAA,IACnB,GAAG;AAAA,IACH,UAAU,OAAOC,qCAAoC,EAAE,KAAK,CAAC,IAAII;AAAA,EACnE,CAAC;AACH;",
+  "names": ["createStorage", "createUrlSearchParamsInHashProvider", "createUrlSearchParamsProvider", "localStorageProvider", "sessionStorageProvider", "urlSearchParamsInHashProvider", "urlSearchParamsProvider"]
+}

package/utils/storage/providers.d.ts

@@ -0,0 +1,11 @@
+export { createLocalStorageProvider } from './createLocalStorageProvider.js';
+export { createMemoryStorageProvider } from './createMemoryStorageProvider.js';
+export { createNoopProvider } from './createNoopProvider.js';
+export { createSessionStorageProvider } from './createSessionStorageProvider.js';
+export { createUrlSearchParamsInHashProvider } from './createUrlSearchParamsInHashProvider.js';
+export { createUrlSearchParamsProvider } from './createUrlSearchParamsProvider.js';
+export declare const localStorageProvider: import("./types.js").StorageProvider;
+export declare const memoryStorageProvider: import("./types.js").StorageProvider;
+export declare const sessionStorageProvider: import("./types.js").StorageProvider;
+export declare const urlSearchParamsProvider: import("./types.js").StorageProvider;
+export declare const urlSearchParamsInHashProvider: import("./types.js").StorageProvider;

package/utils/storage/providers.js

@@ -0,0 +1,30 @@
+import { createLocalStorageProvider } from "./createLocalStorageProvider.js";
+import { createMemoryStorageProvider } from "./createMemoryStorageProvider.js";
+import { createSessionStorageProvider } from "./createSessionStorageProvider.js";
+import { createUrlSearchParamsInHashProvider } from "./createUrlSearchParamsInHashProvider.js";
+import { createUrlSearchParamsProvider } from "./createUrlSearchParamsProvider.js";
+import { createLocalStorageProvider as createLocalStorageProvider2 } from "./createLocalStorageProvider.js";
+import { createMemoryStorageProvider as createMemoryStorageProvider2 } from "./createMemoryStorageProvider.js";
+import { createNoopProvider } from "./createNoopProvider.js";
+import { createSessionStorageProvider as createSessionStorageProvider2 } from "./createSessionStorageProvider.js";
+import { createUrlSearchParamsInHashProvider as createUrlSearchParamsInHashProvider2 } from "./createUrlSearchParamsInHashProvider.js";
+import { createUrlSearchParamsProvider as createUrlSearchParamsProvider2 } from "./createUrlSearchParamsProvider.js";
+const localStorageProvider = createLocalStorageProvider();
+const memoryStorageProvider = createMemoryStorageProvider();
+const sessionStorageProvider = createSessionStorageProvider();
+const urlSearchParamsProvider = createUrlSearchParamsProvider();
+const urlSearchParamsInHashProvider = createUrlSearchParamsInHashProvider();
+export {
+  createLocalStorageProvider2 as createLocalStorageProvider,
+  createMemoryStorageProvider2 as createMemoryStorageProvider,
+  createNoopProvider,
+  createSessionStorageProvider2 as createSessionStorageProvider,
+  createUrlSearchParamsInHashProvider2 as createUrlSearchParamsInHashProvider,
+  createUrlSearchParamsProvider2 as createUrlSearchParamsProvider,
+  localStorageProvider,
+  memoryStorageProvider,
+  sessionStorageProvider,
+  urlSearchParamsInHashProvider,
+  urlSearchParamsProvider
+};
+//# sourceMappingURL=providers.js.map

package/utils/storage/providers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/storage/providers.ts"],
+  "sourcesContent": ["import { createLocalStorageProvider } from './createLocalStorageProvider.js';\nimport { createMemoryStorageProvider } from './createMemoryStorageProvider.js';\nimport { createSessionStorageProvider } from './createSessionStorageProvider.js';\nimport { createUrlSearchParamsInHashProvider } from './createUrlSearchParamsInHashProvider.js';\nimport { createUrlSearchParamsProvider } from './createUrlSearchParamsProvider.js';\n\nexport { createLocalStorageProvider } from './createLocalStorageProvider.js';\nexport { createMemoryStorageProvider } from './createMemoryStorageProvider.js';\nexport { createNoopProvider } from './createNoopProvider.js';\nexport { createSessionStorageProvider } from './createSessionStorageProvider.js';\nexport { createUrlSearchParamsInHashProvider } from './createUrlSearchParamsInHashProvider.js';\nexport { createUrlSearchParamsProvider } from './createUrlSearchParamsProvider.js';\n\nexport const localStorageProvider = createLocalStorageProvider();\nexport const memoryStorageProvider = createMemoryStorageProvider();\nexport const sessionStorageProvider = createSessionStorageProvider();\nexport const urlSearchParamsProvider = createUrlSearchParamsProvider();\nexport const urlSearchParamsInHashProvider = createUrlSearchParamsInHashProvider();\n"],
+  "mappings": "AAAA,SAAS,kCAAkC;AAC3C,SAAS,mCAAmC;AAC5C,SAAS,oCAAoC;AAC7C,SAAS,2CAA2C;AACpD,SAAS,qCAAqC;AAE9C,SAAS,8BAAAA,mCAAkC;AAC3C,SAAS,+BAAAC,oCAAmC;AAC5C,SAAS,0BAA0B;AACnC,SAAS,gCAAAC,qCAAoC;AAC7C,SAAS,uCAAAC,4CAA2C;AACpD,SAAS,iCAAAC,sCAAqC;AAEvC,MAAM,uBAAuB,2BAA2B;AACxD,MAAM,wBAAwB,4BAA4B;AAC1D,MAAM,yBAAyB,6BAA6B;AAC5D,MAAM,0BAA0B,8BAA8B;AAC9D,MAAM,gCAAgC,oCAAoC;",
+  "names": ["createLocalStorageProvider", "createMemoryStorageProvider", "createSessionStorageProvider", "createUrlSearchParamsInHashProvider", "createUrlSearchParamsProvider"]
+}

package/utils/storage/serializers.d.ts

@@ -0,0 +1,2 @@
+import type { StorageSerializer } from './types.js';
+export declare const jsonSerializer: StorageSerializer;

package/utils/storage/serializers.js

@@ -0,0 +1,14 @@
+const jsonSerializer = {
+  serialize: (value) => JSON.stringify(value),
+  deserialize: (value) => {
+    try {
+      return JSON.parse(value);
+    } catch {
+      return void 0;
+    }
+  }
+};
+export {
+  jsonSerializer
+};
+//# sourceMappingURL=serializers.js.map

package/utils/storage/serializers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/js-toolkit/utils/storage/serializers.ts"],
+  "sourcesContent": ["import type { StorageSerializer } from './types.js';\n\nexport const jsonSerializer: StorageSerializer = {\n  serialize: <T>(value: T): string => JSON.stringify(value),\n  deserialize: <T>(value: string): T | undefined => {\n    try {\n      return JSON.parse(value);\n    } catch {\n      return undefined;\n    }\n  },\n};\n"],
+  "mappings": "AAEO,MAAM,iBAAoC;AAAA,EAC/C,WAAW,CAAI,UAAqB,KAAK,UAAU,KAAK;AAAA,EACxD,aAAa,CAAI,UAAiC;AAChD,QAAI;AACF,aAAO,KAAK,MAAM,KAAK;AAAA,IACzB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "names": []
+}

package/utils/storage/types.d.ts

@@ -0,0 +1,33 @@
+export interface StorageProvider {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+    has(key: string): boolean;
+    keys(): string[];
+    clear(): void;
+    syncEvent?: string;
+    storageArea?: Storage;
+}
+export interface StorageInstance<T = any> {
+    get<K extends keyof T>(key: K): T[K] | undefined;
+    get<K extends keyof T>(key: K, defaultValue: T[K]): T[K];
+    set<K extends keyof T>(key: K, value: T[K]): void;
+    delete<K extends keyof T>(key: K): void;
+    has<K extends keyof T>(key: K): boolean;
+    keys(): (keyof T)[];
+    clear(): void;
+    subscribe<K extends keyof T>(key: K, callback: (value: T[K] | undefined) => void): () => void;
+    destroy(): void;
+}
+export interface StorageSerializer {
+    serialize: (value: any) => string;
+    deserialize: (value: string) => any;
+}
+export interface StorageOptions {
+    provider?: StorageProvider;
+    serializer?: StorageSerializer;
+    prefix?: string;
+}
+export interface UrlProviderOptions {
+    push?: boolean;
+}

package/utils/storage/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/utils/storage/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/utils/storage.d.ts

@@ -0,0 +1 @@
+export * from './storage/index.js';

package/utils/storage.js

@@ -0,0 +1,2 @@
+export * from "./storage/index.js";
+//# sourceMappingURL=storage.js.map

package/utils/storage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../packages/js-toolkit/utils/storage.ts"],
+  "sourcesContent": ["export * from './storage/index.js';\n"],
+  "mappings": "AAAA,cAAc;",
+  "names": []
+}

package/utils/string/changeCase.d.ts

@@ -1,30 +1,30 @@
 /**
  * Convert a string to lowercase.
  * @link https://js-toolkit.studiometa.dev/utils/string/lowerCase.html
-*/
+ */
 export declare function lowerCase(string: string): string;
 /**
  * Convert a string to UPPERCASE.
  * @link https://js-toolkit.studiometa.dev/utils/string/upperCase.html
-*/
+ */
 export declare function upperCase(string: string): string;
 /**
  * Convert a string to camelCase.
  * @link https://js-toolkit.studiometa.dev/utils/string/camelCase.html
-*/
+ */
 export declare const camelCase: (string: string) => string;
 /**
  * Convert a string to PascalCase.
  * @link https://js-toolkit.studiometa.dev/utils/string/pascalCase.html
-*/
+ */
 export declare const pascalCase: (string: string) => string;
 /**
  * Convert a string to snake_case.
  * @link https://js-toolkit.studiometa.dev/utils/string/snakeCase.html
-*/
+ */
 export declare const snakeCase: (string: string) => string;
 /**
  * Convert a string to dash-case.
  * @link https://js-toolkit.studiometa.dev/utils/string/dashCase.html
-*/
+ */
 export declare const dashCase: (string: string) => string;

package/utils/string/changeCase.js

@@ -12,7 +12,7 @@ function split(value) {
   while (result.charAt(start) === "\0") start++;
   if (start === end) return [];
   while (result.charAt(end - 1) === "\0") end--;
-  return result.slice(start, end).split(/\0/g);
+  return result.slice(start, end).split("\0");
 }
 function delimitedCase(string, delimiter) {
   return split(string).map((word) => lowerCase(word)).join(delimiter);