@g9tm/lynxcontrols 0.0.0-stage → 1.4.0

package/dist/base/index.d.ts

@@ -0,0 +1,10 @@
+export { type G9ControlBaseProps, type G9ControlState, g9RowStyle, g9TextStart, useG9Control, } from './control.js';
+export { cornerBadgeWidth, G9CornerBadge, type G9CornerBadgeProps, g9CornerBadgeMetrics, hasCornerBadge, } from './corner-badge.js';
+export { createDisposer, type G9Disposer, useDisposer } from './disposer.js';
+export { type G9PressOptions, type G9PressVisual, g9PressGuardMs, useG9Press, usePressVisual } from './press.js';
+export { G9Pressable, type G9PressableProps, g9PressFeedbackDefaults } from './pressable.js';
+export { type G9SelectionItem, selectionKey } from './selection-item.js';
+export { type G9TimerHandle, startTimer, stopTimer } from './timers.js';
+export { type G9ControllableSetter, type G9ControllableStateOptions, useControllableState, } from './use-controllable-state.js';
+export { useStableCallback } from './use-stable-callback.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,KAAK,kBAAkB,EACvB,oBAAoB,EACpB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,KAAK,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,KAAK,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/base/index.jsx

@@ -0,0 +1,9 @@
+export { g9RowStyle, g9TextStart, useG9Control } from "./control.jsx";
+export { G9CornerBadge, cornerBadgeWidth, g9CornerBadgeMetrics, hasCornerBadge } from "./corner-badge.jsx";
+export { createDisposer, useDisposer } from "./disposer.jsx";
+export { g9PressGuardMs, useG9Press, usePressVisual } from "./press.jsx";
+export { G9Pressable, g9PressFeedbackDefaults } from "./pressable.jsx";
+export { selectionKey } from "./selection-item.jsx";
+export { startTimer, stopTimer } from "./timers.jsx";
+export { useControllableState } from "./use-controllable-state.jsx";
+export { useStableCallback } from "./use-stable-callback.jsx";

package/dist/base/press.d.ts

@@ -0,0 +1,38 @@
+/** Presses closer together than this are dropped (MAUI `G9Press` 300 ms double-fire guard). */
+export declare const g9PressGuardMs = 300;
+/** Options of {@link useG9Press}. */
+export interface G9PressOptions {
+    /** Blocks the press (disabled, loading, coming soon …). */
+    readonly blocked?: boolean;
+    /** Diagnostics source for a press handler that throws (e.g. `'G9Button'`). */
+    readonly source: string;
+    /** Double-fire guard in ms; 0 disables it. Default {@link g9PressGuardMs}. */
+    readonly guardMs?: number;
+}
+/**
+ * The press of a G9 control (MAUI `G9Press.Invoke`): one handler on the control root (`bindtap`), so a tap on any
+ * child (icon, label, badge) fires it exactly once. Blocked presses do nothing; a second press within `guardMs` is
+ * dropped; a handler that throws is reported to the provider diagnostics (MAUI `G9Press.ReportFailure`) and never
+ * escapes into the event loop. Returns a stable-per-render tap handler.
+ */
+export declare function useG9Press(onPress: (() => void) | undefined, options: G9PressOptions): () => void;
+/** A press visual: what the root's style becomes while pressed, and how fast it goes and comes back. */
+export interface G9PressVisual {
+    /** `'scale'` (transform) or `'opacity'`. */
+    readonly property: 'scale' | 'opacity';
+    readonly rest: number;
+    readonly pressed: number;
+    /** Press-in duration (ms). */
+    readonly inMs: number;
+    /** Release duration (ms). */
+    readonly outMs: number;
+    /** Hovered value (desktop pointer); `undefined` = no hover state. */
+    readonly hovered?: number;
+}
+/**
+ * Press feedback as main-thread twins (plan/specs/02 §3): the touch handlers run on the main thread and set the
+ * root's style directly, so the feedback starts on the frame of the touch and never re-renders React. Spread the
+ * returned props on the control root. Disabled: no feedback.
+ */
+export declare function usePressVisual(visual: G9PressVisual, disabled: boolean): Record<string, unknown>;
+//# sourceMappingURL=press.d.ts.map

package/dist/base/press.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"press.d.ts","sourceRoot":"","sources":["../../src/base/press.ts"],"names":[],"mappings":"AAGA,+FAA+F;AAC/F,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAOD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAyBjG;AAED,wGAAwG;AACxG,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqChG"}

package/dist/base/press.jsx

@@ -0,0 +1,73 @@
+import { useContext, useRef } from "@lynx-js/react";
+import { G9CoreContext, G9DiagnosticsContext } from "../provider/contexts.jsx";
+const g9PressGuardMs = 300;
+function monotonicNow(core) {
+    if (core) return core.services.clock.monotonicNow();
+    return Date.now();
+}
+function useG9Press(onPress, options) {
+    const core = useContext(G9CoreContext);
+    const diagnostics = useContext(G9DiagnosticsContext);
+    const last = useRef(-1 / 0);
+    return ()=>{
+        var _options_guardMs;
+        if (options.blocked || !onPress) return;
+        const guard = null != (_options_guardMs = options.guardMs) ? _options_guardMs : g9PressGuardMs;
+        const now = monotonicNow(core);
+        if (guard > 0 && now - last.current < guard) return;
+        last.current = now;
+        try {
+            onPress();
+        } catch (error) {
+            if (diagnostics) diagnostics.log({
+                level: 'error',
+                message: `${options.source}: press handler failed.`,
+                source: options.source,
+                error
+            });
+            else console.error(`[G9] ${options.source}: press handler failed.`, error);
+        }
+    };
+}
+function usePressVisual(visual, disabled) {
+    const property = visual.property;
+    const rest = visual.rest;
+    const pressed = visual.pressed;
+    const inMs = visual.inMs;
+    const outMs = visual.outMs;
+    const hovered = visual.hovered;
+    const apply = (target, value, ms)=>{
+        'main thread';
+        var _target_setStyleProperties;
+        const css = 'scale' === property ? 'transform' : 'opacity';
+        null == target || null == (_target_setStyleProperties = target.setStyleProperties) || _target_setStyleProperties.call(target, {
+            transition: `${css} ${ms}ms ease-out`,
+            [css]: 'scale' === property ? `scale(${value})` : String(value)
+        });
+    };
+    const onStart = (event)=>{
+        'main thread';
+        apply(event.currentTarget, pressed, inMs);
+    };
+    const onEnd = (event)=>{
+        'main thread';
+        apply(event.currentTarget, rest, outMs);
+    };
+    if (disabled) return {};
+    const props = {
+        'main-thread:bindtouchstart': onStart,
+        'main-thread:bindtouchend': onEnd,
+        'main-thread:bindtouchcancel': onEnd
+    };
+    if (void 0 !== hovered) {
+        props['main-thread:bindmouseenter'] = (event)=>{
+            'main thread';
+            apply(event.currentTarget, hovered, outMs);
+        };
+        props['main-thread:bindmouseleave'] = onEnd;
+    }
+    return props;
+}
+export { g9PressGuardMs, useG9Press, usePressVisual };
+
+//# sourceMappingURL=press.jsx.map

package/dist/base/press.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"base/press.jsx","sources":["../../src/base/press.ts"],"sourcesContent":["import { useContext, useRef } from '@lynx-js/react';\nimport { G9CoreContext, G9DiagnosticsContext } from '../provider/contexts';\n\n/** Presses closer together than this are dropped (MAUI `G9Press` 300 ms double-fire guard). */\nexport const g9PressGuardMs = 300;\n\n/** Options of {@link useG9Press}. */\nexport interface G9PressOptions {\n  /** Blocks the press (disabled, loading, coming soon …). */\n  readonly blocked?: boolean;\n  /** Diagnostics source for a press handler that throws (e.g. `'G9Button'`). */\n  readonly source: string;\n  /** Double-fire guard in ms; 0 disables it. Default {@link g9PressGuardMs}. */\n  readonly guardMs?: number;\n}\n\nfunction monotonicNow(core: { services: { clock: { monotonicNow(): number } } } | null): number {\n  if (core) return core.services.clock.monotonicNow();\n  return Date.now();\n}\n\n/**\n * The press of a G9 control (MAUI `G9Press.Invoke`): one handler on the control root (`bindtap`), so a tap on any\n * child (icon, label, badge) fires it exactly once. Blocked presses do nothing; a second press within `guardMs` is\n * dropped; a handler that throws is reported to the provider diagnostics (MAUI `G9Press.ReportFailure`) and never\n * escapes into the event loop. Returns a stable-per-render tap handler.\n */\nexport function useG9Press(onPress: (() => void) | undefined, options: G9PressOptions): () => void {\n  const core = useContext(G9CoreContext);\n  const diagnostics = useContext(G9DiagnosticsContext);\n  const last = useRef(Number.NEGATIVE_INFINITY);\n  return () => {\n    if (options.blocked || !onPress) return;\n    const guard = options.guardMs ?? g9PressGuardMs;\n    const now = monotonicNow(core);\n    if (guard > 0 && now - last.current < guard) return;\n    last.current = now;\n    try {\n      onPress();\n    } catch (error) {\n      if (diagnostics) {\n        diagnostics.log({\n          level: 'error',\n          message: `${options.source}: press handler failed.`,\n          source: options.source,\n          error,\n        });\n      } else {\n        console.error(`[G9] ${options.source}: press handler failed.`, error);\n      }\n    }\n  };\n}\n\n/** A press visual: what the root's style becomes while pressed, and how fast it goes and comes back. */\nexport interface G9PressVisual {\n  /** `'scale'` (transform) or `'opacity'`. */\n  readonly property: 'scale' | 'opacity';\n  readonly rest: number;\n  readonly pressed: number;\n  /** Press-in duration (ms). */\n  readonly inMs: number;\n  /** Release duration (ms). */\n  readonly outMs: number;\n  /** Hovered value (desktop pointer); `undefined` = no hover state. */\n  readonly hovered?: number;\n}\n\ninterface MainThreadTarget {\n  setStyleProperties?: (styles: Record<string, string>) => void;\n}\n\n/**\n * Press feedback as main-thread twins (plan/specs/02 §3): the touch handlers run on the main thread and set the\n * root's style directly, so the feedback starts on the frame of the touch and never re-renders React. Spread the\n * returned props on the control root. Disabled: no feedback.\n */\nexport function usePressVisual(visual: G9PressVisual, disabled: boolean): Record<string, unknown> {\n  const property = visual.property;\n  const rest = visual.rest;\n  const pressed = visual.pressed;\n  const inMs = visual.inMs;\n  const outMs = visual.outMs;\n  const hovered = visual.hovered;\n  const apply = (target: MainThreadTarget | undefined, value: number, ms: number) => {\n    'main thread';\n    const css = property === 'scale' ? 'transform' : 'opacity';\n    target?.setStyleProperties?.({\n      transition: `${css} ${ms}ms ease-out`,\n      [css]: property === 'scale' ? `scale(${value})` : String(value),\n    });\n  };\n  const onStart = (event: { currentTarget?: MainThreadTarget }) => {\n    'main thread';\n    apply(event.currentTarget, pressed, inMs);\n  };\n  const onEnd = (event: { currentTarget?: MainThreadTarget }) => {\n    'main thread';\n    apply(event.currentTarget, rest, outMs);\n  };\n  if (disabled) return {};\n  const props: Record<string, unknown> = {\n    'main-thread:bindtouchstart': onStart,\n    'main-thread:bindtouchend': onEnd,\n    'main-thread:bindtouchcancel': onEnd,\n  };\n  if (hovered !== undefined) {\n    props['main-thread:bindmouseenter'] = (event: { currentTarget?: MainThreadTarget }) => {\n      'main thread';\n      apply(event.currentTarget, hovered, outMs);\n    };\n    props['main-thread:bindmouseleave'] = onEnd;\n  }\n  return props;\n}\n"],"names":["g9PressGuardMs","monotonicNow","core","Date","useG9Press","onPress","options","useContext","G9CoreContext","diagnostics","G9DiagnosticsContext","last","useRef","Number","_options_guardMs","guard","now","error","console","usePressVisual","visual","disabled","property","rest","pressed","inMs","outMs","hovered","apply","target","value","ms","css","String","onStart","event","onEnd","props","undefined"],"mappings":";;AAIO,MAAMA,iBAAiB;AAY9B,SAASC,aAAaC,IAAgE;IACpF,IAAIA,MAAM,OAAOA,KAAK,QAAQ,CAAC,KAAK,CAAC,YAAY;IACjD,OAAOC,KAAK,GAAG;AACjB;AAQO,SAASC,WAAWC,OAAiC,EAAEC,OAAuB;IACnF,MAAMJ,OAAOK,WAAWC;IACxB,MAAMC,cAAcF,WAAWG;IAC/B,MAAMC,OAAOC,OAAOC,MAAwB;IAC5C,OAAO;YAESC;QADd,IAAIR,QAAQ,OAAO,IAAI,CAACD,SAAS;QACjC,MAAMU,QAAQ,QAAAD,CAAAA,mBAAAA,QAAQ,OAAO,AAAD,IAAdA,mBAAmBd;QACjC,MAAMgB,MAAMf,aAAaC;QACzB,IAAIa,QAAQ,KAAKC,MAAML,KAAK,OAAO,GAAGI,OAAO;QAC7CJ,KAAK,OAAO,GAAGK;QACf,IAAI;YACFX;QACF,EAAE,OAAOY,OAAO;YACd,IAAIR,aACFA,YAAY,GAAG,CAAC;gBACd,OAAO;gBACP,SAAS,GAAGH,QAAQ,MAAM,CAAC,uBAAuB,CAAC;gBACnD,QAAQA,QAAQ,MAAM;gBACtBW;YACF;iBAEAC,QAAQ,KAAK,CAAC,CAAC,KAAK,EAAEZ,QAAQ,MAAM,CAAC,uBAAuB,CAAC,EAAEW;QAEnE;IACF;AACF;AAyBO,SAASE,eAAeC,MAAqB,EAAEC,QAAiB;IACrE,MAAMC,WAAWF,OAAO,QAAQ;IAChC,MAAMG,OAAOH,OAAO,IAAI;IACxB,MAAMI,UAAUJ,OAAO,OAAO;IAC9B,MAAMK,OAAOL,OAAO,IAAI;IACxB,MAAMM,QAAQN,OAAO,KAAK;IAC1B,MAAMO,UAAUP,OAAO,OAAO;IAC9B,MAAMQ,QAAQ,CAACC,QAAsCC,OAAeC;QAClE;YAEAF;QADA,MAAMG,MAAMV,AAAa,YAAbA,WAAuB,cAAc;QACjDO,QAAAA,UAAAA,QAAAA,CAAAA,6BAAAA,OAAQ,kBAAkB,AAAD,KAAzBA,2BAAAA,IAAAA,CAAAA,QAA6B;YAC3B,YAAY,GAAGG,IAAI,CAAC,EAAED,GAAG,WAAW,CAAC;YACrC,CAACC,IAAI,EAAEV,AAAa,YAAbA,WAAuB,CAAC,MAAM,EAAEQ,MAAM,CAAC,CAAC,GAAGG,OAAOH;QAC3D;IACF;IACA,MAAMI,UAAU,CAACC;QACf;QACAP,MAAMO,MAAM,aAAa,EAAEX,SAASC;IACtC;IACA,MAAMW,QAAQ,CAACD;QACb;QACAP,MAAMO,MAAM,aAAa,EAAEZ,MAAMG;IACnC;IACA,IAAIL,UAAU,OAAO,CAAC;IACtB,MAAMgB,QAAiC;QACrC,8BAA8BH;QAC9B,4BAA4BE;QAC5B,+BAA+BA;IACjC;IACA,IAAIT,AAAYW,WAAZX,SAAuB;QACzBU,KAAK,CAAC,6BAA6B,GAAG,CAACF;YACrC;YACAP,MAAMO,MAAM,aAAa,EAAER,SAASD;QACtC;QACAW,KAAK,CAAC,6BAA6B,GAAGD;IACxC;IACA,OAAOC;AACT"}

package/dist/base/pressable.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from '@lynx-js/react';
+import { type G9ControlBaseProps } from './control.js';
+import { type G9PressVisual } from './press.js';
+/** The standard press feedback curve (MAUI `G9PressFeedbackBehavior` defaults: 1 / 0.86 / 0.78 over 110 ms). */
+export declare const g9PressFeedbackDefaults: G9PressVisual;
+/** Props of {@link G9Pressable}. */
+export interface G9PressableProps extends G9ControlBaseProps {
+    /** The press (MAUI `Command` + `CommandParameter`); one handler on the root, children never take the touch. */
+    readonly onPress?: () => void;
+    /** Opacity at rest. Default 1. */
+    readonly restOpacity?: number;
+    /** Opacity under a desktop pointer. Default 0.86. */
+    readonly hoveredOpacity?: number;
+    /** Opacity while pressed. Default 0.78. */
+    readonly pressedOpacity?: number;
+    /** Each tween's length. Default 110 ms. */
+    readonly animationDurationMs?: number;
+    readonly children?: ReactNode;
+}
+/**
+ * Opacity press feedback around any content (MAUI `G9PressFeedbackBehavior` attached to a view; `.For(command)` is
+ * `<G9Pressable onPress={…}>`). The feedback runs on the main thread; the press goes through `useG9Press`.
+ */
+export declare function G9Pressable(props: G9PressableProps): ReactNode;
+//# sourceMappingURL=pressable.d.ts.map

package/dist/base/pressable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pressable.d.ts","sourceRoot":"","sources":["../../src/base/pressable.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,kBAAkB,EAAgB,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,KAAK,aAAa,EAA8B,MAAM,SAAS,CAAC;AAEzE,gHAAgH;AAChH,eAAO,MAAM,uBAAuB,EAAE,aAOpC,CAAC;AAEH,oCAAoC;AACpC,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,+GAA+G;IAC/G,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CA4B9D"}

package/dist/base/pressable.jsx

@@ -0,0 +1,38 @@
+import { useG9Control } from "./control.jsx";
+import { useG9Press, usePressVisual } from "./press.jsx";
+const g9PressFeedbackDefaults = Object.freeze({
+    property: 'opacity',
+    rest: 1,
+    hovered: 0.86,
+    pressed: 0.78,
+    inMs: 110,
+    outMs: 110
+});
+function G9Pressable(props) {
+    var _props_animationDurationMs, _props_restOpacity, _props_hoveredOpacity, _props_pressedOpacity, _props_restOpacity1;
+    const control = useG9Control(props, 'g9-pressable');
+    const press = useG9Press(props.onPress, {
+        blocked: control.disabled,
+        source: 'G9Pressable'
+    });
+    const ms = null != (_props_animationDurationMs = props.animationDurationMs) ? _props_animationDurationMs : g9PressFeedbackDefaults.inMs;
+    const visual = usePressVisual({
+        property: 'opacity',
+        rest: null != (_props_restOpacity = props.restOpacity) ? _props_restOpacity : g9PressFeedbackDefaults.rest,
+        hovered: null != (_props_hoveredOpacity = props.hoveredOpacity) ? _props_hoveredOpacity : g9PressFeedbackDefaults.hovered,
+        pressed: null != (_props_pressedOpacity = props.pressedOpacity) ? _props_pressedOpacity : g9PressFeedbackDefaults.pressed,
+        inMs: ms,
+        outMs: ms
+    }, control.disabled);
+    return <view className={control.className} style={{
+        opacity: null != (_props_restOpacity1 = props.restOpacity) ? _props_restOpacity1 : 1
+    }} {...props.accessibilityLabel ? {
+        'accessibility-element': true,
+        'accessibility-label': props.accessibilityLabel
+    } : {}} bindtap={press} {...visual}>
+      {props.children}
+    </view>;
+}
+export { G9Pressable, g9PressFeedbackDefaults };
+
+//# sourceMappingURL=pressable.jsx.map

