@elurjs/ionic 1.6.1

package/dist/lib/page-state.d.ts

@@ -0,0 +1,160 @@
+/**
+ * @elurjs/ionic / page-state.ts
+ *
+ * Opt-in page-state persistence protocol. Allows pages to save and restore
+ * serializable state across navigation, cache eviction, and app reloads.
+ *
+ * Key design rules:
+ *   - **Only serializable data** — JSON.stringify is used; DOM nodes, functions,
+ *     symbols, class instances with methods are rejected.
+ *   - **Never persist DOM/view instances** — the protocol validates values
+ *     before storage and throws on non-serializable content.
+ *   - **Opt-in** — pages must explicitly call `save()` to persist state.
+ *   - **Per cache key** — state is keyed by route path + params + query,
+ *     matching the IonRouterOutlet cache key logic.
+ *   - **Storage choice** — `sessionStorage` (default, cleared on tab close)
+ *     or `localStorage` (persists across sessions).
+ *
+ * @example Basic usage in a page component
+ * ```ts
+ * import { signal, html } from "@elurjs/core";
+ * import { createPageState, IonPage } from "@elurjs/ionic";
+ *
+ * class SearchPage extends IonPage {
+ *   private query = signal("");
+ *   private results = signal<string[]>([]);
+ *   private pageState = createPageState("search", {
+ *     // Declare which signals are persistable
+ *     query: this.query,
+ *     results: this.results,
+ *   });
+ *
+ *   override onMount() {
+ *     // Restore saved state on mount
+ *     this.pageState.restore();
+ *   }
+ *
+ *   override onUnmount() {
+ *     // Save state before leaving
+ *     this.pageState.save();
+ *   }
+ *
+ *   override render() {
+ *     return html`
+ *       <ion-content>
+ *         <ion-searchbar value=${() => this.query.value} @input=${(e: any) => {
+ *           this.query.value = e.target.value;
+ *           this.pageState.save(); // save on change
+ *         }}></ion-searchbar>
+ *         <ion-list>
+ *           ${() => this.results.value.map(r => html`<ion-item>${r}</ion-item>`)}
+ *         </ion-list>
+ *       </ion-content>
+ *     `;
+ *   }
+ * }
+ * ```
+ *
+ * @example With localStorage (persists across app restarts)
+ * ```ts
+ * const pageState = createPageState("cart", {
+ *   items: cartItems,
+ *   total: cartTotal,
+ * }, { storage: "local" });
+ * ```
+ */
+/** Storage backend selection. */
+export type StorageBackend = "session" | "local";
+/** Options for page-state persistence. */
+export interface PageStateOptions {
+    /**
+     * Storage backend: `"session"` (sessionStorage, cleared on tab close)
+     * or `"local"` (localStorage, persists across sessions).
+     * @default "session"
+     */
+    storage?: StorageBackend;
+    /**
+     * Namespace prefix for storage keys. Defaults to "elur-ionic".
+     * Useful for multi-app scenarios on the same origin.
+     */
+    namespace?: string;
+    /**
+     * Additional key suffix (e.g. user ID) to isolate state between users.
+     */
+    keySuffix?: string;
+}
+/**
+ * A map of signal names to signals. Each signal's value must be serializable.
+ */
+export type SignalMap = Record<string, {
+    value: unknown;
+}>;
+/**
+ * Page-state persistence controller. Created per page instance.
+ */
+export interface PageState {
+    /**
+     * Save the current state of all declared signals to storage.
+     * Only serializable values are stored; non-serializable values are
+     * silently skipped (with a console.warn in dev).
+     */
+    save(): void;
+    /**
+     * Restore saved state from storage into the declared signals.
+     * Returns true if state was found and restored, false otherwise.
+     */
+    restore(): boolean;
+    /**
+     * Clear saved state for this page's key.
+     */
+    clear(): void;
+    /**
+     * Get the storage key that would be used (for debugging).
+     */
+    readonly key: string;
+}
+/**
+ * Check if a value is serializable (can survive JSON.stringify + parse).
+ * Returns true for: primitives, plain arrays, plain objects.
+ * Returns false for: functions, symbols, DOM nodes, class instances,
+ * undefined, circular references.
+ */
+declare function isSerializable(value: unknown): boolean;
+/**
+ * Create a page-state persistence controller.
+ *
+ * @param pageId Unique identifier for the page (e.g. route path).
+ * @param signals Map of signal names to signals whose values should be persisted.
+ * @param options Persistence options.
+ *
+ * @example
+ * ```ts
+ * const state = createPageState("search", {
+ *   query: searchQuery,
+ *   filters: filterSignal,
+ * }, { storage: "local" });
+ *
+ * // On page mount:
+ * state.restore();
+ *
+ * // On page leave or data change:
+ * state.save();
+ * ```
+ */
+export declare function createPageState(pageId: string, signals: SignalMap, options?: PageStateOptions): PageState;
+/**
+ * Clear all elur-ionic page-state entries from a storage backend.
+ * Useful for logout flows.
+ *
+ * @example
+ * ```ts
+ * import { clearAllPageState } from "@elurjs/ionic";
+ *
+ * function logout() {
+ *   clearAllPageState(); // sessionStorage
+ *   clearAllPageState("local"); // localStorage
+ * }
+ * ```
+ */
+export declare function clearAllPageState(backend?: StorageBackend, namespace?: string): void;
+export { isSerializable };

package/dist/lib/page-state.js

