@g1cloud/ui-modeler-next 5.0.0-alpha.1

package/dist/agent/symbolicOp.d.ts

@@ -0,0 +1,97 @@
+import { MultiLangText } from '../core/lang';
+import { PartType } from '../core/partType';
+/**
+ * 요소 지정 핸들 — partId 대신 사람 지정 어휘(불변식 #4: id 1차 → path 2차 → caption 3차).
+ * 모호성은 실패가 아니라 후보 반환(resolver escalation) — 재질의 유도.
+ * - id: 파트 UUID(가장 안정. describeScreen이 항상 노출).
+ * - path: 자식 순서 기반 경로(예: `FormLayout[0]/TextField[2]`). resolver·describeScreen 동일 문법.
+ * - caption: PartDef.captionProp가 가리키는 attr 값(사람 라벨. 모델 내 중복 가능 → 모호 시 후보).
+ */
+export interface Handle {
+    /** 매칭할 id/경로/캡션 문자열. */
+    ref: string;
+    /** 매칭 축 고정. 미지정 시 id → path → caption 순으로 시도. */
+    by?: 'id' | 'path' | 'caption';
+}
+/**
+ * 파트 속성 값의 **agent 노출 clean 표현**. core `AttrVal`(G6 타입드 union)의 부분집합 —
+ * G2 비노출 kind(`dataSource`/`dataMapping`/`validator`)는 여기 없다(바인딩 seam은 M12 예약).
+ * `enum`은 SELECT 등의 저장값 직접 방출(toAgentCatalog가 라벨 큐레이션 → resolver 매핑 불요).
+ */
+export type PropValue = {
+    kind: 'string';
+    value: string;
+} | {
+    kind: 'int';
+    value: number;
+} | {
+    kind: 'bool';
+    value: boolean;
+} | {
+    kind: 'text';
+    value: MultiLangText;
+} | {
+    kind: 'enum';
+    value: string;
+};
+/** 한 속성 지정. `id`는 catalog PropertyItem.id(agent 노출 항목). */
+export interface PropAssign {
+    id: string;
+    value: PropValue;
+}
+/**
+ * 한 스타일 지정(G1). agent는 **중립 의미 토큰**만 말하고(`dim`/`token`), resolver가
+ * `token→styleName` lowering으로 하강한다 — 원시 CSS 클래스는 agent 어휘에 없다(G1 누출 차단).
+ * `dim`은 STYLE_TOKENS 차원. 하강 타깃은 `STYLE_TOKEN_DIM_META.source`가 결정한다:
+ * - `style` 소스(bgColor·size·spacing…) → css 클래스가 `addStyleNames`(공백구분 집합)에 누적.
+ * - `layoutAttr` 소스(slotAlign) → enum 이름이 layoutAttrs(`componentAlignment`)에 저장.
+ * (레이아웃 자식 정렬 slotAlign도 별도 필드가 아니라 이 단일 메커니즘으로 표현 — lowering 경로 일원화.)
+ */
+export interface StyleAssign {
+    dim: string;
+    token: string;
+}
+/**
+ * 신규/기존 파트의 선언적 스펙.
+ *
+ * **inline fold**: 자식은 별도 `part.add`로 보내지 않고 여기 `children`에 inline으로 담는다.
+ * resolver가 완성형 서브트리를 한 번에 조립하고 interpreter가 전 노드에 `rev:0` stamp(불변식 #3) —
+ * 별도 child op은 pending-ref 무효화를 부른다(inline-fold가 정공법).
+ *
+ * ⚠ `children`은 **본질적으로 재귀**다(FormLayout이 FormLayout을 품는 임의 깊이 중첩). 이 재귀가
+ * Anthropic strict-subset 스키마의 self-`$ref` 수용 여부(R-schema, exit #3)를 트리거한다 —
+ * schema.ts는 self-`$ref` 대신 **고정 깊이 unroll**(`partSpecL0..LN`)로 이 재귀를 표현한다.
+ */
+export interface PartSpec {
+    partType: PartType | (string & {});
+    /** 타입드 속성(순서 무관). id는 catalog PropertyItem.id. */
+    props?: PropAssign[];
+    /** 중립 스타일 토큰(G1). resolver가 css/enum으로 lowering(slotAlign 포함 — StyleAssign 참조). */
+    styles?: StyleAssign[];
+    /** inline-fold 자식 서브트리(재귀). */
+    children?: PartSpec[];
+}
+/**
+ * LLM이 산출하는 단일 심볼릭 op. `kind`는 command/op 어휘와 1:1(로케이터만 심볼릭).
+ * `part.update`의 props/styles는 부분 지정(주어진 키만 갱신).
+ */
+export type SymbolicOp = {
+    kind: 'part.add';
+    parent: Handle | null;
+    spec: PartSpec;
+    index?: number;
+} | {
+    kind: 'part.update';
+    target: Handle;
+    props?: PropAssign[];
+    styles?: StyleAssign[];
+} | {
+    kind: 'part.remove';
+    target: Handle;
+};
+/**
+ * v1(M3.5)이 다루는 심볼릭 op 종류의 닫힌 집합(단일 출처). resolver·JSON Schema(`schema.ts`)가 공유한다.
+ * 아래 컴파일타임 단언이 이 튜플과 `SymbolicOp['kind']`의 일치를 강제 — 한쪽만 늘리면 타입 에러.
+ */
+export declare const SYMBOLIC_OP_KINDS: readonly ["part.add", "part.update", "part.remove"];
+export type SymbolicOpKind = (typeof SYMBOLIC_OP_KINDS)[number];

