@nadicodeai/ui 12.1.96 → 12.1.97

package/dist/components/entry-scene.js

@@ -1,5 +1,17 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "../lib/utils.js";
+/**
+ * Nadia's entry screen, contained: the approved picture of the surface behind,
+ * the wordmark at the upper left, Nadia's ribbon and her words centred as one
+ * group. The screen is black in every theme.
+ *
+ * @family Compositions
+ * @when Nadia's installer and the desktop's sign-in, start, update and failure screens, which paint the same screen; a page that shows that screen beside other things.
+ * @instead The Portal's entry pages are its funnel frame with the shared entry header; Alveare Server's entry is the HiveScene; a wait inside the product is a WaitingLine.
+ * @behaviour It holds no state and decides nothing: which view is open, the words and when the screen ends belong to whoever mounts it. It fills a box of the window's own shape (`aspectRatio`), so the picture's figure stands on the window's floor (`pictureFeet`). A failure quiets the picture and never removes it. Its children stand in order: the message, the actions, the progress line, the stage list.
+ * @words The heading names the surface and is never seen. Instructions and status are one plain sentence that changes only when the real stage changes ("Loading your tools").
+ * @access One level-1 heading for the screen, read but not shown; a message that reports work in progress is a status.
+ */
 export function EntryScene({ aspectRatio = "1220 / 800", minHeight, picture, pictureFeet = 906, wordmark, title, presence, view, className, children, }) {
     return (_jsx("div", { "data-slot": "entry-scene", className: cn("nc-entry-scene", className), 
         // SAFETY: CSSProperties lists only standard properties; React sets each `--` custom property key here through style.setProperty.
@@ -31,15 +43,30 @@ export function EntryAction({ variant = "primary", pressed, className, children,
     return (_jsx("button", { type: "button", "data-variant": variant, "data-pressed": pressed ? "" : undefined, className: cn("nc-entry-action", className), ...props, children: children }));
 }
 /**
- * Measured work: a 2 px line with the count written under it. It is
- * decorative, because Nadia's own hidden progress bar already carries the
- * value and her ribbon above already says the work is hers.
+ * Measured work on an entry screen: a 2 px line with the product's written
+ * count under it.
+ *
+ * @family Feedback
+ * @when Work on an entry screen whose progress is measured: downloading an update, the stages of starting Nadia.
+ * @instead Work whose length is unknown is a WaitingLine; the named stages themselves are the EntryStageList; measured work inside the product is a Progress with its count.
+ * @behaviour The line keeps the measured fraction, clamped between empty and full; the count under it is the product's own words. It never prints a percentage.
+ * @words The count says what is measured, in tabular figures: "Step 2 of 3", "12 of 40 MB". Never an invented percentage.
+ * @access The count is a status, so assistive technology hears it change; the line is hidden.
  */
-export function EntryProgress({ fraction, className }) {
-    const percent = Math.min(100, Math.max(0, Math.round(fraction * 100)));
-    return (_jsxs("div", { "aria-hidden": "true", className: cn("nc-entry-progress", className), children: [_jsx("div", { className: "nc-entry-progress-track", children: _jsx("div", { className: "nc-entry-progress-value", style: { width: `${percent}%` } }) }), _jsxs("span", { className: "nc-entry-progress-count", children: [percent, "%"] })] }));
+export function EntryProgress({ fraction, count, className, }) {
+    const width = Math.min(1, Math.max(0, fraction));
+    return (_jsxs("div", { className: cn("nc-entry-progress", className), children: [_jsx("div", { "aria-hidden": "true", className: "nc-entry-progress-track", children: _jsx("div", { className: "nc-entry-progress-value", style: { width: `${width * 100}%` } }) }), _jsx("span", { className: "nc-entry-progress-count", role: "status", children: count })] }));
 }
-/** The stages of a long install, each done, current or still to come. */
+/**
+ * The stages a system runs on an entry screen, each done, current or still to come.
+ *
+ * @family Feedback
+ * @when The real stages of a long setup on an entry screen: installing Nadia, Alveare Server's "Get this computer ready".
+ * @instead Steps the person does are NumberedSteps; the steps of an Agent's run are a RunTimeline.
+ * @behaviour One mark per stage: done, current, still to come. Followed by the EntryProgress count. Nothing moves but the stage that changes.
+ * @words Each stage is what the system does, in the imperative: "Start the chat service".
+ * @access An ordered list; the current stage carries `aria-current="step"`; the marks are hidden.
+ */
 export function EntryStageList({ stages, className, }) {
     return (_jsx("ol", { className: cn("nc-entry-stages", className), children: stages.map((stage) => (_jsxs("li", { "aria-current": stage.mark === "current" ? "step" : undefined, "data-mark": stage.mark, children: [_jsx("span", { "aria-hidden": "true", className: "nc-entry-mark" }), stage.label] }, stage.id))) }));
 }

package/dist/components/expandable-block.d.ts

@@ -5,6 +5,16 @@ interface ExpandableBlockProps {
     collapseLabel?: string;
     expandLabel?: string;
 }
+/**
+ * A tall block cut to its first lines, with a control to read the rest.
+ *
+ * @family Other
+ * @when A long output inside a conversation or a run: a tool's result, a pasted log.
+ * @instead Supporting detail behind a label is `Disclosure`. Exact text to copy is `CodeBlock`.
+ * @behaviour Shows the control only when the content runs past 120 px; expanding shows it whole.
+ * @words The expand and collapse labels come from the product's catalogue.
+ * @access The control is a `button` with `aria-expanded` and the current label as its name.
+ */
 declare function ExpandableBlock({ children, className, collapseLabel, expandLabel, }: ExpandableBlockProps): import("react").JSX.Element;
 export { ExpandableBlock };
 //# sourceMappingURL=expandable-block.d.ts.map

package/dist/components/expandable-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expandable-block.d.ts","sourceRoot":"","sources":["../../src/components/expandable-block.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAK1E,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,iBAAS,eAAe,CAAC,EACvB,QAAQ,EACR,SAAS,EACT,aAA0B,EAC1B,WAAsB,GACvB,EAAE,oBAAoB,+BAsCtB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"expandable-block.d.ts","sourceRoot":"","sources":["../../src/components/expandable-block.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAK1E,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,iBAAS,eAAe,CAAC,EACvB,QAAQ,EACR,SAAS,EACT,aAA0B,EAC1B,WAAsB,GACvB,EAAE,oBAAoB,+BAsCtB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/components/expandable-block.js

@@ -3,6 +3,16 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useLayoutEffect, useRef, useState } from "react";
 import { ChevronDownIcon } from "lucide-react";
 import { cn } from "../lib/utils.js";
+/**
+ * A tall block cut to its first lines, with a control to read the rest.
+ *
+ * @family Other
+ * @when A long output inside a conversation or a run: a tool's result, a pasted log.
+ * @instead Supporting detail behind a label is `Disclosure`. Exact text to copy is `CodeBlock`.
+ * @behaviour Shows the control only when the content runs past 120 px; expanding shows it whole.
+ * @words The expand and collapse labels come from the product's catalogue.
+ * @access The control is a `button` with `aria-expanded` and the current label as its name.
+ */
 function ExpandableBlock({ children, className, collapseLabel = "Collapse", expandLabel = "Expand", }) {
     const innerRef = useRef(null);
     const [expanded, setExpanded] = useState(false);

package/dist/components/field.d.ts

@@ -8,6 +8,23 @@ declare function FieldGroup({ className, ...props }: React.ComponentProps<"div">
 declare const fieldVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * A control with its label, its help and its error, tied together.
+ *
+ * @family Inputs
+ * @when Every control with a name: it ties the label, the help and the error to the control. Inside
+ * a settings section `SettingsField` does it and hands the control its `controlProps`. A rich
+ * choice tile is a `FieldLabel` holding a `Field` with its radio or checkbox.
+ * @instead A group of radios or checkboxes is a `FieldSet` with a `FieldLegend`. A whole save group
+ * is `SettingsSection`.
+ * @behaviour Label, then help, then the error, then the control, 8 px apart. Invalid turns the
+ * label and message red and puts the red edge and outline on the control. Validate on submit or on
+ * leaving a field, then update the message as the value is corrected.
+ * @words The help says what the setting changes, in one sentence. The error says how to fix it, not
+ * what went wrong: *Enter a full address, like name@company.it.* A disabled field says why.
+ * @access `FieldError` is `role="alert"`. The control carries `id`, `aria-invalid`,
+ * `aria-describedby` (help, then error), `disabled` and `required`.
+ */
 declare function Field({ className, orientation, ...props }: React.ComponentProps<"div"> & VariantProps<typeof fieldVariants>): import("react").JSX.Element;
 declare function FieldContent({ className, ...props }: React.ComponentProps<"div">): import("react").JSX.Element;
 declare function FieldLabel({ className, ...props }: React.ComponentProps<typeof Label>): import("react").JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/components/field.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,+BAW1E;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,OAAkB,EAClB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,+BAYnE;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,+BAWvE;AAED,QAAA,MAAM,aAAa;;8EAajB,CAAC;AAEH,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,WAAwB,EACxB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,+BAUlE;AAKD,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,+BAWzE;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,KAAK,CAAC,+BAY9E;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,+BAWvE;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,+BAa3E;AAED,iBAAS,cAAc,CAAC,EACtB,QAAQ,EACR,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC/B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,+BAsBA;AAED,iBAAS,UAAU,CAAC,EAClB,SAAS,EACT,QAAQ,EACR,MAAM,EACN,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC/B,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;CAClD,sCAwCA;AAED,OAAO,EACL,KAAK,EACL,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,UAAU,GACX,CAAC"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/components/field.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,+BAW1E;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,OAAkB,EAClB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,+BAYnE;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,+BAWvE;AAED,QAAA,MAAM,aAAa;;8EAajB,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,WAAwB,EACxB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,+BAUlE;AAKD,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,+BAWzE;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,KAAK,CAAC,+BAY9E;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,+BAWvE;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,+BAa3E;AAED,iBAAS,cAAc,CAAC,EACtB,QAAQ,EACR,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC/B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,+BAsBA;AAED,iBAAS,UAAU,CAAC,EAClB,SAAS,EACT,QAAQ,EACR,MAAM,EACN,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC/B,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;CAClD,sCAwCA;AAED,OAAO,EACL,KAAK,EACL,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,UAAU,GACX,CAAC"}

package/dist/components/field.js

@@ -26,6 +26,23 @@ const fieldVariants = cva("group/field flex w-full gap-2 data-[invalid=true]:tex
         orientation: "vertical",
     },
 });
+/**
+ * A control with its label, its help and its error, tied together.
+ *
+ * @family Inputs
+ * @when Every control with a name: it ties the label, the help and the error to the control. Inside
+ * a settings section `SettingsField` does it and hands the control its `controlProps`. A rich
+ * choice tile is a `FieldLabel` holding a `Field` with its radio or checkbox.
+ * @instead A group of radios or checkboxes is a `FieldSet` with a `FieldLegend`. A whole save group
+ * is `SettingsSection`.
+ * @behaviour Label, then help, then the error, then the control, 8 px apart. Invalid turns the
+ * label and message red and puts the red edge and outline on the control. Validate on submit or on
+ * leaving a field, then update the message as the value is corrected.
+ * @words The help says what the setting changes, in one sentence. The error says how to fix it, not
+ * what went wrong: *Enter a full address, like name@company.it.* A disabled field says why.
+ * @access `FieldError` is `role="alert"`. The control carries `id`, `aria-invalid`,
+ * `aria-describedby` (help, then error), `disabled` and `required`.
+ */
 function Field({ className, orientation = "vertical", ...props }) {
     return (_jsx("div", { role: "group", "data-slot": "field", "data-orientation": orientation, className: cn(fieldVariants({ orientation }), className), ...props }));
 }

package/dist/components/file-diff.d.ts

@@ -7,6 +7,18 @@ interface FileDiffProps extends Omit<React.ComponentProps<"div">, "children"> {
     removedLabel?: string;
     skippedLabel?: (count: number) => string;
 }
+/**
+ * A file's before and after, line by line.
+ *
+ * @family Data
+ * @when Showing what changed in a file an Agent edited, or in a configuration before it is saved.
+ * @instead A file as it stands is `CodeBlock`. A count of changed lines is `DiffCount`.
+ * @behaviour Added lines on the success fill with a plus, removed on the destructive fill with a
+ * true minus; unchanged lines beyond `context` fold into one marker.
+ * @words The added and removed labels and the folded-lines count come from the product's catalogue.
+ * @access Each changed line carries its added or removed label in screen-reader text; the plus and
+ * minus marks are hidden.
+ */
 declare function FileDiff({ addedLabel, after, before, className, context, removedLabel, skippedLabel, ...props }: FileDiffProps): import("react").JSX.Element;
 export { FileDiff };
 //# sourceMappingURL=file-diff.d.ts.map

package/dist/components/file-diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-diff.d.ts","sourceRoot":"","sources":["../../src/components/file-diff.tsx"],"names":[],"mappings":"AAKA,UAAU,aAAc,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C;AAcD,iBAAS,QAAQ,CAAC,EAChB,UAAoB,EACpB,KAAK,EACL,MAAM,EACN,SAAS,EACT,OAAW,EACX,YAAwB,EACxB,YAAoD,EACpD,GAAG,KAAK,EACT,EAAE,aAAa,+BAkCf;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"file-diff.d.ts","sourceRoot":"","sources":["../../src/components/file-diff.tsx"],"names":[],"mappings":"AAKA,UAAU,aAAc,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C;AAcD;;;;;;;;;;;GAWG;AACH,iBAAS,QAAQ,CAAC,EAChB,UAAoB,EACpB,KAAK,EACL,MAAM,EACN,SAAS,EACT,OAAW,EACX,YAAwB,EACxB,YAAoD,EACpD,GAAG,KAAK,EACT,EAAE,aAAa,+BAkCf;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/components/file-diff.js

@@ -12,6 +12,18 @@ const MARK = {
     context: "",
     removed: "−",
 };
+/**
+ * A file's before and after, line by line.
+ *
+ * @family Data
+ * @when Showing what changed in a file an Agent edited, or in a configuration before it is saved.
+ * @instead A file as it stands is `CodeBlock`. A count of changed lines is `DiffCount`.
+ * @behaviour Added lines on the success fill with a plus, removed on the destructive fill with a
+ * true minus; unchanged lines beyond `context` fold into one marker.
+ * @words The added and removed labels and the folded-lines count come from the product's catalogue.
+ * @access Each changed line carries its added or removed label in screen-reader text; the plus and
+ * minus marks are hidden.
+ */
 function FileDiff({ addedLabel = "Added", after, before, className, context = 3, removedLabel = "Removed", skippedLabel = (count) => `${count} unchanged lines`, ...props }) {
     const diff = useMemo(() => lineDiff(before, after, context), [after, before, context]);
     return (_jsx("div", { className: cn("overflow-hidden rounded-sm border border-border bg-recessed font-code text-code", className), "data-slot": "file-diff", ...props, children: diff.lines.map((line, index) => line.kind === "skipped" ? (_jsx("div", { className: "px-2.5 py-0.5 text-muted-foreground select-none", children: `… ${skippedLabel(line.count)}` }, index)) : (_jsxs("div", { className: cn("grid grid-cols-[1.25rem_minmax(0,1fr)] pr-2.5", ROW[line.kind]), "data-kind": line.kind, children: [_jsx("span", { "aria-hidden": "true", className: "text-center select-none", children: MARK[line.kind] }), line.kind !== "context" ? (_jsx("span", { className: "sr-only", children: line.kind === "added" ? addedLabel : removedLabel })) : null, _jsx("span", { className: "break-words whitespace-pre-wrap", children: line.text || " " })] }, index))) }));

package/dist/components/file-type-icon.d.ts

@@ -3,6 +3,18 @@ export interface FileTypeIconProps extends Omit<React.ComponentProps<"svg">, "ch
     language?: string;
     path?: string;
 }
+/**
+ * A file's kind as a Lucide icon, from its path or its language.
+ *
+ * @family Status
+ * @when Beside a file's name: a file an Agent wrote, a code block's language, an attachment.
+ * @instead An app is `AppMark`; a Library entry is its `IdentityMark`. A file's content is
+ * `CodeBlock` or `FileDiff`.
+ * @behaviour Maps a path's extension or a language name to one icon: terminal, document, braces,
+ * settings, database, diff, palette, regex, globe, package, share; anything else is the code icon.
+ * @words None; the file's name stands beside it.
+ * @access Always `aria-hidden`.
+ */
 declare function FileTypeIcon({ className, language, path, ...props }: FileTypeIconProps): React.JSX.Element;
 export { FileTypeIcon };
 //# sourceMappingURL=file-type-icon.d.ts.map

package/dist/components/file-type-icon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-type-icon.d.ts","sourceRoot":"","sources":["../../src/components/file-type-icon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AA6GpC,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,qBAW/E;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"file-type-icon.d.ts","sourceRoot":"","sources":["../../src/components/file-type-icon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AA6GpC,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,qBAW/E;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/components/file-type-icon.js

@@ -85,6 +85,18 @@ function languageForPath(path) {
     const token = dot > 0 ? base.slice(dot + 1) : base;
     return LANGUAGE_BY_EXTENSION.get(token) ?? token;
 }
+/**
+ * A file's kind as a Lucide icon, from its path or its language.
+ *
+ * @family Status
+ * @when Beside a file's name: a file an Agent wrote, a code block's language, an attachment.
+ * @instead An app is `AppMark`; a Library entry is its `IdentityMark`. A file's content is
+ * `CodeBlock` or `FileDiff`.
+ * @behaviour Maps a path's extension or a language name to one icon: terminal, document, braces,
+ * settings, database, diff, palette, regex, globe, package, share; anything else is the code icon.
+ * @words None; the file's name stands beside it.
+ * @access Always `aria-hidden`.
+ */
 function FileTypeIcon({ className, language, path, ...props }) {
     const key = normalizeLanguage(path ? languageForPath(path) : language);
     const Icon = isIconLanguage(key) ? ICON_BY_LANGUAGE[key] : CodeIcon;

package/dist/components/footer.d.ts

@@ -22,6 +22,20 @@ import * as React from "react";
  * brings the gutters. The default keeps the Portal's own measure.
  */
 type FooterWidth = "content" | "page";
+/**
+ * The always-dark site footer: the brand line, link columns and a meta row.
+ *
+ * @family Navigation
+ * @when The foot of every website page and the Portal's public pages.
+ * @instead A dialog's or a card's footer is its recessed strip. A product's account is
+ * `AccountMenu`.
+ * @behaviour Always dark, in either theme: it scopes `dark` itself. `mega` adds link columns and
+ * one hairline above the meta row; `width="page"` puts it on the website's one column. The clock is
+ * a pre-formatted string, not a live timer.
+ * @words Link columns are nouns; the identity paragraph names the company as the glossary defines
+ * it.
+ * @access A `footer` landmark; each link group is a labelled `nav`.
+ */
 declare function Footer({ className, variant, width, ...props }: React.ComponentProps<"footer"> & {
     variant?: "flat" | "mega";
     width?: FooterWidth;

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

@@ -1 +1 @@
-{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../../src/components/footer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;;;;;;;;GAeG;AAEH;;;;;GAKG;AACH,KAAK,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtC,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAgB,EAChB,KAAiB,EACjB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,qBAcrF;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,OAAgB,EAChB,KAAiB,EACjB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,qBAalF;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAWtE;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAQzE;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWtE;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAQrE;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAQzE;AAID,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW1E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW3E;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW1E;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAW7E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAY3E;AAED,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,cAAc,EACd,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,CAAC"}
+{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../../src/components/footer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;;;;;;;;GAeG;AAEH;;;;;GAKG;AACH,KAAK,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAgB,EAChB,KAAiB,EACjB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,qBAcrF;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,OAAgB,EAChB,KAAiB,EACjB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,qBAalF;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAWtE;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAQzE;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWtE;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAQrE;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAQzE;AAID,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW1E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW3E;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW1E;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAW7E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAY3E;AAED,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,cAAc,EACd,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,CAAC"}

package/dist/components/footer.js

@@ -1,5 +1,19 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { cn } from "../lib/utils.js";
+/**
+ * The always-dark site footer: the brand line, link columns and a meta row.
+ *
+ * @family Navigation
+ * @when The foot of every website page and the Portal's public pages.
+ * @instead A dialog's or a card's footer is its recessed strip. A product's account is
+ * `AccountMenu`.
+ * @behaviour Always dark, in either theme: it scopes `dark` itself. `mega` adds link columns and
+ * one hairline above the meta row; `width="page"` puts it on the website's one column. The clock is
+ * a pre-formatted string, not a live timer.
+ * @words Link columns are nouns; the identity paragraph names the company as the glossary defines
+ * it.
+ * @access A `footer` landmark; each link group is a labelled `nav`.
+ */
 function Footer({ className, variant = "flat", width = "content", ...props }) {
     return (_jsx("footer", { "data-slot": "footer", "data-variant": variant, "data-width": width, className: cn("dark relative isolate overflow-hidden border-t border-border bg-card py-12 text-foreground [&_a]:no-underline", width === "content" && "px-6", className), ...props }));
 }

package/dist/components/form-dialog.d.ts

@@ -4,6 +4,16 @@ export type FormDialogProps = FormSurfaceProps & {
     /** Its form's save is running: the dialog stays open until it settles. */
     pending?: boolean;
 };
+/**
+ * A new record, or one or two values from a command, in a centred dialog.
+ *
+ * @family Compositions
+ * @when A person adds a record through a few fields, or changes one or two values a command asks for: new customer, add a mailbox, add an MCP server.
+ * @instead A record already in a list edits in its row with `RowEditForm`; a choice from a catalogue is a `CatalogDrawer`; a setup in steps with a wait is a `FormDrawer` with `job="steps"`; a consequence is confirmed in a `ConfirmDialog`.
+ * @behaviour Centred over a scrim without blur: the title and its help, the fields in a body that scrolls, then the footer with Cancel and the primary at its trailing edge. A refusal or a failed save sits above the footer and the fields keep what was typed. While its save runs it holds open, Cancel and the primary hold, and the waiting line runs under them.
+ * @words The title names the job and its object: "New customer", "Add a mailbox". The primary repeats it: "Create customer", "Add mailbox", never "OK" or "Submit".
+ * @access A modal dialog named by its title; focus starts in its first field or `initialFocus`, Escape and Close close it unless the save runs, and focus returns to the opener or `finalFocus`.
+ */
 export declare function FormDialog({ open, onOpenChange, onOpenChangeComplete, title, description, closeLabel, children, initialFocus, finalFocus, pending, }: FormDialogProps): import("react").JSX.Element;
 export declare function FormDialogForm({ cancelLabel, submit, notice, children, ...form }: FormProps): import("react").JSX.Element;
 //# sourceMappingURL=form-dialog.d.ts.map

package/dist/components/form-dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-dialog.d.ts","sourceRoot":"","sources":["../../src/components/form-dialog.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG;IAC/C,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,WAAW,EACX,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,OAAe,GAChB,EAAE,eAAe,+BAuBjB;AAED,wBAAgB,cAAc,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,+BAsB3F"}
+{"version":3,"file":"form-dialog.d.ts","sourceRoot":"","sources":["../../src/components/form-dialog.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG;IAC/C,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,WAAW,EACX,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,OAAe,GAChB,EAAE,eAAe,+BAuBjB;AAED,wBAAgB,cAAc,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,+BAsB3F"}

package/dist/components/form-dialog.js

@@ -4,6 +4,16 @@ import { Button } from "./button.js";
 import { Dialog, DialogBody, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, } from "./dialog.js";
 import { WaitingLine } from "./waiting-line.js";
 import { FormSubmitButton } from "../internal/form-submit.js";
+/**
+ * A new record, or one or two values from a command, in a centred dialog.
+ *
+ * @family Compositions
+ * @when A person adds a record through a few fields, or changes one or two values a command asks for: new customer, add a mailbox, add an MCP server.
+ * @instead A record already in a list edits in its row with `RowEditForm`; a choice from a catalogue is a `CatalogDrawer`; a setup in steps with a wait is a `FormDrawer` with `job="steps"`; a consequence is confirmed in a `ConfirmDialog`.
+ * @behaviour Centred over a scrim without blur: the title and its help, the fields in a body that scrolls, then the footer with Cancel and the primary at its trailing edge. A refusal or a failed save sits above the footer and the fields keep what was typed. While its save runs it holds open, Cancel and the primary hold, and the waiting line runs under them.
+ * @words The title names the job and its object: "New customer", "Add a mailbox". The primary repeats it: "Create customer", "Add mailbox", never "OK" or "Submit".
+ * @access A modal dialog named by its title; focus starts in its first field or `initialFocus`, Escape and Close close it unless the save runs, and focus returns to the opener or `finalFocus`.
+ */
 export function FormDialog({ open, onOpenChange, onOpenChangeComplete, title, description, closeLabel, children, initialFocus, finalFocus, pending = false, }) {
     return (_jsx(Dialog, { open: open, onOpenChange: (next) => {
             if (next || !pending)

package/dist/components/form-drawer.d.ts

@@ -20,17 +20,30 @@ export type FormSurfaceProps = {
     /** Where focus returns when the drawer closes, when its opener is gone. */
     finalFocus?: ComponentProps<typeof SheetContent>["finalFocus"];
 };
-export type FormDrawerProps = FormSurfaceProps & {
-    /**
-     * Why this is a drawer and not a dialog: "catalog" chooses from a list too
-     * long for a dialog, "steps" sets something up over several steps, with a
-     * wait. A form of a few fields is a `FormDialog`, and a record already on
-     * screen edits inside its row.
-     */
-    job: "catalog" | "steps";
-};
-/** The right-side drawer for a catalog or a setup in steps, at one width. */
-export declare function FormDrawer({ open, onOpenChange, onOpenChangeComplete, title, description, closeLabel, children, initialFocus, finalFocus, }: FormDrawerProps): import("react").JSX.Element;
+/**
+ * Why this is a drawer and not a dialog: "catalog" chooses from a list too long
+ * for a dialog, and is reached through `CatalogDrawer`; "steps" sets something
+ * up over several steps, with a wait. A form of a few fields is a `FormDialog`,
+ * and a record already on screen edits inside its row.
+ */
+export type FormDrawerProps = FormSurfaceProps & ({
+    job: "catalog";
+} | {
+    job: "steps";
+    /** "Step 2 of 3", worded by the product, drawn over the title, which stays the job's name. */
+    progress: string;
+});
+/**
+ * The right-side drawer for a catalogue or a setup in steps, at one width.
+ *
+ * @family Compositions
+ * @when Choosing from a catalogue too long for a dialog (through `CatalogDrawer`), or setting something up in several steps with a wait: connect a messaging channel, Telegram's code.
+ * @instead A new record from a few fields is a `FormDialog`; a record already in a list edits in its row with `RowEditForm`; a fact on the record's own page changes in place in its section; a consequence is confirmed in a `ConfirmDialog`.
+ * @behaviour Opens from the right edge at one width, 560 px (the full width on a compact screen), with the page still behind it; 12 px corners on the edges not flush with the window. The header holds the step ("Step 2 of 3") over the title, the description and Close; the body scrolls between the header and a recessed footer that stays, Cancel then the primary at its trailing edge. Cancel holds while a save runs.
+ * @words The title names the job and its object: "Connect Telegram", "Add a skill". The step reads "Step N of M". The primary says what it does: "Connect", "Continue", never "OK".
+ * @access A modal dialog named by its title; focus moves inside on open and returns to the opener on close, or to `finalFocus` when the opener is gone. Escape and Close close it; the step is read before the title.
+ */
+export declare function FormDrawer(props: FormDrawerProps): import("react").JSX.Element;
 /** The part of the drawer that scrolls between its title and its footer. */
 export declare function FormDrawerBody({ className, ...props }: ComponentProps<"div">): import("react").JSX.Element;
 export type FormDrawerFooterProps = {

package/dist/components/form-drawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-drawer.d.ts","sourceRoot":"","sources":["../../src/components/form-drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvD,OAAO,EAGL,YAAY,EAKb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAG1E,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpE,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,qFAAqF;IACrF,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,6FAA6F;IAC7F,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,wGAAwG;IACxG,QAAQ,EAAE,SAAS,CAAC;IACpB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,cAAc,CAAC,CAAC;IACnE,2EAA2E;IAC3E,UAAU,CAAC,EAAE,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG;IAC/C;;;;;OAKG;IACH,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC;CAC1B,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,WAAW,EACX,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,GACX,EAAE,eAAe,+BAkBjB;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAW5E;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,+DAA+D;IAC/D,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+BAc3E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,+BAqB3F"}
+{"version":3,"file":"form-drawer.d.ts","sourceRoot":"","sources":["../../src/components/form-drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvD,OAAO,EAGL,YAAY,EAKb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAG1E,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpE,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,qFAAqF;IACrF,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,6FAA6F;IAC7F,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,wGAAwG;IACxG,QAAQ,EAAE,SAAS,CAAC;IACpB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,cAAc,CAAC,CAAC;IACnE,2EAA2E;IAC3E,UAAU,CAAC,EAAE,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC;CAChE,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAC5C,CACI;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,GAClB;IACE,GAAG,EAAE,OAAO,CAAC;IACb,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,CAAC;CAClB,CACJ,CAAC;AAEJ;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,+BAqChD;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAW5E;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,+DAA+D;IAC/D,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+BAc3E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,+BAqB3F"}

package/dist/components/form-drawer.js

@@ -5,9 +5,19 @@ import { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHe
 import { WaitingLine } from "./waiting-line.js";
 import { FormSubmitButton } from "../internal/form-submit.js";
 import { cn } from "../lib/utils.js";
-/** The right-side drawer for a catalog or a setup in steps, at one width. */
-export function FormDrawer({ open, onOpenChange, onOpenChangeComplete, title, description, closeLabel, children, initialFocus, finalFocus, }) {
-    return (_jsx(Sheet, { open: open, onOpenChange: onOpenChange, onOpenChangeComplete: onOpenChangeComplete, children: _jsxs(SheetContent, { className: "max-sm:data-[side=right]:left-nadicode-sm max-sm:data-[side=right]:w-auto data-[side=right]:sm:w-[560px] data-[side=right]:sm:max-w-[calc(100%-var(--nc-lg))]", closeLabel: closeLabel, finalFocus: finalFocus, initialFocus: initialFocus, side: "right", children: [_jsxs(SheetHeader, { className: "pr-12", children: [_jsx(SheetTitle, { className: "break-words", children: title }), description ? _jsx(SheetDescription, { children: description }) : null] }), children] }) }));
+/**
+ * The right-side drawer for a catalogue or a setup in steps, at one width.
+ *
+ * @family Compositions
+ * @when Choosing from a catalogue too long for a dialog (through `CatalogDrawer`), or setting something up in several steps with a wait: connect a messaging channel, Telegram's code.
+ * @instead A new record from a few fields is a `FormDialog`; a record already in a list edits in its row with `RowEditForm`; a fact on the record's own page changes in place in its section; a consequence is confirmed in a `ConfirmDialog`.
+ * @behaviour Opens from the right edge at one width, 560 px (the full width on a compact screen), with the page still behind it; 12 px corners on the edges not flush with the window. The header holds the step ("Step 2 of 3") over the title, the description and Close; the body scrolls between the header and a recessed footer that stays, Cancel then the primary at its trailing edge. Cancel holds while a save runs.
+ * @words The title names the job and its object: "Connect Telegram", "Add a skill". The step reads "Step N of M". The primary says what it does: "Connect", "Continue", never "OK".
+ * @access A modal dialog named by its title; focus moves inside on open and returns to the opener on close, or to `finalFocus` when the opener is gone. Escape and Close close it; the step is read before the title.
+ */
+export function FormDrawer(props) {
+    const { open, onOpenChange, onOpenChangeComplete, title, description, closeLabel, children, initialFocus, finalFocus, } = props;
+    return (_jsx(Sheet, { open: open, onOpenChange: onOpenChange, onOpenChangeComplete: onOpenChangeComplete, children: _jsxs(SheetContent, { className: "max-sm:data-[side=right]:left-nadicode-sm max-sm:data-[side=right]:w-auto data-[side=right]:sm:w-[560px] data-[side=right]:sm:max-w-[calc(100%-var(--nc-lg))]", closeLabel: closeLabel, finalFocus: finalFocus, initialFocus: initialFocus, side: "right", children: [_jsxs(SheetHeader, { className: "pr-12", children: [props.job === "steps" ? (_jsx("p", { className: "font-label-mono text-label-mono text-muted-foreground", "data-slot": "form-drawer-progress", children: props.progress })) : null, _jsx(SheetTitle, { className: "break-words", children: title }), description ? _jsx(SheetDescription, { children: description }) : null] }), children] }) }));
 }
 /** The part of the drawer that scrolls between its title and its footer. */
 export function FormDrawerBody({ className, ...props }) {

package/dist/components/form.d.ts

@@ -2,6 +2,23 @@ import * as React from "react";
 import { useRender } from "@base-ui/react/use-render";
 import { type ControllerProps, type FieldPath, type FieldValues } from "react-hook-form";
 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.
+ */
 declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getErrors, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, resetDefaultValues, handleSubmit, unregister, control, register, setFocus, subscribe, }: import("react-hook-form").FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
 declare const FormField: <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ ...props }: ControllerProps<TFieldValues, TName>) => React.JSX.Element;
 declare const useFormField: () => {

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

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/components/form.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,QAAA,MAAM,IAAI,yaAAe,CAAC;AAW1B,QAAA,MAAM,SAAS,GACb,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,KAAK,SAAS,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,YAAY,CAAC,EAC/D,cAEC,eAAe,CAAC,YAAY,EAAE,KAAK,CAAC,sBAMtC,CAAC;AAEF,QAAA,MAAM,YAAY;;;;;;;;;;;CAuBjB,CAAC;AAQF,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAQrE;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,KAAK,CAAC,qBAY7E;AAED,iBAAS,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,0EAoBzE;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAW1E;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,4BAkBtE;AAED,OAAO,EACL,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,WAAW,EACX,eAAe,EACf,WAAW,EACX,SAAS,GACV,CAAC"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/components/form.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,IAAI,yaAAe,CAAC;AAW1B,QAAA,MAAM,SAAS,GACb,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,KAAK,SAAS,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,YAAY,CAAC,EAC/D,cAEC,eAAe,CAAC,YAAY,EAAE,KAAK,CAAC,sBAMtC,CAAC;AAEF,QAAA,MAAM,YAAY;;;;;;;;;;;CAuBjB,CAAC;AAQF,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAQrE;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,KAAK,CAAC,qBAY7E;AAED,iBAAS,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,0EAoBzE;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAW1E;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,4BAkBtE;AAED,OAAO,EACL,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,WAAW,EACX,eAAe,EACf,WAAW,EACX,SAAS,GACV,CAAC"}

package/dist/components/form.js

@@ -6,6 +6,23 @@ 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(null);
 const FormField = ({ ...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/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);