@flextudio/scenario 0.1.0

package/skill/schemas/control/input-text.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/input-text.schema.json",
+  "title": "InputText",
+  "description": "한 줄 텍스트 입력. text/password 모드.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    { "$ref": "_base.schema.json#/$defs/inputBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "InputText" },
+        "InputType": {
+          "type": "string",
+          "enum": ["text", "password"],
+          "description": "text=일반 텍스트 / password=마스킹 입력. (숫자/이메일/전화 등은 InputNumber 또는 InputMask 사용.)"
+        },
+        "Events": { "$ref": "_base.schema.json#/$defs/inputEventsFull" }
+      }
+    }
+  ]
+}

package/skill/schemas/control/label.schema.json

@@ -0,0 +1,113 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/label.schema.json",
+  "title": "Label",
+  "description": "텍스트/아이콘 표시 전용. 입력 없음. labeltext / LabelCKey 두 모드. UseMove / UseClickEvent 로 Group / Button 과 동일한 클릭 패턴 지원.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "Label" },
+        "LabelType": {
+          "type": "string",
+          "enum": ["labeltext", "LabelCKey"],
+          "description": "labeltext=정적 텍스트(+바인딩) / LabelCKey=카테고리 필드값 직접 표시."
+        },
+        "labeltext": {
+          "type": "string",
+          "description": "LabelType='labeltext' 일 때 표시 텍스트. {{i18n}} / {=Field} / {=$Field}(콤마) / {% JS %} 사용 가능. Load.sector 사용 불가."
+        },
+        "LabelCKey": {
+          "type": "string",
+          "description": "LabelType='LabelCKey' 일 때 표시할 컬렉션 필드명."
+        },
+        "ImageStyle": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "아이콘 라벨용 이미지 스타일."
+        },
+        "UseFullShape": { "type": "boolean", "default": false, "description": "라벨 전체 영역 사용 (engine const K.USE_FULLSHAPE='UseFullShape'). ★ AI 생성 시 미포함 (사용자 수동 설정 전용)." },
+        "UseTriming":   { "type": "boolean", "default": false, "description": "텍스트 말줄임 (...) 처리. ★ 오타 'Triming' 운영 키 그대로 — 'Trimming' 아님 (engine const K.USE_TRIMMING='UseTriming'). ★ AI 생성 시 미포함 (사용자 수동 설정 전용)." },
+        "TooltipType": { "type": "string", "description": "툴팁 모드 키 (정적 텍스트 / 카테고리 필드값 등 운영 키 기준). ★ PC 전용 — 모바일 시나리오 생성 시 미포함 (AI 생성 금지, 키 자체를 두지 말 것)." },
+        "TooltipText": { "type": "string", "description": "TooltipType 이 정적 텍스트 모드일 때 표시할 툴팁 문자열. ★ PC 전용 — 모바일 시나리오 생성 시 미포함 (AI 생성 금지, 키 자체를 두지 말 것)." },
+        "TooltipCKey": { "type": "string", "description": "TooltipType 이 카테고리 필드 모드일 때 표시할 컬렉션 필드명. ★ PC 전용 — 모바일 시나리오 생성 시 미포함 (AI 생성 금지, 키 자체를 두지 말 것)." },
+        "UseClickEvent": {
+          "type": "boolean",
+          "default": false,
+          "description": "클릭 이벤트 사용. Events.Click 핸들러 명과 함께. UseMove 와 같이 쓰면 UseMove 가 먼저 동작."
+        },
+        "UseMove": {
+          "type": "boolean",
+          "default": false,
+          "description": "클릭 시 Step 이동. MoveSteps 와 함께."
+        },
+        "MoveSteps": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "이동 대상 Step 정의. UseMove=true 일 때. MoveStepOrder 배열의 각 StepId 마다 동일 레벨에 옵션 객체(MoveTo/Direction 등) 슬롯이 함께 존재해야 한다.",
+          "properties": {
+            "MoveStepOrder": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "type": "string", "pattern": "^Step[1-9][0-9]*$" }
+            }
+          },
+          "patternProperties": {
+            "^Step[1-9][0-9]*$": {
+              "type": "object",
+              "additionalProperties": true,
+              "description": "StepId 별 이동 설정. 신규 생성 시 { MoveTo: 'Next', Direction: 'toRight' } 로 초기화.",
+              "properties": {
+                "Condition": { "type": "string", "description": "이동 조건식 (빈 문자열=무조건)." },
+                "MoveTo": {
+                  "type": "string",
+                  "enum": ["Next", "Prev", "Prev_ReStart", "Init"],
+                  "description": "이동 동작. const.js MOVETYPE 참조."
+                },
+                "Direction": { "type": "string", "description": "MoveTo='Next' 일 때 네비게이션 방향 (예: toBottom, toRight)." }
+              }
+            }
+          }
+        },
+        "Events": { "$ref": "_base.schema.json#/$defs/labelEvents" }
+      }
+    },
+    {
+      "$comment": "LabelType='labeltext' 면 labeltext 필요.",
+      "if": {
+        "properties": { "LabelType": { "const": "labeltext" } },
+        "required": ["LabelType"]
+      },
+      "then": { "required": ["labeltext"] }
+    },
+    {
+      "$comment": "LabelType='LabelCKey' 면 LabelCKey 필요.",
+      "if": {
+        "properties": { "LabelType": { "const": "LabelCKey" } },
+        "required": ["LabelType"]
+      },
+      "then": { "required": ["LabelCKey"] }
+    },
+    {
+      "$comment": "UseMove=true 면 MoveSteps 필요.",
+      "if": {
+        "properties": { "UseMove": { "const": true } },
+        "required": ["UseMove"]
+      },
+      "then": { "required": ["MoveSteps"] }
+    },
+    {
+      "$comment": "PC 전용 툴팁 키는 모바일 시나리오 메타에 등장 금지 — 키 존재 자체 차단 (명세는 properties 에 유지하되 옵션 차원 강제).",
+      "not": {
+        "anyOf": [
+          { "required": ["TooltipType"] },
+          { "required": ["TooltipText"] },
+          { "required": ["TooltipCKey"] }
+        ]
+      }
+    }
+  ]
+}

