gridsmith-ui 0.29.1 → 0.30.1

package/dist/{chunk-37WOC7F7.js → chunk-UDJOIVKQ.js}

@@ -1,8 +1,7 @@
 "use client";
 import { Slot, mergeRefs } from './chunk-7Q46JXSK.js';
-import { usePosition } from './chunk-HP7WUZPK.js';
-import { useLatest } from './chunk-WH2FUFAC.js';
-import { cn, GLASS_DROPDOWN } from './chunk-JTU7OBYJ.js';
+import { usePosition, useLatest } from './chunk-WIUGPZOH.js';
+import { cn, GLASS_DROPDOWN } from './chunk-YL5KD5RC.js';
 import { createContext, useContext, useState, useRef, useId, useCallback, useEffect, isValidElement, cloneElement } from 'react';
 import { createPortal } from 'react-dom';
 import { jsx, jsxs } from 'react/jsx-runtime';
@@ -15,7 +14,10 @@ function Tooltip({ content, children, side = "top", delay = 600, className, cont
 function AutoTooltip(props) {
   return /* @__PURE__ */ jsx(TooltipBase, { ...props, auto: true });
 }
-function TooltipBase({ content, children, side = "top", delay = 600, className, container, disabled = false, auto = false, ref: forwardedRef, ...slotProps }) {
+function RevealTooltip(props) {
+  return /* @__PURE__ */ jsx(TooltipBase, { ...props, auto: true, reveal: true });
+}
+function TooltipBase({ content, children, side = "top", delay = 600, className, container, disabled = false, auto = false, reveal = false, ref: forwardedRef, ...slotProps }) {
   const around = useContext(TooltipCtx);
   const [open, setOpen] = useState(false);
   if (disabled && open) setOpen(false);
@@ -62,14 +64,31 @@ function TooltipBase({ content, children, side = "top", delay = 600, className,
     suppressedRef.current = false;
     hide();
   }, [hide]);
+  const revealOnPress = (e) => {
+    if (e.pointerType !== "touch" || disabled || covered()) return;
+    if (open) {
+      hide();
+      return;
+    }
+    cancel();
+    suppressedRef.current = false;
+    setOpen(true);
+  };
   useEffect(() => {
     if (!open) return;
     const onKey = (e) => {
       if (e.key === "Escape") hide();
     };
+    const onPress = (e) => {
+      if (!triggerRef.current?.contains(e.target)) hide();
+    };
     document.addEventListener("keydown", onKey);
-    return () => document.removeEventListener("keydown", onKey);
-  }, [open, hide]);
+    if (reveal) document.addEventListener("pointerdown", onPress, true);
+    return () => {
+      document.removeEventListener("keydown", onKey);
+      document.removeEventListener("pointerdown", onPress, true);
+    };
+  }, [open, hide, reveal]);
   useEffect(() => cancel, [cancel]);
   const nativeTitle = isValidElement(children) && (typeof children.type === "string" || NATIVE_TITLE in children.type);
   const trigger = nativeTitle && children.props.title !== void 0 ? cloneElement(children, { title: void 0 }) : children;
@@ -97,11 +116,12 @@ function TooltipBase({ content, children, side = "top", delay = 600, className,
         },
         onPointerDown: (e) => {
           slotProps.onPointerDown?.(e);
-          dismissOnActivate();
+          if (reveal) revealOnPress(e);
+          else dismissOnActivate();
         },
         onKeyDown: (e) => {
           slotProps.onKeyDown?.(e);
-          if (e.key === "Enter" || e.key === " ") dismissOnActivate();
+          if (!reveal && (e.key === "Enter" || e.key === " ")) dismissOnActivate();
         },
         "aria-describedby": open ? id : void 0,
         children: trigger
@@ -132,109 +152,7 @@ function TooltipBase({ content, children, side = "top", delay = 600, className,
     )
   ] });
 }
-var registry = /* @__PURE__ */ new WeakMap();
-var sharedObserver = null;
-var rafId = null;
-var pendingElements = /* @__PURE__ */ new Set();
-function getSharedObserver() {
-  if (sharedObserver) return sharedObserver;
-  sharedObserver = new ResizeObserver((entries) => {
-    for (const entry of entries) {
-      pendingElements.add(entry.target);
-    }
-    if (rafId === null) {
-      rafId = requestAnimationFrame(flush);
-    }
-  });
-  return sharedObserver;
-}
-function flush() {
-  rafId = null;
-  for (const el of pendingElements) {
-    const callbacks = registry.get(el);
-    if (callbacks) {
-      for (const cb of callbacks) cb();
-    }
-  }
-  pendingElements.clear();
-}
-function observe(el, callback) {
-  let set = registry.get(el);
-  if (!set) {
-    set = /* @__PURE__ */ new Set();
-    registry.set(el, set);
-  }
-  set.add(callback);
-  if (set.size === 1) {
-    getSharedObserver().observe(el);
-  }
-}
-function unobserve(el, callback) {
-  const set = registry.get(el);
-  if (!set) return;
-  set.delete(callback);
-  if (set.size === 0) {
-    registry.delete(el);
-    getSharedObserver().unobserve(el);
-  }
-}
-var TOLERANCE = 1;
-function checkOverflow(el, lines) {
-  if (lines <= 1) {
-    return el.scrollWidth - el.clientWidth > TOLERANCE;
-  }
-  return el.scrollHeight - el.clientHeight > TOLERANCE;
-}
-function useTextOverflow(options = {}) {
-  const { lines = 1, disabled = false, content } = options;
-  const [isTruncated, setIsTruncated] = useState(false);
-  const elementRef = useRef(null);
-  const registeredRef = useRef(null);
-  const doCheck = useCallback(() => {
-    if (!elementRef.current || disabled) {
-      setIsTruncated(false);
-      return;
-    }
-    const next = checkOverflow(elementRef.current, lines);
-    setIsTruncated((prev) => prev !== next ? next : prev);
-  }, [lines, disabled]);
-  const checkRef = useLatest(doCheck);
-  useEffect(() => {
-    if (disabled) {
-      setIsTruncated(false);
-    } else if (elementRef.current) {
-      const next = checkOverflow(elementRef.current, lines);
-      setIsTruncated((prev) => prev !== next ? next : prev);
-    }
-  }, [content, lines, disabled]);
-  const ref = useCallback(
-    (node) => {
-      const prev = elementRef.current;
-      if (prev && registeredRef.current) {
-        unobserve(prev, registeredRef.current);
-        registeredRef.current = null;
-      }
-      elementRef.current = node;
-      if (node && !disabled) {
-        const wrapper = () => checkRef.current?.();
-        registeredRef.current = wrapper;
-        observe(node, wrapper);
-        const initial = checkOverflow(node, lines);
-        setIsTruncated(initial);
-      }
-    },
-    [lines, disabled, checkRef]
-  );
-  useEffect(() => {
-    return () => {
-      if (elementRef.current && registeredRef.current) {
-        unobserve(elementRef.current, registeredRef.current);
-      }
-    };
-  }, []);
-  return { ref, isTruncated };
-}
 
-export { AutoTooltip, NATIVE_TITLE, Tooltip, useTextOverflow };
-//# sourceMappingURL=chunk-37WOC7F7.js.map
-//# sourceMappingURL=chunk-37WOC7F7.js.map
+export { AutoTooltip, NATIVE_TITLE, RevealTooltip, Tooltip };
+//# sourceMappingURL=chunk-UDJOIVKQ.js.map
+//# sourceMappingURL=chunk-UDJOIVKQ.js.map

