@g9tm/lynxcontrols 0.0.0-stage → 1.4.0

package/dist/cascade/model.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade/model.jsx","sources":["../../src/cascade/model.ts"],"sourcesContent":["import type { G9CascadeDirection } from '@g9tm/lynxcontrols-foundation';\nimport type { ReactNode } from '@lynx-js/react';\n\n// The drill-down stack of `G9CascadePanel` (MAUI `G9CascadePanel` push/pop logic), as a pure model: the view renders\n// its snapshot; timers come from the caller so tests drive time.\n\n/** A nested panel's content: built, or built lazily after its slide (spinner meanwhile). */\nexport type G9CascadeContent = ReactNode | (() => ReactNode);\n\n/** Options of one push (MAUI `Push(content, title, direction, wrapInScrollView)`). */\nexport interface G9CascadePushOptions {\n  readonly title?: string | null;\n  /** Entry direction of this panel; default the panel's `direction`. */\n  readonly direction?: G9CascadeDirection;\n  /** Wrap the content in a vertical scroll view (false for content that scrolls itself, e.g. a list). Default true. */\n  readonly wrapInScrollView?: boolean;\n}\n\n/** Where a panel is in its life. `staged` = mounted off-screen for one frame so the slide can start from there. */\nexport type G9CascadePanelStatus = 'staged' | 'entering' | 'shown' | 'leaving';\n\n/** One nested panel (depth ≥ 1). */\nexport interface G9CascadePanelEntry {\n  readonly id: number;\n  readonly content: G9CascadeContent;\n  readonly title: string | null;\n  readonly direction: G9CascadeDirection | null;\n  readonly wrap: boolean;\n  readonly status: G9CascadePanelStatus;\n}\n\n/** Timing and callbacks of the stack. */\nexport interface G9CascadeConfig {\n  setTimer(callback: () => void, ms: number): unknown;\n  clearTimer(handle: unknown): void;\n  durationMs(): number;\n  onPushed?(depth: number): void;\n  onPopped?(depth: number): void;\n}\n\ntype Op =\n  | { kind: 'push'; content: G9CascadeContent; options: G9CascadePushOptions; done: (ok: boolean) => void }\n  | {\n      kind: 'pop';\n      done: (ok: boolean) => void;\n    };\n\n/**\n * One slide at a time (MAUI re-entrancy guard): a second operation of the SAME kind during a slide is dropped (two\n * taps never push two panels or pop two levels); one of the OTHER kind is parked and runs when the slide ends (a newer\n * parked one replaces it). `popToRoot` waits out a slide in flight. Every operation resolves `true` when its slide\n * finished, `false` when it was dropped, displaced or had nothing to do.\n */\nexport class G9CascadeStack {\n  private panels: G9CascadePanelEntry[] = [];\n  private nextId = 1;\n  private running: Op['kind'] | null = null;\n  private parked: Op | null = null;\n  private timers = new Set<unknown>();\n  private readonly listeners = new Set<() => void>();\n  private snapshot: ReadonlyArray<G9CascadePanelEntry> = [];\n  private disposed = false;\n\n  constructor(private readonly config: G9CascadeConfig) {}\n\n  /** Nested depth: 0 = only the root (MAUI `Depth`); a leaving panel no longer counts. */\n  get depth(): number {\n    return this.panels.filter((p) => p.status !== 'leaving').length;\n  }\n\n  getSnapshot(): ReadonlyArray<G9CascadePanelEntry> {\n    return this.snapshot;\n  }\n\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  /** Pushes a panel; resolves when it slid in (MAUI `PushAsync`). */\n  push(content: G9CascadeContent, options: G9CascadePushOptions = {}): Promise<boolean> {\n    return new Promise((done) => this.request({ kind: 'push', content, options, done }));\n  }\n\n  /** Pops the top panel; resolves when it slid out. No-op at the root (MAUI `PopAsync`). */\n  pop(): Promise<boolean> {\n    return new Promise((done) => this.request({ kind: 'pop', done }));\n  }\n\n  /** Pops every panel back to the root, after a slide in flight (MAUI `PopToRootAsync`). */\n  async popToRoot(): Promise<boolean> {\n    while (this.running) await new Promise<void>((r) => this.later(r, this.config.durationMs()));\n    if (this.depth === 0) return false;\n    // The intermediate levels go at once; the top one slides out over the root.\n    const top = this.panels[this.panels.length - 1] as G9CascadePanelEntry;\n    this.panels = [top];\n    this.emit();\n    return this.pop();\n  }\n\n  /** Cancels every timer; pending operations resolve `false`. */\n  dispose(): void {\n    this.disposed = true;\n    for (const t of this.timers) this.config.clearTimer(t);\n    this.timers.clear();\n    this.parked?.done(false);\n    this.parked = null;\n  }\n\n  private request(op: Op): void {\n    if (this.disposed) {\n      op.done(false);\n      return;\n    }\n    if (this.running) {\n      if (this.running === op.kind) {\n        op.done(false);\n        return;\n      }\n      this.parked?.done(false);\n      this.parked = op;\n      return;\n    }\n    this.start(op);\n  }\n\n  private start(op: Op): void {\n    if (op.kind === 'pop') {\n      const top = [...this.panels].reverse().find((p) => p.status !== 'leaving');\n      if (!top) {\n        op.done(false);\n        return;\n      }\n      this.running = 'pop';\n      this.set(top.id, 'leaving');\n      this.later(() => {\n        this.panels = this.panels.filter((p) => p.id !== top.id);\n        this.emit();\n        this.finish(op, () => this.config.onPopped?.(this.depth));\n      }, this.config.durationMs());\n      return;\n    }\n    this.running = 'push';\n    const entry: G9CascadePanelEntry = {\n      id: this.nextId++,\n      content: op.content,\n      title: op.options.title ?? null,\n      direction: op.options.direction ?? null,\n      wrap: op.options.wrapInScrollView !== false,\n      status: 'staged',\n    };\n    this.panels = [...this.panels, entry];\n    this.emit();\n    // One frame off-screen, then the slide (MAUI parks the panel once it has a size, then animates).\n    this.later(() => {\n      this.set(entry.id, 'entering');\n      this.later(() => {\n        this.set(entry.id, 'shown');\n        this.finish(op, () => this.config.onPushed?.(this.depth));\n      }, this.config.durationMs());\n    }, 16);\n  }\n\n  private finish(op: Op, report: () => void): void {\n    this.running = null;\n    try {\n      report();\n    } finally {\n      op.done(true);\n      const parked = this.parked;\n      this.parked = null;\n      if (parked && !this.disposed) this.start(parked);\n    }\n  }\n\n  private set(id: number, status: G9CascadePanelStatus): void {\n    this.panels = this.panels.map((p) => (p.id === id ? { ...p, status } : p));\n    this.emit();\n  }\n\n  private later(callback: () => void, ms: number): void {\n    const handle = this.config.setTimer(() => {\n      this.timers.delete(handle);\n      if (!this.disposed) callback();\n    }, ms);\n    this.timers.add(handle);\n  }\n\n  private emit(): void {\n    this.snapshot = this.panels;\n    for (const l of this.listeners) l();\n  }\n}\n"],"names":["G9CascadeStack","p","listener","content","options","Promise","done","r","top","_this_parked","t","op","_op_options_title","_op_options_direction","_this_config","entry","report","parked","id","status","callback","ms","handle","l","config","Set"],"mappings":"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"}

