@sentropic/track 0.85.11 → 0.85.14

package/dist/report/html.js

@@ -0,0 +1,76 @@
+// report-revamp §C — the DS-compatible HTML FRAGMENT renderer for the conductor report. Implements the
+// shared `DsFragmentPresenter` contract (present.ts) — the SAME presenter path as focus's `renderHtml`, not
+// a second engine: a self-contained `<article>` with namespaced classes + `data-*` variants, every
+// interpolation escaped (§A4), the whole fragment run through the host `sanitizeHtml` hook. It consumes the
+// SAME `ReportView` the JSON path exposes (tables + directives + keystone), so the HTML and the table render
+// share one derived model. The design system supplies the CSS/tokens and embeds the fragment.
+import { buildWpConductorView, directivePhrase } from './format.js';
+import { escapeHtml, IDENTITY_HOOKS } from './present.js';
+/** One conductor table → a `<section>` with a `<table class="report-table">`; cells escaped (§A4). */
+function renderTable(t) {
+    const head = t.columns.map((c) => `<th>${escapeHtml(c.label)}</th>`).join('');
+    const body = t.rows
+        .map((row) => `<tr>${t.columns.map((c) => `<td>${escapeHtml(row[c.id] ?? '')}</td>`).join('')}</tr>`)
+        .join('');
+    return (`<section class="report-section" data-section="${escapeHtml(t.id)}">` +
+        `<h2>${escapeHtml(t.title)}</h2>` +
+        `<table class="report-table"><thead><tr>${head}</tr></thead><tbody>${body}</tbody></table>` +
+        `</section>`);
+}
+/**
+ * The machine-attributed directive list — the DS-consumable variant surface (mirrors focus's
+ * `data-annotation`/`data-modality` convention): each `<li>` carries `data-mode`, `data-advice-kind`,
+ * `data-rank`, `data-step`, and (when present) `data-gate`/`data-blocked-by`/`data-fan-in`, so the design
+ * system styles chips WITHOUT parsing the phrase. The rendered phrase reuses `directivePhrase` (same bytes
+ * as the table). Every interpolated title/ref is escaped.
+ */
+function renderDirectives(dirs) {
+    if (dirs.length === 0)
+        return '';
+    const items = dirs
+        .map((d) => {
+        const g = d.gate;
+        const attrs = [
+            `data-mode="${escapeHtml(d.mode)}"`,
+            `data-advice-kind="${escapeHtml(d.adviceKind)}"`,
+            `data-rank="${escapeHtml(d.rank)}"`,
+            `data-step="${escapeHtml(d.step.code)}"`,
+            ...(g?.code !== undefined ? [`data-gate="${escapeHtml(g.code)}"`] : []),
+            ...(g?.blockedBy !== undefined ? [`data-blocked-by="${escapeHtml(g.blockedBy)}"`] : []),
+            ...(d.facts.fanIn !== undefined ? [`data-fan-in="${escapeHtml(String(d.facts.fanIn))}"`] : []),
+        ].join(' ');
+        const subject = escapeHtml(d.target.title ?? d.target.id);
+        const blocker = g?.blockedByTitle !== undefined
+            ? ` <span class="report-directive-blocker">bloqué par « ${escapeHtml(g.blockedByTitle)} »</span>`
+            : '';
+        return (`<li class="report-directive" ${attrs}>` +
+            `<strong class="report-directive-subject">${subject}</strong> — ` +
+            `<span class="report-directive-phrase">${escapeHtml(directivePhrase(d))}</span>${blocker}</li>`);
+    })
+        .join('');
+    return `<section class="report-section" data-section="directives"><h2>Directives</h2><ul class="report-directives">${items}</ul></section>`;
+}
+function renderHeader(view) {
+    const k = view.keystone;
+    const keystone = k !== undefined
+        ? ` · <span class="report-keystone" data-keystone-id="${escapeHtml(k.id)}" data-blocks="${escapeHtml(String(k.blocks))}">goulot: ${escapeHtml(k.title)} (bloque ${escapeHtml(String(k.blocks))})</span>`
+        : '';
+    return (`<header class="report-header"><h1>Report — conducteur</h1>` +
+        `<p class="report-meta">vue: <code>${escapeHtml(view.kind)}</code> · locale: ${escapeHtml(view.locale)}${keystone}</p></header>`);
+}
+/** Render a `ReportView` to a sanitized, DS-styled `<article>` fragment (the shared presenter, §C). */
+export const renderReportHtml = (view, hooks = IDENTITY_HOOKS) => {
+    const html = `<article class="report-document" data-kind="${escapeHtml(view.kind)}" data-locale="${escapeHtml(view.locale)}">` +
+        renderHeader(view) +
+        view.tables.map(renderTable).join('') +
+        renderDirectives(view.directives) +
+        `<section class="report-section" data-section="recommandation"><h2>Recommandation</h2>` +
+        `<p class="report-recommendation">${escapeHtml(view.generalRecommendation)}</p></section>` +
+        `</article>`;
+    return hooks.sanitizeHtml(html);
+};
+/** Build the conductor view from the forest and render its DS fragment (the CLI `--format html` path). */
+export function formatWpConductorHtml(tree, decisions = [], hooks = IDENTITY_HOOKS) {
+    return renderReportHtml(buildWpConductorView(tree, decisions), hooks);
+}
+//# sourceMappingURL=html.js.map

package/dist/report/html.js.map

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

package/dist/report/present.d.ts

