Skip to content

fix(console): a settings value that misses its declared format blocks Save (objectui#13287) - #13298

Merged
objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-13287-settings-format-check
Oct 21, 2026
Merged

objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-13287-settings-format-check

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #13287
Clause-②: no

What changed

On Save, the Settings page now judges every visible, unlocked url, email, phone and color row whose effective value (draft over stored) is non-empty. A miss blocks the save on the same path as the required check from objectui#13239: no request goes out, each row is marked inline through the fieldErrors slot (aria-invalid plus aria-describedby to the message), focus moves to the first blocked row in manifest order, and the existing blocked-save toast names the rows. An empty value is left to required.

  • apps/console/src/pages/settings/SettingsView.tsx: emptyRequiredKeys becomes preSaveBlocks. It runs one pass with the same visibility, lock and non-input skips, and returns required or format per key. DECLARED_VALUE_FORMATS with missesDeclaredFormat does the judging, on the trimmed value.
  • Messages, one per format: email reuses validation.email and url reuses validation.url. Two new keys, console.settingsView.invalidPhone and console.settingsView.invalidColor, name what a phone number and a hex colour take. Both are added to all ten locale packs.
  • A server SETTINGS_VALIDATION refusal renders as before. That branch is untouched.

Grammars: the settings service's own, copied from objectstack main

They come from DECLARED_VALUE_FORMATS in service-settings (objectstack PR #25022, merged), so the page never blocks a value the server accepts and never passes one it refuses:

  • email: local@domain with a dotted domain.
  • url: scheme://..., root-relative /path, data: or blob:. This is wider than the dispatch's gloss "scheme http/https". The server accepts any scheme://. The branding.logo_url reader takes absolute or relative values, and platform storage hands back root-relative file URLs. An http(s)-only console would block values the server and the reader both serve.
  • phone: digits, spaces and + ( ) - ., at least 5 characters. The server has this grammar, so phone is checked rather than left out.
  • color: #rgb, #rgba, #rrggbb or #rrggbbaa.

Acceptance notes

  • Untouched stored values. The page judges the effective value, so a stored malformed value on a visible row blocks a save that edits a different row. That row is shown marked so the admin can fix it. This is what the dispatch ruling asks ("effective value"), and the required check works the same way. The server, by contrast, judges only the keys a save touches. It is pinned by the test "a stored malformed value on a visible row blocks a save that edits another row".
  • Colour rows. On a color row, aria-invalid and aria-describedby land on the wrapper div, not on the two inputs. This is how SettingsField's wrapper already handles a server refusal on that row type: cloneElement applies to the outer child. The message itself still renders in the row, and focus goes to the picker. This was found by reading the code and has not been measured in a browser. It is not changed here.

Tests (at a1dd56fed7)

  • New: apps/console/src/pages/settings/__tests__/SettingsView.formatCheck-13287.test.tsx, 15 tests.
    • (a) Logo URL not a url blocks: no request, row marked, focus on it. https://..., /logo.png and a padded /logo.png all save.
    • (b) no-reply@localhost blocks; a valid email saves.
    • (c) red and #12 block; #1a2b3c saves.
    • Phone: a value with letters blocks, a valid one saves. Four misses get four distinct messages, with focus on the first.
    • (d) control: an empty optional url saves.
    • (e) control: a url hidden by visible and an env-locked malformed url do not block.
    • Editing a marked row clears its message.
  • pnpm exec vitest run --maxWorkers=1 apps/console/src/pages/settings/: Test Files 28 passed (28), Tests 233 passed (233). This covers the family that reads SettingsView.tsx, including the required-check suite.
  • The 56 packages/i18n/src/__tests__ files that read the locale packs: Test Files 56 passed (56), Tests 1003 passed (1003). The full apps/console and packages/i18n directories are left to CI.
  • Ablation via ablation-replace.mjs, run at the commit above. The mutation } else if (missesDeclaredFormat( became } else if (false && missesDeclaredFormat(; anchor count went 1 to 0 and the blob went 4f3bc9f9bb64 to c0bd531ba548. Result: 8 failed, 7 passed. Every (a), (b) and (c) block test went red; the save cases and the (d) and (e) controls stayed green. Restore: blob 4f3bc9f9bb64 equals the HEAD blob and git diff HEAD is empty.
  • type-check for @object-ui/i18n and @object-ui/console, after the @object-ui/console^... closure build: both Done, exit 0. Console tsc --listFiles includes the new test.
  • eslint over the 12 changed files (JSON count 12): 0 errors and 3 warnings, all no-explicit-any on pre-existing catch (err: any) lines. With --no-inline-config there is one more, the pre-existing suppressed react-hooks/static-components. The base file gives the same four findings. Type-aware linting is not configured in eslint.config.js, so this diff cannot change the verdict on any untouched file.
  • Gates, all exit 0: check:phantom-deps, check:self-import, check:unreferenced-sources, check:doc-example-readers, check:handler-key-reads, check:side-effects-array, check:element-data-source-declaration, check:spec-symbols, check:action-forward-parity, check:designer-field-key-parity, check:icon-record-names, check:i18n-keys, check:i18n-drift, check:i18n-designer-parity, check:i18n-dead-keys, check:control-bytes, scripts/check-hand-rolled-comment-mask.mjs and scripts/check-changeset-fixed.mjs.

Changeset: .changeset/13287-settings-format-check.md (@object-ui/console patch, @object-ui/i18n patch).


Generated by Claude Code

… Save (objectui#13287)

A url, email, phone or color value that misses the grammar its specifier
type declares (ADR-0007) now blocks Save on the same path as the required
check: no request, the row marked through the field-error slot with a
message naming what the format expects, focus on the first. Grammars are
the settings service's own (objectstack#24882), judged trimmed; empty,
hidden and env-locked rows are not judged.

Co-authored-by: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XVp19E1MYUTFM3dnkwz8gB
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 77 chunks) 3224.5 KB 3744.1 KB
Main entry chunk (gzip) 81.2 KB 350 KB
Entry file index-BSbzPTiT.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 (buildIdentity.js) 0.80KB 0.49KB
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 21.41KB 7.90KB
app-shell (runtime-config.js) 24.52KB 8.48KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.11KB 3.87KB
auth (ActiveOrganizationStorage.js) 27.95KB 10.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 45.59KB 12.03KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 20.67KB 6.12KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.72KB 2.24KB
auth (SocialSignInButtons.js) 9.74KB 3.94KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.62KB 0.83KB
auth (authStyles.js) 5.27KB 1.86KB
auth (createAuthClient.js) 42.84KB 11.66KB
auth (createAuthenticatedFetch.js) 8.54KB 3.46KB
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.26KB 8.03KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.28KB 2.60KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (commentAuthorship.js) 1.39KB 0.78KB
collaboration (index.js) 1.93KB 0.85KB
collaboration (useCollaborationTranslation.js) 6.50KB 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) 617.27KB 150.49KB
core (index.js) 10.18KB 4.04KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 252.96KB 70.67KB
fields (index.js) 294.69KB 75.35KB
i18n (LocalizationContext.js) 2.92KB 1.42KB
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.52KB 2.39KB
i18n (pickLocalized.js) 9.86KB 3.95KB
i18n (provider.js) 39.35KB 12.88KB
i18n (translateFn.js) 0.20KB 0.18KB
i18n (useDisplayLocale.js) 3.52KB 1.76KB
i18n (useObjectLabel.js) 36.87KB 9.88KB
i18n (useSafeTranslation.js) 7.14KB 2.92KB
layout (index.js) 41.40KB 12.01KB
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) 15.35KB 5.51KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.82KB 2.38KB
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.04KB 3.92KB
plugin-calendar (index.js) 55.56KB 16.21KB
plugin-charts (index.js) 86.06KB 23.66KB
plugin-chatbot (index.js) 238.47KB 56.30KB
plugin-dashboard (index.js) 147.53KB 39.95KB
plugin-designer (index.js) 233.95KB 50.08KB
plugin-detail (index.js) 266.70KB 70.83KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 186.64KB 48.54KB
plugin-gantt (index.js) 178.46KB 45.13KB
plugin-grid (index.js) 276.74KB 76.89KB
plugin-kanban (index.js) 64.49KB 19.83KB
plugin-list (index.js) 149.81KB 39.28KB
plugin-map (index.js) 27.17KB 9.00KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 46.66KB 13.13KB
plugin-timeline (index.js) 39.31KB 11.88KB
plugin-tree (index.js) 15.27KB 5.40KB
plugin-view (index.js) 94.54KB 24.33KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 12.07KB 3.68KB
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) 126.45KB 41.40KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.71KB 2.11KB
react (schema-input.js) 4.31KB 2.07KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (body-dialect.js) 4.50KB 1.99KB
sdui-parser (codegen.js) 9.45KB 3.76KB
sdui-parser (dashboard-widget-options.js) 3.07KB 1.30KB
sdui-parser (index.js) 7.30KB 3.12KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 25.28KB 7.81KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.29KB 0.24KB
sdui-parser (validate.js) 23.87KB 7.83KB
types (ai.js) 4.39KB 2.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 4.12KB 1.61KB
types (authoring-nodes.js) 0.20KB 0.19KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (cloud.js) 0.20KB 0.18KB
types (complex.js) 4.44KB 2.07KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (dashboard-widget-layout.js) 2.06KB 0.96KB
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) 1.13KB 0.65KB
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) 5.78KB 2.70KB
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 (node-slots.js) 7.18KB 2.34KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 2.52KB 1.31KB
types (plugin-scope.js) 0.20KB 0.18KB
types (product-blocks.js) 0.20KB 0.19KB
types (record-approval-decision.js) 0.20KB 0.20KB
types (record-components.js) 0.20KB 0.19KB
types (record-panels.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) 4.99KB 1.96KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 19.93KB 7.26KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.48KB 3.50KB
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
objectstack-fleet Bot marked this pull request as ready for review October 21, 2026 04:07
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 21, 2026 04:07
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 21, 2026
Merged via the queue into main with commit 0093b2c Oct 21, 2026
37 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-13287-settings-format-check branch October 21, 2026 04:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Settings pages: a url, email or color value that misses its declared format saves with no word to the admin; the console runs no format check on Save

2 participants