@reopt-ai/opt-ui 1.12.0 → 1.12.2

package/dist/meta.cjs

@@ -3,7 +3,7 @@ const coreMetas = [
 	{
 		name: "FieldToken",
 		category: "core",
-		description: "필드 타입을 글리프 하나로 표현하는 토큰. 문자열·숫자·날짜·IP·지오 등 분석 스키마 타입마다 고정된 아이콘과 팔레트 슬롯을 부여해 필드 목록·컬럼 헤더·속성 테이블 전역에서 같은 어휘를 쓴다.",
+		description: "필드 타입을 일관된 글리프와 선택적 텍스트 레이블로 표현합니다. 문자열·숫자·날짜·IP·지오 등 분석 스키마 타입마다 같은 아이콘과 팔레트 슬롯을 씁니다.",
 		slug: "field-token",
 		exports: [
 			"FieldToken",
@@ -46,6 +46,17 @@ const coreMetas = [
 				default: "false",
 				description: "인접 텍스트가 타입을 이미 말할 때 접근성 트리에서 제외"
 			},
+			{
+				name: "withLabel",
+				type: "boolean",
+				default: "false",
+				description: "글리프 옆에 타입 이름을 함께 표시"
+			},
+			{
+				name: "label",
+				type: "string",
+				description: "withLabel이 표시할 문구. 기본값은 타입 이름"
+			},
 			{
 				name: "className",
 				type: "string",
@@ -5056,11 +5067,11 @@ const MyDashboard = createBlock<MyDashboardProps>(
 			{
 				name: "hint",
 				type: "string",
-				description: "판정 기준 툴팁"
+				description: "판정 기준. 호버·키보드 포커스로 열리는 툴팁이며, 지정하면 이 항목이 탭 정지점이 됩니다"
 			}
 		] },
 		usage: {
-			bestPractices: ["표의 상태 컬럼처럼 행마다 반복되는 자리에 씁니다. 점은 장식이고 의미는 텍스트가 담습니다."],
+			bestPractices: ["표의 상태 컬럼처럼 행마다 반복되는 자리에 씁니다. 점은 장식이고 의미는 텍스트가 담습니다.", "hint는 행마다 탭 정지점을 하나 늘립니다. 알아야 행동할 수 있는 규칙이면 툴팁이 아니라 상태 옆 텍스트에 씁니다."],
 			avoid: ["사람이 붙인 라벨(태그, 카테고리)에는 Badge를 씁니다. StatusDot은 관측된 상태용입니다."]
 		},
 		testDescribe: "StatusDot"
@@ -5157,6 +5168,11 @@ const MyDashboard = createBlock<MyDashboardProps>(
 				type: "string",
 				required: true,
 				description: "radiogroup 이름. 필수"
+			},
+			{
+				name: "className",
+				type: "string",
+				description: "추가 CSS 클래스"
 			}
 		] },
 		usage: {
@@ -5767,7 +5783,7 @@ const fields = [
 	{
 		name: "DataTable",
 		category: "shell",
-		description: "제네릭 데이터 테이블. 동적 컬럼, 결측값 안전 정렬, 키보드 컬럼 리사이즈, 보정된 인라인 진행률과 Composite 탐색을 지원합니다.",
+		description: "제네릭 데이터 테이블. 제목은 opt-in이고 ariaLabel로 grid를 이름 붙이며, 동적 컬럼·안전 정렬·키보드 리사이즈·Composite 탐색을 지원합니다.",
 		slug: "data-table",
 		exports: ["DataTable"],
 		keyboardShortcuts: [
@@ -5835,8 +5851,12 @@ const fields = [
 				{
 					name: "title",
 					type: "string",
-					default: "\"데이터 테이블\"",
-					description: "테이블 제목"
+					description: "테이블 위에 표시할 제목. 생략하면 제목 영역을 렌더하지 않음"
+				},
+				{
+					name: "ariaLabel",
+					type: "string",
+					description: "보이는 제목이 없을 때 grid에 제공할 접근 가능한 이름"
 				},
 				{
 					name: "onRowClick",
@@ -5846,7 +5866,7 @@ const fields = [
 				{
 					name: "emptyMessage",
 					type: "string",
-					default: "\"데이터가 없습니다\"",
+					default: "\"No data available\"",
 					description: "데이터 없을 때 표시할 메시지"
 				}
 			],
@@ -6820,10 +6840,78 @@ const filters = [
 	{
 		name: "PropertyExplorer",
 		category: "shell",
-		description: "프로퍼티 탐색기. 검색 가능한 속성 목록을 그룹별로 표시합니다.",
+		description: "검색 가능한 속성 목록을 그룹별로 표시하고, 숨김 상태와 호출자 소유의 명시적인 편집 액션을 함께 제공합니다.",
 		slug: "property-explorer",
 		exports: ["PropertyExplorer"],
-		props: {},
+		props: {
+			PropertyExplorer: [
+				{
+					name: "groups",
+					type: "PropertyGroup[]",
+					required: true,
+					description: "그룹별 속성 목록. 각 속성은 dataType과 hidden 상태를 포함 가능"
+				},
+				{
+					name: "onSelect",
+					type: "(property: PropertyDef) => void",
+					description: "속성 선택"
+				},
+				{
+					name: "onEdit",
+					type: "(property: PropertyDef) => void",
+					description: "행에 명시적인 편집 버튼을 표시하고 선택한 속성을 전달"
+				},
+				{
+					name: "className",
+					type: "string",
+					description: "추가 CSS 클래스"
+				},
+				{
+					name: "labels",
+					type: "PropertyExplorerLabels",
+					description: "검색·빈 상태·편집·숨김 문구"
+				}
+			],
+			PropertyDef: [
+				{
+					name: "name",
+					type: "string",
+					required: true,
+					description: "속성 이름"
+				},
+				{
+					name: "type",
+					type: "string",
+					required: true,
+					description: "원본 스키마 타입"
+				},
+				{
+					name: "dataType",
+					type: "FieldDataType",
+					description: "호출자가 이미 판정한 opt-ui 필드 타입"
+				},
+				{
+					name: "description",
+					type: "string",
+					description: "속성 설명"
+				},
+				{
+					name: "exampleValue",
+					type: "string",
+					description: "예시 값"
+				},
+				{
+					name: "eventCount",
+					type: "number",
+					description: "관측 이벤트 수"
+				},
+				{
+					name: "hidden",
+					type: "boolean",
+					description: "피커에서는 숨기되 탐색기에서는 흐리게 표시할 상태"
+				}
+			]
+		},
 		dependencies: [{
 			slug: "input",
 			category: "core"
@@ -6982,10 +7070,74 @@ const filters = [
 	{
 		name: "EventMetaEditor",
 		category: "shell",
-		description: "이벤트 메타 에디터. 레이블이 연결된 IconPicker + ColorPicker + TagInput 조합으로 이벤트 메타데이터를 편집합니다.",
+		description: "기본 이벤트 메타와 호출자 소유 섹션을 한 폼에서 편집하고, footer의 한 액션으로 함께 저장할 수 있습니다.",
 		slug: "event-meta-editor",
 		exports: ["EventMetaEditor"],
-		props: {},
+		props: {
+			EventMetaEditor: [
+				{
+					name: "value",
+					type: "EventMeta",
+					required: true,
+					description: "편집 중인 이벤트 메타데이터"
+				},
+				{
+					name: "onChange",
+					type: "(meta: EventMeta) => void",
+					required: true,
+					description: "메타데이터 변경"
+				},
+				{
+					name: "icons",
+					type: "IconDef[]",
+					description: "선택 가능한 아이콘"
+				},
+				{
+					name: "sections",
+					type: "EventMetaEditorSection[]",
+					description: "기본 여섯 필드 뒤에 렌더할 호출자 소유 섹션"
+				},
+				{
+					name: "footer",
+					type: "ReactNode",
+					description: "내장 필드와 추가 섹션을 함께 저장하는 마지막 액션 영역"
+				},
+				{
+					name: "className",
+					type: "string",
+					description: "추가 CSS 클래스"
+				},
+				{
+					name: "labels",
+					type: "EventMetaEditorLabels",
+					description: "필드 레이블과 placeholder 문구"
+				}
+			],
+			EventMetaEditorSection: [
+				{
+					name: "id",
+					type: "string",
+					required: true,
+					description: "섹션 키"
+				},
+				{
+					name: "title",
+					type: "ReactNode",
+					description: "섹션 제목"
+				},
+				{
+					name: "description",
+					type: "ReactNode",
+					description: "섹션 변경이 미치는 영향 안내"
+				},
+				{
+					name: "children",
+					type: "ReactNode",
+					required: true,
+					description: "호출자가 소유하는 필드"
+				}
+			]
+		},
 		dependencies: [
 			{
 				slug: "input",
@@ -9369,6 +9521,16 @@ const messages = [
 				type: "\"sm\" | \"md\" | \"lg\"",
 				default: "\"md\"",
 				description: "push 레이아웃에서의 인스펙터 폭"
+			},
+			{
+				name: "labels",
+				type: "InspectorLayoutLabels",
+				description: "닫기 버튼 등 인스펙터 문구"
+			},
+			{
+				name: "className",
+				type: "string",
+				description: "추가 CSS 클래스"
 			}
 		] },
 		usage: {
@@ -9434,6 +9596,16 @@ const messages = [
 				name: "queryBarLabels",
 				type: "QueryBarLabels",
 				description: "QueryBar로 통과되는 나머지 문구. placeholder/ariaLabel은 labels가 이깁니다"
+			},
+			{
+				name: "labels",
+				type: "QueryFilterBarLabels",
+				description: "검색·필터·초기화 문구"
+			},
+			{
+				name: "className",
+				type: "string",
+				description: "추가 CSS 클래스"
 			}
 		] },
 		usage: {
@@ -9616,6 +9788,11 @@ const messages = [
 					name: "labels",
 					type: "CatalogFrameLabels",
 					description: "빈/필터된 빈/에러 문구"
+				},
+				{
+					name: "className",
+					type: "string",
+					description: "추가 CSS 클래스"
 				}
 			],
 			CatalogRowActions: [
@@ -9643,6 +9820,36 @@ const messages = [
 					description: "그룹·오버플로 라벨"
 				}
 			],
+			CatalogRowAction: [
+				{
+					name: "id",
+					type: "string",
+					required: true,
+					description: "액션 키"
+				},
+				{
+					name: "label",
+					type: "string",
+					required: true,
+					description: "액션 문구"
+				},
+				{
+					name: "icon",
+					type: "ReactNode",
+					description: "선택적 액션 아이콘"
+				},
+				{
+					name: "onSelect",
+					type: "(item: T) => void",
+					required: true,
+					description: "행과 함께 호출되는 액션"
+				},
+				{
+					name: "available",
+					type: "(item: T) => boolean",
+					description: "이 행에 적용되지 않는 액션을 비활성화 대신 제거"
+				}
+			],
 			CatalogCellControls: [{
 				name: "children",
 				type: "ReactNode",

package/dist/meta.js

@@ -2,7 +2,7 @@ const coreMetas = [
 	{
 		name: "FieldToken",
 		category: "core",
-		description: "필드 타입을 글리프 하나로 표현하는 토큰. 문자열·숫자·날짜·IP·지오 등 분석 스키마 타입마다 고정된 아이콘과 팔레트 슬롯을 부여해 필드 목록·컬럼 헤더·속성 테이블 전역에서 같은 어휘를 쓴다.",
+		description: "필드 타입을 일관된 글리프와 선택적 텍스트 레이블로 표현합니다. 문자열·숫자·날짜·IP·지오 등 분석 스키마 타입마다 같은 아이콘과 팔레트 슬롯을 씁니다.",
 		slug: "field-token",
 		exports: [
 			"FieldToken",
@@ -45,6 +45,17 @@ const coreMetas = [
 				default: "false",
 				description: "인접 텍스트가 타입을 이미 말할 때 접근성 트리에서 제외"
 			},
+			{
+				name: "withLabel",
+				type: "boolean",
+				default: "false",
+				description: "글리프 옆에 타입 이름을 함께 표시"
+			},
+			{
+				name: "label",
+				type: "string",
+				description: "withLabel이 표시할 문구. 기본값은 타입 이름"
+			},
 			{
 				name: "className",
 				type: "string",
@@ -5055,11 +5066,11 @@ const MyDashboard = createBlock<MyDashboardProps>(
 			{
 				name: "hint",
 				type: "string",
-				description: "판정 기준 툴팁"
+				description: "판정 기준. 호버·키보드 포커스로 열리는 툴팁이며, 지정하면 이 항목이 탭 정지점이 됩니다"
 			}
 		] },
 		usage: {
-			bestPractices: ["표의 상태 컬럼처럼 행마다 반복되는 자리에 씁니다. 점은 장식이고 의미는 텍스트가 담습니다."],
+			bestPractices: ["표의 상태 컬럼처럼 행마다 반복되는 자리에 씁니다. 점은 장식이고 의미는 텍스트가 담습니다.", "hint는 행마다 탭 정지점을 하나 늘립니다. 알아야 행동할 수 있는 규칙이면 툴팁이 아니라 상태 옆 텍스트에 씁니다."],
 			avoid: ["사람이 붙인 라벨(태그, 카테고리)에는 Badge를 씁니다. StatusDot은 관측된 상태용입니다."]
 		},
 		testDescribe: "StatusDot"
@@ -5156,6 +5167,11 @@ const MyDashboard = createBlock<MyDashboardProps>(
 				type: "string",
 				required: true,
 				description: "radiogroup 이름. 필수"
+			},
+			{
+				name: "className",
+				type: "string",
+				description: "추가 CSS 클래스"
 			}
 		] },
 		usage: {
@@ -5766,7 +5782,7 @@ const fields = [
 	{
 		name: "DataTable",
 		category: "shell",
-		description: "제네릭 데이터 테이블. 동적 컬럼, 결측값 안전 정렬, 키보드 컬럼 리사이즈, 보정된 인라인 진행률과 Composite 탐색을 지원합니다.",
+		description: "제네릭 데이터 테이블. 제목은 opt-in이고 ariaLabel로 grid를 이름 붙이며, 동적 컬럼·안전 정렬·키보드 리사이즈·Composite 탐색을 지원합니다.",
 		slug: "data-table",
 		exports: ["DataTable"],
 		keyboardShortcuts: [
@@ -5834,8 +5850,12 @@ const fields = [
 				{
 					name: "title",
 					type: "string",
-					default: "\"데이터 테이블\"",
-					description: "테이블 제목"
+					description: "테이블 위에 표시할 제목. 생략하면 제목 영역을 렌더하지 않음"
+				},
+				{
+					name: "ariaLabel",
+					type: "string",
+					description: "보이는 제목이 없을 때 grid에 제공할 접근 가능한 이름"
 				},
 				{
 					name: "onRowClick",
@@ -5845,7 +5865,7 @@ const fields = [
 				{
 					name: "emptyMessage",
 					type: "string",
-					default: "\"데이터가 없습니다\"",
+					default: "\"No data available\"",
 					description: "데이터 없을 때 표시할 메시지"
 				}
 			],
@@ -6819,10 +6839,78 @@ const filters = [
 	{
 		name: "PropertyExplorer",
 		category: "shell",
-		description: "프로퍼티 탐색기. 검색 가능한 속성 목록을 그룹별로 표시합니다.",
+		description: "검색 가능한 속성 목록을 그룹별로 표시하고, 숨김 상태와 호출자 소유의 명시적인 편집 액션을 함께 제공합니다.",
 		slug: "property-explorer",
 		exports: ["PropertyExplorer"],
-		props: {},
+		props: {
+			PropertyExplorer: [
+				{
+					name: "groups",
+					type: "PropertyGroup[]",
+					required: true,
+					description: "그룹별 속성 목록. 각 속성은 dataType과 hidden 상태를 포함 가능"
+				},
+				{
+					name: "onSelect",
+					type: "(property: PropertyDef) => void",
+					description: "속성 선택"
+				},
+				{
+					name: "onEdit",
+					type: "(property: PropertyDef) => void",
+					description: "행에 명시적인 편집 버튼을 표시하고 선택한 속성을 전달"
+				},
+				{
+					name: "className",
+					type: "string",
+					description: "추가 CSS 클래스"
+				},
+				{
+					name: "labels",
+					type: "PropertyExplorerLabels",
+					description: "검색·빈 상태·편집·숨김 문구"
+				}
+			],
+			PropertyDef: [
+				{
+					name: "name",
+					type: "string",
+					required: true,
+					description: "속성 이름"
+				},
+				{
+					name: "type",
+					type: "string",
+					required: true,
+					description: "원본 스키마 타입"
+				},
+				{
+					name: "dataType",
+					type: "FieldDataType",
+					description: "호출자가 이미 판정한 opt-ui 필드 타입"
+				},
+				{
+					name: "description",
+					type: "string",
+					description: "속성 설명"
+				},
+				{
+					name: "exampleValue",
+					type: "string",
+					description: "예시 값"
+				},
+				{
+					name: "eventCount",
+					type: "number",
+					description: "관측 이벤트 수"
+				},
+				{
+					name: "hidden",
+					type: "boolean",
+					description: "피커에서는 숨기되 탐색기에서는 흐리게 표시할 상태"
+				}
+			]
+		},
 		dependencies: [{
 			slug: "input",
 			category: "core"
@@ -6981,10 +7069,74 @@ const filters = [
 	{
 		name: "EventMetaEditor",
 		category: "shell",
-		description: "이벤트 메타 에디터. 레이블이 연결된 IconPicker + ColorPicker + TagInput 조합으로 이벤트 메타데이터를 편집합니다.",
+		description: "기본 이벤트 메타와 호출자 소유 섹션을 한 폼에서 편집하고, footer의 한 액션으로 함께 저장할 수 있습니다.",
 		slug: "event-meta-editor",
 		exports: ["EventMetaEditor"],
-		props: {},
+		props: {
+			EventMetaEditor: [
+				{
+					name: "value",
+					type: "EventMeta",
+					required: true,
+					description: "편집 중인 이벤트 메타데이터"
+				},
+				{
+					name: "onChange",
+					type: "(meta: EventMeta) => void",
+					required: true,
+					description: "메타데이터 변경"
+				},
+				{
+					name: "icons",
+					type: "IconDef[]",
+					description: "선택 가능한 아이콘"
+				},
+				{
+					name: "sections",
+					type: "EventMetaEditorSection[]",
+					description: "기본 여섯 필드 뒤에 렌더할 호출자 소유 섹션"
+				},
+				{
+					name: "footer",
+					type: "ReactNode",
+					description: "내장 필드와 추가 섹션을 함께 저장하는 마지막 액션 영역"
+				},
+				{
+					name: "className",
+					type: "string",
+					description: "추가 CSS 클래스"
+				},
+				{
+					name: "labels",
+					type: "EventMetaEditorLabels",
+					description: "필드 레이블과 placeholder 문구"
+				}
+			],
+			EventMetaEditorSection: [
+				{
+					name: "id",
+					type: "string",
+					required: true,
+					description: "섹션 키"
+				},
+				{
+					name: "title",
+					type: "ReactNode",
+					description: "섹션 제목"
+				},
+				{
+					name: "description",
+					type: "ReactNode",
+					description: "섹션 변경이 미치는 영향 안내"
+				},
+				{
+					name: "children",
+					type: "ReactNode",
+					required: true,
+					description: "호출자가 소유하는 필드"
+				}
+			]
+		},
 		dependencies: [
 			{
 				slug: "input",
@@ -9368,6 +9520,16 @@ const messages = [
 				type: "\"sm\" | \"md\" | \"lg\"",
 				default: "\"md\"",
 				description: "push 레이아웃에서의 인스펙터 폭"
+			},
+			{
+				name: "labels",
+				type: "InspectorLayoutLabels",
+				description: "닫기 버튼 등 인스펙터 문구"
+			},
+			{
+				name: "className",
+				type: "string",
+				description: "추가 CSS 클래스"
 			}
 		] },
 		usage: {
@@ -9433,6 +9595,16 @@ const messages = [
 				name: "queryBarLabels",
 				type: "QueryBarLabels",
 				description: "QueryBar로 통과되는 나머지 문구. placeholder/ariaLabel은 labels가 이깁니다"
+			},
+			{
+				name: "labels",
+				type: "QueryFilterBarLabels",
+				description: "검색·필터·초기화 문구"
+			},
+			{
+				name: "className",
+				type: "string",
+				description: "추가 CSS 클래스"
 			}
 		] },
 		usage: {
@@ -9615,6 +9787,11 @@ const messages = [
 					name: "labels",
 					type: "CatalogFrameLabels",
 					description: "빈/필터된 빈/에러 문구"
+				},
+				{
+					name: "className",
+					type: "string",
+					description: "추가 CSS 클래스"
 				}
 			],
 			CatalogRowActions: [
@@ -9642,6 +9819,36 @@ const messages = [
 					description: "그룹·오버플로 라벨"
 				}
 			],
+			CatalogRowAction: [
+				{
+					name: "id",
+					type: "string",
+					required: true,
+					description: "액션 키"
+				},
+				{
+					name: "label",
+					type: "string",
+					required: true,
+					description: "액션 문구"
+				},
+				{
+					name: "icon",
+					type: "ReactNode",
+					description: "선택적 액션 아이콘"
+				},
+				{
+					name: "onSelect",
+					type: "(item: T) => void",
+					required: true,
+					description: "행과 함께 호출되는 액션"
+				},
+				{
+					name: "available",
+					type: "(item: T) => boolean",
+					description: "이 행에 적용되지 않는 액션을 비활성화 대신 제거"
+				}
+			],
 			CatalogCellControls: [{
 				name: "children",
 				type: "ReactNode",