@chartguard/core 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ChartGuard contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,47 @@
-# Temporary Holding Version
+# @chartguard/core
 
-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.
+Shared diagnostics, statuses and runtime contracts.
+
+Every ChartGuard package speaks the types defined here: a `Diagnostic` (code, severity, path, message, confidence, an optional fix), a `ValidationResult` (`valid`, `status`, `coverage`, the schema that checked it) and a `QualityReport`. You use it directly to apply a fix, to locate a finding in JSON text, or to stop a chart from being created with an invalid config.
+
+**Status:** pre-release (0.x). Coverage is partial, and the API and settings may still change between minor versions.
+
+```sh
+npm install @chartguard/core
+```
+
+```ts
+import { Chart, type ChartConfiguration } from "chart.js";
+import { createValidateBeforeCreate, locateJsonPath, parseJsonSource } from "@chartguard/core";
+import { validate } from "@chartguard/config-chartjs";
+
+// Creates the chart only when the config has no confirmed errors; otherwise throws
+// ConfigValidationError, which carries the full result.
+const validateBeforeCreate = createValidateBeforeCreate("chartjs", validate);
+const chart = validateBeforeCreate(config, (checked) => new Chart(canvas, checked as ChartConfiguration));
+
+// Where a finding is in the JSON text it came from (1-based line and column).
+const text = '{ "type": "bar", "options": { "responsive": "yes" } }';
+const parsed = parseJsonSource(text);
+if (parsed.ok) {
+	const { line, column } = locateJsonPath(parsed.root, "$.options.responsive");
+	console.log(line, column);
+}
+```
+
+- **Status and validity:** `valid` is true when nothing is a confirmed error; `status` is `valid`, `partial` (something could not be checked: an unknown schema part, a dynamic value) or `invalid`. Read `status` before trusting a `valid`.
+- **Confidence:** `certain` findings rest on a schema fact from the library's own declarations; `inferred` on a derived or hand-written one (reported as warnings); `unknown` findings claim nothing.
+- **Paths** use one notation everywhere: `$.series[0].type`, `$.title["te.xt"]`; `pathSegments` and `keySegment` read and write it.
+
+## Fixes
+
+A `Diagnostic` may carry a `fix`. There are two kinds:
+
+- **`rename-key`** preserves behaviour: the runtime already reads the option under its new name, so a tool may apply it.
+- **`set-option`** changes what is drawn, as a quality finding asks. It names the option (`path`), the value it held when the finding was made (`from`; absent when unset), the new `value` and its `effect`. Apply it only at the user's request.
+
+`applyFix(config, fix, path?)` returns a new config with the fix applied. `path` is the finding's path, needed for a rename.
+
+- Only the objects on the path are copied; everything else is shared.
+- The input is never written and no getter runs.
+- It throws `FixError` when the fix no longer applies: the option changed since the finding, a getter, a primitive or a missing array element is on the way, or a renamed key's new name is taken.

package/dist/diagnostic.d.ts

