Warp IR — 디자인 문서 중간 표현

DesignDoc                     문서 하나 = 파일 하나
├─ version                    IR 스키마 버전 (현재 0.10.0)
├─ tokens?                    문서 공통 색 · 글자 크기
├─ components[]               재사용 정의 — instance 가 가리킨다
└─ pages[]                    페이지 = Figma 프레임 = HTML 페이지 (1:1)
   ├─ size {w, h?}
   ├─ style?                  페이지 자체 칠 (fills · opacity 만 의미가 있다)
   ├─ background?             순서를 바꿀 수 없는 배경 슬롯 (노드 하나)
   └─ root                    노드 트리의 뿌리 — 보통 layout
      └─ children[]           자식을 갖는 것은 layout · diagram 뿐

문서 레벨 키

페이지 키

SERIALIZED_KEYS.common() = id name node sizing position cell mask clip adjust transform style semantic

TextStyle 의 나머지 — fontFamily · fontWeight(100–900) · color(#hex) · align(left·center·right·justify). 런은 {text, style?, href?} 이고 href 가 있으면 그 런이 링크다.

{ "id": "p1-body", "node": "text",
  "runs": [ { "text": "런 단위 스타일과 " },
            { "href": "https://example.com/ir?a=1&b=2", "style": { "color": "#2c6bed" }, "text": "링크" } ],
  "semantic": { "tag": "p" },
  "sizing": { "h": { "kind": "hug" }, "w": { "kind": "fill" } },
  "textStyle": { "align": "justify", "color": "#444444", "fontSize": 16, "lineHeight": 26 } }

<i id="p1-body" node="text">
  <runs t="a">
    <i text="런 단위 스타일과 "/>
    <i href="https://example.com/ir?a=1&amp;b=2" text="링크"><style color="#2c6bed"/></i>
  </runs>
  <semantic tag="p"/>
  <sizing height="fit-content" width="stretch"/>
  <textStyle align="justify" color="#444444" font-size="16px" line-height="26px"/>
</i>

<i>
  <id t="s">p1-body</id>
  <node t="s">text</node>
  <runs t="a">
    <i><text t="s">런 단위 스타일과 </text></i>
    <i>
      <href t="s">https://example.com/ir?a=1&amp;b=2</href>
      <style><color t="s">#2c6bed</color></style>
      <text t="s">링크</text>
    </i>
  </runs>
  <sizing><h><kind t="s">hug</kind></h><w><kind t="s">fill</kind></w></sizing>
</i>

v2 를 읽는 규칙은 여섯 줄뿐

그래서 그 규칙으로 읽힐 문자열만 인용한다 — "8"·"true"·"null"·"10px"·"[a b]"·"". 속성에 담을 수 없는 값(제어문자가 든 문자열·배열)은 v1 의 t 형태로 떨어진다 — v2 는 v1 을 대체하는 표기가 아니라 그 위에 빠른 길을 얹은 것이다. 타입 태그 t 는 두 판 공통: a 배열 · s 문자열 · s64 base64 · n 숫자 · b 불린 · z 널 · l 스칼라 배열(v2 전용).

web-2 안의 Warp — vendor 가 두 자리다

같은 Warp 저장소에서 왔지만 가져온 부분이 겹치지 않는다 — 파일 내용 SHA-256 교차 0개, 파일명 교집합 0개. HTML 가져오기가 지금은 adapter-html(정적 파싱)이 아니라 브라우저 실측 → adapter-miricanvas 경로를 쓰는 것도 이 때문이다. 기준: main 병합 커밋 6ae349c9765 · Warp cf87a75(mirror) / 3964a2c(main vendor) · 2026-08-12 확인.

Warp 저장소 안의 근거 문서 — 왜 XML 이 이렇게 생겼나: records/decisions/DR-041-ir-xml-form.md(v1) · DR-059-xml-ir-v2-compact.md(v2 축약) · DR-042(URL 대체 정책) · DR-043·DR-045(리소스 키) · 엔진 단위·한계는 docs/wiki/pages/concept-miricanvas-engine-contracts.md. 모든 종류를 담은 실물 표본은 examples/artifacts/all-node-kinds.ir.{json,xml}.