@fluixi/core 1.0.0-alpha.53

package/dist/src/lib/server/reactive.js

@@ -0,0 +1,472 @@
+/**
+ * @fileoverview Server Reactive Primitives for Fluixi
+ * @module @fluixi/core/server/reactive
+ *
+ * Maps reactive primitives for server-side execution
+ * Following SolidJS pattern of server-specific reactive behavior
+ *
+ * Server mode:
+ * - Signals read-only snapshot
+ * - Effects run once
+ * - No scheduling
+ * - No subscriptions
+ */
+// ============================================================================
+// SERVER SIGNAL
+// ============================================================================
+/**
+ * Server createSignal - Returns snapshot value
+ *
+ * Section 4: Signals read-only snapshot on server
+ * No reactivity, no tracking, just initial value
+ *
+ * @template T
+ * @param {T} value - Initial value
+ * @param {SignalOptions<T>} options - SignalTuple options (ignored on server)
+ * @returns {SignalTuple<T>} Tuple of [getter, setter]
+ *
+ * @example
+ * ```typescript
+ * // On server, this returns a static snapshot
+ * const [count, setCount] = createSignal(0);
+ * console.log(count()); // 0
+ * setCount(1); // Updates value but triggers no effects
+ * console.log(count()); // 1
+ * ```
+ */
+export function createSignal(value, options) {
+    // Server: Simple read/write, no reactivity
+    let current = value;
+    const read = (() => current);
+    const write = (newValue) => {
+        if (typeof newValue === 'function') {
+            current = newValue(current);
+        }
+        else {
+            current = newValue;
+        }
+        return current;
+    };
+    return [read, write];
+}
+// ============================================================================
+// SERVER EFFECT
+// ============================================================================
+/**
+ * Server createEffect - Runs once, no tracking
+ *
+ * Section 4: Effects run once on server, no scheduling
+ * Execute immediately and return no-op disposer
+ *
+ * @param {(v?: any) => any} fn - Effect function
+ * @param {any} value - Initial value (optional)
+ * @param {any} options - Effect options (ignored on server)
+ * @returns {{ dispose: () => void }} Disposer object
+ *
+ * @example
+ * ```typescript
+ * // On server, runs once immediately
+ * createEffect(() => {
+ *   console.log('This runs once');
+ * });
+ * ```
+ */
+export function createEffect(fn, value, options) {
+    // Server: Run once, no tracking, no scheduling
+    try {
+        fn(value);
+    }
+    catch (error) {
+        console.error('[Fluixi Server] Effect error:', error);
+    }
+    // Return no-op disposer
+    return { dispose: () => { } };
+}
+// ============================================================================
+// SERVER MEMO
+// ============================================================================
+/**
+ * Server createMemo - Compute once, return static accessor
+ *
+ * Section 4: No tracking on server, single evaluation
+ * Memoizes value at creation time
+ *
+ * @template T
+ * @param {(v?: T) => T} fn - Computation function
+ * @param {T} value - Initial value (optional)
+ * @param {any} options - Memo options (ignored on server)
+ * @returns {Accessor<T>} Static accessor
+ *
+ * @example
+ * ```typescript
+ * const [count] = createSignal(5);
+ * const doubled = createMemo(() => count() * 2);
+ * console.log(doubled()); // 10 (computed once)
+ * ```
+ */
+export function createMemo(fn, value, options) {
+    // Server: Compute once, no reactivity
+    const computed = fn(value);
+    return (() => computed);
+}
+// ============================================================================
+// SERVER ROOT
+// ============================================================================
+/**
+ * Server createRoot - Creates owner but no reactive tracking
+ *
+ * Section 5: Owners exist on server for tree structure
+ * Needed for context and cleanup, but no reactive tracking
+ *
+ * @template T
+ * @param {(dispose: () => void) => T} fn - Root function
+ * @returns {T} Function result
+ *
+ * @example
+ * ```typescript
+ * const result = createRoot((dispose) => {
+ *   // Server: Executes once, maintains owner tree
+ *   return <App />;
+ * });
+ * ```
+ */
+export function createRoot(fn) {
+    // Server: Execute function with no-op disposer
+    // Owner tree maintained for context/cleanup
+    const cleanups = [];
+    const dispose = () => {
+        cleanups.forEach((cleanup) => {
+            try {
+                cleanup();
+            }
+            catch (error) {
+                console.error('[Fluixi Server] Cleanup error:', error);
+            }
+        });
+        cleanups.length = 0;
+    };
+    try {
+        return fn(dispose);
+    }
+    catch (error) {
+        dispose();
+        throw error;
+    }
+}
+// ============================================================================
+// SERVER BATCH
+// ============================================================================
+/**
+ * Server batch - Execute immediately, no batching
+ *
+ * Section 4: No scheduling on server
+ * Just runs the function synchronously
+ *
+ * @template T
+ * @param {() => T} fn - Function to batch
+ * @returns {T} Function result
+ *
+ * @example
+ * ```typescript
+ * batch(() => {
+ *   setCount(1);
+ *   setName('Alice');
+ * }); // Executes immediately
+ * ```
+ */
+export function batch(fn) {
+    // Server: No batching needed, just run
+    return fn();
+}
+// ============================================================================
+// SERVER UNTRACK
+// ============================================================================
+/**
+ * Server untrack - Execute function (already untracked)
+ *
+ * Section 4: No tracking on server anyway
+ * This is a no-op but exists for API compatibility
+ *
+ * @template T
+ * @param {() => T} fn - Function to run untracked
+ * @returns {T} Function result
+ *
+ * @example
+ * ```typescript
+ * untrack(() => {
+ *   return signal(); // Not tracked (but nothing is on server)
+ * });
+ * ```
+ */
+export function untrack(fn) {
+    // Server: Already untracked, just run
+    return fn();
+}
+// ============================================================================
+// SERVER CLEANUP
+// ============================================================================
+let currentCleanups = null;
+/**
+ * Server onCleanup - Register cleanup function
+ *
+ * Section 5: Cleanup still needed for SSR resource management
+ * Stores cleanup for execution when root disposes
+ *
+ * @param {() => void} fn - Cleanup function
+ *
+ * @example
+ * ```typescript
+ * createRoot((dispose) => {
+ *   onCleanup(() => {
+ *     console.log('Cleanup on dispose');
+ *   });
+ *   return result;
+ * });
+ * ```
+ */
+export function onCleanup(fn) {
+    if (currentCleanups) {
+        currentCleanups.push(fn);
+    }
+}
+// ============================================================================
+// SERVER OWNER
+// ============================================================================
+let currentOwner = null;
+/**
+ * Server getOwner - Get current reactive owner
+ *
+ * Section 5: Owner tree maintained on server for context
+ *
+ * @returns {RootOwner | null} Current owner or null
+ */
+export function getOwner() {
+    return currentOwner;
+}
+/**
+ * Server runWithOwner - Run function with specific owner
+ *
+ * Section 5: Owner switching for proper context nesting
+ *
+ * @template T
+ * @param {RootOwner | null} owner - Owner to run with
+ * @param {() => T} fn - Function to run
+ * @returns {T} Function result
+ */
+export function runWithOwner(owner, fn) {
+    const prev = currentOwner;
+    currentOwner = owner;
+    try {
+        return fn();
+    }
+    finally {
+        currentOwner = prev;
+    }
+}
+// ============================================================================
+// SERVER CONTEXT
+// ============================================================================
+const contextMap = new Map();
+/**
+ * Server createContext - Create context with default value
+ *
+ * Section 9: Context lookup-based, no subscriptions on server
+ *
+ * @template T
+ * @param {T} defaultValue - Default context value
+ * @returns {Context<T>} Context object
+ *
+ * @example
+ * ```typescript
+ * const ThemeContext = createContext('light');
+ * ```
+ */
+export function createContext(defaultValue) {
+    const id = Symbol('context');
+    const Provider = (props) => {
+        // Server: Store value in context map
+        const prevValue = contextMap.get(id);
+        contextMap.set(id, props.value);
+        try {
+            return props.children;
+        }
+        finally {
+            // Restore previous value
+            if (prevValue !== undefined) {
+                contextMap.set(id, prevValue);
+            }
+            else {
+                contextMap.delete(id);
+            }
+        }
+    };
+    return {
+        id,
+        Provider,
+        defaultValue: defaultValue,
+    };
+}
+/**
+ * Server useContext - Retrieve context value
+ *
+ * Section 9: No subscriptions on server, just lookup
+ *
+ * @template T
+ * @param {Context<T>} context - Context to use
+ * @returns {T} Context value
+ *
+ * @example
+ * ```typescript
+ * const theme = useContext(ThemeContext);
+ * ```
+ */
+export function useContext(context) {
+    // Server: Simple lookup, no subscription
+    const value = contextMap.get(context.id);
+    return value !== undefined ? value : context.defaultValue;
+}
+// ============================================================================
+// SERVER COMPUTED
+// ============================================================================
+/**
+ * Server createComputed - Alias for createEffect
+ *
+ * On server, computed values run once like effects
+ *
+ * @param {() => any} fn - Computation function
+ * @returns {{ dispose: () => void }} Disposer
+ */
+export function createComputed(fn) {
+    return createEffect(fn);
+}
+// ============================================================================
+// SERVER RENDER EFFECT
+// ============================================================================
+/**
+ * Server createRenderEffect - Runs once for SSR rendering
+ *
+ * @param {() => any} fn - Render effect function
+ * @returns {{ dispose: () => void }} Disposer
+ */
+export function createRenderEffect(fn) {
+    return createEffect(fn);
+}
+// ============================================================================
+// SERVER DEFERRED
+// ============================================================================
+/**
+ * Server createDeferred - No deferring on server
+ *
+ * @template T
+ * @param {() => T} fn - Deferred computation
+ * @returns {Accessor<T>} Accessor
+ */
+export function createDeferred(fn) {
+    return createMemo(fn);
+}
+// ============================================================================
+// SERVER SELECTOR
+// ============================================================================
+/**
+ * Server createSelector - Returns static equality check
+ *
+ * @template T
+ * @param {() => T} source - Source value
+ * @returns {(key: T) => boolean} Selector function
+ */
+// ENVIRONMENT
+export function createSelector(source) {
+    const value = source();
+    return (key) => key === value;
+}
+// ============================================================================
+// SERVER RESOURCE
+// ============================================================================
+/**
+ * Server createResource - Stub for resource creation
+ *
+ * @param source Source signal or value
+ * @param fetcher Fetcher function
+ * @param options Resource options
+ */
+export function createResource(source, fetcher, options) {
+    return [
+        () => undefined,
+        {
+            mutate: (v) => v,
+            refetch: () => { },
+        },
+    ];
+}
+/**
+ * Server createStore — plain object wrapper, no reactivity.
+ * Mirrors the client API so shared code compiles on both sides.
+ */
+export function createStore(init) {
+    const state = { ...init };
+    function setStore(keyOrPatch, value) {
+        if (typeof keyOrPatch === 'object' &&
+            keyOrPatch !== null &&
+            !Array.isArray(keyOrPatch)) {
+            for (const k of Object.keys(keyOrPatch)) {
+                const v = keyOrPatch[k];
+                state[k] = typeof v === 'function' ? v(state[k]) : v;
+            }
+        }
+        else {
+            state[keyOrPatch] =
+                typeof value === 'function' ? value(state[keyOrPatch]) : value;
+        }
+    }
+    return [state, setStore];
+}
+// ============================================================================
+// SERVER TRANSITION
+// ============================================================================
+/**
+ * Server startTransition - Execute immediately
+ *
+ * @param fn Transition function
+ */
+export function startTransition(fn) {
+    fn();
+}
+// ============================================================================
+// ENVIRONMENT
+// ============================================================================
+// ENVIRONMENT
+// ============================================================================
+/**
+ * Check if running on server
+ */
+export const isServer = true;
+/**
+ * Check if running on client
+ */
+export const isClient = false;
+// ============================================================================
+// COMPATIBILITY
+// ============================================================================
+/**
+ * Server sharedConfig - Empty config object for compatibility
+ */
+export const sharedConfig = {
+    context: null,
+    owner: null,
+};
+/**
+ * Set current reactive owner (for internal use)
+ * @internal
+ */
+export function setOwner(owner) {
+    currentOwner = owner;
+    sharedConfig.owner = owner;
+    sharedConfig.context = owner;
+}
+/**
+ * Get shared config (for compatibility)
+ * @internal
+ */
+export function getSharedConfig() {
+    return sharedConfig;
+}

