@uapkg/diagnostics 1.2.0 → 1.3.1

package/dist/base/Diagnostic.d.ts

@@ -1,5 +1,6 @@
-import type { DiagnosticLevel } from './DiagnosticLevel.js';
-export type DiagnosticEmitPolicy = 'always' | 'once';
+import { DiagnosticLevel } from "./DiagnosticLevel.js";
+//#region src/base/Diagnostic.d.ts
+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.
@@ -7,24 +8,26 @@ export type DiagnosticEmitPolicy = 'always' | 'once';
  * @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;
+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;
+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>;
+//#endregion
+export { DiagnosticBase, DiagnosticEmitPolicy, createDiagnostic };
 //# sourceMappingURL=Diagnostic.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"Diagnostic.d.ts","names":[],"sources":["../../src/base/Diagnostic.ts"],"mappings":";;KAGY;;;;;;;;UASK,eAAe,2BAA2B;;WAEhD,OAAO;;WAGP,MAAM;;WAGN;;WAGA;;WAGA,aAAa;;WAGb;;WAGA,MAAM;;;iBAQD,iBAAiB,kBAAkB,eACjD,MAAM,GACN,OAAO,iBACP,iBACA,MAAM,GACN,eACA;WACW,aAAa;IAEvB,eAAe,GAAG"}

package/dist/base/Diagnostic.js

@@ -1,27 +1,26 @@
-import { createDiagnosticFingerprint } from './DiagnosticFingerprint.js';
-// ---------------------------------------------------------------------------
-// Convenience helpers to construct a diagnostic without specifying every field
-// ---------------------------------------------------------------------------
+import { createDiagnosticFingerprint } from "./DiagnosticFingerprint.js";
+
+//#region src/base/Diagnostic.ts
 /** 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,
-    };
+function createDiagnostic(code, level, message, data, hint, options) {
+	const emitPolicy = options?.emitPolicy;
+	return {
+		level,
+		code,
+		message,
+		data,
+		hint,
+		emitPolicy,
+		emitFingerprint: emitPolicy === "once" ? createDiagnosticFingerprint({
+			level,
+			code,
+			message,
+			hint,
+			data
+		}) : void 0
+	};
 }
+
+//#endregion
+export { createDiagnostic };
 //# sourceMappingURL=Diagnostic.js.map

package/dist/base/Diagnostic.js.map

@@ -1 +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"}
+{"version":3,"file":"Diagnostic.js","names":[],"sources":["../../src/base/Diagnostic.ts"],"sourcesContent":["import { createDiagnosticFingerprint } from './DiagnosticFingerprint.js';\nimport type { DiagnosticLevel } from './DiagnosticLevel.js';\n\nexport type DiagnosticEmitPolicy = 'always' | 'once';\n\n/**\n * Base shape for all diagnostics. Every concrete diagnostic must extend this\n * interface, discriminating on `code` so that `data` is always strongly typed.\n *\n * @typeParam C - The string literal diagnostic code.\n * @typeParam D - The shape of the typed data payload (defaults to `undefined`).\n */\nexport interface DiagnosticBase<C extends string = string, D = undefined> {\n  /** Severity of this diagnostic. */\n  readonly level: DiagnosticLevel;\n\n  /** Stable, machine-readable code used for discrimination. */\n  readonly code: C;\n\n  /** Human-readable summary. */\n  readonly message: string;\n\n  /** Actionable hint shown to the user. */\n  readonly hint?: string;\n\n  /** Emit strategy for user-facing reporting. */\n  readonly emitPolicy?: DiagnosticEmitPolicy;\n\n  /** Stable dedupe key used when `emitPolicy` is `once`. */\n  readonly emitFingerprint?: string;\n\n  /** Strongly typed payload whose shape is determined by `code`. */\n  readonly data: D;\n}\n\n// ---------------------------------------------------------------------------\n// Convenience helpers to construct a diagnostic without specifying every field\n// ---------------------------------------------------------------------------\n\n/** Create an error-level diagnostic. */\nexport function createDiagnostic<C extends string, D = undefined>(\n  code: C,\n  level: DiagnosticLevel,\n  message: string,\n  data: D,\n  hint?: string,\n  options?: {\n    readonly emitPolicy?: DiagnosticEmitPolicy;\n  },\n): DiagnosticBase<C, D> {\n  const emitPolicy = options?.emitPolicy;\n  const emitFingerprint =\n    emitPolicy === 'once'\n      ? createDiagnosticFingerprint({\n          level,\n          code,\n          message,\n          hint,\n          data,\n        })\n      : undefined;\n\n  return {\n    level,\n    code,\n    message,\n    data,\n    hint,\n    emitPolicy,\n    emitFingerprint,\n  };\n}\n"],"mappings":";;;;AAwCA,SAAgB,iBACd,MACA,OACA,SACA,MACA,MACA,SAGsB;CACtB,MAAM,aAAa,SAAS;CAY5B,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA,iBAjBA,eAAe,SACX,4BAA4B;GAC1B;GACA;GACA;GACA;GACA;EACF,CAAC,IACD;CAUN;AACF"}

