@nexim/alpine 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.1.4](https://github.com/the-nexim/nanolib/compare/@nexim/alpine@1.1.3...@nexim/alpine@1.1.4) (2025-04-21)
+
+**Note:** Version bump only for package @nexim/alpine
+
+## [1.1.3](https://github.com/the-nexim/nanolib/compare/@nexim/alpine@1.1.2...@nexim/alpine@1.1.3) (2025-01-09)
+
+### Code Refactoring
+
+* update output paths in package.json ([#30](https://github.com/the-nexim/nanolib/issues/30)) ([2e03380](https://github.com/the-nexim/nanolib/commit/2e033802420b65644b2af19d29b9c2c5f06332b0)) by @
+
 ## [1.1.2](https://github.com/the-nexim/nanolib/compare/@nexim/alpine@1.1.1...@nexim/alpine@1.1.2) (2025-01-06)
 
 ### Code Refactoring

package/README.md

@@ -21,101 +21,10 @@ npm install @nexim/alpine
 yarn add @nexim/alpine
 ```
 
-## API
+## Documentation
 
-### alpineStoreGenerator
+Read full documentation [here](./docs/README.md).
 
-Generates an Alpine.js store with a default value.
+## TODO
 
-#### Example Usage
-
-```ts
-import {alpineStoreGenerator} from '@nexim/alpine';
-
-const store = alpineStoreGenerator({
-  name: 'user',
-  defaultValue: {type: 'root'},
-});
-
-console.log(store.type); // Output: root
-```
-
-### AlpineStore
-
-Provides a Alpine.js pure store implementation with logger.
-
-#### Constructor
-
-Creates an instance of `AlpineStore`.
-
-- **config**: The configuration object for the store.
-  - **name**: The name of the store.
-  - **defaultValue**: The default value of the store.
-
-### Properties
-
-- **store**: alpine store proxy.
-
-#### Example Usage
-
-```ts
-import {AlpineStore} from '@nexim/alpine';
-
-const {store} = new AlpineStore({
-  name: 'myStore',
-  defaultValue: {data: 'root'},
-});
-
-console.log(store.data); // Output: { data: 'root' }
-store.data = 'user';
-
-console.log(store.data); // Output: { data: 'user' }
-```
-
-### AlpineStoreWithBackup
-
-Extends `AlpineStore` to add backup and restore functionality with local storage support and expiration handling.
-
-#### Constructor
-
-Creates an instance of `AlpineStoreWithBackup`.
-
-- **config**: The configuration object for the store.
-  - **name**: The name of the store.
-  - **version**: The version of the store.
-  - **defaultValue**: The default value of the store.
-  - **expireDuration**: Optional. The duration after which the store expires.
-
-### Properties
-
-- **store**: alpine store proxy.
-
-#### Methods
-
-- **save()**: Saves the current data to local storage. If the data is null, it clears the stored data. Also updates the expiration time.
-- **clear()**: Clears the local storage and set default value to store.
-
-#### Example Usage
-
-```ts
-import {AlpineStoreWithBackup} from '@nexim/alpine';
-
-const storeWithBackup = new AlpineStoreWithBackup({
-  name: 'myStoreWithBackup',
-  version: 1,
-  defaultValue: {data: 'root'},
-  expireDuration: '1d',
-});
-
-storeWithBackup.store.data = 'user';
-
-storeWithBackup.save();
-console.log(storeWithBackup.store.data); // Output: { data: 'user' }
-
-storeWithBackup.clear();
-console.log(storeWithBackup.store.data); // Output: { data: 'root' }
-```
-
-### TODO
-
-- Analyze [@alwatr/context](https://github.com/Alwatr/flux/tree/next/packages/context) for use here.
+- [ ] Analyze [@alwatr/context](https://github.com/Alwatr/flux/tree/next/packages/context) for use here.

package/dist/main.cjs

@@ -1,4 +1,4 @@
-/* @nexim/alpine v1.1.2 */
+/* @nexim/alpine v1.1.4 */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -39,8 +39,8 @@ module.exports = __toCommonJS(main_exports);
 var import_package_tracer = require("@alwatr/package-tracer");
 
 // src/store/store-generator.ts
-var import_logger = require("@alwatr/logger");
 var import_alpinejs = __toESM(require("alpinejs"), 1);
+var import_logger = require("@alwatr/logger");
 var logger = (0, import_logger.createLogger)("@nexim/alpine");
 function alpineStoreGenerator(config) {
   logger.logMethodArgs?.("alpineStoreGenerator", { config });
@@ -55,9 +55,10 @@ var AlpineStore = class {
   /**
    * Provides a Alpine.js pure store implementation with logger.
    *
-   * @param {AlpineStoreOptions} config - Configuration object.
+   * @param config - Configuration object.
    *
    * @example
+   * ```ts
    * import {AlpineStore} from '@nexim/alpine';
    *
    * const {store} = new AlpineStore({
@@ -68,6 +69,7 @@ var AlpineStore = class {
    *
    * store.data = 'user';
    * console.log(store.data); // Output: { data: 'user' }
+   * ```
    */
   constructor(config) {
     this.logger_ = (0, import_logger2.createLogger)(`${"@nexim/alpine"}:${config.name}`);
@@ -77,16 +79,17 @@ var AlpineStore = class {
 };
 
 // src/store/store-with-backup.ts
-var import_local_storage = require("@alwatr/local-storage");
 var import_parse_duration = require("@alwatr/parse-duration");
+var import_local_storage = require("@alwatr/local-storage");
 var schemaVersion = 1;
 var AlpineStoreWithBackup = class extends AlpineStore {
   /**
    * Provides a Alpine.js store implementation with backup and expiration.
    *
-   * @param {AlpineStoreWithBackupOptions} config__ - Configuration object.
+   * @param config__ - Configuration object.
    *
    * @example
+   * ```ts
    * import {AlpineStoreWithBackup} from '@nexim/alpine';
    *
    * const storeWithBackup = new AlpineStoreWithBackup({
@@ -103,6 +106,7 @@ var AlpineStoreWithBackup = class extends AlpineStore {
    *
    * storeWithBackup.clear();
    * console.log(storeWithBackup.store.data); // Output: { data: 'root' }
+   * ```
    */
   constructor(config__) {
     super(config__);
@@ -111,8 +115,8 @@ var AlpineStoreWithBackup = class extends AlpineStore {
      * Keys for storing data and expire time in local storage with version.
      */
     this.localStorageKey__ = {
-      data: `[${"@nexim/alpine"}:data:sv${schemaVersion}]:${this.config__.name}`,
-      expireTime: `[${"@nexim/alpine"}:expire-time:sv${schemaVersion}]:${this.config__.name}`
+      data: `[${"@nexim/alpine"}:data:sv${schemaVersion.toString()}]:${this.config__.name}`,
+      expireTime: `[${"@nexim/alpine"}:expire-time:sv${schemaVersion.toString()}]:${this.config__.name}`
     };
     if (this.config__.expireDuration != null) {
       this.handleDataExpiration__();
@@ -162,7 +166,7 @@ var AlpineStoreWithBackup = class extends AlpineStore {
    *
    * When data is not found or invalid in local storage, it uses the default value.
    *
-   * FIXME: remove `NonNullable` from <T['data']>, after local storage new version.
+   * FIXME: remove `NonNullable` from `<T['data']>`, after local storage new version.
    */
   load__() {
     this.logger_.logMethod?.("load__");
@@ -186,6 +190,5 @@ var AlpineStoreWithBackup = class extends AlpineStore {
 };
 
 // src/main.ts
-__dev_mode__: import_package_tracer.packageTracer.add("@nexim/alpine", "1.1.2");
-/*! For license information please see main.cjs.LEGAL.txt */
+__dev_mode__: import_package_tracer.packageTracer.add("@nexim/alpine", "1.1.4");
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts", "../src/store/store-generator.ts", "../src/store/store.ts", "../src/store/store-with-backup.ts"],
-  "sourcesContent": ["import {packageTracer} from '@alwatr/package-tracer';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nexport * from './store/store-generator.js';\nexport * from './store/store.js';\nexport * from './store/store-with-backup.js';\n", "import {createLogger} from '@alwatr/logger';\nimport alpine from 'alpinejs';\n\nconst logger = createLogger(__package_name__);\n\n/**\n * alpineStoreGenerator Options.\n *\n * @template T - The type of the default value.\n * @property {string} name - The name of the store.\n * @property {T} defaultValue - The default value of the store.\n */\nexport type AlpineStoreGeneratorOptions<T extends DictionaryReq> = {\n  name: string;\n  defaultValue: T;\n};\n\n/**\n * Generates an Alpine.js store with default value.\n *\n * @template T - The type of the data.\n * @param {AlpineStoreGeneratorOptions} config - The configuration object for the store.\n * @returns {T} - The initialized store instance.\n *\n * @example\n * const store = alpineStoreGenerator({\n *   name: 'user',\n *   defaultValue: {type: 'root'},\n * });\n *\n * console.log(store.type); // Output: root\n *\n * @description\n * This function uses Alpine.js to create a reactive store with a default value.\n * The store is identified by a unique name and can be accessed and manipulated\n * throughout the application. Alpine.js stores provide a simple way to manage\n * data in your application, making it easy to keep your UI in sync with your data.\n *\n * @see https://alpinejs.dev/globals/alpine-store\n */\nexport function alpineStoreGenerator<T extends DictionaryReq>(config: AlpineStoreGeneratorOptions<T>): T {\n  logger.logMethodArgs?.('alpineStoreGenerator', {config});\n\n  alpine.store(config.name, config.defaultValue);\n\n  // Get store Proxy\n  const store = alpine.store(config.name) as T;\n  return store;\n}\n", "import {type AlwatrLogger, createLogger} from '@alwatr/logger';\n\nimport {alpineStoreGenerator} from './store-generator.js';\n\n/**\n * AlpineStore Options.\n *\n * @template T - The type of the store value.\n * @param {string} name - The name of the store.\n * @param {T} defaultValue - The default value of the store.\n */\nexport type AlpineStoreOptions<T extends DictionaryReq> = {\n  name: string;\n  defaultValue: T;\n};\n\n/**\n * Provides a Alpine.js pure store implementation with logger.\n */\nexport class AlpineStore<T extends DictionaryReq> {\n  /**\n   * The store's data.\n   */\n  store: T;\n\n  protected logger_: AlwatrLogger;\n\n  /**\n   * Provides a Alpine.js pure store implementation with logger.\n   *\n   * @param {AlpineStoreOptions} config - Configuration object.\n   *\n   * @example\n   * import {AlpineStore} from '@nexim/alpine';\n   *\n   * const {store} = new AlpineStore({\n   *   name: 'myStore',\n   *   defaultValue: {data: 'root'},\n   * });\n   * console.log(store.data); // Output: { data: 'root' }\n   *\n   * store.data = 'user';\n   * console.log(store.data); // Output: { data: 'user' }\n   */\n  constructor(config: AlpineStoreOptions<T>) {\n    this.logger_ = createLogger(`${__package_name__}:${config.name}`);\n    this.logger_.logMethodArgs?.('constructor', config);\n\n    this.store = alpineStoreGenerator(config);\n  }\n}\n", "import {localJsonStorage} from '@alwatr/local-storage';\nimport {parseDuration, type Duration} from '@alwatr/parse-duration';\n\nimport {AlpineStore} from './store.js';\n\n/**\n * Type for the store's data to extends from them.\n */\nexport type AlpineStoreWithBackupType = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  data: DictionaryReq<any> | null;\n};\n\n/**\n * AlpineStoreWithBackup Options.\n *\n * @template T - The type of the store value.\n * @param {string} name - The name of the store.\n * @param {number} version - The version of the store.\n * @param {T} defaultValue - The default value of the store.\n * @param {Duration} [expireDuration] - Optional. The duration after which the store expires.\n */\nexport type AlpineStoreWithBackupOptions<T extends AlpineStoreWithBackupType> = {\n  name: string;\n  version: number;\n  defaultValue: T;\n  expireDuration?: Duration;\n};\n\n/**\n * Version of the schema for storing data in local storage.\n *\n * Change when this schema changes.\n */\nconst schemaVersion = 1;\n\n/**\n * Provides a Alpine.js store implementation with backup and expiration.\n */\nexport class AlpineStoreWithBackup<T extends AlpineStoreWithBackupType> extends AlpineStore<T> {\n  /**\n   * Keys for storing data and expire time in local storage with version.\n   */\n  private localStorageKey__ = {\n    data: `[${__package_name__}:data:sv${schemaVersion}]:${this.config__.name}`,\n    expireTime: `[${__package_name__}:expire-time:sv${schemaVersion}]:${this.config__.name}`,\n  };\n\n  /**\n   * Provides a Alpine.js store implementation with backup and expiration.\n   *\n   * @param {AlpineStoreWithBackupOptions} config__ - Configuration object.\n   *\n   * @example\n   * import {AlpineStoreWithBackup} from '@nexim/alpine';\n   *\n   * const storeWithBackup = new AlpineStoreWithBackup({\n   *   name: 'myStoreWithBackup',\n   *   version: 1,\n   *   defaultValue: {data: 'root'},\n   *   expireDuration: '1d',\n   * });\n   *\n   * storeWithBackup.store.data = 'user';\n   *\n   * storeWithBackup.save();\n   * console.log(storeWithBackup.store.data); // Output: { data: 'user' }\n   *\n   * storeWithBackup.clear();\n   * console.log(storeWithBackup.store.data); // Output: { data: 'root' }\n   */\n  constructor(private config__: AlpineStoreWithBackupOptions<T>) {\n    super(config__);\n\n    if (this.config__.expireDuration != null) {\n      this.handleDataExpiration__();\n    }\n\n    this.load__();\n  }\n\n  /**\n   * Saves the current data to local storage. If the data is null, it clears the stored data.\n   *\n   * Also updates the expiration time.\n   */\n  save(): void {\n    this.logger_.logMethodArgs?.('save', {data: this.store.data});\n\n    if (this.store.data === null) {\n      this.clear();\n      return;\n    }\n\n    localJsonStorage.setItem(this.localStorageKey__.data, this.store.data, this.config__.version);\n    this.updateExpireTime__();\n  }\n\n  /**\n   * Clears the stored data.\n   */\n  clear(): void {\n    this.logger_.logMethod?.('clear');\n\n    localJsonStorage.removeItem(this.localStorageKey__.data, this.config__.version);\n    localJsonStorage.removeItem(this.localStorageKey__.expireTime, this.config__.version);\n\n    this.store = this.config__.defaultValue;\n  }\n\n  /**\n   * Handles the expiration duration by checking if the stored data has expired.\n   * If expired, it clears the stored data.\n   */\n  private handleDataExpiration__(): void {\n    this.logger_.logMethod?.('handleDataExpiration__');\n\n    // FIXME: use null if not set, after local storage new version.\n    const expireDuration = localJsonStorage.getItem<{time: number}>(\n      this.localStorageKey__.expireTime,\n      {time: -1},\n      this.config__.version,\n    ).time;\n\n    if (expireDuration !== -1 && expireDuration < Date.now()) {\n      this.clear();\n    }\n  }\n\n  /**\n   * Loads data from local storage and updates the store's data.\n   *\n   * When data is not found or invalid in local storage, it uses the default value.\n   *\n   * FIXME: remove `NonNullable` from <T['data']>, after local storage new version.\n   */\n  private load__(): void {\n    this.logger_.logMethod?.('load__');\n\n    const newData = localJsonStorage.getItem<NonNullable<T['data']>>(\n      this.localStorageKey__.data,\n      this.config__.defaultValue.data as NonNullable<T['data']>,\n      this.config__.version,\n    ) as T['data'];\n    this.store.data = newData;\n  }\n\n  /**\n   * Updates the expiration time in local storage to the current time plus the configured expiration duration.\n   */\n  private updateExpireTime__(): void {\n    if (this.config__.expireDuration == null) return;\n    this.logger_.logMethod?.('updateExpireTime__');\n\n    const newExpireTime = Date.now() + parseDuration(this.config__.expireDuration);\n    localJsonStorage.setItem(this.localStorageKey__.expireTime, {time: newExpireTime}, this.config__.version);\n\n    this.logger_.logOther?.('updated_expire_time', {newExpireTime});\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { packageTracer } from '@alwatr/package-tracer';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nexport * from './store/store-generator.js';\nexport * from './store/store.js';\nexport * from './store/store-with-backup.js';\n", "import alpine from 'alpinejs';\nimport { createLogger } from '@alwatr/logger';\n\nconst logger = createLogger(__package_name__);\n\n/**\n * alpineStoreGenerator Options.\n *\n * @typeParam T - The type of the default value.\n */\nexport type AlpineStoreGeneratorOptions<T extends DictionaryReq> = {\n  /**\n   * The name of the store.\n   */\n  name: string;\n\n  /**\n   * The default value of the store.\n   */\n  defaultValue: T;\n};\n\n/**\n * Generates an Alpine.js store with default value.\n *\n * @typeParam T - The type of the data.\n *\n * @param config - The configuration object for the store.\n * @returns - The initialized store instance.\n *\n * @remarks\n *\n * This function uses Alpine.js to create a reactive store with a default value.\n * The store is identified by a unique name and can be accessed and manipulated\n * throughout the application. Alpine.js stores provide a simple way to manage\n * data in your application, making it easy to keep your UI in sync with your data.\n *\n * @see {@link https://alpinejs.dev/globals/alpine-store}\n *\n * @example\n * ```ts\n * const store = alpineStoreGenerator({\n *   name: 'user',\n *   defaultValue: {type: 'root'},\n * });\n *\n * console.log(store.type); // Output: root\n *```\n */\nexport function alpineStoreGenerator<T extends DictionaryReq>(config: AlpineStoreGeneratorOptions<T>): T {\n  logger.logMethodArgs?.('alpineStoreGenerator', { config });\n\n  alpine.store(config.name, config.defaultValue);\n\n  // Get store Proxy\n  const store = alpine.store(config.name) as T;\n  return store;\n}\n", "import { type AlwatrLogger, createLogger } from '@alwatr/logger';\n\nimport { alpineStoreGenerator } from './store-generator.js';\n\n/**\n * AlpineStore Options.\n *\n * @typeParam T - The type of the store value.\n */\nexport type AlpineStoreOptions<T extends DictionaryReq> = {\n  /**\n   * The name of the store.\n   */\n  name: string;\n\n  /**\n   * The default value of the store.\n   */\n  defaultValue: T;\n};\n\n/**\n * Provides a Alpine.js pure store implementation with logger.\n */\nexport class AlpineStore<T extends DictionaryReq> {\n  /**\n   * The store's data.\n   */\n  store: T;\n\n  protected logger_: AlwatrLogger;\n\n  /**\n   * Provides a Alpine.js pure store implementation with logger.\n   *\n   * @param config - Configuration object.\n   *\n   * @example\n   * ```ts\n   * import {AlpineStore} from '@nexim/alpine';\n   *\n   * const {store} = new AlpineStore({\n   *   name: 'myStore',\n   *   defaultValue: {data: 'root'},\n   * });\n   * console.log(store.data); // Output: { data: 'root' }\n   *\n   * store.data = 'user';\n   * console.log(store.data); // Output: { data: 'user' }\n   * ```\n   */\n  constructor(config: AlpineStoreOptions<T>) {\n    this.logger_ = createLogger(`${__package_name__}:${config.name}`);\n    this.logger_.logMethodArgs?.('constructor', config);\n\n    this.store = alpineStoreGenerator(config);\n  }\n}\n", "import { type Duration, parseDuration } from '@alwatr/parse-duration';\nimport { AlpineStore } from './store.js';\nimport { localJsonStorage } from '@alwatr/local-storage';\n\n/**\n * Type for the store's data to extends from them.\n */\nexport type AlpineStoreWithBackupType = {\n  data: DictionaryReq | null;\n};\n\n/**\n * AlpineStoreWithBackup Options.\n *\n * @typeParam T - The type of the store value.\n */\nexport type AlpineStoreWithBackupOptions<T extends AlpineStoreWithBackupType> = {\n  /**\n   * The name of the store.\n   */\n  name: string;\n\n  /**\n   * The version of the store.\n   */\n  version: number;\n\n  /**\n   * The default value of the store.\n   */\n  defaultValue: T;\n\n  /**\n   * Optional. The duration after which the store expires.\n   */\n  expireDuration?: Duration;\n};\n\n/**\n * Version of the schema for storing data in local storage.\n *\n * Change when this schema changes.\n */\nconst schemaVersion = 1;\n\n/**\n * Provides a Alpine.js store implementation with backup and expiration.\n */\nexport class AlpineStoreWithBackup<T extends AlpineStoreWithBackupType> extends AlpineStore<T> {\n  /**\n   * Keys for storing data and expire time in local storage with version.\n   */\n  private localStorageKey__ = {\n    data: `[${__package_name__}:data:sv${schemaVersion.toString()}]:${this.config__.name}`,\n    expireTime: `[${__package_name__}:expire-time:sv${schemaVersion.toString()}]:${this.config__.name}`,\n  };\n\n  /**\n   * Provides a Alpine.js store implementation with backup and expiration.\n   *\n   * @param config__ - Configuration object.\n   *\n   * @example\n   * ```ts\n   * import {AlpineStoreWithBackup} from '@nexim/alpine';\n   *\n   * const storeWithBackup = new AlpineStoreWithBackup({\n   *   name: 'myStoreWithBackup',\n   *   version: 1,\n   *   defaultValue: {data: 'root'},\n   *   expireDuration: '1d',\n   * });\n   *\n   * storeWithBackup.store.data = 'user';\n   *\n   * storeWithBackup.save();\n   * console.log(storeWithBackup.store.data); // Output: { data: 'user' }\n   *\n   * storeWithBackup.clear();\n   * console.log(storeWithBackup.store.data); // Output: { data: 'root' }\n   * ```\n   */\n  constructor(private config__: AlpineStoreWithBackupOptions<T>) {\n    super(config__);\n\n    if (this.config__.expireDuration != null) {\n      this.handleDataExpiration__();\n    }\n\n    this.load__();\n  }\n\n  /**\n   * Saves the current data to local storage. If the data is null, it clears the stored data.\n   *\n   * Also updates the expiration time.\n   */\n  save(): void {\n    this.logger_.logMethodArgs?.('save', { data: this.store.data });\n\n    if (this.store.data === null) {\n      this.clear();\n      return;\n    }\n\n    localJsonStorage.setItem(this.localStorageKey__.data, this.store.data, this.config__.version);\n    this.updateExpireTime__();\n  }\n\n  /**\n   * Clears the stored data.\n   */\n  clear(): void {\n    this.logger_.logMethod?.('clear');\n\n    localJsonStorage.removeItem(this.localStorageKey__.data, this.config__.version);\n    localJsonStorage.removeItem(this.localStorageKey__.expireTime, this.config__.version);\n\n    this.store = this.config__.defaultValue;\n  }\n\n  /**\n   * Handles the expiration duration by checking if the stored data has expired.\n   * If expired, it clears the stored data.\n   */\n  private handleDataExpiration__(): void {\n    this.logger_.logMethod?.('handleDataExpiration__');\n\n    // FIXME: use null if not set, after local storage new version.\n    const expireDuration = localJsonStorage.getItem<{ time: number }>(\n      this.localStorageKey__.expireTime,\n      { time: -1 },\n      this.config__.version,\n    ).time;\n\n    if (expireDuration !== -1 && expireDuration < Date.now()) {\n      this.clear();\n    }\n  }\n\n  /**\n   * Loads data from local storage and updates the store's data.\n   *\n   * When data is not found or invalid in local storage, it uses the default value.\n   *\n   * FIXME: remove `NonNullable` from `<T['data']>`, after local storage new version.\n   */\n  private load__(): void {\n    this.logger_.logMethod?.('load__');\n\n    const newData = localJsonStorage.getItem<NonNullable<T['data']>>(\n      this.localStorageKey__.data,\n      this.config__.defaultValue.data as NonNullable<T['data']>,\n      this.config__.version,\n    ) as T['data'];\n    this.store.data = newData;\n  }\n\n  /**\n   * Updates the expiration time in local storage to the current time plus the configured expiration duration.\n   */\n  private updateExpireTime__(): void {\n    if (this.config__.expireDuration == null) return;\n    this.logger_.logMethod?.('updateExpireTime__');\n\n    const newExpireTime = Date.now() + parseDuration(this.config__.expireDuration);\n    localJsonStorage.setItem(this.localStorageKey__.expireTime, { time: newExpireTime }, this.config__.version);\n\n    this.logger_.logOther?.('updated_expire_time', { newExpireTime });\n  }\n}\n"],
+  "mappings": "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",
   "names": ["alpine", "import_logger"]
 }

package/dist/main.mjs

@@ -1,11 +1,11 @@
-/* @nexim/alpine v1.1.2 */
+/* @nexim/alpine v1.1.4 */
 
 // src/main.ts
 import { packageTracer } from "@alwatr/package-tracer";
 
 // src/store/store-generator.ts
-import { createLogger } from "@alwatr/logger";
 import alpine from "alpinejs";
+import { createLogger } from "@alwatr/logger";
 var logger = createLogger("@nexim/alpine");
 function alpineStoreGenerator(config) {
   logger.logMethodArgs?.("alpineStoreGenerator", { config });
@@ -20,9 +20,10 @@ var AlpineStore = class {
   /**
    * Provides a Alpine.js pure store implementation with logger.
    *
-   * @param {AlpineStoreOptions} config - Configuration object.
+   * @param config - Configuration object.
    *
    * @example
+   * ```ts
    * import {AlpineStore} from '@nexim/alpine';
    *
    * const {store} = new AlpineStore({
@@ -33,6 +34,7 @@ var AlpineStore = class {
    *
    * store.data = 'user';
    * console.log(store.data); // Output: { data: 'user' }
+   * ```
    */
   constructor(config) {
     this.logger_ = createLogger2(`${"@nexim/alpine"}:${config.name}`);
@@ -42,16 +44,17 @@ var AlpineStore = class {
 };
 
 // src/store/store-with-backup.ts
-import { localJsonStorage } from "@alwatr/local-storage";
 import { parseDuration } from "@alwatr/parse-duration";
+import { localJsonStorage } from "@alwatr/local-storage";
 var schemaVersion = 1;
 var AlpineStoreWithBackup = class extends AlpineStore {
   /**
    * Provides a Alpine.js store implementation with backup and expiration.
    *
-   * @param {AlpineStoreWithBackupOptions} config__ - Configuration object.
+   * @param config__ - Configuration object.
    *
    * @example
+   * ```ts
    * import {AlpineStoreWithBackup} from '@nexim/alpine';
    *
    * const storeWithBackup = new AlpineStoreWithBackup({
@@ -68,6 +71,7 @@ var AlpineStoreWithBackup = class extends AlpineStore {
    *
    * storeWithBackup.clear();
    * console.log(storeWithBackup.store.data); // Output: { data: 'root' }
+   * ```
    */
   constructor(config__) {
     super(config__);
@@ -76,8 +80,8 @@ var AlpineStoreWithBackup = class extends AlpineStore {
      * Keys for storing data and expire time in local storage with version.
      */
     this.localStorageKey__ = {
-      data: `[${"@nexim/alpine"}:data:sv${schemaVersion}]:${this.config__.name}`,
-      expireTime: `[${"@nexim/alpine"}:expire-time:sv${schemaVersion}]:${this.config__.name}`
+      data: `[${"@nexim/alpine"}:data:sv${schemaVersion.toString()}]:${this.config__.name}`,
+      expireTime: `[${"@nexim/alpine"}:expire-time:sv${schemaVersion.toString()}]:${this.config__.name}`
     };
     if (this.config__.expireDuration != null) {
       this.handleDataExpiration__();
@@ -127,7 +131,7 @@ var AlpineStoreWithBackup = class extends AlpineStore {
    *
    * When data is not found or invalid in local storage, it uses the default value.
    *
-   * FIXME: remove `NonNullable` from <T['data']>, after local storage new version.
+   * FIXME: remove `NonNullable` from `<T['data']>`, after local storage new version.
    */
   load__() {
     this.logger_.logMethod?.("load__");
@@ -151,11 +155,10 @@ var AlpineStoreWithBackup = class extends AlpineStore {
 };
 
 // src/main.ts
-__dev_mode__: packageTracer.add("@nexim/alpine", "1.1.2");
+__dev_mode__: packageTracer.add("@nexim/alpine", "1.1.4");
 export {
   AlpineStore,
   AlpineStoreWithBackup,
   alpineStoreGenerator
 };
-/*! For license information please see main.mjs.LEGAL.txt */
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts", "../src/store/store-generator.ts", "../src/store/store.ts", "../src/store/store-with-backup.ts"],
-  "sourcesContent": ["import {packageTracer} from '@alwatr/package-tracer';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nexport * from './store/store-generator.js';\nexport * from './store/store.js';\nexport * from './store/store-with-backup.js';\n", "import {createLogger} from '@alwatr/logger';\nimport alpine from 'alpinejs';\n\nconst logger = createLogger(__package_name__);\n\n/**\n * alpineStoreGenerator Options.\n *\n * @template T - The type of the default value.\n * @property {string} name - The name of the store.\n * @property {T} defaultValue - The default value of the store.\n */\nexport type AlpineStoreGeneratorOptions<T extends DictionaryReq> = {\n  name: string;\n  defaultValue: T;\n};\n\n/**\n * Generates an Alpine.js store with default value.\n *\n * @template T - The type of the data.\n * @param {AlpineStoreGeneratorOptions} config - The configuration object for the store.\n * @returns {T} - The initialized store instance.\n *\n * @example\n * const store = alpineStoreGenerator({\n *   name: 'user',\n *   defaultValue: {type: 'root'},\n * });\n *\n * console.log(store.type); // Output: root\n *\n * @description\n * This function uses Alpine.js to create a reactive store with a default value.\n * The store is identified by a unique name and can be accessed and manipulated\n * throughout the application. Alpine.js stores provide a simple way to manage\n * data in your application, making it easy to keep your UI in sync with your data.\n *\n * @see https://alpinejs.dev/globals/alpine-store\n */\nexport function alpineStoreGenerator<T extends DictionaryReq>(config: AlpineStoreGeneratorOptions<T>): T {\n  logger.logMethodArgs?.('alpineStoreGenerator', {config});\n\n  alpine.store(config.name, config.defaultValue);\n\n  // Get store Proxy\n  const store = alpine.store(config.name) as T;\n  return store;\n}\n", "import {type AlwatrLogger, createLogger} from '@alwatr/logger';\n\nimport {alpineStoreGenerator} from './store-generator.js';\n\n/**\n * AlpineStore Options.\n *\n * @template T - The type of the store value.\n * @param {string} name - The name of the store.\n * @param {T} defaultValue - The default value of the store.\n */\nexport type AlpineStoreOptions<T extends DictionaryReq> = {\n  name: string;\n  defaultValue: T;\n};\n\n/**\n * Provides a Alpine.js pure store implementation with logger.\n */\nexport class AlpineStore<T extends DictionaryReq> {\n  /**\n   * The store's data.\n   */\n  store: T;\n\n  protected logger_: AlwatrLogger;\n\n  /**\n   * Provides a Alpine.js pure store implementation with logger.\n   *\n   * @param {AlpineStoreOptions} config - Configuration object.\n   *\n   * @example\n   * import {AlpineStore} from '@nexim/alpine';\n   *\n   * const {store} = new AlpineStore({\n   *   name: 'myStore',\n   *   defaultValue: {data: 'root'},\n   * });\n   * console.log(store.data); // Output: { data: 'root' }\n   *\n   * store.data = 'user';\n   * console.log(store.data); // Output: { data: 'user' }\n   */\n  constructor(config: AlpineStoreOptions<T>) {\n    this.logger_ = createLogger(`${__package_name__}:${config.name}`);\n    this.logger_.logMethodArgs?.('constructor', config);\n\n    this.store = alpineStoreGenerator(config);\n  }\n}\n", "import {localJsonStorage} from '@alwatr/local-storage';\nimport {parseDuration, type Duration} from '@alwatr/parse-duration';\n\nimport {AlpineStore} from './store.js';\n\n/**\n * Type for the store's data to extends from them.\n */\nexport type AlpineStoreWithBackupType = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  data: DictionaryReq<any> | null;\n};\n\n/**\n * AlpineStoreWithBackup Options.\n *\n * @template T - The type of the store value.\n * @param {string} name - The name of the store.\n * @param {number} version - The version of the store.\n * @param {T} defaultValue - The default value of the store.\n * @param {Duration} [expireDuration] - Optional. The duration after which the store expires.\n */\nexport type AlpineStoreWithBackupOptions<T extends AlpineStoreWithBackupType> = {\n  name: string;\n  version: number;\n  defaultValue: T;\n  expireDuration?: Duration;\n};\n\n/**\n * Version of the schema for storing data in local storage.\n *\n * Change when this schema changes.\n */\nconst schemaVersion = 1;\n\n/**\n * Provides a Alpine.js store implementation with backup and expiration.\n */\nexport class AlpineStoreWithBackup<T extends AlpineStoreWithBackupType> extends AlpineStore<T> {\n  /**\n   * Keys for storing data and expire time in local storage with version.\n   */\n  private localStorageKey__ = {\n    data: `[${__package_name__}:data:sv${schemaVersion}]:${this.config__.name}`,\n    expireTime: `[${__package_name__}:expire-time:sv${schemaVersion}]:${this.config__.name}`,\n  };\n\n  /**\n   * Provides a Alpine.js store implementation with backup and expiration.\n   *\n   * @param {AlpineStoreWithBackupOptions} config__ - Configuration object.\n   *\n   * @example\n   * import {AlpineStoreWithBackup} from '@nexim/alpine';\n   *\n   * const storeWithBackup = new AlpineStoreWithBackup({\n   *   name: 'myStoreWithBackup',\n   *   version: 1,\n   *   defaultValue: {data: 'root'},\n   *   expireDuration: '1d',\n   * });\n   *\n   * storeWithBackup.store.data = 'user';\n   *\n   * storeWithBackup.save();\n   * console.log(storeWithBackup.store.data); // Output: { data: 'user' }\n   *\n   * storeWithBackup.clear();\n   * console.log(storeWithBackup.store.data); // Output: { data: 'root' }\n   */\n  constructor(private config__: AlpineStoreWithBackupOptions<T>) {\n    super(config__);\n\n    if (this.config__.expireDuration != null) {\n      this.handleDataExpiration__();\n    }\n\n    this.load__();\n  }\n\n  /**\n   * Saves the current data to local storage. If the data is null, it clears the stored data.\n   *\n   * Also updates the expiration time.\n   */\n  save(): void {\n    this.logger_.logMethodArgs?.('save', {data: this.store.data});\n\n    if (this.store.data === null) {\n      this.clear();\n      return;\n    }\n\n    localJsonStorage.setItem(this.localStorageKey__.data, this.store.data, this.config__.version);\n    this.updateExpireTime__();\n  }\n\n  /**\n   * Clears the stored data.\n   */\n  clear(): void {\n    this.logger_.logMethod?.('clear');\n\n    localJsonStorage.removeItem(this.localStorageKey__.data, this.config__.version);\n    localJsonStorage.removeItem(this.localStorageKey__.expireTime, this.config__.version);\n\n    this.store = this.config__.defaultValue;\n  }\n\n  /**\n   * Handles the expiration duration by checking if the stored data has expired.\n   * If expired, it clears the stored data.\n   */\n  private handleDataExpiration__(): void {\n    this.logger_.logMethod?.('handleDataExpiration__');\n\n    // FIXME: use null if not set, after local storage new version.\n    const expireDuration = localJsonStorage.getItem<{time: number}>(\n      this.localStorageKey__.expireTime,\n      {time: -1},\n      this.config__.version,\n    ).time;\n\n    if (expireDuration !== -1 && expireDuration < Date.now()) {\n      this.clear();\n    }\n  }\n\n  /**\n   * Loads data from local storage and updates the store's data.\n   *\n   * When data is not found or invalid in local storage, it uses the default value.\n   *\n   * FIXME: remove `NonNullable` from <T['data']>, after local storage new version.\n   */\n  private load__(): void {\n    this.logger_.logMethod?.('load__');\n\n    const newData = localJsonStorage.getItem<NonNullable<T['data']>>(\n      this.localStorageKey__.data,\n      this.config__.defaultValue.data as NonNullable<T['data']>,\n      this.config__.version,\n    ) as T['data'];\n    this.store.data = newData;\n  }\n\n  /**\n   * Updates the expiration time in local storage to the current time plus the configured expiration duration.\n   */\n  private updateExpireTime__(): void {\n    if (this.config__.expireDuration == null) return;\n    this.logger_.logMethod?.('updateExpireTime__');\n\n    const newExpireTime = Date.now() + parseDuration(this.config__.expireDuration);\n    localJsonStorage.setItem(this.localStorageKey__.expireTime, {time: newExpireTime}, this.config__.version);\n\n    this.logger_.logOther?.('updated_expire_time', {newExpireTime});\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { packageTracer } from '@alwatr/package-tracer';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nexport * from './store/store-generator.js';\nexport * from './store/store.js';\nexport * from './store/store-with-backup.js';\n", "import alpine from 'alpinejs';\nimport { createLogger } from '@alwatr/logger';\n\nconst logger = createLogger(__package_name__);\n\n/**\n * alpineStoreGenerator Options.\n *\n * @typeParam T - The type of the default value.\n */\nexport type AlpineStoreGeneratorOptions<T extends DictionaryReq> = {\n  /**\n   * The name of the store.\n   */\n  name: string;\n\n  /**\n   * The default value of the store.\n   */\n  defaultValue: T;\n};\n\n/**\n * Generates an Alpine.js store with default value.\n *\n * @typeParam T - The type of the data.\n *\n * @param config - The configuration object for the store.\n * @returns - The initialized store instance.\n *\n * @remarks\n *\n * This function uses Alpine.js to create a reactive store with a default value.\n * The store is identified by a unique name and can be accessed and manipulated\n * throughout the application. Alpine.js stores provide a simple way to manage\n * data in your application, making it easy to keep your UI in sync with your data.\n *\n * @see {@link https://alpinejs.dev/globals/alpine-store}\n *\n * @example\n * ```ts\n * const store = alpineStoreGenerator({\n *   name: 'user',\n *   defaultValue: {type: 'root'},\n * });\n *\n * console.log(store.type); // Output: root\n *```\n */\nexport function alpineStoreGenerator<T extends DictionaryReq>(config: AlpineStoreGeneratorOptions<T>): T {\n  logger.logMethodArgs?.('alpineStoreGenerator', { config });\n\n  alpine.store(config.name, config.defaultValue);\n\n  // Get store Proxy\n  const store = alpine.store(config.name) as T;\n  return store;\n}\n", "import { type AlwatrLogger, createLogger } from '@alwatr/logger';\n\nimport { alpineStoreGenerator } from './store-generator.js';\n\n/**\n * AlpineStore Options.\n *\n * @typeParam T - The type of the store value.\n */\nexport type AlpineStoreOptions<T extends DictionaryReq> = {\n  /**\n   * The name of the store.\n   */\n  name: string;\n\n  /**\n   * The default value of the store.\n   */\n  defaultValue: T;\n};\n\n/**\n * Provides a Alpine.js pure store implementation with logger.\n */\nexport class AlpineStore<T extends DictionaryReq> {\n  /**\n   * The store's data.\n   */\n  store: T;\n\n  protected logger_: AlwatrLogger;\n\n  /**\n   * Provides a Alpine.js pure store implementation with logger.\n   *\n   * @param config - Configuration object.\n   *\n   * @example\n   * ```ts\n   * import {AlpineStore} from '@nexim/alpine';\n   *\n   * const {store} = new AlpineStore({\n   *   name: 'myStore',\n   *   defaultValue: {data: 'root'},\n   * });\n   * console.log(store.data); // Output: { data: 'root' }\n   *\n   * store.data = 'user';\n   * console.log(store.data); // Output: { data: 'user' }\n   * ```\n   */\n  constructor(config: AlpineStoreOptions<T>) {\n    this.logger_ = createLogger(`${__package_name__}:${config.name}`);\n    this.logger_.logMethodArgs?.('constructor', config);\n\n    this.store = alpineStoreGenerator(config);\n  }\n}\n", "import { type Duration, parseDuration } from '@alwatr/parse-duration';\nimport { AlpineStore } from './store.js';\nimport { localJsonStorage } from '@alwatr/local-storage';\n\n/**\n * Type for the store's data to extends from them.\n */\nexport type AlpineStoreWithBackupType = {\n  data: DictionaryReq | null;\n};\n\n/**\n * AlpineStoreWithBackup Options.\n *\n * @typeParam T - The type of the store value.\n */\nexport type AlpineStoreWithBackupOptions<T extends AlpineStoreWithBackupType> = {\n  /**\n   * The name of the store.\n   */\n  name: string;\n\n  /**\n   * The version of the store.\n   */\n  version: number;\n\n  /**\n   * The default value of the store.\n   */\n  defaultValue: T;\n\n  /**\n   * Optional. The duration after which the store expires.\n   */\n  expireDuration?: Duration;\n};\n\n/**\n * Version of the schema for storing data in local storage.\n *\n * Change when this schema changes.\n */\nconst schemaVersion = 1;\n\n/**\n * Provides a Alpine.js store implementation with backup and expiration.\n */\nexport class AlpineStoreWithBackup<T extends AlpineStoreWithBackupType> extends AlpineStore<T> {\n  /**\n   * Keys for storing data and expire time in local storage with version.\n   */\n  private localStorageKey__ = {\n    data: `[${__package_name__}:data:sv${schemaVersion.toString()}]:${this.config__.name}`,\n    expireTime: `[${__package_name__}:expire-time:sv${schemaVersion.toString()}]:${this.config__.name}`,\n  };\n\n  /**\n   * Provides a Alpine.js store implementation with backup and expiration.\n   *\n   * @param config__ - Configuration object.\n   *\n   * @example\n   * ```ts\n   * import {AlpineStoreWithBackup} from '@nexim/alpine';\n   *\n   * const storeWithBackup = new AlpineStoreWithBackup({\n   *   name: 'myStoreWithBackup',\n   *   version: 1,\n   *   defaultValue: {data: 'root'},\n   *   expireDuration: '1d',\n   * });\n   *\n   * storeWithBackup.store.data = 'user';\n   *\n   * storeWithBackup.save();\n   * console.log(storeWithBackup.store.data); // Output: { data: 'user' }\n   *\n   * storeWithBackup.clear();\n   * console.log(storeWithBackup.store.data); // Output: { data: 'root' }\n   * ```\n   */\n  constructor(private config__: AlpineStoreWithBackupOptions<T>) {\n    super(config__);\n\n    if (this.config__.expireDuration != null) {\n      this.handleDataExpiration__();\n    }\n\n    this.load__();\n  }\n\n  /**\n   * Saves the current data to local storage. If the data is null, it clears the stored data.\n   *\n   * Also updates the expiration time.\n   */\n  save(): void {\n    this.logger_.logMethodArgs?.('save', { data: this.store.data });\n\n    if (this.store.data === null) {\n      this.clear();\n      return;\n    }\n\n    localJsonStorage.setItem(this.localStorageKey__.data, this.store.data, this.config__.version);\n    this.updateExpireTime__();\n  }\n\n  /**\n   * Clears the stored data.\n   */\n  clear(): void {\n    this.logger_.logMethod?.('clear');\n\n    localJsonStorage.removeItem(this.localStorageKey__.data, this.config__.version);\n    localJsonStorage.removeItem(this.localStorageKey__.expireTime, this.config__.version);\n\n    this.store = this.config__.defaultValue;\n  }\n\n  /**\n   * Handles the expiration duration by checking if the stored data has expired.\n   * If expired, it clears the stored data.\n   */\n  private handleDataExpiration__(): void {\n    this.logger_.logMethod?.('handleDataExpiration__');\n\n    // FIXME: use null if not set, after local storage new version.\n    const expireDuration = localJsonStorage.getItem<{ time: number }>(\n      this.localStorageKey__.expireTime,\n      { time: -1 },\n      this.config__.version,\n    ).time;\n\n    if (expireDuration !== -1 && expireDuration < Date.now()) {\n      this.clear();\n    }\n  }\n\n  /**\n   * Loads data from local storage and updates the store's data.\n   *\n   * When data is not found or invalid in local storage, it uses the default value.\n   *\n   * FIXME: remove `NonNullable` from `<T['data']>`, after local storage new version.\n   */\n  private load__(): void {\n    this.logger_.logMethod?.('load__');\n\n    const newData = localJsonStorage.getItem<NonNullable<T['data']>>(\n      this.localStorageKey__.data,\n      this.config__.defaultValue.data as NonNullable<T['data']>,\n      this.config__.version,\n    ) as T['data'];\n    this.store.data = newData;\n  }\n\n  /**\n   * Updates the expiration time in local storage to the current time plus the configured expiration duration.\n   */\n  private updateExpireTime__(): void {\n    if (this.config__.expireDuration == null) return;\n    this.logger_.logMethod?.('updateExpireTime__');\n\n    const newExpireTime = Date.now() + parseDuration(this.config__.expireDuration);\n    localJsonStorage.setItem(this.localStorageKey__.expireTime, { time: newExpireTime }, this.config__.version);\n\n    this.logger_.logOther?.('updated_expire_time', { newExpireTime });\n  }\n}\n"],
+  "mappings": "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",
   "names": ["createLogger", "createLogger"]
 }

package/dist/main.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.test.d.ts.map

package/dist/main.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.test.d.ts","sourceRoot":"","sources":["../src/main.test.js"],"names":[],"mappings":""}

package/dist/store/store-generator.d.ts

@@ -1,36 +1,44 @@
 /**
  * alpineStoreGenerator Options.
  *
- * @template T - The type of the default value.
- * @property {string} name - The name of the store.
- * @property {T} defaultValue - The default value of the store.
+ * @typeParam T - The type of the default value.
  */
 export type AlpineStoreGeneratorOptions<T extends DictionaryReq> = {
+    /**
+     * The name of the store.
+     */
     name: string;
+    /**
+     * The default value of the store.
+     */
     defaultValue: T;
 };
 /**
  * Generates an Alpine.js store with default value.
  *
- * @template T - The type of the data.
- * @param {AlpineStoreGeneratorOptions} config - The configuration object for the store.
- * @returns {T} - The initialized store instance.
+ * @typeParam T - The type of the data.
  *
- * @example
- * const store = alpineStoreGenerator({
- *   name: 'user',
- *   defaultValue: {type: 'root'},
- * });
+ * @param config - The configuration object for the store.
+ * @returns - The initialized store instance.
  *
- * console.log(store.type); // Output: root
+ * @remarks
  *
- * @description
  * This function uses Alpine.js to create a reactive store with a default value.
  * The store is identified by a unique name and can be accessed and manipulated
  * throughout the application. Alpine.js stores provide a simple way to manage
  * data in your application, making it easy to keep your UI in sync with your data.
  *
- * @see https://alpinejs.dev/globals/alpine-store
+ * @see {@link https://alpinejs.dev/globals/alpine-store}
+ *
+ * @example
+ * ```ts
+ * const store = alpineStoreGenerator({
+ *   name: 'user',
+ *   defaultValue: {type: 'root'},
+ * });
+ *
+ * console.log(store.type); // Output: root
+ *```
  */
 export declare function alpineStoreGenerator<T extends DictionaryReq>(config: AlpineStoreGeneratorOptions<T>): T;
 //# sourceMappingURL=store-generator.d.ts.map

package/dist/store/store-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-generator.d.ts","sourceRoot":"","sources":["../../src/store/store-generator.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,aAAa,IAAI;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,CAAC,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GAAG,CAAC,CAQvG"}
+{"version":3,"file":"store-generator.d.ts","sourceRoot":"","sources":["../../src/store/store-generator.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,aAAa,IAAI;IACjE;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,YAAY,EAAE,CAAC,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GAAG,CAAC,CAQvG"}

package/dist/store/store-with-backup.d.ts

@@ -4,21 +4,29 @@ import { AlpineStore } from './store.js';
  * Type for the store's data to extends from them.
  */
 export type AlpineStoreWithBackupType = {
-    data: DictionaryReq<any> | null;
+    data: DictionaryReq | null;
 };
 /**
  * AlpineStoreWithBackup Options.
  *
- * @template T - The type of the store value.
- * @param {string} name - The name of the store.
- * @param {number} version - The version of the store.
- * @param {T} defaultValue - The default value of the store.
- * @param {Duration} [expireDuration] - Optional. The duration after which the store expires.
+ * @typeParam T - The type of the store value.
  */
 export type AlpineStoreWithBackupOptions<T extends AlpineStoreWithBackupType> = {
+    /**
+     * The name of the store.
+     */
     name: string;
+    /**
+     * The version of the store.
+     */
     version: number;
+    /**
+     * The default value of the store.
+     */
     defaultValue: T;
+    /**
+     * Optional. The duration after which the store expires.
+     */
     expireDuration?: Duration;
 };
 /**
@@ -33,9 +41,10 @@ export declare class AlpineStoreWithBackup<T extends AlpineStoreWithBackupType>
     /**
      * Provides a Alpine.js store implementation with backup and expiration.
      *
-     * @param {AlpineStoreWithBackupOptions} config__ - Configuration object.
+     * @param config__ - Configuration object.
      *
      * @example
+     * ```ts
      * import {AlpineStoreWithBackup} from '@nexim/alpine';
      *
      * const storeWithBackup = new AlpineStoreWithBackup({
@@ -52,6 +61,7 @@ export declare class AlpineStoreWithBackup<T extends AlpineStoreWithBackupType>
      *
      * storeWithBackup.clear();
      * console.log(storeWithBackup.store.data); // Output: { data: 'root' }
+     * ```
      */
     constructor(config__: AlpineStoreWithBackupOptions<T>);
     /**
@@ -74,7 +84,7 @@ export declare class AlpineStoreWithBackup<T extends AlpineStoreWithBackupType>
      *
      * When data is not found or invalid in local storage, it uses the default value.
      *
-     * FIXME: remove `NonNullable` from <T['data']>, after local storage new version.
+     * FIXME: remove `NonNullable` from `<T['data']>`, after local storage new version.
      */
     private load__;
     /**

package/dist/store/store-with-backup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-with-backup.d.ts","sourceRoot":"","sources":["../../src/store/store-with-backup.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,QAAQ,EAAC,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IAEtC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,4BAA4B,CAAC,CAAC,SAAS,yBAAyB,IAAI;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,CAAC,CAAC;IAChB,cAAc,CAAC,EAAE,QAAQ,CAAC;CAC3B,CAAC;AASF;;GAEG;AACH,qBAAa,qBAAqB,CAAC,CAAC,SAAS,yBAAyB,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAgChF,OAAO,CAAC,QAAQ;IA/B5B;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAGvB;IAEF;;;;;;;;;;;;;;;;;;;;;;OAsBG;gBACiB,QAAQ,EAAE,4BAA4B,CAAC,CAAC,CAAC;IAU7D;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAYZ;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAWd;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAS3B"}
+{"version":3,"file":"store-with-backup.d.ts","sourceRoot":"","sources":["../../src/store/store-with-backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,CAAC,CAAC,SAAS,yBAAyB,IAAI;IAC9E;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,CAAC,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,QAAQ,CAAC;CAC3B,CAAC;AASF;;GAEG;AACH,qBAAa,qBAAqB,CAAC,CAAC,SAAS,yBAAyB,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAkChF,OAAO,CAAC,QAAQ;IAjC5B;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAGvB;IAEF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;gBACiB,QAAQ,EAAE,4BAA4B,CAAC,CAAC,CAAC;IAU7D;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAYZ;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAWd;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAS3B"}

package/dist/store/store.d.ts

@@ -2,12 +2,16 @@ import { type AlwatrLogger } from '@alwatr/logger';
 /**
  * AlpineStore Options.
  *
- * @template T - The type of the store value.
- * @param {string} name - The name of the store.
- * @param {T} defaultValue - The default value of the store.
+ * @typeParam T - The type of the store value.
  */
 export type AlpineStoreOptions<T extends DictionaryReq> = {
+    /**
+     * The name of the store.
+     */
     name: string;
+    /**
+     * The default value of the store.
+     */
     defaultValue: T;
 };
 /**
@@ -22,9 +26,10 @@ export declare class AlpineStore<T extends DictionaryReq> {
     /**
      * Provides a Alpine.js pure store implementation with logger.
      *
-     * @param {AlpineStoreOptions} config - Configuration object.
+     * @param config - Configuration object.
      *
      * @example
+     * ```ts
      * import {AlpineStore} from '@nexim/alpine';
      *
      * const {store} = new AlpineStore({
@@ -35,6 +40,7 @@ export declare class AlpineStore<T extends DictionaryReq> {
      *
      * store.data = 'user';
      * console.log(store.data); // Output: { data: 'user' }
+     * ```
      */
     constructor(config: AlpineStoreOptions<T>);
 }

package/dist/store/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,YAAY,EAAe,MAAM,gBAAgB,CAAC;AAI/D;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,aAAa,IAAI;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,CAAC,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,aAAa;IAC9C;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC;IAET,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC;IAEhC;;;;;;;;;;;;;;;;OAgBG;gBACS,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CAM1C"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAIjE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,aAAa,IAAI;IACxD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,YAAY,EAAE,CAAC,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,aAAa;IAC9C;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC;IAET,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC;IAEhC;;;;;;;;;;;;;;;;;;OAkBG;gBACS,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CAM1C"}

package/docs/README.md

@@ -0,0 +1,23 @@
+# @nexim/alpine
+
+## Classes
+
+| Class                                                     | Description                                                           |
+| --------------------------------------------------------- | --------------------------------------------------------------------- |
+| [AlpineStore](classes/AlpineStore.md)                     | Provides a Alpine.js pure store implementation with logger.           |
+| [AlpineStoreWithBackup](classes/AlpineStoreWithBackup.md) | Provides a Alpine.js store implementation with backup and expiration. |
+
+## Type Aliases
+
+| Type Alias                                                                   | Description                                     |
+| ---------------------------------------------------------------------------- | ----------------------------------------------- |
+| [AlpineStoreGeneratorOptions](type-aliases/AlpineStoreGeneratorOptions.md)   | alpineStoreGenerator Options.                   |
+| [AlpineStoreOptions](type-aliases/AlpineStoreOptions.md)                     | AlpineStore Options.                            |
+| [AlpineStoreWithBackupOptions](type-aliases/AlpineStoreWithBackupOptions.md) | AlpineStoreWithBackup Options.                  |
+| [AlpineStoreWithBackupType](type-aliases/AlpineStoreWithBackupType.md)       | Type for the store's data to extends from them. |
+
+## Functions
+
+| Function                                                  | Description                                      |
+| --------------------------------------------------------- | ------------------------------------------------ |
+| [alpineStoreGenerator](functions/alpineStoreGenerator.md) | Generates an Alpine.js store with default value. |

package/docs/classes/AlpineStore.md

@@ -0,0 +1,55 @@
+[@nexim/alpine](../README.md) / AlpineStore
+
+# Class: AlpineStore\<T\>
+
+Provides a Alpine.js pure store implementation with logger.
+
+## Extended by
+
+- [`AlpineStoreWithBackup`](AlpineStoreWithBackup.md)
+
+## Type Parameters
+
+| Type Parameter                |
+| ----------------------------- |
+| `T` _extends_ `DictionaryReq` |
+
+## Constructors
+
+### Constructor
+
+> **new AlpineStore**\<`T`\>(`config`: [`AlpineStoreOptions`](../type-aliases/AlpineStoreOptions.md)\<`T`\>): `AlpineStore`\<`T`\>
+
+Provides a Alpine.js pure store implementation with logger.
+
+#### Parameters
+
+| Parameter | Type                                                                 | Description           |
+| --------- | -------------------------------------------------------------------- | --------------------- |
+| `config`  | [`AlpineStoreOptions`](../type-aliases/AlpineStoreOptions.md)\<`T`\> | Configuration object. |
+
+#### Returns
+
+`AlpineStore`\<`T`\>
+
+#### Example
+
+```ts
+import { AlpineStore } from '@nexim/alpine';
+
+const { store } = new AlpineStore({
+  name: 'myStore',
+  defaultValue: { data: 'root' },
+});
+console.log(store.data); // Output: { data: 'root' }
+
+store.data = 'user';
+console.log(store.data); // Output: { data: 'user' }
+```
+
+## Properties
+
+| Property                       | Modifier    | Type           | Description       |
+| ------------------------------ | ----------- | -------------- | ----------------- |
+| <a id="logger_"></a> `logger_` | `protected` | `AlwatrLogger` | -                 |
+| <a id="store"></a> `store`     | `public`    | `T`            | The store's data. |

package/docs/classes/AlpineStoreWithBackup.md

@@ -0,0 +1,91 @@
+[@nexim/alpine](../README.md) / AlpineStoreWithBackup
+
+# Class: AlpineStoreWithBackup\<T\>
+
+Provides a Alpine.js store implementation with backup and expiration.
+
+## Extends
+
+- [`AlpineStore`](AlpineStore.md)\<`T`\>
+
+## Type Parameters
+
+| Type Parameter                                                                            |
+| ----------------------------------------------------------------------------------------- |
+| `T` _extends_ [`AlpineStoreWithBackupType`](../type-aliases/AlpineStoreWithBackupType.md) |
+
+## Constructors
+
+### Constructor
+
+> **new AlpineStoreWithBackup**\<`T`\>(`config__`: [`AlpineStoreWithBackupOptions`](../type-aliases/AlpineStoreWithBackupOptions.md)\<`T`\>): `AlpineStoreWithBackup`\<`T`\>
+
+Provides a Alpine.js store implementation with backup and expiration.
+
+#### Parameters
+
+| Parameter  | Type                                                                                     | Description           |
+| ---------- | ---------------------------------------------------------------------------------------- | --------------------- |
+| `config__` | [`AlpineStoreWithBackupOptions`](../type-aliases/AlpineStoreWithBackupOptions.md)\<`T`\> | Configuration object. |
+
+#### Returns
+
+`AlpineStoreWithBackup`\<`T`\>
+
+#### Example
+
+```ts
+import { AlpineStoreWithBackup } from '@nexim/alpine';
+
+const storeWithBackup = new AlpineStoreWithBackup({
+  name: 'myStoreWithBackup',
+  version: 1,
+  defaultValue: { data: 'root' },
+  expireDuration: '1d',
+});
+
+storeWithBackup.store.data = 'user';
+
+storeWithBackup.save();
+console.log(storeWithBackup.store.data); // Output: { data: 'user' }
+
+storeWithBackup.clear();
+console.log(storeWithBackup.store.data); // Output: { data: 'root' }
+```
+
+#### Overrides
+
+[`AlpineStore`](AlpineStore.md).[`constructor`](AlpineStore.md#constructor)
+
+## Properties
+
+| Property                       | Modifier    | Type           | Description       | Inherited from                                                      |
+| ------------------------------ | ----------- | -------------- | ----------------- | ------------------------------------------------------------------- |
+| <a id="logger_"></a> `logger_` | `protected` | `AlwatrLogger` | -                 | [`AlpineStore`](AlpineStore.md).[`logger_`](AlpineStore.md#logger_) |
+| <a id="store"></a> `store`     | `public`    | `T`            | The store's data. | [`AlpineStore`](AlpineStore.md).[`store`](AlpineStore.md#store)     |
+
+## Methods
+
+### clear()
+
+> **clear**(): `void`
+
+Clears the stored data.
+
+#### Returns
+
+`void`
+
+---
+
+### save()
+
+> **save**(): `void`
+
+Saves the current data to local storage. If the data is null, it clears the stored data.
+
+Also updates the expiration time.
+
+#### Returns
+
+`void`

package/docs/functions/alpineStoreGenerator.md

@@ -0,0 +1,47 @@
+[@nexim/alpine](../README.md) / alpineStoreGenerator
+
+# Function: alpineStoreGenerator()
+
+> **alpineStoreGenerator**\<`T`\>(`config`: [`AlpineStoreGeneratorOptions`](../type-aliases/AlpineStoreGeneratorOptions.md)\<`T`\>): `T`
+
+Generates an Alpine.js store with default value.
+
+## Type Parameters
+
+| Type Parameter                         | Description           |
+| -------------------------------------- | --------------------- |
+| `T` _extends_ `DictionaryReq`\<`any`\> | The type of the data. |
+
+## Parameters
+
+| Parameter | Type                                                                                   | Description                             |
+| --------- | -------------------------------------------------------------------------------------- | --------------------------------------- |
+| `config`  | [`AlpineStoreGeneratorOptions`](../type-aliases/AlpineStoreGeneratorOptions.md)\<`T`\> | The configuration object for the store. |
+
+## Returns
+
+`T`
+
+- The initialized store instance.
+
+## Remarks
+
+This function uses Alpine.js to create a reactive store with a default value.
+The store is identified by a unique name and can be accessed and manipulated
+throughout the application. Alpine.js stores provide a simple way to manage
+data in your application, making it easy to keep your UI in sync with your data.
+
+## See
+
+[https://alpinejs.dev/globals/alpine-store](https://alpinejs.dev/globals/alpine-store)
+
+## Example
+
+```ts
+const store = alpineStoreGenerator({
+  name: 'user',
+  defaultValue: { type: 'root' },
+});
+
+console.log(store.type); // Output: root
+```

package/docs/type-aliases/AlpineStoreGeneratorOptions.md

@@ -0,0 +1,29 @@
+[@nexim/alpine](../README.md) / AlpineStoreGeneratorOptions
+
+# Type Alias: AlpineStoreGeneratorOptions\<T\>
+
+> **AlpineStoreGeneratorOptions**\<`T`\> = `object`
+
+alpineStoreGenerator Options.
+
+## Type Parameters
+
+| Type Parameter                | Description                    |
+| ----------------------------- | ------------------------------ |
+| `T` _extends_ `DictionaryReq` | The type of the default value. |
+
+## Properties
+
+### defaultValue
+
+> **defaultValue**: `T`
+
+The default value of the store.
+
+---
+
+### name
+
+> **name**: `string`
+
+The name of the store.

package/docs/type-aliases/AlpineStoreOptions.md

@@ -0,0 +1,29 @@
+[@nexim/alpine](../README.md) / AlpineStoreOptions
+
+# Type Alias: AlpineStoreOptions\<T\>
+
+> **AlpineStoreOptions**\<`T`\> = `object`
+
+AlpineStore Options.
+
+## Type Parameters
+
+| Type Parameter                | Description                  |
+| ----------------------------- | ---------------------------- |
+| `T` _extends_ `DictionaryReq` | The type of the store value. |
+
+## Properties
+
+### defaultValue
+
+> **defaultValue**: `T`
+
+The default value of the store.
+
+---
+
+### name
+
+> **name**: `string`
+
+The name of the store.

package/docs/type-aliases/AlpineStoreWithBackupOptions.md

@@ -0,0 +1,45 @@
+[@nexim/alpine](../README.md) / AlpineStoreWithBackupOptions
+
+# Type Alias: AlpineStoreWithBackupOptions\<T\>
+
+> **AlpineStoreWithBackupOptions**\<`T`\> = `object`
+
+AlpineStoreWithBackup Options.
+
+## Type Parameters
+
+| Type Parameter                                                            | Description                  |
+| ------------------------------------------------------------------------- | ---------------------------- |
+| `T` _extends_ [`AlpineStoreWithBackupType`](AlpineStoreWithBackupType.md) | The type of the store value. |
+
+## Properties
+
+### defaultValue
+
+> **defaultValue**: `T`
+
+The default value of the store.
+
+---
+
+### expireDuration?
+
+> `optional` **expireDuration**: `Duration`
+
+Optional. The duration after which the store expires.
+
+---
+
+### name
+
+> **name**: `string`
+
+The name of the store.
+
+---
+
+### version
+
+> **version**: `number`
+
+The version of the store.

package/docs/type-aliases/AlpineStoreWithBackupType.md

@@ -0,0 +1,13 @@
+[@nexim/alpine](../README.md) / AlpineStoreWithBackupType
+
+# Type Alias: AlpineStoreWithBackupType
+
+> **AlpineStoreWithBackupType** = `object`
+
+Type for the store's data to extends from them.
+
+## Properties
+
+### data
+
+> **data**: `DictionaryReq` \| `null`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexim/alpine",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Utility functions to enhance Alpine.js usage with backup support.",
   "keywords": [
     "alpinejs",
@@ -41,24 +41,28 @@
   ],
   "scripts": {
     "build": "wireit",
+    "doc": "wireit",
     "test": "wireit",
     "watch": "wireit"
   },
   "dependencies": {
-    "@alwatr/local-storage": "^5.0.0",
-    "@alwatr/logger": "^5.0.0",
-    "@alwatr/package-tracer": "^5.0.0",
-    "@alwatr/parse-duration": "^5.0.0",
-    "alpinejs": "^3.14.8"
+    "@alwatr/local-storage": "^5.5.3",
+    "@alwatr/logger": "^5.5.3",
+    "@alwatr/package-tracer": "^5.5.3",
+    "@alwatr/parse-duration": "^5.5.4",
+    "alpinejs": "^3.14.9"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^5.0.0",
-    "@alwatr/type-helper": "^5.0.0",
-    "@nexim/typescript-config": "^2.0.0",
+    "@alwatr/nano-build": "^5.5.3",
+    "@alwatr/type-helper": "^5.4.1",
+    "@nexim/typescript-config": "^2.0.1",
     "@types/alpinejs": "^3.13.11",
     "ava": "^6.2.0",
-    "typescript": "^5.7.2",
-    "wireit": "^0.14.9"
+    "typedoc": "^0.28.3",
+    "typedoc-plugin-markdown": "^4.6.2",
+    "typedoc-plugin-no-inherit": "^1.6.1",
+    "typescript": "^5.8.3",
+    "wireit": "^0.14.12"
   },
   "publishConfig": {
     "access": "public"
@@ -77,14 +81,14 @@
       ]
     },
     "build:es": {
-      "command": "nano-build --preset=module",
+      "command": "yarn nano-build --preset=module",
       "files": [
         "src",
         "tsconfig.json"
       ],
       "clean": "if-file-deleted",
       "output": [
-        "dist/es",
+        "dist",
         "tsconfig.tsbuildinfo"
       ]
     },
@@ -103,9 +107,12 @@
       ]
     },
     "watch:es": {
-      "command": "nano-build --preset=module -- --watch",
+      "command": "yarn nano-build --preset=module -- --watch",
       "service": true
+    },
+    "doc": {
+      "command": "typedoc"
     }
   },
-  "gitHead": "8d72218409e5b93b27b5026d9cea8f0bf0b1414a"
+  "gitHead": "f20da89af20ee0c17c96e1ea15c6dfd831717ee6"
 }