@g9tm/lynxcontrols 0.0.0-stage → 1.4.2

package/dist/sheet/processing.jsx

@@ -0,0 +1,66 @@
+import { G9StringKey } from "@g9tm/lynxcontrols-foundation";
+import { useEffect, useRef, useState } from "@lynx-js/react";
+import { G9ActivityIndicator } from "../display/activity-indicator.jsx";
+import { useG9Executor, useG9Strings } from "../provider/hooks.jsx";
+import { useG9SheetContext } from "./frame.jsx";
+function G9ProcessingSheetContent(props) {
+    var _props_loadingHeight;
+    const sheet = useG9SheetContext();
+    const executor = useG9Executor();
+    const strings = useG9Strings();
+    const [built, setBuilt] = useState(null);
+    const started = useRef(false);
+    const latest = useRef(props);
+    latest.current = props;
+    useEffect(()=>{
+        var _ref;
+        var _props_handle;
+        if (started.current || !sheet) return;
+        started.current = true;
+        const handle = null != (_ref = null == (_props_handle = props.handle) ? void 0 : _props_handle.call(props)) ? _ref : sheet.handle;
+        const signal = sheet.signal;
+        const run = async ()=>{
+            try {
+                const node = await latest.current.build(handle, signal);
+                if (signal.aborted) return;
+                if (null == node) return void handle.close();
+                setBuilt({
+                    node
+                });
+            } catch (error) {
+                if (signal.aborted) return;
+                await executor.run(()=>{
+                    throw error;
+                }, {
+                    source: 'G9ProcessingSheet',
+                    showErrorPopup: false,
+                    enableThrottle: false,
+                    preventConcurrentExecution: false
+                });
+                const onError = latest.current.onError;
+                if (onError) {
+                    try {
+                        await onError(error, handle);
+                    } catch  {}
+                    return;
+                }
+                await executor.showOperationError(strings.get(G9StringKey.UnexpectedError), {
+                    title: strings.get(G9StringKey.Error)
+                });
+                handle.close();
+            }
+        };
+        run();
+    }, [
+        sheet
+    ]);
+    if (built) return <view className="g9-processing-sheet">{built.node}</view>;
+    return <view className="g9-processing-sheet__loading" style={{
+        height: `${null != (_props_loadingHeight = props.loadingHeight) ? _props_loadingHeight : 160}px`
+    }}>
+      <G9ActivityIndicator running size={42}/>
+    </view>;
+}
+export { G9ProcessingSheetContent };
+
+//# sourceMappingURL=processing.jsx.map

