@anselmdk/feature-spec-md 0.1.0 → 0.1.1-rc.1

package/dist/reportTemplate.js

@@ -0,0 +1,154 @@
+import { html } from "./html.js";
+import { screenshotKey } from "./screenshots.js";
+/** Render a complete self-contained feature spec report as HTML. */
+export function renderHtmlReport(specs, options = {}) {
+    const title = options.title ?? "Feature Spec Report";
+    const issues = options.validationIssues ?? [];
+    const screenshots = options.screenshots ?? [];
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <title>${html(title)}</title>
+    <style>
+      body{font-family:system-ui,sans-serif;max-width:1180px;margin:0 auto;padding:40px 24px;color:#1f2328}
+      .panel{border:1px solid #d0d7de;border-radius:8px;padding:20px;margin:18px 0}
+      .ok{color:#1a7f37}.missing,.error{color:#cf222e}.warning{color:#9a6700}
+      .badge{border:1px solid #d0d7de;border-radius:999px;padding:2px 8px;font-size:12px;white-space:nowrap}
+      .feature-header{display:flex;gap:12px;align-items:center;justify-content:space-between}
+      .scenario{border:1px solid #d0d7de;border-radius:8px;margin:12px 0;background:#fff}
+      .scenario summary{cursor:pointer;padding:14px 16px;font-weight:600}
+      .scenario-body{padding:0 16px 16px}
+      .step{border-left:3px solid #d0d7de;margin:12px 0;padding:2px 0 2px 12px}
+      .step p{margin:8px 0}
+      .screenshots{display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:12px;margin:10px 0 14px}
+      .screenshot{border:1px solid #d0d7de;border-radius:8px;overflow:hidden;background:#f6f8fa}
+      .screenshot img{display:block;width:100%;height:auto}
+      .screenshot figcaption{font-size:12px;padding:8px;color:#57606a}
+    </style>
+  </head>
+  <body>
+    <h1>${html(title)}</h1>
+    <p>Generated ${html(options.generatedAt ?? new Date().toISOString())}.</p>
+    ${renderIssues(issues)}
+    ${renderModels(options.models ?? [], options.coverage)}
+    ${specs.map((spec) => renderSpec(spec, options.coverage, screenshots)).join("\n")}
+  </body>
+</html>`;
+}
+function renderIssues(issues) {
+    if (!issues.length) {
+        return `<section class="panel"><h2>Validation</h2><p class="ok">No validation issues found.</p></section>`;
+    }
+    return `<section class="panel"><h2>Validation</h2><ul>${issues
+        .map((issue) => `<li class="${issue.severity}"><code>${html(`${issue.filePath ?? ""}${issue.line ? `:${issue.line}` : ""}`)}</code> ${html(issue.message)}</li>`)
+        .join("")}</ul></section>`;
+}
+function renderModels(models, coverage) {
+    if (!models.length)
+        return "";
+    const modelCoverage = coverage?.modelCoverage ?? [];
+    return `<section class="panel">
+  <h2>Models</h2>
+  ${models
+        .map((model) => `<section>
+    <div class="feature-header">
+      <h3>${html(model.frontmatter.id)} ${html(model.title)}</h3>
+      <span class="badge">${html(model.frontmatter.status ?? "draft")}</span>
+    </div>
+    <p>${html(model.purpose)}</p>
+    <h4>Model</h4>
+    <ul>${model.modelItems
+        .map((item) => {
+        const coverageItem = modelCoverage.find((candidate) => candidate.id === item.id);
+        return `<li><code>${html(item.id)}</code>: ${html(item.title)} ${coverageBadge(coverageItem?.covered)}</li>`;
+    })
+        .join("")}</ul>
+    ${model.rules.length
+        ? `<h4>Rules</h4><ul>${model.rules
+            .map((rule) => `<li><code>${html(rule.id)}</code>: ${html(rule.text)}</li>`)
+            .join("")}</ul>`
+        : ""}
+  </section>`)
+        .join("\n")}
+</section>`;
+}
+function renderSpec(spec, coverage, screenshots = []) {
+    const screenshotsByLine = groupScreenshotsByLine(screenshots);
+    const ruleCoverage = coverage?.ruleCoverage ?? [];
+    const scenarioCoverage = coverage?.scenarioCoverage ?? [];
+    return `<section class="panel">
+  <div class="feature-header">
+    <h2>${html(spec.frontmatter.id)} ${html(spec.title)}</h2>
+    <span class="badge">${html(spec.frontmatter.status ?? "draft")}</span>
+  </div>
+  <p>${html(spec.purpose)}</p>
+  <h3>Rules</h3>
+  <ul>${spec.rules
+        .map((rule) => {
+        const item = ruleCoverage.find((coverageItem) => coverageItem.id === rule.id);
+        return `<li><code>${html(rule.id)}</code>: ${html(rule.text)} ${coverageBadge(item?.covered, ruleScenarioShortIds(item, scenarioCoverage))}</li>`;
+    })
+        .join("")}</ul>
+  <h3>Scenarios</h3>
+  ${spec.scenarios
+        .map((scenario) => {
+        const screenshotCount = scenario.steps.reduce((count, step) => count +
+            (screenshotsByLine.get(screenshotKey(spec.filePath, step.line))
+                ?.length ?? 0), 0);
+        return `<details class="scenario">
+    <summary><code>${html(scenario.id)}</code>: ${html(scenario.title)} ${coverageBadge(scenarioCoverage.find((item) => item.id === scenario.id)?.covered)} <span class="badge">${screenshotCount} screenshot${screenshotCount === 1 ? "" : "s"}</span></summary>
+    <div class="scenario-body">${scenario.steps.map((step) => renderStep(spec, step, screenshotsByLine)).join("")}</div>
+  </details>`;
+    })
+        .join("\n")}
+</section>`;
+}
+function renderStep(spec, step, screenshotsByLine) {
+    const screenshots = screenshotsByLine.get(screenshotKey(spec.filePath, step.line)) ?? [];
+    const evidenceBadge = screenshots.length
+        ? `<span class="badge ok">${screenshots.length} screenshot${screenshots.length === 1 ? "" : "s"}</span>`
+        : `<span class="badge missing">missing screenshot</span>`;
+    return `<div class="step"><p><strong>${html(step.keyword)}</strong> ${html(step.text)} <span class="badge">line ${step.line}</span> ${evidenceBadge}</p>${renderScreenshots(screenshots)}</div>`;
+}
+function renderScreenshots(screenshots) {
+    if (!screenshots.length)
+        return "";
+    return `<div class="screenshots">${screenshots
+        .map((screenshot) => `<figure class="screenshot"><img src="${html(screenshot.path)}" alt="${html(screenshot.title ?? `Screenshot for ${screenshot.specPath}:${screenshot.line}`)}"><figcaption>${html(screenshot.title ?? `${screenshot.specPath}:${screenshot.line}`)}</figcaption></figure>`)
+        .join("")}</div>`;
+}
+function coverageBadge(covered, suffixes = []) {
+    return covered === undefined
+        ? ""
+        : covered
+            ? `<span class="badge ok">covered${suffixes.length ? ` ${suffixes.map(html).join(" ")}` : ""}</span>`
+            : `<span class="badge missing">missing coverage</span>`;
+}
+function ruleScenarioShortIds(ruleCoverage, scenarioCoverage) {
+    if (!ruleCoverage?.covered)
+        return [];
+    const scenarioIds = new Set();
+    for (const ruleReference of ruleCoverage.references) {
+        for (const scenario of scenarioCoverage) {
+            const coversRule = scenario.references.some((scenarioReference) => scenarioReference.filePath === ruleReference.filePath &&
+                scenarioReference.line === ruleReference.line);
+            if (coversRule)
+                scenarioIds.add(shortScenarioId(scenario.id));
+        }
+    }
+    return Array.from(scenarioIds).sort();
+}
+function shortScenarioId(id) {
+    return id.match(/-(S\d{3})$/)?.[1] ?? id;
+}
+function groupScreenshotsByLine(screenshots) {
+    const grouped = new Map();
+    for (const screenshot of screenshots) {
+        const key = screenshotKey(screenshot.specPath, screenshot.line);
+        grouped.set(key, [...(grouped.get(key) ?? []), screenshot]);
+    }
+    return grouped;
+}
+//# sourceMappingURL=reportTemplate.js.map

package/dist/reportTemplate.js.map

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

package/dist/screenshots.d.ts

@@ -0,0 +1,6 @@
+import type { SpecScreenshot } from "./types.js";
+/** Load screenshot evidence manifests and normalize entries for report rendering. */
+export declare function collectSpecScreenshots(patterns: string[]): Promise<SpecScreenshot[]>;
+export declare function screenshotKey(filePath: string, line: number): string;
+export declare function normalizeFilePath(filePath: string): string;
+//# sourceMappingURL=screenshots.d.ts.map

package/dist/screenshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots.d.ts","sourceRoot":"","sources":["../src/screenshots.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qFAAqF;AACrF,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,6BAgB9D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAE3D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,UAEjD"}

package/dist/screenshots.js

@@ -0,0 +1,49 @@
+import { readFile } from "node:fs/promises";
+import { expandArtifactPatterns } from "./filePatterns.js";
+/** Load screenshot evidence manifests and normalize entries for report rendering. */
+export async function collectSpecScreenshots(patterns) {
+    const screenshots = [];
+    for (const file of await expandArtifactPatterns(patterns)) {
+        const parsed = JSON.parse(await readFile(file, "utf8"));
+        const entries = Array.isArray(parsed)
+            ? parsed
+            : isRecord(parsed) && Array.isArray(parsed.screenshots)
+                ? parsed.screenshots
+                : [];
+        for (const entry of entries) {
+            const screenshot = normalizeScreenshot(entry);
+            if (screenshot)
+                screenshots.push(screenshot);
+        }
+    }
+    return screenshots;
+}
+export function screenshotKey(filePath, line) {
+    return `${normalizeFilePath(filePath)}:${line}`;
+}
+export function normalizeFilePath(filePath) {
+    return filePath.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+function normalizeScreenshot(value) {
+    if (!isRecord(value))
+        return null;
+    const specPath = value.specPath;
+    const line = value.line;
+    const imagePath = value.path ?? value.imagePath;
+    if (typeof specPath !== "string" ||
+        typeof line !== "number" ||
+        typeof imagePath !== "string") {
+        return null;
+    }
+    return {
+        specPath: normalizeFilePath(specPath),
+        line,
+        path: imagePath,
+        title: typeof value.title === "string" ? value.title : undefined,
+        testPath: typeof value.testPath === "string" ? value.testPath : undefined,
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=screenshots.js.map

package/dist/screenshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots.js","sourceRoot":"","sources":["../src/screenshots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAkB;IAC7D,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,MAAM,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;QACnE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACnC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;gBACrD,CAAC,CAAC,MAAM,CAAC,WAAW;gBACpB,CAAC,CAAC,EAAE,CAAC;QAET,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,UAAU;gBAAE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,IAAY;IAC1D,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC;IAChD,IACE,OAAO,QAAQ,KAAK,QAAQ;QAC5B,OAAO,IAAI,KAAK,QAAQ;QACxB,OAAO,SAAS,KAAK,QAAQ,EAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QACrC,IAAI;QACJ,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAChE,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/specDocuments.d.ts

@@ -0,0 +1,72 @@
+import type { DesignSpec, FeatureSpec, ModelSpec, SpecDocument, StackSpec, TestReference, ValidationIssue } from "./types.js";
+type SpecKind = "model" | "feature" | "stack" | "design";
+export declare function parseSpecDocument(source: string, options?: {
+    filePath?: string;
+    kind?: SpecKind;
+}): SpecDocument;
+export declare function parseModelSpec(source: string, options?: {
+    filePath?: string;
+}): ModelSpec;
+export declare function parseStackSpec(source: string, options?: {
+    filePath?: string;
+}): StackSpec;
+export declare function parseDesignSpec(source: string, options?: {
+    filePath?: string;
+}): DesignSpec;
+export declare function loadSpecDocuments(patterns: string[]): Promise<SpecDocument[]>;
+export declare function parseSpecTestReferences(source: string, filePath?: string): TestReference[];
+export declare function collectSpecTestReferences(patterns: string[]): Promise<TestReference[]>;
+export declare function validateModelSpec(spec: ModelSpec): ValidationIssue[];
+export declare function validateStackSpec(spec: StackSpec): ValidationIssue[];
+export declare function validateDesignSpec(spec: DesignSpec): ValidationIssue[];
+export declare function validateSpecDocument(spec: SpecDocument): ValidationIssue[];
+export declare function validateSpecGraph(documents: SpecDocument[]): ValidationIssue[];
+export declare function buildSpecCoverageSummary(documents: SpecDocument[], references: TestReference[]): {
+    modelCoverage: {
+        id: string;
+        title: string;
+        filePath: string;
+        line: number;
+        references: TestReference[];
+        covered: boolean;
+    }[];
+    orphanModelReferences: TestReference[];
+    ruleCoverage: import("./types.js").CoverageItem[];
+    scenarioCoverage: import("./types.js").CoverageItem[];
+    orphanRuleReferences: TestReference[];
+    orphanScenarioReferences: TestReference[];
+};
+export declare function checkSpecDocuments(options: {
+    specs: string[];
+    tests?: string[];
+    requireModelCoverage?: boolean;
+    requireRuleCoverage?: boolean;
+    requireScenarioCoverage?: boolean;
+}): Promise<{
+    documents: SpecDocument[];
+    models: ModelSpec[];
+    features: FeatureSpec[];
+    stacks: StackSpec[];
+    designs: DesignSpec[];
+    specs: FeatureSpec[];
+    validationIssues: ValidationIssue[];
+    coverage: {
+        modelCoverage: {
+            id: string;
+            title: string;
+            filePath: string;
+            line: number;
+            references: TestReference[];
+            covered: boolean;
+        }[];
+        orphanModelReferences: TestReference[];
+        ruleCoverage: import("./types.js").CoverageItem[];
+        scenarioCoverage: import("./types.js").CoverageItem[];
+        orphanRuleReferences: TestReference[];
+        orphanScenarioReferences: TestReference[];
+    } | undefined;
+    coverageIssues: ValidationIssue[];
+    ok: boolean;
+}>;
+export {};
+//# sourceMappingURL=specDocuments.d.ts.map

package/dist/specDocuments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specDocuments.d.ts","sourceRoot":"","sources":["../src/specDocuments.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEX,SAAS,EACT,YAAY,EAEZ,SAAS,EACT,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,KAAK,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAO,GACnD,YAAY,CASd;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,SAAS,CAaX;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,SAAS,CAgBX;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,UAAU,CAiBZ;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,2BAMzD;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,SAAa,GACpB,aAAa,EAAE,CAUjB;AAED,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,4BAMjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CA8BpE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAWpE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,EAAE,CAgBtE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,EAAE,CAK1E;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,eAAe,EAAE,CAmC9E;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,YAAY,EAAE,EACzB,UAAU,EAAE,aAAa,EAAE;;;;;;;;;;;;;;EAsB5B;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBA"}