@starci/grammar 0.15.3 → 0.15.6

package/dist/core/branch/FlowGraph/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/FlowGraph/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAC7F,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAClD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAChD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAC7D,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAA;AAE5C,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,oDAAoD;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,6HAA6H;IAC7H,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACjE,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACtB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/FlowGraph/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAC7F,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAClD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAChD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;AACpF,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAC7D,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAA;AAE5C,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,oDAAoD;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,6HAA6H;IAC7H,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACjE,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,iIAAiI;IACjI,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACtB,CAAA"}

package/dist/core/branch/MermaidDiagram/index.d.ts

@@ -0,0 +1,30 @@
+/** The canvas box every state reserves: `sm` 16rem, `md` 24rem, `lg` 32rem (the FlowGraph heights). */
+export type MermaidDiagramHeight = "sm" | "md" | "lg";
+export type MermaidDiagramProps = {
+    /** The Mermaid text, as written in the article's fence (without the fence itself). */
+    readonly source: string;
+    /** Names the diagram for assistive technology, e.g. "Request flow". The drawing is one image with this name. */
+    readonly label: string;
+    /**
+     * The least height of the canvas, kept by the loading, ready and error states alike so the page does not jump when
+     * the drawing arrives. A taller drawing grows the canvas; a wider one scrolls inline. Default `sm`.
+     */
+    readonly height?: MermaidDiagramHeight;
+    /** The error title shown in the region when the source cannot be drawn; the source follows it as code. */
+    readonly errorTitle?: string;
+    /** Accessible name of the source code block in the error state. Default: `${label} source`. */
+    readonly sourceLabel?: string;
+    /** Unresolved source (STATE-8): the frame at its height with a Skeleton block, Mermaid not loaded, `aria-busy`. */
+    readonly isSkeleton?: boolean;
+    /** Layout only. */
+    readonly className?: string;
+};
+/**
+ * A Mermaid diagram drawn client-side in the grammar's theme: Mermaid (`mermaid`) is imported lazily on the first
+ * diagram, initialised with colours resolved from the root's semantic tokens (surface, foreground, separator, accent),
+ * and its SVG is placed as one named image. Loading keeps the canvas box with a Skeleton; a source Mermaid refuses is
+ * an error inside the same region, the title then the source as code, so the reader still has the text.
+ * Contract: overflow OVERFLOW-4; loading and failure keep the anatomy STATE-8.
+ */
+export declare const MermaidDiagram: ({ source, label, height, errorTitle, sourceLabel, isSkeleton, className, }: MermaidDiagramProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/branch/MermaidDiagram/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/MermaidDiagram/index.tsx"],"names":[],"mappings":"AAQA,uGAAuG;AACvG,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAErD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,gHAAgH;IAChH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAA;IACtC,0GAA0G;IAC1G,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,mHAAmH;IACnH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,mBAAmB;IACnB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAgFD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,4EAQ5B,mBAAmB,gCAuDrB,CAAA"}

package/dist/core/branch/MermaidDiagram/index.js

@@ -0,0 +1,110 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useId, useRef, useState } from "react";
+import { Alert } from "../../composite/Alert/index.js";
+import { Skeleton } from "../../primitive/Skeleton/index.js";
+import { FencedCodeBlock } from "../MarkdownArticle/index.js";
+import { resolveMermaidTheme } from "./theme.js";
+let mermaidModule = null;
+/** Mermaid is loaded on the first diagram that needs it, once per page, and never on the server. */
+const loadMermaid = () => {
+    mermaidModule ??= import("mermaid").then((module) => module.default);
+    return mermaidModule;
+};
+let queue = Promise.resolve();
+/**
+ * Mermaid's configuration is one global, so each diagram initialises it with its own theme and renders before the next
+ * diagram may: the renders of one page run one after another.
+ */
+const renderSerially = (id, source, theme) => {
+    const run = queue.then(async () => {
+        const mermaid = await loadMermaid();
+        mermaid.initialize({
+            startOnLoad: false,
+            securityLevel: "strict",
+            // A refused source throws and leaves nothing in the document: the error state is the component's, in its region.
+            suppressErrorRendering: true,
+            theme: "base",
+            darkMode: theme.darkMode,
+            fontFamily: theme.fontFamily,
+            themeVariables: theme,
+            htmlLabels: false,
+            flowchart: { htmlLabels: false },
+        });
+        try {
+            const { svg } = await mermaid.render(id, source);
+            return svg;
+        }
+        finally {
+            // Mermaid draws in a temporary node of the body; a failed render can leave it behind.
+            document.getElementById(`d${id}`)?.remove();
+        }
+    });
+    queue = run.catch(() => undefined);
+    return run;
+};
+/** The SVG Mermaid returns, as a node of this document; null when the text is not one `<svg>` element. */
+const svgNode = (svg) => {
+    const parsed = new DOMParser().parseFromString(svg, "image/svg+xml");
+    const root = parsed.documentElement;
+    if (root.nodeName.toLowerCase() !== "svg" || parsed.getElementsByTagName("parsererror").length > 0)
+        return null;
+    const node = document.importNode(root, true);
+    node.setAttribute("aria-hidden", "true");
+    node.removeAttribute("height");
+    return node;
+};
+/** Re-renders when the root's theme changes: its attributes (theme, family, token overrides) or the system scheme. */
+const useThemeRevision = (anchor) => {
+    const [revision, setRevision] = useState(0);
+    useEffect(() => {
+        const root = anchor.current?.closest(".grammar-common-root") ?? null;
+        const bump = () => setRevision((value) => value + 1);
+        const scheme = window.matchMedia("(prefers-color-scheme: dark)");
+        scheme.addEventListener("change", bump);
+        const observer = root === null ? null : new MutationObserver(bump);
+        observer?.observe(root, { attributes: true, attributeFilter: ["data-grammar-theme", "data-grammar-family", "style", "class"] });
+        return () => {
+            scheme.removeEventListener("change", bump);
+            observer?.disconnect();
+        };
+    }, [anchor]);
+    return revision;
+};
+/**
+ * A Mermaid diagram drawn client-side in the grammar's theme: Mermaid (`mermaid`) is imported lazily on the first
+ * diagram, initialised with colours resolved from the root's semantic tokens (surface, foreground, separator, accent),
+ * and its SVG is placed as one named image. Loading keeps the canvas box with a Skeleton; a source Mermaid refuses is
+ * an error inside the same region, the title then the source as code, so the reader still has the text.
+ * Contract: overflow OVERFLOW-4; loading and failure keep the anatomy STATE-8.
+ */
+export const MermaidDiagram = ({ source, label, height = "sm", errorTitle = "This diagram could not be drawn.", sourceLabel, isSkeleton = false, className, }) => {
+    const frame = useRef(null);
+    const canvas = useRef(null);
+    const [drawing, setDrawing] = useState({ status: "loading" });
+    const revision = useThemeRevision(frame);
+    const id = `grammar-mermaid-${useId().replace(/[^a-zA-Z0-9_-]/g, "")}`;
+    useEffect(() => {
+        if (isSkeleton || frame.current === null)
+            return;
+        let isCurrent = true;
+        setDrawing({ status: "loading" });
+        const theme = resolveMermaidTheme(frame.current);
+        renderSerially(`${id}-${revision}`, source, theme).then((svg) => { if (isCurrent)
+            setDrawing(svgNode(svg) === null ? { status: "error", message: "not an svg" } : { status: "ready", svg }); }, (error) => { if (isCurrent)
+            setDrawing({ status: "error", message: error instanceof Error ? error.message : String(error) }); });
+        return () => { isCurrent = false; };
+    }, [id, isSkeleton, revision, source]);
+    useEffect(() => {
+        if (drawing.status !== "ready" || canvas.current === null)
+            return;
+        const node = svgNode(drawing.svg);
+        if (node !== null)
+            canvas.current.replaceChildren(node);
+    }, [drawing]);
+    const state = isSkeleton ? "loading" : drawing.status;
+    return (_jsx("figure", { ref: frame, className: ["starci-core-mermaid-diagram", className].filter(Boolean).join(" "), "data-component": "MermaidDiagram", "data-contract": state === "ready" ? "OVERFLOW-4" : "OVERFLOW-4 STATE-8", "data-grammar-mermaid-height": height, "data-grammar-mermaid-state": state, "data-tier": "branch", "aria-label": label, ...(state === "loading" ? { "aria-busy": true, "data-loading": "true" } : {}), children: state === "error" ? (_jsxs("div", { className: "starci-core-mermaid-diagram-error", "data-grammar-mermaid-error": "true", children: [_jsx(Alert, { tone: "negative", appearance: "soft", title: errorTitle }), _jsx(FencedCodeBlock, { language: "mermaid", label: sourceLabel ?? `${label} source`, code: source })] })) : (
+        // A wide drawing scrolls inline in this frame: a named Tab stop, since the drawing holds nothing focusable.
+        _jsx("div", { className: "starci-core-mermaid-diagram-canvas", "data-grammar-mermaid-canvas": "true", ...(state === "ready" ? { role: "region", "aria-label": label, tabIndex: 0 } : {}), children: state === "loading" ? _jsx(Skeleton, { shape: "rect" }) : _jsx("div", { ref: canvas, className: "starci-core-mermaid-diagram-drawing", role: "img", "aria-label": label }) })) }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/branch/MermaidDiagram/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/MermaidDiagram/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAA8B,MAAM,YAAY,CAAA;AAmC5E,IAAI,aAAa,GAA+B,IAAI,CAAA;AACpD,oGAAoG;AACpG,MAAM,WAAW,GAAG,GAAwB,EAAE;IAC1C,aAAa,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAgC,CAAC,CAAA;IAC7F,OAAO,aAAa,CAAA;AACxB,CAAC,CAAA;AAED,IAAI,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAA;AAC/C;;;GAGG;AACH,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,MAAc,EAAE,KAA4B,EAAmB,EAAE;IACjG,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QAC9B,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAA;QACnC,OAAO,CAAC,UAAU,CAAC;YACf,WAAW,EAAE,KAAK;YAClB,aAAa,EAAE,QAAQ;YACvB,iHAAiH;YACjH,sBAAsB,EAAE,IAAI;YAC5B,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,cAAc,EAAE,KAAK;YACrB,UAAU,EAAE,KAAK;YACjB,SAAS,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;SACnC,CAAC,CAAA;QACF,IAAI,CAAC;YACD,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;YAChD,OAAO,GAAG,CAAA;QACd,CAAC;gBAAS,CAAC;YACP,sFAAsF;YACtF,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;QAC/C,CAAC;IACL,CAAC,CAAC,CAAA;IACF,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAClC,OAAO,GAAG,CAAA;AACd,CAAC,CAAA;AAED,0GAA0G;AAC1G,MAAM,OAAO,GAAG,CAAC,GAAW,EAAwB,EAAE;IAClD,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,eAAe,CAAC,CAAA;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,CAAA;IACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/G,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAA6B,CAAA;IACxE,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IACxC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAA;IAC9B,OAAO,IAAI,CAAA;AACf,CAAC,CAAA;AAED,sHAAsH;AACtH,MAAM,gBAAgB,GAAG,CAAC,MAAqC,EAAE,EAAE;IAC/D,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC3C,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,sBAAsB,CAAC,IAAI,IAAI,CAAA;QACpE,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACpD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAA;QAChE,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAClE,QAAQ,EAAE,OAAO,CAAC,IAAe,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,oBAAoB,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;QAC1I,OAAO,GAAG,EAAE;YACR,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;YAC1C,QAAQ,EAAE,UAAU,EAAE,CAAA;QAC1B,CAAC,CAAA;IACL,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IACZ,OAAO,QAAQ,CAAA;AACnB,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAC3B,MAAM,EACN,KAAK,EACL,MAAM,GAAG,IAAI,EACb,UAAU,GAAG,kCAAkC,EAC/C,WAAW,EACX,UAAU,GAAG,KAAK,EAClB,SAAS,GACS,EAAE,EAAE;IACtB,MAAM,KAAK,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAA;IAClD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;IACtE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACxC,MAAM,EAAE,GAAG,mBAAmB,KAAK,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,EAAE,CAAA;IAEtE,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,UAAU,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;YAAE,OAAM;QAChD,IAAI,SAAS,GAAG,IAAI,CAAA;QACpB,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAChD,cAAc,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CACnD,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,SAAS;YAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA,CAAC,CAAC,EACrI,CAAC,KAAc,EAAE,EAAE,GAAG,IAAI,SAAS;YAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA,CAAC,CAAC,CAC1I,CAAA;QACD,OAAO,GAAG,EAAE,GAAG,SAAS,GAAG,KAAK,CAAA,CAAC,CAAC,CAAA;IACtC,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;IAEtC,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;YAAE,OAAM;QACjE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC3D,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IACrD,OAAO,CACH,iBACI,GAAG,EAAE,KAAK,EACV,SAAS,EAAE,CAAC,6BAA6B,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,oBAChE,gBAAgB,mBAChB,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,oBAAoB,iCACzC,MAAM,gCACP,KAAK,eACvB,QAAQ,gBACN,KAAK,KACb,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAE7E,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CACjB,eAAK,SAAS,EAAC,mCAAmC,gCAA4B,MAAM,aAChF,KAAC,KAAK,IAAC,IAAI,EAAC,UAAU,EAAC,UAAU,EAAC,MAAM,EAAC,KAAK,EAAE,UAAU,GAAI,EAC9D,KAAC,eAAe,IAAC,QAAQ,EAAC,SAAS,EAAC,KAAK,EAAE,WAAW,IAAI,GAAG,KAAK,SAAS,EAAE,IAAI,EAAE,MAAM,GAAI,IAC3F,CACT,CAAC,CAAC,CAAC;QACA,4GAA4G;QAC5G,cACI,SAAS,EAAC,oCAAoC,iCAClB,MAAM,KAC9B,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAElF,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAC,QAAQ,IAAC,KAAK,EAAC,MAAM,GAAG,CAAC,CAAC,CAAC,cAAK,GAAG,EAAE,MAAM,EAAE,SAAS,EAAC,qCAAqC,EAAC,IAAI,EAAC,KAAK,gBAAa,KAAK,GAAI,GACnJ,CACT,GACI,CACZ,CAAA;AACL,CAAC,CAAA"}

package/dist/core/branch/MermaidDiagram/theme.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Mermaid's `base` theme variables, resolved from the grammar root's semantic tokens. Mermaid derives shades from the
+ * colours it is given, so it needs concrete colours: each token is resolved in the page (through a probe inside the
+ * diagram, so family, theme and the caller's token overrides apply) and converted to hex through a 1px canvas, which
+ * turns any CSS colour syntax (oklch, color-mix) into sRGB.
+ */
+export type MermaidThemeVariables = {
+    readonly darkMode: boolean;
+    readonly fontFamily: string;
+    readonly fontSize: string;
+    readonly background: string;
+    readonly primaryColor: string;
+    readonly primaryTextColor: string;
+    readonly primaryBorderColor: string;
+    readonly secondaryColor: string;
+    readonly secondaryTextColor: string;
+    readonly secondaryBorderColor: string;
+    readonly tertiaryColor: string;
+    readonly tertiaryTextColor: string;
+    readonly tertiaryBorderColor: string;
+    readonly mainBkg: string;
+    readonly nodeBorder: string;
+    readonly textColor: string;
+    readonly titleColor: string;
+    readonly lineColor: string;
+    readonly edgeLabelBackground: string;
+    readonly clusterBkg: string;
+    readonly clusterBorder: string;
+    readonly noteBkgColor: string;
+    readonly noteTextColor: string;
+    readonly noteBorderColor: string;
+    readonly actorBkg: string;
+    readonly actorBorder: string;
+    readonly actorTextColor: string;
+    readonly signalColor: string;
+    readonly signalTextColor: string;
+};
+/** The theme variables of the diagram rendered inside `anchor`. */
+export declare const resolveMermaidTheme: (anchor: HTMLElement) => MermaidThemeVariables;
+//# sourceMappingURL=theme.d.ts.map

package/dist/core/branch/MermaidDiagram/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/MermaidDiagram/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACnC,CAAA;AAyDD,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,GAAI,QAAQ,WAAW,KAAG,qBAiCzD,CAAA"}

package/dist/core/branch/MermaidDiagram/theme.js

@@ -0,0 +1,86 @@
+/** Token, then the system colour used when the token resolves to nothing. */
+const TOKENS = {
+    surface: ["--surface", "Canvas"],
+    surfaceSecondary: ["--surface-secondary", "Canvas"],
+    foreground: ["--foreground", "CanvasText"],
+    muted: ["--muted", "GrayText"],
+    border: ["--border", "CanvasText"],
+    separator: ["--separator", "GrayText"],
+    accentSoft: ["--accent-soft", "Canvas"],
+    accentSoftForeground: ["--accent-soft-foreground", "CanvasText"],
+    accent: ["--accent", "Highlight"],
+    warningSoft: ["--warning-soft", "Canvas"],
+};
+const hex = (channel) => channel.toString(16).padStart(2, "0");
+/** Resolves every token to `#rrggbb` inside `anchor`, so the values are the ones the diagram's own root shows. */
+const resolveTokens = (anchor) => {
+    const probe = document.createElement("span");
+    probe.setAttribute("aria-hidden", "true");
+    probe.style.cssText = "position:absolute;inline-size:0;block-size:0;overflow:hidden;visibility:hidden";
+    anchor.append(probe);
+    const context = document.createElement("canvas").getContext("2d", { willReadFrequently: true });
+    const resolved = {};
+    for (const [name, [token, fallback]] of Object.entries(TOKENS)) {
+        probe.style.color = `var(${token}, ${fallback})`;
+        const color = getComputedStyle(probe).color;
+        if (context === null) {
+            resolved[name] = color;
+            continue;
+        }
+        context.clearRect(0, 0, 1, 1);
+        context.fillStyle = "#000000";
+        context.fillStyle = color;
+        context.fillRect(0, 0, 1, 1);
+        const [red = 0, green = 0, blue = 0] = context.getImageData(0, 0, 1, 1).data;
+        resolved[name] = `#${hex(red)}${hex(green)}${hex(blue)}`;
+    }
+    probe.remove();
+    return resolved;
+};
+/** Relative luminance of a `#rrggbb` colour, for Mermaid's dark-mode switch. */
+const luminance = (color) => {
+    const match = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(color);
+    if (match === null)
+        return 1;
+    const [red, green, blue] = match.slice(1).map((part) => {
+        const value = Number.parseInt(part, 16) / 255;
+        return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+    });
+    return 0.2126 * red + 0.7152 * green + 0.0722 * blue;
+};
+/** The theme variables of the diagram rendered inside `anchor`. */
+export const resolveMermaidTheme = (anchor) => {
+    const token = resolveTokens(anchor);
+    return {
+        darkMode: luminance(token.surface) < 0.5,
+        fontFamily: getComputedStyle(anchor).fontFamily,
+        fontSize: "14px",
+        background: token.surface,
+        primaryColor: token.surfaceSecondary,
+        primaryTextColor: token.foreground,
+        primaryBorderColor: token.border,
+        secondaryColor: token.accentSoft,
+        secondaryTextColor: token.accentSoftForeground,
+        secondaryBorderColor: token.accent,
+        tertiaryColor: token.surface,
+        tertiaryTextColor: token.foreground,
+        tertiaryBorderColor: token.separator,
+        mainBkg: token.surfaceSecondary,
+        nodeBorder: token.border,
+        textColor: token.foreground,
+        titleColor: token.foreground,
+        lineColor: token.muted,
+        edgeLabelBackground: token.surface,
+        clusterBkg: token.surface,
+        clusterBorder: token.separator,
+        noteBkgColor: token.warningSoft,
+        noteTextColor: token.foreground,
+        noteBorderColor: token.separator,
+        actorBkg: token.surfaceSecondary,
+        actorBorder: token.border,
+        actorTextColor: token.foreground,
+        signalColor: token.foreground,
+        signalTextColor: token.foreground,
+    };
+};
+//# sourceMappingURL=theme.js.map

package/dist/core/branch/MermaidDiagram/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../../src/core/branch/MermaidDiagram/theme.ts"],"names":[],"mappings":"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"}

package/dist/core/branch/Tabs/index.d.ts

@@ -4,14 +4,22 @@ export type TabItem = {
     readonly id: string;
     readonly label: string;
     readonly leading?: ReactNode;
+    /**
+     * The route this tab opens. A tab with `href` is a link tab: it renders an anchor, navigates through the
+     * `GrammarRoot` router (`navigate`, `useHref`) or the browser, and needs no `onSelect`, so a server page can pass
+     * its page tabs as plain data. The selected link tab follows the current path unless `selectedKey` is given.
+     */
+    readonly href?: string;
 };
 /**
- * Business-neutral controlled peer tabs with the shared horizontal frame owning overflow,
- * scroll shadows and the directional controls.
+ * Business-neutral peer tabs with the shared horizontal frame owning overflow, scroll shadows and the directional
+ * controls. Controlled tabs pass `selectedKey` and `onSelect`; link tabs pass an `href` on every item and the selected
+ * tab is the one whose `href` matches the current path (the exact path, else the longest `href` the path lies under).
  */
 export type TabsProps = {
     readonly label: string;
-    readonly selectedKey: string;
+    /** The selected tab. Required for controlled tabs; link tabs derive it from the current path when it is omitted. */
+    readonly selectedKey?: string;
     readonly items: ReadonlyArray<TabItem>;
     readonly onSelect?: (key: string) => void;
     readonly panelId?: (key: string) => string;

package/dist/core/branch/Tabs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Tabs/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAUpF,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAC/B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAC1C,uLAAuL;IACvL,QAAQ,CAAC,eAAe,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAA;IAClD,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAA;IAC1C,4IAA4I;IAC5I,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,sFAAsF;IACtF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACpC,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,IAAI,GAAI,OAAO,SAAS,gCAgGpC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Tabs/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAUpF,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,oHAAoH;IACpH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAC1C,uLAAuL;IACvL,QAAQ,CAAC,eAAe,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAA;IAClD,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAA;IAC1C,4IAA4I;IAC5I,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,sFAAsF;IACtF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACpC,CAAA;AAmCD,qFAAqF;AACrF,eAAO,MAAM,IAAI,GAAI,OAAO,SAAS,gCA4GpC,CAAA"}

package/dist/core/branch/Tabs/index.js

@@ -5,12 +5,58 @@ import { useEffect, useLayoutEffect, useRef, useState } from "react";
 import { HorizontalScrollFrame } from "../../HorizontalScrollFrame.js";
 import { useSurfaceNesting } from "../../surfaceContext.js";
 import { tabContentClassName, tabLabelClassName, tabsClassName, tabsFrameClassName, } from "./classNames.js";
+/** A path without its trailing slash, the root kept as `/`. */
+const trimPath = (path) => (path.length > 1 && path.endsWith("/") ? path.slice(0, -1) : path);
+/**
+ * The link tab the current path selects: the item whose `href` path is the current path, else the one with the
+ * longest `href` path the current path lies under, else none.
+ */
+const tabKeyFromPath = (items, pathname, base) => {
+    const current = trimPath(pathname);
+    let best;
+    for (const item of items) {
+        if (item.href === undefined)
+            continue;
+        const path = trimPath(new URL(item.href, base).pathname);
+        if (path === current)
+            return item.id;
+        const under = path === "/" ? current.startsWith("/") : current.startsWith(`${path}/`);
+        if (under && (best === undefined || path.length > best.length))
+            best = { id: item.id, length: path.length };
+    }
+    return best?.id;
+};
+/** The current location's path, read on the client and kept current across history moves. */
+const useLocationPath = (enabled) => {
+    const [path, setPath] = useState(undefined);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const read = () => setPath(window.location.pathname);
+        read();
+        window.addEventListener("popstate", read);
+        return () => window.removeEventListener("popstate", read);
+    }, [enabled]);
+    return [path, setPath];
+};
 /** Render peer tabs through Core's selected, accessible and responsive treatment. */
 export const Tabs = (props) => {
     const nested = useSurfaceNesting();
     const [isClientReady, setIsClientReady] = useState(false);
     const frameRef = useRef(null);
     useEffect(() => setIsClientReady(true), []);
+    const isLinkTabs = props.items.some((item) => item.href !== undefined);
+    const [locationPath, setLocationPath] = useLocationPath(isLinkTabs && props.selectedKey === undefined);
+    // A path no link tab owns falls back to the first tab, so link tabs stay controlled from their first render.
+    const selectedKey = props.selectedKey
+        ?? (isLinkTabs && locationPath !== undefined ? tabKeyFromPath(props.items, locationPath, window.location.href) ?? props.items[0]?.id : undefined);
+    const select = (key) => {
+        const href = props.items.find((item) => item.id === key)?.href;
+        // A link tab navigates on its own; selecting it ahead of the route change keeps the indicator on the press.
+        if (href !== undefined && props.selectedKey === undefined)
+            setLocationPath(new URL(href, window.location.href).pathname);
+        props.onSelect?.(key);
+    };
     useLayoutEffect(() => {
         const frame = frameRef.current;
         const panelId = props.panelId;
@@ -48,7 +94,7 @@ export const Tabs = (props) => {
                     tab.setAttribute("aria-controls", original);
             });
         };
-    }, [isClientReady, props.items, props.panelId, props.selectedKey]);
+    }, [isClientReady, props.items, props.panelId, selectedKey]);
     // The vendor indicator fills its tab and animates width. A label edit resizes the selected tab, so the
     // indicator follows at once: the frame disables that width transition for the commit that changed a label.
     const labelSignature = props.items.map((item) => `${item.id}|${item.label}`).join(", ");
