@things-factory/board-ai 10.0.0-beta.108

package/dist-server/service/styling/text-tools.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSetTextOps = buildSetTextOps;
+exports.buildSetFontOps = buildSetFontOps;
+const color_utils_1 = require("./color-utils");
+// Canvas CanvasRenderingContext2D 가 허용하는 값만.
+// dash / lineCap / lineJoin 과 동일 패턴 — AI 가 비표준 값 ('serif-italic',
+// 'middle-align' 등) 을 보내도 Canvas 가 silent ignore → 효과 없는 op 가 그대로
+// 실행되는 것 방지.
+const VALID_FONT_STYLE = new Set(['normal', 'italic', 'oblique']);
+const VALID_TEXT_ALIGN = new Set(['start', 'end', 'left', 'right', 'center']);
+const VALID_TEXT_BASELINE = new Set([
+    'top',
+    'middle',
+    'bottom',
+    'hanging',
+    'alphabetic',
+    'ideographic'
+]);
+function buildSetTextOps(input) {
+    if (!Array.isArray(input.refids) || input.refids.length === 0) {
+        return { ops: [], errors: ['refids must be a non-empty array'] };
+    }
+    if (typeof input.text !== 'string') {
+        return { ops: [], errors: ['text must be a string'] };
+    }
+    const refids = input.refids.filter(n => typeof n === 'number' && Number.isFinite(n));
+    if (refids.length === 0)
+        return { ops: [], errors: ['No valid numeric refids'] };
+    const patch = { text: input.text };
+    return {
+        ops: refids.map(refid => ({ op: 'modify', refid, patch })),
+        errors: []
+    };
+}
+function buildSetFontOps(input) {
+    if (!Array.isArray(input.refids) || input.refids.length === 0) {
+        return { ops: [], errors: ['refids must be a non-empty array'] };
+    }
+    const refids = input.refids.filter(n => typeof n === 'number' && Number.isFinite(n));
+    if (refids.length === 0)
+        return { ops: [], errors: ['No valid numeric refids'] };
+    // 어느 인자도 없으면 무의미
+    const noOp = !(input.fontFamily ||
+        input.fontSize !== undefined ||
+        input.fontWeight !== undefined ||
+        input.fontStyle ||
+        input.fontColor ||
+        input.textAlign ||
+        input.textBaseline ||
+        input.lineHeight !== undefined);
+    if (noOp)
+        return { ops: [], errors: ['No font changes specified'] };
+    if (input.fontSize !== undefined && (input.fontSize <= 0 || !Number.isFinite(input.fontSize))) {
+        return { ops: [], errors: [`Invalid fontSize: ${input.fontSize}`] };
+    }
+    if (input.lineHeight !== undefined && input.lineHeight <= 0) {
+        return { ops: [], errors: [`Invalid lineHeight: ${input.lineHeight}`] };
+    }
+    if (input.fontColor !== undefined) {
+        const v = (0, color_utils_1.validateColor)(input.fontColor);
+        if (!v.valid)
+            return { ops: [], errors: [v.error ?? 'Invalid fontColor'] };
+    }
+    if (input.fontStyle !== undefined && !VALID_FONT_STYLE.has(input.fontStyle)) {
+        return {
+            ops: [],
+            errors: [`Unknown fontStyle: '${input.fontStyle}'. Valid: ${[...VALID_FONT_STYLE].join(' / ')}.`]
+        };
+    }
+    if (input.textAlign !== undefined && !VALID_TEXT_ALIGN.has(input.textAlign)) {
+        return {
+            ops: [],
+            errors: [`Unknown textAlign: '${input.textAlign}'. Valid: ${[...VALID_TEXT_ALIGN].join(' / ')}.`]
+        };
+    }
+    if (input.textBaseline !== undefined && !VALID_TEXT_BASELINE.has(input.textBaseline)) {
+        return {
+            ops: [],
+            errors: [`Unknown textBaseline: '${input.textBaseline}'. Valid: ${[...VALID_TEXT_BASELINE].join(' / ')}.`]
+        };
+    }
+    const patch = {};
+    if (input.fontFamily)
+        patch.fontFamily = input.fontFamily;
+    if (input.fontSize !== undefined)
+        patch.fontSize = input.fontSize;
+    if (input.fontWeight !== undefined)
+        patch.fontWeight = String(input.fontWeight);
+    if (input.fontStyle)
+        patch.fontStyle = input.fontStyle;
+    if (input.fontColor !== undefined)
+        patch.fontColor = (0, color_utils_1.normalizeColor)(input.fontColor);
+    if (input.textAlign)
+        patch.textAlign = input.textAlign;
+    if (input.textBaseline)
+        patch.textBaseline = input.textBaseline;
+    if (input.lineHeight !== undefined)
+        patch.lineHeight = input.lineHeight;
+    return {
+        ops: refids.map(refid => ({ op: 'modify', refid, patch })),
+        errors: []
+    };
+}
+//# sourceMappingURL=text-tools.js.map

