@flextudio/scenario 0.1.0

package/contract-data/runtime/v1/intent-system/intent.schema.json

@@ -0,0 +1,164 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "intent.schema.json",
+  "title": "intent — runtime short-form 진입점",
+  "description": "intent:{<slot>:...} 진입점. 호스트 노드 안에 박혀 있다가 materialize 단계에서 raw Script 본문으로 펼쳐진 뒤 트리에서 제거된다. 활성 슬롯: mock (Phase 2), script (Phase 3 — 6 kind). Panel.* + Collections 는 스튜디오 자동 재생성이라 AI 단에서 카테고리 정의 슬롯 미제공. 진실원본: runtime/v1/intent-system/INTENT.md",
+  "type": "object",
+  "properties": {
+    "mock": { "$ref": "#/$defs/mockSlot" },
+    "script": { "$ref": "#/$defs/scriptSlot" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "categoryName": {
+      "type": "string",
+      "pattern": "^Ctg[A-Z][A-Za-z0-9]*$",
+      "description": "Ctg 접두 + PascalCase. cross-check [category-name] 과 정렬."
+    },
+    "fid": {
+      "type": "string",
+      "pattern": "^f_[1-9][0-9]*$",
+      "description": "Group Id (f_N 형태)."
+    },
+    "sectorKey": {
+      "$ref": "../../../schema/v1/naming-objects.schema.json#/$defs/ckey",
+      "description": "컬렉션키 / 섹터 키 — schema/v1/naming-objects.schema.json $defs.ckey 의 정의 (JS 식별자 + sectorReservedKeys + jsReservedWords 차단) 와 정합. 단 intent walker 는 펼침 시점에 추가로 case-insensitive 검사 (Status / STATUS / status 모두 차단)."
+    },
+    "sectorObject": {
+      "type": "object",
+      "description": "한 섹터의 필드 맵. 키는 sectorKey 형식, 값은 primitive / 중첩 객체/배열 자유.",
+      "propertyNames": { "$ref": "#/$defs/sectorKey" },
+      "additionalProperties": true,
+      "minProperties": 1
+    },
+    "mockSlot": {
+      "type": "object",
+      "description": "intent.mock — { '<Cat>': [sectorObject, ...], ... }. Step.Events.Init 의 Action:'Script' 안에만 박을 수 있음 (scope: event-script-init). materialize 가 f.Collection.addSector(...) 라인들로 펼침.",
+      "propertyNames": { "$ref": "#/$defs/categoryName" },
+      "additionalProperties": {
+        "type": "array",
+        "items": { "$ref": "#/$defs/sectorObject" }
+      },
+      "minProperties": 1
+    },
+    "scriptSlot": {
+      "type": "object",
+      "description": "intent.script — { kind: '<name>', ... kindProps }. Events 안의 Action:'Script' 에서 사용. materialize 가 kind 별 정형 idiom 으로 펼침. 활성 kind: dialog / reloadGroup / clearCategory / deleteActive / updateActive / copyStepValues.",
+      "required": ["kind"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": ["dialog", "updateActive", "clearCategory", "reloadGroup", "deleteActive", "copyStepValues"]
+        }
+      },
+      "allOf": [
+        { "if": { "properties": { "kind": { "const": "dialog" } } },         "then": { "$ref": "#/$defs/dialogProps" } },
+        { "if": { "properties": { "kind": { "const": "reloadGroup" } } },    "then": { "$ref": "#/$defs/reloadGroupProps" } },
+        { "if": { "properties": { "kind": { "const": "clearCategory" } } },  "then": { "$ref": "#/$defs/clearCategoryProps" } },
+        { "if": { "properties": { "kind": { "const": "deleteActive" } } },   "then": { "$ref": "#/$defs/deleteActiveProps" } },
+        { "if": { "properties": { "kind": { "const": "updateActive" } } },   "then": { "$ref": "#/$defs/updateActiveProps" } },
+        { "if": { "properties": { "kind": { "const": "copyStepValues" } } }, "then": { "$ref": "#/$defs/copyStepValuesProps" } }
+      ]
+    },
+    "dialogProps": {
+      "type": "object",
+      "description": "intent.script(dialog) props. f.MessageBox(type).setTitle().setDescription()?.addButton/addBtn().show() 정형으로 1:1 펼침.",
+      "required": ["type", "title", "buttons"],
+      "properties": {
+        "kind": { "const": "dialog" },
+        "type": { "enum": ["Alert", "Error", "Completed"], "description": "f.MessageBox(type) 의 type 인자" },
+        "title": { "type": "string", "minLength": 1, "description": ".setTitle(...)" },
+        "body": { "type": "string", "description": ".setDescription(...) — 옵션, 없으면 호출 생략" },
+        "buttons": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/dialogButton" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "dialogButton": {
+      "type": "object",
+      "required": ["label"],
+      "properties": {
+        "label": { "type": "string", "minLength": 1, "description": "버튼 라벨 (1번째 인자)" },
+        "event": { "type": "string", "minLength": 1, "description": "scenario.Events 키 — 없으면 null (닫기). 실재성은 [event-ref] cross-check 가 검사." },
+        "moveType": {
+          "enum": ["None", "Next", "Prev", "Init", "Close", "JumpTo"],
+          "description": "있으면 addButton(MOVETYPE_*, ...) 풀 시그니처, 없으면 addBtn(...) 약식"
+        },
+        "color": { "const": "sub", "description": "addBtn(..., true) 보조 스타일 토글. 다른 값 불가." }
+      },
+      "additionalProperties": false
+    },
+    "reloadGroupProps": {
+      "type": "object",
+      "description": "intent.script(reloadGroup) — f.Content(fid).reload() 한 줄.",
+      "required": ["fid"],
+      "properties": {
+        "kind": { "const": "reloadGroup" },
+        "fid": { "$ref": "#/$defs/fid" }
+      },
+      "additionalProperties": false
+    },
+    "clearCategoryProps": {
+      "type": "object",
+      "description": "intent.script(clearCategory) — f.Collection.removeSector('all', cat) + 옵션 reload.",
+      "required": ["cat"],
+      "properties": {
+        "kind": { "const": "clearCategory" },
+        "cat": { "$ref": "#/$defs/categoryName" },
+        "reload": { "$ref": "#/$defs/fid" }
+      },
+      "additionalProperties": false
+    },
+    "deleteActiveProps": {
+      "type": "object",
+      "description": "intent.script(deleteActive) — 가드 2단 + cur.delete() + 옵션 reload.",
+      "required": ["cat"],
+      "properties": {
+        "kind": { "const": "deleteActive" },
+        "cat": { "$ref": "#/$defs/categoryName" },
+        "reload": { "$ref": "#/$defs/fid" }
+      },
+      "additionalProperties": false
+    },
+    "updateActiveProps": {
+      "type": "object",
+      "description": "intent.script(updateActive) — 가드 2단 + 다중 필드 직접 대입 + 옵션 reload.",
+      "required": ["cat", "set"],
+      "properties": {
+        "kind": { "const": "updateActive" },
+        "cat": { "$ref": "#/$defs/categoryName" },
+        "set": {
+          "type": "object",
+          "description": "{ <fieldKey>: <value>, ... } — 1개 이상. value 는 primitive / 중첩 객체/배열.",
+          "propertyNames": { "$ref": "#/$defs/sectorKey" },
+          "additionalProperties": true,
+          "minProperties": 1
+        },
+        "reload": { "$ref": "#/$defs/fid" }
+      },
+      "additionalProperties": false
+    },
+    "copyStepValuesProps": {
+      "type": "object",
+      "description": "intent.script(copyStepValues) — Step 간 활성 섹터 필드 1대1 매핑. 두 카테고리의 활성 섹터 가드 4단 + 매핑 라인 N + 옵션 reload. {=Field} 토큰 raw 침투를 short-form 으로 흡수 (병목 2-a).",
+      "required": ["from", "to", "map"],
+      "properties": {
+        "kind": { "const": "copyStepValues" },
+        "from": { "$ref": "#/$defs/categoryName", "description": "원본 카테고리 (이전 Step 에서 활성 섹터가 살아있다고 가정)." },
+        "to": { "$ref": "#/$defs/categoryName", "description": "대상 카테고리 (현재 Step 의 표시/요약 영역)." },
+        "map": {
+          "type": "object",
+          "description": "{ '<srcKey>': '<dstKey>', ... } — 1대1 매핑. 값은 대상 필드 키 문자열. 1개 이상.",
+          "propertyNames": { "$ref": "#/$defs/sectorKey" },
+          "additionalProperties": { "$ref": "#/$defs/sectorKey" },
+          "minProperties": 1
+        },
+        "reload": { "$ref": "#/$defs/fid" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/contract-data/runtime/v1/intent-system/kinds/_base.mjs

@@ -0,0 +1,137 @@
+// runtime/v1/intent-system/kinds/_base.mjs
+// ─────────────────────────────────────────────────────────────────────────────
+// 5+ script kind 가 공유하는 가드 / 직렬화 / 예약어 enum.
+//
+// 예약어 진실원본: schema/v1/naming-objects.schema.json
+//   - sectorReservedKeys (시스템 게터: _SUID, _mSUID, status, isActive, ...)
+//   - jsReservedWords    (JS 예약어 + 빌트인: for, class, Object, prototype, ...)
+//
+// 본 모듈은 위 enum 을 readFileSync 로 가져와 intent 펼침 시점에 case-insensitive
+// 차단 검사를 한다. case-insensitive 강화는 schema 보다 한 단계 더 엄격 —
+// 사용자가 `Status` / `STATUS` 같은 변종으로 시스템 키와 충돌하는 ckey 를
+// 생성하지 못하도록 진입 전 차단.
+// ─────────────────────────────────────────────────────────────────────────────
+
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const NAMING_SCHEMA_PATH = join(
+  __dirname,
+  "..",
+  "..",
+  "..",
+  "..",
+  "schema",
+  "v1",
+  "naming-objects.schema.json",
+);
+
+const _namingSchema = JSON.parse(readFileSync(NAMING_SCHEMA_PATH, "utf-8"));
+
+/** 시스템 게터 / Sector 인스턴스 속성 충돌 — 진실원본 enum (15개). */
+export const SECTOR_RESERVED_KEYS = Object.freeze([
+  ...(_namingSchema.$defs?.sectorReservedKeys?.enum ?? []),
+]);
+
+/** JS 예약어 + 빌트인 / 글로벌 — 진실원본 enum (50+개). */
+export const JS_RESERVED_WORDS = Object.freeze([
+  ...(_namingSchema.$defs?.jsReservedWords?.enum ?? []),
+]);
+
+const _RESERVED_LOWER = new Set(
+  [...SECTOR_RESERVED_KEYS, ...JS_RESERVED_WORDS].map((s) => s.toLowerCase()),
+);
+
+/**
+ * 컬렉션키 / 섹터 키 / set 키의 예약어 충돌 검사.
+ *
+ * **case-insensitive** — `Status` / `STATUS` / `status` 모두 차단. 사용자가
+ * 시스템 키워드의 변종으로 ckey 를 생성하지 못하도록.
+ *
+ * @returns {{ ok: true } | { ok: false, reason: 'sector-getter'|'js-reserved', match: string }}
+ */
+export function checkReservedCkey(name) {
+  const lower = String(name).toLowerCase();
+  if (!_RESERVED_LOWER.has(lower)) return { ok: true };
+  // 어떤 enum 에 매치되는지 보고 사용자에게 원인 안내.
+  const sectorMatch = SECTOR_RESERVED_KEYS.find((s) => s.toLowerCase() === lower);
+  if (sectorMatch) return { ok: false, reason: "sector-getter", match: sectorMatch };
+  const jsMatch = JS_RESERVED_WORDS.find((s) => s.toLowerCase() === lower);
+  return { ok: false, reason: "js-reserved", match: jsMatch ?? lower };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 형식 패턴 — schema 의 ckey / categoryName 과 정합.
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** 카테고리명 컨벤션 — `Ctg` 접두 + PascalCase. intent 측 strict 적용. */
+export const CATEGORY_NAME_RE = /^Ctg[A-Z][A-Za-z0-9]*$/;
+
+/** Group / Control fid — `f_숫자`. */
+export const FID_RE = /^f_[1-9][0-9]*$/;
+
+/**
+ * 컬렉션키 / 섹터 키 형식 — JS 식별자 (schema 의 ckey 패턴과 정합).
+ * `_` 시작 허용 — 진짜 예약어 검사는 `checkReservedCkey` 에 위임.
+ */
+export const SECTOR_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// JS 직렬화 — kind 별 펼침 함수가 공유.
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** 작은따옴표 + 백슬래시/작은따옴표/개행 이스케이프. f_messagebox.md 와 동일 형식. */
+export function jsString(s) {
+  return `'${String(s)
+    .replace(/\\/g, "\\\\")
+    .replace(/'/g, "\\'")
+    .replace(/\n/g, "\\n")
+    .replace(/\r/g, "\\r")}'`;
+}
+
+/** 임의 값 → JS 리터럴. string→jsString / number·boolean·null→그대로 / object·array→JSON.stringify. */
+export function jsValue(v) {
+  if (v == null) return v === undefined ? "undefined" : "null";
+  if (typeof v === "string") return jsString(v);
+  if (typeof v === "number" || typeof v === "boolean") return String(v);
+  if (typeof v === "object") return JSON.stringify(v);
+  return JSON.stringify(v);
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 공통 에러 빌더 — 일관된 phase 명명을 위한 헬퍼.
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** ckey/섹터키/set 키의 형식+예약어 검사. 한 줄로 호출 후 errors 누적. */
+export function validateKey(name, opts) {
+  const { path, errors, kindLabel, kindPhasePrefix } = opts;
+  if (!SECTOR_KEY_RE.test(name)) {
+    errors.push({
+      kind: "intent",
+      phase: `${kindPhasePrefix}-format`,
+      path,
+      key: name,
+      message: `${kindLabel} 키 '${name}' 형식 위반 — JS 식별자 (영문/언더스코어 시작 + 영숫자/언더스코어).`,
+    });
+    return false;
+  }
+  const r = checkReservedCkey(name);
+  if (!r.ok) {
+    errors.push({
+      kind: "intent",
+      phase: `${kindPhasePrefix}-reserved`,
+      path,
+      key: name,
+      reservedReason: r.reason,
+      matchedAgainst: r.match,
+      message:
+        r.reason === "sector-getter"
+          ? `${kindLabel} 키 '${name}' 가 Sector 시스템 게터 '${r.match}' 와 충돌 (case-insensitive). setter 가 동작하지 않음. 다른 이름 사용. 진실원본: schema/v1/naming-objects.schema.json $defs.sectorReservedKeys.`
+          : `${kindLabel} 키 '${name}' 가 JS 예약어/빌트인 '${r.match}' 와 충돌 (case-insensitive). 점 표기법 (\`_c.Cat.<key>\`) 접근 시 빌트인이 우선되어 동작이 깨짐. 다른 이름 사용. 진실원본: schema/v1/naming-objects.schema.json $defs.jsReservedWords.`,
+    });
+    return false;
+  }
+  return true;
+}

package/contract-data/runtime/v1/intent-system/kinds/clearCategory.mjs

@@ -0,0 +1,35 @@
+// kinds/clearCategory.mjs — f.Collection.removeSector('all', cat) + 옵션 reload
+
+import { CATEGORY_NAME_RE, FID_RE, jsString } from "./_base.mjs";
+
+export const meta = Object.freeze({
+  name: "clearCategory",
+  allowedScopes: null,
+  summary: "카테고리 비우기 — f.Collection.removeSector('all', cat) + 옵션 reload",
+});
+
+export default function expand(props, scopePath) {
+  const errors = [];
+  const { cat, reload } = props;
+  if (!CATEGORY_NAME_RE.test(cat || "")) {
+    errors.push({
+      kind: "intent",
+      phase: "clearCategory-cat-format",
+      path: `${scopePath}.cat`,
+      message: `intent.script(clearCategory).cat 형식 위반 — 'Ctg' 접두 + PascalCase. 받은 값: ${JSON.stringify(cat)}.`,
+    });
+  }
+  if (reload != null && !FID_RE.test(reload)) {
+    errors.push({
+      kind: "intent",
+      phase: "clearCategory-reload-format",
+      path: `${scopePath}.reload`,
+      message: `intent.script(clearCategory).reload 는 'f_N' 형태 (옵션). 받은 값: ${JSON.stringify(reload)}.`,
+    });
+  }
+  if (errors.length > 0) return { script: "", errors };
+
+  const lines = [`f.Collection.removeSector('all', ${jsString(cat)})`];
+  if (reload) lines.push(`f.Content(${jsString(reload)}).reload()`);
+  return { script: lines.join("\n"), errors: [] };
+}

package/contract-data/runtime/v1/intent-system/kinds/copyStepValues.mjs

@@ -0,0 +1,100 @@
+// kinds/copyStepValues.mjs — Step 간 활성 섹터 필드 1대1 매핑.
+//
+// 병목 2-a 흡수 — `{=Field}` 토큰을 script 자리에 박는 raw 사고를 short-form 으로 차단.
+// from / to 두 카테고리의 활성 섹터 가드 4단 + dst.<dstKey> = src.<srcKey> 라인 N + 옵션 reload.
+
+import {
+  CATEGORY_NAME_RE,
+  FID_RE,
+  jsString,
+  validateKey,
+} from "./_base.mjs";
+
+export const meta = Object.freeze({
+  name: "copyStepValues",
+  allowedScopes: null,
+  summary: "Step 간 활성 섹터 필드 1대1 매핑 — 가드 4단 + 대입 N + 옵션 reload",
+});
+
+export default function expand(props, scopePath) {
+  const errors = [];
+  const { from, to, map, reload } = props;
+
+  if (!CATEGORY_NAME_RE.test(from || "")) {
+    errors.push({
+      kind: "intent",
+      phase: "copyStepValues-from-format",
+      path: `${scopePath}.from`,
+      message: `intent.script(copyStepValues).from 형식 위반 — 'Ctg' 접두 + PascalCase.`,
+    });
+  }
+  if (!CATEGORY_NAME_RE.test(to || "")) {
+    errors.push({
+      kind: "intent",
+      phase: "copyStepValues-to-format",
+      path: `${scopePath}.to`,
+      message: `intent.script(copyStepValues).to 형식 위반 — 'Ctg' 접두 + PascalCase.`,
+    });
+  }
+  if (!map || typeof map !== "object" || Array.isArray(map)) {
+    errors.push({
+      kind: "intent",
+      phase: "copyStepValues-map-shape",
+      path: `${scopePath}.map`,
+      message: `intent.script(copyStepValues).map 은 { srcKey: dstKey, ... } 객체 필수.`,
+    });
+  } else if (Object.keys(map).length === 0) {
+    errors.push({
+      kind: "intent",
+      phase: "copyStepValues-map-empty",
+      path: `${scopePath}.map`,
+      message: `intent.script(copyStepValues).map 은 1개 이상의 매핑 필수.`,
+    });
+  }
+  if (reload != null && !FID_RE.test(reload)) {
+    errors.push({
+      kind: "intent",
+      phase: "copyStepValues-reload-format",
+      path: `${scopePath}.reload`,
+      message: `intent.script(copyStepValues).reload 는 'f_N' 형태 (옵션).`,
+    });
+  }
+  if (errors.length > 0) return { script: "", errors };
+
+  for (const [src, dst] of Object.entries(map)) {
+    validateKey(src, {
+      path: `${scopePath}.map.${src}`,
+      errors,
+      kindLabel: "intent.script(copyStepValues).map(src)",
+      kindPhasePrefix: "copyStepValues-map-src-key",
+    });
+    if (typeof dst !== "string") {
+      errors.push({
+        kind: "intent",
+        phase: "copyStepValues-map-dst-shape",
+        path: `${scopePath}.map.${src}`,
+        message: `intent.script(copyStepValues).map['${src}'] 값은 대상 키 문자열이어야 함.`,
+      });
+      continue;
+    }
+    validateKey(dst, {
+      path: `${scopePath}.map.${src}`,
+      errors,
+      kindLabel: "intent.script(copyStepValues).map(dst)",
+      kindPhasePrefix: "copyStepValues-map-dst-key",
+    });
+  }
+  if (errors.length > 0) return { script: "", errors };
+
+  const lines = [
+    `if (!_c.${from} || !_c.${to}) return;`,
+    `const src = _c.${from}.activeSector;`,
+    `const dst = _c.${to}.activeSector;`,
+    `if (!src || !dst) return;`,
+  ];
+  for (const [src, dst] of Object.entries(map)) {
+    lines.push(`dst.${dst} = src.${src};`);
+  }
+  if (reload) lines.push(`f.Content(${jsString(reload)}).reload();`);
+  return { script: lines.join("\n"), errors: [] };
+}

package/contract-data/runtime/v1/intent-system/kinds/deleteActive.mjs

@@ -0,0 +1,45 @@
+// kinds/deleteActive.mjs — 가드 2단 + cur.release() + 옵션 reload (scripts.md §C)
+//
+// ★ cur.delete() 가 아니라 cur.release() — delete() 는 added 가 아닌 섹터를
+//   deleted 상태로 컬렉션에 남긴다(백엔드 동기화용 표시). 생성 시나리오는
+//   서버 동기화가 없으므로 잔존 deleted 섹터가 집계/반복 루프를 오염시킨다 —
+//   완전삭제 release() 가 정본 (runtime/v1/collection/sector.md §4-4).
+
+import { CATEGORY_NAME_RE, FID_RE, jsString } from "./_base.mjs";
+
+export const meta = Object.freeze({
+  name: "deleteActive",
+  allowedScopes: null,
+  summary: "활성 섹터 완전삭제 — 가드 2단 + cur.release() + 옵션 reload",
+});
+
+export default function expand(props, scopePath) {
+  const errors = [];
+  const { cat, reload } = props;
+  if (!CATEGORY_NAME_RE.test(cat || "")) {
+    errors.push({
+      kind: "intent",
+      phase: "deleteActive-cat-format",
+      path: `${scopePath}.cat`,
+      message: `intent.script(deleteActive).cat 형식 위반 — 'Ctg' 접두 + PascalCase.`,
+    });
+  }
+  if (reload != null && !FID_RE.test(reload)) {
+    errors.push({
+      kind: "intent",
+      phase: "deleteActive-reload-format",
+      path: `${scopePath}.reload`,
+      message: `intent.script(deleteActive).reload 는 'f_N' 형태 (옵션).`,
+    });
+  }
+  if (errors.length > 0) return { script: "", errors };
+
+  const lines = [
+    `if (!_c.${cat}) return;`,
+    `const cur = _c.${cat}.activeSector;`,
+    `if (!cur) return;`,
+    `cur.release();`,
+  ];
+  if (reload) lines.push(`f.Content(${jsString(reload)}).reload();`);
+  return { script: lines.join("\n"), errors: [] };
+}

package/contract-data/runtime/v1/intent-system/kinds/dialog.mjs

@@ -0,0 +1,127 @@
+// kinds/dialog.mjs — f.MessageBox(...) 정형 패턴 펼침
+//
+// 입력 props: { kind, type, title, body?, buttons:[{label, event?, moveType?, color?}] }
+// 출력 script: f.MessageBox(type).setTitle().setDescription()?.addButton/addBtn(...).show()
+//
+// 진실원본: runtime/v1/script/f_messagebox.md (메서드 시그니처 / 종결자 .show())
+
+import { jsString } from "./_base.mjs";
+
+export const meta = Object.freeze({
+  name: "dialog",
+  allowedScopes: null, // 슬롯의 allowedScopes 를 따름 (event-script / event-script-init)
+  summary: "모달 다이얼로그 — f.MessageBox(type).setTitle().setDescription()?.addBtn/addButton(...).show()",
+});
+
+const TYPE_ENUM = new Set(["Alert", "Error", "Completed"]);
+const MOVE_TYPE_ENUM = new Set(["None", "Next", "Prev", "Init", "Close", "JumpTo"]);
+
+export default function expand(props, scopePath) {
+  const errors = [];
+  const { type, title, body, buttons } = props;
+
+  if (!TYPE_ENUM.has(type)) {
+    errors.push({
+      kind: "intent",
+      phase: "dialog-type-enum",
+      path: `${scopePath}.type`,
+      message: `intent.script(dialog).type '${type}' 미정의 — 허용: ${[...TYPE_ENUM].join(" / ")}.`,
+    });
+  }
+  if (typeof title !== "string" || title === "") {
+    errors.push({
+      kind: "intent",
+      phase: "dialog-title-required",
+      path: `${scopePath}.title`,
+      message: `intent.script(dialog).title 필수 — 비어있지 않은 문자열.`,
+    });
+  }
+  if (!Array.isArray(buttons) || buttons.length === 0) {
+    errors.push({
+      kind: "intent",
+      phase: "dialog-buttons-empty",
+      path: `${scopePath}.buttons`,
+      message: `intent.script(dialog).buttons 필수 — 1개 이상의 버튼 배열.`,
+    });
+  }
+  if (body != null && typeof body !== "string") {
+    errors.push({
+      kind: "intent",
+      phase: "dialog-body-type",
+      path: `${scopePath}.body`,
+      message: `intent.script(dialog).body 는 문자열이어야 함 (옵션).`,
+    });
+  }
+  if (errors.length > 0) return { script: "", errors };
+
+  const btnParts = [];
+  for (let i = 0; i < buttons.length; i++) {
+    const btn = buttons[i];
+    const btnPath = `${scopePath}.buttons[${i}]`;
+    if (!btn || typeof btn !== "object" || Array.isArray(btn)) {
+      errors.push({
+        kind: "intent",
+        phase: "dialog-button-shape",
+        path: btnPath,
+        message: `버튼 항목은 객체여야 함 ({ label, event?, moveType?, color? }).`,
+      });
+      continue;
+    }
+    if (typeof btn.label !== "string" || btn.label === "") {
+      errors.push({
+        kind: "intent",
+        phase: "dialog-button-label",
+        path: `${btnPath}.label`,
+        message: `버튼 label 은 비어있지 않은 문자열 필수.`,
+      });
+      continue;
+    }
+    if (btn.event != null && (typeof btn.event !== "string" || btn.event === "")) {
+      errors.push({
+        kind: "intent",
+        phase: "dialog-button-event-format",
+        path: `${btnPath}.event`,
+        message: `버튼 event 는 비어있지 않은 문자열 (scenario.Events 키). 실재성은 [event-ref] cross-check 가 검사.`,
+      });
+      continue;
+    }
+    if (btn.moveType != null && !MOVE_TYPE_ENUM.has(btn.moveType)) {
+      errors.push({
+        kind: "intent",
+        phase: "dialog-button-moveType-enum",
+        path: `${btnPath}.moveType`,
+        message: `버튼 moveType '${btn.moveType}' 미정의 — 허용: ${[...MOVE_TYPE_ENUM].join(" / ")}.`,
+      });
+      continue;
+    }
+    if (btn.color != null && btn.color !== "sub") {
+      errors.push({
+        kind: "intent",
+        phase: "dialog-button-color-enum",
+        path: `${btnPath}.color`,
+        message: `버튼 color 는 'sub' 만 허용 (보조 스타일).`,
+      });
+      continue;
+    }
+
+    const labelStr = jsString(btn.label);
+    const eventArg = btn.event ? jsString(btn.event) : "null";
+    if (btn.moveType) {
+      btnParts.push(`.addButton(MOVETYPE_${btn.moveType.toUpperCase()}, ${labelStr}, ${eventArg})`);
+    } else if (btn.color === "sub") {
+      btnParts.push(`.addBtn(${labelStr}, ${eventArg}, true)`);
+    } else {
+      btnParts.push(`.addBtn(${labelStr}, ${eventArg})`);
+    }
+  }
+  if (errors.length > 0) return { script: "", errors };
+
+  const parts = [`f.MessageBox(${jsString(type)})`, `.setTitle(${jsString(title)})`];
+  if (typeof body === "string" && body !== "") {
+    parts.push(`.setDescription(${jsString(body)})`);
+  }
+  for (const p of btnParts) parts.push(p);
+  parts.push(`.show()`);
+
+  return { script: parts.join(""), errors: [] };
+}

package/contract-data/runtime/v1/intent-system/kinds/reloadGroup.mjs

@@ -0,0 +1,28 @@
+// kinds/reloadGroup.mjs — f.Content(fid).reload()
+//
+// 입력 props: { kind, fid }
+// 출력 script: f.Content('<fid>').reload()
+
+import { FID_RE, jsString } from "./_base.mjs";
+
+export const meta = Object.freeze({
+  name: "reloadGroup",
+  allowedScopes: null,
+  summary: "그룹 부분 재렌더 — f.Content(fid).reload()",
+});
+
+export default function expand(props, scopePath) {
+  const { fid } = props;
+  if (typeof fid !== "string" || !FID_RE.test(fid)) {
+    return {
+      script: "",
+      errors: [{
+        kind: "intent",
+        phase: "reloadGroup-fid-format",
+        path: `${scopePath}.fid`,
+        message: `intent.script(reloadGroup).fid 는 'f_N' 형태 (예: f_3). 받은 값: ${JSON.stringify(fid)}.`,
+      }],
+    };
+  }
+  return { script: `f.Content(${jsString(fid)}).reload()`, errors: [] };
+}