@hjmds/react 0.8.2

package/dist/navigation.js

@@ -0,0 +1,196 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getTabNavigationIntent, getTabNavigationTarget, resolveInitialTabValue, tabsBehaviorDefaults, } from "@hjmds/design-contracts/behaviors";
+import { iconRecipe, tabsRecipe, } from "@hjmds/design-contracts/recipes";
+import { forwardRef, useEffect, useId, useRef, useState, } from "react";
+import { classNames, useControllableState } from "./internal.js";
+import { useOptionalHjmTheme } from "./provider.js";
+function validateItems(items) {
+    if (items.length === 0)
+        throw new TypeError("Tabs requires at least one item");
+    const ids = new Set();
+    for (const item of items) {
+        if (item.id.trim().length === 0)
+            throw new TypeError("Tabs item id must not be empty");
+        if (ids.has(item.id))
+            throw new TypeError(`Duplicate Tabs item id: ${item.id}`);
+        ids.add(item.id);
+    }
+    if (!items.some((item) => !item.disabled)) {
+        throw new TypeError("Tabs requires at least one enabled item");
+    }
+}
+const panelFocusableSelector = [
+    "a[href]",
+    "button:not([disabled])",
+    "input:not([disabled])",
+    "select:not([disabled])",
+    "textarea:not([disabled])",
+    "[tabindex]:not([tabindex='-1'])",
+].join(",");
+function TabPanelHost({ id, labelledBy, selected, dynamic, children, className, ...props }) {
+    const ref = useRef(null);
+    const [hasFocusableContent, setHasFocusableContent] = useState(false);
+    useEffect(() => {
+        setHasFocusableContent(ref.current?.querySelector(panelFocusableSelector) !== null);
+    }, [children]);
+    return (_jsx("div", { ...props, ref: ref, id: id, role: "tabpanel", className: classNames("hjm-tabs__panel", className), "aria-labelledby": labelledBy, tabIndex: selected && !hasFocusableContent ? 0 : undefined, hidden: !selected, inert: selected ? undefined : true, "data-state": selected ? "active" : "inactive", "data-panel-mode": dynamic ? "dynamic" : "keyed", children: children }));
+}
+function encodedTabId(value) {
+    return encodeURIComponent(value);
+}
+export function getTabId(tabsId, value) {
+    return `${tabsId}-tab-${encodedTabId(value)}`;
+}
+export function getTabPanelId(tabsId, value, mode = "keyed") {
+    return mode === "dynamic"
+        ? `${tabsId}-panel`
+        : `${tabsId}-panel-${encodedTabId(value)}`;
+}
+export function getDynamicTabPanelId(tabsId) {
+    return getTabPanelId(tabsId, "", "dynamic");
+}
+/** External panel host for products that keep routing, query, or scroll state outside Tabs. */
+export function TabPanel(props) {
+    const { tabsId, activeValue, children } = props;
+    const dynamic = props.mode === "dynamic";
+    const value = dynamic ? activeValue : props.value;
+    const selected = value === activeValue;
+    const mountPolicy = dynamic ? "active" : props.mountPolicy ?? tabsBehaviorDefaults.mountPolicy;
+    let hostProps;
+    if (props.mode === "dynamic") {
+        const { tabsId: _tabsId, activeValue: _activeValue, children: _children, mode: _mode, ...htmlProps } = props;
+        hostProps = htmlProps;
+    }
+    else {
+        const { tabsId: _tabsId, activeValue: _activeValue, children: _children, mode: _mode, value: _value, mountPolicy: _mountPolicy, ...htmlProps } = props;
+        hostProps = htmlProps;
+    }
+    const [visited, setVisited] = useState(selected);
+    useEffect(() => {
+        if (selected)
+            setVisited(true);
+    }, [selected]);
+    const mounted = dynamic ||
+        selected ||
+        mountPolicy === "always" ||
+        (mountPolicy === "visited" && visited);
+    if (!mounted)
+        return null;
+    return (_jsx(TabPanelHost, { ...hostProps, id: getTabPanelId(tabsId, value, dynamic ? "dynamic" : "keyed"), labelledBy: getTabId(tabsId, dynamic ? activeValue : value), selected: selected, dynamic: dynamic, children: children }));
+}
+export const Tabs = forwardRef(function Tabs(props, ref) {
+    const { label, items, activationMode = tabsBehaviorDefaults.activationMode, mountPolicy = tabsBehaviorDefaults.mountPolicy, panelMode = tabsBehaviorDefaults.panelMode, orientation = tabsBehaviorDefaults.orientation, direction: directionProp, loop = tabsBehaviorDefaults.loop, size = tabsRecipe.defaults.size, layout = tabsRecipe.defaults.layout, overflow = tabsRecipe.defaults.overflow, renderPanels = true, className, id, value: valueProp, defaultValue, onValueChange, ...rest } = props;
+    validateItems(items);
+    if (label.trim().length === 0)
+        throw new TypeError("Tabs label must not be empty");
+    if (panelMode === "dynamic" && mountPolicy !== "active") {
+        throw new TypeError("Tabs dynamic panelMode requires active mountPolicy");
+    }
+    const descriptors = items.map((item) => ({
+        id: item.id,
+        label: item.id,
+        ...(item.disabled === undefined ? {} : { disabled: item.disabled }),
+    }));
+    const initialValueRef = useRef(null);
+    if (initialValueRef.current === null) {
+        const resolved = resolveInitialTabValue(descriptors, defaultValue);
+        if (resolved === undefined)
+            throw new TypeError("Tabs requires an enabled item");
+        initialValueRef.current = { value: resolved };
+    }
+    const initialValue = initialValueRef.current.value;
+    const collectionFallback = items.find((item) => !item.disabled)?.id;
+    if (collectionFallback === undefined)
+        throw new TypeError("Tabs requires an enabled item");
+    const [storedValue, setValue] = useControllableState({
+        ...(valueProp === undefined ? {} : { value: valueProp }),
+        defaultValue: initialValue,
+        ...(onValueChange === undefined ? {} : { onChange: onValueChange }),
+    });
+    const controlled = valueProp !== undefined;
+    const storedSelectionIsValid = items.some((item) => item.id === storedValue && !item.disabled);
+    if (controlled && !storedSelectionIsValid) {
+        throw new RangeError(`Tabs value must identify an enabled item: ${storedValue}`);
+    }
+    const value = storedSelectionIsValid ? storedValue : collectionFallback;
+    const [focusValue, setFocusValue] = useState(value);
+    const resolvedFocusValue = items.some((item) => item.id === focusValue && !item.disabled)
+        ? focusValue
+        : value;
+    const [visited, setVisited] = useState(() => new Set([value]));
+    const tabRefs = useRef(new Map());
+    const generatedId = useId().replaceAll(":", "");
+    const baseId = id ?? `hjm-${generatedId}`;
+    const theme = useOptionalHjmTheme();
+    const direction = directionProp ?? theme?.environment.direction ?? tabsBehaviorDefaults.direction;
+    useEffect(() => {
+        if (!controlled && !storedSelectionIsValid)
+            setValue(collectionFallback);
+    }, [collectionFallback, controlled, setValue, storedSelectionIsValid]);
+    useEffect(() => {
+        if (!items.some((item) => item.id === focusValue && !item.disabled)) {
+            setFocusValue(value);
+        }
+    }, [focusValue, items, value]);
+    useEffect(() => {
+        setVisited((current) => {
+            const known = new Set(items.map((item) => item.id));
+            const next = new Set([...current].filter((id) => known.has(id)));
+            next.add(value);
+            if (next.size === current.size &&
+                [...next].every((id) => current.has(id)))
+                return current;
+            return next;
+        });
+    }, [items, value]);
+    const focusItem = (id) => {
+        setFocusValue(id);
+        if (activationMode === "automatic")
+            setValue(id);
+        queueMicrotask(() => tabRefs.current.get(id)?.focus());
+    };
+    const handleKeyDown = (event, id) => {
+        const intent = getTabNavigationIntent(event.key === " " ? "Space" : event.key, orientation, direction);
+        if (intent !== undefined) {
+            const target = getTabNavigationTarget(descriptors, id, intent, loop);
+            if (target !== undefined) {
+                event.preventDefault();
+                focusItem(target);
+            }
+            return;
+        }
+        if (activationMode === "manual" &&
+            (event.key === "Enter" || event.key === " ")) {
+            event.preventDefault();
+            setValue(id);
+        }
+    };
+    const panelId = (value) => getTabPanelId(baseId, value, panelMode);
+    return (_jsxs("div", { ...rest, ref: ref, id: baseId, className: classNames("hjm-tabs", className), "data-size": size, "data-layout": layout, "data-overflow": overflow, "data-orientation": orientation, "data-mount-policy": mountPolicy, "data-panel-mode": panelMode, "data-state": "ready", dir: direction, children: [_jsx("div", { className: "hjm-tabs__list", role: "tablist", "aria-label": label, "aria-orientation": orientation, children: items.map((item) => {
+                    const selected = item.id === value;
+                    const tabId = getTabId(baseId, item.id);
+                    const leadingSize = iconRecipe.sizes[tabsRecipe.icon.glyph];
+                    return (_jsxs("button", { ref: (node) => {
+                            if (node)
+                                tabRefs.current.set(item.id, node);
+                            else
+                                tabRefs.current.delete(item.id);
+                        }, id: tabId, type: "button", role: "tab", className: "hjm-tabs__tab", "data-state": selected ? "selected" : "idle", "aria-selected": selected, "aria-controls": panelId(item.id), tabIndex: item.id === resolvedFocusValue ? 0 : -1, disabled: item.disabled, onClick: () => {
+                            setFocusValue(item.id);
+                            setValue(item.id);
+                        }, onKeyDown: (event) => handleKeyDown(event, item.id), children: [item.renderLeading ? (_jsx("span", { "aria-hidden": "true", className: "hjm-tabs__leading", children: item.renderLeading({
+                                    selected,
+                                    disabled: item.disabled ?? false,
+                                    color: "currentColor",
+                                    size: leadingSize,
+                                    glyphSize: leadingSize,
+                                }) })) : null, item.label] }, item.id));
+                }) }), !renderPanels ? null : panelMode === "dynamic" ? (_jsx(TabPanelHost, { id: panelId(value), labelledBy: getTabId(baseId, value), selected: true, dynamic: true, children: items.find((item) => item.id === value)?.panel })) : items.map((item) => {
+                const selected = item.id === value;
+                const mounted = mountPolicy === "always" ||
+                    (mountPolicy === "visited" && (visited.has(item.id) || selected)) ||
+                    (mountPolicy === "active" && selected);
+                return mounted ? (_jsx(TabPanelHost, { id: panelId(item.id), labelledBy: getTabId(baseId, item.id), selected: selected, dynamic: false, children: item.panel }, item.id)) : null;
+            })] }));
+});
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../src/navigation.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  getTabNavigationIntent,\n  getTabNavigationTarget,\n  resolveInitialTabValue,\n  tabsBehaviorDefaults,\n  type TabsActivationMode,\n  type TabsDirection,\n  type TabsMountPolicy,\n  type TabsOrientation,\n  type TabsPanelMode,\n} from \"@hjmds/design-contracts/behaviors\";\nimport {\n  iconRecipe,\n  tabsRecipe,\n  type TabSize,\n  type TabsLayout,\n  type TabsOverflow,\n} from \"@hjmds/design-contracts/recipes\";\nimport {\n  forwardRef,\n  useEffect,\n  useId,\n  useRef,\n  useState,\n  type HTMLAttributes,\n  type KeyboardEvent,\n  type ReactNode,\n} from \"react\";\nimport { classNames, useControllableState } from \"./internal.js\";\nimport { useOptionalHjmTheme } from \"./provider.js\";\n\nexport type TabLeadingRenderProps = Readonly<{\n  selected: boolean;\n  disabled: boolean;\n  color: \"currentColor\";\n  /** Pixel size resolved from `tabsRecipe.icon.glyph`. */\n  size: number;\n  /** Compatibility alias for product icon libraries that name this value explicitly. */\n  glyphSize: number;\n}>;\n\nexport type TabItem = Readonly<{\n  id: string;\n  label: ReactNode;\n  panel?: ReactNode;\n  renderLeading?: (state: TabLeadingRenderProps) => ReactNode;\n  disabled?: boolean;\n}>;\n\ntype TabsSelection =\n  | Readonly<{\n      value: string;\n      defaultValue?: never;\n      onValueChange(value: string): void;\n    }>\n  | Readonly<{\n      value?: never;\n      defaultValue?: string;\n      onValueChange?: (value: string) => void;\n    }>;\n\nexport type TabsProps = Omit<HTMLAttributes<HTMLDivElement>, \"dir\" | \"onChange\"> &\n  TabsSelection &\n  Readonly<{\n    label: string;\n    items: readonly TabItem[];\n    activationMode?: TabsActivationMode;\n    mountPolicy?: TabsMountPolicy;\n    panelMode?: TabsPanelMode;\n    orientation?: TabsOrientation;\n    direction?: TabsDirection;\n    loop?: boolean;\n    size?: TabSize;\n    layout?: TabsLayout;\n    overflow?: TabsOverflow;\n    /** Set false when panels are rendered separately with `TabPanel`. */\n    renderPanels?: boolean;\n  }>;\n\nfunction validateItems(items: readonly TabItem[]): void {\n  if (items.length === 0) throw new TypeError(\"Tabs requires at least one item\");\n  const ids = new Set<string>();\n  for (const item of items) {\n    if (item.id.trim().length === 0) throw new TypeError(\"Tabs item id must not be empty\");\n    if (ids.has(item.id)) throw new TypeError(`Duplicate Tabs item id: ${item.id}`);\n    ids.add(item.id);\n  }\n  if (!items.some((item) => !item.disabled)) {\n    throw new TypeError(\"Tabs requires at least one enabled item\");\n  }\n}\n\nconst panelFocusableSelector = [\n  \"a[href]\",\n  \"button:not([disabled])\",\n  \"input:not([disabled])\",\n  \"select:not([disabled])\",\n  \"textarea:not([disabled])\",\n  \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\ntype TabPanelHostProps = HTMLAttributes<HTMLDivElement> & Readonly<{\n  id: string;\n  labelledBy: string;\n  selected: boolean;\n  dynamic: boolean;\n  children: ReactNode;\n}>;\n\nfunction TabPanelHost({\n  id,\n  labelledBy,\n  selected,\n  dynamic,\n  children,\n  className,\n  ...props\n}: TabPanelHostProps) {\n  const ref = useRef<HTMLDivElement>(null);\n  const [hasFocusableContent, setHasFocusableContent] = useState(false);\n  useEffect(() => {\n    setHasFocusableContent(\n      ref.current?.querySelector(panelFocusableSelector) !== null,\n    );\n  }, [children]);\n\n  return (\n    <div\n      {...props}\n      ref={ref}\n      id={id}\n      role=\"tabpanel\"\n      className={classNames(\"hjm-tabs__panel\", className)}\n      aria-labelledby={labelledBy}\n      tabIndex={selected && !hasFocusableContent ? 0 : undefined}\n      hidden={!selected}\n      inert={selected ? undefined : true}\n      data-state={selected ? \"active\" : \"inactive\"}\n      data-panel-mode={dynamic ? \"dynamic\" : \"keyed\"}\n    >\n      {children}\n    </div>\n  );\n}\n\nfunction encodedTabId(value: string): string {\n  return encodeURIComponent(value);\n}\n\nexport function getTabId(tabsId: string, value: string): string {\n  return `${tabsId}-tab-${encodedTabId(value)}`;\n}\n\nexport function getTabPanelId(\n  tabsId: string,\n  value: string,\n  mode: TabsPanelMode = \"keyed\",\n): string {\n  return mode === \"dynamic\"\n    ? `${tabsId}-panel`\n    : `${tabsId}-panel-${encodedTabId(value)}`;\n}\n\nexport function getDynamicTabPanelId(tabsId: string): string {\n  return getTabPanelId(tabsId, \"\", \"dynamic\");\n}\n\ntype ExternalTabPanelBaseProps = Omit<HTMLAttributes<HTMLDivElement>, \"id\"> &\n  Readonly<{\n    tabsId: string;\n    activeValue: string;\n    children: ReactNode;\n  }>;\n\nexport type TabPanelProps = ExternalTabPanelBaseProps &\n  (\n    | Readonly<{\n        mode: \"dynamic\";\n        value?: never;\n        mountPolicy?: never;\n      }>\n    | Readonly<{\n        mode?: \"keyed\";\n        value: string;\n        mountPolicy?: TabsMountPolicy;\n      }>\n  );\n\n/** External panel host for products that keep routing, query, or scroll state outside Tabs. */\nexport function TabPanel(props: TabPanelProps) {\n  const { tabsId, activeValue, children } = props;\n  const dynamic = props.mode === \"dynamic\";\n  const value = dynamic ? activeValue : props.value;\n  const selected = value === activeValue;\n  const mountPolicy = dynamic ? \"active\" : props.mountPolicy ?? tabsBehaviorDefaults.mountPolicy;\n  let hostProps: Omit<HTMLAttributes<HTMLDivElement>, \"id\">;\n  if (props.mode === \"dynamic\") {\n    const {\n      tabsId: _tabsId,\n      activeValue: _activeValue,\n      children: _children,\n      mode: _mode,\n      ...htmlProps\n    } = props;\n    hostProps = htmlProps;\n  } else {\n    const {\n      tabsId: _tabsId,\n      activeValue: _activeValue,\n      children: _children,\n      mode: _mode,\n      value: _value,\n      mountPolicy: _mountPolicy,\n      ...htmlProps\n    } = props;\n    hostProps = htmlProps;\n  }\n  const [visited, setVisited] = useState(selected);\n  useEffect(() => {\n    if (selected) setVisited(true);\n  }, [selected]);\n  const mounted =\n    dynamic ||\n    selected ||\n    mountPolicy === \"always\" ||\n    (mountPolicy === \"visited\" && visited);\n  if (!mounted) return null;\n  return (\n    <TabPanelHost\n      {...hostProps}\n      id={getTabPanelId(tabsId, value, dynamic ? \"dynamic\" : \"keyed\")}\n      labelledBy={getTabId(tabsId, dynamic ? activeValue : value)}\n      selected={selected}\n      dynamic={dynamic}\n    >\n      {children}\n    </TabPanelHost>\n  );\n}\n\nexport const Tabs = forwardRef<HTMLDivElement, TabsProps>(function Tabs(\n  props,\n  ref,\n) {\n  const {\n    label,\n    items,\n    activationMode = tabsBehaviorDefaults.activationMode,\n    mountPolicy = tabsBehaviorDefaults.mountPolicy,\n    panelMode = tabsBehaviorDefaults.panelMode,\n    orientation = tabsBehaviorDefaults.orientation,\n    direction: directionProp,\n    loop = tabsBehaviorDefaults.loop,\n    size = tabsRecipe.defaults.size,\n    layout = tabsRecipe.defaults.layout,\n    overflow = tabsRecipe.defaults.overflow,\n    renderPanels = true,\n    className,\n    id,\n    value: valueProp,\n    defaultValue,\n    onValueChange,\n    ...rest\n  } = props;\n  validateItems(items);\n  if (label.trim().length === 0) throw new TypeError(\"Tabs label must not be empty\");\n  if (panelMode === \"dynamic\" && mountPolicy !== \"active\") {\n    throw new TypeError(\"Tabs dynamic panelMode requires active mountPolicy\");\n  }\n  const descriptors = items.map((item) => ({\n    id: item.id,\n    label: item.id,\n    ...(item.disabled === undefined ? {} : { disabled: item.disabled }),\n  }));\n  const initialValueRef = useRef<Readonly<{ value: string }> | null>(null);\n  if (initialValueRef.current === null) {\n    const resolved = resolveInitialTabValue(descriptors, defaultValue);\n    if (resolved === undefined) throw new TypeError(\"Tabs requires an enabled item\");\n    initialValueRef.current = { value: resolved };\n  }\n  const initialValue = initialValueRef.current.value;\n  const collectionFallback = items.find((item) => !item.disabled)?.id;\n  if (collectionFallback === undefined) throw new TypeError(\"Tabs requires an enabled item\");\n  const [storedValue, setValue] = useControllableState({\n    ...(valueProp === undefined ? {} : { value: valueProp }),\n    defaultValue: initialValue,\n    ...(onValueChange === undefined ? {} : { onChange: onValueChange }),\n  });\n  const controlled = valueProp !== undefined;\n  const storedSelectionIsValid = items.some(\n    (item) => item.id === storedValue && !item.disabled,\n  );\n  if (controlled && !storedSelectionIsValid) {\n    throw new RangeError(`Tabs value must identify an enabled item: ${storedValue}`);\n  }\n  const value = storedSelectionIsValid ? storedValue : collectionFallback;\n  const [focusValue, setFocusValue] = useState(value);\n  const resolvedFocusValue = items.some(\n    (item) => item.id === focusValue && !item.disabled,\n  )\n    ? focusValue\n    : value;\n  const [visited, setVisited] = useState<ReadonlySet<string>>(() => new Set([value]));\n  const tabRefs = useRef(new Map<string, HTMLButtonElement>());\n  const generatedId = useId().replaceAll(\":\", \"\");\n  const baseId = id ?? `hjm-${generatedId}`;\n  const theme = useOptionalHjmTheme();\n  const direction = directionProp ?? theme?.environment.direction ?? tabsBehaviorDefaults.direction;\n\n  useEffect(() => {\n    if (!controlled && !storedSelectionIsValid) setValue(collectionFallback);\n  }, [collectionFallback, controlled, setValue, storedSelectionIsValid]);\n  useEffect(() => {\n    if (!items.some((item) => item.id === focusValue && !item.disabled)) {\n      setFocusValue(value);\n    }\n  }, [focusValue, items, value]);\n  useEffect(() => {\n    setVisited((current) => {\n      const known = new Set(items.map((item) => item.id));\n      const next = new Set([...current].filter((id) => known.has(id)));\n      next.add(value);\n      if (\n        next.size === current.size &&\n        [...next].every((id) => current.has(id))\n      ) return current;\n      return next;\n    });\n  }, [items, value]);\n\n  const focusItem = (id: string) => {\n    setFocusValue(id);\n    if (activationMode === \"automatic\") setValue(id);\n    queueMicrotask(() => tabRefs.current.get(id)?.focus());\n  };\n  const handleKeyDown = (event: KeyboardEvent<HTMLButtonElement>, id: string) => {\n    const intent = getTabNavigationIntent(\n      event.key === \" \" ? \"Space\" : event.key as Parameters<typeof getTabNavigationIntent>[0],\n      orientation,\n      direction,\n    );\n    if (intent !== undefined) {\n      const target = getTabNavigationTarget(descriptors, id, intent, loop);\n      if (target !== undefined) {\n        event.preventDefault();\n        focusItem(target);\n      }\n      return;\n    }\n    if (\n      activationMode === \"manual\" &&\n      (event.key === \"Enter\" || event.key === \" \")\n    ) {\n      event.preventDefault();\n      setValue(id);\n    }\n  };\n  const panelId = (value: string) => getTabPanelId(baseId, value, panelMode);\n\n  return (\n    <div\n      {...rest}\n      ref={ref}\n      id={baseId}\n      className={classNames(\"hjm-tabs\", className)}\n      data-size={size}\n      data-layout={layout}\n      data-overflow={overflow}\n      data-orientation={orientation}\n      data-mount-policy={mountPolicy}\n      data-panel-mode={panelMode}\n      data-state=\"ready\"\n      dir={direction}\n    >\n      <div\n        className=\"hjm-tabs__list\"\n        role=\"tablist\"\n        aria-label={label}\n        aria-orientation={orientation}\n      >\n        {items.map((item) => {\n          const selected = item.id === value;\n          const tabId = getTabId(baseId, item.id);\n          const leadingSize = iconRecipe.sizes[tabsRecipe.icon.glyph];\n          return (\n            <button\n              key={item.id}\n              ref={(node) => {\n                if (node) tabRefs.current.set(item.id, node);\n                else tabRefs.current.delete(item.id);\n              }}\n              id={tabId}\n              type=\"button\"\n              role=\"tab\"\n              className=\"hjm-tabs__tab\"\n              data-state={selected ? \"selected\" : \"idle\"}\n              aria-selected={selected}\n              aria-controls={panelId(item.id)}\n              tabIndex={item.id === resolvedFocusValue ? 0 : -1}\n              disabled={item.disabled}\n              onClick={() => {\n                setFocusValue(item.id);\n                setValue(item.id);\n              }}\n              onKeyDown={(event) => handleKeyDown(event, item.id)}\n            >\n              {item.renderLeading ? (\n                <span aria-hidden=\"true\" className=\"hjm-tabs__leading\">\n                  {item.renderLeading({\n                    selected,\n                    disabled: item.disabled ?? false,\n                    color: \"currentColor\",\n                    size: leadingSize,\n                    glyphSize: leadingSize,\n                  })}\n                </span>\n              ) : null}\n              {item.label}\n            </button>\n          );\n        })}\n      </div>\n      {!renderPanels ? null : panelMode === \"dynamic\" ? (\n        <TabPanelHost\n          id={panelId(value)}\n          labelledBy={getTabId(baseId, value)}\n          selected\n          dynamic\n        >\n          {items.find((item) => item.id === value)?.panel}\n        </TabPanelHost>\n      ) : items.map((item) => {\n        const selected = item.id === value;\n        const mounted = mountPolicy === \"always\" ||\n          (mountPolicy === \"visited\" && (visited.has(item.id) || selected)) ||\n          (mountPolicy === \"active\" && selected);\n        return mounted ? (\n          <TabPanelHost\n            key={item.id}\n            id={panelId(item.id)}\n            labelledBy={getTabId(baseId, item.id)}\n            selected={selected}\n            dynamic={false}\n          >\n            {item.panel}\n          </TabPanelHost>\n        ) : null;\n      })}\n    </div>\n  );\n});\n"]}