package/dist/chunk-UDJOIVKQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../showcase/src/components/Tooltip.tsx"],"names":[],"mappings":"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","file":"chunk-UDJOIVKQ.js","sourcesContent":["import { useState, useRef, useCallback, useEffect, useId, useContext, cloneElement, isValidElement, type HTMLAttributes, type ReactElement, type ReactNode, type Ref, createContext } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { cn, GLASS_DROPDOWN } from \"../lib/utils\";\nimport { Slot, mergeRefs } from \"../lib/slot\";\nimport { usePosition, type Side } from \"../lib/use-position\";\nimport { useLatest } from \"../lib/use-latest\";\n\ninterface TooltipProps extends Omit<HTMLAttributes<HTMLElement>, \"content\"> {\n  content: ReactNode;\n  children: ReactNode;\n  side?: Side;\n  delay?: number;\n  className?: string;\n  container?: Element | DocumentFragment;\n  /**\n   * Keep the Tooltip in the tree but never show it. Use this instead of rendering\n   * the Tooltip only sometimes: adding or removing the wrapper remounts its child,\n   * which drops focus from a field inside it (Sprint 25.7, the Combobox).\n   */\n  disabled?: boolean;\n  /**\n   * A Tooltip can itself be the child of a Slot — `<DropdownMenu trigger={<Tooltip …><Button/></Tooltip>}>` —\n   * so the ref and handlers a parent merges onto it are passed through to its own trigger (14 Sep 2026).\n   */\n  ref?: Ref<HTMLElement>;\n}\n\n/**\n * Inside a tooltip's trigger: asks for the element that tooltip covers, or null when it can't show (disabled, in which\n * case the one around it answers). A tooltip a component draws on its own (an icon Button's from its aria-label, every\n * AutoTooltip) asks when it would show, and steps aside when the answer holds its own trigger: the outer one shows\n * whenever the pointer is in it, so both would show at once (round 15, 52.7, two tooltips on one button; every\n * component's own tooltip since the review of 21.6 session B). Asked then, not at render: a Tooltip around a component\n * that passes no props on never fires, and the component's own tooltip still shows.\n */\nexport const TooltipCtx = createContext<(() => HTMLElement | null) | null>(null);\n\n/** Marks a component whose `title` prop is the native attribute (the library's Button): a Tooltip drops it, as an element's. */\nexport const NATIVE_TITLE = Symbol(\"native title\");\n\n// 600ms: long enough that passing the pointer over a toolbar, or landing focus\n// on an icon button, does not flash a label; short enough to still feel live.\nexport function Tooltip({ content, children, side = \"top\", delay = 600, className, container, disabled = false, ref, ...slotProps }: TooltipProps) {\n  return <TooltipBase content={content} side={side} delay={delay} className={className} container={container} disabled={disabled} ref={ref} {...slotProps}>{children}</TooltipBase>;\n}\n\n/**\n * The tooltip a library component draws on its own: an icon Button's label, cut-off text in full, a relative time's\n * date, an avatar's name, its own controls' labels. Where a tooltip that can show already covers its trigger (a Tooltip\n * the page put around it) it steps aside, so the control shows one (the review of 21.6 session B: a Tooltip around a\n * cut-off Badge showed two). Every component's own tooltip is one of these; `<Tooltip>` is the page's, and never steps aside.\n */\nexport function AutoTooltip(props: TooltipProps) {\n  return <TooltipBase {...props} auto />;\n}\n\n/**\n * The AutoTooltip of text cut to fit (Sprint 25.8.7 item 5, lib's CutText): the tooltip is the way to the full text, so a\n * tap shows it at once and a second tap or a press elsewhere hides it, and a press or Enter never dismisses it, there\n * being nothing to activate.\n */\nexport function RevealTooltip(props: TooltipProps) {\n  return <TooltipBase {...props} auto reveal />;\n}\n\nfunction TooltipBase({ content, children, side = \"top\", delay = 600, className, container, disabled = false, auto = false, reveal = false, ref: forwardedRef, ...slotProps }: TooltipProps & { auto?: boolean; reveal?: boolean }) {\n  const around = useContext(TooltipCtx);\n  const [open, setOpen] = useState(false);\n  // Disabling while shown hides it (render-time state adjustment).\n  if (disabled && open) setOpen(false);\n  const triggerRef = useRef<HTMLElement>(null);\n  const floatingRef = useRef<HTMLDivElement>(null);\n  const timeoutRef = useRef<ReturnType<typeof setTimeout>>(undefined);\n  // Set when the trigger is activated: the label must not reappear (from the\n  // focus the click leaves behind, or a still-pending timer) until the pointer\n  // leaves and comes back.\n  const suppressedRef = useRef(false);\n  const id = useId();\n\n  const pos = usePosition(triggerRef, floatingRef, open, { side, offset: 6, flip: true });\n\n  const cancel = useCallback(() => {\n    clearTimeout(timeoutRef.current);\n    timeoutRef.current = undefined;\n  }, []);\n\n  // What this tooltip covers, for one inside its trigger to ask: its trigger while it can show, else the answer of the\n  // one around it. An automatic tooltip is covered when that answer holds its own trigger.\n  const disabledRef = useLatest(disabled);\n  const covers = useCallback(() => (disabledRef.current ? around?.() ?? null : triggerRef.current), [around, disabledRef]);\n  const covered = useCallback(() => {\n    const mine = triggerRef.current;\n    const theirs = auto ? around?.() : null;\n    return !!(mine && theirs && theirs.contains(mine));\n  }, [auto, around]);\n\n  // One pending timer at a time: hover and focus both call show(), and the\n  // earlier timer used to be orphaned, firing after hide() had run and leaving\n  // the tooltip up with nothing left to close it.\n  const show = useCallback(() => {\n    if (disabled || suppressedRef.current || covered()) return;\n    cancel();\n    timeoutRef.current = setTimeout(() => setOpen(true), delay);\n  }, [delay, cancel, disabled, covered]);\n\n  const hide = useCallback(() => {\n    cancel();\n    setOpen(false);\n  }, [cancel]);\n\n  // Pointer focus (a click) does not warrant a label; keyboard focus does. The element focused is asked, not the\n  // trigger: focus that reaches the trigger from a control inside it (a card title's button) is that control's, and\n  // the trigger itself never matched, so the label never showed by keyboard (the review of 30 September).\n  const showOnFocus = useCallback((e: React.FocusEvent<HTMLElement>) => {\n    let keyboard = true;\n    const focused = e.target instanceof Element ? e.target : e.currentTarget;\n    try { keyboard = focused.matches(\":focus-visible\"); } catch { /* selector unsupported: assume keyboard */ }\n    if (keyboard) show();\n  }, [show]);\n\n  // Activating the trigger dismisses the label and keeps it away until the\n  // pointer has left — what opens next (a menu, a dialog) owns the screen.\n  const dismissOnActivate = useCallback(() => {\n    suppressedRef.current = true;\n    hide();\n  }, [hide]);\n\n  // Suppression lifts when the pointer leaves or focus moves on — a keyboard\n  // user never produces a mouseleave, so blur must reset it too.\n  const leave = useCallback(() => {\n    suppressedRef.current = false;\n    hide();\n  }, [hide]);\n\n  // Cut text's tooltip (`reveal`): a finger's tap shows it at once, and taps it away; a mouse's press leaves it as the\n  // hover has it\n  const revealOnPress = (e: React.PointerEvent<HTMLElement>) => {\n    if (e.pointerType !== \"touch\" || disabled || covered()) return;\n    if (open) { hide(); return; }\n    cancel();\n    suppressedRef.current = false;\n    setOpen(true);\n  };\n\n  // Escape dismisses an open tooltip (WCAG 1.4.13); it does not stop the key\n  // reaching whatever overlay is also listening. Cut text's goes with a press anywhere else too, as a tap showed it.\n  useEffect(() => {\n    if (!open) return;\n    const onKey = (e: KeyboardEvent) => { if (e.key === \"Escape\") hide(); };\n    const onPress = (e: PointerEvent) => { if (!triggerRef.current?.contains(e.target as Node)) hide(); };\n    document.addEventListener(\"keydown\", onKey);\n    if (reveal) document.addEventListener(\"pointerdown\", onPress, true);\n    return () => {\n      document.removeEventListener(\"keydown\", onKey);\n      document.removeEventListener(\"pointerdown\", onPress, true);\n    };\n  }, [open, hide, reveal]);\n\n  useEffect(() => cancel, [cancel]);\n\n  // A native title on the trigger would be the browser's second tooltip, a moment after this one (the review of 21.6\n  // session B): an element's own title goes, and the library Button's. Another component's title prop is left alone: it\n  // often means something else (a Card's heading).\n  const nativeTitle = isValidElement(children) && (typeof children.type === \"string\" || NATIVE_TITLE in (children.type as object));\n  const trigger = nativeTitle && (children.props as { title?: unknown }).title !== undefined\n    ? cloneElement(children as ReactElement<{ title?: string }>, { title: undefined })\n    : children;\n\n  return (\n    <TooltipCtx value={covers}>\n      <Slot\n        {...slotProps}\n        ref={mergeRefs(triggerRef, forwardedRef)}\n        onMouseEnter={(e) => { slotProps.onMouseEnter?.(e); show(); }}\n        onMouseLeave={(e) => { slotProps.onMouseLeave?.(e); leave(); }}\n        onFocus={(e) => { slotProps.onFocus?.(e); showOnFocus(e); }}\n        onBlur={(e) => { slotProps.onBlur?.(e); leave(); }}\n        onPointerDown={(e) => { slotProps.onPointerDown?.(e); if (reveal) revealOnPress(e); else dismissOnActivate(); }}\n        onKeyDown={(e) => { slotProps.onKeyDown?.(e); if (!reveal && (e.key === \"Enter\" || e.key === \" \")) dismissOnActivate(); }}\n        aria-describedby={open ? id : undefined}\n      >\n        {trigger}\n      </Slot>\n      {open && createPortal(\n        <div\n          ref={floatingRef}\n          id={id}\n          role=\"tooltip\"\n          className={cn(\n            \"fixed z-[var(--ds-z-tooltip)] pointer-events-none\",\n            \"px-ds-2.5 py-ds-1.5 text-xs\",\n            \"max-w-[280px] break-words\",\n            \"bg-[var(--ds-bg-surface-elevated)] text-[var(--ds-text-primary)]\",\n            GLASS_DROPDOWN,\n            \"border-[length:var(--ds-border-width)] border-[var(--ds-border-default)]\",\n            \"rounded-[var(--ds-radius-sm)]\",\n            className\n          )}\n          style={{ top: pos.top, left: pos.left }}\n        >\n          {content}\n        </div>,\n        container ?? document.body\n      )}\n    </TooltipCtx>\n  );\n}\n\n"]}