@@ -0,0 +1,131 @@
+/** How serious a finding is; only `error` is a confirmed error that makes a result invalid. */
+export type Severity = 'error' | 'warning' | 'info';
+/**
+ * `invalid`: at least one confirmed error; `partial`: none, but coverage is partial or a finding is not
+ * `certain`; `valid`: none, full coverage and every finding certain.
+ */
+export type ValidationStatus = 'valid' | 'invalid' | 'partial';
+/**
+ * How sure a finding is: `certain`, `inferred` (a likely problem read from a schema fact that is not
+ * authoritative) or `unknown` (could not be decided). Anything but `certain` keeps a result from `valid`.
+ */
+export type Confidence = 'certain' | 'inferred' | 'unknown';
+/** Whether the schema checked the whole config (`full`) or only what it describes (`partial`). */
+export type Coverage = 'partial' | 'full';
+/**
+ * A behaviour-preserving edit a tool may apply to the reported key: the runtime already reads the
+ * key under its new name (a rename it performs itself), and the new name is not set yet.
+ */
+export interface KeyRename {
+    readonly kind: 'rename-key';
+    readonly to: string;
+}
+/** An option value an edit reads or writes: JSON's primitives. */
+export type OptionValue = string | number | boolean | null;
+/**
+ * An edit that changes what is drawn, to what a quality finding asks (CG-05-06): set the option at
+ * `path` (the finding notation) to `value`. It holds `from` when the finding was made, or nothing
+ * when `from` is absent; `applyFix` refuses it once that is no longer so. `effect` says what changes.
+ * Never applied without the user: unlike `rename-key`, it does not preserve behaviour.
+ */
+export interface OptionEdit {
+    readonly kind: 'set-option';
+    readonly path: string;
+    readonly from?: OptionValue;
+    readonly value: OptionValue;
+    readonly effect: string;
+}
+/** An edit a finding offers: a behaviour-preserving `rename-key`, or a `set-option` that changes what is drawn. */
+export type Fix = KeyRename | OptionEdit;
+/**
+ * One finding at `path` (the finding notation, `$.series[0].type`), with its `code`, `severity` and
+ * `confidence`; `file`, `line` and `column` locate it when it was read from source.
+ */
+export interface Diagnostic {
+    code: string;
+    severity: Severity;
+    message: string;
+    path: string;
+    ruleId?: string;
+    suggestion?: string;
+    /**
+     * Where the finding is explained: its code's anchor in the published reference, or a page the
+     * adapter names for it (a deprecation's migration). Present on every finding of a result or report.
+     */
+    documentationUrl?: string;
+    /**
+     * `rename-key`: present only when applying it cannot change what the runtime does, so a tool may
+     * apply it. `set-option`: changes what is drawn, as the finding asks, offered only when the edit was
+     * verified to resolve the finding without a new one; apply it only at the user's request.
+     */
+    fix?: Fix;
+    confidence: Confidence;
+    file?: string;
+    line?: number;
+    column?: number;
+    /** Where the source range the finding is about ends (exclusive), when it is known (CG-03-07). */
+    endLine?: number;
+    endColumn?: number;
+}
+/**
+ * What the caller's runtime has registered in one registry (CG-02-04). `complete`: `names` is
+ * everything registered (a tree-shaken build), so anything else is rejected by the runtime.
+ * Otherwise `names` are extensions known to be registered on top of the built-ins.
+ */
+export interface RegistryContext {
+    readonly names: readonly string[];
+    readonly complete: boolean;
+}
+/** What the caller knows about its input and runtime, passed to every validation. */
+export interface ValidationOptions {
+    /**
+     * The input is a partial extraction (unresolved spreads or values were left out), so a
+     * missing required key is unresolved rather than confirmed missing, and coverage is partial.
+     */
+    readonly incomplete?: boolean;
+    /**
+     * The exact upstream version the caller runs (`4.4.1`). Another minor or patch than the
+     * schema's turns confirmed errors into warnings; another major is not validated (CG-01-07).
+     */
+    readonly libraryVersion?: string;
+    /** Registered names per registry id the schema uses (`echarts`, `chartjs.controllers`). */
+    readonly registries?: Readonly<Record<string, RegistryContext>>;
+}
+/**
+ * The outcome of one validation. `valid` and `status` are derived from `coverage` and `diagnostics` by
+ * `result()` only, never assembled by hand.
+ */
+export interface ValidationResult {
+    /** No confirmed errors; read `status` for completeness. */
+    valid: boolean;
+    status: ValidationStatus;
+    library: string;
+    /** The upstream version the schema describes. */
+    schemaVersion: string;
+    /** The exact schema artifact that produced this result (`sha256-…`), when it is generated. */
+    schemaDigest?: string;
+    /** The plugin extensions the schema was extended with (CG-02-05), by id. */
+    extensions?: string[];
+    coverage: Coverage;
+    diagnostics: Diagnostic[];
+}
+/**
+ * A finding that was not reported, and why: the caller's settings ignore it at its path (`setting`),
+ * or the context the caller declares meets the rule's concern (`context`). It is kept, never dropped.
+ */
+export interface Suppression {
+    readonly diagnostic: Diagnostic;
+    readonly by: 'setting' | 'context';
+    readonly reason: string;
+}
+/** Advisory findings about a chart's presentation. Never a verdict: there is no `valid` and no error severity. */
+export interface QualityReport {
+    readonly library: string;
+    readonly rulesVersion: string;
+    readonly diagnostics: readonly Diagnostic[];
+    /** Findings the caller's settings or context suppressed, in rule order. */
+    readonly suppressed: readonly Suppression[];
+    /** The rules the caller's settings turned off, by id: they did not run. */
+    readonly disabled: readonly string[];
+}
+//# sourceMappingURL=diagnostic.d.ts.map

package/dist/diagnostic.d.ts.map

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

package/dist/diagnostic.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostic.js.map

package/dist/diagnostic.js.map

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

package/dist/fix.d.ts

@@ -0,0 +1,13 @@
+import type { Fix } from './diagnostic.js';
+/** A fix that cannot be applied to this config: the option changed since the finding, or the path cannot be edited. */
+export declare class FixError extends Error {
+    readonly name = "FixError";
+}
+/**
+ * The config with `fix` applied (`path`: the finding's, for a rename): a new object, the input never
+ * written and no getter run. Throws `FixError` when it no longer applies: a `set-option` whose option
+ * is not `from` any more, a rename whose key is gone or whose new name is taken, a path through a
+ * getter, a primitive or a missing array element.
+ */
+export declare function applyFix(config: unknown, fix: Fix, path?: string): unknown;
+//# sourceMappingURL=fix.d.ts.map

package/dist/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../src/fix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAyB,MAAM,iBAAiB,CAAC;AAIlE,uHAAuH;AACvH,qBAAa,QAAS,SAAQ,KAAK;IAClC,SAAkB,IAAI,cAAc;CACpC;AA2FD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAI1E"}

package/dist/fix.js

