@nadicodeai/ui 12.1.95 → 12.1.97

package/dist/components/form.js

@@ -6,20 +6,40 @@ import { useRender } from "@base-ui/react/use-render";
 import { Controller, FormProvider, useFormContext, useFormState, } from "react-hook-form";
 import { cn } from "../lib/utils.js";
 import { Label } from "./label.js";
+/**
+ * A react-hook-form form whose fields bind their label, help and message for the reader.
+ *
+ * @family Inputs
+ * @when A client form whose values, validation and submit run through react-hook-form: `FormField`
+ * binds a control, `FormMessage` shows its error.
+ * @instead A settings group that saves on its own is `SettingsSection`. A short form in a dialog is
+ * `FormDialog`; one in a row is `RowEditForm`. A form with no client validation is a plain `form`
+ * with `Field`.
+ * @behaviour Validation runs on submit and on leaving a field, then updates while the value is
+ * corrected. A failed save keeps every value. The submit is `type="submit"`, so Enter in a field
+ * submits.
+ * @words Messages come from the product's catalogue or schema: how to fix the value, not what went
+ * wrong.
+ * @access `FormControl` gives the control its `id`, `aria-invalid` and `aria-describedby` (help,
+ * then message); `FormMessage` is read when it appears.
+ */
 const Form = FormProvider;
