@g9tm/lynxcontrols 0.0.0-stage → 1.4.0

package/dist/sheet/sizing.d.ts

@@ -0,0 +1,69 @@
+import type { G9SheetOptions } from './options.js';
+/** MAUI `G9SheetView.MinimizedHeight`: default peek height. */
+export declare const g9SheetDefaultPeekHeight = 100;
+/** Absolute minimum of an authoritative fit height (MAUI helper :81). */
+export declare const g9SheetFitMinHeight = 80;
+/** Floor while the height is unknown (loading window). */
+export declare const g9SheetFitLoadingMinHeight = 180;
+/** Finger travel at release that requests a close (MAUI `DragCloseThreshold`). */
+export declare const g9SheetDragCloseThreshold = 72;
+/** Base gap above full-screen content (MAUI safe-area rule). */
+export declare const g9SheetTopSafeAreaBaseGap = 8;
+/** The platform the app runs on (Lynx `SystemInfo.platform`), lower-cased; `'unknown'` outside Lynx. */
+export declare function currentPlatform(): 'android' | 'ios' | 'windows' | 'macos' | 'unknown';
+/** What the adapter passes to lynx-ui `SheetRoot` and how the frame behaves. */
+export interface G9SheetLayout {
+    /** lynx-ui snap points, small to large: pixels, `'NN%'` of the host, or `'fit'`. */
+    readonly snapPoints: Array<number | string>;
+    readonly initialSnap: number;
+    /** One detent, or fit-to-content (MAUI "fixed"): no grabber, no detent dragging. */
+    readonly fixed: boolean;
+    readonly fit: boolean;
+    /** Grabber visible (`hasHandle && isDraggable && !fixed`). */
+    readonly showHandle: boolean;
+    readonly dragDisabled: boolean;
+    /** Drag past the lowest detent may request a close. */
+    readonly enableDragToClose: boolean;
+    /** Backdrop tap requests a close. */
+    readonly closeOnOverlayTap: boolean;
+    /** The resting body cap for a fit sheet (`maxFitToContentHeightRatio × host`), else `null`. */
+    readonly fitMaxHeight: number | null;
+    /** Whether the sheet's largest detent is full screen. */
+    readonly fullScreen: boolean;
+}
+/**
+ * Maps G9 options to a lynx-ui layout (the agreed mapping of MAUI `ApplyOptions`): fit → `['fit']` capped at
+ * `maxFitToContentHeightRatio`; states → peek pixels / half ratio / full ratio for the allowed detents, the initial
+ * detent from `currentState`. The MAUI quirks (a hidden 100 dp detent under `[medium, large]`, a peek-only sheet that
+ * may expand) are not carried over: the detents are exactly `states` (docs/sheets.md "deliberate differences").
+ */
+export declare function resolveSheetLayout(options: G9SheetOptions, hostHeight: number, platform?: "android" | "ios" | "windows" | "macos" | "unknown"): G9SheetLayout;
+/** Clamps a measured fit body height: `[80, cap]`, or `[180, cap]` while loading (MAUI fit engine). */
+export declare function clampFitHeight(natural: number, cap: number, loading: boolean): number;
+/**
+ * Scrim opacity for a visible ratio (MAUI helper overlay rule): between the smallest and the largest detent it runs
+ * from `min` to `max`; a single detent uses `max`; below the smallest detent it fades with the ratio.
+ */
+export declare function sheetOverlayOpacity(visibleRatio: number, detentRatios: ReadonlyArray<number>, min: number, max: number): number;
+/** The page recede behind a tall primary sheet (MAUI backdrop card): scale 1 → 0.93, translateY 0 → 12. */
+export declare function backdropCardTransform(visibleRatio: number, threshold?: number): {
+    scale: number;
+    translateY: number;
+};
+/**
+ * The visible share of the host a detent sheet covers: its resting height when known, else its opening detent
+ * (peek = peek height, medium = half ratio, large = full ratio; `expandedFitsContent` large counts as the fit cap).
+ */
+export declare function sheetVisibleRatio(options: G9SheetOptions, hostHeight: number, restingHeightPx: number | null, platform?: "android" | "ios" | "windows" | "macos" | "unknown"): number;
+/** How far a receded parent sheet sinks: `max(24, visible × 0.25)` (MAUI stack recede). */
+export declare function parentRecedeOffset(visibleHeight: number): number;
+/** Top padding of a full-screen sheet (MAUI safe-area rule). */
+export declare function sheetTopPadding(options: G9SheetOptions, topInset: number): number;
+/**
+ * Size-scaled animation duration (MAUI `SizeScaledAnimationDuration`): a partial traversal takes the matching slice
+ * of the full duration (at least 1 ms unless the duration is 0).
+ */
+export declare function scaledSheetDuration(durationMs: number, traversedRatio: number, sizeScaled: boolean): number;
+/** Platform size constraints of the sheet surface (MAUI Android/Windows options, applied where they belong). */
+export declare function platformSheetConstraints(options: G9SheetOptions, platform?: "android" | "ios" | "windows" | "macos" | "unknown"): Record<string, string>;
+//# sourceMappingURL=sizing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sizing.d.ts","sourceRoot":"","sources":["../../src/sheet/sizing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,WAAW,CAAC;AAI/D,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,0DAA0D;AAC1D,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAI3C,wGAAwG;AACxG,wBAAgB,eAAe,IAAI,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAQrF;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,qCAAqC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,sDAAoB,GAC3B,aAAa,CAmDf;AAED,uGAAuG;AACvG,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAIrF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,MAAM,CAOR;AAED,2GAA2G;AAC3G,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAInH;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,QAAQ,sDAAoB,GAC3B,MAAM,CAQR;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAI3G;AAED,gHAAgH;AAChH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,cAAc,EACvB,QAAQ,sDAAoB,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBxB"}

