@critical-path/svelte 0.12.0 → 0.13.1

package/dist/timeline-ladder-state.svelte.d.ts

@@ -0,0 +1,23 @@
+import type { CriticalPathClient } from '@critical-path/client';
+import type { TimelineLadder, TimelineLadderOptions, AbstractionLevel, MacroTimelineSummary, ConcreteTaskEvidence } from '@critical-path/core';
+export declare class TimelineLadderState {
+    private client;
+    projectId: string;
+    data: TimelineLadder | null;
+    level: AbstractionLevel;
+    loading: boolean;
+    error: Error | null;
+    macro: MacroTimelineSummary | null;
+    standard: {
+        tasks: import("@critical-path/client").StandardTaskTimelineItem[];
+        criticalPathTaskIds: string[];
+        dependencies: import("@critical-path/core").TaskDependency[];
+        totalDurationHours: number;
+    } | null | undefined;
+    concrete: Record<string, ConcreteTaskEvidence> | null;
+    constructor(client: CriticalPathClient, projectId: string, initialOptions?: TimelineLadderOptions);
+    setLevel(newLevel: AbstractionLevel): Promise<void>;
+    fetch(options?: TimelineLadderOptions): Promise<void>;
+}
+export declare function createTimelineLadderState(client: CriticalPathClient, projectId: string, initialOptions?: TimelineLadderOptions): TimelineLadderState;
+//# sourceMappingURL=timeline-ladder-state.svelte.d.ts.map

package/dist/timeline-ladder-state.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-ladder-state.svelte.d.ts","sourceRoot":"","sources":["../src/timeline-ladder-state.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,mBAAmB;IAW5B,OAAO,CAAC,MAAM;IACP,SAAS,EAAE,MAAM;IAX1B,IAAI,wBAAuC;IAC3C,KAAK,mBAAmC;IACxC,OAAO,UAA0B;IACjC,KAAK,eAA8B;IAEnC,KAAK,8BAAmE;IACxE,QAAQ;;;;;yBAA4E;IACpF,QAAQ,8CAAsF;gBAGpF,MAAM,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACxB,cAAc,CAAC,EAAE,qBAAqB;IAOlC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB;IAKnC,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB;CAc5C;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,qBAAqB,GACrC,mBAAmB,CAErB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@critical-path/svelte",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "Svelte 5 Runes state and reactive integrations for Critical Path headless project management framework",
   "author": "Jack James",
   "license": "MIT",
