@pantheon-systems/puck-css 0.4.0

package/dist/editor/plugin/createP1Overrides.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { SaveIndicator } from '../components/SaveIndicator.js';
+import { HistoricalVersionBanner } from '../../versioning/components/HistoricalVersionBanner.js';
+import { CollaboratorAvatars } from '../../collaboration/components/CollaboratorAvatars.js';
+import { AgentActivityBanner } from '../../collaboration/components/AgentActivityBanner.js';
+import { PublishedStatusBadge } from '../components/PublishedStatusBadge.js';
+/**
+ * Creates Puck overrides for P1 integration.
+ *
+ * Adds SaveIndicator and PublishButton to the header actions area.
+ *
+ * @example
+ * ```tsx
+ * import { createP1Overrides, useP1Puck } from '@pantheon-systems/puck-css';
+ *
+ * function Editor() {
+ *   const {
+ *     saveStatus,
+ *     lastSaved,
+ *     saveError,
+ *     saveNow,
+ *     publishDocument,
+ *   } = useP1Puck();
+ *
+ *   // Preferred: use refs and getters for better performance
+ *   const saveStatusRef = useRef(saveStatus);
+ *   useEffect(() => { saveStatusRef.current = saveStatus; }, [saveStatus]);
+ *
+ *   const overrides = createP1Overrides({
+ *     getSaveStatus: () => saveStatusRef.current,
+ *     getLastSaved: () => lastSavedRef.current,
+ *     getSaveError: () => saveErrorRef.current,
+ *     onRetrySave: saveNow,
+ *   });
+ *
+ *   // Legacy: direct values (causes overrides to be recreated on changes)
+ *   const overrides = createP1Overrides({
+ *     saveStatus,
+ *     lastSaved,
+ *     saveError,
+ *     onRetrySave: saveNow,
+ *   });
+ *
+ *   return <Puck overrides={overrides} {...otherProps} />;
+ * }
+ * ```
+ */
+export function createP1Overrides(options) {
+    const { 
+    // New getter-based API (preferred)
+    getSaveStatus, getLastSaved, getSaveError, 
+    // Legacy direct value API
+    saveStatus: directSaveStatus, lastSaved: directLastSaved, saveError: directSaveError, 
+    // Common options
+    onRetrySave, showDefaultPublish = false, 
+    // Deprecated props - kept for type signature compatibility but ignored
+    syncData: _syncData, dataSyncKey: _dataSyncKey,
+    // Presence/Agent Features — NOT destructured here.
+    // These are read lazily from `options` in the headerActions render function
+    // so that the Proxy pattern from useP1Overrides provides live values.
+    // Destructuring would capture stale values from the initial call.
+     } = options;
+    // Suppress unused variable warnings for deprecated props
+    void _syncData;
+    void _dataSyncKey;
+    // Determine if using getter API or direct props API
+    const usingGetters = typeof getSaveStatus === 'function';
+    // Build props for SaveIndicator based on which API is being used
+    const saveIndicatorProps = usingGetters
+        ? {
+            getStatus: getSaveStatus,
+            getLastSaved: getLastSaved,
+            getError: getSaveError,
+            onRetry: onRetrySave,
+        }
+        : {
+            status: directSaveStatus,
+            lastSaved: directLastSaved,
+            error: directSaveError,
+            onRetry: onRetrySave,
+        };
+    return {
+        headerActions: ({ children }) => {
+            // Read presence/agent values lazily from options (Proxy) each render
+            // so they reflect the latest state from useP1Overrides' optionsRef.
+            const _showCollaboratorAvatars = options.showCollaboratorAvatars ?? false;
+            const _presence = options.presence ?? [];
+            const _showAgentActivityBanner = options.showAgentActivityBanner ?? false;
+            const _activeAgents = options.activeAgents ?? [];
+            const _isAgentEditing = options.isAgentEditing ?? false;
+            const _onStopAgent = options.onStopAgent;
+            const _showSaveIndicator = options.showSaveIndicator ?? true;
+            const _isViewingHistoricalVersion = options.isViewingHistoricalVersion ?? false;
+            const _viewingVersion = options.viewingVersion;
+            const _onReturnToLatest = options.onReturnToLatest;
+            const _publishedStatus = options.publishedStatus;
+            // Find the first active agent for banner display
+            const firstActiveAgent = _activeAgents.find(a => a.state === 'editing') || _activeAgents[0];
+            return (_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: '8px' }, children: [_showAgentActivityBanner && _isAgentEditing && firstActiveAgent && (_jsx(AgentActivityBanner, { agent: firstActiveAgent, showIdle: true, onStopAgent: _onStopAgent })), _showCollaboratorAvatars && _presence.length > 0 && (_jsx(CollaboratorAvatars, { actors: _presence, maxVisible: 5 })), _isViewingHistoricalVersion && _viewingVersion && _onReturnToLatest ? (_jsx(HistoricalVersionBanner, { version: _viewingVersion, onReturnToLatest: _onReturnToLatest })) : (_jsxs(_Fragment, { children: [_showSaveIndicator && _jsx(SaveIndicator, { ...saveIndicatorProps }), _publishedStatus && (_jsx(PublishedStatusBadge, { status: _publishedStatus }))] })), showDefaultPublish && children] }));
+        },
+    };
+}
+//# sourceMappingURL=createP1Overrides.js.map

package/dist/editor/plugin/createP1Overrides.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Puck Plugin Integration
+ *
+ * Exports for integrating P1 functionality directly into Puck
+ * using Puck's official Plugin API and Overrides system.
+ */
+export { createP1Plugin } from './P1Plugin.js';
+export type { P1PluginOptions, PuckPlugin } from './P1Plugin.js';
+export { createP1Overrides } from './createP1Overrides.js';
+export type { P1OverridesOptions, PuckOverrides } from './createP1Overrides.js';
+export { createMergePreviewPlugin } from './mergePreviewPlugin.js';
+export type { MergePreviewPluginOptions } from './mergePreviewPlugin.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/editor/plugin/index.js

@@ -0,0 +1,10 @@
+/**
+ * Puck Plugin Integration
+ *
+ * Exports for integrating P1 functionality directly into Puck
+ * using Puck's official Plugin API and Overrides system.
+ */
+export { createP1Plugin } from './P1Plugin.js';
+export { createP1Overrides } from './createP1Overrides.js';
+export { createMergePreviewPlugin } from './mergePreviewPlugin.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/editor/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/editor/plugin/mergePreviewPlugin.d.ts

@@ -0,0 +1,9 @@
+import type { PuckPlugin } from './P1Plugin.js';
+export interface MergePreviewPluginOptions {
+    /** Puck configuration for rendering components. */
+    config: any;
+    /** Callback when a document is selected. */
+    onDocumentSelect?: (documentId: string) => void;
+}
+export declare function createMergePreviewPlugin(options: MergePreviewPluginOptions): PuckPlugin;
+//# sourceMappingURL=mergePreviewPlugin.d.ts.map

package/dist/editor/plugin/mergePreviewPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergePreviewPlugin.d.ts","sourceRoot":"","sources":["../../../src/editor/plugin/mergePreviewPlugin.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKhD,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IAEnD,MAAM,EAAE,GAAG,CAAC;IAEZ,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAyDD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,UAAU,CAYZ"}

