@flextudio/scenario 0.1.0

package/skill/schemas/index.json

@@ -0,0 +1,362 @@
+{
+  "count": 51,
+  "schemas": [
+    {
+      "name": "bottom-buttons",
+      "path": "bottom-buttons.schema.json",
+      "title": "BottomButtons",
+      "description": "Step 의 하단 고정 버튼 채널. `Step.BottomButtons` 배열의 각 항목(`BottomButton`) 단위 스키마. Control 급 풍부도이지만 ControlType 키 없이 Step 의 직접 자식으로만 등장. StepSub 에서는 `UseBottomButton:false` 강제로 빈 배열만 허용.\n\n[canonical-shape] Flextudio 스튜디오가 실제로 emit 하는 형태가 기준. MoveTo 별 키 분기는 상호배타 — `MoveTo:\"Next\"` 면 top-level `Next` 만, `MoveTo:\"Prev\"` / `\"Prev_ReStart\"` 면 top-level `Prev` 만 (서로의 키 emit 금지). `Next.Step{N}` 슬롯 값은 **빈 문자열 `\"\"`** 이 canonical — 비어있지 않은 문자열은 조건/Direction 등 향후 슬롯 확장 여지 (현재 엔진 emit 은 `\"\"`).\n\n[canonical-key-order] Flextudio emit 순서: `IsRestored → IsIgnoreRequired → Direction → Next | Prev` (앞쪽 스타일/표시 키 다음). 스키마는 키 순서를 강제하지 않으나 가능하면 이 순서로 emit 권장.",
+      "$id": "https://flextudio.local/meta-contract/v1/bottom-buttons.schema.json"
+    },
+    {
+      "name": "control/_base",
+      "path": "control/_base.schema.json",
+      "title": "Control Base",
+      "description": "모든 Control 분기가 공통으로 사용하는 $defs. 개별 control/*.schema.json 은 controlBase / inputBase / calendarDialog / comboDialog / searchDialog (+ 내부 calendarControl / comboListControl / searchListControl) 을 $ref 로 합성.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/_base.schema.json"
+    },
+    {
+      "name": "control/button",
+      "path": "control/button.schema.json",
+      "title": "Button",
+      "description": "액션 트리거 전용 컨트롤. 입력 없음. ButtonName(텍스트) + ImageStyle(아이콘) 단독 또는 조합. UseClickEvent 로 Events.Click 핸들러만 지원. ButtonValueCKey + ButtonValue 로 클릭 시 카테고리 필드에 값 저장 가능. Step 이동 미지원 — Label.UseMove 또는 BottomButton 사용.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/button.schema.json"
+    },
+    {
+      "name": "control/calendar-navigator",
+      "path": "control/calendar-navigator.schema.json",
+      "title": "CalendarNavigator",
+      "description": "캘린더 네비게이터. 월/주/일 단위로 날짜 범위를 이동·선택. (1) TimeTable 내부 자식 (UseTimeTable=true), (2) 독립 컨트롤 (UseTimeTable=false) 두 가지 사용 형태. 독립 사용 시 래퍼 Group 에 UseDataConnection:true 필수. Events / DayArea / DaySetting / SelectDay / UseEvents 는 빈 객체/기본값이라도 반드시 존재해야 한다 (런타임 규약).",
+      "$id": "https://flextudio.local/meta-contract/v1/control/calendar-navigator.schema.json"
+    },
+    {
+      "name": "control/calendar",
+      "path": "control/calendar.schema.json",
+      "title": "Calendar",
+      "description": "캘린더 (날짜 선택). 일반적으로 InputDate.Dialog.Layouts[*].Controls[*] 위치에 자식으로 배치되며, 단독 컨트롤로도 사용 가능. CalendarType / SelectType 으로 일·월·년 picker 와 단일·기간 모드를 분기. 정의 본체는 _base.schema.json#/$defs/calendarControl 을 그대로 차용한다.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/calendar.schema.json"
+    },
+    {
+      "name": "control/check-box",
+      "path": "control/check-box.schema.json",
+      "title": "CheckBox",
+      "description": "체크박스. Items[] 로 다중 항목 / 단일 toggle 모두 지원. 옆 텍스트는 Items[].ItemName.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/check-box.schema.json"
+    },
+    {
+      "name": "control/combo",
+      "path": "control/combo.schema.json",
+      "title": "Combo",
+      "description": "드롭다운 선택. 자식 트리 보유 (Dialog.Layouts[*].Controls[*] = ComboList). 8개 이하 고정 목록 전용 — 그 외는 Search 사용.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/combo.schema.json"
+    },
+    {
+      "name": "control/embed",
+      "path": "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 같은 내부명을 두면 그대로 출력됨).",
+      "$id": "https://flextudio.local/meta-contract/v1/control/embed.schema.json"
+    },
+    {
+      "name": "control/image-box",
+      "path": "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 별 필수 키는 강제.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/image-box.schema.json"
+    },
+    {
+      "name": "control/input-date",
+      "path": "control/input-date.schema.json",
+      "title": "InputDate",
+      "description": "날짜 입력 + 캘린더 다이얼로그. CalendarType / SelectType 은 InputDate 본체가 아니라 Dialog.Layouts[*].Controls[*] 의 Calendar 컨트롤에 위치. DateFormat 은 본체에 위치하며 CalendarType 과 정합되어야 한다.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/input-date.schema.json"
+    },
+    {
+      "name": "control/input-file",
+      "path": "control/input-file.schema.json",
+      "title": "InputFile",
+      "description": "파일 첨부 컨트롤. Module 값에 따라 백엔드 저장 방식이 갈리고 그에 맞는 Attributes shape 가 적용된다. 공통 옵션 (Title/Description/Limit/AllowExtensions/UseClickdownload) 은 본체에, 모듈별 옵션은 Attributes 안에. property-data.js inputFile() 진실원본.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/input-file.schema.json"
+    },
+    {
+      "name": "control/input-mask",
+      "path": "control/input-mask.schema.json",
+      "title": "InputMask",
+      "description": "마스크 패턴 입력. hhmm/money/yyyymmdd/phone.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/input-mask.schema.json"
+    },
+    {
+      "name": "control/input-number",
+      "path": "control/input-number.schema.json",
+      "title": "InputNumber",
+      "description": "숫자 입력. number/decimal/password. 천단위 콤마 (money) 는 InputMask 컨트롤 사용.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/input-number.schema.json"
+    },
+    {
+      "name": "control/input-text",
+      "path": "control/input-text.schema.json",
+      "title": "InputText",
+      "description": "한 줄 텍스트 입력. text/password 모드.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/input-text.schema.json"
+    },
+    {
+      "name": "control/label",
+      "path": "control/label.schema.json",
+      "title": "Label",
+      "description": "텍스트/아이콘 표시 전용. 입력 없음. labeltext / LabelCKey 두 모드. UseMove / UseClickEvent 로 Group / Button 과 동일한 클릭 패턴 지원.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/label.schema.json"
+    },
+    {
+      "name": "control/multi-input-box",
+      "path": "control/multi-input-box.schema.json",
+      "title": "MultiInputBox",
+      "description": "여러 줄 텍스트 입력 (TextArea). Enter 로 줄바꿈. Shared Input Base 사용 — Height 기본 120px (다른 입력은 70px).",
+      "$id": "https://flextudio.local/meta-contract/v1/control/multi-input-box.schema.json"
+    },
+    {
+      "name": "control/other",
+      "path": "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 분기로 빠짐.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/other.schema.json"
+    },
+    {
+      "name": "control/radio-box",
+      "path": "control/radio-box.schema.json",
+      "title": "RadioBox",
+      "description": "라디오 그룹. Fixed Items 또는 DataSource 두 가지 데이터 소스. styleTab 으로 탭 형태 UI 도 가능. UseDataSource 미지정 시 런타임 default=false (Fixed 모드).",
+      "$id": "https://flextudio.local/meta-contract/v1/control/radio-box.schema.json"
+    },
+    {
+      "name": "control/search",
+      "path": "control/search.schema.json",
+      "title": "Search",
+      "description": "Code Help / Lookup. 자식 트리 보유 (Dialog.Layouts[*].Controls[*] = List). 항목이 8개를 초과하거나 동적으로 늘어나는 데이터 (고객/사용자/거래처 등) 에 사용. DataSource=Collection/Service 면 Search, Fixed 면 Combo.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/search.schema.json"
+    },
+    {
+      "name": "control/tab",
+      "path": "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)가 실행되지 않으며 서브시나리오 스텝은 표시할 수 없다.'",
+      "$id": "https://flextudio.local/meta-contract/v1/control/tab.schema.json"
+    },
+    {
+      "name": "control/tree",
+      "path": "control/tree.schema.json",
+      "title": "Tree",
+      "description": "계층형(부모-자식) 데이터를 트리 구조로 표시. NodeId/ParentId 로 flat array 의 트리 관계 표현. 단일 선택(Selected) 과 다중 선택(UseMultiData=true → Checked 체크박스) 모드.",
+      "$id": "https://flextudio.local/meta-contract/v1/control/tree.schema.json"
+    },
+    {
+      "name": "control",
+      "path": "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.",
+      "$id": "https://flextudio.local/meta-contract/v1/control.schema.json"
+    },
+    {
+      "name": "data-objects",
+      "path": "data-objects.schema.json",
+      "title": "Data Objects",
+      "description": "데이터 바인딩/필터 관련 공통 객체 카탈로그. Group의 DataConnection 과 TargetSector.Filters 등.",
+      "$id": "https://flextudio.local/meta-contract/v1/data-objects.schema.json"
+    },
+    {
+      "name": "data-sources",
+      "path": "data-sources.schema.json",
+      "title": "DataSources",
+      "description": "scenarioMeta.DataSources — 명명 데이터소스 모음. Combo / RadioBox / Search / Tree / CheckBox(Multi) / Approval / TimeTable / Scheduler 등에서 'DataSourceName' 으로 참조. 키=DataSource 이름, 값=dataSource 분기. 엔진 enum: Fixed/Grid/Service/Collection/API (engine/common/const.js).",
+      "$id": "https://flextudio.local/meta-contract/v1/data-sources.schema.json"
+    },
+    {
+      "name": "design-system/design",
+      "path": "design-system/design.schema.json",
+      "title": "design",
+      "description": "Short stylesheet for raw controls — materializer expands to FontStyle / Width / Height / Padding / Margin / BgStyle / BorderStyle / DisplayStyle / ContentStyle / UseFixedSize / CaptionStyle / UseAbsoluteLayout+AbsolutePosition / UseOpacity+OpacityValue before validation. Full guide: DESIGN.md (get_design_rules). enum slots sync with tokens.json (verified by design.schema.test.mjs).",
+      "$id": "https://flextudio.local/meta-contract/v1/design-system/design.schema.json"
+    },
+    {
+      "name": "events",
+      "path": "events.schema.json",
+      "title": "Scenario Events",
+      "description": "scenarioMeta.Events — 시나리오 레벨 이벤트 핸들러 맵. 키 패턴 `^[A-Za-z_][A-Za-z0-9_.]*$` (영문/숫자/언더스코어/점, 첫 글자는 영문/언더스코어). 값은 Action 객체 배열. Step / Group / Control / BottomButton 의 Events 안에서 핸들러 이름으로 참조한다 (validator.ts checkEventReferences 와 정합). 실 샘플 예: `Init`, `Loaded`, `Click`, `userCheck`, `getList`, `STEP1_Query_E`, `Step6Init`, `Chart.js`, `loadMapScript`. Event-Service 흐름 (Event 호출 → Service 호출 → DB 조회 → 결과를 컬렉션 카테고리에 저장 → Step 재로드) 을 코드로 표현.",
+      "$id": "https://flextudio.local/meta-contract/v1/events.schema.json"
+    },
+    {
+      "name": "group",
+      "path": "group.schema.json",
+      "title": "Group",
+      "description": "ContentsType=\"Group\" 단일. 컨테이너 노드. 자식으로 Group | Control 보유.",
+      "$id": "https://flextudio.local/meta-contract/v1/group.schema.json"
+    },
+    {
+      "name": "naming-objects",
+      "path": "naming-objects.schema.json",
+      "title": "Naming Objects",
+      "description": "컬렉션 식별자 (Ckey / CategoryName) 의 명명 제약 카탈로그. AI 메타 생성 시 시스템 예약어 / JS 예약어 / JS 빌트인 충돌을 schema 레벨에서 강제 차단. 상세 규칙은 runtime/v1/collection/naming.md, runtime/v1/collection/sector.md §6 참조.",
+      "$id": "https://flextudio.local/meta-contract/v1/naming-objects.schema.json"
+    },
+    {
+      "name": "node",
+      "path": "node.schema.json",
+      "title": "Node",
+      "description": "Group | Control 2-union (Step은 Scenario 직속이라 여기 포함하지 않음). Group.Contents[] 의 자식으로 사용.",
+      "$id": "https://flextudio.local/meta-contract/v1/node.schema.json"
+    },
+    {
+      "name": "patterns/atom/badge",
+      "path": "patterns/atom/badge.schema.json",
+      "title": "pattern.atom.badge",
+      "description": "상태/카테고리 라벨용 pill 형 뱃지. Label + pill BorderRadius(999) + 라이트 배경(`var(--colorSub10)`) + Bold 텍스트. 너비는 텍스트에 맞춰 자동 fit, 높이도 텍스트 + Padding 으로 결정. color 는 의미적 5종(green/black/red/blue/gray) — FontColor 만 바뀌고 배경은 5종 모두 동일한 라이트 톤이라 인접 정보 위에 얹어도 충돌 없음. size 는 md/lg 두 단계.",
+      "$id": "https://flextudio.local/meta-contract/v1/patterns/atom/badge.schema.json"
+    },
+    {
+      "name": "patterns/atom/button",
+      "path": "patterns/atom/button.schema.json",
+      "title": "pattern.atom.button",
+      "description": "버튼 액션 아톰. v1 엔진에 'Button' ControlType 이 없으므로 Label + UseClickEvent 패턴으로 materialize. 시각적 강조 수준(variant) 3종 — primary 는 화면당 1개 CTA 권장(`Step.FixedContentsBottom` 자리), secondary 는 보조 액션, tertiary 는 인라인 텍스트 액션. 너비는 full(100%) 또는 fit(content + padding) 두 가지. 라운드/타이포/색은 DESIGN.md §Buttons + §Do's 기준이라 prop 으로 노출하지 않는다.",
+      "$id": "https://flextudio.local/meta-contract/v1/patterns/atom/button.schema.json"
+    },
+    {
+      "name": "patterns/atom/checkbox",
+      "path": "patterns/atom/checkbox.schema.json",
+      "title": "pattern.atom.checkbox",
+      "description": "단일 체크박스 아톰. label 옆에 사각 체크박스를 표시한다. Expo 디자인 언어 — 체크 시 박스 내부가 Ink(검정) 으로 채워진다(`ItemBgStyle.ItemBgColor: var(--colorBlack)`). 폼 동의 / 토글 / 선택지 1개에 사용. 다중 선택 그룹은 RadioBox 또는 다중 체크박스 패턴(별도) 사용.",
+      "$id": "https://flextudio.local/meta-contract/v1/patterns/atom/checkbox.schema.json"
+    },
+    {
+      "name": "patterns/atom/segmented-radio",
+      "path": "patterns/atom/segmented-radio.schema.json",
+      "title": "pattern.atom.segmented-radio",
+      "description": "세그먼티드 라디오 아톰. RadioBox + `ControlStyle:\"stylePeriod\"` 로 동등 분할된 탭형 단일 선택. 같은 리스트의 필터/뷰 전환 등 화면 전체가 바뀌지 않는 옵션 토글에 사용 (탭 전환이 필요하면 Tab 컨트롤). items 는 string 배열 — 각 항목의 표시 텍스트와 저장 값이 동일하게 매핑된다. 너비 100% / 높이 35px 고정(단 stylePeriod 항목 높이는 엔진 CSS `.stylePeriod label{min-height:2em}` 가 우선이라 meta Height 는 무시되고 실제 약 25px 로 렌더됨 — meta 로 조절 불가). 선택 시 박스 내부가 Ink(검정) 으로 채워지는 Expo 디자인. 라운드/타이포는 DESIGN.md 기준이라 prop 으로 노출하지 않는다. ★ 데이터 바인딩(폼 입력)으로 쓸 때는 `saveValueKey`(+선택적 `saveNameKey`) 를 넘긴다 — 머티리얼라이저가 `Ckeys`+`SaveValueKey`(+`SaveNameKey`) 로 emit 한다. 이 키들은 **섹터(목업/카테고리 데이터)의 필드명** 이어야 하므로, 목업 데이터를 생성했다면 거기서 쓰는 키로 맞춘다 (rules.md §5.5.1). 순수 필터/뷰 토글(선택값 저장 불필요)이면 생략 가능. `CtrlDisplayCkey` 는 RadioBox 미사용이라 넣지 않는다.",
+      "$id": "https://flextudio.local/meta-contract/v1/patterns/atom/segmented-radio.schema.json"
+    },
+    {
+      "name": "patterns/atom/switch",
+      "path": "patterns/atom/switch.schema.json",
+      "title": "pattern.atom.switch",
+      "description": "토글 스위치 아톰. CheckBox 컨트롤 기반 (`CheckBoxType:\"CheckBoxSwitch\"` + `ControlStyle:\"styleSwitchSmall\"`). 이진 on/off 상태 전환에 사용 — 다중 선택지는 segmented-radio, 동의 체크는 checkbox 아톰. label 은 optional: 있으면 스위치 + 라벨 한 줄(Width 100%), 없으면 스위치만 fit. on 상태 색은 Expo Ink (`var(--colorBlack)`) — checkbox / segmented-radio 아톰과 동일한 primary 선택 색.",
+      "$id": "https://flextudio.local/meta-contract/v1/patterns/atom/switch.schema.json"
+    },
+    {
+      "name": "patterns/molecule/checklist",
+      "path": "patterns/molecule/checklist.schema.json",
+      "title": "pattern.molecule.checklist",
+      "description": "상단 라벨 + 체크박스 아이템 그리드 (molecule). 필터/다중선택 영역에 쓰는 '라벨 + 여러 체크박스' 묶음. 외부 Group(세로, rowGap 12)에 라벨 Label(SemiBold 15)이 위에 오고, 그 아래 체크박스 그리드 Group(wrap, columnGap 8 / rowGap 12)이 온다. 각 아이템은 styleSquare 단일 체크박스이며 체크 시 박스가 checkedColor 로 채워진다. lines=1 이면 한 줄에 하나(Width 100%), lines=2 이면 2열(각 Width calc(50% - 4px) + columnGap 8px 로 정확히 100% 정렬). Height 는 emit 하지 않고 엔진 자동에 맡긴다. 데이터 바인딩(Ckeys/SaveKey)이 필요하면 override.grid 또는 각 아이템에 직접 지정.",
+      "$id": "https://flextudio.local/meta-contract/v1/patterns/molecule/checklist.schema.json"
+    },
+    {
+      "name": "patterns/molecule/input-action",
+      "path": "patterns/molecule/input-action.schema.json",
+      "title": "pattern.molecule.input-action",
+      "description": "입력 컨트롤 + 트레일링 아이콘 버튼 페어 (molecule). 검색 / 필터 / 장바구니 / 알림 등 'field + 우상단 액션' 패턴. 외부 Group 안에 입력 본체(InputText/InputNumber/InputMask/Search/InputDate) 가 Width 100% 로 깔리고, 그 위 우상단 모서리에 28×28 아이콘 버튼이 절대 위치(UseAbsoluteLayout) 로 떠 있다. 버튼 우상단에는 옵션으로 작은 카운터 뱃지(absolute) 가 얹힌다. molecule 의 작은 뱃지는 atom/badge 와 별도 구현 — 크기/위치 규격이 다르고 절댓값 좌표가 필요하기 때문. 입력 본체는 Caption 비활성 (molecule 가 시각적 라벨을 노출하지 않음) — 라벨이 필요한 폼 필드라면 별도 라벨 + input 조합을 사용. inputType=inputSearch / inputDate 는 Dialog 합성을 포함한다.",
+      "$id": "https://flextudio.local/meta-contract/v1/patterns/molecule/input-action.schema.json"
+    },
+    {
+      "name": "patterns/molecule/input-button",
+      "path": "patterns/molecule/input-button.schema.json",
+      "title": "pattern.molecule.input-button",
+      "description": "입력 컨트롤 + 짧은 액션 버튼 페어 (molecule). 왼쪽에 단말 입력 (InputText / InputNumber / InputMask), 오른쪽에 atom/button 표준 CTA 가 fit 너비로 붙는 가로 페어. 대표 use case: 주소 + '우편번호 검색', 휴대폰 + '인증', 쿠폰 코드 + '적용', 사번 + '직원 검색' — 버튼이 입력값을 외부 lookup 으로 채우거나 값에 대한 액션을 수행하는 패턴.\n\n입력은 Width 100% (남는 공간을 채우되 maxWidth 500px 로 캡, minWidth 는 content 만큼). Caption(라벨) 유무로 Height 자동 분기 — 있으면 70px, 없으면 44px. readOnly 옵션은 버튼이 값을 채우는 lookup 패턴에서 입력 직접 편집을 막을 때 사용 (ControlKey:'ReadOnly').\n\n버튼은 atom/button 의 primary variant + width=fit 을 그대로 호출하여 생성 — 색/높이/타이포는 atom 표준. molecule 은 wrapper(horizontal flex, columnGap 4px, vertical-align bottom) + 입력 디자인만 결정한다. 버튼에 이벤트가 필요하면 별도 후처리 또는 atom/button raw 사용을 권장 (이 molecule 은 시각 + 라벨만 제공).",
+      "$id": "https://flextudio.local/meta-contract/v1/patterns/molecule/input-button.schema.json"
+    },
+    {
+      "name": "patterns/molecule/input-pair",
+      "path": "patterns/molecule/input-pair.schema.json",
+      "title": "pattern.molecule.input-pair",
+      "description": "두 개의 입력 컨트롤이 가로로 나란히 50%/50% 로 배치되는 페어 (molecule). 쿼리/필터 행에 자주 쓰이는 'duo' 구조 — 예: 부서(inputCombo) + 담당자(inputSearch), 시작일(inputDate) + 종료일(inputDate), 기간(inputCombo) + 상태(inputCombo). 두 입력은 서로 다른 inputType 을 가질 수 있다 (per-item). 각 입력은 Caption(입력 위 라벨) 을 옵션으로 가질 수 있으며 Caption 유무에 따라 Height 가 68px(라벨 포함) / 44px(라벨 없음) 로 자동 결정.\n\nbgColor 가 있으면 'carded' 모드 — wrapper 에 라이트 톤 배경 + 상하 20px Margin + (8/10) Padding 이 깔리고, 두 입력은 columnGap 8px 로 모이고 border 는 radius-only(시각 hairline 없음) 가 되어 카드 안에 잠긴다. bgColor 가 없으면 'open' 모드 — wrapper 는 투명, columnGap 16px 로 더 여유 있고, 두 입력은 1px Gray4 hairline 으로 페이지 위에 또렷이 선다.\n\n[naming] inputType 식별자 + per-type 옵션 키 prefix — `inputCombo / inputSearch / inputDate`, `comboItems`, `comboDataSourceName`, `comboTitle`, `searchDataSourceName`, `searchTitle`, `searchSubTitle`, `searchKeywordCkey`, `dateFormat`, `dateSelectType`. 공통 키(`name`, `caption`, `placeholder`) 는 접두사 없음.",
+      "$id": "https://flextudio.local/meta-contract/v1/patterns/molecule/input-pair.schema.json"
+    },
+    {
+      "name": "scenario",
+      "path": "scenario.schema.json",
+      "title": "Scenario",
+      "description": "flextudio scenarioMeta 루트. modules/htmlkey/ScenarioTitle/fConverterVersion/Collections 는 고정값 강제.",
+      "$id": "https://flextudio.local/meta-contract/v1/scenario.schema.json"
+    },
+    {
+      "name": "service/CustomSystem",
+      "path": "service/CustomSystem.schema.json",
+      "title": "CustomSystem ServiceBinding",
+      "description": "API 연동 사용자 정의 시스템 호출 (외부 마이크로서비스 / 인증 시스템 등). SystemType='CustomSystem' 고정. SystemID 문자열. fEventKey + fEvent 로 외부 라우팅 정의.",
+      "$id": "https://flextudio.local/meta-contract/v1/service/CustomSystem.schema.json"
+    },
+    {
+      "name": "service/Firestore",
+      "path": "service/Firestore.schema.json",
+      "title": "Firestore ServiceBinding",
+      "description": "Google Firestore 서비스 호출 정의. SystemID='Firestore' 고정. ModuleID 로 작업 종류 식별 (Query / Save / Update / Delete).",
+      "$id": "https://flextudio.local/meta-contract/v1/service/Firestore.schema.json"
+    },
+    {
+      "name": "service/FlexAutoQuery",
+      "path": "service/FlexAutoQuery.schema.json",
+      "title": "FlexAutoQuery ServiceBinding",
+      "description": "FlexAutoQuery 서비스 호출 정의. const.js 의 SYSTEM_ID.FLEXAUTOQUERY='FlexAutoQuery' 에 매핑. FlexSQL 없이 FlexDB '자동생성 테이블 (AI로 DB연결하기)' 에 대한 CRUD 자동 구성. flextudio-guide §6.8 / FlexAutoQuery. Business+ 플랜.",
+      "$id": "https://flextudio.local/meta-contract/v1/service/FlexAutoQuery.schema.json"
+    },
+    {
+      "name": "service/FlexSQL",
+      "path": "service/FlexSQL.schema.json",
+      "title": "FlexSQL ServiceBinding",
+      "description": "FlexSQL 서비스 호출 정의. 워크스페이스 콘솔에 등록된 SQL 쿼리를 시나리오 명:서비스 명 형식으로 호출. flextudio-guide §6.7. SystemID 'FlexSQL' 고정.",
+      "$id": "https://flextudio.local/meta-contract/v1/service/FlexSQL.schema.json"
+    },
+    {
+      "name": "service/Flextudio API",
+      "path": "service/Flextudio API.schema.json",
+      "title": "Flextudio API ServiceBinding",
+      "description": "Flextudio API 시스템 호출. const.js 의 SYSTEM_ID.FLEXTUDIO_API='Flextudio API' (공백 포함) 에 매핑. flexApiKey 기반 인증. 사용자(User) / 메시지(Message) / 그룹(Group) 3 모듈 + SubModuleID 로 CRUD 식별. 런타임: public/system/flextudio/flextudio_api.js.",
+      "$id": "https://flextudio.local/meta-contract/v1/service/Flextudio%20API.schema.json"
+    },
+    {
+      "name": "service/Flextudio",
+      "path": "service/Flextudio.schema.json",
+      "title": "Flextudio ServiceBinding",
+      "description": "Flextudio 내장 시스템 호출. const.js 의 SYSTEM_ID.FLEXTUDIO='Flextudio' 에 매핑. 워크스페이스 사용자/메시지 도메인 기능 (GetUserList / QueryMessage / SendMessage). 런타임 구현: public/system/flextudio/flextudio.js.",
+      "$id": "https://flextudio.local/meta-contract/v1/service/Flextudio.schema.json"
+    },
+    {
+      "name": "service/GoogleSheet",
+      "path": "service/GoogleSheet.schema.json",
+      "title": "GoogleSheet ServiceBinding",
+      "description": "Google Sheet 직접 연동. SystemID='GoogleSheet'. spreadsheetId + Sheet 명 + 기준 컬럼명 (보통 _SUID) 으로 동작. ModuleID 4종 (Query / Append / Update / Clear).",
+      "$id": "https://flextudio.local/meta-contract/v1/service/GoogleSheet.schema.json"
+    },
+    {
+      "name": "service/_base",
+      "path": "service/_base.schema.json",
+      "title": "Service Base",
+      "description": "서비스 종류별 ServiceBinding 분기에서 공통으로 쓰는 $defs. 각 service/<type>.schema.json 은 commonBase 위에 분기별 키를 얹는다 (allOf).",
+      "$id": "https://flextudio.local/meta-contract/v1/service/_base.schema.json"
+    },
+    {
+      "name": "service/ksystem",
+      "path": "service/ksystem.schema.json",
+      "title": "ksystem ServiceBinding",
+      "description": "ksystem 서비스 호출 정의. const.js 의 SYSTEM_ID.KSYSTEM='ksystem' 에 매핑. 영림원소프트랩 ksystem 사내 모듈 (FlexAPI / OpenAPI / Codehelp / Ksystem / Filehelp). 자동생성 BIZ 테이블에 대한 SP 호출 형태가 가장 흔함.",
+      "$id": "https://flextudio.local/meta-contract/v1/service/ksystem.schema.json"
+    },
+    {
+      "name": "service-binding",
+      "path": "service-binding.schema.json",
+      "title": "ServiceBinding",
+      "description": "scenarioMeta.ServiceBinding — 서비스 호출 정의 맵. 키는 서비스 식별자 (영문/숫자/언더스코어), 값은 호출 정의(SystemID + ModuleID 등). 스킬 생성 시에는 비어있는 객체 `{}` 만 허용 — `[no-service]` 후검증이 strict (`strict_no_service:true`). 운영 메타 호환을 위해 형식만 정의.",
+      "$id": "https://flextudio.local/meta-contract/v1/service-binding.schema.json"
+    },
+    {
+      "name": "step",
+      "path": "step.schema.json",
+      "title": "Step",
+      "description": "Steps[StepId] 의 값. StepType 누락 시 런타임은 StepView 로 처리.",
+      "$id": "https://flextudio.local/meta-contract/v1/step.schema.json"
+    },
+    {
+      "name": "style-objects",
+      "path": "style-objects.schema.json",
+      "title": "Style Objects",
+      "description": "Group/Control/BottomButton 등에서 공통 사용되는 스타일/레이아웃 객체 카탈로그. 모든 객체는 additionalProperties: true (런타임에서 추가 키를 무시하지 않으므로 유연성 유지).",
+      "$id": "https://flextudio.local/meta-contract/v1/style-objects.schema.json"
+    }
+  ]
+}

