@ryusenkei/maezae 0.1.0 → 0.3.0

package/dist/types/delivery-client/src/client.d.ts

@@ -0,0 +1,62 @@
+import type { ContentType } from '../../model/src/index.js';
+import { type ListQuery, type Page } from './query.js';
+/** 配信 API のパスの前半 */
+export declare const DELIVERY_PATH = "/content/v1";
+/** 配信 API への接続（path は /content/v1 から始まるパスとクエリ） */
+export type Delivery = (path: string, init?: RequestInit) => Promise<Response>;
+/** 一式の経路ごとの結果（body は経路の応答の JSON） */
+export type BundleResult = Readonly<{
+    status: number;
+    body: unknown;
+}>;
+/**
+ * 一式の取得の結果
+ * - notModified: ETag が一致、etag: 応答の ETag、stale: 失敗のため最後に成功した値
+ * - partial: 一部の経路が 5xx の一式 x-partial（最後に成功した値や描画の結果として保存しない）
+ */
+export type Prefetched = Readonly<{
+    notModified: boolean;
+    etag: string | null;
+    stale: boolean;
+    partial: boolean;
+}>;
+/** 配信 API の取得の失敗（call: 失敗した経路、status: 応答のステータス） */
+export declare class DeliveryError extends Error {
+    readonly call: string;
+    readonly status: number;
+    constructor(call: string, status: number, body: string);
+}
+/** 配信 API の中のパスとクエリ（一式の path と結果のキー） */
+export declare const subPath: (path: string, params?: Readonly<Record<string, string>>) => string;
+/**
+ * 配信 API の読み取り
+ * - drafts: 下書き・予約なども含める（プレビュー用、署名は接続の側で付与）
+ * - at: 公開の基準の日時（なしは今）
+ */
+export declare function createDeliveryClient(delivery: Delivery, { drafts, at }?: {
+    drafts?: boolean;
+    at?: string;
+}): {
+    find: <T>(path: string, params?: Readonly<Record<string, string>>) => Promise<T | undefined>;
+    get: <T>(path: string, params?: Readonly<Record<string, string>>) => Promise<T>;
+    page: <I = Readonly<Record<string, unknown>>, T extends ContentType = Readonly<{
+        id: string;
+        label: string;
+        description?: string;
+        format?: import("../../model/src/index.js").ContentFormat;
+        publishing?: import("../../model/src/index.js").Publishing;
+        table?: string;
+        core?: readonly import("../../model/src/index.js").FieldDef[];
+        fields: readonly import("../../model/src/index.js").FieldDef[];
+        pages?: readonly import("../../model/src/index.js").PageDef[];
+        counts?: readonly import("../../model/src/index.js").CountDef[];
+        og?: string;
+    }>>(path: string, query: ListQuery<T> & Readonly<{
+        limit: number;
+    }>) => Promise<Page<I>>;
+    prefetch: (paths: readonly string[], { ifNoneMatch }?: {
+        ifNoneMatch?: string;
+    }) => Promise<Prefetched>;
+};
+/** 配信 API の読み取り（createDeliveryClient の戻り値） */
+export type DeliveryClient = ReturnType<typeof createDeliveryClient>;

package/dist/types/delivery-client/src/index.d.ts

@@ -0,0 +1,5 @@
+export { createDeliveryClient, DELIVERY_PATH, DeliveryError, subPath, type BundleResult, type Delivery, type DeliveryClient, type Prefetched } from './client.js';
+export { mediaOf, type ImageUrl, type MediaOf } from './media.js';
+export { listParams, type ListFilter, type ListQuery, type Page } from './query.js';
+export { createDeliveryClock, fieldOf, limitOf, optionLabels, pagePath, type DeliveryClock } from './schema.js';
+export type { DeliveredAsset, FieldValue, Item, ItemOf } from './values.js';

package/dist/types/delivery-client/src/media.d.ts

