@jqhtml/core 2.3.13 → 2.3.50

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 JQHTML Team
+Copyright (c) 2026 HansonXyz
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/component-cache.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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.
+ */
+/**
+ * Result of generating a cache key for a component.
+ */
+interface Cache_Key_Result {
+    cache_key: string | null;
+    uncacheable_property?: string;
+}
+/**
+ * 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 declare function generate_cache_key(component: any): Cache_Key_Result;
+/**
+ * Read cache during create() phase.
+ * Sets component._cache_key, _cached_html, _use_cached_data_hit as side effects.
+ *
+ * @param component - The component instance
+ */
+export declare function read_cache_in_create(component: any): void;
+/**
+ * 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 declare function check_cache_on_reload(component: any): boolean;
+/**
+ * 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 declare function write_html_cache_snapshot(component: any): void;
+/**
+ * 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 declare function write_cache_on_loaded(component: any, data_changed: boolean): void;
+export {};
+//# sourceMappingURL=component-cache.d.ts.map

package/dist/component-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-cache.d.ts","sourceRoot":"","sources":["../src/component-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;GAEG;AACH,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,GAAG,GAAG,gBAAgB,CAanE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CA+FzD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAqD7D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CA2B9D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CA4BjF"}

package/dist/component-events.d.ts

@@ -0,0 +1,68 @@
+/**
+ * JQHTML Component Event System
+ *
+ * Extracted from component.ts - handles lifecycle event registration,
+ * triggering, and state tracking.
+ *
+ * Events have "sticky" semantics for lifecycle events: if an event has already
+ * occurred, new .on() handlers fire immediately with the stored data.
+ */
+/**
+ * Register a callback for an event.
+ *
+ * Lifecycle events (create, render, load, loaded, ready) are "sticky":
+ * If a lifecycle event has already occurred, the callback fires immediately
+ * AND registers for future occurrences.
+ *
+ * Custom events only fire when explicitly triggered via trigger().
+ *
+ * @param component - The component instance
+ * @param event_name - Name of the event
+ * @param callback - Callback: (component, data?) => void
+ */
+export declare function event_on(component: any, event_name: string, callback: (comp: any, data?: any) => void): any;
+/**
+ * Register a callback that fires exactly once.
+ *
+ * - If the event already occurred (sticky), fires immediately and does NOT register.
+ * - If the event has not occurred, registers and auto-deregisters after first fire.
+ *
+ * @param component - The component instance
+ * @param event_name - Name of the event
+ * @param callback - Callback: (component, data?) => void
+ */
+export declare function event_once(component: any, event_name: string, callback: (comp: any, data?: any) => void): any;
+/**
+ * Trigger an event - fires all registered callbacks.
+ * Marks event as occurred so future .on() calls fire immediately.
+ *
+ * @param component - The component instance
+ * @param event_name - Name of the event to trigger
+ * @param data - Optional data to pass to callbacks as second parameter
+ */
+export declare function event_trigger(component: any, event_name: string, data?: any): void;
+/**
+ * Check if any callbacks are registered for a given event.
+ *
+ * @param component - The component instance
+ * @param event_name - Name of the event to check
+ */
+export declare function event_on_registered(component: any, event_name: string): boolean;
+/**
+ * Invalidate a lifecycle event - removes the "already occurred" marker.
+ *
+ * After invalidate() is called:
+ * - New .on() handlers will NOT fire immediately
+ * - The ready() promise will NOT resolve immediately
+ * - Handlers wait for the next trigger() call
+ *
+ * Existing registered callbacks are NOT removed - they'll fire on next trigger().
+ *
+ * Use case: Call invalidate('ready') at the start of reload() or render()
+ * so that any new .on('ready') handlers wait for the reload/render to complete.
+ *
+ * @param component - The component instance
+ * @param event_name - Name of the event to invalidate
+ */
+export declare function event_invalidate(component: any, event_name: string): void;
+//# sourceMappingURL=component-events.d.ts.map