@@ -0,0 +1,109 @@
+import { isContainer } from './object.js';
+import { pathSegments } from './paths.js';
+/** A fix that cannot be applied to this config: the option changed since the finding, or the path cannot be edited. */
+export class FixError extends Error {
+    name = 'FixError';
+}
+/**
+ * A shallow copy that keeps the prototype and every property, symbol-keyed ones included: getters are
+ * copied, never run. The copy is ours, so its properties are configurable (a frozen input stays frozen;
+ * its copy can be edited). A typed array is copied as a typed array of its own kind (A13: a list).
+ */
+function copyOf(value) {
+    if (ArrayBuffer.isView(value) && !(value instanceof DataView))
+        return value.slice();
+    const array = Array.isArray(value);
+    const shell = array ? [] : Object.create(Object.getPrototypeOf(value));
+    const descriptors = {};
+    for (const key of Reflect.ownKeys(value)) {
+        if (array && key === 'length')
+            continue;
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor === undefined)
+            continue;
+        // A symbol key is a valid key of a property descriptor map; `PropertyDescriptorMap` only says strings.
+        descriptors[key] =
+            'value' in descriptor
+                ? { ...descriptor, writable: true, configurable: true }
+                : { ...descriptor, configurable: true };
+    }
+    Object.defineProperties(shell, descriptors);
+    if (array)
+        shell.length = value.length;
+    return shell;
+}
+/** The own data value at `key`, `absent`, or a refusal for a getter (never run). */
+function own(target, key, path) {
+    const descriptor = Object.getOwnPropertyDescriptor(target, String(key));
+    if (descriptor === undefined)
+        return 'absent';
+    if (!('value' in descriptor))
+        throw new FixError(`${path}: a getter is on the way; it is never run`);
+    return { value: descriptor.value };
+}
+function define(target, key, value) {
+    Object.defineProperty(target, String(key), { value, writable: true, enumerable: true, configurable: true });
+}
+/**
+ * The config with `edit(parent, key)` applied to the object holding the last segment of `path`, every
+ * object on the way copied and everything else shared: the input is never written. Missing objects
+ * on the way are created for keys, never for array indices.
+ */
+function edited(config, path, edit) {
+    const segments = pathSegments(path);
+    if (segments === undefined || segments.length === 0)
+        throw new FixError(`${path}: not a path to an option`);
+    const descend = (value, index) => {
+        if (!isContainer(value))
+            throw new FixError(`${path}: ${typeof value} on the way, not an object`);
+        const key = segments[index];
+        if (key === undefined)
+            throw new FixError(`${path}: not a path to an option`);
+        const copy = copyOf(value);
+        if (index === segments.length - 1) {
+            edit(copy, key);
+            return copy;
+        }
+        const next = own(value, key, path);
+        if (next === 'absent' && typeof key === 'number')
+            throw new FixError(`${path}: no element ${String(key)}`);
+        define(copy, key, descend(next === 'absent' ? {} : next.value, index + 1));
+        return copy;
+    };
+    return descend(config, 0);
+}
+function setOption(config, { path, from, value }, hadFrom) {
+    return edited(config, path, (parent, key) => {
+        const current = own(parent, key, path);
+        const holds = hadFrom ? current !== 'absent' && Object.is(current.value, from) : current === 'absent';
+        if (!holds)
+            throw new FixError(`${path}: the option is no longer ${hadFrom ? JSON.stringify(from) : 'unset'}`);
+        define(parent, key, value);
+    });
+}
+function renameKey(config, path, { to }) {
+    return edited(config, path, (parent, key) => {
+        const current = own(parent, key, path);
+        if (current === 'absent' || current.value === null)
+            throw new FixError(`${path}: nothing to rename`);
+        const target = own(parent, to, path);
+        if (target !== 'absent' && target.value !== undefined)
+            throw new FixError(`${path}: ${to} is already set`);
+        Reflect.deleteProperty(parent, String(key));
+        define(parent, to, current.value);
+    });
+}
+/**
+ * The config with `fix` applied (`path`: the finding's, for a rename): a new object, the input never
+ * written and no getter run. Throws `FixError` when it no longer applies: a `set-option` whose option
+ * is not `from` any more, a rename whose key is gone or whose new name is taken, a path through a
+ * getter, a primitive or a missing array element.
+ */
+export function applyFix(config, fix, path) {
+    if (fix.kind === 'set-option')
+        return setOption(config, fix, Object.hasOwn(fix, 'from'));
+    if (path === undefined)
+        throw new FixError('a rename needs the path of the key it renames');
+    return renameKey(config, path, fix);
+}
+//# sourceMappingURL=fix.js.map

package/dist/fix.js.map

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

package/dist/guard.d.ts

@@ -0,0 +1,19 @@
+import type { ValidationOptions, ValidationResult } from './diagnostic.js';
+/** Validates a config for one library and returns the full result; findings are never thrown. */
+export type ConfigValidator = (config: unknown, options?: ValidationOptions) => ValidationResult;
+/** Receives a validation's result before the chart is created or refused. */
+export type ValidationReporter = (validation: ValidationResult) => void;
+/**
+ * Validates `config` with `options` (the version the caller runs, what its runtime registered), then
+ * creates the chart with `create`, or throws `ConfigValidationError` when the config has confirmed errors.
+ */
+export type ValidateBeforeCreate = <T>(config: unknown, create: (value: unknown) => T, report?: ValidationReporter, options?: ValidationOptions) => T;
+/** Thrown instead of creating a chart; carries the full result so callers can inspect every diagnostic. */
+export declare class ConfigValidationError extends Error {
+    readonly result: ValidationResult;
+    readonly name = "ConfigValidationError";
+    constructor(library: string, result: ValidationResult);
+}
+/** Never monkey-patches global APIs. Caller owns the original factory and side effects. */
+export declare function createValidateBeforeCreate(library: string, validate: ConfigValidator): ValidateBeforeCreate;
+//# sourceMappingURL=guard.d.ts.map

package/dist/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../src/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,iGAAiG;AACjG,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;AACjG,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE,gBAAgB,KAAK,IAAI,CAAC;AACxE;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,EACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,EAC7B,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,KACvB,CAAC,CAAC;AAEP,2GAA2G;AAC3G,qBAAa,qBAAsB,SAAQ,KAAK;IAK9C,QAAQ,CAAC,MAAM,EAAE,gBAAgB;IAJlC,SAAkB,IAAI,2BAA2B;gBAGhD,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,gBAAgB;CAKlC;AAED,2FAA2F;AAC3F,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,oBAAoB,CAO3G"}

package/dist/guard.js