package/dist/editor/plugin/mergePreviewPlugin.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MergePreviewPanel } from '../components/merge-preview/MergePreviewPanel.js';
+import { useMergePreview } from '../useMergePreview.js';
+import { MergePreviewIcon } from '../icons/MergePreviewIcon.js';
+function ConnectedMergePreviewPanel({ config, onDocumentSelect, }) {
+    const { documents, loading, error, sourceBranchName, targetBranchName, isMainBranch } = useMergePreview();
+    if (isMainBranch) {
+        return (_jsxs("div", { className: "merge-preview-panel", children: [_jsx("h3", { className: "merge-preview-panel__title", children: "Merge preview" }), _jsx("p", { className: "merge-preview-panel__empty", children: "Switch to a workstream to preview changes before merging." })] }));
+    }
+    if (loading) {
+        return (_jsxs("div", { className: "merge-preview-panel", children: [_jsx("h3", { className: "merge-preview-panel__title", children: "Merge preview" }), _jsx("p", { className: "merge-preview-panel__loading", children: "Loading comparison\u2026" })] }));
+    }
+    if (error) {
+        return (_jsxs("div", { className: "merge-preview-panel", children: [_jsx("h3", { className: "merge-preview-panel__title", children: "Merge preview" }), _jsxs("p", { className: "merge-preview-panel__error", children: ["Failed to load comparison: ", error.message] })] }));
+    }
+    return (_jsx(MergePreviewPanel, { documents: documents, sourceBranchName: sourceBranchName, targetBranchName: targetBranchName, config: config, onDocumentSelect: onDocumentSelect }));
+}
+export function createMergePreviewPlugin(options) {
+    return {
+        name: 'merge-preview',
+        label: 'Merge Preview',
+        icon: _jsx(MergePreviewIcon, {}),
+        render: () => (_jsx(ConnectedMergePreviewPanel, { config: options.config, onDocumentSelect: options.onDocumentSelect })),
+    };
+}
+//# sourceMappingURL=mergePreviewPlugin.js.map

package/dist/editor/plugin/mergePreviewPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergePreviewPlugin.js","sourceRoot":"","sources":["../../../src/editor/plugin/mergePreviewPlugin.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAiBhE,SAAS,0BAA0B,CAAC,EAClC,MAAM,EACN,gBAAgB,GACgB;IAChC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,GACnF,eAAe,EAAE,CAAC;IAEpB,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CACL,eAAK,SAAS,EAAC,qBAAqB,aAClC,aAAI,SAAS,EAAC,4BAA4B,8BAAmB,EAC7D,YAAG,SAAS,EAAC,4BAA4B,0EAErC,IACA,CACP,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CACL,eAAK,SAAS,EAAC,qBAAqB,aAClC,aAAI,SAAS,EAAC,4BAA4B,8BAAmB,EAC7D,YAAG,SAAS,EAAC,8BAA8B,yCAAwB,IAC/D,CACP,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CACL,eAAK,SAAS,EAAC,qBAAqB,aAClC,aAAI,SAAS,EAAC,4BAA4B,8BAAmB,EAC7D,aAAG,SAAS,EAAC,4BAA4B,4CACX,KAAK,CAAC,OAAO,IACvC,IACA,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,iBAAiB,IAChB,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,gBAAgB,EAClC,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,gBAAgB,GAClC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAkC;IAElC,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,KAAC,gBAAgB,KAAG;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,0BAA0B,IACzB,MAAM,EAAE,OAAO,CAAC,MAAM,EACtB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,GAC1C,CACH;KACF,CAAC;AACJ,CAAC"}

package/dist/editor/presets.d.ts

@@ -0,0 +1,8 @@
+import type { P1FeaturePlugin } from '../core/plugin-types.js';
+import type { P1FeatureConfig } from '../core/featureConfig.js';
+export interface P1Preset {
+    plugins: P1FeaturePlugin[];
+    config: Required<P1FeatureConfig>;
+}
+export declare function createDefaultPreset(additionalPlugins?: P1FeaturePlugin[], configOverrides?: P1FeatureConfig): P1Preset;
+//# sourceMappingURL=presets.d.ts.map

package/dist/editor/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/editor/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAIhE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;CACnC;AAED,wBAAgB,mBAAmB,CACjC,iBAAiB,CAAC,EAAE,eAAe,EAAE,EACrC,eAAe,CAAC,EAAE,eAAe,GAChC,QAAQ,CAqBV"}

package/dist/editor/presets.js

@@ -0,0 +1,24 @@
+import { resolveFeatureConfig } from '../core/featureConfig.js';
+import { DEFAULT_CSS_FEATURE_PLUGINS } from './defaultPlugins.js';
+export function createDefaultPreset(additionalPlugins, configOverrides) {
+    const baseConfig = {
+        enableRealtime: true,
+        presenceEnabled: true,
+        agentModeEnabled: true,
+        enableDocumentBrowser: true,
+        enableBranchSelector: true,
+        enableVersionHistory: true,
+        enableMergeControl: true,
+        enableAutoSave: true,
+        enablePublishButton: true,
+        enableCollaboratorAvatars: true,
+        enableAgentBanner: true,
+        enableFocusHighlighting: true,
+        ...configOverrides,
+    };
+    return {
+        plugins: [...DEFAULT_CSS_FEATURE_PLUGINS, ...(additionalPlugins ?? [])],
+        config: resolveFeatureConfig(baseConfig),
+    };
+}
+//# sourceMappingURL=presets.js.map

