@g9tm/lynxcontrols 0.0.0-stage → 1.4.2

package/dist/button/nav-card.d.ts

@@ -0,0 +1,58 @@
+import './button.css';
+import { type G9ImageSource } from '@g9tm/lynxcontrols-foundation';
+import type { ReactNode } from '@lynx-js/react';
+import { type G9ControlBaseProps } from '../base/control.js';
+import type { G9IconInput } from '../icon/icon.js';
+/** Props of {@link G9NavCard} (MAUI `G9NavCard`). */
+export interface G9NavCardProps extends G9ControlBaseProps {
+    readonly title?: string | null;
+    readonly subtitle?: string | null;
+    /** Icon and icon-tile tint. Default the primary colour. Must be a colour literal (it is mixed). */
+    readonly accentColor?: string | null;
+    readonly iconEmoji?: string | null;
+    readonly icon?: G9IconInput;
+    readonly iconPath?: string | null;
+    readonly iconImage?: G9ImageSource | null;
+    /** Trailing chevron (forward in LTR, back in RTL). Default true. */
+    readonly showChevron?: boolean;
+    readonly valueText?: string | null;
+    /** Value colour; default error when destructive, else tertiary text. */
+    readonly valueColor?: string | null;
+    /** Coming-soon badge instead of value and chevron; presses do nothing. Default false. */
+    readonly isComingSoon?: boolean;
+    /** Badge text; default the localized `comingSoon`. */
+    readonly comingSoonText?: string | null;
+    readonly iconBadgeText?: string | null;
+    readonly showIconBadgeDot?: boolean;
+    readonly iconBadgeColor?: string | null;
+    /** Default true. */
+    readonly mirrorBadgeTextInRtl?: boolean;
+    /** Replaces the whole trailing area (value, chevron, coming-soon badge). */
+    readonly trailing?: ReactNode;
+    /**
+     * A small node on the title's line, right after the title (a count pill, an unread dot, a "6/10"; MAUI 1.4.0
+     * `TitleAccessoryView`). It does not take over the trailing area, so the chevron, value and coming-soon badge keep
+     * working beside it. A long title truncates; the accessory never does. Unset keeps the title layout as it was.
+     */
+    readonly titleAccessory?: ReactNode;
+    /** Title (and default value colour) in the error colour. Default false. */
+    readonly isDestructive?: boolean;
+    /** Tint the card background with the accent (88 % surface). Default false. */
+    readonly useAccentSurface?: boolean;
+    /** Accent used only for the background tint. */
+    readonly cardAccentColor?: string | null;
+    /**
+     * Paint the icon tile solid in the accent with an `OnPrimary` icon instead of the pastel tile with an accent icon
+     * (MAUI 1.4.0 `UseFilledIconChip`): the one primary row of a list. Pair with `useAccentSurface`. Default false.
+     */
+    readonly useFilledIconChip?: boolean;
+    /** The press (MAUI `Tapped` + `Command`); not while disabled or coming soon. */
+    readonly onPress?: () => void;
+}
+/**
+ * Navigation row card (MAUI `G9NavCard`): icon tile (pastel, or filled with `useFilledIconChip`) with optional corner
+ * badge, title (with an optional `titleAccessory` after it)/subtitle, value text, chevron or coming-soon badge, or a
+ * custom trailing node. Press: scale 0.985 (70 ms) → 1 (120 ms); hover on desktop.
+ */
+export declare function G9NavCard(props: G9NavCardProps): ReactNode;
+//# sourceMappingURL=nav-card.d.ts.map

package/dist/button/nav-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-card.d.ts","sourceRoot":"","sources":["../../src/button/nav-card.tsx"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AACtB,OAAO,EAAe,KAAK,aAAa,EAAuC,MAAM,+BAA+B,CAAC;AACrH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,kBAAkB,EAAyC,MAAM,iBAAiB,CAAC;AAGjG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,qDAAqD;AACrD,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mGAAmG;IACnG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,yFAAyF;IACzF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,sDAAsD;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,oBAAoB;IACpB,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,gDAAgD;IAChD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAgH1D"}

package/dist/button/nav-card.jsx

@@ -0,0 +1,96 @@
+import "./button.css";
+import { G9StringKey, formatColor, mix, resolveThemeColor } from "@g9tm/lynxcontrols-foundation";
+import { g9RowStyle, g9TextStart, useG9Control } from "../base/control.jsx";
+import { G9CornerBadge } from "../base/corner-badge.jsx";
+import { useG9Press, usePressVisual } from "../base/press.jsx";
+import { G9IconSlot, hasIconSlot } from "../icon/slot.jsx";
+import { useG9Settings, useG9Strings, useG9Theme } from "../provider/hooks.jsx";
+function G9NavCard(props) {
+    var _props_accessibilityLabel, _props_accessibilityLabel1, _props_valueColor;
+    const control = useG9Control(props, 'g9-nav-card');
+    const palette = useG9Theme().palette;
+    const glyphs = useG9Settings().glyphs;
+    const strings = useG9Strings();
+    const soon = true === props.isComingSoon;
+    const destructive = true === props.isDestructive;
+    const accent = props.accentColor ? resolveThemeColor(props.accentColor, palette) : palette.Primary;
+    const cardAccent = props.cardAccentColor ? resolveThemeColor(props.cardAccentColor, palette) : accent;
+    const surface = props.useAccentSurface ? formatColor(mix(cardAccent, palette.Surface, 0.88)) : palette.Surface;
+    const press = useG9Press(props.onPress, {
+        blocked: control.disabled || soon,
+        source: 'G9NavCard'
+    });
+    const visual = usePressVisual({
+        property: 'scale',
+        rest: 1,
+        pressed: 0.985,
+        inMs: 70,
+        outMs: 120
+    }, control.disabled || soon);
+    const icon = {
+        emoji: props.iconEmoji,
+        icon: props.icon,
+        imagePath: props.iconPath,
+        image: props.iconImage
+    };
+    const subtitle = props.subtitle && '' !== props.subtitle.trim() ? props.subtitle : null;
+    const value = props.valueText && '' !== props.valueText.trim() ? props.valueText : null;
+    const soonText = props.comingSoonText && '' !== props.comingSoonText.trim() ? props.comingSoonText : strings.get(G9StringKey.ComingSoon);
+    const label = [
+        props.title,
+        subtitle
+    ].filter(Boolean).join(', ');
+    const filledChip = true === props.useFilledIconChip;
+    const title = props.title ? <text className="g9-nav-card__title" text-maxline="1" style={{
+        color: destructive ? palette.Error : palette.TextPrimary,
+        ...g9TextStart(control.direction)
+    }}>
+      {props.title}
+    </text> : null;
+    return <view className={control.className} {...control.idProps} style={{
+        backgroundColor: surface,
+        ...g9RowStyle(control.direction)
+    }} {...void 0 === props.trailing ? {
+        'accessibility-element': true,
+        'accessibility-traits': 'button',
+        ...(null != (_props_accessibilityLabel = props.accessibilityLabel) ? _props_accessibilityLabel : label) ? {
+            'accessibility-label': null != (_props_accessibilityLabel1 = props.accessibilityLabel) ? _props_accessibilityLabel1 : label
+        } : {},
+        ...soon ? {
+            'accessibility-value': soonText
+        } : value ? {
+            'accessibility-value': value
+        } : {}
+    } : {}} bindtap={press} {...visual}>
+      {hasIconSlot(icon) ? <view className="g9-nav-card__tile" style={{
+        backgroundColor: filledChip ? accent : formatColor(mix(accent, palette.Surface, 0.82))
+    }}>
+          <G9IconSlot {...icon} size={props.iconEmoji ? 22 : 18} color={filledChip ? palette.OnPrimary : accent}/>
+          <G9CornerBadge text={props.iconBadgeText} dot={true === props.showIconBadgeDot} color={props.iconBadgeColor} mirrorTextInRtl={false !== props.mirrorBadgeTextInRtl}/>
+        </view> : null}
+      <view className="g9-nav-card__text">
+        {void 0 === props.titleAccessory || null === props.titleAccessory ? title : <view className="g9-nav-card__title-row" style={g9RowStyle(control.direction)}>
+            {title}
+            <view className="g9-nav-card__title-accessory">{props.titleAccessory}</view>
+          </view>}
+        {subtitle ? <text className="g9-nav-card__subtitle" text-maxline="1" style={g9TextStart(control.direction)}>
+            {subtitle}
+          </text> : null}
+      </view>
+      {void 0 !== props.trailing ? <view className="g9-nav-card__trailing" style={g9RowStyle(control.direction)}>
+          {props.trailing}
+        </view> : <view className="g9-nav-card__trailing" style={g9RowStyle(control.direction)}>
+          {value && !soon ? <text className="g9-nav-card__value" text-maxline="1" style={{
+        color: null != (_props_valueColor = props.valueColor) ? _props_valueColor : destructive ? palette.Error : palette.TextTertiary
+    }}>
+              {value}
+            </text> : null}
+          {soon ? <view className="g9-nav-card__soon">
+              <text className="g9-nav-card__soon-text">{soonText}</text>
+            </view> : false !== props.showChevron ? <G9IconSlot icon={'rtl' === control.direction ? glyphs.chevronBack : glyphs.chevronForward} size={24} color={palette.TextTertiary}/> : null}
+        </view>}
+    </view>;
+}
+export { G9NavCard };
+
+//# sourceMappingURL=nav-card.jsx.map