@@ -0,0 +1,22 @@
+import { isConfirmedError } from './result.js';
+/** Thrown instead of creating a chart; carries the full result so callers can inspect every diagnostic. */
+export class ConfigValidationError extends Error {
+    result;
+    name = 'ConfigValidationError';
+    constructor(library, result) {
+        const paths = result.diagnostics.filter(isConfirmedError).map((diagnostic) => diagnostic.path);
+        super(`${library} config invalid: ${paths.join(', ')}`);
+        this.result = result;
+    }
+}
+/** Never monkey-patches global APIs. Caller owns the original factory and side effects. */
+export function createValidateBeforeCreate(library, validate) {
+    return (config, create, report, options) => {
+        const checked = validate(config, options);
+        report?.(checked);
+        if (!checked.valid)
+            throw new ConfigValidationError(library, checked);
+        return create(config);
+    };
+}
+//# sourceMappingURL=guard.js.map

package/dist/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../src/guard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAiB/C,2GAA2G;AAC3G,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAKrC;IAJQ,IAAI,GAAG,uBAAuB,CAAC;IAEjD,YACC,OAAe,EACN,MAAwB;QAEjC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/F,KAAK,CAAC,GAAG,OAAO,oBAAoB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAH/C,WAAM,GAAN,MAAM,CAAkB;IAIlC,CAAC;CACD;AAED,2FAA2F;AAC3F,MAAM,UAAU,0BAA0B,CAAC,OAAe,EAAE,QAAyB;IACpF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;QAClB,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,MAAM,IAAI,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export type { Confidence, Coverage, Diagnostic, Fix, KeyRename, OptionEdit, OptionValue, QualityReport, RegistryContext, Severity, Suppression, ValidationOptions, ValidationResult, ValidationStatus } from './diagnostic.js';
+export { applyFix, FixError } from './fix.js';
+export type { ConfigValidator, ValidateBeforeCreate, ValidationReporter } from './guard.js';
+export { ConfigValidationError, createValidateBeforeCreate } from './guard.js';
+export type { JsonNode, JsonSource, JsonSpan } from './json-source.js';
+export { locateJsonKey, locateJsonPath, parseJsonSource } from './json-source.js';
+export type { OwnProperty } from './object.js';
+export { isContainer, isRecord, ownDataProperty } from './object.js';
+export { keySegment, pathSegments } from './paths.js';
+export { documented, REFERENCE_URL, referenceUrl } from './reference.js';
+export { isConfirmedError, result } from './result.js';
+export { suggestion, type SuggestionBudget, suggestionBudget } from './suggestion.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,UAAU,EACV,QAAQ,EACR,UAAU,EACV,GAAG,EACH,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC/E,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { applyFix, FixError } from './fix.js';
+export { ConfigValidationError, createValidateBeforeCreate } from './guard.js';
+export { locateJsonKey, locateJsonPath, parseJsonSource } from './json-source.js';
+export { isContainer, isRecord, ownDataProperty } from './object.js';
+export { keySegment, pathSegments } from './paths.js';
+export { documented, REFERENCE_URL, referenceUrl } from './reference.js';
+export { isConfirmedError, result } from './result.js';
+export { suggestion, suggestionBudget } from './suggestion.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAElF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAyB,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/json-source.d.ts

@@ -0,0 +1,54 @@
+/**
+ * A JSON text read with the position of every value (CG-06-02), so a finding's path can be shown
+ * where it is: in an editor (the playground) or in a SARIF log (the CLI). Exactly `JSON.parse`'s
+ * grammar; positions are offsets and 1-based lines and columns (UTF-16 code units, as editors count).
+ */
+export interface JsonSpan {
+    readonly start: number;
+    readonly end: number;
+    readonly line: number;
+    readonly column: number;
+    readonly endLine: number;
+    readonly endColumn: number;
+}
+/** A JSON value with its span: a scalar, an array of items, or an object of entries by key. */
+export type JsonNode = (JsonSpan & {
+    readonly kind: 'scalar';
+}) | (JsonSpan & {
+    readonly kind: 'array';
+    readonly items: readonly JsonNode[];
+}) | (JsonSpan & {
+    readonly kind: 'object';
+    readonly entries: ReadonlyMap<string, JsonNode>;
+});
+/**
+ * What `parseJsonSource` read: the root value with every position, or, for a text that is not JSON,
+ * the reason and where it was found.
+ */
+export type JsonSource = {
+    readonly ok: true;
+    readonly root: JsonNode;
+} | {
+    readonly ok: false;
+    readonly message: string;
+    readonly offset: number;
+    readonly line: number;
+    readonly column: number;
+};
+/** The JSON text with the position of every value, or its first syntax error and where. Never throws. */
+export declare function parseJsonSource(text: string): JsonSource;
+/**
+ * Where the value at a finding's `path` is. A path that does not exist (a missing required key)
+ * resolves to its deepest existing ancestor and is marked inexact; a path that is not one the
+ * engine writes is the root, inexact.
+ */
+export declare function locateJsonPath(root: JsonNode, path: string): JsonSpan & {
+    readonly exact: boolean;
+};
+/**
+ * Where the key token of `key` in an object `parseJsonSource` read is (quotes included), so an
+ * editor can rename it (CG-06-06); for a duplicate key the last, whose value `JSON.parse` keeps.
+ * Undefined when the object has no such key, or the node was not read by `parseJsonSource`.
+ */
+export declare function locateJsonKey(object: JsonNode, key: string): JsonSpan | undefined;
+//# sourceMappingURL=json-source.d.ts.map

package/dist/json-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-source.d.ts","sourceRoot":"","sources":["../src/json-source.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,+FAA+F;AAC/F,MAAM,MAAM,QAAQ,GACjB,CAAC,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,GACxC,CAAC,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,CAAC,GAC5E,CAAC,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CAAE,CAAC,CAAC;AAK7F;;;GAGG;AACH,MAAM,MAAM,UAAU,GACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC9C;IACA,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACvB,CAAC;AAqIL,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAQxD;AAWD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAkBnG;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEjF"}

