mates-devtools 0.1.0-beta.6 → 0.1.0-beta.7

package/dist/types/lib/MatesUtils/RouterUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterUtils.d.ts","sourceRoot":"","sources":["../../../../../lib/MatesUtils/RouterUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAgBrC,qBAAa,WAAW;IACtB,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,sBAAsB,EAAE,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAC1D,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACtC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;;IAexC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAS7D,cAAc,IAAI,IAAI;IAItB,gBAAgB,IAAI,IAAI;IAIxB,IAAI,QAAQ;;;;MAEX;IAED,mBAAmB,CACjB,EAAE,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC5D,IAAI;CAqCR"}

package/dist/types/lib/MatesUtils/StorageUtils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * StorageUtils — Scope class for localStorage/sessionStorage reactive atoms.
+ *
+ * @example
+ * ```ts
+ * const { lsAtom } = getParentScope(StorageUtils);
+ * lsAtom.set({ theme: "dark" });
+ * ```
+ */
+import type { StorageAtomType } from "../Mutables/atom/storageAtom";
+export declare class StorageUtils {
+    lsAtom: StorageAtomType;
+    ssAtom: StorageAtomType;
+    constructor();
+}
+//# sourceMappingURL=StorageUtils.d.ts.map

package/dist/types/lib/MatesUtils/StorageUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageUtils.d.ts","sourceRoot":"","sources":["../../../../../lib/MatesUtils/StorageUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,qBAAa,YAAY;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;;CAMzB"}

package/dist/types/lib/MatesUtils/ThemeUtils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ThemeUtils — Scope class for theme and title reactive atoms.
+ *
+ * @example
+ * ```ts
+ * const { themeAtom, titleAtom } = getParentScope(ThemeUtils);
+ * themeAtom.setToDark();
+ * titleAtom.set("My App");
+ * ```
+ */
+import type { AtomType } from "../Mutables/atom/atom";
+import type { ThemeAtomType } from "../Mutables/Extended Atoms/themeAtom";
+export declare class ThemeUtils {
+    themeAtom: ThemeAtomType;
+    titleAtom: AtomType<string>;
+    constructor();
+}
+//# sourceMappingURL=ThemeUtils.d.ts.map

package/dist/types/lib/MatesUtils/ThemeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeUtils.d.ts","sourceRoot":"","sources":["../../../../../lib/MatesUtils/ThemeUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAI1E,qBAAa,UAAU;IACrB,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;;CAM7B"}

package/dist/types/lib/MatesUtils/index.d.ts

@@ -0,0 +1,6 @@
+export { FetchUtils } from "./FetchUtils";
+export { MatesUtils } from "./MatesUtils";
+export { RouterUtils } from "./RouterUtils";
+export { StorageUtils } from "./StorageUtils";
+export { ThemeUtils } from "./ThemeUtils";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/MatesUtils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/lib/Mutables/Extended Atoms/changeFlagAtom.d.ts

@@ -0,0 +1,56 @@
+import type { AtomConfig, AtomType } from "../atom/atom";
+export type ChangeFlagAtomType = AtomType<number> & {
+    /**
+     * Trigger a reactivity update.
+     *
+     * - Called with no argument: sets the value to `Math.random()`, guaranteeing
+     *   a new value every call and forcing all subscribers / effects / views to
+     *   re-run.
+     * - Called with a number: sets the value to that number. Useful when you
+     *   want a meaningful version counter or a specific sentinel value.
+     *
+     * @example
+     * flag.change();        // random — always triggers
+     * flag.change(n + 1);   // explicit increment
+     */
+    change(value?: number): void;
+    /** Discriminator tag — always `"changeFlagAtom"`. */
+    readonly name: "changeFlagAtom";
+};
+/**
+ * changeFlagAtom — a reactive number atom whose sole purpose is to force
+ * re-renders, effect re-runs, and subscription callbacks.
+ *
+ * The stored number is intentionally meaningless by default — only the fact
+ * that it changed matters. Call `change()` to trigger, or pass a value if
+ * you want a meaningful version counter.
+ *
+ * Pairs well with `disappear` to bring back a disappeared element:
+ *
+ * @example
+ * const flag = changeFlagAtom();
+ *
+ * // Re-render the element (and restart the disappear timer) each time flag changes
+ * return () => html`
+ *   ${flag()}   // read flag so the template re-runs when it changes
+ *   <div ${disappear(3000)}>I vanish in 3 s</div>
+ *   <button @click=${() => flag.change()}>Show again</button>
+ * `;
+ *
+ * @example
+ * // Explicit version counter
+ * const version = changeFlagAtom(0);
+ * version.change(version() + 1);
+ *
+ * @example
+ * // Pair with effect
+ * const refresh = changeFlagAtom();
+ * effect(() => {
+ *   refresh(); // subscribe
+ *   fetchData();
+ * });
+ * // later:
+ * refresh.change(); // re-triggers the effect
+ */
+export declare function changeFlagAtom(initial?: number, config?: AtomConfig): ChangeFlagAtomType;
+//# sourceMappingURL=changeFlagAtom.d.ts.map

