@taskctrl/canvas-timeline 0.1.2 → 0.3.0

package/dist/core/HierarchyEngine.d.ts

@@ -0,0 +1,31 @@
+interface HierarchyItem {
+    id: number;
+    start_time: number;
+    end_time: number;
+    parentId?: number;
+}
+export declare class HierarchyEngine {
+    private parentToChildren;
+    private childToParent;
+    private itemMap;
+    private depthCache;
+    rebuild(items: HierarchyItem[]): void;
+    isParent(itemId: number): boolean;
+    getParent(itemId: number): number | undefined;
+    getChildren(itemId: number): number[];
+    getDescendants(itemId: number): number[];
+    getEffectiveSpan(itemId: number): {
+        start: number;
+        end: number;
+    };
+    getNestingDepth(itemId: number): number;
+    getMoveDelta(itemId: number, newStart: number): {
+        itemId: number;
+        newStart: number;
+    }[];
+    getResizeConstraint(itemId: number, edge: 'left' | 'right'): {
+        min: number;
+        max: number;
+    };
+}
+export {};

package/dist/core/LayoutEngine.d.ts

@@ -1,4 +1,5 @@
 import type { Item } from '../types';
+import type { HierarchyEngine } from './HierarchyEngine';
 export interface ItemLayout {
     stackLevel: number;
     itemHeight: number;
@@ -9,7 +10,9 @@ export declare class LayoutEngine {
     private layoutCache;
     private groupMaxStack;
     constructor(lineHeight: number, itemHeightRatio: number);
-    computeLayout(items: Item[], stackItems: boolean): Map<number, ItemLayout>;
+    computeLayout(items: Item[], stackItems: boolean, hierarchy?: HierarchyEngine): Map<number, ItemLayout>;
+    private computeFlatLayout;
+    private computeHierarchyLayout;
     getLayout(itemId: number): ItemLayout | undefined;
     getGroupHeight(groupId: string | number): number;
 }

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export type { Group, Item, ItemBounds, ItemState, DrawHelpers, CanvasItemRenderer, CanvasGroupItemRenderer, DayStyle, RowStyle, Dependency, TimelineTheme, MarkerConfig, CanvasTimelineProps, CanvasTimelineRef, CaptureOptions, } from './types';
+export type { Group, Item, ItemBounds, ItemState, DrawHelpers, CanvasItemRenderer, CanvasGroupItemRenderer, DayStyle, RowStyle, Dependency, TimeRangeHighlight, TimelineTheme, MarkerConfig, CanvasTimelineProps, CanvasTimelineRef, CaptureOptions, } from './types';
 export { DEFAULT_THEME } from './types';
 export { CanvasTimeline } from './CanvasTimeline';
+export { HierarchyEngine } from './core/HierarchyEngine';
 export { TodayMarker } from './dom/TodayMarker';
 export { CustomMarker } from './dom/CustomMarker';
 export { TimelineHeaders } from './dom/TimelineHeaders';

package/dist/interaction/snapUtils.d.ts

@@ -0,0 +1,15 @@
+interface SnapItem {
+    id: number;
+    start_time: number;
+    end_time: number;
+}
+/**
+ * Collect start and end X positions from all items except the dragged item.
+ */
+export declare function collectItemEdges(items: SnapItem[], excludeItemId: number, timeToX: (time: number) => number): number[];
+/**
+ * Find the best snap target from a list of edge X positions.
+ * Returns the snapped X position if an edge is within threshold, or null to fall back to time-grid snap.
+ */
+export declare function findSnapTarget(currentX: number, edgeXPositions: number[], thresholdPx: number, _pixelsPerMs: number, _dragSnap: number): number | null;
+export {};

package/dist/types.d.ts

@@ -12,6 +12,7 @@ export interface Item {
     group: number | string;
     start_time: number;
     end_time: number;
+    parentId?: number;
     type?: string;
     [key: string]: unknown;
 }
@@ -52,6 +53,13 @@ export interface Dependency {
     type?: 'finish-to-start' | 'start-to-start' | 'finish-to-finish';
     color?: string;
 }
+export interface TimeRangeHighlight {
+    start: number;
+    end: number;
+    color: string;
+    label?: string;
+    opacity?: number;
+}
 export interface TimelineTheme {
     primary: string;
     trainColors: Record<string, string>;
@@ -117,14 +125,19 @@ export interface CanvasTimelineProps {
     showCursorLine?: boolean;
     itemRenderer: CanvasItemRenderer;
     groupRenderer?: CanvasGroupItemRenderer;
+    summaryRenderer?: CanvasItemRenderer;
     sidebarGroupRenderer: (group: Group) => React.ReactNode;
     rightSidebarWidth?: number;
     rightSidebarGroupRenderer?: (group: Group) => React.ReactNode;
     dependencies?: Dependency[];
+    highlights?: TimeRangeHighlight[];
     onItemClick?: (itemId: number, e: PointerEvent) => void;
     onItemDoubleClick?: (itemId: number, e: PointerEvent) => void;
     onItemContextMenu?: (itemId: number, e: PointerEvent) => void;
-    onItemMove?: (itemId: number, newStartTime: number, newGroupId: string | number) => void;
+    onItemMove?: (itemId: number, newStartTime: number, newGroupId: string | number, childMoves?: {
+        itemId: number;
+        newStart: number;
+    }[]) => void;
     onItemResize?: (itemId: number, newTime: number, edge: 'left' | 'right') => void;
     /** Validate and optionally constrain move/resize. Return the (possibly modified) time. */
     moveResizeValidator?: (action: 'move' | 'resize', itemId: number, time: number, edge?: 'left' | 'right') => number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskctrl/canvas-timeline",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "High-performance canvas-based timeline component for React",
   "scripts": {
     "build": "rimraf ./dist && tsc && vite build",
@@ -8,6 +8,7 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "lint": "eslint --ext .ts --ext .tsx ./src",
+    "prepublishOnly": "yarn build",
     "release": "yarn release:patch",
     "release:patch": "npm version patch -m \"chore: release v%s\" && git push origin HEAD --follow-tags",
     "release:minor": "npm version minor -m \"chore: release v%s\" && git push origin HEAD --follow-tags",