@vielzeug/refine 1.1.1

package/dist/headless/field-base.d.ts

@@ -0,0 +1,148 @@
+import { type Readable } from '@vielzeug/ripple';
+export type ValidationTrigger = 'blur' | 'change' | 'input' | 'submit';
+export type ControlValidationMode = ValidationTrigger | undefined;
+/** Options shared by both `createTextField` and `createChoiceField`. */
+export type FieldOptions = {
+    disabled?: Readable<boolean | undefined>;
+    error?: Readable<string | undefined>;
+    /**
+     * Returns the underlying form field object used for validation triggering.
+     * Called lazily — safe to return `null` before the first render.
+     */
+    getFormField?: () => {
+        reportValidity(): void;
+    } | null;
+    /**
+     * Override for label visibility that takes precedence over deriving it from
+     * the `label` text signal. Pass a computed signal that checks both prop and
+     * slot presence to enable slot-first composition.
+     *
+     * @example
+     * ```ts
+     * const hasLabel = computed(() => !!props.label.value || slots.has('label').value);
+     * const field = createField({ ...options, hasLabel });
+     * ```
+     */
+    hasLabel?: Readable<boolean>;
+    helper?: Readable<string | undefined>;
+    /**
+     * When provided, used directly as `fieldId` instead of generating one via
+     * `createStableId`. Useful in tests for deterministic ID assertions.
+     */
+    id?: string;
+    /**
+     * Label text signal. When provided, `labelVisible` and `ariaLabelledBy` are
+     * computed reactively from this value (see `hasLabel` for the slot-first override).
+     */
+    label?: Readable<string | undefined>;
+    /**
+     * Label placement signal. Defaults to `'inset'`.
+     *
+     * Not currently consumed by `createField()` itself — visibility is driven
+     * solely by `hasLabel`/`label`. Threaded through so component authors can
+     * apply placement-specific styling (`label-placement` attribute) without a
+     * second prop; if placement-dependent visibility is ever needed, wire it
+     * into `labelVisible$` in `createField()` instead of adding a new option.
+     */
+    labelPlacement?: Readable<LabelPlacement>;
+    prefix?: string;
+    validateOn?: Readable<ControlValidationMode>;
+};
+export type ErrorHelperState = {
+    errorText: string;
+    helperText: string;
+};
+export type ErrorHelperOptions = {
+    error?: Readable<string | undefined>;
+    helper?: Readable<string | undefined>;
+};
+export declare const createErrorHelperState: (options: ErrorHelperOptions) => Readable<ErrorHelperState>;
+/** Counter state for text fields with `maxLength`. */
+export type CounterState = {
+    counterAtLimit: boolean;
+    counterNearLimit: boolean;
+    counterText: string;
+};
+export type CounterOptions = {
+    maxLength?: Readable<number | undefined>;
+    value: Readable<string | undefined>;
+};
+/**
+ * Creates a reactive counter state signal for text fields with `maxLength`.
+ * Only call this when `maxLength` may be set — the state is genuinely opt-in.
+ *
+ * @example
+ * ```ts
+ * const counter = createCounterState({ value: tf.value, maxLength: props.maxlength });
+ * ```
+ */
+export declare const createCounterState: (options: CounterOptions) => Readable<CounterState>;
+export type LabelPlacement = 'inset' | 'outside' | undefined;
+/**
+ * Common handle returned by `createField` — the base for both `TextFieldHandle`
+ * and `ChoiceFieldHandle`.
+ *
+ * ARIA signals and label state are flat on the handle — no nested `aria` or
+ * `label` sub-objects.
+ *
+ * @example
+ * ```html
+ * <label id="${labelId}" ?hidden="${() => !labelVisible.value}">...</label>
+ * <input
+ *   :aria-labelledby="${ariaLabelledBy}"
+ *   :aria-describedby="${ariaDescribedBy}"
+ *   :aria-invalid="${ariaInvalid}" />
+ * ```
+ */
+/** Flat ARIA attribute bag ready to spread into a template bind call. */
+export type AriaProps = {
+    'aria-describedby': string | null;
+    'aria-errormessage': string | null;
+    'aria-invalid': 'true' | null;
+    'aria-labelledby': string | null;
+};
+export type FieldHandle = {
+    /** `aria-describedby` value. Non-null when helper or error text is present. */
+    ariaDescribedBy: Readable<string | null>;
+    /** `aria-errormessage` value. Non-null when error text is present. */
+    ariaErrorMessage: Readable<string | null>;
+    /** `aria-invalid` value. `'true'` when error text is present, otherwise `null`. */
+    ariaInvalid: Readable<'true' | null>;
+    /** `aria-labelledby` value. Non-null when a label is visible. */
+    ariaLabelledBy: Readable<string | null>;
+    /**
+     * Returns a snapshot of the four ARIA attributes as a plain object.
+     * Spread into a template bind call to avoid repeating each signal individually.
+     *
+     * @example
+     * ```ts
+     * bind(inputEl, { attr: field.ariaProps() });
+     * ```
+     */
+    ariaProps(): AriaProps;
+    /**
+     * The stable `id` used for `aria-describedby` on the input. Points at the
+     * assistive-text region (covers both helper text and error text per WAI-ARIA).
+     */
+    assistiveId: string;
+    disabled: Readable<boolean>;
+    /** Stable `id` for the inline error message element (`aria-errormessage`). */
+    errorId: string;
+    /** Reactive error text. Empty string when no error is set. */
+    errorText: Readable<string>;
+    fieldId: string;
+    /** Reactive helper text. Empty string when no helper is set. */
+    helperText: Readable<string>;
+    /** Stable `id` for the label element. Stamp this on your `<label id="...">`. */
+    labelId: string;
+    /** Whether the label should be visible. Use to toggle `hidden` on the `<label>`. */
+    labelVisible: Readable<boolean>;
+    triggerValidation: (on: Extract<ValidationTrigger, 'blur' | 'change'>) => void;
+};
+/**
+ * Composes the field triad — IDs, assistive state, and label state — into a
+ * single `FieldHandle`. Both `createTextField` and `createChoiceField` build
+ * on top of this.
+ */
+export declare const createField: (options: FieldOptions) => FieldHandle;
+//# sourceMappingURL=field-base.d.ts.map

package/dist/headless/field-base.d.ts.map

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

package/dist/headless/field-base.js

@@ -0,0 +1,46 @@
+import { createStableId as e } from "@vielzeug/ore";
+import { computed as t } from "@vielzeug/ripple";
+//#region src/headless/field-base.ts
+var n = (e) => t(() => ({
+	errorText: e.error?.value ?? "",
+	helperText: e.helper?.value ?? ""
+})), r = (e) => t(() => {
+	let t = e.value?.value ?? "", n = e.maxLength?.value, r = Number(n), i = Number.isFinite(r) && r > 0 ? r : null, a = i !== null, o = a ? `${t.length} / ${i}` : "", s = a ? t.length / i : 0;
+	return {
+		counterAtLimit: a ? s >= 1 : !1,
+		counterNearLimit: a ? s >= .9 && s < 1 : !1,
+		counterText: o
+	};
+}), i = (r) => {
+	let i = t(() => !!r.disabled?.value), a = r.validateOn, o = r.id ?? e(r.prefix ?? "field"), s = e("helper"), c = (e) => {
+		a?.value === e && r.getFormField?.()?.reportValidity();
+	}, l = e("label"), u = e("error"), d = r.label ?? t(() => void 0), f = r.hasLabel ?? t(() => !!d.value), p = n({
+		error: r.error,
+		helper: r.helper
+	}), m = t(() => p.value.errorText || p.value.helperText ? s : null), h = t(() => p.value.errorText ? u : null), g = t(() => p.value.errorText ? "true" : null), _ = t(() => f.value ? l : null);
+	return {
+		ariaDescribedBy: m,
+		ariaErrorMessage: h,
+		ariaInvalid: g,
+		ariaLabelledBy: _,
+		ariaProps: () => ({
+			"aria-describedby": m.value,
+			"aria-errormessage": h.value,
+			"aria-invalid": g.value,
+			"aria-labelledby": _.value
+		}),
+		assistiveId: s,
+		disabled: i,
+		errorId: u,
+		errorText: t(() => p.value.errorText),
+		fieldId: o,
+		helperText: t(() => p.value.helperText),
+		labelId: l,
+		labelVisible: f,
+		triggerValidation: c
+	};
+};
+//#endregion
+export { r as createCounterState, n as createErrorHelperState, i as createField };
+
+//# sourceMappingURL=field-base.js.map