package/dist/deferred/deferred-content.d.ts

@@ -0,0 +1,82 @@
+import { type G9AbortSignal } from '@g9tm/lynxcontrols-foundation';
+import { type ReactNode } from '@lynx-js/react';
+import type { CSSProperties } from '@lynx-js/types';
+import { type G9ReadinessSignal } from './readiness-signal.js';
+import './deferred.css';
+/** Default delay before the content is built (MAUI `DeferredContentView.DefaultLoadDelayMs`, the layout metric, 369). */
+export declare const g9DeferredLoadDelayMs: number;
+/** Default cap of the covered reveal's settle window (MAUI `FadeRevealDelayMs`). */
+export declare const g9DeferredFadeRevealDelayMs = 220;
+/** Default frames the covered content gets after its first layout (MAUI `RevealSettleFrames`). */
+export declare const g9DeferredRevealSettleFrames = 2;
+/** Longest the covered reveal waits for readiness signals (MAUI `ContentReadinessTimeoutMs`). */
+export declare const g9DeferredReadinessTimeoutMs = 5000;
+/** The cover's fade-out (MAUI: `FadeToAsync(0, 160, CubicIn)`). */
+export declare const g9DeferredCoverFadeMs = 160;
+/** Imperative handle of {@link G9DeferredContent} (via `ref`). */
+export interface G9DeferredContentHandle {
+    /**
+     * Starts the load now (MAUI `LoadContentAsync`): waits `loadDelayMs`, builds the content, reveals it. A second call
+     * while a load is claimed returns at once. Aborting `signal` (or unmounting) before the content is built releases
+     * the claim so a later call loads again. Settles when the content is mounted (not when the reveal settles).
+     */
+    load(signal?: G9AbortSignal): Promise<void>;
+    /** The load has been claimed (MAUI `IsContentLoaded`): a re-entrancy latch, `true` from the start of a load. */
+    readonly isContentLoaded: boolean;
+    /** The final content is the only visual (MAUI `IsRevealSettled`); also `true` after a failure. */
+    readonly isRevealSettled: boolean;
+}
+/** Props of {@link G9DeferredContent}. */
+export interface G9DeferredContentProps {
+    /** Builds the content after the delay (MAUI `ContentFactory`): preferred when building is expensive. */
+    readonly render?: () => ReactNode;
+    /** Already-built content to swap in after the delay (MAUI `DeferredContent`); used when `render` is absent. */
+    readonly children?: ReactNode;
+    /** The placeholder (MAUI `LoadingView`). Default: a full-fill themed background with a centred 42 px spinner. */
+    readonly placeholder?: ReactNode;
+    /** Start loading on mount (MAUI `AutoLoad`). Default `true`; otherwise call `ref.load()`. */
+    readonly autoLoad?: boolean;
+    /** Delay before the content is built (MAUI `LoadDelayMs`). Default {@link g9DeferredLoadDelayMs}. */
+    readonly loadDelayMs?: number;
+    /**
+     * Reveal under the opaque placeholder and fade it out once the content settled (MAUI `FadeContentIn`): first
+     * layout + `revealSettleFrames` frames (capped by `fadeRevealDelayMs`), then every readiness gate
+     * (`useG9DeferredReadiness`, at most 5 s), then a 160 ms fade. Default `false` (instant swap).
+     */
+    readonly fadeContentIn?: boolean;
+    /** Cap of the settle window (MAUI `FadeRevealDelayMs`); `0` skips it. Default 220. */
+    readonly fadeRevealDelayMs?: number;
+    /** Frames after the content's first layout (MAUI `RevealSettleFrames`). Default 2. */
+    readonly revealSettleFrames?: number;
+    /** Called right after the content was built, before it is shown (MAUI `OnContentCreated`). */
+    readonly onContentCreated?: () => void;
+    /** The content is mounted (MAUI `ContentLoaded`); with `fadeContentIn` it is still covered. */
+    readonly onContentLoaded?: () => void;
+    /** The content is the only visual, or the load failed (MAUI `RevealSettled`): re-measure here. */
+    readonly onRevealSettled?: () => void;
+    /**
+     * What to show after a failure: the build threw, or the content threw while rendering. Default: the placeholder
+     * stays (MAUI). The error has already gone to diagnostics and the executor's popup; `retry` loads again.
+     */
+    readonly renderError?: (error: unknown, retry: () => void) => ReactNode;
+    /** Names the load in diagnostics (`deferred:<name>`). Default `'G9DeferredContent'`. */
+    readonly name?: string;
+    readonly className?: string;
+    readonly style?: CSSProperties;
+}
+/**
+ * Opts the calling content into the covered reveal's readiness gate (MAUI `IDeferredContentReadiness` /
+ * `GateContentReadiness`): the placeholder stays until the returned signal's `markReady()` runs (bounded by 5 s), so
+ * work applied after the first layout (a data fill, a scroll-to-selection) is never seen re-rendering. Call
+ * `markReady()` on every path, including failures. Outside a fading `G9DeferredContent` nothing waits for it.
+ */
+export declare function useG9DeferredReadiness(): G9ReadinessSignal;
+/**
+ * Shows a placeholder first and the real content after the host's open animation (MAUI `DeferredContentView`), so an
+ * expensive body never blocks the animation and the user sees motion, not a blank host. The build runs through the
+ * provider's safe executor (errors go to diagnostics and the popup), holds a busy activity `deferred:<name>` until the
+ * reveal settles, is cancelled by unmount, and can be retried. Built on lynx-ui `DeferredComponent` for the
+ * frame-counted settle window of the covered reveal. Must be inside `G9Provider`.
+ */
+export declare const G9DeferredContent: import("react").ForwardRefExoticComponent<G9DeferredContentProps & import("react").RefAttributes<G9DeferredContentHandle>>;
+//# sourceMappingURL=deferred-content.d.ts.map

package/dist/deferred/deferred-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-content.d.ts","sourceRoot":"","sources":["../../src/deferred/deferred-content.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAGnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAIL,KAAK,SAAS,EAOf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,gBAAgB,CAAC;AAExB,yHAAyH;AACzH,eAAO,MAAM,qBAAqB,EAAE,MAAmD,CAAC;AACxF,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,iGAAiG;AACjG,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,kEAAkE;AAClE,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,gHAAgH;IAChH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,kGAAkG;IAClG,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,wGAAwG;IACxG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,SAAS,CAAC;IAClC,+GAA+G;IAC/G,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,iHAAiH;IACjH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,qGAAqG;IACrG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,sFAAsF;IACtF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,sFAAsF;IACtF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,8FAA8F;IAC9F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,+FAA+F;IAC/F,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IACtC,kGAAkG;IAClG,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IACxE,wFAAwF;IACxF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC;AAOD;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,CAK1D;AA0CD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,4HAoN5B,CAAC"}

package/dist/deferred/deferred-content.jsx

