mokkun 0.1.5 → 0.2.0

package/dist/types/lib.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Mokkun Library Entry Point
+ * YAML-based presentation and form builder
+ */
+import './style.css';
+import { parseYaml, parseYamlV2, parseV2Document, isV2Document, getScreen, getScreenNames, findFieldById } from './parser';
+import { mountViewV2, renderViewV2, type V2Controller, type V2Callbacks, type V2ViewState } from './renderer-v2';
+import { compileV2Warnings } from './parser/v2/compile-warnings';
+import type { MokkunSchema, ScreenDefinition, BuiltInThemeId } from './types';
+import type { MokkunV2Schema } from './types/schema-v2';
+/**
+ * Mokkun initialization options
+ */
+export interface MokkunInitOptions {
+    /** Container selector or element */
+    container: string | HTMLElement;
+    /** URL to YAML file */
+    yamlUrl?: string;
+    /** Inline YAML content */
+    yamlContent?: string;
+    /** Initial theme ('light' | 'dark') */
+    theme?: BuiltInThemeId | string;
+    /** v2 文書で、画面遷移時に location.hash も書き換える（既定 false） */
+    syncHash?: boolean;
+    /** Initial screen to display */
+    initialScreen?: string;
+    /** v2 文書: 現在のロール（app.roles の値）。ロール外の操作・ナビ・通知を出さない。未指定は全ロール分を表示 */
+    role?: string;
+    /** v2 文書: 最初の画面の状態（normal / success / error / empty / loading）。既定 normal（状態バナーなし） */
+    initialState?: V2ViewState;
+    /** Callback when ready */
+    onReady?: (instance: MokkunInstance) => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Callback when navigating between screens */
+    onNavigate?: (fromScreen: string, toScreen: string) => void;
+    /** Callback when form is submitted */
+    onSubmit?: (screenName: string, formData: Record<string, unknown>) => void;
+}
+/**
+ * Mokkun instance returned by init()
+ */
+export interface MokkunInstance {
+    /** Current schema（v2 文書のときは null。schemaV2 を使う） */
+    readonly schema: MokkunSchema | null;
+    /** Current v2 schema（v1 文書のときは null） */
+    readonly schemaV2: MokkunV2Schema | null;
+    /** Current screen name */
+    readonly currentScreen: string | null;
+    /** Navigate to a screen */
+    showScreen: (screenName: string) => void;
+    /** v2 文書: 現在のロール。変更すると現在の画面を描き直す（undefined は全ロール） */
+    setRole: (role: string | undefined) => void;
+    /** v2 文書: 現在の画面の状態。変更すると描き直す */
+    setState: (viewState: V2ViewState) => void;
+    /** v2 文書: 現在の画面で選べる状態（normal は常に。success / error / empty / loading は対応する states.* があるとき） */
+    getAvailableStates: () => V2ViewState[];
+    /** v2 文書: 現在のロール */
+    readonly role: string | undefined;
+    /** v2 文書: 現在の画面の状態 */
+    readonly viewState: V2ViewState;
+    /** Get available screen names */
+    getScreenNames: () => string[];
+    /** Change theme */
+    setTheme: (themeId: string) => void;
+    /** Get current theme */
+    getTheme: () => string | null;
+    /** Get current form data */
+    getFormData: () => Record<string, unknown> | null;
+    /** Destroy instance and cleanup */
+    destroy: () => void;
+}
+/**
+ * Initialize Mokkun with the given options
+ */
+declare function init(options: MokkunInitOptions): Promise<MokkunInstance>;
+/**
+ * Mokkun - YAML-based presentation and form builder
+ */
+export declare const Mokkun: {
+    /** Initialize Mokkun */
+    init: typeof init;
+    /** Library version */
+    VERSION: string;
+    /** Utility functions */
+    utils: {
+        parseYaml: typeof parseYaml;
+        parseYamlV2: typeof parseYamlV2;
+        compileV2Warnings: typeof compileV2Warnings;
+        /** v2 の状態の表示名（ビューアーのセレクトに使う） */
+        V2_STATE_LABELS: Record<V2ViewState, string>;
+        getScreen: typeof getScreen;
+        getScreenNames: typeof getScreenNames;
+        findFieldById: typeof findFieldById;
+    };
+    /** Theme management */
+    theme: {
+        apply: (id: string) => boolean;
+        getCurrent: () => string | null;
+        getAvailable: () => import("./types").ThemeDefinition[];
+    };
+};
+export type { MokkunSchema, ScreenDefinition, BuiltInThemeId, MokkunV2Schema };
+export { renderViewV2, mountViewV2, parseYamlV2, parseV2Document, isV2Document, compileV2Warnings };
+export type { V2Controller, V2Callbacks, V2ViewState };
+export type { V2RenderOptions, V2ActionPayload } from './renderer-v2';
+export type { V2CompileWarning } from './parser/v2/compile-warnings';
+export { Textarea, createTextarea, type TextareaState, type TextareaCallbacks, type TextareaConfig, } from './renderer/components/textarea';
+export { Combobox, type ComboboxOption, type ComboboxConfig, type ComboboxState, type ComboboxCallbacks, } from './renderer/components';

