@apexops/renderers 0.10.0-next.0

package/dist/test/scorecard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorecard.test.d.ts","sourceRoot":"","sources":["../../src/test/scorecard.test.ts"],"names":[],"mappings":""}

package/dist/test/scorecard.test.js

@@ -0,0 +1,129 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { evaluateQualityScorecard, renderQualityScorecardEvaluation } from "../index.js";
+const scorecard = {
+    schemaVersion: "1.0.0",
+    frozenAt: "2026-07-01T00:00:00Z",
+    rules: [
+        {
+            metric: "minimum",
+            direction: "min",
+            target: 90,
+            tolerance: 2,
+            scenario: "base",
+            minimumSamples: 2,
+            source: "kernel",
+            owner: "quality",
+            unavailable: "block",
+        },
+        {
+            metric: "maximum",
+            direction: "max",
+            target: 10,
+            tolerance: 1,
+            scenario: "base",
+            minimumSamples: 1,
+            source: "kernel",
+            owner: "quality",
+            unavailable: "block",
+        },
+        {
+            metric: "exact-pass",
+            direction: "exact",
+            target: 5,
+            tolerance: 0.5,
+            scenario: "base",
+            minimumSamples: 1,
+            source: "vscode",
+            owner: "quality",
+            unavailable: "block",
+        },
+        {
+            metric: "exact-fail",
+            direction: "exact",
+            target: 5,
+            tolerance: 0.5,
+            scenario: "base",
+            minimumSamples: 1,
+            source: "vscode",
+            owner: "quality",
+            unavailable: "block",
+        },
+        {
+            metric: "undersampled-block",
+            direction: "min",
+            target: 1,
+            tolerance: 0,
+            scenario: "base",
+            minimumSamples: 3,
+            source: "estimated",
+            owner: "quality",
+            unavailable: "block",
+        },
+        {
+            metric: "undersampled-omit",
+            direction: "min",
+            target: 1,
+            tolerance: 0,
+            scenario: "base",
+            minimumSamples: 3,
+            source: "estimated",
+            owner: "quality",
+            unavailable: "omit-claim",
+        },
+        {
+            metric: "missing-block",
+            direction: "max",
+            target: 1,
+            tolerance: 0,
+            scenario: "base",
+            minimumSamples: 1,
+            source: "kernel",
+            owner: "quality",
+            unavailable: "block",
+        },
+        {
+            metric: "missing-omit",
+            direction: "max",
+            target: 1,
+            tolerance: 0,
+            scenario: "base",
+            minimumSamples: 1,
+            source: "kernel",
+            owner: "quality",
+            unavailable: "omit-claim",
+        },
+    ],
+};
+test("scorecard applies direction, tolerance, sample, and unavailable rules mechanically", () => {
+    const measurements = [
+        { metric: "minimum", scenario: "base", value: 88, samples: 2 },
+        { metric: "maximum", scenario: "base", value: 11, samples: 1 },
+        { metric: "exact-pass", scenario: "base", value: 5.5, samples: 1 },
+        { metric: "exact-fail", scenario: "base", value: 5.51, samples: 1 },
+        { metric: "undersampled-block", scenario: "base", value: 2, samples: 2 },
+        { metric: "undersampled-omit", scenario: "base", value: 2, samples: 2 },
+    ];
+    const byMetric = new Map(evaluateQualityScorecard(scorecard, measurements).map((item) => [item.metric, item]));
+    assert.equal(byMetric.get("minimum")?.decision, "pass");
+    assert.equal(byMetric.get("maximum")?.decision, "pass");
+    assert.equal(byMetric.get("exact-pass")?.decision, "pass");
+    assert.equal(byMetric.get("exact-fail")?.decision, "fail");
+    assert.equal(byMetric.get("undersampled-block")?.decision, "fail");
+    assert.equal(byMetric.get("undersampled-omit")?.decision, "omitted");
+    assert.equal(byMetric.get("missing-block")?.decision, "fail");
+    assert.equal(byMetric.get("missing-omit")?.decision, "omitted");
+});
+test("scorecard evaluation and Markdown ordering are deterministic", () => {
+    const measurements = [
+        { metric: "maximum", scenario: "base", value: 12, samples: 1 },
+        { metric: "minimum", scenario: "base", value: 87.99, samples: 2 },
+    ];
+    const reversed = { ...scorecard, rules: [...scorecard.rules].reverse() };
+    assert.deepEqual(evaluateQualityScorecard(scorecard, measurements), evaluateQualityScorecard(reversed, measurements));
+    const rendered = renderQualityScorecardEvaluation(scorecard, measurements);
+    assert.equal(rendered, renderQualityScorecardEvaluation(reversed, [...measurements].reverse()));
+    assert.match(rendered, /\| maximum \| base \| max \| 10 \| 1 \| 12 \| 1\/1 \| FAIL \|/);
+    assert.match(rendered, /\| minimum \| base \| min \| 90 \| 2 \| 87.99 \| 2\/2 \| FAIL \|/);
+});
+//# sourceMappingURL=scorecard.test.js.map

package/dist/test/scorecard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorecard.test.js","sourceRoot":"","sources":["../../src/test/scorecard.test.ts"],"names":[],"mappings":"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"}

package/dist/test/semantic-diff.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=semantic-diff.test.d.ts.map

package/dist/test/semantic-diff.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-diff.test.d.ts","sourceRoot":"","sources":["../../src/test/semantic-diff.test.ts"],"names":[],"mappings":""}

package/dist/test/semantic-diff.test.js

@@ -0,0 +1,19 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { renderSemanticDiff, semanticDiff } from "../index.js";
+test("semantic diff returns sorted JSON Pointer leaf paths", () => {
+    const result = semanticDiff({ retained: 1, removed: { "a/b": true }, changed: "old", array: [1] }, { retained: 1, added: { "x~y": true }, changed: "new", array: [1, 2] });
+    assert.deepEqual(result.added, ["/added/x~0y", "/array/1"]);
+    assert.deepEqual(result.removed, ["/removed/a~1b"]);
+    assert.deepEqual(result.changed, [{ path: "/changed", before: "old", after: "new" }]);
+});
+test("semantic diff Markdown is stable and escapes table content", () => {
+    const diff = semanticDiff({ value: "left|\u0001" }, { value: "right\nline" });
+    const first = renderSemanticDiff(diff);
+    const second = renderSemanticDiff(diff);
+    assert.equal(first, second);
+    assert.match(first, /left\\\|\\\\u0001/);
+    assert.match(first, /right\\\\nline/);
+    assert.doesNotMatch(first, /\u0001/);
+});
+//# sourceMappingURL=semantic-diff.test.js.map

package/dist/test/semantic-diff.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-diff.test.js","sourceRoot":"","sources":["../../src/test/semantic-diff.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,MAAM,GAAG,YAAY,CACzB,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EACrE,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CACvE,CAAC;IAEF,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;IAC5D,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACxF,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;IACtE,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAExC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACtC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@apexops/renderers",
+  "version": "0.10.0-next.0",
+  "description": "Deterministic Markdown renderers for APEX vNext contracts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jonathan-vella/apex-vnext.git",
+    "directory": "packages/renderers"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "tag": "next"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@apexops/contracts": "0.10.0-next.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "node --test dist/test/*.test.js"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}