@starci/grammar 0.1.0 → 0.3.0

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

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { fencedCodeBlockClassName, fencedCodeHeaderClassName, markdownArticleClassName, markdownTableFrameClassName } from "./classNames.js";
+/** Own the business-neutral reading rhythm for one semantic Markdown document. */
+export const MarkdownArticle = (props) => (_jsx("div", { "aria-label": props.ariaLabel, className: markdownArticleClassName, "data-grammar-markdown-measure": props.measure ?? "reading", children: props.children }));
+/** Own bounded code overflow while allowing a caller-supplied neutral action such as Copy. */
+export const FencedCodeBlock = (props) => {
+    const body = "children" in props ? props.children : _jsx("pre", { children: _jsx("code", { children: props.code }) });
+    return (_jsxs("div", { className: fencedCodeBlockClassName, children: [props.language === undefined && props.action === undefined ? null : (_jsxs("div", { className: fencedCodeHeaderClassName, children: [props.language === undefined ? _jsx("span", {}) : _jsx("span", { children: props.language }), props.action] })), body] }));
+};
+/** Keep a vendor-rendered table inside the same bounded reading frame as semantic tables. */
+export const MarkdownTableFrame = (props) => (_jsx("div", { className: markdownTableFrameClassName, children: props.children }));
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/MarkdownArticle/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AA6B5I,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE,CAAC,CAC5D,4BACgB,KAAK,CAAC,SAAS,EAC3B,SAAS,EAAE,wBAAwB,mCACJ,KAAK,CAAC,OAAO,IAAI,SAAS,YAExD,KAAK,CAAC,QAAQ,GACb,CACT,CAAA;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE;IAC3D,MAAM,IAAI,GAAG,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,wBAAK,yBAAO,KAAK,CAAC,IAAI,GAAQ,GAAM,CAAA;IACxF,OAAO,CACH,eACI,SAAS,EAAE,wBAAwB,aAElC,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACjE,eAAK,SAAS,EAAE,yBAAyB,aACpC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAQ,CAAC,CAAC,CAAC,yBAAO,KAAK,CAAC,QAAQ,GAAQ,EACvE,KAAK,CAAC,MAAM,IACX,CACT,EACA,IAAI,IACH,CACT,CAAA;AACL,CAAC,CAAA;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAA8B,EAAE,EAAE,CAAC,CAClE,cACI,SAAS,EAAE,2BAA2B,YAErC,KAAK,CAAC,QAAQ,GACb,CACT,CAAA"}

package/dist/core/branch/Rail/classNames.d.ts

@@ -0,0 +1,9 @@
+/** Identifies the rail landmark wrapper. */
+export declare const railClassName: import("tailwind-variants").CnReturn;
+/** Identifies the rail's internal frame. */
+export declare const railFrameClassName: import("tailwind-variants").CnReturn;
+/** Identifies the rail's primary body region. */
+export declare const railBodyClassName: import("tailwind-variants").CnReturn;
+/** Identifies the optional rail footer region. */
+export declare const railFooterClassName: import("tailwind-variants").CnReturn;
+//# sourceMappingURL=classNames.d.ts.map

package/dist/core/branch/Rail/classNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Rail/classNames.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,eAAO,MAAM,aAAa,sCAAgB,CAAA;AAC1C,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,sCAAoC,CAAA;AACnE,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,sCAA0B,CAAA;AACxD,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,sCAA6B,CAAA"}

package/dist/core/branch/Rail/classNames.js

@@ -0,0 +1,10 @@
+import { cn } from "@heroui/react";
+/** Identifies the rail landmark wrapper. */
+export const railClassName = cn("min-w-0");
+/** Identifies the rail's internal frame. */
+export const railFrameClassName = cn("flex", "min-w-0", "flex-col");
+/** Identifies the rail's primary body region. */
+export const railBodyClassName = cn("min-w-0", "flex-1");
+/** Identifies the optional rail footer region. */
+export const railFooterClassName = cn("flex", "items-center");
+//# sourceMappingURL=classNames.js.map

package/dist/core/branch/Rail/classNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.js","sourceRoot":"","sources":["../../../../src/core/branch/Rail/classNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;AAC1C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;AACnE,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;AACxD,kDAAkD;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA"}

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

@@ -1,17 +1,25 @@
 import { type ReactNode } from "react";
 import { type PresentationState } from "../../state.js";
-export type RailProps = {
+type ComplementaryRailProps = {
     readonly label: string;
+    readonly landmark?: "complementary";
+};
+type ContentNavigationRailProps = {
+    readonly label?: never;
+    /** The child owns the single navigation landmark; Core must not wrap it in another landmark. */
+    readonly landmark: "content-navigation";
+};
+export type RailProps = (ComplementaryRailProps | ContentNavigationRailProps) & {
     readonly children: ReactNode;
     readonly footer?: ReactNode;
+    /** Whether the rail sizes to authored content or fills a height supplied by its layout host. */
+    readonly height?: "content" | "fill";
     readonly mode?: "flow" | "sticky";
     readonly width?: "compact" | "standard" | "wide";
     readonly state?: PresentationState;
+    readonly collapse?: "expanded" | "collapsed";
+    readonly motion?: "static" | "animated" | "reduced";
 };
-export declare const Rail: ({ label, children, footer, mode, width, state, }: RailProps) => import("react").JSX.Element;
-export declare const meta: {
-    readonly shape: "branch";
-    readonly grammar: "core";
-    readonly contract: "core.branch.rail";
-};
+export declare const Rail: (props: RailProps) => import("react").JSX.Element;
+export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Rail/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAE9F,MAAM,MAAM,SAAS,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAA;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;CACrC,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,kDAOlB,SAAS,gCAwBX,CAAA;AAED,eAAO,MAAM,IAAI;;;;CAA8E,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Rail/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAG9F,KAAK,sBAAsB,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;CACtC,CAAA;AAED,KAAK,0BAA0B,GAAG;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,sBAAsB,GAAG,0BAA0B,CAAC,GAAG;IAC5E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAA;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,CAAA;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;CACtD,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,OAAO,SAAS,gCAgDpC,CAAA"}

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

@@ -1,11 +1,27 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useId } from "react";
 import { assertPresentationState, treatmentFor } from "../../state.js";