package/dist-server/service/styling/text-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-tools.js","sourceRoot":"","sources":["../../../server/service/styling/text-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * setText / setFont — 컴포넌트의 텍스트 내용 / 폰트 스타일.\n *\n * setText: state.text 변경 (내용)\n * setFont: state.fontFamily / fontSize / fontWeight / fontStyle / fontColor /\n *          textAlign / textBaseline / lineHeight 변경 (폰트 스타일)\n *\n * 두 tool 분리 — 의도가 다름. 내용 변경 vs 시각 스타일.\n */\nimport type { BoardEditOp } from '../types'\nimport { normalizeColor, validateColor } from './color-utils'\n\nexport interface SetTextInput {\n  refids: number[]\n  text: string\n}\n\nexport interface SetFontInput {\n  refids: number[]\n  fontFamily?: string\n  fontSize?: number\n  fontWeight?: 'normal' | 'bold' | 'lighter' | 'bolder' | string | number\n  fontStyle?: 'normal' | 'italic' | 'oblique'\n  fontColor?: string\n  /** Canvas API 표준 — 'justify' 는 Canvas 미지원이라 제외. */\n  textAlign?: 'left' | 'center' | 'right' | 'start' | 'end'\n  textBaseline?: 'top' | 'middle' | 'bottom' | 'hanging' | 'alphabetic' | 'ideographic'\n  lineHeight?: number\n}\n\n// Canvas CanvasRenderingContext2D 가 허용하는 값만.\n// dash / lineCap / lineJoin 과 동일 패턴 — AI 가 비표준 값 ('serif-italic',\n// 'middle-align' 등) 을 보내도 Canvas 가 silent ignore → 효과 없는 op 가 그대로\n// 실행되는 것 방지.\nconst VALID_FONT_STYLE = new Set(['normal', 'italic', 'oblique'])\nconst VALID_TEXT_ALIGN = new Set(['start', 'end', 'left', 'right', 'center'])\nconst VALID_TEXT_BASELINE = new Set([\n  'top',\n  'middle',\n  'bottom',\n  'hanging',\n  'alphabetic',\n  'ideographic'\n])\n\nexport interface OpsResult {\n  ops: BoardEditOp[]\n  errors: string[]\n}\n\nexport function buildSetTextOps(input: SetTextInput): OpsResult {\n  if (!Array.isArray(input.refids) || input.refids.length === 0) {\n    return { ops: [], errors: ['refids must be a non-empty array'] }\n  }\n  if (typeof input.text !== 'string') {\n    return { ops: [], errors: ['text must be a string'] }\n  }\n  const refids = input.refids.filter(n => typeof n === 'number' && Number.isFinite(n))\n  if (refids.length === 0) return { ops: [], errors: ['No valid numeric refids'] }\n\n  const patch = { text: input.text }\n  return {\n    ops: refids.map(refid => ({ op: 'modify', refid, patch })),\n    errors: []\n  }\n}\n\nexport function buildSetFontOps(input: SetFontInput): OpsResult {\n  if (!Array.isArray(input.refids) || input.refids.length === 0) {\n    return { ops: [], errors: ['refids must be a non-empty array'] }\n  }\n  const refids = input.refids.filter(n => typeof n === 'number' && Number.isFinite(n))\n  if (refids.length === 0) return { ops: [], errors: ['No valid numeric refids'] }\n\n  // 어느 인자도 없으면 무의미\n  const noOp = !(\n    input.fontFamily ||\n    input.fontSize !== undefined ||\n    input.fontWeight !== undefined ||\n    input.fontStyle ||\n    input.fontColor ||\n    input.textAlign ||\n    input.textBaseline ||\n    input.lineHeight !== undefined\n  )\n  if (noOp) return { ops: [], errors: ['No font changes specified'] }\n\n  if (input.fontSize !== undefined && (input.fontSize <= 0 || !Number.isFinite(input.fontSize))) {\n    return { ops: [], errors: [`Invalid fontSize: ${input.fontSize}`] }\n  }\n  if (input.lineHeight !== undefined && input.lineHeight <= 0) {\n    return { ops: [], errors: [`Invalid lineHeight: ${input.lineHeight}`] }\n  }\n  if (input.fontColor !== undefined) {\n    const v = validateColor(input.fontColor)\n    if (!v.valid) return { ops: [], errors: [v.error ?? 'Invalid fontColor'] }\n  }\n  if (input.fontStyle !== undefined && !VALID_FONT_STYLE.has(input.fontStyle)) {\n    return {\n      ops: [],\n      errors: [`Unknown fontStyle: '${input.fontStyle}'. Valid: ${[...VALID_FONT_STYLE].join(' / ')}.`]\n    }\n  }\n  if (input.textAlign !== undefined && !VALID_TEXT_ALIGN.has(input.textAlign)) {\n    return {\n      ops: [],\n      errors: [`Unknown textAlign: '${input.textAlign}'. Valid: ${[...VALID_TEXT_ALIGN].join(' / ')}.`]\n    }\n  }\n  if (input.textBaseline !== undefined && !VALID_TEXT_BASELINE.has(input.textBaseline)) {\n    return {\n      ops: [],\n      errors: [`Unknown textBaseline: '${input.textBaseline}'. Valid: ${[...VALID_TEXT_BASELINE].join(' / ')}.`]\n    }\n  }\n\n  const patch: any = {}\n  if (input.fontFamily) patch.fontFamily = input.fontFamily\n  if (input.fontSize !== undefined) patch.fontSize = input.fontSize\n  if (input.fontWeight !== undefined) patch.fontWeight = String(input.fontWeight)\n  if (input.fontStyle) patch.fontStyle = input.fontStyle\n  if (input.fontColor !== undefined) patch.fontColor = normalizeColor(input.fontColor)\n  if (input.textAlign) patch.textAlign = input.textAlign\n  if (input.textBaseline) patch.textBaseline = input.textBaseline\n  if (input.lineHeight !== undefined) patch.lineHeight = input.lineHeight\n\n  return {\n    ops: refids.map(refid => ({ op: 'modify', refid, patch })),\n    errors: []\n  }\n}\n"]}

