canopycms 0.0.0

package/dist/editor/group-manager/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for GroupManager module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/editor/group-manager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/editor/group-manager/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/editor/hooks/__test__/test-utils.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Shared test utilities for hook tests.
+ *
+ * This file provides common setup patterns and helpers to reduce duplication
+ * across hook test files.
+ */
+import React from 'react';
+import { vi } from 'vitest';
+import { type MockApiClient } from '../../../api/__test__/mock-client';
+/**
+ * Setup mock API client for hook tests.
+ *
+ * This helper handles the common pattern of:
+ * 1. Creating a mock API client
+ * 2. Injecting it into the createApiClient factory
+ *
+ * @returns The mock API client instance
+ *
+ * @example
+ * ```ts
+ * let mockClient: MockApiClient
+ *
+ * beforeEach(async () => {
+ *   mockClient = await setupMockApiClient()
+ * })
+ * ```
+ */
+export declare function setupMockApiClient(): Promise<MockApiClient>;
+/**
+ * Create a wrapper component that provides the mock API client via context.
+ *
+ * Use this with renderHook to provide the ApiClientContext:
+ *
+ * @example
+ * ```ts
+ * const mockClient = await setupMockApiClient()
+ * const wrapper = createApiClientWrapper(mockClient)
+ * const { result } = renderHook(() => useSomeHook(), { wrapper })
+ * ```
+ */
+export declare function createApiClientWrapper(mockClient: MockApiClient): ({ children }: {
+    children: React.ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Setup mock window.location for tests that need to manipulate browser location.
+ *
+ * Automatically restores the original location after the test.
+ *
+ * @param options - Initial location values
+ * @returns Cleanup function (called automatically in afterEach if used with setupTestEnvironment)
+ *
+ * @example
+ * ```ts
+ * beforeEach(() => {
+ *   setupMockLocation({ href: 'http://localhost/', search: '' })
+ * })
+ * ```
+ */
+export declare function setupMockLocation(options?: {
+    href?: string;
+    search?: string;
+}): () => void;
+/**
+ * Setup mock window.history.replaceState for tests.
+ *
+ * @returns The mock function
+ *
+ * @example
+ * ```ts
+ * beforeEach(() => {
+ *   setupMockHistory()
+ * })
+ * ```
+ */
+export declare function setupMockHistory(): import("vitest").Mock<any, any>;
+/**
+ * Setup mock console methods with automatic cleanup.
+ *
+ * @param methods - Console methods to mock ('error', 'warn', 'log', etc.)
+ * @returns Object with spy methods and restore function
+ *
+ * @example
+ * ```ts
+ * it('handles errors silently', async () => {
+ *   const { error, restore } = setupMockConsole(['error'])
+ *
+ *   // ... test code that logs errors
+ *
+ *   expect(error).toHaveBeenCalled()
+ *   restore()
+ * })
+ * ```
+ */
+export declare function setupMockConsole(methods?: Array<'error' | 'warn' | 'log' | 'info' | 'debug'>): Record<"error" | "warn" | "log" | "info" | "debug", ReturnType<typeof vi.spyOn>> & {
+    restore: () => void;
+};
+/**
+ * Complete test environment setup for hook tests.
+ *
+ * Sets up:
+ * - Mock API client
+ * - Mock window.location
+ * - Mock window.history
+ *
+ * @param options - Configuration options
+ * @returns Object with mock client and cleanup functions
+ *
+ * @example
+ * ```ts
+ * let mockClient: MockApiClient
+ *
+ * beforeEach(async () => {
+ *   const setup = await setupTestEnvironment()
+ *   mockClient = setup.mockClient
+ * })
+ * ```
+ */
+export declare function setupTestEnvironment(options?: {
+    location?: {
+        href?: string;
+        search?: string;
+    };
+    setupHistory?: boolean;
+}): Promise<{
+    mockClient: MockApiClient;
+    mockHistory: import("vitest").Mock<any, any> | undefined;
+    cleanup: () => void;
+}>;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/editor/hooks/__test__/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../../src/editor/hooks/__test__/test-utils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,mCAAmC,CAAA;AAG3F;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,CAKjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,aAAa,IACtC,cAAc;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,6CAGpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,cAYjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,oCAI/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE,KAAK,CAAC,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAa,GAiBlE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG;IACtF,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CACF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAA;CAClB;;;;GAcP"}

package/dist/editor/hooks/__test__/test-utils.js

@@ -0,0 +1,157 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { vi } from 'vitest';
+import { createMockApiClient } from '../../../api/__test__/mock-client';
+import { ApiClientProvider } from '../../context';
+/**
+ * Setup mock API client for hook tests.
+ *
+ * This helper handles the common pattern of:
+ * 1. Creating a mock API client
+ * 2. Injecting it into the createApiClient factory
+ *
+ * @returns The mock API client instance
+ *
+ * @example
+ * ```ts
+ * let mockClient: MockApiClient
+ *
+ * beforeEach(async () => {
+ *   mockClient = await setupMockApiClient()
+ * })
+ * ```
+ */
+export async function setupMockApiClient() {
+    const { createApiClient } = await import('../../../api');
+    const mockClient = createMockApiClient();
+    vi.mocked(createApiClient).mockReturnValue(mockClient);
+    return mockClient;
+}
+/**
+ * Create a wrapper component that provides the mock API client via context.
+ *
+ * Use this with renderHook to provide the ApiClientContext:
+ *
+ * @example
+ * ```ts
+ * const mockClient = await setupMockApiClient()
+ * const wrapper = createApiClientWrapper(mockClient)
+ * const { result } = renderHook(() => useSomeHook(), { wrapper })
+ * ```
+ */
+export function createApiClientWrapper(mockClient) {
+    return function Wrapper({ children }) {
+        return _jsx(ApiClientProvider, { client: mockClient, children: children });
+    };
+}
+/**
+ * Setup mock window.location for tests that need to manipulate browser location.
+ *
+ * Automatically restores the original location after the test.
+ *
+ * @param options - Initial location values
+ * @returns Cleanup function (called automatically in afterEach if used with setupTestEnvironment)
+ *
+ * @example
+ * ```ts
+ * beforeEach(() => {
+ *   setupMockLocation({ href: 'http://localhost/', search: '' })
+ * })
+ * ```
+ */
+export function setupMockLocation(options = {}) {
+    const originalLocation = window.location;
+    delete window.location;
+    window.location = {
+        href: options.href ?? 'http://localhost/',
+        search: options.search ?? '',
+    };
+    return () => {
+        ;
+        window.location = originalLocation;
+    };
+}
+/**
+ * Setup mock window.history.replaceState for tests.
+ *
+ * @returns The mock function
+ *
+ * @example
+ * ```ts
+ * beforeEach(() => {
+ *   setupMockHistory()
+ * })
+ * ```
+ */
+export function setupMockHistory() {
+    const mockReplaceState = vi.fn();
+    window.history.replaceState = mockReplaceState;
+    return mockReplaceState;
+}
+/**
+ * Setup mock console methods with automatic cleanup.
+ *
+ * @param methods - Console methods to mock ('error', 'warn', 'log', etc.)
+ * @returns Object with spy methods and restore function
+ *
+ * @example
+ * ```ts
+ * it('handles errors silently', async () => {
+ *   const { error, restore } = setupMockConsole(['error'])
+ *
+ *   // ... test code that logs errors
+ *
+ *   expect(error).toHaveBeenCalled()
+ *   restore()
+ * })
+ * ```
+ */
+export function setupMockConsole(methods = ['error']) {
+    const spies = {};
+    for (const method of methods) {
+        spies[method] = vi.spyOn(console, method).mockImplementation(() => { });
+    }
+    const restore = () => {
+        for (const spy of Object.values(spies)) {
+            ;
+            spy?.mockRestore();
+        }
+    };
+    return {
+        ...spies,
+        restore,
+    };
+}
+/**
+ * Complete test environment setup for hook tests.
+ *
+ * Sets up:
+ * - Mock API client
+ * - Mock window.location
+ * - Mock window.history
+ *
+ * @param options - Configuration options
+ * @returns Object with mock client and cleanup functions
+ *
+ * @example
+ * ```ts
+ * let mockClient: MockApiClient
+ *
+ * beforeEach(async () => {
+ *   const setup = await setupTestEnvironment()
+ *   mockClient = setup.mockClient
+ * })
+ * ```
+ */
+export async function setupTestEnvironment(options = {}) {
+    const mockClient = await setupMockApiClient();
+    const cleanupLocation = setupMockLocation(options.location);
+    const mockHistory = options.setupHistory !== false ? setupMockHistory() : undefined;
+    return {
+        mockClient,
+        mockHistory,
+        cleanup: () => {
+            cleanupLocation();
+        },
+    };
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/editor/hooks/__test__/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../../../../src/editor/hooks/__test__/test-utils.tsx"],"names":[],"mappings":";AAQA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAE,mBAAmB,EAAsB,MAAM,mCAAmC,CAAA;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;IACxD,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAA;IACxC,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,eAAe,CAAC,UAAiB,CAAC,CAAA;IAC7D,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAyB;IAC9D,OAAO,SAAS,OAAO,CAAC,EAAE,QAAQ,EAAiC;QACjE,OAAO,KAAC,iBAAiB,IAAC,MAAM,EAAE,UAAiB,YAAG,QAAQ,GAAqB,CAAA;IACrF,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA8C,EAAE;IAChF,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAoB,CAAA;IAEpD,OAAQ,MAAc,CAAC,QAAQ,CAC9B;IAAC,MAAc,CAAC,QAAQ,GAAG;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,mBAAmB;QACzC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;KAC7B,CAAA;IAED,OAAO,GAAG,EAAE;QACV,CAAC;QAAC,MAAc,CAAC,QAAQ,GAAG,gBAAgB,CAAA;IAC9C,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;IAChC,MAAM,CAAC,OAAO,CAAC,YAAY,GAAG,gBAAgB,CAAA;IAC9C,OAAO,gBAAgB,CAAA;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAA8D,CAAC,OAAO,CAAC;IAEvE,MAAM,KAAK,GAAQ,EAAE,CAAA;IAErB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACxE,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,CAAC;YAAC,GAAW,EAAE,WAAW,EAAE,CAAA;QAC9B,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,GAAG,KAAK;QACR,OAAO;KAGR,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAGI,EAAE;IAEN,MAAM,UAAU,GAAG,MAAM,kBAAkB,EAAE,CAAA;IAE7C,MAAM,eAAe,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC3D,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAEnF,OAAO;QACL,UAAU;QACV,WAAW;QACX,OAAO,EAAE,GAAG,EAAE;YACZ,eAAe,EAAE,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/editor/hooks/index.d.ts

@@ -0,0 +1,12 @@
+export * from './useEditorLayout';
+export { useBranchManager, type UseBranchManagerOptions } from './useBranchManager';
+export { useEntryManager } from './useEntryManager';
+export * from './useDraftManager';
+export { useCommentSystem } from './useCommentSystem';
+export { useGroupManager } from './useGroupManager';
+export { usePermissionManager } from './usePermissionManager';
+export { useBranchActions } from './useBranchActions';
+export { useUserContext, type UseUserContextReturn } from './useUserContext';
+export { useReferenceResolution, type UseReferenceResolutionOptions, type UseReferenceResolutionResult, } from './useReferenceResolution';
+export { useSchemaManager, type UseSchemaManagerOptions, type UseSchemaManagerReturn, } from './useSchemaManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,GAClC,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAA"}

package/dist/editor/hooks/index.js

@@ -0,0 +1,15 @@
+// Barrel export for all custom hooks
+// Export hooks as they are created
+// Note: resetApiClient functions are not exported - they're test-only utilities
+export * from './useEditorLayout';
+export { useBranchManager } from './useBranchManager';
+export { useEntryManager } from './useEntryManager';
+export * from './useDraftManager';
+export { useCommentSystem } from './useCommentSystem';
+export { useGroupManager } from './useGroupManager';
+export { usePermissionManager } from './usePermissionManager';
+export { useBranchActions } from './useBranchActions';
+export { useUserContext } from './useUserContext';
+export { useReferenceResolution, } from './useReferenceResolution';
+export { useSchemaManager, } from './useSchemaManager';
+//# sourceMappingURL=index.js.map

package/dist/editor/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/editor/hooks/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,mCAAmC;AACnC,gFAAgF;AAEhF,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAgC,MAAM,oBAAoB,CAAA;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,cAAc,EAA6B,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EACL,sBAAsB,GAGvB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,gBAAgB,GAGjB,MAAM,oBAAoB,CAAA"}

package/dist/editor/hooks/useBranchActions.d.ts

@@ -0,0 +1,34 @@
+export interface UseBranchActionsOptions {
+    branchName: string;
+    setBranchName: (name: string) => void;
+    isSelectedDirty: () => boolean;
+    onReloadBranches: () => Promise<void>;
+    onBranchSwitch?: (branch: string) => void;
+}
+export interface UseBranchActionsReturn {
+    handleBranchChange: (branch: string | null) => Promise<void>;
+    handleCreateBranch: (branch: {
+        name: string;
+        title?: string;
+        description?: string;
+    }) => Promise<void>;
+}
+/**
+ * Custom hook for branch navigation actions with dirty check support.
+ *
+ * Handles:
+ * - Branch switching with unsaved changes confirmation
+ * - Creating new branches with dirty check
+ *
+ * @example
+ * ```tsx
+ * const { handleBranchChange, handleCreateBranch } = useBranchActions({
+ *   branchName,
+ *   setBranchName,
+ *   isSelectedDirty,
+ *   onReloadBranches
+ * })
+ * ```
+ */
+export declare function useBranchActions(options: UseBranchActionsOptions): UseBranchActionsReturn;
+//# sourceMappingURL=useBranchActions.d.ts.map

package/dist/editor/hooks/useBranchActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBranchActions.d.ts","sourceRoot":"","sources":["../../../src/editor/hooks/useBranchActions.tsx"],"names":[],"mappings":"AAKA,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,eAAe,EAAE,MAAM,OAAO,CAAA;IAC9B,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACrC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,kBAAkB,EAAE,CAAC,MAAM,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAiFzF"}

package/dist/editor/hooks/useBranchActions.js

@@ -0,0 +1,95 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { modals } from '@mantine/modals';
+import { notifications } from '@mantine/notifications';
+import { Text } from '@mantine/core';
+import { useApiClient } from '../context';
+/**
+ * Custom hook for branch navigation actions with dirty check support.
+ *
+ * Handles:
+ * - Branch switching with unsaved changes confirmation
+ * - Creating new branches with dirty check
+ *
+ * @example
+ * ```tsx
+ * const { handleBranchChange, handleCreateBranch } = useBranchActions({
+ *   branchName,
+ *   setBranchName,
+ *   isSelectedDirty,
+ *   onReloadBranches
+ * })
+ * ```
+ */
+export function useBranchActions(options) {
+    const apiClient = useApiClient();
+    // Helper: Perform branch switch with URL update
+    const performBranchSwitch = (next) => {
+        // Update branchName state - hooks will react:
+        // - useEntryManager clears selectedPath and refreshes entries
+        // - useDraftManager clears drafts/loadedValues
+        // - useCommentSystem loads comments
+        options.setBranchName(next);
+        // Update URL
+        if (typeof window !== 'undefined') {
+            const url = new URL(window.location.href);
+            url.searchParams.set('branch', next);
+            window.history.replaceState({}, '', url.toString());
+        }
+        options.onBranchSwitch?.(next);
+    };
+    // Helper: Check for dirty state and show modal
+    const confirmIfDirty = async (message) => {
+        if (!options.isSelectedDirty())
+            return true;
+        return new Promise((resolve) => {
+            modals.openConfirmModal({
+                title: 'Unsaved Changes',
+                children: _jsx(Text, { size: "sm", children: message }),
+                labels: { confirm: 'Continue Anyway', cancel: 'Cancel' },
+                confirmProps: { color: 'red' },
+                onCancel: () => resolve(false),
+                onConfirm: () => resolve(true),
+            });
+        });
+    };
+    const handleBranchChange = async (next) => {
+        if (!next || next === options.branchName)
+            return;
+        const confirmed = await confirmIfDirty('You have unsaved changes. Switch branches anyway?');
+        if (!confirmed)
+            throw new Error('User cancelled branch switch');
+        performBranchSwitch(next);
+    };
+    const handleCreateBranch = async (branch) => {
+        const confirmed = await confirmIfDirty('Create new branch without saving changes?');
+        if (!confirmed)
+            return;
+        // Create the branch via API
+        try {
+            const result = await apiClient.branches.create({
+                branch: branch.name,
+                title: branch.title,
+                description: branch.description,
+            });
+            if (!result.ok) {
+                throw new Error(result.error || 'Failed to create branch');
+            }
+            notifications.show({
+                message: `Branch "${branch.name}" created`,
+                color: 'green',
+            });
+            await options.onReloadBranches();
+            // Switch to new branch (already confirmed dirty check)
+            performBranchSwitch(branch.name);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Failed to create branch';
+            notifications.show({ message, color: 'red' });
+        }
+    };
+    return {
+        handleBranchChange,
+        handleCreateBranch,
+    };
+}
+//# sourceMappingURL=useBranchActions.js.map

package/dist/editor/hooks/useBranchActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBranchActions.js","sourceRoot":"","sources":["../../../src/editor/hooks/useBranchActions.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAmBzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAEhC,gDAAgD;IAChD,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAE,EAAE;QAC3C,8CAA8C;QAC9C,8DAA8D;QAC9D,+CAA+C;QAC/C,oCAAoC;QACpC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;QAE3B,aAAa;QACb,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YACzC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;YACpC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAA;QACrD,CAAC;QACD,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC,CAAA;IAED,+CAA+C;IAC/C,MAAM,cAAc,GAAG,KAAK,EAAE,OAAe,EAAoB,EAAE;QACjE,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE;YAAE,OAAO,IAAI,CAAA;QAE3C,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YACtC,MAAM,CAAC,gBAAgB,CAAC;gBACtB,KAAK,EAAE,iBAAiB;gBACxB,QAAQ,EAAE,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,YAAE,OAAO,GAAQ;gBAC1C,MAAM,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE;gBACxD,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;gBAC9B,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC9B,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;aAC/B,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,kBAAkB,GAAG,KAAK,EAAE,IAAmB,EAAE,EAAE;QACvD,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,OAAO,CAAC,UAAU;YAAE,OAAM;QAEhD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,mDAAmD,CAAC,CAAA;QAC3F,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;QAE/D,mBAAmB,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC,CAAA;IAED,MAAM,kBAAkB,GAAG,KAAK,EAAE,MAIjC,EAAE,EAAE;QACH,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,2CAA2C,CAAC,CAAA;QACnF,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtB,4BAA4B;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC7C,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAA;YACF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAA;YAC5D,CAAC;YACD,aAAa,CAAC,IAAI,CAAC;gBACjB,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,WAAW;gBAC1C,KAAK,EAAE,OAAO;aACf,CAAC,CAAA;YACF,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAA;YAEhC,uDAAuD;YACvD,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAA;YAC9E,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,kBAAkB;QAClB,kBAAkB;KACnB,CAAA;AACH,CAAC"}

package/dist/editor/hooks/useBranchManager.d.ts

@@ -0,0 +1,88 @@
+import type { BranchMetadata } from '../../types';
+import type { OperatingMode } from '../../operating-mode';
+import type { CommentThread } from '../../comment-store';
+/**
+ * Branch summary for display in BranchManager component.
+ */
+export interface BranchSummary {
+    name: string;
+    status: string;
+    createdBy?: string;
+    updatedAt?: string;
+    access: {
+        users: string[] | undefined;
+        groups: string[] | undefined;
+    };
+    pullRequestUrl?: string;
+    pullRequestNumber?: number;
+    commentCount: number;
+}
+export interface UseBranchManagerOptions {
+    /**
+     * Initial branch name.
+     */
+    initialBranch: string;
+    /**
+     * Operating mode (dev, etc.).
+     */
+    operatingMode: OperatingMode;
+    /**
+     * Callback to set busy state.
+     */
+    setBusy: (busy: boolean) => void;
+    /**
+     * Current comments (for computing comment counts per branch).
+     */
+    comments: CommentThread[];
+}
+export interface UseBranchManagerReturn {
+    branchName: string;
+    setBranchName: (name: string) => void;
+    branches: BranchMetadata[];
+    branchSummaries: BranchSummary[];
+    currentBranch: BranchMetadata | undefined;
+    branchStatus: string;
+    handleSubmit: (branchName: string) => Promise<void>;
+    handleWithdraw: (branchName: string) => Promise<void>;
+    handleRequestChanges: (branchName: string) => Promise<void>;
+    handleDelete: (branchName: string) => Promise<void>;
+    handleReloadBranchData: () => Promise<void>;
+    loadBranches: () => Promise<void>;
+}
+/**
+ * Custom hook for managing git branches.
+ *
+ * Handles:
+ * - Loading branches from API
+ * - Branch switching with unsaved changes confirmation
+ * - Creating new branches
+ * - Branch workflow (submit, withdraw, request changes)
+ * - URL synchronization for branch parameter
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   branchName,
+ *   branches,
+ *   currentBranch,
+ *   handleBranchChange,
+ *   handleCreateBranch,
+ *   handleSubmit
+ * } = useBranchManager({
+ *   initialBranch: 'main',
+ *   operatingMode: 'collaboration',
+ *   selectedPath,
+ *   drafts,
+ *   loadedValues,
+ *   setDrafts,
+ *   setLoadedValues,
+ *   setSelectedId,
+ *   setEntries,
+ *   onEntriesRefresh: refreshEntries,
+ *   onCommentsLoad: loadComments,
+ *   setBusy
+ * })
+ * ```
+ */
+export declare function useBranchManager(options: UseBranchManagerOptions): UseBranchManagerReturn;
+//# sourceMappingURL=useBranchManager.d.ts.map

package/dist/editor/hooks/useBranchManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBranchManager.d.ts","sourceRoot":"","sources":["../../../src/editor/hooks/useBranchManager.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA+CxD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;QAC3B,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;KAC7B,CAAA;IACD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,aAAa,EAAE,aAAa,CAAA;IAE5B;;OAEG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEhC;;OAEG;IACH,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,eAAe,EAAE,aAAa,EAAE,CAAA;IAChC,aAAa,EAAE,cAAc,GAAG,SAAS,CAAA;IACzC,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,sBAAsB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAuLzF"}