@happyvertical/smrt-ui 0.51.39 → 0.52.0

package/dist/components/forms/index.d.ts

@@ -11,24 +11,36 @@
  * dependency. The Provider-REQUIRED inputs (`CheckboxInput`, `TextInput`,
  * `MoneyInput`, the rich `Form`, …) stay in `@happyvertical/smrt-svelte/forms`.
  */
+export { canCaptureDictationAudio, createMediaRecorderCapture, DICTATION_AUDIO_MIME_TYPES, DICTATION_MAX_BYTES, DICTATION_MAX_DURATION_MS, type DictationAudioCapture, type DictationAudioCaptureFactory, type DictationAudioCaptureOptions, DictationError, type DictationRecording, pickDictationMimeType, } from './audio-capture.js';
 export { default as Checkbox } from './Checkbox.svelte';
 export { default as Combobox } from './Combobox.svelte';
+export { emitControlChange, focusControl, highlightControl, revealControl, } from './control-dom.js';
 export { type ControlBatchResult, type ControlCapability, type ControlCommand, type ControlCommandAction, type ControlCommandContext, type ControlCommandResult, type ControlCommandSource, type ControlConstraints, type ControlExtensionContext, type ControlIdentity, type ControlInteractionEvent, type ControlInteractionOptions, type ControlInteractionPolicy, type ControlInteractionRegistry, type ControlKind, type ControlMetadata, type ControlOption, type ControlRegistration, type ControlRuntimeState, type ControlSensitivity, type ControlSnapshot, type ControlStagedEntry, type ControlStagedProvenance, type ControlSubject, type ControlValueValidationResult, createControlInteractionRegistry, executeLocalControlBatch, executeLocalControlCommand, } from './control-interaction.js';
-export { type ControlInteractionContextValue, getControlInteractionContext, setControlInteractionContext, tryGetControlInteractionContext, } from './control-interaction-context.js';
+export { type ControlInteractionContextValue, getControlInteractionContext, recordControlUserEdit, setControlInteractionContext, tryGetControlInteractionContext, } from './control-interaction-context.js';
+export { type ControlProposalOptions, controlProposalInputSchema, controlProposalProperties, controlProposalSchema, controlProposalToolName, isControlProposable, proposableControls, type StageControlProposalsResult, stageControlProposals, } from './control-proposals.js';
 export { default as DatePicker } from './DatePicker.svelte';
+export { default as DictationButton } from './DictationButton.svelte';
+export { default as DictationStatus } from './DictationStatus.svelte';
+export { classifyDictationError, Dictation, type DictationErrorKind, type DictationLogEvent, type DictationOptions, type DictationSourceProvider, type DictationSpeechResult, type DictationSpeechSource, type DictationStartOptions, type DictationState, dictationErrorCode, } from './dictation.svelte.js';
+export { createHttpTranscriber, type DictationTranscribe, type DictationTranscribeOptions, type HttpTranscriberOptions, } from './dictation-transcribe.js';
 export { default as ErrorSummary } from './ErrorSummary.svelte';
 export { default as Fieldset } from './Fieldset.svelte';
 export { default as FilePicker } from './FilePicker.svelte';
 export { default as Form } from './Form.svelte';
+export { default as FormActionBar } from './FormActionBar.svelte';
 export { default as Field, default as FormGroup } from './FormGroup.svelte';
 export { type FormGroupContextValue, nextFieldId, setFormGroupContext, tryGetFormGroupContext, } from './form-group-context.js';
 export { default as Input } from './Input.svelte';
 export { default as InputGroup } from './InputGroup.svelte';
+export { insertTextAtCursor } from './insert-text.js';
 export { default as Listbox } from './Listbox.svelte';