@@ -0,0 +1,91 @@
+//#region src/page-state.ts
+function e(t) {
+	if (t === void 0) return !1;
+	if (t === null) return !0;
+	if (typeof t == "function" || typeof t == "symbol" || typeof t == "bigint" || typeof window < "u" && t instanceof Node || typeof window < "u" && t instanceof Element || typeof window < "u" && t instanceof DocumentFragment) return !1;
+	if (typeof t != "object") return !0;
+	if (Array.isArray(t)) return t.every(e);
+	let n = Object.getPrototypeOf(t);
+	if (n !== null && n !== Object.prototype) return !1;
+	try {
+		return JSON.stringify(t), !0;
+	} catch {
+		return !1;
+	}
+}
+function t(e) {
+	return typeof window > "u" ? null : e === "local" ? window.localStorage : window.sessionStorage;
+}
+function n(n, r, i = {}) {
+	let { storage: a = "session", namespace: o = "elur-ionic", keySuffix: s = "" } = i, c = `${o}:${n}${s ? ":" + s : ""}`;
+	function l() {
+		let i = t(a);
+		if (!i) return;
+		let o = {}, s = !1;
+		for (let [t, i] of Object.entries(r)) {
+			let r = i.value;
+			if (!e(r)) {
+				typeof console < "u" && console.warn && console.warn(`[elur-ionic] PageState: skipping non-serializable value for "${t}" on page "${n}". Only serializable data (primitives, plain arrays, plain objects) can be persisted. DOM nodes, functions, and class instances are not allowed.`);
+				continue;
+			}
+			o[t] = r, s = !0;
+		}
+		if (s) try {
+			i.setItem(c, JSON.stringify(o));
+		} catch {
+			typeof console < "u" && console.warn && console.warn(`[elur-ionic] PageState: failed to save state for page "${n}" (storage quota exceeded or storage disabled).`);
+		}
+	}
+	function u() {
+		let e = t(a);
+		if (!e) return !1;
+		let n = null;
+		try {
+			n = e.getItem(c);
+		} catch {
+			return !1;
+		}
+		if (!n) return !1;
+		let i;
+		try {
+			i = JSON.parse(n);
+		} catch {
+			try {
+				e.removeItem(c);
+			} catch {}
+			return !1;
+		}
+		for (let [e, t] of Object.entries(r)) e in i && (t.value = i[e]);
+		return !0;
+	}
+	function d() {
+		let e = t(a);
+		if (e) try {
+			e.removeItem(c);
+		} catch {}
+	}
+	return {
+		save: l,
+		restore: u,
+		clear: d,
+		get key() {
+			return c;
+		}
+	};
+}
+function r(e = "session", n = "elur-ionic") {
+	let r = t(e);
+	if (!r) return;
+	let i = `${n}:`, a = [];
+	try {
+		for (let e = 0; e < r.length; e++) {
+			let t = r.key(e);
+			t && t.startsWith(i) && a.push(t);
+		}
+		for (let e of a) r.removeItem(e);
+	} catch {}
+}
+//#endregion
+export { r as clearAllPageState, n as createPageState, e as isSerializable };
+
+//# sourceMappingURL=page-state.js.map

