@reopt-ai/opt-ui 1.12.5 → 1.13.0

package/dist/meta.cjs

@@ -1221,6 +1221,10 @@ const coreMetas = [
 				},
 				{
 					name: "setOpen",
+					deprecated: {
+						since: "1.12.5",
+						replacement: "onOpenChange"
+					},
 					type: "(open: boolean) => void",
 					description: "제어 모드: 상태 변경 핸들러"
 				},
@@ -1298,6 +1302,10 @@ const coreMetas = [
 				},
 				{
 					name: "setSelectedId",
+					deprecated: {
+						since: "1.12.5",
+						replacement: "onSelectedIdChange"
+					},
 					type: "(id: string | null) => void",
 					description: "제어 모드: 탭 변경 핸들러"
 				}
@@ -1466,6 +1474,10 @@ const coreMetas = [
 				},
 				{
 					name: "gutter",
+					deprecated: {
+						since: "1.12.5",
+						replacement: "sideOffset"
+					},
 					type: "number",
 					default: "4",
 					description: "트리거와의 간격 (px)"
@@ -1544,6 +1556,10 @@ const coreMetas = [
 				description: "제어 모드: 열림 상태"
 			}, {
 				name: "setOpen",
+				deprecated: {
+					since: "1.12.5",
+					replacement: "onOpenChange"
+				},
 				type: "(open: boolean) => void",
 				description: "제어 모드: 상태 변경 핸들러"
 			}],