package/dist/{chunk-RJEUQ7RL.js → chunk-ULCACQSA.js}

@@ -1,10 +1,10 @@
 "use client";
-import { elementType, formatLocale } from './chunk-OYNUU346.js';
-import { AutoTooltip, NATIVE_TITLE } from './chunk-37WOC7F7.js';
-import { slotDraws, slotIcon, warnOnce } from './chunk-MKFWHWBK.js';
-import { cn, FOCUS_RING } from './chunk-JTU7OBYJ.js';
+import { elementType } from './chunk-NKUCS67T.js';
+import { AutoTooltip, NATIVE_TITLE } from './chunk-UDJOIVKQ.js';
+import { slotDraws, slotIcon } from './chunk-L6HWACK7.js';
+import { cn, FOCUS_RING } from './chunk-YL5KD5RC.js';
 import { jsxs, jsx } from 'react/jsx-runtime';
-import { createContext, forwardRef, useContext, isValidElement, useMemo } from 'react';
+import { createContext, forwardRef, useContext, isValidElement, createElement, useLayoutEffect } from 'react';
 
 var sizes = {
   sm: "h-4 w-4 border-[1.5px]",
@@ -159,93 +159,50 @@ function triggerType(node) {
   const type = elementType(node.type);
   return (type === "button" || type === Button) && node.props.type === void 0 ? { type: "button" } : {};
 }
-
-// ../../showcase/src/lib/relative-time.ts
-var MINUTE = 6e4;
-var HOUR = 60 * MINUTE;
-var DAY = 24 * HOUR;
-var HOUSE_RELATIVE_THRESHOLD_HOURS = 24;
-function toMillis(time) {
-  if (time instanceof Date) return time.getTime();
-  if (typeof time === "number") return time;
-  if (typeof time !== "string") return NaN;
-  const day = /^(\d{4})-(\d{2})-(\d{2})$/.exec(time.trim());
-  if (day) return new Date(Number(day[1]), Number(day[2]) - 1, Number(day[3])).getTime();
-  return Date.parse(time);
-}
-function thresholdOf(hours, from) {
-  if (typeof hours === "number" && Number.isFinite(hours) && hours >= 0) return hours;
-  const house = HOUSE_RELATIVE_THRESHOLD_HOURS;
-  warnOnce(from, `a threshold of ${String(hours)} isn't a number of hours, so the house's ${house} is used.`);
-  return house;
-}
-function midnight(t) {
-  const d = new Date(t);
-  d.setHours(0, 0, 0, 0);
-  return d.getTime();
+var PageActionsCtx = createContext(null);
+var CardSurfaceCtx = createContext(false);
+var SplitPaneCtx = createContext(false);
+var TableCardCtx = createContext(false);
+var RowsCtx = createContext(false);
+var SplitListFramerCtx = createContext(null);
+function useReportToList(kind) {
+  const report = useContext(SplitListFramerCtx);
+  useLayoutEffect(() => {
+    if (!report) return;
+    report(kind, true);
+    return () => report(kind, false);
+  }, [report, kind]);
 }
-function formatRelativeTime(time, options) {
-  const at = toMillis(time);
-  if (!Number.isFinite(at)) return "";
-  const now = options.now ?? Date.now();
-  const locale = options.locale ?? formatLocale();
-  const diff = at - now;
-  const age = Math.abs(diff);
-  if (age > thresholdOf(options.thresholdHours, "formatRelativeTime") * HOUR) return new Intl.DateTimeFormat(locale, { dateStyle: "medium", timeStyle: "short" }).format(at);
-  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
-  if (age < MINUTE) return rtf.format(0, "second");
-  if (age < HOUR) return rtf.format(Math.trunc(diff / MINUTE), "minute");
-  if (age < DAY) return rtf.format(Math.trunc(diff / HOUR), "hour");
-  return rtf.format(Math.round((midnight(at) - midnight(now)) / DAY), "day");
+function useFramesItself() {
+  useReportToList("framed");
 }
-function formatFullTime(time, locale) {
-  const at = toMillis(time);
-  return Number.isFinite(at) ? new Intl.DateTimeFormat(locale ?? formatLocale(), { year: "numeric", month: "long", day: "numeric", hour: "numeric", minute: "2-digit", timeZoneName: "short" }).format(at) : "";
+function useScrollsInside() {
+  useReportToList("scrolls");
 }
-var PreferencesContext = createContext(null);
-var HOUSE_DEFAULTS = {
-  validationTiming: "onBlur",
-  formActions: { align: "end", placement: "auto" },
-  itemsPerPage: 25,
-  paginationStyle: "pagination",
-  tableToCardsBreakpoint: "md",
-  emptyStyle: "illustration-cta",
-  loadingStyle: "skeleton",
-  destructiveMode: "dialog",
-  highSeverityActions: ["delete_account", "remove_team_member"],
-  typeToConfirmActions: ["delete_account"],
-  undoWindowSeconds: 5,
-  relativeThresholdHours: HOUSE_RELATIVE_THRESHOLD_HOURS,
-  canNavigateBack: true
-};
-var PREFERENCE_HOUSE_DEFAULTS = Object.freeze(HOUSE_DEFAULTS);
-function usePreferences() {
-  const raw = useShellPreferences();
-  return useMemo(() => resolvePreferences(raw), [raw]);
-}
-function resolvePreferences(raw) {
-  const d = PREFERENCE_HOUSE_DEFAULTS;
-  const out = { ...d, formActions: { ...d.formActions }, highSeverityActions: [...d.highSeverityActions], typeToConfirmActions: [...d.typeToConfirmActions] };
-  for (const [key, value] of Object.entries(raw)) {
-    if (value === void 0) continue;
-    if (key === "formActions") {
-      const actions = value;
-      if (actions?.align !== void 0) out.formActions.align = actions.align;
-      if (actions?.placement !== void 0) out.formActions.placement = actions.placement;
-      continue;
-    }
-    out[key] = value;
-  }
-  return out;
-}
-function useShellPreferences() {
-  return useContext(PreferencesContext) ?? EMPTY;
-}
-var EMPTY = Object.freeze({});
-function preferenceActionKey(label) {
-  return label.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "");
+function SurfaceBoundary({ children, pane = false, framer = null }) {
+  return createElement(
+    CardSurfaceCtx,
+    { value: false },
+    createElement(
+      SplitPaneCtx,
+      { value: pane },
+      createElement(
+        TableCardCtx,
+        { value: false },
+        createElement(
+          RowsCtx,
+          { value: false },
+          createElement(
+            PageActionsCtx,
+            { value: null },
+            createElement(SplitListFramerCtx, { value: framer }, children)
+          )
+        )
+      )
+    )
+  );
 }
 
-export { Button, ButtonSizeContext, ControlSizeContext, DAY, HOUR, MINUTE, PREFERENCE_HOUSE_DEFAULTS, PreferencesContext, Spinner, formatFullTime, formatRelativeTime, preferenceActionKey, thresholdOf, toMillis, triggerType, usePreferences, useShellPreferences };
-//# sourceMappingURL=chunk-RJEUQ7RL.js.map
-//# sourceMappingURL=chunk-RJEUQ7RL.js.map
+export { Button, ButtonSizeContext, CardSurfaceCtx, ControlSizeContext, PageActionsCtx, RowsCtx, Spinner, SplitPaneCtx, SurfaceBoundary, TableCardCtx, triggerType, useFramesItself, useScrollsInside };
+//# sourceMappingURL=chunk-ULCACQSA.js.map
+//# sourceMappingURL=chunk-ULCACQSA.js.map

package/dist/chunk-ULCACQSA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../showcase/src/components/Spinner.tsx","../../../showcase/src/components/Button.tsx","../../../showcase/src/lib/page-actions.ts","../../../showcase/src/lib/surface-context.ts"],"names":["Button","jsx","createContext","useContext"],"mappings":"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","file":"chunk-ULCACQSA.js","sourcesContent":["import { cn } from \"../lib/utils\";\n\nconst sizes = {\n  sm: \"h-4 w-4 border-[1.5px]\",\n  md: \"h-6 w-6 border-2\",\n  lg: \"h-8 w-8 border-[2.5px]\",\n} as const;\n\ninterface SpinnerProps {\n  size?: keyof typeof sizes;\n  color?: \"default\" | \"inherit\";\n  label?: string;\n  className?: string;\n}\n\nexport function Spinner({ size = \"md\", color = \"default\", label = \"Loading\", className }: SpinnerProps) {\n  return (\n    <span\n      role=\"status\"\n      aria-label={label}\n      className={cn(\n        \"inline-block rounded-[var(--ds-radius-full)] animate-spin\",\n        color === \"inherit\"\n          ? \"border-current/30 border-t-current\"\n          : \"border-[var(--ds-bg-emphasis)] border-t-[var(--ds-accent-primary)]\",\n        sizes[size],\n        className\n      )}\n    />\n  );\n}\n","import { cn, FOCUS_RING } from \"../lib/utils\";\n// a server component hands its client children on as lazy references (Sprint 25.22's review)\nimport { elementType } from \"../lib/element-type\";\nimport { createContext, useContext, forwardRef, isValidElement, type ButtonHTMLAttributes, type CSSProperties, type ReactNode } from \"react\";\nimport { AutoTooltip, NATIVE_TITLE } from \"./Tooltip\";\nimport { Spinner } from \"./Spinner\";\nimport { slotIcon, type IconSlot, slotDraws } from \"../lib/icons\";\n\ntype ButtonVariant = \"default\" | \"secondary\" | \"tertiary\" | \"outline\" | \"ghost\" | \"destructive\" | \"success\" | \"warning\" | \"link\";\ntype ButtonSize = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"icon-xs\" | \"icon-sm\" | \"icon\" | \"icon-lg\";\n\nexport type ControlSize = \"sm\" | \"md\" | \"lg\";\nexport const ControlSizeContext = createContext<ControlSize | null>(null);\nexport const ButtonSizeContext = ControlSizeContext;\n\ninterface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {\n  variant?: ButtonVariant;\n  size?: ButtonSize;\n  /** An icon name (\"clock\"), drawn as the theme's icon at the button's icon size, or an element. Not text: use children. */\n  iconLeft?: IconSlot;\n  /** As iconLeft, after the label. */\n  iconRight?: IconSlot;\n  loading?: boolean;\n  children?: ReactNode;\n}\n\nconst variantStyles: Record<ButtonVariant, string> = {\n  default: \"bg-[var(--ds-accent-primary)] [background-image:var(--ds-gradient)] [background-origin:border-box] text-[var(--ds-text-on-primary)] border-transparent hover:bg-[var(--ds-accent-primary-hover)] hover:brightness-110\",\n  secondary: \"bg-[var(--ds-bg-surface)] text-[var(--ds-text-primary)] border-[var(--ds-border-default)] hover:bg-[var(--ds-bg-muted)]\",\n  tertiary: \"bg-[var(--ds-bg-muted)] text-[var(--ds-text-primary)] border-transparent hover:brightness-95\",\n  outline: \"bg-[var(--ds-input-bg)] text-[var(--ds-text-primary)] border-[var(--ds-border-default)] hover:bg-[var(--ds-bg-muted)]\",\n  ghost: \"bg-transparent text-[var(--ds-text-primary)] border-transparent hover:bg-[var(--ds-bg-muted)] shadow-none\",\n  destructive: \"bg-[var(--ds-status-error)] text-[var(--ds-text-on-error)] border-transparent hover:opacity-90\",\n  success: \"bg-[var(--ds-status-success)] text-[var(--ds-text-on-success)] border-transparent hover:opacity-90\",\n  warning: \"bg-[var(--ds-status-warning)] text-[var(--ds-text-on-warning)] border-transparent hover:opacity-90\",\n  link: \"bg-transparent text-[var(--ds-accent-ink)] hover:text-[var(--ds-accent-primary-hover)] hover:underline\",\n};\n\nconst sizeStyles: Record<ButtonSize, string> = {\n  // xs / icon-xs: dense tool chrome (builder toolbars, inline row actions).\n  xs: \"h-ds-6 px-ds-3 py-0 text-xs\",\n  sm: \"h-[var(--ds-control-height-sm)] px-ds-4 py-ds-1 text-xs\",\n  md: \"h-[var(--ds-control-height-md)] px-ds-6 py-ds-2 text-sm\",\n  lg: \"h-[var(--ds-control-height-lg)] px-ds-8 py-ds-3 text-base\",\n  \"icon-xs\": \"h-ds-6 w-ds-6 p-0\",\n  \"icon-sm\": \"h-[var(--ds-control-height-sm)] w-[var(--ds-control-height-sm)] p-0\",\n  icon: \"h-[var(--ds-control-height-md)] w-[var(--ds-control-height-md)] p-0\",\n  \"icon-lg\": \"h-[var(--ds-control-height-lg)] w-[var(--ds-control-height-lg)] p-0\",\n};\n\n// Link buttons have no box, so only the text size follows `size`.\nconst linkSizeStyles: Record<ButtonSize, string> = {\n  xs: \"text-xs\",\n  sm: \"text-xs\",\n  md: \"text-sm\",\n  lg: \"text-base\",\n  \"icon-xs\": \"text-xs\",\n  \"icon-sm\": \"text-xs\",\n  icon: \"text-sm\",\n  \"icon-lg\": \"text-base\",\n};\n\nconst iconPaddingReduce: Record<Exclude<ButtonSize, \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\">, number> = {\n  xs: 2,\n  sm: 2,\n  md: 4,\n  lg: 6,\n};\n\n/** The icon size each button size draws a named icon at (Sprint 25.17 A26): what the library's own buttons pass by hand. */\nconst SLOT_ICON_PX: Record<ButtonSize, number> = { xs: 12, sm: 14, md: 16, lg: 18, \"icon-xs\": 12, \"icon-sm\": 14, icon: 16, \"icon-lg\": 18 };\n\nconst HOVER_SCALE_CAP = { '--_btn-scale': 'min(var(--ds-hover-scale), 1.02)' } as CSSProperties;\n\nexport const Button = forwardRef<HTMLButtonElement, ButtonProps>(function Button({ variant = \"default\", size: sizeProp, iconLeft, iconRight, loading, className, children, disabled, style, onClick, ...props }, ref) {\n  const contextSize = useContext(ControlSizeContext);\n  const size = sizeProp ?? contextSize ?? \"md\";\n  const isLink = variant === \"link\";\n  const spinnerSize = size === \"lg\" || size === \"icon-lg\" ? \"md\" : \"sm\";\n  let paddingStyle: CSSProperties | undefined;\n  const isIconSize = size === \"icon\" || size === \"icon-xs\" || size === \"icon-sm\" || size === \"icon-lg\";\n  // a slot that draws nothing (text, which no icon pack names) keeps the button's even padding\n  const drawsLeft = slotDraws(iconLeft);\n  const drawsRight = slotDraws(iconRight);\n  if (!isIconSize && !isLink && (drawsLeft || drawsRight)) {\n    const reduce = iconPaddingReduce[size];\n    paddingStyle = {};\n    if (drawsLeft) paddingStyle.paddingLeft = `calc(${getCssPadding(size)} - ${reduce}px)`;\n    if (drawsRight) paddingStyle.paddingRight = `calc(${getCssPadding(size)} - ${reduce}px)`;\n  }\n\n  const isLoading = loading && !disabled;\n  const isDisabled = !!disabled;\n\n  const handleClick = isLoading\n    ? (e: React.MouseEvent<HTMLButtonElement>) => { e.preventDefault(); }\n    : onClick;\n\n  const ariaLabel = props[\"aria-label\"];\n  // An icon-size Button with an aria-label draws its own tooltip from it. Round 15 (52.7): where a Tooltip the page put\n  // around it shows, that one owns the label and this steps aside (AutoTooltip asks when it would show).\n  const drawsTooltip = isIconSize && !!ariaLabel;\n  // A title beside a tooltip is the browser's second one, a moment later (the review of 21.6 session B): a Button that\n  // draws its tooltip shows the title's text in it instead (the Tooltip drops the button's own title), and a Tooltip the\n  // page puts around a Button drops its title too (NATIVE_TITLE).\n  const title = props.title;\n\n  const btn = (\n    <button\n      ref={ref}\n      data-variant={variant}\n      className={cn(\n        \"relative inline-flex items-center justify-center gap-ds-2 whitespace-nowrap font-medium\",\n        isLink\n          ? cn(\n              \"px-0 py-ds-0.5 h-auto\",\n              linkSizeStyles[size],\n              \"transition-colors duration-[var(--ds-transition-speed)]\",\n              FOCUS_RING,\n              \"cursor-pointer\",\n              \"active:text-[var(--ds-accent-primary-active)]\",\n            )\n          : cn(\n              \"border-[length:var(--ds-border-width)]\",\n              \"rounded-[var(--ds-radius-md)]\",\n              \"shadow-[var(--ds-shadow-button)]\",\n              \"hover:scale-[var(--_btn-scale)] hover:-translate-y-[var(--ds-hover-lift)]\",\n              \"active:shadow-[var(--ds-shadow-button-pressed)] active:translate-x-[var(--ds-press-depth)] active:translate-y-[var(--ds-press-depth)]\",\n              \"[transition:var(--ds-transition-interactive)]\",\n              FOCUS_RING,\n              \"cursor-pointer disabled:cursor-not-allowed disabled:opacity-disabled\",\n              sizeStyles[size],\n            ),\n        variantStyles[variant],\n        isLoading && !isLink && \"cursor-wait pointer-events-none\",\n        className\n      )}\n      disabled={isDisabled}\n      aria-busy={isLoading || undefined}\n      aria-disabled={isLoading && !disabled ? true : undefined}\n      onClick={handleClick}\n      style={isLink ? style : { ...HOVER_SCALE_CAP, ...paddingStyle, ...style }}\n      {...props}\n    >\n      {loading && !isLink && (\n        <span className=\"absolute inset-0 flex items-center justify-center\">\n          <Spinner size={spinnerSize} color=\"inherit\" />\n        </span>\n      )}\n      <span className={cn(\"inline-flex items-center gap-ds-2 min-w-0\", loading && !isLink && \"invisible\")}>\n        {slotIcon(iconLeft, SLOT_ICON_PX[size], \"Button's iconLeft\")}\n        {children}\n        {slotIcon(iconRight, SLOT_ICON_PX[size], \"Button's iconRight\")}\n      </span>\n    </button>\n  );\n\n  if (drawsTooltip) {\n    return <AutoTooltip content={title ?? ariaLabel}>{btn}</AutoTooltip>;\n  }\n\n  return btn;\n});\n// a Button's title is the native attribute: a Tooltip around it drops it, as it does an element's\n(Button as unknown as Record<symbol, true>)[NATIVE_TITLE] = true;\n\nfunction getCssPadding(size: Exclude<ButtonSize, \"icon\" | \"icon-xs\" | \"icon-sm\" | \"icon-lg\">): string {\n  switch (size) {\n    case \"xs\": return \"var(--ds-space-3)\";\n    case \"sm\": return \"var(--ds-space-4)\";\n    case \"md\": return \"var(--ds-space-6)\";\n    case \"lg\": return \"var(--ds-space-8)\";\n  }\n}\n\n/**\n * A trigger the library wires up (a Collapsible's, a menu's, a popover's) never submits the form it sits in (0.21.0): a\n * button element or Button given no type gets type=\"button\". A page's own Button keeps HTML's default, so its submits\n * still work.\n */\nexport function triggerType(node: unknown): { type?: \"button\" } {\n  if (!isValidElement(node)) return {};\n  const type = elementType(node.type);\n  return (type === \"button\" || type === Button) && (node.props as { type?: unknown }).type === undefined ? { type: \"button\" } : {};\n}\n","import { createContext } from \"react\";\nimport type { ControlSize } from \"../components/Button\";\n\n/**\n * Sprint 25.16 A4 (R28-7): the slot in a page's own PageHeader for its actions (PageActions). PageContainer provides it,\n * its header draws it while a page asks, and the page's PageActions render into it. The review of 1 October:\n * - content that starts afresh (an overlay's body, a SplitView's pane: SurfaceBoundary) has no slot, so a header there\n *   (a message's own header, a drawer's) never takes the page's actions;\n * - the page's header is the first slot in the page, so a second header that comes and goes hands nothing on;\n * - a container with no header of its own (a page that wraps itself in one under an area layout) passes its page's\n *   actions to the container around it;\n * - the actions take the header's control size (a minimal or snapping header draws its own actions small).\n */\nexport interface PageActionsSlot {\n  /** A page below asks for the slot: a PageActions is drawn. */\n  wanted: boolean;\n  /** Where the actions go: the slot of the page's header, at the size its controls are drawn. */\n  target: { el: HTMLElement; size: ControlSize | null } | null;\n  /** A header's slot, while drawn, with its controls' size; returns its release. */\n  register: (el: HTMLElement, size: ControlSize | null) => () => void;\n  /** A PageActions asks for the slot while drawn; returns its release. */\n  add: () => () => void;\n}\n\nexport const PageActionsCtx = createContext<PageActionsSlot | null>(null);\n","import { createContext, createElement, useContext, useLayoutEffect, type ReactNode } from \"react\";\nimport { PageActionsCtx } from \"./page-actions\";\n\n/**\n * True inside a Card's surface. A StackedList reads it to inset its rows to the card's header (px-ds-5).\n */\nexport const CardSurfaceCtx = createContext(false);\n\n/**\n * The SplitView pane content sits in (\"list\", \"detail\", \"aside\"), false outside one. A StackedList reads it to take its\n * inset from the pane (Sprint 25.4 C-5): rows keep their padding so the selection rail sits at the pane's edge and never\n * touches content. A pane header (SectionHeading variant=\"pane\") in the detail insets at the page's gutter, as the item's\n * path above it does, and in the list at its rows' inset (the owner's review of 1 October).\n */\nexport type SplitPaneKind = false | \"list\" | \"detail\" | \"aside\";\nexport const SplitPaneCtx = createContext<SplitPaneKind>(false);\n\n/**\n * True inside a Table or DataGrid card (the phone layout below mobileBreakpoint). An EntityCell reads it to keep\n * the avatar beside the text and align to the value column (Sprint 25.4, round 7: the stacked cell made the card\n * three lines taller than it needed to be).\n */\nexport const TableCardCtx = createContext(false);\n\n/**\n * True among a collection's rows: a Table's or a DataGrid's rows and their phone cards, a StackedList's rows, a Timeline's\n * items, a NotificationCenter's rows. Something\n * with a Tab stop of its own adds a stop to every row there, which makes the collection hard to cross: a RelativeTime\n * drops its own, its full timestamp in its name and on hover (Sprint 25.17 A29). A DataList is one record's fields, not\n * rows, so it doesn't set it (the second review). Inside a control (a card or a row that is a button, a link) the time\n * finds that for itself, from the page. Overlays reset it: SurfaceBoundary, a Popover, a HoverCard.\n */\nexport const RowsCtx = createContext(false);\n\n/**\n * Sprint 25.14 A44: what a SplitView's list pane holds, as its content reports it while mounted. \"framed\": content that\n * draws its own frame or cards (a KanbanBoard, a CardGrid, a Table, a DataGrid). \"scrolls\": content with no frame of its\n * own that scrolls inside the pane (a StackedList, a Gantt, a VirtualizedList), which the view's hairline frames. The\n * view drops its frame and surface when the pane holds framed content and nothing that scrolls (P32: no frame around\n * what frames itself; a hairline around what scrolls inside). Here, not in SplitView, so a board or a card grid never\n * imports the resizable panels. Null outside a list pane: overlays and the view's other panes reset it (SurfaceBoundary).\n */\nexport type SplitListReport = (kind: \"framed\" | \"scrolls\", present: boolean) => void;\nexport const SplitListFramerCtx = createContext<SplitListReport | null>(null);\n\nfunction useReportToList(kind: \"framed\" | \"scrolls\") {\n  const report = useContext(SplitListFramerCtx);\n  useLayoutEffect(() => {\n    if (!report) return;\n    report(kind, true);\n    return () => report(kind, false);\n  }, [report, kind]);\n}\n\n/** Tell a SplitView whose list pane this sits in that it draws its own frame or cards (A44). */\nexport function useFramesItself() {\n  useReportToList(\"framed\");\n}\n\n/** Tell a SplitView whose list pane this sits in that it scrolls inside the pane with no frame of its own (A44). */\nexport function useScrollsInside() {\n  useReportToList(\"scrolls\");\n}\n\n/**\n * Where content starts afresh: an overlay's body, an opened table row's panel, a SplitView's pane. What a Card, a pane\n * or a table card told the content around it stops here (the review of 30 September: a StackedList in a Drawer opened\n * from a Card took the card's inset, and one in a Dialog declared in a list pane the pane's, so neither lined up with\n * the overlay's gutter), and so does the page's actions slot. A pane passes `pane` (which pane its content is in) and\n * the list pane its `framer`.\n */\nexport function SurfaceBoundary({ children, pane = false, framer = null }: { children: ReactNode; pane?: SplitPaneKind; framer?: SplitListReport | null }) {\n  // the page's actions belong to the page's own header (Sprint 25.16's review): a header in a pane or an overlay never\n  // takes them, and PageActions there renders nothing\n  return createElement(CardSurfaceCtx, { value: false },\n    createElement(SplitPaneCtx, { value: pane },\n      createElement(TableCardCtx, { value: false },\n        createElement(RowsCtx, { value: false },\n          createElement(PageActionsCtx, { value: null },\n            createElement(SplitListFramerCtx, { value: framer }, children))))));\n}\n"]}

package/dist/{chunk-HP7WUZPK.js → chunk-WIUGPZOH.js}

@@ -75,7 +75,14 @@ function usePosition(triggerRef, floatingRef, open, options = {}) {
   }, [open, compute]);
   return pos;
 }