package/dist/headless/field-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-base.js","names":[],"sources":["../../src/headless/field-base.ts"],"sourcesContent":["import { createStableId } from '@vielzeug/ore';\nimport { computed, type Readable } from '@vielzeug/ripple';\n\n// ── Validation / context types ────────────────────────────────────────────────\n\nexport type ValidationTrigger = 'blur' | 'change' | 'input' | 'submit';\nexport type ControlValidationMode = ValidationTrigger | undefined;\n\n// ── Field options + handle ───────────────────────────────────────────────────\n\n/** Options shared by both `createTextField` and `createChoiceField`. */\nexport type FieldOptions = {\n  disabled?: Readable<boolean | undefined>;\n  error?: Readable<string | undefined>;\n  /**\n   * Returns the underlying form field object used for validation triggering.\n   * Called lazily — safe to return `null` before the first render.\n   */\n  getFormField?: () => { reportValidity(): void } | null;\n  /**\n   * Override for label visibility that takes precedence over deriving it from\n   * the `label` text signal. Pass a computed signal that checks both prop and\n   * slot presence to enable slot-first composition.\n   *\n   * @example\n   * ```ts\n   * const hasLabel = computed(() => !!props.label.value || slots.has('label').value);\n   * const field = createField({ ...options, hasLabel });\n   * ```\n   */\n  hasLabel?: Readable<boolean>;\n  helper?: Readable<string | undefined>;\n  /**\n   * When provided, used directly as `fieldId` instead of generating one via\n   * `createStableId`. Useful in tests for deterministic ID assertions.\n   */\n  id?: string;\n  /**\n   * Label text signal. When provided, `labelVisible` and `ariaLabelledBy` are\n   * computed reactively from this value (see `hasLabel` for the slot-first override).\n   */\n  label?: Readable<string | undefined>;\n  /**\n   * Label placement signal. Defaults to `'inset'`.\n   *\n   * Not currently consumed by `createField()` itself — visibility is driven\n   * solely by `hasLabel`/`label`. Threaded through so component authors can\n   * apply placement-specific styling (`label-placement` attribute) without a\n   * second prop; if placement-dependent visibility is ever needed, wire it\n   * into `labelVisible$` in `createField()` instead of adding a new option.\n   */\n  labelPlacement?: Readable<LabelPlacement>;\n  prefix?: string;\n  validateOn?: Readable<ControlValidationMode>;\n};\n\n// ── Error/helper assistive state ──────────────────────────────────────────────\n\nexport type ErrorHelperState = {\n  errorText: string;\n  helperText: string;\n};\n\nexport type ErrorHelperOptions = {\n  error?: Readable<string | undefined>;\n  helper?: Readable<string | undefined>;\n};\n\nexport const createErrorHelperState = (options: ErrorHelperOptions): Readable<ErrorHelperState> =>\n  computed(() => ({\n    errorText: options.error?.value ?? '',\n    helperText: options.helper?.value ?? '',\n  }));\n\n// ── Counter state (opt-in) ─────────────────────────────────────────────────────\n\n/** Counter state for text fields with `maxLength`. */\nexport type CounterState = {\n  counterAtLimit: boolean;\n  counterNearLimit: boolean;\n  counterText: string;\n};\n\nexport type CounterOptions = {\n  maxLength?: Readable<number | undefined>;\n  value: Readable<string | undefined>;\n};\n\n/**\n * Creates a reactive counter state signal for text fields with `maxLength`.\n * Only call this when `maxLength` may be set — the state is genuinely opt-in.\n *\n * @example\n * ```ts\n * const counter = createCounterState({ value: tf.value, maxLength: props.maxlength });\n * ```\n */\nexport const createCounterState = (options: CounterOptions): Readable<CounterState> =>\n  computed<CounterState>(() => {\n    const value = options.value?.value ?? '';\n    const maxLength = options.maxLength?.value;\n    const parsedMaxLength = Number(maxLength);\n    const validMaxLength = Number.isFinite(parsedMaxLength) && parsedMaxLength > 0 ? parsedMaxLength : null;\n    const hasCounter = validMaxLength !== null;\n    const counterText = hasCounter ? `${value.length} / ${validMaxLength}` : '';\n    const ratio = hasCounter ? value.length / validMaxLength : 0;\n\n    return {\n      counterAtLimit: hasCounter ? ratio >= 1 : false,\n      counterNearLimit: hasCounter ? ratio >= 0.9 && ratio < 1 : false,\n      counterText,\n    };\n  });\n\n// ── Label placement ───────────────────────────────────────────────────────────\n\nexport type LabelPlacement = 'inset' | 'outside' | undefined;\n\n// ── Field handle ──────────────────────────────────────────────────────────────\n\n/**\n * Common handle returned by `createField` — the base for both `TextFieldHandle`\n * and `ChoiceFieldHandle`.\n *\n * ARIA signals and label state are flat on the handle — no nested `aria` or\n * `label` sub-objects.\n *\n * @example\n * ```html\n * <label id=\"${labelId}\" ?hidden=\"${() => !labelVisible.value}\">...</label>\n * <input\n *   :aria-labelledby=\"${ariaLabelledBy}\"\n *   :aria-describedby=\"${ariaDescribedBy}\"\n *   :aria-invalid=\"${ariaInvalid}\" />\n * ```\n */\n/** Flat ARIA attribute bag ready to spread into a template bind call. */\nexport type AriaProps = {\n  'aria-describedby': string | null;\n  'aria-errormessage': string | null;\n  'aria-invalid': 'true' | null;\n  'aria-labelledby': string | null;\n};\n\nexport type FieldHandle = {\n  /** `aria-describedby` value. Non-null when helper or error text is present. */\n  ariaDescribedBy: Readable<string | null>;\n  /** `aria-errormessage` value. Non-null when error text is present. */\n  ariaErrorMessage: Readable<string | null>;\n  /** `aria-invalid` value. `'true'` when error text is present, otherwise `null`. */\n  ariaInvalid: Readable<'true' | null>;\n  /** `aria-labelledby` value. Non-null when a label is visible. */\n  ariaLabelledBy: Readable<string | null>;\n  /**\n   * Returns a snapshot of the four ARIA attributes as a plain object.\n   * Spread into a template bind call to avoid repeating each signal individually.\n   *\n   * @example\n   * ```ts\n   * bind(inputEl, { attr: field.ariaProps() });\n   * ```\n   */\n  ariaProps(): AriaProps;\n  /**\n   * The stable `id` used for `aria-describedby` on the input. Points at the\n   * assistive-text region (covers both helper text and error text per WAI-ARIA).\n   */\n  assistiveId: string;\n  disabled: Readable<boolean>;\n  /** Stable `id` for the inline error message element (`aria-errormessage`). */\n  errorId: string;\n  /** Reactive error text. Empty string when no error is set. */\n  errorText: Readable<string>;\n  fieldId: string;\n  /** Reactive helper text. Empty string when no helper is set. */\n  helperText: Readable<string>;\n  /** Stable `id` for the label element. Stamp this on your `<label id=\"...\">`. */\n  labelId: string;\n  /** Whether the label should be visible. Use to toggle `hidden` on the `<label>`. */\n  labelVisible: Readable<boolean>;\n  triggerValidation: (on: Extract<ValidationTrigger, 'blur' | 'change'>) => void;\n};\n\n/**\n * Composes the field triad — IDs, assistive state, and label state — into a\n * single `FieldHandle`. Both `createTextField` and `createChoiceField` build\n * on top of this.\n */\nexport const createField = (options: FieldOptions): FieldHandle => {\n  // ── Core ──────────────────────────────────────────────────────────────────\n  const disabled = computed(() => Boolean(options.disabled?.value));\n  const validateOn = options.validateOn;\n  const fieldId = options.id ?? createStableId(options.prefix ?? 'field');\n  const assistiveId = createStableId('helper');\n\n  const triggerValidation = (on: Extract<ValidationTrigger, 'blur' | 'change'>): void => {\n    if (validateOn?.value === on) options.getFormField?.()?.reportValidity();\n  };\n\n  // ── Label + ARIA state ────────────────────────────────────────────────────\n  const labelId = createStableId('label');\n  const errorId = createStableId('error');\n\n  const label$ = options.label ?? computed(() => undefined);\n\n  // Slot-first composition: if the caller provides `hasLabel`, use it instead\n  // of deriving visibility purely from the label text signal. This allows\n  // components with a `<slot name=\"label\">` to stay visible even when the\n  // `label` prop is empty but a slotted label element is present.\n  const labelVisible$ = options.hasLabel ?? computed(() => Boolean(label$.value));\n\n  const resolvedAssistive = createErrorHelperState({ error: options.error, helper: options.helper });\n\n  const ariaDescribedBy = computed(() =>\n    resolvedAssistive.value.errorText || resolvedAssistive.value.helperText ? assistiveId : null,\n  );\n  const ariaErrorMessage = computed(() => (resolvedAssistive.value.errorText ? errorId : null));\n  const ariaInvalid = computed<'true' | null>(() => (resolvedAssistive.value.errorText ? 'true' : null));\n  const ariaLabelledBy = computed(() => (labelVisible$.value ? labelId : null));\n\n  return {\n    ariaDescribedBy,\n    ariaErrorMessage,\n    ariaInvalid,\n    ariaLabelledBy,\n    ariaProps: () => ({\n      'aria-describedby': ariaDescribedBy.value,\n      'aria-errormessage': ariaErrorMessage.value,\n      'aria-invalid': ariaInvalid.value,\n      'aria-labelledby': ariaLabelledBy.value,\n    }),\n    assistiveId,\n    disabled,\n    errorId,\n    errorText: computed(() => resolvedAssistive.value.errorText),\n    fieldId,\n    helperText: computed(() => resolvedAssistive.value.helperText),\n    labelId,\n    labelVisible: labelVisible$,\n    triggerValidation,\n  };\n};\n"],"mappings":";;;AAoEA,IAAa,KAA0B,MACrC,SAAgB;CACd,WAAW,EAAQ,OAAO,SAAS;CACnC,YAAY,EAAQ,QAAQ,SAAS;AACvC,EAAE,GAyBS,KAAsB,MACjC,QAA6B;CAC3B,IAAM,IAAQ,EAAQ,OAAO,SAAS,IAChC,IAAY,EAAQ,WAAW,OAC/B,IAAkB,OAAO,CAAS,GAClC,IAAiB,OAAO,SAAS,CAAe,KAAK,IAAkB,IAAI,IAAkB,MAC7F,IAAa,MAAmB,MAChC,IAAc,IAAa,GAAG,EAAM,OAAO,KAAK,MAAmB,IACnE,IAAQ,IAAa,EAAM,SAAS,IAAiB;CAE3D,OAAO;EACL,gBAAgB,IAAa,KAAS,IAAI;EAC1C,kBAAkB,IAAa,KAAS,MAAO,IAAQ,IAAI;EAC3D;CACF;AACF,CAAC,GA4EU,KAAe,MAAuC;CAEjE,IAAM,IAAW,QAAe,EAAQ,EAAQ,UAAU,KAAM,GAC1D,IAAa,EAAQ,YACrB,IAAU,EAAQ,MAAM,EAAe,EAAQ,UAAU,OAAO,GAChE,IAAc,EAAe,QAAQ,GAErC,KAAqB,MAA4D;EACrF,AAAI,GAAY,UAAU,KAAI,EAAQ,eAAe,CAAC,EAAE,eAAe;CACzE,GAGM,IAAU,EAAe,OAAO,GAChC,IAAU,EAAe,OAAO,GAEhC,IAAS,EAAQ,SAAS,QAAe,KAAA,CAAS,GAMlD,IAAgB,EAAQ,YAAY,QAAe,EAAQ,EAAO,KAAM,GAExE,IAAoB,EAAuB;EAAE,OAAO,EAAQ;EAAO,QAAQ,EAAQ;CAAO,CAAC,GAE3F,IAAkB,QACtB,EAAkB,MAAM,aAAa,EAAkB,MAAM,aAAa,IAAc,IAC1F,GACM,IAAmB,QAAgB,EAAkB,MAAM,YAAY,IAAU,IAAK,GACtF,IAAc,QAA+B,EAAkB,MAAM,YAAY,SAAS,IAAK,GAC/F,IAAiB,QAAgB,EAAc,QAAQ,IAAU,IAAK;CAE5E,OAAO;EACL;EACA;EACA;EACA;EACA,kBAAkB;GAChB,oBAAoB,EAAgB;GACpC,qBAAqB,EAAiB;GACtC,gBAAgB,EAAY;GAC5B,mBAAmB,EAAe;EACpC;EACA;EACA;EACA;EACA,WAAW,QAAe,EAAkB,MAAM,SAAS;EAC3D;EACA,YAAY,QAAe,EAAkB,MAAM,UAAU;EAC7D;EACA,cAAc;EACd;CACF;AACF"}

