mokkun 0.1.6 → 0.2.0

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

@@ -0,0 +1,22 @@
+/**
+ * 表示系: badge / chip / status → chip-label、timeline → list、map → image 枠
+ */
+import type { FieldV2 } from '../../types/schema-v2';
+import { type Ctl } from './control-label';
+/** badge / chip / status。値があれば項目名 + チップ、無ければチップのみ（ラベルを二重に出さない） */
+export declare function renderChip(c: Ctl): string;
+export interface TimelineRow {
+    time: string;
+    title: string;
+    description?: string;
+}
+/**
+ * timeline の行。value（{ at, label, text? }[]）を優先し、なければ props.items（{ time, title, description? }[]）
+ */
+export declare function timelineRows(f: FieldV2): TimelineRow[];
+/** 日時・ラベル・本文の順序なしリスト。readonly の値としても使う */
+export declare function timelineList(f: FieldV2, labelledBy?: string): string;
+/** timeline（value の { at, label, text? }[]、または props.items） */
+export declare function renderTimeline(c: Ctl): string;
+/** 地図は image の枠に「地図」プレースホルダー */
+export declare function renderMap(c: Ctl): string;

package/dist/types/renderer-v2/fields/file-support.d.ts

@@ -0,0 +1,15 @@
+/**
+ * file の accept / multiple / maxSize と、サポートテキストへの自動追記
+ */
+import type { FieldV2 } from '../../types/schema-v2';
+/** `<input accept>` の値 */
+export declare function acceptAttr(accept: FieldV2['accept']): string | undefined;
+/** 形式名（「PDF・JPEG・PNG」の形） */
+export declare function acceptLabel(accept: FieldV2['accept']): string | undefined;
+/** 複数選択か（first-class の multiple。props.multiple も受け付ける） */
+export declare function isMultiple(f: FieldV2): boolean;
+/**
+ * サポートテキストに自動で足す「形式: …／1ファイル 10MB まで」。
+ * help が形式名・容量をすでに書いているときは、その部分を足さない（重複させない）。
+ */
+export declare function fileSupportLine(f: FieldV2): string | undefined;

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

@@ -0,0 +1,9 @@
+/**
+ * file → file-upload / photo_grid → file-upload + 画像グリッド
+ * DADS の file-upload は JS（カスタム要素）で一覧を更新する。選択ボタンと一覧更新は mount.ts で行う。
+ */
+import { type Ctl } from './control-label';
+/** file-upload は label が for で input を指す。ボタンのラベル参照用に label へ id を付ける */
+export declare function renderFile(c: Ctl): string;
+/** 画像グリッド（props.photos: [{ src, alt }]）+ 追加用 file-upload */
+export declare function renderPhotoGrid(c: Ctl): string;

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

@@ -0,0 +1,20 @@
+/**
+ * Field 層: component（と条件）から DADS 部品への振り分け
+ *
+ * | component | 条件 | DADS 部品 |
+ * |---|---|---|
+ * | text / number / time / duration / combobox | | input-text |
+ * | textarea | | textarea |
+ * | date | | date-picker（inline は calendar）|
+ * | file / photo_grid | | file-upload |
+ * | select | | select（multiple は checkbox、segmented は radio）|
+ * | radio / checkbox / toggle | | radio / checkbox / switch |
+ * | browser | | select（階層は optgroup）|
+ * | badge / chip / status | | chip-label |
+ * | timeline / map | | list / image |
+ */
+import type { FieldV2 } from '../../types/schema-v2';
+import { type FieldOpts } from './control-label';
+export type { FieldOpts } from './control-label';
+/** 1 項目を form-control-label でラップした HTML にする */
+export declare function renderFieldV2(field: FieldV2, opts: FieldOpts): string;

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

@@ -0,0 +1,17 @@
+/**
+ * select / browser（階層は optgroup）と、select の変種の振り分け
+ */
+import type { OptionV2 } from '../../types/schema-v2';
+import { type Ctl } from './control-label';
+interface BrowserItem {
+    value: string;
+    label: string;
+    children?: BrowserItem[];
+}
+export declare function option(o: OptionV2 | BrowserItem, current: string): string;
+/** select 1 つ（form-control-label の外側）。一覧セルの入力欄からも使う */
+export declare function selectControl(c: Ctl, body: string, ariaLabel?: string): string;
+export declare function renderSelect(c: Ctl): string;
+/** 階層を持つ項目は optgroup、持たない項目は option（props.items は { value, label, children? }） */
+export declare function renderBrowser(c: Ctl): string;
+export {};

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

