@alfadocs/ui-kit-debug 0.70.0 → 0.71.0

package/dist/_chunks/position-grid-CcvqHaKN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-grid-CcvqHaKN.js","sources":["../../src/components/position-grid/position-grid.agent.ts","../../src/components/position-grid/position-grid.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — PositionGrid.                                          */\n/*                                                                        */\n/* See `src/docs/26-agent-readiness.mdx` for the contract.                */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { PositionGridHandle } from './position-grid';\n\nexport const positionGridAgent: AgentAdapter<PositionGridHandle> = {\n  id: 'position-grid',\n  capabilities: ['select_single'],\n  state: {\n    value: {\n      type: 'string',\n      descriptionKey: 'ui.agent.positionGrid.state.value',\n      description:\n        'Currently selected position value (e.g. \"top-start\"), or empty string when none.',\n      read: (handle) => handle.getValue(),\n    },\n  },\n  actions: {\n    set_value: {\n      safety: 'write',\n      argsType: '{ value: string }',\n      argsSchema: {\n        type: 'object',\n        properties: { value: { type: 'string' } },\n        required: ['value'],\n      },\n      idempotent: true,\n      descriptionKey: 'ui.agent.positionGrid.actions.setValue',\n      description: 'Select the cell with the given position value.',\n      examples: [\n        {\n          args: { value: 'center' },\n          note: 'Selects the centre cell of the default 3×3 grid.',\n        },\n      ],\n      invoke: (handle, args: { value: string }) => {\n        handle.setValue(args.value);\n      },\n    },\n  },\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'position-grid',\n      description: 'Marks the PositionGrid root.',\n    },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description: 'Sourced from the id prop.',\n    },\n    item: {\n      attr: 'data-option-id',\n      description: 'Position value emitted on each rendered cell.',\n    },\n  },\n};\n","import { forwardRef, useMemo, useRef, useState } from 'react';\nimport * as RadixRadioGroup from '@radix-ui/react-radio-group';\nimport { cva } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { useDirection } from '../_shared/use-direction';\nimport { composeRefs } from '../_shared/compose-refs';\nimport { useAgentRegistration } from '../../agent';\nimport { positionGridAgent } from './position-grid.agent';\n\n/** Agent-readiness curated handle for PositionGrid. */\nexport interface PositionGridHandle {\n  getValue: () => string;\n  setValue: (value: string) => void;\n  focus: () => void;\n}\n\n/** One selectable cell in the grid. */\nexport interface PositionGridOption {\n  /** Stable value emitted on selection (logical, e.g. `top-start`). */\n  value: string;\n  /** Accessible name for the cell — sighted users read the dot's position. */\n  label: string;\n}\n\nexport interface PositionGridProps {\n  /** Controlled selected value. Pair with onChange. */\n  value?: string;\n  /** Uncontrolled initial value. */\n  defaultValue?: string;\n  /** Fires with the newly-selected value. */\n  onChange?: (value: string) => void;\n  /**\n   * Override the default 9-cell set. When omitted, the default 3×3 anchor grid\n   * renders with bundled `positionGrid.*` labels. Cells flow in array order\n   * across the three columns.\n   */\n  positions?: PositionGridOption[];\n  /** Native form name for the underlying radio group. */\n  name?: string;\n  /** Disables every cell. */\n  disabled?: boolean;\n  id?: string;\n  className?: string;\n  /** Group accessible name. Defaults to the bundled `positionGrid.groupLabel`. */\n  'aria-label'?: string;\n}\n\n/** Default 3×3 anchor set. `labelKey` resolves against the bundled\n *  `positionGrid` i18n root; values use logical start/end naming (never\n *  left/right), so the layout mirrors correctly under `dir=\"rtl\"`. */\nconst DEFAULT_POSITIONS: ReadonlyArray<{ value: string; labelKey: string }> = [\n  { value: 'top-start', labelKey: 'topStart' },\n  { value: 'top', labelKey: 'top' },\n  { value: 'top-end', labelKey: 'topEnd' },\n  { value: 'start', labelKey: 'start' },\n  { value: 'center', labelKey: 'center' },\n  { value: 'end', labelKey: 'end' },\n  { value: 'bottom-start', labelKey: 'bottomStart' },\n  { value: 'bottom', labelKey: 'bottom' },\n  { value: 'bottom-end', labelKey: 'bottomEnd' },\n];\n\n// grid-cols-3 is intentional: the picker is a fixed-column anchor grid; custom\n// `positions` flow across the same three columns in array order.\nconst gridVariants = cva(\n  'ds:grid ds:grid-cols-3 ds:gap-[var(--spacing-2xs)] ds:w-fit',\n);\n\nconst cellVariants = cva(\n  [\n    'ds:group ds:relative ds:inline-flex ds:items-center ds:justify-center ds:shrink-0',\n    'ds:aspect-square ds:min-h-[var(--min-target-size)] ds:min-w-[var(--min-target-size)]',\n    'ds:rounded-[var(--radius-md)] ds:border ds:border-border ds:bg-background',\n    'ds:cursor-pointer',\n    'ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none',\n    'ds:hover:border-ring',\n    'ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid',\n    'ds:focus-visible:outline-ring ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]',\n    'ds:disabled:cursor-not-allowed ds:disabled:opacity-50',\n    'ds:data-[state=checked]:border-primary',\n    'ds:data-[state=checked]:bg-[color-mix(in_srgb,var(--accent)_8%,transparent)]',\n    'ds:data-[disabled]:border-muted',\n  ].join(' '),\n);\n\nconst markerVariants = cva(\n  [\n    'ds:size-2.5 ds:rounded-full ds:bg-muted-foreground',\n    'ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none',\n    'ds:group-data-[state=checked]:bg-primary',\n    'ds:group-data-[disabled]:bg-muted',\n  ].join(' '),\n);\n\nexport const PositionGrid = forwardRef<HTMLDivElement, PositionGridProps>(\n  function PositionGrid(\n    {\n      value,\n      defaultValue,\n      onChange,\n      positions,\n      name,\n      disabled,\n      id,\n      className,\n      'aria-label': ariaLabel,\n    },\n    ref,\n  ) {\n    const { t } = useTranslation();\n\n    const rootRef = useRef<HTMLDivElement>(null);\n    const composedRef = composeRefs(ref, rootRef);\n    // Pass the resolved direction to Radix so arrow-key navigation (and the\n    // CSS grid's inline flow) mirror correctly under dir=\"rtl\".\n    const dir = useDirection(rootRef);\n\n    const isControlled = value !== undefined;\n    const [internalValue, setInternalValue] = useState<string>(\n      defaultValue ?? '',\n    );\n    const currentValue = isControlled ? (value ?? '') : internalValue;\n    const currentValueRef = useRef<string>(currentValue);\n    currentValueRef.current = currentValue;\n\n    const items = useMemo<PositionGridOption[]>(\n      () =>\n        positions ??\n        DEFAULT_POSITIONS.map((p) => ({\n          value: p.value,\n          label: t(`positionGrid.${p.labelKey}`),\n        })),\n      [positions, t],\n    );\n\n    const groupLabel = ariaLabel ?? t('positionGrid.groupLabel');\n\n    const handleValueChange = (next: string) => {\n      if (!isControlled) setInternalValue(next);\n      onChange?.(next);\n    };\n\n    const agentHandle = useMemo<PositionGridHandle>(\n      () => ({\n        getValue: () => currentValueRef.current,\n        setValue: (next) => handleValueChange(next),\n        focus: () => {\n          const root = rootRef.current;\n          if (!root) return;\n          const checked = root.querySelector<HTMLElement>(\n            '[role=\"radio\"][aria-checked=\"true\"]',\n          );\n          const target =\n            checked ?? root.querySelector<HTMLElement>('[role=\"radio\"]');\n          target?.focus();\n        },\n      }),\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n      [isControlled, onChange],\n    );\n    useAgentRegistration(positionGridAgent, agentHandle, id);\n\n    return (\n      <RadixRadioGroup.Root\n        ref={composedRef}\n        id={id}\n        name={name}\n        dir={dir}\n        disabled={disabled}\n        value={isControlled ? value : undefined}\n        defaultValue={!isControlled ? defaultValue : undefined}\n        onValueChange={handleValueChange}\n        aria-label={groupLabel}\n        className={gridVariants({ className })}\n        data-component=\"position-grid\"\n        data-component-id={id}\n      >\n        {items.map((pos) => (\n          <RadixRadioGroup.Item\n            key={pos.value}\n            value={pos.value}\n            aria-label={pos.label}\n            data-option-id={pos.value}\n            className={cellVariants()}\n          >\n            <span aria-hidden=\"true\" className={markerVariants()} />\n          </RadixRadioGroup.Item>\n        ))}\n      </RadixRadioGroup.Root>\n    );\n  },\n);\n\nPositionGrid.displayName = 'PositionGrid';\n\nexport { gridVariants as positionGridVariants };\n"],"names":["positionGridAgent","handle","args","DEFAULT_POSITIONS","gridVariants","cva","cellVariants","markerVariants","PositionGrid","forwardRef","value","defaultValue","onChange","positions","name","disabled","id","className","ariaLabel","ref","t","useTranslation","rootRef","useRef","composedRef","composeRefs","dir","useDirection","isControlled","internalValue","setInternalValue","useState","currentValue","currentValueRef","items","useMemo","p","groupLabel","handleValueChange","next","agentHandle","root","target","useAgentRegistration","jsx","RadixRadioGroup","pos"],"mappings":"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"}