@@ -76,6 +122,6 @@ export const Tabs = (props) => {
     const frameContract = inset === "page" ? "PADDING-5" : undefined;
     if (!isClientReady)
         return _jsx("div", { "aria-hidden": "true", className: tabsFrameClassName, "data-contract": frameContract, "data-component": "Tabs", "data-tier": "branch", "data-grammar-tabs": "true", "data-grammar-tabs-client": "pending", "data-grammar-tabs-inset": inset, "data-grammar-tabs-variant": variant, style: { minHeight: "3rem" } });
-    return _jsx("div", { ref: frameRef, className: tabsFrameClassName, "data-contract": frameContract, "data-component": "Tabs", "data-tier": "branch", "data-grammar-tabs": "true", "data-grammar-tabs-client": "ready", "data-grammar-tabs-inset": inset, "data-grammar-tabs-variant": variant, "data-grammar-tab-labels": props.labelVisibility ?? "responsive", children: _jsx(HeroTabs, { variant: vendorVariant, selectedKey: props.selectedKey, onSelectionChange: (key) => props.onSelect?.(String(key)), className: tabsClassName ?? "", "data-contract": "FLOW-2", children: _jsx(HeroTabs.List, { "aria-label": props.label, render: ({ children, ref, ...listProps }) => (_jsx(HorizontalScrollFrame, { appearance: "tabs", hideScrollBar: true, size: 64, scrollPreviousLabel: scrollPreviousLabel, scrollNextLabel: scrollNextLabel, children: _jsx("div", { ...listProps, ref: ref, children: children }) })), children: props.items.map((item) => (_jsxs(HeroTabs.Tab, { id: item.id, "aria-label": item.label, "data-contract": "PADDING-3", children: [_jsxs("span", { className: tabContentClassName, "data-contract": "GAP-2", "data-grammar-tab-id": item.id, children: [item.leading, _jsx("span", { className: tabLabelClassName, style: props.labelVisibility === "always" || item.leading == null ? { display: "inline" } : undefined, children: item.label })] }), _jsx(HeroTabs.Indicator, {})] }, item.id))) }) }) });
+    return _jsx("div", { ref: frameRef, className: tabsFrameClassName, "data-contract": frameContract, "data-component": "Tabs", "data-tier": "branch", "data-grammar-tabs": "true", "data-grammar-tabs-client": "ready", "data-grammar-tabs-inset": inset, "data-grammar-tabs-variant": variant, "data-grammar-tab-labels": props.labelVisibility ?? "responsive", children: _jsx(HeroTabs, { variant: vendorVariant, ...(selectedKey === undefined ? {} : { selectedKey }), onSelectionChange: (key) => select(String(key)), className: tabsClassName ?? "", "data-contract": "FLOW-2", children: _jsx(HeroTabs.List, { "aria-label": props.label, render: ({ children, ref, ...listProps }) => (_jsx(HorizontalScrollFrame, { appearance: "tabs", hideScrollBar: true, size: 64, scrollPreviousLabel: scrollPreviousLabel, scrollNextLabel: scrollNextLabel, children: _jsx("div", { ...listProps, ref: ref, children: children }) })), children: props.items.map((item) => (_jsxs(HeroTabs.Tab, { id: item.id, ...(item.href === undefined ? {} : { href: item.href }), "aria-label": item.label, "data-contract": "PADDING-3", children: [_jsxs("span", { className: tabContentClassName, "data-contract": "GAP-2", "data-grammar-tab-id": item.id, children: [item.leading, _jsx("span", { className: tabLabelClassName, style: props.labelVisibility === "always" || item.leading == null ? { display: "inline" } : undefined, children: item.label })] }), _jsx(HeroTabs.Indicator, {})] }, item.id))) }) }) });
 };
 //# sourceMappingURL=index.js.map

