@noldova/context.diagnostics 0.0.2 → 0.0.4

package/README.md

@@ -0,0 +1,34 @@
+# noldova.context.diagnostics
+
+The diagnostic model CONTEXT parsers and tools report through: codes in an
+authority's namespace (`TS` or `CTX`), categories, structured message chains,
+source locations, related information and tags. A `Diagnostic` is complete and
+immutable once created; reusable `DiagnosticTemplate`s create occurrences from a
+catalog.
+
+## Install
+
+```bash
+npm install @noldova/context.diagnostics
+```
+
+## Use
+
+```ts
+import { DiagnosticAuthority, DiagnosticCategory, DiagnosticCode, DiagnosticLocation, DiagnosticTemplate } from "@noldova/context.diagnostics";
+
+const code = new DiagnosticCode(DiagnosticAuthority.typeScript, 2304);
+const template = new DiagnosticTemplate(code, DiagnosticCategory.Error, "Cannot find name '{0}'.");
+
+const diagnostic = template.create(new DiagnosticLocation("example.ts", 12, 5), ["value"]);
+diagnostic.code.displayText; // "TS2304"
+diagnostic.message.text; // "Cannot find name 'value'."
+diagnostic.location?.start; // 12
+```
+
+Locations are UTF-16 offsets and lengths in a source. The declaration file
+`api/index.d.ts` documents every member with its contract and examples.
+
+## License
+
+MIT; see `LICENSE`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noldova/context.diagnostics",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "main": "api/index.js",
   "types": "api/index.d.ts",
@@ -19,7 +19,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@noldova/context.core": "0.0.2",
-    "@noldova/context.exceptions": "0.0.2"
-  }
+    "@noldova/context.core": "0.0.4",
+    "@noldova/context.exceptions": "0.0.4"
+  },
+  "gitHead": "15e2532ec1c46998b0403aeb8c009bd903b15362"
 }