flexium 0.10.7 → 0.12.8

package/dist/components-C83mBQXW.d.ts

@@ -1,126 +0,0 @@
-import { S as StateValue } from './state-DitsMyev.js';
-import { a as FNodeChild, F as FNode } from './renderer-DSLb-FGg.js';
-
-interface Location {
-    pathname: string;
-    search: string;
-    hash: string;
-    query: Record<string, string>;
-}
-interface RouterContext {
-    location: StateValue<Location>;
-    params: StateValue<Record<string, string>>;
-    navigate: (path: string) => void;
-    matches: StateValue<RouteMatch[]>;
-}
-interface RouteProps {
-    path?: string;
-    index?: boolean;
-    component: Function;
-    children?: FNodeChild;
-    beforeEnter?: (params: Record<string, string>) => boolean | Promise<boolean>;
-}
-interface RouteMatch {
-    route: RouteDef;
-    params: Record<string, string>;
-    pathname: string;
-}
-interface RouteDef {
-    path: string;
-    index: boolean;
-    component: Function;
-    children: RouteDef[];
-    beforeEnter?: (params: Record<string, string>) => boolean | Promise<boolean>;
-}
-interface LinkProps {
-    to: string;
-    class?: string;
-    children?: FNodeChild;
-}
-
-/**
- * Router Core Module
- *
- * Provides core routing functionality including location management,
- * path matching, and navigation.
- */
-
-/**
- * Creates a reactive location signal and navigate function.
- *
- * The location signal automatically updates when:
- * - navigate() is called
- * - Browser back/forward buttons are used (popstate event)
- *
- * @returns Tuple of [location signal, navigate function, cleanup function]
- *
- * @example
- * ```tsx
- * const [location, navigate, cleanup] = createLocation();
- * // Access current path
- * console.log(location().pathname);
- * // Navigate to new path
- * navigate('/users/123');
- * // Cleanup when done (removes popstate listener)
- * cleanup();
- * ```
- */
-declare function createLocation(): [StateValue<Location>, (path: string) => void, () => void];
-/**
- * Check if a path contains unsafe protocols (XSS prevention)
- * @param path - Path to validate
- * @returns true if path is unsafe
- */
-declare function isUnsafePath(path: string): boolean;
-/**
- * Sanitize query parameter value to prevent XSS
- * @param value - Query parameter value
- * @returns Sanitized value
- */
-declare function sanitizeQueryValue(value: string): string;
-/**
- * Matches a pathname against a route pattern.
- *
- * Supports dynamic segments with `:param` syntax.
- *
- * @param pathname - Current URL pathname (e.g., "/users/123")
- * @param routePath - Route pattern (e.g., "/users/:id")
- * @returns Object with `matches` boolean and extracted `params`
- *
- * @example
- * ```tsx
- * const result = matchPath('/users/123', '/users/:id');
- * // { matches: true, params: { id: '123' } }
- * ```
- */
-declare function matchPath(pathname: string, routePath: string): {
-    matches: boolean;
-    params: Record<string, string>;
-};
-
-/**
- * Get the current router context.
- * Must be called within a <Router> component.
- *
- * @example
- * ```tsx
- * const r = router()
- * r.navigate('/dashboard')
- * ```
- */
-declare function router(): RouterContext;
-declare function Router(props: {
-    children: FNodeChild;
-}): () => FNode;
-/**
- * Route configuration component.
- * Doesn't render anything directly; used by Router to build the route tree.
- */
-declare function Route(_props: RouteProps): null;
-/**
- * Renders the child route content.
- */
-declare function Outlet(): (() => FNode | null) | null;
-declare function Link(props: LinkProps): FNode;
-
-export { type Location as L, Outlet as O, type RouteDef as R, type RouteMatch as a, type RouterContext as b, type RouteProps as c, type LinkProps as d, createLocation as e, Router as f, Route as g, Link as h, isUnsafePath as i, matchPath as m, router as r, sanitizeQueryValue as s };

package/dist/core-CxHP8991.d.cts