package/dist/core/branch/Tabs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Tabs/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Tabs/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACrB,MAAM,iBAAiB,CAAA;AA6CxB,+DAA+D;AAC/D,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAE7G;;;GAGG;AACH,MAAM,cAAc,GAAG,CAAC,KAA6B,EAAE,QAAgB,EAAE,IAAY,EAAsB,EAAE;IACzG,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAClC,IAAI,IAAkE,CAAA;IACtE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,SAAQ;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;QACxD,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC,EAAE,CAAA;QACpC,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAA;QACrF,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAAE,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IAC/G,CAAC;IACD,OAAO,IAAI,EAAE,EAAE,CAAA;AACnB,CAAC,CAAA;AAED,6FAA6F;AAC7F,MAAM,eAAe,GAAG,CAAC,OAAgB,EAAyD,EAAE;IAChG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAqB,SAAS,CAAC,CAAA;IAC/D,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACpD,IAAI,EAAE,CAAA;QACN,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QACzC,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAC7D,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IACb,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAC1B,CAAC,CAAA;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAgB,EAAE,EAAE;IACrC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAA;IAClC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACzD,MAAM,QAAQ,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAA;IAC7C,SAAS,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;IACtE,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,eAAe,CAAC,UAAU,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAA;IACtG,6GAA6G;IAC7G,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW;WAC9B,CAAC,UAAU,IAAI,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACrJ,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAA;QAC9D,4GAA4G;QAC5G,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;YAAE,eAAe,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;QACxH,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC,CAAA;IACD,eAAe,CAAC,GAAG,EAAE;QACjB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAA;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QAC7B,IAAI,CAAC,aAAa,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;YAAE,OAAM;QAErE,4EAA4E;QAC5E,+EAA+E;QAC/E,MAAM,aAAa,GAAG,IAAI,GAAG,EAA6D,CAAA;QAC1F,MAAM,YAAY,GAAG,GAAG,EAAE;YACtB,KAAK,CAAC,gBAAgB,CAAc,uBAAuB,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAA;gBAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAc,cAAc,CAAC,CAAA;gBACzD,IAAI,MAAM,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;oBAAE,OAAM;gBAChD,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAA;gBACjD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;gBAChC,MAAM,QAAQ,GAAG,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAA;gBACrG,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;gBACvD,IAAI,OAAO,KAAK,QAAQ;oBAAE,GAAG,CAAC,YAAY,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;YACzE,CAAC,CAAC,CAAA;QACN,CAAC,CAAA;QACD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAAA;QACnD,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,eAAe,EAAE,qBAAqB,CAAC,EAAE,CAAC,CAAA;QACxI,YAAY,EAAE,CAAA;QACd,OAAO,GAAG,EAAE;YACR,QAAQ,CAAC,UAAU,EAAE,CAAA;YACrB,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE;gBACjD,IAAI,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,KAAK,OAAO;oBAAE,OAAM;gBACzD,IAAI,QAAQ,KAAK,IAAI;oBAAE,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC,CAAA;;oBACtD,GAAG,CAAC,YAAY,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;YACpD,CAAC,CAAC,CAAA;QACN,CAAC,CAAA;IACL,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAA;IAE5D,uGAAuG;IACvG,2GAA2G;IAC3G,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvF,MAAM,iBAAiB,GAAG,MAAM,CAAC,cAAc,CAAC,CAAA;IAChD,eAAe,CAAC,GAAG,EAAE;QACjB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAA;QAC9B,IAAI,iBAAiB,CAAC,OAAO,KAAK,cAAc;YAAE,OAAM;QACxD,iBAAiB,CAAC,OAAO,GAAG,cAAc,CAAA;QAC1C,IAAI,KAAK,KAAK,IAAI;YAAE,OAAM;QAC1B,KAAK,CAAC,OAAO,CAAC,oBAAoB,GAAG,MAAM,CAAA;QAC3C,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,EAAE;YACrC,qBAAqB,CAAC,GAAG,EAAE,GAAG,OAAO,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAA,CAAC,CAAC,CAAC,CAAA;QAC9E,CAAC,CAAC,CAAA;QACF,OAAO,GAAG,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAA,CAAC,CAAC,CAAA;IAC3F,CAAC,EAAE,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAA;IAEnC,MAAM,mBAAmB,GAAG,KAAK,CAAC,mBAAmB,IAAI,kBAAkB,CAAA;IAC3E,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,IAAI,mBAAmB,CAAA;IAEpE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,MAAM,CAAA;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACnE,8EAA8E;IAC9E,+DAA+D;IAC/D,MAAM,aAAa,GAAG,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAA;IACvE,MAAM,aAAa,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAA;IAChE,IAAI,CAAC,aAAa;QAAE,OAAO,6BAAiB,MAAM,EAAC,SAAS,EAAE,kBAAkB,mBAAiB,aAAa,oBAAiB,MAAM,eAAW,QAAQ,uBAAmB,MAAM,8BAA0B,SAAS,6BAA0B,KAAK,+BAA6B,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAI,CAAA;IAEzT,OAAO,cAAK,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,mBAAiB,aAAa,oBAAiB,MAAM,eAAW,QAAQ,uBAAmB,MAAM,8BAA0B,OAAO,6BAA0B,KAAK,+BAA6B,OAAO,6BAA2B,KAAK,CAAC,eAAe,IAAI,YAAY,YACzT,KAAC,QAAQ,IACL,OAAO,EAAE,aAAa,KAClB,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EACtD,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAC/C,SAAS,EAAE,aAAa,IAAI,EAAE,mBAChB,QAAQ,YAEtB,KAAC,QAAQ,CAAC,IAAI,kBAAa,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,EAAE,EAAE,CAAC,CACjF,KAAC,qBAAqB,IAAC,UAAU,EAAC,MAAM,EAAC,aAAa,QAAC,IAAI,EAAE,EAAE,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,YACvI,iBAAS,SAAS,EAAE,GAAG,EAAE,GAAG,YAAG,QAAQ,GAAO,GAC1B,CAC3B,YACI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACvB,MAAC,QAAQ,CAAC,GAAG,IAET,EAAE,EAAE,IAAI,CAAC,EAAE,KACP,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,gBAC5C,IAAI,CAAC,KAAK,mBACR,WAAW,aAEzB,gBAAM,SAAS,EAAE,mBAAmB,mBAAgB,OAAO,yBAAsB,IAAI,CAAC,EAAE,aACnF,IAAI,CAAC,OAAO,EACb,eAAM,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,CAAC,eAAe,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,YAAG,IAAI,CAAC,KAAK,GAAQ,IAC3J,EACP,KAAC,QAAQ,CAAC,SAAS,KAAG,KAVjB,IAAI,CAAC,EAAE,CAWD,CAClB,CAAC,GACU,GACT,GACT,CAAA;AACV,CAAC,CAAA"}

