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

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

@@ -1,74 +1,15 @@
-export { lockNavigation, navigationLocked, unlockNavigation, } from "./navigationLock";
+import type { AtomType } from "../Mutables/atom/atom";
+import type { SuperAtomType } from "../Mutables/atom/atom";
 /**
- * Read-only facade over the three URL-state atoms: `pathAtom`, `hashAtom`,
- * and `qsAtom`.
+ * Creates a read-only location facade bound to the given scope atoms.
  *
  * Every getter performs a **tracked read**, so any reactive context (effect,
  * component render function) that accesses one of these properties will
  * automatically re-run when that part of the URL changes.
- *
- * This module also re-exports `navigationLocked`, `lockNavigation`, and
- * `unlockNavigation` from `navigationLock.ts` as a single convenient import
- * point for consumers that need both location data and navigation control.
- *
- * **Intentionally read-only.** To navigate, use `navigateTo()`. To update
- * the query string or hash state, use `qsAtom.set()` / `hashAtom.set()`.
- *
- * @example
- * import { location } from "mates";
- *
- * location.path;   // "/about"          — current pathname
- * location.hash;   // { tab: "overview" } — parsed hash fragment
- * location.qsObj;  // { q: "react", page: 1 } — parsed query string
- *
- * @example
- * import { location, lockNavigation, unlockNavigation } from "mates";
- *
- * lockNavigation();
- * navigateTo("/somewhere"); // no-op while locked
- * unlockNavigation();
- * navigateTo("/somewhere"); // works
  */