package/dist/types/lib/Mutables/Extended Atoms/changeFlagAtom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeFlagAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/Extended Atoms/changeFlagAtom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKzD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG;IAClD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,MAAU,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,kBAAkB,CAYpB"}

package/dist/types/lib/Mutables/Extended Atoms/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./cacheAtom";
+export * from "./changeFlagAtom";
 export * from "./paginationAtom";
 export * from "./themeAtom";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/lib/Mutables/Extended Atoms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/Extended Atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/Extended Atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/types/lib/Mutables/Extended Atoms/themeAtom.d.ts

@@ -34,26 +34,14 @@ export type ThemeAtomType = AtomType<ThemeValue> & {
     readonly name: "themeAtom";
 };
 /**
- * The singleton reactive theme atom.
- *
- * Use directly — it is the atom, not a factory.
+ * Creates a reactive theme atom.
  *
  * - Reads the initial theme from `localStorage["mates-theme"]`.
  * - Falls back to the OS color-scheme preference when no value is stored.
  * - Keeps `<html data-theme="…">` in sync automatically via an internal effect.
  * - Persists changes to localStorage (removes key for "auto").
  * - Re-applies the resolved theme when the OS preference changes while in
- *   "auto" mode, re-notifying all subscribers so derived UIs update.
- *
- * @example
- * import { themeAtom } from "mates";
- *
- * themeAtom.setToDark();
- * themeAtom.toggle();      // → "light"
- * themeAtom.setToAuto();   // follows OS
- * themeAtom.resolved;      // "light" | "dark" — never "auto"
- * themeAtom();             // read current value: "light" | "dark" | "auto"
- * themeAtom.val;           // same
+ *   "auto" mode.
  */
-export declare const themeAtom: ThemeAtomType;
+export declare const createThemeAtom: () => ThemeAtomType;
 //# sourceMappingURL=themeAtom.d.ts.map

package/dist/types/lib/Mutables/Extended Atoms/themeAtom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themeAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/Extended Atoms/themeAtom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAQ,MAAM,cAAc,CAAC;AAUnD,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG;IACjD,mEAAmE;IACnE,UAAU,IAAI,IAAI,CAAC;IACnB,kEAAkE;IAClE,SAAS,IAAI,IAAI,CAAC;IAClB,uEAAuE;IACvE,SAAS,IAAI,IAAI,CAAC;IAClB;;;;OAIG;IACH,MAAM,IAAI,IAAI,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B,CAAC;AA6JF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,SAAS,EAAE,aAAgC,CAAC"}
+{"version":3,"file":"themeAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/Extended Atoms/themeAtom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAQ,MAAM,cAAc,CAAC;AAUnD,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG;IACjD,mEAAmE;IACnE,UAAU,IAAI,IAAI,CAAC;IACnB,kEAAkE;IAClE,SAAS,IAAI,IAAI,CAAC;IAClB,uEAAuE;IACvE,SAAS,IAAI,IAAI,CAAC;IAClB;;;;OAIG;IACH,MAAM,IAAI,IAAI,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B,CAAC;AAiKF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,aAA8B,CAAC"}

package/dist/types/lib/Mutables/atom/atom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/atom/atom.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"atom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/atom/atom.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/Mutables/atom/delayAtom.d.ts