package/dist/types/loader/file-loader.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Mokkun - File Loader Module
+ * YAMLファイルの読み込み機能を提供
+ */
+import type { MokkunSchema } from '../types/schema';
+import type { MokkunV2Schema } from '../types/schema-v2';
+import type { ParseError } from '../parser/yaml-parser';
+/**
+ * ファイル読み込みエラーの種類
+ */
+export type FileLoadErrorType = 'INVALID_FILE_TYPE' | 'FILE_READ_ERROR' | 'FETCH_ERROR' | 'YAML_PARSE_ERROR' | 'NETWORK_ERROR';
+/**
+ * ファイル読み込みエラー
+ */
+export interface FileLoadError {
+    type: FileLoadErrorType;
+    message: string;
+    details?: string;
+    parseErrors?: ParseError[];
+}
+/**
+ * ファイル読み込み成功結果
+ */
+export interface FileLoadSuccess {
+    success: true;
+    /** v1 スキーマ。v2 文書では compileV2 の結果（変換できなければ null） */
+    schema: MokkunSchema | null;
+    /** v2 文書（mokkun: 2）のとき、検証済みの v2 スキーマ。v2 専用レンダラーの入力 */
+    schemaV2?: MokkunV2Schema;
+    fileName: string;
+    source: 'file' | 'url' | 'drop';
+    /** 読み込んだ YAML の原文（コメント・順序を保持） */
+    content: string;
+}
+/**
+ * ファイル読み込み失敗結果
+ */
+export interface FileLoadFailure {
+    success: false;
+    error: FileLoadError;
+}
+/**
+ * ファイル読み込み結果
+ */
+export type FileLoadResult = FileLoadSuccess | FileLoadFailure;
+/**
+ * ファイル読み込みコールバック
+ */
+export type FileLoadCallback = (result: FileLoadResult) => void;
+/**
+ * ドロップゾーンオプション
+ */
+export interface DropZoneOptions {
+    element: HTMLElement;
+    onLoad: FileLoadCallback;
+    onDragOver?: () => void;
+    onDragLeave?: () => void;
+    multiple?: boolean;
+}
+/**
+ * ファイル選択オプション
+ */
+export interface FileSelectOptions {
+    onLoad: FileLoadCallback;
+    multiple?: boolean;
+}
+/**
+ * ファイル名が許可された拡張子かチェック
+ */
+export declare function isValidFileName(fileName: string): boolean;
+/**
+ * ファイルタイプが許可されているかチェック
+ */
+export declare function isValidFileType(file: File): boolean;
+/**
+ * FileReaderでファイルを読み込み
+ */
+export declare function readFile(file: File, source: 'file' | 'drop'): Promise<FileLoadResult>;
+/**
+ * 複数ファイルを読み込み
+ */
+export declare function readFiles(files: FileList | File[], source: 'file' | 'drop'): Promise<FileLoadResult[]>;
+/**
+ * URLからYAMLファイルを読み込み
+ */
+export declare function loadFromUrl(url: string): Promise<FileLoadResult>;
+/**
+ * URLパラメータからYAMLパスを取得
+ */
+export declare function getYamlUrlFromParams(): string | null;
+/**
+ * URLパラメータで指定されたYAMLを読み込み
+ */
+export declare function loadFromUrlParams(): Promise<FileLoadResult | null>;
+/**
+ * ファイル選択input要素を作成
+ */
+export declare function createFileInput(options: FileSelectOptions): HTMLInputElement;
+/**
+ * ファイル選択ダイアログを開く
+ */
+export declare function openFileDialog(options: FileSelectOptions): void;
+/**
+ * ドロップゾーンをセットアップ
+ */
+export declare function setupDropZone(options: DropZoneOptions): () => void;
+/**
+ * エラーをフォーマットして表示用文字列に変換
+ */
+export declare function formatFileLoadError(error: FileLoadError): string;
+/**
+ * ファイル読み込みUIを生成
+ */
+export declare function renderFileLoaderUI(): string;
+/**
+ * ファイルローダーUIにイベントをアタッチ
+ */
+export declare function attachFileLoaderEvents(container: HTMLElement, onLoad: FileLoadCallback): () => void;

