@ryusenkei/maezae 0.16.0 → 0.17.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/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

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;

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

@@ -1,16 +1,30 @@
-/** インラインの装飾（strong・em・code・s・mark・sup・sub） */
-export type Mark = 'strong' | 'em' | 'code' | 'strike' | 'mark' | 'sup' | 'sub';
-/** リンク（HTML の a の href・title・rel） */
+/** インラインの装飾（strong・em・code・s・mark・sup・sub・u） */
+export type Mark = 'strong' | 'em' | 'code' | 'strike' | 'mark' | 'sup' | 'sub' | 'underline';
+/** リンク（HTML の a の href・title・rel、target は別のタブ） */
 export type Link = Readonly<{
     href: string;
     title?: string;
     rel?: string;
+    target?: '_blank';
 }>;
-/** 装飾・リンクつきの文字列 */
+/** 名前のついた値（name は本文の設定で宣言した名前、value は元の CSS の値、どちらか1つ以上） */
+export type Named = Readonly<{
+    name?: string;
+    value?: string;
+}>;
+/** 文字の見た目（styles は本文の設定で宣言した名前のついた装飾、例: microCMS のカスタム class） */
+export type TextStyle = Readonly<{
+    color?: Named;
+    background?: Named;
+    size?: Named;
+    styles?: readonly string[];
+}>;
+/** 装飾・リンク・見た目つきの文字列 */
 export type Text = Readonly<{
     text: string;
     marks?: readonly Mark[];
     link?: Link;
+    style?: TextStyle;
 }>;
 /** インラインのコンポーネント（例: 注、属性は文字列だけ、text は中の文字） */
 export type InlineComponent = Readonly<{
@@ -24,6 +38,20 @@ export type Inline = string | Text | InlineComponent;
 export type Rich = readonly Inline[];
 /** 見出しの段階 */
 export type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+/** 揃え（段落・見出し・表のセル） */
+export type Align = 'left' | 'center' | 'right' | 'justify';
+/** 画像の横の位置 */
+export type ImageAlign = 'left' | 'center' | 'right';
+/** 属性つきの表のセル（content はセルの中の段落、header は見出しのセル、colspan・rowspan は結合） */
+export type TableCell = Readonly<{
+    content: readonly Rich[];
+    header?: boolean;
+    colspan?: number;
+    rowspan?: number;
+    align?: Align;
+}>;
+/** 表のセル（断片の列だけのセルか、属性つきのセル） */
+export type Cell = Rich | TableCell;
 /** リストの1項目（children は入れ子のリスト） */
 export type ListItem = Readonly<{
     content: Rich;
@@ -40,12 +68,14 @@ export type List = Readonly<{
 export type StandardBlock<M> = Readonly<{
     type: 'paragraph';
     content: Rich;
+    align?: Align;
     variant?: string;
 }> | Readonly<{
     type: 'heading';
     level: HeadingLevel;
     content: Rich;
     id?: string;
+    align?: Align;
     variant?: string;
 }> | List | Readonly<{
     type: 'quote';
@@ -60,19 +90,26 @@ export type StandardBlock<M> = Readonly<{
     code: string;
     lang?: string;
     caption?: string;
+    filename?: string;
     variant?: string;
 }> | Readonly<{
     type: 'image';
     media: M;
     alt?: string;
     caption?: string;
+    link?: Link;
+    align?: ImageAlign;
     variant?: string;
 }> | Readonly<{
     type: 'table';
     head?: readonly Rich[];
-    rows: readonly (readonly Rich[])[];
+    rows: readonly (readonly Cell[])[];
     caption?: string;
     variant?: string;
+}> | Readonly<{
+    type: 'file';
+    media: M;
+    label?: string;
 }> | Readonly<{
     type: 'divider';
 }> | Readonly<{
@@ -89,3 +126,7 @@ export type ComponentBlock = Readonly<{
 export type Block<M> = StandardBlock<M> | ComponentBlock;
 /** 本文 */
 export type Body<M> = readonly Block<M>[];
+/** 属性つきのセルか */
+export declare const isTableCell: (cell: Cell) => cell is TableCell;
+/** セルの中の段落（断片の列だけのセルは1段落） */
+export declare const cellParagraphs: (cell: Cell) => readonly Rich[];

package/dist/types/cms-contract/src/apiKeys.d.ts

@@ -1,7 +1,29 @@
+/** 鍵の種類 */
+export declare const API_KEY_KINDS: readonly ["server"];
+/** 鍵の種類 */
+export type ApiKeyKind = (typeof API_KEY_KINDS)[number];
+/** 鍵の操作 */
+export declare const API_KEY_OPERATIONS: readonly ["read", "read_drafts", "create", "update", "publish", "delete"];
+/** 鍵の操作 */
+export type ApiKeyOperation = (typeof API_KEY_OPERATIONS)[number];
+/** 書き込みの操作（書き込みの API（#500）まで画面で選べない） */
+export declare const API_KEY_WRITE_OPERATIONS: readonly ["create", "update", "publish", "delete"];
+/** 権限のキーで、すべての型（後から足す型を含む） */
+export declare const API_KEY_ALL_TYPES = "*";
+/** 鍵の権限（キーは型の id か API_KEY_ALL_TYPES） */
+export type ApiKeyPermissions = Readonly<Record<string, readonly ApiKeyOperation[]>>;
+/** 権限を省略した鍵と既存の鍵の権限 */
+export declare const DEFAULT_API_KEY_PERMISSIONS: {
+    readonly "*": readonly ["read"];
+};
+/** 鍵の権限が型の操作を許すか（read は read_drafts でも満たす） */
+export declare function apiKeyAllows(permissions: ApiKeyPermissions, type: string, operation: ApiKeyOperation): boolean;
 /** 一覧に表示する API の鍵（tail は鍵の末尾、revokedAt は失効の日時で有効なら null） */
 export type ApiKey = Readonly<{
     id: string;
     label: string;
+    kind: ApiKeyKind;
+    permissions: ApiKeyPermissions;
     tail: string;
     createdAt: string;
     revokedAt: string | null;
@@ -11,3 +33,8 @@ export declare const API_KEY_RATE: {
     readonly limit: 600;
     readonly period: 60;
 };
+/** 公開のエンドポイントで鍵や媒体の照合に失敗した要求の、接続元の IP ごとの上限（period 秒で limit 回、超えた IP は照合の前に429、platform#45） */
+export declare const PUBLIC_FAILURE_RATE: {
+    readonly limit: 30;
+    readonly period: 60;
+};

package/dist/types/cms-contract/src/errors.d.ts

@@ -20,6 +20,7 @@ export declare const ERROR_STATUS: {
     readonly invalid_api_key: 401;
     readonly account_not_found: 403;
     readonly invalid_preview_token: 403;
+    readonly api_key_forbidden: 403;
     readonly mcp_not_allowed: 403;
     readonly admin_only: 403;
     readonly forbidden: 403;
@@ -62,7 +63,7 @@ export type ErrorTarget = 'request' | 'role' | 'media' | 'entry' | 'asset' | 'mc
 /** エラーの補足の値（コードごとに使用する項目だけ） */
 export type ErrorParams = {
     /**
-     * 対象: not_found・own_only・forbidden・not_visible・no_linked_entry・editorial_only
+     * 対象: not_found・own_only・forbidden・not_visible・no_linked_entry・editorial_only・api_key_forbidden
      * - 文字列: モジュールの対象・コンテンツタイプの id
      */
     target?: ErrorTarget | (string & {});
@@ -71,9 +72,9 @@ export type ErrorParams = {
     /** 使用先: in_use */
     by?: 'uses' | 'places' | 'outputs' | 'entry' | 'writers' | 'members' | 'accounts';
     /** 状態の不一致の理由: invalid_state */
-    reason?: 'not_draft' | 'no_draft' | 'not_in_review' | 'request_handled' | 'deleted' | 'not_deleted' | 'schema_confirm' | 'no_publishing' | 'no_review';
+    reason?: 'not_draft' | 'no_draft' | 'not_in_review' | 'request_handled' | 'deleted' | 'not_deleted' | 'schema_confirm' | 'no_publishing' | 'no_review' | 'not_published';
     /** 取得の対象: upstream_failed */
-    resource?: 'page' | 'image' | 'webhook';
+    resource?: 'page' | 'image' | 'webhook' | 'microcms';
     /**
      * 名前
      * - no_linked_entry: 結び付くコンテンツタイプの表示名、account_not_found: メールアドレス