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

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

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSetFillOps = buildSetFillOps;
+const color_utils_1 = require("./color-utils");
+/**
+ * setFill 입력 검증 + BoardEditOp[] 생성.
+ *
+ * 기본 정책:
+ *   - refids 비어있거나 mode 도 색도 없으면 에러
+ *   - 색상 입력은 normalizeColor 통과해야 적용
+ *   - mode='gradient' 인데 stops 없으면 자동 생성 (color → 어두운 변형)
+ */
+function buildSetFillOps(input) {
+    const errors = [];
+    const ops = [];
+    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 in input'] };
+    }
+    // mode 미지정 + 어떤 styling 인자도 없으면 무의미
+    if (!input.mode &&
+        !input.color &&
+        !input.colorStops &&
+        !input.image &&
+        typeof input.opacity !== 'number') {
+        return {
+            ops: [],
+            errors: ['No fill changes specified. Provide mode and/or color/opacity/etc.']
+        };
+    }
+    // 색상 검증
+    if (input.color !== undefined) {
+        const v = (0, color_utils_1.validateColor)(input.color);
+        if (!v.valid) {
+            errors.push(v.error ?? `Invalid color: ${input.color}`);
+            return { ops: [], errors };
+        }
+    }
+    // gradient stops 검증
+    if (input.colorStops) {
+        for (const s of input.colorStops) {
+            if (typeof s.position !== 'number' || s.position < 0 || s.position > 1) {
+                errors.push(`Gradient stop position out of [0,1]: ${s.position}`);
+                return { ops: [], errors };
+            }
+            const v = (0, color_utils_1.validateColor)(s.color);
+            if (!v.valid) {
+                errors.push(`Invalid gradient stop color: ${s.color}`);
+                return { ops: [], errors };
+            }
+        }
+    }
+    // opacity 검증
+    if (typeof input.opacity === 'number') {
+        if (input.opacity < 0 || input.opacity > 1) {
+            errors.push(`Opacity out of [0,1]: ${input.opacity}`);
+            return { ops: [], errors };
+        }
+    }
+    // pattern — image 필수
+    if (input.mode === 'pattern' && !input.image) {
+        errors.push(`Mode 'pattern' requires 'image' (URL or asset ref)`);
+        return { ops: [], errors };
+    }
+    // 각 refid 별 patch 생성
+    const patch = buildFillPatch(input);
+    if (!patch) {
+        return { ops: [], errors: ['Failed to build fill patch'] };
+    }
+    // 단일 op — apply-patch 의 deep merge 가 자연스럽게 처리:
+    //   - 새 fillStyle 이 string (solid) → 기존 object 통째 replace (typeof 매칭 X)
+    //   - 새 fillStyle 이 object → 같은 key (colorStops 배열 등) 는 array replace 됨
+    //   - 기존 부가 필드 (rotation 등) 가 새 patch 에 없으면 유지 — partial update 의도
+    // 이전 2-op (null + new) 방식은 중간 null 상태가 onchange / 3D texture trigger 해
+    // 크래시 유발 → 제거. 정확한 colorStops 출력으로 stale 필드 문제 자체가 해결됐음.
+    for (const refid of refids) {
+        ops.push({ op: 'modify', refid, patch });
+    }
+    return { ops, errors };
+}
+/**
+ * input → fillStyle patch 객체 생성.
+ *
+ * Mode 명시 시: fillStyle 통째 교체 → patch = { fillStyle: {...새 객체} }
+ * Mode 미지정 시: 기존 fillStyle 위에 색/opacity 만 병합 → patch = { fillStyle: { ...덮어쓸 필드 } }
+ *   (apply-patch 의 deep-merge 가 처리. fillStyle 이 객체라면.)
+ *
+ * mode='none' 의 경우 fillStyle 을 falsy 로 — 빈 객체 또는 type:'none' 명시.
+ */
+function buildFillPatch(input) {
+    const { mode } = input;
+    if (mode === 'none') {
+        // fillStyle 제거 의도 — null 시맨틱 활용 (apply-patch 가 키 자체를 delete).
+        // drawer/fill.ts: fillStyle 없으면 falsy → 채우지 않음.
+        return { fillStyle: null };
+    }
+    if (mode === 'solid') {
+        // things-scene drawer/fill.ts:17 — fillStyle 이 string 이면 그대로 색상.
+        // 객체 형식 {type:'solid', color} 은 인터페이스에만 있는 stale.
+        // opacity 는 색상에 alpha 채널로 embedding (rgba).
+        const color = input.color ? (0, color_utils_1.normalizeColor)(input.color) : undefined;
+        if (!color)
+            return null;
+        let fillStyle = color;
+        if (typeof input.opacity === 'number' && input.opacity < 1) {
+            fillStyle = withAlpha(color, input.opacity);
+        }
+        return { fillStyle: fillStyle };
+    }
+    if (mode === 'gradient') {
+        let stops = input.colorStops;
+        // stops 미지정 시 — color 와 자동 생성 어두운 변형 (간단한 fallback)
+        if ((!stops || stops.length === 0) && input.color) {
+            const hex = (0, color_utils_1.normalizeColor)(input.color);
+            if (hex) {
+                stops = [
+                    { color: hex, position: 0 },
+                    { color: darken(hex, 0.4), position: 1 }
+                ];
+            }
+        }
+        if (!stops || stops.length < 2) {
+            // gradient 인데 stops 부족 — 호출자가 명시 안 하면 만들어 주지 않음
+            return null;
+        }
+        // things-scene 의 실제 필드: colorStops [{position, color}]
+        const colorStops = stops
+            .map(s => ({ position: s.position, color: (0, color_utils_1.normalizeColor)(s.color) }))
+            .filter(s => !!s.color);
+        if (colorStops.length < 2)
+            return null;
+        // rotation: 항상 명시 — drawer/fill.ts 가 default 없이 fillStyle.rotation 을 직접
+        // Math.cos / Math.sin 에 넘기므로 undefined 면 NaN → createLinearGradient 크래시.
+        // AI/사용자는 degrees 로 표현, 내부에서 라디안 변환. 미지정 시 0 default.
+        const rotationRad = typeof input.rotation === 'number' ? (input.rotation * Math.PI) / 180 : 0;
+        const fs = {
+            type: 'gradient',
+            gradientType: input.gradientType ?? 'linear',
+            colorStops,
+            rotation: rotationRad
+        };
+        if (typeof input.opacity === 'number')
+            fs.opacity = input.opacity;
+        return { fillStyle: fs };
+    }
+    if (mode === 'pattern') {
+        if (!input.image)
+            return null;
+        // things-scene 의 실제 pattern fillStyle (drawer/fill.ts:95~)
+        const fs = { type: 'pattern', image: input.image };
+        if (input.color) {
+            const c = (0, color_utils_1.normalizeColor)(input.color);
+            if (c)
+                fs.color = c; // 패턴 뒤 배경색 (drawer 가 사용)
+        }
+        if (input.fitPattern !== undefined)
+            fs.fitPattern = input.fitPattern;
+        if (input.noRepeat !== undefined)
+            fs.noRepeat = input.noRepeat;
+        if (input.align)
+            fs.align = input.align;
+        if (typeof input.offsetX === 'number')
+            fs.offsetX = input.offsetX;
+        if (typeof input.offsetY === 'number')
+            fs.offsetY = input.offsetY;
+        if (typeof input.patternWidth === 'number')
+            fs.width = input.patternWidth;
+        if (typeof input.patternHeight === 'number')
+            fs.height = input.patternHeight;
+        if (typeof input.opacity === 'number')
+            fs.opacity = input.opacity;
+        return { fillStyle: fs };
+    }
+    // mode 미지정 — 부분 update.
+    // things-scene 의 fillStyle 은 string (solid) 또는 object (gradient/pattern).
+    // 부분 update 에서 색만 들어오면 solid string 으로 통째 set (가장 흔한 케이스).
+    // (gradient 의 부분 update 는 mode='gradient' 명시 사용 — 모드 명시 시 full replace.)
+    if (input.color) {
+        const c = (0, color_utils_1.normalizeColor)(input.color);
+        if (!c)
+            return null;
+        const fillStyle = typeof input.opacity === 'number' && input.opacity < 1 ? withAlpha(c, input.opacity) : c;
+        return { fillStyle: fillStyle };
+    }
+    // color 없이 opacity 만 — 부분 update 어려움 (string 인지 object 인지 모름).
+    // 명확한 의도가 있으면 mode 명시 권장. 일단 무동작 (null).
+    return null;
+}
+/**
+ * hex / 명명 색 + alpha (0..1) → rgba(r,g,b,a) 문자열.
+ * Canvas API 의 fillStyle 은 rgba string 그대로 사용 가능.
+ */
+function withAlpha(hexOrName, alpha) {
+    // transparent
+    if (hexOrName === 'transparent')
+        return 'rgba(0,0,0,0)';
+    // hex 예상 (#rrggbb)
+    if (hexOrName.startsWith('#') && hexOrName.length === 7) {
+        const r = parseInt(hexOrName.slice(1, 3), 16);
+        const g = parseInt(hexOrName.slice(3, 5), 16);
+        const b = parseInt(hexOrName.slice(5, 7), 16);
+        return `rgba(${r},${g},${b},${alpha})`;
+    }
+    // 다른 형식이면 색을 그대로 두고 alpha 무시 (nullable 안전)
+    return hexOrName;
+}
+/**
+ * 단순 hex 색상 어둡게 — gradient 자동 생성 시 fallback 두 번째 stop 용.
+ * lightness 기반 정확도 < HSL 변환이 정확하지만 의존성 줄이려 RGB linear blend 로 대체.
+ */
+function darken(hex, amount) {
+    const p = (0, color_utils_1.parseColor)(hex);
+    if (!p || p.hex === 'transparent')
+        return hex;
+    const h = p.hex.slice(1); // remove #
+    const r = parseInt(h.slice(0, 2), 16);
+    const g = parseInt(h.slice(2, 4), 16);
+    const b = parseInt(h.slice(4, 6), 16);
+    const factor = 1 - Math.max(0, Math.min(1, amount));
+    const r2 = Math.round(r * factor);
+    const g2 = Math.round(g * factor);
+    const b2 = Math.round(b * factor);
+    const toHex = (n) => n.toString(16).padStart(2, '0');
+    return `#${toHex(r2)}${toHex(g2)}${toHex(b2)}`;
+}
+//# sourceMappingURL=fill-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fill-tools.js","sourceRoot":"","sources":["../../../server/service/styling/fill-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * setFill — 컴포넌트 배경 (state.fillStyle) 변경.\n *\n * 4 modes 지원: none / solid / gradient / pattern.\n *\n * 출력 정책 — refid 당 1 op:\n *   - solid: fillStyle = '#rrggbb' or 'rgba(...)' (string)\n *   - gradient: fillStyle = { type:'gradient', gradientType, colorStops, rotation, ... }\n *   - pattern: fillStyle = { type:'pattern', image, ... }\n *   - none: fillStyle = { type:'none' }\n *   - mode 미지정 + color 만: 부분 update (string 또는 object 병합)\n *\n * things-scene 실제 데이터 형식 (drawer/fill.ts 검증):\n *   - gradient: { type, gradientType, colorStops: [{position, color}], rotation (라디안) }\n *   - rotation 은 라디안 — `Math.cos(fRotation)` 직접 사용\n *\n * 이전 2-op (null + new) 방식은 중간 null 상태가 onchange / 3D texture\n * 크래시 유발 → 제거. 정확한 colorStops 출력으로 stale 필드 문제는 자체 해결.\n */\nimport type { BoardEditOp } from '../types'\nimport { parseColor, normalizeColor, validateColor } from './color-utils'\n\nexport interface SetFillInput {\n  refids: number[]\n  mode?: 'none' | 'solid' | 'gradient' | 'pattern'\n  // solid\n  color?: string\n  // gradient\n  gradientType?: 'linear' | 'radial'\n  /** colorStops — things-scene 의 canonical 필드명 그대로. position 0..1, color hex/rgb/named. */\n  colorStops?: Array<{ color: string; position: number }>\n  /** 회전 — 입력은 degrees (사용자/AI 친화), 내부 변환 후 things-scene 의 라디안으로 저장. */\n  rotation?: number\n  // pattern (drawer/fill.ts:95~ 검증)\n  image?: string\n  /** pattern: 영역에 맞춰 비율 조정 (true) vs 원본 크기 사용 (false). */\n  fitPattern?: boolean\n  /** pattern: 반복 안 함 (true) — 1회만 그림. */\n  noRepeat?: boolean\n  /** pattern: 정렬. fitPattern=false 일 때만 적용. */\n  align?:\n    | 'center'\n    | 'left-top'\n    | 'left-bottom'\n    | 'right-top'\n    | 'right-bottom'\n    | 'left'\n    | 'right'\n    | 'top'\n    | 'bottom'\n  /** pattern: 영역 내 오프셋 (fitPattern=false 일 때). */\n  offsetX?: number\n  offsetY?: number\n  /** pattern: 패턴 크기 (기본은 이미지 원본 크기). */\n  patternWidth?: number\n  patternHeight?: number\n  // 공통\n  opacity?: number  // 0..1\n}\n\nexport interface SetFillResult {\n  ops: BoardEditOp[]\n  errors: string[]  // refid 별 에러 (성공한 것은 op 만 발사)\n}\n\n/**\n * setFill 입력 검증 + BoardEditOp[] 생성.\n *\n * 기본 정책:\n *   - refids 비어있거나 mode 도 색도 없으면 에러\n *   - 색상 입력은 normalizeColor 통과해야 적용\n *   - mode='gradient' 인데 stops 없으면 자동 생성 (color → 어두운 변형)\n */\nexport function buildSetFillOps(input: SetFillInput): SetFillResult {\n  const errors: string[] = []\n  const ops: BoardEditOp[] = []\n\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) {\n    return { ops: [], errors: ['No valid numeric refids in input'] }\n  }\n\n  // mode 미지정 + 어떤 styling 인자도 없으면 무의미\n  if (\n    !input.mode &&\n    !input.color &&\n    !input.colorStops &&\n    !input.image &&\n    typeof input.opacity !== 'number'\n  ) {\n    return {\n      ops: [],\n      errors: ['No fill changes specified. Provide mode and/or color/opacity/etc.']\n    }\n  }\n\n  // 색상 검증\n  if (input.color !== undefined) {\n    const v = validateColor(input.color)\n    if (!v.valid) {\n      errors.push(v.error ?? `Invalid color: ${input.color}`)\n      return { ops: [], errors }\n    }\n  }\n\n  // gradient stops 검증\n  if (input.colorStops) {\n    for (const s of input.colorStops) {\n      if (typeof s.position !== 'number' || s.position < 0 || s.position > 1) {\n        errors.push(`Gradient stop position out of [0,1]: ${s.position}`)\n        return { ops: [], errors }\n      }\n      const v = validateColor(s.color)\n      if (!v.valid) {\n        errors.push(`Invalid gradient stop color: ${s.color}`)\n        return { ops: [], errors }\n      }\n    }\n  }\n\n  // opacity 검증\n  if (typeof input.opacity === 'number') {\n    if (input.opacity < 0 || input.opacity > 1) {\n      errors.push(`Opacity out of [0,1]: ${input.opacity}`)\n      return { ops: [], errors }\n    }\n  }\n\n  // pattern — image 필수\n  if (input.mode === 'pattern' && !input.image) {\n    errors.push(`Mode 'pattern' requires 'image' (URL or asset ref)`)\n    return { ops: [], errors }\n  }\n\n  // 각 refid 별 patch 생성\n  const patch = buildFillPatch(input)\n  if (!patch) {\n    return { ops: [], errors: ['Failed to build fill patch'] }\n  }\n\n  // 단일 op — apply-patch 의 deep merge 가 자연스럽게 처리:\n  //   - 새 fillStyle 이 string (solid) → 기존 object 통째 replace (typeof 매칭 X)\n  //   - 새 fillStyle 이 object → 같은 key (colorStops 배열 등) 는 array replace 됨\n  //   - 기존 부가 필드 (rotation 등) 가 새 patch 에 없으면 유지 — partial update 의도\n  // 이전 2-op (null + new) 방식은 중간 null 상태가 onchange / 3D texture trigger 해\n  // 크래시 유발 → 제거. 정확한 colorStops 출력으로 stale 필드 문제 자체가 해결됐음.\n  for (const refid of refids) {\n    ops.push({ op: 'modify', refid, patch })\n  }\n  return { ops, errors }\n}\n\n/**\n * input → fillStyle patch 객체 생성.\n *\n * Mode 명시 시: fillStyle 통째 교체 → patch = { fillStyle: {...새 객체} }\n * Mode 미지정 시: 기존 fillStyle 위에 색/opacity 만 병합 → patch = { fillStyle: { ...덮어쓸 필드 } }\n *   (apply-patch 의 deep-merge 가 처리. fillStyle 이 객체라면.)\n *\n * mode='none' 의 경우 fillStyle 을 falsy 로 — 빈 객체 또는 type:'none' 명시.\n */\nfunction buildFillPatch(input: SetFillInput): { fillStyle: any } | null {\n  const { mode } = input\n\n  if (mode === 'none') {\n    // fillStyle 제거 의도 — null 시맨틱 활용 (apply-patch 가 키 자체를 delete).\n    // drawer/fill.ts: fillStyle 없으면 falsy → 채우지 않음.\n    return { fillStyle: null as any }\n  }\n\n  if (mode === 'solid') {\n    // things-scene drawer/fill.ts:17 — fillStyle 이 string 이면 그대로 색상.\n    // 객체 형식 {type:'solid', color} 은 인터페이스에만 있는 stale.\n    // opacity 는 색상에 alpha 채널로 embedding (rgba).\n    const color = input.color ? normalizeColor(input.color) : undefined\n    if (!color) return null\n    let fillStyle: string = color\n    if (typeof input.opacity === 'number' && input.opacity < 1) {\n      fillStyle = withAlpha(color, input.opacity)\n    }\n    return { fillStyle: fillStyle as any }\n  }\n\n  if (mode === 'gradient') {\n    let stops = input.colorStops\n    // stops 미지정 시 — color 와 자동 생성 어두운 변형 (간단한 fallback)\n    if ((!stops || stops.length === 0) && input.color) {\n      const hex = normalizeColor(input.color)\n      if (hex) {\n        stops = [\n          { color: hex, position: 0 },\n          { color: darken(hex, 0.4), position: 1 }\n        ]\n      }\n    }\n    if (!stops || stops.length < 2) {\n      // gradient 인데 stops 부족 — 호출자가 명시 안 하면 만들어 주지 않음\n      return null\n    }\n    // things-scene 의 실제 필드: colorStops [{position, color}]\n    const colorStops = stops\n      .map(s => ({ position: s.position, color: normalizeColor(s.color)! }))\n      .filter(s => !!s.color)\n    if (colorStops.length < 2) return null\n    // rotation: 항상 명시 — drawer/fill.ts 가 default 없이 fillStyle.rotation 을 직접\n    // Math.cos / Math.sin 에 넘기므로 undefined 면 NaN → createLinearGradient 크래시.\n    // AI/사용자는 degrees 로 표현, 내부에서 라디안 변환. 미지정 시 0 default.\n    const rotationRad =\n      typeof input.rotation === 'number' ? (input.rotation * Math.PI) / 180 : 0\n    const fs: any = {\n      type: 'gradient',\n      gradientType: input.gradientType ?? 'linear',\n      colorStops,\n      rotation: rotationRad\n    }\n    if (typeof input.opacity === 'number') fs.opacity = input.opacity\n    return { fillStyle: fs }\n  }\n\n  if (mode === 'pattern') {\n    if (!input.image) return null\n    // things-scene 의 실제 pattern fillStyle (drawer/fill.ts:95~)\n    const fs: any = { type: 'pattern', image: input.image }\n    if (input.color) {\n      const c = normalizeColor(input.color)\n      if (c) fs.color = c // 패턴 뒤 배경색 (drawer 가 사용)\n    }\n    if (input.fitPattern !== undefined) fs.fitPattern = input.fitPattern\n    if (input.noRepeat !== undefined) fs.noRepeat = input.noRepeat\n    if (input.align) fs.align = input.align\n    if (typeof input.offsetX === 'number') fs.offsetX = input.offsetX\n    if (typeof input.offsetY === 'number') fs.offsetY = input.offsetY\n    if (typeof input.patternWidth === 'number') fs.width = input.patternWidth\n    if (typeof input.patternHeight === 'number') fs.height = input.patternHeight\n    if (typeof input.opacity === 'number') fs.opacity = input.opacity\n    return { fillStyle: fs }\n  }\n\n  // mode 미지정 — 부분 update.\n  // things-scene 의 fillStyle 은 string (solid) 또는 object (gradient/pattern).\n  // 부분 update 에서 색만 들어오면 solid string 으로 통째 set (가장 흔한 케이스).\n  // (gradient 의 부분 update 는 mode='gradient' 명시 사용 — 모드 명시 시 full replace.)\n  if (input.color) {\n    const c = normalizeColor(input.color)\n    if (!c) return null\n    const fillStyle =\n      typeof input.opacity === 'number' && input.opacity < 1 ? withAlpha(c, input.opacity) : c\n    return { fillStyle: fillStyle as any }\n  }\n  // color 없이 opacity 만 — 부분 update 어려움 (string 인지 object 인지 모름).\n  // 명확한 의도가 있으면 mode 명시 권장. 일단 무동작 (null).\n  return null\n}\n\n/**\n * hex / 명명 색 + alpha (0..1) → rgba(r,g,b,a) 문자열.\n * Canvas API 의 fillStyle 은 rgba string 그대로 사용 가능.\n */\nfunction withAlpha(hexOrName: string, alpha: number): string {\n  // transparent\n  if (hexOrName === 'transparent') return 'rgba(0,0,0,0)'\n  // hex 예상 (#rrggbb)\n  if (hexOrName.startsWith('#') && hexOrName.length === 7) {\n    const r = parseInt(hexOrName.slice(1, 3), 16)\n    const g = parseInt(hexOrName.slice(3, 5), 16)\n    const b = parseInt(hexOrName.slice(5, 7), 16)\n    return `rgba(${r},${g},${b},${alpha})`\n  }\n  // 다른 형식이면 색을 그대로 두고 alpha 무시 (nullable 안전)\n  return hexOrName\n}\n\n/**\n * 단순 hex 색상 어둡게 — gradient 자동 생성 시 fallback 두 번째 stop 용.\n * lightness 기반 정확도 < HSL 변환이 정확하지만 의존성 줄이려 RGB linear blend 로 대체.\n */\nfunction darken(hex: string, amount: number): string {\n  const p = parseColor(hex)\n  if (!p || p.hex === 'transparent') return hex\n  const h = p.hex.slice(1) // remove #\n  const r = parseInt(h.slice(0, 2), 16)\n  const g = parseInt(h.slice(2, 4), 16)\n  const b = parseInt(h.slice(4, 6), 16)\n  const factor = 1 - Math.max(0, Math.min(1, amount))\n  const r2 = Math.round(r * factor)\n  const g2 = Math.round(g * factor)\n  const b2 = Math.round(b * factor)\n  const toHex = (n: number) => n.toString(16).padStart(2, '0')\n  return `#${toHex(r2)}${toHex(g2)}${toHex(b2)}`\n}\n"]}

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

@@ -0,0 +1,32 @@
+/**
+ * setMaterial / setShadowProperties — 3D PBR 재질 + 그림자 동작.
+ *
+ * Material3D (`things-scene/src/threed/material-3d.ts`) 와 1:1 매핑.
+ * preset 만 줘도 변경 가능 (resolveMaterial3d 가 default 위 override 적용).
+ */
+import type { BoardEditOp } from '../types';
+declare const MATERIAL_PRESETS: readonly ["default", "metal", "glass", "plastic", "wood", "ceramic", "rubber", "custom"];
+declare const SIDE_VALUES: readonly ["double", "front", "back"];
+export interface SetMaterialInput {
+    refids: number[];
+    preset?: typeof MATERIAL_PRESETS[number];
+    metalness?: number;
+    roughness?: number;
+    emissive?: string;
+    emissiveIntensity?: number;
+    opacity?: number;
+    envMapIntensity?: number;
+    side?: typeof SIDE_VALUES[number];
+}
+export interface SetShadowPropertiesInput {
+    refids: number[];
+    castShadow?: boolean;
+    receiveShadow?: boolean;
+}
+export interface OpsResult {
+    ops: BoardEditOp[];
+    errors: string[];
+}
+export declare function buildSetMaterialOps(input: SetMaterialInput): OpsResult;
+export declare function buildSetShadowPropertiesOps(input: SetShadowPropertiesInput): OpsResult;
+export {};

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

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSetMaterialOps = buildSetMaterialOps;
+exports.buildSetShadowPropertiesOps = buildSetShadowPropertiesOps;
+const color_utils_1 = require("./color-utils");
+const MATERIAL_PRESETS = ['default', 'metal', 'glass', 'plastic', 'wood', 'ceramic', 'rubber', 'custom'];
+const SIDE_VALUES = ['double', 'front', 'back'];
+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 = (0, color_utils_1.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 = (0, color_utils_1.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: [] };
+}
+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-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-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-server/service/styling/read-tools.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildComponentStyleSummary = buildComponentStyleSummary;
+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-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,gEA+BC;AA/BD,SAAgB,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-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;