@noldova/context.diagnostics 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Noldova
+
+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/api/index.d.ts

@@ -0,0 +1,428 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import "@noldova/context.core";
+
+/**
+ * The semantic category of a diagnostic. Category is part of diagnostic
+ * identity; no formatter, consumer, or later phase may rewrite it.
+ * The producer selects it from its catalog, not from display preferences.
+ */
+export declare enum DiagnosticCategory {
+  /**
+   * A condition that prevents the requested operation from succeeding.
+   */
+  Error = "Error",
+
+  /**
+   * A condition that deserves attention but does not prevent success.
+   */
+  Warning = "Warning",
+
+  /**
+   * A non-failing recommendation for improving the source.
+   */
+  Suggestion = "Suggestion",
+
+  /**
+   * Informational diagnostic output without an error or warning condition.
+   */
+  Message = "Message",
+}
+
+/**
+ * One diagnostic-code namespace and the prefix used to display its codes.
+ * Authorities are closed canonical identities rather than arbitrary strings.
+ * Use the shared instances; callers cannot construct or register an authority.
+ *
+ * @example
+ * ```ts
+ * DiagnosticAuthority.context.codePrefix; // "CTX"
+ * DiagnosticAuthority.typeScript.codePrefix; // "TS"
+ * ```
+ */
+export declare class DiagnosticAuthority {
+  /**
+   * The shared CONTEXT-owned diagnostic-code namespace, displayed with `CTX`.
+   */
+  public static readonly context: DiagnosticAuthority;
+
+  /**
+   * The shared upstream TypeScript diagnostic-code namespace, displayed with `TS`.
+   */
+  public static readonly typeScript: DiagnosticAuthority;
+
+  /**
+   * The canonical prefix placed before a numeric code in display text. It is
+   * presentation data owned by the authority, not a separately registered identity.
+   */
+  public readonly codePrefix: string;
+
+  private constructor(codePrefix: string);
+}
+
+/**
+ * An immutable code pairing a canonical authority with a positive safe integer.
+ * The producer supplies the exact upstream TypeScript number or a registered
+ * CONTEXT number from its allocated range. Construction validates the numeric
+ * value only; it does not allocate codes or check catalog membership or uniqueness.
+ */
+export declare class DiagnosticCode {
+  /**
+   * The namespace that owns the numeric code.
+   */
+  public readonly authority: DiagnosticAuthority;
+
+  /**
+   * The display form: the authority prefix followed by the value, such as
+   * `TS2304` or `CTX1001`.
+   */
+  public readonly displayText: string;
+
+  /**
+   * The positive safe integer assigned by the owning authority.
+   */
+  public readonly value: number;
+
+  /**
+   * Creates a code in the supplied authority's namespace.
+   *
+   * @param authority The canonical namespace that owns the numeric code.
+   * @param value The assigned integer, from 1 through `Number.MAX_SAFE_INTEGER`
+   * inclusive. Zero is not a valid code or an absence marker.
+   * @throws {ArgumentOutOfRangeException} If `value` is nonpositive, fractional,
+   * non-finite, or outside the safe integer range. The exception identifies
+   * `value` and retains the rejected number as `actualValue`.
+   * @example
+   * ```ts
+   * import { DiagnosticAuthority, DiagnosticCode } from "@noldova/context.diagnostics";
+   *
+   * const code = new DiagnosticCode(DiagnosticAuthority.typeScript, 2304);
+   * code.displayText; // "TS2304"
+   * ```
+   */
+  public constructor(authority: DiagnosticAuthority, value: number);
+}
+
+/**
+ * One diagnostic location: an optional canonical source identity and one exact
+ * UTF-16 span. The span is half-open: `[start, start + length)`. Zero-length
+ * spans, including an end-of-file span, are valid. Line and character
+ * coordinates are derived presentation and are never stored here.
+ */
+export declare class DiagnosticLocation {
+  /**
+   * The caller-supplied canonical logical source identity, preserved verbatim.
+   * `undefined` represents anonymous input; no path or synthetic name is inferred.
+   */
+  public readonly sourceIdentity: string | undefined;
+
+  /**
+   * The zero-based UTF-16 offset at which the span begins.
+   */
+  public readonly start: number;
+
+  /**
+   * The number of UTF-16 code units in the span.
+   */
+  public readonly length: number;
+
+  /**
+   * Creates a source span, optionally checking it against a known source length.
+   *
+   * @param sourceIdentity The canonical logical identity supplied by the input
+   * owner, or `undefined` for anonymous text. A supplied identity must be nonblank;
+   * it is not trimmed, resolved as a path, or otherwise canonicalized here.
+   * @param start The zero-based UTF-16 code-unit offset. It must be a non-negative
+   * safe integer, and `start + length` must also be a safe integer.
+   * @param length The number of UTF-16 code units covered, as a non-negative safe
+   * integer. Zero describes a position without covering a character, including EOF.
+   * @param sourceLength The source snapshot's UTF-16 length, as a non-negative
+   * safe integer. When supplied, the span end must not exceed it. It is used only
+   * for validation and is not retained; omission leaves the upper bound unchecked.
+   * @throws {ArgumentException} If a supplied source identity is empty or whitespace-only.
+   * @throws {ArgumentOutOfRangeException} If a numeric argument is negative,
+   * fractional, non-finite, or unsafe, the span end is unsafe, or the span exceeds
+   * `sourceLength`. Span-end failures identify `length`; individual numeric
+   * failures identify the offending argument and retain its value.
+   * @example
+   * ```ts
+   * const text = "A\u{1F600}B";
+   * const character = new DiagnosticLocation(undefined, 1, 2, text.length);
+   * text.slice(character.start, character.start + character.length); // "\u{1F600}"
+   * const end = new DiagnosticLocation("sample.ts", text.length, 0, text.length);
+   * end.length; // 0: an end-of-file position.
+   * const empty = new DiagnosticLocation(undefined, 0, 0, 0);
+   * empty.sourceIdentity; // undefined: an empty anonymous source.
+   * ```
+   */
+  public constructor(sourceIdentity: string | undefined, start: number, length: number, sourceLength?: number);
+}
+
+/**
+ * A structured marker applicable to a diagnostic. A tag is complete at
+ * creation and is never inferred later from message wording.
+ * Tags do not replace or change {@link DiagnosticCategory}.
+ */
+export declare enum DiagnosticTag {
+  /**
+   * The diagnosed source is unnecessary.
+   */
+  Unnecessary = "Unnecessary",
+
+  /**
+   * The diagnosed source refers to a deprecated API or construct.
+   */
+  Deprecated = "Deprecated",
+}
+
+/**
+ * One canonical message node: its code, category, canonical English text,
+ * and ordered children. A nested message chain is a tree of these nodes;
+ * child order is preserved exactly. Flattening the chain into one string is
+ * a presentation concern and never a substitute for this structure.
+ */
+export declare class DiagnosticMessage {
+  /**
+   * The diagnostic code carried by this message node.
+   */
+  public readonly code: DiagnosticCode;
+
+  /**
+   * The semantic category carried by this message node.
+   */
+  public readonly category: DiagnosticCategory;
+
+  /**
+   * The complete nonblank canonical English text of this node, preserved
+   * verbatim. It is not a deferred template or a flattened message chain.
+   */
+  public readonly text: string;
+
+  /**
+   * A shallow snapshot of the ordered child sequence. Child instances are
+   * shared, not cloned; neither duplicate entries nor their order are changed.
+   */
+  public readonly children: readonly DiagnosticMessage[];
+
+  /**
+   * Creates one node in a structured message chain.
+   *
+   * @param code The code for this node, which may differ from its parent's code.
+   * @param category This node's category; it is not inherited from a parent.
+   * @param text The already formatted canonical text. It must contain at least
+   * one non-whitespace character and is stored without trimming or reformatting.
+   * @param children The ordered detail nodes, or an empty array for a leaf.
+   * The array is copied; the child objects and their nested chains are retained.
+   * @throws {ArgumentException} If `text` is empty or whitespace-only.
+   * @example
+   * ```ts
+   * const code = new DiagnosticCode(DiagnosticAuthority.typeScript, 2322);
+   * const detail = new DiagnosticMessage(code, DiagnosticCategory.Error,
+   *   "Type 'string' is not assignable to type 'number'.", []);
+   * const message = new DiagnosticMessage(code, DiagnosticCategory.Error,
+   *   "The assignment is invalid.", [detail]);
+   * message.children[0] === detail; // true: the array is copied, not the detail.
+   * ```
+   */
+  public constructor(code: DiagnosticCode, category: DiagnosticCategory, text: string, children: readonly DiagnosticMessage[]);
+}
+
+/**
+ * One related record of a diagnostic, preserved independently: its message
+ * node and its optional location. The code and category are those of the
+ * message node. Related information is never appended to the primary
+ * message and never discarded by a formatter that does not display it.
+ */
+export declare class DiagnosticRelatedInformation {
+  /**
+   * The retained related message, including its independent code, category,
+   * and any nested details.
+   */
+  public readonly message: DiagnosticMessage;
+
+  /**
+   * The related source location, when the information is source-bound.
+   */
+  public readonly location: DiagnosticLocation | undefined;
+
+  /**
+   * Pairs a related message with its optional source location.
+   *
+   * @param message The complete related message, not text to append to the
+   * primary diagnostic. Its identity and message chain are retained unchanged.
+   * @param location The related span, or `undefined` for information that is
+   * not source-bound. It need not use the primary diagnostic's source identity.
+   * @example
+   * ```ts
+   * const code = new DiagnosticCode(DiagnosticAuthority.typeScript, 2728);
+   * const message = new DiagnosticMessage(code, DiagnosticCategory.Error,
+   *   "'value' is declared here.", []);
+   * const related = new DiagnosticRelatedInformation(message,
+   *   new DiagnosticLocation("sample.ts", 3, 4));
+   * related.message === message; // true
+   * ```
+   */
+  public constructor(message: DiagnosticMessage, location: DiagnosticLocation | undefined);
+}
+
+/**
+ * One complete reported diagnostic occurrence. A constructor establishes a
+ * completely valid object; no consumer attaches, repairs, or replaces
+ * fields after creation. The code and category are derived from the primary
+ * message node, so one authority exists by construction.
+ */
+export declare class Diagnostic {
+  /**
+   * The primary message node of this occurrence.
+   */
+  public readonly message: DiagnosticMessage;
+
+  /**
+   * The code of the primary message node.
+   */
+  public readonly code: DiagnosticCode;
+
+  /**
+   * The category of the primary message node.
+   */
+  public readonly category: DiagnosticCategory;
+
+  /**
+   * The primary source location, when the occurrence is source-bound.
+   */
+  public readonly location: DiagnosticLocation | undefined;
+
+  /**
+   * A shallow snapshot of related records in their canonical order. The
+   * records themselves are shared; repeated records are preserved.
+   */
+  public readonly relatedInformation: readonly DiagnosticRelatedInformation[];
+
+  /**
+   * A snapshot of the supplied tags in order, with no duplicates. These tags
+   * do not change the occurrence's code or category.
+   */
+  public readonly tags: readonly DiagnosticTag[];
+
+  /**
+   * Publishes one complete occurrence from a primary message and its context.
+   *
+   * @param message The complete primary message or message-chain root. Its code
+   * and category also become the occurrence's code and category; it is not cloned.
+   * @param location The primary source span, or `undefined` for a global or
+   * non-text diagnostic. An anonymous source still supplies a location with an
+   * undefined source identity, rather than discarding its span.
+   * @param relatedInformation Ordered related records, or an empty array.
+   * The array is copied, retaining its elements, order, and repeated entries.
+   * @param tags The final ordered tags, or an empty array. The array is copied;
+   * every tag must occur at most once. No tags are inferred from the message.
+   * @throws {ArgumentException} If `tags` contains a duplicate.
+   * @example
+   * ```ts
+   * const code = new DiagnosticCode(DiagnosticAuthority.typeScript, 2304);
+   * const message = new DiagnosticMessage(code, DiagnosticCategory.Error,
+   *   "Cannot find name 'value'.", []);
+   * const diagnostic = new Diagnostic(message,
+   *   new DiagnosticLocation(undefined, 12, 5), [], []);
+   * diagnostic.code === message.code; // true
+   * diagnostic.location?.sourceIdentity; // undefined: anonymous, not unlocated.
+   * ```
+   */
+  public constructor(
+    message: DiagnosticMessage,
+    location: DiagnosticLocation | undefined,
+    relatedInformation: readonly DiagnosticRelatedInformation[],
+    tags: readonly DiagnosticTag[]);
+}
+
+/**
+ * One reusable, immutable diagnostic template owned by a producer catalog.
+ * A template is not itself a reported diagnostic, and an occurrence cannot
+ * be reused as a template.
+ */
+export declare class DiagnosticTemplate {
+  /**
+   * The code assigned to every occurrence created from this template.
+   */
+  public readonly code: DiagnosticCode;
+
+  /**
+   * The category assigned to every occurrence created from this template.
+   */
+  public readonly category: DiagnosticCategory;
+
+  /**
+   * The nonblank canonical positional template, using Core's
+   * {@link StringConstructor.format} placeholder convention.
+   */
+  public readonly messageTemplate: string;
+
+  /**
+   * A snapshot of the default tags, applied in this order before occurrence
+   * tags. The array contains no duplicates and is unchanged by creating occurrences.
+   */
+  public readonly defaultTags: readonly DiagnosticTag[];
+
+  /**
+   * Creates a reusable catalog definition without reporting a diagnostic.
+   *
+   * @param code The producer-assigned code shared by all created occurrences.
+   * Catalog membership and allocation are the producer's responsibility.
+   * @param category The category applied to every occurrence without reinterpretation.
+   * @param messageTemplate Nonblank canonical English text with zero-based
+   * placeholders such as `{0}`. Catalogs and their generators validate placeholder
+   * correctness; this constructor neither parses nor caches placeholder structure.
+   * @param defaultTags Tags applied to every occurrence, in order. Omission or
+   * `undefined` uses an empty sequence. The input array is copied and must contain
+   * no duplicates.
+   * @throws {ArgumentException} If `messageTemplate` is empty or whitespace-only,
+   * or `defaultTags` contains a duplicate.
+   * @example
+   * See {@link DiagnosticTemplate.create} for a reusable template and its occurrences.
+   */
+  public constructor(code: DiagnosticCode, category: DiagnosticCategory, messageTemplate: string, defaultTags?: readonly DiagnosticTag[]);
+
+  /**
+   * Creates one immutable occurrence, formatting its primary message exactly
+   * once through {@link StringConstructor.format}. To publish a nested chain,
+   * construct {@link DiagnosticMessage} nodes and a {@link Diagnostic} directly.
+   *
+   * @param location The primary span, or `undefined` for a diagnostic without a
+   * source location. Anonymous text can use a {@link DiagnosticLocation} without
+   * a source identity.
+   * @param messageArguments String and number substitutions, indexed from zero.
+   * Omission or `undefined` supplies none. Unavailable or unrecognized placeholders
+   * remain unchanged; the producer must supply arguments matching its catalog.
+   * @param relatedInformation Ordered related records. Omission or `undefined`
+   * uses an empty sequence. The occurrence copies the array and retains its elements.
+   * @param tags Occurrence-specific tags appended after {@link DiagnosticTemplate.defaultTags}.
+   * Omission or `undefined` supplies none. The combined sequence must have no duplicates.
+   * @returns A new occurrence and primary message node, with the template's code
+   * and category and no message children. Formatting arguments are not retained;
+   * the template is unchanged and can create further independent occurrences.
+   * @throws {ArgumentException} If the formatted message is empty or whitespace-only,
+   * or a tag repeats within the occurrence tags or overlaps a default tag. A valid
+   * template such as `"{0}"` can still produce invalid blank text after substitution.
+   * @example
+   * ```ts
+   * const code = new DiagnosticCode(DiagnosticAuthority.typeScript, 2304);
+   * const template = new DiagnosticTemplate(code, DiagnosticCategory.Error, "Cannot find name '{0}'.");
+   * const first = template.create(undefined, ["value"]);
+   * const second = template.create(undefined, ["other"]);
+   * first.message.text; // "Cannot find name 'value'."
+   * second.message.text; // "Cannot find name 'other'."
+   * first !== second; // true
+   * ```
+   */
+  public create(
+    location: DiagnosticLocation | undefined,
+    messageArguments?: readonly (string | number)[],
+    relatedInformation?: readonly DiagnosticRelatedInformation[],
+    tags?: readonly DiagnosticTag[]): Diagnostic;
+}