@@ -18,9 +18,9 @@
     }
   },
   "dependencies": {
-    "@critical-path/client": "0.9.2",
-    "@critical-path/core": "0.15.2",
-    "@critical-path/mcp": "0.2.0"
+    "@critical-path/core": "0.16.0",
+    "@critical-path/mcp": "0.3.1",
+    "@critical-path/client": "0.10.0"
   },
   "peerDependencies": {
     "svelte": "^5.0.0"

package/src/critical-path-state.svelte.ts

@@ -0,0 +1,33 @@
+/// <reference types="svelte" />
+import type { CriticalPathClient } from '@critical-path/client';
+import type { CriticalPathAnalysis } from '@critical-path/core';
+
+export class CriticalPathState {
+  data = $state<CriticalPathAnalysis | null>(null);
+  loading = $state<boolean>(false);
+  error = $state<Error | null>(null);
+
+  constructor(
+    private client: CriticalPathClient,
+    public projectId: string
+  ) {}
+
+  async fetch() {
+    this.loading = true;
+    this.error = null;
+    try {
+      this.data = await this.client.calculateCriticalPath(this.projectId);
+    } catch (err) {
+      this.error = err instanceof Error ? err : new Error(String(err));
+    } finally {
+      this.loading = false;
+    }
+  }
+}
+
+export function createCriticalPathState(
+  client: CriticalPathClient,
+  projectId: string
+): CriticalPathState {
+  return new CriticalPathState(client, projectId);
+}

package/src/index.test.ts

@@ -22,10 +22,24 @@ import {
   TaskTransitionsState,
   createTaskTransitionsState,
   WebMcpState,
-  createWebMcpState
+  createWebMcpState,
+  CriticalPathState,
+  createCriticalPathState,
+  TimelineLadderState,
+  createTimelineLadderState
 } from './index.js';
 import type { CriticalPathClient } from '@critical-path/client';
-import type { Project, Task, Workflow, Comment, Attachment, Deliverable, DeliverableSummary } from '@critical-path/core';
+import type {
+  Project,
+  Task,
+  Workflow,
+  Comment,
+  Attachment,
+  Deliverable,
+  DeliverableSummary,
+  CriticalPathAnalysis,
+  TimelineLadder
+} from '@critical-path/core';
 
 describe('@critical-path/svelte Svelte 5 Runes Test Suite', () => {
   it('exports client factory and Svelte 5 Runes state factories', () => {
@@ -568,6 +582,84 @@ describe('@critical-path/svelte Svelte 5 Runes Test Suite', () => {
       expect(summaryState.data).toEqual(mockSummary);
     });
   });
+
+  describe('CriticalPathState', () => {
+    it('manages loading, error, and critical path analysis data', async () => {
+      const mockAnalysis: CriticalPathAnalysis = {
+        projectId: 'proj_cpm',
+        calculatedAt: '2026-09-11T12:00:00Z',
+        totalDurationHours: 42,
+        criticalTaskIds: ['t1', 't2'],
+        tasks: []
+      };
+
+      const mockClient = {
+        calculateCriticalPath: vi.fn().mockResolvedValue(mockAnalysis)
+      } as unknown as CriticalPathClient;
+
+      const cpmState = createCriticalPathState(mockClient, 'proj_cpm');
+      expect(cpmState.data).toBeNull();
+      expect(cpmState.loading).toBe(false);
+
+      await cpmState.fetch();
+      expect(mockClient.calculateCriticalPath).toHaveBeenCalledWith('proj_cpm');
+      expect(cpmState.data).toEqual(mockAnalysis);
+      expect(cpmState.loading).toBe(false);
+    });
+  });
+
+  describe('TimelineLadderState', () => {
+    it('manages multi-scale ladder data, levels, and derived rungs', async () => {
+      const mockLadder: TimelineLadder = {
+        projectId: 'proj_ladder',
+        generatedAt: '2026-09-11T12:00:00Z',
+        level: 'all',
+        macro: {
+          projectId: 'proj_ladder',
+          projectName: 'Ladder Proj',
+          totalDurationHours: 50,
+          criticalPathDurationHours: 40,
+          overallProgressPercentage: 60,
+          health: 'on_track',
+          totalTasks: 5,
+          completedTasks: 3,
+          inProgressTasks: 2,
+          blockedTasks: 0,
+          totalEstimatedHours: 50,
+          totalLoggedHours: 25,
+          phases: []
+        },
+        standard: {
+          tasks: [],
+          criticalPathTaskIds: [],
+          dependencies: [],
+          totalDurationHours: 40
+        },
+        concrete: {}
+      };
+
+      const mockClient = {
+        getTimelineLadder: vi.fn().mockResolvedValue(mockLadder)
+      } as unknown as CriticalPathClient;
+
+      const ladderState = createTimelineLadderState(mockClient, 'proj_ladder', { level: 'all' });
+      expect(ladderState.data).toBeNull();
+      expect(ladderState.macro).toBeNull();
+      expect(ladderState.standard).toBeNull();
+      expect(ladderState.concrete).toBeNull();
+
+      await ladderState.fetch();
+      expect(mockClient.getTimelineLadder).toHaveBeenCalledWith('proj_ladder', { level: 'all' });
+      expect(ladderState.data).toEqual(mockLadder);
+      expect(ladderState.macro?.projectName).toBe('Ladder Proj');
+      expect(ladderState.standard?.tasks).toEqual([]);
+      expect(ladderState.concrete).toEqual({});
+
+      await ladderState.setLevel('macro');
+      expect(ladderState.level).toBe('macro');
+      expect(mockClient.getTimelineLadder).toHaveBeenCalledWith('proj_ladder', { level: 'macro' });
+    });
+  });
 });
 
 

package/src/index.ts

@@ -15,5 +15,7 @@ export * from './deliverable-summary-state.svelte.js';
 export * from './kanban-state.svelte.js';
 export * from './task-transitions-state.svelte.js';
 export * from './webmcp-state.svelte.js';
+export * from './critical-path-state.svelte.js';
+export * from './timeline-ladder-state.svelte.js';
 
 

package/src/timeline-ladder-state.svelte.ts

@@ -0,0 +1,58 @@
+/// <reference types="svelte" />
+import type { CriticalPathClient } from '@critical-path/client';
+import type {
+  TimelineLadder,
+  TimelineLadderOptions,
+  AbstractionLevel,
+  MacroTimelineSummary,
+  ConcreteTaskEvidence
+} from '@critical-path/core';
+
+export class TimelineLadderState {
+  data = $state<TimelineLadder | null>(null);
+  level = $state<AbstractionLevel>('all');
+  loading = $state<boolean>(false);
+  error = $state<Error | null>(null);
+
+  macro = $derived<MacroTimelineSummary | null>(this.data?.macro ?? null);
+  standard = $derived<TimelineLadder['standard'] | null>(this.data?.standard ?? null);
+  concrete = $derived<Record<string, ConcreteTaskEvidence> | null>(this.data?.concrete ?? null);
+
+  constructor(
+    private client: CriticalPathClient,
+    public projectId: string,
+    initialOptions?: TimelineLadderOptions
+  ) {
+    if (initialOptions?.level) {
+      this.level = initialOptions.level;
+    }
+  }
+
+  async setLevel(newLevel: AbstractionLevel) {
+    this.level = newLevel;
+    await this.fetch();
+  }
+
+  async fetch(options?: TimelineLadderOptions) {
+    this.loading = true;
+    this.error = null;
+    try {
+      this.data = await this.client.getTimelineLadder(this.projectId, {
+        level: this.level,
+        ...options
+      });
+    } catch (err) {
+      this.error = err instanceof Error ? err : new Error(String(err));
+    } finally {
+      this.loading = false;
+    }
+  }
+}
+
+export function createTimelineLadderState(
+  client: CriticalPathClient,
+  projectId: string,
+  initialOptions?: TimelineLadderOptions
+): TimelineLadderState {
+  return new TimelineLadderState(client, projectId, initialOptions);
+}