package/dist/component-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-events.d.ts","sourceRoot":"","sources":["../src/component-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,GAAG,CAqB3G;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,GAAG,CA+B7G;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAelF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAG/E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAEzE"}

package/dist/component-queue.d.ts

@@ -0,0 +1,47 @@
+/**
+ * JQHTML Component Lifecycle Queue
+ *
+ * Serializes lifecycle operations (render, reload, refresh) per component.
+ * Replaces _create_debounced_function with a proper queue that:
+ *
+ * - At most one operation runs at a time per component
+ * - At most one operation is pending (waiting for the current to finish)
+ * - Same-type pending operations collapse (fan-in: all callers share one execution)
+ * - Different-type pending operations: new replaces old (old callers get the new result)
+ *
+ * Boot bypasses this queue entirely - it runs the lifecycle directly.
+ */
+export declare class Component_Queue {
+    /** Currently executing operation */
+    private _current;
+    /** Next operation waiting to execute after current completes */
+    private _pending;
+    /**
+     * Enqueue a lifecycle operation.
+     *
+     * Behavior:
+     * - Nothing running → execute immediately
+     * - Something running, no pending → create pending entry
+     * - Something running, same type pending → collapse (share pending promise)
+     * - Something running, different type pending → replace pending (all callers get new result)
+     *
+     * @param type - Operation type ('render', 'reload', 'refresh', 'load')
+     * @param executor - The async function to execute
+     * @returns Promise that resolves when the operation completes
+     */
+    enqueue(type: string, executor: () => Promise<void>): Promise<void>;
+    /**
+     * Execute an operation and handle pending queue after completion.
+     * @private
+     */
+    private _execute;
+    /**
+     * Check if any operation is currently running.
+     */
+    get is_busy(): boolean;
+    /**
+     * Check if there's a pending operation waiting.
+     */
+    get has_pending(): boolean;
+}
+//# sourceMappingURL=component-queue.d.ts.map

package/dist/component-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-queue.d.ts","sourceRoot":"","sources":["../src/component-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,qBAAa,eAAe;IAC1B,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAyD;IAEzE,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAA4B;IAE5C;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CnE;;;OAGG;IACH,OAAO,CAAC,QAAQ;IA0BhB;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF"}

package/dist/component.d.ts