package/dist/base/pressable.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"base/pressable.jsx","sources":["../../src/base/pressable.tsx"],"sourcesContent":["import type { ReactNode } from '@lynx-js/react';\nimport { type G9ControlBaseProps, useG9Control } from './control';\nimport { type G9PressVisual, useG9Press, usePressVisual } from './press';\n\n/** The standard press feedback curve (MAUI `G9PressFeedbackBehavior` defaults: 1 / 0.86 / 0.78 over 110 ms). */\nexport const g9PressFeedbackDefaults: G9PressVisual = Object.freeze({\n  property: 'opacity',\n  rest: 1,\n  hovered: 0.86,\n  pressed: 0.78,\n  inMs: 110,\n  outMs: 110,\n});\n\n/** Props of {@link G9Pressable}. */\nexport interface G9PressableProps extends G9ControlBaseProps {\n  /** The press (MAUI `Command` + `CommandParameter`); one handler on the root, children never take the touch. */\n  readonly onPress?: () => void;\n  /** Opacity at rest. Default 1. */\n  readonly restOpacity?: number;\n  /** Opacity under a desktop pointer. Default 0.86. */\n  readonly hoveredOpacity?: number;\n  /** Opacity while pressed. Default 0.78. */\n  readonly pressedOpacity?: number;\n  /** Each tween's length. Default 110 ms. */\n  readonly animationDurationMs?: number;\n  readonly children?: ReactNode;\n}\n\n/**\n * Opacity press feedback around any content (MAUI `G9PressFeedbackBehavior` attached to a view; `.For(command)` is\n * `<G9Pressable onPress={…}>`). The feedback runs on the main thread; the press goes through `useG9Press`.\n */\nexport function G9Pressable(props: G9PressableProps): ReactNode {\n  const control = useG9Control(props, 'g9-pressable');\n  const press = useG9Press(props.onPress, { blocked: control.disabled, source: 'G9Pressable' });\n  const ms = props.animationDurationMs ?? g9PressFeedbackDefaults.inMs;\n  const visual = usePressVisual(\n    {\n      property: 'opacity',\n      rest: props.restOpacity ?? g9PressFeedbackDefaults.rest,\n      hovered: props.hoveredOpacity ?? (g9PressFeedbackDefaults.hovered as number),\n      pressed: props.pressedOpacity ?? g9PressFeedbackDefaults.pressed,\n      inMs: ms,\n      outMs: ms,\n    },\n    control.disabled,\n  );\n  return (\n    <view\n      className={control.className}\n      style={{ opacity: props.restOpacity ?? 1 }}\n      {...(props.accessibilityLabel\n        ? { 'accessibility-element': true, 'accessibility-label': props.accessibilityLabel }\n        : {})}\n      bindtap={press}\n      {...visual}\n    >\n      {props.children}\n    </view>\n  );\n}\n"],"names":["g9PressFeedbackDefaults","Object","G9Pressable","props","_props_animationDurationMs","_props_restOpacity","_props_hoveredOpacity","_props_pressedOpacity","_props_restOpacity1","control","useG9Control","press","useG9Press","ms","visual","usePressVisual","view"],"mappings":";;AAKO,MAAMA,0BAAyCC,OAAO,MAAM,CAAC;IAClE,UAAU;IACV,MAAM;IACN,SAAS;IACT,SAAS;IACT,MAAM;IACN,OAAO;AACT;AAqBO,SAASC,YAAYC,KAAuB;QAGtCC,4BAIDC,oBACGC,uBACAC,uBASSC;IAjBtB,MAAMC,UAAUC,aAAaP,OAAO;IACpC,MAAMQ,QAAQC,WAAWT,MAAM,OAAO,EAAE;QAAE,SAASM,QAAQ,QAAQ;QAAE,QAAQ;IAAc;IAC3F,MAAMI,KAAK,QAAAT,CAAAA,6BAAAA,MAAM,mBAAmB,AAAD,IAAxBA,6BAA6BJ,wBAAwB,IAAI;IACpE,MAAMc,SAASC,eACb;QACE,UAAU;QACV,MAAM,QAAAV,CAAAA,qBAAAA,MAAM,WAAW,AAAD,IAAhBA,qBAAqBL,wBAAwB,IAAI;QACvD,SAAS,QAAAM,CAAAA,wBAAAA,MAAM,cAAc,AAAD,IAAnBA,wBAAyBN,wBAAwB,OAAO;QACjE,SAAS,QAAAO,CAAAA,wBAAAA,MAAM,cAAc,AAAD,IAAnBA,wBAAwBP,wBAAwB,OAAO;QAChE,MAAMa;QACN,OAAOA;IACT,GACAJ,QAAQ,QAAQ;IAElB,QACGO,KACC,WAAWP,QAAQ,SAAS,EAC5B,OAAO;QAAE,SAAS,QAAAD,CAAAA,sBAAAA,MAAM,WAAW,AAAD,IAAhBA,sBAAqB;IAAE,IACxC,GAAIL,MAAM,kBAAkB,GACzB;QAAE,yBAAyB;QAAM,uBAAuBA,MAAM,kBAAkB;IAAC,IACjF,CAAC,CAAC,EACN,SAASQ,QACR,GAAGG,MAAM,EACX;MACC,CAACX,MAAM,QAAQ,CAAC;IAClB,EAAEa;AAEN"}

package/dist/base/selection-item.d.ts

@@ -0,0 +1,29 @@
+import type { G9ImageSource } from '@g9tm/lynxcontrols-foundation';
+import type { G9IconInput } from '../icon/icon.js';
+/**
+ * One selectable item (MAUI `G9SelectionItem`), shared by the chip group (WP04), the selection sheet and the pickers
+ * (WP05/WP06). Plain data: create it inline or map your own objects to it.
+ */
+export interface G9SelectionItem<TValue = unknown> {
+    readonly text: string;
+    /** Stable identity; when blank, `text` is the identity (MAUI `SelectionIdentity`). */
+    readonly key?: string | null | undefined;
+    readonly emoji?: string | null | undefined;
+    readonly icon?: G9IconInput | undefined;
+    readonly iconPath?: string | null | undefined;
+    readonly iconImage?: G9ImageSource | null | undefined;
+    readonly iconTintColor?: string | null | undefined;
+    /** Colour swatch (one colour = circle, two = split circle). */
+    readonly swatchFirstColor?: string | null | undefined;
+    readonly swatchSecondColor?: string | null | undefined;
+    /** App payload, never read by the controls. */
+    readonly value?: TValue | undefined;
+    /** Default true. */
+    readonly isEnabled?: boolean | undefined;
+    /** Selected fill override (wins over the group's). */
+    readonly selectedColor?: string | null | undefined;
+    readonly selectedTextColor?: string | null | undefined;
+}
+/** The identity of an item: `key` unless blank, else `text` (MAUI `G9SelectionItem.SelectionIdentity`). */
+export declare function selectionKey(item: Pick<G9SelectionItem, 'key' | 'text'>): string;
+//# sourceMappingURL=selection-item.d.ts.map

package/dist/base/selection-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-item.d.ts","sourceRoot":"","sources":["../../src/base/selection-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,OAAO;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,+DAA+D;IAC/D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,oBAAoB;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,sDAAsD;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACxD;AAED,2GAA2G;AAC3G,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAEhF"}

package/dist/base/selection-item.jsx

@@ -0,0 +1,6 @@
+function selectionKey(item) {
+    return null != item.key && '' !== item.key.trim() ? item.key : item.text;
+}
+export { selectionKey };
+
+//# sourceMappingURL=selection-item.jsx.map

package/dist/base/selection-item.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"base/selection-item.jsx","sources":["../../src/base/selection-item.ts"],"sourcesContent":["import type { G9ImageSource } from '@g9tm/lynxcontrols-foundation';\nimport type { G9IconInput } from '../icon/icon';\n\n/**\n * One selectable item (MAUI `G9SelectionItem`), shared by the chip group (WP04), the selection sheet and the pickers\n * (WP05/WP06). Plain data: create it inline or map your own objects to it.\n */\nexport interface G9SelectionItem<TValue = unknown> {\n  readonly text: string;\n  /** Stable identity; when blank, `text` is the identity (MAUI `SelectionIdentity`). */\n  readonly key?: string | null | undefined;\n  readonly emoji?: string | null | undefined;\n  readonly icon?: G9IconInput | undefined;\n  readonly iconPath?: string | null | undefined;\n  readonly iconImage?: G9ImageSource | null | undefined;\n  readonly iconTintColor?: string | null | undefined;\n  /** Colour swatch (one colour = circle, two = split circle). */\n  readonly swatchFirstColor?: string | null | undefined;\n  readonly swatchSecondColor?: string | null | undefined;\n  /** App payload, never read by the controls. */\n  readonly value?: TValue | undefined;\n  /** Default true. */\n  readonly isEnabled?: boolean | undefined;\n  /** Selected fill override (wins over the group's). */\n  readonly selectedColor?: string | null | undefined;\n  readonly selectedTextColor?: string | null | undefined;\n}\n\n/** The identity of an item: `key` unless blank, else `text` (MAUI `G9SelectionItem.SelectionIdentity`). */\nexport function selectionKey(item: Pick<G9SelectionItem, 'key' | 'text'>): string {\n  return item.key != null && item.key.trim() !== '' ? item.key : item.text;\n}\n"],"names":["selectionKey","item"],"mappings":"AA6BO,SAASA,aAAaC,IAA2C;IACtE,OAAOA,AAAY,QAAZA,KAAK,GAAG,IAAYA,AAAoB,OAApBA,KAAK,GAAG,CAAC,IAAI,KAAYA,KAAK,GAAG,GAAGA,KAAK,IAAI;AAC1E"}

