@pantheon-systems/puck-css 0.7.0 → 0.9.0

package/dist/editor/plugin/context-sync-key.d.ts

@@ -0,0 +1,30 @@
+import { type DocumentSyncStore } from "./document-sync-plugin.js";
+export interface ContextSyncKeyInput {
+    remoteSyncKey: string | null;
+    viewingVersion: {
+        id: string;
+    } | null;
+    currentDocument: {
+        id: string;
+    } | null;
+    branchId?: string | null;
+    /** Omitted by consumers that drive Puck without the document-sync plugin. */
+    documentSyncStore?: Pick<DocumentSyncStore, "getAppliedKey">;
+}
+/**
+ * Sync key ContextSyncBridge should push into Puck, or null to push nothing.
+ *
+ * Two mechanisms can replace the whole canvas: this one (a `setData` dispatch)
+ * and the document-sync plugin (`setHistories`, which also resets the undo
+ * stack). Since Puck now survives document switches, the plugin owns
+ * document -> document transitions; this bridge stands down for them. Its
+ * dispatch would otherwise land first — before the plugin advances the applied
+ * key — and trip useP1Editor's write-back guard on every page switch, burying
+ * the real races that warning is there to surface.
+ *
+ * The doc-latest key still matters when the canvas already shows the document:
+ * returning to latest from a historical version reaches this path, and nothing
+ * else restores the live data.
+ */
+export declare function resolveContextSyncKey({ remoteSyncKey, viewingVersion, currentDocument, branchId, documentSyncStore, }: ContextSyncKeyInput): string | null;
+//# sourceMappingURL=context-sync-key.d.ts.map

package/dist/editor/plugin/context-sync-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-sync-key.d.ts","sourceRoot":"","sources":["../../../src/editor/plugin/context-sync-key.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEpF,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;CAC9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,aAAa,EACb,cAAc,EACd,eAAe,EACf,QAAQ,EACR,iBAAiB,GAClB,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAkBrC"}

package/dist/editor/plugin/context-sync-key.js

@@ -0,0 +1,36 @@
+"use client";
+import { documentSyncKey } from "./document-sync-plugin.js";
+/**
+ * Sync key ContextSyncBridge should push into Puck, or null to push nothing.
+ *
+ * Two mechanisms can replace the whole canvas: this one (a `setData` dispatch)
+ * and the document-sync plugin (`setHistories`, which also resets the undo
+ * stack). Since Puck now survives document switches, the plugin owns
+ * document -> document transitions; this bridge stands down for them. Its
+ * dispatch would otherwise land first — before the plugin advances the applied
+ * key — and trip useP1Editor's write-back guard on every page switch, burying
+ * the real races that warning is there to surface.
+ *
+ * The doc-latest key still matters when the canvas already shows the document:
+ * returning to latest from a historical version reaches this path, and nothing
+ * else restores the live data.
+ */
+export function resolveContextSyncKey({ remoteSyncKey, viewingVersion, currentDocument, branchId, documentSyncStore, }) {
+    if (remoteSyncKey)
+        return remoteSyncKey;
+    if (viewingVersion)
+        return `version-${viewingVersion.id}`;
+    if (!currentDocument)
+        return null;
+    if (documentSyncStore) {
+        const appliedKey = documentSyncStore.getAppliedKey();
+        // A null applied key means the plugin has not observed a document yet, so
+        // Puck was mounted with this one and there is no switch to defer to.
+        if (appliedKey !== null &&
+            appliedKey !== documentSyncKey(branchId, currentDocument.id)) {
+            return null;
+        }
+    }
+    return `doc-${currentDocument.id}-latest`;
+}
+//# sourceMappingURL=context-sync-key.js.map

package/dist/editor/plugin/context-sync-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-sync-key.js","sourceRoot":"","sources":["../../../src/editor/plugin/context-sync-key.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,eAAe,EAA0B,MAAM,2BAA2B,CAAC;AAWpF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,aAAa,EACb,cAAc,EACd,eAAe,EACf,QAAQ,EACR,iBAAiB,GACG;IACpB,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,IAAI,cAAc;QAAE,OAAO,WAAW,cAAc,CAAC,EAAE,EAAE,CAAC;IAC1D,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAElC,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,iBAAiB,CAAC,aAAa,EAAE,CAAC;QACrD,0EAA0E;QAC1E,qEAAqE;QACrE,IACE,UAAU,KAAK,IAAI;YACnB,UAAU,KAAK,eAAe,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,CAAC,EAC5D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,OAAO,eAAe,CAAC,EAAE,SAAS,CAAC;AAC5C,CAAC"}

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