package/dist/editor/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/editor/presets.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAOlE,MAAM,UAAU,mBAAmB,CACjC,iBAAqC,EACrC,eAAiC;IAEjC,MAAM,UAAU,GAAoB;QAClC,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,qBAAqB,EAAE,IAAI;QAC3B,oBAAoB,EAAE,IAAI;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,IAAI;QACpB,mBAAmB,EAAE,IAAI;QACzB,yBAAyB,EAAE,IAAI;QAC/B,iBAAiB,EAAE,IAAI;QACvB,uBAAuB,EAAE,IAAI;QAC7B,GAAG,eAAe;KACnB,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,2BAA2B,EAAE,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QACvE,MAAM,EAAE,oBAAoB,CAAC,UAAU,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/editor/useAutoSave.d.ts

@@ -0,0 +1,37 @@
+/**
+ * useAutoSave Hook
+ *
+ * Provides auto-save functionality with debouncing and retry logic.
+ */
+import type { P1Client } from '@pantheon-systems/css-client';
+import type { UseAutoSaveOptions, UseAutoSaveReturn } from '../core/types.js';
+interface UseAutoSaveParams {
+    client: P1Client;
+    siteId: string;
+    branchId: string;
+    documentId: string;
+    options?: UseAutoSaveOptions;
+}
+/**
+ * Hook for auto-saving Puck data with debouncing and retry logic.
+ *
+ * @param params - Configuration for auto-save
+ * @returns Auto-save state and controls
+ *
+ * @example
+ * ```tsx
+ * const { save, status, lastSaved } = useAutoSave({
+ *   client,
+ *   siteId,
+ *   branchId,
+ *   documentId,
+ *   options: { debounceMs: 3000 },
+ * });
+ *
+ * // In Puck onChange handler
+ * <Puck onChange={(data) => save(data)} />
+ * ```
+ */
+export declare function useAutoSave({ client, siteId, branchId, documentId, options, }: UseAutoSaveParams): UseAutoSaveReturn;
+export {};
+//# sourceMappingURL=useAutoSave.d.ts.map

package/dist/editor/useAutoSave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoSave.d.ts","sourceRoot":"","sources":["../../src/editor/useAutoSave.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAc,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1F,UAAU,iBAAiB;IACzB,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,UAAU,EACV,OAAY,GACb,EAAE,iBAAiB,GAAG,iBAAiB,CA4GvC"}

package/dist/editor/useAutoSave.js

