@ryusenkei/maezae 0.6.0 → 0.7.1

package/README.md

@@ -19,6 +19,8 @@ maezae の SDK（導入先のサイト向け）
 - バインディング: `services: [{ "binding": "CMS", "service": "<CMS のサーバーの Worker>", "entrypoint": "Delivery" }]`
 - 媒体: URL のホスト名（媒体の管理画面のホスト名）
 - 鍵: 媒体の管理画面の「設定 → 連携」で発行した API の鍵
+- 1件の形: `{ id, ...項目, _meta: { created_at, updated_at, published_at } }`、published_at は公開の管理がある型だけ（0.7.0 から）
+- 一覧: 本文の種類の項目を含めない、本文は1件の取得か `/bundle` で
 
 ```ts
 import { createDeliveryClient } from '@ryusenkei/maezae/delivery';

package/dist/delivery.js

@@ -1,4 +1,4 @@
-import { c as croppedHotspot, d as createClock, i as typeOf, r as optionsOf, s as cropRect, t as pagePathOf } from "./page-UEKb7_gu.js";
+import { c as croppedHotspot, d as createClock, i as typeOf, r as optionsOf, s as cropRect, t as pagePathOf } from "./page-TFUlKv3R.js";
 // ../delivery-client/src/query.ts
 const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 /** in の値の検査（コンマを含む値はクエリで区切れない） */
@@ -277,10 +277,9 @@ function mediaOf(base, imageUrl) {
 // ../delivery-client/src/schema.ts
 /** 選択肢の項目から表示名の表（値 → 表示名、key はまとまりの中なら `links.kind` の形、選択肢の項目でなければ空） */
 const optionLabels = (schema, type, key) => Object.fromEntries(optionsOf(typeOf(schema, type), key).map((o) => [o.value, o.label]));
-/** 型の項目（コアの項目と追加の項目から、なければ例外: 導入先の設定の誤り） */
+/** 型の項目（なければ例外: 導入先の設定の誤り） */
 function fieldOf(schema, type, key) {
-	const t = typeOf(schema, type);
-	const field = [...t.core ?? [], ...t.fields].find((f) => f.key === key);
+	const field = typeOf(schema, type).fields.find((f) => f.key === key);
 	if (!field) throw new Error(`型 ${type} に項目 ${key} がない`);
 	return field;
 }

package/dist/model.js

@@ -1,4 +1,4 @@
-import { a as coverPosition, c as croppedHotspot, d as createClock, f as isDateOnly, i as typeOf, l as objectPosition, n as publicPathOf, o as coverStart, s as cropRect, t as pagePathOf, u as stillOf } from "./page-UEKb7_gu.js";
+import { a as coverPosition, c as croppedHotspot, d as createClock, f as isDateOnly, i as typeOf, l as objectPosition, n as publicPathOf, o as coverStart, s as cropRect, t as pagePathOf, u as stillOf } from "./page-TFUlKv3R.js";
 import { i as CORE_COMPONENTS, t as declaredComponentsSchema } from "./declared-9_jI3JXH.js";
 import "./src-BrLwIWaT.js";
 import { z } from "zod";
@@ -72,14 +72,13 @@ const IMAGE_TYPE = {
 	id: "image",
 	label: "画像",
 	description: "見せたい点（hotspot）と切り抜き（crop）を画像ごとに1つ保持、切り抜く場所すべてで共通",
-	core: file,
-	fields: []
+	fields: file
 };
 /** 動画の型（配信と再生は最初に使用する場所が決まったときに実装） */
 const VIDEO_TYPE = {
 	id: "video",
 	label: "動画",
-	core: [
+	fields: [
 		...file,
 		{
 			key: "duration",
@@ -94,30 +93,101 @@ const VIDEO_TYPE = {
 			accept: ["image"],
 			description: "読み込み前・動きを抑える設定・OG で代わりに表示"
 		}
-	],
-	fields: []
+	]
 };
 // ../model/src/capabilities.ts
-const NONE = {
-	editorial: false,
-	derived: false,
-	sources: false,
-	shared: false
+/** 出典の項目と、内側の項目の key */
+const SOURCES_FIELD = {
+	key: "sources",
+	source: "source",
+	note: "note"
 };
-const CORE_TABLES = {
-	articles: {
-		...NONE,
-		editorial: true,
-		derived: true,
-		sources: true
+// ../model/src/legacy.ts
+const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/** 記事の表の型だった目印（古いバージョンの table の値） */
+const ARTICLES = "articles";
+const PUBLISHED_AT = "published_at";
+/** 本文から作成する値の計算の項目（from は本文の項目の key） */
+const computedFields = (from) => [
+	{
+		key: "excerpt",
+		label: "抜粋",
+		type: "textarea",
+		computed: {
+			kind: "excerpt",
+			from
+		}
+	},
+	{
+		key: "read_min",
+		label: "読了の分",
+		type: "number",
+		computed: {
+			kind: "read_min",
+			from
+		}
 	},
-	sources: {
-		...NONE,
-		shared: true
+	{
+		key: "links",
+		label: "リンク先",
+		type: "text",
+		multiple: true,
+		computed: {
+			kind: "links",
+			from
+		}
 	}
-};
-/** 表の性質（コアの表にない表はすべてなし） */
-const tableTraitsOf = (table) => table && Object.hasOwn(CORE_TABLES, table) ? CORE_TABLES[table] : NONE;
+];
+/** 出典の参照の項目を複数のまとまりに */
+const sourcesGroup = (f) => ({
+	key: f.key,
+	label: f.label,
+	...f.private !== void 0 && { private: f.private },
+	type: "group",
+	multiple: true,
+	fields: [{
+		key: SOURCES_FIELD.source,
+		label: f.label,
+		type: "reference",
+		to: f.to
+	}, {
+		key: SOURCES_FIELD.note,
+		label: "注記",
+		type: "textarea"
+	}]
+});
+/** 古い形の型を今の形に（core・table のない型はそのまま） */
+function normalizeType(t) {
+	if (!("core" in t) && !("table" in t)) return t;
+	const { core, table, ...rest } = t;
+	const articles = table === ARTICLES;
+	const coreFields = (Array.isArray(core) ? core : []).filter(isRecord).flatMap((f) => {
+		if (articles && f.key === PUBLISHED_AT) return [];
+		if (articles && f.key === SOURCES_FIELD.key && f.type === "reference") return [sourcesGroup(f)];
+		return [f];
+	});
+	const keys = new Set(coreFields.map((f) => f.key));
+	const fields = [...coreFields, ...(Array.isArray(t.fields) ? t.fields : []).filter((f) => !isRecord(f) || !keys.has(f.key))];
+	if (!articles) return {
+		...rest,
+		fields
+	};
+	const body = fields.find((f) => isRecord(f) && f.type === "body");
+	const present = new Set(fields.filter(isRecord).map((f) => f.key));
+	const computed = body ? computedFields(String(body.key)).filter((f) => !present.has(f.key)) : [];
+	return {
+		...rest,
+		fields: [...fields, ...computed]
+	};
+}
+/** 古い形のスキーマの JSON を今の形に（形の分からない値はそのまま、検査は parseModel） */
+function normalizeLegacyModel(json) {
+	if (!isRecord(json) || !Array.isArray(json.types)) return json;
+	return {
+		...json,
+		types: json.types.map((t) => isRecord(t) ? normalizeType(t) : t)
+	};
+}
 // ../model/src/schema.ts
 const key = z.string().regex(/^[a-z][a-z0-9_]*$/, "id は英小文字で始まり、英小文字・数字・アンダーラインだけ");
 const fieldKey = z.string().regex(/^[a-z][a-zA-Z0-9_-]*$/, "key は英小文字で始まり、英字・数字・アンダーライン・ハイフンだけ");
@@ -125,6 +195,14 @@ const condition = z.object({
 	key: fieldKey,
 	in: z.array(z.string().min(1)).min(1)
 });
+const computed = z.object({
+	kind: z.enum([
+		"excerpt",
+		"read_min",
+		"links"
+	]),
+	from: fieldKey
+});
 const base = {
 	key: fieldKey,
 	label: z.string().min(1),
@@ -138,7 +216,8 @@ const base = {
 	when: condition.optional(),
 	private: z.boolean().optional(),
 	adminOnly: z.boolean().optional(),
-	pendingUntil: fieldKey.optional()
+	pendingUntil: fieldKey.optional(),
+	computed: computed.optional()
 };
 const frame = z.object({
 	when: condition.optional(),
@@ -296,8 +375,7 @@ const nestedRules = (fields) => fields.flatMap((f) => (f.fields ?? []).flatMap((
 /**
 * システムの値と同じ名前で、項目の key に使用できない名前（API・配信が項目の値を上書きするため）
 * - すべての型: 行の ID・作成と更新の日時・作成者、管理画面の一覧で参照する行の数 uses
-* - 公開の管理がある型と、コアの表を持つ型の追加の項目: 編集の機能の列
-* - 本文から作成する列を持つ表の型: excerpt・read_min・links
+* - 公開の管理がある型: 公開の機能の値
 * - 対象外: API・配信の値に出ない列 type、導入先の設定で決まるアカウントの email・account_role
 */
 const RESERVED = [
@@ -315,22 +393,25 @@ const RESERVED_EDITORIAL = [
 	"review_note",
 	"assignee"
 ];
-const RESERVED_DERIVED = [
-	"excerpt",
-	"read_min",
-	"links"
-];
-/** 予約の名前と同じ最上位の key（コアの項目は表の列そのものなので、編集の機能の列は対象外） */
+/** 予約の名前と同じ最上位の key */
 function reservedKeysOf(t) {
-	const derived = tableTraitsOf(t.table).derived ? RESERVED_DERIVED : [];
-	const editorial = (t.publishing ?? "none") !== "none" || t.table ? RESERVED_EDITORIAL : [];
-	const core = t.core ?? [];
-	const extra = [...t.fields.map((f) => f.key), ...(t.counts ?? []).map((c) => c.key)];
-	return [...core.map((f) => f.key).filter((k) => [...RESERVED, ...derived].includes(k)), ...extra.filter((k) => [
-		...RESERVED,
-		...derived,
-		...editorial
-	].includes(k))];
+	const reserved = [...RESERVED, ...(t.publishing ?? "none") !== "none" ? RESERVED_EDITORIAL : []];
+	return [...t.fields.map((f) => f.key), ...(t.counts ?? []).map((c) => c.key)].filter((k) => reserved.includes(k));
+}
+/** 計算の種類ごとに受け付ける項目の種類 */
+const COMPUTED_TYPES = {
+	excerpt: (f) => (f.type === "text" || f.type === "textarea") && !f.multiple,
+	read_min: (f) => f.type === "number",
+	links: (f) => f.type === "text" && Boolean(f.multiple)
+};
+/** 計算の項目の誤り（最上位の項目と、まとまりの中にある計算の項目） */
+function computedProblems(fields) {
+	const nested = (fs, path) => fs.flatMap((f) => [...f.computed ? [`${path}${f.key}: まとまりの中の項目は計算の項目なし`] : [], ...nested(f.fields ?? [], `${path}${f.key}.`)]);
+	return fields.flatMap((f) => {
+		const inner = nested(f.fields ?? [], `${f.key}.`);
+		if (!f.computed) return inner;
+		return [...[...fields.find((g) => g.key === f.computed.from)?.type === "body" ? [] : [`${f.key}: 計算の元 ${f.computed.from} が同じ型の本文の項目でない`], ...COMPUTED_TYPES[f.computed.kind]?.(f) ? [] : [`${f.key}: 計算の種類 ${f.computed.kind} に合わない項目の種類 ${f.type}`]], ...inner];
+	});
 }
 /** 本文の項目が使用する部品の名前（まとまりの中も、key は項目の key） */
 const bodyComponents = (fields) => fields.flatMap((f) => f.type === "body" ? f.profile.components.map((name) => ({
@@ -349,8 +430,6 @@ const contentType = z.object({
 		"draft",
 		"review"
 	]).optional(),
-	table: key.optional(),
-	core: z.array(field).optional(),
 	fields: z.array(field),
 	pages: z.array(page).optional(),
 	counts: z.array(z.object({
@@ -360,29 +439,33 @@ const contentType = z.object({
 	})).optional(),
 	og: z.string().startsWith("/", "OG 画像の雛形は / で始まる").optional(),
 	idInput: z.boolean().optional()
-}).refine((t) => t.format !== "object" || !t.core?.length, { message: "オブジェクト形式の型はコアの項目なし" }).refine((t) => new Set([...t.core ?? [], ...t.fields].map((f) => f.key)).size === (t.core?.length ?? 0) + t.fields.length, { message: "項目の key が重複（コアの項目を含む）" }).refine((t) => conditionsValid([...t.core ?? [], ...t.fields]), { message: "項目の条件が同じ階層の選択肢の項目と値を指していない" }).refine((t) => (t.pages ?? []).every((p) => conditionValid(p.when, [...t.core ?? [], ...t.fields])), { message: "ページの条件が型の選択肢の項目と値を指していない" }).superRefine((t, ctx) => {
+}).refine((t) => new Set(t.fields.map((f) => f.key)).size === t.fields.length, { message: "項目の key が重複" }).refine((t) => conditionsValid(t.fields), { message: "項目の条件が同じ階層の選択肢の項目と値を指していない" }).refine((t) => (t.pages ?? []).every((p) => conditionValid(p.when, t.fields)), { message: "ページの条件が型の選択肢の項目と値を指していない" }).superRefine((t, ctx) => {
 	for (const k of reservedKeysOf(t)) ctx.addIssue({
 		code: "custom",
 		message: `型 ${t.id} の key ${k} はシステムの値と同じ名前（別の key に）`
 	});
-	for (const k of nestedRules([...t.core ?? [], ...t.fields])) ctx.addIssue({
+	for (const k of nestedRules(t.fields)) ctx.addIssue({
 		code: "custom",
 		message: `型 ${t.id} の項目 ${k}: まとまりの中の項目は決まる値 derive・参照先で固定 fixedBy なし`
 	});
+	for (const m of computedProblems(t.fields)) ctx.addIssue({
+		code: "custom",
+		message: `型 ${t.id} の項目 ${m}`
+	});
 });
 const modelSchema = z.object({
 	components: declaredComponentsSchema.optional(),
 	types: z.array(contentType).refine((ts) => new Set(ts.map((t) => t.id)).size === ts.length, { message: "型の id が重複" }).superRefine((ts, ctx) => {
 		const ids = new Set(ts.map((t) => t.id));
-		for (const t of ts) for (const to of referenceTargets([...t.core ?? [], ...t.fields])) if (!ids.has(to)) ctx.addIssue({
+		for (const t of ts) for (const to of referenceTargets(t.fields)) if (!ids.has(to)) ctx.addIssue({
 			code: "custom",
 			message: `型 ${t.id} の参照先 ${to} がスキーマにない`
 		});
 		for (const t of ts) {
-			const keys = new Set([...t.core ?? [], ...t.fields].map((f) => f.key));
+			const keys = new Set(t.fields.map((f) => f.key));
 			for (const c of t.counts ?? []) {
 				const from = ts.find((x) => x.id === c.from);
-				const ref = from && [...from.core ?? [], ...from.fields].find((f) => f.key === c.field);
+				const ref = from && from.fields.find((f) => f.key === c.field);
 				if (ref?.type !== "reference" || ref.to !== t.id) ctx.addIssue({
 					code: "custom",
 					message: `型 ${t.id} の被参照の件数 ${c.key}: 型 ${c.from} の参照の項目 ${c.field} がこの型を指していない`
@@ -396,13 +479,13 @@ const modelSchema = z.object({
 	})
 }).superRefine((m, ctx) => {
 	const known = /* @__PURE__ */ new Set([...CORE_COMPONENTS.map((c) => c.name), ...(m.components ?? []).map((c) => c.name)]);
-	for (const t of m.types) for (const { key, name } of bodyComponents([...t.core ?? [], ...t.fields])) if (!known.has(name)) ctx.addIssue({
+	for (const t of m.types) for (const { key, name } of bodyComponents(t.fields)) if (!known.has(name)) ctx.addIssue({
 		code: "custom",
 		message: `型 ${t.id} の本文の項目 ${key} の部品 ${name} がコアの部品にも宣言 components にもない`
 	});
 });
 /** コンテンツスキーマの JSON を検査して返却（形が合わなければ例外、理由は zod の issues） */
-const parseModel = (json) => modelSchema.parse(json);
+const parseModel = (json) => modelSchema.parse(normalizeLegacyModel(json));
 // ../model/src/screens.ts
 /** メニューにある全項目の id（グループの中も、上から順） */
 const menuItemsOf = (menu) => menu.flatMap((e) => typeof e === "string" ? [e] : e.items);
@@ -443,9 +526,8 @@ const DEFAULT_SCHEMA = { "types": [
 	{
 		"id": "post",
 		"label": "投稿",
-		"table": "articles",
 		"publishing": "review",
-		"core": [
+		"fields": [
 			{
 				"key": "title",
 				"label": "タイトル",
@@ -498,24 +580,47 @@ const DEFAULT_SCHEMA = { "types": [
 					"components": ["gallery", "link-card"]
 				}
 			},
-			{
-				"key": "published_at",
-				"label": "公開日時",
-				"type": "datetime"
-			},
 			{
 				"key": "revised_at",
 				"label": "更新日時",
 				"type": "datetime"
+			},
+			{
+				"key": "tags",
+				"label": "タグ",
+				"type": "reference",
+				"to": "tag",
+				"multiple": true
+			},
+			{
+				"key": "excerpt",
+				"label": "抜粋",
+				"type": "textarea",
+				"computed": {
+					"kind": "excerpt",
+					"from": "body"
+				}
+			},
+			{
+				"key": "read_min",
+				"label": "読了の分",
+				"type": "number",
+				"computed": {
+					"kind": "read_min",
+					"from": "body"
+				}
+			},
+			{
+				"key": "links",
+				"label": "リンク先",
+				"type": "text",
+				"multiple": true,
+				"computed": {
+					"kind": "links",
+					"from": "body"
+				}
 			}
 		],
-		"fields": [{
-			"key": "tags",
-			"label": "タグ",
-			"type": "reference",
-			"to": "tag",
-			"multiple": true
-		}],
 		"pages": [{
 			"path": "/posts/{id}",
 			"public": [{
@@ -565,7 +670,7 @@ const DEFAULT_SCHEMA = { "types": [
 		"id": "image",
 		"label": "画像",
 		"description": "見せたい点（hotspot）と切り抜き（crop）を画像ごとに1つ保持、切り抜く場所すべてで共通",
-		"core": [
+		"fields": [
 			{
 				"key": "mime_type",
 				"label": "形式",
@@ -600,13 +705,12 @@ const DEFAULT_SCHEMA = { "types": [
 				"type": "text",
 				"description": "使用する側の既定の値、使用する場所ごとに上書き可"
 			}
-		],
-		"fields": []
+		]
 	},
 	{
 		"id": "video",
 		"label": "動画",
-		"core": [
+		"fields": [
 			{
 				"key": "mime_type",
 				"label": "形式",
@@ -654,8 +758,7 @@ const DEFAULT_SCHEMA = { "types": [
 				"accept": ["image"],
 				"description": "読み込み前・動きを抑える設定・OG で代わりに表示"
 			}
-		],
-		"fields": []
+		]
 	}
 ] };
 /** 既定の画面設定（新しい媒体の作成で適用する中立の値、移入する screens の土台） */

package/dist/{page-UEKb7_gu.js → page-TFUlKv3R.js}

@@ -107,10 +107,10 @@ function typeOf(model, id) {
 	if (!type) throw new Error(`コンテンツスキーマに型 ${id} がない`);
 	return type;
 }
-/** 選択肢の項目の選択肢（コアの項目と追加の項目から、まとまりの中の項目は `links.kind` の形、選択肢の項目でなければ空） */
+/** 選択肢の項目の選択肢（まとまりの中の項目は `links.kind` の形、選択肢の項目でなければ空） */
 function optionsOf(type, key) {
 	const [head, ...rest] = key.split(".");
-	let field = [...type.core ?? [], ...type.fields].find((f) => f.key === head);
+	let field = type.fields.find((f) => f.key === head);
 	for (const k of rest) field = field?.type === "group" ? field.fields.find((f) => f.key === k) : void 0;
 	return field?.type === "select" ? field.options : [];
 }

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

@@ -45,8 +45,6 @@ export declare function createDeliveryClient(delivery: Delivery, { drafts, at }?
         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[];

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

@@ -3,4 +3,4 @@ export { deliveredImageUrl, mediaOf, type ImageUrl, type MediaOf } from './media
 export { imageParamsOf, parseMediaPath, withImageParams, type ImageParams, type MediaPath } from '../../model/src/index.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';
+export type { DeliveredAsset, FieldValue, Item, ItemMeta, ItemOf } from './values.js';

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

@@ -29,13 +29,14 @@ type SortableKey<T extends ContentType> = FieldsOf<T> extends infer F ? (F exten
     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 ごと、公開日時・更新日時は範囲） */
+/** 並べ替えの key（項目・公開日時・作成日時・更新日時・id） */
+type OrderKey<T extends ContentType> = SortableKey<T> | 'published_at' | 'created_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>;
+    created_at?: Range<string>;
     updated_at?: Range<string>;
 }>;
 /**

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

@@ -1,7 +1,7 @@
 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;

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

@@ -1,6 +1,6 @@
 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） */
+/** 配信 API の1件の値（id・項目の key・メタ情報 _meta） */
 export type Item = Readonly<Record<string, unknown>>;
 /** 配信 API が解決した実体（url は配信 URL で配信のオリジンがある CMS だけ、hotspot・crop は元の画像に対する割合） */
 export type DeliveredAsset = Readonly<{
@@ -52,12 +52,18 @@ type GroupValue<G extends FieldDef> = {
 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 FieldsOf<T extends ContentType> = T['fields'][number];
+/** 1件のメタ情報（作成・更新の日時、公開日時は公開の管理がある型だけで未公開は null、日時は `ISO 8601` の UTC） */
+export type ItemMeta = Readonly<{
+    created_at: string;
+    updated_at: string;
+    published_at?: string | null;
+}>;
+/** 型の宣言から導く1件の値（id・項目の key ごとの値・メタ情報 _meta） */
 export type ItemOf<T extends ContentType> = Readonly<{
     id: string;
-    updated_at: string;
+    _meta: ItemMeta;
 } & {
     [F in FieldsOf<T> as F['key']]: FieldValue<F>;
 }>;

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

@@ -1,20 +1,23 @@
-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;
+import { type ContentModel, type ContentType, type FieldDef } from './model.js';
+/** 出典の項目と、内側の項目の key */
+export declare const SOURCES_FIELD: {
+    readonly key: "sources";
+    readonly source: "source";
+    readonly note: "note";
+};
+/** 出典の項目の定義（参照の項目 source の参照先 to） */
+export type SourcesField = Extract<FieldDef, {
+    type: 'group';
+}> & Readonly<{
+    to: string;
 }>;
-/** 表の性質（コアの表にない表はすべてなし） */
-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;
+/** 主の型（スキーマの順で先頭、なければ null） */
+export declare const primaryTypeOf: (model: ContentModel) => ContentType | null;
+/** 主の型（なければ例外: その型を前提にする画面・処理だけが使用） */
+export declare function requiredPrimaryTypeOf(model: ContentModel): ContentType;
+/** 型の出典の項目（なければ null） */
+export declare function sourcesFieldOf(type: ContentType): SourcesField | null;
+/** 出典の型（出典の項目の参照先でスキーマの順で先頭、なければ null） */
+export declare function sourceTypeOf(model: ContentModel): ContentType | null;
+/** 出典の値にある参照の ID（注の順、空と形の誤りは除外） */
+export declare const sourceIdsOf: (value: unknown) => string[];

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

@@ -1,4 +1,4 @@
-import type { ContentModel } from './model.js';
+import { type ContentModel } from './model.js';
 /** 変更の扱い */
 export type ChangeLevel = 'safe' | 'confirm' | 'forbidden';
 /** 変更の種類 */
@@ -13,11 +13,9 @@ export type SchemaChange = Readonly<{
     value?: string;
     message: string;
 }>;
-/** 差分の条件（fixed はコードで固定の定義、history は保存済みの版より古い過去の版） */
+/** 差分の条件（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/index.d.ts

@@ -3,12 +3,13 @@ export { assetRefSchema, cropSchema, hotspotSchema, mediaSchema, type Asset, typ
 export { coverPosition, coverStart, cropRect, croppedHotspot, objectPosition, stillOf, type CropRect } from './image.js';
 export { IMAGE_TYPE, VIDEO_TYPE } from './media.js';
 export { IMAGE_SIZE_MAX, imageParamsOf, mediaExtOf, mediaMimeOf, mediaPathOf, parseMediaPath, withImageParams, type ImageParams, type MediaPath } from './mediaUrl.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 { diffSchema, type ChangeKind, type ChangeLevel, type DiffOptions, type SchemaChange } from './changes.js';
+export { primaryTypeOf, requiredPrimaryTypeOf, SOURCES_FIELD, sourceIdsOf, sourcesFieldOf, sourceTypeOf, type SourcesField } from './capabilities.js';
 export { appliesTo, checkFields, fieldsFor } from './check.js';
 export { deliveredFields, emptyValues, pickValues, referencedIds, referencesOf, valueFieldsOf } from './values.js';
-export { idInputOf, 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 { entryRefsOf, type EntryRef } from './refs.js';
+export { bodyFieldOf, bodyFieldsOf, computedFieldsOf, idInputOf, imageFieldOf, initialValueOf, isEditorial, isInputField, isListType, isMediaType, isSingleton, isStoredType, MEDIA_TYPE_IDS, optionLabelOf, optionsOf, publishingOf, requestReferencesOf, titleFieldOf, toneOf, typeOf, type ComputedKind, type FieldComputed, 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, withPagesFrom, 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';

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

@@ -0,0 +1,2 @@
+/** 古い形のスキーマの JSON を今の形に（形の分からない値はそのまま、検査は parseModel） */
+export declare function normalizeLegacyModel(json: unknown): unknown;

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

@@ -15,6 +15,15 @@ type FieldBase = Readonly<{
     adminOnly?: boolean;
     /** 未定の null にできる期限: 型の最上位の項目 key に値が入ると未定なし（方針のページの制定日など） */
     pendingUntil?: string;
+    /** 計算の項目（保存のときに本文の項目から作成、入力の対象外） */
+    computed?: FieldComputed;
+}>;
+/** 計算の項目の種類（excerpt は導入の段落・read_min は読了の分・links はサイト内へのリンク先） */
+export type ComputedKind = 'excerpt' | 'read_min' | 'links';
+/** 計算の項目の宣言（from は同じ型の最上位にある本文の項目の key） */
+export type FieldComputed = Readonly<{
+    kind: ComputedKind;
+    from: string;
 }>;
 /** 項目の対象の条件（同じ階層にある選択肢の項目 key の値が in のいずれか） */
 export type FieldCondition = Readonly<{
@@ -67,7 +76,7 @@ export type ReferenceRules = Readonly<{
     published?: boolean;
     linkedBy?: string;
 }>;
-/** メディアの種類（コアの型 image・video の id と同じ） */
+/** メディアの種類（メディアの型 image・video の id と同じ） */
 export type MediaKind = 'image' | 'video';
 /** 項目の定義 */
 export type FieldDef = FieldBase & Readonly<{
@@ -95,7 +104,7 @@ export type FieldDef = FieldBase & Readonly<{
 } & Counts) | ({
     type: 'reference';
     to: string;
-    multiple?: boolean; /** 候補の絞り込み（参照先のコアの項目の key と値、例: 企画の種類が特集） */
+    multiple?: boolean; /** 候補の絞り込み（参照先の項目の key と値、例: 企画の種類が特集） */
     where?: Readonly<Record<string, string>>; /** 候補にない名前を追加の依頼で付けられる（参照先は一覧で管理する汎用の型、承認で行を作成） */
     requests?: boolean; /** 値が空のときの表示名（持ち主のいない行の名義など） */
     emptyLabel?: string;
@@ -117,19 +126,14 @@ export type ContentFormat = 'list' | 'object';
 /** 公開の管理（なし・下書きと公開・レビューあり） */
 export type Publishing = 'none' | 'draft' | 'review';
 /**
- * 型の定義
- * - id: コアの型の ID か、追加の型の ID
- * - core: コアで固定の項目、fields: 導入先の追加の項目
- * - format: 形式（なしはリスト形式）、オブジェクト形式はコアの項目なし
+ * コンテンツタイプ
+ * - id: 型の ID（メディアの型は image・video）
+ * - format: 形式（なしはリスト形式）
  * - publishing: 公開の管理（なしは管理なし）
- * - table: コアの項目を持つ型の表
  * - pages: サイトのページの URL と公開中の条件（なしはページのない型、page.ts）
- */
-/**
- * コンテンツタイプ
  * - counts: 被参照の件数（ページの公開中の条件・ページの公開で必須の判定に使用）
  * - og: サイトの OG 画像のパスの雛形（{key} は行の値、管理画面の OG 画像のプレビュー）
- * - idInput: 作成のときに管理画面で ID を入力できる（汎用の型だけ、ページのある型は常に入力可、空欄は自動）
+ * - idInput: 作成のときに管理画面で ID を入力できる（ページのある型は常に入力可、空欄は自動）
  */
 export type ContentType = Readonly<{
     id: string;
@@ -137,8 +141,6 @@ export type ContentType = Readonly<{
     description?: string;
     format?: ContentFormat;
     publishing?: Publishing;
-    table?: string;
-    core?: readonly FieldDef[];
     fields: readonly FieldDef[];
     pages?: readonly PageDef[];
     counts?: readonly CountDef[];
@@ -155,15 +157,17 @@ export type FieldProblem = Readonly<{
     path: string;
     message: string;
 }>;
-/** 汎用の表 entries に保存する型か（コアの項目がない型、コアの項目がある型は専用の表） */
-export declare const isEntryType: (type: ContentType) => boolean;
-/** 作成のときに ID を入力できる型か（汎用の型で、宣言 idInput かページを持つ型） */
+/** メディアの型の id（項目の種類 media の accept と同じ、行は表 assets） */
+export declare const MEDIA_TYPE_IDS: readonly MediaKind[];
+/** メディアの型か（画像・動画、行は表 assets で一覧・作成・配信の対象外） */
+export declare const isMediaType: (type: ContentType) => boolean;
+/** 作成のときに ID を入力できる型か（メディアの型を除き、宣言 idInput かページを持つ型） */
 export declare const idInputOf: (type: ContentType) => boolean;
 /** オブジェクト形式の型か（行は表 entries の id が型の id の1行、一覧・作成の対象外） */
 export declare const isSingleton: (type: ContentType) => boolean;
 /** 公開の管理（なしは none） */
 export declare const publishingOf: (type: ContentType) => Publishing;
-/** 一覧で行を追加・管理する汎用の型か（取材相手・トピックなど、オブジェクト形式の型を除く） */
+/** 一覧で行を追加・管理する型か（オブジェクト形式の型・メディアの型を除く） */
 export declare const isListType: (type: ContentType) => boolean;
 /**
  * 編集の機能を持つ型か（公開の管理がある一覧の型）
@@ -171,11 +175,11 @@ export declare const isListType: (type: ContentType) => boolean;
  * - 提出と差し戻し: レビューありの型だけ
  */
 export declare const isEditorial: (type: ContentType) => boolean;
-/** 型の行を保存する表（汎用の型は entries、表を持たない型は null） */
-export declare const tableOf: (type: ContentType) => string | null;
+/** 型の行を表 entries に保存するか（メディアの型を除くすべて） */
+export declare const isStoredType: (type: ContentType) => boolean;
 /** コンテンツスキーマの型（id から、なければ例外: 導入先の設定の誤り） */
 export declare function typeOf(model: ContentModel, id: string): ContentType;
-/** 選択肢の項目の選択肢（コアの項目と追加の項目から、まとまりの中の項目は `links.kind` の形、選択肢の項目でなければ空） */
+/** 選択肢の項目の選択肢（まとまりの中の項目は `links.kind` の形、選択肢の項目でなければ空） */
 export declare function optionsOf(type: ContentType, key: string): readonly SelectOption[];
 /** 新しい行の初期値（セレクトは項目の initial、なければ先頭の選択肢、セレクトでなければ空文字） */
 export declare const initialValueOf: (type: ContentType, key: string) => string;
@@ -183,11 +187,23 @@ export declare const initialValueOf: (type: ContentType, key: string) => string;
 export declare const toneOf: (type: ContentType, key: string, value: string) => OptionTone;
 /** 選択肢の表示名（なければ値のまま） */
 export declare const optionLabelOf: (type: ContentType, key: string, value: string) => string;
+/** 入力する項目か（計算の項目を除く） */
+export declare const isInputField: (f: FieldDef) => boolean;
 /** 型の表示名の項目（複数でない文字の項目で先頭、なければ null: 行の表示名に使用） */
 export declare const titleFieldOf: (type: ContentType) => FieldDef | null;
-/** 型のサムネの項目（複数でない画像の項目で先頭、なければ null: 一覧・参照の候補に使用） */
+/** 型のサムネの項目（複数でない画像の項目で先頭、なければ null: 一覧・参照の候補・アイキャッチに使用） */
 export declare const imageFieldOf: (type: ContentType) => FieldDef | null;
-/** 追加の依頼ができる参照の項目（コアと追加の項目、参照先が一覧で管理する汎用の型で requests の指定があるもの、タグ・分類など） */
+/** 型の本文の項目（最上位で先頭、なければ null: 本文の Markdown・点検・制作の案内に使用） */
+export declare const bodyFieldOf: (type: ContentType) => Extract<FieldDef, {
+    type: "body";
+}> | null;
+/** 最上位で本文の種類の項目（表 entry_bodies に保存、一覧では取得しない） */
+export declare const bodyFieldsOf: (type: ContentType) => Extract<FieldDef, {
+    type: "body";
+}>[];
+/** 型の計算の項目（最上位） */
+export declare const computedFieldsOf: (type: ContentType) => FieldDef[];
+/** 追加の依頼ができる参照の項目（参照先が一覧で管理する型で requests の指定があるもの、タグ・分類など） */
 export declare function requestReferencesOf(model: ContentModel, type: ContentType): Extract<FieldDef, {
     type: 'reference';
 }>[];

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

@@ -1,4 +1,4 @@
-import type { ContentType, FieldCondition } from './model.js';
+import type { ContentModel, ContentType, FieldCondition } from './model.js';
 /** ページの行の値（項目の key と値、表の列・集計の値も含む） */
 export type PageEntry = Readonly<Record<string, unknown>>;
 /**
@@ -43,5 +43,10 @@ export declare function pagePathOf(type: ContentType, entry: PageEntry): string
 export declare function hasPublicPage(type: ContentType, entry: PageEntry, now: string): boolean;
 /** 公開中のページのパス（公開前・予約中・ページのない行は null、now は今の時刻の ISO 文字列） */
 export declare function publicPathOf(type: ContentType, entry: PageEntry, now: string): string | null;
-/** 画像の項目 key の枠（コアの項目と追加の項目の最上位から、枠の宣言がなければ null） */
+/** 画像の項目 key の枠（最上位の項目から、枠の宣言がなければ null） */
 export declare function imageFrameOf(type: ContentType, key: string, entry: PageEntry): ImageFrame | null;
+/**
+ * 保存済みでページの宣言がない型に、最初の版の宣言を補う（宣言の導入より前に保存した版の読み込み）
+ * - ページなしにするのは空の配列（補わない）
+ */
+export declare function withPagesFrom(first: ContentModel, stored: ContentModel): ContentModel;

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

@@ -0,0 +1,10 @@
+import type { FieldDef } from './model.js';
+/** 参照の逆引きの1行（toType は参照先の型、toId は参照先の ID） */
+export type EntryRef = Readonly<{
+    key: string;
+    position: number;
+    toType: string;
+    toId: string;
+}>;
+/** 行の値の参照（fields は型の項目、values は行の値） */
+export declare function entryRefsOf(fields: readonly FieldDef[], values: unknown): EntryRef[];

package/dist/types/sdk/src/delivery.d.ts

@@ -1,2 +1,2 @@
 export { createDeliveryClient, createDeliveryClock, deliveredImageUrl, DELIVERY_PATH, DeliveryError, fieldOf, imageParamsOf, limitOf, listParams, mediaOf, optionLabels, pagePath, parseMediaPath, subPath, withImageParams } from '../../delivery-client/src/index.js';
-export type { BundleResult, DeliveredAsset, Delivery, DeliveryClient, DeliveryClock, FieldValue, ImageParams, ImageUrl, Item, ItemOf, ListFilter, ListQuery, MediaOf, MediaPath, Page, Prefetched } from '../../delivery-client/src/index.js';
+export type { BundleResult, DeliveredAsset, Delivery, DeliveryClient, DeliveryClock, FieldValue, ImageParams, ImageUrl, Item, ItemMeta, ItemOf, ListFilter, ListQuery, MediaOf, MediaPath, Page, Prefetched } from '../../delivery-client/src/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryusenkei/maezae",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "maezae の導入先のサイト向けの SDK（配信 API の取得・本文の型・プレビューの署名・手元の開発の配信 API）",
   "license": "UNLICENSED",
   "author": "RYUSENKEI",