package/api/index.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export { DiagnosticCategory } from "../enums/diagnostic-category.js";
+export { DiagnosticTag } from "../enums/diagnostic-tag.js";
+export { DiagnosticAuthority } from "../models/diagnostic-authority.js";
+export { DiagnosticCode } from "../models/diagnostic-code.js";
+export { DiagnosticLocation } from "../models/diagnostic-location.js";
+export { DiagnosticMessage } from "../models/diagnostic-message.js";
+export { DiagnosticRelatedInformation } from "../models/diagnostic-related-information.js";
+export { DiagnosticTemplate } from "../models/diagnostic-template.js";
+export { Diagnostic } from "../models/diagnostic.js";
+//# sourceMappingURL=index.js.map

package/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC"}

package/enums/diagnostic-category.js

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export var DiagnosticCategory;
+(function (DiagnosticCategory) {
+    DiagnosticCategory["Error"] = "Error";
+    DiagnosticCategory["Warning"] = "Warning";
+    DiagnosticCategory["Suggestion"] = "Suggestion";
+    DiagnosticCategory["Message"] = "Message";
+})(DiagnosticCategory || (DiagnosticCategory = {}));
+//# sourceMappingURL=diagnostic-category.js.map

package/enums/diagnostic-category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-category.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/enums/diagnostic-category.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,qCAAe,CAAA;IACf,yCAAmB,CAAA;IACnB,+CAAyB,CAAA;IACzB,yCAAmB,CAAA;AACrB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}