@@ -34,14 +34,13 @@ export declare class Jqhtml_Component {
     private _data_before_render;
     private _lifecycle_callbacks;
     private _lifecycle_states;
-    private __loading;
     private _did_first_render;
     private _render_count;
     private _args_on_last_render;
     private _data_on_last_render;
     private __initial_data_snapshot;
     private __data_frozen;
-    private _reload_debounced?;
+    private _queue;
     private next_reload_force_refresh;
     private __lifecycle_authorized;
     private _cache_key;
@@ -50,6 +49,17 @@ export declare class Jqhtml_Component {
     private _should_cache_html_after_ready;
     private _is_dynamic;
     private _on_render_complete;
+    private _use_cached_data_hit;
+    private _load_only;
+    private _load_render_only;
+    _is_detached: boolean;
+    private _force_initial_render;
+    private _has_rendered;
+    private _load_queue;
+    private __has_custom_on_load;
+    private __load_gates;
+    private __first_load_started;
+    private __gate_resume;
     constructor(element?: any, args?: Record<string, any>);
     /**
      * Protect lifecycle methods from manual invocation
@@ -70,6 +80,13 @@ export declare class Jqhtml_Component {
      * @private
      */
     private _call_lifecycle_sync;
+    /**
+     * Check if on_load() is overridden in a subclass
+     * Used to skip the load phase entirely for components that don't fetch data
+     * Returns cached value set in _boot() for O(1) performance
+     * @private
+     */
+    private _has_on_load;
     /**
      * Boot - Start the full component lifecycle
      * Called immediately after construction by instruction processor
@@ -88,38 +105,129 @@ export declare class Jqhtml_Component {
      * @returns The current _render_count after incrementing (used to detect stale renders)
      * @private
      */
-    _render(id?: string | null): number;
+    _render(id?: string | null, options?: {
+        skip_on_render?: boolean;
+    }): number;
     /**
      * Public render method - re-renders component and completes lifecycle
      * This is what users should call when they want to update a component.
      *
-     * Lifecycle sequence:
+     * Lifecycle sequence (serialized via component queue):
      * 1. _render() - Updates DOM synchronously, calls on_render(), fires 'render' event
-     * 2. Async continuation (fire and forget):
-     *    - _wait_for_children_ready() - Waits for all children to reach ready state
-     *    - on_ready() - Calls user's ready hook
-     *    - trigger('ready') - Fires ready event
+     * 2. _wait_for_children_ready() - Waits for all children to reach ready state
+     * 3. on_ready() - Calls user's ready hook
+     * 4. trigger('ready') - Fires ready event
      *
-     * Returns immediately after _render() completes - does NOT wait for children
+     * Goes through the component queue to prevent concurrent lifecycle operations.
+     * Returns a Promise that resolves when the full render lifecycle completes.
      */
-    render(id?: string | null): void;
+    render(id?: string | null): Promise<void>;
     /**
      * Alias for render() - re-renders component with current data
      * Provided for API consistency and clarity
      */
-    redraw(id?: string | null): void;
+    redraw(id?: string | null): Promise<void>;
+    /**
+     * Re-fetch data by executing on_load() without triggering re-render or lifecycle.
+     *
+     * Runs on_load() on a detached proxy (same restrictions as during boot):
+     *   - this.data is restored to on_create() snapshot, then unfrozen for writing
+     *   - this.args is read-only
+     *   - All other properties (this.$, this.$sid, etc.) are blocked
+     *
+     * After on_load() completes, this.data is atomically updated and re-frozen.
+     * The developer decides what to do next (e.g., call this.render()).
+     *
+     * Pattern: load() invokes on_load(), just as render() invokes on_render().
+     *
+     * @returns true if this.data changed, false if unchanged
+     */
+    load(): Promise<boolean>;
     /**
      * Create phase - Quick setup, prepare UI
-     * Called bottom-up (children before parent)
+     * SYNCHRONOUS - no awaits, no yields
      */
-    create(): Promise<void>;
+    create(): void;
     /**
-     * Load phase - Fetch data from APIs
+     * Register a "load gate" — a promise that must settle before this component's
+     * FIRST on_load() runs.
+     *
+     * Register gates during on_create(). Multiple calls accumulate; all gates are
+     * awaited together (via Promise.allSettled) at the seam between create and the
+     * first load. A REJECTED gate does NOT block or abort the load — it is an
+     * ordering hint, not a data dependency, so loading proceeds after settlement
+     * (rejections are logged through the debug channel).
+     *
+     * Gates are ONE-SHOT: they delay the first on_load() only. Once that load
+     * begins the gate list is cleared, and reload()/refresh() never re-await gates.
+     * Calling reload()/refresh() while a gate is still holding the first load
+     * releases the wait immediately and resumes the lifecycle (a later gate
+     * settlement then does nothing).
+     *
+     * Gates delay ONLY the on_load phase — never create(), the initial render,
+     * on_render(), or the cached-content first paint (stale-while-revalidate is
+     * preserved). Components with no custom on_load() ignore gates entirely.
+     *
+     * No-op during SSR (the server cannot await arbitrary client promises).
+     *
+     * jqhtml has no knowledge of WHAT is being awaited — the caller supplies the
+     * promise, and policy such as timeouts is the caller's responsibility (bake it
+     * into the promise you pass).
+     *
+     * @param promise The promise to await before the first on_load().
+     * @throws If called after the component's first load has already started.
+     */
+    gate_load(promise: Promise<any>): void;
+    /**
+     * Await all registered load gates before the first on_load().
+     *
+     * Called exactly once, at the boot seam immediately before the load phase
+     * (only for components with a custom on_load()). Latches "first load started"
+     * so any later gate_load() throws and reload()/refresh() never re-await.
+     *
+     * Returns a promise to await when there are gates to wait on, or `null` when
+     * there is nothing to wait for (no gates, or SSR). Returning `null` keeps the
+     * common no-gate path free of an extra microtask hop, so it does not shift the
+     * timing of ungated components.
+     *
+     * The returned promise resolves as soon as any of the following happens
+     * (whichever is first — the rest become no-ops):
+     *   - all gates settle (Promise.allSettled),
+     *   - reload()/refresh() is called while gated (they resolve __gate_resume),
+     *   - the component is stopped (stop() resolves __gate_resume).
+     *
+     * @private
+     */
+    private _await_load_gates;
+    /**
+     * Load phase - Fetch asynchronous data
      * Called bottom-up, fully parallel
      * NO DOM MODIFICATIONS ALLOWED IN THIS PHASE
+     *
+     * Key design: on_load() runs on a DETACHED proxy with a clone of this.data.
+     * The real component's this.data is not touched during on_load execution.
+     * After on_load completes, the result is applied via a sequential queue.
+     *
      * @private - Internal lifecycle method, not for external use
      */
     _load(): Promise<void>;
+    /**
+     * Execute on_load() on a fully detached proxy.
+     * @see data-proxy.ts for full implementation
+     * @private
+     */
+    private _execute_on_load_detached;
+    /**
+     * Apply the result of on_load() to this.data via the sequential queue.
+     *
+     * Multiple _load calls can execute on_load in parallel, but this method
+     * ensures that setting this.data happens in FIFO order.
+     *
+     * @param result_data - The data returned from _execute_on_load_detached
+     * @param data_before_load - JSON string of this.data before on_load (for change detection), or null
+     * @private
+     */
+    private _apply_load_result;
     /**
      * Ready phase - Component fully initialized
      * Called bottom-up (children before parent)
@@ -148,6 +256,24 @@ export declare class Jqhtml_Component {
      * @param callback Optional callback to execute when ready
      */
     ready(callback?: () => void): Promise<void>;
+    /**
+     * Returns a promise that resolves when the component has completed its
+     * synchronous render chain (after on_load's re-render if applicable,
+     * or after first render if no on_load override).
+     *
+     * This fires BEFORE on_ready() and before children are waited on.
+     * Use this when you need to know the component's DOM is stable but
+     * don't need to wait for the full async ready phase.
+     *
+     * The 'rendered' event fires exactly once per component lifecycle.
+     *
+     * @example
+     * await component.rendered();
+     * // DOM is now stable, on_render has completed
+     *
+     * @param callback Optional callback to execute when rendered
+     */
+    rendered(callback?: () => void): Promise<void>;
     /**
      * Wait for all child components to reach ready state
      * Ensures bottom-up ordering (children ready before parent)
@@ -237,11 +363,12 @@ export declare class Jqhtml_Component {
      * Leaves DOM intact, just stops lifecycle engine and fires cleanup hooks
      */
     stop(): void;
-    on_render(): void | Promise<void>;
-    on_create(): void | Promise<void>;
-    on_load(): Promise<void>;
+    on_render(): void;
+    on_create(): void;
+    on_load(): void | Promise<void>;
+    on_loaded(): void | Promise<void>;
     on_ready(): Promise<void>;
-    on_stop(): void | Promise<void>;
+    on_stop(): void;
     /**
      * Optional: Override cache key generation
      *
@@ -268,23 +395,30 @@ export declare class Jqhtml_Component {
      */
     component_name(): string;
     /**
-     * Register event callback
-     * Supports lifecycle events ('render', 'create', 'load', 'ready', 'stop') and custom events
-     * Lifecycle event callbacks fire after the lifecycle method completes
-     * If a lifecycle event has already occurred, the callback fires immediately AND registers for future occurrences
-     * Custom events only fire when explicitly triggered via .trigger()
+     * Register event callback - delegates to component-events.ts
+     * @see component-events.ts for full documentation
+     */
+    on(event_name: string, callback: (component: Jqhtml_Component, data?: any) => void): this;
+    /**
+     * Register a callback that fires exactly once - delegates to component-events.ts
+     * If the event already occurred, fires immediately and does not register.
+     * @see component-events.ts for full documentation
      */
-    on(event_name: string, callback: (component: Jqhtml_Component) => void): this;
+    once(event_name: string, callback: (component: Jqhtml_Component, data?: any) => void): this;
     /**
-     * Trigger a lifecycle event - fires all registered callbacks
-     * Marks event as occurred so future .on() calls fire immediately
+     * Trigger a lifecycle event - delegates to component-events.ts
+     * @see component-events.ts for full documentation
      */
-    trigger(event_name: string): void;
+    trigger(event_name: string, data?: any): void;
     /**
      * Check if any callbacks are registered for a given event
-     * Used to determine if cleanup logic needs to run
      */
     _on_registered(event_name: string): boolean;
+    /**
+     * Invalidate a lifecycle event - delegates to component-events.ts
+     * @see component-events.ts for full documentation
+     */
+    invalidate(event_name: string): void;
     /**
      * Find element by scoped ID
      *
@@ -355,21 +489,5 @@ export declare class Jqhtml_Component {
     private _get_dom_children;
     private _log_lifecycle;
     private _log_debug;
-    /**
-     * Creates a debounced function with exclusivity and promise fan-in
-     *
-     * When invoked, immediately runs the callback exclusively.
-     * For subsequent invocations, applies a delay before running the callback exclusively again.
-     * The delay starts after the current asynchronous operation resolves.
-     *
-     * If delay is 0, the function only prevents enqueueing multiple executions,
-     * but will still run them immediately in an exclusive sequential manner.
-     *
-     * The most recent invocation's parameters are used when the function executes.
-     * Returns a promise that resolves when the next exclusive execution completes.
-     *
-     * @private
-     */
-    private _create_debounced_function;
 }
 //# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

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

package/dist/data-proxy.d.ts

@@ -0,0 +1,37 @@
+/**
+ * JQHTML Data Proxy System
+ *
+ * Extracted from component.ts - handles:
+ * - Data freeze/unfreeze enforcement via Proxy
+ * - Detached on_load() execution with restricted access
+ */
+/**
+ * Set up the `this.data` property on a component using Object.defineProperty
+ * with a Proxy that enforces freeze/unfreeze semantics.
+ *
+ * After setup:
+ * - `this.data` reads/writes go through a Proxy
+ * - When `component.__data_frozen === true`, writes throw errors
+ * - When frozen is false, writes pass through normally
+ *
+ * @param component - The component instance to set up data on
+ */
+export declare function setup_data_property(component: any): void;
+/**
+ * Execute on_load() in a detached context with restricted access.
+ *
+ * Creates a sandboxed environment where on_load() can only access:
+ * - this.args (read-only)
+ * - this.data (read/write, cloned from __initial_data_snapshot)
+ *
+ * All other property access (this.$, this.$sid, etc.) throws errors.
+ *
+ * @param component - The component instance
+ * @param use_load_coordinator - Whether to use Load_Coordinator for deduplication
+ * @returns The resulting data and optional coordination completion function
+ */
+export declare function execute_on_load_detached(component: any, use_load_coordinator?: boolean): Promise<{
+    data: Record<string, any>;
+    complete_coordination: ((data: Record<string, any>) => void) | null;
+}>;
+//# sourceMappingURL=data-proxy.d.ts.map

package/dist/data-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-proxy.d.ts","sourceRoot":"","sources":["../src/data-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CAiFxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,EAAE,GAAG,EAAE,oBAAoB,GAAE,OAAe,GAAG,OAAO,CAAC;IAC7G,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,qBAAqB,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACrE,CAAC,CA8JD"}