@@ -0,0 +1,263 @@
+import { createAbortController, g9LayoutMetrics } from "@g9tm/lynxcontrols-foundation";
+import { DeferredComponent } from "@lynx-js/lynx-ui-deferred-component";
+import { createContext, forwardRef, useContext, useEffect, useErrorBoundary, useImperativeHandle, useRef, useState } from "@lynx-js/react";
+import { useDisposer } from "../base/disposer.jsx";
+import { useStableCallback } from "../base/use-stable-callback.jsx";
+import { useG9Core } from "../provider/hooks.jsx";
+import { createReadinessSignal } from "./readiness-signal.jsx";
+import "./deferred.css";
+const g9DeferredLoadDelayMs = g9LayoutMetrics.DeferredContentLoadDelayMs;
+const g9DeferredFadeRevealDelayMs = 220;
+const g9DeferredRevealSettleFrames = 2;
+const g9DeferredReadinessTimeoutMs = 5000;
+const g9DeferredCoverFadeMs = 160;
+const G9DeferredReadinessContext = createContext(null);
+function useG9DeferredReadiness() {
+    const [signal] = useState(createReadinessSignal);
+    const registry = useContext(G9DeferredReadinessContext);
+    useEffect(()=>null == registry ? void 0 : registry.register(signal), [
+        registry,
+        signal
+    ]);
+    return signal;
+}
+function DefaultPlaceholder() {
+    return <view className="g9-deferred__placeholder">
+      <view className="g9-deferred__spinner"/>
+    </view>;
+}
+function SettleProbe(props) {
+    const { onSettled } = props;
+    useEffect(()=>onSettled(), [
+        onSettled
+    ]);
+    return null;
+}
+function ContentBoundary(props) {
+    const [error] = useErrorBoundary(props.onError);
+    return error ? null : props.children;
+}
+function waitFor(ms, signals, schedule) {
+    return new Promise((resolve)=>{
+        const live = signals.filter((signal)=>void 0 !== signal);
+        if (live.some((signal)=>signal.aborted)) return resolve(false);
+        let cancel = ()=>{};
+        const onAbort = ()=>finish(false);
+        function finish(ok) {
+            cancel();
+            for (const signal of live)signal.removeEventListener('abort', onAbort);
+            resolve(ok);
+        }
+        for (const signal of live)signal.addEventListener('abort', onAbort);
+        if (ms > 0) cancel = schedule(()=>finish(true), ms);
+        else Promise.resolve().then(()=>finish(!live.some((signal)=>signal.aborted)));
+    });
+}
+const deferred_content_G9DeferredContent = forwardRef(function(props, ref) {
+    var _props_name, _props_fadeContentIn, _props_fadeRevealDelayMs, _props_placeholder, _latest_current_revealSettleFrames;
+    const core = useG9Core();
+    const disposer = useDisposer();
+    const latest = useRef(props);
+    latest.current = props;
+    const name = null != (_props_name = props.name) ? _props_name : 'G9DeferredContent';
+    const fade = null != (_props_fadeContentIn = props.fadeContentIn) ? _props_fadeContentIn : false;
+    const settleCap = null != (_props_fadeRevealDelayMs = props.fadeRevealDelayMs) ? _props_fadeRevealDelayMs : g9DeferredFadeRevealDelayMs;
+    const [phase, setPhase] = useState('placeholder');
+    const [content, setContent] = useState(null);
+    const [failure, setFailure] = useState(null);
+    const [coverFading, setCoverFading] = useState(false);
+    const [session] = useState(()=>({
+            claimed: false,
+            settled: false,
+            attempt: 0,
+            unmount: createAbortController(),
+            activity: null,
+            gates: new Set()
+        }));
+    const [registry] = useState(()=>({
+            register (signal) {
+                session.gates.add(signal);
+                return ()=>{
+                    session.gates.delete(signal);
+                };
+            }
+        }));
+    const endActivity = ()=>{
+        var _session_activity;
+        null == (_session_activity = session.activity) || _session_activity.dispose();
+        session.activity = null;
+    };
+    const fail = useStableCallback((error)=>{
+        var _latest_current_onRevealSettled, _latest_current;
+        session.claimed = false;
+        session.settled = true;
+        endActivity();
+        setFailure({
+            error
+        });
+        setPhase('failed');
+        null == (_latest_current_onRevealSettled = (_latest_current = latest.current).onRevealSettled) || _latest_current_onRevealSettled.call(_latest_current);
+    });
+    const reportRenderError = useStableCallback((error)=>{
+        core.executor.run(()=>{
+            throw error;
+        }, {
+            source: name,
+            throttleKey: `${name}.render`,
+            enableThrottle: false,
+            preventConcurrentExecution: false
+        });
+        fail(error);
+    });
+    const load = useStableCallback(async (signal)=>{
+        var _session;
+        if (session.claimed || session.unmount.signal.aborted) return;
+        session.claimed = true;
+        session.settled = false;
+        null != (_session = session).activity || (_session.activity = core.diagnostics.activity(`deferred:${name}`));
+        let built = false;
+        const result = await core.executor.run(async (context)=>{
+            var _latest_current_loadDelayMs;
+            var _current_onContentCreated;
+            const delay = null != (_latest_current_loadDelayMs = latest.current.loadDelayMs) ? _latest_current_loadDelayMs : g9DeferredLoadDelayMs;
+            const due = await waitFor(delay, [
+                context.signal,
+                session.unmount.signal,
+                signal
+            ], disposer.setTimeout);
+            if (!due) return;
+            const current = latest.current;
+            const node = current.render ? current.render() : current.children;
+            null == (_current_onContentCreated = current.onContentCreated) || _current_onContentCreated.call(current);
+            session.attempt += 1;
+            built = true;
+            setFailure(null);
+            setCoverFading(false);
+            setContent({
+                node,
+                attempt: session.attempt
+            });
+            setPhase(fade ? 'revealing' : 'settled');
+        }, {
+            source: name,
+            throttleKey: `${name}.load`,
+            enableThrottle: false,
+            preventConcurrentExecution: false,
+            ...signal ? {
+                signal
+            } : {}
+        });
+        if ('failed' === result.status) return void fail(result.error);
+        if (!built) {
+            session.claimed = false;
+            endActivity();
+        }
+    });
+    const retry = useStableCallback(()=>{
+        load();
+    });
+    useImperativeHandle(ref, ()=>({
+            load: (signal)=>load(signal),
+            get isContentLoaded () {
+                return session.claimed;
+            },
+            get isRevealSettled () {
+                return session.settled;
+            }
+        }), [
+        load,
+        session
+    ]);
+    useEffect(()=>{
+        var _latest_current_autoLoad;
+        if (null != (_latest_current_autoLoad = latest.current.autoLoad) ? _latest_current_autoLoad : true) load();
+        return ()=>{
+            session.unmount.abort();
+            endActivity();
+        };
+    }, [
+        load,
+        session
+    ]);
+    useEffect(()=>{
+        if ('revealing' === phase) {
+            var _latest_current_onContentLoaded, _latest_current;
+            null == (_latest_current_onContentLoaded = (_latest_current = latest.current).onContentLoaded) || _latest_current_onContentLoaded.call(_latest_current);
+            if (!(settleCap <= 0)) return disposer.setTimeout(()=>setPhase((p)=>'revealing' === p ? 'fading' : p), settleCap);
+            else setPhase('fading');
+        }
+        if ('settled' === phase && !session.settled) {
+            var _latest_current_onContentLoaded1, _latest_current1, _latest_current_onRevealSettled, _latest_current2;
+            session.settled = true;
+            endActivity();
+            if (!fade) null == (_latest_current_onContentLoaded1 = (_latest_current1 = latest.current).onContentLoaded) || _latest_current_onContentLoaded1.call(_latest_current1);
+            null == (_latest_current_onRevealSettled = (_latest_current2 = latest.current).onRevealSettled) || _latest_current_onRevealSettled.call(_latest_current2);
+        }
+    }, [
+        phase,
+        fade,
+        settleCap,
+        disposer,
+        session
+    ]);
+    useEffect(()=>{
+        if ('fading' !== phase) return;
+        let done = false;
+        const unsubscribes = [];
+        const startFade = ()=>{
+            if (done) return;
+            done = true;
+            for (const unsubscribe of unsubscribes)unsubscribe();
+            setCoverFading(true);
+            disposer.setTimeout(()=>setPhase('settled'), g9DeferredCoverFadeMs);
+        };
+        const pending = Array.from(session.gates).filter((gate)=>!gate.isReady);
+        if (0 === pending.length) return void startFade();
+        let remaining = pending.length;
+        for (const gate of pending)unsubscribes.push(gate.subscribe(()=>{
+            remaining -= 1;
+            if (0 === remaining) startFade();
+        }));
+        unsubscribes.push(disposer.setTimeout(startFade, g9DeferredReadinessTimeoutMs));
+        return ()=>{
+            done = true;
+            for (const unsubscribe of unsubscribes)unsubscribe();
+        };
+    }, [
+        phase,
+        disposer,
+        session
+    ]);
+    const onSettleProbe = useStableCallback(()=>{
+        setPhase((p)=>'revealing' === p ? 'fading' : p);
+    });
+    const placeholder = null != (_props_placeholder = props.placeholder) ? _props_placeholder : <DefaultPlaceholder/>;
+    const covering = 'revealing' === phase || 'fading' === phase;
+    const showContent = null !== content && (covering || 'settled' === phase);
+    return <view className={`g9-deferred${props.className ? ` ${props.className}` : ''}`} {...props.style ? {
+        style: props.style
+    } : {}}>
+      {showContent ? <G9DeferredReadinessContext.Provider value={registry}>
+          <view className="g9-deferred__content">
+            <ContentBoundary key={content.attempt} onError={reportRenderError}>
+              {content.node}
+            </ContentBoundary>
+          </view>
+        </G9DeferredReadinessContext.Provider> : null}
+      {covering ? <view className={`g9-deferred__cover${coverFading ? ' g9-deferred__cover--fading' : ''}`}>
+          {placeholder}
+          {'revealing' === phase ? <DeferredComponent delayFrames={null != (_latest_current_revealSettleFrames = latest.current.revealSettleFrames) ? _latest_current_revealSettleFrames : g9DeferredRevealSettleFrames} estimatedStyle={{
+        position: 'absolute',
+        width: '0px',
+        height: '0px'
+    }}>
+              <SettleProbe onSettled={onSettleProbe}/>
+            </DeferredComponent> : null}
+        </view> : null}
+      {'placeholder' === phase ? placeholder : null}
+      {'failed' === phase ? props.renderError ? props.renderError(null == failure ? void 0 : failure.error, retry) : placeholder : null}
+    </view>;
+});
+export { deferred_content_G9DeferredContent as G9DeferredContent, g9DeferredCoverFadeMs, g9DeferredFadeRevealDelayMs, g9DeferredLoadDelayMs, g9DeferredReadinessTimeoutMs, g9DeferredRevealSettleFrames, useG9DeferredReadiness };
+
+//# sourceMappingURL=deferred-content.jsx.map

