@elabs-ai/components-process 4.2.0 → 5.1.0

package/dist/test/index.js

@@ -1,88 +1,121 @@
 "use client";
 
-// src/test/contract.ts
-var ProcessContractError = class extends Error {
-  constructor(componentName, message) {
-    super(`${componentName}: ${message}`);
-    this.name = "ProcessContractError";
-  }
-};
-function isProcessGraph(value) {
-  return !!value && typeof value === "object" && Array.isArray(value.activities) && Array.isArray(value.transitions);
+// src/core/event-log.ts
+function isNormalizedLog(log) {
+  return Array.isArray(log.cases);
 }
-function isVariantArray(value) {
-  return Array.isArray(value) && value.every((entry) => typeof entry === "object" && entry !== null && "sequence" in entry);
+function asNormalizedLog(log) {
+  return isNormalizedLog(log) ? log : normalizeLog(log);
 }
-function assertProcessContract(componentName, props, spec) {
-  const data = props[spec.dataProp];
-  if (spec.dataProp === "graph" && !isProcessGraph(data)) {
-    throw new ProcessContractError(
-      componentName,
-      `"graph" prop must be a ProcessGraph, got ${typeof data}`
-    );
-  }
-  if (spec.dataProp === "variants" && !isVariantArray(data)) {
-    throw new ProcessContractError(
-      componentName,
-      `"variants" prop must be a Variant[], got ${typeof data}`
-    );
+function toEpochMs(value) {
+  if (value === void 0 || value === null) return Number.NaN;
+  if (typeof value === "number") return Number.isFinite(value) ? value : Number.NaN;
+  if (value instanceof Date) return value.getTime();
+  const parsed = Date.parse(value);
+  if (!Number.isNaN(parsed)) return parsed;
+  const asNumber = Number(value);
+  return Number.isFinite(asNumber) && value.trim() !== "" ? asNumber : Number.NaN;
+}
+function byTimestamp(a, b) {
+  if (Number.isNaN(a.at) || Number.isNaN(b.at)) return 0;
+  return a.at - b.at;
+}
+function normalizeLog(log) {
+  const staged = /* @__PURE__ */ new Map();
+  const order = [];
+  for (const row of log.events) {
+    if (!row || typeof row.caseId !== "string" || row.caseId === "") continue;
+    if (typeof row.activity !== "string" || row.activity === "") continue;
+    let bucket = staged.get(row.caseId);
+    if (bucket === void 0) {
+      bucket = [];
+      staged.set(row.caseId, bucket);
+      order.push(row.caseId);
+    }
+    bucket.push({ at: toEpochMs(row.timestamp), row });
   }
-  for (const key of spec.requiredProps ?? []) {
-    if (props[key] === void 0) {
-      throw new ProcessContractError(componentName, `missing required prop "${key}"`);
+  const cases = [];
+  let events = 0;
+  for (const caseId of order) {
+    const bucket = staged.get(caseId);
+    bucket.sort(byTimestamp);
+    const instances = [];
+    const open = /* @__PURE__ */ new Map();
+    for (const { at, row } of bucket) {
+      if (row.lifecycle === "start") {
+        const index = instances.length;
+        instances.push(makeInstance(row, at, at, true));
+        const queue = open.get(row.activity);
+        if (queue === void 0) open.set(row.activity, [index]);
+        else queue.push(index);
+        continue;
+      }
+      if (row.lifecycle === "complete") {
+        const queue = open.get(row.activity);
+        const index = queue?.shift();
+        if (index !== void 0) {
+          const instance = instances[index];
+          instance.end = at;
+          instance.duration = durationOf(instance.start, at);
+          instance.isOpen = false;
+          if (instance.resource === void 0 && row.resource !== void 0) {
+            instance.resource = row.resource;
+          }
+          if (instance.attributes === void 0 && row.attributes !== void 0) {
+            instance.attributes = row.attributes;
+          }
+          continue;
+        }
+      }
+      const end = at;
+      const explicitStart = toEpochMs(row.startTimestamp);
+      const start = Number.isNaN(explicitStart) ? end : explicitStart;
+      instances.push(makeInstance(row, start, end, false));
     }
+    if (instances.length === 0) continue;
+    instances.sort(byStart);
+    let caseStart = Number.POSITIVE_INFINITY;
+    let caseEnd = Number.NEGATIVE_INFINITY;
+    for (const instance of instances) {
+      if (Number.isFinite(instance.start) && instance.start < caseStart) caseStart = instance.start;
+      if (Number.isFinite(instance.end) && instance.end > caseEnd) caseEnd = instance.end;
+    }
+    const hasExtent = caseStart !== Number.POSITIVE_INFINITY && caseEnd !== Number.NEGATIVE_INFINITY;
+    const normalizedCase = {
+      caseId,
+      events: instances,
+      start: hasExtent ? caseStart : Number.NaN,
+      end: hasExtent ? caseEnd : Number.NaN,
+      duration: hasExtent ? durationOf(caseStart, caseEnd) : Number.NaN
+    };
+    const caseAttributes = log.caseAttributes?.[caseId];
+    if (caseAttributes !== void 0) normalizedCase.attributes = caseAttributes;
+    cases.push(normalizedCase);
+    events += instances.length;
   }
+  return { cases, totals: { cases: cases.length, events } };
 }
-function buildProcessDoublePayload(componentName, props, spec) {
-  const data = props[spec.dataProp];
-  const dataLength = spec.dataProp === "graph" && isProcessGraph(data) ? data.activities.length : Array.isArray(data) ? data.length : 0;
-  const payload = { component: componentName, dataLength };
-  if ("selection" in props) payload.selection = props.selection;
-  return payload;
+function byStart(a, b) {
+  if (Number.isNaN(a.start) || Number.isNaN(b.start)) return 0;
+  return a.start - b.start;
 }
-function readProcessDoubleProps(el) {
-  const raw = el.getAttribute("data-process-props");
-  return raw ? JSON.parse(raw) : null;
+function durationOf(start, end) {
+  const delta = end - start;
+  if (!Number.isFinite(delta)) return Number.NaN;
+  return delta < 0 ? 0 : delta;
 }
-
-// src/test/doubles.tsx
-import { forwardRef } from "react";
-import { jsx } from "react/jsx-runtime";
-var PROCESS_MAP_SPEC = { dataProp: "graph" };
-var VARIANT_EXPLORER_SPEC = { dataProp: "variants" };
-var PROCESS_KPI_STRIP_SPEC = { dataProp: "graph" };
-function createProcessDouble(name, spec) {
-  const Double = forwardRef(function ProcessTestDouble(props, ref) {
-    const record = props;
-    assertProcessContract(name, record, spec);
-    const payload = buildProcessDoublePayload(name, record, spec);
-    return /* @__PURE__ */ jsx(
-      "div",
-      {
-        ref,
-        "data-slot": "process-test-double",
-        "data-process-double": name,
-        "data-process-props": JSON.stringify(payload),
-        className: props.className,
-        style: props.style
-      }
-    );
-  });
-  Double.displayName = name;
-  return Double;
+function makeInstance(row, start, end, isOpen) {
+  const instance = {
+    activity: row.activity,
+    start,
+    end,
+    duration: durationOf(start, end),
+    isOpen
+  };
+  if (row.resource !== void 0) instance.resource = row.resource;
+  if (row.attributes !== void 0) instance.attributes = row.attributes;
+  return instance;
 }
-var ProcessMapDouble = createProcessDouble(
-  "ProcessMapDouble",
-  PROCESS_MAP_SPEC
-);
-var VariantExplorerDouble = createProcessDouble(
-  "VariantExplorerDouble",
-  VARIANT_EXPLORER_SPEC
-);
-var ProcessKpiStripDouble = createProcessDouble(
-  "ProcessKpiStripDouble",
-  PROCESS_KPI_STRIP_SPEC
-);
 
 // src/core/scale.ts
 function ascending(a, b) {
@@ -205,123 +238,6 @@ var DurationSampler = class {
   }
 };
 
-// src/core/event-log.ts
-function isNormalizedLog(log) {
-  return Array.isArray(log.cases);
-}
-function asNormalizedLog(log) {
-  return isNormalizedLog(log) ? log : normalizeLog(log);
-}
-function toEpochMs(value) {
-  if (value === void 0 || value === null) return Number.NaN;
-  if (typeof value === "number") return Number.isFinite(value) ? value : Number.NaN;
-  if (value instanceof Date) return value.getTime();
-  const parsed = Date.parse(value);
-  if (!Number.isNaN(parsed)) return parsed;
-  const asNumber = Number(value);
-  return Number.isFinite(asNumber) && value.trim() !== "" ? asNumber : Number.NaN;
-}
-function byTimestamp(a, b) {
-  if (Number.isNaN(a.at) || Number.isNaN(b.at)) return 0;
-  return a.at - b.at;
-}
-function normalizeLog(log) {
-  const staged = /* @__PURE__ */ new Map();
-  const order = [];
-  for (const row of log.events) {
-    if (!row || typeof row.caseId !== "string" || row.caseId === "") continue;
-    if (typeof row.activity !== "string" || row.activity === "") continue;
-    let bucket = staged.get(row.caseId);
-    if (bucket === void 0) {
-      bucket = [];
-      staged.set(row.caseId, bucket);
-      order.push(row.caseId);
-    }
-    bucket.push({ at: toEpochMs(row.timestamp), row });
-  }
-  const cases = [];
-  let events = 0;
-  for (const caseId of order) {
-    const bucket = staged.get(caseId);
-    bucket.sort(byTimestamp);
-    const instances = [];
-    const open = /* @__PURE__ */ new Map();
-    for (const { at, row } of bucket) {
-      if (row.lifecycle === "start") {
-        const index = instances.length;
-        instances.push(makeInstance(row, at, at, true));
-        const queue = open.get(row.activity);
-        if (queue === void 0) open.set(row.activity, [index]);
-        else queue.push(index);
-        continue;
-      }
-      if (row.lifecycle === "complete") {
-        const queue = open.get(row.activity);
-        const index = queue?.shift();
-        if (index !== void 0) {
-          const instance = instances[index];
-          instance.end = at;
-          instance.duration = durationOf(instance.start, at);
-          instance.isOpen = false;
-          if (instance.resource === void 0 && row.resource !== void 0) {
-            instance.resource = row.resource;
-          }
-          if (instance.attributes === void 0 && row.attributes !== void 0) {
-            instance.attributes = row.attributes;
-          }
-          continue;
-        }
-      }
-      const end = at;
-      const explicitStart = toEpochMs(row.startTimestamp);
-      const start = Number.isNaN(explicitStart) ? end : explicitStart;
-      instances.push(makeInstance(row, start, end, false));
-    }
-    if (instances.length === 0) continue;
-    instances.sort(byStart);
-    let caseStart = Number.POSITIVE_INFINITY;
-    let caseEnd = Number.NEGATIVE_INFINITY;
-    for (const instance of instances) {
-      if (Number.isFinite(instance.start) && instance.start < caseStart) caseStart = instance.start;
-      if (Number.isFinite(instance.end) && instance.end > caseEnd) caseEnd = instance.end;
-    }
-    const hasExtent = caseStart !== Number.POSITIVE_INFINITY && caseEnd !== Number.NEGATIVE_INFINITY;
-    const normalizedCase = {
-      caseId,
-      events: instances,
-      start: hasExtent ? caseStart : Number.NaN,
-      end: hasExtent ? caseEnd : Number.NaN,
-      duration: hasExtent ? durationOf(caseStart, caseEnd) : Number.NaN
-    };
-    const caseAttributes = log.caseAttributes?.[caseId];
-    if (caseAttributes !== void 0) normalizedCase.attributes = caseAttributes;
-    cases.push(normalizedCase);
-    events += instances.length;
-  }
-  return { cases, totals: { cases: cases.length, events } };
-}
-function byStart(a, b) {
-  if (Number.isNaN(a.start) || Number.isNaN(b.start)) return 0;
-  return a.start - b.start;
-}
-function durationOf(start, end) {
-  const delta = end - start;
-  if (!Number.isFinite(delta)) return Number.NaN;
-  return delta < 0 ? 0 : delta;
-}
-function makeInstance(row, start, end, isOpen) {
-  const instance = {
-    activity: row.activity,
-    start,
-    end,
-    duration: durationOf(start, end),
-    isOpen
-  };
-  if (row.resource !== void 0) instance.resource = row.resource;
-  if (row.attributes !== void 0) instance.attributes = row.attributes;
-  return instance;
-}
-
 // src/core/extract-variants.ts
 var VARIANT_KEY_SEPARATOR = "
";
 function variantKey(sequence) {
@@ -510,15 +426,254 @@ function toSortedRecord(counts) {
   return out;
 }
 
+// src/core/segments.ts
+function segmentKey(from, to) {
+  return `${from}${EDGE_KEY_SEPARATOR}${to}`;
+}
+function segmentsFor(log, order) {
+  const wanted = /* @__PURE__ */ new Set();
+  for (const def of order) wanted.add(segmentKey(def.from, def.to));
+  const out = [];
+  if (wanted.size === 0) return out;
+  for (const kase of asNormalizedLog(log).cases) {
+    const trace = kase.events;
+    for (let i = 1; i < trace.length; i += 1) {
+      const previous = trace[i - 1];
+      const event = trace[i];
+      const key = segmentKey(previous.activity, event.activity);
+      if (!wanted.has(key)) continue;
+      const start = previous.end;
+      if (!Number.isFinite(start) || !Number.isFinite(event.start)) continue;
+      const end = Math.max(start, event.start);
+      out.push({ segment: key, caseId: kase.caseId, start, end, duration: end - start });
+    }
+  }
+  return out;
+}
+function segmentOrderByFrequency(graph, limit = Number.POSITIVE_INFINITY) {
+  const n = Math.max(0, Math.floor(limit));
+  return graph.transitions.slice(0, n).map((t) => ({ from: t.source, to: t.target }));
+}
+function segmentOrderForVariant(variant) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (let i = 1; i < variant.sequence.length; i += 1) {
+    const from = variant.sequence[i - 1];
+    const to = variant.sequence[i];
+    const key = segmentKey(from, to);
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push({ from, to });
+  }
+  return out;
+}
+
+// src/test/contract.ts
+var ProcessContractError = class extends Error {
+  constructor(componentName, message) {
+    super(`${componentName}: ${message}`);
+    this.name = "ProcessContractError";
+  }
+};
+function isProcessGraph(value) {
+  return !!value && typeof value === "object" && Array.isArray(value.activities) && Array.isArray(value.transitions);
+}
+function isEventLog(value) {
+  return !!value && typeof value === "object" && Array.isArray(value.events);
+}
+function countSpectrumOccurrences(log, order, limit) {
+  const cap = typeof limit === "number" ? Math.max(0, Math.floor(limit)) : 12;
+  let definitions = [];
+  if (order === void 0 || order === "frequency") {
+    definitions = segmentOrderByFrequency(discoverGraph(log), cap);
+  } else if (Array.isArray(order)) {
+    definitions = order.slice(0, cap);
+  } else if (order && typeof order === "object" && "variantId" in order) {
+    const id = order.variantId;
+    const variant = extractVariants(log).find((v) => v.id === id);
+    definitions = variant ? segmentOrderForVariant(variant).slice(0, cap) : [];
+  }
+  return segmentsFor(log, definitions).length;
+}
+function isVariantArray(value) {
+  return Array.isArray(value) && value.every((entry) => typeof entry === "object" && entry !== null && "sequence" in entry);
+}
+function isTimedEventLog(value) {
+  const events = value?.events;
+  return Array.isArray(events) && events.length > 0 && events.every(
+    (row) => !!row && typeof row === "object" && Number.isFinite(toEpochMs(row.timestamp))
+  );
+}
+function isConformanceResult(value) {
+  return !!value && typeof value === "object" && Array.isArray(value.traces) && typeof value.deviationCounts === "object";
+}
+function isHappyPath(value) {
+  return !!value && typeof value === "object" && Array.isArray(value.steps);
+}
+function assertProcessContract(componentName, props, spec) {
+  const data = props[spec.dataProp];
+  if (spec.dataProp === "graph" && !isProcessGraph(data)) {
+    throw new ProcessContractError(
+      componentName,
+      `"graph" prop must be a ProcessGraph, got ${typeof data}`
+    );
+  }
+  if (spec.dataProp === "variants" && !isVariantArray(data)) {
+    throw new ProcessContractError(
+      componentName,
+      `"variants" prop must be a Variant[], got ${typeof data}`
+    );
+  }
+  if (spec.dataProp === "log" && !isTimedEventLog(data)) {
+    throw new ProcessContractError(
+      componentName,
+      `"log" prop must be an EventLog with non-empty events and parsable timestamps`
+    );
+  }
+  if (spec.segmentOrder && isEventLog(data) && data.events.length > 0 && countSpectrumOccurrences(data, props.order, props.segmentLimit) === 0) {
+    throw new ProcessContractError(
+      componentName,
+      `"order" resolves to no segment that occurs in "log"`
+    );
+  }
+  if (spec.dataProp === "conformance" && !isConformanceResult(data)) {
+    throw new ProcessContractError(
+      componentName,
+      `"conformance" prop must be a ConformanceResult, got ${typeof data}`
+    );
+  }
+  if (spec.dataProp === "value" && !isHappyPath(data)) {
+    throw new ProcessContractError(
+      componentName,
+      `"value" prop must be a HappyPath, got ${typeof data}`
+    );
+  }
+  for (const key of spec.requiredProps ?? []) {
+    if (props[key] === void 0) {
+      throw new ProcessContractError(componentName, `missing required prop "${key}"`);
+    }
+  }
+}
+function buildProcessDoublePayload(componentName, props, spec) {
+  const data = props[spec.dataProp];
+  const dataLength = spec.dataProp === "graph" && isProcessGraph(data) ? data.activities.length : spec.dataProp === "log" && isTimedEventLog(data) ? data.events.length : spec.dataProp === "conformance" && isConformanceResult(data) ? data.traces.length : spec.dataProp === "value" && isHappyPath(data) ? data.steps.length : Array.isArray(data) ? data.length : 0;
+  const payload = { component: componentName, dataLength };
+  if ("selection" in props) payload.selection = props.selection;
+  return payload;
+}
+function readProcessDoubleProps(el) {
+  const raw = el.getAttribute("data-process-props");
+  return raw ? JSON.parse(raw) : null;
+}
+
+// src/test/doubles.tsx
+import { forwardRef } from "react";
+import { jsx } from "react/jsx-runtime";
+var PROCESS_MAP_SPEC = { dataProp: "graph" };
+var VARIANT_EXPLORER_SPEC = { dataProp: "variants" };
+var PROCESS_KPI_STRIP_SPEC = { dataProp: "graph" };
+function createProcessDouble(name, spec) {
+  const Double = forwardRef(function ProcessTestDouble(props, ref) {
+    const record = props;
+    assertProcessContract(name, record, spec);
+    const payload = buildProcessDoublePayload(name, record, spec);
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        "data-slot": "process-test-double",
+        "data-process-double": name,
+        "data-process-props": JSON.stringify(payload),
+        className: props.className,
+        style: props.style
+      }
+    );
+  });
+  Double.displayName = name;
+  return Double;
+}
+var ProcessMapDouble = createProcessDouble(
+  "ProcessMapDouble",
+  PROCESS_MAP_SPEC
+);
+var VariantExplorerDouble = createProcessDouble(
+  "VariantExplorerDouble",
+  VARIANT_EXPLORER_SPEC
+);
+var ProcessKpiStripDouble = createProcessDouble(
+  "ProcessKpiStripDouble",
+  PROCESS_KPI_STRIP_SPEC
+);
+var DottedChartDouble = createProcessDouble("DottedChartDouble", {
+  dataProp: "log"
+});
+var PERFORMANCE_SPECTRUM_SPEC = { dataProp: "log", segmentOrder: true };
+var PerformanceSpectrumDouble = createProcessDouble(
+  "PerformanceSpectrumDouble",
+  PERFORMANCE_SPECTRUM_SPEC
+);
+var ConformanceOverlayDouble = createProcessDouble(
+  "ConformanceOverlayDouble",
+  { dataProp: "conformance", requiredProps: ["graph"] }
+);
+var ViolationListDouble = createProcessDouble(
+  "ViolationListDouble",
+  { dataProp: "conformance" }
+);
+var HappyPathEditorDouble = createProcessDouble(
+  "HappyPathEditorDouble",
+  { dataProp: "value", requiredProps: ["onChange"] }
+);
+var ProcessReplayDouble = createProcessDouble(
+  "ProcessReplayDouble",
+  { dataProp: "log", requiredProps: ["graph"] }
+);
+var ProcessCompareDouble = forwardRef(
+  function ProcessCompareDouble2({ a, b, mode = "side-by-side", className, style }, ref) {
+    if (!a || typeof a.label !== "string") {
+      throw new ProcessContractError("ProcessCompareDouble", 'missing required prop "a.label"');
+    }
+    if (!b || typeof b.label !== "string") {
+      throw new ProcessContractError("ProcessCompareDouble", 'missing required prop "b.label"');
+    }
+    const payload = {
+      component: "ProcessCompareDouble",
+      mode,
+      aLabel: a.label,
+      bLabel: b.label,
+      aActivityCount: a.graph?.activities.length ?? 0,
+      bActivityCount: b.graph?.activities.length ?? 0
+    };
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        "data-slot": "process-test-double",
+        "data-process-double": "ProcessCompareDouble",
+        "data-process-props": JSON.stringify(payload),
+        className,
+        style
+      }
+    );
+  }
+);
+
 // src/test/primitives.tsx
 function withProcessFixture(log) {
   return { log, graph: discoverGraph(log), variants: extractVariants(log) };
 }
 export {
+  ConformanceOverlayDouble,
+  DottedChartDouble,
+  HappyPathEditorDouble,
+  PerformanceSpectrumDouble,
+  ProcessCompareDouble,
   ProcessContractError,
   ProcessKpiStripDouble,
   ProcessMapDouble,
+  ProcessReplayDouble,
   VariantExplorerDouble,
+  ViolationListDouble,
   assertProcessContract,
   buildProcessDoublePayload,
   readProcessDoubleProps,