Skip to content

fix: align NavigationItem and NavigationArea label types with @objectstack/spec v4#1225

Merged
hotlong merged 2 commits intomainfrom
claude/fix-pnpm-dev-issues
Apr 14, 2026
Merged

fix: align NavigationItem and NavigationArea label types with @objectstack/spec v4#1225
hotlong merged 2 commits intomainfrom
claude/fix-pnpm-dev-issues

Conversation

@Claude
Copy link
Copy Markdown
Contributor

@Claude Claude AI commented Apr 14, 2026

Problem

@objectstack/spec v4 changed the protocol to require label fields as plain strings, but ObjectUI type definitions still allowed the legacy i18n object format {key, defaultValue, params}, causing validation warnings during development.

Changes

Type Definition Updates

  • NavigationItem.label: string | {key, defaultValue, params}string
  • NavigationArea.label: string | {key, defaultValue, params}string

Backward Compatibility Preserved

  • Runtime utilities (resolveI18nLabel(), resolveLabel()) still handle both formats for data coming from external sources or legacy configurations
  • Only type definitions enforce the new protocol

Note

Validation warnings from @objectstack/plugin-auth persist due to upstream runtime transformations in the ObjectStack framework itself - the plugin's TypeScript source uses plain strings but runtime code transforms them to i18n objects. This is an upstream issue outside ObjectUI's scope.

// Before (legacy format still in type definition)
export interface NavigationItem {
  label: string | { key: string; defaultValue?: string; params?: Record<string, any> };
}

// After (spec v4 compliant)
export interface NavigationItem {
  label: string; // Plain string only per @objectstack/spec v4
}

Claude AI and others added 2 commits April 14, 2026 01:49
Updated pnpm-lock.yaml via clean install to ensure all @objectstack packages are on consistent 4.0.3 versions.

Note: There's a validation warning from @objectstack/spec@4.0.3 regarding Setup app navigation labels, but this is an upstream issue and doesn't affect functionality. The dev server starts and runs successfully.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
…stack/spec v4

Updated NavigationItem.label and NavigationArea.label to use plain string type instead of the legacy i18n object format `{key, defaultValue}`.

This aligns our type definitions with @objectstack/spec v4 protocol which requires label fields to be plain strings only.

Note: The validation warning from @objectstack/plugin-auth persists because that package's runtime code still transforms string labels into i18n objects. This is an upstream issue in the @objectstack framework.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 14, 2026

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

Project Deployment Actions Updated (UTC)
objectui-demo Ready Ready Preview, Comment Apr 14, 2026 2:48am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectui Ignored Ignored Apr 14, 2026 2:48am

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Main entry (gzip) 287.4 KB 350 KB
Entry file index-KDzKK6UM.js
Status PASS

📦 Bundle Size Report

