@critical-path/react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jack James
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/hooks.d.ts

@@ -0,0 +1,27 @@
+import type { Project, Task, TaskStatus } from '@critical-path/core';
+export declare function useProjects(): {
+    projects: Project[];
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    createProject: (input: Omit<Project, "id" | "createdAt" | "updatedAt">) => Promise<Project>;
+};
+export declare function useTasks(projectId?: string): {
+    tasks: Task[];
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    createTask: (input: Omit<Task, "id" | "createdAt" | "updatedAt">) => Promise<Task>;
+    updateTaskStatus: (taskId: string, status: TaskStatus) => Promise<Task>;
+    deleteTask: (taskId: string) => Promise<void>;
+};
+export declare function useKanban(projectId?: string): {
+    columns: Record<TaskStatus, Task[]>;
+    tasks: Task[];
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    moveTask: (taskId: string, targetStatus: TaskStatus) => Promise<Task>;
+    createTask: (input: Omit<Task, "id" | "createdAt" | "updatedAt">) => Promise<Task>;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGrE,wBAAgB,WAAW;;;;;2BAuBW,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC;EAOpF;AAED,wBAAgB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;;;;;wBAuBR,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC;+BAMrC,MAAM,UAAU,UAAU;yBAMhC,MAAM;EAMzC;AAED,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM;;;;;;uBAYV,MAAM,gBAAgB,UAAU;wBAhC/B,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC;EAqC9E"}

package/dist/hooks.js

@@ -0,0 +1,85 @@
+import { useState, useEffect, useCallback } from 'react';
+import { useCriticalPathClient } from './provider.js';
+export function useProjects() {
+    const client = useCriticalPathClient();
+    const [projects, setProjects] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const fetchProjects = useCallback(async () => {
+        try {
+            setLoading(true);
+            const data = await client.getProjects();
+            setProjects(data);
+            setError(null);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client]);
+    useEffect(() => {
+        fetchProjects();
+    }, [fetchProjects]);
+    const createProject = async (input) => {
+        const created = await client.createProject(input);
+        setProjects((prev) => [...prev, created]);
+        return created;
+    };
+    return { projects, loading, error, refresh: fetchProjects, createProject };
+}
+export function useTasks(projectId) {
+    const client = useCriticalPathClient();
+    const [tasks, setTasks] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const fetchTasks = useCallback(async () => {
+        try {
+            setLoading(true);
+            const data = await client.getTasks(projectId);
+            setTasks(data);
+            setError(null);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client, projectId]);
+    useEffect(() => {
+        fetchTasks();
+    }, [fetchTasks]);
+    const createTask = async (input) => {
+        const created = await client.createTask(input);
+        setTasks((prev) => [...prev, created]);
+        return created;
+    };
+    const updateTaskStatus = async (taskId, status) => {
+        const updated = await client.updateTask(taskId, { status });
+        setTasks((prev) => prev.map((t) => (t.id === taskId ? updated : t)));
+        return updated;
+    };
+    const deleteTask = async (taskId) => {
+        await client.deleteTask(taskId);
+        setTasks((prev) => prev.filter((t) => t.id !== taskId));
+    };
+    return { tasks, loading, error, refresh: fetchTasks, createTask, updateTaskStatus, deleteTask };
+}
+export function useKanban(projectId) {
+    const { tasks, loading, error, refresh, updateTaskStatus, createTask } = useTasks(projectId);
+    const columns = {
+        backlog: tasks.filter((t) => t.status === 'backlog'),
+        todo: tasks.filter((t) => t.status === 'todo'),
+        in_progress: tasks.filter((t) => t.status === 'in_progress'),
+        in_review: tasks.filter((t) => t.status === 'in_review'),
+        done: tasks.filter((t) => t.status === 'done'),
+        canceled: tasks.filter((t) => t.status === 'canceled')
+    };
+    const moveTask = async (taskId, targetStatus) => {
+        return updateTaskStatus(taskId, targetStatus);
+    };
+    return { columns, tasks, loading, error, refresh, moveTask, createTask };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './provider.js';
+export * from './hooks.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './provider.js';
+export * from './hooks.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js

@@ -0,0 +1,9 @@
+import { describe, it, expect } from 'vitest';
+import { CriticalPathProvider, useCriticalPathClient } from './index.js';
+describe('@critical-path/react Exports Test', () => {
+    it('exports Provider and Hooks', () => {
+        expect(CriticalPathProvider).toBeDefined();
+        expect(useCriticalPathClient).toBeDefined();
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEzE,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,oBAAoB,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,CAAC,qBAAqB,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { CriticalPathClient, type ClientOptions } from '@critical-path/client';
+export interface CriticalPathProviderProps {
+    client?: CriticalPathClient;
+    options?: ClientOptions;
+    children: React.ReactNode;
+}
+export declare function CriticalPathProvider({ client, options, children }: CriticalPathProviderProps): React.JSX.Element;
+export declare function useCriticalPathClient(): CriticalPathClient;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQ/E,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,yBAAyB,qBAY5F;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAM1D"}

package/dist/provider.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from 'react';
+import { CriticalPathClient } from '@critical-path/client';
+const CriticalPathContext = createContext(null);
+export function CriticalPathProvider({ client, options, children }) {
+    const activeClient = useMemo(() => {
+        if (client)
+            return client;
+        if (options)
+            return new CriticalPathClient(options);
+        return new CriticalPathClient({ baseUrl: '/api/critical-path' });
+    }, [client, options]);
+    return (_jsx(CriticalPathContext.Provider, { value: { client: activeClient }, children: children }));
+}
+export function useCriticalPathClient() {
+    const ctx = useContext(CriticalPathContext);
+    if (!ctx) {
+        throw new Error('useCriticalPathClient must be used within a <CriticalPathProvider>');
+    }
+    return ctx.client;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAsB,MAAM,uBAAuB,CAAC;AAM/E,MAAM,mBAAmB,GAAG,aAAa,CAAkC,IAAI,CAAC,CAAC;AAQjF,MAAM,UAAU,oBAAoB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAA6B;IAC3F,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE;QAChC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,IAAI,OAAO;YAAE,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACnE,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEtB,OAAO,CACL,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,YAC1D,QAAQ,GACoB,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@critical-path/react",
+  "version": "0.1.0",
+  "description": "React Context Provider and Hooks for Critical Path headless project management framework",
+  "author": "Jack James",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@critical-path/client": "0.1.0",
+    "@critical-path/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "test": "vitest run",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}

package/src/hooks.ts

@@ -0,0 +1,97 @@
+import { useState, useEffect, useCallback } from 'react';
+import type { Project, Task, TaskStatus } from '@critical-path/core';
+import { useCriticalPathClient } from './provider.js';
+
+export function useProjects() {
+  const client = useCriticalPathClient();
+  const [projects, setProjects] = useState<Project[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  const fetchProjects = useCallback(async () => {
+    try {
+      setLoading(true);
+      const data = await client.getProjects();
+      setProjects(data);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+
+  useEffect(() => {
+    fetchProjects();
+  }, [fetchProjects]);
+
+  const createProject = async (input: Omit<Project, 'id' | 'createdAt' | 'updatedAt'>) => {
+    const created = await client.createProject(input);
+    setProjects((prev) => [...prev, created]);
+    return created;
+  };
+
+  return { projects, loading, error, refresh: fetchProjects, createProject };
+}
+
+export function useTasks(projectId?: string) {
+  const client = useCriticalPathClient();
+  const [tasks, setTasks] = useState<Task[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  const fetchTasks = useCallback(async () => {
+    try {
+      setLoading(true);
+      const data = await client.getTasks(projectId);
+      setTasks(data);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, projectId]);
+
+  useEffect(() => {
+    fetchTasks();
+  }, [fetchTasks]);
+
+  const createTask = async (input: Omit<Task, 'id' | 'createdAt' | 'updatedAt'>) => {
+    const created = await client.createTask(input);
+    setTasks((prev) => [...prev, created]);
+    return created;
+  };
+
+  const updateTaskStatus = async (taskId: string, status: TaskStatus) => {
+    const updated = await client.updateTask(taskId, { status });
+    setTasks((prev) => prev.map((t) => (t.id === taskId ? updated : t)));
+    return updated;
+  };
+
+  const deleteTask = async (taskId: string) => {
+    await client.deleteTask(taskId);
+    setTasks((prev) => prev.filter((t) => t.id !== taskId));
+  };
+
+  return { tasks, loading, error, refresh: fetchTasks, createTask, updateTaskStatus, deleteTask };
+}
+
+export function useKanban(projectId?: string) {
+  const { tasks, loading, error, refresh, updateTaskStatus, createTask } = useTasks(projectId);
+
+  const columns: Record<TaskStatus, Task[]> = {
+    backlog: tasks.filter((t) => t.status === 'backlog'),
+    todo: tasks.filter((t) => t.status === 'todo'),
+    in_progress: tasks.filter((t) => t.status === 'in_progress'),
+    in_review: tasks.filter((t) => t.status === 'in_review'),
+    done: tasks.filter((t) => t.status === 'done'),
+    canceled: tasks.filter((t) => t.status === 'canceled')
+  };
+
+  const moveTask = async (taskId: string, targetStatus: TaskStatus) => {
+    return updateTaskStatus(taskId, targetStatus);
+  };
+
+  return { columns, tasks, loading, error, refresh, moveTask, createTask };
+}

package/src/index.test.ts

@@ -0,0 +1,9 @@
+import { describe, it, expect } from 'vitest';
+import { CriticalPathProvider, useCriticalPathClient } from './index.js';
+
+describe('@critical-path/react Exports Test', () => {
+  it('exports Provider and Hooks', () => {
+    expect(CriticalPathProvider).toBeDefined();
+    expect(useCriticalPathClient).toBeDefined();
+  });
+});

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './provider.js';
+export * from './hooks.js';

package/src/provider.tsx

@@ -0,0 +1,36 @@
+import React, { createContext, useContext, useMemo } from 'react';
+import { CriticalPathClient, type ClientOptions } from '@critical-path/client';
+
+interface CriticalPathContextValue {
+  client: CriticalPathClient;
+}
+
+const CriticalPathContext = createContext<CriticalPathContextValue | null>(null);
+
+export interface CriticalPathProviderProps {
+  client?: CriticalPathClient;
+  options?: ClientOptions;
+  children: React.ReactNode;
+}
+
+export function CriticalPathProvider({ client, options, children }: CriticalPathProviderProps) {
+  const activeClient = useMemo(() => {
+    if (client) return client;
+    if (options) return new CriticalPathClient(options);
+    return new CriticalPathClient({ baseUrl: '/api/critical-path' });
+  }, [client, options]);
+
+  return (
+    <CriticalPathContext.Provider value={{ client: activeClient }}>
+      {children}
+    </CriticalPathContext.Provider>
+  );
+}
+
+export function useCriticalPathClient(): CriticalPathClient {
+  const ctx = useContext(CriticalPathContext);
+  if (!ctx) {
+    throw new Error('useCriticalPathClient must be used within a <CriticalPathProvider>');
+  }
+  return ctx.client;
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "jsx": "react-jsx"
+  },
+  "include": ["src/**/*"]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/hooks.ts","./src/index.test.ts","./src/index.ts","./src/provider.tsx"],"version":"5.9.3"}