@g9tm/lynxcontrols 0.0.0-stage → 1.4.2

package/dist/sheet/motion.d.ts

@@ -0,0 +1,59 @@
+import type { currentPlatform } from './sizing.js';
+/** ViewDragHelper `BASE_SETTLE_DURATION` (ms). */
+export declare const g9MaterialBaseSettleMs = 256;
+/** ViewDragHelper `MAX_SETTLE_DURATION` (ms). */
+export declare const g9MaterialMaxSettleMs = 600;
+/** UIKit's default transition spring, critically damped as Core Animation runs it: ω₀ = √(1000 / 3) rad/s. */
+export declare const g9CupertinoOmega: number;
+/** Material settle duration (ms) for a programmatic move over `distanceRatio` of the host height. */
+export declare function materialSettleDurationMs(distanceRatio: number): number;
+/** ViewDragHelper's `sInterpolator`: `(t − 1)^5 + 1`. */
+export declare function materialSettle(t: number): number;
+/** Main-thread twin of {@link materialSettle} (the curve lynx-ui calls every frame). */
+export declare function materialSettleMT(t: number): number;
+/** The timed style's curve (MAUI `Easing.CubicOut`). */
+export declare function easeOutCubic(t: number): number;
+/** Main-thread twin of {@link easeOutCubic}. */
+export declare function easeOutCubicMT(t: number): number;
+/** A lynx-ui sheet transition. */
+export type G9SheetTransition = {
+    readonly type: 'tween' /** milliseconds (lynx-ui's unit) */;
+    readonly duration: number;
+    readonly ease: (t: number) => number;
+} | {
+    readonly type: 'spring';
+    readonly stiffness: number;
+    readonly damping: number;
+    readonly mass: number;
+};
+/** The lynx-ui motion of one sheet: `SheetContent`'s `enterAnimation`, `exitAnimation`, `snapAnimation`. */
+export interface G9SheetMotion {
+    readonly enterAnimation: G9SheetTransition;
+    readonly exitAnimation: G9SheetTransition;
+    readonly snapAnimation: G9SheetTransition;
+}
+/** What {@link resolveSheetMotion} needs; ratios are shares of the host height (0–1). */
+export interface G9SheetMotionInput {
+    readonly style: 'platformNative' | 'timed';
+    readonly platform: ReturnType<typeof currentPlatform>;
+    /** Share of the host the sheet covers where it opens and from where it closes. */
+    readonly openRatio: number;
+    /** Share of the host between the smallest and the largest detent (snap travel). */
+    readonly snapRatio: number;
+    /** Settings or per-sheet open duration (ms); used by `timed`, and by `platformNative` when `perSheetOpen`. */
+    readonly openMs: number;
+    readonly closeMs: number;
+    /** A per-sheet `openAnimationDurationMs` / `closeAnimationDurationMs` was set: it sets the time, the curve stays. */
+    readonly perSheetOpen: boolean;
+    readonly perSheetClose: boolean;
+    /** `timed` only: partial travel takes the matching slice of the duration (`sizeScaledAnimationDuration`). */
+    readonly sizeScaled: boolean;
+}
+/**
+ * The lynx-ui motion for a sheet (MAUI `ResolveSheetMotion`). `platformNative`: Material settle tweens on Android,
+ * Windows and unknown hosts (durations from the travel), the critically damped UIKit spring on iOS and macOS; a
+ * per-sheet duration replaces the time for its direction and keeps the platform curve (a quintic tween). `timed`: the
+ * configured durations on a cubic ease-out, size-scaled when enabled; snapping keeps the full open duration.
+ */
+export declare function resolveSheetMotion(input: G9SheetMotionInput): G9SheetMotion;
+//# sourceMappingURL=motion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../src/sheet/motion.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,8GAA8G;AAC9G,eAAO,MAAM,gBAAgB,QAAsB,CAAC;AAEpD,qGAAqG;AACrG,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,kCAAkC;AAClC,MAAM,MAAM,iBAAiB,GACzB;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,oCAAoC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7G,4GAA4G;AAC5G,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IACtD,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8GAA8G;IAC9G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qHAAqH;IACrH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,6GAA6G;IAC7G,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAaD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAgC3E"}

