@object-ui/plugin-gantt 6.2.2 → 7.0.0

package/CHANGELOG.md

@@ -1,5 +1,155 @@
 # @object-ui/plugin-gantt
 
+## 7.0.0
+
+### Minor Changes
+
+- 995c85d: Gantt feature parity, Phases 1–5: dependency links, real time scales, hierarchy, interaction polish, and virtualization.
+
+  - **Dependency links** — `task.dependencies` renders as orthogonal arrows in an SVG overlay, with all four MS-Project link types (`fs`/`ss`/`ff`/`sf`) via the object form `{ id, type }`. Arrows follow bars live during drag/resize; hovering a bar highlights its links. `normalizeDependencies` (exported) accepts CSV strings, id arrays, and object arrays with id/type aliases. New dependencies can be created by dragging from a bar's link dot onto another bar (`onDependencyCreate`).
+  - **Real time scales** — day/week/month/quarter modes with a two-row header (group row + unit row), weekend tinting, zoom in/out, and a jump-to-today button.
+  - **Hierarchy** — `parent` builds a tree: collapsible summary rows with bracket-style summary bars aggregated from descendants, milestone diamonds, indent guides, and `aria-expanded`/`role="treeitem"` semantics. Dragging a summary bar moves its whole subtree by the same offset (live preview + one `onTaskUpdate` per task); the summary's displayed range rolls up from children, so moving a child past the parent's edge stretches the parent automatically.
+  - **Interaction polish** — progress drag handle, hover tooltip, context menu (including delete), keyboard navigation/editing, inline title editing, and row drag-reorder (`onTaskReorder`).
+  - **Scale** — virtualized rows _and_ columns (spacer-based windowing; only the visible window is in the DOM, verified: 5,000 tasks render in ~27 ms with 26 rows in the DOM), a fullscreen toggle, and custom timeline `markers` (`{ date, label?, color? }`).
+
+  Colors that the prebuilt components stylesheet doesn't emit utilities for use theme CSS variables inline, so everything renders correctly in consuming apps.
+
+- 053c948: feat(gantt): year scale, navigation, saved layout, and PDF export (follow-up to #1672)
+
+  - **Year scale** — new `year` granularity (one column per year, with a "20XXs"
+    decade group band above); ResourceWorkload follows the same column width/label.
+  - **Navigation** — toolbar gains _This week_ / _This month_ jump buttons (beside
+    the existing _Today_), scrolling the timeline to the current week/month start.
+  - **Saved layout** — `persistLayoutKey` / `onLayoutChange` plus a "Save layout"
+    button snapshot the current granularity + zoom + collapsed task columns to
+    `localStorage` (`gantt-layout:<object>:<view>`) and restore on next load (an
+    explicit `viewMode` prop still wins). `ObjectGantt` derives the key from the
+    data object by default; `persistLayout: false` opts out.
+  - **PDF export** — rasterizes the whole chart SVG to JPEG embedded in a
+    zero-dependency single-page PDF (DCTDecode), alongside PNG export
+    (`buildExportSvg` shared by both).
+
+- 053c948: feat(gantt): configurable hover tooltip + live parent-stretch (follow-up to #1672)
+
+  - **Configurable tooltip** — a view declares `tooltipFields` on its gantt config
+    (field names, or `{ field, label }` to override the label); `ObjectGantt`
+    resolves each against the record (select options → label, lookups → embedded
+    record name, dates/numbers/currency/percent through the shared `@object-ui/
+fields` formatters) and feeds `GanttView` a `task.fields` array that replaces
+    the default hover detail.
+  - **Live parent-stretch** — a summary bar's displayed range rolls up from its
+    children live, so dragging a child past the parent's edge stretches the parent.
+  - Also replaces six prebuilt-CSS utilities the components stylesheet never emits
+    (connector dot `-right-2` was occluding the progress label, resize-handle
+    width, progress-fill radius, grid z-index, `sm:` variants) with inline styles
+    / a scoped media query so the chart renders correctly in consuming apps.
+
+### Patch Changes
+
+- 0ad72a6: fix: pass full gantt config to renderer, render multi-value lookups in gantt tooltips, persist `bodyExtra` on dataSource actions, and complete zh/en gantt labels
+
+  Four platform gaps that the EHR app previously worked around with `node_modules` patches:
+
+  - **app-shell / ObjectView** — the `config.gantt → renderer props` adapter was a hardcoded 6-field whitelist, so `parentField`/`typeField` (and `baseline*`, `groupByField`, `resourceView`, `tooltipFields`, `quickFilters`, …) never reached the renderer and the chart degraded to a flat list. It now spreads the full `viewDef.gantt` first, then applies the three required defaults last (mirroring the gallery branch).
+  - **plugin-gantt / ObjectGantt** — the tooltip value formatter only handled single-object lookups, so a multi-value lookup (a populated `[{name},{name}]` array) fell through to `'—'`. It now maps each array element to its display value and joins them.
+  - **app-shell / useConsoleActionRuntime** — `bodyExtra` was merged only on the absolute-HTTP path; the generic `dataSource.update` path ignored it, so a pure-confirmation action (no params array) left an empty payload and persisted nothing. `bodyExtra` is now merged last on that path too, matching the documented semantics.
+  - **i18n** — added the gantt labels the 9.x renderer references but the bundles lacked: `toolbar.thisWeek/thisMonth/exportPdf/saveLayout`, `viewMode.year`, `menu.add*/removeDependency/noCandidates`, the `linkType.*` and `conflict.*` blocks, and `readOnly*` — in both `en` (canonical key source) and `zh`.
+
+- bd8b054: fix(currency): resolve the tenant default currency across the long-tail renderers
+
+  Phase 2b of the currency-resolution work (ADR-0053). The cell/field renderers
+  already funnelled through `resolveFieldCurrency` + `useLocalization` (#1856),
+  but the rest of the renderers still hard-coded `USD` or read only one of
+  `currency`/`defaultCurrency`. They now share the same resolution chain — explicit
+  field currency -> `currencyConfig.defaultCurrency` -> legacy `defaultCurrency` ->
+  tenant `localization.currency` -> plain number:
+
+  - `plugin-dashboard` `ObjectMetricWidget` (inferred currency), `ObjectDataTable`
+    (symbol-format fallback).
+  - `plugin-grid` `useColumnSummary` (footer agrees with the cells) and
+    `ObjectGrid` (compact amount + name-inferred currency cells).
+  - `plugin-detail` `DetailView` summary metrics.
+  - `plugin-gantt` `ObjectGantt` currency tooltips.
+  - `components` `element:number` (`format: 'currency'`) — tenant default instead
+    of a baked-in `USD`, and renders with the tenant locale.
+
+  `resolveFieldCurrency` now lives in `@object-ui/i18n` (co-located with
+  `useLocalization`, which supplies the tenant default); `@object-ui/fields`
+  re-exports it, so the existing import path is unchanged. No behavior change when
+  no tenant currency is configured — a field that declares its own currency, or a
+  deployment with no `localization.currency`, renders exactly as before.
+
+- Updated dependencies [5976ba3]
+- Updated dependencies [a00e16d]
+- Updated dependencies [eaccefd]
+- Updated dependencies [f7f325d]
+- Updated dependencies [c12986e]
+- Updated dependencies [71d7ce0]
+- Updated dependencies [053c948]
+- Updated dependencies [89e113c]
+- Updated dependencies [ddbe4a2]
+- Updated dependencies [2d47e94]
+- Updated dependencies [9049bbe]
+- Updated dependencies [77cc6bb]
+- Updated dependencies [6c0c92c]
+- Updated dependencies [97c6831]
+- Updated dependencies [cb2fdb1]
+- Updated dependencies [c3749eb]
+- Updated dependencies [c09f44e]
+- Updated dependencies [6cfa330]
+- Updated dependencies [ad8ade6]
+- Updated dependencies [d54346c]
+- Updated dependencies [5332639]
+- Updated dependencies [3870c20]
+- Updated dependencies [2eb3096]
+- Updated dependencies [b88c560]
+- Updated dependencies [0ad72a6]
+- Updated dependencies [bd398df]
+- Updated dependencies [3fa23a7]
+- Updated dependencies [18d0339]
+- Updated dependencies [66ed3ad]
+- Updated dependencies [c6445b6]
+- Updated dependencies [80c133c]
+- Updated dependencies [5e1b838]
+- Updated dependencies [59b6bbb]
+- Updated dependencies [d16566f]
+- Updated dependencies [90acb7f]
+- Updated dependencies [7913390]
+- Updated dependencies [514f426]
+- Updated dependencies [1394e34]
+- Updated dependencies [e95cc25]
+- Updated dependencies [abe8ebc]
+- Updated dependencies [300d755]
+- Updated dependencies [3cc38fe]
+- Updated dependencies [bd8b054]
+- Updated dependencies [4eb9cb6]
+- Updated dependencies [7c239fd]
+- Updated dependencies [858ad94]
+- Updated dependencies [2270239]
+- Updated dependencies [db8cd00]
+- Updated dependencies [650bd1f]
+- Updated dependencies [2f31406]
+- Updated dependencies [18728c1]
+- Updated dependencies [8d1195d]
+  - @object-ui/core@7.0.0
+  - @object-ui/components@7.0.0
+  - @object-ui/plugin-detail@7.0.0
+  - @object-ui/react@7.0.0
+  - @object-ui/i18n@7.0.0
+  - @object-ui/types@7.0.0
+  - @object-ui/fields@7.0.0
+
+## 6.2.3
+
+### Patch Changes
+
+- @object-ui/types@6.2.3
+- @object-ui/core@6.2.3
+- @object-ui/react@6.2.3
+- @object-ui/components@6.2.3
+- @object-ui/fields@6.2.3
+- @object-ui/plugin-detail@6.2.3
+
 ## 6.2.2
 
 ### Patch Changes

package/README.md

@@ -127,6 +127,7 @@ Display project timeline with tasks:
   viewMode?: 'day' | 'week' | 'month',
   onTaskClick?: (task) => void,
   onTaskUpdate?: (task) => void,
+  readOnly?: boolean,          // disable all editing (drag/resize/inline/delete/link/undo)
   className?: string
 }
 ```
@@ -227,11 +228,20 @@ const schema = {
 
 ## View Modes
 
-The Gantt chart supports different time scales:
+The Gantt chart renders one timeline column per unit of the active scale:
 
-- **day** - Day-by-day view
-- **week** - Week-by-week view
-- **month** - Month-by-month view
+- **day** - one column per day (weekday + weekend shading)
+- **week** - one column per week (starting Monday)
+- **month** - one column per calendar month
+- **quarter** - one column per quarter (Q1–Q4)
+
+A two-row header shows the grouping above the units (months above days/weeks,
+years above months/quarters). The toolbar's segmented control switches scales
+interactively (`onViewChange` notifies you), and the zoom buttons step the
+column width — falling through to the next coarser/finer scale at the bounds.
+Drag snapping follows the active scale: bars snap to days in day view, weeks
+in week view, and whole calendar months/quarters (duration preserved) in the
+coarse views.
 
 ```typescript
 const schema = {
@@ -241,6 +251,79 @@ const schema = {
 };
 ```
 
+## Task Hierarchy, Summaries & Milestones
+
+Give a task a `parent` (or configure `parentField` on the data-source schema)
+to build a tree: child rows indent under their parent with expand/collapse
+chevrons in the task list. Any task with children renders as a **summary**
+bracket spanning its children's combined date range, with progress rolled up
+as the duration-weighted average of its descendants — summaries are read-only,
+their children drive them.
+
+Zero-duration tasks (`end <= start`) — or tasks whose `type` is
+`'milestone'` (via `typeField`: values like `milestone`, `summary`,
+`project`, `group` are recognized) — render as diamond markers. Milestones
+can be dragged to move but not resized; dependency arrows anchor at the
+diamond center.
+
+```typescript
+const tasks = [
+  { id: 'phase1', title: 'Phase 1', start: '…', end: '…', progress: 0 },        // summary (has children)
+  { id: 't1', title: 'Design', parent: 'phase1', start: '…', end: '…', progress: 80 },
+  { id: 't2', title: 'Build', parent: 'phase1', start: '…', end: '…', progress: 20 },
+  { id: 'launch', title: 'Launch', type: 'milestone', start: '2024-07-01', end: '2024-07-01', progress: 0 },
+];
+```
+
+## Interactions
+
+Beyond drag-to-reschedule, the timeline supports:
+
+- **Progress drag** — hover a bar and drag the round grip at the progress
+  boundary; the fill follows live and `onTaskUpdate(task, { progress })`
+  commits on release (snapped to whole percent, clamped 0–100).
+- **Hover tooltip** — bars, milestones and summaries show a tooltip with
+  title, date range, duration and progress.
+- **Context menu** — right-click a bar or list row for View details / Edit
+  inline / Delete (items appear only when the matching callback is wired).
+- **Keyboard navigation** — the chart body is focusable: ↑/↓ move the row
+  selection, Enter opens the task, Delete deletes it, ←/→ collapse/expand
+  summary rows. Rows carry `treeitem` roles with `aria-level`/`aria-selected`.
+- **Drag-to-create dependency** — drag the connector dot on a bar's right
+  edge onto another bar; a dashed rubber band previews the link and
+  `onDependencyCreate(source, target, 'fs')` fires on drop. Through
+  `ObjectGantt` the new predecessor is appended to the record's
+  `dependenciesField`, preserving the field's original shape (CSV or array).
+- **Row drag-to-reorder** — pass `onTaskReorder(task, before)` to enable
+  HTML5 drag reordering in the task list (sibling-scoped; persistence is up
+  to the host, e.g. via a sort field).
+
+## Scale & Performance
+
+Rows and timeline columns are **virtualized**: only what is in (or near) the
+viewport renders, so the chart stays responsive with thousands of tasks and
+multi-year day-scale ranges. No configuration needed — windowing follows the
+scroll position automatically, and dependency arrows keep their absolute
+positions while scrolling.
+
+Two more chrome features ship with it:
+
+- **Fullscreen** — the expand button in the toolbar puts the whole chart into
+  native fullscreen (and back).
+- **Custom markers** — vertical reference lines beyond the Today marker:
+
+```tsx
+<GanttView
+  tasks={tasks}
+  markers={[
+    { date: '2026-07-01', label: 'Code freeze', color: '#ef4444' },
+    { date: '2026-07-15', label: 'Release' }, // defaults to the primary theme color
+  ]}
+/>
+```
+
+Through the schema, pass the same array as `markers` on the gantt node.
+
 ## Task Dependencies
 
 Link tasks to show dependencies:
@@ -273,6 +356,28 @@ const tasks = [
 ];
 ```
 
+Dependencies render as arrows from the predecessor bar to the dependent bar.
+Arrows follow bars live while dragging, and hovering a bar highlights its links.
+
+### Link Types
+
+Each dependency entry is either a predecessor id (`'task-1'`) or an object with
+an explicit link type:
+
+```typescript
+dependencies: [
+  { id: 'task-1', type: 'fs' },  // finish-to-start (default)
+  { id: 'task-2', type: 'ss' },  // start-to-start
+  { id: 'task-3', type: 'ff' },  // finish-to-finish
+  { id: 'task-4', type: 'sf' },  // start-to-finish
+]
+```
+
+When records come from a data source (`dependenciesField`), the field value may
+be a CSV string (`"task1, task2"`), an array of ids, or an array of objects —
+`task`/`target`/`_id` are accepted as id aliases, and long-form type names like
+`"finish_to_start"` / `"end-to-end"` map onto `fs`/`ss`/`ff`/`sf`.
+
 ## Integration with Data Sources
 
 ```typescript

package/dist/GanttView.d.ts

@@ -0,0 +1,217 @@
+import { WorkingCalendar } from './scheduling';
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import * as React from "react";
+/**
+ * Dependency link types, MS-Project style:
+ * - `fs` finish-to-start (default): predecessor must finish before this task starts
+ * - `ss` start-to-start, `ff` finish-to-finish, `sf` start-to-finish
+ */
+export type GanttLinkType = 'fs' | 'ss' | 'ff' | 'sf';
+export interface GanttDependencyObject {
+    id: string | number;
+    type?: GanttLinkType;
+}
+/** A dependency is the PREDECESSOR's task id, optionally with a link type. */
+export type GanttDependency = string | number | GanttDependencyObject;
+/**
+ * Task rendering variant. `summary` is implied for any task that has
+ * children; `milestone` is implied when end <= start (zero duration).
+ */
+export type GanttTaskType = 'task' | 'summary' | 'milestone' | 'group';
+export interface GanttTask {
+    id: string | number;
+    title: string;
+    start: Date;
+    end: Date;
+    progress: number;
+    color?: string;
+    data?: any;
+    dependencies?: GanttDependency[];
+    /** Parent task id — builds the hierarchy. Unknown ids render as roots. */
+    parent?: string | number | null;
+    /**
+     * Node kind. Defaults to a leaf `task` (or `summary` automatically when it has
+     * children). Set `'group'` to render a pure tree header — expandable/collapsible
+     * like a summary but with NO timeline bar (用于 项目/产品 这类纯分组层级，左侧成树、右侧无条).
+     * Its children still render their own bars normally.
+     */
+    type?: GanttTaskType;
+    /**
+     * Per-node lock (仅查看/跳转). When true this row is view-only: its bar can't be
+     * dragged/resized, progress can't be dragged, no dependency can be drawn from
+     * it, and inline-edit / context-menu edit+delete are hidden. Clicking the bar
+     * (onTaskClick — open drawer / jump) still works. Independent of the global
+     * `readOnly`; use to lock individual levels (e.g. 派工单) while others stay
+     * editable. Maps from the view's `lockField` in ObjectGantt.
+     */
+    locked?: boolean;
+    /**
+     * Baseline (planned) start/end. When both are present a thin reference bar is
+     * drawn beneath the live bar so planned-vs-actual drift is visible at a glance.
+     */
+    baselineStart?: Date;
+    baselineEnd?: Date;
+    /**
+     * Extra label/value rows for the hover tooltip (悬浮详情), in display order.
+     * Populated from the view's `tooltipFields` config (resolved + formatted by
+     * ObjectGantt). When present they replace the default date·duration·progress
+     * line in the tooltip.
+     */
+    fields?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/** Timeline granularity — one column per day, week, month, or quarter. */
+export type GanttViewMode = 'day' | 'week' | 'month' | 'quarter' | 'year';
+/**
+ * Nominal days represented by one column at each granularity. Sets the zoom
+ * scale: pxPerDay = columnWidth / NOMINAL_DAYS[mode]. Actual column widths
+ * follow the calendar (a 31-day month is slightly wider than a 30-day one)
+ * so grid lines, bars and the Today marker share one linear ms→px mapping.
+ */
+export declare const NOMINAL_DAYS: Record<GanttViewMode, number>;
+export declare const MS_PER_DAY: number;
+/** Floor a date to the start of its column unit (Monday for weeks). */
+export declare function startOfUnit(date: Date, mode: GanttViewMode): Date;
+/** Add whole column units; month/quarter clamp the day (Jan 31 + 1mo = Feb 28). */
+export declare function addUnits(date: Date, units: number, mode: GanttViewMode): Date;
+/** Custom vertical timeline marker (deadline, sprint boundary, release…). */
+export interface GanttMarker {
+    date: Date | string;
+    label?: string;
+    color?: string;
+}
+export interface GanttViewProps {
+    tasks: GanttTask[];
+    /** Initial timeline granularity (also switchable from the toolbar). */
+    viewMode?: GanttViewMode;
+    startDate?: Date;
+    endDate?: Date;
+    /** Extra vertical marker lines rendered like the Today marker. */
+    markers?: GanttMarker[];
+    onTaskClick?: (task: GanttTask) => void;
+    onTaskUpdate?: (task: GanttTask, changes: Partial<Pick<GanttTask, 'title' | 'start' | 'end' | 'progress'>>) => void;
+    onTaskDelete?: (task: GanttTask) => void;
+    /** Notified when the user switches granularity from the toolbar. */
+    onViewChange?: (view: GanttViewMode) => void;
+    /**
+     * Enables drag-to-link: a connector dot on each bar can be dragged onto
+     * another bar to create a dependency (target depends on source).
+     */
+    onDependencyCreate?: (source: GanttTask, target: GanttTask, type: GanttLinkType) => void;
+    /**
+     * Enables dependency removal: right-clicking a dependency link opens a menu
+     * with "移除依赖" and a type switch. Called with the source/target tasks of the
+     * removed link (target no longer depends on source).
+     */
+    onDependencyDelete?: (source: GanttTask, target: GanttTask) => void;
+    /**
+     * Enables row drag-to-reorder in the task list. Called with the dragged
+     * task and the sibling it was dropped on (insert before it). Only fires
+     * for rows sharing the same parent.
+     */
+    onTaskReorder?: (task: GanttTask, before: GanttTask) => void;
+    className?: string;
+    /** Enable inline editing of task fields */
+    inlineEdit?: boolean;
+    /**
+     * Show the "auto-schedule" toolbar button. Clicking it runs a one-shot
+     * dependency-driven reschedule of the whole project (顺延): every successor is
+     * pushed later until its link constraints hold, preserving durations, and the
+     * resulting date changes are emitted via `onTaskUpdate`. Requires onTaskUpdate.
+     */
+    autoSchedule?: boolean;
+    /**
+     * After a bar drag/resize, validate the move against dependency constraints
+     * (拖拽冲突校验). If the new position would violate a link — the task moved
+     * earlier than a predecessor allows, or its move pushes successors past their
+     * constraints — a confirmation prompts to 自动顺延 (cascade-reschedule the
+     * affected tasks, preserving durations) or keep the overlap. Requires
+     * onTaskUpdate and only fires when links exist. Ignored in readOnly.
+     */
+    rescheduleOnConflict?: boolean;
+    /** Start with the critical-path highlight enabled (toggle stays in the toolbar). */
+    criticalPathDefault?: boolean;
+    /**
+     * Working calendar for duration math. When set, auto-schedule and critical
+     * path count working days only — weekends (`skipWeekends`) and any `holidays`
+     * (ISO `yyyy-mm-dd` UTC keys) are skipped rather than consumed.
+     */
+    workingCalendar?: WorkingCalendar;
+    /** Render planned-vs-actual baseline bars when tasks carry baseline dates. */
+    showBaselines?: boolean;
+    /**
+     * Read-only mode. When true, every write interaction is disabled regardless
+     * of which callbacks are passed: no bar drag / resize / progress handle, no
+     * inline editing, no delete, no dependency-link drag, no row reorder, no
+     * auto-schedule, and the Undo/Redo toolbar buttons are hidden. Clicking a
+     * task (`onTaskClick`) and switching granularity still work — those don't
+     * mutate data. Equivalent to omitting all write callbacks, but explicit and
+     * metadata-drivable.
+     */
+    readOnly?: boolean;
+    /**
+     * Mobile read-only (移动端只读缩略). When true, the chart auto-enters read-only
+     * mode on narrow viewports (< 640px) so touch users get a clean, scrollable
+     * thumbnail of the schedule instead of error-prone drag editing — equivalent
+     * to `readOnly` but scoped to small screens. Wider viewports are unaffected.
+     * Independent of (and OR-combined with) `readOnly`.
+     */
+    mobileReadOnly?: boolean;
+    /**
+     * Dynamic grouping accessor (动态 Group by). When provided, leaf tasks are
+     * bucketed by the returned `key` and rendered beneath one synthesized summary
+     * row per group — the original `parent` hierarchy is replaced by the grouping.
+     * Return `null` to drop a task into the "ungrouped" bucket. Grouping is purely
+     * presentational: the timeline range, critical path and auto-schedule still run
+     * on the real task list, and the synthetic group rows are never draggable.
+     */
+    groupBy?: (task: GanttTask) => {
+        key: string | number;
+        label: string;
+    } | null;
+    /** Label for the bucket collecting tasks whose `groupBy` returns null. */
+    ungroupedLabel?: string;
+    /**
+     * Auto-collapse tree nodes at or below this depth on first render (默认折叠).
+     * Depth is 0-indexed: roots are 0, their children 1, etc. Every node whose
+     * depth is `>= defaultCollapsedDepth` AND which has children is seeded into the
+     * collapsed set once, so its subtree starts hidden. The user can still expand
+     * any of them — this only sets the initial state. Example: a 项目→产品→排产计划→派工单
+     * tree where 排产计划 sits at depth 2 uses `defaultCollapsedDepth={2}` to start
+     * with every 排产计划 (and its 派工单 children) folded. Omit (or pass a depth past
+     * the deepest node) to start fully expanded.
+     */
+    defaultCollapsedDepth?: number;
+    /**
+     * Persist the user's layout tweaks (granularity + column/task-list widths)
+     * to `localStorage` under this key. On mount the saved layout is restored;
+     * the "保存布局" toolbar button writes the current layout. Omit to disable
+     * persistence. The button still appears when `onLayoutChange` is set.
+     */
+    persistLayoutKey?: string;
+    /**
+     * Notified when the user saves the current layout (保存布局). Receives the
+     * snapshot `{ viewMode, columnWidth, taskListCollapsed }`. Use this to persist
+     * layout in your own store instead of (or alongside) `persistLayoutKey`.
+     */
+    onLayoutChange?: (layout: GanttLayout) => void;
+}
+/** Persisted layout snapshot written by the "保存布局" toolbar button. */
+export interface GanttLayout {
+    viewMode: GanttViewMode;
+    /** Effective day-column width in px, or null when auto-fit. */
+    columnWidth: number | null;
+    taskListCollapsed: boolean;
+    /** User-dragged task-list (name column) width in px, or null when auto-sized. */
+    taskListWidth?: number | null;
+}
+export declare function GanttView({ tasks, viewMode: viewModeProp, startDate, endDate, markers, onTaskClick, onTaskUpdate: onTaskUpdateProp, onTaskDelete: onTaskDeleteProp, onViewChange, onDependencyCreate: onDependencyCreateProp, onDependencyDelete: onDependencyDeleteProp, onTaskReorder: onTaskReorderProp, className, inlineEdit: inlineEditProp, autoSchedule: autoScheduleProp, rescheduleOnConflict: rescheduleOnConflictProp, criticalPathDefault, workingCalendar, showBaselines, readOnly, mobileReadOnly, groupBy, ungroupedLabel, defaultCollapsedDepth, persistLayoutKey, onLayoutChange, }: GanttViewProps): React.JSX.Element;
+//# sourceMappingURL=GanttView.d.ts.map

package/dist/GanttView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GanttView.d.ts","sourceRoot":"","sources":["../src/GanttView.tsx"],"names":[],"mappings":"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"}

package/dist/ObjectGantt.d.ts

@@ -0,0 +1,38 @@
+import { default as React } from 'react';
+import { ObjectGridSchema, DataSource } from '@object-ui/types';
+import { GanttDependency, GanttTaskType } from './GanttView';
+/**
+ * One quick-filter dimension (快速筛选维度). Generic by design: the page configures
+ * which record fields become filter dropdowns; the plugin resolves each one's
+ * options from the object schema (select options / lookup reference records) so
+ * no business field names are baked into the (MIT) plugin.
+ */
+export interface QuickFilterDef {
+    /** Record field / dot-path the dimension filters on. */
+    field: string;
+    /** Trigger label (falls back to the schema field label / humanized name). */
+    label?: string;
+    /**
+     * Explicit option override. Highest priority — use for fixed enums that are
+     * not modeled as select options (e.g. 派工类别). Plain strings become
+     * value === label; objects allow a distinct display label.
+     */
+    options?: Array<string | {
+        value: string | number;
+        label?: string;
+    }>;
+}
+/** Map a record's type value onto a GanttTaskType (undefined = infer). */
+export declare function normalizeTaskType(raw: unknown): GanttTaskType | undefined;
+export declare function normalizeDependencies(raw: unknown): GanttDependency[];
+export interface ObjectGanttProps {
+    schema: ObjectGridSchema;
+    dataSource?: DataSource;
+    className?: string;
+    onTaskClick?: (record: any) => void;
+    onRowClick?: (record: any) => void;
+    onEdit?: (record: any) => void;
+    onDelete?: (record: any) => void;
+}
+export declare const ObjectGantt: React.FC<ObjectGanttProps>;
+//# sourceMappingURL=ObjectGantt.d.ts.map

package/dist/ObjectGantt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectGantt.d.ts","sourceRoot":"","sources":["../src/ObjectGantt.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAoD,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AA0B5F,OAAO,EAA6B,KAAK,eAAe,EAAsB,KAAK,aAAa,EAAsB,MAAM,aAAa,CAAC;AAK1I;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAqED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAUzE;AAiBD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,EAAE,CAqBrE;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;CAClC;AAuGD,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAu2BlD,CAAC"}

package/dist/QuickFilterBar.d.ts

@@ -0,0 +1,39 @@
+import { default as React } from 'react';
+export interface QuickFilterOption {
+    /** Stable key compared against a task's resolved field value. */
+    value: string;
+    /** Human-facing label shown in the checkbox list and trigger summary. */
+    label: string;
+}
+export interface QuickFilterField {
+    /** Record field/path this dimension filters on (e.g. "project", "owner.id"). */
+    field: string;
+    /** Display label for the dropdown trigger. */
+    label: string;
+    /** Full option list (already resolved by the owner). */
+    options: QuickFilterOption[];
+}
+export interface QuickFilterLabels {
+    /** "全部" / "All" — the select-all toggle and empty-selection trigger text. */
+    all?: string;
+    /** "清除筛选" / "Clear" — clears every dimension. */
+    clear?: string;
+    /** Builds the "showing N / M" summary; omit to hide the summary. */
+    resultSummary?: (shown: number, total: number) => string;
+    /** Placeholder shown when a dimension resolved zero options. */
+    empty?: string;
+}
+export interface QuickFilterBarProps {
+    filters: QuickFilterField[];
+    /** field → selected option values (absent/empty = no constraint). */
+    value: Record<string, string[]>;
+    onChange: (field: string, values: string[]) => void;
+    onClear: () => void;
+    /** Visible/total task counts for the summary caption (optional). */
+    resultCount?: number;
+    totalCount?: number;
+    labels?: QuickFilterLabels;
+    className?: string;
+}
+export declare const QuickFilterBar: React.FC<QuickFilterBarProps>;
+//# sourceMappingURL=QuickFilterBar.d.ts.map

package/dist/QuickFilterBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuickFilterBar.d.ts","sourceRoot":"","sources":["../src/QuickFilterBar.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AACH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACzD,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACpD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA4MD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+CxD,CAAC"}

package/dist/ResourceWorkload.d.ts

@@ -0,0 +1,37 @@
+import { GanttTask, GanttViewMode } from './GanttView';
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Resource / Workload view (资源/工作负载视图).
+ *
+ * A per-resource load histogram aligned to the same time columns the Gantt grid
+ * uses. Each resource gets a row; each column draws a bar whose height ∝ the
+ * summed effort of that resource's tasks active in that span, painted red once
+ * it exceeds capacity (over-allocation). The aggregation lives in `workload.ts`
+ * (pure + unit-tested); this component is the renderer + timeline geometry.
+ */
+import * as React from 'react';
+export interface ResourceWorkloadProps {
+    tasks: GanttTask[];
+    /** Resource accessor — null routes a task into the "unassigned" row. */
+    assignee: (task: GanttTask) => {
+        key: string | number;
+        label: string;
+    } | null;
+    /** Capacity units a task consumes while active (default 1). */
+    effort?: (task: GanttTask) => number;
+    /** Per-resource capacity ceiling; number or per-key function (default 1). */
+    capacity?: number | ((key: string) => number);
+    /** Time granularity — must match the chart it accompanies. */
+    viewMode?: GanttViewMode;
+    /** Label for the unassigned bucket. */
+    unassignedLabel?: string;
+    className?: string;
+}
+export declare function ResourceWorkload({ tasks, assignee, effort, capacity, viewMode, unassignedLabel, className, }: ResourceWorkloadProps): React.JSX.Element;
+//# sourceMappingURL=ResourceWorkload.d.ts.map

package/dist/ResourceWorkload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceWorkload.d.ts","sourceRoot":"","sources":["../src/ResourceWorkload.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAmD,MAAM,aAAa,CAAC;AAIlH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,wEAAwE;IACxE,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK;QAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9E,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAY,EACZ,QAAgB,EAChB,eAA8B,EAC9B,SAAS,GACV,EAAE,qBAAqB,qBAuIvB"}