@bsuite/page-builder 0.7.0 → 0.9.0

package/dist/scanner/cardSurfaceScanner.js

@@ -0,0 +1,289 @@
+/**
+ * The card-surface contract scanner — ONE implementation, shipped from the
+ * package, replacing five divergent hand-rolled copies.
+ *
+ * Why this exists
+ * ---------------
+ * crm7 wrote a card-unglue contract test. BSU, conduit, throughput and braden
+ * each PORTED it, and each silently dropped checks during the port. The
+ * divergence was not cosmetic:
+ *
+ *   - `findUngriddedMultiCard` — the check crm7's own comment calls "the actual
+ *     root cause of the operator's platform-wide complaint" — was ABSENT from
+ *     BSU, throughput and braden, and present only in a narrowed form in
+ *     conduit. In throughput and braden it was absent structurally: their glue
+ *     scan is gated on the file containing `CanvasCard` at all, so a page with
+ *     two cards and no grid primitive is invisible by construction.
+ *   - conduit's header documents THREE card idioms and its regexes detect TWO.
+ *     The third (`rounded-lg border p-4` section panels) has no detector, which
+ *     is how five known-glued conduit pages pass as an empty ledger.
+ *   - BSU's scan only walks files containing the literal string
+ *     `PageGridLayout`, so every BSU page that never adopted the grid is
+ *     structurally invisible to BSU's own gate.
+ *
+ * A gate that cannot tell "checked nothing" from "found nothing" is not a gate
+ * (D-92). This module therefore ASSERTS ITS INPUTS: it fails closed if a scan
+ * root is missing or matches zero files, and it reports how it reached its
+ * verdict rather than only the verdict.
+ *
+ * What stays per-app
+ * ------------------
+ * Scan roots, card vocabulary, class-based surface patterns, and the exclusion
+ * ledgers. Those are operational truth about a specific app. Everything else —
+ * the detection logic — lives here so it can only be fixed once.
+ *
+ * Node-only: this module touches the filesystem and is exported from
+ * `@bsuite/page-builder/scanner`, NOT from the package root, so it never
+ * reaches a browser bundle.
+ */
+import { readFileSync, readdirSync, statSync, existsSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+const DEFAULT_GRID_PRIMITIVES = [
+    'CanvasCard',
+    'DraggableCardPage',
+    'PageGridLayout',
+    'usePageGridLayout',
+];
+/**
+ * Strip block comments, line comments and JSX comments before matching.
+ *
+ * Three of the five hand-rolled copies matched against raw file content, which
+ * produced two opposite errors at once: a commented-out `<Card/><Card/>`
+ * example false-POSITIVES as glue, and a file that merely MENTIONS
+ * `CanvasCard` in a TODO comment false-NEGATIVES as "already gridded" and is
+ * skipped entirely. Stripping first fixes both.
+ */
+export function stripComments(source) {
+    return source
+        .replace(/\{\s*\/\*[\s\S]*?\*\/\s*\}/g, '') // {/* JSX comment */}
+        .replace(/\/\*[\s\S]*?\*\//g, '') // /* block */
+        .replace(/(^|[^:])\/\/[^\n]*/g, '$1'); // // line, but not http://
+}
+function tagPattern(tags) {
+    // `[\s/>]` not `[\s>]`: `<Card/>` with no space before the slash was missed
+    // by three of the five copies. The trailing alternation keeps `<Card>` and
+    // `<Card ...>` matching too.
+    return new RegExp(`<(${tags.join('|')})[\\s/>]`, 'g');
+}
+function countCardTags(source, config) {
+    let count = (source.match(tagPattern(config.cardTags)) ?? []).length;
+    for (const re of config.classSurfaces ?? []) {
+        const global = new RegExp(re.source, re.flags.includes('g') ? re.flags : re.flags + 'g');
+        count += (source.match(global) ?? []).length;
+    }
+    return count;
+}
+/**
+ * Does this source render cards from a `.map()`?
+ *
+ * The non-greedy `[\s\S]*?` form is deliberate. Three copies used
+ * `\.map\s*\([^)]*\)\s*=>` which requires a PARENTHESISED parameter, so
+ * `items.map(item => <Card/>)` — a bare param with an expression body — was
+ * missed. That gap is currently dormant across the estate but it is a landmine,
+ * not a theoretical concern.
+ */
+function hasMappedCards(source, config) {
+    const tags = config.cardTags.join('|');
+    if (new RegExp(`\\.map\\s*\\([\\s\\S]*?=>\\s*\\(?\\s*<(${tags})[\\s/>]`).test(source) ||
+        new RegExp(`\\.map\\s*\\([\\s\\S]*?\\{[\\s\\S]*?return\\s*\\(?\\s*<(${tags})[\\s/>]`).test(source))
+        return true;
+    // A mapped CLASS surface is still a mapped card.
+    //
+    // This was missed on the first pass: the tag alternation above is built from
+    // `cardTags` only, so `.map(api => <div className="glass-card">…)` produced N
+    // cards inside one grid slot and read as clean. BSU's `Government.tsx#apis`
+    // is exactly that shape, and only its hand-maintained ledger knew — which is
+    // the failure mode this whole module exists to end. `countCardTags` already
+    // counts class surfaces; the mapped check has to as well or the two disagree.
+    for (const re of config.classSurfaces ?? []) {
+        const src = re.source;
+        if (new RegExp(`\\.map\\s*\\([\\s\\S]*?=>\\s*\\(?\\s*<[^>]*?${src}`).test(source) ||
+            new RegExp(`\\.map\\s*\\([\\s\\S]*?\\{[\\s\\S]*?return\\s*\\(?\\s*<[^>]*?${src}`).test(source))
+            return true;
+    }
+    return false;
+}
+/** Extract the body of every `<CanvasCard …> … </CanvasCard>` block. */
+function extractCanvasCardBlocks(source) {
+    const blocks = [];
+    const re = /<CanvasCard[\s>][\s\S]*?<\/CanvasCard>/g;
+    let m;
+    while ((m = re.exec(source)) !== null)
+        blocks.push(m[0]);
+    return blocks;
+}
+/**
+ * Extract each value of an inline `widgets={{ key: <jsx/> }}` object literal.
+ * Brace-balanced rather than regex-terminated, because a widget body contains
+ * arbitrary nested JSX and braces.
+ */
+function extractWidgetEntries(source) {
+    const out = [];
+    const start = /widgets=\{\{/g;
+    let m;
+    while ((m = start.exec(source)) !== null) {
+        let depth = 2;
+        let i = m.index + m[0].length;
+        const objStart = i;
+        while (i < source.length && depth > 0) {
+            if (source[i] === '{')
+                depth++;
+            else if (source[i] === '}')
+                depth--;
+            i++;
+        }
+        const obj = source.slice(objStart, i - 2);
+        // Split top-level `key:` entries at depth 0.
+        let d = 0;
+        let keyStart = 0;
+        let currentKey = null;
+        let bodyStart = 0;
+        for (let j = 0; j < obj.length; j++) {
+            const c = obj[j];
+            if (c === '{' || c === '(' || c === '[')
+                d++;
+            else if (c === '}' || c === ')' || c === ']')
+                d--;
+            else if (c === ':' && d === 0 && currentKey === null) {
+                currentKey = obj.slice(keyStart, j).trim().replace(/['"]/g, '');
+                bodyStart = j + 1;
+            }
+            else if (c === ',' && d === 0 && currentKey !== null) {
+                out.push({ key: currentKey, body: obj.slice(bodyStart, j) });
+                currentKey = null;
+                keyStart = j + 1;
+            }
+        }
+        if (currentKey !== null)
+            out.push({ key: currentKey, body: obj.slice(bodyStart) });
+    }
+    return out;
+}
+function walk(dir, extensions, acc) {
+    for (const entry of readdirSync(dir)) {
+        if (entry === 'node_modules' || entry === 'dist' || entry === '.git')
+            continue;
+        const full = join(dir, entry);
+        const st = statSync(full);
+        if (st.isDirectory())
+            walk(full, extensions, acc);
+        else if (extensions.some((e) => entry.endsWith(e)) && !/\.(test|spec)\./.test(entry))
+            acc.push(full);
+    }
+}
+export function scanCardSurfaces(config) {
+    const extensions = config.extensions ?? ['.tsx'];
+    const gridPrimitives = config.gridPrimitives ?? DEFAULT_GRID_PRIMITIVES;
+    const findings = [];
+    const files = [];
+    const scanRootsResolved = [];
+    // 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) {
+        const abs = join(config.projectRoot, root);
+        if (!existsSync(abs))
+            throw new Error(`[cardSurfaceScanner] scan root "${root}" does not exist at ${abs}. ` +
+                `A scanner that silently skips a missing root reports a false pass, which is worse than a failure.`);
+        const before = files.length;
+        walk(abs, extensions, files);
+        if (files.length === before)
+            throw new Error(`[cardSurfaceScanner] scan root "${root}" matched ZERO files with extensions ${extensions.join(', ')}. ` +
+                `Refusing to report a verdict from an empty scan.`);
+        scanRootsResolved.push(root);
+    }
+    // Retired single-widget primitives must not exist and must not be imported.
+    for (const retired of config.retiredPrimitivePaths ?? []) {
+        const abs = join(config.projectRoot, retired);
+        if (existsSync(abs))
+            findings.push({
+                file: retired,
+                idiom: 'retired-primitive',
+                detail: `${retired} still exists. It builds ONE grid item for the whole page, so every card on it ` +
+                    `moves as a single block — the exact defect this contract exists to prevent.`,
+            });
+        const base = retired.split(sep).pop()?.replace(/\.tsx?$/, '');
+        if (base) {
+            for (const file of files) {
+                const src = stripComments(readFileSync(file, 'utf8'));
+                if (new RegExp(`\\b${base}\\b`).test(src) && !file.endsWith(retired))
+                    findings.push({
+                        file: relative(config.projectRoot, file),
+                        idiom: 'retired-primitive',
+                        detail: `imports or references the retired primitive ${base}`,
+                    });
+            }
+        }
+    }
+    for (const file of files) {
+        const rel = relative(config.projectRoot, file);
+        const raw = readFileSync(file, 'utf8');
+        const src = stripComments(raw);
+        // --- 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 })),
+        ];
+        for (const slot of slots) {
+            const n = countCardTags(slot.body, config);
+            const mapped = hasMappedCards(slot.body, config);
+            if (n > 1 || mapped) {
+                if (config.gluedExclusions?.[rel])
+                    continue;
+                findings.push({
+                    file: rel,
+                    idiom: 'glued-widget',
+                    cardCount: n,
+                    detail: `${slot.label} packs ${mapped ? 'a .map() of cards' : `${n} card-like components`} into one grid slot. ` +
+                        `Dragging any one of them moves them all.`,
+                });
+            }
+        }
+        // --- ungridded multi-card: the check three of five ports DROPPED -------
+        // Gate on the COMMENT-STRIPPED source so a TODO mentioning CanvasCard does
+        // not mask a page that never actually reaches the grid.
+        const usesGrid = gridPrimitives.some((p) => new RegExp(`\\b${p}\\b`).test(src));
+        if (!usesGrid) {
+            const n = countCardTags(src, config);
+            if (n > 1 && !config.ungriddedExclusions?.[rel]) {
+                findings.push({
+                    file: rel,
+                    idiom: 'ungridded-multi-card',
+                    cardCount: n,
+                    detail: `renders ${n} card-like surfaces and never reaches a grid primitive, so none of them is draggable at all. ` +
+                        `This is the idiom crm7's scanner calls "the actual root cause of the operator's platform-wide complaint".`,
+                });
+            }
+        }
+        // --- autoHeight opt-out + clip invariant -------------------------------
+        const optOut = /autoHeight\s*[:=]\s*\{?\s*false/g;
+        if (optOut.test(src) && !(config.autoHeightEscapeHatch?.test(src) ?? false)) {
+            findings.push({
+                file: rel,
+                idiom: 'autoheight-optout',
+                detail: `opts out of autoHeight. That is reserved for genuinely virtualized/windowed lists that own their own scroll; ` +
+                    `an ordinary table must expand so every row is visible.`,
+            });
+        }
+        // A card that opts out AND seeds h<=2 (64px) cannot show its content.
+        if (/autoHeight\s*[:=]\s*\{?\s*false/.test(src) && /\bh=\{?[12]\}?/.test(src)) {
+            findings.push({
+                file: rel,
+                idiom: 'clipped-card',
+                detail: `autoHeight={false} with h<=2 (<=64px) — the card is guaranteed to clip its content.`,
+            });
+        }
+    }
+    // Stale ledger entries: a claim that is no longer true is a claim that will
+    // be trusted next time. An exclusions ledger is a claim, not a fact.
+    const hit = new Set(findings.map((f) => `${f.idiom}:${f.file}`));
+    const staleExclusions = [
+        ...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 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 };
+}

package/dist/scanner/index.d.ts

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

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

@@ -0,0 +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"}

package/dist/scanner/index.js

@@ -0,0 +1 @@
+export { scanCardSurfaces, stripComments } from './cardSurfaceScanner.js';

package/dist/types.d.ts

@@ -34,6 +34,14 @@ export interface UsePageGridLayoutOptions {
     canEditPage?: boolean;
     editorEventNames?: readonly string[];
     preferenceAdapter?: PageGridPreferenceFactory;
+    /**
+     * Value used for `GridLayoutItem.autoHeight` on any item that does not state
+     * one. Defaults to `true` — cards grow to fit their content rather than
+     * clipping it behind an inner scrollbar (D-76). Pass `false` for a surface
+     * whose items own their own scroll (a virtualized list); an individual item
+     * can always opt out with an explicit `autoHeight: false`.
+     */
+    defaultAutoHeight?: boolean;
 }
 export interface WidgetMeta {
     label: string;
@@ -162,6 +170,14 @@ export interface UsePageGridLayoutResult {
     activeCompactor: Compactor;
     onLayoutChange: (_layout: unknown, layouts: unknown) => void;
     handleColumnChange: (newCols: number) => void;
+    /**
+     * Wire to `<Responsive onBreakpointChange>`. The hook needs to know which
+     * breakpoint react-grid-layout is rendering so a gesture is written back to
+     * the breakpoint that owns it — see `canonicaliseLayoutForPersist`. Without
+     * this the hook assumes `lg`, and every edit made at a narrower container
+     * width lands in a derived breakpoint that is then discarded (D-75).
+     */
+    handleBreakpointChange: (breakpoint: string) => void;
     handleCompact: () => void;
     handleReset: () => void;
     addWidget: (widgetKey: string, initialSize?: Partial<Pick<GridLayoutItem, 'w' | 'h' | 'minW' | 'minH'>>) => void;

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

@@ -10,9 +10,30 @@ export declare const DEFAULT_EDITOR_EVENT_NAMES: readonly ["bsuite-open-page-edi
  * launchers scope by page if they handle multiple grids on one screen.
  */
 export declare const PAGE_GRID_EDITING_EVENT = "bsuite-page-grid-editing";
+/**
+ * Package-wide layout epoch, added to EVERY consumer's `layoutVersion`.
+ *
+ * When a default that governs all grids changes, a saved layout produced under
+ * the old default has to be invalidated — and there is no way to reach ~330
+ * call sites across six apps to hand-bump each one. crm7's `DraggableCardPage`
+ * already solved this locally with its own `LAYOUT_EPOCH`; this is the same
+ * lever one level down, so it also covers the raw `PageGridLayout` consumers
+ * (Dashboard, Billing, GTO, Analytics, the throughput and braden pages) that
+ * no app-level epoch can see.
+ *
+ * 0 -> 1000 (2026-08-13, D-75/D-76): two all-grids defaults changed in the same
+ * release — `autoHeight` now defaults to true for raw consumers, and md/sm no
+ * longer collapse to a full-width stack. Every stored layout predates both and
+ * was additionally polluted with frozen derived breakpoints, so all of them
+ * reset once to the corrected defaults.
+ *
+ * Per-page `layoutVersion` bumps keep working on top; this only moves the
+ * floor.
+ */
+export declare const PACKAGE_LAYOUT_EPOCH = 1000;
 export interface PageGridEditingEventDetail {
     pageKey: string;
     editing: boolean;
 }
-export declare function usePageGridLayout({ pageKey, defaultLayouts, defaultCols, layoutVersion, canEditPage, editorEventNames, preferenceAdapter, }: UsePageGridLayoutOptions): UsePageGridLayoutResult;
+export declare function usePageGridLayout({ pageKey, defaultLayouts, defaultCols, layoutVersion, canEditPage, editorEventNames, preferenceAdapter, defaultAutoHeight, }: UsePageGridLayoutOptions): UsePageGridLayoutResult;
 //# sourceMappingURL=usePageGridLayout.d.ts.map

package/dist/usePageGridLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePageGridLayout.d.ts","sourceRoot":"","sources":["../src/usePageGridLayout.ts"],"names":[],"mappings":"AAaA,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,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,GAC7C,EAAE,wBAAwB,GAAG,uBAAuB,CA+fpD"}
+{"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,CAkmBpD"}