@ryusenkei/maezae 0.1.0 → 0.3.0

package/dist/types/body/src/components.d.ts

@@ -0,0 +1,25 @@
+import type { Body } from './types.js';
+/** 属性（Markdown の `{…}`、値は文字列） */
+export type Attributes = Readonly<Record<string, string>>;
+/** コンポーネントの Markdown の記法（to と from で往復して同じ props に戻ること） */
+export type ComponentMarkdown<M> = Readonly<{
+    to(props: unknown): Readonly<{
+        attributes?: Attributes;
+        content?: Body<M>;
+    }>;
+    from(attributes: Attributes, content: Body<M>): unknown;
+}>;
+/** カスタムコンポーネントの定義（inline はインラインのコンポーネント、description と example は Markdown の説明に使用） */
+export type ComponentDef<M> = Readonly<{
+    name: string;
+    inline?: boolean;
+    description?: string;
+    example?: string;
+    markdown?: ComponentMarkdown<M>;
+}>;
+/** 予約の名前（ブロック） */
+export declare const RESERVED_BLOCK_NAMES: ReadonlySet<string>;
+/** 予約の名前（インライン） */
+export declare const RESERVED_INLINE_NAMES: ReadonlySet<string>;
+/** 既定の記法: props を JSON のコードブロックに */
+export declare const jsonMarkdown: ComponentMarkdown<never>;

package/dist/types/body/src/declared.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { type ComponentDef } from './components.js';
+/** 引数の型 */
+export type PropType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+/** 1つの引数の形（title は管理画面の項目名、enum は文字列の選択肢、items は配列の要素、properties・required はオブジェクトの中） */
+export type PropSchema = Readonly<{
+    type: PropType;
+    title?: string;
+    description?: string;
+    enum?: readonly string[];
+    items?: PropSchema;
+    properties?: Readonly<Record<string, PropSchema>>;
+    required?: readonly string[];
+}>;
+/** 引数の全体の形（最上位はオブジェクト） */
+export type PropsSchema = Readonly<{
+    type: 'object';
+    properties: Readonly<Record<string, PropSchema>>;
+    required?: readonly string[];
+}>;
+/** 導入先が宣言する部品（label は管理画面の表示名、inline の省略はブロック） */
+export type DeclaredComponent = Readonly<{
+    name: string;
+    label: string;
+    description?: string;
+    inline?: boolean;
+    props: PropsSchema;
+}>;
+/** 宣言の一覧の検査（名前の重複も拒否） */
+export declare const declaredComponentsSchema: z.ZodType<readonly DeclaredComponent[]>;
+/** 宣言した部品の引数の検査（宣言ごとに作成を再利用） */
+export declare function declaredPropsZod(d: DeclaredComponent): z.ZodType;
+/** 宣言から Markdown の変換と説明に使用する部品の定義（記法は既定の JSON） */
+export declare const declaredDefOf: (d: DeclaredComponent) => ComponentDef<never>;

package/dist/types/body/src/derive.d.ts

@@ -0,0 +1,13 @@
+import type { Body, Rich } from './types.js';
+/** 読了時間の既定の分速（字/分） */
+export declare const READING_SPEED = 500;
+/** 断片の列の文字（装飾・リンクは文字、インラインのコンポーネントは中の文字） */
+export declare const plainOf: (rich: Rich) => string;
+/** 本文の注が参照する出典の ID（出現の順、重複あり） */
+export declare function citesOf<M>(body: Body<M>): string[];
+/** 本文の導入の文字（最初の見出しまでの段落をつなげたもの、導入がなければ空） */
+export declare function excerptOf<M>(body: Body<M>): string;
+/** 読了時間（分、本文の文字列の字数を分速 speed で割った概算、1分以上） */
+export declare const readMinOf: <M>(body: Body<M>, speed?: number) => number;
+/** 本文にあるサイト内へのリンク先（`/` で始まる href、重複なし） */
+export declare const linksOf: <M>(body: Body<M>) => string[];

package/dist/types/body/src/description.d.ts