package/skill/schemas/naming-objects.schema.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/naming-objects.schema.json",
+  "title": "Naming Objects",
+  "description": "컬렉션 식별자 (Ckey / CategoryName) 의 명명 제약 카탈로그. AI 메타 생성 시 시스템 예약어 / JS 예약어 / JS 빌트인 충돌을 schema 레벨에서 강제 차단. 상세 규칙은 runtime/v1/collection/naming.md, runtime/v1/collection/sector.md §6 참조.",
+
+  "$defs": {
+    "categoryReservedKeys": {
+      "$comment": "isInvalidCategoryName() 의 차단 키 목록. 런타임이 categoryBridge 생성을 거부함. ckey 측에서도 Sector prototype 메서드(activate/select/unSelect/setStatus) 와 충돌하므로 동일 enum 을 ckey 차단에도 합친다.",
+      "enum": [
+        "outerSector", "outerBlock", "collection", "status", "category",
+        "suids", "keys", "active", "activeSector", "last", "lastSectors",
+        "displayed", "added", "updated", "selected", "deleted",
+        "isPrototypeOf", "propertyIsEnumerable", "toLocaleString",
+        "activate", "unActivate", "select", "unSelect"
+      ]
+    },
+
+    "sectorReservedKeys": {
+      "$comment": "Sector 인스턴스의 시스템 게터 이름 (public/engine/common/collection.js / const.js). 컬렉션키로 사용 시 setter 가 debug 모드에서 에러 출력 + 정상 모드에서도 값이 반영되지 않는다 (COLLECTION_ESCAPE). _SUID 는 시스템 등록 키 — Sector 인스턴스 속성으로 직접 두면 동작 깨지지만, Panel.Collection.Ckeys 의 시스템 등록 슬롯에는 반드시 포함되어야 하므로 ckeyWithSuid 변형에서만 허용.",
+      "enum": [
+        "_SUID",
+        "_mSUID",
+        "block",
+        "collection",
+        "innerBlocks",
+        "keys",
+        "status",
+        "isAdded",
+        "isUpdated",
+        "isDeleted",
+        "isSelected",
+        "isActive",
+        "isLast",
+        "outerSector",
+        "outerBlock"
+      ]
+    },
+
+    "jsReservedWords": {
+      "$comment": "JS 예약어 + 자주 쓰이는 빌트인 / 글로벌. Sector 가 점 표기법 (`_c.카테고리[n].키`) 으로 접근되므로 충돌 시 sector.length / sector.toString 등 JS 빌트인이 우선되어 동작이 깨진다. naming.md §3-5 카탈로그 기준.",
+      "enum": [
+        "break", "case", "catch", "class", "const", "continue", "debugger", "default", "delete", "do",
+        "else", "export", "extends", "finally", "for", "function", "if", "import", "in", "instanceof",
+        "new", "return", "super", "switch", "this", "throw", "try", "typeof", "var", "void", "while", "with", "yield",
+        "let", "static", "enum", "await", "async",
+        "null", "true", "false",
+        "constructor", "prototype", "length", "toString", "hasOwnProperty", "valueOf", "__proto__",
+        "Object", "Array", "String", "Number", "Boolean", "Date", "Math", "JSON", "Function", "Symbol", "RegExp"
+      ]
+    },
+
+    "ckey": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+      "description": "컬렉션키 (Sector 인스턴스 속성명). JS 식별자 규칙 + 시스템 게터 / JS 빌트인 충돌 차단. 컨벤션은 `f` 접두 + camelCase (`fName`, `fStatus`) — schema 강제 X. 운영 메타 호환을 위해 `_` 접두 변종은 별도 규칙으로 차단하지 않음 (단 시스템 게터 `_SUID`/`_mSUID` 는 차단).",
+      "not": {
+        "anyOf": [
+          { "$ref": "#/$defs/categoryReservedKeys" },
+          { "$ref": "#/$defs/sectorReservedKeys" },
+          { "$ref": "#/$defs/jsReservedWords" }
+        ]
+      }
+    },
+
+    "ckeyWithSuid": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+      "description": "Panel.Collection.Ckeys 전용 변형. `_SUID` 는 시스템 필수 등록 키이므로 허용. 그 외 시스템 게터 / JS 빌트인은 `ckey` 와 동일하게 차단.",
+      "not": {
+        "anyOf": [
+          { "$ref": "#/$defs/categoryReservedKeys" },
+          {
+            "enum": [
+              "_mSUID",
+              "block",
+              "collection",
+              "innerBlocks",
+              "keys",
+              "status",
+              "isAdded",
+              "isUpdated",
+              "isDeleted",
+              "isSelected",
+              "isActive",
+              "isLast",
+              "outerSector",
+              "outerBlock"
+            ]
+          },
+          { "$ref": "#/$defs/jsReservedWords" }
+        ]
+      }
+    },
+
+    "ckeysArray": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/ckey" },
+      "description": "컨트롤 / 자식 ComboList / 자식 List / Tab / Calendar 등의 데이터 바인딩 키 배열. 시스템 게터 / JS 빌트인 충돌 시 런타임 동작 깨짐 — schema 레벨 차단."
+    },
+
+    "ckeysArrayWithSuid": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/ckeyWithSuid" },
+      "description": "Panel.Collection.Ckeys 전용 — `_SUID` 시스템 키 허용."
+    },
+
+    "categoryName": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+      "description": "Panel.Category 의 카테고리 이름. JS 식별자 규칙 + JS 빌트인 충돌 차단 (점 표기법 `_c.카테고리.*` 로 접근). 권장 컨벤션 = `Ctg` 접두 + PascalCase (예: `CtgItemList`) — 컨벤션 자체는 schema 강제 X (validator 경고). 안티패턴 (`CtgNew*`/`CtgEdit*`/`CtgAdd*`/`CtgInsert*`) 도 schema 강제 X — 별도 카테고리 정당화 케이스 (저장 전 변환/검증) 가 있으므로 validator 경고로만.",
+      "not": {
+        "anyOf": [
+          { "$ref": "#/$defs/categoryReservedKeys" },
+          { "$ref": "#/$defs/sectorReservedKeys" },
+          { "$ref": "#/$defs/jsReservedWords" }
+        ]
+      }
+    },
+
+    "categoryNameOrEmpty": {
+      "$comment": "ParamBlock.CategoryName 등 빈 문자열 (= 컬렉션 루트 / 기본 컨텍스트) 이 의미를 갖는 위치 전용. UserData 만 사용하는 ParamBlock 등에서 빈 문자열 허용.",
+      "type": "string",
+      "anyOf": [
+        { "const": "" },
+        { "$ref": "#/$defs/categoryName" }
+      ]
+    }
+  }
+}