package/dist/button/nav-card.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"button/nav-card.jsx","sources":["../../src/button/nav-card.tsx"],"sourcesContent":["import './button.css';\nimport { formatColor, type G9ImageSource, G9StringKey, mix, resolveThemeColor } from '@g9tm/lynxcontrols-foundation';\nimport type { ReactNode } from '@lynx-js/react';\nimport { type G9ControlBaseProps, g9RowStyle, g9TextStart, useG9Control } from '../base/control';\nimport { G9CornerBadge } from '../base/corner-badge';\nimport { useG9Press, usePressVisual } from '../base/press';\nimport type { G9IconInput } from '../icon/icon';\nimport { G9IconSlot, hasIconSlot } from '../icon/slot';\nimport { useG9Settings, useG9Strings, useG9Theme } from '../provider/hooks';\n\n/** Props of {@link G9NavCard} (MAUI `G9NavCard`). */\nexport interface G9NavCardProps extends G9ControlBaseProps {\n  readonly title?: string | null;\n  readonly subtitle?: string | null;\n  /** Icon and icon-tile tint. Default the primary colour. Must be a colour literal (it is mixed). */\n  readonly accentColor?: string | null;\n  readonly iconEmoji?: string | null;\n  readonly icon?: G9IconInput;\n  readonly iconPath?: string | null;\n  readonly iconImage?: G9ImageSource | null;\n  /** Trailing chevron (forward in LTR, back in RTL). Default true. */\n  readonly showChevron?: boolean;\n  readonly valueText?: string | null;\n  /** Value colour; default error when destructive, else tertiary text. */\n  readonly valueColor?: string | null;\n  /** Coming-soon badge instead of value and chevron; presses do nothing. Default false. */\n  readonly isComingSoon?: boolean;\n  /** Badge text; default the localized `comingSoon`. */\n  readonly comingSoonText?: string | null;\n  readonly iconBadgeText?: string | null;\n  readonly showIconBadgeDot?: boolean;\n  readonly iconBadgeColor?: string | null;\n  /** Default true. */\n  readonly mirrorBadgeTextInRtl?: boolean;\n  /** Replaces the whole trailing area (value, chevron, coming-soon badge). */\n  readonly trailing?: ReactNode;\n  /**\n   * A small node on the title's line, right after the title (a count pill, an unread dot, a \"6/10\"; MAUI 1.4.0\n   * `TitleAccessoryView`). It does not take over the trailing area, so the chevron, value and coming-soon badge keep\n   * working beside it. A long title truncates; the accessory never does. Unset keeps the title layout as it was.\n   */\n  readonly titleAccessory?: ReactNode;\n  /** Title (and default value colour) in the error colour. Default false. */\n  readonly isDestructive?: boolean;\n  /** Tint the card background with the accent (88 % surface). Default false. */\n  readonly useAccentSurface?: boolean;\n  /** Accent used only for the background tint. */\n  readonly cardAccentColor?: string | null;\n  /**\n   * Paint the icon tile solid in the accent with an `OnPrimary` icon instead of the pastel tile with an accent icon\n   * (MAUI 1.4.0 `UseFilledIconChip`): the one primary row of a list. Pair with `useAccentSurface`. Default false.\n   */\n  readonly useFilledIconChip?: boolean;\n  /** The press (MAUI `Tapped` + `Command`); not while disabled or coming soon. */\n  readonly onPress?: () => void;\n}\n\n/**\n * Navigation row card (MAUI `G9NavCard`): icon tile (pastel, or filled with `useFilledIconChip`) with optional corner\n * badge, title (with an optional `titleAccessory` after it)/subtitle, value text, chevron or coming-soon badge, or a\n * custom trailing node. Press: scale 0.985 (70 ms) → 1 (120 ms); hover on desktop.\n */\nexport function G9NavCard(props: G9NavCardProps): ReactNode {\n  const control = useG9Control(props, 'g9-nav-card');\n  const palette = useG9Theme().palette;\n  const glyphs = useG9Settings().glyphs;\n  const strings = useG9Strings();\n  const soon = props.isComingSoon === true;\n  const destructive = props.isDestructive === true;\n  // A theme reference (`var(--g9-success)`) is resolved against the live palette: the accent is mixed below, and a\n  // CSS variable cannot be mixed.\n  const accent = props.accentColor ? resolveThemeColor(props.accentColor, palette) : palette.Primary;\n  const cardAccent = props.cardAccentColor ? resolveThemeColor(props.cardAccentColor, palette) : accent;\n  const surface = props.useAccentSurface ? formatColor(mix(cardAccent, palette.Surface, 0.88)) : palette.Surface;\n  const press = useG9Press(props.onPress, { blocked: control.disabled || soon, source: 'G9NavCard' });\n  const visual = usePressVisual(\n    { property: 'scale', rest: 1, pressed: 0.985, inMs: 70, outMs: 120 },\n    control.disabled || soon,\n  );\n  const icon = { emoji: props.iconEmoji, icon: props.icon, imagePath: props.iconPath, image: props.iconImage };\n  const subtitle = props.subtitle && props.subtitle.trim() !== '' ? props.subtitle : null;\n  const value = props.valueText && props.valueText.trim() !== '' ? props.valueText : null;\n  const soonText =\n    props.comingSoonText && props.comingSoonText.trim() !== ''\n      ? props.comingSoonText\n      : strings.get(G9StringKey.ComingSoon);\n  const label = [props.title, subtitle].filter(Boolean).join(', ');\n  const filledChip = props.useFilledIconChip === true;\n  const title = props.title ? (\n    <text\n      className=\"g9-nav-card__title\"\n      text-maxline=\"1\"\n      style={{ color: destructive ? palette.Error : palette.TextPrimary, ...g9TextStart(control.direction) }}\n    >\n      {props.title}\n    </text>\n  ) : null;\n  return (\n    <view\n      className={control.className}\n      {...control.idProps}\n      style={{ backgroundColor: surface, ...g9RowStyle(control.direction) }}\n      {...(props.trailing === undefined\n        ? {\n            'accessibility-element': true,\n            'accessibility-traits': 'button',\n            ...((props.accessibilityLabel ?? label)\n              ? { 'accessibility-label': props.accessibilityLabel ?? label }\n              : {}),\n            ...(soon ? { 'accessibility-value': soonText } : value ? { 'accessibility-value': value } : {}),\n          }\n        : {})}\n      bindtap={press}\n      {...visual}\n    >\n      {hasIconSlot(icon) ? (\n        <view\n          className=\"g9-nav-card__tile\"\n          style={{ backgroundColor: filledChip ? accent : formatColor(mix(accent, palette.Surface, 0.82)) }}\n        >\n          <G9IconSlot {...icon} size={props.iconEmoji ? 22 : 18} color={filledChip ? palette.OnPrimary : accent} />\n          <G9CornerBadge\n            text={props.iconBadgeText}\n            dot={props.showIconBadgeDot === true}\n            color={props.iconBadgeColor}\n            mirrorTextInRtl={props.mirrorBadgeTextInRtl !== false}\n          />\n        </view>\n      ) : null}\n      <view className=\"g9-nav-card__text\">\n        {props.titleAccessory === undefined || props.titleAccessory === null ? (\n          title\n        ) : (\n          <view className=\"g9-nav-card__title-row\" style={g9RowStyle(control.direction)}>\n            {title}\n            <view className=\"g9-nav-card__title-accessory\">{props.titleAccessory}</view>\n          </view>\n        )}\n        {subtitle ? (\n          <text className=\"g9-nav-card__subtitle\" text-maxline=\"1\" style={g9TextStart(control.direction)}>\n            {subtitle}\n          </text>\n        ) : null}\n      </view>\n      {props.trailing !== undefined ? (\n        <view className=\"g9-nav-card__trailing\" style={g9RowStyle(control.direction)}>\n          {props.trailing}\n        </view>\n      ) : (\n        <view className=\"g9-nav-card__trailing\" style={g9RowStyle(control.direction)}>\n          {value && !soon ? (\n            <text\n              className=\"g9-nav-card__value\"\n              text-maxline=\"1\"\n              style={{ color: props.valueColor ?? (destructive ? palette.Error : palette.TextTertiary) }}\n            >\n              {value}\n            </text>\n          ) : null}\n          {soon ? (\n            <view className=\"g9-nav-card__soon\">\n              <text className=\"g9-nav-card__soon-text\">{soonText}</text>\n            </view>\n          ) : props.showChevron !== false ? (\n            <G9IconSlot\n              icon={control.direction === 'rtl' ? glyphs.chevronBack : glyphs.chevronForward}\n              size={24}\n              color={palette.TextTertiary}\n            />\n          ) : null}\n        </view>\n      )}\n    </view>\n  );\n}\n"],"names":["G9NavCard","props","_props_accessibilityLabel","_props_accessibilityLabel1","_props_valueColor","control","useG9Control","palette","useG9Theme","glyphs","useG9Settings","strings","useG9Strings","soon","destructive","accent","resolveThemeColor","cardAccent","surface","formatColor","mix","press","useG9Press","visual","usePressVisual","icon","subtitle","value","soonText","G9StringKey","label","Boolean","filledChip","title","text","g9TextStart","view","g9RowStyle","undefined","hasIconSlot","G9IconSlot","G9CornerBadge"],"mappings":"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"}