@@ -0,0 +1,118 @@
+/**
+ * useAutoSave Hook
+ *
+ * Provides auto-save functionality with debouncing and retry logic.
+ */
+import { useState, useRef, useCallback, useEffect } from 'react';
+import { debounce } from '../core/utils/debounce.js';
+import { withRetry } from '../core/utils/retry.js';
+/**
+ * Hook for auto-saving Puck data with debouncing and retry logic.
+ *
+ * @param params - Configuration for auto-save
+ * @returns Auto-save state and controls
+ *
+ * @example
+ * ```tsx
+ * const { save, status, lastSaved } = useAutoSave({
+ *   client,
+ *   siteId,
+ *   branchId,
+ *   documentId,
+ *   options: { debounceMs: 3000 },
+ * });
+ *
+ * // In Puck onChange handler
+ * <Puck onChange={(data) => save(data)} />
+ * ```
+ */
+export function useAutoSave({ client, siteId, branchId, documentId, options = {}, }) {
+    const { debounceMs = 3000, maxRetries = 3, onSaveStart, onSaveSuccess, onSaveError, } = options;
+    const [status, setStatus] = useState('idle');
+    const [lastSaved, setLastSaved] = useState(null);
+    const [error, setError] = useState(null);
+    const [isDirty, setIsDirty] = useState(false);
+    // Store the latest data for saving
+    const pendingDataRef = useRef(null);
+    const isSavingRef = useRef(false);
+    // Core save function
+    const performSave = useCallback(async () => {
+        const dataToSave = pendingDataRef.current;
+        if (!dataToSave || isSavingRef.current) {
+            return;
+        }
+        isSavingRef.current = true;
+        setStatus('saving');
+        setError(null);
+        onSaveStart?.();
+        try {
+            await withRetry(async () => {
+                await client.versions.create(siteId, {
+                    documentId,
+                    branchId,
+                    snapshot: dataToSave,
+                });
+            }, {
+                maxAttempts: maxRetries,
+                baseDelayMs: 1000,
+                shouldRetry: (err) => {
+                    // Don't retry on validation errors
+                    if ('status' in err && err.status === 400) {
+                        return false;
+                    }
+                    return true;
+                },
+            });
+            pendingDataRef.current = null;
+            setStatus('saved');
+            setLastSaved(new Date());
+            setIsDirty(false);
+            onSaveSuccess?.();
+        }
+        catch (err) {
+            const saveError = err instanceof Error ? err : new Error(String(err));
+            setStatus('error');
+            setError(saveError);
+            onSaveError?.(saveError);
+        }
+        finally {
+            isSavingRef.current = false;
+        }
+    }, [client, siteId, branchId, documentId, maxRetries, onSaveStart, onSaveSuccess, onSaveError]);
+    // Create debounced save function
+    const debouncedSaveRef = useRef(null);
+    useEffect(() => {
+        debouncedSaveRef.current = debounce(() => {
+            void performSave();
+        }, debounceMs);
+        return () => {
+            debouncedSaveRef.current?.cancel();
+        };
+    }, [performSave, debounceMs]);
+    // Public save function (debounced)
+    const save = useCallback((data) => {
+        pendingDataRef.current = data;
+        setIsDirty(true);
+        debouncedSaveRef.current?.();
+    }, []);
+    // Force immediate save
+    const saveNow = useCallback(async () => {
+        debouncedSaveRef.current?.cancel();
+        await performSave();
+    }, [performSave]);
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            debouncedSaveRef.current?.cancel();
+        };
+    }, []);
+    return {
+        save,
+        saveNow,
+        status,
+        lastSaved,
+        error,
+        isDirty,
+    };
+}
+//# sourceMappingURL=useAutoSave.js.map

package/dist/editor/useAutoSave.js.map

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

package/dist/editor/useBranches.d.ts

@@ -0,0 +1,67 @@
+/**
+ * useBranches Hook
+ *
+ * Provides branch management functionality.
+ */
+import type { Branch } from '@pantheon-systems/css-client';
+import type { P1Client } from '@pantheon-systems/css-client';
+interface UseBranchesParams {
+    client: P1Client;
+    siteId: string;
+    initialBranchId: string;
+}
+interface UseBranchesReturn {
+    /**
+     * List of all branches for the site.
+     */
+    branches: Branch[];
+    /**
+     * Currently selected branch.
+     */
+    currentBranch: Branch | null;
+    /**
+     * Current branch ID.
+     */
+    branchId: string;
+    /**
+     * Loading state.
+     */
+    loading: boolean;
+    /**
+     * Error state.
+     */
+    error: Error | null;
+    /**
+     * Switch to a different branch.
+     */
+    switchBranch: (branchId: string) => Promise<void>;
+    /**
+     * Refresh the branches list.
+     */
+    refresh: () => Promise<void>;
+    /**
+     * Get main branch.
+     */
+    mainBranch: Branch | null;
+}
+/**
+ * Hook for managing branches.
+ *
+ * @param params - Configuration for branch management
+ * @returns Branch state and operations
+ *
+ * @example
+ * ```tsx
+ * const { branches, currentBranch, switchBranch } = useBranches({
+ *   client,
+ *   siteId,
+ *   initialBranchId,
+ * });
+ *
+ * // Switch to a different branch
+ * await switchBranch(otherBranchId);
+ * ```
+ */
+export declare function useBranches({ client, siteId, initialBranchId, }: UseBranchesParams): UseBranchesReturn;
+export {};
+//# sourceMappingURL=useBranches.d.ts.map