package/dist/catalog/builtin/basic.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** Basic 카테고리. 파생 원본: createButton/PopupButton/Label/Image/Link/LinkTab/ProgressBar/Console/NativeUpload/AuditInfo/AuditInfoButton. */
+export declare const basicParts: PartDef[];

package/dist/catalog/builtin/chart.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** Chart 카테고리. 파생 원본: createFlagCard/Chart. */
+export declare const chartParts: PartDef[];

package/dist/catalog/builtin/composite.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** Composite 카테고리. 파생 원본: createMultiFileUpload/SingleFileUpload/SingleImageUpload/NameField/AddressField/PageBuilder/ContentEditor. */
+export declare const compositeParts: PartDef[];

package/dist/catalog/builtin/etc.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** Etc 카테고리. 파생 원본: createPageRefreshButton/MultiLangExpandButton/Fragment/CommentList/SourceCodeEditor/MarkdownViewer/History. */
+export declare const etcParts: PartDef[];

package/dist/catalog/builtin/filter.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** Filter 카테고리. 파생 원본: createTextFilter()~createYesNoSelectFilter(). 전부 styleList() 비어있음. */
+export declare const filterParts: PartDef[];

package/dist/catalog/builtin/grid.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** Grid 카테고리. 파생 원본: createGrid/GridColumn(ColumnDef)/GridCellPanel/GridControl/GridLookup. */
+export declare const gridParts: PartDef[];

package/dist/catalog/builtin/index.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** 레거시 {@code UiModelerPartDefFactory.createDefaultPartDefinitions()}에 대응하는 builtin 전체 PartDef. */
+export declare const BUILTIN_PART_DEFS: PartDef[];

package/dist/catalog/builtin/input.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** Input 카테고리. 파생 원본: createTextField()~createYesNoSelect() + createColorField(). */
+export declare const inputParts: PartDef[];

package/dist/catalog/builtin/layout.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** Layout 카테고리. 파생 원본: UiModelerPartDefFactory createVerticalLayout()~createInternalLayoutArea(). */
+export declare const layoutParts: PartDef[];

package/dist/catalog/builtin/listField.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** ListField 카테고리. 파생 원본: createListField/ListControl. */
+export declare const listFieldParts: PartDef[];

package/dist/catalog/builtin/multilang.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** MultiLang 카테고리. 파생 원본: createMultiLangTextField()~createMultiLangFileUpload(). 전부 styleList() 비어있음. */
+export declare const multilangParts: PartDef[];

package/dist/catalog/builtin/shared.d.ts