Package Size Gzipped
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 1.17KB 0.53KB
auth (AuthProvider.js) 7.37KB 1.79KB
auth (ForgotPasswordForm.js) 4.91KB 1.66KB
auth (LoginForm.js) 5.00KB 1.64KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.85KB 1.86KB
auth (UserMenu.js) 3.40KB 1.22KB
auth (createAuthClient.js) 5.14KB 1.60KB
auth (createAuthenticatedFetch.js) 1.24KB 0.60KB
auth (index.js) 1.18KB 0.51KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 1.57KB 0.57KB
collaboration (CommentThread.js) 18.38KB 4.49KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 3.65KB 1.42KB
collaboration (index.js) 1.16KB 0.50KB
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) 1979.64KB 464.57KB
core (index.js) 1.29KB 0.51KB
create-plugin (index.js) 10.13KB 3.17KB
data-objectstack (index.js) 45.20KB 11.14KB
fields (LookupField-B6MOSQVJ.js) 30.75KB 8.34KB
fields (index.js) 74.79KB 15.84KB
fields (rolldown-runtime-CAFD8bLK.js) 0.24KB 0.24KB
fields (useFieldTranslation-Bv3oUVgb.js) 0.26KB 0.21KB
i18n (i18n.js) 2.03KB 0.77KB
i18n (index.js) 1.99KB 0.79KB
i18n (provider.js) 4.63KB 1.47KB
i18n (useObjectLabel.js) 4.51KB 1.61KB
i18n (useSafeTranslation.js) 1.63KB 0.57KB
layout (index.js) 88.09KB 24.91KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (index.js) 1.19KB 0.53KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 4.42KB 1.27KB
mobile (usePullToRefresh.js) 2.53KB 0.85KB
mobile (useResponsive.js) 0.71KB 0.42KB
mobile (useResponsiveConfig.js) 1.36KB 0.63KB
mobile (useSpecGesture.js) 1.77KB 0.77KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 3.11KB 0.87KB
permissions (evaluator.js) 4.00KB 1.23KB
permissions (index.js) 0.85KB 0.40KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.52KB
permissions (usePermissions.js) 0.99KB 0.49KB
plugin-aggrid (AddressField-DKqaE9pD.js) 2.85KB 0.81KB
plugin-aggrid (AgGridImpl-DBqxIsko.js) 6.39KB 2.24KB
plugin-aggrid (AutoNumberField-0RU2dNKe.js) 0.43KB 0.34KB
plugin-aggrid (AvatarField-C5b9biGa.js) 2.65KB 1.15KB
plugin-aggrid (BooleanField-DRzAZhSq.js) 1.23KB 0.58KB
plugin-aggrid (CodeField-RWhnDMyL.js) 0.86KB 0.53KB
plugin-aggrid (ColorField-B-YAFXdz.js) 1.26KB 0.59KB
plugin-aggrid (CurrencyField-Bu80a-sI.js) 1.52KB 0.80KB
plugin-aggrid (DateField-CV-NpLbM.js) 0.65KB 0.43KB
plugin-aggrid (DateTimeField--YTsgTjw.js) 0.82KB 0.48KB
plugin-aggrid (EmailField-B-3fWJsH.js) 0.88KB 0.53KB
plugin-aggrid (FileField-BcGMvBnI.js) 5.67KB 2.05KB
plugin-aggrid (FormulaField-MQXJZOep.js) 0.64KB 0.46KB
plugin-aggrid (GeolocationField-D3BrmwqV.js) 4.10KB 1.49KB
plugin-aggrid (GridField-DHsGo9l2.js) 1.96KB 0.76KB
plugin-aggrid (ImageField-BBqwJEkk.js) 2.65KB 1.12KB
plugin-aggrid (LocationField-DSvhU9Dz.js) 1.00KB 0.59KB
plugin-aggrid (LookupField-DoOmbbZF.js) 33.78KB 8.95KB
plugin-aggrid (LookupField-KfYQlgUd.js) 0.08KB 0.11KB
plugin-aggrid (MasterDetailField-BnSPGAtS.js) 3.40KB 1.14KB
plugin-aggrid (NumberField-Kz4_o5DE.js) 0.76KB 0.50KB
plugin-aggrid (ObjectAgGridImpl-DrI0aa8t.js) 726.52KB 183.35KB
plugin-aggrid (ObjectField-C1qkl6s4.js) 1.63KB 0.82KB
plugin-aggrid (PasswordField-k5JeKk9f.js) 1.88KB 0.94KB
plugin-aggrid (PercentField-Dmipqv0I.js) 1.85KB 0.88KB
plugin-aggrid (PhoneField-Dn4h6V9H.js) 0.87KB 0.54KB
plugin-aggrid (QRCodeField-BIrSW1Zr.js) 3.27KB 1.25KB
plugin-aggrid (RatingField-5iMhn2GL.js) 2.05KB 0.93KB
plugin-aggrid (RichTextField-CN5BRd_7.js) 1.19KB 0.63KB
plugin-aggrid (SelectField-Bjk_S2zT.js) 1.07KB 0.58KB
plugin-aggrid (SelectField-CcWvzp9g.js) 0.08KB 0.11KB
plugin-aggrid (SignatureField-BAMvNrE6.js) 3.14KB 1.29KB
plugin-aggrid (SliderField-C9IhmjbF.js) 1.11KB 0.55KB
plugin-aggrid (SummaryField-R9RENAZv.js) 0.60KB 0.45KB
plugin-aggrid (TextAreaField-BY63Nr6-.js) 1.12KB 0.64KB
plugin-aggrid (TextField-SIw8aMzf.js) 0.90KB 0.50KB
plugin-aggrid (TimeField-xxziHPjE.js) 0.61KB 0.40KB
plugin-aggrid (UrlField-Ihk3_ff5.js) 1.04KB 0.57KB
plugin-aggrid (UserField-BHl6mmIH.js) 2.62KB 0.98KB
plugin-aggrid (VectorField-Ci167cxr.js) 0.92KB 0.52KB
plugin-aggrid (createLucideIcon-BjfZYZey.js) 1.72KB 0.93KB
plugin-aggrid (image-DlUdeTgT.js) 0.36KB 0.26KB
plugin-aggrid (index.js) 10.33KB 2.43KB
plugin-aggrid (jsx-runtime-CGDkM_Jn.js) 7.83KB 2.89KB
plugin-aggrid (plus-BwEV_Q5_.js) 0.19KB 0.19KB
plugin-aggrid (upload-DPiohvXv.js) 0.29KB 0.23KB
plugin-aggrid (useFieldTranslation-C69OtouR.js) 9.53KB 3.69KB
plugin-aggrid (x-BFq2GeQ5.js) 0.19KB 0.19KB
plugin-ai (index.js) 24.21KB 6.44KB
plugin-calendar (index.js) 44.95KB 12.96KB
plugin-charts (AdvancedChartImpl-JDjuxIZW.js) 118.19KB 24.21KB
plugin-charts (BarChart-Bvt5Se8Q.js) 523.60KB 126.89KB
plugin-charts (ChartImpl-CQj8Kris.js) 3.62KB 1.16KB
plugin-charts (index.js) 12.70KB 4.07KB
plugin-charts (jsx-runtime-C8d0IhUE.js) 8.40KB 3.09KB
plugin-chatbot (index.js) 1194.20KB 340.76KB
plugin-dashboard (index.js) 158.02KB 38.69KB
plugin-designer (index.js) 244.91KB 47.93KB
plugin-detail (AddressField-CDLSeyNx.js) 2.66KB 0.79KB
plugin-detail (AutoNumberField-CtE7suf5.js) 0.44KB 0.34KB
plugin-detail (AvatarField-Xuieq0ZI.js) 2.40KB 1.09KB
plugin-detail (BooleanField-DwfMKknK.js) 1.14KB 0.55KB
plugin-detail (CodeField-CfwgRxx2.js) 0.80KB 0.50KB
plugin-detail (ColorField-YKHA7dBD.js) 1.19KB 0.57KB
plugin-detail (CurrencyField-tvS3fPAF.js) 1.47KB 0.78KB
plugin-detail (DateField-BKqXpkOh.js) 0.60KB 0.41KB
plugin-detail (DateTimeField-CR-nJCE7.js) 0.78KB 0.46KB
plugin-detail (EmailField-CgvW1Qal.js) 0.83KB 0.51KB
plugin-detail (FileField-BVAme2ML.js) 5.12KB 1.90KB
plugin-detail (FormulaField-DamJ2VaG.js) 0.66KB 0.45KB
plugin-detail (GeolocationField-C99z7ZBM.js) 3.31KB 1.23KB
plugin-detail (GridField-C9JbpTx_.js) 1.83KB 0.74KB
plugin-detail (ImageField-CDANtgVV.js) 2.45KB 1.09KB
plugin-detail (LocationField-ZSyZ0O-h.js) 0.97KB 0.58KB
plugin-detail (LookupField-B3hQJt95.js) 30.30KB 8.21KB
plugin-detail (LookupField-D00z6gn_.js) 0.08KB 0.11KB
plugin-detail (MasterDetailField-B0HTmmD7.js) 2.90KB 1.00KB
plugin-detail (NumberField-DL2QAL7X.js) 0.72KB 0.47KB
plugin-detail (ObjectField-JYvUnuRO.js) 1.57KB 0.79KB
plugin-detail (PasswordField-DVTimsc3.js) 1.13KB 0.66KB
plugin-detail (PercentField-DjR6BSpw.js) 1.76KB 0.86KB
plugin-detail (PhoneField-CX1JL-jp.js) 0.82KB 0.51KB
plugin-detail (QRCodeField-CH_1pU6R.js) 2.15KB 0.93KB
plugin-detail (RatingField-rRi_P0N0.js) 1.56KB 0.69KB
plugin-detail (RichTextField-CJqLWlrb.js) 1.12KB 0.62KB
plugin-detail (SelectField-DGoDoRM_.js) 0.96KB 0.55KB
plugin-detail (SelectField-XBVI50AD.js) 0.08KB 0.11KB
plugin-detail (SignatureField-2CnhcWI0.js) 2.81KB 1.15KB
plugin-detail (SliderField-DEpMVXko.js) 1.04KB 0.53KB
plugin-detail (SummaryField-7ch9aqAu.js) 0.62KB 0.45KB
plugin-detail (TextAreaField-Cmw1oXcw.js) 1.06KB 0.62KB
plugin-detail (TextField-OTLa3p51.js) 0.84KB 0.47KB
plugin-detail (TimeField-DKPoNWoR.js) 0.57KB 0.38KB
plugin-detail (UrlField-CxbmzP9f.js) 0.98KB 0.55KB
plugin-detail (UserField-ChvwUkMK.js) 2.43KB 0.95KB
plugin-detail (VectorField-BVClL8Vw.js) 0.92KB 0.52KB
plugin-detail (index.js) 136.92KB 30.17KB
plugin-detail (src-C56Ly5uG.js) 1959.48KB 461.51KB
plugin-detail (useFieldTranslation-CkxqyB82.js) 0.25KB 0.20KB
plugin-editor (MonacoImpl-BMgw4JKF.js) 17.97KB 5.53KB
plugin-editor (index.js) 1.61KB 0.74KB
plugin-editor (jsx-runtime-HjdTyiyb.js) 7.63KB 2.80KB
plugin-form (index.js) 60.57KB 13.62KB
plugin-gantt (index.js) 215.46KB 52.74KB
plugin-grid (index.js) 101.88KB 27.60KB
plugin-kanban (KanbanEnhanced-TdUe0kQH.js) 30.21KB 8.94KB
plugin-kanban (KanbanImpl-BtlPa7GE.js) 13.33KB 4.08KB
plugin-kanban (chevron-down-B6UH8BbF.js) 0.15KB 0.18KB
plugin-kanban (index.js) 18.55KB 5.80KB
plugin-kanban (plus-BTqoaaEC.js) 9.31KB 3.57KB
plugin-kanban (sortable.esm-LJG1TjKd.js) 59.36KB 17.43KB
plugin-list (index.js) 2029.65KB 476.72KB
plugin-map (chunk-vKJrgz-R.js) 1.18KB 0.67KB
plugin-map (index.js) 123.69KB 30.35KB
plugin-map (maplibre-gl-DK6BxsIK.js) 1331.05KB 296.40KB
plugin-markdown (MarkdownImpl-BcKLng98.js) 220.68KB 53.61KB
plugin-markdown (index.js) 1.04KB 0.58KB
plugin-markdown (jsx-runtime-B1W8iDPg.js) 8.39KB 3.09KB
plugin-report (index.js) 70.37KB 13.98KB
plugin-timeline (index.js) 99.93KB 24.18KB
plugin-view (index.js) 116.61KB 31.05KB
plugin-workflow (index.js) 81.18KB 17.06KB
react (LazyPluginLoader.js) 3.77KB 1.33KB
react (SchemaRenderer.js) 9.07KB 2.83KB
react (index.js) 0.76KB 0.42KB
tenant (TenantContext.js) 0.31KB 0.25KB
tenant (TenantGuard.js) 1.04KB 0.43KB
tenant (TenantProvider.js) 2.76KB 0.98KB
tenant (TenantScopedQuery.js) 0.77KB 0.44KB
tenant (index.js) 0.75KB 0.38KB
tenant (resolver.js) 2.64KB 0.76KB
tenant (useTenant.js) 0.50KB 0.32KB
tenant (useTenantBranding.js) 0.62KB 0.39KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 0.99KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 0.20KB 0.18KB
types (crud.js) 0.20KB 0.18KB
types (data-display.js) 0.20KB 0.18KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 0.74KB 0.39KB
types (disclosure.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 (index.js) 1.25KB 0.58KB
types (layout.js) 0.20KB 0.18KB
types (mobile.js) 0.20KB 0.18KB
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 (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (tenant.js) 0.20KB 0.18KB
types (theme.js) 0.20KB 0.18KB
types (ui-action.js) 0.20KB 0.18KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB
types (workflow.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

@hotlong hotlong marked this pull request as ready for review April 14, 2026 02:53
Copilot AI review requested due to automatic review settings April 14, 2026 02:53
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Aligns ObjectUI’s unified navigation type definitions with @objectstack/spec v4 by enforcing label fields as plain strings, eliminating legacy i18n-object typing that caused dev-time validation/type inconsistencies.

Changes:

  • Update NavigationItem.label type from a string-or-i18n-object union to string.
  • Update NavigationArea.label type from a string-or-i18n-object union to string.
  • Adjust inline documentation comments to reflect the spec v4 requirement.

@hotlong hotlong merged commit 1ce682d into main Apr 14, 2026
14 of 15 checks passed
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.

3 participants