@pantheon-systems/puck-css 0.8.0 → 0.10.0

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

@@ -64,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
@@ -118,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":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACzG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAYtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,UAAU,CAAC;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,KAAK,GAAG,IAAI,CAAC;IAElC;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAEzB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACpD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACxC,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;OAEG;IACH,cAAc,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,qDAAqD;IACrD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,sDAAsD;IACtD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,8BAA8B;IAC9B,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;IAC/B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,uDAAuD;IACvD,eAAe,CAAC,EAAE,WAAW,GAAG,qBAAqB,GAAG,OAAO,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IAC7E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IACxF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAuG5E"}
+{"version":3,"file":"createP1Overrides.d.ts","sourceRoot":"","sources":["../../../src/editor/plugin/createP1Overrides.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACzG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAetD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,UAAU,CAAC;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,KAAK,GAAG,IAAI,CAAC;IAElC;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAEzB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACpD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACxC,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mEAAmE;IACnE,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,qDAAqD;IACrD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,sDAAsD;IACtD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,8BAA8B;IAC9B,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;IAC/B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,uDAAuD;IACvD,eAAe,CAAC,EAAE,WAAW,GAAG,qBAAqB,GAAG,OAAO,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IAC7E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAK,KAAK,CAAC,YAAY,CAAC;IACxF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAuDD,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,uBAAuB,GAAG,KAAK,CAAC,YAAY,CAkB/E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAiI5E"}

package/dist/editor/plugin/createP1Overrides.js

@@ -1,12 +1,22 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { ActionBar } from '@puckeditor/core';
+/**
+ * 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 { 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.
 // Re-exported for backwards compatibility — implementation lives in utils/templatePath.ts.
@@ -14,46 +24,26 @@ 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';
+ * 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.
  *
- * function Editor() {
- *   const {
- *     saveStatus,
- *     lastSaved,
- *     saveError,
- *     saveNow,
- *     publishDocument,
- *   } = useP1Puck();
+ * The context is cleared for descendants so a nested group inside a collapsible
+ * one keeps its ordinary label.
  *
- *   // 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} />;
- * }
- * ```
+ * 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)
@@ -63,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.
@@ -72,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
@@ -91,6 +83,20 @@ export function createP1Overrides(options) {
     return {
         actionBar: ({ label, children }) => (_jsxs(ActionBar, { label: label, children: [children, _jsx(ActionBarPinButton, {})] })),
         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.
@@ -102,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":";AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gEAAgE,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,kFAAkF;AAClF,qFAAqF;AAErF,2FAA2F;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,qGAAqG;AACrG,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAsLrE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,KAA8B;IACzD,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAE9D,IAAI,WAAW,IAAI,KAAK,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QACtC,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAC3C,KAAC,uBAAuB,IACtB,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,EAC9C,KAAK,EAAE,WAAW,CAAC,KAAK,YAEvB,KAAK,CAAC,QAAQ,GACS,GACO,CACpC,CAAC;IACJ,CAAC;IAED,OAAO,KAAC,UAAU,OAAK,KAAK,EAAE,IAAI,EAAE,SAAS,GAAI,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM;IACJ,mCAAmC;IACnC,aAAa,EACb,YAAY,EACZ,YAAY;IACZ,0BAA0B;IAC1B,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,eAAe,EAC1B,SAAS,EAAE,eAAe;IAC1B,iBAAiB;IACjB,WAAW,EACX,kBAAkB,GAAG,KAAK;IAC1B,uEAAuE;IACvE,QAAQ,EAAE,SAAS,EACnB,WAAW,EAAE,YAAY,EACzB,gBAAgB,EAAE,iBAAiB,EACnC,SAAS,EAAE,UAAU;IACrB,mDAAmD;IACnD,4EAA4E;IAC5E,sEAAsE;IACtE,kEAAkE;MACnE,GAAG,OAAO,CAAC;IAEZ,yDAAyD;IACzD,KAAK,SAAS,CAAC;IACf,KAAK,YAAY,CAAC;IAClB,KAAK,iBAAiB,CAAC;IACvB,KAAK,UAAU,CAAC;IAEhB,oDAAoD;IACpD,MAAM,YAAY,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC;IAEzD,iEAAiE;IACjE,MAAM,kBAAkB,GAAG,YAAY;QACrC,CAAC,CAAC;YACE,SAAS,EAAE,aAAa;YACxB,YAAY,EAAE,YAAY;YAC1B,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,WAAW;SACrB;QACH,CAAC,CAAC;YACE,MAAM,EAAE,gBAAgB;YACxB,SAAS,EAAE,eAAe;YAC1B,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,WAAW;SACrB,CAAC;IAEN,OAAO;QACL,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAiD,EAAE,EAAE,CAAC,CACjF,MAAC,SAAS,IAAC,KAAK,EAAE,KAAK,aACpB,QAAQ,EACT,KAAC,kBAAkB,KAAG,IACZ,CACb;QACD,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CACvD,KAAC,iBAAiB,cAAE,QAAQ,GAAqB,CAClD;QACD,UAAU,EAAE,YAAY;QACxB,UAAU,EAAE;YACV,GAAG,uBAAuB;YAC1B,4EAA4E;YAC5E,yEAAyE;YACzE,yDAAyD;YACzD,MAAM,EAAE,CAAC,EACP,KAAK,EACL,QAAQ,GAIT,EAAE,EAAE,CACH,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAC5B,KAAC,uBAAuB,CAAC,QAAQ,IAC/B,KAAK,EAAE;oBACL,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,gBAAgB;oBACjD,iEAAiE;oBACjE,uDAAuD;oBACvD,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM;iBACpD,YAEA,QAAQ,GACwB,CACpC,CAAC,CAAC,CAAC,CACF,4BAAG,QAAQ,GAAI,CAChB;SACJ;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,KAAC,YAAY,KAAG;QAC/B,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC9B,qEAAqE;YACrE,oEAAoE;YACpE,MAAM,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,IAAI,KAAK,CAAC;YAC1E,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YACzC,MAAM,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,IAAI,KAAK,CAAC;YAC1E,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;YACjD,MAAM,eAAe,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;YACxD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;YACzC,MAAM,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;YAC7D,MAAM,2BAA2B,GAAG,OAAO,CAAC,0BAA0B,IAAI,KAAK,CAAC;YAChF,MAAM,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;YAEjD,iDAAiD;YACjD,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;YAE5F,OAAO,CACL,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,aAK9D,wBAAwB,IAAI,eAAe,IAAI,gBAAgB,IAAI,CAClE,KAAC,mBAAmB,IAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,QAAC,WAAW,EAAE,YAAY,GAAI,CACrF,EAEA,wBAAwB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CACnD,KAAC,mBAAmB,IAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,GAAI,CAC1D,EACA,CAAC,2BAA2B,IAAI,CAC/B,8BACG,kBAAkB,IAAI,KAAC,aAAa,OAAK,kBAAkB,GAAI,EAC/D,gBAAgB,IAAI,CACnB,KAAC,oBAAoB,IAAC,MAAM,EAAE,gBAAgB,GAAI,CACnD,IACA,CACJ,EACA,kBAAkB,IAAI,QAAQ,IAC3B,CACP,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -1,7 +1,13 @@
 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}`) */
+    /**
+     * Identity of the document this data actually *is* (`${branchId}:${documentId}`),
+     * derived from the payload's own origin. It must never be built from the live
+     * branchId: that flips the moment a switch starts, so it names the document
+     * being requested rather than the one in hand, and publishing a new key beside
+     * the outgoing branch's data made the canvas render a branch behind.
+     */
     syncKey: string | null;
     data: PuckData | null;
 }
