@g9tm/lynxcontrols 0.0.0-stage → 1.4.2

package/dist/fields/search-entry.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields/search-entry.jsx","sources":["../../src/fields/search-entry.tsx"],"sourcesContent":["import {\n  createAbortController,\n  type G9AbortController,\n  type G9AbortSignal,\n  G9StringKey,\n  isAbortError,\n} from '@g9tm/lynxcontrols-foundation';\nimport { forwardRef, type ReactNode, useEffect, useImperativeHandle, useRef } from '@lynx-js/react';\nimport { type G9TimerHandle, startTimer, stopTimer } from '../base/timers';\nimport { useControllableState } from '../base/use-controllable-state';\nimport { useG9Diagnostics, useG9Settings, useG9Strings } from '../provider/hooks';\nimport { type G9EntryVariant, type G9TextEntryHandle, type G9TextEntryProps, TextEntryBody } from './text-entry';\nimport type { G9ValueChangeDetails } from './use-text-input';\n\n/** Context of one search (`onSearch`). */\nexport interface G9SearchContext {\n  /** Aborted when a newer query fires or the field unmounts: drop this query's results. */\n  readonly signal: G9AbortSignal;\n  /** Increases with every fired query; compare to discard a stale result. */\n  readonly version: number;\n}\n\n/** Props of {@link G9SearchEntry} (MAUI `G9SearchEntry`). */\nexport interface G9SearchEntryProps extends G9TextEntryProps {\n  /** Quiet time after the last change before the query fires; `0` fires on every change. Default 250. */\n  readonly debounceMs?: number;\n  /** The debounced text (MAUI `DebouncedTextChanged`). */\n  readonly onDebouncedValueChange?: (value: string) => void;\n  /**\n   * Runs the search (MAUI `SearchCommand`): after the debounce, on the keyboard's search key and on `submit()`.\n   * A newer query aborts the previous one's signal (query versioning). A thrown error or rejected promise (other\n   * than an abort) goes to the provider's diagnostics.\n   */\n  readonly onSearch?: (query: string, context: G9SearchContext) => unknown;\n}\n\n/** Imperative handle of {@link G9SearchEntry}. */\nexport interface G9SearchEntryHandle extends G9TextEntryHandle {\n  /** Fires the current text now, skipping the debounce (MAUI `Submit`). */\n  submit(): void;\n}\n\n/**\n * Search field (MAUI `G9SearchEntry`): a `G9TextEntry` with a leading search glyph, the clear button, dictation on,\n * the localized `search` placeholder, the floating-label clearance reserved, the keyboard's search key, and a\n * debounced query. Every change of the text (typing, dictation, clear, a new `value` from the parent) restarts the\n * debounce; the search key and `submit()` fire at once. Pending queries never fire after unmount.\n */\nexport const G9SearchEntry = forwardRef<G9SearchEntryHandle, G9SearchEntryProps>(\n  function G9SearchEntry(props, ref): ReactNode {\n    const glyphs = useG9Settings().glyphs;\n    const strings = useG9Strings();\n    const diagnostics = useG9Diagnostics();\n    const [text, setText] = useControllableState<string, [G9ValueChangeDetails]>({\n      value: props.value,\n      defaultValue: props.defaultValue ?? '',\n      onChange: props.onValueChange,\n      name: 'G9SearchEntry.value',\n    });\n    const latest = useRef({ text, props });\n    latest.current = { text, props };\n    const timer = useRef<G9TimerHandle | null>(null);\n    const current = useRef<G9AbortController | null>(null);\n    const version = useRef(0);\n    const inner = useRef<G9TextEntryHandle | null>(null);\n\n    const stopDebounce = () => {\n      if (timer.current !== null) {\n        stopTimer(timer.current);\n        timer.current = null;\n      }\n    };\n    const report = (error: unknown) => {\n      if (isAbortError(error)) return;\n      diagnostics.log({ level: 'error', message: 'G9SearchEntry.onSearch failed.', source: 'G9SearchEntry', error });\n    };\n    const fire = (value: string) => {\n      const p = latest.current.props;\n      current.current?.abort();\n      const controller = createAbortController();\n      current.current = controller;\n      version.current += 1;\n      try {\n        p.onDebouncedValueChange?.(value);\n        const result = p.onSearch?.(value, { signal: controller.signal, version: version.current });\n        if (result && typeof (result as PromiseLike<unknown>).then === 'function') {\n          (result as PromiseLike<unknown>).then(undefined, report);\n        }\n      } catch (error) {\n        report(error);\n      }\n    };\n    const submit = () => {\n      stopDebounce();\n      fire(latest.current.text);\n    };\n\n    const first = useRef(true);\n    useEffect(() => {\n      if (first.current) {\n        first.current = false;\n        return;\n      }\n      const ms = latest.current.props.debounceMs ?? 250;\n      stopDebounce();\n      if (ms <= 0) {\n        fire(text);\n        return;\n      }\n      timer.current = startTimer(() => {\n        timer.current = null;\n        fire(latest.current.text);\n      }, ms);\n    }, [text]);\n\n    useEffect(\n      () => () => {\n        stopDebounce();\n        current.current?.abort();\n      },\n      [],\n    );\n\n    useImperativeHandle(ref, () => {\n      const base = inner.current as G9TextEntryHandle;\n      return {\n        focus: () => base.focus(),\n        blur: () => base.blur(),\n        validate: () => base.validate(),\n        get isListening() {\n          return base.isListening;\n        },\n        toggleVoice: () => base.toggleVoice(),\n        startVoice: () => base.startVoice(),\n        stopVoice: () => base.stopVoice(),\n        get element() {\n          return base.element;\n        },\n        submit,\n      };\n    });\n\n    const variant: G9EntryVariant = {\n      name: 'G9SearchEntry.value',\n      restingTone: 'placeholder',\n      confirmType: 'search',\n      onConfirm: submit,\n    };\n    return (\n      <TextEntryBody\n        {...props}\n        leadingIcon={props.leadingIcon === undefined ? glyphs.search : props.leadingIcon}\n        clearButton={props.clearButton ?? true}\n        voiceEnabled={props.voiceEnabled ?? true}\n        placeholder={props.placeholder === undefined ? strings.get(G9StringKey.Search) : props.placeholder}\n        reserveFloatingLabelClearance={props.reserveFloatingLabelClearance ?? true}\n        value={text}\n        onValueChange={(value, details) => setText(value, details)}\n        variant={variant}\n        ref={inner}\n      />\n    );\n  },\n);\n"],"names":["G9SearchEntry","forwardRef","props","ref","_props_defaultValue","_props_clearButton","_props_voiceEnabled","_props_reserveFloatingLabelClearance","glyphs","useG9Settings","strings","useG9Strings","diagnostics","useG9Diagnostics","text","setText","useControllableState","latest","useRef","timer","current","version","inner","stopDebounce","stopTimer","report","error","isAbortError","fire","value","_current_current","p","controller","createAbortController","result","undefined","submit","first","useEffect","_latest_current_props_debounceMs","ms","startTimer","useImperativeHandle","base","variant","TextEntryBody","G9StringKey","details"],"mappings":"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"}

package/dist/fields/slot-layout.d.ts