+function useLatest(value) {
+  const ref = useRef(value);
+  useLayoutEffect(() => {
+    ref.current = value;
+  });
+  return ref;
+}
 
-export { usePosition };
-//# sourceMappingURL=chunk-HP7WUZPK.js.map
-//# sourceMappingURL=chunk-HP7WUZPK.js.map
+export { useLatest, usePosition };
+//# sourceMappingURL=chunk-WIUGPZOH.js.map
+//# sourceMappingURL=chunk-WIUGPZOH.js.map

package/dist/chunk-WIUGPZOH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../showcase/src/lib/use-position.ts","../../../showcase/src/lib/use-latest.ts"],"names":["useRef","useLayoutEffect"],"mappings":"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","file":"chunk-WIUGPZOH.js","sourcesContent":["import { useState, useCallback, useLayoutEffect, useRef, type RefObject } from \"react\";\n\nexport type Side = \"top\" | \"right\" | \"bottom\" | \"left\";\nexport type Align = \"start\" | \"center\" | \"end\";\n\ninterface PositionOptions {\n  side?: Side;\n  align?: Align;\n  offset?: number;\n  flip?: boolean;\n}\n\ninterface PositionResult {\n  top: number;\n  left: number;\n  placement: Side;\n}\n\nconst VIEWPORT_PADDING = 8;\n\nexport function usePosition(\n  triggerRef: RefObject<HTMLElement | null>,\n  floatingRef: RefObject<HTMLElement | null>,\n  open: boolean,\n  options: PositionOptions = {}\n): PositionResult {\n  const { side = \"bottom\", align = \"center\", offset = 8, flip = true } = options;\n  const [pos, setPos] = useState<PositionResult>({ top: 0, left: 0, placement: side });\n  const rafId = useRef(0);\n\n  const compute = useCallback(() => {\n    const trigger = triggerRef.current;\n    const floating = floatingRef.current;\n    if (!trigger || !floating) return;\n\n    const tRect = trigger.getBoundingClientRect();\n    const fRect = floating.getBoundingClientRect();\n    const vw = window.innerWidth;\n    const vh = window.innerHeight;\n\n    let placement = side;\n\n    if (flip) {\n      if (placement === \"bottom\" && tRect.bottom + offset + fRect.height > vh - VIEWPORT_PADDING && tRect.top - offset - fRect.height > VIEWPORT_PADDING) {\n        placement = \"top\";\n      } else if (placement === \"top\" && tRect.top - offset - fRect.height < VIEWPORT_PADDING && tRect.bottom + offset + fRect.height < vh - VIEWPORT_PADDING) {\n        placement = \"bottom\";\n      } else if (placement === \"right\" && tRect.right + offset + fRect.width > vw - VIEWPORT_PADDING && tRect.left - offset - fRect.width > VIEWPORT_PADDING) {\n        placement = \"left\";\n      } else if (placement === \"left\" && tRect.left - offset - fRect.width < VIEWPORT_PADDING && tRect.right + offset + fRect.width < vw - VIEWPORT_PADDING) {\n        placement = \"right\";\n      }\n    }\n\n    let top: number;\n    let left: number;\n\n    if (placement === \"bottom\" || placement === \"top\") {\n      top = placement === \"bottom\" ? tRect.bottom + offset : tRect.top - fRect.height - offset;\n\n      switch (align) {\n        case \"start\":\n          left = tRect.left;\n          break;\n        case \"end\":\n          left = tRect.right - fRect.width;\n          break;\n        default:\n          left = tRect.left + (tRect.width - fRect.width) / 2;\n      }\n    } else {\n      left = placement === \"right\" ? tRect.right + offset : tRect.left - fRect.width - offset;\n\n      switch (align) {\n        case \"start\":\n          top = tRect.top;\n          break;\n        case \"end\":\n          top = tRect.bottom - fRect.height;\n          break;\n        default:\n          top = tRect.top + (tRect.height - fRect.height) / 2;\n      }\n    }\n\n    left = Math.max(VIEWPORT_PADDING, Math.min(left, vw - fRect.width - VIEWPORT_PADDING));\n    top = Math.max(VIEWPORT_PADDING, Math.min(top, vh - fRect.height - VIEWPORT_PADDING));\n\n    // the same place is no change: a scroll anywhere on the page, the popup's own list included, re-renders nothing (the\n    // 25.17 second review: every scroll re-rendered an open list)\n    setPos((cur) => (cur.top === top && cur.left === left && cur.placement === placement ? cur : { top, left, placement }));\n  }, [triggerRef, floatingRef, side, align, offset, flip]);\n\n  useLayoutEffect(() => {\n    if (!open) return;\n\n    compute();\n\n    const onUpdate = () => {\n      cancelAnimationFrame(rafId.current);\n      rafId.current = requestAnimationFrame(compute);\n    };\n\n    window.addEventListener(\"scroll\", onUpdate, true);\n    window.addEventListener(\"resize\", onUpdate);\n\n    return () => {\n      cancelAnimationFrame(rafId.current);\n      window.removeEventListener(\"scroll\", onUpdate, true);\n      window.removeEventListener(\"resize\", onUpdate);\n    };\n  }, [open, compute]);\n\n  return pos;\n}\n","import { useLayoutEffect, useRef, type RefObject } from \"react\";\n\n/**\n * A ref that always holds the latest value of `value`, updated in a layout\n * effect (before paint, before any event can fire) rather than during render.\n *\n * Use it for callbacks read from long-lived listeners — `onClose` inside a\n * document keydown handler, `onDismiss` inside a timer — so the listener need\n * not be re-attached every render and never calls a stale closure.\n *\n * The write happens in a commit-phase effect, which is the React-sanctioned\n * place to touch refs (the React Compiler's `refs` rule rejects writes during\n * render).\n */\nexport function useLatest<T>(value: T): RefObject<T> {\n  const ref = useRef(value);\n  useLayoutEffect(() => {\n    ref.current = value;\n  });\n  return ref;\n}\n"]}