@@ -0,0 +1,8 @@
+/** meta description の長さの上限（検索結果で省略されにくい字数の目安） */
+export declare const DESCRIPTION_MAX = 120;
+/**
+ * 説明を meta description の長さに調整
+ * - 上限を超える場合: 上限までの最後の句点まで
+ * - 句点がない場合: 上限で切って省略の記号
+ */
+export declare function descriptionOf(excerpt: string, max?: number): string;

package/dist/types/body/src/href.d.ts

@@ -0,0 +1,4 @@
+/** 本文のリンク先として許可する形か（保存の検査とサイトの出力で共通） */
+export declare const isSafeHref: (href: string) => boolean;
+/** 許可しないリンク先の問題の文言 */
+export declare const unsafeHrefMessage: (href: string) => string;

package/dist/types/body/src/index.d.ts

@@ -0,0 +1,11 @@
+export type { ComponentDef } from './components.js';
+export { type DeclaredComponent, declaredComponentsSchema, declaredDefOf, declaredPropsZod, type PropSchema, type PropsSchema, type PropType } from './declared.js';
+export { DESCRIPTION_MAX, descriptionOf } from './description.js';
+export { citesOf, excerptOf, linksOf, plainOf, READING_SPEED, readMinOf } from './derive.js';
+export { CORE_COMPONENTS, coreComponentOf, type Chart, type ChartColor, type ChartDatum, type ComponentName, type ComponentProps, type CoreComponent } from './library.js';
+export { isSafeHref } from './href.js';
+export { fromMarkdown, toMarkdown, type MarkdownOptions } from './markdown.js';
+export { checkBody, describeMarkdown, type BodyProfile } from './profile.js';
+export { blockSchemaOf } from './schema.js';
+export { bodyFromMarkdown, bodyToMarkdown, markdownGuide, type MarkdownResult, type MediaSyntax } from './standard.js';
+export type { Block, Body, ComponentBlock, HeadingLevel, Inline, InlineComponent, Link, List, ListItem, Mark, Rich, StandardBlock, Text } from './types.js';

package/dist/types/body/src/library.d.ts

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+import type { ComponentDef } from './components.js';
+/** グラフの項目と値 */
+export type ChartDatum = Readonly<{
+    label: string;
+    value: number;
+}>;
+/** グラフの色（テーマの系列の番号） */
+export type ChartColor = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+/**
+ * グラフ（コンポーネント chart の props から caption を除いた形）
+ * - bar: 横棒、pie: 割合
+ * - line: 折れ線（series の values は labels と同じ長さ）
+ * - heat: 濃淡の表（rows の values は cols と同じ長さ）
+ */
+export type Chart = Readonly<{
+    chart: 'bar';
+    data: readonly ChartDatum[];
+    unit: string;
+    color?: ChartColor;
+} | {
+    chart: 'line';
+    labels: readonly string[];
+    series: readonly Readonly<{
+        name: string;
+        values: readonly number[];
+    }>[];
+    unit: string;
+} | {
+    chart: 'pie';
+    data: readonly ChartDatum[];
+    unit: string;
+} | {
+    chart: 'heat';
+    cols: readonly string[];
+    rows: readonly Readonly<{
+        label: string;
+        values: readonly number[];
+    }>[];
+    unit: string;
+    color?: ChartColor;
+}>;
+/** 核のコンポーネントの props（名前ごと、インラインは属性） */
+export type ComponentProps<M> = Readonly<{
+    cite: Readonly<{
+        id: string;
+    }>;
+    pending: Readonly<Record<string, never>>;
+    speech: Readonly<{
+        text: string;
+    }>;
+    chart: Chart & Readonly<{
+        caption: string;
+    }>;
+    diagram: Readonly<{
+        source: string;
+        alt: string;
+        caption: string;
+    }>;
+    gallery: Readonly<{
+        items: readonly Readonly<{
+            media: M;
+            caption?: string;
+        }>[];
+    }>;
+    'link-card': Readonly<{
+        href: `https://${string}`;
+        title: string;
+        site?: string;
+        desc?: string;
+        image?: M;
+    }>;
+    links: Readonly<{
+        label?: string;
+        items: readonly Readonly<{
+            href: `https://${string}`;
+            title: string;
+            site?: string;
+        }>[];
+    }>;
+}>;
+/** 核のコンポーネントの名前 */
+export type ComponentName = keyof ComponentProps<unknown>;
+/** 核のコンポーネントの定義（props は検査、インラインは属性の検査） */
+export type CoreComponent = ComponentDef<unknown> & Readonly<{
+    name: ComponentName;
+    props: (media: z.ZodType) => z.ZodType;
+}>;
+/** 注のコンポーネントの名前（本文からの算出 citesOf が参照） */
+export declare const CITE = "cite";
+/** 核のコンポーネント（chart の Markdown は既定の JSON） */
+export declare const CORE_COMPONENTS: readonly CoreComponent[];
+/** 名前から核のコンポーネント（なければ undefined） */
+export declare const coreComponentOf: (name: string) => CoreComponent | undefined;