package/dist/deferred/deferred-content.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred/deferred-content.jsx","sources":["../../src/deferred/deferred-content.tsx"],"sourcesContent":["import {\n  createAbortController,\n  type G9AbortSignal,\n  type G9ActivityScope,\n  g9LayoutMetrics,\n} from '@g9tm/lynxcontrols-foundation';\nimport { DeferredComponent } from '@lynx-js/lynx-ui-deferred-component';\nimport {\n  createContext,\n  type ForwardedRef,\n  forwardRef,\n  type ReactNode,\n  useContext,\n  useEffect,\n  useErrorBoundary,\n  useImperativeHandle,\n  useRef,\n  useState,\n} from '@lynx-js/react';\nimport type { CSSProperties } from '@lynx-js/types';\nimport { useDisposer } from '../base/disposer';\nimport { useStableCallback } from '../base/use-stable-callback';\nimport { useG9Core } from '../provider/hooks';\nimport { createReadinessSignal, type G9ReadinessSignal } from './readiness-signal';\nimport './deferred.css';\n\n/** Default delay before the content is built (MAUI `DeferredContentView.DefaultLoadDelayMs`, the layout metric, 369). */\nexport const g9DeferredLoadDelayMs: number = g9LayoutMetrics.DeferredContentLoadDelayMs;\n/** Default cap of the covered reveal's settle window (MAUI `FadeRevealDelayMs`). */\nexport const g9DeferredFadeRevealDelayMs = 220;\n/** Default frames the covered content gets after its first layout (MAUI `RevealSettleFrames`). */\nexport const g9DeferredRevealSettleFrames = 2;\n/** Longest the covered reveal waits for readiness signals (MAUI `ContentReadinessTimeoutMs`). */\nexport const g9DeferredReadinessTimeoutMs = 5000;\n/** The cover's fade-out (MAUI: `FadeToAsync(0, 160, CubicIn)`). */\nexport const g9DeferredCoverFadeMs = 160;\n\n/** Imperative handle of {@link G9DeferredContent} (via `ref`). */\nexport interface G9DeferredContentHandle {\n  /**\n   * Starts the load now (MAUI `LoadContentAsync`): waits `loadDelayMs`, builds the content, reveals it. A second call\n   * while a load is claimed returns at once. Aborting `signal` (or unmounting) before the content is built releases\n   * the claim so a later call loads again. Settles when the content is mounted (not when the reveal settles).\n   */\n  load(signal?: G9AbortSignal): Promise<void>;\n  /** The load has been claimed (MAUI `IsContentLoaded`): a re-entrancy latch, `true` from the start of a load. */\n  readonly isContentLoaded: boolean;\n  /** The final content is the only visual (MAUI `IsRevealSettled`); also `true` after a failure. */\n  readonly isRevealSettled: boolean;\n}\n\n/** Props of {@link G9DeferredContent}. */\nexport interface G9DeferredContentProps {\n  /** Builds the content after the delay (MAUI `ContentFactory`): preferred when building is expensive. */\n  readonly render?: () => ReactNode;\n  /** Already-built content to swap in after the delay (MAUI `DeferredContent`); used when `render` is absent. */\n  readonly children?: ReactNode;\n  /** The placeholder (MAUI `LoadingView`). Default: a full-fill themed background with a centred 42 px spinner. */\n  readonly placeholder?: ReactNode;\n  /** Start loading on mount (MAUI `AutoLoad`). Default `true`; otherwise call `ref.load()`. */\n  readonly autoLoad?: boolean;\n  /** Delay before the content is built (MAUI `LoadDelayMs`). Default {@link g9DeferredLoadDelayMs}. */\n  readonly loadDelayMs?: number;\n  /**\n   * Reveal under the opaque placeholder and fade it out once the content settled (MAUI `FadeContentIn`): first\n   * layout + `revealSettleFrames` frames (capped by `fadeRevealDelayMs`), then every readiness gate\n   * (`useG9DeferredReadiness`, at most 5 s), then a 160 ms fade. Default `false` (instant swap).\n   */\n  readonly fadeContentIn?: boolean;\n  /** Cap of the settle window (MAUI `FadeRevealDelayMs`); `0` skips it. Default 220. */\n  readonly fadeRevealDelayMs?: number;\n  /** Frames after the content's first layout (MAUI `RevealSettleFrames`). Default 2. */\n  readonly revealSettleFrames?: number;\n  /** Called right after the content was built, before it is shown (MAUI `OnContentCreated`). */\n  readonly onContentCreated?: () => void;\n  /** The content is mounted (MAUI `ContentLoaded`); with `fadeContentIn` it is still covered. */\n  readonly onContentLoaded?: () => void;\n  /** The content is the only visual, or the load failed (MAUI `RevealSettled`): re-measure here. */\n  readonly onRevealSettled?: () => void;\n  /**\n   * What to show after a failure: the build threw, or the content threw while rendering. Default: the placeholder\n   * stays (MAUI). The error has already gone to diagnostics and the executor's popup; `retry` loads again.\n   */\n  readonly renderError?: (error: unknown, retry: () => void) => ReactNode;\n  /** Names the load in diagnostics (`deferred:<name>`). Default `'G9DeferredContent'`. */\n  readonly name?: string;\n  readonly className?: string;\n  readonly style?: CSSProperties;\n}\n\ntype Phase = 'placeholder' | 'revealing' | 'fading' | 'settled' | 'failed';\n\n/** Readiness gates registered by the content of the nearest {@link G9DeferredContent}. */\nconst G9DeferredReadinessContext = createContext<{ register(signal: G9ReadinessSignal): () => void } | null>(null);\n\n/**\n * Opts the calling content into the covered reveal's readiness gate (MAUI `IDeferredContentReadiness` /\n * `GateContentReadiness`): the placeholder stays until the returned signal's `markReady()` runs (bounded by 5 s), so\n * work applied after the first layout (a data fill, a scroll-to-selection) is never seen re-rendering. Call\n * `markReady()` on every path, including failures. Outside a fading `G9DeferredContent` nothing waits for it.\n */\nexport function useG9DeferredReadiness(): G9ReadinessSignal {\n  const [signal] = useState(createReadinessSignal);\n  const registry = useContext(G9DeferredReadinessContext);\n  useEffect(() => registry?.register(signal), [registry, signal]);\n  return signal;\n}\n\nfunction DefaultPlaceholder(): ReactNode {\n  return (\n    <view className=\"g9-deferred__placeholder\">\n      <view className=\"g9-deferred__spinner\" />\n    </view>\n  );\n}\n\nfunction SettleProbe(props: { readonly onSettled: () => void }): ReactNode {\n  const { onSettled } = props;\n  useEffect(() => onSettled(), [onSettled]);\n  return null;\n}\n\nfunction ContentBoundary(props: { readonly onError: (error: unknown) => void; readonly children?: ReactNode }) {\n  const [error] = useErrorBoundary(props.onError);\n  return error ? null : props.children;\n}\n\nfunction waitFor(\n  ms: number,\n  signals: ReadonlyArray<G9AbortSignal | undefined>,\n  schedule: (callback: () => void, ms: number) => () => void,\n): Promise<boolean> {\n  return new Promise<boolean>((resolve) => {\n    const live = signals.filter((signal): signal is G9AbortSignal => signal !== undefined);\n    if (live.some((signal) => signal.aborted)) return resolve(false);\n    let cancel = () => {};\n    const onAbort = () => finish(false);\n    function finish(ok: boolean) {\n      cancel();\n      for (const signal of live) signal.removeEventListener('abort', onAbort);\n      resolve(ok);\n    }\n    for (const signal of live) signal.addEventListener('abort', onAbort);\n    if (ms > 0) cancel = schedule(() => finish(true), ms);\n    else void Promise.resolve().then(() => finish(!live.some((signal) => signal.aborted)));\n  });\n}\n\n/**\n * Shows a placeholder first and the real content after the host's open animation (MAUI `DeferredContentView`), so an\n * expensive body never blocks the animation and the user sees motion, not a blank host. The build runs through the\n * provider's safe executor (errors go to diagnostics and the popup), holds a busy activity `deferred:<name>` until the\n * reveal settles, is cancelled by unmount, and can be retried. Built on lynx-ui `DeferredComponent` for the\n * frame-counted settle window of the covered reveal. Must be inside `G9Provider`.\n */\nexport const G9DeferredContent = forwardRef(function G9DeferredContent(\n  props: G9DeferredContentProps,\n  ref: ForwardedRef<G9DeferredContentHandle>,\n): ReactNode {\n  const core = useG9Core();\n  const disposer = useDisposer();\n  const latest = useRef(props);\n  latest.current = props;\n  const name = props.name ?? 'G9DeferredContent';\n  const fade = props.fadeContentIn ?? false;\n  const settleCap = props.fadeRevealDelayMs ?? g9DeferredFadeRevealDelayMs;\n\n  const [phase, setPhase] = useState<Phase>('placeholder');\n  const [content, setContent] = useState<{ readonly node: ReactNode; readonly attempt: number } | null>(null);\n  const [failure, setFailure] = useState<{ readonly error: unknown } | null>(null);\n  const [coverFading, setCoverFading] = useState(false);\n  const [session] = useState(() => ({\n    claimed: false,\n    settled: false,\n    attempt: 0,\n    unmount: createAbortController(),\n    activity: null as G9ActivityScope | null,\n    gates: new Set<G9ReadinessSignal>(),\n  }));\n  const [registry] = useState(() => ({\n    register(signal: G9ReadinessSignal) {\n      session.gates.add(signal);\n      return () => {\n        session.gates.delete(signal);\n      };\n    },\n  }));\n\n  const endActivity = () => {\n    session.activity?.dispose();\n    session.activity = null;\n  };\n\n  const fail = useStableCallback((error: unknown) => {\n    // MAUI: release the latch, stop claiming to be loading (hosts holding their size let go), report the failure.\n    session.claimed = false;\n    session.settled = true;\n    endActivity();\n    setFailure({ error });\n    setPhase('failed');\n    latest.current.onRevealSettled?.();\n  });\n\n  const reportRenderError = useStableCallback((error: unknown) => {\n    void core.executor.run(\n      () => {\n        throw error;\n      },\n      { source: name, throttleKey: `${name}.render`, enableThrottle: false, preventConcurrentExecution: false },\n    );\n    fail(error);\n  });\n\n  const load = useStableCallback(async (signal?: G9AbortSignal) => {\n    if (session.claimed || session.unmount.signal.aborted) return;\n    session.claimed = true;\n    session.settled = false;\n    session.activity ??= core.diagnostics.activity(`deferred:${name}`);\n    let built = false;\n    const result = await core.executor.run(\n      async (context) => {\n        const delay = latest.current.loadDelayMs ?? g9DeferredLoadDelayMs;\n        const due = await waitFor(delay, [context.signal, session.unmount.signal, signal], disposer.setTimeout);\n        if (!due) return;\n        const current = latest.current;\n        const node = current.render ? current.render() : current.children;\n        current.onContentCreated?.();\n        session.attempt += 1;\n        built = true;\n        setFailure(null);\n        setCoverFading(false);\n        setContent({ node, attempt: session.attempt });\n        setPhase(fade ? 'revealing' : 'settled');\n      },\n      {\n        source: name,\n        throttleKey: `${name}.load`,\n        enableThrottle: false,\n        preventConcurrentExecution: false,\n        ...(signal ? { signal } : {}),\n      },\n    );\n    if (result.status === 'failed') {\n      fail(result.error);\n      return;\n    }\n    if (!built) {\n      // Cancelled before the content was built: a cancelled load must be repeatable (MAUI).\n      session.claimed = false;\n      endActivity();\n    }\n  });\n\n  const retry = useStableCallback(() => {\n    void load();\n  });\n\n  useImperativeHandle(\n    ref,\n    () => ({\n      load: (signal) => load(signal) as Promise<void>,\n      get isContentLoaded() {\n        return session.claimed;\n      },\n      get isRevealSettled() {\n        return session.settled;\n      },\n    }),\n    [load, session],\n  );\n\n  // Auto load on mount; unmount cancels a pending load and ends the activity.\n  useEffect(() => {\n    if (latest.current.autoLoad ?? true) void load();\n    return () => {\n      session.unmount.abort();\n      endActivity();\n    };\n  }, [load, session]);\n\n  // Instant swap: loaded and settled together. Covered reveal: loaded now, settled after the fade.\n  useEffect(() => {\n    if (phase === 'revealing') {\n      latest.current.onContentLoaded?.();\n      if (settleCap <= 0) setPhase('fading');\n      else return disposer.setTimeout(() => setPhase((p) => (p === 'revealing' ? 'fading' : p)), settleCap);\n    }\n    if (phase === 'settled' && !session.settled) {\n      session.settled = true;\n      endActivity();\n      if (!fade) latest.current.onContentLoaded?.();\n      latest.current.onRevealSettled?.();\n    }\n    return undefined;\n  }, [phase, fade, settleCap, disposer, session]);\n\n  // The settle window ended: hold the cover for the readiness gates (bounded), then fade it out.\n  useEffect(() => {\n    if (phase !== 'fading') return;\n    let done = false;\n    const unsubscribes: Array<() => void> = [];\n    const startFade = () => {\n      if (done) return;\n      done = true;\n      for (const unsubscribe of unsubscribes) unsubscribe();\n      setCoverFading(true);\n      disposer.setTimeout(() => setPhase('settled'), g9DeferredCoverFadeMs);\n    };\n    const pending = Array.from(session.gates).filter((gate) => !gate.isReady);\n    if (pending.length === 0) {\n      startFade();\n      return;\n    }\n    let remaining = pending.length;\n    for (const gate of pending) {\n      unsubscribes.push(\n        gate.subscribe(() => {\n          remaining -= 1;\n          if (remaining === 0) startFade();\n        }),\n      );\n    }\n    unsubscribes.push(disposer.setTimeout(startFade, g9DeferredReadinessTimeoutMs));\n    return () => {\n      done = true;\n      for (const unsubscribe of unsubscribes) unsubscribe();\n    };\n  }, [phase, disposer, session]);\n\n  const onSettleProbe = useStableCallback(() => {\n    setPhase((p) => (p === 'revealing' ? 'fading' : p));\n  });\n\n  const placeholder = props.placeholder ?? <DefaultPlaceholder />;\n  const covering = phase === 'revealing' || phase === 'fading';\n  const showContent = content !== null && (covering || phase === 'settled');\n  return (\n    <view\n      className={`g9-deferred${props.className ? ` ${props.className}` : ''}`}\n      {...(props.style ? { style: props.style } : {})}\n    >\n      {showContent ? (\n        <G9DeferredReadinessContext.Provider value={registry}>\n          <view className=\"g9-deferred__content\">\n            <ContentBoundary key={content.attempt} onError={reportRenderError}>\n              {content.node}\n            </ContentBoundary>\n          </view>\n        </G9DeferredReadinessContext.Provider>\n      ) : null}\n      {covering ? (\n        <view className={`g9-deferred__cover${coverFading ? ' g9-deferred__cover--fading' : ''}`}>\n          {placeholder}\n          {phase === 'revealing' ? (\n            <DeferredComponent\n              delayFrames={latest.current.revealSettleFrames ?? g9DeferredRevealSettleFrames}\n              estimatedStyle={{ position: 'absolute', width: '0px', height: '0px' }}\n            >\n              <SettleProbe onSettled={onSettleProbe} />\n            </DeferredComponent>\n          ) : null}\n        </view>\n      ) : null}\n      {phase === 'placeholder' ? placeholder : null}\n      {phase === 'failed' ? (props.renderError ? props.renderError(failure?.error, retry) : placeholder) : null}\n    </view>\n  );\n});\n"],"names":["g9DeferredLoadDelayMs","g9LayoutMetrics","g9DeferredFadeRevealDelayMs","g9DeferredRevealSettleFrames","g9DeferredReadinessTimeoutMs","g9DeferredCoverFadeMs","G9DeferredReadinessContext","createContext","useG9DeferredReadiness","signal","useState","createReadinessSignal","registry","useContext","useEffect","DefaultPlaceholder","view","SettleProbe","props","onSettled","ContentBoundary","error","useErrorBoundary","waitFor","ms","signals","schedule","Promise","resolve","live","undefined","cancel","onAbort","finish","ok","G9DeferredContent","forwardRef","ref","_props_name","_props_fadeContentIn","_props_fadeRevealDelayMs","_props_placeholder","_latest_current_revealSettleFrames","core","useG9Core","disposer","useDisposer","latest","useRef","name","fade","settleCap","phase","setPhase","content","setContent","failure","setFailure","coverFading","setCoverFading","session","createAbortController","Set","endActivity","_session_activity","fail","useStableCallback","_latest_current","reportRenderError","load","_session","built","result","context","_latest_current_loadDelayMs","current","delay","due","node","retry","useImperativeHandle","_latest_current_autoLoad","p","_latest_current1","_latest_current2","done","unsubscribes","startFade","unsubscribe","pending","Array","gate","remaining","onSettleProbe","placeholder","covering","showContent","DeferredComponent"],"mappings":"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"}

