@g9tm/lynxcontrols 0.0.0-stage → 1.4.0

package/dist/sheet/frame.jsx

@@ -0,0 +1,205 @@
+import "./sheet.css";
+import { createAbortController, formatColor, tryParseColor, withAlpha } from "@g9tm/lynxcontrols-foundation";
+import { SheetContent, SheetHandle, SheetRoot, SheetView } from "@lynx-js/lynx-ui-sheet";
+import { createContext, useContext, useEffect, useRef, useState } from "@lynx-js/react";
+import { startTimer, stopTimer } from "../base/timers.jsx";
+import { G9ActivityIndicator } from "../display/activity-indicator.jsx";
+import { G9SheetSkeleton } from "../display/shimmer.jsx";
+import { G9SheetFooter, G9SheetHeader, g9SheetHeaderMetrics } from "./header.jsx";
+import { clampFitHeight, currentPlatform, g9SheetDragCloseThreshold, g9SheetFitLoadingMinHeight, parentRecedeOffset, platformSheetConstraints, resolveSheetLayout, scaledSheetDuration, sheetOverlayOpacity, sheetTopPadding } from "./sizing.jsx";
+const SheetContext = createContext(null);
+function useG9SheetContext() {
+    return useContext(SheetContext);
+}
+function scrimColor(entry, settings, opacity) {
+    const explicit = entry.options.windowBackgroundColor;
+    const parsed = tryParseColor(null != explicit ? explicit : settings.modalOverlayColor);
+    if (!parsed) return null != explicit ? explicit : settings.modalOverlayColor;
+    return formatColor(withAlpha(parsed, explicit ? parsed.a : opacity));
+}
+function G9SheetFrame(props) {
+    var _ref, _o_deferredLoadingPlaceholderHeight, _o_loadingSkeletonRowCount, _ratios_layout_initialSnap, _o_openAnimationDurationMs, _o_closeAnimationDurationMs, _o_cornerRadius, _o_backgroundColor, _o_padding;
+    var _props_memo;
+    const { entry, stack, settings } = props;
+    const o = entry.options;
+    const layout = resolveSheetLayout(o, props.hostHeight);
+    const showing = 'opening' === entry.status || 'open' === entry.status;
+    const closing = 'closing' === entry.status;
+    const handle = stack.handleOf(entry.id);
+    const controller = useRef(null);
+    if (null === controller.current) controller.current = createAbortController();
+    useEffect(()=>{
+        var _controller_current;
+        if (closing || 'closed' === entry.status) null == (_controller_current = controller.current) || _controller_current.abort();
+    }, [
+        closing,
+        entry.status
+    ]);
+    useEffect(()=>()=>{
+            var _controller_current;
+            return null == (_controller_current = controller.current) ? void 0 : _controller_current.abort();
+        }, []);
+    const factory = 'function' == typeof entry.content;
+    const deferred = (factory || settings.deferPrebuiltContent) && false !== o.deferContent;
+    const [revealed, setRevealed] = useState(!deferred);
+    const [covering, setCovering] = useState(false);
+    const timer = useRef(null);
+    const coverTimer = useRef(null);
+    useEffect(()=>()=>{
+            if (null !== coverTimer.current) stopTimer(coverTimer.current);
+        }, []);
+    useEffect(()=>{
+        var _o_loadDelayMs, _o_loadDelayMs1;
+        if (!deferred || revealed || 'open' !== entry.status) return;
+        const delay = layout.fullScreen ? Math.max(null != (_o_loadDelayMs = o.loadDelayMs) ? _o_loadDelayMs : 369, settings.openAnimationDurationMs + 32) : null != (_o_loadDelayMs1 = o.loadDelayMs) ? _o_loadDelayMs1 : 369;
+        timer.current = startTimer(()=>{
+            setRevealed(true);
+            if (false !== o.fadeDeferredContentIn) {
+                setCovering(true);
+                coverTimer.current = startTimer(()=>setCovering(false), 220);
+            }
+        }, delay);
+        return ()=>{
+            if (null !== timer.current) stopTimer(timer.current);
+        };
+    }, [
+        deferred,
+        revealed,
+        entry.status
+    ]);
+    const memoKey = o.heightMemoKey ? `${o.heightMemoKey}|w${Math.round(props.hostWidth)}|${props.culture}|fs1` : null;
+    const placeholderHeight = o.useFullScreenLoadingPlaceholder ? props.hostHeight : null != (_ref = null != (_o_deferredLoadingPlaceholderHeight = o.deferredLoadingPlaceholderHeight) ? _o_deferredLoadingPlaceholderHeight : memoKey ? null == (_props_memo = props.memo) ? void 0 : _props_memo.lookup(memoKey) : void 0) ? _ref : g9SheetFitLoadingMinHeight;
+    const [bodyHeight, setBodyHeight] = useState(0);
+    const onBodyLayout = (e)=>{
+        var _ref;
+        var _e_detail, _props_memo;
+        const h = null != (_ref = null == (_e_detail = e.detail) ? void 0 : _e_detail.height) ? _ref : 0;
+        if (h <= 0) return;
+        setBodyHeight(h);
+        if (memoKey && revealed && !covering) null == (_props_memo = props.memo) || _props_memo.record(memoKey, h);
+    };
+    const placeholder = o.loadingSkeleton && 'none' !== o.loadingSkeleton ? <view className="g9-sheet__placeholder" style={{
+        height: `${placeholderHeight}px`
+    }}>
+        <G9SheetSkeleton skeleton={o.loadingSkeleton} rowCount={null != (_o_loadingSkeletonRowCount = o.loadingSkeletonRowCount) ? _o_loadingSkeletonRowCount : 0}/>
+      </view> : <view className="g9-sheet__placeholder g9-sheet__placeholder--spinner" style={{
+        height: `${placeholderHeight}px`
+    }}>
+        <G9ActivityIndicator running size={32}/>
+      </view>;
+    const body = revealed ? factory ? entry.content() : entry.content : null;
+    const maxBody = layout.fitMaxHeight;
+    const contextValue = {
+        handle,
+        signal: controller.current.signal,
+        opened: 'open' === entry.status,
+        closing,
+        maxBodyHeight: maxBody
+    };
+    const ratios = layout.snapPoints.map((p)=>'number' == typeof p ? p / Math.max(1, props.hostHeight) : 'fit' === p ? 0.5 : Number.parseFloat(p) / 100);
+    const restingRatio = null != (_ratios_layout_initialSnap = ratios[layout.initialSnap]) ? _ratios_layout_initialSnap : 1;
+    const opacity = entry.handingOff ? 0 : sheetOverlayOpacity(restingRatio, ratios, settings.modalOverlayMinimumOpacity, settings.modalOverlayMaximumOpacity);
+    const modal = false !== o.isModal;
+    const recede = entry.receded ? {
+        transform: `translateY(${parentRecedeOffset(bodyHeight || 0.5 * props.hostHeight)}px)`,
+        opacity: 0
+    } : {
+        transform: 'translateY(0px)',
+        opacity: 1
+    };
+    const topPadding = layout.fullScreen ? sheetTopPadding(o, props.topInset) : 0;
+    const platform = currentPlatform();
+    const openMs = null != (_o_openAnimationDurationMs = o.openAnimationDurationMs) ? _o_openAnimationDurationMs : settings.openAnimationDurationMs;
+    const closeMs = null != (_o_closeAnimationDurationMs = o.closeAnimationDurationMs) ? _o_closeAnimationDurationMs : settings.closeAnimationDurationMs;
+    const corner = 'android' === platform && true === o.androidShouldRemoveExpandedCorners && layout.fullScreen ? 0 : null != (_o_cornerRadius = o.cornerRadius) ? _o_cornerRadius : 12;
+    const easeOut = (t)=>1 - (1 - t) ** 3;
+    const timed = 'timed' === settings.motionStyle || null != o.openAnimationDurationMs || null != o.closeAnimationDurationMs;
+    const enterMs = scaledSheetDuration(openMs, restingRatio, settings.sizeScaledAnimationDuration);
+    const exitMs = scaledSheetDuration(closeMs, restingRatio, settings.sizeScaledAnimationDuration);
+    const motion = timed ? {
+        enterAnimation: {
+            type: 'tween',
+            duration: enterMs / 1000,
+            ease: easeOut
+        },
+        exitAnimation: {
+            type: 'tween',
+            duration: exitMs / 1000,
+            ease: easeOut
+        },
+        snapAnimation: {
+            type: 'tween',
+            duration: openMs / 1000,
+            ease: easeOut
+        }
+    } : {};
+    return <SheetRoot show={showing} snapPoints={layout.snapPoints} initialSnap={layout.initialSnap} screenHeight={props.hostHeight} dragDisabled={layout.dragDisabled} enableDragToClose={layout.enableDragToClose} dismissThreshold={g9SheetDragCloseThreshold} handleOnly={false === o.scrollingExpandsSheet} onShowChange={(open)=>{
+        if (!open) stack.requestBack(entry.id, 'drag');
+    }} onSnapChange={(index, value)=>{
+        var _ordered_index;
+        var _props_onRest, _o_onStateChanged;
+        const detents = (o.states && o.states.length > 0 ? o.states : [
+            'medium',
+            'large'
+        ]).filter((d)=>d);
+        const ordered = [
+            'peek',
+            'medium',
+            'large'
+        ].filter((d)=>detents.includes(d));
+        null == (_props_onRest = props.onRest) || _props_onRest.call(props, value);
+        null == (_o_onStateChanged = o.onStateChanged) || _o_onStateChanged.call(o, layout.fit ? 'fit' : null != (_ordered_index = ordered[index]) ? _ordered_index : 'large', value);
+    }} onOpen={()=>stack.markOpened(entry.id)} onClose={()=>stack.markClosed(entry.id)}>
+      {}
+      <SheetView className="g9-sheet__view" nativeProps={{
+        'event-through': true
+    }}>
+        {modal ? <view event-through={false} className={`g9-sheet__scrim${props.isTop && !closing ? '' : ' g9-sheet__scrim--covered'}`} style={{
+        backgroundColor: scrimColor(entry, settings, opacity),
+        transition: 'ios' === platform && false === o.animateOverlayToColorOnIos ? 'none' : `background-color ${closing ? closeMs : openMs}ms`
+    }} bindtap={()=>{
+        if (layout.closeOnOverlayTap) stack.requestBack(entry.id, 'overlayTap');
+    }}/> : null}
+        <SheetContent className={`g9-sheet g9-sheet--${entry.status}${layout.fit ? ' g9-sheet--fit' : ''}`} style={{
+        backgroundColor: null != (_o_backgroundColor = o.backgroundColor) ? _o_backgroundColor : 'var(--g9-surface-container)',
+        borderTopLeftRadius: `${corner}px`,
+        borderTopRightRadius: `${corner}px`,
+        transition: 'transform 220ms ease-out, opacity 220ms ease-out',
+        ...recede,
+        ...platformSheetConstraints(o)
+    }} innerStyle={{
+        paddingTop: `${topPadding}px`
+    }} {...motion}>
+          <SheetContext.Provider value={contextValue}>
+            {layout.showHandle || layout.fullScreen && o.showToolbar && false !== o.showFullScreenDragHandle && !layout.dragDisabled ? <SheetHandle className="g9-sheet__grabber-area">
+                <view className="g9-sheet__grabber"/>
+              </SheetHandle> : null}
+            <G9SheetHeader options={o} onBack={()=>void stack.requestBack(entry.id, 'toolbarButton')}/>
+            {o.showToolbar && false !== o.useStandardBodyTopGap ? <view className="g9-sheet__body-gap" style={{
+        height: `${g9SheetHeaderMetrics.bodyTopGap}px`
+    }}/> : null}
+            <scroll-view className={`g9-sheet__body${layout.fullScreen ? ' g9-sheet__body--fill' : ''}`} scroll-orientation="vertical" style={{
+        padding: `${null != (_o_padding = o.padding) ? _o_padding : 0}px`,
+        ...null !== maxBody ? {
+            maxHeight: `${maxBody}px`
+        } : {}
+    }}>
+              <view className="g9-sheet__content" key={entry.version} bindlayoutchange={onBodyLayout}>
+                {body}
+                {!revealed ? placeholder : null}
+                {covering ? <view className="g9-sheet__cover" style={{
+        height: `${clampFitHeight(placeholderHeight, props.hostHeight, true)}px`
+    }}>
+                    {placeholder}
+                  </view> : null}
+              </view>
+            </scroll-view>
+            <G9SheetFooter options={o}/>
+          </SheetContext.Provider>
+        </SheetContent>
+      </SheetView>
+    </SheetRoot>;
+}
+export { G9SheetFrame, useG9SheetContext };
+
+//# sourceMappingURL=frame.jsx.map

