@taskctrl/canvas-timeline 0.2.0 → 0.4.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, 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/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;
 }
@@ -124,6 +125,7 @@ export interface CanvasTimelineProps {
     showCursorLine?: boolean;
     itemRenderer: CanvasItemRenderer;
     groupRenderer?: CanvasGroupItemRenderer;
+    summaryRenderer?: CanvasItemRenderer;
     sidebarGroupRenderer: (group: Group) => React.ReactNode;
     rightSidebarWidth?: number;
     rightSidebarGroupRenderer?: (group: Group) => React.ReactNode;
@@ -132,7 +134,10 @@ export interface CanvasTimelineProps {
     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;
@@ -144,6 +149,9 @@ export interface CanvasTimelineProps {
     selected?: number[];
     /** Called when the timeline is ready, providing the capture API */
     onReady?: (api: CanvasTimelineRef) => void;
+    /** Dev-only: show a version + build-time badge in the top-left corner.
+     *  Wire to your app's dev flag, e.g. `devBadge={import.meta.env.DEV}`. */
+    devBadge?: boolean;
     children?: React.ReactNode;
 }
 export interface CaptureOptions {

package/package.json

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