@g1cloud/bpmn-modeler-next 5.0.0-beta.8 → 5.0.0-beta.9

package/dist/command/setTranslations.d.ts

@@ -0,0 +1,42 @@
+/** 커맨드 이름 — bwl 소유 네임스페이스(`bwl.updateTranslation` 과 같은 소유권 경계). */
+export declare const SET_TRANSLATIONS_COMMAND = "bwl.setTranslations";
+type Any = any;
+/** 확인 요청 표식 한 건의 값 — moddle 객체와 무관한 비교 단위. */
+export interface ReviewRequestValue {
+    locale: string;
+    sourceLocale?: string;
+    previous: string;
+}
+export interface SetTranslationsContext {
+    element: Any;
+    /**
+     * 쓸 문구 — 문서 언어 **전부**(validator 가 보장한다). `undefined` = 문구를 쓰지 않는다(확인만) ·
+     * `null` = 라벨 제거(문서 언어 칸과 표식을 전부 걷는다 — `name` 은 하강이 이미 지웠다).
+     */
+    texts?: Record<string, string> | null;
+    /** 문구를 바꾸지 않고 해소할 확인 요청의 언어들(`translation.confirm`). */
+    confirm?: string[];
+    designLocale: string;
+    /** 문서 언어(설계 + 병기). */
+    locales: string[];
+    /** 루트 `xml:lang`. */
+    rootLang?: string;
+    /** 배치 직전 상태 — 「바뀌었나」 판정과 표식의 출발점. 새 요소는 둘 다 비어 있다. */
+    before: {
+        texts: Record<string, string>;
+        requests: ReviewRequestValue[];
+    };
+}
+interface ExecutedContext extends SetTranslationsContext {
+    undo: Array<() => void>;
+}
+export declare class SetTranslationsHandler {
+    private moddle;
+    static $inject: string[];
+    constructor(moddle: Any);
+    execute(ctx: ExecutedContext): Any[];
+    revert(ctx: ExecutedContext): Any[];
+}
+/** 요소의 확인 요청 표식을 비교 단위 값으로 읽는다(배치 직전 스냅샷용). */
+export declare function reviewRequestValuesOf(bo: Any): ReviewRequestValue[];
+export {};

package/dist/command/translationCommands.d.ts

@@ -0,0 +1,11 @@
+type Any = any;
+export declare class TranslationCommands {
+    static $inject: string[];
+    constructor(commandStack: Any);
+}
+/** bpmn-js 모듈 — 서비스 이름 = `translationCommands`. 헤드리스 기본 셋(`HEADLESS_BPMN_MODULES`)에 들어 있다. */
+export declare const TranslationCommandsModule: {
+    __init__: string[];
+    translationCommands: (string | typeof TranslationCommands)[];
+};
+export {};

package/dist/core/ir.d.ts

@@ -64,9 +64,35 @@ export declare function isIrEventDefinition(v: unknown): v is IrEventDefinition;
  * 어휘 안의 것일 때만** 값을 낸다 — 다중 정의(BPMN 의 multiple 이벤트)와 어휘 밖 정의는 undefined.
  */
 export declare function irEventDefinitionOf(definitionTypes: readonly string[]): IrEventDefinition | undefined;