@@ -0,0 +1,26 @@
+/**
+ * input-text 系: text / number / time / duration / combobox
+ */
+import { type Ctl } from './control-label';
+interface InputOpts {
+    type: string;
+    inputmode?: string;
+    list?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    /** 入力欄の後ろに付ける単位（同じ control の中） */
+    unit?: string;
+    /** ラベルを持たない場所（一覧セル）で使う aria-label */
+    ariaLabel?: string;
+}
+/** input-text 1 つ（form-control-label の外側）。一覧セルの入力欄からも使う */
+export declare function inputText(c: Ctl, o: InputOpts): string;
+export declare function renderText(c: Ctl): string;
+export declare function renderNumber(c: Ctl): string;
+export declare function renderTime(c: Ctl): string;
+/** 数値入力 + 単位（unit、なければ props.unit、既定「分」） */
+export declare function renderDuration(c: Ctl): string;
+/** input-text + datalist（候補は options のラベル） */
+export declare function renderCombobox(c: Ctl): string;
+export {};

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

@@ -0,0 +1,5 @@
+/**
+ * textarea
+ */
+import { type Ctl } from './control-label';
+export declare function renderTextarea(c: Ctl): string;

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

@@ -0,0 +1,6 @@
+/**
+ * toggle → switch（on-off）
+ * DADS の switch は JS で aria-checked を切り替える。クリック処理は mount.ts で行う。
+ */
+import { type Ctl } from './control-label';
+export declare function renderToggle(c: Ctl): string;

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