@@ -0,0 +1,40 @@
+import { type AtomConfig, type AtomType } from "./atom";
+/**
+ * delayAtom — a reactive atom whose `set()` and `update()` calls are applied
+ * after a fixed `delay` in milliseconds.
+ *
+ * Unlike `debouncedAtom`, **every call fires** — there is no cancellation of
+ * previous pending writes. Each call schedules its own independent timeout.
+ * This makes it useful for "apply this value after N ms" patterns rather than
+ * "apply only the last value after N ms of silence".
+ *
+ * Accepts either a plain initial value or a source {@link AtomType}. When a
+ * source atom is provided the delay atom mirrors the source's value, applying
+ * the delay to every propagated change.
+ *
+ * All pending timeouts are cancelled automatically when the atom is disposed
+ * via `registerCleanup`.
+ *
+ * @param initialAtomOrState - A plain initial value, or a source atom to mirror.
+ * @param delay - How long to wait (ms) before each `set` / `update` is applied.
+ * @param config - Optional atom configuration forwarded to the underlying atom.
+ *
+ * @example
+ * // Every set fires independently after 1 second:
+ * const status = delayAtom("idle", 1000);
+ * status.set("loading");  // applied after 1 s
+ * status.set("done");     // also applied after 1 s (both fire, in order)
+ *
+ * @example
+ * // Mirror a source with delay:
+ * const immediate = atom(0);
+ * const delayed = delayAtom(immediate, 500);
+ * immediate.set(42); // delayed reflects 42 after 500 ms
+ *
+ * @example
+ * // Useful with disappear — update state after the animation finishes:
+ * const visible = delayAtom(true, 300);
+ * visible.set(false); // hides the element 300 ms later (after CSS transition)
+ */
+export declare function delayAtom<T>(initialAtomOrState: T | AtomType<T>, delay: number, config?: AtomConfig): AtomType<T>;
+//# sourceMappingURL=delayAtom.d.ts.map

package/dist/types/lib/Mutables/atom/delayAtom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delayAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/atom/delayAtom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAQ,MAAM,QAAQ,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,kBAAkB,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EACnC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,UAAU,GAClB,QAAQ,CAAC,CAAC,CAAC,CA8Db"}

package/dist/types/lib/Mutables/atom/index.d.ts

@@ -1,7 +1,8 @@
 export * from "./atom";
+export * from "./atom";
 export * from "./createTimedAtom";
 export * from "./debouncedAtom";
-export * from "./atom";
+export * from "./delayAtom";
 export * from "./mapAtom";
 export * from "./setAtom";
 export * from "./storageAtom";

package/dist/types/lib/Mutables/atom/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/atom/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/atom/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/types/lib/Mutables/atom/storageAtom.d.ts

@@ -2,43 +2,21 @@ import { type AtomType } from "./atom";
 export type StorageValue = Record<string, unknown>;
 export type StorageAtomType = AtomType<StorageValue | null>;
 /**
- * A reactive atom backed by `localStorage["mates"]`.
+ * Creates a reactive atom backed by `localStorage["mates"]`.
  *
- * A single shared instance — import and use directly, no factory call needed.
- *
- * - Hydrates from `localStorage` on module load.
+ * - Hydrates from `localStorage` on creation.
  * - Every `set()` / `update()` persists the new value to `localStorage["mates"]`.
  * - Changes made in another tab are synced automatically via the `storage` event.
- * - Only manages the single `"mates"` key — it does not expose or interact with
- *   any other localStorage entries.
- *
- * @example
- * import { lsAtom } from "./storageAtom";
- *
- * lsAtom.set({ theme: "dark", lang: "en" });
- * lsAtom.update(d => { d.lang = "fr"; });
- * lsAtom();          // { theme: "dark", lang: "fr" }
- * lsAtom.get();      // same
- * lsAtom.val;        // same
+ * - Only manages the single `"mates"` key.
  */
-export declare const lsAtom: StorageAtomType;
+export declare function createLsAtom(): StorageAtomType;
 /**
- * A reactive atom backed by `sessionStorage["mates"]`.
+ * Creates a reactive atom backed by `sessionStorage["mates"]`.
  *
- * A single shared instance — import and use directly, no factory call needed.
- *
- * - Hydrates from `sessionStorage` on module load.
- * - Every `set()` / `update()` persists the new value to `sessionStorage["mates"]`.
+ * - Hydrates from `sessionStorage` on creation.
+ * - Every `set()` / `update()` persists to `sessionStorage["mates"]`.
  * - `sessionStorage` is tab-scoped so no cross-tab sync occurs.
- * - Only manages the single `"mates"` key — it does not expose or interact with
- *   any other sessionStorage entries.
- *
- * @example
- * import { ssAtom } from "./storageAtom";
- *
- * ssAtom.set({ cart: [], user: null });
- * ssAtom.update(d => { d.cart = [item]; });
- * ssAtom();          // { cart: [item], user: null }
+ * - Only manages the single `"mates"` key.
  */
