@markii/stdlib 0.17.0-next.1 → 0.17.0-next.2

package/dist/diagnostics.d.ts

@@ -33,11 +33,28 @@
  * the fallback box, labeled as a missing view rather than an unknown
  * component. Only reported when the host passed `unavailableComponents`.
  *
+ * `'unknown-directive'` — a directive names no registered component and
+ * rendered as the unknown-component fallback box. Reported by the terminal
+ * engine only, so a host that wants a finding for every unknown directive
+ * (the language server) can place it; the other engines draw the same
+ * fallback and stay quiet.
+ *
  * `'code-renderer-failed'` — a host's `renderCode` callback threw for an
  * ordinary fenced code block; the block rendered as usual. Carries no
  * directive or attribute.
  */
-export type DiagnosticKind = 'invalid-attribute-value' | 'unsafe-image-src' | 'form-mismatch' | 'no-engine-view' | 'code-renderer-failed';
+export type DiagnosticKind = 'invalid-attribute-value' | 'unsafe-image-src' | 'form-mismatch' | 'no-engine-view' | 'unknown-directive' | 'code-renderer-failed';
+/**
+ * Where in the note's source an event happened: the directive's range, in
+ * unist coordinates (1-based line, 1-based column, end exclusive). Present
+ * only when the engine knows the node the event came from.
+ */
+export interface DiagnosticPosition {
+    readonly startLine: number;
+    readonly startColumn: number;
+    readonly endLine: number;
+    readonly endColumn: number;
+}
 export interface DiagnosticEvent {
     readonly kind: DiagnosticKind;
     /** The directive name the event happened on, when there is a single unambiguous one. */
@@ -46,6 +63,8 @@ export interface DiagnosticEvent {
     readonly attribute?: string;
     /** The same human-readable text the in-page marker's tooltip carries. */
     readonly message: string;
+    /** The source range of the directive the event came from, when the engine can say. */
+    readonly position?: DiagnosticPosition;
 }
 export type OnDiagnostic = (event: DiagnosticEvent) => void;
 /**

package/dist/index.d.ts

@@ -3,5 +3,5 @@ export { ALIGN_PRESETS, LAYOUT_ATTRIBUTE_KEYS, LAYOUT_ATTRIBUTES, WIDTH_PRESETS,
 export { TEXT_ALIGN_ATTRIBUTE, TEXT_ALIGN_COMPONENTS, TEXT_ALIGN_PRESETS, type TextAlignPreset, } from './text-align.js';
 export { formatValue, isNumericLike, FORMAT_ATTRIBUTE, DECIMALS_ATTRIBUTE, type ValueFormat, } from './value-format.js';
 export { deriveTableShape, type TableShape } from './table-shape.js';
-export { reportDiagnostic, createUnavailableComponentLookup, type UnavailableComponent, type UnavailableComponentLookup, type DiagnosticEvent, type DiagnosticKind, type OnDiagnostic, } from './diagnostics.js';
+export { reportDiagnostic, createUnavailableComponentLookup, type UnavailableComponent, type UnavailableComponentLookup, type DiagnosticEvent, type DiagnosticPosition, type DiagnosticKind, type OnDiagnostic, } from './diagnostics.js';
 export { INTERACTIVE_ATTRIBUTE } from './interactive.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markii/stdlib",
-  "version": "0.17.0-next.1",
+  "version": "0.17.0-next.2",
   "description": "Neutral, framework-agnostic standard component contracts for Mark (.mk.md) — the kind/attribute-schema seam every renderer (e.g. @markii/react) implements against. No React, zero dependencies.",
   "keywords": [
     "markdown",