@starci/grammar 0.4.12 → 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;

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.12",
+  "version": "0.4.13",
   "description": "Reusable StarCi React components, compositions, and packaged visual DNA.",
   "keywords": [
     "starci",