@@ -0,0 +1,69 @@
+import { AttrVal } from '../../core/attrValue';
+import { PartType } from '../../core/partType';
+import { PropertyEditor } from '../propertyEditor';
+import { PartDef, PropertyGroup, PropertyItem, StyleDim } from '../types';
+/**
+ * builtin PartDef 이식용 공용 팩토리. 레거시 {@code UiModelerPartDefFactory}의
+ * propertyGroup·propertyItem·styleFor 계열 헬퍼를 1:1 대응하는 TS 함수로 옮긴다
+ * (카테고리 파일을 원본 Java와 시각적으로 대칭 유지 → 대조 검증 용이).
+ */
+/** PartDef 빌더. category/captionProp 기본값은 createCatalog가 채운다(보일러플레이트 축소). */
+export declare function def(partType: PartType, partName: string, groups: PropertyGroup[], styles?: StyleDim[]): PartDef;
+/** {@code propertyItem(id, name, valueType, type, param, default)}. */
+export declare function pi(id: string, name: string, valueType: PropertyItem['valueType'], editor: PropertyEditor, param?: string, def?: AttrVal): PropertyItem;
+/** {@code propertyGroup(name, ...items)}. */
+export declare function pg(name: string, ...items: PropertyItem[]): PropertyGroup;
+/** {@code propertyGroup(name, true, ...items)} — layout 속성 그룹(layoutAttrMap 대상). */
+export declare function pgLayout(name: string, ...items: PropertyItem[]): PropertyGroup;
+/** {@code propertyGroupForComponent()}. addStyleNames(스타일 팔레트)·caption 등 공통 컴포넌트 속성. */
+export declare function pgComponent(): PropertyGroup;
+/** {@code propertyGroupForSize()}. */
+export declare function pgSize(): PropertyGroup;
+/** {@code propertyGroupForMimMaxSize()}. */
+export declare function pgMinMaxSize(): PropertyGroup;
+/** {@code layoutPropertyGroupForOrderedLayout()} — componentAlignment(ALIGN)·expandRatio. */
+export declare function pgOrderedLayout(): PropertyGroup;
+/** {@code propertyGroupForField()}. */
+export declare function pgField(): PropertyGroup;
+/** {@code propertyGroupForPseudoField()} — propertyId/dataMapping 없는 field 그룹. */
+export declare function pgPseudoField(): PropertyGroup;
+/** css 클래스 하나의 on/off 토글. legacy AddStyle(children 無). */
+export declare function tog(css: string, label: string): StyleDim;
+export declare const sMarginSize: () => StyleDim;
+export declare const sSpacingSize: () => StyleDim;
+export declare const sColor: () => StyleDim;
+export declare const sTextColor: () => StyleDim;
+export declare const sBgColor: () => StyleDim;
+export declare const sCaptionBg: () => StyleDim;
+export declare const sCaptionDir: () => StyleDim;
+export declare const sAlignment: () => StyleDim;
+export declare const sVerticalAlignment: () => StyleDim;
+export declare const sSize: () => StyleDim;
+/** styleForSize2 — size의 부분집합(small/default/large). */
+export declare const sSize2: () => StyleDim;
+export declare const sCaptionSize: () => StyleDim;
+export declare const sIconAlignment: () => StyleDim;
+export declare const sHeading: () => StyleDim;
+export declare const sWeight: () => StyleDim;
+export declare const sBorderless: () => StyleDim;
+export declare const sBorderlessTop: () => StyleDim;
+export declare const sBorderlessBottom: () => StyleDim;
+export declare const sBorderlessLeft: () => StyleDim;
+export declare const sBorderlessRight: () => StyleDim;
+export declare const sBordered: () => StyleDim;
+export declare const sBorderedTop: () => StyleDim;
+export declare const sBorderedBottom: () => StyleDim;
+export declare const sBorderedLeft: () => StyleDim;
+export declare const sBorderedRight: () => StyleDim;
+export declare const sColorBorderedTop: () => StyleDim;
+export declare const sLineless: () => StyleDim;
+export declare const sHorizontal: () => StyleDim;
+export declare const sScrollable: () => StyleDim;
+export declare const sWhitePrefix: () => StyleDim;
+export declare const sWhiteSuffix: () => StyleDim;
+export declare const sCaptionBorderlessBottom: () => StyleDim;
+/** 공통 border toggle 4방(top/bottom/left/right). */
+export declare const borderedSides: () => StyleDim[];
+export declare const borderlessSides: () => StyleDim[];
+/** 다수 파트가 공유하는 caption 스타일 3종(caption bg/borderless-bottom/direction). */
+export declare const captionStyles: () => StyleDim[];

package/dist/catalog/builtin/tree.d.ts

@@ -0,0 +1,3 @@
+import { PartDef } from '../types';
+/** Tree 카테고리. 파생 원본: createTree/TreeControl/TabSheet/TabSheetPanel. */
+export declare const treeParts: PartDef[];

package/dist/catalog/catalog.d.ts

@@ -0,0 +1,13 @@
+import { PartCatalog, PartDef } from './types';
+/** builtin(기본) 또는 주어진 defs로 카탈로그 생성. */
+export declare function createCatalog(defs?: PartDef[]): PartCatalog;
+/**
+ * 기존 카탈로그를 확장/오버라이드/제거해 새 카탈로그 생성(호스트 확장 API).
+ * - add/override: partType 키로 교체·추가(동일 키면 override).
+ * - remove: partType 키 제거.
+ */
+export declare function extendCatalog(base: PartCatalog, changes?: {
+    add?: PartDef[];
+    override?: PartDef[];
+    remove?: string[];
+}): PartCatalog;

package/dist/catalog/containment.d.ts

