tuiuiu.js 0.1.1

package/dist/primitives/nodes.js

@@ -0,0 +1,164 @@
+/**
+ * Core Primitives - Box, Text, and VNode factories
+ *
+ * This file contains the fundamental building blocks of the UI.
+ * These are the atomic units that all other components are built upon.
+ */
+/**
+ * Normalize children into VNode array
+ */
+export function normalizeChildren(children) {
+    if (children === null || children === undefined || children === false || children === true) {
+        return [];
+    }
+    if (Array.isArray(children)) {
+        return children.flatMap(normalizeChildren);
+    }
+    if (typeof children === 'string' || typeof children === 'number') {
+        return [Text({ children: String(children) })];
+    }
+    return [children];
+}
+/**
+ * Box - Container with flexbox layout
+ *
+ * @example
+ * Box({ flexDirection: 'row', padding: 1 },
+ *   Text({ color: 'cyan' }, 'Hello'),
+ *   Text({ color: 'green' }, 'World')
+ * )
+ */
+export function Box(props, ...children) {
+    return {
+        type: 'box',
+        props: { ...props },
+        children: normalizeChildren(children.length > 0 ? children : props.children),
+    };
+}
+/**
+ * Text - Styled text content
+ *
+ * @example
+ * Text({ color: 'red', bold: true }, 'Error!')
+ */
+export function Text(props, ...children) {
+    const content = children.length > 0
+        ? children.join('')
+        : Array.isArray(props.children)
+            ? props.children.join('')
+            : String(props.children ?? '');
+    return {
+        type: 'text',
+        props: { ...props, children: content },
+        children: [],
+    };
+}
+/**
+ * Spacer - Flexible space that expands
+ *
+ * @example
+ * Box({ flexDirection: 'row' },
+ *   Text({}, 'Left'),
+ *   Spacer(),
+ *   Text({}, 'Right')
+ * )
+ */
+export function Spacer(props = {}) {
+    return {
+        type: 'spacer',
+        props: { flexGrow: 1, ...props },
+        children: [],
+    };
+}
+/**
+ * Newline - Insert blank lines
+ *
+ * @example
+ * Newline({ count: 2 })
+ */
+export function Newline(props = {}) {
+    return {
+        type: 'newline',
+        props: { count: props.count ?? 1 },
+        children: [],
+    };
+}
+/**
+ * Fragment - Group children without wrapper
+ *
+ * @example
+ * Fragment(
+ *   Text({}, 'Line 1'),
+ *   Text({}, 'Line 2')
+ * )
+ */
+export function Fragment(...children) {
+    return {
+        type: 'fragment',
+        props: {},
+        children: normalizeChildren(children),
+    };
+}
+/**
+ * Conditional rendering helper
+ *
+ * @example
+ * When(isLoading,
+ *   Text({}, 'Loading...')
+ * )
+ */
+export function When(condition, ...children) {
+    if (!condition)
+        return null;
+    return Fragment(...children);
+}
+/**
+ * Map helper for rendering lists
+ *
+ * @example
+ * Each(items, (item, i) =>
+ *   Text({ key: i }, item.name)
+ * )
+ */
+export function Each(items, render) {
+    return Fragment(...items.map(render));
+}
+export function Transform(props, ...children) {
+    const { transform, accessibilityLabel, ...boxProps } = props;
+    return {
+        type: 'box',
+        props: {
+            ...boxProps,
+            __transform: transform,
+            __accessibilityLabel: accessibilityLabel,
+        },
+        children: normalizeChildren(children.length > 0 ? children : props.children),
+    };
+}
+export function Static(props) {
+    const { items, children: render, style = {} } = props;
+    const renderedItems = items.map((item, index) => render(item, index));
+    return {
+        type: 'box',
+        props: {
+            ...style,
+            position: 'absolute',
+            flexDirection: 'column',
+            __static: true,
+        },
+        children: renderedItems,
+    };
+}
+export function Slot(props, ...children) {
+    const { visible, height = 0, minHeight, flexGrow, width } = props;
+    if (visible) {
+        // When visible, render children with optional minHeight
+        return Box({ flexDirection: 'column', minHeight: minHeight ?? height, flexGrow, width }, ...children);
+    }
+    // When hidden, still reserve the space
+    if (height === 0 && !minHeight) {
+        return Box({ height: 0 });
+    }
+    return Box({ height: minHeight ?? height, flexGrow, width });
+}
+//# sourceMappingURL=nodes.js.map

package/dist/primitives/nodes.js.map

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