-export declare const ssAtom: StorageAtomType;
+export declare function createSsAtom(): StorageAtomType;
 //# sourceMappingURL=storageAtom.d.ts.map

package/dist/types/lib/Mutables/atom/storageAtom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storageAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/atom/storageAtom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAQ,MAAM,QAAQ,CAAC;AAI7C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAwI5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,EAAE,eAMpB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM,EAAE,eAMpB,CAAC"}
+{"version":3,"file":"storageAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/atom/storageAtom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAQ,MAAM,QAAQ,CAAC;AAI7C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AA8G5D;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAQ9C;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAQ9C"}

package/dist/types/lib/Mutables/atom/titleAtom.d.ts

@@ -1,5 +1,6 @@
+import { type AtomType } from "./atom";
 /**
- * A singleton reactive atom that mirrors `document.title`.
+ * Creates a reactive atom that mirrors `document.title`.
  *
  * Setting this atom automatically updates the browser tab title via an
  * internal effect. Reading it inside a memo, effect, or component will
@@ -8,13 +9,6 @@
  * On SSR (environments where `document` is not defined) the initial value
  * is `""` and writes to the atom are tracked reactively but do not touch
  * any DOM.
- *
- * @example
- * ```ts
- * titleAtom.set("My App - Dashboard"); // document.title === "My App - Dashboard"
- * titleAtom.get(); // "My App - Dashboard"
- * // Reading titleAtom() in a component will re-render whenever the title changes
- * ```
  */
-export declare const titleAtom: import("./atom").AtomType<string>;
+export declare function createTitleAtom(): AtomType<string>;
 //# sourceMappingURL=titleAtom.d.ts.map

package/dist/types/lib/Mutables/atom/titleAtom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"titleAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/atom/titleAtom.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,mCAAqB,CAAC"}
+{"version":3,"file":"titleAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/atom/titleAtom.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAQ,MAAM,QAAQ,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAAC,MAAM,CAAC,CAWlD"}

package/dist/types/lib/Mutables/form/formAtom.d.ts

@@ -1,7 +1,8 @@
-import { type AtomConfig, type AtomType } from "../atom/atom";
+import { type AtomConfig, type SuperAtomType } from "../atom/atom";
 import type { ValidatorFn } from "./validators";
 /**
- * Widen literal types so that `formAtom("")` infers `FormAtom<string>`
+ * Widen literal types so that `form
+ "")` infers `FormAtom<string>`
  * instead of `FormAtom<"">`, and `formAtom(0)` infers `FormAtom<number>`
  * instead of `FormAtom<0>`.
  */
@@ -13,7 +14,7 @@ type Widen<T> = T extends string ? string : T extends number ? number : T extend
  * __subscribe, __version__, lock/unlock, toJSON, …) with form-specific
  * members: errors, isValid, validate(), and the numeric helpers.
  */