package/dist/src/lib/server/reactive.mjs

@@ -0,0 +1 @@
+function f(e,t){let o=e;return[(()=>o),c=>(typeof c=="function"?o=c(o):o=c,o)]}function T(e,t,o){try{e(t)}catch(n){console.error("[Fluixi Server] Effect error:",n)}return{dispose:()=>{}}}function p(e,t,o){let n=e(t);return(()=>n)}function d(e){let t=[],o=()=>{t.forEach(n=>{try{n()}catch(r){console.error("[Fluixi Server] Cleanup error:",r)}}),t.length=0};try{return e(o)}catch(n){throw o(),n}}function x(e){return e()}function y(e){return e()}var l=null;function v(e){l&&l.push(e)}var s=null;function S(){return s}function g(e,t){let o=s;s=e;try{return t()}finally{s=o}}var i=new Map;function w(e){let t=Symbol("context");return{id:t,Provider:n=>{let r=i.get(t);i.set(t,n.value);try{return n.children}finally{r!==void 0?i.set(t,r):i.delete(t)}},defaultValue:e}}function C(e){let t=i.get(e.id);return t!==void 0?t:e.defaultValue}function h(e){return T(e)}function A(e){return T(e)}function K(e){return p(e)}function R(e){let t=e();return o=>o===t}function O(e,t,o){return[()=>{},{mutate:n=>n,refetch:()=>{}}]}function b(e){let t={...e};function o(n,r){if(typeof n=="object"&&n!==null&&!Array.isArray(n))for(let c of Object.keys(n)){let u=n[c];t[c]=typeof u=="function"?u(t[c]):u}else t[n]=typeof r=="function"?r(t[n]):r}return[t,o]}function m(e){e()}var j=!0,F=!1,a={context:null,owner:null};function E(e){s=e,a.owner=e,a.context=e}function k(){return a}export{x as batch,h as createComputed,w as createContext,K as createDeferred,T as createEffect,p as createMemo,A as createRenderEffect,O as createResource,d as createRoot,R as createSelector,f as createSignal,b as createStore,S as getOwner,k as getSharedConfig,F as isClient,j as isServer,v as onCleanup,g as runWithOwner,E as setOwner,a as sharedConfig,m as startTransition,y as untrack,C as useContext};