@@ -7,13 +7,8 @@
 import React from 'react';
 import type { Checkpoint, DocumentVersion, PuckData, ActorPresence } from '@pantheon-systems/css-client';
 import type { SaveStatus } from '../../core/types.js';
-import type { TemplateSummary } from '../../features/content-type-templates/types.js';
-/**
- * Resolve the template being edited from a document path. Templates are stored
- * as documents at `_registry/templates/<name>`; returns the matching template
- * (by name) or null for ordinary pages.
- */
-export declare function templateFromRegistryPath(path: string | undefined | null, templates: TemplateSummary[] | undefined): TemplateSummary | null;
+export { templateFromRegistryPath } from '../utils/templatePath.js';
+export { P1TemplateFields } from '../components/P1TemplateFields.js';
 /**
  * Options for creating P1 overrides
  */
@@ -69,18 +64,25 @@ export interface P1OverridesOptions {
     onPublishError?: (error: Error) => void;
     /** Whether to show the default Puck publish button */
     showDefaultPublish?: boolean;
+    /** Whether currently viewing a historical version of a document */
+    isViewingHistoricalVersion?: boolean;
+    /** The historical version being previewed. */
+    viewingVersion?: DocumentVersion | null;
     /**
-     * Whether currently viewing a historical version (not the latest).
+     * Callback to exit version preview and return to the latest version.
+     * Wired to the "Back to current version" button in the components/outline overlays.
      */
-    isViewingHistoricalVersion?: boolean;
+    onReturnToLatest?: () => void;
     /**
-     * The historical version being viewed.
+     * @deprecated Pass to VersionBannerOverride instead. The banner is no longer
+     * rendered by createP1Overrides; this prop is silently ignored.
      */
-    viewingVersion?: DocumentVersion | null;
+    onRestoreVersion?: (version: DocumentVersion) => Promise<void>;
     /**
-     * Callback to return to the latest version.
+     * @deprecated Pass to VersionBannerOverride instead. The banner is no longer
+     * rendered by createP1Overrides; this prop is silently ignored.
      */
-    onReturnToLatest?: () => void;
+    canRevert?: boolean;
     /**
      * @deprecated Pass syncData to createP1Plugin instead. The plugin renders
      * inside Puck's context where usePuck() works correctly. Passing these props
@@ -123,46 +125,27 @@ export interface PuckOverrides {
     }) => React.ReactElement;
     [key: string]: unknown;
 }
+interface FieldLabelOverrideProps {
+    children?: React.ReactNode;
+    icon?: React.ReactNode;
+    label: string;
+    el?: 'label' | 'div';
+    readOnly?: boolean;
+}
 /**
- * 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,
- *   });
+ * Renders an opted-in field group's label row as a disclosure. Puck hands a
+ * label override the field's content as `children`, so the group's own label
+ * becomes the toggle — there is no second header and nothing to suppress.
  *
- *   // Legacy: direct values (causes overrides to be recreated on changes)
- *   const overrides = createP1Overrides({
- *     saveStatus,
- *     lastSaved,
- *     saveError,
- *     onRetrySave: saveNow,
- *   });
+ * The context is cleared for descendants so a nested group inside a collapsible
+ * one keeps its ordinary label.
  *
- *   return <Puck overrides={overrides} {...otherProps} />;
- * }
- * ```
+ * Ordinary field labels drop Puck's field-type icon. Its select variant is a
+ * chevron, the same glyph the disclosure above uses, so it reads as a group that
+ * expands and then does nothing. The label already says what the field is, and
+ * the narrow inspector would rather have the space. The read-only lock is a
+ * separate slot and survives.
  */
+export declare function P1FieldLabel(props: FieldLabelOverrideProps): React.ReactElement;
 export declare function createP1Overrides(options: P1OverridesOptions): PuckOverrides;
 //# sourceMappingURL=createP1Overrides.d.ts.map

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

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

package/dist/editor/plugin/createP1Overrides.js

@@ -1,121 +1,49 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { ActionBar, createUsePuck, usePuck } from '@puckeditor/core';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * P1 Puck Overrides
+ *
+ * Creates Puck overrides for P1 integration, including
+ * header actions for save status and publish functionality.
+ */
+import React from 'react';
+import { ActionBar, FieldLabel } from '@puckeditor/core';
 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';
 import { ActionBarPinButton } from '../../features/content-type-templates/ui/ActionBarPinButton.js';
-import { TemplateDetailsPanel } from '../../features/content-type-templates/ui/TemplateDetailsPanel.js';
-import { useP1PuckOptional } from '../../core/P1PuckContext.js';
+import { P1InspectorFields } from '../components/P1InspectorFields.js';
+import { CollapsibleFieldSection } from '../components/CollapsibleFieldSection.js';
+import { CollapsibleFieldContext } from '../components/collapsibleSectionContext.js';
+import { OutlinePanel } from '../components/OutlinePanel.js';
+import { fieldGuidanceFieldTypes } from './fieldGuidance.js';
 // NOTE: PuckDataSynchronizer is NOT imported here - it's used in P1Plugin instead
 // because headerActions renders outside Puck's context where usePuck() doesn't work.
-// Module-level usePuck hook for reading the current selection inside the fields override.
-const useOverridesPuck = createUsePuck();
-/**
- * Resolve the template being edited from a document path. Templates are stored
- * as documents at `_registry/templates/<name>`; returns the matching template
- * (by name) or null for ordinary pages.
- */
-export function templateFromRegistryPath(path, templates) {
-    if (!path || !templates)
-        return null;
-    const match = path.match(/^_registry\/templates\/(.+)$/);
-    if (!match)
-        return null;
-    return templates.find((t) => t.name === match[1]) ?? null;
-}
-/**
- * Right-sidebar fields override. In template mode (editing a template document)
- * with the root selected, it replaces the default "Page" root fields with the
- * "Template" details panel (Label / Description / URL pattern). Otherwise it
- * renders Puck's default fields unchanged.
- */
-function P1TemplateFields({ children }) {
-    const css = useP1PuckOptional();
-    const itemSelector = useOverridesPuck((s) => s.appState?.ui?.itemSelector);
-    const { dispatch } = usePuck();
-    const template = templateFromRegistryPath(css?.currentDocument?.path, css?.templates);
-    // Only override the ROOT fields (nothing selected) while editing a template.
-    if (template && !itemSelector && css?.updateTemplate) {
-        const updateTemplate = css.updateTemplate;
-        return (_jsx(TemplateDetailsPanel, { template: template, onSave: async (details) => {
-                // Metadata-only PATCH; the layout is persisted by the canvas autosave.
-                await updateTemplate(template.id, {
-                    label: details.label,
-                    description: details.description,
-                    defaultUrlPattern: details.defaultUrlPattern,
-                });
-                // Mirror the saved metadata into the live Puck root props
-                // (root.props._template) so the canvas autosave writes the same
-                // metadata the PATCH persisted.
-                dispatch({
-                    type: 'setData',
-                    data: (prev) => {
-                        const root = (prev.root ?? {});
-                        const props = (root.props ?? {});
-                        return {
-                            ...prev,
-                            root: {
-                                ...root,
-                                props: {
-                                    ...props,
-                                    _template: {
-                                        ...(props._template ?? {}),
-                                        label: details.label,
-                                        description: details.description,
-                                        defaultUrlPattern: details.defaultUrlPattern,
-                                    },
-                                },
-                            },
-                        };
-                    },
-                });
-            } }));
-    }
-    return _jsx(_Fragment, { children: children });
-}
+// Re-exported for backwards compatibility — implementation lives in utils/templatePath.ts.
+export { templateFromRegistryPath } from '../utils/templatePath.js';
+// Re-exported for backwards compatibility — implementation lives in components/P1TemplateFields.tsx.
+export { P1TemplateFields } from '../components/P1TemplateFields.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]);
+ * Renders an opted-in field group's label row as a disclosure. Puck hands a
+ * label override the field's content as `children`, so the group's own label
+ * becomes the toggle — there is no second header and nothing to suppress.
  *
- *   const overrides = createP1Overrides({
- *     getSaveStatus: () => saveStatusRef.current,
- *     getLastSaved: () => lastSavedRef.current,
- *     getSaveError: () => saveErrorRef.current,
- *     onRetrySave: saveNow,
- *   });
+ * The context is cleared for descendants so a nested group inside a collapsible
+ * one keeps its ordinary label.
  *
- *   // Legacy: direct values (causes overrides to be recreated on changes)
- *   const overrides = createP1Overrides({
- *     saveStatus,
- *     lastSaved,
- *     saveError,
- *     onRetrySave: saveNow,
- *   });
- *
- *   return <Puck overrides={overrides} {...otherProps} />;
- * }
- * ```
+ * Ordinary field labels drop Puck's field-type icon. Its select variant is a
+ * chevron, the same glyph the disclosure above uses, so it reads as a group that
+ * expands and then does nothing. The label already says what the field is, and
+ * the narrow inspector would rather have the space. The read-only lock is a
+ * separate slot and survives.
  */
+export function P1FieldLabel(props) {
+    const collapsible = React.useContext(CollapsibleFieldContext);
+    if (collapsible && props.el === 'div') {
+        return (_jsx(CollapsibleFieldContext.Provider, { value: null, children: _jsx(CollapsibleFieldSection, { label: props.label, defaultCollapsed: collapsible.defaultCollapsed, count: collapsible.count, children: props.children }) }));
+    }
+    return _jsx(FieldLabel, { ...props, icon: undefined });
+}
 export function createP1Overrides(options) {
     const { 
     // New getter-based API (preferred)
@@ -125,7 +53,7 @@ export function createP1Overrides(options) {
     // Common options
     onRetrySave, showDefaultPublish = false, 
     // Deprecated props - kept for type signature compatibility but ignored
-    syncData: _syncData, dataSyncKey: _dataSyncKey,
+    syncData: _syncData, dataSyncKey: _dataSyncKey, onRestoreVersion: _onRestoreVersion, canRevert: _canRevert,
     // 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.
@@ -134,6 +62,8 @@ export function createP1Overrides(options) {
     // Suppress unused variable warnings for deprecated props
     void _syncData;
     void _dataSyncKey;
+    void _onRestoreVersion;
+    void _canRevert;
     // 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
@@ -152,7 +82,21 @@ export function createP1Overrides(options) {
         };
     return {
         actionBar: ({ label, children }) => (_jsxs(ActionBar, { label: label, children: [children, _jsx(ActionBarPinButton, {})] })),
-        fields: ({ children }) => (_jsx(P1TemplateFields, { children: children })),
+        fields: ({ children }) => (_jsx(P1InspectorFields, { children: children })),
+        fieldLabel: P1FieldLabel,
+        fieldTypes: {
+            ...fieldGuidanceFieldTypes,
+            // Marks an opted-in object field for P1FieldLabel, which owns the rendering
+            // because it is the only override that receives the label. Object fields
+            // without `metadata.collapsible` pass through untouched.
+            object: ({ field, children, }) => field.metadata?.collapsible ? (_jsx(CollapsibleFieldContext.Provider, { value: {
+                    defaultCollapsed: field.metadata.defaultCollapsed,
+                    // Derived from the resolved field set, so omitting a field — how
+                    // role gating will hide one — moves the count with it.
+                    count: Object.keys(field.objectFields ?? {}).length,
+                }, children: children })) : (_jsx(_Fragment, { children: children })),
+        },
+        outline: () => _jsx(OutlinePanel, {}),
         headerActions: ({ children }) => {
             // Read presence/agent values lazily from options (Proxy) each render
             // so they reflect the latest state from useP1Overrides' optionsRef.
@@ -164,12 +108,10 @@ export function createP1Overrides(options) {
             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] }));
+            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 && (_jsxs(_Fragment, { children: [_showSaveIndicator && _jsx(SaveIndicator, { ...saveIndicatorProps }), _publishedStatus && (_jsx(PublishedStatusBadge, { status: _publishedStatus }))] })), showDefaultPublish && children] }));
         },
     };
 }

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

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

package/dist/editor/plugin/document-sync-plugin.d.ts

@@ -0,0 +1,35 @@
+import type { Plugin } from "@puckeditor/core";
+import type { PuckData } from "@pantheon-systems/css-client";
+export interface DocumentSyncSnapshot {
+    /** Identity of the loaded document (e.g. `${branchId}:${documentId}`) */
+    syncKey: string | null;
+    data: PuckData | null;
+}
+export interface DocumentSyncStore {
+    publish(snapshot: DocumentSyncSnapshot): void;
+    subscribe(onChange: VoidFunction): VoidFunction;
+    getSnapshot(): DocumentSyncSnapshot;
+    /** Records which document the Puck canvas currently shows; null before the first */
+    markApplied(syncKey: string | null): void;
+    /** Sync key of the document the canvas shows, or null before the first one */
+    getAppliedKey(): string | null;
+}
+/**
+ * Sync-key format for a loaded document. Shared so the publisher
+ * (useP1Editor) and readers of the applied key (ContextSyncBridge, the
+ * write-back guard) can never disagree about what identifies a document.
+ */
+export declare function documentSyncKey(branchId: string | null | undefined, documentId: string): string;
+/**
+ * Guarantee a complete PuckData shape before handing data to Puck. Puck's
+ * walkAppState reads data.root.props while rebuilding indexes, so a page whose
+ * root or content hasn't settled yet (as can happen mid document-switch) would
+ * otherwise crash with "Cannot read properties of undefined (reading 'props')".
+ * Settled data passes through by reference unchanged; a non-object (a bug
+ * upstream — data should already be parsed) collapses to a blank page rather
+ * than being spread character-by-character.
+ */
+export declare function normalizeSyncData(data: PuckData): PuckData;
+export declare function createDocumentSyncStore(): DocumentSyncStore;
+export declare function createDocumentSyncPlugin(store: DocumentSyncStore): Plugin;
+//# sourceMappingURL=document-sync-plugin.d.ts.map

package/dist/editor/plugin/document-sync-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-sync-plugin.d.ts","sourceRoot":"","sources":["../../../src/editor/plugin/document-sync-plugin.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC9C,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAAC;IAChD,WAAW,IAAI,oBAAoB,CAAC;IACpC,oFAAoF;IACpF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1C,8EAA8E;IAC9E,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;CAChC;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAW1D;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAwB3D;AAwED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAYzE"}

package/dist/editor/plugin/document-sync-plugin.js

@@ -0,0 +1,130 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Document-sync plugin
+ *
+ * Lets a single mounted <Puck> instance follow document switches instead of
+ * being remounted via a React key (which tears down the preview iframe and
+ * re-parses all canvas styles). useP1Editor publishes the freshly loaded
+ * document into a DocumentSyncStore; a headless component inside the Puck
+ * tree picks it up and replaces editor state through the history API.
+ *
+ * A single history.setHistories([{ state }]) call does everything atomically:
+ * it dispatches the new state into Puck and replaces the undo stack, so
+ * undo can never resurrect the previous document. The state passed omits
+ * `indexes` on purpose — Puck's set action only re-runs walkAppState (which
+ * rebuilds the node/zone indexes for the new content) when indexes are absent.
+ */
+import { useEffect, useSyncExternalStore } from "react";
+import { useGetPuck } from "@puckeditor/core";
+const EMPTY_SNAPSHOT = { syncKey: null, data: null };
+/**
+ * Sync-key format for a loaded document. Shared so the publisher
+ * (useP1Editor) and readers of the applied key (ContextSyncBridge, the
+ * write-back guard) can never disagree about what identifies a document.
+ */
+export function documentSyncKey(branchId, documentId) {
+    return `${branchId ?? ""}:${documentId}`;
+}
+/**
+ * Guarantee a complete PuckData shape before handing data to Puck. Puck's
+ * walkAppState reads data.root.props while rebuilding indexes, so a page whose
+ * root or content hasn't settled yet (as can happen mid document-switch) would
+ * otherwise crash with "Cannot read properties of undefined (reading 'props')".
+ * Settled data passes through by reference unchanged; a non-object (a bug
+ * upstream — data should already be parsed) collapses to a blank page rather
+ * than being spread character-by-character.
+ */
+export function normalizeSyncData(data) {
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        return { content: [], root: { props: {} } };
+    }
+    if (data.content && data.root?.props)
+        return data;
+    const root = data.root ?? { props: {} };
+    return {
+        ...data,
+        content: data.content ?? [],
+        root: { ...root, props: root.props ?? {} },
+    };
+}
+export function createDocumentSyncStore() {
+    let snapshot = EMPTY_SNAPSHOT;
+    let appliedKey = null;
+    const listeners = new Set();
+    return {
+        publish(next) {
+            snapshot = next;
+            for (const listener of listeners)
+                listener();
+        },
+        subscribe(onChange) {
+            listeners.add(onChange);
+            return () => listeners.delete(onChange);
+        },
+        getSnapshot() {
+            return snapshot;
+        },
+        markApplied(syncKey) {
+            appliedKey = syncKey;
+        },
+        getAppliedKey() {
+            return appliedKey;
+        },
+    };
+}
+function DocumentSync({ store }) {
+    const snapshot = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+    // Puck state is read imperatively at push time rather than subscribed to —
+    // subscribing to appState would re-run this component on every keystroke.
+    const getPuck = useGetPuck();
+    useEffect(() => {
+        const { syncKey, data } = snapshot;
+        if (!syncKey || !data)
+            return;
+        const appliedKey = store.getAppliedKey();
+        if (appliedKey === syncKey)
+            return;
+        if (appliedKey === null) {
+            // First document observed: Puck was mounted with it, nothing to push.
+            store.markApplied(syncKey);
+            return;
+        }
+        const { appState, history } = getPuck();
+        // Omit indexes so Puck re-runs walkAppState for the new content.
+        const { indexes: _indexes, ...rest } = appState;
+        // Marked before dispatching, and rolled back if the dispatch fails. Puck's
+        // onChange is a store subscriber, so it fires synchronously inside
+        // setHistories: the echo has to find the new document already applied, or
+        // useP1Editor's write-back guard reports a race on every switch. A failed
+        // dispatch must not leave the key advanced either — the canvas would still
+        // hold the old document and the guard would wave through a save that writes
+        // it into the new one.
+        store.markApplied(syncKey);
+        try {
+            history.setHistories([
+                {
+                    state: {
+                        ...rest,
+                        data: normalizeSyncData(data),
+                        ui: { ...rest.ui, itemSelector: null },
+                    },
+                },
+            ]);
+        }
+        catch (err) {
+            store.markApplied(appliedKey);
+            throw err;
+        }
+    }, [snapshot, getPuck, store]);
+    return null;
+}
+export function createDocumentSyncPlugin(store) {
+    return {
+        name: "p1-document-sync",
+        overrides: {
+            puck: ({ children }) => (_jsxs(_Fragment, { children: [_jsx(DocumentSync, { store: store }), children] })),
+        },
+    };
+}
+//# sourceMappingURL=document-sync-plugin.js.map

package/dist/editor/plugin/document-sync-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-sync-plugin.js","sourceRoot":"","sources":["../../../src/editor/plugin/document-sync-plugin.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;GAcG;AAEH,OAAc,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAoB9C,MAAM,cAAc,GAAyB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAE3E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAmC,EACnC,UAAkB;IAElB,OAAO,GAAG,QAAQ,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACxC,OAAO;QACL,GAAG,IAAI;QACP,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;QAC3B,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,IAAI,QAAQ,GAAG,cAAc,CAAC;IAC9B,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgB,CAAC;IAE1C,OAAO;QACL,OAAO,CAAC,IAAI;YACV,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,MAAM,QAAQ,IAAI,SAAS;gBAAE,QAAQ,EAAE,CAAC;QAC/C,CAAC;QACD,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,WAAW;YACT,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,WAAW,CAAC,OAAO;YACjB,UAAU,GAAG,OAAO,CAAC;QACvB,CAAC;QACD,aAAa;YACX,OAAO,UAAU,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAoBD,SAAS,YAAY,CAAC,EAAE,KAAK,EAAgC;IAC3D,MAAM,QAAQ,GAAG,oBAAoB,CACnC,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,WAAW,CAClB,CAAC;IACF,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;QACnC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI;YAAE,OAAO;QAE9B,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,UAAU,KAAK,OAAO;YAAE,OAAO;QACnC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,sEAAsE;YACtE,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAA+B,CAAC;QACrE,iEAAiE;QACjE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;QAEhD,2EAA2E;QAC3E,mEAAmE;QACnE,0EAA0E;QAC1E,0EAA0E;QAC1E,2EAA2E;QAC3E,4EAA4E;QAC5E,uBAAuB;QACvB,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,CAAC,YAAY,CAAC;gBACnB;oBACE,KAAK,EAAE;wBACL,GAAG,IAAI;wBACP,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC;wBAC7B,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;qBACvC;iBACF;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAE/B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAwB;IAC/D,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE;YACT,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CACrD,8BACE,KAAC,YAAY,IAAC,KAAK,EAAE,KAAK,GAAI,EAC7B,QAAQ,IACR,CACJ;SACF;KACF,CAAC;AACJ,CAAC"}