flexium 0.8.15 → 0.9.0

package/dist/signal-mNtlF8-v.d.cts

@@ -1,158 +0,0 @@
-/**
- * Runs a function once when the component mounts.
- * Unlike effect(), onMount does not track dependencies - it runs exactly once.
- *
- * @param fn - Function to run on mount. Can return a cleanup function.
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   onMount(() => {
- *     console.log('Mounted!');
- *     return () => console.log('Unmounted!');
- *   });
- *   return <div>Hello</div>;
- * }
- * ```
- */
-declare function onMount(fn: () => void | (() => void)): void;
-/**
- * Base interface for reactive signals
- * @internal
- */
-interface Signal<T> {
-    value: T;
-    (): T;
-    set(value: T): void;
-    peek(): T;
-}
-/**
- * Computed signal interface (read-only)
- * @internal
- */
-interface Computed<T> {
-    readonly value: T;
-    (): T;
-    peek(): T;
-}
-/**
- * Creates a reactive signal
- *
- * @param initialValue - The initial value of the signal
- * @returns A signal object with value getter/setter
- *
- * @example
- * const count = signal(0);
- * count.value++; // triggers subscribers
- * console.log(count()); // alternative getter syntax
- */
-declare function signal<T>(initialValue: T): Signal<T>;
-/**
- * Creates a computed signal (derived value)
- * @internal Use `state(() => ...)` instead
- */
-declare function computed<T>(fn: () => T): Computed<T>;
-/**
- * Creates a side effect that runs when dependencies change
- *
- * @param fn - Effect function, can return a cleanup function
- * @param options - Optional error handler
- * @returns Dispose function to stop the effect
- *
- * @example
- * const count = signal(0);
- * const dispose = effect(() => {
- *   console.log('Count:', count.value);
- *   return () => console.log('Cleanup');
- * });
- */
-declare function effect(fn: () => void | (() => void), options?: {
-    onError?: (error: Error) => void;
-    name?: string;
-}): () => void;
-/**
- * Execute a function without tracking signal dependencies.
- * Useful when you need to read signals inside an effect without creating dependencies.
- *
- * @param fn - Function to execute without tracking
- * @returns The return value of fn
- *
- * @example
- * ```tsx
- * const count = signal(0);
- * const name = signal('Alice');
- *
- * effect(() => {
- *   // Only re-runs when count changes, not name
- *   console.log(count(), untrack(() => name()));
- * });
- * ```
- */
-declare function untrack<T>(fn: () => T): T;
-/**
- * Batches multiple signal updates together.
- * Effects will only run once after all updates complete.
- *
- * @param fn - Function containing signal updates to batch
- * @returns The return value of fn
- *
- * @example
- * ```tsx
- * const count = signal(0);
- * const name = signal('Alice');
- *
- * effect(() => console.log(count(), name())); // runs once
- *
- * batch(() => {
- *   count.value = 1;
- *   name.value = 'Bob';
- * }); // effect runs only once after batch completes
- * ```
- */
-declare function batch<T>(fn: () => T): T;
-/**
- * Creates a root scope for effects
- * All effects created within the scope can be disposed together
- *
- * @param fn - Function that creates effects
- * @returns Dispose function for all effects in the scope
- */
-declare function root<T>(fn: (dispose: () => void) => T): T;
-/**
- * Check if a value is a signal
- * @internal Use state() which handles all reactive patterns
- */
-declare function isSignal(value: unknown): value is Signal<any> | Computed<any>;
-/**
- * Registers a cleanup function that runs before the current effect re-runs or is disposed
- *
- * @param fn - Cleanup function
- */
-declare function onCleanup(fn: () => void): void;
-/**
- * Resource interface for async data
- */
-interface Resource<T> extends Signal<T | undefined> {
-    loading: boolean;
-    error: any;
-    state: 'unresolved' | 'pending' | 'ready' | 'refreshing' | 'errored';
-    latest: T | undefined;
-    /**
-     * Read value, throwing Promise if pending or Error if failed.
-     * Used by Suspense.
-     */
-    read: () => T | undefined;
-}
-/**
- * Creates a resource for handling async data
- * @internal Use state(async () => ...) instead which returns [data, refetch, status, error]
- */
-declare function createResource<T, S = any>(source: S | Signal<S> | (() => S), fetcher: (source: S, { value, refetching }: {
-    value: T | undefined;
-    refetching: any;
-}) => Promise<T>): [Resource<T>, {
-    mutate: (v: T | undefined) => void;
-    refetch: () => void;
-}];
-
-export { type Computed as C, type Signal as S, createResource as a, onMount as b, computed as c, batch as d, effect as e, isSignal as i, onCleanup as o, root as r, signal as s, untrack as u };