package/dist/base/timers.d.ts

@@ -0,0 +1,7 @@
+/** A timer handle as the runtime returns it. */
+export type G9TimerHandle = unknown;
+/** Schedules `callback` after `ms` milliseconds (negative is treated as 0). */
+export declare function startTimer(callback: () => void, ms: number): G9TimerHandle;
+/** Cancels a timer from {@link startTimer}; cancelling twice or after it fired is harmless. */
+export declare function stopTimer(handle: G9TimerHandle): void;
+//# sourceMappingURL=timers.d.ts.map

package/dist/base/timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../src/base/timers.ts"],"names":[],"mappings":"AAIA,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAEpC,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAE1E;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAErD"}

package/dist/base/timers.jsx

@@ -0,0 +1,10 @@
+import { g9RuntimeTimers } from "@g9tm/lynxcontrols-foundation";
+function startTimer(callback, ms) {
+    return g9RuntimeTimers.setTimeout(callback, Math.max(0, ms));
+}
+function stopTimer(handle) {
+    g9RuntimeTimers.clearTimeout(handle);
+}
+export { startTimer, stopTimer };
+
+//# sourceMappingURL=timers.jsx.map

package/dist/base/timers.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"base/timers.jsx","sources":["../../src/base/timers.ts"],"sourcesContent":["// The runtime timers: foundation's `g9RuntimeTimers` (bundle-scope `setTimeout` / `clearTimeout`; Lynx does not put\n// them on `globalThis`). Every G9 control timer goes through here so a disposer can clear it and tests can fake it.\nimport { g9RuntimeTimers } from '@g9tm/lynxcontrols-foundation';\n\n/** A timer handle as the runtime returns it. */\nexport type G9TimerHandle = unknown;\n\n/** Schedules `callback` after `ms` milliseconds (negative is treated as 0). */\nexport function startTimer(callback: () => void, ms: number): G9TimerHandle {\n  return g9RuntimeTimers.setTimeout(callback, Math.max(0, ms));\n}\n\n/** Cancels a timer from {@link startTimer}; cancelling twice or after it fired is harmless. */\nexport function stopTimer(handle: G9TimerHandle): void {\n  g9RuntimeTimers.clearTimeout(handle);\n}\n"],"names":["startTimer","callback","ms","g9RuntimeTimers","Math","stopTimer","handle"],"mappings":";AAQO,SAASA,WAAWC,QAAoB,EAAEC,EAAU;IACzD,OAAOC,gBAAgB,UAAU,CAACF,UAAUG,KAAK,GAAG,CAAC,GAAGF;AAC1D;AAGO,SAASG,UAAUC,MAAqB;IAC7CH,gBAAgB,YAAY,CAACG;AAC/B"}

package/dist/base/use-controllable-state.d.ts

@@ -0,0 +1,30 @@
+/** Inputs of {@link useControllableState}: one MAUI two-way property (plan/specs/03 §3). */
+export interface G9ControllableStateOptions<T, TExtra extends unknown[]> {
+    /** The controlled value. Present (anything but `undefined`, `null` included) means the caller owns the state. */
+    readonly value: T | undefined;
+    /** The initial value while uncontrolled. Read once, on the first render. */
+    readonly defaultValue: T;
+    /** Told once per logical change, with any extra payload the setter received (e.g. `{ source }`). */
+    readonly onChange?: ((value: T, ...extra: TExtra) => void) | undefined;
+    /** Names the prop in the development diagnostic, e.g. `'G9Switch.checked'`. */
+    readonly name: string;
+    /** Equality of two values; a setter call with an equal value changes nothing. Default `Object.is`. */
+    readonly equals?: ((a: T, b: T) => boolean) | undefined;
+}
+/** Sets the value: a value or an updater of the current one, plus the extra payload for `onChange`. */
+export type G9ControllableSetter<T, TExtra extends unknown[]> = (next: T | ((current: T) => T), ...extra: TExtra) => void;
+/**
+ * The library's only implementation of controlled/uncontrolled state (plan/specs/03 §3, WP02 design note).
+ *
+ * - Controlled (`value !== undefined`): the returned value is always `value`; the setter only calls `onChange`.
+ * - Uncontrolled: the hook keeps the state, starting at `defaultValue` (read once).
+ * - `onChange` fires once per logical change: never for a value equal to the current one and never for a value the
+ *   parent pushed in through `value`.
+ * - Switching between controlled and uncontrolled during the component's life emits one development diagnostic
+ *   (a `warning` log on the provider's diagnostics hub, or `console.warn` outside a provider) and keeps working with
+ *   the new mode.
+ *
+ * The setter's identity is stable. `T` must not be a function type (a function argument is an updater).
+ */
+export declare function useControllableState<T, TExtra extends unknown[] = []>(options: G9ControllableStateOptions<T, TExtra>): [T, G9ControllableSetter<T, TExtra>];
+//# sourceMappingURL=use-controllable-state.d.ts.map

package/dist/base/use-controllable-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-controllable-state.d.ts","sourceRoot":"","sources":["../../src/base/use-controllable-state.ts"],"names":[],"mappings":"AAIA,4FAA4F;AAC5F,MAAM,WAAW,0BAA0B,CAAC,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE;IACrE,iHAAiH;IACjH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACzB,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACvE,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sGAAsG;IACtG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CACzD;AAED,uGAAuG;AACvG,MAAM,MAAM,oBAAoB,CAAC,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,IAAI,CAC9D,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAC7B,GAAG,KAAK,EAAE,MAAM,KACb,IAAI,CAAC;AAEV;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,GAAG,EAAE,EACnE,OAAO,EAAE,0BAA0B,CAAC,CAAC,EAAE,MAAM,CAAC,GAC7C,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAyCtC"}

package/dist/base/use-controllable-state.jsx