package/dist/headless/focus-trap.cjs

@@ -0,0 +1,2 @@
+var e=[`a[href]`,`area[href]`,`button:not([disabled])`,`details > summary:not([disabled])`,`iframe`,`input:not([disabled])`,`select:not([disabled])`,`textarea:not([disabled])`,`[contenteditable]:not([contenteditable="false"])`,`[tabindex]:not([tabindex="-1"])`,`[role="button"]:not([disabled]):not([aria-disabled="true"])`,`[role="link"]:not([aria-disabled="true"])`,`[role="menuitem"]:not([aria-disabled="true"])`,`[role="menuitemcheckbox"]:not([aria-disabled="true"])`,`[role="menuitemradio"]:not([aria-disabled="true"])`,`[role="option"]:not([aria-disabled="true"])`,`[role="tab"]:not([aria-disabled="true"])`].join(`,`),t=(t,n={})=>{let r=!1,i=()=>{let n=t();return n?Array.from(n.querySelectorAll(e)).filter(e=>!e.closest(`[aria-hidden="true"]`)&&!e.closest(`[hidden]`)&&!e.closest(`[inert]`)):[]},a=e=>{if(!r||n.enabled?.()===!1||e.key!==`Tab`)return;let t=i();if(t.length===0){e.preventDefault();return}let a=t[0],o=t[t.length-1],s=e.target??document.activeElement;e.shiftKey?(s===a||!t.includes(s))&&(e.preventDefault(),o.focus()):(s===o||!t.includes(s))&&(e.preventDefault(),a.focus())},o=()=>{r||(r=!0,document.addEventListener(`keydown`,a,!0))},s=()=>{r&&(r=!1,document.removeEventListener(`keydown`,a,!0))};return n.signal&&!n.signal.aborted&&n.signal.addEventListener(`abort`,s,{once:!0}),{activate:o,get active(){return r},deactivate:s,dispose:s,[Symbol.dispose]:s}};exports.createFocusTrap=t;
+//# sourceMappingURL=focus-trap.cjs.map

package/dist/headless/focus-trap.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-trap.cjs","names":[],"sources":["../../src/headless/focus-trap.ts"],"sourcesContent":["// ── Focus Trap ────────────────────────────────────────────────────────────────\n// Implements the WAI-ARIA modal dialog focus-containment pattern.\n//\n// When active, Tab/Shift-Tab wrap within the container's focusable descendants\n// instead of leaving it. The focusable list is re-queried on every Tab keydown\n// so DOM changes (e.g. lazy-rendered content) are always reflected without a\n// MutationObserver.\n//\n// Usage (inside a ore component):\n// ```ts\n// const trap = createFocusTrap(() => dialogEl);\n// onOpen: () => trap.activate(),\n// onClose: () => trap.deactivate(),\n// ```\n\n// ── Constants ─────────────────────────────────────────────────────────────────\n\n/**\n * CSS selector matching all focusable elements, including:\n * - Native HTML interactive elements\n * - Elements with explicit `tabindex` (covers custom elements that correctly manage focus)\n * - Custom elements using ARIA interactive roles that are inherently focusable\n *   but may not carry a native `tabindex` attribute\n *\n * Note: `[tabindex]:not([tabindex=\"-1\"])` already covers any element that\n * explicitly opts into the tab order. The ARIA role selectors below additionally\n * capture elements that rely on the implicit focusability of their role\n * without a redundant `tabindex=\"0\"` attribute.\n */\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'area[href]',\n  'button:not([disabled])',\n  'details > summary:not([disabled])',\n  'iframe',\n  'input:not([disabled])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  // ARIA interactive roles that should participate in focus order.\n  // These cover custom components that set role but not explicit tabindex.\n  '[role=\"button\"]:not([disabled]):not([aria-disabled=\"true\"])',\n  '[role=\"link\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitem\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitemcheckbox\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitemradio\"]:not([aria-disabled=\"true\"])',\n  '[role=\"option\"]:not([aria-disabled=\"true\"])',\n  '[role=\"tab\"]:not([aria-disabled=\"true\"])',\n  // Note: [role=\"gridcell\"] and [role=\"row\"] are intentionally omitted — they\n  // participate in focus order only when an explicit tabindex is set, which is\n  // already caught by the [tabindex]:not([tabindex=\"-1\"]) selector above.\n].join(',');\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type FocusTrapOptions = {\n  /**\n   * When provided, the trap only processes events when this returns `true`.\n   * Useful to pause trapping while an inner dialog is open.\n   */\n  enabled?: () => boolean;\n  /**\n   * Optional `AbortSignal`. When aborted, `deactivate()` is called automatically.\n   * Prevents global `keydown` listener leaks if the component is destroyed while\n   * the trap is still active.\n   */\n  signal?: AbortSignal;\n};\n\nexport type FocusTrap = {\n  [Symbol.dispose](): void;\n  /** Start trapping Tab/Shift-Tab. Safe to call when already active. */\n  activate(): void;\n  /** Whether the trap is currently active. */\n  readonly active: boolean;\n  /** Stop trapping. Safe to call when already inactive. */\n  deactivate(): void;\n  /** Alias for `deactivate()`. Conforms to the monorepo disposal convention. */\n  dispose(): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Creates a WAI-ARIA modal focus trap for a container element.\n *\n * When active, Tab wraps from the last focusable child to the first, and\n * Shift-Tab wraps in reverse. The focusable list is re-queried live on each\n * Tab keydown — no MutationObserver required.\n *\n * The container itself is queried lazily via `getContainer()` so it may be\n * `null` at construction time (the typical case when the container is inside\n * an initially-hidden overlay).\n *\n * @example\n * ```ts\n * const trap = createFocusTrap(() => dialogEl);\n *\n * onOpen: () => trap.activate(),\n * onClose: () => trap.deactivate(),\n * ```\n */\nexport const createFocusTrap = (\n  getContainer: () => HTMLElement | ShadowRoot | null,\n  options: FocusTrapOptions = {},\n): FocusTrap => {\n  let _active = false;\n\n  const getFocusable = (): HTMLElement[] => {\n    const container = getContainer();\n\n    if (!container) return [];\n\n    return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(\n      // Exclude elements hidden from the accessibility tree or removed from tab order.\n      // aria-hidden=\"true\" and [hidden] have long been standard; [inert] is the\n      // modern successor that browsers honour natively from 2022+.\n      (el) => !el.closest('[aria-hidden=\"true\"]') && !el.closest('[hidden]') && !el.closest('[inert]'),\n    );\n  };\n\n  const handleKeydown = (event: KeyboardEvent): void => {\n    if (!_active) return;\n\n    if (options.enabled?.() === false) return;\n\n    if (event.key !== 'Tab') return;\n\n    const focusable = getFocusable();\n\n    if (focusable.length === 0) {\n      // Prevent focus from escaping the empty container.\n      event.preventDefault();\n\n      return;\n    }\n\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    // Prefer event.target over document.activeElement: the capture-phase handler\n    // fires before focus has moved in some environments (e.g. jsdom).\n    const current = (event.target as HTMLElement) ?? document.activeElement;\n\n    if (event.shiftKey) {\n      // Shift+Tab from first (or outside) → wrap to last.\n      if (current === first || !focusable.includes(current as HTMLElement)) {\n        event.preventDefault();\n        last.focus();\n      }\n    } else {\n      // Tab from last (or outside) → wrap to first.\n      if (current === last || !focusable.includes(current as HTMLElement)) {\n        event.preventDefault();\n        first.focus();\n      }\n    }\n  };\n\n  const activate = (): void => {\n    if (_active) return;\n\n    _active = true;\n    document.addEventListener('keydown', handleKeydown, true);\n  };\n\n  const deactivate = (): void => {\n    if (!_active) return;\n\n    _active = false;\n    document.removeEventListener('keydown', handleKeydown, true);\n  };\n\n  if (options.signal && !options.signal.aborted) {\n    options.signal.addEventListener('abort', deactivate, { once: true });\n  }\n\n  return {\n    activate,\n    get active() {\n      return _active;\n    },\n    deactivate,\n    dispose: deactivate,\n    [Symbol.dispose]: deactivate,\n  };\n};\n"],"mappings":"AA6BA,IAAM,EAAqB,CACzB,UACA,aACA,yBACA,oCACA,SACA,wBACA,yBACA,2BACA,mDACA,kCAGA,8DACA,4CACA,gDACA,wDACA,qDACA,8CACA,0CAIF,CAAC,CAAC,KAAK,GAAG,EAmDG,GACX,EACA,EAA4B,CAAC,IACf,CACd,IAAI,EAAU,GAER,MAAoC,CACxC,IAAM,EAAY,EAAa,EAI/B,OAFK,EAEE,MAAM,KAAK,EAAU,iBAA8B,CAAkB,CAAC,CAAC,CAAC,OAI5E,GAAO,CAAC,EAAG,QAAQ,sBAAsB,GAAK,CAAC,EAAG,QAAQ,UAAU,GAAK,CAAC,EAAG,QAAQ,SAAS,CACjG,EAPuB,CAAC,CAQ1B,EAEM,EAAiB,GAA+B,CAKpD,GAJI,CAAC,GAED,EAAQ,UAAU,IAAM,IAExB,EAAM,MAAQ,MAAO,OAEzB,IAAM,EAAY,EAAa,EAE/B,GAAI,EAAU,SAAW,EAAG,CAE1B,EAAM,eAAe,EAErB,MACF,CAEA,IAAM,EAAQ,EAAU,GAClB,EAAO,EAAU,EAAU,OAAS,GAGpC,EAAW,EAAM,QAA0B,SAAS,cAEtD,EAAM,UAEJ,IAAY,GAAS,CAAC,EAAU,SAAS,CAAsB,KACjE,EAAM,eAAe,EACrB,EAAK,MAAM,IAIT,IAAY,GAAQ,CAAC,EAAU,SAAS,CAAsB,KAChE,EAAM,eAAe,EACrB,EAAM,MAAM,EAGlB,EAEM,MAAuB,CACvB,IAEJ,EAAU,GACV,SAAS,iBAAiB,UAAW,EAAe,EAAI,EAC1D,EAEM,MAAyB,CACxB,IAEL,EAAU,GACV,SAAS,oBAAoB,UAAW,EAAe,EAAI,EAC7D,EAMA,OAJI,EAAQ,QAAU,CAAC,EAAQ,OAAO,SACpC,EAAQ,OAAO,iBAAiB,QAAS,EAAY,CAAE,KAAM,EAAK,CAAC,EAG9D,CACL,WACA,IAAI,QAAS,CACX,OAAO,CACT,EACA,aACA,QAAS,GACR,OAAO,SAAU,CACpB,CACF"}

package/dist/headless/focus-trap.d.ts

@@ -0,0 +1,45 @@
+export type FocusTrapOptions = {
+    /**
+     * When provided, the trap only processes events when this returns `true`.
+     * Useful to pause trapping while an inner dialog is open.
+     */
+    enabled?: () => boolean;
+    /**
+     * Optional `AbortSignal`. When aborted, `deactivate()` is called automatically.
+     * Prevents global `keydown` listener leaks if the component is destroyed while
+     * the trap is still active.
+     */
+    signal?: AbortSignal;
+};
+export type FocusTrap = {
+    [Symbol.dispose](): void;
+    /** Start trapping Tab/Shift-Tab. Safe to call when already active. */
+    activate(): void;
+    /** Whether the trap is currently active. */
+    readonly active: boolean;
+    /** Stop trapping. Safe to call when already inactive. */
+    deactivate(): void;
+    /** Alias for `deactivate()`. Conforms to the monorepo disposal convention. */
+    dispose(): void;
+};
+/**
+ * Creates a WAI-ARIA modal focus trap for a container element.
+ *
+ * When active, Tab wraps from the last focusable child to the first, and
+ * Shift-Tab wraps in reverse. The focusable list is re-queried live on each
+ * Tab keydown — no MutationObserver required.
+ *
+ * The container itself is queried lazily via `getContainer()` so it may be
+ * `null` at construction time (the typical case when the container is inside
+ * an initially-hidden overlay).
+ *
+ * @example
+ * ```ts
+ * const trap = createFocusTrap(() => dialogEl);
+ *
+ * onOpen: () => trap.activate(),
+ * onClose: () => trap.deactivate(),
+ * ```
+ */
+export declare const createFocusTrap: (getContainer: () => HTMLElement | ShadowRoot | null, options?: FocusTrapOptions) => FocusTrap;
+//# sourceMappingURL=focus-trap.d.ts.map

package/dist/headless/focus-trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-trap.d.ts","sourceRoot":"","sources":["../../src/headless/focus-trap.ts"],"names":[],"mappings":"AAwDA,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,sEAAsE;IACtE,QAAQ,IAAI,IAAI,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,UAAU,IAAI,IAAI,CAAC;IACnB,8EAA8E;IAC9E,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAIF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAC1B,cAAc,MAAM,WAAW,GAAG,UAAU,GAAG,IAAI,EACnD,UAAS,gBAAqB,KAC7B,SAgFF,CAAC"}

package/dist/headless/focus-trap.js