package/skill/schemas/control/multi-input-box.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/multi-input-box.schema.json",
+  "title": "MultiInputBox",
+  "description": "여러 줄 텍스트 입력 (TextArea). Enter 로 줄바꿈. Shared Input Base 사용 — Height 기본 120px (다른 입력은 70px).",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    { "$ref": "_base.schema.json#/$defs/inputBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "MultiInputBox" },
+        "Events":      { "$ref": "_base.schema.json#/$defs/inputEventsFull" }
+      }
+    }
+  ]
+}

package/skill/schemas/control/other.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/other.schema.json",
+  "title": "OtherControl",
+  "description": "v1 명시 외 ControlType (InputBox, Sheet, TimeTable, Approval, Scheduler, Image, ComboList 단독, List 단독, Signature, Line 등) — 검증 통과시키는 fallback. 상세 schema 는 v2 에서 정의. Button/Calendar/CalendarNavigator/Tab/Tree/Embed 는 자체 schema 분기로 빠짐.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "properties": {
+    "Id": { "type": "string", "pattern": "^f_[1-9][0-9]*$" },
+    "ControlType": {
+      "type": "string",
+      "not": {
+        "enum": [
+          "InputText", "InputNumber", "InputMask", "InputDate",
+          "MultiInputBox", "Combo", "Search", "CheckBox", "RadioBox",
+          "Label", "ImageBox", "InputFile", "Button",
+          "Calendar", "CalendarNavigator", "Tab",
+          "Tree", "Embed"
+        ]
+      }
+    }
+  }
+}