package/dist/types/body/src/markdown.d.ts

@@ -0,0 +1,14 @@
+import { type ComponentDef } from './components.js';
+import type { Body } from './types.js';
+/** マッパーの設定（media は画像の参照と Markdown の文字列の変換） */
+export type MarkdownOptions<M> = Readonly<{
+    media: Readonly<{
+        toSrc(media: M): string;
+        fromSrc(src: string): M;
+    }>;
+    components?: readonly ComponentDef<M>[];
+}>;
+/** 本文を Markdown に */
+export declare function toMarkdown<M>(body: Body<M>, options: MarkdownOptions<M>): string;
+/** Markdown を本文に（解析できない構文は例外） */
+export declare function fromMarkdown<M>(markdown: string, options: MarkdownOptions<M>): Body<M>;

package/dist/types/body/src/normalize.d.ts

@@ -0,0 +1,7 @@
+import type { Body, Mark, Rich } from './types.js';
+/** 装飾の順序（Markdown では外側から内側） */
+export declare const MARK_ORDER: readonly Mark[];
+/** インラインの断片の列を正規化 */
+export declare function normalizeRich(rich: Rich): Rich;
+/** 本文を正規化 */
+export declare function normalizeBody<M>(body: Body<M>): Body<M>;

package/dist/types/body/src/profile.d.ts

@@ -0,0 +1,48 @@
+import type { ComponentDef } from './components.js';
+import type { Body, HeadingLevel, Mark } from './types.js';
+/** 本文の設定 */
+export type BodyProfile = Readonly<{
+    headings: readonly HeadingLevel[];
+    marks: readonly Mark[];
+    /** 装飾の重ね掛けと装飾つきのリンク（既定は可） */
+    combineMarks?: boolean;
+    /** リンクの rel（なしは rel なしのリンクだけ） */
+    linkRels?: readonly string[];
+    /** 装飾・リンク・インラインのコンポーネントを使用できない場所 */
+    plain?: readonly ('heading' | 'tableHead')[];
+    list?: Readonly<{
+        ordered: boolean;
+        nested: boolean;
+        variants?: readonly string[];
+    }>;
+    quote?: Readonly<{
+        multiple: boolean;
+        cite: boolean;
+    }>;
+    /** コード（componentLangs はコンポーネントで書く言語とコンポーネントの名前、例: mermaid は図、その言語のフェンスだけのコードは不可） */
+    code?: Readonly<{
+        caption: boolean;
+        componentLangs?: Readonly<Record<string, string>>;
+    }>;
+    image?: Readonly<{
+        variants?: readonly string[];
+    }>;
+    table?: Readonly<{
+        head: 'required' | 'optional';
+        caption: 'required' | 'optional' | 'none';
+    }>;
+    divider?: true;
+    html?: true;
+    /** 使用できるコンポーネントの名前（ブロック・インライン） */
+    components: readonly string[];
+}>;
+/** 本文の設定に合わない箇所（index は本文のブロックの位置、0から） */
+type BodyProblem = Readonly<{
+    index: number;
+    message: string;
+}>;
+/** 本文を設定で検査（合わない箇所をすべて返却） */
+export declare function checkBody<M>(body: Body<M>, profile: BodyProfile): BodyProblem[];
+/** 書き手と AI への Markdown の説明（使用できるものを記法の例つきで列挙し、使用できないものは末尾） */
+export declare function describeMarkdown<M>(profile: BodyProfile, components?: readonly ComponentDef<M>[]): string;
+export {};

