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

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

@@ -0,0 +1,352 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STYLING_TOOLS = void 0;
+exports.getStylingToolNames = getStylingToolNames;
+exports.buildStylingToolDefinitions = buildStylingToolDefinitions;
+exports.dispatchStylingTool = dispatchStylingTool;
+exports.isStylingTool = isStylingTool;
+const fill_tools_1 = require("./fill-tools");
+const stroke_tools_1 = require("./stroke-tools");
+const text_tools_1 = require("./text-tools");
+const effect_tools_1 = require("./effect-tools");
+const material_tools_1 = require("./material-tools");
+const clear_tools_1 = require("./clear-tools");
+const copy_tools_1 = require("./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 도 그대로 통과.
+ */
+exports.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) => (0, fill_tools_1.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) => (0, stroke_tools_1.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) => (0, text_tools_1.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) => (0, text_tools_1.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) => (0, effect_tools_1.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) => (0, effect_tools_1.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) => (0, effect_tools_1.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) => (0, material_tools_1.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) => (0, material_tools_1.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) => (0, clear_tools_1.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) => (0, copy_tools_1.buildCopyStyleOps)(args, components)
+    }
+];
+// ── Helpers — 사용처에서 호출 ────────────────────────────────────
+/**
+ * registry 에 등록된 모든 styling tool 이름 set.
+ * WRITE_TOOL_NAMES 합산용 — assistant.ts 가 isWriteTool 판정 시 styling 영역
+ * 부분을 본 set 에 위임.
+ */
+function getStylingToolNames(registry = exports.STYLING_TOOLS) {
+    return new Set(registry.map(s => s.name));
+}
+/**
+ * LLM 에 노출할 tool 정의 배열.
+ * buildBoardEditTools 가 styling 부분을 본 함수 결과로 채운다.
+ */
+function buildStylingToolDefinitions(registry = exports.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 에만 의미 있음.
+ */
+function dispatchStylingTool(name, args, components = [], registry = exports.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 로 등록되어 있는가. */
+function isStylingTool(name, registry = exports.STYLING_TOOLS) {
+    return registry.some(s => s.name === name);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../server/service/styling/registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Styling tool registry — 선언형 단일 진실 (single source of truth).\n *\n * 동기:\n *   기존 styling tool 추가 시 4-5곳 (WRITE_TOOL_NAMES set / tools 배열 정의 /\n *   dispatch case / validation case / system prompt 안내) 에 같은 정보가 산재해\n *   동기화 누락 위험. 신규 tool 마다 4곳 boilerplate.\n *\n * 본 registry 가 한 곳에 모음 — 위 모든 사용처가 STYLING_TOOLS 에서 자동 도출.\n *\n * 마이그레이션:\n *   STYLING_TOOLS 는 초기엔 비어있고, 한 tool 씩 점진 이전한다. 각 단계마다\n *   기존 hardcoded 정의/dispatch 와 byte-단위 동등성을 단위 테스트가 잠금.\n *\n * 비-styling write tool (addComponent / modifyBoard / alignComponents 등) 은\n * 본 registry 의 영역이 아니다 — 의미·구조가 styling 패턴과 달라 별도 dispatch.\n */\nimport type { BoardEditOp } from '../types'\nimport { buildSetFillOps } from './fill-tools'\nimport { buildSetStrokeOps } from './stroke-tools'\nimport { buildSetTextOps, buildSetFontOps } from './text-tools'\nimport { buildSetShadowOps, buildSetOpacityOps, buildSetVisibleOps } from './effect-tools'\nimport { buildSetMaterialOps, buildSetShadowPropertiesOps } from './material-tools'\nimport { buildClearStyleOps } from './clear-tools'\nimport { buildCopyStyleOps } from './copy-tools'\n\nexport interface OpsResult {\n  ops: BoardEditOp[]\n  errors: string[]\n}\n\n/**\n * 한 styling tool 의 모든 메타데이터 + 빌더.\n *\n * description 과 themeNote 는 별도 — 자동 합성될 때 description 본문은 영문/기능\n * 위주로 짧게, themeNote 는 한국어 ⚠ 정책 단문. 분리해 두면 미래에 i18n / 정책\n * 일괄 변경 시 검색-치환이 쉽다.\n */\nexport interface StylingToolSpec {\n  /** AIToolCall.name 과 매칭. unique. */\n  name: string\n  /** 기능 설명 (영문 위주). */\n  description: string\n  /**\n   * 선택 — ⚠ 정책 / 테마 가이드 단문. 빌드 시 description 끝에 자동 부착.\n   * 예: '⚠ 테마 요청 시 width/dash 건드리지 말 것.'\n   */\n  themeNote?: string\n  /** JSON Schema for parameters — LLM tool schema 에 그대로 노출. */\n  schema: any\n  /**\n   * AIToolCall.arguments → OpsResult 변환.\n   * components 는 copyStyle 처럼 source lookup 필요한 tool 만 사용. 다른 tool 은\n   * 두 번째 인자 무시하면 됨.\n   */\n  builder: (args: any, components: ReadonlyArray<any>) => OpsResult\n}\n\n/**\n * 등록된 styling tool 들. 한 tool 씩 점진 이전 중.\n *\n * 마이그레이션 순서: setFill → setStroke → setText/setFont → setShadow /\n *   setOpacity / setVisible → setMaterial / setShadowProperties → clearStyle\n *   → copyStyle. 각 이전 commit 은 별도 — bisect 로 회귀 추적 용이.\n *\n * spec 작성 규약:\n *   - description 은 영문 / 기능 설명\n *   - themeNote 는 ⚠ 시작 한국어 정책 단문 (테마 가이드 / 호출 금지 등)\n *   - schema 는 LLM 에 그대로 노출되는 JSON Schema\n *   - builder 는 builder 함수 직접 사용 (signature 호환). components 인자\n *     안 쓰는 tool 도 그대로 통과.\n */\nexport const STYLING_TOOLS: StylingToolSpec[] = [\n  {\n    name: 'setFill',\n    description:\n      \"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.\",\n    schema: {\n      type: 'object',\n      properties: {\n        refids: {\n          type: 'array',\n          items: { type: 'number' },\n          description: 'Components to update. things-scene auto-assigned numeric handles.'\n        },\n        mode: {\n          type: 'string',\n          enum: ['none', 'solid', 'gradient', 'pattern', 'image'],\n          description: 'Fill mode dispatcher (synthetic — not stored on the model). Omit for partial update of color/opacity within the existing mode.'\n        },\n        color: {\n          type: 'string',\n          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).\"\n        },\n        gradientType: {\n          type: 'string',\n          enum: ['linear', 'radial'],\n          description: 'Gradient kind (when mode=gradient). Default linear. Stored at fillStyle.gradientType.'\n        },\n        colorStops: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              color: { type: 'string' },\n              position: { type: 'number', description: '0..1' }\n            },\n            required: ['color', 'position']\n          },\n          description: 'Gradient color stops (when mode=gradient). At least 2. Stored at fillStyle.colorStops (canonical things-scene field name).'\n        },\n        rotation: {\n          type: 'number',\n          description: 'Gradient rotation in degrees (when mode=gradient). Default 0. Internally converted to radians and stored at fillStyle.rotation.'\n        },\n        image: {\n          type: 'string',\n          description: 'Image URL or asset reference (when mode=pattern or mode=image). Stored at fillStyle.image.'\n        },\n        opacity: {\n          type: 'number',\n          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.'\n        }\n      },\n      required: ['refids']\n    },\n    builder: (args, _components) => buildSetFillOps(args)\n  },\n  {\n    name: 'setStroke',\n    description:\n      \"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' 도 가능.\",\n    themeNote:\n      '⚠ 테마 요청 (북유럽/사이버펑크/미니멀 등) 시 lineWidth/dash/lineCap/lineJoin 은 건드리지 말 것 — 선의 두께·점선 패턴은 디자인 의도를 가진 *구조* 다. strokeStyle (색상) 만 테마 팔레트에 맞춰 변경. 사용자가 명시적으로 두께/점선 변경을 요청한 경우에만 lineWidth/dash 사용.',\n    schema: {\n      type: 'object',\n      properties: {\n        refids: { type: 'array', items: { type: 'number' } },\n        enabled: {\n          type: 'boolean',\n          description: 'Synthetic helper — false maps to lineWidth=0 (drawer skips). Not stored on the model itself.'\n        },\n        strokeStyle: {\n          type: 'string',\n          description: 'Stroke color (CSS color string — hex / rgb / named / semantic alias). Stored at top-level state.strokeStyle.'\n        },\n        lineWidth: {\n          type: 'number',\n          description: 'Stroke width in pixels (0 = no stroke). Stored at top-level state.lineWidth.'\n        },\n        dash: {\n          description:\n            \"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.\"\n        },\n        lineCap: {\n          type: 'string',\n          enum: ['butt', 'round', 'square'],\n          description: 'Line cap style. Stored at top-level state.lineCap.'\n        },\n        lineJoin: {\n          type: 'string',\n          enum: ['miter', 'round', 'bevel'],\n          description: 'Line join style. Stored at top-level state.lineJoin.'\n        }\n      },\n      required: ['refids']\n    },\n    builder: (args, _components) => buildSetStrokeOps(args)\n  },\n  {\n    name: 'setText',\n    description: 'Change component TEXT CONTENT (state.text). For font styling use setFont separately.',\n    themeNote:\n      '⚠ 텍스트는 *콘텐츠* 이지 *스타일* 이 아니다 — 테마 요청 (북유럽/사이버펑크/미니멀 등) 시 호출 금지. 사용자가 텍스트 변경을 명시한 경우에만 사용.',\n    schema: {\n      type: 'object',\n      properties: {\n        refids: { type: 'array', items: { type: 'number' } },\n        text: { type: 'string' }\n      },\n      required: ['refids', 'text']\n    },\n    builder: (args, _components) => buildSetTextOps(args)\n  },\n  {\n    name: 'setFont',\n    description:\n      'Set FONT/TEXT STYLE (family / size / weight / style / color / align / baseline / lineHeight). For text content use setText.',\n    themeNote:\n      '⚠ 테마 요청 (북유럽/사이버펑크 등) 시 fontSize / fontFamily 는 건드리지 말 것 — 정보 위계와 레이아웃에 영향. fontColor 만 테마 팔레트에 맞춰 변경. 사용자가 명시적으로 폰트 크기/패밀리 변경을 요청한 경우에만 사용.',\n    schema: {\n      type: 'object',\n      properties: {\n        refids: { type: 'array', items: { type: 'number' } },\n        fontFamily: { type: 'string' },\n        fontSize: { type: 'number' },\n        fontWeight: {\n          description: \"'normal' | 'bold' | 'lighter' | 'bolder' | 100..900\"\n        },\n        fontStyle: { type: 'string', enum: ['normal', 'italic', 'oblique'] },\n        fontColor: { type: 'string' },\n        textAlign: {\n          type: 'string',\n          enum: ['left', 'center', 'right', 'start', 'end', 'justify']\n        },\n        textBaseline: {\n          type: 'string',\n          enum: ['top', 'middle', 'bottom', 'hanging', 'alphabetic', 'ideographic']\n        },\n        lineHeight: { type: 'number' }\n      },\n      required: ['refids']\n    },\n    builder: (args, _components) => buildSetFontOps(args)\n  },\n  {\n    name: 'setShadow',\n    description:\n      '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).',\n    schema: {\n      type: 'object',\n      properties: {\n        refids: { type: 'array', items: { type: 'number' } },\n        enabled: {\n          type: 'boolean',\n          description: 'Synthetic helper — false maps to blur=0 + color=transparent. Not stored as a model field.'\n        },\n        color: {\n          type: 'string',\n          description: 'Shadow color (CSS color string). Stored at state.shadow.color.'\n        },\n        blur: {\n          type: 'number',\n          description: 'Shadow blur radius in pixels (matches CSS box-shadow blur-radius / Canvas shadowBlur). Stored at state.shadow.blur.'\n        },\n        offsetX: {\n          type: 'number',\n          description: 'Shadow horizontal offset in pixels (matches CSS box-shadow offset-x / Canvas shadowOffsetX). Stored at state.shadow.offsetX.'\n        },\n        offsetY: {\n          type: 'number',\n          description: 'Shadow vertical offset in pixels (matches CSS box-shadow offset-y / Canvas shadowOffsetY). Stored at state.shadow.offsetY.'\n        }\n      },\n      required: ['refids']\n    },\n    builder: (args, _components) => buildSetShadowOps(args)\n  },\n  {\n    name: 'setOpacity',\n    description: 'Set component overall ALPHA (canonical things-scene field state.alpha, 0..1).',\n    schema: {\n      type: 'object',\n      properties: {\n        refids: { type: 'array', items: { type: 'number' } },\n        alpha: {\n          type: 'number',\n          description: 'Component overall opacity 0..1 (1 = opaque, 0 = invisible). Stored at top-level state.alpha.'\n        }\n      },\n      required: ['refids', 'alpha']\n    },\n    builder: (args, _components) => buildSetOpacityOps(args)\n  },\n  {\n    name: 'setVisible',\n    description: 'Show/hide components (state.hidden = !visible).',\n    schema: {\n      type: 'object',\n      properties: {\n        refids: { type: 'array', items: { type: 'number' } },\n        visible: { type: 'boolean' }\n      },\n      required: ['refids', 'visible']\n    },\n    builder: (args, _components) => buildSetVisibleOps(args)\n  },\n  {\n    name: 'setMaterial',\n    description:\n      '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.',\n    schema: {\n      type: 'object',\n      properties: {\n        refids: { type: 'array', items: { type: 'number' } },\n        preset: {\n          type: 'string',\n          enum: ['default', 'metal', 'glass', 'plastic', 'wood', 'ceramic', 'rubber', 'custom']\n        },\n        metalness: { type: 'number', description: '0..1' },\n        roughness: { type: 'number', description: '0..1' },\n        emissive: { type: 'string', description: 'glow color (hex / named)' },\n        emissiveIntensity: { type: 'number', description: '0..5' },\n        opacity: { type: 'number', description: '0..1 (3D-only, separate from component alpha)' },\n        envMapIntensity: { type: 'number', description: '0..3' },\n        side: { type: 'string', enum: ['double', 'front', 'back'] }\n      },\n      required: ['refids']\n    },\n    builder: (args, _components) => buildSetMaterialOps(args)\n  },\n  {\n    name: 'setShadowProperties',\n    description: 'Set 3D shadow behavior — castShadow / receiveShadow flags on material3d.',\n    schema: {\n      type: 'object',\n      properties: {\n        refids: { type: 'array', items: { type: 'number' } },\n        castShadow: { type: 'boolean' },\n        receiveShadow: { type: 'boolean' }\n      },\n      required: ['refids']\n    },\n    builder: (args, _components) => buildSetShadowPropertiesOps(args)\n  },\n  {\n    name: 'clearStyle',\n    description:\n      'Reset specific styling aspects to default — useful before applying preset/binding. Aspects: fill/stroke/shadow/material/font/opacity.',\n    schema: {\n      type: 'object',\n      properties: {\n        refids: { type: 'array', items: { type: 'number' } },\n        aspects: {\n          type: 'array',\n          items: {\n            type: 'string',\n            enum: ['fill', 'stroke', 'shadow', 'material', 'font', 'opacity']\n          }\n        }\n      },\n      required: ['refids', 'aspects']\n    },\n    builder: (args, _components) => buildClearStyleOps(args)\n  },\n  {\n    name: 'copyStyle',\n    description:\n      \"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.\",\n    schema: {\n      type: 'object',\n      properties: {\n        sourceRefid: { type: 'number', description: 'Component to copy from' },\n        targetRefids: {\n          type: 'array',\n          items: { type: 'number' },\n          description: 'Components to copy to (source excluded automatically)'\n        },\n        aspects: {\n          type: 'array',\n          items: {\n            type: 'string',\n            enum: ['fill', 'stroke', 'shadow', 'material', 'font', 'opacity', 'visibility']\n          },\n          description:\n            'Which styling aspects to copy. Default: fill/stroke/shadow/material/font/opacity (visibility excluded by default).'\n        }\n      },\n      required: ['sourceRefid', 'targetRefids']\n    },\n    // copyStyle 은 source lookup 위해 components 배열 필요\n    builder: (args, components) => buildCopyStyleOps(args, components as any[])\n  }\n]\n\n// ── Helpers — 사용처에서 호출 ────────────────────────────────────\n\n/**\n * registry 에 등록된 모든 styling tool 이름 set.\n * WRITE_TOOL_NAMES 합산용 — assistant.ts 가 isWriteTool 판정 시 styling 영역\n * 부분을 본 set 에 위임.\n */\nexport function getStylingToolNames(\n  registry: ReadonlyArray<StylingToolSpec> = STYLING_TOOLS\n): Set<string> {\n  return new Set(registry.map(s => s.name))\n}\n\n/**\n * LLM 에 노출할 tool 정의 배열.\n * buildBoardEditTools 가 styling 부분을 본 함수 결과로 채운다.\n */\nexport function buildStylingToolDefinitions(\n  registry: ReadonlyArray<StylingToolSpec> = STYLING_TOOLS\n): Array<{ name: string; description: string; parameters: any }> {\n  return registry.map(spec => ({\n    name: spec.name,\n    description: spec.themeNote\n      ? `${spec.description} ${spec.themeNote}`\n      : spec.description,\n    parameters: spec.schema\n  }))\n}\n\n/**\n * AIToolCall name 에 매칭되는 styling tool 의 builder 호출 → BoardEditOp[] | null.\n *\n * 반환:\n *   - 매칭 spec 없음 → null (caller 가 다른 카테고리 dispatch 시도)\n *   - 빈 ops (validation 실패 등) → null (assistant.ts 의 기존 동작과 동일)\n *   - 정상 → BoardEditOp[]\n *\n * components 인자는 copyStyle 같은 source-lookup 필요 tool 에만 의미 있음.\n */\nexport function dispatchStylingTool(\n  name: string,\n  args: any,\n  components: ReadonlyArray<any> = [],\n  registry: ReadonlyArray<StylingToolSpec> = STYLING_TOOLS\n): BoardEditOp[] | null {\n  const spec = registry.find(s => s.name === name)\n  if (!spec) return null\n  const result = spec.builder(args, components)\n  return result.ops.length > 0 ? result.ops : null\n}\n\n/** name 이 styling tool 로 등록되어 있는가. */\nexport function isStylingTool(\n  name: string,\n  registry: ReadonlyArray<StylingToolSpec> = STYLING_TOOLS\n): boolean {\n  return registry.some(s => s.name === name)\n}\n"]}

package/dist-server/service/styling/stroke-tools.d.ts

@@ -0,0 +1,35 @@
+/**
+ * setStroke — 컴포넌트 테두리 / 라인 스타일.
+ *
+ * **things-scene 의 실제 데이터 형식 (drawer/stroke.ts 검증):**
+ *   - `state.strokeStyle: string` (색상 — Canvas API 의 strokeStyle 에 직접 대입되는 CSS color)
+ *   - `state.lineWidth: number` (top-level)
+ *   - `state.lineDash: string` (top-level — preset 이름. drawer 가 lineWidth 기반으로 배열 변환)
+ *     valid: 'solid' | 'round-dot' | 'square-dot' | 'dash' | 'dash-dot' | 'long-dash' | 'long-dash-dot' | 'long-dash-dot-dot'
+ *   - `state.lineCap: 'butt' | 'round' | 'square'` (top-level)
+ *   - `state.lineJoin: 'miter' | 'round' | 'bevel'` (top-level)
+ *
+ * 인터페이스의 `StrokeStyle` 객체 구조는 stale. 사용처는 모두 top-level 직접 접근.
+ *
+ * 입력 단순화 — AI 친화적 alias 도 받아 things-scene preset 으로 매핑:
+ *   AI 'dashed' → 'dash', 'dotted' → 'square-dot', 'dashdot' → 'dash-dot'.
+ */
+import type { BoardEditOp } from '../types';
+export interface SetStrokeInput {
+    refids: number[];
+    /** synthetic — false 면 lineWidth=0 으로 매핑 (drawer 가 안 그림). 모델에 enabled 필드는 안 박힘. */
+    enabled?: boolean;
+    /** state.strokeStyle 의 canonical 이름. CSS color string. */
+    strokeStyle?: string;
+    /** state.lineWidth 의 canonical 이름. pixels. */
+    lineWidth?: number;
+    /** preset 이름. AI 친화 alias 자동 매핑 — 'dashed' / 'dotted' / 'dashdot' 도 가능. */
+    dash?: 'solid' | 'dashed' | 'dotted' | 'dashdot' | 'round-dot' | 'square-dot' | 'dash' | 'dash-dot' | 'long-dash' | 'long-dash-dot' | 'long-dash-dot-dot' | string;
+    lineCap?: 'butt' | 'round' | 'square';
+    lineJoin?: 'miter' | 'round' | 'bevel';
+}
+export interface SetStrokeResult {
+    ops: BoardEditOp[];
+    errors: string[];
+}
+export declare function buildSetStrokeOps(input: SetStrokeInput): SetStrokeResult;

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

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSetStrokeOps = buildSetStrokeOps;
+const color_utils_1 = require("./color-utils");
+/** AI 친화 alias → things-scene 의 실제 preset 이름. */
+const DASH_ALIASES = {
+    dashed: 'dash',
+    dotted: 'square-dot',
+    dashdot: 'dash-dot'
+};
+const VALID_DASH = new Set([
+    'solid',
+    'round-dot',
+    'square-dot',
+    'dash',
+    'dash-dot',
+    'long-dash',
+    'long-dash-dot',
+    'long-dash-dot-dot'
+]);
+// Canvas CanvasRenderingContext2D 가 허용하는 lineCap / lineJoin 만.
+// 잘못된 값은 Canvas 가 silent ignore → AI 가 'flat' / 'cap' 등을 보내도
+// 효과 없음. 명시 검증으로 ops 미실행 + 명확한 에러.
+const VALID_LINE_CAP = new Set(['butt', 'round', 'square']);
+const VALID_LINE_JOIN = new Set(['miter', 'round', 'bevel']);
+function buildSetStrokeOps(input) {
+    if (!Array.isArray(input.refids) || input.refids.length === 0) {
+        return { ops: [], errors: ['refids must be a non-empty array of numbers'] };
+    }
+    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.enabled === undefined &&
+        input.strokeStyle === undefined &&
+        input.lineWidth === undefined &&
+        input.dash === undefined &&
+        input.lineCap === undefined &&
+        input.lineJoin === undefined;
+    if (noOp) {
+        return { ops: [], errors: ['No stroke changes specified'] };
+    }
+    // 검증
+    if (input.strokeStyle !== undefined) {
+        const v = (0, color_utils_1.validateColor)(input.strokeStyle);
+        if (!v.valid)
+            return { ops: [], errors: [v.error ?? 'Invalid strokeStyle'] };
+    }
+    if (input.lineWidth !== undefined && (input.lineWidth < 0 || !Number.isFinite(input.lineWidth))) {
+        return { ops: [], errors: [`Invalid lineWidth: ${input.lineWidth}`] };
+    }
+    if (input.lineCap !== undefined && !VALID_LINE_CAP.has(input.lineCap)) {
+        return {
+            ops: [],
+            errors: [`Unknown lineCap: '${input.lineCap}'. Valid: ${[...VALID_LINE_CAP].join(' / ')}.`]
+        };
+    }
+    if (input.lineJoin !== undefined && !VALID_LINE_JOIN.has(input.lineJoin)) {
+        return {
+            ops: [],
+            errors: [`Unknown lineJoin: '${input.lineJoin}'. Valid: ${[...VALID_LINE_JOIN].join(' / ')}.`]
+        };
+    }
+    // dash 정규화 — alias → 실제 preset → 검증
+    let dashValue;
+    if (input.dash !== undefined) {
+        const raw = String(input.dash);
+        const resolved = DASH_ALIASES[raw] ?? raw;
+        if (!VALID_DASH.has(resolved)) {
+            return {
+                ops: [],
+                errors: [
+                    `Unknown dash: '${input.dash}'. Valid: ${[...VALID_DASH].join(' / ')} (or alias: dashed/dotted/dashdot).`
+                ]
+            };
+        }
+        dashValue = resolved;
+    }
+    // patch 구성 — canonical 이름 그대로. 매핑 X. (color 만 normalizeColor 통과 — 입력 정규화는 mapping 이 아닌 처리)
+    const patch = {};
+    if (input.strokeStyle !== undefined)
+        patch.strokeStyle = (0, color_utils_1.normalizeColor)(input.strokeStyle);
+    if (input.lineWidth !== undefined)
+        patch.lineWidth = input.lineWidth;
+    if (dashValue !== undefined)
+        patch.lineDash = dashValue;
+    if (input.lineCap !== undefined)
+        patch.lineCap = input.lineCap;
+    if (input.lineJoin !== undefined)
+        patch.lineJoin = input.lineJoin;
+    // synthetic enabled — false 면 lineWidth 0 으로 변환 (drawer 가 안 그림 — drawer/stroke.ts:9)
+    if (input.enabled === false) {
+        patch.lineWidth = 0;
+    }
+    const ops = refids.map(refid => ({ op: 'modify', refid, patch }));
+    return { ops, errors: [] };
+}
+//# sourceMappingURL=stroke-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stroke-tools.js","sourceRoot":"","sources":["../../../server/service/styling/stroke-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * setStroke — 컴포넌트 테두리 / 라인 스타일.\n *\n * **things-scene 의 실제 데이터 형식 (drawer/stroke.ts 검증):**\n *   - `state.strokeStyle: string` (색상 — Canvas API 의 strokeStyle 에 직접 대입되는 CSS color)\n *   - `state.lineWidth: number` (top-level)\n *   - `state.lineDash: string` (top-level — preset 이름. drawer 가 lineWidth 기반으로 배열 변환)\n *     valid: 'solid' | 'round-dot' | 'square-dot' | 'dash' | 'dash-dot' | 'long-dash' | 'long-dash-dot' | 'long-dash-dot-dot'\n *   - `state.lineCap: 'butt' | 'round' | 'square'` (top-level)\n *   - `state.lineJoin: 'miter' | 'round' | 'bevel'` (top-level)\n *\n * 인터페이스의 `StrokeStyle` 객체 구조는 stale. 사용처는 모두 top-level 직접 접근.\n *\n * 입력 단순화 — AI 친화적 alias 도 받아 things-scene preset 으로 매핑:\n *   AI 'dashed' → 'dash', 'dotted' → 'square-dot', 'dashdot' → 'dash-dot'.\n */\nimport type { BoardEditOp } from '../types'\nimport { normalizeColor, validateColor } from './color-utils'\n\nexport interface SetStrokeInput {\n  refids: number[]\n  /** synthetic — false 면 lineWidth=0 으로 매핑 (drawer 가 안 그림). 모델에 enabled 필드는 안 박힘. */\n  enabled?: boolean\n  /** state.strokeStyle 의 canonical 이름. CSS color string. */\n  strokeStyle?: string\n  /** state.lineWidth 의 canonical 이름. pixels. */\n  lineWidth?: number\n  /** preset 이름. AI 친화 alias 자동 매핑 — 'dashed' / 'dotted' / 'dashdot' 도 가능. */\n  dash?:\n    | 'solid'\n    | 'dashed'\n    | 'dotted'\n    | 'dashdot'\n    | 'round-dot'\n    | 'square-dot'\n    | 'dash'\n    | 'dash-dot'\n    | 'long-dash'\n    | 'long-dash-dot'\n    | 'long-dash-dot-dot'\n    | string\n  lineCap?: 'butt' | 'round' | 'square'\n  lineJoin?: 'miter' | 'round' | 'bevel'\n}\n\nexport interface SetStrokeResult {\n  ops: BoardEditOp[]\n  errors: string[]\n}\n\n/** AI 친화 alias → things-scene 의 실제 preset 이름. */\nconst DASH_ALIASES: Record<string, string> = {\n  dashed: 'dash',\n  dotted: 'square-dot',\n  dashdot: 'dash-dot'\n}\n\nconst VALID_DASH = new Set([\n  'solid',\n  'round-dot',\n  'square-dot',\n  'dash',\n  'dash-dot',\n  'long-dash',\n  'long-dash-dot',\n  'long-dash-dot-dot'\n])\n\n// Canvas CanvasRenderingContext2D 가 허용하는 lineCap / lineJoin 만.\n// 잘못된 값은 Canvas 가 silent ignore → AI 가 'flat' / 'cap' 등을 보내도\n// 효과 없음. 명시 검증으로 ops 미실행 + 명확한 에러.\nconst VALID_LINE_CAP = new Set(['butt', 'round', 'square'])\nconst VALID_LINE_JOIN = new Set(['miter', 'round', 'bevel'])\n\nexport function buildSetStrokeOps(input: SetStrokeInput): SetStrokeResult {\n  if (!Array.isArray(input.refids) || input.refids.length === 0) {\n    return { ops: [], errors: ['refids must be a non-empty array of numbers'] }\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.enabled === undefined &&\n    input.strokeStyle === undefined &&\n    input.lineWidth === undefined &&\n    input.dash === undefined &&\n    input.lineCap === undefined &&\n    input.lineJoin === undefined\n  if (noOp) {\n    return { ops: [], errors: ['No stroke changes specified'] }\n  }\n\n  // 검증\n  if (input.strokeStyle !== undefined) {\n    const v = validateColor(input.strokeStyle)\n    if (!v.valid) return { ops: [], errors: [v.error ?? 'Invalid strokeStyle'] }\n  }\n  if (input.lineWidth !== undefined && (input.lineWidth < 0 || !Number.isFinite(input.lineWidth))) {\n    return { ops: [], errors: [`Invalid lineWidth: ${input.lineWidth}`] }\n  }\n  if (input.lineCap !== undefined && !VALID_LINE_CAP.has(input.lineCap)) {\n    return {\n      ops: [],\n      errors: [`Unknown lineCap: '${input.lineCap}'. Valid: ${[...VALID_LINE_CAP].join(' / ')}.`]\n    }\n  }\n  if (input.lineJoin !== undefined && !VALID_LINE_JOIN.has(input.lineJoin)) {\n    return {\n      ops: [],\n      errors: [`Unknown lineJoin: '${input.lineJoin}'. Valid: ${[...VALID_LINE_JOIN].join(' / ')}.`]\n    }\n  }\n\n  // dash 정규화 — alias → 실제 preset → 검증\n  let dashValue: string | undefined\n  if (input.dash !== undefined) {\n    const raw = String(input.dash)\n    const resolved = DASH_ALIASES[raw] ?? raw\n    if (!VALID_DASH.has(resolved)) {\n      return {\n        ops: [],\n        errors: [\n          `Unknown dash: '${input.dash}'. Valid: ${[...VALID_DASH].join(' / ')} (or alias: dashed/dotted/dashdot).`\n        ]\n      }\n    }\n    dashValue = resolved\n  }\n\n  // patch 구성 — canonical 이름 그대로. 매핑 X. (color 만 normalizeColor 통과 — 입력 정규화는 mapping 이 아닌 처리)\n  const patch: any = {}\n  if (input.strokeStyle !== undefined) patch.strokeStyle = normalizeColor(input.strokeStyle)\n  if (input.lineWidth !== undefined) patch.lineWidth = input.lineWidth\n  if (dashValue !== undefined) patch.lineDash = dashValue\n  if (input.lineCap !== undefined) patch.lineCap = input.lineCap\n  if (input.lineJoin !== undefined) patch.lineJoin = input.lineJoin\n\n  // synthetic enabled — false 면 lineWidth 0 으로 변환 (drawer 가 안 그림 — drawer/stroke.ts:9)\n  if (input.enabled === false) {\n    patch.lineWidth = 0\n  }\n\n  const ops: BoardEditOp[] = refids.map(refid => ({ op: 'modify', refid, patch }))\n  return { ops, errors: [] }\n}\n"]}

package/dist-server/service/styling/text-tools.d.ts

@@ -0,0 +1,32 @@
+/**
+ * setText / setFont — 컴포넌트의 텍스트 내용 / 폰트 스타일.
+ *
+ * setText: state.text 변경 (내용)
+ * setFont: state.fontFamily / fontSize / fontWeight / fontStyle / fontColor /
+ *          textAlign / textBaseline / lineHeight 변경 (폰트 스타일)
+ *
+ * 두 tool 분리 — 의도가 다름. 내용 변경 vs 시각 스타일.
+ */
+import type { BoardEditOp } from '../types';
+export interface SetTextInput {
+    refids: number[];
+    text: string;
+}
+export interface SetFontInput {
+    refids: number[];
+    fontFamily?: string;
+    fontSize?: number;
+    fontWeight?: 'normal' | 'bold' | 'lighter' | 'bolder' | string | number;
+    fontStyle?: 'normal' | 'italic' | 'oblique';
+    fontColor?: string;
+    /** Canvas API 표준 — 'justify' 는 Canvas 미지원이라 제외. */
+    textAlign?: 'left' | 'center' | 'right' | 'start' | 'end';
+    textBaseline?: 'top' | 'middle' | 'bottom' | 'hanging' | 'alphabetic' | 'ideographic';
+    lineHeight?: number;
+}
+export interface OpsResult {
+    ops: BoardEditOp[];
+    errors: string[];
+}
+export declare function buildSetTextOps(input: SetTextInput): OpsResult;
+export declare function buildSetFontOps(input: SetFontInput): OpsResult;