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

package/dist-client/server/service/styling/material-tools.js

@@ -0,0 +1,88 @@
+import { normalizeColor, validateColor } from './color-utils';
+const MATERIAL_PRESETS = ['default', 'metal', 'glass', 'plastic', 'wood', 'ceramic', 'rubber', 'custom'];
+const SIDE_VALUES = ['double', 'front', 'back'];
+export function buildSetMaterialOps(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.preset ||
+        input.metalness !== undefined ||
+        input.roughness !== undefined ||
+        input.emissive !== undefined ||
+        input.emissiveIntensity !== undefined ||
+        input.opacity !== undefined ||
+        input.envMapIntensity !== undefined ||
+        input.side !== undefined);
+    if (noOp)
+        return { ops: [], errors: ['No material changes specified'] };
+    if (input.preset && !MATERIAL_PRESETS.includes(input.preset)) {
+        return {
+            ops: [],
+            errors: [`Unknown preset: '${input.preset}'. Valid: ${MATERIAL_PRESETS.join('/')}`]
+        };
+    }
+    if (input.metalness !== undefined && (input.metalness < 0 || input.metalness > 1)) {
+        return { ops: [], errors: [`metalness out of [0,1]: ${input.metalness}`] };
+    }
+    if (input.roughness !== undefined && (input.roughness < 0 || input.roughness > 1)) {
+        return { ops: [], errors: [`roughness out of [0,1]: ${input.roughness}`] };
+    }
+    if (input.opacity !== undefined && (input.opacity < 0 || input.opacity > 1)) {
+        return { ops: [], errors: [`opacity out of [0,1]: ${input.opacity}`] };
+    }
+    if (input.emissiveIntensity !== undefined && (input.emissiveIntensity < 0 || input.emissiveIntensity > 5)) {
+        return { ops: [], errors: [`emissiveIntensity out of [0,5]: ${input.emissiveIntensity}`] };
+    }
+    if (input.envMapIntensity !== undefined && (input.envMapIntensity < 0 || input.envMapIntensity > 3)) {
+        return { ops: [], errors: [`envMapIntensity out of [0,3]: ${input.envMapIntensity}`] };
+    }
+    if (input.emissive !== undefined) {
+        const v = validateColor(input.emissive);
+        if (!v.valid)
+            return { ops: [], errors: [v.error ?? 'Invalid emissive color'] };
+    }
+    if (input.side && !SIDE_VALUES.includes(input.side)) {
+        return { ops: [], errors: [`Unknown side: '${input.side}'. Valid: ${SIDE_VALUES.join('/')}`] };
+    }
+    const m = {};
+    if (input.preset)
+        m.preset = input.preset;
+    if (input.metalness !== undefined)
+        m.metalness = input.metalness;
+    if (input.roughness !== undefined)
+        m.roughness = input.roughness;
+    if (input.emissive !== undefined)
+        m.emissive = normalizeColor(input.emissive);
+    if (input.emissiveIntensity !== undefined)
+        m.emissiveIntensity = input.emissiveIntensity;
+    if (input.opacity !== undefined)
+        m.opacity = input.opacity;
+    if (input.envMapIntensity !== undefined)
+        m.envMapIntensity = input.envMapIntensity;
+    if (input.side)
+        m.side = input.side;
+    const patch = { material3d: m };
+    return { ops: refids.map(refid => ({ op: 'modify', refid, patch })), errors: [] };
+}
+export function buildSetShadowPropertiesOps(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.castShadow === undefined && input.receiveShadow === undefined;
+    if (noOp)
+        return { ops: [], errors: ['Specify castShadow and/or receiveShadow'] };
+    const m = {};
+    if (input.castShadow !== undefined)
+        m.castShadow = input.castShadow;
+    if (input.receiveShadow !== undefined)
+        m.receiveShadow = input.receiveShadow;
+    const patch = { material3d: m };
+    return { ops: refids.map(refid => ({ op: 'modify', refid, patch })), errors: [] };
+}
+//# sourceMappingURL=material-tools.js.map

