Skip to content

fix(fields): required file grid cells announce their state — FileCell gains the published error slot - #5561

Merged
os-sales merged 1 commit into
mainfrom
claude/issue-5431-filecell-aria-invalid
Aug 21, 2026
Merged

fix(fields): required file grid cells announce their state — FileCell gains the published error slot#5561
os-sales merged 1 commit into
mainfrom
claude/issue-5431-filecell-aria-invalid

Conversation

@os-sales

Copy link
Copy Markdown
Collaborator

Fixes#5431

What

A required-but-empty file cell in GridField flagged only the visual ring and title on the td — no element in the cell subtree carried aria-invalid, so assistive tech was told nothing. #3318 / PR #5429 wired every other cell type (text/number/currency/date/datetime/time, select, lookup); file was left out because FileCell's prop set was closed.

Per the dispatch ruling (option 1, triage-concurred): FileCell gains the published error slot mirroring LookupField, and the grid passes it.

Public-surface widening (stated explicitly, per the contract-review dispatch)

FileCell is exported from @object-ui/fields's barrel (export * from './widgets/FileField.js'), so the new optional error?: string prop is an API addition to a published package. It is the same validation slot @objectstack/spec/ui's FieldWidgetPropsSchema declares (verified: error: z.ZodOptional<z.ZodString> in the installed spec typings) and FieldWidgetComponentProps names (objectui#3222) — no second spelling is minted. The changeset declares minor and describes the addition.

How

Tests

  • GridField.test.tsx: required-empty file cell → the aria-invalid="true" carrier inside the flagged cell is a BUTTON and the td is not the carrier; optional-empty and required-filled cells announce nothing; ghost row stays unmarked.
  • complex-widgets.test.tsx: FileCell unit pins — error set → picker button aria-invalid="true"; slot empty → "false".
  • Reverse verification (fix committed first, sources reverted to origin/main, mutation confirmed on disk by anchored grep counts 2→1 for both aria-invalid={!!error} and error={invalid): exactly the 3 positive pins went red (Tests 3 failed | 85 passed), the 2 negative guards stayed green as predicted; restore leg confirmed markers back (counts 2/2) and 88/88 green. No dist rebuild involved — both suites import the widgets by relative src path.
  • The registry sweep (widget-aria-invalid-registry-e2e.test.tsx) legitimately does not see this per-column-type gap (text/number grid config) and stays green before and after — not cited as evidence.

Verification (all at head 818107d)

  • pnpm exec vitest run packages/fields/ packages/plugin-detail/src/__tests__/RelatedList.filecolumns.test.tsx packages/plugin-form/src/deriveMasterDetail.test.ts packages/plugin-form/src/deriveMasterDetail.declaredSpelling.test.tsx --maxWorkers=2Test Files 113 passed (113), Tests 1882 passed (1882) (includes the two FileCell-consumer suites outside the package)
  • pnpm --filter @object-ui/fields type-check → exit 0 (script echoed; deps built first via pnpm --workspace-concurrency=2 --filter '@object-ui/fields^...' build)
  • pnpm exec turbo run lint --filter=@object-ui/fields --concurrency=20 errors (857 pre-existing warnings, package no-explicit-any baseline). Narrowed lint declared: root lint is per-package turbo run lint; no per-package eslint config exists, root flat config has no type-aware (projectService/project) settings and no markdown plugin, so the fields package is the entire lint population this diff can move; changesets sit in no eslint population.
  • node scripts/check-control-bytes.mjs, check-changeset-presence.mjs, check-changeset-no-major.mjs, check-changeset-fixed.mjs → all ✅

Note: the dispatch's gate list named objectstack-side gates (check:slot-lookup, check:test-source-alias, check:type-source-resolution, plugin-teardown/docs-audit/ADR-0087 scripts) that do not exist in this repo; re-derived against objectui's actual gate set as above.

Scope

File surface as dispatched: the two widget sources, their tests, and a changeset. packages/fields/README.md mentions FileCell only for upload mechanics (no prop list documented), so no doc file is touched; the changeset carries the API-addition record.


Generated by Claude Code

… gains the published error slot
A required-but-empty `file` cell in GridField flagged only the visual ring and
`title` on the `td`; nothing in the cell subtree carried `aria-invalid`, so
assistive tech was told nothing (objectui#5431). #3318 / PR #5429 wired every
other cell type; `file` was left out because `FileCell`'s prop set was closed.
`FileCell` now takes the published `error?: string` slot — the same spelling
`FieldWidgetPropsSchema` declares and `LookupField` / `FileField` already
consume (#3222) — and puts `aria-invalid` on its own focusable picker button
(#5223: never the wrapper). GridField's file branch passes the slot exactly as
its lookup branch does.
Public-surface widening: `FileCell` is exported from `@object-ui/fields`'s
barrel, so the new optional prop is an API addition (declared minor in the
changeset).
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-DaR6K7mp.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.94KB113.63KB
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.51KB32.94KB
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.52KB20.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 12:46
@os-sales
os-sales added this pull request to the merge queueAug 21, 2026
Merged via the queue into main with commit 9a1fb41Aug 21, 2026
23 checks passed
@os-sales
os-sales deleted the claude/issue-5431-filecell-aria-invalid branch August 21, 2026 12:47
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