+export { createLongPress, LONG_PRESS_DEFAULT_DELAY_MS, LONG_PRESS_DEFAULT_MOVE_TOLERANCE_PX, type LongPressController, type LongPressDetail, type LongPressOptions, longPress, } from './long-press.js';
 export { default as MultiSelect } from './MultiSelect.svelte';
 export { default as Radio } from './Radio.svelte';
 export { default as RadioGroup } from './RadioGroup.svelte';
 export { default as RangeSlider } from './RangeSlider.svelte';
+export { playReadyBeep, primeReadyBeep, type ReadyBeepOptions, } from './ready-beep.js';
+export { default as SearchInput } from './SearchInput.svelte';
 export { default as SegmentedControl } from './SegmentedControl.svelte';
 export { default as Select } from './Select.svelte';
 export { default as Slider } from './Slider.svelte';
@@ -41,4 +53,5 @@ export { default as TimePicker } from './TimePicker.svelte';
 export { default as Toggle } from './Toggle.svelte';
 export { default as ToggleButton } from './ToggleButton.svelte';
 export type { FormError, RangeSliderValue, SegmentedControlOption, } from './types.js';
+export { type ControlRegistrationDescriptor, useControlRegistration, } from './use-control-registration.svelte.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/forms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/forms/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,cAAc,EACd,KAAK,kBAAkB,EACvB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,gCAAgC,EAChC,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,8BAA8B,EACnC,4BAA4B,EAC5B,qBAAqB,EACrB,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,KAAK,sBAAsB,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,2BAA2B,EAChC,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EACL,sBAAsB,EACtB,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EACL,KAAK,qBAAqB,EAC1B,WAAW,EACX,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,oCAAoC,EACpC,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,SAAS,GACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,6BAA6B,EAClC,sBAAsB,GACvB,MAAM,sCAAsC,CAAC"}

package/dist/components/forms/index.js

@@ -11,24 +11,36 @@
  * dependency. The Provider-REQUIRED inputs (`CheckboxInput`, `TextInput`,
  * `MoneyInput`, the rich `Form`, …) stay in `@happyvertical/smrt-svelte/forms`.
  */
+export { canCaptureDictationAudio, createMediaRecorderCapture, DICTATION_AUDIO_MIME_TYPES, DICTATION_MAX_BYTES, DICTATION_MAX_DURATION_MS, DictationError, pickDictationMimeType, } from './audio-capture.js';
 export { default as Checkbox } from './Checkbox.svelte';
 export { default as Combobox } from './Combobox.svelte';
+export { emitControlChange, focusControl, highlightControl, revealControl, } from './control-dom.js';
 export { createControlInteractionRegistry, executeLocalControlBatch, executeLocalControlCommand, } from './control-interaction.js';
-export { getControlInteractionContext, setControlInteractionContext, tryGetControlInteractionContext, } from './control-interaction-context.js';
+export { getControlInteractionContext, recordControlUserEdit, setControlInteractionContext, tryGetControlInteractionContext, } from './control-interaction-context.js';
+export { controlProposalInputSchema, controlProposalProperties, controlProposalSchema, controlProposalToolName, isControlProposable, proposableControls, stageControlProposals, } from './control-proposals.js';
 export { default as DatePicker } from './DatePicker.svelte';
+export { default as DictationButton } from './DictationButton.svelte';
+export { default as DictationStatus } from './DictationStatus.svelte';
+export { classifyDictationError, Dictation, dictationErrorCode, } from './dictation.svelte.js';
+export { createHttpTranscriber, } from './dictation-transcribe.js';
 export { default as ErrorSummary } from './ErrorSummary.svelte';
 export { default as Fieldset } from './Fieldset.svelte';
 export { default as FilePicker } from './FilePicker.svelte';
 export { default as Form } from './Form.svelte';
+export { default as FormActionBar } from './FormActionBar.svelte';
 export { default as Field, default as FormGroup } from './FormGroup.svelte';
 export { nextFieldId, setFormGroupContext, tryGetFormGroupContext, } from './form-group-context.js';
 export { default as Input } from './Input.svelte';
 export { default as InputGroup } from './InputGroup.svelte';
