@starci/grammar 0.4.11 → 0.4.13

package/dist/common/styles.css

@@ -371,6 +371,23 @@
         min-width: max-content;
     }
 
+    /*
+     * The same one scrolling axis, for the vertical region.
+     *
+     * The vendor's `.scroll-shadow--vertical` sets `overflow-y: auto` alone, and every host class
+     * this region wears - the chat conversation, the chat overlay rail, the accordion region, the
+     * form scroll viewport - names that same single axis or names none at all. A computed non-visible
+     * overflow on one axis forces the other from `visible` to `auto`, so the region rendered
+     * `overflow: auto auto`: two scrolling axes under an OVERFLOW-3 claim that promises one. Naming
+     * both axes on the region's own identity holds the render at the one axis the claim describes,
+     * and needs no `!important` to do it: no host class and no vendor rule ever names `overflow-x`,
+     * so this declaration is unopposed whichever order a consumer imports the two sheets in.
+     */
+    [data-grammar-scroll-region="vertical"] {
+        overflow-x: hidden;
+        overflow-y: auto;
+    }
+
     @media (min-width: 40rem) {
         .starci-core-form-page {
             padding-block: 2.5rem;
@@ -2309,6 +2326,57 @@
         border-radius: var(--field-radius, calc(var(--radius, 0.5rem) * 1.5)) !important;
     }
 
+    /* --- Heading: the FONT rank each level stamps, drawn from the family's own sheet. --- */
+    /*
+     * `Heading` renders through the vendor's `Typography.Heading`, which sizes `.typography--h1`
+     * through `--h4` from the vendor's own sheet. Until 0.4.12 the family answered that with the
+     * Tailwind utility classes on the component alone - and a utility class exists only where the
+     * CONSUMER's Tailwind build scanned this package's dist, which is the same debt
+     * `shipped-geometry.spec.ts` already refuses for layout. A consumer whose scan stopped finding
+     * the package measured 36px under a `FONT-4` stamp and 30px under `FONT-3`: the vendor's sizes,
+     * under the family's promise. The scale is the family's, so the family's sheet draws it, the way
+     * `.starci-core-text` above already draws its own.
+     *
+     * `!important` because the vendor rule has to lose in either import order - consumers import
+     * this sheet both before and after `@heroui/styles`, so layer rank alone cannot decide it. The
+     * values re-state what the utilities carry, so nothing moves where a scan still finds them.
+     *
+     * `display` is the one row a family may re-cut: `offset-pop` gives it its own weight, tracking
+     * and 0.96 line height. So only FONT-6's SIZE is important here; its rhythm stays a normal
+     * declaration that a later family layer can still own.
+     */
+    .grammar-common-root [data-component="Heading"][data-scale="standard"][data-level="1"] {
+        font-size: 1.25rem !important;
+        font-weight: 600 !important;
+        letter-spacing: -0.025em !important;
+        line-height: 1.75rem !important;
+    }
+
+    .grammar-common-root [data-component="Heading"][data-scale="standard"][data-level="2"] {
+        font-size: 1rem !important;
+        font-weight: 600 !important;
+        line-height: 1.5rem !important;
+    }
+
+    .grammar-common-root [data-component="Heading"][data-scale="standard"][data-level="3"] {
+        font-size: 0.875rem !important;
+        font-weight: 500 !important;
+        line-height: 1.25rem !important;
+    }
+
+    .grammar-common-root [data-component="Heading"][data-scale="standard"][data-level="4"] {
+        font-size: 0.75rem !important;
+        font-weight: 500 !important;
+        line-height: 1rem !important;
+    }
+
+    .grammar-common-root [data-component="Heading"][data-scale="display"] {
+        font-size: 2.25rem !important;
+        font-weight: 600;
+        letter-spacing: -0.025em;
+        line-height: 1.25;
+    }
+
     /* --- Text: one resolved line of copy, drawn from the attributes it already emits. --- */
     .starci-core-text {
         color: var(--foreground, var(--starci-core-foreground, CanvasText));

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

@@ -1,9 +1,20 @@
 import type { ComponentProps, ReactNode } from "react";
+/**
+ * Which overflow answer this region gives for its one axis.
+ *
+ * `always` is the region standing on its own: the block axis scrolls, full stop (OVERFLOW-3).
+ * `needed` is that same one axis scrolling only where the content actually overflows (OVERFLOW-4).
+ * The region is the node that carries the stamp, so the owner has to be able to say which of the two
+ * it is; a `data-contract` passed in was, and still is, silently replaced by this element's own.
+ */
+export type VerticalScrollRegionOverflow = "always" | "needed";
 export type VerticalScrollRegionProps = Omit<ComponentProps<"div">, "children"> & {
     readonly children: ReactNode;
     readonly isScrollable: boolean;
     /** Hide scrollbar chrome by default while retaining wheel, touch and keyboard scrolling. */
     readonly hideScrollBar?: boolean;
+    /** The region's own overflow answer; the stamp and the render both follow it. */
+    readonly overflow?: VerticalScrollRegionOverflow;
 };
 /** Use HeroUI's Vertical ScrollShadow without making consumers own its DOM contract. */
 export declare const VerticalScrollRegion: (props: VerticalScrollRegionProps) => import("react").JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/VerticalScrollRegion/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtD,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC9E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACnC,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,GAAI,OAAO,yBAAyB,gCAKpE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/VerticalScrollRegion/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtD;;;;;;;GAOG;AACH,MAAM,MAAM,4BAA4B,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE9D,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC9E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,4BAA4B,CAAA;CACnD,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,GAAI,OAAO,yBAAyB,gCAMpE,CAAA"}

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

@@ -2,9 +2,10 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { ScrollShadow } from "@heroui/react";
 /** Use HeroUI's Vertical ScrollShadow without making consumers own its DOM contract. */
 export const VerticalScrollRegion = (props) => {
-    const { children, isScrollable, hideScrollBar = true, ...regionProps } = props;
+    const { children, isScrollable, hideScrollBar = true, overflow = "always", ...regionProps } = props;
+    const contract = overflow === "needed" ? "MEASURE-7 OVERFLOW-4" : "MEASURE-7 OVERFLOW-3";
     return isScrollable
-        ? _jsx(ScrollShadow, { ...regionProps, "data-contract": "MEASURE-7 OVERFLOW-3", hideScrollBar: hideScrollBar, orientation: "vertical", children: children })
+        ? _jsx(ScrollShadow, { ...regionProps, "data-contract": contract, "data-grammar-overflow": overflow, "data-grammar-scroll-region": "vertical", hideScrollBar: hideScrollBar, orientation: "vertical", children: children })
         : _jsx("div", { ...regionProps, children: children });
 };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/VerticalScrollRegion/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAS5C,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAgC,EAAE,EAAE;IACrE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,GAAG,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,KAAK,CAAA;IAC9E,OAAO,YAAY;QACf,CAAC,CAAC,KAAC,YAAY,OAAK,WAAW,mBAAgB,sBAAsB,EAAC,aAAa,EAAE,aAAa,EAAE,WAAW,EAAC,UAAU,YAAE,QAAQ,GAAgB;QACpJ,CAAC,CAAC,iBAAS,WAAW,YAAG,QAAQ,GAAO,CAAA;AAChD,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/VerticalScrollRegion/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAqB5C,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAgC,EAAE,EAAE;IACrE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,GAAG,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,KAAK,CAAA;IACnG,MAAM,QAAQ,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,sBAAsB,CAAA;IACxF,OAAO,YAAY;QACf,CAAC,CAAC,KAAC,YAAY,OAAK,WAAW,mBAAiB,QAAQ,2BAAyB,QAAQ,gCAA6B,UAAU,EAAC,aAAa,EAAE,aAAa,EAAE,WAAW,EAAC,UAAU,YAAE,QAAQ,GAAgB;QAC/M,CAAC,CAAC,iBAAS,WAAW,YAAG,QAAQ,GAAO,CAAA;AAChD,CAAC,CAAA"}

package/package.json

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