package/enums/diagnostic-tag.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export var DiagnosticTag;
+(function (DiagnosticTag) {
+    DiagnosticTag["Unnecessary"] = "Unnecessary";
+    DiagnosticTag["Deprecated"] = "Deprecated";
+})(DiagnosticTag || (DiagnosticTag = {}));
+//# sourceMappingURL=diagnostic-tag.js.map

package/enums/diagnostic-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-tag.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/enums/diagnostic-tag.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,4CAA2B,CAAA;IAC3B,0CAAyB,CAAA;AAC3B,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB"}

package/models/diagnostic-authority.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Resources } from "../resources.js";
+export class DiagnosticAuthority {
+    static context = new DiagnosticAuthority(Resources.contextCodePrefix);
+    static typeScript = new DiagnosticAuthority(Resources.typeScriptCodePrefix);
+    codePrefix;
+    constructor(codePrefix) {
+        this.codePrefix = codePrefix;
+    }
+}
+//# sourceMappingURL=diagnostic-authority.js.map

package/models/diagnostic-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-authority.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/models/diagnostic-authority.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,OAAO,mBAAmB;IACvB,MAAM,CAAU,OAAO,GAAwB,IAAI,mBAAmB,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACpG,MAAM,CAAU,UAAU,GAAwB,IAAI,mBAAmB,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAEjG,UAAU,CAAS;IAEnC,YAAoB,UAAkB;QACpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/models/diagnostic-code.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { nameof } from "@noldova/context.core";
+import { ArgumentOutOfRangeException } from "@noldova/context.exceptions";
+import { Resources } from "../resources.js";
+import { DiagnosticAuthority } from "./diagnostic-authority.js";
+export class DiagnosticCode {
+    authority;
+    displayText;
+    value;
+    constructor(authority, value) {
+        if (!Number.isSafeInteger(value) || value < 1)
+            throw new ArgumentOutOfRangeException(nameof(t => t.value), value, Resources.codeValueInvalid);
+        this.authority = authority;
+        this.displayText = `${authority.codePrefix}${value}`;
+        this.value = value;
+    }
+}
+//# sourceMappingURL=diagnostic-code.js.map

package/models/diagnostic-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-code.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/models/diagnostic-code.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE1E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,OAAO,cAAc;IACT,SAAS,CAAsB;IAC/B,WAAW,CAAS;IACpB,KAAK,CAAS;IAE9B,YAAmB,SAA8B,EAAE,KAAa;QAC9D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAC3C,MAAM,IAAI,2BAA2B,CAAC,MAAM,CAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAEjH,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,GAAG,SAAS,CAAC,UAAU,GAAG,KAAK,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/models/diagnostic-location.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { nameof } from "@noldova/context.core";
+import { ArgumentException, ArgumentOutOfRangeException } from "@noldova/context.exceptions";
+import { Resources } from "../resources.js";
+export class DiagnosticLocation {
+    sourceIdentity;
+    start;
+    length;
+    constructor(sourceIdentity, start, length, sourceLength) {
+        if (!Object.isUndefined(sourceIdentity))
+            ArgumentException.throwIfNullOrWhitespace(sourceIdentity, nameof(t => t.sourceIdentity));
+        if (!Number.isSafeInteger(start) || start < 0)
+            throw new ArgumentOutOfRangeException(nameof(t => t.start), start, Resources.startInvalid);
+        if (!Number.isSafeInteger(length) || length < 0)
+            throw new ArgumentOutOfRangeException(nameof(t => t.length), length, Resources.lengthInvalid);
+        const end = start + length;
+        if (!Number.isSafeInteger(end))
+            throw new ArgumentOutOfRangeException(nameof(t => t.length), length, Resources.spanEndInvalid);
+        if (!Object.isUndefined(sourceLength)) {
+            if (!Number.isSafeInteger(sourceLength) || sourceLength < 0)
+                throw new ArgumentOutOfRangeException(Resources.sourceLengthParameterName, sourceLength, Resources.sourceLengthInvalid);
+            if (end > sourceLength)
+                throw new ArgumentOutOfRangeException(nameof(t => t.length), length, Resources.spanBeyondSource(end, sourceLength));
+        }
+        this.sourceIdentity = sourceIdentity;
+        this.start = start;
+        this.length = length;
+    }
+}
+//# sourceMappingURL=diagnostic-location.js.map