package/dist/number-field.d.ts

@@ -0,0 +1,55 @@
+import { type NumberFieldSize, type NumberFieldValue } from "@hjmds/design-contracts/components/number-field";
+import { type InputHTMLAttributes, type ReactNode } from "react";
+type NativeNumberInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "aria-errormessage" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "className" | "defaultValue" | "disabled" | "max" | "min" | "onChange" | "readOnly" | "required" | "role" | "size" | "step" | "type" | "value">;
+export type NumberFieldProps = NativeNumberInputProps & Readonly<{
+    label: ReactNode;
+    min: number;
+    max: number;
+    step?: number;
+    value?: NumberFieldValue;
+    defaultValue?: NumberFieldValue;
+    onValueChange?: (value: NumberFieldValue) => void;
+    description?: ReactNode;
+    error?: ReactNode;
+    required?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    size?: NumberFieldSize;
+    /** Product-localized accessible name for the decrement action. */
+    decrementLabel: string;
+    /** Product-localized accessible name for the increment action. */
+    incrementLabel: string;
+    /** Optional product formatting for assistive output, never the editable text. */
+    getValueText?: (value: number) => string;
+    className?: string;
+    inputClassName?: string;
+}>;
+/**
+ * Exact numeric entry with a nullable draft and explicit single-step actions.
+ * Typing commits on blur; steppers and ArrowUp/ArrowDown commit immediately.
+ */
+export declare const NumberField: import("react").ForwardRefExoticComponent<NativeNumberInputProps & Readonly<{
+    label: ReactNode;
+    min: number;
+    max: number;
+    step?: number;
+    value?: NumberFieldValue;
+    defaultValue?: NumberFieldValue;
+    onValueChange?: (value: NumberFieldValue) => void;
+    description?: ReactNode;
+    error?: ReactNode;
+    required?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    size?: NumberFieldSize;
+    /** Product-localized accessible name for the decrement action. */
+    decrementLabel: string;
+    /** Product-localized accessible name for the increment action. */
+    incrementLabel: string;
+    /** Optional product formatting for assistive output, never the editable text. */
+    getValueText?: (value: number) => string;
+    className?: string;
+    inputClassName?: string;
+}> & import("react").RefAttributes<HTMLInputElement>>;
+export {};
+//# sourceMappingURL=number-field.d.ts.map

