@g9tm/lynxcontrols 0.0.0-stage → 1.4.0

package/dist/sheet/height-memo.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/height-memo.jsx","sources":["../../src/sheet/height-memo.ts"],"sourcesContent":["// MAUI `G9BottomSheetHeightSeeds` + `G9BottomSheetHeightMemoStore`: first-open body heights for deferred sheets.\n// Keys are `{identity}|w{width}|{culture}|fs{fontScale}`, so a viewport, language or font-size change misses and\n// re-measures; `invalidate()` clears the learned heights (theme or font change).\n\n/** Most learned heights kept (MAUI 64). */\nexport const g9SheetHeightMemoLimit = 64;\n/** Preference key of the persisted memo. */\nexport const g9SheetHeightMemoPreferenceKey = 'sheet-heights';\n\n/** The memo key of a sheet body. */\nexport function sheetHeightMemoKey(identity: string, width: number, culture: string, fontScale: number): string {\n  return `${identity}|w${Math.round(width)}|${culture}|fs${fontScale}`;\n}\n\n/** Compiled-in first-open heights (MAUI `G9BottomSheetHeightSeeds`); never persisted. */\nexport interface G9SheetHeightSeeds {\n  /** Sets (or replaces) the seed of a memo key or bare identity; blank keys and heights ≤ 0 are ignored. */\n  seed(key: string, bodyHeight: number): void;\n  /** Exact key first, then the identity alone (the last three `|` segments stripped). */\n  tryGet(key: string): number | undefined;\n  reset(): void;\n}\n\n/** Creates a seed table. */\nexport function createSheetHeightSeeds(): G9SheetHeightSeeds {\n  const seeds = new Map<string, number>();\n  return {\n    seed(key, bodyHeight) {\n      if (!key || key.trim() === '' || !(bodyHeight > 0)) return;\n      seeds.set(key, bodyHeight);\n    },\n    tryGet(key) {\n      const exact = seeds.get(key);\n      if (exact !== undefined) return exact;\n      const parts = key.split('|');\n      if (parts.length < 4) return undefined;\n      return seeds.get(parts.slice(0, parts.length - 3).join('|'));\n    },\n    reset() {\n      seeds.clear();\n    },\n  };\n}\n\n/** The learned heights (MAUI `G9BottomSheetHeightMemoStore`). */\nexport interface G9SheetHeightMemo {\n  /** Learned height, else the seed. */\n  lookup(key: string): number | undefined;\n  /** Records a real body measurement; ≤ 0 is ignored, a change < 0.5 is skipped; the oldest key is evicted at 64. */\n  record(key: string, bodyHeight: number): void;\n  /** Forgets every learned height (theme/font change). */\n  invalidate(): void;\n  readonly size: number;\n  /** Writes the memo to preferences now. */\n  flush(): void;\n}\n\n/** The synchronous preference reads/writes the memo needs (`useG9Preferences()` provides them). */\nexport interface G9SheetMemoPreferences {\n  getString(key: string, defaultValue?: string | null): string | null;\n  setString(key: string, value: string): unknown;\n}\n\n/** Options of {@link createSheetHeightMemo}. */\nexport interface G9SheetHeightMemoOptions {\n  readonly seeds?: G9SheetHeightSeeds;\n  /** Persists under {@link g9SheetHeightMemoPreferenceKey}; a different `appVersion` discards the stored memo. */\n  readonly preferences?: G9SheetMemoPreferences;\n  readonly appVersion?: string;\n  /** Debounced flush (ms). Default 3000. */\n  readonly flushDelayMs?: number;\n  readonly setTimer?: (callback: () => void, ms: number) => unknown;\n  readonly clearTimer?: (handle: unknown) => void;\n}\n\n/** Creates a height memo (lazy load from preferences on first use, debounced flush). */\nexport function createSheetHeightMemo(options: G9SheetHeightMemoOptions = {}): G9SheetHeightMemo {\n  const entries = new Map<string, number>();\n  const header = `v1\\t${options.appVersion ?? '0'}`;\n  let loaded = false;\n  let timer: unknown = null;\n  const prefs = options.preferences;\n  const load = () => {\n    if (loaded) return;\n    loaded = true;\n    if (!prefs) return;\n    const blob = prefs.getString(g9SheetHeightMemoPreferenceKey, '') ?? '';\n    const lines = blob.split('\\n');\n    if (lines[0] !== header) return;\n    for (const line of lines.slice(1)) {\n      const tab = line.lastIndexOf('\\t');\n      if (tab <= 0) continue;\n      const height = Number(line.slice(tab + 1));\n      if (height > 0) entries.set(line.slice(0, tab), height);\n    }\n  };\n  const flush = () => {\n    if (timer !== null) options.clearTimer?.(timer);\n    timer = null;\n    if (!prefs) return;\n    const body = [...entries].map(([k, h]) => `${k}\\t${Math.round(h * 10) / 10}`);\n    prefs.setString(g9SheetHeightMemoPreferenceKey, [header, ...body].join('\\n'));\n  };\n  const schedule = () => {\n    if (!prefs || !options.setTimer) return;\n    if (timer !== null) options.clearTimer?.(timer);\n    timer = options.setTimer(flush, options.flushDelayMs ?? 3000);\n  };\n  return {\n    lookup(key) {\n      load();\n      return entries.get(key) ?? options.seeds?.tryGet(key);\n    },\n    record(key, bodyHeight) {\n      load();\n      if (!(bodyHeight > 0)) return;\n      const old = entries.get(key);\n      if (old !== undefined && Math.abs(old - bodyHeight) < 0.5) return;\n      if (old === undefined && entries.size >= g9SheetHeightMemoLimit) {\n        const first = entries.keys().next().value as string;\n        entries.delete(first);\n      }\n      entries.set(key, bodyHeight);\n      schedule();\n    },\n    invalidate() {\n      load();\n      entries.clear();\n      schedule();\n    },\n    get size() {\n      load();\n      return entries.size;\n    },\n    flush,\n  };\n}\n"],"names":["g9SheetHeightMemoLimit","g9SheetHeightMemoPreferenceKey","sheetHeightMemoKey","identity","width","culture","fontScale","Math","createSheetHeightSeeds","seeds","Map","key","bodyHeight","exact","undefined","parts","createSheetHeightMemo","options","_options_appVersion","entries","header","loaded","timer","prefs","load","_prefs_getString","blob","lines","line","tab","height","Number","flush","body","k","h","schedule","_options_flushDelayMs","_entries_get","_options_seeds","old","first"],"mappings":"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"}

package/dist/sheet/index.d.ts

@@ -0,0 +1,11 @@
+export { type G9SheetContextValue, G9SheetFrame, type G9SheetFrameProps, useG9SheetContext } from './frame.js';
+export { footerRows, G9SheetFooter, type G9SheetFooterProps, G9SheetHeader, type G9SheetHeaderProps, g9SheetHeaderMetrics, } from './header.js';
+export { createSheetHeightMemo, createSheetHeightSeeds, type G9SheetHeightMemo, type G9SheetHeightMemoOptions, type G9SheetHeightSeeds, type G9SheetMemoPreferences, g9SheetHeightMemoLimit, g9SheetHeightMemoPreferenceKey, sheetHeightMemoKey, } from './height-memo.js';
+export { G9LoadableSheetContent, type G9LoadableSheetContentProps } from './loadable.js';
+export { defaultSheetOptions, fitToContentSheetOptions, fullScreenEdgeToEdgeModalSheetOptions, fullScreenModalSheetOptions, fullScreenWithoutHandleSheetOptions, type G9SheetBackAction, type G9SheetBackSource, type G9SheetContentWidthMode, type G9SheetDetent, type G9SheetHeaderTitlePlacement, type G9SheetLifecycle, type G9SheetOptions, type G9SheetSettings, type G9SheetSizeMode, type G9SheetToolbarItem, resolveSheetSettings, } from './options.js';
+export { type G9ProcessingBuild, type G9ProcessingErrorHandler, G9ProcessingSheetContent, type G9ProcessingSheetContentProps, } from './processing.js';
+export { type G9SheetService, g9Sheets, sheetServiceOf, useG9Sheets } from './service.js';
+export { G9Sheet, type G9SheetProps } from './sheet.js';
+export { backdropCardTransform, clampFitHeight, currentPlatform, type G9SheetLayout, g9SheetDefaultPeekHeight, g9SheetDragCloseThreshold, g9SheetFitLoadingMinHeight, g9SheetFitMinHeight, g9SheetTopSafeAreaBaseGap, parentRecedeOffset, platformSheetConstraints, resolveSheetLayout, scaledSheetDuration, sheetOverlayOpacity, sheetTopPadding, } from './sizing.js';
+export { type G9SheetCloseReason, type G9SheetContent, type G9SheetEntry, type G9SheetHandle, type G9SheetResult, G9SheetStack, type G9SheetStackConfig, type G9SheetStatus, g9SheetCloseGraceMs, g9SheetShowThrottleMs, } from './stack.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sheet/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,mBAAmB,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5G,OAAO,EACL,UAAU,EACV,aAAa,EACb,KAAK,kBAAkB,EACvB,aAAa,EACb,KAAK,kBAAkB,EACvB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,sBAAsB,EACtB,8BAA8B,EAC9B,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,sBAAsB,EAAE,KAAK,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,qCAAqC,EACrC,2BAA2B,EAC3B,mCAAmC,EACnC,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,KAAK,6BAA6B,GACnC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,KAAK,aAAa,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/dist/sheet/index.jsx

