mokkun 0.1.6 → 0.2.0

package/dist/types/lib.d.ts

@@ -3,8 +3,11 @@
  * YAML-based presentation and form builder
  */
 import './style.css';
-import { parseYaml, getScreen, getScreenNames, findFieldById } from './parser';
+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
  */
@@ -17,8 +20,14 @@ export interface MokkunInitOptions {
     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 */
@@ -32,12 +41,24 @@ export interface MokkunInitOptions {
  * Mokkun instance returned by init()
  */
 export interface MokkunInstance {
-    /** Current schema */
+    /** 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 */
@@ -64,6 +85,10 @@ export declare const Mokkun: {
     /** 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;
@@ -75,6 +100,10 @@ export declare const Mokkun: {
         getAvailable: () => import("./types").ThemeDefinition[];
     };
 };
-export type { MokkunSchema, ScreenDefinition, BuiltInThemeId };
+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

@@ -3,6 +3,7 @@
  * YAMLファイルの読み込み機能を提供
  */
 import type { MokkunSchema } from '../types/schema';
+import type { MokkunV2Schema } from '../types/schema-v2';
 import type { ParseError } from '../parser/yaml-parser';
 /**
  * ファイル読み込みエラーの種類
@@ -22,7 +23,10 @@ export interface FileLoadError {
  */
 export interface FileLoadSuccess {
     success: true;
-    schema: MokkunSchema;
+    /** v1 スキーマ。v2 文書では compileV2 の結果（変換できなければ null） */
+    schema: MokkunSchema | null;
+    /** v2 文書（mokkun: 2）のとき、検証済みの v2 スキーマ。v2 専用レンダラーの入力 */
+    schemaV2?: MokkunV2Schema;
     fileName: string;
     source: 'file' | 'url' | 'drop';
     /** 読み込んだ YAML の原文（コメント・順序を保持） */

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

@@ -2,3 +2,4 @@
  * Parser exports
  */
 export * from './yaml-parser';
+export * from './v2';

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

@@ -2,6 +2,7 @@
  * Mokkun YAML Parser
  * YAMLテキストを型安全にパースする
  */
+import type { MokkunV2Schema } from '../types/schema-v2';
 import type { MokkunSchema, ScreenDefinition, InputField, InputFieldType, CommonComponent, ValidationRule } from '../types/schema';
 /**
  * パースエラーの種類
@@ -32,6 +33,15 @@ 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>;
 /**
  * パースエラーを整形して文字列に変換
  */

package/dist/types/renderer/screen-renderer.d.ts

@@ -9,6 +9,10 @@ import { AppNavi } from './components/app-navi';
  * ウィザード画面をレンダリング
  */
 export declare function renderWizardScreen(screen: ScreenDefinition, currentStepIndex?: number): string;
+/**
+ * セクションIDを生成（セクション名から安全なIDを生成）
+ */
+export declare function generateSectionId(sectionName: string, index: number): string;
 /**
  * 通常画面をレンダリング（shell レイアウト固定）
  */

package/dist/types/renderer-v2/actions.d.ts

@@ -0,0 +1,30 @@
+/**
+ * アクションボタンと確認ダイアログ（modal-dialog）
+ * primaryAction: solid-fill lg / secondary: outline md / tertiary: text md / danger: --button-color を error 色に（mokkun-v2.css の .mk2-button--danger）
+ * 並び順（DADS）: tertiary が左端、secondary、primary が右端。DOM の順序をそのまま見た目にする（CSS で並べ替えない）
+ */
+import type { ActionPlacementV2, ActionV2, ListV2, SectionV2 } from '../types/schema-v2';
+import { type ViewContext } from './context';
+export interface PlacedAction {
+    action: ActionV2;
+    primary: boolean;
+    placement: ActionPlacementV2;
+}
+/** Section.actions（見出し行の操作）。現在のロールで表示するもの */
+export declare function sectionActions(section: SectionV2, ctx: ViewContext): ActionV2[];
+/** list.bulkActions（選択した行への操作）。現在のロールで表示するもの */
+export declare function bulkActions(list: ListV2, ctx: ViewContext): ActionV2[];
+/** 画面のアクションを配置先つきで列挙する。primary が先頭。placement 未指定の secondary は primary に揃える。現在のロールで表示するものだけ */
+export declare function collectActions(ctx: ViewContext): PlacedAction[];
+export declare function dialogId(ctx: ViewContext, action: ActionV2): string;
+/**
+ * 操作ボタン 1 つ。Section 内の操作（primary ではない）は extra で data-section / data-bulk を付ける。
+ * type: solid-fill は primary、text は tertiary、outline はそれ以外
+ */
+export declare function renderActionButton(ctx: ViewContext, action: ActionV2, type: 'solid-fill' | 'outline' | 'text', size: 'lg' | 'md', extra?: Record<string, string | boolean | undefined>): string;
+/** Section の操作（見出し行）。tertiary はテキスト、それ以外は outline md */
+export declare function renderSectionButton(ctx: ViewContext, action: ActionV2, sectionId: string): string;
+/** 指定した配置のアクション群。無ければ空文字 */
+export declare function renderActions(ctx: ViewContext, placement: ActionPlacementV2): string;
+/** action.confirm を持つアクションごとの <dialog>。静的 HTML に含め、mount 時にボタンから開く */
+export declare function renderDialogs(ctx: ViewContext): string;

package/dist/types/renderer-v2/app-shell.d.ts

@@ -0,0 +1,15 @@
+/**
+ * App 層: ヘッダー、グローバルナビ、パンくず、通知
+ */
+import type { NoticeVariantV2 } from '../types/schema-v2';
+import type { ViewContext } from './context';
+/** notification-banner（app.notifications / view.states 共通） */
+export declare function renderBanner(id: string, variant: NoticeVariantV2, message: string, dismissible?: boolean): string;
+/** 共通通知。現在のロールに向けたもので、掲示期限（until）が今日より前でないものだけ。id は定義順の通し番号 */
+export declare function renderNotifications(ctx: ViewContext): string;
+/** グローバルナビ: group が 1 項目ならリンク、複数ならサブメニューボタン + menu-list。現在地は aria-current="page" */
+export declare function renderGlobalNav(ctx: ViewContext): string;
+/** ヘッダー: 左にシステム名とアプリ名、右に利用者名とテナント名（utility-link） */
+export declare function renderHeader(ctx: ViewContext): string;
+/** パンくず: アプリ名 › グループ › 画面タイトル */
+export declare function renderBreadcrumb(ctx: ViewContext): string;

package/dist/types/renderer-v2/condition.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 条件（visibleWhen / requiredWhen）の評価。静的描画（既定値）と mount 後（DOM の現在値）で共有する。
+ *
+ * 比較の対象は「項目の現在値のトークン」: 単一値は文字列、複数選択は選択値の配列、
+ * 真偽値系（checkbox / toggle）は 'true' / 'false'、date は `y-m-d`（precision: month は `y-m`）。
+ */
+import type { ConditionV2 } from '../types/schema-v2';
+export type Token = string | string[];
+/** data 属性に載せる条件（JSON）。equals / notEquals / in のうち書かれたものだけ */
+export declare function serializeCondition(cond: ConditionV2): string;
+/** 条件を評価する。equals は一致、notEquals は不一致、in は配列のどれかと一致 */
+export declare function matchesCondition(token: Token, cond: ConditionV2): boolean;
+/**
+ * date の値のトークン。年・月・日を 0 埋めして `-` でつなぎ、末尾の空の部分は落とす
+ * （年月だけなら `2026-11`、全部空なら空文字）。静的描画（既定値）と mount 後（入力欄）で同じ形にするための唯一の組み立て
+ */
+export declare function dateToken(year: string, month: string, day: string): string;
+/** 値の文字列（YYYY-MM-DD / YYYY-MM）から date のトークンを作る。precision: month は日を無視する。解釈できない値はそのまま */
+export declare function dateTokenOf(text: string, precision: 'day' | 'month' | undefined): string;

package/dist/types/renderer-v2/context.d.ts

@@ -0,0 +1,37 @@
+/**
+ * v2 レンダラー内部で共有する描画文脈
+ */
+import type { ConditionV2, FieldV2, FlowV2, MokkunV2Schema, ViewV2 } from '../types/schema-v2';
+/** view の状態（ビューアーの「状態」切替）。normal は状態バナーなし */
+export type V2ViewState = 'normal' | 'success' | 'error' | 'empty' | 'loading';
+export declare const V2_VIEW_STATES: readonly V2ViewState[];
+/** 描画オプション */
+export interface V2RenderOptions {
+    /** 表示する状態。既定 normal（状態バナーを出さない） */
+    state?: V2ViewState;
+    /** 現在のロール（app.roles の値）。未指定は全ロール分を表示する */
+    role?: string;
+    /** 通知の期限（Notice.until）判定に使う今日。既定は実行時の日付（テスト用） */
+    today?: Date | string;
+}
+export interface ViewContext {
+    schema: MokkunV2Schema;
+    viewName: string;
+    view: ViewV2;
+    /** 展開後の項目 id → 項目定義（visibleWhen の初期評価用） */
+    fields: Map<string, FieldV2>;
+    state: V2ViewState;
+    role: string | undefined;
+    /** 今日（YYYY-MM-DD） */
+    today: string;
+}
+export declare function createContext(schema: MokkunV2Schema, viewName: string, options?: V2RenderOptions): ViewContext | undefined;
+/** DOM id は view 名で前置して、ページ内で一意にする */
+export declare function domId(ctx: ViewContext, ...parts: Array<string | number>): string;
+/** 条件を既定値で評価する（条件がなければ true）。参照先が無ければ false */
+export declare function isInitiallyVisible(cond: ConditionV2 | undefined, ctx: ViewContext): boolean;
+/** view を含み、手順ナビを出す flow（progress: none は除く） */
+export declare function findFlow(schema: MokkunV2Schema, viewName: string): {
+    flow: FlowV2;
+    index: number;
+} | undefined;

package/dist/types/renderer-v2/fields/choice.d.ts

@@ -0,0 +1,12 @@
+/**
+ * radio / checkbox の fieldset と、それを使う select の変種
+ * - radio: radio の fieldset
+ * - checkbox: checkbox 1 つ / multiple は checkbox の fieldset
+ * - select multiple: checkbox の fieldset（DADS の指針: 複数選択はチェックボックス）
+ * - select segmented: radio の横並び fieldset
+ */
+import { type Ctl } from './control-label';
+export declare function renderRadio(c: Ctl, inline?: boolean): string;
+export declare function renderCheckboxGroup(c: Ctl): string;
+/** 単一チェックボックス: ラベルはチェックボックス自身（必須表示も同じ行に） */
+export declare function renderCheckbox(c: Ctl): string;

package/dist/types/renderer-v2/fields/control-label.d.ts

@@ -0,0 +1,57 @@
+/**
+ * form-control-label（DADS）でのラップ
+ * 単一コントロールは <label for>、複数コントロール（グループ）は <fieldset> + <legend>。
+ * サポートテキスト・エラーテキストは aria-describedby で関連付ける。
+ */
+import type { FieldV2 } from '../../types/schema-v2';
+/** 1 項目の描画入力（DOM id / name は呼び出し側で繰り返しグループの添字まで解決済み） */
+export interface FieldOpts {
+    /** コントロールの DOM id（view 名で前置済み） */
+    domId: string;
+    /** フォーム送信名 */
+    name: string;
+    /** 初期表示で非表示にするか（visibleWhen を既定値で評価した結果） */
+    hidden?: boolean;
+    /**
+     * props.error（項目のエラー文）を描くか。既定 true（単体で呼ぶとき）。View の描画では状態が error のときだけ true
+     * （通常の状態ではエラーを出さない）
+     */
+    showError?: boolean;
+    /** 初期表示で必須か（requiredWhen を既定値で評価した結果）。省略は field.required */
+    required?: boolean;
+}
+/** コントロール描画用の文脈 */
+export interface Ctl {
+    f: FieldV2;
+    domId: string;
+    name: string;
+    hidden: boolean;
+    /** 必須として扱うか（requiredWhen のときは条件の評価結果。mount 後は DOM が追随する） */
+    required: boolean;
+    supportId?: string;
+    errorId?: string;
+    error?: string;
+    /** aria-describedby に入れる id 列（エラー → サポートの順） */
+    describedBy?: string;
+    /** 初期値 */
+    value: unknown;
+}
+export declare function makeCtl(f: FieldV2, o: FieldOpts): Ctl;
+/** サポートテキストの行（help / ファイル形式と容量 / whyRequired / format / example）。placeholder は使わない */
+export declare function supportLines(f: FieldV2): string[];
+/** aria-invalid / aria-describedby の共通属性 */
+export declare function ariaAttrs(c: Ctl): string;
+/** form-control-label 共通のエラー（各コントロールが専用のエラーテキストを持たない場合） */
+export declare function groupError(c: Ctl): string;
+/** 単一コントロール: <div> + <label for> */
+export declare function wrapSingle(c: Ctl, control: string): string;
+/** グループ: <fieldset> + <legend>。aria-describedby は fieldset に付ける */
+export declare function wrapGroup(c: Ctl, control: string, extra?: Record<string, string | boolean | undefined>, opts?: {
+    skipError?: boolean;
+}): string;
+/** ラベルを持たない表示用コントロール（チップ・タイムライン等）用のラップ */
+export declare function wrapDisplay(c: Ctl, control: string): string;
+/** 単一チェックボックス用: ラベルはチェックボックス自身が持つ（必須表示はその中に入れる） */
+export declare function wrapInline(c: Ctl, control: string): string;
+/** 必須／任意の表示（単一チェックボックスのラベル内で使う） */
+export declare function requirementHtml(c: Ctl): string;

package/dist/types/renderer-v2/fields/date.d.ts

@@ -0,0 +1,6 @@
+/**
+ * date → date-picker（consolidated）/ inline のときは calendar
+ * DADS の date-picker は 年・月・日 の 3 入力。カレンダーのポップオーバーは JS が必要なため出さない。
+ */
+import { type Ctl } from './control-label';
+export declare function renderDate(c: Ctl): string;