package/dist/number-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-field.d.ts","sourceRoot":"","sources":["../src/number-field.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAOL,KAAK,mBAAmB,EAExB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,KAAK,sBAAsB,GAAG,IAAI,CAChC,mBAAmB,CAAC,gBAAgB,CAAC,EACnC,mBAAmB,GACnB,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,UAAU,GACV,WAAW,GACX,cAAc,GACd,UAAU,GACV,KAAK,GACL,KAAK,GACL,UAAU,GACV,UAAU,GACV,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,CACV,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GACnD,QAAQ,CAAC;IACP,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAWL;;;GAGG;AACH,eAAO,MAAM,WAAW;WApCb,SAAS;SACX,MAAM;SACN,MAAM;WACJ,MAAM;YACL,gBAAgB;mBACT,gBAAgB;oBACf,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI;kBACnC,SAAS;YACf,SAAS;eACN,OAAO;eACP,OAAO;eACP,OAAO;WACX,eAAe;IACtB,kEAAkE;oBAClD,MAAM;IACtB,kEAAkE;oBAClD,MAAM;IACtB,iFAAiF;mBAClE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM;gBAC5B,MAAM;qBACD,MAAM;qDAuN1B,CAAC"}

package/dist/number-field.js

@@ -0,0 +1,107 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { commitNumberFieldInput, parseNumberFieldInput, resolveNumberFieldDescriptor, resolveNumberFieldInputStepperState, stepNumberFieldInput, } from "@hjmds/design-contracts/components/number-field";
+import { forwardRef, useEffect, useId, useRef, useState, } from "react";
+import { classNames, composeRefs, useControllableState } from "./internal.js";
+function valueToInput(value) {
+    return value === null ? "" : String(value);
+}
+function defaultInputMode(min, step) {
+    if (min < 0)
+        return "text";
+    return Number.isInteger(step) ? "numeric" : "decimal";
+}
+/**
+ * Exact numeric entry with a nullable draft and explicit single-step actions.
+ * Typing commits on blur; steppers and ArrowUp/ArrowDown commit immediately.
+ */
+export const NumberField = forwardRef(function NumberField({ id, label, min, max, step, value, defaultValue = null, onValueChange, description, error, required = false, disabled = false, readOnly = false, size = "medium", decrementLabel, incrementLabel, getValueText, className, inputClassName, inputMode, onBlur, onFocus, onKeyDown, "aria-describedby": ariaDescribedBy, "aria-invalid": ariaInvalid, ...inputProps }, forwardedRef) {
+    const generatedId = useId();
+    const controlId = id ?? `hjm-number-${generatedId.replaceAll(":", "")}`;
+    const descriptionId = `${controlId}-description`;
+    const errorId = `${controlId}-error`;
+    const inputRef = useRef(null);
+    const controlled = value !== undefined;
+    const controlledAtMount = useRef(controlled);
+    if (controlledAtMount.current !== controlled) {
+        throw new Error("HJM components cannot switch between controlled and uncontrolled state");
+    }
+    const [currentValue, setCurrentValue] = useControllableState({
+        ...(controlled ? { value } : {}),
+        defaultValue,
+        ...(onValueChange === undefined ? {} : { onChange: onValueChange }),
+    });
+    const descriptor = resolveNumberFieldDescriptor({
+        value: currentValue,
+        min,
+        max,
+        ...(step === undefined ? {} : { step }),
+    });
+    const [draft, setDraft] = useState(() => valueToInput(currentValue));
+    const [focused, setFocused] = useState(false);
+    const stepper = resolveNumberFieldInputStepperState(draft, descriptor);
+    useEffect(() => {
+        setDraft(valueToInput(currentValue));
+    }, [currentValue]);
+    const restoreOrDisplay = (next) => {
+        setDraft(valueToInput(controlled ? currentValue : next));
+    };
+    const commitDraft = () => {
+        const next = commitNumberFieldInput(draft, descriptor);
+        if (next === undefined) {
+            setDraft(valueToInput(currentValue));
+            return;
+        }
+        if (!Object.is(next, currentValue))
+            setCurrentValue(next);
+        restoreOrDisplay(next);
+    };
+    const stepValue = (direction) => {
+        if (disabled || readOnly)
+            return;
+        const next = stepNumberFieldInput(draft, descriptor, direction);
+        if (!Object.is(next, currentValue))
+            setCurrentValue(next);
+        restoreOrDisplay(next);
+        inputRef.current?.focus({ preventScroll: true });
+    };
+    const handleFocus = (event) => {
+        setFocused(true);
+        onFocus?.(event);
+    };
+    const handleBlur = (event) => {
+        setFocused(false);
+        commitDraft();
+        onBlur?.(event);
+    };
+    const handleKeyDown = (event) => {
+        onKeyDown?.(event);
+        if (event.defaultPrevented || disabled || readOnly)
+            return;
+        if (event.key === "ArrowUp" || event.key === "ArrowDown") {
+            event.preventDefault();
+            stepValue(event.key === "ArrowUp" ? "increment" : "decrement");
+        }
+        else if (event.key === "Enter") {
+            commitDraft();
+        }
+    };
+    const unavailable = disabled || readOnly;
+    const state = disabled
+        ? "disabled"
+        : error || ariaInvalid
+            ? "invalid"
+            : focused
+                ? "focused"
+                : "idle";
+    const describedBy = [
+        ariaDescribedBy,
+        error ? errorId : description ? descriptionId : undefined,
+    ].filter(Boolean).join(" ") || undefined;
+    const parsedDraft = parseNumberFieldInput(draft);
+    const announcedValue = typeof parsedDraft === "number" && parsedDraft >= min && parsedDraft <= max
+        ? parsedDraft
+        : currentValue;
+    const valueText = announcedValue === null ? undefined : getValueText?.(announcedValue);
+    return (_jsxs("div", { className: classNames("hjm-field", "hjm-number-field", className), "data-availability": disabled ? "disabled" : readOnly ? "readOnly" : "enabled", "data-size": size, "data-state": state, "data-value": currentValue === null ? "empty" : "filled", children: [_jsxs("label", { className: "hjm-field__label", htmlFor: controlId, children: [label, required ? _jsx("span", { "aria-hidden": "true", children: " *" }) : null] }), _jsxs("div", { className: "hjm-field__control hjm-number-field__control", children: [_jsx("button", { type: "button", "aria-controls": controlId, "aria-label": decrementLabel, className: "hjm-number-field__stepper", "data-direction": "decrement", disabled: unavailable || stepper.decrementDisabled, onClick: () => stepValue("decrement"), onMouseDown: (event) => event.preventDefault(), tabIndex: -1, children: _jsx("span", { "aria-hidden": "true", children: "\u2212" }) }), _jsx("input", { ...inputProps, ref: composeRefs(inputRef, forwardedRef), id: controlId, type: "text", role: "spinbutton", className: classNames("hjm-field__input", "hjm-number-field__input", inputClassName), value: draft, inputMode: inputMode ?? defaultInputMode(min, descriptor.step), required: required, disabled: disabled, readOnly: readOnly, "aria-invalid": error ? true : ariaInvalid, "aria-describedby": describedBy, ...(error ? { "aria-errormessage": errorId } : {}), "aria-valuemin": min, "aria-valuemax": max, ...(announcedValue === null ? {} : { "aria-valuenow": announcedValue }), ...(valueText === undefined ? {} : { "aria-valuetext": valueText }), onChange: (event) => setDraft(event.currentTarget.value), onFocus: handleFocus, onBlur: handleBlur, onKeyDown: handleKeyDown }), _jsx("button", { type: "button", "aria-controls": controlId, "aria-label": incrementLabel, className: "hjm-number-field__stepper", "data-direction": "increment", disabled: unavailable || stepper.incrementDisabled, onClick: () => stepValue("increment"), onMouseDown: (event) => event.preventDefault(), tabIndex: -1, children: _jsx("span", { "aria-hidden": "true", children: "+" }) })] }), description && !error ? (_jsx("div", { id: descriptionId, className: "hjm-field__description", children: description })) : null, error ? (_jsx("div", { id: errorId, className: "hjm-field__error", children: error })) : null] }));
+});
+//# sourceMappingURL=number-field.js.map