@@ -0,0 +1,26 @@
+import { PartType } from '../core/partType';
+import { ContainmentRule } from './types';
+/**
+ * 파트별 containment 규칙 테이블(M4 역공학 산출). 안(b): builtin/*.ts와 분리된 단일 테이블로
+ * `createCatalog`가 각 PartDef에 머지(`catalog.ts`). 역공학 원본은 레거시 GWT 모델러
+ * `ui/client/part/*Part.java`.
+ *
+ * ## 판별식 (컨테이너 여부의 유일 기준)
+ * 레거시에서 "자식 파트를 담는가"는 `Part.getChildParts()` 오버라이드 여부로만 결정된다.
+ * 기본 `PartAdapter.getChildParts()`는 `null` 반환 → leaf(`PartSupport.java:164-166`).
+ * 전 패키지에서 이를 오버라이드하는 클래스는 10개뿐(전부 레이아웃/컨테이너):
+ *   AbstractOrderedLayoutPart, ActionLayoutPart, CardLayoutPart, FlowLayoutPart,
+ *   FormLayoutPart, FormLayoutCaption, GridPart, PopupButtonPart, TabSheetPart, TableLayoutPart
+ * + 내부 static 클래스 3종: GridColumnPart(ColumnDef)/GridCellPartPanel(GridCellPanel)/TabPanelPart(TabSheetPanel).
+ * 이 목록에 없는 파트는 전부 leaf.
+ *
+ * ## role 의미
+ * - open: 임의 자식 수용(레거시 ordered/form/flow 레이아웃은 타입 guard 없음). 필터 미지정=모든 타입.
+ * - fixed: 특정 타입 자식만(fixedChildren). arity로 개수 불변식 기록(M5 소비).
+ * - leaf: 자식 거부.
+ *
+ * ## 미등재 파트
+ * 이 테이블에 없는 partType은 규칙 미정 → `canContain`이 `warn`(거부 아님, 과도 제약 방지).
+ * 아래 leaf 파트들은 **명시적으로** role:'leaf'를 부여해 `deny`가 나오도록 한다(미정 warn과 구분).
+ */
+export declare const CONTAINMENT_RULES: Partial<Record<PartType, ContainmentRule>>;

package/dist/catalog/index.d.ts

@@ -0,0 +1,6 @@
+export * from './propertyEditor';
+export * from './styleTokens';
+export * from './types';
+export * from './catalog';
+export * from './toAgentCatalog';
+export { BUILTIN_PART_DEFS } from './builtin';

package/dist/catalog/propertyEditor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 속성 편집 위젯 종류. 레거시 {@code PropertyType.java} enum을 그대로 포팅하되,
+ * core의 {@code PartType}과의 이름 충돌·의미 혼동을 피하려 **`PropertyEditor`로 개명**한다
+ * ("무엇을 편집하는 위젯인가"를 가리키므로 editor가 정확한 어휘).
+ *
+ * 파생 원본: bluework-uimodeler-model/.../ui/shared/PropertyType.java
+ */
+export type PropertyEditor = 'TEXT' | 'TEXT_WITH_BUTTON' | 'TEXT_RO_WITH_BUTTON' | 'MESSAGE_TEXT' | 'TEXTAREA' | 'FULL_TEXTAREA' | 'MESSAGE_TEXTAREA' | 'INTEGER' | 'BOOL' | 'BUTTON' | 'SIMPLE_BUTTON' | 'WINDOW_OPEN_BUTTON' | 'SELECT' | 'ALIGN' | 'ADD_STYLE' | 'SIZE' | 'ICON' | 'TAGS' | 'COMPONENT_REF' | 'DATASOURCE' | 'DATAMAPPING' | 'COMMENT' | 'CASE_MESSAGES';
+export declare const PROPERTY_EDITORS: readonly PropertyEditor[];
+/**
+ * G2 — editor별 agent 노출 기본 규칙.
+ * 85파트×N속성을 수기 주석하지 않고 **editor 종류로 노출 여부를 결정**하고, 예외만
+ * {@code PropertyItem.agent.expose}로 오버레이한다. 계획 §"G1·G2 확정 결정"의 표를 코드화.
+ *
+ * - 값형 텍스트/불리언/정수/태그/다국어 텍스트 = 노출(값 그대로 또는 `#{key}` 인코딩은 resolver).
+ * - SELECT = 노출(`param`을 label enum으로).
+ * - ALIGN/ADD_STYLE/SIZE/ICON = 노출하되 **원시 CSS가 아닌 의미 토큰**(G1, STYLE_TOKENS 경유).
+ * - `*_BUTTON` 계열(host 다이얼로그 트리거)·COMPONENT_REF·DATASOURCE/DATAMAPPING·COMMENT/CASE_MESSAGES
+ *   = 비노출. 바인딩(DATASOURCE/DATAMAPPING)은 G5 design-intent 층(M12)에서 재개방.
+ *
+ * `*_BUTTON`/`*_WITH_BUTTON` 기본 false는 G2 표를 M3에서 보강한 결정(host 액션·바인딩 트리거는
+ * NL 주소 대상이 아님). 개별 예외는 PartDef의 agent 오버레이로 승격 가능.
+ */
+export declare const AGENT_EXPOSE_DEFAULT: Record<PropertyEditor, boolean>;

package/dist/catalog/styleTokens.d.ts