package/dist/deferred/deferred.css

@@ -0,0 +1,62 @@
+.g9-deferred {
+  flex-direction: column;
+  flex: 1;
+  display: flex;
+  position: relative;
+}
+
+.g9-deferred__content {
+  flex-direction: column;
+  flex: 1;
+  display: flex;
+}
+
+.g9-deferred__placeholder {
+  background-color: var(--g9-background);
+  flex: 1;
+  justify-content: center;
+  align-items: center;
+  display: flex;
+}
+
+.g9-deferred__spinner {
+  border-style: solid;
+  border-width: 4px;
+  border-color: var(--g9-primary);
+  border-top-color: #0000;
+  border-radius: 21px;
+  width: 42px;
+  height: 42px;
+  animation: .9s linear infinite g9-deferred-spin;
+}
+
+.g9-deferred__cover {
+  opacity: 1;
+  flex-direction: column;
+  transition-property: opacity;
+  transition-duration: .16s;
+  transition-timing-function: cubic-bezier(.55, .055, .675, .19);
+  display: flex;
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  right: 0;
+}
+
+.g9-deferred__cover--fading {
+  opacity: 0;
+}
+
+@keyframes g9-deferred-spin {
+  from {
+    transform: rotate(0);
+  }
+
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+
+/*# sourceMappingURL=deferred.css.map */

package/dist/deferred/deferred.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["webpack://./src/deferred/deferred.css"],"names":[],"mappings":"AACA;EAAE,sBAAsB;EACtB,OAAO;EACP,aAAa;EACb,kBAAkB;AACpB;;AAGA;EAAE,sBAAsB;EACtB,OAAO;EACP,aAAa;AACf;;AAIA;EADE,sCAAsC;EACtC,OAAO;EACP,uBAAuB;EACvB,mBAAmB;EACnB,aAAa;AACf;;AAIA;EADE,mBAAmB;EACnB,iBAAiB;EACjB,+BAA+B;EAC/B,uBAAuB;EACvB,mBAAmB;EACnB,WAAW;EACX,YAAY;EACZ,+CAA+C;AACjD;;AAKA;EAFE,UAAU;EACV,sBAAsB;EACtB,4BAA4B;EAC5B,yBAAyB;EACzB,8DAA8D;EAC9D,aAAa;EACb,kBAAkB;EAClB,MAAM;EACN,SAAS;EACT,OAAO;EACP,QAAQ;AACV;;AAKA;EAFE,UAAU;AACZ;;AAKA;EAFE;IACE,oBAAoB;EACtB;;EAEA;IACE,yBAAyB;EAC3B;AACF","sourcesContent":["/* G9DeferredContent: placeholder, content and the covering placeholder of the faded reveal. */\n.g9-deferred {\n  display: flex;\n  flex-direction: column;\n  position: relative;\n  flex: 1;\n}\n\n.g9-deferred__content {\n  display: flex;\n  flex-direction: column;\n  flex: 1;\n}\n\n/* MAUI CreateDefaultLoadingView: a solid themed fill (a stacked sheet must not show what is under it), 42 px spinner. */\n.g9-deferred__placeholder {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  flex: 1;\n  background-color: var(--g9-background);\n}\n\n.g9-deferred__spinner {\n  width: 42px;\n  height: 42px;\n  border-width: 4px;\n  border-style: solid;\n  border-radius: 21px;\n  border-color: var(--g9-primary);\n  border-top-color: transparent;\n  animation: g9-deferred-spin 900ms linear infinite;\n}\n\n/* The covered reveal: the opaque placeholder over the content until it settles, then a 160 ms cubic-in fade. */\n.g9-deferred__cover {\n  display: flex;\n  flex-direction: column;\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  opacity: 1;\n  transition-property: opacity;\n  transition-duration: 160ms;\n  transition-timing-function: cubic-bezier(0.55, 0.055, 0.675, 0.19);\n}\n\n.g9-deferred__cover--fading {\n  opacity: 0;\n}\n\n@keyframes g9-deferred-spin {\n  from {\n    transform: rotate(0deg);\n  }\n  to {\n    transform: rotate(360deg);\n  }\n}\n"],"sourceRoot":""}

