@uapkg/diagnostics 1.1.8 → 1.1.10

package/dist/base/Diagnostic.d.ts

@@ -0,0 +1,30 @@
+import type { DiagnosticLevel } from './DiagnosticLevel.js';
+export type DiagnosticEmitPolicy = 'always' | 'once';
+/**
+ * Base shape for all diagnostics. Every concrete diagnostic must extend this
+ * interface, discriminating on `code` so that `data` is always strongly typed.
+ *
+ * @typeParam C - The string literal diagnostic code.
+ * @typeParam D - The shape of the typed data payload (defaults to `undefined`).
+ */
+export interface DiagnosticBase<C extends string = string, D = undefined> {
+    /** Severity of this diagnostic. */
+    readonly level: DiagnosticLevel;
+    /** Stable, machine-readable code used for discrimination. */
+    readonly code: C;
+    /** Human-readable summary. */
+    readonly message: string;
+    /** Actionable hint shown to the user. */
+    readonly hint?: string;
+    /** Emit strategy for user-facing reporting. */
+    readonly emitPolicy?: DiagnosticEmitPolicy;
+    /** Stable dedupe key used when `emitPolicy` is `once`. */
+    readonly emitFingerprint?: string;
+    /** Strongly typed payload whose shape is determined by `code`. */
+    readonly data: D;
+}
+/** Create an error-level diagnostic. */
+export declare function createDiagnostic<C extends string, D = undefined>(code: C, level: DiagnosticLevel, message: string, data: D, hint?: string, options?: {
+    readonly emitPolicy?: DiagnosticEmitPolicy;
+}): DiagnosticBase<C, D>;
+//# sourceMappingURL=Diagnostic.d.ts.map

package/dist/base/Diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Diagnostic.d.ts","sourceRoot":"","sources":["../../src/base/Diagnostic.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,SAAS;IACtE,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAEhC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAEjB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAE3C,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;CAClB;AAMD,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,SAAS,EAC9D,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,EACP,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;CAC5C,GACA,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAsBtB"}

package/dist/base/Diagnostic.js

@@ -0,0 +1,27 @@
+import { createDiagnosticFingerprint } from './DiagnosticFingerprint.js';
+// ---------------------------------------------------------------------------
+// Convenience helpers to construct a diagnostic without specifying every field
+// ---------------------------------------------------------------------------
+/** Create an error-level diagnostic. */
+export function createDiagnostic(code, level, message, data, hint, options) {
+    const emitPolicy = options?.emitPolicy;
+    const emitFingerprint = emitPolicy === 'once'
+        ? createDiagnosticFingerprint({
+            level,
+            code,
+            message,
+            hint,
+            data,
+        })
+        : undefined;
+    return {
+        level,
+        code,
+        message,
+        data,
+        hint,
+        emitPolicy,
+        emitFingerprint,
+    };
+}
+//# sourceMappingURL=Diagnostic.js.map

package/dist/base/Diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Diagnostic.js","sourceRoot":"","sources":["../../src/base/Diagnostic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAmCzE,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAE9E,wCAAwC;AACxC,MAAM,UAAU,gBAAgB,CAC9B,IAAO,EACP,KAAsB,EACtB,OAAe,EACf,IAAO,EACP,IAAa,EACb,OAEC;IAED,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;IACvC,MAAM,eAAe,GACnB,UAAU,KAAK,MAAM;QACnB,CAAC,CAAC,2BAA2B,CAAC;YAC1B,KAAK;YACL,IAAI;YACJ,OAAO;YACP,IAAI;YACJ,IAAI;SACL,CAAC;QACJ,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,KAAK;QACL,IAAI;QACJ,OAAO;QACP,IAAI;QACJ,IAAI;QACJ,UAAU;QACV,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/base/DiagnosticBag.d.ts

@@ -0,0 +1,42 @@
+import type { Diagnostic } from '../types.js';
+import type { DiagnosticLevel } from './DiagnosticLevel.js';
+import { type Result } from './Result.js';
+/**
+ * Mutable accumulator for diagnostics produced during an operation.
+ *
+ * Typical usage:
+ * ```ts
+ * const bag = new DiagnosticBag();
+ * bag.addError('MY_CODE', 'Something broke', undefined, 'Try X');
+ * if (bag.hasErrors()) return bag.toFailure();
+ * return bag.toResult(value);
+ * ```
+ */
+export declare class DiagnosticBag {
+    private readonly items;
+    /** Number of diagnostics collected so far. */
+    get length(): number;
+    /** Add a pre-built diagnostic. */
+    add(diagnostic: Diagnostic): this;
+    /** Shorthand: add an error-level diagnostic. */
+    addError<C extends string, D = undefined>(code: C, message: string, data: D, hint?: string): this;
+    /** Shorthand: add a warning-level diagnostic. */
+    addWarning<C extends string, D = undefined>(code: C, message: string, data: D, hint?: string): this;
+    /** Shorthand: add an info-level diagnostic. */
+    addInfo<C extends string, D = undefined>(code: C, message: string, data: D, hint?: string): this;
+    /** Merge another bag's diagnostics into this one. */
+    merge(other: DiagnosticBag): this;
+    /** Merge a readonly diagnostic array into this bag. */
+    mergeArray(diagnostics: readonly Diagnostic[]): this;
+    /** True if at least one diagnostic has level `error`. */
+    hasErrors(): boolean;
+    /** True if at least one diagnostic has the given level. */
+    hasLevel(level: DiagnosticLevel): boolean;
+    /** Return all collected diagnostics as a readonly array. */
+    all(): readonly Diagnostic[];
+    /** Build a successful `Result<T>` carrying accumulated diagnostics. */
+    toResult<T>(value: T): Result<T>;
+    /** Build a failed `Result` from the accumulated diagnostics. */
+    toFailure(): Result<never>;
+}
+//# sourceMappingURL=DiagnosticBag.d.ts.map