package/dist/types/loader/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Loader exports
+ */
+export * from './file-loader';

package/dist/types/parser/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Parser exports
+ */
+export * from './yaml-parser';
+export * from './v2';

package/dist/types/parser/key-normalizer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * YAML キー正規化
+ *
+ * YAML の正規形は camelCase。内部表現は snake_case のまま維持するため、
+ * パーサーの入口で camelCase キーを内部の snake_case キーへ変換する。
+ * snake_case の YAML（teamkit generate-ui の出力など）は変換せずそのまま通す（後方互換）。
+ */
+/**
+ * 内部で使用する snake_case キーの完全な集合（ソート済み、113 個）。
+ * schema.json のプロパティ名 / src/types/schema.ts のプロパティ名 /
+ * yaml-parser.ts が読むキーの和集合。key-normalizer.test.ts で schema.json と突き合わせる。
+ *
+ * 注意: 内部で元から camelCase のプロパティ（dropdownItems, maxColumns, weekStartsOn, loaderType,
+ * showProgress, initialProgress, ariaLabel, defaultValue）は snake_case 版と衝突するため、パーサーは snake 形で読む。
+ * definition_list の group/item の maxColumns はレンダラーが camelCase で読むが、静的 renderField では無視される。
+ */
+export declare const KNOWN_KEYS: readonly string[];
+/** snake_case を camelCase に変換（use_24_hour → use24Hour） */
+export declare function toCamel(snake: string): string;
+/** camelCase を snake_case に変換（use24Hour → use_24_hour） */
+export declare function toSnake(camel: string): string;
+/** camelCase キー → 内部 snake_case キー */
+export declare const CAMEL_TO_SNAKE: Record<string, string>;
+export declare function normalizeKeysDeep(value: unknown, parentKey?: string, verbatimSelf?: boolean, isNamedEntry?: boolean): unknown;

package/dist/types/parser/v2/compile-expand.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Section の項目展開（patterns の use）。パーサー・コンパイラ・レンダラーで共有する軽量モジュール
+ */
+import type { FieldV2, PatternV2, SectionV2 } from '../../types/schema-v2';
+/**
+ * 合成フィールド（stepper / 通知 / 一覧など）の id 接頭辞。item と衝突しない。
+ * セクション由来は `_v2_s_`（本体）/ `_v2_n_`（note）/ `_v2_p_`（accordion）+ section.id、
+ * view 由来は `_v2_` + 固定名で、互いに衝突しない。
+ */
+export declare const SYNTH_PREFIX = "_v2_";
+/** section 内の展開済みフィールド（use 由来は id に section.id を前置） */
+export interface ExpandedField {
+    field: FieldV2;
+    id: string;
+    /** patterns 由来か */
+    fromPattern: boolean;
+}
+/**
+ * section.fields と patterns[use].fields を展開する。
+ * pattern 由来のフィールドは id を `<sectionId>_<item>` にし、
+ * pattern 内で同じ pattern のフィールドを指す visibleWhen / requiredWhen は前置した id に書き換える。
+ */
+export declare function expandSectionFields(section: SectionV2, patterns: Record<string, PatternV2> | undefined): ExpandedField[];

package/dist/types/parser/v2/compile-field.d.ts

