@ryusenkei/maezae 0.16.0 → 0.18.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）
@@ -156,10 +159,51 @@ 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)` で文字にする（取り込みは見出しの文字を変えない）
+
+## 非公開のメディア（0.18.0 から）
+
+非公開の項目（型の宣言で `visibility: 'private'` のメディアと本文）の画像とファイルは、署名つき・期限つきの URL でだけ配信する。配信 API は `visibility: 'private'` と署名のない `url` を返すので、権利のある人に見せるときにサイトのサーバーが署名する
+
+- 鍵: 媒体の管理画面の「設定 → 連携」の非公開のメディアの署名の鍵。サイトの秘密値に入れ、ブラウザに出さない
+- 期限: `expiresInSec`（既定は3600秒）。ページを表示するたびに署名し、写しに署名つきの URL を保存しない
+- 画像の変換のクエリ（`w` など）は署名の後に足してよい（署名の対象はパスと期限だけ）
+- 署名のない URL は404、期限切れと別の鍵の署名は403。鍵を作り直すと古い鍵の署名はすぐ通らない
+
+```ts
+import { signMediaUrl, withImageParams } from '@ryusenkei/maezae/delivery';
+
+const src = image.visibility === 'private' ? await signMediaUrl(image.url, env.MEDIA_SIGNING_KEY, { expiresInSec: 1800 }) : image.url;
+const thumb = withImageParams(src, { w: 400, auto: 'format' });
+```
+
+ファイル（`kind: 'file'`）: `url` は `/files/<媒体>/<ID>.<拡張子>`、`name`（元のファイル名）・`mimeType`・`size` を持つ。本文のファイルのブロックも同じ実体を参照する
+
 ## プレビュー
 
 - 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 };