package/dist/sheet/frame.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/frame.jsx","sources":["../../src/sheet/frame.tsx"],"sourcesContent":["import './sheet.css';\nimport {\n  createAbortController,\n  formatColor,\n  type G9AbortController,\n  type G9AbortSignal,\n  tryParseColor,\n  withAlpha,\n} from '@g9tm/lynxcontrols-foundation';\nimport { SheetContent, SheetHandle, SheetRoot, SheetView } from '@lynx-js/lynx-ui-sheet';\nimport { createContext, type ReactNode, useContext, useEffect, useRef, useState } from '@lynx-js/react';\nimport { type G9TimerHandle, startTimer, stopTimer } from '../base/timers';\nimport { G9ActivityIndicator } from '../display/activity-indicator';\nimport { G9SheetSkeleton } from '../display/shimmer';\nimport { G9SheetFooter, G9SheetHeader, g9SheetHeaderMetrics } from './header';\nimport type { G9SheetHeightMemo } from './height-memo';\nimport type { G9SheetSettings } from './options';\nimport {\n  clampFitHeight,\n  currentPlatform,\n  g9SheetDragCloseThreshold,\n  g9SheetFitLoadingMinHeight,\n  parentRecedeOffset,\n  platformSheetConstraints,\n  resolveSheetLayout,\n  scaledSheetDuration,\n  sheetOverlayOpacity,\n  sheetTopPadding,\n} from './sizing';\nimport type { G9SheetEntry, G9SheetHandle, G9SheetStack } from './stack';\n\n/** What content inside a sheet can read (MAUI `IG9BottomSheetAwareView` + deferred load signals). */\nexport interface G9SheetContextValue {\n  /** The sheet-scoped handle: `close()` closes only this sheet. */\n  readonly handle: G9SheetHandle;\n  /** Aborted when the sheet starts closing (cancel loads with it). */\n  readonly signal: G9AbortSignal;\n  /** The open motion has finished. */\n  readonly opened: boolean;\n  /** The sheet is closing. */\n  readonly closing: boolean;\n  /** Resting body cap of a fit sheet (px), else `null`. */\n  readonly maxBodyHeight: number | null;\n}\n\nconst SheetContext = createContext<G9SheetContextValue | null>(null);\n\n/** The enclosing sheet, or `null` outside one. */\nexport function useG9SheetContext(): G9SheetContextValue | null {\n  return useContext(SheetContext);\n}\n\n/** Props of {@link G9SheetFrame}. */\nexport interface G9SheetFrameProps {\n  readonly entry: G9SheetEntry;\n  readonly stack: G9SheetStack;\n  /** Host height (px): percentage detents and caps resolve against it. */\n  readonly hostHeight: number;\n  readonly hostWidth: number;\n  readonly topInset: number;\n  readonly settings: Required<G9SheetSettings>;\n  readonly memo: G9SheetHeightMemo | null;\n  /** Culture tag of the memo key. */\n  readonly culture: string;\n  /** The sheet is the top of the stack (receives scrim input). */\n  readonly isTop: boolean;\n  /** The sheet came to rest at a new height (px); drives the page recede threshold. */\n  readonly onRest?: (heightPx: number) => void;\n}\n\nfunction scrimColor(entry: G9SheetEntry, settings: Required<G9SheetSettings>, opacity: number): string {\n  const explicit = entry.options.windowBackgroundColor;\n  const parsed = tryParseColor(explicit ?? settings.modalOverlayColor);\n  if (!parsed) return explicit ?? settings.modalOverlayColor;\n  return formatColor(withAlpha(parsed, explicit ? parsed.a : opacity));\n}\n\n/**\n * One sheet of the stack on lynx-ui `SheetRoot` (motion, drag, snap points from lynx-ui; G9 adds detent mapping,\n * scrim, header/footer, deferred content, recede and results). Rendered by the sheet service in the host's sheets\n * layer; use `useG9Sheets()` to open sheets.\n */\nexport function G9SheetFrame(props: G9SheetFrameProps): ReactNode {\n  const { entry, stack, settings } = props;\n  const o = entry.options;\n  const layout = resolveSheetLayout(o, props.hostHeight);\n  const showing = entry.status === 'opening' || entry.status === 'open';\n  const closing = entry.status === 'closing';\n  const handle = stack.handleOf(entry.id) as G9SheetHandle;\n\n  const controller = useRef<G9AbortController | null>(null);\n  if (controller.current === null) controller.current = createAbortController();\n  useEffect(() => {\n    if (closing || entry.status === 'closed') controller.current?.abort();\n  }, [closing, entry.status]);\n  useEffect(() => () => controller.current?.abort(), []);\n\n  // Deferred (factory) content: placeholder until the open motion ended + loadDelayMs, then the body.\n  const factory = typeof entry.content === 'function';\n  const deferred = (factory || settings.deferPrebuiltContent) && o.deferContent !== false;\n  const [revealed, setRevealed] = useState(!deferred);\n  const [covering, setCovering] = useState(false);\n  const timer = useRef<G9TimerHandle | null>(null);\n  const coverTimer = useRef<G9TimerHandle | null>(null);\n  useEffect(\n    () => () => {\n      if (coverTimer.current !== null) stopTimer(coverTimer.current);\n    },\n    [],\n  );\n  useEffect(() => {\n    if (!deferred || revealed || entry.status !== 'open') return;\n    const delay = layout.fullScreen\n      ? Math.max(o.loadDelayMs ?? 369, settings.openAnimationDurationMs + 32)\n      : (o.loadDelayMs ?? 369);\n    timer.current = startTimer(() => {\n      setRevealed(true);\n      if (o.fadeDeferredContentIn !== false) {\n        setCovering(true);\n        coverTimer.current = startTimer(() => setCovering(false), 220);\n      }\n    }, delay);\n    return () => {\n      if (timer.current !== null) stopTimer(timer.current);\n    };\n  }, [deferred, revealed, entry.status]);\n\n  const memoKey = o.heightMemoKey ? `${o.heightMemoKey}|w${Math.round(props.hostWidth)}|${props.culture}|fs1` : null;\n  const placeholderHeight = o.useFullScreenLoadingPlaceholder\n    ? props.hostHeight\n    : (o.deferredLoadingPlaceholderHeight ??\n      (memoKey ? props.memo?.lookup(memoKey) : undefined) ??\n      g9SheetFitLoadingMinHeight);\n\n  const [bodyHeight, setBodyHeight] = useState(0);\n  const onBodyLayout = (e: { detail?: { height?: number } }) => {\n    const h = e.detail?.height ?? 0;\n    if (h <= 0) return;\n    setBodyHeight(h);\n    if (memoKey && revealed && !covering) props.memo?.record(memoKey, h);\n  };\n\n  const placeholder =\n    o.loadingSkeleton && o.loadingSkeleton !== 'none' ? (\n      <view className=\"g9-sheet__placeholder\" style={{ height: `${placeholderHeight}px` }}>\n        <G9SheetSkeleton skeleton={o.loadingSkeleton} rowCount={o.loadingSkeletonRowCount ?? 0} />\n      </view>\n    ) : (\n      <view\n        className=\"g9-sheet__placeholder g9-sheet__placeholder--spinner\"\n        style={{ height: `${placeholderHeight}px` }}\n      >\n        <G9ActivityIndicator running size={32} />\n      </view>\n    );\n  const body = revealed ? (factory ? (entry.content as () => ReactNode)() : (entry.content as ReactNode)) : null;\n\n  const maxBody = layout.fitMaxHeight;\n  const contextValue: G9SheetContextValue = {\n    handle,\n    signal: (controller.current as G9AbortController).signal,\n    opened: entry.status === 'open',\n    closing,\n    maxBodyHeight: maxBody,\n  };\n\n  // Scrim: the resting dim of the detent (one detent → max; several → interpolated at the initial detent).\n  const ratios = layout.snapPoints.map((p) =>\n    typeof p === 'number' ? p / Math.max(1, props.hostHeight) : p === 'fit' ? 0.5 : Number.parseFloat(p) / 100,\n  );\n  const restingRatio = ratios[layout.initialSnap] ?? 1;\n  const opacity = entry.handingOff\n    ? 0\n    : sheetOverlayOpacity(\n        restingRatio,\n        ratios,\n        settings.modalOverlayMinimumOpacity,\n        settings.modalOverlayMaximumOpacity,\n      );\n  const modal = o.isModal !== false;\n  const recede = entry.receded\n    ? { transform: `translateY(${parentRecedeOffset(bodyHeight || props.hostHeight * 0.5)}px)`, opacity: 0 }\n    : { transform: 'translateY(0px)', opacity: 1 };\n  const topPadding = layout.fullScreen ? sheetTopPadding(o, props.topInset) : 0;\n  const platform = currentPlatform();\n  const openMs = o.openAnimationDurationMs ?? settings.openAnimationDurationMs;\n  const closeMs = o.closeAnimationDurationMs ?? settings.closeAnimationDurationMs;\n  const corner =\n    platform === 'android' && o.androidShouldRemoveExpandedCorners === true && layout.fullScreen\n      ? 0\n      : (o.cornerRadius ?? 12);\n  // Motion: lynx-ui's native spring by default; tweens of the configured durations for the timed style or a per-sheet\n  // duration (MAUI `MotionStyle.Timed`, `Open/CloseAnimationDurationMs`).\n  const easeOut = (t: number) => 1 - (1 - t) ** 3;\n  const timed =\n    settings.motionStyle === 'timed' || o.openAnimationDurationMs != null || o.closeAnimationDurationMs != null;\n  // Size-scaled: a sheet resting below full height travels (and takes) the matching slice of the duration.\n  const enterMs = scaledSheetDuration(openMs, restingRatio, settings.sizeScaledAnimationDuration);\n  const exitMs = scaledSheetDuration(closeMs, restingRatio, settings.sizeScaledAnimationDuration);\n  const motion = timed\n    ? {\n        enterAnimation: { type: 'tween' as const, duration: enterMs / 1000, ease: easeOut },\n        exitAnimation: { type: 'tween' as const, duration: exitMs / 1000, ease: easeOut },\n        snapAnimation: { type: 'tween' as const, duration: openMs / 1000, ease: easeOut },\n      }\n    : {};\n  return (\n    <SheetRoot\n      show={showing}\n      snapPoints={layout.snapPoints}\n      initialSnap={layout.initialSnap}\n      screenHeight={props.hostHeight}\n      dragDisabled={layout.dragDisabled}\n      enableDragToClose={layout.enableDragToClose}\n      dismissThreshold={g9SheetDragCloseThreshold}\n      handleOnly={o.scrollingExpandsSheet === false}\n      onShowChange={(open) => {\n        if (!open) void stack.requestBack(entry.id, 'drag');\n      }}\n      onSnapChange={(index, value) => {\n        const detents = (o.states && o.states.length > 0 ? o.states : ['medium', 'large']).filter((d) => d);\n        const ordered = (['peek', 'medium', 'large'] as const).filter((d) => detents.includes(d));\n        props.onRest?.(value);\n        o.onStateChanged?.(layout.fit ? 'fit' : (ordered[index] ?? 'large'), value);\n      }}\n      onOpen={() => stack.markOpened(entry.id)}\n      onClose={() => stack.markClosed(entry.id)}\n    >\n      {/* The view is `position: fixed` without a size; lynx-ui places the sheet at its `top: 100%` and the backdrop at\n          its 100 %. Unsized it is 0 × 0 (Lynxtron), so the sheet slid in above the screen: give it the viewport.\n          event-through lets taps reach the page around a non-modal sheet; the scrim and the sheet take theirs. */}\n      <SheetView className=\"g9-sheet__view\" nativeProps={{ 'event-through': true }}>\n        {modal ? (\n          <view\n            event-through={false}\n            className={`g9-sheet__scrim${props.isTop && !closing ? '' : ' g9-sheet__scrim--covered'}`}\n            style={{\n              backgroundColor: scrimColor(entry, settings, opacity),\n              transition:\n                platform === 'ios' && o.animateOverlayToColorOnIos === false\n                  ? 'none'\n                  : `background-color ${closing ? closeMs : openMs}ms`,\n            }}\n            bindtap={() => {\n              if (layout.closeOnOverlayTap) void stack.requestBack(entry.id, 'overlayTap');\n            }}\n          />\n        ) : null}\n        <SheetContent\n          className={`g9-sheet g9-sheet--${entry.status}${layout.fit ? ' g9-sheet--fit' : ''}`}\n          style={{\n            backgroundColor: o.backgroundColor ?? 'var(--g9-surface-container)',\n            borderTopLeftRadius: `${corner}px`,\n            borderTopRightRadius: `${corner}px`,\n            transition: 'transform 220ms ease-out, opacity 220ms ease-out',\n            ...recede,\n            ...platformSheetConstraints(o),\n          }}\n          innerStyle={{ paddingTop: `${topPadding}px` }}\n          {...motion}\n        >\n          <SheetContext.Provider value={contextValue}>\n            {layout.showHandle ||\n            (layout.fullScreen && o.showToolbar && o.showFullScreenDragHandle !== false && !layout.dragDisabled) ? (\n              <SheetHandle className=\"g9-sheet__grabber-area\">\n                <view className=\"g9-sheet__grabber\" />\n              </SheetHandle>\n            ) : null}\n            <G9SheetHeader options={o} onBack={() => void stack.requestBack(entry.id, 'toolbarButton')} />\n            {o.showToolbar && o.useStandardBodyTopGap !== false ? (\n              <view className=\"g9-sheet__body-gap\" style={{ height: `${g9SheetHeaderMetrics.bodyTopGap}px` }} />\n            ) : null}\n            <scroll-view\n              className={`g9-sheet__body${layout.fullScreen ? ' g9-sheet__body--fill' : ''}`}\n              scroll-orientation=\"vertical\"\n              style={{\n                padding: `${o.padding ?? 0}px`,\n                ...(maxBody !== null ? { maxHeight: `${maxBody}px` } : {}),\n              }}\n            >\n              <view className=\"g9-sheet__content\" key={entry.version} bindlayoutchange={onBodyLayout}>\n                {body}\n                {!revealed ? placeholder : null}\n                {covering ? (\n                  <view\n                    className=\"g9-sheet__cover\"\n                    style={{ height: `${clampFitHeight(placeholderHeight, props.hostHeight, true)}px` }}\n                  >\n                    {placeholder}\n                  </view>\n                ) : null}\n              </view>\n            </scroll-view>\n            <G9SheetFooter options={o} />\n          </SheetContext.Provider>\n        </SheetContent>\n      </SheetView>\n    </SheetRoot>\n  );\n}\n"],"names":["SheetContext","createContext","useG9SheetContext","useContext","scrimColor","entry","settings","opacity","explicit","parsed","tryParseColor","formatColor","withAlpha","G9SheetFrame","props","_ref","_o_loadingSkeletonRowCount","_ratios_layout_initialSnap","_o_openAnimationDurationMs","_o_closeAnimationDurationMs","_o_cornerRadius","_o_backgroundColor","_o_padding","_props_memo","stack","o","layout","resolveSheetLayout","showing","closing","handle","controller","useRef","createAbortController","useEffect","_controller_current","factory","deferred","revealed","setRevealed","useState","covering","setCovering","timer","coverTimer","stopTimer","_o_loadDelayMs","_o_loadDelayMs1","delay","Math","startTimer","memoKey","placeholderHeight","undefined","g9SheetFitLoadingMinHeight","bodyHeight","setBodyHeight","onBodyLayout","e","_e_detail","h","placeholder","view","G9SheetSkeleton","G9ActivityIndicator","body","maxBody","contextValue","ratios","p","Number","restingRatio","sheetOverlayOpacity","modal","recede","parentRecedeOffset","topPadding","sheetTopPadding","platform","currentPlatform","openMs","closeMs","corner","easeOut","t","timed","enterMs","scaledSheetDuration","exitMs","motion","SheetRoot","g9SheetDragCloseThreshold","open","index","value","_ordered_index","detents","d","ordered","SheetView","SheetContent","platformSheetConstraints","SheetHandle","G9SheetHeader","g9SheetHeaderMetrics","scroll-view","clampFitHeight","G9SheetFooter"],"mappings":"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"}

package/dist/sheet/header.d.ts

@@ -0,0 +1,35 @@
+import { type ReactNode } from '@lynx-js/react';
+import type { G9SheetOptions } from './options.js';
+/** Header metrics (MAUI `G9LayoutMetrics` sheet header values). */
+export declare const g9SheetHeaderMetrics: Readonly<{
+    minHeight: 64;
+    verticalGap: 10;
+    bodyTopGap: 10;
+    backButton: 30;
+    backGlyph: 24;
+    backHitSlop: 7;
+    titleSize: 16.2;
+    footerMaxButtonsPerRow: 3;
+}>;
+/** Props of {@link G9SheetHeader}. */
+export interface G9SheetHeaderProps {
+    readonly options: G9SheetOptions;
+    /** The leading button (MAUI back request with source `toolbarButton`). */
+    readonly onBack: () => void;
+}
+/**
+ * The three-slot sheet header (MAUI header template): leading back/close button (RTL-aware arrow, or × with
+ * `useCloseIcon`), the title (centre or near the back button), the trailing toolbar items; slot overrides
+ * `headerView` > `headerLeadingAndTitleView` > `headerTitleAndTrailingView` > per-slot views > defaults. A hairline
+ * closes the band. Rendered only with `showToolbar`.
+ */
+export declare function G9SheetHeader(props: G9SheetHeaderProps): ReactNode;
+/** Props of {@link G9SheetFooter}. */
+export interface G9SheetFooterProps {
+    readonly options: G9SheetOptions;
+}
+/** Rows of footer buttons: equal-width columns, wrapping every `perRow` (MAUI footer template). */
+export declare function footerRows<T>(buttons: ReadonlyArray<T>, perRow: number): T[][];
+/** The sheet footer: `footerView`, else `footerButtons` in equal columns (3 per row by default), with a divider. */
+export declare function G9SheetFooter(props: G9SheetFooterProps): ReactNode;
+//# sourceMappingURL=header.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../src/sheet/header.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,gBAAgB,CAAC;AAM1D,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,WAAW,CAAC;AAEpE,mEAAmE;AACnE,eAAO,MAAM,oBAAoB;;;;;;;;;EAS/B,CAAC;AAiCH,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CA0GlE;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAK9E;AAED,oHAAoH;AACpH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAmBlE"}

package/dist/sheet/header.jsx

@@ -0,0 +1,145 @@
+import { G9StringKey } from "@g9tm/lynxcontrols-foundation";
+import { useState } from "@lynx-js/react";
+import { g9RowStyle } from "../base/control.jsx";
+import { useG9Press } from "../base/press.jsx";
+import { G9HeaderActionButton } from "../button/header-action-button.jsx";
+import { G9IconSlot } from "../icon/slot.jsx";
+import { useG9Direction, useG9Settings, useG9Strings } from "../provider/hooks.jsx";
+const g9SheetHeaderMetrics = Object.freeze({
+    minHeight: 64,
+    verticalGap: 10,
+    bodyTopGap: 10,
+    backButton: 30,
+    backGlyph: 24,
+    backHitSlop: 7,
+    titleSize: 16.2,
+    footerMaxButtonsPerRow: 3
+});
+function ToolbarItemButton(props) {
+    const { item } = props;
+    const [running, setRunning] = useState(false);
+    const busy = true === item.isBusy || running;
+    const onPress = ()=>{
+        var _item_onPress;
+        if (busy && false !== item.disableWhileBusy) return;
+        const result = null == (_item_onPress = item.onPress) ? void 0 : _item_onPress.call(item);
+        if (result && 'function' == typeof result.then) {
+            setRunning(true);
+            result.then(()=>setRunning(false), ()=>setRunning(false));
+        }
+    };
+    return <G9HeaderActionButton {...void 0 !== item.icon ? {
+        icon: item.icon
+    } : {}} {...item.text ? {
+        buttonText: item.text
+    } : {}} isBusy={busy && true === item.showBusyIndicator} isActive={true === item.isActive} showActiveBadge={true === item.showActiveBadge} animatePress={false !== item.animatePress} {...item.iconSize ? {
+        iconSize: item.iconSize
+    } : {}} {...item.accessibilityLabel ? {
+        accessibilityLabel: item.accessibilityLabel
+    } : {}} disabled={busy && false !== item.disableWhileBusy && true !== item.showBusyIndicator} onPress={onPress}/>;
+}
+function G9SheetHeader(props) {
+    var _o_headerLeadingView, _o_headerTitleView, _ref, _o_toolbarItems, _o_headerTrailingView, _o_headerTitlePlacement;
+    var _o_toolbarItemsFactory;
+    const o = props.options;
+    const direction = useG9Direction();
+    const glyphs = useG9Settings().glyphs;
+    const strings = useG9Strings();
+    const back = useG9Press(props.onBack, {
+        source: 'G9SheetHeader'
+    });
+    if (true !== o.showToolbar) return null;
+    if (void 0 !== o.headerView && null !== o.headerView) return <view className="g9-sheet-header g9-sheet-header--custom">{o.headerView}</view>;
+    const m = g9SheetHeaderMetrics;
+    const leading = null != (_o_headerLeadingView = o.headerLeadingView) ? _o_headerLeadingView : o.showCloseButton ? <view className="g9-sheet-header__back" style={{
+        width: `${m.backButton}px`,
+        height: `${m.backButton}px`
+    }} accessibility-element={true} accessibility-traits="button" accessibility-label={o.useCloseIcon ? strings.get(G9StringKey.Close) : strings.get(G9StringKey.Back)} hit-slop={{
+        top: `${m.backHitSlop}px`,
+        left: `${m.backHitSlop}px`,
+        right: `${m.backHitSlop}px`,
+        bottom: `${m.backHitSlop}px`
+    }} bindtap={back}>
+        <G9IconSlot icon={o.useCloseIcon ? glyphs.clear : 'rtl' === direction ? glyphs.arrowForward : glyphs.arrowBack} size={m.backGlyph} color="var(--g9-on-surface)"/>
+      </view> : null;
+    const title = null != (_o_headerTitleView = o.headerTitleView) ? _o_headerTitleView : o.title ? <text className="g9-sheet-header__title" text-maxline="1" style={{
+        fontSize: `${m.titleSize}px`
+    }}>
+        {o.title}
+      </text> : null;
+    const items = null != (_ref = null != (_o_toolbarItems = o.toolbarItems) ? _o_toolbarItems : null == (_o_toolbarItemsFactory = o.toolbarItemsFactory) ? void 0 : _o_toolbarItemsFactory.call(o)) ? _ref : [];
+    const trailing = null != (_o_headerTrailingView = o.headerTrailingView) ? _o_headerTrailingView : items.length > 0 ? <view className="g9-sheet-header__items" style={g9RowStyle(direction)}>
+        {items.map((item, i)=>{
+        var _item_key;
+        return <ToolbarItemButton key={null != (_item_key = item.key) ? _item_key : String(i)} item={item}/>;
+    })}
+      </view> : null;
+    const spanned = null != o.headerLeadingAndTitleView || null != o.headerTitleAndTrailingView;
+    const center = (null != (_o_headerTitlePlacement = o.headerTitlePlacement) ? _o_headerTitlePlacement : 'center') === 'center' && false !== o.reserveEmptyHeaderSlots && !spanned;
+    let slots;
+    slots = null != o.headerLeadingAndTitleView ? [
+        <view key="lt" className="g9-sheet-header__grow">
+        {o.headerLeadingAndTitleView}
+      </view>,
+        <view key="t" className="g9-sheet-header__end">
+        {trailing}
+      </view>
+    ] : null != o.headerTitleAndTrailingView ? [
+        <view key="l" className="g9-sheet-header__start">
+        {leading}
+      </view>,
+        <view key="tt" className="g9-sheet-header__grow">
+        {o.headerTitleAndTrailingView}
+      </view>
+    ] : center ? [
+        <view key="l" className="g9-sheet-header__side g9-sheet-header__start">
+        {leading}
+      </view>,
+        <view key="t" className="g9-sheet-header__title-slot">
+        {title}
+      </view>,
+        <view key="r" className="g9-sheet-header__side g9-sheet-header__end">
+        {trailing}
+      </view>
+    ] : [
+        <view key="l" className="g9-sheet-header__start">
+        {leading}
+      </view>,
+        <view key="t" className="g9-sheet-header__grow g9-sheet-header__title-near">
+        {title}
+      </view>,
+        <view key="r" className="g9-sheet-header__end">
+        {trailing}
+      </view>
+    ];
+    return <view className={`g9-sheet-header g9-dir-${direction}`} style={{
+        minHeight: `${m.minHeight}px`,
+        ...g9RowStyle(direction)
+    }}>
+      {slots}
+    </view>;
+}
+function footerRows(buttons, perRow) {
+    const n = Math.max(1, Math.floor(perRow));
+    const rows = [];
+    for(let i = 0; i < buttons.length; i += n)rows.push(buttons.slice(i, i + n));
+    return rows;
+}
+function G9SheetFooter(props) {
+    var _o_footerButtons, _o_footerMaxButtonsPerRow;
+    const direction = useG9Direction();
+    const o = props.options;
+    if (null != o.footerView) return <view className="g9-sheet-footer">{o.footerView}</view>;
+    const buttons = null != (_o_footerButtons = o.footerButtons) ? _o_footerButtons : [];
+    if (0 === buttons.length) return null;
+    return <view className="g9-sheet-footer">
+      {footerRows(buttons, null != (_o_footerMaxButtonsPerRow = o.footerMaxButtonsPerRow) ? _o_footerMaxButtonsPerRow : g9SheetHeaderMetrics.footerMaxButtonsPerRow).map((row, r)=><view key={r} className="g9-sheet-footer__row" style={g9RowStyle(direction)}>
+          {row.map((button, i)=><view key={i} className="g9-sheet-footer__cell">
+              {button}
+            </view>)}
+        </view>)}
+    </view>;
+}
+export { G9SheetFooter, G9SheetHeader, footerRows, g9SheetHeaderMetrics };
+
+//# sourceMappingURL=header.jsx.map

package/dist/sheet/header.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet/header.jsx","sources":["../../src/sheet/header.tsx"],"sourcesContent":["import { G9StringKey } from '@g9tm/lynxcontrols-foundation';\nimport { type ReactNode, useState } from '@lynx-js/react';\nimport { g9RowStyle } from '../base/control';\nimport { useG9Press } from '../base/press';\nimport { G9HeaderActionButton } from '../button/header-action-button';\nimport { G9IconSlot } from '../icon/slot';\nimport { useG9Direction, useG9Settings, useG9Strings } from '../provider/hooks';\nimport type { G9SheetOptions, G9SheetToolbarItem } from './options';\n\n/** Header metrics (MAUI `G9LayoutMetrics` sheet header values). */\nexport const g9SheetHeaderMetrics = Object.freeze({\n  minHeight: 64,\n  verticalGap: 10,\n  bodyTopGap: 10,\n  backButton: 30,\n  backGlyph: 24,\n  backHitSlop: 7,\n  titleSize: 16.2,\n  footerMaxButtonsPerRow: 3,\n});\n\nfunction ToolbarItemButton(props: { readonly item: G9SheetToolbarItem }): ReactNode {\n  const { item } = props;\n  const [running, setRunning] = useState(false);\n  const busy = item.isBusy === true || running;\n  const onPress = () => {\n    if (busy && item.disableWhileBusy !== false) return;\n    const result = item.onPress?.();\n    if (result && typeof (result as PromiseLike<unknown>).then === 'function') {\n      setRunning(true);\n      (result as PromiseLike<unknown>).then(\n        () => setRunning(false),\n        () => setRunning(false),\n      );\n    }\n  };\n  return (\n    <G9HeaderActionButton\n      {...(item.icon !== undefined ? { icon: item.icon } : {})}\n      {...(item.text ? { buttonText: item.text } : {})}\n      isBusy={busy && item.showBusyIndicator === true}\n      isActive={item.isActive === true}\n      showActiveBadge={item.showActiveBadge === true}\n      animatePress={item.animatePress !== false}\n      {...(item.iconSize ? { iconSize: item.iconSize } : {})}\n      {...(item.accessibilityLabel ? { accessibilityLabel: item.accessibilityLabel } : {})}\n      disabled={busy && item.disableWhileBusy !== false && item.showBusyIndicator !== true}\n      onPress={onPress}\n    />\n  );\n}\n\n/** Props of {@link G9SheetHeader}. */\nexport interface G9SheetHeaderProps {\n  readonly options: G9SheetOptions;\n  /** The leading button (MAUI back request with source `toolbarButton`). */\n  readonly onBack: () => void;\n}\n\n/**\n * The three-slot sheet header (MAUI header template): leading back/close button (RTL-aware arrow, or × with\n * `useCloseIcon`), the title (centre or near the back button), the trailing toolbar items; slot overrides\n * `headerView` > `headerLeadingAndTitleView` > `headerTitleAndTrailingView` > per-slot views > defaults. A hairline\n * closes the band. Rendered only with `showToolbar`.\n */\nexport function G9SheetHeader(props: G9SheetHeaderProps): ReactNode {\n  const o = props.options;\n  const direction = useG9Direction();\n  const glyphs = useG9Settings().glyphs;\n  const strings = useG9Strings();\n  const back = useG9Press(props.onBack, { source: 'G9SheetHeader' });\n  if (o.showToolbar !== true) return null;\n  if (o.headerView !== undefined && o.headerView !== null) {\n    return <view className=\"g9-sheet-header g9-sheet-header--custom\">{o.headerView}</view>;\n  }\n  const m = g9SheetHeaderMetrics;\n  const leading =\n    o.headerLeadingView ??\n    (o.showCloseButton ? (\n      <view\n        className=\"g9-sheet-header__back\"\n        style={{ width: `${m.backButton}px`, height: `${m.backButton}px` }}\n        accessibility-element={true}\n        accessibility-traits=\"button\"\n        accessibility-label={o.useCloseIcon ? strings.get(G9StringKey.Close) : strings.get(G9StringKey.Back)}\n        hit-slop={{\n          top: `${m.backHitSlop}px`,\n          left: `${m.backHitSlop}px`,\n          right: `${m.backHitSlop}px`,\n          bottom: `${m.backHitSlop}px`,\n        }}\n        bindtap={back}\n      >\n        <G9IconSlot\n          icon={o.useCloseIcon ? glyphs.clear : direction === 'rtl' ? glyphs.arrowForward : glyphs.arrowBack}\n          size={m.backGlyph}\n          color=\"var(--g9-on-surface)\"\n        />\n      </view>\n    ) : null);\n  const title =\n    o.headerTitleView ??\n    (o.title ? (\n      <text className=\"g9-sheet-header__title\" text-maxline=\"1\" style={{ fontSize: `${m.titleSize}px` }}>\n        {o.title}\n      </text>\n    ) : null);\n  const items = o.toolbarItems ?? o.toolbarItemsFactory?.() ?? [];\n  const trailing =\n    o.headerTrailingView ??\n    (items.length > 0 ? (\n      <view className=\"g9-sheet-header__items\" style={g9RowStyle(direction)}>\n        {items.map((item, i) => (\n          <ToolbarItemButton key={item.key ?? String(i)} item={item} />\n        ))}\n      </view>\n    ) : null);\n  const spanned = o.headerLeadingAndTitleView != null || o.headerTitleAndTrailingView != null;\n  const center = (o.headerTitlePlacement ?? 'center') === 'center' && o.reserveEmptyHeaderSlots !== false && !spanned;\n  let slots: ReactNode;\n  if (o.headerLeadingAndTitleView != null) {\n    slots = [\n      <view key=\"lt\" className=\"g9-sheet-header__grow\">\n        {o.headerLeadingAndTitleView}\n      </view>,\n      <view key=\"t\" className=\"g9-sheet-header__end\">\n        {trailing}\n      </view>,\n    ];\n  } else if (o.headerTitleAndTrailingView != null) {\n    slots = [\n      <view key=\"l\" className=\"g9-sheet-header__start\">\n        {leading}\n      </view>,\n      <view key=\"tt\" className=\"g9-sheet-header__grow\">\n        {o.headerTitleAndTrailingView}\n      </view>,\n    ];\n  } else if (center) {\n    slots = [\n      <view key=\"l\" className=\"g9-sheet-header__side g9-sheet-header__start\">\n        {leading}\n      </view>,\n      <view key=\"t\" className=\"g9-sheet-header__title-slot\">\n        {title}\n      </view>,\n      <view key=\"r\" className=\"g9-sheet-header__side g9-sheet-header__end\">\n        {trailing}\n      </view>,\n    ];\n  } else {\n    slots = [\n      <view key=\"l\" className=\"g9-sheet-header__start\">\n        {leading}\n      </view>,\n      <view key=\"t\" className=\"g9-sheet-header__grow g9-sheet-header__title-near\">\n        {title}\n      </view>,\n      <view key=\"r\" className=\"g9-sheet-header__end\">\n        {trailing}\n      </view>,\n    ];\n  }\n  return (\n    <view\n      className={`g9-sheet-header g9-dir-${direction}`}\n      style={{ minHeight: `${m.minHeight}px`, ...g9RowStyle(direction) }}\n    >\n      {slots}\n    </view>\n  );\n}\n\n/** Props of {@link G9SheetFooter}. */\nexport interface G9SheetFooterProps {\n  readonly options: G9SheetOptions;\n}\n\n/** Rows of footer buttons: equal-width columns, wrapping every `perRow` (MAUI footer template). */\nexport function footerRows<T>(buttons: ReadonlyArray<T>, perRow: number): T[][] {\n  const n = Math.max(1, Math.floor(perRow));\n  const rows: T[][] = [];\n  for (let i = 0; i < buttons.length; i += n) rows.push(buttons.slice(i, i + n));\n  return rows;\n}\n\n/** The sheet footer: `footerView`, else `footerButtons` in equal columns (3 per row by default), with a divider. */\nexport function G9SheetFooter(props: G9SheetFooterProps): ReactNode {\n  const direction = useG9Direction();\n  const o = props.options;\n  if (o.footerView != null) return <view className=\"g9-sheet-footer\">{o.footerView}</view>;\n  const buttons = o.footerButtons ?? [];\n  if (buttons.length === 0) return null;\n  return (\n    <view className=\"g9-sheet-footer\">\n      {footerRows(buttons, o.footerMaxButtonsPerRow ?? g9SheetHeaderMetrics.footerMaxButtonsPerRow).map((row, r) => (\n        <view key={r} className=\"g9-sheet-footer__row\" style={g9RowStyle(direction)}>\n          {row.map((button, i) => (\n            <view key={i} className=\"g9-sheet-footer__cell\">\n              {button}\n            </view>\n          ))}\n        </view>\n      ))}\n    </view>\n  );\n}\n"],"names":["g9SheetHeaderMetrics","Object","ToolbarItemButton","props","item","running","setRunning","useState","busy","onPress","result","G9HeaderActionButton","undefined","G9SheetHeader","_o_headerLeadingView","_o_headerTitleView","_ref","_o_headerTrailingView","_o_headerTitlePlacement","o","direction","useG9Direction","glyphs","useG9Settings","strings","useG9Strings","back","useG9Press","view","m","leading","G9StringKey","G9IconSlot","title","text","items","trailing","g9RowStyle","i","_item_key","String","spanned","center","slots","footerRows","buttons","perRow","n","Math","rows","G9SheetFooter","_o_footerButtons","_o_footerMaxButtonsPerRow","row","r","button"],"mappings":"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"}

package/dist/sheet/height-memo.d.ts

@@ -0,0 +1,47 @@
+/** Most learned heights kept (MAUI 64). */
+export declare const g9SheetHeightMemoLimit = 64;
+/** Preference key of the persisted memo. */
+export declare const g9SheetHeightMemoPreferenceKey = "sheet-heights";
+/** The memo key of a sheet body. */
+export declare function sheetHeightMemoKey(identity: string, width: number, culture: string, fontScale: number): string;
+/** Compiled-in first-open heights (MAUI `G9BottomSheetHeightSeeds`); never persisted. */
+export interface G9SheetHeightSeeds {
+    /** Sets (or replaces) the seed of a memo key or bare identity; blank keys and heights ≤ 0 are ignored. */
+    seed(key: string, bodyHeight: number): void;
+    /** Exact key first, then the identity alone (the last three `|` segments stripped). */
+    tryGet(key: string): number | undefined;
+    reset(): void;
+}
+/** Creates a seed table. */
+export declare function createSheetHeightSeeds(): G9SheetHeightSeeds;
+/** The learned heights (MAUI `G9BottomSheetHeightMemoStore`). */
+export interface G9SheetHeightMemo {
+    /** Learned height, else the seed. */
+    lookup(key: string): number | undefined;
+    /** Records a real body measurement; ≤ 0 is ignored, a change < 0.5 is skipped; the oldest key is evicted at 64. */
+    record(key: string, bodyHeight: number): void;
+    /** Forgets every learned height (theme/font change). */
+    invalidate(): void;
+    readonly size: number;
+    /** Writes the memo to preferences now. */
+    flush(): void;
+}
+/** The synchronous preference reads/writes the memo needs (`useG9Preferences()` provides them). */
+export interface G9SheetMemoPreferences {
+    getString(key: string, defaultValue?: string | null): string | null;
+    setString(key: string, value: string): unknown;
+}
+/** Options of {@link createSheetHeightMemo}. */
+export interface G9SheetHeightMemoOptions {
+    readonly seeds?: G9SheetHeightSeeds;
+    /** Persists under {@link g9SheetHeightMemoPreferenceKey}; a different `appVersion` discards the stored memo. */
+    readonly preferences?: G9SheetMemoPreferences;
+    readonly appVersion?: string;
+    /** Debounced flush (ms). Default 3000. */
+    readonly flushDelayMs?: number;
+    readonly setTimer?: (callback: () => void, ms: number) => unknown;
+    readonly clearTimer?: (handle: unknown) => void;
+}
+/** Creates a height memo (lazy load from preferences on first use, debounced flush). */
+export declare function createSheetHeightMemo(options?: G9SheetHeightMemoOptions): G9SheetHeightMemo;
+//# sourceMappingURL=height-memo.d.ts.map

package/dist/sheet/height-memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"height-memo.d.ts","sourceRoot":"","sources":["../../src/sheet/height-memo.ts"],"names":[],"mappings":"AAIA,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,4CAA4C;AAC5C,eAAO,MAAM,8BAA8B,kBAAkB,CAAC;AAE9D,oCAAoC;AACpC,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9G;AAED,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,0GAA0G;IAC1G,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,uFAAuF;IACvF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACxC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,4BAA4B;AAC5B,wBAAgB,sBAAsB,IAAI,kBAAkB,CAkB3D;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACxC,mHAAmH;IACnH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,wDAAwD;IACxD,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,mGAAmG;AACnG,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACpE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAChD;AAED,gDAAgD;AAChD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IACpC,gHAAgH;IAChH,QAAQ,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,wBAA6B,GAAG,iBAAiB,CA4D/F"}