package/dist-server/service/subscribe-auth.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 구독 허용 여부 단언. 불가 시 throw (graphql-ws 가 구독 거부).
+ * - domain 없음 → 거부.
+ * - user 가 해당 subdomain 의 도메인 소속이 아니고 superUser 도 아니면 → 거부.
+ *
+ * 주의(버그 수정): process.superUserGranted 는 async(Promise<boolean>) 다. 기존 양쪽 spine 은
+ * `!process.superUserGranted(...)` 로 동기 평가해 `!Promise` = 항상 false → membership throw 가
+ * 발동하지 않는 fail-open 상태였다. 여기서는 await 로 제대로 평가한다 → subscribe 는 async.
+ *
+ * @param domain  context.state.domain
+ * @param user    context.state.user (domains[] / email 사용)
+ * @param isSuperUser  (domain, user) → boolean | Promise<boolean> (process.superUserGranted 주입)
+ */
+export declare function assertDomainSubscribeAllowed(domain: any, user: any, isSuperUser: (domain: any, user: any) => boolean | Promise<boolean>): Promise<void>;

package/dist-server/service/subscribe-auth.js

@@ -0,0 +1,33 @@
+"use strict";
+/*
+ * 구독 도메인 인증 게이트 — 순수 로직 (데코레이터·pubsub 없음 → 테스트 가능).
+ *
+ * 실시간 구독(@Subscription)은 같은 도메인 구성원만 허용해야 한다(도메인 격리 = 보안 핵심).
+ * 이 게이트는 board-patch / chat-message 양쪽 spine 의 subscribe 클로저가 공유한다
+ * (reuse — fork 금지). superUserGranted 는 process 전역 의존이라 주입받아 순수성 유지.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertDomainSubscribeAllowed = assertDomainSubscribeAllowed;
+/**
+ * 구독 허용 여부 단언. 불가 시 throw (graphql-ws 가 구독 거부).
+ * - domain 없음 → 거부.
+ * - user 가 해당 subdomain 의 도메인 소속이 아니고 superUser 도 아니면 → 거부.
+ *
+ * 주의(버그 수정): process.superUserGranted 는 async(Promise<boolean>) 다. 기존 양쪽 spine 은
+ * `!process.superUserGranted(...)` 로 동기 평가해 `!Promise` = 항상 false → membership throw 가
+ * 발동하지 않는 fail-open 상태였다. 여기서는 await 로 제대로 평가한다 → subscribe 는 async.
+ *
+ * @param domain  context.state.domain
+ * @param user    context.state.user (domains[] / email 사용)
+ * @param isSuperUser  (domain, user) → boolean | Promise<boolean> (process.superUserGranted 주입)
+ */
+async function assertDomainSubscribeAllowed(domain, user, isSuperUser) {
+    if (!domain) {
+        throw new Error('domain required');
+    }
+    const subdomain = domain?.subdomain;
+    if (!user?.domains?.find((d) => d.subdomain === subdomain) && !(await isSuperUser(domain, user))) {
+        throw new Error(`domain(${subdomain}) is not working for user(${user?.email}).`);
+    }
+}
+//# sourceMappingURL=subscribe-auth.js.map