@@ -1,32 +0,0 @@
-import './state-DitsMyev.cjs';
-
-/**
- * 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
- * ```ts
- * const [count, setCount] = state(0);
- *
- * effect(() => {
- *   console.log(count());
- * });
- *
- * setCount(1); // logs: 1
- * ```
- */
-declare function effect(fn: () => void | (() => void), options?: {
-    onError?: (error: Error) => void;
-    name?: string;
-}): () => void;
-/**
- * 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;
-
-export { effect as e, onCleanup as o };

package/dist/core-D0ggvjX3.d.ts

@@ -1,32 +0,0 @@
-import './state-DitsMyev.js';
-
-/**
- * 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
- * ```ts
- * const [count, setCount] = state(0);
- *
- * effect(() => {
- *   console.log(count());
- * });
- *
- * setCount(1); // logs: 1
- * ```
- */
-declare function effect(fn: () => void | (() => void), options?: {
-    onError?: (error: Error) => void;
-    name?: string;
-}): () => void;
-/**
- * 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;
-
-export { effect as e, onCleanup as o };

package/dist/effect-554ONNZR.js

@@ -1,2 +0,0 @@
-'use strict';var chunkWWEWRI6S_js=require('./chunk-WWEWRI6S.js');require('./chunk-GYDP6MFV.js');Object.defineProperty(exports,"EffectNode",{enumerable:true,get:function(){return chunkWWEWRI6S_js.b}});Object.defineProperty(exports,"effect",{enumerable:true,get:function(){return chunkWWEWRI6S_js.c}});Object.defineProperty(exports,"onCleanup",{enumerable:true,get:function(){return chunkWWEWRI6S_js.d}});//# sourceMappingURL=effect-554ONNZR.js.map
-//# sourceMappingURL=effect-554ONNZR.js.map

package/dist/effect-554ONNZR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"effect-554ONNZR.js"}

package/dist/effect-T2GVIS3T.mjs

@@ -1,2 +0,0 @@
-export{b as EffectNode,c as effect,d as onCleanup}from'./chunk-HB5VPQTB.mjs';import'./chunk-ECYYIQEX.mjs';//# sourceMappingURL=effect-T2GVIS3T.mjs.map
-//# sourceMappingURL=effect-T2GVIS3T.mjs.map

package/dist/effect-T2GVIS3T.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"effect-T2GVIS3T.mjs"}

package/dist/owner-QS9tPwPr.d.cts

@@ -1,27 +0,0 @@
-/**
- * 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
- */
-declare function untrack<T>(fn: () => T): T;
-/**
- * Creates a disposal scope.
- * The return value of the function is returned, and a dispose function is returned.
- *
- * @param fn - Function to run within a new root scope
- * @returns [return value of fn, dispose function]
- *
- * @example
- * ```tsx
- * const [val, dispose] = root((dispose) => {
- *   effect(() => console.log('Inside root'));
- *   return 123;
- * });
- * dispose(); // Cleans up all effects created inside
- * ```
- */
-declare function root<T>(fn: (dispose: () => void) => T): T;
-
-export { root as r, untrack as u };

package/dist/owner-QS9tPwPr.d.ts

@@ -1,27 +0,0 @@
-/**
- * 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
- */
-declare function untrack<T>(fn: () => T): T;
-/**
- * Creates a disposal scope.
- * The return value of the function is returned, and a dispose function is returned.
- *
- * @param fn - Function to run within a new root scope
- * @returns [return value of fn, dispose function]
- *
- * @example
- * ```tsx
- * const [val, dispose] = root((dispose) => {
- *   effect(() => console.log('Inside root'));
- *   return 123;
- * });
- * dispose(); // Cleans up all effects created inside
- * ```
- */
-declare function root<T>(fn: (dispose: () => void) => T): T;
-
-export { root as r, untrack as u };

package/dist/portal-BK_0Z0hE.d.cts