@@ -0,0 +1,28 @@
+/**
+ * v2 の Field / Condition を旧フォーマットの InputField / Condition に変換する
+ */
+import type { Condition, InputField } from '../../types/schema';
+import type { ConditionV2, FieldV2, RuleV2 } from '../../types/schema-v2';
+import type { ExpandedField } from './compile-expand';
+/** 緩い型のフィールド（旧フォーマットは種類ごとに属性が異なるため） */
+export type LooseField = Record<string, unknown> & {
+    id: string;
+    type: string;
+    label: string;
+};
+/**
+ * 条件を旧フォーマットの条件にする。
+ * equals → eq、notEquals → ne、in → in（旧スキーマの SimpleCondition が持つ演算子）
+ */
+export declare function compileCondition(cond: ConditionV2): Condition;
+/** v2 の accept → 旧 file_upload の accept 配列（image は image_uploader になるため扱わない） */
+export declare function legacyAccept(accept: FieldV2['accept']): string[] | undefined;
+/** timeline の value（{ at, label, text? }[]）→ 旧 timeline の items */
+export declare function legacyTimelineItems(value: unknown): Array<{
+    time: string;
+    title: string;
+    description?: string;
+}> | undefined;
+export declare function compileField(ef: ExpandedField, ruleDefs: Record<string, RuleV2> | undefined): InputField;
+/** トップレベルのフィールドに section の表示条件を付与（既に条件があるものは維持） */
+export declare function applySectionCondition(fields: InputField[], cond: ConditionV2 | undefined): InputField[];

package/dist/types/parser/v2/compile-section.d.ts

@@ -0,0 +1,6 @@
+/**
+ * v2 の Section を旧フォーマットの FormSection に変換する
+ */
+import type { FormSection } from '../../types/schema';
+import type { MokkunV2Schema, SectionV2, ViewV2 } from '../../types/schema-v2';
+export declare function compileSection(section: SectionV2, v2: MokkunV2Schema, view: ViewV2): FormSection;

package/dist/types/parser/v2/compile-v2.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Mokkun v2 コンパイラ
+ * v2 フォーマット（camelCase, 6層）を旧フォーマット（MokkunSchema, snake_case 内部キー）へ変換する。
+ * 規則: docs/format-redesign/02-schema-v2.md 末尾の「コンパイル規則」
+ * 旧フォーマットで表現できないキーは compileV2Warnings（compile-warnings.ts）が列挙する。
+ */
+import type { MokkunSchema } from '../../types/schema';
+import type { MokkunV2Schema } from '../../types/schema-v2';
+export { SYNTH_PREFIX, expandSectionFields, type ExpandedField } from './compile-expand';
+export { compileV2Warnings, type V2CompileWarning } from './compile-warnings';
+/**
+ * v2 スキーマを旧フォーマット（MokkunSchema）へコンパイル
+ */
+export declare function compileV2(v2: MokkunV2Schema): MokkunSchema;

package/dist/types/parser/v2/compile-warnings.d.ts

@@ -0,0 +1,17 @@
+/**
+ * v2 → 旧フォーマットの変換で、旧スキーマ／旧レンダラーが表現できずに落ちるキーの一覧。
+ * ビューアーはコンソールにだけ出す（画面には出さない）。仕様の「コンパイル規則」の「未対応」と対応する。
+ */
+import type { MokkunV2Schema } from '../../types/schema-v2';
+export interface V2CompileWarning {
+    /** 対象の位置（パーサーのエラーと同じ書き方。例 views.order_form.sections[0].fields[1]） */
+    path: string;
+    /** 落ちるキー（例 unit、list.bulkActions） */
+    key: string;
+    message: string;
+}
+/**
+ * compileV2 が旧フォーマットへ変換するときに無視するキーを列挙する（検証済みの v2 スキーマを渡す）。
+ * 変換結果は変えない。
+ */
+export declare function compileV2Warnings(schema: MokkunV2Schema): V2CompileWarning[];

package/dist/types/parser/v2/file-spec.d.ts