package/models/diagnostic-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-location.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/models/diagnostic-location.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE7F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,OAAO,kBAAkB;IACb,cAAc,CAAqB;IACnC,KAAK,CAAS;IACd,MAAM,CAAS;IAE/B,YAAmB,cAAkC,EAAE,KAAa,EAAE,MAAc,EAAE,YAAqB;QACzG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC;YACrC,iBAAiB,CAAC,uBAAuB,CAAC,cAAc,EAAE,MAAM,CAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;QAE/G,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAC3C,MAAM,IAAI,2BAA2B,CAAC,MAAM,CAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QAEjH,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;YAC7C,MAAM,IAAI,2BAA2B,CAAC,MAAM,CAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QAEpH,MAAM,GAAG,GAAG,KAAK,GAAG,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC;YAC5B,MAAM,IAAI,2BAA2B,CAAC,MAAM,CAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;QAErH,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC;gBACzD,MAAM,IAAI,2BAA2B,CAAC,SAAS,CAAC,yBAAyB,EAAE,YAAY,EAAE,SAAS,CAAC,mBAAmB,CAAC,CAAC;YAE1H,IAAI,GAAG,GAAG,YAAY;gBACpB,MAAM,IAAI,2BAA2B,CAAC,MAAM,CAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;QAC5I,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/models/diagnostic-message.js

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { nameof } from "@noldova/context.core";
+import { ArgumentException } from "@noldova/context.exceptions";
+export class DiagnosticMessage {
+    code;
+    category;
+    text;
+    children;
+    constructor(code, category, text, children) {
+        ArgumentException.throwIfNullOrWhitespace(text, nameof(t => t.text));
+        this.code = code;
+        this.category = category;
+        this.text = text;
+        this.children = [...children];
+    }
+}
+//# sourceMappingURL=diagnostic-message.js.map

