@hjmds/react 1.13.0 → 1.14.0

package/dist/field-group.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useLayoutEffect, useRef } from "react";
+import { createFieldGroupEditSession, resolveFieldGroup } from "@hjmds/design-contracts/field-group";
+/** Named related fields inside an existing form; never creates a submission boundary. */
+export function FieldGroup({ descriptor, renderField, layoutStyle }) {
+    const groupId = useId();
+    const resolved = resolveFieldGroup(descriptor);
+    const session = useRef(createFieldGroupEditSession(resolved.fields));
+    useLayoutEffect(() => { session.current.update(resolved.fields); return () => session.current.suspend(); }, [resolved.fields]);
+    const groupSupport = [resolved.description ? `${groupId}-description` : undefined, resolved.error ? `${groupId}-error` : undefined].filter(Boolean).join(" ") || undefined;
+    return _jsxs("fieldset", { disabled: resolved.disabled, "aria-describedby": groupSupport, style: { border: 0, margin: 0, padding: 0, minInlineSize: 0, ...layoutStyle }, children: [_jsx("legend", { style: { maxInlineSize: "100%", overflowWrap: "anywhere", marginBlockEnd: "var(--hjm-space-sm)" }, children: resolved.label }), resolved.description ? _jsx("p", { id: `${groupId}-description`, children: resolved.description }) : null, resolved.error ? _jsx("p", { id: `${groupId}-error`, role: "alert", style: { color: "var(--hjm-color-danger)" }, children: resolved.error }) : null, _jsx("div", { style: { display: "grid", gap: "var(--hjm-space-md)", minInlineSize: 0 }, children: resolved.fields.map(field => {
+                    // Encode product ids rather than indexes: reordering must preserve control identity and focus.
+                    const id = `${groupId}-field-${encodeURIComponent(field.id)}`;
+                    const supportId = (message) => message.scope === "group" ? `${groupId}-${message.kind}` : `${id}-${message.kind}`;
+                    const support = field.support.map(supportId).join(" ");
+                    return _jsxs("div", { style: { minInlineSize: 0 }, children: [renderField({ id: field.id, controlProps: { id, label: field.label, disabled: field.disabled, "aria-invalid": field.invalid,
+                                    ...(support ? { "aria-describedby": support } : {}) }, guardChange: callback => session.current.guard(field.id, callback) }), field.support.filter(message => message.scope === "field").map(message => _jsx("p", { id: supportId(message), ...(message.kind === "error" ? { role: "alert", style: { color: "var(--hjm-color-danger)" } } : {}), children: message.text }, message.kind))] }, field.id);
+                }) })] });
+}
+//# sourceMappingURL=field-group.js.map

package/dist/field-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-group.js","sourceRoot":"","sources":["../src/field-group.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAA6B,MAAM,qCAAqC,CAAC;AAchI,yFAAyF;AACzF,MAAM,UAAU,UAAU,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAmB;IAClF,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,2BAA2B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,eAAe,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/H,MAAM,YAAY,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,cAAc,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;IAC3K,OAAO,oBAAU,QAAQ,EAAE,QAAQ,CAAC,QAAQ,sBAAoB,YAAY,EAC1E,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,GAAG,WAAW,EAAE,aAC7E,iBAAQ,KAAK,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAG,QAAQ,CAAC,KAAK,GAAU,EACnI,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,YAAG,EAAE,EAAE,GAAG,OAAO,cAAc,YAAG,QAAQ,CAAC,WAAW,GAAK,CAAC,CAAC,CAAC,IAAI,EACzF,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,YAAG,EAAE,EAAE,GAAG,OAAO,QAAQ,EAAE,IAAI,EAAC,OAAO,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,YAAG,QAAQ,CAAC,KAAK,GAAK,CAAC,CAAC,CAAC,IAAI,EAClI,cAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,EAAE,aAAa,EAAE,CAAC,EAAE,YAC1E,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;oBAC3B,+FAA+F;oBAC/F,MAAM,EAAE,GAAG,GAAG,OAAO,UAAU,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC9D,MAAM,SAAS,GAAG,CAAC,OAAqC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBAChJ,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACvD,OAAO,eAAoB,KAAK,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,aACnD,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,OAAO;oCAC1H,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,EAC7H,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,YAAsB,EAAE,EAAE,SAAS,CAAC,OAAO,CAAC,KACjH,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAAG,OAAO,CAAC,IAAI,IADlC,OAAO,CAAC,IAAI,CAC2B,CAAC,KAJ5G,KAAK,CAAC,EAAE,CAKnB,CAAC;gBACT,CAAC,CAAC,GACE,IACG,CAAC;AACd,CAAC","sourcesContent":["import { useId, useLayoutEffect, useRef, type ReactNode } from \"react\";\nimport { createFieldGroupEditSession, resolveFieldGroup, type FieldGroupDescriptor } from \"@hjmds/design-contracts/field-group\";\nimport type { HjmCompositionStyleProp } from \"./composition-style.js\";\n\nexport type FieldGroupBinding = Readonly<{\n  id: string;\n  controlProps: Readonly<{ id: string; label: string; disabled: boolean; \"aria-invalid\": boolean; \"aria-describedby\"?: string }>;\n  guardChange: <Args extends unknown[]>(callback: (...args: Args) => void) => (...args: Args) => void;\n}>;\nexport type FieldGroupProps = Readonly<{\n  descriptor: FieldGroupDescriptor;\n  renderField: (field: FieldGroupBinding) => ReactNode;\n  layoutStyle?: HjmCompositionStyleProp;\n}>;\n\n/** Named related fields inside an existing form; never creates a submission boundary. */\nexport function FieldGroup({ descriptor, renderField, layoutStyle }: FieldGroupProps) {\n  const groupId = useId();\n  const resolved = resolveFieldGroup(descriptor);\n  const session = useRef(createFieldGroupEditSession(resolved.fields));\n  useLayoutEffect(() => { session.current.update(resolved.fields); return () => session.current.suspend(); }, [resolved.fields]);\n  const groupSupport = [resolved.description ? `${groupId}-description` : undefined, resolved.error ? `${groupId}-error` : undefined].filter(Boolean).join(\" \") || undefined;\n  return <fieldset disabled={resolved.disabled} aria-describedby={groupSupport}\n    style={{ border: 0, margin: 0, padding: 0, minInlineSize: 0, ...layoutStyle }}>\n    <legend style={{ maxInlineSize: \"100%\", overflowWrap: \"anywhere\", marginBlockEnd: \"var(--hjm-space-sm)\" }}>{resolved.label}</legend>\n    {resolved.description ? <p id={`${groupId}-description`}>{resolved.description}</p> : null}\n    {resolved.error ? <p id={`${groupId}-error`} role=\"alert\" style={{ color: \"var(--hjm-color-danger)\" }}>{resolved.error}</p> : null}\n    <div style={{ display: \"grid\", gap: \"var(--hjm-space-md)\", minInlineSize: 0 }}>\n      {resolved.fields.map(field => {\n        // Encode product ids rather than indexes: reordering must preserve control identity and focus.\n        const id = `${groupId}-field-${encodeURIComponent(field.id)}`;\n        const supportId = (message: typeof field.support[number]) => message.scope === \"group\" ? `${groupId}-${message.kind}` : `${id}-${message.kind}`;\n        const support = field.support.map(supportId).join(\" \");\n        return <div key={field.id} style={{ minInlineSize: 0 }}>\n          {renderField({ id: field.id, controlProps: { id, label: field.label, disabled: field.disabled, \"aria-invalid\": field.invalid,\n            ...(support ? { \"aria-describedby\": support } : {}) }, guardChange: callback => session.current.guard(field.id, callback) })}\n          {field.support.filter(message => message.scope === \"field\").map(message => <p key={message.kind} id={supportId(message)}\n            {...(message.kind === \"error\" ? { role: \"alert\", style: { color: \"var(--hjm-color-danger)\" } } : {})}>{message.text}</p>)}\n        </div>;\n      })}\n    </div>\n  </fieldset>;\n}\n"]}

package/dist/forms.d.ts

@@ -16,6 +16,7 @@ type FieldFrameProps = HTMLAttributes<HTMLDivElement> & FieldCopyProps & Readonl
     errorId?: string;
     disabled?: boolean;
     focused?: boolean;
+    invalid?: boolean;
     variant?: FieldVariant;
     shape?: FieldShape;
     align?: FieldAlign;

package/dist/forms.d.ts.map

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

package/dist/forms.js

@@ -12,8 +12,10 @@ import { composeRefs, classNames, useControllableState } from "./internal.js";
   module-private context instead of widening TextField's public props.
 */
 const FieldDisabledOpacityContext = createContext(undefined);