package/dist/{chunk-JTU7OBYJ.js → chunk-YL5KD5RC.js}

@@ -15,6 +15,7 @@ var FOCUS_RING = "focus-visible:outline-2 focus-visible:outline-solid focus-visi
 var PEER_FOCUS_RING = "peer-focus-visible:outline-2 peer-focus-visible:outline-solid peer-focus-visible:outline-offset-2 peer-focus-visible:outline-[var(--ds-focus)] peer-focus-visible:shadow-none";
 var GROUP_FOCUS_RING = "group-focus-visible:outline-2 group-focus-visible:outline-solid group-focus-visible:outline-offset-2 group-focus-visible:outline-[var(--ds-focus)] group-focus-visible:shadow-none";
 var FOCUS_INSET = "focus-visible:outline-2 focus-visible:outline-solid focus-visible:-outline-offset-[var(--ds-focus-inset)] focus-visible:outline-[var(--ds-focus)]";
+var FOCUS_INSET_WHILE_STOP = "data-[scroll-stop]:focus-visible:outline-2 data-[scroll-stop]:focus-visible:outline-solid data-[scroll-stop]:focus-visible:-outline-offset-[var(--ds-focus-inset)] data-[scroll-stop]:focus-visible:outline-[var(--ds-focus)]";
 var FOCUS_ROOM = 4;
 var atLeastFocusRoom = (length) => `max(${length}, ${FOCUS_ROOM}px)`;
 var FIELD_FOCUS_RING = "focus-visible:outline-2 focus-visible:outline-solid focus-visible:outline-offset-2 focus-visible:outline-[var(--ds-focus)] focus-visible:border-[var(--ds-focus)] [[data-input-modality=pointer]_&]:focus-visible:outline-none [[data-input-modality=pointer]_&]:focus-visible:border-[var(--ds-accent-ink)] [[data-input-modality=pointer]_&]:focus-visible:ring-2 [[data-input-modality=pointer]_&]:focus-visible:ring-[var(--ds-ring-active)]";