+export { insertTextAtCursor } from './insert-text.js';
 export { default as Listbox } from './Listbox.svelte';
+export { createLongPress, LONG_PRESS_DEFAULT_DELAY_MS, LONG_PRESS_DEFAULT_MOVE_TOLERANCE_PX, longPress, } from './long-press.js';
 export { default as MultiSelect } from './MultiSelect.svelte';
 export { default as Radio } from './Radio.svelte';
 export { default as RadioGroup } from './RadioGroup.svelte';
 export { default as RangeSlider } from './RangeSlider.svelte';
+export { playReadyBeep, primeReadyBeep, } from './ready-beep.js';
+export { default as SearchInput } from './SearchInput.svelte';
 export { default as SegmentedControl } from './SegmentedControl.svelte';
 export { default as Select } from './Select.svelte';
 export { default as Slider } from './Slider.svelte';
@@ -39,3 +51,4 @@ export { default as Textarea } from './Textarea.svelte';
 export { default as TimePicker } from './TimePicker.svelte';
 export { default as Toggle } from './Toggle.svelte';
 export { default as ToggleButton } from './ToggleButton.svelte';
+export { useControlRegistration, } from './use-control-registration.svelte.js';

package/dist/components/forms/insert-text.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Put text into a text field at the cursor, the way typing would.
+ *
+ * - Replaces the selection, if any.
+ * - A field that has never had the cursor in it gets the text at the end.
+ * - Adds a space before the text when it would otherwise run into a word,
+ *   and after it when the next character is a letter or digit.
+ * - Leaves the cursor after the inserted text and fires `input`, so bound
+ *   values (`bind:value`) and listeners see the change.
+ */
+export declare function insertTextAtCursor(field: HTMLTextAreaElement | HTMLInputElement, text: string): void;
+//# sourceMappingURL=insert-text.d.ts.map

package/dist/components/forms/insert-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-text.d.ts","sourceRoot":"","sources":["../../../src/components/forms/insert-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,GAAG,gBAAgB,EAC7C,IAAI,EAAE,MAAM,GACX,IAAI,CA0BN"}

package/dist/components/forms/insert-text.js

@@ -0,0 +1,38 @@
+/**
+ * Put text into a text field at the cursor, the way typing would.
+ *
+ * - Replaces the selection, if any.
+ * - A field that has never had the cursor in it gets the text at the end.
+ * - Adds a space before the text when it would otherwise run into a word,
+ *   and after it when the next character is a letter or digit.
+ * - Leaves the cursor after the inserted text and fires `input`, so bound
+ *   values (`bind:value`) and listeners see the change.
+ */
+export function insertTextAtCursor(field, text) {
+    const words = text.trim();
+    if (!words)
+        return;
+    const value = field.value;
+    const focused = typeof document !== 'undefined' && document.activeElement === field;
+    let start = field.selectionStart ?? value.length;
+    let end = field.selectionEnd ?? value.length;
+    // An untouched field reports 0/0; dictation then belongs at the end.
+    if (!focused && start === 0 && end === 0 && value.length > 0) {
+        start = value.length;
+        end = value.length;
+    }
+    const before = value.slice(0, start);
+    const after = value.slice(end);
+    const lead = before.length > 0 && !/\s$/.test(before) ? ' ' : '';
+    const trail = /^[\p{L}\p{N}]/u.test(after) ? ' ' : '';
+    const inserted = `${lead}${words}${trail}`;
+    field.value = `${before}${inserted}${after}`;
+    const caret = before.length + inserted.length;
+    try {
+        field.setSelectionRange(caret, caret);
+    }
+    catch {
+        // Some input types do not support selection; the value is still set.
+    }
+    field.dispatchEvent(new Event('input', { bubbles: true }));
+}

