Skip to content

fix(plugin-charts): keep the xAxis object on any declared presentation key (objectui#10516) - #10571

Merged
objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-10516-xaxis-presentation-gate
Sep 25, 2026
Merged

objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-10516-xaxis-presentation-gate

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #10516
Clause-②: no

Executes triage 5829695041: normalizeChartSchema keeps the x-axis object whenever it carries any declared presentation key, pinned per key with title as the control. Implemented by the os-dev dispatched from seat domain:ui#2 (claim 5829769784), session https://claude.ai/code/session_014mXUNuFomfj24w7s1pZzhN.

The change

The x gate in the axes block was xAxisSpec.format || xAxisSpec.title || xAxisSpec.showGridLines !== undefined. It now asks whether Object.keys(xAxisSpec) holds any key other than field, the data key hoisted to xAxisKey. The object is kept whenever normalizeAxis kept one.

There is no second key list. The presentation set is whatever normalizeAxis read, and normalizeChartSchema.specAxisKeys-7690.test.ts already ties that read set to the installed spec's ChartAxisSchema keys in both directions. The new per-key pins read their key list off ChartAxisSchema.shape minus field, so a key the spec adds joins them on the next install. No new dependency: @objectstack/spec stays a devDependency, and the runtime test runs over the normalized object.

Mechanism hypotheses, measured on the base 9cbe4dbca

  • H1: confirmed. The gate was exactly that expression. { field, min, max, stepSize, logarithmic, position } normalized to no xAxis (see the red rows below).
  • H2: derived, as described above. There is no hand list and no mirrored declaration.
  • H3: different shape, left unchanged. The y-axis branch has no presentation gate at all. Every entry normalizeAxis returns is kept, {} included, and that is what preserves the secondary-axis count.
  • H4: measured through ChartRenderer, with normalizer and renderer as one path and recharts in a fixed 510x350 box, on the head:
    • min / max / stepSize on a scatter x axis set the bottom ticks to 0 50 100 150 200. On the base they were 0 25 50 75 100. This is pinned.
    • logarithmic: true on a scatter x axis with x = 1, 10, 100, 1000 gives mark cx gaps of 143 143 143. On the base, and on the head with false, the gaps are 4 39 385. This was a one-off probe and is not kept.
    • position: 'top' on xAxis leaves the tick labels at orientation="bottom" for both scatter and bar, on the base and on the head. The key survives normalization now, but no renderer reads it. That is reported as its own finding below and is not implemented here.
  • H5: pinned as asked. See the table below.

Red on base, green on head

normalizeChartSchema.xAxisPresentationGate-10516.test.ts (unit project) and ChartRenderer.scatterXAxisScale-10516.test.tsx (dom project) were first run against the unchanged base source, then against the fix.

pin base head
the sample covers exactly the spec presentation keys pass pass
title alone beside field (the control) pass pass
format alone pass pass
showGridLines alone pass pass
min alone FAIL: xAxis undefined pass
max alone FAIL pass
stepSize alone FAIL pass
logarithmic alone FAIL pass
position alone FAIL pass
the card's reproduction: all five, no title FAIL pass
falsy values: min: 0, logarithmic: false, showGridLines: false FAIL pass
control: field alone yields no xAxis pass pass
control: refused values (stepSize: -5, min: 'zero', position: 'middle') yield no xAxis pass pass
seam: scatter ticks from min / max / stepSize with no title FAIL: 0 25 50 75 100 pass
seam control: the same axis plus title pass pass

Totals over the two files: base 8 failed / 7 passed, head 15 passed.

Files beyond the claim's surface, and why

The claim named normalizeChartSchema.ts, the tests beside it and one changeset. Two more files changed. Each holds a published sentence that this change makes false, and the dispatch contract says such a sentence is repaired in the same change:

  • content/docs/plugins/plugin-charts.mdx: removed the caveat saying that on xAxis, min, max, stepSize and logarithmic take effect only when the object also carries title, format or showGridLines. That caveat described this defect. The page's 14 fenced blocks are byte-identical between base and head (sha256 prefix 84a4534a0330fcf9 on both sides).
  • packages/core/src/utils/chart-presentation.ts: the axisPresentation docblock is exported, so it ships in core's .d.ts. It said the normalizer keeps only format / title / showGridLines on the x-axis. It now points at the normalizer and the new pin rather than restating an answer (AGENTS.md 完善设计器的每一个细节 #9). This is a comment-only edit.

No pending changeset sentence becomes false. 9675-scatter-spec-axes and 7113-chart-data-model describe x-axis keys reaching the normalized axis, and this change makes that true for more axes, not fewer.

Gates

The union was re-run at 01f7648b6, the head of this PR. Each entry quotes the gate's own verdict line.

  • pnpm --filter @object-ui/plugin-charts --filter @object-ui/core run type-check: both packages echo tsc --noEmit && tsc -p tsconfig.test.json and end with Done. --listFiles shows both new test files inside plugin-charts' test program. The dependency closure (@object-ui/plugin-charts^..., 9 packages) was built first.
  • pnpm exec vitest run packages/plugin-charts/ packages/core/src/utils/: Test Files 163 passed (163), Tests 2564 passed (2564). Full packages/core/ at 4cc8be66f (core's bytes have not changed since): 171 passed, 3486 passed. The four plugin-dashboard files that import normalizeChartSchema or read the axes lowering, at 4cc8be66f: 78 passed.
  • check-changeset-presence: 4 source file(s) of 2 released package(s) changed, and this change declares 1 changeset(s). check-changeset-no-major and check-changeset-overwrite are green. check:changeset-claims: No pending changeset names a file this change touches. check:pending-changeset-literals is green.
  • check:new-line-citations: 0 new citation(s). check:control-bytes: OK. check-doc-links: Links are valid across 17 scan roots. check:doc-types, check:doc-example-ids, check:doc-fences and check:doc-example-readers are green.
  • check:vi-mock-specifiers, check:vi-mock-inherit, check:vi-mock-override-shape, check:test-path-roots and check:spec-symbols are green.
  • eslint on the 4 touched TS files: --format json reports 4 files and 0 errors. The new files add no warnings, and the existing no-explicit-any warnings in normalizeChartSchema.ts predate this change. The root config is not type-aware (no parserOptions.project or projectService), and no local rule reads the filesystem, so this diff cannot move any untouched file's verdict. The repo-wide lint run belongs to CI.
  • NOT MEASURED: check:doc-snippets and check:doc-examples. Reason: PREREQUISITE NOT MET, because they need a 34-package scoped build. Declared narrowing: the doc diff removes one prose line outside any fence, the fenced blocks are byte-identical, and those gates read fenced blocks only. CI runs them in full.

Acceptance notes

  • The AdvancedChartImplProps.xAxis docblock lists format / title / showGridLines as the category-axis presentation. Since objectui#9675 the scatter branch has also read min / max / stepSize / logarithmic from it. The docblock was incomplete before this change and is not made false by it, and AdvancedChartImpl.tsx is outside the claim. Noted here, not filed.
  • ChartRenderer.tsx changed on main after the base (objectui#8086, PR 10554). The seam pin renders through it, but the changed arm is series, which the pin does not write. The pin was not re-run on a merge; the merge queue rebuilds on main.

Finding, not fixed here

xAxis.position is declared (spec ChartAxisSchema.position, "Axis position", with values left / right / top / bottom, referenced on objectui's ChartSchema.xAxis). After this change it reaches the normalized axis, but no renderer reads it: position: 'top' still draws the x axis at the bottom on scatter and bar (H4 above). The docs table row "The side of the chart the axis belongs to" is its doc half.

Seam: spec:ChartAxisSchema.position → runtime:normalizeChartSchema x-axis → renderer:AdvancedChartImpl XAxis (no orientation read)


Generated by Claude Code

…n key, not three hand-named ones

normalizeChartSchema kept the x-axis object only when it carried format,
title or showGridLines, so an axis with only min / max / stepSize /
logarithmic / position beside its field was dropped whole and a scatter's
authored x scale never reached its axis. The gate now keeps the object
whenever normalizeAxis kept any key other than field, which is the spec's
ChartAxisSchema key set by construction (tied by the 7690 key-set pin).

Pins: one per presentation key read off the installed spec (title,
format, showGridLines were already green; min, max, stepSize,
logarithmic, position were red on the base), the card's reproduction,
falsy values, and two controls (field alone; refused values). A
ChartRenderer seam pin reads the scatter's bottom ticks with a
title-carrying twin as the lit control.

The docs caveat that described the defect is removed, and the
axisPresentation docblock in core that spelled out the old x-axis answer
no longer restates it.

Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014mXUNuFomfj24w7s1pZzhN
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 329 chunks) 3046.6 KB 3104.5 KB
Main entry chunk (gzip) 147.8 KB 350 KB
Entry file index-Dsmwy0S8.js —
Status PASS —

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

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 16.68KB 6.20KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 27.95KB 10.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.18KB 10.59KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.52KB 3.45KB
auth (index.js) 3.63KB 1.64KB
auth (invitation-status.js) 1.22KB 0.70KB
auth (org-roles.js) 6.66KB 2.78KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 11.08KB 4.58KB
collaboration (CommentThread.js) 27.13KB 7.95KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 545.30KB 130.42KB
core (index.js) 9.22KB 3.71KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 223.91KB 62.28KB
fields (index.js) 257.58KB 65.21KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 2.59KB 1.22KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 8.87KB 3.64KB
i18n (index.js) 5.24KB 2.27KB
i18n (pickLocalized.js) 9.86KB 3.95KB
i18n (provider.js) 39.40KB 12.91KB
i18n (useDisplayLocale.js) 3.52KB 1.76KB
i18n (useObjectLabel.js) 34.34KB 9.17KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 39.28KB 11.09KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.75KB
mobile (index.js) 1.99KB 0.87KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 6.62KB 2.45KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 5.52KB 2.10KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 13.52KB 4.88KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.33KB 3.07KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 16.01KB 3.93KB
plugin-calendar (index.js) 51.38KB 14.60KB
plugin-charts (index.js) 74.94KB 20.89KB
plugin-chatbot (index.js) 198.36KB 47.20KB
plugin-dashboard (index.js) 133.50KB 35.37KB
plugin-designer (index.js) 216.25KB 44.39KB
plugin-detail (index.js) 232.59KB 61.50KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 147.58KB 37.78KB
plugin-gantt (index.js) 169.64KB 41.92KB
plugin-grid (index.js) 215.37KB 58.92KB
plugin-kanban (index.js) 48.26KB 15.04KB
plugin-list (index.js) 114.43KB 28.26KB
plugin-map (index.js) 22.42KB 7.38KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 43.55KB 11.99KB
plugin-timeline (index.js) 30.64KB 8.94KB
plugin-tree (index.js) 10.52KB 3.69KB
plugin-view (index.js) 87.31KB 21.78KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.66KB 3.50KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 114.58KB 37.60KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.03KB 1.86KB
react (schema-input.js) 4.25KB 2.04KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (body-dialect.js) 4.78KB 2.09KB
sdui-parser (codegen.js) 6.58KB 2.74KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 5.78KB 2.56KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (kanban-quick-add.js) 3.89KB 1.87KB
sdui-parser (parse.js) 25.28KB 7.80KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 18.27KB 6.20KB
types (ai.js) 4.11KB 2.06KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 1.00KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.93KB 1.49KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.74KB 2.25KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 5.00KB 2.39KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 0.20KB 0.18KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 17.15KB 6.32KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

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

@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

Contract review

Served-tier: CONTRACT_REVIEW_TIER
Head-sha: 01f7648b6cea0bed29b054b33a0fd27d400cf422

① Derived judgments

Inputs read. Card body + 3 comments (triage 5829695041, claim 5829769784, os-dev-report 5830214863, the latter two treated as the seat's/dev's words only). PR body, 6-file list (+251/-8). git rev-parse refs/review/pr-10571 = 01f7648b6… (matches). Merge-base 9cbe4dbca; main at read 8740e86ce (7 commits ahead of base). No checkout/edit/stash; git status --short on the review checkout stayed empty.

The new gate is derived, not hand-listed. Head: if (xAxisSpec && Object.keys(xAxisSpec).some((key) => key !== 'field')), applied to the NORMALIZED axis. normalizeAxis (head lines 308–330) is a whitelist: it writes exactly the nine spec keys (field, format, min, max, stepSize, showGridLines, logarithmic, position, title) and only when the value is admitted (str/num/boolean/enum/label); it never writes an undefined-valued key and passes nothing through. So "any key besides field" ≡ "any admitted spec presentation key". The tie to ChartAxisSchema is the existing normalizeChartSchema.specAxisKeys-7690.test.ts: DECLARED ⊆ READ (it.each(SPEC_AXIS_KEYS) through the y arm) and READ ⊆ DECLARED (Object.keys(out.yAxes[0]).sort() equals Object.keys(SpecChartAxisSchema.shape).sort()). The normaliser diff is one predicate line + comment; normalizeAxis is unchanged base→head, so the old predicate applied to head's normalized objects is an exact derivation of base.

Probe (scratch git archive of head packages/plugin-charts/src + packages/core/src, the single @object-ui/i18n import re-pointed at a copy of pickLocalized.ts, run with node 22 type-stripping; 26 inputs, no tests re-run):

  • { field } → no xAxis, xAxisKey: 'progress'. { field, zzz: 1 } and { field, grid: true } → no xAxis (an unknown or alias key cannot keep the object alive).
  • Each declared key alone keeps it: title, format, showGridLines:true/false, min:0, max, stepSize:50, logarithmic:true/false, position:'top'. Falsy values count (min: 0, logarithmic: false).
  • Refused values do not: stepSize: 0, stepSize: -5, min: 'zero', min: NaN, position: 'middle', title: '', title: {}, title: undefined → no xAxis. Locale-map title resolves and keeps it. {} → nothing; bare string → xAxisKey only. DatasetWidget's field-less shape { min, max } is kept.
  • Base-vs-head derivation: the flip set is exactly min, max, stepSize, logarithmic, position (alone and combined) and the field-less {min,max}; no other input flips. Nit: showGridLines: false was already kept on base (!== undefined), so in the PR's "falsy values" row the base FAIL comes from min: 0 / logarithmic: false; the third entry is a control inside a red row. Row still correctly red-on-base.

y-axis branch is ungated. .map(normalizeAxis ?? { field }).filter(Boolean); probe yAxis: [{field:'a'}, {}, {field:'b', zzz:1}, 'c'] → [{field:a},{},{field:b},{field:c}] — every normalized entry kept incl. {}, unknown keys stripped. Leaving it unchanged is right (secondary-axis count depends on it).

Pins. normalizeChartSchema.xAxisPresentationGate-10516.test.ts (unit project by .test.ts suffix): PRESENTATION_KEYS = Object.keys(SpecChartAxisSchema.shape).filter(k !== 'field').sort(); sample-covers-spec-keys pin present; it.each(PRESENTATION_KEYS) per key; card repro; falsy loop; {field} control; refused-values control. title control passes both predicates (old gate is title-truthy). Seam pin ChartRenderer.scatterXAxisScale-10516.test.tsx (dom project): rows x 0..100, authored min:0,max:200,stepSize:50, reads text.recharts-cartesian-axis-tick-value[orientation="bottom"] — the identical selector and 510×350 ResponsiveContainer double used by AdvancedChartImpl.scatterSpecAxes-9675.test.tsx (green on main). On base the object is dropped → numericAxisSpecProps(undefined) returns {} → auto ticks; red for the tick reason, not the NumericValueRefusal path (rows carry numeric x). Dev's red/green table (8 failed / 7 passed base, 15 passed head) is not re-run here; CI test shards 1–8 all success on the head.

Prose hunks. Both texts were made false: mdx caveat "take effect only when the same object also carries title, format or showGridLines" (removed, +blank; the only mdx change; outside any fence; Axis-options table still says min/max pin "the x axis of a scatter chart" — accurate). axisPresentation docblock "keeps format/title/showGridLines on the x-axis" rewritten to point at the normaliser and the pin with no restated answer (AGENTS.md #9); comment-only (+6/-5 all inside the /** */). It ships: packages/core/src/index.ts has export * from './utils/chart-presentation.js', types: ./dist/index.d.ts, files: [dist,…]. check-changeset-presence.mjs header: guards pkg/src/** of every fixed-group package, requires A changeset (empty frontmatter counts), does not require the touched package be named; core and plugin-charts are both in the 40-package fixed group, so the plugin-charts: patch entry satisfies the rule (CI Changeset Declaration success). No core entry required; PR body records the edit.

main moved. git merge-tree --write-tree refs/review/main refs/review/pr-10571 → clean (tree 20475a39e). None of the PR's 6 paths changed on main since base. ChartRenderer.tsx on main (aa6be30, #8086) changed only the series union arm and a comment; xAxis={props.spec.xAxis} pass-through unchanged; the seam pin writes xAxis/yAxis/data, no series. Seam pin still valid. PR mergeable_state: behind — queue rebuilds on main.

Pending changesets. Grep over .changeset/*.md on head and main for showGridLines|axisPresentation|only when the same object|x-axis gate|format/title/showGridLines: 7113 (line 91 "config object … NOT folded … presentation keys survive separately into out.xAxis" — still true, more so; carries pre-existing cross-file line addresses normalizeChartSchema.ts:289-291/:292, already stale before this PR, not its finding, no sweep per #11), 7690 (declares nine keys — true), 9675 ("resolved by normalizeChartSchema" was overstated for a title-less x on its own base; this PR makes it true and the new changeset says "completes objectui#9675's x-axis repair"), 9792 and 10132 (unaffected). No pending sentence falsified. Tree-wide grep for any other restatement of the three-key gate outside the six files: 0 hits. AdvancedChartImplProps.xAxis docblock (format/title/showGridLines "for the category axis") matches what the category branch reads (lines 1515/1578/1691); incomplete for scatter since 9675, not falsified.

② Semver level

patch on @object-ui/plugin-charts is right: no export, type (NormalizedAxis unchanged), schema or accept-set change; declared keys stop being dropped; the only render change is on axes that previously mis-drew what they declared. Clause-②: no is right. Changeset prose verified sentence by sentence: old predicate quoted correctly; "lost everything but its field" (xAxisKey survives — probe); "kept whenever it carries any key of the spec's ChartAxisSchema other than field" (normalizeAxis whitelist — probe); "position … no renderer reads it" (grep: .position read only on y — primaryY?.position === 'right', primary?.position === 'right'; no orientation on any XAxis). True.

③ Boundary flags

  • CI (second read): 43 check runs — 39 success, 3 skipped (coverage matrix ×2, dependabot), 1 in_progress: Spec Main Shape Gate. Type Check, Lint, Build Docs, Doc Snippet Type Check, all 8 Test shards, all Changeset gates, Line Citation Gate, Control Byte Scan: success. PR is a draft and behind main.
  • Class-b xAxis.position: real at source (reads above). Not made worse in outcome — before, a title-carrying x with position already survived normalisation and was ignored by the renderer; now every x with position reaches the renderer and is ignored there. The inert site moves from normaliser to renderer and becomes consistent, which is the more visible (and more honest) ADR-0049 shape; the new changeset states it. Same holds for min/max/stepSize/logarithmic reaching category (bar/line) x axes, which read only format/title/showGridLines — matches the docs row. The finding is reported in the PR/report but not filed as a card; that is the seat's follow-up, not a landing blocker.
  • Scatter deadAxes: a title-less x with min+max or stepSize now satisfies declaresScale, so a scatter with no numeric x rows no longer hits NumericValueRefusal for x — identical to the pre-existing title-carrying behaviour and what that code's own comment intends ("never dead"). Not a stopper.
  • Nothing should stop landing. Minor notes only: the falsy-row nit above; the core src/ docblock edit relies on the presence rule rather than a named entry.

Implemented-by: claude/issue-10516-xaxis-presentation-gate
Reviewed-by: session_014mXUNuFomfj24w7s1pZzhN

VERDICT: PASS


Generated by Claude Code

@objectstack-fleet
objectstack-fleet Bot marked this pull request as ready for review September 25, 2026 09:51
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Sep 25, 2026
Merged via the queue into main with commit a506001 Sep 25, 2026
45 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-10516-xaxis-presentation-gate branch September 25, 2026 10:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants