sibujs 1.0.2 → 1.0.3

package/dist/src/core/tagFactory.js

@@ -1,86 +0,0 @@
-import { bindAttribute } from "../reactivity/bindAttribute";
-import { bindChildNode } from "../reactivity/bindChildNode";
-// Applies inline styles or style object
-function applyStyle(el, style) {
-    if (!style)
-        return;
-    if (typeof style === "string") {
-        el.setAttribute("style", style);
-    }
-    else {
-        for (const [prop, val] of Object.entries(style)) {
-            const name = prop.replace(/[A-Z]/g, m => "-" + m.toLowerCase());
-            el.style.setProperty(name, String(val));
-        }
-    }
-}
-// Renders a single child: static or reactive
-function renderChild(child) {
-    if (child == null) {
-        return document.createTextNode("");
-    }
-    if (typeof child === "function") {
-        const placeholder = document.createComment("bind:child");
-        queueMicrotask(() => bindChildNode(placeholder, child));
-        return placeholder;
-    }
-    if (child instanceof Node) {
-        return child;
-    }
-    // string or number
-    return document.createTextNode(String(child));
-}
-/**
- * Factory for creating HTML elements with reactive props and children
- */
-export const tagFactory = (tag) => (props = {}) => {
-    const el = document.createElement(tag);
-    // Process props
-    for (const [key, value] of Object.entries(props)) {
-        if (value == null)
-            continue;
-        switch (key) {
-            case "id":
-                el.id = String(value);
-                break;
-            case "class":
-                el.className = String(value);
-                break;
-            case "style":
-                applyStyle(el, value);
-                break;
-            case "on":
-                {
-                    const handlers = value;
-                    for (const [ev, handler] of Object.entries(handlers || {})) {
-                        el.addEventListener(ev, handler);
-                    }
-                }
-                break;
-            case "children":
-                {
-                    const childs = Array.isArray(value) ? value : [value];
-                    for (const c of childs) {
-                        if (Array.isArray(c)) {
-                            for (const nested of c) {
-                                el.appendChild(renderChild(nested));
-                            }
-                        }
-                        else {
-                            el.appendChild(renderChild(c));
-                        }
-                    }
-                }
-                break;
-            default:
-                // Other attributes
-                if (typeof value === "function") {
-                    bindAttribute(el, key, value);
-                }
-                else {
-                    el.setAttribute(key, String(value));
-                }
-        }
-    }
-    return el;
-};

package/dist/src/core/test.d.ts

@@ -1,11 +0,0 @@
-type ErrorHandler = (error: unknown, context?: any) => void;
-/**
- * Wraps any function in a try/catch block and optionally passes error to a handler.
- * This is used internally by components or boundaries.
- */
-export declare function catchError(fn: () => any, onError?: ErrorHandler): any;
-/**
- * Sets a global error handler used by default if no onError is provided.
- */
-export declare function setGlobalErrorHandler(handler: ErrorHandler): void;
-export {};

package/dist/src/core/test.js

@@ -1,28 +0,0 @@
-let globalErrorHandler = null;
-/**
- * Wraps any function in a try/catch block and optionally passes error to a handler.
- * This is used internally by components or boundaries.
- */
-export function catchError(fn, onError) {
-    try {
-        return fn();
-    }
-    catch (err) {
-        if (onError) {
-            onError(err);
-        }
-        else if (globalErrorHandler) {
-            globalErrorHandler(err);
-        }
-        else {
-            console.error("Unhandled error in Sibu.catch:", err);
-        }
-        return null;
-    }
-}
-/**
- * Sets a global error handler used by default if no onError is provided.
- */
-export function setGlobalErrorHandler(handler) {
-    globalErrorHandler = handler;
-}

package/dist/src/core/types.d.ts

@@ -1,2 +0,0 @@
-export type NodeChild = HTMLElement | Text | Comment | (() => NodeChild) | null;
-export type NodeChildren = NodeChild | NodeChild[] | string | (() => string);