package/dist/lib/page-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-state.js","names":[],"sources":["../../src/page-state.ts"],"sourcesContent":["/**\n * @elurjs/ionic / page-state.ts\n *\n * Opt-in page-state persistence protocol. Allows pages to save and restore\n * serializable state across navigation, cache eviction, and app reloads.\n *\n * Key design rules:\n *   - **Only serializable data** — JSON.stringify is used; DOM nodes, functions,\n *     symbols, class instances with methods are rejected.\n *   - **Never persist DOM/view instances** — the protocol validates values\n *     before storage and throws on non-serializable content.\n *   - **Opt-in** — pages must explicitly call `save()` to persist state.\n *   - **Per cache key** — state is keyed by route path + params + query,\n *     matching the IonRouterOutlet cache key logic.\n *   - **Storage choice** — `sessionStorage` (default, cleared on tab close)\n *     or `localStorage` (persists across sessions).\n *\n * @example Basic usage in a page component\n * ```ts\n * import { signal, html } from \"@elurjs/core\";\n * import { createPageState, IonPage } from \"@elurjs/ionic\";\n *\n * class SearchPage extends IonPage {\n *   private query = signal(\"\");\n *   private results = signal<string[]>([]);\n *   private pageState = createPageState(\"search\", {\n *     // Declare which signals are persistable\n *     query: this.query,\n *     results: this.results,\n *   });\n *\n *   override onMount() {\n *     // Restore saved state on mount\n *     this.pageState.restore();\n *   }\n *\n *   override onUnmount() {\n *     // Save state before leaving\n *     this.pageState.save();\n *   }\n *\n *   override render() {\n *     return html`\n *       <ion-content>\n *         <ion-searchbar value=${() => this.query.value} @input=${(e: any) => {\n *           this.query.value = e.target.value;\n *           this.pageState.save(); // save on change\n *         }}></ion-searchbar>\n *         <ion-list>\n *           ${() => this.results.value.map(r => html`<ion-item>${r}</ion-item>`)}\n *         </ion-list>\n *       </ion-content>\n *     `;\n *   }\n * }\n * ```\n *\n * @example With localStorage (persists across app restarts)\n * ```ts\n * const pageState = createPageState(\"cart\", {\n *   items: cartItems,\n *   total: cartTotal,\n * }, { storage: \"local\" });\n * ```\n */\n\n// --- Types ---\n\n/** Storage backend selection. */\nexport type StorageBackend = \"session\" | \"local\";\n\n/** Options for page-state persistence. */\nexport interface PageStateOptions {\n    /**\n     * Storage backend: `\"session\"` (sessionStorage, cleared on tab close)\n     * or `\"local\"` (localStorage, persists across sessions).\n     * @default \"session\"\n     */\n    storage?: StorageBackend;\n    /**\n     * Namespace prefix for storage keys. Defaults to \"elur-ionic\".\n     * Useful for multi-app scenarios on the same origin.\n     */\n    namespace?: string;\n    /**\n     * Additional key suffix (e.g. user ID) to isolate state between users.\n     */\n    keySuffix?: string;\n}\n\n/**\n * A map of signal names to signals. Each signal's value must be serializable.\n */\nexport type SignalMap = Record<string, { value: unknown }>;\n\n/**\n * Page-state persistence controller. Created per page instance.\n */\nexport interface PageState {\n    /**\n     * Save the current state of all declared signals to storage.\n     * Only serializable values are stored; non-serializable values are\n     * silently skipped (with a console.warn in dev).\n     */\n    save(): void;\n    /**\n     * Restore saved state from storage into the declared signals.\n     * Returns true if state was found and restored, false otherwise.\n     */\n    restore(): boolean;\n    /**\n     * Clear saved state for this page's key.\n     */\n    clear(): void;\n    /**\n     * Get the storage key that would be used (for debugging).\n     */\n    readonly key: string;\n}\n\n// --- Serialization validation ---\n\n/**\n * Check if a value is serializable (can survive JSON.stringify + parse).\n * Returns true for: primitives, plain arrays, plain objects.\n * Returns false for: functions, symbols, DOM nodes, class instances,\n * undefined, circular references.\n */\nfunction isSerializable(value: unknown): boolean {\n    if (value === undefined) return false;\n    if (value === null) return true;\n    if (typeof value === \"function\") return false;\n    if (typeof value === \"symbol\") return false;\n    if (typeof value === \"bigint\") return false; // JSON.stringify throws on bigint\n\n    // DOM nodes and elements\n    if (typeof window !== \"undefined\" && value instanceof Node) return false;\n    if (typeof window !== \"undefined\" && value instanceof Element) return false;\n    if (typeof window !== \"undefined\" && value instanceof DocumentFragment) return false;\n\n    // Primitives\n    if (typeof value !== \"object\") return true;\n\n    // Arrays — check each element\n    if (Array.isArray(value)) {\n        return value.every(isSerializable);\n    }\n\n    // Plain objects — check constructor and each value\n    const proto = Object.getPrototypeOf(value);\n    if (proto !== null && proto !== Object.prototype) {\n        // Class instances (has non-trivial prototype) — reject\n        return false;\n    }\n\n    try {\n        // Final check: can it survive a round-trip?\n        JSON.stringify(value);\n        return true;\n    } catch {\n        return false; // circular reference or other stringify error\n    }\n}\n\n// --- Storage abstraction ---\n\nfunction getStorage(backend: StorageBackend): Storage | null {\n    if (typeof window === \"undefined\") return null;\n    return backend === \"local\" ? window.localStorage : window.sessionStorage;\n}\n\n// --- Factory ---\n\n/**\n * Create a page-state persistence controller.\n *\n * @param pageId Unique identifier for the page (e.g. route path).\n * @param signals Map of signal names to signals whose values should be persisted.\n * @param options Persistence options.\n *\n * @example\n * ```ts\n * const state = createPageState(\"search\", {\n *   query: searchQuery,\n *   filters: filterSignal,\n * }, { storage: \"local\" });\n *\n * // On page mount:\n * state.restore();\n *\n * // On page leave or data change:\n * state.save();\n * ```\n */\nexport function createPageState(\n    pageId: string,\n    signals: SignalMap,\n    options: PageStateOptions = {},\n): PageState {\n    const {\n        storage: backend = \"session\",\n        namespace = \"elur-ionic\",\n        keySuffix = \"\",\n    } = options;\n\n    const baseKey = `${namespace}:${pageId}${keySuffix ? \":\" + keySuffix : \"\"}`;\n\n    function save(): void {\n        const storage = getStorage(backend);\n        if (!storage) return;\n\n        const data: Record<string, unknown> = {};\n        let hasData = false;\n\n        for (const [name, sig] of Object.entries(signals)) {\n            const value = sig.value;\n            if (!isSerializable(value)) {\n                if (typeof console !== \"undefined\" && console.warn) {\n                    console.warn(\n                        `[elur-ionic] PageState: skipping non-serializable value for \"${name}\" ` +\n                        `on page \"${pageId}\". Only serializable data (primitives, plain arrays, ` +\n                        `plain objects) can be persisted. DOM nodes, functions, and class ` +\n                        `instances are not allowed.`,\n                    );\n                }\n                continue;\n            }\n            data[name] = value;\n            hasData = true;\n        }\n\n        if (hasData) {\n            try {\n                storage.setItem(baseKey, JSON.stringify(data));\n            } catch {\n                // Quota exceeded or storage disabled — fail silently\n                if (typeof console !== \"undefined\" && console.warn) {\n                    console.warn(\n                        `[elur-ionic] PageState: failed to save state for page \"${pageId}\" ` +\n                        `(storage quota exceeded or storage disabled).`,\n                    );\n                }\n            }\n        }\n    }\n\n    function restore(): boolean {\n        const storage = getStorage(backend);\n        if (!storage) return false;\n\n        let raw: string | null = null;\n        try {\n            raw = storage.getItem(baseKey);\n        } catch {\n            return false; // storage access denied\n        }\n\n        if (!raw) return false;\n\n        let data: Record<string, unknown>;\n        try {\n            data = JSON.parse(raw);\n        } catch {\n            // Corrupted data — clear it\n            try { storage.removeItem(baseKey); } catch { /* ignore */ }\n            return false;\n        }\n\n        for (const [name, sig] of Object.entries(signals)) {\n            if (name in data) {\n                sig.value = data[name];\n            }\n        }\n\n        return true;\n    }\n\n    function clear(): void {\n        const storage = getStorage(backend);\n        if (!storage) return;\n        try {\n            storage.removeItem(baseKey);\n        } catch { /* ignore */ }\n    }\n\n    return {\n        save,\n        restore,\n        clear,\n        get key() { return baseKey; },\n    };\n}\n\n// --- Batch helpers ---\n\n/**\n * Clear all elur-ionic page-state entries from a storage backend.\n * Useful for logout flows.\n *\n * @example\n * ```ts\n * import { clearAllPageState } from \"@elurjs/ionic\";\n *\n * function logout() {\n *   clearAllPageState(); // sessionStorage\n *   clearAllPageState(\"local\"); // localStorage\n * }\n * ```\n */\nexport function clearAllPageState(backend: StorageBackend = \"session\", namespace = \"elur-ionic\"): void {\n    const storage = getStorage(backend);\n    if (!storage) return;\n\n    const prefix = `${namespace}:`;\n    const keysToRemove: string[] = [];\n\n    try {\n        for (let i = 0; i < storage.length; i++) {\n            const key = storage.key(i);\n            if (key && key.startsWith(prefix)) {\n                keysToRemove.push(key);\n            }\n        }\n        for (const key of keysToRemove) {\n            storage.removeItem(key);\n        }\n    } catch { /* ignore */ }\n}\n\n// --- Serialization utilities (exported for testing) ---\n\nexport { isSerializable };\n"],"mappings":"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"}

