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

package/dist-server/service/validation/board-model-schema.js

@@ -0,0 +1,409 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoardPatchSchema = exports.ComponentPatchSchema = exports.BoardModelSchema = exports.ComponentSchema = exports.MappingSchema = exports.Material3DSchema = exports.ShadowSchema = exports.FillStyleSchema = void 0;
+exports.validateBoardModel = validateBoardModel;
+exports.validateComponentPatch = validateComponentPatch;
+exports.validateComponent = validateComponent;
+exports.validateBoardPatch = validateBoardPatch;
+/**
+ * BoardModel zod schema — 영속 / patch 적용 boundary 에서 데이터 무결성 검증.
+ *
+ * 핵심 정책:
+ *   - things-scene 의 실제 drawer / setter 구현을 진실로 봄 (인터페이스 declaration X)
+ *   - Component schema 는 `.passthrough()` — 알려진 필드 검증 + 미지 필드 통과
+ *     (사용자 정의 / 데이터 바인딩 / 컴포넌트별 specific 속성 허용)
+ *   - 그러나 styling sub-objects (FillStyle / Shadow 등) 는 `.strict()` — unknown key
+ *     거부. stale 잔재 필드 (예: colorStops + colors 공존) 자동 발견.
+ *   - validation 실패 시 silent 누락 X — caller 가 명시적 에러 / 로그
+ *
+ * 적용 지점:
+ *   1. server `UpdateBoard` mutation 진입 → DB 영속 직전 마지막 방어선
+ *   2. server `BoardAIChat` mutation 응답 직전 — AI 가 만든 patch 의 안전성
+ *   3. (선택) client apply-patch 적용 후 — 메모리 상태 무결성
+ */
+const zod_1 = require("zod");
+// ── Color ────────────────────────────────────────────────────────
+/**
+ * 색상 — hex (#rgb / #rgba / #rrggbb / #rrggbbaa) / rgb / rgba / CSS named / 'transparent'.
+ * 정규식은 느슨 — 정확한 검증은 normalizeColor 가, 여기선 형식만.
+ */
+const ColorSchema = zod_1.z.string().min(1).max(50);
+// ── FillStyle (state.fillStyle) ──────────────────────────────────
+//
+// 실제 형식 (drawer/fill.ts 검증):
+//   - solid: 색상 string 그대로
+//   - gradient: { type: 'gradient', gradientType, colorStops: [{position, color}], rotation?, opacity? }
+//   - pattern:  { type: 'pattern', image, ...옵션들 }
+//   - none: undefined / null
+const GradientStopSchema = zod_1.z
+    .object({
+    position: zod_1.z.number().min(0).max(1),
+    color: ColorSchema
+})
+    .strict();
+const FillStyleGradientSchema = zod_1.z
+    .object({
+    type: zod_1.z.literal('gradient'),
+    gradientType: zod_1.z.enum(['linear', 'radial']).optional(),
+    colorStops: zod_1.z.array(GradientStopSchema).min(2),
+    rotation: zod_1.z.number().optional(),
+    opacity: zod_1.z.number().min(0).max(1).optional(),
+    center: zod_1.z
+        .enum([
+        'center',
+        'left-top',
+        'left-bottom',
+        'right-top',
+        'right-bottom',
+        'left',
+        'right',
+        'top',
+        'bottom'
+    ])
+        .optional()
+})
+    .strict();
+const FillStylePatternSchema = zod_1.z
+    .object({
+    type: zod_1.z.literal('pattern'),
+    image: zod_1.z.union([zod_1.z.string(), zod_1.z.unknown()]),
+    color: ColorSchema.optional(),
+    fitPattern: zod_1.z.boolean().optional(),
+    noRepeat: zod_1.z.boolean().optional(),
+    align: zod_1.z
+        .enum([
+        'center',
+        'left-top',
+        'left-bottom',
+        'right-top',
+        'right-bottom',
+        'left',
+        'right',
+        'top',
+        'bottom'
+    ])
+        .optional(),
+    offsetX: zod_1.z.number().optional(),
+    offsetY: zod_1.z.number().optional(),
+    width: zod_1.z.number().optional(),
+    height: zod_1.z.number().optional(),
+    opacity: zod_1.z.number().min(0).max(1).optional(),
+    guideOnly: zod_1.z.boolean().optional()
+})
+    .strict();
+/** 'none' type — fillStyle 제거 의도 표현 (state.fillStyle = {type:'none'} 도 허용). */
+const FillStyleNoneSchema = zod_1.z.object({ type: zod_1.z.literal('none') }).strict();
+exports.FillStyleSchema = zod_1.z.union([
+    ColorSchema, // solid: '#xxx'
+    FillStyleGradientSchema,
+    FillStylePatternSchema,
+    FillStyleNoneSchema,
+    zod_1.z.null()
+]);
+// ── Shadow (state.shadow) ────────────────────────────────────────
+//
+// Canonical (CSS box-shadow / Canvas API 표준): { color, offsetX, offsetY, blur }
+// Backwards-compat aliases (옛 이름, drawer 가 fallback 으로 읽음): left / top / blurSize.
+// 영속된 옛 데이터 호환을 위해 두 이름 다 schema 통과 — 새 코드는 canonical 사용.
+exports.ShadowSchema = zod_1.z
+    .object({
+    color: ColorSchema.optional(),
+    // canonical (CSS / Canvas 표준)
+    offsetX: zod_1.z.number().optional(),
+    offsetY: zod_1.z.number().optional(),
+    blur: zod_1.z.number().min(0).optional(),
+    // legacy aliases — 옛 things-scene 데이터 호환용. 새 코드는 위 canonical 사용.
+    left: zod_1.z.number().optional(),
+    top: zod_1.z.number().optional(),
+    blurSize: zod_1.z.number().min(0).optional()
+})
+    .strict();
+// ── Material3D (state.material3d) ────────────────────────────────
+//
+// `things-scene/src/threed/material-3d.ts` 의 Material3D 인터페이스와 일치.
+exports.Material3DSchema = zod_1.z
+    .object({
+    preset: zod_1.z
+        .enum(['default', 'metal', 'glass', 'plastic', 'wood', 'ceramic', 'rubber', 'custom'])
+        .optional(),
+    metalness: zod_1.z.number().min(0).max(1).optional(),
+    roughness: zod_1.z.number().min(0).max(1).optional(),
+    emissive: ColorSchema.optional(),
+    emissiveIntensity: zod_1.z.number().min(0).max(5).optional(),
+    opacity: zod_1.z.number().min(0).max(1).optional(),
+    envMapIntensity: zod_1.z.number().min(0).max(3).optional(),
+    side: zod_1.z.enum(['double', 'front', 'back']).optional(),
+    castShadow: zod_1.z.boolean().optional(),
+    receiveShadow: zod_1.z.boolean().optional()
+})
+    .strict();
+// ── DataMapping (state.mappings) ─────────────────────────────────
+//
+// 데이터 바인딩 — `interfaces/data.ts` Mapping. rule / target / accessor / converter / param.
+exports.MappingSchema = zod_1.z
+    .object({
+    rule: zod_1.z.string().optional(),
+    target: zod_1.z.string(),
+    property: zod_1.z.string().optional(),
+    accessor: zod_1.z.string().optional(),
+    source: zod_1.z.unknown().optional(),
+    converter: zod_1.z.union([zod_1.z.string(), zod_1.z.unknown()]).optional(),
+    param: zod_1.z.unknown().optional()
+})
+    .passthrough(); // mapping 의 자유 필드 (converter args 등) 허용
+// ── Component (one component in board.components) ────────────────
+//
+// 핵심 styling 필드는 명시 검증, 나머지는 passthrough — 컴포넌트별 specific 속성 자유.
+const LineDashSchema = zod_1.z.enum([
+    'solid',
+    'round-dot',
+    'square-dot',
+    'dash',
+    'dash-dot',
+    'long-dash',
+    'long-dash-dot',
+    'long-dash-dot-dot'
+]);
+/**
+ * 컴포넌트가 *어떤 형태든* 유효한 geometry 를 가졌는지 확인.
+ *
+ * things-scene 의 컴포넌트 type 별로 geometry 필드가 다양함 (rect 는 box,
+ * line 은 endpoints, polyline 은 vertices/path 등). type → 필드 매핑을 strict
+ * 하게 enumerate 하면 신규 type 등록 시 schema 도 동시 업데이트 필요 → forward
+ * compatibility 손해.
+ *
+ * 대신 "최소한 어떤 geometry 형식이라도 있어야 한다" 는 약한 보장 — 빈 컴포넌트
+ * (`{type:'rect'}` 만) 또는 type 에 안 맞는 geometry 구성 (`{type:'rect', cx:10, cy:20}`)
+ * 같은 명백한 오류만 차단. 실제 렌더링 정합성은 things-scene 자체가 검증.
+ */
+function componentHasValidGeometry(component) {
+    if (!component || typeof component !== 'object')
+        return false;
+    // Box geometry — left/top 둘 다 있어야 (width/height 는 optional)
+    const hasBox = typeof component.left === 'number' && typeof component.top === 'number';
+    // Circle/ellipse geometry — cx/cy 둘 다 있어야
+    const hasCircle = typeof component.cx === 'number' && typeof component.cy === 'number';
+    // Line endpoints
+    const hasLineEndpoints = typeof component.x1 === 'number' &&
+        typeof component.y1 === 'number' &&
+        typeof component.x2 === 'number' &&
+        typeof component.y2 === 'number';
+    // Path / points / vertices 계열
+    const hasPath = typeof component.path === 'string' || Array.isArray(component.path);
+    const hasPoints = Array.isArray(component.points) && component.points.length > 0;
+    const hasVertices = (Array.isArray(component.vertices) && component.vertices.length > 0) ||
+        (Array.isArray(component.verticles) && component.verticles.length > 0); // legacy 오타
+    // line connector — startPoint / endPoint 형태 (anchor 기반 line)
+    const hasConnector = component.from && typeof component.from === 'object' &&
+        component.to && typeof component.to === 'object';
+    return hasBox || hasCircle || hasLineEndpoints || hasPath || hasPoints || hasVertices || hasConnector;
+}
+/** type 이 'gauge' 또는 'gauge-*' 면 value 필드 필요 (선택: min/max). */
+function isGaugeType(type) {
+    return type === 'gauge' || type.startsWith('gauge-');
+}
+/** type 이 'chart' 또는 'chart-*' 면 data 필드 필요. */
+function isChartType(type) {
+    return type === 'chart' || type.startsWith('chart-');
+}
+const ComponentBaseSchema = zod_1.z
+    .object({
+    type: zod_1.z.string().min(1),
+    refid: zod_1.z.number().int().optional(), // 신규 컴포넌트 추가 시점엔 미할당 가능
+    // 위치 / 크기 — 컴포넌트 타입에 따라 다름. 본 schema 는 optional 로 두고
+    // refinement 가 *어떤 형태든* 있는지만 검사.
+    left: zod_1.z.number().optional(),
+    top: zod_1.z.number().optional(),
+    width: zod_1.z.number().optional(),
+    height: zod_1.z.number().optional(),
+    cx: zod_1.z.number().optional(),
+    cy: zod_1.z.number().optional(),
+    rx: zod_1.z.number().optional(),
+    ry: zod_1.z.number().optional(),
+    radius: zod_1.z.number().optional(),
+    x1: zod_1.z.number().optional(),
+    y1: zod_1.z.number().optional(),
+    x2: zod_1.z.number().optional(),
+    y2: zod_1.z.number().optional(),
+    rotation: zod_1.z.number().optional(),
+    // styling
+    fillStyle: exports.FillStyleSchema.optional(),
+    strokeStyle: ColorSchema.optional(), // top-level string
+    lineWidth: zod_1.z.number().min(0).optional(),
+    lineDash: LineDashSchema.optional(),
+    lineCap: zod_1.z.enum(['butt', 'round', 'square']).optional(),
+    lineJoin: zod_1.z.enum(['miter', 'round', 'bevel']).optional(),
+    shadow: exports.ShadowSchema.optional(),
+    material3d: exports.Material3DSchema.optional(),
+    // text / font — top-level
+    text: zod_1.z.string().optional(),
+    fontFamily: zod_1.z.string().optional(),
+    fontSize: zod_1.z.number().positive().optional(),
+    fontWeight: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
+    fontStyle: zod_1.z.string().optional(),
+    fontColor: ColorSchema.optional(),
+    textAlign: zod_1.z.enum(['left', 'center', 'right', 'start', 'end', 'justify']).optional(),
+    textBaseline: zod_1.z
+        .enum(['top', 'middle', 'bottom', 'hanging', 'alphabetic', 'ideographic'])
+        .optional(),
+    lineHeight: zod_1.z.number().positive().optional(),
+    // visibility / opacity
+    alpha: zod_1.z.number().min(0).max(1).optional(),
+    hidden: zod_1.z.boolean().optional(),
+    // misc — 검증 안 함
+    id: zod_1.z.string().optional(),
+    class: zod_1.z.string().optional(),
+    tag: zod_1.z.string().optional(),
+    // 데이터 바인딩
+    mappings: zod_1.z.array(exports.MappingSchema).optional()
+})
+    .passthrough(); // 컴포넌트별 specific 속성 (vehicle wheels, gauge needle, points/path 등) 허용
+/**
+ * Component schema — base 위에 type-aware refinement 두 가지:
+ *
+ *   1. 모든 컴포넌트는 *어떤 형태든* 유효한 geometry 가 있어야
+ *      (left+top / cx+cy / x1y1x2y2 / path / points / vertices / from+to)
+ *   2. gauge-* type 은 value 필요, chart-* type 은 data 필요 (soft check —
+ *      일부 prefab 이 미리 채워주는 케이스도 있어 strict 거부보다 미리 잡기 목적)
+ *
+ * 이 refinement 들이 LLM 의 잘못된 geometry (rect 에 cx/cy만, line 에 left/top만)
+ * 를 영속 직전 차단.
+ */
+exports.ComponentSchema = ComponentBaseSchema.superRefine((component, ctx) => {
+    if (!componentHasValidGeometry(component)) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: `Component '${component.type}' has no valid geometry — provide left+top (box), cx+cy (circle/ellipse), x1+y1+x2+y2 (line), path / points / vertices, or from+to (connector).`
+        });
+    }
+    if (isGaugeType(component.type) && component.value === undefined) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['value'],
+            message: `Component '${component.type}' requires 'value' (current sensor reading or display number).`
+        });
+    }
+    if (isChartType(component.type) && component.data === undefined) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['data'],
+            message: `Component '${component.type}' requires 'data' (chart datapoints array or object).`
+        });
+    }
+});
+// ── BoardModel (top-level) ───────────────────────────────────────
+/**
+ * BoardModel — things-scene 의 model-layer (보드 root).
+ *
+ * 인식되는 root 속성 (model-layer 의 NATURE.properties + 실제 코드에서 state.* 로
+ * 참조되는 키):
+ *   • Layout: width, height, fitMode, translate, scale
+ *   • 2D 배경: fillStyle
+ *   • 3D Sky: sky, skyColor
+ *   • 3D Tone: exposure
+ *   • 3D Hemisphere: hemiSkyColor, hemiGroundColor, hemiIntensity
+ *   • 3D Directional light: dirLightEnabled, dirLightColor, dirLightIntensity,
+ *                           dirLightFollowCamera, dirLightAzimuth, dirLightElevation
+ *   • 3D Shadow: dirShadowEnabled, dirShadowMapSize, dirShadowBias
+ *   • 3D Camera: cameraX, cameraY, cameraZ, cameraAutoPlay, autoRotate, initialCameraView
+ *   • 식별: id, refid, type
+ *
+ * ⚠ `name` 은 things-scene model-layer 가 인식 안 함 — Board *엔티티* 의 컬럼이지
+ * scene MODEL 의 필드가 아님. AI 가 modifyBoard 로 name 을 보내도 죽은 필드. 검증
+ * 시에도 제거 / 무시 정책.
+ *
+ * `passthrough` 인 이유 — 3D 광원/카메라/sky 등 키가 너무 많아 strict 로는 회귀 위험
+ * 큼. 대신 패키지 외부 (operato 등) 가 임의 root 키 추가하는 걸 막지 않음.
+ */
+exports.BoardModelSchema = zod_1.z
+    .object({
+    width: zod_1.z.number().positive(),
+    height: zod_1.z.number().positive(),
+    fillStyle: exports.FillStyleSchema.optional(), // 보드 배경
+    components: zod_1.z.array(exports.ComponentSchema).optional()
+})
+    .passthrough(); // 보드 레벨 자유 필드 (3D atmosphere / sky / camera 등)
+// ── Patch op schemas — modify op 의 patch 가 invalid 이면 거부 ───
+/**
+ * modify op 의 patch — 컴포넌트 partial. 모든 필드 optional. styling sub-object
+ * 만 strict 하게 검증해 stale key 잔존 차단.
+ */
+exports.ComponentPatchSchema = zod_1.z
+    .object({
+    fillStyle: exports.FillStyleSchema.nullable().optional(),
+    strokeStyle: ColorSchema.nullable().optional(),
+    lineWidth: zod_1.z.number().min(0).optional(),
+    lineDash: LineDashSchema.optional(),
+    lineCap: zod_1.z.enum(['butt', 'round', 'square']).optional(),
+    lineJoin: zod_1.z.enum(['miter', 'round', 'bevel']).optional(),
+    shadow: exports.ShadowSchema.nullable().optional(),
+    material3d: exports.Material3DSchema.nullable().optional(),
+    text: zod_1.z.string().optional(),
+    fontFamily: zod_1.z.string().optional(),
+    fontSize: zod_1.z.number().positive().optional(),
+    fontWeight: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
+    fontStyle: zod_1.z.string().optional(),
+    fontColor: ColorSchema.optional(),
+    textAlign: zod_1.z.enum(['left', 'center', 'right', 'start', 'end', 'justify']).optional(),
+    textBaseline: zod_1.z
+        .enum(['top', 'middle', 'bottom', 'hanging', 'alphabetic', 'ideographic'])
+        .optional(),
+    lineHeight: zod_1.z.number().positive().optional(),
+    alpha: zod_1.z.number().min(0).max(1).optional(),
+    hidden: zod_1.z.boolean().optional()
+})
+    .passthrough(); // 위치 / 크기 / 컴포넌트 specific 통과
+/**
+ * modifyBoard op 의 patch — 보드 root partial.
+ *
+ * 모든 root 필드 optional (BoardModelSchema 와 달리 width/height 도 optional).
+ * passthrough 로 알려지지 않은 root 키 (3D atmosphere, sky, camera 등) 통과.
+ * 다만 *알려진 nested object* (fillStyle 등) 는 strict schema 재사용 — 그 안에
+ * unknown key 가 들어오면 거부 (예: fillStyle 안 gradientStops 같은 stale 이름).
+ *
+ * AI 가 setFill 등에서 학습한 vocabulary 를 modifyBoard 로 echo 시킬 때 stale
+ * key 가 fillStyle / shadow 같은 sub-object 안에 끼면 본 schema 가 catch.
+ */
+exports.BoardPatchSchema = zod_1.z
+    .object({
+    width: zod_1.z.number().positive().optional(),
+    height: zod_1.z.number().positive().optional(),
+    fillStyle: exports.FillStyleSchema.nullable().optional(),
+    components: zod_1.z.array(exports.ComponentSchema).optional()
+})
+    .passthrough(); // root 의 자유 필드 (sky / exposure / hemi*/ dirLight* / camera* 등)
+function formatIssues(error) {
+    return error.issues.map(issue => ({
+        path: issue.path.join('.'),
+        message: issue.message
+    }));
+}
+/** BoardModel 전체 검증. 영속 / 로드 시 사용. */
+function validateBoardModel(model) {
+    const r = exports.BoardModelSchema.safeParse(model);
+    if (r.success)
+        return { valid: true };
+    return { valid: false, errors: formatIssues(r.error) };
+}
+/** modify patch 검증. AI 가 만든 patch 가 styling spec 에 맞는지. */
+function validateComponentPatch(patch) {
+    const r = exports.ComponentPatchSchema.safeParse(patch);
+    if (r.success)
+        return { valid: true };
+    return { valid: false, errors: formatIssues(r.error) };
+}
+/** 한 컴포넌트 검증. addComponent 시 사용. */
+function validateComponent(component) {
+    const r = exports.ComponentSchema.safeParse(component);
+    if (r.success)
+        return { valid: true };
+    return { valid: false, errors: formatIssues(r.error) };
+}
+/** modifyBoard op 의 patch 검증. 보드 root partial. */
+function validateBoardPatch(patch) {
+    const r = exports.BoardPatchSchema.safeParse(patch);
+    if (r.success)
+        return { valid: true };
+    return { valid: false, errors: formatIssues(r.error) };
+}
+//# sourceMappingURL=board-model-schema.js.map