@@ -0,0 +1,33 @@
+/** Inputs of the slot layout. */
+export interface G9FieldSlotLayoutInput {
+    readonly hasLeadingIcon: boolean;
+    readonly hasTrailingIcon: boolean;
+    readonly isRtl: boolean;
+    /** Pin the trailing icon to the physical right in both directions. */
+    readonly forceTrailingIconRight: boolean;
+    /** Pin the leading icon to the physical left in both directions. */
+    readonly forceLeadingIconLeft: boolean;
+}
+/** Physical padding (logical pixels). */
+export interface G9PhysicalPadding {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+}
+/** Everything the field derives from {@link G9FieldSlotLayoutInput}. */
+export interface G9FieldSlotLayout {
+    /** Physical column of the leading icon: 0 (left) or 2 (right). */
+    readonly leadingColumn: 0 | 2;
+    /** Physical column of the trailing icon: 0 (left) or 2 (right). */
+    readonly trailingColumn: 0 | 2;
+    /** Inner content padding: 0 on a side with an icon, `InputHorizontalPadding` otherwise, plus the control's own. */
+    readonly innerPadding: G9PhysicalPadding;
+    /** Label X translation at rest (physical pixels; negative is left). */
+    readonly labelRestX: number;
+    /** Extra label X translation when floated. */
+    readonly labelFloatedX: number;
+}
+/** Resolves the slot layout (MAUI `ResolvePhysical*Column`, `ResolveInnerPadding`, `ResolveLabel*TranslationX`). */
+export declare function resolveFieldSlotLayout(input: G9FieldSlotLayoutInput, perControlPadding?: G9PhysicalPadding): G9FieldSlotLayout;
+//# sourceMappingURL=slot-layout.d.ts.map

package/dist/fields/slot-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-layout.d.ts","sourceRoot":"","sources":["../../src/fields/slot-layout.ts"],"names":[],"mappings":"AAKA,iCAAiC;AACjC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,oEAAoE;IACpE,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/B,mHAAmH;IACnH,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAID,oHAAoH;AACpH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,sBAAsB,EAC7B,iBAAiB,GAAE,iBAAwB,GAC1C,iBAAiB,CA0BnB"}

package/dist/fields/slot-layout.jsx

@@ -0,0 +1,33 @@
+import { G9Metrics } from "@g9tm/lynxcontrols-foundation";
+const zero = Object.freeze({
+    left: 0,
+    top: 0,
+    right: 0,
+    bottom: 0
+});
+function resolveFieldSlotLayout(input, perControlPadding = zero) {
+    const leadingColumn = input.forceLeadingIconLeft ? 0 : input.isRtl ? 2 : 0;
+    const trailingColumn = input.forceTrailingIconRight ? 2 : input.isRtl ? 0 : 2;
+    const iconLeft = input.hasLeadingIcon && 0 === leadingColumn || input.hasTrailingIcon && 0 === trailingColumn;
+    const iconRight = input.hasLeadingIcon && 2 === leadingColumn || input.hasTrailingIcon && 2 === trailingColumn;
+    const pad = G9Metrics.InputHorizontalPadding;
+    let labelRestX = 0;
+    if (input.hasLeadingIcon) {
+        if (!(input.isRtl && input.forceLeadingIconLeft)) labelRestX = input.isRtl ? -G9Metrics.InputLabelLeadingIconOffset : G9Metrics.InputLabelLeadingIconOffset;
+    } else if (input.isRtl && input.forceTrailingIconRight && input.hasTrailingIcon) labelRestX = -(G9Metrics.TrailingIconSlotWidth - pad);
+    return {
+        leadingColumn,
+        trailingColumn,
+        innerPadding: {
+            left: (iconLeft ? 0 : pad) + perControlPadding.left,
+            top: perControlPadding.top,
+            right: (iconRight ? 0 : pad) + perControlPadding.right,
+            bottom: perControlPadding.bottom
+        },
+        labelRestX,
+        labelFloatedX: input.isRtl ? -G9Metrics.FloatingLabelFloatedExtraX : G9Metrics.FloatingLabelFloatedExtraX
+    };
+}
+export { resolveFieldSlotLayout };
+
+//# sourceMappingURL=slot-layout.jsx.map

