construction-gantt 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,628 @@
+import * as react from 'react';
+import { FC, ReactElement } from 'react';
+
+type TaskId = string | number;
+type LinkId = string | number;
+type ResourceId = string | number;
+type CalendarId = string | number;
+type AssignmentId = string | number;
+type TaskType = 'task' | 'summary' | 'milestone';
+type ScheduleMode = 'auto' | 'manual';
+/**
+ * MS Project's 8 constraint types.
+ *
+ * - ASAP / ALAP: scheduling preferences, no date required.
+ * - MSO / MFO:   hard constraints, pin the date; override predecessor logic.
+ * - SNET / SNLT / FNET / FNLT: soft date bounds.
+ *
+ * Hard constraints can produce negative slack — the contract-trouble
+ * signal we surface rather than silently clip to zero (ADR-003).
+ */
+type ConstraintType = 'ASAP' | 'ALAP' | 'MSO' | 'MFO' | 'SNET' | 'SNLT' | 'FNET' | 'FNLT';
+interface Constraint {
+    type: ConstraintType;
+    /** Required for all types except ASAP and ALAP. */
+    date?: Date;
+}
+interface Task {
+    id: TaskId;
+    text: string;
+    /** Hierarchy parent. Undefined = top-level. */
+    parent?: TaskId;
+    type: TaskType;
+    scheduleMode: ScheduleMode;
+    /**
+     * For summary tasks: are children currently expanded?
+     * Default true (expanded). Toggled by the user via the renderer's
+     * collapse/expand chevron.
+     */
+    open?: boolean;
+    /** Working-time duration in minutes. For milestones this is 0. */
+    duration: number;
+    /**
+     * User-set start / end. For manual-scheduled tasks these are authoritative.
+     * For auto-scheduled tasks the engine recomputes them and writes the
+     * result back. Either way, the engine populates `computed` with the
+     * full forward/backward-pass data.
+     */
+    start: Date;
+    end: Date;
+    /** Percent complete, 0-100. */
+    progress: number;
+    constraint?: Constraint;
+    /** Resource assignments. Order is not meaningful. */
+    resourceIds?: ResourceId[];
+    /**
+     * Calendar override. If unset, the task uses the project default calendar.
+     * If a resource on the task has a calendar, the engine reconciles them
+     * (resource calendar wins for activities depending on that resource).
+     */
+    calendarId?: CalendarId;
+    /** Populated by the scheduling engine. Read-only for user code. */
+    computed?: TaskComputed;
+}
+/**
+ * Forward/backward-pass output. Filled in by `schedule()`.
+ *
+ * `totalSlack` is the contract-trouble signal: when negative, the task is
+ * already late against a downstream constraint and the schedule is
+ * infeasible without intervention. We display this; we don't clip it.
+ */
+interface TaskComputed {
+    earlyStart: Date;
+    earlyFinish: Date;
+    lateStart: Date;
+    lateFinish: Date;
+    /** Working-minutes of total float. Can be negative. */
+    totalSlack: number;
+    /** Working-minutes of free float (slack against the earliest successor). */
+    freeSlack: number;
+    isCritical: boolean;
+}
+/**
+ * Dependency type, matching MS Project notation:
+ * - FS = Finish-to-Start (most common in construction)
+ * - SS = Start-to-Start (concurrent activities sharing a start trigger)
+ * - FF = Finish-to-Finish (concurrent activities sharing a finish gate)
+ * - SF = Start-to-Finish (rare; reverse-direction)
+ */
+type DependencyType = 'FS' | 'SS' | 'FF' | 'SF';
+interface Link {
+    id: LinkId;
+    source: TaskId;
+    target: TaskId;
+    type: DependencyType;
+    /**
+     * Lag in working-minutes. Positive = delay, negative = lead.
+     * Construction example: 3-day cure time on a FS link = lag of 3 working days
+     * converted to minutes via the calendar.
+     */
+    lag: number;
+}
+/** Minutes-from-midnight working interval. e.g. 8am-5pm = {480, 1020}. */
+interface WorkInterval {
+    startMinutes: number;
+    endMinutes: number;
+}
+type DayOfWeek = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * A calendar describes when work happens.
+ *
+ * - `workWeek` is the recurring base: 7 entries, each an array of intervals.
+ *   Empty array = non-working day. Multiple intervals = split shift
+ *   (e.g. 7-12 + 13-15 for concreting with a lunch break).
+ * - `exceptions` override specific dates: holidays, weather days, site
+ *   shutdown periods, or "this Saturday is a working day."
+ * - `baseCalendarId` lets resource/task calendars inherit from a base
+ *   and override only the differences.
+ */
+interface Calendar {
+    id: CalendarId;
+    name: string;
+    workWeek: WorkInterval[][];
+    exceptions: CalendarException[];
+    baseCalendarId?: CalendarId;
+}
+interface CalendarException {
+    date: Date;
+    /** false = non-working day (holiday). true = working with given intervals. */
+    isWorking: boolean;
+    intervals?: WorkInterval[];
+    /** Display name. NZ Anzac Day, Auckland Anniversary, weather day, etc. */
+    name?: string;
+}
+interface Resource {
+    id: ResourceId;
+    name: string;
+    /** Optional per-resource calendar override (plasterer's 4-day week, etc.). */
+    calendarId?: CalendarId;
+}
+/**
+ * Allocates a Resource to a Task. v0.2 first cut carries only the core
+ * triple (taskId + resourceId + units) — enough to round-trip MSPDI
+ * <Assignment> elements without losing the allocation graph.
+ *
+ * Per-day timephased work data + cost tracking + EV fields are MSPDI-side
+ * concerns that we don't yet model internally; they appear in
+ * `droppedFields` on parse rather than entering our model.
+ *
+ * The eventual v0.4 editing-model expansion will likely add `actualWork`,
+ * `plannedWork`, and `progress` fields here, plus a separate
+ * `TimephasedSpread` type for per-day allocations.
+ */
+interface Assignment {
+    id: AssignmentId;
+    taskId: TaskId;
+    resourceId: ResourceId;
+    /**
+     * Allocation share. 1.0 = 100% (fully assigned). 0.5 = part-time. >1.0
+     * is over-allocated (MS Project allows this — the renderer surfaces it
+     * with the OverAllocated flag). Default 1.0 if omitted.
+     */
+    units?: number;
+}
+/** MS Project supports 11 baselines (Baseline 0-10). We match. */
+type BaselineIndex = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+interface Baseline {
+    index: BaselineIndex;
+    /** Display name. "Original contract programme", "Variation 1 reprogramme", etc. */
+    name?: string;
+    capturedAt: Date;
+    /** Snapshot of task dates + durations at capture time. */
+    tasks: Map<TaskId, BaselineTaskSnapshot>;
+}
+interface BaselineTaskSnapshot {
+    start: Date;
+    end: Date;
+    duration: number;
+}
+interface Project {
+    /** Project start anchor. Forward pass starts here. */
+    start: Date;
+    /** Optional finish anchor. If set, backward pass terminates here instead of latest task EarlyFinish. */
+    end?: Date;
+    defaultCalendarId: CalendarId;
+    tasks: Task[];
+    links: Link[];
+    resources: Resource[];
+    calendars: Calendar[];
+    /** Up to 11 entries (Baseline 0-10). */
+    baselines: Baseline[];
+    /** Resource-to-task allocations. Empty array if no resources are allocated. */
+    assignments: Assignment[];
+}
+
+/**
+ * Return the critical-path leaf tasks (summary tasks excluded), ordered
+ * by `earlyStart` ascending. A construction PM reading this list is
+ * looking at "the tasks that, if any of them slip, the contract finish
+ * slips."
+ *
+ * The list mirrors what `task.computed.isCritical` says — i.e., includes
+ * tasks with negative total slack (already-late tasks).
+ */
+declare function getCriticalPath(project: Project): Task[];
+interface ProjectStats {
+    /** Leaf task count (summaries excluded). */
+    totalTasks: number;
+    /** Leaf tasks on the critical path (totalSlack <= 0). */
+    criticalTasks: number;
+    /** Leaf tasks with strictly negative totalSlack (the contract-trouble subset). */
+    lateTasks: number;
+    /** Latest earlyFinish across leaf tasks. Project's natural finish date. */
+    projectFinish?: Date;
+    /** Duration-weighted average progress across leaf tasks. 0 if no tasks. */
+    weightedProgress: number;
+}
+/**
+ * Summary statistics over a scheduled Project. Useful for status
+ * dashboards, programme-health badges in management views, and CI
+ * checks that flag "did the critical path grow this commit?".
+ */
+declare function getProjectStats(project: Project): ProjectStats;
+
+/**
+ * Snapshot the current schedule (task starts, ends, durations) as a baseline
+ * at the given index. Returns a new Project with the baseline added; the
+ * input is not mutated. If a baseline already exists at this index, it is
+ * replaced (matches MS Project "Save Baseline" behavior).
+ */
+declare function captureBaseline(project: Project, index: BaselineIndex, options?: {
+    name?: string;
+    capturedAt?: Date;
+}): Project;
+interface TaskBaselineVariance {
+    /** Working-minute drift in start. Positive = task is later than baseline. */
+    startVariance: number;
+    /** Working-minute drift in finish. Positive = task is later than baseline. */
+    finishVariance: number;
+    /** Change in duration (calendar-minute units of the task model). */
+    durationVariance: number;
+}
+/**
+ * Compute baseline variance for every task in `project`. Returns a Map
+ * keyed by TaskId. Tasks not present in the named baseline are omitted
+ * from the returned map.
+ *
+ * `baselineIndex` selects the baseline on `project.baselines`. If the
+ * project has no baseline at that index, returns an empty Map (caller
+ * decides whether to treat this as a soft error or hard error).
+ *
+ * The calendar used for working-time variance arithmetic is the project
+ * default calendar, looked up by `project.defaultCalendarId`. If that
+ * lookup fails, throw an Error (consistent with `schedule()`'s behavior
+ * on a missing default calendar).
+ */
+declare function getTaskBaselineVarianceAll(project: Project, baselineIndex: BaselineIndex): Map<TaskId, TaskBaselineVariance>;
+/**
+ * Compute working-time variance between a task's current dates and its
+ * snapshot in a baseline. Returns undefined if the task isn't in the
+ * baseline (added after the baseline was captured).
+ */
+declare function getTaskBaselineVariance(task: Task, baseline: Baseline, calendar: Calendar): TaskBaselineVariance | undefined;
+
+/**
+ * The 13 statutory NZ regions with their own anniversary day, plus Northland
+ * which observes Waitangi Day per Holidays Act 2003 (no extra exception
+ * is added for `'northland'` — the region value is accepted, the
+ * national-only set is returned).
+ */
+type NZRegion = 'auckland' | 'canterbury' | 'chatham-islands' | 'hawkes-bay' | 'marlborough' | 'nelson' | 'northland' | 'otago' | 'south-canterbury' | 'southland' | 'taranaki' | 'wellington' | 'westland';
+interface NZDefaultCalendarOptions {
+    /** Year (single) or years (array). 2022 ≤ year ≤ 2052. Duplicates deduplicated. */
+    years: number | number[];
+    /** Optional regional anniversary on top of the 11 national holidays. */
+    region?: NZRegion;
+    /**
+     * Override the default Mon–Fri 8am–5pm working week.
+     * 7 entries, Sunday=0 … Saturday=6.
+     */
+    workWeek?: WorkInterval[][];
+    /** Calendar.id. Default: 'nz-default'. */
+    id?: CalendarId;
+    /** Calendar.name. Default: 'New Zealand Standard'. */
+    name?: string;
+}
+declare function nzPublicHolidays(years: number | number[], region?: NZRegion): CalendarException[];
+declare function nzDefaultCalendar(options: NZDefaultCalendarOptions): Calendar;
+
+/**
+ * The contract every edit command must satisfy. apply must be pure
+ * (no mutation, no I/O) — returns a new Project. inverse(project)
+ * captures the state needed to reverse the edit when applied to the
+ * post-edit Project.
+ *
+ * Per ADR-006: every edit flows through schedule() recompute at the
+ * hook layer, not inside apply(). Commands operate on raw data only.
+ */
+interface EditCommand {
+    /** Discriminator for command kind. */
+    readonly kind: string;
+    /** Human-readable label for UI undo text (e.g. "Rename Foundation pour"). */
+    readonly label: string;
+    /** Pure: applies the edit to a Project, returning a new Project. Throws EditError on invalid input. */
+    apply(project: Project): Project;
+    /**
+     * Returns an inverse command: applying inverse(P) on apply(P) yields P.
+     *
+     * Pre-edit state capture timing varies by command kind:
+     * - Create*Command: constructor argument is the inverse's only input
+     * - Update*Command, Delete*Command: snapshot pre-state internally during
+     *   apply() (single-use per instance). The `project` argument is
+     *   accepted for interface consistency but ignored.
+     *
+     * Consumers (CompositeCommand, CommandHistory) only need to call apply()
+     * before inverse() and pass the current project to inverse().
+     */
+    inverse(project: Project): EditCommand;
+}
+
+/**
+ * Thrown when an EditCommand's pre-conditions fail (e.g. target task
+ * doesn't exist, FS-link-to-self, malformed patch). Caught at the hook
+ * boundary so consumers see a typed error rather than a generic Error.
+ */
+declare class EditError extends Error {
+    readonly commandKind: string;
+    constructor(message: string, commandKind: string);
+}
+
+/**
+ * Ergonomic factory functions for constructing edit commands with
+ * descriptive labels. Consumers call these instead of `new
+ * UpdateTaskCommand(...)` so undo UI shows "Rename task to 'Foundation'"
+ * rather than the generic "Update task 'a' (text)".
+ */
+declare function renameTask(id: TaskId, text: string): EditCommand;
+declare function setTaskStart(id: TaskId, start: Date): EditCommand;
+declare function setTaskDuration(id: TaskId, minutes: number): EditCommand;
+declare function setTaskProgress(id: TaskId, percent: number): EditCommand;
+declare function updateTask(id: TaskId, patch: Partial<Task>): EditCommand;
+declare function createTask(task: Task, _parent?: TaskId, _insertAfter?: TaskId): EditCommand;
+declare function deleteTask(id: TaskId): EditCommand;
+/**
+ * Creates a CreateLinkCommand with a **deterministic** link id derived
+ * from `${source}->${target}`. This means calling `linkTasks('a', 'b')`
+ * twice produces the same id — and the second `apply()` will throw
+ * `EditError: duplicate link id`. By design: duplicate enqueues are a
+ * consumer bug we surface loudly rather than silently coalesce.
+ *
+ * Consumers who legitimately need to re-add a previously-deleted link
+ * (e.g. delete A→B, then re-create it without bringing the deleted one
+ * back via undo) should use `new CreateLinkCommand({ id: customId, … })`
+ * directly with a fresh id.
+ */
+declare function linkTasks(source: TaskId, target: TaskId, type?: DependencyType, lag?: number): EditCommand;
+declare function updateLink(id: LinkId, patch: Partial<Link>): EditCommand;
+declare function deleteLink(id: LinkId): EditCommand;
+
+/**
+ * Consumer-facing return shape. The renderer reads `project`
+ * unconditionally — it's always the scheduled, effective state.
+ */
+interface EditableProject {
+    readonly project: Project;
+    readonly isDirty: boolean;
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    enqueue(command: EditCommand): void;
+    commit(label?: string): void;
+    cancel(): void;
+    undo(): void;
+    redo(): void;
+}
+/**
+ * The single hook entry point for v0.4 editing. Captures `initial` once
+ * on first mount (subsequent renders with a different `initial` are
+ * ignored — consumers reset by remounting via `key={projectId}`).
+ *
+ * Every effective state change is run through `schedule()` so the
+ * returned `project` always has fresh CPM data. Per ADR-005 (engine-first).
+ */
+declare function useEditableProject(initial: Project): EditableProject;
+
+interface PngExportOptions {
+    /** Background colour for the captured canvas. Defaults to '#ffffff'. */
+    backgroundColor?: string;
+    /** Pixel ratio. Defaults to window.devicePixelRatio || 2. */
+    pixelRatio?: number;
+}
+interface PdfExportOptions {
+    /** Page orientation. Defaults to 'landscape' (Gantt charts are wide). */
+    orientation?: 'landscape' | 'portrait';
+    /** Page size. Defaults to 'a3'. */
+    format?: 'a4' | 'a3' | 'letter';
+    /** Margin in mm. Defaults to 10. */
+    margin?: number;
+    /** Background colour for the underlying PNG. Defaults to '#ffffff'. */
+    backgroundColor?: string;
+}
+interface XlsxColumn {
+    header: string;
+    /** A key on Task, or a function returning the cell value. */
+    value: keyof Task | ((task: Task) => string | number | Date | undefined);
+}
+interface XlsxExportOptions {
+    /** Sheet name. Defaults to 'Programme'. */
+    sheetName?: string;
+    /** Override the default column set. */
+    columns?: XlsxColumn[];
+}
+interface GanttHandle {
+    exportPNG(options?: PngExportOptions): Promise<Blob>;
+    exportPDF(options?: PdfExportOptions): Promise<Blob>;
+    exportXLSX(options?: XlsxExportOptions): Promise<Blob>;
+}
+
+interface GanttMarker {
+    start: Date;
+    text?: string;
+    /**
+     * Visual style. 'today' renders as a red line; 'milestone' as blue;
+     * 'custom' lets you supply a `css` class name yourself.
+     */
+    variant?: 'today' | 'milestone' | 'custom';
+    /** CSS class name when `variant: 'custom'`. */
+    css?: string;
+}
+/**
+ * Defines a column in the left-hand grid of the Gantt chart.
+ * Construction-PM-facing: these are the columns site PMs expect alongside
+ * the task name (WBS code, trade package, assigned subcontractor, etc.).
+ *
+ * This is a SVAR-agnostic type — internal conversion to SVAR's IColumnConfig
+ * happens inside the <Gantt> wrapper.
+ */
+interface GanttColumn<TTask = Task> {
+    /** Identifier; used as SVAR column id. */
+    id: string;
+    /** Header label rendered in the column header row. */
+    header: string;
+    /**
+     * The field on the task to pluck for the default cell render.
+     * Optional — if `render` is provided, this is ignored.
+     */
+    field?: keyof TTask;
+    /** Column width in pixels. Defaults to SVAR's default if unset. */
+    width?: number;
+    /** Text alignment for the cell. */
+    align?: 'left' | 'center' | 'right';
+    /**
+     * Custom cell render. Receives the live (scheduled) task. Use for any
+     * column more complex than displaying a single field value.
+     */
+    render?: FC<{
+        task: Task;
+    }>;
+}
+interface GanttProps {
+    project: Project;
+    /** Container height. Defaults to 500 (px). */
+    height?: number | string;
+    /** Width of one time-scale cell (per `cellWidth` SVAR prop). Default 48. */
+    cellWidth?: number;
+    /** Height of one row. */
+    cellHeight?: number;
+    /**
+     * Skip running the scheduling engine. Use when the project's tasks
+     * already have `computed` populated by a prior `schedule()` call.
+     */
+    preScheduled?: boolean;
+    /**
+     * Vertical markers (today line + arbitrary milestones).
+     * Default: a today line if the current date falls within the project
+     * window. Pass an empty array to suppress, or your own markers list to
+     * override.
+     */
+    markers?: GanttMarker[];
+    /**
+     * Show variance against this baseline index. If unset (or no matching
+     * baseline exists on `project.baselines`), bars render without variance
+     * pills. Construction-vertical use case (ADR-003): comparing the live
+     * programme against the original contract programme captured under
+     * NZS 3910 / AS 4000.
+     */
+    baselineIndex?: BaselineIndex;
+    /**
+     * Render the baseline as a separate "ghost" bar beneath each live task.
+     * Matches the MS Project baseline-view idiom construction PMs expect
+     * when reviewing variation claims. Default true when `baselineIndex`
+     * is set; pass `false` to keep variance shown only as in-bar pills.
+     */
+    showBaselineBars?: boolean;
+    /**
+     * Grid columns displayed alongside the Gantt bars.
+     *
+     * - `undefined` (default): SVAR renders its built-in columns (task name +
+     *   duration + start + end).
+     * - `[]` (empty array): hides the grid entirely (passes `columns={false}`
+     *   to SVAR).
+     * - `GanttColumn[]`: replaces SVAR's default columns with the supplied set.
+     *
+     * Construction-PM-facing columns live here: WBS code, trade package,
+     * assigned subcontractor, and similar project-specific fields.
+     */
+    columns?: GanttColumn[];
+    /**
+     * Render-only visibility filter. When set, only tasks whose `id` is in
+     * the set are rendered. **CPM still runs on the full task set** — hidden
+     * predecessors continue to drive their visible successors' computed
+     * fields. The visibility filter is a render-only concern (ADR-005).
+     *
+     * - `undefined` (default): no filter; render everything.
+     * - empty set: render nothing.
+     * - set containing ids not present in `project.tasks`: those ids are
+     *   ignored; only matching tasks render.
+     *
+     * Lifts the "filter-while-keeping-CPM-correct" domain rule that
+     * consumer apps would otherwise have to write themselves. See
+     * `visibility.ts` for the contract test.
+     */
+    visibleTaskIds?: ReadonlySet<TaskId>;
+}
+declare const Gantt: react.ForwardRefExoticComponent<GanttProps & react.RefAttributes<GanttHandle>>;
+
+/**
+ * Result of parsing an MSPDI XML document.
+ *
+ * `project` is our internal SVAR-agnostic Project shape.
+ * `droppedFields` enumerates MSPDI fields we encountered but did not map,
+ * for consumer transparency. Each entry: the JSON-path-like location, the
+ * raw value, and a short reason (`'unsupported-element'`, `'unsupported-attribute'`,
+ * `'lossy-on-roundtrip'`).
+ */
+interface MspdiParseResult {
+    project: Project;
+    droppedFields: DroppedField[];
+}
+interface DroppedField {
+    /** Dotted path to the location in the MSPDI document, e.g. `Project.Tasks.Task[2].Notes`. */
+    path: string;
+    /** The raw value we saw and chose not to map. Stringified for diagnostic only. */
+    value: string;
+    /** Why it wasn't carried into the internal Project. */
+    reason: 'unsupported-element' | 'unsupported-attribute' | 'lossy-on-roundtrip';
+}
+/**
+ * Options accepted by `serializeMspdi`.
+ */
+interface MspdiSerializeOptions {
+    /**
+     * Override the root project metadata. Defaults match MS Project 2016+
+     * defaults where applicable. Optional fields not set here are omitted
+     * from the output.
+     */
+    meta?: {
+        /** `<Name>` — defaults to 'Untitled'. */
+        name?: string;
+        /** `<Author>` — defaults to omitted. */
+        author?: string;
+        /** `<Title>` — defaults to the same as `name`. */
+        title?: string;
+    };
+}
+
+declare function parseMspdi(xml: string): MspdiParseResult;
+
+declare function serializeMspdi(project: Project, options?: MspdiSerializeOptions): string;
+
+declare function SpikeGantt(): ReactElement;
+
+declare function schedule(project: Project): Project;
+
+/**
+ * Order tasks so that every predecessor appears before its successors.
+ *
+ * Operates on link-based ordering only (all dependency types FS/SS/FF/SF
+ * establish "source must be visited before target" for scheduling-pass
+ * purposes). Hierarchy (parent/summary) is not considered here — summary
+ * task dates are derived from children after the forward/backward pass.
+ *
+ * Throws if the link graph contains a cycle.
+ */
+declare function topologicalSort(tasks: Task[], links: Link[]): Task[];
+
+declare function isWorkingDay(date: Date, calendar: Calendar): boolean;
+declare function getDayWorkingMinutes(date: Date, calendar: Calendar): number;
+/**
+ * Add `minutes` of working time to `start`, skipping non-working time
+ * (weekends, holidays, partial-day shift gaps). The result is the wall-clock
+ * Date exactly `minutes` working-time-minutes after `start`.
+ *
+ * If `start` falls in a non-working moment (weekend, after-hours, lunch
+ * break), the working-time clock begins from the next working interval.
+ *
+ * Note: not DST-aware. Working hours are wall-clock; cross-DST scheduling
+ * is approximate. Real DST handling is a future enhancement.
+ */
+declare function addWorkingMinutes(start: Date, minutes: number, calendar: Calendar): Date;
+/**
+ * Subtract `minutes` of working time from `end`, walking backward through
+ * working intervals. Backward-pass mirror of {@link addWorkingMinutes}.
+ *
+ * If `end` falls in a non-working moment, the clock begins from the end of
+ * the most recent working interval.
+ */
+declare function subtractWorkingMinutes(end: Date, minutes: number, calendar: Calendar): Date;
+/**
+ * Return the next working moment at or after `date`. If `date` already falls
+ * inside a working interval, returns it unchanged. If it falls in non-working
+ * time (weekend, after-hours, lunch break, holiday), returns the start of the
+ * next working interval.
+ */
+declare function snapToNextWorkingMoment(date: Date, calendar: Calendar): Date;
+/**
+ * Return the previous working moment at or before `date`. Mirror of
+ * {@link snapToNextWorkingMoment} for backward-pass scheduling.
+ */
+declare function snapToPreviousWorkingMoment(date: Date, calendar: Calendar): Date;
+/**
+ * Working-minute distance from `a` to `b`. Positive if `a` is earlier than
+ * `b`, negative if `a` is later. Used to compute slack (lateStart - earlyStart
+ * in working time).
+ */
+declare function workingMinutesBetween(a: Date, b: Date, calendar: Calendar): number;
+
+export { EditError, Gantt, SpikeGantt, addWorkingMinutes, captureBaseline, createTask, deleteLink, deleteTask, getCriticalPath, getDayWorkingMinutes, getProjectStats, getTaskBaselineVariance, getTaskBaselineVarianceAll, isWorkingDay, linkTasks, nzDefaultCalendar, nzPublicHolidays, parseMspdi, renameTask, schedule, serializeMspdi, setTaskDuration, setTaskProgress, setTaskStart, snapToNextWorkingMoment, snapToPreviousWorkingMoment, subtractWorkingMinutes, topologicalSort, updateLink, updateTask, useEditableProject, workingMinutesBetween };
+export type { Assignment, AssignmentId, Baseline, BaselineIndex, BaselineTaskSnapshot, Calendar, CalendarException, CalendarId, Constraint, ConstraintType, DayOfWeek, DependencyType, DroppedField, EditCommand, EditableProject, GanttColumn, GanttHandle, GanttMarker, GanttProps, Link, LinkId, MspdiParseResult, MspdiSerializeOptions, NZDefaultCalendarOptions, NZRegion, PdfExportOptions, PngExportOptions, Project, ProjectStats, Resource, ResourceId, ScheduleMode, Task, TaskBaselineVariance, TaskComputed, TaskId, TaskType, WorkInterval, XlsxColumn, XlsxExportOptions };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sources":["../src/types.ts","../src/analysis.ts","../src/baseline.ts","../src/calendars/nz-holidays.ts","../src/editing/commands.ts","../src/editing/errors.ts","../src/editing/factories.ts","../src/editing/use-editable-project.ts","../src/export/types.ts","../src/Gantt.tsx","../src/mspdi/types.ts","../src/mspdi/parse.ts","../src/mspdi/serialize.ts","../src/SpikeGantt.tsx","../src/schedule.ts","../src/topological-sort.ts","../src/working-time.ts"],"mappings":";;;AAAA,KAAK,MAAM;AACX,KAAK,MAAM;AACX,KAAK,UAAU;AACf,KAAK,UAAU;AACf,KAAK,YAAY;AACjB,KAAK,QAAQ;AACb,KAAK,YAAY;AACjB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,cAAc;AACnB,UAAU,UAAU;AACpB,UAAU,cAAc;AACxB;AACA,WAAW,IAAI;AACf;AACA,UAAU,IAAI;AACd,QAAQ,MAAM;AACd;AACA;AACA,aAAa,MAAM;AACnB,UAAU,QAAQ;AAClB,kBAAkB,YAAY;AAC9B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,WAAW,IAAI;AACf,SAAS,IAAI;AACb;AACA;AACA,iBAAiB,UAAU;AAC3B;AACA,kBAAkB,UAAU;AAC5B;AACA;AACA;AACA;AACA;AACA,iBAAiB,UAAU;AAC3B;AACA,eAAe,YAAY;AAC3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAU,YAAY;AACtB,gBAAgB,IAAI;AACpB,iBAAiB,IAAI;AACrB,eAAe,IAAI;AACnB,gBAAgB,IAAI;AACpB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,cAAc;AACnB,UAAU,IAAI;AACd,QAAQ,MAAM;AACd,YAAY,MAAM;AAClB,YAAY,MAAM;AAClB,UAAU,cAAc;AACxB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAU,YAAY;AACtB;AACA;AACA;AACA,KAAK,SAAS;AACd;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAU,QAAQ;AAClB,QAAQ,UAAU;AAClB;AACA,cAAc,YAAY;AAC1B,gBAAgB,iBAAiB;AACjC,qBAAqB,UAAU;AAC/B;AACA,UAAU,iBAAiB;AAC3B,UAAU,IAAI;AACd;AACA;AACA,gBAAgB,YAAY;AAC5B;AACA;AACA;AACA,UAAU,QAAQ;AAClB,QAAQ,UAAU;AAClB;AACA;AACA,iBAAiB,UAAU;AAC3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAU,UAAU;AACpB,QAAQ,YAAY;AACpB,YAAY,MAAM;AAClB,gBAAgB,UAAU;AAC1B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB,UAAU,QAAQ;AAClB,WAAW,aAAa;AACxB;AACA;AACA,gBAAgB,IAAI;AACpB;AACA,WAAW,GAAG,CAAC,MAAM,EAAE,oBAAoB;AAC3C;AACA,UAAU,oBAAoB;AAC9B,WAAW,IAAI;AACf,SAAS,IAAI;AACb;AACA;AACA,UAAU,OAAO;AACjB;AACA,WAAW,IAAI;AACf;AACA,UAAU,IAAI;AACd,uBAAuB,UAAU;AACjC,WAAW,IAAI;AACf,WAAW,IAAI;AACf,eAAe,QAAQ;AACvB,eAAe,QAAQ;AACvB;AACA,eAAe,QAAQ;AACvB;AACA,iBAAiB,UAAU;AAC3B;;AC5LA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,eAAe,UAAU,OAAO,GAAG,IAAI;AACxD,UAAU,YAAY;AACtB;AACA;AACA;AACA;AACA;AACA;AACA;AACA,oBAAoB,IAAI;AACxB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,eAAe,UAAU,OAAO,GAAG,YAAY;;AC3BhE;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,eAAe,UAAU,OAAO,SAAS,aAAa;AACvE;AACA,iBAAiB,IAAI;AACrB,IAAI,OAAO;AACX,UAAU,oBAAoB;AAC9B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,0BAA0B,UAAU,OAAO,iBAAiB,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB;AAC7H;AACA;AACA;AACA;AACA;AACA,iBAAiB,uBAAuB,OAAO,IAAI,YAAY,QAAQ,YAAY,QAAQ,GAAG,oBAAoB;;ACtClH;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,QAAQ;AACb,UAAU,wBAAwB;AAClC;AACA;AACA;AACA,aAAa,QAAQ;AACrB;AACA;AACA;AACA;AACA,eAAe,YAAY;AAC3B;AACA,SAAS,UAAU;AACnB;AACA;AACA;AACA,iBAAiB,gBAAgB,oCAAoC,QAAQ,GAAG,iBAAiB;AACjG,iBAAiB,iBAAiB,UAAU,wBAAwB,GAAG,QAAQ;;ACvB/E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAU,WAAW;AACrB;AACA;AACA;AACA;AACA;AACA,mBAAmB,OAAO,GAAG,OAAO;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,qBAAqB,OAAO,GAAG,WAAW;AAC1C;;AC9BA;AACA;AACA;AACA;AACA;AACA,cAAc,SAAS,SAAS,KAAK;AACrC;AACA;AACA;;ACNA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,UAAU,KAAK,MAAM,iBAAiB,WAAW;AAClE,iBAAiB,YAAY,KAAK,MAAM,SAAS,IAAI,GAAG,WAAW;AACnE,iBAAiB,eAAe,KAAK,MAAM,oBAAoB,WAAW;AAC1E,iBAAiB,eAAe,KAAK,MAAM,oBAAoB,WAAW;AAC1E,iBAAiB,UAAU,KAAK,MAAM,SAAS,OAAO,CAAC,IAAI,IAAI,WAAW;AAC1E,iBAAiB,UAAU,OAAO,IAAI,YAAY,MAAM,iBAAiB,MAAM,GAAG,WAAW;AAC7F,iBAAiB,UAAU,KAAK,MAAM,GAAG,WAAW;AACpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,SAAS,SAAS,MAAM,UAAU,MAAM,SAAS,cAAc,iBAAiB,WAAW;AAC5G,iBAAiB,UAAU,KAAK,MAAM,SAAS,OAAO,CAAC,IAAI,IAAI,WAAW;AAC1E,iBAAiB,UAAU,KAAK,MAAM,GAAG,WAAW;;AC3BpD;AACA;AACA;AACA;AACA,UAAU,eAAe;AACzB,sBAAsB,OAAO;AAC7B;AACA;AACA;AACA,qBAAqB,WAAW;AAChC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,kBAAkB,UAAU,OAAO,GAAG,eAAe;;ACxBtE,UAAU,gBAAgB;AAC1B;AACA;AACA;AACA;AACA;AACA,UAAU,gBAAgB;AAC1B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAU,UAAU;AACpB;AACA;AACA,iBAAiB,IAAI,WAAW,IAAI,uBAAuB,IAAI;AAC/D;AACA,UAAU,iBAAiB;AAC3B;AACA;AACA;AACA,cAAc,UAAU;AACxB;AACA,UAAU,WAAW;AACrB,wBAAwB,gBAAgB,GAAG,OAAO,CAAC,IAAI;AACvD,wBAAwB,gBAAgB,GAAG,OAAO,CAAC,IAAI;AACvD,yBAAyB,iBAAiB,GAAG,OAAO,CAAC,IAAI;AACzD;;AC1BA,UAAU,WAAW;AACrB,WAAW,IAAI;AACf;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAU,WAAW,SAAS,IAAI;AAClC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,aAAa,EAAE;AACf,cAAc,IAAI;AAClB;AACA;AACA,UAAU,UAAU;AACpB,aAAa,OAAO;AACpB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,WAAW;AACzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA,oBAAoB,aAAa;AACjC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,WAAW;AACzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,qBAAqB,WAAW,CAAC,MAAM;AACvC;AACA,cAAc,KAAK,EAAE,KAAK,CAAC,yBAAyB,CAAC,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW;;AC/GjG;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAU,gBAAgB;AAC1B,aAAa,OAAO;AACpB,mBAAmB,YAAY;AAC/B;AACA,UAAU,YAAY;AACtB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAU,qBAAqB;AAC/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;ACrCA,iBAAiB,UAAU,eAAe,gBAAgB;;ACA1D,iBAAiB,cAAc,UAAU,OAAO,YAAY,qBAAqB;;ACAjF,iBAAiB,UAAU,IAAI,YAAY;;ACD3C,iBAAiB,QAAQ,UAAU,OAAO,GAAG,OAAO;;ACApD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,eAAe,QAAQ,IAAI,WAAW,IAAI,KAAK,IAAI;;ACVpE,iBAAiB,YAAY,OAAO,IAAI,YAAY,QAAQ;AAC5D,iBAAiB,oBAAoB,OAAO,IAAI,YAAY,QAAQ;AACpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,iBAAiB,QAAQ,IAAI,6BAA6B,QAAQ,GAAG,IAAI;AAC1F;AACA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,sBAAsB,MAAM,IAAI,6BAA6B,QAAQ,GAAG,IAAI;AAC7F;AACA;AACA;AACA;AACA;AACA;AACA,iBAAiB,uBAAuB,OAAO,IAAI,YAAY,QAAQ,GAAG,IAAI;AAC9E;AACA;AACA;AACA;AACA,iBAAiB,2BAA2B,OAAO,IAAI,YAAY,QAAQ,GAAG,IAAI;AAClF;AACA;AACA;AACA;AACA;AACA,iBAAiB,qBAAqB,IAAI,IAAI,KAAK,IAAI,YAAY,QAAQ;;;;","names":[]}