@jqhtml/core 2.3.54 → 2.3.59

package/README.md

@@ -15,7 +15,9 @@ Components have a simple lifecycle: `on_load()` fetches data, `on_render()` sets
 
 ## Status
 
-Alpha release. It works and I use it daily, but expect rough edges. Full documentation and framework plugins coming soon.
+Alpha release. It works and I use it daily, but expect rough edges.
+
+Full documentation: **[docs.jqhtml.org](https://docs.jqhtml.org/)**
 
 If you try it in a project, I'd love to hear about it.
 

package/dist/boot.js

@@ -0,0 +1,130 @@
+/**
+ * JQHTML Boot - Component Hydration System
+ *
+ * Bridges server-rendered HTML and client-side jqhtml components.
+ *
+ * Server output:   <div class="_Component_Init" data-component-init-name="User_Card" data-component-args='{"id":1}'></div>
+ * After boot():    <div class="User_Card Component">...rendered template...</div>
+ *
+ * Usage:
+ *   await jqhtml.boot();           // Hydrate all placeholders, wait for ready
+ *   jqhtml.boot($('#container'));  // Hydrate within scope
+ */
+/**
+ * Hydrate all _Component_Init placeholders within a scope.
+ *
+ * @param scope - jQuery object, HTMLElement, or undefined (defaults to body)
+ * @returns Promise that resolves when all components (including nested) are ready
+ */
+export function boot(scope) {
+    const jQ = typeof jQuery !== 'undefined' ? jQuery : $;
+    if (!scope) {
+        scope = jQ('body');
+    }
+    else if (!(scope instanceof jQ)) {
+        scope = jQ(scope);
+    }
+    const readyPromises = [];
+    // Find top-level placeholders only (skip those nested inside other placeholders)
+    scope.find('._Component_Init').each(function () {
+        const $element = jQ(this);
+        // Skip if removed from DOM
+        if (!document.contains($element[0])) {
+            return;
+        }
+        // Skip nested placeholders - they'll be hydrated by parent's render callback
+        let parent = $element[0].parentElement;
+        while (parent) {
+            if (parent.classList.contains('_Component_Init')) {
+                return;
+            }
+            parent = parent.parentElement;
+        }
+        // Hydrate this placeholder
+        const component = hydrateElement($element, jQ);
+        if (!component)
+            return;
+        // On render, recursively hydrate any nested placeholders
+        component.on('render', function () {
+            hydrateNested(component.$, jQ);
+        });
+        // Collect ready promise - parent.ready() waits for all children via _wait_for_children_ready()
+        readyPromises.push(component.ready());
+    });
+    // Fire jqhtml:ready event when all top-level components are ready
+    const result = Promise.all(readyPromises);
+    result.then(() => {
+        document.dispatchEvent(new CustomEvent('jqhtml:ready'));
+    });
+    return result;
+}
+/**
+ * Hydrate nested _Component_Init placeholders within a component's DOM.
+ * Called from parent's 'render' event.
+ */
+function hydrateNested($scope, jQ) {
+    $scope.find('._Component_Init').each(function () {
+        const $element = jQ(this);
+        if (!document.contains($element[0])) {
+            return;
+        }
+        // Skip if nested inside another placeholder
+        let parent = $element[0].parentElement;
+        while (parent && parent !== $scope[0]) {
+            if (parent.classList.contains('_Component_Init')) {
+                return;
+            }
+            parent = parent.parentElement;
+        }
+        const component = hydrateElement($element, jQ);
+        if (!component)
+            return;
+        // Recursively handle deeper nesting
+        component.on('render', function () {
+            hydrateNested(component.$, jQ);
+        });
+    });
+}
+/**
+ * Hydrate a single _Component_Init element into a live component.
+ */
+function hydrateElement($element, jQ) {
+    const componentName = $element.attr('data-component-init-name');
+    if (!componentName)
+        return null;
+    // Parse args
+    const argsString = $element.attr('data-component-args');
+    let args = {};
+    if (argsString) {
+        try {
+            args = JSON.parse(argsString);
+        }
+        catch (e) {
+            console.error(`[jqhtml.boot] Failed to parse args for ${componentName}:`, e);
+        }
+    }
+    // Strip data- prefix from args if present
+    const filteredArgs = {};
+    for (const [key, value] of Object.entries(args)) {
+        filteredArgs[key.startsWith('data-') ? key.substring(5) : key] = value;
+    }
+    // Capture innerHTML for content() and mark as boot-created
+    filteredArgs._inner_html = $element.html();
+    filteredArgs._component_name = componentName;
+    // Cleanup placeholder
+    $element.removeAttr('data-component-init-name');
+    $element.removeAttr('data-component-args');
+    $element.removeData('component-init-name');
+    $element.removeData('component-args');
+    $element.removeClass('_Component_Init');
+    $element.empty();
+    // Create component
+    try {
+        return $element.component(componentName, filteredArgs).component();
+    }
+    catch (error) {
+        console.error(`[jqhtml.boot] Failed to create ${componentName}:`, error);
+        return null;
+    }
+}
+//# sourceMappingURL=boot.js.map

package/dist/boot.js.map

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

package/dist/cache-key-serializer.js

@@ -0,0 +1,140 @@
+/**
+ * JQHTML Cache Key Serializer
+ *
+ * Produces a deterministic string for a plain-data argument value, so that two
+ * structurally equal objects built on separate renders yield the SAME cache key.
+ * Templates rebuild `{contact_id: 12}` on every render, so identity-based keying
+ * can never match and permanently opts the receiving component out of caching.
+ *
+ * ---------------------------------------------------------------------------
+ * THIS IS NOT `process_for_serialization()` IN local-storage.ts. DO NOT MERGE THEM.
+ *
+ * That serializer stores cache VALUES and deliberately degrades: a function, a
+ * symbol or a circular reference is dropped and serialization continues, because
+ * losing a method while keeping the data is the right trade for a payload.
+ *
+ * For a cache KEY that policy manufactures false hits. Two argument objects that
+ * differ ONLY by a callback would serialize identically, and a component would
+ * render with another component's cached content - strictly worse than not
+ * caching at all. So this serializer DECLINES on the first value it cannot
+ * express exactly. It never drops anything.
+ * ---------------------------------------------------------------------------
+ *
+ * Allow-list, and nothing else: null, undefined, boolean, number, string, Date,
+ * arrays, and plain objects (prototype Object.prototype or null), in any nesting.
+ * Everything else declines with a reason that reaches `data-nocache`.
+ */
+/**
+ * Values larger than this are declined rather than keyed. The supported case is a
+ * handful of key/value pairs or a list of ids - not a payload. Declining loudly
+ * beats spending the budget on a key nobody benefits from.
+ */
+export const MAX_KEY_BYTES = 500;
+class Decline extends Error {
+    constructor(reason) {
+        super(reason);
+        this.reason = reason;
+    }
+}
+function push(state, text) {
+    state.size += text.length;
+    if (state.size > MAX_KEY_BYTES) {
+        throw new Decline('too-large');
+    }
+    return text;
+}
+/**
+ * Length-prefix strings so that no combination of separators can make two
+ * different structures produce the same text.
+ */
+function encode_string(state, prefix, value) {
+    return push(state, `${prefix}${value.length}:${value}`);
+}
+function walk(value, state) {
+    // --- primitives, each tagged so shapes cannot collide ---
+    if (value === null)
+        return push(state, 'n');
+    if (value === undefined)
+        return push(state, 'u');
+    const type = typeof value;
+    if (type === 'boolean')
+        return push(state, value ? 'b1' : 'b0');
+    if (type === 'number')
+        return push(state, `d${String(value)}`);
+    if (type === 'string')
+        return encode_string(state, 's', value);
+    if (type === 'function')
+        throw new Decline('function');
+    if (type === 'symbol')
+        throw new Decline('symbol');
+    if (type === 'bigint')
+        throw new Decline('bigint');
+    if (type !== 'object')
+        throw new Decline(type);
+    // --- objects: reject the impostors before treating anything as data ---
+    if (typeof value.nodeType === 'number')
+        throw new Decline('dom-node');
+    if (value.jquery)
+        throw new Decline('jquery');
+    if (state.seen.has(value))
+        throw new Decline('circular');
+    state.seen.add(value);
+    try {
+        if (value instanceof Date) {
+            const time = value.getTime();
+            if (Number.isNaN(time))
+                throw new Decline('invalid-date');
+            return push(state, `t${value.toISOString()}`);
+        }
+        if (Array.isArray(value)) {
+            // Order is meaningful - never sorted.
+            const parts = [];
+            push(state, 'a[');
+            for (let i = 0; i < value.length; i++) {
+                parts.push(walk(value[i], state));
+            }
+            push(state, ']');
+            return `a[${parts.join(',')}]`;
+        }
+        // Plain object ONLY. A class instance, Map, Set, RegExp, Error, etc. is
+        // declined: two different classes with identical fields would otherwise
+        // serialize the same and collide.
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== Object.prototype && proto !== null) {
+            throw new Decline('non-plain-object');
+        }
+        // Recursive key sort - the existing top-level sort is not enough for nesting.
+        const keys = Object.keys(value).sort();
+        const parts = [];
+        push(state, 'o{');
+        for (const key of keys) {
+            const encoded_key = encode_string(state, 'k', key);
+            parts.push(`${encoded_key}=${walk(value[key], state)}`);
+        }
+        push(state, '}');
+        return `o{${parts.join(',')}}`;
+    }
+    finally {
+        state.seen.delete(value);
+    }
+}
+/**
+ * Serialize a value for use in a cache key.
+ *
+ * @returns `{ok: true, text}` when the value is exactly expressible, or
+ *          `{ok: false, reason}` naming why it is not. Never throws.
+ */
+export function serialize_for_cache_key(value) {
+    const state = { seen: new WeakSet(), size: 0 };
+    try {
+        return { ok: true, text: walk(value, state) };
+    }
+    catch (error) {
+        if (error instanceof Decline) {
+            return { ok: false, reason: error.reason };
+        }
+        // A throwing getter or exotic proxy trap - decline rather than guess.
+        return { ok: false, reason: 'unserializable' };
+    }
+}
+//# sourceMappingURL=cache-key-serializer.js.map