@@ -0,0 +1,35 @@
+/**
+ * DADS が使う SVG アイコン
+ * 取得元: design-system-example-components-html の各コンポーネント HTML（dads/NOTICE.md 参照）
+ */
+/** select / horizontal-menu の下向きシェブロン */
+export declare const chevronDown: (cls: string) => string;
+export declare const breadcrumbSeparator = "<svg class=\"dads-breadcrumb__separator-icon\" width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" aria-hidden=\"true\"><path d=\"M4.5 11L4 10.5L8 6.5L4 2.5L4.5 2L9 6.5L4.5 11Z\" fill=\"currentcolor\" /></svg>";
+export declare const accordionChevron = "<svg class=\"dads-accordion__icon-svg\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path d=\"M3.3 7.3L12 16L20.7 7.3\" fill=\"none\" stroke=\"currentcolor\" stroke-width=\"2\"/></svg>";
+export declare const closeIcon = "<svg class=\"dads-notification-banner__close-icon\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path d=\"m6.4 18.6-1-1 5.5-5.6-5.6-5.6 1.1-1 5.6 5.5 5.6-5.6 1 1.1L13 12l5.6 5.6-1 1L12 13l-5.6 5.6Z\" fill=\"currentcolor\"/></svg>";
+export declare const modalCloseIcon = "<svg class=\"dads-modal-dialog__close-icon\" width=\"24\" height=\"24\" viewBox=\"0 0 120 120\" aria-hidden=\"true\"><path d=\"M32 95L25 88L53 60L25 32L32 25L60 53L88 25L95 32L67 60L95 88L88 95L60 67L32 95Z\" fill=\"currentcolor\"/></svg>";
+/** notification-banner の種別アイコン */
+export declare const bannerIcons: {
+    readonly 'info-1': "<svg class=\"dads-notification-banner__icon\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" role=\"img\" aria-label=\"インフォメーション\"><circle cx=\"12\" cy=\"12\" r=\"10\" fill=\"currentcolor\"/><circle cx=\"12\" cy=\"8\" r=\"1\" fill=\"Canvas\"/><path d=\"M11 11h2v6h-2z\" fill=\"Canvas\"/></svg>";
+    readonly success: "<svg class=\"dads-notification-banner__icon\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" role=\"img\" aria-label=\"成功\"><circle cx=\"12\" cy=\"12\" r=\"10\" fill=\"currentcolor\"/><path d=\"m17.6 9.6-7 7-4.3-4.3L7.7 11l2.9 2.9 5.7-5.6 1.3 1.4Z\" fill=\"Canvas\"/></svg>";
+    readonly warning: "<svg class=\"dads-notification-banner__icon\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" role=\"img\" aria-label=\"警告\"><path d=\"M1 21 12 2l11 19H1Z\" fill=\"currentcolor\"/><path d=\"M13 15h-2v-5h2v5Z\" fill=\"Canvas\"/><circle cx=\"12\" cy=\"17\" r=\"1\" fill=\"Canvas\"/></svg>";
+    readonly error: "<svg class=\"dads-notification-banner__icon\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" role=\"img\" aria-label=\"エラー\"><path d=\"M8.25 21 3 15.75v-7.5L8.25 3h7.5L21 8.25v7.5L15.75 21h-7.5Z\" fill=\"currentcolor\"/><path d=\"m12 13.4-2.85 2.85-1.4-1.4L10.6 12 7.75 9.15l1.4-1.4L12 10.6l2.85-2.85 1.4 1.4L13.4 12l2.85 2.85-1.4 1.4L12 13.4Z\" fill=\"Canvas\"/></svg>";
+};
+/** step-navigation の完了アイコン（DADS 原文のまま） */
+export declare const stepCompleted = "<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"12\" fill=\"#666\"/><path d=\"M10 17.5 19.8 8l-1.5-1.5-8.1 8-4.1-4L4.5 12l5.6 5.5Z\" fill=\"#fff\"/></svg>";
+export declare const pageNavPrev = "<svg class=\"dads-button__icon\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path d=\"m7.9 12 8-8-1.4-1.4L5.1 12l9.4 9.4 1.4-1.4z\" fill=\"currentcolor\"/></svg>";
+export declare const pageNavNext = "<svg class=\"dads-button__icon\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path d=\"M9 2.6 7.6 4l8 8-8 8L9 21.4l9.4-9.4z\" fill=\"currentcolor\"/></svg>";
+/** table の並べ替えアイコン（none / ascending / descending） */
+export declare const sortIcons: {
+    readonly none: "M17 18.11L21.27 14L22 14.7L16.5 20L11 14.7L11.73 14L16 18.12V4H17V18.12ZM8 5.88L12.27 10L13 9.3L7.5 4L2 9.3L2.73 10L7 5.88V20H8V5.88Z";
+    readonly ascending: "M17 18.12L21.27 14L22 14.7L16.5 20L11 14.7L11.73 14L16 18.12V4H17V18.12ZM14 8.92L11.73 11L9 8.52V20H6V8.52L3.27 11L1 8.93L7.5 3L14 8.93Z";
+    readonly descending: "M7 5.88L2.73 10L2 9.3L7.5 4L13 9.3L12.27 10L8 5.88V20H7V5.88ZM10 15.08L12.27 13L15 15.48V4H18V15.48L20.73 13L23 15.07L16.5 21L10 15.07Z";
+};
+export declare const sortSvg: (path: string) => string;
+export declare const calendarPrev = "<svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" role=\"img\" aria-label=\"\u524D\u306E\u6708\"><path d=\"m5.27 8 5.33-5.33-.93-.94L3.4 8l6.27 6.27.93-.94L5.27 8Z\" fill=\"currentcolor\" /></svg>";
+export declare const calendarNext = "<svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" role=\"img\" aria-label=\"\u6B21\u306E\u6708\"><path d=\"m6 1.73-.93.94L10.4 8l-5.33 5.33.93.94L12.27 8 6 1.73Z\" fill=\"currentcolor\" /></svg>";
+export declare const switchCheck = "<svg class=\"dads-switch-on-off__icon\" viewBox=\"0 0 24 24\" width=\"24\" height=\"24\" aria-hidden=\"true\"><path d=\"m10.4 16.3-4.1-4.1 1.2-1.3 2.9 2.9 6-6.1 1.3 1.2z\" fill=\"currentcolor\"/></svg>";
+export declare const disclosureIcon = "<svg class=\"dads-disclosure__icon\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" aria-hidden=\"true\"><circle cx=\"12\" cy=\"12\" r=\"11\" fill=\"currentcolor\"/><circle class=\"dads-disclosure__icon-circle\" cx=\"12\" cy=\"12\" r=\"8\" fill=\"currentcolor\"/><path class=\"dads-disclosure__icon-triangle\" d=\"M17 10H7L12 15L17 10Z\" fill=\"Canvas\"/></svg>";
+export declare const calendarButtonIcon = "<svg class=\"dads-date-picker__calendar-icon\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" role=\"img\" aria-label=\"\u30AB\u30EC\u30F3\u30C0\u30FC\"><rect x=\"5\" y=\"10\" width=\"14\" height=\"10\" fill=\"Canvas\"/><path d=\"M9 16.5C7.62 16.5 6.5 15.38 6.5 14C6.5 12.62 7.62 11.5 9 11.5C10.38 11.5 11.5 12.62 11.5 14C11.5 15.38 10.38 16.5 9 16.5ZM5 22C3.9 22 3 21.09 3 20V6C3 4.91 3.91 4 5 4H6V2H8V4H16V2H18V4H19C20.09 4 21 4.91 21 6V20C21 21.09 20.09 22 19 22H5ZM5 20H19V10H5V20Z\" fill=\"currentcolor\"/></svg><svg class=\"dads-date-picker__calendar-chevron\" viewBox=\"0 0 24 24\" aria-hidden=\"true\"><path d=\"M12 17.1L3 8L4 7L12 15L20 7L21 8L12 17.1Z\" fill=\"currentcolor\" /></svg>";
+/** 新規タブで開くリンクのアイコン（上流 link/new-tab.html） */
+export declare const externalIcon = "<svg class=\"dads-link__icon\" width=\"16\" height=\"16\" viewBox=\"0 0 48 48\" role=\"img\" aria-label=\"\u65B0\u898F\u30BF\u30D6\u3067\u958B\u304D\u307E\u3059\"><path d=\"M22 6V9H9V39H39V26H42V42H6V6H22ZM42 6V20H39V11.2L21 29L19 27L36.8 9H28V6H42Z\" fill=\"currentcolor\"/></svg>";

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