package/dist/_chunks/postal-code-input-UCOYuRY2.js

@@ -0,0 +1,192 @@
+import { jsxs as P, jsx as E } from "react/jsx-runtime";
+import { forwardRef as X, useRef as j, useId as Y, useState as N, useMemo as u, useEffect as Z, useCallback as S } from "react";
+import { useTranslation as ee } from "react-i18next";
+import { T as te } from "./text-input-B-OWQ1Je.js";
+import { u as oe } from "./form-field-context-B3APVHKx.js";
+import { c as se } from "./compose-refs-C0k0tdqF.js";
+import { u as re } from "./registry-DvAUVLHh.js";
+import { C as ne } from "./circle-alert-ChA9opNA.js";
+const ie = {
+  id: "postal-code-input",
+  capabilities: ["set_value"],
+  state: {
+    value: {
+      type: "string",
+      descriptionKey: "ui.agent.postalCodeInput.state.value",
+      description: "Current postal code value.",
+      read: (e) => e.getValue()
+    },
+    isEmpty: {
+      type: "boolean",
+      descriptionKey: "ui.agent.postalCodeInput.state.isEmpty",
+      description: "Whether the field has no value.",
+      read: (e) => e.getValue() === ""
+    }
+  },
+  actions: {
+    set_value: {
+      safety: "write",
+      argsType: "{ value: string }",
+      argsSchema: {
+        type: "object",
+        properties: { value: { type: "string" } },
+        required: ["value"]
+      },
+      idempotent: !0,
+      descriptionKey: "ui.agent.postalCodeInput.actions.setValue",
+      description: "Replace the postal code value.",
+      examples: [{ args: { value: "20121" }, note: "An Italian CAP." }],
+      invoke: (e, o) => {
+        e.setValue(o.value);
+      }
+    },
+    clear: {
+      safety: "destructive",
+      idempotent: !0,
+      descriptionKey: "ui.agent.postalCodeInput.actions.clear",
+      description: "Empty the field. Loses any typed value.",
+      invoke: (e) => {
+        e.clear();
+      }
+    }
+  },
+  domHooks: {
+    root: { attr: "data-component", value: "postal-code-input" },
+    instanceId: {
+      attr: "data-component-id",
+      sourceProp: "id",
+      description: "Sourced from the id prop."
+    }
+  }
+}, A = {
+  it: { pattern: /^\d{5}$/, inputMode: "numeric", maxLength: 5 }
+};
+function ae(e, o, s, r) {
+  if (s) return s(e, o);
+  if (e.length === 0) return !0;
+  const n = o ? A[o.toLowerCase()] : void 0;
+  return n ? n.pattern.test(e) : r ? r.test(e) : !0;
+}
+function k(e, o) {
+  var r;
+  if (!e) return;
+  const s = (r = Object.getOwnPropertyDescriptor(
+    HTMLInputElement.prototype,
+    "value"
+  )) == null ? void 0 : r.set;
+  s == null || s.call(e, o), e.dispatchEvent(new Event("input", { bubbles: !0 }));
+}
+const de = X(function({
+  country: o,
+  value: s,
+  defaultValue: r,
+  onValueChange: n,
+  validate: C,
+  pattern: f,
+  errorMessage: m,
+  onValidityChange: c,
+  onBlur: l,
+  id: v,
+  maxLength: K,
+  className: M,
+  "aria-describedby": R,
+  "aria-invalid": w,
+  ..._
+}, F) {
+  const { t: H } = ee(), g = oe(), p = j(null), V = se(F, p), h = Y(), d = s !== void 0, [$, B] = N(() => typeof s == "string" ? s : typeof r == "string" ? r : ""), i = d ? String(s) : $, [x, O] = N(
+    () => i.length > 0
+  ), a = o ? A[o.toLowerCase()] : void 0, L = u(() => {
+    if (f)
+      try {
+        return new RegExp(`^(?:${f})$`);
+      } catch {
+        return;
+      }
+  }, [f]), y = u(
+    () => ae(i, o, C, L),
+    [i, o, C, L]
+  ), I = x && i.length > 0 && !y, T = j(null);
+  Z(() => {
+    if (!x) return;
+    const t = i.length === 0 || y;
+    T.current !== t && (T.current = t, c == null || c(t));
+  }, [x, i, y, c]);
+  const U = S(
+    (t) => {
+      d || B(t.target.value), n == null || n(t.target.value);
+    },
+    [d, n]
+  ), q = S(
+    (t) => {
+      O(!0), l == null || l(t);
+    },
+    [l]
+  ), z = u(
+    () => ({
+      getValue: () => {
+        var t;
+        return ((t = p.current) == null ? void 0 : t.value) ?? "";
+      },
+      setValue: (t) => k(p.current, t),
+      clear: () => k(p.current, "")
+    }),
+    []
+  );
+  re(ie, z, v);
+  const b = I && m !== null, W = u(() => {
+    const t = [
+      R,
+      g.describedBy || void 0,
+      b ? h : null
+    ].filter(Boolean);
+    return t.length > 0 ? t.join(" ") : void 0;
+  }, [R, g.describedBy, b, h]), D = I ? "error" : "default", G = w === !0 || w === "true", J = I || g.invalid || G || void 0, Q = m !== void 0 ? m : H("inputs.postalCode.invalid", "Enter a valid postal code");
+  return /* @__PURE__ */ P(
+    "div",
+    {
+      "data-component": "postal-code-input",
+      "data-component-id": v,
+      className: ["ds:flex ds:flex-col ds:gap-[var(--spacing-xs)]", M].filter(Boolean).join(" "),
+      children: [
+        /* @__PURE__ */ E(
+          te,
+          {
+            ..._,
+            ref: V,
+            id: v,
+            type: "text",
+            inputMode: (a == null ? void 0 : a.inputMode) ?? "text",
+            autoComplete: "postal-code",
+            maxLength: K ?? (a == null ? void 0 : a.maxLength),
+            tone: D,
+            value: d ? i : void 0,
+            defaultValue: d ? void 0 : r,
+            onChange: U,
+            onBlur: q,
+            "aria-invalid": J,
+            "aria-describedby": W
+          }
+        ),
+        b ? /* @__PURE__ */ P(
+          "p",
+          {
+            id: h,
+            role: "alert",
+            "data-slot": "postal-code-input-error",
+            className: "ds:inline-flex ds:items-center ds:gap-[var(--spacing-xs)] type-body-sm ds:text-destructive",
+            children: [
+              /* @__PURE__ */ E(ne, { "aria-hidden": "true", className: "ds:size-4 ds:shrink-0" }),
+              /* @__PURE__ */ E("span", { children: Q })
+            ]
+          }
+        ) : null
+      ]
+    }
+  );
+});
+de.displayName = "PostalCodeInput";
+export {
+  de as P,
+  ie as p
+};
+//# sourceMappingURL=postal-code-input-UCOYuRY2.js.map

