construction-gantt 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # construction-gantt
 
+## 0.3.0
+
+### Minor Changes
+
+- ## v0.3 — UX editing layer + construction-vertical extensions
+
+  ### Inline editing (`editMode` prop)
+
+  New `editMode` prop on `<Gantt>` gates interactive editing. When `true`:
+
+  - Click any grid cell (name, start, end, duration, progress, scheduleMode) to edit inline. Enter/Tab commits; Escape cancels; blur commits.
+  - `onTaskEdit(id, patch)` callback fires with only the changed field. Consumer applies via `useEditableProject` or own state.
+  - Summary task date/duration cells are read-only (engine-derived).
+  - `DEFAULT_EDIT_COLUMNS` (name 220px, start 100px, end 100px, duration 60px, progress 50px) used automatically when `editMode=true` and no `columns` prop is supplied.
+
+  ### Live CPM preview while editing
+
+  While a timing field is dirty (not yet committed), the engine runs a debounced (80ms) speculative CPM pass. Downstream tasks that would shift are rendered as blue dashed ghost bars alongside their solid live bars. Preview clears on commit or Escape. `name` / `progress` / `scheduleMode` edits skip the CPM pass (no cascade).
+
+  ### Drag-to-link dependency creation (`onLinkCreate` callback)
+
+  Hover a task bar in `editMode` to reveal a drag handle at the right edge. Drag to a target bar; a dashed SVG line follows the cursor. Drop fires `onLinkCreate(source, target, 'FS')`. Invalid targets (self, summary, duplicate link, phantom rows) are silently rejected.
+
+  ### Link deletion (`onLinkDelete` callback)
+
+  In `editMode`, clicking a rendered dependency arrow fires `onLinkDelete(linkId)`.
+
+  ### Editing command model (`useEditableProject`)
+
+  `useEditableProject(project)` returns `{ enqueue, commit, undo, redo, canUndo, canRedo, draft }` — a command-pattern draft layer with full undo/redo. Ten built-in factory functions: `updateTask`, `createTask`, `deleteTask`, `renameTask`, `setTaskStart`, `setTaskDuration`, `setTaskProgress`, `linkTasks`, `deleteLink`, `updateLink`.
+
+  ### Multi-baseline UI (`baselineIndices` prop)
+
+  `baselineIndices?: ReadonlyArray<BaselineIndex>` overlays multiple baseline snapshots as phantom ghost rows beneath each live task. Each phantom row carries its own variance pill (+Nd/−Nd). Per-baseline colour palette (up to 11 baselines). `baselineIndex` kept as a deprecated single-index alias.
+
+  ### NZ public holidays calendar
+
+  `nzPublicHolidays(year, region)` + `nzDefaultCalendar(options)` — all 13 statutory NZ regions, Matariki dates per Te Kāhui o Matariki Public Holiday Act 2022, Canterbury Show Day from employment.govt.nz year-by-year, pre-seeded 2022–2052.
+
+  ### MSPDI constraint + hierarchy preservation
+
+  `ConstraintDate` round-trips through MSPDI parse/serialize. `OutlineLevel`-based parent derivation from flat MSPDI task lists. `PercentComplete` emission added.
+
+  ### New public API exports
+
+  `TaskEditPatch`, `EditableField` — needed for typing `onTaskEdit` callbacks in consuming apps.
+
+  ### New `GanttProps`
+
+  ```ts
+  editMode?: boolean;
+  onTaskEdit?: (id: TaskId, patch: TaskEditPatch) => void;
+  onLinkCreate?: (source: TaskId, target: TaskId, type: DependencyType) => void;
+  onLinkDelete?: (linkId: LinkId) => void;
+  baselineIndices?: ReadonlyArray<BaselineIndex>;
+  ```
+
+## 0.2.0
+
+### Minor Changes
+
+- b59d1fe: Multi-baseline UI: render multiple captured baselines simultaneously for variation-claim delay analysis under NZS 3910 / AS 4000.
+
+  - New `baselineIndices: ReadonlyArray<BaselineIndex>` prop on `<Gantt>` overlays one phantom ghost row per selected baseline.
+  - Existing `baselineIndex` prop continues to work; deprecated, removed at v1.0.
+  - Each phantom row in multi-baseline mode carries its own variance pill; single-baseline mode keeps the pill on the live bar (existing behaviour).
+  - Per-baseline CSS class `bode-baseline-${N}` for indices 0–10 ships with a default palette; consumers override via higher-specificity rules.
+  - Phantom row label includes `baseline.name` (or `Baseline N` fallback) and formatted `capturedAt`.
+
+  No engine changes (ADR-005 preserved). Render-layer only. Test infrastructure additions: canvas 2D context stub at `vitest.setup.ts` so SVAR mounts under happy-dom.
+
 ## 0.1.0
 
 ### Minor Changes

package/LICENSE.md

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 Rips Cassels
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This software wraps and depends on free SVAR React Gantt (also MIT-licensed). Consumers
+must also accept that license. See https://github.com/svar-widgets/gantt for SVAR's
+terms.