package/dist-server/service/subscribe-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-auth.js","sourceRoot":"","sources":["../../server/service/subscribe-auth.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAeH,oEAYC;AAzBD;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,4BAA4B,CAChD,MAAW,EACX,IAAS,EACT,WAAmE;IAEnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;IACpC,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,CAAA;IACnC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QACtG,MAAM,IAAI,KAAK,CAAC,UAAU,SAAS,6BAA6B,IAAI,EAAE,KAAK,IAAI,CAAC,CAAA;IAClF,CAAC;AACH,CAAC","sourcesContent":["/*\n * 구독 도메인 인증 게이트 — 순수 로직 (데코레이터·pubsub 없음 → 테스트 가능).\n *\n * 실시간 구독(@Subscription)은 같은 도메인 구성원만 허용해야 한다(도메인 격리 = 보안 핵심).\n * 이 게이트는 board-patch / chat-message 양쪽 spine 의 subscribe 클로저가 공유한다\n * (reuse — fork 금지). superUserGranted 는 process 전역 의존이라 주입받아 순수성 유지.\n */\n\n/**\n * 구독 허용 여부 단언. 불가 시 throw (graphql-ws 가 구독 거부).\n * - domain 없음 → 거부.\n * - user 가 해당 subdomain 의 도메인 소속이 아니고 superUser 도 아니면 → 거부.\n *\n * 주의(버그 수정): process.superUserGranted 는 async(Promise<boolean>) 다. 기존 양쪽 spine 은\n * `!process.superUserGranted(...)` 로 동기 평가해 `!Promise` = 항상 false → membership throw 가\n * 발동하지 않는 fail-open 상태였다. 여기서는 await 로 제대로 평가한다 → subscribe 는 async.\n *\n * @param domain  context.state.domain\n * @param user    context.state.user (domains[] / email 사용)\n * @param isSuperUser  (domain, user) → boolean | Promise<boolean> (process.superUserGranted 주입)\n */\nexport async function assertDomainSubscribeAllowed(\n  domain: any,\n  user: any,\n  isSuperUser: (domain: any, user: any) => boolean | Promise<boolean>\n): Promise<void> {\n  if (!domain) {\n    throw new Error('domain required')\n  }\n  const subdomain = domain?.subdomain\n  if (!user?.domains?.find((d: any) => d.subdomain === subdomain) && !(await isSuperUser(domain, user))) {\n    throw new Error(`domain(${subdomain}) is not working for user(${user?.email}).`)\n  }\n}\n"]}

package/dist-server/service/types.d.ts

