@art-tools/react-gantt 0.2.1 → 0.3.0

package/dist/index.d.cts

@@ -371,6 +371,8 @@ export declare interface DependencyLinkOwnerState {
     link: DependencyLink;
     /** Whether this link is currently selected. */
     isSelected: boolean;
+    /** Whether this link is the binding edge of the critical path (ADR-023). */
+    isCritical: boolean;
 }
 
 /** State passed to the function form of the `layer` slotProps. */
@@ -458,7 +460,7 @@ export declare type DurationUnit = "day" | "hour" | "minute";
  */
 export declare function endInstantFromDisplayDate(displayEnd: Date): Date;
 
-export declare function Gantt({ tasks, dependencies, rowHeight, colWidth, height, scales, padDays, zoomLevels, defaultZoomIndex, onZoomChange, zoomWheel, zoomKeyboard, onTaskClick, columns: columnsProp, defaultTaskListWidth, onDependencyCreate, onDependencyDelete, onTaskCreate, onTaskDelete, onTaskEdit, onTasksChange, calendar, snapToWorking, durationUnit, readOnly, apiRef, hideTaskList, taskList, bars, dependencySlots, timeline, labels, }: GanttProps): JSX.Element;
+export declare function Gantt({ tasks, dependencies, rowHeight, colWidth, height, scales, padDays, zoomLevels, defaultZoomIndex, onZoomChange, zoomWheel, zoomKeyboard, onTaskClick, columns: columnsProp, defaultTaskListWidth, onDependencyCreate, onDependencyDelete, onTaskCreate, onTaskDelete, onTaskEdit, onTasksChange, calendar, snapToWorking, durationUnit, readOnly, criticalPath, apiRef, hideTaskList, taskList, bars, dependencySlots, timeline, labels, }: GanttProps): JSX.Element;
 
 /** Slots for the timeline bars and their handles. Delivered via context. */
 export declare interface GanttBarsSlots {
@@ -593,6 +595,13 @@ export declare interface GanttEngineProps {
      * ADR-021). Custom `columns` are yours to gate; read `api.readOnly` in `render`.
      */
     readOnly?: boolean;
+    /**
+     * Highlight the critical path — the chain of tasks and dependency links that
+     * currently have zero working-time float before the chart's actual end date
+     * would move. Off by default; charts that do not set it render byte-identically
+     * to today (ADR-023).
+     */
+    criticalPath?: boolean;
     /** Receives the imperative API: `apiRef.current.createTask(...)`, `.undo()`, etc. */
     apiRef?: default_2.Ref<GanttHandle>;
     /**
@@ -698,7 +707,7 @@ export declare interface GanttProps extends GanttEngineProps {
 
 /**
  * The composition root: owns every piece of chart state and publishes it through
- * the twelve contexts defined in `contexts.ts`.
+ * the fourteen contexts defined in `contexts.ts`.
  *
  * The provider nesting at the bottom is ordered stable-outermost, hottest-inside,
  * mirroring the cadence table in `contexts.ts`. That order is not load-bearing
@@ -707,7 +716,7 @@ export declare interface GanttProps extends GanttEngineProps {
  * *becomes* load-bearing the moment a layer starts reading another context. Keep
  * it.
  */
-export declare function GanttProvider({ tasks, rowHeight, colWidth, height, scales, padDays, zoomLevels, defaultZoomIndex, onZoomChange, zoomWheel, zoomKeyboard, dependencies, onTaskClick, onDependencyCreate, onDependencyDelete, onTaskCreate: onTaskCreateProp, onTaskDelete, onTaskEdit, onTasksChange, apiRef, labels, calendar, snapToWorking, durationUnit, readOnly, children, }: GanttProviderProps): JSX.Element;
+export declare function GanttProvider({ tasks, rowHeight, colWidth, height, scales, padDays, zoomLevels, defaultZoomIndex, onZoomChange, zoomWheel, zoomKeyboard, dependencies, onTaskClick, onDependencyCreate, onDependencyDelete, onTaskCreate: onTaskCreateProp, onTaskDelete, onTaskEdit, onTasksChange, apiRef, labels, calendar, snapToWorking, durationUnit, readOnly, criticalPath: highlightCriticalPath, children, }: GanttProviderProps): JSX.Element;
 
 /** Props of the composable `<GanttProvider>`: the engine plus its subtree. */
 export declare interface GanttProviderProps extends GanttEngineProps {
@@ -867,11 +876,13 @@ export declare function mergeSlotProps<Props extends {
     style?: CSSProperties;
 }, OwnerState>(internalProps: Props, slotProps: SlotPropsInput<Props, OwnerState> | undefined, ownerState: OwnerState): Props;
 
-export declare function MilestoneBar({ size, centerLeft, top, colWidth, title, a11y, onMove, onMoveEnd, tooltip, slots: slotsProp, slotProps: slotPropsProp, }: MilestoneBarProps): JSX.Element;
+export declare function MilestoneBar({ size, centerLeft, top, colWidth, title, a11y, onMove, onMoveEnd, tooltip, isCritical, slots: slotsProp, slotProps: slotPropsProp, }: MilestoneBarProps): JSX.Element;
 
 export declare interface MilestoneBarOwnerState {
     size: number;
     title: string;
+    /** Whether this bar is on the critical path (ADR-023). */
+    isCritical: boolean;
 }
 
 declare interface MilestoneBarProps {
@@ -889,6 +900,8 @@ declare interface MilestoneBarProps {
      * verbatim; a replaced `slots.root` that ignores it simply shows no tooltip.
      */
     tooltip?: BarTooltipOwnerState;
+    /** Whether this bar is on the critical path (ADR-023). Defaults to `false`. */
+    isCritical?: boolean;
     slots?: MilestoneBarSlots;
     slotProps?: MilestoneBarSlotProps;
 }
@@ -915,7 +928,7 @@ export declare interface Point {
     y: number;
 }
 
-export declare function ProjectBar({ width, height, left, top, colWidth, title, a11y, progress, onProgressChange, onProgressEnd, onMove, onMoveEnd, tooltip, slots: slotsProp, slotProps: slotPropsProp, }: ProjectBarProps): JSX.Element;
+export declare function ProjectBar({ width, height, left, top, colWidth, title, a11y, progress, onProgressChange, onProgressEnd, onMove, onMoveEnd, tooltip, isCritical, slots: slotsProp, slotProps: slotPropsProp, }: ProjectBarProps): JSX.Element;
 
 /** State passed to the function form of each ProjectBar slotProps. */
 export declare interface ProjectBarOwnerState {
@@ -923,6 +936,8 @@ export declare interface ProjectBarOwnerState {
     height: number;
     progress: number;
     title: string;
+    /** Whether this bar is on the critical path (ADR-023). */
+    isCritical: boolean;
 }
 
 declare interface ProjectBarProps {
@@ -944,6 +959,8 @@ declare interface ProjectBarProps {
      * verbatim; a replaced `slots.root` that ignores it simply shows no tooltip.
      */
     tooltip?: BarTooltipOwnerState;
+    /** Whether this bar is on the critical path (ADR-023). Defaults to `false`. */
+    isCritical?: boolean;
     slots?: ProjectBarSlots;
     slotProps?: ProjectBarSlotProps;
 }
@@ -1004,7 +1021,7 @@ export declare interface SlotConfig<Slots, SlotProps> {
  */
 export declare type SlotPropsInput<P, OwnerState> = Partial<P> | ((ownerState: OwnerState) => Partial<P>);
 
-export declare function TaskBar({ width, height, left, top, colWidth, title, a11y, progress, onProgressChange, onProgressEnd, onResize, onResizeEnd, onMove, onMoveEnd, tooltip, slots: slotsProp, slotProps: slotPropsProp, }: TaskBarProps): JSX.Element;
+export declare function TaskBar({ width, height, left, top, colWidth, title, a11y, progress, onProgressChange, onProgressEnd, onResize, onResizeEnd, onMove, onMoveEnd, tooltip, isCritical, slots: slotsProp, slotProps: slotPropsProp, }: TaskBarProps): JSX.Element;
 
 /** State passed to the function form of each TaskBar slotProps. */
 export declare interface TaskBarOwnerState {
@@ -1012,6 +1029,8 @@ export declare interface TaskBarOwnerState {
     height: number;
     progress: number;
     title: string;
+    /** Whether this bar is on the critical path (ADR-023). */
+    isCritical: boolean;
 }
 
 declare interface TaskBarProps {
@@ -1038,6 +1057,8 @@ declare interface TaskBarProps {
      * verbatim; a replaced `slots.root` that ignores it simply shows no tooltip.
      */
     tooltip?: BarTooltipOwnerState;
+    /** Whether this bar is on the critical path (ADR-023). Defaults to `false`. */
+    isCritical?: boolean;
     slots?: TaskBarSlots;
     slotProps?: TaskBarSlotProps;
 }

package/dist/index.d.ts

@@ -371,6 +371,8 @@ export declare interface DependencyLinkOwnerState {
     link: DependencyLink;
     /** Whether this link is currently selected. */
     isSelected: boolean;
+    /** Whether this link is the binding edge of the critical path (ADR-023). */
+    isCritical: boolean;
 }
 
 /** State passed to the function form of the `layer` slotProps. */
@@ -458,7 +460,7 @@ export declare type DurationUnit = "day" | "hour" | "minute";
  */
 export declare function endInstantFromDisplayDate(displayEnd: Date): Date;
 
-export declare function Gantt({ tasks, dependencies, rowHeight, colWidth, height, scales, padDays, zoomLevels, defaultZoomIndex, onZoomChange, zoomWheel, zoomKeyboard, onTaskClick, columns: columnsProp, defaultTaskListWidth, onDependencyCreate, onDependencyDelete, onTaskCreate, onTaskDelete, onTaskEdit, onTasksChange, calendar, snapToWorking, durationUnit, readOnly, apiRef, hideTaskList, taskList, bars, dependencySlots, timeline, labels, }: GanttProps): JSX.Element;
+export declare function Gantt({ tasks, dependencies, rowHeight, colWidth, height, scales, padDays, zoomLevels, defaultZoomIndex, onZoomChange, zoomWheel, zoomKeyboard, onTaskClick, columns: columnsProp, defaultTaskListWidth, onDependencyCreate, onDependencyDelete, onTaskCreate, onTaskDelete, onTaskEdit, onTasksChange, calendar, snapToWorking, durationUnit, readOnly, criticalPath, apiRef, hideTaskList, taskList, bars, dependencySlots, timeline, labels, }: GanttProps): JSX.Element;
 
 /** Slots for the timeline bars and their handles. Delivered via context. */
 export declare interface GanttBarsSlots {
@@ -593,6 +595,13 @@ export declare interface GanttEngineProps {
      * ADR-021). Custom `columns` are yours to gate; read `api.readOnly` in `render`.
      */
     readOnly?: boolean;
+    /**
+     * Highlight the critical path — the chain of tasks and dependency links that
+     * currently have zero working-time float before the chart's actual end date
+     * would move. Off by default; charts that do not set it render byte-identically
+     * to today (ADR-023).
+     */
+    criticalPath?: boolean;
     /** Receives the imperative API: `apiRef.current.createTask(...)`, `.undo()`, etc. */
     apiRef?: default_2.Ref<GanttHandle>;
     /**
@@ -698,7 +707,7 @@ export declare interface GanttProps extends GanttEngineProps {
 
 /**
  * The composition root: owns every piece of chart state and publishes it through
- * the twelve contexts defined in `contexts.ts`.
+ * the fourteen contexts defined in `contexts.ts`.
  *
  * The provider nesting at the bottom is ordered stable-outermost, hottest-inside,
  * mirroring the cadence table in `contexts.ts`. That order is not load-bearing
@@ -707,7 +716,7 @@ export declare interface GanttProps extends GanttEngineProps {
  * *becomes* load-bearing the moment a layer starts reading another context. Keep
  * it.
  */
-export declare function GanttProvider({ tasks, rowHeight, colWidth, height, scales, padDays, zoomLevels, defaultZoomIndex, onZoomChange, zoomWheel, zoomKeyboard, dependencies, onTaskClick, onDependencyCreate, onDependencyDelete, onTaskCreate: onTaskCreateProp, onTaskDelete, onTaskEdit, onTasksChange, apiRef, labels, calendar, snapToWorking, durationUnit, readOnly, children, }: GanttProviderProps): JSX.Element;
+export declare function GanttProvider({ tasks, rowHeight, colWidth, height, scales, padDays, zoomLevels, defaultZoomIndex, onZoomChange, zoomWheel, zoomKeyboard, dependencies, onTaskClick, onDependencyCreate, onDependencyDelete, onTaskCreate: onTaskCreateProp, onTaskDelete, onTaskEdit, onTasksChange, apiRef, labels, calendar, snapToWorking, durationUnit, readOnly, criticalPath: highlightCriticalPath, children, }: GanttProviderProps): JSX.Element;
 
 /** Props of the composable `<GanttProvider>`: the engine plus its subtree. */
 export declare interface GanttProviderProps extends GanttEngineProps {
@@ -867,11 +876,13 @@ export declare function mergeSlotProps<Props extends {
     style?: CSSProperties;
 }, OwnerState>(internalProps: Props, slotProps: SlotPropsInput<Props, OwnerState> | undefined, ownerState: OwnerState): Props;
 
-export declare function MilestoneBar({ size, centerLeft, top, colWidth, title, a11y, onMove, onMoveEnd, tooltip, slots: slotsProp, slotProps: slotPropsProp, }: MilestoneBarProps): JSX.Element;
+export declare function MilestoneBar({ size, centerLeft, top, colWidth, title, a11y, onMove, onMoveEnd, tooltip, isCritical, slots: slotsProp, slotProps: slotPropsProp, }: MilestoneBarProps): JSX.Element;
 
 export declare interface MilestoneBarOwnerState {
     size: number;
     title: string;
+    /** Whether this bar is on the critical path (ADR-023). */
+    isCritical: boolean;
 }
 
 declare interface MilestoneBarProps {
@@ -889,6 +900,8 @@ declare interface MilestoneBarProps {
      * verbatim; a replaced `slots.root` that ignores it simply shows no tooltip.
      */
     tooltip?: BarTooltipOwnerState;
+    /** Whether this bar is on the critical path (ADR-023). Defaults to `false`. */
+    isCritical?: boolean;
     slots?: MilestoneBarSlots;
     slotProps?: MilestoneBarSlotProps;
 }
@@ -915,7 +928,7 @@ export declare interface Point {
     y: number;
 }
 
-export declare function ProjectBar({ width, height, left, top, colWidth, title, a11y, progress, onProgressChange, onProgressEnd, onMove, onMoveEnd, tooltip, slots: slotsProp, slotProps: slotPropsProp, }: ProjectBarProps): JSX.Element;
+export declare function ProjectBar({ width, height, left, top, colWidth, title, a11y, progress, onProgressChange, onProgressEnd, onMove, onMoveEnd, tooltip, isCritical, slots: slotsProp, slotProps: slotPropsProp, }: ProjectBarProps): JSX.Element;
 
 /** State passed to the function form of each ProjectBar slotProps. */
 export declare interface ProjectBarOwnerState {
@@ -923,6 +936,8 @@ export declare interface ProjectBarOwnerState {
     height: number;
     progress: number;
     title: string;
+    /** Whether this bar is on the critical path (ADR-023). */
+    isCritical: boolean;
 }
 
 declare interface ProjectBarProps {
@@ -944,6 +959,8 @@ declare interface ProjectBarProps {
      * verbatim; a replaced `slots.root` that ignores it simply shows no tooltip.
      */
     tooltip?: BarTooltipOwnerState;
+    /** Whether this bar is on the critical path (ADR-023). Defaults to `false`. */
+    isCritical?: boolean;
     slots?: ProjectBarSlots;
     slotProps?: ProjectBarSlotProps;
 }
@@ -1004,7 +1021,7 @@ export declare interface SlotConfig<Slots, SlotProps> {
  */
 export declare type SlotPropsInput<P, OwnerState> = Partial<P> | ((ownerState: OwnerState) => Partial<P>);
 
-export declare function TaskBar({ width, height, left, top, colWidth, title, a11y, progress, onProgressChange, onProgressEnd, onResize, onResizeEnd, onMove, onMoveEnd, tooltip, slots: slotsProp, slotProps: slotPropsProp, }: TaskBarProps): JSX.Element;
+export declare function TaskBar({ width, height, left, top, colWidth, title, a11y, progress, onProgressChange, onProgressEnd, onResize, onResizeEnd, onMove, onMoveEnd, tooltip, isCritical, slots: slotsProp, slotProps: slotPropsProp, }: TaskBarProps): JSX.Element;
 
 /** State passed to the function form of each TaskBar slotProps. */
 export declare interface TaskBarOwnerState {
@@ -1012,6 +1029,8 @@ export declare interface TaskBarOwnerState {
     height: number;
     progress: number;
     title: string;
+    /** Whether this bar is on the critical path (ADR-023). */
+    isCritical: boolean;
 }
 
 declare interface TaskBarProps {
@@ -1038,6 +1057,8 @@ declare interface TaskBarProps {
      * verbatim; a replaced `slots.root` that ignores it simply shows no tooltip.
      */
     tooltip?: BarTooltipOwnerState;
+    /** Whether this bar is on the critical path (ADR-023). Defaults to `false`. */
+    isCritical?: boolean;
     slots?: TaskBarSlots;
     slotProps?: TaskBarSlotProps;
 }