package/dist/types/body/src/schema.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { type DeclaredComponent } from './declared.js';
+import { type BodyProfile } from './profile.js';
+import type { Block } from './types.js';
+/** 本文の1ブロックの検査（profile は本文の設定、media は画像の参照の検査、declared は導入先が宣言した部品） */
+export declare function blockSchemaOf<M>(profile: BodyProfile, media: z.ZodType<M>, declared?: readonly DeclaredComponent[]): z.ZodType<Block<M>>;

package/dist/types/body/src/standard.d.ts

@@ -0,0 +1,20 @@
+import { type DeclaredComponent } from './declared.js';
+import { type MarkdownOptions } from './markdown.js';
+import { type BodyProfile } from './profile.js';
+import type { Body } from './types.js';
+/** 画像の参照と Markdown の文字列の変換（example は説明の例の参照） */
+export type MediaSyntax<M> = MarkdownOptions<M>['media'] & Readonly<{
+    example: string;
+}>;
+/** Markdown の解析の結果（problems は設定に合わない箇所のすべて） */
+export type MarkdownResult<M> = Readonly<{
+    body: Body<M>;
+}> | Readonly<{
+    problems: readonly string[];
+}>;
+/** 本文を Markdown に（declared は導入先が宣言した部品） */
+export declare const bodyToMarkdown: <M>(body: Body<M>, media: MediaSyntax<M>, declared?: readonly DeclaredComponent[]) => string;
+/** Markdown を本文に（解析できない・設定に合わない内容は problems、declared は導入先が宣言した部品） */
+export declare function bodyFromMarkdown<M>(markdown: string, profile: BodyProfile, media: MediaSyntax<M>, declared?: readonly DeclaredComponent[]): MarkdownResult<M>;
+/** 書き手と AI へ最初に提示する Markdown の説明（設定と核のコンポーネント・宣言した部品から作成） */
+export declare const markdownGuide: (profile: BodyProfile, media: Pick<MediaSyntax<unknown>, "example">, declared?: readonly DeclaredComponent[]) => string;

package/dist/types/body/src/types.d.ts

@@ -0,0 +1,91 @@
+/** インラインの装飾（strong・em・code・s・mark・sup・sub） */
+export type Mark = 'strong' | 'em' | 'code' | 'strike' | 'mark' | 'sup' | 'sub';
+/** リンク（HTML の a の href・title・rel） */
+export type Link = Readonly<{
+    href: string;
+    title?: string;
+    rel?: string;
+}>;
+/** 装飾・リンクつきの文字列 */
+export type Text = Readonly<{
+    text: string;
+    marks?: readonly Mark[];
+    link?: Link;
+}>;
+/** インラインのコンポーネント（例: 注、属性は文字列だけ、text は中の文字） */
+export type InlineComponent = Readonly<{
+    component: string;
+    props?: Readonly<Record<string, string>>;
+    text?: string;
+}>;
+/** インラインの断片（文字列は装飾なし） */
+export type Inline = string | Text | InlineComponent;
+/** インラインの断片の列（1つの段落・見出し・セルの内容） */
+export type Rich = readonly Inline[];
+/** 見出しの段階 */
+export type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+/** リストの1項目（children は入れ子のリスト） */
+export type ListItem = Readonly<{
+    content: Rich;
+    children?: List;
+}>;
+/** リスト */
+export type List = Readonly<{
+    type: 'list';
+    ordered?: boolean;
+    items: readonly ListItem[];
+    variant?: string;
+}>;
+/** 標準のブロック */
+export type StandardBlock<M> = Readonly<{
+    type: 'paragraph';
+    content: Rich;
+    variant?: string;
+}> | Readonly<{
+    type: 'heading';
+    level: HeadingLevel;
+    content: Rich;
+    id?: string;
+    variant?: string;
+}> | List | Readonly<{
+    type: 'quote';
+    content: readonly Rich[];
+    cite?: Readonly<{
+        label: string;
+        href?: string;
+    }>;
+    variant?: string;
+}> | Readonly<{
+    type: 'code';
+    code: string;
+    lang?: string;
+    caption?: string;
+    variant?: string;
+}> | Readonly<{
+    type: 'image';
+    media: M;
+    alt?: string;
+    caption?: string;
+    variant?: string;
+}> | Readonly<{
+    type: 'table';
+    head?: readonly Rich[];
+    rows: readonly (readonly Rich[])[];
+    caption?: string;
+    variant?: string;
+}> | Readonly<{
+    type: 'divider';
+}> | Readonly<{
+    type: 'html';
+    html: string;
+}>;
+/** カスタムコンポーネントのブロック（props は JSON で表せる値） */
+export type ComponentBlock = Readonly<{
+    type: 'component';
+    name: string;
+    props: unknown;
+}>;
+/** 本文のブロック */
+export type Block<M> = StandardBlock<M> | ComponentBlock;
+/** 本文 */
+export type Body<M> = readonly Block<M>[];