package/skill/schemas/control/radio-box.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/radio-box.schema.json",
+  "title": "RadioBox",
+  "description": "라디오 그룹. Fixed Items 또는 DataSource 두 가지 데이터 소스. styleTab 으로 탭 형태 UI 도 가능. UseDataSource 미지정 시 런타임 default=false (Fixed 모드).",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "RadioBox" },
+        "ControlStyle": {
+          "type": "string",
+          "enum": ["", "None", "styleRectangle", "styleTab", "stylePeriod", "styleRadius"],
+          "description": "'None'=기본 라디오 / 'styleRectangle'=사각 카드 (UseItemDesign 과 함께) / 'styleTab'=탭 형태 / 'stylePeriod'=기간 선택형 / 'styleRadius'=라운드."
+        },
+        "Items": {
+          "type": "array",
+          "items": { "$ref": "_base.schema.json#/$defs/selectionItem" },
+          "description": "Fixed 모드 (UseDataSource=false 또는 생략) 일 때 인라인 선택지."
+        },
+        "SaveNameKey":     { "type": "string", "description": "Ckeys 중 표시명 저장 필드. **Fixed 모드(UseDataSource=false 또는 생략) 전용** — DataSource 모드에서는 CollectionMapper 로 매핑하므로 본 키를 사용하지 않는다 (if/then 으로 차단)." },
+        "SaveNameName":    { "type": "string", "description": "표시명 저장 시 사용할 별칭. **Fixed 모드 전용** (UseDataSource=true 시 사용 금지)." },
+        "SaveValueKey":    { "type": "string", "description": "Ckeys 중 값 저장 필드." },
+        "DefaultValue":    { "type": "string", "description": "초기 선택값 — **표시명(RadioBoxItem명) 기준** 문자열. Fixed 모드면 Items[*].ItemName 과 매칭, DataSource 모드면 CollectionMapper 의 ItemName 매핑 대상 필드 값과 매칭. ItemValue 가 아님에 유의. 빈 문자열 \"\" 도 가능." },
+        "UseDefaultValue": false,
+        "Direction":       { "type": "string", "examples": ["horizontal", "vertical", "row", "column"], "description": "선택지 배치 방향." },
+        "UseDataSource": {
+          "type": "boolean",
+          "default": false,
+          "description": "true=DataSource 사용 (DataSourceName 필수), false=Fixed Items. 런타임 default=false. ★ 프로퍼티 EDITOR_CTRL.RADIOBOX boolean 저장 — 진실원본 boolean."
+        },
+        "DataSourceName":  { "type": "string", "description": "UseDataSource=true 일 때 데이터 소스 이름." },
+        "CollectionMapper": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "DataSource 사용 시 { 대상Ckey: 원본필드, ItemName: ..., ItemValue: ... } 매핑."
+        },
+        "UseCategory":     { "type": "boolean", "default": false },
+        "CategoryName":    { "type": "string" },
+        "UseItemDesign":   { "type": "boolean", "default": false, "description": "true=ItemDesign 으로 항목별 커스텀 디자인 적용 (styleRectangle 과 함께)." },
+        "ItemDesign":      { "type": "object", "additionalProperties": true },
+        "ItemBgStyle":     { "type": "object", "additionalProperties": true },
+        "UseAlignRight":   { "type": "boolean", "default": false },
+        "AfterScript":     { "type": "string" },
+        "UniqueKey":       { "type": "string" },
+        "Events":          { "$ref": "_base.schema.json#/$defs/directClickEvents" }
+      }
+    },
+    {
+      "$comment": "UseDataSource=true 면 DataSourceName + CollectionMapper 필수 — 콜렉션 ↔ DataSource 필드 매핑이 있어야 데이터 연결관계가 성립.",
+      "if": {
+        "properties": { "UseDataSource": { "const": true } },
+        "required": ["UseDataSource"]
+      },
+      "then": {
+        "required": ["DataSourceName", "CollectionMapper"],
+        "properties": {
+          "CollectionMapper": { "minProperties": 1 }
+        }
+      }
+    },
+    {
+      "$comment": "UseItemDesign=true 면 ItemDesign 필수.",
+      "if": {
+        "properties": { "UseItemDesign": { "const": true } },
+        "required": ["UseItemDesign"]
+      },
+      "then": { "required": ["ItemDesign"] }
+    },
+    {
+      "$comment": "UseDataSource=true (DataSource 모드) 일 때 SaveNameKey / SaveNameName 사용 금지 — Fixed 모드 전용 키. DataSource 모드의 표시명은 CollectionMapper 로 매핑.",
+      "if": {
+        "properties": { "UseDataSource": { "const": true } },
+        "required": ["UseDataSource"]
+      },
+      "then": {
+        "properties": {
+          "SaveNameKey": false,
+          "SaveNameName": false
+        }
+      }
+    }
+  ]
+}

