@taskctrl/canvas-timeline 0.4.5 → 0.6.0

package/dist/core/ViewState.d.ts

@@ -8,6 +8,7 @@ export interface ViewStateConfig {
     groupCount: number;
     buffer: number;
     scrollTop: number;
+    groupHeights?: number[];
 }
 export declare class ViewState {
     visibleTimeStart: number;
@@ -19,14 +20,18 @@ export declare class ViewState {
     groupCount: number;
     buffer: number;
     scrollTop: number;
+    groupHeights: number[] | null;
     private visibleDuration;
     private pixelsPerMs;
+    private groupYOffsets;
     constructor(config: ViewStateConfig);
     update(params: Partial<ViewStateConfig>): void;
+    private recomputeGroupYOffsets;
     timeToX(time: number): number;
     xToTime(x: number): number;
     yToGroupIndex(y: number): number;
     groupIndexToY(index: number): number;
+    groupIndexToHeight(index: number): number;
     getBufferBounds(): {
         bufferStart: number;
         bufferEnd: number;

package/dist/dom/DateHeader.d.ts

@@ -13,8 +13,9 @@ export interface DateHeaderProps {
     /** Minimum cell width in pixels. Header auto-hides when cells are narrower. Set to 0 to disable. */
     minCellWidth?: number;
     onZoomToInterval?: (start: number, end: number) => void;
+    timezone?: string;
 }
-export declare function DateHeader({ unit, visibleTimeStart, visibleTimeEnd, canvasWidth, theme, height, className, labelFormat, onIntervalClick, minCellWidth, onZoomToInterval, }: DateHeaderProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function DateHeader({ unit, visibleTimeStart, visibleTimeEnd, canvasWidth, theme, height, className, labelFormat, onIntervalClick, minCellWidth, onZoomToInterval, timezone, }: DateHeaderProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace DateHeader {
     var displayName: string;
 }

package/dist/dom/Sidebar.d.ts

@@ -4,11 +4,12 @@ interface SidebarProps {
     groups: Group[];
     width: number;
     lineHeight: number;
+    groupHeights?: number[];
     scrollTop: number;
     canvasHeight: number;
     theme: TimelineTheme;
     groupRenderer: (group: Group) => React.ReactNode;
     onScroll: (scrollTop: number) => void;
 }
-export declare function Sidebar({ groups, width, lineHeight, scrollTop, canvasHeight, theme, groupRenderer, onScroll, }: SidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function Sidebar({ groups, width, lineHeight, groupHeights, scrollTop, canvasHeight, theme, groupRenderer, onScroll, }: SidebarProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/dom/TimelineHeaders.d.ts

@@ -11,8 +11,9 @@ export interface TimelineHeadersProps {
     canvasWidth?: number;
     sidebarWidth?: number;
     onZoomToInterval?: (start: number, end: number) => void;
+    timezone?: string;
 }
-export declare function TimelineHeaders({ children, theme, className, classNames: _classNames, style, visibleTimeStart, visibleTimeEnd, canvasWidth, sidebarWidth, onZoomToInterval }: TimelineHeadersProps): import("react/jsx-runtime").JSX.Element;
+export declare function TimelineHeaders({ children, theme, className, classNames: _classNames, style, visibleTimeStart, visibleTimeEnd, canvasWidth, sidebarWidth, onZoomToInterval, timezone }: TimelineHeadersProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace TimelineHeaders {
     var displayName: string;
 }

package/dist/types.d.ts

@@ -151,6 +151,14 @@ export interface CanvasTimelineProps {
     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}`. */
+    /** Maximum visible height for the timeline body. Accepts a number (px) or
+     *  a CSS string like `'calc(100vh - 98px)'`. When set, the canvas and sidebar
+     *  are clipped and internally scrollable via wheel, drag, or touch. */
+    maxHeight?: number | string;
+    /** IANA timezone string (e.g. "America/New_York", "UTC").
+     *  When set, grid lines, headers, and day styling render in this timezone.
+     *  Defaults to the browser's local timezone. */
+    timezone?: string;
     devBadge?: boolean;
     children?: React.ReactNode;
 }

package/dist/utils/timezone.d.ts

@@ -0,0 +1,2 @@
+import dayjs from 'dayjs';
+export declare function toDayjs(ts: number, timezone?: string): dayjs.Dayjs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskctrl/canvas-timeline",
-  "version": "0.4.5",
+  "version": "0.6.0",
   "description": "High-performance canvas-based timeline component for React",
   "scripts": {
     "build": "rimraf ./dist && tsc && vite build",