@flextudio/scenario 0.1.0

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

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/button.schema.json",
+  "title": "Button",
+  "description": "액션 트리거 전용 컨트롤. 입력 없음. ButtonName(텍스트) + ImageStyle(아이콘) 단독 또는 조합. UseClickEvent 로 Events.Click 핸들러만 지원. ButtonValueCKey + ButtonValue 로 클릭 시 카테고리 필드에 값 저장 가능. Step 이동 미지원 — Label.UseMove 또는 BottomButton 사용.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "Button" },
+        "ButtonName": {
+          "type": "string",
+          "description": "버튼에 표시할 텍스트. 빈 문자열 가능 (아이콘 전용 버튼). `{{i18n}}` / `{=Field}` / `{=$Field}`(콤마) / `{% JS %}` 사용 가능. Load.sector 사용 불가."
+        },
+        "ButtonValueCKey": {
+          "type": "string",
+          "default": "",
+          "description": "클릭 시 값을 저장할 카테고리 필드명 (ckey 바인딩). 빈 문자열=저장 안 함. ButtonValue 와 함께 사용 — 클릭하면 이 ckey 에 ButtonValue 가 set. 사용 시 상위 Group 계층에 UseDataConnection + DataConnection 필요 (다른 ckey 바인딩 컨트롤과 동일)."
+        },
+        "ButtonValue": {
+          "type": "string",
+          "default": "",
+          "description": "클릭 시 ButtonValueCKey 에 저장할 값. 문자열. ButtonValueCKey 가 비어 있으면 의미 없음. 정적 값만 — 표현식/바인딩 미지원."
+        },
+        "ImageStyle": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "아이콘 버튼용 이미지 스타일. ButtonName='' 와 조합 시 아이콘 전용, ButtonName 과 함께 두면 아이콘+텍스트 버튼."
+        },
+        "UseClickEvent": {
+          "type": "boolean",
+          "default": false,
+          "description": "클릭 이벤트 사용. true 일 때 Events.Click 핸들러 명 필수."
+        },
+        "Events": { "$ref": "_base.schema.json#/$defs/buttonEvents" }
+      }
+    },
+    {
+      "$comment": "UseClickEvent=true 면 Events.Click 필요.",
+      "if": {
+        "properties": { "UseClickEvent": { "const": true } },
+        "required": ["UseClickEvent"]
+      },
+      "then": {
+        "required": ["Events"],
+        "properties": {
+          "Events": { "required": ["Click"] }
+        }
+      }
+    }
+  ]
+}

package/skill/schemas/control/calendar-navigator.schema.json