package/dist/primitives/signal.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Reck Signals - Minimal reactive primitives
+ *
+ * ~100 lines of reactive state management
+ */
+type CleanupFn = () => void;
+/**
+ * Signal - A reactive value container
+ */
+export declare class Signal<T> {
+    private _value;
+    private subscribers;
+    constructor(initialValue: T);
+    get value(): T;
+    set value(newValue: T);
+    /** Update value using a function */
+    update(fn: (current: T) => T): void;
+    /** Get value without tracking */
+    peek(): T;
+    private notify;
+    /** Remove a subscriber */
+    unsubscribe(effect: Effect): void;
+}
+/**
+ * Effect - A reactive side effect that re-runs when dependencies change
+ */
+export declare class Effect {
+    private fn;
+    dependencies: Set<Signal<any>>;
+    private cleanup;
+    private running;
+    private disposed;
+    constructor(fn: () => CleanupFn | void);
+    run(): void;
+    dispose(): void;
+}
+/**
+ * Create a reactive signal
+ */
+export declare function createSignal<T>(initialValue: T): [() => T, (value: T | ((prev: T) => T)) => void];
+/**
+ * Create a reactive effect that auto-tracks dependencies
+ */
+export declare function createEffect(fn: () => CleanupFn | void): () => void;
+/**
+ * Computed value - derives from other signals
+ */
+export declare function createMemo<T>(fn: () => T): () => T;
+/**
+ * Batch multiple signal updates into one render
+ */
+export declare function batch(fn: () => void): void;
+/**
+ * Untrack - read signals without creating dependencies
+ */
+export declare function untrack<T>(fn: () => T): T;
+/**
+ * Reducer - Complex state management with actions
+ *
+ * @example
+ * const [state, dispatch] = createReducer(
+ *   (state, action) => {
+ *     switch (action.type) {
+ *       case 'increment': return { count: state.count + 1 };
+ *       case 'decrement': return { count: state.count - 1 };
+ *       default: return state;
+ *     }
+ *   },
+ *   { count: 0 }
+ * );
+ *
+ * dispatch({ type: 'increment' });
+ */
+export declare function createReducer<S, A>(reducer: (state: S, action: A) => S, initialState: S | (() => S)): [() => S, (action: A) => void];
+/**
+ * Ref - Mutable container that doesn't trigger re-renders
+ *
+ * @example
+ * const countRef = createRef(0);
+ * countRef.current++; // No re-render triggered
+ */
+export declare function createRef<T>(initialValue: T): {
+    current: T;
+};
+/**
+ * Deferred - Value that updates with lower priority
+ *
+ * When the source signal changes, the deferred value updates
+ * after a microtask delay, allowing urgent updates to process first.
+ *
+ * @example
+ * const [search, setSearch] = createSignal('');
+ * const deferredSearch = createDeferred(search);
+ *
+ * // deferredSearch will lag behind search slightly,
+ * // keeping the UI responsive during rapid updates
+ */
+export declare function createDeferred<T>(source: () => T): () => T;
+export declare function createId(prefix?: string): string;
+/**
+ * Reset the ID counter (useful for testing)
+ */
+export declare function resetIdCounter(): void;
+/**
+ * Previous value - Track the previous value of a signal
+ * Useful for comparison or animations
+ *
+ * @example
+ * const [count, setCount] = createSignal(0);
+ * const prevCount = createPrevious(count);
+ *
+ * // After setCount(5):
+ * // count() === 5
+ * // prevCount() === 0
+ */
+export declare function createPrevious<T>(source: () => T): () => T | undefined;
+/**
+ * Throttled signal - Limits how often a signal can update
+ * Useful for expensive operations or rate limiting
+ *
+ * @example
+ * const [position, setPosition] = createSignal({ x: 0, y: 0 });
+ * const throttledPosition = createThrottled(position, 100); // 100ms
+ */
+export declare function createThrottled<T>(source: () => T, delay: number): () => T;
+/**
+ * Debounced signal - Delays updates until activity stops
+ * Useful for search inputs or resize handlers
+ *
+ * @example
+ * const [search, setSearch] = createSignal('');
+ * const debouncedSearch = createDebounced(search, 300);
+ */
+export declare function createDebounced<T>(source: () => T, delay: number): () => T;
+export {};
+//# sourceMappingURL=signal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/primitives/signal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,KAAK,SAAS,GAAG,MAAM,IAAI,CAAC;AAO5B;;GAEG;AACH,qBAAa,MAAM,CAAC,CAAC;IACnB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,WAAW,CAAqB;gBAE5B,YAAY,EAAE,CAAC;IAI3B,IAAI,KAAK,IAAI,CAAC,CAOb;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,EAOpB;IAED,oCAAoC;IACpC,MAAM,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI;IAInC,iCAAiC;IACjC,IAAI,IAAI,CAAC;IAIT,OAAO,CAAC,MAAM;IAad,0BAA0B;IAC1B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGlC;AAED;;GAEG;AACH,qBAAa,MAAM;IAML,OAAO,CAAC,EAAE;IALtB,YAAY,mBAA0B;IACtC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEL,EAAE,EAAE,MAAM,SAAS,GAAG,IAAI;IAI9C,GAAG,IAAI,IAAI;IAkCX,OAAO,IAAI,IAAI;CAahB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAajG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,IAAI,CAGnE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAQlD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAiB1C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQzC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EACnC,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAC1B,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC,CAYhC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAE5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAY1D;AAMD,wBAAgB,QAAQ,CAAC,MAAM,GAAE,MAAe,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,SAAS,CAatE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,CAuB1E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,CAiB1E"}