package/dist/types/cms-contract/src/apiKeys.d.ts

@@ -0,0 +1,13 @@
+/** 一覧に表示する API の鍵（tail は鍵の末尾、revokedAt は失効の日時で有効なら null） */
+export type ApiKey = Readonly<{
+    id: string;
+    label: string;
+    tail: string;
+    createdAt: string;
+    revokedAt: string | null;
+}>;
+/** 公開のエンドポイントで鍵ごとの回数の上限（period は秒） */
+export declare const API_KEY_RATE: {
+    readonly limit: 600;
+    readonly period: 60;
+};

package/dist/types/cms-contract/src/assets.d.ts

@@ -0,0 +1,10 @@
+/** まとめての削除・元に戻すで1回のリクエストに指定できる画像の数（超える分は管理画面が分割して送信） */
+export declare const ASSET_BULK_MAX = 500;
+/**
+ * アップロード・取り込みで受け付ける画像の形式（判定はファイルの先頭のバイト、申告の種類は不使用）
+ * - SVG: スクリプトを含められ、CMS のオリジンで配信すると実行されうるため対象外
+ * - AVIF: OG 画像の生成（photon）が非対応のため対象外
+ */
+export declare const ASSET_IMAGE_TYPES: readonly ["image/jpeg", "image/png", "image/webp", "image/gif"];
+/** 画像1枚の大きさの上限（バイト、アップロード・取り込みで共通） */
+export declare const ASSET_SIZE_MAX: number;

package/dist/types/cms-contract/src/builtins.d.ts

@@ -0,0 +1,17 @@
+import type { ModuleManifest } from './modules.js';
+/** 計測（閲覧数の集計・ダッシュボードの閲覧数） */
+export declare const ANALYTICS_MODULE: ModuleManifest;
+/** OG 画像の自動生成で選択できる書体（id と表示名、文字の範囲はサーバーの側の OG 画像のモジュール） */
+export declare const OG_FONTS: {
+    readonly 'noto-serif-jp': "Noto Serif JP（明朝）";
+};
+/** OG 画像の書体の id */
+export type OgFont = keyof typeof OG_FONTS;
+/** OG 画像の設定値（font は自動生成の画像の書体、なしは書体の点検なし） */
+export type OgSettings = Readonly<{
+    font?: OgFont;
+}>;
+/** OG 画像（自動生成の画像に付く規則、導入先の設定 modules の og に書体） */
+export declare const OG_MODULE: ModuleManifest<OgSettings>;
+/** コアに組み込みのモジュール（登録の順） */
+export declare const BUILTIN_MODULES: readonly ModuleManifest<unknown>[];

package/dist/types/cms-contract/src/embeds.d.ts

@@ -0,0 +1,56 @@
+/** 外の画面を表示する位置（編集画面のパネル） */
+export declare const EMBED_PLACEMENTS: readonly ["panel"];
+/** 外の画面を表示する位置 */
+export type EmbedPlacement = (typeof EMBED_PLACEMENTS)[number];
+/** 外の画面の登録（secret は末尾だけを伏せずに返す） */
+export type ExternalScreen = Readonly<{
+    id: string;
+    label: string;
+    type: string;
+    url: string;
+    placement: EmbedPlacement;
+    secret: string;
+    enabled: boolean;
+}>;
+/** 編集画面に置く外の画面（鍵なし、編集できるアカウントに返す） */
+export type EmbedEntry = Readonly<{
+    id: string;
+    label: string;
+    url: string;
+    placement: EmbedPlacement;
+}>;
+/** 署名つきの文脈の内容（id は行の ID で新規は null、origin は管理画面のオリジン） */
+export type EmbedContext = Readonly<{
+    tenant: string;
+    account: Readonly<{
+        id: string;
+        role: string;
+    }>;
+    type: string;
+    id: string | null;
+    origin: string;
+}>;
+/** URL のクエリの名前（署名つきの文脈） */
+export declare const EMBED_CONTEXT_PARAM = "ctx";
+/** 文脈の有効期間（秒） */
+export declare const EMBED_CONTEXT_TTL_SEC = 600;
+/** postMessage の種類 */
+export declare const EMBED_MESSAGES: {
+    readonly ready: "maezae:ready";
+    readonly values: "maezae:values";
+    readonly set: "maezae:set";
+    readonly height: "maezae:height";
+};
+/** 外の画面と管理画面の間のメッセージ */
+export type EmbedMessage = Readonly<{
+    type: typeof EMBED_MESSAGES.ready;
+}> | Readonly<{
+    type: typeof EMBED_MESSAGES.values;
+    values: Readonly<Record<string, unknown>>;
+}> | Readonly<{
+    type: typeof EMBED_MESSAGES.set;
+    values: Readonly<Record<string, unknown>>;
+}> | Readonly<{
+    type: typeof EMBED_MESSAGES.height;
+    height: number;
+}>;

package/dist/types/cms-contract/src/errorLabels.d.ts

@@ -0,0 +1,22 @@
+import { type ErrorCode, type ErrorParams, type ErrorTarget } from './errors.js';
+/** コアの対象の表示名（エラーの文と操作の履歴で共通、モジュールの対象は ModuleManifest の targets） */
+export declare const TARGET_LABELS: Record<ErrorTarget, string>;
+/** 型の id・マスタの種類からエラーの対象（対象の一覧になければ fallback） */
+export declare const targetOf: (id: string, fallback: ErrorTarget) => ErrorTarget;
+/**
+ * 対象ごとの文の追加（モジュールの manifest の messages、キーは対象の id）
+ * - own: 自分のものだけを操作できるときの文
+ * - noLink: 結び付くエントリーがないアカウントの文、{name} は結び付くコンテンツタイプの表示名
+ */
+export type TargetMessages = Readonly<{
+    own?: Readonly<Record<string, string>>;
+    noLink?: Readonly<Record<string, string>>;
+}>;
+/** エラーの文（targets は対象の表示名、messages は対象ごとの文の追加、サーバーはモジュールの対象と文を含めた表） */
+export declare const errorLabel: (code: ErrorCode, params?: ErrorParams, targets?: Readonly<Record<string, string>>, messages?: TargetMessages) => string;
+/** モジュールの対象ごとの文をまとめる（同じ対象はあとのモジュールの文） */
+export declare const mergeMessages: (list: readonly (TargetMessages | undefined)[]) => TargetMessages;
+/** エラーのトーストの見出し（項目ごとの理由がすべて未入力なら必須項目のエラー、スキーマの文は「〜が未入力」で統一） */
+export declare const errorTitle: (code: ErrorCode, issues?: readonly {
+    message: string;
+}[]) => string;

package/dist/types/cms-contract/src/errors.d.ts

@@ -0,0 +1,97 @@
+/** 変更の操作で受け付ける本文の大きさ（/api、バイト数、multipart のアップロードは ASSET_SIZE_MAX） */
+export declare const JSON_BODY_MAX: number;
+/** エラーのコードと HTTP の状態 */
+export declare const ERROR_STATUS: {
+    readonly invalid_input: 400;
+    readonly submit_unmet: 400;
+    readonly publish_unmet: 400;
+    readonly save_unmet: 403;
+    readonly version_required: 400;
+    readonly file_required: 400;
+    readonly file_too_large: 400;
+    readonly unsupported_image: 400;
+    readonly invalid_dimensions: 400;
+    readonly https_required: 400;
+    readonly invalid_style: 400;
+    readonly login_required: 401;
+    readonly invalid_mcp_token: 401;
+    readonly preview_token_required: 401;
+    readonly api_key_required: 401;
+    readonly invalid_api_key: 401;
+    readonly account_not_found: 403;
+    readonly invalid_preview_token: 403;
+    readonly mcp_not_allowed: 403;
+    readonly admin_only: 403;
+    readonly forbidden: 403;
+    readonly editorial_only: 403;
+    readonly no_linked_entry: 403;
+    readonly own_only: 403;
+    readonly not_visible: 403;
+    readonly published_admin_only: 403;
+    readonly cannot_remove_self: 403;
+    readonly cannot_change_owner: 403;
+    readonly not_found: 404;
+    readonly read_only: 405;
+    readonly in_use: 409;
+    readonly duplicate_name: 409;
+    readonly duplicate_email: 409;
+    readonly duplicate_id: 409;
+    readonly version_conflict: 409;
+    readonly article_editing: 409;
+    readonly invalid_state: 409;
+    readonly unpublish_first: 409;
+    readonly body_too_large: 413;
+    readonly rate_limited: 429;
+    readonly upstream_failed: 502;
+    readonly not_configured: 503;
+    readonly unavailable: 503;
+    readonly job_failed: 500;
+    readonly internal_error: 500;
+    readonly network_error: 0;
+};
+/** エラーのコード（network_error は画面の側だけ、通信の失敗と JSON でない応答） */
+export type ErrorCode = keyof typeof ERROR_STATUS;
+/**
+ * コアの操作や表示の対象（not_found・own_only などの params.target）
+ * - 型の対象: 型の id、表示名はスキーマ
+ * - モジュールの対象: ModuleManifest の targets
+ */
+export type ErrorTarget = 'request' | 'role' | 'media' | 'entry' | 'asset' | 'mcp' | 'version' | 'profile' | 'portrait' | 'extension' | 'account' | 'comment' | 'view' | 'webhook' | 'external_function' | 'external_screen' | 'api_key';
+/** エラーの補足の値（コードごとに使用する項目だけ） */
+export type ErrorParams = {
+    /**
+     * 対象: not_found・own_only・forbidden・not_visible・no_linked_entry・editorial_only
+     * - 文字列: モジュールの対象・コンテンツタイプの id
+     */
+    target?: ErrorTarget | (string & {});
+    /** 件数: in_use */
+    count?: number;
+    /** 使用先: in_use */
+    by?: 'uses' | 'places' | 'outputs' | 'entry' | 'writers' | 'members' | 'accounts';
+    /** 状態の不一致の理由: invalid_state */
+    reason?: 'not_draft' | 'not_in_review' | 'request_handled' | 'deleted' | 'not_deleted' | 'schema_confirm' | 'no_publishing' | 'no_review';
+    /** 取得の対象: upstream_failed */
+    resource?: 'page' | 'image' | 'webhook';
+    /**
+     * 名前
+     * - no_linked_entry: 結び付くコンテンツタイプの表示名、account_not_found: メールアドレス
+     * - not_configured: 設定の名前、job_failed: 失敗の理由、in_use の entry: 参照する型と項目
+     */
+    name?: string;
+};
+/**
+ * エラーの応答の本文
+ * - login: ログインなしのとき、CMS 自身が受け持つログインの入り口
+ * - requestId: 5xx の相関の ID（問い合わせのときにログと突き合わせ）
+ */
+export type ErrorBody = {
+    code: ErrorCode;
+    params?: ErrorParams;
+    issues?: {
+        path: string;
+        message: string;
+    }[];
+    login?: string;
+    requestId?: string;
+    error: string;
+};