package/skill/schemas/control/search.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/search.schema.json",
+  "title": "Search",
+  "description": "Code Help / Lookup. 자식 트리 보유 (Dialog.Layouts[*].Controls[*] = List). 항목이 8개를 초과하거나 동적으로 늘어나는 데이터 (고객/사용자/거래처 등) 에 사용. DataSource=Collection/Service 면 Search, Fixed 면 Combo.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    { "$ref": "_base.schema.json#/$defs/inputBase" },
+    {
+      "properties": {
+        "ControlType":  { "const": "Search" },
+        "DisplayValue": {
+          "type": "string",
+          "description": "선택 후 표시 텍스트. 일반적으로 '{{=CkeyName}}' 형식 (현재 섹터의 Ckey 값 표시)."
+        },
+        "Dialog": { "$ref": "_base.schema.json#/$defs/searchDialog" }
+      }
+    }
+  ]
+}

package/skill/schemas/control/tab.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/tab.schema.json",
+  "title": "Tab",
+  "description": "탭 컨트롤. 각 Items[].LinkedStepId 로 다른 Step 의 전체 UI 를 탭 내부에 렌더링한다. (탭마다 화면 전체가 바뀌는 경우 전용. 같은 리스트의 필터만 바뀌는 케이스는 RadioBox + ControlStyle:'styleTab' 권장.) Height 는 반드시 100% — 헤더 높이만 주면 LinkedStep 콘텐츠가 표시되지 않는다. Items[].LinkedStepId 가 자기 자신 Step 을 가리키면 무한 재귀. 핵심 제약: '탭 컨트롤은 일반 스텝에서 제공하는 기능이 적용되지 않는다 → 스텝버튼이 그려지지 않고 스텝 이벤트(Init/Loaded/OnBackLoaded/OnLeave/OnForeground/ScrollEnd)가 실행되지 않으며 서브시나리오 스텝은 표시할 수 없다.'",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "Tab" },
+        "ControlStyle": {
+          "type": "string",
+          "examples": ["", "None"],
+          "description": "기본 'None'."
+        },
+
+        "Height": {
+          "$ref": "../style-objects.schema.json#/$defs/sizeObject",
+          "description": "반드시 100% — `{ SizeValue: '100', SizeUnit: '%', MatchText: false }`. 고정 px 면 탭 헤더만 보이고 LinkedStep 콘텐츠가 잘림. (validate.mjs 후검증으로도 강제.)"
+        },
+
+        "DefaultValue": {
+          "type": "string",
+          "default": "",
+          "description": "초기 선택 탭의 값. Items[].ItemValue 와 일치하는 항목이 시작 시 선택 상태로 그려진다. 빈 문자열/미지정 시 첫 번째 Items 항목이 선택. ★ 초기 선택으로 LinkedStep 이 렌더되더라도 그 Step 의 Step 이벤트(Init/Loaded/OnBackLoaded/OnLeave/OnForeground/ScrollEnd)는 실행되지 않음 — Tab 컨트롤의 일반 제약(공식 가이드). 따라서 초기 데이터 로딩은 부모 Step(Tab 이 있는 Step) 의 Init 에서 처리하고, 탭 전환 시 동작이 필요하면 Items[].Events.Click 에 둔다. controlBase.DefaultValue 의 any 타입을 Tab 에서 string 으로 좁힘 (ItemValue 가 항상 string)."
+        },
+        "Items": {
+          "type": "array",
+          "minItems": 1,
+          "description": "탭 항목 배열. 각 항목이 하나의 탭 헤더 + 연결된 Step.",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["ItemName", "ItemValue", "LinkedStepId"],
+            "properties": {
+              "ItemName":     { "type": "string", "description": "탭 헤더 표시 텍스트. 필요시 `{{}}` 다국어." },
+              "ItemValue":    { "type": "string", "description": "선택 시 Ckeys 에 저장되는 값." },
+              "LinkedStepId": { "type": "string", "pattern": "^Step[1-9][0-9]*$", "description": "이 탭이 선택되었을 때 내부에 렌더할 Step Id. 자기 자신 Step 금지 (무한 재귀)." },
+              "Events": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "탭 항목 단위 이벤트. Click 핸들러 1종.",
+                "properties": {
+                  "Click": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+
+        "Ckeys": {
+          "$ref": "../naming-objects.schema.json#/$defs/ckeysArray",
+          "description": "선택된 탭의 ItemValue 가 저장될 컬렉션 키 (선택). 시스템 게터 / JS 빌트인 차단."
+        },
+
+        "TabHeader": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "탭 헤더 전체 영역(아이템들을 감싸는 컨테이너) 디자인. 정렬·여백·테두리·배경.",
+          "properties": {
+            "ArrangeItemsStyle": { "$ref": "../style-objects.schema.json#/$defs/arrangeItemsStyle" },
+            "Padding":           { "$ref": "../style-objects.schema.json#/$defs/spacing" },
+            "Margin":            { "$ref": "../style-objects.schema.json#/$defs/spacing" },
+            "BorderStyle":       { "$ref": "../style-objects.schema.json#/$defs/borderStyle" },
+            "BgStyle":           { "$ref": "../style-objects.schema.json#/$defs/bgStyle" }
+          }
+        },
+        "SelectTabHeader": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "선택 상태의 탭 헤더 컨테이너 디자인. TabHeader 와 동일 슬롯. 보통 비워두고 SelectTabHeaderItem 으로 항목별 강조를 처리.",
+          "properties": {
+            "ArrangeItemsStyle": { "$ref": "../style-objects.schema.json#/$defs/arrangeItemsStyle" },
+            "Padding":           { "$ref": "../style-objects.schema.json#/$defs/spacing" },
+            "Margin":            { "$ref": "../style-objects.schema.json#/$defs/spacing" },
+            "BorderStyle":       { "$ref": "../style-objects.schema.json#/$defs/borderStyle" },
+            "BgStyle":           { "$ref": "../style-objects.schema.json#/$defs/bgStyle" }
+          }
+        },
+        "TabHeaderItem": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "각 탭 항목 헤더(미선택 상태) 디자인. 폰트·여백·테두리·배경.",
+          "properties": {
+            "FontStyle":   { "$ref": "../style-objects.schema.json#/$defs/fontStyle" },
+            "Padding":     { "$ref": "../style-objects.schema.json#/$defs/spacing" },
+            "Margin":      { "$ref": "../style-objects.schema.json#/$defs/spacing" },
+            "BorderStyle": { "$ref": "../style-objects.schema.json#/$defs/borderStyle" },
+            "BgStyle":     { "$ref": "../style-objects.schema.json#/$defs/bgStyle" }
+          }
+        },
+        "SelectTabHeaderItem": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "선택된 탭 항목 헤더 디자인. 보통 FontStyle / BgStyle / BorderStyle 만 사용 (선택 강조). Padding/Margin 은 TabHeaderItem 값을 그대로 상속.",
+          "properties": {
+            "FontStyle":   { "$ref": "../style-objects.schema.json#/$defs/fontStyle" },
+            "BgStyle":     { "$ref": "../style-objects.schema.json#/$defs/bgStyle" },
+            "BorderStyle": { "$ref": "../style-objects.schema.json#/$defs/borderStyle" },
+            "Padding":     { "$ref": "../style-objects.schema.json#/$defs/spacing" },
+            "Margin":      { "$ref": "../style-objects.schema.json#/$defs/spacing" }
+          }
+        },
+        "ArrangeItems": { "type": "string", "description": "(레거시) 탭 헤더 정렬/배치 옵션 — 운영 메타 잔존 호환. 신규 생성은 TabHeader.ArrangeItemsStyle 사용." }
+      },
+      "required": ["Items"]
+    }
+  ]
+}