package/dist/lib/setup.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @elurjs/ionic / setup.ts — v2 modular setup
+ *
+ * Architecture (Elur Ionic 2):
+ *
+ *   initializeElurIonic(options)   — configures Ionic Core once; returns a
+ *                                    handle with status/diagnostics. Safe to
+ *                                    call again (no-op after first init, but
+ *                                    validates incompatible config changes).
+ *
+ *   registerIonicComponents(...definers)  — incremental & idempotent. Always
+ *                                    registers new definers, skips already-
+ *                                    registered custom elements. Works for
+ *                                    lazy route loading.
+ *
+ *   registerIonicons(map)         — incremental with collision diagnostics.
+ *                                    Merges new icons into the global set;
+ *                                    warns on name collisions.
+ *
+ *   setupElurIonic(options)        — backward-compatible facade that calls all
+ *                                    three. Existing apps work unchanged.
+ *
+ * Key changes vs v1.x:
+ *   - No more `isInitialized` blocking: `registerIonicComponents` and
+ *     `registerIonicons` are always incremental.
+ *   - No `unpkg@latest` default asset path: uses official `setAssetPath` from
+ *     ionicons. CDN is opt-in only.
+ *   - SSR-safe: no `window` access at module load; guards in each function.
+ *   - Returns a handle with diagnostics from `initializeElurIonic`.
+ */
+import { addIcons, setAssetPath } from "ionicons";
+export type ComponentDefiner = () => void;
+export type IconDefinitionMap = Record<string, string>;
+export interface SetupElurIonicOptions {
+    /** @deprecated Use `icons` mode in `initializeElurIonic` instead. */
+    iconAssetPath?: string;
+    components?: ComponentDefiner[];
+    icons?: IconDefinitionMap;
+}
+export interface InitializeOptions {
+    /**
+     * Icon asset strategy:
+     * - "inline" (default): icons are inlined via addIcons; no remote fetch.
+     * - "assets": use setAssetPath to a local URL; icons fetched on demand.
+     * - object with `mode: "assets"` and `path` for explicit local path.
+     */
+    icons?: "inline" | "assets" | {
+        mode: "assets";
+        path: string;
+    };
+    /** Ionic mode override: "ios" | "md" | undefined (auto-detect). */
+    mode?: "ios" | "md";
+}
+export interface SetupHandle {
+    /** True if this call performed the initialization; false if already init. */
+    readonly initialized: boolean;
+    /** Diagnostics collected during initialization. */
+    readonly diagnostics: string[];
+}
+/**
+ * Initialize Ionic Core for Elur. Configures the runtime once.
+ *
+ * Subsequent calls are no-ops for the core init, but `registerIonicComponents`
+ * and `registerIonicons` remain incremental regardless.
+ *
+ * Returns a handle with diagnostics.
+ */
+export declare function initializeElurIonic(options?: InitializeOptions): SetupHandle;
+/**
+ * Register additional Ionic custom element definers. Incremental and
+ * idempotent — always processes new definers, safe to call from lazy routes.
+ *
+ * @example
+ * ```ts
+ * // In a lazy route module:
+ * import { defineCustomElement as defineIonDatetime } from "@ionic/core/components/ion-datetime.js";
+ * registerIonicComponents(defineIonDatetime);
+ * ```
+ */
+export declare function registerIonicComponents(...definers: ComponentDefiner[]): void;
+/**
+ * Register additional Ionicons by name → SVG string mapping. Incremental
+ * with collision diagnostics.
+ *
+ * @example
+ * ```ts
+ * import { registerIonicons } from "@elurjs/ionic";
+ * import { home, homeOutline } from "ionicons/icons";
+ *
+ * registerIonicons({ home, "home-outline": homeOutline });
+ * ```
+ */
+export declare function registerIonicons(map: IconDefinitionMap): void;
+/**
+ * Backward-compatible facade. Calls `initializeElurIonic`, then registers
+ * any extra components and icons passed via options.
+ *
+ * Existing v1.x apps work unchanged. New apps should prefer the granular
+ * functions (`initializeElurIonic` + `registerIonicComponents` + `registerIonicons`)
+ * for lazy loading and HMR support.
+ *
+ * @deprecated Prefer `initializeElurIonic` + `registerIonicComponents` + `registerIonicons` for new code.
+ */
+export declare function setupElurIonic(options?: SetupElurIonicOptions): void;
+export { addIcons, setAssetPath };

package/dist/lib/tabs-ByPLrzax.cjs

