@yadeck/slide-schema 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 onfi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# @yadeck/slide-schema
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+deck / slide / block の基底スキーマと、Layout の Interface(`DeckLayout` / `SlideLayout` / `BlockLayout`)。
+
+YADECK は、AI が schema 付きの YAML に内容を書き、作り込みたいページだけを JSX で作るスライドジェネレータです。
+
+- ドキュメント: https://onfi.github.io/yadeck/
+- リポジトリ: https://github.com/onfi/yadeck
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./nodes.js";
+export * from "./interface.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./nodes.js";
+export * from "./interface.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/interface.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from "react";
+import type { z } from "zod";
+import type { BlockNode, DeckNode, SlideNode, Stage } from "./nodes.js";
+/**
+ * DI コンテナの契約型。`Props` は実装コンポーネントが受け取る共通部で、
+ * 実体は識別用のトークン。型引数は phantom として推論にだけ使う。
+ */
+export interface Interface<Props, S extends Stage = Stage> {
+    readonly name: string;
+    readonly stage: S;
+    readonly __props?: Props;
+}
+export declare function defineInterface<Props, S extends Stage = Stage>(name: string, stage: S): Interface<Props, S>;
+/** Interface から共通 props を取り出す */
+export type PropsOf<I> = I extends Interface<infer P, Stage> ? P : never;
+/** 各段の Layout が受け取る props。段のノードそのもの */
+export declare const DeckLayout: Interface<DeckNode, "deck">;
+export declare const SlideLayout: Interface<SlideNode, "slide">;
+export declare const BlockLayout: Interface<BlockNode, "block">;
+/** Layout の実装。利用者は素の React コンポーネントを書く */
+export type LayoutComponent<P> = (props: P) => ReactNode;
+/** Layout の `type` に渡す zod。自分のフィールドのみを記述する */
+export type FieldsSchema = z.ZodObject<z.ZodRawShape>;
+export type DeckOf<T extends FieldsSchema> = DeckNode & z.infer<T>;
+export type SlideOf<T extends FieldsSchema> = SlideNode & z.infer<T>;
+export type BlockOf<T extends FieldsSchema> = BlockNode & z.infer<T>;
+//# sourceMappingURL=interface.d.ts.map

package/dist/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,SAAS,CAAC,KAAK,EAAE,CAAC,SAAS,KAAK,GAAG,KAAK;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,CAAC,SAAS,KAAK,GAAG,KAAK,EAC5D,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,GACP,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAErB;AAED,iCAAiC;AACjC,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEzE,uCAAuC;AACvC,eAAO,MAAM,UAAU,6BAA0D,CAAC;AAClF,eAAO,MAAM,WAAW,+BAA8D,CAAC;AACvF,eAAO,MAAM,WAAW,+BAA8D,CAAC;AAEvF,yCAAyC;AACzC,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC;AAEzD,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAEtD,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,YAAY,IAAI,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnE,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,YAAY,IAAI,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrE,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,YAAY,IAAI,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/interface.js

@@ -0,0 +1,8 @@
+export function defineInterface(name, stage) {
+    return Object.freeze({ name, stage });
+}
+/** 各段の Layout が受け取る props。段のノードそのもの */
+export const DeckLayout = defineInterface("DeckLayout", "deck");
+export const SlideLayout = defineInterface("SlideLayout", "slide");
+export const BlockLayout = defineInterface("BlockLayout", "block");
+//# sourceMappingURL=interface.js.map

package/dist/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAAQ;IAER,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACxC,CAAC;AAKD,uCAAuC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAmB,YAAY,EAAE,MAAM,CAAC,CAAC;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAqB,aAAa,EAAE,OAAO,CAAC,CAAC;AACvF,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAqB,aAAa,EAAE,OAAO,CAAC,CAAC"}

package/dist/nodes.d.ts