@@ -0,0 +1,12 @@
+import { type CropRect, type Media } from '../../model/src/index.js';
+/** 配信する画像の URL（元の URL と、元画像の画素での切り抜きの範囲から、配信の側で変換する URL） */
+export type ImageUrl = (src: string, rect?: CropRect) => string;
+/** 実体から表示の素材（見つからない実体はなし） */
+export type MediaOf = (asset: unknown) => Media | undefined;
+/**
+ * 実体から表示の素材への変換（動画は代わりの画像も）
+ * - base: 実体の URL の前半（URL は base/<ID>）
+ * - 画像の変換: imageUrl があれば画像（動画の実体は除く）を変換の URL に、切り抜きは切り抜いた画像の URL・寸法・見せたい点
+ * - imageUrl なし: 元の画像のまま（手元の開発）
+ */
+export declare function mediaOf(base: string, imageUrl?: ImageUrl): MediaOf;

package/dist/types/delivery-client/src/query.d.ts

@@ -0,0 +1,68 @@
+import type { ContentType, FieldDef } from '../../model/src/index.js';
+import type { FieldsOf, Item, SingleValue } from './values.js';
+/** 範囲の指定（両端を含む） */
+type Range<V> = Readonly<{
+    gte?: V;
+    lte?: V;
+}>;
+type Scalar<F extends FieldDef> = NonNullable<SingleValue<F>>;
+/** 項目の種類ごとの絞り込みの値（選択肢・参照は一致か in、チェックボックスは一致、数値・日付は一致か範囲、日時は範囲） */
+type FilterValue<F extends FieldDef> = F extends {
+    private: true;
+} ? never : F extends {
+    type: 'select' | 'reference';
+} ? Scalar<F> | Readonly<{
+    in: readonly Scalar<F>[];
+}> : F extends {
+    type: 'checkbox';
+} ? boolean : F extends {
+    type: 'number' | 'date';
+} ? Scalar<F> | Range<Scalar<F>> : F extends {
+    type: 'datetime';
+} ? Range<string> : never;
+/** 並べ替えできる項目の key（単数の文字・数値・日付・日時・選択肢・チェックボックス） */
+type SortableKey<T extends ContentType> = FieldsOf<T> extends infer F ? (F extends {
+    private: true;
+} | {
+    multiple: true;
+} ? never : F extends {
+    type: 'text' | 'number' | 'date' | 'datetime' | 'select' | 'checkbox';
+    key: infer K extends string;
+} ? K : never) : never;
+/** 並べ替えの key（項目・公開日時・更新日時・id） */
+type OrderKey<T extends ContentType> = SortableKey<T> | 'published_at' | 'updated_at' | 'id';
+/** 絞り込みの指定（項目の key ごと、公開日時・更新日時は範囲） */
+export type ListFilter<T extends ContentType = ContentType> = Readonly<{
+    [F in FieldsOf<T> as [FilterValue<F>] extends [never] ? never : F['key']]?: FilterValue<F>;
+} & {
+    published_at?: Range<string>;
+    updated_at?: Range<string>;
+}>;
+/**
+ * 型の一覧の指定
+ * - limit: 1ページの件数（サーバーの上限は100）
+ * - cursor: 前のページの next
+ * - order: 並べ替えの key の配列（`-` の接頭辞で降順、最後に id を自動で追加）
+ * - filter: 項目の key ごとの絞り込み（複数の値の項目は値を含む行）
+ */
+export type ListQuery<T extends ContentType = ContentType> = Readonly<{
+    limit?: number;
+    cursor?: string | null;
+    order?: readonly (OrderKey<T> | `-${OrderKey<T>}`)[];
+    filter?: ListFilter<T>;
+}>;
+/** ページ送りの応答（next は次のページの cursor、最後のページは null） */
+export type Page<I = Item> = Readonly<{
+    items: readonly I[];
+    next: string | null;
+}>;
+/** どの型の一覧の指定も受け取る形（型の検査は ListQuery の側） */
+type QueryShape = Readonly<{
+    limit?: number;
+    cursor?: string | null;
+    order?: readonly string[];
+    filter?: Readonly<Record<string, unknown>>;
+}>;
+/** 一覧の指定をクエリの組に（find・get・subPath の params、一式の path に使用） */
+export declare function listParams(query: QueryShape): Record<string, string>;
+export {};

