@jqhtml/core 2.3.59 → 2.3.64

package/dist/lifecycle-manager.js

@@ -1,201 +0,0 @@
-/**
- * JQHTML v2 Lifecycle Manager
- *
- * Simple lifecycle orchestration - no queues, no batching.
- * Components boot when created. That's it.
- *
- * Lifecycle order:
- * 1. create() - SYNC - Calls on_create() BEFORE first render
- * 2. render() - SYNC - Creates DOM, instantiates child components, calls on_render()
- * 3. _load() - ASYNC - Calls on_load() if overridden, may trigger re-render if this.data changes
- * 4. ready() - ASYNC - Waits for children to be ready, calls on_ready()
- *
- * Key insight: create/render/on_render are synchronous. If a component doesn't
- * override on_load(), the entire create→render→on_render chain completes without
- * yielding to the event loop. This means parent components can access child
- * components in their on_render() as long as the children don't have async on_load().
- */
-export class LifecycleManager {
-    static get_instance() {
-        if (!LifecycleManager.instance) {
-            LifecycleManager.instance = new LifecycleManager();
-        }
-        return LifecycleManager.instance;
-    }
-    constructor() {
-        this.active_components = new Set();
-        // No automatic cleanup on DOM removal - components stop explicitly via:
-        // 1. Parent component re-render (calls .empty() which stops children)
-        // 2. Manual .empty(), .html(), .text() calls (overridden to stop children)
-        // 3. Explicit .stop() call
-        // This allows components to be moved in DOM without lifecycle interruption
-    }
-    /**
-     * Boot a component - run its full lifecycle
-     * Called when component is created
-     *
-     * Supports lifecycle truncation flags:
-     * - _load_only: on_create + on_load only. No render, no children, no on_render, no on_loaded, no on_ready.
-     * - _load_render_only: on_create + render + on_load + re-render. No on_render, no on_loaded, no on_ready.
-     */
-    async boot_component(component) {
-        this.active_components.add(component);
-        try {
-            // Create phase - SYNCHRONOUS, runs BEFORE first render
-            component.create();
-            // Check if stopped during create
-            if (component._stopped)
-                return;
-            // Trigger create event
-            component.trigger('create');
-            // Check for lifecycle truncation flags
-            const load_only = component._load_only;
-            const load_render_only = component._load_render_only;
-            const is_detached = component._is_detached;
-            let render_id;
-            if (load_only || is_detached) {
-                // _load_only or detached: skip initial render entirely
-                render_id = 0;
-                component._render_count = 0;
-            }
-            else if (load_render_only) {
-                // _load_render_only: render to create children, but skip on_render()
-                render_id = component._render(null, { skip_on_render: true });
-                // Check if stopped during render
-                if (component._stopped)
-                    return;
-            }
-            else {
-                // Normal: render with on_render()
-                render_id = component._render();
-                // Check if stopped during render
-                if (component._stopped)
-                    return;
-            }
-            // Load phase - ASYNC, but only if on_load() is overridden
-            // Skip entirely if component uses default stub to avoid unnecessary yield
-            if (component._has_on_load()) {
-                // Load gates: await any promises registered via gate_load() during
-                // on_create() before the FIRST on_load(). Gates delay ONLY this load
-                // phase — create/render/on_render/cached-paint already happened above.
-                // Released early by reload()/refresh()/stop() while gated (see component).
-                // Returns null (no await) for the common no-gate case to keep timing
-                // identical for ungated components.
-                const gate_wait = component._await_load_gates();
-                if (gate_wait) {
-                    await gate_wait;
-                    // Check if stopped while awaiting gates
-                    if (component._stopped)
-                        return;
-                }
-                await component._load();
-                // Yield to microtask queue after on_load completes
-                // This ensures async queue tasks always run before the on_load process completes,
-                // even if on_load() itself completes instantly (deterministic behavior)
-                await Promise.resolve();
-            }
-            // Check if stopped during load
-            if (component._stopped)
-                return;
-            // If _load_only, mark component as ready now and return
-            if (load_only) {
-                component._ready_state = 4;
-                component._update_debug_attrs();
-                component._log_lifecycle('ready', 'complete (_load_only)');
-                component.trigger('ready');
-                return;
-            }
-            // Detached elements always render here (initial render was skipped)
-            // Normal elements re-render only if data changed during on_load
-            if (is_detached || component._should_rerender()) {
-                // Disable animations during re-render to prevent visual artifacts
-                // from CSS transitions/animations firing on newly rendered elements
-                const $el = component.$;
-                if ($el && $el[0]) {
-                    $el[0].classList.add('__jqhtml_disable_animations');
-                    // Re-enable animations after animation frame + 5ms
-                    // This ensures the browser has painted the new DOM before animations resume
-                    requestAnimationFrame(() => {
-                        setTimeout(() => {
-                            // Check component still exists and element is still in DOM
-                            if (!component._stopped && $el[0].isConnected) {
-                                $el[0].classList.remove('__jqhtml_disable_animations');
-                            }
-                        }, 5);
-                    });
-                }
-                // _load_render_only: re-render with skip_on_render to suppress DOM hooks
-                if (load_render_only) {
-                    render_id = component._render(null, { skip_on_render: true });
-                }
-                else {
-                    render_id = component._render();
-                }
-                // Check if stopped during re-render
-                if (component._stopped)
-                    return;
-            }
-            // _load_render_only: skip waiting for children, on_ready — mark ready and return
-            if (load_render_only) {
-                component._ready_state = 4;
-                component._update_debug_attrs();
-                component._log_lifecycle('ready', 'complete (_load_render_only)');
-                component.trigger('ready');
-                return;
-            }
-            // Fire 'rendered' event - component has completed its synchronous render chain
-            // This happens once, after the final on_render (whether from first render or re-render after on_load)
-            if (!component._has_rendered) {
-                component._has_rendered = true;
-                component.trigger('rendered');
-            }
-            // Check if this render is still current before proceeding to ready
-            // If _render_count changed, another render happened and we should skip ready
-            if (component._render_count !== render_id) {
-                return; // Stale render, don't call ready
-            }
-            // Yield to microtask queue before ready phase
-            // This allows any queued async callbacks (e.g., from child component boots)
-            // to execute before on_ready() runs, without triggering a paint cycle.
-            // Promise.resolve() schedules on microtask queue (not macrotask like setTimeout)
-            await Promise.resolve();
-            // Re-check stopped state after yield - something may have stopped us
-            if (component._stopped)
-                return;
-            // Re-check render count after yield - another render may have started
-            if (component._render_count !== render_id) {
-                return; // Stale render, don't call ready
-            }
-            // Ready phase - waits for children, then calls on_ready()
-            await component._ready();
-            // Check if stopped during ready
-            if (component._stopped)
-                return;
-        }
-        catch (error) {
-            console.error(`Error booting component ${component.component_name()}:`, error);
-            throw error;
-        }
-    }
-    /**
-     * Unregister a component (called on destroy)
-     */
-    unregister_component(component) {
-        this.active_components.delete(component);
-    }
-    /**
-     * Wait for all active components to reach ready state
-     */
-    async wait_for_ready() {
-        const ready_promises = [];
-        for (const component of this.active_components) {
-            if (component._ready_state < 4) {
-                ready_promises.push(new Promise((resolve) => {
-                    component.on('ready', () => resolve());
-                }));
-            }
-        }
-        await Promise.all(ready_promises);
-    }
-}
-//# sourceMappingURL=lifecycle-manager.js.map