package/dist/sheet/motion.jsx

@@ -0,0 +1,59 @@
+const g9MaterialBaseSettleMs = 256;
+const g9MaterialMaxSettleMs = 600;
+const g9CupertinoOmega = Math.sqrt(1000 / 3);
+function materialSettleDurationMs(distanceRatio) {
+    const ratio = Number.isFinite(distanceRatio) ? Math.min(1, Math.max(0, distanceRatio)) : 1;
+    return Math.min(g9MaterialMaxSettleMs, Math.round((ratio + 1) * g9MaterialBaseSettleMs));
+}
+function materialSettle(t) {
+    const u = t - 1;
+    return u * u * u * u * u + 1;
+}
+function materialSettleMT(t) {
+    'main thread';
+    const u = t - 1;
+    return u * u * u * u * u + 1;
+}
+function easeOutCubic(t) {
+    const u = 1 - t;
+    return 1 - u * u * u;
+}
+function easeOutCubicMT(t) {
+    'main thread';
+    const u = 1 - t;
+    return 1 - u * u * u;
+}
+const tween = (ms, ease)=>({
+        type: 'tween',
+        duration: Math.max(0, ms),
+        ease
+    });
+const scaled = (ms, ratio, sizeScaled)=>ms <= 0 ? 0 : sizeScaled ? Math.max(1, Math.round(ms * Math.min(1, Math.max(0, ratio)))) : ms;
+function resolveSheetMotion(input) {
+    if ('timed' === input.style) return {
+        enterAnimation: tween(scaled(input.openMs, input.openRatio, input.sizeScaled), easeOutCubicMT),
+        exitAnimation: tween(scaled(input.closeMs, input.openRatio, input.sizeScaled), easeOutCubicMT),
+        snapAnimation: tween(input.openMs, easeOutCubicMT)
+    };
+    if ('ios' === input.platform || 'macos' === input.platform) {
+        const spring = {
+            type: 'spring',
+            stiffness: g9CupertinoOmega * g9CupertinoOmega,
+            damping: 2 * g9CupertinoOmega,
+            mass: 1
+        };
+        return {
+            enterAnimation: input.perSheetOpen ? tween(input.openMs, materialSettleMT) : spring,
+            exitAnimation: input.perSheetClose ? tween(input.closeMs, materialSettleMT) : spring,
+            snapAnimation: spring
+        };
+    }
+    return {
+        enterAnimation: tween(input.perSheetOpen ? input.openMs : materialSettleDurationMs(input.openRatio), materialSettleMT),
+        exitAnimation: tween(input.perSheetClose ? input.closeMs : materialSettleDurationMs(input.openRatio), materialSettleMT),
+        snapAnimation: tween(materialSettleDurationMs(input.snapRatio), materialSettleMT)
+    };
+}
+export { easeOutCubic, easeOutCubicMT, g9CupertinoOmega, g9MaterialBaseSettleMs, g9MaterialMaxSettleMs, materialSettle, materialSettleDurationMs, materialSettleMT, resolveSheetMotion };
+
+//# sourceMappingURL=motion.jsx.map