package/dist/sheet/sizing.jsx

@@ -0,0 +1,146 @@
+const g9SheetDefaultPeekHeight = 100;
+const g9SheetFitMinHeight = 80;
+const g9SheetFitLoadingMinHeight = 180;
+const g9SheetDragCloseThreshold = 72;
+const g9SheetTopSafeAreaBaseGap = 8;
+const clamp = (v, lo, hi)=>Math.min(hi, Math.max(lo, v));
+function currentPlatform() {
+    var _ref;
+    const info = globalThis.SystemInfo;
+    const p = (null != (_ref = null == info ? void 0 : info.platform) ? _ref : '').toLowerCase();
+    if ('android' === p) return 'android';
+    if ('ios' === p) return 'ios';
+    if (p.startsWith('win')) return 'windows';
+    if ('macos' === p || 'mac' === p || 'osx' === p) return 'macos';
+    return 'unknown';
+}
+const pct = (ratio)=>`${Math.round(10000 * ratio) / 100}%`;
+function resolveSheetLayout(options, hostHeight, platform = currentPlatform()) {
+    var _ref, _options_fullExpandedRatio, _ref1, _options_collapsedHeight, _options_currentState, _options_maxFitToContentHeightRatio;
+    const fit = 'fitToContent' === options.sizeMode;
+    const draggable = false !== options.isDraggable;
+    const cancelable = false !== options.isCancelable;
+    const intercepted = null != options.onBackRequested;
+    if (fit) {
+        var _options_maxFitToContentHeightRatio1;
+        const ratio = clamp(null != (_options_maxFitToContentHeightRatio1 = options.maxFitToContentHeightRatio) ? _options_maxFitToContentHeightRatio1 : 0.75, 0.2, 1);
+        return {
+            snapPoints: [
+                'fit'
+            ],
+            initialSnap: 0,
+            fixed: true,
+            fit: true,
+            showHandle: false,
+            dragDisabled: true,
+            enableDragToClose: false,
+            closeOnOverlayTap: cancelable,
+            fitMaxHeight: Math.max(g9SheetFitMinHeight, Math.floor(hostHeight * ratio)),
+            fullScreen: false
+        };
+    }
+    const order = [
+        'peek',
+        'medium',
+        'large'
+    ];
+    const requested = options.states && options.states.length > 0 ? options.states : [
+        'medium',
+        'large'
+    ];
+    const states = order.filter((d)=>requested.includes(d));
+    const androidHalf = 'android' === platform ? options.androidHalfExpandedRatio : null;
+    const half = clamp(null != (_ref = null != androidHalf ? androidHalf : options.halfExpandedRatio) ? _ref : 0.5, 0.1, 0.9);
+    const full = clamp(null != (_options_fullExpandedRatio = options.fullExpandedRatio) ? _options_fullExpandedRatio : 1, 0.1, 1);
+    const peek = Math.max(1, null != (_ref1 = null != (_options_collapsedHeight = options.collapsedHeight) ? _options_collapsedHeight : options.peekHeight) ? _ref1 : g9SheetDefaultPeekHeight);
+    const snap = (d)=>'peek' === d ? Math.min(peek, Math.max(1, hostHeight)) : 'medium' === d ? pct(half) : pct(full);
+    const snapPoints = states.map(snap);
+    if (options.expandedFitsContent && snapPoints.length > 0) snapPoints[snapPoints.length - 1] = 'fit';
+    const current = null != (_options_currentState = options.currentState) ? _options_currentState : 'medium';
+    const index = states.indexOf(current);
+    const fixed = states.length <= 1;
+    return {
+        snapPoints,
+        initialSnap: index >= 0 ? index : 0,
+        fixed,
+        fit: false,
+        showHandle: false !== options.hasHandle && draggable && !fixed,
+        dragDisabled: !draggable || intercepted,
+        enableDragToClose: cancelable && draggable && !intercepted,
+        closeOnOverlayTap: cancelable,
+        fitMaxHeight: options.expandedFitsContent ? Math.max(g9SheetFitMinHeight, Math.floor(hostHeight * clamp(null != (_options_maxFitToContentHeightRatio = options.maxFitToContentHeightRatio) ? _options_maxFitToContentHeightRatio : 0.75, 0.2, 1))) : null,
+        fullScreen: 1 === states.length && 'large' === states[0] && full >= 1
+    };
+}
+function clampFitHeight(natural, cap, loading) {
+    const min = loading ? g9SheetFitLoadingMinHeight : g9SheetFitMinHeight;
+    if (!(natural > 0)) return Math.min(min, cap);
+    return clamp(natural, Math.min(min, cap), cap);
+}
+function sheetOverlayOpacity(visibleRatio, detentRatios, min, max) {
+    if (0 === detentRatios.length) return max;
+    const lo = Math.min(...detentRatios);
+    const hi = Math.max(...detentRatios);
+    if (visibleRatio < lo) return (1 === detentRatios.length ? max : min) * clamp(visibleRatio / lo, 0, 1);
+    if (hi === lo) return max;
+    return min + (max - min) * clamp((visibleRatio - lo) / (hi - lo), 0, 1);
+}
+function backdropCardTransform(visibleRatio, threshold = 0.75) {
+    const raw = clamp((visibleRatio - threshold) / Math.max(1e-6, 1 - threshold), 0, 1);
+    const progress = raw <= 0 ? 0 : 1 - (1 - raw) ** (1 / 3);
+    return {
+        scale: 1 - 0.07 * progress,
+        translateY: 12 * progress
+    };
+}
+function sheetVisibleRatio(options, hostHeight, restingHeightPx, platform = currentPlatform()) {
+    var _layout_fitMaxHeight;
+    const host = Math.max(1, hostHeight);
+    if (null != restingHeightPx) return clamp(restingHeightPx / host, 0, 1);
+    const layout = resolveSheetLayout(options, host, platform);
+    const point = layout.snapPoints[layout.initialSnap];
+    if ('number' == typeof point) return clamp(point / host, 0, 1);
+    if ('fit' === point || void 0 === point) return (null != (_layout_fitMaxHeight = layout.fitMaxHeight) ? _layout_fitMaxHeight : 0) / host;
+    return clamp(Number.parseFloat(point) / 100, 0, 1);
+}
+function parentRecedeOffset(visibleHeight) {
+    return Math.max(24, 0.25 * visibleHeight);
+}
+function sheetTopPadding(options, topInset) {
+    var _options_additionalTopSafeAreaPadding;
+    if (null != options.topSafeAreaPaddingOverride) return Math.max(0, options.topSafeAreaPaddingOverride);
+    const inset = false === options.useTopSafeAreaPadding ? 0 : Math.max(0, topInset);
+    return inset + g9SheetTopSafeAreaBaseGap + Math.max(0, null != (_options_additionalTopSafeAreaPadding = options.additionalTopSafeAreaPadding) ? _options_additionalTopSafeAreaPadding : 0);
+}
+function scaledSheetDuration(durationMs, traversedRatio, sizeScaled) {
+    if (durationMs <= 0) return 0;
+    if (!sizeScaled) return durationMs;
+    return Math.max(1, Math.round(durationMs * clamp(traversedRatio, 0, 1)));
+}
+function platformSheetConstraints(options, platform = currentPlatform()) {
+    const px = (n)=>`${n}px`;
+    const style = {};
+    if ('android' === platform) {
+        if (null != options.androidMaxWidth) style.maxWidth = px(options.androidMaxWidth);
+        if (null != options.androidMaxHeight) style.maxHeight = px(options.androidMaxHeight);
+        if (options.androidMargin) {
+            const [l, t, r, b] = options.androidMargin;
+            style.margin = `${t}px ${r}px ${b}px ${l}px`;
+        }
+    }
+    if ('windows' === platform) {
+        if (null != options.windowsMaxWidth) style.maxWidth = px(options.windowsMaxWidth);
+        if (null != options.windowsMaxHeight) style.maxHeight = px(options.windowsMaxHeight);
+        if (null != options.windowsMinWidth) style.minWidth = px(options.windowsMinWidth);
+        if (null != options.windowsMinHeight) style.minHeight = px(options.windowsMinHeight);
+    }
+    if ('custom' === options.contentWidthMode) {
+        var _options_contentWidth;
+        style.width = px(null != (_options_contentWidth = options.contentWidth) ? _options_contentWidth : 300);
+        style.alignSelf = 'center';
+    }
+    return style;
+}
+export { backdropCardTransform, clampFitHeight, currentPlatform, g9SheetDefaultPeekHeight, g9SheetDragCloseThreshold, g9SheetFitLoadingMinHeight, g9SheetFitMinHeight, g9SheetTopSafeAreaBaseGap, parentRecedeOffset, platformSheetConstraints, resolveSheetLayout, scaledSheetDuration, sheetOverlayOpacity, sheetTopPadding, sheetVisibleRatio };
+
+//# sourceMappingURL=sizing.jsx.map