package/dist/number-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-field.js","sourceRoot":"","sources":["../src/number-field.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,mCAAmC,EACnC,oBAAoB,GAGrB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,UAAU,EACV,SAAS,EACT,KAAK,EACL,MAAM,EACN,QAAQ,GAKT,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAkD9E,SAAS,YAAY,CAAC,KAAuB;IAC3C,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,IAAY;IACjD,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3B,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CACnC,SAAS,WAAW,CAClB,EACE,EAAE,EACF,KAAK,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACJ,KAAK,EACL,YAAY,GAAG,IAAI,EACnB,aAAa,EACb,WAAW,EACX,KAAK,EACL,QAAQ,GAAG,KAAK,EAChB,QAAQ,GAAG,KAAK,EAChB,QAAQ,GAAG,KAAK,EAChB,IAAI,GAAG,QAAQ,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,SAAS,EACT,cAAc,EACd,SAAS,EACT,MAAM,EACN,OAAO,EACP,SAAS,EACT,kBAAkB,EAAE,eAAe,EACnC,cAAc,EAAE,WAAW,EAC3B,GAAG,UAAU,EACd,EACD,YAAY;IAEZ,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,EAAE,IAAI,cAAc,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;IACxE,MAAM,aAAa,GAAG,GAAG,SAAS,cAAc,CAAC;IACjD,MAAM,OAAO,GAAG,GAAG,SAAS,QAAQ,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,CAAmB,IAAI,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,KAAK,KAAK,SAAS,CAAC;IACvC,MAAM,iBAAiB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,iBAAiB,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,oBAAoB,CAAmB;QAC7E,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,YAAY;QACZ,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;KACpE,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,4BAA4B,CAAC;QAC9C,KAAK,EAAE,YAAY;QACnB,GAAG;QACH,GAAG;QACH,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;KACxC,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,mCAAmC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAEvE,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;IACvC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,MAAM,gBAAgB,GAAG,CAAC,IAAsB,EAAE,EAAE;QAClD,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;YAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1D,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,SAAoC,EAAE,EAAE;QACzD,IAAI,QAAQ,IAAI,QAAQ;YAAE,OAAO;QACjC,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;YAAE,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1D,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,KAAmC,EAAE,EAAE;QAC1D,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,KAAmC,EAAE,EAAE;QACzD,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,MAAM,aAAa,GAAG,CAAC,KAAsC,EAAE,EAAE;QAC/D,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,gBAAgB,IAAI,QAAQ,IAAI,QAAQ;YAAE,OAAO;QAC3D,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YACzD,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACjE,CAAC;aAAM,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YACjC,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,QAAQ,IAAI,QAAQ,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ;QACpB,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,KAAK,IAAI,WAAW;YACpB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,OAAO;gBACP,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,MAAM,CAAC;IACf,MAAM,WAAW,GAAG;QAClB,eAAe;QACf,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;KAC1D,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;IACzC,MAAM,WAAW,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,cAAc,GAClB,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,IAAI,GAAG,IAAI,WAAW,IAAI,GAAG;QACzE,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,YAAY,CAAC;IACnB,MAAM,SAAS,GAAG,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,cAAc,CAAC,CAAC;IAEvF,OAAO,CACL,eACE,SAAS,EAAE,UAAU,CAAC,WAAW,EAAE,kBAAkB,EAAE,SAAS,CAAC,uBAC9C,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,eACjE,IAAI,gBACH,KAAK,gBACL,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,aAEtD,iBAAO,SAAS,EAAC,kBAAkB,EAAC,OAAO,EAAE,SAAS,aACnD,KAAK,EACL,QAAQ,CAAC,CAAC,CAAC,8BAAkB,MAAM,mBAAU,CAAC,CAAC,CAAC,IAAI,IAC/C,EACR,eAAK,SAAS,EAAC,8CAA8C,aAC3D,iBACE,IAAI,EAAC,QAAQ,mBACE,SAAS,gBACZ,cAAc,EAC1B,SAAS,EAAC,2BAA2B,oBACtB,WAAW,EAC1B,QAAQ,EAAE,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAClD,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,EACrC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAC9C,QAAQ,EAAE,CAAC,CAAC,YAEZ,8BAAkB,MAAM,uBAAS,GAC1B,EACT,mBACM,UAAU,EACd,GAAG,EAAE,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,EACxC,EAAE,EAAE,SAAS,EACb,IAAI,EAAC,MAAM,EACX,IAAI,EAAC,YAAY,EACjB,SAAS,EAAE,UAAU,CACnB,kBAAkB,EAClB,yBAAyB,EACzB,cAAc,CACf,EACD,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,IAAI,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,EAC9D,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,kBACJ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,sBACtB,WAAW,KACzB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,mBACpC,GAAG,mBACH,GAAG,KACd,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,KACpE,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC,EACpE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,EACxD,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,aAAa,GACxB,EACF,iBACE,IAAI,EAAC,QAAQ,mBACE,SAAS,gBACZ,cAAc,EAC1B,SAAS,EAAC,2BAA2B,oBACtB,WAAW,EAC1B,QAAQ,EAAE,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAClD,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,EACrC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAC9C,QAAQ,EAAE,CAAC,CAAC,YAEZ,8BAAkB,MAAM,kBAAS,GAC1B,IACL,EACL,WAAW,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CACvB,cAAK,EAAE,EAAE,aAAa,EAAE,SAAS,EAAC,wBAAwB,YAAE,WAAW,GAAO,CAC/E,CAAC,CAAC,CAAC,IAAI,EACP,KAAK,CAAC,CAAC,CAAC,CACP,cAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAC,kBAAkB,YAAE,KAAK,GAAO,CAC7D,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC,CACF,CAAC","sourcesContent":["import {\n  commitNumberFieldInput,\n  parseNumberFieldInput,\n  resolveNumberFieldDescriptor,\n  resolveNumberFieldInputStepperState,\n  stepNumberFieldInput,\n  type NumberFieldSize,\n  type NumberFieldValue,\n} from \"@hjmds/design-contracts/components/number-field\";\nimport {\n  forwardRef,\n  useEffect,\n  useId,\n  useRef,\n  useState,\n  type FocusEvent,\n  type InputHTMLAttributes,\n  type KeyboardEvent,\n  type ReactNode,\n} from \"react\";\n\nimport { classNames, composeRefs, useControllableState } from \"./internal.js\";\n\ntype NativeNumberInputProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  | \"aria-errormessage\"\n  | \"aria-valuemax\"\n  | \"aria-valuemin\"\n  | \"aria-valuenow\"\n  | \"aria-valuetext\"\n  | \"children\"\n  | \"className\"\n  | \"defaultValue\"\n  | \"disabled\"\n  | \"max\"\n  | \"min\"\n  | \"onChange\"\n  | \"readOnly\"\n  | \"required\"\n  | \"role\"\n  | \"size\"\n  | \"step\"\n  | \"type\"\n  | \"value\"\n>;\n\nexport type NumberFieldProps = NativeNumberInputProps &\n  Readonly<{\n    label: ReactNode;\n    min: number;\n    max: number;\n    step?: number;\n    value?: NumberFieldValue;\n    defaultValue?: NumberFieldValue;\n    onValueChange?: (value: NumberFieldValue) => void;\n    description?: ReactNode;\n    error?: ReactNode;\n    required?: boolean;\n    disabled?: boolean;\n    readOnly?: boolean;\n    size?: NumberFieldSize;\n    /** Product-localized accessible name for the decrement action. */\n    decrementLabel: string;\n    /** Product-localized accessible name for the increment action. */\n    incrementLabel: string;\n    /** Optional product formatting for assistive output, never the editable text. */\n    getValueText?: (value: number) => string;\n    className?: string;\n    inputClassName?: string;\n  }>;\n\nfunction valueToInput(value: NumberFieldValue): string {\n  return value === null ? \"\" : String(value);\n}\n\nfunction defaultInputMode(min: number, step: number): \"decimal\" | \"numeric\" | \"text\" {\n  if (min < 0) return \"text\";\n  return Number.isInteger(step) ? \"numeric\" : \"decimal\";\n}\n\n/**\n * Exact numeric entry with a nullable draft and explicit single-step actions.\n * Typing commits on blur; steppers and ArrowUp/ArrowDown commit immediately.\n */\nexport const NumberField = forwardRef<HTMLInputElement, NumberFieldProps>(\n  function NumberField(\n    {\n      id,\n      label,\n      min,\n      max,\n      step,\n      value,\n      defaultValue = null,\n      onValueChange,\n      description,\n      error,\n      required = false,\n      disabled = false,\n      readOnly = false,\n      size = \"medium\",\n      decrementLabel,\n      incrementLabel,\n      getValueText,\n      className,\n      inputClassName,\n      inputMode,\n      onBlur,\n      onFocus,\n      onKeyDown,\n      \"aria-describedby\": ariaDescribedBy,\n      \"aria-invalid\": ariaInvalid,\n      ...inputProps\n    },\n    forwardedRef,\n  ) {\n    const generatedId = useId();\n    const controlId = id ?? `hjm-number-${generatedId.replaceAll(\":\", \"\")}`;\n    const descriptionId = `${controlId}-description`;\n    const errorId = `${controlId}-error`;\n    const inputRef = useRef<HTMLInputElement>(null);\n    const controlled = value !== undefined;\n    const controlledAtMount = useRef(controlled);\n    if (controlledAtMount.current !== controlled) {\n      throw new Error(\"HJM components cannot switch between controlled and uncontrolled state\");\n    }\n    const [currentValue, setCurrentValue] = useControllableState<NumberFieldValue>({\n      ...(controlled ? { value } : {}),\n      defaultValue,\n      ...(onValueChange === undefined ? {} : { onChange: onValueChange }),\n    });\n    const descriptor = resolveNumberFieldDescriptor({\n      value: currentValue,\n      min,\n      max,\n      ...(step === undefined ? {} : { step }),\n    });\n    const [draft, setDraft] = useState(() => valueToInput(currentValue));\n    const [focused, setFocused] = useState(false);\n    const stepper = resolveNumberFieldInputStepperState(draft, descriptor);\n\n    useEffect(() => {\n      setDraft(valueToInput(currentValue));\n    }, [currentValue]);\n\n    const restoreOrDisplay = (next: NumberFieldValue) => {\n      setDraft(valueToInput(controlled ? currentValue : next));\n    };\n\n    const commitDraft = () => {\n      const next = commitNumberFieldInput(draft, descriptor);\n      if (next === undefined) {\n        setDraft(valueToInput(currentValue));\n        return;\n      }\n      if (!Object.is(next, currentValue)) setCurrentValue(next);\n      restoreOrDisplay(next);\n    };\n\n    const stepValue = (direction: \"increment\" | \"decrement\") => {\n      if (disabled || readOnly) return;\n      const next = stepNumberFieldInput(draft, descriptor, direction);\n      if (!Object.is(next, currentValue)) setCurrentValue(next);\n      restoreOrDisplay(next);\n      inputRef.current?.focus({ preventScroll: true });\n    };\n\n    const handleFocus = (event: FocusEvent<HTMLInputElement>) => {\n      setFocused(true);\n      onFocus?.(event);\n    };\n    const handleBlur = (event: FocusEvent<HTMLInputElement>) => {\n      setFocused(false);\n      commitDraft();\n      onBlur?.(event);\n    };\n    const handleKeyDown = (event: KeyboardEvent<HTMLInputElement>) => {\n      onKeyDown?.(event);\n      if (event.defaultPrevented || disabled || readOnly) return;\n      if (event.key === \"ArrowUp\" || event.key === \"ArrowDown\") {\n        event.preventDefault();\n        stepValue(event.key === \"ArrowUp\" ? \"increment\" : \"decrement\");\n      } else if (event.key === \"Enter\") {\n        commitDraft();\n      }\n    };\n\n    const unavailable = disabled || readOnly;\n    const state = disabled\n      ? \"disabled\"\n      : error || ariaInvalid\n        ? \"invalid\"\n        : focused\n          ? \"focused\"\n          : \"idle\";\n    const describedBy = [\n      ariaDescribedBy,\n      error ? errorId : description ? descriptionId : undefined,\n    ].filter(Boolean).join(\" \") || undefined;\n    const parsedDraft = parseNumberFieldInput(draft);\n    const announcedValue =\n      typeof parsedDraft === \"number\" && parsedDraft >= min && parsedDraft <= max\n        ? parsedDraft\n        : currentValue;\n    const valueText = announcedValue === null ? undefined : getValueText?.(announcedValue);\n\n    return (\n      <div\n        className={classNames(\"hjm-field\", \"hjm-number-field\", className)}\n        data-availability={disabled ? \"disabled\" : readOnly ? \"readOnly\" : \"enabled\"}\n        data-size={size}\n        data-state={state}\n        data-value={currentValue === null ? \"empty\" : \"filled\"}\n      >\n        <label className=\"hjm-field__label\" htmlFor={controlId}>\n          {label}\n          {required ? <span aria-hidden=\"true\"> *</span> : null}\n        </label>\n        <div className=\"hjm-field__control hjm-number-field__control\">\n          <button\n            type=\"button\"\n            aria-controls={controlId}\n            aria-label={decrementLabel}\n            className=\"hjm-number-field__stepper\"\n            data-direction=\"decrement\"\n            disabled={unavailable || stepper.decrementDisabled}\n            onClick={() => stepValue(\"decrement\")}\n            onMouseDown={(event) => event.preventDefault()}\n            tabIndex={-1}\n          >\n            <span aria-hidden=\"true\">−</span>\n          </button>\n          <input\n            {...inputProps}\n            ref={composeRefs(inputRef, forwardedRef)}\n            id={controlId}\n            type=\"text\"\n            role=\"spinbutton\"\n            className={classNames(\n              \"hjm-field__input\",\n              \"hjm-number-field__input\",\n              inputClassName,\n            )}\n            value={draft}\n            inputMode={inputMode ?? defaultInputMode(min, descriptor.step)}\n            required={required}\n            disabled={disabled}\n            readOnly={readOnly}\n            aria-invalid={error ? true : ariaInvalid}\n            aria-describedby={describedBy}\n            {...(error ? { \"aria-errormessage\": errorId } : {})}\n            aria-valuemin={min}\n            aria-valuemax={max}\n            {...(announcedValue === null ? {} : { \"aria-valuenow\": announcedValue })}\n            {...(valueText === undefined ? {} : { \"aria-valuetext\": valueText })}\n            onChange={(event) => setDraft(event.currentTarget.value)}\n            onFocus={handleFocus}\n            onBlur={handleBlur}\n            onKeyDown={handleKeyDown}\n          />\n          <button\n            type=\"button\"\n            aria-controls={controlId}\n            aria-label={incrementLabel}\n            className=\"hjm-number-field__stepper\"\n            data-direction=\"increment\"\n            disabled={unavailable || stepper.incrementDisabled}\n            onClick={() => stepValue(\"increment\")}\n            onMouseDown={(event) => event.preventDefault()}\n            tabIndex={-1}\n          >\n            <span aria-hidden=\"true\">+</span>\n          </button>\n        </div>\n        {description && !error ? (\n          <div id={descriptionId} className=\"hjm-field__description\">{description}</div>\n        ) : null}\n        {error ? (\n          <div id={errorId} className=\"hjm-field__error\">{error}</div>\n        ) : null}\n      </div>\n    );\n  },\n);\n"]}

package/dist/otp-field.d.ts

@@ -0,0 +1,2 @@
+export { OtpField, type OtpFieldProps } from "./forms.js";
+//# sourceMappingURL=otp-field.d.ts.map

package/dist/otp-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otp-field.d.ts","sourceRoot":"","sources":["../src/otp-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/otp-field.js

@@ -0,0 +1,2 @@
+export { OtpField } from "./forms.js";
+//# sourceMappingURL=otp-field.js.map

package/dist/otp-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otp-field.js","sourceRoot":"","sources":["../src/otp-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsB,MAAM,YAAY,CAAC","sourcesContent":["export { OtpField, type OtpFieldProps } from \"./forms.js\";\n"]}