@@ -0,0 +1,10 @@
+export { G9SheetFrame, useG9SheetContext } from "./frame.jsx";
+export { G9SheetFooter, G9SheetHeader, footerRows, g9SheetHeaderMetrics } from "./header.jsx";
+export { createSheetHeightMemo, createSheetHeightSeeds, g9SheetHeightMemoLimit, g9SheetHeightMemoPreferenceKey, sheetHeightMemoKey } from "./height-memo.jsx";
+export { G9LoadableSheetContent } from "./loadable.jsx";
+export { defaultSheetOptions, fitToContentSheetOptions, fullScreenEdgeToEdgeModalSheetOptions, fullScreenModalSheetOptions, fullScreenWithoutHandleSheetOptions, resolveSheetSettings } from "./options.jsx";
+export { G9ProcessingSheetContent } from "./processing.jsx";
+export { g9Sheets, sheetServiceOf, useG9Sheets } from "./service.jsx";
+export { G9Sheet } from "./sheet.jsx";
+export { backdropCardTransform, clampFitHeight, currentPlatform, g9SheetDefaultPeekHeight, g9SheetDragCloseThreshold, g9SheetFitLoadingMinHeight, g9SheetFitMinHeight, g9SheetTopSafeAreaBaseGap, parentRecedeOffset, platformSheetConstraints, resolveSheetLayout, scaledSheetDuration, sheetOverlayOpacity, sheetTopPadding } from "./sizing.jsx";
+export { G9SheetStack, g9SheetCloseGraceMs, g9SheetShowThrottleMs } from "./stack.jsx";

package/dist/sheet/loadable.d.ts

@@ -0,0 +1,35 @@
+import { type ReactNode } from '@lynx-js/react';
+import { type G9BottomSheetLoadingSkeleton } from '../display/shimmer.js';
+/** Props of {@link G9LoadableSheetContent} (MAUI `LoadableSheetContentView<TData>`). */
+export interface G9LoadableSheetContentProps<TData> {
+    /** Loads the data once per open, after the open motion (open-then-fill); `signal` aborts on close. */
+    readonly load: (signal: import('@g9tm/lynxcontrols-foundation').G9AbortSignal) => Promise<TData | null | undefined>;
+    /** Renders the loaded data (MAUI `ApplyLoadedData`). Never called after the sheet closed. */
+    readonly children: (data: TData) => ReactNode;
+    /** The loader returned nothing (MAUI `OnLoadReturnedNull`). Default: nothing rendered. */
+    readonly renderEmpty?: () => ReactNode;
+    /** The loader threw (MAUI `OnLoadFailed`); the error is also logged. */
+    readonly onLoadFailed?: (error: unknown) => void;
+    /** What a failure shows. Default nothing. */
+    readonly renderError?: (error: unknown) => ReactNode;
+    /** Height of the loading state (fills the seeded height). Default 180. */
+    readonly loadingHeight?: number;
+    /** Skeleton instead of the spinner. Default `'none'`. */
+    readonly skeleton?: G9BottomSheetLoadingSkeleton;
+    /**
+     * Load while the sheet is still staged (MAUI `LoadWhileStaged`): start at once instead of after the open motion.
+     * For on-device data only. Default false.
+     */
+    readonly loadWhileStaged?: boolean;
+    /** Fade the body in over 140 ms once loaded (MAUI `RevealLoadedContentAsync`). Default true. */
+    readonly reveal?: boolean;
+    /** Told when loading starts/ends (MAUI `IsLoading`). */
+    readonly onLoadingChange?: (loading: boolean) => void;
+}
+/**
+ * Open-then-fill sheet body (MAUI `LoadableSheetContentView`): shows a loading state that fills the sheet's seeded
+ * height, loads once after the open motion (or at once with `loadWhileStaged`), cancels on close, and never applies
+ * results after the sheet closed. Outside a sheet it loads on mount.
+ */
+export declare function G9LoadableSheetContent<TData>(props: G9LoadableSheetContentProps<TData>): ReactNode;
+//# sourceMappingURL=loadable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadable.d.ts","sourceRoot":"","sources":["../../src/sheet/loadable.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,KAAK,4BAA4B,EAAmB,MAAM,oBAAoB,CAAC;AAIxF,wFAAwF;AACxF,MAAM,WAAW,2BAA2B,CAAC,KAAK;IAChD,sGAAsG;IACtG,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,+BAA+B,EAAE,aAAa,KAAK,OAAO,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACpH,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC;IAC9C,0FAA0F;IAC1F,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,SAAS,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC;IACrD,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,4BAA4B,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,SAAS,CA+ClG"}

package/dist/sheet/loadable.jsx

@@ -0,0 +1,65 @@
+import { createAbortController } from "@g9tm/lynxcontrols-foundation";
+import { useEffect, useRef, useState } from "@lynx-js/react";
+import { G9ActivityIndicator } from "../display/activity-indicator.jsx";
+import { G9SheetSkeleton } from "../display/shimmer.jsx";
+import { useG9Diagnostics } from "../provider/hooks.jsx";
+import { useG9SheetContext } from "./frame.jsx";
+function G9LoadableSheetContent(props) {
+    var _ref, _ref1, _props_loadingHeight;
+    var _props_renderEmpty, _props_renderError;
+    const sheet = useG9SheetContext();
+    const diagnostics = useG9Diagnostics();
+    const [state, setState] = useState({
+        s: 'loading'
+    });
+    const started = useRef(false);
+    const latest = useRef(props);
+    latest.current = props;
+    const ready = !sheet || sheet.opened || true === props.loadWhileStaged;
+    useEffect(()=>{
+        var _latest_current_onLoadingChange, _latest_current;
+        if (started.current || !ready) return;
+        started.current = true;
+        const signal = null == sheet ? void 0 : sheet.signal;
+        null == (_latest_current_onLoadingChange = (_latest_current = latest.current).onLoadingChange) || _latest_current_onLoadingChange.call(_latest_current, true);
+        latest.current.load(null != signal ? signal : createAbortController().signal).then((data)=>{
+            var _latest_current_onLoadingChange, _latest_current;
+            if (null == signal ? void 0 : signal.aborted) return;
+            setState(null == data ? {
+                s: 'empty'
+            } : {
+                s: 'loaded',
+                data
+            });
+            null == (_latest_current_onLoadingChange = (_latest_current = latest.current).onLoadingChange) || _latest_current_onLoadingChange.call(_latest_current, false);
+        }, (error)=>{
+            var _latest_current_onLoadFailed, _latest_current, _latest_current_onLoadingChange, _latest_current1;
+            if (null == signal ? void 0 : signal.aborted) return;
+            diagnostics.log({
+                level: 'error',
+                message: 'Sheet content failed to load.',
+                source: 'G9LoadableSheetContent',
+                error
+            });
+            null == (_latest_current_onLoadFailed = (_latest_current = latest.current).onLoadFailed) || _latest_current_onLoadFailed.call(_latest_current, error);
+            setState({
+                s: 'failed',
+                error
+            });
+            null == (_latest_current_onLoadingChange = (_latest_current1 = latest.current).onLoadingChange) || _latest_current_onLoadingChange.call(_latest_current1, false);
+        });
+    }, [
+        ready
+    ]);
+    if ('loaded' === state.s) return <view className={false === props.reveal ? '' : 'g9-sheet-reveal'}>{props.children(state.data)}</view>;
+    if ('empty' === state.s) return null != (_ref = null == (_props_renderEmpty = props.renderEmpty) ? void 0 : _props_renderEmpty.call(props)) ? _ref : null;
+    if ('failed' === state.s) return null != (_ref1 = null == (_props_renderError = props.renderError) ? void 0 : _props_renderError.call(props, state.error)) ? _ref1 : null;
+    return <view className="g9-sheet-loading" style={{
+        height: `${null != (_props_loadingHeight = props.loadingHeight) ? _props_loadingHeight : 180}px`
+    }}>
+      {props.skeleton && 'none' !== props.skeleton ? <G9SheetSkeleton skeleton={props.skeleton}/> : <G9ActivityIndicator running size={32}/>}
+    </view>;
+}
+export { G9LoadableSheetContent };
+
+//# sourceMappingURL=loadable.jsx.map