+/**
+ * **문구 로케일 어휘**(B-4 ④ · 2026-10-02) — 다국어 그룹의 op 가 문구마다 붙이는 로케일의 닫힌 집합.
+ *
+ * 🔴 **열린 맵이 아니라 닫힌 집합인 이유** — op 스키마는 Anthropic 엄격 서브셋을 지킨다(`strictSubset.ts`)는데
+ * 그 서브셋은 `additionalProperties` 에 false 밖에 못 쓴다. 로케일을 키로 받는 맵은 **키를 열거해야만** 표현된다.
+ * 값은 호스트 그룹 설정의 선택지(`GROUP_DOC_LOCALES` = ko · en · ja · zh)와 같다 — 🔴 **호스트 선택지는 이 집합의
+ * 부분집합이어야 한다**(밖의 언어를 문서 언어로 켜면 에이전트가 그 칸을 스키마상 쓸 수 없어 「전 언어 필수」를
+ * 영원히 못 채운다). 늘릴 때는 additive 다(불변식 5).
+ *
+ * 실제로 요구되는 언어는 이 집합이 아니라 **그 그룹의 문서 언어**(설계 + 병기)다 — validator 가 집행한다.
+ */
+export declare const IR_TEXT_LOCALES: readonly ["ko", "en", "ja", "zh"];
+export type IrTextLocale = (typeof IR_TEXT_LOCALES)[number];
+export declare function isIrTextLocale(v: unknown): v is IrTextLocale;
+/**
+ * 로케일 → 문구 (B-4 ④). 다국어 그룹에서 평문 `name`/`text` 대신 쓰는 짝 필드(`names`/`texts`)의 형태다.
+ *
+ * - **write** — 그 그룹의 문서 언어(설계 + 병기)를 **전부** 담아야 한다(빠지거나 밖의 언어면 거부). 평문과 함께
+ *   주면 모호해 거부한다(🔁 A-5 `condition-name-conflict`). `name` 은 설계 언어 문구로 하강한다.
+ * - **read** — 문서 언어 중 **문구가 있는 칸만** 담는다. 빠진 키 = 그 언어로는 미번역이다.
+ *
+ * 기능이 꺼진 그룹(문서 언어 미설정)은 지금처럼 평문만 쓴다 — 이 필드를 주면 거부한다.
+ */
+export type IrLocaleTexts = Partial<Record<IrTextLocale, string>>;
 export interface IrLane {
     id: string;
     name?: string;
+    /** 다국어 그룹의 이름(B-4 ④ — `IrLocaleTexts`). `name` 과 동시 지정 금지. */
+    names?: IrLocaleTexts;
 }
 /**
  * 풀(participant). 레인은 풀 정의에 선언하고 노드가 `lane` 인자로 배정된다(A-3) —
@@ -75,6 +101,8 @@ export interface IrLane {
 export interface IrParticipant {
     id: string;
     name?: string;
+    /** 다국어 그룹의 이름(B-4 ④ — `IrLocaleTexts`). `name` 과 동시 지정 금지. */
+    names?: IrLocaleTexts;
     /** true 면 내부 프로세스 없는 블랙박스 풀 */
     blackBox?: boolean;
     lanes?: IrLane[];
