@markii/stdlib 0.16.0 → 0.17.0-next.0

package/dist/diagnostics.d.ts

@@ -22,8 +22,18 @@
  * `'unsafe-image-src'` — a component-built `<img>` (the standard `figure`)
  * had its `src` refused as an unsafe URL scheme; the component rendered
  * without the image, with a quiet marker.
+ *
+ * `'form-mismatch'` — a registered block component was written as an
+ * inline directive (`:callout[x]`); it rendered as the inline fallback
+ * marker instead of the component.
+ *
+ * `'no-engine-view'` — a directive names a component of an INSTALLED pack
+ * that ships no view for this render engine (a React-only pack in the
+ * 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`.
  */
-export type DiagnosticKind = 'invalid-attribute-value' | 'unsafe-image-src';
+export type DiagnosticKind = 'invalid-attribute-value' | 'unsafe-image-src' | 'form-mismatch' | 'no-engine-view';
 export interface DiagnosticEvent {
     readonly kind: DiagnosticKind;
     /** The directive name the event happened on, when there is a single unambiguous one. */
@@ -43,3 +53,29 @@ export type OnDiagnostic = (event: DiagnosticEvent) => void;
  * guard cannot drift between them.
  */
 export declare function reportDiagnostic(onDiagnostic: OnDiagnostic | undefined, event: DiagnosticEvent): void;
+/**
+ * One component of an installed pack that the current render cannot draw,
+ * as plain data a host hands to a renderer's `unavailableComponents`
+ * option. The renderer uses it only to tell this case apart from a typo:
+ * the fallback box keeps its structure and the label changes.
+ *
+ * `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.
+ */
+export interface UnavailableComponent {
+    readonly directive: string;
+    readonly pack: string;
+    readonly engines: readonly string[];
+}
+/** A lookup from a directive name to its `UnavailableComponent`, or `undefined`. */
+export type UnavailableComponentLookup = (directive: string) => UnavailableComponent | undefined;
+/**
+ * Builds the lookup a renderer queries per directive. Backed by a `Map`
+ * (never a plain object), so a directive named `constructor` or
+ * `__proto__` cannot resolve through the prototype chain. An omitted or
+ * empty list gives `undefined`, so a renderer given no option takes
+ * exactly the path it took before the option existed. Entries that are not
+ * well-formed are skipped, and the first entry for a name wins.
+ */
+export declare function createUnavailableComponentLookup(components: readonly UnavailableComponent[] | undefined): UnavailableComponentLookup | undefined;

package/dist/diagnostics.js

@@ -32,3 +32,35 @@ export function reportDiagnostic(onDiagnostic, event) {
         // A throwing callback must never break rendering.
     }
 }
+/**
+ * Builds the lookup a renderer queries per directive. Backed by a `Map`
+ * (never a plain object), so a directive named `constructor` or
+ * `__proto__` cannot resolve through the prototype chain. An omitted or
+ * empty list gives `undefined`, so a renderer given no option takes
+ * exactly the path it took before the option existed. Entries that are not
+ * well-formed are skipped, and the first entry for a name wins.
+ */
+export function createUnavailableComponentLookup(components) {
+    if (!Array.isArray(components) || components.length === 0)
+        return undefined;
+    const byName = new Map();
+    for (const entry of components) {
+        if (entry === null || typeof entry !== 'object')
+            continue;
+        const { directive, pack, engines } = entry;
+        if (typeof directive !== 'string' || typeof pack !== 'string')
+            continue;
+        if (!Array.isArray(engines))
+            continue;
+        if (byName.has(directive))
+            continue;
+        byName.set(directive, {
+            directive,
+            pack,
+            engines: engines.filter((e) => typeof e === 'string'),
+        });
+    }
+    if (byName.size === 0)
+        return undefined;
+    return (directive) => byName.get(directive);
+}

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, type DiagnosticEvent, type DiagnosticKind, type OnDiagnostic, } from './diagnostics.js';
+export { reportDiagnostic, createUnavailableComponentLookup, type UnavailableComponent, type UnavailableComponentLookup, type DiagnosticEvent, type DiagnosticKind, type OnDiagnostic, } from './diagnostics.js';
 export { INTERACTIVE_ATTRIBUTE } from './interactive.js';

package/dist/index.js

@@ -3,5 +3,5 @@ export { ALIGN_PRESETS, LAYOUT_ATTRIBUTE_KEYS, LAYOUT_ATTRIBUTES, WIDTH_PRESETS,
 export { TEXT_ALIGN_ATTRIBUTE, TEXT_ALIGN_COMPONENTS, TEXT_ALIGN_PRESETS, } from './text-align.js';
 export { formatValue, isNumericLike, FORMAT_ATTRIBUTE, DECIMALS_ATTRIBUTE, } from './value-format.js';
 export { deriveTableShape } from './table-shape.js';
-export { reportDiagnostic, } from './diagnostics.js';
+export { reportDiagnostic, createUnavailableComponentLookup, } from './diagnostics.js';
 export { INTERACTIVE_ATTRIBUTE } from './interactive.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markii/stdlib",
-  "version": "0.16.0",
+  "version": "0.17.0-next.0",
   "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",