@ryusenkei/maezae 0.15.0 → 0.17.0

package/README.md

@@ -19,6 +19,9 @@ maezae の SDK（導入先のサイト向け）
 - バインディング: `services: [{ "binding": "CMS", "service": "<CMS のサーバーの Worker>", "entrypoint": "Delivery" }]`
 - 媒体: URL のホスト名（媒体の管理画面のホスト名）
 - 鍵: 媒体の管理画面の「設定 → 連携」で発行した API の鍵
+- 鍵の権限: 鍵ごとに型と操作（公開中の読み取り、下書きの読み取り）を選ぶ。権限のない型の経路は403（`code: "api_key_forbidden"`）
+  - `/types` はどれかの型、`/changes` と拡張機能の経路はすべての型の読み取りが要る。`fields` で展開する参照先の型と、`/bundle` の各 `path` も判定する
+  - 下書きの読み取りを許した鍵は、プレビューの署名なしで `drafts=1` を読める。許していない鍵は今までどおり署名が要る
 - 1件の形: `{ id, ...項目, _meta: { created_at, updated_at, published_at } }`、published_at は公開の管理がある型だけ（0.7.0 から）
 - 一覧: 本文の種類の項目を含めない、本文は1件の取得か `/bundle` で
 - 契約の版: パス `/content/v1` と、すべての応答のヘッダー `x-cms-version: 1`。非互換の変更はバージョン（版）を上げて行う（#495）