package/dist/fields/slot-layout.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields/slot-layout.jsx","sources":["../../src/fields/slot-layout.ts"],"sourcesContent":["import { G9Metrics } from '@g9tm/lynxcontrols-foundation';\n\n// MAUI `G9FieldSlotLayout` (Controls/Shared/G9FieldSlotLayout.cs): where an outlined field's icons sit and how far\n// its inner content and floating label move. Columns are PHYSICAL (0 = left, 2 = right), as in MAUI.\n\n/** Inputs of the slot layout. */\nexport interface G9FieldSlotLayoutInput {\n  readonly hasLeadingIcon: boolean;\n  readonly hasTrailingIcon: boolean;\n  readonly isRtl: boolean;\n  /** Pin the trailing icon to the physical right in both directions. */\n  readonly forceTrailingIconRight: boolean;\n  /** Pin the leading icon to the physical left in both directions. */\n  readonly forceLeadingIconLeft: boolean;\n}\n\n/** Physical padding (logical pixels). */\nexport interface G9PhysicalPadding {\n  readonly left: number;\n  readonly top: number;\n  readonly right: number;\n  readonly bottom: number;\n}\n\n/** Everything the field derives from {@link G9FieldSlotLayoutInput}. */\nexport interface G9FieldSlotLayout {\n  /** Physical column of the leading icon: 0 (left) or 2 (right). */\n  readonly leadingColumn: 0 | 2;\n  /** Physical column of the trailing icon: 0 (left) or 2 (right). */\n  readonly trailingColumn: 0 | 2;\n  /** Inner content padding: 0 on a side with an icon, `InputHorizontalPadding` otherwise, plus the control's own. */\n  readonly innerPadding: G9PhysicalPadding;\n  /** Label X translation at rest (physical pixels; negative is left). */\n  readonly labelRestX: number;\n  /** Extra label X translation when floated. */\n  readonly labelFloatedX: number;\n}\n\nconst zero: G9PhysicalPadding = Object.freeze({ left: 0, top: 0, right: 0, bottom: 0 });\n\n/** Resolves the slot layout (MAUI `ResolvePhysical*Column`, `ResolveInnerPadding`, `ResolveLabel*TranslationX`). */\nexport function resolveFieldSlotLayout(\n  input: G9FieldSlotLayoutInput,\n  perControlPadding: G9PhysicalPadding = zero,\n): G9FieldSlotLayout {\n  const leadingColumn: 0 | 2 = input.forceLeadingIconLeft ? 0 : input.isRtl ? 2 : 0;\n  const trailingColumn: 0 | 2 = input.forceTrailingIconRight ? 2 : input.isRtl ? 0 : 2;\n  const iconLeft = (input.hasLeadingIcon && leadingColumn === 0) || (input.hasTrailingIcon && trailingColumn === 0);\n  const iconRight = (input.hasLeadingIcon && leadingColumn === 2) || (input.hasTrailingIcon && trailingColumn === 2);\n  const pad = G9Metrics.InputHorizontalPadding;\n  let labelRestX = 0;\n  if (input.hasLeadingIcon) {\n    if (!(input.isRtl && input.forceLeadingIconLeft)) {\n      labelRestX = input.isRtl ? -G9Metrics.InputLabelLeadingIconOffset : G9Metrics.InputLabelLeadingIconOffset;\n    }\n  } else if (input.isRtl && input.forceTrailingIconRight && input.hasTrailingIcon) {\n    labelRestX = -(G9Metrics.TrailingIconSlotWidth - pad);\n  }\n  return {\n    leadingColumn,\n    trailingColumn,\n    innerPadding: {\n      left: (iconLeft ? 0 : pad) + perControlPadding.left,\n      top: perControlPadding.top,\n      right: (iconRight ? 0 : pad) + perControlPadding.right,\n      bottom: perControlPadding.bottom,\n    },\n    labelRestX,\n    labelFloatedX: input.isRtl ? -G9Metrics.FloatingLabelFloatedExtraX : G9Metrics.FloatingLabelFloatedExtraX,\n  };\n}\n"],"names":["zero","Object","resolveFieldSlotLayout","input","perControlPadding","leadingColumn","trailingColumn","iconLeft","iconRight","pad","G9Metrics","labelRestX"],"mappings":";AAsCA,MAAMA,OAA0BC,OAAO,MAAM,CAAC;IAAE,MAAM;IAAG,KAAK;IAAG,OAAO;IAAG,QAAQ;AAAE;AAG9E,SAASC,uBACdC,KAA6B,EAC7BC,oBAAuCJ,IAAI;IAE3C,MAAMK,gBAAuBF,MAAM,oBAAoB,GAAG,IAAIA,MAAM,KAAK,GAAG,IAAI;IAChF,MAAMG,iBAAwBH,MAAM,sBAAsB,GAAG,IAAIA,MAAM,KAAK,GAAG,IAAI;IACnF,MAAMI,WAAYJ,MAAM,cAAc,IAAIE,AAAkB,MAAlBA,iBAAyBF,MAAM,eAAe,IAAIG,AAAmB,MAAnBA;IAC5F,MAAME,YAAaL,MAAM,cAAc,IAAIE,AAAkB,MAAlBA,iBAAyBF,MAAM,eAAe,IAAIG,AAAmB,MAAnBA;IAC7F,MAAMG,MAAMC,UAAU,sBAAsB;IAC5C,IAAIC,aAAa;IACjB,IAAIR,MAAM,cAAc,EACtB;QAAA,IAAI,CAAEA,CAAAA,MAAM,KAAK,IAAIA,MAAM,oBAAmB,GAC5CQ,aAAaR,MAAM,KAAK,GAAG,CAACO,UAAU,2BAA2B,GAAGA,UAAU,2BAA2B;IAC3G,OACK,IAAIP,MAAM,KAAK,IAAIA,MAAM,sBAAsB,IAAIA,MAAM,eAAe,EAC7EQ,aAAa,CAAED,CAAAA,UAAU,qBAAqB,GAAGD,GAAE;IAErD,OAAO;QACLJ;QACAC;QACA,cAAc;YACZ,MAAOC,AAAAA,CAAAA,WAAW,IAAIE,GAAE,IAAKL,kBAAkB,IAAI;YACnD,KAAKA,kBAAkB,GAAG;YAC1B,OAAQI,AAAAA,CAAAA,YAAY,IAAIC,GAAE,IAAKL,kBAAkB,KAAK;YACtD,QAAQA,kBAAkB,MAAM;QAClC;QACAO;QACA,eAAeR,MAAM,KAAK,GAAG,CAACO,UAAU,0BAA0B,GAAGA,UAAU,0BAA0B;IAC3G;AACF"}

package/dist/fields/text-entry.d.ts

@@ -0,0 +1,62 @@
+import { type G9TextInputHandle, type G9TextInputProps } from './use-text-input.js';
+import type { G9TextValidator } from './validator.js';
+/** Props of {@link G9TextEntry} (MAUI `G9TextEntry`). */
+export interface G9TextEntryProps extends G9TextInputProps {
+    /** Eye toggle in the trailing slot while there is a value; pins the trailing icon right. Default false. */
+    readonly passwordToggle?: boolean;
+    /** Mask the value (until the eye reveals it); the text is pinned LTR. Default false. */
+    readonly isPassword?: boolean;
+    /** Clear (×) button in the trailing slot while there is a value. Default false. */
+    readonly clearButton?: boolean;
+    /** Extra validation, run before the input-type rule (on blur, `validateOnTextChanged`, `validate()`). */
+    readonly validator?: G9TextValidator | null;
+    /** Validate on every change, not only on blur. Default false. */
+    readonly validateOnTextChanged?: boolean;
+    /** Keyboard confirm key. Default `'done'`. */
+    readonly confirmType?: 'send' | 'search' | 'go' | 'done' | 'next';
+    /** iOS spell checking (`ios-spell-check`; Android has no attribute). Default true. */
+    readonly isSpellCheckEnabled?: boolean;
+    /** iOS auto-correct / prediction (`ios-auto-correct`). Default true. */
+    readonly isTextPredictionEnabled?: boolean;
+}
+/** Imperative handle of {@link G9TextEntry}. */
+export type G9TextEntryHandle = G9TextInputHandle;
+/**
+ * Whether the trailing slot shows the microphone (MAUI `ShouldShowVoiceMic`): dictation available, not while the
+ * password eye owns the slot, and only on an empty field or during a session (the clear button owns a filled field).
+ */
+export declare function shouldShowEntryMic(state: {
+    readonly available: boolean;
+    readonly listening: boolean;
+    readonly hasValue: boolean;
+    readonly passwordToggle: boolean;
+}): boolean;
+/** What `G9SearchEntry` changes in the entry (internal). */
+export interface G9EntryVariant {
+    readonly name: string;
+    readonly restingTone?: 'outline' | 'placeholder';
+    readonly confirmType?: G9TextEntryProps['confirmType'];
+    readonly onConfirm?: (value: string) => void;
+}
+interface BodyProps extends G9TextEntryProps {
+    readonly variant: G9EntryVariant;
+}
+/**
+ * The entry body shared by `G9TextEntry` and `G9SearchEntry` (internal). The inner name must differ from the binding
+ * (E20, scripts/check-dist-jsx.mjs): `G9TextEntry` renders it in this module.
+ */
+export declare const TextEntryBody: import("react").ForwardRefExoticComponent<BodyProps & import("react").RefAttributes<G9TextInputHandle>>;
+/**
+ * Single-line outlined text field (MAUI `G9TextEntry`): floating label, input-type keyboard/filter/validation,
+ * password eye, clear button, optional dictation (`voiceEnabled` + `services.speech`).
+ *
+ * - Value: `value`/`defaultValue`/`onValueChange(value, { source })`; one call per change.
+ * - Validation: on blur when there is a rule (`validator`, email/url, custom pattern), on every change with
+ *   `validateOnTextChanged`, or through the handle's `validate()`. An error set through `hasError`/`errorText`
+ *   survives blur on a field without a rule.
+ * - Requires the host's `xelement-input` registration (plan/specs/02 §2). Keyboard avoidance: put the form inside
+ *   lynx-ui `KeyboardAwareRoot`/`KeyboardAwareResponder`; the field reports focus to it.
+ */
+export declare const G9TextEntry: import("react").ForwardRefExoticComponent<G9TextEntryProps & import("react").RefAttributes<G9TextInputHandle>>;
+export {};
+//# sourceMappingURL=text-entry.d.ts.map