@@ -0,0 +1,54 @@
+/**
+ * G1 — 스타일/정렬 어휘의 **의미 토큰(neutral token)** 단일 lowering 테이블.
+ *
+ * 레거시는 스타일을 원시 CSS 클래스(`blue-bg`, `margin-lg`, `align-center`)로 저장하고,
+ * `AddStyle{styleName(=css), styleDesc(=사람라벨), children}` 트리로 팔레트를 기술한다.
+ * 원시 CSS는 bluesea 디자인시스템 종속(불변식 #1 위반 대상)이라 **agent 표면에 노출 금지**다.
+ *
+ * 이 테이블이 유일한 진실 소스(SoT)로서 `token ⇄ css`를 매핑한다:
+ * - resolver: `token → css` (하강, write)
+ * - describeScreen(G3): `css → token` (역매핑, read)
+ * - agent schema / toAgentCatalog(G2): enum 후보를 이 테이블에서 파생
+ *
+ * 근거·확정: 계획 §"G1 확정 — 의미 토큰 차원". `slotAlign`은 legacy `ALIGN` editor 실증 결과
+ * 단일 6값 enum(2축 아님)으로 확정(`VAbstractProperties.java:1459-1493`).
+ *
+ * 파생 원본: UiModelerPartDefFactory.styleFor*() 팩토리 + layoutPropertyGroupForOrderedLayout().
+ */
+/** 의미 토큰 차원. agent가 다루는 중립 스타일 축. */
+export type StyleTokenDim = 'spacing' | 'gap' | 'color' | 'textColor' | 'bgColor' | 'captionBg' | 'captionDir' | 'align' | 'verticalAlign' | 'size' | 'captionSize' | 'iconAlign' | 'heading' | 'weight' | 'slotAlign';
+/** 한 토큰: 중립 id ⇄ 원시 저장값(css 클래스 또는 layout enum 이름) ⇄ 사람 라벨. */
+export interface StyleToken {
+    /** 중립 토큰 id(agent 표면). 사람 라벨의 정규화값. */
+    token: string;
+    /** 원시 저장값. style 차원=css 클래스(빈 문자열=기본, 클래스 없음), slotAlign=enum 이름(대문자). */
+    css: string;
+    /** 사람 라벨(속성패널 표시용). legacy AddStyle.styleDesc. */
+    label: string;
+}
+/** 토큰 차원의 저장 소스. */
+export type StyleDimSource = 'style' | 'layoutAttr';
+export interface StyleTokenDimMeta {
+    source: StyleDimSource;
+    /** legacy AddStyle.styleName(style 차원) 또는 layout propertyId(layoutAttr). */
+    legacyDimId: string;
+    label: string;
+}
+/**
+ * G1 확정 테이블. 빈 css `""`는 각 차원의 default/none/normal 토큰에 매핑(왕복 대칭).
+ * heading은 legacy에 기본값이 없어 `""` 항목이 없다.
+ */
+export declare const STYLE_TOKENS: Record<StyleTokenDim, StyleToken[]>;
+/** 각 토큰 차원의 저장 소스·legacy 원본 id. describeScreen/resolver 배선용. */
+export declare const STYLE_TOKEN_DIM_META: Record<StyleTokenDim, StyleTokenDimMeta>;
+/** 토큰 → 원시 저장값. 미지 토큰이면 undefined. */
+export declare function tokenToCss(dim: StyleTokenDim, token: string): string | undefined;
+/** 원시 저장값(css/enum 이름) → 토큰. 미지 값이면 undefined. */
+export declare function cssToToken(dim: StyleTokenDim, css: string): string | undefined;
+/** style 소스 css 클래스 하나를 소속 차원·토큰으로 역해석(describeScreen의 addStyleNames 분해용). */
+export declare function classifyStyleClass(css: string): {
+    dim: StyleTokenDim;
+    token: string;
+} | undefined;
+/** 한 차원의 토큰 id 목록(agent enum 후보). */
+export declare function tokensOf(dim: StyleTokenDim): string[];

package/dist/catalog/toAgentCatalog.d.ts

