nostics 0.0.0 → 0.0.4

package/README.md

@@ -0,0 +1,145 @@
+# nostics
+
+Structured diagnostic codes for JavaScript/TypeScript libraries and frameworks.
+
+`nostics` makes every error, warning, and suggestion a **structured, typed, machine-readable object** — with a stable code, a human explanation, and enough context for an agent to act on it precisely.
+
+## What it looks like
+
+```
+[NUXT_B2011] Invalid plugin `/plugins/bad.ts`. src option is required.
+├▶ fix: Pass a string path or an object with a `src` property to `addPlugin()`.
+├▶ hint: Check your module's addPlugin() calls
+╰▶ see: https://nuxt.com/e/b2011
+```
+
+Every diagnostic has a **stable code**, a **human-readable explanation**, and structured fields — `fix`, `why`, `hint`, `docs` — that tell you what happened and how to resolve it. The `see` link points to a dedicated documentation page for that error code, with detailed explanations, examples, and common solutions. It should be visited only if more context is needed beyond the concise inline message.
+
+These error messages are designed to be **actionable** — not just telling you what went wrong, but guiding you toward the fix.
+
+## For humans
+
+A code like `NUXT_B2011` is stable and searchable — look it up in docs, find it in source, share it in issues. The structured fields give you immediate guidance: you don't need to search for the error message to find the fix, it's right there. And when you need more detail, the docs link takes you to a dedicated page for that specific error code — with explanations and examples to understand the root cause and how to resolve it.
+
+When library authors define diagnostics in one place, messages stay consistent. Every occurrence of `NUXT_B2011` produces the same explanation, the same fix, the same docs link.
+
+## For AI agents
+
+Structured diagnostics enable a different kind of agent integration — **precise rather than probabilistic**.
+
+Every diagnostic has a stable code an agent can dispatch on directly, instead of pattern-matching on message text. The object carries everything needed to act: what happened (`message`), why (`why`), how to fix it (`fix`), where to learn more (`docs`), and machine-readable details (`context`, `sources`). The per-code documentation pages are equally useful for agents — they can crawl or fetch them for deeper context when the inline fields aren't enough.
+
+An agent can resolve the issue without asking the user for more information. Users don't need to configure anything — if a library uses `nostics`, its diagnostics are already agent-ready. All codes are defined in a catalog, so an agent can enumerate the full error surface ahead of time. And when multiple libraries in a stack adopt it, agents get uniformly structured data from every layer.
+
+## Usage
+
+### Define diagnostics
+
+`defineDiagnostics()` declares the diagnostic codes for a domain — pure data, no side effects.
+
+`docsBase` can be a string (auto-appends `/${code.toLowerCase()}`) or a function for full control over the URL:
+
+```ts
+import { defineDiagnostics } from 'nostics'
+
+// Function form — strip the project prefix for cleaner URLs
+const diagnostics = defineDiagnostics({
+  docsBase: code => `https://nuxt.com/e/${code.replace('NUXT_', '').toLowerCase()}`,
+  codes: {
+    NUXT_B2011: {
+      message: (p: { src: string }) => `Invalid plugin \`${p.src}\`. src option is required.`,
+      fix: 'Pass a string path or an object with a `src` property to `addPlugin()`.',
+    },
+    NUXT_B5001: {
+      message: 'Missing compatibilityDate in nuxt.config.',
+      fix: (p: { date: string }) => `Add \`compatibilityDate: '${p.date}'\` to your nuxt.config.`,
+      hint: 'This ensures consistent behavior across Nuxt versions.',
+      level: 'warn',
+    },
+  },
+})
+// diagnostics.NUXT_B2011({ src: '...' }).docs → 'https://nuxt.com/e/b2011'
+```
+
+```ts
+// String form — simple base URL, code appended automatically
+const diagnostics = defineDiagnostics({
+  docsBase: 'https://example.com/errors',
+  codes: {
+    MY_E001: { message: 'Something went wrong.' },
+  },
+})
+// diagnostics.MY_E001().docs → 'https://example.com/errors/my_e001'
+```
+
+### Create a logger
+
+`createLogger()` binds diagnostics to output — formatting and reporting.
+
+```ts
+import { createLogger } from 'nostics'
+
+const log = createLogger({
+  diagnostics: [diagnostics],
+})
+
+log.NUXT_B2011({ src: pluginPath }).throw()
+log.NUXT_B5001({ date: '2025-01-01' }).warn()
+```
+
+`log.NUXT_B2011` is cmd+clickable, TypeScript enforces params, and actions are chainable — `.throw()`, `.warn()`, `.error()`, `.log()`.
+
+### Multiple diagnostic sets
+
+```ts
+const log = createLogger({
+  diagnostics: [nuxtDiagnostics, i18nDiagnostics],
+})
+
+log.NUXT_B2011({ src: pluginPath }).throw() // [NUXT_B2011] ...
+log.I18N_I001({ locale: 'fr' }).warn() // [I18N_I001] ...
+```
+
+### Custom reporters
+
+Pass a single reporter function or an array:
+
+```ts
+const log = createLogger({
+  diagnostics: [diagnostics],
+  reporter: [
+    consoleReporter,
+    (diagnostic, formatted) => {
+      sentry.captureMessage(formatted, { tags: { code: diagnostic.code } })
+    },
+  ],
+})
+```
+
+## Features
+
+- Typed diagnostic factories — cmd+clickable (go to definition), hover shows params, TypeScript enforces correctness
+- Structured `Diagnostic` objects — serializable, transportable across process boundaries
+- Chainable actions — `.throw()`, `.warn()`, `.error()`, `.log()`
+- Pluggable formatters — plain text, ANSI colors, JSON
+- Pluggable reporters — console, HTTP, custom
+- Multiple diagnostic sets — compose diagnostics from different libraries
+- Zero runtime dependencies
+
+## Claude Code plugin
+
+nostics ships a [Claude Code plugin](https://docs.anthropic.com/en/docs/claude-code/skills) that gives agents full context on the diagnostics API.
+
+```bash
+# temporary install because private repo, should be a claude code marketplace in the future
+gh api repos/vercel-labs/nostics/contents/install.sh --jq '.content' | base64 -d | bash
+```
+
+The plugin includes two skills:
+
+- **nostics** — auto-triggered reference skill. Loaded automatically when Claude Code detects nostics imports or API usage in your project, providing context on `defineDiagnostics`, `createLogger`, formatters, reporters, and best practices.
+- **`/add-diagnostic`** — user-invocable skill. Guides the agent through adding a new diagnostic code following the `PREFIX_XNNNN` convention, picking the right file, category, and sequence number.
+
+## License
+
+[MIT](./LICENSE)

package/dist/dev-reporter.d.mts

@@ -0,0 +1,7 @@
+import { t as Reporter } from "./reporter-DDQiiD6l.mjs";
+
+//#region src/dev-reporter.d.ts
+declare const devReporter: Reporter;
+//#endregion
+export { devReporter };
+//# sourceMappingURL=dev-reporter.d.mts.map

package/dist/dev-reporter.mjs

@@ -0,0 +1,9 @@
+//#region src/dev-reporter.ts
+const devReporter = (diagnostic) => {
+	if (import.meta.hot && typeof import.meta.hot.send === "function") import.meta.hot.send("nostics:report", diagnostic);
+	else console.warn("[nostics]: import.meta.hot.send() is not available. This must be running on Vite.");
+};
+//#endregion
+export { devReporter };
+
+//# sourceMappingURL=dev-reporter.mjs.map

package/dist/dev-reporter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-reporter.mjs","names":[],"sources":["../src/dev-reporter.ts"],"sourcesContent":["import type { Reporter } from './reporter'\n\nexport const devReporter: Reporter = (diagnostic) => {\n  if (import.meta.hot && typeof import.meta.hot.send === 'function') {\n    import.meta.hot.send('nostics:report', diagnostic)\n  }\n  else {\n    console.warn('[nostics]: import.meta.hot.send() is not available. This must be running on Vite.')\n  }\n}\n"],"mappings":";AAEA,MAAa,eAAyB,eAAe;AACnD,KAAI,OAAO,KAAK,OAAO,OAAO,OAAO,KAAK,IAAI,SAAS,WACrD,QAAO,KAAK,IAAI,KAAK,kBAAkB,WAAW;KAGlD,SAAQ,KAAK,oFAAoF"}

package/dist/diagnostics-CSUYJHfP.d.mts

@@ -0,0 +1,59 @@
+//#region src/utils.d.ts
+type Simplify<T> = { [K in keyof T]: T[K] } & {};
+type ExtractFieldParams<T> = T extends ((params: infer P) => string) ? P : Record<never, never>;
+type ExtractParams<T> = (T extends {
+  message: infer M;
+} ? ExtractFieldParams<M> : Record<never, never>) & (T extends {
+  fix: infer F;
+} ? ExtractFieldParams<F> : Record<never, never>) & (T extends {
+  why: infer W;
+} ? ExtractFieldParams<W> : Record<never, never>) & (T extends {
+  hint: infer H;
+} ? ExtractFieldParams<H> : Record<never, never>);
+type IsEmptyObject<T> = keyof T extends never ? true : false;
+//#endregion
+//#region src/diagnostics.d.ts
+type DiagnosticLevel = "error" | "warn" | "suggestion" | "deprecation";
+interface SourceLocation {
+  file?: string;
+  line?: number;
+  column?: number;
+}
+interface Diagnostic {
+  code: string;
+  level: DiagnosticLevel;
+  message: string;
+  why?: string;
+  fix?: string;
+  hint?: string;
+  docs?: string;
+  sources?: SourceLocation[];
+  cause?: unknown;
+  context?: Record<string, unknown>;
+  stack?: string;
+}
+type Overrides = Partial<Pick<Diagnostic, "level" | "sources" | "cause" | "context">>;
+type MessageTemplate<P = any> = string | ((params: P) => string);
+interface DiagnosticDefinition {
+  message: MessageTemplate;
+  fix?: MessageTemplate;
+  why?: MessageTemplate;
+  hint?: MessageTemplate;
+  level?: DiagnosticLevel;
+}
+type CodeFactory<T> = IsEmptyObject<ExtractParams<T>> extends true ? (overrides?: Overrides) => Diagnostic : (params: Simplify<ExtractParams<T>>, overrides?: Overrides) => Diagnostic;
+interface DiagnosticsMethods<C extends Record<string, DiagnosticDefinition>> {
+  codes: () => (keyof C & string)[];
+  has: (code: string) => code is Extract<keyof C, string>;
+  get: <K extends keyof C>(code: K) => C[K];
+  extend: <U extends Record<string, DiagnosticDefinition>>(defs: U) => DiagnosticsResult<C & U>;
+}
+type DiagnosticsResult<C extends Record<string, DiagnosticDefinition>> = { [K in keyof C]: CodeFactory<C[K]> } & DiagnosticsMethods<C>;
+interface DefineDiagnosticsOptions<C extends Record<string, DiagnosticDefinition>> {
+  docsBase?: string | ((code: string) => string | undefined);
+  codes: C;
+}
+declare function defineDiagnostics<C extends Record<string, DiagnosticDefinition>>(options: DefineDiagnosticsOptions<C>): DiagnosticsResult<C>;
+//#endregion
+export { DiagnosticLevel as a, Overrides as c, DiagnosticDefinition as i, SourceLocation as l, DefineDiagnosticsOptions as n, DiagnosticsMethods as o, Diagnostic as r, DiagnosticsResult as s, CodeFactory as t, defineDiagnostics as u };
+//# sourceMappingURL=diagnostics-CSUYJHfP.d.mts.map

package/dist/format-CKWeokpQ.d.mts

@@ -0,0 +1,10 @@
+import { r as Diagnostic } from "./diagnostics-CSUYJHfP.mjs";
+
+//#region src/format.d.ts
+type Formatter = (diagnostic: Diagnostic) => string;
+declare function formatTag(d: Diagnostic): string;
+declare function renderFrame(d: Diagnostic): string;
+declare const plainFormatter: Formatter;
+//#endregion
+export { renderFrame as i, formatTag as n, plainFormatter as r, Formatter as t };
+//# sourceMappingURL=format-CKWeokpQ.d.mts.map

package/dist/format-DYh8khIQ.mjs

@@ -0,0 +1,21 @@
+//#region src/format.ts
+function formatTag(d) {
+	return `[${d.code}]`;
+}
+function renderFrame(d) {
+	const header = `${formatTag(d)} ${d.message}`;
+	const details = [];
+	if (d.why) details.push(`why: ${d.why}`);
+	if (d.fix) details.push(`fix: ${d.fix}`);
+	if (d.hint) details.push(`hint: ${d.hint}`);
+	if (d.docs) details.push(`see: ${d.docs}`);
+	if (details.length === 0) return header;
+	return [header, ...details.map((detail, i) => {
+		return `${i < details.length - 1 ? "├▶" : "╰▶"} ${detail}`;
+	})].join("\n");
+}
+const plainFormatter = renderFrame;
+//#endregion
+export { plainFormatter as n, renderFrame as r, formatTag as t };
+
+//# sourceMappingURL=format-DYh8khIQ.mjs.map

package/dist/format-DYh8khIQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-DYh8khIQ.mjs","names":[],"sources":["../src/format.ts"],"sourcesContent":["import type { Diagnostic } from './diagnostics'\n\nexport type Formatter = (diagnostic: Diagnostic) => string\n\nexport function formatTag(d: Diagnostic): string {\n  return `[${d.code}]`\n}\n\nexport function renderFrame(d: Diagnostic): string {\n  const header = `${formatTag(d)} ${d.message}`\n\n  const details: string[] = []\n  if (d.why)\n    details.push(`why: ${d.why}`)\n  if (d.fix)\n    details.push(`fix: ${d.fix}`)\n  if (d.hint)\n    details.push(`hint: ${d.hint}`)\n  if (d.docs)\n    details.push(`see: ${d.docs}`)\n\n  if (details.length === 0)\n    return header\n\n  const lines = details.map((detail, i) => {\n    const connector = i < details.length - 1 ? '├▶' : '╰▶'\n    return `${connector} ${detail}`\n  })\n\n  return [header, ...lines].join('\\n')\n}\n\nexport const plainFormatter: Formatter = renderFrame\n"],"mappings":";AAIA,SAAgB,UAAU,GAAuB;AAC/C,QAAO,IAAI,EAAE,KAAK;;AAGpB,SAAgB,YAAY,GAAuB;CACjD,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC,GAAG,EAAE;CAEpC,MAAM,UAAoB,EAAE;AAC5B,KAAI,EAAE,IACJ,SAAQ,KAAK,QAAQ,EAAE,MAAM;AAC/B,KAAI,EAAE,IACJ,SAAQ,KAAK,QAAQ,EAAE,MAAM;AAC/B,KAAI,EAAE,KACJ,SAAQ,KAAK,SAAS,EAAE,OAAO;AACjC,KAAI,EAAE,KACJ,SAAQ,KAAK,QAAQ,EAAE,OAAO;AAEhC,KAAI,QAAQ,WAAW,EACrB,QAAO;AAOT,QAAO,CAAC,QAAQ,GALF,QAAQ,KAAK,QAAQ,MAAM;AAEvC,SAAO,GADW,IAAI,QAAQ,SAAS,IAAI,OAAO,KAC9B,GAAG;GACvB,CAEuB,CAAC,KAAK,KAAK;;AAGtC,MAAa,iBAA4B"}

package/dist/formatters/ansi.d.mts

@@ -0,0 +1,15 @@
+import { t as Formatter } from "../format-CKWeokpQ.mjs";
+
+//#region src/formatters/ansi.d.ts
+interface Colors {
+  red: (s: string) => string;
+  yellow: (s: string) => string;
+  cyan: (s: string) => string;
+  gray: (s: string) => string;
+  bold: (s: string) => string;
+  dim: (s: string) => string;
+}
+declare function ansiFormatter(colors: Colors): Formatter;
+//#endregion
+export { Colors, ansiFormatter };
+//# sourceMappingURL=ansi.d.mts.map

package/dist/formatters/ansi.mjs

@@ -0,0 +1,30 @@
+import { t as formatTag } from "../format-DYh8khIQ.mjs";
+//#region src/formatters/ansi.ts
+function levelColor(colors, level) {
+	switch (level) {
+		case "error": return colors.red;
+		case "warn":
+		case "deprecation": return colors.yellow;
+		case "suggestion": return colors.cyan;
+		default: return (s) => s;
+	}
+}
+function ansiFormatter(colors) {
+	return (d) => {
+		const colorize = levelColor(colors, d.level);
+		const header = `${colors.bold(colorize(formatTag(d)))} ${d.message}`;
+		const details = [];
+		if (d.why) details.push(`${colors.dim("why:")} ${d.why}`);
+		if (d.fix) details.push(`${colors.dim("fix:")} ${d.fix}`);
+		if (d.hint) details.push(`${colors.dim("hint:")} ${colors.gray(d.hint)}`);
+		if (d.docs) details.push(`${colors.dim("see:")} ${colors.cyan(d.docs)}`);
+		if (details.length === 0) return header;
+		return [header, ...details.map((detail, i) => {
+			return `${i < details.length - 1 ? colors.dim("├▶") : colors.dim("╰▶")} ${detail}`;
+		})].join("\n");
+	};
+}
+//#endregion
+export { ansiFormatter };
+
+//# sourceMappingURL=ansi.mjs.map

package/dist/formatters/ansi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.mjs","names":[],"sources":["../../src/formatters/ansi.ts"],"sourcesContent":["import type { Diagnostic } from '../diagnostics'\nimport type { Formatter } from '../format'\nimport { formatTag } from '../format'\n\nexport interface Colors {\n  red: (s: string) => string\n  yellow: (s: string) => string\n  cyan: (s: string) => string\n  gray: (s: string) => string\n  bold: (s: string) => string\n  dim: (s: string) => string\n}\n\nfunction levelColor(colors: Colors, level: string): (s: string) => string {\n  switch (level) {\n    case 'error':\n      return colors.red\n    case 'warn':\n    case 'deprecation':\n      return colors.yellow\n    case 'suggestion':\n      return colors.cyan\n    default:\n      return s => s\n  }\n}\n\nexport function ansiFormatter(colors: Colors): Formatter {\n  return (d: Diagnostic): string => {\n    const colorize = levelColor(colors, d.level)\n    const tag = colors.bold(colorize(formatTag(d)))\n    const header = `${tag} ${d.message}`\n\n    const details: string[] = []\n    if (d.why)\n      details.push(`${colors.dim('why:')} ${d.why}`)\n    if (d.fix)\n      details.push(`${colors.dim('fix:')} ${d.fix}`)\n    if (d.hint)\n      details.push(`${colors.dim('hint:')} ${colors.gray(d.hint)}`)\n    if (d.docs)\n      details.push(`${colors.dim('see:')} ${colors.cyan(d.docs)}`)\n\n    if (details.length === 0)\n      return header\n\n    const lines = details.map((detail, i) => {\n      const connector = i < details.length - 1\n        ? colors.dim('├▶')\n        : colors.dim('╰▶')\n      return `${connector} ${detail}`\n    })\n\n    return [header, ...lines].join('\\n')\n  }\n}\n"],"mappings":";;AAaA,SAAS,WAAW,QAAgB,OAAsC;AACxE,SAAQ,OAAR;EACE,KAAK,QACH,QAAO,OAAO;EAChB,KAAK;EACL,KAAK,cACH,QAAO,OAAO;EAChB,KAAK,aACH,QAAO,OAAO;EAChB,QACE,SAAO,MAAK;;;AAIlB,SAAgB,cAAc,QAA2B;AACvD,SAAQ,MAA0B;EAChC,MAAM,WAAW,WAAW,QAAQ,EAAE,MAAM;EAE5C,MAAM,SAAS,GADH,OAAO,KAAK,SAAS,UAAU,EAAE,CAAC,CAAC,CACzB,GAAG,EAAE;EAE3B,MAAM,UAAoB,EAAE;AAC5B,MAAI,EAAE,IACJ,SAAQ,KAAK,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,MAAM;AAChD,MAAI,EAAE,IACJ,SAAQ,KAAK,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,MAAM;AAChD,MAAI,EAAE,KACJ,SAAQ,KAAK,GAAG,OAAO,IAAI,QAAQ,CAAC,GAAG,OAAO,KAAK,EAAE,KAAK,GAAG;AAC/D,MAAI,EAAE,KACJ,SAAQ,KAAK,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,OAAO,KAAK,EAAE,KAAK,GAAG;AAE9D,MAAI,QAAQ,WAAW,EACrB,QAAO;AAST,SAAO,CAAC,QAAQ,GAPF,QAAQ,KAAK,QAAQ,MAAM;AAIvC,UAAO,GAHW,IAAI,QAAQ,SAAS,IACnC,OAAO,IAAI,KAAK,GAChB,OAAO,IAAI,KAAK,CACA,GAAG;IACvB,CAEuB,CAAC,KAAK,KAAK"}

package/dist/formatters/json.d.mts

@@ -0,0 +1,7 @@
+import { t as Formatter } from "../format-CKWeokpQ.mjs";
+
+//#region src/formatters/json.d.ts
+declare const jsonFormatter: Formatter;
+//#endregion
+export { jsonFormatter };
+//# sourceMappingURL=json.d.mts.map

package/dist/formatters/json.mjs

@@ -0,0 +1,6 @@
+//#region src/formatters/json.ts
+const jsonFormatter = (diagnostic) => JSON.stringify(diagnostic);
+//#endregion
+export { jsonFormatter };
+
+//# sourceMappingURL=json.mjs.map

package/dist/formatters/json.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.mjs","names":[],"sources":["../../src/formatters/json.ts"],"sourcesContent":["import type { Formatter } from '../format'\n\nexport const jsonFormatter: Formatter = diagnostic => JSON.stringify(diagnostic)\n"],"mappings":";AAEA,MAAa,iBAA2B,eAAc,KAAK,UAAU,WAAW"}

package/dist/index.d.mts

@@ -0,0 +1,38 @@
+import { a as DiagnosticLevel, c as Overrides, i as DiagnosticDefinition, l as SourceLocation, n as DefineDiagnosticsOptions, o as DiagnosticsMethods, r as Diagnostic, s as DiagnosticsResult, t as CodeFactory, u as defineDiagnostics } from "./diagnostics-CSUYJHfP.mjs";
+import { n as consoleReporter, r as createFetchReporter, t as Reporter } from "./reporter-DDQiiD6l.mjs";
+import { i as renderFrame, n as formatTag, r as plainFormatter, t as Formatter } from "./format-CKWeokpQ.mjs";
+
+//#region src/error.d.ts
+declare class CodedError extends Error {
+  readonly diagnostic: Diagnostic;
+  constructor(diagnostic: Diagnostic);
+}
+//#endregion
+//#region src/logger.d.ts
+interface DiagnosticActions extends Diagnostic {
+  throw: () => never;
+  warn: () => void;
+  error: () => void;
+  log: () => void;
+  format: () => string;
+}
+type ActionFactories<T> = { [K in keyof T as T[K] extends ((...args: any[]) => Diagnostic) ? K : never]: T[K] extends ((...args: infer A) => Diagnostic) ? (...args: A) => DiagnosticActions : never };
+type MergeFactories<D extends readonly any[]> = D extends readonly [infer First, ...infer Rest] ? ActionFactories<First> & MergeFactories<Rest> : {};
+interface LoggerMethods {
+  throw: (diagnostic: Diagnostic) => never;
+  warn: (diagnostic: Diagnostic) => void;
+  error: (diagnostic: Diagnostic) => void;
+  log: (diagnostic: Diagnostic) => void;
+  format: (diagnostic: Diagnostic) => string;
+}
+type Logger<D extends readonly any[]> = MergeFactories<D> & LoggerMethods;
+interface CreateLoggerOptions<D extends readonly any[]> {
+  diagnostics: [...D];
+  formatter?: Formatter;
+  reporter?: Reporter | Reporter[];
+  captureStack?: boolean;
+}
+declare function createLogger<const D extends readonly any[]>(options: CreateLoggerOptions<D>): Logger<D>;
+//#endregion
+export { type CodeFactory, CodedError, type CreateLoggerOptions, type DefineDiagnosticsOptions, type Diagnostic, type DiagnosticActions, type DiagnosticDefinition, type DiagnosticLevel, type DiagnosticsMethods, type DiagnosticsResult, type Formatter, type Logger, type LoggerMethods, type MergeFactories, type Overrides, type Reporter, type SourceLocation, consoleReporter, createFetchReporter, createLogger, defineDiagnostics, formatTag, plainFormatter, renderFrame };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,192 @@
+import { n as plainFormatter, r as renderFrame, t as formatTag } from "./format-DYh8khIQ.mjs";
+//#region src/diagnostics.ts
+function resolveTemplate(template, params) {
+	if (template == null) return void 0;
+	if (typeof template === "function") return template(params);
+	return template;
+}
+function defineDiagnostics(options) {
+	const { docsBase, codes } = options;
+	const result = {};
+	const codeKeys = Object.keys(codes);
+	for (const code of codeKeys) {
+		const def = codes[code];
+		result[code] = (paramsOrOverrides, maybeOverrides) => {
+			const hasParams = typeof def.message === "function" || typeof def.fix === "function" || typeof def.why === "function" || typeof def.hint === "function";
+			const params = hasParams ? paramsOrOverrides : void 0;
+			const overrides = hasParams ? maybeOverrides : paramsOrOverrides;
+			const docs = typeof docsBase === "function" ? docsBase(code) : docsBase != null ? `${docsBase}/${code.toLowerCase()}` : void 0;
+			return {
+				code,
+				level: def.level ?? "error",
+				message: resolveTemplate(def.message, params),
+				...docs != null && { docs },
+				...resolveTemplate(def.fix, params) != null && { fix: resolveTemplate(def.fix, params) },
+				...resolveTemplate(def.why, params) != null && { why: resolveTemplate(def.why, params) },
+				...resolveTemplate(def.hint, params) != null && { hint: resolveTemplate(def.hint, params) },
+				...overrides
+			};
+		};
+	}
+	Object.defineProperties(result, {
+		codes: {
+			value: () => codeKeys,
+			enumerable: false
+		},
+		has: {
+			value: (code) => code in codes,
+			enumerable: false
+		},
+		get: {
+			value: (code) => codes[code],
+			enumerable: false
+		},
+		extend: {
+			value: (defs) => defineDiagnostics({
+				...options,
+				codes: {
+					...codes,
+					...defs
+				}
+			}),
+			enumerable: false
+		}
+	});
+	return result;
+}
+//#endregion
+//#region src/error.ts
+var CodedError = class extends Error {
+	diagnostic;
+	constructor(diagnostic) {
+		super(`[${diagnostic.code}] ${diagnostic.message}`);
+		this.name = "CodedError";
+		this.diagnostic = diagnostic;
+		if (diagnostic.cause != null) this.cause = diagnostic.cause;
+	}
+};
+//#endregion
+//#region src/reporter.ts
+const consoleReporter = (diagnostic, formatted) => {
+	if (diagnostic.level === "error") console.error(formatted);
+	else console.warn(formatted);
+};
+function createFetchReporter(url) {
+	return (diagnostic, _formatted) => {
+		fetch(url, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(diagnostic)
+		}).catch(() => {});
+	};
+}
+//#endregion
+//#region src/logger.ts
+function captureStackTrace() {
+	const err = {};
+	if (typeof Error.captureStackTrace === "function") Error.captureStackTrace(err, captureStackTrace);
+	else err.stack = (/* @__PURE__ */ new Error()).stack;
+	if (!err.stack) return void 0;
+	const lines = err.stack.split("\n");
+	let frameStart = 0;
+	while (frameStart < lines.length && !lines[frameStart].trimStart().startsWith("at ")) frameStart++;
+	const skipInternal = typeof Error.captureStackTrace === "function" ? 1 : 2;
+	const frames = lines.slice(frameStart + skipInternal).filter((line) => !line.includes("/node_modules/") && !line.includes("(node:")).map((line) => line.trim());
+	return frames.length > 0 ? frames.join("\n") : void 0;
+}
+function formatAndReport(formatter, reporters, diagnostic) {
+	const formatted = formatter(diagnostic);
+	for (const reporter of reporters) reporter(diagnostic, formatted);
+	return formatted;
+}
+function createActions(diagnostic, formatter, reporters, shouldCaptureStack) {
+	return Object.assign({}, diagnostic, {
+		throw() {
+			const stack = shouldCaptureStack ? captureStackTrace() : void 0;
+			const d = stack ? {
+				...diagnostic,
+				stack
+			} : diagnostic;
+			formatAndReport(formatter, reporters, d);
+			throw new CodedError(d);
+		},
+		warn() {
+			const stack = shouldCaptureStack ? captureStackTrace() : void 0;
+			formatAndReport(formatter, reporters, {
+				...diagnostic,
+				level: "warn",
+				...stack && { stack }
+			});
+		},
+		error() {
+			const stack = shouldCaptureStack ? captureStackTrace() : void 0;
+			formatAndReport(formatter, reporters, {
+				...diagnostic,
+				level: "error",
+				...stack && { stack }
+			});
+		},
+		log() {
+			const stack = shouldCaptureStack ? captureStackTrace() : void 0;
+			formatAndReport(formatter, reporters, stack ? {
+				...diagnostic,
+				stack
+			} : diagnostic);
+		},
+		format() {
+			return formatter(diagnostic);
+		}
+	});
+}
+function createLogger(options) {
+	const formatter = options.formatter ?? plainFormatter;
+	const reporters = Array.isArray(options.reporter) ? options.reporter : [options.reporter ?? consoleReporter];
+	const shouldCaptureStack = options.captureStack !== false;
+	const result = {};
+	for (const diagnostics of options.diagnostics) {
+		const codeKeys = typeof diagnostics.codes === "function" ? diagnostics.codes() : Object.keys(diagnostics);
+		for (const code of codeKeys) if (typeof diagnostics[code] === "function") result[code] = (...args) => {
+			return createActions(diagnostics[code](...args), formatter, reporters, shouldCaptureStack);
+		};
+	}
+	result.throw = (diagnostic) => {
+		const stack = shouldCaptureStack ? captureStackTrace() : void 0;
+		const d = stack ? {
+			...diagnostic,
+			stack
+		} : diagnostic;
+		formatAndReport(formatter, reporters, d);
+		throw new CodedError(d);
+	};
+	result.warn = (diagnostic) => {
+		const stack = shouldCaptureStack ? captureStackTrace() : void 0;
+		formatAndReport(formatter, reporters, {
+			...diagnostic,
+			level: "warn",
+			...stack && { stack }
+		});
+	};
+	result.error = (diagnostic) => {
+		const stack = shouldCaptureStack ? captureStackTrace() : void 0;
+		formatAndReport(formatter, reporters, {
+			...diagnostic,
+			level: "error",
+			...stack && { stack }
+		});
+	};
+	result.log = (diagnostic) => {
+		const stack = shouldCaptureStack ? captureStackTrace() : void 0;
+		formatAndReport(formatter, reporters, stack ? {
+			...diagnostic,
+			stack
+		} : diagnostic);
+	};
+	result.format = (diagnostic) => {
+		return formatter(diagnostic);
+	};
+	return result;
+}
+//#endregion
+export { CodedError, consoleReporter, createFetchReporter, createLogger, defineDiagnostics, formatTag, plainFormatter, renderFrame };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/diagnostics.ts","../src/error.ts","../src/reporter.ts","../src/logger.ts"],"sourcesContent":["import type { ExtractParams, IsEmptyObject, Simplify } from './utils'\n\nexport type DiagnosticLevel = 'error' | 'warn' | 'suggestion' | 'deprecation'\n\nexport interface SourceLocation {\n  file?: string\n  line?: number\n  column?: number\n}\n\nexport interface Diagnostic {\n  code: string\n  level: DiagnosticLevel\n  message: string\n  why?: string\n  fix?: string\n  hint?: string\n  docs?: string\n  sources?: SourceLocation[]\n  cause?: unknown\n  context?: Record<string, unknown>\n  stack?: string\n}\n\nexport type Overrides = Partial<Pick<Diagnostic, 'level' | 'sources' | 'cause' | 'context'>>\n\nexport type MessageTemplate<P = any> = string | ((params: P) => string)\n\nexport interface DiagnosticDefinition {\n  message: MessageTemplate\n  fix?: MessageTemplate\n  why?: MessageTemplate\n  hint?: MessageTemplate\n  level?: DiagnosticLevel\n}\n\nexport type CodeFactory<T>\n  = IsEmptyObject<ExtractParams<T>> extends true\n    ? (overrides?: Overrides) => Diagnostic\n    : (params: Simplify<ExtractParams<T>>, overrides?: Overrides) => Diagnostic\n\nexport interface DiagnosticsMethods<C extends Record<string, DiagnosticDefinition>> {\n  codes: () => (keyof C & string)[]\n  has: (code: string) => code is Extract<keyof C, string>\n  get: <K extends keyof C>(code: K) => C[K]\n  extend: <U extends Record<string, DiagnosticDefinition>>(defs: U) => DiagnosticsResult<C & U>\n}\n\nexport type DiagnosticsResult<C extends Record<string, DiagnosticDefinition>> = {\n  [K in keyof C]: CodeFactory<C[K]>\n} & DiagnosticsMethods<C>\n\nexport interface DefineDiagnosticsOptions<C extends Record<string, DiagnosticDefinition>> {\n  docsBase?: string | ((code: string) => string | undefined)\n  codes: C\n}\n\nfunction resolveTemplate(template: MessageTemplate | undefined, params: any): string | undefined {\n  if (template == null)\n    return undefined\n  if (typeof template === 'function')\n    return template(params)\n  return template\n}\n\nexport function defineDiagnostics<C extends Record<string, DiagnosticDefinition>>(\n  options: DefineDiagnosticsOptions<C>,\n): DiagnosticsResult<C> {\n  const { docsBase, codes } = options\n\n  const result = {} as any\n  const codeKeys = Object.keys(codes)\n\n  for (const code of codeKeys) {\n    const def = codes[code]\n    result[code] = (paramsOrOverrides?: any, maybeOverrides?: Overrides): Diagnostic => {\n      // Determine if first arg is params or overrides\n      const hasParams = typeof def.message === 'function'\n        || typeof def.fix === 'function'\n        || typeof def.why === 'function'\n        || typeof def.hint === 'function'\n\n      const params = hasParams ? paramsOrOverrides : undefined\n      const overrides = hasParams ? maybeOverrides : paramsOrOverrides as Overrides | undefined\n\n      const docs = typeof docsBase === 'function'\n        ? docsBase(code)\n        : docsBase != null\n          ? `${docsBase}/${code.toLowerCase()}`\n          : undefined\n\n      const diagnostic: Diagnostic = {\n        code,\n        level: def.level ?? 'error',\n        message: resolveTemplate(def.message, params)!,\n        ...(docs != null && { docs }),\n        ...resolveTemplate(def.fix, params) != null && { fix: resolveTemplate(def.fix, params) },\n        ...resolveTemplate(def.why, params) != null && { why: resolveTemplate(def.why, params) },\n        ...resolveTemplate(def.hint, params) != null && { hint: resolveTemplate(def.hint, params) },\n        ...overrides,\n      }\n\n      return diagnostic\n    }\n  }\n\n  Object.defineProperties(result, {\n    codes: {\n      value: () => codeKeys,\n      enumerable: false,\n    },\n    has: {\n      value: (code: string) => code in codes,\n      enumerable: false,\n    },\n    get: {\n      value: (code: string) => codes[code],\n      enumerable: false,\n    },\n    extend: {\n      value: <U extends Record<string, DiagnosticDefinition>>(defs: U) =>\n        defineDiagnostics({ ...options, codes: { ...codes, ...defs } as any }),\n      enumerable: false,\n    },\n  })\n\n  return result as DiagnosticsResult<C>\n}\n","import type { Diagnostic } from './diagnostics'\n\nexport class CodedError extends Error {\n  readonly diagnostic: Diagnostic\n\n  constructor(diagnostic: Diagnostic) {\n    super(`[${diagnostic.code}] ${diagnostic.message}`)\n    this.name = 'CodedError'\n    this.diagnostic = diagnostic\n    if (diagnostic.cause != null)\n      this.cause = diagnostic.cause\n  }\n}\n","import type { Diagnostic } from './diagnostics'\n\nexport type Reporter = (diagnostic: Diagnostic, formatted: string) => void\n\nexport const consoleReporter: Reporter = (diagnostic, formatted) => {\n  if (diagnostic.level === 'error')\n    console.error(formatted)\n  else\n    console.warn(formatted)\n}\n\nexport function createFetchReporter(url: string): Reporter {\n  return (diagnostic, _formatted) => {\n    fetch(url, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(diagnostic),\n    }).catch(() => { })\n  }\n}\n","import type { Diagnostic } from './diagnostics'\nimport type { Formatter } from './format'\nimport type { Reporter } from './reporter'\nimport { CodedError } from './error'\nimport { plainFormatter } from './format'\nimport { consoleReporter } from './reporter'\n\nexport interface DiagnosticActions extends Diagnostic {\n  throw: () => never\n  warn: () => void\n  error: () => void\n  log: () => void\n  format: () => string\n}\n\n// Type utilities for extracting params from template fields\n\ntype ActionFactories<T> = {\n  [K in keyof T as T[K] extends (...args: any[]) => Diagnostic ? K : never]:\n  T[K] extends (...args: infer A) => Diagnostic\n    ? (...args: A) => DiagnosticActions\n    : never\n}\n\nexport type MergeFactories<D extends readonly any[]>\n  = D extends readonly [infer First, ...infer Rest]\n    ? ActionFactories<First> & MergeFactories<Rest>\n    // eslint-disable-next-line ts/no-empty-object-type\n    : {}\n\nexport interface LoggerMethods {\n  throw: (diagnostic: Diagnostic) => never\n  warn: (diagnostic: Diagnostic) => void\n  error: (diagnostic: Diagnostic) => void\n  log: (diagnostic: Diagnostic) => void\n  format: (diagnostic: Diagnostic) => string\n}\n\nexport type Logger<D extends readonly any[]> = MergeFactories<D> & LoggerMethods\n\nexport interface CreateLoggerOptions<D extends readonly any[]> {\n  diagnostics: [...D]\n  formatter?: Formatter\n  reporter?: Reporter | Reporter[]\n  captureStack?: boolean\n}\n\nfunction captureStackTrace(): string | undefined {\n  const err: { stack?: string } = {}\n  if (typeof Error.captureStackTrace === 'function') {\n    Error.captureStackTrace(err, captureStackTrace)\n  }\n  else {\n    // eslint-disable-next-line unicorn/error-message -- only used for stack capture\n    err.stack = new Error().stack\n  }\n  if (!err.stack)\n    return undefined\n\n  const lines = err.stack.split('\\n')\n\n  // Find where \"at \" frames begin (skip \"Error\" header)\n  let frameStart = 0\n  while (frameStart < lines.length && !lines[frameStart].trimStart().startsWith('at ')) {\n    frameStart++\n  }\n\n  // V8 captureStackTrace already strips captureStackTrace itself,\n  // fallback needs to skip captureStackTrace + the action method (2 frames)\n  const skipInternal = typeof Error.captureStackTrace === 'function' ? 1 : 2\n\n  const frames = lines\n    .slice(frameStart + skipInternal)\n    .filter(line => !line.includes('/node_modules/') && !line.includes('(node:'))\n    .map(line => line.trim())\n\n  return frames.length > 0 ? frames.join('\\n') : undefined\n}\n\nfunction formatAndReport(formatter: Formatter, reporters: Reporter[], diagnostic: Diagnostic): string {\n  const formatted = formatter(diagnostic)\n  for (const reporter of reporters)\n    reporter(diagnostic, formatted)\n  return formatted\n}\n\nfunction createActions(\n  diagnostic: Diagnostic,\n  formatter: Formatter,\n  reporters: Reporter[],\n  shouldCaptureStack: boolean,\n): DiagnosticActions {\n  return Object.assign({}, diagnostic, {\n    throw(): never {\n      const stack = shouldCaptureStack ? captureStackTrace() : undefined\n      const d = stack ? { ...diagnostic, stack } : diagnostic\n      formatAndReport(formatter, reporters, d)\n      throw new CodedError(d)\n    },\n    warn() {\n      const stack = shouldCaptureStack ? captureStackTrace() : undefined\n      formatAndReport(formatter, reporters, { ...diagnostic, level: 'warn' as const, ...(stack && { stack }) })\n    },\n    error() {\n      const stack = shouldCaptureStack ? captureStackTrace() : undefined\n      formatAndReport(formatter, reporters, { ...diagnostic, level: 'error' as const, ...(stack && { stack }) })\n    },\n    log() {\n      const stack = shouldCaptureStack ? captureStackTrace() : undefined\n      const d = stack ? { ...diagnostic, stack } : diagnostic\n      formatAndReport(formatter, reporters, d)\n    },\n    format() {\n      return formatter(diagnostic)\n    },\n  })\n}\n\nexport function createLogger<const D extends readonly any[]>(\n  options: CreateLoggerOptions<D>,\n): Logger<D> {\n  const formatter = options.formatter ?? plainFormatter\n  const reporters = Array.isArray(options.reporter)\n    ? options.reporter\n    : [options.reporter ?? consoleReporter]\n  const shouldCaptureStack = options.captureStack !== false\n\n  const result = {} as any\n\n  // Merge all diagnostic code factories\n  for (const diagnostics of options.diagnostics) {\n    const codeKeys = typeof diagnostics.codes === 'function'\n      ? diagnostics.codes()\n      : Object.keys(diagnostics)\n\n    for (const code of codeKeys) {\n      if (typeof diagnostics[code] === 'function') {\n        result[code] = (...args: any[]) => {\n          const diagnostic = diagnostics[code](...args)\n          return createActions(diagnostic, formatter, reporters, shouldCaptureStack)\n        }\n      }\n    }\n  }\n\n  // Raw logger methods\n  result.throw = (diagnostic: Diagnostic): never => {\n    const stack = shouldCaptureStack ? captureStackTrace() : undefined\n    const d = stack ? { ...diagnostic, stack } : diagnostic\n    formatAndReport(formatter, reporters, d)\n    throw new CodedError(d)\n  }\n  result.warn = (diagnostic: Diagnostic): void => {\n    const stack = shouldCaptureStack ? captureStackTrace() : undefined\n    formatAndReport(formatter, reporters, { ...diagnostic, level: 'warn' as const, ...(stack && { stack }) })\n  }\n  result.error = (diagnostic: Diagnostic): void => {\n    const stack = shouldCaptureStack ? captureStackTrace() : undefined\n    formatAndReport(formatter, reporters, { ...diagnostic, level: 'error' as const, ...(stack && { stack }) })\n  }\n  result.log = (diagnostic: Diagnostic): void => {\n    const stack = shouldCaptureStack ? captureStackTrace() : undefined\n    const d = stack ? { ...diagnostic, stack } : diagnostic\n    formatAndReport(formatter, reporters, d)\n  }\n  result.format = (diagnostic: Diagnostic): string => {\n    return formatter(diagnostic)\n  }\n\n  return result as Logger<D>\n}\n"],"mappings":"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"}

package/dist/reporter-DDQiiD6l.d.mts

@@ -0,0 +1,9 @@
+import { r as Diagnostic } from "./diagnostics-CSUYJHfP.mjs";
+
+//#region src/reporter.d.ts
+type Reporter = (diagnostic: Diagnostic, formatted: string) => void;
+declare const consoleReporter: Reporter;
+declare function createFetchReporter(url: string): Reporter;
+//#endregion
+export { consoleReporter as n, createFetchReporter as r, Reporter as t };
+//# sourceMappingURL=reporter-DDQiiD6l.d.mts.map

package/dist/unplugin.d.mts

@@ -0,0 +1,28 @@
+import { UnpluginInstance } from "unplugin";
+import MagicString from "magic-string";
+
+//#region src/code-transform/transform.d.ts
+interface TransformOptions {
+  /**
+  * The package name to detect imports from.
+  * @default 'nostics'
+  */
+  packageName?: string;
+}
+//#endregion
+//#region src/code-transform/server-plugin.d.ts
+interface LogsSdkServerOptions {
+  /**
+  * Path to the log file.
+  * @default '.nostics.log'
+  */
+  logFile?: string;
+}
+declare const logsSDKServer: UnpluginInstance<LogsSdkServerOptions | undefined>;
+//#endregion
+//#region src/code-transform/unplugin.d.ts
+type LogsSdkPluginOptions = TransformOptions;
+declare const logsSDK: UnpluginInstance<LogsSdkPluginOptions | undefined>;
+//#endregion
+export { LogsSdkPluginOptions, type LogsSdkServerOptions, logsSDK as default, logsSDK, logsSDKServer };
+//# sourceMappingURL=unplugin.d.mts.map