package/dist/components/forms/long-press.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Long-press detection for pointer (mouse, pen) and touch input.
+ *
+ * A press counts as a long press when the primary pointer stays down, and
+ * within `moveTolerance` pixels of where it went down, for `delay`
+ * milliseconds (default 500ms, 10px). Moving further first is a drag or a
+ * scroll, never a long press, so a host's own drag gestures keep working.
+ * A native `dragstart` cancels a pending press for the same reason.
+ *
+ * - Only the primary button (left mouse, a finger, a pen tip) starts one; a
+ *   right click is left alone, and so is the context menu it opens.
+ * - The `click` that follows a fired long press is swallowed so the release
+ *   does not also "tap" the target.
+ * - `preventContextMenu` suppresses the context menu a touch long press
+ *   opens (Android, desktop touch screens) — but only during a press this
+ *   detector is tracking. Opt in only where the long press replaces that
+ *   menu (for example on a picture), never on a text field.
+ *
+ * Framework-free: `createLongPress` returns handlers a host wires itself, and
+ * `longPress` is the Svelte action (`use:longPress={options}`) that wires
+ * them to an element.
+ */
+/** What a long press was made on. */
+export interface LongPressDetail {
+    /** The element the press is about (from `filter`, else the event target). */
+    target: Element;
+    /** `mouse`, `pen` or `touch`. */
+    pointerType: string;
+    clientX: number;
+    clientY: number;
+}
+export interface LongPressOptions {
+    /** How long the pointer must stay down, in ms. Default 500. */
+    delay?: number;
+    /** How far (px) the pointer may move before it is a drag instead. Default 10. */
+    moveTolerance?: number;
+    /**
+     * Which presses count. Return the element the press is about, or `null` /
+     * `false` to ignore the press (for example: only pictures inside an
+     * editor). Default: every press, about its event target.
+     */
+    filter?: (event: PointerEvent) => Element | null | boolean;
+    /** The pointer stayed down long enough. */
+    onLongPress: (detail: LongPressDetail) => void;
+    /** The pointer came up after a long press fired (a user gesture). */
+    onRelease?: (detail: LongPressDetail) => void;
+    /** The pointer went down on a counted target (before the delay). */
+    onPressStart?: (detail: LongPressDetail) => void;
+    /** A pending press ended without firing (a tap, a drag, a scroll). */
+    onCancel?: () => void;
+    /** Suppress the context menu during a tracked press. Default false. */
+    preventContextMenu?: boolean;
+    /** Ignore every press. */
+    disabled?: boolean;
+}
+export declare const LONG_PRESS_DEFAULT_DELAY_MS = 500;
+export declare const LONG_PRESS_DEFAULT_MOVE_TOLERANCE_PX = 10;
+export interface LongPressController {
+    handlePointerDown(event: PointerEvent): void;
+    handlePointerMove(event: PointerEvent): void;
+    handlePointerUp(event: PointerEvent): void;
+    handlePointerCancel(event: PointerEvent): void;
+    handleDragStart(): void;
+    handleContextMenu(event: Event): void;
+    /** Wire in the capture phase so the swallowed click never reaches the target. */
+    handleClick(event: Event): void;
+    /** Forget any press in progress (no callbacks). */
+    cancel(): void;
+    update(options: LongPressOptions): void;
+    /** A press is down and waiting for the delay. */
+    readonly pending: boolean;
+    /** The current press already fired (until the pointer comes up). */
+    readonly fired: boolean;
+}
+/** Long-press state and handlers (see the module comment). */
+export declare function createLongPress(initial: LongPressOptions): LongPressController;
+/**
+ * Svelte action: `use:longPress={{ onLongPress: () => … }}`.
+ *
+ * Listens on the element (presses bubble up from its children, so wrapping a
+ * field or an editor works). Pointer moves and releases are also tracked on
+ * the window so a release outside the element still ends the press.
+ */
+export declare function longPress(node: HTMLElement, options: LongPressOptions): {
+    update(next: LongPressOptions): void;
+    destroy(): void;
+};
+//# sourceMappingURL=long-press.d.ts.map