@@ -0,0 +1,57 @@
+import { AttrKind } from '../core/attrValue';
+import { PartCategory } from '../core/partType';
+import { StyleTokenDim } from './styleTokens';
+import { PartCatalog } from './types';
+/**
+ * G2 — PartDef(SoT)에서 파생하는 **agent 전용 정제 뷰**. 이중 카탈로그를 만들지 않고
+ * 노출 규칙·토큰 치환·SELECT 라벨화를 여기서 한 번에 적용한다. `agent/schema.ts`(M8)는
+ * PartDef가 아닌 이 AgentCatalog만 소비한다(catalog-drift 단일 소스).
+ *
+ * 규칙: 계획 §"G2 확정 — 단일 PartDef + agent 오버레이".
+ * - 노출 여부 = `PropertyItem.agent.expose` ?? {@link AGENT_EXPOSE_DEFAULT}[editor].
+ * - ADD_STYLE(스타일 팔레트) 항목은 attrs에서 제거하고 PartDef.styles를 styleDims/styleToggles로 노출(G1).
+ * - ALIGN(componentAlignment)은 slotAlign 토큰으로 노출.
+ * - SELECT는 원시 CSS가 아닌 옵션 목록(value+label)으로. TAGS는 태그 목록으로.
+ */
+export type AgentValueKind = 'text' | 'multilang' | 'int' | 'bool' | 'enum' | 'tags';
+export interface AgentEnumOption {
+    /** 저장값(stored value). agent가 이 값을 직접 방출 → resolver 매핑 불요. */
+    value: string;
+    /** 사람 라벨(LLM 가독성). */
+    label: string;
+}
+export interface AgentPropertyItem {
+    id: string;
+    valueType: AttrKind;
+    kind: AgentValueKind;
+    description?: string;
+    /** SELECT/TAGS 옵션. kind가 enum/tags일 때. */
+    options?: AgentEnumOption[];
+}
+export interface AgentStyleDim {
+    dim: StyleTokenDim;
+    /** 이 파트에서 선택 가능한 의미 토큰(중립). 원시 CSS는 노출하지 않음(G1). */
+    tokens: string[];
+}
+export interface AgentPartDef {
+    partType: string;
+    category?: PartCategory;
+    captionProp?: string;
+    /** 노출된 값 속성. */
+    attrs: AgentPropertyItem[];
+    /** enum 스타일 차원(의미 토큰). */
+    styleDims: AgentStyleDim[];
+    /** on/off 스타일 토글(css 클래스는 lowering 대상이므로 라벨만 의미 전달). */
+    styleToggles: {
+        css: string;
+        label: string;
+    }[];
+    /** ordered layout 자식일 때의 슬롯 정렬 토큰(componentAlignment). */
+    slotAlign?: string[];
+}
+export interface AgentCatalog {
+    get(partType: string): AgentPartDef | undefined;
+    all(): AgentPartDef[];
+}
+/** PartCatalog → AgentCatalog 파생. */
+export declare function toAgentCatalog(catalog: PartCatalog): AgentCatalog;

package/dist/catalog/types.d.ts