@@ -0,0 +1,51 @@
+//#region src/headless/focus-trap.ts
+var e = [
+	"a[href]",
+	"area[href]",
+	"button:not([disabled])",
+	"details > summary:not([disabled])",
+	"iframe",
+	"input:not([disabled])",
+	"select:not([disabled])",
+	"textarea:not([disabled])",
+	"[contenteditable]:not([contenteditable=\"false\"])",
+	"[tabindex]:not([tabindex=\"-1\"])",
+	"[role=\"button\"]:not([disabled]):not([aria-disabled=\"true\"])",
+	"[role=\"link\"]:not([aria-disabled=\"true\"])",
+	"[role=\"menuitem\"]:not([aria-disabled=\"true\"])",
+	"[role=\"menuitemcheckbox\"]:not([aria-disabled=\"true\"])",
+	"[role=\"menuitemradio\"]:not([aria-disabled=\"true\"])",
+	"[role=\"option\"]:not([aria-disabled=\"true\"])",
+	"[role=\"tab\"]:not([aria-disabled=\"true\"])"
+].join(","), t = (t, n = {}) => {
+	let r = !1, i = () => {
+		let n = t();
+		return n ? Array.from(n.querySelectorAll(e)).filter((e) => !e.closest("[aria-hidden=\"true\"]") && !e.closest("[hidden]") && !e.closest("[inert]")) : [];
+	}, a = (e) => {
+		if (!r || n.enabled?.() === !1 || e.key !== "Tab") return;
+		let t = i();
+		if (t.length === 0) {
+			e.preventDefault();
+			return;
+		}
+		let a = t[0], o = t[t.length - 1], s = e.target ?? document.activeElement;
+		e.shiftKey ? (s === a || !t.includes(s)) && (e.preventDefault(), o.focus()) : (s === o || !t.includes(s)) && (e.preventDefault(), a.focus());
+	}, o = () => {
+		r || (r = !0, document.addEventListener("keydown", a, !0));
+	}, s = () => {
+		r && (r = !1, document.removeEventListener("keydown", a, !0));
+	};
+	return n.signal && !n.signal.aborted && n.signal.addEventListener("abort", s, { once: !0 }), {
+		activate: o,
+		get active() {
+			return r;
+		},
+		deactivate: s,
+		dispose: s,
+		[Symbol.dispose]: s
+	};
+};
+//#endregion
+export { t as createFocusTrap };
+
+//# sourceMappingURL=focus-trap.js.map

package/dist/headless/focus-trap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-trap.js","names":[],"sources":["../../src/headless/focus-trap.ts"],"sourcesContent":["// ── Focus Trap ────────────────────────────────────────────────────────────────\n// Implements the WAI-ARIA modal dialog focus-containment pattern.\n//\n// When active, Tab/Shift-Tab wrap within the container's focusable descendants\n// instead of leaving it. The focusable list is re-queried on every Tab keydown\n// so DOM changes (e.g. lazy-rendered content) are always reflected without a\n// MutationObserver.\n//\n// Usage (inside a ore component):\n// ```ts\n// const trap = createFocusTrap(() => dialogEl);\n// onOpen: () => trap.activate(),\n// onClose: () => trap.deactivate(),\n// ```\n\n// ── Constants ─────────────────────────────────────────────────────────────────\n\n/**\n * CSS selector matching all focusable elements, including:\n * - Native HTML interactive elements\n * - Elements with explicit `tabindex` (covers custom elements that correctly manage focus)\n * - Custom elements using ARIA interactive roles that are inherently focusable\n *   but may not carry a native `tabindex` attribute\n *\n * Note: `[tabindex]:not([tabindex=\"-1\"])` already covers any element that\n * explicitly opts into the tab order. The ARIA role selectors below additionally\n * capture elements that rely on the implicit focusability of their role\n * without a redundant `tabindex=\"0\"` attribute.\n */\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'area[href]',\n  'button:not([disabled])',\n  'details > summary:not([disabled])',\n  'iframe',\n  'input:not([disabled])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  // ARIA interactive roles that should participate in focus order.\n  // These cover custom components that set role but not explicit tabindex.\n  '[role=\"button\"]:not([disabled]):not([aria-disabled=\"true\"])',\n  '[role=\"link\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitem\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitemcheckbox\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitemradio\"]:not([aria-disabled=\"true\"])',\n  '[role=\"option\"]:not([aria-disabled=\"true\"])',\n  '[role=\"tab\"]:not([aria-disabled=\"true\"])',\n  // Note: [role=\"gridcell\"] and [role=\"row\"] are intentionally omitted — they\n  // participate in focus order only when an explicit tabindex is set, which is\n  // already caught by the [tabindex]:not([tabindex=\"-1\"]) selector above.\n].join(',');\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type FocusTrapOptions = {\n  /**\n   * When provided, the trap only processes events when this returns `true`.\n   * Useful to pause trapping while an inner dialog is open.\n   */\n  enabled?: () => boolean;\n  /**\n   * Optional `AbortSignal`. When aborted, `deactivate()` is called automatically.\n   * Prevents global `keydown` listener leaks if the component is destroyed while\n   * the trap is still active.\n   */\n  signal?: AbortSignal;\n};\n\nexport type FocusTrap = {\n  [Symbol.dispose](): void;\n  /** Start trapping Tab/Shift-Tab. Safe to call when already active. */\n  activate(): void;\n  /** Whether the trap is currently active. */\n  readonly active: boolean;\n  /** Stop trapping. Safe to call when already inactive. */\n  deactivate(): void;\n  /** Alias for `deactivate()`. Conforms to the monorepo disposal convention. */\n  dispose(): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Creates a WAI-ARIA modal focus trap for a container element.\n *\n * When active, Tab wraps from the last focusable child to the first, and\n * Shift-Tab wraps in reverse. The focusable list is re-queried live on each\n * Tab keydown — no MutationObserver required.\n *\n * The container itself is queried lazily via `getContainer()` so it may be\n * `null` at construction time (the typical case when the container is inside\n * an initially-hidden overlay).\n *\n * @example\n * ```ts\n * const trap = createFocusTrap(() => dialogEl);\n *\n * onOpen: () => trap.activate(),\n * onClose: () => trap.deactivate(),\n * ```\n */\nexport const createFocusTrap = (\n  getContainer: () => HTMLElement | ShadowRoot | null,\n  options: FocusTrapOptions = {},\n): FocusTrap => {\n  let _active = false;\n\n  const getFocusable = (): HTMLElement[] => {\n    const container = getContainer();\n\n    if (!container) return [];\n\n    return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(\n      // Exclude elements hidden from the accessibility tree or removed from tab order.\n      // aria-hidden=\"true\" and [hidden] have long been standard; [inert] is the\n      // modern successor that browsers honour natively from 2022+.\n      (el) => !el.closest('[aria-hidden=\"true\"]') && !el.closest('[hidden]') && !el.closest('[inert]'),\n    );\n  };\n\n  const handleKeydown = (event: KeyboardEvent): void => {\n    if (!_active) return;\n\n    if (options.enabled?.() === false) return;\n\n    if (event.key !== 'Tab') return;\n\n    const focusable = getFocusable();\n\n    if (focusable.length === 0) {\n      // Prevent focus from escaping the empty container.\n      event.preventDefault();\n\n      return;\n    }\n\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    // Prefer event.target over document.activeElement: the capture-phase handler\n    // fires before focus has moved in some environments (e.g. jsdom).\n    const current = (event.target as HTMLElement) ?? document.activeElement;\n\n    if (event.shiftKey) {\n      // Shift+Tab from first (or outside) → wrap to last.\n      if (current === first || !focusable.includes(current as HTMLElement)) {\n        event.preventDefault();\n        last.focus();\n      }\n    } else {\n      // Tab from last (or outside) → wrap to first.\n      if (current === last || !focusable.includes(current as HTMLElement)) {\n        event.preventDefault();\n        first.focus();\n      }\n    }\n  };\n\n  const activate = (): void => {\n    if (_active) return;\n\n    _active = true;\n    document.addEventListener('keydown', handleKeydown, true);\n  };\n\n  const deactivate = (): void => {\n    if (!_active) return;\n\n    _active = false;\n    document.removeEventListener('keydown', handleKeydown, true);\n  };\n\n  if (options.signal && !options.signal.aborted) {\n    options.signal.addEventListener('abort', deactivate, { once: true });\n  }\n\n  return {\n    activate,\n    get active() {\n      return _active;\n    },\n    deactivate,\n    dispose: deactivate,\n    [Symbol.dispose]: deactivate,\n  };\n};\n"],"mappings":";AA6BA,IAAM,IAAqB;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;AAIF,CAAC,CAAC,KAAK,GAAG,GAmDG,KACX,GACA,IAA4B,CAAC,MACf;CACd,IAAI,IAAU,IAER,UAAoC;EACxC,IAAM,IAAY,EAAa;EAI/B,OAFK,IAEE,MAAM,KAAK,EAAU,iBAA8B,CAAkB,CAAC,CAAC,CAAC,QAI5E,MAAO,CAAC,EAAG,QAAQ,wBAAsB,KAAK,CAAC,EAAG,QAAQ,UAAU,KAAK,CAAC,EAAG,QAAQ,SAAS,CACjG,IAPuB,CAAC;CAQ1B,GAEM,KAAiB,MAA+B;EAKpD,IAJI,CAAC,KAED,EAAQ,UAAU,MAAM,MAExB,EAAM,QAAQ,OAAO;EAEzB,IAAM,IAAY,EAAa;EAE/B,IAAI,EAAU,WAAW,GAAG;GAE1B,EAAM,eAAe;GAErB;EACF;EAEA,IAAM,IAAQ,EAAU,IAClB,IAAO,EAAU,EAAU,SAAS,IAGpC,IAAW,EAAM,UAA0B,SAAS;EAE1D,AAAI,EAAM,YAEJ,MAAY,KAAS,CAAC,EAAU,SAAS,CAAsB,OACjE,EAAM,eAAe,GACrB,EAAK,MAAM,MAIT,MAAY,KAAQ,CAAC,EAAU,SAAS,CAAsB,OAChE,EAAM,eAAe,GACrB,EAAM,MAAM;CAGlB,GAEM,UAAuB;EACvB,MAEJ,IAAU,IACV,SAAS,iBAAiB,WAAW,GAAe,EAAI;CAC1D,GAEM,UAAyB;EACxB,MAEL,IAAU,IACV,SAAS,oBAAoB,WAAW,GAAe,EAAI;CAC7D;CAMA,OAJI,EAAQ,UAAU,CAAC,EAAQ,OAAO,WACpC,EAAQ,OAAO,iBAAiB,SAAS,GAAY,EAAE,MAAM,GAAK,CAAC,GAG9D;EACL;EACA,IAAI,SAAS;GACX,OAAO;EACT;EACA;EACA,SAAS;GACR,OAAO,UAAU;CACpB;AACF"}