@@ -9,11 +15,23 @@ 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;
+    /** Records which document the Puck canvas currently shows */
+    markApplied(syncKey: string): void;
+    /** Sync key of the document the canvas shows; BLANK_SYNC_KEY before the first */
+    getAppliedKey(): string;
 }
+/**
+ * Applied key while Puck still shows the blank data it mounted with.
+ *
+ * A distinct sentinel rather than null because "no document yet" and "the
+ * document Puck was mounted with" are different states, and conflating them
+ * dropped the first real payload: Puck mounts with empty data and the branch is
+ * restored from storage after mount, so the assumption that the first observed
+ * document was already on the canvas never held.
+ *
+ * Contains no colon, so it can never collide with a documentSyncKey.
+ */
+export declare const BLANK_SYNC_KEY = "blank";
 /**
  * Sync-key format for a loaded document. Shared so the publisher
  * (useP1Editor) and readers of the applied key (ContextSyncBridge, the

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

@@ -1 +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"}
+{"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;;;;;;OAMG;IACH,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,6DAA6D;IAC7D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iFAAiF;IACjF,aAAa,IAAI,MAAM,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,UAAU,CAAC;AAItC;;;;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;AAmED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAYzE"}

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

@@ -17,6 +17,18 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
  */
 import { useEffect, useSyncExternalStore } from "react";
 import { useGetPuck } from "@puckeditor/core";
