@growgroup/visual-editor 0.2.2 → 0.3.1

package/src/editor/contexts/MultiPageCanvasContext.tsx

@@ -3,38 +3,77 @@
 /**
  * MultiPageCanvasContext
  *
- * マルチページ無限キャンバスの状態管理Context
- * 全ページを常にキャンバス上に表示し、クリックで即座にページ切替
- * Figmaライクな統合ビュー（モード切替なし）
+ * Figma 風のマルチフレームキャンバスの状態。
+ * 全ページをフレームとして 1 枚のキャンバスに並べ、1 つのフレームだけが「生きている」
+ * エディタ(EditorCanvas)で、残りは見るだけの紙面(srcdoc の iframe)。
+ * クリックしたフレームへ編集が移る。倍率・位置はこの Context が持ち、
+ * 外側の CSS transform で全体を拡大縮小する(iframe の中は常に等倍)。
+ *
+ * [設計]
+ * - 編集エンジンは 1 つ(EditorCanvas)。ページごとの編集ロジックの二重実装はしない
+ * - フレームの寸法: 幅は版面の幅(webpage は artboardWidth、slide は 1920)、
+ *   高さは実測(生きているページはエディタ、他は見るだけの紙面が測る)
+ * - 位置は寸法から毎回計算する(状態に持たない)。高さが変わっても流れ直すだけ
+ * - 見えている範囲は localStorage に保存し、開き直しても同じ場所に戻る
+ *
+ * [ビュー状態は Context の外に置く]
+ * 倍率・位置(viewState)はホイールの 1 目盛りごとに変わる。これを Context の値に
+ * 入れると、購読しているもの(エディタ本体・150 枚の紙面・左パネル…)が毎目盛り
+ * 描き直しになる。そこで viewState は小さな外部ストア(viewStore)に置き、
+ * 必要な部品だけが useCanvasViewState() で購読する。Context の値そのものは
+ * ズーム・パンでは変わらない
  */
 
 import React, {
   createContext,
-  useContext,
-  useState,
   useCallback,
+  useContext,
+  useEffect,
   useMemo,
   useRef,
-  useEffect,
+  useState,
+  useSyncExternalStore,
 } from 'react';
-import { useEditorArtboard } from './EditorArtboardContext';
-import { useEditorHistory } from './EditorHistoryContext';
-import { useEditorRefs } from './EditorRefsContext';
-import { generateEditableHtml } from '../utils/html-utils';
+import { useEditorArtboard, computeContentDepths, type DocumentAttributes } from './EditorArtboardContext';
+import { useEditorTool } from './EditorToolContext';
+import { useEditorView } from './EditorViewContext';
+import { SLIDE_HEIGHT, SLIDE_WIDTH, WEBPAGE_WIDTH } from '../constants';
+import type { EditorMode } from './EditorToolContext';
+import { io, type PreviewStyle } from '../../io';
 
 // ============================================================
 // 定数
 // ============================================================
 
-/** ウェブページの標準幅 (px) */
-export const WEBPAGE_WIDTH = 1440;
-/** ウェブページの最小高さ (px) */
-export const WEBPAGE_MIN_HEIGHT = 900;
-/** ページ間の水平間隔 (px) */
-const LAYOUT_GAP_X = 100;
-/** ズーム範囲 */
-const MIN_ZOOM = 0.02;
-const MAX_ZOOM = 2.0;
+/** 互換のために残す(旧実装が公開していた)。フレームの幅は viewportWidth を使う */
+export { WEBPAGE_WIDTH };
+/** 高さが未測定の webpage フレームに仮に与える高さ */
+export const WEBPAGE_MIN_HEIGHT = 1200;
+/** ズーム範囲(Figma は 2%〜25600%。紙面の編集で要るのはこの範囲) */
+export const MIN_ZOOM = 0.02;
+export const MAX_ZOOM = 4;
+/** ホイール 1 段のズーム倍率(ボタン・キー操作) */
+const ZOOM_STEP = 1.25;
+/** 全体表示・ページ表示のときの余白(px、画面上) */
+const FIT_PADDING = 72;
+/** 上と左の定規の太さ(px)。全体表示の余白に足す */
+export const RULER_SIZE = 20;
+/** ビューのアニメーション(ms) */
+const VIEW_ANIMATION_MS = 240;
+/** 見るだけの紙面を同時に読む枚数 */
+const PREVIEW_PARALLEL = 4;
+
+/** フレームどうしの間隔(紙面の座標系、等倍のとき)。フレーム名を出すかの判定にも使う */
+export const FRAME_GAP: Record<EditorMode, { x: number; y: number }> = {
+  webpage: { x: 200, y: 260 },
+  slide: { x: 160, y: 220 },
+};
+const GAP = FRAME_GAP;
+/** 1 行に並べる数。webpage は横一列が基本だが、多いと横に長すぎるので折り返す */
+const WRAP_AT: Record<EditorMode, (count: number) => number> = {
+  webpage: () => 8,
+  slide: (count) => Math.min(6, Math.max(3, Math.ceil(Math.sqrt(count)))),
+};
 
 // ============================================================
 // 型定義
@@ -43,57 +82,141 @@ const MAX_ZOOM = 2.0;
 export interface PageFrame {
   id: string;
   title: string;
-  position: { x: number; y: number };
+  /** 本文。null = まだ読んでいない(または読み直す) */
+  html: string | null;
+  /** 本文を読んでいる途中 */
+  loading: boolean;
+  /** 読めなかったときの理由 */
+  error: string | null;
   size: { width: number; height: number };
-  thumbnailHtml: string;
-  thumbnailDataUrl: string | null;
+  /** 高さを実測済みか(未測定はレイアウト用の仮の高さ) */
+  measured: boolean;
+  /** 未保存の変更がある(生きているページだけ立つ) */
   isDirty: boolean;
-  html: string;
+  /** 親ページ(contentList[].parentId。一覧に無い親は null 扱い) */
+  parentId: string | null;
+  /** 階層の深さ(ルート = 0) */
+  depth: number;
+  /** 編集しない表示の URL(contentList[].href) */
+  href?: string;
+  /** 利用側が進める本文の版(contentList[].revision)。変わったら読み直す */
+  revision: number;
+  /**
+   * 本文が古い(部品の反映などで外から変わった)。読み直すときは contentList[].thumbnailHtml
+   * ではなく io.loadContent から取る(thumbnailHtml は利用側が最初に渡した姿のままなので)
+   */
+  stale: boolean;
 }
 
+/** レイアウト済み(位置付き)のフレーム */
+export interface PageFrameLayout extends PageFrame {
+  position: { x: number; y: number };
+  index: number;
+}
+
+/** フレームの並べ方。tree = 階層(parentId)のツリー、grid = 行で折り返す */
+export type CanvasLayoutKind = 'grid' | 'tree';
+
 export interface CanvasViewState {
   canvasOffset: { x: number; y: number };
   canvasZoom: number;
+  /** 生きているエディタが載っているページ(利用側の currentContentId と同じ) */
   activePageId: string | null;
 }
 