package/dist/primitives/signal.js

@@ -0,0 +1,338 @@
+/**
+ * Reck Signals - Minimal reactive primitives
+ *
+ * ~100 lines of reactive state management
+ */
+// Global tracking for auto-dependency detection
+let currentEffect = null;
+const batchQueue = new Set();
+let isBatching = false;
+/**
+ * Signal - A reactive value container
+ */
+export class Signal {
+    _value;
+    subscribers = new Set();
+    constructor(initialValue) {
+        this._value = initialValue;
+    }
+    get value() {
+        // Auto-track dependency when accessed inside an effect
+        if (currentEffect) {
+            this.subscribers.add(currentEffect);
+            currentEffect.dependencies.add(this);
+        }
+        return this._value;
+    }
+    set value(newValue) {
+        // Eager state optimization: skip update if value is the same
+        // Uses Object.is() for better semantics (handles NaN, -0)
+        if (!Object.is(this._value, newValue)) {
+            this._value = newValue;
+            this.notify();
+        }
+    }
+    /** Update value using a function */
+    update(fn) {
+        this.value = fn(this._value);
+    }
+    /** Get value without tracking */
+    peek() {
+        return this._value;
+    }
+    notify() {
+        // Copy subscribers before iterating to prevent infinite loops
+        // (effects may re-subscribe during their run)
+        const effects = [...this.subscribers];
+        for (const effect of effects) {
+            if (isBatching) {
+                batchQueue.add(effect);
+            }
+            else {
+                effect.run();
+            }
+        }
+    }
+    /** Remove a subscriber */
+    unsubscribe(effect) {
+        this.subscribers.delete(effect);
+    }
+}
+/**
+ * Effect - A reactive side effect that re-runs when dependencies change
+ */
+export class Effect {
+    fn;
+    dependencies = new Set();
+    cleanup = undefined;
+    running = false;
+    disposed = false;
+    constructor(fn) {
+        this.fn = fn;
+        this.run();
+    }
+    run() {
+        // Prevent re-entrant execution (avoids infinite loops)
+        if (this.running || this.disposed) {
+            return;
+        }
+        this.running = true;
+        try {
+            // Cleanup previous run
+            if (this.cleanup) {
+                this.cleanup();
+                this.cleanup = undefined;
+            }
+            // Clear old dependencies
+            for (const dep of this.dependencies) {
+                dep.unsubscribe(this);
+            }
+            this.dependencies.clear();
+            // Run effect with tracking enabled
+            const prevEffect = currentEffect;
+            currentEffect = this;
+            try {
+                this.cleanup = this.fn();
+            }
+            finally {
+                currentEffect = prevEffect;
+            }
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.cleanup) {
+            this.cleanup();
+            this.cleanup = undefined;
+        }
+        for (const dep of this.dependencies) {
+            dep.unsubscribe(this);
+        }
+        this.dependencies.clear();
+    }
+}
+/**
+ * Create a reactive signal
+ */
+export function createSignal(initialValue) {
+    const signal = new Signal(initialValue);
+    const getter = () => signal.value;
+    const setter = (value) => {
+        if (typeof value === 'function') {
+            signal.update(value);
+        }
+        else {
+            signal.value = value;
+        }
+    };
+    return [getter, setter];
+}
+/**
+ * Create a reactive effect that auto-tracks dependencies
+ */
+export function createEffect(fn) {
+    const effect = new Effect(fn);
+    return () => effect.dispose();
+}
+/**
+ * Computed value - derives from other signals
+ */
+export function createMemo(fn) {
+    const [value, setValue] = createSignal(undefined);
+    createEffect(() => {
+        setValue(fn());
+    });
+    return value;
+}
+/**
+ * Batch multiple signal updates into one render
+ */
+export function batch(fn) {
+    const wasBatching = isBatching;
+    isBatching = true;
+    try {
+        fn();
+    }
+    finally {
+        isBatching = wasBatching;
+        if (!wasBatching) {
+            const effects = [...batchQueue];
+            batchQueue.clear();
+            for (const effect of effects) {
+                effect.run();
+            }
+        }
+    }
+}
+/**
+ * Untrack - read signals without creating dependencies
+ */
+export function untrack(fn) {
+    const prevEffect = currentEffect;
+    currentEffect = null;
+    try {
+        return fn();
+    }
+    finally {
+        currentEffect = prevEffect;
+    }
+}
+// ============================================
+// Additional reactive utilities
+// ============================================
+/**
+ * Reducer - Complex state management with actions
+ *
+ * @example
+ * const [state, dispatch] = createReducer(
+ *   (state, action) => {
+ *     switch (action.type) {
+ *       case 'increment': return { count: state.count + 1 };
+ *       case 'decrement': return { count: state.count - 1 };
+ *       default: return state;
+ *     }
+ *   },
+ *   { count: 0 }
+ * );
+ *
+ * dispatch({ type: 'increment' });
+ */
+export function createReducer(reducer, initialState) {
+    const initial = typeof initialState === 'function'
+        ? initialState()
+        : initialState;
+    const [state, setState] = createSignal(initial);
+    const dispatch = (action) => {
+        setState(currentState => reducer(currentState, action));
+    };
+    return [state, dispatch];
+}
+/**
+ * Ref - Mutable container that doesn't trigger re-renders
+ *
+ * @example
+ * const countRef = createRef(0);
+ * countRef.current++; // No re-render triggered
+ */
+export function createRef(initialValue) {
+    return { current: initialValue };
+}
+/**
+ * Deferred - Value that updates with lower priority
+ *
+ * When the source signal changes, the deferred value updates
+ * after a microtask delay, allowing urgent updates to process first.
+ *
+ * @example
+ * const [search, setSearch] = createSignal('');
+ * const deferredSearch = createDeferred(search);
+ *
+ * // deferredSearch will lag behind search slightly,
+ * // keeping the UI responsive during rapid updates
+ */
+export function createDeferred(source) {
+    const [deferred, setDeferred] = createSignal(source());
+    createEffect(() => {
+        const value = source();
+        // Schedule update with lower priority
+        queueMicrotask(() => {
+            setDeferred(value);
+        });
+    });
+    return deferred;
+}
+/**
+ * ID Generator - Creates unique IDs for components
+ */
+let idCounter = 0;
+export function createId(prefix = 'reck') {
+    return `${prefix}-${++idCounter}`;
+}
+/**
+ * Reset the ID counter (useful for testing)
+ */
+export function resetIdCounter() {
+    idCounter = 0;
+}
+/**
+ * Previous value - Track the previous value of a signal
+ * Useful for comparison or animations
+ *
+ * @example
+ * const [count, setCount] = createSignal(0);
+ * const prevCount = createPrevious(count);
+ *
+ * // After setCount(5):
+ * // count() === 5
+ * // prevCount() === 0
+ */
+export function createPrevious(source) {
+    const [previous, setPrevious] = createSignal(undefined);
+    createEffect(() => {
+        const currentValue = source();
+        // Use untrack to avoid creating dependency on previous
+        const prevValue = untrack(previous);
+        if (prevValue !== currentValue) {
+            setPrevious(currentValue);
+        }
+    });
+    return previous;
+}
+/**
+ * Throttled signal - Limits how often a signal can update
+ * Useful for expensive operations or rate limiting
+ *
+ * @example
+ * const [position, setPosition] = createSignal({ x: 0, y: 0 });
+ * const throttledPosition = createThrottled(position, 100); // 100ms
+ */
+export function createThrottled(source, delay) {
+    const [throttled, setThrottled] = createSignal(source());
+    let lastUpdate = 0;
+    let pending = null;
+    createEffect(() => {
+        const value = source();
+        const now = Date.now();
+        const elapsed = now - lastUpdate;
+        if (elapsed >= delay) {
+            setThrottled(value);
+            lastUpdate = now;
+        }
+        else if (!pending) {
+            pending = setTimeout(() => {
+                setThrottled(source());
+                lastUpdate = Date.now();
+                pending = null;
+            }, delay - elapsed);
+        }
+    });
+    return throttled;
+}
+/**
+ * Debounced signal - Delays updates until activity stops
+ * Useful for search inputs or resize handlers
+ *
+ * @example
+ * const [search, setSearch] = createSignal('');
+ * const debouncedSearch = createDebounced(search, 300);
+ */
+export function createDebounced(source, delay) {
+    const [debounced, setDebounced] = createSignal(source());
+    let timeout = null;
+    createEffect(() => {
+        const value = source();
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+        timeout = setTimeout(() => {
+            setDebounced(value);
+        }, delay);
+    });
+    return debounced;
+}
+//# sourceMappingURL=signal.js.map

package/dist/primitives/signal.js.map

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