package/dist/cache-key-serializer.js.map

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

package/dist/component-cache.js

@@ -0,0 +1,270 @@
+/**
+ * JQHTML Component Cache Integration
+ *
+ * Extracted from component.ts - handles cache key generation,
+ * cache reads during create(), cache checks during reload(),
+ * and HTML cache snapshots during ready().
+ *
+ * Uses Jqhtml_Local_Storage as the underlying storage layer.
+ */
+import { Load_Coordinator } from './load-coordinator.js';
+import { Jqhtml_Local_Storage } from './local-storage.js';
+import { warn_uncacheable_args_enabled } from './config.js';
+/**
+ * Generate a cache key for a component using its name + args.
+ * Supports custom cache_id() override.
+ *
+ * @param component - The component instance
+ * @returns Cache key string or null if caching is disabled
+ */
+export function generate_cache_key(component) {
+    if (typeof component.cache_id === 'function') {
+        try {
+            const custom_cache_id = component.cache_id();
+            return { cache_key: `${component.component_name()}::${String(custom_cache_id)}` };
+        }
+        catch (error) {
+            return { cache_key: null, uncacheable_property: 'cache_id()', uncacheable_reason: 'cache-id-threw' };
+        }
+    }
+    // Standard args-based key. The CACHE opts into content serialization for plain-data
+    // object args; deduplication does not - see InvocationKeyOptions for why.
+    const result = Load_Coordinator.generate_invocation_key(component.component_name(), component.args, { allow_content_serialization: true });
+    return {
+        cache_key: result.key,
+        uncacheable_property: result.uncacheable_property,
+        uncacheable_reason: result.uncacheable_reason,
+    };
+}
+// One warning per component+property. A list of 50 rows must not print 50 warnings.
+const _warned_uncacheable = new Set();
+/**
+ * Development warning: this component fetches data but cannot be cached, because
+ * its args do not reduce to a stable key and it defines no cache_id() to say what
+ * its identity is. Nothing is broken - the component works - but it silently opts
+ * out of cache reuse and of load deduplication.
+ *
+ * Controlled by the `warn_uncacheable_args` integration flag (see config.ts).
+ */
+function warn_uncacheable_component(component, uncacheable_property, uncacheable_reason) {
+    if (!warn_uncacheable_args_enabled())
+        return;
+    let name = 'unknown';
+    try {
+        name = component.component_name();
+    }
+    catch { /* name unavailable */ }
+    const dedupe_key = `${name}::${uncacheable_property || '?'}::${uncacheable_reason || '?'}`;
+    if (_warned_uncacheable.has(dedupe_key))
+        return;
+    _warned_uncacheable.add(dedupe_key);
+    // cache_id() exists but threw - a different problem with a different fix
+    if (uncacheable_property === 'cache_id()' || uncacheable_reason === 'cache-id-threw') {
+        console.warn(`[JQHTML] <${name}> defines cache_id() but it threw, so this component is not cached ` +
+            `and its loads are not deduplicated. Fix cache_id() so it returns a stable string.`, { component: name, cid: component._cid });
+        return;
+    }
+    const REASONS = {
+        'function': 'it contains a function - a callback is real identity that content cannot express',
+        'symbol': 'it contains a symbol',
+        'bigint': 'it contains a bigint',
+        'dom-node': 'it contains a DOM node',
+        'jquery': 'it contains a jQuery object',
+        'circular': 'it contains a circular reference',
+        'non-plain-object': 'it contains a class instance, Map, Set or similar - only plain objects and arrays can be keyed by content',
+        'too-large': 'it serializes to more than 500 bytes - args are meant to identify data, not carry it',
+        'invalid-date': 'it contains an invalid Date',
+    };
+    const why = REASONS[uncacheable_reason || ''] || 'it cannot be serialized deterministically';
+    console.warn(`[JQHTML] <${name}> cannot be cached: arg $${uncacheable_property} is not keyable because ` +
+        `${why}.\n` +
+        `  The component works, but it will not be restored from cache when reused.\n` +
+        `  Fix: define cache_id() on the component to state its identity explicitly, e.g.\n` +
+        `    cache_id() { return \`${name.toLowerCase()}_\${this.args.some_id}\`; }\n` +
+        `  Or pass plain data (objects/arrays of primitives are keyed automatically) instead of ` +
+        `$${uncacheable_property}.\n` +
+        `  Find it in DevTools with the selector ` +
+        `[data-nocache="${uncacheable_property}:${uncacheable_reason || ''}"].`, {
+        component: name,
+        cid: component._cid,
+        uncacheable_arg: uncacheable_property,
+        reason: uncacheable_reason,
+        all_args: component.args ? Object.keys(component.args) : [],
+    });
+}
+/**
+ * Read cache during create() phase.
+ * Sets component._cache_key, _cached_html, _use_cached_data_hit as side effects.
+ *
+ * @param component - The component instance
+ */
+export function read_cache_in_create(component) {
+    const { cache_key, uncacheable_property, uncacheable_reason } = generate_cache_key(component);
+    // If cache_key is null, caching disabled
+    if (cache_key === null) {
+        // Set data-nocache attribute for debugging
+        if (uncacheable_property) {
+            // "<arg>:<reason>" - a bare property name left authors reverse-engineering why
+            component.$.attr('data-nocache', uncacheable_reason ? `${uncacheable_property}:${uncacheable_reason}` : uncacheable_property);
+        }
+        warn_uncacheable_component(component, uncacheable_property, uncacheable_reason);
+        if (window.jqhtml?.debug?.verbose) {
+            console.log(`[Cache] Component ${component._cid} (${component.component_name()}) has non-serializable args - caching disabled`, { uncacheable_property });
+        }
+        return;
+    }
+    // Store cache key for later use
+    component._cache_key = cache_key;
+    // Get cache mode
+    const cache_mode = Jqhtml_Local_Storage.get_cache_mode();
+    if (window.jqhtml?.debug?.verbose) {
+        console.log(`[Cache ${cache_mode}] Component ${component._cid} (${component.component_name()}) checking cache in create()`, { cache_key, cache_mode, has_cache_key_set: Jqhtml_Local_Storage.has_cache_key() });
+    }
+    if (cache_mode === 'html') {
+        // HTML cache mode - check for cached HTML to inject on first render
+        const html_cache_key = `${cache_key}::html`;
+        const cached_html = Jqhtml_Local_Storage.get(html_cache_key);
+        if (cached_html !== null && typeof cached_html === 'string') {
+            component._cached_html = cached_html;
+            if (window.jqhtml?.debug?.verbose) {
+                console.log(`[Cache html] Component ${component._cid} (${component.component_name()}) found cached HTML`, { cache_key: html_cache_key, html_length: cached_html.length });
+            }
+        }
+        else {
+            if (window.jqhtml?.debug?.verbose) {
+                console.log(`[Cache html] Component ${component._cid} (${component.component_name()}) cache miss`, { cache_key: html_cache_key });
+            }
+        }
+        // Warn if use_cached_data is set in html cache mode
+        if (component.args.use_cached_data === true) {
+            console.warn(`[JQHTML] Component "${component.component_name()}" has use_cached_data=true but cache mode is 'html'.\n` +
+                `use_cached_data only applies to 'data' cache mode. In 'html' mode, the entire rendered HTML is cached.\n` +
+                `The use_cached_data flag will be ignored.`);
+        }
+    }
+    else {
+        // Data cache mode (default) - check for cached data to hydrate this.data
+        const cached_data = Jqhtml_Local_Storage.get(cache_key);
+        if (cached_data !== null && typeof cached_data === 'object') {
+            // Hydrate this.data with cached data
+            component.data = cached_data;
+            if (component.args.use_cached_data === true) {
+                component._use_cached_data_hit = true;
+                if (window.jqhtml?.debug?.verbose) {
+                    console.log(`[Cache data] Component ${component._cid} (${component.component_name()}) using cached data (use_cached_data=true, skipping on_load)`, { cache_key, data: cached_data });
+                }
+            }
+            else {
+                if (window.jqhtml?.debug?.verbose) {
+                    console.log(`[Cache data] Component ${component._cid} (${component.component_name()}) hydrated from cache`, { cache_key, data: cached_data });
+                }
+            }
+        }
+        else {
+            if (window.jqhtml?.debug?.verbose) {
+                console.log(`[Cache data] Component ${component._cid} (${component.component_name()}) cache miss`, { cache_key });
+            }
+        }
+    }
+}
+/**
+ * Check cache during reload() when args have changed.
+ * If cache hit, hydrates data/html and triggers an immediate render.
+ *
+ * @param component - The component instance
+ * @returns true if rendered from cache, false otherwise
+ */
+export function check_cache_on_reload(component) {
+    const { cache_key } = generate_cache_key(component);
+    if (cache_key === null) {
+        return false;
+    }
+    const cache_mode = Jqhtml_Local_Storage.get_cache_mode();
+    component._cache_key = cache_key;
+    if (cache_mode === 'html') {
+        // HTML cache mode - check for cached HTML
+        const html_cache_key = `${cache_key}::html`;
+        const cached_html = Jqhtml_Local_Storage.get(html_cache_key);
+        if (cached_html !== null && typeof cached_html === 'string') {
+            if (window.jqhtml?.debug?.verbose) {
+                console.log(`[Cache html] reload() - Component ${component._cid} (${component.component_name()}) found cached HTML (args changed)`, { cache_key: html_cache_key, html_length: cached_html.length });
+            }
+            component._cached_html = cached_html;
+            // Call _render() directly (not render()) since _reload() manages the full lifecycle
+            // Using render() would trigger a separate queue entry and interfere with _reload()'s flow
+            component._render();
+            return true;
+        }
+    }
+    else {
+        // Data cache mode (default) - check for cached data
+        const cached_data = Jqhtml_Local_Storage.get(cache_key);
+        if (cached_data !== null && typeof cached_data === 'object' && JSON.stringify(cached_data) !== '{}') {
+            if (window.jqhtml?.debug?.verbose) {
+                console.log(`[Cache data] reload() - Component ${component._cid} (${component.component_name()}) hydrated from cache (args changed)`, { cache_key, data: cached_data });
+            }
+            // Hydrate this.data with cached data
+            component.__data_frozen = false;
+            component.data = cached_data;
+            component.__data_frozen = true;
+            // Call _render() directly (not render()) since _reload() manages the full lifecycle
+            component._render();
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Write HTML cache snapshot during ready() phase.
+ * Only caches if the component is dynamic (data changed during on_load).
+ *
+ * @param component - The component instance
+ */
+export function write_html_cache_snapshot(component) {
+    if (!component._should_cache_html_after_ready || !component._cache_key) {
+        return;
+    }
+    if (component._is_dynamic) {
+        component._should_cache_html_after_ready = false;
+        const html = component.$.html();
+        const html_cache_key = `${component._cache_key}::html`;
+        Jqhtml_Local_Storage.set(html_cache_key, html);
+        if (window.jqhtml?.debug?.verbose) {
+            console.log(`[Cache html] Component ${component._cid} (${component.component_name()}) cached HTML after children on_render complete`, { cache_key: html_cache_key, html_length: html.length });
+        }
+    }
+    else {
+        component._should_cache_html_after_ready = false;
+        if (window.jqhtml?.debug?.verbose) {
+            console.log(`[Cache html] Component ${component._cid} (${component.component_name()}) is static (no data change) - skipping HTML cache`);
+        }
+    }
+}
+/**
+ * Write data/HTML to cache after on_load() completes.
+ * Called from _apply_load_result().
+ *
+ * @param component - The component instance
+ * @param data_changed - Whether this.data changed during on_load
+ */
+export function write_cache_on_loaded(component, data_changed) {
+    if (!data_changed || !component._cache_key) {
+        return;
+    }
+    const cache_mode = Jqhtml_Local_Storage.get_cache_mode();
+    if (cache_mode === 'html') {
+        // HTML cache mode - flag to cache HTML after children ready in _ready()
+        component._should_cache_html_after_ready = true;
+        if (window.jqhtml?.debug?.verbose) {
+            console.log(`[Cache html] Component ${component._cid} (${component.component_name()}) will cache HTML after ready`, { cache_key: component._cache_key });
+        }
+    }
+    else {
+        // Data cache mode (default) - write this.data to cache
+        Jqhtml_Local_Storage.set(component._cache_key, component.data);
+        if (window.jqhtml?.debug?.verbose) {
+            console.log(`[Cache data] Component ${component._cid} (${component.component_name()}) cached data after on_load()`, { cache_key: component._cache_key, data: component.data });
+        }
+    }
+}
+//# sourceMappingURL=component-cache.js.map

package/dist/component-cache.js.map

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