@tatamicks/core 0.3.2 → 1.0.1

package/dist/src/shell.d.ts

@@ -0,0 +1,1982 @@
+/**
+ * @tatamicks/core/shell - シェルサブパスエントリポイント
+ *
+ * カスタマイズ向けの Advanced API。
+ *
+ * ActionBar / Sidebar / DefaultSelectionActionBarOverlay / FloatingWidget は {@link @tatamicks/core} メインエントリのみで提供（このサブパスには含まれない）。
+ *
+ * @remarks Advanced — 個別パネル・ UI プリミティブ・選択 UI カスタムなど、細かくカスタマイズしたい場合に使用する。
+ *
+ * Breaking changes が生じる可能性がある。
+ *
+ * @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 { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+import { RefObject } from 'react';
+
+/**
+ * `ActionBar` 内のセクション間区切り線コンポーネント。
+ *
+ * @remarks
+ * **Shell** — `ActionBar` により自動挿入される。通常は直接使用しない。
+ */
+export declare const ActionBarDivider: {
+    (_props: ActionBarDividerProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `ActionBar` 内のセクション間区切り線コンポーネントへの props。
+ */
+export declare type ActionBarDividerProps = Record<string, never>;
+
+/**
+ * 登録済みアクションの実行および有効判定インターフェース。
+ *
+ * @remarks
+ * button ブロックのクリック時に呼び出される。
+ */
+declare interface ActionContext {
+    /** 指定 ID のアクションを実行する。 */
+    execute(actionId: BuiltinActionId | (string & {}), payload?: unknown): void;
+    /** 指定 ID のアクションが実行可能か返す。 */
+    isEnabled(actionId: BuiltinActionId | (string & {})): boolean;
+}
+
+/**
+ * アクション実行後にトースト通知で表示するフィードバック情報。
+ *
+ * @remarks
+ * `ActionBar` / `CanvasActionSection` に渡す `onActionFeedback` の引数型。
+ */
+declare interface ActionFeedback {
+    /** アクションの識別子 */
+    actionId: string;
+    /** トースト通知に表示するメッセージ */
+    message: string;
+    /** ショートカットキーの表示文字列（なしの場合は `null`） */
+    shortcut: string | null;
+}
+
+/**
+ * 全単位の配列。
+ */
+declare const ALL_UNITS: readonly ["mm", "cm", "fr", "inch", "pt", "px", "%"];
+
+/**
+ * ブロックの背景色と枠線を設定するパネル。
+ *
+ * @remarks
+ * **Shell** — タブ切り替えで背景色と枠線を個別に設定できる。
+ */
+export declare const BackgroundBorderPanel: default_2.FC<BackgroundBorderPanelProps>;
+
+/**
+ * `BackgroundBorderPanel` コンポーネントへの props。
+ */
+export declare interface BackgroundBorderPanelProps {
+    /** 選択中のブロックの配列 */
+    selectedBlocks: Block[];
+    /** ブロック更新時のコールバック */
+    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
+}
+
+declare type BaseRenderer = ForwardRefExoticComponent<RendererProps<Record<string, Value>, Value> & RefAttributes<BlockRef>>;
+
+/**
+ * binding パスによる設定値の読み書きインターフェース。
+ *
+ * @remarks
+ * `HiddenBinding` の評価および button ブロックのアクション判定に使用される。
+ */
+declare interface BindingContext {
+    /**
+     * 指定パスの値を取得する。
+     *
+     * - パスが存在し値が `null` の場合: `null` を返す。
+     * - パスの値が未設定（未登録）の場合: `undefined` を返す。
+     *
+     * `extra` として渡す実装では、担当外のパスに対して `undefined` を返すことで
+     * 組み込みの BindingContext へのフォールバックを指示できる。
+     * 有効値として `null` を返す場合はフォールバックしない。
+     */
+    get(path: string): Value | undefined;
+    /** 指定パスに値を書き込む。 */
+    set(path: string, value: Value): void;
+}
+
+/**
+ * book 内のブロックを表すインターフェース。
+ *
+ * @remarks
+ * - `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` を使用すること。
+ */
+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;
+}
+
+/**
+ * ブロックの動作設定。
+ *
+ * @remarks
+ * キーが存在する（`true`）場合に有効、`undefined` の場合は無効として扱う。
+ */
+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" },
+ * };
+ * ```
+ */
+declare type BlockDefaults = Record<string, Record<string, Value>>;
+
+/**
+ * ブロック種類ごとのデフォルトプロパティ設定パネル。
+ *
+ * @remarks
+ * **Shell** — `DefaultCanvasPanel` 内で使用される。
+ */
+export declare const BlockDefaultsPanel: MemoExoticComponent<({ blockDefaults, pluginRegistry, onChange }: BlockDefaultsPanelProps) => JSX.Element>;
+
+/**
+ * `BlockDefaultsPanel` コンポーネントへの props。
+ */
+export declare interface BlockDefaultsPanelProps {
+    /** 現在のブロックデフォルト設定 */
+    blockDefaults: BlockDefaults;
+    /** プラグインレジストリ（全プラグイン情報） */
+    pluginRegistry: PluginRegistry;
+    /** デフォルト値変更時のコールバック */
+    onChange: (newBlockDefaults: BlockDefaults) => void;
+}
+
+/**
+ * ブロックの配列順序を変更するパネル。UI では上が最前面、下が最背面。
+ *
+ * @remarks
+ * **Shell** — 内部配列では最後が最前面。
+ */
+export declare const BlockOrderPanel: {
+    ({ blocks, onBlocksChange, selectedBlockIds, onBlockHover, onBlockDragChange, }: BlockOrderPanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `BlockOrderPanel` コンポーネントへの props。
+ */
+export declare interface BlockOrderPanelProps {
+    /** ブロック一覧 */
+    blocks: Block[];
+    /** ブロック更新時のコールバック (blocks 配列全体を更新) */
+    onBlocksChange: (blocks: Block[]) => void;
+    /** 選択中のブロック ID 一覧 */
+    selectedBlockIds?: string[];
+    /** ホバー時のコールバック（キャンバス上でのホバーハイライト用。ドラッグ選択とは別） */
+    onBlockHover?: (id: string | null) => void;
+    /** ドラッグ中のブロック ID 通知（キャンバス上にソリッド枠を表示するために使用） */
+    onBlockDragChange?: (id: string | null) => void;
+}
+
+/**
+ * pluginのメタ情報（UI表示・アイコン・デフォルトサイズ）。
+ */
+declare interface BlockPluginMeta {
+    /** UIに表示されるブロック名 */
+    displayName: string;
+    /** ブロックの説明文 */
+    description?: string;
+    /** ブロックのグリッド上のデフォルトサイズ */
+    defaultSize?: BlockSize;
+    /** ブロック選択パネルなどで使用するアイコンコンポーネント */
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+}
+
+/**
+ * ブロックのグリッド上座標。
+ */
+declare interface BlockPos {
+    /** グリッド列の開始位置 (0-based) */
+    x: number;
+    /** グリッド行の開始位置 (0-based) */
+    y: number;
+}
+
+/**
+ * ブロックプロパティパネルの純粹なコンテナ。レイアウトシェルのみを提供する。
+ *
+ * @remarks
+ * **Shell** — ビジネスロジックを含む実装は `DefaultBlockPropertyPanel` を使用してください。
+ */
+export declare const BlockPropertyPanel: {
+    ({ children, className, }: BlockPropertyPanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `BlockPropertyPanel` コンポーネントへの props。
+ */
+export declare interface BlockPropertyPanelProps {
+    /** パネルのコンテンツ */
+    children?: ReactNode;
+    /** カスタムクラス名 */
+    className?: string;
+}
+
+/**
+ * ブロックのグリッド上の位置とサイズを合わせた矩形領域。
+ */
+declare interface BlockRect extends BlockPos, BlockSize {
+}
+
+declare interface BlockRectPx {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+
+/**
+ * Rendererが forwardRef で外部に公開するインターフェース。
+ */
+declare interface BlockRef {
+    focus: () => void;
+}
+
+/**
+ * ブロックのグリッド上サイズ。
+ */
+declare interface BlockSize {
+    /** 列方向の幅（列数） */
+    w: number;
+    /** 行方向の高さ（行数） */
+    h: number;
+}
+
+/**
+ * ブロックのスタイル定義。
+ */
+declare interface BlockStyle {
+    /** 背景色 (CSS color 値) */
+    backgroundColor?: string;
+    /** 枠線スタイル */
+    border?: BorderStyle;
+}
+
+/**
+ * 複数ページのフォームを表すスキーマ（Book）。
+ *
+ * @remarks
+ * - `pages` は最低1ページ必須（タプル型で空配列を禁止）
+ * - `Page.id` はオプション。index による識別がベースだが、並び替え・外部同期には `id` を利用する
+ * - `block.id` はブック全体でユニークであること
+ * - `paper` はブック全体で共通（全ページ同一の用紙設定を維持する）
+ */
+declare interface Book {
+    /** ブック全体の用紙設定。全ページ共通（PDF の慣習に従いページごとの変更は不可） */
+    paper: Paper;
+    /** ページ一覧（0-based インデックス順） */
+    pages: [Page, ...Page[]];
+    /** ブックレベルのメタデータ。例: `{ title: "月次業務報告書", version: "2" }` */
+    metaData?: Record<string, Value>;
+}
+
+/**
+ * 枠線の幅に使用できる単位の配列。
+ */
+declare const BORDER_UNITS: readonly ["px", "pt", "mm"];
+
+/**
+ * 四辺それぞれの枠線スタイル定義。省略した辺は枠線なし。
+ *
+ * `all` を指定した場合、各辺に個別指定がなければ `all` の値が全辺に適用される。
+ */
+declare interface BorderStyle {
+    top?: LineStyle;
+    right?: LineStyle;
+    bottom?: LineStyle;
+    left?: LineStyle;
+    /** 全辺共通スタイル。各辺に個別指定がない場合のフォールバック */
+    all?: LineStyle;
+}
+
+/**
+ * 枠線の幅に使用できる単位。
+ */
+declare type BorderUnit = (typeof BORDER_UNITS)[number];
+
+/**
+ * 組み込みアクション ID のユニオン型。
+ *
+ * `ActionContext.execute` / `ActionContext.isEnabled` の引数に指定したとき IDE の補完候補として表示される。
+ * カスタムアクション ID は任意の `string` として渡せる。
+ */
+declare type BuiltinActionId = "undo" | "redo" | "paste" | "delete" | "copy" | "duplicate" | "addPage" | "deletePage" | "selectBlocks" | "goToPage" | "updateBlocks";
+
+/**
+ * `CanvasPanel` 最上部に表示するアクションボタン行。
+ *
+ * @remarks
+ * **Shell** — Undo/Redo/Delete/Copy/Paste/Duplicate ボタンを提供する。
+ */
+export declare const CanvasActionPanel: {
+    ({ context, onActionFeedback, }: CanvasActionPanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `CanvasActionPanel` コンポーネントへの props。
+ */
+export declare interface CanvasActionPanelProps {
+    /** NoteContext（`useNoteContext` が返すコンテキスト） */
+    context: NoteContext;
+    /** アクション実行時のフィードバック（トースト表示など） */
+    onActionFeedback?: (feedback: ActionFeedback) => void;
+}
+
+/**
+ * `ActionBar` に表示する Undo/Redo/Paste ボタン群コンポーネント。
+ *
+ * @remarks
+ * **Shell** — 選択依存のアクション（Delete/Copy/Duplicate）は `SelectionActionBar` 側で担う。
+ */
+export declare const CanvasActionSection: {
+    ({ actionContext, onActionFeedback, onPrint, }: CanvasActionSectionProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `CanvasActionSection` コンポーネントへの props。
+ */
+export declare interface CanvasActionSectionProps {
+    /** アクション実行コンテキスト */
+    actionContext: ActionContext;
+    /** アクション実行時のフィードバック（トースト表示など） */
+    onActionFeedback?: (feedback: ActionFeedback) => void;
+    /** 印刷ボタン押下時のコールバック。省略時は `window.print()` を呼び出す */
+    onPrint?: () => void;
+}
+
+/**
+ * キャンバス設定パネルの純粹なコンテナ。`TabPanel` ラッパーのみを提供する。
+ *
+ * @remarks
+ * **Shell** — ビジネスロジックを含む実装は `DefaultCanvasPanel` を使用してください。
+ */
+export declare const CanvasPanel: {
+    ({ children, className }: CanvasPanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `CanvasPanel` コンポーネントへの props。
+ */
+declare interface CanvasPanelProps {
+    /** パネルのコンテンツ */
+    children?: ReactNode;
+    /** カスタムクラス名 */
+    className?: string;
+}
+
+/**
+ * チェックボックス入力コンポーネント。
+ *
+ * @remarks
+ * **Shell** — プラグインプロパティの編集 UI として使用する。
+ */
+export declare const Checkbox: {
+    ({ value, onChange, readOnly, label: propLabel, config, }: CheckboxProps): default_2.ReactElement;
+    displayName: string;
+};
+
+/**
+ * チェックボックス入力の設定オブジェクト。
+ *
+ * @remarks
+ * **Shell** — `CheckboxProps.config` に渡す設定値の型。
+ */
+export declare interface CheckboxConfig {
+    /** チェックボックスのラベルテキスト */
+    label?: string;
+    [key: string]: Value | undefined;
+}
+
+/**
+ * チェックボックス入力コンポーネントへの props。
+ */
+export declare interface CheckboxProps extends PropertyComponentProps<boolean | undefined> {
+    /** チェックボックスのラベルテキスト */
+    label?: string;
+    /** `label` 等をまとめた設定オブジェクト。フィールドより優先度が低い */
+    config?: CheckboxConfig;
+}
+
+/**
+ * 折りたたみ可能なセクションコンポーネント。
+ *
+ * @remarks
+ * **Shell** — プロパティパネル等のセクション区切り UI として使用する。
+ */
+export declare const CollapsibleSection: {
+    ({ title, children, collapsible, defaultCollapsed, isOpen: isOpenProp, onOpenChange, description, actions, openLabel, closeLabel, noPadding, }: CollapsibleSectionProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * 折りたたみ可能なセクションコンポーネントへの props。
+ */
+export declare interface CollapsibleSectionProps {
+    /** セクションのタイトル */
+    title: string;
+    /** 子要素（コンテンツ） */
+    children: ReactNode;
+    /** 折りたたみ可能にするかどうか（デフォルト: false = 常時展開） */
+    collapsible?: boolean;
+    /** 初期状態で折りたたむかどうか（collapsible が true のときのみ有効、デフォルト: true） */
+    defaultCollapsed?: boolean;
+    /**
+     * 開閉状態の外部制御（指定時は内部状態を使わず isOpen に従う）。
+     * collapsible=true のときのみ有効。
+     */
+    isOpen?: boolean;
+    /** 外部制御時の開閉変更コールバック */
+    onOpenChange?: (open: boolean) => void;
+    /** タイトル直右に表示する info アイコンのツールチップ説明文 */
+    description?: string;
+    /** ヘッダー右側に配置するアクション要素 */
+    actions?: ReactNode;
+    /** 開いているときに表示するラベル（例: "カスタム"） */
+    openLabel?: string;
+    /** 閉じているときに表示するラベル（例: "標準"） */
+    closeLabel?: string;
+    /** コンテンツ領域のパディングを除去する */
+    noPadding?: boolean;
+}
+
+/**
+ * カラーピッカーコンポーネント。
+ *
+ * @remarks
+ * **Shell** — プラグインプロパティの編集 UI として使用する。
+ */
+export declare const ColorPicker: {
+    ({ value, onChange, readOnly, showTextInput, allowUndefined: propAllowUndefined, placeholder: propPlaceholder, width: propWidth, height: propHeight, config, }: ColorPickerProps): default_2.ReactElement;
+    displayName: string;
+};
+
+/**
+ * カラーピッカーの設定オブジェクト。
+ *
+ * @remarks
+ * **Shell** — `ColorPickerProps.config` に渡す設定値の型。
+ */
+declare interface ColorPickerConfig {
+    /** `true` のとき未設定（`undefined`）を許容する */
+    allowUndefined?: boolean;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    [key: string]: Value | undefined;
+}
+
+/**
+ * カラーピッカーコンポーネントへの props。
+ */
+export declare interface ColorPickerProps extends PropertyComponentProps<string | undefined> {
+    /** カラーテキスト入力を表示するか */
+    showTextInput?: boolean;
+    /** undefined（未設定）を許容するか */
+    allowUndefined?: boolean;
+    /** プレースホルダーテキスト */
+    placeholder?: string;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    /** 設定オブジェクト */
+    config?: ColorPickerConfig;
+}
+
+/**
+ * 選択ブロックのプロパティを編集するコンポーネントのデフォルト実装。
+ *
+ * @remarks
+ * **Shell** — レイアウト・背景・枠線・メタ情報・プラグインプロパティパネルを内包する。
+ */
+export declare const DefaultBlockPropertyPanel: MemoExoticComponent<({ context, gridSize, className }: DefaultBlockPropertyPanelProps) => JSX.Element>;
+
+/**
+ * `DefaultBlockPropertyPanel` コンポーネントへの props。
+ */
+export declare interface DefaultBlockPropertyPanelProps {
+    /** NoteContext（`useNoteContext` が返すコンテキスト） */
+    context: NoteContext;
+    /** グリッドサイズ（レイアウトパネルに渡す） */
+    gridSize?: {
+        cols: number;
+        rows: number;
+    };
+    /** カスタムクラス名 */
+    className?: string;
+}
+
+/**
+ * キャンバス設定統合パネルのデフォルト実装。
+ *
+ * @remarks
+ * **Shell** — 内部に CanvasActionPanel, PaperSizePanel, MarginPanel, GridSizePanel, BlockDefaultsPanel, BlockOrderPanel を含む。
+ */
+export declare const DefaultCanvasPanel: {
+    ({ context, onBlockHover, onBlockDragChange, onActionFeedback, }: DefaultCanvasPanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `DefaultCanvasPanel` コンポーネントへの props。
+ */
+export declare interface DefaultCanvasPanelProps {
+    /** NoteContext（`useNoteContext` が返すコンテキスト） */
+    context: NoteContext;
+    /** ホバー中のブロック ID 通知 */
+    onBlockHover?: (id: string | null) => void;
+    /** ドラッグ中のブロック ID 通知 */
+    onBlockDragChange?: (id: string | null) => void;
+    /** アクション実行時のフィードバック（トースト表示など） */
+    onActionFeedback?: (feedback: ActionFeedback) => void;
+}
+
+/**
+ * 数値と単位の組み合わせ。
+ */
+declare interface Dimension<U extends Unit = Unit> {
+    /** 数値 */
+    value: number;
+    /** 単位 */
+    unit: U;
+}
+
+/**
+ * `Dimension`（値＋単位）入力コンポーネント。
+ *
+ * @remarks
+ * **Shell** — プラグインプロパティの編集 UI として使用する。
+ */
+export declare const DimensionInput: <U extends Unit>(props: DimensionInputProps<U>) => default_2.ReactElement;
+
+/**
+ * `Dimension`（値＋単位）入力の設定オブジェクト。
+ *
+ * @remarks
+ * **Shell** — `DimensionInputProps.config` に渡す設定値の型。
+ */
+export declare interface DimensionInputConfig<U extends Unit> {
+    /** 選択可能な単位の一覧 */
+    allowedUnits?: readonly U[];
+    /** 最小値 */
+    min?: number;
+    /** 最大値 */
+    max?: number;
+    /** ステップ幅 */
+    step?: number;
+    /** プレースホルダーテキスト */
+    placeholder?: string;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    [key: string]: Value | undefined;
+}
+
+/**
+ * `Dimension`（値＋単位）入力コンポーネントへの props。
+ */
+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;
+    /** `aria-label` 属性に設定するテキスト */
+    ariaLabel?: string;
+    /** 各フィールドをまとめた設定オブジェクト。フィールドより優先度が低い */
+    config?: DimensionInputConfig<U>;
+}
+
+/**
+ * ドロップダウン選択コンポーネント。
+ *
+ * @remarks
+ * **Shell** — プラグインプロパティの編集 UI として使用する。
+ */
+export declare const Dropdown: {
+    <T extends string = string>(props: DropdownProps<T>): default_2.ReactElement;
+    displayName: string;
+};
+
+/**
+ * ドロップダウン選択の設定オブジェクト。
+ *
+ * @remarks
+ * **Shell** — `DropdownProps.config` に渡す設定値の型。
+ */
+export declare interface DropdownConfig {
+    /** 選択肢の一覧 */
+    options?: readonly DropdownOption[];
+    /** 未選択時のプレースホルダーテキスト */
+    placeholder?: string;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    /** `false` のとき「未選択」状態を選択不可にする（デフォルト: `true`） */
+    allowEmpty?: boolean;
+    [key: string]: Value | undefined;
+}
+
+/**
+ * ドロップダウンの選択肢オブジェクト。
+ *
+ * @remarks
+ * **Shell** — `DropdownConfig.options` や `DropdownProps.options` に渡す選択肖の型。
+ */
+export declare interface DropdownOption {
+    /** 選択時に `onChange` に渡される値 */
+    value: Value;
+    /** 画面表示ラベル */
+    label: string;
+    [key: string]: Value;
+}
+
+/**
+ * ドロップダウン選択コンポーネントへの props。
+ */
+export declare interface DropdownProps<T extends string = string> extends PropertyComponentProps<T | undefined> {
+    /** 選択肢の一覧 */
+    options?: readonly DropdownOption[];
+    /** 未選択時のプレースホルダーテキスト */
+    placeholder?: string;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    /** `aria-label` 属性に設定するテキスト */
+    ariaLabel?: string;
+    /** `false` のとき「未選択」状態を選択不可にする（デフォルト: `true`） */
+    allowEmpty?: boolean;
+    /** 各フィールドをまとめた設定オブジェクト。フィールドより優先度が低い */
+    config?: DropdownConfig;
+}
+
+/**
+ * フルエディター用の UI 状態。
+ *
+ * @remarks
+ * - `useNoteContext` が内部で生成し、`NoteContext` に格納する。
+ * - `Default*` コンポーネントと `getDefault*` ヘルパー関数はこの状態を参照する。
+ */
+declare interface EditorState {
+    /** 選択中のブロック ID 一覧 */
+    selectedBlockIds: string[];
+    /** 表示中のページインデックス */
+    pageIdx: number;
+}
+
+/**
+ * `SelectionActionBar` に渡すデフォルト items 配列を返す。
+ *
+ * @remarks
+ * **Shell** — 各要素には `key` が付いているため `filter` / `map` でプログラマブルに操作できる。
+ *
+ * @example
+ * ```tsx
+ * const items = getDefaultSelectionActionBarItems({ context });
+ * // 削除ボタンを除外
+ * <SelectionActionBar items={items.filter((i) => i.key !== "delete")} />
+ * ```
+ */
+export declare function getDefaultSelectionActionBarItems({ context, gridSize, onActionFeedback, }: GetDefaultSelectionActionBarItemsOptions): ReactNode[];
+
+/**
+ * `GetDefaultSelectionActionBarItemsOptions` のオプション。
+ *
+ * @remarks
+ * **Shell** — `getDefaultSelectionActionBarItems()` の引数型。
+ */
+export declare interface GetDefaultSelectionActionBarItemsOptions {
+    /** NoteContext（`useNoteContext` が返すコンテキスト） */
+    context: NoteContext;
+    /** グリッドサイズ（レイアウトパネルに使用） */
+    gridSize?: {
+        cols: number;
+        rows: number;
+    };
+    /** アクション実行時のフィードバック（トースト表示など） */
+    onActionFeedback?: (feedback: ActionFeedback) => void;
+}
+
+/**
+ * ページのグリッド定義。
+ *
+ * @remarks
+ * `cols` / `rows` を省略した列/行は全て 1fr 等分割として扱われる。
+ */
+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"];
+
+/**
+ * `ActionBar` 上にグリッドの列数・行数を表示するコンパクトなコントロール。
+ *
+ * @remarks
+ * **Shell** — `ActionBar` のグリッド列数・行数設定セクション。
+ */
+export declare const GridSettingsSection: {
+    ({ grid, onGridChange, }: GridSettingsSectionProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `GridSettingsSection` コンポーネントへの props。
+ */
+export declare interface GridSettingsSectionProps {
+    /** グリッド設定 */
+    grid: Grid;
+    /** グリッド変更時のコールバック */
+    onGridChange: (grid: Grid) => void;
+}
+
+/**
+ * 行・列数を変更するパネル。
+ *
+ * @remarks
+ * **Shell** — 行・列数変更パネル。
+ */
+export declare const GridSizePanel: {
+    ({ grid, onGridChange }: GridSizePanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `GridSizePanel` コンポーネントへの props。
+ */
+export declare interface GridSizePanelProps {
+    /** グリッド設定 */
+    grid: Grid;
+    /** グリッド変更時のコールバック */
+    onGridChange: (grid: Grid) => void;
+}
+
+/**
+ * グリッドの列・行サイズに使用できる単位（`fr` を含む）。
+ */
+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;
+};
+
+/**
+ * アイコンボタンコンポーネント。
+ *
+ * @remarks
+ * **Shell** — ツールバーヤアクションバーのアイコンボタン UI として使用する。
+ */
+export declare const IconActionButton: {
+    ({ icon, label, onClick, onMouseEnter, disabled, title, preventFocusOnMouseDown, }: IconActionButtonProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * アイコンボタンコンポーネントへの props。
+
+ */
+export declare interface IconActionButtonProps {
+    /** ボタン内に表示するアイコン */
+    icon: default_2.ReactNode;
+    /** アクセシビリティ用ラベル（`aria-label` および `title` のデフォルト値） */
+    label: string;
+    /** クリック時のコールバック */
+    onClick?: () => void;
+    /** マウスホバー時のコールバック */
+    onMouseEnter?: () => void;
+    /** `true` のとき非活性化 */
+    disabled?: boolean;
+    /** ツールチップテキスト。省略時は `label` を使用する */
+    title?: string;
+    /** `true` のとき `mousedown` でフォーカスを奪わない。パネルを閉じたくない操作に使用する */
+    preventFocusOnMouseDown?: boolean;
+}
+
+/**
+ * JSON 形式でブックデータのインポート・エクスポートを行うパネル。
+ *
+ * @remarks
+ * **Shell** — `OtherPanel` のデフォルトセクションとして使用される。
+ */
+export declare const ImportExportPanel: default_2.FC<ImportExportPanelProps>;
+
+/**
+ * `ImportExportPanel` コンポーネントへの props。
+ */
+export declare interface ImportExportPanelProps {
+    /** ブックデータ */
+    book: Book;
+    /** 入力値のマップ */
+    values: Record<string, Value>;
+    /** ブック変更時のコールバック */
+    onBookChange: OnBookChange;
+    /** 入力値変更時のコールバック */
+    onValuesChange: OnValuesChange;
+}
+
+/**
+ * ブロックの位置と大きさを設定するパネル。
+ *
+ * @remarks
+ * **Shell** — 複数選択時はバウンディングボックスの最小座標を基準に相対変更する。
+ */
+export declare const LayoutPanel: default_2.FC<LayoutPanelProps>;
+
+/**
+ * `LayoutPanel` コンポーネントへの props。
+ */
+export declare interface LayoutPanelProps {
+    /** 選択中のブロックの配列 */
+    selectedBlocks: Block[];
+    /** ブロック更新時のコールバック */
+    onUpdateBlocks: (updates: Record<string, Partial<Block>>, options?: {
+        mergeKey?: string;
+    }) => void;
+    /** グリッドサイズ（最大入力値の制限に使用） */
+    gridSize?: {
+        cols: number;
+        rows: number;
+    };
+}
+
+/**
+ * 線のスタイル定義（色・幅・種別）。
+ */
+declare interface LineStyle {
+    /** CSS カラー値 */
+    color: string;
+    /** 線の幅 */
+    width: Dimension<BorderUnit>;
+    /** 線の種別 */
+    type: LineType;
+}
+
+/**
+ * 枠線・区切り線に適用するスタイル種別。
+ */
+declare enum LineType {
+    /** 実線 */
+    SOLID = "solid",
+    /** 破線 */
+    DASHED = "dashed",
+    /** 点線 */
+    DOTTED = "dotted"
+}
+
+/**
+ * マージンを変更するパネル。
+ *
+ * @remarks
+ * **Shell** — 全辺一括設定モードあり。
+ */
+export declare const MarginPanel: {
+    ({ paper, onPaperChange }: MarginPanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `MarginPanel` コンポーネントへの props。
+ */
+export declare interface MarginPanelProps {
+    /** 用紙設定 */
+    paper: Paper;
+    /** 用紙変更時のコールバック */
+    onPaperChange: (paper: Paper) => void;
+}
+
+/**
+ * ブロックの ID と非表示設定を編集するパネル。
+ *
+ * @remarks
+ * **Shell** — ID の重複チェックおよびバリデーションを含む。
+ */
+export declare const MetaPanel: default_2.FC<MetaPanelProps>;
+
+/**
+ * `MetaPanel` コンポーネントへの props。
+ */
+export declare interface MetaPanelProps {
+    /** 選択中のブロックの配列 */
+    selectedBlocks: Block[];
+    /** ブロック更新時のコールバック */
+    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
+    /** 全ブロックの ID セット（重複チェックに使用） */
+    allBlockIds?: Set<string>;
+}
+
+/**
+ * `useNoteContext` が組み立てるコンテキストオブジェクト。
+ *
+ * Note / ActionBar / Sidebar / DefaultSelectionActionBarOverlay にそのまま渡して使用する。
+ */
+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;
+}
+
+/**
+ * Note の表示・編集モード。
+ */
+declare enum NoteMode {
+    /**
+     * ブロックの配置・サイズ変更、グリッド設定、`initValue`（初期値）の設定が可能。
+     *
+     * 入力コントロールは動作するが、値はセッション内のみ保持される（永続化されない）。
+     */
+    FORM = "Form",
+    /**
+     * ブロックの値を入力・編集できる。
+     *
+     * レイアウトや `initValue` は変更不可。
+     */
+    EDIT = "Edit",
+    /**
+     * すべて読み取り専用。入力コントロールは無効。
+     *
+     * `showValidation` によるバリデーション結果の表示が有効。
+     */
+    VIEW = "View"
+}
+
+/**
+ * 数値入力コンポーネント。
+ *
+ * @remarks
+ * **Shell** — プラグインプロパティの編集 UI として使用する。
+ */
+export declare const NumberInput: {
+    ({ value, onChange, readOnly, min: propMin, max: propMax, step: propStep, integer: propInteger, placeholder: propPlaceholder, width: propWidth, height: propHeight, ariaLabel, config, onBlur, }: NumberInputProps): default_2.ReactElement;
+    displayName: string;
+};
+
+/**
+ * 数値入力の設定オブジェクト。
+ *
+ * @remarks
+ * **Shell** — `NumberInputProps.config` に渡す設定値の型。
+ */
+export declare interface NumberInputConfig {
+    /** 最小値 */
+    min?: number;
+    /** 最大値 */
+    max?: number;
+    /** ステップ幅 */
+    step?: number;
+    /** `true` のとき入力値を整数に丸める */
+    integer?: boolean;
+    /** プレースホルダーテキスト */
+    placeholder?: string;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    [key: string]: Value | undefined;
+}
+
+/**
+ * 数値入力コンポーネントへの props。
+ */
+export declare interface NumberInputProps extends PropertyComponentProps<number | undefined> {
+    /** 最小値 */
+    min?: number;
+    /** 最大値 */
+    max?: number;
+    /** ステップ幅 */
+    step?: number;
+    /** `true` のとき入力値を整数に丸める */
+    integer?: boolean;
+    /** プレースホルダーテキスト */
+    placeholder?: string;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    /** `aria-label` 属性に設定するテキスト */
+    ariaLabel?: string;
+    /** `min`/`max`/`step` 等をまとめた設定オブジェクト。フィールドより優先度が低い */
+    config?: NumberInputConfig;
+    /** フォーカスが外れたときのコールバック */
+    onBlur?: () => void;
+}
+
+/**
+ * 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;
+
+/**
+ * その他設定パネル。インポート・エクスポートなどを含む。
+ *
+ * @remarks
+ * **Shell** — `sections` で内容をカスタマイズできる。
+ */
+export declare const OtherPanel: default_2.FC<OtherPanelProps>;
+
+/**
+ * `OtherPanel` コンポーネントへの props。
+ */
+export declare interface OtherPanelProps {
+    /** NoteContext（`useNoteContext` が返すコンテキスト） */
+    context: NoteContext;
+    /** カスタムセクションの配列。未指定時はデフォルト構成（`ImportExportPanel`）が使用される */
+    sections?: ReactNode[];
+}
+
+/**
+ * 1ページ分のフォームスキーマ。
+ */
+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>;
+}
+
+/**
+ * ブロックをドラッグ＆ドロップで挿入するためのパレットパネル。
+ *
+ * @remarks
+ * **Shell** — ブロック未選択時にサイドバーに表示される。
+ */
+export declare const PalettePanel: {
+    ({ context, className }: PalettePanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `PalettePanel` コンポーネントへの props。
+ */
+export declare interface PalettePanelProps {
+    /** NoteContext（`useNoteContext` が返すコンテキスト） */
+    context: NoteContext;
+    /** カスタムクラス名 */
+    className?: string;
+}
+
+/**
+ * ページに適用する用紙設定（サイズ・マージン・向き）。
+ */
+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"];
+
+/**
+ * 用紙四辺のマージン設定。
+ */
+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>;
+}
+
+/**
+ * `ActionBar` 上に用紙サイズプリセット選択を表示するコンパクトなコントロール。
+ *
+ * @remarks
+ * **Shell** — カスタム選択時は幅・高さ・単位の入力も表示される。
+ */
+export declare const PaperSettingsSection: {
+    ({ paper, onPaperChange, }: PaperSettingsSectionProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `PaperSettingsSection` コンポーネントへの props。
+ */
+export declare interface PaperSettingsSectionProps {
+    /** 用紙設定 */
+    paper: Paper;
+    /** 用紙変更時のコールバック */
+    onPaperChange: (paper: Paper) => void;
+}
+
+/**
+ * 用紙サイズ設定。
+ *
+ * @remarks
+ * `preset` が `CUSTOM` 以外の場合も `width` / `height` には実寸が格納される。
+ */
+declare interface PaperSize {
+    /** 選択中のプリセット */
+    preset: PaperSizePreset;
+    /** 幅（物理単位）。`CUSTOM` 時はユーザー指定値。 */
+    width: Dimension<PaperUnit>;
+    /** 高さ（物理単位）。`CUSTOM` 時はユーザー指定値。 */
+    height: Dimension<PaperUnit>;
+}
+
+/**
+ * 用紙サイズ・向き・自動サイズモードを変更するパネル。
+ *
+ * @remarks
+ * **Shell** — カスタム選択時は幅・高さ・単位の入力も表示される。
+ */
+export declare const PaperSizePanel: {
+    ({ paper, onPaperChange, }: PaperSizePanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `PaperSizePanel` コンポーネントへの props。
+ */
+export declare interface PaperSizePanelProps {
+    /** 用紙設定 */
+    paper: Paper;
+    /** 用紙変更時のコールバック */
+    onPaperChange: (paper: Paper) => void;
+}
+
+/**
+ * 用紙サイズのプリセット種別。`CUSTOM` 選択時は `PaperSize.width` / `height` が有効になる。
+ */
+declare enum PaperSizePreset {
+    A4 = "A4",
+    B5 = "B5",
+    A3 = "A3",
+    LETTER = "Letter",
+    LEGAL = "Legal",
+    CUSTOM = "Custom"
+}
+
+/**
+ * 用紙サイズに使用できる単位。
+ */
+declare type PaperUnit = (typeof PAPER_UNITS)[number];
+
+/**
+ * 選択ブロックのプラグイン固有属性パネルを表示するコンポーネント。
+ *
+ * @remarks
+ * **Shell** — プラグインの `propDefs` に従ってプロパティフィールドを動的に表示する。
+ */
+export declare const PluginPanels: default_2.FC<PluginPanelsProps>;
+
+/**
+ * `PluginPanels` コンポーネントへの props。
+ */
+export declare interface PluginPanelsProps {
+    /** 選択中のブロックの配列 */
+    selectedBlocks: Block[];
+    /** プラグインレジストリ */
+    pluginRegistry: PluginRegistry;
+    /** ブロック更新時のコールバック */
+    onUpdateBlocks: (updates: Record<string, Partial<Block>>) => void;
+    /** ブロックデフォルト設定 */
+    blockDefaults?: BlockDefaults;
+    /** `true` のときグループヘッダーを表示（デフォルト: `true`） */
+    showGroupHeader?: boolean;
+}
+
+/**
+ * `createPluginRegistry` が返す、`block.kind` をキーにしたプラグインレジストリ。
+ *
+ * 未登録の `kind` は `undefined` になるため、アクセス前に存在確認が必要。
+ */
+declare type PluginRegistry = Record<string, ResolvedPlugin | undefined>;
+
+/**
+ * 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;
+}
+
+/**
+ * `PropDef` の種類に応じたプロパティ編集フィールドを描画するコンポーネント。
+ *
+ * @remarks
+ * `PluginPanels` から各ブロックのプロパティを編集するために使用される。
+ */
+export declare const PropertyField: MemoExoticComponent<({ propDef, selectedBlocks, onChange, onChangeBatch, readOnly, blockDefaults, onResetToDefault, }: PropertyFieldProps) => JSX.Element>;
+
+/**
+ * `PropDefEditor`（ブロックデフォルト用）および `PropertyField` コンポーネントへの props。
+ */
+export declare interface PropertyFieldProps {
+    /** プロパティ定義（種類・ドィスプレイ名・デフォルト値など） */
+    propDef: PropDef;
+    /** 選択中のブロックの配列 */
+    selectedBlocks: Block[];
+    /** 容橋値変更時のコールバック */
+    onChange: (key: string, value: Value) => void;
+    /** 複数値一括変更時のコールバック */
+    onChangeBatch?: (updates: Record<string, Value>) => void;
+    /** `true` のときカスタムコンポーネントに `readOnly` を渡す */
+    readOnly?: boolean;
+    /** ブロックデフォルト設定 */
+    blockDefaults?: BlockDefaults;
+    /** デフォルト値にリセット実行時のコールバック */
+    onResetToDefault?: (keys: string[]) => void;
+}
+
+/**
+ * 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;
+}
+
+/**
+ * レジストリに登録された解決済みプラグイン。
+ *
+ * @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;
+}
+
+/**
+ * フローティングボタンバー + ポップオーバーフレームワークのコンテナ。
+ *
+ * @remarks
+ * **Shell** — `items` 配列でボタン・パネルを渡す。デフォルト構成は `getDefaultSelectionActionBarItems()` で取得できる。
+ */
+export declare const SelectionActionBar: {
+    ({ items, className, style, onPointerDown, }: SelectionActionBarProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `SelectionActionBar` の個別ボタン。バー以外の UI からも単体で使用可能。
+ *
+ * @remarks
+ * **Shell** — `SelectionActionBar` の各ボタン。
+ */
+export declare const SelectionActionBarButton: {
+    ({ icon, label, onClick, onMouseEnter, title, disabled, }: SelectionActionBarButtonProps): ReactNode;
+    displayName: string;
+};
+
+/**
+ * `SelectionActionBarButton` コンポーネントへの props。
+ */
+export declare interface SelectionActionBarButtonProps {
+    /** ボタン内に表示するアイコン（SVG コンポーネントや絵文字など） */
+    icon: ReactNode;
+    /** aria-label / title に使用するラベル */
+    label: string;
+    /** クリック時のコールバック */
+    onClick?: () => void;
+    /** マウスオーバー時のコールバック */
+    onMouseEnter?: () => void;
+    /** ツールチップに表示するテキスト（省略時は `label` を使用） */
+    title?: string;
+    /** `true` のときボタンを無効化 */
+    disabled?: boolean;
+}
+
+/**
+ * `SelectionActionBar` コンテキストで共有される値。
+ */
+export declare interface SelectionActionBarContextValue {
+    /** 現在開いているパネルの ID */
+    openPanel: string | null;
+    /** ホバーでパネルを開く */
+    openPanelByHover: (panelId: string) => void;
+    /** クリックでパネルを開く */
+    openPanelByClick: (panelId: string) => void;
+    /** バー外のイベント用 pointer-down ハンドラ */
+    onPointerDown?: default_2.PointerEventHandler<HTMLDivElement>;
+    /** ポータルベースのポップオーバー描画用ターゲット要素 */
+    wrapperEl: HTMLDivElement | null;
+}
+
+/**
+ * `selectionBoundingBox` の右上コーナーの右上に `children` を浮かせるコンテナ。
+ *
+ * @remarks
+ * **Shell** — `isDragging=true` または `selectionBoundingBox` が `null` の場合は何も描画しない。
+ *
+ * 配置ルール: 水平はバーの右端を `bbox.right` に揃える。垂直はブロック上に表示し上端がキャンバス外の場合はブロック下に反転。
+ */
+export declare const SelectionActionBarOverlay: ({ selectionBoundingBox, isDragging, zIndex, children, }: SelectionActionBarOverlayProps) => JSX.Element | null;
+
+/**
+ * `SelectionActionBarOverlay` コンポーネントへの props。
+ */
+export declare interface SelectionActionBarOverlayProps {
+    /**
+     * 選択ブロック群の bounding box（px座標）。
+     *
+     * `useSelectionBoundingBox` で算出して渡す。`null` の場合は非表示。
+     */
+    selectionBoundingBox?: SelectionBoundingBox | null;
+    /** ドラッグ中のとき `true` を渡すと非表示になる */
+    isDragging?: boolean;
+    /** z-index（デフォルト: `Z_INDEX.SELECTION_ACTION_BAR`） */
+    zIndex?: number;
+    /** オーバーレイ内に描画するコンテンツ */
+    children?: ReactNode;
+}
+
+/**
+ * `SelectionActionBar` 内でポップオーバーパネルを1件管理するコンポーネント。
+ *
+ * @remarks
+ * **Shell** — トリガーボタンはバー内に描画し、ポップオーバーはラッパー要素にポータル描画される。
+ */
+export declare const SelectionActionBarPanel: {
+    ({ id, icon, label, children, }: SelectionActionBarPanelProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * `SelectionActionBarPanel` コンポーネントへの props。
+ */
+export declare interface SelectionActionBarPanelProps {
+    /** このパネルを一意に識別する ID */
+    id: string;
+    /** トリガーボタンのアイコン（SVG コンポーネントや絵文字など） */
+    icon: ReactNode;
+    /** トリガーボタンのラベル（aria-label） */
+    label: string;
+    /** ポップオーバーのコンテンツ */
+    children: ReactNode;
+}
+
+/**
+ * `SelectionActionBar` コンポーネントへの props。
+ */
+export declare interface SelectionActionBarProps {
+    /**
+     * バーに表示するアイテムの配列（SelectionActionBarButton / SelectionActionBarPanel など）。
+     * デフォルト値は `getDefaultSelectionActionBarItems()` で取得できる。
+     */
+    items?: ReactNode[];
+    /** バールート要素への追加 CSS クラス */
+    className?: string;
+    /** バールート要素へのインラインスタイル */
+    style?: default_2.CSSProperties;
+    /** コンテキストに渡す pointer-down ハンドラ */
+    onPointerDown?: default_2.PointerEventHandler<HTMLDivElement>;
+}
+
+/**
+ * 選択ブロック群全体を囲む bounding box（px 座標）を表す型。
+ */
+export declare interface SelectionBoundingBox {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+
+/**
+ * JSON シリアライズ可能なプロパティのみを持つオブジェクト型の境界。
+ *
+ * `BlockPlugin<P>` / `Block<P>` の型引数制約として使用し、`P` に関数・クラスインスタンス・DOM 要素など非 serializable な型が混入した場合に型エラーとして検出する。
+ *
+ * オプショナルフィールド（`?`）は `undefined` を許容するため `Value | undefined` としている。
+ */
+declare type SerializableRecord = Record<string, Value | undefined>;
+
+/**
+ * サイドバー／フローティングウィジェットのルート要素に付与する props。
+ *
+ * @remarks
+ * **Shell** — スプレッドすることで `NoteForm` の選択解除ロジックの対象外になる。
+ */
+export declare const SIDEBAR_PORTAL_PROPS: {
+    readonly "data-sidebar": "true";
+};
+
+/**
+ * NoteForm がサイドバー領域を判定するためのセレクタ。
+ *
+ * @remarks
+ * **Shell** — カスタムサイドバー実装時にルート要素へ付与する `data-sidebar="true"` を選択する。
+ */
+export declare const SIDEBAR_PORTAL_SELECTOR = "[data-sidebar=\"true\"]";
+
+/**
+ * タブパネル共通コンポーネント。
+ *
+ * @remarks
+ * **Shell** — サイドバーのタブコンテンツ領域として使用する。
+ */
+export declare const TabPanel: ({ children, emptyMessage, className, }: TabPanelProps) => JSX.Element;
+
+/**
+ * タブパネル共通コンポーネントへの props。
+ */
+export declare interface TabPanelProps {
+    /** パネルの内容 */
+    children: ReactNode;
+    /** 空状態のメッセージ（childrenがない場合に表示） */
+    emptyMessage?: string;
+    /** カスタムクラス名 */
+    className?: string;
+}
+
+/**
+ * タブコンテナコンポーネント。
+ *
+ * @remarks
+ * **Shell** — サイドバー・パネルのタブ UI として使用する。
+ */
+export declare const Tabs: default_2.FC<TabsProps>;
+
+/**
+ * タブコンテンツコンポーネント。
+ *
+ * @remarks
+ * **Shell** — `Tabs` の子要素として使用する。
+ */
+export declare const TabsContent: default_2.FC<TabsContentProps>;
+
+/**
+ * タブコンテンツコンポーネントへの props。
+ */
+export declare interface TabsContentProps {
+    /** 対応するタブ値（`TabsTrigger.value` と対応） */
+    value: string;
+    /** 表示する内容 */
+    children: default_2.ReactNode;
+    /** カスタムクラス名 */
+    className?: string;
+}
+
+/**
+ * タブリストコンポーネント。
+ *
+ * @remarks
+ * **Shell** — `Tabs` の子要素として使用する。
+ */
+export declare const TabsList: default_2.FC<TabsListProps>;
+
+/**
+ * タブリストコンポーネントへの props。
+ */
+export declare interface TabsListProps {
+    /** 子要素 */
+    children: default_2.ReactNode;
+    /** カスタムクラス名 */
+    className?: string;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    /** インラインスタイル */
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * タブコンテナコンポーネントへの props。
+ */
+export declare interface TabsProps {
+    /** 初期選択タブの値 */
+    defaultValue: string;
+    /** 外部制御時の選択タブ値 */
+    value?: string;
+    /** 選択タブ変更時のコールバック */
+    onValueChange?: (value: string) => void;
+    /** 子要素 */
+    children: default_2.ReactNode;
+    /** 表示バリアント。`segmented` は分割ボタン型 */
+    variant?: "default" | "segmented";
+    /** カスタムクラス名 */
+    className?: string;
+}
+
+/**
+ * タブトリガーボタンコンポーネント。
+ *
+ * @remarks
+ * **Shell** — `TabsList` の子要素として使用する。
+ */
+export declare const TabsTrigger: default_2.FC<TabsTriggerProps>;
+
+/**
+ * タブトリガーボタンコンポーネントへの props。
+ */
+export declare interface TabsTriggerProps {
+    /** このトリガーが対応するタブ値（`TabsContent.value` と対応） */
+    value: string;
+    /** ボタン内に表示する内容 */
+    children: default_2.ReactNode;
+    /** カスタムクラス名 */
+    className?: string;
+    /** `true` のとき非活性化 */
+    disabled?: boolean;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    /** インラインスタイル */
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * テキスト入力コンポーネント。
+ *
+ * @remarks
+ * **Shell** — プラグインプロパティの編集 UI として使用する。
+ */
+export declare const TextInput: {
+    ({ value, onChange, readOnly, placeholder: propPlaceholder, maxLength: propMaxLength, multiline: propMultiline, rows: propRows, width, height, ariaLabel, config, onBlur, }: TextInputProps): default_2.ReactElement;
+    displayName: string;
+};
+
+/**
+ * テキスト入力の設定オブジェクト。
+ *
+ * @remarks
+ * **Shell** — `TextInputProps.config` に渡す設定値の型。
+ */
+export declare interface TextInputConfig {
+    /** プレースホルダーテキスト */
+    placeholder?: string;
+    /** 最大文字数 */
+    maxLength?: number;
+    /** `true` のとき `<textarea>` で表示する */
+    multiline?: boolean;
+    /** `multiline` のとき表示する行数 */
+    rows?: number;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    [key: string]: Value | undefined;
+}
+
+/**
+ * テキスト入力コンポーネントへの props。
+ */
+export declare interface TextInputProps extends PropertyComponentProps<string | undefined> {
+    /** プレースホルダーテキスト */
+    placeholder?: string;
+    /** 最大文字数 */
+    maxLength?: number;
+    /** `true` のとき `<textarea>` で表示する */
+    multiline?: boolean;
+    /** `multiline` のとき表示する行数 */
+    rows?: number;
+    /** 幅(px) */
+    width?: number;
+    /** 高さ(px) */
+    height?: number;
+    /** `aria-label` 属性に設定するテキスト */
+    ariaLabel?: string;
+    /** 各フィールドをまとめた設定オブジェクト。フィールドより優先度が低い */
+    config?: TextInputConfig;
+    /** フォーカスが外れたときのコールバック */
+    onBlur?: () => void;
+}
+
+/**
+ * このパッケージで使用できる全単位。
+ */
+declare type Unit = (typeof ALL_UNITS)[number];
+
+/**
+ * `SelectionActionBar` コンテキスト値を取得するフック。
+ *
+ * @remarks
+ * **Shell** — `SelectionActionBar` の子コンポーネント内でのみ使用可能。
+ *
+ * バー外で呼び出すと `Error` をスローする。
+ */
+export declare function useSelectionActionBar(): SelectionActionBarContextValue;
+
+/**
+ * 選択中ブロックたちの bounding box を返す。
+ *
+ * 選択ブロックが 0 件、または存在しない ID のみの場合は `null` を返す。
+ *
+ * @remarks
+ * **Shell** — 結果は `useMemo` でメモ化される。
+ */
+export declare function useSelectionBoundingBox(blocks: Block[], selectedBlockIds: string[], getBlockRectPx: (block: Block) => BlockRectPx): SelectionBoundingBox | null;
+
+/**
+ * 選択中ブロックの bounding box をコンテナ相対 px 座標で返すフック。
+ *
+ * @remarks
+ * **Shell** — `position: relative` なコンテナ内に `<Note>` と `<DefaultSelectionActionBarOverlay>` を並べる構成で使用する。
+ *
+ * 「いつ再計測するか」は呼び出し側の責任。ブロックの座標変化時にも再計測したい場合は、
+ * `selectedBlockIds` に新しい配列参照を渡すこと。
+ *
+ * @example
+ * ```tsx
+ * const containerRef = useRef<HTMLDivElement>(null);
+ * const selectionBoundingBox = useSelectionBounds(containerRef, selectedBlockIds);
+ * ```
+ *
+ * @param containerRef - Note を包む `position: relative` なコンテナの ref
+ * @param selectedBlockIds - 選択中のブロック ID 一覧（再計測が必要なときは新しい配列参照を渡すこと）
+ * @returns 選択範囲の bounding box。選択なし・要素未発見時は null
+ */
+export declare function useSelectionBounds(containerRef: RefObject<HTMLElement | null>, selectedBlockIds: string[]): SelectionBoundingBox | null;
+
+/**
+ * このパッケージで扱う値の型。JSON シリアライズ可能な値のみを表す再帰型。
+ *
+ * ブロックの入力値・バインディング値・スキーマのデフォルト値などに共通して使用される。
+ */
+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;
+};
+
+export { }