@ifc-lite/sdk 9.0.0 → 9.3.0

package/dist/review/portable-automation-provenance.js.map

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

package/dist/review/portable-ids-report.d.ts

@@ -0,0 +1,125 @@
+/**
+ * The validation report block's saved shape (#5125, #6372), split out of
+ * `types.ts` (which re-exports everything here) to keep that file under its
+ * module-size budget.
+ *
+ * One block kind (`'ids-report'`) serves both validation sources: an IDS run
+ * and an information-validation (rule set) run. `sourceKind` says which one
+ * produced the snapshot. It is optional and additive (#6372): every block
+ * saved before it existed was labelled as IDS, so an absent `sourceKind`
+ * reads as `'ids'` and the document format version stays the same.
+ */
+import { type SavedValidationElements } from './portable-validation-evidence.js';
+import { type BlockTitle } from './portable-report-metadata.js';
+import type { PortableReportValidationError as DocumentValidationError } from './portable-report-metadata.js';
+import { type ReportProvenance } from './portable-report-metadata.js';
+/** Which engine produced a report block's snapshot; mirrors `ValidationSource['kind']`. */
+export type ReportSourceKind = 'ids' | 'rules';
+/**
+ * One check (IDS specification, or information-validation rule) inside a
+ * report block (#5125): the counts and description taken straight off
+ * `SpecificationResult` — `shortDescription` is the specification's `name`,
+ * `longDescription` its optional `description`, so neither is invented here.
+ *
+ * The optional fields below are only ever written for an information
+ * validation snapshot (#6372); an IDS snapshot keeps its original shape.
+ */
+export interface IdsReportCheckSummary {
+    id: string;
+    shortDescription: string;
+    longDescription?: string;
+    checked: number;
+    passed: number;
+    failed: number;
+    /** 0-100, floor-rounded; 100 when `checked` is 0 (no applicable entities) — matches `SpecificationResult.passRate`. */
+    passRate: number;
+    rules: IdsReportRuleSummary[];
+    /** `'warning'`: this check's failures are warnings, counted apart from failures (#6372). Absent means `'error'`. */
+    severity?: 'error' | 'warning';
+    /** The engine could not evaluate this check (`SpecificationResult.error`); printed instead of counts (#6372). */
+    error?: string;
+    /** Set-level results of a `unique` / `aggregate` rule (`SpecificationResult.setResults`, #6372). */
+    sets?: IdsReportSetRow[];
+    /** The engine capped `sets` before every set was evaluated (`setResultsTruncated`). */
+    setsTruncated?: boolean;
+    /** How many applicable elements the rule found against its declared cardinality (#6372). */
+    cardinality?: IdsReportCardinality;
+}
+/** A requirement under one IDS specification. Null metrics mean the source
+ * report omitted passing entities, so an exact per-rule count is unavailable. */
+export interface IdsReportRuleSummary {
+    id: string;
+    /** Bare attribute / property name (#6470), for the compact layout. Absent in older documents. */
+    name?: string;
+    shortDescription: string;
+    longDescription?: string;
+    checked: number;
+    passed: number | null;
+    failed: number | null;
+    passRate: number | null;
+}
+/** One uniqueness / aggregate group result, as `SetResult` reports it (without its member list). */
+export interface IdsReportSetRow {
+    /** unique: the shared value; aggregate: fn + subject, e.g. `sum(Qto_….NetFloorArea)`. */
+    label: string;
+    /** The rendered groupBy key (parent name, storey name…), when the rule groups; `''` is a blank grouping value, not "ungrouped". */
+    groupKey?: string;
+    actual: string;
+    expected: string;
+    passed: boolean;
+}
+/** `IDSCardinalityResult` reduced to its numbers, so every surface words it in its own language. */
+export interface IdsReportCardinality {
+    passed: boolean;
+    actual: number;
+    min?: number;
+    max?: number;
+}
+/** `compact`: one bar row per check / requirement. `long`: full requirement text, never truncated. */
+export type IdsReportVariant = 'compact' | 'long';
+export declare const IDS_REPORT_VARIANTS: readonly IdsReportVariant[];
+/**
+ * A frozen snapshot of an IDS / information-validation report (#5125, #6372),
+ * taken from the live `ValidationReport` when the block is added or refreshed
+ * — like a table block's list copy, it travels with the document instead of
+ * reading the store, so a saved document still prints the run that produced it.
+ */
+export interface IdsReportBlock extends ReportProvenance, BlockTitle {
+    kind: 'ids-report';
+    id: string;
+    /** Layout (#6470). Absent in documents saved before it existed, which keep printing the original layout (one truncated line per field) until the author picks one. */
+    variant?: IdsReportVariant;
+    /**
+     * Compact layout only (#6560): print one bar row per specification and leave out its
+     * requirement rows. Optional and additive, so the document format version is unchanged;
+     * a viewer that supports the document format but predates this field ignores it
+     * and prints the full compact report.
+     */
+    specificationsOnly?: boolean;
+    /** Optional ring benchmark (#6552). Absent retains existing document output. */
+    benchmarks?: boolean;
+    /** Whole-block size, 0.5-2 (#6548); absent is 1. */
+    scale?: number;
+    /** Which engine produced the snapshot (#6372). Absent means `'ids'`: every block saved before this field existed was labelled IDS. */
+    sourceKind?: ReportSourceKind;
+    /** IDS document title, or rule-set name, printed in the block's heading. */
+    sourceName: string;
+    /** When the snapshotted run finished (`ValidationReport.timestamp`, ISO). */
+    generatedAt: string;
+    /** `failed` excludes warning-severity failures, which `warnings` counts (#6372; absent on IDS snapshots). */
+    summary: {
+        checked: number;
+        passed: number;
+        failed: number;
+        passRate: number;
+        warnings?: number;
+    };
+    checks: IdsReportCheckSummary[];
+    /** Optional immutable element failures; absent in older count-only snapshots (#7091). */
+    elementEvidence?: SavedValidationElements;
+}
+/** The source a report block was snapshotted from; a block saved before #6372 has none and is IDS. */
+export declare function reportBlockSourceKind(block: Pick<IdsReportBlock, 'sourceKind'>): ReportSourceKind;
+/** Structural check of a report block (#5125, #6372): a finite, non-negative count and a 0-100 pass rate at both the block and every check. */
+export declare function validateIdsReportBlock(block: Record<string, unknown>, at: string, errors: DocumentValidationError[]): void;
+//# sourceMappingURL=portable-ids-report.d.ts.map