package/dist/button/safe-tap.d.ts

@@ -0,0 +1,27 @@
+import type { G9SafeRunContext } from '@g9tm/lynxcontrols-foundation';
+/** Options of {@link useSafeTap} (MAUI `G9SafeTapBehavior`). */
+export interface G9SafeTapOptions {
+    /** Taps needed to run (double tap = 2); taps further apart than `multiTapWindowMs` restart the count. Default 1. */
+    readonly numberOfTapsRequired?: number;
+    /** Max gap between the taps of a multi-tap. Default 300 ms. */
+    readonly multiTapWindowMs?: number;
+    /** Default true. */
+    readonly enableThrottle?: boolean;
+    /** Default one key per hook instance. */
+    readonly throttleKey?: string;
+    /** Default 369 ms. */
+    readonly throttleIntervalMs?: number;
+    /** Default `'G9SafeTapBehavior'`. */
+    readonly source?: string;
+    /** Default true. */
+    readonly showErrorPopup?: boolean;
+    /** `false` ignores taps (MAUI `CanExecute`). Default true. */
+    readonly canExecute?: boolean;
+}
+/**
+ * A guarded tap for any element (MAUI `G9SafeTapBehavior`): returns a `bindtap` handler that runs `action` through the
+ * provider's safe executor (throttle, one run at a time, errors to diagnostics and the popup). No busy state and no
+ * visual feedback, as in MAUI. `numberOfTapsRequired` is read on every tap (MAUI read it once at attach).
+ */
+export declare function useSafeTap(action: ((context: G9SafeRunContext) => unknown) | null | undefined, options?: G9SafeTapOptions): () => void;
+//# sourceMappingURL=safe-tap.d.ts.map

package/dist/button/safe-tap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-tap.d.ts","sourceRoot":"","sources":["../../src/button/safe-tap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,oHAAoH;IACpH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,+DAA+D;IAC/D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,oBAAoB;IACpB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sBAAsB;IACtB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB;IACpB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAID;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACnE,OAAO,GAAE,gBAAqB,GAC7B,MAAM,IAAI,CAwBZ"}

package/dist/button/safe-tap.jsx

@@ -0,0 +1,46 @@
+import { useRef } from "@lynx-js/react";
+import { useG9Executor } from "../provider/hooks.jsx";
+let counter = 0;
+function useSafeTap(action, options = {}) {
+    const executor = useG9Executor();
+    const key = useRef(null);
+    if (null === key.current) key.current = `G9SafeTapBehavior:${++counter}`;
+    const taps = useRef({
+        count: 0,
+        last: 0
+    });
+    return ()=>{
+        var _options_numberOfTapsRequired, _options_throttleKey, _options_source;
+        if (!action || false === options.canExecute) return;
+        const required = Math.max(1, Math.floor(null != (_options_numberOfTapsRequired = options.numberOfTapsRequired) ? _options_numberOfTapsRequired : 1));
+        if (required > 1) {
+            var _options_multiTapWindowMs;
+            const now = Date.now();
+            const window = null != (_options_multiTapWindowMs = options.multiTapWindowMs) ? _options_multiTapWindowMs : 300;
+            taps.current = now - taps.current.last <= window ? {
+                count: taps.current.count + 1,
+                last: now
+            } : {
+                count: 1,
+                last: now
+            };
+            if (taps.current.count < required) return;
+            taps.current = {
+                count: 0,
+                last: 0
+            };
+        }
+        executor.runSafe(action, {
+            throttleKey: null != (_options_throttleKey = options.throttleKey) ? _options_throttleKey : key.current,
+            enableThrottle: false !== options.enableThrottle,
+            ...void 0 !== options.throttleIntervalMs ? {
+                throttleIntervalMs: options.throttleIntervalMs
+            } : {},
+            source: null != (_options_source = options.source) ? _options_source : 'G9SafeTapBehavior',
+            showErrorPopup: false !== options.showErrorPopup
+        });
+    };
+}
+export { useSafeTap };
+
+//# sourceMappingURL=safe-tap.jsx.map