package/dist/sheet/sizing.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/sizing.jsx","sources":["../../src/sheet/sizing.ts"],"sourcesContent":["import type { G9SheetDetent, G9SheetOptions } from './options';\n\n// Pure sizing rules of the G9 sheet (MAUI G9SheetView + G9BottomSheetHelper sizing; guide 650–980, ADR-0019/0026).\n\n/** MAUI `G9SheetView.MinimizedHeight`: default peek height. */\nexport const g9SheetDefaultPeekHeight = 100;\n/** Absolute minimum of an authoritative fit height (MAUI helper :81). */\nexport const g9SheetFitMinHeight = 80;\n/** Floor while the height is unknown (loading window). */\nexport const g9SheetFitLoadingMinHeight = 180;\n/** Finger travel at release that requests a close (MAUI `DragCloseThreshold`). */\nexport const g9SheetDragCloseThreshold = 72;\n/** Base gap above full-screen content (MAUI safe-area rule). */\nexport const g9SheetTopSafeAreaBaseGap = 8;\n\nconst clamp = (v: number, lo: number, hi: number) => Math.min(hi, Math.max(lo, v));\n\n/** The platform the app runs on (Lynx `SystemInfo.platform`), lower-cased; `'unknown'` outside Lynx. */\nexport function currentPlatform(): 'android' | 'ios' | 'windows' | 'macos' | 'unknown' {\n  const info = (globalThis as { SystemInfo?: { platform?: string } }).SystemInfo;\n  const p = (info?.platform ?? '').toLowerCase();\n  if (p === 'android') return 'android';\n  if (p === 'ios') return 'ios';\n  if (p.startsWith('win')) return 'windows';\n  if (p === 'macos' || p === 'mac' || p === 'osx') return 'macos';\n  return 'unknown';\n}\n\n/** What the adapter passes to lynx-ui `SheetRoot` and how the frame behaves. */\nexport interface G9SheetLayout {\n  /** lynx-ui snap points, small to large: pixels, `'NN%'` of the host, or `'fit'`. */\n  readonly snapPoints: Array<number | string>;\n  readonly initialSnap: number;\n  /** One detent, or fit-to-content (MAUI \"fixed\"): no grabber, no detent dragging. */\n  readonly fixed: boolean;\n  readonly fit: boolean;\n  /** Grabber visible (`hasHandle && isDraggable && !fixed`). */\n  readonly showHandle: boolean;\n  readonly dragDisabled: boolean;\n  /** Drag past the lowest detent may request a close. */\n  readonly enableDragToClose: boolean;\n  /** Backdrop tap requests a close. */\n  readonly closeOnOverlayTap: boolean;\n  /** The resting body cap for a fit sheet (`maxFitToContentHeightRatio × host`), else `null`. */\n  readonly fitMaxHeight: number | null;\n  /** Whether the sheet's largest detent is full screen. */\n  readonly fullScreen: boolean;\n}\n\nconst pct = (ratio: number) => `${Math.round(ratio * 10000) / 100}%`;\n\n/**\n * Maps G9 options to a lynx-ui layout (the agreed mapping of MAUI `ApplyOptions`): fit → `['fit']` capped at\n * `maxFitToContentHeightRatio`; states → peek pixels / half ratio / full ratio for the allowed detents, the initial\n * detent from `currentState`. The MAUI quirks (a hidden 100 dp detent under `[medium, large]`, a peek-only sheet that\n * may expand) are not carried over: the detents are exactly `states` (docs/sheets.md \"deliberate differences\").\n */\nexport function resolveSheetLayout(\n  options: G9SheetOptions,\n  hostHeight: number,\n  platform = currentPlatform(),\n): G9SheetLayout {\n  const fit = options.sizeMode === 'fitToContent';\n  const draggable = options.isDraggable !== false;\n  const cancelable = options.isCancelable !== false;\n  const intercepted = options.onBackRequested != null;\n  if (fit) {\n    const ratio = clamp(options.maxFitToContentHeightRatio ?? 0.75, 0.2, 1);\n    return {\n      snapPoints: ['fit'],\n      initialSnap: 0,\n      fixed: true,\n      fit: true,\n      showHandle: false,\n      dragDisabled: true,\n      enableDragToClose: false,\n      closeOnOverlayTap: cancelable,\n      fitMaxHeight: Math.max(g9SheetFitMinHeight, Math.floor(hostHeight * ratio)),\n      fullScreen: false,\n    };\n  }\n  const order: G9SheetDetent[] = ['peek', 'medium', 'large'];\n  const requested = options.states && options.states.length > 0 ? options.states : ['medium', 'large'];\n  const states = order.filter((d) => requested.includes(d));\n  const androidHalf = platform === 'android' ? options.androidHalfExpandedRatio : null;\n  const half = clamp(androidHalf ?? options.halfExpandedRatio ?? 0.5, 0.1, 0.9);\n  const full = clamp(options.fullExpandedRatio ?? 1, 0.1, 1);\n  const peek = Math.max(1, options.collapsedHeight ?? options.peekHeight ?? g9SheetDefaultPeekHeight);\n  const snap = (d: G9SheetDetent): number | string =>\n    d === 'peek' ? Math.min(peek, Math.max(1, hostHeight)) : d === 'medium' ? pct(half) : pct(full);\n  const snapPoints = states.map(snap);\n  if (options.expandedFitsContent && snapPoints.length > 0) snapPoints[snapPoints.length - 1] = 'fit';\n  const current = options.currentState ?? 'medium';\n  const index = states.indexOf(current);\n  const fixed = states.length <= 1;\n  return {\n    snapPoints,\n    initialSnap: index >= 0 ? index : 0,\n    fixed,\n    fit: false,\n    showHandle: options.hasHandle !== false && draggable && !fixed,\n    dragDisabled: !draggable || intercepted,\n    enableDragToClose: cancelable && draggable && !intercepted,\n    closeOnOverlayTap: cancelable,\n    fitMaxHeight: options.expandedFitsContent\n      ? Math.max(\n          g9SheetFitMinHeight,\n          Math.floor(hostHeight * clamp(options.maxFitToContentHeightRatio ?? 0.75, 0.2, 1)),\n        )\n      : null,\n    fullScreen: states.length === 1 && states[0] === 'large' && full >= 1,\n  };\n}\n\n/** Clamps a measured fit body height: `[80, cap]`, or `[180, cap]` while loading (MAUI fit engine). */\nexport function clampFitHeight(natural: number, cap: number, loading: boolean): number {\n  const min = loading ? g9SheetFitLoadingMinHeight : g9SheetFitMinHeight;\n  if (!(natural > 0)) return Math.min(min, cap);\n  return clamp(natural, Math.min(min, cap), cap);\n}\n\n/**\n * Scrim opacity for a visible ratio (MAUI helper overlay rule): between the smallest and the largest detent it runs\n * from `min` to `max`; a single detent uses `max`; below the smallest detent it fades with the ratio.\n */\nexport function sheetOverlayOpacity(\n  visibleRatio: number,\n  detentRatios: ReadonlyArray<number>,\n  min: number,\n  max: number,\n): number {\n  if (detentRatios.length === 0) return max;\n  const lo = Math.min(...detentRatios);\n  const hi = Math.max(...detentRatios);\n  if (visibleRatio < lo) return (detentRatios.length === 1 ? max : min) * clamp(visibleRatio / lo, 0, 1);\n  if (hi === lo) return max;\n  return min + (max - min) * clamp((visibleRatio - lo) / (hi - lo), 0, 1);\n}\n\n/** The page recede behind a tall primary sheet (MAUI backdrop card): scale 1 → 0.93, translateY 0 → 12. */\nexport function backdropCardTransform(visibleRatio: number, threshold = 0.75): { scale: number; translateY: number } {\n  const raw = clamp((visibleRatio - threshold) / Math.max(1e-6, 1 - threshold), 0, 1);\n  const progress = raw <= 0 ? 0 : 1 - (1 - raw) ** (1 / 3);\n  return { scale: 1 - 0.07 * progress, translateY: 12 * progress };\n}\n\n/**\n * The visible share of the host a detent sheet covers: its resting height when known, else its opening detent\n * (peek = peek height, medium = half ratio, large = full ratio; `expandedFitsContent` large counts as the fit cap).\n */\nexport function sheetVisibleRatio(\n  options: G9SheetOptions,\n  hostHeight: number,\n  restingHeightPx: number | null,\n  platform = currentPlatform(),\n): number {\n  const host = Math.max(1, hostHeight);\n  if (restingHeightPx != null) return clamp(restingHeightPx / host, 0, 1);\n  const layout = resolveSheetLayout(options, host, platform);\n  const point = layout.snapPoints[layout.initialSnap];\n  if (typeof point === 'number') return clamp(point / host, 0, 1);\n  if (point === 'fit' || point === undefined) return (layout.fitMaxHeight ?? 0) / host;\n  return clamp(Number.parseFloat(point) / 100, 0, 1);\n}\n\n/** How far a receded parent sheet sinks: `max(24, visible × 0.25)` (MAUI stack recede). */\nexport function parentRecedeOffset(visibleHeight: number): number {\n  return Math.max(24, visibleHeight * 0.25);\n}\n\n/** Top padding of a full-screen sheet (MAUI safe-area rule). */\nexport function sheetTopPadding(options: G9SheetOptions, topInset: number): number {\n  if (options.topSafeAreaPaddingOverride != null) return Math.max(0, options.topSafeAreaPaddingOverride);\n  const inset = options.useTopSafeAreaPadding === false ? 0 : Math.max(0, topInset);\n  return inset + g9SheetTopSafeAreaBaseGap + Math.max(0, options.additionalTopSafeAreaPadding ?? 0);\n}\n\n/**\n * Size-scaled animation duration (MAUI `SizeScaledAnimationDuration`): a partial traversal takes the matching slice\n * of the full duration (at least 1 ms unless the duration is 0).\n */\nexport function scaledSheetDuration(durationMs: number, traversedRatio: number, sizeScaled: boolean): number {\n  if (durationMs <= 0) return 0;\n  if (!sizeScaled) return durationMs;\n  return Math.max(1, Math.round(durationMs * clamp(traversedRatio, 0, 1)));\n}\n\n/** Platform size constraints of the sheet surface (MAUI Android/Windows options, applied where they belong). */\nexport function platformSheetConstraints(\n  options: G9SheetOptions,\n  platform = currentPlatform(),\n): Record<string, string> {\n  const px = (n: number) => `${n}px`;\n  const style: Record<string, string> = {};\n  if (platform === 'android') {\n    if (options.androidMaxWidth != null) style.maxWidth = px(options.androidMaxWidth);\n    if (options.androidMaxHeight != null) style.maxHeight = px(options.androidMaxHeight);\n    if (options.androidMargin) {\n      const [l, t, r, b] = options.androidMargin;\n      style.margin = `${t}px ${r}px ${b}px ${l}px`;\n    }\n  }\n  if (platform === 'windows') {\n    if (options.windowsMaxWidth != null) style.maxWidth = px(options.windowsMaxWidth);\n    if (options.windowsMaxHeight != null) style.maxHeight = px(options.windowsMaxHeight);\n    if (options.windowsMinWidth != null) style.minWidth = px(options.windowsMinWidth);\n    if (options.windowsMinHeight != null) style.minHeight = px(options.windowsMinHeight);\n  }\n  if (options.contentWidthMode === 'custom') {\n    style.width = px(options.contentWidth ?? 300);\n    style.alignSelf = 'center';\n  }\n  return style;\n}\n"],"names":["g9SheetDefaultPeekHeight","g9SheetFitMinHeight","g9SheetFitLoadingMinHeight","g9SheetDragCloseThreshold","g9SheetTopSafeAreaBaseGap","clamp","v","lo","hi","Math","currentPlatform","info","globalThis","p","pct","ratio","resolveSheetLayout","options","hostHeight","platform","_ref","_options_fullExpandedRatio","_ref1","_options_currentState","_options_maxFitToContentHeightRatio","fit","draggable","cancelable","intercepted","_options_maxFitToContentHeightRatio1","order","requested","states","d","androidHalf","half","full","peek","snap","snapPoints","current","index","fixed","clampFitHeight","natural","cap","loading","min","sheetOverlayOpacity","visibleRatio","detentRatios","max","backdropCardTransform","threshold","raw","progress","sheetVisibleRatio","restingHeightPx","_layout_fitMaxHeight","host","layout","point","undefined","Number","parentRecedeOffset","visibleHeight","sheetTopPadding","topInset","_options_additionalTopSafeAreaPadding","inset","scaledSheetDuration","durationMs","traversedRatio","sizeScaled","platformSheetConstraints","px","n","style","l","t","r","b","_options_contentWidth"],"mappings":"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"}

