@pantheon-systems/puck-css 0.7.0 → 0.9.0

package/dist/editor/thumbnails/humanizeComponentName.js

@@ -0,0 +1,32 @@
+/**
+ * humanizeComponentName
+ *
+ * Derives a human-readable label from a Puck component key for display in the
+ * visual component sidebar. Callers should prefer a component's explicit
+ * `label` when one exists and fall back to this for the raw key.
+ *
+ * Transform: strip a trailing "Block" suffix, split PascalCase (and
+ * digit→capital boundaries) into words, and upper-case known acronyms.
+ *
+ *   "HeroBlock"        -> "Hero"
+ *   "CardGridBlock"    -> "Card Grid"
+ *   "P1WelcomeBlock"   -> "P1 Welcome"
+ *   "CtaBannerBlock"   -> "CTA Banner"
+ *   "FaqBlock"         -> "FAQ"
+ */
+/** Words (lower-cased) that should render fully upper-cased. */
+const ACRONYMS = {
+    cta: 'CTA',
+    faq: 'FAQ',
+};
+export function humanizeComponentName(name) {
+    return name
+        .replace(/Block$/, '')
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((word) => ACRONYMS[word.toLowerCase()] ?? word)
+        .join(' ');
+}
+//# sourceMappingURL=humanizeComponentName.js.map

