Skip to content

feat(types)!: adopt @objectstack/spec 15; drop value-erased spec/ui …Schema re-exports (#2561) - #2589

Merged
os-zhuang merged 4 commits into
mainfrom
feat/types-spec15-ui-reexports
Jul 17, 2026
Merged

feat(types)!: adopt @objectstack/spec 15; drop value-erased spec/ui …Schema re-exports (#2561)#2589
os-zhuang merged 4 commits into
mainfrom
feat/types-spec15-ui-reexports

Conversation

@os-zhuang

@os-zhuangos-zhuang commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Implements both halves of #2561 as one coherent types-package PR.

1. /ui re-export shape — decision (a)

Evidence gathered before deciding: zero consumers of the ~84 …Schema names anywhere in this repo (packages/apps/content, value- or type-level), no sibling-repo package depends on @object-ui/types, and since the names sat inside export type blocks they were value-erased — any import would have received undefined at runtime, so no working consumer can exist. Went with (a): the schema names are dropped from the public surface; the inferred types (DndConfig, SpecFormView, …) are unchanged and the genuine value re-exports (defineStack, ObjectStackSchema, SpecReportSchema, …) keep working. BreakpointColumnMapSchema / BreakpointOrderMapSchema are dropped without a type replacement (spec exports no companion inferred type). theme.ts's ThemeModeSchema was the same class of bug and is dropped too.

Guardrail: packages/types/src/__tests__/spec-ui-schema-reexports.test.ts pins the contract three ways — the dropped names are not runtime-exported, the genuine value exports stay defined, and a source scan fails if any spec/ui zod value ever reappears inside an export type block.

2. Spec pin ^14.6^15.1.1

All 14 workspace package.jsons + lockfile. The issue predicted the bump was low-risk modulo strict-mode fixture fallout — validation found something better: ADR-0089 D3a's .strict().transform(…) pipes crash z.toJSONSchema over spec's lazySchema proxies (Cannot set properties of undefined (setting 'ref')), which broke Studio's spec-derived Page inspector schema (caught by page-schema.test.ts) and silently degraded the View inspector (no test existed). Root cause + fix upstream: objectstack-ai/objectstack#3021, which shipped in @objectstack/spec@15.1.1 (15.1.0 predates it). Hence the 15.1.1 floor.

New view-schema.test.ts pins the previously-untested View-inspector derivation.

Verification

  • @object-ui/typestsc --noEmit clean under spec 15.1.1; guardrail test + full types suite 86 passed.
  • app-shell Page + View inspector schema tests 7 passed against the real published @objectstack/spec@15.1.1 (not a dist overlay).
  • Full workspace suite 6852 passed / 0 failed (24 skipped) against 15.1.1.
  • Changeset: major on the fixed group (version-alignment policy: objectui major follows @objectstack major → next release is 15).

Status

Closes#2561. Refs #2545, objectstack-ai/objectstack#2998.

🤖 Generated with Claude Code

…chema re-exports (#2561)
Decision (a) from #2561: the ~84 zod-validator names (DndConfigSchema,
SpecFormViewSchema, ThemeModeSchema, ...) sat inside 'export type' blocks,
so importing any of them as a value from @object-ui/types silently yielded
undefined at runtime. They are removed from the public surface instead of
converted to value re-exports; consumers needing the runtime validators
import @objectstack/spec/ui directly. Inferred types unchanged; genuine
value re-exports (defineStack, ObjectStackSchema, SpecReportSchema, ...)
keep working. Guardrail test pins the contract both at runtime and via
source scan.
Bump @objectstack/spec ^14.6.0 -> ^15.0.1 across all 14 workspace
package.json files. The floor is 15.0.1: ADR-0089 D3a's
.strict().transform() pipes crashed z.toJSONSchema over spec's lazySchema
proxies, breaking Studio's spec-derived Page/View inspector schemas
(fixed upstream in framework#3021). New view-schema.test.ts pins the
previously-untested View inspector derivation.
Closes#2561
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredJul 17, 2026 10:01am

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

❌ Console Performance Budget

MetricValueBudget
Main entry (gzip)** KB**KB
Entry file``
StatusFAIL

📦 Bundle Size Report

PackageSizeGzipped

Size Limits

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

…es the framework#3021 fix)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

❌ Console Performance Budget

MetricValueBudget
Main entry (gzip)** KB**KB
Entry file``
StatusFAIL

📦 Bundle Size Report

PackageSizeGzipped

Size Limits

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

claude added 2 commits July 17, 2026 09:58
…reexports
# Conflicts:
#	packages/plugin-view/package.json
#	pnpm-lock.yaml
…fix release)
framework#3021's z.toJSONSchema/lazySchema-proxy fix shipped in
@objectstack/spec 15.1.1, not 15.1.0. Raise the floor across the
workspace to ^15.1.1 so the Studio Page/View inspector derivation is
guaranteed the fix, and refresh the lockfile to 15.1.1. Align the
changeset and types README narrative.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015Cijq425rfCKbyvFthNWTD
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)27.6 KB350 KB
Entry fileindex-wMOe8boX.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)8.17KB2.95KB
app-shell (runtime-config.js)7.42KB2.32KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)7.57KB2.97KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)21.70KB4.21KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.12KB3.41KB
auth (LoginForm.js)17.86KB5.29KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.43KB2.09KB
auth (SocialSignInButtons.js)9.60KB3.89KB
auth (UserMenu.js)3.40KB1.22KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)33.74KB8.53KB
auth (createAuthenticatedFetch.js)3.93KB1.55KB
auth (index.js)1.83KB0.79KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)4.86KB0.85KB
auth (useIsWorkspaceAdmin.js)1.61KB0.85KB
collaboration (CommentThread.js)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (PresenceProvider.js)2.42KB0.96KB
collaboration (index.js)1.25KB0.53KB
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)449.19KB97.54KB
core (index.js)1.82KB0.62KB
create-plugin (index.js)9.28KB2.98KB
data-objectstack (index.js)115.42KB28.53KB
fields (index.js)208.25KB50.87KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.32KB1.77KB
i18n (index.js)2.46KB0.96KB
i18n (pickLocalized.js)1.70KB0.83KB
i18n (provider.js)5.37KB1.72KB
i18n (useObjectLabel.js)21.22KB4.69KB
i18n (useSafeTranslation.js)2.87KB1.28KB
layout (index.js)38.45KB10.67KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.74KB
mobile (index.js)1.50KB0.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)4.42KB1.27KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)5.90KB2.15KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.46KB1.03KB
permissions (evaluator.js)4.00KB1.23KB
permissions (index.js)0.91KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)1.50KB0.70KB
plugin-ai (index.js)15.71KB3.79KB
plugin-calendar (index.js)45.12KB12.34KB
plugin-charts (index.js)46.31KB13.06KB
plugin-chatbot (index.js)179.58KB42.81KB
plugin-dashboard (index.js)117.25KB29.14KB
plugin-designer (index.js)213.89KB43.03KB
plugin-detail (index.js)213.30KB51.94KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)105.03KB25.46KB
plugin-gantt (index.js)149.18KB37.17KB
plugin-grid (index.js)173.23KB45.75KB
plugin-kanban (index.js)47.23KB12.88KB
plugin-list (index.js)97.69KB23.10KB
plugin-map (index.js)16.80KB5.24KB
plugin-markdown (index.js)13.65KB4.67KB
plugin-report (index.js)37.63KB9.92KB
plugin-timeline (index.js)25.37KB7.20KB
plugin-tree (index.js)8.36KB2.81KB
plugin-view (index.js)85.72KB20.86KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
providers (UploadProvider.js)11.71KB3.53KB
providers (index.js)0.44KB0.22KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)3.19KB1.38KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)18.70KB6.09KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)0.76KB0.42KB
sdui-parser (codegen.js)4.09KB1.74KB
sdui-parser (index.js)2.16KB0.94KB
sdui-parser (parse.js)10.04KB2.82KB
sdui-parser (types.js)0.29KB0.24KB
sdui-parser (validate.js)4.69KB1.48KB
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 (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.77KB0.41KB
types (disclosure.js)0.20KB0.18KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (index.js)1.67KB0.75KB
types (layout.js)0.20KB0.18KB
types (mobile.js)0.20KB0.18KB
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.26KB1.96KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)0.75KB0.46KB
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-zhuang
os-zhuang marked this pull request as ready for review July 17, 2026 10:14
@os-zhuang
os-zhuang merged commit 9b8f978 into mainJul 17, 2026
10 checks passed
@os-zhuang
os-zhuang deleted the feat/types-spec15-ui-reexports branch July 17, 2026 12:06
Sign up for freeto 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.

@object-ui/types: decide the @objectstack/spec/ui re-export shape + bump spec pin to ^15

2 participants

@os-zhuang@claude