package/dist-client/server/service/styling/material-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-tools.js","sourceRoot":"","sources":["../../../../server/service/styling/material-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * setMaterial / setShadowProperties — 3D PBR 재질 + 그림자 동작.\n *\n * Material3D (`things-scene/src/threed/material-3d.ts`) 와 1:1 매핑.\n * preset 만 줘도 변경 가능 (resolveMaterial3d 가 default 위 override 적용).\n */\nimport type { BoardEditOp } from '../types'\nimport { normalizeColor, validateColor } from './color-utils'\n\nconst MATERIAL_PRESETS = ['default', 'metal', 'glass', 'plastic', 'wood', 'ceramic', 'rubber', 'custom'] as const\nconst SIDE_VALUES = ['double', 'front', 'back'] as const\n\nexport interface SetMaterialInput {\n  refids: number[]\n  preset?: typeof MATERIAL_PRESETS[number]\n  metalness?: number       // 0..1\n  roughness?: number       // 0..1\n  emissive?: string\n  emissiveIntensity?: number  // 0..5\n  opacity?: number         // 0..1 (3D-only)\n  envMapIntensity?: number // 0..3\n  side?: typeof SIDE_VALUES[number]\n}\n\nexport interface SetShadowPropertiesInput {\n  refids: number[]\n  castShadow?: boolean\n  receiveShadow?: boolean\n}\n\nexport interface OpsResult {\n  ops: BoardEditOp[]\n  errors: string[]\n}\n\nexport function buildSetMaterialOps(input: SetMaterialInput): 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  const noOp = !(\n    input.preset ||\n    input.metalness !== undefined ||\n    input.roughness !== undefined ||\n    input.emissive !== undefined ||\n    input.emissiveIntensity !== undefined ||\n    input.opacity !== undefined ||\n    input.envMapIntensity !== undefined ||\n    input.side !== undefined\n  )\n  if (noOp) return { ops: [], errors: ['No material changes specified'] }\n\n  if (input.preset && !MATERIAL_PRESETS.includes(input.preset)) {\n    return {\n      ops: [],\n      errors: [`Unknown preset: '${input.preset}'. Valid: ${MATERIAL_PRESETS.join('/')}`]\n    }\n  }\n  if (input.metalness !== undefined && (input.metalness < 0 || input.metalness > 1)) {\n    return { ops: [], errors: [`metalness out of [0,1]: ${input.metalness}`] }\n  }\n  if (input.roughness !== undefined && (input.roughness < 0 || input.roughness > 1)) {\n    return { ops: [], errors: [`roughness out of [0,1]: ${input.roughness}`] }\n  }\n  if (input.opacity !== undefined && (input.opacity < 0 || input.opacity > 1)) {\n    return { ops: [], errors: [`opacity out of [0,1]: ${input.opacity}`] }\n  }\n  if (input.emissiveIntensity !== undefined && (input.emissiveIntensity < 0 || input.emissiveIntensity > 5)) {\n    return { ops: [], errors: [`emissiveIntensity out of [0,5]: ${input.emissiveIntensity}`] }\n  }\n  if (input.envMapIntensity !== undefined && (input.envMapIntensity < 0 || input.envMapIntensity > 3)) {\n    return { ops: [], errors: [`envMapIntensity out of [0,3]: ${input.envMapIntensity}`] }\n  }\n  if (input.emissive !== undefined) {\n    const v = validateColor(input.emissive)\n    if (!v.valid) return { ops: [], errors: [v.error ?? 'Invalid emissive color'] }\n  }\n  if (input.side && !SIDE_VALUES.includes(input.side)) {\n    return { ops: [], errors: [`Unknown side: '${input.side}'. Valid: ${SIDE_VALUES.join('/')}`] }\n  }\n\n  const m: any = {}\n  if (input.preset) m.preset = input.preset\n  if (input.metalness !== undefined) m.metalness = input.metalness\n  if (input.roughness !== undefined) m.roughness = input.roughness\n  if (input.emissive !== undefined) m.emissive = normalizeColor(input.emissive)\n  if (input.emissiveIntensity !== undefined) m.emissiveIntensity = input.emissiveIntensity\n  if (input.opacity !== undefined) m.opacity = input.opacity\n  if (input.envMapIntensity !== undefined) m.envMapIntensity = input.envMapIntensity\n  if (input.side) m.side = input.side\n\n  const patch = { material3d: m }\n  return { ops: refids.map(refid => ({ op: 'modify', refid, patch })), errors: [] }\n}\n\nexport function buildSetShadowPropertiesOps(input: SetShadowPropertiesInput): 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  const noOp = input.castShadow === undefined && input.receiveShadow === undefined\n  if (noOp) return { ops: [], errors: ['Specify castShadow and/or receiveShadow'] }\n\n  const m: any = {}\n  if (input.castShadow !== undefined) m.castShadow = input.castShadow\n  if (input.receiveShadow !== undefined) m.receiveShadow = input.receiveShadow\n\n  const patch = { material3d: m }\n  return { ops: refids.map(refid => ({ op: 'modify', refid, patch })), errors: [] }\n}\n"]}

package/dist-client/server/service/styling/read-tools.d.ts

@@ -0,0 +1,34 @@
+/**
+ * getComponentStyle — 컴포넌트의 현재 styling 상태 조회 (read tool).
+ *
+ * AI 가 변경 전 현재 상태 파악용 — "이미 빨간 모터를 더 빨갛게" 같은 모호 명령
+ * 정확 처리. iteration loop 의 핵심 기반.
+ *
+ * 반환 형태: { fillStyle, strokeStyle, shadow, material3d, font, alpha, hidden, text }
+ *   - aspects 인자로 부분 조회 가능 (토큰 절감)
+ */
+export interface GetComponentStyleInput {
+    refid: number;
+    aspects?: Array<'fill' | 'stroke' | 'shadow' | 'material' | 'font' | 'opacity' | 'visibility' | 'text'>;
+}
+export interface ComponentStyleSummary {
+    refid: number;
+    fillStyle?: any;
+    strokeStyle?: any;
+    shadow?: any;
+    material3d?: any;
+    font?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fontWeight?: string;
+        fontStyle?: string;
+        fontColor?: string;
+        textAlign?: string;
+        textBaseline?: string;
+        lineHeight?: number;
+    };
+    alpha?: number;
+    hidden?: boolean;
+    text?: string;
+}
+export declare function buildComponentStyleSummary(component: any, aspects?: GetComponentStyleInput['aspects']): ComponentStyleSummary;

