Skip to content

feat(app-shell): the /data filter bar offers single-value relation fields, so Members View all filters by User - #13313

Merged
objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-13310-data-page-relation-filters
Oct 21, 2026
Merged

objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-13310-data-page-relation-filters

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #13310
Clause-②: no

What

ObjectDataPage (the /data surface "View all" opens; it anchors no declared view, objectui#12741) derives its filter bar from the object definition. It derived picklist-like fields only. It now also offers single-value relation fields (lookup, master_detail, user), so an organization's Members "View all" page can be filtered by User (ruling F1 on objectstack-ai/objectstack#24815).

  • The derivation is one exported helper, deriveDataPageUserFilterFields: picklist fields first in declaration order (exactly the old set and order), then single-value relation fields in declaration order, under the unchanged MAX_USER_FILTERS cap of 4. Hidden fields, unreadable fields and multiple: true relations are never offered.
  • Nothing else changes. A relation chip is rendered by UserFilters' existing LookupValuePicker branch (search by name; the query goes through the caller's data source); a pick emits [field, 'in', [id]], the id predicate ListView already ANDs into the list query; the selection rides the existing uf_FIELD URL param. UserFilters.tsx, userFilterUrlState.ts and LookupValuePicker are untouched.

Ruling 2 (cap and order). Measured: sys_member declares organization_id, user_id and role, three fields, so the cap does not cost the Members page its User filter and the cap stays 4. Relations are ordered AFTER picklists so that an object whose picklists already fill the cap keeps exactly the bar it had; that order is pinned. On Members the bar reads Role, Organization, User.

Pin (b), which of the two. The field IS offered, matching what LookupValuePicker already does: it scopes by asking the caller's data source, not by hiding the chip. An unreadable related object answers with a refusal and the picker lists no options (it shows the refusal text).

Tests

New packages/app-shell/src/views/ObjectDataPage.relationUserFilters-13310.test.tsx: the real ObjectDataPage, with ListView replaced by a stand-in that hands schema.userFilters, the restored uf_* selections and the selection callback to the REAL UserFilters and real LookupValuePicker.

  • (a) Members: the bar is Role, Organization, User; picking a member emits user_id in [id] and keeps 1 row, a non-member keeps 0. A user-typed field filters by id the same way.
  • (b) the picker queries demo_vault through the data source; the refusal leaves no options.
  • (c) CONTROL: a picklist-only object renders Status, Priority, Urgent and no lookup chip.
  • (d) a multiple: true user field, a multiple: true lookup, a hidden lookup and an unreadable lookup are not offered.
  • (e) the pick writes uf_user_id; a reload with that URL restores the condition and the resolved label; a stale uf_user_id=u_gone shows u_gone, no error.
  • order and cap: picklists keep all four slots when they fill the cap; relations follow them in declaration order.

Run on the tree committed as 76f01dd1a2 (the final commit), under the shared verify lock: the new file plus the families naming the touched file (ObjectDataPage.* five files, userFilterUrlState.listState-11860), 7 files, 85 tests passed. @object-ui/app-shell type-check (both tsc --noEmit and tsconfig.test.json, which lists the new test) exit 0 after a turbo build of the @object-ui/app-shell^... closure. The full packages/app-shell/ directory is declared to CI, not run locally.

Ablation (through ablation-replace.mjs, anchor hit 1 to 0): USER_FILTER_RELATION_TYPES emptied. Predicted: (a), (e) and the ordering case RED; (c) GREEN. Observed: 6 failed, 3 passed. Red: both (a) cases, (b), (d), (e), the relation-order case. Green: (c), the picklists-keep-their-slots case, the no-fields case. (b) and (d) also went red, which the prediction did not say: both assert the single-value relation chips are present (the field offered in b; assignee/vault remaining in d), so they need the relation set too. Restore proved by blob hash: d8f37661c3fe after restore equals the HEAD blob, git diff HEAD empty.

Browser measurement (Done when)

A real stack: objectstack origin/main 28c9a2cb66 examples/app-showcase (objectstack dev --seed-admin --fresh on a private port), with this branch's console (apps/console vite, proxied to it), driven by Playwright Chromium, signed in as the seeded admin. Data: the Default Organization; Ada Auditor (demo) removed from it through better-auth organization/remove-member, so she is a user who is not a member.

  • Organization record, Members tab, View All opens /apps/setup/sys_member/data?filter[organization_id]=org_mvhxp7nxzorku6gl with 2 records. Bar: Role, Organization, User.
  • User, search "Dev", pick Dev Admin (a member): 1 record; URL gains uf_user_id=AVv0T5ffUcGSwUccNvxX3YUU3zN5ysf0.
  • Clear, search "Ada", pick Ada Auditor (demo) (not a member): 0 records ("No matching records"); URL uf_user_id=usr_showcase_auditor_demo.
  • Reload: still 0 records, the User chip still shows 1 selection.

Gates (exit codes, final commit 76f01dd1a2)

All 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:control-bytes, check:new-line-citations, check-hand-rolled-comment-mask.mjs, check-changeset-fixed.mjs, check-changeset-presence.mjs.

eslint --no-inline-config narrowed to the two changed source files: exit 0, 0 errors, 14 warnings, the same count the origin/main copy of ObjectDataPage.tsx produces (one new only-export-components for the exported helper, one no-explicit-any removed). The narrowing is a measurement: both files sit under the config's **/*.{ts,tsx} block; the file count is 2 from --format json; the config enables no type-aware linting (no parserOptions.project / projectService), so this diff cannot move a verdict on an untouched file. The repo-wide pnpm lint is CI's.

Acceptance notes

  • System relation fields count as relations: on an ordinary object the injected created_by, updated_by and owner_id lookups now become eligible after the declared fields, inside the same cap. sys_member carries none.
  • docs/adr/0055-parameterized-bare-data-surface.md point 4 still says the bar derives from enum-ish fields. An ADR is a dated record, so it is not edited here; carrier: none.
  • One .changeset/13310-data-page-relation-filters.md, @object-ui/app-shell patch.
  • No objectstack metadata change; no free-text page search; no multi-value relations.

The session for this change is https://claude.ai/code/session_01XVp19E1MYUTFM3dnkwz8gB.


Generated by Claude Code

…value relation fields

ObjectDataPage derives its filter bar from the object definition because
"View all" anchors no declared view (objectui#12741). It now offers
single-value lookup, master_detail and user fields after the picklist
fields, under the same four-field cap, through UserFilters' existing
LookupValuePicker; a pick filters by the related record's id and persists
in uf_* like the picklist filters. Multi-value relations stay out.

Co-authored-by: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XVp19E1MYUTFM3dnkwz8gB
… location in an effect

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) 3225.1 KB 3744.1 KB
Main entry chunk (gzip) 81.2 KB 350 KB
Entry file index-Dk0qEED-.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.54KB 150.58KB
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.97KB 75.45KB
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) 267.56KB 71.11KB
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) 129.13KB 42.23KB
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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants