@ryusenkei/maezae 0.2.0 → 0.3.1

package/dist/types/access/src/signed.d.ts

@@ -0,0 +1,47 @@
+/** 経路ごとのヘッダーの名前（署名と主体） */
+export declare const SIGNED_HEADERS: {
+    /** MCP → CMS の署名（鍵は MCP_TOKEN） */
+    readonly mcp: "x-mcp-signature";
+    /** MCP → CMS のログインのメールアドレス（署名の主体） */
+    readonly mcpEmail: "x-mcp-email";
+    /** CMS ⇄ サイトのプレビューと下書きの署名（鍵は PREVIEW_TOKEN） */
+    readonly preview: "x-preview-signature";
+    /** CMS → 外の送信先の Webhook・外の関数の署名（鍵は登録ごと、受け手は verifyParts と同じ手順で照合） */
+    readonly outbound: "x-cms-signature";
+};
+/** 署名の対象（body は本文、なしは空） */
+export type SignedParts = Readonly<{
+    method: string;
+    url: string;
+    body?: string | ArrayBuffer | Uint8Array | null;
+    /** 主体（MCP のログインのメールアドレスなど、なしは空） */
+    subject?: string | null;
+}>;
+/** 署名のヘッダーの値（t=<秒>,v1=<署名>） */
+export declare function signParts(secret: string, parts: SignedParts, now?: number): Promise<string>;
+/** 署名の照合（形の誤り・時刻のずれの超過・不一致は false） */
+export declare function verifyParts(secret: string, header: string | null | undefined, parts: SignedParts, { now, maxSkewSec }?: {
+    now?: number;
+    maxSkewSec?: number;
+}): Promise<boolean>;
+/** 署名を付けたヘッダー（init のヘッダーに署名と主体を追加した新しい Headers） */
+export declare function signedHeaders(secret: string, { method, url, body, subject }: SignedParts, { header, subjectHeader, init, now }: Readonly<{
+    header: string;
+    subjectHeader?: string;
+    init?: HeadersInit;
+    now?: number;
+}>): Promise<Headers>;
+/** 署名つきのリクエストを照合する設定 */
+export type VerifyRequestOptions = Readonly<{
+    /** 署名のヘッダーの名前 */
+    header: string;
+    /** 主体のヘッダーの名前（なしは主体なしで照合） */
+    subjectHeader?: string;
+    now?: number;
+}>;
+/** リクエストの署名の照合（本文は複製から読み込み、元のリクエストの本文は残す） */
+export declare function verifyRequest(secret: string | undefined, request: Request, { header, subjectHeader, now }: VerifyRequestOptions): Promise<boolean>;
+/** 期限と署名を付けた値（JSON にできる値、ttlSec は有効な秒数） */
+export declare function sealValue(secret: string, value: unknown, ttlSec: number, now?: number): Promise<string>;
+/** 封印した値（署名の不一致・期限切れ・形の誤りは null） */
+export declare function openValue<T = unknown>(secret: string, token: string | null | undefined, now?: number): Promise<T | null>;

package/dist/types/access/src/span.d.ts

@@ -0,0 +1,23 @@
+import { type TraceContext } from './traceparent.js';
+/** 区間の結果（ok・error、logTracer と同じ値） */
+export type EdgeSpanStatus = 'ok' | 'error';
+/** エントリポイントの区間（context は転送先へ受け渡す自身の区間、traceparent はその値） */
+export type EdgeSpan = Readonly<{
+    context: TraceContext;
+    traceparent: string;
+    /** 応答のステータスの数か例外で終了（500以上・例外は error、2回目以降は無視） */
+    end: (result: number | 'error') => void;
+}>;
+/** エントリポイントの区間の引数（write は1行の出力先、既定は console.info） */
+export type EdgeSpanOptions = Readonly<{
+    name: string;
+    request: Request;
+    sampleRate?: number;
+    write?: (line: string) => void;
+}>;
+/** 記録の割合（0〜1、なし・範囲の外・数でない値は1） */
+export declare const sampleRateOf: (value: string | undefined) => number;
+/** エントリポイントの区間の開始（受け取った traceparent の子か、新しいトレースの根） */
+export declare function startEdgeSpan({ name, request, sampleRate, write }: EdgeSpanOptions): EdgeSpan;
+/** 処理をエントリポイントの区間で包む（応答のステータスか例外で終了、例外は再送出） */
+export declare function withEdgeSpan(options: EdgeSpanOptions, handle: (span: EdgeSpan) => Promise<Response>): Promise<Response>;

package/dist/types/access/src/traceparent.d.ts

@@ -0,0 +1,21 @@
+/** traceparent のヘッダーの名前 */
+export declare const TRACEPARENT_HEADER = "traceparent";
+/** トレースの文脈（traceId は32桁、spanId は呼び出し元の区間の16桁、sampled は記録の対象か） */
+export type TraceContext = Readonly<{
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+}>;
+/** 受け取った traceparent の解釈（なし・形の違反は null） */
+export declare function parseTraceparent(value: string | null | undefined): TraceContext | null;
+/** traceparent の値（版は00） */
+export declare const formatTraceparent: (ctx: TraceContext) => string;
+/** 新しいトレースの ID（32桁） */
+export declare const newTraceId: () => string;
+/** 新しい区間の ID（16桁） */
+export declare const newSpanId: () => string;
+/**
+ * 呼び出し元の区間の文脈（受け取った traceparent があれば同じトレースの子、なければ新しいトレース）
+ * - sampled: 受け取った値のフラグ、新しいトレースは引数（既定は記録の対象）
+ */
+export declare function childTraceContext(incoming: string | null | undefined, sampled?: boolean): TraceContext;

package/dist/types/analytics/src/day.d.ts

@@ -0,0 +1,2 @@
+/** 時間帯 timeZone での日付（YYYY-MM-DD、例: timeZone は Asia/Tokyo） */
+export declare const dayIn: (timeZone: string, at?: Date) => string;

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

@@ -0,0 +1,4 @@
+export { recordView, type Classify, type Dataset } from './record.js';
+export { syncCron } from './schedule.js';
+export { analyticsEngine, type DailyRow, fixedSource, type Source, tenantDaily, type TenantSource } from './source.js';
+export { readDaily, syncDaily } from './store.js';

package/dist/types/analytics/src/record.d.ts

@@ -0,0 +1,22 @@
+/** Analytics Engine のデータセットの binding（書き込みだけ） */
+export type Dataset = {
+    writeDataPoint(point: {
+        blobs?: string[];
+        doubles?: number[];
+        indexes?: string[];
+    }): void;
+};
+/** パスから種類と ID への対応（利用側が定義、例: /articles/<id> は記事） */
+export type Classify = (path: string) => {
+    kind: string;
+    id: string;
+};
+/** 記録の設定（tenant は媒体の識別子） */
+type RecordOptions = {
+    classify: Classify;
+    timeZone: string;
+    tenant?: string;
+};
+/** 閲覧を1件記録（対象: GET で応答が200の HTML・ボット以外、記録の失敗は無視） */
+export declare function recordView(dataset: Dataset | undefined, request: Request, response: Response, { classify, timeZone, tenant }: RecordOptions): void;
+export {};

package/dist/types/analytics/src/schedule.d.ts

@@ -0,0 +1,2 @@
+/** 集計の間隔（分）から Cron の式を算出 */
+export declare function syncCron(minutes: number): string;

package/dist/types/analytics/src/source.d.ts

@@ -0,0 +1,33 @@
+/** 日ごと・種類・ID の閲覧数 */
+export type DailyRow = {
+    date: string;
+    kind: string;
+    id: string;
+    views: number;
+};
+/** 読み込み元の接続の型（since 以降の日付の閲覧数） */
+export type Source = {
+    daily(since: string): Promise<DailyRow[]>;
+};
+/** Analytics Engine の接続の設定（token は Account Analytics の読み取りの API トークン、tenant は絞り込む媒体の識別子） */
+type AnalyticsEngineOptions = {
+    accountId: string;
+    token: string;
+    dataset: string;
+    tenant?: string;
+};
+/** 1回の問い合わせの行数 */
+export declare const PAGE_ROWS = 10000;
+/** 問い合わせの回数の上限（PAGE_ROWS との積が1回で集計できる行数） */
+export declare const MAX_PAGES = 20;
+/** Analytics Engine の SQL API の読み込み元 */
+export declare function analyticsEngine({ accountId, token, dataset, tenant }: AnalyticsEngineOptions): Source;
+/** 全媒体の読み込み元の型（since 以降の日付の閲覧数を媒体の識別子ごとに） */
+export type TenantSource = {
+    dailyByTenant(since: string): Promise<ReadonlyMap<string, DailyRow[]>>;
+};
+/** 全媒体を1回の問い合わせで集計する Analytics Engine の読み込み元（媒体の列が空の記録は除外） */
+export declare function tenantDaily(options: Omit<AnalyticsEngineOptions, 'tenant'>): TenantSource;
+/** 集計済みの行の読み込み元（定期の集計で全媒体の問い合わせ結果を媒体ごとに受け渡し、daily は since 以降の行） */
+export declare const fixedSource: (rows: readonly DailyRow[]) => Source;
+export {};

package/dist/types/analytics/src/store.d.ts

@@ -0,0 +1,24 @@
+import type { DailyRow, Source } from './source.js';
+type Statement = {
+    bind(...values: unknown[]): Statement;
+    all<T = Record<string, unknown>>(): Promise<{
+        results: T[];
+    }>;
+};
+/** D1 の接続の型（D1Database と互換） */
+export type Db = {
+    prepare(sql: string): Statement;
+    batch(statements: Statement[]): Promise<unknown>;
+};
+/** 読み込み元の since 以降の閲覧数を表へ（戻り値は行の数） */
+export declare function syncDaily(source: Source, db: Db, since: string): Promise<number>;
+/** 日付が after より後の閲覧数（live は今日の行を読み込み元から、失敗は表の値のままで failure に例外） */
+export declare function readDaily(db: Db, after: string, live?: {
+    source: Source;
+    today: string;
+}): Promise<{
+    rows: DailyRow[];
+    live: boolean;
+    failure?: unknown;
+}>;
+export {};

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>[];