-export declare const location: {
-    /**
-     * The current URL pathname (e.g. `"/about"`), sourced from `pathAtom`.
-     *
-     * Reading this property inside a reactive context registers a dependency on
-     * `pathAtom`, so the context re-runs whenever the path changes.
-     *
-     * @example
-     * location.path; // "/about"
-     */
+export declare function createLocation(pathAtom: SuperAtomType<string>, hashAtom: AtomType<Record<string, any>>, qsAtom: AtomType<Record<string, any>>): {
     readonly path: string;
-    /**
-     * The current URL hash fragment as a parsed plain object, sourced from
-     * `hashAtom`.
-     *
-     * The hash is parsed as `URLSearchParams` — primitive values are strings,
-     * JSON-encoded objects/arrays are automatically deserialised.
-     *
-     * Reading this property inside a reactive context registers a dependency on
-     * `hashAtom`, so the context re-runs whenever the hash state changes.
-     *
-     * @example
-     * // URL: #tab=overview&page=2
-     * location.hash; // { tab: "overview", page: "2" }
-     */
     readonly hash: Record<string, any>;
-    /**
-     * The current URL query string as a parsed plain object, sourced from
-     * `qsAtom`.
-     *
-     * The query string is parsed via `URLSearchParams` — primitive values are
-     * strings, JSON-encoded objects/arrays are automatically deserialised.
-     *
-     * Reading this property inside a reactive context registers a dependency on
-     * `qsAtom`, so the context re-runs whenever the query string changes.
-     *
-     * @example
-     * // URL: ?q=react&page=1
-     * location.qsObj; // { q: "react", page: "1" }
-     */
     readonly qsObj: Record<string, any>;
 };
 //# sourceMappingURL=location.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/location.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,QAAQ;IACnB;;;;;;;;OAQG;mBACS,MAAM;IAIlB;;;;;;;;;;;;;OAaG;mBACS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI/B;;;;;;;;;;;;;OAaG;oBACU,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAGjC,CAAC"}
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/location.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EACvC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;mBAGvB,MAAM;mBAGN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;oBAGlB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;EAInC"}

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

@@ -1,31 +1,12 @@
+import type { AtomType } from "../Mutables/atom/atom";
+import type { SuperAtomType } from "../Mutables/atom/atom";
+import type { EventType } from "../Mutables/events/events";
+import type { NavigationEventPayload } from "./navigationRequest";
 /**
- * Navigates to `path` by updating both `window.history` and `pathAtom` in
- * sync, so the Router re-renders reactively.
+ * Creates a `navigateTo` function bound to the given scope atoms.
  *
- * - By default uses `pushState`, creating a new browser history entry.
- * - Pass `replace = true` to use `replaceState` instead — the current entry
- *   is overwritten, so the user cannot navigate back to the previous URL.
- * - Silently no-ops if navigation is currently locked (`navigationLocked()`
- *   returns `true`). Nothing is pushed/replaced and `pathAtom` is not updated.
- * - `data` is forwarded as the state argument to the history API and can be
- *   retrieved later via `history.state`.
- *
- * Scroll-to-top is intentionally **not** handled here. It belongs in the
- * router layer (`animatedRouter`'s `scrollToTop` option) so that:
- *   1. The scroll fires at the right moment (after exit animation, before
- *      enter animation) rather than prematurely before the old page exits.
- *   2. Nested / child routers can opt out with `scrollToTop: false` without
- *      affecting the parent.
- *
- * @param path    - The pathname to navigate to (e.g. `"/about"`).
- * @param replace - When `true`, calls `replaceState` instead of `pushState`.
- *                  Defaults to `false`.
- * @param data    - Optional state object passed to the history API.
- *
- * @example
- * navigateTo("/about");                          // pushState
- * navigateTo("/login", true);                    // replaceState (no new history entry)
- * navigateTo("/profile", false, { userId: 42 }); // pushState with state data
+ * Use this factory when working with a `MatesUtils` scope to ensure
+ * SSR-safe, request-isolated navigation.
  */
-export declare function navigateTo(path: string, replace?: boolean, data?: any): void;
+export declare function createNavigateTo(pathAtom: SuperAtomType<string>, navigationLocked: AtomType<boolean>, historyStateAtom: AtomType<unknown>, navigationRequestEvent: EventType<NavigationEventPayload>): (path: string, replace?: boolean, data?: any) => void;
 //# sourceMappingURL=navigateTo.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"navigateTo.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/navigateTo.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAU5E"}
+{"version":3,"file":"navigateTo.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/navigateTo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIlE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,EACnC,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,EACnC,sBAAsB,EAAE,SAAS,CAAC,sBAAsB,CAAC,GACxD,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAsCvD"}

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

@@ -1,50 +1,9 @@
+import { type AtomType } from "../Mutables/atom/atom";
 /**
- * Reactive atom holding the current navigation lock state.
+ * Creates a reactive atom holding the navigation lock state.
  *
- * When `true`, all navigation is suspended:
- *  - `navigateTo()` becomes a no-op.
- *  - `pathAtom` is hard-locked via `superAtom.lock()`, so `.set()` calls are
- *    silently ignored.
- *  - The `qsAtom → URL` effect and the `popstate` handler both bail out early.
- *  - The `hashAtom → URL` effect and the `hashchange` handler both bail out early.
- *
- * When `false` (the default), all navigation works normally.
- *
- * Prefer using the `lockNavigation()` / `unlockNavigation()` helpers over
- * calling `navigationLocked.set()` directly.
- *
- * @example
- * import { navigationLocked } from "mates";
- *
- * navigationLocked(); // false — unlocked by default
- */
-export declare const navigationLocked: import("..").AtomType<boolean>;
-/**
- * Locks navigation across the entire Router module.
- *
- * After calling this, the following all become no-ops until
- * `unlockNavigation()` is called:
- *  - `navigateTo()`
- *  - `pathAtom.set()` (hard-locked via `superAtom`)
- *  - `qsAtom` → URL writes
- *  - `hashAtom` → URL writes
- *  - `popstate` / `hashchange` → atom updates
- *
- * @example
- * lockNavigation();
- * navigateTo("/somewhere"); // no-op
- */
-export declare const lockNavigation: () => void;
-/**
- * Unlocks navigation, re-enabling all navigation operations that were
- * suppressed by `lockNavigation()`.
- *
- * @example
- * lockNavigation();
- * navigateTo("/somewhere"); // no-op
- *
- * unlockNavigation();
- * navigateTo("/somewhere"); // works — pushState + pathAtom.set()
+ * When `true`, all navigation is suspended. When `false` (default),
+ * navigation works normally.
  */
-export declare const unlockNavigation: () => void;
+export declare function createNavigationLocked(): AtomType<boolean>;
 //# sourceMappingURL=navigationLock.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"navigationLock.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/navigationLock.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,gCAAc,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,YAAmC,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,YAAoC,CAAC"}
+{"version":3,"file":"navigationLock.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/navigationLock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,QAAQ,CAAC,OAAO,CAAC,CAE1D"}

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

@@ -0,0 +1,26 @@
+import type { EventType } from "../Mutables/events/events";
+/** Internal event payload — what navigateTo() / pathAtom fire (no `next`). */
+export interface NavigationEventPayload {
+    to: string;
+    from: string;
+}
+/**
+ * Detail object passed to every `onNavigationRequest` callback.
+ *
+ * - `to`   — the path the user is navigating to.
+ * - `from` — the path the user is currently on.
+ * - `next` — call this to **allow** the navigation to proceed.
+ *            If `next()` is never called, the navigation is silently cancelled.
+ */
+export interface NavigationRequestDetail {
+    to: string;
+    from: string;
+    /** Proceed with the navigation. If not called before the callback settles, navigation is cancelled. */
+    next: () => void;
+}
+/**
+ * Creates a low-level event bus fired by `navigateTo()` / `popstate`
+ * immediately before navigation is committed.
+ */
+export declare function createNavigationRequestEvent(): EventType<NavigationEventPayload>;
+//# sourceMappingURL=navigationRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigationRequest.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/navigationRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAI3D,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,uGAAuG;IACvG,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAID;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,SAAS,CAAC,sBAAsB,CAAC,CAEhF"}

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

@@ -1,42 +1,22 @@
+import { type SuperAtomType } from "../Mutables/atom/atom";
+import type { AtomType } from "../Mutables/atom/atom";
+import type { EventType } from "../Mutables/events/events";
+import type { NavigationEventPayload } from "./navigationRequest";
 /**
- * @file pathAtom.ts
- *
- * Provides `pathAtom` — the single source of truth for the current URL
- * pathname inside the Router module.
- *
- * `pathAtom` is a `superAtom` (a lockable reactive atom) initialised with
- * `window.location.pathname` at module load time.  Because it is a
- * `superAtom`, it can be hard-locked and hard-unlocked in response to the
- * navigation lock state, which causes every subscriber (including the Router
- * itself) to ignore updates while navigation is locked.
- *
- * Three browser events keep `pathAtom` in sync with navigation that happens
- * outside of `navigateTo`:
- *  - `popstate`   — browser back / forward buttons
- *  - `hashchange` — hash-only navigations that also change the pathname
- *  - `navigate`   — Navigation API (supported in modern browsers)
- *
- * Any component or effect that reads `pathAtom()` will automatically re-run
- * whenever the path changes.
- *
- * **Do NOT set `pathAtom` directly.**  Use `navigateTo()` instead so that
- * `window.history` and the atom are always updated together.
- *
- * @example
- * pathAtom.get(); // "/current/path"
- * pathAtom();     // same — tracked read (registers a reactive dependency)
- *
- * // Do NOT do this:
- * // pathAtom.set("/somewhere"); // bypasses history API
- * // Use instead:
- * // navigateTo("/somewhere");
- */
-/**
- * Reactive atom holding the current `window.location.pathname`.
+ * Creates a reactive superAtom holding the current `window.location.pathname`.
  *
  * Implemented as a `superAtom` so it can be locked/unlocked in step with
- * `navigationLocked()`.  Prefer reading via the call syntax (`pathAtom()`)
+ * `navigationLocked()`. Prefer reading via the call syntax (`pathAtom()`)
  * inside reactive contexts so that the caller re-renders on path changes.
+ *
+ * **Do NOT set `pathAtom` directly.** Use `navigateTo()` instead.
+ *
+ * @param navigationLocked - Reactive atom; when true, popstate/hashchange/navigate
+ *   events are suppressed and beforeunload guard is active.
+ * @param historyStateAtom - Reactive atom; kept in sync with `window.history.state`
+ *   during popstate events.
+ * @param navigationRequestEvent - Event bus; fired before navigation is committed
+ *   so subscribers can cancel via lockNavigation().
  */
-export declare const pathAtom: import("..").SuperAtomType<string>;
+export declare function createPathAtom(navigationLocked: AtomType<boolean>, historyStateAtom: AtomType<unknown>, navigationRequestEvent: EventType<NavigationEventPayload>): SuperAtomType<string>;
 //# sourceMappingURL=pathAtom.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pathAtom.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/pathAtom.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,oCAEpB,CAAC"}
+{"version":3,"file":"pathAtom.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/pathAtom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,EACnC,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,EACnC,sBAAsB,EAAE,SAAS,CAAC,sBAAsB,CAAC,GACxD,aAAa,CAAC,MAAM,CAAC,CAsEvB"}

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

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

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

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

package/dist/types/lib/Template/hmr.d.ts

@@ -0,0 +1,6 @@
+export declare function isHmrEnabled(): boolean;
+export declare function getHotComponentImpl<T extends Function>(component: T): T;
+export declare function getHotComponentId(component: unknown): string | null;
+export declare function getHotComponentFile(component: unknown): string | null;
+export declare function getHotComponentExport(component: unknown): string | null;
+//# sourceMappingURL=hmr.d.ts.map

package/dist/types/lib/Template/hmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../../../../../lib/Template/hmr.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,IAAI,OAAO,CAItC;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,QAAQ,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAMvE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAInE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIrE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIvE"}

package/dist/types/lib/Template/x-x.d.ts

@@ -55,6 +55,7 @@ export declare class Component extends HTMLElement {
     addToCleanUps(key: any, cleanup: Function): void;
     _render(): void;
     private _mountComponent;
+    _hotRefresh(): void;
     private _handleRenderError;
 }
 //# sourceMappingURL=x-x.d.ts.map

package/dist/types/lib/Template/x-x.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"x-x.d.ts","sourceRoot":"","sources":["../../../../../lib/Template/x-x.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,gBAAgB,EAAgB,MAAM,2BAA2B,CAAC;AAahF,qBAAa,SAAU,SAAQ,WAAW;IACxC,OAAO,CAAC,MAAM,CAAsB;IAE7B,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,IAAI,SAAe;IAC1B,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,WAAW,CAEV;IACT,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,gBAAgB,CAAU;IAE3B,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,CAAC,UAAU,GAAG,EAAE,MAAM,GAAG,CAAC,CAAa;IAEzD,gFAAgF;IACzE,UAAU,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,EAAE,CAAM;IAEpD,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,EAAE,KAAK,EAAE,GAAG;IAIvC,WAAW,SAAM;IAExB,iGAAiG;IAC1F,MAAM,SAAK;IAClB,sEAAsE;IAC/D,gBAAgB,EAAE,SAAS,GAAG,IAAI,CAAQ;IACjD,kFAAkF;IAC3E,cAAc,SAAK;IAE1B,+CAA+C;IACxC,cAAc,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,EAAE,CAAM;IACzD,2EAA2E;IACpE,WAAW,EAAE,OAAO,CAAQ;IAG5B,qBAAqB,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAa;IACnD,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI;IAKjC,aAAa,EAAE,IAAI,GAAG,gBAAgB,CAAQ;IAC9C,UAAU,EAAE,IAAI,GAAG,gBAAgB,CAAQ;;IAwBlD,IAAI,KAAK,CAAC,GAAG,qBAAA,EAGZ;IAED,IAAI,KAAK,wBAER;IAEM,OAAO,EAAE,GAAG,CAAC;IAEpB,OAAO,CAAC,cAAc,CAAS;IAM/B;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAmBxB,IAAI,IAAI,CAAC,GAAG,KAAA,EAyBX;IAED,IAAI,IAAI,QAEP;IAMD,gBAAgB;IAIhB,iBAAiB;IAgCjB,oBAAoB;IAqBpB,OAAO,CAAC,qBAAqB,CAa3B;IAEF,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ;IAazC,OAAO;IA6CP,OAAO,CAAC,eAAe;IAqFvB,OAAO,CAAC,kBAAkB;CA0E3B"}
+{"version":3,"file":"x-x.d.ts","sourceRoot":"","sources":["../../../../../lib/Template/x-x.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,gBAAgB,EAAgB,MAAM,2BAA2B,CAAC;AAYhF,qBAAa,SAAU,SAAQ,WAAW;IACxC,OAAO,CAAC,MAAM,CAAsB;IAE7B,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,IAAI,SAAe;IAC1B,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,WAAW,CAEV;IACT,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,gBAAgB,CAAU;IAE3B,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,CAAC,UAAU,GAAG,EAAE,MAAM,GAAG,CAAC,CAAa;IAEzD,gFAAgF;IACzE,UAAU,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,EAAE,CAAM;IAEpD,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,EAAE,KAAK,EAAE,GAAG;IAIvC,WAAW,SAAM;IAExB,iGAAiG;IAC1F,MAAM,SAAK;IAClB,sEAAsE;IAC/D,gBAAgB,EAAE,SAAS,GAAG,IAAI,CAAQ;IACjD,kFAAkF;IAC3E,cAAc,SAAK;IAE1B,+CAA+C;IACxC,cAAc,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,EAAE,CAAM;IACzD,2EAA2E;IACpE,WAAW,EAAE,OAAO,CAAQ;IAG5B,qBAAqB,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAa;IACnD,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI;IAKjC,aAAa,EAAE,IAAI,GAAG,gBAAgB,CAAQ;IAC9C,UAAU,EAAE,IAAI,GAAG,gBAAgB,CAAQ;;IAwBlD,IAAI,KAAK,CAAC,GAAG,qBAAA,EAGZ;IAED,IAAI,KAAK,wBAER;IAEM,OAAO,EAAE,GAAG,CAAC;IAEpB,OAAO,CAAC,cAAc,CAAS;IAM/B;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAmBxB,IAAI,IAAI,CAAC,GAAG,KAAA,EAyBX;IAED,IAAI,IAAI,QAEP;IAMD,gBAAgB;IAIhB,iBAAiB;IAgCjB,oBAAoB;IAqBpB,OAAO,CAAC,qBAAqB,CAa3B;IAEF,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ;IAazC,OAAO;IA6CP,OAAO,CAAC,eAAe;IAsFhB,WAAW;IAKlB,OAAO,CAAC,kBAAkB;CAiF3B"}

package/dist/types/lib/Template/x-x.types.d.ts

@@ -66,26 +66,4 @@ export type ComponentType<T extends Record<string, any> = Record<string, any>> =
  * current host component.
  */
 export type Setter = <T extends (...args: any[]) => any>(fn: T) => T;
-/** @deprecated Use Component instead */
-export type ComponentFn<T extends Record<string, any> = Record<string, any>> = Component<T>;
-/** @deprecated Use Component instead */
-export type View<T extends Record<string, any> = Record<string, any>> = Component<T>;
-/** @deprecated Use Component instead */
-export type ClosureComponent<T extends Record<string, any> = Record<string, any>> = Component<T>;
-/** @deprecated Use Component instead */
-export type ViewComponent<T extends Record<string, any> = Record<string, any>> = Component<T>;
-/** @deprecated Use Component instead */
-export type C<T extends Record<string, any> = Record<string, any>> = Component<T>;
-/** @deprecated Use Component instead */
-export type OuterFn<T extends Record<string, any> = Record<string, any>> = Component<T>;
-/** @deprecated Use Props instead */
-export type PropsType<T extends Record<string, any> = Record<string, any>> = Props<T>;
-/** @deprecated Use TemplateFn instead */
-export type RenderFn = TemplateFn;
-/** @deprecated Use TemplateFn instead */
-export type InnerFn = TemplateFn;
-/** @deprecated Use TemplateFn instead */
-export type TemplateComponent = TemplateFn;
-/** @deprecated Use TemplateFn instead */
-export type X = TemplateFn;
 //# sourceMappingURL=x-x.types.d.ts.map

package/dist/types/lib/Template/x-x.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"x-x.types.d.ts","sourceRoot":"","sources":["../../../../../lib/Template/x-x.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"x-x.types.d.ts","sourceRoot":"","sources":["../../../../../lib/Template/x-x.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAE3D,YAAY,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,cAAc,GAAG,IAAI,GAAG,OAAO,OAAO,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAC3E,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,KACd,UAAU,CAAC;AAEhB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAC3E,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG;IAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IACzE,SAAS,CAAC,CAAC,CAAC,GACZ,aAAa,CAAC,CAAC,CAAC,CAAC;AAErB;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC"}

package/dist/types/lib/Template/x.d.ts

@@ -1,5 +1,22 @@
-import type { ComponentType } from "./x-x.types";
+import type { ComponentType, Props } from "./x-x.types";
 export declare const x: <T extends Record<string, any>>(viewFn: ComponentType<T>, props?: T) => import("lit-html").TemplateResult<1>;
 export declare const view: <T extends Record<string, any>>(viewFn: ComponentType<T>, props?: T) => import("lit-html").TemplateResult<1>;
-export declare const renderX: <T extends Record<string, any>>(viewFn: ComponentType<T>, element: HTMLElement, props?: T) => import("lit-html").RootPart;
+/** @alias x */
+export declare const template: <T extends Record<string, any>>(viewFn: ComponentType<T>, props?: T) => import("lit-html").TemplateResult<1>;
+export declare const renderX: <T extends Record<string, any>>(viewFn: ComponentType<T>, element: HTMLElement) => import("lit-html").RootPart;
+/**
+ * Wraps a component in a scope provider that initializes all framework
+ * utilities (RouterUtils, FetchUtils, StorageUtils, ThemeUtils).
+ *
+ * The returned component creates scopes in its outer function, so
+ * `scope()` has a valid host context. Child components can then access
+ * them via `useRouter()` / `useFetch()` / etc.
+ *
+ * @example
+ * const App = WithScope(AppShell, () => ({}));
+ * render(App, document.getElementById("app")!);
+ */
+export declare const WithScope: <T extends Record<string, any>>(propsFn: Props<T>) => () => import("lit-html").TemplateResult<1>;
+/** @alias renderX */
+export declare const renderTemplate: <T extends Record<string, any>>(viewFn: ComponentType<T>, element: HTMLElement) => import("lit-html").RootPart;
 //# sourceMappingURL=x.d.ts.map

package/dist/types/lib/Template/x.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"x.d.ts","sourceRoot":"","sources":["../../../../../lib/Template/x.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,CAAC,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7C,QAAQ,aAAa,CAAC,CAAC,CAAC,EACxB,QAAO,CAAW,yCAGnB,CAAC;AAGF,eAAO,MAAM,IAAI,GARC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,UACrC,aAAa,CAAC,CAAC,CAAC,UACjB,CAAC,yCAMW,CAAC;AAEtB,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnD,QAAQ,aAAa,CAAC,CAAC,CAAC,EACxB,SAAS,WAAW,EACpB,QAAO,CAAW,gCAGnB,CAAC"}
+{"version":3,"file":"x.d.ts","sourceRoot":"","sources":["../../../../../lib/Template/x.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AASxD,eAAO,MAAM,CAAC,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7C,QAAQ,aAAa,CAAC,CAAC,CAAC,EACxB,QAAO,CAAW,yCAGnB,CAAC;AAGF,eAAO,MAAM,IAAI,GARC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,UACrC,aAAa,CAAC,CAAC,CAAC,UACjB,CAAC,yCAMW,CAAC;AACtB,eAAe;AACf,eAAO,MAAM,QAAQ,GAVH,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,UACrC,aAAa,CAAC,CAAC,CAAC,UACjB,CAAC,yCAQe,CAAC;AAE1B,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnD,QAAQ,aAAa,CAAC,CAAC,CAAC,EACxB,SAAS,WAAW,gCAGrB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,+CAkBzE,CAAC;AAEF,qBAAqB;AACrB,eAAO,MAAM,cAAc,GAxCH,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,UAC3C,aAAa,CAAC,CAAC,CAAC,WACf,WAAW,gCAsCe,CAAC"}

package/dist/types/lib/TrackState/componentStatus.d.ts

@@ -1,8 +1,3 @@
-/**
- * Global component running status tracker.
- * Used to enforce safety checks and prevent certain operations during specific
- * execution contexts.
- */
 export declare const componentRunningStatus: {
     /**
      * Set to true while a scope's setup() method is running.

package/dist/types/lib/TrackState/componentStatus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"componentStatus.d.ts","sourceRoot":"","sources":["../../../../../lib/TrackState/componentStatus.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;;;;;;;;;OAWG;;IAGH;;;;;;;OAOG;;IAGH;;;;OAIG;;IAGH;;;;OAIG;;CAEJ,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAiBxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAsBvE"}
+{"version":3,"file":"componentStatus.d.ts","sourceRoot":"","sources":["../../../../../lib/TrackState/componentStatus.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,sBAAsB,EAAgC;IACjE;;;;;;;;;;;OAWG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;;;;;;OAOG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAiBxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAsBvE"}

package/dist/types/lib/TrackState/readTracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readTracking.d.ts","sourceRoot":"","sources":["../../../../../lib/TrackState/readTracking.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,kBAAkB,IAAI,GAAG,CAAC,GAAG,CAAC,CAE7C;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,QAE3C;AAED,wBAAgB,UAAU,SAEzB;AAED,wBAAgB,SAAS,SAExB;AAID,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;CACtB;AAED,wBAAgB,qBAAqB,IAAI,gBAAgB,CAQxD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,GAAG,CAAC,GAAG,CAAC,CAKhE;AAID,eAAO,MAAM,aAAa,8BAAwB,CAAC;AACnD,eAAO,MAAM,YAAY,wBAAkB,CAAC"}
+{"version":3,"file":"readTracking.d.ts","sourceRoot":"","sources":["../../../../../lib/TrackState/readTracking.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,kBAAkB,IAAI,GAAG,CAAC,GAAG,CAAC,CAE7C;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,QAE3C;AAED,wBAAgB,UAAU,SAEzB;AAED,wBAAgB,SAAS,SAExB;AAID,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;CACtB;AAED,wBAAgB,qBAAqB,IAAI,gBAAgB,CAQxD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,GAAG,CAAC,GAAG,CAAC,CAKhE;AAID,eAAO,MAAM,aAAa,8BAAwB,CAAC;AACnD,eAAO,MAAM,YAAY,wBAAkB,CAAC"}

package/dist/types/lib/Utils/cookie.d.ts

@@ -0,0 +1,2 @@
+export declare function getCookieObj(): Record<string, string>;
+//# sourceMappingURL=cookie.d.ts.map

package/dist/types/lib/Utils/cookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../../../../lib/Utils/cookie.ts"],"names":[],"mappings":"AAWA,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0BrD"}

package/dist/types/lib/Utils/countdown.d.ts

@@ -0,0 +1,48 @@
+export type CountdownState = "idle" | "running" | "paused" | "stopped";
+export interface Countdown {
+    /** Start the timer from the full duration. No-op if already running. */
+    start(): void;
+    /**
+     * Pause the timer. The remaining time is frozen at the current value.
+     * No-op if already paused, idle, or stopped.
+     */
+    pause(): void;
+    /**
+     * Resume a paused timer. Restarts a `setTimeout` for the remaining duration.
+     * No-op if already running, idle, or stopped.
+     */
+    resume(): void;
+    /**
+     * Stop and reset the timer. The callback will never fire.
+     * Remaining time is reset to the full duration.
+     * Calling start() after stop() begins a fresh countdown.
+     */
+    stop(): void;
+    /** Current state of the timer. */
+    readonly state: CountdownState;
+    /**
+     * Milliseconds remaining.
+     * - While `running`: live value computed from wall-clock elapsed.
+     * - While `paused` / `idle` / `stopped`: last frozen snapshot.
+     */
+    readonly remaining: number;
+}
+/**
+ * timer — precise pausable countdown timer.
+ *
+ * @param callback  Called once when the full duration has elapsed.
+ * @param duration  Total countdown duration in milliseconds.
+ *
+ * @example
+ * const { start, pause, resume, stop, remaining } = timer(() => {
+ *   dismiss(id);
+ * }, 6000);
+ *
+ * start();
+ * // user hovers card
+ * pause();
+ * // user leaves card
+ * resume();
+ */
+export declare function countdown(callback: () => void, duration: number): Countdown;
+//# sourceMappingURL=countdown.d.ts.map

package/dist/types/lib/Utils/countdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countdown.d.ts","sourceRoot":"","sources":["../../../../../lib/Utils/countdown.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,KAAK,IAAI,IAAI,CAAC;IACd;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;IACd;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;IACf;;;;OAIG;IACH,IAAI,IAAI,IAAI,CAAC;IACb,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CA6G3E"}

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

@@ -1,4 +1,6 @@
 export * from "./Context";
+export * from "./cookie";
+export * from "./countdown";
 export * from "./deepClone";
 export * from "./deepFreeze";
 export * from "./getAllProps";
@@ -7,6 +9,7 @@ export * from "./is";
 export * from "./isDefinedAsGetter";
 export * from "./logger";
 export * from "./notificationManager";
+export * from "./onceIdle";
 export * from "./registerCleanup";
 export * from "./svgIcon";
 export * from "./uuid";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/Utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/Utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}

package/dist/types/lib/Utils/logEvent.d.ts

@@ -0,0 +1,24 @@
+/**
+ * matesLogEvent — the internal pub/sub event fired by log() / logError() / logWarning().
+ *
+ * Deliberately does NOT use event() from events.ts to avoid a circular
+ * dependency (events.ts → logger.ts → events.ts).
+ *
+ * The shape matches EventType<T> so devtools and user code can subscribe
+ * with the same __subscribe / trigger API as any other mates event.
+ */
+export interface MatesLogEventDetail {
+    level: "log" | "error" | "warn";
+    message: unknown;
+    data?: unknown;
+    ts: number;
+}
+type Handler = (data: MatesLogEventDetail) => void;
+export declare const matesLogEvent: {
+    name: string;
+    __isEvent___: true;
+    trigger(data: MatesLogEventDetail): void;
+    __subscribe(fn: Handler): () => void;
+};
+export {};
+//# sourceMappingURL=logEvent.d.ts.map

package/dist/types/lib/Utils/logEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logEvent.d.ts","sourceRoot":"","sources":["../../../../../lib/Utils/logEvent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAGnD,eAAO,MAAM,aAAa;;;kBAIV,mBAAmB,GAAG,IAAI;oBAUxB,OAAO,GAAG,MAAM,IAAI;CAIrC,CAAC"}

package/dist/types/lib/Utils/logger.d.ts

@@ -1,22 +1,33 @@
 /**
- * Logger utility that only logs errors in localhost/development environment
+ * Logger utility — logs in dev, and always fires matesLogEvent so that
+ * mates-devtools can capture user logs regardless of environment.
  */
+export type { MatesLogEventDetail } from "./logEvent";
+export { matesLogEvent } from "./logEvent";
+/** Deep-clone a value with structuredClone; falls back to the original if not cloneable. */
+export declare function safeClone<T>(value: T): T;
 /**
- * Log an error only in localhost/development environment
- * @param error - The error to log
- * @param context - Optional context information
+ * Log a message + optional data.
+ * Always fires matesLogEvent (captured by devtools).
+ * Prints to console only in dev/localhost.
+ *
+ * @example
+ * log("User clicked", { id: 42 });
  */
-export declare function logError(error: any, context?: string): void;
+export declare function log(message: unknown, data?: unknown): void;
 /**
- * Log a warning only in localhost/development environment
- * @param message - The warning message
- * @param context - Optional context information
+ * Log an error + optional context.
+ * Always fires matesLogEvent (captured by devtools).
+ * Prints to console only in dev/localhost.
+ *
+ * @example
+ * logError("Fetch failed", error);
  */
-export declare function logWarning(message: any, context?: string): void;
+export declare function logError(error: unknown, context?: unknown): void;
 /**
- * Log info only in localhost/development environment
- * @param message - The info message
- * @param context - Optional context information
+ * Log a warning + optional data.
+ * Always fires matesLogEvent (captured by devtools).
+ * Prints to console only in dev/localhost.
  */
-export declare function logInfo(message: any, context?: string): void;
+export declare function logWarning(message: unknown, data?: unknown): void;
 //# sourceMappingURL=logger.d.ts.map

package/dist/types/lib/Utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../lib/Utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ/D;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ5D"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../../lib/Utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMxC;AAuBD;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAW1D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAWhE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAWjE"}