pagepilot-visual-editor 1.0.28 → 1.0.30

package/dist/editor-sample/documents/editor/EditorContext.d.ts

@@ -3,18 +3,15 @@ import { TEditorConfiguration } from './core';
 import { TemplateFormField, TemplateArrayRow } from './templateVariables';
 type TValue = {
     document: TEditorConfiguration;
+    record: any | null;
     selectedBlockId: string | null;
     selectedSidebarTab: 'block-configuration' | 'styles' | 'behaviour' | 'layout' | 'settings' | 'background' | 'page-pilot-ai' | 'layers' | 'brand' | 'seo' | 'variables' | 'research';
     selectedMainTab: 'editor' | 'preview' | 'json' | 'html';
     selectedScreenSize: 'desktop' | 'mobile' | 'tablet';
     zoomLevel: number;
     minimapVisible: boolean;
-    /**
-     * Which device the responsive sidebar tabs are currently authoring
-     * for. Independent of `selectedScreenSize` (the top-toolbar preview
-     * device) — flipping this must NOT resize the canvas.
-     */
     sidebarEditingDevice: 'desktop' | 'mobile' | 'tablet';
+    hasManualScreenSizeOverride: boolean;
     inspectorDrawerOpen: boolean;
     samplesDrawerOpen: boolean;
     activeStepIndex: number;
@@ -41,6 +38,7 @@ type TValue = {
     };
     inlineEditingEnabled: boolean;
     hoveredBlockId: string | null;
+    highlightedVariableId: string | null;
     copiedBlock: {
         rootBlockId: string;
         blocks: Record<string, any>;
@@ -98,13 +96,26 @@ export declare function useDocumentPruned(): TEditorConfiguration;
  * whenever a component only needs one block's data.
  */
 export declare function useEditorBlock(id: string): any;
+/**
+ * Subscribe to just the root block, for the id-not-found fallback path.
+ * Narrower than useDocument() — re-renders only when 'root' itself changes.
+ */
+export declare function useRootBlock(): any;
 /**
  * Non-reactive read of the current document. Use inside event handlers / callbacks
  * when you need the latest document but do NOT want the component to re-render
  * every time any block in the document changes.
  */
 export declare function getDocument(): TValue['document'];
-export declare function useRootFontFamily(): string;
+/**
+ * The page root's own font key, or null when the author never picked one.
+ *
+ * Deliberately does NOT resolve the workspace brand default here: this module
+ * is imported by nearly every editor component, and reaching into the redux
+ * store from it would create an import cycle. Callers pass the result through
+ * `resolveRootFontFamily` instead.
+ */
+export declare function useRootFontFamilyKey(): string | null;
 export declare function useSelectedBlockId(): string;
 /**
  * Boolean selector — returns true only when THIS block is the selected one.
@@ -113,6 +124,8 @@ export declare function useSelectedBlockId(): string;
  */
 export declare function useIsBlockSelected(id: string): boolean;
 export declare function useSelectedScreenSize(): "desktop" | "tablet" | "mobile";
+export declare const ZOOM_MIN = 25;
+export declare const ZOOM_MAX = 100;
 export declare function useZoomLevel(): number;
 /**
  * View-only state — deliberately does NOT go through pushToUndoStack, so
@@ -126,7 +139,6 @@ export declare function useMinimapVisible(): boolean;
 export declare function toggleMinimapVisible(): void;
 /** Which device's properties the sidebar is currently editing (see ResponsiveDeviceTabs). */
 export declare function useSidebarEditingDevice(): "desktop" | "tablet" | "mobile";
-export declare function setSidebarEditingDevice(sidebarEditingDevice: TValue['sidebarEditingDevice']): void;
 export declare function useSelectedMainTab(): "html" | "editor" | "preview" | "json";
 export declare function useActiveStepIndex(): number;
 export declare function useSelectors(): string[];
@@ -141,6 +153,7 @@ export declare function usePanelMeasurements(): {
     offsetTop?: number;
 };
 export declare function useCurrentRecordType(): string;
+export declare function setCurrentRecord(record: any | null): void;
 export declare function setCurrentRecordType(type: string | null): void;
 export declare function setPanelMeasurements(measurements: {
     panelWidth: number;
@@ -188,6 +201,8 @@ export declare function useHoveredBlockId(): string;
  */
 export declare function useIsBlockHovered(id: string): boolean;
 export declare function setHoveredBlockId(hoveredBlockId: string | null): void;
+export declare function useHighlightedVariableId(): string;
+export declare function setHighlightedVariableId(highlightedVariableId: string | null): void;
 export declare function getHoveredBlockId(): string | null;
 export declare function useCopiedBlock(): {
     rootBlockId: string;
@@ -231,23 +246,16 @@ export declare function resetDocument(document: TValue['document'], options?: {
     sideEffect?: UndoSideEffect;
     activeStepIndex?: number;
     /**
-     * Skip the undo-stack push *and* wipe both stacks. Use when seeding the
-     * editor from external state (host record on mount, hot reload, etc.) —
-     * the swap isn't a user action and the previous empty doc shouldn't
-     * become an Undo target. Without this, the Undo button is already
-     * enabled the moment the editor mounts because pushToUndoStack records
-     * the pre-seed empty state.
+     * pagepilot: skip the undo-stack push *and* wipe both stacks. Used by the
+     * Shell when seeding the editor from host props (not a user action), so
+     * the pre-seed empty doc never becomes an Undo target.
      */
     skipHistory?: boolean;
 }): void;
 /**
- * Wipe both history stacks without touching the document. Used by the Shell
- * after the initial seed has settled, to swallow any spurious pushes that
- * various block-level useEffects (ButtonGroup auto-seed, layout positioning
- * re-measure, sidebar panels echoing fetched data, etc.) emit between
- * "editor mounted" and "user has actually edited something". Without this
- * guard the Undo button is enabled on first paint and clicking it rolls
- * the canvas back to an empty document.
+ * pagepilot: wipe both history stacks without touching the document. Used by
+ * the Shell after the initial props-driven seed settles, to swallow spurious
+ * pushes from block-level effects before the user has edited anything.
  */
 export declare function clearEditorHistory(): void;
 export declare function resetDocumentKeepTab(document: TValue['document'], options?: {
@@ -263,6 +271,29 @@ export declare function resetDocumentKeepTab(document: TValue['document'], optio
  * the 200ms burst window with neighbouring words.
  */
 export declare function resetCoalesce(): void;
+/**
+ * Run a batch of setDocument / setTemplateForms calls as a SINGLE undoable
+ * step. Any entries the batch pushes onto undoStack are collapsed to one
+ * entry whose snapshot is the pre-batch state — so a single Ctrl+Z rewinds
+ * the whole logical action.
+ *
+ * Motivation: the "insert a section-library template" flow calls
+ *   1. `setDocument(newBlocks)`     — seed descendant blocks
+ *   2. `onInsert(rootBlock, id)`     — parent's handleChildrenChange writes
+ *      the root into its childrenIds AND calls `setSelectedBlockId` (which
+ *      resetCoalesces)
+ *   3. `appendTemplateFormFields`    — setDocument for root.data.formFields
+ *
+ * Step 2's `setSelectedBlockId` closes the coalesce window, so step 3 lands
+ * on its own undo entry. Users then need TWO Undos to remove the section,
+ * and after one Undo the section is still wired into the tree but its
+ * `{{tokens}}` render as "Add X" pills because formFields hasn't been
+ * restored yet.
+ *
+ * Any code path that combines several setDocument mutations into one
+ * user-visible action should wrap them here.
+ */
+export declare function withSingleUndoStep(action: () => void): void;
 export declare function undo(): void;
 export declare function redo(): void;
 /**
@@ -328,6 +359,15 @@ export declare function setDocument(document: TValue['document'], options?: SetD
 export declare function toggleInspectorDrawerOpen(): void;
 export declare function toggleSamplesDrawerOpen(): void;
 export declare function setSelectedScreenSize(selectedScreenSize: TValue['selectedScreenSize']): void;
+export declare function resetSelectedScreenSizeFromRecord(selectedScreenSize: TValue['selectedScreenSize']): void;
+export declare function useHasManualScreenSizeOverride(): boolean;
+export declare function resetManualScreenSizeOverride(): void;
+/**
+ * Switch which device's properties the sidebar edits. Deliberately separate
+ * from `setSelectedScreenSize` — this must NEVER resize the canvas preview;
+ * only the top toolbar's device toggle does that.
+ */
+export declare function setSidebarEditingDevice(sidebarEditingDevice: TValue['sidebarEditingDevice']): void;
 /** Reactive view of the template fields on root.data.formFields. */
 export declare function useTemplateForms(): TemplateFormField[];
 /** Non-reactive read for use inside event handlers / the save transform. */
@@ -337,8 +377,25 @@ export declare function getTemplateFormsState(): TemplateFormField[];
  * field (array field with a `sourceBlockId`). Recomputed when the document
  * changes. The canvas render path uses it to substitute a repeated container
  * copy's `{{this.subField}}` tokens with that copy's row values.
+ *
+ * Prefer `useRepeatRowForBlock(blockId)` in per-block components — this whole-
+ * map subscription re-renders on every document change and should only be used
+ * by callers that need the full map (ContainerRepeatSection, ItemsArrayRepeatSection,
+ * TabsBlockEditor's per-tab lookup).
  */
 export declare function useRepeatRowIndex(): Map<string, TemplateArrayRow>;
+/**
+ * Reactive per-block row lookup — the row (if any) that `blockId` currently
+ * belongs to inside a container-repeat copy. Unlike `useRepeatRowIndex()`, this
+ * subscribes to a single Map entry: zustand's `Object.is` equality check means
+ * the component only re-renders when ITS OWN row reference changes (row values
+ * come from `formFields[i].value[j]` and keep referential identity across
+ * unrelated edits), not on every keystroke anywhere in the document.
+ *
+ * This is what per-block components (Text/Heading/Button/Image/Avatar/Logo/
+ * Rating/Progress/Breadcrumb) should call — never a whole-document selector.
+ */
+export declare function useRepeatRowForBlock(blockId: string): TemplateArrayRow | null;
 /** Write the template-fields onto the document root (undoable, live). */
 export declare function setTemplateForms(fields: TemplateFormField[]): void;
 export declare function useElementIdError(): {

package/dist/editor-sample/documents/editor/LazyEditorBlock.d.ts

@@ -1,6 +1,7 @@
 type Props = {
     id: string;
 };
+export declare const blockHeightCache: Map<string, number>;
 /**
  * Virtualized wrapper around <EditorBlock>. While the placeholder div is
  * outside the viewport (plus a 600px margin), the real EditorBlock is NOT