@@ -0,0 +1,117 @@
+import { AttrVal, AttrKind } from '../core/attrValue';
+import { PartType, PartCategory } from '../core/partType';
+import { PropertyEditor } from './propertyEditor';
+import { StyleTokenDim } from './styleTokens';
+/**
+ * catalog 타입 허브. 레거시 {@code UiModelerPartDef}(+ PropertiesList/PropertyGroup/PropertyItem/AddStyle)를
+ * 선언적 TS 데이터로 포팅. **단일 PartDef가 SoT**(G2 — 이중 카탈로그 금지)이고, agent 뷰는
+ * {@code toAgentCatalog}가 파생한다.
+ *
+ * 파생 원본: bluework-uimodeler-lib/.../ui/shared/UiModelerPartDef.java
+ */
+/**
+ * 한 속성 항목. 레거시 {@code PropertyItem}.
+ * - `valueType`: clean 값 종류({@link AttrKind}) — 이 항목의 attr 값을 타이핑하는 SoT(G6).
+ *   adapter v1-read 디코더가 이 값을 authoritative로 사용(레거시 저장 태그가 아님).
+ * - `editor`: 편집 위젯 종류.
+ * - `param`: SELECT 옵션(`raw:label; …`)·COMPONENT_REF 타깃·TAGS 목록 등 editor별 파라미터.
+ * - `default`: legacy componentDefaultValue.
+ * - `layoutAttr`: 부모 레이아웃이 부과하는 속성(layoutAttrMap 대상). 레거시 group의 isLayoutAttribute 전파.
+ * - `agent`: G2 노출 오버레이(선택). 미지정 시 editor별 기본 규칙({@link AGENT_EXPOSE_DEFAULT}).
+ */
+export interface PropertyItem {
+    id: string;
+    name: string;
+    valueType: AttrKind;
+    editor: PropertyEditor;
+    param?: string;
+    default?: AttrVal;
+    layoutAttr?: boolean;
+    agent?: PropertyItemAgent;
+}
+/** G2 agent 오버레이. 계획 §"G2 확정 — 단일 PartDef + agent 오버레이". */
+export interface PropertyItemAgent {
+    /** editor 기본 규칙을 덮어써 노출 여부 강제. */
+    expose?: boolean;
+    /** LLM 대상 설명(용도/언제 쓰는지). 사람 라벨(name)과 별개. */
+    description?: string;
+    /** ADD_STYLE/ALIGN/SIZE 항목이 참조하는 의미 토큰 차원(G1). */
+    token?: StyleTokenDim;
+    /** SELECT 등에서 노출할 큐레이션 값 집합(미지정 시 param 파싱 결과 전체). */
+    enum?: string[];
+}
+/** 속성 그룹. 레거시 {@code PropertyGroup}. `layoutAttr`면 소속 item 전부 layoutAttrMap 대상. */
+export interface PropertyGroup {
+    name: string;
+    layoutAttr?: boolean;
+    items: PropertyItem[];
+}
+/**
+ * 파트가 지원하는 스타일 차원 하나. 레거시 {@code AddStyle}(children 有=라디오 차원, 無=토글).
+ * - enum: {@link STYLE_TOKENS}의 `dim`을 참조(옵션은 그 테이블에서 파생 — drift 방지). `only`로 부분집합 제한.
+ * - toggle: css 클래스 하나의 on/off.
+ */
+export type StyleDim = {
+    kind: 'enum';
+    dim: StyleTokenDim;
+    only?: string[];
+} | {
+    kind: 'toggle';
+    css: string;
+    label: string;
+};
+/**
+ * containment 규칙. M4에서 레거시 `getChildParts()` 오버라이드 여부(컨테이너 판별 유일 기준)를
+ * 역공학해 채움. 판별식·근거는 `containment.ts` 참조.
+ * - open: 임의 자식 수용(allow/allowCategories/deny로 필터). 필터 미지정이면 모든 타입 수용.
+ * - fixed: 특정 타입 자식만(fixedChildren). 개수 제약은 {@link ContainmentRule.arity}로 별도 표현.
+ * - leaf: 자식 거부.
+ *
+ * `arity`는 pairwise `canContain`이 아닌 트리 검증(M5 `validatePartModel`)이 소비하는
+ * 개수 불변식이다(예: ActionLayout=정확히 2 ActionLayoutArea, 단일 슬롯=max 1). M4는 데이터로만 기록.
+ */
+export interface ContainmentRule {
+    role: 'open' | 'fixed' | 'leaf';
+    allow?: PartType[];
+    allowCategories?: PartCategory[];
+    deny?: PartType[];
+    fixedChildren?: PartType[];
+    /** 자식 개수 불변식(M5 소비). 미지정이면 제약 없음. */
+    arity?: {
+        min?: number;
+        max?: number;
+    };
+}
+/**
+ * `canContain` 판정 결과. warn-first 정책(계획 §M4)으로 3값.
+ * - allow: 규칙상 수용.
+ * - deny: 규칙상 명시적 거부(leaf 부모, fixed 부모의 비대상 자식, open 부모의 deny/allow 위반).
+ * - warn: 규칙 미정(부모 containment 미지정 — 호스트 확장 파트 등). 과도 제약 방지 위해 거부하지 않음.
+ */
+export type ContainmentVerdict = 'allow' | 'deny' | 'warn';
+/**
+ * 파트 정의(팔레트/속성패널/검증의 단일 SoT). 레거시 {@code UiModelerPartDef}.
+ * builtin은 닫힌 {@link PartType}, 호스트 확장 파트는 임의 string 키.
+ */
+export interface PartDef {
+    partType: PartType | (string & {});
+    partName: string;
+    category?: PartCategory;
+    groups: PropertyGroup[];
+    styles?: StyleDim[];
+    /** G3 — caption 핸들·표시에 쓰는 propertyId. 없으면 caption 생략(id/path만). */
+    captionProp?: string;
+    /** M4에서 채움. M3에서는 미지정. */
+    containment?: ContainmentRule;
+}
+/** 카탈로그 조회 인터페이스. */
+export interface PartCatalog {
+    get(partType: string): PartDef | undefined;
+    all(): PartDef[];
+    propertyItem(partType: string, propertyId: string): PropertyItem | undefined;
+    /**
+     * `parentType`이 `childType`을 자식으로 담을 수 있는지 pairwise 판정(M4).
+     * 개수(arity)는 검증하지 않는다 — 트리 검증(M5)의 관심사. {@link ContainmentVerdict} 참조.
+     */
+    canContain(parentType: string, childType: string): ContainmentVerdict;
+}

package/dist/command/commands.d.ts

@@ -0,0 +1,25 @@
+import { PartModel } from '../core/types';
+import { PartId } from './op';
+import { Command } from './types';
+/** update 대상 = 비구조 필드만(구조 변경은 add/move/remove). partId/partType/children 제외. */
+export type PartPatch = Partial<Pick<PartModel, 'attrs' | 'layoutAttrs' | 'comment' | 'caseMessages' | 'info' | 'extraAttrs'>>;
+/**
+ * 파트 추가 — `part` 서브트리를 `parentId`의 children[index]에 삽입(생략이면 append).
+ * invert는 삽입한 파트를 제거. emitOps forward=part.add(inline-fold value), invert=part.remove.
+ */
+export declare function addPart(parentId: PartId, part: PartModel, index?: number): Command;
+/**
+ * 파트 비구조 필드 부분 수정 — 얕은 patch. 원래 값(부재 키 포함)을 캡처해 invert에서 정확히 복원
+ * (부재였던 키는 삭제, 존재했던 키는 원값 복원 — undefined-vs-absent 왕복 손실 방지).
+ */
+export declare function updatePart(partId: PartId, patch: PartPatch): Command;
+/**
+ * 파트 이동 — `partId`를 `toParentId`의 children[index]로 옮긴다(index는 노드 제거 후 대상 배열 기준).
+ * memento로 원래 부모/인덱스/노드를 보존해 invert에서 원위치 복원. 드래그 중 coalesce(`move:<id>`).
+ */
+export declare function movePart(partId: PartId, toParentId: PartId, index?: number): Command;
+/**
+ * 파트 삭제 — 서브트리 통째 제거. memento로 부모/인덱스/서브트리를 보존해 invert에서 원자 재삽입.
+ * emitOps invert=part.add(inline-fold value=서브트리 통째) → 한 op에 자손까지 복원.
+ */
+export declare function removePart(partId: PartId): Command;

