@bsuite/page-builder 1.0.6 → 1.1.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 1.1.0. Pass 12 to restore the pre-1.1.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-1.1.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 1.1.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 1.1.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 1.1.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 1.1.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 1.1.0 defaults: ONE border, ONE radius. */
+export const NestedCardSingleFrame = {
+    name: 'Nested card — ONE frame (1.1.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/cardSurfaceScanner.d.ts

@@ -46,7 +46,20 @@ export type CardSurfaceIdiom =
 /** autoHeight opt-out on a card that is not a virtualized list. */
  | 'autoheight-optout'
 /** autoHeight={false} with a seed height so small the card must clip. */
- | 'clipped-card';
+ | 'clipped-card'
+/**
+ * V-C5. A grid item whose child re-declares card chrome — border + radius +
+ * background — inside the chrome the grid item already paints. 28px inside
+ * 24px, two 1px borders. This is the idiom V-C4 (`glued-widget`) cannot see:
+ * ONE card in ONE slot is not glue, and it is still a double frame.
+ */
+ | 'nested-chrome'
+/**
+ * The file could not be parsed with confidence. NOT a clean verdict. A gate
+ * that cannot tell "checked nothing" from "found nothing" is not a gate
+ * (D-92), so an unparseable file gets its own idiom and its own exit path.
+ */
+ | 'unparseable';
 export interface CardSurfaceFinding {
     file: string;
     idiom: CardSurfaceIdiom;
@@ -95,6 +108,36 @@ export interface CardSurfaceScannerConfig {
     autoHeightEscapeHatch?: RegExp;
     /** File extensions to scan. Defaults to .tsx. */
     extensions?: string[];
+    /**
+     * Extra component names that count as CARD CHROME when they appear inside a
+     * grid slot — a component that paints its own border + radius + background.
+     * `cardTags` is always included; this is for app-local chrome components the
+     * glue check does not need (BSU `MagicCard`, conduit `CounterCard`, …).
+     */
+    nestedChromeTags?: string[];
+    /** file -> reason. A nested-chrome file listed here is allowed. */
+    nestedChromeExclusions?: Record<string, string>;
+    /**
+     * Does the GRID ITEM paint card chrome in the version this app resolves?
+     *
+     * TRUE for `@bsuite/page-builder` <= 1.0.7, where every grid item painted
+     * `rounded-3xl bg-card border border-border` unconditionally and there was
+     * no way to turn it off. On those versions a nested card is ALWAYS a double
+     * frame, so every nesting slot is a finding.
+     *
+     * FALSE from 1.1.0, where chrome is opt-in. A nested card then becomes the
+     * CORRECT shape — it is the only surface — and the defect narrows to a slot
+     * that opts back INTO chrome (`itemChrome`, or `chrome` on the item or the
+     * CanvasCard) AND still nests a card.
+     *
+     * DEFAULTS TO TRUE, i.e. it assumes the pre-inversion package until an app
+     * says otherwise. A shared-package fix that four consumers receive and one
+     * does not is this estate's recorded failure mode (conduit sat on a
+     * minor-locked `^0.6.3` while the fix shipped in 0.8.0, and nothing
+     * reported it), so each app must DECLARE which side of the inversion it is
+     * on rather than inherit an optimistic default.
+     */
+    gridItemPaintsChrome?: boolean;
 }
 export interface CardSurfaceScanResult {
     findings: CardSurfaceFinding[];
@@ -103,6 +146,14 @@ export interface CardSurfaceScanResult {
     scanRootsResolved: string[];
     /** Exclusion-ledger keys that no longer match any finding — stale entries. */
     staleExclusions: string[];
+    /**
+     * Files the scanner could NOT parse with confidence. These are UNKNOWN, not
+     * clean. A caller that treats an empty `findings` array as a pass while this
+     * array is non-empty has reproduced the exact defect D-92 names.
+     */
+    unknownFiles: string[];
+    /** Distinct files carrying at least one `nested-chrome` finding. */
+    nestedChromeFiles: string[];
     /** Human-readable account of how the verdict was reached. */
     summary: string;
 }
@@ -116,5 +167,54 @@ export interface CardSurfaceScanResult {
  * skipped entirely. Stripping first fixes both.
  */
 export declare function stripComments(source: string): string;
+/**
+ * Every opening tag in a JSX body, with its raw attribute text.
+ *
+ * Hand-rolled rather than regex-only because an attribute value can contain
+ * `>` inside a string, a template literal or a `{…}` expression — three of the
+ * five hand-rolled copies this module replaced were defeated by exactly that.
+ */
+export declare function openingTags(body: string): {
+    tag: string;
+    attrs: string;
+}[];
+/**
+ * Does this element paint its OWN card chrome?
+ *
+ * Chrome means all three of border, radius and background, because that is
+ * exactly what `PageGridLayout` already paints on the slot. Two of the three is
+ * a tinted panel or a divider, not a second card — requiring all three is what
+ * separates BSU's `glass-card rounded-2xl border-primary/30` (a real double
+ * frame) from a `rounded-lg bg-muted` inline chip (not one).
+ *
+ * Chrome declared through `style={{ background, border, borderRadius }}` counts
+ * the same as chrome declared through classes. BSU's `Settings.tsx` is chrome
+ * entirely in inline style; a class-only detector calls that file clean, which
+ * is how a nested card hides from a gate that only reads Tailwind.
+ */
+export declare function elementDeclaresCardChrome(el: {
+    tag: string;
+    attrs: string;
+}, chromeTags: Set<string>): string | null;
+/**
+ * Does this grid slot paint chrome of its OWN, post-inversion?
+ *
+ * Three ways to opt in, and all three have to be visible to the scanner or a
+ * re-chromed slot goes unnoticed: `itemChrome` on the grid component (whole
+ * app/page), `chrome: true` on the layout item, and `chrome` on the CanvasCard.
+ */
+export declare function slotOptsIntoChrome(fileSource: string, slotBody: string): boolean;
+/** The first nested-chrome element inside one grid slot, or null. */
+export declare function findNestedChrome(slotBody: string, config: Pick<CardSurfaceScannerConfig, 'cardTags' | 'nestedChromeTags'>): string | null;
+/**
+ * Can this file be parsed with confidence?
+ *
+ * Returns a reason when it CANNOT. Every `<CanvasCard` must pair with a
+ * `</CanvasCard>` the block regex can reach, and every `widgets={{` must close
+ * before EOF. A file that fails either is UNKNOWN — it is not reported clean,
+ * and it is not silently skipped. "Checked nothing" and "found nothing" do not
+ * share an exit code here.
+ */
+export declare function parseConfidence(src: string): string | null;
 export declare function scanCardSurfaces(config: CardSurfaceScannerConfig): CardSurfaceScanResult;
 //# sourceMappingURL=cardSurfaceScanner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cardSurfaceScanner.d.ts","sourceRoot":"","sources":["../../src/scanner/cardSurfaceScanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAKH,MAAM,MAAM,gBAAgB;AAC1B,2DAA2D;AACzD,cAAc;AAChB,6EAA6E;GAC3E,sBAAsB;AACxB,yEAAyE;GACvE,mBAAmB;AACrB,mEAAmE;GACjE,mBAAmB;AACrB,yEAAyE;GACvE,cAAc,CAAC;AAEnB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mFAAmF;IACnF,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,8EAA8E;IAC9E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB;AASD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKpD;AAwHD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,wBAAwB,GAC/B,qBAAqB,CAwIvB"}
+{"version":3,"file":"cardSurfaceScanner.d.ts","sourceRoot":"","sources":["../../src/scanner/cardSurfaceScanner.ts"],"names":[],"mappings":"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"}

package/dist/scanner/cardSurfaceScanner.js

@@ -55,8 +55,17 @@ const DEFAULT_GRID_PRIMITIVES = [
  */
 export function stripComments(source) {
     return source
-        .replace(/\{\s*\/\*[\s\S]*?\*\/\s*\}/g, '') // {/* JSX comment */}
-        .replace(/\/\*[\s\S]*?\*\//g, '') // /* block */
+        // {/* JSX comment */} — TEMPERED so the match cannot span a `*​/` it did
+        // not open. The naive lazy form `\{\s*\/\*[\s\S]*?\*\/\s*\}` backtracks
+        // past the comment's own terminator whenever the next character is not
+        // `}` — e.g. an ordinary block comment sitting at the head of an object
+        // literal — and then matches the NEXT `*​/}` anywhere later in the file,
+        // DELETING every line between. crm7 `src/pages/people/new/worker.tsx` lost
+        // 37 lines and two whole `<CanvasCard>` blocks to exactly that, which the
+        // UNKNOWN gate below caught as unbalanced tags. Code silently deleted
+        // before matching is a scanner that under-reports and calls it clean.
+        .replace(/\{\s*\/\*(?:(?!\*\/)[\s\S])*\*\/\s*\}/g, '')
+        .replace(/\/\*(?:(?!\*\/)[\s\S])*\*\//g, '') // /* block */
         .replace(/(^|[^:])\/\/[^\n]*/g, '$1'); // // line, but not http://
 }
 function tagPattern(tags) {
@@ -159,6 +168,293 @@ function extractWidgetEntries(source) {
     }
     return out;
 }
+/* ==========================================================================
+ * V-C5 — NESTED CHROME
+ *
+ * `PageGridLayout` paints EVERY grid item as a card:
+ *
+ *   h-full w-full rounded-3xl transition-all flex flex-col
+ *   bg-card border border-border shadow-sm dark:shadow-[var(--glow-card,none)]
+ *
+ * When the slot's own content re-declares that surface — border + radius +
+ * background — the user sees 28px inside 24px and two 1px borders. V-C4
+ * (`glued-widget`) cannot see this: ONE card in ONE slot is not glue, and it
+ * is still a double frame. That is why 316 files across the estate render a
+ * card inside a card and every existing gate reads green.
+ * ========================================================================== */
+/** Components that paint their own card chrome. */
+const DEFAULT_NESTED_CHROME_TAGS = [
+    'Card',
+    'MagicCard',
+    'GlassCard',
+    'NeonCard',
+    'StatCard',
+    'SummaryCard',
+    'ServiceCard',
+    'CounterCard',
+    'MetricCard',
+    'InfoCard',
+];
+/**
+ * Elements that are CONTROLS, not surfaces.
+ *
+ * A bordered, rounded, tinted `<button>` is a button. A `<Badge>` is a pill.
+ * Counting them as nested chrome is how a detector inflates: throughput's
+ * `Teams.tsx` carries `border … rounded … text-…` on a filter button, which is
+ * correct styling and not a second card. Chrome on a control is never the
+ * double-frame defect, so controls are excluded BY TAG rather than by tuning
+ * the class thresholds until the number looks right.
+ */
+const CONTROL_TAGS = new Set([
+    'button',
+    'a',
+    'input',
+    'select',
+    'textarea',
+    'label',
+    'summary',
+    'Button',
+    'Input',
+    'Select',
+    'SelectTrigger',
+    'SelectContent',
+    'Textarea',
+    'Badge',
+    'Avatar',
+    'AvatarFallback',
+    'Switch',
+    'Checkbox',
+    'Progress',
+    'Slider',
+    'Toggle',
+    'ToggleGroup',
+    'ToggleGroupItem',
+    'TabsList',
+    'TabsTrigger',
+    'Skeleton',
+    'Tooltip',
+    'TooltipContent',
+    'DropdownMenuContent',
+    'PopoverContent',
+]);
+const RADIUS_CLASS = /(?:^|[\s'"`])rounded(?:-[a-z0-9[\]().\-/]+)?(?=$|[\s'"`])/;
+const BORDER_CLASS = /(?:^|[\s'"`])border(?:-[a-z0-9[\]().\-/]+)?(?=$|[\s'"`])/;
+const BG_CLASS = /(?:^|[\s'"`])(?:bg-[a-z0-9[\]().\-/]+|glass-card|neon-card|card-surface)(?=$|[\s'"`])/;
+/**
+ * Composite classes that are a WHOLE card surface on their own.
+ *
+ * BSU's `.glass-card` (business-suite-unified/src/index.css:760) declares
+ * `background-color` AND `border: 1px solid` AND a shadow. `glass-card
+ * rounded-xl` is therefore already border + radius + background — the full
+ * double frame — while carrying no `border-*` utility for a class matcher to
+ * find. Requiring three separate Tailwind utilities makes every composite-class
+ * card invisible; BSU `Government.tsx` is exactly that shape.
+ */
+const COMPOSITE_CARD_CLASS = /(?:^|[\s'"`])(?:glass-card|neon-card|card-surface)(?=$|[\s'"`])/;
+const RADIUS_STYLE = /\bborder-?[Rr]adius\b/;
+const BORDER_STYLE = /\bborder(?:Color|Width|Style)?\s*:/;
+const BG_STYLE = /\b(?:background|backgroundColor|backgroundImage)\s*:/;
+/**
+ * Every opening tag in a JSX body, with its raw attribute text.
+ *
+ * Hand-rolled rather than regex-only because an attribute value can contain
+ * `>` inside a string, a template literal or a `{…}` expression — three of the
+ * five hand-rolled copies this module replaced were defeated by exactly that.
+ */
+export function openingTags(body) {
+    const out = [];
+    for (let i = 0; i < body.length; i++) {
+        if (body[i] !== '<')
+            continue;
+        const nameMatch = /^<([A-Za-z][A-Za-z0-9._-]*)/.exec(body.slice(i, i + 64));
+        if (!nameMatch)
+            continue;
+        let j = i + nameMatch[0].length;
+        let depth = 0;
+        let quote = null;
+        let closed = false;
+        for (; j < body.length; j++) {
+            const c = body[j];
+            if (quote) {
+                if (c === quote && body[j - 1] !== '\\')
+                    quote = null;
+                continue;
+            }
+            if (c === '"' || c === "'" || c === '`') {
+                quote = c;
+                continue;
+            }
+            if (c === '{')
+                depth++;
+            else if (c === '}')
+                depth--;
+            else if (c === '>' && depth === 0) {
+                closed = true;
+                break;
+            }
+        }
+        if (!closed)
+            continue;
+        out.push({ tag: nameMatch[1], attrs: body.slice(i + nameMatch[0].length, j) });
+        i = j;
+    }
+    return out;
+}
+/** Every className value on one element — string, template literal or `cn(...)`. */
+function classValues(attrs) {
+    const out = [];
+    const re = /class(?:Name)?\s*=\s*(?:"([^"]*)"|'([^']*)'|\{([\s\S]*)\})/;
+    const m = re.exec(attrs);
+    if (!m)
+        return out;
+    if (m[1] !== undefined)
+        out.push(m[1]);
+    else if (m[2] !== undefined)
+        out.push(m[2]);
+    else if (m[3] !== undefined) {
+        // `{cn('a', cond && 'b')}` / `{`a ${x}`}` — take every literal inside.
+        const lit = /(?:"([^"]*)"|'([^']*)'|`([^`]*)`)/g;
+        let l;
+        while ((l = lit.exec(m[3])) !== null)
+            out.push(l[1] ?? l[2] ?? l[3] ?? '');
+    }
+    return out;
+}
+/** The raw text of an inline `style={{ … }}` attribute, if present. */
+function styleValue(attrs) {
+    const i = attrs.indexOf('style');
+    if (i < 0)
+        return null;
+    const m = /style\s*=\s*\{/.exec(attrs.slice(i));
+    if (!m)
+        return null;
+    let depth = 0;
+    const start = i + m.index + m[0].length - 1;
+    for (let j = start; j < attrs.length; j++) {
+        if (attrs[j] === '{')
+            depth++;
+        else if (attrs[j] === '}') {
+            depth--;
+            if (depth === 0)
+                return attrs.slice(start, j + 1);
+        }
+    }
+    return null;
+}
+/**
+ * Does this element paint its OWN card chrome?
+ *
+ * Chrome means all three of border, radius and background, because that is
+ * exactly what `PageGridLayout` already paints on the slot. Two of the three is
+ * a tinted panel or a divider, not a second card — requiring all three is what
+ * separates BSU's `glass-card rounded-2xl border-primary/30` (a real double
+ * frame) from a `rounded-lg bg-muted` inline chip (not one).
+ *
+ * Chrome declared through `style={{ background, border, borderRadius }}` counts
+ * the same as chrome declared through classes. BSU's `Settings.tsx` is chrome
+ * entirely in inline style; a class-only detector calls that file clean, which
+ * is how a nested card hides from a gate that only reads Tailwind.
+ */
+export function elementDeclaresCardChrome(el, chromeTags) {
+    if (chromeTags.has(el.tag))
+        return `<${el.tag}> paints its own card chrome`;
+    if (CONTROL_TAGS.has(el.tag))
+        return null;
+    for (const value of classValues(el.attrs)) {
+        const composite = COMPOSITE_CARD_CLASS.test(value);
+        const hasBorder = composite || BORDER_CLASS.test(value);
+        const hasBg = composite || BG_CLASS.test(value);
+        if (RADIUS_CLASS.test(value) && hasBorder && hasBg)
+            return `<${el.tag}> className declares border + radius + background ("${value.replace(/\s+/g, ' ').trim().slice(0, 80)}")`;
+    }
+    const style = styleValue(el.attrs);
+    if (style && RADIUS_STYLE.test(style) && BORDER_STYLE.test(style) && BG_STYLE.test(style))
+        return `<${el.tag}> inline style declares border + radius + background`;
+    // Mixed: radius as a class, border+background as inline style. BSU
+    // `Settings.tsx` is exactly this shape.
+    if (style) {
+        const classText = classValues(el.attrs).join(' ');
+        const composite = COMPOSITE_CARD_CLASS.test(classText);
+        const hasRadius = RADIUS_CLASS.test(classText) || RADIUS_STYLE.test(style);
+        const hasBorder = composite || BORDER_CLASS.test(classText) || BORDER_STYLE.test(style);
+        const hasBg = composite || BG_CLASS.test(classText) || BG_STYLE.test(style);
+        if (hasRadius && hasBorder && hasBg)
+            return `<${el.tag}> declares border + radius + background across className and inline style`;
+    }
+    return null;
+}
+/**
+ * Does this grid slot paint chrome of its OWN, post-inversion?
+ *
+ * Three ways to opt in, and all three have to be visible to the scanner or a
+ * re-chromed slot goes unnoticed: `itemChrome` on the grid component (whole
+ * app/page), `chrome: true` on the layout item, and `chrome` on the CanvasCard.
+ */
+export function slotOptsIntoChrome(fileSource, slotBody) {
+    const openTag = /^<CanvasCard[\s\S]*?>/.exec(slotBody)?.[0] ?? '';
+    if (/\bchrome\s*(?:=\s*\{?\s*true\b|\}|[\s/>])/.test(openTag) &&
+        !/\bchrome\s*=\s*\{\s*false\s*\}/.test(openTag))
+        return true;
+    if (/\bitemChrome\b(?!\s*=\s*\{\s*false\s*\})/.test(fileSource))
+        return true;
+    if (/\bchrome\s*:\s*true\b/.test(fileSource))
+        return true;
+    return false;
+}
+/** The first nested-chrome element inside one grid slot, or null. */
+export function findNestedChrome(slotBody, config) {
+    const chromeTags = new Set([
+        ...config.cardTags,
+        ...(config.nestedChromeTags ?? DEFAULT_NESTED_CHROME_TAGS),
+    ]);
+    // Skip the slot's own opening tag — `<CanvasCard>` is the grid item, not a
+    // child of it.
+    const inner = slotBody.replace(/^<CanvasCard[\s\S]*?>/, '');
+    for (const el of openingTags(inner)) {
+        const hit = elementDeclaresCardChrome(el, chromeTags);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+/**
+ * Can this file be parsed with confidence?
+ *
+ * Returns a reason when it CANNOT. Every `<CanvasCard` must pair with a
+ * `</CanvasCard>` the block regex can reach, and every `widgets={{` must close
+ * before EOF. A file that fails either is UNKNOWN — it is not reported clean,
+ * and it is not silently skipped. "Checked nothing" and "found nothing" do not
+ * share an exit code here.
+ */
+export function parseConfidence(src) {
+    const opens = (src.match(/<CanvasCard[\s/>]/g) ?? []).length;
+    const selfClosing = (src.match(/<CanvasCard[^<>]*\/>/g) ?? []).length;
+    const closes = (src.match(/<\/CanvasCard>/g) ?? []).length;
+    if (opens - selfClosing !== closes)
+        return `unbalanced CanvasCard tags: ${opens} opening (${selfClosing} self-closing) vs ${closes} closing`;
+    const blocks = extractCanvasCardBlocks(src).length;
+    if (blocks !== closes)
+        return `CanvasCard block extraction recovered ${blocks} of ${closes} blocks (nested or dynamically composed CanvasCards)`;
+    const widgetStarts = (src.match(/widgets=\{\{/g) ?? []).length;
+    if (widgetStarts > 0) {
+        const re = /widgets=\{\{/g;
+        let m;
+        while ((m = re.exec(src)) !== null) {
+            let depth = 2;
+            let i = m.index + m[0].length;
+            while (i < src.length && depth > 0) {
+                if (src[i] === '{')
+                    depth++;
+                else if (src[i] === '}')
+                    depth--;
+                i++;
+            }
+            if (depth !== 0)
+                return 'widgets={{ … }} object literal never closes before EOF';
+        }
+    }
+    return null;
+}
 function walk(dir, extensions, acc) {
     for (const entry of readdirSync(dir)) {
         if (entry === 'node_modules' || entry === 'dist' || entry === '.git')
@@ -177,6 +473,7 @@ export function scanCardSurfaces(config) {
     const findings = [];
     const files = [];
     const scanRootsResolved = [];
+    const unknownFiles = [];
     // D-92: assert the inputs were present BEFORE reporting any verdict. A
     // missing scan root must fail loudly, not produce a confident zero.
     for (const root of config.scanRoots) {
@@ -216,14 +513,53 @@ export function scanCardSurfaces(config) {
     }
     for (const file of files) {
         const rel = relative(config.projectRoot, file);
-        const raw = readFileSync(file, 'utf8');
+        let raw;
+        try {
+            raw = readFileSync(file, 'utf8');
+        }
+        catch (err) {
+            // A file we could not READ is UNKNOWN, never clean.
+            unknownFiles.push(rel);
+            findings.push({
+                file: rel,
+                idiom: 'unparseable',
+                detail: `could not be read: ${err.message}`,
+            });
+            continue;
+        }
         const src = stripComments(raw);
+        // D-92 fail-closed: decide whether this file can be parsed with confidence
+        // BEFORE reporting any verdict about it. An UNKNOWN file is recorded as
+        // UNKNOWN and still scanned on a best-effort basis — what it must never do
+        // is contribute a silent "clean".
+        const unparseable = parseConfidence(src);
+        if (unparseable) {
+            unknownFiles.push(rel);
+            findings.push({ file: rel, idiom: 'unparseable', detail: unparseable });
+        }
         // --- glued widget: 2+ cards inside ONE grid slot -----------------------
         const slots = [
             ...extractCanvasCardBlocks(src).map((b, i) => ({ label: `CanvasCard#${i + 1}`, body: b })),
             ...extractWidgetEntries(src).map((e) => ({ label: `widgets.${e.key}`, body: e.body })),
         ];
+        let nestedChromeReported = false;
         for (const slot of slots) {
+            // --- V-C5 nested chrome: ONE card inside ONE slot is still a double
+            // frame, and V-C4 below cannot see it (it needs 2+).
+            const gridItemChromed = (config.gridItemPaintsChrome ?? true) || slotOptsIntoChrome(src, slot.body);
+            if (gridItemChromed && !nestedChromeReported && !config.nestedChromeExclusions?.[rel]) {
+                const chrome = findNestedChrome(slot.body, config);
+                if (chrome) {
+                    nestedChromeReported = true;
+                    findings.push({
+                        file: rel,
+                        idiom: 'nested-chrome',
+                        detail: `${slot.label} ${chrome}. The grid item already paints ` +
+                            `rounded-3xl + bg-card + border-border, so this renders a card inside a card — ` +
+                            `mismatched corners and a doubled 1px edge.`,
+                    });
+                }
+            }
             const n = countCardTags(slot.body, config);
             const mapped = hasMappedCards(slot.body, config);
             if (n > 1 || mapped) {
@@ -280,10 +616,23 @@ export function scanCardSurfaces(config) {
         ...Object.keys(config.gluedExclusions ?? {}).filter((f) => !hit.has(`glued-widget:${f}`) && !hit.has(`autoheight-optout:${f}`)),
         ...Object.keys(config.ungriddedExclusions ?? {}).filter((f) => !hit.has(`ungridded-multi-card:${f}`)),
     ];
+    const nestedChromeFiles = [
+        ...new Set(findings.filter((f) => f.idiom === 'nested-chrome').map((f) => f.file)),
+    ];
     const summary = `scanned ${files.length} files across ${scanRootsResolved.length} root(s) [${scanRootsResolved.join(', ')}] ` +
         `with cardTags [${config.cardTags.join(', ')}]` +
         `${config.classSurfaces?.length ? ` + ${config.classSurfaces.length} class surface pattern(s)` : ''}; ` +
-        `${findings.length} finding(s); ${Object.keys(config.blindSpots ?? {}).length} declared blind spot(s); ` +
-        `${staleExclusions.length} stale exclusion(s).`;
-    return { findings, filesScanned: files.length, scanRootsResolved, staleExclusions, summary };
+        `${findings.length} finding(s) incl. ${nestedChromeFiles.length} nested-chrome file(s); ` +
+        `${Object.keys(config.blindSpots ?? {}).length} declared blind spot(s); ` +
+        `${staleExclusions.length} stale exclusion(s); ` +
+        `${unknownFiles.length} UNKNOWN file(s) — an UNKNOWN is not a clean file.`;
+    return {
+        findings,
+        filesScanned: files.length,
+        scanRootsResolved,
+        staleExclusions,
+        unknownFiles,
+        nestedChromeFiles,
+        summary,
+    };
 }

package/dist/scanner/index.d.ts

@@ -1,3 +1,3 @@
-export { scanCardSurfaces, stripComments } from './cardSurfaceScanner.js';
+export { scanCardSurfaces, stripComments, openingTags, elementDeclaresCardChrome, findNestedChrome, parseConfidence, slotOptsIntoChrome, } from './cardSurfaceScanner.js';
 export type { CardSurfaceScannerConfig, CardSurfaceScanResult, CardSurfaceFinding, CardSurfaceIdiom, } from './cardSurfaceScanner.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC1E,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC"}

package/dist/scanner/index.js

@@ -1 +1 @@
-export { scanCardSurfaces, stripComments } from './cardSurfaceScanner.js';
+export { scanCardSurfaces, stripComments, openingTags, elementDeclaresCardChrome, findNestedChrome, parseConfidence, slotOptsIntoChrome, } from './cardSurfaceScanner.js';

package/dist/types.d.ts

@@ -15,6 +15,17 @@ export interface GridLayoutItem extends LayoutItem {
      * operator-mandated capability. See the `activeLayouts` memo.
      */
     autoHeight?: boolean;
+    /**
+     * Paint THIS item as a card — border, radius, background, shadow.
+     *
+     * Undefined falls back to `PageGridLayout`'s `itemChrome`, which is FALSE.
+     * Up to 1.0.7 every grid item painted chrome unconditionally and there was
+     * no way to turn it off; 332 files across six apps render their own card
+     * inside it. Set this true on a slot whose content is BARE — a heading, a
+     * chart, a list with no surface of its own — and leave it alone everywhere
+     * the content already is a card.
+     */
+    chrome?: boolean;
     /**
      * True once the user has resized this item with the SE handle.
      *
@@ -147,6 +158,15 @@ export interface PageGridLayoutProps extends UsePageGridLayoutOptions {
     widgetMeta?: Record<string, WidgetMeta>;
     className?: string;
     isResizable?: boolean;
+    /**
+     * Paint every grid item as a card unless the item says otherwise.
+     *
+     * DEFAULT FALSE. This is the app-level migration lever for the 1.1.0 chrome
+     * inversion: an app that has not yet migrated its bare slots passes
+     * `itemChrome` and gets the pre-1.1.0 look back exactly, then flips slot by
+     * slot with `GridLayoutItem.chrome`. Per-item always wins.
+     */
+    itemChrome?: boolean;
     resizeHandles?: readonly ResizeHandleAxis[];
     /**
      * The signed-in caller's tenant. Threaded into every widget-factory call

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/usePageGridLayout.d.ts

@@ -27,10 +27,17 @@ export declare const PAGE_GRID_EDITING_EVENT = "bsuite-page-grid-editing";
  * was additionally polluted with frozen derived breakpoints, so all of them
  * reset once to the corrected defaults.
  *
+ * 1000 -> 2000 (2026-08-25, V-C5/G1): two more all-grids defaults changed in
+ * one release — the grid item no longer paints card chrome, and a `CanvasCard`
+ * that omits `w` is now half the grid rather than all of it. Every stored
+ * layout was written under the old width default, so a saved `w: 12` would
+ * fight the new default forever and the page would keep stacking. An epoch
+ * bump is the only lever that reaches every consumer at once.
+ *
  * Per-page `layoutVersion` bumps keep working on top; this only moves the
  * floor.
  */
-export declare const PACKAGE_LAYOUT_EPOCH = 1000;
+export declare const PACKAGE_LAYOUT_EPOCH = 2000;
 export interface PageGridEditingEventDetail {
     pageKey: string;
     editing: boolean;

package/dist/usePageGridLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePageGridLayout.d.ts","sourceRoot":"","sources":["../src/usePageGridLayout.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAGV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,0BAA0B,2IAM7B,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAiBzC,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAyDD,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,cAAc,EACd,WAAgB,EAChB,aAAiB,EACjB,WAAkB,EAClB,gBAA6C,EAC7C,iBAA4C,EAC5C,iBAAiB,GAClB,EAAE,wBAAwB,GAAG,uBAAuB,CAusBpD"}
+{"version":3,"file":"usePageGridLayout.d.ts","sourceRoot":"","sources":["../src/usePageGridLayout.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAGV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,0BAA0B,2IAM7B,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAiBzC,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,cAAc,EACd,WAAgB,EAChB,aAAiB,EACjB,WAAkB,EAClB,gBAA6C,EAC7C,iBAA4C,EAC5C,iBAAiB,GAClB,EAAE,wBAAwB,GAAG,uBAAuB,CA2sBpD"}

package/dist/usePageGridLayout.js

@@ -37,10 +37,17 @@ export const PAGE_GRID_EDITING_EVENT = 'bsuite-page-grid-editing';
  * was additionally polluted with frozen derived breakpoints, so all of them
  * reset once to the corrected defaults.
  *
+ * 1000 -> 2000 (2026-08-25, V-C5/G1): two more all-grids defaults changed in
+ * one release — the grid item no longer paints card chrome, and a `CanvasCard`
+ * that omits `w` is now half the grid rather than all of it. Every stored
+ * layout was written under the old width default, so a saved `w: 12` would
+ * fight the new default forever and the page would keep stacking. An epoch
+ * bump is the only lever that reaches every consumer at once.
+ *
  * Per-page `layoutVersion` bumps keep working on top; this only moves the
  * floor.
  */
-export const PACKAGE_LAYOUT_EPOCH = 1000;
+export const PACKAGE_LAYOUT_EPOCH = 2000;
 /**
  * Default for `GridLayoutItem.autoHeight` when an item does not state one.
  *
@@ -55,57 +62,6 @@ export const PACKAGE_LAYOUT_EPOCH = 1000;
  * opts out with an explicit `autoHeight: false`.
  */
 const DEFAULT_ITEM_AUTO_HEIGHT = true;
-/**
- * Do two layout SETS describe the same arrangement, at every breakpoint?
- *
- * Compares only the five fields that place an item. Anything else react-grid-layout
- * attaches (`moved`, `static`, `isDraggable`, measured heights) is noise here, and
- * comparing it would make every reflow look like a change.
- *
- * EVERY breakpoint, not just `lg`. A gesture made while the canvas is at `md`
- * leaves `lg` untouched, so an `lg`-only comparison reads that real gesture as a
- * reflow and silently drops it. That is not hypothetical — it broke the D-75
- * "folds a gesture made at md back onto lg" test the moment the comparison was
- * introduced.
- */
-function sameArrangement(a, b) {
-    return compare(a, b, false);
-}
-/** Same, but blind to the height of items whose height is MEASURED, not authored. */
-function samePlacement(a, b) {
-    return compare(a, b, true);
-}
-function compare(a, b, ignoreDerivedHeight) {
-    if (!a || !b)
-        return false;
-    const keys = new Set([...Object.keys(a), ...Object.keys(b)]);
-    /*
-     * `h` is EXCLUDED for an autoHeight item, and that exclusion is the whole point.
-     *
-     * An autoHeight card's height is MEASURED, not authored: change the column count,
-     * the card gets narrower, its content rewraps taller, and the ResizeObserver
-     * emits a new `h`. That emission differs from what was rendered, so a comparison
-     * including `h` calls it a gesture — and commits the RESCALED WIDTHS riding along
-     * with it. Measured: three cards authored w=4,3,4 came back w=1,1,1 after nothing
-     * but a height re-measure.
-     *
-     * NARROWED, because the first version was too broad and two existing tests said
-     * so: a user CAN drag an autoHeight card's height, and that stamps `hUserSet`.
-     * Once stamped, the height IS a choice and must be compared like any other. So
-     * `h` is excluded only where it is purely derived — autoHeight AND not user-set.
-     * A real resize changes `w`, or stamps `hUserSet`, or both; none of those are
-     * hidden by this.
-     */
-    const fingerprint = (items) => (items ?? [])
-        .map((i) => `${i.i}:${i.x}:${i.y}:${i.w}:${ignoreDerivedHeight && i.autoHeight ? 'auto' : i.h}`)
-        .sort()
-        .join('|');
-    for (const k of keys) {
-        if (fingerprint(a[k]) !== fingerprint(b[k]))
-            return false;
-    }
-    return true;
-}
 export function usePageGridLayout({ pageKey, defaultLayouts, defaultCols = 12, layoutVersion = 1, canEditPage = true, editorEventNames = DEFAULT_EDITOR_EVENT_NAMES, preferenceAdapter = defaultPreferenceAdapter, defaultAutoHeight, }) {
     const effectiveLayoutVersion = layoutVersion + PACKAGE_LAYOUT_EPOCH;
     const containerRef = useRef(null);
@@ -512,28 +468,33 @@ export function usePageGridLayout({ pageKey, defaultLayouts, defaultCols = 12, l
          * Identified by comparison rather than by a flag, so it needs no event
          * ordering to be correct.
          */
-        const emitted = layouts;
-        /* Identical to what was just rendered: a pure reflow, nothing to commit. */
-        if (sameArrangement(emitted, currentLayouts))
-            return;
         /*
-         * DIFFERS ONLY IN THE HEIGHT OF AN autoHeight ITEM — and that is ambiguous
-         * by shape alone. A user CAN drag such a card taller (crm7#744), and the
-         * ResizeObserver ALSO emits a new height when the card is narrowed by a
-         * column change, because the content rewraps. Both arrive as a bare `h`.
+         * ONLY A POINTER GESTURE MAY COMMIT A LAYOUT. Nothing else.
+         *
+         * Three attempts tried to classify the emission by SHAPE and all three
+         * shipped and all three failed on the deployed app:
+         *
+         *   1.0.4  removed the writes in handleColumnChange   — the grid still emitted
+         *   1.0.5  skipped an emission equal to what we rendered
+         *   1.0.6  ...ignoring measured heights as well
+         *
+         * Shape can never work, and the reason is structural: react-grid-layout
+         * COMPACTS after a reflow. Its emission is therefore legitimately different
+         * from `currentLayouts` in x and y, so every comparison against what we
+         * rendered says "this is a gesture" and commits the rescaled arrangement.
+         * Measured on d.crm.crm7.app with 1.0.6 confirmed in the served bundle: a
+         * 12 -> 4 -> 8 -> 2 -> 12 round trip produced THIRTEEN writes and turned
+         * widths 4,4,4,7,5,5,12 into 6,6,6,6,6,6,6.
          *
-         * Nothing in the layout distinguishes them, so the caller must: the grid
-         * knows whether a pointer gesture just ended. Default TRUE keeps every
-         * existing caller behaving exactly as before; `PageGridLayout` passes the
-         * real answer.
+         * The grid knows what we cannot infer: whether a pointer gesture produced
+         * this emission. That is the only sound signal, so it is the whole rule.
          *
-         * Getting this wrong in either direction is expensive. Treat a re-measure
-         * as a gesture and the RESCALED WIDTHS ride along into storage — measured:
-         * three cards authored w=4,3,4 came back w=1,1,1 after nothing but a height
-         * re-measure. Treat a gesture as a re-measure and a deliberate resize is
-         * silently dropped, which is crm7#744 reopened.
+         * Every other mutation — add, remove, compact, reset — calls `commitItems`
+         * directly and is unaffected. A deliberate resize of an auto-height card
+         * (crm7#744) IS a gesture and still commits. `wasGesture` defaults to true,
+         * so any caller that does not pass it behaves exactly as before.
          */
-        if (!wasGesture && samePlacement(emitted, currentLayouts))
+        if (!wasGesture)
             return;
         pendingLayoutRef.current = layouts;
         if (layoutCommitFrameRef.current !== null)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsuite/page-builder",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "Shared BSuite responsive page-builder grid and layout persistence primitives",
   "type": "module",
   "license": "UNLICENSED",