package/dist/fields/text-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-entry.d.ts","sourceRoot":"","sources":["../../src/fields/text-entry.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAgB,MAAM,kBAAkB,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,yDAAyD;AACzD,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,2GAA2G;IAC3G,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,wFAAwF;IACxF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,yGAAyG;IACzG,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5C,iEAAiE;IACjE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAClE,sFAAsF;IACtF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C;AAED,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAElD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC,GAAG,OAAO,CAEV;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,UAAU,SAAU,SAAQ,gBAAgB;IAC1C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,yGAyFzB,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,gHAEtB,CAAC"}

package/dist/fields/text-entry.jsx

@@ -0,0 +1,82 @@
+import { G9KeyboardType, G9StringKey } from "@g9tm/lynxcontrols-foundation";
+import { forwardRef, useImperativeHandle } from "@lynx-js/react";
+import { useG9Settings, useG9Strings } from "../provider/hooks.jsx";
+import { resolveEffectiveKeyboard, resolveInputElementType } from "./input-policy.jsx";
+import { G9OutlinedField } from "./outlined-field.jsx";
+import { useTextInput } from "./use-text-input.jsx";
+function shouldShowEntryMic(state) {
+    return state.available && !(state.passwordToggle && state.hasValue) && (state.listening || !state.hasValue);
+}
+const TextEntryBody = forwardRef(function(props, ref) {
+    var _props_validator, _props_keyboardType, _core_errorText, _props_variant_restingTone, _ref, _props_variant_confirmType;
+    const glyphs = useG9Settings().glyphs;
+    const strings = useG9Strings();
+    const passwordToggle = true === props.passwordToggle;
+    const core = useTextInput({
+        ...props,
+        ...props.variant.onConfirm ? {
+            onConfirm: props.variant.onConfirm
+        } : {}
+    }, {
+        name: props.variant.name,
+        validator: null != (_props_validator = props.validator) ? _props_validator : null,
+        validateOnTextChanged: true === props.validateOnTextChanged,
+        isPassword: true === props.isPassword,
+        showMic: (s)=>shouldShowEntryMic({
+                ...s,
+                passwordToggle
+            })
+    });
+    useImperativeHandle(ref, ()=>core.handle);
+    let affordance = null;
+    if (passwordToggle && core.hasValue) affordance = {
+        icon: core.passwordVisible ? glyphs.eyeClosed : glyphs.eyeOpen,
+        signature: core.passwordVisible ? 'eye-closed' : 'eye-open',
+        onPress: ()=>core.setPasswordVisible(!core.passwordVisible)
+    };
+    else if (core.showMic) affordance = {
+        icon: core.dictation.listening ? glyphs.micOff : glyphs.mic,
+        color: core.dictation.listening ? 'var(--g9-error)' : 'var(--g9-primary)',
+        signature: 'voice',
+        onPress: core.pressMic
+    };
+    else if (true === props.clearButton && core.hasValue) affordance = {
+        icon: glyphs.clear,
+        label: strings.get(G9StringKey.Clear),
+        signature: 'clear',
+        onPress: ()=>core.setText('', {
+                source: 'clear'
+            })
+    };
+    const masked = true === props.isPassword && !core.passwordVisible;
+    const keyboard = resolveEffectiveKeyboard(core.inputType, null != (_props_keyboardType = props.keyboardType) ? _props_keyboardType : G9KeyboardType.Default);
+    return <G9OutlinedField {...props} hasError={core.hasError} errorText={null != (_core_errorText = core.errorText) ? _core_errorText : null} forceTrailingIconRight={true === props.forceTrailingIconRight || passwordToggle} focused={core.focused} hasValue={core.hasValue} textLength={core.text.length} trailingAffordance={affordance} restingTone={null != (_props_variant_restingTone = props.variant.restingTone) ? _props_variant_restingTone : 'outline'} onFocusRequest={core.focus}>
+        {}
+        {true === props.readOnly && !masked ? <text className="g9-field__input g9-field__input--readonly" text-maxline="1" style={{
+        direction: core.textDirection,
+        textAlign: 'rtl' === core.textDirection ? 'right' : 'left',
+        ...core.font ? {
+            fontFamily: core.font
+        } : {},
+        color: props.disabled ? 'var(--g9-text-disabled)' : 'var(--g9-text-primary)'
+    }}>
+            {core.text}
+          </text> : <input {...core.elementProps} className="g9-field__input" type={resolveInputElementType(core.inputType, keyboard, masked)} confirm-type={null != (_ref = null != (_props_variant_confirmType = props.variant.confirmType) ? _props_variant_confirmType : props.confirmType) ? _ref : 'done'} ios-spell-check={false !== props.isSpellCheckEnabled} ios-auto-correct={false !== props.isTextPredictionEnabled} style={{
+        direction: core.textDirection,
+        textAlign: 'rtl' === core.textDirection ? 'right' : 'left',
+        ...core.font ? {
+            fontFamily: core.font
+        } : {},
+        color: props.disabled ? 'var(--g9-text-disabled)' : 'var(--g9-text-primary)'
+    }}/>}
+      </G9OutlinedField>;
+});
+const entryVariant = {
+    name: 'G9TextEntry.value'
+};
+const text_entry_G9TextEntry = forwardRef(function(props, ref) {
+    return <TextEntryBody {...props} variant={entryVariant} ref={ref}/>;
+});
+export { TextEntryBody, shouldShowEntryMic, text_entry_G9TextEntry as G9TextEntry };
+
+//# sourceMappingURL=text-entry.jsx.map

