Skip to content

fix(plugin-dashboard): let @object-ui/core own percent scaling in the record-field branch - #5639

Merged
os-sales merged 2 commits into
mainfrom
claude/issue-5607-recordfields-percent-roundtrip
Aug 21, 2026
Merged

fix(plugin-dashboard): let @object-ui/core own percent scaling in the record-field branch#5639
os-sales merged 2 commits into
mainfrom
claude/issue-5607-recordfields-percent-roundtrip

Conversation

@os-sales

Copy link
Copy Markdown
Collaborator

Fixes#5607

renderFieldValue's %-format branch normalised the value itself before calling
formatPercent. formatPercent already applies percentDisplayValue, which
@object-ui/core documents as the SINGLE source of truth for percent display
scaling — so the call site was re-deciding what core owns, with a copy that had
drifted from it.

The branch is deleted rather than repaired, and the measurement below is why.

Verified line numbers (re-derived by code on origin/main)

The card cites packages/plugin-dashboard/src/recordFields.tsx:189-192. Derived
on cdda37ae3 with git show origin/main:… | grep -n:

188: if (typeof fmt === 'string' && /%/.test(fmt) && typeof value === 'number') {
189: const decimals = (fmt.match(/0\.(0+)%/) || [undefined, ''] as any)[1].length;
190: const normalized = value > 1 ? value / 100 : value;
191: return formatPercent(normalized * 100, decimals, displayLocale);

No drift. The two defect lines are 190-191; the branch opens at 188. The file
is byte-identical between f52d36c96 (when the card was filed) and current
origin/maingit diff --stat f52d36c96 origin/main -- <file> is empty.

What core already does (the measurement that chose the shape)

Triage asked for this to be measured before choosing between repairing the local
normalisation and deleting it. Executed against the built dist:

percentDisplayValue(0.75) = 75 percentDisplayValue(1.605) = 1.605
percentDisplayValue(0.005) = 0.5 percentDisplayValue(57) = 57
percentDisplayValue(-0.5) = -50 percentDisplayValue(-5) = -5
percentDisplayValue(1) = 1

percentDisplayValue is value > -1 && value < 1 ? value * 100 : value
both arms, and a symmetric test. Core needs no help from the caller, so the
condition triage named for "the branch should go rather than be fixed" is met by
measurement. The raw stored value now goes to formatPercent: the identical call
the list-view percent cell already makes for an ordinary percent column.

Note this also rules out the shape the issue body floated
(formatPercent(value > 1 ? value : value * 100, …)): it keeps the asymmetric
> 1 test and double-scales small fractions, i.e. it preserves two of the three
divergences below.

Intl option spellings, re-read on the current tip

Triage's second note. The body's measurement was taken through
style: 'unit' / unit: 'percent' / unitDisplay: 'narrow' quoted from
formatPercent. Those spellings have moved. On the current tip
formatPercent renders through formatDisplayNumber(displayValue, { locale, style: 'percentPoints', … }) — the raw Intl triple is now an internal detail
of the 'percentPoints' style token. This PR therefore pins noIntl
options: every assertion goes through renderFieldValue, so nothing here can
become a second drift when that token's internals move again.

The three divergences, all one defect

storedbeforeafter
1.6051.60%1.61%
0.00550.00%0.50%
-5-500.00%-5.00%
1100.00%1.00%
  1. (value / 100) * 100 is not value-preserving in binary floating point. Grid
    v = i/1000, i in 1001..200000, re-measured through the current call
    shape: 19,978 of 199,000 values change bit pattern and 1,108 rendered
    strings move
    — reproducing the card's numbers and its five first movers
    exactly.
  2. A stored fraction below 0.01 was scaled twice — the local * 100 put it
    back under 1, so core's fraction arm scaled it again.
  3. The local test was value > 1, not core's symmetric |value| < 1, so a
    negative already in percentage points took the fraction arm.

Evidence — the repair is what turns the test green

Ablation by mutating the fix away on disk. Each leg proves the mutation on disk
with anchored whole-line counts in both directions before measuring, and a
trap … EXIT INT TERM restores the file. No rebuild is needed for the mutation
to take effect: the test reaches the subject by a relative source import
(../recordFields), not through the package's exportsdist.

Leg A — restore the round-trip form.8 failed | 5 passed (13), and all five
named movers are red with exactly the card's values:

AssertionError: expected '1.60%' to be '1.61%'
AssertionError: expected '1.65%' to be '1.66%'
AssertionError: expected '1.70%' to be '1.71%'
AssertionError: expected '1.78%' to be '1.79%'
AssertionError: expected '1.83%' to be '1.84%'

The 5 that stay green are the 4 controls plus the precision pin — so the red is
targeted, not a branch that stopped rendering percents.

Leg B — the controls' own mutation leg. A control that cannot fail is a
tautology, so this measures rather than argues it: same branch, same call, same
locale, only decimalsdecimals + 1. Result 13 failed (13)all four
controls red
, e.g. expected '1.000%' to be '1.00%'.

An earlier revision of the ablation used grep -E, where ( is a grouping
metacharacter, so the literal parens matched nothing and every anchor read 0. The
pristine assertion aborted with ablation NOT RUN rather than reporting a
no-op as a result; anchors are now grep -cxF. Recorded because the guard
firing is the reason the reading is trustworthy.

Runs

All at 348c1330f, from the repo root (package-cwd vitest is refused by the
repo's own guard, objectui#3378).

runverdict
new test fileTest Files 1 passed (1) · Tests 13 passed (13)
full plugin-dashboard suiteTest Files 74 passed (74) · Tests 670 passed (670)
type-checkVERDICT command-exit 0 (tsc --noEmit && tsc -p tsconfig.test.json echoed)
lint✖ 365 problems (0 errors, 365 warnings) — exit 0
check-control-bytes✅ OK (scanned 4684 tracked text file(s); skipped 85 binary)

The heavier runs were measured at 4e98151ea; the only commit since touches
.changeset/*.md, so the code tree is byte-identical and they apply unchanged.

No existing fixture pinned the old behaviour — notably
ObjectDataTable.percentLocale.test.tsx, which drives this same branch with
1234.5 ('0%') and 33.33 ('0.00%'), is green unchanged.

Lint narrowing — declared, and measured

The repo-wide eslint . is CI's run. This narrowing is a measurement, not a skip:

  1. Population read from ESLint's own config via isPathIgnored: 3,506
    lintable tracked files, of which 104 under packages/plugin-dashboard/.
  2. Files actually linted here, counted from --format json: 104 — the whole
    changed package, 0 errors.
  3. Type-aware linting is not enabled (no projectService / parserOptions /
    project: in eslint.config.js), so no untouched file's verdict can depend
    on this diff. The 3,402 excluded files are provably unmovable by it.

src/recordFields.tsx carries 14 no-explicit-any warnings, all at lines 47-126
— upstream of the percent branch and untouched here.

Changeset

check-changeset-presence.mjs is the authority:

✅ 2 source file(s) of 1 released package(s) changed, and this change declares
1 changeset(s): .changeset/olive-pugs-sing.md.

Dist deltas, measured at the real dist/ path with dist/ (which contains
tsconfig.tsbuildinfo) removed on every leg, compared by hash:

artifactfixedunfixed
dist/index.js77df7ba4d50ceb43 (131,405 B)a2db53c8a5fae48a (131,436 B)
all 26 *.d.ts061342ba4c1f1e5b061342ba4c1f1e5b

The behaviour-card signature exactly: JS moves, .d.ts does not — which is
why a zero .d.ts delta would have been the wrong reason to skip a changeset.
dist/ was rebuilt from the restored source afterwards and re-hashed to
77df7ba4d50ceb43, with the mutation marker absent, so no mutated build was left
behind. (plugin-dashboard emits no index.cjs; ESM only.)


Generated by Claude Code

os-salesand others added 2 commits August 21, 2026 21:12
…ld branch
`renderFieldValue`'s `%`-format branch normalised the value itself before
calling `formatPercent`:
const normalized = value > 1 ? value / 100 : value;
return formatPercent(normalized * 100, decimals, displayLocale);
`formatPercent` already applies `percentDisplayValue`, which `@object-ui/core`
documents as the single source of truth for percent display scaling, so this was
a second, drifted copy of one decision. Measured on the current tip, core
already handles both arms — `percentDisplayValue(0.75) === 75` and
`percentDisplayValue(1.605) === 1.605` — so the branch is deleted rather than
patched, and the raw stored value now goes to `formatPercent`: the identical
call the list-view percent cell already makes for an ordinary percent column.
Three measured divergences, all one defect:
- `(value / 100) * 100` is not value-preserving in binary floating point,
re-introducing one call frame upstream the round trip that was removed from
inside `formatPercent`. On the 0.001-step grid to 200, 19,978 of 199,000
values change bit pattern and 1,108 rendered strings move, every one a
last-digit off-by-one: a stored 1.605 rendered 1.60% where half-up is 1.61%.
- A stored fraction below 0.01 was scaled twice, because the local `* 100` put
it back under 1 and core's fraction arm scaled it again: 0.005 rendered
50.00%.
- The local test was `value > 1` rather than core's symmetric `|value| < 1`, so
a negative already in percentage points took the fraction arm: -5 rendered
-500.00%.
Reverse-verified: the round-trip form restored on disk turns 8 of the 13 cases
red, including `expected '1.60%' to be '1.61%'`. The 4 control cases and the
precision pin stay green on both legs.
…st of the note uses
The note quoted every other value at two decimals but rendered the
boundary case as `1%`, which is the 0-decimal form. At the `0.00%`
precision the rest of the note uses it is `1.00%`, against `100.00%`
from the local `value > 1` test. Same fact, stated at one precision.
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 52 chunks)3785.8 KB3867.2 KB
Main entry chunk (gzip)151.6 KB350 KB
Entry fileindex-kLRIdLzS.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.96KB113.71KB
core (index.js)4.51KB1.80KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)159.80KB44.33KB
fields (index.js)238.85KB60.13KB
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)33.40KB8.71KB
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.65KB18.32KB
plugin-chatbot (index.js)181.41KB43.22KB
plugin-dashboard (index.js)128.33KB32.93KB
plugin-designer (index.js)212.30KB42.80KB
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.50KB20.68KB
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)2.32KB1.24KB
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 21:45
@os-sales
os-sales added this pull request to the merge queueAug 21, 2026
Merged via the queue into main with commit f1c27f0Aug 21, 2026
23 checks passed
@os-sales
os-sales deleted the claude/issue-5607-recordfields-percent-roundtrip branch August 21, 2026 21:46
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[plugin-dashboard] recordFields re-introduces the divide-by-100 round trip #4590 removed: 1.605 renders 1.60% where half-up is 1.61%

2 participants

@os-sales@claude