@tatamicks/core 0.3.2 → 1.0.1

package/dist/src/index.d.ts

@@ -1,3116 +1,2037 @@
+/**
+ * @tatamicks/core - メインエントリポイント
+ *
+ * @packageDocumentation
+ */
+
+import { ComponentType } from 'react';
 import { default as default_2 } from 'react';
+import { ForwardRefExoticComponent } from 'react';
 import { JSX } from 'react/jsx-runtime';
-import { MemoExoticComponent } from 'react';
 import { NamedExoticComponent } from 'react';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
-
-export declare const ACTUAL_UNITS: readonly ["mm", "cm", "pt", "inch", "px"];
-
-export declare type ActualUnit = (typeof ACTUAL_UNITS)[number];
-
-export declare const alignmentDefinition: PluginProperties<AlignmentSchema>;
-
-export declare interface AlignmentSchema {
-    justifyContent?: HorizontalAlign;
-    alignItems?: VerticalAlign;
-}
-
-export declare const ALL_UNITS: readonly ["mm", "cm", "fr", "inch", "pt", "px", "%"];
-
-export declare type AnyBlockPlugin = BlockPlugin<Record<string, Value>, Value>;
-
-/**
- * 値が有限数であることを検証し、失敗時は例外を投げる
- * @param value 検証する値
- * @param name 値の名前(エラーメッセージに含まれる)
- * @throws {Error} 値がInfinityまたはNaNの場合
- */
-export declare function assertFinite(value: number, name?: string): void;
-
-/**
- * 値が整数であることを検証し、失敗時は例外を投げる
- * @param value 検証する値
- * @param name 値の名前(エラーメッセージに含まれる)
- * @throws {Error} 値が整数でない場合
- */
-export declare function assertInteger(value: number, name?: string): void;
+import { RefObject } from 'react';
 
 /**
- * 値が非負(>= 0)であることを検証し、失敗時は例外を投げる
- * @param value 検証する値
- * @param name 値の名前(エラーメッセージに含まれる)
- * @throws {Error} 値が負の場合
+ * アクションバーコンポーネント。
+ *
+ * @remarks
+ * **Shell** — `sections` 配列でセクションを渡すと区切り線を自動挿入して横並びにレンダリングする。
+ *
+ * デフォルトの `sections` は `getDefaultActionBarSections()` で取得できる。
  */
-export declare function assertNonNegative(value: number, name?: string): void;
+export declare const ActionBar: {
+    ({ sections, className, style, }: ActionBarProps): JSX.Element;
+    displayName: string;
+};
 
 /**
- * 値が正 (> 0) であることを検証し、失敗時は例外を投げる
- * @param value 検証する値
- * @param name 値の名前(エラーメッセージに含まれる)
- * @throws {Error} 値が0以下の場合
+ * アクションバーコンポーネントへの props。
  */
-export declare function assertPositive(value: number, name?: string): void;
+export declare interface ActionBarProps {
+    /**
+     * バーに表示するセクションの配列。
+     *
+     * 隣接するセクション間には区切り線が自動挿入される。
+     *
+     * デフォルト値は `getDefaultActionBarSections()` で取得できる。
+     */
+    sections?: ReactNode[];
+    /** カスタムクラス名 */
+    className?: string;
+    /** インラインスタイル */
+    style?: default_2.CSSProperties;
+}
 
 /**
- * 値が指定範囲内であることを検証し、失敗時は例外を投げる
- * @param value 検証する値
- * @param min 最小値(含む)
- * @param max 最大値(含む)
- * @param name 値の名前(エラーメッセージに含まれる)
- * @throws {Error} 値が範囲外の場合
+ * 登録済みアクションの実行および有効判定インターフェース。
+ *
+ * @remarks
+ * button ブロックのクリック時に呼び出される。
  */