package/dist/sheet/loadable.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/loadable.jsx","sources":["../../src/sheet/loadable.tsx"],"sourcesContent":["import { createAbortController } from '@g9tm/lynxcontrols-foundation';\nimport { type ReactNode, useEffect, useRef, useState } from '@lynx-js/react';\nimport { G9ActivityIndicator } from '../display/activity-indicator';\nimport { type G9BottomSheetLoadingSkeleton, G9SheetSkeleton } from '../display/shimmer';\nimport { useG9Diagnostics } from '../provider/hooks';\nimport { useG9SheetContext } from './frame';\n\n/** Props of {@link G9LoadableSheetContent} (MAUI `LoadableSheetContentView<TData>`). */\nexport interface G9LoadableSheetContentProps<TData> {\n  /** Loads the data once per open, after the open motion (open-then-fill); `signal` aborts on close. */\n  readonly load: (signal: import('@g9tm/lynxcontrols-foundation').G9AbortSignal) => Promise<TData | null | undefined>;\n  /** Renders the loaded data (MAUI `ApplyLoadedData`). Never called after the sheet closed. */\n  readonly children: (data: TData) => ReactNode;\n  /** The loader returned nothing (MAUI `OnLoadReturnedNull`). Default: nothing rendered. */\n  readonly renderEmpty?: () => ReactNode;\n  /** The loader threw (MAUI `OnLoadFailed`); the error is also logged. */\n  readonly onLoadFailed?: (error: unknown) => void;\n  /** What a failure shows. Default nothing. */\n  readonly renderError?: (error: unknown) => ReactNode;\n  /** Height of the loading state (fills the seeded height). Default 180. */\n  readonly loadingHeight?: number;\n  /** Skeleton instead of the spinner. Default `'none'`. */\n  readonly skeleton?: G9BottomSheetLoadingSkeleton;\n  /**\n   * Load while the sheet is still staged (MAUI `LoadWhileStaged`): start at once instead of after the open motion.\n   * For on-device data only. Default false.\n   */\n  readonly loadWhileStaged?: boolean;\n  /** Fade the body in over 140 ms once loaded (MAUI `RevealLoadedContentAsync`). Default true. */\n  readonly reveal?: boolean;\n  /** Told when loading starts/ends (MAUI `IsLoading`). */\n  readonly onLoadingChange?: (loading: boolean) => void;\n}\n\ntype LoadState<T> = { s: 'loading' } | { s: 'loaded'; data: T } | { s: 'empty' } | { s: 'failed'; error: unknown };\n\n/**\n * Open-then-fill sheet body (MAUI `LoadableSheetContentView`): shows a loading state that fills the sheet's seeded\n * height, loads once after the open motion (or at once with `loadWhileStaged`), cancels on close, and never applies\n * results after the sheet closed. Outside a sheet it loads on mount.\n */\nexport function G9LoadableSheetContent<TData>(props: G9LoadableSheetContentProps<TData>): ReactNode {\n  const sheet = useG9SheetContext();\n  const diagnostics = useG9Diagnostics();\n  const [state, setState] = useState<LoadState<TData>>({ s: 'loading' });\n  const started = useRef(false);\n  const latest = useRef(props);\n  latest.current = props;\n  const ready = !sheet || sheet.opened || props.loadWhileStaged === true;\n  useEffect(() => {\n    if (started.current || !ready) return;\n    started.current = true;\n    const signal = sheet?.signal;\n    latest.current.onLoadingChange?.(true);\n    latest.current.load(signal ?? createAbortController().signal).then(\n      (data) => {\n        if (signal?.aborted) return;\n        setState(data === null || data === undefined ? { s: 'empty' } : { s: 'loaded', data });\n        latest.current.onLoadingChange?.(false);\n      },\n      (error) => {\n        if (signal?.aborted) return;\n        diagnostics.log({\n          level: 'error',\n          message: 'Sheet content failed to load.',\n          source: 'G9LoadableSheetContent',\n          error,\n        });\n        latest.current.onLoadFailed?.(error);\n        setState({ s: 'failed', error });\n        latest.current.onLoadingChange?.(false);\n      },\n    );\n  }, [ready]);\n  if (state.s === 'loaded') {\n    return <view className={props.reveal === false ? '' : 'g9-sheet-reveal'}>{props.children(state.data)}</view>;\n  }\n  if (state.s === 'empty') return props.renderEmpty?.() ?? null;\n  if (state.s === 'failed') return props.renderError?.(state.error) ?? null;\n  return (\n    <view className=\"g9-sheet-loading\" style={{ height: `${props.loadingHeight ?? 180}px` }}>\n      {props.skeleton && props.skeleton !== 'none' ? (\n        <G9SheetSkeleton skeleton={props.skeleton} />\n      ) : (\n        <G9ActivityIndicator running size={32} />\n      )}\n    </view>\n  );\n}\n"],"names":["G9LoadableSheetContent","props","_props_loadingHeight","sheet","useG9SheetContext","diagnostics","useG9Diagnostics","state","setState","useState","started","useRef","latest","ready","useEffect","_latest_current","signal","createAbortController","data","error","_latest_current1","view","G9SheetSkeleton","G9ActivityIndicator"],"mappings":";;;;;;AAyCO,SAASA,uBAA8BC,KAAyC;qBAuC5BC;QAHzBD,oBACCA;IApCjC,MAAME,QAAQC;IACd,MAAMC,cAAcC;IACpB,MAAM,CAACC,OAAOC,SAAS,GAAGC,SAA2B;QAAE,GAAG;IAAU;IACpE,MAAMC,UAAUC,OAAO;IACvB,MAAMC,SAASD,OAAOV;IACtBW,OAAO,OAAO,GAAGX;IACjB,MAAMY,QAAQ,CAACV,SAASA,MAAM,MAAM,IAAIF,AAA0B,SAA1BA,MAAM,eAAe;IAC7Da,UAAU;YAIRC,iCAAAA;QAHA,IAAIL,QAAQ,OAAO,IAAI,CAACG,OAAO;QAC/BH,QAAQ,OAAO,GAAG;QAClB,MAAMM,SAASb,QAAAA,QAAAA,KAAAA,IAAAA,MAAO,MAAM;gBAC5BY,CAAAA,kCAAAA,AAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,EAAE,eAAe,AAAD,KAA7BA,gCAAAA,IAAAA,CAAAA,iBAAiC;QACjCH,OAAO,OAAO,CAAC,IAAI,CAACI,QAAAA,SAAAA,SAAUC,wBAAwB,MAAM,EAAE,IAAI,CAChE,CAACC;gBAGCH,iCAAAA;YAFA,IAAIC,QAAAA,SAAAA,KAAAA,IAAAA,OAAQ,OAAO,EAAE;YACrBR,SAASU,QAAAA,OAAsC;gBAAE,GAAG;YAAQ,IAAI;gBAAE,GAAG;gBAAUA;YAAK;oBACpFH,CAAAA,kCAAAA,AAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,EAAE,eAAe,AAAD,KAA7BA,gCAAAA,IAAAA,CAAAA,iBAAiC;QACnC,GACA,CAACI;gBAQCJ,8BAAAA,iBAEAK,iCAAAA;YATA,IAAIJ,QAAAA,SAAAA,KAAAA,IAAAA,OAAQ,OAAO,EAAE;YACrBX,YAAY,GAAG,CAAC;gBACd,OAAO;gBACP,SAAS;gBACT,QAAQ;gBACRc;YACF;oBACAJ,CAAAA,+BAAAA,AAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,EAAE,YAAY,AAAD,KAA1BA,6BAAAA,IAAAA,CAAAA,iBAA8BI;YAC9BX,SAAS;gBAAE,GAAG;gBAAUW;YAAM;oBAC9BC,CAAAA,kCAAAA,AAAAA,CAAAA,mBAAAA,OAAO,OAAO,AAAD,EAAE,eAAe,AAAD,KAA7BA,gCAAAA,IAAAA,CAAAA,kBAAiC;QACnC;IAEJ,GAAG;QAACP;KAAM;IACV,IAAIN,AAAY,aAAZA,MAAM,CAAC,EACT,QAAQc,KAAK,WAAWpB,AAAiB,UAAjBA,MAAM,MAAM,GAAa,KAAK,oBAAoBA,MAAM,QAAQ,CAACM,MAAM,IAAI,IAAIc;IAEzG,IAAId,AAAY,YAAZA,MAAM,CAAC,EAAc,OAAO,QAAP,gBAAON,CAAAA,qBAAAA,MAAM,WAAW,AAAD,IAAhBA,KAAAA,IAAAA,mBAAAA,IAAAA,CAAAA,MAAK,IAALA,OAAyB;IACzD,IAAIM,AAAY,aAAZA,MAAM,CAAC,EAAe,OAAO,QAAP,iBAAON,CAAAA,qBAAAA,MAAM,WAAW,AAAD,IAAhBA,KAAAA,IAAAA,mBAAAA,IAAAA,CAAAA,OAAoBM,MAAM,KAAK,aAAK;IACrE,QACGc,KAAK,UAAU,mBAAmB,OAAO;QAAE,QAAQ,GAAG,QAAAnB,CAAAA,uBAAAA,MAAM,aAAa,AAAD,IAAlBA,uBAAuB,IAAI,EAAE,CAAC;IAAC,GAAG;MACvF,CAACD,MAAM,QAAQ,IAAIA,AAAmB,WAAnBA,MAAM,QAAQ,IAC9BqB,gBAAgB,UAAUrB,MAAM,QAAQ,OAExCsB,oBAAoB,QAAQ,MAAM,MACnC;IACJ,EAAEF;AAEN"}

