Skip to content

fix(plugin-dashboard): PivotTable keeps "no rows" stable so the pivot memo holds - #5584

Merged
os-sales merged 1 commit into
mainfrom
claude/issue-5562-pivottable-stable-empty
Aug 21, 2026
Merged

fix(plugin-dashboard): PivotTable keeps "no rows" stable so the pivot memo holds#5584
os-sales merged 1 commit into
mainfrom
claude/issue-5562-pivottable-stable-empty

Conversation

@os-sales

Copy link
Copy Markdown
Collaborator

Fixes#5562

PivotTable spelled the empty array twice, and both spellings feed the same cross-tabulation memo:

146: data: rawData = [], // destructuring default
176: const data = Array.isArray(rawData) ? rawData : []; // non-array fallback
241: }, [data, rowField, columnField, valueField, aggregation]);

So a schema that declares no data key, or one whose data is a provider-config object rather than rows, handed the memo a fresh array identity on every render. The memo is not trivial — two ordered key sets, a bucket[row][col] number-array map, the aggregated matrix and the row/column/grand totals — and all of it was rebuilt on every render, over nothing. The data.length === 0 early return sits after the memo (hooks must stay unconditional), so the wasted matrix is computed and then discarded.

Both spellings now resolve to one module-scope Object.freeze([]). Same fix, same reason as data-table.tsx's EMPTY_COLUMNS/EMPTY_ROWS (#4618) and ObjectPivotTable's (#4629); this closes the direct-use path those two did not cover, where DashboardRenderer / DashboardGridLayout construct pivot schemas without ObjectPivotTable in the chain.

Severity is unchanged from the card: wasted work only. The churn feeds a memo rather than a setState, and PivotTable holds no prop-to-state sync, so nothing rendered wrong and no render loop was possible.

The test asserts on the memo, not on the render

Nothing renders wrong today, so a "the pivot renders correctly" assertion is green against the broken code and proves nothing. PivotTable.stableEmptyRows.test.tsx wraps useMemo and counts how many times the cross-tabulation memo's factory actually runs, identifying that memo by its exact five-entry dependency list. It also asserts the identity of the memo's data dependency across renders, mirroring ObjectPivotTable.stableEmptyRows.test.tsx.

The two literals get one case each, because they are independent churn sources on independent lines and a single test cannot tell you which half is live.

Reverse-verification

Three mutations, each restored by a trap ... EXIT INT TERM, each proved on disk with anchored grep -c in both directions (real text 1 to 0, mutant 0 to 1) plus git diff --stat; git status --porcelain empty after every leg. No build step is involved: the root vitest config aliases every @object-ui/* specifier to that package's src/, and the test imports ../PivotTable relatively, so the mutated source is what executes.

mutationno-data-key caseprovider-config caseshared-empty case
both literals revertedREDREDRED
only :146 revertedREDgreenRED
only :176 revertedgreenREDRED

The two one-sided legs are the load-bearing half: they confirm the card's warning that fixing one literal leaves the other live, and that this test says which. The headline failure is expected 4 to be 1 — four renders, four distinct empty-array identities, four full recomputes.

ESLint tracks the same thing independently. Reverting :176 alone reproduces the warning the issue quotes verbatim, and it is absent on the fixed file:

mutant: 204:9 warning The 'data' conditional could make the dependencies of useMemo Hook
(at line 269) change on every render... react-hooks/exhaustive-deps
2 problems (0 errors, 2 warnings)
fixed: 1 problem (0 errors, 1 warning)

The one remaining warning is the pre-existing react-refresh/only-export-components on export const PIVOT_AGGREGATIONS, shifted from line 109 to 133 by the new doc comment. Not introduced here.

Gates

All run locally, exit codes captured before any pipe, each gate's own verdict line quoted.

gateverdict
pnpm --filter @object-ui/plugin-dashboard type-checkexit 0 (tsc --noEmit && tsc -p tsconfig.test.json, both echoed)
pnpm --filter @object-ui/plugin-dashboard lintexit 0 — 365 problems (0 errors, 365 warnings) — every one pre-existing
pnpm exec vitest run packages/plugin-dashboard/exit 0 — Test Files 73 passed (73) / Tests 657 passed (657)
pnpm exec eslint . (repo-wide, 3486 files)exit 0 — 0 errors, 10459 warnings
node scripts/check-control-bytes.mjscheck-control-bytes: OK (scanned 4635 tracked text file(s); skipped 85 binary).
node scripts/check-changeset-presence.mjs2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s)
node scripts/check-changeset-no-major.mjsNo changeset declares a major bump.
node scripts/check-changeset-fixed.mjsAll workspace packages are in the changeset fixed group.
node scripts/check-lint-coverage.mjslint coverage: 46/46 packages linted, 0 with outstanding errors (0 total).
node scripts/check-type-check-coverage.mjs45/46 via type-check / 41/41 packages compile their tests
node scripts/check-phantom-dependencies.mjsEvery in-scope import is declared by the package that publishes it.
node scripts/check-package-self-import.mjsNo package names itself inside its own src/.

Repo-wide lint was not narrowed — the full eslint . farm ran green. The dependency closure had to be built first (pnpm --workspace-concurrency=2 --filter '@object-ui/plugin-dashboard^...' build); without it tsc resolves workspace packages through dist/ and reports Cannot find module '@object-ui/components' on files this PR never touches.

One gate is declared not run: node scripts/check-eager-closure-budget.mjs refuses without apps/console/dist/eager-closure.json, which only a console vite build emits — its own verdict line calls that "a broken gauge, not a passing budget", so it reports nothing about this change either way. It cannot be implicated regardless: that gate measures which modules land in the eager closure, and git diff shows this PR adds and removes zero import statements in src/.

The 6 @typescript-eslint/no-explicit-any warnings on the new test are as any casts on SDUI schema fixtures — the established pattern in this package's tests (the sibling ObjectPivotTable.stableEmptyRows.test.tsx carries 8 of the same, PivotTable.drill.test.tsx 1).

Gate union was run against the final commit, 34db0672.

Scope

packages/plugin-dashboard/src/PivotTable.tsx, its new test, and one changeset. ObjectPivotTable.tsx and ObjectDataTable.tsx were not touched — both already fixed by #4629. No drive-by tidying, and no out-of-scope findings.


Generated by Claude Code

… memo holds
`PivotTable` spelled the empty array twice — as the destructuring default for
`schema.data` and as the `Array.isArray` fallback that keeps a provider-config
object out of iteration. Both feed the same cross-tabulation memo, so a schema
with no `data` key, or one whose `data` is a provider config, handed the memo a
fresh array identity every render and rebuilt the ordered key sets, the bucket
map, the aggregated matrix and the row/column/grand totals over nothing.
Both spellings now resolve to one module-scope `Object.freeze([])`, matching
`data-table.tsx` (objectui#4618) and `ObjectPivotTable` (objectui#4629). This
closes the direct-use path those two did not cover.
The test asserts on the memo's recompute count and the identity of its `data`
dependency, not on the rendered output — nothing renders wrong today, so a
rendering assertion is green against the broken code. Each of the two literals
gets its own case.
Fixes#5562
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012u2pRjcqAYtoEjgr3wwhnK
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 52 chunks)3784.8 KB3867.2 KB
Main entry chunk (gzip)151.2 KB350 KB
Entry fileindex-DEeUAQ1d.js
StatusPASS

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)10.04KB3.72KB
app-shell (runtime-config.js)8.91KB2.99KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)10.06KB3.86KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)29.34KB7.05KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.21KB3.45KB
auth (LoginForm.js)18.15KB5.39KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.65KB2.22KB
auth (SocialSignInButtons.js)9.61KB3.89KB
auth (UserMenu.js)3.41KB1.23KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)40.21KB10.80KB
auth (createAuthenticatedFetch.js)6.35KB2.43KB
auth (index.js)2.77KB1.22KB
auth (invitation-status.js)1.22KB0.70KB
auth (org-roles.js)6.66KB2.78KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)5.02KB0.89KB
auth (useIsWorkspaceAdmin.js)3.04KB1.45KB
collaboration (CommentThread.js)26.08KB7.56KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)6.49KB2.64KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.68KB0.73KB
collaboration (useCollaborationTranslation.js)6.05KB2.52KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)506.88KB113.68KB
core (index.js)4.51KB1.80KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)159.80KB44.33KB
fields (index.js)237.61KB59.63KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.28KB1.75KB
i18n (index.js)3.44KB1.39KB
i18n (pickLocalized.js)7.22KB3.08KB
i18n (provider.js)23.13KB7.63KB
i18n (useDisplayLocale.js)2.85KB1.45KB
i18n (useObjectLabel.js)30.51KB7.57KB
i18n (useSafeTranslation.js)7.77KB3.13KB
layout (index.js)38.95KB10.97KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.75KB
mobile (index.js)1.55KB0.62KB
mobile (offlineQueue.js)3.91KB1.35KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (serviceWorkerSource.js)3.41KB1.48KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)6.96KB1.98KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.72KB0.42KB
mobile (useResponsiveConfig.js)1.37KB0.63KB
mobile (useSpecGesture.js)4.32KB1.64KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)9.35KB3.31KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)4.42KB1.42KB
permissions (evaluator.js)5.12KB1.74KB
permissions (index.js)0.93KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.53KB
permissions (usePermissions.js)1.81KB0.83KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.62KB12.83KB
plugin-charts (index.js)64.72KB18.35KB
plugin-chatbot (index.js)181.21KB43.14KB
plugin-dashboard (index.js)128.53KB32.97KB
plugin-designer (index.js)212.39KB42.83KB
plugin-detail (index.js)242.15KB60.89KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)125.07KB30.43KB
plugin-gantt (index.js)164.10KB39.87KB
plugin-grid (index.js)200.79KB54.26KB
plugin-kanban (index.js)52.93KB14.60KB
plugin-list (index.js)111.70KB27.17KB
plugin-map (index.js)20.06KB6.62KB
plugin-markdown (index.js)13.72KB4.69KB
plugin-report (index.js)43.49KB11.93KB
plugin-timeline (index.js)26.68KB7.66KB
plugin-tree (index.js)8.50KB2.88KB
plugin-view (index.js)84.48KB20.67KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.90KB0.85KB
providers (UploadProvider.js)11.66KB3.50KB
providers (index.js)0.45KB0.23KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)5.62KB2.34KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)43.66KB14.77KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)1.33KB0.69KB
react (schema-input.js)1.45KB0.83KB
react (spec-input.js)0.20KB0.18KB
sdui-parser (codegen.js)5.41KB2.34KB
sdui-parser (index.js)4.77KB2.16KB
sdui-parser (input-type.js)2.84KB1.40KB
sdui-parser (parse.js)10.76KB3.17KB
sdui-parser (provenance.js)3.66KB1.82KB
sdui-parser (types.js)0.29KB0.24KB
sdui-parser (validate.js)6.92KB2.40KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (dashboard-filter-alias.js)6.23KB2.74KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)1.87KB0.85KB
types (disclosure.js)0.20KB0.18KB
types (error-code.js)1.54KB0.88KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (http-retry.js)4.32KB2.02KB
types (index.js)3.08KB1.53KB
types (layout.js)0.20KB0.18KB
types (managed-by.js)0.19KB0.18KB
types (mobile.js)2.59KB1.31KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (record-semantics.js)1.28KB0.67KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (spec-report.js)5.05KB1.93KB
types (system-fields.js)3.33KB1.54KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)3.40KB1.71KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@os-sales
os-sales marked this pull request as ready for review August 21, 2026 15:34
@os-sales
os-sales added this pull request to the merge queueAug 21, 2026
Merged via the queue into main with commit 0ccbdc1Aug 21, 2026
23 checks passed
@os-sales
os-sales deleted the claude/issue-5562-pivottable-stable-empty branch August 21, 2026 15:34
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-sales@claude