package/dist/core/composite/FormGrid/index.d.ts

@@ -0,0 +1,17 @@
+import { type ReactNode } from "react";
+/** How many fields share a row once the grid's own width holds them. */
+export type FormGridColumns = 1 | 2;
+export type FormGridProps = {
+    /** The fields, in reading order; they fill the rows left to right. */
+    readonly children: ReactNode;
+    /** Fields per row at a wide container; below it every row is one column (RESPONSIVE-1). Default 2. */
+    readonly columns?: FormGridColumns;
+};
+/**
+ * The form column layout. Fields fill rows of `columns`; every row is a grid of four tracks (label, control, description,
+ * error) that each field takes as a subgrid, so the controls of one row stand on one line whether or not a neighbour
+ * carries a description, an error or a two-line label. The columns come from a container query on the grid itself, never
+ * from the viewport, so a form in a narrow owner (drawer, rail, dialog) stays one column.
+ */
+export declare const FormGrid: ({ children, columns }: FormGridProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composite/FormGrid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/FormGrid/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEhE,wEAAwE;AACxE,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,CAAA;AAEnC,MAAM,MAAM,aAAa,GAAG;IACxB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,sGAAsG;IACtG,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CACrC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,uBAA2B,aAAa,gCAuBhE,CAAA"}

package/dist/core/composite/FormGrid/index.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Children, isValidElement } from "react";
+/**
+ * The form column layout. Fields fill rows of `columns`; every row is a grid of four tracks (label, control, description,
+ * error) that each field takes as a subgrid, so the controls of one row stand on one line whether or not a neighbour
+ * carries a description, an error or a two-line label. The columns come from a container query on the grid itself, never
+ * from the viewport, so a form in a narrow owner (drawer, rail, dialog) stays one column.
+ */
+export const FormGrid = ({ children, columns = 2 }) => {
+    const fields = Children.toArray(children);
+    const rows = [];
+    for (let start = 0; start < fields.length; start += columns)
+        rows.push(fields.slice(start, start + columns));
+    return (_jsx("div", { "data-tier": "composite", "data-component": "FormGrid", "data-contract": "RESPONSIVE-1", "data-grammar-form-grid-columns": String(columns), className: "starci-core-form-grid", children: rows.map((row) => (_jsx("div", { className: "starci-core-form-grid-row", "data-grammar-form-grid-row": "true", children: row }, row.map((field) => (isValidElement(field) ? String(field.key) : "")).join("|")))) }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/composite/FormGrid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/FormGrid/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAkB,MAAM,OAAO,CAAA;AAYhE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,CAAC,EAAiB,EAAE,EAAE;IACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzC,MAAM,IAAI,GAAkB,EAAE,CAAA;IAC9B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC,CAAA;IAC5G,OAAO,CACH,2BACc,WAAW,oBACN,UAAU,mBACX,cAAc,oCACI,MAAM,CAAC,OAAO,CAAC,EAC/C,SAAS,EAAC,uBAAuB,YAEhC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACf,cAEI,SAAS,EAAC,2BAA2B,gCACV,MAAM,YAEhC,GAAG,IAJC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAKjF,CACT,CAAC,GACA,CACT,CAAA;AACL,CAAC,CAAA"}

package/dist/core/composition/Page/index.d.ts

@@ -0,0 +1,30 @@
+import type { ReactNode } from "react";
+import { type PageContainerProps } from "../../primitive/PageContainer/index.js";
+import { type PageHeaderProps } from "../PageHeader/index.js";
+/** The page header Page draws: every `PageHeader` prop except the two Page owns, `measure` and `isSkeleton`. */
+export type PageHeaderContent = Omit<PageHeaderProps, "measure" | "isSkeleton" | "className">;
+export type PageProps = {
+    /**
+     * The page header band, as `PageHeader`'s props (data, not an element): Page draws it full width with the body's
+     * measure, so the header's content edges are the body's. Leave it out for a page with no header band (a sign-in
+     * card, a landing hero); the body then starts one region step below the top.
+     */
+    readonly header?: PageHeaderContent;
+    /** The page body. It always sits inside the page measure and gutter; nothing in it reaches past the gutter. */
+    readonly children: ReactNode;
+    /** The page measure, shared by the header's content and the body. Default `product`. */
+    readonly measure?: PageContainerProps["measure"];
+    /** Unresolved page subject (STATE-8): passed to the header, which keeps its slots' boxes. The body owns its own loading. */
+    readonly isSkeleton?: boolean;
+    /** Layout only: the page's placement in the app's layout region. */
+    readonly className?: string;
+};
+/**
+ * One route page: the header band across the region, then the body in the page measure and gutter, one region step
+ * below it. Page is the single owner of the page inset and the page's vertical rhythm; layout frames (WorkspaceShell,
+ * PrimaryRailLayout, ChatWorkspace) only place regions and never wrap a page in a PageContainer. Page tabs are the
+ * header's `tabs`, never a Tabs at the top of the body (lint `page-tabs-in-header`), and a route page renders nothing
+ * beside its Page (lint `route-page-is-one-page`).
+ */
+export declare const Page: ({ header, children, measure, isSkeleton, className }: PageProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composition/Page/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composition/Page/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAC/F,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAEzE,gHAAgH;AAChH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC,CAAA;AAE7F,MAAM,MAAM,SAAS,GAAG;IACpB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;IACnC,+GAA+G;IAC/G,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,wFAAwF;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAChD,4HAA4H;IAC5H,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,sDAA0E,SAAS,gCAavG,CAAA"}

package/dist/core/composition/Page/index.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@heroui/react";
+import { PageContainer } from "../../primitive/PageContainer/index.js";
+import { PageHeader } from "../PageHeader/index.js";
+/**
+ * One route page: the header band across the region, then the body in the page measure and gutter, one region step
+ * below it. Page is the single owner of the page inset and the page's vertical rhythm; layout frames (WorkspaceShell,
+ * PrimaryRailLayout, ChatWorkspace) only place regions and never wrap a page in a PageContainer. Page tabs are the
+ * header's `tabs`, never a Tabs at the top of the body (lint `page-tabs-in-header`), and a route page renders nothing
+ * beside its Page (lint `route-page-is-one-page`).
+ */
+export const Page = ({ header, children, measure = "product", isSkeleton = false, className }) => (_jsxs("div", { className: cn("starci-core-page", className), "data-component": "Page", "data-tier": "composition", "data-contract": "MARGIN-5 MEASURE-1", "data-grammar-page-header": header === undefined ? "false" : "true", children: [header === undefined ? null : _jsx(PageHeader, { ...header, measure: measure, isSkeleton: isSkeleton }), _jsx(PageContainer, { className: "starci-core-page-body", "data-grammar-page-body": "true", measure: measure, children: children })] }));
+//# sourceMappingURL=index.js.map

package/dist/core/composition/Page/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composition/Page/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,OAAO,EAAE,aAAa,EAA2B,MAAM,wCAAwC,CAAA;AAC/F,OAAO,EAAE,UAAU,EAAwB,MAAM,wBAAwB,CAAA;AAsBzE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,EAAE,UAAU,GAAG,KAAK,EAAE,SAAS,EAAa,EAAE,EAAE,CAAC,CACzG,eACI,SAAS,EAAE,EAAE,CAAC,kBAAkB,EAAE,SAAS,CAAC,oBAC7B,MAAM,eACX,aAAa,mBACT,oBAAoB,8BACR,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,aAEhE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,UAAU,OAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAI,EACnG,KAAC,aAAa,IAAC,SAAS,EAAC,uBAAuB,4BAAwB,MAAM,EAAC,OAAO,EAAE,OAAO,YAC1F,QAAQ,GACG,IACd,CACT,CAAA"}

package/dist/core/primitive/Button/index.d.ts

@@ -36,8 +36,8 @@ type ButtonBase = {
      * How the action takes its inline space: to its own content, or filling its parent.
      *
      * `fill` forwards the vendor's own full-width variant and adds the part the vendor does not
-     * own - a label that WRAPS onto a second line instead of overflowing, with the control height
-     * released to follow it - from `.starci-core-button[data-width="fill"]` in the packaged
+     * own - a label that WRAPS onto a second line instead of overflowing, the box holding its size
+     * step (md 40px) on one line and growing only with the wrapped label - from `.starci-core-button[data-width="fill"]` in the packaged
      * stylesheet. An app never has to reach through the boundary with a descendant width utility.
      */
     readonly width?: ButtonWidth;
@@ -57,13 +57,19 @@ type DestinationButton = {
     readonly onFollow?: () => void;
     readonly onPress?: never;
     readonly type?: never;
+    readonly form?: never;
 };
-/** A same-document command. It renders the vendor button and may submit or reset a form. */
+/** A same-document command. It renders the vendor button and may submit or reset a form, its own or the one `form` names. */
 type CommandButton = {
     /** Controlled toggle state. Keep the action label unchanged between pressed and unpressed. */
     readonly "aria-pressed"?: boolean;
     readonly onPress?: () => void;
     readonly type?: ButtonType;
+    /**
+     * The `id` of the form this button submits or resets from outside it: a `Drawer` or `Modal` footer button with
+     * `type="submit"` and `form` naming the form in the overlay's body.
+     */
+    readonly form?: string;
     readonly href?: never;
     readonly target?: never;
     readonly rel?: never;

package/dist/core/primitive/Button/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Button/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAE7C,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEtF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAA;AACjH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;AACvD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;AACtD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,CAAA;AAE5C,KAAK,UAAU,GAAG;IACd,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B,oGAAoG;IACpG,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAA;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAA;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAC/B,CAAA;AAED;;;;GAIG;AACH,KAAK,iBAAiB,GAAG;IACrB,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACpC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CACxB,CAAA;AAED,4FAA4F;AAC5F,KAAK,aAAa,GAAG;IACjB,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,iBAAiB,GAAG,CAAC,iBAAiB,GAAG,aAAa,CAAC,CAAA;AAiB9F,0FAA0F;AAC1F,eAAO,MAAM,MAAM,GAAI,OAAO,WAAW,gCAcxC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Button/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAE7C,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEtF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAA;AACjH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;AACvD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;AACtD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,CAAA;AAE5C,KAAK,UAAU,GAAG;IACd,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B,oGAAoG;IACpG,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAA;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAA;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAC/B,CAAA;AAED;;;;GAIG;AACH,KAAK,iBAAiB,GAAG;IACrB,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACpC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CACxB,CAAA;AAED,6HAA6H;AAC7H,KAAK,aAAa,GAAG;IACjB,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,iBAAiB,GAAG,CAAC,iBAAiB,GAAG,aAAa,CAAC,CAAA;AAiB9F,0FAA0F;AAC1F,eAAO,MAAM,MAAM,GAAI,OAAO,WAAW,gCAcxC,CAAA"}