@flextudio/scenario 0.1.0

package/contract-data/schema/v1/design-system/tests/error-mapping.test.mjs

@@ -0,0 +1,244 @@
+// design-system/tests/error-mapping.test.mjs
+// 실행: node --test meta-contract/schema/v1/design-system/tests/error-mapping.test.mjs
+
+import { test } from "node:test";
+import assert from "node:assert/strict";
+
+import {
+  instancePathToDotted,
+  reverseMapInstancePath,
+  describeErrorPath,
+} from "../error-mapping.mjs";
+
+// ────────────────────────────────────────────────────────────────────────────
+// instancePathToDotted
+// ────────────────────────────────────────────────────────────────────────────
+
+test("instancePathToDotted: 기본 변환", () => {
+  assert.equal(
+    instancePathToDotted("/Steps/S1/Contents/0/FontStyle/FontColor"),
+    "Steps.S1.Contents[0].FontStyle.FontColor",
+  );
+});
+
+test("instancePathToDotted: 중첩 배열 인덱스", () => {
+  assert.equal(
+    instancePathToDotted("/Steps/S1/Contents/0/Contents/2"),
+    "Steps.S1.Contents[0].Contents[2]",
+  );
+});
+
+test("instancePathToDotted: 단일 세그먼트", () => {
+  assert.equal(instancePathToDotted("/Steps"), "Steps");
+});
+
+test("instancePathToDotted: 빈 / 루트", () => {
+  assert.equal(instancePathToDotted(""), "");
+  assert.equal(instancePathToDotted("/"), "");
+});
+
+test("instancePathToDotted: JSON Pointer escape (~0 ~1)", () => {
+  // ~0 = ~, ~1 = /  (RFC 6901)
+  assert.equal(instancePathToDotted("/a~1b/c~0d"), "a/b.c~d");
+});
+
+// ────────────────────────────────────────────────────────────────────────────
+// reverseMapInstancePath — exact leaf
+// ────────────────────────────────────────────────────────────────────────────
+
+test("reverseMap: 정확 leaf 매칭", () => {
+  const sm = {
+    "Steps.S1.Contents[0]": {
+      "FontStyle.FontColor": "$.design.color",
+      "Width": "$.design.w",
+    },
+  };
+  const r = reverseMapInstancePath(
+    "/Steps/S1/Contents/0/FontStyle/FontColor",
+    sm,
+  );
+  assert.equal(r.path, "Steps.S1.Contents[0].design.color");
+  assert.equal(r.originalPath, "/Steps/S1/Contents/0/FontStyle/FontColor");
+  assert.equal(r.designOrigin, true);
+  assert.equal(r.nodePath, "Steps.S1.Contents[0]");
+  assert.equal(r.leaf, "FontStyle.FontColor");
+});
+
+test("reverseMap: Width 같은 단일 키 매칭", () => {
+  const sm = {
+    "Steps.S1.Contents[0]": { Width: "$.design.w" },
+  };
+  const r = reverseMapInstancePath(
+    "/Steps/S1/Contents/0/Width/SizeValue",
+    sm,
+  );
+  // 정확 leaf "Width.SizeValue" 없으니 parent fallback "Width"
+  assert.equal(r.path, "Steps.S1.Contents[0].design.w");
+  assert.equal(r.leaf, "Width");
+});
+
+// ────────────────────────────────────────────────────────────────────────────
+// reverseMap — parent fallback
+// ────────────────────────────────────────────────────────────────────────────
+
+test("reverseMap: 부모 fallback — FontStyle.UseFont (파생 leaf) 는 sm 의 FontStyle 도메인 키로 fallback", () => {
+  // PR3 후속: materialize.mjs 가 FontStyle/BgStyle/BorderStyle 에 도메인 레벨
+  // sourceMap 엔트리를 함께 둠. 파생 leaf 에러도 design 위치로 안내됨.
+  const sm = {
+    "Steps.S1.Contents[0]": {
+      "FontStyle.FontColor": "$.design.color",
+      FontStyle: "$.design",
+    },
+  };
+  const r = reverseMapInstancePath(
+    "/Steps/S1/Contents/0/FontStyle/UseFont",
+    sm,
+  );
+  assert.equal(r.path, "Steps.S1.Contents[0].design");
+  assert.equal(r.leaf, "FontStyle");
+  assert.equal(r.designOrigin, true);
+});
+
+test("reverseMap: 도메인 키 없는 sm 은 여전히 null 반환 (회귀 보호)", () => {
+  const sm = {
+    "Steps.S1.Contents[0]": { "FontStyle.FontColor": "$.design.color" },
+    // 도메인 레벨 키 의도적으로 누락.
+  };
+  const r = reverseMapInstancePath(
+    "/Steps/S1/Contents/0/FontStyle/UseFont",
+    sm,
+  );
+  assert.equal(r, null);
+});
+
+test("reverseMap: parent fallback — Padding.Top 의 부모 Padding 이 sm 에 있을 때 성공", () => {
+  const sm = {
+    "Steps.S1.Contents[0]": { Padding: "$.design.p" },
+  };
+  const r = reverseMapInstancePath(
+    "/Steps/S1/Contents/0/Padding/Top",
+    sm,
+  );
+  assert.equal(r.path, "Steps.S1.Contents[0].design.p");
+  assert.equal(r.leaf, "Padding");
+});
+
+// ────────────────────────────────────────────────────────────────────────────
+// reverseMap — 중첩 노드, 가장 긴 매칭
+// ────────────────────────────────────────────────────────────────────────────
+
+test("reverseMap: 중첩 노드에서 가장 긴 prefix 가 이김", () => {
+  const sm = {
+    "Steps.S1.Contents[0]": { Padding: "$.design.p" },
+    "Steps.S1.Contents[0].Contents[0]": {
+      "FontStyle.FontColor": "$.design.color",
+    },
+  };
+  const r = reverseMapInstancePath(
+    "/Steps/S1/Contents/0/Contents/0/FontStyle/FontColor",
+    sm,
+  );
+  // 안쪽 노드 (자식) 가 매칭돼야 함 — Padding 으로 잘못 매핑되면 안 됨.
+  assert.equal(
+    r.path,
+    "Steps.S1.Contents[0].Contents[0].design.color",
+  );
+  assert.equal(r.nodePath, "Steps.S1.Contents[0].Contents[0]");
+});
+
+// ────────────────────────────────────────────────────────────────────────────
+// reverseMap — failure / edge cases
+// ────────────────────────────────────────────────────────────────────────────
+
+test("reverseMap: 어느 노드와도 매칭 안 되면 null", () => {
+  const sm = {
+    "Steps.S1.Contents[0]": { "FontStyle.FontColor": "$.design.color" },
+  };
+  const r = reverseMapInstancePath("/Steps/S2/Contents/0/Width", sm);
+  assert.equal(r, null);
+});
+
+test("reverseMap: 빈 designSourceMaps → null", () => {
+  assert.equal(reverseMapInstancePath("/x/y", {}), null);
+  assert.equal(reverseMapInstancePath("/x/y", null), null);
+  assert.equal(reverseMapInstancePath("/x/y", undefined), null);
+});
+
+test("reverseMap: 빈 instancePath → null", () => {
+  const sm = { "Steps.S1": { Width: "$.design.w" } };
+  assert.equal(reverseMapInstancePath("", sm), null);
+  assert.equal(reverseMapInstancePath(null, sm), null);
+});
+
+// ────────────────────────────────────────────────────────────────────────────
+// describeErrorPath — 편의 헬퍼
+// ────────────────────────────────────────────────────────────────────────────
+
+test("describeErrorPath: 매핑 성공 시 originalPath + designOrigin", () => {
+  const sm = {
+    "Steps.S1.Contents[0]": { "FontStyle.FontColor": "$.design.color" },
+  };
+  const r = describeErrorPath(
+    "/Steps/S1/Contents/0/FontStyle/FontColor",
+    sm,
+  );
+  assert.deepEqual(r, {
+    path: "Steps.S1.Contents[0].design.color",
+    originalPath: "/Steps/S1/Contents/0/FontStyle/FontColor",
+    designOrigin: true,
+  });
+});
+
+test("describeErrorPath: 매핑 실패 시 instancePath 그대로", () => {
+  const r = describeErrorPath("/Steps/S1/Contents/0/Caption", {});
+  assert.deepEqual(r, { path: "/Steps/S1/Contents/0/Caption" });
+});
+
+test("describeErrorPath: 빈 instancePath → '<root>'", () => {
+  assert.deepEqual(describeErrorPath("", {}), { path: "<root>" });
+  assert.deepEqual(describeErrorPath(null, {}), { path: "<root>" });
+});
+
+// ────────────────────────────────────────────────────────────────────────────
+// 통합 시나리오 — PR2 가 생성하는 sourceMap 모양과 일치하는지
+// ────────────────────────────────────────────────────────────────────────────
+
+test("통합: applyDesign 의 sourceMap 출력 형태와 호환", async () => {
+  const { applyDesign } = await import("../materialize.mjs");
+  // PR2 walker 가 setup 하는 path 와 동일 형식.
+  const { sourceMap } = applyDesign(
+    {
+      ControlType: "Label",
+      labeltext: "x",
+      Id: "f_1",
+      design: { color: "body", font: "body-large" },
+    },
+    "Steps.S1.Contents[0]",
+  );
+
+  // walker 가 designSourceMaps[path] = sourceMap 로 저장 — 우리도 같은 모양으로 wrap.
+  const sm = { "Steps.S1.Contents[0]": sourceMap };
+
+  // Ajv 가 FontColor 에서 실패했다고 가정.
+  const r = describeErrorPath(
+    "/Steps/S1/Contents/0/FontStyle/FontColor",
+    sm,
+  );
+  assert.equal(r.path, "Steps.S1.Contents[0].design.color");
+  assert.equal(r.designOrigin, true);
+
+  // FontSize 도 mapping — text role 이 두 leaf 를 모두 채움.
+  const r2 = describeErrorPath(
+    "/Steps/S1/Contents/0/FontStyle/FontSize",
+    sm,
+  );
+  assert.equal(r2.path, "Steps.S1.Contents[0].design.font");
+
+  // 파생 leaf (UseFont) — leaf 매핑은 없지만 도메인 fallback 으로 design 위치 안내.
+  const r3 = describeErrorPath(
+    "/Steps/S1/Contents/0/FontStyle/UseFont",
+    sm,
+  );
+  assert.equal(r3.path, "Steps.S1.Contents[0].design");
+  assert.equal(r3.designOrigin, true);
+});