package/dist/headless/focus.cjs

@@ -0,0 +1,2 @@
+function e(e){let t=null,n=null;return{applyInitialFocus(){n!==null&&(cancelAnimationFrame(n),n=null);let t=e.getInitialFocusSelector();if(t){let r=e.host.shadowRoot??e.host,i=null;try{i=r.querySelector(t)}catch{return}i&&(n=requestAnimationFrame(()=>{n=null,i.focus()}))}},cancelInitialFocus(){n!==null&&(cancelAnimationFrame(n),n=null)},captureReturnFocus(){t=document.activeElement},restoreFocus(){e.getReturnFocus()!==!1&&t&&(t.focus(),t=null)}}}exports.createFocusManager=e;
+//# sourceMappingURL=focus.cjs.map

package/dist/headless/focus.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.cjs","names":[],"sources":["../../src/headless/focus.ts"],"sourcesContent":["// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type FocusManagerOptions = {\n  /**\n   * Returns the CSS selector for the element that should receive focus on open.\n   *\n   * **Security note:** this value is passed directly to `querySelector`. It must\n   * come from trusted developer-controlled configuration, never from raw user input.\n   */\n  getInitialFocusSelector: () => string | undefined;\n  /**\n   * Returns whether focus should be restored to the previously focused element\n   * on close. `undefined` or `true` means restore; `false` means skip.\n   */\n  getReturnFocus: () => boolean | undefined;\n  /** Host element used for `querySelector` when resolving the initial focus target. */\n  host: HTMLElement;\n};\n\nexport type FocusManager = {\n  /** Move focus to the element matching `getInitialFocusSelector` (deferred one frame). */\n  applyInitialFocus: () => void;\n  /** Cancel a pending `applyInitialFocus` rAF, if any. */\n  cancelInitialFocus: () => void;\n  /** Capture the currently focused element so it can be restored later. */\n  captureReturnFocus: () => void;\n  /** Restore focus to the element captured by `captureReturnFocus`. */\n  restoreFocus: () => void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Encapsulates the three-step focus lifecycle used by dialogs and drawers:\n * 1. Capture the element that triggered the open.\n * 2. Move focus inside the overlay (optionally to a specific element).\n * 3. Restore focus when the overlay closes.\n */\nexport function createFocusManager(options: FocusManagerOptions): FocusManager {\n  let returnFocusEl: HTMLElement | null = null;\n  let rafHandle: ReturnType<typeof requestAnimationFrame> | null = null;\n\n  return {\n    applyInitialFocus() {\n      if (rafHandle !== null) {\n        cancelAnimationFrame(rafHandle);\n        rafHandle = null;\n      }\n\n      const selector = options.getInitialFocusSelector();\n\n      if (selector) {\n        // Query the shadow root first (all refine components render into Shadow DOM),\n        // falling back to the host's light-DOM tree for non-Shadow contexts.\n        const root = options.host.shadowRoot ?? options.host;\n\n        let target: HTMLElement | null = null;\n\n        try {\n          target = root.querySelector<HTMLElement>(selector);\n        } catch {\n          // Malformed selector (SyntaxError) — skip initial focus rather than throw.\n          return;\n        }\n\n        if (target) {\n          rafHandle = requestAnimationFrame(() => {\n            rafHandle = null;\n            target.focus();\n          });\n        }\n      }\n    },\n\n    cancelInitialFocus() {\n      if (rafHandle !== null) {\n        cancelAnimationFrame(rafHandle);\n        rafHandle = null;\n      }\n    },\n\n    captureReturnFocus() {\n      returnFocusEl = document.activeElement as HTMLElement;\n    },\n\n    restoreFocus() {\n      if (options.getReturnFocus() !== false && returnFocusEl) {\n        returnFocusEl.focus();\n        returnFocusEl = null;\n      }\n    },\n  };\n}\n"],"mappings":"AAsCA,SAAgB,EAAmB,EAA4C,CAC7E,IAAI,EAAoC,KACpC,EAA6D,KAEjE,MAAO,CACL,mBAAoB,CACd,IAAc,OAChB,qBAAqB,CAAS,EAC9B,EAAY,MAGd,IAAM,EAAW,EAAQ,wBAAwB,EAEjD,GAAI,EAAU,CAGZ,IAAM,EAAO,EAAQ,KAAK,YAAc,EAAQ,KAE5C,EAA6B,KAEjC,GAAI,CACF,EAAS,EAAK,cAA2B,CAAQ,CACnD,MAAQ,CAEN,MACF,CAEI,IACF,EAAY,0BAA4B,CACtC,EAAY,KACZ,EAAO,MAAM,CACf,CAAC,EAEL,CACF,EAEA,oBAAqB,CACf,IAAc,OAChB,qBAAqB,CAAS,EAC9B,EAAY,KAEhB,EAEA,oBAAqB,CACnB,EAAgB,SAAS,aAC3B,EAEA,cAAe,CACT,EAAQ,eAAe,IAAM,IAAS,IACxC,EAAc,MAAM,EACpB,EAAgB,KAEpB,CACF,CACF"}

package/dist/headless/focus.d.ts

@@ -0,0 +1,34 @@
+export type FocusManagerOptions = {
+    /**
+     * Returns the CSS selector for the element that should receive focus on open.
+     *
+     * **Security note:** this value is passed directly to `querySelector`. It must
+     * come from trusted developer-controlled configuration, never from raw user input.
+     */
+    getInitialFocusSelector: () => string | undefined;
+    /**
+     * Returns whether focus should be restored to the previously focused element
+     * on close. `undefined` or `true` means restore; `false` means skip.
+     */
+    getReturnFocus: () => boolean | undefined;
+    /** Host element used for `querySelector` when resolving the initial focus target. */
+    host: HTMLElement;
+};
+export type FocusManager = {
+    /** Move focus to the element matching `getInitialFocusSelector` (deferred one frame). */
+    applyInitialFocus: () => void;
+    /** Cancel a pending `applyInitialFocus` rAF, if any. */
+    cancelInitialFocus: () => void;
+    /** Capture the currently focused element so it can be restored later. */
+    captureReturnFocus: () => void;
+    /** Restore focus to the element captured by `captureReturnFocus`. */
+    restoreFocus: () => void;
+};
+/**
+ * Encapsulates the three-step focus lifecycle used by dialogs and drawers:
+ * 1. Capture the element that triggered the open.
+ * 2. Move focus inside the overlay (optionally to a specific element).
+ * 3. Restore focus when the overlay closes.
+ */
+export declare function createFocusManager(options: FocusManagerOptions): FocusManager;
+//# sourceMappingURL=focus.d.ts.map

package/dist/headless/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/headless/focus.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;;OAKG;IACH,uBAAuB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAClD;;;OAGG;IACH,cAAc,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1C,qFAAqF;IACrF,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,yFAAyF;IACzF,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,qEAAqE;IACrE,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAsD7E"}

package/dist/headless/focus.js

@@ -0,0 +1,34 @@
+//#region src/headless/focus.ts
+function e(e) {
+	let t = null, n = null;
+	return {
+		applyInitialFocus() {
+			n !== null && (cancelAnimationFrame(n), n = null);
+			let t = e.getInitialFocusSelector();
+			if (t) {
+				let r = e.host.shadowRoot ?? e.host, i = null;
+				try {
+					i = r.querySelector(t);
+				} catch {
+					return;
+				}
+				i && (n = requestAnimationFrame(() => {
+					n = null, i.focus();
+				}));
+			}
+		},
+		cancelInitialFocus() {
+			n !== null && (cancelAnimationFrame(n), n = null);
+		},
+		captureReturnFocus() {
+			t = document.activeElement;
+		},
+		restoreFocus() {
+			e.getReturnFocus() !== !1 && t && (t.focus(), t = null);
+		}
+	};
+}
+//#endregion
+export { e as createFocusManager };
+
+//# sourceMappingURL=focus.js.map