-const FormFieldContext = React.createContext({});
+const FormFieldContext = React.createContext(null);
 const FormField = ({ ...props }) => {
     return (_jsx(FormFieldContext.Provider, { value: { name: props.name }, children: _jsx(Controller, { ...props }) }));
 };
 const useFormField = () => {
     const fieldContext = React.useContext(FormFieldContext);
     const itemContext = React.useContext(FormItemContext);
-    const { getFieldState } = useFormContext();
-    const formState = useFormState({ name: fieldContext.name });
-    const fieldState = getFieldState(fieldContext.name, formState);
     if (!fieldContext) {
         throw new Error("useFormField should be used within <FormField>");
     }
+    if (!itemContext) {
+        throw new Error("useFormField should be used within <FormItem>");
+    }
+    const { getFieldState } = useFormContext();
+    const formState = useFormState({ name: fieldContext.name });
+    const fieldState = getFieldState(fieldContext.name, formState);
     const { id } = itemContext;
     return {
         id,
@@ -30,7 +50,7 @@ const useFormField = () => {
         ...fieldState,
     };
 };
-const FormItemContext = React.createContext({});
+const FormItemContext = React.createContext(null);
 function FormItem({ className, ...props }) {
     const id = React.useId();
     return (_jsx(FormItemContext.Provider, { value: { id }, children: _jsx("div", { "data-slot": "form-item", className: cn("grid gap-2", className), ...props }) }));

package/dist/components/glass-control.d.ts

@@ -1,5 +1,18 @@
 import { useRender } from "@base-ui/react/use-render";
 type GlassControlShape = "control" | "bar";
+/**
+ * A control or a bar on glass, floating over content that moves under it.
+ *
+ * @family Menus
+ * @when A control that floats over content passing under it: a period picker over a chart, a bar
+ * over the product view.
+ * @instead A control on a solid ground is drawn plain; glass over nothing reads as a bordered box.
+ * A toolbar over its own rows is `CollectionToolbar`.
+ * @behaviour The glass material at the floating height; `shape="control"` takes 6 px corners,
+ * `shape="bar"` none. The caller renders the element through `render`.
+ * @words None of its own.
+ * @access Takes the semantics of what it renders; the glass is paint.
+ */
 declare function GlassControl({ className, render, shape, ...props }: useRender.ComponentProps<"div"> & {
     shape?: GlassControlShape;
 }): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;

package/dist/components/glass-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glass-control.d.ts","sourceRoot":"","sources":["../../src/components/glass-control.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAItD,KAAK,iBAAiB,GAAG,SAAS,GAAG,KAAK,CAAC;AAE3C,iBAAS,YAAY,CAAC,EACpB,SAAS,EACT,MAAM,EACN,KAAiB,EACjB,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,iBAAiB,CAAA;CAAE,8FAiBjE;AAED,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"glass-control.d.ts","sourceRoot":"","sources":["../../src/components/glass-control.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAItD,KAAK,iBAAiB,GAAG,SAAS,GAAG,KAAK,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,iBAAS,YAAY,CAAC,EACpB,SAAS,EACT,MAAM,EACN,KAAiB,EACjB,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,iBAAiB,CAAA;CAAE,8FAiBjE;AAED,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,CAAC"}

package/dist/components/glass-control.js

@@ -1,6 +1,19 @@
 import { mergeProps } from "@base-ui/react/merge-props";
 import { useRender } from "@base-ui/react/use-render";
 import { cn } from "../lib/utils.js";
+/**
+ * A control or a bar on glass, floating over content that moves under it.
+ *
+ * @family Menus
+ * @when A control that floats over content passing under it: a period picker over a chart, a bar
+ * over the product view.
+ * @instead A control on a solid ground is drawn plain; glass over nothing reads as a bordered box.
+ * A toolbar over its own rows is `CollectionToolbar`.
+ * @behaviour The glass material at the floating height; `shape="control"` takes 6 px corners,
+ * `shape="bar"` none. The caller renders the element through `render`.
+ * @words None of its own.
+ * @access Takes the semantics of what it renders; the glass is paint.
+ */
 function GlassControl({ className, render, shape = "control", ...props }) {
     return useRender({
         defaultTagName: "div",

package/dist/components/heatmap/calendar-heatmap.d.ts.map

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

package/dist/components/heatmap/calendar-heatmap.js

@@ -282,14 +282,14 @@ export const CalendarHeatmap = ({ data, weekStart = 0, continuousMonths = true,
     const dataWithLevels = useMemo(() => {
         if (data.length === 0)
             return [];
-        const measuredValues = data.flatMap((activity) => typeof activity.value === "number" && Number.isFinite(activity.value) ? [activity.value] : []);
+        const measuredValues = data.flatMap((activity) => activity.value !== null && Number.isFinite(activity.value) ? [activity.value] : []);
         const maxCount = measuredValues.reduce((max, value) => Math.max(max, value), 1);
         const minCount = isNormalized
             ? measuredValues.reduce((min, value) => Math.min(min, value), Infinity)
             : 0;
         return data.map((activity) => {
             const value = activity.value;
-            const measured = typeof value === "number" && Number.isFinite(value);
+            const measured = value !== null && Number.isFinite(value);
             return {
                 ...activity,
                 measured,
@@ -314,7 +314,7 @@ export const CalendarHeatmap = ({ data, weekStart = 0, continuousMonths = true,
     const labelHeight = fontSize + LABEL_MARGIN;
     const firstDatum = data[0];
     const year = firstDatum ? getYear(parseISO(firstDatum.date)) : new Date().getFullYear();
-    const totalCount = typeof totalCountProp === "number"
+    const totalCount = totalCountProp !== undefined
         ? totalCountProp
         : dataWithLevels.reduce((sum, activity) => sum + (activity.value ?? 0), 0);
     const blockWidth = blockSize * blockAspectRatio;
@@ -376,7 +376,9 @@ export const CalendarHeatmapBlock = ({ ref, activity, dayIndex, weekIndex, highl
     const { blockSize, blockWidth, blockMargin, blockRadius, labelHeight, labels, levels, isNormalized, colors, } = useCalendarHeatmap();
     const level = Math.max(0, Math.min(colorStepCount(levels, isNormalized), activity.level));
     const cellLabel = labels.cellLabel ?? "{{date}}: {{value}} contributions";
-    const ariaLabel = typeof cellLabel === "function"
+    const ariaLabel = 
+    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- cellLabel is our own string | (activity => string) union, told apart only by typeof.
+    typeof cellLabel === "function"
         ? cellLabel(activity)
         : cellLabel
             .replace("{{date}}", activity.date)

package/dist/components/hive-scene.d.ts

@@ -54,6 +54,20 @@ export type HiveSceneProps = Omit<React.ComponentProps<"div">, "children"> & {
     label?: string;
     children?: React.ReactNode;
 };
+/**
+ * Alveare's entry scene: its picture, its logo and six Agent orbs around the words.
+ *
+ * @family Other
+ * @when Alveare's entry screens, on its desktop and on Alveare Server: joining, loading, a failure.
+ * @instead Nadia's entry screens are `EntryScene`. A product page never stands on a scene.
+ * @behaviour `join` puts the words in the hexagon's middle, `loading` draws the orbs in with no
+ * words, `still` shows no Agent and no work. Only the orbs and the particles move; reduced motion
+ * stops both. Black in every theme.
+ * @words The words are the screen's own: a title, a line, one action. The logo's label names
+ * Alveare.
+ * @access The canvases are hidden; the logo's image is named by its label. In `loading` the scene
+ * is `role="status"` named by `label`; otherwise the words and their action are the reading.
+ */
 declare function HiveScene({ mode, column, logo, picture, work, chrome, label, className, children, ...props }: HiveSceneProps): React.JSX.Element;
 /** The screen's one heading, in the middle of the hive. */
 declare function HiveTitle({ children, id }: {

package/dist/components/hive-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hive-scene.d.ts","sourceRoot":"","sources":["../../src/components/hive-scene.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IAC9B,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC3E,IAAI,EAAE,aAAa,CAAC;IACpB,qFAAqF;IACrF,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,kFAAkF;IAClF,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mFAAmF;IACnF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,QAAQ,CAAC;IAC7D,iEAAiE;IACjE,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAmLF,iBAAS,SAAS,CAAC,EACjB,IAAI,EACJ,MAAkB,EAClB,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,MAAM,EACN,KAAK,EACL,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,qBAsNhB;AAED,2DAA2D;AAC3D,iBAAS,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,qBAM9E;AAED,iEAAiE;AACjE,iBAAS,QAAQ,CAAC,EAChB,QAAQ,EACR,EAAE,EACF,IAAa,GACd,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB,qBAMA;AAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"hive-scene.d.ts","sourceRoot":"","sources":["../../src/components/hive-scene.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IAC9B,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC3E,IAAI,EAAE,aAAa,CAAC;IACpB,qFAAqF;IACrF,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,kFAAkF;IAClF,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mFAAmF;IACnF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,QAAQ,CAAC;IAC7D,iEAAiE;IACjE,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAmLF;;;;;;;;;;;;;GAaG;AACH,iBAAS,SAAS,CAAC,EACjB,IAAI,EACJ,MAAkB,EAClB,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,MAAM,EACN,KAAK,EACL,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,qBAsNhB;AAED,2DAA2D;AAC3D,iBAAS,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,qBAM9E;AAED,iEAAiE;AACjE,iBAAS,QAAQ,CAAC,EAChB,QAAQ,EACR,EAAE,EACF,IAAa,GACd,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB,qBAMA;AAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC"}

package/dist/components/hive-scene.js

@@ -150,6 +150,20 @@ function along(particle, t) {
 function pick(items) {
     return items[Math.floor(Math.random() * items.length)];
 }
+/**
+ * Alveare's entry scene: its picture, its logo and six Agent orbs around the words.
+ *
+ * @family Other
+ * @when Alveare's entry screens, on its desktop and on Alveare Server: joining, loading, a failure.
+ * @instead Nadia's entry screens are `EntryScene`. A product page never stands on a scene.
+ * @behaviour `join` puts the words in the hexagon's middle, `loading` draws the orbs in with no
+ * words, `still` shows no Agent and no work. Only the orbs and the particles move; reduced motion
+ * stops both. Black in every theme.
+ * @words The words are the screen's own: a title, a line, one action. The logo's label names
+ * Alveare.
+ * @access The canvases are hidden; the logo's image is named by its label. In `loading` the scene
+ * is `role="status"` named by `label`; otherwise the words and their action are the reading.
+ */
 function HiveScene({ mode, column = "default", logo, picture, work, chrome, label, className, children, ...props }) {
     const sceneRef = React.useRef(null);
     const combRef = React.useRef(null);

package/dist/components/house-icons.d.ts

@@ -1,5 +1,20 @@
 import { type LucideIcon } from "lucide-react";
 /** The company and its doors. */
+/**
+ * The house's own icons, the arch, the approvals arch and the Agent, as Lucide components.
+ *
+ * @family Status
+ * @when Wherever an icon names the company (`ArchIcon`), the work waiting on a person
+ * (`ApprovalsIcon`), or Agents as a section (`AgentIcon`). 12, 16, 20 and 24 px; 20 in persistent
+ * navigation.
+ * @instead Lucide for everything else. A particular Agent is her orb, not the agent icon. No Lucide
+ * glyph, a circle or a bot, stands in for these three.
+ * @behaviour Rendered exactly as Lucide: 1.5 px line (1.25 at 12), round caps and joins, no fill
+ * except the agent's dot, the text colour. Interchangeable with any Lucide icon wherever a
+ * `LucideIcon` is expected.
+ * @words Always beside its label in navigation: *Agents*, *Approvals*.
+ * @access Decorative beside text. An icon-only control carries its own `aria-label`.
+ */
 export declare const ArchIcon: LucideIcon;
 /** The arch with a check: work waiting on a person. */
 export declare const ApprovalsIcon: LucideIcon;

package/dist/components/house-icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"house-icons.d.ts","sourceRoot":"","sources":["../../src/components/house-icons.tsx"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAsBjE,iCAAiC;AACjC,eAAO,MAAM,QAAQ,EAAE,UAA8D,CAAC;AAEtF,uDAAuD;AACvD,eAAO,MAAM,aAAa,EAAE,UAG3B,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,SAAS,EAAE,UAAgE,CAAC"}
+{"version":3,"file":"house-icons.d.ts","sourceRoot":"","sources":["../../src/components/house-icons.tsx"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAsBjE,iCAAiC;AACjC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,EAAE,UAA8D,CAAC;AAEtF,uDAAuD;AACvD,eAAO,MAAM,aAAa,EAAE,UAG3B,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,SAAS,EAAE,UAAgE,CAAC"}

package/dist/components/house-icons.js

@@ -14,8 +14,26 @@ import { createLucideIcon } from "lucide-react";
  * React and nowhere else. Without it every house icon logs a missing-key
  * warning the first time it renders.
  */
-const toNode = (node) => node.map(([element, attributes], index) => [element, { ...attributes, key: `${element}-${index}` }]);
+const toNode = (node) => node.map(([element, attributes], index) => [
+    element,
+    { ...attributes, key: `${element}-${index}` },
+]);
 /** The company and its doors. */
+/**
+ * The house's own icons, the arch, the approvals arch and the Agent, as Lucide components.
+ *
+ * @family Status
+ * @when Wherever an icon names the company (`ArchIcon`), the work waiting on a person
+ * (`ApprovalsIcon`), or Agents as a section (`AgentIcon`). 12, 16, 20 and 24 px; 20 in persistent
+ * navigation.
+ * @instead Lucide for everything else. A particular Agent is her orb, not the agent icon. No Lucide
+ * glyph, a circle or a bot, stands in for these three.
+ * @behaviour Rendered exactly as Lucide: 1.5 px line (1.25 at 12), round caps and joins, no fill
+ * except the agent's dot, the text colour. Interchangeable with any Lucide icon wherever a
+ * `LucideIcon` is expected.
+ * @words Always beside its label in navigation: *Agents*, *Approvals*.
+ * @access Decorative beside text. An icon-only control carries its own `aria-label`.
+ */
 export const ArchIcon = createLucideIcon("arch", toNode(houseIcons.arch));
 /** The arch with a check: work waiting on a person. */
 export const ApprovalsIcon = createLucideIcon("approvals", toNode(houseIcons.approvals));

package/dist/components/hover-card.d.ts

@@ -1,4 +1,19 @@
 import { PreviewCard as PreviewCardPrimitive } from "@base-ui/react/preview-card";
+/**
+ * A preview of a few facts about something named in a dense row.
+ *
+ * @family Feedback
+ * @when A preview of a few facts about something named in a dense row: the exact moment behind a
+ * relative time, a record's summary.
+ * @instead For one phrase use `Tooltip`. For anything to edit or keep open use a `Sheet` or the
+ * record's page. Never the only way to an action.
+ * @behaviour Opens on hover and on focus, below by default, 4 px off; stays while the pointer is on
+ * it. Solid floating surface, 12 px padding.
+ * @words Facts, not prose: the date in words, the time with its zone, the machine timestamp. The
+ * trigger keeps its verb sentence: *Updated 3 hours ago*.
+ * @access The trigger is a real element with its own name (a `time` with its `datetime` for a
+ * moment), so the facts never depend on hover. Keyboard opening is tested, not assumed.
+ */
 declare function HoverCard({ ...props }: PreviewCardPrimitive.Root.Props): import("react").JSX.Element;
 declare function HoverCardTrigger({ ...props }: PreviewCardPrimitive.Trigger.Props): import("react").JSX.Element;
 declare function HoverCardContent({ className, side, sideOffset, align, alignOffset, ...props }: PreviewCardPrimitive.Popup.Props & Pick<PreviewCardPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset">): import("react").JSX.Element;

package/dist/components/hover-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hover-card.d.ts","sourceRoot":"","sources":["../../src/components/hover-card.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAKlF,iBAAS,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,IAAI,CAAC,KAAK,+BAE/D;AAED,iBAAS,gBAAgB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,OAAO,CAAC,KAAK,+BAEzE;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,IAAe,EACf,UAAc,EACd,KAAgB,EAChB,WAAe,EACf,GAAG,KAAK,EACT,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,GACjC,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC,+BAsB7F;AAED,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"hover-card.d.ts","sourceRoot":"","sources":["../../src/components/hover-card.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAKlF;;;;;;;;;;;;;;GAcG;AACH,iBAAS,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,IAAI,CAAC,KAAK,+BAE/D;AAED,iBAAS,gBAAgB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,OAAO,CAAC,KAAK,+BAEzE;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,IAAe,EACf,UAAc,EACd,KAAgB,EAChB,WAAe,EACf,GAAG,KAAK,EACT,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,GACjC,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC,+BAsB7F;AAED,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/hover-card.js

@@ -3,6 +3,21 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { PreviewCard as PreviewCardPrimitive } from "@base-ui/react/preview-card";
 import { anchoredOverlayMotion } from "../lib/motion.js";
 import { cn } from "../lib/utils.js";
+/**
+ * A preview of a few facts about something named in a dense row.
+ *
+ * @family Feedback
+ * @when A preview of a few facts about something named in a dense row: the exact moment behind a
+ * relative time, a record's summary.
+ * @instead For one phrase use `Tooltip`. For anything to edit or keep open use a `Sheet` or the
+ * record's page. Never the only way to an action.
+ * @behaviour Opens on hover and on focus, below by default, 4 px off; stays while the pointer is on
+ * it. Solid floating surface, 12 px padding.
+ * @words Facts, not prose: the date in words, the time with its zone, the machine timestamp. The
+ * trigger keeps its verb sentence: *Updated 3 hours ago*.
+ * @access The trigger is a real element with its own name (a `time` with its `datetime` for a
+ * moment), so the facts never depend on hover. Keyboard opening is tested, not assumed.
+ */
 function HoverCard({ ...props }) {
     return _jsx(PreviewCardPrimitive.Root, { "data-slot": "hover-card", ...props });
 }

package/dist/components/identity-mark.d.ts

@@ -0,0 +1,55 @@
+import type { ComponentType, CSSProperties, ReactElement, ReactNode } from "react";
+import { type AgentOrbFigure, type AgentOrbState } from "./agent-orb.js";
+import { type AppMarkGlyph } from "./app-mark.js";
+export type IdentityMarkSize = 20 | 24 | 28 | 32 | 40 | 64;
+/** A navigation icon from any Lucide build: the package's and Hermes's ship different versions of the same icons. */
+export type IconComponent = ComponentType<{
+    className?: string;
+    size?: number;
+    "aria-hidden"?: boolean | "true" | "false";
+}>;
+export type IdentityMarkProps = {
+    /** 32 in a row, 64 at an object's head, 24 in a feed or a sidebar identity line, 40 for a Library entry. */
+    size?: IdentityMarkSize;
+    /** Its accessible name where it stands without its name beside it (a narrow rail). Decorative otherwise. */
+    label?: string;
+} & ({
+    kind: "agent";
+    orb: {
+        form: AgentOrbFigure;
+        color?: CSSProperties["color"];
+        state?: AgentOrbState;
+    };
+    /** Wraps the drawn orb, such as in the product's view transition that carries her to her page. */
+    frame?: (orb: ReactElement) => ReactNode;
+} | ({
+    kind: "app";
+    app: string;
+} & AppMarkGlyph) | {
+    kind: "company";
+    name: string;
+} | {
+    kind: "person";
+    name: string;
+    image?: string;
+} | {
+    kind: "record";
+    /** The kind's own icon, the one its section has in the navigation: Mail for a mailbox. */
+    icon: IconComponent;
+    /** A catalogue kind's ground; neutral is the ringed card ground. */
+    tone?: "neutral" | "skill" | "plugin" | "teal";
+});
+/**
+ * What says which thing a record is, at a fixed size at the start of its row,
+ * its object's head or its feed line: an Agent's orb, an app's logo, a
+ * company's initials, a person's picture, or a record kind's icon on its tile.
+ *
+ * @family Status
+ * @when The first thing in a record's row (32), at the head of its object page (64), in a feed or a sidebar identity line (24), on a Library entry (40): wherever it tells a person which thing they are looking at.
+ * @instead An icon beside a card's title, a KPI's label or a section heading only repeats the words and is left out. A picture for a first use or a whole-page moment is the empty state's or the page's own. A model is its `ModelIdentity`.
+ * @behaviour Static, except an Agent's orb, which moves with her state. An Agent is always her orb from the orb engine, never an avatar or a painted circle, and `frame` lets the product wrap that orb, such as in the transition that carries her to her page; an app keeps its own logo on the white tile; a company is two initials on the ringed card tile; a person is their picture, then their initials; a record with no picture of its own takes its kind's navigation icon, on the purple ground for a skill and the blue one for a plugin.
+ * @words None of its own: the record's name stands beside it. Initials are the first letters of the name's first two words.
+ * @access Decorative beside the record's name. Alone, as in a narrow rail, `label` names it.
+ */
+export declare function IdentityMark(props: IdentityMarkProps): ReactNode;
+//# sourceMappingURL=identity-mark.d.ts.map

package/dist/components/identity-mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-mark.d.ts","sourceRoot":"","sources":["../../src/components/identity-mark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEnF,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAInE,MAAM,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAE3D,qHAAqH;AACrH,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4GAA4G;IAC5G,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,4GAA4G;IAC5G,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,CACA;IACE,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC;IACrF,kGAAkG;IAClG,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,SAAS,CAAC;CAC1C,GACD,CAAC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAAC,GAC7C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,0FAA0F;IAC1F,IAAI,EAAE,aAAa,CAAC;IACpB,oEAAoE;IACpE,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChD,CACJ,CAAC;AAqEF;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAoDhE"}

package/dist/components/identity-mark.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AgentOrb, } from "./agent-orb.js";
+import { AppMark } from "./app-mark.js";
+import { Avatar, AvatarFallback, AvatarImage } from "./avatar.js";
+import { cn } from "../lib/utils.js";
+const MEASURES = {
+    20: { orb: 20, icon: 12, initials: 8 },
+    24: { orb: 24, icon: 14, initials: 9 },
+    28: { orb: 24, icon: 16, initials: 10 },
+    32: { orb: 32, icon: 16, initials: 11 },
+    40: { orb: 40, icon: 20, initials: 13 },
+    64: { orb: 64, icon: 24, initials: 20 },
+};
+const TONES = {
+    neutral: "bg-card text-muted-foreground ring-1 ring-border ring-inset",
+    skill: "bg-category-purple text-category-purple-foreground",
+    plugin: "bg-info-soft text-info-soft-foreground",
+    teal: "bg-category-teal text-category-teal-foreground",
+};
+function identityInitials(name) {
+    return name
+        .split(/\s+/)
+        .map((word) => word.match(/^[\p{L}\p{N}]/u)?.[0])
+        .filter((initial) => initial !== undefined)
+        .slice(0, 2)
+        .join("")
+        .toUpperCase();
+}
+function naming(label) {
+    return label
+        ? { role: "img", "aria-label": label }
+        : { "aria-hidden": true };
+}
+function Tile({ kind, label, size, tone, children, }) {
+    return (_jsx("span", { className: cn("inline-flex shrink-0 items-center justify-center", size >= 40 ? "rounded-md" : "rounded-sm", TONES[tone]), "data-kind": kind, "data-slot": "identity-mark", style: { width: size, height: size }, ...naming(label), children: children }));
+}
+/**
+ * What says which thing a record is, at a fixed size at the start of its row,
+ * its object's head or its feed line: an Agent's orb, an app's logo, a
+ * company's initials, a person's picture, or a record kind's icon on its tile.
+ *
+ * @family Status
+ * @when The first thing in a record's row (32), at the head of its object page (64), in a feed or a sidebar identity line (24), on a Library entry (40): wherever it tells a person which thing they are looking at.
+ * @instead An icon beside a card's title, a KPI's label or a section heading only repeats the words and is left out. A picture for a first use or a whole-page moment is the empty state's or the page's own. A model is its `ModelIdentity`.
+ * @behaviour Static, except an Agent's orb, which moves with her state. An Agent is always her orb from the orb engine, never an avatar or a painted circle, and `frame` lets the product wrap that orb, such as in the transition that carries her to her page; an app keeps its own logo on the white tile; a company is two initials on the ringed card tile; a person is their picture, then their initials; a record with no picture of its own takes its kind's navigation icon, on the purple ground for a skill and the blue one for a plugin.
+ * @words None of its own: the record's name stands beside it. Initials are the first letters of the name's first two words.
+ * @access Decorative beside the record's name. Alone, as in a narrow rail, `label` names it.
+ */
+export function IdentityMark(props) {
+    const size = props.size ?? 32;
+    const measures = MEASURES[size];
+    switch (props.kind) {
+        case "agent": {
+            const orb = props.label ? (_jsx(AgentOrb, { ...props.orb, label: props.label, size: measures.orb })) : (_jsx(AgentOrb, { ...props.orb, decorative: true, size: measures.orb }));
+            return props.frame ? props.frame(orb) : orb;
+        }
+        case "app":
+            return props.platform ? (_jsx(AppMark, { app: props.app, label: props.label, platform: props.platform, size: size })) : (_jsx(AppMark, { app: props.app, label: props.label, logo: props.logo, size: size }));
+        case "person":
+            return (_jsxs(Avatar, { "data-kind": "person", "data-slot": "identity-mark", style: { width: size, height: size }, ...naming(props.label), children: [props.image ? _jsx(AvatarImage, { alt: "", src: props.image }) : null, _jsx(AvatarFallback, { style: { fontSize: measures.initials }, children: identityInitials(props.name) })] }));
+        case "company":
+            return (_jsx(Tile, { kind: "company", label: props.label, size: size, tone: "neutral", children: _jsx("span", { "aria-hidden": "true", className: "leading-none font-semibold", style: { fontSize: measures.initials }, children: identityInitials(props.name) }) }));
+        case "record":
+            return (_jsx(Tile, { kind: "record", label: props.label, size: size, tone: props.tone ?? "neutral", children: _jsx(props.icon, { "aria-hidden": "true", size: measures.icon }) }));
+    }
+}

package/dist/components/input-group.d.ts

@@ -1,6 +1,22 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
 import { Button } from "./button.js";
+/**
+ * One input box with something fixed inside it: a mark, a prefix, a button.
+ *
+ * @family Inputs
+ * @when A single-line value with something fixed inside the box: a search mark, a clear button, a
+ * prefix like *https://*, a copy button.
+ * @instead A collection's search is `CollectionSearch`, never a hand-built group. A plain value is
+ * `Input`. Many known values to filter is `Combobox`.
+ * @behaviour The group draws the edge and the focus outline for the input inside it. The clear
+ * button empties the value and puts focus back in the box. Escape clears only while the box holds
+ * the interaction and has a value; otherwise it closes the overlay as usual.
+ * @words Prefix and suffix are literal text, never the label. An inline button names what it does:
+ * *Clear search*, *Copy address*.
+ * @access `role="group"` around the box. The input inside keeps its own label. Inline buttons are
+ * named: *Clear search*, *Copy address*.
+ */
 declare function InputGroup({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
 declare const inputGroupAddonVariants: (props?: ({
     align?: "inline-end" | "inline-start" | "block-end" | "block-start" | null | undefined;

package/dist/components/input-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-group.d.ts","sourceRoot":"","sources":["../../src/components/input-group.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI7C,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAYvE;AAED,QAAA,MAAM,uBAAuB;;8EAiB5B,CAAC;AAEF,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,KAAsB,EACtB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,uBAAuB,CAAC,qBAiB5E;AAED,QAAA,MAAM,wBAAwB;;8EAY5B,CAAC;AAEH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,IAAe,EACf,OAAiB,EACjB,IAAW,EACX,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3D,YAAY,CAAC,OAAO,wBAAwB,CAAC,GAAG;IAC9C,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;CACtC,qBAUF;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAU5E;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAW9E;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,qBAWpF;AAED,OAAO,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,CAAC"}
+{"version":3,"file":"input-group.d.ts","sourceRoot":"","sources":["../../src/components/input-group.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI7C;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAYvE;AAED,QAAA,MAAM,uBAAuB;;8EAiB5B,CAAC;AAEF,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,KAAsB,EACtB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,uBAAuB,CAAC,qBAkB5E;AAED,QAAA,MAAM,wBAAwB;;8EAY5B,CAAC;AAEH,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,IAAe,EACf,OAAiB,EACjB,IAAW,EACX,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,GAC3D,YAAY,CAAC,OAAO,wBAAwB,CAAC,GAAG;IAC9C,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;CACtC,qBAUF;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAU5E;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAW9E;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,qBAWpF;AAED,OAAO,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,CAAC"}

package/dist/components/input-group.js

@@ -5,6 +5,22 @@ import { cn } from "../lib/utils.js";
 import { Button } from "./button.js";
 import { Input } from "./input.js";
 import { Textarea } from "./textarea.js";
+/**
+ * One input box with something fixed inside it: a mark, a prefix, a button.
+ *
+ * @family Inputs
+ * @when A single-line value with something fixed inside the box: a search mark, a clear button, a
+ * prefix like *https://*, a copy button.
+ * @instead A collection's search is `CollectionSearch`, never a hand-built group. A plain value is
+ * `Input`. Many known values to filter is `Combobox`.
+ * @behaviour The group draws the edge and the focus outline for the input inside it. The clear
+ * button empties the value and puts focus back in the box. Escape clears only while the box holds
+ * the interaction and has a value; otherwise it closes the overlay as usual.
+ * @words Prefix and suffix are literal text, never the label. An inline button names what it does:
+ * *Clear search*, *Copy address*.
+ * @access `role="group"` around the box. The input inside keeps its own label. Inline buttons are
+ * named: *Clear search*, *Copy address*.
+ */
 function InputGroup({ className, ...props }) {
     return (_jsx("div", { "data-slot": "input-group", role: "group", className: cn("group/input-group relative flex h-control-height min-h-touch-target w-full min-w-0 items-center rounded-sm border border-input bg-background transition-colors outline-none in-data-[slot=combobox-content]:focus-within:border-inherit has-disabled:bg-input/50 has-disabled:opacity-50 not-in-data-[slot=combobox-content]:has-[[data-slot=input-group-control]:focus-visible]:nc-focus-outline has-[[data-slot=input-group-control]:focus-visible]:outline-ring has-[[data-slot][aria-invalid=true]]:border-destructive has-[[data-slot][aria-invalid=true]]:nc-focus-outline has-[[data-slot][aria-invalid=true]]:outline-destructive has-[>[data-align=block-end]]:h-auto has-[>[data-align=block-end]]:flex-col has-[>[data-align=block-start]]:h-auto has-[>[data-align=block-start]]:flex-col has-[>textarea]:h-auto has-[>[data-align=block-end]]:[&>input]:pt-3 has-[>[data-align=block-start]]:[&>input]:pb-3 has-[>[data-align=inline-end]]:[&>input]:pr-1.5 has-[>[data-align=inline-start]]:[&>input]:pl-1.5 [@media(hover:hover)_and_(pointer:fine)]:min-h-0", className), ...props }));
 }
@@ -23,6 +39,7 @@ const inputGroupAddonVariants = cva("flex h-auto cursor-text items-center justif
 });
 function InputGroupAddon({ className, align = "inline-start", ...props }) {
     return (_jsx("div", { role: "group", "data-slot": "input-group-addon", "data-align": align, className: cn(inputGroupAddonVariants({ align }), className), onClick: (e) => {
+            // SAFETY: a click reaches this handler only from the addon or a node inside it, and React reports a text node's parent element as the target (react-dom's getEventTarget), so the target is an Element in whichever document the addon renders.
             if (e.target.closest("button")) {
                 return;
             }

package/dist/components/input-otp.d.ts

@@ -1,5 +1,20 @@
 import * as React from "react";
 import { OTPInput } from "input-otp";
+/**
+ * A fixed-length code typed into one slot per character.
+ *
+ * @family Inputs
+ * @when A fixed-length code a person types: the two-factor code at the Portal's sign-in.
+ * @instead A code a person only compares between two screens is `PairingCode`. A long token is
+ * `Input` with a copy or paste action.
+ * @behaviour One real input behind the slots: paste fills them all, Backspace walks back. The
+ * active slot carries the focus outline and a still caret. A wrong code turns the group red and
+ * keeps the digits so the person can correct them. Resend follows the product's real policy.
+ * @words The label says where the code comes from. The error says what to do: *That code didn't
+ * match. Check the newest code in your app.*
+ * @access One labelled input with `autocomplete="one-time-code"` and `inputMode="numeric"`. The
+ * separator is decorative to the reader.
+ */
 declare function InputOTP({ className, containerClassName, ...props }: React.ComponentProps<typeof OTPInput> & {
     containerClassName?: string;
 }): React.JSX.Element;

package/dist/components/input-otp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-otp.d.ts","sourceRoot":"","sources":["../../src/components/input-otp.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAmB,MAAM,WAAW,CAAC;AAKtD,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,kBAAkB,EAClB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,QAAQ,CAAC,GAAG;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,qBAoBA;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW1E;AAED,iBAAS,YAAY,CAAC,EACpB,KAAK,EACL,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,qBAsBA;AAED,iBAAS,iBAAiB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWnE;AAED,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"input-otp.d.ts","sourceRoot":"","sources":["../../src/components/input-otp.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAmB,MAAM,WAAW,CAAC;AAKtD;;;;;;;;;;;;;;GAcG;AACH,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,kBAAkB,EAClB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,QAAQ,CAAC,GAAG;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,qBAoBA;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW1E;AAED,iBAAS,YAAY,CAAC,EACpB,KAAK,EACL,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,qBAsBA;AAED,iBAAS,iBAAiB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWnE;AAED,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/components/input-otp.js

@@ -4,6 +4,21 @@ import * as React from "react";
 import { OTPInput, OTPInputContext } from "input-otp";
 import { cn } from "../lib/utils.js";
 import { MinusIcon } from "lucide-react";
+/**
+ * A fixed-length code typed into one slot per character.
+ *
+ * @family Inputs
+ * @when A fixed-length code a person types: the two-factor code at the Portal's sign-in.
+ * @instead A code a person only compares between two screens is `PairingCode`. A long token is
+ * `Input` with a copy or paste action.
+ * @behaviour One real input behind the slots: paste fills them all, Backspace walks back. The
+ * active slot carries the focus outline and a still caret. A wrong code turns the group red and
+ * keeps the digits so the person can correct them. Resend follows the product's real policy.
+ * @words The label says where the code comes from. The error says what to do: *That code didn't
+ * match. Check the newest code in your app.*
+ * @access One labelled input with `autocomplete="one-time-code"` and `inputMode="numeric"`. The
+ * separator is decorative to the reader.
+ */
 function InputOTP({ className, containerClassName, ...props }) {
     return (_jsx(OTPInput, { "data-slot": "input-otp", containerClassName: cn("cn-input-otp flex items-center has-disabled:opacity-50", containerClassName), spellCheck: false, 
         // The hidden native input spans the whole container; the active slot is

package/dist/components/input.d.ts

@@ -1,4 +1,19 @@
 import * as React from "react";
+/**
+ * One line of free text, edged in the input grey.
+ *
+ * @family Inputs
+ * @when One free-form value on one line: a name, an address, a number.
+ * @instead Text with a fixed prefix, an icon or a button inside is `InputGroup`. Several lines are
+ * `Textarea`. A known set of values is a select, radios or a combobox.
+ * @behaviour 36 px, edged in the `input` role's grey with no shadow, 6 px corners. Focus is the 2 px outline. Invalid keeps a red edge and a red outline even without
+ * focus. Disabled is 50% on a half-grey fill. The value survives a failed save.
+ * @words The label is a noun in sentence case with no colon. The placeholder is an example (*Bizeta
+ * Arredamenti*), never the label or an instruction. In a configuration section the box stops at 20
+ * rem under its label.
+ * @access A visible `label` tied by `id`, the help and the error joined through `aria-describedby`,
+ * `aria-invalid` when wrong. Use the right `type`, `autocomplete` and `inputMode`.
+ */
 declare function Input({ className, type, ...props }: React.ComponentProps<"input">): React.JSX.Element;
 export { Input };
 //# sourceMappingURL=input.d.ts.map

package/dist/components/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/components/input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,iBAAS,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAY1E;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/components/input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B;;;;;;;;;;;;;;GAcG;AACH,iBAAS,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAY1E;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/components/input.js

@@ -1,6 +1,21 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Input as InputPrimitive } from "@base-ui/react/input";
 import { cn } from "../lib/utils.js";
+/**
+ * One line of free text, edged in the input grey.
+ *
+ * @family Inputs
+ * @when One free-form value on one line: a name, an address, a number.
+ * @instead Text with a fixed prefix, an icon or a button inside is `InputGroup`. Several lines are
+ * `Textarea`. A known set of values is a select, radios or a combobox.
+ * @behaviour 36 px, edged in the `input` role's grey with no shadow, 6 px corners. Focus is the 2 px outline. Invalid keeps a red edge and a red outline even without
+ * focus. Disabled is 50% on a half-grey fill. The value survives a failed save.
+ * @words The label is a noun in sentence case with no colon. The placeholder is an example (*Bizeta
+ * Arredamenti*), never the label or an instruction. In a configuration section the box stops at 20
+ * rem under its label.
+ * @access A visible `label` tied by `id`, the help and the error joined through `aria-describedby`,
+ * `aria-invalid` when wrong. Use the right `type`, `autocomplete` and `inputMode`.
+ */
 function Input({ className, type, ...props }) {
     return (_jsx(InputPrimitive, { type: type, "data-slot": "input", className: cn("h-control-height min-h-touch-target w-full min-w-0 rounded-sm border border-input bg-background px-control-padding-inline py-1 text-base transition-colors file:inline-flex file:h-6 file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-placeholder disabled:pointer-events-none disabled:cursor-not-allowed disabled:bg-input/50 disabled:opacity-50 aria-invalid:border-destructive [@media(hover:hover)_and_(pointer:fine)]:min-h-0 md:text-sm", className), ...props }));
 }