package/dist/src/lib/theme/index.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var x=(e,t)=>{for(var r in t)s(e,r,{get:t[r],enumerable:!0})},S=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of v(t))!p.call(e,i)&&i!==r&&s(e,i,{get:()=>t[i],enumerable:!(o=y(t,i))||o.enumerable});return e};var k=e=>S(s({},"__esModule",{value:!0}),e);var I={};x(I,{createTheme:()=>O});module.exports=k(I);var l=require("@fluixi/reactive/signal");function b(){let e=new Map;return{getItem:t=>e.has(t)?e.get(t):null,setItem:(t,r)=>{e.set(t,String(r))},removeItem:t=>{e.delete(t)},clear:()=>e.clear(),key:t=>Array.from(e.keys())[t]??null,get length(){return e.size}}}var a=typeof localStorage<"u"?localStorage:b(),c={get window(){return typeof window<"u"?window:void 0},get document(){return typeof document<"u"?document:void 0}};function w(e){return e?e===!0?{dark:"dark",light:"light"}:e:null}function O(e){let t=e.storageKey??"theme",r=e.attribute??"data-theme",o=w(e.system),i=()=>{let n=a.getItem(t);return n&&e.themes.includes(n)?n:o&&c.window?.matchMedia?.("(prefers-color-scheme: dark)")?.matches?o.dark:o?o.light:e.default},[d,f]=(0,l.createSignal)(i()),[T,u]=(0,l.createSignal)(!1),g=n=>{c.document?.documentElement.setAttribute(r,n);try{a.setItem(t,n)}catch{}},m=n=>{if(!e.themes.includes(n))return;let h=d();f(()=>n),g(n),e.onChange?.(n,h),e.load&&(u(!0),e.onLoading?.(n),Promise.resolve(e.load(n)).finally(()=>{u(!1),e.onLoaded?.(n)}))};return{value:d,isLoading:T,set:m,toggle:()=>{let n=e.themes.indexOf(d());m(e.themes[(n+1)%e.themes.length])},init:()=>g(d()),headScript:()=>`<script>(function(){try{var c=${JSON.stringify({k:t,a:r,d:e.default,sys:o})},t=localStorage.getItem(c.k);if(!t&&c.sys)t=matchMedia('(prefers-color-scheme: dark)').matches?c.sys.dark:c.sys.light;if(!t)t=c.d;document.documentElement.setAttribute(c.a,t);}catch(e){}})();<\/script>`}}