+/**
+ * Applied key while Puck still shows the blank data it mounted with.
+ *
+ * A distinct sentinel rather than null because "no document yet" and "the
+ * document Puck was mounted with" are different states, and conflating them
+ * dropped the first real payload: Puck mounts with empty data and the branch is
+ * restored from storage after mount, so the assumption that the first observed
+ * document was already on the canvas never held.
+ *
+ * Contains no colon, so it can never collide with a documentSyncKey.
+ */
+export const BLANK_SYNC_KEY = "blank";
 const EMPTY_SNAPSHOT = { syncKey: null, data: null };
 /**
  * Sync-key format for a loaded document. Shared so the publisher
@@ -50,7 +62,7 @@ export function normalizeSyncData(data) {
 }
 export function createDocumentSyncStore() {
     let snapshot = EMPTY_SNAPSHOT;
-    let appliedKey = null;
+    let appliedKey = BLANK_SYNC_KEY;
     const listeners = new Set();
     return {
         publish(next) {
@@ -85,11 +97,6 @@ function DocumentSync({ store }) {
         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;

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * Per-field help text, rendered under the input.
+ *
+ * Opt in with Puck's per-field `metadata`, the same extension point the
+ * collapsible section uses:
+ *
+ *   metadata: { help: 'Always shown.', helpWhenEmpty: 'Shown while empty.' }
+ *
+ * `helpWhenEmpty` is how an inheriting field says where its value comes from,
+ * since a field is inheriting exactly while it is empty. Fields without either
+ * key render unchanged.
+ *
+ * These are `fieldTypes` overrides, so Puck hands us its own field renderer as
+ * `children` — the help is appended after it rather than replacing it. Note the
+ * side effect of registering a type here: Puck subscribes to the value of every
+ * field of that type, which is what makes the empty/authored switch work.
+ */
+import React from 'react';
+export interface FieldGuidanceMetadata {
+    help?: string;
+    helpWhenEmpty?: string;
+}
+interface GuidedFieldProps {
+    field: {
+        metadata?: FieldGuidanceMetadata;
+    };
+    value: unknown;
+    children: React.ReactNode;
+}
+declare function WithHelpText({ field, value, children }: GuidedFieldProps): React.ReactElement;
+/**
+ * The field types help text is wired for. Select is included for the fields
+ * whose fallback is a fixed default rather than another prop — it has no
+ * `placeholder` to show one in, so the help line carries it alone.
+ */
+export declare const fieldGuidanceFieldTypes: {
+    text: typeof WithHelpText;
+    textarea: typeof WithHelpText;
+    select: typeof WithHelpText;
+};
+export declare function createFieldGuidanceOverrides(): {
+    fieldTypes: typeof fieldGuidanceFieldTypes;
+};
+export {};
+//# sourceMappingURL=fieldGuidance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fieldGuidance.d.ts","sourceRoot":"","sources":["../../../src/editor/plugin/fieldGuidance.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,gBAAgB;IACxB,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,qBAAqB,CAAA;KAAE,CAAC;IAC5C,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,iBAAS,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,KAAK,CAAC,YAAY,CActF;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;CAInC,CAAC;AAEF,wBAAgB,4BAA4B,IAAI;IAC9C,UAAU,EAAE,OAAO,uBAAuB,CAAC;CAC5C,CAEA"}