@@ -0,0 +1,265 @@
+/**
+ * Board AI — 자연어 채팅 인터페이스 타입 정의.
+ *
+ * 핵심 개념:
+ *   - 단일 진입점 `chat()`. 의도 분류(생성/편집/스타일/질문)는 AI 의 일.
+ *   - 출력은 항상 `ChatResponse`. 보드 변경이 있으면 `patch` 동봉.
+ *   - patch 의 op 는 직교 4 종 (add / remove / modify / replace).
+ *     style/move 등은 modify.patch 안에 흡수.
+ */
+import type { BoardComponent, BoardModel } from '@things-factory/board-import';
+export interface LLMMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface ChatOptions {
+    /** board-import 의 registry scope — 등록된 ImportRule 에서 type/category 후보 추출 */
+    scopes?: string[];
+    /** 사용 가능한 도메인 type (override). 미지정 시 scopes 에서 자동 추출 */
+    knownTypes?: string[];
+    /** 사용 가능한 카테고리 (override). 미지정 시 scopes 에서 자동 추출 */
+    categories?: string[];
+    /**
+     * 컴포넌트 type 별 유효 속성 스킴.
+     * LLM 이 정확한 컴포넌트 생성을 하도록 type 의 description, group, default model 키 전달.
+     *
+     * 예:
+     *   [{ type: 'rect', description: 'Rectangle', group: 'shape',
+     *      properties: { fillStyle: '#fff', strokeStyle: '#000' } }, ...]
+     */
+    componentSchemas?: ComponentSchema[];
+    /**
+     * 사용자가 모델러에서 현재 선택한 컴포넌트의 `refid` 목록.
+     *
+     * refid 는 things-scene 이 모든 컴포넌트에 자동 발급하는 universal numeric handle.
+     * id (데이터 바인딩 이름, unique 아님) 와는 다른 개념 — 선택은 항상 refid 로 표현.
+     */
+    selectedRefids?: number[];
+    /**
+     * popup 에서 사용자가 명시 선택한 #mention 매핑 — {token, refid}.
+     * server 가 mention 해석 시 이 매핑을 우선 사용. 본문엔 #token 만 남고
+     * refid 는 사용자에게 노출되지 않음 (LLM mention map 에만 첨부).
+     */
+    mentionPicks?: Array<{
+        token: string;
+        refid: number;
+    }>;
+    /** LLM 모델 override */
+    model?: string;
+    /** LLM 옵션 */
+    temperature?: number;
+    maxTokens?: number;
+    /**
+     * Tool 카테고리 (read/external) builder 가 사용할 컨텍스트.
+     *
+     * board-ai 자체는 ResolverContext / typeorm 을 직접 알지 않지만, 외부 도메인 패키지가
+     * 등록한 tool (예: board-import 의 importBoardAsync) 은 server-side 의존성 (도메인,
+     * 사용자, 트랜잭션) 이 필요할 수 있다. board-ai-resolver 가 ResolverContext.state 등을
+     * 이 필드로 전달하면, dispatch 시 closure 로 builder 의 ctx.state 에 주입.
+     *
+     * 미지정이면 외부 builder 는 ctx.state === undefined — 빈 응답이나 에러를 반환할 책임.
+     */
+    toolCallContext?: any;
+}
+export interface ComponentSchema {
+    type: string;
+    description?: string;
+    group?: string;
+    /**
+     * 좌표/크기/경로 관련 키들 — type 마다 다름.
+     * 예) ['left', 'top', 'width', 'height']  vs  ['cx', 'cy', 'radius']  vs  ['points']
+     * LLM 이 type 별 정확한 좌표 키를 사용하도록 명시.
+     */
+    geometryKeys?: string[];
+    /**
+     * 좌표 외 type 특화 속성 (style, value, min/max 등).
+     * default 값 또는 keys 만 — LLM 의 token 절감을 위해 호출자가 적절히 압축.
+     */
+    properties?: Record<string, any>;
+}
+/**
+ * AI 가 응답을 만드는 동안 호출한 도구의 시간순 trace.
+ *
+ * UX 목적 — 사용자가 "왜 이렇게 답했지" 의문 가질 때 fold-able 박스에서 확인.
+ * 디버그용 + 신뢰도 향상.
+ */
+export interface ToolUsage {
+    /** 도구 이름 (예: 'getSelection', 'modifyBoard', 'addComponent') */
+    name: string;
+    /** 호출 인자 JSON */
+    arguments: any;
+    /** 도구 결과 — read tool 은 실제 값 (truncated 가능), write tool 은 queued 마커 */
+    result: any;
+    /** read tool / write tool 분류 */
+    kind: 'read' | 'write' | 'unknown';
+}
+export interface ChatResponse {
+    /** 사용자에게 보여줄 텍스트 응답 */
+    reply: string;
+    /** 보드 변경이 있으면 patch */
+    patch?: BoardEditPatch;
+    /**
+     * Scene 조작 action (ephemeral — 모델 변경 없음 / undo 영향 없음).
+     * 시간순 시퀀스로 호스트가 things-scene API 직접 실행.
+     */
+    actions?: BoardActionOp[];
+    /** 모호한 입력 시 명확화 질문 (patch 없음) */
+    followUp?: string;
+    /** AI 가 응답 만드는 과정에서 호출한 도구들 (시간순). UI fold-able 박스용. */
+    toolUsages?: ToolUsage[];
+}
+export interface BoardEditPatch {
+    ops: BoardEditOp[];
+    /** 사용자 검수용 1-2 문장 요약 */
+    summary: string;
+    /** 0..1 신뢰도 */
+    confidence: number;
+}
+/**
+ * 보드 변경 op.
+ *
+ * 식별자 정책 — 기존 컴포넌트 타깃팅은 `refid` (number) 만 사용.
+ * things-scene 의 모든 컴포넌트는 `refid` 를 자동 발급받는다 (universal).
+ * `model.id` 는 optional metadata 일 뿐 — 항상 존재하지 않으므로 targeting 에는
+ * 부적합. 별개 개념이므로 BoardEditOp / tool 인자에서도 별개 식별자로 분리하지
+ * 않고 refid 단일 채널로 일원화.
+ *
+ * 계층 — 보드는 **최상위 부모** (things-scene 의 model-layer) 이고 그 자체로 자기
+ * 속성을 갖는다 (fillStyle, width, height, fitMode, translate, scale, sky, skyColor,
+ * exposure, hemi/dirLight 계열, camera 계열). 자식 컴포넌트와 별개. 보드 속성 변경은
+ * `modifyBoard`, 자식 변경은 `modify` (refid 기반).
+ *
+ * 주의 — `name` 은 보드 *엔티티* (DB row) 의 컬럼이지 scene MODEL 의 필드가 아니다.
+ * things-scene 의 model-layer 가 인식 안 함. modifyBoard 로 name 을 보내면 model
+ * JSON 에 죽은 필드로 박힐 뿐 렌더링/동작에 영향 없음. 보드 라벨 변경은 GraphQL
+ * boardPatch (BoardPatch input 의 name 필드) 영역.
+ *
+ * style 변경 / 이동 / 크기 변경 등 자식 컴포넌트의 변경은 모두 `modify.patch` 안에
+ * 흡수. 보드 root 속성 변경은 `modifyBoard.patch` 로.
+ */
+/**
+ * Phase 2 — Scene 조작 op 들. 모델 차원 (좌표 / 부모-자식 관계 / z-order) 변경이지만
+ * things-scene 의 자체 API (align/distribute/group/ungroup/zorder) 가 일관된 결과를
+ * 보장하므로 호스트가 직접 호출. 모델 차원 시뮬레이션 (apply-patch) 은 단순화 —
+ * scene 호출 결과가 정본.
+ */
+export type AlignDirection = 'left' | 'right' | 'center' | 'top' | 'middle' | 'bottom';
+export type DistributeAxis = 'horizontal' | 'vertical';
+export type ZorderDirection = 'front' | 'back' | 'forward' | 'backward';
+/**
+ * Sugar layout — `arrange` op 의 layout 종류.
+ *
+ * 의도: align/distribute 위에 얹는 high-level 의도 표현. AI 가 "3x2 그리드로",
+ * "한 줄로", "세로로 일렬" 같은 자연어를 픽셀 노가다 없이 단일 op 로 표현.
+ *
+ * left/top 만 변경 — width/height 는 유지. AI 가 사이즈도 바꾸려면 별도 modify.
+ *
+ * 위치 계산은 호스트 (things-scene 측) 가 담당 — 각 컴포넌트의 현재 width/height 를
+ * 정확히 알아야 하므로 model 차원 시뮬레이션은 SCENE_ONLY (apply-patch noop).
+ */
+export type ArrangeLayout = {
+    type: 'grid';
+    cols: number;
+    gap?: number;
+    anchor?: {
+        left: number;
+        top: number;
+    };
+} | {
+    type: 'row';
+    gap?: number;
+    anchor?: {
+        left: number;
+        top: number;
+    };
+    align?: 'start' | 'center' | 'end';
+} | {
+    type: 'column';
+    gap?: number;
+    anchor?: {
+        left: number;
+        top: number;
+    };
+    align?: 'start' | 'center' | 'end';
+};
+/**
+ * C-1 — Scene 조작 action 들 (ephemeral). 모델 변경 X, 따라서 BoardEditOp 와 별개
+ * 채널 (board-action-execute 이벤트). undo 히스토리 미영향, dirty flag 미영향.
+ *
+ * 종류:
+ *   - selectComponents: scene.selected 직접 set (사용자 선택 변경)
+ *   - centerToComponent: 특정 컴포넌트로 view 이동
+ *   - fitToView: 보드 전체가 보이도록 fit
+ *   - setSceneMode: edit / view 모드 전환
+ */
+export type BoardActionOp = {
+    action: 'selectComponents';
+    refids: number[];
+} | {
+    action: 'centerToComponent';
+    refid: number;
+    animated?: boolean;
+} | {
+    action: 'fitToView';
+    mode?: 'fit' | 'ratio' | 'width' | 'height';
+} | {
+    action: 'setSceneMode';
+    mode: 'edit' | 'view';
+}
+/** 다중 컴포넌트 outline highlight — search/finder UX 의 "이게 모두 매칭이다" 시각화.
+ *  things-scene 의 highlightSearchResults API 위임 (2D/3D 모두 지원). */
+ | {
+    action: 'highlightComponents';
+    refids: number[];
+};
+export type BoardEditOp = {
+    op: 'add';
+    component: BoardComponent;
+} | {
+    op: 'remove';
+    refid: number;
+} | {
+    op: 'modify';
+    refid: number;
+    patch: Partial<BoardComponent>;
+} | {
+    op: 'modifyBoard';
+    patch: Partial<BoardModel>;
+} | {
+    op: 'replace';
+    board: BoardModel;
+} | {
+    op: 'align';
+    refids: number[];
+    direction: AlignDirection;
+} | {
+    op: 'distribute';
+    refids: number[];
+    axis: DistributeAxis;
+} | {
+    op: 'group';
+    refids: number[];
+} | {
+    op: 'ungroup';
+    refid: number;
+} | {
+    op: 'zorder';
+    refid: number;
+    direction: ZorderDirection;
+} | {
+    op: 'arrange';
+    refids: number[];
+    layout: ArrangeLayout;
+};
+/**
+ * BoardAIAssistant — 자연어 채팅으로 보드를 다루는 단일 인터페이스.
+ *
+ * 사용:
+ *   const ai = new DefaultBoardAIAssistant(baseClient, { scopes: ['fmsim'] })
+ *   const r = await ai.chat([{ role: 'user', content: 'AGV 3대 추가' }], currentBoard)
+ *   if (r.patch) currentBoard = applyBoardEditPatch(currentBoard, r.patch)
+ */
+export interface BoardAIAssistant {
+    readonly id: string;
+    chat(messages: LLMMessage[], currentBoard: BoardModel | undefined, options?: ChatOptions): Promise<ChatResponse>;
+}

