@multiplatform.one/forms 6.1.0 → 6.4.0

package/src/shared/interactionHooks.spec.tsx

@@ -0,0 +1,174 @@
+/**
+ * Shared interaction-hook contracts:
+ * - useSheetEscapeDismiss (LC-21): Escape dismisses sheet-mode popups from the
+ *   keyboard, but only while enabled, and inner popups that own Escape
+ *   (preventDefault) keep the sheet open; the listener detaches on unmount.
+ * - useWheelIncrement: wheel-up increments / wheel-down decrements once the
+ *   accumulated delta crosses the threshold, page scroll is prevented, and
+ *   disabled/readOnly inputs ignore the wheel.
+ */
+
+import { render, renderHook } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useSheetEscapeDismiss } from "./useSheetEscapeDismiss";
+import { useWheelIncrement } from "./useWheelIncrement";
+
+function pressEscape(defaultPrevented = false) {
+  const event = new KeyboardEvent("keydown", { key: "Escape", cancelable: true });
+  if (defaultPrevented) event.preventDefault();
+  window.dispatchEvent(event);
+  return event;
+}
+
+describe("useSheetEscapeDismiss", () => {
+  it("dismisses on Escape while enabled", () => {
+    const onDismiss = vi.fn();
+    renderHook(() => useSheetEscapeDismiss(true, onDismiss));
+    pressEscape();
+    expect(onDismiss).toHaveBeenCalledTimes(1);
+  });
+
+  it("ignores other keys", () => {
+    const onDismiss = vi.fn();
+    renderHook(() => useSheetEscapeDismiss(true, onDismiss));
+    window.dispatchEvent(new KeyboardEvent("keydown", { key: "Enter" }));
+    expect(onDismiss).not.toHaveBeenCalled();
+  });
+
+  it("does nothing while disabled", () => {
+    const onDismiss = vi.fn();
+    renderHook(() => useSheetEscapeDismiss(false, onDismiss));
+    pressEscape();
+    expect(onDismiss).not.toHaveBeenCalled();
+  });
+
+  it("respects inner popups that already handled Escape (defaultPrevented)", () => {
+    const onDismiss = vi.fn();
+    renderHook(() => useSheetEscapeDismiss(true, onDismiss));
+    pressEscape(true);
+    expect(onDismiss).not.toHaveBeenCalled();
+  });
+
+  it("always calls the latest onDismiss callback (no stale closure)", () => {
+    const first = vi.fn();
+    const second = vi.fn();
+    const { rerender } = renderHook(({ cb }) => useSheetEscapeDismiss(true, cb), {
+      initialProps: { cb: first },
+    });
+    rerender({ cb: second });
+    pressEscape();
+    expect(first).not.toHaveBeenCalled();
+    expect(second).toHaveBeenCalledTimes(1);
+  });
+
+  it("detaches the listener on unmount", () => {
+    const onDismiss = vi.fn();
+    const { unmount } = renderHook(() => useSheetEscapeDismiss(true, onDismiss));
+    unmount();
+    pressEscape();
+    expect(onDismiss).not.toHaveBeenCalled();
+  });
+});
+
+interface WheelHarnessProps {
+  onIncrement: () => void;
+  onDecrement: () => void;
+  disabled?: boolean;
+  readOnly?: boolean;
+  threshold?: number;
+}
+
+function WheelHarness(props: WheelHarnessProps) {
+  const { wheelProps } = useWheelIncrement(props);
+  return <div data-testid="wheel-target" ref={wheelProps.ref} />;
+}
+
+function dispatchWheel(target: Element, deltaY: number) {
+  const event = new WheelEvent("wheel", { deltaY, cancelable: true, bubbles: true });
+  target.dispatchEvent(event);
+  return event;
+}
+
+describe("useWheelIncrement", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    vi.setSystemTime(0);
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it("increments on wheel-up and decrements on wheel-down past the threshold", () => {
+    const onIncrement = vi.fn();
+    const onDecrement = vi.fn();
+    const { getByTestId } = render(
+      <WheelHarness onIncrement={onIncrement} onDecrement={onDecrement} />,
+    );
+    const target = getByTestId("wheel-target");
+    dispatchWheel(target, -30);
+    expect(onIncrement).toHaveBeenCalledTimes(1);
+    dispatchWheel(target, 30);
+    expect(onDecrement).toHaveBeenCalledTimes(1);
+  });
+
+  it("accumulates small trackpad deltas until the threshold is crossed", () => {
+    const onIncrement = vi.fn();
+    const onDecrement = vi.fn();
+    const { getByTestId } = render(
+      <WheelHarness onIncrement={onIncrement} onDecrement={onDecrement} />,
+    );
+    const target = getByTestId("wheel-target");
+    dispatchWheel(target, -10);
+    dispatchWheel(target, -10);
+    expect(onIncrement).not.toHaveBeenCalled();
+    dispatchWheel(target, -10);
+    expect(onIncrement).toHaveBeenCalledTimes(1);
+  });
+
+  it("resets the accumulated delta after a pause", () => {
+    const onIncrement = vi.fn();
+    const onDecrement = vi.fn();
+    const { getByTestId } = render(
+      <WheelHarness onIncrement={onIncrement} onDecrement={onDecrement} />,
+    );
+    const target = getByTestId("wheel-target");
+    dispatchWheel(target, -20);
+    // Pause longer than the 150ms accumulation window.
+    vi.setSystemTime(1000);
+    dispatchWheel(target, -20);
+    // 20 + (reset) 20 never crosses 30 in one window → no increment.
+    expect(onIncrement).not.toHaveBeenCalled();
+  });
+
+  it("prevents the page scroll (preventDefault on the wheel event)", () => {
+    const { getByTestId } = render(<WheelHarness onIncrement={vi.fn()} onDecrement={vi.fn()} />);
+    const event = dispatchWheel(getByTestId("wheel-target"), -30);
+    expect(event.defaultPrevented).toBe(true);
+  });
+
+  it("ignores the wheel when disabled or read-only", () => {
+    const onIncrement = vi.fn();
+    for (const props of [{ disabled: true }, { readOnly: true }]) {
+      const { getByTestId, unmount } = render(
+        <WheelHarness onIncrement={onIncrement} onDecrement={vi.fn()} {...props} />,
+      );
+      const event = dispatchWheel(getByTestId("wheel-target"), -60);
+      expect(onIncrement).not.toHaveBeenCalled();
+      expect(event.defaultPrevented).toBe(false);
+      unmount();
+    }
+  });
+
+  it("scales the trigger point with a custom threshold", () => {
+    const onIncrement = vi.fn();
+    const { getByTestId } = render(
+      <WheelHarness onIncrement={onIncrement} onDecrement={vi.fn()} threshold={2} />,
+    );
+    const target = getByTestId("wheel-target");
+    dispatchWheel(target, -30);
+    expect(onIncrement).not.toHaveBeenCalled();
+    dispatchWheel(target, -30);
+    expect(onIncrement).toHaveBeenCalledTimes(1);
+  });
+});

