@fmsim/board 2.0.0-beta.9 → 2.0.0-beta.93

package/dist/src/modeller/bulk-create.d.ts

@@ -0,0 +1,101 @@
+export type Pattern = 'grid' | 'line-h' | 'line-v';
+export interface Area {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface BulkCreateOptions {
+    /** 복제할 원본 컴포넌트 state. id, left, top 제외하고 모두 상속. */
+    template: Record<string, any>;
+    /** 타겟 영역 (보드 좌표). */
+    area: Area;
+    /** 분포 패턴. */
+    pattern: Pattern;
+    /**
+     * 총 개수. grid 패턴에선 rows × cols 로 분해.
+     * rows/cols 가 명시되면 그것 사용, 미명시 시 area 비율과 count 로 자동 결정.
+     */
+    count: number;
+    /** grid pattern 용 — 행 수. 미지정 시 area 비율 + count 로 자동. */
+    rows?: number;
+    /** grid pattern 용 — 열 수. 미지정 시 area 비율 + count 로 자동. */
+    cols?: number;
+    /**
+     * ID 패턴. placeholder:
+     *   `{i}` — 일련번호 (0-based + idStart)
+     *   `{r}` — 행 index (grid 만, 0-based + idStart)
+     *   `{c}` — 열 index (grid 만, 0-based + idStart)
+     * 예: "PORT_{i}", "P_{r}_{c}", "CELL{r}{c}"
+     */
+    idPattern: string;
+    /** ID 시작 번호. default 1. */
+    idStart?: number;
+    /** ID 숫자 자릿수 (zero-pad). 0 = 미적용. default 0. */
+    idPadding?: number;
+    /**
+     * 컴포넌트의 크기를 사용할지 (= template.width/height 그대로) 또는 cell 에
+     * 맞춰 자동 조정할지. default 'template' (원본 크기 유지).
+     */
+    sizeMode?: 'template' | 'fit-cell';
+}
+export interface GeneratedModel {
+    type?: string;
+    id: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    [key: string]: any;
+}
+/**
+ * 타겟 영역과 총 count 로 grid 의 (rows, cols) 자동 결정.
+ * area 의 종횡비를 가능한 한 보존.
+ */
+export declare function deriveGridShape(count: number, area: Area, rows?: number, cols?: number): {
+    rows: number;
+    cols: number;
+};
+/**
+ * 메인 헬퍼 — 옵션을 받아 새 컴포넌트 model 배열 반환.
+ *
+ * **주의**: 반환된 model 은 `scene.add(models)` 로 추가하면 된다. ID 충돌 사전
+ * 검사는 호출 측 책임 — `findIdConflicts` 와 결합 사용.
+ */
+export declare function generateBulkComponents(opts: BulkCreateOptions): GeneratedModel[];
+/**
+ * 생성될 model 의 id 중 기존 scene 의 id 와 충돌하는 것 검출.
+ * @returns 충돌하는 id 배열 (없으면 빈 배열).
+ */
+export declare function findIdConflicts(models: GeneratedModel[], existingIds: Iterable<string>): string[];
+/**
+ * 템플릿의 id 문자열로부터 다음 컴포넌트들의 ID 패턴을 자동 추론.
+ *
+ * 규칙:
+ *   - 끝에 숫자 있음: `"PORT_05"` → `{ pattern: "PORT_{i}", start: 6, padding: 2 }`
+ *   - 끝에 숫자 없음: `"abc"` → `{ pattern: "abc_{i}", start: 1, padding: 0 }`
+ *   - 빈 id: `{ pattern: "{i}", start: 1, padding: 0 }`
+ *
+ * padding 은 *leading zero* 가 있을 때만 적용:
+ *   - "05" → padding 2 (= "01", "02"... 형식 유지)
+ *   - "5" → padding 0 (= "1", "2"... 형식)
+ */
+export declare function inferIdPattern(id: string | undefined | null): {
+    pattern: string;
+    start: number;
+    padding: number;
+};
+/**
+ * 패턴이 매칭하는 기존 ID 들 중 *최대 번호 + 1* 반환 — 반복 bulk-create 시
+ * 시작 번호 자동 advance 용.
+ *
+ * 예:
+ *   pattern = "PORT_{i}", existingIds = ["PORT_05", "PORT_12", "Other_1"]
+ *   → 13 (= 12 + 1)
+ *
+ * 매칭 안 되면 fallbackStart 반환 (기본 inferIdPattern 의 start).
+ *
+ * NOTE: 현재 `{i}` placeholder 만 인식. `{r}` / `{c}` 는 grid 전용이므로 별도
+ * 처리 필요 (추후).
+ */
+export declare function nextAvailableStart(idPattern: string, existingIds: Iterable<string>, fallbackStart: number): number;

package/dist/src/modeller/bulk-create.js

@@ -0,0 +1,199 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * Bulk-create — 단일 템플릿 컴포넌트로부터 N개의 컴포넌트 model 을 일괄 생성
+ * 하는 순수 헬퍼 모음.
+ *
+ * 설계 원칙:
+ *   - 순수 함수 (UI / scene side-effect 없음)
+ *   - 도메인 중립 (factory, board-ai, fmsim, operato-* 등 모든 consumer 가 동일하게 사용)
+ *   - 의존성 0 (Three.js / Lit 불필요)
+ *
+ * 사용 패턴:
+ *   1. consumer 가 template (= 컴포넌트 model state) + area + 옵션 수집
+ *   2. generateBulkComponents() → 새 컴포넌트 model 배열 반환
+ *   3. scene.undoableChange(() => scene.add(models)) — 단일 undo 단위로 추가
+ *
+ * 결합 사용:
+ *   - deriveGridShape: 격자 패턴의 (rows, cols) 자동 결정
+ *   - inferIdPattern: 템플릿의 id 로부터 ID 패턴/시작/padding 자동 추출
+ *   - nextAvailableStart: 반복 호출 시 시작번호 자동 advance (existingIds 스캔)
+ *   - findIdConflicts: 생성될 ID 가 scene 의 기존 ID 와 충돌하는지 검출
+ */
+/**
+ * 타겟 영역과 총 count 로 grid 의 (rows, cols) 자동 결정.
+ * area 의 종횡비를 가능한 한 보존.
+ */
+export function deriveGridShape(count, area, rows, cols) {
+    if (rows && cols)
+        return { rows, cols };
+    if (rows)
+        return { rows, cols: Math.ceil(count / rows) };
+    if (cols)
+        return { rows: Math.ceil(count / cols), cols };
+    // 자동: area 의 종횡비와 비슷한 grid 도출.
+    // cols / rows ≈ width / height → cols ≈ sqrt(count × width / height)
+    const aspect = area.width / Math.max(area.height, 1);
+    const c = Math.max(1, Math.round(Math.sqrt(count * aspect)));
+    const r = Math.max(1, Math.ceil(count / c));
+    return { rows: r, cols: c };
+}
+/**
+ * ID 패턴 치환 — {i}, {r}, {c} placeholder.
+ */
+function formatId(pattern, i, r, c, start, padding) {
+    const pad = (n) => {
+        const v = n + start;
+        return padding > 0 ? String(v).padStart(padding, '0') : String(v);
+    };
+    return pattern
+        .replace(/\{i\}/g, pad(i))
+        .replace(/\{r\}/g, pad(r))
+        .replace(/\{c\}/g, pad(c));
+}
+/**
+ * 메인 헬퍼 — 옵션을 받아 새 컴포넌트 model 배열 반환.
+ *
+ * **주의**: 반환된 model 은 `scene.add(models)` 로 추가하면 된다. ID 충돌 사전
+ * 검사는 호출 측 책임 — `findIdConflicts` 와 결합 사용.
+ */
+export function generateBulkComponents(opts) {
+    const { template, area, pattern, count, idPattern, idStart = 1, idPadding = 0, sizeMode = 'template' } = opts;
+    if (count <= 0)
+        return [];
+    if (!template || typeof template !== 'object')
+        return [];
+    // template 에서 제외할 필드. id/위치 는 새로 생성. (width/height 는 sizeMode 에 따라 처리)
+    const { id: _id, left: _l, top: _t, width: _w, height: _h, ...rest } = template;
+    const tplW = typeof template.width === 'number' ? template.width : 50;
+    const tplH = typeof template.height === 'number' ? template.height : 50;
+    const result = [];
+    if (pattern === 'grid') {
+        const { rows, cols } = deriveGridShape(count, area, opts.rows, opts.cols);
+        const cellW = area.width / cols;
+        const cellH = area.height / rows;
+        const itemW = sizeMode === 'fit-cell' ? Math.min(cellW, cellH) * 0.8 : tplW;
+        const itemH = sizeMode === 'fit-cell' ? Math.min(cellW, cellH) * 0.8 : tplH;
+        let i = 0;
+        outer: for (let r = 0; r < rows; r++) {
+            for (let c = 0; c < cols; c++) {
+                if (i >= count)
+                    break outer;
+                const cx = area.left + cellW * (c + 0.5);
+                const cy = area.top + cellH * (r + 0.5);
+                result.push({
+                    ...rest,
+                    id: formatId(idPattern, i, r, c, idStart, idPadding),
+                    left: cx - itemW / 2,
+                    top: cy - itemH / 2,
+                    width: itemW,
+                    height: itemH
+                });
+                i++;
+            }
+        }
+    }
+    else if (pattern === 'line-h' || pattern === 'line-v') {
+        const isH = pattern === 'line-h';
+        const span = isH ? area.width : area.height;
+        const cellSize = span / count;
+        const itemW = sizeMode === 'fit-cell' && isH ? cellSize * 0.8 : tplW;
+        const itemH = sizeMode === 'fit-cell' && !isH ? cellSize * 0.8 : tplH;
+        for (let i = 0; i < count; i++) {
+            const along = (i + 0.5) * cellSize;
+            const cx = isH ? area.left + along : area.left + area.width / 2;
+            const cy = isH ? area.top + area.height / 2 : area.top + along;
+            result.push({
+                ...rest,
+                id: formatId(idPattern, i, 0, i, idStart, idPadding),
+                left: cx - itemW / 2,
+                top: cy - itemH / 2,
+                width: itemW,
+                height: itemH
+            });
+        }
+    }
+    return result;
+}
+/**
+ * 생성될 model 의 id 중 기존 scene 의 id 와 충돌하는 것 검출.
+ * @returns 충돌하는 id 배열 (없으면 빈 배열).
+ */
+export function findIdConflicts(models, existingIds) {
+    const set = existingIds instanceof Set ? existingIds : new Set(existingIds);
+    const conflicts = [];
+    for (const m of models) {
+        if (set.has(m.id))
+            conflicts.push(m.id);
+    }
+    return conflicts;
+}
+/**
+ * 템플릿의 id 문자열로부터 다음 컴포넌트들의 ID 패턴을 자동 추론.
+ *
+ * 규칙:
+ *   - 끝에 숫자 있음: `"PORT_05"` → `{ pattern: "PORT_{i}", start: 6, padding: 2 }`
+ *   - 끝에 숫자 없음: `"abc"` → `{ pattern: "abc_{i}", start: 1, padding: 0 }`
+ *   - 빈 id: `{ pattern: "{i}", start: 1, padding: 0 }`
+ *
+ * padding 은 *leading zero* 가 있을 때만 적용:
+ *   - "05" → padding 2 (= "01", "02"... 형식 유지)
+ *   - "5" → padding 0 (= "1", "2"... 형식)
+ */
+export function inferIdPattern(id) {
+    if (!id || typeof id !== 'string') {
+        return { pattern: '{i}', start: 1, padding: 0 };
+    }
+    const m = id.match(/^(.*?)(\d+)$/);
+    if (m) {
+        const prefix = m[1];
+        const numStr = m[2];
+        const num = parseInt(numStr, 10);
+        const padding = numStr.length > 1 && numStr.startsWith('0') ? numStr.length : 0;
+        return {
+            pattern: `${prefix}{i}`,
+            start: num + 1,
+            padding
+        };
+    }
+    return {
+        pattern: `${id}_{i}`,
+        start: 1,
+        padding: 0
+    };
+}
+/**
+ * 패턴이 매칭하는 기존 ID 들 중 *최대 번호 + 1* 반환 — 반복 bulk-create 시
+ * 시작 번호 자동 advance 용.
+ *
+ * 예:
+ *   pattern = "PORT_{i}", existingIds = ["PORT_05", "PORT_12", "Other_1"]
+ *   → 13 (= 12 + 1)
+ *
+ * 매칭 안 되면 fallbackStart 반환 (기본 inferIdPattern 의 start).
+ *
+ * NOTE: 현재 `{i}` placeholder 만 인식. `{r}` / `{c}` 는 grid 전용이므로 별도
+ * 처리 필요 (추후).
+ */
+export function nextAvailableStart(idPattern, existingIds, fallbackStart) {
+    if (!idPattern.includes('{i}'))
+        return fallbackStart;
+    // pattern → regex. {i} → 캡쳐, {r}/{c} → 그냥 숫자, 특수문자 escape.
+    const escaped = idPattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp('^' +
+        escaped
+            .replace(/\\\{i\\\}/g, '(\\d+)')
+            .replace(/\\\{[rc]\\\}/g, '\\d+') +
+        '$');
+    let max = -1;
+    for (const id of existingIds) {
+        const m = id.match(re);
+        if (m) {
+            const n = parseInt(m[1], 10);
+            if (!Number.isNaN(n) && n > max)
+                max = n;
+        }
+    }
+    return max >= 0 ? max + 1 : fallbackStart;
+}
+//# sourceMappingURL=bulk-create.js.map

package/dist/src/modeller/bulk-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-create.js","sourceRoot":"","sources":["../../../src/modeller/bulk-create.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Bulk-create — 단일 템플릿 컴포넌트로부터 N개의 컴포넌트 model 을 일괄 생성\n * 하는 순수 헬퍼 모음.\n *\n * 설계 원칙:\n *   - 순수 함수 (UI / scene side-effect 없음)\n *   - 도메인 중립 (factory, board-ai, fmsim, operato-* 등 모든 consumer 가 동일하게 사용)\n *   - 의존성 0 (Three.js / Lit 불필요)\n *\n * 사용 패턴:\n *   1. consumer 가 template (= 컴포넌트 model state) + area + 옵션 수집\n *   2. generateBulkComponents() → 새 컴포넌트 model 배열 반환\n *   3. scene.undoableChange(() => scene.add(models)) — 단일 undo 단위로 추가\n *\n * 결합 사용:\n *   - deriveGridShape: 격자 패턴의 (rows, cols) 자동 결정\n *   - inferIdPattern: 템플릿의 id 로부터 ID 패턴/시작/padding 자동 추출\n *   - nextAvailableStart: 반복 호출 시 시작번호 자동 advance (existingIds 스캔)\n *   - findIdConflicts: 생성될 ID 가 scene 의 기존 ID 와 충돌하는지 검출\n */\n\nexport type Pattern = 'grid' | 'line-h' | 'line-v'\n\nexport interface Area {\n  left: number\n  top: number\n  width: number\n  height: number\n}\n\nexport interface BulkCreateOptions {\n  /** 복제할 원본 컴포넌트 state. id, left, top 제외하고 모두 상속. */\n  template: Record<string, any>\n  /** 타겟 영역 (보드 좌표). */\n  area: Area\n  /** 분포 패턴. */\n  pattern: Pattern\n  /**\n   * 총 개수. grid 패턴에선 rows × cols 로 분해.\n   * rows/cols 가 명시되면 그것 사용, 미명시 시 area 비율과 count 로 자동 결정.\n   */\n  count: number\n  /** grid pattern 용 — 행 수. 미지정 시 area 비율 + count 로 자동. */\n  rows?: number\n  /** grid pattern 용 — 열 수. 미지정 시 area 비율 + count 로 자동. */\n  cols?: number\n  /**\n   * ID 패턴. placeholder:\n   *   `{i}` — 일련번호 (0-based + idStart)\n   *   `{r}` — 행 index (grid 만, 0-based + idStart)\n   *   `{c}` — 열 index (grid 만, 0-based + idStart)\n   * 예: \"PORT_{i}\", \"P_{r}_{c}\", \"CELL{r}{c}\"\n   */\n  idPattern: string\n  /** ID 시작 번호. default 1. */\n  idStart?: number\n  /** ID 숫자 자릿수 (zero-pad). 0 = 미적용. default 0. */\n  idPadding?: number\n  /**\n   * 컴포넌트의 크기를 사용할지 (= template.width/height 그대로) 또는 cell 에\n   * 맞춰 자동 조정할지. default 'template' (원본 크기 유지).\n   */\n  sizeMode?: 'template' | 'fit-cell'\n}\n\nexport interface GeneratedModel {\n  type?: string\n  id: string\n  left: number\n  top: number\n  width: number\n  height: number\n  [key: string]: any\n}\n\n/**\n * 타겟 영역과 총 count 로 grid 의 (rows, cols) 자동 결정.\n * area 의 종횡비를 가능한 한 보존.\n */\nexport function deriveGridShape(\n  count: number,\n  area: Area,\n  rows?: number,\n  cols?: number\n): { rows: number; cols: number } {\n  if (rows && cols) return { rows, cols }\n  if (rows) return { rows, cols: Math.ceil(count / rows) }\n  if (cols) return { rows: Math.ceil(count / cols), cols }\n\n  // 자동: area 의 종횡비와 비슷한 grid 도출.\n  // cols / rows ≈ width / height → cols ≈ sqrt(count × width / height)\n  const aspect = area.width / Math.max(area.height, 1)\n  const c = Math.max(1, Math.round(Math.sqrt(count * aspect)))\n  const r = Math.max(1, Math.ceil(count / c))\n  return { rows: r, cols: c }\n}\n\n/**\n * ID 패턴 치환 — {i}, {r}, {c} placeholder.\n */\nfunction formatId(\n  pattern: string,\n  i: number,\n  r: number,\n  c: number,\n  start: number,\n  padding: number\n): string {\n  const pad = (n: number) => {\n    const v = n + start\n    return padding > 0 ? String(v).padStart(padding, '0') : String(v)\n  }\n  return pattern\n    .replace(/\\{i\\}/g, pad(i))\n    .replace(/\\{r\\}/g, pad(r))\n    .replace(/\\{c\\}/g, pad(c))\n}\n\n/**\n * 메인 헬퍼 — 옵션을 받아 새 컴포넌트 model 배열 반환.\n *\n * **주의**: 반환된 model 은 `scene.add(models)` 로 추가하면 된다. ID 충돌 사전\n * 검사는 호출 측 책임 — `findIdConflicts` 와 결합 사용.\n */\nexport function generateBulkComponents(opts: BulkCreateOptions): GeneratedModel[] {\n  const {\n    template,\n    area,\n    pattern,\n    count,\n    idPattern,\n    idStart = 1,\n    idPadding = 0,\n    sizeMode = 'template'\n  } = opts\n\n  if (count <= 0) return []\n  if (!template || typeof template !== 'object') return []\n\n  // template 에서 제외할 필드. id/위치 는 새로 생성. (width/height 는 sizeMode 에 따라 처리)\n  const { id: _id, left: _l, top: _t, width: _w, height: _h, ...rest } = template\n\n  const tplW = typeof template.width === 'number' ? template.width : 50\n  const tplH = typeof template.height === 'number' ? template.height : 50\n\n  const result: GeneratedModel[] = []\n\n  if (pattern === 'grid') {\n    const { rows, cols } = deriveGridShape(count, area, opts.rows, opts.cols)\n    const cellW = area.width / cols\n    const cellH = area.height / rows\n    const itemW = sizeMode === 'fit-cell' ? Math.min(cellW, cellH) * 0.8 : tplW\n    const itemH = sizeMode === 'fit-cell' ? Math.min(cellW, cellH) * 0.8 : tplH\n\n    let i = 0\n    outer: for (let r = 0; r < rows; r++) {\n      for (let c = 0; c < cols; c++) {\n        if (i >= count) break outer\n        const cx = area.left + cellW * (c + 0.5)\n        const cy = area.top + cellH * (r + 0.5)\n        result.push({\n          ...rest,\n          id: formatId(idPattern, i, r, c, idStart, idPadding),\n          left: cx - itemW / 2,\n          top: cy - itemH / 2,\n          width: itemW,\n          height: itemH\n        })\n        i++\n      }\n    }\n  } else if (pattern === 'line-h' || pattern === 'line-v') {\n    const isH = pattern === 'line-h'\n    const span = isH ? area.width : area.height\n    const cellSize = span / count\n    const itemW = sizeMode === 'fit-cell' && isH ? cellSize * 0.8 : tplW\n    const itemH = sizeMode === 'fit-cell' && !isH ? cellSize * 0.8 : tplH\n\n    for (let i = 0; i < count; i++) {\n      const along = (i + 0.5) * cellSize\n      const cx = isH ? area.left + along : area.left + area.width / 2\n      const cy = isH ? area.top + area.height / 2 : area.top + along\n      result.push({\n        ...rest,\n        id: formatId(idPattern, i, 0, i, idStart, idPadding),\n        left: cx - itemW / 2,\n        top: cy - itemH / 2,\n        width: itemW,\n        height: itemH\n      })\n    }\n  }\n\n  return result\n}\n\n/**\n * 생성될 model 의 id 중 기존 scene 의 id 와 충돌하는 것 검출.\n * @returns 충돌하는 id 배열 (없으면 빈 배열).\n */\nexport function findIdConflicts(\n  models: GeneratedModel[],\n  existingIds: Iterable<string>\n): string[] {\n  const set = existingIds instanceof Set ? existingIds : new Set(existingIds)\n  const conflicts: string[] = []\n  for (const m of models) {\n    if (set.has(m.id)) conflicts.push(m.id)\n  }\n  return conflicts\n}\n\n/**\n * 템플릿의 id 문자열로부터 다음 컴포넌트들의 ID 패턴을 자동 추론.\n *\n * 규칙:\n *   - 끝에 숫자 있음: `\"PORT_05\"` → `{ pattern: \"PORT_{i}\", start: 6, padding: 2 }`\n *   - 끝에 숫자 없음: `\"abc\"` → `{ pattern: \"abc_{i}\", start: 1, padding: 0 }`\n *   - 빈 id: `{ pattern: \"{i}\", start: 1, padding: 0 }`\n *\n * padding 은 *leading zero* 가 있을 때만 적용:\n *   - \"05\" → padding 2 (= \"01\", \"02\"... 형식 유지)\n *   - \"5\" → padding 0 (= \"1\", \"2\"... 형식)\n */\nexport function inferIdPattern(id: string | undefined | null): {\n  pattern: string\n  start: number\n  padding: number\n} {\n  if (!id || typeof id !== 'string') {\n    return { pattern: '{i}', start: 1, padding: 0 }\n  }\n  const m = id.match(/^(.*?)(\\d+)$/)\n  if (m) {\n    const prefix = m[1]\n    const numStr = m[2]\n    const num = parseInt(numStr, 10)\n    const padding = numStr.length > 1 && numStr.startsWith('0') ? numStr.length : 0\n    return {\n      pattern: `${prefix}{i}`,\n      start: num + 1,\n      padding\n    }\n  }\n  return {\n    pattern: `${id}_{i}`,\n    start: 1,\n    padding: 0\n  }\n}\n\n/**\n * 패턴이 매칭하는 기존 ID 들 중 *최대 번호 + 1* 반환 — 반복 bulk-create 시\n * 시작 번호 자동 advance 용.\n *\n * 예:\n *   pattern = \"PORT_{i}\", existingIds = [\"PORT_05\", \"PORT_12\", \"Other_1\"]\n *   → 13 (= 12 + 1)\n *\n * 매칭 안 되면 fallbackStart 반환 (기본 inferIdPattern 의 start).\n *\n * NOTE: 현재 `{i}` placeholder 만 인식. `{r}` / `{c}` 는 grid 전용이므로 별도\n * 처리 필요 (추후).\n */\nexport function nextAvailableStart(\n  idPattern: string,\n  existingIds: Iterable<string>,\n  fallbackStart: number\n): number {\n  if (!idPattern.includes('{i}')) return fallbackStart\n  // pattern → regex. {i} → 캡쳐, {r}/{c} → 그냥 숫자, 특수문자 escape.\n  const escaped = idPattern.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n  const re = new RegExp(\n    '^' +\n      escaped\n        .replace(/\\\\\\{i\\\\\\}/g, '(\\\\d+)')\n        .replace(/\\\\\\{[rc]\\\\\\}/g, '\\\\d+') +\n      '$'\n  )\n  let max = -1\n  for (const id of existingIds) {\n    const m = id.match(re)\n    if (m) {\n      const n = parseInt(m[1], 10)\n      if (!Number.isNaN(n) && n > max) max = n\n    }\n  }\n  return max >= 0 ? max + 1 : fallbackStart\n}\n"]}

package/dist/src/modeller/component-toolbar/component-menu.d.ts

@@ -5,7 +5,7 @@ import { LitElement, PropertyValues } from 'lit';
 import { Scene } from '@hatiolab/things-scene';
 import { Pallet, PalletItem } from '../../types';
 import { ComponentDetail } from './component-detail';
-declare const ComponentMenu_base: typeof LitElement & import("@open-wc/dedupe-mixin").Constructor<import("@open-wc/scoped-elements/types/src/types").ScopedElementsHost>;
+declare const ComponentMenu_base: typeof LitElement & import("@open-wc/dedupe-mixin").Constructor<import("@open-wc/scoped-elements/types.js").ScopedElementsHost>;
 export declare class ComponentMenu extends ComponentMenu_base {
     static styles: import("lit").CSSResult[];
     groups: Pallet[];

package/dist/src/modeller/component-toolbar/component-toolbar.d.ts

@@ -5,7 +5,7 @@ import { LitElement, PropertyValues } from 'lit';
 import { Scene, SceneMode } from '@hatiolab/things-scene';
 import { ComponentGroup } from '../../types';
 import { ComponentMenu } from './component-menu.js';
-declare const ComponentToolbar_base: typeof LitElement & import("@open-wc/dedupe-mixin").Constructor<import("@open-wc/scoped-elements/types/src/types").ScopedElementsHost>;
+declare const ComponentToolbar_base: typeof LitElement & import("@open-wc/dedupe-mixin").Constructor<import("@open-wc/scoped-elements/types.js").ScopedElementsHost>;
 export declare class ComponentToolbar extends ComponentToolbar_base {
     static styles: import("lit").CSSResult[];
     componentGroupList: ComponentGroup[];

package/dist/src/modeller/edit-toolbar.d.ts

@@ -3,6 +3,7 @@
  */
 import { LitElement, PropertyValues } from 'lit';
 import { Component, Scene } from '@hatiolab/things-scene';
+import './bulk-create-dialog.js';
 export declare class EditToolbar extends LitElement {
     static styles: import("lit").CSSResult[];
     scene?: Scene;
@@ -36,6 +37,18 @@ export declare class EditToolbar extends LitElement {
     onTapCopy(): Promise<void>;
     onTapPaste(): void;
     onTapDelete(): void;
+    /**
+     * 멀티 컴포넌트 일괄 붙여넣기 — Ctrl+Shift+V 진입점.
+     *
+     * 흐름:
+     *   1. 클립보드 (this.cliped) 검증 — *단일* 컴포넌트만 허용
+     *   2. scene.startBulkCreateMode → AddLayer 가 캔버스 위에 드래그 박스 그림
+     *   3. 사용자가 영역 드래그 → Promise resolve({area, template})
+     *      ESC/취소 → Promise resolve(null)
+     *   4. 영역이 결정되면 dialog 오픈
+     */
+    onBulkPaste(): Promise<void>;
+    private _openBulkCreateDialog;
     onTapSelectAll(): void;
     onTapFontIncrease(e: TouchEvent): void;
     onTapFontDecrease(e: TouchEvent): void;

package/dist/src/modeller/edit-toolbar.js

@@ -5,8 +5,54 @@ import { __decorate } from "tslib";
 import { html, LitElement } from 'lit';
 import { property, state } from 'lit/decorators.js';
 import { copyToClipboard, isMacOS } from '@operato/utils';
+import { OxPopup } from '@operato/popup';
 import { style } from './edit-toolbar-style';
+import './bulk-create-dialog.js';
 const MACOS = isMacOS();
+/**
+ * 컴포넌트 model JSON 만으로 type-aware bounding box (width, height) 추출.
+ *
+ * things-scene 의 component.bounds 는 *path 의 bounding box* 인데, model JSON 만
+ * 으로는 path 를 그릴 수 없으므로 type-specific 필드를 직접 본다.
+ *   - width/height 명시 (Rect, Container 등) → 그대로
+ *   - rx/ry (Ellipse 등) → 2*rx, 2*ry
+ *   - points 배열 (Line, Polygon 등) → 점들의 bounding box
+ *   - 그 외 → 50x50 fallback
+ *
+ * bulk-paste 가 영역 안에 N 개 복제할 때 *원본 크기를 보존* 하기 위해 사용.
+ */
+function deriveBoundsFromModel(model) {
+    if (typeof model.width === 'number' && typeof model.height === 'number') {
+        return { width: model.width, height: model.height };
+    }
+    if (typeof model.rx === 'number' && typeof model.ry === 'number') {
+        return { width: 2 * Math.abs(model.rx), height: 2 * Math.abs(model.ry) };
+    }
+    if (Array.isArray(model.points) && model.points.length > 0) {
+        let minX = Infinity;
+        let maxX = -Infinity;
+        let minY = Infinity;
+        let maxY = -Infinity;
+        for (const p of model.points) {
+            if (typeof (p === null || p === void 0 ? void 0 : p.x) === 'number') {
+                if (p.x < minX)
+                    minX = p.x;
+                if (p.x > maxX)
+                    maxX = p.x;
+            }
+            if (typeof (p === null || p === void 0 ? void 0 : p.y) === 'number') {
+                if (p.y < minY)
+                    minY = p.y;
+                if (p.y > maxY)
+                    maxY = p.y;
+            }
+        }
+        if (isFinite(minX) && isFinite(maxX) && isFinite(minY) && isFinite(maxY)) {
+            return { width: maxX - minX, height: maxY - minY };
+        }
+    }
+    return { width: 50, height: 50 };
+}
 export class EditToolbar extends LitElement {
     constructor() {
         super(...arguments);
@@ -246,7 +292,13 @@ export class EditToolbar extends LitElement {
                     this.onTapCut();
                 break;
             case 'KeyV':
-                if (ctrlKey && !shiftKey) {
+                if (ctrlKey && shiftKey && !altKey) {
+                    // Ctrl+Shift+V = Bulk Paste (Paste Special 컨벤션) — 클립보드의
+                    // 단일 컴포넌트를 N개로 일괄 붙여넣기.
+                    this.onBulkPaste();
+                    defaultPrevent = true;
+                }
+                else if (ctrlKey && !shiftKey) {
                     this.onTapPaste();
                     defaultPrevent = false;
                 }
@@ -266,21 +318,35 @@ export class EditToolbar extends LitElement {
                         this.onTapUngroup();
                 }
                 break;
-            case 'KeyF':
+            case 'BracketRight':
+                // Ctrl+] = Bring Forward, Ctrl+Shift+] = Bring to Front
+                // (Photoshop / Illustrator 표준 컨벤션)
                 if (this._dimension === '2d') {
-                    if (ctrlKey && !shiftKey)
+                    if (ctrlKey && !shiftKey) {
                         (_a = this.scene) === null || _a === void 0 ? void 0 : _a.zorder('forward');
-                    else if (ctrlKey && shiftKey)
+                        defaultPrevent = true;
+                    }
+                    else if (ctrlKey && shiftKey) {
                         (_b = this.scene) === null || _b === void 0 ? void 0 : _b.zorder('front');
+                        defaultPrevent = true;
+                    }
                 }
                 break;
-            case 'KeyB':
+            case 'BracketLeft':
+                // Ctrl+[ = Send Backward, Ctrl+Shift+[ = Send to Back
                 if (this._dimension === '2d') {
-                    if (ctrlKey && !shiftKey)
+                    if (ctrlKey && !shiftKey) {
                         (_c = this.scene) === null || _c === void 0 ? void 0 : _c.zorder('backward');
-                    else if (ctrlKey && shiftKey)
+                        defaultPrevent = true;
+                    }
+                    else if (ctrlKey && shiftKey) {
                         (_d = this.scene) === null || _d === void 0 ? void 0 : _d.zorder('back');
+                        defaultPrevent = true;
+                    }
                 }
+                break;
+            case 'KeyB':
+                // zorder 는 BracketLeft 로 이동. KeyB 의 Alt+Shift+B = align bottom 만 유지.
                 if (altKey && shiftKey)
                     this.onTapAlign('bottom');
                 break;
@@ -458,6 +524,101 @@ export class EditToolbar extends LitElement {
         var _a;
         (_a = this.scene) === null || _a === void 0 ? void 0 : _a.remove();
     }
+    /**
+     * 멀티 컴포넌트 일괄 붙여넣기 — Ctrl+Shift+V 진입점.
+     *
+     * 흐름:
+     *   1. 클립보드 (this.cliped) 검증 — *단일* 컴포넌트만 허용
+     *   2. scene.startBulkCreateMode → AddLayer 가 캔버스 위에 드래그 박스 그림
+     *   3. 사용자가 영역 드래그 → Promise resolve({area, template})
+     *      ESC/취소 → Promise resolve(null)
+     *   4. 영역이 결정되면 dialog 오픈
+     */
+    async onBulkPaste() {
+        var _a;
+        if (!this.cliped) {
+            console.warn('bulk-paste: 먼저 Ctrl+C 로 컴포넌트를 복사하세요.');
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(this.cliped);
+        }
+        catch (e) {
+            console.warn('bulk-paste: 클립보드 파싱 실패', e);
+            return;
+        }
+        if (!Array.isArray(parsed) || parsed.length === 0) {
+            console.warn('bulk-paste: 클립보드 비어있음');
+            return;
+        }
+        if (parsed.length > 1) {
+            console.warn('bulk-paste: 단일 컴포넌트만 일괄 붙여넣기 가능. 다중은 일반 paste 사용.');
+            return;
+        }
+        const template = parsed[0];
+        // bulk 모드 임을 시각 구분하기 위해 파란 점선 (일반 add 의 검정과 색만 차별).
+        const result = await ((_a = this.scene) === null || _a === void 0 ? void 0 : _a.startBulkCreateMode(template, { boxStrokeStyle: '#2964c2' }));
+        if (result) {
+            this._openBulkCreateDialog(template, result.area);
+        }
+    }
+    _openBulkCreateDialog(template, initialArea) {
+        var _a;
+        const dialogEl = document.createElement('bulk-create-dialog');
+        dialogEl.template = template;
+        dialogEl.initialArea = initialArea;
+        // 충돌 검사용 — scene 의 모든 컴포넌트 id 수집.
+        // (scene.ids 는 indexMap 기반인데 fmsim 의 일부 컴포넌트는 indexMap 미등록
+        //  되는 케이스가 있어 직접 컴포넌트 트리 walk.)
+        const existingIds = new Set();
+        const collectIds = (comp) => {
+            var _a, _b, _c;
+            if (!comp)
+                return;
+            const id = (_b = (_a = comp === null || comp === void 0 ? void 0 : comp.state) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : (_c = comp === null || comp === void 0 ? void 0 : comp.model) === null || _c === void 0 ? void 0 : _c.id;
+            if (typeof id === 'string' && id)
+                existingIds.add(id);
+            const children = comp.components || [];
+            for (const c of children)
+                collectIds(c);
+        };
+        const root = (_a = this.scene) === null || _a === void 0 ? void 0 : _a.root;
+        if (root)
+            collectIds(root);
+        dialogEl.existingIds = existingIds;
+        dialogEl.onConfirm = (models) => {
+            const scene = this.scene;
+            if (!scene || !models.length) {
+                popup === null || popup === void 0 ? void 0 : popup.close();
+                return;
+            }
+            // cliped 의 template model 자체에서 type-aware bounds 추출. things-scene 의
+            // component.bounds (= path bounding box) 와 동일 결과를 model JSON 의
+            // type-specific 필드 (width/height, rx/ry, points) 만으로 계산.
+            const bounds = deriveBoundsFromModel(template);
+            scene.undoableChange(() => {
+                for (const m of models) {
+                    const cx = m.left + m.width / 2;
+                    const cy = m.top + m.height / 2;
+                    scene.add(m, {
+                        left: cx - bounds.width / 2,
+                        top: cy - bounds.height / 2,
+                        width: bounds.width,
+                        height: bounds.height
+                    });
+                }
+            });
+            popup === null || popup === void 0 ? void 0 : popup.close();
+        };
+        dialogEl.onCancel = () => {
+            popup === null || popup === void 0 ? void 0 : popup.close();
+        };
+        const popup = OxPopup.open({
+            template: dialogEl,
+            backdrop: true
+        });
+    }
     onTapSelectAll() {
         var _a;
         (_a = this.scene) === null || _a === void 0 ? void 0 : _a.select('(child)');