@@ -0,0 +1,24 @@
+/**
+ * file の accept / maxSize の仕様（パーサー・コンパイラ・レンダラーで共有）
+ */
+/** accept のキーワード */
+export declare const ACCEPT_KEYWORDS: readonly ["image", "pdf", "document"];
+/** accept の配列要素: 拡張子（.pdf）または MIME タイプ（image/png, image/*） */
+export declare const ACCEPT_EXT_PATTERN: RegExp;
+export declare const ACCEPT_MIME_PATTERN: RegExp;
+/** 旧来の HTML accept 文字列（".pdf" "image/png"。カンマ区切りも可）を許す判定 */
+export declare const ACCEPT_LEGACY_PATTERN: RegExp;
+/** maxSize: 正の整数 + KB / MB / GB（"0MB" や "010MB" は不可） */
+export declare const MAX_SIZE_PATTERN: RegExp;
+export declare const ACCEPT_FORMS = "image / pdf / document\u3001\u307E\u305F\u306F [\".pdf\", \"image/png\"] \u306E\u3088\u3046\u306A\u62E1\u5F35\u5B50\u30FBMIME \u30BF\u30A4\u30D7\u306E\u914D\u5217";
+export declare const MAX_SIZE_FORMS = "\u6B63\u306E\u6574\u6570 + KB / MB / GB\uFF08\u4F8B: \"10MB\"\uFF09";
+/** 配列要素として正しいか */
+export declare function isAcceptToken(token: unknown): boolean;
+/** キーワード → `<input accept>` */
+export declare const ACCEPT_INPUT_ATTR: Record<string, string>;
+/** キーワード → サポートテキストの形式名 */
+export declare const ACCEPT_LABEL: Record<string, string>;
+/** キーワード → 旧 file_upload の accept（拡張子・MIME タイプの配列） */
+export declare const ACCEPT_LEGACY_LIST: Record<string, string[]>;
+/** "10MB" → バイト数（書式外は undefined） */
+export declare function maxSizeToBytes(text: string | undefined): number | undefined;

package/dist/types/parser/v2/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * v2 parser exports
+ */
+export * from './parse-v2';
+export * from './compile-v2';

package/dist/types/parser/v2/iso-date.d.ts

@@ -0,0 +1,10 @@
+/**
+ * ISO 日付（YYYY-MM-DD）と、YAML の日付リテラル（js-yaml が Date にする）の正規化
+ */
+/** YYYY-MM-DD として実在する日付か */
+export declare function isIsoDate(text: string): boolean;
+/**
+ * 値の中の Date（引用符なしの `2026-11-20` を js-yaml が変換したもの）を、再帰的に UTC の `YYYY-MM-DD` 文字列にする。
+ * 元のデータは変更せず、Date を含むときだけ複製する。
+ */
+export declare function normalizeDates<T>(value: T): T;

package/dist/types/parser/v2/parse-v2.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Mokkun v2 パーサー
+ * 判別（isV2Document）、構造検証（ajv に依存せず手書き）、compileV2 による旧フォーマットへの変換
+ */
+import type { MokkunSchema } from '../../types/schema';
+import type { MokkunV2Schema } from '../../types/schema-v2';
+import type { ParseResult } from '../yaml-parser';
+/**
+ * v2 ドキュメントかどうか（トップレベルの `mokkun` が 2）
+ */
+export declare function isV2Document(data: unknown): boolean;
+/**
+ * トップレベルに `mokkun` キーがあるか（バージョン不一致を v1 として扱わないための判定）
+ */
+export declare function hasMokkunVersionKey(data: unknown): boolean;
+/**
+ * v2 ドキュメント（yaml.load 済みの生データ）を検証し、検証済みの MokkunV2Schema を返す（コンパイルしない）
+ * v2 専用レンダラー（renderer-v2）の入力に使う
+ */
+export declare function parseV2Document(raw: unknown): ParseResult<MokkunV2Schema>;
+/**
+ * v2 ドキュメント（yaml.load 済みの生データ）を検証し、旧フォーマットへコンパイルする
+ */
+export declare function parseV2(data: unknown): ParseResult<MokkunSchema>;

package/dist/types/parser/v2/validate-action.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Action の検証（View の主・副アクション、rowActions、bulkActions、Section.actions で共通）
+ */
+import { type VCtx } from './validate-context';
+export interface ActionCheckOptions {
+    /** Section.actions のとき true。primary を持てるのは View だけなので style: primary を拒否する */
+    section?: boolean;
+    /** list.rowActions[] のとき true。id / label / kind / to だけを持てる（role・confirm・style・placement は不可） */
+    row?: boolean;
+}
+export declare function checkAction(v: VCtx, action: unknown, path: string, opts?: ActionCheckOptions): void;

package/dist/types/parser/v2/validate-app.d.ts

@@ -0,0 +1,9 @@
+/**
+ * App 層（app / navigation / notifications）と Flow 層の検証
+ */
+import { type Obj, type VCtx } from './validate-context';
+/** app の形（views が無くても検証できる部分） */
+export declare function checkApp(v: VCtx, app: Obj | undefined): void;
+/** navigation を検証し、載っている view 名の集合を返す（undefined は navigation 未定義） */
+export declare function checkNavigation(v: VCtx, navigation: unknown): Set<string> | undefined;
+export declare function checkFlows(v: VCtx, flows: unknown): void;