package/dist/fields/text-entry.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields/text-entry.jsx","sources":["../../src/fields/text-entry.tsx"],"sourcesContent":["import { G9KeyboardType, G9StringKey } from '@g9tm/lynxcontrols-foundation';\nimport { forwardRef, type ReactNode, useImperativeHandle } from '@lynx-js/react';\nimport { useG9Settings, useG9Strings } from '../provider/hooks';\nimport { resolveEffectiveKeyboard, resolveInputElementType } from './input-policy';\nimport { G9OutlinedField, type G9TrailingAffordance } from './outlined-field';\nimport { type G9TextInputHandle, type G9TextInputProps, useTextInput } from './use-text-input';\nimport type { G9TextValidator } from './validator';\n\n/** Props of {@link G9TextEntry} (MAUI `G9TextEntry`). */\nexport interface G9TextEntryProps extends G9TextInputProps {\n  /** Eye toggle in the trailing slot while there is a value; pins the trailing icon right. Default false. */\n  readonly passwordToggle?: boolean;\n  /** Mask the value (until the eye reveals it); the text is pinned LTR. Default false. */\n  readonly isPassword?: boolean;\n  /** Clear (×) button in the trailing slot while there is a value. Default false. */\n  readonly clearButton?: boolean;\n  /** Extra validation, run before the input-type rule (on blur, `validateOnTextChanged`, `validate()`). */\n  readonly validator?: G9TextValidator | null;\n  /** Validate on every change, not only on blur. Default false. */\n  readonly validateOnTextChanged?: boolean;\n  /** Keyboard confirm key. Default `'done'`. */\n  readonly confirmType?: 'send' | 'search' | 'go' | 'done' | 'next';\n  /** iOS spell checking (`ios-spell-check`; Android has no attribute). Default true. */\n  readonly isSpellCheckEnabled?: boolean;\n  /** iOS auto-correct / prediction (`ios-auto-correct`). Default true. */\n  readonly isTextPredictionEnabled?: boolean;\n}\n\n/** Imperative handle of {@link G9TextEntry}. */\nexport type G9TextEntryHandle = G9TextInputHandle;\n\n/**\n * Whether the trailing slot shows the microphone (MAUI `ShouldShowVoiceMic`): dictation available, not while the\n * password eye owns the slot, and only on an empty field or during a session (the clear button owns a filled field).\n */\nexport function shouldShowEntryMic(state: {\n  readonly available: boolean;\n  readonly listening: boolean;\n  readonly hasValue: boolean;\n  readonly passwordToggle: boolean;\n}): boolean {\n  return state.available && !(state.passwordToggle && state.hasValue) && (state.listening || !state.hasValue);\n}\n\n/** What `G9SearchEntry` changes in the entry (internal). */\nexport interface G9EntryVariant {\n  readonly name: string;\n  readonly restingTone?: 'outline' | 'placeholder';\n  readonly confirmType?: G9TextEntryProps['confirmType'];\n  readonly onConfirm?: (value: string) => void;\n}\n\ninterface BodyProps extends G9TextEntryProps {\n  readonly variant: G9EntryVariant;\n}\n\n/**\n * The entry body shared by `G9TextEntry` and `G9SearchEntry` (internal). The inner name must differ from the binding\n * (E20, scripts/check-dist-jsx.mjs): `G9TextEntry` renders it in this module.\n */\nexport const TextEntryBody = forwardRef<G9TextEntryHandle, BodyProps>(\n  function TextEntryBodyRender(props, ref): ReactNode {\n    const glyphs = useG9Settings().glyphs;\n    const strings = useG9Strings();\n    const passwordToggle = props.passwordToggle === true;\n    const core = useTextInput(\n      { ...props, ...(props.variant.onConfirm ? { onConfirm: props.variant.onConfirm } : {}) },\n      {\n        name: props.variant.name,\n        validator: props.validator ?? null,\n        validateOnTextChanged: props.validateOnTextChanged === true,\n        isPassword: props.isPassword === true,\n        showMic: (s) => shouldShowEntryMic({ ...s, passwordToggle }),\n      },\n    );\n    useImperativeHandle(ref, () => core.handle);\n\n    let affordance: G9TrailingAffordance | null = null;\n    if (passwordToggle && core.hasValue) {\n      affordance = {\n        icon: core.passwordVisible ? glyphs.eyeClosed : glyphs.eyeOpen,\n        signature: core.passwordVisible ? 'eye-closed' : 'eye-open',\n        onPress: () => core.setPasswordVisible(!core.passwordVisible),\n      };\n    } else if (core.showMic) {\n      affordance = {\n        icon: core.dictation.listening ? glyphs.micOff : glyphs.mic,\n        color: core.dictation.listening ? 'var(--g9-error)' : 'var(--g9-primary)',\n        signature: 'voice',\n        onPress: core.pressMic,\n      };\n    } else if (props.clearButton === true && core.hasValue) {\n      affordance = {\n        icon: glyphs.clear,\n        label: strings.get(G9StringKey.Clear),\n        signature: 'clear',\n        onPress: () => core.setText('', { source: 'clear' }),\n      };\n    }\n\n    const masked = props.isPassword === true && !core.passwordVisible;\n    const keyboard = resolveEffectiveKeyboard(core.inputType, props.keyboardType ?? G9KeyboardType.Default);\n    return (\n      <G9OutlinedField\n        {...props}\n        hasError={core.hasError}\n        errorText={core.errorText ?? null}\n        forceTrailingIconRight={props.forceTrailingIconRight === true || passwordToggle}\n        focused={core.focused}\n        hasValue={core.hasValue}\n        textLength={core.text.length}\n        trailingAffordance={affordance}\n        restingTone={props.variant.restingTone ?? 'outline'}\n        onFocusRequest={core.focus}\n      >\n        {/* A read-only (unmasked) field shows its value as text: nobody types into it, and a native read-only\n            EditText ignored the value pushed into it (a scan-only barcode field stayed blank). */}\n        {props.readOnly === true && !masked ? (\n          <text\n            className=\"g9-field__input g9-field__input--readonly\"\n            text-maxline=\"1\"\n            style={{\n              direction: core.textDirection,\n              textAlign: core.textDirection === 'rtl' ? 'right' : 'left',\n              ...(core.font ? { fontFamily: core.font } : {}),\n              color: props.disabled ? 'var(--g9-text-disabled)' : 'var(--g9-text-primary)',\n            }}\n          >\n            {core.text}\n          </text>\n        ) : (\n          <input\n            {...core.elementProps}\n            className=\"g9-field__input\"\n            type={resolveInputElementType(core.inputType, keyboard, masked)}\n            confirm-type={props.variant.confirmType ?? props.confirmType ?? 'done'}\n            ios-spell-check={props.isSpellCheckEnabled !== false}\n            ios-auto-correct={props.isTextPredictionEnabled !== false}\n            style={{\n              direction: core.textDirection,\n              textAlign: core.textDirection === 'rtl' ? 'right' : 'left',\n              ...(core.font ? { fontFamily: core.font } : {}),\n              color: props.disabled ? 'var(--g9-text-disabled)' : 'var(--g9-text-primary)',\n            }}\n          />\n        )}\n      </G9OutlinedField>\n    );\n  },\n);\n\nconst entryVariant: G9EntryVariant = { name: 'G9TextEntry.value' };\n\n/**\n * Single-line outlined text field (MAUI `G9TextEntry`): floating label, input-type keyboard/filter/validation,\n * password eye, clear button, optional dictation (`voiceEnabled` + `services.speech`).\n *\n * - Value: `value`/`defaultValue`/`onValueChange(value, { source })`; one call per change.\n * - Validation: on blur when there is a rule (`validator`, email/url, custom pattern), on every change with\n *   `validateOnTextChanged`, or through the handle's `validate()`. An error set through `hasError`/`errorText`\n *   survives blur on a field without a rule.\n * - Requires the host's `xelement-input` registration (plan/specs/02 §2). Keyboard avoidance: put the form inside\n *   lynx-ui `KeyboardAwareRoot`/`KeyboardAwareResponder`; the field reports focus to it.\n */\nexport const G9TextEntry = forwardRef<G9TextEntryHandle, G9TextEntryProps>(function G9TextEntry(props, ref) {\n  return <TextEntryBody {...props} variant={entryVariant} ref={ref} />;\n});\n"],"names":["shouldShowEntryMic","state","TextEntryBody","forwardRef","props","ref","_props_validator","_props_keyboardType","_core_errorText","_props_variant_restingTone","_ref","glyphs","useG9Settings","strings","useG9Strings","passwordToggle","core","useTextInput","s","useImperativeHandle","affordance","G9StringKey","masked","keyboard","resolveEffectiveKeyboard","G9KeyboardType","G9OutlinedField","text","input","resolveInputElementType","entryVariant","G9TextEntry"],"mappings":"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"}

package/dist/fields/use-dictation.d.ts

@@ -0,0 +1,34 @@
+/** Options of {@link useDictation}. */
+export interface G9DictationOptions {
+    /** Whether the field offers dictation at all (`voiceEnabled`). Availability is not checked while `false`. */
+    readonly enabled: boolean;
+    /** Locale to recognise; `null`/`undefined` follows the active culture (MAUI `VoiceCulture`). */
+    readonly locale?: string | null;
+    /** The field's current text. */
+    readonly readText: () => string;
+    /** Writes recognised text (the field filters it like typed text). */
+    readonly writeText: (text: string) => void;
+    readonly onListeningStarted?: () => void;
+    readonly onListeningEnded?: () => void;
+    readonly onFailed?: (message: string) => void;
+}
+/** What {@link useDictation} returns. */
+export interface G9DictationState {
+    /** `services.speech` exists, the field enabled dictation and the recogniser reported this locale available. */
+    readonly available: boolean;
+    /** A session is listening. */
+    readonly listening: boolean;
+    /** A session exists (listening or waiting for the permission prompt). */
+    readonly active: boolean;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    toggle(): Promise<void>;
+}
+/**
+ * The dictation session owner shared by `G9TextEntry`, `G9Editor` and `G9SearchEntry` (MAUI `G9VoiceDictation` +
+ * `G9Speech.IsAvailable`). Optional service: without `services.speech` the microphone is never shown. Availability
+ * is asked once per locale (`isAvailable(locale)`, no prompt); a stale answer for a previous locale is ignored.
+ * Permission is requested on every start, from the tap. A running session stops when the field unmounts.
+ */
+export declare function useDictation(options: G9DictationOptions): G9DictationState;
+//# sourceMappingURL=use-dictation.d.ts.map

package/dist/fields/use-dictation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dictation.d.ts","sourceRoot":"","sources":["../../src/fields/use-dictation.ts"],"names":[],"mappings":"AAIA,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,6GAA6G;IAC7G,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,+GAA+G;IAC/G,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,gBAAgB,CA8D1E"}

package/dist/fields/use-dictation.jsx

@@ -0,0 +1,80 @@
+import { useEffect, useRef, useState } from "@lynx-js/react";
+import { useG9Culture, useG9OptionalService, useG9Strings } from "../provider/hooks.jsx";
+import { G9VoiceDictation } from "./dictation.jsx";
+function useDictation(options) {
+    var _options_locale;
+    const speech = useG9OptionalService('speech');
+    const culture = useG9Culture();
+    const strings = useG9Strings();
+    const locale = null != (_options_locale = options.locale) ? _options_locale : culture.locale;
+    const [, setVersion] = useState(0);
+    const [available, setAvailable] = useState(false);
+    const latest = useRef({
+        options,
+        strings,
+        locale,
+        speech
+    });
+    latest.current = {
+        options,
+        strings,
+        locale,
+        speech
+    };
+    const dictation = useRef(null);
+    if (!dictation.current) dictation.current = new G9VoiceDictation({
+        get speech () {
+            return latest.current.speech;
+        },
+        readText: ()=>latest.current.options.readText(),
+        writeText: (text)=>latest.current.options.writeText(text),
+        onStateChanged: ()=>setVersion((n)=>n + 1),
+        strings: ()=>latest.current.strings,
+        locale: ()=>latest.current.locale,
+        onListeningStarted: ()=>{
+            var _latest_current_options_onListeningStarted, _latest_current_options;
+            return null == (_latest_current_options_onListeningStarted = (_latest_current_options = latest.current.options).onListeningStarted) ? void 0 : _latest_current_options_onListeningStarted.call(_latest_current_options);
+        },
+        onListeningEnded: ()=>{
+            var _latest_current_options_onListeningEnded, _latest_current_options;
+            return null == (_latest_current_options_onListeningEnded = (_latest_current_options = latest.current.options).onListeningEnded) ? void 0 : _latest_current_options_onListeningEnded.call(_latest_current_options);
+        },
+        onFailed: (message)=>{
+            var _latest_current_options_onFailed, _latest_current_options;
+            return null == (_latest_current_options_onFailed = (_latest_current_options = latest.current.options).onFailed) ? void 0 : _latest_current_options_onFailed.call(_latest_current_options, message);
+        }
+    });
+    const session = dictation.current;
+    useEffect(()=>{
+        if (!options.enabled || !speech) return void setAvailable(false);
+        let current = true;
+        speech.isAvailable(locale).then((ok)=>{
+            if (current) setAvailable(true === ok);
+        }, ()=>{
+            if (current) setAvailable(false);
+        });
+        return ()=>{
+            current = false;
+        };
+    }, [
+        options.enabled,
+        speech,
+        locale
+    ]);
+    useEffect(()=>()=>{
+            session.stop();
+        }, [
+        session
+    ]);
+    return {
+        available: options.enabled && void 0 !== speech && available,
+        listening: session.isListening,
+        active: session.hasSession,
+        start: ()=>session.start(),
+        stop: ()=>session.stop(),
+        toggle: ()=>session.toggle()
+    };
+}
+export { useDictation };
+
+//# sourceMappingURL=use-dictation.jsx.map

package/dist/fields/use-dictation.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields/use-dictation.jsx","sources":["../../src/fields/use-dictation.ts"],"sourcesContent":["import { useEffect, useRef, useState } from '@lynx-js/react';\nimport { useG9Culture, useG9OptionalService, useG9Strings } from '../provider/hooks';\nimport { G9VoiceDictation } from './dictation';\n\n/** Options of {@link useDictation}. */\nexport interface G9DictationOptions {\n  /** Whether the field offers dictation at all (`voiceEnabled`). Availability is not checked while `false`. */\n  readonly enabled: boolean;\n  /** Locale to recognise; `null`/`undefined` follows the active culture (MAUI `VoiceCulture`). */\n  readonly locale?: string | null;\n  /** The field's current text. */\n  readonly readText: () => string;\n  /** Writes recognised text (the field filters it like typed text). */\n  readonly writeText: (text: string) => void;\n  readonly onListeningStarted?: () => void;\n  readonly onListeningEnded?: () => void;\n  readonly onFailed?: (message: string) => void;\n}\n\n/** What {@link useDictation} returns. */\nexport interface G9DictationState {\n  /** `services.speech` exists, the field enabled dictation and the recogniser reported this locale available. */\n  readonly available: boolean;\n  /** A session is listening. */\n  readonly listening: boolean;\n  /** A session exists (listening or waiting for the permission prompt). */\n  readonly active: boolean;\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  toggle(): Promise<void>;\n}\n\n/**\n * The dictation session owner shared by `G9TextEntry`, `G9Editor` and `G9SearchEntry` (MAUI `G9VoiceDictation` +\n * `G9Speech.IsAvailable`). Optional service: without `services.speech` the microphone is never shown. Availability\n * is asked once per locale (`isAvailable(locale)`, no prompt); a stale answer for a previous locale is ignored.\n * Permission is requested on every start, from the tap. A running session stops when the field unmounts.\n */\nexport function useDictation(options: G9DictationOptions): G9DictationState {\n  const speech = useG9OptionalService('speech');\n  const culture = useG9Culture();\n  const strings = useG9Strings();\n  const locale = options.locale ?? culture.locale;\n  const [, setVersion] = useState(0);\n  const [available, setAvailable] = useState(false);\n  const latest = useRef({ options, strings, locale, speech });\n  latest.current = { options, strings, locale, speech };\n\n  const dictation = useRef<G9VoiceDictation | null>(null);\n  if (!dictation.current) {\n    dictation.current = new G9VoiceDictation({\n      get speech() {\n        return latest.current.speech;\n      },\n      readText: () => latest.current.options.readText(),\n      writeText: (text) => latest.current.options.writeText(text),\n      onStateChanged: () => setVersion((n) => n + 1),\n      strings: () => latest.current.strings,\n      locale: () => latest.current.locale,\n      onListeningStarted: () => latest.current.options.onListeningStarted?.(),\n      onListeningEnded: () => latest.current.options.onListeningEnded?.(),\n      onFailed: (message) => latest.current.options.onFailed?.(message),\n    });\n  }\n  const session = dictation.current;\n\n  useEffect(() => {\n    if (!options.enabled || !speech) {\n      setAvailable(false);\n      return;\n    }\n    let current = true;\n    speech.isAvailable(locale).then(\n      (ok) => {\n        if (current) setAvailable(ok === true);\n      },\n      () => {\n        if (current) setAvailable(false);\n      },\n    );\n    return () => {\n      current = false;\n    };\n  }, [options.enabled, speech, locale]);\n\n  useEffect(\n    () => () => {\n      void session.stop();\n    },\n    [session],\n  );\n\n  return {\n    available: options.enabled && speech !== undefined && available,\n    listening: session.isListening,\n    active: session.hasSession,\n    start: () => session.start(),\n    stop: () => session.stop(),\n    toggle: () => session.toggle(),\n  };\n}\n"],"names":["useDictation","options","_options_locale","speech","useG9OptionalService","culture","useG9Culture","strings","useG9Strings","locale","setVersion","useState","available","setAvailable","latest","useRef","dictation","G9VoiceDictation","text","n","_latest_current_options","message","session","useEffect","current","ok","undefined"],"mappings":";;;AAsCO,SAASA,aAAaC,OAA2B;QAIvCC;IAHf,MAAMC,SAASC,qBAAqB;IACpC,MAAMC,UAAUC;IAChB,MAAMC,UAAUC;IAChB,MAAMC,SAAS,QAAAP,CAAAA,kBAAAA,QAAQ,MAAM,AAAD,IAAbA,kBAAkBG,QAAQ,MAAM;IAC/C,MAAM,GAAGK,WAAW,GAAGC,SAAS;IAChC,MAAM,CAACC,WAAWC,aAAa,GAAGF,SAAS;IAC3C,MAAMG,SAASC,OAAO;QAAEd;QAASM;QAASE;QAAQN;IAAO;IACzDW,OAAO,OAAO,GAAG;QAAEb;QAASM;QAASE;QAAQN;IAAO;IAEpD,MAAMa,YAAYD,OAAgC;IAClD,IAAI,CAACC,UAAU,OAAO,EACpBA,UAAU,OAAO,GAAG,IAAIC,iBAAiB;QACvC,IAAI;YACF,OAAOH,OAAO,OAAO,CAAC,MAAM;QAC9B;QACA,UAAU,IAAMA,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ;QAC/C,WAAW,CAACI,OAASJ,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAACI;QACtD,gBAAgB,IAAMR,WAAW,CAACS,IAAMA,IAAI;QAC5C,SAAS,IAAML,OAAO,OAAO,CAAC,OAAO;QACrC,QAAQ,IAAMA,OAAO,OAAO,CAAC,MAAM;QACnC,oBAAoB;gBAAMM,4CAAAA;2BAAAA,CAAAA,6CAAAA,AAAAA,CAAAA,0BAAAA,OAAO,OAAO,CAAC,OAAO,AAAD,EAAE,kBAAkB,AAAD,IAAxCA,KAAAA,IAAAA,2CAAAA,IAAAA,CAAAA;;QAC1B,kBAAkB;gBAAMA,0CAAAA;2BAAAA,CAAAA,2CAAAA,AAAAA,CAAAA,0BAAAA,OAAO,OAAO,CAAC,OAAO,AAAD,EAAE,gBAAgB,AAAD,IAAtCA,KAAAA,IAAAA,yCAAAA,IAAAA,CAAAA;;QACxB,UAAU,CAACC;gBAAYD,kCAAAA;2BAAAA,CAAAA,mCAAAA,AAAAA,CAAAA,0BAAAA,OAAO,OAAO,CAAC,OAAO,AAAD,EAAE,QAAQ,AAAD,IAA9BA,KAAAA,IAAAA,iCAAAA,IAAAA,CAAAA,yBAAkCC;;IAC3D;IAEF,MAAMC,UAAUN,UAAU,OAAO;IAEjCO,UAAU;QACR,IAAI,CAACtB,QAAQ,OAAO,IAAI,CAACE,QAAQ,YAC/BU,aAAa;QAGf,IAAIW,UAAU;QACdrB,OAAO,WAAW,CAACM,QAAQ,IAAI,CAC7B,CAACgB;YACC,IAAID,SAASX,aAAaY,AAAO,SAAPA;QAC5B,GACA;YACE,IAAID,SAASX,aAAa;QAC5B;QAEF,OAAO;YACLW,UAAU;QACZ;IACF,GAAG;QAACvB,QAAQ,OAAO;QAAEE;QAAQM;KAAO;IAEpCc,UACE,IAAM;YACCD,QAAQ,IAAI;QACnB,GACA;QAACA;KAAQ;IAGX,OAAO;QACL,WAAWrB,QAAQ,OAAO,IAAIE,AAAWuB,WAAXvB,UAAwBS;QACtD,WAAWU,QAAQ,WAAW;QAC9B,QAAQA,QAAQ,UAAU;QAC1B,OAAO,IAAMA,QAAQ,KAAK;QAC1B,MAAM,IAAMA,QAAQ,IAAI;QACxB,QAAQ,IAAMA,QAAQ,MAAM;IAC9B;AACF"}

package/dist/fields/use-text-input.d.ts

@@ -0,0 +1,150 @@
+import { G9InputType, type G9KeyboardType, G9TextInputDirection } from '@g9tm/lynxcontrols-foundation';
+import type { NodesRef } from '@lynx-js/types';
+import type { G9OutlinedFieldProps } from './outlined-field.js';
+import { type G9TextValidator } from './validator.js';
+/** Where a value change came from (plan/specs/03 §3). */
+export type G9ValueChangeSource = 'user' | 'dictation' | 'clear' | 'programmatic';
+/** Payload of `onValueChange`. */
+export interface G9ValueChangeDetails {
+    readonly source: G9ValueChangeSource;
+}
+/** Props the text inputs (`G9TextEntry`, `G9Editor`, `G9SearchEntry`) share on top of the outlined-field props. */
+export interface G9TextInputProps extends G9OutlinedFieldProps {
+    /** The text (controlled; MAUI `Text`). Present, the caller owns it and must apply `onValueChange`. */
+    readonly value?: string;
+    /** Initial text while uncontrolled. Default `''`. */
+    readonly defaultValue?: string;
+    /**
+     * Once per change of the field's value, with where it came from: `'user'` (typing, paste), `'dictation'`,
+     * `'clear'` (the clear button) or `'programmatic'` (the field re-filtered a value it was given, e.g. after an
+     * `inputType` change). Never for a value the parent pushed in that needed no filtering.
+     */
+    readonly onValueChange?: (value: string, details: G9ValueChangeDetails) => void;
+    /** On-screen keyboard; used when `inputType` is `'default'` (any other type picks its own). Default `'default'`. */
+    readonly keyboardType?: G9KeyboardType;
+    /** Semantic input type: keyboard, live filter and blur validation. Default `'default'`. */
+    readonly inputType?: G9InputType;
+    /** Per-character filter regex (a single character class) for `inputType: 'custom'`. */
+    readonly allowedCharsPattern?: string | null;
+    /** Blur validation regex for `inputType: 'custom'`. An invalid pattern fails closed. */
+    readonly validationPattern?: string | null;
+    /** Message for a failed type validation; default the culture's `invalidEmail` / `invalidUrl` / `invalidValue`. */
+    readonly validationErrorText?: string | null;
+    /** Direction of the entered text; `'matchParent'` (default) pins numbers, phone, email, URL and passwords LTR. */
+    readonly inputTextDirection?: G9TextInputDirection;
+    /** Font family of the entered text; default the culture's font. */
+    readonly customFont?: string | null;
+    /** Offer dictation through `services.speech` (hidden without the service or recogniser). Default false. */
+    readonly voiceEnabled?: boolean;
+    /** Locale to recognise (MAUI `VoiceCulture`); default the active culture. */
+    readonly voiceLocale?: string | null;
+    readonly onVoiceListeningStarted?: () => void;
+    readonly onVoiceListeningEnded?: () => void;
+    /** Dictation could not run or finish; a localized message for a toast. */
+    readonly onVoiceFailed?: (message: string) => void;
+    /** Validation ran (blur, `validateOnTextChanged` or `validate()`): the message, or `null` when valid. */
+    readonly onValidationChange?: (message: string | null) => void;
+    readonly onFocus?: () => void;
+    readonly onBlur?: () => void;
+    /** The keyboard's confirm key was pressed. */
+    readonly onConfirm?: (value: string) => void;
+    /** Element id of the inner `<input>`/`<textarea>`. */
+    readonly inputId?: string;
+}
+/** Imperative handle of the text inputs (MAUI public methods). */
+export interface G9TextInputHandle {
+    /** Focuses the inner element (raises the keyboard). */
+    focus(): void;
+    /** Removes focus (hides the keyboard). */
+    blur(): void;
+    /** Runs the validator and the type rule now; sets or clears the error; `true` when valid (MAUI `Validate`). */
+    validate(): boolean;
+    /** `true` while dictating (MAUI `IsListening`). */
+    readonly isListening: boolean;
+    /** MAUI `ToggleVoiceAsync`. */
+    toggleVoice(): Promise<void>;
+    /** MAUI `StartVoiceAsync`. */
+    startVoice(): Promise<void>;
+    /** MAUI `StopVoiceAsync`; safe when nothing runs. */
+    stopVoice(): Promise<void>;
+    /** The inner element's node ref (MAUI `InnerEntry` / `InnerEditor`), for `invoke` calls G9 does not wrap. */
+    readonly element: G9NodeRef | null;
+}
+/** The Lynx node ref of a field's inner element. */
+export type G9NodeRef = NodesRef;
+/** Lynx input event detail. */
+interface InputDetail {
+    readonly value?: string;
+    readonly isComposing?: boolean;
+}
+/** Resolves the entered text's direction (MAUI `ResolveInputFlowDirection`). */
+export declare function resolveInputTextDirection(inputTextDirection: G9TextInputDirection, inputType: G9InputType, isPassword: boolean, cultureDirection: 'ltr' | 'rtl'): 'ltr' | 'rtl';
+/** Calls a UI method on a node; a missing node or a failing call is ignored (the element is gone). */
+export declare function invokeNode(ref: {
+    current: G9NodeRef | null;
+}, method: string, params?: Record<string, unknown>): boolean;
+/**
+ * {@link invokeNode}, retried on the next ticks (up to `attempts` times) while the element is not created natively
+ * yet, e.g. a focus requested during the first commit.
+ */
+export declare function invokeNodeWhenReady(ref: {
+    current: G9NodeRef | null;
+}, method: string, params?: Record<string, unknown>, attempts?: number): void;
+/** Options of {@link useTextInput}. */
+export interface G9TextInputCoreOptions {
+    /** Name for the controlled/uncontrolled diagnostic, e.g. `'G9TextEntry.value'`. */
+    readonly name: string;
+    /** Whether the microphone is shown, given the dictation and value state. */
+    readonly showMic: (state: {
+        available: boolean;
+        listening: boolean;
+        hasValue: boolean;
+    }) => boolean;
+    /** Extra validator (`G9TextEntry.validator`; the editor has none). */
+    readonly validator?: G9TextValidator | null;
+    /** Validate on every change (`G9TextEntry.validateOnTextChanged`). */
+    readonly validateOnTextChanged?: boolean;
+    /** A password field (its text is pinned LTR). */
+    readonly isPassword?: boolean;
+}
+/**
+ * The state machine behind the text inputs: value ownership, the live filter, the native element sync, focus,
+ * validation and dictation. Returns what the input element and the outlined frame need.
+ */
+export declare function useTextInput(props: G9TextInputProps, options: G9TextInputCoreOptions): {
+    text: string;
+    setText: import("../index.js").G9ControllableSetter<string, [G9ValueChangeDetails]>;
+    hasValue: boolean;
+    focused: boolean;
+    hasError: boolean;
+    errorText: string | null | undefined;
+    passwordVisible: boolean;
+    setPasswordVisible: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    dictation: import("./use-dictation.js").G9DictationState;
+    showMic: boolean;
+    pressMic: () => void;
+    focus: () => void;
+    blur: () => boolean;
+    handle: G9TextInputHandle;
+    inputType: G9InputType;
+    /** Element attributes and handlers shared by `<input>` and `<textarea>`. */
+    elementProps: {
+        'ignore-focus': boolean;
+        readonly: boolean;
+        disabled: boolean;
+        maxlength: number;
+        bindinput: (event: {
+            detail?: InputDetail;
+        }) => void;
+        bindfocus: () => void;
+        bindblur: () => void;
+        bindconfirm: () => void | undefined;
+        id?: string;
+        ref: (node: NodesRef | null) => void;
+        'data-g9keyboard': "target";
+    };
+    textDirection: "ltr" | "rtl";
+    font: string | undefined;
+};
+export {};
+//# sourceMappingURL=use-text-input.d.ts.map

package/dist/fields/use-text-input.d.ts.map

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