package/dist/headless/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","names":[],"sources":["../../src/headless/focus.ts"],"sourcesContent":["// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type FocusManagerOptions = {\n  /**\n   * Returns the CSS selector for the element that should receive focus on open.\n   *\n   * **Security note:** this value is passed directly to `querySelector`. It must\n   * come from trusted developer-controlled configuration, never from raw user input.\n   */\n  getInitialFocusSelector: () => string | undefined;\n  /**\n   * Returns whether focus should be restored to the previously focused element\n   * on close. `undefined` or `true` means restore; `false` means skip.\n   */\n  getReturnFocus: () => boolean | undefined;\n  /** Host element used for `querySelector` when resolving the initial focus target. */\n  host: HTMLElement;\n};\n\nexport type FocusManager = {\n  /** Move focus to the element matching `getInitialFocusSelector` (deferred one frame). */\n  applyInitialFocus: () => void;\n  /** Cancel a pending `applyInitialFocus` rAF, if any. */\n  cancelInitialFocus: () => void;\n  /** Capture the currently focused element so it can be restored later. */\n  captureReturnFocus: () => void;\n  /** Restore focus to the element captured by `captureReturnFocus`. */\n  restoreFocus: () => void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Encapsulates the three-step focus lifecycle used by dialogs and drawers:\n * 1. Capture the element that triggered the open.\n * 2. Move focus inside the overlay (optionally to a specific element).\n * 3. Restore focus when the overlay closes.\n */\nexport function createFocusManager(options: FocusManagerOptions): FocusManager {\n  let returnFocusEl: HTMLElement | null = null;\n  let rafHandle: ReturnType<typeof requestAnimationFrame> | null = null;\n\n  return {\n    applyInitialFocus() {\n      if (rafHandle !== null) {\n        cancelAnimationFrame(rafHandle);\n        rafHandle = null;\n      }\n\n      const selector = options.getInitialFocusSelector();\n\n      if (selector) {\n        // Query the shadow root first (all refine components render into Shadow DOM),\n        // falling back to the host's light-DOM tree for non-Shadow contexts.\n        const root = options.host.shadowRoot ?? options.host;\n\n        let target: HTMLElement | null = null;\n\n        try {\n          target = root.querySelector<HTMLElement>(selector);\n        } catch {\n          // Malformed selector (SyntaxError) — skip initial focus rather than throw.\n          return;\n        }\n\n        if (target) {\n          rafHandle = requestAnimationFrame(() => {\n            rafHandle = null;\n            target.focus();\n          });\n        }\n      }\n    },\n\n    cancelInitialFocus() {\n      if (rafHandle !== null) {\n        cancelAnimationFrame(rafHandle);\n        rafHandle = null;\n      }\n    },\n\n    captureReturnFocus() {\n      returnFocusEl = document.activeElement as HTMLElement;\n    },\n\n    restoreFocus() {\n      if (options.getReturnFocus() !== false && returnFocusEl) {\n        returnFocusEl.focus();\n        returnFocusEl = null;\n      }\n    },\n  };\n}\n"],"mappings":";AAsCA,SAAgB,EAAmB,GAA4C;CAC7E,IAAI,IAAoC,MACpC,IAA6D;CAEjE,OAAO;EACL,oBAAoB;GAClB,AAAI,MAAc,SAChB,qBAAqB,CAAS,GAC9B,IAAY;GAGd,IAAM,IAAW,EAAQ,wBAAwB;GAEjD,IAAI,GAAU;IAGZ,IAAM,IAAO,EAAQ,KAAK,cAAc,EAAQ,MAE5C,IAA6B;IAEjC,IAAI;KACF,IAAS,EAAK,cAA2B,CAAQ;IACnD,QAAQ;KAEN;IACF;IAEA,AAAI,MACF,IAAY,4BAA4B;KAEtC,AADA,IAAY,MACZ,EAAO,MAAM;IACf,CAAC;GAEL;EACF;EAEA,qBAAqB;GACnB,AAAI,MAAc,SAChB,qBAAqB,CAAS,GAC9B,IAAY;EAEhB;EAEA,qBAAqB;GACnB,IAAgB,SAAS;EAC3B;EAEA,eAAe;GACb,AAAI,EAAQ,eAAe,MAAM,MAAS,MACxC,EAAc,MAAM,GACpB,IAAgB;EAEpB;CACF;AACF"}

package/dist/headless/index.d.ts

@@ -0,0 +1,28 @@
+export { lifecycleSignal } from './ore';
+export { createErrorHelperState, type AriaProps, type ControlValidationMode, type CounterOptions, type CounterState, type ErrorHelperOptions, type ErrorHelperState, type FieldHandle, type FieldOptions, type LabelPlacement, type ValidationTrigger, } from './field-base';
+export { createTextField, type TextFieldDetach, type TextFieldHandle, type TextFieldOptions } from './text-field';
+export { createChoiceField, type ChoiceChangeDetail, type ChoiceFieldHandle, type ChoiceFieldOptions, } from './choice-field';
+export { createCheckable, type CheckableChangePayload, type CheckableHandle, type CheckableOptions } from './checkable';
+export { type DialogCloseReason, type DropdownCloseReason, type OverlayCloseDetail, type OverlayControl, type OverlayOpenDetail, type OverlayOpenReason, } from './overlay';
+export { createOptionList, type BaseOptionItem, type OptionListHandle, type OptionListOptions, type PlacementOptions, } from './option-list';
+export { createPaginatedList, type PaginatedListHandle, type PaginatedListOptions } from './paginated-list';
+export { type ListKeyAction, type ListNavigationAction } from './nav';
+export { createSpinnerControl, type SpinnerControl, type SpinnerControlOptions } from './spinner';
+export { createSliderControl, type SliderControl, type SliderControlOptions } from './slider';
+export { createSwipeControl, type SwipeAxis, type SwipeControl, type SwipeControlDetail, type SwipeControlOptions, } from './swipe';
+export { announce, type AnnouncePoliteness, type AnnounceOptions } from './announcer';
+export { createDatePickerControl, formatDisplayDate, parseIso, toIsoString, type DateCell, type DatePickerControl, type DatePickerControlOptions, type DatePickerView, type MonthCell, type YearCell, } from './date-picker';
+export { createDialogFocusControl, type DialogFocusControl, type DialogFocusControlOptions } from './dialog-focus';
+export { getChoiceLabel, getLightChildrenByTag } from './light-dom';
+export { toFiniteNumber, toFiniteNumberOr, toPositiveStep } from './numbers';
+export { createDataGridControl, type DataGridColumn, type DataGridControl, type DataGridControlOptions, type SelectionMode, type SortDirection, type SortState, } from './datagrid';
+export { createDropdownPositioner, type DropdownPositionerOptions, type OverlayPositioner } from './positioner';
+export { createInteraction, dispatchKeyboardAction, type Interaction, type InteractionOptions, type KeyboardDispatchOptions, type PressTrigger, } from './keyboard';
+export { createListControl, type ListControl, type ListNavigationOptions } from './nav';
+export { createOverlayControl, type OverlayControlOptions } from './overlay';
+export { createSelectionControl, type SelectionControl, type SelectionControlOptions } from './selection-control';
+export { createSortControl, type SortControl, type SortControlOptions } from './sort-control';
+export { createTypeahead, type Typeahead, type TypeaheadOptions } from './typeahead';
+export { parseStringTriggers } from './parse';
+export { syncedSignal } from './signals';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/headless/keyboard.cjs

@@ -0,0 +1,2 @@
+var e=(e,t)=>{if(t.disabled?.value)return!1;let n=Object.hasOwn(t.keymap,e.key)?t.keymap[e.key]:void 0;if(!n)return!1;let r=t.preventDefault??`before`;r===`before`&&e.preventDefault();let i=n(e)!==!1;return r===`after`&&i&&e.preventDefault(),i},t=t=>{let n=()=>!!t.disabled?.value,r=t.keys??[`Enter`,` `],i=Object.fromEntries(r.map(e=>[e,e=>t.onPress?.(e,`keyboard`)]));return{handleBlur:e=>{n()||t.onBlur?.(e)},handleClick:e=>n()?!1:(t.onPress?.(e,`pointer`),!0),handleFocus:e=>{n()||t.onFocus?.(e)},handleKeydown:n=>e(n,{disabled:t.disabled,keymap:i})}};exports.createInteraction=t,exports.dispatchKeyboardAction=e;
+//# sourceMappingURL=keyboard.cjs.map