package/dist/editor/plugin/fieldGuidance.js

@@ -0,0 +1,24 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { FieldHelpText } from '../components/FieldHelpText.js';
+function WithHelpText({ field, value, children }) {
+    const { help, helpWhenEmpty } = field.metadata ?? {};
+    const text = value === undefined || value === null || value === '' ? helpWhenEmpty ?? help : help;
+    if (!text) {
+        return _jsx(_Fragment, { children: children });
+    }
+    return (_jsxs(_Fragment, { children: [children, _jsx(FieldHelpText, { children: text })] }));
+}
+/**
+ * The field types help text is wired for. Select is included for the fields
+ * whose fallback is a fixed default rather than another prop — it has no
+ * `placeholder` to show one in, so the help line carries it alone.
+ */
+export const fieldGuidanceFieldTypes = {
+    text: WithHelpText,
+    textarea: WithHelpText,
+    select: WithHelpText,
+};
+export function createFieldGuidanceOverrides() {
+    return { fieldTypes: fieldGuidanceFieldTypes };
+}
+//# sourceMappingURL=fieldGuidance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fieldGuidance.js","sourceRoot":"","sources":["../../../src/editor/plugin/fieldGuidance.tsx"],"names":[],"mappings":";AAmBA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAa/D,SAAS,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAoB;IAChE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAElG,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,OAAO,CACL,8BACG,QAAQ,EACT,KAAC,aAAa,cAAE,IAAI,GAAiB,IACpC,CACJ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,YAAY;IAClB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,YAAY;CACrB,CAAC;AAEF,MAAM,UAAU,4BAA4B;IAG1C,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,CAAC;AACjD,CAAC"}

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