package/dist/deferred/index.d.ts

@@ -0,0 +1,3 @@
+export { G9DeferredContent, type G9DeferredContentHandle, type G9DeferredContentProps, g9DeferredCoverFadeMs, g9DeferredFadeRevealDelayMs, g9DeferredLoadDelayMs, g9DeferredReadinessTimeoutMs, g9DeferredRevealSettleFrames, useG9DeferredReadiness, } from './deferred-content.js';
+export { createReadinessSignal, type G9ReadinessSignal } from './readiness-signal.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/deferred/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deferred/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/deferred/index.jsx

@@ -0,0 +1,2 @@
+export { G9DeferredContent, g9DeferredCoverFadeMs, g9DeferredFadeRevealDelayMs, g9DeferredLoadDelayMs, g9DeferredReadinessTimeoutMs, g9DeferredRevealSettleFrames, useG9DeferredReadiness } from "./deferred-content.jsx";
+export { createReadinessSignal } from "./readiness-signal.jsx";

package/dist/deferred/readiness-signal.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A latched "the visual is settled" flag with a one-shot notification (MAUI `DeferredContentReadinessSignal`, the
+ * backing of `IDeferredContentReadiness`). Subscribing after it fired calls the listener at once, so a late
+ * subscriber can never miss it.
+ */
+export interface G9ReadinessSignal {
+    /** `true` once {@link G9ReadinessSignal.markReady} ran. Never goes back. */
+    readonly isReady: boolean;
+    /** Calls `listener` once when ready (at once if already ready). Returns an unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+    /** Flips the flag and notifies; idempotent. */
+    markReady(): void;
+}
+/** Creates a {@link G9ReadinessSignal}. */
+export declare function createReadinessSignal(): G9ReadinessSignal;
+//# sourceMappingURL=readiness-signal.d.ts.map