package/dist/sheet/options.d.ts

@@ -0,0 +1,220 @@
+import type { ReactNode } from '@lynx-js/react';
+import type { G9BottomSheetLoadingSkeleton } from '../display/shimmer.js';
+import type { G9IconInput } from '../icon/icon.js';
+/** Detents (MAUI `G9BottomSheetState`): peek (collapsed height), medium (half), large (full). */
+export type G9SheetDetent = 'peek' | 'medium' | 'large';
+/** Detent sizing or fit-to-content (MAUI `G9BottomSheetSizeMode`). */
+export type G9SheetSizeMode = 'states' | 'fitToContent';
+/** Header title anchor (MAUI `G9BottomSheetHeaderTitlePlacement`). */
+export type G9SheetHeaderTitlePlacement = 'center' | 'nearBack';
+/** Where a back request came from (MAUI `G9BottomSheetBackRequestSource` + drag-to-close). */
+export type G9SheetBackSource = 'toolbarButton' | 'hardwareButton' | 'overlayTap' | 'drag';
+/** What `onBackRequested` decides (MAUI `G9BottomSheetBackAction`). */
+export type G9SheetBackAction = 'close' | 'doNothing';
+/** Content width (MAUI `G9SheetViewContentWidthMode`). */
+export type G9SheetContentWidthMode = 'full' | 'custom';
+/** A header toolbar action (MAUI `G9BottomSheetToolbarItem`). */
+export interface G9SheetToolbarItem {
+    /** Glyph/icon. */
+    readonly icon?: G9IconInput;
+    /** Text (when there is no icon). */
+    readonly text?: string;
+    /** The action (MAUI `AsyncAction`/`Command`); a returned promise keeps the item busy while `disableWhileBusy`. */
+    readonly onPress?: () => unknown;
+    readonly isBusy?: boolean;
+    /** Spinner while busy. Default false. */
+    readonly showBusyIndicator?: boolean;
+    readonly isActive?: boolean;
+    /** Dot while active. Default false. */
+    readonly showActiveBadge?: boolean;
+    /** Ignore presses while busy. Default true. */
+    readonly disableWhileBusy?: boolean;
+    /** Default true. */
+    readonly animatePress?: boolean;
+    /** 0 → 24. */
+    readonly iconSize?: number;
+    readonly accessibilityLabel?: string;
+    /** Stable key (default the index). */
+    readonly key?: string;
+}
+/** Lifecycle callbacks of one sheet (MAUI `Opening/Opened/Closing/ClosedCommand`). */
+export interface G9SheetLifecycle {
+    /** When the sheet starts opening. */
+    readonly onOpening?: () => void;
+    /** After the open motion (or its timer fallback). */
+    readonly onOpened?: () => void;
+    /** Once, when closing starts (not on an in-place replace). */
+    readonly onClosing?: () => void;
+    /** Once, at cleanup. */
+    readonly onClosed?: () => void;
+    /** The sheet came to rest at another detent (MAUI `G9SheetView.StateChanged`), with its height in px. */
+    readonly onStateChanged?: (detent: G9SheetDetent | 'fit', heightPx: number) => void;
+}
+/** Everything a sheet can be opened with (MAUI `G9BottomSheetOptions`; 77 properties + presets). */
+export interface G9SheetOptions extends G9SheetLifecycle {
+    /** Initial detent. Default `'medium'`. */
+    readonly currentState?: G9SheetDetent;
+    /** Allowed detents. Default `['medium', 'large']`. */
+    readonly states?: ReadonlyArray<G9SheetDetent>;
+    /** Default `'states'`. */
+    readonly sizeMode?: G9SheetSizeMode;
+    /** Dim scrim that blocks the page. Default true. */
+    readonly isModal?: boolean;
+    /** Overlay tap / drag may close. Default true. */
+    readonly isCancelable?: boolean;
+    /** Default true. */
+    readonly isDraggable?: boolean;
+    /** Grabber. Default true. */
+    readonly hasHandle?: boolean;
+    /** Peek height (dp). Default 100 (with `collapsedHeight`). */
+    readonly peekHeight?: number | null;
+    /** Alias of `peekHeight` (MAUI `CollapsedHeight`); wins when both are set. */
+    readonly collapsedHeight?: number | null;
+    /** Medium = host × ratio (0.1–0.9). Default 0.5. */
+    readonly halfExpandedRatio?: number | null;
+    /** Large = host × ratio (0.1–1). Default 1. */
+    readonly fullExpandedRatio?: number | null;
+    /** Cap of a fit sheet (0.2–1). Default 0.75. */
+    readonly maxFitToContentHeightRatio?: number;
+    /** The largest detent is sized to the content (states mode). Default false. */
+    readonly expandedFitsContent?: boolean;
+    /** A drag on a scroller expands the sheet first. Default true. */
+    readonly scrollingExpandsSheet?: boolean;
+    /** Height memory key (needed for factory content). */
+    readonly heightMemoKey?: string | null;
+    /** Body padding. Default 0. */
+    readonly padding?: number;
+    /** 10 px gap under the header hairline. Default true. */
+    readonly useStandardBodyTopGap?: boolean;
+    /** Top corners. Default 12. */
+    readonly cornerRadius?: number;
+    /** Body background. Default `var(--g9-surface-container)`. */
+    readonly backgroundColor?: string | null;
+    /** Scrim colour; its alpha replaces the maximum opacity. */
+    readonly windowBackgroundColor?: string | null;
+    /** Default `'full'`. */
+    readonly contentWidthMode?: G9SheetContentWidthMode;
+    /** Width in `'custom'` mode (MAUI `G9BottomSheetContentWidth`). */
+    readonly contentWidth?: number | null;
+    /** Full-screen sheets reserve the top inset. Default true. */
+    readonly useTopSafeAreaPadding?: boolean;
+    /** Default 0. */
+    readonly additionalTopSafeAreaPadding?: number;
+    /** Replaces the top padding (0 = flush). */
+    readonly topSafeAreaPaddingOverride?: number | null;
+    /** Grabber on full-screen toolbar sheets. Default true. */
+    readonly showFullScreenDragHandle?: boolean;
+    /** Page recede behind a tall primary sheet. Default true. */
+    readonly enableBackdropCardEffect?: boolean;
+    /** Visible ratio where the recede starts. Default 0.75. */
+    readonly backdropCardEffectThreshold?: number;
+    /** Per-sheet open duration (ms); default the settings value. */
+    readonly openAnimationDurationMs?: number | null;
+    readonly closeAnimationDurationMs?: number | null;
+    /** Factory content builds after the open motion (spinner/skeleton first). Default true. */
+    readonly deferContent?: boolean;
+    /** Delay before deferred content swaps in. Default 369. */
+    readonly loadDelayMs?: number;
+    /** The placeholder uses the full height. Default false. */
+    readonly useFullScreenLoadingPlaceholder?: boolean;
+    /** Known final body height for the placeholder. */
+    readonly deferredLoadingPlaceholderHeight?: number | null;
+    /** Covered crossfade reveal of deferred content. Default true. */
+    readonly fadeDeferredContentIn?: boolean;
+    /** Placeholder shape. Default `'none'` (spinner). */
+    readonly loadingSkeleton?: G9BottomSheetLoadingSkeleton;
+    /** 0 → the shape's default. */
+    readonly loadingSkeletonRowCount?: number;
+    /** The parent sinks and fades when this sheet stacks on it. Default true. */
+    readonly recedeParentOnStack?: boolean;
+    /** Hand-off: replaces the one open sheet once this one is ready. Default false. */
+    readonly replaceCurrentSheet?: boolean;
+    /** Three-slot header. Default false. */
+    readonly showToolbar?: boolean;
+    /** Leading back (or close) button. Default false. */
+    readonly showCloseButton?: boolean;
+    /** × instead of the back arrow. Default false. */
+    readonly useCloseIcon?: boolean;
+    readonly title?: string | null;
+    readonly toolbarItems?: ReadonlyArray<G9SheetToolbarItem> | null;
+    /** Items built from the content once it exists. */
+    readonly toolbarItemsFactory?: (() => ReadonlyArray<G9SheetToolbarItem>) | null;
+    /** Default `'center'`. */
+    readonly headerTitlePlacement?: G9SheetHeaderTitlePlacement;
+    /** Star/Auto/Star columns. Default true. */
+    readonly reserveEmptyHeaderSlots?: boolean;
+    readonly headerView?: ReactNode;
+    readonly headerLeadingView?: ReactNode;
+    readonly headerTitleView?: ReactNode;
+    readonly headerTrailingView?: ReactNode;
+    readonly headerLeadingAndTitleView?: ReactNode;
+    readonly headerTitleAndTrailingView?: ReactNode;
+    /** Custom footer; wins over `footerButtons`. */
+    readonly footerView?: ReactNode;
+    /** Equal-width footer buttons. */
+    readonly footerButtons?: ReadonlyArray<ReactNode> | null;
+    /** Default 3. */
+    readonly footerMaxButtonsPerRow?: number;
+    /** Hardware back closes. Default true. */
+    readonly hardwareBackCloses?: boolean;
+    /** Intercepts every back request (disables drag). */
+    readonly onBackRequested?: ((source: G9SheetBackSource) => G9SheetBackAction | Promise<G9SheetBackAction>) | null;
+    /** Max sheet width on Android (px). */
+    readonly androidMaxWidth?: number | null;
+    /** Max sheet height on Android (px). */
+    readonly androidMaxHeight?: number | null;
+    /** Margin around the sheet on Android `[l, t, r, b]`. */
+    readonly androidMargin?: readonly [number, number, number, number] | null;
+    /** Android half-expanded ratio override. */
+    readonly androidHalfExpandedRatio?: number | null;
+    /** Square the expanded corners on Android. */
+    readonly androidShouldRemoveExpandedCorners?: boolean | null;
+    readonly windowsMaxWidth?: number | null;
+    readonly windowsMaxHeight?: number | null;
+    readonly windowsMinWidth?: number | null;
+    readonly windowsMinHeight?: number | null;
+    /** Animate the scrim colour on iOS. Default true. */
+    readonly animateOverlayToColorOnIos?: boolean;
+}
+/** App-wide sheet settings (MAUI `G9BottomSheetSettings`), `<G9Provider settings={{ sheets }}>`. */
+export interface G9SheetSettings {
+    /** Default black. */
+    readonly modalOverlayColor?: string;
+    /** Dim at the smallest detent (0–1). Default 0.3. */
+    readonly modalOverlayMinimumOpacity?: number;
+    /** Dim at full screen (0–1). Default 0.9. */
+    readonly modalOverlayMaximumOpacity?: number;
+    /** Default 300. */
+    readonly openAnimationDurationMs?: number;
+    /** Default 300. */
+    readonly closeAnimationDurationMs?: number;
+    /** Partial traversals take a proportional slice. Default true. */
+    readonly sizeScaledAnimationDuration?: boolean;
+    /** Global switch of the page recede. Default true. */
+    readonly enableBackdropCardEffect?: boolean;
+    /** Colour behind the receded page. Default black. */
+    readonly backdropCardColor?: string;
+    /** Staged pipeline: a `replaceCurrentSheet` successor hands off once it is ready. Default true. */
+    readonly stageBeforeShow?: boolean;
+    /** Longest a hand-off waits for the successor to open before the old sheet closes anyway (0–5000). Default 250. */
+    readonly preOpenMaxHoldMs?: number;
+    /** Prebuilt (non-factory) content also waits behind the loading placeholder until after the open motion. Default false. */
+    readonly deferPrebuiltContent?: boolean;
+    /** `'platformNative'` (lynx-ui's motion) or `'timed'` (tween over the durations). Default platformNative. */
+    readonly motionStyle?: 'platformNative' | 'timed';
+    /** The app version the persisted sheet heights belong to; another version discards them. Default `'0'`. */
+    readonly heightMemoVersion?: string;
+}
+/** {@link G9SheetSettings} with defaults, clamped like MAUI `G9BottomSheetSettings.Normalize`. */
+export declare function resolveSheetSettings(settings: G9SheetSettings | undefined): Required<G9SheetSettings>;
+/** MAUI `DefaultOptions()`: medium, `[medium, large]`, modal, cancelable, handle, draggable. */
+export declare function defaultSheetOptions(): G9SheetOptions;
+/** MAUI `FitToContentOptions()`: sized to a non-scrolling body, capped at 75 % of the host. */
+export declare function fitToContentSheetOptions(): G9SheetOptions;
+/** MAUI `FullScreenWithoutHandleOptions()`. */
+export declare function fullScreenWithoutHandleSheetOptions(): G9SheetOptions;
+/** MAUI `FullScreenModalOptions(title, showCloseButton, hardwareBackCloses, toolbarItems)`. */
+export declare function fullScreenModalSheetOptions(title?: string | null, showCloseButton?: boolean, hardwareBackCloses?: boolean, toolbarItems?: ReadonlyArray<G9SheetToolbarItem> | null): G9SheetOptions;
+/** MAUI `FullScreenEdgeToEdgeModalOptions(hardwareBackCloses)`: no header, flush top. */
+export declare function fullScreenEdgeToEdgeModalSheetOptions(hardwareBackCloses?: boolean): G9SheetOptions;
+//# sourceMappingURL=options.d.ts.map

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

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