package/dist/button/safe-tap.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"button/safe-tap.jsx","sources":["../../src/button/safe-tap.ts"],"sourcesContent":["import type { G9SafeRunContext } from '@g9tm/lynxcontrols-foundation';\nimport { useRef } from '@lynx-js/react';\nimport { useG9Executor } from '../provider/hooks';\n\n/** Options of {@link useSafeTap} (MAUI `G9SafeTapBehavior`). */\nexport interface G9SafeTapOptions {\n  /** Taps needed to run (double tap = 2); taps further apart than `multiTapWindowMs` restart the count. Default 1. */\n  readonly numberOfTapsRequired?: number;\n  /** Max gap between the taps of a multi-tap. Default 300 ms. */\n  readonly multiTapWindowMs?: number;\n  /** Default true. */\n  readonly enableThrottle?: boolean;\n  /** Default one key per hook instance. */\n  readonly throttleKey?: string;\n  /** Default 369 ms. */\n  readonly throttleIntervalMs?: number;\n  /** Default `'G9SafeTapBehavior'`. */\n  readonly source?: string;\n  /** Default true. */\n  readonly showErrorPopup?: boolean;\n  /** `false` ignores taps (MAUI `CanExecute`). Default true. */\n  readonly canExecute?: boolean;\n}\n\nlet counter = 0;\n\n/**\n * A guarded tap for any element (MAUI `G9SafeTapBehavior`): returns a `bindtap` handler that runs `action` through the\n * provider's safe executor (throttle, one run at a time, errors to diagnostics and the popup). No busy state and no\n * visual feedback, as in MAUI. `numberOfTapsRequired` is read on every tap (MAUI read it once at attach).\n */\nexport function useSafeTap(\n  action: ((context: G9SafeRunContext) => unknown) | null | undefined,\n  options: G9SafeTapOptions = {},\n): () => void {\n  const executor = useG9Executor();\n  const key = useRef<string | null>(null);\n  if (key.current === null) key.current = `G9SafeTapBehavior:${++counter}`;\n  const taps = useRef<{ count: number; last: number }>({ count: 0, last: 0 });\n  return () => {\n    if (!action || options.canExecute === false) return;\n    const required = Math.max(1, Math.floor(options.numberOfTapsRequired ?? 1));\n    if (required > 1) {\n      const now = Date.now();\n      const window = options.multiTapWindowMs ?? 300;\n      taps.current =\n        now - taps.current.last <= window ? { count: taps.current.count + 1, last: now } : { count: 1, last: now };\n      if (taps.current.count < required) return;\n      taps.current = { count: 0, last: 0 };\n    }\n    executor.runSafe(action, {\n      throttleKey: options.throttleKey ?? (key.current as string),\n      enableThrottle: options.enableThrottle !== false,\n      ...(options.throttleIntervalMs !== undefined ? { throttleIntervalMs: options.throttleIntervalMs } : {}),\n      source: options.source ?? 'G9SafeTapBehavior',\n      showErrorPopup: options.showErrorPopup !== false,\n    });\n  };\n}\n"],"names":["counter","useSafeTap","action","options","executor","useG9Executor","key","useRef","taps","_options_numberOfTapsRequired","_options_throttleKey","_options_source","required","Math","_options_multiTapWindowMs","now","Date","window","undefined"],"mappings":";;AAwBA,IAAIA,UAAU;AAOP,SAASC,WACdC,MAAmE,EACnEC,UAA4B,CAAC,CAAC;IAE9B,MAAMC,WAAWC;IACjB,MAAMC,MAAMC,OAAsB;IAClC,IAAID,AAAgB,SAAhBA,IAAI,OAAO,EAAWA,IAAI,OAAO,GAAG,CAAC,kBAAkB,EAAE,EAAEN,SAAS;IACxE,MAAMQ,OAAOD,OAAwC;QAAE,OAAO;QAAG,MAAM;IAAE;IACzE,OAAO;YAEmCE,+BAUzBC,sBAGLC;QAdV,IAAI,CAACT,UAAUC,AAAuB,UAAvBA,QAAQ,UAAU,EAAY;QAC7C,MAAMS,WAAWC,KAAK,GAAG,CAAC,GAAGA,KAAK,KAAK,CAAC,QAAAJ,CAAAA,gCAAAA,QAAQ,oBAAoB,AAAD,IAA3BA,gCAAgC;QACxE,IAAIG,WAAW,GAAG;gBAEDE;YADf,MAAMC,MAAMC,KAAK,GAAG;YACpB,MAAMC,SAAS,QAAAH,CAAAA,4BAAAA,QAAQ,gBAAgB,AAAD,IAAvBA,4BAA4B;YAC3CN,KAAK,OAAO,GACVO,MAAMP,KAAK,OAAO,CAAC,IAAI,IAAIS,SAAS;gBAAE,OAAOT,KAAK,OAAO,CAAC,KAAK,GAAG;gBAAG,MAAMO;YAAI,IAAI;gBAAE,OAAO;gBAAG,MAAMA;YAAI;YAC3G,IAAIP,KAAK,OAAO,CAAC,KAAK,GAAGI,UAAU;YACnCJ,KAAK,OAAO,GAAG;gBAAE,OAAO;gBAAG,MAAM;YAAE;QACrC;QACAJ,SAAS,OAAO,CAACF,QAAQ;YACvB,aAAa,QAAAQ,CAAAA,uBAAAA,QAAQ,WAAW,AAAD,IAAlBA,uBAAwBJ,IAAI,OAAO;YAChD,gBAAgBH,AAA2B,UAA3BA,QAAQ,cAAc;YACtC,GAAIA,AAA+Be,WAA/Bf,QAAQ,kBAAkB,GAAiB;gBAAE,oBAAoBA,QAAQ,kBAAkB;YAAC,IAAI,CAAC,CAAC;YACtG,QAAQ,QAAAQ,CAAAA,kBAAAA,QAAQ,MAAM,AAAD,IAAbA,kBAAkB;YAC1B,gBAAgBR,AAA2B,UAA3BA,QAAQ,cAAc;QACxC;IACF;AACF"}

package/dist/button/safe.d.ts