package/dist/types/delivery-client/src/schema.d.ts

@@ -0,0 +1,19 @@
+import { type Clock, type ContentModel, type DateString, type FieldDef, type PageEntry } from '../../model/src/index.js';
+/** 選択肢の項目から表示名の表（値 → 表示名、key はまとまりの中なら `links.kind` の形、選択肢の項目でなければ空） */
+export declare const optionLabels: <K extends string = string>(schema: ContentModel, type: string, key: string) => Readonly<Record<K, string>>;
+/** 型の項目（コアの項目と追加の項目から、なければ例外: 導入先の設定の誤り） */
+export declare function fieldOf(schema: ContentModel, type: string, key: string): FieldDef;
+/** 項目の宣言の上限（宣言がなければ例外） */
+export declare function limitOf(field: FieldDef, name: 'maxItems' | 'maxLength'): number;
+/** ページのパス（型の宣言 pages から、ページのない型は例外） */
+export declare function pagePath(schema: ContentModel, type: string, entry: PageEntry): string;
+/** 媒体のタイムゾーンでの日時の変換（表示用の日付と日時の組 dated を含む） */
+export type DeliveryClock = Clock & Readonly<{
+    /** 日時の項目から、表示用のタイムゾーンの日付と `ISO 8601` の日時（日時の形でない値はそのまま） */
+    dated: (value: string) => Readonly<{
+        date: DateString;
+        at: string;
+    }>;
+}>;
+/** 日時の変換を作成（timeZone は媒体の設定にある IANA の名前） */
+export declare function createDeliveryClock(timeZone: string): DeliveryClock;

package/dist/types/delivery-client/src/values.d.ts

@@ -0,0 +1,63 @@
+import type { Body } from '../../body/src/index.js';
+import type { ContentType, Crop, DateString, FieldDef, Hotspot } from '../../model/src/index.js';
+/** 配信 API の1件の値（項目の key と id・updated_at） */
+export type Item = Readonly<Record<string, unknown>>;
+/** 配信 API が解決した実体（hotspot・crop は元の画像に対する割合） */
+export type DeliveredAsset = Readonly<{
+    id: string;
+    kind: 'image' | 'video';
+    width: number;
+    height: number;
+    alt: string;
+    hotspot?: Hotspot;
+    crop?: Crop;
+    poster?: DeliveredAsset | null;
+}>;
+/** 項目の1つ分の値（複数の値を持つ項目は FieldValue が配列に、query.ts の絞り込みの値と共通） */
+export type SingleValue<F extends FieldDef> = F extends {
+    type: 'text' | 'textarea';
+} ? string : F extends {
+    type: 'number';
+} ? number : F extends {
+    type: 'checkbox';
+} ? boolean : F extends {
+    type: 'date';
+} ? DateString : F extends {
+    type: 'datetime';
+} ? string : F extends {
+    type: 'select';
+    options: readonly (infer O extends {
+        value: string;
+    })[];
+} ? O['value'] : F extends {
+    type: 'reference';
+} ? string : F extends {
+    type: 'media';
+} ? DeliveredAsset | null : F extends {
+    type: 'body';
+} ? Body<DeliveredAsset | null> : F extends {
+    type: 'group';
+    fields: readonly (infer G extends FieldDef)[];
+} ? GroupValue<G> : unknown;
+/** まとまりの値（中の項目の key ごと） */
+type GroupValue<G extends FieldDef> = {
+    readonly [K in G as K['key']]: FieldValue<K>;
+};
+/**
+ * 項目の値（種類ごと: 文字は string、日付は YYYY-MM-DD、日時は `ISO 8601` の UTC、参照は参照先の id、メディアは実体、本文は標準のブロック）
+ * - multiple の項目: 値の配列
+ * - 値なし: null
+ */
+export type FieldValue<F extends FieldDef> = (F extends {
+    multiple: true;
+} ? readonly SingleValue<F>[] : SingleValue<F>) | null;
+/** 型の項目（コアの項目と追加の項目） */
+export type FieldsOf<T extends ContentType> = (T['core'] extends readonly (infer C extends FieldDef)[] ? C : never) | T['fields'][number];
+/** 型の宣言から導く1件の値（id・更新日時と、項目の key ごとの値） */
+export type ItemOf<T extends ContentType> = Readonly<{
+    id: string;
+    updated_at: string;
+} & {
+    [F in FieldsOf<T> as F['key']]: FieldValue<F>;
+}>;
+export {};

package/dist/types/model/src/asset.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+/**
+ * 見せたい点（Sanity の hotspot、値はすべて画像に対する割合の0〜1、左上が0,0）
+ * - x・y: 中心（枠に合わせて切り抜くときの中心、なしは中央）
+ * - width・height: 範囲の大きさ（今の表示は中心だけを使用）
+ * - 切り抜き crop がある画像: CMS で保存する値は元の画像に対する割合、表示の Media では切り抜いた後の画像に対する割合
+ */
+export type Hotspot = Readonly<{
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+}>;
+/** 切り抜き（Sanity の crop、上下左右の各辺から削る量を画像に対する割合の0〜1で） */
+export type Crop = Readonly<{
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}>;
+/** サイトのビルドで読み込んだ画像（Astro の ImageMetadata と同じ形、画像の最適化の対象） */
+export type LocalImage = Readonly<{
+    src: string;
+    width: number;
+    height: number;
+    format: string;
+}>;
+/** 実体の共通の項目（ID は UUID で R2 のキーと同じ、sha256 は内容のハッシュで同じ画像の重複を防止、ファイル名は保存しない） */
+type AssetBase = Readonly<{
+    id: string;
+    mimeType: string;
+    size: number;
+    sha256: string | null;
+    width: number;
+    height: number;
+    alt: string;
+    hotspot?: Hotspot;
+    crop?: Crop;
+    createdAt: string;
+}>;
+/** 画像の実体（Sanity の sanity.imageAsset、代替テキストと hotspot は画像ごとに1つ） */
+export type ImageAsset = AssetBase & Readonly<{
+    kind: 'image';
+}>;
+/** 動画の実体（poster は代わりに表示する画像の実体の ID、配信と再生は最初に使用する場所が決まったときに実装） */
+export type VideoAsset = AssetBase & Readonly<{
+    kind: 'video';
+    duration?: number;
+    poster?: string;
+}>;
+/** 実体（CMS のメディアにある1件） */
+export type Asset = ImageAsset | VideoAsset;
+/** 使用する側が保存する実体の参照（Sanity の image の asset、表示のときに実体の寸法・代替テキスト・hotspot を合わせて Media に解決） */
+export type AssetRef = Readonly<{
+    asset: string;
+}>;
+/**
+ * 表示する素材の共通の項目
+ * - src: URL（CMS の実体）か、ビルドで読み込んだ画像
+ * - width・height: 元の寸法（表示の比と、読み込み前の場所の確保）
+ * - alt: 代替テキスト（飾りの画像は空文字）
+ */
+type MediaBase = Readonly<{
+    src: string | LocalImage;
+    width: number;
+    height: number;
+    alt: string;
+    hotspot?: Hotspot;
+}>;
+/**
+ * 表示の素材（使用する側の型で共通、実体の参照 AssetRef を解決した値）
+ * - `image`: 画像
+ * - `video`: 動画（poster は読み込み前・動きを抑える設定・OG で代わりに表示する画像、再生の仕方は使用する場所で決定）
+ */
+export type Media = MediaBase & Readonly<{
+    kind: 'image';
+} | {
+    kind: 'video';
+    poster: MediaBase;
+}>;
+/** 見せたい点の検査 */
+export declare const hotspotSchema: z.ZodType<Hotspot>;
+/** 切り抜きの検査（残る幅と高さが画像の1割以上） */
+export declare const cropSchema: z.ZodType<Crop>;
+/** 解決後の素材の検査（src は URL、ビルドで読み込んだ画像は JSON に含めないため対象外） */
+export declare const mediaSchema: z.ZodType<Media>;
+/** 使用する側が保存する実体の参照の検査 */
+export declare const assetRefSchema: z.ZodType<AssetRef>;
+export {};