package/dist/json-source.js

@@ -0,0 +1,184 @@
+import { pathSegments } from './paths.js';
+/** The key tokens of each object `parseJsonSource` read, by key: what `locateJsonKey` answers from. */
+const KEYS = new WeakMap();
+/** The 1-based line and column of each offset of a text. */
+class Lines {
+    starts = [0];
+    constructor(text) {
+        for (let index = 0; index < text.length; index++)
+            if (text[index] === '\n')
+                this.starts.push(index + 1);
+    }
+    at(offset) {
+        let low = 0;
+        let high = this.starts.length - 1;
+        while (low < high) {
+            const middle = Math.ceil((low + high) / 2);
+            if ((this.starts[middle] ?? 0) <= offset)
+                low = middle;
+            else
+                high = middle - 1;
+        }
+        return { line: low + 1, column: offset - (this.starts[low] ?? 0) + 1 };
+    }
+    span(start, end) {
+        const from = this.at(start);
+        const to = this.at(end);
+        return { start, end, line: from.line, column: from.column, endLine: to.line, endColumn: to.column };
+    }
+}
+class SyntaxProblem extends Error {
+    offset;
+    constructor(message, offset) {
+        super(message);
+        this.offset = offset;
+    }
+}
+/** JSON whitespace: space, tab, line feed and carriage return only, not every Unicode space (H13). */
+const WHITESPACE = /[ \t\n\r]/;
+/** A string with only the escapes JSON knows, a number, `true`, `false` or `null`. */
+const SCALAR = /^(?:"(?:[^"\\\u0000-\u001f]|\\(?:["\\/bfnrt]|u[0-9a-fA-F]{4}))*"|-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?|true|false|null)/;
+/** A strict JSON reader that keeps the position of every value; it reports the first syntax error. */
+class Reader {
+    text;
+    lines;
+    offset = 0;
+    constructor(text, lines) {
+        this.text = text;
+        this.lines = lines;
+    }
+    document() {
+        const root = this.value();
+        this.skip();
+        if (this.offset < this.text.length)
+            this.fail('Unexpected text after the JSON value');
+        return root;
+    }
+    value() {
+        this.skip();
+        const next = this.text[this.offset];
+        if (next === '{')
+            return this.object();
+        if (next === '[')
+            return this.array();
+        return this.scalar();
+    }
+    object() {
+        const start = this.offset++;
+        const entries = new Map();
+        const keys = new Map();
+        if (this.peek() !== '}')
+            do {
+                this.skip();
+                const { kind: _kind, ...token } = this.require(this.scalar(), 'a property name');
+                const key = JSON.parse(this.text.slice(token.start, token.end));
+                this.expect(':');
+                entries.set(key, this.value());
+                keys.set(key, token);
+            } while (this.consume(','));
+        this.expect('}');
+        const node = { kind: 'object', ...this.lines.span(start, this.offset), entries };
+        KEYS.set(node, keys);
+        return node;
+    }
+    array() {
+        const start = this.offset++;
+        const items = [];
+        if (this.peek() !== ']')
+            do
+                items.push(this.value());
+            while (this.consume(','));
+        this.expect(']');
+        return { kind: 'array', ...this.lines.span(start, this.offset), items };
+    }
+    scalar() {
+        const match = SCALAR.exec(this.text.slice(this.offset));
+        if (match === null)
+            this.fail('Expected a JSON value');
+        const start = this.offset;
+        this.offset += match[0].length;
+        return { kind: 'scalar', ...this.lines.span(start, this.offset) };
+    }
+    require(span, what) {
+        if (this.text[span.start] !== '"')
+            throw new SyntaxProblem(`Expected ${what} in double quotes`, span.start);
+        return span;
+    }
+    peek() {
+        this.skip();
+        return this.text[this.offset];
+    }
+    consume(token) {
+        if (this.peek() !== token)
+            return false;
+        this.offset++;
+        return true;
+    }
+    expect(token) {
+        if (!this.consume(token))
+            this.fail(`Expected "${token}"`);
+    }
+    skip() {
+        while (this.offset < this.text.length && WHITESPACE.test(this.text.charAt(this.offset)))
+            this.offset++;
+    }
+    fail(message) {
+        throw new SyntaxProblem(message, this.offset);
+    }
+}
+/** The JSON text with the position of every value, or its first syntax error and where. Never throws. */
+export function parseJsonSource(text) {
+    const lines = new Lines(text);
+    try {
+        return { ok: true, root: new Reader(text, lines).document() };
+    }
+    catch (error) {
+        if (!(error instanceof SyntaxProblem))
+            throw error;
+        return { ok: false, message: error.message, offset: error.offset, ...lines.at(error.offset) };
+    }
+}
+function child(node, segment) {
+    if (node.kind === 'array' && typeof segment === 'number')
+        return node.items[segment];
+    if (node.kind === 'object' && typeof segment === 'string')
+        return node.entries.get(segment);
+    return undefined;
+}
+/** A run of holes (`[3..9]`, one finding for a sparse list) is read as its first index. */
+const HOLE_RUN = /\[(\d+)\.\.\d+\]/gu;
+/**
+ * Where the value at a finding's `path` is. A path that does not exist (a missing required key)
+ * resolves to its deepest existing ancestor and is marked inexact; a path that is not one the
+ * engine writes is the root, inexact.
+ */
+export function locateJsonPath(root, path) {
+    const segments = pathSegments(path.replace(HOLE_RUN, '[$1]'));
+    const span = (node) => ({
+        start: node.start,
+        end: node.end,
+        line: node.line,
+        column: node.column,
+        endLine: node.endLine,
+        endColumn: node.endColumn
+    });
+    if (segments === undefined)
+        return { ...span(root), exact: false };
+    let node = root;
+    for (const segment of segments) {
+        const next = child(node, segment);
+        if (next === undefined)
+            return { ...span(node), exact: false };
+        node = next;
+    }
+    return { ...span(node), exact: true };
+}
+/**
+ * Where the key token of `key` in an object `parseJsonSource` read is (quotes included), so an
+ * editor can rename it (CG-06-06); for a duplicate key the last, whose value `JSON.parse` keeps.
+ * Undefined when the object has no such key, or the node was not read by `parseJsonSource`.
+ */
+export function locateJsonKey(object, key) {
+    return KEYS.get(object)?.get(key);
+}
+//# sourceMappingURL=json-source.js.map

package/dist/json-source.js.map

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

package/dist/object.d.ts

@@ -0,0 +1,18 @@
+/** `accessor`: the key exists but holds a getter/setter, whose value cannot be known without running it. */
+export type OwnProperty = {
+    readonly found: true;
+    readonly value: unknown;
+} | {
+    readonly found: false;
+    readonly accessor: boolean;
+};
+/** Whether `value` is a non-null object that is not an array. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Whether `value` is a non-null object, arrays included: something that can hold properties. */
+export declare function isContainer(value: unknown): value is object;
+/**
+ * Reads an own data property. Accessors are reported as missing so getters never run.
+ * A Proxy is the caller's object: its `getOwnPropertyDescriptor` trap does run, and an error it throws propagates.
+ */
+export declare function ownDataProperty(target: object, key: string): OwnProperty;
+//# sourceMappingURL=object.d.ts.map

package/dist/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,MAAM,WAAW,GACtB;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAK3G,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAKxE"}

package/dist/object.js

@@ -0,0 +1,23 @@
+const MISSING = { found: false, accessor: false };
+const ACCESSOR = { found: false, accessor: true };
+/** Whether `value` is a non-null object that is not an array. */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Whether `value` is a non-null object, arrays included: something that can hold properties. */
+export function isContainer(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Reads an own data property. Accessors are reported as missing so getters never run.
+ * A Proxy is the caller's object: its `getOwnPropertyDescriptor` trap does run, and an error it throws propagates.
+ */
+export function ownDataProperty(target, key) {
+    const descriptor = Object.getOwnPropertyDescriptor(target, key);
+    if (descriptor === undefined)
+        return MISSING;
+    if (!('value' in descriptor))
+        return ACCESSOR;
+    return { found: true, value: descriptor.value };
+}
+//# sourceMappingURL=object.js.map

package/dist/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,GAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC/D,MAAM,QAAQ,GAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAE/D,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,GAAW;IAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChE,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC7C,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAgB,EAAE,CAAC;AAC5D,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The path segment of an object key: `.key` for an identifier, `["key"]` (JSON-quoted) for any
+ * other, so every path names exactly one place (`$.title["te.xt"]` is not `$.title.te.xt`).
+ */
+export declare function keySegment(key: string): string;
+/**
+ * The keys and indices a path names, in order: the inverse of the notation `keySegment` writes
+ * (`$.series[0].label["a b"]` → `['series', 0, 'label', 'a b']`); undefined for anything else. Only
+ * that one spelling is read, so a place has one path (`[01]`, `["a"]` or an escaped key are not
+ * paths, E29), and a malformed one is undefined, never a thrown error (K15).
+ */
+export declare function pathSegments(path: string): (string | number)[] | undefined;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAyBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,CAa1E"}

package/dist/paths.js

@@ -0,0 +1,54 @@
+const IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
+/**
+ * The path segment of an object key: `.key` for an identifier, `["key"]` (JSON-quoted) for any
+ * other, so every path names exactly one place (`$.title["te.xt"]` is not `$.title.te.xt`).
+ */
+export function keySegment(key) {
+    return IDENTIFIER.test(key) ? `.${key}` : `[${JSON.stringify(key)}]`;
+}
+const SEGMENT = /\.([A-Za-z_$][\w$]*)|\[(0|[1-9]\d*)\]|\[("(?:[^"\\]|\\.)*")\]/y;
+/** The key a quoted segment names, when it is quoted as `keySegment` quotes it; otherwise undefined. */
+function quotedKey(quoted) {
+    let key;
+    try {
+        key = JSON.parse(quoted);
+    }
+    catch {
+        return undefined;
+    }
+    return typeof key === 'string' && keySegment(key) === `[${quoted}]` ? key : undefined;
+}
+/** One segment as `SEGMENT` matched it; undefined for a spelling `keySegment` does not write. */
+function segmentOf([, name, index, quoted]) {
+    if (name !== undefined)
+        return name;
+    if (index !== undefined) {
+        const value = Number(index);
+        return Number.isSafeInteger(value) ? value : undefined;
+    }
+    return quoted === undefined ? undefined : quotedKey(quoted);
+}
+/**
+ * The keys and indices a path names, in order: the inverse of the notation `keySegment` writes
+ * (`$.series[0].label["a b"]` → `['series', 0, 'label', 'a b']`); undefined for anything else. Only
+ * that one spelling is read, so a place has one path (`[01]`, `["a"]` or an escaped key are not
+ * paths, E29), and a malformed one is undefined, never a thrown error (K15).
+ */
+export function pathSegments(path) {
+    if (!path.startsWith('$'))
+        return undefined;
+    const segments = [];
+    SEGMENT.lastIndex = 1;
+    while (SEGMENT.lastIndex < path.length) {
+        const start = SEGMENT.lastIndex;
+        const match = SEGMENT.exec(path);
+        if (match?.index !== start)
+            return undefined;
+        const segment = segmentOf(match);
+        if (segment === undefined)
+            return undefined;
+        segments.push(segment);
+    }
+    return segments;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACrC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;AACtE,CAAC;AAED,MAAM,OAAO,GAAG,gEAAgE,CAAC;AAEjF,wGAAwG;AACxG,SAAS,SAAS,CAAC,MAAc;IAChC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACJ,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACvF,CAAC;AAED,iGAAiG;AACjG,SAAS,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAkB;IAC1D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;IACtB,OAAO,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,EAAE,KAAK,KAAK,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/reference.d.ts

@@ -0,0 +1,15 @@
+import type { Diagnostic } from './diagnostic.js';
+/**
+ * The published reference (CG-06-07): the repository's GitHub Pages site, with the reference at
+ * `/reference/`. Its codes page has an anchor for every code a package emits, the quality codes
+ * included, so a link is formed from the code alone and core still knows no code.
+ */
+export declare const REFERENCE_URL = "https://dovicsin.github.io/chartguard/reference/";
+/** Where `code` is explained: its anchor on the reference's codes page. */
+export declare function referenceUrl(code: string): string;
+/**
+ * The finding with a link to where it is explained: its own when it has one (a migration page the
+ * adapter names), else its code's anchor in the reference.
+ */
+export declare function documented(diagnostic: Diagnostic): Diagnostic;
+//# sourceMappingURL=reference.d.ts.map

package/dist/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,aAAa,qDAAqD,CAAC;AAEhF,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAI7D"}

package/dist/reference.js

@@ -0,0 +1,20 @@
+/**
+ * The published reference (CG-06-07): the repository's GitHub Pages site, with the reference at
+ * `/reference/`. Its codes page has an anchor for every code a package emits, the quality codes
+ * included, so a link is formed from the code alone and core still knows no code.
+ */
+export const REFERENCE_URL = 'https://dovicsin.github.io/chartguard/reference/';
+/** Where `code` is explained: its anchor on the reference's codes page. */
+export function referenceUrl(code) {
+    return `${REFERENCE_URL}codes.html#${encodeURIComponent(code)}`;
+}
+/**
+ * The finding with a link to where it is explained: its own when it has one (a migration page the
+ * adapter names), else its code's anchor in the reference.
+ */
+export function documented(diagnostic) {
+    return diagnostic.documentationUrl === undefined
+        ? { ...diagnostic, documentationUrl: referenceUrl(diagnostic.code) }
+        : diagnostic;
+}
+//# sourceMappingURL=reference.js.map

package/dist/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kDAAkD,CAAC;AAEhF,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,OAAO,GAAG,aAAa,cAAc,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,UAAsB;IAChD,OAAO,UAAU,CAAC,gBAAgB,KAAK,SAAS;QAC/C,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,gBAAgB,EAAE,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;QACpE,CAAC,CAAC,UAAU,CAAC;AACf,CAAC"}

package/dist/result.d.ts

@@ -0,0 +1,9 @@
+import type { Coverage, Diagnostic, ValidationResult } from './diagnostic.js';
+/** Whether the finding is a confirmed error: severity `error`, whatever its code. */
+export declare function isConfirmedError(diagnostic: Diagnostic): boolean;
+/**
+ * The only place that derives `valid` and `status`; callers never assemble a result by hand. Every
+ * finding leaves it with a `documentationUrl`.
+ */
+export declare function result(library: string, schemaVersion: string, coverage: Coverage, diagnostics: Diagnostic[]): ValidationResult;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAoB,MAAM,iBAAiB,CAAC;AAGhG,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEhE;AAiBD;;;GAGG;AACH,wBAAgB,MAAM,CACrB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,UAAU,EAAE,GACvB,gBAAgB,CAUlB"}

package/dist/result.js

@@ -0,0 +1,36 @@
+import { documented } from './reference.js';
+/** Whether the finding is a confirmed error: severity `error`, whatever its code. */
+export function isConfirmedError(diagnostic) {
+    return diagnostic.severity === 'error';
+}
+/**
+ * Producers mark anything they could not decide with `confidence: 'unknown'`, and a likely problem
+ * read from a schema fact that is not authoritative with `'inferred'` (CG-02-07). Either keeps a
+ * result from `valid`, which needs a complete, authoritative check. Codes carry no meaning here.
+ */
+function isUndecided(diagnostic) {
+    return diagnostic.confidence !== 'certain';
+}
+function statusOf(coverage, diagnostics) {
+    if (diagnostics.some(isConfirmedError))
+        return 'invalid';
+    if (coverage === 'partial' || diagnostics.some(isUndecided))
+        return 'partial';
+    return 'valid';
+}
+/**
+ * The only place that derives `valid` and `status`; callers never assemble a result by hand. Every
+ * finding leaves it with a `documentationUrl`.
+ */
+export function result(library, schemaVersion, coverage, diagnostics) {
+    const status = statusOf(coverage, diagnostics);
+    return {
+        valid: status !== 'invalid',
+        status,
+        library,
+        schemaVersion,
+        coverage,
+        diagnostics: diagnostics.map(documented)
+    };
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAAC,UAAsB;IACtD,OAAO,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,UAAsB;IAC1C,OAAO,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC;AAC5C,CAAC;AAED,SAAS,QAAQ,CAAC,QAAkB,EAAE,WAAkC;IACvE,IAAI,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAAE,OAAO,SAAS,CAAC;IACzD,IAAI,QAAQ,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9E,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CACrB,OAAe,EACf,aAAqB,EACrB,QAAkB,EAClB,WAAyB;IAEzB,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/C,OAAO;QACN,KAAK,EAAE,MAAM,KAAK,SAAS;QAC3B,MAAM;QACN,OAAO;QACP,aAAa;QACb,QAAQ;QACR,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC;KACxC,CAAC;AACH,CAAC"}

package/dist/suggestion.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The work typo hints may still do, in distance cells. Both the names and how many are compared come
+ * from the input, so one run shares one budget; once it is spent, no further hint is searched for.
+ */
+export declare class SuggestionBudget {
+    private left;
+    constructor(left: number);
+    /** The cells not yet spent. */
+    get cells(): number;
+    /** Spends `cells` when that many are left; false (nothing spent) otherwise. */
+    spend(cells: number): boolean;
+}
+/** A fresh budget for one run (`cells`: for tests and callers with their own bound). */
+export declare function suggestionBudget(cells?: number): SuggestionBudget;
+/**
+ * Closest candidate within a typo-sized edit distance, if any: the first one at the smallest
+ * distance. Bounded for untrusted names: none for a name over 100 characters, candidates whose length
+ * alone rules them out are skipped, and the search stops (no hint) when `budget` is spent.
+ */
+export declare function suggestion(input: string, candidates: readonly string[], budget?: SuggestionBudget): string | undefined;
+//# sourceMappingURL=suggestion.d.ts.map

package/dist/suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.d.ts","sourceRoot":"","sources":["../src/suggestion.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,qBAAa,gBAAgB;IAChB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEhC,+BAA+B;IAC/B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,+EAA+E;IAC/E,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAK7B;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,MAAkB,GAAG,gBAAgB,CAE5E;AA0BD;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,GAAE,gBAA+C,GACrD,MAAM,GAAG,SAAS,CAepB"}

package/dist/suggestion.js

@@ -0,0 +1,81 @@
+/** Names longer than this get no typo hint: a typo-sized edit of a long name is no longer a typo. */
+const MAX_HINT_LENGTH = 100;
+/** Distance cells one call may compute when the caller gives no budget of its own. */
+const CALL_CELLS = 100_000;
+/** Distance cells one run (a validation) may spend on hints, whatever the input holds. */
+const RUN_CELLS = 2_000_000;
+/**
+ * The work typo hints may still do, in distance cells. Both the names and how many are compared come
+ * from the input, so one run shares one budget; once it is spent, no further hint is searched for.
+ */
+export class SuggestionBudget {
+    left;
+    constructor(left) {
+        this.left = left;
+    }
+    /** The cells not yet spent. */
+    get cells() {
+        return this.left;
+    }
+    /** Spends `cells` when that many are left; false (nothing spent) otherwise. */
+    spend(cells) {
+        if (this.left < cells)
+            return false;
+        this.left -= cells;
+        return true;
+    }
+}
+/** A fresh budget for one run (`cells`: for tests and callers with their own bound). */
+export function suggestionBudget(cells = RUN_CELLS) {
+    return new SuggestionBudget(cells);
+}
+/**
+ * Levenshtein distance with a single rolling row, given only up to `limit`: `limit + 1` once every
+ * cell of a row exceeds it, `undefined` when the budget is spent first.
+ */
+function distanceWithin(source, target, limit, budget) {
+    const row = Array.from({ length: target.length + 1 }, (_, index) => index);
+    for (let i = 1; i <= source.length; i++) {
+        if (!budget.spend(target.length))
+            return undefined;
+        let diagonal = i - 1;
+        row[0] = i;
+        let lowest = i;
+        for (let k = 1; k <= target.length; k++) {
+            const above = row[k] ?? 0;
+            const left = row[k - 1] ?? 0;
+            const substitution = source.charAt(i - 1) === target.charAt(k - 1) ? 0 : 1;
+            row[k] = Math.min(left + 1, above + 1, diagonal + substitution);
+            lowest = Math.min(lowest, row[k] ?? 0);
+            diagonal = above;
+        }
+        if (lowest > limit)
+            return limit + 1;
+    }
+    return row[target.length] ?? 0;
+}
+/**
+ * Closest candidate within a typo-sized edit distance, if any: the first one at the smallest
+ * distance. Bounded for untrusted names: none for a name over 100 characters, candidates whose length
+ * alone rules them out are skipped, and the search stops (no hint) when `budget` is spent.
+ */
+export function suggestion(input, candidates, budget = suggestionBudget(CALL_CELLS)) {
+    if (input.length > MAX_HINT_LENGTH)
+        return undefined;
+    let best;
+    let bestDistance = Math.max(1, Math.floor(input.length / 4)) + 1;
+    for (const candidate of candidates) {
+        // The distance is at least the difference in length: such a candidate cannot be closer.
+        if (Math.abs(candidate.length - input.length) >= bestDistance)
+            continue;
+        const distance = distanceWithin(input, candidate, bestDistance - 1, budget);
+        if (distance === undefined)
+            return undefined;
+        if (distance < bestDistance) {
+            best = candidate;
+            bestDistance = distance;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=suggestion.js.map

package/dist/suggestion.js.map

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

package/package.json

@@ -1,6 +1,36 @@
 {
-  "name": "@chartguard/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@chartguard/core",
+	"version": "0.1.1",
+	"description": "Shared diagnostics, statuses and runtime contracts",
+	"type": "module",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/dovicsin/chartguard.git",
+		"directory": "packages/core"
+	},
+	"sideEffects": false,
+	"engines": {
+		"node": ">=22.12.0"
+	},
+	"files": [
+		"dist/",
+		"README.md"
+	],
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
+	},
+	"scripts": {
+		"build": "tsc -b",
+		"test": "node --test tests/*.test.mjs"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}