package/dist/components/forms/long-press.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-press.d.ts","sourceRoot":"","sources":["../../../src/components/forms/long-press.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC;IAC3D,2CAA2C;IAC3C,WAAW,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/C,qEAAqE;IACrE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC9C,oEAAoE;IACpE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IACjD,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7C,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7C,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3C,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,eAAe,IAAI,IAAI,CAAC;IACxB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACtC,iFAAiF;IACjF,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAChC,mDAAmD;IACnD,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,GACxB,mBAAmB,CA6IrB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB;iBAmBrD,gBAAgB;;EAchC"}

package/dist/components/forms/long-press.js

@@ -0,0 +1,213 @@
+/**
+ * Long-press detection for pointer (mouse, pen) and touch input.
+ *
+ * A press counts as a long press when the primary pointer stays down, and
+ * within `moveTolerance` pixels of where it went down, for `delay`
+ * milliseconds (default 500ms, 10px). Moving further first is a drag or a
+ * scroll, never a long press, so a host's own drag gestures keep working.
+ * A native `dragstart` cancels a pending press for the same reason.
+ *
+ * - Only the primary button (left mouse, a finger, a pen tip) starts one; a
+ *   right click is left alone, and so is the context menu it opens.
+ * - The `click` that follows a fired long press is swallowed so the release
+ *   does not also "tap" the target.
+ * - `preventContextMenu` suppresses the context menu a touch long press
+ *   opens (Android, desktop touch screens) — but only during a press this
+ *   detector is tracking. Opt in only where the long press replaces that
+ *   menu (for example on a picture), never on a text field.
+ *
+ * Framework-free: `createLongPress` returns handlers a host wires itself, and
+ * `longPress` is the Svelte action (`use:longPress={options}`) that wires
+ * them to an element.
+ */
+export const LONG_PRESS_DEFAULT_DELAY_MS = 500;
+export const LONG_PRESS_DEFAULT_MOVE_TOLERANCE_PX = 10;
+/** Long-press state and handlers (see the module comment). */
+export function createLongPress(initial) {
+    let options = initial;
+    let timer = null;
+    let pointerId = null;
+    let startX = 0;
+    let startY = 0;
+    let detail = null;
+    let fired = false;
+    let swallowClick = false;
+    let swallowTimer = null;
+    function clearTimer() {
+        if (timer)
+            clearTimeout(timer);
+        timer = null;
+    }
+    function reset() {
+        clearTimer();
+        pointerId = null;
+        detail = null;
+        fired = false;
+    }
+    function cancelPending() {
+        if (!timer)
+            return;
+        reset();
+        options.onCancel?.();
+    }
+    function resolveTarget(event) {
+        const picked = options.filter ? options.filter(event) : true;
+        if (!picked)
+            return null;
+        if (picked === true) {
+            return event.target instanceof Element ? event.target : null;
+        }
+        return picked;
+    }
+    function armClickSwallow() {
+        swallowClick = true;
+        if (swallowTimer)
+            clearTimeout(swallowTimer);
+        // A click that never comes (the pointer moved off) must not eat a later one.
+        swallowTimer = setTimeout(() => {
+            swallowClick = false;
+            swallowTimer = null;
+        }, 400);
+    }
+    return {
+        handlePointerDown(event) {
+            if (options.disabled)
+                return;
+            if (!event.isPrimary)
+                return;
+            if (event.pointerType === 'mouse' && event.button !== 0)
+                return;
+            const target = resolveTarget(event);
+            if (!target)
+                return;
+            reset();
+            pointerId = event.pointerId;
+            startX = event.clientX;
+            startY = event.clientY;
+            detail = {
+                target,
+                pointerType: event.pointerType || 'mouse',
+                clientX: event.clientX,
+                clientY: event.clientY,
+            };
+            options.onPressStart?.(detail);
+            const pressed = detail;
+            timer = setTimeout(() => {
+                timer = null;
+                fired = true;
+                options.onLongPress(pressed);
+            }, options.delay ?? LONG_PRESS_DEFAULT_DELAY_MS);
+        },
+        handlePointerMove(event) {
+            if (!timer || event.pointerId !== pointerId)
+                return;
+            const tolerance = options.moveTolerance ?? LONG_PRESS_DEFAULT_MOVE_TOLERANCE_PX;
+            if (Math.hypot(event.clientX - startX, event.clientY - startY) > tolerance) {
+                cancelPending();
+            }
+        },
+        handlePointerUp(event) {
+            if (event.pointerId !== pointerId)
+                return;
+            if (timer) {
+                cancelPending();
+                return;
+            }
+            if (fired && detail) {
+                const released = detail;
+                armClickSwallow();
+                reset();
+                options.onRelease?.(released);
+                return;
+            }
+            reset();
+        },
+        handlePointerCancel(event) {
+            if (event.pointerId !== pointerId)
+                return;
+            if (timer) {
+                cancelPending();
+                return;
+            }
+            if (fired && detail) {
+                const released = detail;
+                reset();
+                options.onRelease?.(released);
+                return;
+            }
+            reset();
+        },
+        handleDragStart() {
+            cancelPending();
+        },
+        handleContextMenu(event) {
+            if (!options.preventContextMenu)
+                return;
+            if (timer || fired)
+                event.preventDefault();
+        },
+        handleClick(event) {
+            if (!swallowClick)
+                return;
+            swallowClick = false;
+            if (swallowTimer)
+                clearTimeout(swallowTimer);
+            swallowTimer = null;
+            event.preventDefault();
+            event.stopPropagation();
+        },
+        cancel() {
+            reset();
+        },
+        update(next) {
+            options = next;
+            if (next.disabled)
+                reset();
+        },
+        get pending() {
+            return timer !== null;
+        },
+        get fired() {
+            return fired;
+        },
+    };
+}
+/**
+ * Svelte action: `use:longPress={{ onLongPress: () => … }}`.
+ *
+ * Listens on the element (presses bubble up from its children, so wrapping a
+ * field or an editor works). Pointer moves and releases are also tracked on
+ * the window so a release outside the element still ends the press.
+ */
+export function longPress(node, options) {
+    const controller = createLongPress(options);
+    const down = (event) => controller.handlePointerDown(event);
+    const move = (event) => controller.handlePointerMove(event);
+    const up = (event) => controller.handlePointerUp(event);
+    const cancel = (event) => controller.handlePointerCancel(event);
+    const drag = () => controller.handleDragStart();
+    const menu = (event) => controller.handleContextMenu(event);
+    const click = (event) => controller.handleClick(event);
+    node.addEventListener('pointerdown', down);
+    node.addEventListener('dragstart', drag);
+    node.addEventListener('contextmenu', menu);
+    node.addEventListener('click', click, true);
+    window.addEventListener('pointermove', move);
+    window.addEventListener('pointerup', up);
+    window.addEventListener('pointercancel', cancel);
+    return {
+        update(next) {
+            controller.update(next);
+        },
+        destroy() {
+            controller.cancel();
+            node.removeEventListener('pointerdown', down);
+            node.removeEventListener('dragstart', drag);
+            node.removeEventListener('contextmenu', menu);
+            node.removeEventListener('click', click, true);
+            window.removeEventListener('pointermove', move);
+            window.removeEventListener('pointerup', up);
+            window.removeEventListener('pointercancel', cancel);
+        },
+    };
+}