package/dist/types/model/src/capabilities.d.ts

@@ -0,0 +1,20 @@
+import type { ContentModel, ContentType } from './model.js';
+/**
+ * コアの表の性質
+ * - editorial: 編集の機能の列 status・published_at・version・review_note・assignee
+ * - derived: 本文から保存時に作成する列 excerpt・read_min・links
+ * - sources: 共有の行（出典）を付属の表 article_sources で結び付ける
+ * - shared: 共有の行を持つ表（複数の行から結び付ける）
+ */
+export type TableTraits = Readonly<{
+    editorial: boolean;
+    derived: boolean;
+    sources: boolean;
+    shared: boolean;
+}>;
+/** 表の性質（コアの表にない表はすべてなし） */
+export declare const tableTraitsOf: (table: string | null | undefined) => TableTraits;
+/** 表の性質を持つ型（スキーマの順で先頭、なければ null: コアの表は1つの型だけが保存） */
+export declare const typeWithTrait: (model: ContentModel, trait: keyof TableTraits) => ContentType | null;
+/** 表の性質を持つ型（なければ例外: その型を前提にする画面・処理だけが使用） */
+export declare function requiredTypeWithTrait(model: ContentModel, trait: keyof TableTraits): ContentType;

package/dist/types/model/src/changes.d.ts

@@ -0,0 +1,23 @@
+import type { ContentModel } from './model.js';
+/** 変更の扱い */
+export type ChangeLevel = 'safe' | 'confirm' | 'forbidden';
+/** 変更の種類 */
+export type ChangeKind = 'type-added' | 'type-removed' | 'type-changed' | 'format-changed' | 'publishing-changed' | 'publishing-removed' | 'fixed-changed' | 'field-added' | 'field-removed' | 'field-changed' | 'field-type-changed' | 'field-key-reused' | 'required-added' | 'constraint-tightened' | 'option-added' | 'option-removed' | 'component-added' | 'component-changed' | 'component-removed';
+/** スキーマの1つの変更（id は確認と置き換え先の指定で使用する識別子、path は項目の key を `.` で連結、value は削除した選択肢の値） */
+export type SchemaChange = Readonly<{
+    id: string;
+    level: ChangeLevel;
+    kind: ChangeKind;
+    type: string;
+    path?: string;
+    value?: string;
+    message: string;
+}>;
+/** 差分の条件（fixed はコードで固定の定義、history は保存済みの版より古い過去の版） */
+export type DiffOptions = Readonly<{
+    fixed?: ContentModel;
+    history?: readonly ContentModel[];
+}>;
+/** 保存済みの版 prev から新しい定義 next への変更（型の順、項目の順） */
+export declare function diffSchema(prev: ContentModel, next: ContentModel, options?: DiffOptions): SchemaChange[];
+export declare function withFixed(fixed: ContentModel, stored: ContentModel): ContentModel;

package/dist/types/model/src/check.d.ts

@@ -0,0 +1,10 @@
+import type { DeclaredComponent } from '../../body/src/index.js';
+import type { ContentType, FieldDef, FieldProblem } from './model.js';
+/** 項目が値の組に当てはまるか（条件なしは常に当てはまる、values は同じ階層の値） */
+export declare const appliesTo: (field: FieldDef, values: Readonly<Record<string, unknown>>) => boolean;
+/** 値の組に当てはまる項目だけ */
+export declare const fieldsFor: <F extends FieldDef>(fields: readonly F[], values: Readonly<Record<string, unknown>>) => F[];
+/** 値を型の定義で検査（stage は保存か提出、提出は保存の必須も含む、まとまりの中は path を key・行の番号で連結、components はスキーマで宣言した本文の部品） */
+export declare const checkFields: (type: ContentType, values: Readonly<Record<string, unknown>>, stage: "save" | "submit", components?: readonly DeclaredComponent[]) => FieldProblem[];
+/** 配列でないオブジェクトか */
+export declare const isRecord: (v: unknown) => v is Readonly<Record<string, unknown>>;

package/dist/types/model/src/image.d.ts

@@ -0,0 +1,38 @@
+import type { Crop, Hotspot, Media } from './asset.js';
+/** 静止画として表示する画像（動画は代わりの画像 poster） */
+export declare const stillOf: (media: Media) => Readonly<{
+    src: string | import("./asset.js").LocalImage;
+    width: number;
+    height: number;
+    alt: string;
+    hotspot?: Hotspot;
+}>;
+/** 見せたい点を CSS の object-position に（なしは undefined で中央、枠の比が分からない表示の代わり） */
+export declare const objectPosition: (hotspot?: Hotspot) => string | undefined;
+/**
+ * 枠を覆う表示で、枠に見える範囲（窓）の始まりの位置: 1次元、画像に対する割合で0〜1 - window
+ * - 見せたい範囲の中心を窓の中央に寄せ、画像の端を越えるときは端と同じ位置
+ * - 範囲が窓に収まる大きさなら、この位置で範囲は必ず窓に入る（範囲が窓より大きいときは範囲の中央を表示）
+ * - center なしは中央、CMS のプレビュー（apps/admin の crop.ts）とサイトの表示で共通
+ */
+export declare function coverStart(center: number | undefined, window: number): number;
+/**
+ * 枠を覆う表示（object-fit: cover）の object-position: 見せたい範囲が枠に入る位置
+ * - size: 画像の幅と高さ、frame: 枠の幅 / 高さ（なしは見せたい点の百分率で代用）
+ * - 帯や余白はなし、枠いっぱいに画像を敷いたまま位置だけを合わせる
+ */
+export declare function coverPosition(hotspot: Hotspot | undefined, size: Readonly<{
+    width: number;
+    height: number;
+}>, frame?: number): string | undefined;
+/** 切り抜いた範囲（元の画像の画素、左上と大きさ、1画素以上） */
+export type CropRect = Readonly<{
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}>;
+/** 切り抜きの割合から、元画像での画素の範囲 */
+export declare function cropRect(width: number, height: number, crop: Crop): CropRect;
+/** 元の画像に対する見せたい点を、切り抜いた後の画像に対する割合に変換（範囲の外は端に寄せる） */
+export declare function croppedHotspot(hotspot: Hotspot, crop: Crop): Hotspot;

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

@@ -0,0 +1,14 @@
+export { fieldZod, jsonSchemaOf, normalizeValues, zodOf, type ValueOptions } from './input.js';
+export { assetRefSchema, cropSchema, hotspotSchema, mediaSchema, type Asset, type AssetRef, type Crop, type Hotspot, type LocalImage, type Media } from './asset.js';
+export { coverPosition, coverStart, cropRect, croppedHotspot, objectPosition, stillOf, type CropRect } from './image.js';
+export { IMAGE_TYPE, VIDEO_TYPE } from './media.js';
+export { diffSchema, withFixed, type ChangeKind, type ChangeLevel, type DiffOptions, type SchemaChange } from './changes.js';
+export { requiredTypeWithTrait, tableTraitsOf, typeWithTrait, type TableTraits } from './capabilities.js';
+export { appliesTo, checkFields, fieldsFor } from './check.js';
+export { deliveredFields, emptyValues, pickValues, referencedIds, referencesOf, valueFieldsOf } from './values.js';
+export { imageFieldOf, initialValueOf, isEditorial, isEntryType, isListType, isSingleton, optionLabelOf, optionsOf, publishingOf, requestReferencesOf, tableOf, titleFieldOf, toneOf, typeOf, type ContentFormat, type ContentModel, type ContentType, type FieldCondition, type FieldDef, type FieldDerive, type FieldFixedBy, type CountDef, type FieldProblem, type MediaKind, type OptionTone, type Publishing, type ReferenceRules, type SelectOption } from './model.js';
+export { hasPublicPage, imageFrameOf, pagePathOf, publicPathOf, type ImageFrame, type ImageFrameDef, type PageDef, type PageEntry, type PageRule } from './page.js';
+export { schemaRulesOf, type SchemaRule } from './rules.js';
+export { parseModel } from './schema.js';
+export { menuItemsOf, parseScreens, placedItemsOf, resolveLayout, resolveMenu, typeItem, typeOfItem, viewItem, viewOfItem, type EditorLayout, type EditorSection, type MenuEntry, type MenuGroup, type ResolvedMenuEntry, type ScreenSettings } from './screens.js';
+export { createClock, isDateOnly, isDateTimeText, type Clock, type DateString } from './time.js';

package/dist/types/model/src/input.d.ts

@@ -0,0 +1,26 @@
+import { type DeclaredComponent } from '../../body/src/index.js';
+import { z } from 'zod';
+import type { FieldDef } from './model.js';
+/** 検査の時点（保存か提出、提出は保存の必須も含む） */
+type Stage = 'save' | 'submit';
+/** 値の検査の設定（toDateTime は日時の変換で、媒体のタイムゾーンを持つ側が指定、components はスキーマで宣言した本文の部品） */
+export type ValueOptions = Readonly<{
+    toDateTime?: (value: string) => string | null;
+    components?: readonly DeclaredComponent[];
+}>;
+/** MCP のツールで入力する1項目の JSON Schema */
+type JsonSchema = Readonly<Record<string, unknown>>;
+/** 1項目の定義から入力の検査を作成（stage が save なら提出の必須は任意、options は日時の変換） */
+export declare function fieldZod(field: FieldDef, stage: Stage, options?: ValueOptions): z.ZodType;
+/** 項目の一覧から入力の検査を作成（key ごとに fieldZod を持つ object） */
+export declare const zodOf: (fields: readonly FieldDef[], stage: Stage, options?: ValueOptions) => z.ZodObject<Record<string, z.ZodType>>;
+/**
+ * 値を保存の形に整形（すべての格納先で共通、まとまりの中も）
+ * - 日時: `ISO 8601` の UTC（options の toDateTime）、本文: 注の記法の変換と未知のキーの除去、メディア: { asset } だけ
+ * - 形の誤りのある値: そのまま（checkFields が検出）
+ * - 定義にないキー・項目を定義しないまとまり: そのまま
+ */
+export declare function normalizeValues(fields: readonly FieldDef[], values: Readonly<Record<string, unknown>>, options: ValueOptions): Record<string, unknown>;
+/** 項目の定義から MCP のツールで入力する JSON Schema を作成（説明は表示名・説明・必須の時点、参照は ID の文字列） */
+export declare function jsonSchemaOf(field: FieldDef): JsonSchema;
+export {};

package/dist/types/model/src/media.d.ts

@@ -0,0 +1,5 @@
+import type { ContentType } from './model.js';
+/** 画像の型 */
+export declare const IMAGE_TYPE: ContentType;
+/** 動画の型（配信と再生は最初に使用する場所が決まったときに実装） */
+export declare const VIDEO_TYPE: ContentType;