-export const Rail = ({ label, children, footer, mode = "flow", width = "standard", state = "neutral", }) => {
+import { railBodyClassName, railClassName, railFooterClassName, railFrameClassName } from "./classNames.js";
+export const Rail = (props) => {
+    const { label, landmark = "complementary", children, footer, height = "content", mode = "flow", width = "standard", state = "neutral", collapse = "expanded", motion = "static", } = props;
     assertPresentationState(state);
     const headingId = useId();
     const treatment = treatmentFor(state);
-    return (_jsx("aside", { "aria-labelledby": headingId, className: "starci-core-rail", "data-grammar-rail": "true", "data-grammar-rail-mode": mode, "data-grammar-rail-width": width, "data-grammar-state": state, "data-grammar-treatment": treatment.tone, children: _jsxs("div", { className: "starci-core-rail-frame", "data-grammar-rail-frame": "true", children: [_jsx("h2", { "data-grammar-rail-heading": "true", id: headingId, children: label }), _jsx("div", { className: "starci-core-rail-body", "data-grammar-rail-body": "true", children: children }), footer === undefined ? null : (_jsx("div", { className: "starci-core-rail-footer", "data-grammar-rail-footer": "true", children: footer }))] }) }));
+    const frame = (_jsxs("div", { className: railFrameClassName, "data-grammar-rail-frame": "true", children: [landmark === "content-navigation" ? null : _jsx("h2", { "data-grammar-rail-heading": "true", id: headingId, children: label }), _jsx("div", { className: railBodyClassName, "data-grammar-rail-body": "true", children: children }), footer === undefined ? null : (_jsx("div", { className: railFooterClassName, "data-grammar-rail-footer": "true", children: footer }))] }));
+    const shared = {
+        className: railClassName,
+        "data-grammar-collapse": collapse,
+        "data-grammar-landmark": landmark,
+        "data-grammar-rail-height": height,
+        "data-grammar-motion": motion,
+        "data-grammar-rail": "true",
+        "data-grammar-rail-mode": mode,
+        "data-grammar-rail-width": width,
+        "data-grammar-state": state,
+        "data-grammar-treatment": treatment.tone,
+    };
+    if (landmark === "content-navigation")
+        return _jsx("div", { ...shared, children: frame });
+    return (_jsx("aside", { "aria-labelledby": headingId, ...shared, children: frame }));
 };
-export const meta = { shape: "branch", grammar: "core", contract: "core.branch.rail" };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Rail/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAA;AAW9F,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,EACjB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,IAAI,GAAG,MAAM,EACb,KAAK,GAAG,UAAU,EAClB,KAAK,GAAG,SAAS,GACT,EAAE,EAAE;IACZ,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAC9B,MAAM,SAAS,GAAG,KAAK,EAAE,CAAA;IACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAErC,OAAO,CACH,mCACqB,SAAS,EAC1B,SAAS,EAAC,kBAAkB,uBACV,MAAM,4BACA,IAAI,6BACH,KAAK,wBACV,KAAK,4BACD,SAAS,CAAC,IAAI,YAEtC,eAAK,SAAS,EAAC,wBAAwB,6BAAyB,MAAM,aAClE,0CAA8B,MAAM,EAAC,EAAE,EAAE,SAAS,YAAG,KAAK,GAAM,EAChE,cAAK,SAAS,EAAC,uBAAuB,4BAAwB,MAAM,YAAE,QAAQ,GAAO,EACpF,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3B,cAAK,SAAS,EAAC,yBAAyB,8BAA0B,MAAM,YAAE,MAAM,GAAO,CAC1F,IACC,GACF,CACX,CAAA;AACL,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Rail/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAA;AAC9F,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAyB3G,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAgB,EAAE,EAAE;IACrC,MAAM,EACF,KAAK,EACL,QAAQ,GAAG,eAAe,EAC1B,QAAQ,EACR,MAAM,EACN,MAAM,GAAG,SAAS,EAClB,IAAI,GAAG,MAAM,EACb,KAAK,GAAG,UAAU,EAClB,KAAK,GAAG,SAAS,EACjB,QAAQ,GAAG,UAAU,EACrB,MAAM,GAAG,QAAQ,GACpB,GAAG,KAAK,CAAA;IACT,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAC9B,MAAM,SAAS,GAAG,KAAK,EAAE,CAAA;IACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAErC,MAAM,KAAK,GAAG,CACV,eAAK,SAAS,EAAE,kBAAkB,6BAA0B,MAAM,aAC7D,QAAQ,KAAK,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0CAA8B,MAAM,EAAC,EAAE,EAAE,SAAS,YAAG,KAAK,GAAM,EAC5G,cAAK,SAAS,EAAE,iBAAiB,4BAAyB,MAAM,YAAE,QAAQ,GAAO,EAChF,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3B,cAAK,SAAS,EAAE,mBAAmB,8BAA2B,MAAM,YAAE,MAAM,GAAO,CACtF,IACC,CACT,CAAA;IACD,MAAM,MAAM,GAAG;QACX,SAAS,EAAE,aAAa;QACxB,uBAAuB,EAAE,QAAQ;QACjC,uBAAuB,EAAE,QAAQ;QACjC,0BAA0B,EAAE,MAAM;QAClC,qBAAqB,EAAE,MAAM;QAC7B,mBAAmB,EAAE,MAAM;QAC3B,wBAAwB,EAAE,IAAI;QAC9B,yBAAyB,EAAE,KAAK;QAChC,oBAAoB,EAAE,KAAK;QAC3B,wBAAwB,EAAE,SAAS,CAAC,IAAI;KAClC,CAAA;IAEV,IAAI,QAAQ,KAAK,oBAAoB;QAAE,OAAO,iBAAS,MAAM,YAAG,KAAK,GAAO,CAAA;IAC5E,OAAO,CACH,mCACqB,SAAS,KACtB,MAAM,YAET,KAAK,GACF,CACX,CAAA;AACL,CAAC,CAAA"}

package/dist/core/branch/SurfaceAccordionCard/classNames.d.ts

@@ -0,0 +1,15 @@
+/** Identifies the joined disclosure-card outer shell. */
+export declare const accordionCardClassName: import("tailwind-variants").CnReturn;
+/** Selects bounded or frameless disclosure surfaces. */
+export declare const getAccordionShellClassName: (bounded: boolean) => import("tailwind-variants").CnReturn;
+/** Identifies one disclosure row. */
+export declare const accordionRowClassName: import("tailwind-variants").CnReturn;
+/** Identifies the semantic disclosure heading. */
+export declare const accordionHeadingClassName: import("tailwind-variants").CnReturn;
+/** Identifies the disclosure trigger control. */
+export declare const accordionTriggerClassName: import("tailwind-variants").CnReturn;
+/** Identifies the expanded disclosure region. */
+export declare const accordionPanelClassName: import("tailwind-variants").CnReturn;
+/** Scroll owner around the joined disclosure rows. */
+export declare const accordionScrollRegionClassName: import("tailwind-variants").CnReturn;
+//# sourceMappingURL=classNames.d.ts.map

package/dist/core/branch/SurfaceAccordionCard/classNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceAccordionCard/classNames.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,sCAA0B,CAAA;AAC7D,wDAAwD;AACxD,eAAO,MAAM,0BAA0B,GAAI,SAAS,OAAO,yCAE1D,CAAA;AACD,qCAAqC;AACrC,eAAO,MAAM,qBAAqB,sCAAe,CAAA;AACjD,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,sCAAY,CAAA;AAClD,iDAAiD;AACjD,eAAO,MAAM,yBAAyB,sCAA4B,CAAA;AAClE,iDAAiD;AACjD,eAAO,MAAM,uBAAuB,sCAA0B,CAAA;AAC9D,sDAAsD;AACtD,eAAO,MAAM,8BAA8B,sCAA0B,CAAA"}

package/dist/core/branch/SurfaceAccordionCard/classNames.js

@@ -0,0 +1,16 @@
+import { cn } from "@heroui/react";
+/** Identifies the joined disclosure-card outer shell. */
+export const accordionCardClassName = cn("w-full", "min-w-0");
+/** Selects bounded or frameless disclosure surfaces. */
+export const getAccordionShellClassName = (bounded) => cn("w-full", "min-w-0", bounded ? "overflow-hidden" : "border-0", bounded ? undefined : "shadow-none");
+/** Identifies one disclosure row. */
+export const accordionRowClassName = cn("w-full");
+/** Identifies the semantic disclosure heading. */
+export const accordionHeadingClassName = cn("m-0");
+/** Identifies the disclosure trigger control. */
+export const accordionTriggerClassName = cn("w-full", "text-left");
+/** Identifies the expanded disclosure region. */
+export const accordionPanelClassName = cn("w-full", "min-w-0");
+/** Scroll owner around the joined disclosure rows. */
+export const accordionScrollRegionClassName = cn("w-full", "min-w-0");
+//# sourceMappingURL=classNames.js.map

package/dist/core/branch/SurfaceAccordionCard/classNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.js","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceAccordionCard/classNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,yDAAyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AAC7D,wDAAwD;AACxD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,OAAgB,EAAE,EAAE,CAAC,EAAE,CAC9D,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CACrG,CAAA;AACD,qCAAqC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAA;AACjD,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;AAClD,iDAAiD;AACjD,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;AAClE,iDAAiD;AACjD,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AAC9D,sDAAsD;AACtD,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA"}

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

@@ -0,0 +1,37 @@
+import { type ReactNode } from "react";
+export type SurfaceAccordionCardItem<Summary, Body> = {
+    readonly id: string;
+    readonly isOpen: boolean;
+    readonly isDisabled?: boolean;
+    readonly summaryRender: Summary;
+    readonly bodyRender: Body;
+};
+type SurfaceAccordionCardCommonProps<Summary, Body> = {
+    /** Top surfaces own elevation; nested surfaces own a subordinate border; omission is frameless. */
+    readonly depth?: "top" | "nested";
+    readonly renderSummary: (summary: Summary) => ReactNode;
+    readonly renderBody: (body: Body) => ReactNode;
+    /** Convenience capability: make the row region a HeroUI Vertical ScrollShadow. */
+    readonly isScrollable?: boolean;
+};
+export type SurfaceAccordionCardProps<Summary, Body> = SurfaceAccordionCardCommonProps<Summary, Body> & ({
+    readonly items: ReadonlyArray<SurfaceAccordionCardItem<Summary, Body>>;
+    readonly onItemOpenChange: (id: string, isOpen: boolean) => void;
+    readonly isOpen?: never;
+    readonly isDisabled?: never;
+    readonly summaryRender?: never;
+    readonly bodyRender?: never;
+    readonly onOpenChange?: never;
+} | {
+    readonly items?: never;
+    readonly onItemOpenChange?: never;
+    readonly isOpen: boolean;
+    readonly isDisabled?: boolean;
+    readonly summaryRender: Summary;
+    readonly bodyRender: Body;
+    readonly onOpenChange: (isOpen: boolean) => void;
+});
+/** Draw one full-width joined disclosure surface whose reusable anatomy is owned by Core Grammar. */
+export declare const SurfaceAccordionCard: <Summary, Body>(props: SurfaceAccordionCardProps<Summary, Body>) => import("react").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceAccordionCard/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAI7C,MAAM,MAAM,wBAAwB,CAAC,OAAO,EAAE,IAAI,IAAI;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;CAC5B,CAAA;AAED,KAAK,+BAA+B,CAAC,OAAO,EAAE,IAAI,IAAI;IAClD,mGAAmG;IACnG,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAA;IACvD,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,CAAA;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,yBAAyB,CAAC,OAAO,EAAE,IAAI,IAAI,+BAA+B,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC;IACrG,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;IACtE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAA;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAA;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAChC,GAAG;IACA,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;CACnD,CAAC,CAAA;AA0EF,qGAAqG;AACrG,eAAO,MAAM,oBAAoB,GAAI,OAAO,EAAE,IAAI,EAAE,OAAO,yBAAyB,CAAC,OAAO,EAAE,IAAI,CAAC,gCAwB9F,CAAA"}

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

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId } from "react";
+import { VerticalScrollRegion } from "../../composite/VerticalScrollRegion/index.js";
+import { accordionCardClassName, accordionHeadingClassName, accordionPanelClassName, accordionRowClassName, accordionScrollRegionClassName, getAccordionShellClassName, accordionTriggerClassName } from "./classNames.js";
+const SurfaceAccordionRows = ({ depth, items, renderSummary, renderBody, onItemOpenChange, isScrollable = false, }) => {
+    const ownerId = useId();
+    const bounded = depth !== undefined;
+    return (_jsx("div", { className: accordionCardClassName, "data-grammar-surface-accordion-card": "true", children: _jsx("div", { className: getAccordionShellClassName(bounded), "data-grammar-accordion-shell": "true", "data-grammar-scroll": isScrollable ? "contained" : "page", "data-grammar-surface": bounded ? "true" : undefined, "data-grammar-surface-depth": depth, "data-surface-context": depth === "nested" ? "nested" : depth === "top" ? "page" : undefined, children: _jsx(VerticalScrollRegion, { className: accordionScrollRegionClassName, isScrollable: isScrollable, children: items.map((item, index) => {
+                    const triggerId = `${ownerId}-trigger-${index}`;
+                    const panelId = `${ownerId}-panel-${index}`;
+                    return (_jsxs("div", { className: accordionRowClassName, "data-grammar-accordion-row": "true", "data-grammar-disclosure-state": item.isOpen ? "open" : "closed", children: [_jsx("h3", { className: accordionHeadingClassName, children: _jsx("button", { "aria-controls": panelId, "aria-expanded": item.isOpen, className: accordionTriggerClassName, disabled: item.isDisabled, id: triggerId, onClick: () => onItemOpenChange(item.id, !item.isOpen), type: "button", children: renderSummary(item.summaryRender) }) }), item.isOpen ? (_jsx("div", { "aria-labelledby": triggerId, className: accordionPanelClassName, id: panelId, role: "region", children: renderBody(item.bodyRender) })) : null] }, item.id));
+                }) }) }) }));
+};
+/** Draw one full-width joined disclosure surface whose reusable anatomy is owned by Core Grammar. */
+export const SurfaceAccordionCard = (props) => props.items === undefined
+    ? (_jsx(SurfaceAccordionRows, { ...(props.depth === undefined ? {} : { depth: props.depth }), items: [{
+                id: "surface-accordion-item",
+                isOpen: props.isOpen,
+                ...(props.isDisabled === undefined ? {} : { isDisabled: props.isDisabled }),
+                summaryRender: props.summaryRender,
+                bodyRender: props.bodyRender,
+            }], renderSummary: props.renderSummary, renderBody: props.renderBody, onItemOpenChange: (_id, isOpen) => props.onOpenChange(isOpen) }))
+    : (_jsx(SurfaceAccordionRows, { ...(props.depth === undefined ? {} : { depth: props.depth }), items: props.items, renderSummary: props.renderSummary, renderBody: props.renderBody, onItemOpenChange: props.onItemOpenChange }));
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/branch/SurfaceCard/classNames.d.ts