-export interface MultiPageCanvasContextValue {
-  // ページフレーム管理
-  pages: PageFrame[];
-  getPage: (id: string) => PageFrame | undefined;
-  updatePageFrame: (id: string, updates: Partial<PageFrame>) => void;
+export interface CanvasBounds {
+  minX: number;
+  minY: number;
+  maxX: number;
+  maxY: number;
+}
+
+/** ビュー状態の外部ストア(購読した部品だけが描き直る) */
+export interface CanvasViewStore {
+  get: () => CanvasViewState;
+  set: (updater: (prev: CanvasViewState) => CanvasViewState) => void;
+  subscribe: (listener: () => void) => () => void;
+}
 
-  // ビュー状態
-  viewState: CanvasViewState;
+export interface MultiPageCanvasContextValue {
+  isEnabled: boolean;
+  editorMode: EditorMode;
+
+  // ---- ページフレーム
+  pages: PageFrameLayout[];
+  bounds: CanvasBounds;
+  /** 並べ方(contentList に階層があれば tree) */
+  layout: CanvasLayoutKind;
+  getPage: (id: string) => PageFrameLayout | undefined;
+  updatePageFrame: (id: string, updates: Partial<Omit<PageFrame, 'id'>>) => void;
+  /** 本文を差し替える(保存後・読み込み後) */
+  setPageHtml: (id: string, html: string) => void;
+  /**
+   * 見るだけの紙面の本文を捨てて読み直させる(部品の定義を更新して他ページが変わったとき等)。
+   * except のページ(編集中のページ)は触らない。読み直す手段(io.loadContent)が無ければ何もしない
+   */
+  invalidatePages: (options?: { except?: readonly (string | null | undefined)[] }) => void;
+  /** 文書(`<html>`)に付ける属性(利用側の documentAttributes)。紙面にも読み直さずに反映する */
+  documentAttributes: DocumentAttributes;
+  /**
+   * 高さの実測を反映する。source が 'preview' のときは、生きているページには効かない
+   * (エディタの実測が正。見るだけの紙面はフォントや画像の読み込み前に測ることがある)
+   */
+  setPageHeight: (id: string, height: number, source: 'editor' | 'preview') => void;
+  /** 本文がまだ無ければ読む(contentList の thumbnailHtml → io.loadContent) */
+  ensurePageHtml: (id: string) => Promise<void>;
+  /** 見るだけの紙面に足すスタイル(io.previewStyles。無ければ空) */
+  previewStyles: PreviewStyle[];
+
+  // ---- ビュー
+  /** 倍率・位置。描画に使うなら useCanvasViewState() で購読する。ハンドラから読むだけなら get() */
+  viewStore: CanvasViewStore;
   setCanvasOffset: (offset: { x: number; y: number }) => void;
   setCanvasZoom: (zoom: number) => void;
-
-  // ページ切替（Figmaスタイル: モード切替なし）
-  switchPage: (id: string) => void;
-
-  // 軽量ページフォーカス（iframe再読込なし、activePageId + contentId更新のみ）
-  focusPage: (id: string) => void;
-
-  // ページ配置
-  autoLayoutPages: () => void;
-
-  // ズーム操作
-  zoomToFit: (containerWidth: number, containerHeight: number) => void;
+  /** 倍率と位置を同時に決める(アニメーションも可) */
+  setView: (view: { zoom: number; offset: { x: number; y: number } }, options?: { animate?: boolean }) => void;
+  /** 画面上の点(容器の座標)を固定したまま倍率を変える */
+  zoomAt: (zoom: number, point: { x: number; y: number }) => void;
+  /** 容器の中心を固定して倍率を変える */
+  zoomTo: (zoom: number, options?: { animate?: boolean }) => void;
   zoomIn: () => void;
   zoomOut: () => void;
+  zoomToFit: (options?: { animate?: boolean }) => void;
+  zoomToPage: (id: string, options?: { animate?: boolean }) => void;
+  zoomToActual: () => void;
+  /** 指定のフレームが画面に入っていなければ、見える位置まで寄せる(倍率は変えない) */
+  revealPage: (id: string) => void;
 
-  // サムネイル更新
-  updateThumbnail: (id: string, dataUrl: string) => void;
-
-  // 有効化フラグ
-  isEnabled: boolean;
-
-  // グローバルUndo/Redoハンドラー (MultiPageCanvasViewから登録される)
-  undo: () => void;
-  redo: () => void;
-  canUndo: boolean;
-  canRedo: boolean;
-  registerUndoHandlers: (handlers: { undo: () => void; redo: () => void; canUndo: () => boolean; canRedo: () => boolean }) => void;
+  // ---- ページ切替
+  /**
+   * 編集するページを移す。中身の読み込みと未保存の変更の保存は利用側
+   * (onContentChange → FrontendVisualEditor.handleContentChange)が行う。
+   * 生きているエディタは本文が読めてから移る(activePageId はそのとき変わる)。
+   * 戻り値は移れたか
+   */
+  activatePage: (id: string, options?: { reveal?: boolean }) => Promise<boolean>;
+  /** 切替の途中(クリックしてから本文が読めるまで)のページ。リングはこちらへ先に移る */
+  activatingPageId: string | null;
+
+  // ---- 容器・操作状態
+  /** キャンバスの容器(ズームの基準になる矩形)。MultiPageCanvasView が登録する */
+  registerContainer: (el: HTMLDivElement | null) => void;
+  containerRef: React.MutableRefObject<HTMLDivElement | null>;
+  /** ホイール・ドラッグの最中(見るだけの紙面の当たり判定を切る) */
+  isInteracting: boolean;
+  markInteracting: () => void;
+  /** 見えている範囲を localStorage から復元できた(初回表示で全体表示を省く) */
+  initialViewRestored: boolean;
+  /** 定規 */
+  rulersVisible: boolean;
+  toggleRulers: () => void;
+  /**
+   * 見るだけの紙面の読み込み枠。同時に読むのは数枚まで(順番待ち。編集中のページに近い順)。
+   * 150 枚を一度に読むと、接続枠と主スレッドをそれらが占め、編集中のページの切替が
+   * 1 秒近く待たされる(実測 82ms → 912ms)
+   */
+  requestPreviewSlot: (id: string, grant: () => void) => void;
+  releasePreviewSlot: (id: string) => void;
 }
 
 // ============================================================
@@ -110,57 +233,203 @@ export function useMultiPageCanvas(): MultiPageCanvasContextValue {
   return context;
 }
 
-/**
- * マルチページキャンバスが有効な場合のみ値を返す（オプショナル使用用）
- */
+/** マルチページキャンバスが有効な場合のみ値を返す(オプショナル使用用) */
 export function useMultiPageCanvasOptional(): MultiPageCanvasContextValue | null {
   return useContext(MultiPageCanvasContext);
 }
 
+/** 倍率・位置を購読する(ズーム・パンのたびに描き直る部品だけが使う) */
+export function useCanvasViewState(): CanvasViewState {
+  const { viewStore } = useMultiPageCanvas();
+  return useSyncExternalStore(viewStore.subscribe, viewStore.get, viewStore.get);
+}
+
+const NULL_VIEW_STORE: CanvasViewStore = {
+  get: () => NULL_VIEW,
+  set: () => undefined,
+  subscribe: () => () => undefined,
+};
+const NULL_VIEW: CanvasViewState = { canvasOffset: { x: 0, y: 0 }, canvasZoom: 1, activePageId: null };
+
+/** キャンバスが無ければ null(単独表示でも同じ部品を使うとき用) */
+export function useCanvasViewStateOptional(): CanvasViewState | null {
+  const context = useContext(MultiPageCanvasContext);
+  const store = context?.viewStore ?? NULL_VIEW_STORE;
+  const state = useSyncExternalStore(store.subscribe, store.get, store.get);
+  return context ? state : null;
+}
+
 // ============================================================
-// レイアウト計算ユーティリティ
+// レイアウト
 // ============================================================
 
-function calculateAutoLayout(pages: PageFrame[]): PageFrame[] {
-  return pages.map((page, index) => ({
-    ...page,
-    position: {
-      x: index * (WEBPAGE_WIDTH + LAYOUT_GAP_X),
-      y: 0,
-    },
-    size: { width: WEBPAGE_WIDTH, height: page.size.height || WEBPAGE_MIN_HEIGHT },
-  }));
+function boundsOf(pages: PageFrameLayout[]): CanvasBounds {
+  return pages.length
+    ? {
+        minX: Math.min(...pages.map((p) => p.position.x)),
+        minY: Math.min(...pages.map((p) => p.position.y)),
+        maxX: Math.max(...pages.map((p) => p.position.x + p.size.width)),
+        maxY: Math.max(...pages.map((p) => p.position.y + p.size.height)),
+      }
+    : { minX: 0, minY: 0, maxX: 0, maxY: 0 };
 }
 
-function calculateFitZoom(
-  pages: PageFrame[],
-  containerWidth: number,
-  containerHeight: number
-): { zoom: number; offset: { x: number; y: number } } {
-  if (pages.length === 0) return { zoom: 0.5, offset: { x: 0, y: 0 } };
-
-  let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
-  pages.forEach(p => {
-    minX = Math.min(minX, p.position.x);
-    minY = Math.min(minY, p.position.y);
-    maxX = Math.max(maxX, p.position.x + p.size.width);
-    maxY = Math.max(maxY, p.position.y + p.size.height);
+/** 行で折り返す並べ方(階層が無いとき)。行の高さはその行で一番高いフレームに合わせる */
+function layoutGrid(frames: PageFrame[], gap: { x: number; y: number }, perRow: number): PageFrameLayout[] {
+  const pages: PageFrameLayout[] = [];
+  let x = 0;
+  let y = 0;
+  let rowHeight = 0;
+  frames.forEach((frame, index) => {
+    if (index > 0 && index % perRow === 0) {
+      x = 0;
+      y += rowHeight + gap.y;
+      rowHeight = 0;
+    }
+    pages.push({ ...frame, index, position: { x, y } });
+    x += frame.size.width + gap.x;
+    rowHeight = Math.max(rowHeight, frame.size.height);
   });
+  return pages;
+}
 
-  const totalWidth = maxX - minX;
-  const totalHeight = maxY - minY;
-  const padding = 80;
+/**
+ * 階層(parentId)のツリーで並べる(サイトマップの図と同じ姿)。
+ * - 深さごとに行を作り、行の高さはその深さで一番高いフレームに合わせる
+ * - 親は子の並び(部分木)の中央の上に置く。部分木の幅 = max(自分の幅, 子の部分木の幅の和 + 間隔)
+ * - 親が一覧に無い・循環しているものはルートとして左から順に置く
+ * 一覧の順(index)は変えない(フレーム名の番号・読み込みの順番待ちに使う)
+ */
+function layoutTree(frames: PageFrame[], gap: { x: number; y: number }): PageFrameLayout[] {
+  const byId = new Map(frames.map((f) => [f.id, f] as const));
+  const children = new Map<string, PageFrame[]>();
+  const roots: PageFrame[] = [];
+  // 循環の検出: 親をたどってルートに着くか(着かないものはルート扱い)
+  const reachesRoot = (f: PageFrame): boolean => {
+    const seen = new Set<string>([f.id]);
+    let cur: PageFrame | undefined = f;
+    while (cur?.parentId && byId.has(cur.parentId)) {
+      if (seen.has(cur.parentId)) return false;
+      seen.add(cur.parentId);
+      cur = byId.get(cur.parentId);
+    }
+    return true;
+  };
+  frames.forEach((f) => {
+    const parent = f.parentId && f.parentId !== f.id && byId.has(f.parentId) && reachesRoot(f) ? f.parentId : null;
+    if (parent) {
+      const list = children.get(parent) ?? [];
+      list.push(f);
+      children.set(parent, list);
+    } else {
+      roots.push(f);
+    }
+  });
+  const subtreeWidth = new Map<string, number>();
+  const widthOf = (f: PageFrame): number => {
+    const cached = subtreeWidth.get(f.id);
+    if (cached != null) return cached;
+    const kids = children.get(f.id) ?? [];
+    const kidsWidth = kids.reduce((sum, k, i) => sum + widthOf(k) + (i > 0 ? gap.x : 0), 0);
+    const w = Math.max(f.size.width, kidsWidth);
+    subtreeWidth.set(f.id, w);
+    return w;
+  };
+  // 深さと行の高さ
+  const depthOf = new Map<string, number>();
+  const rowHeight: number[] = [];
+  const walk = (f: PageFrame, d: number) => {
+    depthOf.set(f.id, d);
+    rowHeight[d] = Math.max(rowHeight[d] ?? 0, f.size.height);
+    (children.get(f.id) ?? []).forEach((k) => walk(k, d + 1));
+  };
+  roots.forEach((r) => walk(r, 0));
+  const rowY: number[] = [];
+  rowHeight.forEach((h, d) => {
+    rowY[d] = d === 0 ? 0 : rowY[d - 1] + rowHeight[d - 1] + gap.y;
+  });
+  const position = new Map<string, { x: number; y: number }>();
+  const place = (f: PageFrame, x0: number) => {
+    const d = depthOf.get(f.id) ?? 0;
+    const w = widthOf(f);
+    position.set(f.id, { x: x0 + (w - f.size.width) / 2, y: rowY[d] ?? 0 });
+    const kids = children.get(f.id) ?? [];
+    const kidsWidth = kids.reduce((sum, k, i) => sum + widthOf(k) + (i > 0 ? gap.x : 0), 0);
+    let cx = x0 + (w - kidsWidth) / 2;
+    kids.forEach((k) => {
+      place(k, cx);
+      cx += widthOf(k) + gap.x;
+    });
+  };
+  let x = 0;
+  roots.forEach((r) => {
+    place(r, x);
+    x += widthOf(r) + gap.x;
+  });
+  return frames.map((f, index) => {
+    const p = position.get(f.id) ?? { x: 0, y: 0 };
+    return { ...f, index, depth: depthOf.get(f.id) ?? 0, position: { x: Math.round(p.x), y: Math.round(p.y) } };
+  });
+}
 
-  const scaleX = (containerWidth - padding * 2) / totalWidth;
-  const scaleY = (containerHeight - padding * 2) / totalHeight;
-  const zoom = Math.min(scaleX, scaleY, 1);
+/**
+ * 寸法から位置を決める。contentList に階層(parentId)があればツリー、無ければ行で折り返す。
+ * 位置を状態に持たないので、高さが実測で変わっても流れ直すだけで済む
+ */
+export function layoutFrames(
+  frames: PageFrame[],
+  editorMode: EditorMode,
+): { pages: PageFrameLayout[]; bounds: CanvasBounds; layout: CanvasLayoutKind } {
+  const gap = GAP[editorMode];
+  const ids = new Set(frames.map((f) => f.id));
+  const hasHierarchy = frames.some((f) => f.parentId && f.parentId !== f.id && ids.has(f.parentId));
+  const pages = hasHierarchy ? layoutTree(frames, gap) : layoutGrid(frames, gap, WRAP_AT[editorMode](frames.length));
+  return { pages, bounds: boundsOf(pages), layout: hasHierarchy ? 'tree' : 'grid' };
+}
 
-  const offset = {
-    x: (containerWidth - totalWidth * zoom) / 2 - minX * zoom,
-    y: (containerHeight - totalHeight * zoom) / 2 - minY * zoom,
+function fitView(
+  rect: CanvasBounds,
+  container: { width: number; height: number },
+  options: { padding: number; maxZoom: number; rulers: boolean },
+): { zoom: number; offset: { x: number; y: number } } {
+  const inset = options.rulers ? RULER_SIZE : 0;
+  const availW = Math.max(1, container.width - inset - options.padding * 2);
+  const availH = Math.max(1, container.height - inset - options.padding * 2);
+  const w = Math.max(1, rect.maxX - rect.minX);
+  const h = Math.max(1, rect.maxY - rect.minY);
+  const zoom = Math.max(MIN_ZOOM, Math.min(options.maxZoom, availW / w, availH / h));
+  return {
+    zoom,
+    offset: {
+      x: inset + (container.width - inset - w * zoom) / 2 - rect.minX * zoom,
+      y: inset + (container.height - inset - h * zoom) / 2 - rect.minY * zoom,
+    },
   };
+}
 
-  return { zoom: Math.max(zoom, MIN_ZOOM), offset };
+const clampZoom = (z: number) => Math.max(MIN_ZOOM, Math.min(MAX_ZOOM, z));
+const easeOutCubic = (t: number) => 1 - Math.pow(1 - t, 3);
+const prefersReducedMotion = () =>
+  typeof matchMedia !== 'undefined' && matchMedia('(prefers-reduced-motion: reduce)').matches;
+
+function createViewStore(initial: CanvasViewState): CanvasViewStore {
+  let state = initial;
+  const listeners = new Set<() => void>();
+  return {
+    get: () => state,
+    set: (updater) => {
+      const next = updater(state);
+      if (next === state) return;
+      state = next;
+      listeners.forEach((l) => l());
+    },
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+  };
 }
 
 // ============================================================
@@ -170,311 +439,545 @@ function calculateFitZoom(
 interface MultiPageCanvasProviderProps {
   children: React.ReactNode;
   enabled: boolean;
+  /** 見えている範囲を保存するキー(利用側の parentId 等)。無ければ保存しない */
+  storageKey?: string | null;
 }
 
-export function MultiPageCanvasProvider({
-  children,
-  enabled,
-}: MultiPageCanvasProviderProps) {
+type PersistedView = { zoom: number; offset: { x: number; y: number }; rulers?: boolean };
+
+function readPersistedView(key: string | null | undefined): PersistedView | null {
+  if (!key || typeof localStorage === 'undefined') return null;
+  try {
+    const raw = localStorage.getItem(`gg-editor:canvas-view:${key}`);
+    if (!raw) return null;
+    const v = JSON.parse(raw) as PersistedView;
+    if (!Number.isFinite(v.zoom) || !v.offset || !Number.isFinite(v.offset.x) || !Number.isFinite(v.offset.y)) return null;
+    return v;
+  } catch {
+    return null;
+  }
+}
+
+export function MultiPageCanvasProvider({ children, enabled, storageKey }: MultiPageCanvasProviderProps) {
   const artboard = useEditorArtboard();
-  const history = useEditorHistory();
-  const refs = useEditorRefs();
-
-  // ページフレーム状態
-  const [pagesMap, setPagesMap] = useState<Map<string, PageFrame>>(new Map());
-  const [isLayoutInitialized, setIsLayoutInitialized] = useState(false);
-
-  // ビュー状態（モードなし — 常に統合ビュー）
-  const [viewState, setViewState] = useState<CanvasViewState>({
-    canvasOffset: { x: 0, y: 0 },
-    canvasZoom: 0.15,
-    activePageId: null,
-  });
+  const { editorMode } = useEditorTool();
+  const { viewportWidth } = useEditorView();
 
-  // contentListからページフレームを同期
-  const prevContentListRef = useRef<string>('');
-  useEffect(() => {
-    if (!enabled) return;
+  const frameWidth = editorMode === 'webpage' ? viewportWidth : SLIDE_WIDTH;
+  const defaultHeight = editorMode === 'webpage' ? WEBPAGE_MIN_HEIGHT : SLIDE_HEIGHT;
 
-    const contentListKey = artboard.contentList.map(c => c.id).join(',');
-    if (contentListKey === prevContentListRef.current) return;
-    prevContentListRef.current = contentListKey;
+  // ---- フレーム(寸法・本文)
+  const [framesMap, setFramesMap] = useState<Map<string, PageFrame>>(() => new Map());
+  const framesMapRef = useRef(framesMap);
+  framesMapRef.current = framesMap;
 
-    setPagesMap(prev => {
-      const newMap = new Map<string, PageFrame>();
-      artboard.contentList.forEach(content => {
+  // contentList からフレームを同期(既存の実測・本文は保つ)
+  const currentContentIdRef = useRef(artboard.currentContentId);
+  currentContentIdRef.current = artboard.currentContentId;
+  useEffect(() => {
+    if (!enabled) return;
+    const ids = new Set(artboard.contentList.map((c) => c.id));
+    const depths = computeContentDepths(artboard.contentList);
+    setFramesMap((prev) => {
+      const next = new Map<string, PageFrame>();
+      let changed = prev.size !== artboard.contentList.length;
+      artboard.contentList.forEach((content) => {
         const existing = prev.get(content.id);
+        const parentId = content.parentId && ids.has(content.parentId) && content.parentId !== content.id ? content.parentId : null;
+        const depth = depths.get(content.id) ?? 0;
+        const revision = content.revision ?? 0;
+        const href = content.href;
         if (existing) {
-          newMap.set(content.id, {
-            ...existing,
-            title: content.title,
-            html: content.thumbnailHtml || existing.html,
-            thumbnailHtml: content.thumbnailHtml || existing.thumbnailHtml,
-          });
+          const title = content.title || existing.title;
+          const width = frameWidth;
+          // 利用側が版を進めた = 本文が外から変わった。編集中のページは触らず(編集中の本文が正)、
+          // 他のページは本文を捨てて読み直させる(紙面は次の本文が来るまで前の姿のまま)
+          const bumped = revision !== existing.revision;
+          const isLive = content.id === currentContentIdRef.current;
+          const html = bumped && !isLive ? null : existing.html ?? content.thumbnailHtml ?? null;
+          const stale = bumped && !isLive ? true : existing.stale;
+          if (
+            title !== existing.title || html !== existing.html || width !== existing.size.width ||
+            parentId !== existing.parentId || depth !== existing.depth || href !== existing.href ||
+            revision !== existing.revision || stale !== existing.stale
+          ) changed = true;
+          next.set(content.id, { ...existing, title, html, stale, parentId, depth, href, revision, size: { width, height: existing.size.height } });
         } else {
-          newMap.set(content.id, {
+          changed = true;
+          next.set(content.id, {
             id: content.id,
-            title: content.title,
-            position: { x: 0, y: 0 },
-            size: { width: WEBPAGE_WIDTH, height: WEBPAGE_MIN_HEIGHT },
-            thumbnailHtml: content.thumbnailHtml || '',
-            thumbnailDataUrl: null,
+            title: content.title || '',
+            html: content.thumbnailHtml ?? null,
+            loading: false,
+            error: null,
+            size: { width: frameWidth, height: defaultHeight },
+            measured: editorMode === 'slide',
             isDirty: false,
-            html: content.thumbnailHtml || '',
+            parentId,
+            depth,
+            href,
+            revision,
+            stale: false,
           });
         }
       });
-      return newMap;
+      return changed ? next : prev;
     });
-    setIsLayoutInitialized(false);
-  }, [enabled, artboard.contentList]);
-
-  // 初期レイアウト
-  useEffect(() => {
-    if (!enabled || isLayoutInitialized || pagesMap.size === 0) return;
-    setPagesMap(prev => {
-      const pages = Array.from(prev.values());
-      const laid = calculateAutoLayout(pages);
-      const newMap = new Map<string, PageFrame>();
-      laid.forEach(p => newMap.set(p.id, p));
-      return newMap;
-    });
-    setIsLayoutInitialized(true);
-  }, [enabled, isLayoutInitialized, pagesMap.size]);
-
-  // 初回: 最初のページを自動アクティブ化
-  useEffect(() => {
-    if (!enabled || viewState.activePageId) return;
-    if (artboard.contentList.length > 0) {
-      const firstId = artboard.contentList[0].id;
-      setViewState(prev => ({ ...prev, activePageId: firstId }));
-    }
-  }, [enabled, artboard.contentList, viewState.activePageId]);
-
-  // ページ配列（順序付き）
-  const pages = useMemo(() => {
-    const contentOrder = artboard.contentList.map(c => c.id);
-    return Array.from(pagesMap.values()).sort(
-      (a, b) => contentOrder.indexOf(a.id) - contentOrder.indexOf(b.id)
-    );
-  }, [pagesMap, artboard.contentList]);
-
-  // --- コールバック ---
-
-  const getPage = useCallback((id: string) => pagesMap.get(id), [pagesMap]);
-
-  const updatePageFrame = useCallback((id: string, updates: Partial<PageFrame>) => {
-    setPagesMap(prev => {
+  }, [enabled, artboard.contentList, frameWidth, defaultHeight, editorMode]);
+
+  const { pages, bounds, layout } = useMemo(() => {
+    const order = artboard.contentList.map((c) => c.id);
+    const frames = order.map((id) => framesMap.get(id)).filter((f): f is PageFrame => !!f);
+    return layoutFrames(frames, editorMode);
+  }, [framesMap, artboard.contentList, editorMode]);
+  const pagesRef = useRef(pages);
+  pagesRef.current = pages;
+  const boundsRef = useRef(bounds);
+  boundsRef.current = bounds;
+
+  const getPage = useCallback((id: string) => pagesRef.current.find((p) => p.id === id), []);
+
+  const updatePageFrame = useCallback<MultiPageCanvasContextValue['updatePageFrame']>((id, updates) => {
+    setFramesMap((prev) => {
       const existing = prev.get(id);
       if (!existing) return prev;
-      const newMap = new Map(prev);
-      newMap.set(id, { ...existing, ...updates });
-      return newMap;
+      const merged = { ...existing, ...updates };
+      // 変わっていなければ参照を保つ(レイアウト再計算・再描画を起こさない)
+      const same = (Object.keys(updates) as (keyof typeof updates)[]).every((k) => {
+        const a = existing[k];
+        const b = merged[k];
+        if (k === 'size') {
+          const sa = a as PageFrame['size'];
+          const sb = b as PageFrame['size'];
+          return sa.width === sb.width && sa.height === sb.height;
+        }
+        return a === b;
+      });
+      if (same) return prev;
+      const next = new Map(prev);
+      next.set(id, merged);
+      return next;
     });
   }, []);
 
-  const setCanvasOffset = useCallback((offset: { x: number; y: number }) => {
-    setViewState(prev => ({ ...prev, canvasOffset: offset }));
-  }, []);
+  const setPageHtml = useCallback(
+    (id: string, html: string) => updatePageFrame(id, { html, loading: false, error: null, stale: false }),
+    [updatePageFrame],
+  );
 
-  const setCanvasZoom = useCallback((zoom: number) => {
-    setViewState(prev => ({
-      ...prev,
-      canvasZoom: Math.max(MIN_ZOOM, Math.min(MAX_ZOOM, zoom)),
-    }));
+  // 見るだけの紙面の本文を捨てて読み直させる(部品の反映など、外からファイルが変わったとき)
+  const invalidatePages = useCallback<MultiPageCanvasContextValue['invalidatePages']>((options) => {
+    if (!io().loadContent) return; // 読み直す手段が無い(thumbnailHtml は最初の姿のままなので読み直しにならない)
+    const except = new Set((options?.except ?? []).filter((id): id is string => !!id));
+    setFramesMap((prev) => {
+      let changed = false;
+      const next = new Map(prev);
+      prev.forEach((frame, id) => {
+        if (except.has(id) || frame.html == null) return;
+        next.set(id, { ...frame, html: null, loading: false, error: null, stale: true });
+        changed = true;
+      });
+      return changed ? next : prev;
+    });
   }, []);
 
-  // Stale closure回避用ref
-  const activePageIdRef = useRef<string | null>(null);
-  activePageIdRef.current = viewState.activePageId;
-  const pagesMapRef = useRef(pagesMap);
-  pagesMapRef.current = pagesMap;
-
-  /**
-   * ページ切替（Figmaスタイル）
-   * 1. 現在のページのHTMLをサムネイルに保存
-   * 2. 新しいページのキャッシュHTMLをiframeにロード
-   * 3. 履歴クリア
-   * 4. activePageId更新
-   * 5. API経由で最新HTML非同期取得
-   */
-  const switchPage = useCallback((id: string) => {
-    const currentPagesMap = pagesMapRef.current;
-    const page = currentPagesMap.get(id);
-    if (!page) {
-      console.warn('[MultiPageCanvas] switchPage: page not found:', id);
-      return;
-    }
-
-    const currentActiveId = activePageIdRef.current;
-    if (currentActiveId === id) return; // 同じページなら何もしない
-
-    // 1. 現在のページのHTMLをサムネイルに保存
-    if (currentActiveId) {
-      const currentEditHtml = history.html;
-      if (currentEditHtml) {
-        updatePageFrame(currentActiveId, { thumbnailHtml: currentEditHtml });
+  // ---- ビュー状態(外部ストア。ズーム・パンで Context の値は変えない)
+  const persisted = useMemo(() => readPersistedView(storageKey), [storageKey]);
+  const [viewStore] = useState<CanvasViewStore>(() =>
+    createViewStore({
+      canvasOffset: persisted?.offset ?? { x: 0, y: 0 },
+      canvasZoom: persisted ? clampZoom(persisted.zoom) : 0.25,
+      activePageId: artboard.currentContentId ?? null,
+    }),
+  );
+  const [rulersVisible, setRulersVisible] = useState<boolean>(persisted?.rulers ?? true);
+  const rulersRef = useRef(rulersVisible);
+  rulersRef.current = rulersVisible;
+
+  const setPageHeight = useCallback<MultiPageCanvasContextValue['setPageHeight']>(
+    (id, height, source) => {
+      if (!Number.isFinite(height) || height <= 0) return;
+      if (source === 'preview' && viewStore.get().activePageId === id) {
+        // 生きているページはエディタの実測が正。ただし一度も測っていなければ受ける
+        const frame = framesMapRef.current.get(id);
+        if (frame?.measured) return;
       }
-    }
+      const frame = framesMapRef.current.get(id);
+      if (!frame) return;
+      const h = Math.max(200, Math.round(height));
+      if (frame.measured && Math.abs(frame.size.height - h) < 1) return;
+      updatePageFrame(id, { size: { width: frame.size.width, height: h }, measured: true });
+    },
+    [updatePageFrame, viewStore],
+  );
 
-    // 2. 新しいページのHTMLをセット
-    const newHtml = page.thumbnailHtml || '';
-    history.setHtml(newHtml);
-    history.clearHistory();
-
-    // 3. iframeを新しいHTMLでリロード
-    const iframe = refs.iframeRef.current;
-    if (iframe) {
-      refs.setIframeReady(false);
-      const blob = new Blob([generateEditableHtml(newHtml, 'webpage')], { type: 'text/html' });
-      iframe.src = URL.createObjectURL(blob);
-    }
+  // 生きているページは利用側(currentContentId)と揃える。
+  // 本文が読めて currentContentId が変わったときに初めてエディタが移る
+  // (クリックの時点では移さない。移すと前のページの本文が新しい枠に見えてしまう)
+  useEffect(() => {
+    if (!enabled) return;
+    const id = artboard.currentContentId ?? artboard.contentList[0]?.id ?? null;
+    viewStore.set((prev) => (prev.activePageId === id ? prev : { ...prev, activePageId: id }));
+  }, [enabled, artboard.currentContentId, artboard.contentList, viewStore]);
 
-    // 4. activePageId更新
-    setViewState(prev => ({ ...prev, activePageId: id }));
+  // 見えている範囲の保存(変化が止まってから)
+  useEffect(() => {
+    if (!storageKey || typeof localStorage === 'undefined') return;
+    let timer: ReturnType<typeof setTimeout> | null = null;
+    const persist = () => {
+      if (timer) clearTimeout(timer);
+      timer = setTimeout(() => {
+        timer = null;
+        try {
+          const { canvasZoom, canvasOffset } = viewStore.get();
+          const v: PersistedView = { zoom: canvasZoom, offset: canvasOffset, rulers: rulersRef.current };
+          localStorage.setItem(`gg-editor:canvas-view:${storageKey}`, JSON.stringify(v));
+        } catch {
+          /* 保存できなくても表示には影響しない */
+        }
+      }, 250);
+    };
+    const unsubscribe = viewStore.subscribe(persist);
+    persist();
+    return () => {
+      unsubscribe();
+      if (timer) clearTimeout(timer);
+    };
+  }, [storageKey, viewStore, rulersVisible]);
+
+  // ---- 容器
+  const containerRef = useRef<HTMLDivElement | null>(null);
+  const registerContainer = useCallback((el: HTMLDivElement | null) => {
+    containerRef.current = el;
+  }, []);
+  const containerSize = () => {
+    const el = containerRef.current;
+    if (!el) return { width: 1200, height: 800 };
+    return { width: el.clientWidth || 1200, height: el.clientHeight || 800 };
+  };
 
-    // 5. API経由で最新HTMLを非同期取得
-    if (artboard.onContentChange && id !== artboard.currentContentId) {
-      artboard.onContentChange(id);
+  // ---- アニメーション
+  const animationRef = useRef<number | null>(null);
+  const cancelAnimation = () => {
+    if (animationRef.current != null) {
+      cancelAnimationFrame(animationRef.current);
+      animationRef.current = null;
     }
+  };
 
-    console.log('[MultiPageCanvas] switchPage:', currentActiveId, '→', id);
-  }, [history, refs, artboard, updatePageFrame]);
-
-  /**
-   * 軽量ページフォーカス（キャンバスモード専用）
-   * iframeを再読込せず、activePageIdとcontentIdのみ更新
-   * → レイヤーパネル・CSS/JS・ページ設定が正しいページに切り替わる
-   */
-  const focusPage = useCallback((id: string) => {
-    const currentActiveId = activePageIdRef.current;
-    if (currentActiveId === id) return;
-
-    // activePageId更新 → レイヤーパネルが正しいページを表示
-    setViewState(prev => ({ ...prev, activePageId: id }));
-
-    // contentId更新 → CSS/JS/ページ設定が正しいページから読み込まれる
-    if (artboard.onContentChange && id !== artboard.currentContentId) {
-      artboard.onContentChange(id);
+  const setView = useCallback<MultiPageCanvasContextValue['setView']>((view, options) => {
+    cancelAnimation();
+    const target = { zoom: clampZoom(view.zoom), offset: view.offset };
+    if (!options?.animate || prefersReducedMotion()) {
+      viewStore.set((prev) => ({ ...prev, canvasZoom: target.zoom, canvasOffset: target.offset }));
+      return;
     }
+    const from = { zoom: viewStore.get().canvasZoom, offset: viewStore.get().canvasOffset };
+    const start = performance.now();
+    const tick = (now: number) => {
+      const t = Math.min(1, (now - start) / VIEW_ANIMATION_MS);
+      const k = easeOutCubic(t);
+      // 倍率は対数で補間する(拡大と縮小で速さが揃う)
+      const zoom = Math.exp(Math.log(from.zoom) + (Math.log(target.zoom) - Math.log(from.zoom)) * k);
+      const offset = {
+        x: from.offset.x + (target.offset.x - from.offset.x) * k,
+        y: from.offset.y + (target.offset.y - from.offset.y) * k,
+      };
+      viewStore.set((prev) => ({ ...prev, canvasZoom: zoom, canvasOffset: offset }));
+      if (t < 1) animationRef.current = requestAnimationFrame(tick);
+      else animationRef.current = null;
+    };
+    animationRef.current = requestAnimationFrame(tick);
+  }, [viewStore]);
+  useEffect(() => () => cancelAnimation(), []);
 
-    console.log('[MultiPageCanvas] focusPage:', currentActiveId, '→', id);
-  }, [artboard]);
+  const setCanvasOffset = useCallback((offset: { x: number; y: number }) => {
+    cancelAnimation();
+    viewStore.set((prev) => ({ ...prev, canvasOffset: offset }));
+  }, [viewStore]);
 
-  const autoLayoutPages = useCallback(() => {
-    setPagesMap(prev => {
-      const pageArray = Array.from(prev.values());
-      const laid = calculateAutoLayout(pageArray);
-      const newMap = new Map<string, PageFrame>();
-      laid.forEach(p => newMap.set(p.id, p));
-      return newMap;
+  const setCanvasZoom = useCallback((zoom: number) => {
+    cancelAnimation();
+    viewStore.set((prev) => ({ ...prev, canvasZoom: clampZoom(zoom) }));
+  }, [viewStore]);
+
+  const zoomAt = useCallback<MultiPageCanvasContextValue['zoomAt']>((zoom, point) => {
+    cancelAnimation();
+    viewStore.set((prev) => {
+      const next = clampZoom(zoom);
+      if (next === prev.canvasZoom) return prev;
+      const ratio = next / prev.canvasZoom;
+      return {
+        ...prev,
+        canvasZoom: next,
+        canvasOffset: {
+          x: point.x - (point.x - prev.canvasOffset.x) * ratio,
+          y: point.y - (point.y - prev.canvasOffset.y) * ratio,
+        },
+      };
     });
-  }, []);
+  }, [viewStore]);
+
+  const zoomTo = useCallback<MultiPageCanvasContextValue['zoomTo']>(
+    (zoom, options) => {
+      const { width, height } = containerSize();
+      const inset = rulersRef.current ? RULER_SIZE : 0;
+      const center = { x: inset + (width - inset) / 2, y: inset + (height - inset) / 2 };
+      const prev = viewStore.get();
+      const next = clampZoom(zoom);
+      const ratio = next / prev.canvasZoom;
+      setView(
+        {
+          zoom: next,
+          offset: {
+            x: center.x - (center.x - prev.canvasOffset.x) * ratio,
+            y: center.y - (center.y - prev.canvasOffset.y) * ratio,
+          },
+        },
+        options,
+      );
+    },
+    [setView, viewStore],
+  );
 
-  const zoomToFit = useCallback((containerWidth: number, containerHeight: number) => {
-    const pageArray = Array.from(pagesMap.values());
-    const { zoom, offset } = calculateFitZoom(pageArray, containerWidth, containerHeight);
-    setViewState(prev => ({
-      ...prev,
-      canvasZoom: zoom,
-      canvasOffset: offset,
-    }));
-  }, [pagesMap]);
-
-  const zoomIn = useCallback(() => {
-    setViewState(prev => ({
-      ...prev,
-      canvasZoom: Math.min(MAX_ZOOM, prev.canvasZoom * 1.25),
-    }));
-  }, []);
+  const zoomIn = useCallback(() => zoomTo(viewStore.get().canvasZoom * ZOOM_STEP, { animate: true }), [zoomTo, viewStore]);
+  const zoomOut = useCallback(() => zoomTo(viewStore.get().canvasZoom / ZOOM_STEP, { animate: true }), [zoomTo, viewStore]);
+  const zoomToActual = useCallback(() => zoomTo(1, { animate: true }), [zoomTo]);
 
-  const zoomOut = useCallback(() => {
-    setViewState(prev => ({
-      ...prev,
-      canvasZoom: Math.max(MIN_ZOOM, prev.canvasZoom * 0.8),
-    }));
-  }, []);
+  const zoomToFit = useCallback<MultiPageCanvasContextValue['zoomToFit']>(
+    (options) => {
+      if (!pagesRef.current.length) return;
+      setView(fitView(boundsRef.current, containerSize(), { padding: FIT_PADDING, maxZoom: 1, rulers: rulersRef.current }), options);
+    },
+    [setView],
+  );
 
-  const updateThumbnail = useCallback((id: string, dataUrl: string) => {
-    setPagesMap(prev => {
-      const existing = prev.get(id);
-      if (!existing) return prev;
-      const newMap = new Map(prev);
-      newMap.set(id, { ...existing, thumbnailDataUrl: dataUrl });
-      return newMap;
-    });
-  }, []);
+  const zoomToPage = useCallback<MultiPageCanvasContextValue['zoomToPage']>(
+    (id, options) => {
+      const page = pagesRef.current.find((p) => p.id === id);
+      if (!page) return;
+      const rect = {
+        minX: page.position.x,
+        minY: page.position.y,
+        maxX: page.position.x + page.size.width,
+        maxY: page.position.y + page.size.height,
+      };
+      const { width, height } = containerSize();
+      // 長いページは全体を収めると小さすぎる。幅を合わせて先頭を見せる(Figma のフレーム選択と同じ感覚)
+      const fitted = fitView(rect, { width, height }, { padding: FIT_PADDING, maxZoom: 1, rulers: rulersRef.current });
+      const inset = rulersRef.current ? RULER_SIZE : 0;
+      const widthZoom = Math.min(1, (width - inset - FIT_PADDING * 2) / page.size.width);
+      if (fitted.zoom < widthZoom * 0.6) {
+        const zoom = clampZoom(widthZoom);
+        setView(
+          {
+            zoom,
+            offset: {
+              x: inset + (width - inset - page.size.width * zoom) / 2 - page.position.x * zoom,
+              y: inset + FIT_PADDING - page.position.y * zoom,
+            },
+          },
+          options,
+        );
+        return;
+      }
+      setView(fitted, options);
+    },
+    [setView],
+  );
 
-  // --- グローバルUndo/Redoハンドラー用のState ---
-  const [undoHandlers, setUndoHandlers] = useState({
-    undo: () => {},
-    redo: () => {},
-    canUndo: false,
-    canRedo: false,
-  });
+  const revealPage = useCallback<MultiPageCanvasContextValue['revealPage']>(
+    (id) => {
+      const page = pagesRef.current.find((p) => p.id === id);
+      if (!page) return;
+      const { width, height } = containerSize();
+      const { canvasZoom: z, canvasOffset: o } = viewStore.get();
+      const inset = rulersRef.current ? RULER_SIZE : 0;
+      const left = o.x + page.position.x * z;
+      const top = o.y + page.position.y * z;
+      const right = left + page.size.width * z;
+      const bottom = top + page.size.height * z;
+      const margin = 48;
+      // 一部でも見えていればそのまま。見えていなければ、そのフレームの左上を画面へ寄せる
+      const visible = right > inset + margin && left < width - margin && bottom > inset + margin && top < height - margin;
+      if (visible) return;
+      const w = page.size.width * z;
+      const h = page.size.height * z;
+      const offset = {
+        x: w <= width - inset ? inset + (width - inset - w) / 2 - page.position.x * z : inset + margin - page.position.x * z,
+        y: h <= height - inset ? inset + (height - inset - h) / 2 - page.position.y * z : inset + margin - page.position.y * z,
+      };
+      setView({ zoom: z, offset }, { animate: true });
+    },
+    [setView, viewStore],
+  );
 
-  const registerUndoHandlers = useCallback((handlers: { undo: () => void; redo: () => void; canUndo: () => boolean; canRedo: () => boolean }) => {
-    // 参照を保持し、再レンダリングをトリガーするためにはcanUndo()の状態を追跡する必要があるが、
-    // ここでは簡易的に関数のみ登録し、判定は都度させる（必要に応じてフラグ化）
-    setUndoHandlers({
-      undo: handlers.undo,
-      redo: handlers.redo,
-      // React state is not ideal for this real-time check inside Toolbar, but we pass getters for now
-      canUndo: handlers.canUndo(),
-      canRedo: handlers.canRedo(),
-    });
+  // ---- 本文の読み込み
+  const loadingRef = useRef(new Set<string>());
+  const ensurePageHtml = useCallback<MultiPageCanvasContextValue['ensurePageHtml']>(
+    async (id) => {
+      const frame = framesMapRef.current.get(id);
+      if (!frame || frame.html != null || loadingRef.current.has(id)) return;
+      const loader = io().loadContent;
+      // 最初は利用側が渡した本文(thumbnailHtml)で足りる。外から変わった(stale)あとは loadContent で読み直す
+      const fromList = artboard.contentList.find((c) => c.id === id)?.thumbnailHtml;
+      if (fromList != null && !(frame.stale && loader)) {
+        setPageHtml(id, fromList);
+        return;
+      }
+      if (!loader) return;
+      loadingRef.current.add(id);
+      updatePageFrame(id, { loading: true, error: null });
+      try {
+        const html = await loader(id);
+        setPageHtml(id, html ?? '');
+      } catch (e) {
+        updatePageFrame(id, { loading: false, error: e instanceof Error ? e.message : String(e) });
+      } finally {
+        loadingRef.current.delete(id);
+      }
+    },
+    [artboard.contentList, setPageHtml, updatePageFrame],
+  );
 
-    // To dynamically update Toolbar when stacks change, we'd need MultiPageCanvasView to call this repeatedly, 
-    // or expose them as refs. For now, Toolbar evaluates button state on render or we expose static getters.
-    // Let's modify the interface to use getters/setters properly if needed, but for now just pass the object.
-  }, []);
+  // ---- 見るだけの紙面のスタイル(利用側から 1 回だけ取る)
+  const [previewStyles, setPreviewStyles] = useState<PreviewStyle[]>([]);
+  useEffect(() => {
+    if (!enabled) return;
+    const loader = io().previewStyles;
+    if (!loader) return;
+    let alive = true;
+    Promise.resolve()
+      .then(() => loader())
+      .then((styles) => { if (alive && Array.isArray(styles)) setPreviewStyles(styles); })
+      .catch((e) => console.warn('[MultiPageCanvas] previewStyles を取れませんでした:', e));
+    return () => { alive = false; };
+  }, [enabled]);
+
+  // ---- ページ切替
+  // 保存と読み込みは利用側(FrontendVisualEditor.handleContentChange)が 1 か所で行う。
+  // ここでは「どこへ移ろうとしているか」を持ち、リングを先に動かして押した手応えを返す
+  const [activatingPageId, setActivatingPageId] = useState<string | null>(null);
+  const onContentChangeRef = useRef(artboard.onContentChange);
+  onContentChangeRef.current = artboard.onContentChange;
+  const activatePage = useCallback<MultiPageCanvasContextValue['activatePage']>(
+    async (id, options) => {
+      if (!framesMapRef.current.has(id)) return false;
+      if (viewStore.get().activePageId === id) {
+        if (options?.reveal) revealPage(id);
+        return true;
+      }
+      const notify = onContentChangeRef.current;
+      if (!notify) return false;
+      setActivatingPageId(id);
+      if (options?.reveal) revealPage(id);
+      try {
+        const result = await (notify as (contentId: string) => unknown)(id);
+        return result !== false;
+      } finally {
+        setActivatingPageId((v) => (v === id ? null : v));
+      }
+    },
+    [revealPage, viewStore],
+  );
 
-  // --- Context値 ---
-
-  const value = useMemo<MultiPageCanvasContextValue>(() => ({
-    pages,
-    getPage,
-    updatePageFrame,
-    viewState,
-    setCanvasOffset,
-    setCanvasZoom,
-    switchPage,
-    focusPage,
-    autoLayoutPages,
-    zoomToFit,
-    zoomIn,
-    zoomOut,
-    updateThumbnail,
-    isEnabled: enabled,
-    undo: undoHandlers.undo,
-    redo: undoHandlers.redo,
-    canUndo: undoHandlers.canUndo,
-    canRedo: undoHandlers.canRedo,
-    registerUndoHandlers,
-  }), [
-    pages,
-    getPage,
-    updatePageFrame,
-    viewState,
-    setCanvasOffset,
-    setCanvasZoom,
-    switchPage,
-    focusPage,
-    autoLayoutPages,
-    zoomToFit,
-    zoomIn,
-    zoomOut,
-    updateThumbnail,
-    enabled,
-    undoHandlers,
-    registerUndoHandlers,
-  ]);
+  // ---- 操作状態
+  const [isInteracting, setIsInteracting] = useState(false);
+  const interactingTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const markInteracting = useCallback(() => {
+    setIsInteracting(true);
+    if (interactingTimer.current) clearTimeout(interactingTimer.current);
+    interactingTimer.current = setTimeout(() => setIsInteracting(false), 160);
+  }, []);
+  useEffect(() => () => { if (interactingTimer.current) clearTimeout(interactingTimer.current); }, []);
+
+  const toggleRulers = useCallback(() => setRulersVisible((v) => !v), []);
+
+  // ---- 見るだけの紙面の読み込み枠(同時に PREVIEW_PARALLEL 枚まで。編集中のページに近い順)
+  const slotQueueRef = useRef<{ id: string; grant: () => void }[]>([]);
+  const slotHoldersRef = useRef(new Set<string>());
+  const pumpPreviewSlots = useCallback(() => {
+    const holders = slotHoldersRef.current;
+    const queue = slotQueueRef.current;
+    if (holders.size >= PREVIEW_PARALLEL || queue.length === 0) return;
+    const indexById = new Map(pagesRef.current.map((p) => [p.id, p.index] as const));
+    const indexOf = (id: string) => indexById.get(id) ?? 0;
+    const activeId = viewStore.get().activePageId;
+    const activeIndex = activeId ? indexOf(activeId) : 0;
+    queue.sort((a, b) => Math.abs(indexOf(a.id) - activeIndex) - Math.abs(indexOf(b.id) - activeIndex));
+    while (holders.size < PREVIEW_PARALLEL && queue.length > 0) {
+      const next = queue.shift()!;
+      holders.add(next.id);
+      next.grant();
+    }
+  }, [viewStore]);
+  const requestPreviewSlot = useCallback<MultiPageCanvasContextValue['requestPreviewSlot']>(
+    (id, grant) => {
+      if (slotHoldersRef.current.has(id)) {
+        grant();
+        return;
+      }
+      if (!slotQueueRef.current.some((q) => q.id === id)) slotQueueRef.current.push({ id, grant });
+      pumpPreviewSlots();
+    },
+    [pumpPreviewSlots],
+  );
+  const releasePreviewSlot = useCallback<MultiPageCanvasContextValue['releasePreviewSlot']>(
+    (id) => {
+      slotQueueRef.current = slotQueueRef.current.filter((q) => q.id !== id);
+      if (slotHoldersRef.current.delete(id)) pumpPreviewSlots();
+    },
+    [pumpPreviewSlots],
+  );
 
-  return (
-    <MultiPageCanvasContext.Provider value={value}>
-      {children}
-    </MultiPageCanvasContext.Provider>
+  const value = useMemo<MultiPageCanvasContextValue>(
+    () => ({
+      isEnabled: enabled,
+      editorMode,
+      pages,
+      bounds,
+      layout,
+      getPage,
+      updatePageFrame,
+      setPageHtml,
+      invalidatePages,
+      documentAttributes: artboard.documentAttributes,
+      setPageHeight,
+      ensurePageHtml,
+      previewStyles,
+      viewStore,
+      setCanvasOffset,
+      setCanvasZoom,
+      setView,
+      zoomAt,
+      zoomTo,
+      zoomIn,
+      zoomOut,
+      zoomToFit,
+      zoomToPage,
+      zoomToActual,
+      revealPage,
+      activatePage,
+      activatingPageId,
+      registerContainer,
+      containerRef,
+      isInteracting,
+      markInteracting,
+      initialViewRestored: !!persisted,
+      rulersVisible,
+      toggleRulers,
+      requestPreviewSlot,
+      releasePreviewSlot,
+    }),
+    [
+      enabled, editorMode, pages, bounds, layout, getPage, updatePageFrame, setPageHtml, invalidatePages, artboard.documentAttributes,
+      setPageHeight, ensurePageHtml, previewStyles, viewStore, setCanvasOffset, setCanvasZoom, setView, zoomAt, zoomTo, zoomIn, zoomOut, zoomToFit, zoomToPage,
+      zoomToActual, revealPage, activatePage, activatingPageId, registerContainer, isInteracting, markInteracting,
+      persisted, rulersVisible, toggleRulers, requestPreviewSlot, releasePreviewSlot,
+    ],
   );
+
+  return <MultiPageCanvasContext.Provider value={value}>{children}</MultiPageCanvasContext.Provider>;
 }
 
 /**
@@ -482,16 +985,18 @@ export function MultiPageCanvasProvider({
  */
 export function ConditionalMultiPageProvider({
   enabled,
+  storageKey,
   children,
 }: {
   enabled: boolean;
+  storageKey?: string | null;
   children: React.ReactNode;
 }) {
   if (!enabled) {
     return <>{children}</>;
   }
   return (
-    <MultiPageCanvasProvider enabled={enabled}>
+    <MultiPageCanvasProvider enabled={enabled} storageKey={storageKey}>
       {children}
     </MultiPageCanvasProvider>
   );