package/dist/components/forms/ready-beep.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A short "ready" beep, made with the Web Audio API (no sound files).
+ *
+ * Browsers only start audio after a user gesture. A long press fires from a
+ * timer while the finger is still down, which on touch screens is not a
+ * gesture yet, so `playReadyBeep` resolves `false` when the audio could not
+ * start; the host plays it again from the release (`pointerup` is a gesture).
+ * `primeReadyBeep` creates the audio context early, from a gesture, so later
+ * beeps start immediately.
+ */
+/** Create (or wake) the audio context; call from a user gesture. */
+export declare function primeReadyBeep(): void;
+export interface ReadyBeepOptions {
+    /** Volume, 0–1. Default 0.12. */
+    volume?: number;
+}
+/**
+ * Play two quick rising tones (about 0.2s). Resolves `true` when it played,
+ * `false` when audio is unavailable or not allowed yet.
+ */
+export declare function playReadyBeep(options?: ReadyBeepOptions): Promise<boolean>;
+/** Tests: forget the shared audio context. */
+export declare function resetReadyBeepForTests(): void;
+//# sourceMappingURL=ready-beep.d.ts.map

package/dist/components/forms/ready-beep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-beep.d.ts","sourceRoot":"","sources":["../../../src/components/forms/ready-beep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4BH,oEAAoE;AACpE,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,8CAA8C;AAC9C,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/components/forms/ready-beep.js