package/dist/base/DiagnosticBag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticBag.d.ts","sourceRoot":"","sources":["../../src/base/DiagnosticBag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,8CAA8C;IAC9C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,kCAAkC;IAClC,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKjC,gDAAgD;IAChD,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAKjG,iDAAiD;IACjD,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAKnG,+CAA+C;IAC/C,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAKhG,qDAAqD;IACrD,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAOjC,uDAAuD;IACvD,UAAU,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI;IAOpD,yDAAyD;IACzD,SAAS,IAAI,OAAO;IAIpB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IAIzC,4DAA4D;IAC5D,GAAG,IAAI,SAAS,UAAU,EAAE;IAI5B,uEAAuE;IACvE,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAOhC,gEAAgE;IAChE,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC;CAG3B"}

package/dist/base/DiagnosticBag.js

@@ -0,0 +1,78 @@
+import { createDiagnostic } from './Diagnostic.js';
+import { fail, ok } from './Result.js';
+/**
+ * Mutable accumulator for diagnostics produced during an operation.
+ *
+ * Typical usage:
+ * ```ts
+ * const bag = new DiagnosticBag();
+ * bag.addError('MY_CODE', 'Something broke', undefined, 'Try X');
+ * if (bag.hasErrors()) return bag.toFailure();
+ * return bag.toResult(value);
+ * ```
+ */
+export class DiagnosticBag {
+    items = [];
+    /** Number of diagnostics collected so far. */
+    get length() {
+        return this.items.length;
+    }
+    /** Add a pre-built diagnostic. */
+    add(diagnostic) {
+        this.items.push(diagnostic);
+        return this;
+    }
+    /** Shorthand: add an error-level diagnostic. */
+    addError(code, message, data, hint) {
+        this.items.push(createDiagnostic(code, 'error', message, data, hint));
+        return this;
+    }
+    /** Shorthand: add a warning-level diagnostic. */
+    addWarning(code, message, data, hint) {
+        this.items.push(createDiagnostic(code, 'warning', message, data, hint));
+        return this;
+    }
+    /** Shorthand: add an info-level diagnostic. */
+    addInfo(code, message, data, hint) {
+        this.items.push(createDiagnostic(code, 'info', message, data, hint));
+        return this;
+    }
+    /** Merge another bag's diagnostics into this one. */
+    merge(other) {
+        for (const d of other.items) {
+            this.items.push(d);
+        }
+        return this;
+    }
+    /** Merge a readonly diagnostic array into this bag. */
+    mergeArray(diagnostics) {
+        for (const d of diagnostics) {
+            this.items.push(d);
+        }
+        return this;
+    }
+    /** True if at least one diagnostic has level `error`. */
+    hasErrors() {
+        return this.items.some((d) => d.level === 'error');
+    }
+    /** True if at least one diagnostic has the given level. */
+    hasLevel(level) {
+        return this.items.some((d) => d.level === level);
+    }
+    /** Return all collected diagnostics as a readonly array. */
+    all() {
+        return this.items;
+    }
+    /** Build a successful `Result<T>` carrying accumulated diagnostics. */
+    toResult(value) {
+        if (this.hasErrors()) {
+            return fail(this.items);
+        }
+        return ok(value, this.items);
+    }
+    /** Build a failed `Result` from the accumulated diagnostics. */
+    toFailure() {
+        return fail(this.items);
+    }
+}
+//# sourceMappingURL=DiagnosticBag.js.map

package/dist/base/DiagnosticBag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticBag.js","sourceRoot":"","sources":["../../src/base/DiagnosticBag.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAe,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAa;IACP,KAAK,GAAiB,EAAE,CAAC;IAE1C,8CAA8C;IAC9C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,kCAAkC;IAClC,GAAG,CAAC,UAAsB;QACxB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,QAAQ,CAAkC,IAAO,EAAE,OAAe,EAAE,IAAO,EAAE,IAAa;QACxF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAe,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iDAAiD;IACjD,UAAU,CAAkC,IAAO,EAAE,OAAe,EAAE,IAAO,EAAE,IAAa;QAC1F,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAe,CAAC,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+CAA+C;IAC/C,OAAO,CAAkC,IAAO,EAAE,OAAe,EAAE,IAAO,EAAE,IAAa;QACvF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAe,CAAC,CAAC;QACnF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,KAAoB;QACxB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uDAAuD;IACvD,UAAU,CAAC,WAAkC;QAC3C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yDAAyD;IACzD,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,2DAA2D;IAC3D,QAAQ,CAAC,KAAsB;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,4DAA4D;IAC5D,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,uEAAuE;IACvE,QAAQ,CAAI,KAAQ;QAClB,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,gEAAgE;IAChE,SAAS;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/base/DiagnosticFingerprint.d.ts