package/dist/sheet/processing.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/processing.jsx","sources":["../../src/sheet/processing.tsx"],"sourcesContent":["import { G9StringKey } from '@g9tm/lynxcontrols-foundation';\nimport { type ReactNode, useEffect, useRef, useState } from '@lynx-js/react';\nimport { G9ActivityIndicator } from '../display/activity-indicator';\nimport { useG9Executor, useG9Strings } from '../provider/hooks';\nimport { useG9SheetContext } from './frame';\nimport type { G9SheetHandle } from './stack';\n\n/** Builds the body of a processing sheet: the node, or `null` to close quietly. Called once, after opening. */\nexport type G9ProcessingBuild = (\n  handle: G9SheetHandle,\n  signal: import('@g9tm/lynxcontrols-foundation').G9AbortSignal,\n) => Promise<ReactNode | null> | ReactNode | null;\n/** Handles a build failure (the sheet stays open unless it closes it). */\nexport type G9ProcessingErrorHandler = (error: unknown, handle: G9SheetHandle) => unknown;\n\n/** Props of {@link G9ProcessingSheetContent}. */\nexport interface G9ProcessingSheetContentProps {\n  readonly build: G9ProcessingBuild;\n  readonly onError?: G9ProcessingErrorHandler;\n  /** Spinner box height. Default 160. */\n  readonly loadingHeight?: number;\n  /** The sheet handle (for content created before the handle existed). Default the enclosing sheet's. */\n  readonly handle?: () => G9SheetHandle | null;\n}\n\n/**\n * The body of a processing sheet (MAUI `ProcessingSheetContentView`): a 42 px spinner in a `loadingHeight` box, then\n * the built body swapped in at once. A failure is always logged (no popup); then `onError` runs, or the error popup\n * shows and the sheet closes. `null` closes the sheet quietly. A close cancels the build (`signal`).\n */\nexport function G9ProcessingSheetContent(props: G9ProcessingSheetContentProps): ReactNode {\n  const sheet = useG9SheetContext();\n  const executor = useG9Executor();\n  const strings = useG9Strings();\n  const [built, setBuilt] = useState<{ node: ReactNode } | null>(null);\n  const started = useRef(false);\n  const latest = useRef(props);\n  latest.current = props;\n  useEffect(() => {\n    if (started.current || !sheet) return;\n    started.current = true;\n    const handle = props.handle?.() ?? sheet.handle;\n    const signal = sheet.signal;\n    const run = async () => {\n      try {\n        const node = await latest.current.build(handle, signal);\n        if (signal.aborted) return;\n        if (node === null || node === undefined) {\n          handle.close();\n          return;\n        }\n        setBuilt({ node });\n      } catch (error) {\n        if (signal.aborted) return;\n        await executor.run(\n          () => {\n            throw error;\n          },\n          {\n            source: 'G9ProcessingSheet',\n            showErrorPopup: false,\n            enableThrottle: false,\n            preventConcurrentExecution: false,\n          },\n        );\n        const onError = latest.current.onError;\n        if (onError) {\n          try {\n            await onError(error, handle);\n          } catch {\n            // A failing error handler must not take the sheet down.\n          }\n          return;\n        }\n        await executor.showOperationError(strings.get(G9StringKey.UnexpectedError), {\n          title: strings.get(G9StringKey.Error),\n        });\n        handle.close();\n      }\n    };\n    void run();\n  }, [sheet]);\n  if (built) return <view className=\"g9-processing-sheet\">{built.node}</view>;\n  return (\n    <view className=\"g9-processing-sheet__loading\" style={{ height: `${props.loadingHeight ?? 160}px` }}>\n      <G9ActivityIndicator running size={42} />\n    </view>\n  );\n}\n"],"names":["G9ProcessingSheetContent","props","_props_loadingHeight","sheet","useG9SheetContext","executor","useG9Executor","strings","useG9Strings","built","setBuilt","useState","started","useRef","latest","useEffect","handle","signal","run","node","error","onError","G9StringKey","view","G9ActivityIndicator"],"mappings":";;;;;AA8BO,SAASA,yBAAyBC,KAAoC;QAsDNC;IArDrE,MAAMC,QAAQC;IACd,MAAMC,WAAWC;IACjB,MAAMC,UAAUC;IAChB,MAAM,CAACC,OAAOC,SAAS,GAAGC,SAAqC;IAC/D,MAAMC,UAAUC,OAAO;IACvB,MAAMC,SAASD,OAAOZ;IACtBa,OAAO,OAAO,GAAGb;IACjBc,UAAU;;YAGOd;QAFf,IAAIW,QAAQ,OAAO,IAAI,CAACT,OAAO;QAC/BS,QAAQ,OAAO,GAAG;QAClB,MAAMI,SAAS,QAATA,CAAAA,OAAAA,QAASf,CAAAA,gBAAAA,MAAM,MAAM,AAAD,IAAXA,KAAAA,IAAAA,cAAAA,IAAAA,CAAAA,MAAK,IAALA,OAAoBE,MAAM,MAAM;QAC/C,MAAMc,SAASd,MAAM,MAAM;QAC3B,MAAMe,MAAM;YACV,IAAI;gBACF,MAAMC,OAAO,MAAML,OAAO,OAAO,CAAC,KAAK,CAACE,QAAQC;gBAChD,IAAIA,OAAO,OAAO,EAAE;gBACpB,IAAIE,QAAAA,MAAqC,YACvCH,OAAO,KAAK;gBAGdN,SAAS;oBAAES;gBAAK;YAClB,EAAE,OAAOC,OAAO;gBACd,IAAIH,OAAO,OAAO,EAAE;gBACpB,MAAMZ,SAAS,GAAG,CAChB;oBACE,MAAMe;gBACR,GACA;oBACE,QAAQ;oBACR,gBAAgB;oBAChB,gBAAgB;oBAChB,4BAA4B;gBAC9B;gBAEF,MAAMC,UAAUP,OAAO,OAAO,CAAC,OAAO;gBACtC,IAAIO,SAAS;oBACX,IAAI;wBACF,MAAMA,QAAQD,OAAOJ;oBACvB,EAAE,OAAM,CAER;oBACA;gBACF;gBACA,MAAMX,SAAS,kBAAkB,CAACE,QAAQ,GAAG,CAACe,YAAY,eAAe,GAAG;oBAC1E,OAAOf,QAAQ,GAAG,CAACe,YAAY,KAAK;gBACtC;gBACAN,OAAO,KAAK;YACd;QACF;QACKE;IACP,GAAG;QAACf;KAAM;IACV,IAAIM,OAAO,QAAQc,KAAK,UAAU,uBAAuBd,MAAM,IAAI,GAAGc;IACtE,QACGA,KAAK,UAAU,+BAA+B,OAAO;QAAE,QAAQ,GAAG,QAAArB,CAAAA,uBAAAA,MAAM,aAAa,AAAD,IAAlBA,uBAAuB,IAAI,EAAE,CAAC;IAAC,GAAG;MACnG,CAACsB,oBAAoB,QAAQ,MAAM,KAAM;IAC3C,EAAED;AAEN"}

package/dist/sheet/service.d.ts

@@ -0,0 +1,55 @@
+import { type G9HostHandle } from '../host/registry.js';
+import { type G9SheetHeightMemo, type G9SheetMemoPreferences } from './height-memo.js';
+import { type G9SheetOptions, type G9SheetSettings } from './options.js';
+import { type G9ProcessingBuild, type G9ProcessingErrorHandler } from './processing.js';
+import { type G9SheetContent, type G9SheetHandle, G9SheetStack } from './stack.js';
+/** The sheet API of one host (MAUI `G9BottomSheetHelper` + `G9BottomSheetExtensions`). */
+export interface G9SheetService {
+    /**
+     * Opens a sheet (MAUI `ShowG9BottomSheet`): auto-stacks over an open sheet, hands off with `replaceCurrentSheet`,
+     * otherwise opens as primary. `content` may be a factory, built after the open motion (`deferContent`). Returns the
+     * sheet-scoped handle, or `null` when throttled (a second show/replace within 369 ms).
+     */
+    show(content: G9SheetContent, options?: G9SheetOptions): G9SheetHandle | null;
+    /** `show` as a promise (MAUI `ShowG9BottomSheetAsync`): resolves with the handle (or `null`). */
+    showAsync(content: G9SheetContent, options?: G9SheetOptions): Promise<G9SheetHandle | null>;
+    /** Replaces the open sheet in place when it can morph, else back-closes it and opens (MAUI `ReplaceG9BottomSheet`). */
+    replace(content: G9SheetContent, options?: G9SheetOptions): G9SheetHandle | null;
+    /**
+     * Opens at once with a spinner, then builds the body (MAUI `ShowProcessingG9BottomSheet`): `build(handle, signal)`
+     * returns the body (the sheet grows to fit), `null` (closes quietly) or throws (`onError`, else error popup + close).
+     * Default options: fit to content, not deferred.
+     */
+    showProcessing(build: G9ProcessingBuild, options?: G9SheetOptions, onError?: G9ProcessingErrorHandler, loadingHeight?: number): G9SheetHandle | null;
+    /** Full-screen modal sheet, not throttled (MAUI `ShowFullScreenAsync`). */
+    showFullScreen(content: G9SheetContent, options?: G9SheetOptions): G9SheetHandle;
+    /** Back-routes the top sheet (MAUI `CloseTopG9BottomSheet`). */
+    closeTop(): void;
+    /** Closes every sheet (MAUI `CloseG9BottomSheet`). */
+    closeAll(): void;
+    /** Open sheets (MAUI `GetOpenSheetCount`). */
+    getOpenCount(): number;
+    /** Routes hardware back to the top sheet; `false` when none is open (MAUI `HandleHardwareBackPressed`). */
+    handleHardwareBack(): boolean;
+    /** `true` while a hand-off successor is replacing this sheet (MAUI `IsBeingReplaced`). */
+    isBeingReplaced(handle: G9SheetHandle | null | undefined): boolean;
+    /** The scrim colour behind receded pages (MAUI `GetBackdropCardColor`). */
+    getBackdropCardColor(): string;
+    /** The height memory of this host's sheets. */
+    readonly heightMemo: G9SheetHeightMemo;
+    /** The stack (advanced: rendering, tests). */
+    readonly stack: G9SheetStack;
+}
+/** The sheet service of a host, created on first use. */
+export declare function sheetServiceOf(host: G9HostHandle, settings?: Required<G9SheetSettings>, preferences?: G9SheetMemoPreferences): G9SheetService;
+/**
+ * The sheets of the nearest `G9Host` (MAUI `G9BottomSheetHelper` for that page). Sheets render in the host's
+ * `sheets` layer; hardware back closes the top sheet first; the host's unmount settles every open sheet.
+ */
+export declare function useG9Sheets(): G9SheetService;
+/**
+ * The sheets of the active host for code outside components (MAUI's static `G9BottomSheetHelper`): view models,
+ * services. Throws `host-missing` when no host is mounted.
+ */
+export declare function g9Sheets(): G9SheetService;
+//# sourceMappingURL=service.d.ts.map

package/dist/sheet/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/sheet/service.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAW,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EAAyB,KAAK,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC3G,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,eAAe,EAErB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,wBAAwB,EAA4B,MAAM,cAAc,CAAC;AAE/G,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEhF,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,IAAI,CAAC;IAC9E,iGAAiG;IACjG,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC5F,uHAAuH;IACvH,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,IAAI,CAAC;IACjF;;;;OAIG;IACH,cAAc,CACZ,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,wBAAwB,EAClC,aAAa,CAAC,EAAE,MAAM,GACrB,aAAa,GAAG,IAAI,CAAC;IACxB,2EAA2E;IAC3E,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC;IACjF,gEAAgE;IAChE,QAAQ,IAAI,IAAI,CAAC;IACjB,sDAAsD;IACtD,QAAQ,IAAI,IAAI,CAAC;IACjB,8CAA8C;IAC9C,YAAY,IAAI,MAAM,CAAC;IACvB,2GAA2G;IAC3G,kBAAkB,IAAI,OAAO,CAAC;IAC9B,0FAA0F;IAC1F,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACnE,2EAA2E;IAC3E,oBAAoB,IAAI,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AA+ID,yDAAyD;AACzD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,EACpC,WAAW,CAAC,EAAE,sBAAsB,GACnC,cAAc,CAIhB;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAI5C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAEzC"}

package/dist/sheet/service.jsx

@@ -0,0 +1,143 @@
+import { useEffect, useRef, useState, useSyncExternalStore } from "@lynx-js/react";
+import { startTimer, stopTimer } from "../base/timers.jsx";
+import { useG9Host, useG9HostInsets } from "../host/hooks.jsx";
+import { g9Hosts } from "../host/registry.jsx";
+import { useG9Culture, useG9Preferences, useG9Settings, useG9Theme, useG9Window } from "../provider/hooks.jsx";
+import { G9SheetFrame } from "./frame.jsx";
+import { createSheetHeightMemo } from "./height-memo.jsx";
+import { fitToContentSheetOptions, fullScreenModalSheetOptions, resolveSheetSettings } from "./options.jsx";
+import { G9ProcessingSheetContent } from "./processing.jsx";
+import { backdropCardTransform, sheetVisibleRatio } from "./sizing.jsx";
+import { G9SheetStack } from "./stack.jsx";
+const FEATURE = 'g9.sheets';
+function StackView(props) {
+    var _primary_options_backdropCardEffectThreshold;
+    const { state } = props;
+    state.settings = useG9Settings().sheets;
+    const win = useG9Window();
+    const insets = useG9HostInsets();
+    const culture = useG9Culture();
+    const stack = state.service.stack;
+    const entries = useSyncExternalStore((l)=>stack.subscribe(l), ()=>stack.getSnapshot());
+    const host = useG9Host();
+    const [rest, setRest] = useState(null);
+    const primary = entries.find((e)=>'opening' === e.status || 'open' === e.status);
+    const card = state.settings.enableBackdropCardEffect && void 0 !== primary && false !== primary.options.enableBackdropCardEffect && 'fitToContent' !== primary.options.sizeMode && backdropCardTransform(sheetVisibleRatio(primary.options, win.height, (null == rest ? void 0 : rest.id) === primary.id ? rest.heightPx : null), Math.min(0.99, Math.max(0.1, null != (_primary_options_backdropCardEffectThreshold = primary.options.backdropCardEffectThreshold) ? _primary_options_backdropCardEffectThreshold : 0.75)));
+    const effectOn = card && card.scale < 1 ? card : null;
+    const effect = effectOn ? {
+        scale: Math.round(1000 * effectOn.scale) / 1000,
+        translateY: Math.round(10 * effectOn.translateY) / 10,
+        durationMs: state.settings.openAnimationDurationMs,
+        backdropColor: state.settings.backdropCardColor
+    } : null;
+    const effectKey = effect ? `${effect.scale}|${effect.translateY}|${effect.durationMs}|${effect.backdropColor}` : '';
+    useEffect(()=>{
+        host.setContentEffect(effect);
+    }, [
+        effectKey
+    ]);
+    useEffect(()=>()=>stack.dispose(), [
+        stack
+    ]);
+    const scheme = useG9Theme().scheme;
+    const lastScheme = useRef(scheme);
+    useEffect(()=>{
+        if (lastScheme.current === scheme) return;
+        lastScheme.current = scheme;
+        state.service.heightMemo.invalidate();
+    }, [
+        scheme
+    ]);
+    const top = [
+        ...entries
+    ].reverse().find((e)=>'opening' === e.status || 'open' === e.status);
+    return <view className="g9-sheet-stack">
+      {entries.map((entry)=><G9SheetFrame key={entry.frameKey} entry={entry} stack={stack} hostHeight={win.height} hostWidth={win.width} topInset={insets.top} bottomInset={insets.bottom} settings={state.settings} memo={state.service.heightMemo} culture={culture.locale} isTop={entry === top} onRest={(heightPx)=>setRest({
+                id: entry.id,
+                heightPx
+            })}/>)}
+    </view>;
+}
+function createSheetService(host, settings, preferences) {
+    const clock = host.services.clock;
+    const state = {
+        settings: null != settings ? settings : resolveSheetSettings(void 0)
+    };
+    const stack = new G9SheetStack({
+        now: ()=>clock.monotonicNow(),
+        setTimer: (cb, ms)=>startTimer(cb, ms),
+        clearTimer: (h)=>stopTimer(h),
+        durations: (o)=>{
+            var _o_openAnimationDurationMs, _o_closeAnimationDurationMs;
+            return {
+                open: null != (_o_openAnimationDurationMs = o.openAnimationDurationMs) ? _o_openAnimationDurationMs : state.settings.openAnimationDurationMs,
+                close: null != (_o_closeAnimationDurationMs = o.closeAnimationDurationMs) ? _o_closeAnimationDurationMs : state.settings.closeAnimationDurationMs
+            };
+        },
+        stageBeforeShow: ()=>state.settings.stageBeforeShow,
+        preOpenMaxHoldMs: ()=>state.settings.preOpenMaxHoldMs
+    });
+    const heightMemo = createSheetHeightMemo({
+        ...preferences ? {
+            preferences
+        } : {},
+        appVersion: state.settings.heightMemoVersion,
+        setTimer: (cb, ms)=>startTimer(cb, ms),
+        clearTimer: (h)=>stopTimer(h)
+    });
+    const service = {
+        stack,
+        heightMemo,
+        show: (content, options)=>stack.show(content, null != options ? options : {}),
+        showAsync: (content, options)=>Promise.resolve(stack.show(content, null != options ? options : {})),
+        replace: (content, options)=>stack.replace(content, null != options ? options : fitToContentSheetOptions()),
+        showProcessing (build, options, onError, loadingHeight) {
+            let handle = null;
+            const content = ()=><G9ProcessingSheetContent build={build} {...onError ? {
+                    onError
+                } : {}} loadingHeight={loadingHeight && loadingHeight > 0 ? loadingHeight : 160} handle={()=>handle}/>;
+            handle = stack.show(content, {
+                ...null != options ? options : fitToContentSheetOptions(),
+                deferContent: false
+            });
+            return handle;
+        },
+        showFullScreen: (content, options)=>stack.show(content, null != options ? options : fullScreenModalSheetOptions(), false),
+        closeTop: ()=>stack.closeTop(),
+        closeAll: ()=>stack.closeAll(),
+        getOpenCount: ()=>stack.openCount(),
+        handleHardwareBack: ()=>stack.handleHardwareBack(),
+        isBeingReplaced: (handle)=>{
+            if (!handle) return false;
+            const entry = stack.getSnapshot().find((e)=>e.id === handle.id);
+            return (null == entry ? void 0 : entry.handingOff) === true;
+        },
+        getBackdropCardColor: ()=>state.settings.backdropCardColor
+    };
+    state.service = service;
+    host.attachFeature(FEATURE, state);
+    host.registerLayerItem('sheets', {
+        key: FEATURE,
+        element: <StackView state={state}/>,
+        order: 0
+    });
+    host.back.push(()=>stack.handleHardwareBack() ? 'handled' : 'pass', {
+        layer: 'sheets'
+    });
+    return state;
+}
+function sheetServiceOf(host, settings, preferences) {
+    const existing = host.getFeature(FEATURE);
+    if (existing && settings) existing.settings = settings;
+    return (null != existing ? existing : createSheetService(host, settings, preferences)).service;
+}
+function useG9Sheets() {
+    const settings = useG9Settings().sheets;
+    return sheetServiceOf(useG9Host(), settings, useG9Preferences());
+}
+function g9Sheets() {
+    return sheetServiceOf(g9Hosts.require());
+}
+export { g9Sheets, sheetServiceOf, useG9Sheets };
+
+//# sourceMappingURL=service.jsx.map

package/dist/sheet/service.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/service.jsx","sources":["../../src/sheet/service.tsx"],"sourcesContent":["import { type ReactNode, useEffect, useRef, useState, useSyncExternalStore } from '@lynx-js/react';\nimport { startTimer, stopTimer } from '../base/timers';\nimport { useG9Host, useG9HostInsets } from '../host/hooks';\nimport { type G9HostHandle, g9Hosts } from '../host/registry';\nimport { useG9Culture, useG9Preferences, useG9Settings, useG9Theme, useG9Window } from '../provider/hooks';\nimport { G9SheetFrame } from './frame';\nimport { createSheetHeightMemo, type G9SheetHeightMemo, type G9SheetMemoPreferences } from './height-memo';\nimport {\n  fitToContentSheetOptions,\n  fullScreenModalSheetOptions,\n  type G9SheetOptions,\n  type G9SheetSettings,\n  resolveSheetSettings,\n} from './options';\nimport { type G9ProcessingBuild, type G9ProcessingErrorHandler, G9ProcessingSheetContent } from './processing';\nimport { backdropCardTransform, sheetVisibleRatio } from './sizing';\nimport { type G9SheetContent, type G9SheetHandle, G9SheetStack } from './stack';\n\n/** The sheet API of one host (MAUI `G9BottomSheetHelper` + `G9BottomSheetExtensions`). */\nexport interface G9SheetService {\n  /**\n   * Opens a sheet (MAUI `ShowG9BottomSheet`): auto-stacks over an open sheet, hands off with `replaceCurrentSheet`,\n   * otherwise opens as primary. `content` may be a factory, built after the open motion (`deferContent`). Returns the\n   * sheet-scoped handle, or `null` when throttled (a second show/replace within 369 ms).\n   */\n  show(content: G9SheetContent, options?: G9SheetOptions): G9SheetHandle | null;\n  /** `show` as a promise (MAUI `ShowG9BottomSheetAsync`): resolves with the handle (or `null`). */\n  showAsync(content: G9SheetContent, options?: G9SheetOptions): Promise<G9SheetHandle | null>;\n  /** Replaces the open sheet in place when it can morph, else back-closes it and opens (MAUI `ReplaceG9BottomSheet`). */\n  replace(content: G9SheetContent, options?: G9SheetOptions): G9SheetHandle | null;\n  /**\n   * Opens at once with a spinner, then builds the body (MAUI `ShowProcessingG9BottomSheet`): `build(handle, signal)`\n   * returns the body (the sheet grows to fit), `null` (closes quietly) or throws (`onError`, else error popup + close).\n   * Default options: fit to content, not deferred.\n   */\n  showProcessing(\n    build: G9ProcessingBuild,\n    options?: G9SheetOptions,\n    onError?: G9ProcessingErrorHandler,\n    loadingHeight?: number,\n  ): G9SheetHandle | null;\n  /** Full-screen modal sheet, not throttled (MAUI `ShowFullScreenAsync`). */\n  showFullScreen(content: G9SheetContent, options?: G9SheetOptions): G9SheetHandle;\n  /** Back-routes the top sheet (MAUI `CloseTopG9BottomSheet`). */\n  closeTop(): void;\n  /** Closes every sheet (MAUI `CloseG9BottomSheet`). */\n  closeAll(): void;\n  /** Open sheets (MAUI `GetOpenSheetCount`). */\n  getOpenCount(): number;\n  /** Routes hardware back to the top sheet; `false` when none is open (MAUI `HandleHardwareBackPressed`). */\n  handleHardwareBack(): boolean;\n  /** `true` while a hand-off successor is replacing this sheet (MAUI `IsBeingReplaced`). */\n  isBeingReplaced(handle: G9SheetHandle | null | undefined): boolean;\n  /** The scrim colour behind receded pages (MAUI `GetBackdropCardColor`). */\n  getBackdropCardColor(): string;\n  /** The height memory of this host's sheets. */\n  readonly heightMemo: G9SheetHeightMemo;\n  /** The stack (advanced: rendering, tests). */\n  readonly stack: G9SheetStack;\n}\n\nconst FEATURE = 'g9.sheets';\n\ninterface ServiceState {\n  readonly service: G9SheetService;\n  settings: Required<G9SheetSettings>;\n}\n\nfunction StackView(props: { readonly state: ServiceState }): ReactNode {\n  const { state } = props;\n  state.settings = useG9Settings().sheets;\n  const win = useG9Window();\n  const insets = useG9HostInsets();\n  const culture = useG9Culture();\n  const stack = state.service.stack;\n  const entries = useSyncExternalStore(\n    (l) => stack.subscribe(l),\n    () => stack.getSnapshot(),\n  );\n  const host = useG9Host();\n  // Backdrop card: the page recedes behind a tall primary sheet (not fit, not stacked over) once its visible ratio\n  // reaches `backdropCardEffectThreshold` (default 0.75): the opening detent first, then where the sheet came to rest.\n  const [rest, setRest] = useState<{ readonly id: number; readonly heightPx: number } | null>(null);\n  const primary = entries.find((e) => e.status === 'opening' || e.status === 'open');\n  const card =\n    state.settings.enableBackdropCardEffect &&\n    primary !== undefined &&\n    primary.options.enableBackdropCardEffect !== false &&\n    primary.options.sizeMode !== 'fitToContent' &&\n    backdropCardTransform(\n      sheetVisibleRatio(primary.options, win.height, rest?.id === primary.id ? rest.heightPx : null),\n      Math.min(0.99, Math.max(0.1, primary.options.backdropCardEffectThreshold ?? 0.75)),\n    );\n  const effectOn = card && card.scale < 1 ? card : null;\n  const effect = effectOn\n    ? {\n        scale: Math.round(effectOn.scale * 1000) / 1000,\n        translateY: Math.round(effectOn.translateY * 10) / 10,\n        durationMs: state.settings.openAnimationDurationMs,\n        backdropColor: state.settings.backdropCardColor,\n      }\n    : null;\n  const effectKey = effect ? `${effect.scale}|${effect.translateY}|${effect.durationMs}|${effect.backdropColor}` : '';\n  useEffect(() => {\n    host.setContentEffect(effect);\n  }, [effectKey]);\n  useEffect(() => () => stack.dispose(), [stack]);\n  // Learned heights belong to one look: a theme change re-measures (viewport and culture are part of the key).\n  const scheme = useG9Theme().scheme;\n  const lastScheme = useRef(scheme);\n  useEffect(() => {\n    if (lastScheme.current === scheme) return;\n    lastScheme.current = scheme;\n    state.service.heightMemo.invalidate();\n  }, [scheme]);\n  const top = [...entries].reverse().find((e) => e.status === 'opening' || e.status === 'open');\n  return (\n    <view className=\"g9-sheet-stack\">\n      {entries.map((entry) => (\n        <G9SheetFrame\n          key={entry.frameKey}\n          entry={entry}\n          stack={stack}\n          hostHeight={win.height}\n          hostWidth={win.width}\n          topInset={insets.top}\n          bottomInset={insets.bottom}\n          settings={state.settings}\n          memo={state.service.heightMemo}\n          culture={culture.locale}\n          isTop={entry === top}\n          onRest={(heightPx) => setRest({ id: entry.id, heightPx })}\n        />\n      ))}\n    </view>\n  );\n}\n\n/** Creates the sheet service of a host (attached once as a host feature). */\nfunction createSheetService(\n  host: G9HostHandle,\n  settings?: Required<G9SheetSettings>,\n  preferences?: G9SheetMemoPreferences,\n): ServiceState {\n  const clock = host.services.clock;\n  const state = { settings: settings ?? resolveSheetSettings(undefined) } as ServiceState;\n  const stack = new G9SheetStack({\n    now: () => clock.monotonicNow(),\n    setTimer: (cb, ms) => startTimer(cb, ms),\n    clearTimer: (h) => stopTimer(h),\n    durations: (o) => ({\n      open: o.openAnimationDurationMs ?? state.settings.openAnimationDurationMs,\n      close: o.closeAnimationDurationMs ?? state.settings.closeAnimationDurationMs,\n    }),\n    stageBeforeShow: () => state.settings.stageBeforeShow,\n    preOpenMaxHoldMs: () => state.settings.preOpenMaxHoldMs,\n  });\n  const heightMemo = createSheetHeightMemo({\n    ...(preferences ? { preferences } : {}),\n    appVersion: state.settings.heightMemoVersion,\n    setTimer: (cb, ms) => startTimer(cb, ms),\n    clearTimer: (h) => stopTimer(h),\n  });\n  const service: G9SheetService = {\n    stack,\n    heightMemo,\n    show: (content, options) => stack.show(content, options ?? {}),\n    showAsync: (content, options) => Promise.resolve(stack.show(content, options ?? {})),\n    replace: (content, options) => stack.replace(content, options ?? fitToContentSheetOptions()),\n    showProcessing(build, options, onError, loadingHeight) {\n      let handle: G9SheetHandle | null = null;\n      const content = () => (\n        <G9ProcessingSheetContent\n          build={build}\n          {...(onError ? { onError } : {})}\n          loadingHeight={loadingHeight && loadingHeight > 0 ? loadingHeight : 160}\n          handle={() => handle}\n        />\n      );\n      handle = stack.show(content, { ...(options ?? fitToContentSheetOptions()), deferContent: false });\n      return handle;\n    },\n    showFullScreen: (content, options) =>\n      stack.show(content, options ?? fullScreenModalSheetOptions(), false) as G9SheetHandle,\n    closeTop: () => stack.closeTop(),\n    closeAll: () => stack.closeAll(),\n    getOpenCount: () => stack.openCount(),\n    handleHardwareBack: () => stack.handleHardwareBack(),\n    isBeingReplaced: (handle) => {\n      if (!handle) return false;\n      const entry = stack.getSnapshot().find((e) => e.id === handle.id);\n      return entry?.handingOff === true;\n    },\n    getBackdropCardColor: () => state.settings.backdropCardColor,\n  };\n  (state as { service: G9SheetService }).service = service;\n  host.attachFeature(FEATURE, state);\n  host.registerLayerItem('sheets', { key: FEATURE, element: <StackView state={state} />, order: 0 });\n  host.back.push(() => (stack.handleHardwareBack() ? 'handled' : 'pass'), { layer: 'sheets' });\n  return state;\n}\n\n/** The sheet service of a host, created on first use. */\nexport function sheetServiceOf(\n  host: G9HostHandle,\n  settings?: Required<G9SheetSettings>,\n  preferences?: G9SheetMemoPreferences,\n): G9SheetService {\n  const existing = host.getFeature(FEATURE) as ServiceState | undefined;\n  if (existing && settings) existing.settings = settings;\n  return (existing ?? createSheetService(host, settings, preferences)).service;\n}\n\n/**\n * The sheets of the nearest `G9Host` (MAUI `G9BottomSheetHelper` for that page). Sheets render in the host's\n * `sheets` layer; hardware back closes the top sheet first; the host's unmount settles every open sheet.\n */\nexport function useG9Sheets(): G9SheetService {\n  const settings = useG9Settings().sheets;\n  // Learned heights persist in the provider's preferences (key `g9controls.sheet-heights`).\n  return sheetServiceOf(useG9Host(), settings, useG9Preferences());\n}\n\n/**\n * The sheets of the active host for code outside components (MAUI's static `G9BottomSheetHelper`): view models,\n * services. Throws `host-missing` when no host is mounted.\n */\nexport function g9Sheets(): G9SheetService {\n  return sheetServiceOf(g9Hosts.require());\n}\n"],"names":["FEATURE","StackView","props","_primary_options_backdropCardEffectThreshold","state","useG9Settings","win","useG9Window","insets","useG9HostInsets","culture","useG9Culture","stack","entries","useSyncExternalStore","l","host","useG9Host","rest","setRest","useState","primary","e","card","undefined","backdropCardTransform","sheetVisibleRatio","Math","effectOn","effect","effectKey","useEffect","scheme","useG9Theme","lastScheme","useRef","top","view","entry","G9SheetFrame","heightPx","createSheetService","settings","preferences","clock","resolveSheetSettings","G9SheetStack","cb","ms","startTimer","h","stopTimer","o","_o_openAnimationDurationMs","_o_closeAnimationDurationMs","heightMemo","createSheetHeightMemo","service","content","options","Promise","fitToContentSheetOptions","build","onError","loadingHeight","handle","G9ProcessingSheetContent","fullScreenModalSheetOptions","sheetServiceOf","existing","useG9Sheets","useG9Preferences","g9Sheets","g9Hosts"],"mappings":"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"}

package/dist/sheet/sheet.css

@@ -0,0 +1,246 @@
+.g9-sheet-stack {
+  pointer-events: none;
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  right: 0;
+}
+
+.g9-sheet__view {
+  top: 0;
+  bottom: 0;
+  left: 0;
+  right: 0;
+}
+
+.g9-sheet__view--passthrough {
+  pointer-events: none;
+}
+
+.g9-sheet__view--passthrough .g9-sheet {
+  pointer-events: auto;
+}
+
+.g9-sheet {
+  pointer-events: auto;
+  flex-direction: column;
+  display: flex;
+  overflow: hidden;
+}
+
+.g9-sheet__frame {
+  flex-direction: column;
+  flex-grow: 1;
+  flex-shrink: 0;
+  display: flex;
+  position: relative;
+  overflow: visible;
+}
+
+.g9-sheet__surface {
+  flex-direction: column;
+  flex-grow: 1;
+  flex-shrink: 0;
+  display: flex;
+  overflow: hidden;
+}
+
+.g9-sheet__skirt {
+  height: 50vh;
+  position: absolute;
+  top: 100%;
+  left: 0;
+  right: 0;
+}
+
+.g9-sheet__scrim {
+  pointer-events: auto;
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  right: 0;
+}
+
+.g9-sheet__scrim--covered {
+  pointer-events: none;
+}
+
+.g9-sheet__grabber-area {
+  justify-content: center;
+  align-items: center;
+  height: 30px;
+  display: flex;
+}
+
+.g9-sheet__grabber {
+  background-color: var(--g9-outline-variant);
+  border-radius: 12px;
+  width: 32px;
+  height: 4px;
+}
+
+.g9-sheet__body {
+  flex-shrink: 1;
+}
+
+.g9-sheet__body--fill {
+  flex: 1;
+}
+
+.g9-sheet__content {
+  flex-direction: column;
+  display: flex;
+  position: relative;
+}
+
+.g9-sheet__body--static {
+  flex-direction: column;
+  flex: 1 1 0;
+  display: flex;
+  overflow: hidden;
+}
+
+.g9-sheet__content--fill {
+  flex: 1 1 0;
+}
+
+.g9-sheet__placeholder {
+  justify-content: center;
+  align-items: center;
+  display: flex;
+  position: relative;
+}
+
+.g9-sheet__cover {
+  background-color: var(--g9-surface-container);
+  animation: .22s ease-out forwards g9-sheet-cover-out;
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+}
+
+@keyframes g9-sheet-cover-out {
+  from {
+    opacity: 1;
+  }
+
+  to {
+    opacity: 0;
+  }
+}
+
+.g9-sheet-reveal {
+  animation: .14s ease-out g9-sheet-reveal-in;
+}
+
+@keyframes g9-sheet-reveal-in {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+
+.g9-sheet-loading, .g9-processing-sheet__loading {
+  justify-content: center;
+  align-items: center;
+  display: flex;
+  position: relative;
+}
+
+.g9-sheet-header {
+  border-bottom: 1px solid #79747e59;
+  flex-direction: row;
+  align-items: center;
+  padding: 10px 16px;
+  display: flex;
+}
+
+.g9-sheet-header__side {
+  flex-direction: row;
+  flex: 1;
+  align-items: center;
+  display: flex;
+}
+
+.g9-sheet-header__start {
+  flex-direction: row;
+  align-items: center;
+  display: flex;
+}
+
+.g9-sheet-header__end {
+  flex-direction: row;
+  justify-content: flex-end;
+  align-items: center;
+  display: flex;
+}
+
+.g9-sheet-header__side.g9-sheet-header__end {
+  justify-content: flex-end;
+}
+
+.g9-sheet-header__grow {
+  flex-direction: row;
+  flex: 1;
+  align-items: center;
+  display: flex;
+}
+
+.g9-sheet-header__title-near {
+  padding: 0 8px;
+}
+
+.g9-sheet-header__back {
+  justify-content: flex-start;
+  align-items: center;
+  display: flex;
+}
+
+.g9-sheet-header__title {
+  color: var(--g9-secondary);
+  text-overflow: ellipsis;
+  font-weight: bold;
+}
+
+.g9-sheet-header__items {
+  flex-direction: row;
+  column-gap: 8px;
+  display: flex;
+}
+
+.g9-sheet__footer-slot {
+  flex-direction: column;
+  flex-shrink: 0;
+  display: flex;
+}
+
+.g9-sheet-footer {
+  border-top-style: solid;
+  border-top-width: 1px;
+  border-top-color: var(--g9-outline-variant);
+  flex-direction: column;
+  row-gap: 8px;
+  padding: 12px 16px;
+  display: flex;
+}
+
+.g9-sheet-footer__row {
+  flex-direction: row;
+  column-gap: 8px;
+  display: flex;
+}
+
+.g9-sheet-footer__cell {
+  flex-direction: column;
+  flex: 1;
+  display: flex;
+}
+
+
+/*# sourceMappingURL=sheet.css.map */

package/dist/sheet/sheet.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["webpack://./src/sheet/sheet.css"],"names":[],"mappings":"AACA;EAAE,oBAAoB;EACpB,kBAAkB;EAClB,MAAM;EACN,SAAS;EACT,OAAO;EACP,QAAQ;AACV;;AAIA;EADE,MAAM;EACN,SAAS;EACT,OAAO;EACP,QAAQ;AACV;;AAKA;EAFE,oBAAoB;AACtB;;AAKA;EAFE,oBAAoB;AACtB;;AAKA;EAFE,oBAAoB;EACpB,sBAAsB;EACtB,aAAa;EACb,gBAAgB;AAClB;;AAMA;EAHE,sBAAsB;EACtB,YAAY;EACZ,cAAc;EACd,aAAa;EACb,kBAAkB;EAClB,iBAAiB;AACnB;;AAMA;EAHE,sBAAsB;EACtB,YAAY;EACZ,cAAc;EACd,aAAa;EACb,gBAAgB;AAClB;;AAOA;EAJE,YAAY;EACZ,kBAAkB;EAClB,SAAS;EACT,OAAO;EACP,QAAQ;AACV;;AAOA;EAJE,oBAAoB;EACpB,kBAAkB;EAClB,MAAM;EACN,SAAS;EACT,OAAO;EACP,QAAQ;AACV;;AAOA;EAJE,oBAAoB;AACtB;;AAOA;EAJE,uBAAuB;EACvB,mBAAmB;EACnB,YAAY;EACZ,aAAa;AACf;;AAOA;EAJE,2CAA2C;EAC3C,mBAAmB;EACnB,WAAW;EACX,WAAW;AACb;;AAOA;EAJE,cAAc;AAChB;;AAOA;EAJE,OAAO;AACT;;AAOA;EAJE,sBAAsB;EACtB,aAAa;EACb,kBAAkB;AACpB;;AAQA;EALE,sBAAsB;EACtB,WAAW;EACX,aAAa;EACb,gBAAgB;AAClB;;AAUA;EAPE,WAAW;AACb;;AAYA;EATE,uBAAuB;EACvB,mBAAmB;EACnB,aAAa;EACb,kBAAkB;AACpB;;AAYA;EATE,6CAA6C;EAC7C,oDAAoD;EACpD,kBAAkB;EAClB,MAAM;EACN,OAAO;EACP,QAAQ;AACV;;AAYA;EATE;IACE,UAAU;EACZ;;EAEA;IACE,UAAU;EACZ;AACF;;AAWA;EARE,2CAA2C;AAC7C;;AAWA;EARE;IACE,UAAU;EACZ;;EAEA;IACE,UAAU;EACZ;AACF;;AAUA;EAPE,uBAAuB;EACvB,mBAAmB;EACnB,aAAa;EACb,kBAAkB;AACpB;;AAWA;EARE,kCAAkC;EAClC,mBAAmB;EACnB,mBAAmB;EACnB,kBAAkB;EAClB,aAAa;AACf;;AAaA;EAVE,mBAAmB;EACnB,OAAO;EACP,mBAAmB;EACnB,aAAa;AACf;;AAaA;EAVE,mBAAmB;EACnB,mBAAmB;EACnB,aAAa;AACf;;AAaA;EAVE,mBAAmB;EACnB,yBAAyB;EACzB,mBAAmB;EACnB,aAAa;AACf;;AAaA;EAVE,yBAAyB;AAC3B;;AAaA;EAVE,mBAAmB;EACnB,OAAO;EACP,mBAAmB;EACnB,aAAa;AACf;;AAaA;EAVE,cAAc;AAChB;;AAaA;EAVE,2BAA2B;EAC3B,mBAAmB;EACnB,aAAa;AACf;;AAaA;EAVE,0BAA0B;EAC1B,uBAAuB;EACvB,iBAAiB;AACnB;;AAaA;EAVE,mBAAmB;EACnB,eAAe;EACf,aAAa;AACf;;AAcA;EAXE,sBAAsB;EACtB,cAAc;EACd,aAAa;AACf;;AAcA;EAXE,uBAAuB;EACvB,qBAAqB;EACrB,2CAA2C;EAC3C,sBAAsB;EACtB,YAAY;EACZ,kBAAkB;EAClB,aAAa;AACf;;AAcA;EAXE,mBAAmB;EACnB,eAAe;EACf,aAAa;AACf;;AAgBA;EAbE,sBAAsB;EACtB,OAAO;EACP,aAAa;AACf","sourcesContent":["/* G9 sheets on lynx-ui Sheet (MAUI G9SheetView / header template). No shadows. */\n.g9-sheet-stack {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  pointer-events: none;\n}\n\n/* lynx-ui SheetView (position: fixed): the whole viewport, so the sheet rises from the bottom edge. */\n.g9-sheet__view {\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n}\n\n/* A non-modal sheet's view lets every touch it does not cover through to the page, native views included. */\n.g9-sheet__view--passthrough {\n  pointer-events: none;\n}\n\n.g9-sheet__view--passthrough .g9-sheet {\n  pointer-events: auto;\n}\n\n.g9-sheet {\n  display: flex;\n  flex-direction: column;\n  overflow: hidden;\n  pointer-events: auto;\n}\n\n/* G9's own views inside lynx-ui's SheetContent (whose style a worklet owns): the frame recedes, the surface paints. */\n.g9-sheet__frame {\n  display: flex;\n  flex-direction: column;\n  flex-grow: 1;\n  flex-shrink: 0;\n  position: relative;\n  overflow: visible;\n}\n\n.g9-sheet__surface {\n  display: flex;\n  flex-direction: column;\n  flex-grow: 1;\n  flex-shrink: 0;\n  overflow: hidden;\n}\n\n/* Paints below the surface for a drag past the top detent; outside the layout, so fit heights ignore it. */\n.g9-sheet__skirt {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  right: 0;\n  height: 50vh;\n}\n\n.g9-sheet__scrim {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  pointer-events: auto;\n}\n\n.g9-sheet__scrim--covered {\n  pointer-events: none;\n}\n\n.g9-sheet__grabber-area {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  height: 30px;\n}\n\n.g9-sheet__grabber {\n  width: 32px;\n  height: 4px;\n  border-radius: 12px;\n  background-color: var(--g9-outline-variant);\n}\n\n.g9-sheet__body {\n  flex-shrink: 1;\n}\n\n.g9-sheet__body--fill {\n  flex: 1;\n}\n\n.g9-sheet__content {\n  display: flex;\n  flex-direction: column;\n  position: relative;\n}\n\n/* scrollBody: false — the content scrolls itself and fills the body (longhands: a definite basis for its children). */\n.g9-sheet__body--static {\n  display: flex;\n  flex-direction: column;\n  flex-grow: 1;\n  flex-shrink: 1;\n  flex-basis: 0px;\n  overflow: hidden;\n}\n\n.g9-sheet__content--fill {\n  flex-grow: 1;\n  flex-shrink: 1;\n  flex-basis: 0px;\n}\n\n.g9-sheet__placeholder {\n  position: relative;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n}\n\n.g9-sheet__cover {\n  position: absolute;\n  top: 0;\n  left: 0;\n  right: 0;\n  background-color: var(--g9-surface-container);\n  animation: g9-sheet-cover-out 220ms ease-out forwards;\n}\n\n@keyframes g9-sheet-cover-out {\n  from {\n    opacity: 1;\n  }\n  to {\n    opacity: 0;\n  }\n}\n\n.g9-sheet-reveal {\n  animation: g9-sheet-reveal-in 140ms ease-out;\n}\n\n@keyframes g9-sheet-reveal-in {\n  from {\n    opacity: 0;\n  }\n  to {\n    opacity: 1;\n  }\n}\n\n.g9-sheet-loading,\n.g9-processing-sheet__loading {\n  position: relative;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n}\n\n.g9-sheet-header {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  padding: 10px 16px;\n  border-bottom-width: 1px;\n  border-bottom-style: solid;\n  border-bottom-color: rgba(121, 116, 126, 0.35);\n}\n\n.g9-sheet-header__side {\n  display: flex;\n  flex-direction: row;\n  flex: 1;\n  align-items: center;\n}\n\n.g9-sheet-header__start {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n}\n\n.g9-sheet-header__end {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  justify-content: flex-end;\n}\n\n.g9-sheet-header__side.g9-sheet-header__end {\n  justify-content: flex-end;\n}\n\n.g9-sheet-header__grow {\n  display: flex;\n  flex-direction: row;\n  flex: 1;\n  align-items: center;\n}\n\n.g9-sheet-header__title-near {\n  padding: 0px 8px;\n}\n\n.g9-sheet-header__back {\n  display: flex;\n  align-items: center;\n  justify-content: flex-start;\n}\n\n.g9-sheet-header__title {\n  font-weight: bold;\n  color: var(--g9-secondary);\n  text-overflow: ellipsis;\n}\n\n.g9-sheet-header__items {\n  display: flex;\n  flex-direction: row;\n  column-gap: 8px;\n}\n\n/* Holds the footer (or nothing) so its height is measured with the body's for a fit sheet. */\n.g9-sheet__footer-slot {\n  display: flex;\n  flex-direction: column;\n  flex-shrink: 0;\n}\n\n.g9-sheet-footer {\n  display: flex;\n  flex-direction: column;\n  row-gap: 8px;\n  padding: 12px 16px;\n  border-top-width: 1px;\n  border-top-style: solid;\n  border-top-color: var(--g9-outline-variant);\n}\n\n.g9-sheet-footer__row {\n  display: flex;\n  flex-direction: row;\n  column-gap: 8px;\n}\n\n/* A column: whatever a cell holds (a button, a wrapper around one) stretches to the cell's width, as MAUI's footer\n   buttons fill their cell. */\n.g9-sheet-footer__cell {\n  display: flex;\n  flex-direction: column;\n  flex: 1;\n}\n"],"sourceRoot":""}

package/dist/sheet/sheet.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from '@lynx-js/react';
+import type { G9SheetOptions } from './options.js';
+import type { G9SheetCloseReason } from './stack.js';
+/** Props of {@link G9Sheet}. */
+export interface G9SheetProps {
+    /** Controlled visibility. */
+    readonly open: boolean;
+    /** Told `false` once with the reason when the sheet closes by itself (back, overlay tap, drag, toolbar). */
+    readonly onOpenChange?: (open: boolean, reason: G9SheetCloseReason) => void;
+    readonly options?: G9SheetOptions;
+    readonly children?: ReactNode;
+}
+/**
+ * Declarative sheet (the `G9Sheet` adapter): mounts the children as a sheet of the nearest host while `open`, keeps
+ * them live (re-renders update the sheet in place), and reports closes the sheet made itself through
+ * `onOpenChange(false, reason)`. Use `useG9Sheets()` for the imperative MAUI API.
+ */
+export declare function G9Sheet(props: G9SheetProps): ReactNode;
+//# sourceMappingURL=sheet.d.ts.map

package/dist/sheet/sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../src/sheet/sheet.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,SAAS,CAAC;AAEjE,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,4GAA4G;IAC5G,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAgCtD"}

package/dist/sheet/sheet.jsx

@@ -0,0 +1,40 @@
+import { useEffect, useRef } from "@lynx-js/react";
+import { useG9Sheets } from "./service.jsx";
+function G9Sheet(props) {
+    const sheets = useG9Sheets();
+    const handle = useRef(null);
+    const latest = useRef(props);
+    latest.current = props;
+    useEffect(()=>{
+        if (props.open && !handle.current) {
+            var _props_children, _props_options;
+            const h = sheets.stack.show(null != (_props_children = props.children) ? _props_children : null, null != (_props_options = props.options) ? _props_options : {}, false);
+            handle.current = h;
+            null == h || h.result.then((result)=>{
+                var _latest_current_onOpenChange, _latest_current;
+                if (handle.current !== h) return;
+                handle.current = null;
+                if ('closed' !== result.reason && 'unmount' !== result.reason) null == (_latest_current_onOpenChange = (_latest_current = latest.current).onOpenChange) || _latest_current_onOpenChange.call(_latest_current, false, result.reason);
+            });
+        } else if (!props.open && handle.current) {
+            const h = handle.current;
+            handle.current = null;
+            h.close();
+        }
+    }, [
+        props.open
+    ]);
+    useEffect(()=>{
+        var _props_children;
+        if (handle.current) sheets.stack.update(handle.current.id, null != (_props_children = props.children) ? _props_children : null, props.options);
+    });
+    useEffect(()=>()=>{
+            var _handle_current;
+            null == (_handle_current = handle.current) || _handle_current.close();
+            handle.current = null;
+        }, []);
+    return null;
+}
+export { G9Sheet };
+
+//# sourceMappingURL=sheet.jsx.map

package/dist/sheet/sheet.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/sheet.jsx","sources":["../../src/sheet/sheet.tsx"],"sourcesContent":["import { type ReactNode, useEffect, useRef } from '@lynx-js/react';\nimport type { G9SheetOptions } from './options';\nimport { useG9Sheets } from './service';\nimport type { G9SheetCloseReason, G9SheetHandle } from './stack';\n\n/** Props of {@link G9Sheet}. */\nexport interface G9SheetProps {\n  /** Controlled visibility. */\n  readonly open: boolean;\n  /** Told `false` once with the reason when the sheet closes by itself (back, overlay tap, drag, toolbar). */\n  readonly onOpenChange?: (open: boolean, reason: G9SheetCloseReason) => void;\n  readonly options?: G9SheetOptions;\n  readonly children?: ReactNode;\n}\n\n/**\n * Declarative sheet (the `G9Sheet` adapter): mounts the children as a sheet of the nearest host while `open`, keeps\n * them live (re-renders update the sheet in place), and reports closes the sheet made itself through\n * `onOpenChange(false, reason)`. Use `useG9Sheets()` for the imperative MAUI API.\n */\nexport function G9Sheet(props: G9SheetProps): ReactNode {\n  const sheets = useG9Sheets();\n  const handle = useRef<G9SheetHandle | null>(null);\n  const latest = useRef(props);\n  latest.current = props;\n  useEffect(() => {\n    if (props.open && !handle.current) {\n      const h = sheets.stack.show(props.children ?? null, props.options ?? {}, false);\n      handle.current = h;\n      void h?.result.then((result) => {\n        if (handle.current !== h) return;\n        handle.current = null;\n        if (result.reason !== 'closed' && result.reason !== 'unmount')\n          latest.current.onOpenChange?.(false, result.reason);\n      });\n    } else if (!props.open && handle.current) {\n      const h = handle.current;\n      handle.current = null;\n      h.close();\n    }\n  }, [props.open]);\n  useEffect(() => {\n    if (handle.current) sheets.stack.update(handle.current.id, props.children ?? null, props.options);\n  });\n  useEffect(\n    () => () => {\n      handle.current?.close();\n      handle.current = null;\n    },\n    [],\n  );\n  return null;\n}\n"],"names":["G9Sheet","props","sheets","useG9Sheets","handle","useRef","latest","useEffect","_props_children","_props_options","h","result","_latest_current","_handle_current"],"mappings":";;AAoBO,SAASA,QAAQC,KAAmB;IACzC,MAAMC,SAASC;IACf,MAAMC,SAASC,OAA6B;IAC5C,MAAMC,SAASD,OAAOJ;IACtBK,OAAO,OAAO,GAAGL;IACjBM,UAAU;QACR,IAAIN,MAAM,IAAI,IAAI,CAACG,OAAO,OAAO,EAAE;gBACLI,iBAAwBC;YAApD,MAAMC,IAAIR,OAAO,KAAK,CAAC,IAAI,CAAC,QAAAM,CAAAA,kBAAAA,MAAM,QAAQ,AAAD,IAAbA,kBAAkB,MAAM,QAAAC,CAAAA,iBAAAA,MAAM,OAAO,AAAD,IAAZA,iBAAiB,CAAC,GAAG;YACzEL,OAAO,OAAO,GAAGM;YACZA,QAAAA,KAAAA,EAAG,MAAM,CAAC,IAAI,CAAC,CAACC;oBAIjBC,8BAAAA;gBAHF,IAAIR,OAAO,OAAO,KAAKM,GAAG;gBAC1BN,OAAO,OAAO,GAAG;gBACjB,IAAIO,AAAkB,aAAlBA,OAAO,MAAM,IAAiBA,AAAkB,cAAlBA,OAAO,MAAM,EAAK,QAClDC,CAAAA,+BAAAA,AAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,EAAE,YAAY,AAAD,KAA1BA,6BAAAA,IAAAA,CAAAA,iBAA8B,OAAOD,OAAO,MAAM;YACtD;QACF,OAAO,IAAI,CAACV,MAAM,IAAI,IAAIG,OAAO,OAAO,EAAE;YACxC,MAAMM,IAAIN,OAAO,OAAO;YACxBA,OAAO,OAAO,GAAG;YACjBM,EAAE,KAAK;QACT;IACF,GAAG;QAACT,MAAM,IAAI;KAAC;IACfM,UAAU;YACmDC;QAA3D,IAAIJ,OAAO,OAAO,EAAEF,OAAO,KAAK,CAAC,MAAM,CAACE,OAAO,OAAO,CAAC,EAAE,EAAE,QAAAI,CAAAA,kBAAAA,MAAM,QAAQ,AAAD,IAAbA,kBAAkB,MAAMP,MAAM,OAAO;IAClG;IACAM,UACE,IAAM;gBACJM;oBAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,KAAbA,gBAAgB,KAAK;YACrBT,OAAO,OAAO,GAAG;QACnB,GACA,EAAE;IAEJ,OAAO;AACT"}