@@ -0,0 +1,50 @@
+let e=require("@elurjs/core"),t=require("@ionic/core/components"),n=require("@ionic/core/components/ion-app.js"),r=require("@ionic/core/components/ion-router-outlet.js"),i=require("@ionic/core/components/ion-back-button.js"),a=require("@ionic/core/components/ion-buttons.js"),o=require("ionicons/components/ion-icon.js"),s=require("ionicons"),c=require("ionicons/icons");var l=[n.defineCustomElement,r.defineCustomElement,i.defineCustomElement,a.defineCustomElement,o.defineCustomElement],u={"arrow-back":c.arrowBack,"arrow-back-sharp":c.arrowBackSharp,"chevron-back":c.chevronBack,"chevron-back-sharp":c.chevronBackSharp},d=!1,f=new Set;function p(){return typeof window<`u`}function m(){return typeof customElements<`u`}function h(e={}){let n=[];if(!p())return{initialized:!1,diagnostics:[`SSR: window unavailable, skipping init`]};if(d)return e.mode&&n.push(`mode cannot be changed after initialization; ignoring`),{initialized:!1,diagnostics:n};let r=e.icons??`inline`;if(r===`inline`)(0,s.setAssetPath)(``);else if(typeof r==`object`&&r.mode===`assets`)(0,s.setAssetPath)(r.path);else if(r===`assets`){let e=document.baseURI||`/`;(0,s.setAssetPath)(new URL(`assets/icons/`,e).href)}(0,t.initialize)();for(let e of l)e();(0,s.addIcons)(u);for(let e of Object.keys(u))f.add(e);return d=!0,{initialized:!0,diagnostics:n}}function g(...e){if(!m()){p()&&console.warn(`[elur-ionic] customElements unavailable; cannot register components`);return}for(let t of e)try{t()}catch(e){e instanceof Error&&!e.message.includes(`already been registered`)&&console.warn(`[elur-ionic] Component registration error: ${e.message}`)}}function _(e){if(!p())return;let t={};for(let[n,r]of Object.entries(e))f.has(n)&&console.warn(`[elur-ionic] Icon "${n}" already registered; overwriting.`),t[n]=r,f.add(n);Object.keys(t).length>0&&(0,s.addIcons)(t)}function v(e={}){if(!p())return;let t={};e.iconAssetPath&&(t.icons={mode:`assets`,path:e.iconAssetPath}),h(t),e.components&&g(...e.components),e.icons&&_(e.icons)}function y(e){return!e||e===`/`?`/`:e.endsWith(`/`)?e.slice(0,-1):e}function b(e,t){let n=y(t),r=y(e.path);return e.exact?n===r:r===`/`?n===`/`:n===r||n.startsWith(`${r}/`)}function x(e,t){if(!t?.length)return!1;let n=y(e);return t.some(e=>{let t=y(e);if(t.endsWith(`/*`)){let e=t.slice(0,-2);return n===e||n.startsWith(`${e}/`)}return n===t})}function S(e){return e?Object.entries(e).map(([e,t])=>`${e}: ${t}`).join(`; `):``}function C(t,n={}){let r=(0,e.elurRouter)(),i=n.slot??`bottom`,a=n.className??`elur-ion-tab-bar`,o=n.navigationDirection??`none`,c=n.layout??`icon-top`,l=n.cssVars;n.icons&&(0,s.addIcons)(n.icons);let u=(0,e.ref)(),d=!1;return(0,e.effect)(()=>{let n=r.current.value,i=u.el;if(!i){d||(0,e.nextTick)(()=>{d=!0;let e=u.el;e&&e.querySelectorAll(`ion-tab-button`).forEach((e,n)=>{let i=t[n];i&&(e.selected=b(i,r.current.value))})});return}i.querySelectorAll(`ion-tab-button`).forEach((e,r)=>{let i=t[r];i&&(e.selected=b(i,n))})}),e.html`
+    <ion-tab-bar
+      slot=${i}
+      class=${a}
+      ref=${u}
+      style=${()=>{let e=r.current.value,t=n.hideWhen?n.hideWhen(e):x(e,n.hiddenPaths);return[S(l),t?`display:none`:``].filter(Boolean).join(`; `)}}
+    >
+      ${t.map(t=>{let n=t.path===`/`?`root`:y(t.path).replace(/^\//,``).replace(/\//g,`-`),i=t.tabId??n;return e.html`
+          <ion-tab-button
+            tab=${i}
+            layout=${c}
+            @click.prevent.stop=${()=>{b(t,r.current.value)?r.replace(t.path,{direction:`none`}):r.navigate(t.path,{direction:o})}}
+          >
+            ${t.icon?e.html`
+                  <ion-icon
+                    name=${()=>b(t,r.current.value)&&t.activeIcon?t.activeIcon:t.icon}
+                  ></ion-icon>
+                `:``}
+            <ion-label>${t.label}</ion-label>
+            ${t.badge==null?``:e.html`<ion-badge color=${t.badgeColor??`danger`}>${t.badge}</ion-badge>`}
+          </ion-tab-button>
+        `})}
+    </ion-tab-bar>
+  `}function w(t,n){E();let r=t instanceof e.ElurComponent?t.render():t;return e.html`
+        <ion-tabs>
+            ${r}
+            ${n}
+        </ion-tabs>
+    `}var T=!1;function E(){if(T||typeof document>`u`)return;T=!0;let e=document.createElement(`style`);e.id=`elur-ionic-tabs-layout`,e.textContent=`
+ion-tabs {
+    display: flex !important;
+    flex-direction: column !important;
+    height: 100% !important;
+    width: 100% !important;
+    position: relative !important;
+}
+ion-tabs > ion-router-outlet {
+    flex: 1 1 0 !important;
+    min-height: 0 !important;
+    position: relative !important;
+    top: auto !important;
+    bottom: auto !important;
+    left: auto !important;
+    right: auto !important;
+}
+ion-tabs > ion-tab-bar {
+    flex-shrink: 0 !important;
+}
+`,document.head.appendChild(e)}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return C}});
+//# sourceMappingURL=tabs-ByPLrzax.cjs.map