package/dist/src/core/types.js

@@ -1 +0,0 @@
-export {};

package/dist/src/core/useComputed.d.ts

@@ -1,6 +0,0 @@
-/**
- * useComputed creates a derived reactive signal whose value updates when dependencies change.
- * @param getter Function returning computed value based on reactive signals.
- * @returns Getter function for the computed value.
- */
-export declare function useComputed<T>(getter: () => T): () => T;

package/dist/src/core/useComputed.js

@@ -1,30 +0,0 @@
-import { track, recordDependency, notifySubscribers } from "../reactivity/track";
-/**
- * useComputed creates a derived reactive signal whose value updates when dependencies change.
- * @param getter Function returning computed value based on reactive signals.
- * @returns Getter function for the computed value.
- */
-export function useComputed(getter) {
-    // Initial value computation
-    let value = getter();
-    // Signal object representing this computed's identity
-    const computedSignal = {};
-    // Recompute function subscribed to dependency changes
-    const recompute = () => {
-        const next = getter();
-        if (Object.is(next, value))
-            return;
-        value = next;
-        notifySubscribers(computedSignal);
-    };
-    // Track dependencies and register recompute callback
-    track(recompute, recompute);
-    /**
-     * Getter for the computed value.
-     * Registers a dependency on this computed signal and returns the current value.
-     */
-    return function computedGetter() {
-        recordDependency(computedSignal);
-        return value;
-    };
-}

package/dist/src/core/useEffect.d.ts

@@ -1,6 +0,0 @@
-/**
- * useEffect runs the provided effectFn immediately and re-runs it whenever
- * any reactive dependency changes.
- * Returns a cleanup function to stop further executions.
- */
-export declare function useEffect(effectFn: () => void): () => void;

package/dist/src/core/useEffect.js

@@ -1,23 +0,0 @@
-import { track } from "../reactivity/track";
-/**
- * useEffect runs the provided effectFn immediately and re-runs it whenever
- * any reactive dependency changes.
- * Returns a cleanup function to stop further executions.
- */
-export function useEffect(effectFn) {
-    // Internal cleanup handle for previous subscription
-    let cleanupHandle = () => { };
-    // Subscriber function that re-schedules the effect when dependencies notify
-    const subscriber = () => {
-        // Cleanup previous subscriptions before re-running
-        cleanupHandle();
-        // Track the effect and update cleanupHandle
-        cleanupHandle = track(effectFn, subscriber);
-    };
-    // Initial execution and subscription
-    cleanupHandle = track(effectFn, subscriber);
-    // Return a function to cleanup and stop any further effect runs
-    return () => {
-        cleanupHandle();
-    };
-}

package/dist/src/core/useState.d.ts

@@ -1,10 +0,0 @@
-type SetState<T> = (next: T | ((prev: T) => T)) => void;
-type StateTuple<T> = [() => T, SetState<T>];
-/**
- * useState creates a reactive signal that holds a value of type T.
- * Returns a tuple: [getter, setter].
- * - getter(): registers dependency and returns the current state value.
- * - setter(next): updates the state and notifies subscribers if changed.
- */
-export declare function useState<T>(initial: T): StateTuple<T>;
-export {};

package/dist/src/core/useState.js

@@ -1,34 +0,0 @@
-import { recordDependency, notifySubscribers } from "../reactivity/track";
-/**
- * useState creates a reactive signal that holds a value of type T.
- * Returns a tuple: [getter, setter].
- * - getter(): registers dependency and returns the current state value.
- * - setter(next): updates the state and notifies subscribers if changed.
- */
-export function useState(initial) {
-    // Internal state container acts as the ReactiveSignal
-    const state = { value: initial };
-    /**
-     * Getter for the state value.
-     * Registers this call as a dependency on the current subscriber.
-     */
-    function get() {
-        recordDependency(state);
-        return state.value;
-    }
-    /**
-     * Setter for the state value.
-     * Accepts a new value or an updater function.
-     * Notifies subscribers only if the new value is different (Object.is).
-     */
-    function set(next) {
-        const newValue = typeof next === "function"
-            ? next(state.value)
-            : next;
-        if (Object.is(newValue, state.value))
-            return;
-        state.value = newValue;
-        notifySubscribers(state);
-    }
-    return [get, set];
-}