package/dist-server/service/validation/board-model-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-model-schema.js","sourceRoot":"","sources":["../../../server/service/validation/board-model-schema.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * BoardModel zod schema — 영속 / patch 적용 boundary 에서 데이터 무결성 검증.\n *\n * 핵심 정책:\n *   - things-scene 의 실제 drawer / setter 구현을 진실로 봄 (인터페이스 declaration X)\n *   - Component schema 는 `.passthrough()` — 알려진 필드 검증 + 미지 필드 통과\n *     (사용자 정의 / 데이터 바인딩 / 컴포넌트별 specific 속성 허용)\n *   - 그러나 styling sub-objects (FillStyle / Shadow 등) 는 `.strict()` — unknown key\n *     거부. stale 잔재 필드 (예: colorStops + colors 공존) 자동 발견.\n *   - validation 실패 시 silent 누락 X — caller 가 명시적 에러 / 로그\n *\n * 적용 지점:\n *   1. server `UpdateBoard` mutation 진입 → DB 영속 직전 마지막 방어선\n *   2. server `BoardAIChat` mutation 응답 직전 — AI 가 만든 patch 의 안전성\n *   3. (선택) client apply-patch 적용 후 — 메모리 상태 무결성\n */\nimport { z } from 'zod'\n\n// ── Color ────────────────────────────────────────────────────────\n\n/**\n * 색상 — hex (#rgb / #rgba / #rrggbb / #rrggbbaa) / rgb / rgba / CSS named / 'transparent'.\n * 정규식은 느슨 — 정확한 검증은 normalizeColor 가, 여기선 형식만.\n */\nconst ColorSchema = z.string().min(1).max(50)\n\n// ── FillStyle (state.fillStyle) ──────────────────────────────────\n//\n// 실제 형식 (drawer/fill.ts 검증):\n//   - solid: 색상 string 그대로\n//   - gradient: { type: 'gradient', gradientType, colorStops: [{position, color}], rotation?, opacity? }\n//   - pattern:  { type: 'pattern', image, ...옵션들 }\n//   - none: undefined / null\n\nconst GradientStopSchema = z\n  .object({\n    position: z.number().min(0).max(1),\n    color: ColorSchema\n  })\n  .strict()\n\nconst FillStyleGradientSchema = z\n  .object({\n    type: z.literal('gradient'),\n    gradientType: z.enum(['linear', 'radial']).optional(),\n    colorStops: z.array(GradientStopSchema).min(2),\n    rotation: z.number().optional(),\n    opacity: z.number().min(0).max(1).optional(),\n    center: z\n      .enum([\n        'center',\n        'left-top',\n        'left-bottom',\n        'right-top',\n        'right-bottom',\n        'left',\n        'right',\n        'top',\n        'bottom'\n      ])\n      .optional()\n  })\n  .strict()\n\nconst FillStylePatternSchema = z\n  .object({\n    type: z.literal('pattern'),\n    image: z.union([z.string(), z.unknown()]),\n    color: ColorSchema.optional(),\n    fitPattern: z.boolean().optional(),\n    noRepeat: z.boolean().optional(),\n    align: z\n      .enum([\n        'center',\n        'left-top',\n        'left-bottom',\n        'right-top',\n        'right-bottom',\n        'left',\n        'right',\n        'top',\n        'bottom'\n      ])\n      .optional(),\n    offsetX: z.number().optional(),\n    offsetY: z.number().optional(),\n    width: z.number().optional(),\n    height: z.number().optional(),\n    opacity: z.number().min(0).max(1).optional(),\n    guideOnly: z.boolean().optional()\n  })\n  .strict()\n\n/** 'none' type — fillStyle 제거 의도 표현 (state.fillStyle = {type:'none'} 도 허용). */\nconst FillStyleNoneSchema = z.object({ type: z.literal('none') }).strict()\n\nexport const FillStyleSchema = z.union([\n  ColorSchema, // solid: '#xxx'\n  FillStyleGradientSchema,\n  FillStylePatternSchema,\n  FillStyleNoneSchema,\n  z.null()\n])\n\n// ── Shadow (state.shadow) ────────────────────────────────────────\n//\n// Canonical (CSS box-shadow / Canvas API 표준): { color, offsetX, offsetY, blur }\n// Backwards-compat aliases (옛 이름, drawer 가 fallback 으로 읽음): left / top / blurSize.\n// 영속된 옛 데이터 호환을 위해 두 이름 다 schema 통과 — 새 코드는 canonical 사용.\n\nexport const ShadowSchema = z\n  .object({\n    color: ColorSchema.optional(),\n    // canonical (CSS / Canvas 표준)\n    offsetX: z.number().optional(),\n    offsetY: z.number().optional(),\n    blur: z.number().min(0).optional(),\n    // legacy aliases — 옛 things-scene 데이터 호환용. 새 코드는 위 canonical 사용.\n    left: z.number().optional(),\n    top: z.number().optional(),\n    blurSize: z.number().min(0).optional()\n  })\n  .strict()\n\n// ── Material3D (state.material3d) ────────────────────────────────\n//\n// `things-scene/src/threed/material-3d.ts` 의 Material3D 인터페이스와 일치.\n\nexport const Material3DSchema = z\n  .object({\n    preset: z\n      .enum(['default', 'metal', 'glass', 'plastic', 'wood', 'ceramic', 'rubber', 'custom'])\n      .optional(),\n    metalness: z.number().min(0).max(1).optional(),\n    roughness: z.number().min(0).max(1).optional(),\n    emissive: ColorSchema.optional(),\n    emissiveIntensity: z.number().min(0).max(5).optional(),\n    opacity: z.number().min(0).max(1).optional(),\n    envMapIntensity: z.number().min(0).max(3).optional(),\n    side: z.enum(['double', 'front', 'back']).optional(),\n    castShadow: z.boolean().optional(),\n    receiveShadow: z.boolean().optional()\n  })\n  .strict()\n\n// ── DataMapping (state.mappings) ─────────────────────────────────\n//\n// 데이터 바인딩 — `interfaces/data.ts` Mapping. rule / target / accessor / converter / param.\n\nexport const MappingSchema = z\n  .object({\n    rule: z.string().optional(),\n    target: z.string(),\n    property: z.string().optional(),\n    accessor: z.string().optional(),\n    source: z.unknown().optional(),\n    converter: z.union([z.string(), z.unknown()]).optional(),\n    param: z.unknown().optional()\n  })\n  .passthrough() // mapping 의 자유 필드 (converter args 등) 허용\n\n// ── Component (one component in board.components) ────────────────\n//\n// 핵심 styling 필드는 명시 검증, 나머지는 passthrough — 컴포넌트별 specific 속성 자유.\n\nconst LineDashSchema = z.enum([\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/**\n * 컴포넌트가 *어떤 형태든* 유효한 geometry 를 가졌는지 확인.\n *\n * things-scene 의 컴포넌트 type 별로 geometry 필드가 다양함 (rect 는 box,\n * line 은 endpoints, polyline 은 vertices/path 등). type → 필드 매핑을 strict\n * 하게 enumerate 하면 신규 type 등록 시 schema 도 동시 업데이트 필요 → forward\n * compatibility 손해.\n *\n * 대신 \"최소한 어떤 geometry 형식이라도 있어야 한다\" 는 약한 보장 — 빈 컴포넌트\n * (`{type:'rect'}` 만) 또는 type 에 안 맞는 geometry 구성 (`{type:'rect', cx:10, cy:20}`)\n * 같은 명백한 오류만 차단. 실제 렌더링 정합성은 things-scene 자체가 검증.\n */\nfunction componentHasValidGeometry(component: any): boolean {\n  if (!component || typeof component !== 'object') return false\n\n  // Box geometry — left/top 둘 다 있어야 (width/height 는 optional)\n  const hasBox = typeof component.left === 'number' && typeof component.top === 'number'\n\n  // Circle/ellipse geometry — cx/cy 둘 다 있어야\n  const hasCircle = typeof component.cx === 'number' && typeof component.cy === 'number'\n\n  // Line endpoints\n  const hasLineEndpoints =\n    typeof component.x1 === 'number' &&\n    typeof component.y1 === 'number' &&\n    typeof component.x2 === 'number' &&\n    typeof component.y2 === 'number'\n\n  // Path / points / vertices 계열\n  const hasPath = typeof component.path === 'string' || Array.isArray(component.path)\n  const hasPoints = Array.isArray(component.points) && component.points.length > 0\n  const hasVertices =\n    (Array.isArray(component.vertices) && component.vertices.length > 0) ||\n    (Array.isArray(component.verticles) && component.verticles.length > 0)  // legacy 오타\n\n  // line connector — startPoint / endPoint 형태 (anchor 기반 line)\n  const hasConnector =\n    component.from && typeof component.from === 'object' &&\n    component.to && typeof component.to === 'object'\n\n  return hasBox || hasCircle || hasLineEndpoints || hasPath || hasPoints || hasVertices || hasConnector\n}\n\n/** type 이 'gauge' 또는 'gauge-*' 면 value 필드 필요 (선택: min/max). */\nfunction isGaugeType(type: string): boolean {\n  return type === 'gauge' || type.startsWith('gauge-')\n}\n\n/** type 이 'chart' 또는 'chart-*' 면 data 필드 필요. */\nfunction isChartType(type: string): boolean {\n  return type === 'chart' || type.startsWith('chart-')\n}\n\nconst ComponentBaseSchema = z\n  .object({\n    type: z.string().min(1),\n    refid: z.number().int().optional(), // 신규 컴포넌트 추가 시점엔 미할당 가능\n    // 위치 / 크기 — 컴포넌트 타입에 따라 다름. 본 schema 는 optional 로 두고\n    // refinement 가 *어떤 형태든* 있는지만 검사.\n    left: z.number().optional(),\n    top: z.number().optional(),\n    width: z.number().optional(),\n    height: z.number().optional(),\n    cx: z.number().optional(),\n    cy: z.number().optional(),\n    rx: z.number().optional(),\n    ry: z.number().optional(),\n    radius: z.number().optional(),\n    x1: z.number().optional(),\n    y1: z.number().optional(),\n    x2: z.number().optional(),\n    y2: z.number().optional(),\n    rotation: z.number().optional(),\n    // styling\n    fillStyle: FillStyleSchema.optional(),\n    strokeStyle: ColorSchema.optional(), // top-level string\n    lineWidth: z.number().min(0).optional(),\n    lineDash: LineDashSchema.optional(),\n    lineCap: z.enum(['butt', 'round', 'square']).optional(),\n    lineJoin: z.enum(['miter', 'round', 'bevel']).optional(),\n    shadow: ShadowSchema.optional(),\n    material3d: Material3DSchema.optional(),\n    // text / font — top-level\n    text: z.string().optional(),\n    fontFamily: z.string().optional(),\n    fontSize: z.number().positive().optional(),\n    fontWeight: z.union([z.string(), z.number()]).optional(),\n    fontStyle: z.string().optional(),\n    fontColor: ColorSchema.optional(),\n    textAlign: z.enum(['left', 'center', 'right', 'start', 'end', 'justify']).optional(),\n    textBaseline: z\n      .enum(['top', 'middle', 'bottom', 'hanging', 'alphabetic', 'ideographic'])\n      .optional(),\n    lineHeight: z.number().positive().optional(),\n    // visibility / opacity\n    alpha: z.number().min(0).max(1).optional(),\n    hidden: z.boolean().optional(),\n    // misc — 검증 안 함\n    id: z.string().optional(),\n    class: z.string().optional(),\n    tag: z.string().optional(),\n    // 데이터 바인딩\n    mappings: z.array(MappingSchema).optional()\n  })\n  .passthrough() // 컴포넌트별 specific 속성 (vehicle wheels, gauge needle, points/path 등) 허용\n\n/**\n * Component schema — base 위에 type-aware refinement 두 가지:\n *\n *   1. 모든 컴포넌트는 *어떤 형태든* 유효한 geometry 가 있어야\n *      (left+top / cx+cy / x1y1x2y2 / path / points / vertices / from+to)\n *   2. gauge-* type 은 value 필요, chart-* type 은 data 필요 (soft check —\n *      일부 prefab 이 미리 채워주는 케이스도 있어 strict 거부보다 미리 잡기 목적)\n *\n * 이 refinement 들이 LLM 의 잘못된 geometry (rect 에 cx/cy만, line 에 left/top만)\n * 를 영속 직전 차단.\n */\nexport const ComponentSchema = ComponentBaseSchema.superRefine((component, ctx) => {\n  if (!componentHasValidGeometry(component)) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      message:\n        `Component '${component.type}' has no valid geometry — provide left+top (box), cx+cy (circle/ellipse), x1+y1+x2+y2 (line), path / points / vertices, or from+to (connector).`\n    })\n  }\n\n  if (isGaugeType(component.type) && component.value === undefined) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: ['value'],\n      message: `Component '${component.type}' requires 'value' (current sensor reading or display number).`\n    })\n  }\n\n  if (isChartType(component.type) && component.data === undefined) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: ['data'],\n      message: `Component '${component.type}' requires 'data' (chart datapoints array or object).`\n    })\n  }\n})\n\n// ── BoardModel (top-level) ───────────────────────────────────────\n\n/**\n * BoardModel — things-scene 의 model-layer (보드 root).\n *\n * 인식되는 root 속성 (model-layer 의 NATURE.properties + 실제 코드에서 state.* 로\n * 참조되는 키):\n *   • Layout: width, height, fitMode, translate, scale\n *   • 2D 배경: fillStyle\n *   • 3D Sky: sky, skyColor\n *   • 3D Tone: exposure\n *   • 3D Hemisphere: hemiSkyColor, hemiGroundColor, hemiIntensity\n *   • 3D Directional light: dirLightEnabled, dirLightColor, dirLightIntensity,\n *                           dirLightFollowCamera, dirLightAzimuth, dirLightElevation\n *   • 3D Shadow: dirShadowEnabled, dirShadowMapSize, dirShadowBias\n *   • 3D Camera: cameraX, cameraY, cameraZ, cameraAutoPlay, autoRotate, initialCameraView\n *   • 식별: id, refid, type\n *\n * ⚠ `name` 은 things-scene model-layer 가 인식 안 함 — Board *엔티티* 의 컬럼이지\n * scene MODEL 의 필드가 아님. AI 가 modifyBoard 로 name 을 보내도 죽은 필드. 검증\n * 시에도 제거 / 무시 정책.\n *\n * `passthrough` 인 이유 — 3D 광원/카메라/sky 등 키가 너무 많아 strict 로는 회귀 위험\n * 큼. 대신 패키지 외부 (operato 등) 가 임의 root 키 추가하는 걸 막지 않음.\n */\nexport const BoardModelSchema = z\n  .object({\n    width: z.number().positive(),\n    height: z.number().positive(),\n    fillStyle: FillStyleSchema.optional(), // 보드 배경\n    components: z.array(ComponentSchema).optional()\n  })\n  .passthrough() // 보드 레벨 자유 필드 (3D atmosphere / sky / camera 등)\n\n// ── Patch op schemas — modify op 의 patch 가 invalid 이면 거부 ───\n\n/**\n * modify op 의 patch — 컴포넌트 partial. 모든 필드 optional. styling sub-object\n * 만 strict 하게 검증해 stale key 잔존 차단.\n */\nexport const ComponentPatchSchema = z\n  .object({\n    fillStyle: FillStyleSchema.nullable().optional(),\n    strokeStyle: ColorSchema.nullable().optional(),\n    lineWidth: z.number().min(0).optional(),\n    lineDash: LineDashSchema.optional(),\n    lineCap: z.enum(['butt', 'round', 'square']).optional(),\n    lineJoin: z.enum(['miter', 'round', 'bevel']).optional(),\n    shadow: ShadowSchema.nullable().optional(),\n    material3d: Material3DSchema.nullable().optional(),\n    text: z.string().optional(),\n    fontFamily: z.string().optional(),\n    fontSize: z.number().positive().optional(),\n    fontWeight: z.union([z.string(), z.number()]).optional(),\n    fontStyle: z.string().optional(),\n    fontColor: ColorSchema.optional(),\n    textAlign: z.enum(['left', 'center', 'right', 'start', 'end', 'justify']).optional(),\n    textBaseline: z\n      .enum(['top', 'middle', 'bottom', 'hanging', 'alphabetic', 'ideographic'])\n      .optional(),\n    lineHeight: z.number().positive().optional(),\n    alpha: z.number().min(0).max(1).optional(),\n    hidden: z.boolean().optional()\n  })\n  .passthrough() // 위치 / 크기 / 컴포넌트 specific 통과\n\n/**\n * modifyBoard op 의 patch — 보드 root partial.\n *\n * 모든 root 필드 optional (BoardModelSchema 와 달리 width/height 도 optional).\n * passthrough 로 알려지지 않은 root 키 (3D atmosphere, sky, camera 등) 통과.\n * 다만 *알려진 nested object* (fillStyle 등) 는 strict schema 재사용 — 그 안에\n * unknown key 가 들어오면 거부 (예: fillStyle 안 gradientStops 같은 stale 이름).\n *\n * AI 가 setFill 등에서 학습한 vocabulary 를 modifyBoard 로 echo 시킬 때 stale\n * key 가 fillStyle / shadow 같은 sub-object 안에 끼면 본 schema 가 catch.\n */\nexport const BoardPatchSchema = z\n  .object({\n    width: z.number().positive().optional(),\n    height: z.number().positive().optional(),\n    fillStyle: FillStyleSchema.nullable().optional(),\n    components: z.array(ComponentSchema).optional()\n  })\n  .passthrough() // root 의 자유 필드 (sky / exposure / hemi*/ dirLight* / camera* 등)\n\n// ── 검증 헬퍼 ────────────────────────────────────────────────────\n\nexport interface ValidationResult {\n  valid: boolean\n  errors?: Array<{ path: string; message: string }>\n}\n\nfunction formatIssues(error: z.ZodError): Array<{ path: string; message: string }> {\n  return error.issues.map(issue => ({\n    path: issue.path.join('.'),\n    message: issue.message\n  }))\n}\n\n/** BoardModel 전체 검증. 영속 / 로드 시 사용. */\nexport function validateBoardModel(model: unknown): ValidationResult {\n  const r = BoardModelSchema.safeParse(model)\n  if (r.success) return { valid: true }\n  return { valid: false, errors: formatIssues(r.error) }\n}\n\n/** modify patch 검증. AI 가 만든 patch 가 styling spec 에 맞는지. */\nexport function validateComponentPatch(patch: unknown): ValidationResult {\n  const r = ComponentPatchSchema.safeParse(patch)\n  if (r.success) return { valid: true }\n  return { valid: false, errors: formatIssues(r.error) }\n}\n\n/** 한 컴포넌트 검증. addComponent 시 사용. */\nexport function validateComponent(component: unknown): ValidationResult {\n  const r = ComponentSchema.safeParse(component)\n  if (r.success) return { valid: true }\n  return { valid: false, errors: formatIssues(r.error) }\n}\n\n/** modifyBoard op 의 patch 검증. 보드 root partial. */\nexport function validateBoardPatch(patch: unknown): ValidationResult {\n  const r = BoardPatchSchema.safeParse(patch)\n  if (r.success) return { valid: true }\n  return { valid: false, errors: formatIssues(r.error) }\n}\n"]}

package/dist-server/service/validation/tool-validation.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Write tool 의 사전 검증 — agentic loop 의 retry 메커니즘.
+ *
+ * 흐름:
+ *   1. LLM 이 write tool 호출
+ *   2. 본 함수가 args 검증 (styling tool 의 build* 함수 또는 schema 직접)
+ *   3. 실패 시 errors 반환 → caller 가 tool_result 에 error 메시지 담아 LLM 한테
+ *   4. LLM 다음 turn 에서 정정 후 재호출 (자기 회복)
+ *
+ * 이게 silent 데이터 손상을 막는 마지막 능동 방어선. 검증 통과한 args 만 누적
+ * → patch 로 변환되므로 깨진 데이터가 영속까지 못 감.
+ */
+import type { AIToolCall } from '@things-factory/ai-client-base';
+export interface ToolValidationResult {
+    /** 검증 통과 — 누적 진행 가능 */
+    valid: boolean;
+    /** 실패 시 LLM 한테 보일 에러 메시지 (자기 회복 정보 포함) */
+    errors?: string[];
+    /** LLM 한테 정정 가이드 — 가능한 경우 어떤 형식이 맞는지 */
+    suggestion?: string;
+}
+/**
+ * write tool 의 args 사전 검증.
+ *
+ * 정책:
+ *   - styling tool: 해당 build* 함수가 errors 반환 — 그대로 LLM 한테
+ *   - modifyComponentByRefid: ComponentPatchSchema 로 검증 (raw fallback 영역)
+ *   - addComponent: ComponentSchema 로 검증
+ *   - 그 외: 기존 dispatcher 의 자체 검증에 위임 (재시도 보장 X)
+ */
+export declare function validateWriteToolCall(tc: AIToolCall, components?: ReadonlyArray<any>): ToolValidationResult;