package/dist/sheet/stack.d.ts

@@ -0,0 +1,161 @@
+import type { ReactNode } from '@lynx-js/react';
+import type { G9SheetBackSource, G9SheetOptions } from './options.js';
+/** Why a sheet's result settled. Every sheet settles exactly once. */
+export type G9SheetCloseReason = 
+/** `handle.close()` / `closeAsync()`. */
+'closed'
+/** `closeAll()` (MAUI `CloseG9BottomSheet`). */
+ | 'closeAll'
+/** The header back/close button or `closeTop()`. */
+ | 'toolbarButton'
+/** Hardware back / desktop Escape. */
+ | 'hardwareButton'
+/** A tap on the scrim. */
+ | 'overlayTap'
+/** Dragged closed. */
+ | 'drag'
+/** Replaced in place or handed off to a successor. */
+ | 'replaced'
+/** A queued request displaced by a newer one before it opened. */
+ | 'displaced'
+/** The host unmounted. */
+ | 'unmount';
+/** The result of one sheet. */
+export interface G9SheetResult {
+    readonly reason: G9SheetCloseReason;
+}
+/** What a sheet shows: a node, or a factory built after the open motion (deferred content). */
+export type G9SheetContent = ReactNode | (() => ReactNode);
+/** Lifecycle status of an entry. */
+export type G9SheetStatus = 'queued' | 'opening' | 'open' | 'closing' | 'closed';
+/** One sheet of the stack (read-only snapshot for rendering). */
+export interface G9SheetEntry {
+    readonly id: number;
+    /** Identity of the rendered frame; kept by an in-place replace. */
+    readonly frameKey: number;
+    readonly content: G9SheetContent;
+    readonly options: G9SheetOptions;
+    readonly status: G9SheetStatus;
+    /** Bumped by an in-place replace (the frame cross-fades its body). */
+    readonly version: number;
+    /** The sheet above this one recedes it. */
+    readonly receded: boolean;
+    /** Close motion runs at half duration (replace fallback). */
+    readonly quickClose: boolean;
+    /** The entry is handing its dim to a successor (its scrim is transparent). */
+    readonly handingOff: boolean;
+    /** Closing without a visible motion (whole-stack teardown keeps recede links static). */
+    readonly reason: G9SheetCloseReason | null;
+}
+/** A handle to one sheet (MAUI `IG9BottomSheetHandle`, sheet-scoped). */
+export interface G9SheetHandle {
+    readonly id: number;
+    /** Settles once with the close reason, after the sheet left the screen. */
+    readonly result: Promise<G9SheetResult>;
+    /** `true` until the sheet started closing. */
+    readonly isOpen: boolean;
+    /** Closes this sheet (MAUI owned-handle `Close`). */
+    close(): void;
+    /** Closes this sheet and resolves when it is gone (MAUI `CloseAsync`). */
+    closeAsync(): Promise<void>;
+    /** Opens another sheet on top (MAUI `Show`, auto-stacking). */
+    show(content: G9SheetContent, options?: G9SheetOptions): G9SheetHandle | null;
+    /** Back-routes the top sheet (MAUI `CloseTop`). */
+    closeTop(): void;
+}
+/** Timing and policy the stack needs from its host. */
+export interface G9SheetStackConfig {
+    /** Monotonic ms. */
+    now(): number;
+    setTimer(callback: () => void, ms: number): unknown;
+    clearTimer(handle: unknown): void;
+    /** Open/close durations (ms) for an entry's fallback timers. */
+    durations(options: G9SheetOptions): {
+        open: number;
+        close: number;
+    };
+    /** Hand-off needs the staged pipeline (`settings.stageBeforeShow`). */
+    stageBeforeShow(): boolean;
+    /**
+     * Longest a hand-off waits for its successor to report open before the predecessor closes anyway (ms; MAUI
+     * `PreOpenMaxHoldMs`). Default: only the successor's open fallback timer bounds it.
+     */
+    preOpenMaxHoldMs?(): number;
+    /** A lifecycle callback threw. */
+    onError?(error: unknown): void;
+}
+/** MAUI `G9SafeCommand` throttle window shared by show and replace. */
+export declare const g9SheetShowThrottleMs = 369;
+/** Grace after the close motion before cleanup (MAUI page-side reset). */
+export declare const g9SheetCloseGraceMs = 48;
+/** The stack of one host. */
+export declare class G9SheetStack {
+    private readonly config;
+    private entries;
+    private pending;
+    private lastShow;
+    private nextId;
+    private readonly listeners;
+    private snapshot;
+    private disposed;
+    constructor(config: G9SheetStackConfig);
+    /** Entries bottom first (closing ones included until removed). The same array until something changes. */
+    getSnapshot(): ReadonlyArray<G9SheetEntry>;
+    subscribe(listener: () => void): () => void;
+    /** Open sheets (MAUI `GetOpenSheetCount`): not closing, not queued. */
+    openCount(): number;
+    /** The top open sheet, or `null`. */
+    top(): G9SheetEntry | null;
+    /**
+     * Shows a sheet (MAUI `ShowG9BottomSheet`): stacks on an open sheet, hands off with `replaceCurrentSheet`, queues
+     * behind a closing primary (one pending request; a newer one displaces it), else opens as primary. Returns `null`
+     * when throttled (a second show/replace within 369 ms).
+     */
+    show(content: G9SheetContent, options?: G9SheetOptions, throttle?: boolean): G9SheetHandle | null;
+    /**
+     * Replaces the open sheet (MAUI `ReplaceG9BottomSheet`): in place (same frame, body cross-fade, old lifecycle not
+     * run) when one fit, modal sheet is open and the new one is fit and modal without a full-screen placeholder;
+     * otherwise the top sheet quick-closes through its back route and the new one opens. Throttled like `show`.
+     */
+    replace(content: G9SheetContent, options?: G9SheetOptions): G9SheetHandle | null;
+    /** Back-routes the top sheet as the toolbar button would (MAUI `CloseTopG9BottomSheet`). */
+    closeTop(): void;
+    /** Closes every sheet, stacked ones first (MAUI `CloseG9BottomSheet`). */
+    closeAll(): void;
+    /** Hardware back (MAUI `HandleHardwareBackPressed`): `false` when no sheet is open, else routes it and `true`. */
+    handleHardwareBack(): boolean;
+    /**
+     * A back request for one sheet (MAUI `HandleBackRequest`): an overlay tap on a non-cancelable sheet is ignored;
+     * `onBackRequested` decides when set; otherwise hardware back closes only with `hardwareBackCloses`, every other
+     * source closes. Resolves `true` when the sheet closes.
+     */
+    requestBack(id: number, source: G9SheetBackSource): Promise<boolean>;
+    /** Updates the content (and options) of an open sheet in place, without any transition (declarative sheets). */
+    update(id: number, content: G9SheetContent, options?: G9SheetOptions): void;
+    /** Closes one sheet (owned handle `Close`). */
+    close(id: number, reason?: G9SheetCloseReason): boolean;
+    /** The frame finished its open motion. */
+    markOpened(id: number): void;
+    /** The frame finished its close motion. */
+    markClosed(id: number): void;
+    /** Host unmount: every sheet settles with `'unmount'`; nothing opens afterwards. */
+    dispose(): void;
+    private live;
+    private passThrottle;
+    private create;
+    private push;
+    private isFullScreen;
+    private beginClose;
+    /** Quick close of an entry already closing: its removal comes at half the close duration from now. */
+    private hurry;
+    private restoreParent;
+    private remove;
+    private finish;
+    private clearTimer;
+    private safe;
+    private view;
+    private emit;
+    /** The handle of an entry (frames inject it into their content). */
+    handleOf(id: number): G9SheetHandle | null;
+}
+//# sourceMappingURL=stack.d.ts.map

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

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