@@ -0,0 +1,45 @@
+/**
+ * mokkun v2 レンダラー（DADS 準拠）
+ * v2 文書を旧フォーマットへ変換せずに直接描画する。
+ *
+ * - renderViewV2: HTML 文字列を返す（SSR / 静的出力）
+ * - mountViewV2: container に描画し、イベントを結線して V2Controller を返す
+ *
+ * 設計: docs/format-redesign/03-renderer-v2.md
+ */
+import type { MokkunV2Schema } from '../types/schema-v2';
+import { V2_VIEW_STATES, type V2RenderOptions, type V2ViewState } from './context';
+/** onAction の付随情報 */
+export interface V2ActionPayload {
+    /** Section.actions / list.bulkActions のとき、操作が属する Section の id */
+    section?: string;
+    /** list.bulkActions のとき、選択されている行の ID（行の `id`、なければ先頭列の値、なければ 1 始まりの通し番号） */
+    selectedRows?: string[];
+}
+export interface V2Callbacks {
+    /** グローバルナビ・パンくず・navigate アクションで遷移先 view を通知する */
+    onNavigate?: (view: string) => void;
+    /** navigate 以外のアクション（submit / custom / reset）を実行したとき。Section 内の操作は payload を持つ */
+    onAction?: (actionId: string, kind: string, payload?: V2ActionPayload) => void;
+    /** true のとき、遷移時に location.hash も書き換える（既定 false） */
+    syncHash?: boolean;
+}
+export interface V2Controller {
+    destroy(): void;
+}
+/**
+ * view を HTML 文字列にする。出力は `.mokkun-v2` ルート要素で包まれる。
+ * view 名が存在しないときは空のルートにエラー文を入れて返す。
+ */
+export declare function renderViewV2(schema: MokkunV2Schema, viewName: string, options?: V2RenderOptions): string;
+/**
+ * container に view を描画して振る舞いを結線する。
+ * destroy() でイベントを外し、DADS の CSS 注入も解除する（二重に呼んでも何も起きない）。
+ * 同じ container に destroy() せずに続けて mount すると、前の mount のイベントが残って重複して結線される。
+ * 作り直すときは先に前の V2Controller の destroy() を呼ぶこと。
+ */
+export declare function mountViewV2(container: HTMLElement, schema: MokkunV2Schema, viewName: string, callbacks?: V2Callbacks & V2RenderOptions, options?: V2RenderOptions): V2Controller;
+export { holdV2Styles } from './styles';
+export { V2_VIEW_STATES };
+export { availableStates, parseViewState, resolveRole, resolveViewState, V2_STATE_LABELS } from './view-state';
+export type { V2RenderOptions, V2ViewState };