package/skill/schemas/control/tree.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/tree.schema.json",
+  "title": "Tree",
+  "description": "계층형(부모-자식) 데이터를 트리 구조로 표시. NodeId/ParentId 로 flat array 의 트리 관계 표현. 단일 선택(Selected) 과 다중 선택(UseMultiData=true → Checked 체크박스) 모드.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "Tree" },
+
+        "DataSourceName": { "type": "string", "description": "트리 데이터 DataSource 이름. Fixed/Collection/Service/API 모두 가능. 필수." },
+
+        "NodeId":   { "type": "string", "description": "각 노드 고유 ID 필드명 (DataSource Items 의 키 이름)." },
+        "ParentId": { "type": "string", "description": "부모 노드 ID 필드명. 루트는 ''/null/undefined 또는 자기참조(parentId===nodeId)." },
+        "Title":    { "type": "string", "description": "노드 표시 텍스트 필드명." },
+        "SubTitle": { "type": "string", "description": "(선택) 노드 부제목 필드명. Title 아래 한 줄 더." },
+
+        "ThumbNail": { "type": "string", "description": "(선택) 노드 썸네일 이미지 필드명. row 의 해당 필드값이 URL/경로면 `<img class=\"img-thumbnail\">` 렌더. 키 표기 'ThumbNail' (camelCase 'Thumbnail' 아님) — engine const K_THUMBNAIL='ThumbNail'." },
+        "Icon":      { "type": "string", "description": "(선택) 노드 좌측 아이콘 필드명. row 의 해당 필드값 형식에 따라 분기: `B_xxx`=라인 아이콘(SVG mask) / `C_xxx`=컬러 아이콘(/imagesCommon/icon/C_xxx.svg) / 'icon' 포함 문자열=라인 아이콘 / URL=이미지." },
+        "SubIcon":   { "type": "string", "description": "(선택) 노드 우측 보조 아이콘 필드명. Icon 과 동일 형식 분기. 렌더 클래스만 'icon-sub' 로 차이 — engine const K_SUB_ICON='SubIcon'." },
+
+        "UseExpandAll":        { "type": "boolean", "default": false, "description": "초기 전체 펼침." },
+        "UseSearchBar":        { "type": "boolean", "default": false, "description": "검색바 표시 — 키워드 포함 노드 조회." },
+        "UseMultiData":        { "type": "boolean", "default": false, "description": "다중 선택 모드 (체크박스). true 면 Checked 이벤트 사용 가능. ★ 프로퍼티 EDITOR_CTRL.CHECKBOX 저장 — boolean 고정." },
+        "UseSelectAllData":    { "type": "boolean", "default": false, "description": "다중 선택 모드의 '전체선택' 체크박스 표시 (UseMultiData=true 일 때)." },
+        "UseParentAutoSelect": { "type": "boolean", "default": true,  "description": "자식 노드 전체 체크 시 부모 자동 체크 (UseMultiData=true 일 때). 기본 true." },
+        "UseCondition":        { "type": "boolean", "default": false },
+
+        "TreeType": {
+          "type": "string",
+          "enum": ["Single", "UseMultiData"],
+          "description": "런타임 분류값 (engine const TREE_TYPE). 'Single'=단일 / 'UseMultiData'=다중. 일반적으로 UseMultiData boolean 으로 충분 — 운영 메타에는 명시 안 됨."
+        },
+
+        "CategoryName": {
+          "type": "string",
+          "description": "다중 선택 (UseMultiData=true) 모드에서 체크된 노드가 저장되는 카테고리. 체크 → addSector / 해제 → remove."
+        },
+
+        "CollectionMapper": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "minProperties": 1,
+          "description": "{ MapperOrder: [...], 대상Ckey: 원본필드, ... } 매핑. 단일 선택 시 activeSector 에 매핑, 다중 선택 시 CategoryName 의 섹터에 매핑. Tree 는 항상 DataSource 기반이므로 콜렉션 ↔ DataSource 필드 매핑 필수 (빈 객체 금지). ★ additionalProperties 는 자유 매핑키(값=원본필드명, string)이므로 {type:string} — true 로 두면 strict 변환이 unevaluatedProperties:false 로 뒤집어 매핑키를 오탐 차단한다 (MapperOrder 는 properties 라 array 허용).",
+          "properties": {
+            "MapperOrder": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+
+        "UseEvents": {
+          "type": "boolean",
+          "default": false,
+          "description": "이벤트 사용. true 면 Events.TreeOrder + 핸들러 등록."
+        },
+        "Events": { "$ref": "_base.schema.json#/$defs/treeEvents" },
+
+        "UseDCLink":  { "type": "boolean", "default": false, "description": "데이터 연결고리 사용. ★ AI 생성 시 미포함 — 운영 메타 잔존 필드 (UseMultiData=true + 상위 DataConnection 활성 조합에서만 스튜디오 UI 노출). useDCLinkBlock 정책 동일." },
+        "DCLinkCkey": { "$ref": "_base.schema.json#/$defs/useDCLinkBlock/properties/DCLinkCkey" }
+      },
+      "required": ["DataSourceName", "NodeId", "ParentId", "Title", "CollectionMapper"]
+    },
+    {
+      "$comment": "UseMultiData=true → CategoryName 권장 (체크된 노드가 저장될 위치). 운영 메타에 종종 누락 — 후검증/가이드 차원으로 두고 schema 강제는 안 함.",
+      "if": {
+        "properties": { "UseMultiData": { "const": true } },
+        "required": ["UseMultiData"]
+      },
+      "then": {}
+    },
+    {
+      "$comment": "UseDCLink=true 면 DCLinkCkey 필수 (useDCLinkBlock 정책).",
+      "if": {
+        "properties": { "UseDCLink": { "const": true } },
+        "required": ["UseDCLink"]
+      },
+      "then": { "required": ["DCLinkCkey"] }
+    }
+  ]
+}

