@ryusenkei/maezae 0.16.0 → 0.18.0

package/dist/{declared-9_jI3JXH.js → declared-Qo-mWnDd.js}

@@ -1,14 +1,99 @@
 import { z } from "zod";
 // ../body/src/components.ts
 /** 予約の名前（ブロック） */
-const RESERVED_BLOCK_NAMES = /* @__PURE__ */ new Set(["block"]);
+const RESERVED_BLOCK_NAMES = /* @__PURE__ */ new Set([
+	"block",
+	"table",
+	"file"
+]);
 /** 予約の名前（インライン） */
 const RESERVED_INLINE_NAMES = /* @__PURE__ */ new Set([
 	"mark",
 	"sup",
 	"sub",
-	"link"
+	"link",
+	"u",
+	"span"
 ]);
+// ../body/src/embed.ts
+/** 埋め込めるサービス */
+const EMBED_PROVIDERS = [
+	"youtube",
+	"vimeo",
+	"x",
+	"instagram",
+	"spotify",
+	"apple-podcasts"
+];
+const ID = /^[\w-]{1,64}$/;
+/** 開始の秒（YouTube の t=1m30s・t=90・start=90） */
+function startOf(params) {
+	const raw = params.get("t") ?? params.get("start");
+	if (!raw) return void 0;
+	const m = raw.match(/^(?:(\d+)h)?(?:(\d+)m)?(?:(\d+)s?)?$/);
+	if (!m) return void 0;
+	const sec = Number(m[1] ?? 0) * 3600 + Number(m[2] ?? 0) * 60 + Number(m[3] ?? 0);
+	return sec > 0 ? sec : void 0;
+}
+/** URL から埋め込み（埋め込めるサービスでなければ null） */
+function embedOfUrl(raw) {
+	const url = URL.parse(raw);
+	if (!url || url.protocol !== "https:") return null;
+	const host = url.hostname.replace(/^(www|m)\./, "");
+	const path = url.pathname.split("/").filter(Boolean);
+	const pick = (provider, id, start) => id && ID.test(id) ? {
+		provider,
+		id,
+		...start ? { start } : {}
+	} : null;
+	switch (host) {
+		case "youtube.com":
+		case "youtube-nocookie.com":
+			if (path[0] === "watch") return pick("youtube", url.searchParams.get("v") ?? void 0, startOf(url.searchParams));
+			if (path[0] === "embed" || path[0] === "shorts" || path[0] === "live") return pick("youtube", path[1], startOf(url.searchParams));
+			return null;
+		case "youtu.be": return pick("youtube", path[0], startOf(url.searchParams));
+		case "vimeo.com": return pick("vimeo", path.find((p) => /^\d+$/.test(p)));
+		case "player.vimeo.com": return path[0] === "video" ? pick("vimeo", path[1]) : null;
+		case "twitter.com":
+		case "x.com": return path[1] === "status" ? pick("x", path[2]) : null;
+		case "instagram.com": return path[0] === "p" || path[0] === "reel" ? pick("instagram", path[1]) : null;
+		case "open.spotify.com": {
+			const [kind, id] = (path[0] === "embed" ? path.slice(1) : path).filter((p) => !p.startsWith("intl-"));
+			return kind && [
+				"track",
+				"album",
+				"playlist",
+				"episode",
+				"show"
+			].includes(kind) && id && ID.test(id) ? {
+				provider: "spotify",
+				id: `${kind}/${id}`
+			} : null;
+		}
+		case "podcasts.apple.com": {
+			const show = path.find((p) => /^id\d+$/.test(p));
+			const episode = url.searchParams.get("i");
+			return show ? pick("apple-podcasts", episode ? `${show}-${episode}` : show) : null;
+		}
+		default: return null;
+	}
+}
+/** 描画の iframe の URL（サービスと ID から組み立てる、X と Instagram は埋め込みのページ） */
+function embedSrcOf(target) {
+	const id = encodeURIComponent(target.id).replaceAll("%2F", "/");
+	switch (target.provider) {
+		case "youtube": return `https://www.youtube-nocookie.com/embed/${id}${target.start ? `?start=${target.start}` : ""}`;
+		case "vimeo": return `https://player.vimeo.com/video/${id}${target.start ? `#t=${target.start}s` : ""}`;
+		case "x": return `https://platform.twitter.com/embed/Tweet.html?id=${id}`;
+		case "instagram": return `https://www.instagram.com/p/${id}/embed`;
+		case "spotify": return `https://open.spotify.com/embed/${id}`;
+		case "apple-podcasts": {
+			const [show, episode] = target.id.split("-");
+			return `https://embed.podcasts.apple.com/podcast/${encodeURIComponent(show ?? "")}${episode ? `?i=${encodeURIComponent(episode)}` : ""}`;
+		}
+	}
+}
 // ../body/src/library.ts
 /** 注のコンポーネントの名前（本文からの算出 citesOf が参照） */
 const CITE = "cite";
@@ -71,9 +156,9 @@ const CORE_COMPONENTS = [
 	{
 		name: CITE,
 		inline: true,
-		description: "注（出典の ID を参照、出典は記事に結び付けが必要）",
+		description: "注（参考資料の ID を参照、参考資料はコンテンツに結び付けが必要）",
 		example: ":cite{#出典の ID}",
-		props: () => z.object({ id: z.string().min(1, "注の出典が未入力") })
+		props: () => z.object({ id: z.string().min(1, "注の参考資料が未入力") })
 	},
 	{
 		name: "pending",
@@ -151,18 +236,20 @@ const CORE_COMPONENTS = [
 	},
 	{
 		name: "link-card",
-		description: "外部リンクのカード（https のみ、site・desc・画像は任意）",
+		description: "リンクのカード（外のページは https と題名、site・desc・画像は任意。中のコンテンツは ref=\"型の id/行の ID\"）",
 		example: ":::link-card{href=\"https://…\" title=\"ページの題\" site=\"サイト名\" desc=\"説明\"}\n:::",
 		markdown: {
 			to: (p) => {
-				const { href, title, site, desc, image } = p;
+				const { href, ref, title, site, desc, image, fetchedAt } = p;
 				return {
-					attributes: {
+					attributes: Object.fromEntries(Object.entries({
 						href,
+						ref,
 						title,
-						...site ? { site } : {},
-						...desc ? { desc } : {}
-					},
+						site,
+						desc,
+						"fetched-at": fetchedAt
+					}).filter((e) => typeof e[1] === "string" && e[1] !== "")),
 					content: image ? [{
 						type: "image",
 						media: image
@@ -170,18 +257,70 @@ const CORE_COMPONENTS = [
 				};
 			},
 			from: (attrs, content) => ({
-				href: attrs.href,
-				title: attrs.title,
-				...optional(attrs, ["site", "desc"]),
+				...optional(attrs, [
+					"href",
+					"ref",
+					"title",
+					"site",
+					"desc"
+				]),
+				...attrs["fetched-at"] ? { fetchedAt: attrs["fetched-at"] } : {},
 				...content[0]?.type === "image" ? { image: content[0].media } : {}
 			})
 		},
-		props: (media) => z.object({
+		props: (media) => z.union([z.object({
 			href: https,
 			title: z.string().min(1, "リンクのタイトルが未入力"),
 			site: z.string().optional(),
 			desc: z.string().optional(),
+			image: media.optional(),
+			fetchedAt: z.string().optional()
+		}), z.object({
+			ref: z.string().regex(/^[\w-]+\/[\w-]+$/, "ref は「型の id/行の ID」"),
+			title: z.string().optional(),
+			site: z.string().optional(),
+			desc: z.string().optional(),
 			image: media.optional()
+		})])
+	},
+	{
+		name: "embed",
+		description: `外のサービスの埋め込み（provider は ${EMBED_PROVIDERS.join("・")}、id はサービスの中の ID、url は元の URL、start は開始の秒）`,
+		example: ":::embed{provider=youtube id=\"xxxxxxxxxxx\" url=\"https://www.youtube.com/watch?v=xxxxxxxxxxx\"}\n:::",
+		markdown: {
+			to: (p) => {
+				const { provider, id, url, width, height, start, title } = p;
+				return { attributes: Object.fromEntries(Object.entries({
+					provider,
+					id,
+					url,
+					width,
+					height,
+					start,
+					title
+				}).filter(([, v]) => v !== void 0).map(([k, v]) => [k, String(v)])) };
+			},
+			from: (attrs) => {
+				const num = (k) => attrs[k] !== void 0 && attrs[k] !== "" ? { [k]: Number(attrs[k]) } : {};
+				return {
+					provider: attrs.provider,
+					id: attrs.id,
+					url: attrs.url,
+					...num("width"),
+					...num("height"),
+					...num("start"),
+					...optional(attrs, ["title"])
+				};
+			}
+		},
+		props: () => z.object({
+			provider: z.enum(EMBED_PROVIDERS),
+			id: z.string().regex(/^[\w-]+(\/[\w-]+)?$/, "埋め込みの ID が不正"),
+			url: https,
+			width: z.number().int().positive().optional(),
+			height: z.number().int().positive().optional(),
+			start: z.number().int().nonnegative().optional(),
+			title: z.string().optional()
 		})
 	},
 	{
@@ -333,4 +472,4 @@ function declaredPropsZod(d) {
 	if (!schema) propsCache.set(d, schema = objectZod(d.props.properties, d.props.required ?? [], { error: () => `${d.label}の引数の形が不正` }));
 	return schema;
 }
-export { coreComponentOf as a, CORE_COMPONENTS as i, declaredPropsZod as n, CITE as r, declaredComponentsSchema as t };
+export { coreComponentOf as a, embedSrcOf as c, CORE_COMPONENTS as i, declaredPropsZod as n, EMBED_PROVIDERS as o, CITE as r, embedOfUrl as s, declaredComponentsSchema as t };

package/dist/delivery.js

@@ -250,12 +250,22 @@ const EXTENSIONS = {
 	"image/webp": "webp",
 	"image/gif": "gif",
 	"video/mp4": "mp4",
-	"video/webm": "webm"
+	"video/webm": "webm",
+	"application/pdf": "pdf",
+	"application/zip": "zip",
+	"text/plain": "txt",
+	"text/csv": "csv",
+	"application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
+	"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx",
+	"application/vnd.openxmlformats-officedocument.presentationml.presentation": "pptx"
 };
+/** 形式の実体の種類 */
+const mediaKindOf = (mimeType) => mimeType.startsWith("image/") ? "image" : mimeType.startsWith("video/") ? "video" : "file";
 /** 拡張子の形式（配信しない拡張子は null） */
 const mediaMimeOf = (ext) => Object.entries(EXTENSIONS).find(([, e]) => e === ext)?.[0] ?? null;
 const IMAGE_PATH = /^\/images\/([A-Za-z0-9_-]+)\/([A-Za-z0-9_-]+)-(\d+)x(\d+)\.([a-z0-9]+)$/;
 const VIDEO_PATH = /^\/videos\/([A-Za-z0-9_-]+)\/([A-Za-z0-9_-]+)\.([a-z0-9]+)$/;
+const FILE_PATH = /^\/files\/([A-Za-z0-9_-]+)\/([A-Za-z0-9_-]+)\.([a-z0-9]+)$/;
 /** 配信 URL のパスを解析（形が違えば null） */
 function parseMediaPath(pathname) {
 	const image = IMAGE_PATH.exec(pathname);
@@ -280,8 +290,39 @@ function parseMediaPath(pathname) {
 			ext
 		} : null;
 	}
+	const file = FILE_PATH.exec(pathname);
+	if (file) {
+		const [, project, id, ext] = file;
+		const mime = mediaMimeOf(ext);
+		return mime && mediaKindOf(mime) === "file" ? {
+			kind: "file",
+			project,
+			id,
+			ext
+		} : null;
+	}
 	return null;
 }
+const hex = (buf) => [...new Uint8Array(buf)].map((b) => b.toString(16).padStart(2, "0")).join("");
+/** 署名（HMAC-SHA256、対象はパスと期限、変換のクエリは含めない） */
+async function signatureOf(secret, pathname, exp) {
+	const key = await crypto.subtle.importKey("raw", new TextEncoder().encode(secret), {
+		name: "HMAC",
+		hash: "SHA-256"
+	}, false, ["sign"]);
+	return hex(await crypto.subtle.sign("HMAC", key, new TextEncoder().encode(`${pathname}:${exp}`)));
+}
+/**
+* 非公開のメディアの署名つきの URL（exp と sig のクエリを付ける、ほかのクエリは残す）
+* - secret: 媒体の非公開のメディアの署名の鍵、expiresInSec: 期限までの秒、now: 今の UNIX ミリ秒
+*/
+async function signMediaUrl(url, secret, options = {}) {
+	const u = new URL(url);
+	const exp = Math.floor((options.now ?? Date.now()) / 1e3) + (options.expiresInSec ?? 3600);
+	u.searchParams.set("exp", String(exp));
+	u.searchParams.set("sig", await signatureOf(secret, u.pathname, exp));
+	return u.toString();
+}
 /** 幅・高さの上限（画素） */
 const IMAGE_SIZE_MAX = 4096;
 const FITS = [
@@ -432,4 +473,4 @@ function createDeliveryClock(timeZone) {
 		})
 	};
 }
-export { DELIVERY_PATH, DeliveryError, cachedDelivery, createDeliveryClient, createDeliveryClock, deliveredImageUrl, fieldOf, imageParamsOf, limitOf, listParams, mediaOf, memoryDeliveryCache, optionLabels, pagePath, parseMediaPath, readChanges, subPath, withImageParams };
+export { DELIVERY_PATH, DeliveryError, cachedDelivery, createDeliveryClient, createDeliveryClock, deliveredImageUrl, fieldOf, imageParamsOf, limitOf, listParams, mediaOf, memoryDeliveryCache, optionLabels, pagePath, parseMediaPath, readChanges, signMediaUrl, subPath, withImageParams };

package/dist/model.js

@@ -1,5 +1,5 @@
 import { c as coverStart, d as objectPosition, f as stillOf, i as acceptsRole, l as cropRect, m as isDateOnly, n as publicPathOf, o as typeOf, p as createClock, r as FIELD_ROLES, s as coverPosition, t as pagePathOf, u as croppedHotspot } from "./page-BnwHL-LC.js";
-import { i as CORE_COMPONENTS, t as declaredComponentsSchema } from "./declared-9_jI3JXH.js";
+import { i as CORE_COMPONENTS, t as declaredComponentsSchema } from "./declared-Qo-mWnDd.js";
 import "./src-BrLwIWaT.js";
 import { z } from "zod";
 // ../model/src/asset.ts
@@ -344,11 +344,13 @@ const fieldUnion = z.discriminatedUnion("type", [
 		type: z.literal("media"),
 		accept: z.array(z.enum(["image", "video"])).optional(),
 		multiple: z.boolean().optional(),
-		frames: z.array(frame).optional()
+		frames: z.array(frame).optional(),
+		visibility: z.literal("private").optional()
 	}),
 	z.object({
 		...base,
 		type: z.literal("body"),
+		visibility: z.literal("private").optional(),
 		profile: z.object({
 			headings: z.array(z.number()),
 			marks: z.array(z.string()),

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

@@ -1,4 +1,5 @@
 export { recordView, type Classify, type Dataset } from './record.js';
 export { syncCron } from './schedule.js';
+export { isViewsCron, sharedViews, viewsFor, viewsSince, viewsSyncOf } from './shared.js';
 export { analyticsEngine, type DailyRow, fixedSource, type Source, projectDaily, type ProjectSource, renamedSource } from './source.js';
 export { readDaily, syncDaily } from './store.js';

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

@@ -0,0 +1,21 @@
+import { type DailyRow, type ProjectSource, type Source } from './source.js';
+/** 全媒体を問い合わせる範囲の最初の日付（UTC の日付、どの時間帯の媒体の直近3日も含む） */
+export declare const viewsSince: (now: number) => string;
+/** 全媒体の問い合わせを行う Cron か（minutes は集計の間隔の分） */
+export declare const isViewsCron: (minutes: string | undefined, cron: string) => boolean;
+/** 全媒体の閲覧数の問い合わせ（対象の Cron で設定があるときだけ、なしは null） */
+export declare const viewsSyncOf: (source: ProjectSource | null, minutes: string | undefined, cron: string, scheduledTime: number) => Readonly<{
+    source: ProjectSource;
+    since: string;
+}> | null;
+/** 媒体ごとの読み込み元の作成 */
+type ViewsOf = (projectId: string) => Source | null;
+/**
+ * Queues なしの構成の媒体ごとの読み込み元（全媒体の問い合わせ結果の行）
+ * - 結果にない媒体: 行なし
+ * - 問い合わせの失敗: 各媒体の集計の処理が失敗として記録（ログ・実行の記録）
+ */
+export declare function sharedViews(source: ProjectSource, since: string): Promise<ViewsOf>;
+/** メッセージに載った行の読み込み元（なしは媒体ごとの問い合わせ live） */
+export declare const viewsFor: (rows: readonly DailyRow[] | undefined, live: ViewsOf) => ViewsOf;
+export {};

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

@@ -1,4 +1,4 @@
-import type { Body, Rich } from './types.js';
+import { type Body, type Rich } from './types.js';
 /** 読了時間の既定の分速（字/分） */
 export declare const READING_SPEED = 500;
 /** 断片の列の文字（装飾・リンクは文字、インラインのコンポーネントは中の文字） */

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

@@ -0,0 +1,14 @@
+/** 埋め込めるサービス */
+export declare const EMBED_PROVIDERS: readonly ["youtube", "vimeo", "x", "instagram", "spotify", "apple-podcasts"];
+/** 埋め込めるサービス */
+export type EmbedProvider = (typeof EMBED_PROVIDERS)[number];
+/** URL から決めた埋め込み（start は開始の秒） */
+export type EmbedTarget = Readonly<{
+    provider: EmbedProvider;
+    id: string;
+    start?: number;
+}>;
+/** URL から埋め込み（埋め込めるサービスでなければ null） */
+export declare function embedOfUrl(raw: string): EmbedTarget | null;
+/** 描画の iframe の URL（サービスと ID から組み立てる、X と Instagram は埋め込みのページ） */
+export declare function embedSrcOf(target: EmbedTarget): `https://${string}`;

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

@@ -0,0 +1,31 @@
+import type { Body } from './types.js';
+/** 変換の設定 */
+export type HtmlOptions<M> = Readonly<{
+    /** 画像の参照（src は元の URL） */
+    image(src: string, info: Readonly<{
+        alt?: string;
+        width?: number;
+        height?: number;
+    }>): M;
+    /** ファイルの参照（href は元の URL、mime は data-mime-type） */
+    file?(href: string, info: Readonly<{
+        mime?: string;
+        name?: string;
+    }>): M;
+    /** 名前のついた装飾として残す class（なしは class をすべて捨てる） */
+    styleClass?(name: string): boolean;
+    /** 元の CSS の値に対応する名前（本文の設定の宣言、なしは名前なし） */
+    nameOf?(kind: 'color' | 'background' | 'size', value: string): string | undefined;
+}>;
+/** 変換で捨てたもの（what は要素・属性・style の項目・class、count は回数） */
+export type Dropped = Readonly<{
+    what: string;
+    count: number;
+}>;
+/** 変換の結果 */
+export type HtmlResult<M> = Readonly<{
+    body: Body<M>;
+    dropped: readonly Dropped[];
+}>;
+/** HTML を本文に（写せないものは dropped） */
+export declare function bodyFromHtml<M>(html: string, options: HtmlOptions<M>): HtmlResult<M>;

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

@@ -4,8 +4,11 @@ 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 { bodyFromHtml, type Dropped, type HtmlOptions, type HtmlResult } from './html.js';
+export { EMBED_PROVIDERS, embedOfUrl, embedSrcOf, type EmbedProvider, type EmbedTarget } from './embed.js';
 export { fromMarkdown, toMarkdown, type MarkdownOptions } from './markdown.js';
-export { checkBody, describeMarkdown, type BodyProfile } from './profile.js';
+export { checkBody, describeMarkdown, isSafeCssValue, type BodyProfile, type NamedStyle, type NamedValue } from './profile.js';
+export { bodyToHtml, type RenderedImage, type RenderOptions } from './render.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';
+export { cellParagraphs, isTableCell, type Align, type Block, type Body, type Cell, type ComponentBlock, type HeadingLevel, type ImageAlign, type Inline, type InlineComponent, type Link, type List, type ListItem, type Mark, type Named, type Rich, type StandardBlock, type TableCell, type Text, type TextStyle } from './types.js';

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { ComponentDef } from './components.js';
+import { type EmbedProvider } from './embed.js';
 /** グラフの項目と値 */
 export type ChartDatum = Readonly<{
     label: string;
@@ -63,12 +64,30 @@ export type ComponentProps<M> = Readonly<{
             caption?: string;
         }>[];
     }>;
+    /** 外のページは href と保存のときの OGP の写し（fetchedAt は取得の日時）、中のコンテンツは ref（型の id/行の ID、題名と画像は配信のときに参照先から） */
     'link-card': Readonly<{
         href: `https://${string}`;
         title: string;
         site?: string;
         desc?: string;
         image?: M;
+        fetchedAt?: string;
+    }> | Readonly<{
+        ref: string;
+        title?: string;
+        site?: string;
+        desc?: string;
+        image?: M;
+    }>;
+    /** 外のサービスの埋め込み（id はサービスの中の ID、url は元の URL、start は開始の秒） */
+    embed: Readonly<{
+        provider: EmbedProvider;
+        id: string;
+        url: `https://${string}`;
+        width?: number;
+        height?: number;
+        start?: number;
+        title?: string;
     }>;
     links: Readonly<{
         label?: string;

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

@@ -1,5 +1,5 @@
 import { type ComponentDef } from './components.js';
-import type { Body } from './types.js';
+import { type Body } from './types.js';
 /** マッパーの設定（media は画像の参照と Markdown の文字列の変換） */
 export type MarkdownOptions<M> = Readonly<{
     media: Readonly<{

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

@@ -1,4 +1,4 @@
-import type { Body, Mark, Rich } from './types.js';
+import { type Body, type Mark, type Rich } from './types.js';
 /** 装飾の順序（Markdown では外側から内側） */
 export declare const MARK_ORDER: readonly Mark[];
 /** インラインの断片の列を正規化 */

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

@@ -1,5 +1,5 @@
 import type { ComponentDef } from './components.js';
-import type { Body, HeadingLevel, Mark } from './types.js';
+import { type Body, type HeadingLevel, type Mark } from './types.js';
 /** 本文の設定 */
 export type BodyProfile = Readonly<{
     headings: readonly HeadingLevel[];
@@ -10,6 +10,17 @@ export type BodyProfile = Readonly<{
     linkRels?: readonly string[];
     /** 装飾・リンク・インラインのコンポーネントを使用できない場所 */
     plain?: readonly ('heading' | 'tableHead')[];
+    /** リンクを別のタブで開く指定（既定は不可） */
+    linkTargets?: true;
+    /** 文字の見た目（色・背景・大きさは名前の宣言、項目がないものは使用不可、styles は名前のついた装飾の宣言） */
+    textStyle?: Readonly<{
+        color?: readonly NamedValue[];
+        background?: readonly NamedValue[];
+        size?: readonly NamedValue[];
+        styles?: readonly NamedStyle[];
+    }>;
+    /** 段落と見出しの揃え */
+    align?: true;
     list?: Readonly<{
         ordered: boolean;
         nested: boolean;
@@ -19,28 +30,49 @@ export type BodyProfile = Readonly<{
         multiple: boolean;
         cite: boolean;
     }>;
-    /** コード（componentLangs はコンポーネントで書く言語とコンポーネントの名前、例: mermaid は図、その言語のフェンスだけのコードは不可） */
+    /** コード（filename はファイル名、componentLangs はコンポーネントで書く言語とコンポーネントの名前、例: mermaid は図、その言語のフェンスだけのコードは不可） */
     code?: Readonly<{
         caption: boolean;
+        filename?: boolean;
         componentLangs?: Readonly<Record<string, string>>;
     }>;
+    /** 画像（link は画像のリンク、align は横の位置） */
     image?: Readonly<{
         variants?: readonly string[];
+        link?: boolean;
+        align?: boolean;
     }>;
+    /** 表（cells は属性つきのセル: 見出しのセル・結合・揃え・複数の段落） */
     table?: Readonly<{
         head: 'required' | 'optional';
         caption: 'required' | 'optional' | 'none';
+        cells?: boolean;
     }>;
+    /** ファイル（実体の参照とリンクの文字） */
+    file?: true;
     divider?: true;
     html?: true;
     /** 使用できるコンポーネントの名前（ブロック・インライン） */
     components: readonly string[];
 }>;
+/** 名前のついた値の宣言（label は管理画面の表示名、value はサイトが対応を持たないときの既定の CSS の値） */
+export type NamedValue = Readonly<{
+    name: string;
+    label: string;
+    value?: string;
+}>;
+/** 名前のついた装飾の宣言（見せ方はサイトが名前で決める） */
+export type NamedStyle = Readonly<{
+    name: string;
+    label: string;
+}>;
 /** 本文の設定に合わない箇所（index は本文のブロックの位置、0から） */
 type BodyProblem = Readonly<{
     index: number;
     message: string;
 }>;
+/** 元の CSS の値として描画してよいか（kind は色か大きさ） */
+export declare const isSafeCssValue: (kind: "color" | "background" | "size", value: string) => boolean;
 /** 本文を設定で検査（合わない箇所をすべて返却） */
 export declare function checkBody<M>(body: Body<M>, profile: BodyProfile): BodyProblem[];
 /** 書き手と AI への Markdown の説明（使用できるものを記法の例つきで列挙し、使用できないものは末尾） */

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

@@ -0,0 +1,29 @@
+import { type Body, type ComponentBlock } from './types.js';
+/** 画像の描画の値 */
+export type RenderedImage = Readonly<{
+    url: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+}>;
+/** 描画の設定 */
+export type RenderOptions<M> = Readonly<{
+    /** 画像の URL と寸法（null は描画しない） */
+    image(media: M): RenderedImage | null;
+    /** ファイルの URL（なし・null は描画しない） */
+    file?(media: M): Readonly<{
+        url: string;
+    }> | null;
+    /** 名前に対応する CSS の値（undefined は元の値） */
+    named?(kind: 'color' | 'background' | 'size', name: string): string | undefined;
+    /** 名前のついた装飾の class */
+    styleClass?(name: string): string;
+    /** コンポーネントの描画（null は既定の描画） */
+    component?(block: ComponentBlock, render: (body: Body<M>) => string): string | null;
+    /** インラインのコンポーネントの描画（null は中の文字） */
+    inlineComponent?(component: string, props: Readonly<Record<string, string>>, text: string): string | null;
+    /** HTML のブロックを生のまま描画 */
+    allowHtml?: boolean;
+}>;
+/** 本文を HTML に */
+export declare function bodyToHtml<M>(body: Body<M>, options: RenderOptions<M>): string;