package/dist/types/renderer-v2/list-cells.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 一覧のセル: 型ごとの表示（status = chip-label、date、number 右寄せ）、リンク（column.to）、入力欄（column.field）
+ */
+import type { ListColumnV2 } from '../types/schema-v2';
+import { type ListRow } from './list-data';
+export declare function renderCell(col: ListColumnV2, row: ListRow, index: number, base: string): string;

package/dist/types/renderer-v2/list-data.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 一覧（kind: list）の行データと、セルの型ごとの値の整形
+ * 行は list.rows（代表行）が優先。なければ列の id / ラベル / type からダミーを作る。
+ */
+import type { ListColumnV2, ListV2 } from '../types/schema-v2';
+import type { ViewContext } from './context';
+export type CellKind = 'id' | 'date' | 'number' | 'status' | 'text';
+/** 列の種類。type があればそれに従い、なければ id / ラベルから推測する（従来どおり） */
+export declare function columnKind(col: ListColumnV2): CellKind;
+/**
+ * 状態列のダミー値に使うラベル。同じ view の status / select / radio などの選択肢から借りる
+ * （項目 id が列 id と同じか、列 id を含むもの。「すべて」は除く）。無ければ undefined
+ */
+export declare function statusLabelsFor(col: ListColumnV2, ctx: ViewContext): string[] | undefined;
+/** 列の id / ラベルから推測したダミー値 */
+export declare function dummyCell(col: ListColumnV2, row: number, ctx?: ViewContext): string;
+export interface ListRow {
+    /** 行 ID。選択行の payload（selectedRows）と入力欄の name に使う。一覧の中で一意 */
+    id: string;
+    values: Record<string, unknown>;
+    /** 1 ページ目に収まらない行（rows と pageSize があるとき。並べ替えのあとで表示を決め直す） */
+    pageHidden: boolean;
+}
+/**
+ * 行 ID を一意にする。空のキーと重複したキーには `#<行の添字（0 始まり）>` を付ける
+ * （付けたあとも既存のキーと重なるなら、重ならなくなるまで `#` を足す）
+ */
+export declare function uniqueRowKeys(keys: string[]): string[];
+/** 表示する行。empty 状態では 0 行。rows があればそれ（pageSize があれば 2 ページ目以降は pageHidden）、なければダミー行 */
+export declare function listRows(list: ListV2, ctx: ViewContext): {
+    rows: ListRow[];
+    total: number;
+    given: boolean;
+};
+/** 日付を「2026年11月7日」にする。YYYY-MM は「2026年11月」。解釈できない値はそのまま */
+export declare function formatDateCell(value: unknown): string;
+/** 数値セル: 数値（と数字だけの文字列）は桁区切りにする。単位付きの文字列はそのまま */
+export declare function formatNumberCell(value: unknown): string;
+/**
+ * 状態ラベル → チップの色（03-renderer-v2.md の表と同じ。上から順に最初に当たったものを使う）
+ *
+ * | 順 | 当たるラベル | 色 |
+ * |---|---|---|
+ * | 1 | 不承認・不承諾・非承認・不可・却下 | error（red） |
+ * | 2 | 未〜・不〜・非〜で始まる（未完了・不備）、〜予定、〜なし で終わる | neutral（gray） |
+ * | 3 | 〜待ち で終わる（承認待ち・キャンセル待ち） | warning（yellow） |
+ * | 4 | 間近・保留・注意・期限・差戻 | warning（yellow） |
+ * | 5 | 要確認・要対応・エラー・欠品・失敗・取下・無効・廃番 | error（red） |
+ * | 6 | 〜済（対応済み・送信済み・受付済）・完了・承認・内定・有効・適正・販売中・成功・受理 | success（green） |
+ * | 7 | 処理中・審査中・確認中・準備中・対応中・配送中・進行中 | info（light-blue） |
+ * | 8 | それ以外（キャンセル・受付・下書きなど） | neutral（gray） |
+ */
+export declare function statusColor(label: string): string;