@@ -0,0 +1,84 @@
+import { type G9SafeRunContext, type G9SafeRunResult } from '@g9tm/lynxcontrols-foundation';
+import { type G9ButtonProps } from './button.js';
+import { type G9IconButtonProps } from './icon-button.js';
+/** MAUI `G9SafeButtonType`: a subset of the button variants. */
+export declare const G9SafeButtonType: {
+    readonly Primary: "primary";
+    readonly Default: "default";
+    readonly Secondary: "secondary";
+    readonly Info: "info";
+    readonly Success: "success";
+    readonly Warning: "warning";
+    readonly Error: "error";
+    readonly Surface: "surface";
+    readonly Outline: "outline";
+};
+export type G9SafeButtonType = (typeof G9SafeButtonType)[keyof typeof G9SafeButtonType];
+/** The guarded action: `onExecute` (specs/03 §4). */
+export type G9SafeExecuteHandler = (context: G9SafeRunContext) => unknown;
+/** Options of the guarded execution shared by the safe buttons (MAUI `G9SafeExecution`). */
+export interface G9SafeExecutionProps {
+    /** The guarded action (MAUI `SafeCommand` / `SafeClickedCallbackAsync` / `SafeClickedAsync`). */
+    readonly onExecute?: G9SafeExecuteHandler;
+    /** More guarded handlers, awaited in order after `onExecute` (MAUI `SafeClickedAsync` subscribers). */
+    readonly onExecuteHandlers?: ReadonlyArray<G9SafeExecuteHandler>;
+    /** Guarded execution on; false: a tap only calls `onPress`. Default true. */
+    readonly enableSafeExecution?: boolean;
+    /** Block presses (dim 0.38) while busy. Default true. */
+    readonly disableWhileLoading?: boolean;
+    /** Show the spinner while busy. Default true. */
+    readonly showSpinnerWhileLoading?: boolean;
+    /** Diagnostics source. Default `'G9SafeButton'` / `'G9SafeIconButton'`. */
+    readonly source?: string;
+    /** Error popup message for an unexpected error. Default the localized `unexpectedError`. */
+    readonly errorMessage?: string;
+    /** Error popup title. Default the localized `error`. */
+    readonly errorTitle?: string;
+    /** Show the error popup. Default true. */
+    readonly showErrorPopup?: boolean;
+    /** Double-tap throttle. Default true. */
+    readonly enableThrottle?: boolean;
+    /** Throttle/concurrency key. Default one per instance. */
+    readonly throttleKey?: string;
+    /** Throttle interval. Default 369 ms. */
+    readonly throttleIntervalMs?: number;
+    /** Delay before the action starts (and before busy shows). Default 0. */
+    readonly busyDelayMs?: number;
+    /** `false` blocks the button and dims it (MAUI `Command.CanExecute`). Default true. */
+    readonly canExecute?: boolean;
+    /** Each guarded run's result (completed, skipped, cancelled, failed). */
+    readonly onResult?: (result: G9SafeRunResult<unknown>) => void;
+}
+/** Imperative handle of the safe buttons. */
+export interface G9SafeButtonHandle {
+    /** MAUI `SetLoadingState`: drives the spinner (when shown) and the block (when `disableWhileLoading`). */
+    setLoadingState(loading: boolean): void;
+    /** Runs the guarded action as a tap would (without `onPress`). */
+    execute(): Promise<G9SafeRunResult<unknown> | null>;
+}
+/** The guarded execution state machine of the safe buttons (one shared executor, specs/03 §4). */
+export declare function useSafeExecution(props: G9SafeExecutionProps, defaultSource: string): {
+    busy: boolean;
+    loading: boolean;
+    blocked: boolean;
+    execute: () => Promise<G9SafeRunResult<unknown> | null>;
+    setLoadingState: (loading: boolean) => void;
+};
+/** Props of {@link G9SafeButton} (MAUI `G9SafeButton`). */
+export interface G9SafeButtonProps extends G9ButtonProps, G9SafeExecutionProps {
+    /** Variant through the MAUI enum; when unset, `variant` (default primary) applies, as MAUI's never-applied default. */
+    readonly buttonType?: G9SafeButtonType;
+}
+/**
+ * Button with guarded execution (MAUI `G9SafeButton`): a tap calls `onPress`, then runs `onExecute` (and
+ * `onExecuteHandlers`) through the provider's safe executor: throttle (369 ms per key), one run at a time, optional
+ * delay, busy spinner + block while running, errors to diagnostics and the error popup, never thrown into the UI.
+ * Unmounting cancels the run.
+ */
+export declare const G9SafeButton: import("react").ForwardRefExoticComponent<G9SafeButtonProps & import("react").RefAttributes<G9SafeButtonHandle>>;
+/** Props of {@link G9SafeIconButton} (MAUI `G9SafeIconButton`). */
+export interface G9SafeIconButtonProps extends G9IconButtonProps, G9SafeExecutionProps {
+}
+/** Icon button with guarded execution (MAUI `G9SafeIconButton`); see {@link G9SafeButton}. */
+export declare const G9SafeIconButton: import("react").ForwardRefExoticComponent<G9SafeIconButtonProps & import("react").RefAttributes<G9SafeButtonHandle>>;
+//# sourceMappingURL=safe.d.ts.map

package/dist/button/safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../../src/button/safe.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAErE,gEAAgE;AAChE,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAExF,qDAAqD;AACrD,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC;AAE1E,4FAA4F;AAC5F,MAAM,WAAW,oBAAoB;IACnC,iGAAiG;IACjG,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAC1C,uGAAuG;IACvG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACjE,6EAA6E;IAC7E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,yDAAyD;IACzD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,iDAAiD;IACjD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CAChE;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,0GAA0G;IAC1G,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,kEAAkE;IAClE,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;CACrD;AAID,kGAAkG;AAClG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM;;;;mBAiBvD,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;+BAqCrC,OAAO;EAErC;AAED,2DAA2D;AAC3D,MAAM,WAAW,iBAAkB,SAAQ,aAAa,EAAE,oBAAoB;IAC5E,uHAAuH;IACvH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACxC;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,kHAmBxB,CAAC;AAEF,mEAAmE;AACnE,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB,EAAE,oBAAoB;CAAG;AAEzF,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,sHAgB5B,CAAC"}

package/dist/button/safe.jsx