package/dist/_chunks/postal-code-input-UCOYuRY2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postal-code-input-UCOYuRY2.js","sources":["../../src/components/postal-code-input/postal-code-input.agent.ts","../../src/components/postal-code-input/postal-code-input.tsx"],"sourcesContent":["import type { AgentAdapter } from '../../agent/types';\n\nexport interface PostalCodeInputHandle {\n  getValue: () => string;\n  setValue: (value: string) => void;\n  clear: () => void;\n}\n\nexport const postalCodeInputAgent: AgentAdapter<PostalCodeInputHandle> = {\n  id: 'postal-code-input',\n  capabilities: ['set_value'],\n  state: {\n    value: {\n      type: 'string',\n      descriptionKey: 'ui.agent.postalCodeInput.state.value',\n      description: 'Current postal code value.',\n      read: (handle) => handle.getValue(),\n    },\n    isEmpty: {\n      type: 'boolean',\n      descriptionKey: 'ui.agent.postalCodeInput.state.isEmpty',\n      description: 'Whether the field has no value.',\n      read: (handle) => handle.getValue() === '',\n    },\n  },\n  actions: {\n    set_value: {\n      safety: 'write',\n      argsType: '{ value: string }',\n      argsSchema: {\n        type: 'object',\n        properties: { value: { type: 'string' } },\n        required: ['value'],\n      },\n      idempotent: true,\n      descriptionKey: 'ui.agent.postalCodeInput.actions.setValue',\n      description: 'Replace the postal code value.',\n      examples: [{ args: { value: '20121' }, note: 'An Italian CAP.' }],\n      invoke: (handle, args: { value: string }) => {\n        handle.setValue(args.value);\n      },\n    },\n    clear: {\n      safety: 'destructive',\n      idempotent: true,\n      descriptionKey: 'ui.agent.postalCodeInput.actions.clear',\n      description: 'Empty the field. Loses any typed value.',\n      invoke: (handle) => {\n        handle.clear();\n      },\n    },\n  },\n  domHooks: {\n    root: { attr: 'data-component', value: 'postal-code-input' },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description: 'Sourced from the id prop.',\n    },\n  },\n};\n","import {\n  forwardRef,\n  useCallback,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ChangeEvent,\n  type FocusEvent,\n  type ReactNode,\n} from 'react';\nimport { useTranslation } from 'react-i18next';\nimport { AlertCircle } from 'lucide-react';\nimport { TextInput, type TextInputProps } from '../text-input';\nimport { useFormField } from '../form-field/form-field-context';\nimport { composeRefs } from '../_shared/compose-refs';\nimport { useAgentRegistration } from '../../agent';\nimport {\n  postalCodeInputAgent,\n  type PostalCodeInputHandle,\n} from './postal-code-input.agent';\n\n/* ------------------------------------------------------------------ */\n/* Built-in rules                                                       */\n/*                                                                      */\n/* Intentionally tiny — Italy (CAP, 5 digits) only. Every other country */\n/* validates as \"non-empty\" unless the consumer supplies `validate` or  */\n/* `pattern`. Postal formats are a long tail; the seam is the contract, */\n/* the table is convenience. (Plan: IT only + seam.)                    */\n/* ------------------------------------------------------------------ */\n\ninterface PostalRule {\n  pattern: RegExp;\n  inputMode: 'numeric' | 'text';\n  maxLength: number;\n}\n\nconst BUILT_IN_RULES: Record<string, PostalRule> = {\n  it: { pattern: /^\\d{5}$/, inputMode: 'numeric', maxLength: 5 },\n};\n\nexport interface PostalCodeInputProps extends Omit<\n  TextInputProps,\n  | 'type'\n  | 'inputMode'\n  | 'autoComplete'\n  | 'value'\n  | 'defaultValue'\n  | 'onChange'\n  | 'tone'\n  | 'pattern'\n> {\n  /** ISO 3166-1 alpha-2 (lowercase). Drives format, length, and keyboard. */\n  country?: string;\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n  /** Override the built-in per-country validity rule entirely. */\n  validate?: (value: string, country?: string) => boolean;\n  /** Regex source applied when there's no `validate` and no built-in rule. */\n  pattern?: string;\n  /**\n   * Inline error message. Pass `null` to suppress the built-in message (e.g.\n   * when surfacing the error through a wrapping FormField).\n   */\n  errorMessage?: ReactNode | null;\n  /**\n   * Fires on blur (and on change after first blur) with the field's validity.\n   * NOTE: an empty value reports `true` — emptiness is `required`'s concern,\n   * not this field's. (EmailInput reports `false` for empty; gate \"required\"\n   * separately at the form level.)\n   */\n  onValidityChange?: (valid: boolean) => void;\n}\n\nfunction isValidFor(\n  value: string,\n  country: string | undefined,\n  validate: PostalCodeInputProps['validate'],\n  patternRegex: RegExp | undefined,\n): boolean {\n  if (validate) return validate(value, country);\n  if (value.length === 0) return true; // empty is `required`'s concern\n  const rule = country ? BUILT_IN_RULES[country.toLowerCase()] : undefined;\n  if (rule) return rule.pattern.test(value);\n  if (patternRegex) return patternRegex.test(value);\n  return true;\n}\n\n// Drive the DOM input through React's native value setter so an agent-set\n// value flows through the normal onChange path (mirrors TextInput's handle).\nfunction setNativeValue(input: HTMLInputElement | null, next: string): void {\n  if (!input) return;\n  const setter = Object.getOwnPropertyDescriptor(\n    HTMLInputElement.prototype,\n    'value',\n  )?.set;\n  setter?.call(input, next);\n  input.dispatchEvent(new Event('input', { bubbles: true }));\n}\n\nexport const PostalCodeInput = forwardRef<\n  HTMLInputElement,\n  PostalCodeInputProps\n>(function PostalCodeInput(\n  {\n    country,\n    value,\n    defaultValue,\n    onValueChange,\n    validate,\n    pattern,\n    errorMessage,\n    onValidityChange,\n    onBlur,\n    id,\n    maxLength,\n    className,\n    'aria-describedby': consumerDescribedBy,\n    'aria-invalid': consumerAriaInvalid,\n    ...rest\n  },\n  ref,\n) {\n  const { t } = useTranslation();\n  const ctx = useFormField();\n  const innerRef = useRef<HTMLInputElement | null>(null);\n  const composedRef = composeRefs(ref, innerRef);\n\n  // Private id for this component's own inline error. When a wrapping\n  // FormField also renders an error element, its id is already folded into\n  // `aria-describedby` via `ctx.describedBy` — so we must NOT reuse\n  // `ctx.errorId` here, or two `role=\"alert\"` elements would share one id.\n  const errorElementId = useId();\n\n  const isControlled = value !== undefined;\n  const [internalValue, setInternalValue] = useState<string>(() => {\n    if (typeof value === 'string') return value;\n    if (typeof defaultValue === 'string') return defaultValue;\n    return '';\n  });\n  const currentValue = isControlled ? String(value) : internalValue;\n\n  const [touched, setTouched] = useState<boolean>(\n    () => currentValue.length > 0,\n  );\n\n  const rule = country ? BUILT_IN_RULES[country.toLowerCase()] : undefined;\n\n  // Compile the consumer `pattern` once per pattern, not once per keystroke.\n  const patternRegex = useMemo(() => {\n    if (!pattern) return undefined;\n    try {\n      return new RegExp(`^(?:${pattern})$`);\n    } catch {\n      return undefined;\n    }\n  }, [pattern]);\n\n  const computedValid = useMemo(\n    () => isValidFor(currentValue, country, validate, patternRegex),\n    [currentValue, country, validate, patternRegex],\n  );\n\n  const shouldShowError = touched && currentValue.length > 0 && !computedValid;\n\n  const lastValidRef = useRef<boolean | null>(null);\n  useEffect(() => {\n    if (!touched) return;\n    const nextValid = currentValue.length === 0 || computedValid;\n    if (lastValidRef.current !== nextValid) {\n      lastValidRef.current = nextValid;\n      onValidityChange?.(nextValid);\n    }\n  }, [touched, currentValue, computedValid, onValidityChange]);\n\n  const handleChange = useCallback(\n    (event: ChangeEvent<HTMLInputElement>) => {\n      if (!isControlled) setInternalValue(event.target.value);\n      onValueChange?.(event.target.value);\n    },\n    [isControlled, onValueChange],\n  );\n\n  const handleBlur = useCallback(\n    (event: FocusEvent<HTMLInputElement>) => {\n      setTouched(true);\n      onBlur?.(event);\n    },\n    [onBlur],\n  );\n\n  const agentHandle = useMemo<PostalCodeInputHandle>(\n    () => ({\n      getValue: () => innerRef.current?.value ?? '',\n      setValue: (next) => setNativeValue(innerRef.current, next),\n      clear: () => setNativeValue(innerRef.current, ''),\n    }),\n    [],\n  );\n  useAgentRegistration(postalCodeInputAgent, agentHandle, id);\n\n  const showInlineError = shouldShowError && errorMessage !== null;\n  const describedBy = useMemo(() => {\n    const parts = [\n      consumerDescribedBy,\n      ctx.describedBy || undefined,\n      showInlineError ? errorElementId : null,\n    ].filter(Boolean) as string[];\n    return parts.length > 0 ? parts.join(' ') : undefined;\n  }, [consumerDescribedBy, ctx.describedBy, showInlineError, errorElementId]);\n\n  const effectiveTone = shouldShowError ? 'error' : 'default';\n  const consumerInvalid =\n    consumerAriaInvalid === true || consumerAriaInvalid === 'true';\n  const effectiveAriaInvalid =\n    shouldShowError || ctx.invalid || consumerInvalid || undefined;\n\n  const resolvedErrorMessage =\n    errorMessage !== undefined\n      ? errorMessage\n      : t('inputs.postalCode.invalid', 'Enter a valid postal code');\n\n  return (\n    <div\n      data-component=\"postal-code-input\"\n      data-component-id={id}\n      className={['ds:flex ds:flex-col ds:gap-[var(--spacing-xs)]', className]\n        .filter(Boolean)\n        .join(' ')}\n    >\n      <TextInput\n        {...rest}\n        ref={composedRef}\n        id={id}\n        type=\"text\"\n        inputMode={rule?.inputMode ?? 'text'}\n        autoComplete=\"postal-code\"\n        maxLength={maxLength ?? rule?.maxLength}\n        tone={effectiveTone}\n        value={isControlled ? currentValue : undefined}\n        defaultValue={!isControlled ? defaultValue : undefined}\n        onChange={handleChange}\n        onBlur={handleBlur}\n        aria-invalid={effectiveAriaInvalid}\n        aria-describedby={describedBy}\n      />\n      {showInlineError ? (\n        <p\n          id={errorElementId}\n          role=\"alert\"\n          data-slot=\"postal-code-input-error\"\n          className=\"ds:inline-flex ds:items-center ds:gap-[var(--spacing-xs)] type-body-sm ds:text-destructive\"\n        >\n          <AlertCircle aria-hidden=\"true\" className=\"ds:size-4 ds:shrink-0\" />\n          <span>{resolvedErrorMessage}</span>\n        </p>\n      ) : null}\n    </div>\n  );\n});\n\nPostalCodeInput.displayName = 'PostalCodeInput';\n"],"names":["postalCodeInputAgent","handle","args","BUILT_IN_RULES","isValidFor","value","country","validate","patternRegex","rule","setNativeValue","input","next","setter","_a","PostalCodeInput","forwardRef","defaultValue","onValueChange","pattern","errorMessage","onValidityChange","onBlur","id","maxLength","className","consumerDescribedBy","consumerAriaInvalid","rest","ref","t","useTranslation","ctx","useFormField","innerRef","useRef","composedRef","composeRefs","errorElementId","useId","isControlled","internalValue","setInternalValue","useState","currentValue","touched","setTouched","useMemo","computedValid","shouldShowError","lastValidRef","useEffect","nextValid","handleChange","useCallback","event","handleBlur","agentHandle","useAgentRegistration","showInlineError","describedBy","parts","effectiveTone","consumerInvalid","effectiveAriaInvalid","resolvedErrorMessage","jsxs","jsx","TextInput","AlertCircle"],"mappings":"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"}

package/dist/_chunks/{practice-results-C6qDfxos.js → practice-results-El5Z-oVp.js}

@@ -9,7 +9,7 @@ import { D as $ } from "./dropdown-menu-qrxjymfw.js";
 import { E as Je } from "./empty-state-BLy7tigq.js";
 import { M as We } from "./map-view-BkOoGoX2.js";
 import { R as Ce } from "./rating-BRD7O74e.js";
-import { S as I } from "./sheet-BxsE7eQm.js";
+import { S as I } from "./sheet-umkfZjF6.js";
 import { S as Xe } from "./skeleton-CZbwyJAA.js";
 import { S as Ye } from "./spinner-hbwuKwMf.js";
 import { B as L } from "./badge-DCOqV9mI.js";
@@ -1606,4 +1606,4 @@ export {
   Ct as P,
   rt as p
 };
-//# sourceMappingURL=practice-results-C6qDfxos.js.map
+//# sourceMappingURL=practice-results-El5Z-oVp.js.map