@@ -43,6 +44,6 @@ function unlockBodyScroll() {
   }
 }
 
-export { ACTIVE_RING, ERROR_ACTIVE_RING, ERROR_FOCUS_RING, ERROR_FOCUS_WITHIN_RING, ERROR_HAS_FOCUS_RING, FIELD_FOCUS_RING, FIELD_FOCUS_WITHIN_RING, FIELD_HAS_FOCUS_RING, FOCUS_INSET, FOCUS_RING, FOCUS_ROOM, GLASS_BACKDROP, GLASS_DROPDOWN, GLASS_OVERLAY, GLASS_SURFACE, GROUP_FOCUS_RING, OVERLAY_SURFACE, PEER_FOCUS_RING, atLeastFocusRoom, cn, lockBodyScroll, unlockBodyScroll };
-//# sourceMappingURL=chunk-JTU7OBYJ.js.map
-//# sourceMappingURL=chunk-JTU7OBYJ.js.map
+export { ACTIVE_RING, ERROR_ACTIVE_RING, ERROR_FOCUS_RING, ERROR_FOCUS_WITHIN_RING, ERROR_HAS_FOCUS_RING, FIELD_FOCUS_RING, FIELD_FOCUS_WITHIN_RING, FIELD_HAS_FOCUS_RING, FOCUS_INSET, FOCUS_INSET_WHILE_STOP, FOCUS_RING, FOCUS_ROOM, GLASS_BACKDROP, GLASS_DROPDOWN, GLASS_OVERLAY, GLASS_SURFACE, GROUP_FOCUS_RING, OVERLAY_SURFACE, PEER_FOCUS_RING, atLeastFocusRoom, cn, lockBodyScroll, unlockBodyScroll };
+//# sourceMappingURL=chunk-YL5KD5RC.js.map
+//# sourceMappingURL=chunk-YL5KD5RC.js.map