package/dist/src/core/useStore.d.ts

@@ -1,19 +0,0 @@
-/**
- * Creates a global store with reactive properties.
- *
- * @param initialState Initial state object
- * @returns A tuple [store, actions]:
- *  - store: Proxy object with reactive getters for each state property
- *  - actions:
- *      - setState: apply a partial patch or updater function
- *      - reset: revert to initial state
- */
-export declare function useStore<T extends object>(initialState: T): [
-    store: {
-        readonly [K in keyof T]: T[K];
-    },
-    actions: {
-        setState: (patch: Partial<T> | ((state: T) => T)) => void;
-        reset: () => void;
-    }
-];

package/dist/src/core/useStore.js

@@ -1,53 +0,0 @@
-import { useState } from "./useState";
-/**
- * Creates a global store with reactive properties.
- *
- * @param initialState Initial state object
- * @returns A tuple [store, actions]:
- *  - store: Proxy object with reactive getters for each state property
- *  - actions:
- *      - setState: apply a partial patch or updater function
- *      - reset: revert to initial state
- */
-export function useStore(initialState) {
-    // Create individual signals for each key
-    const signals = {};
-    // Initialize signals
-    Object.keys(initialState).forEach((key) => {
-        const [getter, setter] = useState(initialState[key]);
-        signals[key] = [getter, setter];
-    });
-    // Proxy to expose reactive getters
-    const store = new Proxy({}, {
-        get(_, prop) {
-            if (prop in signals) {
-                const getter = signals[prop][0];
-                return getter();
-            }
-            return undefined;
-        },
-        set() {
-            throw new Error("Direct mutation of store is not allowed. Use actions.setState.");
-        },
-    });
-    // Actions
-    const setState = (patch) => {
-        const current = {};
-        Object.keys(signals).forEach((key) => {
-            current[key] = signals[key][0]();
-        });
-        const nextState = typeof patch === "function" ? patch(current) : patch;
-        Object.entries(nextState).forEach(([key, value]) => {
-            if (key in signals) {
-                signals[key][1](value);
-            }
-        });
-    };
-    const reset = () => {
-        Object.keys(initialState).forEach((key) => {
-            const setter = signals[key][1];
-            setter(initialState[key]);
-        });
-    };
-    return [store, { setState, reset }];
-}

package/dist/src/core/useWatch.d.ts

@@ -1,8 +0,0 @@
-/**
- * Watches a reactive getter and calls callback with (newValue, oldValue) when it changes.
- *
- * @param getter Function that returns the value to watch (reads reactive signals).
- * @param callback Function called when the watched value changes.
- * @returns Teardown function to cancel the watcher.
- */
-export declare function useWatch<T>(getter: () => T, callback: (value: T, prev: T | undefined) => void): () => void;

package/dist/src/core/useWatch.js

@@ -1,23 +0,0 @@
-import { track } from "../reactivity/track";
-/**
- * Watches a reactive getter and calls callback with (newValue, oldValue) when it changes.
- *
- * @param getter Function that returns the value to watch (reads reactive signals).
- * @param callback Function called when the watched value changes.
- * @returns Teardown function to cancel the watcher.
- */
-export function useWatch(getter, callback) {
-    // Get initial value without registering dependencies
-    let oldValue = getter();
-    // Subscriber function for track
-    const subscriber = () => {
-        const newValue = getter();
-        if (newValue !== oldValue) {
-            callback(newValue, oldValue);
-            oldValue = newValue;
-        }
-    };
-    // Track dependencies and return teardown for unsubscription
-    const teardown = track(subscriber, subscriber);
-    return teardown;
-}

