@bsuite/page-builder 1.0.7 → 2.0.0

package/dist/CanvasCard.d.ts

@@ -2,7 +2,14 @@ import type { ReactNode } from 'react';
 export interface CanvasCardProps {
     /** Stable widget key used by PageGridLayout for layout persistence. Required. */
     cardKey: string;
-    /** Default grid width in columns (12-col grid). Defaults to 12. */
+    /**
+     * Grid width in columns on the 12-column grid.
+     *
+     * Defaults to **6** — half the grid, two cards per row. It defaulted to 12
+     * up to 1.0.7, which meant every card that omitted `w` rendered full width
+     * and stacked; 1,068 of 1,729 usages across the estate omit it. Say `w={12}`
+     * when a card genuinely wants the full row.
+     */
     w?: 2 | 3 | 4 | 6 | 8 | 12;
     /** Minimum width in columns when the user resizes. Defaults to 4. */
     minW?: 2 | 3 | 4 | 6 | 8 | 12;

package/dist/CanvasCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CanvasCard.d.ts","sourceRoot":"","sources":["../src/CanvasCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IAC3B,qEAAqE;IACrE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IAC9B,4FAA4F;IAC5F,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAExD;yBAFe,UAAU"}
+{"version":3,"file":"CanvasCard.d.ts","sourceRoot":"","sources":["../src/CanvasCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IAC3B,qEAAqE;IACrE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IAC9B,4FAA4F;IAC5F,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAExD;yBAFe,UAAU"}

package/dist/DraggableCardPage.d.ts

@@ -105,6 +105,14 @@ export type DraggableCardPageProps = Omit<PageGridLayoutProps, 'widgets' | 'defa
      * the element it toggles was never mounted.
      */
     onDroppedChildren?: (dropped: string[], pageKey: string) => void;
+    /**
+     * Width, in grid columns, for cards that do not set `w` themselves.
+     *
+     * Defaults to `DEFAULT_CANVAS_CARD_WIDTH` (6 — half the grid, two cards per
+     * row) as of 2.0.0. Pass 12 to restore the pre-2.0.0 full-width stack while
+     * an app migrates its pages.
+     */
+    defaultCardWidth?: number;
     /**
      * CanvasCard children. Falsy entries are ignored. Fragments are flattened so
      * a conditional multi-card branch still registers each CanvasCard.

package/dist/DraggableCardPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DraggableCardPage.d.ts","sourceRoot":"","sources":["../src/DraggableCardPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,OAAO,EAAW,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,mBAAmB,EACnB,SAAS,GAAG,gBAAgB,CAC7B,GAAG;IACF;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACnD;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAgCF,wBAAgB,iBAAiB,CAAC,EAChC,WAAe,EACf,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,GAAG,SAAS,EACb,EAAE,sBAAsB,+BA2BxB;yBAjCe,iBAAiB"}
+{"version":3,"file":"DraggableCardPage.d.ts","sourceRoot":"","sources":["../src/DraggableCardPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,OAAO,EAAW,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,mBAAmB,EACnB,SAAS,GAAG,gBAAgB,CAC7B,GAAG;IACF;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACnD;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAgCF,wBAAgB,iBAAiB,CAAC,EAChC,WAAe,EACf,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,GAAG,SAAS,EACb,EAAE,sBAAsB,+BA2BxB;yBAjCe,iBAAiB"}

package/dist/PageGridLayout.d.ts

@@ -2,5 +2,5 @@ import React from 'react';
 import 'react-grid-layout/css/styles.css';
 import 'react-resizable/css/styles.css';
 import type { PageGridLayoutProps } from './types.js';
-export declare function PageGridLayout({ pageKey, defaultLayouts, defaultCols, layoutVersion, canEditPage, editorEventNames, preferenceAdapter, widgets, widgetMeta, className, isResizable, resizeHandles, tenantId, defaultAutoHeight, addEntityWidgetEventNames, createEntityWidget, onRegisterEntityWidget, relationshipCatalog, addRelationshipWidgetEventNames, createRelationshipWidget, onRegisterRelationshipWidget, onRelationshipWidgetRejected, }: PageGridLayoutProps): React.JSX.Element;
+export declare function PageGridLayout({ pageKey, defaultLayouts, defaultCols, layoutVersion, canEditPage, editorEventNames, preferenceAdapter, widgets, widgetMeta, className, isResizable, resizeHandles, tenantId, defaultAutoHeight, itemChrome, addEntityWidgetEventNames, createEntityWidget, onRegisterEntityWidget, relationshipCatalog, addRelationshipWidgetEventNames, createRelationshipWidget, onRegisterRelationshipWidget, onRelationshipWidgetRejected, }: PageGridLayoutProps): React.JSX.Element;
 //# sourceMappingURL=PageGridLayout.d.ts.map

package/dist/PageGridLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageGridLayout.d.ts","sourceRoot":"","sources":["../src/PageGridLayout.tsx"],"names":[],"mappings":"AACA,OAAO,KAQN,MAAM,OAAO,CAAC;AAGf,OAAO,kCAAkC,CAAC;AAC1C,OAAO,gCAAgC,CAAC;AAMxC,OAAO,KAAK,EAAe,mBAAmB,EAA4B,MAAM,YAAY,CAAC;AA8U7F,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,UAAU,EACV,SAAS,EAMT,WAAkB,EAClB,aAAsC,EACtC,QAAQ,EACR,iBAAiB,EACjB,yBAAiE,EACjE,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,+BAA6E,EAC7E,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,GAC7B,EAAE,mBAAmB,qBAwzBrB"}
+{"version":3,"file":"PageGridLayout.d.ts","sourceRoot":"","sources":["../src/PageGridLayout.tsx"],"names":[],"mappings":"AACA,OAAO,KAQN,MAAM,OAAO,CAAC;AAGf,OAAO,kCAAkC,CAAC;AAC1C,OAAO,gCAAgC,CAAC;AAMxC,OAAO,KAAK,EAAe,mBAAmB,EAA4B,MAAM,YAAY,CAAC;AA4W7F,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,UAAU,EACV,SAAS,EAMT,WAAkB,EAClB,aAAsC,EACtC,QAAQ,EACR,iBAAiB,EAKjB,UAAkB,EAClB,yBAAiE,EACjE,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,+BAA6E,EAC7E,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,GAC7B,EAAE,mBAAmB,qBAyzBrB"}

package/dist/PageGridLayout.js

@@ -84,7 +84,7 @@ const DEFAULT_ADD_RELATIONSHIP_WIDGET_EVENT_NAMES = [
 const RGLResizeHandle = React.forwardRef(function RGLResizeHandle({ axis = 'se', className: injectedClassName, ...rest }, ref) {
     return (_jsx("span", { ref: ref, "data-no-drag": true, className: `react-resizable-handle react-resizable-handle-${axis}${injectedClassName ? ' ' + injectedClassName : ''}`, ...rest }));
 });
-const GridItem = React.memo(React.forwardRef(function GridItem({ id, content, isEditing, label, onHide, autoHeight, onAutoHeightChange, children: injectedChildren, className: injectedClassName, style: injectedStyle, ...rest }, ref) {
+const GridItem = React.memo(React.forwardRef(function GridItem({ id, content, isEditing, label, onHide, autoHeight, onAutoHeightChange, chrome = false, children: injectedChildren, className: injectedClassName, style: injectedStyle, ...rest }, ref) {
     // Auto-height measurement (blueprint amendment A1). `measureRef` wraps
     // `content` with NO height constraint of its own — its parent has
     // `overflow-hidden` + `flex-1 min-h-0` (clips *painting* to the current
@@ -214,7 +214,18 @@ const GridItem = React.memo(React.forwardRef(function GridItem({ id, content, is
     return (_jsxs("div", { ref: ref, className: outerClass, style: injectedStyle, ...rest, children: [_jsxs("div", { className: "h-full w-full relative", children: [isEditing && (_jsx("div", { className: "absolute inset-0 z-10 pointer-events-none rounded-3xl border-2 border-transparent group-hover:border-primary/50 transition-colors bg-primary/5" })), isEditing && (_jsx("div", { className: "absolute top-2 left-2 z-30 flex items-center gap-1 pointer-events-none", children: _jsx("span", { className: "text-[10px] px-1.5 py-0.5 rounded-md opacity-80 font-medium bg-muted text-muted-foreground", children: label }) })), isEditing && (_jsx("button", { className: "absolute top-2 right-2 z-30 h-6 w-6 rounded-full flex items-center justify-center bg-destructive/80 hover:bg-destructive text-destructive-foreground shadow transition-colors", "data-no-drag": true, onPointerDown: (event) => event.stopPropagation(), onClick: (event) => {
                             event.stopPropagation();
                             onHide(id);
-                        }, title: `Hide ${label}`, "aria-label": `Hide ${label}`, children: _jsx(EyeOff, { className: "h-3 w-3", "aria-hidden": "true" }) })), _jsx("div", { className: "h-full w-full rounded-3xl transition-all flex flex-col bg-card border border-border shadow-sm dark:shadow-[var(--glow-card,none)]", style: { contain: 'layout style' }, children: _jsx("div", { className: cn('flex-1 min-h-0', autoHeight ? 'overflow-hidden' : 'overflow-auto'), children: autoHeight ? _jsx("div", { ref: measureRef, children: content }) : content }) })] }), injectedChildren] }));
+                        }, title: `Hide ${label}`, "aria-label": `Hide ${label}`, children: _jsx(EyeOff, { className: "h-3 w-3", "aria-hidden": "true" }) })), _jsx("div", { "data-slot": "grid-item-surface", "data-chrome": chrome ? 'on' : 'off', className: chrome
+                            ? // ONE radius token, read by the grid item AND available to any
+                                // app card that opts into the same surface. Two surfaces
+                                // reading the SAME var is what makes their corners align, and
+                                // it is also what keeps the radius tenant-configurable —
+                                // a literal here would align them and lock white-label out.
+                                // `--radius-card` defaults to today's value (1.5rem =
+                                // rounded-3xl), so this is byte-identical until a tenant sets
+                                // one.
+                                'h-full w-full rounded-[var(--radius-card,1.5rem)] transition-all flex flex-col bg-card border border-border shadow-sm dark:shadow-[var(--glow-card,none)]'
+                            : // Chrome OFF: layout only. Identical box, no paint.
+                                'h-full w-full transition-all flex flex-col', style: { contain: 'layout style' }, children: _jsx("div", { className: cn('flex-1 min-h-0', autoHeight ? 'overflow-hidden' : 'overflow-auto'), children: autoHeight ? _jsx("div", { ref: measureRef, children: content }) : content }) })] }), injectedChildren] }));
 }));
 export function PageGridLayout({ pageKey, defaultLayouts, defaultCols, layoutVersion, canEditPage, editorEventNames, preferenceAdapter, widgets, widgetMeta, className, 
 // Resize default flipped 2026-05-12: rgl v2 dropped auto-handle rendering
@@ -222,7 +233,12 @@ export function PageGridLayout({ pageKey, defaultLayouts, defaultCols, layoutVer
 // adapters then defaulted it back to true. With v2's handle gap fixed,
 // the safe default is true so any consumer who forgets to set it still
 // gets a usable canvas. Opt out per-page with isResizable={false}.
-isResizable = true, resizeHandles = DEFAULT_RESIZE_HANDLES, tenantId, defaultAutoHeight, addEntityWidgetEventNames = DEFAULT_ADD_ENTITY_WIDGET_EVENT_NAMES, createEntityWidget, onRegisterEntityWidget, relationshipCatalog, addRelationshipWidgetEventNames = DEFAULT_ADD_RELATIONSHIP_WIDGET_EVENT_NAMES, createRelationshipWidget, onRegisterRelationshipWidget, onRelationshipWidgetRejected, }) {
+isResizable = true, resizeHandles = DEFAULT_RESIZE_HANDLES, tenantId, defaultAutoHeight, 
+// CHROME OFF BY DEFAULT — the inversion. See `GridItemProps.chrome`.
+// An app that is not ready to migrate its own card surfaces passes
+// `itemChrome` to get the pre-2.0.0 behaviour back for every slot, and
+// migrates page by page with the per-item `chrome` flag.
+itemChrome = false, addEntityWidgetEventNames = DEFAULT_ADD_ENTITY_WIDGET_EVENT_NAMES, createEntityWidget, onRegisterEntityWidget, relationshipCatalog, addRelationshipWidgetEventNames = DEFAULT_ADD_RELATIONSHIP_WIDGET_EVENT_NAMES, createRelationshipWidget, onRegisterRelationshipWidget, onRelationshipWidgetRejected, }) {
     const { currentLayouts, layoutCols, isEditing, setIsEditing, activeCols, activeCompactor, onLayoutChange, handleColumnChange, handleBreakpointChange, handleCompact, handleReset, addWidget, moveWidget, setWidgetLocked, applyAutoHeightRows, autoHeightRows, resetConfirmOpen, setResetConfirmOpen, containerRef, containerWidth, } = usePageGridLayout({
         pageKey,
         defaultLayouts,
@@ -693,6 +709,6 @@ isResizable = true, resizeHandles = DEFAULT_RESIZE_HANDLES, tenantId, defaultAut
                             const content = allWidgets[layoutItem.i];
                             if (content === undefined || content === null)
                                 return null;
-                            return (_jsx(GridItem, { id: layoutItem.i, content: content, isEditing: isEditing, label: layerNames[layoutItem.i] || widgetMeta?.[layoutItem.i]?.label || layoutItem.i, onHide: hideLayer, autoHeight: layoutItem.autoHeight, onAutoHeightChange: handleAutoHeightChange }, layoutItem.i));
+                            return (_jsx(GridItem, { id: layoutItem.i, content: content, isEditing: isEditing, label: layerNames[layoutItem.i] || widgetMeta?.[layoutItem.i]?.label || layoutItem.i, onHide: hideLayer, autoHeight: layoutItem.autoHeight, onAutoHeightChange: handleAutoHeightChange, chrome: layoutItem.chrome ?? itemChrome }, layoutItem.i));
                         }) }) }) })] }));
 }

package/dist/canvasCardLayout.d.ts

@@ -12,6 +12,26 @@ import type { CanvasCardProps } from './CanvasCard.js';
 import type { GridLayouts } from './types.js';
 /** The 12-column grid every BSuite page canvas is laid out against. */
 export declare const CANVAS_GRID_COLUMNS = 12;
+/**
+ * The width a `CanvasCard` gets when its author does not say.
+ *
+ * SIX, i.e. half the grid — changed from twelve in 2.0.0. Twelve on a
+ * twelve-column grid means every card that omits `w` renders full width and
+ * the page becomes a single vertical stack. Measured across the estate on
+ * 2026-08-25: **1,068 of 1,729 CanvasCard usages omit `w`** (BSU and conduit
+ * omit it 100% of the time), so 62% of every card surface in BSuite was
+ * stacked by a DEFAULT, not by a layout decision. That is the operator's
+ * long-standing "the cards don't use the available space" report, and it is
+ * one number in one file rather than 1,068 page edits.
+ *
+ * Six rather than four: at a 1680px container half the grid is still ~820px,
+ * which comfortably holds a data table. Four would have traded a stacking
+ * complaint for a cramping one.
+ *
+ * A page that genuinely wants a full-width card still says `w={12}` — an
+ * explicit width always wins, and 661 usages already do exactly that.
+ */
+export declare const DEFAULT_CANVAS_CARD_WIDTH = 6;
 export declare function isCanvasCardElement(node: ReactNode): node is ReactElement<CanvasCardProps>;
 /**
  * Best-effort display name for a node that is about to be discarded.
@@ -58,5 +78,7 @@ export interface CanvasCardLayoutResult {
  * item. (This is the fact that disproves the "dynamic card lists cannot be
  * split into static widget keys" objection recorded in several app ledgers.)
  */
-export declare function buildCanvasCardLayout(children: ReactNode): CanvasCardLayoutResult;
+export declare function buildCanvasCardLayout(children: ReactNode, options?: {
+    defaultWidth?: number;
+}): CanvasCardLayoutResult;
 //# sourceMappingURL=canvasCardLayout.d.ts.map

package/dist/canvasCardLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasCardLayout.d.ts","sourceRoot":"","sources":["../src/canvasCardLayout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,GACd,IAAI,IAAI,YAAY,CAAC,eAAe,CAAC,CAKvC;AAQD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAQpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG;IACpD,KAAK,EAAE,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAqBA;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,EAAE,GAAG,SAAsB,UAE7E;AAED,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,yEAAyE;IACzE,OAAO,EAAE,WAAW,CAAC;IACrB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,GAClB,sBAAsB,CA0CxB"}
+{"version":3,"file":"canvasCardLayout.d.ts","sourceRoot":"","sources":["../src/canvasCardLayout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,GACd,IAAI,IAAI,YAAY,CAAC,eAAe,CAAC,CAKvC;AAQD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAQpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG;IACpD,KAAK,EAAE,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAqBA;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,EAAE,GAAG,SAAsB,UAE7E;AAED,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,yEAAyE;IACzE,OAAO,EAAE,WAAW,CAAC;IACrB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,EACnB,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC,sBAAsB,CA2CxB"}

package/dist/canvasCardLayout.js

@@ -11,6 +11,26 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { Children, Fragment, isValidElement, } from 'react';
 /** The 12-column grid every BSuite page canvas is laid out against. */
 export const CANVAS_GRID_COLUMNS = 12;
+/**
+ * The width a `CanvasCard` gets when its author does not say.
+ *
+ * SIX, i.e. half the grid — changed from twelve in 2.0.0. Twelve on a
+ * twelve-column grid means every card that omits `w` renders full width and
+ * the page becomes a single vertical stack. Measured across the estate on
+ * 2026-08-25: **1,068 of 1,729 CanvasCard usages omit `w`** (BSU and conduit
+ * omit it 100% of the time), so 62% of every card surface in BSuite was
+ * stacked by a DEFAULT, not by a layout decision. That is the operator's
+ * long-standing "the cards don't use the available space" report, and it is
+ * one number in one file rather than 1,068 page edits.
+ *
+ * Six rather than four: at a 1680px container half the grid is still ~820px,
+ * which comfortably holds a data table. Four would have traded a stacking
+ * complaint for a cramping one.
+ *
+ * A page that genuinely wants a full-width card still says `w={12}` — an
+ * explicit width always wins, and 661 usages already do exactly that.
+ */
+export const DEFAULT_CANVAS_CARD_WIDTH = 6;
 export function isCanvasCardElement(node) {
     return (isValidElement(node) &&
         node.type.displayName === 'CanvasCard');
@@ -84,7 +104,8 @@ export function clampColumns(value, min = 1, max = CANVAS_GRID_COLUMNS) {
  * item. (This is the fact that disproves the "dynamic card lists cannot be
  * split into static widget keys" objection recorded in several app ledgers.)
  */
-export function buildCanvasCardLayout(children) {
+export function buildCanvasCardLayout(children, options = {}) {
+    const defaultWidth = clampColumns(options.defaultWidth ?? DEFAULT_CANVAS_CARD_WIDTH);
     const widgets = {};
     const lg = [];
     let x = 0;
@@ -96,7 +117,7 @@ export function buildCanvasCardLayout(children) {
         // a card explicitly opts out for a virtualized list. See CanvasCardProps.
         const { cardKey, h = 6, minH = 2, minW = 4, autoHeight = true, children: body, } = child.props;
         const normalizedMinW = clampColumns(minW);
-        const width = clampColumns(child.props.w ?? CANVAS_GRID_COLUMNS, normalizedMinW);
+        const width = clampColumns(child.props.w ?? defaultWidth, normalizedMinW);
         if (x + width > CANVAS_GRID_COLUMNS) {
             y += rowHeight;
             x = 0;

package/dist/cardSurfaces.stories.d.ts

@@ -0,0 +1,62 @@
+import type { ReactNode } from 'react';
+/**
+ * The card-surface defect classes, made VISIBLE and DIFFABLE.
+ *
+ * `@bsuite/page-builder` 1.0.4, 1.0.5 and 1.0.6 each shipped GREEN AND BROKEN.
+ * Types, lint, unit tests and CI cannot see a 28px card sitting inside a 24px
+ * frame; only a rendered surface can. These stories exist so the chrome
+ * inversion has something to be checked against that is not a number.
+ *
+ * Read them in pairs: the story named "…(the defect)" is what shipped up to
+ * 1.0.7, and the one beside it is what 2.0.0 renders.
+ */
+/**
+ * Plain CSF, no `Meta`/`StoryObj` type imports.
+ *
+ * `@storybook/react-vite` is a devDependency of `@bsuite/ui`, which owns the
+ * Storybook config; this package does not depend on Storybook and must not
+ * start to, or `pnpm typecheck` here fails on a type-only import for a tool
+ * that is not installed. CSF is a plain-object format — the indexer reads the
+ * default export and the named exports, and the types are optional sugar.
+ */
+type Story = {
+    name?: string;
+    render: () => ReactNode;
+};
+declare const _default: {
+    title: string;
+    parameters: {
+        layout: string;
+    };
+};
+export default _default;
+/**
+ * THE DEFECT, exactly as it shipped. A card inside the grid item's card:
+ * two radii, two 1px borders, two backgrounds. 316+ files render this.
+ */
+export declare const NestedCardDoubleFrame: Story;
+/** The same content on 2.0.0 defaults: ONE border, ONE radius. */
+export declare const NestedCardSingleFrame: Story;
+/** Bare content with chrome OFF — the regression the inversion could cause. */
+export declare const BareContentNoChrome: Story;
+/** The same bare content opting IN per item. This is the migration for the 10%. */
+export declare const BareContentOptsIn: Story;
+/**
+ * Every card width side by side. `w` defaulted to 12, so 1,068 of 1,729 usages
+ * rendered like the last row here — one card per row, the rest of the screen
+ * empty. That is the "cards don't use the available space" report.
+ */
+export declare const WidthLadder: Story;
+/**
+ * Card headings. `text-gradient-accent` is on 183 of 235 crm7 h1 page titles
+ * and 0 of 310 crm7 h2/h3 CARD headings — the element the operator keeps
+ * asking about. The pairing matters: the solid `text-(--role-text-heading)`
+ * sits UNDER the gradient as the fallback layer.
+ *
+ * `width: fit-content` inside the utility is load-bearing. Anything that
+ * overrides width makes a short heading sample only the first ~15% of the
+ * gradient and render flat — indistinguishable from having no gradient at all,
+ * which is why "is the class present" is not a check.
+ */
+export declare const CardHeadingGradient: Story;
+//# sourceMappingURL=cardSurfaces.stories.d.ts.map

package/dist/cardSurfaces.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardSurfaces.stories.d.ts","sourceRoot":"","sources":["../src/cardSurfaces.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC;;;;;;;;;;GAUG;AACH;;;;;;;;GAQG;AACH,KAAK,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,SAAS,CAAA;CAAE,CAAA;;;;;;;AAEvD,wBAGC;AA0BD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAYnC,CAAA;AAED,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,EAAE,KAWnC,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,EAAE,KAWjC,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,EAAE,KAW/B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,KAyBzB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAoBjC,CAAA"}

package/dist/cardSurfaces.stories.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PageGridLayout } from './PageGridLayout.js';
+export default {
+    title: 'Page Builder/Card surfaces',
+    parameters: { layout: 'fullscreen' },
+};
+/** What an app renders inside a slot: its own card. Border, radius, background. */
+function AppCard({ title, children }) {
+    return (_jsxs("div", { className: "h-full rounded-[var(--radius-card,1.5rem)] border border-border bg-card p-6 shadow-sm", children: [_jsx("h3", { className: "mb-2 text-lg font-semibold text-(--role-text-heading)", children: title }), _jsx("div", { className: "text-sm text-muted-foreground", children: children })] }));
+}
+/** Bare content: no surface of its own. This is the 10% that NEEDS the chrome. */
+function BareContent({ title }) {
+    return (_jsxs("div", { className: "p-6", children: [_jsx("h3", { className: "mb-2 text-lg font-semibold text-(--role-text-heading)", children: title }), _jsx("p", { className: "text-sm text-muted-foreground", children: "No surface of its own \u2014 this slot is the one that should opt IN to chrome." })] }));
+}
+const oneSlot = { lg: [{ i: 'a', x: 0, y: 0, w: 6, h: 6 }] };
+/**
+ * THE DEFECT, exactly as it shipped. A card inside the grid item's card:
+ * two radii, two 1px borders, two backgrounds. 316+ files render this.
+ */
+export const NestedCardDoubleFrame = {
+    name: 'Nested card — DOUBLE FRAME (the defect)',
+    render: () => (_jsx("div", { className: "p-8", children: _jsx(PageGridLayout, { pageKey: "sb/nested-defect", defaultLayouts: oneSlot, itemChrome: true, widgets: { a: _jsx(AppCard, { title: "Quick Actions", children: "Grid item chrome ON + app card." }) } }) })),
+};
+/** The same content on 2.0.0 defaults: ONE border, ONE radius. */
+export const NestedCardSingleFrame = {
+    name: 'Nested card — ONE frame (2.0.0 default)',
+    render: () => (_jsx("div", { className: "p-8", children: _jsx(PageGridLayout, { pageKey: "sb/nested-fixed", defaultLayouts: oneSlot, widgets: { a: _jsx(AppCard, { title: "Quick Actions", children: "Grid item chrome OFF; the app card is the only surface." }) } }) })),
+};
+/** Bare content with chrome OFF — the regression the inversion could cause. */
+export const BareContentNoChrome = {
+    name: 'Bare content, chrome OFF — the regression to watch for',
+    render: () => (_jsx("div", { className: "p-8", children: _jsx(PageGridLayout, { pageKey: "sb/bare-off", defaultLayouts: oneSlot, widgets: { a: _jsx(BareContent, { title: "Pipeline Overview" }) } }) })),
+};
+/** The same bare content opting IN per item. This is the migration for the 10%. */
+export const BareContentOptsIn = {
+    name: 'Bare content, per-item chrome ON — the migration',
+    render: () => (_jsx("div", { className: "p-8", children: _jsx(PageGridLayout, { pageKey: "sb/bare-on", defaultLayouts: { lg: [{ i: 'a', x: 0, y: 0, w: 6, h: 6, chrome: true }] }, widgets: { a: _jsx(BareContent, { title: "Pipeline Overview" }) } }) })),
+};
+/**
+ * Every card width side by side. `w` defaulted to 12, so 1,068 of 1,729 usages
+ * rendered like the last row here — one card per row, the rest of the screen
+ * empty. That is the "cards don't use the available space" report.
+ */
+export const WidthLadder = {
+    name: 'Width ladder — w = 2 / 3 / 4 / 6 / 12',
+    render: () => (_jsx("div", { className: "p-8", children: _jsx(PageGridLayout, { pageKey: "sb/widths", defaultLayouts: {
+                lg: [
+                    { i: 'w2', x: 0, y: 0, w: 2, h: 4 },
+                    { i: 'w3', x: 2, y: 0, w: 3, h: 4 },
+                    { i: 'w4', x: 5, y: 0, w: 4, h: 4 },
+                    { i: 'w6', x: 0, y: 4, w: 6, h: 4 },
+                    { i: 'w12', x: 0, y: 8, w: 12, h: 4 },
+                ],
+            }, widgets: {
+                w2: _jsx(AppCard, { title: "w=2" }),
+                w3: _jsx(AppCard, { title: "w=3" }),
+                w4: _jsx(AppCard, { title: "w=4" }),
+                w6: _jsx(AppCard, { title: "w=6 \u2014 the new default" }),
+                w12: _jsx(AppCard, { title: "w=12 \u2014 the old default, one card per row" }),
+            } }) })),
+};
+/**
+ * Card headings. `text-gradient-accent` is on 183 of 235 crm7 h1 page titles
+ * and 0 of 310 crm7 h2/h3 CARD headings — the element the operator keeps
+ * asking about. The pairing matters: the solid `text-(--role-text-heading)`
+ * sits UNDER the gradient as the fallback layer.
+ *
+ * `width: fit-content` inside the utility is load-bearing. Anything that
+ * overrides width makes a short heading sample only the first ~15% of the
+ * gradient and render flat — indistinguishable from having no gradient at all,
+ * which is why "is the class present" is not a check.
+ */
+export const CardHeadingGradient = {
+    name: 'Card headings — with and without the gradient',
+    render: () => (_jsxs("div", { className: "grid gap-8 p-8 md:grid-cols-2", children: [_jsxs("div", { className: "rounded-[var(--radius-card,1.5rem)] border border-border bg-card p-6", children: [_jsx("h3", { className: "mb-2 text-lg font-semibold text-(--role-text-heading)", children: "Quick Actions \u2014 flat (today, 0 of 310)" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "No gradient." })] }), _jsxs("div", { className: "rounded-[var(--radius-card,1.5rem)] border border-border bg-card p-6", children: [_jsx("h3", { className: "text-gradient-accent mb-2 text-lg font-semibold text-(--role-text-heading)", children: "Quick Actions \u2014 gradient (G2 target)" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "`text-gradient-accent` over the solid heading token." })] })] })),
+};

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { CanvasCard } from './CanvasCard.js';
 export type { CanvasCardProps } from './CanvasCard.js';
 export { DraggableCardPage } from './DraggableCardPage.js';
 export type { DraggableCardPageProps } from './DraggableCardPage.js';
-export { buildCanvasCardLayout, flattenCanvasCards, isCanvasCardElement, describeNode, clampColumns, CANVAS_GRID_COLUMNS, } from './canvasCardLayout.js';
+export { buildCanvasCardLayout, DEFAULT_CANVAS_CARD_WIDTH, flattenCanvasCards, isCanvasCardElement, describeNode, clampColumns, CANVAS_GRID_COLUMNS, } from './canvasCardLayout.js';
 export type { CanvasCardLayoutResult } from './canvasCardLayout.js';
 export type { WidgetConfig, PageEditorLauncherProps } from './PageEditorLauncher.js';
 export { usePageGridLayout, DEFAULT_EDITOR_EVENT_NAMES, PAGE_GRID_EDITING_EVENT, } from './usePageGridLayout.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,gCAAgC,EAChC,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,GACX,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,gCAAgC,EAChC,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -2,7 +2,7 @@ export { PageGridLayout } from './PageGridLayout.js';
 export { PageEditorLauncher } from './PageEditorLauncher.js';
 export { CanvasCard } from './CanvasCard.js';
 export { DraggableCardPage } from './DraggableCardPage.js';
-export { buildCanvasCardLayout, flattenCanvasCards, isCanvasCardElement, describeNode, clampColumns, CANVAS_GRID_COLUMNS, } from './canvasCardLayout.js';
+export { buildCanvasCardLayout, DEFAULT_CANVAS_CARD_WIDTH, flattenCanvasCards, isCanvasCardElement, describeNode, clampColumns, CANVAS_GRID_COLUMNS, } from './canvasCardLayout.js';
 export { usePageGridLayout, DEFAULT_EDITOR_EVENT_NAMES, PAGE_GRID_EDITING_EVENT, } from './usePageGridLayout.js';
 export { rescaleLayout } from './rescaleLayout.js';
 export { computeAutoHeightRows } from './autoHeight.js';

package/dist/scanner/cardHeadingScanner.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Which headings are CARD headings, and do they carry the gradient?
+ *
+ * WHY THIS EXISTS. The estate's heading gradient was implemented as a
+ * PAGE-TITLE convention and shipped: 183 of 232 crm7 `<h1>` page titles carry
+ * `.text-gradient-accent`. Card headings were never in scope, and the numbers
+ * say so plainly — 0 of 304 crm7 `<h2>`/`<h3>`, 15 of 734 estate-wide. The work
+ * was done, declared complete, and covered a DIFFERENT ELEMENT than the one the
+ * operator keeps pointing at. On the very dashboard he screenshotted,
+ * "Dashboard" (h1) has the gradient and "Quick Actions", "Communication Center"
+ * and "Pipeline Overview" (h2/h3) do not.
+ *
+ * SO WHY NOT JUST GREP `<h2`? Because `<h2>` is not the same thing as "card
+ * heading", and a sweep that treats them as equal gradients dialog titles,
+ * empty-state titles, section labels and table captions along with the cards.
+ * The operator asked for card headings. A detector that cannot tell a card
+ * heading from any other heading would deliver 734 changes to satisfy a request
+ * about roughly 600 of them, and the excess is what gets noticed.
+ *
+ * A heading is a CARD heading here when an enclosing element paints card chrome
+ * — a card component, or a border+radius+background surface — which is the same
+ * definition `cardSurfaceScanner` already uses for nested chrome. One definition
+ * of "card", two scanners.
+ *
+ * FAIL CLOSED. A file whose JSX tags do not balance is UNKNOWN, not clean: a
+ * tag stack that has lost its place cannot say what encloses what, and
+ * "checked nothing" must not share an exit code with "found nothing" (D-92).
+ *
+ * Node-only: filesystem access, exported from `@bsuite/page-builder/scanner`.
+ */
+export interface CardHeadingFinding {
+    file: string;
+    /** `h2` or `h3`. */
+    tag: string;
+    /** 1-based line of the heading's opening tag. */
+    line: number;
+    /** The chrome element that makes this a card heading. */
+    enclosingSurface: string;
+    /** Does it already carry a gradient class? */
+    hasGradient: boolean;
+    /**
+     * Classes that fight `width: fit-content`.
+     *
+     * `.text-gradient-accent` sets `width: fit-content`, and that is load-bearing
+     * — `background-clip: text` paints across the ELEMENT BOX, so a block-level
+     * heading spanning its container samples only the first slice of the gradient
+     * and renders flat, which is indistinguishable from having no gradient at
+     * all. But a heading that is `truncate`, `flex-1`, `w-full` or `line-clamp-*`
+     * DEPENDS on filling its box, and shrink-wrapping it changes the layout.
+     * Those headings need a decision, not a codemod.
+     */
+    widthDependentClasses: string[];
+}
+export interface CardHeadingScanResult {
+    findings: CardHeadingFinding[];
+    filesScanned: number;
+    scanRootsResolved: string[];
+    /** Files whose JSX could not be walked. UNKNOWN is not clean. */
+    unknownFiles: string[];
+    summary: string;
+}
+export interface CardHeadingScannerConfig {
+    projectRoot: string;
+    scanRoots: string[];
+    /** Component names that count as card chrome. */
+    cardTags: string[];
+    /** Extra chrome components, as in `cardSurfaceScanner`. */
+    nestedChromeTags?: string[];
+    /** Heading tags to consider. Defaults to h2 and h3 — h1 is the page title. */
+    headingTags?: string[];
+    /** Classes that already paint a heading gradient. */
+    gradientClasses?: string[];
+    extensions?: string[];
+}
+interface JsxTag {
+    kind: 'open' | 'close' | 'self';
+    tag: string;
+    attrs: string;
+    index: number;
+}
+/**
+ * Tokenise JSX tags with their kind and offset.
+ *
+ * `openingTags` in the sibling module is deliberately kind-blind — it only has
+ * to find chrome inside a known block. Ancestry needs a stack, and a stack
+ * needs to know which tags close.
+ */
+export declare function jsxTags(source: string): JsxTag[];
+export declare function scanCardHeadings(config: CardHeadingScannerConfig): CardHeadingScanResult;
+export {};
+//# sourceMappingURL=cardHeadingScanner.d.ts.map

package/dist/scanner/cardHeadingScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardHeadingScanner.d.ts","sourceRoot":"","sources":["../../src/scanner/cardHeadingScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAMH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;;;;;;OAUG;IACH,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iEAAiE;IACjE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAkDD,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAqDhD;AAsCD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,wBAAwB,GAAG,qBAAqB,CA+FxF"}