@@ -0,0 +1,116 @@
+import { createAbortController } from "@g9tm/lynxcontrols-foundation";
+import { forwardRef, useEffect, useImperativeHandle, useRef, useState } from "@lynx-js/react";
+import { useG9Executor } from "../provider/hooks.jsx";
+import { G9Button } from "./button.jsx";
+import { G9IconButton } from "./icon-button.jsx";
+const G9SafeButtonType = {
+    Primary: 'primary',
+    Default: 'default',
+    Secondary: 'secondary',
+    Info: 'info',
+    Success: 'success',
+    Warning: 'warning',
+    Error: 'error',
+    Surface: 'surface',
+    Outline: 'outline'
+};
+let instanceCounter = 0;
+function useSafeExecution(props, defaultSource) {
+    const executor = useG9Executor();
+    const [busy, setBusy] = useState(false);
+    const key = useRef(null);
+    if (null === key.current) key.current = `${defaultSource}:${++instanceCounter}`;
+    const mount = useRef(null);
+    if (null === mount.current) mount.current = createAbortController();
+    const executing = useRef(false);
+    const latest = useRef(props);
+    latest.current = props;
+    useEffect(()=>{
+        const controller = mount.current;
+        return ()=>controller.abort();
+    }, []);
+    const showSpinner = false !== props.showSpinnerWhileLoading;
+    const blocked = busy && false !== props.disableWhileLoading || false === props.canExecute;
+    const execute = async ()=>{
+        var _p_onExecuteHandlers;
+        const p = latest.current;
+        if (false === p.enableSafeExecution || executing.current) return null;
+        const handlers = [
+            ...p.onExecute ? [
+                p.onExecute
+            ] : [],
+            ...null != (_p_onExecuteHandlers = p.onExecuteHandlers) ? _p_onExecuteHandlers : []
+        ];
+        if (0 === handlers.length) return null;
+        executing.current = true;
+        try {
+            var _p_throttleKey, _p_source;
+            var _p_onResult;
+            const result = await executor.run(async (context)=>{
+                for (const handler of handlers)await handler(context);
+            }, {
+                throttleKey: null != (_p_throttleKey = p.throttleKey) ? _p_throttleKey : key.current,
+                enableThrottle: false !== p.enableThrottle,
+                ...void 0 !== p.throttleIntervalMs ? {
+                    throttleIntervalMs: p.throttleIntervalMs
+                } : {},
+                ...void 0 !== p.busyDelayMs ? {
+                    busyDelayMs: p.busyDelayMs
+                } : {},
+                ...void 0 !== p.errorMessage ? {
+                    errorMessage: p.errorMessage
+                } : {},
+                ...void 0 !== p.errorTitle ? {
+                    errorTitle: p.errorTitle
+                } : {},
+                source: null != (_p_source = p.source) ? _p_source : defaultSource,
+                showErrorPopup: false !== p.showErrorPopup,
+                setBusy: (b)=>{
+                    if (!mount.current.signal.aborted) setBusy(b);
+                },
+                signal: mount.current.signal
+            });
+            null == (_p_onResult = p.onResult) || _p_onResult.call(p, result);
+            return result;
+        } finally{
+            executing.current = false;
+        }
+    };
+    return {
+        busy,
+        loading: busy && showSpinner,
+        blocked,
+        execute,
+        setLoadingState: (loading)=>setBusy(loading)
+    };
+}
+const safe_G9SafeButton = forwardRef(function(props, ref) {
+    var _ref, _props_buttonType;
+    const safe = useSafeExecution(props, 'G9SafeButton');
+    useImperativeHandle(ref, ()=>({
+            setLoadingState: safe.setLoadingState,
+            execute: safe.execute
+        }));
+    const variant = null != (_ref = null != (_props_buttonType = props.buttonType) ? _props_buttonType : props.variant) ? _ref : 'primary';
+    const onPress = ()=>{
+        var _props_onPress;
+        null == (_props_onPress = props.onPress) || _props_onPress.call(props);
+        safe.execute();
+    };
+    return <G9Button {...props} variant={variant} isLoading={true === props.isLoading || safe.loading} blocked={true === props.blocked || safe.blocked} onPress={onPress}/>;
+});
+const safe_G9SafeIconButton = forwardRef(function(props, ref) {
+    const safe = useSafeExecution(props, 'G9SafeIconButton');
+    useImperativeHandle(ref, ()=>({
+            setLoadingState: safe.setLoadingState,
+            execute: safe.execute
+        }));
+    return <G9IconButton {...props} isLoading={true === props.isLoading || safe.loading} blocked={true === props.blocked || safe.blocked} onPress={()=>{
+        var _props_onPress;
+        null == (_props_onPress = props.onPress) || _props_onPress.call(props);
+        safe.execute();
+    }}/>;
+});
+export { G9SafeButtonType, safe_G9SafeButton as G9SafeButton, safe_G9SafeIconButton as G9SafeIconButton, useSafeExecution };
+
+//# sourceMappingURL=safe.jsx.map