@@ -0,0 +1,82 @@
+/**
+ * A short "ready" beep, made with the Web Audio API (no sound files).
+ *
+ * Browsers only start audio after a user gesture. A long press fires from a
+ * timer while the finger is still down, which on touch screens is not a
+ * gesture yet, so `playReadyBeep` resolves `false` when the audio could not
+ * start; the host plays it again from the release (`pointerup` is a gesture).
+ * `primeReadyBeep` creates the audio context early, from a gesture, so later
+ * beeps start immediately.
+ */
+let context = null;
+function audioContextCtor() {
+    if (typeof window === 'undefined')
+        return null;
+    const w = window;
+    return (w.AudioContext ??
+        w.webkitAudioContext ??
+        null);
+}
+function getContext() {
+    if (context)
+        return context;
+    const Ctor = audioContextCtor();
+    if (!Ctor)
+        return null;
+    try {
+        context = new Ctor();
+    }
+    catch {
+        context = null;
+    }
+    return context;
+}
+/** Create (or wake) the audio context; call from a user gesture. */
+export function primeReadyBeep() {
+    const ctx = getContext();
+    if (ctx && ctx.state === 'suspended') {
+        void ctx.resume().catch(() => undefined);
+    }
+}
+/**
+ * Play two quick rising tones (about 0.2s). Resolves `true` when it played,
+ * `false` when audio is unavailable or not allowed yet.
+ */
+export async function playReadyBeep(options = {}) {
+    const ctx = getContext();
+    if (!ctx)
+        return false;
+    try {
+        if (ctx.state === 'suspended')
+            await ctx.resume();
+    }
+    catch {
+        return false;
+    }
+    if (ctx.state !== 'running')
+        return false;
+    const volume = Math.max(0, Math.min(1, options.volume ?? 0.12));
+    const start = ctx.currentTime + 0.01;
+    const tones = [
+        [660, 0],
+        [990, 0.1],
+    ];
+    for (const [frequency, at] of tones) {
+        const oscillator = ctx.createOscillator();
+        const gain = ctx.createGain();
+        oscillator.type = 'sine';
+        oscillator.frequency.value = frequency;
+        gain.gain.setValueAtTime(0, start + at);
+        gain.gain.linearRampToValueAtTime(volume, start + at + 0.01);
+        gain.gain.exponentialRampToValueAtTime(0.0001, start + at + 0.09);
+        oscillator.connect(gain);
+        gain.connect(ctx.destination);
+        oscillator.start(start + at);
+        oscillator.stop(start + at + 0.1);
+    }
+    return true;
+}
+/** Tests: forget the shared audio context. */
+export function resetReadyBeepForTests() {
+    context = null;
+}