package/dist/types/renderer-v2/mount-parts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 部品ごとの小さな振る舞い: switch / file-upload / table の並べ替え / tab / submenu / dialog
+ */
+/** switch の状態を aria-checked と、フォーム送信用の hidden input の両方へ反映する */
+export declare function setSwitch(button: HTMLElement, on: boolean): void;
+export declare function toggleSwitch(button: HTMLElement): void;
+/** 選択済みファイルを一覧に反映する（DADS の file-upload JS の最小相当） */
+export declare function updateFileList(input: HTMLInputElement): void;
+/** 並べ替えヘッダーのクリック。none → ascending → descending → ascending … */
+export declare function sortTable(button: HTMLElement): void;
+/** rows と pageSize があるときは、並べ替えた全行の先頭 pageSize 件だけを表示する（2 ページ目以降は hidden） */
+export declare function applyPage(list: HTMLElement | null): void;
+export declare function selectTab(tab: HTMLElement): void;
+/** 矢印キー / Home / End で隣のタブへ */
+export declare function moveTabFocus(tab: HTMLElement, key: string): boolean;
+export declare function setSubmenu(button: HTMLElement, open: boolean): void;
+export declare function closeAllSubmenus(root: ParentNode): void;
+export declare function openDialog(dialog: HTMLDialogElement): void;
+export declare function closeDialog(dialog: HTMLDialogElement): void;

package/dist/types/renderer-v2/mount-repeat.d.ts

@@ -0,0 +1,8 @@
+/**
+ * repeatable: グループの追加・削除、添字の再採番、min / max の反映
+ */
+export declare function syncAllRepeatables(root: ParentNode): void;
+/** クリックされたボタンが追加 / 削除なら処理して true を返す */
+export declare function handleRepeatClick(target: Element): boolean;
+/** フォームのリセット後: 繰り返しグループを min 件に戻す（超過分は削除） */
+export declare function resetRepeatables(root: ParentNode): void;

package/dist/types/renderer-v2/mount-section.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Section 単位の操作: reset（その Section の項目だけ初期値に戻す）、一括操作が使う選択行の収集
+ */
+/** 行の選択チェックボックス／ラジオで選ばれている行 ID（list.bulkActions の payload.selectedRows） */
+export declare function selectedRowIds(root: HTMLElement, sectionId: string | undefined): string[];
+/**
+ * その Section の入力欄だけを初期値に戻す（ネイティブの form.reset() はフォーム全体を戻してしまう）。
+ * 繰り返しは min 件に戻し、switch とファイル一覧も追随させる。
+ */
+export declare function resetSection(root: HTMLElement, sectionId: string | undefined): void;

package/dist/types/renderer-v2/mount-visibility.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 条件: 参照先項目の現在値で、visibleWhen（項目ラッパー／セクションの hidden）と
+ * requiredWhen（必須／任意の表示と required 属性）を切り替える
+ */
+import { type Token } from './condition';
+/** 項目の現在値。複数選択（data-multiple）は選択値の配列、単一 checkbox / switch は 'true' / 'false' */
+export declare function readValue(field: HTMLElement): Token;
+/** root 内の [data-visible-when] をすべて評価する */
+export declare function evaluateVisibility(root: ParentNode): void;
+/** root 内の [data-required-when] をすべて評価し、「※必須」「※任意」と required 属性を切り替える */
+export declare function evaluateRequired(root: ParentNode): void;
+/** visibleWhen と requiredWhen を評価する */
+export declare function evaluateConditions(root: ParentNode): void;

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

@@ -0,0 +1,9 @@
+/**
+ * mountViewV2 の振る舞い結線（イベント委譲）
+ * - 遷移: グローバルナビ・パンくず・navigate アクション → callbacks.onNavigate
+ * - 確認ダイアログ: アクションボタンで開き、確定ボタンでアクションを実行
+ * - visibleWhen / repeatable / accordion 以外の DADS 部品の最小限の JS
+ */
+import type { V2Callbacks } from './index';
+/** イベントを結線する。戻り値で解除 */
+export declare function attachV2Behavior(root: HTMLElement, callbacks: V2Callbacks): () => void;

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