package/dist/chunk-YL5KD5RC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../showcase/src/lib/utils.ts"],"names":[],"mappings":";;;;;AAGO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA;AAC7B;AAEO,IAAM,cAAA,GAAiB;AAEvB,IAAM,aAAA,GAAgB,GAAG,cAAc,CAAA,qDAAA;AAEvC,IAAM,aAAA,GAAgB,GAAG,cAAc,CAAA,sDAAA;AAavC,IAAM,eAAA,GAAkB;AAExB,IAAM,cAAA,GAAiB,GAAG,cAAc,CAAA,yDAAA;AAWxC,IAAM,UAAA,GAAa;AAgBnB,IAAM,eAAA,GAAkB;AAExB,IAAM,gBAAA,GAAmB;AAUzB,IAAM,WAAA,GAAc;AAOpB,IAAM,sBAAA,GAAyB;AAO/B,IAAM,UAAA,GAAa;AAGnB,IAAM,mBAAmB,CAAC,MAAA,KAAmB,CAAA,IAAA,EAAO,MAAM,KAAK,UAAU,CAAA,GAAA;AAgBzE,IAAM,gBAAA,GAAmB;AAEzB,IAAM,uBAAA,GAA0B;AAEhC,IAAM,oBAAA,GAAuB;AAG7B,IAAM,gBAAA,GAAmB;AAEzB,IAAM,uBAAA,GAA0B;AAEhC,IAAM,oBAAA,GAAuB;AAK7B,IAAM,WAAA,GAAc;AAEpB,IAAM,iBAAA,GAAoB;AAMjC,IAAI,eAAA,GAAkB,CAAA;AACtB,IAAI,0BAAA,GAA6B,EAAA;AAE1B,SAAS,cAAA,GAAiB;AAC/B,EAAA,IAAI,oBAAoB,CAAA,EAAG;AACzB,IAAA,0BAAA,GAA6B,QAAA,CAAS,KAAK,KAAA,CAAM,QAAA;AACjD,IAAA,QAAA,CAAS,IAAA,CAAK,MAAM,QAAA,GAAW,QAAA;AAAA,EACjC;AACA,EAAA,eAAA,EAAA;AACF;AAEO,SAAS,gBAAA,GAAmB;AACjC,EAAA,IAAI,oBAAoB,CAAA,EAAG;AAC3B,EAAA,eAAA,EAAA;AACA,EAAA,IAAI,oBAAoB,CAAA,EAAG;AACzB,IAAA,QAAA,CAAS,IAAA,CAAK,MAAM,QAAA,GAAW,0BAAA;AAC/B,IAAA,0BAAA,GAA6B,EAAA;AAAA,EAC/B;AACF","file":"chunk-YL5KD5RC.js","sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n\nexport const GLASS_BACKDROP = \"[backdrop-filter:var(--ds-glass-filter)] [-webkit-backdrop-filter:var(--ds-glass-filter)]\";\n\nexport const GLASS_SURFACE = `${GLASS_BACKDROP} shadow-[var(--ds-shadow-card),var(--ds-glass-inset)]`;\n\nexport const GLASS_OVERLAY = `${GLASS_BACKDROP} shadow-[var(--ds-shadow-modal),var(--ds-glass-inset)]`;\n\n/**\n * A modal surface (Dialog, Drawer, Sheet, CommandPalette, GlobalSearch): the theme's surface, never less than 85% opaque.\n * A glass theme's surface is see-through by design, which suits a card on the canvas; over an overlay's scrim the same\n * glass reads as grey mud, and the page shows through (round 27, R27-17, the owner picked 85% from a mock-up). An opaque\n * theme keeps its surface as it is: the alpha only rises, through CSS relative colour, in every mode and scope.\n *\n * The theme's surface comes first, for a browser without relative colour (Chrome before 119, Firefox before 128,\n * Safari before 16.4): a value holding var() is only found invalid once computed, which drops the background to\n * transparent rather than to an earlier declaration, so the raised one applies only where @supports says it can (the\n * round 27 review). A surface with no colour at all (fully transparent) stays so: raising it would paint it black.\n */\nexport const OVERLAY_SURFACE = \"bg-[var(--ds-bg-surface)] supports-[color:oklch(from_red_l_c_h)]:bg-[oklch(from_var(--ds-bg-surface)_l_c_h_/_max(alpha,min(1,alpha*1000)*0.85))]\";\n\nexport const GLASS_DROPDOWN = `${GLASS_BACKDROP} shadow-[var(--ds-shadow-dropdown),var(--ds-glass-inset)]`;\n\n// Keyboard focus (Sprint 30, the owner's D1 and D6): where Tab has landed. A solid outline in the theme's focus colour\n// (--ds-focus, derived to 3:1 on every ground), 2 px, with a 2 px gap between it and the element. The gap shows what the\n// element sits on, so one colour reads beside any fill, and while the outline shows, the element's own shadow steps\n// aside (D7, P12): shadow-none drops its --tw-shadow and keeps any ring. Every part is prefixed: an unprefixed\n// outline-solid draws an outline at rest. And outline-solid is required: in Tailwind 4, outline-none (which many\n// components set at rest) sets --tw-outline-style: none, which outline-2 reads, so without it no outline draws. These\n// draw no border (a button that uses one, the Launcher, gets the outline alone); a field takes FIELD_FOCUS_RING. `cn()`\n// keeps only the last of outline-none and outline-solid in one variant, so a component's own focus-visible:outline-none\n// after a utility would remove the outline: none may follow one.\nexport const FOCUS_RING = \"focus-visible:outline-2 focus-visible:outline-solid focus-visible:outline-offset-2 focus-visible:outline-[var(--ds-focus)] focus-visible:shadow-none\";\n\n/**\n * On a wrapper that shows focus for a control inside it: HAS_FOCUS_RING, from the keyboard only (`:has(:focus-visible)`).\n * FOCUS_WITHIN_RING shows it on any focus inside, a click's too, since `:focus-within` has no keyboard-only form: kept\n * for code that uses it, and a new wrapper takes HAS_FOCUS_RING (D6: keyboard focus shows only from the keyboard).\n */\nexport const FOCUS_WITHIN_RING = \"focus-within:outline-2 focus-within:outline-solid focus-within:outline-offset-2 focus-within:outline-[var(--ds-focus)] focus-within:shadow-none\";\n\nexport const HAS_FOCUS_RING = \"has-[:focus-visible]:outline-2 has-[:focus-visible]:outline-solid has-[:focus-visible]:outline-offset-2 has-[:focus-visible]:outline-[var(--ds-focus)] has-[:focus-visible]:shadow-none\";\n\n/**\n * The outline on a drawn child, where the element that takes focus is hidden or wraps it: a checkbox's box beside its\n * input (`peer`), a radio's circle inside its button, a separator's grip, a Gantt milestone's diamond (`group`). The\n * same outline, gap and shadow rule.\n */\nexport const PEER_FOCUS_RING = \"peer-focus-visible:outline-2 peer-focus-visible:outline-solid peer-focus-visible:outline-offset-2 peer-focus-visible:outline-[var(--ds-focus)] peer-focus-visible:shadow-none\";\n\nexport const GROUP_FOCUS_RING = \"group-focus-visible:outline-2 group-focus-visible:outline-solid group-focus-visible:outline-offset-2 group-focus-visible:outline-[var(--ds-focus)] group-focus-visible:shadow-none\";\n\n/**\n * The same outline drawn inside the element's edge, for edge-to-edge rows, cells and scroll regions only (the plan's\n * P3): elements that are never filled solid, since inside the edge there is no gap to keep one colour readable on a fill.\n * It sits `--ds-focus-inset` in: 5 px, deeper where the theme's corners are rounder, so it clears a table's rounded\n * corners (D8, the owner's decision A); what such an element holds keeps 1 px more clear of its edge. Anywhere else the\n * outline stays outside, with room made for it. Moved here from use-keyboard-scroll.ts (Sprint 30) so the server-safe\n * `gridsmith-ui/utils` can export it.\n */\nexport const FOCUS_INSET = \"focus-visible:outline-2 focus-visible:outline-solid focus-visible:-outline-offset-[var(--ds-focus-inset)] focus-visible:outline-[var(--ds-focus)]\";\n\n/**\n * FOCUS_INSET only while the element is a scroll region's Tab stop (useKeyboardScroll's `data-scroll-stop`), for one that\n * takes focus by script for another reason and shows no ring for it: the shell's <main>, the skip link's target (Sprint\n * 25.29 item 10).\n */\nexport const FOCUS_INSET_WHILE_STOP = \"data-[scroll-stop]:focus-visible:outline-2 data-[scroll-stop]:focus-visible:outline-solid data-[scroll-stop]:focus-visible:-outline-offset-[var(--ds-focus-inset)] data-[scroll-stop]:focus-visible:outline-[var(--ds-focus)]\";\n\n/**\n * The room FOCUS_RING's outline takes outside its element, in px: its 2 px gap and 2 px line (Sprint 30, P3). Where a\n * container clips, what sits beside its edge keeps this much clear of it: a fixed size, never a theme space. Internal,\n * as is the one below (exports/utils.ts exports by name).\n */\nexport const FOCUS_ROOM = 4;\n\n/** A theme's length that sets how far something sits from a clipping edge, never under FOCUS_ROOM (Sprint 25.27). */\nexport const atLeastFocusRoom = (length: string) => `max(${length}, ${FOCUS_ROOM}px)`;\n\n/**\n * A field (D6, P4, P13). Reached with Tab: the keyboard's outline, and its border in the focus colour, as GOV.UK turns a\n * focused input's border: it is where you type. Clicked into: the active look instead, the accent border and its soft\n * halo (`ring-2` in --ds-ring-active, laid over the field's own shadow), and no outline. A browser matches :focus-visible\n * on a text field either way, so lib/input-modality.ts notes on <html> whether a pointer moved focus last; with no note\n * yet, the outline. The field keeps its own (inset) shadow in both: no shadow-none here.\n *\n * The wrapper forms (_WITHIN_ and _HAS_, for a box round the part you type in) show it while that part has focus, and\n * not while a control of the field's own does: a button, a select, a link, a checkbox, a radio or a switch inside it (a\n * tag's remove, a picker's chevron, a composer's Send, an editor's toolbar or a task's checkbox), or anything in a popup\n * inside the box (a dialog of its own; a field that is itself in a dialog still shows it). That control shows its own outline, so there is one focus point, never\n * two (P11). _WITHIN_ reads :focus, as a click on a date's segment isn't :focus-visible; _HAS_ reads :focus-visible.\n * Either outranks the field's hover border, so hovering keeps the look.\n */\nexport const FIELD_FOCUS_RING = \"focus-visible:outline-2 focus-visible:outline-solid focus-visible:outline-offset-2 focus-visible:outline-[var(--ds-focus)] focus-visible:border-[var(--ds-focus)] [[data-input-modality=pointer]_&]:focus-visible:outline-none [[data-input-modality=pointer]_&]:focus-visible:border-[var(--ds-accent-ink)] [[data-input-modality=pointer]_&]:focus-visible:ring-2 [[data-input-modality=pointer]_&]:focus-visible:ring-[var(--ds-ring-active)]\";\n\nexport const FIELD_FOCUS_WITHIN_RING = \"has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-2 has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-solid has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-offset-2 has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-[var(--ds-focus)] has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:border-[var(--ds-focus)] [[data-input-modality=pointer]_&]:has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-none [[data-input-modality=pointer]_&]:has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:border-[var(--ds-accent-ink)] [[data-input-modality=pointer]_&]:has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:ring-2 [[data-input-modality=pointer]_&]:has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:ring-[var(--ds-ring-active)]\";\n\nexport const FIELD_HAS_FOCUS_RING = \"has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-2 has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-solid has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-offset-2 has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-[var(--ds-focus)] has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:border-[var(--ds-focus)] [[data-input-modality=pointer]_&]:has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-none [[data-input-modality=pointer]_&]:has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:border-[var(--ds-accent-ink)] [[data-input-modality=pointer]_&]:has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:ring-2 [[data-input-modality=pointer]_&]:has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:ring-[var(--ds-ring-active)]\";\n\n// A field with an error: the same, its red border kept, and the red halo when clicked into.\nexport const ERROR_FOCUS_RING = \"focus-visible:outline-2 focus-visible:outline-solid focus-visible:outline-offset-2 focus-visible:outline-[var(--ds-focus)] focus-visible:border-[var(--ds-status-error)] [[data-input-modality=pointer]_&]:focus-visible:outline-none [[data-input-modality=pointer]_&]:focus-visible:ring-2 [[data-input-modality=pointer]_&]:focus-visible:ring-[var(--ds-ring-error)]\";\n\nexport const ERROR_FOCUS_WITHIN_RING = \"has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-2 has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-solid has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-offset-2 has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-[var(--ds-focus)] has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:border-[var(--ds-status-error)] [[data-input-modality=pointer]_&]:has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:outline-none [[data-input-modality=pointer]_&]:has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:ring-2 [[data-input-modality=pointer]_&]:has-[:focus:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus))]:ring-[var(--ds-ring-error)]\";\n\nexport const ERROR_HAS_FOCUS_RING = \"has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-2 has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-solid has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-offset-2 has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-[var(--ds-focus)] has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:border-[var(--ds-status-error)] [[data-input-modality=pointer]_&]:has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:outline-none [[data-input-modality=pointer]_&]:has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:ring-2 [[data-input-modality=pointer]_&]:has-[:focus-visible:not(button,select,a,[role=button],input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch])]:[&:not(:has([role=dialog]_:focus-visible))]:ring-[var(--ds-ring-error)]\";\n\n// Active (D6): a field clicked into, or a dropdown or picker that's open, is its accent border (--ds-accent-ink, P8) with\n// the soft halo beyond it; on a field with an error, red with the red halo. Never an outline: that is keyboard focus's.\n// Choices (a selected card, row or swatch, the Stepper's current step) draw their own selected look, not this (D2).\nexport const ACTIVE_RING = \"border-[var(--ds-accent-ink)] ring-2 ring-[var(--ds-ring-active)]\";\n\nexport const ERROR_ACTIVE_RING = \"border-[var(--ds-status-error)] ring-2 ring-[var(--ds-ring-error)]\";\n\n// Body scroll lock is reference-counted so stacked overlays (a Dialog opened\n// from a Drawer, for example) only restore scrolling when the LAST one\n// closes. The original overflow value is captured on the first lock and put\n// back on the last unlock; an unbalanced unlock is clamped at zero.\nlet scrollLockCount = 0;\nlet scrollLockPreviousOverflow = \"\";\n\nexport function lockBodyScroll() {\n  if (scrollLockCount === 0) {\n    scrollLockPreviousOverflow = document.body.style.overflow;\n    document.body.style.overflow = \"hidden\";\n  }\n  scrollLockCount++;\n}\n\nexport function unlockBodyScroll() {\n  if (scrollLockCount === 0) return;\n  scrollLockCount--;\n  if (scrollLockCount === 0) {\n    document.body.style.overflow = scrollLockPreviousOverflow;\n    scrollLockPreviousOverflow = \"\";\n  }\n}\n\n/** Test-only: current number of active locks. */\nexport function getBodyScrollLockCount() {\n  return scrollLockCount;\n}\n"]}