-export declare function assertRange(value: number, min: number, max: number, name?: string): void;
-
-export declare const BackgroundPanel: default_2.FC<BackgroundPanelProps>;
-
-export declare interface BackgroundPanelProps {
-    selectedBlocks: Block[];
-    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
+export declare interface ActionContext {
+    /** 指定 ID のアクションを実行する。 */
+    execute(actionId: BuiltinActionId | (string & {}), payload?: unknown): void;
+    /** 指定 ID のアクションが実行可能か返す。 */
+    isEnabled(actionId: BuiltinActionId | (string & {})): boolean;
 }
 
-export declare function binarySearch(num: number, arr: readonly number[]): number;
-
 /**
- * ブロックデータ（永続化対象）
- *
- * @template P - プラグイン固有プロパティ型
+ * アクション実行後にトースト通知で表示するフィードバック情報。
  *
  * @remarks
- * - JSONから読み込み、JSONに保存される型
- * - グリッド座標（論理座標）で位置を管理
- * - 画面サイズやDPIに依存しない
- * - FormSchema.blocks の要素型
+ * `ActionBar` / `CanvasActionSection` に渡す `onActionFeedback` の引数型。
  */
-export declare interface Block<P = Record<string, Value>> {
-    id: string;
-    kind: string;
-    layout: BlockRect;
-    style?: BlockStyle;
-    behavior?: BlockBehavior;
-    props: P;
-    initValue?: Value;
+declare interface ActionFeedback {
+    /** アクションの識別子 */
+    actionId: string;
+    /** トースト通知に表示するメッセージ */
+    message: string;
+    /** ショートカットキーの表示文字列（なしの場合は `null`） */
+    shortcut: string | null;
 }
 
-export declare const BLOCK_SUB_INDEX: {
-    readonly BG: 10;
-    readonly CONTENT: 50;
-    readonly GUIDE: 70;
-    readonly BORDER: 80;
-};
-
 /**
- * ブロックの動作設定
+ * 末尾に空ページを追加した新しい Book を返す。
  */
-export declare interface BlockBehavior {
-    readOnly?: boolean;
-}
+export declare function addPage(book: Book): Book;
 
 /**
- * BlockBorder
- *
- * ブロックの境界線を描画するコンポーネント
- * - block.style?.borderで設定された枠線を描画
- * - pointer-events: none (クリックイベント透過)
- *
- * @remarks
- * - ユーザー設定の枠線を描画
- * - BlockBaseBorderと構造は同じだが、用途とz-indexが異なる
- * - BlockBaseBorder: ガイド線（GUIDE層）
- * - BlockBorder: 実際の枠線（BORDER層）
+ * ブロック内の水平・垂直配置を保持する Props。
  */
-export declare const BlockBorder: default_2.FC<BlockBorderProps>;
+declare interface AlignmentProps {
+    /** 水平配置 */
+    horizontal?: HorizontalAlign;
+    /** 垂直配置 */
+    vertical?: VerticalAlign;
+}
 
 /**
- * BlockBorderコンポーネントのProps
+ * 全単位の配列。
  */
-export declare interface BlockBorderProps {
-    blockSizePx: BlockSizePx;
-    borderStyle?: BorderStyle;
-    blockZIndex: number;
-    subZIndex?: number;
-    visible?: boolean;
-    dpi?: number;
-    className?: string;
-}
+declare const ALL_UNITS: readonly ["mm", "cm", "fr", "inch", "pt", "px", "%"];
+
+/* Excluded from this release type: AnyBlockPlugin */
 
 /**
- * BlockCanvas
+ * フォーム構築に最低限必要な標準プラグインのリスト。
+ *
+ * `CheckboxPlugin` / `SelectPlugin` / `TextPlugin` の3つを含む。
  *
- * ブロック背景を描画するコンポーネント
- * - z-index: ブロック基底値 + 0 (各ブロックの最下層)
- * - pointer-events: none (クリックイベント透過)
- * - 背景色のみを描画（境界線はBlockBaseBorderが担当）
+ * `createPluginRegistry` にそのまま渡して使用する。
+ *
+ * @example
+ * ```ts
+ * import { BASE_PLUGINS, createPluginRegistry } from "@tatamicks/core";
+ *
+ * const pluginRegistry = createPluginRegistry(BASE_PLUGINS);
+ * ```
  */
-export declare const BlockCanvas: default_2.FC<BlockCanvasProps>;
+export declare const BASE_PLUGINS: readonly [BlockPlugin<CheckboxBlockProps, boolean>, BlockPlugin<SelectBlockProps, SelectBlockValue>, BlockPlugin<TextBlockProps, TextBlockValue>];
 
 /**
- * BlockCanvasコンポーネントのProps
+ * 全ブロックに共通して存在する基底プロパティ。
+ *
+ * コンテナが alignment / padding を CSS に変換し、Renderer は意識しない。
  */
-export declare interface BlockCanvasProps {
-    blockSizePx: BlockSizePx;
-    blockZIndex: number;
-    subZIndex?: number;
-    backgroundColor?: string;
-    className?: string;
+declare interface BaseBlockProps extends AlignmentProps, PaddingProps {
+    /** 値の読み書き先 `BindingContext` のドットパス。バインディングを使わないブロックは省略可 */
+    binding?: string;
 }
 
-export declare interface BlockChangeEvent {
-    type: BlockChangeType;
-    blockIds: string[];
-    blocks?: Block[];
-    updates?: Record<string, Partial<Block>>;
-}
-
-export declare enum BlockChangeType {
-    /** ブロック追加 */
-    ADD = "add",
-    /** ブロック更新 */
-    UPDATE = "update",
-    /** ブロック削除 */
-    DELETE = "delete",
-    /** ブロック移動 */
-    MOVE = "move",
-    /** ブロックリサイズ */
-    RESIZE = "resize",
-    /** ブロック複製 */
-    DUPLICATE = "duplicate",
-    /** ブロック貼り付け */
-    PASTE = "paste"
-}
-
-export declare const BlockContainer: NamedExoticComponent<BlockContainerProps & RefAttributes<BlockRef>>;
-
-export declare interface BlockContainerProps {
-    block: Block;
-    plugin: BlockPlugin;
-    blockRectPx: BlockRectPx;
-    blockZIndex: number;
-    mode: NoteMode;
-    value: Value;
-    onValueChange?: (val: Value) => void;
-    onValueBlur?: (val: Value) => void;
-    showGuides?: boolean;
-    showBorder?: boolean;
-    blockSubZIndex?: Record<string, number>;
-    defaultGuideBorder?: BorderStyle;
-    dpi?: number;
-    className?: string;
-    pointerEvents?: "auto" | "none";
-}
+declare type BaseRenderer = ForwardRefExoticComponent<RendererProps<Record<string, Value>, Value> & RefAttributes<BlockRef>>;
 
 /**
- * ブロックコンテナスタイルのオプション
+ * binding パスによる設定値の読み書きインターフェース。
+ *
+ * @remarks
+ * `HiddenBinding` の評価および button ブロックのアクション判定に使用される。
  */
-export declare interface BlockContainerStyleOptions {
-    /** z-index値 (オプション) */
-    zIndex?: number;
-    /** ポインターイベントの制御 (デフォルト: "auto") */
-    pointerEvents?: "auto" | "none";
+export declare interface BindingContext {
+    /**
+     * 指定パスの値を取得する。
+     *
+     * - パスが存在し値が `null` の場合: `null` を返す。
+     * - パスの値が未設定（未登録）の場合: `undefined` を返す。
+     *
+     * `extra` として渡す実装では、担当外のパスに対して `undefined` を返すことで
+     * 組み込みの BindingContext へのフォールバックを指示できる。
+     * 有効値として `null` を返す場合はフォールバックしない。
+     */
+    get(path: string): Value | undefined;
+    /** 指定パスに値を書き込む。 */
+    set(path: string, value: Value): void;
 }
 
 /**
- * BlockBaseBorder
- *
- * レイアウト編集時にブロックの境界を可視化するガイド線コンポーネント
- * - formモードでのみ使用される
- * - block.style?.borderが未設定のブロックに表示
- * - pointer-events: none (クリックイベント透過)
+ * book 内のブロックを表すインターフェース。
  *
  * @remarks
- * - 固定スタイル（薄いグレーの実線）でブロック境界を描画
- * - ユーザー設定の枠線とは別の、編集補助用のガイド
- * - BorderOverlayと構造は同じだが、用途と表示条件が異なる
+ * - `kind` はプラグインの登録 ID（`createPluginRegistry` に渡した `kind`）と対応する。
+ *
+ * - `props` の値解決順序: `block.props` → `page.blockDefaults?.[kind]` → `PropDef.defaultProps`
+ *
+ * - `id` はブック全体でユニークである必要がある。
+ *
+ * - `P` のジェネリクスは `Page.blocks: Block[]` に格納すると `Record<string, Value>` に消去される。
+ *
+ *   そのため `block.kind === "text"` のように `kind` で条件分岐しても TypeScript は `props` の型を絞り込まない。
+ *
+ *   props に型安全にアクセスするには `pluginRegistry[block.kind]?.validateProps(block.props)` を使用すること。
+ *
+ *   実行時の型保証は `BlockPlugin.validateProps` が担保している。
+ *
+ * - `P` に関数・クラスインスタンス・DOM 要素など非シリアライズ可能な値を含めると、JSON 保存時に値が消失する。
+ *
+ *   型パラメータ `P` は {@link SerializableRecord}（= `Record<string, Value | undefined>`）互換であること。
+ *
+ *   検証には `satisfies SerializableRecord` を使用すること。
  */
-export declare const BlockGuideBorder: default_2.FC<BlockGuideBorderProps>;
+export declare interface Block<P extends SerializableRecord = Record<string, Value>> {
+    /** ブロック ID */
+    id: string;
+    /** ブロック種別（プラグインの kind） */
+    kind: string;
+    /** ブロックの位置とサイズ */
+    layout: BlockRect;
+    /** ブロック固有のプロパティ（プラグインごとに内容が異なる） */
+    props: P;
+    /** ブロックのスタイル */
+    style?: BlockStyle;
+    /** ブロックの動作設定 */
+    behavior?: BlockBehavior;
+    /** ブロックの表示/非表示を制御する条件式 */
+    hiddenBinding?: HiddenBinding;
+    /**
+     * form モードで送信するデフォルト値。
+     *
+     * 設定されている場合、edit モードで自動で初期値として使用される。
+     */
+    initValue?: Value;
+}
 
 /**
- * BlockBaseBorderコンポーネントのProps
+ * ブロックの動作設定。
+ *
+ * @remarks
+ * キーが存在する（`true`）場合に有効、`undefined` の場合は無効として扱う。
  */
-export declare interface BlockGuideBorderProps {
-    blockSizePx: BlockSizePx;
-    blockZIndex: number;
-    subZIndex?: number;
-    borderStyle?: BorderStyle;
-    visible?: boolean;
-    dpi?: number;
-    className?: string;
-}
-
-export declare const BlockLayer: MemoExoticComponent<({ blocks, pluginRegistry, mode, values, selectedBlockIds, getBlockRectPx, onValueChange, onValueBlur, showGuides, showBorder, blockSubZIndex, defaultGuideBorder, dpi, className, }: BlockLayerProps) => JSX.Element>;
-
-export declare interface BlockLayerProps {
-    blocks: Block[];
-    pluginRegistry: Record<string, BlockPlugin>;
-    mode: NoteMode;
-    values: Record<string, Value>;
-    selectedBlockIds?: string[];
-    getBlockRectPx: (block: Block) => BlockRectPx;
-    onValueChange?: OnChange;
-    onValueBlur?: OnBlur;
-    showGuides?: boolean;
-    showBorder?: boolean;
-    blockSubZIndex?: Record<string, number>;
-    defaultGuideBorder?: BorderStyle;
-    dpi?: number;
-    className?: string;
+export declare interface BlockBehavior {
+    /**
+     * 読み取り専用フラグ。
+     *
+     * `NoteMode.VIEW` の強制読み取りとは独立して動作し、EDIT モードでも入力をブロックする。
+     */
+    readOnly?: true;
+    /**
+     * コンテンツ実測幅にブロックを伸縮させる。
+     *
+     * `paper.autoWidth` と組み合わせるとキャンバス幅も追従する。
+     */
+    widthFit?: true;
+    /**
+     * コンテンツ実測高さにブロックを伸縮させる。
+     *
+     * `paper.autoHeight` と組み合わせるとキャンバス高さも追従する。
+     */
+    heightFit?: true;
 }
 
 /**
- * ブロックレイアウト（グリッド座標系）
+ * ブロック種別ごとの共通デフォルトプロパティ。
+ *
+ * @remarks
+ * - キー: プラグインの kind（例: `"text"`, `"checkbox"`）
+ * - 値: プロパティの部分辞書。`block.props` にキーが存在しない場合に参照され、
+ *   それも存在しない場合は `PropDef.defaultProps` にフォールバックする
+ *
+ * @example
+ * ```ts
+ * const defaults: BlockDefaults = {
+ *   text: { fontFamily: "serif", verticalAlign: "center" },
+ *   checkbox: { horizontalAlign: "center" },
+ * };
+ * ```
  */
-export declare interface BlockLayout {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
+export declare type BlockDefaults = Record<string, Record<string, Value>>;
 
 /**
- * BlockOrderPanel
- * ブロックの配列順序を変更するパネル
- * UIでは上が最前面、下が最背面（一般的なデザインソフトと同じ）
- * 内部配列では最後が最前面
+ * ブロックレイアウト設定 compound widget。
+ *
+ * @remarks
+ * カスタムシェル構築専用。
+ *
+ * X / Y / W / H の 4 入力を 1 行フラット構成で横並びにする。
+ *
+ * 12 列 × 1 行グリッド。
+ *
+ * 列構成:
+ *
+ *   0(label X) 1(input X) 2(stepper X・8mm)
+ *
+ *   3(label Y) 4(input Y) 5(stepper Y・8mm)
+ *
+ *   6(label W) 7(input W) 8(stepper W・8mm)
+ *
+ *   9(label H) 10(input H) 11(stepper H・8mm)
  */
-export declare const BlockOrderPanel: {
-    ({ blocks, onBlocksChange, }: BlockOrderPanelProps): JSX.Element;
-    displayName: string;
-};
-
-export declare interface BlockOrderPanelProps {
-    /** ブロック一覧 */
-    blocks: Block[];
-    /** ブロック更新時のコールバック (blocks配列全体を更新) */
-    onBlocksChange: (blocks: Block[]) => void;
-}
+export declare const blockLayoutWidget: WidgetDef;
 
 /**
- * BlockPlugin 型定義
+ * ブロックプラグインの定義。
+ *
+ * @remarks
+ * 型パラメータ `P` は JSON シリアライズ可能なプロパティのみを持つこと。
+ *
+ * 関数・クラスインスタンス・DOM 要素などの非 serializable な値を含めると、`book` を JSON 保存・復元した際に値が消失する。
+ *
+ * `P extends BaseBlockProps` は TypeScript 上の型エラーとならないため、非シリアライズ型を渡してもコンパイル時には検知されない。
+ *
+ * `P` の serializable 性を型レベルで検証するには `satisfies SerializableRecord` を使う。
  *
- * @template P - プラグイン固有プロパティ型
- * @template V - プラグインが扱う値の型
+ * @example
+ * ```ts
+ * import type { SerializableRecord } from "@tatamicks/core";
+ *
+ * interface MyProps extends BaseBlockProps {
+ *   label: string;
+ *   count: number;
+ * }
+ * // ✅ シリアライズ可能か検証
+ * type _check = MyProps satisfies SerializableRecord;
+ * ```
  */
-export declare interface BlockPlugin<P = Record<string, Value>, V = Value> {
+declare interface BlockPlugin<P extends BaseBlockProps = BaseBlockProps, V = Value> {
+    /** プラグインの一意識別子。`block.kind` と対応する */
     kind: string;
+    /** UI表示・アイコン・デフォルトサイズ等のメタ情報 */
     meta: BlockPluginMeta;
-    Renderer: default_2.ForwardRefExoticComponent<RendererProps<P, V> & default_2.RefAttributes<BlockRef>>;
-    properties: PluginProperties<P>;
+    /**
+     * ブロックを描画する `forwardRef` コンポーネント。
+     *
+     * `BlockRef.focus()` を `useImperativeHandle` で公開する必要がある。
+     *
+     * @example
+     * ```tsx
+     * const MyRenderer = forwardRef<BlockRef, RendererProps<MyProps, string>>(
+     *   ({ props, value, onChange, readOnly }, ref) => {
+     *     const inputRef = useRef<HTMLInputElement>(null);
+     *     useImperativeHandle(ref, () => ({ focus: () => inputRef.current?.focus() }));
+     *     return (
+     *       <input
+     *         ref={inputRef}
+     *         value={value ?? ""}
+     *         readOnly={readOnly}
+     *         onChange={(e) => onChange(e.target.value)}
+     *       />
+     *     );
+     *   },
+     * );
+     * ```
+     */
+    Renderer: ForwardRefExoticComponent<RendererProps<P, V> & RefAttributes<BlockRef>>;
+    /**
+     * プロパティパネルに表示するプロパティ定義一覧。
+     *
+     * `defaultProps` は配列順に合成され、同じキーは後ろの定義が優先される。
+     */
+    properties: PropDef[];
+    /**
+     * ストレージから読み込んだ生の `block.props` をサニタイズして型安全な Props に変換する。
+     *
+     * 省略時は raw オブジェクトをそのまま使用する。
+     */
     validateProps?: (props: unknown) => P;
-    validateValue?: (value: unknown, props: P) => V | null;
+    /**
+     * 外部 state から読み込んだ生の値をサニタイズする。
+     *
+     * `undefined` を返した場合は `block.initValue`、それもなければ raw 値にフォールバックする。
+     *
+     * フォールバックを指示する場合にのみ `undefined` を使い、`null` は正当な値として返せる。
+     *
+     * 省略時は raw 値をそのまま使用する。
+     *
+     * 戻り値 `V` は {@link Value} 互換型（JSON serializable）にすること。
+     *
+     * 日付は `Date` インスタンスではなく ISO 8601 文字列（例: `"2025-01-01"`）で表現する。
+     */
+    validateValue?: (value: unknown, props: P) => V | undefined;
+    /** 旧バージョンの props を現バージョンにマイグレーションする。`validateProps` の前に呼ばれる */
+    migrateProps?: (props: unknown) => Record<string, unknown>;
 }
 
 /**
- * プラグインのメタ情報
+ * pluginのメタ情報（UI表示・アイコン・デフォルトサイズ）。
  */
-export declare interface BlockPluginMeta {
+declare interface BlockPluginMeta {
+    /** UIに表示されるブロック名 */
     displayName: string;
-    description: string;
-    icon?: default_2.ComponentType<PluginIconProps>;
-    defaultSize: BlockSize;
+    /** ブロックの説明文 */
+    description?: string;
+    /** ブロックのグリッド上のデフォルトサイズ */
+    defaultSize?: BlockSize;
+    /** ブロック選択パネルなどで使用するアイコンコンポーネント */
+    icon?: ComponentType<{
+        className?: string;
+    }>;
 }
 
 /**
- * ブロックの位置とサイズ（グリッド座標）
- *
- * @remarks
- * - JSONに保存される論理座標
- * - 画面サイズやDPIに依存しない
- * - レスポンシブ対応・印刷時の一貫性のためグリッド座標を使用
+ * ブロックのグリッド上座標。
  */
 export declare interface BlockPos {
+    /** グリッド列の開始位置 (0-based) */
     x: number;
+    /** グリッド行の開始位置 (0-based) */
     y: number;
 }
 
 /**
- * ブロックの位置とサイズ（ピクセル座標）
- *
- * @remarks
- * - レンダリング時に使用する物理座標
- * - グリッド座標から計算される（BlockLayerで変換）
- * - 画面サイズやDPIに依存
- */
-export declare interface BlockPosPx {
-    left: number;
-    top: number;
-}
-
-/**
- * PropertyPanel
- *
- * 選択されたブロックのプロパティを編集するための統合サイドバーコンポーネント。
- * BasePanels（共通設定）と PluginPanels（固有設定）を組み合わせて表示します。
+ * ブロックのグリッド上の位置とサイズを合わせた矩形領域。
  */
-export declare const BlockPropertyPanel: MemoExoticComponent<({ selectedBlocks, pluginRegistry, onUpdateBlocks, gridSize, className, }: BlockPropertyPanelProps) => JSX.Element>;
-
-export declare interface BlockPropertyPanelProps {
-    selectedBlocks: Block[];
-    pluginRegistry: Record<string, BlockPlugin>;
-    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
-    gridSize?: {
-        cols: number;
-        rows: number;
-    };
-    className?: string;
-}
-
 export declare interface BlockRect extends BlockPos, BlockSize {
 }
 
-export declare interface BlockRectPx extends BlockPosPx, BlockSizePx {
-}
-
 /**
- * ブロック参照インターフェース (Renderer が実装)
- *
- * @remarks
- * すべてのプラグインのRendererコンポーネントは、
- * forwardRefを使用してこのインターフェースを実装する必要があります。
+ * Rendererが forwardRef で外部に公開するインターフェース。
  */
-export declare interface BlockRef {
-    /**
-     * フォーカスメソッド (全プラグイン必須実装)
-     *
-     * @remarks
-     * - キーボード操作でブロックにフォーカスを移動する際に使用
-     * - 入力可能な要素(input, textarea等)にフォーカスを当てる
-     */
+declare interface BlockRef {
     focus: () => void;
 }
 
-export declare const BlockRenderer: typeof ForwardedBlockRenderer;
-
 /**
- * BlockRendererコンポーネントのProps
- *
- * @template P - プラグイン固有プロパティ型
- * @template V - プラグインが扱う値の型
+ * ブロックのグリッド上サイズ。
  */
-export declare interface BlockRendererProps<P = Record<string, Value>, V = Value> {
-    /** ブロックID */
-    id: string;
-    /** プラグイン定義 */
-    plugin: BlockPlugin<P, V>;
-    /** プラグイン固有プロパティ */
-    props: P;
-    /** ブロックの現在値 */
-    value: V;
-    /** 値変更コールバック (オプション) */
-    onChange?: (value: V) => void;
-    /** 値確定コールバック (オプション) */
-    onBlur?: (value: V) => void;
-    /** 読み取り専用フラグ */
-    readOnly: boolean;
-    /** 現在のモード */
-    mode: NoteMode;
-    /** ブロックの位置とサイズ（ピクセル単位） */
-    blockSizePx: BlockSizePx;
-    /** ブロック基底z-index */
-    blockZIndex: number;
-    /** ブロック内でのレイヤーz-index (オプション) */
-    subZIndex?: number;
-    /** バリデーション状態 (オプション) */
-    validationState?: "valid" | "invalid" | "warning";
-    /** 追加のクラス名 */
-    className?: string;
-}
-
 export declare interface BlockSize {
+    /** 列方向の幅（列数） */
     w: number;
+    /** 行方向の高さ（行数） */
     h: number;
 }
 
-export declare interface BlockSizePx {
-    width: number;
-    height: number;
-}
-
 /**
- * ブロックのスタイル定義
+ * ブロックのスタイル定義。
  */
 export declare interface BlockStyle {
+    /** 背景色 (CSS color 値) */
     backgroundColor?: string;
+    /** 枠線スタイル */
     border?: BorderStyle;
 }
 
-export declare type BlockSubIndexValue = (typeof BLOCK_SUB_INDEX)[keyof typeof BLOCK_SUB_INDEX];
-
-/**
- * Block単位のバリデーター関数型
- */
-export declare type BlockValidator<P = unknown, V = unknown> = (props: P, value: V) => ValidationError | null;
-
 /**
- * 複数のBlockバリデーター関数型
- */
-export declare type BlockValidators<P = unknown, V = unknown> = (props: P, value: V) => ValidationError[];
-
-/**
- * レンダリング用ブロック情報
+ * 複数ページのフォームを表すスキーマ（Book）。
  *
  * @remarks
- * - Blockコンポーネントに渡される型
- * - 元のBlockデータ + 計算済みピクセル座標
- * - BlockLayerで Block → BlockViewModel に変換される
+ * - `pages` は最低1ページ必須（タプル型で空配列を禁止）
+ * - `Page.id` はオプション。index による識別がベースだが、並び替え・外部同期には `id` を利用する
+ * - `block.id` はブック全体でユニークであること
+ * - `paper` はブック全体で共通（全ページ同一の用紙設定を維持する）
  */
-export declare interface BlockViewModel<P = Record<string, Value>> {
-    /**
-     * 元のブロックデータへの参照
-     */
-    block: Block<P>;
-    /**
-     * 計算済みピクセル座標
-     */
-    position: BlockRectPx;
-    /**
-     * z-index値（配列インデックスから計算）
-     */
-    zIndex: number;
-    /**
-     * ブロックの現在値
-     */
-    value?: Value;
-}
-
-export declare class Border {
-    private readonly style;
-    constructor(style: BorderStyle);
-    get top(): LineStyle | undefined;
-    get right(): LineStyle | undefined;
-    get bottom(): LineStyle | undefined;
-    get left(): LineStyle | undefined;
-    get hasAnyBorder(): boolean;
-    getTopSVGProps(widthPx: number, dpi?: number): {
-        x1: number;
-        y1: number;
-        x2: number;
-        y2: number;
-        stroke: string;
-        strokeWidth: number;
-        strokeDasharray: string | undefined;
-        vectorEffect: string;
-        "data-edge": string;
-    } | null;
-    getRightSVGProps(widthPx: number, heightPx: number, dpi?: number): {
-        x1: number;
-        y1: number;
-        x2: number;
-        y2: number;
-        stroke: string;
-        strokeWidth: number;
-        strokeDasharray: string | undefined;
-        vectorEffect: string;
-        "data-edge": string;
-    } | null;
-    getBottomSVGProps(widthPx: number, heightPx: number, dpi?: number): {
-        x1: number;
-        y1: number;
-        x2: number;
-        y2: number;
-        stroke: string;
-        strokeWidth: number;
-        strokeDasharray: string | undefined;
-        vectorEffect: string;
-        "data-edge": string;
-    } | null;
-    getLeftSVGProps(heightPx: number, dpi?: number): {
-        x1: number;
-        y1: number;
-        x2: number;
-        y2: number;
-        stroke: string;
-        strokeWidth: number;
-        strokeDasharray: string | undefined;
-        vectorEffect: string;
-        "data-edge": string;
-    } | null;
+export declare interface Book {
+    /** ブック全体の用紙設定。全ページ共通（PDF の慣習に従いページごとの変更は不可） */
+    paper: Paper;
+    /** ページ一覧（0-based インデックス順） */
+    pages: [Page, ...Page[]];
+    /** ブックレベルのメタデータ。例: `{ title: "月次業務報告書", version: "2" }` */
+    metaData?: Record<string, Value>;
 }
 
-export declare const BORDER_UNITS: readonly ["px", "pt", "mm"];
-
 /**
- * BorderOverlay
- *
- * 印刷可能領域の境界線をSVGで描画するオーバーレイコンポーネント
- * - z-index: 3 (GridLayerの最上層)
- * - pointer-events: none (クリックイベント透過)
- * - 印刷可能領域の4辺に境界線を描画
- *
- * @remarks
- * - 境界線は印刷可能領域（contentArea）の外枠に描画される
- * - 個別設定（topBorderStyle等）が優先され、なければborderStyleを使用
- * - すべてのスタイルが未指定の場合、その辺は描画されない
+ * 枠線の幅に使用できる単位の配列。
  */
-export declare const BorderOverlay: default_2.FC<BorderOverlayProps>;
+declare const BORDER_UNITS: readonly ["px", "pt", "mm"];
 
 /**
- * BorderOverlayコンポーネントのProps
+ * 四辺それぞれの枠線スタイル定義。省略した辺は枠線なし。
+ *
+ * `all` を指定した場合、各辺に個別指定がなければ `all` の値が全辺に適用される。
  */
-export declare interface BorderOverlayProps {
-    contentPx: PaperContentPx;
-    marginLeftPx: number;
-    marginTopPx: number;
-    borderStyle?: BorderStyle;
-    visible?: boolean;
-    dpi?: number;
-    zIndex?: number;
-    className?: string;
-}
-
-export declare const BorderPanel: default_2.FC<BorderPanelProps>;
-
-export declare interface BorderPanelProps {
-    selectedBlocks: Block[];
-    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
-}
-
-export declare const BorderRenderer: MemoExoticComponent<({ width, height, border, dpi, className, }: BorderRendererProps) => JSX.Element | null>;
-
-export declare interface BorderRendererProps {
-    width: number;
-    height: number;
-    border: Border;
-    dpi?: number;
-    className?: string;
-}
-
 export declare interface BorderStyle {
-    all?: LineStyle;
     top?: LineStyle;
     right?: LineStyle;
     bottom?: LineStyle;
     left?: LineStyle;
+    /** 全辺共通スタイル。各辺に個別指定がない場合のフォールバック */
+    all?: LineStyle;
 }
 
+/**
+ * 枠線の幅に使用できる単位。
+ */
 export declare type BorderUnit = (typeof BORDER_UNITS)[number];
 
 /**
- * px単位でのデルタ値をGridDimensionに反映
+ * 組み込みアクション ID のユニオン型。
  *
- * @param dimensions - 現在のDimension配列
- * @param index - リサイズするグリッドのインデックス
- * @param deltaPx - ピクセル単位での変更量
- * @param totalContentPx - コンテンツ全体のサイズ(px)
- * @returns 更新されたDimension配列
+ * `ActionContext.execute` / `ActionContext.isEnabled` の引数に指定したとき IDE の補完候補として表示される。
+ * カスタムアクション ID は任意の `string` として渡せる。
  */
-export declare function calculateGridResize(dimensions: Dimension<GridUnit>[], index: number, deltaPx: number, totalContentPx: number): Dimension<GridUnit>[];
+export declare type BuiltinActionId = "undo" | "redo" | "paste" | "delete" | "copy" | "duplicate" | "addPage" | "deletePage" | "selectBlocks" | "goToPage" | "updateBlocks";
 
 /**
- * リサイズ後のレイアウトを計算
- *
- * @param params - リサイズパラメータ
- * @returns 新しいレイアウト
+ * デフォルトのキャンバス操作ボタン widget。
  *
  * @remarks
- * - 最小サイズは1x1
- * - グリッド範囲外にははみ出さない
- * - 左端・上端を超える場合は自動的にクランプ
+ * カスタムシェル構築専用。
  *
- * @example
- * ```typescript
- * const newLayout = calculateResizedLayout({
- *   layout: { x: 2, y: 2, w: 3, h: 3 },
- *   handle: ResizeHandle.SE,
- *   deltaCol: 2,
- *   deltaRow: 1,
- *   gridCols: 10,
- *   gridRows: 10,
- * });
- * // => { x: 2, y: 2, w: 5, h: 4 }
- * ```
+ * `createCanvasActionsWidget()` と等価。
  */
-export declare function calculateResizedLayout({ layout, handle, deltaCol, deltaRow, gridCols, gridRows, }: ResizeParams): BlockLayout;
+export declare const canvasActionsWidget: WidgetDef;
 
 /**
- * CanvasPanel
- * キャンバス設定の統合パネル
- * - PaperSizePanel: 用紙サイズ設定
- * - MarginPanel: マージン設定
- * - GridSizePanel: グリッドサイズ設定
- * - BlockOrderPanel: ブロック順序設定
+ * チェックボックスブロックの props 型。
  */
-export declare const CanvasPanel: {
-    ({ schema, onSchemaChange }: CanvasPanelProps): JSX.Element;
-    displayName: string;
-};
+declare type CheckboxBlockProps = BaseBlockProps & RequiredProps & CheckboxStyleProps;
 
-export declare interface CanvasPanelProps {
-    /** フォームスキーマ */
-    schema: FormSchema;
-    /** スキーマ変更時のコールバック */
-    onSchemaChange: (newSchema: FormSchema) => void;
-}
+/**
+ * チェックボックスブロックの値型。
+ */
+declare type CheckboxBlockValue = boolean;
 
 /**
- * チェックボックスコンポーネント
+ * チェックボックスブロックのプラグイン定義。
+ *
+ * `kind: "checkbox"` で登録され、チェック・非チェックを `boolean` 値で管理する。
  */
-export declare const Checkbox: {
-    ({ value, onChange, readOnly, label: propLabel, config, }: CheckboxProps): default_2.ReactElement;
-    displayName: string;
-};
+export declare const CheckboxPlugin: BlockPlugin<CheckboxBlockProps, CheckboxBlockValue>;
 
-export declare interface CheckboxConfig {
-    label?: string;
-    [key: string]: Value;
+/**
+ * チェックボックスの外観カスタマイズ設定。
+ */
+declare interface CheckboxStyleConfig {
+    /** チェックボックス全体のサイズ。 */
+    checkboxSize?: Dimension;
+    /** 枠の太さ。 */
+    borderWidth?: Dimension;
+    /** 枠の色。 */
+    borderColor?: string;
+    /** チェックマークの線の太さ。 */
+    checkWidth?: Dimension;
+    /** チェックマークの色。 */
+    checkColor?: string;
+    /** 未チェック時の背景色。 */
+    backgroundColor?: string;
+    /** チェック時の背景色。 */
+    checkedBackgroundColor?: string;
 }
 
 /**
- * Checkbox固有のProps
- * ★修正: boolean | undefined にして未設定を許容する
+ * チェックボックスの外観カスタマイズ props。
  */
-export declare interface CheckboxProps extends PropertyComponentProps<boolean | undefined> {
-    label?: string;
-    config?: CheckboxConfig;
+declare interface CheckboxStyleProps {
+    /** 外観カスタマイズ設定。 */
+    styleConfig?: CheckboxStyleConfig;
 }
 
 /**
- * @file clampBlock.ts
- * @description ブロックをグリッド範囲内にクランプする共通ロジック
- *
- * @remarks
- * 移動・挿入・リサイズ時のはみ出し防止処理を集約。
- * DRY原則に従い、InteractionLayer内の重複コードを排除。
+ * Book に存在しない blockId のエントリを `values` から除去して返す。
  */
+export declare function cleanValues(book: Book, values: Record<string, Value>): Record<string, Value>;
+
 /**
- * ブロックの位置をグリッド範囲内にクランプ
- *
- * @param position - ブロックの位置 (x, y)
- * @param size - ブロックのサイズ (w, h)
- * @param gridCols - グリッドの列数
- * @param gridRows - グリッドの行数
- * @returns クランプされた位置 { x, y }
- *
- * @remarks
- * - x は 0 ～ (gridCols - w) の範囲にクランプ
- * - y は 0 ～ (gridRows - h) の範囲にクランプ
- * - ブロックがグリッドからはみ出さないことを保証
- *
- * @example
- * ```typescript
- * const clamped = clampBlockToGrid(
- *   { x: -1, y: 5 },
- *   { w: 2, h: 3 },
- *   10, // gridCols
- *   10  // gridRows
- * );
- * // => { x: 0, y: 5 }
- * ```
- */
-export declare function clampBlockToGrid(position: {
-    x: number;
-    y: number;
-}, size: {
-    w: number;
-    h: number;
-}, gridCols: number, gridRows: number): {
-    x: number;
-    y: number;
-};
-
-export declare interface ClampedBlockPosition {
-    blockId: string;
-    x: number;
-    y: number;
-}
-
-/**
- * 複数ブロックの移動をクランプ
- * 全体のバウンディングボックスを計算し、グリッド範囲内に収めた上で
- * 相対位置を保持したまま各ブロックの新しい座標を返す
- *
- * @param blocks - 移動対象のブロック配列
- * @param deltaCol - 列方向の移動量
- * @param deltaRow - 行方向の移動量
- * @param gridCols - グリッドの列数
- * @param gridRows - グリッドの行数
- * @returns クランプ後の各ブロックの座標配列
- */
-export declare function clampMultipleBlocks(blocks: Block[], deltaCol: number, deltaRow: number, gridCols: number, gridRows: number): ClampedBlockPosition[];
-
-/**
- * 印刷後のクリーンアップ処理
- */
-export declare function cleanupPrint(options?: {
-    restoreScrollbars?: boolean;
-}): void;
-
-/**
- * カラーパレット定義（30色）
- */
-export declare const COLOR_PALETTE: readonly [{
-    readonly label: "無色";
-    readonly value: string | undefined;
-}, {
-    readonly label: "白";
-    readonly value: "#ffffff";
-}, {
-    readonly label: "グレー1";
-    readonly value: "#efefef";
-}, {
-    readonly label: "グレー2";
-    readonly value: "#d9d9d9";
-}, {
-    readonly label: "グレー3";
-    readonly value: "#cccccc";
-}, {
-    readonly label: "グレー4";
-    readonly value: "#b7b7b7";
-}, {
-    readonly label: "グレー5";
-    readonly value: "#999999";
-}, {
-    readonly label: "グレー6";
-    readonly value: "#666666";
-}, {
-    readonly label: "グレー7";
-    readonly value: "#434343";
-}, {
-    readonly label: "黒";
-    readonly value: "#000000";
-}, {
-    readonly label: "薄茶";
-    readonly value: "#E6B8AF";
-}, {
-    readonly label: "薄赤";
-    readonly value: "#F4CCCC";
-}, {
-    readonly label: "薄橙";
-    readonly value: "#FCE5CD";
-}, {
-    readonly label: "薄黄";
-    readonly value: "#FFF2CC";
-}, {
-    readonly label: "薄緑";
-    readonly value: "#D9EAD3";
-}, {
-    readonly label: "薄青緑";
-    readonly value: "#D0E0E3";
-}, {
-    readonly label: "薄青";
-    readonly value: "#C9DAF8";
-}, {
-    readonly label: "薄青紫";
-    readonly value: "#CFE2F3";
-}, {
-    readonly label: "薄紫";
-    readonly value: "#D9D2E9";
-}, {
-    readonly label: "薄赤紫";
-    readonly value: "#EAD1DC";
-}, {
-    readonly label: "茶";
-    readonly value: "#DD7E6B";
-}, {
-    readonly label: "赤";
-    readonly value: "#EA9999";
-}, {
-    readonly label: "橙";
-    readonly value: "#F9CB9C";
-}, {
-    readonly label: "黄";
-    readonly value: "#FFE599";
-}, {
-    readonly label: "緑";
-    readonly value: "#B6D7A8";
-}, {
-    readonly label: "青緑";
-    readonly value: "#A2C4C9";
-}, {
-    readonly label: "青";
-    readonly value: "#A4C2F4";
-}, {
-    readonly label: "青紫";
-    readonly value: "#9FC5E8";
-}, {
-    readonly label: "紫";
-    readonly value: "#B4A7D6";
-}, {
-    readonly label: "赤紫";
-    readonly value: "#D5A6BD";
-}];
-
-/**
- * カラーパレットコンポーネント
- */
-export declare const ColorPalette: {
-    ({ onColorSelect, selectedColor, readOnly, }: ColorPaletteProps): default_2.ReactElement;
-    displayName: string;
-};
-
-export declare interface ColorPaletteProps {
-    onColorSelect: (color: string | undefined) => void;
-    selectedColor?: string;
-    readOnly?: boolean;
-}
-
-/**
- * カラーピッカーコンポーネント
- */
-export declare const ColorPicker: {
-    ({ value, onChange, readOnly, showTextInput, allowUndefined: propAllowUndefined, placeholder: propPlaceholder, width: propWidth, height: propHeight, config, }: ColorPickerProps): default_2.ReactElement;
-    displayName: string;
-};
-
-/**
- * Config型定義
- * Record<string, Value> との互換性を持たせる
- */
-export declare interface ColorPickerConfig {
-    allowUndefined?: boolean;
-    width?: number;
-    height?: number;
-    [key: string]: Value;
-}
-
-/**
- * カラーピッカーポップオーバーコンポーネント
- */
-export declare const ColorPickerPopover: {
-    ({ isOpen, onClose, rgba, onRgbaChange, onColorSelect, selectedColor, readOnly, }: ColorPickerPopoverProps): default_2.ReactElement | null;
-    displayName: string;
-};
-
-export declare interface ColorPickerPopoverProps {
-    isOpen: boolean;
-    onClose: () => void;
-    rgba: RGBA;
-    onRgbaChange: (channel: keyof RGBA, value: number | undefined) => void;
-    onColorSelect: (color: string | undefined) => void;
-    selectedColor?: string;
-    readOnly?: boolean;
-}
-
-/**
- * ColorPicker固有のProps
- * T は string | undefined
- */
-export declare interface ColorPickerProps extends PropertyComponentProps<string | undefined> {
-    /** カラーテキスト入力を表示するか */
-    showTextInput?: boolean;
-    /** undefined（未設定）を許容するか */
-    allowUndefined?: boolean;
-    /** プレースホルダーテキスト */
-    placeholder?: string;
-    /** 幅(px) */
-    width?: number;
-    /** 高さ(px) */
-    height?: number;
-    /** 設定オブジェクト */
-    config?: ColorPickerConfig;
-}
-
-/**
- * 新規ブロックを作成
+ * デフォルトのクリップボード操作ボタン widget。
  *
  * @remarks
- * Interaction層（D&Dでの配置）や初期化時に使用されます。
+ * カスタムシェル構築専用。
  *
- * @param plugin ブロックプラグイン
- * @param position グリッド上の配置情報
- * @param overrideProps プロパティの上書き（オプション）
- * @returns 新しい Block オブジェクト
+ * `createClipboardWidget()` と等価。
  */
-export declare function createBlock<P = Record<string, unknown>>(plugin: BlockPlugin<P>, position: {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}, overrideProps?: Partial<P>): Block<P>;
+export declare const clipboardWidget: WidgetDef;
 
 /**
- * ブロック ID を生成
+ * ブロックの一意 ID を生成する。
  *
- * @remarks
- * UUID/nanoid は使わず、カスタム ID 方式
- * タイムスタンプ + ランダム文字列で一意性を保証
+ * `kind` をプレフィックスにした UUID 形式（例: `text_xxxxxxxx-...`）。
  */
 export declare function createBlockId(kind: string): string;
 
 /**
- * プラグインの properties 定義から初期Propsを生成
- *
- * @remarks
- * - フラットなプロパティ定義から defaultValue を抽出してオブジェクトを生成します
- * - false で無効化されたプロパティはスキップします
- * - defaultValue が undefined のプロパティも含めます（CSS変数対応のため）
- *
- * @param plugin BlockPlugin オブジェクト
- * @returns 初期化されたプロパティオブジェクト
- */
-export declare const createInitialProps: <P>(plugin: BlockPlugin<P>) => P;
-
-/**
- * プラグイン配列からプラグインレジストリを作成
+ * キャンバス操作ボタン widget を生成するファクトリ関数。
  *
  * @remarks
- * - プラグインの kind をキーとしたオブジェクトを生成します
- * - 型推論により、配列内の具体的なプラグイン型が保持されます
- *
- * @template T - BlockPlugin の配列型
- * @param plugins プラグインの配列 (as const推奨)
- * @returns kind をキーとしたプラグインレジストリ
- *
- * @example
- * ```typescript
- * const registry = createPluginRegistry([
- *   TextPlugin,
- *   SelectPlugin,
- *   CheckboxPlugin,
- * ] as const);
- * // registry.text, registry.select, registry.checkbox が型推論される
- * ```
- */
-export declare function createPluginRegistry<T extends readonly BlockPlugin[]>(plugins: T): Record<string, T[number]>;
-
-export declare const DEFAULT_DPI = 96;
-
-export declare const DEFAULT_FONT_FAMILY: readonly SelectOption[];
-
-export declare const DEFAULT_GRID: Grid;
-
-export declare const DEFAULT_GUIDE_BORDER: BorderStyle;
-
-export declare const DEFAULT_GUIDE_LINE: LineStyle;
-
-export declare const DEFAULT_PAPER: Paper;
-
-export declare const DEFAULT_PAPER_MARGIN: PaperMargin;
-
-export declare const DEFAULT_PAPER_SIZES: Record<PaperSizePreset, PaperSize>;
-
-export declare const DEFAULT_SCHEMA: FormSchema;
-
-/**
- * JSON文字列をFormSchemaにデシリアライズ
- *
- * @param json - デシリアライズするJSON文字列
- * @returns FormSchema (バリデーション済み)
- * @throws バリデーションエラー時にエラーをスロー
- *
- * @example
- * ```ts
- * const json = '{"paper": {...}, "grid": {...}, "blocks": [...]}';
- * const schema = deserializeSchema(json);
- * ```
- */
-export declare function deserializeSchema(json: string): FormSchema;
-
-/**
- * JSON文字列を入力値(values)にデシリアライズ
- *
- * @param json - デシリアライズするJSON文字列
- * @returns Record<string, Value> (バリデーション済み)
- * @throws バリデーションエラー時にエラーをスロー
- *
- * @example
- * ```ts
- * const json = '{"block-1": "Hello", "block-2": 42}';
- * const values = deserializeValues(json);
- * ```
- */
-export declare function deserializeValues(json: string): Record<string, Value>;
-
-export declare interface Dimension<U extends Unit = Unit> {
-    value: number;
-    unit: U;
-}
-
-export declare const DimensionInput: <U extends Unit>(props: DimensionInputProps<U>) => default_2.ReactElement;
-
-export declare interface DimensionInputConfig<U extends Unit> {
-    allowedUnits?: readonly U[];
-    min?: number;
-    max?: number;
-    step?: number;
-    placeholder?: string;
-    width?: number;
-    height?: number;
-    [key: string]: Value;
-}
-
-/**
- * DimensionInput固有のProps
- * ★重要: ジェネリクスに `| undefined` を追加して、未設定状態を受け入れられるようにする
- */
-export declare interface DimensionInputProps<U extends Unit> extends PropertyComponentProps<Dimension<U> | undefined> {
-    allowedUnits?: readonly U[];
-    min?: number;
-    max?: number;
-    step?: number;
-    placeholder?: string;
-    /** 幅(px) */
-    width?: number;
-    /** 高さ(px) */
-    height?: number;
-    config?: DimensionInputConfig<U>;
-}
-
-export declare function dimensionsToStrings<U extends Unit>(dims: Dimension<U>[]): string[];
-
-export declare function dimensionToString<U extends Unit>(dim: Dimension<U>): string;
-
-/**
- * 浮動小数点のピクセル配列を整数ピクセル配列に変換します。
- *
- * Bresenhamアルゴリズムに基づく累積誤差補正により、
- * 境界位置（prefix sum）のズレを最小化します。
- * これにより視覚的なバランスが保たれ、ピクセルギャップを防ぎます。
- *
- * @example
- * // 767px ÷ 3 = 255.666...
- * distributeRemainder([255.666, 255.666, 255.666])
- * // → [256, 255, 256] (合計767px、累積誤差を均等に分散)
- *
- * @example
- * // 100px ÷ 3 = 33.333...
- * distributeRemainder([33.333, 33.333, 33.333])
- * // → [33, 34, 33] (合計100px、累積誤差を補正)
- *
- * @param floatPixels - 浮動小数点のピクセル値配列
- * @returns 整数のピクセル値配列(合計値は元の合計を四捨五入した値と一致)
- *
- * @see https://en.wikipedia.org/wiki/Bresenham%27s_line_algorithm
- * @see Zen Grids - Responsive Design's Dirty Little Secret
- */
-export declare function distributeRemainder(floatPixels: number[]): number[];
-
-/**
- * ドラッグ状態の詳細情報
- */
-export declare interface DraggingState {
-    /** ドラッグ種別 */
-    type: DragType;
-    /** ドラッグ対象のブロックID群 */
-    blockIds: string[];
-    /** 開始グリッド座標 */
-    startGrid: {
-        col: number;
-        row: number;
-    };
-    /** 現在のグリッド座標 */
-    currentGrid: {
-        col: number;
-        row: number;
-    };
-    /** 現在のマウス座標 (px, キャンバス相対) - キャンバス外でのゴースト表示用 */
-    currentMousePx?: {
-        x: number;
-        y: number;
-    };
-    /** リサイズ用: ハンドル位置 */
-    handle?: ResizeHandle;
-    /** 挿入用: プラグイン種別 */
-    pluginKind?: string;
-    /** 挿入用: デフォルトサイズ */
-    defaultSize?: {
-        w: number;
-        h: number;
-    };
-    /** キャンバス外フラグ (true: 範囲外でドロップすると削除) */
-    isOutside?: boolean;
-}
-
-export declare const DragLayer: MemoExoticComponent<({ blocks, pluginRegistry, gridLength, draggingState, getBlockRectPx, selectionStyle, ghostZIndex, selectBorderZIndex, blockHandlesZIndex, }: DragLayerProps) => JSX.Element | null>;
-
-export declare interface DragLayerProps {
-    blocks: Block[];
-    pluginRegistry: Record<string, BlockPlugin>;
-    gridLength: {
-        cols: number;
-        rows: number;
-    };
-    draggingState: DraggingState | undefined;
-    getBlockRectPx: (block: Block) => BlockRectPx;
-    selectionStyle?: BorderStyle;
-    ghostZIndex?: number;
-    selectBorderZIndex?: number;
-    blockHandlesZIndex?: number;
-}
-
-/**
- * GlobalDragStore
- *
- * Palette → Canvas 間のドラッグ&ドロップで使用するグローバル状態管理
- * 「現在ドラッグ中のアイテム」を保持し、NoteFormが必要に応じて参照する
- *
- * ## 使用方法
- *
- * ### Palette側 (ホストアプリ)
- * ```tsx
- * const handlePointerDown = (e: React.PointerEvent) => {
- *   globalDragStore.start('text', { w: 200, h: 100 });
- *
- *   const handleWindowUp = () => {
- *     globalDragStore.end();
- *     window.removeEventListener('pointerup', handleWindowUp);
- *   };
- *   window.addEventListener('pointerup', handleWindowUp);
- * };
- * ```
+ * カスタムシェル構築専用。
  *
- * ### NoteForm側 (core)
- * ```tsx
- * const handlePointerEnter = () => {
- *   const item = globalDragStore.get();
- *   if (item) {
- *     handleInteractionChange({
- *       type: InteractionEventType.START_INSERT,
- *       pluginKind: item.kind,
- *       defaultSize: item.defaultSize,
- *     });
- *   }
- * };
- * ```
- */
-/**
- * ドラッグ中のアイテム情報
- */
-export declare type DragState = {
-    /** プラグインの種類 (例: 'text', 'image') */
-    kind: string;
-    /** デフォルトサイズ (グリッド単位) */
-    defaultSize: {
-        w: number;
-        h: number;
-    };
-} | null;
-
-/**
- * ドラッグ種別
+ * 8 列 × 1 行: [全選択][解除][削除][コピー][貼付][複製][元に戻す][やり直し]
  *
- * @remarks
- * ドラッグ操作の種類を型安全に扱うための列挙型
- */
-export declare enum DragType {
-    /** ブロックの移動 */
-    MOVE = "move",
-    /** ブロックのリサイズ */
-    RESIZE = "resize",
-    /** 新規ブロックの挿入 */
-    INSERT = "insert"
-}
-
-export declare const EditingBlock: typeof ForwardedEditingBlock;
-
-export declare interface EditingBlockProps<P = Record<string, Value>, V = Value> {
-    /** ブロックID */
-    id: string;
-    /** プラグイン定義 */
-    plugin: BlockPlugin<P, V>;
-    /** プラグイン固有プロパティ */
-    props: P;
-    /** ブロックの現在値 */
-    value: V;
-    /** 値変更コールバック */
-    onChange: (value: V) => void;
-    /** 値確定コールバック (オプション) */
-    onBlur?: (value: V) => void;
-    /** ブロックの位置とサイズ（ピクセル単位） */
-    blockRectPx: BlockRectPx;
-    /** z-index (オプション、デフォルト: Z_INDEX.EDIT_BLOCK) */
-    zIndex?: number;
-    /** バリデーション状態 (オプション) */
-    validationState?: "valid" | "invalid" | "warning";
-    /** 追加のクラス名 */
-    className?: string;
-}
-
-/**
- * 印刷を実行(準備 + 印刷 + クリーンアップ)
+ * `idPrefix` でブロック ID プレフィックスを変更できる。
  */
-export declare function executePrint(options?: {
-    title?: string;
-    onBeforePrint?: () => void;
-    onAfterPrint?: () => void;
-}): void;
+export declare function createCanvasActionsWidget(idPrefix?: string): WidgetDef;
 
 /**
- * 機能プラグイン (将来の拡張用)
+ * クリップボード操作ボタン widget を生成するファクトリ関数。
  *
  * @remarks
- * 現在未使用。将来的にエディタ全体の機能を拡張するプラグインを定義する際に使用
- * 例: Undo/Redo, 自動保存, PDFエクスポートなど
- */
-export declare interface FeaturePlugin {
-    kind: string;
-}
-
-/**
- * 指定された座標にあるブロックを検索します
- *
- * @param point - 検索対象の座標 (Client/Offset座標ではなく、InteractionLayer内の相対座標)
- * @param blocks - ブロックのリスト
- * @param getBlockRectPx - ブロックからピクセル矩形を計算する関数 (useGridCalc由来)
- * @returns 見つかったブロックのID。見つからない場合は null
- */
-export declare function findBlockAtPoint(point: {
-    x: number;
-    y: number;
-}, blocks: Block[], getBlockRectPx: (block: Block) => BlockRectPx): string | null;
-
-export declare function findGridIndex(starts: readonly number[], maxStep: number, windowPx: number): (px: number) => number;
-
-export declare const FONT_UNITS: readonly ["px", "pt", "mm"];
-
-/**
- * FontStyleSchema の実体定義
- */
-export declare const fontStyleDefinition: PluginProperties<FontStyleSchema>;
-
-export declare interface FontStyleSchema {
-    fontSize?: Dimension<FontUnit>;
-    fontFamily?: string;
-    color?: string;
-    fontWeight?: boolean;
-    italic?: boolean;
-    underline?: boolean;
-    lineThrough?: boolean;
-    lineHeight?: number;
-}
-
-export declare type FontUnit = (typeof FONT_UNITS)[number];
-
-export declare interface FormSchema {
-    paper: Paper;
-    grid: Grid;
-    blocks: Block[];
-    metaData?: Record<string, Value>;
-}
-
-declare const ForwardedBlockRenderer: <P extends Record<string, Value> = Record<string, Value>, V extends Value = Value>(props: BlockRendererProps<P, V> & {
-    ref?: default_2.Ref<BlockRef>;
-}) => default_2.ReactElement;
-
-declare const ForwardedEditingBlock: <P extends Record<string, Value>, V extends Value>(props: EditingBlockProps<P, V> & {
-    ref?: default_2.ForwardedRef<BlockRef>;
-}) => default_2.ReactElement;
-
-/**
- * ブロックコンテナの共通スタイルを生成
- *
- * @param blockRectPx - ブロックの位置とサイズ (ピクセル単位)
- * @param options - オプション設定
- * @returns React CSSProperties オブジェクト
- *
- * @example
- * ```tsx
- * const style = getBlockContainerStyle(blockRectPx, {
- *   zIndex: 2400000,
- *   pointerEvents: "auto"
- * });
- * ```
- */
-export declare function getBlockContainerStyle(blockRectPx: BlockRectPx, options?: BlockContainerStyleOptions): default_2.CSSProperties;
-
-/**
- * @file helpers.ts
- * @description z-index計算ヘルパー関数
- */
-/**
- * ブロックの基底z-indexを計算
+ * カスタムシェル構築専用。
  *
- * @param index - ブロックの配列インデックス (0-based)
- * @returns 基底z-index（ブロックはbase ~ base+9を使用可能）
+ * 3 列 × 1 行: [コピー][貼付][複製]
  *
- * @example
- * ```ts
- * getBlockZIndex(0);  // 100
- * getBlockZIndex(1);  // 200
- * getBlockZIndex(10); // 1100
- * ```
+ * `idPrefix` でブロック ID プレフィックスを変更できる。
  */
-export declare function getBlockZIndex(index: number): number;
+export declare function createClipboardWidget(idPrefix?: string): WidgetDef;
 
 /**
- * 選択中のブロックから共通の値を取得する
- * 値がバラバラの場合は undefined を返す
+ * 操作履歴（アンドゥ・リドゥ）ボタン widget を生成するファクトリ関数。
  *
- * @param blocks 選択中のブロック配列
- * @param path プロパティへのパス (例: "props.text", "layout.x", "style.backgroundColor")
- * @returns 全ブロックで共通の値、または値が異なる場合は undefined
- *
- * @example
- * ```ts
- * // propsの値を取得
- * const textValue = getCommonValue(blocks, "props.text");
+ * @remarks
+ * カスタムシェル構築専用。
  *
- * // layoutの値を取得
- * const xPos = getCommonValue<number>(blocks, "layout.x");
+ * 2 列 × 1 行: [元に戻す][やり直し]
  *
- * // styleの値を取得
- * const bgColor = getCommonValue(blocks, "style.backgroundColor");
- * ```
+ * `idPrefix` でブロック ID プレフィックスを変更できる。
  */
-export declare function getCommonValue<T = Value>(blocks: Block[], path: string): T | undefined;
+export declare function createHistoryWidget(idPrefix?: string): WidgetDef;
 
 /**
- * インタラクション状態からモードを導出する
+ * ページナビゲーション widget を生成するファクトリ関数。
  *
  * @remarks
- * モードは状態の導出値であり、状態そのものではない
- * これにより状態の一貫性が保証される
+ * カスタムシェル構築専用。
  *
- * @param state - インタラクション状態
- * @returns 現在のモード
- */
-export declare function getInteractionMode(state: InteractionState): InteractionMode;
-
-/**
- * サポートされる最大ブロック数を取得
+ * 7 列 × 1 行の NoteBlock プリセット:
  *
- * @returns 最大ブロック数
+ *   [prev][current][separator][total][next][add][delete]
  *
- * @example
- * ```ts
- * getMaxBlockCount(); // 9999 (99,999 - 10) / 10
- * ```
- */
-export declare function getMaxBlockCount(): number;
-
-export declare function getMaxStep(starts: number[]): {
-    readonly step: number;
-    readonly windowPx: number;
-};
-
-/**
- * 用紙サイズの寸法を取得(mm単位)
+ * `pageIdx` と `pageCount` を渡すとインジケーター表示が動的になる。
+ *
+ * 省略時は「—」が表示される。
  */
-export declare function getPaperSize(paperSize: PrintPaperSize, orientation: Orientation): {
-    width: number;
-    height: number;
-};
-
-export declare const getStrokeDasharray: (lineStyle?: LineStyle) => string | undefined;
+export declare function createPageNavigationWidget(options: {
+    pageIdx?: number;
+    pageCount?: number;
+}): WidgetDef;
 
 /**
- * ブロック内のサブレイヤーz-indexを計算
+ * プラグインの配列から `kind` をキーとしたレジストリを生成する。
  *
- * @param baseZIndex - ブロックの基底z-index
- * @param subIndex - サブレイヤーのオフセット (0-99)
- * @returns サブレイヤーのz-index
+ * 各プラグインの `properties` から `defaultProps` を合成し、`Renderer` をベース型に正規化した `ResolvedPlugin` を返す。
  *
  * @example
  * ```ts
- * const baseZ = getBlockZIndex(0); // 100
- * getSubLayerZIndex(baseZ, BLOCK_SUB_INDEX.BG);     // 110 (Blockの背景色)
- * getSubLayerZIndex(baseZ, BLOCK_SUB_INDEX.CONTENT); // 150 (Blockのコンテンツ)
+ * const registry = createPluginRegistry([TextPlugin, CheckboxPlugin]);
  * ```
  */
-export declare function getSubZIndex(baseZIndex: number, subIndex: number): number;
-
-/**
- * グローバルドラッグストア
- * シングルトンパターンで実装
- */
-declare class GlobalDragStore {
-    private state;
-    private listeners;
+export declare function createPluginRegistry(plugins: readonly (Pick<BlockPlugin, "kind" | "meta" | "properties"> & {
     /**
-     * ドラッグ開始
-     * Paletteから呼ばれる
+     * `forwardRef()` で生成した React コンポーネント。
      *
-     * @param kind プラグインの種類
-     * @param defaultSize デフォルトサイズ (グリッド単位)
-     */
-    start(kind: string, defaultSize: {
-        w: number;
-        h: number;
-    }): void;
-    /**
-     * ドラッグ終了
-     * window.pointerup で呼ばれる
+     * `ForwardRefExoticComponent<never>` は P=never（⊥型）を使うことでどの P でも代入可。
+     *
+     * 非コンポーネント値（数値等）は型エラーになる。
      */
-    end(): void;
+    Renderer: ForwardRefExoticComponent<never>;
     /**
-     * 現在の状態を取得
-     * NoteFormのonPointerEnterから呼ばれる
+     * `never[]` rest 型により、任意の引数型の関数が代入可。
      *
-     * @returns 現在ドラッグ中のアイテム (なければ null)
+     * 非関数値は型エラーになる。
      */
-    get(): DragState;
+    migrateProps?: (...args: never[]) => unknown;
     /**
-     * 状態変化を監視
-     * (現在は使用していないが、将来的なデバッグ用に実装)
+     * `never[]` rest 型により、任意の引数型の関数が代入可。
      *
-     * @param listener 状態変化時に呼ばれる関数
-     * @returns アンサブスクライブ関数
+     * 非関数値は型エラーになる。
      */
-    subscribe(listener: Listener): () => void;
+    validateProps?: (...args: never[]) => unknown;
     /**
-     * 全リスナーに状態変化を通知
+     * `never[]` rest 型により、任意の引数型の関数が代入可。
+     *
+     * 非関数値は型エラーになる。
      */
-    private notify;
-}
+    validateValue?: (...args: never[]) => unknown;
+})[]): PluginRegistry;
 
 /**
- * グローバルドラッグストアのシングルトンインスタンス
+ * 選択操作・削除ボタン widget を生成するファクトリ関数。
+ *
+ * @remarks
+ * カスタムシェル構築専用。
+ *
+ * 3 列 × 1 行: [全選択][選択解除][削除]
+ *
+ * `idPrefix` でブロック ID プレフィックスを変更できる。
  */
-export declare const globalDragStore: GlobalDragStore;
-
-export declare interface Grid {
-    cols: Dimension<GridUnit>[];
-    rows: Dimension<GridUnit>[];
-}
+export declare function createSelectionDeleteWidget(idPrefix?: string): WidgetDef;
 
-export declare const GRID_UNITS: readonly ["mm", "cm", "fr", "inch", "pt", "px"];
+/**
+ * デフォルト Book（1ページ・空スキーマ）。
+ */
+export declare const DEFAULT_BOOK: Book;
 
 /**
- * GridCanvas
- *
- * 用紙背景を描画するコンポーネント
- * - z-index: 0 (GridLayerの最下層)
- * - pointer-events: none (クリックイベント透過)
- * - 白い用紙背景を表示
+ * デフォルトグリッド。A4 縦置き時にセルがほぼ正方形になるよう、
+ * 列数 20・行数 28 に設定。
  */
-export declare const GridCanvas: React.FC<GridCanvasProps>;
+export declare const DEFAULT_GRID: Grid;
 
 /**
- * GridCanvasコンポーネントのProps
+ * デフォルトフォームスキーマ（空ページ）。
  */
-export declare interface GridCanvasProps {
-    canvasPx: PaperCanvasPx;
-    backgroundColor?: string;
-    boxShadow?: string;
-    zIndex?: number;
-    className?: string;
-}
+export declare const DEFAULT_PAGE: Page;
 
-export declare interface GridChangeEvent {
-    type: GridChangeType;
-    index?: number;
-    cols?: readonly Dimension<GridUnit>[];
-    rows?: readonly Dimension<GridUnit>[];
-    affectedBlockIds: string[];
-}
+/**
+ * デフォルト用紙設定（A4 縦置き、マージン四辺 10 mm）。
+ */
+export declare const DEFAULT_PAPER: Paper;
 
-export declare type GridChangeType = "resize" | "insert" | "delete" | "equalize";
+/**
+ * デフォルトマージン。四辺すべて 10 mm。
+ */
+export declare const DEFAULT_PAPER_MARGIN: PaperMargin;
 
 /**
- * GridDimensionLabel - グリッド線間の寸法表示
- *
- * グリッド線と線の間に寸法（値と単位）を表示します。
- * ダブルクリックで単位編集UIを表示します。
+ * 各プリセットのデフォルト寸法定義。
  */
-export declare const GridDimensionLabel: MemoExoticComponent<({ direction, index, dimension, position, currentPxSize, marginLeftPx, marginTopPx, isNearCursor, resizingPxSize, onDimensionChange, }: GridDimensionLabelProps) => JSX.Element | null>;
-
-export declare interface GridDimensionLabelProps {
-    /** ラベルの方向 ('column' or 'row') */
-    direction: "column" | "row";
-    /** 次元のインデックス（配列のインデックス） */
-    index: number;
-    /** 寸法の値（Dimensionオブジェクト） */
-    dimension: Dimension<GridUnit>;
-    /** ラベルの位置 (px) - 中央座標 */
-    position: number;
-    /** 現在のpxサイズ（単位変換用） */
-    currentPxSize: number;
-    /** 印刷可能領域の左マージン (px) */
-    marginLeftPx: number;
-    /** 印刷可能領域の上マージン (px) */
-    marginTopPx: number;
-    /** カーソルが近い場合にのみ表示 */
-    isNearCursor: boolean;
-    /** リサイズ中のプレビューサイズ(px) - 指定時は単位変換して表示 */
-    resizingPxSize?: number;
-    /** 寸法更新時のコールバック */
-    onDimensionChange?: (direction: "column" | "row", index: number, dimension: Dimension<GridUnit>) => void;
-}
+export declare const DEFAULT_PAPER_SIZES: Record<PaperSizePreset, PaperSize>;
 
 /**
- * GridLayer - グリッドシステムの統合コンポーネント
+ * `getDefaultSelectionActionBarItems` + `SelectionActionBar` をキャンバス上に浮かせて表示するオーバーレイ。
  *
- * 4つのレイヤーを統合して提供します:
- * 1. GridCanvas (z-index: 0) - 用紙背景
- * 2. MarginOverlay (z-index: 1) - 印刷不可領域の視覚化
- * 3. GridOverlay (z-index: 2) - グリッド線
- * 4. BorderOverlay (z-index: 3) - 印刷可能領域の境界線
+ * @remarks
+ * `position: relative` なコンテナ内で選択ブロック群の右上コーナーに `SelectionActionBar` を浮かせる。
  *
  * @example
  * ```tsx
- * <GridLayer
- *   paper={schema.paper}
- *   grid={schema.grid}
- *   paperWidthPx={794}
- *   paperHeightPx={1123}
- *   contentAreaWidthPx={718}
- *   contentAreaHeightPx={1047}
- *   marginLeftPx={38}
- *   marginRightPx={38}
- *   marginTopPx={38}
- *   marginBottomPx={38}
- *   colWidthPxs={[100, 150, 200, 268]}
- *   rowHeightPxs={[50, 75, 100, 125, 697]}
- * />
+ * <div style={{ position: "relative" }}>
+ *   <NoteForm ... />
+ *   <DefaultSelectionActionBarOverlay context={context} />
+ * </div>
  * ```
  */
-export declare const GridLayer: React.FC<GridLayerProps>;
+export declare const DefaultSelectionActionBarOverlay: {
+    ({ context, gridSize, isDragging, zIndex, onActionFeedback, }: DefaultSelectionActionBarOverlayProps): JSX.Element;
+    displayName: string;
+};
 
 /**
- * GridLayerのプロパティ
+ * `DefaultSelectionActionBarOverlay` コンポーネントへの props。
  */
-export declare interface GridLayerProps {
-    paperPx: PaperPx;
-    gridPosPxs: GridPosPx;
-    gridDimensions?: {
-        cols: Array<Dimension<GridUnit>>;
-        rows: Array<Dimension<GridUnit>>;
-    };
-    gridLineStyle?: LineStyle;
-    borderStyle?: BorderStyle;
-    backgroundColor?: string;
-    boxShadow?: string;
-    marginFillColor?: string;
-    showGridLines?: boolean;
-    showMargins?: boolean;
-    showBorder?: boolean;
-    showResizeHandles?: boolean;
-    showDimensionLabels?: boolean;
-    onGridResize?: (direction: "column" | "row", index: number, delta: number) => void;
-    onDimensionChange?: (direction: "column" | "row", index: number, dimension: Dimension<GridUnit>) => void;
-    className?: string;
-    zIndex?: {
-        canvas?: number;
-        margin?: number;
-        grid?: number;
-        border?: number;
-    };
-}
-
-/**
- * GridOverlay
- *
- * グリッド線をSVGで描画するオーバーレイコンポーネント
- * - z-index: 2 (GridLayerの最上層)
- * - pointer-events: none (クリックイベント透過)
- * - コンテンツエリア（印刷可能領域）内にグリッド線を描画
- */
-export declare const GridOverlay: default_2.FC<GridOverlayProps>;
-
-/**
- * GridOverlayコンポーネントのProps
- */
-export declare interface GridOverlayProps {
-    gridPosPx: GridPosPx;
-    contentPx: PaperContentPx;
-    marginLeftPx: number;
-    marginTopPx: number;
-    lineStyle?: LineStyle;
-    visible?: boolean;
-    zIndex?: number;
-    dpi?: number;
-    className?: string;
-}
-
-export declare interface GridPosPx {
-    cols: number[];
-    rows: number[];
-}
-
-/**
- * GridResizeHandle - グリッドリサイズ用のハンドル
- *
- * グリッド線の両端にハンドルを配置し、ドラッグでリサイズ可能にします。
- * 設計文書に従い、「グリッド線そのもののドラッグは禁止」し、
- * 「グリッド線の両端ハンドル」のみをドラッグ可能とします。
- */
-export declare const GridResizeHandle: MemoExoticComponent<({ direction, index, position, marginLeftPx, marginTopPx, onResizeStart, onResize, onResizeEnd, }: GridResizeHandleProps) => JSX.Element>;
-
-/**
- * @file GridResizeHandle.tsx
- * @description グリッドリサイズ用のハンドルコンポーネント
- */
-export declare interface GridResizeHandleProps {
-    /** ハンドルの方向 ('column' or 'row') */
-    direction: "column" | "row";
-    /** グリッドのインデックス (列なら列番号、行なら行番号) */
-    index: number;
-    /** ハンドルの位置 (px) - グリッド線の位置 */
-    position: number;
-    /** 印刷可能領域の左マージン (px) */
-    marginLeftPx: number;
-    /** 印刷可能領域の上マージン (px) */
-    marginTopPx: number;
-    /** リサイズ開始時のコールバック */
-    onResizeStart?: (direction: "column" | "row", index: number) => void;
-    /** リサイズ中のコールバック */
-    onResize?: (direction: "column" | "row", index: number, delta: number) => void;
-    /** リサイズ終了時のコールバック */
-    onResizeEnd?: (direction: "column" | "row", index: number, delta: number) => void;
-}
-
-/**
- * GridSizePanel
- * 行・列数を変更するパネル
- */
-export declare const GridSizePanel: {
-    ({ grid, onGridChange }: GridSizePanelProps): JSX.Element;
-    displayName: string;
-};
-
-export declare interface GridSizePanelProps {
-    /** グリッド設定 */
-    grid: Grid;
-    /** グリッド変更時のコールバック */
-    onGridChange: (grid: Grid) => void;
-}
-
-export declare function gridToMms(dims: Dimension<GridUnit>[], contentSizeMm: number): number[];
-
-export declare function gridToPxs(dims: Dimension<GridUnit>[], contentSizeMm: number, dpi: number): number[];
-
-export declare type GridUnit = (typeof GRID_UNITS)[number];
-
-export declare enum HorizontalAlign {
-    left = "flex-start",
-    center = "center",
-    right = "flex-end"
-}
-
-/**
- * ImageSchema の実体定義
- */
-export declare const imageDefinition: PluginProperties<ImageSchema>;
-
-/**
- * 画像プロパティのスキーマ（フラット）
- */
-export declare enum ImageObjectFit {
-    Contain = "contain",
-    Cover = "cover",
-    Fill = "fill",
-    None = "none",
-    ScaleDown = "scale-down"
-}
-
-export declare interface ImageSchema {
-    objectFit?: ImageObjectFit;
-    alt?: string;
-}
-
-/**
- * ImportExportPanel
- * スキーマと値のインポート/エクスポート機能を提供
- */
-export declare const ImportExportPanel: {
-    ({ schema, values, onSchemaChange, onValuesChange, }: ImportExportPanelProps): JSX.Element;
-    displayName: string;
-};
-
-export declare interface ImportExportPanelProps {
-    /** スキーマ */
-    schema: FormSchema;
-    /** 値 */
-    values: Record<string, Value>;
-    /** スキーマ変更時のコールバック */
-    onSchemaChange: (schema: FormSchema) => void;
-    /** 値変更時のコールバック */
-    onValuesChange: (values: Record<string, Value>) => void;
-}
-
-export declare const InsertGhost: MemoExoticComponent<({ pluginRegistry, gridLength, getBlockRectPx, currentGrid, currentMousePx, pluginKind, defaultSize, isOutside, selectionStyle, ghostZIndex, selectBorderZIndex, blockHandlesZIndex, }: InsertGhostProps) => JSX.Element | null>;
-
-export declare interface InsertGhostProps {
-    pluginRegistry: Record<string, BlockPlugin>;
-    gridLength: {
-        cols: number;
-        rows: number;
-    };
-    getBlockRectPx: (block: Block) => BlockRectPx;
-    currentGrid: {
-        col: number;
-        row: number;
-    };
-    currentMousePx?: {
-        x: number;
-        y: number;
-    };
-    pluginKind: string;
-    defaultSize: {
-        w: number;
-        h: number;
-    };
-    isOutside: boolean;
-    selectionStyle: BorderStyle;
-    ghostZIndex?: number;
-    selectBorderZIndex?: number;
-    blockHandlesZIndex?: number;
-}
-
-export declare const InteractionBlock: default_2.MemoExoticComponent<({ block, rect, showHandles, onResizeStart, activeHandle, selectionStyle, handleStyle, selectBorderZIndex, blockHandlesZIndex, }: InteractionBlockProps) => JSX.Element>;
-
-export declare interface InteractionBlockProps {
-    block: Block;
-    rect: BlockRectPx;
-    showHandles?: boolean;
-    onResizeStart?: (e: default_2.PointerEvent, handle: ResizeHandle) => void;
-    activeHandle?: ResizeHandle | null;
-    selectionStyle?: BorderStyle;
-    handleStyle?: typeof RESIZE_HANDLE_STYLE;
-    /** 選択枠のz-index (デフォルト: interactionZIndexs.select_border) */
-    selectBorderZIndex?: number;
-    /** リサイズハンドルのz-index (デフォルト: interactionZIndexs.block_handles) */
-    blockHandlesZIndex?: number;
-}
-
-export declare type InteractionChangeEvent = {
-    type: InteractionEventType.START_PRESS;
-    blockId: string;
-    startGrid: {
-        col: number;
-        row: number;
-    };
-    selectedBlockIds?: string[];
-} | {
-    type: InteractionEventType.UPDATE_DRAG;
-    currentGrid: {
-        col: number;
-        row: number;
-    };
-    currentMousePx: {
-        x: number;
-        y: number;
-    };
-    isOutside?: boolean;
-} | {
-    type: InteractionEventType.END_DRAG;
-} | {
-    type: InteractionEventType.CANCEL_DRAG;
-} | {
-    type: InteractionEventType.EDIT;
-    blockId: string;
-} | {
-    type: InteractionEventType.END_EDIT;
-} | {
-    type: InteractionEventType.START_INSERT;
-    pluginKind: string;
-    defaultSize: {
-        w: number;
-        h: number;
-    };
-} | {
-    type: InteractionEventType.CANCEL_INSERT;
-} | {
-    type: InteractionEventType.START_RESIZE;
-    blockId: string;
-    handle: ResizeHandle;
-    startGrid: {
-        col: number;
-        row: number;
-    };
-};
-
-/**
- * インタラクション変更イベント種別
- *
- * @remarks
- * インタラクション変更イベントの種類を型安全に扱うための列挙型
- */
-export declare enum InteractionEventType {
-    /** プレス開始（ドラッグ判定前） */
-    START_PRESS = "startPress",
-    /** ドラッグ更新 */
-    UPDATE_DRAG = "updateDrag",
-    /** ドラッグ終了 */
-    END_DRAG = "endDrag",
-    /** ドラッグキャンセル */
-    CANCEL_DRAG = "cancelDrag",
-    /** 編集開始 */
-    EDIT = "edit",
-    /** 編集終了 */
-    END_EDIT = "endEdit",
-    /** 挿入開始 */
-    START_INSERT = "startInsert",
-    /** 挿入キャンセル */
-    CANCEL_INSERT = "cancelInsert",
-    /** リサイズ開始 */
-    START_RESIZE = "startResize"
-}
-
-export declare const InteractionLayer: MemoExoticComponent<({ blocks, pluginRegistry, gridLength, getBlockRectPx, getColIndex, getRowIndex, state, onChange, selectedBlockIds, onSelectionChange, onBlockChange, scale, className, selectionStyle, handleStyle, editBlockZIndex, selectBorderZIndex, blockHandlesZIndex, dragGhostZIndex, }: InteractionLayerProps) => JSX.Element>;
-
-/**
- * InteractionLayerProps
- */
-export declare interface InteractionLayerProps {
-    blocks: Block[];
-    pluginRegistry: Record<string, BlockPlugin>;
-    gridLength: {
-        cols: number;
-        rows: number;
-    };
-    getBlockRectPx: (block: Block) => BlockRectPx;
-    getColIndex: (px: number) => number;
-    getRowIndex: (px: number) => number;
-    state: InteractionState;
-    onChange: OnInteractionChange;
-    selectedBlockIds: string[];
-    onSelectionChange: (blockIds: string[]) => void;
-    onBlockChange?: OnBlockChange;
-    scale?: number;
-    className?: string;
-    selectionStyle?: BorderStyle;
-    handleStyle?: typeof RESIZE_HANDLE_STYLE;
-    editBlockZIndex?: number;
-    selectBorderZIndex?: number;
-    blockHandlesZIndex?: number;
-    dragGhostZIndex?: number;
-}
-
-/**
- * インタラクションモード
- *
- * @remarks
- * インタラクション操作の状態を型安全に扱うための列挙型
- */
-export declare enum InteractionMode {
-    /** 待機状態 */
-    IDLE = "idle",
-    /** マウスダウン中（クリックかドラッグか判定前） */
-    PRESSING = "pressing",
-    /** ドラッグ確定 */
-    DRAGGING = "dragging",
-    /** 編集中 */
-    EDITING = "editing"
-}
-
-/**
- * インタラクション状態 (単一オブジェクト)
- *
- * @remarks
- * Pluginの `value` に相当する統合状態
- * 全ての操作状態をこのオブジェクト1つで管理する
- *
- * **注意**:
- * - 選択状態(`selectedBlockIds`)は外部で管理されます
- * - モード(`mode`)は`dragging`と`editingBlockId`から導出されます
- */
-export declare interface InteractionState {
-    /** 編集中のブロックID (nullの場合は編集モードではない) */
-    editingBlockId: string | null;
-    /** ドラッグ中の状態 (ドラッグ中のみ有効) */
-    dragging?: DraggingState;
-}
-
-export declare const interactionZIndexs: {
-    readonly base: 2100000;
-    readonly select_block: 2000000;
-    readonly block_ghost: 2200000;
-    readonly hover_outline: 2300000;
-    readonly edit_block: 2400000;
-    readonly grid_ghost: 2700000;
-    readonly grid_handles: 2800000;
-    readonly select_border: 2500000;
-    readonly block_handles: 2600000;
-    readonly rubber_band: 2900000;
-};
-
-/**
- * Hex カラー文字列の妥当性をチェック
- * @param hex チェックする文字列
- * @returns 妥当な Hex カラー文字列かどうか
- */
-export declare function isValidHex(hex: string): boolean;
-
-export declare const LayoutPanel: default_2.FC<LayoutPanelProps>;
-
-export declare interface LayoutPanelProps {
-    selectedBlocks: Block[];
-    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
+export declare interface DefaultSelectionActionBarOverlayProps {
+    /** NoteContext（`useNoteContext` が返すコンテキスト） */
+    context: NoteContext;
+    /** グリッドサイズ（レイアウトパネルに使用） */
     gridSize?: {
         cols: number;
         rows: number;
     };
-}
-
-export declare interface LineStyle {
-    color: string;
-    width: Dimension<BorderUnit>;
-    type: LineType;
-}
-
-export declare enum LineType {
-    SOLID = "solid",// 実線
-    DASHED = "dashed",// 破線
-    DOTTED = "dotted"
-}
-
-/**
- * 状態変化を監視するリスナー関数
- */
-declare type Listener = (state: DragState) => void;
-
-/**
- * MarginOverlay
- *
- * 用紙のマージン（印刷不可領域）を視覚的に表示するコンポーネント
- * - z-index: 1 (GridCanvasの上、GridOverlayの下)
- * - pointer-events: none (クリックイベント透過)
- * - 半透明の影でマージン領域を表現
- */
-export declare const MarginOverlay: default_2.FC<MarginOverlayProps>;
-
-/**
- * MarginOverlayコンポーネントのProps
- */
-export declare interface MarginOverlayProps {
-    paperPx: PaperPx;
-    visible?: boolean;
-    marginColor?: string;
+    /** ドラッグ中のとき `true` を渡すと非表示になる */
+    isDragging?: boolean;
+    /** z-index（デフォルト: `Z_INDEX.SELECTION_ACTION_BAR`） */
     zIndex?: number;
-    className?: string;
-}
-
-/**
- * MarginPanel
- * マージンを変更するパネル
- */
-export declare const MarginPanel: {
-    ({ paper, onPaperChange }: MarginPanelProps): JSX.Element;
-    displayName: string;
-};
-
-export declare interface MarginPanelProps {
-    /** 用紙設定 */
-    paper: Paper;
-    /** 用紙変更時のコールバック */
-    onPaperChange: (paper: Paper) => void;
-}
-
-export declare const MetaPanel: default_2.FC<MetaPanelProps>;
-
-export declare interface MetaPanelProps {
-    selectedBlocks: Block[];
-    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
-}
-
-export declare function mmsToPxs(mms: number[], dpi?: number): number[];
-
-export declare const MovingGhost: MemoExoticComponent<({ blocks, pluginRegistry, gridLength, getBlockRectPx, selectedBlockIds, deltaCol, deltaRow, isOutside, currentMousePx, selectionStyle, ghostZIndex, selectBorderZIndex, blockHandlesZIndex, }: MovingGhostProps) => JSX.Element>;
-
-export declare interface MovingGhostProps {
-    blocks: Block[];
-    pluginRegistry: Record<string, BlockPlugin>;
-    gridLength: {
-        cols: number;
-        rows: number;
-    };
-    getBlockRectPx: (block: Block) => BlockRectPx;
-    selectedBlockIds: string[];
-    deltaCol: number;
-    deltaRow: number;
-    isOutside: boolean;
-    currentMousePx?: {
-        x: number;
-        y: number;
-    };
-    selectionStyle: BorderStyle;
-    ghostZIndex?: number;
-    selectBorderZIndex?: number;
-    blockHandlesZIndex?: number;
-}
-
-export declare const multilineDefinition: PluginProperties<MultilineSchema>;
-
-export declare interface MultilineSchema {
-    multiline?: boolean;
-    wordWrap?: MultilineWordWrap;
-    whiteSpace?: MultilineWhiteSpace;
-}
-
-export declare enum MultilineWhiteSpace {
-    Normal = "normal",
-    NoWrap = "nowrap",
-    Pre = "pre",
-    PreWrap = "pre-wrap",
-    PreLine = "pre-line"
-}
-
-export declare enum MultilineWordWrap {
-    Normal = "normal",
-    BreakWord = "break-word",
-    BreakAll = "break-all"
-}
-
-export declare const NoteEdit: MemoExoticComponent<    {
-({ schema, values, pluginRegistry, onValueChange, scale, className, }: NoteEditProps): JSX.Element;
-displayName: string;
-}>;
-
-export declare const NoteEditor: MemoExoticComponent<    {
-({ schema, values, mode, pluginRegistry, selectedBlockIds, onSchemaChange, onValuesChange, onSelectionChange, scale, className, }: NoteEditorProps): JSX.Element;
-displayName: string;
-}>;
-
-export declare interface NoteEditorProps {
-    schema: FormSchema;
-    values: Record<string, Value>;
-    mode: NoteMode;
-    pluginRegistry: Record<string, BlockPlugin>;
-    selectedBlockIds?: string[];
-    onSchemaChange?: OnSchemaChange;
-    onValuesChange?: OnValuesChange;
-    onSelectionChange?: (selectedBlockIds: string[]) => void;
-    scale?: number;
-    className?: string;
-}
-
-export declare interface NoteEditProps {
-    schema: FormSchema;
-    values: Record<string, Value>;
-    pluginRegistry: Record<string, BlockPlugin>;
-    onValueChange?: OnChange;
-    scale?: number;
-    className?: string;
-}
-
-export declare const NoteForm: MemoExoticComponent<    {
-({ schema, pluginRegistry, selectedBlockIds: OuterSelectedBlockIds, onSchemaChange, onSelectionChange: onOuterSelectionChange, scale, className, }: NoteFormProps): JSX.Element;
-displayName: string;
-}>;
-
-export declare interface NoteFormProps {
-    schema: FormSchema;
-    pluginRegistry: Record<string, BlockPlugin>;
-    selectedBlockIds?: string[];
-    onSchemaChange?: OnSchemaChange;
-    onSelectionChange?: (selectedBlockIds: string[]) => void;
-    scale?: number;
-    className?: string;
-}
-
-export declare enum NoteMode {
-    FORM = "Form",// テンプレート作成モード
-    EDIT = "Edit",// 値入力モード
-    VIEW = "View"
-}
-
-export declare const NotePrint: NamedExoticComponent<NotePrintProps & RefAttributes<NoteViewPrintRef>>;
-
-export declare interface NotePrintProps {
-    schema: FormSchema;
-    values?: Record<string, Value>;
-    pluginRegistry: Record<string, BlockPlugin>;
-    className?: string;
-}
-
-export declare const NoteView: MemoExoticComponent<    {
-({ schema, values, pluginRegistry, scale, className, }: NoteViewProps): JSX.Element;
-displayName: string;
-}>;
-
-/**
- * NoteView の ref に公開する印刷メソッド
- */
-export declare interface NoteViewPrintRef {
-    /** 印刷ダイアログを開く */
-    print: () => void;
-    /** 印刷プレビューを開く（ブラウザの印刷ダイアログ） */
-    openPrintPreview: () => void;
-}
-
-export declare interface NoteViewProps {
-    schema: FormSchema;
-    values: Record<string, Value>;
-    pluginRegistry: Record<string, BlockPlugin>;
-    scale?: number;
-    className?: string;
-}
-
-export declare const NumberInput: {
-    ({ value, onChange, readOnly, min: propMin, max: propMax, step: propStep, integer: propInteger, placeholder: propPlaceholder, width: propWidth, height: propHeight, config, onBlur, }: NumberInputProps): default_2.ReactElement;
-    displayName: string;
-};
-
-export declare interface NumberInputConfig {
-    min?: number;
-    max?: number;
-    step?: number;
-    integer?: boolean;
-    placeholder?: string;
-    width?: number;
-    height?: number;
-    [key: string]: Value;
-}
-
-export declare interface NumberInputProps extends PropertyComponentProps<number | undefined> {
-    min?: number;
-    max?: number;
-    step?: number;
-    integer?: boolean;
-    placeholder?: string;
-    /** 幅(px) */
-    width?: number;
-    /** 高さ(px) */
-    height?: number;
-    config?: NumberInputConfig;
-    onBlur?: () => void;
-}
-
-export declare type OnBlockChange = (event: BlockChangeEvent) => void;
-
-export declare type OnBlur = (id: string, value: Value) => void;
-
-export declare type OnChange = (id: string, value: Value) => void;
-
-export declare type OnError = (error: Error, context?: string) => void;
-
-export declare type OnGridChange = (event: GridChangeEvent) => void;
-
-/**
- * インタラクション変更コールバック
- *
- * @remarks
- * Pluginの `onChange` に相当
- * 全ての操作変更をこの1つのコールバックで処理する
- */
-export declare type OnInteractionChange = (event: InteractionChangeEvent) => void;
-
-export declare type OnPaperChange = (event: PaperChangeEvent) => void;
-
-export declare type OnSchemaChange = (schema: FormSchema) => void;
-
-export declare type OnSelectionChange = (selectedIds: string[]) => void;
-
-export declare type OnValidationError = (errors: Record<string, ValidationError[]>) => void;
-
-export declare type OnValuesChange = (values: Record<string, Value>) => void;
-
-/**
- * 用紙の向き
- */
-export declare type Orientation = "portrait" | "landscape";
-
-/**
- * OtherPanel
- * その他の設定の統合パネル
- * - ImportExportPanel: スキーマ・値のインポート/エクスポート
- */
-export declare const OtherPanel: {
-    ({ schema, values, onSchemaChange, onValuesChange, }: OtherPanelProps): JSX.Element;
-    displayName: string;
-};
-
-export declare interface OtherPanelProps {
-    /** フォームスキーマ */
-    schema: FormSchema;
-    /** 入力データ */
-    values: Record<string, Value>;
-    /** スキーマ変更時のコールバック */
-    onSchemaChange: (newSchema: FormSchema) => void;
-    /** 入力データ変更時のコールバック */
-    onValuesChange: (newValues: Record<string, Value>) => void;
-}
-
-export declare const PADDING_UNITS: readonly ["mm", "pt", "px", "%"];
-
-/**
- * PaddingSchema の実体定義
- */
-export declare const paddingDefinition: PluginProperties<PaddingSchema>;
-
-/**
- * パディングプロパティのスキーマ
- */
-export declare interface PaddingSchema {
-    isIndividual?: boolean;
-    all?: Dimension<PaddingUnit>;
-    top?: Dimension<PaddingUnit>;
-    right?: Dimension<PaddingUnit>;
-    bottom?: Dimension<PaddingUnit>;
-    left?: Dimension<PaddingUnit>;
-}
-
-export declare type PaddingUnit = (typeof PADDING_UNITS)[number];
-
-/**
- * PalettePanel
- * ブロックをドラッグ&ドロップで挿入するためのパレット
- */
-export declare const PalettePanel: {
-    ({ plugins, className }: PalettePanelProps): JSX.Element;
-    displayName: string;
-};
-
-export declare interface PalettePanelProps {
-    /** 利用可能なプラグイン一覧 */
-    plugins: BlockPlugin[];
-    /** カスタムクラス名 */
-    className?: string;
-}
-
-export declare interface Paper {
-    size: PaperSize;
-    margin: PaperMargin;
-}
-
-export declare const PAPER_UNITS: readonly ["mm", "cm", "inch"];
-
-export declare interface PaperCanvasPx {
-    width: number;
-    height: number;
-}
-
-export declare interface PaperChangeEvent {
-    type: PaperChangeType;
-    paper: Paper;
-}
-
-export declare type PaperChangeType = "size" | "margin" | "preset";
-
-export declare interface PaperContentPx {
-    width: number;
-    height: number;
-}
-
-export declare interface PaperMargin {
-    top: Dimension<PaperUnit>;
-    right: Dimension<PaperUnit>;
-    bottom: Dimension<PaperUnit>;
-    left: Dimension<PaperUnit>;
-}
-
-export declare interface PaperMarginPx {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-}
-
-export declare interface PaperPx {
-    canvas: PaperCanvasPx;
-    margin: PaperMarginPx;
-    content: PaperContentPx;
-}
-
-export declare interface PaperSize {
-    preset: PaperSizePreset;
-    width: Dimension<PaperUnit>;
-    height: Dimension<PaperUnit>;
-}
-
-/**
- * PaperSizePanel
- * 用紙サイズを変更するパネル
- */
-export declare const PaperSizePanel: {
-    ({ paper, onPaperChange, }: PaperSizePanelProps): JSX.Element;
-    displayName: string;
-};
-
-export declare interface PaperSizePanelProps {
-    /** 用紙設定 */
-    paper: Paper;
-    /** 用紙変更時のコールバック */
-    onPaperChange: (paper: Paper) => void;
-}
-
-export declare enum PaperSizePreset {
-    A4 = "A4",
-    B5 = "B5",
-    A3 = "A3",
-    LETTER = "Letter",
-    LEGAL = "Legal",
-    CUSTOM = "Custom"
-}
-
-export declare type PaperUnit = (typeof PAPER_UNITS)[number];
-
-/**
- * カラー文字列を RGBA オブジェクトに変換
- * @param value カラー文字列 (#RRGGBB, #RRGGBBAA, rgba(r,g,b,a), undefined)
- * @returns RGBA オブジェクト、または null（変換失敗時）
- */
-export declare function parseColor(value: string | undefined): RGBA | null;
-
-/**
- * PlaceholderSchema の実体定義
- */
-export declare const placeholderDefinition: PluginProperties<PlaceholderSchema>;
-
-/**
- * プレースホルダープロパティのスキーマ（フラット）
- */
-export declare interface PlaceholderSchema {
-    placeholder?: string;
-}
-
-declare type Plugin_2<P = Record<string, Value>, V = Value> = BlockPlugin<P, V> | FeaturePlugin;
-export { Plugin_2 as Plugin }
-
-/**
- * プラグインアイコンProps
- */
-export declare interface PluginIconProps {
-    className?: string;
-    style?: default_2.CSSProperties;
-}
-
-export declare const PluginPanels: React.FC<PluginPanelsProps>;
-
-export declare interface PluginPanelsProps {
-    selectedBlocks: Block[];
-    pluginRegistry: Record<string, BlockPlugin>;
-    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
-}
-
-export declare type PluginProperties<P> = {
-    [K in keyof P]-?: PropertyConfig<P[K], P>;
-};
-
-/**
- * 印刷前の準備処理
- */
-export declare function preparePrint(options?: {
-    title?: string;
-    removeScrollbars?: boolean;
-}): void;
-
-/**
- * 特定の要素だけを印刷
- * 非破壊的な方法: 一時的なクラスを使用して、CSSで他の要素を非表示化
- */
-export declare function printElement(element: HTMLElement, options?: {
-    title?: string;
-    onBeforePrint?: () => void;
-    onAfterPrint?: () => void;
-}): void;
-
-/**
- * 印刷時の余白設定
- */
-export declare interface PrintMargin {
-    top?: string;
-    right?: string;
-    bottom?: string;
-    left?: string;
-}
-
-/**
- * @file types/print/index.ts
- * @description 印刷機能関連の型定義
- */
-/**
- * 印刷用の用紙サイズ
- */
-export declare type PrintPaperSize = "A4" | "A3" | "B4" | "B5" | "Letter" | "Legal";
-
-/**
- * 印刷設定
- */
-export declare interface PrintSettings {
-    /** 用紙サイズ */
-    paperSize?: PrintPaperSize;
-    /** 用紙の向き */
-    orientation?: Orientation;
-    /** 余白 */
-    margin?: PrintMargin;
-}
-
-/**
- * PropertiesPanel Props
- *
- * @template P - プラグイン固有プロパティ型
- */
-export declare interface PropertiesPanelProps<P = Record<string, Value>> {
-    props: P;
-    onChange: (nextProps: P) => void;
-}
-
-export declare interface PropertyComponentProps<T> {
-    value: T;
-    onChange: (value: T) => void;
-    readOnly?: boolean;
-    config?: Record<string, Value>;
-}
-
-export declare type PropertyConfig<T, Context> = PropertyDefinition_2<T, Context> | false;
-
-declare interface PropertyDefinition_2<T, Context = Record<string, Value>> {
-    /** デフォルト値 */
-    defaultValue: T;
-    /** UIに表示されるラベル */
-    label?: string;
-    /** UI上のグループ分け (例: "フォント", "レイアウト") */
-    group?: string;
-    /** プロパティ編集用のUIコンポーネント */
-    Component?: default_2.ComponentType<PropertyComponentProps<T>>;
-    config?: Record<string, Value>;
-    /** 説明文 (ツールチップ等で表示) */
-    description?: string;
-    /** 複数ブロック選択時に編集不可にするか */
-    disableInMultiSelection?: boolean;
-    condition?: (data: Context) => boolean;
-}
-export { PropertyDefinition_2 as PropertyDefinition }
-
-export declare const PropertyField: MemoExoticComponent<({ propertyKey, definition, selectedBlocks, onChange, }: PropertyFieldProps) => JSX.Element | null>;
-
-export declare interface PropertyFieldProps {
-    propertyKey: string;
-    definition: PropertyDefinition_2<Value, Record<string, Value>>;
-    selectedBlocks: Block[];
-    onChange: (key: string, val: Value) => void;
-}
-
-/**
- * @file objectUtils.ts
- * @description オブジェクト操作のユーティリティ関数
- */
-/**
- * オブジェクトからundefined/nullプロパティを再帰的に削除する
- * 空オブジェクト{}は保持される(削除指示として重要)
- */
-export declare function removeUndefinedProps<T extends Record<string, unknown>>(obj: T): T;
-
-/**
- * BlockRenderer Props
- *
- * @template P - プラグイン固有プロパティ型
- * @template V - プラグインが扱う値の型
- */
-export declare interface RendererProps<P = Record<string, Value>, V = Value> {
-    id: string;
-    props: P;
-    value: V;
-    onChange: (value: V) => void;
-    onBlur?: (value: V) => void;
-    readOnly: boolean;
-    mode: NoteMode;
-    dimensions?: {
-        widthPx: number;
-        heightPx: number;
-    };
-    validationState?: "valid" | "invalid" | "warning";
-}
-
-export declare const RESIZE_HANDLE_STYLE: ResizeHandleStyle;
-
-export declare const ResizeGhost: MemoExoticComponent<({ blocks, pluginRegistry, gridLength, getBlockRectPx, blockId, handle, deltaCol, deltaRow, isOutside, selectionStyle, ghostZIndex, selectBorderZIndex, blockHandlesZIndex, }: ResizeGhostProps) => JSX.Element | null>;
-
-export declare interface ResizeGhostProps {
-    blocks: Block[];
-    pluginRegistry: Record<string, BlockPlugin>;
-    gridLength: {
-        cols: number;
-        rows: number;
-    };
-    getBlockRectPx: (block: Block) => BlockRectPx;
-    blockId: string;
-    handle: ResizeHandle;
-    deltaCol: number;
-    deltaRow: number;
-    isOutside: boolean;
-    selectionStyle: BorderStyle;
-    ghostZIndex?: number;
-    selectBorderZIndex?: number;
-    blockHandlesZIndex?: number;
-}
-
-/**
- * リサイズハンドル方向
- *
- * @remarks
- * 8方向のリサイズハンドルを型安全に扱うための列挙型
- */
-export declare enum ResizeHandle {
-    /** 北（上） */
-    N = "n",
-    /** 北東（右上） */
-    NE = "ne",
-    /** 東（右） */
-    E = "e",
-    /** 南東（右下） */
-    SE = "se",
-    /** 南（下） */
-    S = "s",
-    /** 南西（左下） */
-    SW = "sw",
-    /** 西（左） */
-    W = "w",
-    /** 北西（左上） */
-    NW = "nw"
-}
-
-export declare const ResizeHandles: default_2.MemoExoticComponent<({ onResizeStart, activeHandle, handleStyle, zIndex, }: ResizeHandlesProps) => JSX.Element>;
-
-export declare interface ResizeHandlesProps {
-    onResizeStart: (e: default_2.PointerEvent, handle: ResizeHandle) => void;
-    activeHandle?: ResizeHandle | null;
-    handleStyle?: ResizeHandleStyle;
-    zIndex?: number;
-}
-
-export declare interface ResizeHandleStyle {
-    size: number;
-    backgroundColor: string;
-    borderColor: string;
-    borderWidth: number;
-    borderRadius: string;
-}
-
-/**
- * リサイズ計算パラメータ
- */
-export declare interface ResizeParams {
-    /** 現在のレイアウト */
-    layout: BlockLayout;
-    /** リサイズハンドル */
-    handle: ResizeHandle;
-    /** 列方向の移動量 */
-    deltaCol: number;
-    /** 行方向の移動量 */
-    deltaRow: number;
-    /** グリッドの列数 */
-    gridCols: number;
-    /** グリッドの行数 */
-    gridRows: number;
-}
-
-/**
- * RGBA カラー型定義
- */
-export declare interface RGBA {
-    r: number;
-    g: number;
-    b: number;
-    a: number;
-}
-
-/**
- * RGBA入力コンポーネント
- */
-export declare const RGBAInputs: {
-    ({ rgba, onChange, readOnly, }: RGBAInputsProps): default_2.ReactElement;
-    displayName: string;
-};
-
-export declare interface RGBAInputsProps {
-    rgba: RGBA;
-    onChange: (channel: keyof RGBA, value: number | undefined) => void;
-    readOnly?: boolean;
-}
-
-/**
- * ドロップダウン選択コンポーネント
- */
-export declare const Select: {
-    <T extends string = string>(props: SelectProps<T>): default_2.ReactElement;
-    displayName: string;
-};
-
-/**
- * Config型定義
- */
-export declare interface SelectConfig {
-    options?: readonly SelectOption[];
-    placeholder?: string;
-    width?: number;
-    height?: number;
-    [key: string]: Value;
-}
-
-export declare const SELECTION_STYLE: BorderStyle;
-
-export declare const SelectionBorder: MemoExoticComponent<({ width, height, zIndex, borderStyle, }: SelectionBorderProps) => JSX.Element>;
-
-declare interface SelectionBorderProps {
-    width: number;
-    height: number;
-    zIndex?: number;
-    borderStyle?: BorderStyle;
-}
-
-export declare const SelectionLayer: default_2.MemoExoticComponent<({ blocks, selectedBlockIds, isDragging, draggingState, getBlockRectPx, onResizeStart, selectionStyle, handleStyle, selectBorderZIndex, blockHandlesZIndex, }: SelectionLayerProps) => JSX.Element | null>;
-
-export declare interface SelectionLayerProps {
-    blocks: Block[];
-    selectedBlockIds: string[];
-    isDragging: boolean;
-    draggingState?: DraggingState;
-    getBlockRectPx: (block: Block) => BlockRectPx;
-    onResizeStart: (e: default_2.PointerEvent, handle: ResizeHandle, blockId: string) => void;
-    selectionStyle?: BorderStyle;
-    handleStyle?: typeof RESIZE_HANDLE_STYLE;
-    /** 選択枠のz-index (デフォルト: interactionZIndexs.select_border) */
-    selectBorderZIndex?: number;
-    /** リサイズハンドルのz-index (デフォルト: interactionZIndexs.block_handles) */
-    blockHandlesZIndex?: number;
-}
-
-/**
- * 選択肢の型
- */
-export declare interface SelectOption {
-    value: Value;
-    label: string;
-    [key: string]: Value;
-}
-
-/**
- * Select固有のProps
- */
-export declare interface SelectProps<T extends string = string> extends PropertyComponentProps<T | undefined> {
-    options?: readonly SelectOption[];
-    placeholder?: string;
-    /** 幅(px) */
-    width?: number;
-    /** 高さ(px) */
-    height?: number;
-    config?: SelectConfig;
-}
-
-export declare type SerializedValue = string | number | boolean | null | SerializedValue[] | readonly SerializedValue[] | {
-    [key: string]: SerializedValue;
-};
-
-/**
- * FormSchemaをJSON文字列にシリアライズ
- *
- * @param schema - シリアライズするスキーマ
- * @param pretty - 整形して出力するか (デフォルト: false)
- * @returns JSON文字列
- *
- * @example
- * ```ts
- * const schema: FormSchema = { ... };
- * const json = serializeSchema(schema);
- * // または整形版
- * const prettyJson = serializeSchema(schema, true);
- * ```
- */
-export declare function serializeSchema(schema: FormSchema, pretty?: boolean): string;
-
-/**
- * 入力値(values)をJSON文字列にシリアライズ
- *
- * @param values - シリアライズする入力値
- * @param pretty - 整形して出力するか (デフォルト: false)
- * @returns JSON文字列
- *
- * @example
- * ```ts
- * const values: Record<string, Value> = {
- *   'block-1': 'Hello',
- *   'block-2': 42,
- * };
- * const json = serializeValues(values);
- * // または整形版
- * const prettyJson = serializeValues(values, true);
- * ```
- */
-export declare function serializeValues(values: Record<string, Value>, pretty?: boolean): string;
-
-/**
- * Sidebar
- * タブ切り替え機能を持つサイドバー
- * - ブロックタブ: BlockPropertyPanel / PalettePanel
- * - キャンバスタブ: CanvasPanel (用紙設定、マージン設定、グリッド設定、ブロック順序)
- * - その他タブ: OtherPanel (スキーマ/値のインポート/エクスポート)
- */
-export declare const Sidebar: {
-    ({ blocks, selectedBlockIds, pluginRegistry, onUpdateBlocks, schema, values, onSchemaChange, onValuesChange, gridSize, className, }: SidebarProps): JSX.Element;
-    displayName: string;
-};
-
-export declare interface SidebarProps {
-    /** 全ブロック */
-    blocks: Block[];
-    /** 選択中のブロックID一覧 */
-    selectedBlockIds: string[];
-    /** プラグインレジストリ */
-    pluginRegistry: Record<string, BlockPlugin>;
-    /** ブロック更新時のコールバック */
-    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
-    /** フォームスキーマ (CanvasPanel/OtherPanelで使用) */
-    schema: FormSchema;
-    /** 入力データ (OtherPanelで使用) */
-    values: Record<string, Value>;
-    /** スキーマ変更時のコールバック */
-    onSchemaChange: (newSchema: FormSchema) => void;
-    /** 入力データ変更時のコールバック */
-    onValuesChange: (newValues: Record<string, Value>) => void;
-    /** グリッドサイズ (LayoutPanelで使用) */
-    gridSize?: {
-        cols: number;
-        rows: number;
-    };
-    /** カスタムクラス名 */
-    className?: string;
-}
-
-export declare const SIZE_UNITS: readonly ["mm", "cm", "inch", "pt", "px", "%"];
-
-/**
- * SizeSchema の実体定義
- */
-export declare const sizeDefinition: PluginProperties<SizeSchema>;
-
-/**
- * サイズプロパティのスキーマ
- */
-export declare interface SizeSchema {
-    width?: Dimension<SizeUnit>;
-    height?: Dimension<SizeUnit>;
-}
-
-export declare type SizeUnit = (typeof SIZE_UNITS)[number];
-
-export declare function stringsToDimensions<U extends Unit>(strs: string[], allowedUnits: readonly U[]): Dimension<U>[];
-
-export declare function stringToDimension<U extends Unit>(str: string, allowedUnits: readonly U[]): Dimension<U>;
-
-/**
- * TabPanel
- * タブコンテンツの共通ラッパー
- */
-export declare const TabPanel: ({ children, emptyMessage, className, }: TabPanelProps) => JSX.Element;
-
-export declare interface TabPanelProps {
-    /** パネルの内容 */
-    children: ReactNode;
-    /** 空状態のメッセージ（childrenがない場合に表示） */
-    emptyMessage?: string;
-    /** カスタムクラス名 */
-    className?: string;
-}
-
-export declare const Tabs: default_2.FC<TabsProps>;
-
-export declare const TabsContent: default_2.FC<TabsContentProps>;
-
-export declare interface TabsContentProps {
-    value: string;
-    children: default_2.ReactNode;
-    className?: string;
-}
-
-export declare const TabsList: default_2.FC<TabsListProps>;
-
-export declare interface TabsListProps {
-    children: default_2.ReactNode;
-    className?: string;
-    width?: number;
-    height?: number;
-    style?: default_2.CSSProperties;
-}
-
-export declare interface TabsProps {
-    defaultValue: string;
-    value?: string;
-    onValueChange?: (value: string) => void;
-    children: default_2.ReactNode;
-    variant?: "default" | "segmented";
-    className?: string;
-}
-
-export declare const TabsTrigger: default_2.FC<TabsTriggerProps>;
-
-export declare interface TabsTriggerProps {
-    value: string;
-    children: default_2.ReactNode;
-    className?: string;
-    disabled?: boolean;
-    width?: number;
-    height?: number;
-    style?: default_2.CSSProperties;
-}
-
-/**
- * テキスト入力コンポーネント
- */
-export declare const TextInput: {
-    ({ value, onChange, readOnly, placeholder: propPlaceholder, maxLength: propMaxLength, multiline: propMultiline, rows: propRows, width, height, config, onBlur, }: TextInputProps): default_2.ReactElement;
-    displayName: string;
-};
-
-/**
- * Config型定義
- * Record<string, Value> との互換性を持たせる
- */
-export declare interface TextInputConfig {
-    placeholder?: string;
-    maxLength?: number;
-    multiline?: boolean;
-    rows?: number;
-    width?: number;
-    height?: number;
-    [key: string]: Value;
-}
-
-/**
- * TextInput固有のProps
- * T は string | undefined
- */
-export declare interface TextInputProps extends PropertyComponentProps<string | undefined> {
-    placeholder?: string;
-    maxLength?: number;
-    multiline?: boolean;
-    rows?: number;
-    width?: number;
-    height?: number;
-    config?: TextInputConfig;
-    onBlur?: () => void;
-}
-
-/**
- * RGBA オブジェクトを Hex 文字列に変換
- * @param rgba RGBA オブジェクト
- * @returns #RRGGBB または #RRGGBBAA 形式の文字列、透明の場合は undefined
- */
-export declare function toHex(rgba: RGBA): string | undefined;
-
-export declare const toMm: {
-    fromCm(cm: number): number;
-    fromInch(inch: number): number;
-    fromPt(pt: number): number;
-    fromPx(px: number): number;
-    fromDim<U extends Unit>(dim: Dimension<U>): number;
-};
-
-export declare const toPx: {
-    _assertDpi(dpi: number): void;
-    fromMm(mm: number, dpi?: number): number;
-    fromCm(cm: number, dpi?: number): number;
-    fromInch(inch: number, dpi?: number): number;
-    fromPt(pt: number, dpi?: number): number;
-    fromPx(px: number, dpi?: number): number;
-    fromDim<U extends Unit>(dim: Dimension<U>, dpi?: number, baseSizePx?: number): number;
-};
-
-/**
- * RGBA オブジェクトを rgba() 文字列に変換
- * @param rgba RGBA オブジェクト
- * @returns rgba(r, g, b, a) 形式の文字列、透明の場合は undefined
- */
-export declare function toRgbaString(rgba: RGBA): string | undefined;
-
-export declare type Unit = (typeof ALL_UNITS)[number];
-
-/**
- * ほぼすべてのブロックで使用される共通プロパティ定義
- *
- * ## 使用方法
- * ```typescript
- * export const MyPlugin: BlockPlugin = {
- *   properties: {
- *     ...universalProperties, // フラットに展開
- *     // プラグイン固有のプロパティ
- *     customProp: { ... },
- *   },
- * };
- * ```
- *
- * ## 上書き
- * 個別のプロパティを上書きする場合は、後から定義します:
- * ```typescript
- * properties: {
- *   ...universalProperties,
- *   justifyContent: {
- *     ...universalProperties.justifyContent,
- *     defaultValue: HorizontalAlign.center, // デフォルト値を変更
- *   },
- * }
- * ```
- *
- * ## 含まれるプロパティ
- * - **alignment** (justifyContent, alignItems): コンテンツの配置
- * - **padding** (isIndividual, all, top, right, bottom, left): 余白
- */
-export declare const universalProperties: {
-    readonly isIndividual: PropertyConfig<boolean | undefined, PaddingSchema>;
-    readonly all: PropertyConfig<Dimension<"mm" | "pt" | "px" | "%"> | undefined, PaddingSchema>;
-    readonly top: PropertyConfig<Dimension<"mm" | "pt" | "px" | "%"> | undefined, PaddingSchema>;
-    readonly right: PropertyConfig<Dimension<"mm" | "pt" | "px" | "%"> | undefined, PaddingSchema>;
-    readonly bottom: PropertyConfig<Dimension<"mm" | "pt" | "px" | "%"> | undefined, PaddingSchema>;
-    readonly left: PropertyConfig<Dimension<"mm" | "pt" | "px" | "%"> | undefined, PaddingSchema>;
-    readonly justifyContent: PropertyConfig<HorizontalAlign | undefined, AlignmentSchema>;
-    readonly alignItems: PropertyConfig<VerticalAlign | undefined, AlignmentSchema>;
-};
-
-export declare function useGridCalc(paper: Paper, grid: Grid, dpi?: number): {
-    paperPx: PaperPx;
-    gridPosPx: GridPosPx;
-    getColIndex: (px: number) => number;
-    getRowIndex: (px: number) => number;
-    getBlockRectPx: (block: Block) => BlockRectPx;
-};
-
-/**
- * インタラクション状態管理Hook
- *
- * @remarks
- * Reducer的なロジックを内包、外部からはシンプルなAPIのみ公開
- *
- * **核心機能**: グリッド変化判定によるドラッグ確定
- * - `mode: 'pressing'` でグリッドをまたいだら → `mode: 'dragging'` に遷移
- * - ピクセル閾値 (5px) は使わない
- *
- * **選択状態**: 外部で管理されるため、このHookでは管理しません
- * - `SELECT/DESELECT`イベントは外部への通知として残されています
- *
- * @param initialState - 初期状態 (オプション)
- * @returns [state, handleChange] - 状態とコールバック
- *
- * @example
- * ```tsx
- * const [state, onChange] = useInteractionState();
- *
- * // ドラッグ開始 (まだpressing)
- * onChange({ type: InteractionEventType.START_PRESS, blockId: 'block-1', startGrid: { col: 0, row: 0 } });
- *
- * // グリッドをまたぐ (自動的にdraggingへ遷移)
- * onChange({ type: InteractionEventType.UPDATE_DRAG, currentGrid: { col: 1, row: 0 } });
- * ```
- */
-export declare function useInteractionState(initialState?: Partial<InteractionState>): readonly [InteractionState, (event: InteractionChangeEvent) => void];
-
-/**
- * 未知の値がFormSchemaかどうかをバリデーションし、型安全に変換
- *
- * @param value - バリデーションする値
- * @returns FormSchema (バリデーション済み)
- * @throws バリデーションエラー時にエラーをスロー
- *
- * @example
- * ```ts
- * const unknownData = JSON.parse(jsonString);
- * const schema = validateSchema(unknownData);
- * ```
- */
-export declare function validateSchema(value: unknown): FormSchema;
-
-/**
- * 未知の値がRecord<string, Value>かどうかをバリデーションし、型安全に変換
- *
- * @param value - バリデーションする値
- * @returns Record<string, Value> (バリデーション済み)
- * @throws バリデーションエラー時にエラーをスロー
- *
- * @example
- * ```ts
- * const unknownData = JSON.parse(jsonString);
- * const values = validateValues(unknownData);
- * ```
- */
-export declare function validateValues(value: unknown): Record<string, Value>;
-
-/**
- * ValidationSchema の実体定義
- */
-export declare const validationDefinition: PluginProperties<ValidationSchema>;
-
-/**
- * バリデーションエラー情報
- */
-export declare interface ValidationError {
-    message: string;
-    code: string;
-    field?: string;
-    severity: ValidationSeverity;
-    metadata?: Record<string, Value>;
-}
-
-/**
- * バリデーション結果
- */
-export declare interface ValidationResult {
-    valid: boolean;
-    errors: ValidationError[];
-}
-
-/**
- * バリデーションプロパティのスキーマ
- */
-export declare interface ValidationSchema {
-    required?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-}
-
-/**
- * エラーの重大度レベル
- */
-export declare enum ValidationSeverity {
-    ERROR = "error",
-    WARNING = "warning",
-    INFO = "info"
-}
-
-export declare type Value = string | number | boolean | null | undefined | Date | File | Blob | Value[] | readonly Value[] | {
-    [key: string]: Value;
-};
-
-export declare enum VerticalAlign {
-    top = "flex-start",
-    center = "center",
-    bottom = "flex-end"
-}
-
-/**
- * Z-INDEX定数
- *
- * 各レイヤーのz-index範囲を定義
- */
-export declare const Z_INDEX: {
-    /** グリッド背景（用紙背景） */
-    readonly GRID_CANVAS: 10;
-    /** 用紙マージン表示（印刷可能範囲） */
-    readonly MARGIN_OVERLAY: 20;
-    /** グリッド線 */
-    readonly GRID_OVERLAY: 30;
-    /** 印刷可能領域の境界線 */
-    readonly BORDER_OVERLAY: 40;
-    /** BlockLayerの最小z-index */
-    readonly BLOCK_LAYER_MIN: 100;
-    /** BlockLayerの最大z-index */
-    readonly BLOCK_LAYER_MAX: 999999;
-    /** ブロック間のz-indexステップ（各ブロックは100段階のサブレイヤーを持っている） */
-    readonly BLOCK_LAYER_STEP: 100;
-    /** エラー枠線 */
-    readonly ERROR_BORDER: 1100000;
-    /** エラーツールチップ */
-    readonly ERROR_TOOLTIP: 1200000;
-    /** エラー背景ハイライト */
-    readonly ERROR_HIGHLIGHT: 1300000;
-    /** 選択中ブロック */
-    readonly SELECT_BLOCK: 2000000;
-    readonly INTERACTION_LAYER_BASE: 2100000;
-    /** ドラッグ中ゴースト */
-    readonly BLOCK_GHOST: 2200000;
-    /** ホバー枠線 */
-    readonly HOVER_OUTLINE: 2300000;
-    /** ブロック編集中 */
-    readonly EDIT_BLOCK: 2400000;
-    /** 選択中ブロック枠線 */
-    readonly BLOCK_SELECT_BORDER: 2500000;
-    /** ブロックリサイズハンドル */
-    readonly BLOCK_HANDLES: 2600000;
-    /** グリッドリサイズ中のゴースト線 */
-    readonly GRID_GHOST: 2700000;
-    /** グリッドリサイズハンドル */
-    readonly GRID_HANDLES: 2800000;
-    /** 範囲選択矩形 */
-    readonly RUBBER_BAND: 2900000;
-    /** プロパティパネル（サイドバー） */
-    readonly PROPERTY_PANEL: 3100000;
-    /** ブロック追加パレット */
-    readonly PALETTE: 3200000;
-    /** ツールチップ */
-    readonly TOOLTIP: 3300000;
-    /** ドロップダウン */
-    readonly DROPDOWN: 3400000;
-    /** コンテキストメニュー */
-    readonly CONTEXT_MENU: 3500000;
-    /** モーダル */
-    readonly MODAL: 3600000;
-    /** デバッグ表示 */
-    readonly DEBUG: 10000000;
-};
-
-/**
- * Z_INDEX型（型安全性のため）
- */
-export declare type ZIndexValue = (typeof Z_INDEX)[keyof typeof Z_INDEX];
-
-export { }
+    /** アクション実行時のフィードバック */
+    onActionFeedback?: (feedback: ActionFeedback) => void;
+}
+
+/**
+ * JSON 文字列をパース・検証して {@link Book} を返す。
+ *
+ * @throws {@link SyntaxError} JSON が無効な場合
+     * @throws {@link Error} Book の構造が不正な場合
+         */
+     export declare function deserializeBook(json: string): Book;
+
+     /**
+      * JSON 文字列をパース・検証して {@link Page} を返す。
+      *
+      * @throws {@link SyntaxError} JSON が無効な場合
+          * @throws {@link Error} ページの構造が不正な場合
+              */
+          export declare function deserializePage(json: string): Page;
+
+          /**
+           * JSON 文字列をパース・検証して `Record<string, Value>` を返す。
+           *
+           * @throws {@link SyntaxError} JSON が無効な場合
+               * @throws {@link Error} 値が無効な {@link Value} を含む場合
+                   */
+               export declare function deserializeValues(json: string): Record<string, Value>;
+
+               /**
+                * 数値と単位の組み合わせ。
+                */
+               export declare interface Dimension<U extends Unit = Unit> {
+                   /** 数値 */
+                   value: number;
+                   /** 単位 */
+                   unit: U;
+               }
+
+               /**
+                * フルエディター用の UI 状態。
+                *
+                * @remarks
+                * - `useNoteContext` が内部で生成し、`NoteContext` に格納する。
+                * - `Default*` コンポーネントと `getDefault*` ヘルパー関数はこの状態を参照する。
+                */
+               export declare interface EditorState {
+                   /** 選択中のブロック ID 一覧 */
+                   selectedBlockIds: string[];
+                   /** 表示中のページインデックス */
+                   pageIdx: number;
+               }
+
+               /**
+                * `id` を持たないページに一意 ID を付与した新しい Book を返す。
+                *
+                * 保存済み Book の migration に使用する。既に `id` があるページは変更しない。
+                */
+               export declare function ensurePageIds(book: Book): Book;
+
+               /**
+                * キャンバス上にフローティング表示するウィジェットコンポーネント。
+                *
+                * タイトルバーをドラッグで移動、右下コーナードラッグでズーム（拡縮）できる。
+                *
+                * `bindingContext` を省略した場合は `widget.book` をローカル state で管理する。
+                */
+               export declare function FloatingWidget({ label, widget, extraPlugins, position, isDragging, onTitlePointerDown, onClose, onContainerPointerDown, style, context, }: FloatingWidgetProps): JSX.Element;
+
+               /**
+                * `FloatingWidget` コンポーネントへの props。
+                */
+               export declare interface FloatingWidgetProps {
+                   /** タイトルバーに表示するラベル */
+                   label: string;
+                   /** 表示するウィジェット（必要なプラグインを内包した {@link WidgetDef}） */
+                   widget: WidgetDef;
+                   /** `widget.plugins` に追加で使用するプラグイン（省略可） */
+                   extraPlugins?: WidgetDef["plugins"];
+                   /** フローティング位置（position: fixed の left / top） */
+                   position: {
+                       x: number;
+                       y: number;
+                   };
+                   /** `useNoteContext` が返すコンテキスト */
+                   context: NoteContext;
+                   /** ドラッグ中かどうか（影の強弱・pointer-events の制御に使用） */
+                   isDragging: boolean;
+                   /** タイトルバー（ドラッグハンドル）の pointerdown ハンドラ */
+                   onTitlePointerDown: default_2.PointerEventHandler<HTMLDivElement>;
+                   /** ✕ボタンが押されたときのコールバック */
+                   onClose: () => void;
+                   /** コンテナ全体の pointerdown ハンドラ（省略可） */
+                   onContainerPointerDown?: () => void;
+                   /**
+                    * コンテナの style を上書きする（position, z-index などを変更したい場合に使用）。
+                    *
+                    * デフォルト: `position: "fixed"`, z-index: isDragging ? 3750000 : 3700000
+                    */
+                   style?: default_2.CSSProperties;
+               }
+
+               /**
+                * フォントサイズに使用できる単位の配列。
+                */
+               declare const FONT_UNITS: readonly ["pt", "px", "mm"];
+
+               /**
+                * ブロック内のフォントスタイルを保持する Props。
+                */
+               declare interface FontStyleProps {
+                   /** フォントファミリー */
+                   fontFamily?: string;
+                   /** フォントサイズ */
+                   fontSize?: Dimension<FontUnit>;
+                   /** 文字色（CSS カラー値） */
+                   color?: string;
+                   /** `true` のとき太字 */
+                   fontWeight?: boolean;
+                   /** `true` のときイタリック */
+                   italic?: boolean;
+                   /** `true` のとき下線 */
+                   underline?: boolean;
+                   /** `true` のとき取り消し線 */
+                   lineThrough?: boolean;
+               }
+
+               /**
+                * フォントサイズに使用できる単位。
+                */
+               declare type FontUnit = (typeof FONT_UNITS)[number];
+
+               /**
+                * `ActionBar` に渡すデフォルト `sections` 配列を返す。
+                *
+                * @remarks
+                * 各要素には `key` が付いているため `filter`/`map` で操作できる。
+                *
+                * パフォーマンスを要する場合は呼び出し側で `useMemo` を使うこと。
+                *
+                * @example
+                * ```tsx
+                * // デフォルトをそのまま使う
+                * const sections = useMemo(
+                *   () => getDefaultActionBarSections({ context }),
+                *   [context],
+                * );
+                * <ActionBar sections={sections} />
+                *
+                * // カスタムセクションを末尾に追加
+                * <ActionBar sections={[...sections, <MySection key="custom" />]} />
+                * ```
+                */
+               export declare function getDefaultActionBarSections({ context, onActionFeedback, onPrint, }: GetDefaultActionBarSectionsOptions): ReactNode[];
+
+               /**
+                * `getDefaultActionBarSections` のオプション。
+                *
+                * @remarks
+                * `getDefaultActionBarSections` に渡す引数の型。
+                */
+               export declare interface GetDefaultActionBarSectionsOptions {
+                   /** `useNoteContext` が返すコンテキスト */
+                   context: NoteContext;
+                   /** アクション実行時のフィードバック（トースト表示など） */
+                   onActionFeedback?: (feedback: ActionFeedback) => void;
+                   /**
+                    * 印刷ボタン押下時のコールバック。
+                    * 省略時は `printNote(context)` を呼び出してNote内容のみを印刷する。
+                    * PDF生成など独自の印刷処理を行う場合に上書きする。
+                    */
+                   onPrint?: () => void;
+               }
+
+               /**
+                * `Sidebar` に渡すデフォルト tabs 配列（ブロック / キャンバス / その他）を返す。
+                *
+                * @remarks
+                * パフォーマンスを要する場合は呼び出し側で `useMemo` を使うこと。
+                *
+                * @example
+                * ```tsx
+                * // デフォルトをそのまま使う
+                * const tabs = useMemo(
+                *   () => getDefaultSidebarTabs({ context }),
+                *   [context],
+                * );
+                * <Sidebar tabs={tabs} />
+                *
+                * // カスタムタブを末尾に追加
+                * <Sidebar tabs={[...tabs, { value: "custom", label: "カスタム", content: <MyPanel /> }]} />
+                *
+                * // 特定タブを除外
+                * <Sidebar tabs={tabs.filter((t) => t.value !== "other")} />
+                * ```
+                */
+               export declare function getDefaultSidebarTabs({ context, gridSize, onBlockHover, onBlockDragChange, onActionFeedback, }: GetDefaultSidebarTabsOptions): SidebarTab[];
+
+               /**
+                * `getDefaultSidebarTabs` のオプション。
+                *
+                * @remarks
+                * `getDefaultSidebarTabs` に渡す引数の型。
+                */
+               export declare interface GetDefaultSidebarTabsOptions {
+                   /** `useNoteContext` が返すコンテキスト */
+                   context: NoteContext;
+                   /** グリッドサイズ（LayoutPanel で使用） */
+                   gridSize?: {
+                       cols: number;
+                       rows: number;
+                   };
+                   /** ホバー中のブロック ID 通知 */
+                   onBlockHover?: (id: string | null) => void;
+                   /** ドラッグ中のブロック ID 通知 */
+                   onBlockDragChange?: (id: string | null) => void;
+                   /** アクション実行時のフィードバック */
+                   onActionFeedback?: (feedback: ActionFeedback) => void;
+               }
+
+               /**
+                * ページのグリッド定義。
+                *
+                * @remarks
+                * `cols` / `rows` を省略した列/行は全て 1fr 等分割として扱われる。
+                */
+               export declare interface Grid {
+                   /** 列数 */
+                   colCount: number;
+                   /** 行数 */
+                   rowCount: number;
+                   /** 列のサイズ定義マップ（インデックス → Dimension）。省略時は全列 1fr。 */
+                   cols?: Record<number, Dimension<GridUnit>>;
+                   /** 行のサイズ定義マップ（インデックス → Dimension）。省略時は全行 1fr。 */
+                   rows?: Record<number, Dimension<GridUnit>>;
+               }
+
+               /**
+                * グリッドの列・行サイズに使用できる単位の配列。
+                */
+               declare const GRID_UNITS: readonly ["mm", "cm", "fr", "inch", "pt", "px"];
+
+               /**
+                * グリッド設定 compound widget。
+                *
+                * @remarks
+                * カスタムシェル構築専用。
+                *
+                * gridRowCountWidget（行数）と gridColCountWidget（列数）を横並びにした
+                *
+                * 1 行 × 6 列構成。
+                *
+                * 列構成:
+                * - 列 0 (1fr): 行数ラベル
+                * - 列 1 (1fr): 行数 numberInput → `grid.rowCount`
+                * - 列 2 (8mm): 行数 stepper    → `grid.rowCount`
+                * - 列 3 (1fr): 列数ラベル
+                * - 列 4 (1fr): 列数 numberInput → `grid.colCount`
+                * - 列 5 (8mm): 列数 stepper    → `grid.colCount`
+                */
+               export declare const gridSettingsWidget: WidgetDef;
+
+               /**
+                * グリッドの列・行サイズに使用できる単位（`fr` を含む）。
+                */
+               export declare type GridUnit = (typeof GRID_UNITS)[number];
+
+               /**
+                * ブロックの表示/非表示を binding 値で制御する条件式。
+                *
+                * - `string` — 指定パスの値が truthy のとき非表示
+                *
+                * - `{ path, eq }` — 指定パスの値が `eq` と等しいとき非表示
+                *
+                * - `{ path, neq }` — 指定パスの値が `neq` と等しくないとき非表示
+                *
+                * `eq` / `neq` は `===` による参照比較を行うため、オブジェクト・配列を指定しても期待通りに動作しない。
+                *
+                * そのため `Value` からオブジェクト・配列変形を除いた `Exclude<Value, Value[] | readonly Value[] | { [key: string]: Value }>` に制限している。
+                */
+               declare type HiddenBinding = string | {
+                   path: string;
+                   /**
+                    * `===` で比較するためプリミティブ値のみ有効。
+                    *
+                    * `Value` からオブジェクト・配列を除いた型。
+                    */
+                   eq: Exclude<Value, Value[] | readonly Value[] | {
+                       [key: string]: Value;
+                   }>;
+                   /** `eq` と同時指定不可 */
+                   neq?: never;
+               } | {
+                   path: string;
+                   /**
+                    * `===` で比較するためプリミティブ値のみ有効。
+                    *
+                    * `Value` からオブジェクト・配列を除いた型。
+                    */
+                   neq: Exclude<Value, Value[] | readonly Value[] | {
+                       [key: string]: Value;
+                   }>;
+                   /** `neq` と同時指定不可 */
+                   eq?: never;
+               };
+
+               /**
+                * デフォルトの履歴操作ボタン widget。
+                *
+                * @remarks
+                * カスタムシェル構築専用。
+                *
+                * `createHistoryWidget()` と等価。
+                */
+               export declare const historyWidget: WidgetDef;
+
+               /**
+                * ブロック内の水平配置。
+                */
+               declare enum HorizontalAlign {
+                   left = "left",
+                   center = "center",
+                   right = "right"
+               }
+
+               /**
+                * テキスト入力の HTML `input[type]` 属性値。バリデーション・キーボードの振る舞いに影響する。
+                */
+               declare enum InputType {
+                   text = "text",
+                   number = "number",
+                   email = "email",
+                   tel = "tel",
+                   url = "url",
+                   date = "date",
+                   password = "password"
+               }
+
+               /**
+                * `afterIdx` の直後に新しいページを挿入した新しい Book を返す。
+                */
+               export declare function insertPage(book: Book, afterIdx: number, page: Page): Book;
+
+               /**
+                * Book 形式かどうかを判定する（`pages` がトップレベル）。
+                */
+               export declare function isBook(data: unknown): boolean;
+
+               /**
+                * 旧 FormSchema 形式かどうかを判定する（`grid` + `blocks` がトップレベル、`pages` なし）。
+                */
+               export declare function isLegacyFormSchema(data: unknown): boolean;
+
+               /**
+                * 線のスタイル定義（色・幅・種別）。
+                */
+               export declare interface LineStyle {
+                   /** CSS カラー値 */
+                   color: string;
+                   /** 線の幅 */
+                   width: Dimension<BorderUnit>;
+                   /** 線の種別 */
+                   type: LineType;
+               }
+
+               /**
+                * 枠線・区切り線に適用するスタイル種別。
+                */
+               export declare enum LineType {
+                   /** 実線 */
+                   SOLID = "solid",
+                   /** 破線 */
+                   DASHED = "dashed",
+                   /** 点線 */
+                   DOTTED = "dotted"
+               }
+
+               /**
+                * 入力データの形式を自動判定し、適切な移行を実行する。
+                *
+                * - 旧 FormSchema（`grid` + `blocks` がトップレベル） → Book へ構造変換
+                * - Book（`pages` がトップレベル） → 各ページのデータを移行
+                *
+                * @throws {@link Error} 入力データがいずれの形式にも該当しない場合
+                    */
+                export declare function migrate(data: unknown, registry?: MigrationPluginRegistry): Book;
+
+                /**
+                 * Book の全ページをデータ移行する（形式 B）。
+                 *
+                 * @throws {@link Error} `notebook` がオブジェクトでない場合
+                     */
+                 export declare function migrateBook(notebook: unknown, registry?: MigrationPluginRegistry): Book;
+
+                 /**
+                  * 旧 FormSchema を Book 形式に構造変換する（形式 A）。
+                  *
+                  * @throws {@link Error} `schema` がオブジェクトでない場合
+                      */
+                  export declare function migrateFormSchemaToBook(schema: unknown, registry?: MigrationPluginRegistry): Book;
+
+                  /**
+                   * マイグレーション用のプラグインレジストリ型。
+                   *
+                   * 各プラグインは `migrateProps` を任意に実装でき、旧プロパティ形式を現形式に変換する契約を持つ。
+                   */
+                  export declare type MigrationPluginRegistry = Record<string, {
+                      migrateProps?: (props: unknown) => Record<string, unknown>;
+                  }>;
+
+                  /**
+                   * ページの順序を変えた新しい Book を返す。
+                   *
+                   * `from === to` の場合は no-op。
+                   */
+                  export declare function movePage(book: Book, from: number, to: number): Book;
+
+                  /**
+                   * `mode` prop で FORM / EDIT / VIEW を切り替えられる統一 Note コンポーネント。
+                   *
+                   * 内部で `NoteForm` / `NoteEdit` / `NoteView` への薄いラッパーとして機能する。
+                   * 印刷は `printNote(context)` で起動できる。
+                   */
+                  export declare function Note({ context, mode, className, style, showValidation, scale, }: NoteProps): JSX.Element;
+
+                  /**
+                   * ノートブロックの props 型。Book を内包して入れ子グリッドを実現する。
+                   *
+                   * @remarks
+                   * **Canvas** — 入れ子グリッド構築向けの型。
+                   *
+                   * 一般的なフォーム構築では直接参照することは少ない。
+                   */
+                  declare interface NoteBlockProps extends BaseBlockProps {
+                      /** ネストして表示する内包 Book。 */
+                      book: Book;
+                      /** 内包 Book で表示するページインデックス。省略時は 0。 */
+                      pageIdx?: number;
+                  }
+
+                  /**
+                   * `useNoteContext` が組み立てるコンテキストオブジェクト。
+                   *
+                   * Note / ActionBar / Sidebar / DefaultSelectionActionBarOverlay にそのまま渡して使用する。
+                   */
+                  export declare interface NoteContext {
+                      /** Book（用紙設定・ページを含む） */
+                      book: Book;
+                      /** Book 変更コールバック */
+                      onBookChange: OnBookChange;
+                      /** ブロックプラグインのレジストリ（`createPluginRegistry` で生成） */
+                      pluginRegistry: PluginRegistry;
+                      /** Note を包む `position: relative` なコンテナの ref */
+                      containerRef: RefObject<HTMLDivElement | null>;
+                      /** バインディングパス対応の値読み書きコンテキスト */
+                      bindingContext: BindingContext;
+                      /** ブロック挿入・移動・削除などのアクションハンドラコンテキスト */
+                      actionContext: ActionContext;
+                      /** 各ブロックの現在の入力値 */
+                      values: Record<string, Value>;
+                      /** 入力値が変更されたときのコールバック */
+                      onValuesChange?: OnValuesChange;
+                      /**
+                       * フルエディター用の UI 状態。
+                       * DefaultSelectionActionBarOverlay / getDefaultActionBarSections / getDefaultSidebarTabs
+                       * はこのフィールドを参照する。
+                       */
+                      editorState: EditorState;
+                  }
+
+                  /**
+                   * 値入力モード（EDIT モード）専用コンポーネント。
+                   *
+                   * ブロックの配置・サイズ変更は不可。直接 value を編集できる。
+                   * `useNoteContext` で生成した `context` を渡して使用する。
+                   *
+                   * @remarks 通常は {@link Note} を `mode={NoteMode.EDIT}` で使用する。
+                   */
+                  export declare const NoteEdit: NamedExoticComponent<NoteEditProps>;
+
+                  /**
+                   * {@link NoteEdit} の props。
+                   */
+                  export declare interface NoteEditProps {
+                      /** `useNoteContext` が返すコンテキスト。 */
+                      context: NoteContext;
+                      /** `true` のときバリデーションエラーを表示する（デフォルト: false）。 */
+                      showValidation?: boolean;
+                      /** 表示倍率（デフォルト: 1）。 */
+                      scale?: number;
+                      /** ルート要素に追加する className。 */
+                      className?: string;
+                  }
+
+                  /**
+                   * テンプレート作成モード（FORM モード）専用コンポーネント。
+                   *
+                   * ブロックの配置・サイズ変更が可能。ダブルクリックで initValue を編集できる。
+                   * `useNoteContext` で生成した `context` を渡す。ActionBar / Sidebar と組み合わせて使用する。
+                   *
+                   * @remarks 通常は {@link Note} を `mode={NoteMode.FORM}` で使用する。
+                   */
+                  export declare const NoteForm: default_2.NamedExoticComponent<NoteFormProps>;
+
+                  /**
+                   * {@link NoteForm} の props。
+                   *
+                   * テンプレートデザインモード専用。`context` は必須。
+                   * `useNoteContext` を使って context を生成し、ActionBar / Sidebar と共に使用する。
+                   */
+                  export declare interface NoteFormProps {
+                      /** `useNoteContext` が返すコンテキスト（必須）。 */
+                      context: NoteContext;
+                      /** 表示倍率（デフォルト: 1）。 */
+                      scale?: number;
+                      /** ルート要素に追加する className。 */
+                      className?: string;
+                  }
+
+                  /**
+                   * Note の表示・編集モード。
+                   */
+                  export declare enum NoteMode {
+                      /**
+                       * ブロックの配置・サイズ変更、グリッド設定、`initValue`（初期値）の設定が可能。
+                       *
+                       * 入力コントロールは動作するが、値はセッション内のみ保持される（永続化されない）。
+                       */
+                      FORM = "Form",
+                      /**
+                       * ブロックの値を入力・編集できる。
+                       *
+                       * レイアウトや `initValue` は変更不可。
+                       */
+                      EDIT = "Edit",
+                      /**
+                       * すべて読み取り専用。入力コントロールは無効。
+                       *
+                       * `showValidation` によるバリデーション結果の表示が有効。
+                       */
+                      VIEW = "View"
+                  }
+
+                  /**
+                   * `Note` コンポーネントの props。
+                   */
+                  export declare type NoteProps = NotePropsBase & {
+                      /** 表示モード。 */
+                      mode: NoteMode;
+                  };
+
+                  /* Excluded from this release type: NotePropsBase */
+
+                  /**
+                   * 閲覧モード（VIEW モード）専用コンポーネント。
+                   *
+                   * すべて読み取り専用。ブロックの配置変更・値の編集は不可。
+                   *
+                   * `context` は省略可能。省略した場合、`book` と `values` を渡すだけで静的表示できる。
+                   * `context` を渡した場合はバインディング・アクション・ページ選択が有効になる。
+                   *
+                   * @remarks 通常は {@link Note} を `mode={NoteMode.VIEW}` で使用する。
+                   */
+                  export declare const NoteView: NamedExoticComponent<NoteViewProps>;
+
+                  /**
+                   * {@link NoteView} の props。`context` か `book` のどちらか一方が必須。
+                   */
+                  export declare type NoteViewProps = NoteViewPropsWithContext | NoteViewPropsWithBook;
+
+                  /* Excluded from this release type: NoteViewPropsBase */
+
+                  /* Excluded from this release type: NoteViewPropsWithBook */
+
+                  /* Excluded from this release type: NoteViewPropsWithContext */
+
+                  /**
+                   * Book 全体の変更通知（ブロック・グリッド・用紙変更を一本で扱う）。
+                   *
+                   * @remarks
+                   * `options.mergeKey` を指定すると、同一キーの連続変更が履歴上でマージされる。
+                   * `options.noTimeWindow` を `true` にすると 500ms の時間窓制限なしにマージされる（セッション型用）。
+                   * ドラッグ中の連続更新やパネルのキー入力など、Undo を細分化したくない場面で使用する。
+                   */
+                  declare type OnBookChange = (book: Book, options?: {
+                      mergeKey?: string;
+                      noTimeWindow?: boolean;
+                  }) => void;
+
+                  /**
+                   * values の変更通知（EDIT モードでの入力値変更）。
+                   *
+                   * 差分リスト形式で渡される。1 ブロック編集 → 1 要素の配列。
+                   * `value` が `undefined` の場合はそのブロックの値を削除する。
+                   *
+                   * @example
+                   * ```tsx
+                   * onValuesChange={(changes) => {
+                   *     setValues(prev => {
+                   *         const next = { ...prev };
+                   *         for (const { id, value } of changes) {
+                   *             if (value === undefined) delete next[id];
+                   *             else next[id] = value;
+                   *         }
+                   *         return next;
+                   *     });
+                   * }}
+                   * ```
+                   */
+                  declare type OnValuesChange = (changes: ValueChange[]) => void;
+
+                  /**
+                   * パディングに使用できる単位の配列。
+                   */
+                  declare const PADDING_UNITS: readonly ["mm", "pt", "px", "%"];
+
+                  /**
+                   * ブロック内の上下左右の余白を保持する Props。
+                   */
+                  declare interface PaddingProps {
+                      top?: Dimension<PaddingUnit>;
+                      right?: Dimension<PaddingUnit>;
+                      bottom?: Dimension<PaddingUnit>;
+                      left?: Dimension<PaddingUnit>;
+                      /** 全辺一括モード。`true` のとき `all` が全辺に適用される */
+                      bulk?: boolean;
+                      /** 全辺共通パディング（`bulk: true` のとき有効） */
+                      all?: Dimension<PaddingUnit>;
+                  }
+
+                  /**
+                   * パディングに使用できる単位（`%` を含む）。
+                   */
+                  declare type PaddingUnit = (typeof PADDING_UNITS)[number];
+
+                  /**
+                   * 1ページ分のフォームスキーマ。
+                   */
+                  export declare interface Page {
+                      /** ページの一意 ID。保存済み Book に ID がない場合は {@link ensurePageIds} で付与できる */
+                      id?: string;
+                      /** グリッド設定（スパース形式）。全列・全行が 1fr の場合は colCount / rowCount のみ */
+                      grid: Grid;
+                      /** 配置されているブロック一覧 */
+                      blocks: Block[];
+                      /** ブロック種別ごとの共通デフォルト設定。値解決順序は `Block` の @remarks を参照 */
+                      blockDefaults?: BlockDefaults;
+                      /** ページ固有のメタデータ（バージョン・タイトルなど） */
+                      metaData?: Record<string, Value>;
+                  }
+
+                  /**
+                   * デフォルトのページナビゲーション widget（ページ数不明の初期状態）。
+                   *
+                   * @remarks
+                   * カスタムシェル構築専用。
+                   *
+                   * `createPageNavigationWidget({})` と等価。
+                   */
+                  export declare const pageNavigationWidget: WidgetDef;
+
+                  /**
+                   * ページに適用する用紙設定（サイズ・マージン・向き）。
+                   */
+                  export declare interface Paper {
+                      /** 用紙サイズ */
+                      size: PaperSize;
+                      /** 用紙マージン */
+                      margin: PaperMargin;
+                      /** 用紙の向き。true = 横向き (landscape)、省略/false = 縦向き (portrait) */
+                      orientation?: boolean;
+                      /**
+                       * 幅自動リサイズ。
+                       *
+                       * `true` のとき、`widthFit` ブロックの実測幅に合わせてキャンバス幅を広げる。
+                       */
+                      autoWidth?: boolean;
+                      /**
+                       * 高さ自動リサイズ。
+                       *
+                       * `true` のとき、`heightFit` ブロックの実測高さに合わせてキャンバス高さを広げる。
+                       */
+                      autoHeight?: boolean;
+                  }
+
+                  /**
+                   * 用紙サイズに使用できる単位の配列。
+                   */
+                  declare const PAPER_UNITS: readonly ["mm", "cm", "inch"];
+
+                  /**
+                   * 用紙四辺のマージン設定。
+                   */
+                  export declare interface PaperMargin {
+                      top: Dimension<PaperUnit>;
+                      right: Dimension<PaperUnit>;
+                      bottom: Dimension<PaperUnit>;
+                      left: Dimension<PaperUnit>;
+                      /**
+                       * 一括編集フラグ。`true` のとき、`all` フィールドが四辺の共通値として使われる。
+                       *
+                       * Book に保存されるため、通常の binding パス `margin.bulk` で読み書きできる。
+                       */
+                      bulk?: boolean;
+                      /**
+                       * 一括モード時の四辺共通マージン値。`bulk` が `true` のときのみ描画・印刷に使用される。
+                       *
+                       * binding パス `margin.all.value` / `margin.all.unit` で読み書きできる。
+                       */
+                      all?: Dimension<PaperUnit>;
+                  }
+
+                  /**
+                   * 用紙設定 compound widget。
+                   * @remarks
+                   * カスタムシェル構築専用。
+                   *
+                   * * 3 つの行 widget を NoteBlock として縦に並べた外偵コンテナ。
+                   *
+                   * - 行 0（常に表示）: PRESET_ORIENTATION_ROW
+                   * - 行 1（常に表示）: AUTO_RESIZE_ROW
+                   * - 行 2（Custom 選択時のみ）: DIMENSION_ROW  ← 末尾・hiddenBinding で縮小
+                   *
+                   * binding:
+                   * - `paper.size.preset` / `paper.orientation`
+                   * - `paper.autoWidth` / `paper.autoHeight`
+                   * - `paper.size.width.value` / `.unit` / `paper.size.height.value` / `.unit`
+                   */
+                  export declare const paperSettingsWidget: WidgetDef;
+
+                  /**
+                   * 用紙サイズ設定。
+                   *
+                   * @remarks
+                   * `preset` が `CUSTOM` 以外の場合も `width` / `height` には実寸が格納される。
+                   */
+                  export declare interface PaperSize {
+                      /** 選択中のプリセット */
+                      preset: PaperSizePreset;
+                      /** 幅（物理単位）。`CUSTOM` 時はユーザー指定値。 */
+                      width: Dimension<PaperUnit>;
+                      /** 高さ（物理単位）。`CUSTOM` 時はユーザー指定値。 */
+                      height: Dimension<PaperUnit>;
+                  }
+
+                  /**
+                   * 用紙サイズのプリセット種別。`CUSTOM` 選択時は `PaperSize.width` / `height` が有効になる。
+                   */
+                  export declare enum PaperSizePreset {
+                      A4 = "A4",
+                      B5 = "B5",
+                      A3 = "A3",
+                      LETTER = "Letter",
+                      LEGAL = "Legal",
+                      CUSTOM = "Custom"
+                  }
+
+                  /**
+                   * 用紙サイズに使用できる単位。
+                   */
+                  export declare type PaperUnit = (typeof PAPER_UNITS)[number];
+
+                  /**
+                   * 未検証の値を {@link Book} として検証する。
+                   *
+                   * @throws {@link Error} `pages` が存在しないまたは空、各ページの構造が不正、`paper` が存在しない場合
+                       */
+                   export declare function parseBook(value: unknown): Book;
+
+                   /**
+                    * ブロックのプレースホルダーテキストを保持する Props。
+                    */
+                   declare interface PlaceholderProps {
+                       /** 未入力時に表示するプレースホルダー文字列 */
+                       placeholder?: string;
+                   }
+
+                   /**
+                    * `createPluginRegistry` が返す、`block.kind` をキーにしたプラグインレジストリ。
+                    *
+                    * 未登録の `kind` は `undefined` になるため、アクセス前に存在確認が必要。
+                    */
+                   export declare type PluginRegistry = Record<string, ResolvedPlugin | undefined>;
+
+                   /**
+                    * 印刷時の余白設定。各辺に CSS の長さ値（例: `"10mm"`）を指定する。
+                    * 省略した辺はブラウザのデフォルト余白が適用される。
+                    */
+                   export declare interface PrintMargin {
+                       top?: string;
+                       right?: string;
+                       bottom?: string;
+                       left?: string;
+                   }
+
+                   /**
+                    * ブックの内容を印刷する。
+                    *
+                    * `useNoteContext` が返す `context` を渡すだけで、book・values・pluginRegistry を自動で解決して印刷する。
+                    *
+                    * @example
+                    * ```ts
+                    * // 印刷ボタンなどから直接呼ぶだけでよい
+                    * printNote(context);
+                    * ```
+                    */
+                   export declare function printNote(context: NoteContext, printSettings?: PrintSettings): void;
+
+                   /**
+                    * 印刷ダイアログへ渡す設定。
+                    *
+                    * @remarks
+                    * - 省略したフィールドはブラウザのデフォルト値に従う。
+                    * - `paperSize` に `"Custom"` は指定不可（型レベルで `Exclude` により除外済み）。
+                    */
+                   export declare interface PrintSettings {
+                       /** 印刷する用紙サイズ。省略時は `book.paper.size` を使用。 */
+                       paperSize?: Exclude<PaperSizePreset, "Custom">;
+                       /** 用紙の向き。true = 横向き (landscape)。省略時は `book.paper.orientation` を使用。 */
+                       orientation?: boolean;
+                       /** 印刷余白。省略時はブラウザのデフォルト余白。 */
+                       margin?: PrintMargin;
+                   }
+
+                   /**
+                    * coreのプロパティカタログに登録する1機能の定義。
+                    *
+                    * @remarks
+                    * `defaultProps` は `createPluginRegistry` でプラグイン単位に合成され、実際のブロック描画時は `PropDef.defaultProps` → `page.blockDefaults[kind]` → `block.props` の順でマージされる。
+                    *
+                    * 後段の値ほど優先される。
+                    */
+                   declare interface PropDef {
+                       /** プロパティの種別 ID。`BlockPlugin.properties` 内で一意になるよう設定する */
+                       kind: string;
+                       /** このプロパティを持つブロック種別のデフォルト props */
+                       defaultProps: Record<string, Value>;
+                       /**
+                        * カスタム編集UIコンポーネント（省略時はPropertyFieldのビルトインUIにフォールバック）。
+                        *
+                        * 外部プラグインは独自のエディタUIをここに渡すことができる。	 *	 * `PropertyComponentProps<Value>` を実装することで `readOnly` が正しく受け取れる。
+                        */
+                       component?: ComponentType<PropertyComponentProps<Value>>;
+                   }
+
+                   /**
+                    * UI コンポーネント（Checkbox, NumberInput 等）の共通 Props 基底型。
+                    */
+                   declare interface PropertyComponentProps<T> {
+                       /** このコンポーネントが編集対象とする現在の値 */
+                       value: T;
+                       /** 値が変更されたときに呼ばれるコールバック */
+                       onChange: (value: T) => void;
+                       /**
+                        * `true` のとき、ユーザーによる値変更を禁止する。
+                        *
+                        * カスタムコンポーネントを実装する際は必ずこのフラグを参照してインタラクションを無効化すること。
+                        */
+                       readOnly?: boolean;
+                   }
+
+                   /**
+                    * 指定インデックスのページを削除した新しい Book を返す。
+                    *
+                    * 1ページのみの場合は no-op。
+                    */
+                   export declare function removePage(book: Book, index: number): Book;
+
+                   /**
+                    * Renderer コンポーネントが受け取る props。
+                    */
+                   declare interface RendererProps<P = Record<string, Value>, V = Value> {
+                       /** ブロック ID */
+                       id: string;
+                       /** ブロックのプロパティ（プラグイン固有型） */
+                       props: P;
+                       /** ブロックの値 */
+                       value: V;
+                       /** 値の変更通知コールバック */
+                       onChange: (value: V) => void;
+                       /** フォーカス離脱時の値確定通知コールバック（オプション） */
+                       onBlur?: (value: V) => void;
+                       /**
+                        * 読み取り専用フラグ。
+                        *
+                        * `BlockContainer` が以下のロジックで計算して渡す。
+                        *
+                        * - EDIT モード: `block.behavior?.readOnly ?? false`
+                        *
+                        * - FORM / VIEW モード: 常に `true`
+                        */
+                       readOnly: boolean;
+                       /** Note のモード（`EDIT` / `VIEW` / `FORM`） */
+                       mode: NoteMode;
+                       /** ブロックの描画領域（px）。未設定時は auto として扱う */
+                       dimensions?: {
+                           widthPx: number;
+                           heightPx: number;
+                       };
+                       /**
+                        * ブロック幅の実測値（px）を通知するコールバック。
+                        *
+                        * `block.behavior.widthFit === true` のブロックに限り `BlockContainer` から渡される。
+                        */
+                       onMeasureWidth?: (widthPx: number) => void;
+                       /**
+                        * ブロック高さの実測値（px）を通知するコールバック。
+                        *
+                        * `block.behavior.heightFit === true` のブロックに限り `BlockContainer` から渡される。
+                        */
+                       onMeasureHeight?: (heightPx: number) => void;
+                       /** `BindingContext`（値の読み書きパス解決）。必要なブロックのみ参照する */
+                       bindingContext?: BindingContext;
+                       /** `ActionContext`（undo/redo 等のアクション実行）。必要なブロックのみ参照する */
+                       actionContext?: ActionContext;
+                       /** アクセシビリティラベル。`BlockRenderer` が `resolvedPlugin.meta.displayName` を自動セットする */
+                       ariaLabel?: string;
+                   }
+
+                   /**
+                    * ブロックの必須入力設定を保持する Props。
+                    */
+                   declare interface RequiredProps {
+                       /** `true` のとき、値が空の場合にバリデーションエラーとなる */
+                       required?: boolean;
+                   }
+
+                   /**
+                    * レジストリに登録された解決済みプラグイン。
+                    *
+                    * @remarks
+                    * BlockPlugin<P,V> のジェネリクスを型消去し、Shell/Canvas 層が any なしで扱えるフラットな構造にまとめたもの。
+                    *
+                    * Renderer の P/V variance 問題は BaseRenderer 型への単一キャストで解決。
+                    */
+                   declare interface ResolvedPlugin {
+                       /** `block.kind` と対応するプラグインの一意識別子 */
+                       kind: string;
+                       /** UI 表示・アイコン・デフォルトサイズ等のメタ情報 */
+                       meta: BlockPluginMeta;
+                       /** プロパティパネルに表示するプロパティ定義一覧 */
+                       properties: PropDef[];
+                       /** プラグインの全 `PropDef.defaultProps` を合成した、このブロック種別のデフォルト props */
+                       defaultProps: Record<string, Value>;
+                       /**
+                        * ブロックを描画する Renderer コンポーネント。
+                        *
+                        * BlockPlugin<P,V>.Renderer を格納する際、P/V の variance 問題を回避するためベース型にキャストしている。
+                        *
+                        * 実行時には block.props（解決済み）と value が渡されるため安全。
+                        */
+                       Renderer: BaseRenderer;
+                       /** 旧バージョンの props を現バージョンに変換する。`validateProps` の前に呼ばれる */
+                       migrateProps?: (props: unknown) => Record<string, unknown>;
+                       /**
+                        * ストレージから読み込んだ生の `block.props` をサニタイズして型安全な Props に変換する。
+                        *
+                        * 省略時は raw オブジェクトをそのまま使用する。
+                        */
+                       validateProps?: (props: unknown) => Record<string, Value>;
+                       /**
+                        * 外部 state から読み込んだ生の値をサニタイズする。
+                        *
+                        * `undefined` を返した場合は `block.initValue`、それもなければ raw 値にフォールバックする。
+                        *
+                        * フォールバックを指示する場合にのみ `undefined` を使い、`null` は正当な値として返せる。
+                        *
+                        * 省略時は raw 値をそのまま使用する。
+                        */
+                       validateValue?: (value: unknown, props: Record<string, Value>) => Value | undefined;
+                   }
+
+                   /**
+                    * セレクトボックスブロックの props 型。
+                    */
+                   declare type SelectBlockProps = BaseBlockProps & FontStyleProps & PlaceholderProps & RequiredProps & SelectConfigProps;
+
+                   /**
+                    * セレクトボックスブロックの値型。`null` は未選択状態を表す。
+                    */
+                   declare type SelectBlockValue = string | null;
+
+                   /**
+                    * セレクトボックスの選択肢設定 props。
+                    */
+                   declare interface SelectConfigProps {
+                       /** 選択肢と機能設定。 */
+                       selectConfig: SelectOptionsConfig;
+                   }
+
+                   /**
+                    * デフォルトの選択操作・削除ボタン widget。
+                    *
+                    * @remarks
+                    * カスタムシェル構築専用。
+                    *
+                    * `createSelectionDeleteWidget()` と等価。
+                    */
+                   export declare const selectionDeleteWidget: WidgetDef;
+
+                   /**
+                    * セレクトボックスの個々の選択肢。
+                    */
+                   declare interface SelectOption {
+                       /** ユーザーに表示するラベル。 */
+                       label: string;
+                       /** 選択時にブロック値として記録される内部値。 */
+                       value: string;
+                       /** ラベルに適用する文字色（任意）。 */
+                       color?: string;
+                   }
+
+                   /**
+                    * セレクトボックスの選択肢一覧と機能設定。
+                    */
+                   declare interface SelectOptionsConfig {
+                       /** 選択肢の配列。 */
+                       options: SelectOption[];
+                       /** `true` のとき空白選択（未選択）を許可する。 */
+                       allowEmpty?: boolean;
+                   }
+
+                   /**
+                    * セレクトボックスブロックのプラグイン定義。
+                    *
+                    * `kind: "select"` で登録され、選択肢設定・必須入力・フォントなどの prop まとまりを提供する。
+                    */
+                   export declare const SelectPlugin: BlockPlugin<SelectBlockProps, SelectBlockValue>;
+
+                   /**
+                    * JSON シリアライズ可能なプロパティのみを持つオブジェクト型の境界。
+                    *
+                    * `BlockPlugin<P>` / `Block<P>` の型引数制約として使用し、`P` に関数・クラスインスタンス・DOM 要素など非 serializable な型が混入した場合に型エラーとして検出する。
+                    *
+                    * オプショナルフィールド（`?`）は `undefined` を許容するため `Value | undefined` としている。
+                    */
+                   declare type SerializableRecord = Record<string, Value | undefined>;
+
+                   /**
+                    * {@link Book} を JSON 文字列にシリアライズする。
+                    */
+                   export declare function serializeBook(book: Book): string;
+
+                   /**
+                    * {@link Page} を JSON 文字列にシリアライズする。
+                    */
+                   export declare function serializePage(page: Page): string;
+
+                   /**
+                    * 指定インデックスのページを置き換えた新しい Book を返す。
+                    */
+                   export declare function setPage(book: Book, pageIdx: number, page: Page): Book;
+
+                   /**
+                    * サイドバーコンポーネント。
+                    *
+                    * @remarks
+                    * **Shell** — タブシェルのみを提供する純粹なコンテナ。
+                    *
+                    * タブの内容は `getDefaultSidebarTabs()` で生成してください。
+                    */
+                   export declare const Sidebar: {
+                       ({ tabs, defaultTab, className }: SidebarProps): JSX.Element;
+                       displayName: string;
+                   };
+
+                   /**
+                    * サイドバーコンポーネントへの props。
+                    */
+                   export declare interface SidebarProps {
+                       /** タブ定義（必須） */
+                       tabs: SidebarTab[];
+                       /** デフォルトで選択されるタブの value。未指定時は最初のタブ */
+                       defaultTab?: string;
+                       /** カスタムクラス名 */
+                       className?: string;
+                   }
+
+                   /**
+                    * サイドバーのタブ定義オブジェクト。
+                    */
+                   export declare interface SidebarTab {
+                       /** タブの value（一意な文字列） */
+                       value: string;
+                       /** タブヘッダーに表示するラベル */
+                       label: ReactNode;
+                       /** タブのコンテンツ */
+                       content: ReactNode;
+                   }
+
+                   /**
+                    * テキスト入力の改行・折り返し・行間隔などのレイアウト挙動 props。
+                    */
+                   declare interface TextBehaviorProps {
+                       /** 行間隔（CSS `line-height` 相当）。デフォルト: 1.2。 */
+                       lineHeight?: number;
+                       /** `true` のとき複数行入力を許可する。デフォルト: true。 */
+                       multiline?: boolean;
+                       /** 折り返しの振る舞い（CSS `overflow-wrap` 相当）。 */
+                       wordWrap?: WordWrap;
+                       /** スペース・改行のレンダリング模式（CSS `white-space` 相当）。 */
+                       whiteSpace?: WhiteSpace;
+                   }
+
+                   /**
+                    * テキストブロックの props 型。
+                    *
+                    * フォント・文字幅返・入力バリデーション・プレースホルダーなどの属性群の共和型。
+                    */
+                   declare type TextBlockProps = BaseBlockProps & FontStyleProps & PlaceholderProps & RequiredProps & TextBehaviorProps & TextValidationProps;
+
+                   /**
+                    * テキストブロックの値型。`null` は未入力状態を表す。
+                    */
+                   declare type TextBlockValue = string | null;
+
+                   /**
+                    * テキスト入力ブロックのプラグイン定義。
+                    *
+                    * `kind: "text"` で登録され、フォント・バリデーション・改行・必須入力などの prop まとまりを提供する。
+                    */
+                   export declare const TextPlugin: BlockPlugin<TextBlockProps, TextBlockValue>;
+
+                   /**
+                    * テキスト入力の入力タイプ・数値範囲・文字数・パターンなどのバリデーション props。
+                    */
+                   declare interface TextValidationProps {
+                       /** 入力タイプ（`<input type>` 属性）。デフォルト: `text`。 */
+                       inputType?: InputType;
+                       /** 数値入力の最小値。 */
+                       min?: number;
+                       /** 数値入力の最大値。 */
+                       max?: number;
+                       /** 数値入力のステップ幅。 */
+                       step?: number;
+                       /** 最小文字数。 */
+                       minLength?: number;
+                       /** 最大文字数。 */
+                       maxLength?: number;
+                       /** 入力値を検証する正規表現パターン。 */
+                       pattern?: string;
+                   }
+
+                   /**
+                    * このパッケージで使用できる全単位。
+                    */
+                   export declare type Unit = (typeof ALL_UNITS)[number];
+
+                   /**
+                    * フルエディター（ActionBar + Note + SelectionActionBarOverlay + Sidebar）向けの Context 統合フック。
+                    *
+                    * `useBookHistory` / `useEditorState` / `useBookBindingContext` / `useBookActionContext`
+                    * を組み合わせ、配線済みの `NoteContext` を返す。
+                    *
+                    * @example
+                    * ```tsx
+                    * const { context } = useNoteContext({ initialBook, pluginRegistry });
+                    * const [mode, setMode] = useState<NoteMode>(NoteMode.FORM);
+                    *
+                    * <ActionBar sections={getDefaultActionBarSections({ context })} />
+                    * <div ref={context.containerRef} style={{ position: "relative" }}>
+                    *   <Note mode={mode} context={context} />
+                    *   <DefaultSelectionActionBarOverlay context={context} />
+                    * </div>
+                    * <Sidebar tabs={getDefaultSidebarTabs({ context })} />
+                    * ```
+                    */
+                   export declare function useNoteContext({ initialBook, pluginRegistry, defaultValues, extra, }: UseNoteContextOptions): UseNoteContextResult;
+
+                   /**
+                    * {@link useNoteContext} のオプション。
+                    */
+                   export declare interface UseNoteContextOptions {
+                       /**
+                        * 初期ブックデータ。
+                        *
+                        * **マウント時のみ参照される**（React の `useState` 初期値と同じ挙動）。
+                        * マウント後に値を変えても内部状態には反映されない。
+                        *
+                        * そのため、非同期ロード後にデータを渡す場合は、
+                        * **ロード完了後にコンポーネントをマウントする**こと。
+                        *
+                        * @example
+                        * ```tsx
+                        * // ✅ ロード完了後にマウント
+                        * if (!templateData) return <Loading />;
+                        * return <MyEditor initialBook={templateData} />;
+                        *
+                        * // ✅ ドキュメント切り替え時は key でリマウント
+                        * return <MyEditor key={documentId} initialBook={loadedBook} />;
+                        * ```
+                        */
+                       initialBook: Book;
+                       /** ブロックプラグインのレジストリ（`createPluginRegistry` で生成） */
+                       pluginRegistry: PluginRegistry;
+                       /**
+                        * 各ブロックの初期入力値（省略可）。
+                        *
+                        * **マウント時のみ参照される**（React の `useState` 初期値と同じ挙動）。
+                        * マウント後に値が変わっても内部状態には反映されない。
+                        *
+                        * そのため、非同期ロード後にデータを渡す場合は、
+                        * **ロード完了後にコンポーネントをマウントする**こと。
+                        *
+                        * @example
+                        * ```tsx
+                        * // ❌ ダメな例 — フェッチ中は undefined、完了後に変わっても無視される
+                        * const { data: savedValues } = useFetch("/api/answers");
+                        * const { context } = useNoteContext({ initialBook, pluginRegistry, defaultValues: savedValues });
+                        *
+                        * // ✅ ロード完了後にマウント
+                        * const { data: savedValues } = useFetch("/api/answers");
+                        * if (!savedValues) return <Loading />;
+                        * return <MyEditor defaultValues={savedValues} />;
+                        * ```
+                        */
+                       defaultValues?: Record<string, Value>;
+                       /**
+                        * ユーザー定義の追加 BindingContext。
+                        * 組み込みパスより優先して参照される。
+                        * 詳細は {@link BookBindingContextOptions.extra} を参照。
+                        */
+                       extra?: BindingContext;
+                   }
+
+                   /**
+                    * {@link useNoteContext} の戻り値。
+                    */
+                   export declare interface UseNoteContextResult {
+                       /** Note / ActionBar / Sidebar / DefaultSelectionActionBarOverlay に渡す context */
+                       context: NoteContext;
+                   }
+
+                   /**
+                    * Book 全体の blockId 重複・ページごとのブロック数上限を検証する。
+                    *
+                    * 問題があれば `ValidationError[]` を返す。空配列は valid。
+                    */
+                   export declare function validateBook(book: Book): ValidationError[];
+
+                   /**
+                    * バリデーション結果の1件分。プラグインのバリデーター関数が返す配列の要素型。
+                    *
+                    * @remarks
+                    * `useNoteLayout` が `Record<blockId, ValidationError[]>` として管理する。
+                    */
+                   export declare interface ValidationError {
+                       /** ユーザーに表示するエラーメッセージ */
+                       message: string;
+                       /** エラー種別を識別するコード（例: `"required"`, `"min_length"`） */
+                       code: string;
+                       /** エラーに関連するフィールド名。ブロック内の特定フィールドを示す場合に使用。 */
+                       field?: string;
+                       /** 重大度レベル */
+                       severity: ValidationSeverity;
+                       /** プラグインが付加する任意のメタデータ */
+                       metadata?: Record<string, Value>;
+                   }
+
+                   /**
+                    * バリデーション結果の重大度レベル。
+                    */
+                   export declare enum ValidationSeverity {
+                       /** 修正が必要なエラー */
+                       ERROR = "error",
+                       /** 推奨される修正があるが続行可能な警告 */
+                       WARNING = "warning",
+                       /** 参考情報 */
+                       INFO = "info"
+                   }
+
+                   /**
+                    * このパッケージで扱う値の型。JSON シリアライズ可能な値のみを表す再帰型。
+                    *
+                    * ブロックの入力値・バインディング値・スキーマのデフォルト値などに共通して使用される。
+                    */
+                   export declare type Value = string | number | boolean | null | Value[] | readonly Value[] | {
+                       [key: string]: Value;
+                   };
+
+                   /**
+                    * 1 件の値変更を表す。
+                    *
+                    * @remarks
+                    * `value` が `undefined` の場合はそのブロックの値を削除する。
+                    */
+                   declare type ValueChange = {
+                       id: string;
+                       value: Value | undefined;
+                   };
+
+                   /**
+                    * ブロック内の垂直配置。
+                    */
+                   declare enum VerticalAlign {
+                       top = "top",
+                       center = "center",
+                       bottom = "bottom"
+                   }
+
+                   /**
+                    * テキストの改行・スペースのレンダリング模式（CSS `white-space` 相当）。
+                    */
+                   declare enum WhiteSpace {
+                       normal = "normal",
+                       nowrap = "nowrap",
+                       pre = "pre",
+                       preWrap = "pre-wrap",
+                       preLine = "pre-line"
+                   }
+
+                   /**
+                    * ウィジェット定義。NoteBlockProps と必要プラグインを一体化した型。
+                    *
+                    * @remarks
+                    * {@link FloatingWidget} に渡すことで、`pluginRegistry` を別途用意する必要がなくなる。
+                    *
+                    * `plugins` には、このウィジェットを描画するために必要なプラグインをすべて列挙する。
+                    *
+                    * `FloatingWidget` はこれを元に内部で `PluginRegistry` を構築する。
+                    */
+                   export declare interface WidgetDef {
+                       /** Widget として表示する NoteBlock の初期データ */
+                       props: NoteBlockProps;
+                       /** このウィジェットを描画するために必要なプラグイン */
+                       plugins: readonly AnyBlockPlugin[];
+                   }
+
+                   /**
+                    * テキストの折り返し・改行插入の振る舞い。
+                    */
+                   declare enum WordWrap {
+                       normal = "normal",
+                       breakWord = "break-word",
+                       breakAll = "break-all"
+                   }
+
+                   export { }