@@ -0,0 +1,15 @@
+/**
+ * ロール指定（Action.role / NavGroup.role / Notice.role）の評価
+ */
+import type { RoleSpecV2 } from '../types/schema-v2';
+/**
+ * 現在のロールで表示するか。role の省略は全ロール、現在のロールが未選択なら常に表示する
+ * （ロールを選ばない既存の挙動を変えない）。
+ */
+export declare function visibleForRole(role: RoleSpecV2 | undefined, current: string | undefined): boolean;
+/** ローカル日付 YYYY-MM-DD */
+export declare function isoDate(date: Date): string;
+/** until が今日より前なら期限切れ（当日までは表示する） */
+export declare function isExpired(until: string | undefined, today: string): boolean;
+/** 今日（YYYY-MM-DD）。YYYY-MM-DD の文字列か有効な Date だけ受け付け、それ以外は実行時の日付にする */
+export declare function resolveToday(today: Date | string | undefined): string;

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

@@ -0,0 +1,11 @@
+/**
+ * kind: form の項目グリッドと repeatable
+ */
+import type { SectionV2 } from '../types/schema-v2';
+import { type ViewContext } from './context';
+/** 添字付きの DOM id / name の区切り。mount.ts が繰り返しの再採番に使う */
+export declare const GROUP_SEP = "__";
+/** 項目グリッド。group を渡すと繰り返しグループ内（id / name に添字を付ける） */
+export declare function renderFieldGrid(section: SectionV2, ctx: ViewContext, group?: number): string;
+/** 繰り返し: min 件を初期表示し、追加用に <template> を持つ */
+export declare function renderRepeatable(section: SectionV2, ctx: ViewContext): string;

package/dist/types/renderer-v2/section-list.d.ts

@@ -0,0 +1,8 @@
+/**
+ * kind: list → table（ソート可能列は sortable-header）+ page-navigation
+ * 行は list.rows（代表行）があればそれを、なければ list-data.ts のダミー（3 行）
+ * 検索と bulkActions（選択した行への操作）は表の上の同じ行に置く
+ */
+import type { SectionV2 } from '../types/schema-v2';
+import { type ViewContext } from './context';
+export declare function renderList(section: SectionV2, ctx: ViewContext): string;

package/dist/types/renderer-v2/section-readonly.d.ts

@@ -0,0 +1,8 @@
+/**
+ * kind: readonly / summary → description-list（term = ラベル、description = 値）
+ */
+import type { FieldV2, SectionV2 } from '../types/schema-v2';
+import type { ViewContext } from './context';
+/** 表示値（options があればラベルに置換、値なしは -） */
+export declare function displayText(f: FieldV2): string;
+export declare function renderReadonly(section: SectionV2, ctx: ViewContext): string;

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

@@ -0,0 +1,15 @@
+/**
+ * Section 層: kind / reveal / repeatable の出し分け
+ *
+ * - reveal: collapsed が 1 つだけ → DADS disclosure（見出しはサマリー自身）
+ * - collapsed が連続 → 1 つの積み重ねた DADS accordion（各サマリー = セクション名）
+ * - visibleWhen はセクション要素自身に付ける（見出しごと隠れる）
+ */
+import type { SectionV2 } from '../types/schema-v2';
+import { type ViewContext } from './context';
+/** Section の DOM id（toc・タブのリンク先） */
+export declare function sectionDomId(ctx: ViewContext, section: SectionV2): string;
+/** 通常（open）のセクション */
+export declare function renderSection(section: SectionV2, ctx: ViewContext): string;
+/** セクション列を描画する。連続する collapsed は 1 つの accordion にまとめ、1 つだけなら disclosure */
+export declare function renderSections(sections: SectionV2[], ctx: ViewContext): string;

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

@@ -0,0 +1,13 @@
+/**
+ * DADS の CSS を v2 描画中だけ document に差し込む。
+ *
+ * DADS の global.css は html / a / :focus-visible などの要素セレクタを含むため、
+ * ライブラリの CSS（mokkun.css）に静的に含めると v1 画面まで再スタイルされる。
+ * そのため ?inline で文字列として取り込み、v2 を描画している間だけ <style> として挿入する。
+ */
+/**
+ * スタイルを 1 つ保持する。戻り値の release で解放する（二重に呼んでも 1 回分しか減らない）。
+ * 画面遷移で「古い view を destroy → 新しい view を mount」する間に <style> が外れて付け直されないよう、
+ * 呼び出し側は destroy の前に hold し、mount の後に release する。
+ */
+export declare function holdV2Styles(): () => void;

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