package/dist/data-grid.d.ts

@@ -1,9 +1,14 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ColumnDef } from '@tanstack/react-table';
-import { B as BreakpointKey, C as ColumnKind } from './table-utils-CxnpFHRF.js';
+import { B as BreakpointKey, C as ColumnKind } from './table-utils-BXkP-2Hx.js';
 import { P as Pager } from './use-pagination-QykGSREv.js';
 import 'react';
 
+/** One of a choice column's options: the value its cells hold, and the words shown for it. */
+interface DataGridOption {
+    value: string | number;
+    label: string;
+}
 /** Column meta for opt-in truncation. Set on ColumnDef.meta. */
 interface DataGridColumnMeta {
     /** true = single-line, or { lines: N } for multi-line clamp. */
@@ -16,15 +21,29 @@ interface DataGridColumnMeta {
     width?: string;
     /** CSS min-width for the column. */
     minWidth?: string;
-    /** Explicit column kind. When omitted the DataGrid infers it from data values. */
+    /**
+     * Explicit column kind. When omitted the DataGrid infers it from data values (a yes or no too; never a choice). In an
+     * editable grid it chooses the editor, where the control can hold the cell's value: "number" a NumberInput for a
+     * number, "date" a DatePicker for a Date or an ISO date ("2026-10-14"), "choice" a Dropdown of `options`, "boolean" a
+     * Checkbox; any other kind, and a number or a date written as text ("18 KB", "12 Jan 2026"), a text Input.
+     */
     kind?: ColumnKind;
     /** Horizontal alignment of the header and the cells; a block element (a Checkbox, a Button) is laid out with flex so it follows too (round 14). Default: numbers right, everything else left. */
     align?: "left" | "center" | "right";
-    /** In an editable grid, whether this column's cells edit (default true); false for a column that shows (a status, actions). */
+    /**
+     * In an editable grid, whether this column's cells edit (default true); false for a column that shows (a status, a
+     * calculated value, actions): its cells show no edit cue, and assistive tech hears them as read-only.
+     */
     editable?: boolean;
     /**
-     * In an editable grid, the value onCellEdit gets from the text typed (default the text itself): a number column's
-     * `(text) => Number(text)`, so a salary stays a number (the review of 30 September).
+     * A choice column's options (with `kind: "choice"`): its cells edit with a Dropdown of them, and a save gives the
+     * option's `value`. Give the column a `cell` that shows the option's label.
+     */
+    options?: readonly DataGridOption[];
+    /**
+     * In an editable grid, the value onCellEdit gets from what was typed in a text cell, or in a number cell as its text
+     * (default the text itself, or the number): a price written as text, `(text) => Number(text.replace(/[$,]/g, ""))`.
+     * A date, a choice and a yes or no are given as their own values.
      */
     parse?: (text: string) => unknown;
 }
@@ -66,4 +85,4 @@ interface DataGridProps<T> {
 }
 declare function DataGrid<T>({ data, columns, pageSize, editable, onCellEdit, mobileBreakpoint: mobileBreakpointProp, cardsBelow, pager: pagerProp, "aria-label": ariaLabel, className, }: DataGridProps<T>): react_jsx_runtime.JSX.Element;
 
-export { DataGrid, type DataGridColumnMeta };
+export { DataGrid, type DataGridColumnMeta, type DataGridOption };