package/dist/deferred/readiness-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-signal.d.ts","sourceRoot":"","sources":["../../src/deferred/readiness-signal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oGAAoG;IACpG,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,+CAA+C;IAC/C,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,IAAI,iBAAiB,CAyBzD"}

package/dist/deferred/readiness-signal.jsx

@@ -0,0 +1,29 @@
+function createReadinessSignal() {
+    let ready = false;
+    let listeners = new Set();
+    return {
+        get isReady () {
+            return ready;
+        },
+        subscribe (listener) {
+            if (ready) {
+                listener();
+                return ()=>{};
+            }
+            listeners.add(listener);
+            return ()=>{
+                listeners.delete(listener);
+            };
+        },
+        markReady () {
+            if (ready) return;
+            ready = true;
+            const pending = listeners;
+            listeners = new Set();
+            for (const listener of Array.from(pending))listener();
+        }
+    };
+}
+export { createReadinessSignal };
+
+//# sourceMappingURL=readiness-signal.jsx.map

package/dist/deferred/readiness-signal.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred/readiness-signal.jsx","sources":["../../src/deferred/readiness-signal.ts"],"sourcesContent":["/**\n * A latched \"the visual is settled\" flag with a one-shot notification (MAUI `DeferredContentReadinessSignal`, the\n * backing of `IDeferredContentReadiness`). Subscribing after it fired calls the listener at once, so a late\n * subscriber can never miss it.\n */\nexport interface G9ReadinessSignal {\n  /** `true` once {@link G9ReadinessSignal.markReady} ran. Never goes back. */\n  readonly isReady: boolean;\n  /** Calls `listener` once when ready (at once if already ready). Returns an unsubscribe function. */\n  subscribe(listener: () => void): () => void;\n  /** Flips the flag and notifies; idempotent. */\n  markReady(): void;\n}\n\n/** Creates a {@link G9ReadinessSignal}. */\nexport function createReadinessSignal(): G9ReadinessSignal {\n  let ready = false;\n  let listeners = new Set<() => void>();\n  return {\n    get isReady() {\n      return ready;\n    },\n    subscribe(listener) {\n      if (ready) {\n        listener();\n        return () => {};\n      }\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    markReady() {\n      if (ready) return;\n      ready = true;\n      const pending = listeners;\n      listeners = new Set();\n      for (const listener of Array.from(pending)) listener();\n    },\n  };\n}\n"],"names":["createReadinessSignal","ready","listeners","Set","listener","pending","Array"],"mappings":"AAeO,SAASA;IACd,IAAIC,QAAQ;IACZ,IAAIC,YAAY,IAAIC;IACpB,OAAO;QACL,IAAI;YACF,OAAOF;QACT;QACA,WAAUG,QAAQ;YAChB,IAAIH,OAAO;gBACTG;gBACA,OAAO,KAAO;YAChB;YACAF,UAAU,GAAG,CAACE;YACd,OAAO;gBACLF,UAAU,MAAM,CAACE;YACnB;QACF;QACA;YACE,IAAIH,OAAO;YACXA,QAAQ;YACR,MAAMI,UAAUH;YAChBA,YAAY,IAAIC;YAChB,KAAK,MAAMC,YAAYE,MAAM,IAAI,CAACD,SAAUD;QAC9C;IACF;AACF"}

package/dist/display/activity-indicator.d.ts

@@ -0,0 +1,21 @@
+import './display.css';
+import type { ReactNode } from '@lynx-js/react';
+/** Props of {@link G9ActivityIndicator} (MAUI `G9ActivityIndicator` = MAUI `ActivityIndicator`). */
+export interface G9ActivityIndicatorProps {
+    /** Spinning and visible (MAUI `IsRunning`). Default false: the box keeps its size but shows nothing. */
+    readonly running?: boolean;
+    /** Ring colour (MAUI `Color`). Default `var(--g9-primary)`. */
+    readonly color?: string;
+    /** Box size in logical pixels. Default 20. */
+    readonly size?: number;
+    /** Ring thickness. Default `max(2, size / 10)`. */
+    readonly thickness?: number;
+    readonly className?: string;
+    readonly accessibilityLabel?: string;
+}
+/**
+ * A spinner: a ring with a transparent quarter rotating once per 800 ms (CSS keyframes, no JavaScript per frame).
+ * Not running → an empty box of the same size (so layouts do not jump).
+ */
+export declare function G9ActivityIndicator(props: G9ActivityIndicatorProps): ReactNode;
+//# sourceMappingURL=activity-indicator.d.ts.map

package/dist/display/activity-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-indicator.d.ts","sourceRoot":"","sources":["../../src/display/activity-indicator.tsx"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,oGAAoG;AACpG,MAAM,WAAW,wBAAwB;IACvC,wGAAwG;IACxG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,SAAS,CAqB9E"}