-export type FormAtom<T> = AtomType<T> & {
+export type FormAtom<T> = SuperAtomType<T> & {
     validate(): string[];
     readonly errors: string[];
     readonly isValid: boolean;
@@ -26,9 +27,10 @@ export type FormAtom<T> = AtomType<T> & {
 /**
  * Create a reactive form field atom.
  *
- * Inherits the full `AtomType<T>` interface — callable as a function,
+ * Inherits the full `SuperAtomType<T>` interface — callable as a function,
  * `.get()`, `.set()`, `.update()`, `.val`, `.__subscribe()`,
- * `.__version__`, `.lock()` / `.unlock()`, `.toJSON()` — plus:
+ * `.__version__`, `.__id__`, `.toJSON()`, `.lock()`, `.unlock()`,
+ * `.reset()`, `.freeze()` — plus:
  *
  * - `errors`    — `string[]` reactive via an internal atom; `[]` on mount.
  * - `isValid`   — `boolean` derived from errors.

package/dist/types/lib/Mutables/form/formAtom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/form/formAtom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAQ,MAAM,cAAc,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;GAIG;AACH,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC5B,MAAM,GACN,CAAC,SAAS,MAAM,GACd,MAAM,GACN,CAAC,SAAS,OAAO,GACf,OAAO,GACP,CAAC,CAAC;AAIV;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG;IACtC,QAAQ,IAAI,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;IAC9B,OAAO,IAAI,MAAM,CAAC;IAClB,aAAa,IAAI,MAAM,CAAC;IACxB,aAAa,IAAI,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,CAAC;AA2FF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,SAAS,CAAC,EACV,aAAY,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAO,EACxC,SAAS,UAAU,KAClB,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAC+C,CAAC"}
+{"version":3,"file":"formAtom.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/form/formAtom.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;GAKG;AACH,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC5B,MAAM,GACN,CAAC,SAAS,MAAM,GACd,MAAM,GACN,CAAC,SAAS,OAAO,GACf,OAAO,GACP,CAAC,CAAC;AAIV;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IAC3C,QAAQ,IAAI,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;IAC9B,OAAO,IAAI,MAAM,CAAC;IAClB,aAAa,IAAI,MAAM,CAAC;IACxB,aAAa,IAAI,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,CAAC;AAiGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,SAAS,CAAC,EACV,aAAY,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAO,EACxC,SAAS,UAAU,KAClB,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAC+C,CAAC"}

package/dist/types/lib/Mutables/scope/scope.d.ts

@@ -1,3 +1,8 @@
+import { MatesUtils } from "../../MatesUtils";
+import { RouterUtils } from "../../MatesUtils/RouterUtils";
+import { FetchUtils } from "../../MatesUtils/FetchUtils";
+import { StorageUtils } from "../../MatesUtils/StorageUtils";
+import { ThemeUtils } from "../../MatesUtils/ThemeUtils";
 type TScope<T> = T & {
     reset: () => void;
     __isScope___: boolean;
@@ -56,5 +61,31 @@ export declare const scope: <T extends object>(ScopeClass: new () => T) => TScop
  * counter.incr();  // mutates the parent's atom
  */
 export declare const getParentScope: <T extends object>(ScopeClass: new () => T) => TScope<T>;
-export {};
+/**
+ * Register scope classes that WithScope should instantiate on every
+ * component tree mount. Libraries call this at module level.
+ *
+ * Safe to call multiple times — duplicates are ignored (Set semantics).
+ *
+ * @example
+ * import { registerGlobalScopes } from "mates";
+ * registerGlobalScopes([SnackbarScope, NotificationScope]);
+ */
+export declare function registerGlobalScopes(classes: Array<new () => object>): void;
+/**
+ * Returns a snapshot of all registered global scope classes.
+ * Used internally by WithScope.
+ */
+export declare function getGlobalScopeClasses(): Array<new () => object>;
+export declare const useUtils: () => TScope<MatesUtils>;
+/** Alias for `scope()` — creates a scope instance. */
+export { scope as useScope };
+/** Shorthand for `getParentScope(RouterUtils)`. */
+export declare const useRouter: () => TScope<RouterUtils>;
+/** Shorthand for `getParentScope(FetchUtils)`. */
+export declare const useFetch: () => TScope<FetchUtils>;
+/** Shorthand for `getParentScope(StorageUtils)`. */
+export declare const useStorage: () => TScope<StorageUtils>;
+/** Shorthand for `getParentScope(ThemeUtils)`. */
+export declare const useTheme: () => TScope<ThemeUtils>;
 //# sourceMappingURL=scope.d.ts.map

package/dist/types/lib/Mutables/scope/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/scope/scope.ts"],"names":[],"mappings":"AAKA,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,EAAE,YAAY,UAAU,CAAC,KAAG,MAAM,CAAC,CAAC,CAiEzE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAC7C,YAAY,UAAU,CAAC,KACtB,MAAM,CAAC,CAAC,CAoBV,CAAC"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/scope/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAMzD,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,EAAE,YAAY,UAAU,CAAC,KAAG,MAAM,CAAC,CAAC,CAiEzE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAC7C,YAAY,UAAU,CAAC,KACtB,MAAM,CAAC,CAAC,CAmCV,CAAC;AAWF;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,MAAM,CAAC,GAAG,IAAI,CAE3E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,CAE/D;AAED,eAAO,MAAM,QAAQ,0BAAmC,CAAC;AAEzD,sDAAsD;AACtD,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAE,CAAC;AAE7B,mDAAmD;AACnD,eAAO,MAAM,SAAS,2BAAoC,CAAC;AAE3D,kDAAkD;AAClD,eAAO,MAAM,QAAQ,0BAAmC,CAAC;AAEzD,oDAAoD;AACpD,eAAO,MAAM,UAAU,4BAAqC,CAAC;AAE7D,kDAAkD;AAClD,eAAO,MAAM,QAAQ,0BAAmC,CAAC"}

package/dist/types/lib/Mutables/useStore/hostContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostContext.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/useStore/hostContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,OAS5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CASvE"}
+{"version":3,"file":"hostContext.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/useStore/hostContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM5D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,OAS5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CASvE"}

package/dist/types/lib/Mutables/useStore/subscription.d.ts

@@ -46,5 +46,5 @@ export type SetterReturnType<T extends Function> = T & {
     set: SetterReturnType<T>;
     [key: string]: any;
 };
-export declare const on: (callback: () => (() => void) | undefined, deps: any[]) => () => void;
+export declare const on: (callback: () => void | (() => void) | Promise<void>, deps: any[]) => () => void;
 //# sourceMappingURL=subscription.d.ts.map

package/dist/types/lib/Mutables/useStore/subscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/useStore/subscription.ts"],"names":[],"mappings":"AAMA,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,EACV,UAAU,UAAO,EACjB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,QAY7C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,QAAQ,CAAC;IAC/C,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,QAAQ,CAAC;IACjD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAG5D;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,GAAG;IACrD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,QAAQ,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,EAAE,GAAI,UAAU,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,EAAE,MAAM,GAAG,EAAE,eAyCvE,CAAC"}
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../../../../lib/Mutables/useStore/subscription.ts"],"names":[],"mappings":"AAMA,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,EACV,UAAU,UAAO,EACjB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,QAY7C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,QAAQ,CAAC;IAC/C,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,QAAQ,CAAC;IACjD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAG5D;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,GAAG;IACrD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,QAAQ,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,EAAE,GACb,UAAU,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EACnD,MAAM,GAAG,EAAE,eA0CZ,CAAC"}

package/dist/types/lib/Router/Router.d.ts

@@ -1,5 +1,5 @@
 import { nothing } from "lit-html";
-import type { ComponentType, View } from "../Template/x-x.types";
+import type { ComponentType } from "../Template/x-x.types";
 /**
  * Renders `view` if the current URL path matches `path`; otherwise returns `null`.
  *
@@ -15,7 +15,7 @@ import type { ComponentType, View } from "../Template/x-x.types";
  * ${route("/about", { view: () => html`<about-page></about-page>` })}
  */
 export declare const route: (path: string, { view: viewFn }: {
-    view: View;
+    view: ComponentType;
 }) => typeof nothing | import("lit-html").TemplateResult<1> | null;
 type RouteConfig = {
     path: string;

package/dist/types/lib/Router/Router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/Router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,KAAK,EAAa,aAAa,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAI5E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,EAAE,kBAAkB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,iEAGnE,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,MAAM,GACjB,aAAa,WAAW,EAAE,EAC1B,WAAW,aAAa,kEAuBzB,CAAC"}
+{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/Router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,GAChB,MAAM,MAAM,EACZ,kBAAkB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,iEAK1C,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,MAAM,GACjB,aAAa,WAAW,EAAE,EAC1B,WAAW,aAAa,kEAezB,CAAC"}

package/dist/types/lib/Router/animatedRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animatedRouter.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/animatedRouter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAM/D,OAAO,KAAK,EAAE,aAAa,EAAS,MAAM,uBAAuB,CAAC;AAIlE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAGD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAuFrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,mBAAmB,EAAE,EAC7B,OAAO,GAAE,qBAA0B,wCAGpC"}
+{"version":3,"file":"animatedRouter.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/animatedRouter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAQ/D,OAAO,KAAK,EAAE,aAAa,EAAS,MAAM,uBAAuB,CAAC;AAGlE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAGD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AA0FrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,mBAAmB,EAAE,EAC7B,OAAO,GAAE,qBAA0B,wCAGpC"}

package/dist/types/lib/Router/hashAtom.d.ts

@@ -1,12 +1,16 @@
+import { type AtomType } from "../Mutables/atom/atom";
 /**
- * Singleton atom holding the current URL hash fragment as a parsed object.
+ * Creates a reactive atom holding the current URL hash fragment as a parsed object.
  *
- * Hydrated from `window.location.hash` at module load time.  All reads are
+ * Hydrated from `window.location.hash` at creation time. All reads are
  * reactive — any effect or component that calls `hashAtom()` will re-run
  * whenever the hash state changes.
  *
  * Setting the atom via `hashAtom.set(obj)` automatically serialises the new
  * value back to the URL hash using `history.replaceState`.
+ *
+ * @param navigationLocked - A reactive atom; when `true`, URL writes and
+ *   hashchange→atom updates are suppressed.
  */
-export declare const hashAtom: import("..").AtomType<Record<string, any>>;
+export declare function createHashAtom(navigationLocked: AtomType<boolean>): AtomType<Record<string, any>>;
 //# sourceMappingURL=hashAtom.d.ts.map

package/dist/types/lib/Router/hashAtom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hashAtom.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/hashAtom.ts"],"names":[],"mappings":"AA+FA;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,4CAAqC,CAAC"}
+{"version":3,"file":"hashAtom.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/hashAtom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAQ,MAAM,uBAAuB,CAAC;AAgD5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAClC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAuB/B"}

package/dist/types/lib/Router/historyStateAtom.d.ts

@@ -0,0 +1,8 @@
+import { type AtomType } from "../Mutables/atom/atom";
+/**
+ * Creates a reactive atom that always reflects `window.history.state`.
+ *
+ * Hydrated from `window.history.state` at creation time.
+ */
+export declare function createHistoryStateAtom(): AtomType<unknown>;
+//# sourceMappingURL=historyStateAtom.d.ts.map

package/dist/types/lib/Router/historyStateAtom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyStateAtom.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/historyStateAtom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,QAAQ,CAAC,OAAO,CAAC,CAI1D"}

package/dist/types/lib/Router/historyUtils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Replace dynamic route params in the current URL using a **pattern** that
+ * describes which segments are params.
+ *
+ * Uses `replaceState` — no new history entry is created.
+ *
+ * Reads `pathAtom` and calls `navigateTo()` from the nearest `MatesUtils` scope.
+ *
+ * @param pattern  Route pattern with `:param` segments (e.g. `"/users/:id"`).
+ * @param params   Param names → new values. Only provided keys are replaced;
+ *                 all other segments are left unchanged.
+ */
+export declare function replaceParams(pattern: string, params: Record<string, string | number | boolean>): void;
+//# sourceMappingURL=historyUtils.d.ts.map

package/dist/types/lib/Router/historyUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyUtils.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/historyUtils.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAChD,IAAI,CA2CN"}

package/dist/types/lib/Router/index.d.ts

@@ -1,11 +1,7 @@
 export { type AnimatedRouteConfig, type AnimatedRouterOptions, animatedRouter, } from "./animatedRouter";
 export { buildPath } from "./buildPath";
-export { hashAtom } from "./hashAtom";
+export { replaceParams } from "./historyUtils";
 export { isPathMatching } from "./isPathMatching";
-export { location } from "./location";
-export { navigateTo } from "./navigateTo";
-export { lockNavigation, navigationLocked, unlockNavigation, } from "./navigationLock";
-export { pathAtom } from "./pathAtom";
-export { qsAtom } from "./qsAtom";
+export type { NavigationRequestDetail } from "./navigationRequest";
 export { Router, route } from "./Router";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/lib/Router/isPathMatching.d.ts

@@ -1,12 +1,16 @@
+import type { SuperAtomType } from "../Mutables/atom/atom";
 /**
  * Checks whether the current pathname matches a route pattern.
  *
  * Supports dynamic params in the pattern using `:param` segments.
  *
+ * Reads `pathAtom` from the nearest `MatesUtils` scope, or uses the
+ * optional `pathAtom` parameter when provided (useful for testing).
+ *
  * @example
  * // current path: /users/42
  * isPathMatching("/users/:id") // true
  * isPathMatching("/users")     // false
  */
-export declare const isPathMatching: (path: string) => boolean;
+export declare const isPathMatching: (path: string, pathAtom?: SuperAtomType<string>) => boolean;
 //# sourceMappingURL=isPathMatching.d.ts.map

package/dist/types/lib/Router/isPathMatching.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isPathMatching.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/isPathMatching.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAuB7C,CAAC"}
+{"version":3,"file":"isPathMatching.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/isPathMatching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,WAAW,aAAa,CAAC,MAAM,CAAC,KAC/B,OAwBF,CAAC"}