package/dist/sheet/motion.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/motion.jsx","sources":["../../src/sheet/motion.ts"],"sourcesContent":["// How a G9 sheet moves on lynx-ui: the open, close and snap configs handed to lynx-ui `SheetContent`.\n//\n// MAUI `G9SheetMotionModel` (G9MAUIControls 1.4.0, BottomSheet/G9SheetView/G9SheetMotionModel.cs) is the reference:\n//   • platformNative on Android (and Windows): Material's settle, androidx ViewDragHelper — a quintic ease-out\n//     `(t − 1)^5 + 1` lasting `(distance / range + 1) × 256 ms`, at most 600 ms (256 ms for a nudge, 512 ms for the\n//     whole screen; 90 % of the way is covered in the first 37 % of the time);\n//   • platformNative on iOS / macOS: UIKit's default transition spring as Core Animation runs it, critically damped,\n//     ω₀ = √(1000 / 3) — mass 1, stiffness ω₀², damping 2ω₀ for lynx-ui's spring;\n//   • timed: the configured duration (size-scaled when enabled) on a cubic ease-out.\n// Before this module the port gave platformNative lynx-ui's default spring (stiffness 200, damping 60, mass 1): an\n// over-damped spring (ζ ≈ 2.1) that takes ~1.3 s to come to rest, a sluggish tail no AgriPad user had seen.\n//\n// lynx-ui runs the curve inside a main-thread worklet, so the curve must be a `'main thread'` function: a plain\n// background function cannot be called there (plan/specs/02 §3). Each\n// curve is a twin: `x` (background, tests, durations) and `xMT` (the worklet), asserted equal.\n\nimport type { currentPlatform } from './sizing';\n\n/** ViewDragHelper `BASE_SETTLE_DURATION` (ms). */\nexport const g9MaterialBaseSettleMs = 256;\n/** ViewDragHelper `MAX_SETTLE_DURATION` (ms). */\nexport const g9MaterialMaxSettleMs = 600;\n/** UIKit's default transition spring, critically damped as Core Animation runs it: ω₀ = √(1000 / 3) rad/s. */\nexport const g9CupertinoOmega = Math.sqrt(1000 / 3);\n\n/** Material settle duration (ms) for a programmatic move over `distanceRatio` of the host height. */\nexport function materialSettleDurationMs(distanceRatio: number): number {\n  const ratio = Number.isFinite(distanceRatio) ? Math.min(1, Math.max(0, distanceRatio)) : 1;\n  return Math.min(g9MaterialMaxSettleMs, Math.round((ratio + 1) * g9MaterialBaseSettleMs));\n}\n\n/** ViewDragHelper's `sInterpolator`: `(t − 1)^5 + 1`. */\nexport function materialSettle(t: number): number {\n  const u = t - 1;\n  return u * u * u * u * u + 1;\n}\n\n/** Main-thread twin of {@link materialSettle} (the curve lynx-ui calls every frame). */\nexport function materialSettleMT(t: number): number {\n  'main thread';\n  const u = t - 1;\n  return u * u * u * u * u + 1;\n}\n\n/** The timed style's curve (MAUI `Easing.CubicOut`). */\nexport function easeOutCubic(t: number): number {\n  const u = 1 - t;\n  return 1 - u * u * u;\n}\n\n/** Main-thread twin of {@link easeOutCubic}. */\nexport function easeOutCubicMT(t: number): number {\n  'main thread';\n  const u = 1 - t;\n  return 1 - u * u * u;\n}\n\n/** A lynx-ui sheet transition. */\nexport type G9SheetTransition =\n  | {\n      readonly type: 'tween' /** milliseconds (lynx-ui's unit) */;\n      readonly duration: number;\n      readonly ease: (t: number) => number;\n    }\n  | { readonly type: 'spring'; readonly stiffness: number; readonly damping: number; readonly mass: number };\n\n/** The lynx-ui motion of one sheet: `SheetContent`'s `enterAnimation`, `exitAnimation`, `snapAnimation`. */\nexport interface G9SheetMotion {\n  readonly enterAnimation: G9SheetTransition;\n  readonly exitAnimation: G9SheetTransition;\n  readonly snapAnimation: G9SheetTransition;\n}\n\n/** What {@link resolveSheetMotion} needs; ratios are shares of the host height (0–1). */\nexport interface G9SheetMotionInput {\n  readonly style: 'platformNative' | 'timed';\n  readonly platform: ReturnType<typeof currentPlatform>;\n  /** Share of the host the sheet covers where it opens and from where it closes. */\n  readonly openRatio: number;\n  /** Share of the host between the smallest and the largest detent (snap travel). */\n  readonly snapRatio: number;\n  /** Settings or per-sheet open duration (ms); used by `timed`, and by `platformNative` when `perSheetOpen`. */\n  readonly openMs: number;\n  readonly closeMs: number;\n  /** A per-sheet `openAnimationDurationMs` / `closeAnimationDurationMs` was set: it sets the time, the curve stays. */\n  readonly perSheetOpen: boolean;\n  readonly perSheetClose: boolean;\n  /** `timed` only: partial travel takes the matching slice of the duration (`sizeScaledAnimationDuration`). */\n  readonly sizeScaled: boolean;\n}\n\n// lynx-ui-sheet takes a tween's duration in MILLISECONDS (useSnap: `animate(…, { duration: (duration ?? 400) / 1000 })`).\n// This used to convert to seconds first, so a 199 ms open ran for 0.2 ms: every sheet jumped into place, no motion.\nconst tween = (ms: number, ease: (t: number) => number): G9SheetTransition => ({\n  type: 'tween',\n  duration: Math.max(0, ms),\n  ease,\n});\n\nconst scaled = (ms: number, ratio: number, sizeScaled: boolean) =>\n  ms <= 0 ? 0 : sizeScaled ? Math.max(1, Math.round(ms * Math.min(1, Math.max(0, ratio)))) : ms;\n\n/**\n * The lynx-ui motion for a sheet (MAUI `ResolveSheetMotion`). `platformNative`: Material settle tweens on Android,\n * Windows and unknown hosts (durations from the travel), the critically damped UIKit spring on iOS and macOS; a\n * per-sheet duration replaces the time for its direction and keeps the platform curve (a quintic tween). `timed`: the\n * configured durations on a cubic ease-out, size-scaled when enabled; snapping keeps the full open duration.\n */\nexport function resolveSheetMotion(input: G9SheetMotionInput): G9SheetMotion {\n  if (input.style === 'timed') {\n    return {\n      enterAnimation: tween(scaled(input.openMs, input.openRatio, input.sizeScaled), easeOutCubicMT),\n      exitAnimation: tween(scaled(input.closeMs, input.openRatio, input.sizeScaled), easeOutCubicMT),\n      snapAnimation: tween(input.openMs, easeOutCubicMT),\n    };\n  }\n  if (input.platform === 'ios' || input.platform === 'macos') {\n    const spring: G9SheetTransition = {\n      type: 'spring',\n      stiffness: g9CupertinoOmega * g9CupertinoOmega,\n      damping: 2 * g9CupertinoOmega,\n      mass: 1,\n    };\n    return {\n      enterAnimation: input.perSheetOpen ? tween(input.openMs, materialSettleMT) : spring,\n      exitAnimation: input.perSheetClose ? tween(input.closeMs, materialSettleMT) : spring,\n      snapAnimation: spring,\n    };\n  }\n  return {\n    enterAnimation: tween(\n      input.perSheetOpen ? input.openMs : materialSettleDurationMs(input.openRatio),\n      materialSettleMT,\n    ),\n    exitAnimation: tween(\n      input.perSheetClose ? input.closeMs : materialSettleDurationMs(input.openRatio),\n      materialSettleMT,\n    ),\n    snapAnimation: tween(materialSettleDurationMs(input.snapRatio), materialSettleMT),\n  };\n}\n"],"names":["g9MaterialBaseSettleMs","g9MaterialMaxSettleMs","g9CupertinoOmega","Math","materialSettleDurationMs","distanceRatio","ratio","Number","materialSettle","t","u","materialSettleMT","easeOutCubic","easeOutCubicMT","tween","ms","ease","scaled","sizeScaled","resolveSheetMotion","input","spring"],"mappings":"AAmBO,MAAMA,yBAAyB;AAE/B,MAAMC,wBAAwB;AAE9B,MAAMC,mBAAmBC,KAAK,IAAI,CAAC,OAAO;AAG1C,SAASC,yBAAyBC,aAAqB;IAC5D,MAAMC,QAAQC,OAAO,QAAQ,CAACF,iBAAiBF,KAAK,GAAG,CAAC,GAAGA,KAAK,GAAG,CAAC,GAAGE,kBAAkB;IACzF,OAAOF,KAAK,GAAG,CAACF,uBAAuBE,KAAK,KAAK,CAAEG,AAAAA,CAAAA,QAAQ,KAAKN;AAClE;AAGO,SAASQ,eAAeC,CAAS;IACtC,MAAMC,IAAID,IAAI;IACd,OAAOC,IAAIA,IAAIA,IAAIA,IAAIA,IAAI;AAC7B;AAGO,SAASC,iBAAiBF,CAAS;IACxC;IACA,MAAMC,IAAID,IAAI;IACd,OAAOC,IAAIA,IAAIA,IAAIA,IAAIA,IAAI;AAC7B;AAGO,SAASE,aAAaH,CAAS;IACpC,MAAMC,IAAI,IAAID;IACd,OAAO,IAAIC,IAAIA,IAAIA;AACrB;AAGO,SAASG,eAAeJ,CAAS;IACtC;IACA,MAAMC,IAAI,IAAID;IACd,OAAO,IAAIC,IAAIA,IAAIA;AACrB;AAsCA,MAAMI,QAAQ,CAACC,IAAYC,OAAoD;QAC7E,MAAM;QACN,UAAUb,KAAK,GAAG,CAAC,GAAGY;QACtBC;IACF;AAEA,MAAMC,SAAS,CAACF,IAAYT,OAAeY,aACzCH,MAAM,IAAI,IAAIG,aAAaf,KAAK,GAAG,CAAC,GAAGA,KAAK,KAAK,CAACY,KAAKZ,KAAK,GAAG,CAAC,GAAGA,KAAK,GAAG,CAAC,GAAGG,YAAYS;AAQtF,SAASI,mBAAmBC,KAAyB;IAC1D,IAAIA,AAAgB,YAAhBA,MAAM,KAAK,EACb,OAAO;QACL,gBAAgBN,MAAMG,OAAOG,MAAM,MAAM,EAAEA,MAAM,SAAS,EAAEA,MAAM,UAAU,GAAGP;QAC/E,eAAeC,MAAMG,OAAOG,MAAM,OAAO,EAAEA,MAAM,SAAS,EAAEA,MAAM,UAAU,GAAGP;QAC/E,eAAeC,MAAMM,MAAM,MAAM,EAAEP;IACrC;IAEF,IAAIO,AAAmB,UAAnBA,MAAM,QAAQ,IAAcA,AAAmB,YAAnBA,MAAM,QAAQ,EAAc;QAC1D,MAAMC,SAA4B;YAChC,MAAM;YACN,WAAWnB,mBAAmBA;YAC9B,SAAS,IAAIA;YACb,MAAM;QACR;QACA,OAAO;YACL,gBAAgBkB,MAAM,YAAY,GAAGN,MAAMM,MAAM,MAAM,EAAET,oBAAoBU;YAC7E,eAAeD,MAAM,aAAa,GAAGN,MAAMM,MAAM,OAAO,EAAET,oBAAoBU;YAC9E,eAAeA;QACjB;IACF;IACA,OAAO;QACL,gBAAgBP,MACdM,MAAM,YAAY,GAAGA,MAAM,MAAM,GAAGhB,yBAAyBgB,MAAM,SAAS,GAC5ET;QAEF,eAAeG,MACbM,MAAM,aAAa,GAAGA,MAAM,OAAO,GAAGhB,yBAAyBgB,MAAM,SAAS,GAC9ET;QAEF,eAAeG,MAAMV,yBAAyBgB,MAAM,SAAS,GAAGT;IAClE;AACF"}