package/src/shared/t.ts

@@ -0,0 +1,23 @@
+import i18n from "i18next";
+
+type TOptions = Record<string, unknown>;
+
+function interpolate(template: string, options?: TOptions): string {
+  if (!options) return template;
+  return template.replace(/\{\{(\w+)\}\}/g, (_, key: string) =>
+    options[key] != null ? String(options[key]) : `{{${key}}}`,
+  );
+}
+
+/**
+ * Safe catalog lookup for non-component paths (preflight, error mappers).
+ * When i18n is not initialized (unit tests / headless DS), returns the English
+ * key with light `{{var}}` interpolation so callers never get `undefined`.
+ */
+export function t(key: string, options?: TOptions): string {
+  if (i18n?.isInitialized) {
+    const translated: unknown = i18n.t(key, options as never);
+    if (typeof translated === "string" && translated.length > 0) return translated;
+  }
+  return interpolate(key, options);
+}

package/src/shared/useSheetEscapeDismiss.ts

@@ -0,0 +1,26 @@
+import { useEffect, useRef } from "react";
+import { isWeb } from "tamagui";
+
+/**
+ * Dismiss a modal Sheet on Escape (web only).
+ *
+ * Tamagui's Sheet has no key handling of its own — Dialog dismisses via
+ * Dismissable, Sheet does not — so keyboard users cannot close sheet-mode
+ * popups and the exit slide (LC-24) is unreachable from the keyboard
+ * (LC-21 dismissal intent). Bubble-phase listener: inner popups (menus,
+ * comboboxes) that own Escape call stopPropagation()/preventDefault() and
+ * keep the sheet open.
+ */
+export function useSheetEscapeDismiss(enabled: boolean, onDismiss: () => void) {
+  const onDismissRef = useRef(onDismiss);
+  onDismissRef.current = onDismiss;
+  useEffect(() => {
+    if (!isWeb || !enabled) return;
+    const onKeyDown = (event: KeyboardEvent) => {
+      if (event.key !== "Escape" || event.defaultPrevented) return;
+      onDismissRef.current();
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => window.removeEventListener("keydown", onKeyDown);
+  }, [enabled]);
+}

package/src/shared/utils.ts

@@ -9,7 +9,8 @@ import { useResolvedKnobs } from "@multiplatform.one/theme";
 import type { SizeTokens } from "tamagui";
 import { getVariableValue, isWeb } from "tamagui";
 import { getSize } from "@tamagui/get-token";
-import { useFormContext } from "../Form";
+import { useFormContext, useFormValidate } from "../Form";
+import { remapValidatorsForTiming, resolveEffectiveValidateOn } from "../Form/validateOn";
 import type { AnyFormApi, SimpleFieldApi } from "../types";
 
 /**
@@ -77,8 +78,11 @@ export function getOTPCellRadius(radiusToken: string | undefined): number | stri
  * On native we use standard RN shadow props.
  */
 
+// Single light source (Axiom 14/15): every directional layer keeps the house
+// y-offset:blur ratio of 0.5 (light straight above); $1's second layer is a
+// directionless ambient ring (0 offset), matching the Switch thumb precedent.
 const webShadow: Record<string, string> = {
-  $1: "0 1px 3px rgba(0,0,0,0.12), 0 1px 2px rgba(0,0,0,0.08)",
+  $1: "0 1px 2px rgba(0,0,0,0.12), 0 0 1px rgba(0,0,0,0.08)",
   $2: "0 3px 6px rgba(0,0,0,0.15), 0 2px 4px rgba(0,0,0,0.10)",
   $4: "0 10px 20px rgba(0,0,0,0.15), 0 3px 6px rgba(0,0,0,0.10)",
 };
@@ -88,7 +92,7 @@ const nativeShadow: Record<string, Record<string, any>> = {
     shadowColor: "#000",
     shadowOffset: { width: 0, height: 1 },
     shadowOpacity: 0.12,
-    shadowRadius: 3,
+    shadowRadius: 2,
     elevation: 2,
   },
   $2: {
@@ -107,10 +111,16 @@ const nativeShadow: Record<string, Record<string, any>> = {
   },
 };
 
-function elevationToProps(token: string | undefined): Record<string, any> {
-  if (!token) return {};
-  if (isWeb) return { style: { boxShadow: webShadow[token] || webShadow["$2"] } };
-  return nativeShadow[token] || nativeShadow["$2"];
+// On native the theme emits NUMERIC tokens.size values instead of token
+// strings ($1=20, $2=28, $4=44) so raw RN Views never see a String for the
+// Double `elevation` prop (SB-N-04). Accept both spellings here.
+const elevationKeyAlias: Record<string, string> = { "20": "$1", "28": "$2", "44": "$4" };
+
+function elevationToProps(token: string | number | undefined): Record<string, any> {
+  if (token == null) return {};
+  const key = elevationKeyAlias[String(token)] ?? String(token);
+  if (isWeb) return { style: { boxShadow: webShadow[key] || webShadow["$2"] } };
+  return nativeShadow[key] || nativeShadow["$2"];
 }
 
 export function getElevationWrapperProps(
@@ -175,20 +185,29 @@ export function useResolvedValidators(
   name?: string,
   isEmpty: (value: unknown) => boolean = defaultIsEmpty,
 ): Record<string, unknown> | undefined {
+  const { validateOn, hasSubmitted } = useFormValidate();
+  const effective = resolveEffectiveValidateOn(validateOn, hasSubmitted);
+
   return useMemo(() => {
-    if (!required) return validators;
-    const requiredValidator = ({ value }: { value: unknown }) =>
-      isEmpty(value)
-        ? `${typeof label === "string" ? label : name || "Field"} is required`
-        : undefined;
-    if (!validators) return { onSubmit: requiredValidator };
-    const existingOnSubmit = validators.onSubmit as ((...args: any[]) => any) | undefined;
-    const composedOnSubmit = existingOnSubmit
-      ? ({ value }: { value: unknown }) =>
-          existingOnSubmit({ value }) ?? requiredValidator({ value })
-      : requiredValidator;
-    return { ...validators, onSubmit: composedOnSubmit };
-  }, [required, validators, label, name, isEmpty]);
+    let resolved = validators;
+    if (required) {
+      const requiredValidator = ({ value }: { value: unknown }) =>
+        isEmpty(value)
+          ? `${typeof label === "string" ? label : name || "Field"} is required`
+          : undefined;
+      if (!validators) {
+        resolved = { onSubmit: requiredValidator };
+      } else {
+        const existingOnSubmit = validators.onSubmit as ((...args: any[]) => any) | undefined;
+        const composedOnSubmit = existingOnSubmit
+          ? ({ value }: { value: unknown }) =>
+              existingOnSubmit({ value }) ?? requiredValidator({ value })
+          : requiredValidator;
+        resolved = { ...validators, onSubmit: composedOnSubmit };
+      }
+    }
+    return remapValidatorsForTiming(resolved, effective);
+  }, [required, validators, label, name, isEmpty, effective]);
 }
 
 export function mergeFieldHandler(

package/src/shared/zIndex.ts

@@ -22,25 +22,25 @@
  */
 
 // Local stacking within a component (badges, pinned columns, scroll arrows)
-export const zLocalBase = 1;
-export const zLocalElevated = 2;
-export const zLocalTop = 10;
+const zLocalBase = 1;
+const zLocalElevated = 2;
+const zLocalTop = 10;
 
 // Component-level overlays (sticky table headers, local overlays)
-export const zComponent = 100;
+const zComponent = 100;
 
 // Loading states, toasts, inline overlays
-export const zLoading = 1000;
+const zLoading = 1000;
 
 // Mobile sheets and drawer overlays
-export const zDrawerOverlay = 99999;
-export const zSheet = 100000;
+const zDrawerOverlay = 99999;
+const zSheet = 100000;
 
 // Floating dropdowns, popovers, modals (must be above sheets)
-export const zDropdown = 200000;
+const zDropdown = 200000;
 
 // Browser extension injection (max safe integer for DOM)
-export const zExtension = 2147483647;
+const zExtension = 2147483647;
 
 /**
  * Named z-index constants for common use cases.

package/src/utils/linkCell.spec.tsx

@@ -0,0 +1,60 @@
+/**
+ * LinkCell contract specs — the field/ChildTable cell link wrapper: content
+ * wraps in a Link only when linkResolver returns an href, resolver misses
+ * render plain content, and a throwing resolver degrades to plain content
+ * instead of crashing the cell.
+ */
+
+import { render } from "@testing-library/react";
+import { Text } from "tamagui";
+import { describe, expect, it, vi } from "vitest";
+import { LinkCell } from "./LinkCell";
+
+describe("LinkCell", () => {
+  it("wraps children in a link when the resolver returns an href", () => {
+    const { container, getByText } = render(
+      <LinkCell value="CUST-001" linkResolver={(value) => `/customers/${value}` as never}>
+        <Text>Acme Corp</Text>
+      </LinkCell>,
+    );
+    const anchor = container.querySelector("a");
+    expect(anchor).toBeTruthy();
+    expect(anchor!.getAttribute("href")).toBe("/customers/CUST-001");
+    expect(getByText("Acme Corp")).toBeTruthy();
+  });
+
+  it("renders plain children when the resolver returns null", () => {
+    const { container, getByText } = render(
+      <LinkCell value="x" linkResolver={() => null}>
+        <Text>No link</Text>
+      </LinkCell>,
+    );
+    expect(container.querySelector("a")).toBeNull();
+    expect(getByText("No link")).toBeTruthy();
+  });
+
+  it("passes the cell value to the resolver", () => {
+    const resolver = vi.fn(() => null);
+    render(
+      <LinkCell value={42} linkResolver={resolver}>
+        <Text>cell</Text>
+      </LinkCell>,
+    );
+    expect(resolver).toHaveBeenCalledWith(42);
+  });
+
+  it("degrades to plain content when the resolver throws", () => {
+    const { container, getByText } = render(
+      <LinkCell
+        value="x"
+        linkResolver={() => {
+          throw new Error("bad resolver");
+        }}
+      >
+        <Text>Still visible</Text>
+      </LinkCell>,
+    );
+    expect(container.querySelector("a")).toBeNull();
+    expect(getByText("Still visible")).toBeTruthy();
+  });
+});

package/types/AdaptivePopup/index.d.ts

@@ -0,0 +1,32 @@
+import { type ReactNode } from "react";
+export interface AdaptivePopupProps {
+    /** Controlled open state */
+    open: boolean;
+    /** Callback when popup opens/closes */
+    onOpenChange: (open: boolean) => void;
+    /** Optional trigger element. If not provided, control open state externally. */
+    trigger?: ReactNode;
+    /** Title shown in the header */
+    title?: ReactNode;
+    /** Description shown below the title */
+    description?: ReactNode;
+    /** Main content */
+    children: ReactNode;
+    /**
+     * Size of the popup on desktop.
+     * - `sm`: 400px max width
+     * - `md`: 600px max width (default)
+     * - `lg`: 800px max width
+     * - `xl`: 1000px max width
+     * - `fullscreen`: fills viewport with padding
+     */
+    size?: "sm" | "md" | "lg" | "xl" | "fullscreen";
+    /** Whether to show the close button. Default true. */
+    showCloseButton?: boolean;
+    /** Custom footer content (e.g. action buttons) */
+    footer?: ReactNode;
+    /** Whether to disable the trigger */
+    disabled?: boolean;
+}
+export declare function AdaptivePopup({ open, onOpenChange, trigger, title, description, children, size, showCloseButton, footer, disabled, }: AdaptivePopupProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/types/AdaptivePopup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/AdaptivePopup/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAU/C,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,uCAAuC;IACvC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,gFAAgF;IAChF,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,gCAAgC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wCAAwC;IACxC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,mBAAmB;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,YAAY,CAAC;IAChD,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kDAAkD;IAClD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkBD,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,YAAY,EACZ,OAAO,EACP,KAAK,EACL,WAAW,EACX,QAAQ,EACR,IAAW,EACX,eAAsB,EACtB,MAAM,EACN,QAAQ,GACT,EAAE,kBAAkB,2CA2IpB"}

package/types/Button/index.d.ts

@@ -0,0 +1,57 @@
+import { type ComponentType, type ReactNode } from "react";
+import { type ButtonProps as TamaguiButtonProps } from "tamagui";
+import type { AnyFormApi } from "../types";
+import type { SizeTokens } from "@tamagui/web";
+/** DG-ACT-01 role within an ActionBar / action region. */
+export type ButtonActionRole = "primary" | "secondary" | "chrome";
+type IconLike = ReactNode | ComponentType<{
+    size?: number;
+}>;
+export interface ButtonProps extends Omit<TamaguiButtonProps, "form" | "icon" | "iconAfter"> {
+    action?: "submit" | "reset";
+    form?: AnyFormApi;
+    loading?: boolean;
+    accent?: boolean;
+    error?: boolean;
+    warning?: boolean;
+    success?: boolean;
+    skeleton?: boolean;
+    outlined?: boolean;
+    icon?: IconLike;
+    iconAfter?: IconLike;
+    compact?: boolean;
+    /**
+     * DG-ACT-02 / DG-COPY-03 — structured label. Used when `children` is omitted.
+     * Prefer `{ verb, noun }` over free-form strings for chrome actions.
+     */
+    verb?: string;
+    noun?: string;
+    /**
+     * DG-ACT-01 — marks the button for ActionBar one-primary DEV scans.
+     * Defaults to `"primary"` when `accent` is set.
+     */
+    actionRole?: ButtonActionRole;
+    /**
+     * DG-ST-03 hide / explain / upgrade — explains why the control is disabled.
+     * With `disabled`, the control switches to `aria-disabled` (stays focusable,
+     * presses swallowed) and renders the reason as visible adjacent text wired
+     * via `aria-describedby` — works without hover (Axiom 12; DG-OVL-05 bans
+     * hover-only tooltips on disabled). Required in DEV when passing `disabled`
+     * — bare `disabled` emits `bare-disabled`.
+     */
+    disabledReason?: string;
+}
+export declare function Button({ children, action, form: formProp, loading, accent, error, warning, success, skeleton, outlined, disabled, theme, onPress, onKeyDown, tabIndex, icon, iconAfter, compact, verb, noun, actionRole, disabledReason, ...props }: ButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Button {
+    var Icon: (props: {
+        children: React.ReactNode;
+        scaleIcon?: number;
+        size?: SizeTokens;
+    }) => any;
+    var Text: import("tamagui").TamaguiComponent<import("@tamagui/web").TamaDefer, import("tamagui").TamaguiTextElement, import("tamagui").TextNonStyleProps, import("@tamagui/web").TextStylePropsBase, {
+        unstyled?: boolean | undefined;
+        size?: import("tamagui").FontSizeTokens | undefined;
+    }, import("@tamagui/web").StaticConfigPublic>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/types/Button/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Button/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAQf,OAAO,EAEL,KAAK,WAAW,IAAI,kBAAkB,EAQvC,MAAM,SAAS,CAAC;AAIjB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,OAAO,KAAK,EAAE,UAAU,EAAuB,MAAM,cAAc,CAAC;AAyBpE,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElE,KAAK,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAgF7D,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IAC1F,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,MAAM,CAAC,EACrB,QAAQ,EACR,MAAM,EACN,IAAI,EAAE,QAAQ,EACd,OAAO,EACP,MAAM,EACN,KAAK,EACL,OAAO,EACP,OAAO,EACP,QAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,cAAc,EACd,GAAG,KAAK,EACT,EAAE,WAAW,2CAgSb;yBAxTe,MAAM;;;iBAsCP,CAAC;YACH,CAAC"}

package/types/Chip/index.d.ts

@@ -0,0 +1,31 @@
+import type { ReactNode } from "react";
+import type { GetProps } from "tamagui";
+export type ChipVariant = "solid" | "subtle" | "outline";
+export type ChipColor = "gray" | "red" | "green" | "blue" | "yellow" | "orange" | "purple";
+export type ChipSize = "$2" | "$3" | "$4" | "$5";
+export interface ChipProps {
+    children: ReactNode;
+    size?: ChipSize;
+    variant?: ChipVariant;
+    color?: ChipColor;
+    onDismiss?: () => void;
+    disabled?: boolean;
+}
+/**
+ * Exported so chip-scale companions (e.g. the Tags "Add Tag" trigger) share
+ * the exact same size variants — height/padding/font stay in lockstep with
+ * Chip for every size token.
+ */
+export declare const ChipFrame: import("tamagui").TamaguiComponent<import("@tamagui/web").TamaDefer, import("tamagui").TamaguiElement, import("@tamagui/core").RNTamaguiViewNonStyleProps, import("@tamagui/web").StackStyleBase, {
+    size?: "$2" | "$3" | "$4" | "$5" | undefined;
+    variant?: "solid" | "outline" | "subtle" | undefined;
+}, import("@tamagui/web").StaticConfigPublic>;
+export declare const ChipText: import("tamagui").TamaguiComponent<import("@tamagui/web").TamaDefer, import("tamagui").TamaguiTextElement, import("@tamagui/core").RNTamaguiTextNonStyleProps, import("@tamagui/web").TextStylePropsBase, {
+    size?: "$2" | "$3" | "$4" | "$5" | undefined;
+    unstyled?: boolean | undefined;
+}, import("@tamagui/web").StaticConfigPublic>;
+/** Icon size that pairs with each chip size (single source, shared with chip-scale triggers). */
+export declare function chipIconSize(size: ChipSize): number;
+export declare function Chip({ children, size, variant, color, onDismiss, disabled, }: ChipProps): import("react/jsx-runtime").JSX.Element;
+export type ChipFrameProps = GetProps<typeof ChipFrame>;
+//# sourceMappingURL=index.d.ts.map

package/types/Chip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Chip/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,SAAS,CAAC;AAMrD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AACzD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC3F,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAsBD;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;6CA8BpB,CAAC;AAEH,eAAO,MAAM,QAAQ;;;6CAenB,CAAC;AAEH,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEnD;AA+BD,wBAAgB,IAAI,CAAC,EACnB,QAAQ,EACR,IAAI,EACJ,OAAkB,EAClB,KAAc,EACd,SAAS,EACT,QAAQ,GACT,EAAE,SAAS,2CAyFX;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/types/ControlGroup/index.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from "react";
+import type { GetProps } from "tamagui";
+declare const ControlGroupFrame: import("tamagui").TamaguiComponent<import("@tamagui/web").TamaDefer, import("tamagui").TamaguiElement, import("@tamagui/core").RNTamaguiViewNonStyleProps, import("@tamagui/web").StackStyleBase, {
+    size?: import("tamagui").SizeTokens | undefined;
+    scaleIcon?: number | undefined;
+}, import("@tamagui/web").StaticConfigPublic>;
+export interface ControlGroupProps extends GetProps<typeof ControlGroupFrame> {
+    children: ReactNode;
+    /** Layout direction. Default "horizontal". */
+    orientation?: "horizontal" | "vertical";
+}
+export declare function ControlGroup({ children, orientation, ...props }: ControlGroupProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/types/ControlGroup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ControlGroup/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAYxC,QAAA,MAAM,iBAAiB;;;6CAuBrB,CAAC;AAMH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ,CAAC,OAAO,iBAAiB,CAAC;IAC3E,QAAQ,EAAE,SAAS,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,WAA0B,EAC1B,GAAG,KAAK,EACT,EAAE,iBAAiB,2CAyInB"}

package/types/ErrorSummary.d.ts

@@ -0,0 +1,55 @@
+import { type ReactNode } from "react";
+/** Structured field error (DG-VAL-04). */
+export type StructuredFieldError = {
+    problem: string;
+    action?: string;
+    cta?: {
+        label: string;
+        href?: string;
+    };
+};
+/** Validators may return a plain string or a structured `{ problem, action }`. */
+export type FieldErrorMessage = string | StructuredFieldError;
+export interface ErrorSummaryItem {
+    /** TanStack field name (used as React key and default focus target). */
+    name: string;
+    /** DOM id of the control to focus; defaults to `name`. Prefer `id={name}` on fields. */
+    id?: string;
+    /** Error payload — string or `{ problem, action?, cta? }`. */
+    error: FieldErrorMessage;
+    /** Optional human label; defaults to formatted error text for the link. */
+    label?: string;
+}
+export interface ErrorSummaryProps {
+    errors: ErrorSummaryItem[];
+    /** Heading text (GOV.UK default). */
+    title?: string;
+    /** Skip moving focus to the summary when it appears. */
+    disableAutoFocus?: boolean;
+    /** Root form element used to resolve focus targets. */
+    formElement?: HTMLElement | null;
+    /** Called after a summary link focuses a field. */
+    onFocusField?: (item: ErrorSummaryItem) => void;
+    children?: ReactNode;
+}
+/** Flatten structured / string errors into display copy. */
+export declare function formatFieldError(error: FieldErrorMessage): string;
+/** Normalize unknown validator return values into FieldErrorMessage. */
+export declare function normalizeFieldError(raw: unknown): FieldErrorMessage | undefined;
+/**
+ * DEV-only banned-word guard (DG-COPY-02 / blueprint §5 `banned-error-word`).
+ * Tree-shaken when `NODE_ENV === "production"`.
+ */
+export declare function warnBannedErrorWords(message: string, fieldName?: string): void;
+type FieldMetaLike = {
+    errors?: unknown[];
+} | undefined;
+/** Collect field errors from TanStack `state.fieldMeta` for ErrorSummary. */
+export declare function collectFormFieldErrors(fieldMeta: Partial<Record<string, FieldMetaLike>> | null | undefined): ErrorSummaryItem[];
+/**
+ * Form-level error summary (DG-VAL-02). Lists field errors with focusable
+ * links, `role="alert"`, and moves keyboard focus onto itself when it appears.
+ */
+export declare function ErrorSummary({ errors, title, disableAutoFocus, formElement, onFocusField, }: ErrorSummaryProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=ErrorSummary.d.ts.map

package/types/ErrorSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorSummary.d.ts","sourceRoot":"","sources":["../src/ErrorSummary.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAA4B,MAAM,OAAO,CAAC;AAOjE,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,oBAAoB,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,KAAK,EAAE,iBAAiB,CAAC;IACzB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,mDAAmD;IACnD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAMjE;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAS/E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAM9E;AAED,KAAK,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG,SAAS,CAAC;AAExD,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GACnE,gBAAgB,EAAE,CAYpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,KAA+B,EAC/B,gBAAwB,EACxB,WAAW,EACX,YAAY,GACb,EAAE,iBAAiB,kDAmGnB"}

package/types/FieldDisplay/editMode.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Field edit-mode classification.
+ *
+ * `inline`  → field renders directly in the table cell at row height.
+ * `popover` → field's full UI lives in a floating popover anchored to the cell;
+ *             cell shows a compact trigger.
+ * `modal`   → field's UI is too big for inline or popover (drop zone, signature
+ *             pad, rich text editor); cell shows a summary chip and clicking
+ *             opens a centered modal (web) or sheet (native).
+ *
+ * Used by DataTableCell to decide how to mount each field type. Centralized
+ * here rather than as static props on every field so the routing is in one
+ * place; if a field's natural shape changes, update one map entry.
+ */
+import type { FieldDisplayType } from "./index";
+export type EditMode = "inline" | "popover" | "modal";
+export declare const FIELD_EDIT_MODE: Record<FieldDisplayType, EditMode>;
+export declare function getEditMode(field: FieldDisplayType | undefined): EditMode;
+//# sourceMappingURL=editMode.d.ts.map