@starci/grammar 0.1.0 → 0.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 StarCi
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 StarCi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,42 +1,55 @@
-# `@starci/grammar`
-
-Business-neutral UI contracts and versioned StarCi Grammar bundles.
-
-## Public entry points
-
-- `@starci/grammar/common` — contract kernel and runtime validation.
-- `@starci/grammar/core` — generic StarCi owners and base contracts.
-- `@starci/grammar/offset-pop` — one declared visual extension of Core.
-- `@starci/grammar/common/styles.css`, `core/styles.css`, `offset-pop/styles.css` — canonical cascade entries. Short `.css` aliases are also exported.
-
-Install this workspace package while it is under development. Published consumers must pin one
-exact version rather than a range:
-
-```sh
-npm install ./packages/grammar
-# after publication: npm install --save-exact @starci/grammar@0.1.0
-```
-
-```ts
-import { createContractRegistry } from "@starci/grammar/common"
-import { CORE_COMPONENT_CONTRACTS } from "@starci/grammar/core"
-import { offsetPopGrammar } from "@starci/grammar/offset-pop"
-```
-
-```css
-@import "@starci/grammar/common/styles.css";
-@import "@starci/grammar/core/styles.css";
-@import "@starci/grammar/offset-pop/styles.css";
-```
-
+# `@starci/grammar`
+
+Business-neutral UI contracts and versioned StarCi Grammar bundles.
+
+## Public entry points
+
+- `@starci/grammar/common` — contract kernel and runtime validation.
+- `@starci/grammar/core` — batteries-included, product-neutral leaves, composites, branches, layout capabilities and base contracts.
+- `@starci/grammar/offset-pop` — one declared visual extension of Core.
+- `@starci/grammar/common/styles.css`, `core/styles.css`, `offset-pop/styles.css` — canonical cascade entries. Short `.css` aliases are also exported.
+
+Install this workspace package while it is under development. Published consumers must pin one
+exact version rather than a range:
+
+```sh
+npm install ./packages/grammar
+# after publication: npm install --save-exact @starci/grammar@0.2.0
+```
+
+```ts
+import { createContractRegistry } from "@starci/grammar/common"
+import { CORE_COMPONENT_CONTRACTS } from "@starci/grammar/core"
+import { offsetPopGrammar } from "@starci/grammar/offset-pop"
+```
+
+```css
+@import "@starci/grammar/common/styles.css";
+@import "@starci/grammar/core/styles.css";
+@import "@starci/grammar/offset-pop/styles.css";
+```
+
 `common` contains no React, Next.js, business entity, operation or domain state. A Product Block translates domain state into `PresentationState`; Grammar consumes only that neutral state.
 
-Contracts are immutable. Extensions may resolve only axes explicitly opened by the base contract. They cannot replace anatomy, mutate a closed invariant, substitute the owner or silently replace a duplicate registry key.
-
-## Package checks
-
-```sh
-npm run typecheck
-npm test
-npm pack --dry-run
-```
+Core owners expose additive, business-neutral capabilities without opening their anatomy:
+
+- `StateMark` is a Core leaf for neutral presentation-state marks.
+- `StaticStateRow` is a Core composite for one non-interactive row in a Core-owned collection.
+- `SurfaceCard` supports bounded/frameless frames, page/contained scrolling and one label-end slot.
+- `SurfaceListCard` supports Core-owned static rows or a content-owned interactive collection, an accessible hidden label and one footer.
+- `Rail` supports a Core-owned complementary landmark or one content-owned navigation landmark, plus expanded/collapsed and motion/reduced-motion declarations.
+
+`CORE_LAYOUT_CLASS_NAMES` is the closed product-neutral layout vocabulary. Product breakpoints,
+token names and selectors remain in the consuming application's contract registry.
+
+Adapters must bind directly to the `core.*` contract identity and emit the canonical `data-grammar-*` anatomy. A product-prefixed contract with no resolved Core axis is not a substitute for conformance.
+
+Contracts are immutable. Extensions may resolve only axes explicitly opened by the base contract. They cannot replace anatomy, mutate a closed invariant, substitute the owner or silently replace a duplicate registry key.
+
+## Package checks
+
+```sh
+npm run typecheck
+npm test
+npm pack --dry-run
+```

package/dist/common/styles.css

@@ -1,2 +1,2 @@
-/* Establish one deterministic cascade without owning product colour or business meaning. */
-@layer starci-grammar-common, starci-grammar-core, starci-grammar-extension;
+/* Establish one deterministic cascade without owning product colour or business meaning. */
+@layer starci-grammar-common, starci-grammar-core, starci-grammar-extension;

package/dist/core/StateMark.d.ts