package/dist/base/DiagnosticBag.d.ts

@@ -1,6 +1,7 @@
-import type { Diagnostic } from '../types.js';
-import type { DiagnosticLevel } from './DiagnosticLevel.js';
-import { type Result } from './Result.js';
+import { DiagnosticLevel } from "./DiagnosticLevel.js";
+import { Diagnostic } from "../types.js";
+import { Result } from "./Result.js";
+//#region src/base/DiagnosticBag.d.ts
 /**
  * Mutable accumulator for diagnostics produced during an operation.
  *
@@ -12,31 +13,33 @@ import { type Result } from './Result.js';
  * 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>;
+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>;
 }
+//#endregion
+export { DiagnosticBag };
 //# sourceMappingURL=DiagnosticBag.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"DiagnosticBag.d.ts","names":[],"sources":["../../src/base/DiagnosticBag.ts"],"mappings":";;;;;;;;;;;;;;;cAgBa;mBACM;;MAGb;;EAKJ,IAAI,YAAY;;EAMhB,SAAS,kBAAkB,eAAe,MAAM,GAAG,iBAAiB,MAAM,GAAG;;EAM7E,WAAW,kBAAkB,eAAe,MAAM,GAAG,iBAAiB,MAAM,GAAG;;EAM/E,QAAQ,kBAAkB,eAAe,MAAM,GAAG,iBAAiB,MAAM,GAAG;;EAM5E,MAAM,OAAO;;EAQb,WAAW,sBAAsB;;EAQjC;;EAKA,SAAS,OAAO;;EAKhB,gBAAgB;;EAKhB,SAAS,GAAG,OAAO,IAAI,OAAO;;EAQ9B,aAAa"}

package/dist/base/DiagnosticBag.js

@@ -1,78 +1,77 @@
-import { createDiagnostic } from './Diagnostic.js';
-import { fail, ok } from './Result.js';
+import { createDiagnostic } from "./Diagnostic.js";
+import { fail, ok } from "./Result.js";
+
+//#region src/base/DiagnosticBag.ts
 /**
- * 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);
-    }
-}
+* 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);
+* ```
+*/
+var DiagnosticBag = class {
+	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);
+	}
+};
+
+//#endregion
+export { DiagnosticBag };
 //# sourceMappingURL=DiagnosticBag.js.map

package/dist/base/DiagnosticBag.js.map

