@cardenelabs/cdl 0.80.0 → 0.82.0

package/CHANGELOG.md

@@ -5,6 +5,53 @@ CDL (Chainome Diagram Language) の主要変更履歴。
 
 ## [Unreleased]
 
+## [0.82.0] - 2026-09-27
+
+### Added
+
+- **速さの判定の境と測り方を package の入口から読めるようにした** (#899 / #900)
+
+  `PERF_BUDGET_TOTAL_MS` と `PERF_SLOWEST_SAMPLE` を値として、`PerfClockKind` を型として
+  `@cardenelabs/cdl` から出した。 `src/visual-validate.ts` には元から export があったが、
+  使う側は package の入口から import するため届いていなかった。
+
+  届かないと使う側は境の `5000` を自分の検査に書き写すことになり、こちらで境を変えた時に
+  使う側の検査だけが古い前提で測り続ける。 同じ理由で入口へ出した先例が 2 つある
+  (`EDGE_LABEL_TEXT` 系と `STAGE_SVG_SELECTOR` 系) ので、同じ形に揃えた。
+
+## [0.81.0] - 2026-09-27
+
+### Fixed
+
+- **速さの判定が機械の混み具合で動かなくなった** (#897 / #898)
+
+  軸 `validate-performance-budget` は検査に掛かった時間を壁時計 (`Date.now()`) で測っていた。
+  壁時計は待たされた分も足すため、値が図の性質ではなく機械の混み具合で動く。
+
+  | 測り方 | 累計の幅 (使う側の図 599 枚を 3 周) |
+  |---|---|
+  | その検査だけを回す (5 回) | 335..1739ms |
+  | 検査を一式回す (5 回) | 806..2468ms |
+
+  同じ入力で 7.4 倍ぶれていた。 境の 5000ms に対して最悪 49% なので超えてはいないが、図の
+  枚数は 0.41.1 で軸を作った時の 444 枚から 599 枚に増えており、余裕は枚数の増加だけで減る。
+
+  CPU 時間で測る形にした。 待っている間は増えないため、同時に他の検査が走っても値が動かない。
+  `Date.now()` の 1ms 刻みでは 1 枚あたりがほとんど 0ms に丸まるが、CPU 時間はマイクロ秒で
+  返るため超過時の「重い順」 の内訳も読める。 読む上乗せは 1 回 0.0008ms。
+
+### Added
+
+- **掃き出しの返り値が速さの測り方を持つようになった** (#897 / #898)
+
+  `visualValidateAll` の返り値に `perfClock` (`"cpu"` または `"wall"`) が入る。
+  CPU 時間が読めない環境では壁時計に落ちるため、**どちらで測ったかを返り値と超過の文面の
+  2 箇所に出す**。 測り方が変わったのに同じ顔で報告すると、読み手が 2 つの値を同じものとして
+  並べる。
+
+  返り値にも出すのは、超過していない周では文面が出ないため。 呼ぶ側が「CPU 時間で測れて
+  いるか」 を超過の有無と切り離して確かめられる。
+
 ## [0.80.0] - 2026-09-27
 
 ### Fixed
@@ -3279,7 +3326,9 @@ Initial OSS release.
 使わない = annotated tag を push しても GitHub Release は作られず、 Release を作っていない版で
 行き止まりになる。
 
-[Unreleased]: https://github.com/cardene777/cdl/compare/v0.80.0...HEAD
+[Unreleased]: https://github.com/cardene777/cdl/compare/v0.82.0...HEAD
+[0.82.0]: https://github.com/cardene777/cdl/compare/v0.81.0...v0.82.0
+[0.81.0]: https://github.com/cardene777/cdl/compare/v0.80.0...v0.81.0
 [0.80.0]: https://github.com/cardene777/cdl/compare/v0.79.0...v0.80.0
 [0.79.0]: https://github.com/cardene777/cdl/compare/v0.78.0...v0.79.0
 [0.78.0]: https://github.com/cardene777/cdl/compare/v0.77.0...v0.78.0

package/dist/index.cjs

@@ -18411,11 +18411,12 @@ function runAxes(laid, diag, violations, counts, push, profile, skippedAxes, \u5
 }
 function visualValidateAll(diagrams, opts) {
   \u5668\u3092\u78BA\u304B\u3081\u308B(opts?.container);
+  const \u6642\u8A08 = perfClock();
   const durations = [];
   const reports = diagrams.map((d) => {
-    const start = Date.now();
+    const \u6B62\u3081\u308B = \u6642\u8A08.\u6E2C\u308B();
     const r = visualValidate(d, opts);
-    durations.push(Date.now() - start);
+    durations.push(\u6B62\u3081\u308B());
     return r;
   });
   const fail = reports.filter((r) => !r.ok).length;
@@ -18425,7 +18426,7 @@ function visualValidateAll(diagrams, opts) {
       totalCounts[axis] += r.counts[axis];
     }
   }
-  const metaViolations = validateMetaAxes(totalCounts, diagrams, durations, reports);
+  const metaViolations = validateMetaAxes(totalCounts, diagrams, durations, reports, \u6642\u8A08.kind);
   return {
     total: reports.length,
     pass: reports.length - fail,
@@ -18434,12 +18435,35 @@ function visualValidateAll(diagrams, opts) {
     totalCounts,
     profile: opts?.profile ?? "production",
     skippedAxes: [...SKIPPED_AXES[opts?.profile ?? "production"]],
-    metaViolations
+    metaViolations,
+    perfClock: \u6642\u8A08.kind
   };
 }
 var PERF_BUDGET_TOTAL_MS = 5e3;
+function perfClock() {
+  const cpu = globalThis.process?.cpuUsage;
+  if (typeof cpu === "function") {
+    return {
+      kind: "cpu",
+      \u6E2C\u308B: () => {
+        const \u59CB\u3081 = cpu();
+        return () => {
+          const \u5DEE = cpu(\u59CB\u3081);
+          return (\u5DEE.user + \u5DEE.system) / 1e3;
+        };
+      }
+    };
+  }
+  return {
+    kind: "wall",
+    \u6E2C\u308B: () => {
+      const \u59CB\u3081 = Date.now();
+      return () => Date.now() - \u59CB\u3081;
+    }
+  };
+}
 var PERF_SLOWEST_SAMPLE = 5;
-function perfBudgetViolations(durations, diagrams = []) {
+function perfBudgetViolations(durations, diagrams = [], clock) {
   const total = durations.reduce((s, d) => s + d, 0);
   if (total <= PERF_BUDGET_TOTAL_MS) return [];
   const \u91CD\u3044\u9806 = durations.map((ms, i) => ({ id: diagrams[i]?.id ?? "?", ms })).sort((a, b) => b.ms - a.ms);
@@ -18450,12 +18474,13 @@ function perfBudgetViolations(durations, diagrams = []) {
     {
       axis: "validate-performance-budget",
       diagramId: "__meta__",
-      detail: `visualValidateAll \u5168 ${durations.length} \u56F3\u306E\u7D2F\u8A08 ${total}ms > ${PERF_BUDGET_TOTAL_MS}ms budget (\u91CD\u3044\u9806 ${\u5185\u8A33})`,
+      detail: `visualValidateAll \u5168 ${durations.length} \u56F3\u306E\u7D2F\u8A08 ${total}ms > ${PERF_BUDGET_TOTAL_MS}ms budget (\u91CD\u3044\u9806 ${\u5185\u8A33})` + // 測り方が変わったのに同じ顔で報告すると、読み手が 2 つの値を同じものとして並べる
+      (clock === void 0 ? "" : `\u3001 \u6E2C\u308A\u65B9 ${clock === "cpu" ? "CPU \u6642\u9593" : "\u58C1\u6642\u8A08 (CPU \u6642\u9593\u304C\u8AAD\u3081\u306A\u3044)"}`),
       severity: "warn"
     }
   ];
 }
-function validateMetaAxes(totalCounts, diagrams = [], durations = [], reports = []) {
+function validateMetaAxes(totalCounts, diagrams = [], durations = [], reports = [], clock) {
   const out = [];
   const totalErrors = reports.reduce(
     (sum, r) => sum + r.violations.filter((v) => v.severity === "error").length,
@@ -18470,7 +18495,7 @@ function validateMetaAxes(totalCounts, diagrams = [], durations = [], reports =
       severity: "warn"
     });
   }
-  out.push(...perfBudgetViolations(durations, diagrams));
+  out.push(...perfBudgetViolations(durations, diagrams, clock));
   const DEAD_ALLOWLIST = [
     // catalog で自然発火なしを許容する security / migration / performance / meta / dev-quality axis 群。
     // 実 diagram に該当データ (XSS / migration list / oversized / broken doc) が混入するのが稀なため。
@@ -34143,6 +34168,8 @@ exports.NEAR_COLLISION_DEFAULT_MIN = NEAR_COLLISION_DEFAULT_MIN;
 exports.NEAR_COLLISION_POLICY = NEAR_COLLISION_POLICY;
 exports.NODE_FRAME_SELECTOR = NODE_FRAME_SELECTOR;
 exports.NODE_KINDS = NODE_KINDS;
+exports.PERF_BUDGET_TOTAL_MS = PERF_BUDGET_TOTAL_MS;
+exports.PERF_SLOWEST_SAMPLE = PERF_SLOWEST_SAMPLE;
 exports.RELATION_FOCUSES = RELATION_FOCUSES;
 exports.RELATION_FOCUS_DEFAULT = RELATION_FOCUS_DEFAULT;
 exports.ROW_GAP_VARIANCE_TOL = ROW_GAP_VARIANCE_TOL;