@@ -0,0 +1,13 @@
+/** Identifies the outer labelled surface-card anatomy. */
+export declare const surfaceCardClassName: import("tailwind-variants").CnReturn;
+/** Identifies the external label row of a surface card. */
+export declare const surfaceLabelClassName: import("tailwind-variants").CnReturn;
+/** Identifies the bounded surface content shell. */
+export declare const surfaceClassName: import("tailwind-variants").CnReturn;
+/** Identifies frameless surface content. */
+export declare const framelessSurfaceClassName: import("tailwind-variants").CnReturn;
+/** Identifies the content region inside a surface. */
+export declare const surfaceContentClassName: import("tailwind-variants").CnReturn;
+/** Selects the bounded or frameless surface treatment without changing anatomy. */
+export declare const getSurfaceFrameClassName: (frame: "bounded" | "frameless") => import("tailwind-variants").CnReturn;
+//# sourceMappingURL=classNames.d.ts.map

package/dist/core/branch/SurfaceCard/classNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceCard/classNames.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,sCAAoC,CAAA;AACrE,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,sCAAyD,CAAA;AAC3F,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,sCAAmC,CAAA;AAChE,4CAA4C;AAC5C,eAAO,MAAM,yBAAyB,sCAAmC,CAAA;AACzE,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,sCAAgB,CAAA;AAEpD,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,GAAI,OAAO,SAAS,GAAG,WAAW,yCAGtE,CAAA"}