@@ -83,6 +111,8 @@ export interface IrNode {
     id: string;
     type: IrFlowNodeType;
     name?: string;
+    /** 다국어 그룹의 이름(B-4 ④ — `IrLocaleTexts`). `name` 과 동시 지정 금지. */
+    names?: IrLocaleTexts;
     /** 소속 풀 (협업 문서) */
     participant?: string;
     /** 소속 레인 (A-3) */
@@ -112,6 +142,11 @@ export interface IrSequenceFlow {
     source: string;
     target: string;
     name?: string;
+    /**
+     * 다국어 그룹의 이름(B-4 ④ — `IrLocaleTexts`). 🔴 **다국어 그룹의 조건 라벨도 이것이다** — `condition.label` 은
+     * name 채널의 별칭이라(A-5) 평문 하나로는 언어를 못 싣는다. 그 그룹에서 `condition` 을 주면 거부한다.
+     */
+    names?: IrLocaleTexts;
     condition?: IrFlowCondition;
 }
 export interface IrMessageFlow {
@@ -119,10 +154,14 @@ export interface IrMessageFlow {
     source: string;
     target: string;
     name?: string;
+    /** 다국어 그룹의 이름(B-4 ④ — `IrLocaleTexts`). `name` 과 동시 지정 금지. */
+    names?: IrLocaleTexts;
 }
 export interface IrDataStore {
     id: string;
     name?: string;
+    /** 다국어 그룹의 이름(B-4 ④ — `IrLocaleTexts`). `name` 과 동시 지정 금지. */
+    names?: IrLocaleTexts;
 }
 /** 데이터 입출력 연관 (노드 ↔ 데이터 스토어, 방향 = source→target) */
 export interface IrDataAssociation {
@@ -133,7 +172,13 @@ export interface IrDataAssociation {
 }
 export interface IrTextAnnotation {
     id: string;
-    text: string;
+    /**
+     * 본문. read 는 늘 낸다(다국어 그룹이면 설계 언어 문구). write 는 이것 또는 `texts` 중 **하나**가 필수다 —
+     * 다국어 그룹은 `texts`, 기능이 꺼진 그룹은 `text`(B-4 ④ · 종전엔 늘 필수였다).
+     */
+    text?: string;
+    /** 다국어 그룹의 본문(B-4 ④ — `IrLocaleTexts`). `text` 와 동시 지정 금지. */
+    texts?: IrLocaleTexts;
 }
 /** 연관선 (주석 ↔ 요소) */
 export interface IrAssociation {
@@ -145,6 +190,8 @@ export interface IrAssociation {
 export interface IrGroup {
     id: string;
     name?: string;
+    /** 다국어 그룹의 이름(B-4 ④ — `IrLocaleTexts`). `name` 과 동시 지정 금지. */
+    names?: IrLocaleTexts;
     members?: string[];
 }
 /** describeProcess 가 반환하는 문서 전체 파생 뷰의 골격 */

package/dist/editor/controller.d.ts

@@ -68,6 +68,8 @@ export interface BpmnEditorController extends CommandSeam {
     /**
      * 에이전트 배치 적용 — 단일 undo 에피소드. `applied` 의 `xml` 이 호스트 영속 페이로드다
      * (내부적으로 `saveXml()` 경로를 타므로 dirty 도 리셋된다 = "영속 진실로 내보낸 시점").
+     * 다국어 설정(`configureI18n`)이 걸려 있으면 그것이 그 문서의 문서 언어다 — op 의 문구는 `names`/`texts` 로
+     * 문서 언어 전부를 요구하고 평문은 거부된다(B-4 ④).
      */
     applyAgentBatch(batch: BpmnOpBatch, currentVersion: number): Promise<ApplyBatchOutcome>;
     /** 사용자 입력 잠금 — 에이전트 턴 시작/종료에서 호출. 프로그램 경로는 영향 없음. */

package/dist/headless/modeler.d.ts

@@ -4,10 +4,16 @@ import { default as CoreModule } from 'bpmn-js/lib/core';
 import { default as ModelingModule } from 'bpmn-js/lib/features/modeling';
 import { default as AutoPlaceModule } from 'bpmn-js/lib/features/auto-place';
 import { HeadlessDomOptions } from './dom';
-/** 헤드리스 하강에 필요한 최소 모듈 셋 — 이 목록이 곧 "에디터 없이 성립하는 표면"의 정의다. */
+/**
+ * 헤드리스 하강에 필요한 최소 모듈 셋 — 이 목록이 곧 "에디터 없이 성립하는 표면"의 정의다.
+ * `TranslationCommandsModule` = 번역 칸 커맨드(B-4 ④ — 다국어 그룹의 에이전트 op 가 쓴다 · 그래픽스 무관).
+ */
 export declare const HEADLESS_BPMN_MODULES: readonly [typeof CoreModule, {
     translate: (string | typeof import('diagram-js/lib/i18n/translate/translate').default)[];
-}, typeof ModelingModule, typeof AutoPlaceModule];
+}, typeof ModelingModule, typeof AutoPlaceModule, {
+    __init__: string[];
+    translationCommands: (string | typeof import('..').TranslationCommands)[];
+}];
 export interface HeadlessBpmnModelerOptions {
     /** 추가 모듈(호스트 확장). 기본 셋을 대체하지 않고 덧붙인다. */
     additionalModules?: ModuleDeclaration[];

package/dist/index.d.ts

@@ -4,6 +4,8 @@ export * from './core/hints';
 export * from './command/commandSeam';
 export * from './command/undoEpisode';
 export * from './command/updateTranslation';
+export * from './command/setTranslations';
+export * from './command/translationCommands';
 export * from './agent/symbolicOp';
 export * from './agent/schema';
 export * from './agent/resolver';

package/dist/view/i18nDisplay.d.ts

@@ -1,8 +1,9 @@
-export interface I18nDisplayConfig {
-    /** 설계 언어 — 고객에게 전달하는 설계 문서의 언어. `name` 이 따른다(B-4 Ⓐ). */
-    designLocale: string;
-    /** 병기 언어 — 함께 최신으로 유지할 언어들. 표시 언어 선택지는 설계 언어 + 이것. */
-    companionLocales: string[];
+import { BpmnDocumentLocales } from '../adapter/i18n';
+/**
+ * 다국어 표시 설정 — 문서 언어(`designLocale` = 설계 언어 · `name` 이 따른다 · `companionLocales` = 병기 언어 ·
+ * 표시 언어 선택지는 설계 언어 + 이것)에 표시 옵션을 더한다.
+ */
+export interface I18nDisplayConfig extends BpmnDocumentLocales {
     /**
      * 외부 라벨(이벤트 · 게이트웨이 · 흐름 · 그룹)을 표시 문구 폭으로 그린다 — 기본 켬.
      * 끄면 DI 폭(설계 언어 문구 기준)에서 줄바꿈되어 긴 문구가 세로 기둥이 된다(스파이크 F7 — 폭 19 ·
@@ -69,6 +70,10 @@ export declare class I18nDisplay {
 }
 /** bpmn-js 모듈 — `BpmnModelerView` 가 붙인다. 서비스 이름 = `i18nDisplay`. */
 export declare const I18nDisplayModule: {
+    __depends__: {
+        __init__: string[];
+        translationCommands: (string | typeof import('..').TranslationCommands)[];
+    }[];
     __init__: string[];
     i18nDisplay: (string | typeof I18nDisplay)[];
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@g1cloud/bpmn-modeler-next",
   "private": false,
-  "version": "5.0.0-beta.8",
+  "version": "5.0.0-beta.9",
   "description": "Vue 3 BPMN document authoring editor (bpmn-js based) with AI agent authoring",
   "type": "module",
   "files": [