package/dist/src/lib/theme/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * createTheme — a reusable, SSR-safe theme store so every Fluixi app gets the whole
+ * theme workflow (detect → persist → apply → toggle, + the no-flash head script)
+ * without rewriting it. Generic over an arbitrary theme list (not just light/dark),
+ * with optional async theme loading and lifecycle hooks.
+ *
+ * Built on the universal `storage` + `env` utilities, so reading the stored theme at
+ * module-eval and touching `document`/`matchMedia` are safe on the server.
+ */
+import { type Accessor } from '@fluixi/reactive/signal';
+export interface ThemeOptions<T extends string> {
+    /** The full set of themes. `toggle()` cycles through them in order. */
+    themes: readonly T[];
+    /** Theme used when nothing is stored and system preference doesn't apply. */
+    default: T;
+    /** localStorage key the choice is persisted under (default `"theme"`). */
+    storageKey?: string;
+    /** Attribute set on `<html>` to drive CSS (default `"data-theme"`). */
+    attribute?: string;
+    /**
+     * Follow `prefers-color-scheme` when there is no stored choice. `true` assumes the
+     * themes literally include `"dark"`/`"light"`; pass `{ dark, light }` to map explicitly.
+     */
+    system?: boolean | {
+        dark: T;
+        light: T;
+    };
+    /** Optional async work per theme (e.g. lazy-import a CSS bundle). Drives `isLoading()`. */
+    load?: (theme: T) => void | Promise<void>;
+    /** Fired after a theme is applied. */
+    onChange?: (next: T, prev: T | undefined) => void;
+    /** Fired when an async `load` starts / finishes. */
+    onLoading?: (theme: T) => void;
+    onLoaded?: (theme: T) => void;
+}
+export interface Theme<T extends string> {
+    /** Reactive current theme. */
+    value: Accessor<T>;
+    /** Reactive — true while an async `load` is running. */
+    isLoading: Accessor<boolean>;
+    /** Set a specific theme (persists, applies, runs `load`/hooks). */
+    set: (theme: T) => void;
+    /** Cycle to the next theme in `themes`. */
+    toggle: () => void;
+    /** Apply the current theme to the DOM (call once on client mount). */
+    init: () => void;
+    /** Inline `<script>` for `<head>` that sets the attribute BEFORE first paint (no flash). */
+    headScript: () => string;
+}
+export declare function createTheme<T extends string>(options: ThemeOptions<T>): Theme<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/lib/theme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/theme/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGtE,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM;IAC5C,uEAAuE;IACvE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;IACrB,6EAA6E;IAC7E,OAAO,EAAE,CAAC,CAAC;IACX,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC;IACzC,2FAA2F;IAC3F,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,sCAAsC;IACtC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;IAClD,oDAAoD;IACpD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,MAAM;IACrC,8BAA8B;IAC9B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7B,mEAAmE;IACnE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACxB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,sEAAsE;IACtE,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,MAAM,CAAC;CAC1B;AAUD,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAiEhF"}

