Skip to content

feat(gantt): declare viewMode on ObjectGanttSchema and wire both renderer branches - #5825

Merged
os-zhuang merged 1 commit into
mainfrom
claude/issue-5074-gantt-viewmode-declare-wire
Aug 23, 2026
Merged

feat(gantt): declare viewMode on ObjectGanttSchema and wire both renderer branches#5825
os-zhuang merged 1 commit into
mainfrom
claude/issue-5074-gantt-viewmode-declare-wire

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Fixes #5074

Executes the maintainer-confirmed ruling of 2026-08-19 (issue comment 5339681862): declare viewMode and wire BOTH branches. The triage seat's "remove" recommendation was rejected there and is not re-opened here.

Precondition re-verified in node_modules

Counter-probed the installed @objectstack/spec (the repo's pinned release) before writing anything, same probe shape as the unlock scan:

probe result
GanttConfigSchema.viewMode (via @objectstack/spec/ui) presentz.enum(['day','week','month','quarter','year']).optional(), no default
resourceView (known-present control) present
zzNotAKey (known-absent control) absent

What changed

  • packages/types/src/objectql.tsObjectGanttSchema declares viewMode?: SpecGanttConfig['viewMode'], DERIVED from the spec type so the member list cannot drift. Doc comment pins the absence semantics (no default; persisted layout may seed granularity).
  • packages/types/src/zod/objectql.zod.ts — the zod mirror declares viewMode: SpecGanttConfigSchema.shape.viewMode.describe(...) — the spec's own optional enum by reference (.describe() wraps; the inner enum object stays reference-identical, pinned by test).
  • packages/plugin-gantt/src/ObjectGantt.tsx
    • getGanttConfig picks viewMode into GanttConfigEx on the flattened path, so both the flattened object-gantt style and the spec gantt config block carry it;
    • the timeline branch now passes viewMode={ganttConfig?.viewMode} to GanttView — deliberately without || 'day', so an omitted key keeps letting the persisted layout (persistLayoutKey) seed the granularity before GanttView's own 'day' fallback (a guard comment marks this as load-bearing);
    • the ResourceWorkload branch reads ganttConfig?.viewMode || 'day' — the (schema as any).viewMode cast is retired (zero remaining as any).viewMode reads in the repo); the now-unused GanttViewMode type import is dropped.
  • Accept-set note: viewMode is now a DECLARED key, so an off-enum value (e.g. 'hour') fails the zod parse where it previously passed through .passthrough() unvalidated. Values on the published spec enum are unaffected. Repo sweep found no fixture, example, or app authoring viewMode on a gantt schema (only the unrelated previewMode and gantt demo i18n labels), so nothing in-repo is re-judged by the narrowing.
  • Changeset: .changeset/gantt-viewmode-declared-both-branches-5074.md (minor for @object-ui/types + @object-ui/plugin-gantt; no bare version literals).

Out of scope, untouched

The other nine undeclared as any reads (readOnly, markers, holidays, skipWeekends, criticalPath, showBaselines, mobileReadOnly, navigation, persistLayout) stay with the #5043 family track. #5057 and #5126 chain behind this card and remain open — nothing here closes them. The stale GanttViewMode JSDoc card (#5132) and content/docs/plugins/plugin-gantt.mdx are untouched.

Tests