package/dist/signal-mNtlF8-v.d.ts

@@ -1,158 +0,0 @@
-/**
- * Runs a function once when the component mounts.
- * Unlike effect(), onMount does not track dependencies - it runs exactly once.
- *
- * @param fn - Function to run on mount. Can return a cleanup function.
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   onMount(() => {
- *     console.log('Mounted!');
- *     return () => console.log('Unmounted!');
- *   });
- *   return <div>Hello</div>;
- * }
- * ```
- */
-declare function onMount(fn: () => void | (() => void)): void;
-/**
- * Base interface for reactive signals
- * @internal
- */
-interface Signal<T> {
-    value: T;
-    (): T;
-    set(value: T): void;
-    peek(): T;
-}
-/**
- * Computed signal interface (read-only)
- * @internal
- */
-interface Computed<T> {
-    readonly value: T;
-    (): T;
-    peek(): T;
-}
-/**
- * Creates a reactive signal
- *
- * @param initialValue - The initial value of the signal
- * @returns A signal object with value getter/setter
- *
- * @example
- * const count = signal(0);
- * count.value++; // triggers subscribers
- * console.log(count()); // alternative getter syntax
- */
-declare function signal<T>(initialValue: T): Signal<T>;
-/**
- * Creates a computed signal (derived value)
- * @internal Use `state(() => ...)` instead
- */
-declare function computed<T>(fn: () => T): Computed<T>;
-/**
- * Creates a side effect that runs when dependencies change
- *
- * @param fn - Effect function, can return a cleanup function
- * @param options - Optional error handler
- * @returns Dispose function to stop the effect
- *
- * @example
- * const count = signal(0);
- * const dispose = effect(() => {
- *   console.log('Count:', count.value);
- *   return () => console.log('Cleanup');
- * });
- */
-declare function effect(fn: () => void | (() => void), options?: {
-    onError?: (error: Error) => void;
-    name?: string;
-}): () => void;
-/**
- * Execute a function without tracking signal dependencies.
- * Useful when you need to read signals inside an effect without creating dependencies.
- *
- * @param fn - Function to execute without tracking
- * @returns The return value of fn
- *
- * @example
- * ```tsx
- * const count = signal(0);
- * const name = signal('Alice');
- *
- * effect(() => {
- *   // Only re-runs when count changes, not name
- *   console.log(count(), untrack(() => name()));
- * });
- * ```
- */
-declare function untrack<T>(fn: () => T): T;
-/**
- * Batches multiple signal updates together.
- * Effects will only run once after all updates complete.
- *
- * @param fn - Function containing signal updates to batch
- * @returns The return value of fn
- *
- * @example
- * ```tsx
- * const count = signal(0);
- * const name = signal('Alice');
- *
- * effect(() => console.log(count(), name())); // runs once
- *
- * batch(() => {
- *   count.value = 1;
- *   name.value = 'Bob';
- * }); // effect runs only once after batch completes
- * ```
- */
-declare function batch<T>(fn: () => T): T;
-/**
- * Creates a root scope for effects
- * All effects created within the scope can be disposed together
- *
- * @param fn - Function that creates effects
- * @returns Dispose function for all effects in the scope
- */
-declare function root<T>(fn: (dispose: () => void) => T): T;
-/**
- * Check if a value is a signal
- * @internal Use state() which handles all reactive patterns
- */
-declare function isSignal(value: unknown): value is Signal<any> | Computed<any>;
-/**
- * Registers a cleanup function that runs before the current effect re-runs or is disposed
- *
- * @param fn - Cleanup function
- */
-declare function onCleanup(fn: () => void): void;
-/**
- * Resource interface for async data
- */
-interface Resource<T> extends Signal<T | undefined> {
-    loading: boolean;
-    error: any;
-    state: 'unresolved' | 'pending' | 'ready' | 'refreshing' | 'errored';
-    latest: T | undefined;
-    /**
-     * Read value, throwing Promise if pending or Error if failed.
-     * Used by Suspense.
-     */
-    read: () => T | undefined;
-}
-/**
- * Creates a resource for handling async data
- * @internal Use state(async () => ...) instead which returns [data, refetch, status, error]
- */
-declare function createResource<T, S = any>(source: S | Signal<S> | (() => S), fetcher: (source: S, { value, refetching }: {
-    value: T | undefined;
-    refetching: any;
-}) => Promise<T>): [Resource<T>, {
-    mutate: (v: T | undefined) => void;
-    refetch: () => void;
-}];
-
-export { type Computed as C, type Signal as S, createResource as a, onMount as b, computed as c, batch as d, effect as e, isSignal as i, onCleanup as o, root as r, signal as s, untrack as u };