package/dist/core/branch/SurfaceCard/classNames.js

@@ -0,0 +1,14 @@
+import { cn } from "@heroui/react";
+/** Identifies the outer labelled surface-card anatomy. */
+export const surfaceCardClassName = cn("flex", "min-w-0", "flex-col");
+/** Identifies the external label row of a surface card. */
+export const surfaceLabelClassName = cn("flex", "items-center", "justify-between", "gap-2");
+/** Identifies the bounded surface content shell. */
+export const surfaceClassName = cn("min-w-0", "overflow-hidden");
+/** Identifies frameless surface content. */
+export const framelessSurfaceClassName = cn("min-w-0", "overflow-hidden");
+/** Identifies the content region inside a surface. */
+export const surfaceContentClassName = cn("min-w-0");
+/** Selects the bounded or frameless surface treatment without changing anatomy. */
+export const getSurfaceFrameClassName = (frame) => cn("min-w-0", "overflow-hidden", frame === "frameless" ? "border-0" : undefined, frame === "frameless" ? "shadow-none" : undefined);
+//# sourceMappingURL=classNames.js.map

package/dist/core/branch/SurfaceCard/classNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.js","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceCard/classNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;AACrE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAA;AAC3F,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAA;AAChE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAA;AACzE,sDAAsD;AACtD,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;AAEpD,mFAAmF;AACnF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAA8B,EAAE,EAAE,CAAC,EAAE,CAC1E,SAAS,EAAE,iBAAiB,EAAE,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAC5E,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CACpD,CAAA"}

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

@@ -20,15 +20,18 @@ type SelfNamedSurfaceCard = {
 export type SurfaceCardProps = (LabelledSurfaceCard | SelfNamedSurfaceCard) & {
     readonly children: ReactNode;
     readonly fact?: string;
+    /** Optional content at the end of the external label row. It takes the fact's single place. */
+    readonly labelEnd?: ReactNode;
     readonly depth?: "top" | "nested";
     readonly state?: PresentationState;
     readonly wholeAction?: WholeCardAction;
+    /** Frameless content already owns its visible boundaries, so Core must not draw another shell. */
+    readonly frame?: "bounded" | "frameless";
+    /** Contained content has exactly one internal scroll owner. */
+    readonly scroll?: "page" | "contained";
+    /** Convenience capability: make the content region a HeroUI Vertical ScrollShadow. */
+    readonly isScrollable?: boolean;
 };
-export declare const SurfaceCard: ({ label, ariaLabel, children, fact, depth, state, wholeAction, }: SurfaceCardProps) => import("react").JSX.Element;
-export declare const meta: {
-    readonly shape: "branch";
-    readonly grammar: "core";
-    readonly contract: "core.branch.surface-card";
-};
+export declare const SurfaceCard: (props: SurfaceCardProps) => import("react").JSX.Element;
 export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceCard/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAE9F,MAAM,MAAM,eAAe,GACrB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACzB,GACC;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACzB,CAAA;AAEL,KAAK,mBAAmB,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,KAAK,oBAAoB,GAAG;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,mBAAmB,GAAG,oBAAoB,CAAC,GAAG;IAC1E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAA;CACzC,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,kEAQzB,gBAAgB,gCAiDlB,CAAA;AAED,eAAO,MAAM,IAAI;;;;CAAsF,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceCard/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAI9F,MAAM,MAAM,eAAe,GACrB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACzB,GACC;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACzB,CAAA;AAEL,KAAK,mBAAmB,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,KAAK,oBAAoB,GAAG;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,mBAAmB,GAAG,oBAAoB,CAAC,GAAG;IAC1E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAA;IACtC,kGAAkG;IAClG,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,WAAW,CAAA;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;IACtC,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAClC,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,gBAAgB,gCAwElD,CAAA"}

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

@@ -1,14 +1,18 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useId } from "react";
 import { assertPresentationState, treatmentFor } from "../../state.js";
