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

package/dist/diagnostics.d.ts

@@ -32,8 +32,29 @@
  * terminal, a terminal-only component in an editor preview). It rendered
  * 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' | '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 type DiagnosticKind = 'invalid-attribute-value' | 'unsafe-image-src' | 'form-mismatch' | 'no-engine-view';
+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. */
@@ -42,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;
 /**
@@ -62,11 +85,18 @@ export declare function reportDiagnostic(onDiagnostic: OnDiagnostic | undefined,
  * `directive` is the composed directive name (`ana_meter`), `pack` the
  * pack's namespace, and `engines` the engine ids (`react`, `ansi`) the
  * component DOES ship a view for.
+ *
+ * `loadFailed` marks a component whose pack could not be loaded for this
+ * render's engine at all (its view script threw, registered nothing, or
+ * registered another namespace). The renderer then words the fallback as a
+ * failed pack rather than a missing view. Absent means the pack loaded and
+ * simply has no view for the component.
  */
 export interface UnavailableComponent {
     readonly directive: string;
     readonly pack: string;
     readonly engines: readonly string[];
+    readonly loadFailed?: true;
 }
 /** A lookup from a directive name to its `UnavailableComponent`, or `undefined`. */
 export type UnavailableComponentLookup = (directive: string) => UnavailableComponent | undefined;

package/dist/diagnostics.js

@@ -47,7 +47,7 @@ export function createUnavailableComponentLookup(components) {
     for (const entry of components) {
         if (entry === null || typeof entry !== 'object')
             continue;
-        const { directive, pack, engines } = entry;
+        const { directive, pack, engines, loadFailed } = entry;
         if (typeof directive !== 'string' || typeof pack !== 'string')
             continue;
         if (!Array.isArray(engines))
@@ -58,6 +58,7 @@ export function createUnavailableComponentLookup(components) {
             directive,
             pack,
             engines: engines.filter((e) => typeof e === 'string'),
+            ...(loadFailed === true ? { loadFailed: true } : {}),
         });
     }
     if (byName.size === 0)

package/dist/editor/fences/container-fences.d.ts

@@ -22,7 +22,7 @@
  * how a note renders.
  *
  * Pure and host-neutral: no editor API, no filesystem, no `node:*`. It is
- * re-exported from `@markii/host/browser`, and
+ * re-exported from `@markii/host`'s main entry, and
  * `apps/vscode/src/browser-entry.probe.test.ts` is the gate for that.
  */
 /** A container-directive fence pair enclosing an insertion point. */

package/dist/editor/fences/container-fences.js

@@ -22,7 +22,7 @@
  * how a note renders.
  *
  * Pure and host-neutral: no editor API, no filesystem, no `node:*`. It is
- * re-exported from `@markii/host/browser`, and
+ * re-exported from `@markii/host`'s main entry, and
  * `apps/vscode/src/browser-entry.probe.test.ts` is the gate for that.
  */
 /**

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.0",
+  "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",