@@ -0,0 +1,164 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/calendar-navigator.schema.json",
+  "title": "CalendarNavigator",
+  "description": "캘린더 네비게이터. 월/주/일 단위로 날짜 범위를 이동·선택. (1) TimeTable 내부 자식 (UseTimeTable=true), (2) 독립 컨트롤 (UseTimeTable=false) 두 가지 사용 형태. 독립 사용 시 래퍼 Group 에 UseDataConnection:true 필수. Events / DayArea / DaySetting / SelectDay / UseEvents 는 빈 객체/기본값이라도 반드시 존재해야 한다 (런타임 규약).",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "CalendarNavigator" },
+        "ControlStyle": {
+          "type": "string",
+          "enum": ["", "None", "StyleBack", "StyleHalf", "StyleAlignLeft"],
+          "description": "공식 4종. ''/'None'=기본 / 'StyleBack'=뒤 배경형 / 'StyleHalf'=절반 표시 / 'StyleAlignLeft'=좌측 정렬."
+        },
+
+        "NavigatorType": {
+          "type": "string",
+          "enum": ["Month", "WeekPeriod", "Day"],
+          "description": "공식 3종 — Month=월 단위 / WeekPeriod=주 단위 / Day=일 단위. (운영 메타에 'Custom' 이 있을 수 있으나 AI 생성에서는 사용 금지 — 공식 가이드 미표기.)"
+        },
+        "NavigatorDateFormat": {
+          "type": "string",
+          "enum": [
+            "",
+            "YYYY.MM.DD", "YYYY/MM/DD", "YYYY-MM-DD", "YYYY년MM월DD일",
+            "YYYY-MM-W",
+            "YYYY.MM", "YYYY/MM", "YYYY-MM", "YYYY년MM월",
+            "YYYY년"
+          ],
+          "description": "헤더 날짜 표시 포맷 (공식 10종). 'YYYY-MM-W' 는 NavigatorType='WeekPeriod' (주 단위) 전용. ''=런타임 기본."
+        },
+
+        "UseDaySelector": {
+          "type": "boolean",
+          "default": false,
+          "description": "true=주간 날짜 선택 바 표시 (스와이프 지원). **boolean strict** — true/false 만. 문자열 \"true\"/\"false\" 금지 (JS truthy 함정). 이 값에 따라 바인딩 키가 갈림 — true → SingleDate.Ckeys, false → StartDate.Ckeys + EndDate.Ckeys (studio-panel-cat.js 진실원본)."
+        },
+        "UseTimeTable": {
+          "type": "boolean",
+          "default": false,
+          "description": "true=TimeTable 내부에 종속. false=독립 컨트롤로 사용."
+        },
+        "UseDataConnection": { "type": "boolean", "default": false },
+        "UseDaySetting":     { "type": "boolean", "default": false },
+        "UseDayArea":        { "type": "boolean", "default": false },
+
+        "SingleDate": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Day 모드 또는 UseDaySelector=true 일 때 단일 날짜 바인딩.",
+          "properties": {
+            "Ckeys": { "$ref": "../naming-objects.schema.json#/$defs/ckeysArray" }
+          }
+        },
+        "StartDate": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "WeekPeriod / Month 모드에서 기간 시작일 바인딩.",
+          "properties": {
+            "Ckeys": { "$ref": "../naming-objects.schema.json#/$defs/ckeysArray" }
+          }
+        },
+        "EndDate": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "WeekPeriod / Month 모드에서 기간 종료일 바인딩.",
+          "properties": {
+            "Ckeys": { "$ref": "../naming-objects.schema.json#/$defs/ckeysArray" }
+          }
+        },
+
+        "DayArea":    { "type": "object", "default": {}, "additionalProperties": true, "description": "필수(빈 객체 허용). 일자별 영역 표시 정의." },
+        "DaySetting": { "type": "object", "default": {}, "additionalProperties": true, "description": "필수(빈 객체 허용). 일자별 부가 설정." },
+        "SelectDay":  { "type": "object", "default": {}, "additionalProperties": true, "description": "필수(빈 객체 허용). 선택 일자 디자인." },
+
+        "DayDsKey":   { "type": "string", "description": "DayArea/DaySetting 의 DataSource 키 (선택)." },
+        "TypeDsKey":  { "type": "string", "description": "Day 타입 분류용 DataSource 키 (선택)." },
+
+        "UseEvents": { "type": "boolean", "default": false, "description": "필수(false 라도 키 존재). Events 핸들러 사용 여부." },
+        "Events": {
+          "type": "object",
+          "default": {},
+          "additionalProperties": true,
+          "description": "필수(빈 객체라도). CalendarNaviEventsOrder 로 등록.",
+          "properties": {
+            "CalendarNaviEventsOrder": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["ClickPrevNextBtn", "OnChangeSwipe", "SelectDay"]
+              }
+            },
+            "ClickPrevNextBtn": { "type": "string", "description": "이전/다음 버튼 클릭." },
+            "OnChangeSwipe":    { "type": "string", "description": "DaySelector 스와이프로 주 변경." },
+            "SelectDay":        { "type": "string", "description": "DaySelector 에서 날짜 클릭." }
+          },
+          "allOf": [
+            { "if": { "properties": { "CalendarNaviEventsOrder": { "type": "array", "contains": { "const": "ClickPrevNextBtn" } } }, "required": ["CalendarNaviEventsOrder"] }, "then": { "required": ["ClickPrevNextBtn"] } },
+            { "if": { "properties": { "CalendarNaviEventsOrder": { "type": "array", "contains": { "const": "OnChangeSwipe"    } } }, "required": ["CalendarNaviEventsOrder"] }, "then": { "required": ["OnChangeSwipe"]    } },
+            { "if": { "properties": { "CalendarNaviEventsOrder": { "type": "array", "contains": { "const": "SelectDay"        } } }, "required": ["CalendarNaviEventsOrder"] }, "then": { "required": ["SelectDay"]        } }
+          ]
+        }
+      },
+      "required": ["DayArea", "DaySetting", "SelectDay", "Events", "UseEvents"]
+    },
+    {
+      "$comment": "NavigatorType='Day' 또는 UseDaySelector=true → SingleDate 권장(검증은 후검증). NavigatorType='WeekPeriod'|'Month' → StartDate + EndDate 필수, 각각의 Ckeys (1개 이상) 도 필수. 런타임이 dlgJson.StartDate.Ckeys / dlgJson.EndDate.Ckeys 로 직접 접근하므로 빈 객체 {} 는 TypeError.",
+      "if": {
+        "properties": { "NavigatorType": { "enum": ["WeekPeriod", "Month"] } },
+        "required": ["NavigatorType"]
+      },
+      "then": {
+        "required": ["StartDate", "EndDate"],
+        "properties": {
+          "StartDate": {
+            "required": ["Ckeys"],
+            "properties": {
+              "Ckeys": { "minItems": 1 }
+            }
+          },
+          "EndDate": {
+            "required": ["Ckeys"],
+            "properties": {
+              "Ckeys": { "minItems": 1 }
+            }
+          }
+        }
+      }
+    },
+    {
+      "$comment": "NavigatorType='Day' 면 SingleDate + SingleDate.Ckeys (1개 이상) 필수. 런타임이 dlgJson.SingleDate.Ckeys 로 직접 접근.",
+      "if": {
+        "properties": { "NavigatorType": { "const": "Day" } },
+        "required": ["NavigatorType"]
+      },
+      "then": {
+        "required": ["SingleDate"],
+        "properties": {
+          "SingleDate": {
+            "required": ["Ckeys"],
+            "properties": {
+              "Ckeys": { "minItems": 1 }
+            }
+          }
+        }
+      }
+    },
+    {
+      "$comment": "NavigatorDateFormat='YYYY-MM-W' 는 NavigatorType='WeekPeriod' 전용 (공식 가이드).",
+      "if": {
+        "properties": { "NavigatorDateFormat": { "const": "YYYY-MM-W" } },
+        "required": ["NavigatorDateFormat"]
+      },
+      "then": {
+        "properties": { "NavigatorType": { "const": "WeekPeriod" } },
+        "required": ["NavigatorType"]
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/calendar.schema.json",
+  "title": "Calendar",
+  "description": "캘린더 (날짜 선택). 일반적으로 InputDate.Dialog.Layouts[*].Controls[*] 위치에 자식으로 배치되며, 단독 컨트롤로도 사용 가능. CalendarType / SelectType 으로 일·월·년 picker 와 단일·기간 모드를 분기. 정의 본체는 _base.schema.json#/$defs/calendarControl 을 그대로 차용한다.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    { "$ref": "_base.schema.json#/$defs/calendarControl" },
+    {
+      "properties": {
+        "ControlType": { "const": "Calendar" }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/check-box.schema.json",
+  "title": "CheckBox",
+  "description": "체크박스. Items[] 로 다중 항목 / 단일 toggle 모두 지원. 옆 텍스트는 Items[].ItemName.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "CheckBox" },
+        "ControlStyle": {
+          "type": "string",
+          "enum": ["", "None", "styleSquare", "styleCircle", "styleCircleGray", "styleSwitch", "styleSwitchSmall", "styleIconHeart", "styleRadius"],
+          "description": "권장 스타일. 빈 문자열/'None'=기본 사각, 'styleSquare'/'styleCircle'/'styleCircleGray'=모양 변종, 'styleSwitch'=토글 스위치, 'styleSwitchSmall'=소형 토글 스위치 (switch atom 의 표준), 'styleIconHeart'=아이콘 하트."
+        },
+        "Items": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "_base.schema.json#/$defs/selectionItem" },
+          "description": "체크박스 항목 배열. ItemName=옆 텍스트, ItemValue=체크 시 값, ItemValueDel=해제 시 값(기본 '')."
+        },
+        "DefaultValue": {
+          "type": "boolean",
+          "default": false,
+          "description": "체크 상태 초기값. **boolean strict** — true=체크됨, false=해제됨. **기본값 false**. ★ 문자열 \"true\"/\"false\" 금지 — JS truthy 함정으로 런타임 오동작 (isColumnCtrl 과 동일). controlBase.DefaultValue 의 any 타입을 boolean 으로 제약."
+        },
+        "SaveValueKey": { "type": "string", "description": "Ckeys 중 저장 대상 필드명." },
+        "CheckBoxType": { "type": "string", "examples": ["Default", "Single", "Multi"] },
+        "UseAlignRight":{ "type": "boolean", "default": false, "description": "true=텍스트 우측 정렬 (체크박스가 좌측)." },
+        "UseTriming":   { "type": "boolean", "default": false },
+        "UseCondition": { "type": "boolean", "default": false },
+        "ItemBgStyle":  { "type": "object", "additionalProperties": true },
+        "Events":       { "$ref": "_base.schema.json#/$defs/checkBoxEvents" }
+      },
+      "required": ["Items"]
+    }
+  ]
+}

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

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/combo.schema.json",
+  "title": "Combo",
+  "description": "드롭다운 선택. 자식 트리 보유 (Dialog.Layouts[*].Controls[*] = ComboList). 8개 이하 고정 목록 전용 — 그 외는 Search 사용.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    { "$ref": "_base.schema.json#/$defs/inputBase" },
+    {
+      "properties": {
+        "ControlType":    { "const": "Combo" },
+        "DataSourceName": {
+          "type": "string",
+          "description": "Service/Collection DataSource 사용 시 데이터 소스 이름. Combo 본체와 ComboList 양쪽에 동일하게 둘 수 있음."
+        },
+        "Dialog": { "$ref": "_base.schema.json#/$defs/comboDialog" }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/embed.schema.json",
+  "title": "Embed",
+  "description": "HTML 태그를 직접 화면에 삽입하는 컨트롤. Embed 속성에 raw HTML 문자열을 두면 그대로 렌더된다. 외부 라이브러리(Chart/지도/QR 등) 연동 시 유니크한 id 의 <div>/<canvas> 를 두고 외부 라이브러리 URL 은 Scenario.StyleURLs 배열에 등록(권장 — 진입 시 자동 로드; 동적 URL 등 부득이한 경우만 f.Script.load() 사용). ★ 로드 ≠ 렌더([embed-render]): 라이브러리 로드만으로는 안 그려진다 — canvas/빈 컨테이너 Embed 는 반드시 host Step 의 Loaded 핸들러에서 document.getElementById() 로 DOM 을 잡아 new Chart()/new naver.maps.Map() 등 렌더 코드를 직접 실행해야 한다. ★ Tab 컨트롤 내부 LinkedStep 에는 Embed 금지([tab-embed]) — 탭 내부 Step 은 Step 이벤트가 미실행이라 초기화 시점을 못 잡음. ★ Caption 은 반드시 빈 문자열 (Embed 본체에 표시되므로 ControlDefaultName 같은 내부명을 두면 그대로 출력됨).",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType", "Embed"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "Embed" },
+        "Caption": {
+          "type": "string",
+          "const": "",
+          "description": "★ 반드시 빈 문자열 — Embed 는 화면에 직접 그려지므로 Caption 값이 그대로 노출된다."
+        },
+        "Embed": {
+          "type": "string",
+          "description": "삽입할 raw HTML 문자열. <video>/<iframe>/<canvas>/<div>/<style> 등. ★ <script></script> 직접 삽입 불가 — 외부 라이브러리 URL 은 Scenario.StyleURLs 배열에 등록(권장). ★ 섹터 값 바인딩은 {%return Load.sector.Field; %} (LoadScript 토큰) — {=Field} 는 Embed 안에서 치환되지 않고 그대로 노출됨([embed-bind] 차단). Load.sector 는 조상 DC 그룹(UseDataConnection:true) 아래에서만 그 행의 섹터를 가리킴 — DC 밖이면 조용히 빈 문자열([embed-bind] 차단). 외부 라이브러리 연동 시 div/canvas 에 유니크한 id 부여 → Step Loaded 에서 document.getElementById() 로 DOM 잡고 라이브러리 호출."
+        },
+        "LoadScript": {
+          "type": "string",
+          "description": "(선택) 컴포넌트 로드 직전 스크립트. DOM 접근은 Step Loaded 에서 처리하는 게 일반적이라 통상 미사용."
+        }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/image-box.schema.json",
+  "title": "ImageBox",
+  "description": "이미지 표시/업로드 컨트롤. ImageBoxType=View → ViewGroup 으로 이미지 표시. ImageBoxType=Edit → ViewGroup(=업로드 placeholder) + EditGroup(FlexFile 저장) 둘 다 권장. Edit 업로드 → 파일키가 EditGroup.FlexKey.ckey 컬렉션 필드에 저장 → View 에서 ImageSrcType='FlexFile' + 동일 FlexKey/ckey 로 표시. **AI 시나리오 생성 시**: ViewGroup/EditGroup 등 데이터 바인딩 메타는 생략 가능 (스튜디오/사용자가 사후 설정). 단 ViewGroup/EditGroup 을 작성한다면 그 안의 ImageSrcType 별 필수 키는 강제.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType":  { "const": "ImageBox" },
+        "ImageBoxType": {
+          "type": "string",
+          "enum": ["View", "Edit"],
+          "description": "View=읽기전용 이미지 표시. Edit=업로드/촬영 + 표시."
+        },
+        "ViewGroup": { "$ref": "_base.schema.json#/$defs/imageBoxViewGroup" },
+        "EditGroup": { "$ref": "_base.schema.json#/$defs/imageBoxEditGroup" },
+        "UseDefaultValue": {
+          "type": "boolean",
+          "default": false,
+          "description": "기본(폴백) 이미지 사용 여부. ★ 단일 키지만 ImageBoxType 별로 의미가 다름: (1) ImageBoxType='Edit' → true 면 EditGroup 업로드 전/실패 시 ViewGroup 의 이미지를 placeholder 로 표시 (property-data createUseDefault, 토글 UI 'UseDefault'). (2) ImageBoxType='View' → true 면 DefaultViewGroup 활성 — ViewGroup 의 FlexFile/Base64 로드 실패 시 fallback (property-data createUseDefaultView, 토글 UI 'UseDefaultView', 표시 조건: ViewGroup.ImageSrcType ∈ {'FlexFile','Base64'}). engine const K.USE_DEFAULTVALUE='UseDefaultValue' — 프로퍼티 EDITOR_CTRL.CHECKBOX, boolean strict."
+        },
+        "DefaultViewGroup": {
+          "$ref": "_base.schema.json#/$defs/imageBoxViewGroup",
+          "description": "기본 이미지 정의 — ImageBoxType='View' + UseDefaultValue=true 조합에서 fallback 으로 표시될 이미지. shape 은 ViewGroup 과 동일 ($defs/imageBoxViewGroup). UseDefaultValue=true 면 사용자 수동 설정으로 채워짐. ★ AI 생성 시 미포함 — 운영 사후 설정 전용."
+        },
+        "UseCondition": { "type": "boolean", "description": "조건부 동작 사용. Edit 모드 샘플은 문자열 'false' 도 허용." },
+        "UseMultiData": { "type": "boolean", "description": "다중 이미지 사용. Edit 모드 샘플은 문자열 'false' 도 허용." },
+        "UseEvents":    { "type": "boolean", "description": "이벤트 사용. Edit 모드 샘플은 문자열 'false' 도 허용." },
+        "Events":       { "$ref": "_base.schema.json#/$defs/imageBoxEvents" }
+      },
+      "required": ["ImageBoxType"]
+    },
+    {
+      "$comment": "ImageBoxType='View' + UseDefaultValue=true → DefaultViewGroup 권장. 운영 메타에 종종 누락 — schema 강제 안 함 (가이드 차원).",
+      "if": {
+        "properties": {
+          "ImageBoxType":    { "const": "View" },
+          "UseDefaultValue": { "const": true }
+        },
+        "required": ["ImageBoxType", "UseDefaultValue"]
+      },
+      "then": {}
+    }
+  ]
+}

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

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/input-date.schema.json",
+  "title": "InputDate",
+  "description": "날짜 입력 + 캘린더 다이얼로그. CalendarType / SelectType 은 InputDate 본체가 아니라 Dialog.Layouts[*].Controls[*] 의 Calendar 컨트롤에 위치. DateFormat 은 본체에 위치하며 CalendarType 과 정합되어야 한다.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    { "$ref": "_base.schema.json#/$defs/inputBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "InputDate" },
+        "DateFormat": {
+          "type": "string",
+          "enum": ["", "YYYY-MM-DD", "YYYY.MM.DD", "YYYY/MM/DD", "YYYY-MM"],
+          "description": "표시 포맷. dayCalendar→YYYY-MM-DD/YYYY.MM.DD/YYYY/MM/DD, monthCalendar→YYYY-MM, yearCalendar→'' (기본). 빈 문자열은 런타임 기본 포맷."
+        },
+        "Dialog": { "$ref": "_base.schema.json#/$defs/calendarDialog" }
+      }
+    },
+    {
+      "$comment": "DateFormat='YYYY-MM' 이면 monthCalendar 와 함께 사용해야 함. Dialog 내 Calendar.CalendarType 과 정합 cross-check 는 validate.mjs 후검증 (JSON Schema 에서 Calendar.CalendarType 까지 추적하는 if/then 은 표현 가능하나 가독성 이슈로 후검증으로 분리)."
+    }
+  ]
+}

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