package/dist/button/safe.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"button/safe.jsx","sources":["../../src/button/safe.tsx"],"sourcesContent":["import {\n  createAbortController,\n  type G9AbortController,\n  type G9AbortSignal,\n  type G9ButtonVariant,\n  type G9SafeRunContext,\n  type G9SafeRunResult,\n} from '@g9tm/lynxcontrols-foundation';\nimport { forwardRef, type ReactNode, useEffect, useImperativeHandle, useRef, useState } from '@lynx-js/react';\nimport { useG9Executor } from '../provider/hooks';\nimport { G9Button, type G9ButtonProps } from './button';\nimport { G9IconButton, type G9IconButtonProps } from './icon-button';\n\n/** MAUI `G9SafeButtonType`: a subset of the button variants. */\nexport const G9SafeButtonType = {\n  Primary: 'primary',\n  Default: 'default',\n  Secondary: 'secondary',\n  Info: 'info',\n  Success: 'success',\n  Warning: 'warning',\n  Error: 'error',\n  Surface: 'surface',\n  Outline: 'outline',\n} as const;\nexport type G9SafeButtonType = (typeof G9SafeButtonType)[keyof typeof G9SafeButtonType];\n\n/** The guarded action: `onExecute` (specs/03 §4). */\nexport type G9SafeExecuteHandler = (context: G9SafeRunContext) => unknown;\n\n/** Options of the guarded execution shared by the safe buttons (MAUI `G9SafeExecution`). */\nexport interface G9SafeExecutionProps {\n  /** The guarded action (MAUI `SafeCommand` / `SafeClickedCallbackAsync` / `SafeClickedAsync`). */\n  readonly onExecute?: G9SafeExecuteHandler;\n  /** More guarded handlers, awaited in order after `onExecute` (MAUI `SafeClickedAsync` subscribers). */\n  readonly onExecuteHandlers?: ReadonlyArray<G9SafeExecuteHandler>;\n  /** Guarded execution on; false: a tap only calls `onPress`. Default true. */\n  readonly enableSafeExecution?: boolean;\n  /** Block presses (dim 0.38) while busy. Default true. */\n  readonly disableWhileLoading?: boolean;\n  /** Show the spinner while busy. Default true. */\n  readonly showSpinnerWhileLoading?: boolean;\n  /** Diagnostics source. Default `'G9SafeButton'` / `'G9SafeIconButton'`. */\n  readonly source?: string;\n  /** Error popup message for an unexpected error. Default the localized `unexpectedError`. */\n  readonly errorMessage?: string;\n  /** Error popup title. Default the localized `error`. */\n  readonly errorTitle?: string;\n  /** Show the error popup. Default true. */\n  readonly showErrorPopup?: boolean;\n  /** Double-tap throttle. Default true. */\n  readonly enableThrottle?: boolean;\n  /** Throttle/concurrency key. Default one per instance. */\n  readonly throttleKey?: string;\n  /** Throttle interval. Default 369 ms. */\n  readonly throttleIntervalMs?: number;\n  /** Delay before the action starts (and before busy shows). Default 0. */\n  readonly busyDelayMs?: number;\n  /** `false` blocks the button and dims it (MAUI `Command.CanExecute`). Default true. */\n  readonly canExecute?: boolean;\n  /** Each guarded run's result (completed, skipped, cancelled, failed). */\n  readonly onResult?: (result: G9SafeRunResult<unknown>) => void;\n}\n\n/** Imperative handle of the safe buttons. */\nexport interface G9SafeButtonHandle {\n  /** MAUI `SetLoadingState`: drives the spinner (when shown) and the block (when `disableWhileLoading`). */\n  setLoadingState(loading: boolean): void;\n  /** Runs the guarded action as a tap would (without `onPress`). */\n  execute(): Promise<G9SafeRunResult<unknown> | null>;\n}\n\nlet instanceCounter = 0;\n\n/** The guarded execution state machine of the safe buttons (one shared executor, specs/03 §4). */\nexport function useSafeExecution(props: G9SafeExecutionProps, defaultSource: string) {\n  const executor = useG9Executor();\n  const [busy, setBusy] = useState(false);\n  const key = useRef<string | null>(null);\n  if (key.current === null) key.current = `${defaultSource}:${++instanceCounter}`;\n  const mount = useRef<G9AbortController | null>(null);\n  if (mount.current === null) mount.current = createAbortController();\n  const executing = useRef(false);\n  const latest = useRef(props);\n  latest.current = props;\n  useEffect(() => {\n    const controller = mount.current as G9AbortController;\n    return () => controller.abort();\n  }, []);\n\n  const showSpinner = props.showSpinnerWhileLoading !== false;\n  const blocked = (busy && props.disableWhileLoading !== false) || props.canExecute === false;\n  const execute = async (): Promise<G9SafeRunResult<unknown> | null> => {\n    const p = latest.current;\n    if (p.enableSafeExecution === false || executing.current) return null;\n    const handlers = [...(p.onExecute ? [p.onExecute] : []), ...(p.onExecuteHandlers ?? [])];\n    if (handlers.length === 0) return null;\n    executing.current = true;\n    try {\n      const result = await executor.run(\n        async (context) => {\n          for (const handler of handlers) await handler(context);\n        },\n        {\n          throttleKey: p.throttleKey ?? (key.current as string),\n          enableThrottle: p.enableThrottle !== false,\n          ...(p.throttleIntervalMs !== undefined ? { throttleIntervalMs: p.throttleIntervalMs } : {}),\n          ...(p.busyDelayMs !== undefined ? { busyDelayMs: p.busyDelayMs } : {}),\n          ...(p.errorMessage !== undefined ? { errorMessage: p.errorMessage } : {}),\n          ...(p.errorTitle !== undefined ? { errorTitle: p.errorTitle } : {}),\n          source: p.source ?? defaultSource,\n          showErrorPopup: p.showErrorPopup !== false,\n          setBusy: (b) => {\n            if (!(mount.current as G9AbortController).signal.aborted) setBusy(b);\n          },\n          signal: (mount.current as G9AbortController).signal as G9AbortSignal,\n        },\n      );\n      p.onResult?.(result);\n      return result;\n    } finally {\n      executing.current = false;\n    }\n  };\n  return {\n    busy,\n    loading: busy && showSpinner,\n    blocked,\n    execute,\n    setLoadingState: (loading: boolean) => setBusy(loading),\n  };\n}\n\n/** Props of {@link G9SafeButton} (MAUI `G9SafeButton`). */\nexport interface G9SafeButtonProps extends G9ButtonProps, G9SafeExecutionProps {\n  /** Variant through the MAUI enum; when unset, `variant` (default primary) applies, as MAUI's never-applied default. */\n  readonly buttonType?: G9SafeButtonType;\n}\n\n/**\n * Button with guarded execution (MAUI `G9SafeButton`): a tap calls `onPress`, then runs `onExecute` (and\n * `onExecuteHandlers`) through the provider's safe executor: throttle (369 ms per key), one run at a time, optional\n * delay, busy spinner + block while running, errors to diagnostics and the error popup, never thrown into the UI.\n * Unmounting cancels the run.\n */\nexport const G9SafeButton = forwardRef<G9SafeButtonHandle, G9SafeButtonProps>(\n  function G9SafeButton(props, ref): ReactNode {\n    const safe = useSafeExecution(props, 'G9SafeButton');\n    useImperativeHandle(ref, () => ({ setLoadingState: safe.setLoadingState, execute: safe.execute }));\n    const variant: G9ButtonVariant = props.buttonType ?? props.variant ?? 'primary';\n    const onPress = () => {\n      props.onPress?.();\n      void safe.execute();\n    };\n    return (\n      <G9Button\n        {...props}\n        variant={variant}\n        isLoading={props.isLoading === true || safe.loading}\n        blocked={props.blocked === true || safe.blocked}\n        onPress={onPress}\n      />\n    );\n  },\n);\n\n/** Props of {@link G9SafeIconButton} (MAUI `G9SafeIconButton`). */\nexport interface G9SafeIconButtonProps extends G9IconButtonProps, G9SafeExecutionProps {}\n\n/** Icon button with guarded execution (MAUI `G9SafeIconButton`); see {@link G9SafeButton}. */\nexport const G9SafeIconButton = forwardRef<G9SafeButtonHandle, G9SafeIconButtonProps>(\n  function G9SafeIconButton(props, ref): ReactNode {\n    const safe = useSafeExecution(props, 'G9SafeIconButton');\n    useImperativeHandle(ref, () => ({ setLoadingState: safe.setLoadingState, execute: safe.execute }));\n    return (\n      <G9IconButton\n        {...props}\n        isLoading={props.isLoading === true || safe.loading}\n        blocked={props.blocked === true || safe.blocked}\n        onPress={() => {\n          props.onPress?.();\n          void safe.execute();\n        }}\n      />\n    );\n  },\n);\n"],"names":["G9SafeButtonType","instanceCounter","useSafeExecution","props","defaultSource","executor","useG9Executor","busy","setBusy","useState","key","useRef","mount","createAbortController","executing","latest","useEffect","controller","showSpinner","blocked","execute","_p_onExecuteHandlers","p","handlers","_p_throttleKey","_p_source","result","context","handler","undefined","b","loading","G9SafeButton","forwardRef","ref","_ref","safe","useImperativeHandle","variant","onPress","G9Button","G9SafeIconButton","G9IconButton"],"mappings":"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"}

package/dist/button/vertical-icon-text-button.d.ts

@@ -0,0 +1,18 @@
+import './button.css';
+import type { G9ImageSource } from '@g9tm/lynxcontrols-foundation';
+import type { ReactNode } from '@lynx-js/react';
+import { type G9ControlBaseProps } from '../base/control.js';
+/** Props of {@link G9VerticalIconTextButton} (MAUI `G9VerticalIconTextButton`). */
+export interface G9VerticalIconTextButtonProps extends G9ControlBaseProps {
+    readonly image?: G9ImageSource | null;
+    readonly text?: string | null;
+    /** Image box size. Default 32. */
+    readonly imageSize?: number;
+    readonly onPress?: () => void;
+}
+/**
+ * Image over a centred label in a bordered tile (MAUI `G9VerticalIconTextButton`). Unlike MAUI (its image and label
+ * took the touch), the press is on the root and honours `disabled` and the 300 ms guard.
+ */
+export declare function G9VerticalIconTextButton(props: G9VerticalIconTextButtonProps): ReactNode;
+//# sourceMappingURL=vertical-icon-text-button.d.ts.map

package/dist/button/vertical-icon-text-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertical-icon-text-button.d.ts","sourceRoot":"","sources":["../../src/button/vertical-icon-text-button.tsx"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,kBAAkB,EAAgB,MAAM,iBAAiB,CAAC;AAIxE,mFAAmF;AACnF,MAAM,WAAW,6BAA8B,SAAQ,kBAAkB;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,SAAS,CAkBxF"}

package/dist/button/vertical-icon-text-button.jsx

@@ -0,0 +1,21 @@
+import "./button.css";
+import { useG9Control } from "../base/control.jsx";
+import { useG9Press } from "../base/press.jsx";
+import { G9IconSlot } from "../icon/slot.jsx";
+function G9VerticalIconTextButton(props) {
+    var _props_accessibilityLabel, _ref, _props_accessibilityLabel1, _props_imageSize;
+    const control = useG9Control(props, 'g9-vertical-button');
+    const press = useG9Press(props.onPress, {
+        blocked: control.disabled,
+        source: 'G9VerticalIconTextButton'
+    });
+    return <view className={control.className} {...control.idProps} accessibility-element={true} accessibility-traits="button" {...(null != (_props_accessibilityLabel = props.accessibilityLabel) ? _props_accessibilityLabel : props.text) ? {
+        'accessibility-label': null != (_ref = null != (_props_accessibilityLabel1 = props.accessibilityLabel) ? _props_accessibilityLabel1 : props.text) ? _ref : ''
+    } : {}} bindtap={press}>
+      {props.image ? <G9IconSlot image={props.image} size={null != (_props_imageSize = props.imageSize) ? _props_imageSize : 32}/> : null}
+      {props.text ? <text className="g9-vertical-button__text">{props.text}</text> : null}
+    </view>;
+}
+export { G9VerticalIconTextButton };
+
+//# sourceMappingURL=vertical-icon-text-button.jsx.map