package/models/diagnostic-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-message.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/models/diagnostic-message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAKhE,MAAM,OAAO,iBAAiB;IACZ,IAAI,CAAiB;IACrB,QAAQ,CAAqB;IAC7B,IAAI,CAAS;IACb,QAAQ,CAA+B;IAEvD,YAAmB,IAAoB,EAAE,QAA4B,EAAE,IAAY,EAAE,QAAsC;QACzH,iBAAiB,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAExF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAChC,CAAC;CACF"}

package/models/diagnostic-related-information.js

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export class DiagnosticRelatedInformation {
+    message;
+    location;
+    constructor(message, location) {
+        this.message = message;
+        this.location = location;
+    }
+}
+//# sourceMappingURL=diagnostic-related-information.js.map

package/models/diagnostic-related-information.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-related-information.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/models/diagnostic-related-information.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,OAAO,4BAA4B;IACvB,OAAO,CAAoB;IAC3B,QAAQ,CAAiC;IAEzD,YAAmB,OAA0B,EAAE,QAAwC;QACrF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/models/diagnostic-template.js

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { nameof } from "@noldova/context.core";
+import { ArgumentException } from "@noldova/context.exceptions";
+import { Resources } from "../resources.js";
+import { DiagnosticMessage } from "./diagnostic-message.js";
+import { Diagnostic } from "./diagnostic.js";
+export class DiagnosticTemplate {
+    code;
+    category;
+    messageTemplate;
+    defaultTags;
+    constructor(code, category, messageTemplate, defaultTags = []) {
+        ArgumentException.throwIfNullOrWhitespace(messageTemplate, nameof(t => t.messageTemplate));
+        if (new Set(defaultTags).size !== defaultTags.length)
+            throw new ArgumentException(Resources.duplicateTag, nameof(t => t.defaultTags));
+        this.code = code;
+        this.category = category;
+        this.messageTemplate = messageTemplate;
+        this.defaultTags = [...defaultTags];
+    }
+    create(location, messageArguments = [], relatedInformation = [], tags = []) {
+        const message = new DiagnosticMessage(this.code, this.category, String.format(this.messageTemplate, ...messageArguments), []);
+        return new Diagnostic(message, location, relatedInformation, [...this.defaultTags, ...tags]);
+    }
+}
+//# sourceMappingURL=diagnostic-template.js.map