@@ -0,0 +1,139 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/input-file.schema.json",
+  "title": "InputFile",
+  "description": "파일 첨부 컨트롤. Module 값에 따라 백엔드 저장 방식이 갈리고 그에 맞는 Attributes shape 가 적용된다. 공통 옵션 (Title/Description/Limit/AllowExtensions/UseClickdownload) 은 본체에, 모듈별 옵션은 Attributes 안에. property-data.js inputFile() 진실원본.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType", "Module"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "InputFile" },
+
+        "Title": {
+          "type": "string",
+          "description": "컨트롤 제목 (스튜디오 프로퍼티 EDITOR_CTRL.INPUTBOX). 화면 표시용은 아니며 식별/문서용."
+        },
+        "Description": {
+          "type": "string",
+          "description": "컨트롤 설명 텍스트 (스튜디오 프로퍼티 EDITOR_CTRL.INPUTBOX)."
+        },
+
+        "Module": {
+          "type": "string",
+          "enum": ["FlexFile", "KsystemFile", "KsystemPayPDF", "HostingFolder", "ServerkitFile"],
+          "default": "FlexFile",
+          "description": "파일 저장 백엔드. ★ engine const FILE_MODULE — 'FlexFile'/'KsystemFile'/'KsystemPayPDF' 는 모든 워크스페이스, 'HostingFolder'/'ServerkitFile' 은 flex/okong/hallim/bhidev 워크스페이스에서만 노출 (스튜디오 프로퍼티 가시성). Module 변경 시 Attributes 가 해당 모듈의 FILEATTR 기본형으로 자동 초기화."
+        },
+
+        "Limit": {
+          "type": ["number", "string"],
+          "description": "업로드 제한 (개수). 프로퍼티 EDITOR_CTRL.INPUTBOX(NUMBER) — 숫자 저장 권장. 빈 문자열/0/미설정=런타임 기본."
+        },
+        "AllowExtensions": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z0-9]+$" },
+          "description": "허용 확장자 화이트리스트. 소문자/숫자만 (런타임 검증: `/^[a-z0-9]+$/`). 차단 확장자: exe, msi, bat, cmd, com, ps1, vbs, js, jar, sh, apk, dmg, docm, xlsm, pptm. ★ 스튜디오 프로퍼티 가시성: Module ∈ {FlexFile, HostingFolder, ServerkitFile} 만 노출 (KsystemFile / KsystemPayPDF 는 확장자 제어 없음)."
+        },
+        "UseClickdownload": {
+          "type": "boolean",
+          "default": false,
+          "description": "★ 키 표기 'UseClickdownload' — 소문자 'd' (engine const K.FILE.USE_CLICK_DOWNLOAD='UseClickdownload'). 'UseClickDownload' 아님. true=클릭 다운로드 활성화. ★ 스튜디오 프로퍼티 가시성: Module ≠ HostingFolder 일 때 노출 (HostingFolder 는 자체 다운로드 라우팅이라 불필요)."
+        },
+
+        "Attributes": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Module 별 백엔드 속성. shape 가 Module 값에 따라 결정됨 — 아래 if/then 분기로 강제. 운영 메타에는 모듈 전환 시 이전 모듈의 키가 남아있을 수 있어 additionalProperties:true.",
+          "properties": {
+            "UseCategory":  { "type": "boolean", "default": false, "description": "true=별도 컬렉션 카테고리에 파일 메타 누적. false=Ckeys 단일 필드에 저장 (★ InnerCKey 경로는 [no-inner-block] 정책으로 차단). FILEATTR 기본값 — FlexFile/HostingFolder/ServerkitFile=true / KsystemFile=false / KsystemPayPDF=N/A." },
+            "CategoryName": { "type": "string", "description": "UseCategory=true 일 때 사용할 카테고리명 (예: 'CtgFiles'). scenario.Panel.Category 에 정의 필요." },
+            "InnerCKey":    false,
+            "Ckeys":        { "type": "array", "items": { "type": "string" }, "description": "KsystemFile / KsystemPayPDF 의 시퀀스 키 배열 — 업로드된 파일 시퀀스를 저장할 컬렉션 필드들." },
+            "Const":        { "type": "string", "description": "KsystemFile / KsystemPayPDF — 백엔드 상수 식별자." },
+            "FlexKey":      {
+              "type": "object",
+              "additionalProperties": true,
+              "description": "FlexFile / HostingFolder / ServerkitFile — 업로드한 파일키 저장 정보. { ckey } 구조.",
+              "properties": {
+                "ckey": { "type": "string", "description": "파일키를 저장할 컬렉션 필드명." }
+              }
+            },
+            "SharedTarget": {
+              "type": "string",
+              "enum": ["user", "tenant"],
+              "default": "tenant",
+              "description": "FlexFile 전용 공유 범위 — 'user'=사용자 전용 / 'tenant'=테넌트 공유. FILEATTR 기본값 'tenant'."
+            },
+            "Directory":  { "type": "string", "description": "FlexFile 전용 (선택) — 저장 경로 디렉토리." },
+            "FileName":   { "type": "string", "description": "HostingFolder / ServerkitFile — 저장 시 사용할 파일명 컬렉션 필드명." },
+            "FolderRoute":{ "type": "string", "description": "HostingFolder / ServerkitFile — 저장 폴더 경로 (선행/후행 슬래시 자동 정규화 — 항상 'foo/bar/' 형태)." }
+          },
+          "allOf": [
+            {
+              "$comment": "Attributes.UseCategory=true 면 CategoryName 필수.",
+              "if": {
+                "properties": { "UseCategory": { "const": true } },
+                "required": ["UseCategory"]
+              },
+              "then": { "required": ["CategoryName"] }
+            }
+          ]
+        },
+
+        "UseEvents": { "type": "boolean", "default": false, "description": "이벤트 사용. Module=KsystemPayPDF 에서는 스튜디오 프로퍼티에 노출 안 됨 (이벤트 미지원)." },
+        "Events":    { "$ref": "_base.schema.json#/$defs/inputFileEvents" }
+      }
+    },
+    {
+      "$comment": "Module='FlexFile' → Attributes.FlexKey + SharedTarget 권장. FileDataGroup 에 UseCategory 기본 true.",
+      "if": {
+        "properties": { "Module": { "const": "FlexFile" } },
+        "required": ["Module"]
+      },
+      "then": {
+        "properties": {
+          "Attributes": { "required": ["FlexKey"] }
+        }
+      }
+    },
+    {
+      "$comment": "Module='KsystemFile' → Attributes.Ckeys + Const 권장. UseCategory 기본 false.",
+      "if": {
+        "properties": { "Module": { "const": "KsystemFile" } },
+        "required": ["Module"]
+      },
+      "then": {
+        "properties": {
+          "Attributes": { "required": ["Ckeys", "Const"] }
+        }
+      }
+    },
+    {
+      "$comment": "Module='KsystemPayPDF' → Attributes.Ckeys + Const 필수. UseEvents/Events 미지원.",
+      "if": {
+        "properties": { "Module": { "const": "KsystemPayPDF" } },
+        "required": ["Module"]
+      },
+      "then": {
+        "properties": {
+          "Attributes": { "required": ["Ckeys", "Const"] }
+        }
+      }
+    },
+    {
+      "$comment": "Module='HostingFolder' / 'ServerkitFile' → Attributes.FlexKey + FileName + FolderRoute 권장.",
+      "if": {
+        "properties": { "Module": { "enum": ["HostingFolder", "ServerkitFile"] } },
+        "required": ["Module"]
+      },
+      "then": {
+        "properties": {
+          "Attributes": { "required": ["FlexKey"] }
+        }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/input-mask.schema.json",
+  "title": "InputMask",
+  "description": "마스크 패턴 입력. hhmm/money/yyyymmdd/phone.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    { "$ref": "_base.schema.json#/$defs/inputBase" },
+    {
+      "properties": {
+        "ControlType":   { "const": "InputMask" },
+        "InputType": {
+          "type": "string",
+          "enum": ["hhmm", "money", "yyyymmdd", "phone"],
+          "description": "hhmm=HH:MM 시간 / money=천단위 콤마 / yyyymmdd=YYYY-MM-DD 날짜 / phone=전화번호 패턴."
+        },
+        "MaskType":      {
+          "type": "string",
+          "enum": ["Time", "Money", "Date", "Phone"],
+          "description": "마스크 카테고리 표시용. InputType 과 정합되어야 함 (hhmm↔Time, money↔Money, yyyymmdd↔Date, phone↔Phone)."
+        },
+        "UseNumberOnly": { "type": "boolean", "default": false, "description": "money 등에서 숫자만 입력 강제. money 사용 시 권장 (필수는 아님)." },
+
+        "UseFixedDecimalPlaces": { "type": "boolean", "default": false, "description": "InputType='money' 일 때 소수점 자릿수 고정 사용 여부. true 일 때 DecimalPlaces + RoundingMode 활성." },
+        "DecimalPlaces": {
+          "type": ["integer", "string", "null"],
+          "minimum": 0,
+          "maximum": 15,
+          "description": "고정 소수점 자릿수 (0~15). UseFixedDecimalPlaces=true 일 때만 의미. 빈 입력은 null."
+        },
+        "RoundingMode": {
+          "type": "string",
+          "enum": ["round", "ceil", "floor"],
+          "default": "round",
+          "description": "소수점 처리 방식. round=반올림 / ceil=올림 / floor=내림. UseFixedDecimalPlaces=true 일 때만 의미."
+        },
+
+        "Events":        { "$ref": "_base.schema.json#/$defs/inputEventsChangeOnly" }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/control/input-number.schema.json",
+  "title": "InputNumber",
+  "description": "숫자 입력. number/decimal/password. 천단위 콤마 (money) 는 InputMask 컨트롤 사용.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id", "ControlType"],
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/controlBase" },
+    { "$ref": "_base.schema.json#/$defs/inputBase" },
+    {
+      "properties": {
+        "ControlType": { "const": "InputNumber" },
+        "InputType": {
+          "type": "string",
+          "enum": ["number", "decimal", "password"],
+          "description": "number=정수 (콤마 없음, 순수 숫자) / decimal=소수점 허용 (콤마 없음) / password=마스킹된 숫자 입력. 1000단위 콤마는 InputMask + InputType:'money' 사용."
+        },
+        "Events":   { "$ref": "_base.schema.json#/$defs/inputEventsChangeOnly" }
+      }
+    }
+  ]
+}