package/dist-server/service/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-server/service/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../server/service/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Board AI — 자연어 채팅 인터페이스 타입 정의.\n *\n * 핵심 개념:\n *   - 단일 진입점 `chat()`. 의도 분류(생성/편집/스타일/질문)는 AI 의 일.\n *   - 출력은 항상 `ChatResponse`. 보드 변경이 있으면 `patch` 동봉.\n *   - patch 의 op 는 직교 4 종 (add / remove / modify / replace).\n *     style/move 등은 modify.patch 안에 흡수.\n */\nimport type { BoardComponent, BoardModel } from '@things-factory/board-import'\n\nexport interface LLMMessage {\n  role: 'user' | 'assistant'\n  content: string\n}\n\nexport interface ChatOptions {\n  /** board-import 의 registry scope — 등록된 ImportRule 에서 type/category 후보 추출 */\n  scopes?: string[]\n  /** 사용 가능한 도메인 type (override). 미지정 시 scopes 에서 자동 추출 */\n  knownTypes?: string[]\n  /** 사용 가능한 카테고리 (override). 미지정 시 scopes 에서 자동 추출 */\n  categories?: string[]\n  /**\n   * 컴포넌트 type 별 유효 속성 스킴.\n   * LLM 이 정확한 컴포넌트 생성을 하도록 type 의 description, group, default model 키 전달.\n   *\n   * 예:\n   *   [{ type: 'rect', description: 'Rectangle', group: 'shape',\n   *      properties: { fillStyle: '#fff', strokeStyle: '#000' } }, ...]\n   */\n  componentSchemas?: ComponentSchema[]\n  /**\n   * 사용자가 모델러에서 현재 선택한 컴포넌트의 `refid` 목록.\n   *\n   * refid 는 things-scene 이 모든 컴포넌트에 자동 발급하는 universal numeric handle.\n   * id (데이터 바인딩 이름, unique 아님) 와는 다른 개념 — 선택은 항상 refid 로 표현.\n   */\n  selectedRefids?: number[]\n  /**\n   * popup 에서 사용자가 명시 선택한 #mention 매핑 — {token, refid}.\n   * server 가 mention 해석 시 이 매핑을 우선 사용. 본문엔 #token 만 남고\n   * refid 는 사용자에게 노출되지 않음 (LLM mention map 에만 첨부).\n   */\n  mentionPicks?: Array<{ token: string; refid: number }>\n  /** LLM 모델 override */\n  model?: string\n  /** LLM 옵션 */\n  temperature?: number\n  maxTokens?: number\n  /**\n   * Tool 카테고리 (read/external) builder 가 사용할 컨텍스트.\n   *\n   * board-ai 자체는 ResolverContext / typeorm 을 직접 알지 않지만, 외부 도메인 패키지가\n   * 등록한 tool (예: board-import 의 importBoardAsync) 은 server-side 의존성 (도메인,\n   * 사용자, 트랜잭션) 이 필요할 수 있다. board-ai-resolver 가 ResolverContext.state 등을\n   * 이 필드로 전달하면, dispatch 시 closure 로 builder 의 ctx.state 에 주입.\n   *\n   * 미지정이면 외부 builder 는 ctx.state === undefined — 빈 응답이나 에러를 반환할 책임.\n   */\n  toolCallContext?: any\n}\n\nexport interface ComponentSchema {\n  type: string\n  description?: string\n  group?: string\n  /**\n   * 좌표/크기/경로 관련 키들 — type 마다 다름.\n   * 예) ['left', 'top', 'width', 'height']  vs  ['cx', 'cy', 'radius']  vs  ['points']\n   * LLM 이 type 별 정확한 좌표 키를 사용하도록 명시.\n   */\n  geometryKeys?: string[]\n  /**\n   * 좌표 외 type 특화 속성 (style, value, min/max 등).\n   * default 값 또는 keys 만 — LLM 의 token 절감을 위해 호출자가 적절히 압축.\n   */\n  properties?: Record<string, any>\n}\n\n/**\n * AI 가 응답을 만드는 동안 호출한 도구의 시간순 trace.\n *\n * UX 목적 — 사용자가 \"왜 이렇게 답했지\" 의문 가질 때 fold-able 박스에서 확인.\n * 디버그용 + 신뢰도 향상.\n */\nexport interface ToolUsage {\n  /** 도구 이름 (예: 'getSelection', 'modifyBoard', 'addComponent') */\n  name: string\n  /** 호출 인자 JSON */\n  arguments: any\n  /** 도구 결과 — read tool 은 실제 값 (truncated 가능), write tool 은 queued 마커 */\n  result: any\n  /** read tool / write tool 분류 */\n  kind: 'read' | 'write' | 'unknown'\n}\n\nexport interface ChatResponse {\n  /** 사용자에게 보여줄 텍스트 응답 */\n  reply: string\n  /** 보드 변경이 있으면 patch */\n  patch?: BoardEditPatch\n  /**\n   * Scene 조작 action (ephemeral — 모델 변경 없음 / undo 영향 없음).\n   * 시간순 시퀀스로 호스트가 things-scene API 직접 실행.\n   */\n  actions?: BoardActionOp[]\n  /** 모호한 입력 시 명확화 질문 (patch 없음) */\n  followUp?: string\n  /** AI 가 응답 만드는 과정에서 호출한 도구들 (시간순). UI fold-able 박스용. */\n  toolUsages?: ToolUsage[]\n}\n\nexport interface BoardEditPatch {\n  ops: BoardEditOp[]\n  /** 사용자 검수용 1-2 문장 요약 */\n  summary: string\n  /** 0..1 신뢰도 */\n  confidence: number\n}\n\n/**\n * 보드 변경 op.\n *\n * 식별자 정책 — 기존 컴포넌트 타깃팅은 `refid` (number) 만 사용.\n * things-scene 의 모든 컴포넌트는 `refid` 를 자동 발급받는다 (universal).\n * `model.id` 는 optional metadata 일 뿐 — 항상 존재하지 않으므로 targeting 에는\n * 부적합. 별개 개념이므로 BoardEditOp / tool 인자에서도 별개 식별자로 분리하지\n * 않고 refid 단일 채널로 일원화.\n *\n * 계층 — 보드는 **최상위 부모** (things-scene 의 model-layer) 이고 그 자체로 자기\n * 속성을 갖는다 (fillStyle, width, height, fitMode, translate, scale, sky, skyColor,\n * exposure, hemi/dirLight 계열, camera 계열). 자식 컴포넌트와 별개. 보드 속성 변경은\n * `modifyBoard`, 자식 변경은 `modify` (refid 기반).\n *\n * 주의 — `name` 은 보드 *엔티티* (DB row) 의 컬럼이지 scene MODEL 의 필드가 아니다.\n * things-scene 의 model-layer 가 인식 안 함. modifyBoard 로 name 을 보내면 model\n * JSON 에 죽은 필드로 박힐 뿐 렌더링/동작에 영향 없음. 보드 라벨 변경은 GraphQL\n * boardPatch (BoardPatch input 의 name 필드) 영역.\n *\n * style 변경 / 이동 / 크기 변경 등 자식 컴포넌트의 변경은 모두 `modify.patch` 안에\n * 흡수. 보드 root 속성 변경은 `modifyBoard.patch` 로.\n */\n/**\n * Phase 2 — Scene 조작 op 들. 모델 차원 (좌표 / 부모-자식 관계 / z-order) 변경이지만\n * things-scene 의 자체 API (align/distribute/group/ungroup/zorder) 가 일관된 결과를\n * 보장하므로 호스트가 직접 호출. 모델 차원 시뮬레이션 (apply-patch) 은 단순화 —\n * scene 호출 결과가 정본.\n */\nexport type AlignDirection =\n  | 'left'\n  | 'right'\n  | 'center'\n  | 'top'\n  | 'middle'\n  | 'bottom'\n\nexport type DistributeAxis = 'horizontal' | 'vertical'\n\nexport type ZorderDirection = 'front' | 'back' | 'forward' | 'backward'\n\n/**\n * Sugar layout — `arrange` op 의 layout 종류.\n *\n * 의도: align/distribute 위에 얹는 high-level 의도 표현. AI 가 \"3x2 그리드로\",\n * \"한 줄로\", \"세로로 일렬\" 같은 자연어를 픽셀 노가다 없이 단일 op 로 표현.\n *\n * left/top 만 변경 — width/height 는 유지. AI 가 사이즈도 바꾸려면 별도 modify.\n *\n * 위치 계산은 호스트 (things-scene 측) 가 담당 — 각 컴포넌트의 현재 width/height 를\n * 정확히 알아야 하므로 model 차원 시뮬레이션은 SCENE_ONLY (apply-patch noop).\n */\nexport type ArrangeLayout =\n  | { type: 'grid'; cols: number; gap?: number; anchor?: { left: number; top: number } }\n  | {\n      type: 'row'\n      gap?: number\n      anchor?: { left: number; top: number }\n      align?: 'start' | 'center' | 'end'\n    }\n  | {\n      type: 'column'\n      gap?: number\n      anchor?: { left: number; top: number }\n      align?: 'start' | 'center' | 'end'\n    }\n\n/**\n * C-1 — Scene 조작 action 들 (ephemeral). 모델 변경 X, 따라서 BoardEditOp 와 별개\n * 채널 (board-action-execute 이벤트). undo 히스토리 미영향, dirty flag 미영향.\n *\n * 종류:\n *   - selectComponents: scene.selected 직접 set (사용자 선택 변경)\n *   - centerToComponent: 특정 컴포넌트로 view 이동\n *   - fitToView: 보드 전체가 보이도록 fit\n *   - setSceneMode: edit / view 모드 전환\n */\nexport type BoardActionOp =\n  | { action: 'selectComponents'; refids: number[] }\n  | { action: 'centerToComponent'; refid: number; animated?: boolean }\n  | { action: 'fitToView'; mode?: 'fit' | 'ratio' | 'width' | 'height' }\n  | { action: 'setSceneMode'; mode: 'edit' | 'view' }\n  /** 다중 컴포넌트 outline highlight — search/finder UX 의 \"이게 모두 매칭이다\" 시각화.\n   *  things-scene 의 highlightSearchResults API 위임 (2D/3D 모두 지원). */\n  | { action: 'highlightComponents'; refids: number[] }\n\nexport type BoardEditOp =\n  | { op: 'add'; component: BoardComponent }\n  | { op: 'remove'; refid: number }\n  | { op: 'modify'; refid: number; patch: Partial<BoardComponent> }\n  | { op: 'modifyBoard'; patch: Partial<BoardModel> }\n  | { op: 'replace'; board: BoardModel }\n  | { op: 'align'; refids: number[]; direction: AlignDirection }\n  | { op: 'distribute'; refids: number[]; axis: DistributeAxis }\n  | { op: 'group'; refids: number[] }\n  | { op: 'ungroup'; refid: number }\n  | { op: 'zorder'; refid: number; direction: ZorderDirection }\n  | { op: 'arrange'; refids: number[]; layout: ArrangeLayout }\n\n/**\n * BoardAIAssistant — 자연어 채팅으로 보드를 다루는 단일 인터페이스.\n *\n * 사용:\n *   const ai = new DefaultBoardAIAssistant(baseClient, { scopes: ['fmsim'] })\n *   const r = await ai.chat([{ role: 'user', content: 'AGV 3대 추가' }], currentBoard)\n *   if (r.patch) currentBoard = applyBoardEditPatch(currentBoard, r.patch)\n */\nexport interface BoardAIAssistant {\n  readonly id: string\n  chat(\n    messages: LLMMessage[],\n    currentBoard: BoardModel | undefined,\n    options?: ChatOptions\n  ): Promise<ChatResponse>\n}\n"]}