package/dist/review/portable-ids-report.d.ts.map

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

package/dist/review/portable-ids-report.js

@@ -0,0 +1,124 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * The validation report block's saved shape (#5125, #6372), split out of
+ * `types.ts` (which re-exports everything here) to keep that file under its
+ * module-size budget.
+ *
+ * One block kind (`'ids-report'`) serves both validation sources: an IDS run
+ * and an information-validation (rule set) run. `sourceKind` says which one
+ * produced the snapshot. It is optional and additive (#6372): every block
+ * saved before it existed was labelled as IDS, so an absent `sourceKind`
+ * reads as `'ids'` and the document format version stays the same.
+ */
+import { validateSavedValidationElements } from './portable-validation-evidence.js';
+import { validateBlockTitle } from './portable-report-metadata.js';
+import { validateReportProvenance } from './portable-report-metadata.js';
+export const IDS_REPORT_VARIANTS = ['compact', 'long'];
+/** The source a report block was snapshotted from; a block saved before #6372 has none and is IDS. */
+export function reportBlockSourceKind(block) {
+    return block.sourceKind ?? 'ids';
+}
+const isRecord = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const isString = (v) => typeof v === 'string';
+const isCount = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0;
+const isRate = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0 && v <= 100;
+function validateCheckExtras(check, checkAt, errors) {
+    if (check.severity !== undefined && check.severity !== 'error' && check.severity !== 'warning')
+        errors.push({ path: `${checkAt}.severity`, message: 'expected error | warning' });
+    if (check.error !== undefined && !isString(check.error))
+        errors.push({ path: `${checkAt}.error`, message: 'expected a string' });
+    if (check.setsTruncated !== undefined && typeof check.setsTruncated !== 'boolean')
+        errors.push({ path: `${checkAt}.setsTruncated`, message: 'expected a boolean' });
+    if (check.sets !== undefined) {
+        if (!Array.isArray(check.sets))
+            errors.push({ path: `${checkAt}.sets`, message: 'expected an array' });
+        else
+            check.sets.forEach((set, k) => {
+                const ok = isRecord(set) && isString(set.label) && isString(set.actual) && isString(set.expected) && typeof set.passed === 'boolean'
+                    && (set.groupKey === undefined || isString(set.groupKey));
+                if (!ok)
+                    errors.push({ path: `${checkAt}.sets[${k}]`, message: 'expected { label, actual, expected: strings; passed: boolean; groupKey?: string }' });
+            });
+    }
+    const cardinality = check.cardinality;
+    if (cardinality !== undefined) {
+        const ok = isRecord(cardinality) && typeof cardinality.passed === 'boolean' && isCount(cardinality.actual)
+            && (cardinality.min === undefined || isCount(cardinality.min)) && (cardinality.max === undefined || isCount(cardinality.max));
+        if (!ok)
+            errors.push({ path: `${checkAt}.cardinality`, message: 'expected { passed: boolean; actual, min?, max?: non-negative numbers }' });
+    }
+}
+/** Structural check of a report block (#5125, #6372): a finite, non-negative count and a 0-100 pass rate at both the block and every check. */
+export function validateIdsReportBlock(block, at, errors) {
+    validateReportProvenance(block, at, errors);
+    if (block.elementEvidence !== undefined)
+        validateSavedValidationElements(block.elementEvidence, `${at}.elementEvidence`, errors);
+    validateBlockTitle(block, at, errors);
+    if (block.sourceKind !== undefined && block.sourceKind !== 'ids' && block.sourceKind !== 'rules')
+        errors.push({ path: `${at}.sourceKind`, message: 'expected ids | rules' });
+    if (!isString(block.sourceName))
+        errors.push({ path: `${at}.sourceName`, message: 'expected a string' });
+    if (!isString(block.generatedAt))
+        errors.push({ path: `${at}.generatedAt`, message: 'expected a string' });
+    if (block.variant !== undefined && !IDS_REPORT_VARIANTS.includes(block.variant))
+        errors.push({ path: `${at}.variant`, message: `expected ${IDS_REPORT_VARIANTS.join(' | ')}` });
+    if (block.benchmarks !== undefined && typeof block.benchmarks !== 'boolean')
+        errors.push({ path: `${at}.benchmarks`, message: 'expected a boolean' });
+    if (block.specificationsOnly !== undefined && typeof block.specificationsOnly !== 'boolean')
+        errors.push({ path: `${at}.specificationsOnly`, message: 'expected a boolean' });
+    const summary = block.summary;
+    if (!isRecord(summary) || !isCount(summary.checked) || !isCount(summary.passed) || !isCount(summary.failed) || !isRate(summary.passRate)
+        || (summary.warnings !== undefined && !isCount(summary.warnings))) {
+        errors.push({ path: `${at}.summary`, message: 'expected { checked, passed, failed, warnings?: non-negative numbers; passRate: 0-100 }' });
+    }
+    if (!Array.isArray(block.checks)) {
+        errors.push({ path: `${at}.checks`, message: 'expected an array' });
+        return;
+    }
+    block.checks.forEach((check, i) => {
+        const checkAt = `${at}.checks[${i}]`;
+        if (!isRecord(check)) {
+            errors.push({ path: checkAt, message: 'expected an object' });
+            return;
+        }
+        if (!isString(check.id) || check.id.length === 0)
+            errors.push({ path: `${checkAt}.id`, message: 'expected a non-empty string' });
+        if (!isString(check.shortDescription))
+            errors.push({ path: `${checkAt}.shortDescription`, message: 'expected a string' });
+        if (check.longDescription !== undefined && !isString(check.longDescription))
+            errors.push({ path: `${checkAt}.longDescription`, message: 'expected a string' });
+        if (!isCount(check.checked) || !isCount(check.passed) || !isCount(check.failed))
+            errors.push({ path: `${checkAt}`, message: 'expected checked/passed/failed: non-negative numbers' });
+        if (!isRate(check.passRate))
+            errors.push({ path: `${checkAt}.passRate`, message: 'expected a number between 0 and 100' });
+        validateCheckExtras(check, checkAt, errors);
+        if (!Array.isArray(check.rules)) {
+            errors.push({ path: `${checkAt}.rules`, message: 'expected an array' });
+            return;
+        }
+        check.rules.forEach((rule, j) => {
+            const ruleAt = `${checkAt}.rules[${j}]`;
+            if (!isRecord(rule)) {
+                errors.push({ path: ruleAt, message: 'expected an object' });
+                return;
+            }
+            if (!isString(rule.id) || rule.id.length === 0)
+                errors.push({ path: `${ruleAt}.id`, message: 'expected a non-empty string' });
+            if (!isString(rule.shortDescription))
+                errors.push({ path: `${ruleAt}.shortDescription`, message: 'expected a string' });
+            if (rule.name !== undefined && !isString(rule.name))
+                errors.push({ path: `${ruleAt}.name`, message: 'expected a string' });
+            if (rule.longDescription !== undefined && !isString(rule.longDescription))
+                errors.push({ path: `${ruleAt}.longDescription`, message: 'expected a string' });
+            if (!isCount(rule.checked))
+                errors.push({ path: `${ruleAt}.checked`, message: 'expected a non-negative number' });
+            const unavailable = rule.passed === null && rule.failed === null && rule.passRate === null;
+            if (!unavailable && (!isCount(rule.passed) || !isCount(rule.failed) || !isRate(rule.passRate))) {
+                errors.push({ path: ruleAt, message: 'expected passed/failed: non-negative numbers and passRate: 0-100, or all null' });
+            }
+        });
+    });
+}
+//# sourceMappingURL=portable-ids-report.js.map

package/dist/review/portable-ids-report.js.map

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

package/dist/review/portable-manual-report.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The manual-validation report block's saved shape (#6401), kept beside
+ * `types.ts` (which composes it into `DocumentBlock`) the way the
+ * validation report block's types are.
+ *
+ * A frozen snapshot, like `ids-report`: the checklist's groups and checks,
+ * each check's verdict and comment, and the per-group counts, copied when
+ * the block is added or refreshed. It never reads the live checklist or
+ * the stored answers again, so a saved document prints the round that was
+ * recorded, and it travels with the `.ifclite-document.json` file.
+ */
+import { type BlockTitle } from './portable-report-metadata.js';
+import type { PortableReportValidationError as DocumentValidationError } from './portable-report-metadata.js';
+import { type ReportProvenance } from './portable-report-metadata.js';
+export type ManualReportVerdict = 'pass' | 'fail' | 'warning';
+/** The four disjoint buckets; a warning is its own bucket, never a pass. */
+export interface ManualReportCounts {
+    total: number;
+    pass: number;
+    fail: number;
+    warning: number;
+    unanswered: number;
+}
+export interface ManualReportItem {
+    id: string;
+    text: string;
+    description?: string;
+    /** `null`: not checked when the snapshot was taken. */
+    status: ManualReportVerdict | null;
+    comment?: string;
+}
+export interface ManualReportGroup {
+    id: string;
+    name: string;
+    counts: ManualReportCounts;
+    items: ManualReportItem[];
+}
+export interface ManualReportBlock extends ReportProvenance, BlockTitle {
+    kind: 'manual-report';
+    id: string;
+    /** The checklist's name, printed in the block's heading. */
+    checklistName: string;
+    /** Live instance used by explicit Refresh; embedded answers stay immutable. */
+    checklistId?: string;
+    /** Missing on older documents: their existing detailed layout. */
+    variant?: 'long' | 'compact';
+    /** Missing on older documents: display their existing rings and scores. */
+    benchmarks?: boolean;
+    /** Whole-block size, 0.5-2 (#6548); absent is 1. */
+    scale?: number;
+    /** The model the answers were recorded against, when there was one (display only). */
+    modelName?: string;
+    /**
+     * That model's source fingerprint, the key its answers are stored under:
+     * Refresh reads this model and no other. Absent when no model (or one
+     * without a fingerprint) was loaded; such a block follows the tab's pick.
+     */
+    modelFingerprint?: string;
+    /** When the snapshot was taken (ISO). */
+    generatedAt: string;
+    summary: ManualReportCounts;
+    groups: ManualReportGroup[];
+}
+/** Structural check of a manual report block (#6401), every problem with its JSON path. */
+export declare function validateManualReportBlock(block: Record<string, unknown>, at: string, errors: DocumentValidationError[]): void;
+//# sourceMappingURL=portable-manual-report.d.ts.map

package/dist/review/portable-manual-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-manual-report.d.ts","sourceRoot":"","sources":["../../src/review/portable-manual-report.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,KAAK,EAAE,6BAA6B,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC9G,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEhG,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE9D,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB,EAAE,UAAU;IACrE,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAeD,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAqD7H"}

package/dist/review/portable-manual-report.js

@@ -0,0 +1,121 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * The manual-validation report block's saved shape (#6401), kept beside
+ * `types.ts` (which composes it into `DocumentBlock`) the way the
+ * validation report block's types are.
+ *
+ * A frozen snapshot, like `ids-report`: the checklist's groups and checks,
+ * each check's verdict and comment, and the per-group counts, copied when
+ * the block is added or refreshed. It never reads the live checklist or
+ * the stored answers again, so a saved document prints the round that was
+ * recorded, and it travels with the `.ifclite-document.json` file.
+ */
+import { validateBlockTitle } from './portable-report-metadata.js';
+import { validateReportProvenance } from './portable-report-metadata.js';
+const isRecord = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const isString = (v) => typeof v === 'string';
+const isCount = (v) => typeof v === 'number' && Number.isInteger(v) && v >= 0;
+const VERDICTS = ['pass', 'fail', 'warning', null];
+/** Counts that are whole, non-negative, and whose four buckets sum to `total`. */
+function isCounts(v) {
+    return isRecord(v) && isCount(v.total) && isCount(v.pass) && isCount(v.fail) && isCount(v.warning) && isCount(v.unanswered)
+        && v.pass + v.fail + v.warning + v.unanswered === v.total;
+}
+const COUNTS_MESSAGE = 'expected { total, pass, fail, warning, unanswered: non-negative integers; the four buckets sum to total }';
+/** Structural check of a manual report block (#6401), every problem with its JSON path. */
+export function validateManualReportBlock(block, at, errors) {
+    validateReportProvenance(block, at, errors);
+    validateBlockTitle(block, at, errors);
+    if (!isString(block.checklistName))
+        errors.push({ path: `${at}.checklistName`, message: 'expected a string' });
+    if (block.checklistId !== undefined && !(isString(block.checklistId) && block.checklistId.trim()))
+        errors.push({ path: `${at}.checklistId`, message: 'expected a nonblank string' });
+    if (block.variant !== undefined && block.variant !== 'long' && block.variant !== 'compact')
+        errors.push({ path: `${at}.variant`, message: 'expected long or compact' });
+    if (block.benchmarks !== undefined && typeof block.benchmarks !== 'boolean')
+        errors.push({ path: `${at}.benchmarks`, message: 'expected a boolean' });
+    if (block.modelName !== undefined && !isString(block.modelName))
+        errors.push({ path: `${at}.modelName`, message: 'expected a string' });
+    if (block.modelFingerprint !== undefined && !(isString(block.modelFingerprint) && block.modelFingerprint.length > 0)) {
+        errors.push({ path: `${at}.modelFingerprint`, message: 'expected a non-empty string' });
+    }
+    if (!isString(block.generatedAt))
+        errors.push({ path: `${at}.generatedAt`, message: 'expected a string' });
+    if (!isCounts(block.summary))
+        errors.push({ path: `${at}.summary`, message: COUNTS_MESSAGE });
+    if (!Array.isArray(block.groups)) {
+        errors.push({ path: `${at}.groups`, message: 'expected an array' });
+        return;
+    }
+    // One id space across groups and checks, as the checklist parser enforces; the preview keys rows by id.
+    const seenIds = new Set();
+    const checkId = (value, path) => {
+        if (!isString(value) || value.length === 0)
+            errors.push({ path, message: 'expected a non-empty string' });
+        else if (seenIds.has(value))
+            errors.push({ path, message: `duplicate id "${value}"` });
+        else
+            seenIds.add(value);
+    };
+    block.groups.forEach((group, i) => {
+        const groupAt = `${at}.groups[${i}]`;
+        if (!isRecord(group)) {
+            errors.push({ path: groupAt, message: 'expected an object' });
+            return;
+        }
+        checkId(group.id, `${groupAt}.id`);
+        if (!isString(group.name))
+            errors.push({ path: `${groupAt}.name`, message: 'expected a string' });
+        if (!isCounts(group.counts))
+            errors.push({ path: `${groupAt}.counts`, message: COUNTS_MESSAGE });
+        if (!Array.isArray(group.items)) {
+            errors.push({ path: `${groupAt}.items`, message: 'expected an array' });
+            return;
+        }
+        group.items.forEach((item, j) => {
+            const itemAt = `${groupAt}.items[${j}]`;
+            if (!isRecord(item)) {
+                errors.push({ path: itemAt, message: 'expected an object' });
+                return;
+            }
+            checkId(item.id, `${itemAt}.id`);
+            if (!isString(item.text))
+                errors.push({ path: `${itemAt}.text`, message: 'expected a string' });
+            if (item.description !== undefined && !isString(item.description))
+                errors.push({ path: `${itemAt}.description`, message: 'expected a string' });
+            if (!VERDICTS.includes(item.status))
+                errors.push({ path: `${itemAt}.status`, message: 'expected pass | fail | warning | null' });
+            if (item.comment !== undefined && !isString(item.comment))
+                errors.push({ path: `${itemAt}.comment`, message: 'expected a string' });
+        });
+        // The ring is drawn from `counts`, so counts that disagree with the verdicts listed under
+        // them would print a chart the page contradicts; a hand-edited file is refused instead.
+        if (isCounts(group.counts) && !sameCounts(group.counts, countItems(group.items))) {
+            errors.push({ path: `${groupAt}.counts`, message: 'does not match the verdicts of its items' });
+        }
+    });
+    const groupCounts = block.groups.map((g) => (isRecord(g) && isCounts(g.counts) ? g.counts : null));
+    if (isCounts(block.summary) && groupCounts.every((c) => c !== null)) {
+        const sum = groupCounts.reduce((acc, c) => ({
+            total: acc.total + c.total, pass: acc.pass + c.pass, fail: acc.fail + c.fail, warning: acc.warning + c.warning, unanswered: acc.unanswered + c.unanswered,
+        }), { total: 0, pass: 0, fail: 0, warning: 0, unanswered: 0 });
+        if (!sameCounts(block.summary, sum))
+            errors.push({ path: `${at}.summary`, message: 'does not match the sum of its groups' });
+    }
+}
+function countItems(items) {
+    const counts = { total: 0, pass: 0, fail: 0, warning: 0, unanswered: 0 };
+    for (const item of items) {
+        counts.total += 1;
+        const status = isRecord(item) ? item.status : null;
+        if (status === 'pass' || status === 'fail' || status === 'warning')
+            counts[status] += 1;
+        else
+            counts.unanswered += 1;
+    }
+    return counts;
+}
+const sameCounts = (a, b) => a.total === b.total && a.pass === b.pass && a.fail === b.fail && a.warning === b.warning && a.unanswered === b.unanswered;
+//# sourceMappingURL=portable-manual-report.js.map

package/dist/review/portable-manual-report.js.map

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

package/dist/review/portable-report-metadata.d.ts

@@ -0,0 +1,42 @@
+import { type AutomationReportProvenance } from './portable-automation-provenance.js';
+export interface PortableReportValidationError {
+    path: string;
+    message: string;
+}
+/** Opaque sRGB document colours; named/alpha/short forms are intentionally excluded. */
+export declare function isRgbColor(value: unknown): value is string;
+/** Heading text size in points: absent prints the default; the bounds match the chart text size (6-24). */
+export declare const BLOCK_TITLE_SIZE_MIN = 6;
+export declare const BLOCK_TITLE_SIZE_MAX = 24;
+/** How the heading looks, shared by every block kind that has one (#6632). Absent fields print as before. */
+export interface BlockHeaderStyleFields {
+    /** Heading text size, `BLOCK_TITLE_SIZE_MIN`-`BLOCK_TITLE_SIZE_MAX` points. */
+    titleFontSize?: number;
+    /** Heading ink in `#RRGGBB`; absent is black, or black/white by contrast when a background is set. */
+    titleTextColor?: string;
+    /** Heading strip background in `#RRGGBB`; absent is transparent paper. */
+    titleBackgroundColor?: string;
+}
+/** Authored presentation belongs to the document, independently of its source (#6547). */
+export interface BlockTitle extends BlockHeaderStyleFields {
+    title?: string;
+}
+export declare function validateBlockTitle(block: Record<string, unknown>, at: string, errors: PortableReportValidationError[]): void;
+/** Source identity is evidence about the original run, never a live selector. */
+export interface ReportModelScope {
+    name: string;
+    fingerprint?: string;
+}
+/** The author's choice to print or omit a report's stamp rows (#6566, #6678).
+ * Absent means shown, so every document saved before the choice printed the same. */
+export interface ReportStampChoice {
+    showStamp?: boolean;
+}
+export interface ReportProvenance extends ReportStampChoice {
+    savedReportId?: string;
+    /** Captured workflow execution identity; travels with the evidence, never a live binding. */
+    automation?: AutomationReportProvenance;
+    reportModels?: ReportModelScope[];
+}
+export declare function validateReportProvenance(block: Record<string, unknown>, at: string, errors: PortableReportValidationError[]): void;
+//# sourceMappingURL=portable-report-metadata.d.ts.map

package/dist/review/portable-report-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-report-metadata.d.ts","sourceRoot":"","sources":["../../src/review/portable-report-metadata.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgC,KAAK,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACpH,MAAM,WAAW,6BAA6B;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAEhF,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE1D;AAED,2GAA2G;AAC3G,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,6GAA6G;AAC7G,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sGAAsG;IACtG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,0FAA0F;AAC1F,MAAM,WAAW,UAAW,SAAQ,sBAAsB;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,6BAA6B,EAAE,GAAG,IAAI,CAS5H;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;AACxE;qFACqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AACD,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,0BAA0B,CAAC;IACxC,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,6BAA6B,EAAE,GAAG,IAAI,CAalI"}

package/dist/review/portable-report-metadata.js

@@ -0,0 +1,41 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { isAutomationReportProvenance } from './portable-automation-provenance.js';
+/** Opaque sRGB document colours; named/alpha/short forms are intentionally excluded. */
+export function isRgbColor(value) {
+    return typeof value === 'string' && /^#[0-9a-f]{6}$/i.test(value);
+}
+/** Heading text size in points: absent prints the default; the bounds match the chart text size (6-24). */
+export const BLOCK_TITLE_SIZE_MIN = 6;
+export const BLOCK_TITLE_SIZE_MAX = 24;
+export function validateBlockTitle(block, at, errors) {
+    if (block.title !== undefined && typeof block.title !== 'string')
+        errors.push({ path: `${at}.title`, message: 'expected a string' });
+    const size = block.titleFontSize;
+    if (size !== undefined && (typeof size !== 'number' || !Number.isFinite(size) || size < BLOCK_TITLE_SIZE_MIN || size > BLOCK_TITLE_SIZE_MAX)) {
+        errors.push({ path: `${at}.titleFontSize`, message: `expected a number between ${BLOCK_TITLE_SIZE_MIN} and ${BLOCK_TITLE_SIZE_MAX}` });
+    }
+    for (const key of ['titleTextColor', 'titleBackgroundColor']) {
+        if (block[key] !== undefined && !isRgbColor(block[key]))
+            errors.push({ path: `${at}.${key}`, message: 'expected an RGB colour in #RRGGBB form' });
+    }
+}
+export function validateReportProvenance(block, at, errors) {
+    if (block.showStamp !== undefined && typeof block.showStamp !== 'boolean')
+        errors.push({ path: `${at}.showStamp`, message: 'expected a boolean' });
+    if (block.automation !== undefined && !isAutomationReportProvenance(block.automation)) {
+        errors.push({ path: `${at}.automation`, message: 'expected valid workflow report provenance' });
+    }
+    if (block.savedReportId !== undefined && (typeof block.savedReportId !== 'string' || !block.savedReportId)) {
+        errors.push({ path: `${at}.savedReportId`, message: 'expected a non-empty string' });
+    }
+    if (block.reportModels !== undefined && (!Array.isArray(block.reportModels) || !block.reportModels.every((model) => {
+        if (typeof model !== 'object' || model === null || Array.isArray(model))
+            return false;
+        const m = model;
+        return typeof m.name === 'string' && m.name.trim().length > 0 && (m.fingerprint === undefined || (typeof m.fingerprint === 'string' && m.fingerprint.length > 0));
+    })))
+        errors.push({ path: `${at}.reportModels`, message: 'expected non-empty model names and optional non-empty fingerprints' });
+}
+//# sourceMappingURL=portable-report-metadata.js.map

package/dist/review/portable-report-metadata.js.map

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

package/dist/review/portable-saved-validation.d.ts

@@ -0,0 +1,12 @@
+import { type AutomationReportProvenance } from './portable-automation-provenance.js';
+import { type IdsReportBlock } from './portable-ids-report.js';
+import { type ManualReportBlock } from './portable-manual-report.js';
+export type ValidationReportSnapshot = IdsReportBlock | ManualReportBlock;
+export interface SavedValidationReport {
+    id: string;
+    name: string;
+    snapshot: ValidationReportSnapshot;
+    automation?: AutomationReportProvenance;
+}
+export declare function validateSavedReport(value: unknown): value is SavedValidationReport;
+//# sourceMappingURL=portable-saved-validation.d.ts.map

package/dist/review/portable-saved-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-saved-validation.d.ts","sourceRoot":"","sources":["../../src/review/portable-saved-validation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoD,KAAK,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACxI,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhG,MAAM,MAAM,wBAAwB,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAC1E,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,wBAAwB,CAAC;IACnC,UAAU,CAAC,EAAE,0BAA0B,CAAC;CACzC;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAelF"}