@@ -1,206 +0,0 @@
-import { R as Renderer, E as EventHandler, F as FNode } from './renderer-DSLb-FGg.cjs';
-import { S as StateValue } from './state-DitsMyev.cjs';
-
-/**
- * DOM Renderer implementation
- */
-declare class DOMRenderer implements Renderer {
-    createNode(type: string, props: Record<string, any>): HTMLElement | SVGElement;
-    updateNode(node: HTMLElement | SVGElement, oldProps: Record<string, any>, newProps: Record<string, any>): void;
-    appendChild(parent: Node, child: Node): void;
-    insertBefore(parent: Node, child: Node, beforeChild: Node | null): void;
-    nextSibling(node: Node): Node | null;
-    removeChild(parent: Node, child: Node): void;
-    createTextNode(text: string): Text;
-    updateTextNode(node: Text, text: string): void;
-    addEventListener(node: Node, event: string, handler: EventHandler): void;
-    removeEventListener(node: Node, event: string, _handler: EventHandler): void;
-}
-/**
- * Default DOM renderer instance
- */
-declare const domRenderer: DOMRenderer;
-
-/**
- * JSX Factory Function (f)
- *
- * This module provides the JSX factory function for creating Flexium nodes.
- * It's used by the JSX transpiler to convert JSX syntax into function calls.
- *
- * Usage in tsconfig.json:
- * {
- *   "compilerOptions": {
- *     "jsx": "react",
- *     "jsxFactory": "f",
- *     "jsxFragmentFactory": "Fragment"
- *   }
- * }
- */
-
-/**
- * JSX factory function for Flexium
- * Creates a Flexium node from JSX syntax
- *
- * @param type - Element type (string for built-in, function for components)
- * @param props - Element properties
- * @param children - Child elements
- * @returns Flexium node
- */
-declare function f(type: string | Function, props: Record<string, any> | null, ...children: any[]): FNode;
-/**
- * Fragment component
- * Renders children without a wrapper element
- */
-declare function Fragment(props: {
-    children?: any[];
-}): FNode;
-
-/**
- * DOM Render Function
- *
- * This module provides the main render function for mounting components to the DOM.
- * It includes simple reconciliation logic for mounting and unmounting components.
- *
- * Note: This module uses reactive rendering internally via mountReactive.
- * For root-level rendering with cleanup support, use createReactiveRoot.
- */
-
-/**
- * Render a component to a DOM container with automatic reactivity
- *
- * This function uses reactive rendering by default, which means:
- * - Signals passed as children automatically update the DOM
- * - Signals in props automatically update element properties
- * - Component functions automatically re-render when signals change
- *
- * @param vnode - Flexium node to render
- * @returns The rendered DOM node
- *
- * @example
- * const count = signal(0);
- * render(f('div', {}, [count]), document.body);
- * // The div will automatically update when count changes
- */
-/**
- * Mounts a Flexium node to a container
- * @param node - Flexium node to render
- * @param container - DOM element to mount to
- */
-declare function render(node: FNode | string | number | null | undefined | Function, container: HTMLElement): Node | null;
-/**
- * Create a root for rendering with automatic reactivity
- *
- * This creates a root that supports fine-grained reactive updates.
- * Signals are automatically tracked and only the affected DOM nodes are updated.
- *
- * @param container - DOM element to render into
- * @returns Root object with render and unmount methods
- *
- * @example
- * const root = createRoot(document.body);
- * const count = signal(0);
- * root.render(f('div', {}, [count]));
- * // Later: count.value++ will automatically update the DOM
- */
-declare function createRoot(container: HTMLElement): {
-    render(node: FNode): void;
-    unmount(): void;
-};
-
-/**
- * Getter function that returns the current value (signal-like)
- */
-type ItemsGetter<T> = () => T[];
-/**
- * Fixed-height item configuration
- */
-interface FixedSizeConfig {
-    mode: 'fixed';
-    itemHeight: number;
-}
-/**
- * Variable-height item configuration
- */
-interface VariableSizeConfig {
-    mode: 'variable';
-    estimatedItemHeight: number;
-    getItemHeight?: (index: number, item: unknown) => number;
-}
-type SizeConfig = FixedSizeConfig | VariableSizeConfig;
-/**
- * List component marker
- */
-interface ListComponent<T> {
-    [key: symbol]: true;
-    each: ItemsGetter<T>;
-    renderItem: (item: T, index: () => number) => FNode;
-    virtual: boolean;
-    height?: number | string;
-    width?: number | string;
-    itemSize?: number | SizeConfig;
-    overscan: number;
-    getKey?: (item: T, index: number) => string | number;
-    onScroll?: (scrollTop: number) => void;
-    onVisibleRangeChange?: (startIndex: number, endIndex: number) => void;
-    class?: string;
-    style?: Record<string, string | number>;
-}
-
-/**
- * Reactive DOM Rendering
- *
- * Integrates the signal system with the DOM renderer to enable fine-grained
- * reactive updates. Only the specific DOM nodes that depend on changed signals
- * will be updated, without re-rendering the entire component tree.
- */
-
-/**
- * Mount a virtual node reactively to the DOM.
- *
- * This is the core rendering function that handles all node types:
- * - FNodes (both built-in elements and function components)
- * - Strings and numbers (text nodes)
- * - Signals and computed values (reactive children)
- * - StateValues from the state() API
- * - ListComponents
- * - Arrays and fragments
- *
- * Reactive values are automatically tracked and DOM updates occur
- * only when the specific values change (fine-grained reactivity).
- *
- * @param vnode - The virtual node to mount
- * @param container - Optional parent node to append to
- * @returns The created DOM node, or null for empty/boolean values
- *
- * @example
- * ```tsx
- * // Mount a simple element
- * const node = mountReactive(<div>Hello</div>, document.body)
- *
- * // Mount a reactive signal
- * const count = signal(0)
- * mountReactive(() => <span>{count.value}</span>, container)
- * ```
- */
-declare function mountReactive(node: FNode | string | number | boolean | StateValue<any> | null | undefined | Function | any[] | ListComponent<any>, container?: Node): Node | null;
-declare function createReactiveRoot(container: HTMLElement): {
-    render(node: FNode): void;
-    unmount(): void;
-};
-
-interface PortalProps {
-    mount?: HTMLElement;
-    children: any;
-}
-/**
- * <Portal> component renders its children into a different part of the DOM.
- * Useful for modals, tooltips, etc.
- *
- * @example
- * <Portal mount={document.body}>
- *   <div class="modal">...</div>
- * </Portal>
- */
-declare function Portal(props: PortalProps): Comment | null;
-
-export { DOMRenderer as D, Fragment as F, type ListComponent as L, Portal as P, createReactiveRoot as a, createRoot as c, domRenderer as d, f, mountReactive as m, render as r };