package/models/diagnostic-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-template.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/models/diagnostic-template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIhE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,OAAO,kBAAkB;IACb,IAAI,CAAiB;IACrB,QAAQ,CAAqB;IAC7B,eAAe,CAAS;IACxB,WAAW,CAA2B;IAEtD,YAAmB,IAAoB,EAAE,QAA4B,EAAE,eAAuB,EAAE,WAAW,GAA6B,EAAE;QACxI,iBAAiB,CAAC,uBAAuB,CAAC,eAAe,EAAE,MAAM,CAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QAE/G,IAAI,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,MAAM;YAClD,MAAM,IAAI,iBAAiB,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAEtG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IACtC,CAAC;IAEM,MAAM,CACX,QAAwC,EACxC,gBAAgB,GAAiC,EAAE,EACnD,kBAAkB,GAA4C,EAAE,EAChE,IAAI,GAA6B,EAAE;QACnC,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC;QAE9H,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/F,CAAC;CACF"}

package/models/diagnostic.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { nameof } from "@noldova/context.core";
+import { ArgumentException } from "@noldova/context.exceptions";
+import { Resources } from "../resources.js";
+export class Diagnostic {
+    message;
+    code;
+    category;
+    location;
+    relatedInformation;
+    tags;
+    constructor(message, location, relatedInformation, tags) {
+        if (new Set(tags).size !== tags.length)
+            throw new ArgumentException(Resources.duplicateTag, nameof(t => t.tags));
+        this.message = message;
+        this.code = this.message.code;
+        this.category = this.message.category;
+        this.location = location;
+        this.relatedInformation = [...relatedInformation];
+        this.tags = [...tags];
+    }
+}
+//# sourceMappingURL=diagnostic.js.map