@@ -97,6 +100,37 @@ const cards = await client.page<Card>('/post', { limit: 20, fields, filter: { ti
 const one = await client.find<Card>('/post/p1', listParams({ fields }));
 ```
 
+## 変更の一覧（0.16.0 から）
+
+`GET /content/v1/changes?since=<cursor>&limit=N` は、型をまたいだ行の変更を順に返す。検索や静的なビルドのために導入先が自分の側へ写すときの土台で、Webhook の取りこぼし（再送は約55時間半で止まる）もここで回収する
+
+```json
+{ "changes": [{ "type": "post", "id": "p1", "change": "upsert", "event": "published", "at": "2026-11-12T00:00:00.000Z" }], "next": "…", "more": false }
+```
+
+- `since` なしは初回の全件の取得。公開中の全行を `event: "snapshot"` で返し、終わったら記録の続きに移る
+- `change` は取得した時点の状態。`upsert` の行は配信 API で取り直し、`delete` の行は手元から消す。同じ行が何度も現れるので、行ごとに最後の状態で上書きする
+- `event` は記録の出来事（`created`・`updated`・`deleted`・`published`・`unpublished`）。予約の公開は、公開日時を過ぎてから `published` で現れる
+- `next` は変更がなくても返る。保存して次回の `since` に渡す。`more` が `true` ならすぐに続きを読む
+- `limit` は1〜1000（既定は100）
+- 記録は30日で消える。それより古い `since` は410（`code: "cursor_expired"`）を返すので、`since` なしで取り直す
+- 公開の管理がある型の下書きの行の編集と、メディアは記録しない
+
+`readChanges` は `more` がなくなるまで読み、ページごとに `apply` を呼んで次回の `since` を返す
+
+```ts
+import { createDeliveryClient, DeliveryError, readChanges } from '@ryusenkei/maezae/delivery';
+
+try {
+  since = await readChanges(client, since, async ({ changes }) => {
+    for (const c of changes) c.change === 'upsert' ? await upsert(c.type, c.id) : await remove(c.type, c.id);
+  });
+} catch (e) {
+  if (e instanceof DeliveryError && e.status === 410) since = null; // 次回は全件から
+  else throw e;
+}
+```
+
 ## 回数の制限
 
 - 対象は公開のエンドポイント（`https://api.maezae.app/<媒体>/content/v1/…`）だけ。上限は媒体と API の鍵ごとに1分で600回で、データセンターごとの近似で数える
@@ -125,10 +159,33 @@ const client = createDeliveryClient(cachedDelivery(delivery, { cache: caches.def
 
 公開の操作の反映は、CMS の側の遅れに加えて最大で `freshSec` 秒遅れる
 
+## 本文の描画（0.17.0 から）
+
+`bodyToHtml` は本文のブロックの JSON を HTML にする。サイトがブロックを自分で解釈しなくて済む
+
+- 文字と属性はエスケープし、リンク先は `https:`・`http:`・`mailto:`・ページ内だけを通す
+- 文字の色・背景・大きさ: 本文の設定で宣言した名前（`style.color.name` など）があれば `named` の対応で、なければ元の CSS の値で描く。値は色と大きさの形だけを通す
+- 名前のついた装飾（`style.styles`、microCMS のカスタム class）: `class` に名前を出す（`styleClass` で変えられる）
+- 埋め込み（`embed`）: YouTube・Vimeo・X・Instagram・Spotify・Apple Podcasts の決まった https の URL だけを、制限つきの `iframe` で描く。本文は `iframe` の HTML を持たない
+- 表の結合（`colspan`・`rowspan`）、見出しのセル、揃え、画像のリンクと横の位置、コードのファイル名を描く
+- HTML のブロックは既定で描かない（`allowHtml: true` で生のまま）。コンポーネントは `component` が文字列を返せばそれ、`null` なら既定（`link-card`・`embed`・`gallery`）
+
+```ts
+import { bodyToHtml } from '@ryusenkei/maezae/body';
+
+const html = bodyToHtml(entry.body, {
+  image: (m) => ({ url: m.url, width: m.width, height: m.height, alt: m.alt }),
+  named: (kind, name) => (kind === 'color' ? `var(--color-${name})` : undefined),
+});
+```
+
+章の分割などで見出しの文字を使うときは、`plainOf(heading.content)` で文字にする（取り込みは見出しの文字を変えない）
+
 ## プレビュー
 
 - CMS は媒体のサイトのオリジンへ、公開のページと同じパスで署名つきのリクエストを送信
 - 鍵: 媒体の管理画面の「設定 → 連携」のプレビューの署名の鍵
+- 書きかけの値の画像: 配信 API の1件と同じ値（`id`・`kind`・`url`・`width`・`height`・`alt`・`hotspot`・`crop`）に参照の `asset` を足した形（0.17.0 から）
 
 ```ts
 import { SIGNED_HEADERS, verifyRequest } from '@ryusenkei/maezae/preview';

package/dist/body.js

@@ -1,4 +1,4 @@
-import { a as coreComponentOf, n as declaredPropsZod, r as CITE } from "./declared-9_jI3JXH.js";
+import { a as coreComponentOf, c as embedSrcOf, n as declaredPropsZod, o as EMBED_PROVIDERS, r as CITE, s as embedOfUrl } from "./declared-Qo-mWnDd.js";
 import { z } from "zod";
 // ../body/src/description.ts
 /** meta description の長さの上限（検索結果で省略されにくい字数の目安） */
@@ -14,6 +14,11 @@ function descriptionOf(excerpt, max = 120) {
 	const end = head.lastIndexOf("。");
 	return end > 0 ? head.slice(0, end + 1) : `${[...head].slice(0, max - 1).join("")}…`;
 }
+// ../body/src/types.ts
+/** 属性つきのセルか */
+const isTableCell = (cell) => !Array.isArray(cell);
+/** セルの中の段落（断片の列だけのセルは1段落） */
+const cellParagraphs = (cell) => isTableCell(cell) ? cell.content : [cell];
 // ../body/src/derive.ts
 /** 読了時間の既定の分速（字/分） */
 const READING_SPEED = 500;
@@ -26,7 +31,7 @@ function richIn(body) {
 			case "heading": return [b.content];
 			case "list": return listRich(b);
 			case "quote": return [...b.content];
-			case "table": return [...b.head ?? [], ...b.rows.flat()];
+			case "table": return [...b.head ?? [], ...b.rows.flat().flatMap(cellParagraphs)];
 			default: return [];
 		}
 	});
@@ -48,7 +53,12 @@ const UNREAD = /* @__PURE__ */ new Set([
 	"name",
 	"component",
 	"variant",
-	"marks"
+	"marks",
+	"style",
+	"align",
+	"colspan",
+	"rowspan",
+	"header"
 ]);
 const chars = (v) => typeof v === "string" ? v.length : Array.isArray(v) ? v.reduce((n, x) => n + chars(x), 0) : v && typeof v === "object" ? Object.entries(v).reduce((n, [k, x]) => n + (UNREAD.has(k) ? 0 : chars(x)), 0) : 0;
 /** 読了時間（分、本文の文字列の字数を分速 speed で割った概算、1分以上） */
@@ -70,8 +80,18 @@ const MARK_LABELS = {
 	strike: "取り消し線",
 	mark: "蛍光ペン",
 	sup: "上付き",
-	sub: "下付き"
+	sub: "下付き",
+	underline: "下線"
 };
+const STYLE_LABELS = {
+	color: "文字の色",
+	background: "背景の色",
+	size: "文字の大きさ"
+};
+const CSS_COLOR = /^(#[0-9a-f]{3,8}|rgba?\(\s*[\d.%\s,/]+\)|hsla?\(\s*[\d.%\sdeg,/]+\)|[a-z]{3,20})$/i;
+const CSS_SIZE = /^(\d{1,4}(\.\d{1,3})?(%|px|em|rem|pt)|xx-small|x-small|small|medium|large|x-large|xx-large|smaller|larger)$/i;
+/** 元の CSS の値として描画してよいか（kind は色か大きさ） */
+const isSafeCssValue = (kind, value) => (kind === "size" ? CSS_SIZE : CSS_COLOR).test(value.trim());
 /** 本文を設定で検査（合わない箇所をすべて返却） */
 function checkBody(body, profile) {
 	const problems = [];
@@ -93,8 +113,37 @@ function checkBody(body, profile) {
 				for (const m of inline.marks ?? []) if (!allowedMarks.has(m)) add(`${MARK_LABELS[m]}は使えない`);
 				if (profile.combineMarks === false && (inline.marks?.length ?? 0) + (inline.link ? 1 : 0) > 1) add("装飾の重ね掛け・装飾つきのリンクは使えない");
 				if (inline.link?.rel && !profile.linkRels?.includes(inline.link.rel)) add(`リンクの rel=${inline.link.rel} は使えない`);
+				if (inline.link?.target && !profile.linkTargets) add("リンクを別のタブで開く指定は使えない");
 				if (inline.link && !isSafeHref(inline.link.href)) add(unsafeHrefMessage(inline.link.href));
+				if (inline.style) textStyle(inline.style, plain);
+			}
+		};
+		const textStyle = (style, plain) => {
+			if (plain) add("この場所では文字の見た目は使えない");
+			for (const kind of [
+				"color",
+				"background",
+				"size"
+			]) {
+				const v = style[kind];
+				if (!v) continue;
+				const declared = profile.textStyle?.[kind];
+				if (!declared) add(`${STYLE_LABELS[kind]}は使えない`);
+				else if (v.name && !declared.some((d) => d.name === v.name)) add(`${STYLE_LABELS[kind]}の名前 ${v.name} は本文の設定にない`);
+				if (!v.name && !v.value) add(`${STYLE_LABELS[kind]}の名前と値がない`);
+				if (v.value && !isSafeCssValue(kind, v.value)) add(`${STYLE_LABELS[kind]}の値 ${v.value} は使えない`);
 			}
+			for (const name of style.styles ?? []) if (!profile.textStyle?.styles?.some((d) => d.name === name)) add(`名前のついた装飾 ${name} は本文の設定にない`);
+		};
+		const align = (a) => {
+			if (a && !profile.align) add("揃えは使えない");
+		};
+		const cell = (c, head) => {
+			if (isTableCell(c)) {
+				if (!profile.table?.cells) add("属性つきの表のセルは使えない");
+				if ((c.colspan ?? 1) < 1 || (c.rowspan ?? 1) < 1) add("セルの結合の数は1以上");
+				c.content.forEach((r) => rich(r, (head || Boolean(c.header)) && profile.plain?.includes("tableHead")));
+			} else rich(c, head && profile.plain?.includes("tableHead"));
 		};
 		const variant = (v, allowed = []) => {
 			if (v && !allowed.includes(v)) add(`表示の種類 ${v} は使えない`);
@@ -103,11 +152,13 @@ function checkBody(body, profile) {
 		switch (b.type) {
 			case "paragraph":
 				variant(b.variant);
+				align(b.align);
 				rich(b.content);
 				break;
 			case "heading":
 				if (!profile.headings.includes(b.level)) add(`見出し${b.level}は使えない（使える見出し: ${profile.headings.join("・")}）`);
 				variant(b.variant);
+				align(b.align);
 				rich(b.content, profile.plain?.includes("heading"));
 				break;
 			case "list": {
@@ -138,13 +189,22 @@ function checkBody(body, profile) {
 			case "code":
 				if (!profile.code) add("コードは使えない");
 				else if (!profile.code.caption && b.caption) add("コードの説明は使えない");
+				else if (!profile.code.filename && b.filename) add("コードのファイル名は使えない");
 				else if (b.lang && profile.code.componentLangs?.[b.lang]) add(`\`\`\`${b.lang} のコードは使えない（:::${profile.code.componentLangs[b.lang]} で囲む）`);
 				variant(b.variant);
 				break;
 			case "image":
 				if (!profile.image) add("画像は使えない");
+				else {
+					if (b.link && !profile.image.link) add("画像のリンクは使えない");
+					if (b.link && !isSafeHref(b.link.href)) add(unsafeHrefMessage(b.link.href));
+					if (b.align && !profile.image.align) add("画像の横の位置は使えない");
+				}
 				variant(b.variant, profile.image?.variants);
 				break;
+			case "file":
+				if (!profile.file) add("ファイルは使えない");
+				break;
 			case "table": {
 				const p = profile.table;
 				if (!p) {
@@ -156,7 +216,7 @@ function checkBody(body, profile) {
 				if (p.caption === "none" && b.caption) add("表の説明は使えない");
 				variant(b.variant);
 				b.head?.forEach((r) => rich(r, profile.plain?.includes("tableHead")));
-				b.rows.forEach((row) => row.forEach((r) => rich(r)));
+				b.rows.forEach((row) => row.forEach((c) => cell(c, false)));
 				break;
 			}
 			case "divider":
@@ -170,6 +230,196 @@ function checkBody(body, profile) {
 	});
 	return problems;
 }
+// ../body/src/render.ts
+const ESCAPES = {
+	"&": "&amp;",
+	"<": "&lt;",
+	">": "&gt;",
+	"\"": "&quot;",
+	"'": "&#39;"
+};
+const esc = (s) => s.replace(/[&<>"']/g, (c) => ESCAPES[c]);
+const attrs = (pairs) => Object.entries(pairs).filter(([, v]) => v !== void 0 && v !== null && v !== false && v !== "").map(([k, v]) => ` ${k}="${esc(String(v))}"`).join("");
+const MARK_TAGS = {
+	strong: "strong",
+	em: "em",
+	code: "code",
+	strike: "s",
+	mark: "mark",
+	sup: "sup",
+	sub: "sub",
+	underline: "u"
+};
+/** 外側から内側の順 */
+const MARK_ORDER = [
+	"strong",
+	"em",
+	"strike",
+	"underline",
+	"mark",
+	"sup",
+	"sub",
+	"code"
+];
+const CSS_PROPERTY = {
+	color: "color",
+	background: "background-color",
+	size: "font-size"
+};
+/** iframe の許可（サービスの再生に要るものだけ） */
+const EMBED_SANDBOX = "allow-scripts allow-same-origin allow-popups allow-presentation";
+const EMBED_ALLOW = "encrypted-media; picture-in-picture; fullscreen";
+/** 本文を HTML に */
+function bodyToHtml(body, options) {
+	const styleAttr = (style) => {
+		const decls = Object.keys(CSS_PROPERTY).flatMap((kind) => {
+			const v = style[kind];
+			if (!v) return [];
+			const value = (v.name ? options.named?.(kind, v.name) : void 0) ?? v.value;
+			return value && isSafeCssValue(kind, value) ? [`${CSS_PROPERTY[kind]}: ${value}`] : [];
+		});
+		const classes = (style.styles ?? []).map((n) => options.styleClass?.(n) ?? n);
+		return attrs({
+			class: classes.join(" "),
+			style: decls.join("; ")
+		});
+	};
+	const linkOpen = (link) => isSafeHref(link.href) ? `<a${attrs({
+		href: link.href,
+		title: link.title,
+		target: link.target,
+		rel: link.target ? [.../* @__PURE__ */ new Set([...link.rel?.split(/\s+/) ?? [], "noopener"])].join(" ") : link.rel
+	})}>` : null;
+	const inline = (i) => {
+		if (typeof i === "string") return esc(i).replaceAll("\n", "<br>");
+		if ("component" in i) return options.inlineComponent?.(i.component, i.props ?? {}, i.text ?? "") ?? esc(i.text ?? "");
+		let html = esc(i.text).replaceAll("\n", "<br>");
+		for (const m of [...MARK_ORDER].reverse()) if (i.marks?.includes(m)) html = `<${MARK_TAGS[m]}>${html}</${MARK_TAGS[m]}>`;
+		if (i.style) {
+			const a = styleAttr(i.style);
+			if (a) html = `<span${a}>${html}</span>`;
+		}
+		if (i.link) {
+			const open = linkOpen(i.link);
+			if (open) html = `${open}${html}</a>`;
+		}
+		return html;
+	};
+	const rich = (r) => r.map(inline).join("");
+	const list = (l) => {
+		const tag = l.ordered ? "ol" : "ul";
+		return `<${tag}${attrs({ class: l.variant })}>${l.items.map((item) => `<li>${rich(item.content)}${item.children ? list(item.children) : ""}</li>`).join("")}</${tag}>`;
+	};
+	const cell = (c, header) => {
+		if (!isTableCell(c)) return `<${header ? "th" : "td"}>${rich(c)}</${header ? "th" : "td"}>`;
+		const tag = c.header || header ? "th" : "td";
+		const content = c.content.length > 1 ? c.content.map((p) => `<p>${rich(p)}</p>`).join("") : rich(c.content[0] ?? []);
+		return `<${tag}${attrs({
+			colspan: c.colspan,
+			rowspan: c.rowspan,
+			style: c.align ? `text-align: ${c.align}` : void 0
+		})}>${content}</${tag}>`;
+	};
+	const imageHtml = (media, alt) => {
+		const img = options.image(media);
+		if (!img || !isSafeHref(img.url)) return null;
+		return `<img${attrs({
+			src: img.url,
+			width: img.width,
+			height: img.height,
+			alt: alt ?? img.alt ?? "",
+			loading: "lazy"
+		})}>`;
+	};
+	const component = (b) => {
+		const custom = options.component?.(b, render);
+		if (custom !== null && custom !== void 0) return custom;
+		const p = b.props ?? {};
+		switch (b.name) {
+			case "embed": {
+				const provider = p.provider;
+				const id = typeof p.id === "string" ? p.id : "";
+				if (!id) return "";
+				const src = embedSrcOf({
+					provider,
+					id,
+					...typeof p.start === "number" ? { start: p.start } : {}
+				});
+				return `<div${attrs({
+					class: "embed",
+					"data-provider": provider
+				})}><iframe${attrs({
+					src,
+					title: typeof p.title === "string" ? p.title : provider,
+					width: p.width,
+					height: p.height,
+					loading: "lazy",
+					sandbox: EMBED_SANDBOX,
+					allow: EMBED_ALLOW,
+					referrerpolicy: "strict-origin-when-cross-origin"
+				})}></iframe></div>`;
+			}
+			case "link-card": {
+				const href = typeof p.href === "string" ? p.href : void 0;
+				if (!href || !isSafeHref(href)) return "";
+				const image = p.image ? imageHtml(p.image, "") : null;
+				const text = (cls, v) => typeof v === "string" && v ? `<span${attrs({ class: cls })}>${esc(v)}</span>` : "";
+				return `<a${attrs({
+					class: "link-card",
+					href
+				})}>${image ?? ""}${text("link-card-title", p.title)}${text("link-card-desc", p.desc)}${text("link-card-site", p.site)}</a>`;
+			}
+			case "gallery": return `<div class="gallery">${(Array.isArray(p.items) ? p.items : []).map((i) => `<figure>${imageHtml(i.media, void 0) ?? ""}${i.caption ? `<figcaption>${esc(i.caption)}</figcaption>` : ""}</figure>`).join("")}</div>`;
+			default: return "";
+		}
+	};
+	const block = (b) => {
+		switch (b.type) {
+			case "paragraph": return `<p${attrs({
+				class: b.variant,
+				style: b.align ? `text-align: ${b.align}` : void 0
+			})}>${rich(b.content)}</p>`;
+			case "heading": return `<h${b.level}${attrs({
+				id: b.id,
+				class: b.variant,
+				style: b.align ? `text-align: ${b.align}` : void 0
+			})}>${rich(b.content)}</h${b.level}>`;
+			case "list": return list(b);
+			case "quote": {
+				const cite = b.cite ? `<cite>${b.cite.href && isSafeHref(b.cite.href) ? `<a${attrs({ href: b.cite.href })}>${esc(b.cite.label)}</a>` : esc(b.cite.label)}</cite>` : "";
+				return `<blockquote${attrs({ class: b.variant })}>${b.content.map((p) => `<p>${rich(p)}</p>`).join("")}${cite}</blockquote>`;
+			}
+			case "code": {
+				const pre = `<pre${attrs({ "data-filename": b.filename })}><code${attrs({ class: b.lang ? `language-${b.lang}` : void 0 })}>${esc(b.code)}</code></pre>`;
+				return b.caption ? `<figure${attrs({ class: b.variant })}>${pre}<figcaption>${esc(b.caption)}</figcaption></figure>` : pre;
+			}
+			case "image": {
+				const img = imageHtml(b.media, b.alt);
+				if (!img) return "";
+				const open = b.link ? linkOpen(b.link) : null;
+				return `<figure${attrs({
+					class: b.variant,
+					style: b.align ? `text-align: ${b.align}` : void 0
+				})}>${open ? `${open}${img}</a>` : img}${b.caption ? `<figcaption>${esc(b.caption)}</figcaption>` : ""}</figure>`;
+			}
+			case "table": {
+				const head = b.head ? `<thead><tr>${b.head.map((h) => cell(h, true)).join("")}</tr></thead>` : "";
+				const rows = `<tbody>${b.rows.map((r) => `<tr>${r.map((c) => cell(c, false)).join("")}</tr>`).join("")}</tbody>`;
+				return `<table${attrs({ class: b.variant })}>${b.caption ? `<caption>${esc(b.caption)}</caption>` : ""}${head}${rows}</table>`;
+			}
+			case "file": {
+				const f = options.file?.(b.media);
+				if (!f || !isSafeHref(f.url)) return "";
+				return `<p class="file"><a${attrs({ href: f.url })}>${esc(b.label ?? f.url)}</a></p>`;
+			}
+			case "divider": return "<hr>";
+			case "html": return options.allowHtml ? b.html : "";
+			case "component": return component(b);
+		}
+	};
+	const render = (blocks) => blocks.map(block).join("");
+	return render(body);
+}
 // ../body/src/schema.ts
 const MARKS = [
 	"strong",
@@ -178,7 +428,14 @@ const MARKS = [
 	"strike",
 	"mark",
 	"sup",
-	"sub"
+	"sub",
+	"underline"
+];
+const ALIGNS = [
+	"left",
+	"center",
+	"right",
+	"justify"
 ];
 const CITE_TEXT = /:cite\{#([^\s}]+)\}/g;
 const liftCites = (text) => text.split(CITE_TEXT).flatMap((piece, i) => i % 2 ? [{
@@ -188,13 +445,26 @@ const liftCites = (text) => text.split(CITE_TEXT).flatMap((piece, i) => i % 2 ?
 const link = z.object({
 	href: z.string().min(1, "リンク先が未入力"),
 	title: z.string().optional(),
-	rel: z.string().optional()
+	rel: z.string().optional(),
+	target: z.literal("_blank").optional()
+});
+const named = z.object({
+	name: z.string().min(1).optional(),
+	value: z.string().min(1).optional()
+});
+const textStyle = z.object({
+	color: named.optional(),
+	background: named.optional(),
+	size: named.optional(),
+	styles: z.array(z.string().min(1)).optional()
 });
 const text = z.object({
 	text: z.string(),
 	marks: z.array(z.enum(MARKS)).optional(),
-	link: link.optional()
+	link: link.optional(),
+	style: textStyle.optional()
 });
+const align = z.enum(ALIGNS).optional();
 /** 部品の props の検査（名前で核のコンポーネント、なければ宣言した部品、どちらもないか種類が違えば null） */
 function propsOf(name, inline, media, declared) {
 	const core = coreComponentOf(name);
@@ -262,12 +532,32 @@ function blockSchemaOf(profile, media, declared = []) {
 		]),
 		content: rich,
 		id: z.string().optional(),
+		align,
 		variant
 	});
+	const span = z.number().int().min(1).max(1e3).optional();
+	const tableCell = z.object({
+		content: z.array(rich),
+		header: z.boolean().optional(),
+		colspan: span,
+		rowspan: span,
+		align
+	});
+	const cell = z.unknown().transform((value, ctx) => {
+		const r = (Array.isArray(value) ? rich : tableCell).safeParse(value);
+		if (r.success) return r.data;
+		for (const issue of r.error.issues) ctx.addIssue({
+			code: "custom",
+			message: issue.message,
+			path: issue.path
+		});
+		return z.NEVER;
+	});
 	return z.discriminatedUnion("type", [
 		z.object({
 			type: z.literal("paragraph"),
 			content: rich,
+			align,
 			variant
 		}),
 		heading.refine((h) => h.content.some((i) => typeof i === "string" ? i.trim() : "text" in i && i.text?.trim()), "見出しが未入力"),
@@ -286,6 +576,7 @@ function blockSchemaOf(profile, media, declared = []) {
 			code: z.string(),
 			lang: z.string().optional(),
 			caption: z.string().optional(),
+			filename: z.string().optional(),
 			variant
 		}),
 		z.object({
@@ -293,15 +584,26 @@ function blockSchemaOf(profile, media, declared = []) {
 			media,
 			alt: z.string().optional(),
 			caption: z.string().optional(),
+			link: link.optional(),
+			align: z.enum([
+				"left",
+				"center",
+				"right"
+			]).optional(),
 			variant
 		}),
 		z.object({
 			type: z.literal("table"),
 			head: z.array(rich).optional(),
-			rows: z.array(z.array(rich)),
+			rows: z.array(z.array(cell)),
 			caption: z.string().optional(),
 			variant
 		}),
+		z.object({
+			type: z.literal("file"),
+			media,
+			label: z.string().optional()
+		}),
 		z.object({ type: z.literal("divider") }),
 		z.object({
 			type: z.literal("html"),
@@ -344,4 +646,4 @@ function blockSchemaOf(profile, media, declared = []) {
 		return out;
 	});
 }
-export { DESCRIPTION_MAX, READING_SPEED, blockSchemaOf, citesOf, descriptionOf, excerptOf, isSafeHref, linksOf, plainOf, readMinOf };
+export { DESCRIPTION_MAX, EMBED_PROVIDERS, READING_SPEED, blockSchemaOf, bodyToHtml, cellParagraphs, citesOf, descriptionOf, embedOfUrl, embedSrcOf, excerptOf, isSafeCssValue, isSafeHref, isTableCell, linksOf, plainOf, readMinOf };