@vielzeug/refine 1.8.0 → 2.0.0

package/dist/core/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","names":[],"sources":["../../src/core/overlay.ts"],"sourcesContent":["/**\n * Why an overlay was opened.\n * - `'click'`       — user clicked the trigger element\n * - `'focus'`       — focus entered the trigger (tooltip, popover)\n * - `'hover'`       — pointer entered the trigger (tooltip)\n * - `'keyboard'`    — keyboard shortcut or Enter/Space on a trigger\n * - `'programmatic'` — opened via the JS API without a user gesture\n * - `'trigger'`     — opened via the Invoker Commands API (`command=\"show-modal\"`)\n */\nexport type OverlayOpenReason = 'click' | 'focus' | 'hover' | 'keyboard' | 'programmatic' | 'trigger';\n\n/** Close reasons valid for modal dialogs (includes 'swipe' for drawer). */\nexport type DialogCloseReason = 'escape' | 'outsideClick' | 'programmatic' | 'swipe' | 'trigger';\n/** Close reasons valid for dropdown overlays (no swipe). */\nexport type DropdownCloseReason = Exclude<DialogCloseReason, 'swipe'>;\n\n/** Detail shape for overlay open events emitted by components. */\nexport type OverlayOpenDetail = { reason: OverlayOpenReason };\n/** Detail shape for overlay close events emitted by components. */\nexport type OverlayCloseDetail = { reason: DialogCloseReason };\n/** Detail shape for state changes emitted by overlay components. */\nexport type OverlayOpenChangeDetail = {\n  open: boolean;\n  reason: DialogCloseReason | OverlayOpenReason;\n};\n\nexport type OutsidePointerDismissalOptions = {\n  getTargets: () => Array<Element | null | undefined>;\n  isActive: () => boolean;\n  onDismiss: () => void;\n  signal: AbortSignal;\n};\n\n/**\n * Dismisses an active floating surface when a pointer begins outside all of its\n * supplied boundary elements. Components retain ownership of their open state.\n */\nexport const createOutsidePointerDismissal = (options: OutsidePointerDismissalOptions): (() => void) => {\n  const onPointerDown = (event: PointerEvent): void => {\n    if (!options.isActive()) return;\n\n    const path = event.composedPath();\n    const target = path[0] instanceof Node ? path[0] : event.target instanceof Node ? event.target : null;\n    const inside = options.getTargets().some((element) => {\n      return (\n        element !== null &&\n        element !== undefined &&\n        (path.includes(element) || Boolean(target && element.contains(target)))\n      );\n    });\n\n    if (!inside) options.onDismiss();\n  };\n\n  const dispose = (): void => {\n    document.removeEventListener('pointerdown', onPointerDown, { capture: true });\n  };\n\n  document.addEventListener('pointerdown', onPointerDown, { capture: true });\n  options.signal.addEventListener('abort', dispose, { once: true });\n\n  return dispose;\n};\n\n/** Restores focus to a trigger when the owning overlay chooses to do so. */\nexport const restoreFocus = (getTrigger: () => HTMLElement | null | undefined): void => {\n  getTrigger()?.focus();\n};\n"],"mappings":";AAqCA,IAAa,KAAiC,MAA0D;CACtG,IAAM,KAAiB,MAA8B;EACnD,IAAI,CAAC,EAAQ,SAAS,GAAG;EAEzB,IAAM,IAAO,EAAM,aAAa,GAC1B,IAAS,EAAK,cAAc,OAAO,EAAK,KAAK,EAAM,kBAAkB,OAAO,EAAM,SAAS;EASjG,AARe,EAAQ,WAAW,CAAC,CAAC,MAAM,MAEtC,KAAY,SAEX,EAAK,SAAS,CAAO,KAAK,GAAQ,KAAU,EAAQ,SAAS,CAAM,GAInE,KAAQ,EAAQ,UAAU;CACjC,GAEM,UAAsB;EAC1B,SAAS,oBAAoB,eAAe,GAAe,EAAE,SAAS,GAAK,CAAC;CAC9E;CAKA,OAHA,SAAS,iBAAiB,eAAe,GAAe,EAAE,SAAS,GAAK,CAAC,GACzE,EAAQ,OAAO,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC,GAEzD;AACT,GAGa,KAAgB,MAA2D;CACtF,EAAW,CAAC,EAAE,MAAM;AACtB"}

package/dist/core/paginated-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginated-list.d.ts","sourceRoot":"","sources":["../../src/core/paginated-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAU,MAAM,kBAAkB,CAAC;AAInE,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IACpC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;IACpB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEpC,qDAAqD;IACrD,IAAI,IAAI,IAAI,CAAC;IACb,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAClC,0DAA0D;IAC1D,IAAI,IAAI,IAAI,CAAC;IACb,+BAA+B;IAC/B,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAIF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,EAAE,SAAS,oBAAoB,CAAC,CAAC,CAAC,KAAG,mBAAmB,CAAC,CAAC,CA2D9F,CAAC"}

package/dist/core/parse.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.cjs","names":[],"sources":["../../src/core/parse.ts"],"sourcesContent":["// ── Trigger string parser ─────────────────────────────────────────────────────\n\n/**\n * Parses a comma-separated trigger string into a typed array, filtering against\n * a valid set and falling back to `defaults` when the input is empty or invalid.\n *\n * Used by tooltip and popover to normalise their `trigger` prop values.\n *\n * @example\n * ```ts\n * const VALID = new Set(['click', 'hover', 'focus'] as const);\n * parseStringTriggers('hover,focus', VALID, ['click']); // → ['hover', 'focus']\n * parseStringTriggers('',            VALID, ['click']); // → ['click']\n * ```\n */\nexport const parseStringTriggers = <T extends string>(\n  value: string | null | undefined,\n  valid: ReadonlySet<T>,\n  defaults: T[],\n): T[] => {\n  const parsed = String(value ?? '')\n    .split(',')\n    .map((t) => t.trim())\n    .filter((t): t is T => valid.has(t as T));\n\n  return parsed.length > 0 ? parsed : [...defaults];\n};\n"],"mappings":"AAeA,IAAa,GACX,EACA,EACA,IACQ,CACR,IAAM,EAAS,OAAO,GAAS,EAAE,CAAC,CAC/B,MAAM,GAAG,CAAC,CACV,IAAK,GAAM,EAAE,KAAK,CAAC,CAAC,CACpB,OAAQ,GAAc,EAAM,IAAI,CAAM,CAAC,EAE1C,OAAO,EAAO,OAAS,EAAI,EAAS,CAAC,GAAG,CAAQ,CAClD"}

package/dist/core/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/core/parse.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,MAAM,EAClD,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,WAAW,CAAC,CAAC,CAAC,EACrB,UAAU,CAAC,EAAE,KACZ,CAAC,EAOH,CAAC"}

package/dist/{headless → core}/parse.js