package/models/diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../../../../src/noldova.context.diagnostics/src/models/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIhE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C,MAAM,OAAO,UAAU;IACL,OAAO,CAAoB;IAC3B,IAAI,CAAiB;IACrB,QAAQ,CAAqB;IAC7B,QAAQ,CAAiC;IACzC,kBAAkB,CAA0C;IAC5D,IAAI,CAA2B;IAE/C,YACE,OAA0B,EAC1B,QAAwC,EACxC,kBAA2D,EAC3D,IAA8B;QAC9B,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM;YACpC,MAAM,IAAI,iBAAiB,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,kBAAkB,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,CAAC;CACF"}

package/package.json

@@ -1,6 +1,25 @@
 {
   "name": "@noldova/context.diagnostics",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "type": "module",
+  "main": "api/index.js",
+  "types": "api/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/noldova-com/context.git",
+    "directory": "src/noldova.context.diagnostics"
+  },
+  "homepage": "https://github.com/noldova-com/context#readme",
+  "bugs": {
+    "url": "https://github.com/noldova-com/context/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@noldova/context.core": "0.0.1",
+    "@noldova/context.exceptions": "0.0.1"
+  }
+}

package/resources.js

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export class Resources {
+    static codeValueInvalid = "The code value must be a positive safe integer.";
+    static contextCodePrefix = "CTX";
+    static duplicateTag = "The tags must not contain a duplicate.";
+    static lengthInvalid = "The length must be a non-negative safe integer.";
+    static sourceLengthInvalid = "The source length must be a non-negative safe integer.";
+    static sourceLengthParameterName = "sourceLength";
+    static spanEndInvalid = "The span end must be a non-negative safe integer.";
+    static startInvalid = "The start must be a non-negative safe integer.";
+    static typeScriptCodePrefix = "TS";
+    static spanBeyondSource(end, sourceLength) {
+        return `The span ending at ${end} exceeds the source length ${sourceLength}.`;
+    }
+}
+//# sourceMappingURL=resources.js.map

package/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/noldova.context.diagnostics/src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,SAAS;IACb,MAAM,CAAU,gBAAgB,GAAW,iDAAiD,CAAC;IAC7F,MAAM,CAAU,iBAAiB,GAAW,KAAK,CAAC;IAClD,MAAM,CAAU,YAAY,GAAW,wCAAwC,CAAC;IAChF,MAAM,CAAU,aAAa,GAAW,iDAAiD,CAAC;IAC1F,MAAM,CAAU,mBAAmB,GAAW,wDAAwD,CAAC;IACvG,MAAM,CAAU,yBAAyB,GAAW,cAAc,CAAC;IACnE,MAAM,CAAU,cAAc,GAAW,mDAAmD,CAAC;IAC7F,MAAM,CAAU,YAAY,GAAW,gDAAgD,CAAC;IACxF,MAAM,CAAU,oBAAoB,GAAW,IAAI,CAAC;IAEpD,MAAM,CAAC,gBAAgB,CAAC,GAAW,EAAE,YAAoB;QAC9D,OAAO,sBAAsB,GAAG,8BAA8B,YAAY,GAAG,CAAC;IAChF,CAAC;CACF"}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-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.