package/dist/headless/keyboard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.cjs","names":[],"sources":["../../src/headless/keyboard.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\n// ── Keyboard dispatch ─────────────────────────────────────────────────────────\n\nexport type KeyboardDispatchOptions = {\n  disabled?: Readable<boolean | undefined>;\n  keymap: Record<string, (event: KeyboardEvent) => boolean | void>;\n  preventDefault?: 'after' | 'before' | false;\n};\n\nexport const dispatchKeyboardAction = (event: KeyboardEvent, options: KeyboardDispatchOptions): boolean => {\n  if (options.disabled?.value) return false;\n\n  // `event.key` is attacker-influenceable on a synthetic KeyboardEvent (e.g. `new\n  // KeyboardEvent('keydown', { key: '__proto__' })`). Guard with `Object.hasOwn` so a\n  // crafted key name can never resolve to an inherited `Object.prototype` member\n  // (`__proto__`, `constructor`, `toString`, …) instead of `undefined`.\n  const action = Object.hasOwn(options.keymap, event.key) ? options.keymap[event.key] : undefined;\n\n  if (!action) return false;\n\n  const preventDefaultMode = options.preventDefault ?? 'before';\n\n  if (preventDefaultMode === 'before') event.preventDefault();\n\n  const handled = action(event) !== false;\n\n  if (preventDefaultMode === 'after' && handled) event.preventDefault();\n\n  return handled;\n};\n\n// ── Press control / Interaction ───────────────────────────────────────────────\n\nexport type PressTrigger = 'keyboard' | 'pointer';\n\n/**\n * Options for `createInteraction` — a unified press + focus/blur interaction\n * handler for accessible interactive elements.\n */\nexport type InteractionOptions = {\n  /** `true` when the element is disabled. All handlers become no-ops. */\n  disabled?: Readable<boolean | undefined>;\n  /** Keys that trigger a press. Defaults to `['Enter', ' ']`. */\n  keys?: string[];\n  /** Called when the element loses focus. */\n  onBlur?: (event: FocusEvent) => void;\n  /** Called when the element receives focus. */\n  onFocus?: (event: FocusEvent) => void;\n  /** Called when the element is pressed via keyboard or pointer. */\n  onPress?: (event: KeyboardEvent | MouseEvent, trigger: PressTrigger) => void;\n};\n\nexport type Interaction = {\n  handleBlur: (event: FocusEvent) => void;\n  handleClick: (event: MouseEvent) => boolean;\n  handleFocus: (event: FocusEvent) => void;\n  handleKeydown: (event: KeyboardEvent) => boolean;\n};\n\n/**\n * Creates a set of event handlers for an interactive element that responds to\n * keyboard and pointer presses, and optionally focus/blur events.\n *\n * @example\n * ```ts\n * const interaction = createInteraction({\n *   disabled: props.disabled,\n *   onPress: (event, trigger) => toggle(event),\n *   onFocus: (event) => setFocused(true),\n *   onBlur: (event) => setFocused(false),\n * });\n *\n * // In template:\n * // @click=\"${interaction.handleClick}\"\n * // @keydown=\"${interaction.handleKeydown}\"\n * // @focus=\"${interaction.handleFocus}\"\n * // @blur=\"${interaction.handleBlur}\"\n * ```\n */\nexport const createInteraction = (options: InteractionOptions): Interaction => {\n  const isDisabled = (): boolean => Boolean(options.disabled?.value);\n  const keyboardKeys = options.keys ?? ['Enter', ' '];\n  const keymap = Object.fromEntries(\n    keyboardKeys.map((key) => [key, (keyboardEvent: KeyboardEvent) => options.onPress?.(keyboardEvent, 'keyboard')]),\n  );\n\n  return {\n    handleBlur: (event: FocusEvent): void => {\n      if (!isDisabled()) options.onBlur?.(event);\n    },\n    handleClick: (event: MouseEvent): boolean => {\n      if (isDisabled()) return false;\n\n      options.onPress?.(event, 'pointer');\n\n      return true;\n    },\n    handleFocus: (event: FocusEvent): void => {\n      if (!isDisabled()) options.onFocus?.(event);\n    },\n    handleKeydown: (event: KeyboardEvent): boolean =>\n      dispatchKeyboardAction(event, { disabled: options.disabled, keymap }),\n  };\n};\n"],"mappings":"AAUA,IAAa,GAA0B,EAAsB,IAA8C,CACzG,GAAI,EAAQ,UAAU,MAAO,MAAO,GAMpC,IAAM,EAAS,OAAO,OAAO,EAAQ,OAAQ,EAAM,GAAG,EAAI,EAAQ,OAAO,EAAM,KAAO,IAAA,GAEtF,GAAI,CAAC,EAAQ,MAAO,GAEpB,IAAM,EAAqB,EAAQ,gBAAkB,SAEjD,IAAuB,UAAU,EAAM,eAAe,EAE1D,IAAM,EAAU,EAAO,CAAK,IAAM,GAIlC,OAFI,IAAuB,SAAW,GAAS,EAAM,eAAe,EAE7D,CACT,EAkDa,EAAqB,GAA6C,CAC7E,IAAM,MAA4B,EAAQ,EAAQ,UAAU,MACtD,EAAe,EAAQ,MAAQ,CAAC,QAAS,GAAG,EAC5C,EAAS,OAAO,YACpB,EAAa,IAAK,GAAQ,CAAC,EAAM,GAAiC,EAAQ,UAAU,EAAe,UAAU,CAAC,CAAC,CACjH,EAEA,MAAO,CACL,WAAa,GAA4B,CAClC,EAAW,GAAG,EAAQ,SAAS,CAAK,CAC3C,EACA,YAAc,GACR,EAAW,EAAU,IAEzB,EAAQ,UAAU,EAAO,SAAS,EAE3B,IAET,YAAc,GAA4B,CACnC,EAAW,GAAG,EAAQ,UAAU,CAAK,CAC5C,EACA,cAAgB,GACd,EAAuB,EAAO,CAAE,SAAU,EAAQ,SAAU,QAAO,CAAC,CACxE,CACF"}

package/dist/headless/keyboard.d.ts

@@ -0,0 +1,52 @@
+import type { Readable } from '@vielzeug/ripple';
+export type KeyboardDispatchOptions = {
+    disabled?: Readable<boolean | undefined>;
+    keymap: Record<string, (event: KeyboardEvent) => boolean | void>;
+    preventDefault?: 'after' | 'before' | false;
+};
+export declare const dispatchKeyboardAction: (event: KeyboardEvent, options: KeyboardDispatchOptions) => boolean;
+export type PressTrigger = 'keyboard' | 'pointer';
+/**
+ * Options for `createInteraction` — a unified press + focus/blur interaction
+ * handler for accessible interactive elements.
+ */
+export type InteractionOptions = {
+    /** `true` when the element is disabled. All handlers become no-ops. */
+    disabled?: Readable<boolean | undefined>;
+    /** Keys that trigger a press. Defaults to `['Enter', ' ']`. */
+    keys?: string[];
+    /** Called when the element loses focus. */
+    onBlur?: (event: FocusEvent) => void;
+    /** Called when the element receives focus. */
+    onFocus?: (event: FocusEvent) => void;
+    /** Called when the element is pressed via keyboard or pointer. */
+    onPress?: (event: KeyboardEvent | MouseEvent, trigger: PressTrigger) => void;
+};
+export type Interaction = {
+    handleBlur: (event: FocusEvent) => void;
+    handleClick: (event: MouseEvent) => boolean;
+    handleFocus: (event: FocusEvent) => void;
+    handleKeydown: (event: KeyboardEvent) => boolean;
+};
+/**
+ * Creates a set of event handlers for an interactive element that responds to
+ * keyboard and pointer presses, and optionally focus/blur events.
+ *
+ * @example
+ * ```ts
+ * const interaction = createInteraction({
+ *   disabled: props.disabled,
+ *   onPress: (event, trigger) => toggle(event),
+ *   onFocus: (event) => setFocused(true),
+ *   onBlur: (event) => setFocused(false),
+ * });
+ *
+ * // In template:
+ * // @click="${interaction.handleClick}"
+ * // @keydown="${interaction.handleKeydown}"
+ * // @focus="${interaction.handleFocus}"
+ * // @blur="${interaction.handleBlur}"
+ * ```
+ */
+export declare const createInteraction: (options: InteractionOptions) => Interaction;
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/headless/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/headless/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC;IACjE,cAAc,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC7C,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,OAAO,aAAa,EAAE,SAAS,uBAAuB,KAAG,OAoB/F,CAAC;AAIF,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAC9E,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;IAC5C,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACzC,aAAa,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;CAClD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,kBAAkB,KAAG,WAwB/D,CAAC"}