package/dist/types/parser/v2/validate-context.d.ts

@@ -0,0 +1,41 @@
+/**
+ * v2 検証の共通部分: 型ガード、列挙値、エラー収集のヘルパー
+ */
+import type { ParseError, ParseErrorType } from '../yaml-parser';
+export type Obj = Record<string, unknown>;
+export declare function isObject(value: unknown): value is Obj;
+export declare function isNonEmptyString(value: unknown): value is string;
+export declare const APP_LAYOUTS: string[];
+export declare const FLOW_PROGRESS: string[];
+export declare const VIEW_LAYOUTS: string[];
+export declare const SECTION_KINDS: string[];
+export declare const REVEALS: string[];
+export declare const ACTION_KINDS: string[];
+export declare const ACTION_PLACEMENTS: string[];
+export declare const ACTION_STYLES: string[];
+export declare const FIELD_WIDTHS: string[];
+export declare const SELECTIONS: string[];
+export declare const NOTICE_VARIANTS: string[];
+export declare const PATTERN_KEYS: string[];
+export declare const COLUMN_TYPES: string[];
+export declare const DATE_PRECISIONS: string[];
+/** 一覧セルに置ける入力の component */
+export declare const COLUMN_FIELD_COMPONENTS: string[];
+/** 条件の比較キー（exactly one） */
+export declare const CONDITION_KEYS: string[];
+/** 検証の共有状態（エラーの収集と、参照先の存在確認に使う集合） */
+export interface VCtx {
+    add: (type: ParseErrorType, message: string, path: string) => void;
+    checkEnum: (value: unknown, allowed: Array<string | number>, path: string, name: string) => void;
+    checkString: (value: unknown, path: string, name: string, required?: boolean) => void;
+    /** views のキーを参照しているか */
+    /** obj に allowed 以外のキーがあればエラー（schema-v2.json の additionalProperties: false に対応） */
+    checkKeys: (obj: Obj, allowed: readonly string[], path: string) => void;
+    checkViewRef: (name: unknown, path: string) => void;
+    /** role（文字列または配列）の形と、app.roles にあるかを確かめる */
+    checkRole: (value: unknown, path: string) => void;
+    /** トップレベル rules */
+    rules: Obj;
+    viewNames: Set<string>;
+}
+export declare function createVCtx(errors: ParseError[], data: Obj): VCtx;

package/dist/types/parser/v2/validate-field.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Field と Condition の検証
+ */
+import { type VCtx } from './validate-context';
+/**
+ * 条件（visibleWhen / requiredWhen）の形だけを検証する（参照先の存在は view 単位で後段チェック）。
+ * equals / notEquals / in のうちちょうど 1 つが必要。
+ */
+export declare function checkConditionShape(v: VCtx, cond: unknown, path: string, name?: string): boolean;
+export interface FieldCheckOptions {
+    /** 一覧セルの入力欄（item / label を持たず、component は text / number / select / checkbox のみ） */
+    column?: boolean;
+}
+/** 項目の検証。条件の参照先と pattern 由来の展開は view 単位で後段チェックする */
+export declare function checkField(v: VCtx, field: unknown, path: string, opts?: FieldCheckOptions): void;
+/** 条件の参照先 item（形が正しいときだけ） */
+export declare function conditionItem(cond: unknown): string | undefined;

package/dist/types/parser/v2/validate-keys.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 各オブジェクトに書けるキー（schema-v2.json の additionalProperties: false と同じ）
+ */
+export declare const TOP_KEYS: string[];
+export declare const APP_KEYS: string[];
+export declare const HEADER_KEYS: string[];
+export declare const NOTICE_KEYS: string[];
+export declare const NAV_GROUP_KEYS: string[];
+export declare const NAV_ITEM_KEYS: string[];
+export declare const FLOW_KEYS: string[];
+export declare const FLOW_STEP_KEYS: string[];
+export declare const VIEW_KEYS: string[];
+export declare const STATE_KEYS: string[];
+export declare const STATE_MESSAGE_KEYS: string[];
+export declare const SECTION_KEYS: string[];
+export declare const REPEATABLE_KEYS: string[];
+export declare const ACTION_KEYS: string[];
+/** list.rowActions[] は id / label / kind / to だけ（role・confirm・style・placement は持てない） */
+export declare const ROW_ACTION_KEYS: string[];
+export declare const CONFIRM_KEYS: string[];
+export declare const LIST_KEYS: string[];
+export declare const COLUMN_KEYS: string[];
+export declare const PAGING_KEYS: string[];
+export declare const CONDITION_ALLOWED_KEYS: string[];
+export declare const OPTION_KEYS: string[];
+export declare const FIELD_KEYS: string[];
+/** 一覧セルの入力欄: item / label / 条件 / to / links / precision / accept / maxSize / rules / whyRequired / example / format は持てない */
+export declare const COLUMN_FIELD_KEYS: string[];
+export declare const LINK_KEYS: string[];

