@cardenelabs/cdl 0.80.0 → 0.81.0

package/dist/index.d.cts

@@ -1723,8 +1723,17 @@ interface SweepReport {
     profile: ValidationProfile;
     /** 用途によって見なかった軸。 `totalCounts` はこれらも 0 を返す。 */
     skippedAxes: VisualAxis[];
+    /**
+     * 速さを何で測ったか (`#897`)。
+     *
+     * 超過した時だけ文面に出すと、超過していない周では測り方が分からない。 呼ぶ側が
+     * 「CPU 時間で測れているか」 を常に確かめられるように、超過の有無と切り離して返す。
+     */
+    perfClock: PerfClockKind;
 }
 declare function visualValidateAll(diagrams: CdlDiagram[], opts?: ValidateOptions): SweepReport;
+/** 時間を何で測ったか。 超過の文面に出して、黙って別の物を測らないようにする。 */
+type PerfClockKind = "cpu" | "wall";
 
 /**
  * 関係から lane と stack の並びを決める (#599)。

package/dist/index.d.ts

@@ -1723,8 +1723,17 @@ interface SweepReport {
     profile: ValidationProfile;
     /** 用途によって見なかった軸。 `totalCounts` はこれらも 0 を返す。 */
     skippedAxes: VisualAxis[];
+    /**
+     * 速さを何で測ったか (`#897`)。
+     *
+     * 超過した時だけ文面に出すと、超過していない周では測り方が分からない。 呼ぶ側が
+     * 「CPU 時間で測れているか」 を常に確かめられるように、超過の有無と切り離して返す。
+     */
+    perfClock: PerfClockKind;
 }
 declare function visualValidateAll(diagrams: CdlDiagram[], opts?: ValidateOptions): SweepReport;
+/** 時間を何で測ったか。 超過の文面に出して、黙って別の物を測らないようにする。 */
+type PerfClockKind = "cpu" | "wall";
 
 /**
  * 関係から lane と stack の並びを決める (#599)。

package/dist/index.js

@@ -18409,11 +18409,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;
@@ -18423,7 +18424,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,
@@ -18432,12 +18433,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);
@@ -18448,12 +18472,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,
@@ -18468,7 +18493,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) が混入するのが稀なため。