package/dist/sheet/options.jsx

@@ -0,0 +1,91 @@
+const clamp = (v, lo, hi)=>Math.min(hi, Math.max(lo, v));
+const finite = (v, fallback)=>'number' == typeof v && Number.isFinite(v) ? v : fallback;
+function resolveSheetSettings(settings) {
+    var _s_modalOverlayColor, _s_sizeScaledAnimationDuration, _s_enableBackdropCardEffect, _s_backdropCardColor, _s_stageBeforeShow, _s_deferPrebuiltContent, _s_motionStyle, _s_heightMemoVersion;
+    const s = null != settings ? settings : {};
+    let min = clamp(finite(s.modalOverlayMinimumOpacity, 0.3), 0, 1);
+    let max = clamp(finite(s.modalOverlayMaximumOpacity, 0.9), 0, 1);
+    if (min > max) [min, max] = [
+        max,
+        min
+    ];
+    return Object.freeze({
+        modalOverlayColor: null != (_s_modalOverlayColor = s.modalOverlayColor) ? _s_modalOverlayColor : '#000000',
+        modalOverlayMinimumOpacity: min,
+        modalOverlayMaximumOpacity: max,
+        openAnimationDurationMs: Math.max(0, finite(s.openAnimationDurationMs, 300)),
+        closeAnimationDurationMs: Math.max(0, finite(s.closeAnimationDurationMs, 300)),
+        sizeScaledAnimationDuration: null != (_s_sizeScaledAnimationDuration = s.sizeScaledAnimationDuration) ? _s_sizeScaledAnimationDuration : true,
+        enableBackdropCardEffect: null != (_s_enableBackdropCardEffect = s.enableBackdropCardEffect) ? _s_enableBackdropCardEffect : true,
+        backdropCardColor: null != (_s_backdropCardColor = s.backdropCardColor) ? _s_backdropCardColor : '#000000',
+        stageBeforeShow: null != (_s_stageBeforeShow = s.stageBeforeShow) ? _s_stageBeforeShow : true,
+        preOpenMaxHoldMs: clamp(finite(s.preOpenMaxHoldMs, 250), 0, 5000),
+        deferPrebuiltContent: null != (_s_deferPrebuiltContent = s.deferPrebuiltContent) ? _s_deferPrebuiltContent : false,
+        motionStyle: null != (_s_motionStyle = s.motionStyle) ? _s_motionStyle : 'platformNative',
+        heightMemoVersion: null != (_s_heightMemoVersion = s.heightMemoVersion) ? _s_heightMemoVersion : '0'
+    });
+}
+function defaultSheetOptions() {
+    return {
+        currentState: 'medium',
+        states: [
+            'medium',
+            'large'
+        ],
+        sizeMode: 'states',
+        halfExpandedRatio: 0.5,
+        fullExpandedRatio: 1
+    };
+}
+function fitToContentSheetOptions() {
+    return {
+        sizeMode: 'fitToContent',
+        isCancelable: true,
+        hasHandle: true,
+        isDraggable: true,
+        deferContent: true
+    };
+}
+function fullScreenWithoutHandleSheetOptions() {
+    return {
+        currentState: 'large',
+        states: [
+            'large'
+        ],
+        isCancelable: false,
+        isDraggable: false,
+        hasHandle: false,
+        deferContent: true
+    };
+}
+function fullScreenModalSheetOptions(title, showCloseButton = true, hardwareBackCloses = true, toolbarItems) {
+    return {
+        currentState: 'large',
+        states: [
+            'large'
+        ],
+        sizeMode: 'states',
+        isCancelable: false,
+        isDraggable: false,
+        hasHandle: false,
+        cornerRadius: 0,
+        backgroundColor: 'var(--g9-background)',
+        showToolbar: true,
+        showCloseButton,
+        title: null != title ? title : null,
+        toolbarItems: null != toolbarItems ? toolbarItems : null,
+        hardwareBackCloses
+    };
+}
+function fullScreenEdgeToEdgeModalSheetOptions(hardwareBackCloses = true) {
+    return {
+        ...fullScreenModalSheetOptions(null, false, hardwareBackCloses),
+        showToolbar: false,
+        useTopSafeAreaPadding: false,
+        topSafeAreaPaddingOverride: 0,
+        additionalTopSafeAreaPadding: 0
+    };
+}
+export { defaultSheetOptions, fitToContentSheetOptions, fullScreenEdgeToEdgeModalSheetOptions, fullScreenModalSheetOptions, fullScreenWithoutHandleSheetOptions, resolveSheetSettings };
+
+//# sourceMappingURL=options.jsx.map