package/dist/editor/useBranches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBranches.d.ts","sourceRoot":"","sources":["../../src/editor/useBranches.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,UAAU,iBAAiB;IACzB,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,iBAAiB;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,MAAM,EACN,eAAe,GAChB,EAAE,iBAAiB,GAAG,iBAAiB,CA6DvC"}

package/dist/editor/useBranches.js

@@ -0,0 +1,78 @@
+/**
+ * useBranches Hook
+ *
+ * Provides branch management functionality.
+ */
+import { useState, useCallback, useEffect } from 'react';
+/**
+ * Hook for managing branches.
+ *
+ * @param params - Configuration for branch management
+ * @returns Branch state and operations
+ *
+ * @example
+ * ```tsx
+ * const { branches, currentBranch, switchBranch } = useBranches({
+ *   client,
+ *   siteId,
+ *   initialBranchId,
+ * });
+ *
+ * // Switch to a different branch
+ * await switchBranch(otherBranchId);
+ * ```
+ */
+export function useBranches({ client, siteId, initialBranchId, }) {
+    const [branches, setBranches] = useState([]);
+    const [branchId, setBranchId] = useState(initialBranchId);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    // Fetch branches
+    const refresh = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            const branchList = await client.branches.list(siteId);
+            setBranches(branchList.filter((b) => b.isMain || b.status === 'active'));
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client, siteId]);
+    // Initial fetch
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    // Get current branch object
+    const currentBranch = branches.find((b) => b.id === branchId) ?? null;
+    // Get main branch
+    const mainBranch = branches.find((b) => b.isMain) ?? null;
+    // Switch branch
+    const switchBranch = useCallback(async (newBranchId) => {
+        // Verify the branch exists
+        const branch = branches.find((b) => b.id === newBranchId);
+        if (!branch) {
+            // Try refreshing first
+            await refresh();
+            const refreshedBranch = branches.find((b) => b.id === newBranchId);
+            if (!refreshedBranch) {
+                throw new Error(`Branch not found: ${newBranchId}`);
+            }
+        }
+        setBranchId(newBranchId);
+    }, [branches, refresh]);
+    return {
+        branches,
+        currentBranch,
+        branchId,
+        loading,
+        error,
+        switchBranch,
+        refresh,
+        mainBranch,
+    };
+}
+//# sourceMappingURL=useBranches.js.map

package/dist/editor/useBranches.js.map

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

package/dist/editor/useComponentRegistry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * useComponentRegistry Hook
+ *
+ * Runs at editor startup to serialise the Puck config into ComponentDescriptor
+ * objects, hash-checks them for changes, and writes updated descriptors to CSS
+ * documents under the /_registry/ path prefix.
+ *
+ * Uses the same P1PuckContext pattern as useVersions, useAutoSave, and useDocuments.
+ */
+export interface RegistrationResult {
+    registered: number;
+    skipped: number;
+    total: number;
+}
+export interface UseComponentRegistryOptions {
+    /** Puck config to register. Pass the same object as <Puck config={...} /> */
+    puckConfig: unknown;
+    /** Optional upstream Puck config for provenance classification */
+    upstreamPuckConfig?: unknown;
+    /** Called when registration completes (or is a full no-op) */
+    onRegistered?: (result: RegistrationResult) => void;
+    /** Called if registration fails */
+    onError?: (error: Error) => void;
+}
+export interface UseComponentRegistryReturn {
+    status: 'idle' | 'registering' | 'registered' | 'error';
+    result: RegistrationResult | null;
+    error: Error | null;
+}
+export declare function useComponentRegistry(options: UseComponentRegistryOptions): UseComponentRegistryReturn;
+//# sourceMappingURL=useComponentRegistry.d.ts.map

package/dist/editor/useComponentRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComponentRegistry.d.ts","sourceRoot":"","sources":["../../src/editor/useComponentRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,UAAU,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACpD,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,YAAY,GAAG,OAAO,CAAC;IACxD,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAqND,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,0BAA0B,CAuD5B"}