package/dist/display/activity-indicator.jsx

@@ -0,0 +1,22 @@
+import "./display.css";
+function G9ActivityIndicator(props) {
+    var _props_size, _props_thickness, _props_color;
+    const size = null != (_props_size = props.size) ? _props_size : 20;
+    const thickness = null != (_props_thickness = props.thickness) ? _props_thickness : Math.max(2, size / 10);
+    const running = true === props.running;
+    const color = null != (_props_color = props.color) ? _props_color : 'var(--g9-primary)';
+    return <view className={`g9-activity${running ? ' g9-activity--running' : ''}${props.className ? ` ${props.className}` : ''}`} style={{
+        width: `${size}px`,
+        height: `${size}px`,
+        borderRadius: `${size / 2}px`,
+        borderWidth: `${thickness}px`,
+        borderColor: running ? color : 'transparent',
+        borderTopColor: 'transparent'
+    }} {...props.accessibilityLabel ? {
+        'accessibility-element': true,
+        'accessibility-label': props.accessibilityLabel
+    } : {}}/>;
+}
+export { G9ActivityIndicator };
+
+//# sourceMappingURL=activity-indicator.jsx.map

package/dist/display/activity-indicator.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"display/activity-indicator.jsx","sources":["../../src/display/activity-indicator.tsx"],"sourcesContent":["import './display.css';\nimport type { ReactNode } from '@lynx-js/react';\n\n/** Props of {@link G9ActivityIndicator} (MAUI `G9ActivityIndicator` = MAUI `ActivityIndicator`). */\nexport interface G9ActivityIndicatorProps {\n  /** Spinning and visible (MAUI `IsRunning`). Default false: the box keeps its size but shows nothing. */\n  readonly running?: boolean;\n  /** Ring colour (MAUI `Color`). Default `var(--g9-primary)`. */\n  readonly color?: string;\n  /** Box size in logical pixels. Default 20. */\n  readonly size?: number;\n  /** Ring thickness. Default `max(2, size / 10)`. */\n  readonly thickness?: number;\n  readonly className?: string;\n  readonly accessibilityLabel?: string;\n}\n\n/**\n * A spinner: a ring with a transparent quarter rotating once per 800 ms (CSS keyframes, no JavaScript per frame).\n * Not running → an empty box of the same size (so layouts do not jump).\n */\nexport function G9ActivityIndicator(props: G9ActivityIndicatorProps): ReactNode {\n  const size = props.size ?? 20;\n  const thickness = props.thickness ?? Math.max(2, size / 10);\n  const running = props.running === true;\n  const color = props.color ?? 'var(--g9-primary)';\n  return (\n    <view\n      className={`g9-activity${running ? ' g9-activity--running' : ''}${props.className ? ` ${props.className}` : ''}`}\n      style={{\n        width: `${size}px`,\n        height: `${size}px`,\n        borderRadius: `${size / 2}px`,\n        borderWidth: `${thickness}px`,\n        borderColor: running ? color : 'transparent',\n        borderTopColor: 'transparent',\n      }}\n      {...(props.accessibilityLabel\n        ? { 'accessibility-element': true, 'accessibility-label': props.accessibilityLabel }\n        : {})}\n    />\n  );\n}\n"],"names":["G9ActivityIndicator","props","_props_size","_props_thickness","_props_color","size","thickness","Math","running","color","view"],"mappings":";AAqBO,SAASA,oBAAoBC,KAA+B;QACpDC,aACKC,kBAEJC;IAHd,MAAMC,OAAO,QAAAH,CAAAA,cAAAA,MAAM,IAAI,AAAD,IAATA,cAAc;IAC3B,MAAMI,YAAY,QAAAH,CAAAA,mBAAAA,MAAM,SAAS,AAAD,IAAdA,mBAAmBI,KAAK,GAAG,CAAC,GAAGF,OAAO;IACxD,MAAMG,UAAUP,AAAkB,SAAlBA,MAAM,OAAO;IAC7B,MAAMQ,QAAQ,QAAAL,CAAAA,eAAAA,MAAM,KAAK,AAAD,IAAVA,eAAe;IAC7B,QACGM,KACC,WAAW,CAAC,WAAW,EAAEF,UAAU,0BAA0B,KAAKP,MAAM,SAAS,GAAG,CAAC,CAAC,EAAEA,MAAM,SAAS,EAAE,GAAG,IAAI,EAChH,OAAO;QACL,OAAO,GAAGI,KAAK,EAAE,CAAC;QAClB,QAAQ,GAAGA,KAAK,EAAE,CAAC;QACnB,cAAc,GAAGA,OAAO,EAAE,EAAE,CAAC;QAC7B,aAAa,GAAGC,UAAU,EAAE,CAAC;QAC7B,aAAaE,UAAUC,QAAQ;QAC/B,gBAAgB;IAClB,IACC,GAAIR,MAAM,kBAAkB,GACzB;QAAE,yBAAyB;QAAM,uBAAuBA,MAAM,kBAAkB;IAAC,IACjF,CAAC,CAAC;AAGZ"}