package/dist/sheet/options.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/options.jsx","sources":["../../src/sheet/options.ts"],"sourcesContent":["import type { ReactNode } from '@lynx-js/react';\nimport type { G9BottomSheetLoadingSkeleton } from '../display/shimmer';\nimport type { G9IconInput } from '../icon/icon';\n\n// MAUI `G9BottomSheetOptions` / `G9BottomSheetSettings` and their enums (BottomSheet/G9BottomSheetOptions.cs).\n\n/** Detents (MAUI `G9BottomSheetState`): peek (collapsed height), medium (half), large (full). */\nexport type G9SheetDetent = 'peek' | 'medium' | 'large';\n/** Detent sizing or fit-to-content (MAUI `G9BottomSheetSizeMode`). */\nexport type G9SheetSizeMode = 'states' | 'fitToContent';\n/** Header title anchor (MAUI `G9BottomSheetHeaderTitlePlacement`). */\nexport type G9SheetHeaderTitlePlacement = 'center' | 'nearBack';\n/** Where a back request came from (MAUI `G9BottomSheetBackRequestSource` + drag-to-close). */\nexport type G9SheetBackSource = 'toolbarButton' | 'hardwareButton' | 'overlayTap' | 'drag';\n/** What `onBackRequested` decides (MAUI `G9BottomSheetBackAction`). */\nexport type G9SheetBackAction = 'close' | 'doNothing';\n/** Content width (MAUI `G9SheetViewContentWidthMode`). */\nexport type G9SheetContentWidthMode = 'full' | 'custom';\n\n/** A header toolbar action (MAUI `G9BottomSheetToolbarItem`). */\nexport interface G9SheetToolbarItem {\n  /** Glyph/icon. */\n  readonly icon?: G9IconInput;\n  /** Text (when there is no icon). */\n  readonly text?: string;\n  /** The action (MAUI `AsyncAction`/`Command`); a returned promise keeps the item busy while `disableWhileBusy`. */\n  readonly onPress?: () => unknown;\n  readonly isBusy?: boolean;\n  /** Spinner while busy. Default false. */\n  readonly showBusyIndicator?: boolean;\n  readonly isActive?: boolean;\n  /** Dot while active. Default false. */\n  readonly showActiveBadge?: boolean;\n  /** Ignore presses while busy. Default true. */\n  readonly disableWhileBusy?: boolean;\n  /** Default true. */\n  readonly animatePress?: boolean;\n  /** 0 → 24. */\n  readonly iconSize?: number;\n  readonly accessibilityLabel?: string;\n  /** Stable key (default the index). */\n  readonly key?: string;\n}\n\n/** Lifecycle callbacks of one sheet (MAUI `Opening/Opened/Closing/ClosedCommand`). */\nexport interface G9SheetLifecycle {\n  /** When the sheet starts opening. */\n  readonly onOpening?: () => void;\n  /** After the open motion (or its timer fallback). */\n  readonly onOpened?: () => void;\n  /** Once, when closing starts (not on an in-place replace). */\n  readonly onClosing?: () => void;\n  /** Once, at cleanup. */\n  readonly onClosed?: () => void;\n  /** The sheet came to rest at another detent (MAUI `G9SheetView.StateChanged`), with its height in px. */\n  readonly onStateChanged?: (detent: G9SheetDetent | 'fit', heightPx: number) => void;\n}\n\n/** Everything a sheet can be opened with (MAUI `G9BottomSheetOptions`; 77 properties + presets). */\nexport interface G9SheetOptions extends G9SheetLifecycle {\n  // State and sizing\n  /** Initial detent. Default `'medium'`. */\n  readonly currentState?: G9SheetDetent;\n  /** Allowed detents. Default `['medium', 'large']`. */\n  readonly states?: ReadonlyArray<G9SheetDetent>;\n  /** Default `'states'`. */\n  readonly sizeMode?: G9SheetSizeMode;\n  /** Dim scrim that blocks the page. Default true. */\n  readonly isModal?: boolean;\n  /** Overlay tap / drag may close. Default true. */\n  readonly isCancelable?: boolean;\n  /** Default true. */\n  readonly isDraggable?: boolean;\n  /** Grabber. Default true. */\n  readonly hasHandle?: boolean;\n  /** Peek height (dp). Default 100 (with `collapsedHeight`). */\n  readonly peekHeight?: number | null;\n  /** Alias of `peekHeight` (MAUI `CollapsedHeight`); wins when both are set. */\n  readonly collapsedHeight?: number | null;\n  /** Medium = host × ratio (0.1–0.9). Default 0.5. */\n  readonly halfExpandedRatio?: number | null;\n  /** Large = host × ratio (0.1–1). Default 1. */\n  readonly fullExpandedRatio?: number | null;\n  /** Cap of a fit sheet (0.2–1). Default 0.75. */\n  readonly maxFitToContentHeightRatio?: number;\n  /** The largest detent is sized to the content (states mode). Default false. */\n  readonly expandedFitsContent?: boolean;\n  /** A drag on a scroller expands the sheet first. Default true. */\n  readonly scrollingExpandsSheet?: boolean;\n  /** Height memory key (needed for factory content). */\n  readonly heightMemoKey?: string | null;\n  // Visual\n  /** Body padding. Default 0. */\n  readonly padding?: number;\n  /** 10 px gap under the header hairline. Default true. */\n  readonly useStandardBodyTopGap?: boolean;\n  /** Top corners. Default 12. */\n  readonly cornerRadius?: number;\n  /** Body background. Default `var(--g9-surface-container)`. */\n  readonly backgroundColor?: string | null;\n  /** Scrim colour; its alpha replaces the maximum opacity. */\n  readonly windowBackgroundColor?: string | null;\n  /** Default `'full'`. */\n  readonly contentWidthMode?: G9SheetContentWidthMode;\n  /** Width in `'custom'` mode (MAUI `G9BottomSheetContentWidth`). */\n  readonly contentWidth?: number | null;\n  /** Full-screen sheets reserve the top inset. Default true. */\n  readonly useTopSafeAreaPadding?: boolean;\n  /** Default 0. */\n  readonly additionalTopSafeAreaPadding?: number;\n  /** Replaces the top padding (0 = flush). */\n  readonly topSafeAreaPaddingOverride?: number | null;\n  /** Grabber on full-screen toolbar sheets. Default true. */\n  readonly showFullScreenDragHandle?: boolean;\n  /** Page recede behind a tall primary sheet. Default true. */\n  readonly enableBackdropCardEffect?: boolean;\n  /** Visible ratio where the recede starts. Default 0.75. */\n  readonly backdropCardEffectThreshold?: number;\n  // Animation and loading\n  /** Per-sheet open duration (ms); default the settings value. */\n  readonly openAnimationDurationMs?: number | null;\n  readonly closeAnimationDurationMs?: number | null;\n  /** Factory content builds after the open motion (spinner/skeleton first). Default true. */\n  readonly deferContent?: boolean;\n  /** Delay before deferred content swaps in. Default 369. */\n  readonly loadDelayMs?: number;\n  /** The placeholder uses the full height. Default false. */\n  readonly useFullScreenLoadingPlaceholder?: boolean;\n  /** Known final body height for the placeholder. */\n  readonly deferredLoadingPlaceholderHeight?: number | null;\n  /** Covered crossfade reveal of deferred content. Default true. */\n  readonly fadeDeferredContentIn?: boolean;\n  /** Placeholder shape. Default `'none'` (spinner). */\n  readonly loadingSkeleton?: G9BottomSheetLoadingSkeleton;\n  /** 0 → the shape's default. */\n  readonly loadingSkeletonRowCount?: number;\n  // Stack and replace\n  /** The parent sinks and fades when this sheet stacks on it. Default true. */\n  readonly recedeParentOnStack?: boolean;\n  /** Hand-off: replaces the one open sheet once this one is ready. Default false. */\n  readonly replaceCurrentSheet?: boolean;\n  // Header and footer\n  /** Three-slot header. Default false. */\n  readonly showToolbar?: boolean;\n  /** Leading back (or close) button. Default false. */\n  readonly showCloseButton?: boolean;\n  /** × instead of the back arrow. Default false. */\n  readonly useCloseIcon?: boolean;\n  readonly title?: string | null;\n  readonly toolbarItems?: ReadonlyArray<G9SheetToolbarItem> | null;\n  /** Items built from the content once it exists. */\n  readonly toolbarItemsFactory?: (() => ReadonlyArray<G9SheetToolbarItem>) | null;\n  /** Default `'center'`. */\n  readonly headerTitlePlacement?: G9SheetHeaderTitlePlacement;\n  /** Star/Auto/Star columns. Default true. */\n  readonly reserveEmptyHeaderSlots?: boolean;\n  readonly headerView?: ReactNode;\n  readonly headerLeadingView?: ReactNode;\n  readonly headerTitleView?: ReactNode;\n  readonly headerTrailingView?: ReactNode;\n  readonly headerLeadingAndTitleView?: ReactNode;\n  readonly headerTitleAndTrailingView?: ReactNode;\n  /** Custom footer; wins over `footerButtons`. */\n  readonly footerView?: ReactNode;\n  /** Equal-width footer buttons. */\n  readonly footerButtons?: ReadonlyArray<ReactNode> | null;\n  /** Default 3. */\n  readonly footerMaxButtonsPerRow?: number;\n  /** Hardware back closes. Default true. */\n  readonly hardwareBackCloses?: boolean;\n  /** Intercepts every back request (disables drag). */\n  readonly onBackRequested?: ((source: G9SheetBackSource) => G9SheetBackAction | Promise<G9SheetBackAction>) | null;\n  // Platform specific (accepted; applied where Lynx has an equivalent)\n  /** Max sheet width on Android (px). */\n  readonly androidMaxWidth?: number | null;\n  /** Max sheet height on Android (px). */\n  readonly androidMaxHeight?: number | null;\n  /** Margin around the sheet on Android `[l, t, r, b]`. */\n  readonly androidMargin?: readonly [number, number, number, number] | null;\n  /** Android half-expanded ratio override. */\n  readonly androidHalfExpandedRatio?: number | null;\n  /** Square the expanded corners on Android. */\n  readonly androidShouldRemoveExpandedCorners?: boolean | null;\n  readonly windowsMaxWidth?: number | null;\n  readonly windowsMaxHeight?: number | null;\n  readonly windowsMinWidth?: number | null;\n  readonly windowsMinHeight?: number | null;\n  /** Animate the scrim colour on iOS. Default true. */\n  readonly animateOverlayToColorOnIos?: boolean;\n}\n\n/** App-wide sheet settings (MAUI `G9BottomSheetSettings`), `<G9Provider settings={{ sheets }}>`. */\nexport interface G9SheetSettings {\n  /** Default black. */\n  readonly modalOverlayColor?: string;\n  /** Dim at the smallest detent (0–1). Default 0.3. */\n  readonly modalOverlayMinimumOpacity?: number;\n  /** Dim at full screen (0–1). Default 0.9. */\n  readonly modalOverlayMaximumOpacity?: number;\n  /** Default 300. */\n  readonly openAnimationDurationMs?: number;\n  /** Default 300. */\n  readonly closeAnimationDurationMs?: number;\n  /** Partial traversals take a proportional slice. Default true. */\n  readonly sizeScaledAnimationDuration?: boolean;\n  /** Global switch of the page recede. Default true. */\n  readonly enableBackdropCardEffect?: boolean;\n  /** Colour behind the receded page. Default black. */\n  readonly backdropCardColor?: string;\n  /** Staged pipeline: a `replaceCurrentSheet` successor hands off once it is ready. Default true. */\n  readonly stageBeforeShow?: boolean;\n  /** Longest a hand-off waits for the successor to open before the old sheet closes anyway (0–5000). Default 250. */\n  readonly preOpenMaxHoldMs?: number;\n  /** Prebuilt (non-factory) content also waits behind the loading placeholder until after the open motion. Default false. */\n  readonly deferPrebuiltContent?: boolean;\n  /** `'platformNative'` (lynx-ui's motion) or `'timed'` (tween over the durations). Default platformNative. */\n  readonly motionStyle?: 'platformNative' | 'timed';\n  /** The app version the persisted sheet heights belong to; another version discards them. Default `'0'`. */\n  readonly heightMemoVersion?: string;\n}\n\nconst clamp = (v: number, lo: number, hi: number) => Math.min(hi, Math.max(lo, v));\nconst finite = (v: number | undefined, fallback: number) =>\n  typeof v === 'number' && Number.isFinite(v) ? v : fallback;\n\n/** {@link G9SheetSettings} with defaults, clamped like MAUI `G9BottomSheetSettings.Normalize`. */\nexport function resolveSheetSettings(settings: G9SheetSettings | undefined): Required<G9SheetSettings> {\n  const s = settings ?? {};\n  let min = clamp(finite(s.modalOverlayMinimumOpacity, 0.3), 0, 1);\n  let max = clamp(finite(s.modalOverlayMaximumOpacity, 0.9), 0, 1);\n  if (min > max) [min, max] = [max, min];\n  return Object.freeze({\n    modalOverlayColor: s.modalOverlayColor ?? '#000000',\n    modalOverlayMinimumOpacity: min,\n    modalOverlayMaximumOpacity: max,\n    openAnimationDurationMs: Math.max(0, finite(s.openAnimationDurationMs, 300)),\n    closeAnimationDurationMs: Math.max(0, finite(s.closeAnimationDurationMs, 300)),\n    sizeScaledAnimationDuration: s.sizeScaledAnimationDuration ?? true,\n    enableBackdropCardEffect: s.enableBackdropCardEffect ?? true,\n    backdropCardColor: s.backdropCardColor ?? '#000000',\n    stageBeforeShow: s.stageBeforeShow ?? true,\n    preOpenMaxHoldMs: clamp(finite(s.preOpenMaxHoldMs, 250), 0, 5000),\n    deferPrebuiltContent: s.deferPrebuiltContent ?? false,\n    motionStyle: s.motionStyle ?? 'platformNative',\n    heightMemoVersion: s.heightMemoVersion ?? '0',\n  });\n}\n\n/** MAUI `DefaultOptions()`: medium, `[medium, large]`, modal, cancelable, handle, draggable. */\nexport function defaultSheetOptions(): G9SheetOptions {\n  return {\n    currentState: 'medium',\n    states: ['medium', 'large'],\n    sizeMode: 'states',\n    halfExpandedRatio: 0.5,\n    fullExpandedRatio: 1,\n  };\n}\n\n/** MAUI `FitToContentOptions()`: sized to a non-scrolling body, capped at 75 % of the host. */\nexport function fitToContentSheetOptions(): G9SheetOptions {\n  return { sizeMode: 'fitToContent', isCancelable: true, hasHandle: true, isDraggable: true, deferContent: true };\n}\n\n/** MAUI `FullScreenWithoutHandleOptions()`. */\nexport function fullScreenWithoutHandleSheetOptions(): G9SheetOptions {\n  return {\n    currentState: 'large',\n    states: ['large'],\n    isCancelable: false,\n    isDraggable: false,\n    hasHandle: false,\n    deferContent: true,\n  };\n}\n\n/** MAUI `FullScreenModalOptions(title, showCloseButton, hardwareBackCloses, toolbarItems)`. */\nexport function fullScreenModalSheetOptions(\n  title?: string | null,\n  showCloseButton = true,\n  hardwareBackCloses = true,\n  toolbarItems?: ReadonlyArray<G9SheetToolbarItem> | null,\n): G9SheetOptions {\n  return {\n    currentState: 'large',\n    states: ['large'],\n    sizeMode: 'states',\n    isCancelable: false,\n    isDraggable: false,\n    hasHandle: false,\n    cornerRadius: 0,\n    backgroundColor: 'var(--g9-background)',\n    showToolbar: true,\n    showCloseButton,\n    title: title ?? null,\n    toolbarItems: toolbarItems ?? null,\n    hardwareBackCloses,\n  };\n}\n\n/** MAUI `FullScreenEdgeToEdgeModalOptions(hardwareBackCloses)`: no header, flush top. */\nexport function fullScreenEdgeToEdgeModalSheetOptions(hardwareBackCloses = true): G9SheetOptions {\n  return {\n    ...fullScreenModalSheetOptions(null, false, hardwareBackCloses),\n    showToolbar: false,\n    useTopSafeAreaPadding: false,\n    topSafeAreaPaddingOverride: 0,\n    additionalTopSafeAreaPadding: 0,\n  };\n}\n"],"names":["clamp","v","lo","hi","Math","finite","fallback","Number","resolveSheetSettings","settings","_s_modalOverlayColor","_s_sizeScaledAnimationDuration","_s_enableBackdropCardEffect","_s_backdropCardColor","_s_stageBeforeShow","_s_deferPrebuiltContent","_s_motionStyle","_s_heightMemoVersion","s","min","max","Object","defaultSheetOptions","fitToContentSheetOptions","fullScreenWithoutHandleSheetOptions","fullScreenModalSheetOptions","title","showCloseButton","hardwareBackCloses","toolbarItems","fullScreenEdgeToEdgeModalSheetOptions"],"mappings":"AA6NA,MAAMA,QAAQ,CAACC,GAAWC,IAAYC,KAAeC,KAAK,GAAG,CAACD,IAAIC,KAAK,GAAG,CAACF,IAAID;AAC/E,MAAMI,SAAS,CAACJ,GAAuBK,WACrC,AAAa,YAAb,OAAOL,KAAkBM,OAAO,QAAQ,CAACN,KAAKA,IAAIK;AAG7C,SAASE,qBAAqBC,QAAqC;QAMnDC,sBAKUC,gCACHC,6BACPC,sBACFC,oBAEKC,yBACTC,gBACMC;IAjBrB,MAAMC,IAAIT,QAAAA,WAAAA,WAAY,CAAC;IACvB,IAAIU,MAAMnB,MAAMK,OAAOa,EAAE,0BAA0B,EAAE,MAAM,GAAG;IAC9D,IAAIE,MAAMpB,MAAMK,OAAOa,EAAE,0BAA0B,EAAE,MAAM,GAAG;IAC9D,IAAIC,MAAMC,KAAK,CAACD,KAAKC,IAAI,GAAG;QAACA;QAAKD;KAAI;IACtC,OAAOE,OAAO,MAAM,CAAC;QACnB,mBAAmB,QAAAX,CAAAA,uBAAAA,EAAE,iBAAiB,AAAD,IAAlBA,uBAAuB;QAC1C,4BAA4BS;QAC5B,4BAA4BC;QAC5B,yBAAyBhB,KAAK,GAAG,CAAC,GAAGC,OAAOa,EAAE,uBAAuB,EAAE;QACvE,0BAA0Bd,KAAK,GAAG,CAAC,GAAGC,OAAOa,EAAE,wBAAwB,EAAE;QACzE,6BAA6B,QAAAP,CAAAA,iCAAAA,EAAE,2BAA2B,AAAD,IAA5BA,iCAAiC;QAC9D,0BAA0B,QAAAC,CAAAA,8BAAAA,EAAE,wBAAwB,AAAD,IAAzBA,8BAA8B;QACxD,mBAAmB,QAAAC,CAAAA,uBAAAA,EAAE,iBAAiB,AAAD,IAAlBA,uBAAuB;QAC1C,iBAAiB,QAAAC,CAAAA,qBAAAA,EAAE,eAAe,AAAD,IAAhBA,qBAAqB;QACtC,kBAAkBd,MAAMK,OAAOa,EAAE,gBAAgB,EAAE,MAAM,GAAG;QAC5D,sBAAsB,QAAAH,CAAAA,0BAAAA,EAAE,oBAAoB,AAAD,IAArBA,0BAA0B;QAChD,aAAa,QAAAC,CAAAA,iBAAAA,EAAE,WAAW,AAAD,IAAZA,iBAAiB;QAC9B,mBAAmB,QAAAC,CAAAA,uBAAAA,EAAE,iBAAiB,AAAD,IAAlBA,uBAAuB;IAC5C;AACF;AAGO,SAASK;IACd,OAAO;QACL,cAAc;QACd,QAAQ;YAAC;YAAU;SAAQ;QAC3B,UAAU;QACV,mBAAmB;QACnB,mBAAmB;IACrB;AACF;AAGO,SAASC;IACd,OAAO;QAAE,UAAU;QAAgB,cAAc;QAAM,WAAW;QAAM,aAAa;QAAM,cAAc;IAAK;AAChH;AAGO,SAASC;IACd,OAAO;QACL,cAAc;QACd,QAAQ;YAAC;SAAQ;QACjB,cAAc;QACd,aAAa;QACb,WAAW;QACX,cAAc;IAChB;AACF;AAGO,SAASC,4BACdC,KAAqB,EACrBC,kBAAkB,IAAI,EACtBC,qBAAqB,IAAI,EACzBC,YAAuD;IAEvD,OAAO;QACL,cAAc;QACd,QAAQ;YAAC;SAAQ;QACjB,UAAU;QACV,cAAc;QACd,aAAa;QACb,WAAW;QACX,cAAc;QACd,iBAAiB;QACjB,aAAa;QACbF;QACA,OAAOD,QAAAA,QAAAA,QAAS;QAChB,cAAcG,QAAAA,eAAAA,eAAgB;QAC9BD;IACF;AACF;AAGO,SAASE,sCAAsCF,qBAAqB,IAAI;IAC7E,OAAO;QACL,GAAGH,4BAA4B,MAAM,OAAOG,mBAAmB;QAC/D,aAAa;QACb,uBAAuB;QACvB,4BAA4B;QAC5B,8BAA8B;IAChC;AACF"}