package/dist/types/parser/v2/validate-list.d.ts

@@ -0,0 +1,5 @@
+/**
+ * kind: list の list オブジェクトの検証
+ */
+import { type VCtx } from './validate-context';
+export declare function checkList(v: VCtx, list: unknown, sp: string): void;

package/dist/types/parser/v2/validate-v2.d.ts

@@ -0,0 +1,6 @@
+/**
+ * v2 の構造を検証してエラー一覧を返す（ajv に依存せず手書き）。入力が不正でも例外を投げない。
+ */
+import type { ParseError } from '../yaml-parser';
+import { type Obj } from './validate-context';
+export declare function validateV2(data: Obj): ParseError[];

package/dist/types/parser/v2/validate-view.d.ts

@@ -0,0 +1,6 @@
+/**
+ * View 層と Section 層の検証（項目 id の重複、条件の参照先、action id の一意性を含む）
+ */
+import type { PatternV2 } from '../../types/schema-v2';
+import { type Obj, type VCtx } from './validate-context';
+export declare function checkViews(v: VCtx, views: Obj, patterns: Record<string, PatternV2>, navViews: Set<string> | undefined): void;

package/dist/types/parser/yaml-parser.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Mokkun YAML Parser
+ * YAMLテキストを型安全にパースする
+ */
+import type { MokkunV2Schema } from '../types/schema-v2';
+import type { MokkunSchema, ScreenDefinition, InputField, InputFieldType, CommonComponent, ValidationRule } from '../types/schema';
+/**
+ * パースエラーの種類
+ */
+export type ParseErrorType = 'YAML_SYNTAX_ERROR' | 'SCHEMA_VALIDATION_ERROR' | 'MISSING_REQUIRED_FIELD' | 'INVALID_FIELD_TYPE' | 'INVALID_VALUE';
+/**
+ * パースエラー
+ */
+export interface ParseError {
+    type: ParseErrorType;
+    message: string;
+    path?: string;
+    line?: number;
+    column?: number;
+}
+/**
+ * パース結果
+ */
+export type ParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: ParseError[];
+};
+export declare const VALID_FIELD_TYPES: InputFieldType[];
+/**
+ * YAMLテキストをパースしてMokkunSchemaに変換
+ */
+export declare function parseYaml(yamlText: string): ParseResult<MokkunSchema>;
+/**
+ * YAMLテキストが v2 フォーマット（トップレベルの `mokkun: 2`）か判定する。YAML として読めない場合は false
+ */
+export declare function isV2Yaml(yamlText: string): boolean;
+/**
+ * v2 の YAMLテキストをパースし、検証済みの MokkunV2Schema を返す（旧フォーマットへはコンパイルしない）
+ * 既存の parseYaml の挙動は変えない
+ */
+export declare function parseYamlV2(yamlText: string): ParseResult<MokkunV2Schema>;
+/**
+ * パースエラーを整形して文字列に変換
+ */
+export declare function formatParseErrors(errors: ParseError[]): string;
+/**
+ * 画面定義を取得
+ */
+export declare function getScreen(schema: MokkunSchema, screenName: string): ScreenDefinition | undefined;
+/**
+ * 全ての画面名を取得
+ */
+export declare function getScreenNames(schema: MokkunSchema): string[];
+/**
+ * フィールドをIDで検索
+ */
+export declare function findFieldById(fields: InputField[], fieldId: string): InputField | undefined;
+/**
+ * 共通コンポーネントを取得
+ */
+export declare function getCommonComponent(schema: MokkunSchema, componentName: string): CommonComponent | undefined;
+/**
+ * バリデーションルールを取得
+ */
+export declare function getValidationRule(schema: MokkunSchema, ruleName: string): ValidationRule | undefined;