@hatiolab/figure-model 0.4.1 → 0.4.3

package/docs/modeller-interaction-performance-2026-10-07.md

@@ -0,0 +1,60 @@
+# 모델러 선택·값 변경 성능 측정 (2026-10-07)
+
+결정 정본: [ADR-0119](../../operato-application/adr/ADR-0119.md) (안건).
+이 문서는 측정 원자료와 실행 상태를 둔다. 예정 효과를 성과로 적지 않는다.
+
+## 대상과 방법
+
+- 대상: 지게차 Figure(부품 504개, joint 다수, 소스 112 KB), operato-figure :3300 모델러.
+- 브라우저 측정: Long Task / Long Animation Frame 관찰자, 세션 메서드와 Lit 렌더를 감싼 시간 합산. 정상 상태는 같은 조작을 세 번 해서 읽는다. 콜드 첫 선택은 따로 적는다.
+- 횟수 측정: `work-counter.ts`(`measureFigureWork`)가 전체 컴파일과 평가를 센다. 시간과 달리 머신과 부하에 흔들리지 않는다. 예산 시험은 `editor-workspace.test.ts`의 「interaction budgets」.
+- 시간(ms)은 10-05 `A/A` 변동 때문에 후보를 가르는 근거로 쓰지 않는다. 횟수로 가르고, 시간은 사용자가 느끼는 크기를 보이는 용도로만 쓴다.
+
+## 결과 (브라우저, 정상 상태)
+
+| 조작 | 시작 | 지금 |
+| --- | --- | --- |
+| 파트 클릭 | 2.1초, 첫 클릭 10.5초 | 클릭 처리 약 90 ms, 150 ms 뒤 미리보기 약 100 ms. 콜드 첫 선택 약 230 ms |
+| 값 변경 확정 | 약 970 ms | 약 230 ms. 이어서 늦춘 작업 셋이 각각 별도 작업으로 약 110·약 100·약 70~100 ms |
+
+값 변경 확정 프레임 약 230 ms의 구성: `command` 약 100 ms(커널), `figure-links` 첫 렌더 약 50 ms, `figure-editor` 렌더 약 33 ms.
+`figure-links` 쪽은 옵션 504개 DOM 때문으로 추정하지만 확인하지 않았다.
+
+## 결과 (횟수, 워크스페이스, 한 번에 일어나는 전체 컴파일)
+
+| 조작 | 시작 | 지금 | 예산 시험 |
+| --- | --- | --- | --- |
+| 열기 | 9 | 3 | ≤ 3 |
+| 값 변경 + 읽기 + dirty | 12(시험 도형에서 27까지) | 4 | ≤ 4 |
+| 소스 텍스트(export) | 3 | 1 | ≤ 1 |
+| 다시 읽기 | 매번 전체 | 0 | 0 |
+
+시작값은 수정 전 코드에 같은 예산 시험을 돌린 값이다(열기 9, 값 변경 27, undo+redo 31). 값 변경 12는 지게차 한 명령의 호출 스택 분해다.
+
+## compileAsset 한 번의 구성 (지게차, node, 10회 평균, 약 21.8 ms)
+
+| 단계 | ms |
+| --- | --- |
+| jsonOnly | 1.0 |
+| stringify · 크기 · 필드 | 0.2 |
+| structuredClone | 0.4 |
+| compileDocument | 약 3.0 |
+| 저장 입력 evaluate | 0.5 |
+| **자산 검증(나머지)** | **약 16.6** |
+
+CPU 프로파일 포함 시간(compileAsset 272 ms 안): `checkFigureJoints` 189 ms(69 %) → `rewriteJoints` 177 → `writeJoint` 130 → `dropIfUnused` 118 → `stringsIn` 103(자체 시간 1위, 26 %).
+
+- 평가는 컴파일 비용이 아니다(0.5 ms).
+- 비용은 ADR-0093의 「joint 기록으로 노드를 다시 만들어 보유한 노드와 대조」에 있다. joint마다 `writeJoint`를 되풀이하고, `dropIfUnused`가 호출마다 `stringsIn`으로 occupancy·capabilities·joints 전체의 문자열을 새로 모아 joint 수에 제곱으로 늘어난다.
+- `stringsIn`을 배열 할당 없는 순회로 바꿨다(figure-model 8085989). 컴파일 중앙값 23.47 → 18.25 ms(−22 %, 최솟값 22.6 → 15.7 ms), 시험 806건 통과. 계약 변화 없음. 복사본에서 먼저 쟀을 때는 20.56 → 14.98 ms(−27 %)였고, 이 머신은 변동이 커서 중앙값으로 읽는다.
+- `dropIfUnused` 재귀가 `declared` 집합을 공유하게 하는 시도는 효과가 없었다(15.16 ms). 재귀가 얕다.
+- 수정 뒤에도 `checkFigureJoints`가 61 %로 남는다.
+
+## 실행 상태
+
+| 항목 | 상태 |
+| --- | --- |
+| 워크스페이스 파생 기억·횟수 계측·예산 시험 | figure-model 0.4.1 발행 |
+| 화면 쪽 정리(파싱 1회, `view.geometry` 심기, 미리보기·검사 디바운스, 안 보이는 패널 건너뛰기) | things-factory v10 커밋 둘, 미발행 |
+| `stringsIn` 비할당 순회 | figure-model 8085989 커밋(시험 806 통과), 미발행 |
+| joint 대조 줄이기, 컴파일 결과 기억 | ADR-0119 안건, 미결정 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatiolab/figure-model",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "The figure format (figure-asset-1): a kernel that evaluates a figure from its declared relations, the authoring commands a modeller and an AI share, the release gate and the score.",
   "keywords": [
     "figure",
@@ -49,6 +49,7 @@
     "build": "tsc -p tsconfig.build.json",
     "check": "tsc -p tsconfig.json --noEmit",
     "test": "npm run check && node --test src/*.test.ts",
+    "test:coverage:slot-layout": "node --test --experimental-test-coverage --test-coverage-include=src/slot-layout.ts --test-coverage-include=src/slot-places.ts --test-coverage-lines=100 --test-coverage-branches=95 --test-coverage-functions=95 src/slot-layout.test.ts src/slot-places.test.ts",
     "test:rewrite": "node --test scripts/*.test.ts",
     "test:released": "node --test scripts/released-kernel.check.ts",
     "test:coverage": "node --test --experimental-test-coverage --test-coverage-lines=100 --test-coverage-branches=95 --test-coverage-functions=100 src/*.test.ts",