package/dist/sheet/options.d.ts

@@ -0,0 +1,252 @@
+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;
+    /** Element id of the item (default `${sheet automationId}_ToolbarItem_${key or index}` when the sheet has one). */
+    readonly automationId?: 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;
+    /**
+     * The body is a vertical scroller (default true). `false` for content that scrolls itself — a `<list>` page, a map:
+     * the body becomes a flex column and the content fills it, so the content's own scroller gets a definite height (MAUI
+     * puts the content in the body as is; a CollectionView body scrolls itself). Lynx-only, additive. Use it with a
+     * detent-sized sheet (full screen / states); a fit-to-content sheet has no height to give.
+     */
+    readonly scrollBody?: 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, and detent sheets resting at a `large` detent that reaches under the top inset, reserve the
+     * top inset (MAUI state-aware top padding). Default true.
+     */
+    readonly useTopSafeAreaPadding?: boolean;
+    /**
+     * The surface reserves the host's bottom safe inset (a visible navigation bar or gesture handle) below the content
+     * and footer. 0 on an immersive host. Default true.
+     */
+    readonly useBottomSafeAreaPadding?: 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;
+    /**
+     * Automation id of the sheet (MAUI `AutomationId`): the surface gets it, the header's back/close button
+     * `${id}_Back`, toolbar items `${id}_ToolbarItem_${key or index}` (see `g9ChildId`). Keep it to `[A-Za-z0-9_-]`.
+     */
+    readonly automationId?: string;
+    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;
+    /**
+     * A footer that draws its own band (usually a component rendering {@link G9SheetFooterBar}, or nothing) — for
+     * buttons that come and go while the sheet is open. Wins over `footerView` and `footerButtons`.
+     */
+    readonly footerBand?: ReactNode;
+    /** Custom footer inside the standard band; 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;
+    /**
+     * Side padding of the header band (MAUI `G9LayoutMetrics.EdgeSpacing`, which an app may scale — AgriPad's 10 × 1.3
+     * = 13). Default 16.
+     */
+    readonly headerEdgeSpacing?: number;
+}
+/** {@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,92 @@
+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',
+        headerEdgeSpacing: Math.max(0, finite(s.headerEdgeSpacing, 16))
+    });
+}
+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  /** Element id of the item (default `${sheet automationId}_ToolbarItem_${key or index}` when the sheet has one). */\n  readonly automationId?: 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  /**\n   * The body is a vertical scroller (default true). `false` for content that scrolls itself — a `<list>` page, a map:\n   * the body becomes a flex column and the content fills it, so the content's own scroller gets a definite height (MAUI\n   * puts the content in the body as is; a CollectionView body scrolls itself). Lynx-only, additive. Use it with a\n   * detent-sized sheet (full screen / states); a fit-to-content sheet has no height to give.\n   */\n  readonly scrollBody?: 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  /**\n   * Full-screen sheets, and detent sheets resting at a `large` detent that reaches under the top inset, reserve the\n   * top inset (MAUI state-aware top padding). Default true.\n   */\n  readonly useTopSafeAreaPadding?: boolean;\n  /**\n   * The surface reserves the host's bottom safe inset (a visible navigation bar or gesture handle) below the content\n   * and footer. 0 on an immersive host. Default true.\n   */\n  readonly useBottomSafeAreaPadding?: 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  /**\n   * Automation id of the sheet (MAUI `AutomationId`): the surface gets it, the header's back/close button\n   * `${id}_Back`, toolbar items `${id}_ToolbarItem_${key or index}` (see `g9ChildId`). Keep it to `[A-Za-z0-9_-]`.\n   */\n  readonly automationId?: string;\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  /**\n   * A footer that draws its own band (usually a component rendering {@link G9SheetFooterBar}, or nothing) — for\n   * buttons that come and go while the sheet is open. Wins over `footerView` and `footerButtons`.\n   */\n  readonly footerBand?: ReactNode;\n  /** Custom footer inside the standard band; 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   * Side padding of the header band (MAUI `G9LayoutMetrics.EdgeSpacing`, which an app may scale — AgriPad's 10 × 1.3\n   * = 13). Default 16.\n   */\n  readonly headerEdgeSpacing?: number;\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    headerEdgeSpacing: Math.max(0, finite(s.headerEdgeSpacing, 16)),\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":"AA6PA,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;QAC1C,mBAAmBb,KAAK,GAAG,CAAC,GAAGC,OAAOa,EAAE,iBAAiB,EAAE;IAC7D;AACF;AAGO,SAASI;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"}