New suites:

  • packages/plugin-gantt/src/ObjectGantt.viewmode.test.tsx — wiring pins (GanttView/ResourceWorkload mocked to thin shells, the file's established convention): timeline honours an authored viewMode in both authoring styles; timeline receives exactly undefined when omitted (the pin that stops someone "simplifying" || 'day' back in); ResourceWorkload still honours the key and keeps its 'day' fallback.
  • packages/types/src/__tests__/gantt-view-mode-declared.test.ts — contract pins: key declared; inner enum reference-identical to the spec's (anti-fork); every spec member accepted; off-enum value refused with an invalid_value issue on the viewMode path; omitted key stays absent after parse (no default materialised); TS member mutually assignable with the spec type + @ts-expect-error non-member pin (compiled by tsconfig.test.json, so it is real enforcement).

Reverse verification on a real commit (git checkout HEAD~1 -- <3 source files>, tests kept; then restored, git diff HEAD --stat empty, re-run green 11/11):

  • Red on reverted source (5 discriminating legs): both "honours an authored viewMode" wiring legs (flattened + gantt block); "declares the key"; "reference identity"; "refuses an off-enum value".
  • Legs that do NOT discriminate (pass either way, stated per protocol): "passes NO viewMode when omitted" (prop was absent pre-fix too — it discriminates the future || 'day' regression, not the pre-fix state); both ResourceWorkload legs (that branch already honoured the key); "accepts every member" (passthrough accepted the undeclared key pre-fix); "no default materialised" (absent either way at runtime — its compile-time half red-shifts only under tsc -p tsconfig.test.json against the reverted interface); the TS mutual-assignability leg (runtime-erased).

Verification union at c4a12f52e (the PR head), all through the container's shared verify lock, verdict lines read from the gate's own output:

  • pnpm exec vitest run packages/plugin-gantt/ packages/types/ (repo root, per AGENTS.md) — Test Files 92 passed (92), Tests 912 passed (912)
  • pnpm --filter @object-ui/types type-check and pnpm --filter @object-ui/plugin-gantt type-check (dependency closure built first) — both clean, script names echoed
  • pnpm lint (turbo run lint, full farm — not narrowed) — 47/47 tasks successful
  • node scripts/check-changeset-presence.mjs ✅ · check-changeset-no-major.mjs ✅ · check-control-bytes.mjs ✅ · check-spec-symbol-derivation.mjs

CI is expected to run the same farm; per dispatch protocol this PR is reported at draft time without waiting for CI convergence.

Generated by Claude Code


Generated by Claude Code

…erer branches (#5074)

Executes the 2026-08-19 maintainer-confirmed ruling (declare-and-wire; the
spec half landed upstream first):

- ObjectGanttSchema declares viewMode in the TS interface and the zod
  mirror, DERIVED from the pinned @objectstack/spec GanttConfigSchema
  member by reference so the list cannot drift. Deliberately no default:
  absence keeps letting a persisted layout seed the granularity before
  the renderer's 'day' fallback.
- getGanttConfig picks viewMode into GanttConfigEx, so both the flattened
  object-gantt style and the spec gantt config block carry it.
- The timeline branch (GanttView) now receives the authored viewMode;
  previously only the ResourceWorkload branch honoured it. The
  (schema as any).viewMode cast is retired.
- Tests: wiring pins for both branches and both authoring styles
  (ObjectGantt.viewmode.test.tsx), plus contract pins for derivation by
  reference, declared-key validation, and no-default absence semantics
  (gantt-view-mode-declared.test.ts).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EuPCi56cnGyykygi3z9w4m
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 52 chunks) 3227.1 KB 3990.2 KB
Main entry chunk (gzip) 152.7 KB 350 KB
Entry file index-BXIeB5fL.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 (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 10.04KB 3.72KB
app-shell (runtime-config.js) 12.80KB 4.47KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 25.05KB 9.16KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 37.99KB 9.84KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.46KB 3.43KB
auth (index.js) 3.19KB 1.44KB
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) 5.13KB 2.35KB
collaboration (CommentThread.js) 26.08KB 7.56KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 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) 503.96KB 113.94KB
core (index.js) 4.92KB 1.97KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 164.55KB 45.67KB
fields (index.js) 238.40KB 59.89KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (i18n.js) 4.28KB 1.75KB
i18n (index.js) 3.44KB 1.39KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 23.13KB 7.63KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 33.40KB 8.71KB
i18n (useSafeTranslation.js) 7.77KB 3.13KB
layout (index.js) 38.95KB 10.97KB
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.55KB 0.62KB
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) 2.53KB 0.85KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useResponsiveConfig.js) 1.37KB 0.63KB
mobile (useSpecGesture.js) 4.32KB 1.64KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 9.53KB 3.38KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 4.64KB 1.50KB
permissions (evaluator.js) 5.12KB 1.74KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 1.93KB 0.88KB
plugin-ai (index.js) 15.75KB 3.80KB
plugin-calendar (index.js) 46.62KB 12.83KB
plugin-charts (index.js) 64.66KB 18.32KB
plugin-chatbot (index.js) 186.86KB 44.21KB
plugin-dashboard (index.js) 128.44KB 32.96KB
plugin-designer (index.js) 212.30KB 42.80KB
plugin-detail (index.js) 242.34KB 60.99KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 125.63KB 30.64KB
plugin-gantt (index.js) 164.15KB 39.88KB
plugin-grid (index.js) 200.79KB 54.26KB
plugin-kanban (index.js) 52.93KB 14.60KB
plugin-list (index.js) 111.80KB 27.20KB
plugin-map (index.js) 20.06KB 6.62KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 43.49KB 11.93KB
plugin-timeline (index.js) 26.49KB 7.59KB
plugin-tree (index.js) 8.50KB 2.88KB
plugin-view (index.js) 84.61KB 20.74KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.66KB 3.50KB
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) 3.77KB 1.33KB
react (SchemaRenderer.js) 44.39KB 14.99KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 1.33KB 0.69KB
react (schema-input.js) 2.32KB 1.24KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 5.41KB 2.34KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 4.93KB 2.24KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 12.13KB 3.65KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 7.54KB 2.63KB
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 (dashboard-filter-alias.js) 6.23KB 2.74KB
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) 1.87KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (index.js) 3.88KB 1.85KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 2.59KB 1.31KB
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 (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 3.40KB 1.68KB
types (ui-action.js) 3.40KB 1.71KB
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

@os-zhuang
os-zhuang marked this pull request as ready for review August 23, 2026 13:44
@os-zhuang
os-zhuang added this pull request to the merge queue Aug 23, 2026
Merged via the queue into main with commit 199d31b Aug 23, 2026
23 checks passed
@os-zhuang
os-zhuang deleted the claude/issue-5074-gantt-viewmode-declare-wire branch August 23, 2026 13:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants