@flextudio/scenario 0.1.0

package/skill/schemas/bottom-buttons.schema.json

@@ -0,0 +1,134 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/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 권장.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["Id"],
+
+  "properties": {
+    "Id": {
+      "type": "string",
+      "pattern": "^f_[1-9][0-9]*$",
+      "description": "f_숫자 형식. 1부터 시작, 선행 0 불가. 시나리오 전체 유일 (validate.mjs 후검증)."
+    },
+    "ButtonName": {
+      "type": "string",
+      "description": "버튼 표시 텍스트. 다국어는 `{{키}}` 권장."
+    },
+
+    "MoveTo": {
+      "type": "string",
+      "enum": ["Next", "None", "Prev", "Prev_ReStart", "Init"],
+      "description": "Click 시 이동 동작. Next=다음 Step / None=이동 없음(이벤트만) / Prev=이전 Step / Prev_ReStart=이전 Step 재시작 / Init=시나리오 처음. (런타임 const.js MOVETYPE 참조.)"
+    },
+    "Direction": {
+      "type": "string",
+      "description": "네비게이션 방향 보조값. MoveTo='Next' 경우 canonical emit 값은 빈 문자열 `\"\"` (필요 시 'toBottom' / 'toRight' 등). 일부 분기 흐름에서만 비어있지 않은 값을 둠."
+    },
+
+    "Next": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "MoveTo='Next' 일 때 이동 대상 정의. `MoveStepOrder` 우선순위 배열 + 각 StepId 별 슬롯. 슬롯 값은 빈 문자열 `\"\"` (canonical) — Flextudio 스튜디오 emit 형태. 빈 객체 `{}` 는 잘못된 메타 (정적 분석에서 거부됨).",
+      "properties": {
+        "MoveStepOrder": {
+          "type": "array",
+          "description": "이동 후보 StepId 우선순위 배열. 첫 매칭 Step 으로 이동.",
+          "items": { "type": "string", "pattern": "^Step[1-9][0-9]*$" }
+        }
+      },
+      "patternProperties": {
+        "^Step[1-9][0-9]*$": {
+          "type": "string",
+          "$comment": "Flextudio canonical: 빈 문자열 \"\". 향후 조건/Direction 슬롯 확장 여지로 문자열 타입 유지 (객체 슬롯이 아님)."
+        }
+      }
+    },
+    "Prev": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "MoveTo='Prev' / 'Prev_ReStart' 일 때 이전 이동 정의. 보통 `{ MoveStepOrder: [] }` (빈 배열). MoveTo='Next' 인 BottomButton 에 emit 금지.",
+      "properties": {
+        "MoveStepOrder": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^Step[1-9][0-9]*$" }
+        }
+      }
+    },
+    "IsRestored": {
+      "type": "boolean",
+      "description": "콜렉션을 이전 상태로 복원할지. true=복원(취소 흐름), false=변경 유지. Flextudio 스튜디오 emit canonical 은 빈 문자열 `\"\"` (=false 와 동치)."
+    },
+    "IsIgnoreRequired": {
+      "type": "boolean",
+      "description": "MoveTo='Next' 시 필수입력 검증 무시 여부. Flextudio 스튜디오가 Next 버튼에서 canonical 로 emit (보통 false)."
+    },
+    "IsRequired": {
+      "type": "boolean",
+      "description": "MoveTo='Prev' / 'Prev_ReStart' 시 필수입력 보존 여부. Group.MoveSteps 의 동일 슬롯과 평행."
+    },
+
+    "Events": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "이벤트 핸들러 맵. 보통 `Click` 만 사용 (예: `{ \"Click\": \"saveData\" }`). UseEvents 토글 없이 등장 가능 — Click 핸들러만 두면 동작.",
+      "properties": {
+        "Click": { "type": "string", "description": "Click 시 실행할 이벤트(스크립트) 이름." }
+      }
+    },
+    "LoadScript": {
+      "type": "string",
+      "description": "버튼 렌더링 직전 실행 스크립트. 표시/숨김 동적 제어 (`f.bottom().style().display(...)` 등)."
+    },
+
+    "Width":  { "$ref": "style-objects.schema.json#/$defs/sizeObject" },
+    "Height": { "$ref": "style-objects.schema.json#/$defs/sizeObject" },
+    "Padding":{ "$ref": "style-objects.schema.json#/$defs/spacing" },
+    "Margin": { "$ref": "style-objects.schema.json#/$defs/spacing" },
+    "BgStyle":     { "$ref": "style-objects.schema.json#/$defs/bgStyle" },
+    "FontStyle":   { "$ref": "style-objects.schema.json#/$defs/fontStyle" },
+    "BorderStyle": { "$ref": "style-objects.schema.json#/$defs/borderStyle" },
+    "ImageStyle": {
+      "type": "object",
+      "$comment": "런타임(bottombuttons.js)에서 BottomButton 렌더링 시 ImageStyle 은 적용 제외. 메타에 남아있어도 시각적 효과 없음. 신규 생성 시 누락 권장."
+    },
+
+    "UseFixedSize": { "type": "boolean", "description": "부모 영역 안 고정 크기 사용 여부." },
+    "UseDesign":    { "type": "boolean", "description": "디자인(스타일) 묶음 적용 여부." }
+  },
+
+  "allOf": [
+    {
+      "$comment": "MoveTo='Next' → top-level Next 필수 (MoveStepOrder 1개 이상). top-level Prev emit 금지.",
+      "if": {
+        "properties": { "MoveTo": { "const": "Next" } },
+        "required": ["MoveTo"]
+      },
+      "then": {
+        "required": ["Next"],
+        "not": { "required": ["Prev"] },
+        "properties": {
+          "Next": {
+            "required": ["MoveStepOrder"],
+            "properties": {
+              "MoveStepOrder": { "type": "array", "minItems": 1 }
+            }
+          }
+        }
+      }
+    },
+    {
+      "$comment": "MoveTo='Prev' | 'Prev_ReStart' → top-level Prev 필수. top-level Next emit 금지.",
+      "if": {
+        "properties": { "MoveTo": { "enum": ["Prev", "Prev_ReStart"] } },
+        "required": ["MoveTo"]
+      },
+      "then": {
+        "required": ["Prev"],
+        "not": { "required": ["Next"] }
+      }
+    }
+  ]
+}