package/dist/state-kK9sQh9s.d.cts

@@ -1,73 +0,0 @@
-/** Key type - string or array of serializable values */
-type StateKey = string | readonly (string | number | boolean | null | undefined | object)[];
-/** Action function type for state mutation */
-type StateAction<T> = (newValue: T | ((prev: T) => T)) => void;
-/**
- * StateValue type - a value-like proxy that behaves like T.
- * Can be used directly in expressions and JSX.
- */
-type StateValue<T> = T & (() => T);
-/** Async state status */
-type AsyncStatus = 'idle' | 'loading' | 'success' | 'error';
-/** Options for state() */
-interface StateOptions<P = unknown> {
-    /**
-     * Key for global state sharing. Can be a string or array.
-     * Array keys are useful for hierarchical namespacing.
-     * @example
-     * state('light', { key: 'theme' })
-     * state(null, { key: ['user', 'profile', userId] })
-     */
-    key?: StateKey;
-    /**
-     * Parameters to pass to the function (for computed/async state).
-     * Improves DX by making dependencies explicit.
-     * @example
-     * state(
-     *   async ({ userId }) => fetch(`/api/users/${userId}`),
-     *   { key: ['user', userId], params: { userId } }
-     * )
-     */
-    params?: P;
-}
-/**
- * Unified State API
- *
- * One function for all reactive state needs - always returns an array for consistency:
- * 1. Simple state: const [count, setCount] = state(0)
- * 2. Derived state: const [doubled] = state(() => count * 2)
- * 3. Async state: const [data, refetch, status, error] = state(async () => fetch(...))
- * 4. Global state: const [theme, setTheme] = state('light', { key: 'theme' })
- * 5. With params: const [user] = state(async (p) => fetch(`/api/${p.id}`), { params: { id } })
- *
- * @example
- * ```tsx
- * function Counter() {
- *   const [count, setCount] = state(0)
- *   const [doubled] = state(() => count * 2)
- *   return <Button onPress={() => setCount(count + 1)}>{doubled}</Button>
- * }
- * ```
- */
-interface StateFunction {
-    <T>(initialValue: T, options?: StateOptions): [StateValue<T>, StateAction<T>];
-    <T, P>(computeFn: (params: P) => T, options: StateOptions<P> & {
-        params: P;
-    }): [StateValue<T>];
-    <T>(computeFn: () => T, options?: StateOptions): [StateValue<T>];
-    <T, P>(fetcher: (params: P) => Promise<T>, options: StateOptions<P> & {
-        params: P;
-    }): [StateValue<T | undefined>, () => void, StateValue<AsyncStatus>, StateValue<unknown>];
-    <T>(fetcher: () => Promise<T>, options?: StateOptions): [StateValue<T | undefined>, () => void, StateValue<AsyncStatus>, StateValue<unknown>];
-    /** Delete a specific global state by key */
-    delete: (key: StateKey) => boolean;
-    /** Clear all global states */
-    clear: () => void;
-    /** Check if a global state exists */
-    has: (key: StateKey) => boolean;
-    /** Current number of global states */
-    readonly size: number;
-}
-declare const _state: StateFunction;
-
-export { type AsyncStatus as A, type StateAction as S, _state as _, type StateValue as a, type StateKey as b, type StateOptions as c };