-export const SurfaceCard = ({ label, ariaLabel, children, fact, depth = "top", state = "neutral", wholeAction, }) => {
+import { VerticalScrollRegion } from "../../composite/VerticalScrollRegion/index.js";
+import { getSurfaceFrameClassName, surfaceCardClassName, surfaceContentClassName, surfaceLabelClassName } from "./classNames.js";
+export const SurfaceCard = (props) => {
+    const { label, ariaLabel, children, fact, labelEnd, depth = "top", state = "neutral", wholeAction, frame = "bounded", scroll = "page", isScrollable = false, } = props;
     assertPresentationState(state);
     const headingId = useId();
     const treatment = treatmentFor(state);
     const disabled = state === "unavailable" || state === "pending";
     const accessibleName = ariaLabel ?? label;
+    const contained = isScrollable || scroll === "contained";
     const action = wholeAction?.kind === "link" ? (_jsx("a", { "aria-disabled": disabled || undefined, "aria-label": wholeAction.label, "data-grammar-whole-action": "link", href: disabled ? undefined : wholeAction.href, tabIndex: disabled ? -1 : undefined })) : wholeAction?.kind === "button" ? (_jsx("button", { "aria-label": wholeAction.label, "data-grammar-whole-action": "button", disabled: disabled, onClick: wholeAction.press, type: "button" })) : null;
-    return (_jsxs("section", { className: "starci-core-surface-card", "data-grammar-surface-card": "true", children: [label === undefined ? null : (_jsxs("div", { className: "starci-core-surface-label", "data-grammar-surface-label": "true", children: [_jsx("h3", { id: headingId, children: label }), fact === undefined ? null : _jsx("span", { children: fact })] })), _jsxs("div", { "aria-label": label === undefined ? accessibleName : undefined, "aria-labelledby": label === undefined ? undefined : headingId, className: "starci-core-surface", "data-grammar-state": state, "data-grammar-surface": "true", "data-grammar-surface-depth": depth, "data-grammar-treatment": treatment.tone, children: [_jsx("div", { className: "starci-core-surface-content", "data-grammar-surface-content": "true", children: children }), action] })] }));
+    const surface = (_jsxs("div", { "aria-label": label === undefined ? accessibleName : undefined, "aria-labelledby": label === undefined ? undefined : headingId, className: getSurfaceFrameClassName(frame), "data-grammar-frame": frame, "data-grammar-scroll": contained ? "contained" : "page", "data-grammar-state": state, "data-grammar-surface-depth": depth, "data-grammar-treatment": treatment.tone, children: [_jsx(VerticalScrollRegion, { className: surfaceContentClassName, "data-grammar-surface-content": "true", isScrollable: contained, children: children }), action] }));
+    return (_jsxs("section", { className: surfaceCardClassName, "data-grammar-frame": frame, "data-grammar-surface-card": "true", children: [label === undefined ? null : (_jsxs("div", { className: surfaceLabelClassName, "data-grammar-surface-label": "true", children: [_jsx("h3", { id: headingId, children: label }), labelEnd ?? (fact === undefined ? null : _jsx("span", { children: fact }))] })), surface] }));
 };
-export const meta = { shape: "branch", grammar: "core", contract: "core.branch.surface-card" };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceCard/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAA;AAgC9F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EACxB,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,KAAK,GAAG,KAAK,EACb,KAAK,GAAG,SAAS,EACjB,WAAW,GACI,EAAE,EAAE;IACnB,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAC9B,MAAM,SAAS,GAAG,KAAK,EAAE,CAAA;IACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,MAAM,QAAQ,GAAG,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,SAAS,CAAA;IAC/D,MAAM,cAAc,GAAG,SAAS,IAAI,KAAK,CAAA;IAEzC,MAAM,MAAM,GAAG,WAAW,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAC1C,6BACmB,QAAQ,IAAI,SAAS,gBACxB,WAAW,CAAC,KAAK,+BACH,MAAM,EAChC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAC7C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GACrC,CACL,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CACjC,+BACgB,WAAW,CAAC,KAAK,+BACH,QAAQ,EAClC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,WAAW,CAAC,KAAK,EAC1B,IAAI,EAAC,QAAQ,GACf,CACL,CAAC,CAAC,CAAC,IAAI,CAAA;IAER,OAAO,CACH,mBAAS,SAAS,EAAC,0BAA0B,+BAA2B,MAAM,aACzE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1B,eAAK,SAAS,EAAC,2BAA2B,gCAA4B,MAAM,aACxE,aAAI,EAAE,EAAE,SAAS,YAAG,KAAK,GAAM,EAC9B,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAO,IAAI,GAAQ,IAC9C,CACT,EACD,6BACgB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,qBAC3C,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAC5D,SAAS,EAAC,qBAAqB,wBACX,KAAK,0BACJ,MAAM,gCACC,KAAK,4BACT,SAAS,CAAC,IAAI,aAEtC,cAAK,SAAS,EAAC,6BAA6B,kCAA8B,MAAM,YAC3E,QAAQ,GACP,EACL,MAAM,IACL,IACA,CACb,CAAA;AACL,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,EAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceCard/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAA;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAA;AACpF,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAwChI,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAuB,EAAE,EAAE;IACnD,MAAM,EACF,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,KAAK,GAAG,KAAK,EACb,KAAK,GAAG,SAAS,EACjB,WAAW,EACX,KAAK,GAAG,SAAS,EACjB,MAAM,GAAG,MAAM,EACf,YAAY,GAAG,KAAK,GACvB,GAAG,KAAK,CAAA;IACT,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAC9B,MAAM,SAAS,GAAG,KAAK,EAAE,CAAA;IACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,MAAM,QAAQ,GAAG,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,SAAS,CAAA;IAC/D,MAAM,cAAc,GAAG,SAAS,IAAI,KAAK,CAAA;IACzC,MAAM,SAAS,GAAG,YAAY,IAAI,MAAM,KAAK,WAAW,CAAA;IAExD,MAAM,MAAM,GAAG,WAAW,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAC1C,6BACmB,QAAQ,IAAI,SAAS,gBACxB,WAAW,CAAC,KAAK,+BACH,MAAM,EAChC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAC7C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GACrC,CACL,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CACjC,+BACgB,WAAW,CAAC,KAAK,+BACH,QAAQ,EAClC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,WAAW,CAAC,KAAK,EAC1B,IAAI,EAAC,QAAQ,GACf,CACL,CAAC,CAAC,CAAC,IAAI,CAAA;IAER,MAAM,OAAO,GAAG,CACZ,6BACgB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,qBAC3C,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAC5D,SAAS,EAAE,wBAAwB,CAAC,KAAK,CAAC,wBACtB,KAAK,yBACJ,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,wBACjC,KAAK,gCACG,KAAK,4BACT,SAAS,CAAC,IAAI,aAEtC,KAAC,oBAAoB,IAAC,SAAS,EAAE,uBAAuB,kCAA+B,MAAM,EAAC,YAAY,EAAE,SAAS,YAChH,QAAQ,GACU,EACtB,MAAM,IACL,CACT,CAAA;IAED,OAAO,CACH,mBACI,SAAS,EAAE,oBAAoB,wBACX,KAAK,+BACC,MAAM,aAE/B,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1B,eAAK,SAAS,EAAE,qBAAqB,gCAA6B,MAAM,aACpE,aAAI,EAAE,EAAE,SAAS,YAAG,KAAK,GAAM,EAC9B,QAAQ,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAO,IAAI,GAAQ,CAAC,IAC5D,CACT,EACA,OAAO,IACF,CACb,CAAA;AACL,CAAC,CAAA"}

package/dist/core/branch/SurfaceListCard/classNames.d.ts

@@ -0,0 +1,11 @@
+/** Identifies the outer surface-list anatomy. */
+export declare const surfaceListClassName: import("tailwind-variants").CnReturn;
+/** Identifies the external label row shared by surface branches. */
+export declare const surfaceLabelClassName: import("tailwind-variants").CnReturn;
+/** Identifies the list's bounded surface shell. */
+export declare const listShellClassName: import("tailwind-variants").CnReturn;
+/** Identifies the optional footer region. */
+export declare const surfaceFooterClassName: import("tailwind-variants").CnReturn;
+/** Selects the collection treatment for verdict and ordinary lists. */
+export declare const getCollectionClassName: (isVerdict: boolean) => import("tailwind-variants").CnReturn;
+//# sourceMappingURL=classNames.d.ts.map

package/dist/core/branch/SurfaceListCard/classNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceListCard/classNames.ts"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,eAAO,MAAM,oBAAoB,sCAAoC,CAAA;AACrE,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,sCAAyD,CAAA;AAC3F,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,sCAAmC,CAAA;AAClE,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,sCAA6B,CAAA;AAChE,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,GAAI,WAAW,OAAO,yCAAyD,CAAA"}