@@ -0,0 +1,49 @@
+import { useContext, useRef, useState } from "@lynx-js/react";
+import { G9DiagnosticsContext } from "../provider/contexts.jsx";
+import { useStableCallback } from "./use-stable-callback.jsx";
+function useControllableState(options) {
+    const { value, defaultValue, name } = options;
+    const controlled = void 0 !== value;
+    const [internal, setInternal] = useState(defaultValue);
+    const diagnostics = useContext(G9DiagnosticsContext);
+    const wasControlled = useRef(controlled);
+    const warned = useRef(false);
+    if (wasControlled.current !== controlled) {
+        if (!warned.current) {
+            warned.current = true;
+            const message = `${name} switched from ${wasControlled.current ? 'controlled' : 'uncontrolled'} to ${controlled ? 'controlled' : 'uncontrolled'}. Decide once: pass the value on every render, or never.`;
+            if (diagnostics) diagnostics.log({
+                level: 'warning',
+                message,
+                source: name
+            });
+            else console.warn(`[G9] ${message}`);
+        }
+        wasControlled.current = controlled;
+    }
+    const current = controlled ? value : internal;
+    const latest = useRef(current);
+    latest.current = current;
+    const notify = useStableCallback(options.onChange);
+    const equals = useRef(options.equals);
+    equals.current = options.equals;
+    const isControlled = useRef(controlled);
+    isControlled.current = controlled;
+    const setValue = useStableCallback((next, ...extra)=>{
+        var _equals_current;
+        const resolved = 'function' == typeof next ? next(latest.current) : next;
+        if ((null != (_equals_current = equals.current) ? _equals_current : Object.is)(latest.current, resolved)) return;
+        if (!isControlled.current) {
+            latest.current = resolved;
+            setInternal(()=>resolved);
+        }
+        notify(resolved, ...extra);
+    });
+    return [
+        current,
+        setValue
+    ];
+}
+export { useControllableState };
+
+//# sourceMappingURL=use-controllable-state.jsx.map

package/dist/base/use-controllable-state.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"base/use-controllable-state.jsx","sources":["../../src/base/use-controllable-state.ts"],"sourcesContent":["import { useContext, useRef, useState } from '@lynx-js/react';\nimport { G9DiagnosticsContext } from '../provider/contexts';\nimport { useStableCallback } from './use-stable-callback';\n\n/** Inputs of {@link useControllableState}: one MAUI two-way property (plan/specs/03 §3). */\nexport interface G9ControllableStateOptions<T, TExtra extends unknown[]> {\n  /** The controlled value. Present (anything but `undefined`, `null` included) means the caller owns the state. */\n  readonly value: T | undefined;\n  /** The initial value while uncontrolled. Read once, on the first render. */\n  readonly defaultValue: T;\n  /** Told once per logical change, with any extra payload the setter received (e.g. `{ source }`). */\n  readonly onChange?: ((value: T, ...extra: TExtra) => void) | undefined;\n  /** Names the prop in the development diagnostic, e.g. `'G9Switch.checked'`. */\n  readonly name: string;\n  /** Equality of two values; a setter call with an equal value changes nothing. Default `Object.is`. */\n  readonly equals?: ((a: T, b: T) => boolean) | undefined;\n}\n\n/** Sets the value: a value or an updater of the current one, plus the extra payload for `onChange`. */\nexport type G9ControllableSetter<T, TExtra extends unknown[]> = (\n  next: T | ((current: T) => T),\n  ...extra: TExtra\n) => void;\n\n/**\n * The library's only implementation of controlled/uncontrolled state (plan/specs/03 §3, WP02 design note).\n *\n * - Controlled (`value !== undefined`): the returned value is always `value`; the setter only calls `onChange`.\n * - Uncontrolled: the hook keeps the state, starting at `defaultValue` (read once).\n * - `onChange` fires once per logical change: never for a value equal to the current one and never for a value the\n *   parent pushed in through `value`.\n * - Switching between controlled and uncontrolled during the component's life emits one development diagnostic\n *   (a `warning` log on the provider's diagnostics hub, or `console.warn` outside a provider) and keeps working with\n *   the new mode.\n *\n * The setter's identity is stable. `T` must not be a function type (a function argument is an updater).\n */\nexport function useControllableState<T, TExtra extends unknown[] = []>(\n  options: G9ControllableStateOptions<T, TExtra>,\n): [T, G9ControllableSetter<T, TExtra>] {\n  const { value, defaultValue, name } = options;\n  const controlled = value !== undefined;\n  const [internal, setInternal] = useState<T>(defaultValue);\n  const diagnostics = useContext(G9DiagnosticsContext);\n\n  const wasControlled = useRef(controlled);\n  const warned = useRef(false);\n  if (wasControlled.current !== controlled) {\n    if (!warned.current) {\n      warned.current = true;\n      const message =\n        `${name} switched from ${wasControlled.current ? 'controlled' : 'uncontrolled'} to ` +\n        `${controlled ? 'controlled' : 'uncontrolled'}. Decide once: pass the value on every render, or never.`;\n      if (diagnostics) diagnostics.log({ level: 'warning', message, source: name });\n      else console.warn(`[G9] ${message}`);\n    }\n    wasControlled.current = controlled;\n  }\n\n  const current = controlled ? value : internal;\n  const latest = useRef(current);\n  latest.current = current;\n\n  const notify = useStableCallback(options.onChange);\n  const equals = useRef(options.equals);\n  equals.current = options.equals;\n  const isControlled = useRef(controlled);\n  isControlled.current = controlled;\n\n  const setValue = useStableCallback((next: T | ((current: T) => T), ...extra: TExtra) => {\n    const resolved = typeof next === 'function' ? (next as (current: T) => T)(latest.current) : next;\n    if ((equals.current ?? Object.is)(latest.current, resolved)) return;\n    if (!isControlled.current) {\n      latest.current = resolved;\n      setInternal(() => resolved);\n    }\n    notify(resolved, ...extra);\n  }) as G9ControllableSetter<T, TExtra>;\n\n  return [current, setValue];\n}\n"],"names":["useControllableState","options","value","defaultValue","name","controlled","undefined","internal","setInternal","useState","diagnostics","useContext","G9DiagnosticsContext","wasControlled","useRef","warned","message","console","current","latest","notify","useStableCallback","equals","isControlled","setValue","next","extra","_equals_current","resolved","Object"],"mappings":";;;AAqCO,SAASA,qBACdC,OAA8C;IAE9C,MAAM,EAAEC,KAAK,EAAEC,YAAY,EAAEC,IAAI,EAAE,GAAGH;IACtC,MAAMI,aAAaH,AAAUI,WAAVJ;IACnB,MAAM,CAACK,UAAUC,YAAY,GAAGC,SAAYN;IAC5C,MAAMO,cAAcC,WAAWC;IAE/B,MAAMC,gBAAgBC,OAAOT;IAC7B,MAAMU,SAASD,OAAO;IACtB,IAAID,cAAc,OAAO,KAAKR,YAAY;QACxC,IAAI,CAACU,OAAO,OAAO,EAAE;YACnBA,OAAO,OAAO,GAAG;YACjB,MAAMC,UACJ,GAAGZ,KAAK,eAAe,EAAES,cAAc,OAAO,GAAG,eAAe,eAC/D,MAAER,aAAa,eAAe,eAAe,wDAAwD,CADlB;YAEtF,IAAIK,aAAaA,YAAY,GAAG,CAAC;gBAAE,OAAO;gBAAWM;gBAAS,QAAQZ;YAAK;iBACtEa,QAAQ,IAAI,CAAC,CAAC,KAAK,EAAED,SAAS;QACrC;QACAH,cAAc,OAAO,GAAGR;IAC1B;IAEA,MAAMa,UAAUb,aAAaH,QAAQK;IACrC,MAAMY,SAASL,OAAOI;IACtBC,OAAO,OAAO,GAAGD;IAEjB,MAAME,SAASC,kBAAkBpB,QAAQ,QAAQ;IACjD,MAAMqB,SAASR,OAAOb,QAAQ,MAAM;IACpCqB,OAAO,OAAO,GAAGrB,QAAQ,MAAM;IAC/B,MAAMsB,eAAeT,OAAOT;IAC5BkB,aAAa,OAAO,GAAGlB;IAEvB,MAAMmB,WAAWH,kBAAkB,CAACI,MAA+B,GAAGC;YAE/DC;QADL,MAAMC,WAAW,AAAgB,cAAhB,OAAOH,OAAuBA,KAA2BN,OAAO,OAAO,IAAIM;QAC5F,IAAI,AAAC,SAAAE,CAAAA,kBAAAA,OAAO,OAAO,AAAD,IAAbA,kBAAkBE,OAAO,EAAE,AAAD,EAAGV,OAAO,OAAO,EAAES,WAAW;QAC7D,IAAI,CAACL,aAAa,OAAO,EAAE;YACzBJ,OAAO,OAAO,GAAGS;YACjBpB,YAAY,IAAMoB;QACpB;QACAR,OAAOQ,aAAaF;IACtB;IAEA,OAAO;QAACR;QAASM;KAAS;AAC5B"}