package/dist/src/lib/theme/index.js

@@ -0,0 +1,79 @@
+/**
+ * createTheme — a reusable, SSR-safe theme store so every Fluixi app gets the whole
+ * theme workflow (detect → persist → apply → toggle, + the no-flash head script)
+ * without rewriting it. Generic over an arbitrary theme list (not just light/dark),
+ * with optional async theme loading and lifecycle hooks.
+ *
+ * Built on the universal `storage` + `env` utilities, so reading the stored theme at
+ * module-eval and touching `document`/`matchMedia` are safe on the server.
+ */
+import { createSignal } from '@fluixi/reactive/signal';
+import { storage, env } from '../env/index.js';
+function systemMap(system) {
+    if (!system)
+        return null;
+    if (system === true)
+        return { dark: 'dark', light: 'light' };
+    return system;
+}
+export function createTheme(options) {
+    const storageKey = options.storageKey ?? 'theme';
+    const attribute = options.attribute ?? 'data-theme';
+    const sys = systemMap(options.system);
+    const detectInitial = () => {
+        const stored = storage.getItem(storageKey);
+        if (stored && options.themes.includes(stored))
+            return stored;
+        if (sys && env.window?.matchMedia?.('(prefers-color-scheme: dark)')?.matches)
+            return sys.dark;
+        if (sys)
+            return sys.light;
+        return options.default;
+    };
+    const [value, setValue] = createSignal(detectInitial());
+    const [isLoading, setLoading] = createSignal(false);
+    const apply = (t) => {
+        env.document?.documentElement.setAttribute(attribute, t);
+        try {
+            storage.setItem(storageKey, t);
+        }
+        catch {
+            /* best-effort persistence */
+        }
+    };
+    const set = (t) => {
+        if (!options.themes.includes(t))
+            return;
+        const prev = value();
+        setValue(() => t);
+        apply(t);
+        options.onChange?.(t, prev);
+        if (options.load) {
+            setLoading(true);
+            options.onLoading?.(t);
+            Promise.resolve(options.load(t)).finally(() => {
+                setLoading(false);
+                options.onLoaded?.(t);
+            });
+        }
+    };
+    const toggle = () => {
+        const i = options.themes.indexOf(value());
+        set(options.themes[(i + 1) % options.themes.length]);
+    };
+    const init = () => apply(value());
+    const headScript = () => {
+        const cfg = JSON.stringify({
+            k: storageKey,
+            a: attribute,
+            d: options.default,
+            sys,
+        });
+        // Runs before paint: read stored choice (or system pref), set the attribute, so the
+        // server-rendered HTML never flashes the default theme before hydration.
+        return (`<script>(function(){try{var c=${cfg},t=localStorage.getItem(c.k);` +
+            `if(!t&&c.sys)t=matchMedia('(prefers-color-scheme: dark)').matches?c.sys.dark:c.sys.light;` +
+            `if(!t)t=c.d;document.documentElement.setAttribute(c.a,t);}catch(e){}})();</script>`);
+    };
+    return { value, isLoading, set, toggle, init, headScript };
+}