@@ -1,4 +1,4 @@
-//#region src/headless/parse.ts
+//#region src/core/parse.ts
 var e = (e, t, n) => {
 	let r = String(e ?? "").split(",").map((e) => e.trim()).filter((e) => t.has(e));
 	return r.length > 0 ? r : [...n];

package/dist/core/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","names":[],"sources":["../../src/core/parse.ts"],"sourcesContent":["// ── Trigger string parser ─────────────────────────────────────────────────────\n\n/**\n * Parses a comma-separated trigger string into a typed array, filtering against\n * a valid set and falling back to `defaults` when the input is empty or invalid.\n *\n * Used by tooltip and popover to normalise their `trigger` prop values.\n *\n * @example\n * ```ts\n * const VALID = new Set(['click', 'hover', 'focus'] as const);\n * parseStringTriggers('hover,focus', VALID, ['click']); // → ['hover', 'focus']\n * parseStringTriggers('',            VALID, ['click']); // → ['click']\n * ```\n */\nexport const parseStringTriggers = <T extends string>(\n  value: string | null | undefined,\n  valid: ReadonlySet<T>,\n  defaults: T[],\n): T[] => {\n  const parsed = String(value ?? '')\n    .split(',')\n    .map((t) => t.trim())\n    .filter((t): t is T => valid.has(t as T));\n\n  return parsed.length > 0 ? parsed : [...defaults];\n};\n"],"mappings":";AAeA,IAAa,KACX,GACA,GACA,MACQ;CACR,IAAM,IAAS,OAAO,KAAS,EAAE,CAAC,CAC/B,MAAM,GAAG,CAAC,CACV,KAAK,MAAM,EAAE,KAAK,CAAC,CAAC,CACpB,QAAQ,MAAc,EAAM,IAAI,CAAM,CAAC;CAE1C,OAAO,EAAO,SAAS,IAAI,IAAS,CAAC,GAAG,CAAQ;AAClD"}

package/dist/core/positioner.cjs

@@ -0,0 +1,2 @@
+const e=require("./direction.cjs");let t=require("@vielzeug/orbit");var n=e=>e.endsWith(`-start`)?e.replace(`-start`,`-end`):e.endsWith(`-end`)?e.replace(`-end`,`-start`):e;function r({boundary:r,getDir:i,getFloating:a,getPlacement:o,getReference:s,matchWidth:c=!0,offsetPx:l=0,padding:u=6}){function d(){let t=o?.()??`bottom-start`;return(i?.()??e.elementDirection(s()))===`rtl`?n(t):t}function f(){let e=s(),n=a();if(!e||!n)return;let i=d(),o=r??(0,t.getClippingAncestorRect)(n),f=(0,t.computePosition)(e,n,{boundary:o,middleware:[...l?[(0,t.offset)(l)]:[],(0,t.flip)({padding:u}),(0,t.shift)({padding:u}),...c?[(0,t.size)({padding:u})]:[]],placement:i});n.style.left=`${f.x}px`,n.style.top=`${f.y}px`;let p=n.style.transition,m=n.style.transform;n.style.transition=`none`,n.style.transform=`none`;let h=n.getBoundingClientRect(),g=f.x-h.left,_=f.y-h.top;n.style.transition=p,n.style.transform=m,(g!==0||_!==0)&&(n.style.left=`${f.x+g}px`,n.style.top=`${f.y+_}px`),c&&(n.style.width=`${e.getBoundingClientRect().width}px`)}function p(){let e=s(),n=a();return!e||!n?()=>{}:(0,t.autoUpdate)(e,n,f)}return{floating:a,reference:s,startAutoUpdate:p,update:f}}exports.createDropdownPositioner=r;
+//# sourceMappingURL=positioner.cjs.map

package/dist/core/positioner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioner.cjs","names":[],"sources":["../../src/core/positioner.ts"],"sourcesContent":["import {\n  autoUpdate,\n  computePosition,\n  flip,\n  getClippingAncestorRect,\n  offset,\n  type Placement,\n  type Rect,\n  shift,\n  size,\n} from '@vielzeug/orbit';\n\nimport { elementDirection } from './direction';\n\n// ── Overlay positioner contract ──────────────────────────────────────────────\n\nexport type OverlayPositioner = {\n  floating: () => HTMLElement | null;\n  reference: () => HTMLElement | null;\n  /** Start continuous position auto-updates. Returns a stop function. */\n  startAutoUpdate?: () => () => void;\n  update: () => void;\n};\n\n// ── Dropdown positioner ───────────────────────────────────────────────────────\n\nexport type DropdownPositionerOptions = {\n  /**\n   * Clipping boundary for flip/shift/size — the edges the dropdown must stay within.\n   * Defaults to the nearest ancestor that actually clips content (`overflow:\n   * hidden|auto|scroll|clip`, e.g. a dialog panel), auto-detected per update via\n   * `getClippingAncestorRect()`, intersected with the viewport. Without this, flip/shift only\n   * avoid the full page viewport — a dropdown can be \"in view\" by that measure while still\n   * visibly overhanging a much smaller container it's actually nested in. Pass an explicit\n   * boundary to override auto-detection.\n   */\n  boundary?: Element | Rect;\n  /**\n   * Returns the text direction used for placement mirroring. Defaults to the resolved\n   * direction of the reference element (nearest `dir=\"ltr\"|\"rtl\"` ancestor, falling back to\n   * computed style) — most callers never need to pass this explicitly.\n   */\n  getDir?: () => 'ltr' | 'rtl';\n  /** Getter for the floating (dropdown panel) element. */\n  getFloating: () => HTMLElement | null;\n  /** Getter for the current placement. Defaults to 'bottom-start' (RTL-aware: flips to 'bottom-end'). */\n  getPlacement?: () => Placement;\n  /** Getter for the reference (trigger) element. */\n  getReference: () => HTMLElement | null;\n  /** Whether to match the floating element width to the reference. Default: true */\n  matchWidth?: boolean;\n  /** Additional offset in pixels between reference and floating element. Default: 0 */\n  offsetPx?: number;\n  /** Padding (px) used by flip, shift, and size middleware. Default: 6 */\n  padding?: number;\n};\n\n/** Mirrors a start/end placement for RTL layouts. */\nconst rtlPlacement = (p: Placement): Placement => {\n  if (p.endsWith('-start')) return p.replace('-start', '-end') as Placement;\n\n  if (p.endsWith('-end')) return p.replace('-end', '-start') as Placement;\n\n  return p;\n};\n\n/**\n * Creates an Orbit-powered positioner for dropdown overlays (select, combobox, menu).\n *\n * Uses flip + shift + optional width-matching middleware. Supports continuous\n * auto-update for repositioning on scroll or resize.\n *\n * RTL-aware: start/end placements are automatically mirrored so dropdowns open on the\n * correct side, based on `getDir` (or the reference element's resolved direction when\n * `getDir` is omitted).\n */\nexport function createDropdownPositioner({\n  boundary,\n  getDir,\n  getFloating,\n  getPlacement,\n  getReference,\n  matchWidth = true,\n  offsetPx = 0,\n  padding = 6,\n}: DropdownPositionerOptions): OverlayPositioner {\n  function resolvedPlacement(): Placement {\n    const base = getPlacement?.() ?? 'bottom-start';\n    const dir = getDir?.() ?? elementDirection(getReference());\n\n    return dir === 'rtl' ? rtlPlacement(base) : base;\n  }\n\n  function updatePosition(): void {\n    const ref = getReference();\n    const floating = getFloating();\n\n    if (!ref || !floating) return;\n\n    const placement = resolvedPlacement();\n    // Defaults to `undefined` (meaning \"auto-detect\"), not the detected value itself —\n    // re-running the detection on every update (rather than once, at positioner-creation time)\n    // matters because the dialog/scroll-container an instance is rendered into can change\n    // across opens (e.g. the same `<ore-select>` reused in different dialogs), and the detected\n    // ancestor's own rect can change between opens even when it's the same element (a resized\n    // dialog).\n    const resolvedBoundary = boundary ?? getClippingAncestorRect(floating);\n\n    const result = computePosition(ref, floating, {\n      boundary: resolvedBoundary,\n      middleware: [\n        ...(offsetPx ? [offset(offsetPx)] : []),\n        flip({ padding }),\n        shift({ padding }),\n        ...(matchWidth ? [size({ padding })] : []),\n      ],\n      placement,\n    });\n\n    floating.style.left = `${result.x}px`;\n    floating.style.top = `${result.y}px`;\n\n    // `computePosition()` assumes `left`/`top` resolve relative to the viewport (correct for\n    // `position: fixed`) — true almost always, but not when some ancestor establishes a\n    // containing block for fixed descendants (a non-`none` `transform`, even a visually-identity\n    // one left over from an entrance transition that never resets to `none` at rest is a real,\n    // easy-to-hit case — a modal dialog's panel, say). Analytically detecting *that* ancestor via\n    // `getContainingBlock()` and pre-subtracting its rect turned out to be unreliable in\n    // practice: browsers don't apply the \"ancestor transform traps fixed descendants\" rule\n    // uniformly across every element nested under it in every case we tested — some floating\n    // elements in the exact same subtree needed the correction and some didn't, for reasons we\n    // couldn't fully pin down. Measuring what actually happened after writing `left`/`top`\n    // and correcting only the observed gap sidesteps that: it's a no-op when the browser already\n    // put the element where asked, and it fixes the same class of bug the moment there's a real\n    // mismatch, regardless of which specific ancestor (if any) turns out to be responsible.\n    //\n    // The measurement itself must not be fooled by the floating element's *own* transform,\n    // though: dropdowns/popovers here all use a `transform: translateY(...)` entrance transition\n    // driven by a `[data-open]` attribute + `@starting-style` — right at open, before the\n    // transition has visibly progressed, `getBoundingClientRect()` can still reflect that\n    // starting offset (a handful of px, matching `--overlay-enter-translate-y`), which this\n    // correction would otherwise misread as a permanent ancestor-driven mismatch and bake in\n    // forever. Temporarily neutralizing the floating element's own transform for the measurement\n    // (and restoring it before anything paints, so there's no visible flash) isolates the\n    // correction to ancestor-driven offsets only, which is the only thing it's meant to fix.\n    const prevTransition = floating.style.transition;\n    const prevTransform = floating.style.transform;\n\n    floating.style.transition = 'none';\n    floating.style.transform = 'none';\n\n    const actual = floating.getBoundingClientRect();\n    const deltaX = result.x - actual.left;\n    const deltaY = result.y - actual.top;\n\n    floating.style.transition = prevTransition;\n    floating.style.transform = prevTransform;\n\n    if (deltaX !== 0 || deltaY !== 0) {\n      floating.style.left = `${result.x + deltaX}px`;\n      floating.style.top = `${result.y + deltaY}px`;\n    }\n\n    if (matchWidth) {\n      floating.style.width = `${ref.getBoundingClientRect().width}px`;\n    }\n  }\n\n  function startAutoUpdate(): () => void {\n    const ref = getReference();\n    const floating = getFloating();\n\n    if (!ref || !floating) return () => {};\n\n    return autoUpdate(ref, floating, updatePosition);\n  }\n\n  return { floating: getFloating, reference: getReference, startAutoUpdate, update: updatePosition };\n}\n"],"mappings":"oEA0DA,IAAM,EAAgB,GAChB,EAAE,SAAS,QAAQ,EAAU,EAAE,QAAQ,SAAU,MAAM,EAEvD,EAAE,SAAS,MAAM,EAAU,EAAE,QAAQ,OAAQ,QAAQ,EAElD,EAaT,SAAgB,EAAyB,CACvC,WACA,SACA,cACA,eACA,eACA,aAAa,GACb,WAAW,EACX,UAAU,GACqC,CAC/C,SAAS,GAA+B,CACtC,IAAM,EAAO,IAAe,GAAK,eAGjC,OAFY,IAAS,GAAK,EAAA,iBAAiB,EAAa,CAAC,KAE1C,MAAQ,EAAa,CAAI,EAAI,CAC9C,CAEA,SAAS,GAAuB,CAC9B,IAAM,EAAM,EAAa,EACnB,EAAW,EAAY,EAE7B,GAAI,CAAC,GAAO,CAAC,EAAU,OAEvB,IAAM,EAAY,EAAkB,EAO9B,EAAmB,IAAA,EAAY,EAAA,wBAAA,CAAwB,CAAQ,EAE/D,GAAA,EAAS,EAAA,gBAAA,CAAgB,EAAK,EAAU,CAC5C,SAAU,EACV,WAAY,CACV,GAAI,EAAW,EAAA,EAAC,EAAA,OAAA,CAAO,CAAQ,CAAC,EAAI,CAAC,GACrC,EAAA,EAAA,KAAA,CAAK,CAAE,SAAQ,CAAC,GAChB,EAAA,EAAA,MAAA,CAAM,CAAE,SAAQ,CAAC,EACjB,GAAI,EAAa,EAAA,EAAC,EAAA,KAAA,CAAK,CAAE,SAAQ,CAAC,CAAC,EAAI,CAAC,CAC1C,EACA,WACF,CAAC,EAED,EAAS,MAAM,KAAO,GAAG,EAAO,EAAE,IAClC,EAAS,MAAM,IAAM,GAAG,EAAO,EAAE,IAyBjC,IAAM,EAAiB,EAAS,MAAM,WAChC,EAAgB,EAAS,MAAM,UAErC,EAAS,MAAM,WAAa,OAC5B,EAAS,MAAM,UAAY,OAE3B,IAAM,EAAS,EAAS,sBAAsB,EACxC,EAAS,EAAO,EAAI,EAAO,KAC3B,EAAS,EAAO,EAAI,EAAO,IAEjC,EAAS,MAAM,WAAa,EAC5B,EAAS,MAAM,UAAY,GAEvB,IAAW,GAAK,IAAW,KAC7B,EAAS,MAAM,KAAO,GAAG,EAAO,EAAI,EAAO,IAC3C,EAAS,MAAM,IAAM,GAAG,EAAO,EAAI,EAAO,KAGxC,IACF,EAAS,MAAM,MAAQ,GAAG,EAAI,sBAAsB,CAAC,CAAC,MAAM,IAEhE,CAEA,SAAS,GAA8B,CACrC,IAAM,EAAM,EAAa,EACnB,EAAW,EAAY,EAI7B,MAFI,CAAC,GAAO,CAAC,MAAuB,CAAC,GAErC,EAAO,EAAA,WAAA,CAAW,EAAK,EAAU,CAAc,CACjD,CAEA,MAAO,CAAE,SAAU,EAAa,UAAW,EAAc,kBAAiB,OAAQ,CAAe,CACnG"}

package/dist/core/positioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioner.d.ts","sourceRoot":"","sources":["../../src/core/positioner.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,IAAI,EAGV,MAAM,iBAAiB,CAAC;AAMzB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,MAAM,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAIF,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,KAAK,GAAG,KAAK,CAAC;IAC7B,wDAAwD;IACxD,WAAW,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACtC,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,SAAS,CAAC;IAC/B,kDAAkD;IAClD,YAAY,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACvC,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAWF;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,MAAM,EACN,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAiB,EACjB,QAAY,EACZ,OAAW,GACZ,EAAE,yBAAyB,GAAG,iBAAiB,CA6F/C"}

package/dist/{headless → core}/positioner.js

@@ -1,6 +1,6 @@
 import { elementDirection as e } from "./direction.js";
 import { autoUpdate as t, computePosition as n, flip as r, getClippingAncestorRect as i, offset as a, shift as o, size as s } from "@vielzeug/orbit";
-//#region src/headless/positioner.ts
+//#region src/core/positioner.ts
 var c = (e) => e.endsWith("-start") ? e.replace("-start", "-end") : e.endsWith("-end") ? e.replace("-end", "-start") : e;
 function l({ boundary: l, getDir: u, getFloating: d, getPlacement: f, getReference: p, matchWidth: m = !0, offsetPx: h = 0, padding: g = 6 }) {
 	function _() {
@@ -10,8 +10,8 @@ function l({ boundary: l, getDir: u, getFloating: d, getPlacement: f, getReferen
 	function v() {
 		let e = p(), t = d();
 		if (!e || !t) return;
-		let c = _(), u = n(e, t, {
-			boundary: l ?? i(t),
+		let c = _(), u = l ?? i(t), f = n(e, t, {
+			boundary: u,
 			middleware: [
 				...h ? [a(h)] : [],
 				r({ padding: g }),
@@ -20,11 +20,11 @@ function l({ boundary: l, getDir: u, getFloating: d, getPlacement: f, getReferen
 			],
 			placement: c
 		});
-		t.style.left = `${u.x}px`, t.style.top = `${u.y}px`;
-		let f = t.style.transition, v = t.style.transform;
+		t.style.left = `${f.x}px`, t.style.top = `${f.y}px`;
+		let v = t.style.transition, y = t.style.transform;
 		t.style.transition = "none", t.style.transform = "none";
-		let y = t.getBoundingClientRect(), b = u.x - y.left, x = u.y - y.top;
-		t.style.transition = f, t.style.transform = v, (b !== 0 || x !== 0) && (t.style.left = `${u.x + b}px`, t.style.top = `${u.y + x}px`), m && (t.style.width = `${e.getBoundingClientRect().width}px`);
+		let b = t.getBoundingClientRect(), x = f.x - b.left, S = f.y - b.top;
+		t.style.transition = v, t.style.transform = y, (x !== 0 || S !== 0) && (t.style.left = `${f.x + x}px`, t.style.top = `${f.y + S}px`), m && (t.style.width = `${e.getBoundingClientRect().width}px`);
 	}
 	function y() {
 		let e = p(), n = d();

package/dist/core/positioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioner.js","names":[],"sources":["../../src/core/positioner.ts"],"sourcesContent":["import {\n  autoUpdate,\n  computePosition,\n  flip,\n  getClippingAncestorRect,\n  offset,\n  type Placement,\n  type Rect,\n  shift,\n  size,\n} from '@vielzeug/orbit';\n\nimport { elementDirection } from './direction';\n\n// ── Overlay positioner contract ──────────────────────────────────────────────\n\nexport type OverlayPositioner = {\n  floating: () => HTMLElement | null;\n  reference: () => HTMLElement | null;\n  /** Start continuous position auto-updates. Returns a stop function. */\n  startAutoUpdate?: () => () => void;\n  update: () => void;\n};\n\n// ── Dropdown positioner ───────────────────────────────────────────────────────\n\nexport type DropdownPositionerOptions = {\n  /**\n   * Clipping boundary for flip/shift/size — the edges the dropdown must stay within.\n   * Defaults to the nearest ancestor that actually clips content (`overflow:\n   * hidden|auto|scroll|clip`, e.g. a dialog panel), auto-detected per update via\n   * `getClippingAncestorRect()`, intersected with the viewport. Without this, flip/shift only\n   * avoid the full page viewport — a dropdown can be \"in view\" by that measure while still\n   * visibly overhanging a much smaller container it's actually nested in. Pass an explicit\n   * boundary to override auto-detection.\n   */\n  boundary?: Element | Rect;\n  /**\n   * Returns the text direction used for placement mirroring. Defaults to the resolved\n   * direction of the reference element (nearest `dir=\"ltr\"|\"rtl\"` ancestor, falling back to\n   * computed style) — most callers never need to pass this explicitly.\n   */\n  getDir?: () => 'ltr' | 'rtl';\n  /** Getter for the floating (dropdown panel) element. */\n  getFloating: () => HTMLElement | null;\n  /** Getter for the current placement. Defaults to 'bottom-start' (RTL-aware: flips to 'bottom-end'). */\n  getPlacement?: () => Placement;\n  /** Getter for the reference (trigger) element. */\n  getReference: () => HTMLElement | null;\n  /** Whether to match the floating element width to the reference. Default: true */\n  matchWidth?: boolean;\n  /** Additional offset in pixels between reference and floating element. Default: 0 */\n  offsetPx?: number;\n  /** Padding (px) used by flip, shift, and size middleware. Default: 6 */\n  padding?: number;\n};\n\n/** Mirrors a start/end placement for RTL layouts. */\nconst rtlPlacement = (p: Placement): Placement => {\n  if (p.endsWith('-start')) return p.replace('-start', '-end') as Placement;\n\n  if (p.endsWith('-end')) return p.replace('-end', '-start') as Placement;\n\n  return p;\n};\n\n/**\n * Creates an Orbit-powered positioner for dropdown overlays (select, combobox, menu).\n *\n * Uses flip + shift + optional width-matching middleware. Supports continuous\n * auto-update for repositioning on scroll or resize.\n *\n * RTL-aware: start/end placements are automatically mirrored so dropdowns open on the\n * correct side, based on `getDir` (or the reference element's resolved direction when\n * `getDir` is omitted).\n */\nexport function createDropdownPositioner({\n  boundary,\n  getDir,\n  getFloating,\n  getPlacement,\n  getReference,\n  matchWidth = true,\n  offsetPx = 0,\n  padding = 6,\n}: DropdownPositionerOptions): OverlayPositioner {\n  function resolvedPlacement(): Placement {\n    const base = getPlacement?.() ?? 'bottom-start';\n    const dir = getDir?.() ?? elementDirection(getReference());\n\n    return dir === 'rtl' ? rtlPlacement(base) : base;\n  }\n\n  function updatePosition(): void {\n    const ref = getReference();\n    const floating = getFloating();\n\n    if (!ref || !floating) return;\n\n    const placement = resolvedPlacement();\n    // Defaults to `undefined` (meaning \"auto-detect\"), not the detected value itself —\n    // re-running the detection on every update (rather than once, at positioner-creation time)\n    // matters because the dialog/scroll-container an instance is rendered into can change\n    // across opens (e.g. the same `<ore-select>` reused in different dialogs), and the detected\n    // ancestor's own rect can change between opens even when it's the same element (a resized\n    // dialog).\n    const resolvedBoundary = boundary ?? getClippingAncestorRect(floating);\n\n    const result = computePosition(ref, floating, {\n      boundary: resolvedBoundary,\n      middleware: [\n        ...(offsetPx ? [offset(offsetPx)] : []),\n        flip({ padding }),\n        shift({ padding }),\n        ...(matchWidth ? [size({ padding })] : []),\n      ],\n      placement,\n    });\n\n    floating.style.left = `${result.x}px`;\n    floating.style.top = `${result.y}px`;\n\n    // `computePosition()` assumes `left`/`top` resolve relative to the viewport (correct for\n    // `position: fixed`) — true almost always, but not when some ancestor establishes a\n    // containing block for fixed descendants (a non-`none` `transform`, even a visually-identity\n    // one left over from an entrance transition that never resets to `none` at rest is a real,\n    // easy-to-hit case — a modal dialog's panel, say). Analytically detecting *that* ancestor via\n    // `getContainingBlock()` and pre-subtracting its rect turned out to be unreliable in\n    // practice: browsers don't apply the \"ancestor transform traps fixed descendants\" rule\n    // uniformly across every element nested under it in every case we tested — some floating\n    // elements in the exact same subtree needed the correction and some didn't, for reasons we\n    // couldn't fully pin down. Measuring what actually happened after writing `left`/`top`\n    // and correcting only the observed gap sidesteps that: it's a no-op when the browser already\n    // put the element where asked, and it fixes the same class of bug the moment there's a real\n    // mismatch, regardless of which specific ancestor (if any) turns out to be responsible.\n    //\n    // The measurement itself must not be fooled by the floating element's *own* transform,\n    // though: dropdowns/popovers here all use a `transform: translateY(...)` entrance transition\n    // driven by a `[data-open]` attribute + `@starting-style` — right at open, before the\n    // transition has visibly progressed, `getBoundingClientRect()` can still reflect that\n    // starting offset (a handful of px, matching `--overlay-enter-translate-y`), which this\n    // correction would otherwise misread as a permanent ancestor-driven mismatch and bake in\n    // forever. Temporarily neutralizing the floating element's own transform for the measurement\n    // (and restoring it before anything paints, so there's no visible flash) isolates the\n    // correction to ancestor-driven offsets only, which is the only thing it's meant to fix.\n    const prevTransition = floating.style.transition;\n    const prevTransform = floating.style.transform;\n\n    floating.style.transition = 'none';\n    floating.style.transform = 'none';\n\n    const actual = floating.getBoundingClientRect();\n    const deltaX = result.x - actual.left;\n    const deltaY = result.y - actual.top;\n\n    floating.style.transition = prevTransition;\n    floating.style.transform = prevTransform;\n\n    if (deltaX !== 0 || deltaY !== 0) {\n      floating.style.left = `${result.x + deltaX}px`;\n      floating.style.top = `${result.y + deltaY}px`;\n    }\n\n    if (matchWidth) {\n      floating.style.width = `${ref.getBoundingClientRect().width}px`;\n    }\n  }\n\n  function startAutoUpdate(): () => void {\n    const ref = getReference();\n    const floating = getFloating();\n\n    if (!ref || !floating) return () => {};\n\n    return autoUpdate(ref, floating, updatePosition);\n  }\n\n  return { floating: getFloating, reference: getReference, startAutoUpdate, update: updatePosition };\n}\n"],"mappings":";;;AA0DA,IAAM,KAAgB,MAChB,EAAE,SAAS,QAAQ,IAAU,EAAE,QAAQ,UAAU,MAAM,IAEvD,EAAE,SAAS,MAAM,IAAU,EAAE,QAAQ,QAAQ,QAAQ,IAElD;AAaT,SAAgB,EAAyB,EACvC,aACA,WACA,gBACA,iBACA,iBACA,gBAAa,IACb,cAAW,GACX,aAAU,KACqC;CAC/C,SAAS,IAA+B;EACtC,IAAM,IAAO,IAAe,KAAK;EAGjC,QAFY,IAAS,KAAK,EAAiB,EAAa,CAAC,OAE1C,QAAQ,EAAa,CAAI,IAAI;CAC9C;CAEA,SAAS,IAAuB;EAC9B,IAAM,IAAM,EAAa,GACnB,IAAW,EAAY;EAE7B,IAAI,CAAC,KAAO,CAAC,GAAU;EAEvB,IAAM,IAAY,EAAkB,GAO9B,IAAmB,KAAY,EAAwB,CAAQ,GAE/D,IAAS,EAAgB,GAAK,GAAU;GAC5C,UAAU;GACV,YAAY;IACV,GAAI,IAAW,CAAC,EAAO,CAAQ,CAAC,IAAI,CAAC;IACrC,EAAK,EAAE,WAAQ,CAAC;IAChB,EAAM,EAAE,WAAQ,CAAC;IACjB,GAAI,IAAa,CAAC,EAAK,EAAE,WAAQ,CAAC,CAAC,IAAI,CAAC;GAC1C;GACA;EACF,CAAC;EAGD,AADA,EAAS,MAAM,OAAO,GAAG,EAAO,EAAE,KAClC,EAAS,MAAM,MAAM,GAAG,EAAO,EAAE;EAyBjC,IAAM,IAAiB,EAAS,MAAM,YAChC,IAAgB,EAAS,MAAM;EAGrC,AADA,EAAS,MAAM,aAAa,QAC5B,EAAS,MAAM,YAAY;EAE3B,IAAM,IAAS,EAAS,sBAAsB,GACxC,IAAS,EAAO,IAAI,EAAO,MAC3B,IAAS,EAAO,IAAI,EAAO;EAUjC,AARA,EAAS,MAAM,aAAa,GAC5B,EAAS,MAAM,YAAY,IAEvB,MAAW,KAAK,MAAW,OAC7B,EAAS,MAAM,OAAO,GAAG,EAAO,IAAI,EAAO,KAC3C,EAAS,MAAM,MAAM,GAAG,EAAO,IAAI,EAAO,MAGxC,MACF,EAAS,MAAM,QAAQ,GAAG,EAAI,sBAAsB,CAAC,CAAC,MAAM;CAEhE;CAEA,SAAS,IAA8B;EACrC,IAAM,IAAM,EAAa,GACnB,IAAW,EAAY;EAI7B,OAFI,CAAC,KAAO,CAAC,UAAuB,CAAC,IAE9B,EAAW,GAAK,GAAU,CAAc;CACjD;CAEA,OAAO;EAAE,UAAU;EAAa,WAAW;EAAc;EAAiB,QAAQ;CAAe;AACnG"}

package/dist/core/ref-callback.cjs

@@ -0,0 +1,2 @@
+let e=require("@vielzeug/ripple/watch");var t=(t,n)=>{t.value?.(n);let r=(0,e.watch)(t,e=>e?.(n));return()=>{r.dispose(),t.value?.(null)}};exports.bindRefCallback=t;
+//# sourceMappingURL=ref-callback.cjs.map

package/dist/core/ref-callback.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-callback.cjs","names":[],"sources":["../../src/core/ref-callback.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { watch } from '@vielzeug/ripple/watch';\n\n/** Shape every `ref` prop in this package uses — a JS-only escape hatch to the live element. */\nexport type RefCallback<T> = ((el: T | null) => void) | null | undefined;\n\n/**\n * Forwards a mounted element to a JS-only `ref` callback prop, and keeps forwarding to a\n * *new* callback if the prop is set again after mount (e.g. a parent sets it via a ref\n * callback after render, rather than at initial mount). Every text-entry-style component\n * with a `ref` escape-hatch prop (`ore-input`, `ore-textarea`, `ore-message-composer`,\n * `ore-file-input`) wires this identically — call it once from inside `onElement()`, alongside\n * whatever else that element needs wired.\n *\n * @example\n * ```ts\n * onElement(fieldRef, (el) => {\n *   const unwireField = tf.wire(el);\n *   const unwireRef = bindRefCallback(props.ref, el);\n *\n *   return () => {\n *     unwireField();\n *     unwireRef();\n *   };\n * });\n * ```\n */\nexport const bindRefCallback = <T extends Element>(ref: Readable<RefCallback<T>>, el: T): (() => void) => {\n  // Immediate fire for when the prop is already set on mount.\n  ref.value?.(el);\n\n  const sub = watch(ref, (cb) => cb?.(el));\n\n  return () => {\n    sub.dispose();\n    ref.value?.(null);\n  };\n};\n"],"mappings":"wCA4BA,IAAa,GAAsC,EAA+B,IAAwB,CAExG,EAAI,QAAQ,CAAE,EAEd,IAAM,GAAA,EAAM,EAAA,MAAA,CAAM,EAAM,GAAO,IAAK,CAAE,CAAC,EAEvC,UAAa,CACX,EAAI,QAAQ,EACZ,EAAI,QAAQ,IAAI,CAClB,CACF"}

package/dist/core/ref-callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-callback.d.ts","sourceRoot":"","sources":["../../src/core/ref-callback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,gGAAgG;AAChG,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,OAAO,EAAE,KAAK,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAG,CAAC,MAAM,IAAI,CAUpG,CAAC"}

package/dist/{headless → core}/ref-callback.js

@@ -1,5 +1,5 @@
-import { watch as e } from "@vielzeug/ripple";
-//#region src/headless/ref-callback.ts
+import { watch as e } from "@vielzeug/ripple/watch";
+//#region src/core/ref-callback.ts
 var t = (t, n) => {
 	t.value?.(n);
 	let r = e(t, (e) => e?.(n));

package/dist/core/ref-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-callback.js","names":[],"sources":["../../src/core/ref-callback.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { watch } from '@vielzeug/ripple/watch';\n\n/** Shape every `ref` prop in this package uses — a JS-only escape hatch to the live element. */\nexport type RefCallback<T> = ((el: T | null) => void) | null | undefined;\n\n/**\n * Forwards a mounted element to a JS-only `ref` callback prop, and keeps forwarding to a\n * *new* callback if the prop is set again after mount (e.g. a parent sets it via a ref\n * callback after render, rather than at initial mount). Every text-entry-style component\n * with a `ref` escape-hatch prop (`ore-input`, `ore-textarea`, `ore-message-composer`,\n * `ore-file-input`) wires this identically — call it once from inside `onElement()`, alongside\n * whatever else that element needs wired.\n *\n * @example\n * ```ts\n * onElement(fieldRef, (el) => {\n *   const unwireField = tf.wire(el);\n *   const unwireRef = bindRefCallback(props.ref, el);\n *\n *   return () => {\n *     unwireField();\n *     unwireRef();\n *   };\n * });\n * ```\n */\nexport const bindRefCallback = <T extends Element>(ref: Readable<RefCallback<T>>, el: T): (() => void) => {\n  // Immediate fire for when the prop is already set on mount.\n  ref.value?.(el);\n\n  const sub = watch(ref, (cb) => cb?.(el));\n\n  return () => {\n    sub.dispose();\n    ref.value?.(null);\n  };\n};\n"],"mappings":";;AA4BA,IAAa,KAAsC,GAA+B,MAAwB;CAExG,EAAI,QAAQ,CAAE;CAEd,IAAM,IAAM,EAAM,IAAM,MAAO,IAAK,CAAE,CAAC;CAEvC,aAAa;EAEX,AADA,EAAI,QAAQ,GACZ,EAAI,QAAQ,IAAI;CAClB;AACF"}

package/dist/core/signals.cjs

@@ -0,0 +1,2 @@
+let e=require("@vielzeug/ripple"),t=require("@vielzeug/ripple/watch");var n=(n,r,i=e=>e)=>{let a=(0,e.signal)((0,e.untrack)(()=>i(n.value))),o=(0,t.watch)(n,e=>{a.value=i(e)});return r&&r.addEventListener(`abort`,()=>o.dispose(),{once:!0}),a};exports.syncedSignal=n;
+//# sourceMappingURL=signals.cjs.map

package/dist/core/signals.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.cjs","names":[],"sources":["../../src/core/signals.ts"],"sourcesContent":["import { type Readable, signal, type Signal, untrack } from '@vielzeug/ripple';\nimport { watch } from '@vielzeug/ripple/watch';\n\n// ── syncedSignal ──────────────────────────────────────────────────────────────\n\n/**\n * Creates a local writable `Signal<T>` that stays in sync with an external\n * `Reactive<T>`. When `abortSignal` is provided the watcher subscription\n * is disposed automatically on abort; otherwise the caller is responsible for\n * disposal.\n *\n * Initialised synchronously via `untrack` so the first render never reads a\n * stale value. The optional `transform` coerces each incoming value (e.g.\n * `Boolean`, `String`).\n *\n * @example\n * ```ts\n * const value = syncedSignal(options.value, options.signal, (v) => String(v ?? ''));\n * // Without lifecycle signal (test / non-component context):\n * const value = syncedSignal(source);\n * ```\n */\nexport const syncedSignal = <TIn, TOut = TIn>(\n  source: Readable<TIn>,\n  abortSignal?: AbortSignal,\n  transform: (value: TIn) => TOut = (v) => v as unknown as TOut,\n): Signal<TOut> => {\n  const local = signal<TOut>(untrack(() => transform(source.value)));\n  const sub = watch(source, (v) => {\n    local.value = transform(v);\n  });\n\n  if (abortSignal) {\n    abortSignal.addEventListener('abort', () => sub.dispose(), { once: true });\n  }\n\n  return local;\n};\n"],"mappings":"sEAsBA,IAAa,GACX,EACA,EACA,EAAmC,GAAM,IACxB,CACjB,IAAM,GAAA,EAAQ,EAAA,OAAA,EAAA,EAAa,EAAA,QAAA,KAAc,EAAU,EAAO,KAAK,CAAC,CAAC,EAC3D,GAAA,EAAM,EAAA,MAAA,CAAM,EAAS,GAAM,CAC/B,EAAM,MAAQ,EAAU,CAAC,CAC3B,CAAC,EAMD,OAJI,GACF,EAAY,iBAAiB,YAAe,EAAI,QAAQ,EAAG,CAAE,KAAM,EAAK,CAAC,EAGpE,CACT"}

package/dist/core/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/core/signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAU,KAAK,MAAM,EAAW,MAAM,kBAAkB,CAAC;AAK/E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,EAAE,IAAI,GAAG,GAAG,EAC1C,QAAQ,QAAQ,CAAC,GAAG,CAAC,EACrB,cAAc,WAAW,EACzB,YAAW,CAAC,KAAK,EAAE,GAAG,KAAK,IAAkC,KAC5D,MAAM,CAAC,IAAI,CAWb,CAAC"}

package/dist/{headless → core}/signals.js

@@ -1,5 +1,6 @@
-import { signal as e, untrack as t, watch as n } from "@vielzeug/ripple";
-//#region src/headless/signals.ts
+import { signal as e, untrack as t } from "@vielzeug/ripple";
+import { watch as n } from "@vielzeug/ripple/watch";
+//#region src/core/signals.ts
 var r = (r, i, a = (e) => e) => {
 	let o = e(t(() => a(r.value))), s = n(r, (e) => {
 		o.value = a(e);

package/dist/core/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","names":[],"sources":["../../src/core/signals.ts"],"sourcesContent":["import { type Readable, signal, type Signal, untrack } from '@vielzeug/ripple';\nimport { watch } from '@vielzeug/ripple/watch';\n\n// ── syncedSignal ──────────────────────────────────────────────────────────────\n\n/**\n * Creates a local writable `Signal<T>` that stays in sync with an external\n * `Reactive<T>`. When `abortSignal` is provided the watcher subscription\n * is disposed automatically on abort; otherwise the caller is responsible for\n * disposal.\n *\n * Initialised synchronously via `untrack` so the first render never reads a\n * stale value. The optional `transform` coerces each incoming value (e.g.\n * `Boolean`, `String`).\n *\n * @example\n * ```ts\n * const value = syncedSignal(options.value, options.signal, (v) => String(v ?? ''));\n * // Without lifecycle signal (test / non-component context):\n * const value = syncedSignal(source);\n * ```\n */\nexport const syncedSignal = <TIn, TOut = TIn>(\n  source: Readable<TIn>,\n  abortSignal?: AbortSignal,\n  transform: (value: TIn) => TOut = (v) => v as unknown as TOut,\n): Signal<TOut> => {\n  const local = signal<TOut>(untrack(() => transform(source.value)));\n  const sub = watch(source, (v) => {\n    local.value = transform(v);\n  });\n\n  if (abortSignal) {\n    abortSignal.addEventListener('abort', () => sub.dispose(), { once: true });\n  }\n\n  return local;\n};\n"],"mappings":";;;AAsBA,IAAa,KACX,GACA,GACA,KAAmC,MAAM,MACxB;CACjB,IAAM,IAAQ,EAAa,QAAc,EAAU,EAAO,KAAK,CAAC,CAAC,GAC3D,IAAM,EAAM,IAAS,MAAM;EAC/B,EAAM,QAAQ,EAAU,CAAC;CAC3B,CAAC;CAMD,OAJI,KACF,EAAY,iBAAiB,eAAe,EAAI,QAAQ,GAAG,EAAE,MAAM,GAAK,CAAC,GAGpE;AACT"}

package/dist/core/slider.cjs

@@ -0,0 +1,2 @@
+const e=require("./numbers.cjs");let t=require("@vielzeug/arsenal/math");var n=n=>{let r=()=>e.toFiniteNumberOr(n.min?.value,0),i=()=>e.toFiniteNumberOr(n.max?.value,100),a=()=>e.toPositiveStep(n.step?.value,1),o=n=>{let a=r(),o=i();return(0,t.clamp)(e.toFiniteNumberOr(n,a),a,o)},s=t=>{let n=r();return o(Math.round(e.toFiniteNumberOr(t,n)/a())*a())},c=t=>{let n=r(),a=i(),o=e.toFiniteNumberOr(t,n);return a<=n?0:(o-n)/(a-n)*100},l=(e,t)=>{if(t.width<=0)return s(r());let n=Math.max(0,Math.min(1,(e-t.left)/t.width)),a=r(),o=i();return s(a+n*(o-a))},u=(t,n)=>{let s=e.toFiniteNumberOr(n,r());return t===`ArrowRight`||t===`ArrowUp`?o(s+a()):t===`ArrowLeft`||t===`ArrowDown`?o(s-a()):t===`Home`?r():t===`End`?i():null};return{clamp:o,fromClientX:l,handleKeydown:(e,t,r)=>{if(n.disabled?.value||n.readonly?.value)return!1;let i=u(e.key,t);return i!==null&&(e.preventDefault(),r(i),!0)},max:i,min:r,nextFromKey:u,snap:s,toPercent:c}};exports.createSliderControl=n;
+//# sourceMappingURL=slider.cjs.map

package/dist/core/slider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider.cjs","names":[],"sources":["../../src/core/slider.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { clamp as clampRange } from '@vielzeug/arsenal/math';\n\nimport { toFiniteNumberOr, toPositiveStep } from './numbers';\n\n// ── Slider control ────────────────────────────────────────────────────────────\n\nexport type SliderControlOptions = {\n  disabled?: Readable<boolean | undefined>;\n  max?: Readable<number | string | undefined>;\n  min?: Readable<number | string | undefined>;\n  readonly?: Readable<boolean | undefined>;\n  step?: Readable<number | string | undefined>;\n};\n\nexport type SliderControl = {\n  clamp: (value: number) => number;\n  fromClientX: (clientX: number, rect: { left: number; width: number }) => number;\n  /**\n   * Handles keyboard navigation for a slider input.\n   * When the slider is disabled or readonly, the event is ignored and `false` is returned.\n   * @returns `true` when the event was handled and `onCommit` was called, `false` otherwise.\n   */\n  handleKeydown: (event: KeyboardEvent, currentValue: number, onCommit: (value: number) => void) => boolean;\n  max: () => number;\n  min: () => number;\n  nextFromKey: (key: string, current: number) => number | null;\n  snap: (value: number) => number;\n  toPercent: (value: number) => number;\n};\n\nexport const createSliderControl = (options: SliderControlOptions): SliderControl => {\n  const min = (): number => toFiniteNumberOr(options.min?.value, 0);\n  const max = (): number => toFiniteNumberOr(options.max?.value, 100);\n  const step = (): number => toPositiveStep(options.step?.value, 1);\n\n  const clamp = (value: number): number => {\n    const minValue = min();\n    const maxValue = max();\n\n    return clampRange(toFiniteNumberOr(value, minValue), minValue, maxValue);\n  };\n\n  const snap = (value: number): number => {\n    const minValue = min();\n\n    return clamp(Math.round(toFiniteNumberOr(value, minValue) / step()) * step());\n  };\n\n  const toPercent = (value: number): number => {\n    const minValue = min();\n    const maxValue = max();\n    const normalized = toFiniteNumberOr(value, minValue);\n\n    if (maxValue <= minValue) return 0;\n\n    return ((normalized - minValue) / (maxValue - minValue)) * 100;\n  };\n\n  const fromClientX = (clientX: number, rect: { left: number; width: number }): number => {\n    if (rect.width <= 0) return snap(min());\n\n    const pct = Math.max(0, Math.min(1, (clientX - rect.left) / rect.width));\n    const minValue = min();\n    const maxValue = max();\n\n    return snap(minValue + pct * (maxValue - minValue));\n  };\n\n  const nextFromKey = (key: string, current: number): number | null => {\n    const normalized = toFiniteNumberOr(current, min());\n\n    if (key === 'ArrowRight' || key === 'ArrowUp') return clamp(normalized + step());\n\n    if (key === 'ArrowLeft' || key === 'ArrowDown') return clamp(normalized - step());\n\n    if (key === 'Home') return min();\n\n    if (key === 'End') return max();\n\n    return null;\n  };\n\n  const handleKeydown = (event: KeyboardEvent, currentValue: number, onCommit: (value: number) => void): boolean => {\n    if (options.disabled?.value || options.readonly?.value) return false;\n\n    const next = nextFromKey(event.key, currentValue);\n\n    if (next === null) return false;\n\n    event.preventDefault();\n    onCommit(next);\n\n    return true;\n  };\n\n  return { clamp, fromClientX, handleKeydown, max, min, nextFromKey, snap, toPercent };\n};\n"],"mappings":"yEAgCA,IAAa,EAAuB,GAAiD,CACnF,IAAM,MAAoB,EAAA,iBAAiB,EAAQ,KAAK,MAAO,CAAC,EAC1D,MAAoB,EAAA,iBAAiB,EAAQ,KAAK,MAAO,GAAG,EAC5D,MAAqB,EAAA,eAAe,EAAQ,MAAM,MAAO,CAAC,EAE1D,EAAS,GAA0B,CACvC,IAAM,EAAW,EAAI,EACf,EAAW,EAAI,EAErB,OAAA,EAAO,EAAA,MAAA,CAAW,EAAA,iBAAiB,EAAO,CAAQ,EAAG,EAAU,CAAQ,CACzE,EAEM,EAAQ,GAA0B,CACtC,IAAM,EAAW,EAAI,EAErB,OAAO,EAAM,KAAK,MAAM,EAAA,iBAAiB,EAAO,CAAQ,EAAI,EAAK,CAAC,EAAI,EAAK,CAAC,CAC9E,EAEM,EAAa,GAA0B,CAC3C,IAAM,EAAW,EAAI,EACf,EAAW,EAAI,EACf,EAAa,EAAA,iBAAiB,EAAO,CAAQ,EAInD,OAFI,GAAY,EAAiB,GAExB,EAAa,IAAa,EAAW,GAAa,GAC7D,EAEM,GAAe,EAAiB,IAAkD,CACtF,GAAI,EAAK,OAAS,EAAG,OAAO,EAAK,EAAI,CAAC,EAEtC,IAAM,EAAM,KAAK,IAAI,EAAG,KAAK,IAAI,GAAI,EAAU,EAAK,MAAQ,EAAK,KAAK,CAAC,EACjE,EAAW,EAAI,EACf,EAAW,EAAI,EAErB,OAAO,EAAK,EAAW,GAAO,EAAW,EAAS,CACpD,EAEM,GAAe,EAAa,IAAmC,CACnE,IAAM,EAAa,EAAA,iBAAiB,EAAS,EAAI,CAAC,EAUlD,OARI,IAAQ,cAAgB,IAAQ,UAAkB,EAAM,EAAa,EAAK,CAAC,EAE3E,IAAQ,aAAe,IAAQ,YAAoB,EAAM,EAAa,EAAK,CAAC,EAE5E,IAAQ,OAAe,EAAI,EAE3B,IAAQ,MAAc,EAAI,EAEvB,IACT,EAeA,MAAO,CAAE,QAAO,cAAa,eAbN,EAAsB,EAAsB,IAA+C,CAChH,GAAI,EAAQ,UAAU,OAAS,EAAQ,UAAU,MAAO,MAAO,GAE/D,IAAM,EAAO,EAAY,EAAM,IAAK,CAAY,EAOhD,OALI,IAAS,OAEb,EAAM,eAAe,EACrB,EAAS,CAAI,EAEN,GACT,EAE4C,MAAK,MAAK,cAAa,OAAM,WAAU,CACrF"}

package/dist/core/slider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../src/core/slider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQjD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IAChF;;;;OAIG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC;IAC1G,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC7D,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,SAAS,oBAAoB,KAAG,aAkEnE,CAAC"}

package/dist/{headless → core}/slider.js

@@ -1,6 +1,6 @@
 import { toFiniteNumberOr as e, toPositiveStep as t } from "./numbers.js";
-import { clamp as n } from "@vielzeug/arsenal";
-//#region src/headless/slider.ts
+import { clamp as n } from "@vielzeug/arsenal/math";
+//#region src/core/slider.ts
 var r = (r) => {
 	let i = () => e(r.min?.value, 0), a = () => e(r.max?.value, 100), o = () => t(r.step?.value, 1), s = (t) => {
 		let r = i(), o = a();
@@ -25,7 +25,7 @@ var r = (r) => {
 		handleKeydown: (e, t, n) => {
 			if (r.disabled?.value || r.readonly?.value) return !1;
 			let i = d(e.key, t);
-			return i === null ? !1 : (e.preventDefault(), n(i), !0);
+			return i !== null && (e.preventDefault(), n(i), !0);
 		},
 		max: a,
 		min: i,

package/dist/{headless/slider.cjs.map → core/slider.js.map}

@@ -1 +1 @@
-{"version":3,"file":"slider.cjs","names":[],"sources":["../../src/headless/slider.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { clamp as clampRange } from '@vielzeug/arsenal';\n\nimport { toFiniteNumberOr, toPositiveStep } from './numbers';\n\n// ── Slider control ────────────────────────────────────────────────────────────\n\nexport type SliderControlOptions = {\n  disabled?: Readable<boolean | undefined>;\n  max?: Readable<number | string | undefined>;\n  min?: Readable<number | string | undefined>;\n  readonly?: Readable<boolean | undefined>;\n  step?: Readable<number | string | undefined>;\n};\n\nexport type SliderControl = {\n  clamp: (value: number) => number;\n  fromClientX: (clientX: number, rect: { left: number; width: number }) => number;\n  /**\n   * Handles keyboard navigation for a slider input.\n   * When the slider is disabled or readonly, the event is ignored and `false` is returned.\n   * @returns `true` when the event was handled and `onCommit` was called, `false` otherwise.\n   */\n  handleKeydown: (event: KeyboardEvent, currentValue: number, onCommit: (value: number) => void) => boolean;\n  max: () => number;\n  min: () => number;\n  nextFromKey: (key: string, current: number) => number | null;\n  snap: (value: number) => number;\n  toPercent: (value: number) => number;\n};\n\nexport const createSliderControl = (options: SliderControlOptions): SliderControl => {\n  const min = (): number => toFiniteNumberOr(options.min?.value, 0);\n  const max = (): number => toFiniteNumberOr(options.max?.value, 100);\n  const step = (): number => toPositiveStep(options.step?.value, 1);\n\n  const clamp = (value: number): number => {\n    const minValue = min();\n    const maxValue = max();\n\n    return clampRange(toFiniteNumberOr(value, minValue), minValue, maxValue);\n  };\n\n  const snap = (value: number): number => {\n    const minValue = min();\n\n    return clamp(Math.round(toFiniteNumberOr(value, minValue) / step()) * step());\n  };\n\n  const toPercent = (value: number): number => {\n    const minValue = min();\n    const maxValue = max();\n    const normalized = toFiniteNumberOr(value, minValue);\n\n    if (maxValue <= minValue) return 0;\n\n    return ((normalized - minValue) / (maxValue - minValue)) * 100;\n  };\n\n  const fromClientX = (clientX: number, rect: { left: number; width: number }): number => {\n    if (rect.width <= 0) return snap(min());\n\n    const pct = Math.max(0, Math.min(1, (clientX - rect.left) / rect.width));\n    const minValue = min();\n    const maxValue = max();\n\n    return snap(minValue + pct * (maxValue - minValue));\n  };\n\n  const nextFromKey = (key: string, current: number): number | null => {\n    const normalized = toFiniteNumberOr(current, min());\n\n    if (key === 'ArrowRight' || key === 'ArrowUp') return clamp(normalized + step());\n\n    if (key === 'ArrowLeft' || key === 'ArrowDown') return clamp(normalized - step());\n\n    if (key === 'Home') return min();\n\n    if (key === 'End') return max();\n\n    return null;\n  };\n\n  const handleKeydown = (event: KeyboardEvent, currentValue: number, onCommit: (value: number) => void): boolean => {\n    if (options.disabled?.value || options.readonly?.value) return false;\n\n    const next = nextFromKey(event.key, currentValue);\n\n    if (next === null) return false;\n\n    event.preventDefault();\n    onCommit(next);\n\n    return true;\n  };\n\n  return { clamp, fromClientX, handleKeydown, max, min, nextFromKey, snap, toPercent };\n};\n"],"mappings":"oEAgCA,IAAa,EAAuB,GAAiD,CACnF,IAAM,MAAoB,EAAA,iBAAiB,EAAQ,KAAK,MAAO,CAAC,EAC1D,MAAoB,EAAA,iBAAiB,EAAQ,KAAK,MAAO,GAAG,EAC5D,MAAqB,EAAA,eAAe,EAAQ,MAAM,MAAO,CAAC,EAE1D,EAAS,GAA0B,CACvC,IAAM,EAAW,EAAI,EACf,EAAW,EAAI,EAErB,OAAA,EAAA,EAAA,MAAA,CAAkB,EAAA,iBAAiB,EAAO,CAAQ,EAAG,EAAU,CAAQ,CACzE,EAEM,EAAQ,GAA0B,CACtC,IAAM,EAAW,EAAI,EAErB,OAAO,EAAM,KAAK,MAAM,EAAA,iBAAiB,EAAO,CAAQ,EAAI,EAAK,CAAC,EAAI,EAAK,CAAC,CAC9E,EAEM,EAAa,GAA0B,CAC3C,IAAM,EAAW,EAAI,EACf,EAAW,EAAI,EACf,EAAa,EAAA,iBAAiB,EAAO,CAAQ,EAInD,OAFI,GAAY,EAAiB,GAExB,EAAa,IAAa,EAAW,GAAa,GAC7D,EAEM,GAAe,EAAiB,IAAkD,CACtF,GAAI,EAAK,OAAS,EAAG,OAAO,EAAK,EAAI,CAAC,EAEtC,IAAM,EAAM,KAAK,IAAI,EAAG,KAAK,IAAI,GAAI,EAAU,EAAK,MAAQ,EAAK,KAAK,CAAC,EACjE,EAAW,EAAI,EACf,EAAW,EAAI,EAErB,OAAO,EAAK,EAAW,GAAO,EAAW,EAAS,CACpD,EAEM,GAAe,EAAa,IAAmC,CACnE,IAAM,EAAa,EAAA,iBAAiB,EAAS,EAAI,CAAC,EAUlD,OARI,IAAQ,cAAgB,IAAQ,UAAkB,EAAM,EAAa,EAAK,CAAC,EAE3E,IAAQ,aAAe,IAAQ,YAAoB,EAAM,EAAa,EAAK,CAAC,EAE5E,IAAQ,OAAe,EAAI,EAE3B,IAAQ,MAAc,EAAI,EAEvB,IACT,EAeA,MAAO,CAAE,QAAO,cAAa,eAbN,EAAsB,EAAsB,IAA+C,CAChH,GAAI,EAAQ,UAAU,OAAS,EAAQ,UAAU,MAAO,MAAO,GAE/D,IAAM,EAAO,EAAY,EAAM,IAAK,CAAY,EAOhD,OALI,IAAS,KAAa,IAE1B,EAAM,eAAe,EACrB,EAAS,CAAI,EAEN,GACT,EAE4C,MAAK,MAAK,cAAa,OAAM,WAAU,CACrF"}
+{"version":3,"file":"slider.js","names":[],"sources":["../../src/core/slider.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { clamp as clampRange } from '@vielzeug/arsenal/math';\n\nimport { toFiniteNumberOr, toPositiveStep } from './numbers';\n\n// ── Slider control ────────────────────────────────────────────────────────────\n\nexport type SliderControlOptions = {\n  disabled?: Readable<boolean | undefined>;\n  max?: Readable<number | string | undefined>;\n  min?: Readable<number | string | undefined>;\n  readonly?: Readable<boolean | undefined>;\n  step?: Readable<number | string | undefined>;\n};\n\nexport type SliderControl = {\n  clamp: (value: number) => number;\n  fromClientX: (clientX: number, rect: { left: number; width: number }) => number;\n  /**\n   * Handles keyboard navigation for a slider input.\n   * When the slider is disabled or readonly, the event is ignored and `false` is returned.\n   * @returns `true` when the event was handled and `onCommit` was called, `false` otherwise.\n   */\n  handleKeydown: (event: KeyboardEvent, currentValue: number, onCommit: (value: number) => void) => boolean;\n  max: () => number;\n  min: () => number;\n  nextFromKey: (key: string, current: number) => number | null;\n  snap: (value: number) => number;\n  toPercent: (value: number) => number;\n};\n\nexport const createSliderControl = (options: SliderControlOptions): SliderControl => {\n  const min = (): number => toFiniteNumberOr(options.min?.value, 0);\n  const max = (): number => toFiniteNumberOr(options.max?.value, 100);\n  const step = (): number => toPositiveStep(options.step?.value, 1);\n\n  const clamp = (value: number): number => {\n    const minValue = min();\n    const maxValue = max();\n\n    return clampRange(toFiniteNumberOr(value, minValue), minValue, maxValue);\n  };\n\n  const snap = (value: number): number => {\n    const minValue = min();\n\n    return clamp(Math.round(toFiniteNumberOr(value, minValue) / step()) * step());\n  };\n\n  const toPercent = (value: number): number => {\n    const minValue = min();\n    const maxValue = max();\n    const normalized = toFiniteNumberOr(value, minValue);\n\n    if (maxValue <= minValue) return 0;\n\n    return ((normalized - minValue) / (maxValue - minValue)) * 100;\n  };\n\n  const fromClientX = (clientX: number, rect: { left: number; width: number }): number => {\n    if (rect.width <= 0) return snap(min());\n\n    const pct = Math.max(0, Math.min(1, (clientX - rect.left) / rect.width));\n    const minValue = min();\n    const maxValue = max();\n\n    return snap(minValue + pct * (maxValue - minValue));\n  };\n\n  const nextFromKey = (key: string, current: number): number | null => {\n    const normalized = toFiniteNumberOr(current, min());\n\n    if (key === 'ArrowRight' || key === 'ArrowUp') return clamp(normalized + step());\n\n    if (key === 'ArrowLeft' || key === 'ArrowDown') return clamp(normalized - step());\n\n    if (key === 'Home') return min();\n\n    if (key === 'End') return max();\n\n    return null;\n  };\n\n  const handleKeydown = (event: KeyboardEvent, currentValue: number, onCommit: (value: number) => void): boolean => {\n    if (options.disabled?.value || options.readonly?.value) return false;\n\n    const next = nextFromKey(event.key, currentValue);\n\n    if (next === null) return false;\n\n    event.preventDefault();\n    onCommit(next);\n\n    return true;\n  };\n\n  return { clamp, fromClientX, handleKeydown, max, min, nextFromKey, snap, toPercent };\n};\n"],"mappings":";;;AAgCA,IAAa,KAAuB,MAAiD;CACnF,IAAM,UAAoB,EAAiB,EAAQ,KAAK,OAAO,CAAC,GAC1D,UAAoB,EAAiB,EAAQ,KAAK,OAAO,GAAG,GAC5D,UAAqB,EAAe,EAAQ,MAAM,OAAO,CAAC,GAE1D,KAAS,MAA0B;EACvC,IAAM,IAAW,EAAI,GACf,IAAW,EAAI;EAErB,OAAO,EAAW,EAAiB,GAAO,CAAQ,GAAG,GAAU,CAAQ;CACzE,GAEM,KAAQ,MAA0B;EACtC,IAAM,IAAW,EAAI;EAErB,OAAO,EAAM,KAAK,MAAM,EAAiB,GAAO,CAAQ,IAAI,EAAK,CAAC,IAAI,EAAK,CAAC;CAC9E,GAEM,KAAa,MAA0B;EAC3C,IAAM,IAAW,EAAI,GACf,IAAW,EAAI,GACf,IAAa,EAAiB,GAAO,CAAQ;EAInD,OAFI,KAAY,IAAiB,KAExB,IAAa,MAAa,IAAW,KAAa;CAC7D,GAEM,KAAe,GAAiB,MAAkD;EACtF,IAAI,EAAK,SAAS,GAAG,OAAO,EAAK,EAAI,CAAC;EAEtC,IAAM,IAAM,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,IAAU,EAAK,QAAQ,EAAK,KAAK,CAAC,GACjE,IAAW,EAAI,GACf,IAAW,EAAI;EAErB,OAAO,EAAK,IAAW,KAAO,IAAW,EAAS;CACpD,GAEM,KAAe,GAAa,MAAmC;EACnE,IAAM,IAAa,EAAiB,GAAS,EAAI,CAAC;EAUlD,OARI,MAAQ,gBAAgB,MAAQ,YAAkB,EAAM,IAAa,EAAK,CAAC,IAE3E,MAAQ,eAAe,MAAQ,cAAoB,EAAM,IAAa,EAAK,CAAC,IAE5E,MAAQ,SAAe,EAAI,IAE3B,MAAQ,QAAc,EAAI,IAEvB;CACT;CAeA,OAAO;EAAE,OAAA;EAAO;EAAa,gBAbN,GAAsB,GAAsB,MAA+C;GAChH,IAAI,EAAQ,UAAU,SAAS,EAAQ,UAAU,OAAO,OAAO;GAE/D,IAAM,IAAO,EAAY,EAAM,KAAK,CAAY;GAOhD,OALI,MAAS,SAEb,EAAM,eAAe,GACrB,EAAS,CAAI,GAEN;EACT;EAE4C;EAAK;EAAK;EAAa;EAAM;CAAU;AACrF"}

package/dist/core/spinner.cjs

@@ -0,0 +1,2 @@
+const e=require("./keyboard.cjs"),t=require("./numbers.cjs");let n=require("@vielzeug/arsenal/math");var r=r=>{let i=()=>!!r.disabled?.value||!!r.readonly?.value,a=()=>t.toFiniteNumber(r.min?.value),o=()=>t.toFiniteNumber(r.max?.value),s=e=>(0,n.clamp)(e,a(),o()),c=()=>t.toPositiveStep(r.step?.value,1),l=()=>{let e=c();return t.toPositiveStep(r.largeStep?.value,e*10)},u=()=>r.parse()??a()??0,d=(e,t)=>{if(e==null){r.commit(null,t);return}r.commit(s(e),t)},f=(e,t)=>{i()||d(u()+e,t)};return{atMax:()=>{let e=r.parse(),t=o();return e!=null&&t!=null&&e>=t},atMin:()=>{let e=r.parse(),t=a();return e!=null&&t!=null&&e<=t},handleKeydown:t=>!i()&&e.dispatchKeyboardAction(t,{keymap:{ArrowDown:()=>f(-c(),t),ArrowUp:()=>f(c(),t),End:()=>{let e=o();if(e==null)return!1;d(e,t)},Home:()=>{let e=a();if(e==null)return!1;d(e,t)},PageDown:()=>f(-l(),t),PageUp:()=>f(l(),t)},preventDefault:`after`}),incrementBy:f}};exports.createSpinnerControl=r;
+//# sourceMappingURL=spinner.cjs.map

package/dist/core/spinner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.cjs","names":[],"sources":["../../src/core/spinner.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { clamp as clampRange } from '@vielzeug/arsenal/math';\n\nimport { dispatchKeyboardAction } from './keyboard';\nimport { toFiniteNumber, toPositiveStep } from './numbers';\n\nexport type SpinnerControlOptions = {\n  commit: (value: number | null, originalEvent?: Event) => void;\n  disabled?: Readable<boolean | undefined>;\n  largeStep?: Readable<number | string | undefined>;\n  max?: Readable<number | string | undefined>;\n  min?: Readable<number | string | undefined>;\n  parse: () => number | null;\n  readonly?: Readable<boolean | undefined>;\n  step?: Readable<number | string | undefined>;\n};\n\nexport type SpinnerControl = {\n  atMax: () => boolean;\n  atMin: () => boolean;\n  handleKeydown: (event: KeyboardEvent) => boolean;\n  incrementBy: (delta: number, originalEvent?: Event) => void;\n};\n\nexport const createSpinnerControl = (options: SpinnerControlOptions): SpinnerControl => {\n  const isBlocked = (): boolean => Boolean(options.disabled?.value) || Boolean(options.readonly?.value);\n\n  const min = (): number | undefined => {\n    return toFiniteNumber(options.min?.value);\n  };\n\n  const max = (): number | undefined => {\n    return toFiniteNumber(options.max?.value);\n  };\n\n  const clamp = (value: number): number => {\n    return clampRange(value, min(), max());\n  };\n\n  const step = (): number => toPositiveStep(options.step?.value, 1);\n\n  const largeStep = (): number => {\n    const s = step();\n\n    return toPositiveStep(options.largeStep?.value, s * 10);\n  };\n\n  const currentOrFallback = (): number => {\n    const parsed = options.parse();\n\n    if (parsed != null) return parsed;\n\n    const minValue = min();\n\n    if (minValue != null) return minValue;\n\n    return 0;\n  };\n\n  const commit = (value: number | null, originalEvent?: Event): void => {\n    if (value == null) {\n      options.commit(null, originalEvent);\n\n      return;\n    }\n\n    options.commit(clamp(value), originalEvent);\n  };\n\n  const incrementBy = (delta: number, originalEvent?: Event): void => {\n    if (isBlocked()) return;\n\n    commit(currentOrFallback() + delta, originalEvent);\n  };\n\n  const atMin = (): boolean => {\n    const parsed = options.parse();\n    const minValue = min();\n\n    return parsed != null && minValue != null && parsed <= minValue;\n  };\n\n  const atMax = (): boolean => {\n    const parsed = options.parse();\n    const maxValue = max();\n\n    return parsed != null && maxValue != null && parsed >= maxValue;\n  };\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    if (isBlocked()) return false;\n\n    return dispatchKeyboardAction(event, {\n      keymap: {\n        ArrowDown: () => incrementBy(-step(), event),\n        ArrowUp: () => incrementBy(step(), event),\n        End: () => {\n          const maxValue = max();\n\n          if (maxValue == null) return false;\n\n          commit(maxValue, event);\n        },\n        Home: () => {\n          const minValue = min();\n\n          if (minValue == null) return false;\n\n          commit(minValue, event);\n        },\n        PageDown: () => incrementBy(-largeStep(), event),\n        PageUp: () => incrementBy(largeStep(), event),\n      },\n      preventDefault: 'after',\n    });\n  };\n\n  return {\n    atMax,\n    atMin,\n    handleKeydown,\n    incrementBy,\n  };\n};\n"],"mappings":"qGAyBA,IAAa,EAAwB,GAAmD,CACtF,IAAM,MAA2B,EAAQ,EAAQ,UAAU,OAAU,EAAQ,EAAQ,UAAU,MAEzF,MACG,EAAA,eAAe,EAAQ,KAAK,KAAK,EAGpC,MACG,EAAA,eAAe,EAAQ,KAAK,KAAK,EAGpC,EAAS,IACb,EAAO,EAAA,MAAA,CAAW,EAAO,EAAI,EAAG,EAAI,CAAC,EAGjC,MAAqB,EAAA,eAAe,EAAQ,MAAM,MAAO,CAAC,EAE1D,MAA0B,CAC9B,IAAM,EAAI,EAAK,EAEf,OAAO,EAAA,eAAe,EAAQ,WAAW,MAAO,EAAI,EAAE,CACxD,EAEM,MACW,EAAQ,MAEnB,GAEa,EAEb,GAEG,EAGH,GAAU,EAAsB,IAAgC,CACpE,GAAI,GAAS,KAAM,CACjB,EAAQ,OAAO,KAAM,CAAa,EAElC,MACF,CAEA,EAAQ,OAAO,EAAM,CAAK,EAAG,CAAa,CAC5C,EAEM,GAAe,EAAe,IAAgC,CAC9D,EAAU,GAEd,EAAO,EAAkB,EAAI,EAAO,CAAa,CACnD,EA4CA,MAAO,CACL,UApC2B,CAC3B,IAAM,EAAS,EAAQ,MAAM,EACvB,EAAW,EAAI,EAErB,OAAO,GAAU,MAAQ,GAAY,MAAQ,GAAU,CACzD,EAgCE,UA5C2B,CAC3B,IAAM,EAAS,EAAQ,MAAM,EACvB,EAAW,EAAI,EAErB,OAAO,GAAU,MAAQ,GAAY,MAAQ,GAAU,CACzD,EAwCE,cA/BqB,GACrB,CAAI,EAAU,GAEP,EAAA,uBAAuB,EAAO,CACnC,OAAQ,CACN,cAAiB,EAAY,CAAC,EAAK,EAAG,CAAK,EAC3C,YAAe,EAAY,EAAK,EAAG,CAAK,EACxC,QAAW,CACT,IAAM,EAAW,EAAI,EAErB,GAAI,GAAY,KAAM,MAAO,GAE7B,EAAO,EAAU,CAAK,CACxB,EACA,SAAY,CACV,IAAM,EAAW,EAAI,EAErB,GAAI,GAAY,KAAM,MAAO,GAE7B,EAAO,EAAU,CAAK,CACxB,EACA,aAAgB,EAAY,CAAC,EAAU,EAAG,CAAK,EAC/C,WAAc,EAAY,EAAU,EAAG,CAAK,CAC9C,EACA,eAAgB,OAClB,CAAC,EAOD,aACF,CACF"}

package/dist/core/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/core/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAOjD,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5C,KAAK,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC;IACrB,aAAa,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IACjD,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,cAmGrE,CAAC"}

package/dist/{headless → core}/spinner.js

@@ -1,7 +1,7 @@
 import { dispatchKeyboardAction as e } from "./keyboard.js";
 import { toFiniteNumber as t, toPositiveStep as n } from "./numbers.js";
-import { clamp as r } from "@vielzeug/arsenal";
-//#region src/headless/spinner.ts
+import { clamp as r } from "@vielzeug/arsenal/math";
+//#region src/core/spinner.ts
 var i = (i) => {
 	let a = () => !!i.disabled?.value || !!i.readonly?.value, o = () => t(i.min?.value), s = () => t(i.max?.value), c = (e) => r(e, o(), s()), l = () => n(i.step?.value, 1), u = () => {
 		let e = l();
@@ -24,7 +24,7 @@ var i = (i) => {
 			let e = i.parse(), t = o();
 			return e != null && t != null && e <= t;
 		},
-		handleKeydown: (t) => a() ? !1 : e(t, {
+		handleKeydown: (t) => !a() && e(t, {
 			keymap: {
 				ArrowDown: () => p(-l(), t),
 				ArrowUp: () => p(l(), t),

package/dist/{headless/spinner.cjs.map → core/spinner.js.map}

@@ -1 +1 @@
-{"version":3,"file":"spinner.cjs","names":[],"sources":["../../src/headless/spinner.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { clamp as clampRange } from '@vielzeug/arsenal';\n\nimport { dispatchKeyboardAction } from './keyboard';\nimport { toFiniteNumber, toPositiveStep } from './numbers';\n\nexport type SpinnerControlOptions = {\n  commit: (value: number | null, originalEvent?: Event) => void;\n  disabled?: Readable<boolean | undefined>;\n  largeStep?: Readable<number | string | undefined>;\n  max?: Readable<number | string | undefined>;\n  min?: Readable<number | string | undefined>;\n  parse: () => number | null;\n  readonly?: Readable<boolean | undefined>;\n  step?: Readable<number | string | undefined>;\n};\n\nexport type SpinnerControl = {\n  atMax: () => boolean;\n  atMin: () => boolean;\n  handleKeydown: (event: KeyboardEvent) => boolean;\n  incrementBy: (delta: number, originalEvent?: Event) => void;\n};\n\nexport const createSpinnerControl = (options: SpinnerControlOptions): SpinnerControl => {\n  const isBlocked = (): boolean => Boolean(options.disabled?.value) || Boolean(options.readonly?.value);\n\n  const min = (): number | undefined => {\n    return toFiniteNumber(options.min?.value);\n  };\n\n  const max = (): number | undefined => {\n    return toFiniteNumber(options.max?.value);\n  };\n\n  const clamp = (value: number): number => {\n    return clampRange(value, min(), max());\n  };\n\n  const step = (): number => toPositiveStep(options.step?.value, 1);\n\n  const largeStep = (): number => {\n    const s = step();\n\n    return toPositiveStep(options.largeStep?.value, s * 10);\n  };\n\n  const currentOrFallback = (): number => {\n    const parsed = options.parse();\n\n    if (parsed != null) return parsed;\n\n    const minValue = min();\n\n    if (minValue != null) return minValue;\n\n    return 0;\n  };\n\n  const commit = (value: number | null, originalEvent?: Event): void => {\n    if (value == null) {\n      options.commit(null, originalEvent);\n\n      return;\n    }\n\n    options.commit(clamp(value), originalEvent);\n  };\n\n  const incrementBy = (delta: number, originalEvent?: Event): void => {\n    if (isBlocked()) return;\n\n    commit(currentOrFallback() + delta, originalEvent);\n  };\n\n  const atMin = (): boolean => {\n    const parsed = options.parse();\n    const minValue = min();\n\n    return parsed != null && minValue != null && parsed <= minValue;\n  };\n\n  const atMax = (): boolean => {\n    const parsed = options.parse();\n    const maxValue = max();\n\n    return parsed != null && maxValue != null && parsed >= maxValue;\n  };\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    if (isBlocked()) return false;\n\n    return dispatchKeyboardAction(event, {\n      keymap: {\n        ArrowDown: () => incrementBy(-step(), event),\n        ArrowUp: () => incrementBy(step(), event),\n        End: () => {\n          const maxValue = max();\n\n          if (maxValue == null) return false;\n\n          commit(maxValue, event);\n        },\n        Home: () => {\n          const minValue = min();\n\n          if (minValue == null) return false;\n\n          commit(minValue, event);\n        },\n        PageDown: () => incrementBy(-largeStep(), event),\n        PageUp: () => incrementBy(largeStep(), event),\n      },\n      preventDefault: 'after',\n    });\n  };\n\n  return {\n    atMax,\n    atMin,\n    handleKeydown,\n    incrementBy,\n  };\n};\n"],"mappings":"gGAyBA,IAAa,EAAwB,GAAmD,CACtF,IAAM,MAA2B,EAAQ,EAAQ,UAAU,OAAU,EAAQ,EAAQ,UAAU,MAEzF,MACG,EAAA,eAAe,EAAQ,KAAK,KAAK,EAGpC,MACG,EAAA,eAAe,EAAQ,KAAK,KAAK,EAGpC,EAAS,IACb,EAAA,EAAA,MAAA,CAAkB,EAAO,EAAI,EAAG,EAAI,CAAC,EAGjC,MAAqB,EAAA,eAAe,EAAQ,MAAM,MAAO,CAAC,EAE1D,MAA0B,CAC9B,IAAM,EAAI,EAAK,EAEf,OAAO,EAAA,eAAe,EAAQ,WAAW,MAAO,EAAI,EAAE,CACxD,EAEM,MACW,EAAQ,MAEnB,GAEa,EAEb,GAEG,EAGH,GAAU,EAAsB,IAAgC,CACpE,GAAI,GAAS,KAAM,CACjB,EAAQ,OAAO,KAAM,CAAa,EAElC,MACF,CAEA,EAAQ,OAAO,EAAM,CAAK,EAAG,CAAa,CAC5C,EAEM,GAAe,EAAe,IAAgC,CAC9D,EAAU,GAEd,EAAO,EAAkB,EAAI,EAAO,CAAa,CACnD,EA4CA,MAAO,CACL,UApC2B,CAC3B,IAAM,EAAS,EAAQ,MAAM,EACvB,EAAW,EAAI,EAErB,OAAO,GAAU,MAAQ,GAAY,MAAQ,GAAU,CACzD,EAgCE,UA5C2B,CAC3B,IAAM,EAAS,EAAQ,MAAM,EACvB,EAAW,EAAI,EAErB,OAAO,GAAU,MAAQ,GAAY,MAAQ,GAAU,CACzD,EAwCE,cA/BqB,GACjB,EAAU,EAAU,GAEjB,EAAA,uBAAuB,EAAO,CACnC,OAAQ,CACN,cAAiB,EAAY,CAAC,EAAK,EAAG,CAAK,EAC3C,YAAe,EAAY,EAAK,EAAG,CAAK,EACxC,QAAW,CACT,IAAM,EAAW,EAAI,EAErB,GAAI,GAAY,KAAM,MAAO,GAE7B,EAAO,EAAU,CAAK,CACxB,EACA,SAAY,CACV,IAAM,EAAW,EAAI,EAErB,GAAI,GAAY,KAAM,MAAO,GAE7B,EAAO,EAAU,CAAK,CACxB,EACA,aAAgB,EAAY,CAAC,EAAU,EAAG,CAAK,EAC/C,WAAc,EAAY,EAAU,EAAG,CAAK,CAC9C,EACA,eAAgB,OAClB,CAAC,EAOD,aACF,CACF"}
+{"version":3,"file":"spinner.js","names":[],"sources":["../../src/core/spinner.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { clamp as clampRange } from '@vielzeug/arsenal/math';\n\nimport { dispatchKeyboardAction } from './keyboard';\nimport { toFiniteNumber, toPositiveStep } from './numbers';\n\nexport type SpinnerControlOptions = {\n  commit: (value: number | null, originalEvent?: Event) => void;\n  disabled?: Readable<boolean | undefined>;\n  largeStep?: Readable<number | string | undefined>;\n  max?: Readable<number | string | undefined>;\n  min?: Readable<number | string | undefined>;\n  parse: () => number | null;\n  readonly?: Readable<boolean | undefined>;\n  step?: Readable<number | string | undefined>;\n};\n\nexport type SpinnerControl = {\n  atMax: () => boolean;\n  atMin: () => boolean;\n  handleKeydown: (event: KeyboardEvent) => boolean;\n  incrementBy: (delta: number, originalEvent?: Event) => void;\n};\n\nexport const createSpinnerControl = (options: SpinnerControlOptions): SpinnerControl => {\n  const isBlocked = (): boolean => Boolean(options.disabled?.value) || Boolean(options.readonly?.value);\n\n  const min = (): number | undefined => {\n    return toFiniteNumber(options.min?.value);\n  };\n\n  const max = (): number | undefined => {\n    return toFiniteNumber(options.max?.value);\n  };\n\n  const clamp = (value: number): number => {\n    return clampRange(value, min(), max());\n  };\n\n  const step = (): number => toPositiveStep(options.step?.value, 1);\n\n  const largeStep = (): number => {\n    const s = step();\n\n    return toPositiveStep(options.largeStep?.value, s * 10);\n  };\n\n  const currentOrFallback = (): number => {\n    const parsed = options.parse();\n\n    if (parsed != null) return parsed;\n\n    const minValue = min();\n\n    if (minValue != null) return minValue;\n\n    return 0;\n  };\n\n  const commit = (value: number | null, originalEvent?: Event): void => {\n    if (value == null) {\n      options.commit(null, originalEvent);\n\n      return;\n    }\n\n    options.commit(clamp(value), originalEvent);\n  };\n\n  const incrementBy = (delta: number, originalEvent?: Event): void => {\n    if (isBlocked()) return;\n\n    commit(currentOrFallback() + delta, originalEvent);\n  };\n\n  const atMin = (): boolean => {\n    const parsed = options.parse();\n    const minValue = min();\n\n    return parsed != null && minValue != null && parsed <= minValue;\n  };\n\n  const atMax = (): boolean => {\n    const parsed = options.parse();\n    const maxValue = max();\n\n    return parsed != null && maxValue != null && parsed >= maxValue;\n  };\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    if (isBlocked()) return false;\n\n    return dispatchKeyboardAction(event, {\n      keymap: {\n        ArrowDown: () => incrementBy(-step(), event),\n        ArrowUp: () => incrementBy(step(), event),\n        End: () => {\n          const maxValue = max();\n\n          if (maxValue == null) return false;\n\n          commit(maxValue, event);\n        },\n        Home: () => {\n          const minValue = min();\n\n          if (minValue == null) return false;\n\n          commit(minValue, event);\n        },\n        PageDown: () => incrementBy(-largeStep(), event),\n        PageUp: () => incrementBy(largeStep(), event),\n      },\n      preventDefault: 'after',\n    });\n  };\n\n  return {\n    atMax,\n    atMin,\n    handleKeydown,\n    incrementBy,\n  };\n};\n"],"mappings":";;;;AAyBA,IAAa,KAAwB,MAAmD;CACtF,IAAM,UAA2B,EAAQ,EAAQ,UAAU,SAAU,EAAQ,EAAQ,UAAU,OAEzF,UACG,EAAe,EAAQ,KAAK,KAAK,GAGpC,UACG,EAAe,EAAQ,KAAK,KAAK,GAGpC,KAAS,MACN,EAAW,GAAO,EAAI,GAAG,EAAI,CAAC,GAGjC,UAAqB,EAAe,EAAQ,MAAM,OAAO,CAAC,GAE1D,UAA0B;EAC9B,IAAM,IAAI,EAAK;EAEf,OAAO,EAAe,EAAQ,WAAW,OAAO,IAAI,EAAE;CACxD,GAEM,UACW,EAAQ,MAEnB,KAEa,EAEb,KAEG,GAGH,KAAU,GAAsB,MAAgC;EACpE,IAAI,KAAS,MAAM;GACjB,EAAQ,OAAO,MAAM,CAAa;GAElC;EACF;EAEA,EAAQ,OAAO,EAAM,CAAK,GAAG,CAAa;CAC5C,GAEM,KAAe,GAAe,MAAgC;EAC9D,EAAU,KAEd,EAAO,EAAkB,IAAI,GAAO,CAAa;CACnD;CA4CA,OAAO;EACL,aApC2B;GAC3B,IAAM,IAAS,EAAQ,MAAM,GACvB,IAAW,EAAI;GAErB,OAAO,KAAU,QAAQ,KAAY,QAAQ,KAAU;EACzD;EAgCE,aA5C2B;GAC3B,IAAM,IAAS,EAAQ,MAAM,GACvB,IAAW,EAAI;GAErB,OAAO,KAAU,QAAQ,KAAY,QAAQ,KAAU;EACzD;EAwCE,gBA/BqB,MACrB,CAAI,EAAU,KAEP,EAAuB,GAAO;GACnC,QAAQ;IACN,iBAAiB,EAAY,CAAC,EAAK,GAAG,CAAK;IAC3C,eAAe,EAAY,EAAK,GAAG,CAAK;IACxC,WAAW;KACT,IAAM,IAAW,EAAI;KAErB,IAAI,KAAY,MAAM,OAAO;KAE7B,EAAO,GAAU,CAAK;IACxB;IACA,YAAY;KACV,IAAM,IAAW,EAAI;KAErB,IAAI,KAAY,MAAM,OAAO;KAE7B,EAAO,GAAU,CAAK;IACxB;IACA,gBAAgB,EAAY,CAAC,EAAU,GAAG,CAAK;IAC/C,cAAc,EAAY,EAAU,GAAG,CAAK;GAC9C;GACA,gBAAgB;EAClB,CAAC;EAOD;CACF;AACF"}

package/dist/core/swipe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"swipe.cjs","names":[],"sources":["../../src/core/swipe.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nexport type SwipeAxis = 'x' | 'y';\n\nexport type SwipeControlDetail = {\n  axis: SwipeAxis;\n  current: number;\n  distance: number;\n  event: PointerEvent;\n  pointerId: number;\n  progress: number;\n  start: number;\n  threshold: number;\n};\n\nexport type SwipeControlOptions = {\n  axis?: () => SwipeAxis;\n  captureTarget?: (event: PointerEvent) => HTMLElement | null;\n  disabled?: Readable<boolean | undefined>;\n  /** Called when the platform interrupts an in-flight swipe (`pointercancel`). */\n  onCancel?: (detail: SwipeControlDetail) => void;\n  onCommit?: (detail: SwipeControlDetail) => void;\n  onMove?: (detail: SwipeControlDetail) => void;\n  /** Called when the pointer is released (`pointerup`) without crossing the commit threshold. */\n  onRelease?: (detail: SwipeControlDetail) => void;\n  onStart?: (detail: SwipeControlDetail) => void;\n  shouldCommit?: (detail: SwipeControlDetail) => boolean;\n  threshold?: () => number;\n};\n\nexport type SwipeControl = {\n  [Symbol.dispose](): void;\n  /** Cancel any in-flight swipe and clean up internal state. */\n  dispose: () => void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  handlePointerCancel: (event: PointerEvent) => boolean;\n  handlePointerDown: (event: PointerEvent) => boolean;\n  handlePointerMove: (event: PointerEvent) => boolean;\n  handlePointerUp: (event: PointerEvent) => boolean;\n  isActive: () => boolean;\n};\n\ntype ActiveSwipe = {\n  axis: SwipeAxis;\n  pointerId: number;\n  start: number;\n  threshold: number;\n};\n\nconst resolveAxis = (options: SwipeControlOptions): SwipeAxis => options.axis?.() ?? 'x';\n\nconst resolveThreshold = (options: SwipeControlOptions): number => {\n  const threshold = options.threshold?.() ?? 48;\n\n  return Number.isFinite(threshold) && threshold > 0 ? threshold : 1;\n};\n\nconst getCoordinate = (event: PointerEvent, axis: SwipeAxis): number => {\n  return axis === 'x' ? event.clientX : event.clientY;\n};\n\nconst defaultCaptureTarget = (event: PointerEvent): HTMLElement | null => {\n  if (event.currentTarget instanceof HTMLElement) return event.currentTarget;\n\n  if (event.target instanceof HTMLElement) return event.target;\n\n  return null;\n};\n\nexport const createSwipeControl = (options: SwipeControlOptions): SwipeControl => {\n  let active: ActiveSwipe | null = null;\n  let disposed = false;\n\n  const isDisabled = (): boolean => Boolean(options.disabled?.value);\n\n  const reset = (): void => {\n    active = null;\n  };\n\n  const dispose = (): void => {\n    disposed = true;\n    reset();\n  };\n\n  const matchesPointer = (event: PointerEvent): boolean => {\n    return active?.pointerId === event.pointerId;\n  };\n\n  const createDetail = (event: PointerEvent): SwipeControlDetail | null => {\n    if (!active) return null;\n\n    const current = getCoordinate(event, active.axis);\n    const distance = current - active.start;\n\n    return {\n      axis: active.axis,\n      current,\n      distance,\n      event,\n      pointerId: active.pointerId,\n      progress: Math.min(Math.abs(distance) / active.threshold, 1),\n      start: active.start,\n      threshold: active.threshold,\n    };\n  };\n\n  const handlePointerDown = (event: PointerEvent): boolean => {\n    if (disposed || active || isDisabled()) return false;\n\n    const axis = resolveAxis(options);\n\n    active = {\n      axis,\n      pointerId: event.pointerId,\n      start: getCoordinate(event, axis),\n      threshold: resolveThreshold(options),\n    };\n\n    const captureTarget =\n      typeof options.captureTarget === 'function' ? options.captureTarget(event) : defaultCaptureTarget(event);\n\n    captureTarget?.setPointerCapture?.(event.pointerId);\n\n    const detail = createDetail(event);\n\n    if (detail) options.onStart?.(detail);\n\n    return true;\n  };\n\n  const handlePointerMove = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    if (!detail) return false;\n\n    options.onMove?.(detail);\n\n    const shouldCommit = options.shouldCommit?.(detail) ?? Math.abs(detail.distance) >= detail.threshold;\n\n    if (!shouldCommit) return true;\n\n    reset();\n    options.onCommit?.(detail);\n\n    return true;\n  };\n\n  const handlePointerUp = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    reset();\n\n    if (detail) options.onRelease?.(detail);\n\n    return true;\n  };\n\n  const handlePointerCancel = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    reset();\n\n    if (detail) options.onCancel?.(detail);\n\n    return true;\n  };\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    handlePointerCancel,\n    handlePointerDown,\n    handlePointerMove,\n    handlePointerUp,\n    isActive: () => active != null,\n    [Symbol.dispose]: dispose,\n  };\n};\n"],"mappings":"AAkDA,IAAM,EAAe,GAA4C,EAAQ,OAAO,GAAK,IAE/E,EAAoB,GAAyC,CACjE,IAAM,EAAY,EAAQ,YAAY,GAAK,GAE3C,OAAO,OAAO,SAAS,CAAS,GAAK,EAAY,EAAI,EAAY,CACnE,EAEM,GAAiB,EAAqB,IACnC,IAAS,IAAM,EAAM,QAAU,EAAM,QAGxC,EAAwB,GACxB,EAAM,yBAAyB,YAAoB,EAAM,cAEzD,EAAM,kBAAkB,YAAoB,EAAM,OAE/C,KAGI,EAAsB,GAA+C,CAChF,IAAI,EAA6B,KAC7B,EAAW,GAET,MAA4B,EAAQ,EAAQ,UAAU,MAEtD,MAAoB,CACxB,EAAS,IACX,EAEM,MAAsB,CAC1B,EAAW,GACX,EAAM,CACR,EAEM,EAAkB,GACf,GAAQ,YAAc,EAAM,UAG/B,EAAgB,GAAmD,CACvE,GAAI,CAAC,EAAQ,OAAO,KAEpB,IAAM,EAAU,EAAc,EAAO,EAAO,IAAI,EAC1C,EAAW,EAAU,EAAO,MAElC,MAAO,CACL,KAAM,EAAO,KACb,UACA,WACA,QACA,UAAW,EAAO,UAClB,SAAU,KAAK,IAAI,KAAK,IAAI,CAAQ,EAAI,EAAO,UAAW,CAAC,EAC3D,MAAO,EAAO,MACd,UAAW,EAAO,SACpB,CACF,EAqEA,MAAO,CACL,UACA,IAAI,UAAW,CACb,OAAO,CACT,EACA,oBAjB2B,GAAiC,CAC5D,GAAI,CAAC,GAAU,CAAC,EAAe,CAAK,EAAG,MAAO,GAE9C,IAAM,EAAS,EAAa,CAAK,EAMjC,OAJA,EAAM,EAEF,GAAQ,EAAQ,WAAW,CAAM,EAE9B,EACT,EAQE,kBAzEyB,GAAiC,CAC1D,GAAI,GAAY,GAAU,EAAW,EAAG,MAAO,GAE/C,IAAM,EAAO,EAAY,CAAO,EAEhC,EAAS,CACP,OACA,UAAW,EAAM,UACjB,MAAO,EAAc,EAAO,CAAI,EAChC,UAAW,EAAiB,CAAO,CACrC,GAGE,OAAO,EAAQ,eAAkB,WAAa,EAAQ,cAAc,CAAK,EAAI,EAAqB,CAAK,EAAA,EAE1F,oBAAoB,EAAM,SAAS,EAElD,IAAM,EAAS,EAAa,CAAK,EAIjC,OAFI,GAAQ,EAAQ,UAAU,CAAM,EAE7B,EACT,EAoDE,kBAlDyB,GAAiC,CAC1D,GAAI,CAAC,GAAU,CAAC,EAAe,CAAK,EAAG,MAAO,GAE9C,IAAM,EAAS,EAAa,CAAK,EAajC,OAXK,GAEL,EAAQ,SAAS,CAAM,EAEF,EAAQ,eAAe,CAAM,GAAK,KAAK,IAAI,EAAO,QAAQ,GAAK,EAAO,WAI3F,EAAM,EACN,EAAQ,WAAW,CAAM,EAElB,IALmB,IANN,EAYtB,EAkCE,gBAhCuB,GAAiC,CACxD,GAAI,CAAC,GAAU,CAAC,EAAe,CAAK,EAAG,MAAO,GAE9C,IAAM,EAAS,EAAa,CAAK,EAMjC,OAJA,EAAM,EAEF,GAAQ,EAAQ,YAAY,CAAM,EAE/B,EACT,EAuBE,aAAgB,GAAU,MACzB,OAAO,SAAU,CACpB,CACF"}

package/dist/core/swipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swipe.d.ts","sourceRoot":"","sources":["../../src/core/swipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC;AAElC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC;IACvB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,WAAW,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,+FAA+F;IAC/F,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACtD,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACpD,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACpD,eAAe,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IAClD,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB,CAAC;AA6BF,eAAO,MAAM,kBAAkB,GAAI,SAAS,mBAAmB,KAAG,YAoHjE,CAAC"}

package/dist/{headless → core}/swipe.js

@@ -1,4 +1,4 @@
-//#region src/headless/swipe.ts
+//#region src/core/swipe.ts
 var e = (e) => e.axis?.() ?? "x", t = (e) => {
 	let t = e.threshold?.() ?? 48;
 	return Number.isFinite(t) && t > 0 ? t : 1;

package/dist/core/swipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swipe.js","names":[],"sources":["../../src/core/swipe.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nexport type SwipeAxis = 'x' | 'y';\n\nexport type SwipeControlDetail = {\n  axis: SwipeAxis;\n  current: number;\n  distance: number;\n  event: PointerEvent;\n  pointerId: number;\n  progress: number;\n  start: number;\n  threshold: number;\n};\n\nexport type SwipeControlOptions = {\n  axis?: () => SwipeAxis;\n  captureTarget?: (event: PointerEvent) => HTMLElement | null;\n  disabled?: Readable<boolean | undefined>;\n  /** Called when the platform interrupts an in-flight swipe (`pointercancel`). */\n  onCancel?: (detail: SwipeControlDetail) => void;\n  onCommit?: (detail: SwipeControlDetail) => void;\n  onMove?: (detail: SwipeControlDetail) => void;\n  /** Called when the pointer is released (`pointerup`) without crossing the commit threshold. */\n  onRelease?: (detail: SwipeControlDetail) => void;\n  onStart?: (detail: SwipeControlDetail) => void;\n  shouldCommit?: (detail: SwipeControlDetail) => boolean;\n  threshold?: () => number;\n};\n\nexport type SwipeControl = {\n  [Symbol.dispose](): void;\n  /** Cancel any in-flight swipe and clean up internal state. */\n  dispose: () => void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  handlePointerCancel: (event: PointerEvent) => boolean;\n  handlePointerDown: (event: PointerEvent) => boolean;\n  handlePointerMove: (event: PointerEvent) => boolean;\n  handlePointerUp: (event: PointerEvent) => boolean;\n  isActive: () => boolean;\n};\n\ntype ActiveSwipe = {\n  axis: SwipeAxis;\n  pointerId: number;\n  start: number;\n  threshold: number;\n};\n\nconst resolveAxis = (options: SwipeControlOptions): SwipeAxis => options.axis?.() ?? 'x';\n\nconst resolveThreshold = (options: SwipeControlOptions): number => {\n  const threshold = options.threshold?.() ?? 48;\n\n  return Number.isFinite(threshold) && threshold > 0 ? threshold : 1;\n};\n\nconst getCoordinate = (event: PointerEvent, axis: SwipeAxis): number => {\n  return axis === 'x' ? event.clientX : event.clientY;\n};\n\nconst defaultCaptureTarget = (event: PointerEvent): HTMLElement | null => {\n  if (event.currentTarget instanceof HTMLElement) return event.currentTarget;\n\n  if (event.target instanceof HTMLElement) return event.target;\n\n  return null;\n};\n\nexport const createSwipeControl = (options: SwipeControlOptions): SwipeControl => {\n  let active: ActiveSwipe | null = null;\n  let disposed = false;\n\n  const isDisabled = (): boolean => Boolean(options.disabled?.value);\n\n  const reset = (): void => {\n    active = null;\n  };\n\n  const dispose = (): void => {\n    disposed = true;\n    reset();\n  };\n\n  const matchesPointer = (event: PointerEvent): boolean => {\n    return active?.pointerId === event.pointerId;\n  };\n\n  const createDetail = (event: PointerEvent): SwipeControlDetail | null => {\n    if (!active) return null;\n\n    const current = getCoordinate(event, active.axis);\n    const distance = current - active.start;\n\n    return {\n      axis: active.axis,\n      current,\n      distance,\n      event,\n      pointerId: active.pointerId,\n      progress: Math.min(Math.abs(distance) / active.threshold, 1),\n      start: active.start,\n      threshold: active.threshold,\n    };\n  };\n\n  const handlePointerDown = (event: PointerEvent): boolean => {\n    if (disposed || active || isDisabled()) return false;\n\n    const axis = resolveAxis(options);\n\n    active = {\n      axis,\n      pointerId: event.pointerId,\n      start: getCoordinate(event, axis),\n      threshold: resolveThreshold(options),\n    };\n\n    const captureTarget =\n      typeof options.captureTarget === 'function' ? options.captureTarget(event) : defaultCaptureTarget(event);\n\n    captureTarget?.setPointerCapture?.(event.pointerId);\n\n    const detail = createDetail(event);\n\n    if (detail) options.onStart?.(detail);\n\n    return true;\n  };\n\n  const handlePointerMove = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    if (!detail) return false;\n\n    options.onMove?.(detail);\n\n    const shouldCommit = options.shouldCommit?.(detail) ?? Math.abs(detail.distance) >= detail.threshold;\n\n    if (!shouldCommit) return true;\n\n    reset();\n    options.onCommit?.(detail);\n\n    return true;\n  };\n\n  const handlePointerUp = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    reset();\n\n    if (detail) options.onRelease?.(detail);\n\n    return true;\n  };\n\n  const handlePointerCancel = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    reset();\n\n    if (detail) options.onCancel?.(detail);\n\n    return true;\n  };\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    handlePointerCancel,\n    handlePointerDown,\n    handlePointerMove,\n    handlePointerUp,\n    isActive: () => active != null,\n    [Symbol.dispose]: dispose,\n  };\n};\n"],"mappings":";AAkDA,IAAM,KAAe,MAA4C,EAAQ,OAAO,KAAK,KAE/E,KAAoB,MAAyC;CACjE,IAAM,IAAY,EAAQ,YAAY,KAAK;CAE3C,OAAO,OAAO,SAAS,CAAS,KAAK,IAAY,IAAI,IAAY;AACnE,GAEM,KAAiB,GAAqB,MACnC,MAAS,MAAM,EAAM,UAAU,EAAM,SAGxC,KAAwB,MACxB,EAAM,yBAAyB,cAAoB,EAAM,gBAEzD,EAAM,kBAAkB,cAAoB,EAAM,SAE/C,MAGI,KAAsB,MAA+C;CAChF,IAAI,IAA6B,MAC7B,IAAW,IAET,UAA4B,EAAQ,EAAQ,UAAU,OAEtD,UAAoB;EACxB,IAAS;CACX,GAEM,UAAsB;EAE1B,AADA,IAAW,IACX,EAAM;CACR,GAEM,KAAkB,MACf,GAAQ,cAAc,EAAM,WAG/B,KAAgB,MAAmD;EACvE,IAAI,CAAC,GAAQ,OAAO;EAEpB,IAAM,IAAU,EAAc,GAAO,EAAO,IAAI,GAC1C,IAAW,IAAU,EAAO;EAElC,OAAO;GACL,MAAM,EAAO;GACb;GACA;GACA;GACA,WAAW,EAAO;GAClB,UAAU,KAAK,IAAI,KAAK,IAAI,CAAQ,IAAI,EAAO,WAAW,CAAC;GAC3D,OAAO,EAAO;GACd,WAAW,EAAO;EACpB;CACF;CAqEA,OAAO;EACL;EACA,IAAI,WAAW;GACb,OAAO;EACT;EACA,sBAjB2B,MAAiC;GAC5D,IAAI,CAAC,KAAU,CAAC,EAAe,CAAK,GAAG,OAAO;GAE9C,IAAM,IAAS,EAAa,CAAK;GAMjC,OAJA,EAAM,GAEF,KAAQ,EAAQ,WAAW,CAAM,GAE9B;EACT;EAQE,oBAzEyB,MAAiC;GAC1D,IAAI,KAAY,KAAU,EAAW,GAAG,OAAO;GAE/C,IAAM,IAAO,EAAY,CAAO;GAYhC,AAVA,IAAS;IACP;IACA,WAAW,EAAM;IACjB,OAAO,EAAc,GAAO,CAAI;IAChC,WAAW,EAAiB,CAAO;GACrC,IAGE,OAAO,EAAQ,iBAAkB,aAAa,EAAQ,cAAc,CAAK,IAAI,EAAqB,CAAK,EAAA,EAE1F,oBAAoB,EAAM,SAAS;GAElD,IAAM,IAAS,EAAa,CAAK;GAIjC,OAFI,KAAQ,EAAQ,UAAU,CAAM,GAE7B;EACT;EAoDE,oBAlDyB,MAAiC;GAC1D,IAAI,CAAC,KAAU,CAAC,EAAe,CAAK,GAAG,OAAO;GAE9C,IAAM,IAAS,EAAa,CAAK;GAajC,OAXK,KAEL,EAAQ,SAAS,CAAM,GAEF,EAAQ,eAAe,CAAM,KAAK,KAAK,IAAI,EAAO,QAAQ,KAAK,EAAO,aAI3F,EAAM,GACN,EAAQ,WAAW,CAAM,GAElB,MALmB,MANN;EAYtB;EAkCE,kBAhCuB,MAAiC;GACxD,IAAI,CAAC,KAAU,CAAC,EAAe,CAAK,GAAG,OAAO;GAE9C,IAAM,IAAS,EAAa,CAAK;GAMjC,OAJA,EAAM,GAEF,KAAQ,EAAQ,YAAY,CAAM,GAE/B;EACT;EAuBE,gBAAgB,KAAU;GACzB,OAAO,UAAU;CACpB;AACF"}

package/dist/core/text-field.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-field.cjs","names":[],"sources":["../../src/core/text-field.ts"],"sourcesContent":["import { computed, type Readable, type Signal } from '@vielzeug/ripple';\n\nimport { type CounterState, createCounterState, createField, type FieldHandle, type FieldOptions } from './field-base';\nimport { syncedSignal } from './signals';\n\n// ── Text field ────────────────────────────────────────────────────────────────\n\n/** Detach function returned by `wire()`. Call to remove element listeners. */\nexport type TextFieldDetach = () => void;\n\nexport type TextFieldOptions = FieldOptions & {\n  maxLength?: Readable<number | undefined>;\n  /**\n   * Called synchronously before value extraction on every input event.\n   * Use only for DOM side-effects (e.g. auto-resize measurement) that must\n   * run before the reactive value is updated.\n   */\n  onBeforeInput?: (event: Event) => void;\n  onBlur?: (event: FocusEvent) => void;\n  onChange?: (event: Event, value: string) => void;\n  onFocus?: (event: FocusEvent) => void;\n  onInput?: (event: Event, value: string) => void;\n  /**\n   * Bars the field from constraint validation while true — matches the native HTML rule that a\n   * `readonly` field is never a candidate for constraint validation (a `readonly required`\n   * field is always valid, per spec), so `validity`/`validationMessage` don't feed a false\n   * `valueMissing` into `useField()` just because a read-only field happens to be blank.\n   */\n  readonly?: Readable<boolean | undefined>;\n  /** Marks a blank value invalid — feeds `validity`/`validationMessage` (see below). */\n  required?: Readable<boolean | undefined>;\n  /** Message for the blank+required case. Defaults to `'This field is required.'`. */\n  requiredMessage?: Readable<string | undefined>;\n  /** `AbortSignal` from the component lifecycle. The internal value-sync watcher is disposed on abort. */\n  signal: AbortSignal;\n  value: Readable<string | undefined>;\n};\n\nexport type TextFieldHandle = FieldHandle & {\n  /**\n   * Registers the real form field handle (the return value of `useField()`) so that\n   * `triggerValidation()` — called internally on blur/change — can call its\n   * `reportValidity()`. `useField()` itself needs `value` (below) to exist first, so this\n   * is a two-step wiring rather than a constructor option:\n   *\n   * ```ts\n   * const tf = createTextField({ value: props.value, ... });\n   * const formField = useField({ value: tf.value, ... });\n   * tf.attachFormField(formField);\n   * ```\n   */\n  attachFormField: (formField: { reportValidity(): void }) => void;\n  /** Clears the field value and fires synthetic input/change events. */\n  clear: (event?: Event) => void;\n  /**\n   * Reactive counter state. Non-null when `maxLength` was provided; `null` otherwise.\n   * Components should only render a counter element when this is non-null.\n   */\n  counter: Readable<CounterState> | null;\n  /**\n   * Restores the value to whatever the `value` option currently holds (native form\n   * `reset()` semantics: a `<input>` reverts to its *current* `value` content attribute,\n   * not a frozen snapshot from element creation — so setting the attribute programmatically\n   * after mount changes what a later reset reverts to). Wire into `useField({ onReset: tf.reset })`.\n   */\n  reset: () => void;\n  /** Reactive validation message paired with `validity`. Empty string when valid. */\n  validationMessage: Readable<string>;\n  /**\n   * Reactive `ValidityStateFlags` — `{ valueMissing: true }` while `required` and blank,\n   * `null` (valid) otherwise. Pass straight to `useField({ validity: tf.validity })`.\n   */\n  validity: Readable<ValidityStateFlags | null>;\n  /** The local mutable field value (two-way bound to the input element via `wire()`). */\n  value: Signal<string>;\n  /**\n   * Attaches event listeners to the underlying input or textarea element.\n   *\n   * When `signal` is provided, the listeners are detached automatically when\n   * the signal's controller calls `abort()`. Without a signal the returned\n   * `TextFieldDetach` must be called manually.\n   *\n   * Safe to call multiple times — each call attaches a fresh set of listeners\n   * and returns a distinct detach function. Calling detach multiple times is\n   * a no-op (guarded internally).\n   */\n  wire: (el: HTMLInputElement | HTMLTextAreaElement, signal?: AbortSignal) => TextFieldDetach;\n};\n\nconst isBlank = (value: string): boolean => value.trim() === '';\nconst toFieldValue = (v: string | undefined): string => String(v ?? '');\n\nexport const createTextField = (options: TextFieldOptions): TextFieldHandle => {\n  const value = syncedSignal(options.value, options.signal, toFieldValue);\n\n  const field = createField(options);\n  const counter = options.maxLength ? createCounterState({ maxLength: options.maxLength, value }) : null;\n\n  const validity = computed<ValidityStateFlags | null>(() =>\n    !options.readonly?.value && options.required?.value && isBlank(value.value) ? { valueMissing: true } : null,\n  );\n  const validationMessage = computed(() =>\n    validity.value ? options.requiredMessage?.value || 'This field is required.' : '',\n  );\n\n  const reset = (): void => {\n    value.value = toFieldValue(options.value.value);\n    field.triggerValidation('change');\n  };\n\n  const clear = (event?: Event): void => {\n    event?.preventDefault?.();\n    value.value = '';\n    options.onInput?.(event ?? new InputEvent('input', { bubbles: true }), '');\n    options.onChange?.(event ?? new Event('change', { bubbles: true }), '');\n    field.triggerValidation('change');\n  };\n\n  const wire = (element: HTMLInputElement | HTMLTextAreaElement, signal?: AbortSignal): TextFieldDetach => {\n    const cleanups: Array<() => void> = [];\n    const on = (type: string, handler: EventListener): void => {\n      element.addEventListener(type, handler);\n      cleanups.push(() => element.removeEventListener(type, handler));\n    };\n\n    if (options.onFocus) {\n      on('focus', (e) => options.onFocus!(e as FocusEvent));\n    }\n\n    on('input', (e) => {\n      e.stopPropagation();\n      options.onBeforeInput?.(e);\n      value.value = element.value;\n      options.onInput?.(e, element.value);\n    });\n\n    on('change', (e) => {\n      e.stopPropagation();\n      value.value = element.value;\n      options.onChange?.(e, element.value);\n      field.triggerValidation('change');\n    });\n\n    on('blur', (e) => {\n      options.onBlur?.(e as FocusEvent);\n      field.triggerValidation('blur');\n    });\n\n    let detached = false;\n    const detach = (): void => {\n      if (detached) return;\n\n      detached = true;\n      for (const dispose of cleanups) dispose();\n    };\n\n    signal?.addEventListener('abort', detach, { once: true });\n\n    return detach;\n  };\n\n  return { ...field, clear, counter, reset, validationMessage, validity, value, wire };\n};\n"],"mappings":"iGAyFA,IAAM,EAAW,GAA2B,EAAM,KAAK,IAAM,GACvD,EAAgB,GAAkC,OAAO,GAAK,EAAE,EAEzD,EAAmB,GAA+C,CAC7E,IAAM,EAAQ,EAAA,aAAa,EAAQ,MAAO,EAAQ,OAAQ,CAAY,EAEhE,EAAQ,EAAA,YAAY,CAAO,EAC3B,EAAU,EAAQ,UAAY,EAAA,mBAAmB,CAAE,UAAW,EAAQ,UAAW,OAAM,CAAC,EAAI,KAE5F,GAAA,EAAW,EAAA,SAAA,KACf,CAAC,EAAQ,UAAU,OAAS,EAAQ,UAAU,OAAS,EAAQ,EAAM,KAAK,EAAI,CAAE,aAAc,EAAK,EAAI,IACzG,EACM,GAAA,EAAoB,EAAA,SAAA,KACxB,EAAS,MAAQ,EAAQ,iBAAiB,OAAS,0BAA4B,EACjF,EAEM,MAAoB,CACxB,EAAM,MAAQ,EAAa,EAAQ,MAAM,KAAK,EAC9C,EAAM,kBAAkB,QAAQ,CAClC,EAEM,EAAS,GAAwB,CACrC,GAAO,iBAAiB,EACxB,EAAM,MAAQ,GACd,EAAQ,UAAU,GAAS,IAAI,WAAW,QAAS,CAAE,QAAS,EAAK,CAAC,EAAG,EAAE,EACzE,EAAQ,WAAW,GAAS,IAAI,MAAM,SAAU,CAAE,QAAS,EAAK,CAAC,EAAG,EAAE,EACtE,EAAM,kBAAkB,QAAQ,CAClC,EAEM,GAAQ,EAAiD,IAA0C,CACvG,IAAM,EAA8B,CAAC,EAC/B,GAAM,EAAc,IAAiC,CACzD,EAAQ,iBAAiB,EAAM,CAAO,EACtC,EAAS,SAAW,EAAQ,oBAAoB,EAAM,CAAO,CAAC,CAChE,EAEI,EAAQ,SACV,EAAG,QAAU,GAAM,EAAQ,QAAS,CAAe,CAAC,EAGtD,EAAG,QAAU,GAAM,CACjB,EAAE,gBAAgB,EAClB,EAAQ,gBAAgB,CAAC,EACzB,EAAM,MAAQ,EAAQ,MACtB,EAAQ,UAAU,EAAG,EAAQ,KAAK,CACpC,CAAC,EAED,EAAG,SAAW,GAAM,CAClB,EAAE,gBAAgB,EAClB,EAAM,MAAQ,EAAQ,MACtB,EAAQ,WAAW,EAAG,EAAQ,KAAK,EACnC,EAAM,kBAAkB,QAAQ,CAClC,CAAC,EAED,EAAG,OAAS,GAAM,CAChB,EAAQ,SAAS,CAAe,EAChC,EAAM,kBAAkB,MAAM,CAChC,CAAC,EAED,IAAI,EAAW,GACT,MAAqB,CACrB,MAEJ,GAAW,GACX,IAAK,IAAM,KAAW,EAAU,EAAQ,CAD7B,CAEb,EAIA,OAFA,GAAQ,iBAAiB,QAAS,EAAQ,CAAE,KAAM,EAAK,CAAC,EAEjD,CACT,EAEA,MAAO,CAAE,GAAG,EAAO,QAAO,UAAS,QAAO,oBAAmB,WAAU,QAAO,MAAK,CACrF"}

package/dist/core/text-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-field.d.ts","sourceRoot":"","sources":["../../src/core/text-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,EAAE,KAAK,YAAY,EAAmC,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAKvH,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG;IAC5C,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACvC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,sFAAsF;IACtF,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,oFAAoF;IACpF,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C,wGAAwG;IACxG,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAC1C;;;;;;;;;;;OAWG;IACH,eAAe,EAAE,CAAC,SAAS,EAAE;QAAE,cAAc,IAAI,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,sEAAsE;IACtE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B;;;OAGG;IACH,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IACvC;;;;;OAKG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,mFAAmF;IACnF,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC9C,uFAAuF;IACvF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB;;;;;;;;;;OAUG;IACH,IAAI,EAAE,CAAC,EAAE,EAAE,gBAAgB,GAAG,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,eAAe,CAAC;CAC7F,CAAC;AAKF,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,eAsE3D,CAAC"}

package/dist/{headless → core}/text-field.js

@@ -1,7 +1,7 @@
 import { createCounterState as e, createField as t } from "./field-base.js";
 import { syncedSignal as n } from "./signals.js";
 import { computed as r } from "@vielzeug/ripple";
-//#region src/headless/text-field.ts
+//#region src/core/text-field.ts
 var i = (e) => e.trim() === "", a = (e) => String(e ?? ""), o = (o) => {
 	let s = n(o.value, o.signal, a), c = t(o), l = o.maxLength ? e({
 		maxLength: o.maxLength,

package/dist/core/text-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-field.js","names":[],"sources":["../../src/core/text-field.ts"],"sourcesContent":["import { computed, type Readable, type Signal } from '@vielzeug/ripple';\n\nimport { type CounterState, createCounterState, createField, type FieldHandle, type FieldOptions } from './field-base';\nimport { syncedSignal } from './signals';\n\n// ── Text field ────────────────────────────────────────────────────────────────\n\n/** Detach function returned by `wire()`. Call to remove element listeners. */\nexport type TextFieldDetach = () => void;\n\nexport type TextFieldOptions = FieldOptions & {\n  maxLength?: Readable<number | undefined>;\n  /**\n   * Called synchronously before value extraction on every input event.\n   * Use only for DOM side-effects (e.g. auto-resize measurement) that must\n   * run before the reactive value is updated.\n   */\n  onBeforeInput?: (event: Event) => void;\n  onBlur?: (event: FocusEvent) => void;\n  onChange?: (event: Event, value: string) => void;\n  onFocus?: (event: FocusEvent) => void;\n  onInput?: (event: Event, value: string) => void;\n  /**\n   * Bars the field from constraint validation while true — matches the native HTML rule that a\n   * `readonly` field is never a candidate for constraint validation (a `readonly required`\n   * field is always valid, per spec), so `validity`/`validationMessage` don't feed a false\n   * `valueMissing` into `useField()` just because a read-only field happens to be blank.\n   */\n  readonly?: Readable<boolean | undefined>;\n  /** Marks a blank value invalid — feeds `validity`/`validationMessage` (see below). */\n  required?: Readable<boolean | undefined>;\n  /** Message for the blank+required case. Defaults to `'This field is required.'`. */\n  requiredMessage?: Readable<string | undefined>;\n  /** `AbortSignal` from the component lifecycle. The internal value-sync watcher is disposed on abort. */\n  signal: AbortSignal;\n  value: Readable<string | undefined>;\n};\n\nexport type TextFieldHandle = FieldHandle & {\n  /**\n   * Registers the real form field handle (the return value of `useField()`) so that\n   * `triggerValidation()` — called internally on blur/change — can call its\n   * `reportValidity()`. `useField()` itself needs `value` (below) to exist first, so this\n   * is a two-step wiring rather than a constructor option:\n   *\n   * ```ts\n   * const tf = createTextField({ value: props.value, ... });\n   * const formField = useField({ value: tf.value, ... });\n   * tf.attachFormField(formField);\n   * ```\n   */\n  attachFormField: (formField: { reportValidity(): void }) => void;\n  /** Clears the field value and fires synthetic input/change events. */\n  clear: (event?: Event) => void;\n  /**\n   * Reactive counter state. Non-null when `maxLength` was provided; `null` otherwise.\n   * Components should only render a counter element when this is non-null.\n   */\n  counter: Readable<CounterState> | null;\n  /**\n   * Restores the value to whatever the `value` option currently holds (native form\n   * `reset()` semantics: a `<input>` reverts to its *current* `value` content attribute,\n   * not a frozen snapshot from element creation — so setting the attribute programmatically\n   * after mount changes what a later reset reverts to). Wire into `useField({ onReset: tf.reset })`.\n   */\n  reset: () => void;\n  /** Reactive validation message paired with `validity`. Empty string when valid. */\n  validationMessage: Readable<string>;\n  /**\n   * Reactive `ValidityStateFlags` — `{ valueMissing: true }` while `required` and blank,\n   * `null` (valid) otherwise. Pass straight to `useField({ validity: tf.validity })`.\n   */\n  validity: Readable<ValidityStateFlags | null>;\n  /** The local mutable field value (two-way bound to the input element via `wire()`). */\n  value: Signal<string>;\n  /**\n   * Attaches event listeners to the underlying input or textarea element.\n   *\n   * When `signal` is provided, the listeners are detached automatically when\n   * the signal's controller calls `abort()`. Without a signal the returned\n   * `TextFieldDetach` must be called manually.\n   *\n   * Safe to call multiple times — each call attaches a fresh set of listeners\n   * and returns a distinct detach function. Calling detach multiple times is\n   * a no-op (guarded internally).\n   */\n  wire: (el: HTMLInputElement | HTMLTextAreaElement, signal?: AbortSignal) => TextFieldDetach;\n};\n\nconst isBlank = (value: string): boolean => value.trim() === '';\nconst toFieldValue = (v: string | undefined): string => String(v ?? '');\n\nexport const createTextField = (options: TextFieldOptions): TextFieldHandle => {\n  const value = syncedSignal(options.value, options.signal, toFieldValue);\n\n  const field = createField(options);\n  const counter = options.maxLength ? createCounterState({ maxLength: options.maxLength, value }) : null;\n\n  const validity = computed<ValidityStateFlags | null>(() =>\n    !options.readonly?.value && options.required?.value && isBlank(value.value) ? { valueMissing: true } : null,\n  );\n  const validationMessage = computed(() =>\n    validity.value ? options.requiredMessage?.value || 'This field is required.' : '',\n  );\n\n  const reset = (): void => {\n    value.value = toFieldValue(options.value.value);\n    field.triggerValidation('change');\n  };\n\n  const clear = (event?: Event): void => {\n    event?.preventDefault?.();\n    value.value = '';\n    options.onInput?.(event ?? new InputEvent('input', { bubbles: true }), '');\n    options.onChange?.(event ?? new Event('change', { bubbles: true }), '');\n    field.triggerValidation('change');\n  };\n\n  const wire = (element: HTMLInputElement | HTMLTextAreaElement, signal?: AbortSignal): TextFieldDetach => {\n    const cleanups: Array<() => void> = [];\n    const on = (type: string, handler: EventListener): void => {\n      element.addEventListener(type, handler);\n      cleanups.push(() => element.removeEventListener(type, handler));\n    };\n\n    if (options.onFocus) {\n      on('focus', (e) => options.onFocus!(e as FocusEvent));\n    }\n\n    on('input', (e) => {\n      e.stopPropagation();\n      options.onBeforeInput?.(e);\n      value.value = element.value;\n      options.onInput?.(e, element.value);\n    });\n\n    on('change', (e) => {\n      e.stopPropagation();\n      value.value = element.value;\n      options.onChange?.(e, element.value);\n      field.triggerValidation('change');\n    });\n\n    on('blur', (e) => {\n      options.onBlur?.(e as FocusEvent);\n      field.triggerValidation('blur');\n    });\n\n    let detached = false;\n    const detach = (): void => {\n      if (detached) return;\n\n      detached = true;\n      for (const dispose of cleanups) dispose();\n    };\n\n    signal?.addEventListener('abort', detach, { once: true });\n\n    return detach;\n  };\n\n  return { ...field, clear, counter, reset, validationMessage, validity, value, wire };\n};\n"],"mappings":";;;;AAyFA,IAAM,KAAW,MAA2B,EAAM,KAAK,MAAM,IACvD,KAAgB,MAAkC,OAAO,KAAK,EAAE,GAEzD,KAAmB,MAA+C;CAC7E,IAAM,IAAQ,EAAa,EAAQ,OAAO,EAAQ,QAAQ,CAAY,GAEhE,IAAQ,EAAY,CAAO,GAC3B,IAAU,EAAQ,YAAY,EAAmB;EAAE,WAAW,EAAQ;EAAW;CAAM,CAAC,IAAI,MAE5F,IAAW,QACf,CAAC,EAAQ,UAAU,SAAS,EAAQ,UAAU,SAAS,EAAQ,EAAM,KAAK,IAAI,EAAE,cAAc,GAAK,IAAI,IACzG,GACM,IAAoB,QACxB,EAAS,QAAQ,EAAQ,iBAAiB,SAAS,4BAA4B,EACjF,GAEM,UAAoB;EAExB,AADA,EAAM,QAAQ,EAAa,EAAQ,MAAM,KAAK,GAC9C,EAAM,kBAAkB,QAAQ;CAClC,GAEM,KAAS,MAAwB;EAKrC,AAJA,GAAO,iBAAiB,GACxB,EAAM,QAAQ,IACd,EAAQ,UAAU,KAAS,IAAI,WAAW,SAAS,EAAE,SAAS,GAAK,CAAC,GAAG,EAAE,GACzE,EAAQ,WAAW,KAAS,IAAI,MAAM,UAAU,EAAE,SAAS,GAAK,CAAC,GAAG,EAAE,GACtE,EAAM,kBAAkB,QAAQ;CAClC,GAEM,KAAQ,GAAiD,MAA0C;EACvG,IAAM,IAA8B,CAAC,GAC/B,KAAM,GAAc,MAAiC;GAEzD,AADA,EAAQ,iBAAiB,GAAM,CAAO,GACtC,EAAS,WAAW,EAAQ,oBAAoB,GAAM,CAAO,CAAC;EAChE;EAoBA,AAlBI,EAAQ,WACV,EAAG,UAAU,MAAM,EAAQ,QAAS,CAAe,CAAC,GAGtD,EAAG,UAAU,MAAM;GAIjB,AAHA,EAAE,gBAAgB,GAClB,EAAQ,gBAAgB,CAAC,GACzB,EAAM,QAAQ,EAAQ,OACtB,EAAQ,UAAU,GAAG,EAAQ,KAAK;EACpC,CAAC,GAED,EAAG,WAAW,MAAM;GAIlB,AAHA,EAAE,gBAAgB,GAClB,EAAM,QAAQ,EAAQ,OACtB,EAAQ,WAAW,GAAG,EAAQ,KAAK,GACnC,EAAM,kBAAkB,QAAQ;EAClC,CAAC,GAED,EAAG,SAAS,MAAM;GAEhB,AADA,EAAQ,SAAS,CAAe,GAChC,EAAM,kBAAkB,MAAM;EAChC,CAAC;EAED,IAAI,IAAW,IACT,UAAqB;GACrB,QAEJ;QAAW;IACX,KAAK,IAAM,KAAW,GAAU,EAAQ;GAD7B;EAEb;EAIA,OAFA,GAAQ,iBAAiB,SAAS,GAAQ,EAAE,MAAM,GAAK,CAAC,GAEjD;CACT;CAEA,OAAO;EAAE,GAAG;EAAO;EAAO;EAAS;EAAO;EAAmB;EAAU;EAAO;CAAK;AACrF"}

package/dist/core/typeahead.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeahead.cjs","names":[],"sources":["../../src/core/typeahead.ts"],"sourcesContent":["// ── Typeahead ─────────────────────────────────────────────────────────────────\n// Standalone typeahead primitive: accumulates printable keystrokes, then finds\n// the first enabled item whose label starts with the buffer.\n//\n// Extracted from nav.ts so it can be reused independently (e.g. combobox input).\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type TypeaheadOptions<T> = {\n  /**\n   * Milliseconds of inactivity before the buffer resets.\n   * ARIA APG recommended window. Default: `500`.\n   */\n  delay?: number;\n  /** Returns the current focused index (used to search forward from current + 1). */\n  getIndex: () => number;\n  /** Returns a plain-text label for the item at `index`. */\n  getItemLabel: (item: T, index: number) => string;\n  /** Returns all items in the current list. */\n  getItems: () => T[];\n  /** Returns `true` for items that should be skipped during typeahead search. */\n  isItemDisabled?: (item: T, index: number) => boolean;\n  /** Called when typeahead navigation lands on an item. */\n  onNavigate: (index: number, event: KeyboardEvent) => void;\n  /**\n   * When provided, the pending reset timer is cancelled automatically when the\n   * signal aborts (e.g. when the owning component disconnects).\n   */\n  signal?: AbortSignal;\n};\n\nexport type Typeahead = {\n  /**\n   * Process a keyboard event. Returns `true` if the event was consumed by\n   * typeahead (a printable character matched or was buffered).\n   */\n  handleKeydown(event: KeyboardEvent): boolean;\n  /** Reset the buffer immediately. Call on list close to clear stale input. */\n  reset(): void;\n};\n\n// ── Implementation ────────────────────────────────────────────────────────────\n\n/**\n * Creates a standalone typeahead handler for keyboard-navigable lists.\n *\n * Accumulates printable keystrokes into a buffer; on each keystroke searches\n * for the first enabled item whose label starts with the buffer. Cycles past\n * the current item on repeated same-character presses. Buffer resets after\n * `delay` ms of inactivity (default 500 — the ARIA APG recommended window).\n *\n * @example\n * ```ts\n * const typeahead = createTypeahead({\n *   getIndex: () => focusedIndex,\n *   getItemLabel: (item) => item.label,\n *   getItems: () => items,\n *   onNavigate: (index) => { focusedIndex = index; },\n * });\n *\n * listEl.addEventListener('keydown', (e) => typeahead.handleKeydown(e));\n * ```\n */\nexport const createTypeahead = <T>(options: TypeaheadOptions<T>): Typeahead => {\n  const delay = options.delay ?? 500;\n  let _buffer = '';\n  let _timer: ReturnType<typeof setTimeout> | null = null;\n\n  const reset = (): void => {\n    _buffer = '';\n\n    if (_timer !== null) {\n      clearTimeout(_timer);\n      _timer = null;\n    }\n  };\n\n  options.signal?.addEventListener('abort', reset, { once: true });\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    // Single printable character only; exclude modifier combos.\n    if (event.key.length !== 1 || event.ctrlKey || event.altKey || event.metaKey) return false;\n\n    _buffer += event.key.toLowerCase();\n\n    if (_timer !== null) clearTimeout(_timer);\n\n    _timer = setTimeout(reset, delay);\n\n    const items = options.getItems();\n    const current = options.getIndex();\n    const startAfter = current >= 0 ? current + 1 : 0;\n\n    for (let n = 0; n < items.length; n++) {\n      const i = (startAfter + n) % items.length;\n\n      if (options.isItemDisabled?.(items[i], i)) continue;\n\n      if (options.getItemLabel(items[i], i).toLowerCase().startsWith(_buffer)) {\n        options.onNavigate(i, event);\n\n        return true;\n      }\n    }\n\n    return false;\n  };\n\n  return { handleKeydown, reset };\n};\n"],"mappings":"AA+DA,IAAa,EAAsB,GAA4C,CAC7E,IAAM,EAAQ,EAAQ,OAAS,IAC3B,EAAU,GACV,EAA+C,KAE7C,MAAoB,CACxB,EAAU,GAEN,IAAW,OACb,aAAa,CAAM,EACnB,EAAS,KAEb,EAiCA,OA/BA,EAAQ,QAAQ,iBAAiB,QAAS,EAAO,CAAE,KAAM,EAAK,CAAC,EA+BxD,CAAE,cA7Bc,GAAkC,CAEvD,GAAI,EAAM,IAAI,SAAW,GAAK,EAAM,SAAW,EAAM,QAAU,EAAM,QAAS,MAAO,GAErF,GAAW,EAAM,IAAI,YAAY,EAE7B,IAAW,MAAM,aAAa,CAAM,EAExC,EAAS,WAAW,EAAO,CAAK,EAEhC,IAAM,EAAQ,EAAQ,SAAS,EACzB,EAAU,EAAQ,SAAS,EAC3B,EAAa,GAAW,EAAI,EAAU,EAAI,EAEhD,IAAK,IAAI,EAAI,EAAG,EAAI,EAAM,OAAQ,IAAK,CACrC,IAAM,GAAK,EAAa,GAAK,EAAM,OAE/B,MAAQ,iBAAiB,EAAM,GAAI,CAAC,GAEpC,EAAQ,aAAa,EAAM,GAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAO,EAGpE,OAFA,EAAQ,WAAW,EAAG,CAAK,EAEpB,EAEX,CAEA,MAAO,EACT,EAEwB,OAAM,CAChC"}

package/dist/core/typeahead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeahead.d.ts","sourceRoot":"","sources":["../../src/core/typeahead.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,yDAAyD;IACzD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1D;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAC7C,6EAA6E;IAC7E,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAIF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,KAAG,SA8CjE,CAAC"}

package/dist/{headless → core}/typeahead.js

@@ -1,4 +1,4 @@
-//#region src/headless/typeahead.ts
+//#region src/core/typeahead.ts
 var e = (e) => {
 	let t = e.delay ?? 500, n = "", r = null, i = () => {
 		n = "", r !== null && (clearTimeout(r), r = null);

package/dist/core/typeahead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeahead.js","names":[],"sources":["../../src/core/typeahead.ts"],"sourcesContent":["// ── Typeahead ─────────────────────────────────────────────────────────────────\n// Standalone typeahead primitive: accumulates printable keystrokes, then finds\n// the first enabled item whose label starts with the buffer.\n//\n// Extracted from nav.ts so it can be reused independently (e.g. combobox input).\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type TypeaheadOptions<T> = {\n  /**\n   * Milliseconds of inactivity before the buffer resets.\n   * ARIA APG recommended window. Default: `500`.\n   */\n  delay?: number;\n  /** Returns the current focused index (used to search forward from current + 1). */\n  getIndex: () => number;\n  /** Returns a plain-text label for the item at `index`. */\n  getItemLabel: (item: T, index: number) => string;\n  /** Returns all items in the current list. */\n  getItems: () => T[];\n  /** Returns `true` for items that should be skipped during typeahead search. */\n  isItemDisabled?: (item: T, index: number) => boolean;\n  /** Called when typeahead navigation lands on an item. */\n  onNavigate: (index: number, event: KeyboardEvent) => void;\n  /**\n   * When provided, the pending reset timer is cancelled automatically when the\n   * signal aborts (e.g. when the owning component disconnects).\n   */\n  signal?: AbortSignal;\n};\n\nexport type Typeahead = {\n  /**\n   * Process a keyboard event. Returns `true` if the event was consumed by\n   * typeahead (a printable character matched or was buffered).\n   */\n  handleKeydown(event: KeyboardEvent): boolean;\n  /** Reset the buffer immediately. Call on list close to clear stale input. */\n  reset(): void;\n};\n\n// ── Implementation ────────────────────────────────────────────────────────────\n\n/**\n * Creates a standalone typeahead handler for keyboard-navigable lists.\n *\n * Accumulates printable keystrokes into a buffer; on each keystroke searches\n * for the first enabled item whose label starts with the buffer. Cycles past\n * the current item on repeated same-character presses. Buffer resets after\n * `delay` ms of inactivity (default 500 — the ARIA APG recommended window).\n *\n * @example\n * ```ts\n * const typeahead = createTypeahead({\n *   getIndex: () => focusedIndex,\n *   getItemLabel: (item) => item.label,\n *   getItems: () => items,\n *   onNavigate: (index) => { focusedIndex = index; },\n * });\n *\n * listEl.addEventListener('keydown', (e) => typeahead.handleKeydown(e));\n * ```\n */\nexport const createTypeahead = <T>(options: TypeaheadOptions<T>): Typeahead => {\n  const delay = options.delay ?? 500;\n  let _buffer = '';\n  let _timer: ReturnType<typeof setTimeout> | null = null;\n\n  const reset = (): void => {\n    _buffer = '';\n\n    if (_timer !== null) {\n      clearTimeout(_timer);\n      _timer = null;\n    }\n  };\n\n  options.signal?.addEventListener('abort', reset, { once: true });\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    // Single printable character only; exclude modifier combos.\n    if (event.key.length !== 1 || event.ctrlKey || event.altKey || event.metaKey) return false;\n\n    _buffer += event.key.toLowerCase();\n\n    if (_timer !== null) clearTimeout(_timer);\n\n    _timer = setTimeout(reset, delay);\n\n    const items = options.getItems();\n    const current = options.getIndex();\n    const startAfter = current >= 0 ? current + 1 : 0;\n\n    for (let n = 0; n < items.length; n++) {\n      const i = (startAfter + n) % items.length;\n\n      if (options.isItemDisabled?.(items[i], i)) continue;\n\n      if (options.getItemLabel(items[i], i).toLowerCase().startsWith(_buffer)) {\n        options.onNavigate(i, event);\n\n        return true;\n      }\n    }\n\n    return false;\n  };\n\n  return { handleKeydown, reset };\n};\n"],"mappings":";AA+DA,IAAa,KAAsB,MAA4C;CAC7E,IAAM,IAAQ,EAAQ,SAAS,KAC3B,IAAU,IACV,IAA+C,MAE7C,UAAoB;EAGxB,AAFA,IAAU,IAEN,MAAW,SACb,aAAa,CAAM,GACnB,IAAS;CAEb;CAiCA,OA/BA,EAAQ,QAAQ,iBAAiB,SAAS,GAAO,EAAE,MAAM,GAAK,CAAC,GA+BxD;EAAE,gBA7Bc,MAAkC;GAEvD,IAAI,EAAM,IAAI,WAAW,KAAK,EAAM,WAAW,EAAM,UAAU,EAAM,SAAS,OAAO;GAMrF,AAJA,KAAW,EAAM,IAAI,YAAY,GAE7B,MAAW,QAAM,aAAa,CAAM,GAExC,IAAS,WAAW,GAAO,CAAK;GAEhC,IAAM,IAAQ,EAAQ,SAAS,GACzB,IAAU,EAAQ,SAAS,GAC3B,IAAa,KAAW,IAAI,IAAU,IAAI;GAEhD,KAAK,IAAI,IAAI,GAAG,IAAI,EAAM,QAAQ,KAAK;IACrC,IAAM,KAAK,IAAa,KAAK,EAAM;IAE/B,OAAQ,iBAAiB,EAAM,IAAI,CAAC,KAEpC,EAAQ,aAAa,EAAM,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAO,GAGpE,OAFA,EAAQ,WAAW,GAAG,CAAK,GAEpB;GAEX;GAEA,OAAO;EACT;EAEwB;CAAM;AAChC"}