@bsuite/page-builder 1.0.7 → 2.0.0

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,5 @@
-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';
+export { scanCardHeadings, jsxTags } from './cardHeadingScanner.js';
+export type { CardHeadingScannerConfig, CardHeadingScanResult, CardHeadingFinding, } from './cardHeadingScanner.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;AAEjC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC"}

package/dist/scanner/index.js

@@ -1 +1,2 @@
-export { scanCardSurfaces, stripComments } from './cardSurfaceScanner.js';
+export { scanCardSurfaces, stripComments, openingTags, elementDeclaresCardChrome, findNestedChrome, parseConfidence, slotOptsIntoChrome, } from './cardSurfaceScanner.js';
+export { scanCardHeadings, jsxTags } from './cardHeadingScanner.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 2.0.0 chrome
+     * inversion: an app that has not yet migrated its bare slots passes
+     * `itemChrome` and gets the pre-2.0.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;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"}
+{"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.
  *

package/package.json

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