@@ -3,4 +3,8 @@ export type StateMarkProps = {
     readonly state: PresentationState;
 };
 export declare const StateMark: ({ state }: StateMarkProps) => import("react").JSX.Element | null;
+export declare const meta: {
+    readonly shape: "leaf";
+    readonly grammar: "core";
+};
 //# sourceMappingURL=StateMark.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StateMark.d.ts","sourceRoot":"","sources":["../../src/core/StateMark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAGnD,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CACpC,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,WAAW,cAAc,uCAclD,CAAA"}
+{"version":3,"file":"StateMark.d.ts","sourceRoot":"","sources":["../../src/core/StateMark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAGnD,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CACpC,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,WAAW,cAAc,uCAclD,CAAA;AAED,eAAO,MAAM,IAAI;;;CAA8C,CAAA"}

package/dist/core/StateMark.js

@@ -6,4 +6,5 @@ export const StateMark = ({ state }) => {
         return null;
     return (_jsx("svg", { "aria-hidden": "true", "data-grammar-state-mark": "check", focusable: "false", viewBox: "0 0 20 20", children: _jsx("path", { d: "M5 10.5 8.25 14 15 6.5", fill: "none", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "2" }) }));
 };
+export const meta = { shape: "leaf", grammar: "core" };
 //# sourceMappingURL=StateMark.js.map

package/dist/core/StateMark.js.map

@@ -1 +1 @@
-{"version":3,"file":"StateMark.js","sourceRoot":"","sources":["../../src/core/StateMark.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAMzC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAE,KAAK,EAAkB,EAAE,EAAE;IACnD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAA;IAE3C,OAAO,CACH,6BACgB,MAAM,6BACM,OAAO,EAC/B,SAAS,EAAC,OAAO,EACjB,OAAO,EAAC,WAAW,YAEnB,eAAM,CAAC,EAAC,wBAAwB,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,EAAC,cAAc,EAAC,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,WAAW,EAAC,GAAG,GAAG,GAChI,CACT,CAAA;AACL,CAAC,CAAA"}
+{"version":3,"file":"StateMark.js","sourceRoot":"","sources":["../../src/core/StateMark.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAMzC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAE,KAAK,EAAkB,EAAE,EAAE;IACnD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAA;IAE3C,OAAO,CACH,6BACgB,MAAM,6BACM,OAAO,EAC/B,SAAS,EAAC,OAAO,EACjB,OAAO,EAAC,WAAW,YAEnB,eAAM,CAAC,EAAC,wBAAwB,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,EAAC,cAAc,EAAC,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,WAAW,EAAC,GAAG,GAAG,GAChI,CACT,CAAA;AACL,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAW,CAAA"}

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

@@ -1,17 +1,28 @@
 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;
     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 Rail: ({ label, landmark, children, footer, mode, width, state, collapse, motion, }: RailProps) => import("react").JSX.Element;
 export declare const meta: {
     readonly shape: "branch";
     readonly grammar: "core";
     readonly contract: "core.branch.rail";
 };
+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;AAE9F,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,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,8EAUlB,SAAS,gCAoCX,CAAA;AAED,eAAO,MAAM,IAAI;;;;CAA8E,CAAA"}

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

@@ -1,11 +1,26 @@
 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", }) => {
+export const Rail = ({ label, landmark = "complementary", children, footer, mode = "flow", width = "standard", state = "neutral", collapse = "expanded", motion = "static", }) => {
     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: "starci-core-rail-frame", "data-grammar-rail-frame": "true", children: [landmark === "content-navigation" ? null : _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 shared = {
+        className: "starci-core-rail",
+        "data-grammar-collapse": collapse,
+        "data-grammar-contract": "core.rail",
+        "data-grammar-landmark": landmark,
+        "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;AAuB9F,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,EACjB,KAAK,EACL,QAAQ,GAAG,eAAe,EAC1B,QAAQ,EACR,MAAM,EACN,IAAI,GAAG,MAAM,EACb,KAAK,GAAG,UAAU,EAClB,KAAK,GAAG,SAAS,EACjB,QAAQ,GAAG,UAAU,EACrB,MAAM,GAAG,QAAQ,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,MAAM,KAAK,GAAG,CACV,eAAK,SAAS,EAAC,wBAAwB,6BAAyB,MAAM,aACjE,QAAQ,KAAK,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0CAA8B,MAAM,EAAC,EAAE,EAAE,SAAS,YAAG,KAAK,GAAM,EAC5G,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,CACT,CAAA;IACD,MAAM,MAAM,GAAG;QACX,SAAS,EAAE,kBAAkB;QAC7B,uBAAuB,EAAE,QAAQ;QACjC,uBAAuB,EAAE,WAAW;QACpC,uBAAuB,EAAE,QAAQ;QACjC,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;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAW,CAAA"}

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

@@ -20,11 +20,17 @@ 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";
 };
-export declare const SurfaceCard: ({ label, ariaLabel, children, fact, depth, state, wholeAction, }: SurfaceCardProps) => import("react").JSX.Element;
+export declare const SurfaceCard: ({ label, ariaLabel, children, fact, labelEnd, depth, state, wholeAction, frame, scroll, }: SurfaceCardProps) => import("react").JSX.Element;
 export declare const meta: {
     readonly shape: "branch";
     readonly grammar: "core";

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;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,+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;CACzC,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,2FAWzB,gBAAgB,gCA4DlB,CAAA;AAED,eAAO,MAAM,IAAI;;;;CAAsF,CAAA"}

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

@@ -1,14 +1,15 @@
 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, }) => {
+export const SurfaceCard = ({ label, ariaLabel, children, fact, labelEnd, depth = "top", state = "neutral", wholeAction, frame = "bounded", scroll = "page", }) => {
     assertPresentationState(state);
     const headingId = useId();
     const treatment = treatmentFor(state);
     const disabled = state === "unavailable" || state === "pending";
     const accessibleName = ariaLabel ?? label;
     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: frame === "bounded" ? "starci-core-surface" : "starci-core-surface starci-core-frameless-surface", "data-grammar-frame": frame, "data-grammar-scroll": scroll, "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] }));
+    return (_jsxs("section", { className: "starci-core-surface-card", "data-grammar-contract": "core.surface-card", "data-grammar-frame": frame, "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 }), 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;AAsC9F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EACxB,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,GACA,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,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,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,mDAAmD,wBACxF,KAAK,yBACJ,MAAM,wBACP,KAAK,0BACJ,MAAM,gCACC,KAAK,4BACT,SAAS,CAAC,IAAI,aAEtC,cAAK,SAAS,EAAC,6BAA6B,kCAA8B,MAAM,YAC3E,QAAQ,GACP,EACL,MAAM,IACL,CACT,CAAA;IAED,OAAO,CACH,mBACI,SAAS,EAAC,0BAA0B,2BACd,mBAAmB,wBACrB,KAAK,+BACC,MAAM,aAE/B,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,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;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,EAAW,CAAA"}

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

@@ -1,10 +1,6 @@
-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";
+import { type StaticStateRowData } from "../../composite/StaticStateRow/index.js";
+export type SurfaceListItem = StaticStateRowData;
 type LabelledSurfaceList = {
     readonly label: string;
     readonly ariaLabel?: string;
@@ -13,13 +9,27 @@ 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";
+};
+type StaticSurfaceListProps = {
+    readonly items: ReadonlyArray<SurfaceListItem>;
     readonly emptyLabel?: string;
+    readonly children?: never;
+    readonly rowMode?: "static";
+};
+type ContentOwnedSurfaceListProps = {
+    readonly children: ReactNode;
+    readonly rowMode: "interactive";
+    readonly items?: never;
+    readonly emptyLabel?: never;
 };
-export declare const SurfaceListCard: ({ label, ariaLabel, items, fact, depth, emptyLabel, }: SurfaceListCardProps) => import("react").JSX.Element;
+export type SurfaceListCardProps = SurfaceListFrameProps & (StaticSurfaceListProps | ContentOwnedSurfaceListProps);
+export declare const SurfaceListCard: ({ label, ariaLabel, items, children, fact, labelEnd, labelHidden, footer, depth, emptyLabel, rowMode, }: SurfaceListCardProps) => import("react").JSX.Element;
 export declare const meta: {
     readonly shape: "branch";
     readonly grammar: "core";

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;AAC7C,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,yCAAyC,CAAA;AAGjG,MAAM,MAAM,eAAe,GAAG,kBAAkB,CAAA;AAEhD,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;CACpC,CAAA;AAED,KAAK,sBAAsB,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;CAC9B,CAAA;AAED,KAAK,4BAA4B,GAAG;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,GAAG,CAAC,sBAAsB,GAAG,4BAA4B,CAAC,CAAA;AAElH,eAAO,MAAM,eAAe,GAAI,yGAY7B,oBAAoB,gCA4CtB,CAAA;AAED,eAAO,MAAM,IAAI;;;;CAA2F,CAAA"}

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

@@ -1,16 +1,14 @@
 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 { StaticStateRow } from "../../composite/StaticStateRow/index.js";
+import { assertPresentationState } from "../../state.js";
+export const SurfaceListCard = ({ label, ariaLabel, items, children, fact, labelEnd, labelHidden = false, footer, depth = "top", emptyLabel = "No items", rowMode = "static", }) => {
     const headingId = useId();
-    for (const item of items)
+    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;
+    const collection = rowMode === "interactive" ? (_jsx("div", { className: "starci-core-owned-collection", "data-grammar-list": "true", "data-grammar-list-mode": "interactive", children: 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", "data-grammar-list-mode": "static", children: (items ?? []).map((item) => _jsx(StaticStateRow, { item: item }, item.id)) }));
+    return (_jsxs("section", { className: "starci-core-surface-list", "data-grammar-contract": "core.surface-list-card", "data-grammar-label-visibility": labelHidden ? "hidden" : "visible", "data-grammar-list-mode": rowMode, "data-grammar-surface-list": "true", children: [label === undefined || labelHidden ? null : (_jsxs("div", { className: "starci-core-surface-label", "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: "starci-core-surface starci-core-list-shell", "data-grammar-surface": "true", "data-grammar-surface-depth": depth, children: collection }), footer === undefined ? null : (_jsx("div", { className: "starci-core-surface-footer", "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,cAAc,EAA2B,MAAM,yCAAyC,CAAA;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAsCxD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC5B,KAAK,EACL,SAAS,EACT,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,WAAW,GAAG,KAAK,EACnB,MAAM,EACN,KAAK,GAAG,KAAK,EACb,UAAU,GAAG,UAAU,EACvB,OAAO,GAAG,QAAQ,GACC,EAAE,EAAE;IACvB,MAAM,SAAS,GAAG,KAAK,EAAE,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE;QAAE,uBAAuB,CAAC,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,CAAA;IAChF,MAAM,cAAc,GAAG,SAAS,IAAI,KAAK,CAAA;IACzC,MAAM,UAAU,GAAG,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,CAC3C,cAAK,SAAS,EAAC,8BAA8B,uBAAmB,MAAM,4BAAwB,aAAa,YACtG,QAAQ,GACP,CACT,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACtB,YAAG,SAAS,EAAC,uBAAuB,wBAAoB,SAAS,YAAE,UAAU,GAAK,CACrF,CAAC,CAAC,CAAC,CACA,aAAI,SAAS,EAAC,yBAAyB,uBAAmB,MAAM,4BAAwB,QAAQ,YAC3F,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAC,cAAc,IAAe,IAAI,EAAE,IAAI,IAAnB,IAAI,CAAC,EAAE,CAAgB,CAAC,GACzE,CACR,CAAA;IAED,OAAO,CACH,mBACI,SAAS,EAAC,0BAA0B,2BACd,wBAAwB,mCACf,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,4BACzC,OAAO,+BACL,MAAM,aAE/B,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACzC,eAAK,SAAS,EAAC,2BAA2B,gCAA4B,MAAM,aACxE,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,EAAC,4CAA4C,0BACjC,MAAM,gCACC,KAAK,YAEhC,UAAU,GACT,EACL,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3B,cAAK,SAAS,EAAC,4BAA4B,iCAA6B,MAAM,YAAE,MAAM,GAAO,CAChG,IACK,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"}

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

@@ -0,0 +1,17 @@
+import { type PresentationState } from "../../state.js";
+export type StaticStateRowData = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly state?: PresentationState;
+};
+export type StaticStateRowProps = {
+    readonly item: StaticStateRowData;
+};
+/** One non-interactive, product-neutral row in a Core-owned static collection. */
+export declare const StaticStateRow: ({ item }: StaticStateRowProps) => import("react").JSX.Element;
+export declare const meta: {
+    readonly shape: "composite";
+    readonly grammar: "core";
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/StaticStateRow/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAErE,MAAM,MAAM,kBAAkB,GAAG;IAC7B,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,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;CACpC,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,cAAc,GAAI,UAAU,mBAAmB,gCAkB3D,CAAA;AAED,eAAO,MAAM,IAAI;;;CAAmD,CAAA"}

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

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { StateMark } from "../../StateMark.js";
+import { treatmentFor } from "../../state.js";
+/** One non-interactive, product-neutral row in a Core-owned static collection. */
+export const StaticStateRow = ({ 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 })] })] }));
+};
+export const meta = { shape: "composite", grammar: "core" };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/StaticStateRow/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAA;AAarE,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAE,IAAI,EAAuB,EAAE,EAAE;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAA;IACrC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAErC,OAAO,CACH,cACI,SAAS,EAAC,wBAAwB,sBACjB,MAAM,wBACH,KAAK,4BACD,SAAS,CAAC,IAAI,aAEtC,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,IACN,CACR,CAAA;AACL,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAW,CAAA"}