package/dist/lifecycle-manager.js.map

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

package/dist/load-coordinator.js

@@ -1,309 +0,0 @@
-/**
- * Load Coordinator - Request deduplication for component on_load() calls
- *
- * Coordinates parallel component loading to prevent duplicate requests.
- * When multiple components with identical names and args load simultaneously,
- * only the first (leader) executes on_load(). Others (followers) wait for
- * the leader's result.
- *
- * Key Concepts:
- * - **INVOCATION_KEY**: Unique identifier for component name + args combination
- * - **Leader**: First component to reach on_load() for a given INVOCATION_KEY
- * - **Follower**: Subsequent components that wait for leader's result
- *
- * Lifecycle:
- * 1. Leader reaches on_load() → create coordination entry
- * 2. Followers reach on_load() → join waiting queue
- * 3. Leader completes → distribute data to all followers
- * 4. Clear coordination entry (no caching)
- *
- * @internal This class is not exposed in the public API
- */
-import { serialize_for_cache_key } from './cache-key-serializer.js';
-export class Load_Coordinator {
-    /**
-     * Generate INVOCATION_KEY from component name and args
-     * Uses deterministic JSON serialization (sorted keys)
-     * Excludes internal properties (those starting with _)
-     *
-     * For functions/objects:
-     * - Checks for ._jqhtml_cache_id property (assigned by RSpade)
-     * - Falls back to .jqhtml_cache_id() method if property doesn't exist
-     * - If neither exists, marks property as uncacheable
-     *
-     * Returns object with:
-     * - key: Cache key string, or null if uncacheable
-     * - uncacheable_property: Name of first property that prevented caching (for debugging)
-     */
-    static generate_invocation_key(component_name, args, options = {}) {
-        let uncacheable_property;
-        let uncacheable_reason;
-        // Filter out internal properties (starting with _) and serialize args
-        const serializable_args = {};
-        for (const key of Object.keys(args).sort()) {
-            if (key.startsWith('_')) {
-                continue; // Skip internal properties
-            }
-            // Skip framework properties that shouldn't affect cache identity
-            // Note: _load_only and _load_render_only are already filtered by the _ prefix check above
-            if (key === 'use_cached_data') {
-                continue;
-            }
-            const value = args[key];
-            const value_type = typeof value;
-            // Handle primitives (string, number, boolean, null, undefined)
-            if (value === null || value === undefined ||
-                value_type === 'string' || value_type === 'number' ||
-                value_type === 'boolean') {
-                serializable_args[key] = value;
-                continue;
-            }
-            // Handle functions and objects
-            if (value_type === 'function' || value_type === 'object') {
-                // Check for ._jqhtml_cache_id property (fastest, what RSpade assigns)
-                if (value._jqhtml_cache_id !== undefined) {
-                    serializable_args[key] = `__JQHTML_CACHE_ID__:${String(value._jqhtml_cache_id)}`;
-                    continue;
-                }
-                // Check for .jqhtml_cache_id() method (more flexible, for custom objects)
-                if (typeof value.jqhtml_cache_id === 'function') {
-                    try {
-                        const cache_id = value.jqhtml_cache_id();
-                        serializable_args[key] = `__JQHTML_CACHE_ID__:${String(cache_id)}`;
-                        continue;
-                    }
-                    catch (error) {
-                        // Method threw error - treat as uncacheable
-                        if (!uncacheable_property) {
-                            uncacheable_property = key;
-                            uncacheable_reason = 'cache-id-threw';
-                        }
-                        return { key: null, uncacheable_property, uncacheable_reason };
-                    }
-                }
-                // No author-supplied id. The cache may fall back to keying by
-                // deterministic content; deduplication deliberately may not.
-                if (options.allow_content_serialization) {
-                    const serialized = serialize_for_cache_key(value);
-                    if (serialized.ok) {
-                        serializable_args[key] = `__JQHTML_CONTENT__:${serialized.text}`;
-                        continue;
-                    }
-                    if (!uncacheable_property) {
-                        uncacheable_property = key;
-                        // This package compiles with strictNullChecks off, and without it
-                        // TypeScript will not narrow a discriminated union by its boolean
-                        // discriminant - so `serialized` is still the full Serialize_Result
-                        // here even though `ok` has been ruled out above. The cast states
-                        // what the control flow already guarantees.
-                        uncacheable_reason = serialized.reason;
-                    }
-                    return { key: null, uncacheable_property, uncacheable_reason };
-                }
-                if (!uncacheable_property) {
-                    uncacheable_property = key;
-                    uncacheable_reason = value_type === 'function' ? 'function' : 'object';
-                }
-                return { key: null, uncacheable_property, uncacheable_reason };
-            }
-            // Unknown type (symbol, bigint, etc.) - uncacheable
-            if (!uncacheable_property) {
-                uncacheable_property = key;
-                uncacheable_reason = value_type;
-            }
-            return { key: null, uncacheable_property, uncacheable_reason };
-        }
-        // Try to serialize - if it fails (shouldn't happen now, but safety net), return null
-        try {
-            const sorted_args = JSON.stringify(serializable_args);
-            return { key: `${component_name}::${sorted_args}` };
-        }
-        catch (error) {
-            // Serialization failed unexpectedly
-            return { key: null, uncacheable_property };
-        }
-    }
-    /**
-     * Check if a component should execute on_load() or wait for existing request
-     * Returns true if component should execute (is leader), false if should wait (is follower)
-     */
-    static should_execute_on_load(component) {
-        const { key } = this.generate_invocation_key(component.component_name(), component.args);
-        // No identity means no coordination. Without this, every un-keyable component
-        // would share the single `null` registry entry and adopt an unrelated
-        // component's data - the worst failure this system can produce.
-        if (key === null) {
-            return true;
-        }
-        const entry = this._registry.get(key);
-        if (!entry) {
-            // No existing request - this component becomes the leader
-            return true;
-        }
-        if (entry.status === 'loading') {
-            // Request in progress - this component becomes a follower
-            entry.waiting.push(component);
-            return false;
-        }
-        // Entry exists but completed/failed - should have been cleaned up
-        // Treat as new leader
-        return true;
-    }
-    /**
-     * Register a leader component that will execute on_load()
-     * Creates coordination entry and returns a function to call when data is ready
-     *
-     * @returns A function that accepts the final data and completes coordination
-     */
-    static register_leader(component, on_load_promise) {
-        const { key } = this.generate_invocation_key(component.component_name(), component.args);
-        // Un-keyable component: run alone, register nothing. See should_execute_on_load().
-        if (key === null) {
-            return () => { };
-        }
-        // Create a promise that we control - it resolves when complete_coordination is called
-        let resolve_promise;
-        const coordination_promise = new Promise((resolve) => {
-            resolve_promise = resolve;
-        });
-        const entry = {
-            status: 'loading',
-            promise: coordination_promise, // Followers await THIS promise, not on_load_promise
-            resolve_promise,
-            leader_component: component,
-            leader_data: null,
-            leader_error: null,
-            waiting: []
-        };
-        this._registry.set(key, entry);
-        // Return cleanup function that accepts the final data
-        return (final_data) => this._complete_coordination(key, component, final_data);
-    }
-    /**
-     * Get the coordination promise for a follower component
-     * Returns a promise that resolves when the leader completes
-     */
-    static get_coordination_promise(component) {
-        const { key } = this.generate_invocation_key(component.component_name(), component.args);
-        const entry = this._registry.get(key);
-        if (!entry || entry.status !== 'loading') {
-            return null;
-        }
-        return entry.promise;
-    }
-    /**
-     * Complete coordination after leader's on_load() finishes
-     * Stores leader's data, marks entry as completed, and resolves the promise.
-     * Followers retrieve the data themselves via get_leader_data().
-     *
-     * @param key - The coordination key
-     * @param leader - The leader component
-     * @param final_data - The final data after on_load and normalization
-     * @private
-     */
-    static _complete_coordination(key, leader, final_data) {
-        const entry = this._registry.get(key);
-        if (!entry) {
-            return;
-        }
-        // Store the final data (already normalized by _apply_load_result)
-        // Deep clone to avoid sharing proxy objects between components
-        try {
-            entry.leader_data = JSON.parse(JSON.stringify(final_data));
-        }
-        catch (error) {
-            // If data can't be serialized, use direct reference (may have issues)
-            entry.leader_data = final_data;
-        }
-        entry.status = 'completed';
-        if (window.jqhtml?.debug?.verbose) {
-            console.log(`[Load Coordinator] Leader ${leader._cid} completed, data available for ${entry.waiting.length} followers`, { key, data: entry.leader_data });
-        }
-        // Resolve the promise - followers waiting on it will now wake up
-        entry.resolve_promise();
-        // Note: We do NOT delete the entry here anymore.
-        // Followers need to retrieve the data after the promise resolves.
-        // Entry will be cleaned up when last follower retrieves data.
-    }
-    /**
-     * Get leader's data for a follower component
-     * Called by follower after coordination promise resolves
-     * Returns the data and cleans up if this is the last follower
-     */
-    static get_leader_data(component) {
-        const { key } = this.generate_invocation_key(component.component_name(), component.args);
-        if (!key) {
-            return null;
-        }
-        const entry = this._registry.get(key);
-        if (!entry || entry.status !== 'completed') {
-            return null;
-        }
-        // Remove this follower from the waiting list
-        const follower_index = entry.waiting.indexOf(component);
-        if (follower_index !== -1) {
-            entry.waiting.splice(follower_index, 1);
-        }
-        if (window.jqhtml?.debug?.verbose) {
-            console.log(`[Load Coordinator] Follower ${component._cid} retrieving data from leader ${entry.leader_component._cid}`, { key, remaining_followers: entry.waiting.length });
-        }
-        // If this was the last follower, clean up the entry
-        if (entry.waiting.length === 0) {
-            this._registry.delete(key);
-            if (window.jqhtml?.debug?.verbose) {
-                console.log(`[Load Coordinator] Coordination complete for key: ${key}`, { registry_size: this._registry.size });
-            }
-        }
-        return entry.leader_data;
-    }
-    /**
-     * Handle leader on_load() error
-     * Propagates error to all followers and cleans up entry
-     */
-    static handle_leader_error(component, error) {
-        const { key } = this.generate_invocation_key(component.component_name(), component.args);
-        const entry = this._registry.get(key);
-        if (!entry) {
-            return;
-        }
-        entry.leader_error = error;
-        entry.status = 'failed';
-        console.error(`[Load Coordinator] Leader ${component._cid} on_load() failed for key: ${key}`, error);
-        // Propagate error to all followers
-        // Note: Followers will handle errors the same way as if their own on_load() failed
-        // This is transparent to the developer
-        for (const follower of entry.waiting) {
-            console.error(`[Load Coordinator] Follower ${follower._cid} failed due to leader error`, error);
-            // The follower's lifecycle will handle the error naturally
-            // as the promise rejection will propagate
-        }
-        // Clear coordination entry so future requests can retry
-        this._registry.delete(key);
-        if (window.jqhtml?.debug?.verbose) {
-            console.log(`[Load Coordinator] Cleared failed coordination for key: ${key}`, { followers_count: entry.waiting.length });
-        }
-    }
-    /**
-     * Get current registry state (for debugging)
-     */
-    static get_registry_state() {
-        const state = {};
-        for (const [key, entry] of this._registry.entries()) {
-            state[key] = {
-                status: entry.status,
-                leader_cid: entry.leader_component._cid,
-                waiting_count: entry.waiting.length,
-                waiting_cids: entry.waiting.map(c => c._cid)
-            };
-        }
-        return state;
-    }
-    /**
-     * Clear all coordination entries (for testing/debugging)
-     */
-    static clear_all() {
-        this._registry.clear();
-    }
-}
-Load_Coordinator._registry = new Map();
-//# sourceMappingURL=load-coordinator.js.map

package/dist/load-coordinator.js.map

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