@@ -1 +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"}
+{"version":3,"file":"DiagnosticBag.js","names":[],"sources":["../../src/base/DiagnosticBag.ts"],"sourcesContent":["import type { Diagnostic } from '../types.js';\nimport { createDiagnostic } from './Diagnostic.js';\nimport type { DiagnosticLevel } from './DiagnosticLevel.js';\nimport { fail, ok, type Result } from './Result.js';\n\n/**\n * Mutable accumulator for diagnostics produced during an operation.\n *\n * Typical usage:\n * ```ts\n * const bag = new DiagnosticBag();\n * bag.addError('MY_CODE', 'Something broke', undefined, 'Try X');\n * if (bag.hasErrors()) return bag.toFailure();\n * return bag.toResult(value);\n * ```\n */\nexport class DiagnosticBag {\n  private readonly items: Diagnostic[] = [];\n\n  /** Number of diagnostics collected so far. */\n  get length(): number {\n    return this.items.length;\n  }\n\n  /** Add a pre-built diagnostic. */\n  add(diagnostic: Diagnostic): this {\n    this.items.push(diagnostic);\n    return this;\n  }\n\n  /** Shorthand: add an error-level diagnostic. */\n  addError<C extends string, D = undefined>(code: C, message: string, data: D, hint?: string): this {\n    this.items.push(createDiagnostic(code, 'error', message, data, hint) as Diagnostic);\n    return this;\n  }\n\n  /** Shorthand: add a warning-level diagnostic. */\n  addWarning<C extends string, D = undefined>(code: C, message: string, data: D, hint?: string): this {\n    this.items.push(createDiagnostic(code, 'warning', message, data, hint) as Diagnostic);\n    return this;\n  }\n\n  /** Shorthand: add an info-level diagnostic. */\n  addInfo<C extends string, D = undefined>(code: C, message: string, data: D, hint?: string): this {\n    this.items.push(createDiagnostic(code, 'info', message, data, hint) as Diagnostic);\n    return this;\n  }\n\n  /** Merge another bag's diagnostics into this one. */\n  merge(other: DiagnosticBag): this {\n    for (const d of other.items) {\n      this.items.push(d);\n    }\n    return this;\n  }\n\n  /** Merge a readonly diagnostic array into this bag. */\n  mergeArray(diagnostics: readonly Diagnostic[]): this {\n    for (const d of diagnostics) {\n      this.items.push(d);\n    }\n    return this;\n  }\n\n  /** True if at least one diagnostic has level `error`. */\n  hasErrors(): boolean {\n    return this.items.some((d) => d.level === 'error');\n  }\n\n  /** True if at least one diagnostic has the given level. */\n  hasLevel(level: DiagnosticLevel): boolean {\n    return this.items.some((d) => d.level === level);\n  }\n\n  /** Return all collected diagnostics as a readonly array. */\n  all(): readonly Diagnostic[] {\n    return this.items;\n  }\n\n  /** Build a successful `Result<T>` carrying accumulated diagnostics. */\n  toResult<T>(value: T): Result<T> {\n    if (this.hasErrors()) {\n      return fail(this.items);\n    }\n    return ok(value, this.items);\n  }\n\n  /** Build a failed `Result` from the accumulated diagnostics. */\n  toFailure(): Result<never> {\n    return fail(this.items);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,IAAa,gBAAb,MAA2B;CACzB,AAAiB,QAAsB,CAAC;;CAGxC,IAAI,SAAiB;EACnB,OAAO,KAAK,MAAM;CACpB;;CAGA,IAAI,YAA8B;EAChC,KAAK,MAAM,KAAK,UAAU;EAC1B,OAAO;CACT;;CAGA,SAA0C,MAAS,SAAiB,MAAS,MAAqB;EAChG,KAAK,MAAM,KAAK,iBAAiB,MAAM,SAAS,SAAS,MAAM,IAAI,CAAe;EAClF,OAAO;CACT;;CAGA,WAA4C,MAAS,SAAiB,MAAS,MAAqB;EAClG,KAAK,MAAM,KAAK,iBAAiB,MAAM,WAAW,SAAS,MAAM,IAAI,CAAe;EACpF,OAAO;CACT;;CAGA,QAAyC,MAAS,SAAiB,MAAS,MAAqB;EAC/F,KAAK,MAAM,KAAK,iBAAiB,MAAM,QAAQ,SAAS,MAAM,IAAI,CAAe;EACjF,OAAO;CACT;;CAGA,MAAM,OAA4B;EAChC,KAAK,MAAM,KAAK,MAAM,OACpB,KAAK,MAAM,KAAK,CAAC;EAEnB,OAAO;CACT;;CAGA,WAAW,aAA0C;EACnD,KAAK,MAAM,KAAK,aACd,KAAK,MAAM,KAAK,CAAC;EAEnB,OAAO;CACT;;CAGA,YAAqB;EACnB,OAAO,KAAK,MAAM,MAAM,MAAM,EAAE,UAAU,OAAO;CACnD;;CAGA,SAAS,OAAiC;EACxC,OAAO,KAAK,MAAM,MAAM,MAAM,EAAE,UAAU,KAAK;CACjD;;CAGA,MAA6B;EAC3B,OAAO,KAAK;CACd;;CAGA,SAAY,OAAqB;EAC/B,IAAI,KAAK,UAAU,GACjB,OAAO,KAAK,KAAK,KAAK;EAExB,OAAO,GAAG,OAAO,KAAK,KAAK;CAC7B;;CAGA,YAA2B;EACzB,OAAO,KAAK,KAAK,KAAK;CACxB;AACF"}

package/dist/base/DiagnosticFingerprint.d.ts

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

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

@@ -1 +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"}
+{"version":3,"file":"DiagnosticFingerprint.d.ts","names":[],"sources":["../../src/base/DiagnosticFingerprint.ts"],"mappings":";;UAGU;WACC,OAAO;WACP;WACA;WACA;WACA;;iBAGK,4BAA4B,OAAO"}

package/dist/base/DiagnosticFingerprint.js

@@ -1,23 +1,22 @@
-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');
+import { createHash } from "node:crypto";
+
+//#region src/base/DiagnosticFingerprint.ts
+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}}`;
+	if (value === null || typeof value !== "object") return JSON.stringify(value);
+	if (Array.isArray(value)) return `[${value.map((item) => stableSerialize(item)).join(",")}]`;
+	return `{${Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => `${JSON.stringify(key)}:${stableSerialize(item)}`).join(",")}}`;
 }
+
+//#endregion
+export { createDiagnosticFingerprint };
 //# sourceMappingURL=DiagnosticFingerprint.js.map

package/dist/base/DiagnosticFingerprint.js.map

@@ -1 +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"}
+{"version":3,"file":"DiagnosticFingerprint.js","names":[],"sources":["../../src/base/DiagnosticFingerprint.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport type { DiagnosticLevel } from './DiagnosticLevel.js';\n\ninterface FingerprintInput {\n  readonly level: DiagnosticLevel;\n  readonly code: string;\n  readonly message: string;\n  readonly hint?: string;\n  readonly data: unknown;\n}\n\nexport function createDiagnosticFingerprint(input: FingerprintInput): string {\n  const serialized = stableSerialize({\n    level: input.level,\n    code: input.code,\n    message: input.message,\n    hint: input.hint ?? null,\n    data: input.data ?? null,\n  });\n\n  return createHash('sha256').update(serialized).digest('hex');\n}\n\nfunction stableSerialize(value: unknown): string {\n  if (value === null || typeof value !== 'object') {\n    return JSON.stringify(value);\n  }\n\n  if (Array.isArray(value)) {\n    return `[${value.map((item) => stableSerialize(item)).join(',')}]`;\n  }\n\n  const entries = Object.entries(value as Record<string, unknown>).sort(([a], [b]) => a.localeCompare(b));\n  const body = entries.map(([key, item]) => `${JSON.stringify(key)}:${stableSerialize(item)}`).join(',');\n  return `{${body}}`;\n}\n"],"mappings":";;;AAWA,SAAgB,4BAA4B,OAAiC;CAC3E,MAAM,aAAa,gBAAgB;EACjC,OAAO,MAAM;EACb,MAAM,MAAM;EACZ,SAAS,MAAM;EACf,MAAM,MAAM,QAAQ;EACpB,MAAM,MAAM,QAAQ;CACtB,CAAC;CAED,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,OAAO,KAAK;AAC7D;AAEA,SAAS,gBAAgB,OAAwB;CAC/C,IAAI,UAAU,QAAQ,OAAO,UAAU,UACrC,OAAO,KAAK,UAAU,KAAK;CAG7B,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,IAAI,MAAM,KAAK,SAAS,gBAAgB,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;CAKlE,OAAO,IAFS,OAAO,QAAQ,KAAgC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAClF,CAAC,CAAC,KAAK,CAAC,KAAK,UAAU,GAAG,KAAK,UAAU,GAAG,EAAE,GAAG,gBAAgB,IAAI,GAAG,CAAC,CAAC,KAAK,GACpF,EAAE;AAClB"}

package/dist/base/DiagnosticLevel.d.ts

@@ -1,3 +1,4 @@
+//#region src/base/DiagnosticLevel.d.ts
 /**
  * Diagnostic severity levels.
  *
@@ -5,5 +6,7 @@
  * - `warning` – operation can continue but something is concerning
  * - `info`    – informational only
  */
-export type DiagnosticLevel = 'error' | 'warning' | 'info';
+type DiagnosticLevel = 'error' | 'warning' | 'info';
+//#endregion
+export { DiagnosticLevel };
 //# sourceMappingURL=DiagnosticLevel.d.ts.map

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

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

package/dist/base/DiagnosticLevel.js

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

package/dist/base/Result.d.ts

@@ -1,24 +1,27 @@
-import type { Diagnostic } from '../types.js';
+import { Diagnostic } from "../types.js";
+//#region src/base/Result.d.ts
 /** Successful result carrying a value and optional diagnostics. */
-export interface ResultOk<T> {
-    readonly ok: true;
-    readonly value: T;
-    readonly diagnostics: readonly Diagnostic[];
+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[];
+interface ResultFail {
+  readonly ok: false;
+  readonly diagnostics: readonly Diagnostic[];
 }
 /** Discriminated union returned by every fallible uapkg operation. */
-export type Result<T> = ResultOk<T> | ResultFail;
+type Result<T> = ResultOk<T> | ResultFail;
 /** Create a successful result. */
-export declare function ok<T>(value: T, diagnostics?: readonly Diagnostic[]): ResultOk<T>;
+declare function ok<T>(value: T, diagnostics?: readonly Diagnostic[]): ResultOk<T>;
 /** Create a failed result. */
-export declare function fail(diagnostics: readonly Diagnostic[]): ResultFail;
+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>;
+declare function fromDiagnostics<T>(diagnostics: readonly Diagnostic[], value?: T): Result<T>;
+//#endregion
+export { Result, ResultFail, ResultOk, fail, fromDiagnostics, ok };
 //# sourceMappingURL=Result.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"Result.d.ts","names":[],"sources":["../../src/base/Result.ts"],"mappings":";;;UAOiB,SAAS;WACf;WACA,OAAO;WACP,sBAAsB;;;UAIhB;WACN;WACA,sBAAsB;;;KAIrB,OAAO,KAAK,SAAS,KAAK;;iBAOtB,GAAG,GAAG,OAAO,GAAG,uBAAsB,eAAoB,SAAS;;iBAKnE,KAAK,sBAAsB,eAAe;;;;;iBAQ1C,gBAAgB,GAAG,sBAAsB,cAAc,QAAQ,IAAI,OAAO"}

package/dist/base/Result.js

@@ -1,23 +1,35 @@
-// ---------------------------------------------------------------------------
-// Factory helpers
-// ---------------------------------------------------------------------------
+//#region src/base/Result.ts
 /** Create a successful result. */
-export function ok(value, diagnostics = []) {
-    return { ok: true, value, diagnostics };
+function ok(value, diagnostics = []) {
+	return {
+		ok: true,
+		value,
+		diagnostics
+	};
 }
 /** Create a failed result. */
-export function fail(diagnostics) {
-    return { ok: false, diagnostics };
+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 };
+* Build a result from a diagnostics array and an optional value.
+* If any diagnostic has level `error`, the result is a failure.
+*/
+function fromDiagnostics(diagnostics, value) {
+	if (diagnostics.some((d) => d.level === "error") || value === void 0) return {
+		ok: false,
+		diagnostics
+	};
+	return {
+		ok: true,
+		value,
+		diagnostics
+	};
 }
+
+//#endregion
+export { fail, fromDiagnostics, ok };
 //# sourceMappingURL=Result.js.map

package/dist/base/Result.js.map

@@ -1 +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"}
+{"version":3,"file":"Result.js","names":[],"sources":["../../src/base/Result.ts"],"sourcesContent":["import type { Diagnostic } from '../types.js';\n\n// ---------------------------------------------------------------------------\n// Result<T> — the universal return type for fallible operations.\n// ---------------------------------------------------------------------------\n\n/** Successful result carrying a value and optional diagnostics. */\nexport interface ResultOk<T> {\n  readonly ok: true;\n  readonly value: T;\n  readonly diagnostics: readonly Diagnostic[];\n}\n\n/** Failed result carrying at least one diagnostic. */\nexport interface ResultFail {\n  readonly ok: false;\n  readonly diagnostics: readonly Diagnostic[];\n}\n\n/** Discriminated union returned by every fallible uapkg operation. */\nexport type Result<T> = ResultOk<T> | ResultFail;\n\n// ---------------------------------------------------------------------------\n// Factory helpers\n// ---------------------------------------------------------------------------\n\n/** Create a successful result. */\nexport function ok<T>(value: T, diagnostics: readonly Diagnostic[] = []): ResultOk<T> {\n  return { ok: true, value, diagnostics };\n}\n\n/** Create a failed result. */\nexport function fail(diagnostics: readonly Diagnostic[]): ResultFail {\n  return { ok: false, diagnostics };\n}\n\n/**\n * Build a result from a diagnostics array and an optional value.\n * If any diagnostic has level `error`, the result is a failure.\n */\nexport function fromDiagnostics<T>(diagnostics: readonly Diagnostic[], value?: T): Result<T> {\n  const hasError = diagnostics.some((d) => d.level === 'error');\n  if (hasError || value === undefined) {\n    return { ok: false, diagnostics };\n  }\n  return { ok: true, value, diagnostics };\n}\n"],"mappings":";;AA2BA,SAAgB,GAAM,OAAU,cAAqC,CAAC,GAAgB;CACpF,OAAO;EAAE,IAAI;EAAM;EAAO;CAAY;AACxC;;AAGA,SAAgB,KAAK,aAAgD;CACnE,OAAO;EAAE,IAAI;EAAO;CAAY;AAClC;;;;;AAMA,SAAgB,gBAAmB,aAAoC,OAAsB;CAE3F,IADiB,YAAY,MAAM,MAAM,EAAE,UAAU,OAC1C,KAAK,UAAU,QACxB,OAAO;EAAE,IAAI;EAAO;CAAY;CAElC,OAAO;EAAE,IAAI;EAAM;EAAO;CAAY;AACxC"}