@@ -0,0 +1,82 @@
+import { z } from "zod";
+/** 段。deck > slide > block の3段構造で、block が末端 */
+export type Stage = "deck" | "slide" | "block";
+export declare const STAGES: readonly Stage[];
+/** 各段の children を保持するキー。block は末端なので持たない */
+export declare const CHILDREN_KEY: {
+    readonly deck: "slides";
+    readonly slide: "items";
+};
+export type Tags = string[];
+/** 正規形スキーマのバージョン。data 側の `version` と照合する */
+export declare const SCHEMA_VERSION = "1";
+export declare const tagsSchema: z.ZodArray<z.ZodString>;
+/** id は loader が付与する位置由来の識別子。React の key や検証エラーの位置表示に使う */
+export declare const blockBase: z.ZodObject<{
+    id: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const slideBase: z.ZodObject<{
+    id: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const deckMeta: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const deckBase: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+    meta: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export type DeckMeta = z.infer<typeof deckMeta>;
+/** 正規形のノード。自分のフィールドは Layout の type が決めるため index signature を持つ */
+export interface BlockNode extends z.infer<typeof blockBase> {
+    [field: string]: unknown;
+}
+export interface SlideNode extends z.infer<typeof slideBase> {
+    items: BlockNode[];
+    [field: string]: unknown;
+}
+export interface DeckNode extends z.infer<typeof deckBase> {
+    slides: SlideNode[];
+    [field: string]: unknown;
+}
+export type NodeOf<S extends Stage> = S extends "deck" ? DeckNode : S extends "slide" ? SlideNode : BlockNode;
+export declare const BASE_SCHEMAS: {
+    readonly deck: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        tags: z.ZodArray<z.ZodString>;
+        meta: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            author: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            image: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+    }, z.core.$strip>;
+    readonly slide: z.ZodObject<{
+        id: z.ZodString;
+        tags: z.ZodArray<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly block: z.ZodObject<{
+        id: z.ZodString;
+        tags: z.ZodArray<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=nodes.d.ts.map

package/dist/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/C,eAAO,MAAM,MAAM,EAAE,SAAS,KAAK,EAA+B,CAAC;AAEnE,4CAA4C;AAC5C,eAAO,MAAM,YAAY;;;CAA8C,CAAC;AAExE,MAAM,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;AAE5B,4CAA4C;AAC5C,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,eAAO,MAAM,UAAU,yBAA6B,CAAC;AAErD,2DAA2D;AAC3D,eAAO,MAAM,SAAS;;;;iBAIpB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;iBAKpB,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;;;iBAQX,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;;;;;;;;iBAKnB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,iEAAiE;AACjE,MAAM,WAAW,SAAU,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC;IAC1D,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,SAAU,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC;IAC1D,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,QAAS,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC;IACxD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,MAAM,GAClD,QAAQ,GACR,CAAC,SAAS,OAAO,GACf,SAAS,GACT,SAAS,CAAC;AAEhB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;CAIf,CAAC"}

package/dist/nodes.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+export const STAGES = ["deck", "slide", "block"];
+/** 各段の children を保持するキー。block は末端なので持たない */
+export const CHILDREN_KEY = { deck: "slides", slide: "items" };
+/** 正規形スキーマのバージョン。data 側の `version` と照合する */
+export const SCHEMA_VERSION = "1";
+export const tagsSchema = z.array(z.string().min(1));
+/** id は loader が付与する位置由来の識別子。React の key や検証エラーの位置表示に使う */
+export const blockBase = z.object({
+    id: z.string(),
+    tags: tagsSchema,
+    text: z.string().optional(),
+});
+export const slideBase = z.object({
+    id: z.string(),
+    tags: tagsSchema,
+    /** 見出しの下に添える 1 行の説明。ページが何を示すかを簡潔に。RichText */
+    description: z.string().optional().describe("見出しの下に添える 1 行の説明"),
+});
+export const deckMeta = z
+    .object({
+    title: z.string().optional().describe("発表タイトル。省略すると header の title、無ければファイル名"),
+    author: z.string().optional().describe("発表者。省略すると header の author"),
+    date: z.string().optional(),
+    description: z.string().optional().describe("検索結果や SNS のカードに出す説明。省略すると表紙の副題と各ページの見出しから作る"),
+    image: z.string().optional().describe("SNS のカードに出す画像。URL か、siteUrl からの相対パス"),
+})
+    .loose();
+export const deckBase = z.object({
+    id: z.string(),
+    version: z.string().optional(),
+    tags: tagsSchema,
+    meta: deckMeta,
+});
+export const BASE_SCHEMAS = {
+    deck: deckBase,
+    slide: slideBase,
+    block: blockBase,
+};
+//# sourceMappingURL=nodes.js.map

package/dist/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../src/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,MAAM,GAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEnE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAW,CAAC;AAIxE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAErD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,UAAU;IAChB,8CAA8C;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CAChE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACnE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC1F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CAC7E,CAAC;KACD,KAAK,EAAE,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,QAAQ;CACf,CAAC,CAAC;AAyBH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;CACR,CAAC"}

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@yadeck/slide-schema",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "YADECK: base schema (version / meta / deck-slide-block) and layout interfaces",
+  "homepage": "https://onfi.github.io/yadeck/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/onfi/yadeck.git",
+    "directory": "packages/slide-schema"
+  },
+  "bugs": {
+    "url": "https://github.com/onfi/yadeck/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__snapshots__"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "react": "^19.3.0",
+    "zod": "^4.6.0"
+  },
+  "license": "MIT",
+  "author": "onfi",
+  "keywords": [
+    "yadeck",
+    "slides",
+    "presentation",
+    "yaml",
+    "react",
+    "ai"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./nodes.js";
+export * from "./interface.js";

package/src/interface.ts

@@ -0,0 +1,38 @@
+import type { ReactNode } from "react";
+import type { z } from "zod";
+import type { BlockNode, DeckNode, SlideNode, Stage } from "./nodes.js";
+
+/**
+ * DI コンテナの契約型。`Props` は実装コンポーネントが受け取る共通部で、
+ * 実体は識別用のトークン。型引数は phantom として推論にだけ使う。
+ */
+export interface Interface<Props, S extends Stage = Stage> {
+  readonly name: string;
+  readonly stage: S;
+  readonly __props?: Props;
+}
+
+export function defineInterface<Props, S extends Stage = Stage>(
+  name: string,
+  stage: S,
+): Interface<Props, S> {
+  return Object.freeze({ name, stage });
+}
+
+/** Interface から共通 props を取り出す */
+export type PropsOf<I> = I extends Interface<infer P, Stage> ? P : never;
+
+/** 各段の Layout が受け取る props。段のノードそのもの */
+export const DeckLayout = defineInterface<DeckNode, "deck">("DeckLayout", "deck");
+export const SlideLayout = defineInterface<SlideNode, "slide">("SlideLayout", "slide");
+export const BlockLayout = defineInterface<BlockNode, "block">("BlockLayout", "block");
+
+/** Layout の実装。利用者は素の React コンポーネントを書く */
+export type LayoutComponent<P> = (props: P) => ReactNode;
+
+/** Layout の `type` に渡す zod。自分のフィールドのみを記述する */
+export type FieldsSchema = z.ZodObject<z.ZodRawShape>;
+
+export type DeckOf<T extends FieldsSchema> = DeckNode & z.infer<T>;
+export type SlideOf<T extends FieldsSchema> = SlideNode & z.infer<T>;
+export type BlockOf<T extends FieldsSchema> = BlockNode & z.infer<T>;

package/src/nodes.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+
+/** 段。deck > slide > block の3段構造で、block が末端 */
+export type Stage = "deck" | "slide" | "block";
+
+export const STAGES: readonly Stage[] = ["deck", "slide", "block"];
+
+/** 各段の children を保持するキー。block は末端なので持たない */
+export const CHILDREN_KEY = { deck: "slides", slide: "items" } as const;
+
+export type Tags = string[];
+
+/** 正規形スキーマのバージョン。data 側の `version` と照合する */
+export const SCHEMA_VERSION = "1";
+
+export const tagsSchema = z.array(z.string().min(1));
+
+/** id は loader が付与する位置由来の識別子。React の key や検証エラーの位置表示に使う */
+export const blockBase = z.object({
+  id: z.string(),
+  tags: tagsSchema,
+  text: z.string().optional(),
+});
+
+export const slideBase = z.object({
+  id: z.string(),
+  tags: tagsSchema,
+  /** 見出しの下に添える 1 行の説明。ページが何を示すかを簡潔に。RichText */
+  description: z.string().optional().describe("見出しの下に添える 1 行の説明"),
+});
+
+export const deckMeta = z
+  .object({
+    title: z.string().optional().describe("発表タイトル。省略すると header の title、無ければファイル名"),
+    author: z.string().optional().describe("発表者。省略すると header の author"),
+    date: z.string().optional(),
+    description: z.string().optional().describe("検索結果や SNS のカードに出す説明。省略すると表紙の副題と各ページの見出しから作る"),
+    image: z.string().optional().describe("SNS のカードに出す画像。URL か、siteUrl からの相対パス"),
+  })
+  .loose();
+
+export const deckBase = z.object({
+  id: z.string(),
+  version: z.string().optional(),
+  tags: tagsSchema,
+  meta: deckMeta,
+});
+
+export type DeckMeta = z.infer<typeof deckMeta>;
+
+/** 正規形のノード。自分のフィールドは Layout の type が決めるため index signature を持つ */
+export interface BlockNode extends z.infer<typeof blockBase> {
+  [field: string]: unknown;
+}
+
+export interface SlideNode extends z.infer<typeof slideBase> {
+  items: BlockNode[];
+  [field: string]: unknown;
+}
+
+export interface DeckNode extends z.infer<typeof deckBase> {
+  slides: SlideNode[];
+  [field: string]: unknown;
+}
+
+export type NodeOf<S extends Stage> = S extends "deck"
+  ? DeckNode
+  : S extends "slide"
+    ? SlideNode
+    : BlockNode;
+
+export const BASE_SCHEMAS = {
+  deck: deckBase,
+  slide: slideBase,
+  block: blockBase,
+} as const;