package/dist/src/lib/theme/index.mjs

@@ -0,0 +1 @@
+import{createSignal as u}from"@fluixi/reactive/signal";function h(){let e=new Map;return{getItem:n=>e.has(n)?e.get(n):null,setItem:(n,o)=>{e.set(n,String(o))},removeItem:n=>{e.delete(n)},clear:()=>e.clear(),key:n=>Array.from(e.keys())[n]??null,get length(){return e.size}}}var d=typeof localStorage<"u"?localStorage:h(),s={get window(){return typeof window<"u"?window:void 0},get document(){return typeof document<"u"?document:void 0}};function y(e){return e?e===!0?{dark:"dark",light:"light"}:e:null}function w(e){let n=e.storageKey??"theme",o=e.attribute??"data-theme",r=y(e.system),g=()=>{let t=d.getItem(n);return t&&e.themes.includes(t)?t:r&&s.window?.matchMedia?.("(prefers-color-scheme: dark)")?.matches?r.dark:r?r.light:e.default},[i,m]=u(g()),[f,a]=u(!1),c=t=>{s.document?.documentElement.setAttribute(o,t);try{d.setItem(n,t)}catch{}},l=t=>{if(!e.themes.includes(t))return;let T=i();m(()=>t),c(t),e.onChange?.(t,T),e.load&&(a(!0),e.onLoading?.(t),Promise.resolve(e.load(t)).finally(()=>{a(!1),e.onLoaded?.(t)}))};return{value:i,isLoading:f,set:l,toggle:()=>{let t=e.themes.indexOf(i());l(e.themes[(t+1)%e.themes.length])},init:()=>c(i()),headScript:()=>`<script>(function(){try{var c=${JSON.stringify({k:n,a:o,d:e.default,sys:r})},t=localStorage.getItem(c.k);if(!t&&c.sys)t=matchMedia('(prefers-color-scheme: dark)').matches?c.sys.dark:c.sys.light;if(!t)t=c.d;document.documentElement.setAttribute(c.a,t);}catch(e){}})();<\/script>`}}export{w as createTheme};

