@molecule/app-solid 1.0.0

package/dist/primitives/storage.js

@@ -0,0 +1,275 @@
+/**
+ * Solid.js primitives for storage.
+ *
+ * @module
+ */
+import { createEffect, createSignal } from 'solid-js';
+import { getStorageProvider } from '../context.js';
+/**
+ * Create a storage value primitive.
+ *
+ * @param key - Storage key
+ * @param defaultValue - Default value if not found
+ * @returns Storage value accessor and actions
+ *
+ * @example
+ * ```tsx
+ * import { createStorageValue } from '@molecule/app-solid'
+ *
+ * function ThemeSelector() {
+ *   const { value, set, loading } = createStorageValue<string>('theme', 'light')
+ *
+ *   return (
+ *     <Show when={!loading()} fallback={<Loading />}>
+ *       <select
+ *         value={value()}
+ *         onChange={(e) => set(e.target.value)}
+ *       >
+ *         <option value="light">Light</option>
+ *         <option value="dark">Dark</option>
+ *       </select>
+ *     </Show>
+ *   )
+ * }
+ * ```
+ */
+export function createStorageValue(key, defaultValue) {
+    const storage = getStorageProvider();
+    const [state, setState] = createSignal({
+        value: defaultValue,
+        loading: true,
+        error: null,
+    });
+    // Load initial value
+    createEffect(() => {
+        storage
+            .get(key)
+            .then((value) => {
+            setState({
+                value: value ?? defaultValue,
+                loading: false,
+                error: null,
+            });
+        })
+            .catch((err) => {
+            setState({
+                value: defaultValue,
+                loading: false,
+                error: err instanceof Error ? err : new Error(String(err)),
+            });
+        });
+    });
+    const set = async (value) => {
+        try {
+            await storage.set(key, value);
+            setState((prev) => ({ ...prev, value, error: null }));
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setState((prev) => ({ ...prev, error }));
+            throw error;
+        }
+    };
+    const remove = async () => {
+        try {
+            await storage.remove(key);
+            setState((prev) => ({ ...prev, value: defaultValue, error: null }));
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setState((prev) => ({ ...prev, error }));
+            throw error;
+        }
+    };
+    const refresh = async () => {
+        setState((prev) => ({ ...prev, loading: true }));
+        try {
+            const value = await storage.get(key);
+            setState({
+                value: value ?? defaultValue,
+                loading: false,
+                error: null,
+            });
+            return value ?? defaultValue;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setState({
+                value: defaultValue,
+                loading: false,
+                error,
+            });
+            return defaultValue;
+        }
+    };
+    return {
+        value: () => state().value,
+        loading: () => state().loading,
+        error: () => state().error,
+        set,
+        remove,
+        refresh,
+    };
+}
+/**
+ * Create storage primitives.
+ *
+ * @returns Storage methods
+ *
+ * @example
+ * ```tsx
+ * function SettingsManager() {
+ *   const storage = createStorage()
+ *
+ *   const saveSettings = async (settings: Settings) => {
+ *     await storage.set('settings', settings)
+ *   }
+ *
+ *   const loadSettings = async () => {
+ *     return await storage.get<Settings>('settings')
+ *   }
+ * }
+ * ```
+ */
+export function createStorage() {
+    const storage = getStorageProvider();
+    return {
+        get: (key) => storage.get(key),
+        set: (key, value) => storage.set(key, value),
+        remove: (key) => storage.remove(key),
+        clear: () => storage.clear(),
+        keys: () => storage.keys(),
+    };
+}
+/**
+ * Create a persisted signal that syncs with storage.
+ *
+ * @param key - Storage key
+ * @param defaultValue - Default value
+ * @returns Tuple of accessor and setter
+ *
+ * @example
+ * ```tsx
+ * function Counter() {
+ *   const [count, setCount] = usePersistedSignal('counter', 0)
+ *
+ *   return (
+ *     <button onClick={() => setCount((c) => (c ?? 0) + 1)}>
+ *       Count: {count() ?? 0}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+export function usePersistedSignal(key, defaultValue) {
+    const storage = getStorageProvider();
+    const [value, setValue] = createSignal(defaultValue);
+    // Load initial value
+    createEffect(() => {
+        storage.get(key).then((stored) => {
+            if (stored != null) {
+                setValue(() => stored);
+            }
+        });
+    });
+    // Persist on change (skip initial)
+    let initialized = false;
+    createEffect(() => {
+        const current = value();
+        if (initialized && current !== undefined) {
+            storage.set(key, current);
+        }
+        initialized = true;
+    });
+    const setAndPersist = (newValue) => {
+        if (typeof newValue === 'function') {
+            setValue((prev) => {
+                const next = newValue(prev);
+                storage.set(key, next);
+                return next;
+            });
+        }
+        else {
+            setValue(() => newValue);
+            storage.set(key, newValue);
+        }
+    };
+    return [value, setAndPersist];
+}
+/**
+ * Create storage helpers from context.
+ *
+ * @returns Storage helper functions
+ */
+export function createStorageHelpers() {
+    const storage = getStorageProvider();
+    return {
+        get: (key) => storage.get(key),
+        set: (key, value) => storage.set(key, value),
+        remove: (key) => storage.remove(key),
+        clear: () => storage.clear(),
+        keys: () => storage.keys(),
+    };
+}
+/**
+ * Create storage primitives from a specific provider.
+ *
+ * @param storage - Storage provider
+ * @returns Storage methods
+ */
+export function createStorageFromProvider(storage) {
+    return {
+        get: (key) => storage.get(key),
+        set: (key, value) => storage.set(key, value),
+        remove: (key) => storage.remove(key),
+        clear: () => storage.clear(),
+        keys: () => storage.keys(),
+    };
+}
+/**
+ * Create storage value primitive from a specific provider.
+ *
+ * @param storage - Storage provider
+ * @param key - Storage key
+ * @param defaultValue - Default value
+ * @returns Storage value accessor and actions
+ */
+export function createStorageValueFromProvider(storage, key, defaultValue) {
+    const [state, setState] = createSignal({
+        value: defaultValue,
+        loading: true,
+        error: null,
+    });
+    createEffect(() => {
+        storage
+            .get(key)
+            .then((value) => {
+            setState({
+                value: value ?? defaultValue,
+                loading: false,
+                error: null,
+            });
+        })
+            .catch((err) => {
+            setState({
+                value: defaultValue,
+                loading: false,
+                error: err instanceof Error ? err : new Error(String(err)),
+            });
+        });
+    });
+    return {
+        value: () => state().value,
+        loading: () => state().loading,
+        error: () => state().error,
+        set: async (value) => {
+            await storage.set(key, value);
+            setState((prev) => ({ ...prev, value, error: null }));
+        },
+        remove: async () => {
+            await storage.remove(key);
+            setState((prev) => ({ ...prev, value: defaultValue, error: null }));
+        },
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/primitives/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/primitives/storage.ts"],"names":[],"mappings":"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"}

package/dist/primitives/theme.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Solid.js primitives for theming.
+ *
+ * @module
+ */
+import { type Accessor } from 'solid-js';
+import type { Theme, ThemeColors, ThemeProvider } from '@molecule/app-theme';
+import type { ThemePrimitives } from '../types.js';
+/**
+ * Create theme primitives for theme state and actions.
+ *
+ *
+ * @example
+ * ```tsx
+ * import { createTheme } from '@molecule/app-solid'
+ *
+ * function ThemeToggle() {
+ *   const { mode, toggleTheme } = createTheme()
+ *
+ *   return (
+ *     <button onClick={toggleTheme}>
+ *       Current: {mode()} - Click to toggle
+ *     </button>
+ *   )
+ * }
+ * ```
+ * @returns The created instance.
+ */
+export declare function createTheme(): ThemePrimitives;
+/**
+ * Create a mode accessor.
+ *
+ * @returns Accessor for current mode
+ *
+ * @example
+ * ```tsx
+ * function ModeIndicator() {
+ *   const mode = useMode()
+ *   return <div class={mode() === 'dark' ? 'dark-mode' : 'light-mode'}>...</div>
+ * }
+ * ```
+ */
+export declare function useMode(): Accessor<'light' | 'dark'>;
+/**
+ * Create a theme name accessor.
+ *
+ * @returns Accessor for current theme name
+ */
+export declare function useThemeName(): Accessor<string>;
+/**
+ * Create theme helpers from context.
+ *
+ * @returns Theme helper functions
+ */
+/**
+ * Creates a theme helpers.
+ * @returns The created result.
+ */
+export declare function createThemeHelpers(): {
+    getTheme: () => Theme;
+    setTheme: (name: string) => void;
+    getMode: () => 'light' | 'dark';
+    toggleMode: () => void;
+    getAvailableThemes: () => Theme[];
+};
+/**
+ * Create theme primitives from a specific provider.
+ *
+ * @param provider - Theme provider
+ * @returns Theme primitives
+ */
+export declare function createThemeFromProvider(provider: ThemeProvider): ThemePrimitives;
+/**
+ * Create a colors accessor derived from a theme accessor.
+ *
+ * @param theme - Theme accessor (e.g. from createTheme().theme)
+ * @returns Accessor for the current theme colors
+ *
+ * @example
+ * ```tsx
+ * function ColorSwatch() {
+ *   const { theme } = createTheme()
+ *   const colors = createThemeColors(theme)
+ *
+ *   return (
+ *     <div style={{ background: colors().background, color: colors().text }}>
+ *       Primary: {colors().primary}
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export declare function createThemeColors(theme: Accessor<Theme>): Accessor<ThemeColors>;
+/**
+ * Apply theme CSS variables to document.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   applyThemeToDocument()
+ *   return <MyApp />
+ * }
+ * ```
+ */
+export declare function applyThemeToDocument(): void;
+//# sourceMappingURL=theme.d.ts.map

package/dist/primitives/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/primitives/theme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAyC,MAAM,UAAU,CAAA;AAE/E,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAG5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,IAAI,eAAe,CAgC7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,IAAI,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAAC,MAAM,CAAC,CAG/C;AAED;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,QAAQ,EAAE,MAAM,KAAK,CAAA;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,OAAO,EAAE,MAAM,OAAO,GAAG,MAAM,CAAA;IAC/B,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,kBAAkB,EAAE,MAAM,KAAK,EAAE,CAAA;CAClC,CAUA;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,eAAe,CAkBhF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAE/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAoC3C"}

package/dist/primitives/theme.js

@@ -0,0 +1,187 @@
+/**
+ * Solid.js primitives for theming.
+ *
+ * @module
+ */
+import { createEffect, createSignal, onCleanup } from 'solid-js';
+import { getThemeProvider } from '../context.js';
+/**
+ * Create theme primitives for theme state and actions.
+ *
+ *
+ * @example
+ * ```tsx
+ * import { createTheme } from '@molecule/app-solid'
+ *
+ * function ThemeToggle() {
+ *   const { mode, toggleTheme } = createTheme()
+ *
+ *   return (
+ *     <button onClick={toggleTheme}>
+ *       Current: {mode()} - Click to toggle
+ *     </button>
+ *   )
+ * }
+ * ```
+ * @returns The created instance.
+ */
+export function createTheme() {
+    const provider = getThemeProvider();
+    const [theme, setThemeSignal] = createSignal(provider.getTheme());
+    // Subscribe to theme changes
+    createEffect(() => {
+        const unsubscribe = provider.subscribe((newTheme) => {
+            setThemeSignal(newTheme);
+        });
+        onCleanup(unsubscribe);
+    });
+    const themeName = () => theme().name;
+    const mode = () => theme().mode;
+    const setTheme = (name) => {
+        provider.setTheme(name);
+    };
+    const toggleTheme = () => {
+        provider.toggleMode();
+    };
+    return {
+        theme,
+        themeName,
+        mode,
+        setTheme,
+        toggleTheme,
+    };
+}
+/**
+ * Create a mode accessor.
+ *
+ * @returns Accessor for current mode
+ *
+ * @example
+ * ```tsx
+ * function ModeIndicator() {
+ *   const mode = useMode()
+ *   return <div class={mode() === 'dark' ? 'dark-mode' : 'light-mode'}>...</div>
+ * }
+ * ```
+ */
+export function useMode() {
+    const { mode } = createTheme();
+    return mode;
+}
+/**
+ * Create a theme name accessor.
+ *
+ * @returns Accessor for current theme name
+ */
+export function useThemeName() {
+    const { themeName } = createTheme();
+    return themeName;
+}
+/**
+ * Create theme helpers from context.
+ *
+ * @returns Theme helper functions
+ */
+/**
+ * Creates a theme helpers.
+ * @returns The created result.
+ */
+export function createThemeHelpers() {
+    const provider = getThemeProvider();
+    return {
+        getTheme: () => provider.getTheme(),
+        setTheme: (name) => provider.setTheme(name),
+        getMode: () => provider.getTheme().mode,
+        toggleMode: () => provider.toggleMode(),
+        getAvailableThemes: () => provider.getThemes?.() ?? [],
+    };
+}
+/**
+ * Create theme primitives from a specific provider.
+ *
+ * @param provider - Theme provider
+ * @returns Theme primitives
+ */
+export function createThemeFromProvider(provider) {
+    const [theme, setThemeSignal] = createSignal(provider.getTheme());
+    createEffect(() => {
+        const unsubscribe = provider.subscribe((newTheme) => {
+            setThemeSignal(newTheme);
+        });
+        onCleanup(unsubscribe);
+    });
+    return {
+        theme,
+        themeName: () => theme().name,
+        mode: () => theme().mode,
+        setTheme: (name) => provider.setTheme(name),
+        toggleTheme: () => provider.toggleMode(),
+    };
+}
+/**
+ * Create a colors accessor derived from a theme accessor.
+ *
+ * @param theme - Theme accessor (e.g. from createTheme().theme)
+ * @returns Accessor for the current theme colors
+ *
+ * @example
+ * ```tsx
+ * function ColorSwatch() {
+ *   const { theme } = createTheme()
+ *   const colors = createThemeColors(theme)
+ *
+ *   return (
+ *     <div style={{ background: colors().background, color: colors().text }}>
+ *       Primary: {colors().primary}
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export function createThemeColors(theme) {
+    return () => theme().colors;
+}
+/**
+ * Apply theme CSS variables to document.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   applyThemeToDocument()
+ *   return <MyApp />
+ * }
+ * ```
+ */
+export function applyThemeToDocument() {
+    const { theme } = createTheme();
+    createEffect(() => {
+        const currentTheme = theme();
+        const root = document.documentElement;
+        // Apply colors
+        if (currentTheme.colors) {
+            Object.entries(currentTheme.colors).forEach(([key, value]) => {
+                root.style.setProperty(`--color-${key}`, value);
+            });
+        }
+        // Apply spacing
+        if (currentTheme.spacing) {
+            Object.entries(currentTheme.spacing).forEach(([key, value]) => {
+                root.style.setProperty(`--spacing-${key}`, value);
+            });
+        }
+        // Apply typography
+        if (currentTheme.typography) {
+            Object.entries(currentTheme.typography).forEach(([key, value]) => {
+                if (typeof value === 'object') {
+                    Object.entries(value).forEach(([prop, val]) => {
+                        root.style.setProperty(`--typography-${key}-${prop}`, val);
+                    });
+                }
+            });
+        }
+        // Set mode class
+        root.classList.remove('light', 'dark');
+        root.classList.add(currentTheme.mode);
+    });
+}
+//# sourceMappingURL=theme.js.map

package/dist/primitives/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/primitives/theme.ts"],"names":[],"mappings":"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"}

package/dist/primitives/version.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Solid.js primitives for version and update management.
+ *
+ * @module
+ */
+import { type Accessor } from 'solid-js';
+import type { UpdateCheckOptions, VersionState } from '@molecule/app-version';
+/**
+ * Version primitives return type.
+ */
+export interface VersionPrimitives {
+    state: Accessor<VersionState>;
+    isUpdateAvailable: Accessor<boolean>;
+    isChecking: Accessor<boolean>;
+    isServiceWorkerWaiting: Accessor<boolean>;
+    newVersion: Accessor<string | undefined>;
+    checkForUpdates: () => Promise<boolean>;
+    applyUpdate: (options?: {
+        force?: boolean;
+    }) => void;
+    dismissUpdate: () => void;
+    startPeriodicChecks: (options?: UpdateCheckOptions) => void;
+    stopPeriodicChecks: () => void;
+}
+/**
+ * Create version primitives for tracking app updates.
+ *
+ * @returns Version primitives object
+ *
+ * @example
+ * ```tsx
+ * import { createVersion } from '@molecule/app-solid'
+ *
+ * function UpdateBanner() {
+ *   const { isUpdateAvailable, newVersion, applyUpdate, dismissUpdate } = createVersion()
+ *
+ *   return (
+ *     <Show when={isUpdateAvailable()}>
+ *       <div>
+ *         <span>Version {newVersion()} is available!</span>
+ *         <button onClick={() => applyUpdate()}>Update</button>
+ *         <button onClick={() => dismissUpdate()}>Dismiss</button>
+ *       </div>
+ *     </Show>
+ *   )
+ * }
+ * ```
+ */
+export declare function createVersion(): VersionPrimitives;
+//# sourceMappingURL=version.d.ts.map

package/dist/primitives/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/primitives/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAA2B,MAAM,UAAU,CAAA;AAEjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAG7E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;IAC7B,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACpC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7B,sBAAsB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACzC,UAAU,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAA;IACpD,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,mBAAmB,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC3D,kBAAkB,EAAE,MAAM,IAAI,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CAoCjD"}