package/dist/editor/thumbnails/humanizeComponentName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"humanizeComponentName.js","sourceRoot":"","sources":["../../../src/editor/thumbnails/humanizeComponentName.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gEAAgE;AAChE,MAAM,QAAQ,GAA2B;IACvC,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI;SACR,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;SACnD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * resolveLiveThumbnailDrawer
+ *
+ * Decides whether useP1Editor should apply the live thumbnail component drawer,
+ * turning the `liveThumbnailDrawer` option into a Puck override layer (or null).
+ *
+ * The drawer is ON by default — passing `undefined` or `true` builds it, an
+ * options object builds it with those settings, and `false` opts out (Puck's
+ * default drawer is kept). Kept as a pure function so the default-on / opt-out
+ * policy is unit-testable independently of the drawer's rendering internals.
+ */
+import type { PuckOverrides } from '../plugin/index.js';
+import { type LiveThumbnailDrawerOptions } from './buildLiveThumbnailDrawer.js';
+export declare function resolveLiveThumbnailDrawer(config: unknown, option: boolean | LiveThumbnailDrawerOptions | undefined): Partial<PuckOverrides> | null;
+//# sourceMappingURL=resolveLiveThumbnailDrawer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveLiveThumbnailDrawer.d.ts","sourceRoot":"","sources":["../../../src/editor/thumbnails/resolveLiveThumbnailDrawer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAA4B,KAAK,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE1G,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,GACvD,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAI/B"}

package/dist/editor/thumbnails/resolveLiveThumbnailDrawer.js

@@ -0,0 +1,19 @@
+/**
+ * resolveLiveThumbnailDrawer
+ *
+ * Decides whether useP1Editor should apply the live thumbnail component drawer,
+ * turning the `liveThumbnailDrawer` option into a Puck override layer (or null).
+ *
+ * The drawer is ON by default — passing `undefined` or `true` builds it, an
+ * options object builds it with those settings, and `false` opts out (Puck's
+ * default drawer is kept). Kept as a pure function so the default-on / opt-out
+ * policy is unit-testable independently of the drawer's rendering internals.
+ */
+import { buildLiveThumbnailDrawer } from './buildLiveThumbnailDrawer.js';
+export function resolveLiveThumbnailDrawer(config, option) {
+    if (option === false)
+        return null;
+    const options = typeof option === 'object' ? option : undefined;
+    return buildLiveThumbnailDrawer(config, options);
+}
+//# sourceMappingURL=resolveLiveThumbnailDrawer.js.map

package/dist/editor/thumbnails/resolveLiveThumbnailDrawer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveLiveThumbnailDrawer.js","sourceRoot":"","sources":["../../../src/editor/thumbnails/resolveLiveThumbnailDrawer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,wBAAwB,EAAmC,MAAM,+BAA+B,CAAC;AAE1G,MAAM,UAAU,0BAA0B,CACxC,MAAe,EACf,MAAwD;IAExD,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,OAAO,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * thumbnailCache
+ *
+ * In-memory, client-side cache for rendered component-preview HTML: a
+ * module-level Map that survives editor/document remounts within a single
+ * page load (Puck is force-remounted via `key` on every document switch,
+ * which would otherwise re-render every preview from scratch).
+ *
+ * Deliberately NOT persisted to localStorage: the cached value is later
+ * injected via `dangerouslySetInnerHTML` (see LiveThumbnail), and localStorage
+ * is writable by any same-origin script. Persisting it would let a same-origin
+ * write to a `p1-thumb:*` key plant markup that gets trusted and replayed on a
+ * future load. Keeping the cache in-memory only means an attacker would need
+ * live script execution in this exact session to influence it — at which
+ * point they already have full DOM control and this cache buys them nothing.
+ *
+ * A preview depends only on component name + defaultProps, NOT on the document
+ * being edited, so entries are reused across every page. The key embeds a hash
+ * of the defaultProps plus a caller-supplied version so stale entries
+ * invalidate when a component's inputs change.
+ */
+/**
+ * Build a cache key for a component preview. Changing `defaultProps` or
+ * `version` yields a different key, so cached previews invalidate.
+ */
+export declare function makeThumbnailKey(name: string, defaultProps: unknown, version?: string): string;
+/** Cache key for a component preview, shared by LiveThumbnail and ThumbnailCard. */
+export declare function getThumbnailCacheKey(config: {
+    components?: Record<string, {
+        defaultProps?: unknown;
+    }>;
+} | undefined, name: string, version?: string): string;
+/** Read a cached preview (in-memory only — see file header for why). */
+export declare function getCachedThumbnail(key: string): string | undefined;
+/** Write a preview to the in-memory cache. */
+export declare function setCachedThumbnail(key: string, html: string): void;
+/** Clear the in-memory cache, plus any stray entries left by an older, localStorage-backed version of this cache. */
+export declare function clearThumbnailCache(): void;
+//# sourceMappingURL=thumbnailCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnailCache.d.ts","sourceRoot":"","sources":["../../../src/editor/thumbnails/thumbnailCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA8BH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,SAAM,GAAG,MAAM,CAS3F;AAUD,oFAAoF;AACpF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,SAAS,EAC/E,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAER;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElE;AAED,qHAAqH;AACrH,wBAAgB,mBAAmB,IAAI,IAAI,CAgB1C"}

package/dist/editor/thumbnails/thumbnailCache.js

@@ -0,0 +1,97 @@
+/**
+ * thumbnailCache
+ *
+ * In-memory, client-side cache for rendered component-preview HTML: a
+ * module-level Map that survives editor/document remounts within a single
+ * page load (Puck is force-remounted via `key` on every document switch,
+ * which would otherwise re-render every preview from scratch).
+ *
+ * Deliberately NOT persisted to localStorage: the cached value is later
+ * injected via `dangerouslySetInnerHTML` (see LiveThumbnail), and localStorage
+ * is writable by any same-origin script. Persisting it would let a same-origin
+ * write to a `p1-thumb:*` key plant markup that gets trusted and replayed on a
+ * future load. Keeping the cache in-memory only means an attacker would need
+ * live script execution in this exact session to influence it — at which
+ * point they already have full DOM control and this cache buys them nothing.
+ *
+ * A preview depends only on component name + defaultProps, NOT on the document
+ * being edited, so entries are reused across every page. The key embeds a hash
+ * of the defaultProps plus a caller-supplied version so stale entries
+ * invalidate when a component's inputs change.
+ */
+// Legacy prefix from a prior localStorage-backed version of this cache.
+// clearThumbnailCache() still purges any stray entries left behind on a
+// user's machine, but nothing here reads or writes through it anymore.
+const LEGACY_LS_PREFIX = 'p1-thumb:';
+// In-memory only, lives as long as the JS runtime (browser tab).
+const memory = new Map();
+/** Small, dependency-free djb2 string hash. */
+function hashString(input) {
+    let hash = 5381;
+    for (let i = 0; i < input.length; i++) {
+        hash = ((hash << 5) + hash + input.charCodeAt(i)) | 0;
+    }
+    return (hash >>> 0).toString(36);
+}
+/** localStorage if available, else null (SSR / disabled / private mode). */
+function getStore() {
+    try {
+        return typeof globalThis !== 'undefined' && globalThis.localStorage
+            ? globalThis.localStorage
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build a cache key for a component preview. Changing `defaultProps` or
+ * `version` yields a different key, so cached previews invalidate.
+ */
+export function makeThumbnailKey(name, defaultProps, version = '2') {
+    let serialized = '';
+    try {
+        serialized = JSON.stringify(defaultProps) ?? '';
+    }
+    catch {
+        // Non-serializable props — fall back to name+version only.
+        serialized = '';
+    }
+    return `${name}:${hashString(`${version}|${serialized}`)}`;
+}
+/** A component's defaultProps, resolved from its config entry. */
+function defaultPropsFor(config, name) {
+    return config?.components?.[name]?.defaultProps ?? {};
+}
+/** Cache key for a component preview, shared by LiveThumbnail and ThumbnailCard. */
+export function getThumbnailCacheKey(config, name, version) {
+    return makeThumbnailKey(name, defaultPropsFor(config, name), version);
+}
+/** Read a cached preview (in-memory only — see file header for why). */
+export function getCachedThumbnail(key) {
+    return memory.get(key);
+}
+/** Write a preview to the in-memory cache. */
+export function setCachedThumbnail(key, html) {
+    memory.set(key, html);
+}
+/** Clear the in-memory cache, plus any stray entries left by an older, localStorage-backed version of this cache. */
+export function clearThumbnailCache() {
+    memory.clear();
+    const store = getStore();
+    if (store) {
+        try {
+            const keys = [];
+            for (let i = 0; i < store.length; i++) {
+                const k = store.key(i);
+                if (k && k.startsWith(LEGACY_LS_PREFIX))
+                    keys.push(k);
+            }
+            keys.forEach((k) => store.removeItem(k));
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=thumbnailCache.js.map

package/dist/editor/thumbnails/thumbnailCache.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"useDocuments.d.ts","sourceRoot":"","sources":["../../src/editor/useDocuments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,UAAU,kBAAkB;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,kBAAkB;IAC1B;;OAEG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,CACN,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,QAAQ,EACtB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACxE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;OAEG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;CACnD;AAUD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,MAAM,EACN,QAAQ,GACT,EAAE,kBAAkB,GAAG,kBAAkB,CAmHzC"}
+{"version":3,"file":"useDocuments.d.ts","sourceRoot":"","sources":["../../src/editor/useDocuments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,UAAU,kBAAkB;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,kBAAkB;IAC1B;;OAEG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,CACN,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,QAAQ,EACtB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACxE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;OAEG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;CACnD;AAUD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,MAAM,EACN,QAAQ,GACT,EAAE,kBAAkB,GAAG,kBAAkB,CAqIzC"}

package/dist/editor/useDocuments.js

@@ -73,20 +73,28 @@ export function useDocuments({ client, siteId, branchId, }) {
     }, [refresh, branchId]);
     // Create a new document
     const create = useCallback(async (path, initialData, options) => {
-        const doc = await client.documents.create({
-            siteId,
-            branchId,
-            path,
-            ...(options?.templateId ? {
+        // Template pages get their initial version built by the backend from the
+        // template, which preserves each component's durable slot id. A
+        // client-built snapshot would be layered on top as a second version and
+        // bury those ids, so it is rejected here.
+        if (options?.templateId) {
+            if (initialData !== undefined) {
+                throw new Error('Cannot supply initialData when creating a document from a template; the backend builds the initial version from the template.');
+            }
+            const doc = await client.documents.create({
+                siteId,
+                branchId,
+                path,
                 templateId: options.templateId,
                 templateVersion: options.templateVersion ?? 1,
-            } : {}),
-        });
-        // Create initial version with default or provided data. When a title is
-        // given, seed it into the Puck root props (root.props.title) — the same
-        // field Puck's root "title" input reads/writes — so it persists in the
-        // initial snapshot. This composes with template scaffolding: the title is
-        // merged into whatever initialData was passed (default or scaffolded).
+                ...(options.title ? { title: options.title } : {}),
+            });
+            await refresh();
+            return doc;
+        }
+        // Blank pages build their initial version on the client. A title seeds
+        // root.props.title (the same field Puck's root "title" input
+        // reads/writes) so it persists in the initial snapshot.
         const baseData = initialData ?? DEFAULT_PUCK_DATA;
         const data = options?.title
             ? {
@@ -97,12 +105,16 @@ export function useDocuments({ client, siteId, branchId, }) {
                 },
             }
             : baseData;
-        await client.versions.create(siteId, {
-            documentId: doc.id,
+        // Create the document and its initial version in a SINGLE call by passing
+        // the content inline as `snapshot`. Previously this was two calls
+        // (documents.create with no snapshot, then a separate versions.create),
+        // which produced two version rows for a brand-new page.
+        const doc = await client.documents.create({
+            siteId,
             branchId,
+            path,
             snapshot: data,
         });
-        // Refresh the list
         await refresh();
         return doc;
     }, [client, siteId, branchId, refresh]);

package/dist/editor/useDocuments.js.map

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

package/dist/editor/useP1Editor.d.ts

@@ -1,19 +1,12 @@
-/**
- * useP1Editor Hook
- *
- * All-in-one hook for setting up a P1-enabled Puck editor.
- * Composes useP1Plugin and useP1Overrides internally, handles
- * document loading, version management, historical version protection,
- * and provides everything needed to render <Puck>.
- */
+import type { Plugin } from '@puckeditor/core';
+import type { PuckData } from '@pantheon-systems/css-client';
+import type { UiState } from '@puckeditor/core';
+import type { P1PuckContextValue } from '../core/types.js';
 import type { ThumbnailMap } from './utils/buildThumbnailOverride.js';
+import type { LiveThumbnailDrawerOptions } from './thumbnails/buildLiveThumbnailDrawer.js';
 import type { UseP1PluginOptions } from './useP1Plugin.js';
 import type { UseP1OverridesOptions } from './useP1Overrides.js';
 import type { PuckOverrides } from './plugin/index.js';
-import type { Plugin } from '@puckeditor/core';
-import type { P1PuckContextValue } from '../core/types.js';
-import type { PuckData } from '@pantheon-systems/css-client';
-import type { UiState } from '@puckeditor/core';
 /**
  * Options for useP1Editor.
  */
@@ -45,6 +38,15 @@ export interface UseP1EditorOptions {
      * ```
      */
     thumbnails?: ThumbnailMap;
+    /**
+     * Live thumbnail component drawer — replaces Puck's default component list
+     * with collapsible categories of live-rendered preview cards. Defaults to
+     * ON for every consumer (no per-app wiring needed). Pass `false` to keep
+     * Puck's default drawer, or an options object to tune scale / card height.
+     *
+     * NOTE: this changes the default drawer for all `puck-css` editors.
+     */
+    liveThumbnailDrawer?: boolean | LiveThumbnailDrawerOptions;
     /** Customization options for overrides */
     overrideOptions?: UseP1OverridesOptions;
     /** Customization options for the CSS plugin (versions are managed internally) */
@@ -93,7 +95,7 @@ export interface UseP1EditorReturn {
     loading: boolean;
     /** Error from document loading, if any */
     error: Error | null;
-    /** React key — pass directly as `<Puck key={puckKey} {...puckProps} />` to force clean remount on document switch */
+    /** React key — pass directly as `<Puck key={puckKey} {...puckProps} />` to force a clean remount on role change (document switches sync in place) */
     puckKey: string;
     /** Props to spread onto <Puck> */
     puckProps: PuckProps;

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

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

package/dist/editor/useP1Editor.js

@@ -1,3 +1,4 @@
+"use client";
 /**
  * useP1Editor Hook
  *
@@ -8,12 +9,15 @@
  */
 import { useState, useEffect, useRef, useMemo, useCallback } from 'react';
 import { useP1Puck } from '../core/P1PuckContext.js';
+import { useVersions } from '../versioning/useVersions.js';
+import { useP1Auth } from '../auth/index.js';
 import { useP1Plugin } from './useP1Plugin.js';
 import { useP1Overrides } from './useP1Overrides.js';
-import { useVersions } from '../versioning/useVersions.js';
 import { useComponentRegistry } from './useComponentRegistry.js';
-import { useP1Auth } from '../auth/index.js';
 import { buildThumbnailOverride } from './utils/buildThumbnailOverride.js';
+import { restoreDocumentVersion } from './utils/restoreDocumentVersion.js';
+import { createDocumentSyncStore, createDocumentSyncPlugin, documentSyncKey, } from './plugin/document-sync-plugin.js';
+import { resolveLiveThumbnailDrawer } from './thumbnails/resolveLiveThumbnailDrawer.js';
 /**
  * All-in-one hook for setting up a P1-enabled Puck editor.
  *
@@ -42,7 +46,7 @@ import { buildThumbnailOverride } from './utils/buildThumbnailOverride.js';
  * ```
  */
 export function useP1Editor(options) {
-    const { documentPath, puckConfig, additionalPlugins, additionalOverrides, thumbnails, overrideOptions, pluginOptions, onSelectionChange, onDocumentNotFound, } = options;
+    const { documentPath, puckConfig, additionalPlugins, additionalOverrides, thumbnails, liveThumbnailDrawer, overrideOptions, pluginOptions, onSelectionChange, onDocumentNotFound, } = options;
     const css = useP1Puck();
     const { user, logout } = useP1Auth();
     // =========================================================================
@@ -155,6 +159,8 @@ export function useP1Editor(options) {
             void css.loadVersion(version);
         }
     }, [versions, css.loadVersion, css.returnToLatest]);
+    // Revert to a prior version.
+    const handleRestoreVersion = useCallback((version) => restoreDocumentVersion(version, css, refreshVersions, () => { }), [css, refreshVersions]);
     // =========================================================================
     // Published Status (derived from version data)
     // =========================================================================
@@ -207,9 +213,16 @@ export function useP1Editor(options) {
         void refreshVersions();
         consumerOnPublishSuccessRef.current?.(checkpoint);
     }, [css, refreshVersions]);
+    const canRevert = css.userRole === 'admin' || css.userRole === 'editor';
+    // Pushes freshly loaded documents into the live Puck instance, replacing
+    // the remount-on-document-switch behavior the old document-scoped puckKey
+    // provided (see document-sync-plugin.tsx). Handed to the P1 plugin as well
+    // so its context sync defers document switches to this store.
+    const [documentSyncStore] = useState(createDocumentSyncStore);
     const p1Plugin = useP1Plugin({
+        documentSyncStore,
         onSelectionChange: handleSelectionChange,
-        currentUser: user ? { id: user.id, name: user.name, email: user.email, avatar: user.picture } : undefined,
+        currentUser: user ? { id: css.userId, name: user.name, email: user.email, avatar: user.picture } : undefined,
         onLogout: logout,
         puckConfig,
         ...pluginOptions,
@@ -219,6 +232,8 @@ export function useP1Editor(options) {
         publishedStatus,
         selectedVersionId: css.viewingVersion?.id ?? undefined,
         onVersionSelect: handleVersionSelect,
+        onRestoreVersion: handleRestoreVersion,
+        canRevert,
     });
     const wrappedOnPublishSuccess = useCallback((checkpoint) => {
         void refreshVersions();
@@ -232,32 +247,76 @@ export function useP1Editor(options) {
     // =========================================================================
     // Stable plugin array
     // =========================================================================
+    if (process.env.NODE_ENV === "development") {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        const prev = useRef(additionalPlugins);
+        if (prev.current !== additionalPlugins) {
+            const countChanged = (prev.current?.length ?? 0) !== (additionalPlugins?.length ?? 0);
+            if (!countChanged) {
+                console.warn("[useP1Editor] additionalPlugins ref is changing every render " +
+                    "without a length change — the caller should memoise this array.");
+            }
+            prev.current = additionalPlugins;
+        }
+    }
     const additionalPluginsRef = useRef(additionalPlugins);
     additionalPluginsRef.current = additionalPlugins;
+    const documentSyncPlugin = useMemo(() => createDocumentSyncPlugin(documentSyncStore), [documentSyncStore]);
+    // Read through a ref so a publish happens once per settled load, not on
+    // every safeData edit.
+    const safeDataRef = useRef(css.safeData);
+    safeDataRef.current = css.safeData;
+    const currentDocumentId = css.currentDocument?.id;
+    useEffect(() => {
+        if (loading || error || !currentDocumentId)
+            return;
+        documentSyncStore.publish({
+            syncKey: documentSyncKey(css.branchId, currentDocumentId),
+            data: safeDataRef.current,
+        });
+    }, [loading, error, css.branchId, currentDocumentId, documentSyncStore]);
     const pluginCount = additionalPlugins?.length ?? 0;
     const plugins = useMemo(() => {
-        const result = [p1Plugin];
+        const result = [p1Plugin, documentSyncPlugin];
         if (additionalPluginsRef.current) {
             result.push(...additionalPluginsRef.current);
         }
         return result;
-    }, [p1Plugin, pluginCount]);
+    }, [p1Plugin, documentSyncPlugin, pluginCount]);
     // =========================================================================
-    // Stable onChange (disabled for historical versions)
+    // Stable onChange (disabled for historical versions, guarded across
+    // document switches)
     // =========================================================================
     const isViewingHistoricalRef = useRef(css.isViewingHistoricalVersion);
     isViewingHistoricalRef.current = css.isViewingHistoricalVersion;
+    // With Puck surviving document switches, onChange can fire while the canvas
+    // still shows the previous document but css already targets the new one
+    // (load in flight, or loaded but not yet pushed by the sync plugin). Saving
+    // then would write the old page's content into the new page — drop instead.
+    const saveTargetKeyRef = useRef(null);
+    saveTargetKeyRef.current = css.currentDocument?.id
+        ? documentSyncKey(css.branchId, css.currentDocument.id)
+        : null;
     const onChange = useCallback((data) => {
-        if (!isViewingHistoricalRef.current) {
-            css.saveData(data);
+        if (isViewingHistoricalRef.current)
+            return;
+        const appliedKey = documentSyncStore.getAppliedKey();
+        if (appliedKey !== null && appliedKey !== saveTargetKeyRef.current) {
+            console.warn('[useP1Editor] save SKIPPED: canvas/document mismatch during switch.', 'canvas:', appliedKey, 'target:', saveTargetKeyRef.current);
+            return;
         }
-    }, [css.saveData]);
+        css.saveData(data);
+    }, [css.saveData, documentSyncStore]);
     // =========================================================================
     // Permissions (read-only for historical versions)
     // =========================================================================
     const permissions = useMemo(() => {
         if (css.isViewingHistoricalVersion) {
-            return { delete: false, drag: false, duplicate: false, edit: false, insert: false };
+            // Omit edit:false so page/root fields are never locked by Puck's own
+            // readonly rendering. Interaction is blocked by ReadOnlyFieldsGuard
+            // (inert attribute) instead, which also covers root fields without
+            // requiring resolvePermissions on config.root.
+            return { delete: false, drag: false, duplicate: false, insert: false };
         }
         return { delete: true, drag: true, duplicate: true, edit: true, insert: true };
     }, [css.isViewingHistoricalVersion]);
@@ -275,10 +334,20 @@ export function useP1Editor(options) {
     // componentItem if needed.
     const thumbnailsRef = useRef(thumbnails);
     thumbnailsRef.current = thumbnails;
+    // Live thumbnail drawer — default ON for every consumer. Uses raw puckConfig
+    // (not configWithPermissions) so previews show all components regardless of
+    // role. Because useMemo deps on p1Overrides (stable after mount), changes to
+    // puckConfig or liveThumbnailDrawer after mount are not picked up.
+    const puckConfigRef = useRef(puckConfig);
+    puckConfigRef.current = puckConfig;
+    const liveThumbnailDrawerRef = useRef(liveThumbnailDrawer);
+    liveThumbnailDrawerRef.current = liveThumbnailDrawer;
     const mergedOverrides = useMemo(() => {
-        // Layer order (last wins): p1Overrides → thumbnailOverride → additionalOverrides
+        // Layer order (last wins):
+        //   p1Overrides → liveThumbnailDrawer → thumbnailOverride → additionalOverrides
         const layers = [
             p1Overrides,
+            resolveLiveThumbnailDrawer(puckConfigRef.current, liveThumbnailDrawerRef.current),
             thumbnailsRef.current ? buildThumbnailOverride(thumbnailsRef.current) : null,
             additionalOverridesRef.current ?? null,
         ];
@@ -302,15 +371,15 @@ export function useP1Editor(options) {
     // =========================================================================
     // Assemble puckProps
     // =========================================================================
-    // Key that forces Puck to remount on document switch or role change,
+    // Key that forces Puck to remount on role change (let puck internally manage the change on document change),
     // ensuring clean undo history, sidebar state, and fresh permission cache.
     // Puck caches resolvePermissions results per component instance — the
     // cache is only invalidated when component data changes, not when the
     // resolver function changes. Including userRole in the key forces a
     // clean remount with an empty cache when roles switch.
-    const puckKey = `css-${css.currentDocument?.id ?? documentPath}-${css.userRole}`;
+    const puckKey = `css-${css.userRole}`;
     // Read persisted sidebar visibility from localStorage each time the Puck instance
-    // changes (puckKey changes on document/branch switch). The value is passed as the
+    // changes (puckKey changes on role switch). The value is passed as the
     // initial `ui` prop so Puck never initializes with wrong defaults.
     const initialSidebarUi = useMemo(() => {
         try {
@@ -350,11 +419,19 @@ export function useP1Editor(options) {
                         const resolver = resolvePermsRef.current;
                         if (!resolver)
                             return params.permissions;
-                        const basePerms = resolver({ type: name }, {});
-                        const pinMap = (params.appState?.data?.root?.props?._pinMap ?? {});
-                        const compId = data?.props?.id;
-                        if (compId && pinMap[compId]) {
-                            return { ...basePerms, drag: false, delete: false };
+                        const basePerms = resolver({ type: name, props: data?.props }, {});
+                        // Template-authoring mode: the context resolver only sees a
+                        // metadata summary (no pins), so the document's live _pinMap is the
+                        // pin source. On a bound page the resolver reads the live template
+                        // and already governs pins, so the page's own snapshot pinMap is
+                        // ignored — otherwise a stale pin would stay locked after the
+                        // template unpins it.
+                        if (isTemplateMode) {
+                            const pinMap = (params.appState?.data?.root?.props?._pinMap ?? {});
+                            const compId = data?.props?.id;
+                            if (compId && pinMap[compId]) {
+                                return { ...basePerms, drag: false, delete: false };
+                            }
                         }
                         return basePerms;
                     },