@starci/grammar 0.16.5 → 0.17.1

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

@@ -0,0 +1,28 @@
+import { type ReactNode, type Ref } from "react";
+export type PaneSectionProps = {
+    readonly children: ReactNode;
+    /** Takes the remaining block size of the pane (min-height 0). */
+    readonly grow?: boolean;
+    /** Its own vertical scroll owner (OVERFLOW-4/5) with the inset inside the scroller. Implies grow. */
+    readonly scroll?: {
+        readonly label: string;
+        readonly role?: "log" | "region";
+        readonly tone?: "surface" | "background";
+        readonly scrollRef?: Ref<HTMLDivElement>;
+    };
+    /** Head band centred in a shared grid row. Default `start`. */
+    readonly align?: "start" | "center";
+    /** `inline`: the one horizontal scroller in it reaches both pane edges and takes the inset as scroll padding. */
+    readonly bleed?: "inline";
+    /** Gap between its own children. Default `row`. */
+    readonly gap?: "inline" | "row" | "section";
+    readonly as?: "div" | "header" | "footer";
+};
+/**
+ * One band of a Pane: it pads inline by the pane's inset, the sections of a pane stack with the row gap between them,
+ * the first takes the pane's block-start inset and the last its block-end inset. With `scroll` the band is its own
+ * full-bleed scroll owner and the inset sits on its content, so the scrollbar stays on the pane edge. A section outside
+ * a Pane throws `PANE_SECTION_OUTSIDE_PANE`.
+ */
+export declare const PaneSection: ({ children, grow, scroll, align, bleed, gap, as }: PaneSectionProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composition/PaneSection/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA4B,KAAK,SAAS,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAA;AAI1E,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,qGAAqG;IACrG,QAAQ,CAAC,MAAM,CAAC,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;QAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,CAAA;QACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAA;KAC3C,CAAA;IACD,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IACnC,iHAAiH;IACjH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;IACzB,mDAAmD;IACnD,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;CAC5C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,mDAAqF,gBAAgB,gCA8BhI,CAAA"}

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

@@ -0,0 +1,31 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createElement, useEffect } from "react";
+import { VerticalScrollRegion } from "../../composite/VerticalScrollRegion/index.js";
+import { usePaneContext } from "../../paneContext.js";
+/**
+ * One band of a Pane: it pads inline by the pane's inset, the sections of a pane stack with the row gap between them,
+ * the first takes the pane's block-start inset and the last its block-end inset. With `scroll` the band is its own
+ * full-bleed scroll owner and the inset sits on its content, so the scrollbar stays on the pane edge. A section outside
+ * a Pane throws `PANE_SECTION_OUTSIDE_PANE`.
+ */
+export const PaneSection = ({ children, grow = false, scroll, align = "start", bleed, gap = "row", as = "div" }) => {
+    const pane = usePaneContext();
+    useEffect(() => pane?.register(), [pane]);
+    if (pane === undefined)
+        throw new Error("PANE_SECTION_OUTSIDE_PANE");
+    const shared = {
+        "data-component": "PaneSection",
+        "data-tier": "composition",
+        "data-grammar-pane-section-align": align,
+        "data-grammar-pane-section-gap": gap,
+        "data-grammar-pane-section-bleed": bleed,
+        "data-grammar-pane-section-grow": grow || scroll !== undefined ? "true" : undefined,
+    };
+    const contract = "PADDING-4 GAP-3";
+    if (scroll === undefined) {
+        return createElement(as, { ...shared, className: "starci-core-pane-section", "data-contract": contract }, children);
+    }
+    return (_jsx(VerticalScrollRegion, { ...shared, "aria-label": scroll.label, className: "starci-core-pane-section", "data-grammar-pane-section-scroll": "true", isScrollable: true, ...(scroll.role === undefined ? {} : { role: scroll.role }), ...(scroll.tone === undefined ? {} : { tone: scroll.tone }), ...(scroll.scrollRef === undefined ? {} : { ref: scroll.scrollRef }), children: createElement(as, { className: "starci-core-pane-section-content", "data-contract": contract }, children) }));
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composition/PaneSection/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,aAAa,EAAE,SAAS,EAA4B,MAAM,OAAO,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAA;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAsBrD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,EAAE,EAAE,GAAG,KAAK,EAAoB,EAAE,EAAE;IACjI,MAAM,IAAI,GAAG,cAAc,EAAE,CAAA;IAC7B,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IACzC,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IACpE,MAAM,MAAM,GAAG;QACX,gBAAgB,EAAE,aAAa;QAC/B,WAAW,EAAE,aAAa;QAC1B,iCAAiC,EAAE,KAAK;QACxC,+BAA+B,EAAE,GAAG;QACpC,iCAAiC,EAAE,KAAK;QACxC,gCAAgC,EAAE,IAAI,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;KACtF,CAAA;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAA;IAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,0BAA0B,EAAE,eAAe,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAA;IACvH,CAAC;IACD,OAAO,CACH,KAAC,oBAAoB,OACb,MAAM,gBACE,MAAM,CAAC,KAAK,EACxB,SAAS,EAAC,0BAA0B,sCACH,MAAM,EACvC,YAAY,WACR,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,KACxD,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,KACxD,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,YAEpE,aAAa,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,kCAAkC,EAAE,eAAe,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,GACvF,CAC1B,CAAA;AACL,CAAC,CAAA"}

package/dist/core/paneContext.d.ts

@@ -0,0 +1,12 @@
+/** What a Pane gives its descendants: `content` publishes the Grammar pane inset to its PaneSections, `flush` publishes none. */
+export type PaneInset = "content" | "flush";
+export type PaneContextValue = {
+    readonly area: string;
+    readonly inset: PaneInset;
+    /** A PaneSection or nested PaneGrid announces itself on mount; the returned function withdraws it. */
+    readonly register: () => () => void;
+};
+/** Internal to the composition tier: not exported from the public entries. */
+export declare const PaneContext: import("react").Context<PaneContextValue | undefined>;
+export declare const usePaneContext: () => PaneContextValue | undefined;
+//# sourceMappingURL=paneContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paneContext.d.ts","sourceRoot":"","sources":["../../src/core/paneContext.tsx"],"names":[],"mappings":"AAIA,iIAAiI;AACjI,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AAE3C,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,sGAAsG;IACtG,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,IAAI,CAAA;CACtC,CAAA;AAED,8EAA8E;AAC9E,eAAO,MAAM,WAAW,uDAAyD,CAAA;AAEjF,eAAO,MAAM,cAAc,QAAO,gBAAgB,GAAG,SAAoC,CAAA"}

package/dist/core/paneContext.js

@@ -0,0 +1,6 @@
+"use client";
+import { createContext, useContext } from "react";
+/** Internal to the composition tier: not exported from the public entries. */
+export const PaneContext = createContext(undefined);
+export const usePaneContext = () => useContext(PaneContext);
+//# sourceMappingURL=paneContext.js.map

package/dist/core/paneContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paneContext.js","sourceRoot":"","sources":["../../src/core/paneContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAYjD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAA+B,SAAS,CAAC,CAAA;AAEjF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAiC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA"}

package/dist/core/styles.css

@@ -149,7 +149,7 @@
     .grammar-common-root[data-grammar-family="core"]
         .starci-core-surface-card[data-grammar-surface-labelled="true"][data-grammar-surface-placement="panel"][data-grammar-frame="bounded"]
         > [data-grammar-surface-label] {
-        --starci-core-surface-label-padding: var(--starci-core-surface-inset, 1rem) var(--starci-core-surface-inset, 1rem) 0;
+        --starci-core-surface-label-padding: var(--grammar-card-padding-block, 1rem) var(--grammar-card-padding-inline, 1rem) 0;
     }
 
     .grammar-common-root[data-grammar-family="core"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/grammar",
-  "version": "0.16.5",
+  "version": "0.17.1",
   "description": "Reusable StarCi React components, compositions, and packaged visual DNA.",
   "keywords": [
     "starci",