package/dist/command/op.d.ts

@@ -0,0 +1,83 @@
+import { PartModel } from '../core/types';
+/** 파트 식별자. */
+export type PartId = string;
+/** rev CAS 대상 축 — UI는 단일 'part' 축(불변식 #2). */
+export type CasUnit = 'part';
+/** op 종류 — 트리 4연산. */
+export type OpKind = 'part.add' | 'part.update' | 'part.move' | 'part.remove';
+export declare const OP_KINDS: OpKind[];
+/**
+ * command가 산출하는 단일 op의 어휘 형태. CAS 메타는 여기 없다 — emit 어댑터 책임(계약 3).
+ */
+export interface OpShape {
+    kind: OpKind;
+    casUnit: CasUnit;
+    /** update/move/remove 대상 파트. */
+    partRef?: PartId;
+    /** add: 새 파트가 들어갈 부모. */
+    parentRef?: PartId;
+    /** move: 원래 부모. */
+    fromParentRef?: PartId;
+    /** move: 대상 부모. */
+    toParentRef?: PartId;
+    /**
+     * add/move: 대상 부모 children 내 삽입 위치. **대상 배열이 (move는 노드 제거 후) 존재하는
+     * 시점 기준의 인덱스**다. 생략이면 말미 append.
+     */
+    index?: number;
+    /**
+     * add: inline-fold 서브트리(children 인라인) — pending-ref 무효화 회피. 호스트 interpreter가
+     * 서브트리 **전 노드에 rev:0**을 stamp한다(불변식 #3).
+     */
+    value?: PartModel;
+    /** update: 비구조 필드 부분 patch(attrs/layoutAttrs/comment/…). */
+    patch?: Record<string, unknown>;
+}
+/**
+ * apply 이후 호출 계약(계약 1)의 산출 — memento가 채워진 상태에서 do/undo 양방향 op.
+ * invert는 *역연산 forward op*(계약 2) — 같은 op의 역값이 아니라 역연산 op.
+ */
+export interface OpEmission {
+    /** do/redo 시 호스트로 보낼 op 배치(apply 순서). */
+    forward: OpShape[];
+    /** undo 시 호스트로 보낼 역연산 forward op 배치(invert 순서). */
+    invert: OpShape[];
+}
+/**
+ * op가 rev CAS를 거는 컨테이너 파트 목록(동시성 pivot). casUnit:'part' 단일 축.
+ * - add / remove: 부모 children 집합 변경 → `[parent]`.
+ * - update: 파트 자신 필드 변경 → `[self]`. (동시 remove는 호스트 element-level `$elemMatch`
+ *   실패 = missing으로 잡히므로 별도 부모 pivot 불요.)
+ * - move: 두 부모 children 변경 → `[from, to]`. 같은 부모 내 reorder면 Set dedup으로 1개.
+ */
+export declare function revContainersOf(op: OpShape): PartId[];
+/** op 출처 — 감사·aggregation 트리거 분기용. */
+export type OpOrigin = 'gui' | 'agent' | 'rest';
+/** 배치 CAS 단언 — 건드리는 컨테이너 파트의 base rev. 호스트가 updateOne filter로 접어 충돌 감지. */
+export interface OpCas {
+    /** 컨테이너 partId → base rev. */
+    revs?: Record<PartId, number>;
+}
+/** 한 제스처 = 한 원자 배치 = 한 updateOne. */
+export interface PersistedOpBatch {
+    modelId: string;
+    ops: OpShape[];
+    cas: OpCas;
+    origin: OpOrigin;
+    /** 멱등 키 — 재시도 중복 적용 차단. */
+    clientOpId: string;
+}
+/** 충돌 종류 — rev 불일치 / 대상 소실. */
+export interface OpConflict {
+    kind: 'rev' | 'missing';
+    ref?: PartId;
+    current?: number;
+}
+/** 호스트 op 집행 응답 — ok면 갱신 rev, 충돌이면 하드 프리즈 트리거. */
+export type OpResult = {
+    ok: true;
+    revs: Record<PartId, number>;
+} | {
+    ok: false;
+    conflict: OpConflict;
+};