package/dist/sheet/processing.d.ts

@@ -0,0 +1,22 @@
+import { type ReactNode } from '@lynx-js/react';
+import type { G9SheetHandle } from './stack.js';
+/** Builds the body of a processing sheet: the node, or `null` to close quietly. Called once, after opening. */
+export type G9ProcessingBuild = (handle: G9SheetHandle, signal: import('@g9tm/lynxcontrols-foundation').G9AbortSignal) => Promise<ReactNode | null> | ReactNode | null;
+/** Handles a build failure (the sheet stays open unless it closes it). */
+export type G9ProcessingErrorHandler = (error: unknown, handle: G9SheetHandle) => unknown;
+/** Props of {@link G9ProcessingSheetContent}. */
+export interface G9ProcessingSheetContentProps {
+    readonly build: G9ProcessingBuild;
+    readonly onError?: G9ProcessingErrorHandler;
+    /** Spinner box height. Default 160. */
+    readonly loadingHeight?: number;
+    /** The sheet handle (for content created before the handle existed). Default the enclosing sheet's. */
+    readonly handle?: () => G9SheetHandle | null;
+}
+/**
+ * The body of a processing sheet (MAUI `ProcessingSheetContentView`): a 42 px spinner in a `loadingHeight` box, then
+ * the built body swapped in at once. A failure is always logged (no popup); then `onError` runs, or the error popup
+ * shows and the sheet closes. `null` closes the sheet quietly. A close cancels the build (`signal`).
+ */
+export declare function G9ProcessingSheetContent(props: G9ProcessingSheetContentProps): ReactNode;
+//# sourceMappingURL=processing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processing.d.ts","sourceRoot":"","sources":["../../src/sheet/processing.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,gBAAgB,CAAC;AAI7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,+GAA+G;AAC/G,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,OAAO,+BAA+B,EAAE,aAAa,KAC1D,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;AAClD,0EAA0E;AAC1E,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC;AAE1F,iDAAiD;AACjD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;IAC5C,uCAAuC;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,uGAAuG;IACvG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,SAAS,CA0DxF"}