@@ -0,0 +1,28 @@
+/** Convert markdown source to an HTML string. Host-supplied (e.g. `marked`) — only prose models need it. */
+export type RenderMarkdown = (markdown: string) => string;
+/** Sanitize an HTML string before emission. Host-supplied (e.g. DOMPurify / sanitize-html). */
+export type SanitizeHtml = (html: string) => string;
+/**
+ * Hooks a DS fragment renderer needs from the host. A SUPERSET of focus's `HtmlRenderHooks`:
+ * `sanitizeHtml` is always required (the fragment is run through it before emission); `renderMarkdown` is
+ * OPTIONAL and only consulted by prose-bearing models (the dossier), so the report renderer never needs it.
+ */
+export interface DsFragmentHooks {
+    readonly sanitizeHtml: SanitizeHtml;
+    readonly renderMarkdown?: RenderMarkdown;
+}
+/** The shared presenter signature: a model → a sanitized, DS-styled `<article>` fragment string. */
+export type DsFragmentPresenter<Model> = (model: Model, hooks: DsFragmentHooks) => string;
+/**
+ * Minimal HTML text escaping for attribute/text content the renderer itself emits (§A4 — every interpolated
+ * user title/ref MUST pass through this before landing in the fragment, so a forged title cannot inject
+ * markup). Byte-for-byte the same escape focus's renderer uses, so the two fragments are consistent.
+ */
+export declare const escapeHtml: (value: string) => string;
+/**
+ * The trusted-local-CLI hooks (identity sanitize): track's `--format html` is a local surface, not untrusted
+ * network output — the renderer already escapes every interpolation, so identity sanitize is safe here. An
+ * L4/web host (the Svelte app) supplies a REAL DOMPurify/sanitize-html hook instead.
+ */
+export declare const IDENTITY_HOOKS: DsFragmentHooks;
+//# sourceMappingURL=present.d.ts.map

package/dist/report/present.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"present.d.ts","sourceRoot":"","sources":["../../src/report/present.ts"],"names":[],"mappings":"AAeA,4GAA4G;AAC5G,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;AAEzD,+FAA+F;AAC/F,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;AAEnD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CACzC;AAED,oGAAoG;AACpG,MAAM,MAAM,mBAAmB,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,KAAK,MAAM,CAAA;AAEzF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAMhB,CAAA;AAE3B;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,eAA4D,CAAA"}

package/dist/report/present.js

@@ -0,0 +1,32 @@
+// report-revamp §C — the SHARED design-system fragment contract (the "embeddable-view contract" of
+// M5-decision-presentation-DESIGN §3.3). The report and the focus dossier are the SAME presenter: both emit
+// a self-contained, DS-styled `<article>` FRAGMENT (structure + namespaced classes + `data-*` variants, NO
+// inline styling, NO tokens embedded), with markdown/sanitization INJECTED by the host. The design system
+// supplies the CSS (`--st-*` tokens) and wrapping; a fragment is embeddable in the Svelte app OR any host.
+//
+// This module defines the contract ONCE. Two implementations conform to it:
+//   • focus  — `@sentropic/focus` `renderHtml(DecisionDossierDocument, HtmlRenderHooks)` (the dossier side),
+//              already vendored in `../focus-vendor/render/html.js`;
+//   • report — `renderReportHtml(ReportView, DsFragmentHooks)` (this repo, `./html.ts`).
+// Both take `(model, hooks) => sanitizedFragment` and share the SAME hooks shape (a superset of focus's
+// `HtmlRenderHooks`: `renderMarkdown` is OPTIONAL because a report carries no prose). The full Svelte app
+// (design-system-svelte, focus L-D) consumes this contract — it is the cross-repo DS piece, out of scope
+// here; this repo ships the DS-compatible FRAGMENT that app embeds.
+/**
+ * Minimal HTML text escaping for attribute/text content the renderer itself emits (§A4 — every interpolated
+ * user title/ref MUST pass through this before landing in the fragment, so a forged title cannot inject
+ * markup). Byte-for-byte the same escape focus's renderer uses, so the two fragments are consistent.
+ */
+export const escapeHtml = (value) => value
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
+/**
+ * The trusted-local-CLI hooks (identity sanitize): track's `--format html` is a local surface, not untrusted
+ * network output — the renderer already escapes every interpolation, so identity sanitize is safe here. An
+ * L4/web host (the Svelte app) supplies a REAL DOMPurify/sanitize-html hook instead.
+ */
+export const IDENTITY_HOOKS = { sanitizeHtml: (h) => h };
+//# sourceMappingURL=present.js.map

package/dist/report/present.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"present.js","sourceRoot":"","sources":["../../src/report/present.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,4GAA4G;AAC5G,2GAA2G;AAC3G,0GAA0G;AAC1G,2GAA2G;AAC3G,EAAE;AACF,4EAA4E;AAC5E,6GAA6G;AAC7G,qEAAqE;AACrE,yFAAyF;AACzF,wGAAwG;AACxG,0GAA0G;AAC1G,yGAAyG;AACzG,oEAAoE;AAqBpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAClD,KAAK;KACF,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;KACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;KACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;KACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;KACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAE3B;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoB,EAAE,YAAY,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentropic/track",
-  "version": "0.85.11",
+  "version": "0.85.14",
   "description": "Typed product-backlog and spec/plan/UAT system of record for the sentropic ecosystem (record-only MVP).",
   "license": "MIT",
   "author": "Fabien Antoine",
@@ -37,7 +37,11 @@
     ".": "./dist/index.js",
     "./read": "./dist/read/index.js",
     "./ingest": "./dist/ingest/index.js",
-    "./seam": "./dist/ingest/seam-schema.js"
+    "./seam": "./dist/ingest/seam-schema.js",
+    "./report/friendly": {
+      "types": "./dist/report/friendly.d.ts",
+      "import": "./dist/report/friendly.js"
+    }
   },
   "files": [
     "dist",