@g1cloud/ui-modeler-next 5.0.0-alpha.8 → 5.0.0-alpha.9

package/dist/view/layout.d.ts

@@ -1,5 +1,6 @@
 import { PartModel } from '../core/types';
 import { PartType } from '../core/partType';
+import { MultiLangText } from '../core/lang';
 /**
  * 컨테이너 렌더 종류. flex/grid는 CSS로 직접 낮추고, card/tabs는 실 BS 컴포넌트에 위임(PreviewNode 분기).
  * slot = 단일 슬롯 홀더(InternalLayoutArea/TableLayoutCell/TabSheetPanel/GridCellPanel/ListField),
@@ -57,6 +58,11 @@ export declare function childLayoutStyle(child: PartModel, parent: LayoutKind):
  */
 export interface GridColumnSpec {
     propertyId: string;
+    /**
+     * 컬럼 헤더 표시 문자열(이미 flatten). 우선순위 = **리졸버 해소분**(부모가 주입한 메시지 카탈로그) →
+     * 평문 caption → `actualPropertyId`(읽을 수 있는 구조 식별자). 캡션 경로와 달리 미해소 키를 `#{key}`로
+     * 폴백하지 않는다 — 컬럼엔 `itemCode` 같은 propertyId가 `#{ecp.itemCode}`보다 읽기 좋기 때문.
+     */
     caption: string;
     width?: number;
     /** ColumnDef cellType 중 BSGrid GridCellType과 교집합인 값만(그 외는 생략→기본 TEXT 렌더). */
@@ -67,8 +73,13 @@ export interface GridColumnSpec {
  * 자식 노드로 재귀 렌더하지 않고 **컬럼 정의로 소비**한다(현 fallback: ColumnDef가 점선 플레이스홀더로 렌더).
  *
  * - `propertyId` ← `actualPropertyId`(없으면 partId).
- * - `caption` ← `caption`(평문일 때만; messageKey/맵은 프리뷰에서 표시 불가 → `actualPropertyId`로 폴백).
+ * - `caption` ← 리졸버 해소분(부모 메시지 카탈로그, 옵션) → 평문 `caption` → `actualPropertyId` 폴백.
  * - `width` ← `width`("90px"→90, 단위/공백 무시). 파싱 실패 시 생략(BSGrid 기본 폭).
  * - `cellType` ← `cellType`(BSGrid 교집합 4종만; 그 외 생략).
+ *
+ * `resolve`는 프리뷰 메시지 카탈로그 해소기(`preview/messages.resolveCaptionText`)를 주입받는 seam이다.
+ * 순수 lib 모듈이 preview 반응형 스토어에 결합하지 않도록 **옵션 파라미터**로 역주입한다(불변식 #1 계층 유지).
+ * 미지정 시 현행(평문/`actualPropertyId`) 동작 — 호출자·기존 테스트 무변경. 미해소 메시지 키는 `#{key}`가
+ * 아니라 `actualPropertyId`로 폴백한다(캡션 경로와 의도적 상이, `GridColumnSpec.caption` 참조).
  */
-export declare function gridColumnsOf(part: PartModel): GridColumnSpec[];
+export declare function gridColumnsOf(part: PartModel, resolve?: (t: MultiLangText) => string | undefined): GridColumnSpec[];

package/dist/view/preview/IframePreview.vue.d.ts

@@ -6,6 +6,11 @@ type __VLS_Props = {
     revision?: number;
     /** 현재 선택 partId — iframe에 highlight로 push(실물 위 선택 아웃라인 동기화). */
     selection?: string | null;
+    /**
+     * 메시지 카탈로그(key→표시텍스트) — iframe에 catalog로 push해 캡션 `#{key}`를 실 텍스트로 해소한다.
+     * 미지정/빈 맵이면 iframe이 지금처럼 `#{key}` 폴백. 실 출처는 호스트 번들, dev는 illustrative fixture.
+     */
+    messages?: Record<string, string>;
     /** iframe 진입 문서 URL(자체 bluesea@5.x 렌더러 번들). */
     src: string;
     /** postMessage targetOrigin — 기본 동일 출처('/'). 교차 출처면 명시. */
@@ -26,6 +31,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
 }>, {
     revision: number;
     selection: string | null;
+    messages: Record<string, string>;
     targetOrigin: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/view/preview/protocol.d.ts

@@ -46,6 +46,18 @@ export interface PreviewHighlightMessage {
     type: 'highlight';
     partId: string | null;
 }
+/**
+ * 부모 → iframe: 메시지 카탈로그 push(캡션 `#{key}` 해소용). 프리뷰엔 메시지 리소스가 없어 실샘플 캡션의
+ * 대부분(레거시 `#{key}` 형)이 미해소인데, 부모가 key→표시텍스트 맵을 push하면 실 텍스트로 렌더된다(맵에
+ * 없는 키는 지금처럼 `#{key}` 폴백). **모델과 직교**(편집마다 안 바뀜)라 render와 분리 — ready 후 1회 +
+ * 카탈로그 변경 시 push. 반응형 해소라 render보다 늦게 도착해도 캡션이 재평가된다.
+ */
+export interface PreviewCatalogMessage {
+    channel: typeof PREVIEW_CHANNEL;
+    type: 'catalog';
+    /** 메시지 키 → 표시 텍스트(활성 locale 평면 맵). */
+    messages: Record<string, string>;
+}
 /**
  * iframe → 부모: 실물 위 드롭 → 구조 편집(Path C, C-a). iframe은 **hit 리포터**로서 드롭 지점의 대상
  * 파트(`data-part-id`)와 존(`dropZoneAt` 로컬 판정)만 실어 보내고, **모델 변형은 부모 controller**가
@@ -65,7 +77,7 @@ export interface PreviewDropMessage {
     zone: DropZone;
 }
 /** 부모가 보내는 메시지(iframe이 수신). */
-export type PreviewOutbound = PreviewRenderMessage | PreviewHighlightMessage;
+export type PreviewOutbound = PreviewRenderMessage | PreviewHighlightMessage | PreviewCatalogMessage;
 /** 부모가 받는 메시지(iframe이 송신). */
 export type PreviewInbound = PreviewReadyMessage | PreviewResizeMessage | PreviewErrorMessage | PreviewSelectMessage | PreviewDropMessage;
 export declare function renderMessage(model: PartModel, revision: number): PreviewRenderMessage;
@@ -74,8 +86,9 @@ export declare function resizeMessage(height: number): PreviewResizeMessage;
 export declare function errorMessage(message: string): PreviewErrorMessage;
 export declare function selectMessage(partId: string | null): PreviewSelectMessage;
 export declare function highlightMessage(partId: string | null): PreviewHighlightMessage;
+export declare function catalogMessage(messages: Record<string, string>): PreviewCatalogMessage;
 export declare function dropMessage(dragKind: 'add' | 'move', payload: string, targetPartId: string | null, zone: DropZone): PreviewDropMessage;
 /** 부모 수신 필터 — iframe이 보낸 ready/resize/error만 통과. */
 export declare function isPreviewInbound(data: unknown): data is PreviewInbound;
-/** iframe 수신 필터 — 부모가 보낸 render만 통과. */
+/** iframe 수신 필터 — 부모가 보낸 render/highlight/catalog만 통과. */
 export declare function isPreviewOutbound(data: unknown): data is PreviewOutbound;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@g1cloud/ui-modeler-next",
   "private": false,
-  "version": "5.0.0-alpha.8",
+  "version": "5.0.0-alpha.9",
   "description": "Vue 3 visual UI-modeling / screen-design editor",
   "type": "module",
   "files": [

package/dist/preview/assets/preview-D_Yvfk8p.css

@@ -1 +0,0 @@
-.pv-frame[data-v-71e6eb5f]{display:flex;flex-direction:column}.pv-logo[data-v-71e6eb5f]{padding-left:16px}.pv-content[data-v-71e6eb5f]{padding:16px}.pv-selected[data-v-891c387b]{outline:2px solid #2563eb;outline-offset:1px;border-radius:2px}.pv-layout[data-v-891c387b]{min-width:0}.pv-card[data-v-891c387b]{margin:4px 0}.pv-grid[data-v-891c387b]{margin:4px 0;min-width:0}.pv-leaf[data-v-891c387b]{display:inline-block}.pv-field[data-v-891c387b]{display:flex;flex-direction:column;gap:2px;min-width:0}.pv-field .pv-leaf[data-v-891c387b]{display:block}.pv-placeholder[data-v-891c387b]{font-size:12px;color:#94a3b8;padding:4px 6px;border:1px dashed #cbd5e1;border-radius:4px;margin:4px 0}.pv-empty-state[data-v-891c387b]{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:4px;min-height:72px;padding:12px;margin:4px 0;border:1px solid #e2e8f0;border-radius:6px;background:#f8fafc;color:#64748b}.pv-empty-state-icon[data-v-891c387b]{font-family:Material Symbols Outlined;font-size:28px;line-height:1;color:#94a3b8}.pv-empty-state-label[data-v-891c387b]{font-size:13px;font-weight:600;color:#475569}.pv-empty-state-hint[data-v-891c387b]{font-size:11px;color:#94a3b8}.pv-root[data-v-280fb755]{position:relative;padding:12px;font-family:system-ui,sans-serif}.pv-empty[data-v-280fb755]{color:#94a3b8;font-size:13px}.pv-drop-indicator[data-v-280fb755]{position:absolute;z-index:50;pointer-events:none;--pv-drop: #3b82f6}.pv-drop-box[data-v-280fb755]{outline:2px dashed var(--pv-drop);outline-offset:1px;border-radius:4px;background:#3b82f614}.pv-drop-line[data-v-280fb755]{background:var(--pv-drop);border-radius:2px}.pv-grab[data-v-280fb755]{position:absolute;z-index:60;display:flex;align-items:center;justify-content:center;width:18px;height:18px;margin-top:-9px;margin-left:-9px;border-radius:4px;background:#2563eb;color:#fff;font-size:11px;line-height:1;cursor:grab;-webkit-user-select:none;user-select:none;box-shadow:0 1px 3px #0000004d}.pv-grab[data-v-280fb755]:active{cursor:grabbing}