@@ -1667,6 +1683,10 @@ const coreMetas = [
 		props: {
 			ComboboxRoot: [{
 				name: "setValue",
+				deprecated: {
+					since: "1.12.5",
+					replacement: "onValueChange"
+				},
 				type: "(value: string) => void",
 				description: "입력값 변경 핸들러"
 			}, {
@@ -1708,6 +1728,10 @@ const coreMetas = [
 				},
 				{
 					name: "gutter",
+					deprecated: {
+						since: "1.12.5",
+						replacement: "sideOffset"
+					},
 					type: "number",
 					default: "4",
 					description: "입력과의 간격 (px)"
@@ -1839,6 +1863,10 @@ const coreMetas = [
 				},
 				{
 					name: "gutter",
+					deprecated: {
+						since: "1.12.5",
+						replacement: "sideOffset"
+					},
 					type: "number",
 					default: "8",
 					description: "트리거와의 간격 (px)"
@@ -2192,6 +2220,10 @@ const coreMetas = [
 				},
 				{
 					name: "gutter",
+					deprecated: {
+						since: "1.12.5",
+						replacement: "sideOffset"
+					},
 					type: "number",
 					default: "4",
 					description: "트리거와의 간격 (px)"
@@ -3949,6 +3981,10 @@ const store = useFormStore({ defaultValues: { name: "" } });
 		}],
 		props: { PopoverContent: [{
 			name: "gutter",
+			deprecated: {
+				since: "1.12.5",
+				replacement: "sideOffset"
+			},
 			type: "number",
 			default: "8",
 			description: "트리거와의 간격 (px)"
@@ -3989,6 +4025,10 @@ const store = useFormStore({ defaultValues: { name: "" } });
 		props: {
 			DropdownContent: [{
 				name: "gutter",
+				deprecated: {
+					since: "1.12.5",
+					replacement: "sideOffset"
+				},
 				type: "number",
 				default: "4",
 				description: "트리거와의 간격 (px)"
@@ -4999,6 +5039,7 @@ const MyDashboard = createBlock<MyDashboardProps>(
 		description: "페이지에 머무는 인페이지 고지. Alert와 달리 dismiss가 없고, 조건이 참인 동안 레이아웃의 일부로 남습니다.",
 		slug: "callout",
 		exports: ["Callout"],
+		ariaRole: "status",
 		props: { Callout: [
 			{
 				name: "tone",
@@ -6940,15 +6981,26 @@ const filters = [
 	{
 		name: "QueryResultsTable",
 		category: "shell",
-		description: "쿼리 결과 테이블. SQL 결과와 스크린 리더에 안내되는 로딩, 에러, 빈 상태를 지원합니다.",
+		functionalCategory: "data-display",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"query",
+			"results",
+			"grid",
+			"table",
+			"virtualized"
+		],
+		description: "쿼리 결과 테이블. 타입이 표시되는 헤더, 로컬 정렬, 컬럼 리사이즈, 행 상세 패널을 갖추고 행을 윈도잉해 만 행도 스크롤로 다룹니다. NULL·불리언·객체를 빈칸 대신 글자로 씁니다.",
 		slug: "query-results-table",
 		exports: ["QueryResultsTable"],
+		domlessExports: ["formatQueryCell"],
 		props: { QueryResultsTable: [
 			{
 				name: "columns",
-				type: "string[]",
+				type: "Array<string | QueryResultColumn>",
 				required: true,
-				description: "컬럼 이름"
+				description: "컬럼 이름, 또는 타입을 포함한 컬럼 정의"
 			},
 			{
 				name: "rows",
@@ -6956,6 +7008,12 @@ const filters = [
 				required: true,
 				description: "결과 행"
 			},
+			{
+				name: "maxHeight",
+				type: "number | \"fill\"",
+				default: "400",
+				description: "스크롤 높이(px). fill이면 부모 높이를 채움"
+			},
 			{
 				name: "loading",
 				type: "boolean",
@@ -6966,12 +7024,59 @@ const filters = [
 				type: "string",
 				description: "assertive 오류 상태"
 			},
+			{
+				name: "sortable",
+				type: "boolean",
+				default: "true",
+				description: "헤더 클릭 정렬"
+			},
+			{
+				name: "sort",
+				type: "QueryResultSort | null",
+				description: "제어형 정렬 상태"
+			},
+			{
+				name: "onSortChange",
+				type: "(sort: QueryResultSort | null) => void",
+				description: "정렬 변경"
+			},
+			{
+				name: "rowHeight",
+				type: "number",
+				default: "32",
+				description: "행 높이(px). 윈도잉의 기준"
+			},
+			{
+				name: "rowDetails",
+				type: "boolean",
+				default: "true",
+				description: "행을 상세 패널로 열기"
+			},
+			{
+				name: "footer",
+				type: "ReactNode",
+				description: "행 수 뒤에 붙는 푸터 내용 — 경과 시간, 읽은 바이트"
+			},
 			{
 				name: "labels",
 				type: "QueryResultsTableLabels",
-				description: "로딩/빈 상태/행 수 문구"
+				description: "로딩/빈 상태/행 수/정렬/상세 문구"
 			}
 		] },
+		dependencies: [
+			{
+				slug: "field-token",
+				category: "core"
+			},
+			{
+				slug: "flyout",
+				category: "shell"
+			},
+			{
+				slug: "description-list",
+				category: "core"
+			}
+		],
 		testDescribe: "QueryResultsTable"
 	},
 	{
@@ -7011,12 +7116,12 @@ const filters = [
 			},
 			{
 				name: "onRun",
-				type: "(sql: string) => void",
-				description: "Mod+Enter 실행 핸들러"
+				type: "(sql: string, context: SqlEditorRunContext) => void",
+				description: "Mod+Enter 실행 핸들러. 두 번째 인자로 선택 영역과 커서 위치"
 			},
 			{
 				name: "onRunAndAdvance",
-				type: "(sql: string) => void",
+				type: "(sql: string, context: SqlEditorRunContext) => void",
 				description: "Shift+Enter — 실행 후 다음 셀/탭으로 이동"
 			},
 			{
@@ -7069,6 +7174,18 @@ const filters = [
 				type: "boolean",
 				description: "실행 힌트/버튼 표시. 기본값은 onRun이 있을 때 표시"
 			},
+			{
+				name: "lineNumbers",
+				type: "boolean",
+				default: "true",
+				description: "줄 번호 거터"
+			},
+			{
+				name: "theme",
+				type: "SqlEditorTheme",
+				default: "\"auto\"",
+				description: "편집기 색상. auto는 OptThemeProvider의 resolved mode를 따름"
+			},
 			{
 				name: "labels",
 				type: "SqlEditorLabels",
@@ -9881,6 +9998,778 @@ const messages = [
 			avoid: ["선택 초기화를 호출자에게 맡기지 않습니다 — 보이지 않는 행에 일괄 작업이 적용됩니다."]
 		},
 		testDescribe: "CatalogFrame"
+	},
+	{
+		name: "SchemaTree",
+		category: "shell",
+		functionalCategory: "navigation",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"schema",
+			"tables",
+			"columns",
+			"tree",
+			"autocomplete"
+		],
+		description: "쿼리할 수 있는 테이블과 컬럼을 타입 글리프와 함께 보여주는 트리. 테이블·컬럼을 함께 검색하고, 이름을 커서에 삽입하거나 테이블을 미리보기합니다.",
+		slug: "schema-tree",
+		exports: ["SchemaTree"],
+		props: { SchemaTree: [
+			{
+				name: "tables",
+				type: "SchemaTreeTable[]",
+				required: true,
+				description: "테이블과 컬럼"
+			},
+			{
+				name: "loading",
+				type: "boolean",
+				description: "스키마 조회 중"
+			},
+			{
+				name: "defaultExpanded",
+				type: "string[]",
+				description: "처음에 펼칠 테이블. 생략 시 첫 테이블"
+			},
+			{
+				name: "onInsert",
+				type: "(name: string, kind: \"table\" | \"column\", table: string) => void",
+				description: "이름을 편집기 커서에 삽입"
+			},
+			{
+				name: "onPreview",
+				type: "(table: string) => void",
+				description: "테이블 미리보기 실행. SQL은 호출자가 작성"
+			},
+			{
+				name: "header",
+				type: "ReactNode",
+				description: "검색창 위 내용"
+			},
+			{
+				name: "labels",
+				type: "SchemaTreeLabels",
+				description: "문구 오버라이드"
+			}
+		] },
+		dependencies: [{
+			slug: "field-token",
+			category: "core"
+		}, {
+			slug: "highlight",
+			category: "core"
+		}],
+		ariaRole: "complementary",
+		testDescribe: "SchemaTree"
+	},
+	{
+		name: "QueryToolbar",
+		category: "shell",
+		functionalCategory: "action",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"run",
+			"cancel",
+			"toolbar",
+			"shortcut"
+		],
+		description: "실행 버튼 하나가 상태를 말하는 쿼리 툴바. 변경됨/현재/실행 중을 색과 문구로 구분하고, 실행 중이면 취소로 바뀌며, 선택 영역·전체 실행은 분할 버튼 뒤에 둡니다.",
+		slug: "query-toolbar",
+		exports: ["QueryToolbar"],
+		props: { QueryToolbar: [
+			{
+				name: "onRun",
+				type: "() => void",
+				required: true,
+				description: "커서 위치의 문장 실행"
+			},
+			{
+				name: "onCancel",
+				type: "() => void",
+				description: "실행 중 취소. 있으면 버튼이 Cancel로 전환"
+			},
+			{
+				name: "running",
+				type: "boolean",
+				description: "실행 중"
+			},
+			{
+				name: "runState",
+				type: "QueryRunState",
+				default: "\"idle\"",
+				description: "마지막 실행 대비 변경 여부"
+			},
+			{
+				name: "runDisabledReason",
+				type: "string",
+				description: "실행 불가 사유. 툴팁으로 표시"
+			},
+			{
+				name: "onRunSelection",
+				type: "() => void",
+				description: "선택 영역만 실행"
+			},
+			{
+				name: "hasSelection",
+				type: "boolean",
+				description: "선택 영역이 있는지. 없으면 항목 비활성"
+			},
+			{
+				name: "onRunAll",
+				type: "() => void",
+				description: "전체 문장 실행"
+			},
+			{
+				name: "multiStatement",
+				type: "boolean",
+				description: "문장이 둘 이상인지. 아니면 전체 실행을 숨김"
+			},
+			{
+				name: "onSave",
+				type: "() => void",
+				description: "저장 다이얼로그 열기"
+			},
+			{
+				name: "saveDisabled",
+				type: "boolean",
+				description: "저장 비활성"
+			},
+			{
+				name: "children",
+				type: "ReactNode",
+				description: "실행 그룹 뒤의 컨트롤 — 필터, 변수"
+			},
+			{
+				name: "trailing",
+				type: "ReactNode",
+				description: "끝쪽 컨트롤"
+			},
+			{
+				name: "modifierKey",
+				type: "string",
+				description: "단축키 힌트의 수정자 글리프. 기본은 플랫폼 감지"
+			},
+			{
+				name: "labels",
+				type: "QueryToolbarLabels",
+				description: "문구 오버라이드"
+			}
+		] },
+		dependencies: [
+			{
+				slug: "button",
+				category: "core"
+			},
+			{
+				slug: "kbd",
+				category: "core"
+			},
+			{
+				slug: "dropdown-menu",
+				category: "core"
+			}
+		],
+		ariaRole: "toolbar",
+		testDescribe: "QueryToolbar"
+	},
+	{
+		name: "QueryOutputPane",
+		category: "shell",
+		functionalCategory: "data-display",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"results",
+			"chart",
+			"split",
+			"status bar"
+		],
+		description: "쿼리 결과가 놓이는 출력 패널. 대기·실행 중·오류·취소·완료 상태를 그리고, 완료는 표·차트·좌우 분할로 전환하며, 상태바에 행 수·경과·읽은 바이트·절단 여부를 남깁니다.",
+		slug: "query-output-pane",
+		exports: ["QueryOutputPane"],
+		props: { QueryOutputPane: [
+			{
+				name: "view",
+				type: "QueryOutputView",
+				required: true,
+				description: "표 / 차트 / 분할"
+			},
+			{
+				name: "onViewChange",
+				type: "(view: QueryOutputView) => void",
+				required: true,
+				description: "뷰 전환"
+			},
+			{
+				name: "results",
+				type: "ReactNode",
+				required: true,
+				description: "결과 테이블"
+			},
+			{
+				name: "chart",
+				type: "ReactNode",
+				description: "차트 빌더. 없으면 차트 뷰를 숨김"
+			},
+			{
+				name: "status",
+				type: "\"idle\" | \"running\" | \"success\" | \"error\" | \"cancelled\"",
+				required: true,
+				description: "실행 수명주기"
+			},
+			{
+				name: "error",
+				type: "string",
+				description: "백엔드 오류 원문"
+			},
+			{
+				name: "runningSeconds",
+				type: "number",
+				description: "실행 경과 초. 로딩 상태에 표시"
+			},
+			{
+				name: "onCancel",
+				type: "() => void",
+				description: "실행 취소"
+			},
+			{
+				name: "stats",
+				type: "QueryRunStats",
+				description: "행 수, 경과, 읽은 바이트, 절단 여부"
+			},
+			{
+				name: "actions",
+				type: "ReactNode",
+				description: "뷰 전환 오른쪽 컨트롤"
+			},
+			{
+				name: "statusExtra",
+				type: "ReactNode",
+				description: "상태바 추가 내용"
+			},
+			{
+				name: "banner",
+				type: "ReactNode",
+				description: "출력 위 알림"
+			},
+			{
+				name: "onRetry",
+				type: "() => void",
+				description: "오류 상태 닫기"
+			},
+			{
+				name: "labels",
+				type: "QueryOutputPaneLabels",
+				description: "문구 오버라이드"
+			}
+		] },
+		dependencies: [
+			{
+				slug: "segmented-control",
+				category: "core"
+			},
+			{
+				slug: "empty-state",
+				category: "core"
+			},
+			{
+				slug: "resizable",
+				category: "core"
+			}
+		],
+		ariaRole: "region",
+		testDescribe: "QueryOutputPane"
+	},
+	{
+		name: "QueryResultChart",
+		category: "shell",
+		functionalCategory: "data-display",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"chart",
+			"visualization",
+			"line",
+			"bar",
+			"pie",
+			"number"
+		],
+		description: "결과 행을 차트로 그리는 빌더. 첫 문자·날짜 컬럼을 축으로, 숫자 컬럼을 값으로 고르고, 한 행 한 숫자면 큰 숫자로 보여줍니다. 설정은 호출자가 들고 있어 저장 쿼리와 함께 보관됩니다.",
+		slug: "query-result-chart",
+		exports: ["QueryResultChart"],
+		domlessExports: ["defaultQueryChartConfig", "numericResultColumns"],
+		props: { QueryResultChart: [
+			{
+				name: "columns",
+				type: "QueryResultColumn[]",
+				required: true,
+				description: "결과 컬럼"
+			},
+			{
+				name: "rows",
+				type: "Array<Record<string, unknown>>",
+				required: true,
+				description: "결과 행"
+			},
+			{
+				name: "config",
+				type: "QueryChartConfig",
+				required: true,
+				description: "차트 종류, 축, 값 컬럼"
+			},
+			{
+				name: "onConfigChange",
+				type: "(config: QueryChartConfig) => void",
+				required: true,
+				description: "설정 변경"
+			},
+			{
+				name: "showControls",
+				type: "boolean",
+				default: "true",
+				description: "컨트롤 표시. 임베드 카드에서는 끔"
+			},
+			{
+				name: "height",
+				type: "number",
+				description: "차트 높이(px). 기본은 부모 채움"
+			},
+			{
+				name: "maxPoints",
+				type: "number",
+				default: "1000",
+				description: "차트에 그릴 최대 행 수"
+			},
+			{
+				name: "labels",
+				type: "QueryResultChartLabels",
+				description: "문구 오버라이드"
+			}
+		] },
+		dependencies: [
+			{
+				slug: "line-chart",
+				category: "visuals"
+			},
+			{
+				slug: "bar-chart",
+				category: "visuals"
+			},
+			{
+				slug: "area-chart",
+				category: "visuals"
+			},
+			{
+				slug: "pie-chart",
+				category: "visuals"
+			},
+			{
+				slug: "segmented-control",
+				category: "core"
+			},
+			{
+				slug: "select",
+				category: "core"
+			}
+		],
+		testDescribe: "QueryResultChart"
+	},
+	{
+		name: "QueryFiltersMenu",
+		category: "shell",
+		functionalCategory: "input",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"filters",
+			"date range",
+			"placeholder",
+			"where"
+		],
+		description: "기간과 속성 조건을 데이터로 들고 {filters} 플레이스홀더로 SQL에 전달하는 메뉴. 플레이스홀더가 없으면 조건이 적용되지 않는다고 경고하고 삽입 버튼을 제공합니다.",
+		slug: "query-filters-menu",
+		exports: ["QueryFiltersMenu"],
+		domlessExports: [
+			"EMPTY_QUERY_FILTERS",
+			"VALUELESS_OPERATORS",
+			"hasActiveQueryFilters",
+			"countActiveQueryFilters"
+		],
+		props: { QueryFiltersMenu: [
+			{
+				name: "value",
+				type: "QueryFilters",
+				required: true,
+				description: "기간과 속성 필터"
+			},
+			{
+				name: "onChange",
+				type: "(filters: QueryFilters) => void",
+				required: true,
+				description: "필터 변경"
+			},
+			{
+				name: "fields",
+				type: "QueryFilterField[]",
+				required: true,
+				description: "필드 선택지"
+			},
+			{
+				name: "placeholderPresent",
+				type: "boolean",
+				description: "SQL에 {filters}가 있는지"
+			},
+			{
+				name: "onInsertPlaceholder",
+				type: "() => void",
+				description: "{filters}를 커서에 삽입"
+			},
+			{
+				name: "onLoadValues",
+				type: "(field: string) => Promise<string[]>",
+				description: "필드의 알려진 값. 값 입력란의 제안으로 쓰이며 자유 입력도 허용"
+			},
+			{
+				name: "presets",
+				type: "DateRangePreset[]",
+				description: "기간 프리셋"
+			},
+			{
+				name: "disabled",
+				type: "boolean",
+				description: "비활성"
+			},
+			{
+				name: "labels",
+				type: "QueryFiltersMenuLabels",
+				description: "문구 오버라이드"
+			}
+		] },
+		dependencies: [
+			{
+				slug: "popover",
+				category: "core"
+			},
+			{
+				slug: "date-range-picker",
+				category: "core"
+			},
+			{
+				slug: "select",
+				category: "core"
+			},
+			{
+				slug: "combobox",
+				category: "core"
+			},
+			{
+				slug: "callout",
+				category: "core"
+			}
+		],
+		testDescribe: "QueryFiltersMenu"
+	},
+	{
+		name: "QueryVariablesMenu",
+		category: "shell",
+		functionalCategory: "input",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"variables",
+			"parameters",
+			"placeholder"
+		],
+		description: "실행마다 바뀌는 값을 이름 붙여 두는 변수 메뉴. SQL은 {variables.name}으로 참조하고 치환은 호출자가 합니다.",
+		slug: "query-variables-menu",
+		exports: ["QueryVariablesMenu"],
+		domlessExports: ["isValidQueryVariableName"],
+		props: { QueryVariablesMenu: [
+			{
+				name: "value",
+				type: "QueryVariable[]",
+				required: true,
+				description: "변수 목록"
+			},
+			{
+				name: "onChange",
+				type: "(variables: QueryVariable[]) => void",
+				required: true,
+				description: "변수 변경"
+			},
+			{
+				name: "onInsert",
+				type: "(name: string) => void",
+				description: "{variables.name}을 커서에 삽입"
+			},
+			{
+				name: "disabled",
+				type: "boolean",
+				description: "비활성"
+			},
+			{
+				name: "disabledReason",
+				type: "string",
+				description: "비활성 사유. 툴팁으로 표시"
+			},
+			{
+				name: "labels",
+				type: "QueryVariablesMenuLabels",
+				description: "문구 오버라이드"
+			}
+		] },
+		dependencies: [{
+			slug: "popover",
+			category: "core"
+		}, {
+			slug: "input",
+			category: "core"
+		}],
+		testDescribe: "QueryVariablesMenu"
+	},
+	{
+		name: "QueryHistoryList",
+		category: "shell",
+		functionalCategory: "data-display",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"history",
+			"recent",
+			"rerun"
+		],
+		description: "실행 이력 목록. 각 실행의 성공/실패, 시각, 행 수, 경과를 보여주고 편집기로 되돌리거나 다시 실행합니다.",
+		slug: "query-history-list",
+		exports: ["QueryHistoryList"],
+		props: { QueryHistoryList: [
+			{
+				name: "items",
+				type: "QueryHistoryItem[]",
+				required: true,
+				description: "최근 실행부터"
+			},
+			{
+				name: "loading",
+				type: "boolean",
+				description: "이력 조회 중"
+			},
+			{
+				name: "onLoad",
+				type: "(item: QueryHistoryItem) => void",
+				description: "쿼리를 편집기로"
+			},
+			{
+				name: "onRerun",
+				type: "(item: QueryHistoryItem) => void",
+				description: "그대로 다시 실행"
+			},
+			{
+				name: "onClear",
+				type: "() => void",
+				description: "이력 비우기"
+			},
+			{
+				name: "header",
+				type: "ReactNode",
+				description: "목록 위 내용"
+			},
+			{
+				name: "labels",
+				type: "QueryHistoryListLabels",
+				description: "문구 오버라이드"
+			}
+		] },
+		dependencies: [{
+			slug: "button",
+			category: "core"
+		}],
+		ariaRole: "region",
+		testDescribe: "QueryHistoryList"
+	},
+	{
+		name: "SaveQueryDialog",
+		category: "shell",
+		functionalCategory: "overlay",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"save",
+			"dialog",
+			"saved query"
+		],
+		description: "쿼리에 이름·설명·공개 여부를 붙여 저장하는 다이얼로그. 편집기에 문장이 여럿이면 어느 문장을 저장할지 넘겨 보며 고릅니다.",
+		slug: "save-query-dialog",
+		exports: ["SaveQueryDialog"],
+		props: { SaveQueryDialog: [
+			{
+				name: "open",
+				type: "boolean",
+				required: true,
+				description: "열림"
+			},
+			{
+				name: "onOpenChange",
+				type: "(open: boolean) => void",
+				required: true,
+				description: "열림 상태 변경"
+			},
+			{
+				name: "onSubmit",
+				type: "(values: SaveQueryValues) => void | Promise<void>",
+				required: true,
+				description: "저장"
+			},
+			{
+				name: "candidates",
+				type: "string[]",
+				required: true,
+				description: "저장할 SQL 후보. 문장이 여럿이면 여러 개"
+			},
+			{
+				name: "initialCandidate",
+				type: "number",
+				default: "0",
+				description: "처음 보여줄 후보"
+			},
+			{
+				name: "candidateIsSelection",
+				type: "boolean",
+				description: "후보가 선택 영역인지"
+			},
+			{
+				name: "initialValues",
+				type: "Partial<Omit<SaveQueryValues, \"sql\">>",
+				description: "기존 저장 쿼리를 수정할 때의 초기값"
+			},
+			{
+				name: "mode",
+				type: "\"create\" | \"update\"",
+				default: "\"create\"",
+				description: "새로 저장 / 수정"
+			},
+			{
+				name: "saving",
+				type: "boolean",
+				description: "저장 중"
+			},
+			{
+				name: "error",
+				type: "string",
+				description: "저장 실패 메시지"
+			},
+			{
+				name: "labels",
+				type: "SaveQueryDialogLabels",
+				description: "문구 오버라이드"
+			}
+		] },
+		dependencies: [
+			{
+				slug: "dialog",
+				category: "core"
+			},
+			{
+				slug: "input",
+				category: "core"
+			},
+			{
+				slug: "textarea",
+				category: "core"
+			},
+			{
+				slug: "switch",
+				category: "core"
+			}
+		],
+		ariaRole: "dialog",
+		testDescribe: "SaveQueryDialog"
+	},
+	{
+		name: "QueryWorkspace",
+		category: "shell",
+		functionalCategory: "layout",
+		maturity: "stable",
+		keywords: [
+			"sql",
+			"workspace",
+			"layout",
+			"resizable",
+			"sidebar"
+		],
+		description: "스키마·편집기·출력의 3-pane 쿼리 워크스페이스. 패널은 리사이즈되고 사이드바는 접히며, storageKey로 레이아웃을 기억합니다. 툴바·편집기·출력은 슬롯입니다.",
+		slug: "query-workspace",
+		exports: ["QueryWorkspace"],
+		props: { QueryWorkspace: [
+			{
+				name: "sidebar",
+				type: "ReactNode",
+				description: "왼쪽 패널 내용"
+			},
+			{
+				name: "sidebarOpen",
+				type: "boolean",
+				description: "제어형 사이드바 열림"
+			},
+			{
+				name: "onSidebarOpenChange",
+				type: "(open: boolean) => void",
+				description: "사이드바 열림 변경"
+			},
+			{
+				name: "header",
+				type: "ReactNode",
+				description: "툴바 위 — 탭이나 페이지 헤더"
+			},
+			{
+				name: "toolbar",
+				type: "ReactNode",
+				description: "툴바"
+			},
+			{
+				name: "editor",
+				type: "ReactNode",
+				required: true,
+				description: "편집기"
+			},
+			{
+				name: "output",
+				type: "ReactNode",
+				required: true,
+				description: "출력"
+			},
+			{
+				name: "storageKey",
+				type: "string",
+				description: "패널 크기를 localStorage에 기억할 키"
+			},
+			{
+				name: "defaultSidebarSize",
+				type: "number",
+				default: "22",
+				description: "사이드바 폭(%)"
+			},
+			{
+				name: "defaultEditorSize",
+				type: "number",
+				default: "40",
+				description: "편집기 높이(%)"
+			},
+			{
+				name: "labels",
+				type: "QueryWorkspaceLabels",
+				description: "문구 오버라이드"
+			}
+		] },
+		dependencies: [{
+			slug: "resizable",
+			category: "core"
+		}, {
+			slug: "button",
+			category: "core"
+		}],
+		testDescribe: "QueryWorkspace"
 	}
 ];
 //#endregion