@@ -1 +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"}
+{"version":3,"file":"mergePreviewPlugin.d.ts","sourceRoot":"","sources":["../../../src/editor/plugin/mergePreviewPlugin.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,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.map

@@ -1 +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"}
+{"version":3,"file":"mergePreviewPlugin.js","sourceRoot":"","sources":["../../../src/editor/plugin/mergePreviewPlugin.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAkBhE,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/plugin/selectHeaderCollaborators.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Selects the human collaborators shown as avatars in the editor header.
+ *
+ * Agents are deliberately excluded — they render as chips in the subheader.
+ *
+ */
+import type { ActorPresence } from '@pantheon-systems/css-client';
+export interface HeaderPresenceState {
+    humans?: ActorPresence[];
+}
+export declare function selectHeaderCollaborators(presence: HeaderPresenceState | null | undefined, _hasActiveHumans: boolean, humanPresenceCount: number): ActorPresence[];
+//# sourceMappingURL=selectHeaderCollaborators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectHeaderCollaborators.d.ts","sourceRoot":"","sources":["../../../src/editor/plugin/selectHeaderCollaborators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAChD,gBAAgB,EAAE,OAAO,EACzB,kBAAkB,EAAE,MAAM,GACzB,aAAa,EAAE,CAMjB"}

package/dist/editor/plugin/selectHeaderCollaborators.js

@@ -0,0 +1,15 @@
+/**
+ * Selects the human collaborators shown as avatars in the editor header.
+ *
+ * Agents are deliberately excluded — they render as chips in the subheader.
+ *
+ */
+export function selectHeaderCollaborators(presence, _hasActiveHumans, humanPresenceCount) {
+    const humans = presence?.humans ?? [];
+    // humanPresenceCount is the fresher of the two signals on a mid-session
+    // departure, so it still guards against a stale presence getter.
+    if (humanPresenceCount <= 0 || humans.length === 0)
+        return [];
+    return humans;
+}
+//# sourceMappingURL=selectHeaderCollaborators.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectHeaderCollaborators.js","sourceRoot":"","sources":["../../../src/editor/plugin/selectHeaderCollaborators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,UAAU,yBAAyB,CACvC,QAAgD,EAChD,gBAAyB,EACzB,kBAA0B;IAE1B,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;IACtC,wEAAwE;IACxE,iEAAiE;IACjE,IAAI,kBAAkB,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/editor/thumbnails/LiveThumbnail.d.ts

@@ -0,0 +1,47 @@
+/**
+ * LiveThumbnail
+ *
+ * Renders a real, scaled-down preview of a single Puck component using the
+ * component's own `defaultProps`, via Puck's <Render>. The preview is clipped
+ * to a fixed height and made non-interactive so it reads as a static thumbnail
+ * inside the visual component sidebar.
+ *
+ * Rendering is cached (see thumbnailCache): on a miss we render live and
+ * capture the resulting HTML; on a hit we re-inject the cached HTML instead of
+ * re-rendering the component. The cache survives editor remounts within a
+ * page load, avoiding re-rendering identical previews on every document
+ * switch.
+ *
+ * The initial capture happens right after the component's first commit, but a
+ * component that renders its own content asynchronously (e.g. after a fetch,
+ * in its own effect) may still be showing a loading state at that point. A
+ * MutationObserver keeps watching the live render and re-captures on every
+ * DOM change, so the cache converges on the settled output instead of
+ * permanently freezing whatever was on screen first.
+ *
+ * The config handed to Puck's <Render> has its `root` swapped for a
+ * pass-through: this preview is a single component, not a page, so it must
+ * not run the site's real page-root wrapper (e.g. a title `<h1>`) — that
+ * wrapper reflects the actual document currently open in the editor, not
+ * this isolated stub, and would otherwise leak into every preview.
+ *
+ * Unlike the exploratory spike this does NOT self-measure its height — grid
+ * cards want a uniform, fixed size, so we clip overflow instead.
+ */
+import React from 'react';
+type RenderConfig = any;
+export interface LiveThumbnailProps {
+    /** The Puck config the component belongs to. */
+    config: RenderConfig;
+    /** Component key to preview (e.g. "HeroBlock"). */
+    name: string;
+    /** Zoom factor applied to the live render. Lower = more fits. */
+    scale?: number;
+    /** Fixed height of the clipped preview box, in pixels. */
+    height?: number;
+}
+declare function LiveThumbnailImpl({ config, name, scale, height }: LiveThumbnailProps): React.JSX.Element;
+/** Memoized so re-expanding a category doesn't re-render existing previews. */
+export declare const LiveThumbnail: React.MemoExoticComponent<typeof LiveThumbnailImpl>;
+export {};
+//# sourceMappingURL=LiveThumbnail.d.ts.map

package/dist/editor/thumbnails/LiveThumbnail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveThumbnail.d.ts","sourceRoot":"","sources":["../../../src/editor/thumbnails/LiveThumbnail.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,KAAK,YAAY,GAAG,GAAG,CAAC;AAExB,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,MAAM,EAAE,YAAY,CAAC;IACrB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iBAAS,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAW,EAAE,MAAiC,EAAE,EAAE,kBAAkB,qBAiG9G;AAED,+EAA+E;AAC/E,eAAO,MAAM,aAAa,qDAAgC,CAAC"}