package/dist-client/server/service/styling/read-tools.js

@@ -0,0 +1,42 @@
+export function buildComponentStyleSummary(component, aspects) {
+    const all = !aspects || aspects.length === 0;
+    const want = (a) => all || aspects.includes(a);
+    const out = { refid: component.refid };
+    if (want('fill') && component.fillStyle !== undefined)
+        out.fillStyle = component.fillStyle;
+    if (want('stroke') && component.strokeStyle !== undefined)
+        out.strokeStyle = component.strokeStyle;
+    if (want('shadow') && component.shadow !== undefined)
+        out.shadow = component.shadow;
+    if (want('material') && component.material3d !== undefined)
+        out.material3d = component.material3d;
+    if (want('opacity') && typeof component.alpha === 'number')
+        out.alpha = component.alpha;
+    if (want('visibility') && component.hidden !== undefined)
+        out.hidden = component.hidden;
+    if (want('text') && typeof component.text === 'string')
+        out.text = component.text;
+    if (want('font')) {
+        const font = {};
+        if (component.fontFamily)
+            font.fontFamily = component.fontFamily;
+        if (component.fontSize !== undefined)
+            font.fontSize = component.fontSize;
+        if (component.fontWeight !== undefined)
+            font.fontWeight = component.fontWeight;
+        if (component.fontStyle)
+            font.fontStyle = component.fontStyle;
+        if (component.fontColor)
+            font.fontColor = component.fontColor;
+        if (component.textAlign)
+            font.textAlign = component.textAlign;
+        if (component.textBaseline)
+            font.textBaseline = component.textBaseline;
+        if (component.lineHeight !== undefined)
+            font.lineHeight = component.lineHeight;
+        if (Object.keys(font).length > 0)
+            out.font = font;
+    }
+    return out;
+}
+//# sourceMappingURL=read-tools.js.map

package/dist-client/server/service/styling/read-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tools.js","sourceRoot":"","sources":["../../../../server/service/styling/read-tools.ts"],"names":[],"mappings":"AAmCA,MAAM,UAAU,0BAA0B,CACxC,SAAc,EACd,OAA2C;IAE3C,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,IAAI,OAAQ,CAAC,QAAQ,CAAC,CAAQ,CAAC,CAAA;IAE9D,MAAM,GAAG,GAA0B,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAA;IAE7D,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;IAC1F,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAA;IAClG,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;IACnF,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,UAAU,KAAK,SAAS;QAAE,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;IACjG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ;QAAE,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;IACvF,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;IACvF,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAAE,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;IAEjF,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,GAAQ,EAAE,CAAA;QACpB,IAAI,SAAS,CAAC,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;QAChE,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAA;QACxE,IAAI,SAAS,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;QAC9E,IAAI,SAAS,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;QAC7D,IAAI,SAAS,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;QAC7D,IAAI,SAAS,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;QAC7D,IAAI,SAAS,CAAC,YAAY;YAAE,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAA;QACtE,IAAI,SAAS,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;QAC9E,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACnD,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["/**\n * getComponentStyle — 컴포넌트의 현재 styling 상태 조회 (read tool).\n *\n * AI 가 변경 전 현재 상태 파악용 — \"이미 빨간 모터를 더 빨갛게\" 같은 모호 명령\n * 정확 처리. iteration loop 의 핵심 기반.\n *\n * 반환 형태: { fillStyle, strokeStyle, shadow, material3d, font, alpha, hidden, text }\n *   - aspects 인자로 부분 조회 가능 (토큰 절감)\n */\nexport interface GetComponentStyleInput {\n  refid: number\n  aspects?: Array<'fill' | 'stroke' | 'shadow' | 'material' | 'font' | 'opacity' | 'visibility' | 'text'>\n}\n\nexport interface ComponentStyleSummary {\n  refid: number\n  fillStyle?: any\n  strokeStyle?: any\n  shadow?: any\n  material3d?: any\n  font?: {\n    fontFamily?: string\n    fontSize?: number\n    fontWeight?: string\n    fontStyle?: string\n    fontColor?: string\n    textAlign?: string\n    textBaseline?: string\n    lineHeight?: number\n  }\n  alpha?: number\n  hidden?: boolean\n  text?: string\n}\n\nexport function buildComponentStyleSummary(\n  component: any,\n  aspects?: GetComponentStyleInput['aspects']\n): ComponentStyleSummary {\n  const all = !aspects || aspects.length === 0\n  const want = (a: string) => all || aspects!.includes(a as any)\n\n  const out: ComponentStyleSummary = { refid: component.refid }\n\n  if (want('fill') && component.fillStyle !== undefined) out.fillStyle = component.fillStyle\n  if (want('stroke') && component.strokeStyle !== undefined) out.strokeStyle = component.strokeStyle\n  if (want('shadow') && component.shadow !== undefined) out.shadow = component.shadow\n  if (want('material') && component.material3d !== undefined) out.material3d = component.material3d\n  if (want('opacity') && typeof component.alpha === 'number') out.alpha = component.alpha\n  if (want('visibility') && component.hidden !== undefined) out.hidden = component.hidden\n  if (want('text') && typeof component.text === 'string') out.text = component.text\n\n  if (want('font')) {\n    const font: any = {}\n    if (component.fontFamily) font.fontFamily = component.fontFamily\n    if (component.fontSize !== undefined) font.fontSize = component.fontSize\n    if (component.fontWeight !== undefined) font.fontWeight = component.fontWeight\n    if (component.fontStyle) font.fontStyle = component.fontStyle\n    if (component.fontColor) font.fontColor = component.fontColor\n    if (component.textAlign) font.textAlign = component.textAlign\n    if (component.textBaseline) font.textBaseline = component.textBaseline\n    if (component.lineHeight !== undefined) font.lineHeight = component.lineHeight\n    if (Object.keys(font).length > 0) out.font = font\n  }\n\n  return out\n}\n"]}

package/dist-client/server/service/styling/registry.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Styling tool registry — 선언형 단일 진실 (single source of truth).
+ *
+ * 동기:
+ *   기존 styling tool 추가 시 4-5곳 (WRITE_TOOL_NAMES set / tools 배열 정의 /
+ *   dispatch case / validation case / system prompt 안내) 에 같은 정보가 산재해
+ *   동기화 누락 위험. 신규 tool 마다 4곳 boilerplate.
+ *
+ * 본 registry 가 한 곳에 모음 — 위 모든 사용처가 STYLING_TOOLS 에서 자동 도출.
+ *
+ * 마이그레이션:
+ *   STYLING_TOOLS 는 초기엔 비어있고, 한 tool 씩 점진 이전한다. 각 단계마다
+ *   기존 hardcoded 정의/dispatch 와 byte-단위 동등성을 단위 테스트가 잠금.
+ *
+ * 비-styling write tool (addComponent / modifyBoard / alignComponents 등) 은
+ * 본 registry 의 영역이 아니다 — 의미·구조가 styling 패턴과 달라 별도 dispatch.
+ */
+import type { BoardEditOp } from '../types';
+export interface OpsResult {
+    ops: BoardEditOp[];
+    errors: string[];
+}
+/**
+ * 한 styling tool 의 모든 메타데이터 + 빌더.
+ *
+ * description 과 themeNote 는 별도 — 자동 합성될 때 description 본문은 영문/기능
+ * 위주로 짧게, themeNote 는 한국어 ⚠ 정책 단문. 분리해 두면 미래에 i18n / 정책
+ * 일괄 변경 시 검색-치환이 쉽다.
+ */
+export interface StylingToolSpec {
+    /** AIToolCall.name 과 매칭. unique. */
+    name: string;
+    /** 기능 설명 (영문 위주). */
+    description: string;
+    /**
+     * 선택 — ⚠ 정책 / 테마 가이드 단문. 빌드 시 description 끝에 자동 부착.
+     * 예: '⚠ 테마 요청 시 width/dash 건드리지 말 것.'
+     */
+    themeNote?: string;
+    /** JSON Schema for parameters — LLM tool schema 에 그대로 노출. */
+    schema: any;
+    /**
+     * AIToolCall.arguments → OpsResult 변환.
+     * components 는 copyStyle 처럼 source lookup 필요한 tool 만 사용. 다른 tool 은
+     * 두 번째 인자 무시하면 됨.
+     */
+    builder: (args: any, components: ReadonlyArray<any>) => OpsResult;
+}
+/**
+ * 등록된 styling tool 들. 한 tool 씩 점진 이전 중.
+ *
+ * 마이그레이션 순서: setFill → setStroke → setText/setFont → setShadow /
+ *   setOpacity / setVisible → setMaterial / setShadowProperties → clearStyle
+ *   → copyStyle. 각 이전 commit 은 별도 — bisect 로 회귀 추적 용이.
+ *
+ * spec 작성 규약:
+ *   - description 은 영문 / 기능 설명
+ *   - themeNote 는 ⚠ 시작 한국어 정책 단문 (테마 가이드 / 호출 금지 등)
+ *   - schema 는 LLM 에 그대로 노출되는 JSON Schema
+ *   - builder 는 builder 함수 직접 사용 (signature 호환). components 인자
+ *     안 쓰는 tool 도 그대로 통과.
+ */
+export declare const STYLING_TOOLS: StylingToolSpec[];
+/**
+ * registry 에 등록된 모든 styling tool 이름 set.
+ * WRITE_TOOL_NAMES 합산용 — assistant.ts 가 isWriteTool 판정 시 styling 영역
+ * 부분을 본 set 에 위임.
+ */
+export declare function getStylingToolNames(registry?: ReadonlyArray<StylingToolSpec>): Set<string>;
+/**
+ * LLM 에 노출할 tool 정의 배열.
+ * buildBoardEditTools 가 styling 부분을 본 함수 결과로 채운다.
+ */
+export declare function buildStylingToolDefinitions(registry?: ReadonlyArray<StylingToolSpec>): Array<{
+    name: string;
+    description: string;
+    parameters: any;
+}>;
+/**
+ * AIToolCall name 에 매칭되는 styling tool 의 builder 호출 → BoardEditOp[] | null.
+ *
+ * 반환:
+ *   - 매칭 spec 없음 → null (caller 가 다른 카테고리 dispatch 시도)
+ *   - 빈 ops (validation 실패 등) → null (assistant.ts 의 기존 동작과 동일)
+ *   - 정상 → BoardEditOp[]
+ *
+ * components 인자는 copyStyle 같은 source-lookup 필요 tool 에만 의미 있음.
+ */
+export declare function dispatchStylingTool(name: string, args: any, components?: ReadonlyArray<any>, registry?: ReadonlyArray<StylingToolSpec>): BoardEditOp[] | null;
+/** name 이 styling tool 로 등록되어 있는가. */
+export declare function isStylingTool(name: string, registry?: ReadonlyArray<StylingToolSpec>): boolean;

package/dist-client/server/service/styling/registry.js

@@ -0,0 +1,345 @@
+import { buildSetFillOps } from './fill-tools';
+import { buildSetStrokeOps } from './stroke-tools';
+import { buildSetTextOps, buildSetFontOps } from './text-tools';
+import { buildSetShadowOps, buildSetOpacityOps, buildSetVisibleOps } from './effect-tools';
+import { buildSetMaterialOps, buildSetShadowPropertiesOps } from './material-tools';
+import { buildClearStyleOps } from './clear-tools';
+import { buildCopyStyleOps } from './copy-tools';
+/**
+ * 등록된 styling tool 들. 한 tool 씩 점진 이전 중.
+ *
+ * 마이그레이션 순서: setFill → setStroke → setText/setFont → setShadow /
+ *   setOpacity / setVisible → setMaterial / setShadowProperties → clearStyle
+ *   → copyStyle. 각 이전 commit 은 별도 — bisect 로 회귀 추적 용이.
+ *
+ * spec 작성 규약:
+ *   - description 은 영문 / 기능 설명
+ *   - themeNote 는 ⚠ 시작 한국어 정책 단문 (테마 가이드 / 호출 금지 등)
+ *   - schema 는 LLM 에 그대로 노출되는 JSON Schema
+ *   - builder 는 builder 함수 직접 사용 (signature 호환). components 인자
+ *     안 쓰는 tool 도 그대로 통과.
+ */
+export const STYLING_TOOLS = [
+    {
+        name: 'setFill',
+        description: "Set a component's BACKGROUND/FILL (fillStyle). Use this for fill changes — handles 4 modes (none/solid/gradient/pattern/image) safely with mode-aware updates. Prefer over modifyComponentByRefid for fill-only changes.\n\nMode rules:\n  - mode='solid': requires `color`\n  - mode='gradient': provide `colorStops` (array of {color,position}) or fall back from `color` (auto-generates 2 stops)\n  - mode='pattern' or 'image': requires `image` (URL or asset ref)\n  - mode='none': removes fill\n  - omitting `mode`: partial update (only color/opacity) — preserves existing mode and other fields.",
+        schema: {
+            type: 'object',
+            properties: {
+                refids: {
+                    type: 'array',
+                    items: { type: 'number' },
+                    description: 'Components to update. things-scene auto-assigned numeric handles.'
+                },
+                mode: {
+                    type: 'string',
+                    enum: ['none', 'solid', 'gradient', 'pattern', 'image'],
+                    description: 'Fill mode dispatcher (synthetic — not stored on the model). Omit for partial update of color/opacity within the existing mode.'
+                },
+                color: {
+                    type: 'string',
+                    description: "Color (hex '#ff0000' / rgb / named 'red' / semantic 'warm-red'). Required for mode='solid'. Output: top-level fillStyle string when mode=solid; nested fillStyle.color when mode=pattern (background tint)."
+                },
+                gradientType: {
+                    type: 'string',
+                    enum: ['linear', 'radial'],
+                    description: 'Gradient kind (when mode=gradient). Default linear. Stored at fillStyle.gradientType.'
+                },
+                colorStops: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            color: { type: 'string' },
+                            position: { type: 'number', description: '0..1' }
+                        },
+                        required: ['color', 'position']
+                    },
+                    description: 'Gradient color stops (when mode=gradient). At least 2. Stored at fillStyle.colorStops (canonical things-scene field name).'
+                },
+                rotation: {
+                    type: 'number',
+                    description: 'Gradient rotation in degrees (when mode=gradient). Default 0. Internally converted to radians and stored at fillStyle.rotation.'
+                },
+                image: {
+                    type: 'string',
+                    description: 'Image URL or asset reference (when mode=pattern or mode=image). Stored at fillStyle.image.'
+                },
+                opacity: {
+                    type: 'number',
+                    description: 'Fill alpha 0..1. For mode=solid, encoded as rgba alpha channel in the fillStyle string. For mode=gradient/pattern, stored at fillStyle.opacity.'
+                }
+            },
+            required: ['refids']
+        },
+        builder: (args, _components) => buildSetFillOps(args)
+    },
+    {
+        name: 'setStroke',
+        description: "Set component STROKE / BORDER. Canonical things-scene fields (all top-level on state): strokeStyle (color string), lineWidth (number), lineDash (preset name string), lineCap, lineJoin. dash 는 CSS-친화 alias 도 매핑 — 'dashed'/'dotted'/'dashdot' → things-scene preset. 'solid'/'dash'/'square-dot'/'round-dot'/'dash-dot'/'long-dash'/'long-dash-dot'/'long-dash-dot-dot' 도 가능.",
+        themeNote: '⚠ 테마 요청 (북유럽/사이버펑크/미니멀 등) 시 lineWidth/dash/lineCap/lineJoin 은 건드리지 말 것 — 선의 두께·점선 패턴은 디자인 의도를 가진 *구조* 다. strokeStyle (색상) 만 테마 팔레트에 맞춰 변경. 사용자가 명시적으로 두께/점선 변경을 요청한 경우에만 lineWidth/dash 사용.',
+        schema: {
+            type: 'object',
+            properties: {
+                refids: { type: 'array', items: { type: 'number' } },
+                enabled: {
+                    type: 'boolean',
+                    description: 'Synthetic helper — false maps to lineWidth=0 (drawer skips). Not stored on the model itself.'
+                },
+                strokeStyle: {
+                    type: 'string',
+                    description: 'Stroke color (CSS color string — hex / rgb / named / semantic alias). Stored at top-level state.strokeStyle.'
+                },
+                lineWidth: {
+                    type: 'number',
+                    description: 'Stroke width in pixels (0 = no stroke). Stored at top-level state.lineWidth.'
+                },
+                dash: {
+                    description: "Dash pattern. CSS-친화 alias 자동 매핑: 'dashed'→'dash', 'dotted'→'square-dot', 'dashdot'→'dash-dot'. things-scene preset 직접 사용도 OK: 'solid' / 'round-dot' / 'square-dot' / 'dash' / 'dash-dot' / 'long-dash' / 'long-dash-dot' / 'long-dash-dot-dot'. Stored at top-level state.lineDash."
+                },
+                lineCap: {
+                    type: 'string',
+                    enum: ['butt', 'round', 'square'],
+                    description: 'Line cap style. Stored at top-level state.lineCap.'
+                },
+                lineJoin: {
+                    type: 'string',
+                    enum: ['miter', 'round', 'bevel'],
+                    description: 'Line join style. Stored at top-level state.lineJoin.'
+                }
+            },
+            required: ['refids']
+        },
+        builder: (args, _components) => buildSetStrokeOps(args)
+    },
+    {
+        name: 'setText',
+        description: 'Change component TEXT CONTENT (state.text). For font styling use setFont separately.',
+        themeNote: '⚠ 텍스트는 *콘텐츠* 이지 *스타일* 이 아니다 — 테마 요청 (북유럽/사이버펑크/미니멀 등) 시 호출 금지. 사용자가 텍스트 변경을 명시한 경우에만 사용.',
+        schema: {
+            type: 'object',
+            properties: {
+                refids: { type: 'array', items: { type: 'number' } },
+                text: { type: 'string' }
+            },
+            required: ['refids', 'text']
+        },
+        builder: (args, _components) => buildSetTextOps(args)
+    },
+    {
+        name: 'setFont',
+        description: 'Set FONT/TEXT STYLE (family / size / weight / style / color / align / baseline / lineHeight). For text content use setText.',
+        themeNote: '⚠ 테마 요청 (북유럽/사이버펑크 등) 시 fontSize / fontFamily 는 건드리지 말 것 — 정보 위계와 레이아웃에 영향. fontColor 만 테마 팔레트에 맞춰 변경. 사용자가 명시적으로 폰트 크기/패밀리 변경을 요청한 경우에만 사용.',
+        schema: {
+            type: 'object',
+            properties: {
+                refids: { type: 'array', items: { type: 'number' } },
+                fontFamily: { type: 'string' },
+                fontSize: { type: 'number' },
+                fontWeight: {
+                    description: "'normal' | 'bold' | 'lighter' | 'bolder' | 100..900"
+                },
+                fontStyle: { type: 'string', enum: ['normal', 'italic', 'oblique'] },
+                fontColor: { type: 'string' },
+                textAlign: {
+                    type: 'string',
+                    enum: ['left', 'center', 'right', 'start', 'end', 'justify']
+                },
+                textBaseline: {
+                    type: 'string',
+                    enum: ['top', 'middle', 'bottom', 'hanging', 'alphabetic', 'ideographic']
+                },
+                lineHeight: { type: 'number' }
+            },
+            required: ['refids']
+        },
+        builder: (args, _components) => buildSetFontOps(args)
+    },
+    {
+        name: 'setShadow',
+        description: 'Set component SHADOW. Standard CSS box-shadow / Canvas shadow* fields (nested under state.shadow): color, blur, offsetX, offsetY. enabled=false maps to blur=0 + transparent (synthetic helper).',
+        schema: {
+            type: 'object',
+            properties: {
+                refids: { type: 'array', items: { type: 'number' } },
+                enabled: {
+                    type: 'boolean',
+                    description: 'Synthetic helper — false maps to blur=0 + color=transparent. Not stored as a model field.'
+                },
+                color: {
+                    type: 'string',
+                    description: 'Shadow color (CSS color string). Stored at state.shadow.color.'
+                },
+                blur: {
+                    type: 'number',
+                    description: 'Shadow blur radius in pixels (matches CSS box-shadow blur-radius / Canvas shadowBlur). Stored at state.shadow.blur.'
+                },
+                offsetX: {
+                    type: 'number',
+                    description: 'Shadow horizontal offset in pixels (matches CSS box-shadow offset-x / Canvas shadowOffsetX). Stored at state.shadow.offsetX.'
+                },
+                offsetY: {
+                    type: 'number',
+                    description: 'Shadow vertical offset in pixels (matches CSS box-shadow offset-y / Canvas shadowOffsetY). Stored at state.shadow.offsetY.'
+                }
+            },
+            required: ['refids']
+        },
+        builder: (args, _components) => buildSetShadowOps(args)
+    },
+    {
+        name: 'setOpacity',
+        description: 'Set component overall ALPHA (canonical things-scene field state.alpha, 0..1).',
+        schema: {
+            type: 'object',
+            properties: {
+                refids: { type: 'array', items: { type: 'number' } },
+                alpha: {
+                    type: 'number',
+                    description: 'Component overall opacity 0..1 (1 = opaque, 0 = invisible). Stored at top-level state.alpha.'
+                }
+            },
+            required: ['refids', 'alpha']
+        },
+        builder: (args, _components) => buildSetOpacityOps(args)
+    },
+    {
+        name: 'setVisible',
+        description: 'Show/hide components (state.hidden = !visible).',
+        schema: {
+            type: 'object',
+            properties: {
+                refids: { type: 'array', items: { type: 'number' } },
+                visible: { type: 'boolean' }
+            },
+            required: ['refids', 'visible']
+        },
+        builder: (args, _components) => buildSetVisibleOps(args)
+    },
+    {
+        name: 'setMaterial',
+        description: 'Set 3D PBR MATERIAL (preset / metalness / roughness / emissive / opacity / envMapIntensity / side). Preset is semantic shortcut: metal/glass/plastic/wood/ceramic/rubber/default. preset alone resets, preset + properties applies overrides on top.',
+        schema: {
+            type: 'object',
+            properties: {
+                refids: { type: 'array', items: { type: 'number' } },
+                preset: {
+                    type: 'string',
+                    enum: ['default', 'metal', 'glass', 'plastic', 'wood', 'ceramic', 'rubber', 'custom']
+                },
+                metalness: { type: 'number', description: '0..1' },
+                roughness: { type: 'number', description: '0..1' },
+                emissive: { type: 'string', description: 'glow color (hex / named)' },
+                emissiveIntensity: { type: 'number', description: '0..5' },
+                opacity: { type: 'number', description: '0..1 (3D-only, separate from component alpha)' },
+                envMapIntensity: { type: 'number', description: '0..3' },
+                side: { type: 'string', enum: ['double', 'front', 'back'] }
+            },
+            required: ['refids']
+        },
+        builder: (args, _components) => buildSetMaterialOps(args)
+    },
+    {
+        name: 'setShadowProperties',
+        description: 'Set 3D shadow behavior — castShadow / receiveShadow flags on material3d.',
+        schema: {
+            type: 'object',
+            properties: {
+                refids: { type: 'array', items: { type: 'number' } },
+                castShadow: { type: 'boolean' },
+                receiveShadow: { type: 'boolean' }
+            },
+            required: ['refids']
+        },
+        builder: (args, _components) => buildSetShadowPropertiesOps(args)
+    },
+    {
+        name: 'clearStyle',
+        description: 'Reset specific styling aspects to default — useful before applying preset/binding. Aspects: fill/stroke/shadow/material/font/opacity.',
+        schema: {
+            type: 'object',
+            properties: {
+                refids: { type: 'array', items: { type: 'number' } },
+                aspects: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['fill', 'stroke', 'shadow', 'material', 'font', 'opacity']
+                    }
+                }
+            },
+            required: ['refids', 'aspects']
+        },
+        builder: (args, _components) => buildClearStyleOps(args)
+    },
+    {
+        name: 'copyStyle',
+        description: "Copy STYLING from one component to others. Use for 'make these components look like that one' patterns. aspects can limit which styling areas to copy (default: all except visibility). Source's styling is read server-side — you don't need getComponentStyle first.",
+        schema: {
+            type: 'object',
+            properties: {
+                sourceRefid: { type: 'number', description: 'Component to copy from' },
+                targetRefids: {
+                    type: 'array',
+                    items: { type: 'number' },
+                    description: 'Components to copy to (source excluded automatically)'
+                },
+                aspects: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['fill', 'stroke', 'shadow', 'material', 'font', 'opacity', 'visibility']
+                    },
+                    description: 'Which styling aspects to copy. Default: fill/stroke/shadow/material/font/opacity (visibility excluded by default).'
+                }
+            },
+            required: ['sourceRefid', 'targetRefids']
+        },
+        // copyStyle 은 source lookup 위해 components 배열 필요
+        builder: (args, components) => buildCopyStyleOps(args, components)
+    }
+];
+// ── Helpers — 사용처에서 호출 ────────────────────────────────────
+/**
+ * registry 에 등록된 모든 styling tool 이름 set.
+ * WRITE_TOOL_NAMES 합산용 — assistant.ts 가 isWriteTool 판정 시 styling 영역
+ * 부분을 본 set 에 위임.
+ */
+export function getStylingToolNames(registry = STYLING_TOOLS) {
+    return new Set(registry.map(s => s.name));
+}
+/**
+ * LLM 에 노출할 tool 정의 배열.
+ * buildBoardEditTools 가 styling 부분을 본 함수 결과로 채운다.
+ */
+export function buildStylingToolDefinitions(registry = STYLING_TOOLS) {
+    return registry.map(spec => ({
+        name: spec.name,
+        description: spec.themeNote
+            ? `${spec.description} ${spec.themeNote}`
+            : spec.description,
+        parameters: spec.schema
+    }));
+}
+/**
+ * AIToolCall name 에 매칭되는 styling tool 의 builder 호출 → BoardEditOp[] | null.
+ *
+ * 반환:
+ *   - 매칭 spec 없음 → null (caller 가 다른 카테고리 dispatch 시도)
+ *   - 빈 ops (validation 실패 등) → null (assistant.ts 의 기존 동작과 동일)
+ *   - 정상 → BoardEditOp[]
+ *
+ * components 인자는 copyStyle 같은 source-lookup 필요 tool 에만 의미 있음.
+ */
+export function dispatchStylingTool(name, args, components = [], registry = STYLING_TOOLS) {
+    const spec = registry.find(s => s.name === name);
+    if (!spec)
+        return null;
+    const result = spec.builder(args, components);
+    return result.ops.length > 0 ? result.ops : null;
+}
+/** name 이 styling tool 로 등록되어 있는가. */
+export function isStylingTool(name, registry = STYLING_TOOLS) {
+    return registry.some(s => s.name === name);
+}
+//# sourceMappingURL=registry.js.map