package/dist/src/plugins/i18n.d.ts

@@ -1,6 +0,0 @@
-type Translations = Record<string, string>;
-type Params = Record<string, string | number>;
-export declare function setLocale(locale: string): void;
-export declare function registerTranslations(locale: string, messages: Translations): void;
-export declare function t(key: string, params?: Params): string;
-export {};

package/dist/src/plugins/i18n.js

@@ -1,16 +0,0 @@
-import { useState } from "../core/useState";
-const [currentLocale, setLocaleInternal] = useState("en");
-const locales = {};
-export function setLocale(locale) {
-    setLocaleInternal(locale);
-}
-export function registerTranslations(locale, messages) {
-    locales[locale] = messages;
-}
-export function t(key, params) {
-    const locale = currentLocale();
-    const message = locales[locale]?.[key] || key;
-    return params
-        ? message.replace(/\{(\w+)\}/g, (_, p) => String(params[p] ?? ""))
-        : message;
-}

package/dist/src/plugins/router.d.ts

@@ -1,188 +0,0 @@
-export type Component = () => HTMLElement;
-export type AsyncComponent = () => Promise<HTMLElement>;
-export type LazyComponent = () => Promise<{
-    default: Component;
-}>;
-export type Params = Record<string, string>;
-export interface RouteContext {
-    readonly path: string;
-    readonly params: Params;
-    readonly query: Params;
-    readonly hash: string;
-    readonly meta: RouteMeta;
-    readonly matched: RouteDef[];
-}
-export type GuardResult = boolean | string | Promise<boolean | string>;
-export type Guard = (to: RouteContext, from?: RouteContext) => GuardResult;
-export interface NavigationGuard {
-    (to: RouteContext, from: RouteContext, next: NavigationNext): void;
-}
-export interface NavigationNext {
-    (result?: boolean | string | Error): void;
-}
-export type RouteMeta = Record<string, any>;
-export interface RouteBase {
-    readonly path: string;
-    readonly name?: string;
-    readonly meta?: RouteMeta;
-    readonly children?: RouteDef[];
-    readonly beforeEnter?: Guard | Guard[];
-    readonly alias?: string | string[];
-}
-export interface ComponentRoute extends RouteBase {
-    readonly component: Component;
-}
-export interface AsyncRoute extends RouteBase {
-    readonly component: AsyncComponent | LazyComponent;
-}
-export interface RedirectRoute extends RouteBase {
-    readonly redirect: string | ((to: RouteContext) => string);
-}
-export type RouteDef = ComponentRoute | AsyncRoute | RedirectRoute;
-export interface RouterOptions {
-    readonly mode?: 'history' | 'hash';
-    readonly base?: string;
-    readonly linkActiveClass?: string;
-    readonly linkExactActiveClass?: string;
-    readonly fallback?: boolean;
-    readonly scrollBehavior?: ScrollBehavior;
-    readonly guardTimeout?: number;
-    readonly cacheSize?: number;
-    readonly errorRetryDelay?: number;
-    readonly preloadStrategy?: 'none' | 'hover' | 'visible';
-}
-export interface ScrollBehavior {
-    (to: RouteContext, from: RouteContext, savedPosition: ScrollPosition | null): ScrollPosition | null;
-}
-export interface ScrollPosition {
-    readonly x: number;
-    readonly y: number;
-}
-export interface NavigationFailure {
-    readonly type: 'aborted' | 'cancelled' | 'duplicated' | 'timeout';
-    readonly from: RouteContext;
-    readonly to: RouteContext;
-    readonly error?: Error;
-}
-export type NavigationResult = {
-    success: true;
-    route: RouteContext;
-} | {
-    success: false;
-    failure: NavigationFailure;
-};
-export type NavigationTarget = string | {
-    path?: string;
-    name?: string;
-    params?: Params;
-    query?: Params;
-    hash?: string;
-};
-export declare class SibuRouter {
-    private options;
-    private matcher;
-    private guards;
-    private loader;
-    private navigator;
-    private currentRouteGetter;
-    private currentRouteSetter;
-    private isReadyGetter;
-    private isReadySetter;
-    private cleanup;
-    constructor(routes: RouteDef[], options?: RouterOptions);
-    private initialize;
-    private createInitialRoute;
-    private handleLocationChange;
-    private getCurrentPath;
-    private createRouteContext;
-    navigate(to: NavigationTarget, options?: {
-        replace?: boolean;
-        state?: any;
-    }): Promise<NavigationResult>;
-    private performNavigation;
-    private resolvePath;
-    private isSameRoute;
-    private updateHistory;
-    private handleScrollBehavior;
-    loadComponent(route: RouteDef, routePath: string): Promise<Component>;
-    beforeEach(guard: NavigationGuard): () => void;
-    beforeResolve(guard: NavigationGuard): () => void;
-    afterEach(hook: (to: RouteContext, from: RouteContext) => void): () => void;
-    push(to: NavigationTarget): Promise<NavigationResult>;
-    replace(to: NavigationTarget): Promise<NavigationResult>;
-    go(delta: number): void;
-    back(): void;
-    forward(): void;
-    get currentRoute(): RouteContext;
-    get isReady(): boolean;
-    get isNavigating(): boolean;
-    destroy(): void;
-    clearCache(): void;
-    clearErrorCache(): void;
-    updateRoutes(routes: RouteDef[]): void;
-}
-export declare function createRouter(routes: RouteDef[], options?: RouterOptions): SibuRouter;
-export declare function useRoute(): RouteContext;
-export declare function useRouter(): {
-    currentRoute: RouteContext;
-    isReady: boolean;
-    isNavigating: boolean;
-    push: (to: NavigationTarget) => Promise<NavigationResult>;
-    replace: (to: NavigationTarget) => Promise<NavigationResult>;
-    go: (delta: number) => void;
-    back: () => void;
-    forward: () => void;
-    beforeEach: (guard: NavigationGuard) => () => void;
-    beforeResolve: (guard: NavigationGuard) => () => void;
-    afterEach: (hook: (to: RouteContext, from: RouteContext) => void) => () => void;
-};
-export declare function navigate(to: NavigationTarget, options?: {
-    replace?: boolean;
-    state?: any;
-}): Promise<NavigationResult>;
-export declare function push(to: NavigationTarget): Promise<NavigationResult>;
-export declare function replace(to: NavigationTarget): Promise<NavigationResult>;
-export declare function go(delta: number): void;
-export declare function back(): void;
-export declare function forward(): void;
-export declare function beforeEach(guard: NavigationGuard): () => void;
-export declare function beforeResolve(guard: NavigationGuard): () => void;
-export declare function afterEach(hook: (to: RouteContext, from: RouteContext) => void): () => void;
-export declare function Route(): Node;
-export declare function RouterLink(props: {
-    to: NavigationTarget;
-    replace?: boolean;
-    activeClass?: string;
-    exactActiveClass?: string;
-    children?: any;
-    target?: string;
-    rel?: string;
-    [key: string]: any;
-}): HTMLElement;
-export declare function Suspense(props: {
-    fallback?: () => HTMLElement | HTMLElement;
-    children: () => HTMLElement | Promise<HTMLElement>;
-}): Node;
-/**
- * Creates a lazy-loaded component
- */
-export declare function lazy(importFn: () => Promise<{
-    default: Component;
-}>): LazyComponent;
-/**
- * Preloads a route component
- */
-export declare function preloadRoute(to: NavigationTarget): Promise<void>;
-/**
- * Validates if a route exists
- */
-export declare function hasRoute(name: string): boolean;
-/**
- * Gets route information by name
- */
-export declare function getRouteInfo(name: string): RouteDef | null;
-/**
- * Builds a URL for a route
- */
-export declare function buildURL(to: NavigationTarget): string;
-export declare function destroyRouter(): void;