package/dist/sheet/height-memo.jsx

@@ -0,0 +1,100 @@
+const g9SheetHeightMemoLimit = 64;
+const g9SheetHeightMemoPreferenceKey = 'sheet-heights';
+function sheetHeightMemoKey(identity, width, culture, fontScale) {
+    return `${identity}|w${Math.round(width)}|${culture}|fs${fontScale}`;
+}
+function createSheetHeightSeeds() {
+    const seeds = new Map();
+    return {
+        seed (key, bodyHeight) {
+            if (!key || '' === key.trim() || !(bodyHeight > 0)) return;
+            seeds.set(key, bodyHeight);
+        },
+        tryGet (key) {
+            const exact = seeds.get(key);
+            if (void 0 !== exact) return exact;
+            const parts = key.split('|');
+            if (parts.length < 4) return;
+            return seeds.get(parts.slice(0, parts.length - 3).join('|'));
+        },
+        reset () {
+            seeds.clear();
+        }
+    };
+}
+function createSheetHeightMemo(options = {}) {
+    var _options_appVersion;
+    const entries = new Map();
+    const header = `v1\t${null != (_options_appVersion = options.appVersion) ? _options_appVersion : '0'}`;
+    let loaded = false;
+    let timer = null;
+    const prefs = options.preferences;
+    const load = ()=>{
+        var _prefs_getString;
+        if (loaded) return;
+        loaded = true;
+        if (!prefs) return;
+        const blob = null != (_prefs_getString = prefs.getString(g9SheetHeightMemoPreferenceKey, '')) ? _prefs_getString : '';
+        const lines = blob.split('\n');
+        if (lines[0] !== header) return;
+        for (const line of lines.slice(1)){
+            const tab = line.lastIndexOf('\t');
+            if (tab <= 0) continue;
+            const height = Number(line.slice(tab + 1));
+            if (height > 0) entries.set(line.slice(0, tab), height);
+        }
+    };
+    const flush = ()=>{
+        var _options_clearTimer;
+        if (null !== timer) null == (_options_clearTimer = options.clearTimer) || _options_clearTimer.call(options, timer);
+        timer = null;
+        if (!prefs) return;
+        const body = [
+            ...entries
+        ].map(([k, h])=>`${k}\t${Math.round(10 * h) / 10}`);
+        prefs.setString(g9SheetHeightMemoPreferenceKey, [
+            header,
+            ...body
+        ].join('\n'));
+    };
+    const schedule = ()=>{
+        var _options_flushDelayMs;
+        var _options_clearTimer;
+        if (!prefs || !options.setTimer) return;
+        if (null !== timer) null == (_options_clearTimer = options.clearTimer) || _options_clearTimer.call(options, timer);
+        timer = options.setTimer(flush, null != (_options_flushDelayMs = options.flushDelayMs) ? _options_flushDelayMs : 3000);
+    };
+    return {
+        lookup (key) {
+            var _entries_get;
+            var _options_seeds;
+            load();
+            return null != (_entries_get = entries.get(key)) ? _entries_get : null == (_options_seeds = options.seeds) ? void 0 : _options_seeds.tryGet(key);
+        },
+        record (key, bodyHeight) {
+            load();
+            if (!(bodyHeight > 0)) return;
+            const old = entries.get(key);
+            if (void 0 !== old && Math.abs(old - bodyHeight) < 0.5) return;
+            if (void 0 === old && entries.size >= g9SheetHeightMemoLimit) {
+                const first = entries.keys().next().value;
+                entries.delete(first);
+            }
+            entries.set(key, bodyHeight);
+            schedule();
+        },
+        invalidate () {
+            load();
+            entries.clear();
+            schedule();
+        },
+        get size () {
+            load();
+            return entries.size;
+        },
+        flush
+    };
+}
+export { createSheetHeightMemo, createSheetHeightSeeds, g9SheetHeightMemoLimit, g9SheetHeightMemoPreferenceKey, sheetHeightMemoKey };
+
+//# sourceMappingURL=height-memo.jsx.map