@@ -0,0 +1,28 @@
+/**
+ * v2 レンダラー共通ユーティリティ
+ * HTML 文字列を組み立てるための最小限のヘルパー（DOM に依存しない）
+ */
+/**
+ * ユーザー由来のテキストを HTML（要素内・属性値）に埋め込めるようエスケープする
+ */
+export declare function esc(value: unknown): string;
+type AttrValue = string | number | boolean | null | undefined;
+/**
+ * 属性文字列を組み立てる。true は値なし属性、false / null / undefined は出力しない。
+ * 先頭に空白を含むため、そのままタグ名の直後に連結できる。
+ */
+export declare function attrs(map: Record<string, AttrValue>): string;
+/** 値を比較用の文字列にする（YAML の数値・真偽値と DOM の文字列値を揃える） */
+export declare function str(value: unknown): string;
+/** props から文字列を取り出す */
+export declare function propString(props: Record<string, unknown> | undefined, key: string): string | undefined;
+/** props から有限の数値を取り出す */
+export declare function propNumber(props: Record<string, unknown> | undefined, key: string): number | undefined;
+/**
+ * リンク・画像の URL を http / https / mailto に限る（javascript: などは '#' に置き換える）。
+ * 相対 URL は許可する。
+ */
+export declare function safeUrl(url: unknown): string;
+/** props の配列から、指定キーが文字列のオブジェクトだけを取り出す */
+export declare function objectItems<T extends object>(value: unknown, requiredStringKey: string): T[];
+export {};

package/dist/types/renderer-v2/view-state.d.ts

@@ -0,0 +1,25 @@
+/**
+ * View の状態表示（ビューアーの「状態」切替）
+ * - 既定（normal）は状態バナーを出さない。success / error は選ばれた 1 つだけ、同時には出さない
+ * - loading は DADS の progress-indicator（スピナー）。フォームの代わりに出す
+ * - empty は一覧の空表示（section-list.ts）で扱う
+ */
+import type { MokkunV2Schema } from '../types/schema-v2';
+import { type V2ViewState, type ViewContext } from './context';
+/** states.success / error のバナー。選ばれた状態の分だけ出す */
+export declare function renderStates(ctx: ViewContext): string;
+/** 読み込み中（上流 progress-indicator の spinner-loop.html、stacked / 大）。不確定進捗なので data-indeterminate を静的に付ける */
+export declare function renderLoading(ctx: ViewContext): string;
+/** 状態の表示名（ビューアーの選択肢） */
+export declare const V2_STATE_LABELS: Record<V2ViewState, string>;
+/**
+ * view が選べる状態。normal は常に、success / error / loading は対応する states.* があるとき、
+ * empty は states.empty か、list.empty を持つ一覧があるとき（一覧の空文言は list.empty が正）
+ */
+export declare function availableStates(schema: MokkunV2Schema, viewName: string): V2ViewState[];
+/** URL パラメータなどの文字列を状態にする（不正は normal） */
+export declare function parseViewState(value: unknown): V2ViewState;
+/** view で選べない状態なら normal に戻す（不正な値も normal） */
+export declare function resolveViewState(schema: MokkunV2Schema, viewName: string, state: unknown): V2ViewState;
+/** app.roles にあるロールだけ（それ以外は未選択＝すべて） */
+export declare function resolveRole(schema: MokkunV2Schema, role: unknown): string | undefined;

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

@@ -0,0 +1,8 @@
+/**
+ * View 層: 見出し、ゴール、手順ナビ、状態バナー、アクション、レイアウト（stack / tabs / sectioned）
+ */
+import { type ViewContext } from './context';
+/** flow の手順ナビ（step-navigation, horizontal）。前の step は completed、現在の step は reached */
+export declare function renderStepNavigation(ctx: ViewContext): string;
+/** View 本体（main の中身）: パンくずは app-shell 側で前置する */
+export declare function renderViewBody(ctx: ViewContext): string;

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

@@ -4,3 +4,4 @@
 export * from './schema';
 export * from './theme';
 export * from './field-renderable';
+export * from './schema-v2';