package/skill/schemas/node.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/node.schema.json",
+  "title": "Node",
+  "description": "Group | Control 2-union (Step은 Scenario 직속이라 여기 포함하지 않음). Group.Contents[] 의 자식으로 사용.",
+  "oneOf": [
+    {
+      "type": "object",
+      "required": ["ContentsType"],
+      "properties": {
+        "ContentsType": { "const": "Group" }
+      },
+      "$ref": "group.schema.json"
+    },
+    {
+      "type": "object",
+      "required": ["ControlType"],
+      "properties": {
+        "ControlType": { "type": "string" }
+      },
+      "$ref": "control.schema.json"
+    }
+  ]
+}

package/skill/schemas/patterns/atom/badge.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/patterns/atom/badge.schema.json",
+  "title": "pattern.atom.badge",
+  "description": "상태/카테고리 라벨용 pill 형 뱃지. Label + pill BorderRadius(999) + 라이트 배경(`var(--colorSub10)`) + Bold 텍스트. 너비는 텍스트에 맞춰 자동 fit, 높이도 텍스트 + Padding 으로 결정. color 는 의미적 5종(green/black/red/blue/gray) — FontColor 만 바뀌고 배경은 5종 모두 동일한 라이트 톤이라 인접 정보 위에 얹어도 충돌 없음. size 는 md/lg 두 단계.",
+  "x-tier": "atom",
+  "x-tags": ["badge", "tag", "status", "label", "chip"],
+  "x-related": [],
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["label", "color", "size"],
+  "properties": {
+    "label": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 20,
+      "description": "뱃지에 표시할 짧은 텍스트. 다국어 토큰 `{{key}}` / 정적 바인딩 `{=Field}` 가능."
+    },
+    "color": {
+      "type": "string",
+      "enum": ["green", "black", "red", "blue", "gray"],
+      "description": "의미 색상 (FontColor 만 매핑, 배경은 모두 동일 라이트 톤). green=긍정/완료 / black=중립 강조 / red=경고/실패 / blue=정보 / gray=비활성/보조."
+    },
+    "size": {
+      "type": "string",
+      "enum": ["md", "lg"],
+      "description": "크기. md=폰트13/패딩 4·8 / lg=폰트16/패딩 6·10."
+    },
+    "override": {
+      "type": "object",
+      "propertyNames": { "enum": ["root"] },
+      "additionalProperties": { "type": "object" },
+      "description": "(L1 escape hatch) 패턴이 노출하지 않는 raw 엔진 메타데이터를 materialized 결과 노드에 deep-merge 로 주입한다. 이 패턴은 단일 컨트롤이라 anchor 는 'root'(결과 노드 자체) 하나. 값은 해당 ControlType 에 유효한 control 레벨 필드 패치이며, 어떤 엔진 스키마에든 정의된 필드명만 검증을 통과한다(예: ControlKey, DefaultValue, 이벤트 바인딩). ★ UseMove/MoveSteps 같은 Step 이동(Group 레벨) 기능은 atom 컨트롤이 아니라 Group(molecule 의 root anchor / raw Group)에 주입한다. 배열 필드는 deep-merge 가 아니라 통째 교체된다. props 로 충분한 일반 케이스엔 쓰지 않는다.",
+      "examples": [{ "root": { "UseClickEvent": true, "Events": { "Click": "openDetail" } } }]
+    }
+  },
+  "examples": [
+    { "label": "승인", "color": "green", "size": "md" },
+    { "label": "반려", "color": "red", "size": "md" },
+    { "label": "대기", "color": "gray", "size": "md" },
+    { "label": "NEW", "color": "blue", "size": "lg" },
+    { "label": "{{공지}}", "color": "black", "size": "md" }
+  ]
+}