package/skill/schemas/control.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control.schema.json",
+  "title": "Control (dispatcher)",
+  "description": "Control 디스패처. ControlType discriminator 로 control/<name>.schema.json 분기. v1 명시 본체 17종(입력류 12 + Calendar/CalendarNavigator/Tab/Tree/Embed) + Dialog 자식 ComboList/List + OtherControl fallback. 진실원본: catalog.controlTypes.",
+  "type": "object",
+  "required": ["Id", "ControlType"],
+  "additionalProperties": true,
+  "oneOf": [
+    { "$ref": "control/input-text.schema.json" },
+    { "$ref": "control/input-number.schema.json" },
+    { "$ref": "control/input-mask.schema.json" },
+    { "$ref": "control/input-date.schema.json" },
+    { "$ref": "control/multi-input-box.schema.json" },
+    { "$ref": "control/combo.schema.json" },
+    { "$ref": "control/search.schema.json" },
+    { "$ref": "control/check-box.schema.json" },
+    { "$ref": "control/radio-box.schema.json" },
+    { "$ref": "control/label.schema.json" },
+    { "$ref": "control/image-box.schema.json" },
+    { "$ref": "control/input-file.schema.json" },
+    { "$ref": "control/button.schema.json" },
+    { "$ref": "control/calendar.schema.json" },
+    { "$ref": "control/calendar-navigator.schema.json" },
+    { "$ref": "control/tab.schema.json" },
+    { "$ref": "control/tree.schema.json" },
+    { "$ref": "control/embed.schema.json" },
+    { "$ref": "control/other.schema.json" }
+  ]
+}