package/dist/base/use-stable-callback.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A function whose identity never changes but which always calls the latest `callback` (the "event handler ref"
+ * pattern). Use it for callbacks handed to subscriptions, timers and child props, so a parent re-render neither
+ * re-subscribes nor re-renders a memoised child. It always calls the callback of the most recent
+ * render. `undefined` makes it a no-op that returns `undefined` (an optional callback prop).
+ */
+export declare function useStableCallback<TArgs extends unknown[], TResult>(callback: ((...args: TArgs) => TResult) | undefined): (...args: TArgs) => TResult | undefined;
+//# sourceMappingURL=use-stable-callback.d.ts.map

package/dist/base/use-stable-callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stable-callback.d.ts","sourceRoot":"","sources":["../../src/base/use-stable-callback.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAChE,QAAQ,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,SAAS,GAClD,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAAG,SAAS,CAIzC"}

package/dist/base/use-stable-callback.jsx

@@ -0,0 +1,12 @@
+import { useCallback, useRef } from "@lynx-js/react";
+function useStableCallback(callback) {
+    const latest = useRef(callback);
+    latest.current = callback;
+    return useCallback((...args)=>{
+        var _latest_current;
+        return null == (_latest_current = latest.current) ? void 0 : _latest_current.call(latest, ...args);
+    }, []);
+}
+export { useStableCallback };
+
+//# sourceMappingURL=use-stable-callback.jsx.map

package/dist/base/use-stable-callback.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"base/use-stable-callback.jsx","sources":["../../src/base/use-stable-callback.ts"],"sourcesContent":["import { useCallback, useRef } from '@lynx-js/react';\n\n/**\n * A function whose identity never changes but which always calls the latest `callback` (the \"event handler ref\"\n * pattern). Use it for callbacks handed to subscriptions, timers and child props, so a parent re-render neither\n * re-subscribes nor re-renders a memoised child. It always calls the callback of the most recent\n * render. `undefined` makes it a no-op that returns `undefined` (an optional callback prop).\n */\nexport function useStableCallback<TArgs extends unknown[], TResult>(\n  callback: ((...args: TArgs) => TResult) | undefined,\n): (...args: TArgs) => TResult | undefined {\n  const latest = useRef(callback);\n  latest.current = callback;\n  return useCallback((...args: TArgs) => latest.current?.(...args), []);\n}\n"],"names":["useStableCallback","callback","latest","useRef","useCallback","args"],"mappings":";AAQO,SAASA,kBACdC,QAAmD;IAEnD,MAAMC,SAASC,OAAOF;IACtBC,OAAO,OAAO,GAAGD;IACjB,OAAOG,YAAY,CAAC,GAAGC;YAAgBH;uBAAAA,CAAAA,kBAAAA,OAAO,OAAO,AAAD,IAAbA,KAAAA,IAAAA,gBAAAA,IAAAA,CAAAA,WAAoBG;OAAO,EAAE;AACtE"}

package/dist/button/button.css

@@ -0,0 +1,162 @@
+.g9-button {
+  border-style: solid;
+  flex-direction: row;
+  justify-content: center;
+  align-items: center;
+  column-gap: 8px;
+  display: flex;
+  overflow: hidden;
+}
+
+.g9-button--fill {
+  align-self: stretch;
+}
+
+.g9-button__label {
+  text-align: center;
+}
+
+.g9-icon-button {
+  justify-content: center;
+  align-items: center;
+  display: flex;
+}
+
+.g9-icon-button__host {
+  position: relative;
+}
+
+.g9-icon-button__frame {
+  border-style: solid;
+  justify-content: center;
+  align-items: center;
+  display: flex;
+}
+
+.g9-header-action {
+  border-style: solid;
+  border-width: 1px;
+  border-color: var(--g9-card-border);
+  background-color: var(--g9-surface-container-lowest);
+  border-radius: 9px;
+  justify-content: center;
+  align-items: center;
+  display: flex;
+  position: relative;
+}
+
+.g9-header-action__text {
+  color: var(--g9-on-surface-variant);
+  font-size: 13px;
+  font-weight: bold;
+}
+
+.g9-header-action__badge {
+  background-color: var(--g9-primary);
+  border-radius: 4px;
+  width: 8px;
+  height: 8px;
+  position: absolute;
+  top: 6px;
+}
+
+.g9-vertical-button {
+  border-style: solid;
+  border-width: 1px;
+  border-color: var(--g9-surface-container-highest);
+  background-color: var(--g9-surface-container);
+  border-radius: 9px;
+  flex-direction: column;
+  align-items: center;
+  padding: 5px;
+  display: flex;
+}
+
+.g9-vertical-button__text {
+  text-align: center;
+  color: var(--g9-secondary);
+}
+
+.g9-nav-card {
+  border-style: solid;
+  border-width: 1px;
+  border-color: var(--g9-outline-variant);
+  border-radius: 16px;
+  flex-direction: row;
+  align-items: center;
+  column-gap: 12px;
+  padding: 12px 14px;
+  display: flex;
+}
+
+.g9-nav-card__tile {
+  border-radius: 12px;
+  justify-content: center;
+  align-items: center;
+  width: 38px;
+  height: 38px;
+  display: flex;
+  position: relative;
+}
+
+.g9-nav-card__text {
+  flex-direction: column;
+  flex: 1;
+  row-gap: 2px;
+  display: flex;
+}
+
+.g9-nav-card__title {
+  text-overflow: ellipsis;
+  font-size: 14px;
+  font-weight: bold;
+}
+
+.g9-nav-card__title-row {
+  align-items: center;
+  column-gap: 8px;
+  display: flex;
+}
+
+.g9-nav-card__title-row .g9-nav-card__title {
+  flex-shrink: 1;
+  min-width: 0;
+}
+
+.g9-nav-card__title-accessory {
+  flex-shrink: 0;
+  align-items: center;
+  display: flex;
+}
+
+.g9-nav-card__subtitle {
+  color: var(--g9-text-tertiary);
+  font-size: 11.5px;
+}
+
+.g9-nav-card__trailing {
+  flex-direction: row;
+  align-items: center;
+  column-gap: 8px;
+  display: flex;
+}
+
+.g9-nav-card__value {
+  font-size: 13px;
+  font-weight: bold;
+}
+
+.g9-nav-card__soon {
+  background-color: var(--g9-error-container);
+  border-radius: 11px;
+  padding: 3.5px 7px;
+}
+
+.g9-nav-card__soon-text {
+  color: var(--g9-error);
+  font-size: 10px;
+  font-weight: bold;
+}
+
+
+/*# sourceMappingURL=button.css.map */