package/dist/button/vertical-icon-text-button.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"button/vertical-icon-text-button.jsx","sources":["../../src/button/vertical-icon-text-button.tsx"],"sourcesContent":["import './button.css';\nimport type { G9ImageSource } from '@g9tm/lynxcontrols-foundation';\nimport type { ReactNode } from '@lynx-js/react';\nimport { type G9ControlBaseProps, useG9Control } from '../base/control';\nimport { useG9Press } from '../base/press';\nimport { G9IconSlot } from '../icon/slot';\n\n/** Props of {@link G9VerticalIconTextButton} (MAUI `G9VerticalIconTextButton`). */\nexport interface G9VerticalIconTextButtonProps extends G9ControlBaseProps {\n  readonly image?: G9ImageSource | null;\n  readonly text?: string | null;\n  /** Image box size. Default 32. */\n  readonly imageSize?: number;\n  readonly onPress?: () => void;\n}\n\n/**\n * Image over a centred label in a bordered tile (MAUI `G9VerticalIconTextButton`). Unlike MAUI (its image and label\n * took the touch), the press is on the root and honours `disabled` and the 300 ms guard.\n */\nexport function G9VerticalIconTextButton(props: G9VerticalIconTextButtonProps): ReactNode {\n  const control = useG9Control(props, 'g9-vertical-button');\n  const press = useG9Press(props.onPress, { blocked: control.disabled, source: 'G9VerticalIconTextButton' });\n  return (\n    <view\n      className={control.className}\n      {...control.idProps}\n      accessibility-element={true}\n      accessibility-traits=\"button\"\n      {...((props.accessibilityLabel ?? props.text)\n        ? { 'accessibility-label': props.accessibilityLabel ?? props.text ?? '' }\n        : {})}\n      bindtap={press}\n    >\n      {props.image ? <G9IconSlot image={props.image} size={props.imageSize ?? 32} /> : null}\n      {props.text ? <text className=\"g9-vertical-button__text\">{props.text}</text> : null}\n    </view>\n  );\n}\n"],"names":["G9VerticalIconTextButton","props","_props_accessibilityLabel","_ref","_props_imageSize","control","useG9Control","press","useG9Press","view","G9IconSlot","text"],"mappings":";;;;AAoBO,SAASA,yBAAyBC,KAAoC;QASjEC,2BACuBC,MAAAA,4BAIwBC;IAbzD,MAAMC,UAAUC,aAAaL,OAAO;IACpC,MAAMM,QAAQC,WAAWP,MAAM,OAAO,EAAE;QAAE,SAASI,QAAQ,QAAQ;QAAE,QAAQ;IAA2B;IACxG,QACGI,KACC,WAAWJ,QAAQ,SAAS,GAC3B,GAAGA,QAAQ,OAAO,EACnB,uBAAuB,MACvB,qBAAqB,UACpB,GAAI,AAAC,SAAAH,CAAAA,4BAAAA,MAAM,kBAAkB,AAAD,IAAvBA,4BAA4BD,MAAM,IAAI,AAAD,IACvC;QAAE,uBAAuB,QAAAE,CAAAA,OAAAA,QAAAA,CAAAA,6BAAAA,MAAM,kBAAkB,AAAD,IAAvBA,6BAA4BF,MAAM,IAAI,AAAD,IAArCE,OAA0C;IAAG,IACtE,CAAC,CAAC,EACN,SAASI,OACV;MACC,CAACN,MAAM,KAAK,IAAIS,WAAW,OAAOT,MAAM,KAAK,EAAE,MAAM,QAAAG,CAAAA,mBAAAA,MAAM,SAAS,AAAD,IAAdA,mBAAmB,QAAS,KAAK;MACtF,CAACH,MAAM,IAAI,IAAIU,KAAK,UAAU,4BAA4BV,MAAM,IAAI,GAAGU,QAAQ,KAAK;IACtF,EAAEF;AAEN"}

package/dist/button/visuals.d.ts

@@ -0,0 +1,53 @@
+import { type G9ButtonVariant, type G9ControlSize, type G9PaletteValues } from '@g9tm/lynxcontrols-foundation';
+/** What a button paints (MAUI `G9Visuals.ButtonVisualResult` + the stroke/opacity rules of G9Button/G9IconButton). */
+export interface G9ButtonPaint {
+    /** CSS `background` (a colour or a vertical gradient). */
+    readonly background: string;
+    readonly text: string;
+    readonly stroke: string;
+    readonly strokeWidth: number;
+    /** 0.38 when not effectively enabled, 0.70 while loading, else 1. */
+    readonly opacity: number;
+}
+/** Inputs of {@link resolveButtonPaint}. */
+export interface G9ButtonPaintInput {
+    readonly variant: G9ButtonVariant;
+    readonly palette: G9PaletteValues;
+    /** `IsEnabled && !blocked`. */
+    readonly enabled: boolean;
+    readonly loading: boolean;
+    readonly baseBackgroundColor?: string | null | undefined;
+    readonly textColor?: string | null | undefined;
+    /** `'button'`: tonal has a 1.5 stroke; `'icon'`: only outline/text do (MAUI G9IconButton). */
+    readonly kind: 'button' | 'icon';
+}
+/**
+ * Resolves the paint of a button (MAUI `G9Button.OnApplyVisuals` / `G9IconButton.OnApplyVisuals`):
+ * - variant colours from `resolveButtonVariant`; the gradient only while enabled and not loading;
+ * - `baseBackgroundColor`: fully transparent → no fill, no border; otherwise a flat fill, contrasting text and a
+ *   darkened border (stroke 1 when visible);
+ * - `textColor` always wins for text/icon/spinner;
+ * - stroke 1.5 for outline/text (and tonal on `G9Button`), else 0.
+ * A colour that is not a parseable literal (e.g. a `var(--…)` token) is used as given: flat fill, the variant's text
+ * colour unless `textColor` is set, and no derived border.
+ */
+export declare function resolveButtonPaint(input: G9ButtonPaintInput): G9ButtonPaint;
+/** Size preset of `G9Button` (MAUI `ApplySizePreset`). */
+export interface G9ButtonSizePreset {
+    readonly height: number;
+    readonly paddingHorizontal: number;
+    readonly paddingVertical: number;
+    readonly fontSize: number;
+    /** Hero buttons fill the width. */
+    readonly fill: boolean;
+}
+/** MAUI G9Button size presets: small 36 / medium 44 / large 48 / hero 52. */
+export declare function buttonSizePreset(size: G9ControlSize): G9ButtonSizePreset;
+/** MAUI `FontAttributes`. */
+export type G9FontAttributes = 'none' | 'bold' | 'italic' | 'boldItalic';
+/** CSS for {@link G9FontAttributes}. */
+export declare function fontAttributesStyle(attributes: G9FontAttributes): {
+    fontWeight: 'bold' | 'normal';
+    fontStyle: 'italic' | 'normal';
+};
+//# sourceMappingURL=visuals.d.ts.map