package/dist/core/branch/SurfaceListCard/classNames.js

@@ -0,0 +1,12 @@
+import { cn } from "@heroui/react";
+/** Identifies the outer surface-list anatomy. */
+export const surfaceListClassName = cn("flex", "min-w-0", "flex-col");
+/** Identifies the external label row shared by surface branches. */
+export const surfaceLabelClassName = cn("flex", "items-center", "justify-between", "gap-2");
+/** Identifies the list's bounded surface shell. */
+export const listShellClassName = cn("min-w-0", "overflow-hidden");
+/** Identifies the optional footer region. */
+export const surfaceFooterClassName = cn("flex", "items-center");
+/** Selects the collection treatment for verdict and ordinary lists. */
+export const getCollectionClassName = (isVerdict) => cn("w-full", isVerdict ? "rounded-none" : undefined);
+//# sourceMappingURL=classNames.js.map

package/dist/core/branch/SurfaceListCard/classNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.js","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceListCard/classNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,iDAAiD;AACjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;AACrE,oEAAoE;AACpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAA;AAC3F,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAA;AAClE,6CAA6C;AAC7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAChE,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA"}

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

@@ -1,10 +1,4 @@
-import { type PresentationState } from "../../state.js";
-export type SurfaceListItem = {
-    readonly id: string;
-    readonly label: string;
-    readonly description?: string;
-    readonly state?: PresentationState;
-};
+import { type ReactNode } from "react";
 type LabelledSurfaceList = {
     readonly label: string;
     readonly ariaLabel?: string;
@@ -13,17 +7,19 @@ type SelfNamedSurfaceList = {
     readonly label?: undefined;
     readonly ariaLabel: string;
 };
-export type SurfaceListCardProps = (LabelledSurfaceList | SelfNamedSurfaceList) & {
-    readonly items: ReadonlyArray<SurfaceListItem>;
+type SurfaceListFrameProps = (LabelledSurfaceList | SelfNamedSurfaceList) & {
     readonly fact?: string;
+    readonly labelEnd?: ReactNode;
+    readonly labelHidden?: boolean;
+    readonly footer?: ReactNode;
     readonly depth?: "top" | "nested";
-    readonly emptyLabel?: string;
+    readonly isLoading?: boolean;
+    readonly isVerdict?: boolean;
+    readonly isScrollable?: boolean;
 };
-export declare const SurfaceListCard: ({ label, ariaLabel, items, fact, depth, emptyLabel, }: SurfaceListCardProps) => import("react").JSX.Element;
-export declare const meta: {
-    readonly shape: "branch";
-    readonly grammar: "core";
-    readonly contract: "core.branch.surface-list-card";
+export type SurfaceListCardProps = SurfaceListFrameProps & {
+    readonly children: ReactNode;
 };
+export declare const SurfaceListCard: (props: SurfaceListCardProps) => import("react").JSX.Element;
 export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceListCard/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAE9F,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;CACrC,CAAA;AAED,KAAK,mBAAmB,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,KAAK,oBAAoB,GAAG;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,mBAAmB,GAAG,oBAAoB,CAAC,GAAG;IAC9E,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC/B,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,uDAO7B,oBAAoB,gCA+CtB,CAAA;AAED,eAAO,MAAM,IAAI;;;;CAA2F,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceListCard/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAI7C,KAAK,mBAAmB,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,KAAK,oBAAoB,GAAG;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,KAAK,qBAAqB,GAAG,CAAC,mBAAmB,GAAG,oBAAoB,CAAC,GAAG;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,GAAG;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAC/B,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,gCAqD1D,CAAA"}

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

@@ -1,16 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useId } from "react";
-import { StateMark } from "../../StateMark.js";
-import { assertPresentationState, treatmentFor } from "../../state.js";
-export const SurfaceListCard = ({ label, ariaLabel, items, fact, depth = "top", emptyLabel = "No items", }) => {
+import { VerticalScrollRegion } from "../../composite/VerticalScrollRegion/index.js";
+import { getCollectionClassName, listShellClassName, surfaceFooterClassName, surfaceLabelClassName, surfaceListClassName } from "./classNames.js";
+export const SurfaceListCard = (props) => {
+    const { label, ariaLabel, children, fact, labelEnd, labelHidden = false, footer, depth = "top", isLoading = false, isVerdict = false, isScrollable = false, } = props;
     const headingId = useId();
-    for (const item of items)
-        assertPresentationState(item.state ?? "neutral");
-    return (_jsxs("section", { className: "starci-core-surface-list", "data-grammar-surface-list": "true", children: [label === undefined ? null : (_jsxs("div", { className: "starci-core-surface-label", "data-grammar-surface-label": "true", children: [_jsx("h3", { id: headingId, children: label }), fact === undefined ? null : _jsx("span", { children: fact })] })), _jsx("div", { "aria-label": label === undefined ? ariaLabel : undefined, "aria-labelledby": label === undefined ? undefined : headingId, className: "starci-core-surface starci-core-list-shell", "data-grammar-surface": "true", "data-grammar-surface-depth": depth, children: items.length === 0 ? (_jsx("p", { className: "starci-core-empty-row", "data-grammar-state": "neutral", children: emptyLabel })) : (_jsx("ul", { className: "starci-core-static-list", "data-grammar-list": "true", children: items.map((item) => {
-                        const state = item.state ?? "neutral";
-                        const treatment = treatmentFor(state);
-                        return (_jsxs("li", { className: "starci-core-static-row", "data-grammar-row": "true", "data-grammar-state": state, "data-grammar-treatment": treatment.tone, children: [_jsx(StateMark, { state: state }), _jsxs("span", { className: "starci-core-static-row-copy", children: [_jsx("span", { children: item.label }), item.description === undefined ? null : _jsx("span", { children: item.description })] })] }, item.id));
-                    }) })) })] }));
+    const accessibleName = ariaLabel ?? label;
+    return (_jsxs("section", { className: surfaceListClassName, "data-grammar-label-visibility": labelHidden ? "hidden" : "visible", "data-grammar-surface-list": "true", children: [label === undefined || labelHidden ? null : (_jsxs("div", { className: surfaceLabelClassName, "data-grammar-surface-label": "true", children: [_jsx("h3", { id: headingId, children: label }), labelEnd ?? (fact === undefined ? null : _jsx("span", { children: fact }))] })), _jsx("div", { "aria-label": labelHidden || label === undefined ? accessibleName : undefined, "aria-labelledby": !labelHidden && label !== undefined ? headingId : undefined, className: listShellClassName, "data-grammar-surface": "true", "data-grammar-scroll": isScrollable ? "contained" : "page", "data-grammar-surface-depth": depth, "data-surface-context": depth === "nested" ? "nested" : "page", "data-verdict": String(isVerdict), children: _jsx(VerticalScrollRegion, { className: getCollectionClassName(isVerdict), "data-grammar-list": "true", "data-loading": String(isLoading), isScrollable: isScrollable, children: children }) }), footer === undefined ? null : (_jsx("div", { className: surfaceFooterClassName, "data-grammar-surface-footer": "true", children: footer }))] }));
 };
-export const meta = { shape: "branch", grammar: "core", contract: "core.branch.surface-list-card" };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceListCard/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAA;AA0B9F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC5B,KAAK,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,KAAK,GAAG,KAAK,EACb,UAAU,GAAG,UAAU,GACJ,EAAE,EAAE;IACvB,MAAM,SAAS,GAAG,KAAK,EAAE,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,uBAAuB,CAAC,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,CAAA;IAE1E,OAAO,CACH,mBAAS,SAAS,EAAC,0BAA0B,+BAA2B,MAAM,aACzE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1B,eAAK,SAAS,EAAC,2BAA2B,gCAA4B,MAAM,aACxE,aAAI,EAAE,EAAE,SAAS,YAAG,KAAK,GAAM,EAC9B,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAO,IAAI,GAAQ,IAC9C,CACT,EACD,4BACgB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,qBACtC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAC5D,SAAS,EAAC,4CAA4C,0BACjC,MAAM,gCACC,KAAK,YAEhC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAClB,YAAG,SAAS,EAAC,uBAAuB,wBAAoB,SAAS,YAAE,UAAU,GAAK,CACrF,CAAC,CAAC,CAAC,CACA,aAAI,SAAS,EAAC,yBAAyB,uBAAmB,MAAM,YAC3D,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;wBAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAA;wBACrC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;wBACrC,OAAO,CACH,cACI,SAAS,EAAC,wBAAwB,sBACjB,MAAM,wBACH,KAAK,4BACD,SAAS,CAAC,IAAI,aAGtC,KAAC,SAAS,IAAC,KAAK,EAAE,KAAK,GAAI,EAC3B,gBAAM,SAAS,EAAC,6BAA6B,aACzC,yBAAO,IAAI,CAAC,KAAK,GAAQ,EACxB,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAO,IAAI,CAAC,WAAW,GAAQ,IACrE,KANF,IAAI,CAAC,EAAE,CAOX,CACR,CAAA;oBACL,CAAC,CAAC,GACD,CACR,GACC,IACA,CACb,CAAA;AACL,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,+BAA+B,EAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/SurfaceListCard/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAA;AACpF,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AA2BjJ,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE;IAC3D,MAAM,EACF,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,WAAW,GAAG,KAAK,EACnB,MAAM,EACN,KAAK,GAAG,KAAK,EACb,SAAS,GAAG,KAAK,EACjB,SAAS,GAAG,KAAK,EACjB,YAAY,GAAG,KAAK,GACvB,GAAG,KAAK,CAAA;IACT,MAAM,SAAS,GAAG,KAAK,EAAE,CAAA;IACzB,MAAM,cAAc,GAAG,SAAS,IAAI,KAAK,CAAA;IAEzC,OAAO,CACH,mBACI,SAAS,EAAE,oBAAoB,mCACA,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,+BACvC,MAAM,aAE/B,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACzC,eAAK,SAAS,EAAE,qBAAqB,gCAA6B,MAAM,aACpE,aAAI,EAAE,EAAE,SAAS,YAAG,KAAK,GAAM,EAC9B,QAAQ,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAO,IAAI,GAAQ,CAAC,IAC5D,CACT,EACD,4BACgB,WAAW,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,qBAC1D,CAAC,WAAW,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAC5E,SAAS,EAAE,kBAAkB,0BACR,MAAM,yBACN,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,gCAC5B,KAAK,0BACX,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,kBAC9C,MAAM,CAAC,SAAS,CAAC,YAE/B,KAAC,oBAAoB,IACjB,SAAS,EAAE,sBAAsB,CAAC,SAAS,CAAC,uBAC1B,MAAM,kBACV,MAAM,CAAC,SAAS,CAAC,EAC/B,YAAY,EAAE,YAAY,YAEzB,QAAQ,GACU,GACrB,EACL,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3B,cAAK,SAAS,EAAE,sBAAsB,iCAA8B,MAAM,YAAE,MAAM,GAAO,CAC5F,IACK,CACb,CAAA;AACL,CAAC,CAAA"}

package/dist/core/classNames.d.ts

@@ -0,0 +1,23 @@
+/** Identifies the compact state mark in the offset-pop visual layer. */
+export declare const stateMarkClassName: import("tailwind-variants").CnReturn;
+/** Identifies the quiet ordinal prefix used by ordered content. */
+export declare const leadingNumberClassName: import("tailwind-variants").CnReturn;
+/** Identifies one static state row shell. */
+export declare const staticRowClassName: import("tailwind-variants").CnReturn;
+/** Identifies the text grouping inside a static state row. */
+export declare const staticRowCopyClassName: import("tailwind-variants").CnReturn;
+/** Identifies the full page that centres one compact form surface. */
+export declare const formPageClassName: import("tailwind-variants").CnReturn;
+/** Identifies the bounded viewport that owns form-surface scrolling under zoom. */
+export declare const formScrollViewportClassName: import("tailwind-variants").CnReturn;
+/** Identifies a form card whose inset belongs to its content region. */
+export declare const formSurfaceClassName: import("tailwind-variants").CnReturn;
+/** Narrows only a form state whose own content remains comfortable at the compact measure. */
+export declare const formCompactSurfaceClassName: import("tailwind-variants").CnReturn;
+/** Identifies the vertical label-control-help anatomy of one form field. */
+export declare const formFieldClassName: import("tailwind-variants").CnReturn;
+/** Identifies a semantic form label that remains available only to assistive technology. */
+export declare const formScreenReaderLabelClassName: import("tailwind-variants").CnReturn;
+/** Identifies content whose intrinsic inline measure must scroll instead of being compressed. */
+export declare const horizontalScrollRegionClassName: import("tailwind-variants").CnReturn;
+//# sourceMappingURL=classNames.d.ts.map

package/dist/core/classNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.d.ts","sourceRoot":"","sources":["../../src/core/classNames.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,sCAA2B,CAAA;AAC1D,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,sCAAyC,CAAA;AAC5E,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,sCAA6C,CAAA;AAC5E,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,sCAA6C,CAAA;AAEhF,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,sCAA8B,CAAA;AAC5D,mFAAmF;AACnF,eAAO,MAAM,2BAA2B,sCAAyC,CAAA;AACjF,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,sCAAiC,CAAA;AAClE,8FAA8F;AAC9F,eAAO,MAAM,2BAA2B,sCAA0C,CAAA;AAClF,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,sCAA+B,CAAA;AAC9D,4FAA4F;AAC5F,eAAO,MAAM,8BAA8B,sCAA8C,CAAA;AACzF,iGAAiG;AACjG,eAAO,MAAM,+BAA+B,sCAA6C,CAAA"}

package/dist/core/classNames.js

@@ -0,0 +1,24 @@
+import { cn } from "@heroui/react";
+/** Identifies the compact state mark in the offset-pop visual layer. */
+export const stateMarkClassName = cn("size-5", "shrink-0");
+/** Identifies the quiet ordinal prefix used by ordered content. */
+export const leadingNumberClassName = cn("shrink-0", "font-mono", "text-sm");
+/** Identifies one static state row shell. */
+export const staticRowClassName = cn("flex", "items-start", "gap-2", "py-2");
+/** Identifies the text grouping inside a static state row. */
+export const staticRowCopyClassName = cn("flex", "min-w-0", "flex-col", "gap-1");
+/** Identifies the full page that centres one compact form surface. */
+export const formPageClassName = cn("starci-core-form-page");
+/** Identifies the bounded viewport that owns form-surface scrolling under zoom. */
+export const formScrollViewportClassName = cn("starci-core-form-scroll-viewport");
+/** Identifies a form card whose inset belongs to its content region. */
+export const formSurfaceClassName = cn("starci-core-form-surface");
+/** Narrows only a form state whose own content remains comfortable at the compact measure. */
+export const formCompactSurfaceClassName = cn("starci-core-form-surface--compact");
+/** Identifies the vertical label-control-help anatomy of one form field. */
+export const formFieldClassName = cn("starci-core-form-field");
+/** Identifies a semantic form label that remains available only to assistive technology. */
+export const formScreenReaderLabelClassName = cn("starci-core-form-label--screen-reader");
+/** Identifies content whose intrinsic inline measure must scroll instead of being compressed. */
+export const horizontalScrollRegionClassName = cn("starci-core-horizontal-scroll-region");
+//# sourceMappingURL=classNames.js.map

package/dist/core/classNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.js","sourceRoot":"","sources":["../../src/core/classNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;AAC1D,mEAAmE;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;AAC5E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;AAC5E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;AAEhF,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,uBAAuB,CAAC,CAAA;AAC5D,mFAAmF;AACnF,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC,kCAAkC,CAAC,CAAA;AACjF,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,0BAA0B,CAAC,CAAA;AAClE,8FAA8F;AAC9F,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC,mCAAmC,CAAC,CAAA;AAClF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC,wBAAwB,CAAC,CAAA;AAC9D,4FAA4F;AAC5F,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC,uCAAuC,CAAC,CAAA;AACzF,iGAAiG;AACjG,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC,sCAAsC,CAAC,CAAA"}

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

@@ -0,0 +1,7 @@
+import { type ComponentProps, type ReactNode } from "react";
+export type HorizontalScrollRegionProps = Omit<ComponentProps<"div">, "children"> & {
+    readonly children: ReactNode;
+};
+/** Preserve intrinsic inline content and expose HeroUI's horizontal overflow affordance. */
+export declare const HorizontalScrollRegion: import("react").ForwardRefExoticComponent<Omit<HorizontalScrollRegionProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=index.d.ts.map