package/dist/button/button.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["webpack://./src/button/button.css"],"names":[],"mappings":"AACA;EAAE,mBAAmB;EACnB,mBAAmB;EACnB,uBAAuB;EACvB,mBAAmB;EACnB,eAAe;EACf,aAAa;EACb,gBAAgB;AAClB;;AAGA;EAAE,mBAAmB;AACrB;;AAGA;EAAE,kBAAkB;AACpB;;AAGA;EAAE,uBAAuB;EACvB,mBAAmB;EACnB,aAAa;AACf;;AAGA;EAAE,kBAAkB;AACpB;;AAGA;EAAE,mBAAmB;EACnB,uBAAuB;EACvB,mBAAmB;EACnB,aAAa;AACf;;AAGA;EAAE,mBAAmB;EACnB,iBAAiB;EACjB,mCAAmC;EACnC,oDAAoD;EACpD,kBAAkB;EAClB,uBAAuB;EACvB,mBAAmB;EACnB,aAAa;EACb,kBAAkB;AACpB;;AAGA;EAAE,mCAAmC;EACnC,eAAe;EACf,iBAAiB;AACnB;;AAGA;EAAE,mCAAmC;EACnC,kBAAkB;EAClB,UAAU;EACV,WAAW;EACX,kBAAkB;EAClB,QAAQ;AACV;;AAGA;EAAE,mBAAmB;EACnB,iBAAiB;EACjB,iDAAiD;EACjD,6CAA6C;EAC7C,kBAAkB;EAClB,sBAAsB;EACtB,mBAAmB;EACnB,YAAY;EACZ,aAAa;AACf;;AAGA;EAAE,kBAAkB;EAClB,0BAA0B;AAC5B;;AAGA;EAAE,mBAAmB;EACnB,iBAAiB;EACjB,uCAAuC;EACvC,mBAAmB;EACnB,mBAAmB;EACnB,mBAAmB;EACnB,gBAAgB;EAChB,kBAAkB;EAClB,aAAa;AACf;;AAGA;EAAE,mBAAmB;EACnB,uBAAuB;EACvB,mBAAmB;EACnB,WAAW;EACX,YAAY;EACZ,aAAa;EACb,kBAAkB;AACpB;;AAGA;EAAE,sBAAsB;EACtB,OAAO;EACP,YAAY;EACZ,aAAa;AACf;;AAGA;EAAE,uBAAuB;EACvB,eAAe;EACf,iBAAiB;AACnB;;AAIA;EADE,mBAAmB;EACnB,eAAe;EACf,aAAa;AACf;;AAIA;EADE,cAAc;EACd,YAAY;AACd;;AAIA;EADE,cAAc;EACd,mBAAmB;EACnB,aAAa;AACf;;AAIA;EADE,8BAA8B;EAC9B,iBAAiB;AACnB;;AAIA;EADE,mBAAmB;EACnB,mBAAmB;EACnB,eAAe;EACf,aAAa;AACf;;AAIA;EADE,eAAe;EACf,iBAAiB;AACnB;;AAIA;EADE,2CAA2C;EAC3C,mBAAmB;EACnB,kBAAkB;AACpB;;AAIA;EADE,sBAAsB;EACtB,eAAe;EACf,iBAAiB;AACnB","sourcesContent":["/* Buttons (MAUI G9Button, G9IconButton, G9HeaderActionButton, G9VerticalIconTextButton, G9NavCard). No shadows. */\n.g9-button {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  justify-content: center;\n  border-style: solid;\n  overflow: hidden;\n  column-gap: 8px;\n}\n\n.g9-button--fill {\n  align-self: stretch;\n}\n\n.g9-button__label {\n  text-align: center;\n}\n\n.g9-icon-button {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n}\n\n.g9-icon-button__host {\n  position: relative;\n}\n\n.g9-icon-button__frame {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  border-style: solid;\n}\n\n.g9-header-action {\n  display: flex;\n  position: relative;\n  align-items: center;\n  justify-content: center;\n  border-style: solid;\n  border-width: 1px;\n  border-radius: 9px;\n  border-color: var(--g9-card-border);\n  background-color: var(--g9-surface-container-lowest);\n}\n\n.g9-header-action__text {\n  font-size: 13px;\n  font-weight: bold;\n  color: var(--g9-on-surface-variant);\n}\n\n.g9-header-action__badge {\n  position: absolute;\n  top: 6px;\n  width: 8px;\n  height: 8px;\n  border-radius: 4px;\n  background-color: var(--g9-primary);\n}\n\n.g9-vertical-button {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  padding: 5px;\n  border-style: solid;\n  border-width: 1px;\n  border-radius: 9px;\n  border-color: var(--g9-surface-container-highest);\n  background-color: var(--g9-surface-container);\n}\n\n.g9-vertical-button__text {\n  text-align: center;\n  color: var(--g9-secondary);\n}\n\n.g9-nav-card {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  column-gap: 12px;\n  padding: 12px 14px;\n  border-style: solid;\n  border-width: 1px;\n  border-radius: 16px;\n  border-color: var(--g9-outline-variant);\n}\n\n.g9-nav-card__tile {\n  display: flex;\n  position: relative;\n  align-items: center;\n  justify-content: center;\n  width: 38px;\n  height: 38px;\n  border-radius: 12px;\n}\n\n.g9-nav-card__text {\n  display: flex;\n  flex-direction: column;\n  flex: 1;\n  row-gap: 2px;\n}\n\n.g9-nav-card__title {\n  font-size: 14px;\n  font-weight: bold;\n  text-overflow: ellipsis;\n}\n\n/* Only while a titleAccessory is set: the title shrinks (and truncates), the accessory keeps its size. */\n.g9-nav-card__title-row {\n  display: flex;\n  align-items: center;\n  column-gap: 8px;\n}\n\n.g9-nav-card__title-row .g9-nav-card__title {\n  flex-shrink: 1;\n  min-width: 0;\n}\n\n.g9-nav-card__title-accessory {\n  display: flex;\n  flex-shrink: 0;\n  align-items: center;\n}\n\n.g9-nav-card__subtitle {\n  font-size: 11.5px;\n  color: var(--g9-text-tertiary);\n}\n\n.g9-nav-card__trailing {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  column-gap: 8px;\n}\n\n.g9-nav-card__value {\n  font-size: 13px;\n  font-weight: bold;\n}\n\n.g9-nav-card__soon {\n  padding: 3.5px 7px;\n  border-radius: 11px;\n  background-color: var(--g9-error-container);\n}\n\n.g9-nav-card__soon-text {\n  font-size: 10px;\n  font-weight: bold;\n  color: var(--g9-error);\n}\n"],"sourceRoot":""}