-function FieldFrame({ controlId, label, description, error, descriptionId, errorId, required = false, disabled = false, focused = false, variant = fieldRecipe.defaults.variant, shape = fieldRecipe.defaults.shape, align = fieldRecipe.defaults.align, disabledOpacity, className, children, layoutStyle, style, ...props }) {
-    const state = disabled ? "disabled" : error ? "invalid" : focused ? "focused" : "idle";
+function FieldFrame({ controlId, label, description, error, descriptionId, errorId, required = false, disabled = false, focused = false, invalid = false, variant = fieldRecipe.defaults.variant, shape = fieldRecipe.defaults.shape, align = fieldRecipe.defaults.align, disabledOpacity, className, children, layoutStyle, style, ...props }) {
+    // A grouped field may reference one external error; aria-invalid must still
+    // use the invalid recipe even when no inline error copy is repeated.
+    const state = disabled ? "disabled" : error || invalid ? "invalid" : focused ? "focused" : "idle";
     const inheritedOpacity = useContext(FieldDisabledOpacityContext);
     const recipeOpacity = disabledOpacity ?? inheritedOpacity;
     return (_jsxs("div", { ...props, 
@@ -87,7 +89,7 @@ export const TextField = forwardRef(function TextField({ id, label, description,
         setFocused(false);
         onBlur?.(event);
     };
-    return (_jsx(FieldFrame, { controlId: ids.controlId, label: label, description: description, error: error, required: required ?? false, disabled: disabled ?? false, focused: focused, variant: variant ?? fieldRecipe.defaults.variant, shape: shape ?? fieldRecipe.defaults.shape, align: align ?? fieldRecipe.defaults.align, className: fieldClassName, ...(layoutStyle === undefined ? {} : { layoutStyle }), ...(description ? { descriptionId: ids.descriptionId } : {}), ...(error ? { errorId: ids.errorId } : {}), children: _jsxs("div", { className: "hjm-field__control", children: [leading ? _jsx("span", { className: "hjm-field__affix", children: leading }) : null, _jsx("input", { ...props, ref: ref, id: ids.controlId, className: classNames("hjm-field__input", className), required: required, disabled: disabled, "aria-invalid": error ? true : ariaInvalid, "aria-label": ariaLabel, "aria-describedby": describedBy(ariaDescribedBy, description, error, ids.descriptionId, ids.errorId), onFocus: handleFocus, onBlur: handleBlur, onChange: (event) => {
+    return (_jsx(FieldFrame, { controlId: ids.controlId, label: label, description: description, error: error, required: required ?? false, disabled: disabled ?? false, focused: focused, invalid: ariaInvalid === true || ariaInvalid === "true", variant: variant ?? fieldRecipe.defaults.variant, shape: shape ?? fieldRecipe.defaults.shape, align: align ?? fieldRecipe.defaults.align, className: fieldClassName, ...(layoutStyle === undefined ? {} : { layoutStyle }), ...(description ? { descriptionId: ids.descriptionId } : {}), ...(error ? { errorId: ids.errorId } : {}), children: _jsxs("div", { className: "hjm-field__control", children: [leading ? _jsx("span", { className: "hjm-field__affix", children: leading }) : null, _jsx("input", { ...props, ref: ref, id: ids.controlId, className: classNames("hjm-field__input", className), required: required, disabled: disabled, "aria-invalid": error ? true : ariaInvalid, "aria-label": ariaLabel, "aria-describedby": describedBy(ariaDescribedBy, description, error, ids.descriptionId, ids.errorId), onFocus: handleFocus, onBlur: handleBlur, onChange: (event) => {
                         onChange?.(event);
                         onValueChange?.(event.currentTarget.value);
                     } }), trailing ? _jsx("span", { className: "hjm-field__affix", children: trailing }) : null] }) }));

package/dist/forms.js.map

@@ -1 +1 @@
-{"version":3,"file":"forms.js","sourceRoot":"","sources":["../src/forms.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  fieldRecipe,\n  type FieldAlign,\n  type FieldShape,\n  type FieldVariant,\n} from \"@hjmds/design-contracts/recipes/base\";\nimport {\n  iconRecipe,\n  searchFieldRecipe,\n  type SearchFieldSize,\n} from \"@hjmds/design-contracts/recipes\";\nimport {\n  passwordFieldRecipe,\n  resolvePasswordFieldDescriptor,\n  type PasswordFieldAutofillHint,\n  type PasswordFieldSize,\n} from \"@hjmds/design-contracts/components/password-field\";\nimport {\n  getOtpFieldSlotValues,\n  otpFieldRecipe,\n  resolveOtpFieldValue,\n  type OtpFieldSize,\n  type OtpFieldPresentation,\n} from \"@hjmds/design-contracts/components/otp-field\";\nimport {\n  createContext,\n  forwardRef,\n  useContext,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useRef,\n  useState,\n  type CSSProperties,\n  type FocusEvent,\n  type HTMLAttributes,\n  type InputHTMLAttributes,\n  type ReactNode,\n  type TextareaHTMLAttributes,\n} from \"react\";\nimport { composeRefs, classNames, useControllableState } from \"./internal.js\";\nimport type { HjmCompositionStyleProp } from \"./composition-style.js\";\n\ntype FieldCopyProps = Readonly<{\n  label?: ReactNode;\n  description?: ReactNode;\n  error?: ReactNode;\n  required?: boolean;\n}>;\n\ntype FieldFrameProps = HTMLAttributes<HTMLDivElement> &\n  FieldCopyProps &\n  Readonly<{\n    controlId: string;\n    descriptionId?: string;\n    errorId?: string;\n    disabled?: boolean;\n    focused?: boolean;\n    variant?: FieldVariant;\n    shape?: FieldShape;\n    align?: FieldAlign;\n    /** Component recipe override of fieldRecipe.disabledOpacity (OtpField). */\n    disabledOpacity?: number;\n    children: ReactNode;\n    /** Canonical layout-only placement on the field frame (`.hjm-field`), not the input. Controlled visual keys are excluded. */\n    layoutStyle?: HjmCompositionStyleProp;\n  }>;\n\n/*\n  How far a disabled field fades its label and control (fieldRecipe.disabledScope). The\n  frame defaults to fieldRecipe.disabledOpacity; SearchField and PasswordField render\n  through the public TextField, so they hand their own recipe value down this\n  module-private context instead of widening TextField's public props.\n*/\nconst FieldDisabledOpacityContext = createContext<number | undefined>(undefined);\n\nfunction FieldFrame({\n  controlId,\n  label,\n  description,\n  error,\n  descriptionId,\n  errorId,\n  required = false,\n  disabled = false,\n  focused = false,\n  variant = fieldRecipe.defaults.variant,\n  shape = fieldRecipe.defaults.shape,\n  align = fieldRecipe.defaults.align,\n  disabledOpacity,\n  className,\n  children,\n  layoutStyle,\n  style,\n  ...props\n}: FieldFrameProps) {\n  const state = disabled ? \"disabled\" : error ? \"invalid\" : focused ? \"focused\" : \"idle\";\n  const inheritedOpacity = useContext(FieldDisabledOpacityContext);\n  const recipeOpacity = disabledOpacity ?? inheritedOpacity;\n  return (\n    <div\n      {...props}\n      // The stylesheet fades the label and control with --hjm-field-disabled-opacity\n      // (theme value: fieldRecipe.disabledOpacity); a component recipe value is set\n      // here, only while disabled, so enabled roots keep their old inline style.\n      style={{\n        ...style,\n        ...layoutStyle,\n        ...(disabled && recipeOpacity !== undefined\n          ? ({ \"--hjm-field-disabled-opacity\": recipeOpacity } as CSSProperties)\n          : {}),\n      }}\n      className={classNames(\"hjm-field\", className)}\n      data-state={state}\n      data-variant={variant}\n      data-shape={shape}\n      data-align={align}\n    >\n      {label !== undefined && label !== null ? (\n        <label className=\"hjm-field__label\" htmlFor={controlId}>\n          {label}\n          {required ? <span aria-hidden=\"true\"> *</span> : null}\n        </label>\n      ) : null}\n      {children}\n      {/*\n        Support text stays visible under an error instead of being replaced by\n        it: the guidance (a length or format hint) is what tells the user how to clear the\n        error, and hiding it is why a product copied that sentence into its own\n        error string. Both are also referenced by aria-describedby.\n      */}\n      {description ? (\n        <div id={descriptionId} className=\"hjm-field__description\">\n          {description}\n        </div>\n      ) : null}\n      {error ? (\n        <div id={errorId} className=\"hjm-field__error\">\n          {error}\n        </div>\n      ) : null}\n    </div>\n  );\n}\n\nexport type FieldControlProps = Readonly<{\n  id: string;\n  required: boolean;\n  disabled: boolean;\n  \"aria-invalid\"?: true;\n  \"aria-describedby\"?: string;\n}>;\n\nexport type FieldProps = Omit<\n  FieldFrameProps,\n  \"children\" | \"descriptionId\" | \"errorId\" | \"disabledOpacity\"\n> &\n  Readonly<{\n    label: ReactNode;\n    children: ReactNode | ((props: FieldControlProps) => ReactNode);\n  }>;\n\n/** Generic frame for custom native controls; `controlId` keeps the label explicit. */\nexport function Field({\n  controlId,\n  description,\n  error,\n  required = false,\n  disabled = false,\n  children,\n  ...props\n}: FieldProps) {\n  const descriptionId = `${controlId}-description`;\n  const errorId = `${controlId}-error`;\n  const controlProps: FieldControlProps = {\n    id: controlId,\n    required,\n    disabled,\n    ...(error ? { \"aria-invalid\": true as const } : {}),\n    // Same merge as the built-in fields: support text stays referenced once an\n    // error appears, so a custom control does not have to re-derive the ids.\n    ...(description || error\n      ? {\n        \"aria-describedby\": [description ? descriptionId : undefined, error ? errorId : undefined]\n          .filter(Boolean)\n          .join(\" \"),\n      }\n      : {}),\n  };\n  return (\n    <FieldFrame\n      {...props}\n      controlId={controlId}\n      description={description}\n      error={error}\n      required={required}\n      disabled={disabled}\n      {...(description ? { descriptionId } : {})}\n      {...(error ? { errorId } : {})}\n    >\n      {typeof children === \"function\" ? children(controlProps) : children}\n    </FieldFrame>\n  );\n}\n\nfunction useFieldIds(id: string | undefined) {\n  const generatedId = useId();\n  const controlId = id ?? `hjm-${generatedId.replaceAll(\":\", \"\")}`;\n  return {\n    controlId,\n    descriptionId: `${controlId}-description`,\n    errorId: `${controlId}-error`,\n  } as const;\n}\n\n/*\n  Support text and the error are both referenced when both exist, in DOM reading\n  order, and the consumer's own `aria-describedby` is kept in front of them.\n  Announcing only the error (the earlier behaviour) dropped the guidance that\n  explains how to fix it — exactly the text a product then duplicated into the\n  error string by hand.\n*/\nfunction describedBy(\n  own: string | undefined,\n  description: ReactNode | undefined,\n  error: ReactNode | undefined,\n  descriptionId: string,\n  errorId: string,\n): string | undefined {\n  return [own, description ? descriptionId : undefined, error ? errorId : undefined]\n    .filter(Boolean)\n    .join(\" \") || undefined;\n}\n\nfunction requireFieldAccessibleName(label: ReactNode | undefined, ariaLabel: string | undefined) {\n  if ((label === undefined || label === null) && !ariaLabel?.trim()) {\n    throw new TypeError(\"Field controls require either label or aria-label\");\n  }\n}\n\ntype SharedInputProps = FieldCopyProps &\n  Readonly<{\n    variant?: FieldVariant;\n    shape?: FieldShape;\n    /**\n     * Text placement inside the control. `start` follows the resolved\n     * direction; `center` suits a short, ceremonial single value such as a\n     * nickname or a code. Replaces a `text-align` override.\n     */\n    align?: FieldAlign;\n    leading?: ReactNode;\n    trailing?: ReactNode;\n    fieldClassName?: string;\n    /**\n     * Canonical layout-only placement on the field frame. `style` keeps going to\n     * the input element, where it always went, so existing callers do not move.\n     */\n    layoutStyle?: HjmCompositionStyleProp;\n  }>;\n\nexport type TextFieldProps = Omit<InputHTMLAttributes<HTMLInputElement>, \"size\"> &\n  SharedInputProps &\n  Readonly<{\n    /**\n     * Receives the next string value, the same callback name and shape as the\n     * Native TextField and the Web TextArea. Before 1.5.0 Web TextField only had\n     * the DOM `onChange`, so shared form code needed a platform branch. Both\n     * fire; `onChange` stays for event access.\n     */\n    onValueChange?: (value: string) => void;\n  }>;\n\nexport const TextField = forwardRef<HTMLInputElement, TextFieldProps>(\n  function TextField(\n    {\n      id,\n      label,\n      description,\n      error,\n      required,\n      disabled,\n      variant,\n      shape,\n      align,\n      leading,\n      trailing,\n      fieldClassName,\n      className,\n      onFocus,\n      onBlur,\n      onChange,\n      onValueChange,\n      \"aria-describedby\": ariaDescribedBy,\n      \"aria-invalid\": ariaInvalid,\n      \"aria-label\": ariaLabel,\n      layoutStyle,\n      ...props\n    },\n    ref,\n  ) {\n    const ids = useFieldIds(id);\n    const [focused, setFocused] = useState(false);\n    requireFieldAccessibleName(label, ariaLabel);\n    const handleFocus = (event: FocusEvent<HTMLInputElement>) => {\n      setFocused(true);\n      onFocus?.(event);\n    };\n    const handleBlur = (event: FocusEvent<HTMLInputElement>) => {\n      setFocused(false);\n      onBlur?.(event);\n    };\n    return (\n      <FieldFrame\n        controlId={ids.controlId}\n        label={label}\n        description={description}\n        error={error}\n        required={required ?? false}\n        disabled={disabled ?? false}\n        focused={focused}\n        variant={variant ?? fieldRecipe.defaults.variant}\n        shape={shape ?? fieldRecipe.defaults.shape}\n        align={align ?? fieldRecipe.defaults.align}\n        className={fieldClassName}\n        {...(layoutStyle === undefined ? {} : { layoutStyle })}\n        {...(description ? { descriptionId: ids.descriptionId } : {})}\n        {...(error ? { errorId: ids.errorId } : {})}\n      >\n        <div className=\"hjm-field__control\">\n          {leading ? <span className=\"hjm-field__affix\">{leading}</span> : null}\n          <input\n            {...props}\n            ref={ref}\n            id={ids.controlId}\n            className={classNames(\"hjm-field__input\", className)}\n            required={required}\n            disabled={disabled}\n            aria-invalid={error ? true : ariaInvalid}\n            aria-label={ariaLabel}\n            aria-describedby={describedBy(\n              ariaDescribedBy,\n              description,\n              error,\n              ids.descriptionId,\n              ids.errorId,\n            )}\n            onFocus={handleFocus}\n            onBlur={handleBlur}\n            onChange={(event) => {\n              onChange?.(event);\n              onValueChange?.(event.currentTarget.value);\n            }}\n          />\n          {trailing ? <span className=\"hjm-field__affix\">{trailing}</span> : null}\n        </div>\n      </FieldFrame>\n    );\n  },\n);\n\nexport type TextAreaProps = TextareaHTMLAttributes<HTMLTextAreaElement> &\n  Omit<SharedInputProps, \"leading\"> &\n  Readonly<{\n    /**\n     * Action before the text inside the field frame (for example a composer's camera button),\n     * vertically centred while the text grows. Mirrors `trailing`; `leading` stays omitted because\n     * TextField's `leading` is a decorative affix with muted color, not an action slot.\n     */\n    leadingAction?: ReactNode;\n    /**\n     * Lower bound for a growing multiline field, in visible lines. Height is\n     * recipe-owned, so this semantic axis replaces a `min-height` override.\n     */\n    minVisibleLines?: number;\n    /** Upper bound for a growing multiline field, in visible lines. */\n    maxVisibleLines?: number;\n  }>;\n\nexport const TextArea = forwardRef<HTMLTextAreaElement, TextAreaProps>(\n  function TextArea(\n    {\n      id,\n      label,\n      description,\n      error,\n      required,\n      disabled,\n      variant,\n      shape,\n      trailing,\n      leadingAction,\n      align,\n      fieldClassName,\n      className,\n      onFocus,\n      onBlur,\n      \"aria-describedby\": ariaDescribedBy,\n      \"aria-invalid\": ariaInvalid,\n      \"aria-label\": ariaLabel,\n      minVisibleLines,\n      maxVisibleLines,\n      style,\n      layoutStyle,\n      ...props\n    },\n    ref,\n  ) {\n    const ids = useFieldIds(id);\n    const [focused, setFocused] = useState(false);\n    requireFieldAccessibleName(label, ariaLabel);\n    // Bounds are expressed in lines so the recipe keeps line height and padding.\n    const lineBounds = {\n      ...(minVisibleLines === undefined\n        ? {}\n        : { \"--hjm-field-min-visible-lines\": minVisibleLines }),\n      ...(maxVisibleLines === undefined\n        ? {}\n        : { \"--hjm-field-max-visible-lines\": maxVisibleLines }),\n    } as CSSProperties;\n    return (\n      <FieldFrame\n        controlId={ids.controlId}\n        label={label}\n        description={description}\n        error={error}\n        required={required ?? false}\n        disabled={disabled ?? false}\n        focused={focused}\n        variant={variant ?? fieldRecipe.defaults.variant}\n        shape={shape ?? fieldRecipe.defaults.shape}\n        align={align ?? fieldRecipe.defaults.align}\n        className={fieldClassName}\n        {...(layoutStyle === undefined ? {} : { layoutStyle })}\n        {...(description ? { descriptionId: ids.descriptionId } : {})}\n        {...(error ? { errorId: ids.errorId } : {})}\n      >\n        <div className=\"hjm-field__control hjm-field__control--multiline\">\n          {leadingAction ? <span className=\"hjm-field__leading\">{leadingAction}</span> : null}\n          <textarea\n            {...props}\n            ref={ref}\n            id={ids.controlId}\n            className={classNames(\"hjm-field__input\", className)}\n            style={{ ...style, ...lineBounds }}\n            required={required}\n            disabled={disabled}\n            aria-invalid={error ? true : ariaInvalid}\n            aria-label={ariaLabel}\n            aria-describedby={describedBy(\n              ariaDescribedBy,\n              description,\n              error,\n              ids.descriptionId,\n              ids.errorId,\n            )}\n            onFocus={(event) => {\n              setFocused(true);\n              onFocus?.(event);\n            }}\n            onBlur={(event) => {\n              setFocused(false);\n              onBlur?.(event);\n            }}\n          />\n          {trailing ? <span className=\"hjm-field__trailing\">{trailing}</span> : null}\n        </div>\n      </FieldFrame>\n    );\n  },\n);\n\nexport type SearchFieldProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  \"type\" | \"size\" | \"value\" | \"defaultValue\"\n> &\n  SharedInputProps &\n  Readonly<{\n    value?: string;\n    defaultValue?: string;\n    onValueChange?: (value: string) => void;\n    size?: SearchFieldSize;\n    /** Localized accessible name for the clear action. */\n    clearLabel: string;\n    onClear?: () => void;\n    /** Keeps the input mounted and named while replacing trailing actions with progress. */\n    loading?: boolean;\n    /** Product icon adapter; the renderer owns size and inherited color. */\n    renderSearchIcon?: (props: SearchFieldIconRenderProps) => ReactNode;\n    /** Product icon adapter for the clear action. */\n    renderClearIcon?: (props: SearchFieldIconRenderProps) => ReactNode;\n    /** Optional progress adapter. The default is the canonical CSS spinner. */\n    renderLoadingIndicator?: (props: SearchFieldIconRenderProps) => ReactNode;\n  }>;\n\nexport type SearchFieldIconRenderProps = Readonly<{\n  color: \"currentColor\";\n  size: number;\n}>;\n\nexport const SearchField = forwardRef<HTMLInputElement, SearchFieldProps>(\n  function SearchField(\n    {\n      value: valueProp,\n      defaultValue = \"\",\n      onValueChange,\n      onChange,\n      size = searchFieldRecipe.defaults.size,\n      clearLabel,\n      onClear,\n      loading = false,\n      renderSearchIcon,\n      renderClearIcon,\n      renderLoadingIndicator,\n      leading,\n      trailing,\n      fieldClassName,\n      disabled,\n      \"aria-busy\": ariaBusy,\n      ...props\n    },\n    forwardedRef,\n  ) {\n    const [value, setValue] = useControllableState({\n      ...(valueProp === undefined ? {} : { value: valueProp }),\n      defaultValue,\n      ...(onValueChange === undefined ? {} : { onChange: onValueChange }),\n    });\n    const inputRef = useRef<HTMLInputElement>(null);\n    const iconAppearance: SearchFieldIconRenderProps = {\n      color: \"currentColor\",\n      size: iconRecipe.sizes[searchFieldRecipe.sizes[size].glyph],\n    };\n    const canClear = value.length > 0 && !disabled;\n    return (\n      <FieldDisabledOpacityContext.Provider value={searchFieldRecipe.states.disabledOpacity}>\n      <TextField\n        {...props}\n        ref={composeRefs(inputRef, forwardedRef)}\n        type=\"search\"\n        value={value}\n        data-size={size}\n        data-loading={loading || undefined}\n        disabled={disabled}\n        aria-busy={loading || ariaBusy || undefined}\n        fieldClassName={classNames(\"hjm-search-field\", fieldClassName)!}\n        leading={\n          leading ?? (renderSearchIcon ? renderSearchIcon(iconAppearance) : undefined)\n        }\n        onChange={(event) => {\n          setValue(event.currentTarget.value);\n          onChange?.(event);\n        }}\n        trailing={\n          loading ? (\n            <span className=\"hjm-search-field__spinner\" aria-hidden=\"true\">\n              {renderLoadingIndicator?.(iconAppearance)}\n            </span>\n          ) : canClear ? (\n            <button\n              type=\"button\"\n              className=\"hjm-search-field__clear\"\n              aria-label={clearLabel}\n              onMouseDown={(event) => event.preventDefault()}\n              onClick={() => {\n                setValue(\"\");\n                onClear?.();\n                inputRef.current?.focus();\n              }}\n            >\n              {renderClearIcon?.(iconAppearance) ?? \"×\"}\n            </button>\n          ) : trailing\n        }\n      />\n      </FieldDisabledOpacityContext.Provider>\n    );\n  },\n);\n\nexport type PasswordFieldToggleRenderProps = Readonly<{\n  name: \"visibility\" | \"visibilityOff\";\n  color: \"currentColor\";\n  size: number;\n  revealed: boolean;\n  disabled: boolean;\n}>;\n\nexport type PasswordFieldProps = Omit<\n  TextFieldProps,\n  \"autoComplete\" | \"defaultValue\" | \"size\" | \"trailing\" | \"type\" | \"value\"\n> &\n  Readonly<{\n    value?: string;\n    defaultValue?: string;\n    onValueChange?: (value: string) => void;\n    revealed?: boolean;\n    defaultRevealed?: boolean;\n    onRevealedChange?: (revealed: boolean) => void;\n    autofillHint: PasswordFieldAutofillHint;\n    revealLabel: string;\n    concealLabel: string;\n    size?: PasswordFieldSize;\n    renderToggleIcon?: (props: PasswordFieldToggleRenderProps) => ReactNode;\n  }>;\n\n/** Password input with an independently controlled, selection-safe reveal action. */\nexport const PasswordField = forwardRef<HTMLInputElement, PasswordFieldProps>(\n  function PasswordField(\n    {\n      value: valueProp,\n      defaultValue = \"\",\n      onValueChange,\n      onChange,\n      revealed: revealedProp,\n      defaultRevealed = false,\n      onRevealedChange,\n      autofillHint,\n      revealLabel,\n      concealLabel,\n      size = passwordFieldRecipe.defaults.size,\n      renderToggleIcon,\n      fieldClassName,\n      className,\n      disabled,\n      readOnly,\n      ...props\n    },\n    forwardedRef,\n  ) {\n    const [value, setValue] = useControllableState({\n      ...(valueProp === undefined ? {} : { value: valueProp }),\n      defaultValue,\n      ...(onValueChange === undefined ? {} : { onChange: onValueChange }),\n    });\n    const [revealed, setRevealed] = useControllableState({\n      ...(revealedProp === undefined ? {} : { value: revealedProp }),\n      defaultValue: defaultRevealed,\n      ...(onRevealedChange === undefined ? {} : { onChange: onRevealedChange }),\n    });\n    const resolved = resolvePasswordFieldDescriptor(\n      { revealed, autofillHint },\n      {\n        composeToggleAccessibleName: ({ willReveal }) =>\n          willReveal ? revealLabel : concealLabel,\n      },\n    );\n    const inputRef = useRef<HTMLInputElement>(null);\n    const selectionRef = useRef<Readonly<{ start: number; end: number }> | null>(null);\n\n    useLayoutEffect(() => {\n      const selection = selectionRef.current;\n      if (!selection || !inputRef.current) return;\n      inputRef.current.setSelectionRange(selection.start, selection.end);\n      selectionRef.current = null;\n    }, [revealed]);\n\n    const toggleAppearance: PasswordFieldToggleRenderProps = {\n      name: revealed\n        ? passwordFieldRecipe.toggle.icons.revealed\n        : passwordFieldRecipe.toggle.icons.concealed,\n      color: \"currentColor\",\n      size: iconRecipe.sizes.sm,\n      revealed,\n      disabled: disabled ?? false,\n    };\n\n    return (\n      <FieldDisabledOpacityContext.Provider value={passwordFieldRecipe.states.disabledOpacity}>\n      <TextField\n        {...props}\n        ref={composeRefs(inputRef, forwardedRef)}\n        autoComplete={autofillHint === \"current\" ? \"current-password\" : \"new-password\"}\n        className={classNames(\"hjm-password-field__input\", className)}\n        disabled={disabled}\n        fieldClassName={classNames(\n          \"hjm-password-field\",\n          `hjm-password-field--${size}`,\n          fieldClassName,\n        )!}\n        onChange={(event) => {\n          setValue(event.currentTarget.value);\n          onChange?.(event);\n        }}\n        readOnly={readOnly}\n        trailing={(\n          <button\n            // No `aria-pressed`: the name already says the next action (\"Show/Hide\n            // password\"), and a pressed state on top would read as \"Hide password,\n            // pressed\" — two answers to one question (password-field.md, rationale 1).\n            aria-label={resolved.toggleAccessibleName}\n            className=\"hjm-password-field__toggle\"\n            data-revealed={revealed || undefined}\n            disabled={disabled}\n            onClick={() => {\n              const input = inputRef.current;\n              if (input && input.selectionStart !== null && input.selectionEnd !== null) {\n                selectionRef.current = {\n                  start: input.selectionStart,\n                  end: input.selectionEnd,\n                };\n              }\n              setRevealed(!revealed);\n            }}\n            type=\"button\"\n          >\n            {renderToggleIcon?.(toggleAppearance) ?? <span aria-hidden=\"true\" />}\n          </button>\n        )}\n        type={resolved.webInputType}\n        value={value}\n      />\n      </FieldDisabledOpacityContext.Provider>\n    );\n  },\n);\n\nexport type OtpFieldProps = Omit<\n  TextFieldProps,\n  | \"autoComplete\"\n  | \"defaultValue\"\n  | \"leading\"\n  | \"maxLength\"\n  | \"shape\"\n  | \"size\"\n  | \"trailing\"\n  | \"type\"\n  | \"value\"\n  | \"variant\"\n> &\n  Readonly<{\n    length: number;\n    value?: string;\n    defaultValue?: string;\n    onValueChange?: (value: string) => void;\n    onComplete?: (value: string) => void;\n    size?: OtpFieldSize;\n    presentation?: OtpFieldPresentation;\n    busy?: boolean;\n  }>;\n\n/** One accessible numeric input rendered as decorative OTP slots. */\nexport const OtpField = forwardRef<HTMLInputElement, OtpFieldProps>(\n  function OtpField(\n    {\n      id,\n      label,\n      description,\n      error,\n      required,\n      disabled,\n      readOnly,\n      busy = false,\n      length,\n      value: valueProp,\n      defaultValue = \"\",\n      onValueChange,\n      onComplete,\n      onChange,\n      size = otpFieldRecipe.defaults.size,\n    presentation = \"boxes\",\n      fieldClassName,\n      className,\n      onFocus,\n      onBlur,\n      \"aria-describedby\": ariaDescribedBy,\n      \"aria-invalid\": ariaInvalid,\n      \"aria-label\": ariaLabel,\n      layoutStyle,\n      ...props\n    },\n    ref,\n  ) {\n    const ids = useFieldIds(id);\n    const [focused, setFocused] = useState(false);\n    requireFieldAccessibleName(label, ariaLabel);\n    const [value, setValue] = useControllableState({\n      ...(valueProp === undefined ? {} : { value: valueProp }),\n      defaultValue: resolveOtpFieldValue(length, defaultValue),\n      ...(onValueChange === undefined ? {} : { onChange: onValueChange }),\n    });\n    const slots = getOtpFieldSlotValues({ length, value });\n    const complete = value.length === length;\n    const wasCompleteRef = useRef(complete);\n    useEffect(() => {\n      if (complete && !wasCompleteRef.current) onComplete?.(value);\n      wasCompleteRef.current = complete;\n    }, [complete, onComplete, value]);\n    const activeIndex = Math.min(value.length, length - 1);\n\n    return (\n      <FieldFrame\n        className={classNames(\"hjm-otp-field\", fieldClassName)}\n        disabledOpacity={otpFieldRecipe.states.disabledOpacity}\n        {...(layoutStyle === undefined ? {} : { layoutStyle })}\n        controlId={ids.controlId}\n        description={description}\n        disabled={(disabled ?? false) || busy}\n        error={error}\n        focused={focused}\n        label={label}\n        required={required ?? false}\n        {...(description ? { descriptionId: ids.descriptionId } : {})}\n        {...(error ? { errorId: ids.errorId } : {})}\n      >\n        <div\n          className=\"hjm-otp-field__control\"\n          data-presentation={presentation}\n          data-complete={complete || undefined}\n          data-size={size}\n          style={{ \"--hjm-otp-length\": length } as CSSProperties}\n        >\n          <input\n            {...props}\n            ref={ref}\n            aria-busy={busy || undefined}\n            aria-describedby={describedBy(\n              ariaDescribedBy,\n              description,\n              error,\n              ids.descriptionId,\n              ids.errorId,\n            )}\n            aria-invalid={error ? true : ariaInvalid}\n            aria-label={ariaLabel}\n            autoComplete=\"one-time-code\"\n            className={classNames(\"hjm-otp-field__input\", className)}\n            // busy stays focusable (read-only); see otp-field.md.\n            disabled={disabled}\n            id={ids.controlId}\n            inputMode=\"numeric\"\n            maxLength={length}\n            onBlur={(event) => {\n              setFocused(false);\n              onBlur?.(event);\n            }}\n            onChange={(event) => {\n              setValue(resolveOtpFieldValue(length, event.currentTarget.value));\n              onChange?.(event);\n            }}\n            onFocus={(event) => {\n              setFocused(true);\n              onFocus?.(event);\n            }}\n            pattern=\"[0-9]*\"\n            readOnly={readOnly || busy}\n            required={required}\n            type=\"text\"\n            value={value}\n          />\n          <div aria-hidden=\"true\" className=\"hjm-otp-field__slots\">\n            {slots.map((digit, index) => (\n              <span\n                className=\"hjm-otp-field__slot\"\n                data-state={error\n                  ? \"invalid\"\n                  : focused && index === activeIndex\n                    ? \"focused\"\n                    : digit\n                      ? \"filled\"\n                      : \"idle\"}\n                key={index}\n              >\n                {digit}\n              </span>\n            ))}\n          </div>\n        </div>\n      </FieldFrame>\n    );\n  },\n);\n"]}
+{"version":3,"file":"forms.js","sourceRoot":"","sources":["../src/forms.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  fieldRecipe,\n  type FieldAlign,\n  type FieldShape,\n  type FieldVariant,\n} from \"@hjmds/design-contracts/recipes/base\";\nimport {\n  iconRecipe,\n  searchFieldRecipe,\n  type SearchFieldSize,\n} from \"@hjmds/design-contracts/recipes\";\nimport {\n  passwordFieldRecipe,\n  resolvePasswordFieldDescriptor,\n  type PasswordFieldAutofillHint,\n  type PasswordFieldSize,\n} from \"@hjmds/design-contracts/components/password-field\";\nimport {\n  getOtpFieldSlotValues,\n  otpFieldRecipe,\n  resolveOtpFieldValue,\n  type OtpFieldSize,\n  type OtpFieldPresentation,\n} from \"@hjmds/design-contracts/components/otp-field\";\nimport {\n  createContext,\n  forwardRef,\n  useContext,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useRef,\n  useState,\n  type CSSProperties,\n  type FocusEvent,\n  type HTMLAttributes,\n  type InputHTMLAttributes,\n  type ReactNode,\n  type TextareaHTMLAttributes,\n} from \"react\";\nimport { composeRefs, classNames, useControllableState } from \"./internal.js\";\nimport type { HjmCompositionStyleProp } from \"./composition-style.js\";\n\ntype FieldCopyProps = Readonly<{\n  label?: ReactNode;\n  description?: ReactNode;\n  error?: ReactNode;\n  required?: boolean;\n}>;\n\ntype FieldFrameProps = HTMLAttributes<HTMLDivElement> &\n  FieldCopyProps &\n  Readonly<{\n    controlId: string;\n    descriptionId?: string;\n    errorId?: string;\n    disabled?: boolean;\n    focused?: boolean;\n    invalid?: boolean;\n    variant?: FieldVariant;\n    shape?: FieldShape;\n    align?: FieldAlign;\n    /** Component recipe override of fieldRecipe.disabledOpacity (OtpField). */\n    disabledOpacity?: number;\n    children: ReactNode;\n    /** Canonical layout-only placement on the field frame (`.hjm-field`), not the input. Controlled visual keys are excluded. */\n    layoutStyle?: HjmCompositionStyleProp;\n  }>;\n\n/*\n  How far a disabled field fades its label and control (fieldRecipe.disabledScope). The\n  frame defaults to fieldRecipe.disabledOpacity; SearchField and PasswordField render\n  through the public TextField, so they hand their own recipe value down this\n  module-private context instead of widening TextField's public props.\n*/\nconst FieldDisabledOpacityContext = createContext<number | undefined>(undefined);\n\nfunction FieldFrame({\n  controlId,\n  label,\n  description,\n  error,\n  descriptionId,\n  errorId,\n  required = false,\n  disabled = false,\n  focused = false,\n  invalid = false,\n  variant = fieldRecipe.defaults.variant,\n  shape = fieldRecipe.defaults.shape,\n  align = fieldRecipe.defaults.align,\n  disabledOpacity,\n  className,\n  children,\n  layoutStyle,\n  style,\n  ...props\n}: FieldFrameProps) {\n  // A grouped field may reference one external error; aria-invalid must still\n  // use the invalid recipe even when no inline error copy is repeated.\n  const state = disabled ? \"disabled\" : error || invalid ? \"invalid\" : focused ? \"focused\" : \"idle\";\n  const inheritedOpacity = useContext(FieldDisabledOpacityContext);\n  const recipeOpacity = disabledOpacity ?? inheritedOpacity;\n  return (\n    <div\n      {...props}\n      // The stylesheet fades the label and control with --hjm-field-disabled-opacity\n      // (theme value: fieldRecipe.disabledOpacity); a component recipe value is set\n      // here, only while disabled, so enabled roots keep their old inline style.\n      style={{\n        ...style,\n        ...layoutStyle,\n        ...(disabled && recipeOpacity !== undefined\n          ? ({ \"--hjm-field-disabled-opacity\": recipeOpacity } as CSSProperties)\n          : {}),\n      }}\n      className={classNames(\"hjm-field\", className)}\n      data-state={state}\n      data-variant={variant}\n      data-shape={shape}\n      data-align={align}\n    >\n      {label !== undefined && label !== null ? (\n        <label className=\"hjm-field__label\" htmlFor={controlId}>\n          {label}\n          {required ? <span aria-hidden=\"true\"> *</span> : null}\n        </label>\n      ) : null}\n      {children}\n      {/*\n        Support text stays visible under an error instead of being replaced by\n        it: the guidance (a length or format hint) is what tells the user how to clear the\n        error, and hiding it is why a product copied that sentence into its own\n        error string. Both are also referenced by aria-describedby.\n      */}\n      {description ? (\n        <div id={descriptionId} className=\"hjm-field__description\">\n          {description}\n        </div>\n      ) : null}\n      {error ? (\n        <div id={errorId} className=\"hjm-field__error\">\n          {error}\n        </div>\n      ) : null}\n    </div>\n  );\n}\n\nexport type FieldControlProps = Readonly<{\n  id: string;\n  required: boolean;\n  disabled: boolean;\n  \"aria-invalid\"?: true;\n  \"aria-describedby\"?: string;\n}>;\n\nexport type FieldProps = Omit<\n  FieldFrameProps,\n  \"children\" | \"descriptionId\" | \"errorId\" | \"disabledOpacity\"\n> &\n  Readonly<{\n    label: ReactNode;\n    children: ReactNode | ((props: FieldControlProps) => ReactNode);\n  }>;\n\n/** Generic frame for custom native controls; `controlId` keeps the label explicit. */\nexport function Field({\n  controlId,\n  description,\n  error,\n  required = false,\n  disabled = false,\n  children,\n  ...props\n}: FieldProps) {\n  const descriptionId = `${controlId}-description`;\n  const errorId = `${controlId}-error`;\n  const controlProps: FieldControlProps = {\n    id: controlId,\n    required,\n    disabled,\n    ...(error ? { \"aria-invalid\": true as const } : {}),\n    // Same merge as the built-in fields: support text stays referenced once an\n    // error appears, so a custom control does not have to re-derive the ids.\n    ...(description || error\n      ? {\n        \"aria-describedby\": [description ? descriptionId : undefined, error ? errorId : undefined]\n          .filter(Boolean)\n          .join(\" \"),\n      }\n      : {}),\n  };\n  return (\n    <FieldFrame\n      {...props}\n      controlId={controlId}\n      description={description}\n      error={error}\n      required={required}\n      disabled={disabled}\n      {...(description ? { descriptionId } : {})}\n      {...(error ? { errorId } : {})}\n    >\n      {typeof children === \"function\" ? children(controlProps) : children}\n    </FieldFrame>\n  );\n}\n\nfunction useFieldIds(id: string | undefined) {\n  const generatedId = useId();\n  const controlId = id ?? `hjm-${generatedId.replaceAll(\":\", \"\")}`;\n  return {\n    controlId,\n    descriptionId: `${controlId}-description`,\n    errorId: `${controlId}-error`,\n  } as const;\n}\n\n/*\n  Support text and the error are both referenced when both exist, in DOM reading\n  order, and the consumer's own `aria-describedby` is kept in front of them.\n  Announcing only the error (the earlier behaviour) dropped the guidance that\n  explains how to fix it — exactly the text a product then duplicated into the\n  error string by hand.\n*/\nfunction describedBy(\n  own: string | undefined,\n  description: ReactNode | undefined,\n  error: ReactNode | undefined,\n  descriptionId: string,\n  errorId: string,\n): string | undefined {\n  return [own, description ? descriptionId : undefined, error ? errorId : undefined]\n    .filter(Boolean)\n    .join(\" \") || undefined;\n}\n\nfunction requireFieldAccessibleName(label: ReactNode | undefined, ariaLabel: string | undefined) {\n  if ((label === undefined || label === null) && !ariaLabel?.trim()) {\n    throw new TypeError(\"Field controls require either label or aria-label\");\n  }\n}\n\ntype SharedInputProps = FieldCopyProps &\n  Readonly<{\n    variant?: FieldVariant;\n    shape?: FieldShape;\n    /**\n     * Text placement inside the control. `start` follows the resolved\n     * direction; `center` suits a short, ceremonial single value such as a\n     * nickname or a code. Replaces a `text-align` override.\n     */\n    align?: FieldAlign;\n    leading?: ReactNode;\n    trailing?: ReactNode;\n    fieldClassName?: string;\n    /**\n     * Canonical layout-only placement on the field frame. `style` keeps going to\n     * the input element, where it always went, so existing callers do not move.\n     */\n    layoutStyle?: HjmCompositionStyleProp;\n  }>;\n\nexport type TextFieldProps = Omit<InputHTMLAttributes<HTMLInputElement>, \"size\"> &\n  SharedInputProps &\n  Readonly<{\n    /**\n     * Receives the next string value, the same callback name and shape as the\n     * Native TextField and the Web TextArea. Before 1.5.0 Web TextField only had\n     * the DOM `onChange`, so shared form code needed a platform branch. Both\n     * fire; `onChange` stays for event access.\n     */\n    onValueChange?: (value: string) => void;\n  }>;\n\nexport const TextField = forwardRef<HTMLInputElement, TextFieldProps>(\n  function TextField(\n    {\n      id,\n      label,\n      description,\n      error,\n      required,\n      disabled,\n      variant,\n      shape,\n      align,\n      leading,\n      trailing,\n      fieldClassName,\n      className,\n      onFocus,\n      onBlur,\n      onChange,\n      onValueChange,\n      \"aria-describedby\": ariaDescribedBy,\n      \"aria-invalid\": ariaInvalid,\n      \"aria-label\": ariaLabel,\n      layoutStyle,\n      ...props\n    },\n    ref,\n  ) {\n    const ids = useFieldIds(id);\n    const [focused, setFocused] = useState(false);\n    requireFieldAccessibleName(label, ariaLabel);\n    const handleFocus = (event: FocusEvent<HTMLInputElement>) => {\n      setFocused(true);\n      onFocus?.(event);\n    };\n    const handleBlur = (event: FocusEvent<HTMLInputElement>) => {\n      setFocused(false);\n      onBlur?.(event);\n    };\n    return (\n      <FieldFrame\n        controlId={ids.controlId}\n        label={label}\n        description={description}\n        error={error}\n        required={required ?? false}\n        disabled={disabled ?? false}\n        focused={focused}\n        invalid={ariaInvalid === true || ariaInvalid === \"true\"}\n        variant={variant ?? fieldRecipe.defaults.variant}\n        shape={shape ?? fieldRecipe.defaults.shape}\n        align={align ?? fieldRecipe.defaults.align}\n        className={fieldClassName}\n        {...(layoutStyle === undefined ? {} : { layoutStyle })}\n        {...(description ? { descriptionId: ids.descriptionId } : {})}\n        {...(error ? { errorId: ids.errorId } : {})}\n      >\n        <div className=\"hjm-field__control\">\n          {leading ? <span className=\"hjm-field__affix\">{leading}</span> : null}\n          <input\n            {...props}\n            ref={ref}\n            id={ids.controlId}\n            className={classNames(\"hjm-field__input\", className)}\n            required={required}\n            disabled={disabled}\n            aria-invalid={error ? true : ariaInvalid}\n            aria-label={ariaLabel}\n            aria-describedby={describedBy(\n              ariaDescribedBy,\n              description,\n              error,\n              ids.descriptionId,\n              ids.errorId,\n            )}\n            onFocus={handleFocus}\n            onBlur={handleBlur}\n            onChange={(event) => {\n              onChange?.(event);\n              onValueChange?.(event.currentTarget.value);\n            }}\n          />\n          {trailing ? <span className=\"hjm-field__affix\">{trailing}</span> : null}\n        </div>\n      </FieldFrame>\n    );\n  },\n);\n\nexport type TextAreaProps = TextareaHTMLAttributes<HTMLTextAreaElement> &\n  Omit<SharedInputProps, \"leading\"> &\n  Readonly<{\n    /**\n     * Action before the text inside the field frame (for example a composer's camera button),\n     * vertically centred while the text grows. Mirrors `trailing`; `leading` stays omitted because\n     * TextField's `leading` is a decorative affix with muted color, not an action slot.\n     */\n    leadingAction?: ReactNode;\n    /**\n     * Lower bound for a growing multiline field, in visible lines. Height is\n     * recipe-owned, so this semantic axis replaces a `min-height` override.\n     */\n    minVisibleLines?: number;\n    /** Upper bound for a growing multiline field, in visible lines. */\n    maxVisibleLines?: number;\n  }>;\n\nexport const TextArea = forwardRef<HTMLTextAreaElement, TextAreaProps>(\n  function TextArea(\n    {\n      id,\n      label,\n      description,\n      error,\n      required,\n      disabled,\n      variant,\n      shape,\n      trailing,\n      leadingAction,\n      align,\n      fieldClassName,\n      className,\n      onFocus,\n      onBlur,\n      \"aria-describedby\": ariaDescribedBy,\n      \"aria-invalid\": ariaInvalid,\n      \"aria-label\": ariaLabel,\n      minVisibleLines,\n      maxVisibleLines,\n      style,\n      layoutStyle,\n      ...props\n    },\n    ref,\n  ) {\n    const ids = useFieldIds(id);\n    const [focused, setFocused] = useState(false);\n    requireFieldAccessibleName(label, ariaLabel);\n    // Bounds are expressed in lines so the recipe keeps line height and padding.\n    const lineBounds = {\n      ...(minVisibleLines === undefined\n        ? {}\n        : { \"--hjm-field-min-visible-lines\": minVisibleLines }),\n      ...(maxVisibleLines === undefined\n        ? {}\n        : { \"--hjm-field-max-visible-lines\": maxVisibleLines }),\n    } as CSSProperties;\n    return (\n      <FieldFrame\n        controlId={ids.controlId}\n        label={label}\n        description={description}\n        error={error}\n        required={required ?? false}\n        disabled={disabled ?? false}\n        focused={focused}\n        variant={variant ?? fieldRecipe.defaults.variant}\n        shape={shape ?? fieldRecipe.defaults.shape}\n        align={align ?? fieldRecipe.defaults.align}\n        className={fieldClassName}\n        {...(layoutStyle === undefined ? {} : { layoutStyle })}\n        {...(description ? { descriptionId: ids.descriptionId } : {})}\n        {...(error ? { errorId: ids.errorId } : {})}\n      >\n        <div className=\"hjm-field__control hjm-field__control--multiline\">\n          {leadingAction ? <span className=\"hjm-field__leading\">{leadingAction}</span> : null}\n          <textarea\n            {...props}\n            ref={ref}\n            id={ids.controlId}\n            className={classNames(\"hjm-field__input\", className)}\n            style={{ ...style, ...lineBounds }}\n            required={required}\n            disabled={disabled}\n            aria-invalid={error ? true : ariaInvalid}\n            aria-label={ariaLabel}\n            aria-describedby={describedBy(\n              ariaDescribedBy,\n              description,\n              error,\n              ids.descriptionId,\n              ids.errorId,\n            )}\n            onFocus={(event) => {\n              setFocused(true);\n              onFocus?.(event);\n            }}\n            onBlur={(event) => {\n              setFocused(false);\n              onBlur?.(event);\n            }}\n          />\n          {trailing ? <span className=\"hjm-field__trailing\">{trailing}</span> : null}\n        </div>\n      </FieldFrame>\n    );\n  },\n);\n\nexport type SearchFieldProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  \"type\" | \"size\" | \"value\" | \"defaultValue\"\n> &\n  SharedInputProps &\n  Readonly<{\n    value?: string;\n    defaultValue?: string;\n    onValueChange?: (value: string) => void;\n    size?: SearchFieldSize;\n    /** Localized accessible name for the clear action. */\n    clearLabel: string;\n    onClear?: () => void;\n    /** Keeps the input mounted and named while replacing trailing actions with progress. */\n    loading?: boolean;\n    /** Product icon adapter; the renderer owns size and inherited color. */\n    renderSearchIcon?: (props: SearchFieldIconRenderProps) => ReactNode;\n    /** Product icon adapter for the clear action. */\n    renderClearIcon?: (props: SearchFieldIconRenderProps) => ReactNode;\n    /** Optional progress adapter. The default is the canonical CSS spinner. */\n    renderLoadingIndicator?: (props: SearchFieldIconRenderProps) => ReactNode;\n  }>;\n\nexport type SearchFieldIconRenderProps = Readonly<{\n  color: \"currentColor\";\n  size: number;\n}>;\n\nexport const SearchField = forwardRef<HTMLInputElement, SearchFieldProps>(\n  function SearchField(\n    {\n      value: valueProp,\n      defaultValue = \"\",\n      onValueChange,\n      onChange,\n      size = searchFieldRecipe.defaults.size,\n      clearLabel,\n      onClear,\n      loading = false,\n      renderSearchIcon,\n      renderClearIcon,\n      renderLoadingIndicator,\n      leading,\n      trailing,\n      fieldClassName,\n      disabled,\n      \"aria-busy\": ariaBusy,\n      ...props\n    },\n    forwardedRef,\n  ) {\n    const [value, setValue] = useControllableState({\n      ...(valueProp === undefined ? {} : { value: valueProp }),\n      defaultValue,\n      ...(onValueChange === undefined ? {} : { onChange: onValueChange }),\n    });\n    const inputRef = useRef<HTMLInputElement>(null);\n    const iconAppearance: SearchFieldIconRenderProps = {\n      color: \"currentColor\",\n      size: iconRecipe.sizes[searchFieldRecipe.sizes[size].glyph],\n    };\n    const canClear = value.length > 0 && !disabled;\n    return (\n      <FieldDisabledOpacityContext.Provider value={searchFieldRecipe.states.disabledOpacity}>\n      <TextField\n        {...props}\n        ref={composeRefs(inputRef, forwardedRef)}\n        type=\"search\"\n        value={value}\n        data-size={size}\n        data-loading={loading || undefined}\n        disabled={disabled}\n        aria-busy={loading || ariaBusy || undefined}\n        fieldClassName={classNames(\"hjm-search-field\", fieldClassName)!}\n        leading={\n          leading ?? (renderSearchIcon ? renderSearchIcon(iconAppearance) : undefined)\n        }\n        onChange={(event) => {\n          setValue(event.currentTarget.value);\n          onChange?.(event);\n        }}\n        trailing={\n          loading ? (\n            <span className=\"hjm-search-field__spinner\" aria-hidden=\"true\">\n              {renderLoadingIndicator?.(iconAppearance)}\n            </span>\n          ) : canClear ? (\n            <button\n              type=\"button\"\n              className=\"hjm-search-field__clear\"\n              aria-label={clearLabel}\n              onMouseDown={(event) => event.preventDefault()}\n              onClick={() => {\n                setValue(\"\");\n                onClear?.();\n                inputRef.current?.focus();\n              }}\n            >\n              {renderClearIcon?.(iconAppearance) ?? \"×\"}\n            </button>\n          ) : trailing\n        }\n      />\n      </FieldDisabledOpacityContext.Provider>\n    );\n  },\n);\n\nexport type PasswordFieldToggleRenderProps = Readonly<{\n  name: \"visibility\" | \"visibilityOff\";\n  color: \"currentColor\";\n  size: number;\n  revealed: boolean;\n  disabled: boolean;\n}>;\n\nexport type PasswordFieldProps = Omit<\n  TextFieldProps,\n  \"autoComplete\" | \"defaultValue\" | \"size\" | \"trailing\" | \"type\" | \"value\"\n> &\n  Readonly<{\n    value?: string;\n    defaultValue?: string;\n    onValueChange?: (value: string) => void;\n    revealed?: boolean;\n    defaultRevealed?: boolean;\n    onRevealedChange?: (revealed: boolean) => void;\n    autofillHint: PasswordFieldAutofillHint;\n    revealLabel: string;\n    concealLabel: string;\n    size?: PasswordFieldSize;\n    renderToggleIcon?: (props: PasswordFieldToggleRenderProps) => ReactNode;\n  }>;\n\n/** Password input with an independently controlled, selection-safe reveal action. */\nexport const PasswordField = forwardRef<HTMLInputElement, PasswordFieldProps>(\n  function PasswordField(\n    {\n      value: valueProp,\n      defaultValue = \"\",\n      onValueChange,\n      onChange,\n      revealed: revealedProp,\n      defaultRevealed = false,\n      onRevealedChange,\n      autofillHint,\n      revealLabel,\n      concealLabel,\n      size = passwordFieldRecipe.defaults.size,\n      renderToggleIcon,\n      fieldClassName,\n      className,\n      disabled,\n      readOnly,\n      ...props\n    },\n    forwardedRef,\n  ) {\n    const [value, setValue] = useControllableState({\n      ...(valueProp === undefined ? {} : { value: valueProp }),\n      defaultValue,\n      ...(onValueChange === undefined ? {} : { onChange: onValueChange }),\n    });\n    const [revealed, setRevealed] = useControllableState({\n      ...(revealedProp === undefined ? {} : { value: revealedProp }),\n      defaultValue: defaultRevealed,\n      ...(onRevealedChange === undefined ? {} : { onChange: onRevealedChange }),\n    });\n    const resolved = resolvePasswordFieldDescriptor(\n      { revealed, autofillHint },\n      {\n        composeToggleAccessibleName: ({ willReveal }) =>\n          willReveal ? revealLabel : concealLabel,\n      },\n    );\n    const inputRef = useRef<HTMLInputElement>(null);\n    const selectionRef = useRef<Readonly<{ start: number; end: number }> | null>(null);\n\n    useLayoutEffect(() => {\n      const selection = selectionRef.current;\n      if (!selection || !inputRef.current) return;\n      inputRef.current.setSelectionRange(selection.start, selection.end);\n      selectionRef.current = null;\n    }, [revealed]);\n\n    const toggleAppearance: PasswordFieldToggleRenderProps = {\n      name: revealed\n        ? passwordFieldRecipe.toggle.icons.revealed\n        : passwordFieldRecipe.toggle.icons.concealed,\n      color: \"currentColor\",\n      size: iconRecipe.sizes.sm,\n      revealed,\n      disabled: disabled ?? false,\n    };\n\n    return (\n      <FieldDisabledOpacityContext.Provider value={passwordFieldRecipe.states.disabledOpacity}>\n      <TextField\n        {...props}\n        ref={composeRefs(inputRef, forwardedRef)}\n        autoComplete={autofillHint === \"current\" ? \"current-password\" : \"new-password\"}\n        className={classNames(\"hjm-password-field__input\", className)}\n        disabled={disabled}\n        fieldClassName={classNames(\n          \"hjm-password-field\",\n          `hjm-password-field--${size}`,\n          fieldClassName,\n        )!}\n        onChange={(event) => {\n          setValue(event.currentTarget.value);\n          onChange?.(event);\n        }}\n        readOnly={readOnly}\n        trailing={(\n          <button\n            // No `aria-pressed`: the name already says the next action (\"Show/Hide\n            // password\"), and a pressed state on top would read as \"Hide password,\n            // pressed\" — two answers to one question (password-field.md, rationale 1).\n            aria-label={resolved.toggleAccessibleName}\n            className=\"hjm-password-field__toggle\"\n            data-revealed={revealed || undefined}\n            disabled={disabled}\n            onClick={() => {\n              const input = inputRef.current;\n              if (input && input.selectionStart !== null && input.selectionEnd !== null) {\n                selectionRef.current = {\n                  start: input.selectionStart,\n                  end: input.selectionEnd,\n                };\n              }\n              setRevealed(!revealed);\n            }}\n            type=\"button\"\n          >\n            {renderToggleIcon?.(toggleAppearance) ?? <span aria-hidden=\"true\" />}\n          </button>\n        )}\n        type={resolved.webInputType}\n        value={value}\n      />\n      </FieldDisabledOpacityContext.Provider>\n    );\n  },\n);\n\nexport type OtpFieldProps = Omit<\n  TextFieldProps,\n  | \"autoComplete\"\n  | \"defaultValue\"\n  | \"leading\"\n  | \"maxLength\"\n  | \"shape\"\n  | \"size\"\n  | \"trailing\"\n  | \"type\"\n  | \"value\"\n  | \"variant\"\n> &\n  Readonly<{\n    length: number;\n    value?: string;\n    defaultValue?: string;\n    onValueChange?: (value: string) => void;\n    onComplete?: (value: string) => void;\n    size?: OtpFieldSize;\n    presentation?: OtpFieldPresentation;\n    busy?: boolean;\n  }>;\n\n/** One accessible numeric input rendered as decorative OTP slots. */\nexport const OtpField = forwardRef<HTMLInputElement, OtpFieldProps>(\n  function OtpField(\n    {\n      id,\n      label,\n      description,\n      error,\n      required,\n      disabled,\n      readOnly,\n      busy = false,\n      length,\n      value: valueProp,\n      defaultValue = \"\",\n      onValueChange,\n      onComplete,\n      onChange,\n      size = otpFieldRecipe.defaults.size,\n    presentation = \"boxes\",\n      fieldClassName,\n      className,\n      onFocus,\n      onBlur,\n      \"aria-describedby\": ariaDescribedBy,\n      \"aria-invalid\": ariaInvalid,\n      \"aria-label\": ariaLabel,\n      layoutStyle,\n      ...props\n    },\n    ref,\n  ) {\n    const ids = useFieldIds(id);\n    const [focused, setFocused] = useState(false);\n    requireFieldAccessibleName(label, ariaLabel);\n    const [value, setValue] = useControllableState({\n      ...(valueProp === undefined ? {} : { value: valueProp }),\n      defaultValue: resolveOtpFieldValue(length, defaultValue),\n      ...(onValueChange === undefined ? {} : { onChange: onValueChange }),\n    });\n    const slots = getOtpFieldSlotValues({ length, value });\n    const complete = value.length === length;\n    const wasCompleteRef = useRef(complete);\n    useEffect(() => {\n      if (complete && !wasCompleteRef.current) onComplete?.(value);\n      wasCompleteRef.current = complete;\n    }, [complete, onComplete, value]);\n    const activeIndex = Math.min(value.length, length - 1);\n\n    return (\n      <FieldFrame\n        className={classNames(\"hjm-otp-field\", fieldClassName)}\n        disabledOpacity={otpFieldRecipe.states.disabledOpacity}\n        {...(layoutStyle === undefined ? {} : { layoutStyle })}\n        controlId={ids.controlId}\n        description={description}\n        disabled={(disabled ?? false) || busy}\n        error={error}\n        focused={focused}\n        label={label}\n        required={required ?? false}\n        {...(description ? { descriptionId: ids.descriptionId } : {})}\n        {...(error ? { errorId: ids.errorId } : {})}\n      >\n        <div\n          className=\"hjm-otp-field__control\"\n          data-presentation={presentation}\n          data-complete={complete || undefined}\n          data-size={size}\n          style={{ \"--hjm-otp-length\": length } as CSSProperties}\n        >\n          <input\n            {...props}\n            ref={ref}\n            aria-busy={busy || undefined}\n            aria-describedby={describedBy(\n              ariaDescribedBy,\n              description,\n              error,\n              ids.descriptionId,\n              ids.errorId,\n            )}\n            aria-invalid={error ? true : ariaInvalid}\n            aria-label={ariaLabel}\n            autoComplete=\"one-time-code\"\n            className={classNames(\"hjm-otp-field__input\", className)}\n            // busy stays focusable (read-only); see otp-field.md.\n            disabled={disabled}\n            id={ids.controlId}\n            inputMode=\"numeric\"\n            maxLength={length}\n            onBlur={(event) => {\n              setFocused(false);\n              onBlur?.(event);\n            }}\n            onChange={(event) => {\n              setValue(resolveOtpFieldValue(length, event.currentTarget.value));\n              onChange?.(event);\n            }}\n            onFocus={(event) => {\n              setFocused(true);\n              onFocus?.(event);\n            }}\n            pattern=\"[0-9]*\"\n            readOnly={readOnly || busy}\n            required={required}\n            type=\"text\"\n            value={value}\n          />\n          <div aria-hidden=\"true\" className=\"hjm-otp-field__slots\">\n            {slots.map((digit, index) => (\n              <span\n                className=\"hjm-otp-field__slot\"\n                data-state={error\n                  ? \"invalid\"\n                  : focused && index === activeIndex\n                    ? \"focused\"\n                    : digit\n                      ? \"filled\"\n                      : \"idle\"}\n                key={index}\n              >\n                {digit}\n              </span>\n            ))}\n          </div>\n        </div>\n      </FieldFrame>\n    );\n  },\n);\n"]}

package/dist/image-comparison.d.ts

@@ -0,0 +1,12 @@
+import type { HjmCompositionStyleProp } from "./composition-style.js";
+import { type ImageComparisonDescriptor } from "@hjmds/design-contracts/reference-controls";
+export type ImageComparisonProps = ImageComparisonDescriptor & Readonly<{
+    onValueChange: (value: number) => void;
+    getValueText: (value: number) => string;
+    disabled?: boolean;
+    layoutStyle?: HjmCompositionStyleProp;
+}>;
+/** Reuse Slider for drag/keyboard/commit semantics. The image divider is a
+ * visual projection, not a second competing gesture or focus target. */
+export declare function ImageComparison(props: ImageComparisonProps): import("react").JSX.Element;
+//# sourceMappingURL=image-comparison.d.ts.map

package/dist/image-comparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-comparison.d.ts","sourceRoot":"","sources":["../src/image-comparison.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAA0B,KAAK,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAGpH,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,GAAG,QAAQ,CAAC;IAAE,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,uBAAuB,CAAA;CAAE,CAAC,CAAC;AACxN;wEACwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAc1D"}

package/dist/image-comparison.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { resolveImageComparison } from "@hjmds/design-contracts/reference-controls";
+import { Slider } from "./slider.js";
+import { Image } from "./supplemental-display.js";
+/** Reuse Slider for drag/keyboard/commit semantics. The image divider is a
+ * visual projection, not a second competing gesture or focus target. */
+export function ImageComparison(props) {
+    const { before, after, label, value, onValueChange, getValueText, disabled = false } = props;
+    const { aspectRatio, fraction } = resolveImageComparison(props);
+    // Labels follow the physical comparison sides even in RTL; each label retains
+    // its own writing direction. Mirroring only the labels misidentifies the images.
+    return _jsxs("div", { className: "hjm-image-comparison", style: props.layoutStyle, children: [_jsxs("div", { style: { display: "flex", justifyContent: "space-between", direction: "ltr", gap: "var(--hjm-space-sm)", flexWrap: "wrap" }, children: [_jsx("span", { dir: "auto", children: before.label }), _jsx("span", { dir: "auto", children: after.label })] }), _jsxs("div", { style: { position: "relative", aspectRatio, overflow: "hidden", direction: "ltr", background: "var(--hjm-color-surface-alt)" }, children: [_jsx(Image, { src: after.src, width: after.width, height: after.height, decorative: false, accessibilityLabel: after.label, style: { display: "block", width: "100%", height: "100%" } }), _jsx("div", { style: { position: "absolute", inset: 0, clipPath: `inset(0 ${100 - value}% 0 0)` }, children: _jsx(Image, { src: before.src, width: before.width, height: before.height, decorative: false, accessibilityLabel: before.label, style: { display: "block", width: "100%", height: "100%" } }) }), _jsx("div", { "aria-hidden": "true", style: { position: "absolute", top: 0, bottom: 0, left: `${fraction * 100}%`, borderInlineStart: "2px solid var(--hjm-color-border)", pointerEvents: "none" } })] }), _jsx(Slider, { label: label, min: 0, max: 100, step: 1, value: value, onValueChange: onValueChange, getValueText: getValueText, disabled: disabled })] });
+}
+//# sourceMappingURL=image-comparison.js.map

package/dist/image-comparison.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-comparison.js","sourceRoot":"","sources":["../src/image-comparison.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,sBAAsB,EAAkC,MAAM,4CAA4C,CAAC;AACpH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAElD;wEACwE;AACxE,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAC7F,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAChE,8EAA8E;IAC9E,iFAAiF;IACjF,OAAO,eAAK,SAAS,EAAC,sBAAsB,EAAC,KAAK,EAAE,KAAK,CAAC,WAAW,aACnE,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAE,eAAM,GAAG,EAAC,MAAM,YAAE,MAAM,CAAC,KAAK,GAAQ,EAAA,eAAM,GAAG,EAAC,MAAM,YAAE,KAAK,CAAC,KAAK,GAAQ,IAAM,EACnN,eAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,8BAA8B,EAAE,aACjI,KAAC,KAAK,IAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAI,EACnL,cAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,GAAG,GAAG,KAAK,QAAQ,EAAE,YAAE,KAAC,KAAK,IAAC,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAI,GAAM,EACvR,6BAAiB,MAAM,EAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,QAAQ,GAAG,GAAG,GAAG,EAAE,iBAAiB,EAAE,mCAAmC,EAAE,aAAa,EAAE,MAAM,EAAE,GAAI,IACrL,EACN,KAAC,MAAM,IAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAI,IAC3I,CAAC;AACT,CAAC","sourcesContent":["import type { HjmCompositionStyleProp } from \"./composition-style.js\";\nimport { resolveImageComparison, type ImageComparisonDescriptor } from \"@hjmds/design-contracts/reference-controls\";\nimport { Slider } from \"./slider.js\";\nimport { Image } from \"./supplemental-display.js\";\nexport type ImageComparisonProps = ImageComparisonDescriptor & Readonly<{ onValueChange: (value: number) => void; getValueText: (value: number) => string; disabled?: boolean; layoutStyle?: HjmCompositionStyleProp }>;\n/** Reuse Slider for drag/keyboard/commit semantics. The image divider is a\n * visual projection, not a second competing gesture or focus target. */\nexport function ImageComparison(props: ImageComparisonProps) {\n  const { before, after, label, value, onValueChange, getValueText, disabled = false } = props;\n  const { aspectRatio, fraction } = resolveImageComparison(props);\n  // Labels follow the physical comparison sides even in RTL; each label retains\n  // its own writing direction. Mirroring only the labels misidentifies the images.\n  return <div className=\"hjm-image-comparison\" style={props.layoutStyle}>\n    <div style={{ display: \"flex\", justifyContent: \"space-between\", direction: \"ltr\", gap: \"var(--hjm-space-sm)\", flexWrap: \"wrap\" }}><span dir=\"auto\">{before.label}</span><span dir=\"auto\">{after.label}</span></div>\n    <div style={{ position: \"relative\", aspectRatio, overflow: \"hidden\", direction: \"ltr\", background: \"var(--hjm-color-surface-alt)\" }}>\n      <Image src={after.src} width={after.width} height={after.height} decorative={false} accessibilityLabel={after.label} style={{ display: \"block\", width: \"100%\", height: \"100%\" }} />\n      <div style={{ position: \"absolute\", inset: 0, clipPath: `inset(0 ${100 - value}% 0 0)` }}><Image src={before.src} width={before.width} height={before.height} decorative={false} accessibilityLabel={before.label} style={{ display: \"block\", width: \"100%\", height: \"100%\" }} /></div>\n      <div aria-hidden=\"true\" style={{ position: \"absolute\", top: 0, bottom: 0, left: `${fraction * 100}%`, borderInlineStart: \"2px solid var(--hjm-color-border)\", pointerEvents: \"none\" }} />\n    </div>\n    <Slider label={label} min={0} max={100} step={1} value={value} onValueChange={onValueChange} getValueText={getValueText} disabled={disabled} />\n  </div>;\n}\n"]}

package/dist/internal/document-resource.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+import { type DocumentResourceControls } from "@hjmds/design-contracts/document-resource";
+export type DocumentResourceProps = DocumentResourceControls & Readonly<{
+    preview?: ReactNode;
+    moreAction?: ReactNode;
+}>;
+/** Rendering a host result never initiates file access or transfer. */
+export declare function DocumentResource({ preview, moreAction, ...props }: DocumentResourceProps): import("react").JSX.Element;
+//# sourceMappingURL=document-resource.d.ts.map

package/dist/internal/document-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-resource.d.ts","sourceRoot":"","sources":["../../src/internal/document-resource.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7E,OAAO,EAAmC,KAAK,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAI3H,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,GAAG,QAAQ,CAAC;IAAE,OAAO,CAAC,EAAE,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAEzH,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,EAAE,qBAAqB,+BAmDxF"}

package/dist/internal/document-resource.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useLayoutEffect, useRef } from "react";
+import { resolveDocumentResourceControls } from "@hjmds/design-contracts/document-resource";
+import { Button } from "../actions.js";
+import { Stack, Surface, Text } from "../layout.js";
+/** Rendering a host result never initiates file access or transfer. */
+export function DocumentResource({ preview, moreAction, ...props }) {
+    const resource = resolveDocumentResourceControls(props);
+    const { labels } = props;
+    const previewFailed = resource.preview.status === "error";
+    const saveFailed = resource.save.status === "error";
+    const previewButton = useRef(null);
+    const saveButton = useRef(null);
+    const retryButton = useRef(null);
+    const previousId = useRef(resource.id);
+    const detachedFocus = useRef(null);
+    const attachRetry = useCallback((node) => {
+        const old = retryButton.current;
+        // Capture before removal: after commit the browser has already dropped focus to body.
+        if (!node && old && old.ownerDocument.activeElement === old)
+            detachedFocus.current = old.ownerDocument;
+        retryButton.current = node;
+    }, []);
+    useLayoutEffect(() => {
+        const owner = detachedFocus.current;
+        detachedFocus.current = null;
+        // Only recover our removed control; never move focus across file identities or from another control.
+        if (owner && previousId.current === resource.id && owner.activeElement === owner.body) {
+            const target = [previewButton.current, saveButton.current].find(button => button && !button.disabled && button.getAttribute("aria-disabled") !== "true");
+            target?.focus();
+        }
+        previousId.current = resource.id;
+    });
+    return _jsx(Surface, { padding: "md", radius: "lg", role: "group", "aria-label": resource.name, children: _jsxs(Stack, { gap: "sm", children: [_jsx(Text, { emphasis: "strong", style: { overflowWrap: "anywhere" }, children: resource.name }), resource.metadata.map((label, index) => _jsx(Text, { variant: "caption", tone: "muted", children: label }, index)), resource.description ? _jsx(Text, { children: resource.description }) : null, resource.preview.status === "ready" ? preview : null, resource.preview.status === "none" ? _jsx(Text, { tone: "muted", children: labels.previewUnavailable }) : null, resource.preview.status === "loading" ? _jsx(Text, { role: "status", children: labels.previewLoading }) : null, previewFailed ? _jsx(Text, { tone: "danger", role: "alert", children: resource.preview.status === "error" ? resource.preview.message : "" }) : null, props.onPreview ? _jsx(Button, { ref: previewButton, tone: "secondary", disabled: !resource.canPreview, onClick: props.onPreview, children: labels.preview }) : null, previewFailed && resource.preview.retryable ? _jsx(Button, { ref: attachRetry, tone: "secondary", disabled: !resource.canRetryPreview, onClick: props.onRetryPreview, children: labels.retryPreview }) : null, _jsx(Button, { ref: saveButton, disabled: saveFailed ? !resource.canRetrySave : !resource.canSave, loading: resource.save.status === "pending", onClick: saveFailed ? props.onRetrySave : props.onSave, children: saveFailed ? labels.retrySave : resource.save.status === "pending" ? labels.saving : labels.save }), saveFailed ? _jsx(Text, { tone: "danger", role: "alert", children: resource.save.status === "error" ? resource.save.message : "" }) : null, resource.save.status === "started" || resource.save.status === "saved" || resource.save.status === "cancelled"
+                    ? _jsx(Text, { role: "status", children: labels[resource.save.status] }) : null, moreAction] }) });
+}
+//# sourceMappingURL=document-resource.js.map

package/dist/internal/document-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-resource.js","sourceRoot":"","sources":["../../src/internal/document-resource.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useLayoutEffect, useRef, type ReactNode } from \"react\";\nimport { resolveDocumentResourceControls, type DocumentResourceControls } from \"@hjmds/design-contracts/document-resource\";\nimport { Button } from \"../actions.js\";\nimport { Stack, Surface, Text } from \"../layout.js\";\n\nexport type DocumentResourceProps = DocumentResourceControls & Readonly<{ preview?: ReactNode; moreAction?: ReactNode }>;\n\n/** Rendering a host result never initiates file access or transfer. */\nexport function DocumentResource({ preview, moreAction, ...props }: DocumentResourceProps) {\n  const resource = resolveDocumentResourceControls(props);\n  const { labels } = props;\n  const previewFailed = resource.preview.status === \"error\";\n  const saveFailed = resource.save.status === \"error\";\n  const previewButton = useRef<HTMLButtonElement>(null);\n  const saveButton = useRef<HTMLButtonElement>(null);\n  const retryButton = useRef<HTMLButtonElement | null>(null);\n  const previousId = useRef(resource.id);\n  const detachedFocus = useRef<Document | null>(null);\n  const attachRetry = useCallback((node: HTMLButtonElement | null) => {\n    const old = retryButton.current;\n    // Capture before removal: after commit the browser has already dropped focus to body.\n    if (!node && old && old.ownerDocument.activeElement === old) detachedFocus.current = old.ownerDocument;\n    retryButton.current = node;\n  }, []);\n  useLayoutEffect(() => {\n    const owner = detachedFocus.current;\n    detachedFocus.current = null;\n    // Only recover our removed control; never move focus across file identities or from another control.\n    if (owner && previousId.current === resource.id && owner.activeElement === owner.body) {\n      const target = [previewButton.current, saveButton.current].find(button =>\n        button && !button.disabled && button.getAttribute(\"aria-disabled\") !== \"true\");\n      target?.focus();\n    }\n    previousId.current = resource.id;\n  });\n  return <Surface padding=\"md\" radius=\"lg\" role=\"group\" aria-label={resource.name}>\n    <Stack gap=\"sm\">\n      {/* A file name is not automatically a page heading. Keep it readable when the preview fails. */}\n      <Text emphasis=\"strong\" style={{ overflowWrap: \"anywhere\" }}>{resource.name}</Text>\n      {resource.metadata.map((label, index) => <Text key={index} variant=\"caption\" tone=\"muted\">{label}</Text>)}\n      {resource.description ? <Text>{resource.description}</Text> : null}\n      {resource.preview.status === \"ready\" ? preview : null}\n      {resource.preview.status === \"none\" ? <Text tone=\"muted\">{labels.previewUnavailable}</Text> : null}\n      {resource.preview.status === \"loading\" ? <Text role=\"status\">{labels.previewLoading}</Text> : null}\n      {previewFailed ? <Text tone=\"danger\" role=\"alert\">{resource.preview.status === \"error\" ? resource.preview.message : \"\"}</Text> : null}\n      {/* Independent buttons prevent preview navigation from swallowing save/menu interaction. */}\n      {props.onPreview ? <Button ref={previewButton} tone=\"secondary\" disabled={!resource.canPreview} onClick={props.onPreview}>{labels.preview}</Button> : null}\n      {previewFailed && resource.preview.retryable ? <Button ref={attachRetry} tone=\"secondary\" disabled={!resource.canRetryPreview} onClick={props.onRetryPreview}>{labels.retryPreview}</Button> : null}\n      <Button ref={saveButton} disabled={saveFailed ? !resource.canRetrySave : !resource.canSave}\n        loading={resource.save.status === \"pending\"}\n        onClick={saveFailed ? props.onRetrySave : props.onSave}>\n        {saveFailed ? labels.retrySave : resource.save.status === \"pending\" ? labels.saving : labels.save}\n      </Button>\n      {saveFailed ? <Text tone=\"danger\" role=\"alert\">{resource.save.status === \"error\" ? resource.save.message : \"\"}</Text> : null}\n      {resource.save.status === \"started\" || resource.save.status === \"saved\" || resource.save.status === \"cancelled\"\n        ? <Text role=\"status\">{labels[resource.save.status]}</Text> : null}\n      {moreAction}\n    </Stack>\n  </Surface>;\n}\n"]}

package/dist/internal/overlay-origin-motion.d.ts

@@ -0,0 +1,13 @@
+import { type TransitionRect } from '@hjmds/design-contracts/content-transition';
+import { dialogRecipe } from '@hjmds/design-contracts/recipes';
+type OriginMotionOptions = Readonly<{
+    ready?: boolean;
+    transition?: typeof dialogRecipe.transition;
+}>;
+/** Keep one real overlay subtree through exit; cancellation must never settle a reopened cycle. */
+export declare function useOverlayOriginMotion(open: boolean, origin: TransitionRect | undefined, reduced: boolean | undefined, { ready, transition }?: OriginMotionOptions): {
+    visible: boolean;
+    setNode: import("react").Dispatch<import("react").SetStateAction<HTMLDivElement | null>>;
+};
+export {};
+//# sourceMappingURL=overlay-origin-motion.d.ts.map

package/dist/internal/overlay-origin-motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-origin-motion.d.ts","sourceRoot":"","sources":["../../src/internal/overlay-origin-motion.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC1G,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAG/D,KAAK,mBAAmB,GAAG,QAAQ,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,YAAY,CAAC,UAAU,CAAC;CAC7C,CAAC,CAAC;AAEH,mGAAmG;AACnG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,EAAE,KAAY,EAAE,UAAoC,EAAE,GAAE,mBAAwB;;;EAwCvM"}

package/dist/internal/overlay-origin-motion.js

@@ -0,0 +1,76 @@
+import { useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';
+import { resolveOriginTransition } from '@hjmds/design-contracts/content-transition';
+import { dialogRecipe } from '@hjmds/design-contracts/recipes';
+import { easing } from '@hjmds/design-contracts/foundations';
+/** Keep one real overlay subtree through exit; cancellation must never settle a reopened cycle. */
+export function useOverlayOriginMotion(open, origin, reduced, { ready = true, transition = dialogRecipe.transition } = {}) {
+    const systemReduced = useSyncExternalStore(subscribeMotion, readMotion, () => false);
+    const reduce = reduced ?? systemReduced;
+    const interrupted = useRef(null);
+    const [node, setNode] = useState(null);
+    const [present, setPresent] = useState(open);
+    const visible = open || present;
+    useLayoutEffect(() => {
+        if (!node) {
+            interrupted.current = null;
+            if (!open)
+                setPresent(false);
+            return;
+        }
+        if (open)
+            setPresent(true);
+        // Anchored surfaces must finish placement before measuring their destination.
+        // Measuring the hidden portal at (0, 0) makes its first frame jump across the viewport.
+        if (!ready) {
+            if (!open)
+                setPresent(false);
+            return;
+        }
+        const transform = resolveOriginTransition(origin, node.getBoundingClientRect(), reduce);
+        if (!transform || typeof node.animate !== 'function') {
+            interrupted.current = null;
+            setPresent(open);
+            return;
+        }
+        const from = `translate(${transform.translateX}px, ${transform.translateY}px) scale(${transform.scaleX}, ${transform.scaleY})`;
+        const start = interrupted.current;
+        interrupted.current = null;
+        const phase = open ? transition.enter : transition.exit;
+        let cancelled = false;
+        let animation;
+        try {
+            // WAAPI only owns presentation. Overlay focus, state and completion remain canonical.
+            animation = node.animate([{ transform: start ?? (open ? from : 'none') }, { transform: open ? 'none' : from }], {
+                duration: phase.duration, easing: `cubic-bezier(${easing[phase.easing].join(',')})`, fill: 'both',
+            });
+        }
+        catch {
+            setPresent(open);
+            return;
+        }
+        animation.finished.then(() => {
+            if (cancelled)
+                return;
+            if (!open)
+                setPresent(false);
+            animation.cancel();
+        }, () => { if (!cancelled)
+            setPresent(open); });
+        return () => {
+            cancelled = true;
+            // Sample before cancelling so a rapid close/reopen continues at its current visual position.
+            interrupted.current = animation.playState === 'running' ? getComputedStyle(node).transform : null;
+            animation.cancel();
+        };
+    }, [open, node, origin?.x, origin?.y, origin?.width, origin?.height, reduce, ready, transition]);
+    return { visible, setNode };
+}
+function readMotion() { return typeof matchMedia !== 'undefined' && matchMedia('(prefers-reduced-motion: reduce)').matches; }
+function subscribeMotion(listener) {
+    if (typeof matchMedia === 'undefined')
+        return () => { };
+    const query = matchMedia('(prefers-reduced-motion: reduce)');
+    query.addEventListener('change', listener);
+    return () => query.removeEventListener('change', listener);
+}
+//# sourceMappingURL=overlay-origin-motion.js.map

package/dist/internal/overlay-origin-motion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-origin-motion.js","sourceRoot":"","sources":["../../src/internal/overlay-origin-motion.ts"],"names":[],"mappings":"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","sourcesContent":["import { useLayoutEffect, useRef, useState, useSyncExternalStore } from 'react';\nimport { resolveOriginTransition, type TransitionRect } from '@hjmds/design-contracts/content-transition';\nimport { dialogRecipe } from '@hjmds/design-contracts/recipes';\nimport { easing } from '@hjmds/design-contracts/foundations';\n\ntype OriginMotionOptions = Readonly<{\n  ready?: boolean;\n  transition?: typeof dialogRecipe.transition;\n}>;\n\n/** Keep one real overlay subtree through exit; cancellation must never settle a reopened cycle. */\nexport function useOverlayOriginMotion(open: boolean, origin: TransitionRect | undefined, reduced: boolean | undefined, { ready = true, transition = dialogRecipe.transition }: OriginMotionOptions = {}) {\n  const systemReduced = useSyncExternalStore(subscribeMotion, readMotion, () => false);\n  const reduce = reduced ?? systemReduced;\n  const interrupted = useRef<string | null>(null);\n  const [node, setNode] = useState<HTMLDivElement | null>(null);\n  const [present, setPresent] = useState(open);\n  const visible = open || present;\n  useLayoutEffect(() => {\n    if (!node) { interrupted.current = null; if (!open) setPresent(false); return; }\n    if (open) setPresent(true);\n    // Anchored surfaces must finish placement before measuring their destination.\n    // Measuring the hidden portal at (0, 0) makes its first frame jump across the viewport.\n    if (!ready) { if (!open) setPresent(false); return; }\n    const transform = resolveOriginTransition(origin, node.getBoundingClientRect(), reduce);\n    if (!transform || typeof node.animate !== 'function') { interrupted.current = null; setPresent(open); return; }\n    const from = `translate(${transform.translateX}px, ${transform.translateY}px) scale(${transform.scaleX}, ${transform.scaleY})`;\n    const start = interrupted.current;\n    interrupted.current = null;\n    const phase = open ? transition.enter : transition.exit;\n    let cancelled = false;\n    let animation: Animation;\n    try {\n      // WAAPI only owns presentation. Overlay focus, state and completion remain canonical.\n      animation = node.animate([{ transform: start ?? (open ? from : 'none') }, { transform: open ? 'none' : from }], {\n        duration: phase.duration, easing: `cubic-bezier(${easing[phase.easing].join(',')})`, fill: 'both',\n      });\n    } catch { setPresent(open); return; }\n    animation.finished.then(() => {\n      if (cancelled) return;\n      if (!open) setPresent(false);\n      animation.cancel();\n    }, () => { if (!cancelled) setPresent(open); });\n    return () => {\n      cancelled = true;\n      // Sample before cancelling so a rapid close/reopen continues at its current visual position.\n      interrupted.current = animation.playState === 'running' ? getComputedStyle(node).transform : null;\n      animation.cancel();\n    };\n  }, [open, node, origin?.x, origin?.y, origin?.width, origin?.height, reduce, ready, transition]);\n  return { visible, setNode };\n}\n\nfunction readMotion() { return typeof matchMedia !== 'undefined' && matchMedia('(prefers-reduced-motion: reduce)').matches; }\nfunction subscribeMotion(listener: () => void) {\n  if (typeof matchMedia === 'undefined') return () => {};\n  const query = matchMedia('(prefers-reduced-motion: reduce)');\n  query.addEventListener('change', listener);\n  return () => query.removeEventListener('change', listener);\n}\n"]}

package/dist/overlays.d.ts

@@ -1,3 +1,4 @@
+import type { TransitionRect } from "@hjmds/design-contracts/content-transition";
 import { type AlertDialogOpenChangeReason, type AlertDialogRequest } from "@hjmds/design-contracts/components/alert-dialog";
 import { type SheetDetent, type SheetDismissPolicy, type SheetDismissReason, type SheetOpenChangeDetails } from "@hjmds/design-contracts/components/sheet";
 import { type TooltipAlign, type TooltipOpenChangeDetails, type TooltipPlacement } from "@hjmds/design-contracts/components/tooltip";
@@ -15,6 +16,8 @@ export type DialogProps = ModalOpenState<Readonly<{
     description?: ReactNode;
     children?: ReactNode;
     footer?: ReactNode;
+    /** Optional measured trigger bounds in viewport coordinates; keeps canonical modal behavior. */
+    motionOrigin?: TransitionRect;
     size?: DialogSize;
     dismissible?: boolean;
     busy?: boolean;