package/dist/lib/tabs-ByPLrzax.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs-ByPLrzax.cjs","names":[],"sources":["../../src/setup.ts","../../src/tabs.ts"],"sourcesContent":["/**\n * @elurjs/ionic / setup.ts — v2 modular setup\n *\n * Architecture (Elur Ionic 2):\n *\n *   initializeElurIonic(options)   — configures Ionic Core once; returns a\n *                                    handle with status/diagnostics. Safe to\n *                                    call again (no-op after first init, but\n *                                    validates incompatible config changes).\n *\n *   registerIonicComponents(...definers)  — incremental & idempotent. Always\n *                                    registers new definers, skips already-\n *                                    registered custom elements. Works for\n *                                    lazy route loading.\n *\n *   registerIonicons(map)         — incremental with collision diagnostics.\n *                                    Merges new icons into the global set;\n *                                    warns on name collisions.\n *\n *   setupElurIonic(options)        — backward-compatible facade that calls all\n *                                    three. Existing apps work unchanged.\n *\n * Key changes vs v1.x:\n *   - No more `isInitialized` blocking: `registerIonicComponents` and\n *     `registerIonicons` are always incremental.\n *   - No `unpkg@latest` default asset path: uses official `setAssetPath` from\n *     ionicons. CDN is opt-in only.\n *   - SSR-safe: no `window` access at module load; guards in each function.\n *   - Returns a handle with diagnostics from `initializeElurIonic`.\n */\n\nimport { initialize } from \"@ionic/core/components\";\n\n// Minimal core components — the bare minimum any elur-ionic app needs.\nimport { defineCustomElement as defineIonApp } from \"@ionic/core/components/ion-app.js\";\nimport { defineCustomElement as defineIonRouterOutlet } from \"@ionic/core/components/ion-router-outlet.js\";\nimport { defineCustomElement as defineIonBackButton } from \"@ionic/core/components/ion-back-button.js\";\nimport { defineCustomElement as defineIonButtons } from \"@ionic/core/components/ion-buttons.js\";\n\n// Icons\nimport { defineCustomElement as defineIonIcon } from \"ionicons/components/ion-icon.js\";\nimport { addIcons, setAssetPath } from \"ionicons\";\nimport { arrowBack, arrowBackSharp, chevronBack, chevronBackSharp } from \"ionicons/icons\";\n\nexport type ComponentDefiner = () => void;\nexport type IconDefinitionMap = Record<string, string>;\n\nexport interface SetupElurIonicOptions {\n    /** @deprecated Use `icons` mode in `initializeElurIonic` instead. */\n    iconAssetPath?: string;\n    components?: ComponentDefiner[];\n    icons?: IconDefinitionMap;\n}\n\nexport interface InitializeOptions {\n    /**\n     * Icon asset strategy:\n     * - \"inline\" (default): icons are inlined via addIcons; no remote fetch.\n     * - \"assets\": use setAssetPath to a local URL; icons fetched on demand.\n     * - object with `mode: \"assets\"` and `path` for explicit local path.\n     */\n    icons?: \"inline\" | \"assets\" | { mode: \"assets\"; path: string };\n    /** Ionic mode override: \"ios\" | \"md\" | undefined (auto-detect). */\n    mode?: \"ios\" | \"md\";\n}\n\nexport interface SetupHandle {\n    /** True if this call performed the initialization; false if already init. */\n    readonly initialized: boolean;\n    /** Diagnostics collected during initialization. */\n    readonly diagnostics: string[];\n}\n\n// --- Internal registry state ---\n\nconst _coreDefiners: ComponentDefiner[] = [\n    defineIonApp,\n    defineIonRouterOutlet,\n    defineIonBackButton,\n    defineIonButtons,\n    defineIonIcon,\n];\n\nconst _defaultIcons: IconDefinitionMap = {\n    \"arrow-back\": arrowBack,\n    \"arrow-back-sharp\": arrowBackSharp,\n    \"chevron-back\": chevronBack,\n    \"chevron-back-sharp\": chevronBackSharp,\n};\n\nlet _initialized = false;\nconst _registeredIconNames = new Set<string>();\n\nfunction _hasWindow(): boolean {\n    return typeof window !== \"undefined\";\n}\n\nfunction _hasCustomElements(): boolean {\n    return typeof customElements !== \"undefined\";\n}\n\n/**\n * Initialize Ionic Core for Elur. Configures the runtime once.\n *\n * Subsequent calls are no-ops for the core init, but `registerIonicComponents`\n * and `registerIonicons` remain incremental regardless.\n *\n * Returns a handle with diagnostics.\n */\nexport function initializeElurIonic(options: InitializeOptions = {}): SetupHandle {\n    const diagnostics: string[] = [];\n\n    if (!_hasWindow()) {\n        // SSR/prerender: do not touch DOM. Module is import-safe.\n        return { initialized: false, diagnostics: [\"SSR: window unavailable, skipping init\"] };\n    }\n\n    if (_initialized) {\n        // Validate incompatible config changes after init.\n        if (options.mode) {\n            diagnostics.push(\"mode cannot be changed after initialization; ignoring\");\n        }\n        return { initialized: false, diagnostics };\n    }\n\n    // Icon asset strategy\n    const iconsCfg = options.icons ?? \"inline\";\n    if (iconsCfg === \"inline\") {\n        // Default: no remote asset path. Icons are inlined via addIcons.\n        // setAssetPath to empty string prevents any CDN fetch.\n        setAssetPath(\"\");\n    } else if (typeof iconsCfg === \"object\" && iconsCfg.mode === \"assets\") {\n        setAssetPath(iconsCfg.path);\n    } else if (iconsCfg === \"assets\") {\n        // \"assets\" mode without explicit path — use a sensible default\n        // relative to the document base.\n        const base = document.baseURI || \"/\";\n        setAssetPath(new URL(\"assets/icons/\", base).href);\n    }\n\n    // Initialize Ionic Core\n    initialize();\n\n    // Register minimal core components\n    for (const definer of _coreDefiners) {\n        definer();\n    }\n\n    // Register default back icons (used by IonBackButton)\n    addIcons(_defaultIcons);\n    for (const name of Object.keys(_defaultIcons)) {\n        _registeredIconNames.add(name);\n    }\n\n    _initialized = true;\n\n    return { initialized: true, diagnostics };\n}\n\n/**\n * Register additional Ionic custom element definers. Incremental and\n * idempotent — always processes new definers, safe to call from lazy routes.\n *\n * @example\n * ```ts\n * // In a lazy route module:\n * import { defineCustomElement as defineIonDatetime } from \"@ionic/core/components/ion-datetime.js\";\n * registerIonicComponents(defineIonDatetime);\n * ```\n */\nexport function registerIonicComponents(...definers: ComponentDefiner[]): void {\n    if (!_hasCustomElements()) {\n        if (_hasWindow()) {\n            console.warn(\"[elur-ionic] customElements unavailable; cannot register components\");\n        }\n        return;\n    }\n\n    for (const definer of definers) {\n        try {\n            definer();\n        } catch (e) {\n            // Ionic definers internally guard against double-registration,\n            // but we catch just in case.\n            if (e instanceof Error && !e.message.includes(\"already been registered\")) {\n                console.warn(`[elur-ionic] Component registration error: ${e.message}`);\n            }\n        }\n    }\n}\n\n/**\n * Register additional Ionicons by name → SVG string mapping. Incremental\n * with collision diagnostics.\n *\n * @example\n * ```ts\n * import { registerIonicons } from \"@elurjs/ionic\";\n * import { home, homeOutline } from \"ionicons/icons\";\n *\n * registerIonicons({ home, \"home-outline\": homeOutline });\n * ```\n */\nexport function registerIonicons(map: IconDefinitionMap): void {\n    if (!_hasWindow()) {\n        return;\n    }\n\n    const toAdd: IconDefinitionMap = {};\n    for (const [name, svg] of Object.entries(map)) {\n        if (_registeredIconNames.has(name)) {\n            // Overwriting is allowed (addIcons merges), but warn in dev.\n            console.warn(`[elur-ionic] Icon \"${name}\" already registered; overwriting.`);\n        }\n        toAdd[name] = svg;\n        _registeredIconNames.add(name);\n    }\n\n    if (Object.keys(toAdd).length > 0) {\n        addIcons(toAdd);\n    }\n}\n\n/**\n * Backward-compatible facade. Calls `initializeElurIonic`, then registers\n * any extra components and icons passed via options.\n *\n * Existing v1.x apps work unchanged. New apps should prefer the granular\n * functions (`initializeElurIonic` + `registerIonicComponents` + `registerIonicons`)\n * for lazy loading and HMR support.\n *\n * @deprecated Prefer `initializeElurIonic` + `registerIonicComponents` + `registerIonicons` for new code.\n */\nexport function setupElurIonic(options: SetupElurIonicOptions = {}): void {\n    if (!_hasWindow()) return;\n\n    // Map old options to new init\n    const initOpts: InitializeOptions = {};\n    if (options.iconAssetPath) {\n        initOpts.icons = { mode: \"assets\", path: options.iconAssetPath };\n    }\n\n    const handle = initializeElurIonic(initOpts);\n\n    // Register extra components (always incremental, even after init)\n    if (options.components) {\n        registerIonicComponents(...options.components);\n    }\n\n    // Register extra icons (always incremental, even after init)\n    if (options.icons) {\n        registerIonicons(options.icons);\n    }\n\n    void handle;\n}\n\nexport { addIcons, setAssetPath };\n","/**\n * @elurjs/ionic / tabs.ts  —  v2\n *\n * Bottom tab bar that drives navigation through the core router. The visual\n * \"active\" state is computed from `elurRouter().current` directly.\n *\n * Tab switches are intentionally direction:\"none\" — Ionic's convention is no\n * animation between tabs. Per-tab stacks (configured on IonRouterOutlet via\n * `tabs: [...]`) preserve each tab's deep view across switches.\n */\n\nimport { html, ElurComponent, effect, ref, nextTick } from \"@elurjs/core\";\nimport type { ElurTemplate } from \"@elurjs/core\";\nimport { elurRouter, type NavigationDirection } from \"@elurjs/core\";\nimport { addIcons, type IconDefinitionMap } from \"./setup.js\";\n\n/** Layout of icon and label inside each tab button. */\nexport type TabButtonLayout =\n    | \"icon-top\"\n    | \"icon-start\"\n    | \"icon-end\"\n    | \"icon-bottom\"\n    | \"icon-hide\"\n    | \"label-hide\";\n\nexport interface BottomTabItem {\n    path: string;\n    label: string;\n    icon?: string;\n    activeIcon?: string;\n    exact?: boolean;\n    tabId?: string;\n    /** Badge text or number (e.g. notification count). */\n    badge?: string | number;\n    /** Badge color (Ionic color name). Default: \"danger\". */\n    badgeColor?: string;\n}\n\nexport interface BottomTabBarOptions {\n    slot?: \"top\" | \"bottom\";\n    className?: string;\n    hiddenPaths?: string[];\n    /**\n     * Direction passed to the router on tab change.\n     * Default `\"none\"` — no animation, native Ionic feel.\n     */\n    navigationDirection?: NavigationDirection;\n    hideWhen?: (path: string) => boolean;\n    /**\n     * Icon SVG data to register for the tab bar icons.\n     *\n     * The Vite plugin can only detect static `name=\"icon-name\"` in html``\n     * templates. Tab bar icons are dynamic, so pass the data here.\n     */\n    icons?: IconDefinitionMap;\n    /**\n     * Layout of icon and label inside each tab button.\n     * Default: `\"icon-top\"`.\n     */\n    layout?: TabButtonLayout;\n    /**\n     * CSS custom properties to set on the `ion-tab-bar` element.\n     * Useful for theming: `--background`, `--color`, `--color-selected`, etc.\n     *\n     * @example\n     * ```ts\n     * createBottomTabBar(tabs, {\n     *   cssVars: {\n     *     \"--background\": \"#1a1a2e\",\n     *     \"--color-selected\": \"#00ff88\",\n     *   },\n     * });\n     * ```\n     */\n    cssVars?: Record<string, string>;\n}\n\nfunction _normalizePath(p: string): string {\n    if (!p || p === \"/\") return \"/\";\n    return p.endsWith(\"/\") ? p.slice(0, -1) : p;\n}\n\nfunction _isActive(tab: BottomTabItem, currentPath: string): boolean {\n    const cur = _normalizePath(currentPath);\n    const tgt = _normalizePath(tab.path);\n    if (tab.exact) return cur === tgt;\n    if (tgt === \"/\") return cur === \"/\";\n    return cur === tgt || cur.startsWith(`${tgt}/`);\n}\n\nfunction _isHidden(path: string, patterns?: string[]): boolean {\n    if (!patterns?.length) return false;\n    const cur = _normalizePath(path);\n    return patterns.some((pat) => {\n        const norm = _normalizePath(pat);\n        if (norm.endsWith(\"/*\")) {\n            const base = norm.slice(0, -2);\n            return cur === base || cur.startsWith(`${base}/`);\n        }\n        return cur === norm;\n    });\n}\n\n/** Convert a cssVars record to a CSS string for the style attribute. */\nfunction _cssVarsToString(vars: Record<string, string> | undefined): string {\n    if (!vars) return \"\";\n    return Object.entries(vars)\n        .map(([k, v]) => `${k}: ${v}`)\n        .join(\"; \");\n}\n\nexport function createBottomTabBar(\n    tabs: BottomTabItem[],\n    options: BottomTabBarOptions = {},\n): ElurTemplate {\n    const router = elurRouter();\n    const slot = options.slot ?? \"bottom\";\n    const className = options.className ?? \"elur-ion-tab-bar\";\n    const direction: NavigationDirection = options.navigationDirection ?? \"none\";\n    const layout: TabButtonLayout = options.layout ?? \"icon-top\";\n    const cssVars = options.cssVars;\n\n    // Register icons if provided.\n    if (options.icons) {\n        addIcons(options.icons);\n    }\n\n    // Stencil boolean props (like `selected`) cannot be set via HTML\n    // attributes with Elur. We use an effect to set the JS property\n    // directly on each ion-tab-button after it's in the DOM, and\n    // re-sync whenever the route changes.\n    const tabBarRef = ref<HTMLElement>();\n    let synced = false;\n    effect(() => {\n        const currentPath = router.current.value;\n        const tabBarEl = tabBarRef.el;\n        if (!tabBarEl) {\n            if (!synced) {\n                nextTick(() => {\n                    synced = true;\n                    const el = tabBarRef.el;\n                    if (!el) return;\n                    const btns = el.querySelectorAll(\"ion-tab-button\");\n                    btns.forEach((btn, i) => {\n                        const tab = tabs[i];\n                        if (!tab) return;\n                        (btn as any).selected = _isActive(tab, router.current.value);\n                    });\n                });\n            }\n            return;\n        }\n        const buttons = tabBarEl.querySelectorAll(\"ion-tab-button\");\n        buttons.forEach((btn, i) => {\n            const tab = tabs[i];\n            if (!tab) return;\n            const isActive = _isActive(tab, currentPath);\n            (btn as any).selected = isActive;\n        });\n    });\n\n    return html`\n    <ion-tab-bar\n      slot=${slot}\n      class=${className}\n      ref=${tabBarRef}\n      style=${() => {\n            const path = router.current.value;\n            const hidden = options.hideWhen\n                ? options.hideWhen(path)\n                : _isHidden(path, options.hiddenPaths);\n            const vars = _cssVarsToString(cssVars);\n            const display = hidden ? \"display:none\" : \"\";\n            return [vars, display].filter(Boolean).join(\"; \");\n        }}\n    >\n      ${tabs.map((tab) => {\n            const computedTabId = tab.path === \"/\"\n                ? \"root\"\n                : _normalizePath(tab.path).replace(/^\\//, \"\").replace(/\\//g, \"-\");\n            const tabId = tab.tabId ?? computedTabId;\n\n            return html`\n          <ion-tab-button\n            tab=${tabId}\n            layout=${layout}\n            @click.prevent.stop=${() => {\n                    // .prevent.stop prevents Ionic's internal tab selection\n                    // (which looks for <ion-tab> children we don't have).\n                    // We drive navigation through the Elur router instead.\n                    if (_isActive(tab, router.current.value)) {\n                        router.replace(tab.path, { direction: \"none\" });\n                    } else {\n                        router.navigate(tab.path, { direction });\n                    }\n                }}\n          >\n            ${tab.icon\n                    ? html`\n                  <ion-icon\n                    name=${() => {\n                            const active = _isActive(tab, router.current.value);\n                            return active && tab.activeIcon ? tab.activeIcon : tab.icon;\n                        }}\n                  ></ion-icon>\n                `\n                    : \"\"}\n            <ion-label>${tab.label}</ion-label>\n            ${tab.badge != null\n                    ? html`<ion-badge color=${tab.badgeColor ?? \"danger\"}>${tab.badge}</ion-badge>`\n                    : \"\"}\n          </ion-tab-button>\n        `;\n        })}\n    </ion-tab-bar>\n  `;\n}\n\n/**\n * Wraps an IonRouterOutlet and a tab bar in <ion-tabs>.\n *\n * <ion-tabs> provides the correct CSS layout context: the outlet fills\n * the available space and the tab bar sits at the bottom (or top).\n *\n * We use <ion-tabs> for layout only — navigation is driven by the\n * Elur router via the @click handler on each <ion-tab-button>, not\n * by Ionic's internal tab selection. The tab buttons have `tab` IDs\n * so Ionic doesn't warn, but there are no <ion-tab> children.\n *\n * A small CSS snippet is injected to ensure <ion-tabs> fills its\n * parent and the absolutely-positioned <ion-router-outlet> doesn't\n * collapse the layout.\n */\nexport function createTabsLayout(\n    outlet: ElurTemplate | ElurComponent,\n    tabBar: ElurTemplate,\n): ElurTemplate {\n    _injectTabsLayoutStyles();\n    const outletTemplate = outlet instanceof ElurComponent ? outlet.render() : outlet;\n    return html`\n        <ion-tabs>\n            ${outletTemplate}\n            ${tabBar}\n        </ion-tabs>\n    `;\n}\n\n/** Inject the tabs layout CSS once (idempotent). */\nlet _tabsStylesInjected = false;\nfunction _injectTabsLayoutStyles(): void {\n    if (_tabsStylesInjected) return;\n    if (typeof document === \"undefined\") return;\n    _tabsStylesInjected = true;\n    const style = document.createElement(\"style\");\n    style.id = \"elur-ionic-tabs-layout\";\n    // ion-tabs defaults to display:block with no explicit height, which\n    // collapses to the tab bar's height because ion-router-outlet is\n    // position:absolute. Force ion-tabs to fill its parent and use flexbox\n    // so the outlet takes the remaining space above the tab bar.\n    style.textContent = `\nion-tabs {\n    display: flex !important;\n    flex-direction: column !important;\n    height: 100% !important;\n    width: 100% !important;\n    position: relative !important;\n}\nion-tabs > ion-router-outlet {\n    flex: 1 1 0 !important;\n    min-height: 0 !important;\n    position: relative !important;\n    top: auto !important;\n    bottom: auto !important;\n    left: auto !important;\n    right: auto !important;\n}\nion-tabs > ion-tab-bar {\n    flex-shrink: 0 !important;\n}\n`;\n    document.head.appendChild(style);\n}\n"],"mappings":"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"}