package/dist/src/lib/utils/index.cjs

@@ -0,0 +1 @@
+"use strict";var i=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var m=(e,t)=>{for(var r in t)i(e,r,{get:t[r],enumerable:!0})},y=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of T(t))!p.call(e,o)&&o!==r&&i(e,o,{get:()=>t[o],enumerable:!(n=f(t,o))||n.enumerable});return e};var g=e=>y(i({},"__esModule",{value:!0}),e);var _={};m(_,{camelCase:()=>K,capitalize:()=>P,clamp:()=>k,debounce:()=>l,deepClone:()=>s,deepMerge:()=>u,formatBytes:()=>M,formatNumber:()=>b,groupBy:()=>E,isDefined:()=>D,isEmpty:()=>B,kebabCase:()=>w,memoize:()=>d,omit:()=>C,pick:()=>O,pipe:()=>R,random:()=>A,range:()=>S,retry:()=>c,sleep:()=>z,throttle:()=>x,uniqueId:()=>h});module.exports=g(_);function l(e,t){let r;return(...n)=>{clearTimeout(r),r=setTimeout(()=>e(...n),t)}}function x(e,t){let r;return(...n)=>{r||(e(...n),r=!0,setTimeout(()=>r=!1,t))}}function d(e){let t=new Map;return((...r)=>{let n=JSON.stringify(r);if(t.has(n))return t.get(n);let o=e(...r);return t.set(n,o),o})}function s(e){if(e===null||typeof e!="object")return e;if(e instanceof Date)return new Date(e.getTime());if(e instanceof Array)return Array.from(e).map(r=>s(r));if(e instanceof Set)return new Set(Array.from(e).map(r=>s(r)));if(e instanceof Map)return new Map(Array.from(e.entries()).map(([r,n])=>[s(r),s(n)]));let t={};for(let r in e)e.hasOwnProperty(r)&&(t[r]=s(e[r]));return t}function u(...e){let t={};for(let r of e)for(let n in r)if(r.hasOwnProperty(n)){let o=r[n];o!==null&&typeof o=="object"&&!Array.isArray(o)?t[n]=u(t[n]||{},o):t[n]=o}return t}function h(e=""){return e+Math.random().toString(36).substr(2,9)}function b(e){return e.toString().replace(/\B(?=(\d{3})+(?!\d))/g,",")}function M(e,t=2){if(e===0)return"0 Bytes";let r=1024,n=t<0?0:t,o=["Bytes","KB","MB","GB","TB","PB"],a=Math.floor(Math.log(e)/Math.log(r));return parseFloat((e/Math.pow(r,a)).toFixed(n))+" "+o[a]}function P(e){return e.charAt(0).toUpperCase()+e.slice(1)}function w(e){return e.replace(/([a-z])([A-Z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase()}function K(e){return e.replace(/[-_\s](.)/g,(t,r)=>r.toUpperCase())}function k(e,t,r){return Math.min(Math.max(e,t),r)}function A(e,t){return Math.floor(Math.random()*(t-e+1))+e}function B(e){return e==null?!0:typeof e=="string"?e.trim().length===0:Array.isArray(e)?e.length===0:typeof e=="object"?Object.keys(e).length===0:!1}function O(e,...t){let r={};return t.forEach(n=>{n in e&&(r[n]=e[n])}),r}function C(e,...t){let r={...e};return t.forEach(n=>{delete r[n]}),r}function E(e,t){return e.reduce((r,n)=>{let o=t(n),a=r.get(o)||[];return a.push(n),r.set(o,a),r},new Map)}function S(e,t,r=1){let n=[];for(let o=e;o<=t;o+=r)n.push(o);return n}async function c(e,t=3,r=1e3){try{return await e()}catch(n){if(t<=0)throw n;return await new Promise(o=>setTimeout(o,r)),c(e,t-1,r)}}function z(e){return new Promise(t=>setTimeout(t,e))}function D(e){return e!=null}function R(...e){return t=>e.reduce((r,n)=>n(r),t)}