package/dist/state-kK9sQh9s.d.ts

@@ -1,73 +0,0 @@
-/** Key type - string or array of serializable values */
-type StateKey = string | readonly (string | number | boolean | null | undefined | object)[];
-/** Action function type for state mutation */
-type StateAction<T> = (newValue: T | ((prev: T) => T)) => void;
-/**
- * StateValue type - a value-like proxy that behaves like T.
- * Can be used directly in expressions and JSX.
- */
-type StateValue<T> = T & (() => T);
-/** Async state status */
-type AsyncStatus = 'idle' | 'loading' | 'success' | 'error';
-/** Options for state() */
-interface StateOptions<P = unknown> {
-    /**
-     * Key for global state sharing. Can be a string or array.
-     * Array keys are useful for hierarchical namespacing.
-     * @example
-     * state('light', { key: 'theme' })
-     * state(null, { key: ['user', 'profile', userId] })
-     */
-    key?: StateKey;
-    /**
-     * Parameters to pass to the function (for computed/async state).
-     * Improves DX by making dependencies explicit.
-     * @example
-     * state(
-     *   async ({ userId }) => fetch(`/api/users/${userId}`),
-     *   { key: ['user', userId], params: { userId } }
-     * )
-     */
-    params?: P;
-}
-/**
- * Unified State API
- *
- * One function for all reactive state needs - always returns an array for consistency:
- * 1. Simple state: const [count, setCount] = state(0)
- * 2. Derived state: const [doubled] = state(() => count * 2)
- * 3. Async state: const [data, refetch, status, error] = state(async () => fetch(...))
- * 4. Global state: const [theme, setTheme] = state('light', { key: 'theme' })
- * 5. With params: const [user] = state(async (p) => fetch(`/api/${p.id}`), { params: { id } })
- *
- * @example
- * ```tsx
- * function Counter() {
- *   const [count, setCount] = state(0)
- *   const [doubled] = state(() => count * 2)
- *   return <Button onPress={() => setCount(count + 1)}>{doubled}</Button>
- * }
- * ```
- */
-interface StateFunction {
-    <T>(initialValue: T, options?: StateOptions): [StateValue<T>, StateAction<T>];
-    <T, P>(computeFn: (params: P) => T, options: StateOptions<P> & {
-        params: P;
-    }): [StateValue<T>];
-    <T>(computeFn: () => T, options?: StateOptions): [StateValue<T>];
-    <T, P>(fetcher: (params: P) => Promise<T>, options: StateOptions<P> & {
-        params: P;
-    }): [StateValue<T | undefined>, () => void, StateValue<AsyncStatus>, StateValue<unknown>];
-    <T>(fetcher: () => Promise<T>, options?: StateOptions): [StateValue<T | undefined>, () => void, StateValue<AsyncStatus>, StateValue<unknown>];
-    /** Delete a specific global state by key */
-    delete: (key: StateKey) => boolean;
-    /** Clear all global states */
-    clear: () => void;
-    /** Check if a global state exists */
-    has: (key: StateKey) => boolean;
-    /** Current number of global states */
-    readonly size: number;
-}
-declare const _state: StateFunction;
-
-export { type AsyncStatus as A, type StateAction as S, _state as _, type StateValue as a, type StateKey as b, type StateOptions as c };