@@ -0,0 +1,11 @@
+import type { DiagnosticLevel } from './DiagnosticLevel.js';
+interface FingerprintInput {
+    readonly level: DiagnosticLevel;
+    readonly code: string;
+    readonly message: string;
+    readonly hint?: string;
+    readonly data: unknown;
+}
+export declare function createDiagnosticFingerprint(input: FingerprintInput): string;
+export {};
+//# sourceMappingURL=DiagnosticFingerprint.d.ts.map

package/dist/base/DiagnosticFingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticFingerprint.d.ts","sourceRoot":"","sources":["../../src/base/DiagnosticFingerprint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,UAAU,gBAAgB;IACxB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAU3E"}

package/dist/base/DiagnosticFingerprint.js

@@ -0,0 +1,23 @@
+import { createHash } from 'node:crypto';
+export function createDiagnosticFingerprint(input) {
+    const serialized = stableSerialize({
+        level: input.level,
+        code: input.code,
+        message: input.message,
+        hint: input.hint ?? null,
+        data: input.data ?? null,
+    });
+    return createHash('sha256').update(serialized).digest('hex');
+}
+function stableSerialize(value) {
+    if (value === null || typeof value !== 'object') {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableSerialize(item)).join(',')}]`;
+    }
+    const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b));
+    const body = entries.map(([key, item]) => `${JSON.stringify(key)}:${stableSerialize(item)}`).join(',');
+    return `{${body}}`;
+}
+//# sourceMappingURL=DiagnosticFingerprint.js.map

package/dist/base/DiagnosticFingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticFingerprint.js","sourceRoot":"","sources":["../../src/base/DiagnosticFingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,MAAM,UAAU,2BAA2B,CAAC,KAAuB;IACjE,MAAM,UAAU,GAAG,eAAe,CAAC;QACjC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;KACzB,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACxG,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvG,OAAO,IAAI,IAAI,GAAG,CAAC;AACrB,CAAC"}

package/dist/base/DiagnosticLevel.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Diagnostic severity levels.
+ *
+ * - `error`   – operation cannot continue
+ * - `warning` – operation can continue but something is concerning
+ * - `info`    – informational only
+ */
+export type DiagnosticLevel = 'error' | 'warning' | 'info';
+//# sourceMappingURL=DiagnosticLevel.d.ts.map

package/dist/base/DiagnosticLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticLevel.d.ts","sourceRoot":"","sources":["../../src/base/DiagnosticLevel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC"}

package/dist/base/DiagnosticLevel.js

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

package/dist/base/DiagnosticLevel.js.map

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

package/dist/base/Result.d.ts

@@ -0,0 +1,24 @@
+import type { Diagnostic } from '../types.js';
+/** Successful result carrying a value and optional diagnostics. */
+export interface ResultOk<T> {
+    readonly ok: true;
+    readonly value: T;
+    readonly diagnostics: readonly Diagnostic[];
+}
+/** Failed result carrying at least one diagnostic. */
+export interface ResultFail {
+    readonly ok: false;
+    readonly diagnostics: readonly Diagnostic[];
+}
+/** Discriminated union returned by every fallible uapkg operation. */
+export type Result<T> = ResultOk<T> | ResultFail;
+/** Create a successful result. */
+export declare function ok<T>(value: T, diagnostics?: readonly Diagnostic[]): ResultOk<T>;
+/** Create a failed result. */
+export declare function fail(diagnostics: readonly Diagnostic[]): ResultFail;
+/**
+ * Build a result from a diagnostics array and an optional value.
+ * If any diagnostic has level `error`, the result is a failure.
+ */
+export declare function fromDiagnostics<T>(diagnostics: readonly Diagnostic[], value?: T): Result<T>;
+//# sourceMappingURL=Result.d.ts.map

package/dist/base/Result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../src/base/Result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C,mEAAmE;AACnE,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,sEAAsE;AACtE,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;AAMjD,kCAAkC;AAClC,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,GAAE,SAAS,UAAU,EAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAEpF;AAED,8BAA8B;AAC9B,wBAAgB,IAAI,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,CAEnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAM3F"}

package/dist/base/Result.js

@@ -0,0 +1,23 @@
+// ---------------------------------------------------------------------------
+// Factory helpers
+// ---------------------------------------------------------------------------
+/** Create a successful result. */
+export function ok(value, diagnostics = []) {
+    return { ok: true, value, diagnostics };
+}
+/** Create a failed result. */
+export function fail(diagnostics) {
+    return { ok: false, diagnostics };
+}
+/**
+ * Build a result from a diagnostics array and an optional value.
+ * If any diagnostic has level `error`, the result is a failure.
+ */
+export function fromDiagnostics(diagnostics, value) {
+    const hasError = diagnostics.some((d) => d.level === 'error');
+    if (hasError || value === undefined) {
+        return { ok: false, diagnostics };
+    }
+    return { ok: true, value, diagnostics };
+}
+//# sourceMappingURL=Result.js.map

package/dist/base/Result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.js","sourceRoot":"","sources":["../../src/base/Result.ts"],"names":[],"mappings":"AAsBA,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,kCAAkC;AAClC,MAAM,UAAU,EAAE,CAAI,KAAQ,EAAE,cAAqC,EAAE;IACrE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAC1C,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,IAAI,CAAC,WAAkC;IACrD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAI,WAAkC,EAAE,KAAS;IAC9E,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;IAC9D,IAAI,QAAQ,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAC1C,CAAC"}

package/dist/config/ConfigDiagnostics.d.ts

@@ -0,0 +1,47 @@
+import type { DiagnosticBase } from '../base/Diagnostic.js';
+/** A config file contains invalid JSON and could not be parsed. */
+export type ConfigInvalidJsonDiagnostic = DiagnosticBase<'CONFIG_INVALID_JSON', {
+    readonly filePath: string;
+    readonly reason: string;
+}>;
+/** Config value type is incompatible with expected merge shape. */
+export type ConfigTypeMismatchDiagnostic = DiagnosticBase<'CONFIG_TYPE_MISMATCH', {
+    readonly path: string;
+    readonly expectedType: string;
+    readonly actualType: string;
+    readonly source: string;
+    readonly filePath?: string;
+}>;
+/** Unknown config key encountered in a config layer. */
+export type ConfigUnknownKeyDiagnostic = DiagnosticBase<'CONFIG_UNKNOWN_KEY', {
+    readonly path: string;
+    readonly source: string;
+    readonly filePath?: string;
+}>;
+/** Cross-field semantic mismatch: default registry not defined in registries map. */
+export type ConfigUnresolvedDefaultRegistryDiagnostic = DiagnosticBase<'CONFIG_UNRESOLVED_DEFAULT_REGISTRY', {
+    readonly registryName: string;
+}>;
+/** Value failed a narrower semantic validation rule. */
+export type ConfigInvalidValueDiagnostic = DiagnosticBase<'CONFIG_INVALID_VALUE', {
+    readonly path: string;
+    readonly rule: string;
+}>;
+/** Union of all config diagnostics. */
+export type ConfigDiagnostic = ConfigInvalidJsonDiagnostic | ConfigTypeMismatchDiagnostic | ConfigUnknownKeyDiagnostic | ConfigUnresolvedDefaultRegistryDiagnostic | ConfigInvalidValueDiagnostic;
+export declare function createConfigInvalidJsonDiagnostic(filePath: string, reason: string): ConfigInvalidJsonDiagnostic;
+export declare function createConfigTypeMismatchDiagnostic(input: {
+    readonly path: string;
+    readonly expectedType: string;
+    readonly actualType: string;
+    readonly source: string;
+    readonly filePath?: string;
+}): ConfigTypeMismatchDiagnostic;
+export declare function createConfigUnknownKeyDiagnostic(input: {
+    readonly path: string;
+    readonly source: string;
+    readonly filePath?: string;
+}): ConfigUnknownKeyDiagnostic;
+export declare function createConfigUnresolvedDefaultRegistryDiagnostic(registryName: string): ConfigUnresolvedDefaultRegistryDiagnostic;
+export declare function createConfigInvalidValueDiagnostic(path: string, rule: string): ConfigInvalidValueDiagnostic;
+//# sourceMappingURL=ConfigDiagnostics.d.ts.map

package/dist/config/ConfigDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigDiagnostics.d.ts","sourceRoot":"","sources":["../../src/config/ConfigDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,mEAAmE;AACnE,MAAM,MAAM,2BAA2B,GAAG,cAAc,CACtD,qBAAqB,EACrB;IACE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CACF,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,4BAA4B,GAAG,cAAc,CACvD,sBAAsB,EACtB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CACF,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,0BAA0B,GAAG,cAAc,CACrD,oBAAoB,EACpB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CACF,CAAC;AAEF,qFAAqF;AACrF,MAAM,MAAM,yCAAyC,GAAG,cAAc,CACpE,oCAAoC,EACpC;IACE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CACF,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,4BAA4B,GAAG,cAAc,CACvD,sBAAsB,EACtB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CACF,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GACxB,2BAA2B,GAC3B,4BAA4B,GAC5B,0BAA0B,GAC1B,yCAAyC,GACzC,4BAA4B,CAAC;AAEjC,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,2BAA2B,CAQ/G;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,4BAA4B,CAQ/B;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,0BAA0B,CAQ7B;AAED,wBAAgB,+CAA+C,CAC7D,YAAY,EAAE,MAAM,GACnB,yCAAyC,CAS3C;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,4BAA4B,CAQ3G"}

package/dist/config/ConfigDiagnostics.js

@@ -0,0 +1,47 @@
+export function createConfigInvalidJsonDiagnostic(filePath, reason) {
+    return {
+        level: 'warning',
+        code: 'CONFIG_INVALID_JSON',
+        message: `Ignoring invalid JSON in config file "${filePath}".`,
+        hint: 'Fix JSON syntax in this file to restore those settings.',
+        data: { filePath, reason },
+    };
+}
+export function createConfigTypeMismatchDiagnostic(input) {
+    return {
+        level: 'warning',
+        code: 'CONFIG_TYPE_MISMATCH',
+        message: `Ignoring config value at "${input.path}" because it is ${input.actualType}, expected ${input.expectedType}.`,
+        hint: 'Use a value type compatible with this config key.',
+        data: input,
+    };
+}
+export function createConfigUnknownKeyDiagnostic(input) {
+    return {
+        level: 'warning',
+        code: 'CONFIG_UNKNOWN_KEY',
+        message: `Ignoring unknown config key "${input.path}".`,
+        hint: 'Remove or rename this key to a supported configuration path.',
+        data: input,
+    };
+}
+export function createConfigUnresolvedDefaultRegistryDiagnostic(registryName) {
+    return {
+        level: 'warning',
+        code: 'CONFIG_UNRESOLVED_DEFAULT_REGISTRY',
+        message: `Default registry "${registryName}" is not defined under "registries".`,
+        emitPolicy: 'once',
+        hint: `Add "registries.${registryName}" or set a different default with 'uapkg registry use <name>'.`,
+        data: { registryName },
+    };
+}
+export function createConfigInvalidValueDiagnostic(path, rule) {
+    return {
+        level: 'warning',
+        code: 'CONFIG_INVALID_VALUE',
+        message: `Config value at "${path}" may be invalid: ${rule}.`,
+        hint: 'Update this value to match the expected format for this key.',
+        data: { path, rule },
+    };
+}
+//# sourceMappingURL=ConfigDiagnostics.js.map

package/dist/config/ConfigDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigDiagnostics.js","sourceRoot":"","sources":["../../src/config/ConfigDiagnostics.ts"],"names":[],"mappings":"AA0DA,MAAM,UAAU,iCAAiC,CAAC,QAAgB,EAAE,MAAc;IAChF,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,yCAAyC,QAAQ,IAAI;QAC9D,IAAI,EAAE,yDAAyD;QAC/D,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAMlD;IACC,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,6BAA6B,KAAK,CAAC,IAAI,mBAAmB,KAAK,CAAC,UAAU,cAAc,KAAK,CAAC,YAAY,GAAG;QACtH,IAAI,EAAE,mDAAmD;QACzD,IAAI,EAAE,KAAK;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,KAIhD;IACC,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,gCAAgC,KAAK,CAAC,IAAI,IAAI;QACvD,IAAI,EAAE,8DAA8D;QACpE,IAAI,EAAE,KAAK;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+CAA+C,CAC7D,YAAoB;IAEpB,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,oCAAoC;QAC1C,OAAO,EAAE,qBAAqB,YAAY,sCAAsC;QAChF,UAAU,EAAE,MAAM;QAClB,IAAI,EAAE,mBAAmB,YAAY,gEAAgE;QACrG,IAAI,EAAE,EAAE,YAAY,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,IAAY,EAAE,IAAY;IAC3E,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,oBAAoB,IAAI,qBAAqB,IAAI,GAAG;QAC7D,IAAI,EAAE,8DAA8D;QACpE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;KACrB,CAAC;AACJ,CAAC"}

package/dist/general/GeneralDiagnostics.d.ts

@@ -0,0 +1,21 @@
+import type { DiagnosticBase } from '../base/Diagnostic.js';
+/** Generic JSON or data parse error. */
+export type ParseErrorDiagnostic = DiagnosticBase<'PARSE_ERROR', {
+    readonly filePath?: string;
+    readonly reason: string;
+}>;
+/** File system I/O error. */
+export type IoErrorDiagnostic = DiagnosticBase<'IO_ERROR', {
+    readonly path: string;
+    readonly reason: string;
+}>;
+/** Catch-all for truly unexpected situations (should be rare). */
+export type UnknownErrorDiagnostic = DiagnosticBase<'UNKNOWN_ERROR', {
+    readonly reason: string;
+}>;
+/** Union of all general diagnostics. */
+export type GeneralDiagnostic = ParseErrorDiagnostic | IoErrorDiagnostic | UnknownErrorDiagnostic;
+export declare function createParseErrorDiagnostic(reason: string, filePath?: string): ParseErrorDiagnostic;
+export declare function createIoErrorDiagnostic(path: string, reason: string): IoErrorDiagnostic;
+export declare function createUnknownErrorDiagnostic(reason: string): UnknownErrorDiagnostic;
+//# sourceMappingURL=GeneralDiagnostics.d.ts.map

package/dist/general/GeneralDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeneralDiagnostics.d.ts","sourceRoot":"","sources":["../../src/general/GeneralDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM5D,wCAAwC;AACxC,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAC/C,aAAa,EACb;IACE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CACF,CAAC;AAEF,6BAA6B;AAC7B,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAC5C,UAAU,EACV;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CACF,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,sBAAsB,GAAG,cAAc,CACjD,eAAe,EACf;IACE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CACF,CAAC;AAEF,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,sBAAsB,CAAC;AAMlG,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAQlG;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAQvF;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAQnF"}

package/dist/general/GeneralDiagnostics.js

@@ -0,0 +1,31 @@
+// ---------------------------------------------------------------------------
+// Factory helpers
+// ---------------------------------------------------------------------------
+export function createParseErrorDiagnostic(reason, filePath) {
+    return {
+        level: 'error',
+        code: 'PARSE_ERROR',
+        message: filePath ? `Parse error in "${filePath}": ${reason}.` : `Parse error: ${reason}.`,
+        hint: 'Ensure the input is well-formed.',
+        data: { filePath, reason },
+    };
+}
+export function createIoErrorDiagnostic(path, reason) {
+    return {
+        level: 'error',
+        code: 'IO_ERROR',
+        message: `I/O error at "${path}": ${reason}.`,
+        hint: 'Check file permissions and that the path exists.',
+        data: { path, reason },
+    };
+}
+export function createUnknownErrorDiagnostic(reason) {
+    return {
+        level: 'error',
+        code: 'UNKNOWN_ERROR',
+        message: `An unexpected error occurred: ${reason}.`,
+        hint: 'If this persists, please report a bug.',
+        data: { reason },
+    };
+}
+//# sourceMappingURL=GeneralDiagnostics.js.map

package/dist/general/GeneralDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeneralDiagnostics.js","sourceRoot":"","sources":["../../src/general/GeneralDiagnostics.ts"],"names":[],"mappings":"AAmCA,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,UAAU,0BAA0B,CAAC,MAAc,EAAE,QAAiB;IAC1E,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,mBAAmB,QAAQ,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,gBAAgB,MAAM,GAAG;QAC1F,IAAI,EAAE,kCAAkC;QACxC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,MAAc;IAClE,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,iBAAiB,IAAI,MAAM,MAAM,GAAG;QAC7C,IAAI,EAAE,kDAAkD;QACxD,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,iCAAiC,MAAM,GAAG;QACnD,IAAI,EAAE,wCAAwC;QAC9C,IAAI,EAAE,EAAE,MAAM,EAAE;KACjB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export type { DiagnosticBase, DiagnosticEmitPolicy } from './base/Diagnostic.js';
+export { createDiagnostic } from './base/Diagnostic.js';
+export { DiagnosticBag } from './base/DiagnosticBag.js';
+export { createDiagnosticFingerprint } from './base/DiagnosticFingerprint.js';
+export type { DiagnosticLevel } from './base/DiagnosticLevel.js';
+export type { Result, ResultFail, ResultOk } from './base/Result.js';
+export { fail, fromDiagnostics, ok } from './base/Result.js';
+export type { ConfigDiagnostic, ConfigInvalidJsonDiagnostic, ConfigInvalidValueDiagnostic, ConfigTypeMismatchDiagnostic, ConfigUnknownKeyDiagnostic, ConfigUnresolvedDefaultRegistryDiagnostic, } from './config/ConfigDiagnostics.js';
+export { createConfigInvalidJsonDiagnostic, createConfigInvalidValueDiagnostic, createConfigTypeMismatchDiagnostic, createConfigUnknownKeyDiagnostic, createConfigUnresolvedDefaultRegistryDiagnostic, } from './config/ConfigDiagnostics.js';
+export type { GeneralDiagnostic, IoErrorDiagnostic, ParseErrorDiagnostic, UnknownErrorDiagnostic, } from './general/GeneralDiagnostics.js';
+export { createIoErrorDiagnostic, createParseErrorDiagnostic, createUnknownErrorDiagnostic, } from './general/GeneralDiagnostics.js';
+export type { DiskRemoveFailedDiagnostic, DownloadFailedDiagnostic, DownloadHttpStatusDiagnostic, ExtractionFailedDiagnostic, InstallerDiagnostic, IntegrityMismatchDiagnostic, NetworkRetriesExhaustedDiagnostic, NetworkTimeoutDiagnostic, } from './installer/InstallerDiagnostics.js';
+export { createDiskRemoveFailedDiagnostic, createDownloadFailedDiagnostic, createDownloadHttpStatusDiagnostic, createExtractionFailedDiagnostic, createIntegrityMismatchDiagnostic, createNetworkRetriesExhaustedDiagnostic, createNetworkTimeoutDiagnostic, } from './installer/InstallerDiagnostics.js';
+export type { DependencyNotFoundDiagnostic, ForbiddenOverridesDiagnostic, LockfileInvalidDiagnostic, LockfileMissingDiagnostic, LockfileOutOfSyncDiagnostic, ManifestDiagnostic, ManifestInvalidDiagnostic, ManifestReadErrorDiagnostic, ManifestWriteErrorDiagnostic, UnresolvedRegistryDiagnostic, } from './manifest/ManifestDiagnostics.js';
+export { createDependencyNotFoundDiagnostic, createForbiddenOverridesDiagnostic, createLockfileInvalidDiagnostic, createLockfileMissingDiagnostic, createLockfileOutOfSyncDiagnostic, createManifestInvalidDiagnostic, createManifestReadErrorDiagnostic, createManifestWriteErrorDiagnostic, createUnresolvedRegistryDiagnostic, } from './manifest/ManifestDiagnostics.js';
+export type { CyclicSymlinkDiagnostic, InvalidPathDiagnostic, LfsSkippedDiagnostic, NoFilesSelectedDiagnostic, OutFileIsDirectoryDiagnostic, PackDiagnostic, PluginRootNotFoundDiagnostic, SymlinkOutsideRootDiagnostic, UnresolvedLfsDiagnostic, UpluginMissingDiagnostic, } from './pack/PackDiagnostics.js';
+export { createCyclicSymlinkDiagnostic, createInvalidPathDiagnostic, createLfsSkippedDiagnostic, createNoFilesSelectedDiagnostic, createOutFileIsDirectoryDiagnostic, createPluginRootNotFoundDiagnostic, createSymlinkOutsideRootDiagnostic, createUnresolvedLfsDiagnostic, createUpluginMissingDiagnostic, } from './pack/PackDiagnostics.js';
+export type { PostinstallDiagnostic, PostinstallDuplicateEntryDiagnostic, PostinstallEsbuildErrorDiagnostic, PostinstallInvalidExportDiagnostic, PostinstallLoadFailedDiagnostic, PostinstallMarkerCorruptDiagnostic, PostinstallPolicyDeniedDiagnostic, } from './postinstall/PostinstallDiagnostics.js';
+export { createPostinstallDuplicateEntryDiagnostic, createPostinstallEsbuildErrorDiagnostic, createPostinstallInvalidExportDiagnostic, createPostinstallLoadFailedDiagnostic, createPostinstallMarkerCorruptDiagnostic, createPostinstallPolicyDeniedDiagnostic, } from './postinstall/PostinstallDiagnostics.js';
+export type { CacheReadErrorDiagnostic, GitErrorDiagnostic, LockAcquisitionFailedDiagnostic, NetworkErrorDiagnostic, RegistryDiagnostic, RegistryNotFoundDiagnostic, RegistryUnreachableDiagnostic, SchemaInvalidDiagnostic, } from './registry/RegistryDiagnostics.js';
+export { createCacheReadErrorDiagnostic, createGitErrorDiagnostic, createLockAcquisitionFailedDiagnostic, createNetworkErrorDiagnostic, createRegistryNotFoundDiagnostic, createRegistryUnreachableDiagnostic, createSchemaInvalidDiagnostic, } from './registry/RegistryDiagnostics.js';
+export type { RegistryToolsDependencyNotInRegistryDiagnostic, RegistryToolsDependencyRangeUnreachableDiagnostic, RegistryToolsDiagnostic, RegistryToolsExternalRegistryDeniedDiagnostic, RegistryToolsExternalRegistryNotAllowedDiagnostic, RegistryToolsIntegrityMismatchDiagnostic, RegistryToolsOfficialPolicyViolationDiagnostic, RegistryToolsPackageMissingDiagnostic, RegistryToolsPackageSourceMismatchDiagnostic, RegistryToolsPathMismatchDiagnostic, RegistryToolsReleaseFileNameInvalidDiagnostic, RegistryToolsRemovalDeniedDiagnostic, RegistryToolsUnknownKeyDiagnostic, RegistryToolsVersionExistsDiagnostic, RegistryToolsVersionNotFoundDiagnostic, RegistryToolsVersionsUnsortedDiagnostic, } from './registryTools/RegistryToolsDiagnostics.js';
+export { createRegistryToolsDependencyNotInRegistryDiagnostic, createRegistryToolsDependencyRangeUnreachableDiagnostic, createRegistryToolsExternalRegistryDeniedDiagnostic, createRegistryToolsExternalRegistryNotAllowedDiagnostic, createRegistryToolsIntegrityMismatchDiagnostic, createRegistryToolsOfficialPolicyViolationDiagnostic, createRegistryToolsPackageMissingDiagnostic, createRegistryToolsPackageSourceMismatchDiagnostic, createRegistryToolsPathMismatchDiagnostic, createRegistryToolsReleaseFileNameInvalidDiagnostic, createRegistryToolsRemovalDeniedDiagnostic, createRegistryToolsUnknownKeyDiagnostic, createRegistryToolsVersionExistsDiagnostic, createRegistryToolsVersionNotFoundDiagnostic, createRegistryToolsVersionsUnsortedDiagnostic, } from './registryTools/RegistryToolsDiagnostics.js';
+export type { CircularDepDiagnostic, PackageNotFoundDiagnostic, RegistryNameCollisionDiagnostic, ResolverDiagnostic, VersionConflictDiagnostic, VersionNotFoundDiagnostic, } from './resolver/ResolverDiagnostics.js';
+export { createCircularDepDiagnostic, createPackageNotFoundDiagnostic, createRegistryNameCollisionDiagnostic, createVersionConflictDiagnostic, createVersionNotFoundDiagnostic, } from './resolver/ResolverDiagnostics.js';
+export type { SafetyDiagnostic, SafetyOverriddenByForceDiagnostic, SafetyPathNotProjectManifestDiagnostic, SafetyTargetExistsNoManifestDiagnostic, } from './safety/SafetyDiagnostics.js';
+export { createSafetyOverriddenByForceDiagnostic, createSafetyPathNotProjectManifestDiagnostic, createSafetyTargetExistsNoManifestDiagnostic, } from './safety/SafetyDiagnostics.js';
+export type { InvalidOrgNameDiagnostic, InvalidPackageSpecDiagnostic, InvalidVersionRangeDiagnostic, SpecParseDiagnostic, } from './spec/SpecDiagnostics.js';
+export { createInvalidOrgNameDiagnostic, createInvalidPackageSpecDiagnostic, createInvalidVersionRangeDiagnostic, } from './spec/SpecDiagnostics.js';
+export type { Diagnostic, DiagnosticByCode, DiagnosticCode } from './types.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":"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"}

package/dist/index.js

@@ -0,0 +1,19 @@
+// ---------------------------------------------------------------------------
+// @uapkg/diagnostics — public API
+// ---------------------------------------------------------------------------
+export { createDiagnostic } from './base/Diagnostic.js';
+export { DiagnosticBag } from './base/DiagnosticBag.js';
+export { createDiagnosticFingerprint } from './base/DiagnosticFingerprint.js';
+export { fail, fromDiagnostics, ok } from './base/Result.js';
+export { createConfigInvalidJsonDiagnostic, createConfigInvalidValueDiagnostic, createConfigTypeMismatchDiagnostic, createConfigUnknownKeyDiagnostic, createConfigUnresolvedDefaultRegistryDiagnostic, } from './config/ConfigDiagnostics.js';
+export { createIoErrorDiagnostic, createParseErrorDiagnostic, createUnknownErrorDiagnostic, } from './general/GeneralDiagnostics.js';
+export { createDiskRemoveFailedDiagnostic, createDownloadFailedDiagnostic, createDownloadHttpStatusDiagnostic, createExtractionFailedDiagnostic, createIntegrityMismatchDiagnostic, createNetworkRetriesExhaustedDiagnostic, createNetworkTimeoutDiagnostic, } from './installer/InstallerDiagnostics.js';
+export { createDependencyNotFoundDiagnostic, createForbiddenOverridesDiagnostic, createLockfileInvalidDiagnostic, createLockfileMissingDiagnostic, createLockfileOutOfSyncDiagnostic, createManifestInvalidDiagnostic, createManifestReadErrorDiagnostic, createManifestWriteErrorDiagnostic, createUnresolvedRegistryDiagnostic, } from './manifest/ManifestDiagnostics.js';
+export { createCyclicSymlinkDiagnostic, createInvalidPathDiagnostic, createLfsSkippedDiagnostic, createNoFilesSelectedDiagnostic, createOutFileIsDirectoryDiagnostic, createPluginRootNotFoundDiagnostic, createSymlinkOutsideRootDiagnostic, createUnresolvedLfsDiagnostic, createUpluginMissingDiagnostic, } from './pack/PackDiagnostics.js';
+export { createPostinstallDuplicateEntryDiagnostic, createPostinstallEsbuildErrorDiagnostic, createPostinstallInvalidExportDiagnostic, createPostinstallLoadFailedDiagnostic, createPostinstallMarkerCorruptDiagnostic, createPostinstallPolicyDeniedDiagnostic, } from './postinstall/PostinstallDiagnostics.js';
+export { createCacheReadErrorDiagnostic, createGitErrorDiagnostic, createLockAcquisitionFailedDiagnostic, createNetworkErrorDiagnostic, createRegistryNotFoundDiagnostic, createRegistryUnreachableDiagnostic, createSchemaInvalidDiagnostic, } from './registry/RegistryDiagnostics.js';
+export { createRegistryToolsDependencyNotInRegistryDiagnostic, createRegistryToolsDependencyRangeUnreachableDiagnostic, createRegistryToolsExternalRegistryDeniedDiagnostic, createRegistryToolsExternalRegistryNotAllowedDiagnostic, createRegistryToolsIntegrityMismatchDiagnostic, createRegistryToolsOfficialPolicyViolationDiagnostic, createRegistryToolsPackageMissingDiagnostic, createRegistryToolsPackageSourceMismatchDiagnostic, createRegistryToolsPathMismatchDiagnostic, createRegistryToolsReleaseFileNameInvalidDiagnostic, createRegistryToolsRemovalDeniedDiagnostic, createRegistryToolsUnknownKeyDiagnostic, createRegistryToolsVersionExistsDiagnostic, createRegistryToolsVersionNotFoundDiagnostic, createRegistryToolsVersionsUnsortedDiagnostic, } from './registryTools/RegistryToolsDiagnostics.js';
+export { createCircularDepDiagnostic, createPackageNotFoundDiagnostic, createRegistryNameCollisionDiagnostic, createVersionConflictDiagnostic, createVersionNotFoundDiagnostic, } from './resolver/ResolverDiagnostics.js';
+export { createSafetyOverriddenByForceDiagnostic, createSafetyPathNotProjectManifestDiagnostic, createSafetyTargetExistsNoManifestDiagnostic, } from './safety/SafetyDiagnostics.js';
+export { createInvalidOrgNameDiagnostic, createInvalidPackageSpecDiagnostic, createInvalidVersionRangeDiagnostic, } from './spec/SpecDiagnostics.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":"AAAA,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAG9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAI9E,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAU7D,OAAO,EACL,iCAAiC,EACjC,kCAAkC,EAClC,kCAAkC,EAClC,gCAAgC,EAChC,+CAA+C,GAChD,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AAYzC,OAAO,EACL,gCAAgC,EAChC,8BAA8B,EAC9B,kCAAkC,EAClC,gCAAgC,EAChC,iCAAiC,EACjC,uCAAuC,EACvC,8BAA8B,GAC/B,MAAM,qCAAqC,CAAC;AAc7C,OAAO,EACL,kCAAkC,EAClC,kCAAkC,EAClC,+BAA+B,EAC/B,+BAA+B,EAC/B,iCAAiC,EACjC,+BAA+B,EAC/B,iCAAiC,EACjC,kCAAkC,EAClC,kCAAkC,GACnC,MAAM,mCAAmC,CAAC;AAc3C,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,0BAA0B,EAC1B,+BAA+B,EAC/B,kCAAkC,EAClC,kCAAkC,EAClC,kCAAkC,EAClC,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAWnC,OAAO,EACL,yCAAyC,EACzC,uCAAuC,EACvC,wCAAwC,EACxC,qCAAqC,EACrC,wCAAwC,EACxC,uCAAuC,GACxC,MAAM,yCAAyC,CAAC;AAYjD,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,qCAAqC,EACrC,4BAA4B,EAC5B,gCAAgC,EAChC,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,mCAAmC,CAAC;AAoB3C,OAAO,EACL,oDAAoD,EACpD,uDAAuD,EACvD,mDAAmD,EACnD,uDAAuD,EACvD,8CAA8C,EAC9C,oDAAoD,EACpD,2CAA2C,EAC3C,kDAAkD,EAClD,yCAAyC,EACzC,mDAAmD,EACnD,0CAA0C,EAC1C,uCAAuC,EACvC,0CAA0C,EAC1C,4CAA4C,EAC5C,6CAA6C,GAC9C,MAAM,6CAA6C,CAAC;AAUrD,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,qCAAqC,EACrC,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,mCAAmC,CAAC;AAQ3C,OAAO,EACL,uCAAuC,EACvC,4CAA4C,EAC5C,4CAA4C,GAC7C,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,EAClC,mCAAmC,GACpC,MAAM,2BAA2B,CAAC"}