package/dist/portal-CbguxtuQ.d.ts

@@ -1,206 +0,0 @@
-import { R as Renderer, E as EventHandler, F as FNode } from './renderer-DSLb-FGg.js';
-import { S as StateValue } from './state-DitsMyev.js';
-
-/**
- * DOM Renderer implementation
- */
-declare class DOMRenderer implements Renderer {
-    createNode(type: string, props: Record<string, any>): HTMLElement | SVGElement;
-    updateNode(node: HTMLElement | SVGElement, oldProps: Record<string, any>, newProps: Record<string, any>): void;
-    appendChild(parent: Node, child: Node): void;
-    insertBefore(parent: Node, child: Node, beforeChild: Node | null): void;
-    nextSibling(node: Node): Node | null;
-    removeChild(parent: Node, child: Node): void;
-    createTextNode(text: string): Text;
-    updateTextNode(node: Text, text: string): void;
-    addEventListener(node: Node, event: string, handler: EventHandler): void;
-    removeEventListener(node: Node, event: string, _handler: EventHandler): void;
-}
-/**
- * Default DOM renderer instance
- */
-declare const domRenderer: DOMRenderer;
-
-/**
- * JSX Factory Function (f)
- *
- * This module provides the JSX factory function for creating Flexium nodes.
- * It's used by the JSX transpiler to convert JSX syntax into function calls.
- *
- * Usage in tsconfig.json:
- * {
- *   "compilerOptions": {
- *     "jsx": "react",
- *     "jsxFactory": "f",
- *     "jsxFragmentFactory": "Fragment"
- *   }
- * }
- */
-
-/**
- * JSX factory function for Flexium
- * Creates a Flexium node from JSX syntax
- *
- * @param type - Element type (string for built-in, function for components)
- * @param props - Element properties
- * @param children - Child elements
- * @returns Flexium node
- */
-declare function f(type: string | Function, props: Record<string, any> | null, ...children: any[]): FNode;
-/**
- * Fragment component
- * Renders children without a wrapper element
- */
-declare function Fragment(props: {
-    children?: any[];
-}): FNode;
-
-/**
- * DOM Render Function
- *
- * This module provides the main render function for mounting components to the DOM.
- * It includes simple reconciliation logic for mounting and unmounting components.
- *
- * Note: This module uses reactive rendering internally via mountReactive.
- * For root-level rendering with cleanup support, use createReactiveRoot.
- */
-
-/**
- * Render a component to a DOM container with automatic reactivity
- *
- * This function uses reactive rendering by default, which means:
- * - Signals passed as children automatically update the DOM
- * - Signals in props automatically update element properties
- * - Component functions automatically re-render when signals change
- *
- * @param vnode - Flexium node to render
- * @returns The rendered DOM node
- *
- * @example
- * const count = signal(0);
- * render(f('div', {}, [count]), document.body);
- * // The div will automatically update when count changes
- */
-/**
- * Mounts a Flexium node to a container
- * @param node - Flexium node to render
- * @param container - DOM element to mount to
- */
-declare function render(node: FNode | string | number | null | undefined | Function, container: HTMLElement): Node | null;
-/**
- * Create a root for rendering with automatic reactivity
- *
- * This creates a root that supports fine-grained reactive updates.
- * Signals are automatically tracked and only the affected DOM nodes are updated.
- *
- * @param container - DOM element to render into
- * @returns Root object with render and unmount methods
- *
- * @example
- * const root = createRoot(document.body);
- * const count = signal(0);
- * root.render(f('div', {}, [count]));
- * // Later: count.value++ will automatically update the DOM
- */
-declare function createRoot(container: HTMLElement): {
-    render(node: FNode): void;
-    unmount(): void;
-};
-
-/**
- * Getter function that returns the current value (signal-like)
- */
-type ItemsGetter<T> = () => T[];
-/**
- * Fixed-height item configuration
- */
-interface FixedSizeConfig {
-    mode: 'fixed';
-    itemHeight: number;
-}
-/**
- * Variable-height item configuration
- */
-interface VariableSizeConfig {
-    mode: 'variable';
-    estimatedItemHeight: number;
-    getItemHeight?: (index: number, item: unknown) => number;
-}
-type SizeConfig = FixedSizeConfig | VariableSizeConfig;
-/**
- * List component marker
- */
-interface ListComponent<T> {
-    [key: symbol]: true;
-    each: ItemsGetter<T>;
-    renderItem: (item: T, index: () => number) => FNode;
-    virtual: boolean;
-    height?: number | string;
-    width?: number | string;
-    itemSize?: number | SizeConfig;
-    overscan: number;
-    getKey?: (item: T, index: number) => string | number;
-    onScroll?: (scrollTop: number) => void;
-    onVisibleRangeChange?: (startIndex: number, endIndex: number) => void;
-    class?: string;
-    style?: Record<string, string | number>;
-}
-
-/**
- * Reactive DOM Rendering
- *
- * Integrates the signal system with the DOM renderer to enable fine-grained
- * reactive updates. Only the specific DOM nodes that depend on changed signals
- * will be updated, without re-rendering the entire component tree.
- */
-
-/**
- * Mount a virtual node reactively to the DOM.
- *
- * This is the core rendering function that handles all node types:
- * - FNodes (both built-in elements and function components)
- * - Strings and numbers (text nodes)
- * - Signals and computed values (reactive children)
- * - StateValues from the state() API
- * - ListComponents
- * - Arrays and fragments
- *
- * Reactive values are automatically tracked and DOM updates occur
- * only when the specific values change (fine-grained reactivity).
- *
- * @param vnode - The virtual node to mount
- * @param container - Optional parent node to append to
- * @returns The created DOM node, or null for empty/boolean values
- *
- * @example
- * ```tsx
- * // Mount a simple element
- * const node = mountReactive(<div>Hello</div>, document.body)
- *
- * // Mount a reactive signal
- * const count = signal(0)
- * mountReactive(() => <span>{count.value}</span>, container)
- * ```
- */
-declare function mountReactive(node: FNode | string | number | boolean | StateValue<any> | null | undefined | Function | any[] | ListComponent<any>, container?: Node): Node | null;
-declare function createReactiveRoot(container: HTMLElement): {
-    render(node: FNode): void;
-    unmount(): void;
-};
-
-interface PortalProps {
-    mount?: HTMLElement;
-    children: any;
-}
-/**
- * <Portal> component renders its children into a different part of the DOM.
- * Useful for modals, tooltips, etc.
- *
- * @example
- * <Portal mount={document.body}>
- *   <div class="modal">...</div>
- * </Portal>
- */
-declare function Portal(props: PortalProps): Comment | null;
-
-export { DOMRenderer as D, Fragment as F, type ListComponent as L, Portal as P, createReactiveRoot as a, createRoot as c, domRenderer as d, f, mountReactive as m, render as r };