@terra-symposium/standards-reporting 0.0.0-stage → 0.4.0

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# @terra-symposium/standards-reporting
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Reusable responsive Playwright diagnostics and evidence reports for Terra Symposium repositories.
+
+## Install
+
+```sh
+pnpm add -D @terra-symposium/standards-reporting @playwright/test
+```
+
+The package requires Node.js `>=18.18` and has an `@playwright/test >=1.52.0 <2` peer dependency. Spreadsheet, slideshow, and image-processing dependencies are installed with the package.
+
+## Configure responsive projects
+
+```ts
+import { defineConfig } from '@playwright/test';
+import { withResponsivePlaywright } from '@terra-symposium/standards-reporting/viewports';
+
+export default withResponsivePlaywright(
+	defineConfig({
+		projects: [{ name: 'web', testMatch: '**/*.spec.ts' }],
+	}),
+	{
+		singleRunProjects: ['manual-browser-capture'],
+	},
+);
+```
+
+By default, regular projects run at the six shared viewport sizes. Set `PW_VIEWPORTS=mobile,lg` to select a subset. Setup projects and names listed in `singleRunProjects` run once. The helper enables full-page screenshots and the shared reporter.
+
+A timestamped directory under `test-results/visual` contains the workbook, slideshow, and copied screenshots. Each Playwright result screenshot and keyed visual capture is also stored with metadata under `test-results/visual/screenshots`. Repeated test/viewport captures replace their previous file, and each new slideshow is rebuilt from the whole folder, so interrupted and subset runs retain earlier evidence. The Playwright output directory defaults to `test-results/playwright-output`.
+
+## More capabilities
+
+- Import `diagnosticsTest` from `/playwright` to attach browser console, page, and request failures.
+- Import `loadTest` to measure named operations and capture page-navigation timings. It reads `loadTesting` from `quality.json` by default.
+- Import `visualTest` to call `visuals.capture(key)` anywhere inside a Playwright test. Matching keys are grouped across responsive projects. The reporter writes `report.pptx` as image-only responsive screenshot slides by default; set `screenshotOnlySlideshow: false` to use the diagnostic review slideshow instead.
+- Import `writeScreenshotSlideshowFromDirectory` from `/slideshow` to rebuild an image-only deck from persisted screenshot evidence without running Playwright.
+- Use `/spreadsheet` and `/slideshow` to write artifacts from normalized results without using the Playwright reporter.
+- Use `/core`, `/viewports`, and `/load-testing` for shared types and helpers.
+
+The repository remains responsible for test scenarios, authentication, browser setup, CI uploads, and retention. See the [reporting guide](https://standards-docs.netlify.app/packages/reporting/) for complete options and output details.

package/dist/core.d.ts

@@ -0,0 +1,122 @@
+/**
+ * packages/reporting/src/core.ts
+ * Framework-neutral test evidence models and normalization helpers.
+ */
+/** Status values emitted by the reporting pipeline. */
+export declare const VISUAL_STATUSES: readonly ["passed", "failed", "timedOut", "skipped", "interrupted"];
+/** A normalized Playwright result status used by both output writers. */
+export type VisualStatus = (typeof VISUAL_STATUSES)[number];
+/** Load budget grades emitted by the shared timing reporter. */
+export declare const LOAD_GRADES: readonly ["pass", "warning", "fail"];
+/** Grade assigned to one elapsed-time measurement. */
+export type LoadGrade = (typeof LOAD_GRADES)[number];
+/** Kind of work timed by the load reporter. */
+export type LoadMeasurementKind = 'test' | 'page' | 'operation';
+/** Warning and hard-failure thresholds for one measured item, in milliseconds. */
+export type LoadBudget = {
+    warnMs: number;
+    failMs: number;
+};
+/** Partial budget accepted for per-test or per-operation overrides. */
+export type LoadBudgetOverride = Partial<LoadBudget>;
+/** Input measurement accepted from a fixture or a supplemental test runner. */
+export type LoadMeasurementInput = {
+    name: string;
+    kind: LoadMeasurementKind;
+    durationMs: number;
+    budget?: LoadBudgetOverride;
+};
+/** Normalized timing measurement rendered in report artifacts. */
+export type LoadMeasurement = LoadMeasurementInput & {
+    budget: LoadBudget;
+    grade: LoadGrade;
+};
+/** Optional repo-level load testing settings read from quality.json. */
+export type LoadTestingConfig = {
+    enabled?: boolean;
+    defaultBudget?: LoadBudgetOverride;
+    testBudgets?: Record<string, LoadBudgetOverride>;
+    operationBudgets?: Record<string, LoadBudgetOverride>;
+};
+/**
+ * A completed or interrupted test result independent of a test framework's internal types.
+ * Screenshot paths are resolved before the result is passed to artifact writers.
+ */
+export type VisualResult = {
+    browserErrors: string;
+    duration: number;
+    error: string;
+    file: string;
+    groups: string;
+    project: string;
+    retry: number;
+    screenshot: string;
+    status: VisualStatus;
+    terminalErrors: string;
+    title: string;
+    visual: string;
+    viewport: string;
+    viewportSize: string;
+    /** Timings collected for this test; absent for legacy/direct writer inputs. */
+    loadMeasurements?: readonly LoadMeasurement[];
+    /** Stable repo-relative key used to match per-test load budgets. */
+    loadTestId?: string;
+};
+/** Playwright project files used to populate the project summary sheet. */
+export type ProjectDefinition = {
+    name: string;
+    configuredFiles: readonly string[];
+};
+/** All normalized evidence and run-level diagnostics for one report directory. */
+export type ReportRun = {
+    results: readonly VisualResult[];
+    runDiagnostics: readonly string[];
+    featureFiles: readonly string[];
+    projects: readonly ProjectDefinition[];
+    /** Whether the reporter should render load timing sections, including an empty summary. */
+    loadTestingEnabled?: boolean;
+};
+/**
+ * Converts an external status into the normalized reporting status set.
+ *
+ * @param value External status value.
+ * @returns A supported reporting status, defaulting to `failed` for unknown values.
+ */
+export declare const normalizeVisualStatus: (val: string) => VisualStatus;
+/**
+ * Converts internal status casing into the label shown in artifacts.
+ *
+ * @param status Normalized reporting status.
+ * @returns The human-readable artifact label.
+ */
+export declare const statusLabel: (status: VisualStatus) => string;
+/**
+ * Counts newline-delimited diagnostic messages while treating an empty value as zero.
+ *
+ * @param value Newline-delimited diagnostic text.
+ * @returns The number of non-empty diagnostic lines.
+ */
+export declare const diagnosticCount: (val: string) => number;
+/**
+ * Returns one count for every supported status, including statuses absent from the run.
+ *
+ * @param results Normalized results to count.
+ * @returns A complete status-to-count map.
+ */
+export declare const statusCounts: (results: readonly VisualResult[]) => Record<VisualStatus, number>;
+/**
+ * Preserves configured feature-file order and appends unexpected result files once.
+ *
+ * @param run Normalized run whose configured and observed files are ordered.
+ * @returns Unique feature-file names in report order.
+ */
+export declare const orderedFiles: (run: ReportRun) => string[];
+/**
+ * Selects the normalized results that belong to one feature file.
+ *
+ * @param run Normalized run to search.
+ * @param file Feature-file name to select.
+ * @returns Results associated with the requested feature file.
+ */
+export declare const resultsForFile: (run: ReportRun, file: string) => VisualResult[];
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

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

package/dist/core.js

@@ -0,0 +1,69 @@
+/**
+ * packages/reporting/src/core.ts
+ * Framework-neutral test evidence models and normalization helpers.
+ */
+/*//////////////////////////////////////////////////
+CONFIG
+//////////////////////////////////////////////////*/
+/** Status values emitted by the reporting pipeline. */
+export const VISUAL_STATUSES = ['passed', 'failed', 'timedOut', 'skipped', 'interrupted'];
+/** Load budget grades emitted by the shared timing reporter. */
+export const LOAD_GRADES = ['pass', 'warning', 'fail'];
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Converts an external status into the normalized reporting status set.
+ *
+ * @param value External status value.
+ * @returns A supported reporting status, defaulting to `failed` for unknown values.
+ */
+export const normalizeVisualStatus = (val) => (VISUAL_STATUSES.includes(val) ? val : 'failed');
+/**
+ * Converts internal status casing into the label shown in artifacts.
+ *
+ * @param status Normalized reporting status.
+ * @returns The human-readable artifact label.
+ */
+export const statusLabel = (status) => (status === 'timedOut' ? 'timed out' : status);
+/**
+ * Counts newline-delimited diagnostic messages while treating an empty value as zero.
+ *
+ * @param value Newline-delimited diagnostic text.
+ * @returns The number of non-empty diagnostic lines.
+ */
+export const diagnosticCount = (val) => (val ? val.split('\n').filter(Boolean).length : 0);
+/**
+ * Returns one count for every supported status, including statuses absent from the run.
+ *
+ * @param results Normalized results to count.
+ * @returns A complete status-to-count map.
+ */
+export const statusCounts = (results) => {
+    const counts = Object.fromEntries(VISUAL_STATUSES.map((s) => [s, 0]));
+    for (const result of results)
+        counts[result.status] += 1;
+    return counts;
+};
+/**
+ * Preserves configured feature-file order and appends unexpected result files once.
+ *
+ * @param run Normalized run whose configured and observed files are ordered.
+ * @returns Unique feature-file names in report order.
+ */
+export const orderedFiles = (run) => [
+    ...run.featureFiles.filter((f) => run.results.some((r) => r.file === f)),
+    ...run.results
+        .map((r) => r.file)
+        .filter((f) => !run.featureFiles.includes(f))
+        .filter((f, i, v) => v.indexOf(f) === i),
+];
+/**
+ * Selects the normalized results that belong to one feature file.
+ *
+ * @param run Normalized run to search.
+ * @param file Feature-file name to select.
+ * @returns Results associated with the requested feature file.
+ */
+export const resultsForFile = (run, file) => run.results.filter((r) => r.file === file);
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;oDAEoD;AAEpD,uDAAuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAU,CAAC;AAKnG,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAiEhE;;oDAEoD;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAW,EAAgB,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAmB,CAAC,CAAC,CAAC,CAAE,GAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEvJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAoB,EAAU,EAAE,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5G;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3G;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAgC,EAAgC,EAAE;IAC9F,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAiC,CAAC;IACtG,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAc,EAAY,EAAE,CAAC;IACzD,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACxE,GAAG,GAAG,CAAC,OAAO;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAc,EAAE,IAAY,EAAkB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC"}

package/dist/load-testing.d.ts

@@ -0,0 +1,78 @@
+/**
+ * packages/reporting/src/load-testing.ts
+ * Load timing configuration and grading helpers.
+ */
+import type { LoadBudget, LoadBudgetOverride, LoadGrade, LoadMeasurement, LoadMeasurementInput, LoadTestingConfig } from './core.js';
+/** Default warning and failure thresholds used when a repo does not override them. */
+export declare const DEFAULT_LOAD_BUDGET: LoadBudget;
+/** Fully normalized load testing settings. */
+export type NormalizedLoadTestingConfig = {
+    enabled: boolean;
+    defaultBudget: LoadBudget;
+    testBudgets: Readonly<Record<string, LoadBudgetOverride>>;
+    operationBudgets: Readonly<Record<string, LoadBudgetOverride>>;
+    root?: string;
+};
+/** Optional inputs that have higher precedence than quality.json values. */
+export type LoadTestingOverrides = LoadTestingConfig;
+/**
+ * Validates and copies a partial budget supplied by a test helper.
+ * @param valandidate partial threshold override.
+ * @returns A validated partial budget.
+ */
+export declare const validateLoadBudgetOverride: (val: LoadBudgetOverride) => LoadBudgetOverride;
+/**
+ * Normalizes raw settings and applies explicit options over quality.json settings.
+ * @param raw Values read from quality.json.
+ * @param overrides Explicit reporting options with higher precedence.
+ * @returns Validated settings with defaults applied.
+ */
+export declare const normalizeLoadTestingConfig: (raw?: LoadTestingConfig, overrides?: LoadTestingOverrides) => NormalizedLoadTestingConfig;
+/**
+ * Reads load settings from a repository's quality.json and applies explicit overrides.
+ * Missing quality.json files preserve the shared 2s/5s defaults.
+ * @param file Optional quality.json path; defaults to the current repository root.
+ * @param overrides Explicit settings with higher precedence than the file.
+ * @returns Validated and normalized settings.
+ */
+export declare const readLoadTestingConfig: (file?: string, overrides?: LoadTestingOverrides) => NormalizedLoadTestingConfig;
+/**
+ * Creates a stable test-budget key from a repository-relative file and full title path.
+ * @param file Absolute or relative test file path.
+ * @param titlePath Full test title path, including describe groups.
+ * @param root Repository root used to make the file portion portable.
+ * @returns A stable `<file>::<title path>` identifier.
+ */
+export declare const loadTestId: (file: string, titlePath: readonly string[], root?: string) => string;
+/**
+ * Grades one duration against an ordered budget.
+ * @param durationMs Elapsed time in milliseconds.
+ * @param budget Warning and failure thresholds.
+ * @returns Pass, warning, or failure grade.
+ */
+export declare const gradeLoad: (durationMs: number, budget: LoadBudget) => LoadGrade;
+/**
+ * Resolves and grades one measurement using test/helper overrides, named config, and defaults.
+ * @param input Raw timing measurement.
+ * @param cfgrmalized repository timing settings.
+ * @param testId Stable test key for per-test budgets.
+ * @param testOverride Optional budget set directly by the test fixture.
+ * @returns A normalized measurement ready for artifacts.
+ */
+export declare const gradeLoadMeasurement: (input: LoadMeasurementInput, cfg: NormalizedLoadTestingConfig, testId: string, testOverride?: LoadBudgetOverride) => LoadMeasurement;
+/**
+ * Summarizes how many load measurements landed in each grade.
+ * @param measurements Measurements to count.
+ * @returns Counts including grades that did not occur.
+ */
+export declare const loadGradeCounts: (measurements: readonly Pick<LoadMeasurement, "grade">[]) => Record<LoadGrade, number>;
+/**
+ * Times an operation, records its duration even when it throws, and preserves its value/error.
+ * @param name Stable human-readable operation name.
+ * @param opo time.
+ * @param recllback receiving the elapsed measurement.
+ * @param budget Optional helper-level budget override.
+ * @returns The operation result.
+ */
+export declare const timeLoadOperation: <T>(name: string, op: () => T | Promise<T>, rec: (measurement: LoadMeasurementInput) => void, budget?: LoadBudgetOverride) => Promise<T>;
+//# sourceMappingURL=load-testing.d.ts.map

package/dist/load-testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-testing.d.ts","sourceRoot":"","sources":["../src/load-testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAMrI,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,EAAE,UAA2C,CAAC;AAC9E,8CAA8C;AAC9C,MAAM,MAAM,2BAA2B,GAAG;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,UAAU,CAAC;IAC1B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC1D,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AACF,4EAA4E;AAC5E,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAkBrD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,KAAK,kBAAkB,KAAG,kBAIpE,CAAC;AAsBF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,MAAK,iBAAsB,EAAE,YAAW,oBAAyB,KAAG,2BAmB9G,CAAC;AACF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAkD,EAAE,YAAW,oBAAyB,KAAG,2BAgBhI,CAAC;AACF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,WAAW,SAAS,MAAM,EAAE,EAAE,aAAoB,KAAG,MACG,CAAC;AAClG;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,YAAY,MAAM,EAAE,QAAQ,UAAU,KAAG,SAKlE,CAAC;AACF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,QAAQ,MAAM,EAAE,eAAe,kBAAkB,KAAG,eAUvJ,CAAC;AACF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,SAAS,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,KAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAIjH,CAAC;AACF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAU,CAAC,EAAE,MAAM,MAAM,EAAE,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,EAAE,oBAAoB,KAAK,IAAI,EAAE,SAAS,kBAAkB,KAAG,OAAO,CAAC,CAAC,CAS3K,CAAC"}

package/dist/load-testing.js

@@ -0,0 +1,201 @@
+/**
+ * packages/reporting/src/load-testing.ts
+ * Load timing configuration and grading helpers.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import fs from 'node:fs';
+import path from 'node:path';
+import { performance } from 'node:perf_hooks';
+// DATA
+import { LOAD_GRADES } from './core.js';
+/*//////////////////////////////////////////////////
+CONFIG
+//////////////////////////////////////////////////*/
+/** Default warning and failure thresholds used when a repo does not override them. */
+export const DEFAULT_LOAD_BUDGET = { warnMs: 2000, failMs: 5000 };
+const isRec = (val) => !!val && typeof val === 'object' && !Array.isArray(val);
+/**
+ * Validates one partial budget and returns a fresh object.
+ * @param valandidate budget from quality.json or test code.
+ * @param label Location used in configuration errors.
+ * @returns A validated partial budget.
+ */
+const budgetOverride = (val, label) => {
+    if (!isRec(val))
+        throw new Error(`${label} must be an object with optional warnMs and failMs numbers.`);
+    const output = {};
+    for (const key of ['warnMs', 'failMs']) {
+        if (val[key] === undefined)
+            continue;
+        if (typeof val[key] !== 'number' || !Number.isFinite(val[key]) || val[key] < 0)
+            throw new Error(`${label}.${key} must be a finite non-negative number.`);
+        output[key] = val[key];
+    }
+    return output;
+};
+/**
+ * Validates and copies a partial budget supplied by a test helper.
+ * @param valandidate partial threshold override.
+ * @returns A validated partial budget.
+ */
+export const validateLoadBudgetOverride = (val) => {
+    const result = budgetOverride(val, 'load budget override');
+    if (result.warnMs !== undefined && result.failMs !== undefined && result.failMs <= result.warnMs)
+        throw new Error('load budget override.failMs must be greater than warnMs.');
+    return result;
+};
+/**
+ * Validates a named budget map.
+ * @param valandidate map from configuration.
+ * @param label Location used in configuration errors.
+ * @returns A validated map keyed by test identity or measurement name.
+ */
+const budgetMap = (val, label) => {
+    if (val === undefined)
+        return {};
+    if (!isRec(val))
+        throw new Error(`${label} must be an object keyed by test identity or measurement name.`);
+    return Object.fromEntries(Object.entries(val).map(([key, budget]) => [key, budgetOverride(budget, `${label}.${key}`)]));
+};
+/**
+ * Checks that a complete budget has an ordered warning/failure boundary.
+ * @param valudget to validate.
+ * @param label Location used in configuration errors.
+ * @returns The validated budget.
+ */
+const completeBudget = (val, label) => {
+    if (val.failMs <= val.warnMs)
+        throw new Error(`${label}.failMs must be greater than warnMs.`);
+    return val;
+};
+/**
+ * Normalizes raw settings and applies explicit options over quality.json settings.
+ * @param raw Values read from quality.json.
+ * @param overrides Explicit reporting options with higher precedence.
+ * @returns Validated settings with defaults applied.
+ */
+export const normalizeLoadTestingConfig = (raw = {}, overrides = {}) => {
+    const rawDefault = budgetOverride(raw.defaultBudget ?? {}, 'loadTesting.defaultBudget');
+    const optDefault = budgetOverride(overrides.defaultBudget ?? {}, 'loadTesting options.defaultBudget');
+    const defaultBudget = completeBudget({ failMs: optDefault.failMs ?? rawDefault.failMs ?? DEFAULT_LOAD_BUDGET.failMs, warnMs: optDefault.warnMs ?? rawDefault.warnMs ?? DEFAULT_LOAD_BUDGET.warnMs }, 'loadTesting.defaultBudget');
+    const mergeMaps = (base, additional) => {
+        const merged = { ...base };
+        for (const [key, val] of Object.entries(additional))
+            merged[key] = { ...merged[key], ...val };
+        return merged;
+    };
+    const testBudgets = mergeMaps(budgetMap(raw.testBudgets, 'loadTesting.testBudgets'), budgetMap(overrides.testBudgets, 'loadTesting options.testBudgets'));
+    const opBudgets = mergeMaps(budgetMap(raw.operationBudgets, 'loadTesting.operationBudgets'), budgetMap(overrides.operationBudgets, 'loadTesting options.operationBudgets'));
+    for (const [key, value] of Object.entries(testBudgets))
+        completeBudget({ ...defaultBudget, ...value }, `loadTesting.testBudgets.${key}`);
+    for (const [key, value] of Object.entries(opBudgets))
+        completeBudget({ ...defaultBudget, ...value }, `loadTesting.operationBudgets.${key}`);
+    const enabled = overrides.enabled ?? raw.enabled ?? true;
+    if (typeof enabled !== 'boolean')
+        throw new Error('loadTesting.enabled must be a boolean.');
+    return { enabled, defaultBudget, testBudgets, operationBudgets: opBudgets };
+};
+/**
+ * Reads load settings from a repository's quality.json and applies explicit overrides.
+ * Missing quality.json files preserve the shared 2s/5s defaults.
+ * @param file Optional quality.json path; defaults to the current repository root.
+ * @param overrides Explicit settings with higher precedence than the file.
+ * @returns Validated and normalized settings.
+ */
+export const readLoadTestingConfig = (file = path.resolve(process.cwd(), 'quality.json'), overrides = {}) => {
+    const cfgFile = path.resolve(file);
+    if (!fs.existsSync(cfgFile))
+        return { ...normalizeLoadTestingConfig({}, overrides), root: process.cwd() };
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(cfgFile, 'utf8'));
+    }
+    catch (err) {
+        throw new Error(`Could not read load testing settings from ${cfgFile}: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    if (!isRec(parsed))
+        throw new Error(`Quality configuration at ${cfgFile} must contain a JSON object.`);
+    const root = typeof parsed.root === 'string' ? path.resolve(path.dirname(cfgFile), parsed.root) : path.dirname(cfgFile);
+    if (parsed.loadTesting === undefined)
+        return { ...normalizeLoadTestingConfig({}, overrides), root };
+    if (!isRec(parsed.loadTesting))
+        throw new Error(`loadTesting in ${cfgFile} must be an object.`);
+    const raw = parsed.loadTesting;
+    if (raw.enabled !== undefined && typeof raw.enabled !== 'boolean')
+        throw new Error(`loadTesting.enabled in ${cfgFile} must be a boolean.`);
+    return { ...normalizeLoadTestingConfig(raw, overrides), root };
+};
+/**
+ * Creates a stable test-budget key from a repository-relative file and full title path.
+ * @param file Absolute or relative test file path.
+ * @param titlePath Full test title path, including describe groups.
+ * @param root Repository root used to make the file portion portable.
+ * @returns A stable `<file>::<title path>` identifier.
+ */
+export const loadTestId = (file, titlePath, root = process.cwd()) => `${path.relative(root, path.resolve(file)).split(path.sep).join('/')}::${titlePath.join(' › ')}`;
+/**
+ * Grades one duration against an ordered budget.
+ * @param durationMs Elapsed time in milliseconds.
+ * @param budget Warning and failure thresholds.
+ * @returns Pass, warning, or failure grade.
+ */
+export const gradeLoad = (durationMs, budget) => {
+    if (!Number.isFinite(durationMs) || durationMs < 0)
+        throw new Error('Load duration must be a finite non-negative number.');
+    if (durationMs > budget.failMs)
+        return LOAD_GRADES[2];
+    if (durationMs > budget.warnMs)
+        return LOAD_GRADES[1];
+    return LOAD_GRADES[0];
+};
+/**
+ * Resolves and grades one measurement using test/helper overrides, named config, and defaults.
+ * @param input Raw timing measurement.
+ * @param cfgrmalized repository timing settings.
+ * @param testId Stable test key for per-test budgets.
+ * @param testOverride Optional budget set directly by the test fixture.
+ * @returns A normalized measurement ready for artifacts.
+ */
+export const gradeLoadMeasurement = (input, cfg, testId, testOverride) => {
+    const cfgd = input.kind === 'test' ? cfg.testBudgets[testId] : cfg.operationBudgets[input.name];
+    const budget = completeBudget({
+        warnMs: input.budget?.warnMs ?? (input.kind === 'test' ? testOverride?.warnMs : undefined) ?? cfgd?.warnMs ?? cfg.defaultBudget.warnMs,
+        failMs: input.budget?.failMs ?? (input.kind === 'test' ? testOverride?.failMs : undefined) ?? cfgd?.failMs ?? cfg.defaultBudget.failMs,
+    }, `load budget for ${input.name}`);
+    return { ...input, budget, grade: gradeLoad(input.durationMs, budget) };
+};
+/**
+ * Summarizes how many load measurements landed in each grade.
+ * @param measurements Measurements to count.
+ * @returns Counts including grades that did not occur.
+ */
+export const loadGradeCounts = (measurements) => {
+    const counts = { fail: 0, pass: 0, warning: 0 };
+    for (const item of measurements)
+        counts[item.grade] += 1;
+    return counts;
+};
+/**
+ * Times an operation, records its duration even when it throws, and preserves its value/error.
+ * @param name Stable human-readable operation name.
+ * @param opo time.
+ * @param recllback receiving the elapsed measurement.
+ * @param budget Optional helper-level budget override.
+ * @returns The operation result.
+ */
+export const timeLoadOperation = async (name, op, rec, budget) => {
+    if (!name.trim())
+        throw new Error('A named load measurement is required.');
+    const valid = budget ? validateLoadBudgetOverride(budget) : undefined;
+    const start = performance.now();
+    try {
+        return await op();
+    }
+    finally {
+        rec({ name, kind: 'operation', durationMs: performance.now() - start, ...(valid ? { budget: valid } : {}) });
+    }
+};
+//# sourceMappingURL=load-testing.js.map

package/dist/load-testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-testing.js","sourceRoot":"","sources":["../src/load-testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;oDAEoD;AAEpD,MAAM;AACN,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO;AACP,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAKxC;;oDAEoD;AAEpD,sFAAsF;AACtF,MAAM,CAAC,MAAM,mBAAmB,GAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAW9E,MAAM,KAAK,GAAG,CAAC,GAAY,EAAkC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACxH;;;;;GAKG;AACH,MAAM,cAAc,GAAG,CAAC,GAAY,EAAE,KAAa,EAAsB,EAAE;IAC1E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6DAA6D,CAAC,CAAC;IACxG,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAU,EAAE,CAAC;QACjD,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,SAAS;QACrC,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,GAAG,wCAAwC,CAAC,CAAC;QACzJ,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AACF;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,GAAuB,EAAsB,EAAE;IACzF,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9K,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AACF;;;;;GAKG;AACH,MAAM,SAAS,GAAG,CAAC,GAAY,EAAE,KAAa,EAAsC,EAAE;IACrF,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gEAAgE,CAAC,CAAC;IAC3G,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,cAAc,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACzH,CAAC,CAAC;AACF;;;;;GAKG;AACH,MAAM,cAAc,GAAG,CAAC,GAAe,EAAE,KAAa,EAAc,EAAE;IACrE,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,sCAAsC,CAAC,CAAC;IAC9F,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AACF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,MAAyB,EAAE,EAAE,YAAkC,EAAE,EAA+B,EAAE;IAC5I,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,EAAE,2BAA2B,CAAC,CAAC;IACxF,MAAM,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,EAAE,mCAAmC,CAAC,CAAC;IACtG,MAAM,aAAa,GAAG,cAAc,CACnC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,IAAI,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,IAAI,mBAAmB,CAAC,MAAM,EAAE,EAC9J,2BAA2B,CAC3B,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,IAAwC,EAAE,UAA8C,EAAsC,EAAE;QAClJ,MAAM,MAAM,GAAuC,EAAE,GAAG,IAAI,EAAE,CAAC;QAC/D,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;QAC9F,OAAO,MAAM,CAAC;IACf,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,yBAAyB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,iCAAiC,CAAC,CAAC,CAAC;IAC1J,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,EAAE,8BAA8B,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,gBAAgB,EAAE,sCAAsC,CAAC,CAAC,CAAC;IAC5K,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;QAAE,cAAc,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,KAAK,EAAE,EAAE,2BAA2B,GAAG,EAAE,CAAC,CAAC;IACzI,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,cAAc,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,KAAK,EAAE,EAAE,gCAAgC,GAAG,EAAE,CAAC,CAAC;IAC5I,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;IACzD,IAAI,OAAO,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5F,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;AAC7E,CAAC,CAAC;AACF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,YAAkC,EAAE,EAA+B,EAAE;IAC9J,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,0BAA0B,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;IAC1G,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9I,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,8BAA8B,CAAC,CAAC;IACvG,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxH,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,0BAA0B,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACpG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,qBAAqB,CAAC,CAAC;IAChG,MAAM,GAAG,GAAG,MAAM,CAAC,WAAgC,CAAC;IACpD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,qBAAqB,CAAC,CAAC;IAC3I,OAAO,EAAE,GAAG,0BAA0B,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;AAChE,CAAC,CAAC;AACF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,SAA4B,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAU,EAAE,CACtG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AAClG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,UAAkB,EAAE,MAAkB,EAAa,EAAE;IAC9E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC3H,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM;QAAE,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM;QAAE,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC,CAAC;AACF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAA2B,EAAE,GAAgC,EAAE,MAAc,EAAE,YAAiC,EAAmB,EAAE;IACzK,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChG,MAAM,MAAM,GAAG,cAAc,CAC5B;QACC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM;QACtI,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM;KACtI,EACD,mBAAmB,KAAK,CAAC,IAAI,EAAE,CAC/B,CAAC;IACF,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;AACzE,CAAC,CAAC;AACF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,YAAuD,EAA6B,EAAE;IACrH,MAAM,MAAM,GAA8B,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC3E,KAAK,MAAM,IAAI,IAAI,YAAY;QAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AACF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAK,IAAY,EAAE,EAAwB,EAAE,GAAgD,EAAE,MAA2B,EAAc,EAAE;IAC/K,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,IAAI,CAAC;QACJ,OAAO,MAAM,EAAE,EAAE,CAAC;IACnB,CAAC;YAAS,CAAC;QACV,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9G,CAAC;AACF,CAAC,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,7 @@
+/**
+ * packages/reporting/src/metadata.ts
+ * Neutral metadata helpers for Open XML spreadsheet and slideshow artifacts.
+ */
+/** Replaces library-generated application labels with neutral evidence metadata. */
+export declare const neutralizeApplicationMetadata: (file: string) => Promise<void>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,oFAAoF;AACpF,eAAO,MAAM,6BAA6B,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,CAW9E,CAAC"}

package/dist/metadata.js

@@ -0,0 +1,26 @@
+/**
+ * packages/reporting/src/metadata.ts
+ * Neutral metadata helpers for Open XML spreadsheet and slideshow artifacts.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import fs from 'node:fs/promises';
+// COMPONENTS
+import JSZip from 'jszip';
+/*//////////////////////////////////////////////////
+CONFIG
+//////////////////////////////////////////////////*/
+/** Replaces library-generated application labels with neutral evidence metadata. */
+export const neutralizeApplicationMetadata = async (file) => {
+    const archive = await JSZip.loadAsync(await fs.readFile(file));
+    const applicationProperties = archive.file('docProps/app.xml');
+    if (!applicationProperties)
+        return;
+    archive.file('docProps/app.xml', (await applicationProperties.async('string'))
+        .replace(/<Application>[^<]*<\/Application>/, '<Application>Test evidence reporter</Application>')
+        .replace(/<Company>[^<]*<\/Company>/, '<Company>Test evidence</Company>'));
+    await fs.writeFile(file, await archive.generateAsync({ type: 'nodebuffer' }));
+};
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;oDAEoD;AAEpD,MAAM;AACN,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,aAAa;AACb,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;oDAEoD;AAEpD,oFAAoF;AACpF,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;IAClF,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/D,IAAI,CAAC,qBAAqB;QAAE,OAAO;IACnC,OAAO,CAAC,IAAI,CACX,kBAAkB,EAClB,CAAC,MAAM,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;SAC3C,OAAO,CAAC,mCAAmC,EAAE,mDAAmD,CAAC;SACjG,OAAO,CAAC,2BAA2B,EAAE,kCAAkC,CAAC,CAC1E,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAC/E,CAAC,CAAC"}