basalt-ui 1.11.0 → 1.13.0

package/dist/agent-chat/virtualize.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Virtualization contract shared by the transcript/feed components that can opt into
+ * `@tanstack/react-virtual` for long lists.
+ *
+ * The `VirtualizeProps` union IS the guard: a virtualizer needs a measured scroll container, so
+ * turning `virtualize` on REQUIRES a `height` and turning it off (or omitting it) FORBIDS one. See
+ * `virtualize.type-guard.test.ts` beside this file for a compile-time proof that the union actually
+ * rejects the invalid combinations.
+ *
+ * The one piece of runtime here is {@link resolveVirtualize} — the single narrowing point every
+ * component that accepts `VirtualizeProps` goes through, so no call site has to re-derive (or
+ * assert its way past) the union's `virtualize`-implies-`height` link.
+ *
+ * The other half of the contract, not encoded in the types (it's a runtime/composition rule, not
+ * a shape): a virtualized transcript OWNS ITS OWN SCROLL NODE (the element `getScrollElement`
+ * measures) and must NOT be nested inside `BasaltStickToBottom` — unlike the non-virtual path,
+ * which `ThreadDetailPanel` nests inside `BasaltStickToBottom` today (its transcript body).
+ * Stacking a virtualizer's own scroll container inside `BasaltStickToBottom`'s would give the
+ * transcript two competing owners of "which element scrolls" and break both the virtualizer's
+ * `scrollToEnd` and stick-to-bottom's anchor tracking.
+ *
+ * A third composition rule, same category (runtime, not a shape): a virtualized transcript
+ * tolerates being hidden via `display: none` on an ANCESTOR (e.g. sitting inside a collapsible
+ * `ThreadFeedRow`) — collapsing does not corrupt its measurement cache, and re-expanding restores
+ * the same scroll position (same top-visible row) it had before the collapse. This is NOT free of
+ * virtual-core: hiding an ancestor makes every mounted row's ResizeObserver box report `0` (a
+ * `display: none` ancestor un-lays-out its descendants), and virtual-core 3.17.1's default
+ * `measureElement`/`resizeItem` write that `0` into `itemSizeCache` with no floor — unguarded, a
+ * few collapse/expand cycles permanently shrink `getTotalSize()` and silently scroll the visible
+ * window to a DIFFERENT part of the transcript (`scrollTop` stays put; the content under it moves).
+ * `thread-message.tsx` closes this with a `measureElement` override (`resolveGuardedMeasurement`)
+ * that treats a `0` reading as unreliable and keeps the last-known size instead of committing it —
+ * see that function's doc for the full mechanism, including why `useVirtualizer`'s `enabled` option
+ * is NOT the fix (it wipes the measurement cache outright, worse than the bug). A consumer combining a
+ * virtualized transcript with its own hide-via-CSS container gets this for free; a consumer who
+ * unmounts/remounts the transcript instead of hiding it is unaffected either way (a fresh
+ * `useVirtualizer` call has no stale cache to poison).
+ *
+ * A fourth composition rule: a virtualized transcript SCROLLS ITSELF on mount. `initialScroll`
+ * defaults to `'end'` — `anchorTo: 'end'` and `followOnAppend` (both wired in `thread-message.tsx`)
+ * only keep an ALREADY-at-the-end transcript pinned as content changes; neither performs the initial
+ * jump, so left alone a freshly mounted virtualized transcript renders at message #0, not the
+ * newest. The fix fires exactly once, on first mount, via `scrollToEnd()` — never again, so a user
+ * who has scrolled up is never yanked back down by a later append (that is precisely the failure
+ * `followOnAppend` exists to avoid, and re-introducing it here would be worse than the defect this
+ * closes). A consumer wiring its OWN scroll-restoration (e.g. `initialOffset` /
+ * `initialMeasurementsCache`, restoring a prior session's position) wants `initialScroll: 'start'` —
+ * otherwise this default jump fires first and the restoration has to fight it. `initialScroll` is
+ * ignored (no scroll, no throw) for an empty transcript, and is deferred rather than treated as done
+ * if the transcript's own scroll container measures 0px on mount (e.g. mounted behind a hidden
+ * ancestor) — it then lands on the first commit where the container is genuinely measurable, which
+ * is what makes "opens at the newest message" hold for a transcript whose lazy virtualizer settled
+ * while its `ThreadFeedRow` was collapsed. See `thread-message.tsx`'s `applyInitialScroll` for the
+ * guard, and `VirtualizedRowsInner` for why its effect is deliberately dependency-free.
+ *
+ * Firing `scrollToEnd()` once is not sufficient on its own to land there, because virtual-core
+ * 3.17.1's own `_willUpdate` writes to the SAME scroll container on the very next commit it runs
+ * on, from state that lags behind the DOM: `_scrollToOffset` only ever records the write's
+ * intent (`_intendedScrollOffset`) — `this.scrollOffset` itself updates ASYNCHRONOUSLY, from the
+ * native `scroll` event, not from the call that requested it. So a commit that runs `_willUpdate`
+ * before this effect had a chance to fire (element-attach) or that re-derives an anchor from
+ * `getScrollOffset()` while `this.scrollOffset` is still the pre-jump value (the anchor branch,
+ * gated on `pendingScrollAnchor`) writes that stale offset — 0, on first mount — straight back to
+ * `scrollTop`, clobbering this effect's jump within roughly one extra commit of it landing.
+ * `applyInitialScroll` survives this the same way the hidden-ancestor case above already
+ * (accidentally) does: by not treating one successful call as permanent. It fires, then — on a
+ * LATER call, i.e. a later commit, exactly the cadence this dependency-free effect already runs on
+ * — reads the container's REAL `scrollTop`/`scrollHeight`/`clientHeight` (never virtual-core's own
+ * `scrollOffset`, which is exactly the stale value that caused the clobber) to check whether the
+ * jump survived; if it didn't, it re-fires, bounded by `MAX_INITIAL_SCROLL_ATTEMPTS` so a DOM that
+ * pathologically never reports settled can never be fought forever. `resolveInitialScrollAction`
+ * itself is untouched by any of this — it is still the one-shot "should I even attempt this"
+ * decision; `applyInitialScroll` layers the across-commits verification on top.
+ *
+ * `initialOffset` (`number | (() => number)`, `virtual-core`'s own construction-time seed for
+ * `scrollOffset`) was investigated as a way to avoid the clobber altogether and rejected: it takes
+ * a concrete pixel number, not an `'end'` sentinel, and the only number available at the point
+ * it would need to resolve — before any row has ever been measured — is an ESTIMATE
+ * (`estimateSize` × count), not the real total. It would relocate the transcript's initial paint
+ * from message #0 to an approximately-right position, but the moment real measurements replace
+ * those estimates the total size (and therefore the true end offset) changes, which still needs a
+ * corrective `scrollToEnd()` once rows have actually measured — the exact write this whole
+ * mechanism exists to protect. It also can't reference the `virtualizer` instance it would be
+ * computing an offset for without a separate ref indirection, since it is itself one of the options
+ * passed to construct that instance. Not a fix for this defect, just a smaller wrong first paint.
+ */
+/** Tuning knobs passed through to `@tanstack/react-virtual`'s `useVirtualizer`. */
+export type VirtualizeOptions = {
+    /** Extra rows rendered beyond the visible viewport, each side. Library default: 1. */
+    readonly overscan?: number;
+    /** Estimated row height in px, used before a row has been measured. */
+    readonly estimateSize?: number;
+    /** Where the transcript sits on first mount. Default 'end' — a chat transcript opens at the
+        newest message. 'start' opens at the oldest. See this module's fourth composition rule
+        above for the mechanism and why a consumer restoring its own scroll position wants 'start'. */
+    readonly initialScroll?: 'end' | 'start';
+};
+/**
+ * `virtualize: false` (or omitted) → no `height` prop (content-sized, non-scrolling-owner layout).
+ * `virtualize: true | VirtualizeOptions` → `height` is REQUIRED — the virtualizer measures a fixed
+ * scroll container, so there is no valid virtualized layout without one.
+ */
+export type VirtualizeProps = {
+    readonly virtualize?: false;
+    readonly height?: never;
+} | {
+    readonly virtualize: true | VirtualizeOptions;
+    readonly height: number | string;
+};
+/** The enabled branch of {@link VirtualizeProps}, with `height` no longer optional. */
+export type ResolvedVirtualize = {
+    readonly options: VirtualizeOptions;
+    readonly height: number | string;
+};
+/**
+ * Narrows a `VirtualizeProps` pair once, centrally: `null` when virtualization is off, otherwise
+ * the options object (normalizing the bare `virtualize: true` shorthand to `{}`) alongside the
+ * `height` the union guarantees is present. Every component accepting `VirtualizeProps` resolves
+ * through here rather than destructuring the two fields apart — destructuring severs the link TS
+ * needs, which is what forces a non-null assertion on `height` at each call site.
+ */
+export declare function resolveVirtualize(props: VirtualizeProps): ResolvedVirtualize | null;
+//# sourceMappingURL=virtualize.d.ts.map

package/dist/agent-chat/virtualize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualize.d.ts","sourceRoot":"","sources":["../../src/agent-chat/virtualize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AAEH,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B;;sGAEkG;IAClG,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,OAAO,CAAA;CACzC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,GAAG,iBAAiB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAA;AAEvF,uFAAuF;AACvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACjC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,kBAAkB,GAAG,IAAI,CAUnF"}

package/dist/agent-chat/virtualize.js

@@ -0,0 +1,9 @@
+function resolveVirtualize(props) {
+  const { virtualize } = props;
+  if (virtualize === void 0 || virtualize === false) return null;
+  const height = props.height;
+  return { options: virtualize === true ? {} : virtualize, height };
+}
+export {
+  resolveVirtualize
+};

package/dist/agent-chat/virtualize.type-guard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=virtualize.type-guard.test.d.ts.map

package/dist/agent-chat/virtualize.type-guard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualize.type-guard.test.d.ts","sourceRoot":"","sources":["../../src/agent-chat/virtualize.type-guard.test.ts"],"names":[],"mappings":""}

package/dist/charts/primitives/ChartFrame.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChartFrame.test.d.ts.map

package/dist/charts/primitives/ChartFrame.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartFrame.test.d.ts","sourceRoot":"","sources":["../../../src/charts/primitives/ChartFrame.test.tsx"],"names":[],"mappings":""}

package/dist/charts/utils/domain.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain.test.d.ts.map

package/dist/charts/utils/domain.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.test.d.ts","sourceRoot":"","sources":["../../../src/charts/utils/domain.test.ts"],"names":[],"mappings":""}

package/dist/cli/check-theme.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=check-theme.test.d.ts.map

package/dist/cli/check-theme.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-theme.test.d.ts","sourceRoot":"","sources":["../../src/cli/check-theme.test.ts"],"names":[],"mappings":""}

package/dist/cli/help.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=help.test.d.ts.map

package/dist/cli/help.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.test.d.ts","sourceRoot":"","sources":["../../src/cli/help.test.ts"],"names":[],"mappings":""}

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/init-sync.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=init-sync.test.d.ts.map

package/dist/cli/init-sync.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-sync.test.d.ts","sourceRoot":"","sources":["../../src/cli/init-sync.test.ts"],"names":[],"mappings":""}

package/dist/cli/placement-engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=placement-engine.test.d.ts.map

package/dist/cli/placement-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement-engine.test.d.ts","sourceRoot":"","sources":["../../src/cli/placement-engine.test.ts"],"names":[],"mappings":""}

package/dist/cli/tarball-parity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tarball-parity.test.d.ts.map

package/dist/cli/tarball-parity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tarball-parity.test.d.ts","sourceRoot":"","sources":["../../src/cli/tarball-parity.test.ts"],"names":[],"mappings":""}

package/dist/cli/template-format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=template-format.test.d.ts.map

package/dist/cli/template-format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-format.test.d.ts","sourceRoot":"","sources":["../../src/cli/template-format.test.ts"],"names":[],"mappings":""}

package/dist/cli/template-ledger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=template-ledger.test.d.ts.map

package/dist/cli/template-ledger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-ledger.test.d.ts","sourceRoot":"","sources":["../../src/cli/template-ledger.test.ts"],"names":[],"mappings":""}

package/dist/cli/tokens-css.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tokens-css.test.d.ts.map

package/dist/cli/tokens-css.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens-css.test.d.ts","sourceRoot":"","sources":["../../src/cli/tokens-css.test.ts"],"names":[],"mappings":""}

package/dist/content/article-actions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=article-actions.test.d.ts.map

package/dist/content/article-actions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-actions.test.d.ts","sourceRoot":"","sources":["../../src/content/article-actions.test.ts"],"names":[],"mappings":""}

package/dist/content/article-model.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=article-model.test.d.ts.map

package/dist/content/article-model.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-model.test.d.ts","sourceRoot":"","sources":["../../src/content/article-model.test.ts"],"names":[],"mappings":""}

package/dist/content/block-split.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=block-split.test.d.ts.map

package/dist/content/block-split.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-split.test.d.ts","sourceRoot":"","sources":["../../src/content/block-split.test.ts"],"names":[],"mappings":""}

package/dist/content/fence-block.d.ts

@@ -1,19 +1,46 @@
+import type { ReactNode } from 'react';
+import type { Element } from 'hast';
+export type FenceRenderContext = {
+    /** The fence body, without the surrounding fence markers. */
+    readonly code: string;
+    /** The info string's first word (` ```ts title="x" ` → `'ts'`), absent on a bare fence. */
+    readonly language?: string;
+    /** Raw meta string after the language on the opening fence line (`'title="x"'` above). */
+    readonly meta?: string;
+    /** Parsed `title="…"` out of `meta` — the filename tab `CodeBlock` renders. */
+    readonly title?: string;
+    /** `false` only for the in-flight tail block of a streaming message. Monotone: never true→false. */
+    readonly settled: boolean;
+};
 /**
- * FenceBlock — renders a fenced code block's hast `pre` node as `CodeBlock` or `MermaidDiagram`
- * (docs/CONTENT-SPEC.md §2 decision 4 / §6). Shared by every `pre` override `./markdown` builds
- * (one per streamed block, each with its own `settled` flag).
+ * `undefined` DECLINES — the fence falls back to the default `CodeBlock` rendering, no different
+ * from an unclaimed language. `null` is NOT a decline; it is a deliberate "render nothing" result
+ * and is used as-is. A renderer that THROWS is also contained and falls back to `CodeBlock` (see the
+ * module doc above) — no renderer needs its own try/parse/fallback scaffolding to survive malformed,
+ * model-authored fence bodies.
+ */
+export type FenceRenderer = (ctx: FenceRenderContext) => ReactNode;
+/** Fence renderers keyed by language. */
+export type FenceRenderers = Readonly<Record<string, FenceRenderer>>;
+/**
+ * Wraps a renderer that is only worth running on finished text: renders the plain `CodeBlock`
+ * while the fence is still streaming, then `render` once its block settles. The built-in `mermaid`
+ * entry IS this — a consumer's own heavyweight fence (a chart spec, a diagram DSL) wants the same
+ * deal.
  *
- * `mermaid` fences render as a plain `CodeBlock` while `settled` is `false` (the in-flight
- * streaming tail) and upgrade to `MermaidDiagram` once the fence's block settles — no flicker, no
- * wasted parse pass on a still-changing diagram. Every other fenced language hides its copy
- * action while unsettled for the same reason (copying a still-streaming block is misleading).
+ * @example
+ * import { settledOnly } from 'basalt-ui/content'
  *
- * Not part of the public surface.
+ * <Markdown fenceRenderers={{ vega: settledOnly(({ code }) => <VegaChart spec={code} />) }}>
  */
-import type { Element } from 'hast';
+export declare function settledOnly(render: FenceRenderer): FenceRenderer;
+/** basalt's own fence renderers. A consumer entry for the same key wins over these. */
+export declare const BUILT_IN_FENCE_RENDERERS: FenceRenderers;
 export type FenceBlockProps = {
     readonly node?: Element;
     readonly settled: boolean;
+    /** Consumer overrides, consulted BEFORE `BUILT_IN_FENCE_RENDERERS`. */
+    readonly renderers?: FenceRenderers;
 };
-export declare function FenceBlock({ node, settled }: FenceBlockProps): import("react").JSX.Element | null;
+export declare function FenceBlock({ node, settled, renderers }: FenceBlockProps): import("react").JSX.Element | null;
 //# sourceMappingURL=fence-block.d.ts.map

package/dist/content/fence-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fence-block.d.ts","sourceRoot":"","sources":["../../src/content/fence-block.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAKnC,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,eAAe,sCAgB5D"}
+{"version":3,"file":"fence-block.d.ts","sourceRoot":"","sources":["../../src/content/fence-block.tsx"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAOnC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,oGAAoG;IACpG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,SAAS,CAAA;AAElE,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;AAYpE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEhE;AAED,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,EAAE,cAEtC,CAAA;AAiBD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAA;CACpC,CAAA;AA2HD,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,eAAe,sCA2BvE"}

package/dist/content/fence-block.js

@@ -1,23 +1,89 @@
 import { jsx } from "react/jsx-runtime";
+import { Component, useRef } from "react";
 import { CodeBlock } from "./code-block.js";
 import { extractFenceInfo } from "./markdown-hast.js";
 import { MermaidDiagram } from "./mermaid.js";
-function FenceBlock({ node, settled }) {
-  const fence = node ? extractFenceInfo(node) : void 0;
-  if (!fence) return null;
-  if (fence.language === "mermaid" && settled) {
-    return /* @__PURE__ */ jsx(MermaidDiagram, { code: fence.code });
+const defaultFenceRenderer = ({ code, language, title, settled }) => /* @__PURE__ */ jsx(
+  CodeBlock,
+  {
+    code,
+    showCopy: settled,
+    ...language !== void 0 && { language },
+    ...title !== void 0 && { title }
   }
-  return /* @__PURE__ */ jsx(
-    CodeBlock,
-    {
-      code: fence.code,
-      showCopy: settled,
-      ...fence.language !== void 0 && { language: fence.language },
-      ...fence.title !== void 0 && { title: fence.title }
-    }
+);
+function settledOnly(render) {
+  return (ctx) => ctx.settled ? render(ctx) : defaultFenceRenderer(ctx);
+}
+const BUILT_IN_FENCE_RENDERERS = {
+  mermaid: settledOnly(({ code }) => /* @__PURE__ */ jsx(MermaidDiagram, { code }))
+};
+function extractFenceMeta(preNode) {
+  const codeNode = preNode.children.find(
+    (child) => child.type === "element" && child.tagName === "code"
   );
+  const data = codeNode?.data;
+  return data?.meta;
+}
+function lookupFenceRenderer(registry, language) {
+  if (registry === void 0 || !Object.hasOwn(registry, language)) return void 0;
+  const candidate = registry[language];
+  return typeof candidate === "function" ? candidate : void 0;
+}
+function warnFenceRendererThrew(warned, error) {
+  if (warned.current) return;
+  warned.current = true;
+  if (process.env["NODE_ENV"] !== "production") {
+    console.warn(
+      "[basalt] FenceBlock: a fence renderer threw \u2014 falling back to the default CodeBlock rendering.",
+      error
+    );
+  }
+}
+function renderFenceSafely(render, ctx, warned) {
+  let rendered;
+  try {
+    rendered = render(ctx);
+  } catch (error) {
+    warnFenceRendererThrew(warned, error);
+    return defaultFenceRenderer(ctx);
+  }
+  return rendered === void 0 ? defaultFenceRenderer(ctx) : rendered;
+}
+class FenceRenderBoundary extends Component {
+  constructor(props) {
+    super(props);
+    this.state = { hasError: false };
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  componentDidCatch(error) {
+    warnFenceRendererThrew(this.props.warned, error);
+  }
+  render() {
+    return this.state.hasError ? defaultFenceRenderer(this.props.ctx) : this.props.children;
+  }
+}
+function FenceBlock({ node, settled, renderers }) {
+  const warned = useRef(false);
+  const fence = node ? extractFenceInfo(node) : void 0;
+  if (!fence) return null;
+  const meta = node ? extractFenceMeta(node) : void 0;
+  const ctx = {
+    code: fence.code,
+    settled,
+    ...fence.language !== void 0 && { language: fence.language },
+    ...fence.title !== void 0 && { title: fence.title },
+    ...meta !== void 0 && { meta }
+  };
+  const language = fence.language;
+  const render = language === void 0 ? void 0 : lookupFenceRenderer(renderers, language) ?? lookupFenceRenderer(BUILT_IN_FENCE_RENDERERS, language);
+  const active = render ?? defaultFenceRenderer;
+  return /* @__PURE__ */ jsx(FenceRenderBoundary, { ctx, warned, children: renderFenceSafely(active, ctx, warned) }, ctx.code);
 }
 export {
-  FenceBlock
+  BUILT_IN_FENCE_RENDERERS,
+  FenceBlock,
+  settledOnly
 };

package/dist/content/heading-components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heading-components.d.ts","sourceRoot":"","sources":["../../src/content/heading-components.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,gBAAgB,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAqCzC,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CASjF"}
+{"version":3,"file":"heading-components.d.ts","sourceRoot":"","sources":["../../src/content/heading-components.tsx"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,gBAAgB,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AA8CzC,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CASjF"}

package/dist/content/heading-components.js

@@ -18,11 +18,14 @@ function headingText(node) {
 }
 function createHeadingRenderer(level, tracker) {
   const Tag = HEADING_TAGS[level];
-  return function HeadingRenderer({ children }) {
-    const id = tracker.slug(headingText(children));
-    return /* @__PURE__ */ jsxs(Tag, { id, children: [
+  return function HeadingRenderer({ id, children, node: _node, ...rest }) {
+    if (id !== void 0) {
+      return /* @__PURE__ */ jsx(Tag, { id, ...rest, children });
+    }
+    const slug = tracker.slug(headingText(children));
+    return /* @__PURE__ */ jsxs(Tag, { id: slug, ...rest, children: [
       children,
-      /* @__PURE__ */ jsx(HeadingAnchor, { id })
+      /* @__PURE__ */ jsx(HeadingAnchor, { id: slug })
     ] });
   };
 }

package/dist/content/heading-components.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=heading-components.test.d.ts.map

package/dist/content/heading-components.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-components.test.d.ts","sourceRoot":"","sources":["../../src/content/heading-components.test.tsx"],"names":[],"mappings":""}

package/dist/content/index.d.ts

@@ -4,7 +4,8 @@
  * Mantine-coupled (like `./forms`/`./notifications`/`./data`): prose typography, a shiki-backed
  * code block (optional peer, lazy singleton), a semantic callout, a scroll-spy TOC rail, a
  * scroll-driven reading-progress bar, a streaming-aware `Markdown` renderer (react-markdown +
- * remark-gfm, optional peers), `MermaidDiagram` (beautiful-mermaid, optional peer), the MDX
+ * remark-gfm + rehype-sanitize + remend, all optional peers) with its fence-renderer registry,
+ * `MermaidDiagram` (beautiful-mermaid, optional peer), the MDX
  * component map, the docs-page frame (`ArticleLayout`), overview cards (`ArticleCard`/
  * `ArticleGrid`), and the contextual-help drawer (`GuideLink`/`GuideDrawer`). See
  * `agent/rules/basalt-content.md` for the full doctrine + the content-collections recipe.
@@ -23,8 +24,10 @@ export { headingSlug, readingTime, SlugTracker } from './slug.js';
 export type { ReadingTime } from './slug.js';
 export { HeadingAnchor } from './heading-anchor.js';
 export type { HeadingAnchorProps } from './heading-anchor.js';
-export { Markdown } from './markdown.js';
-export type { MarkdownComponents, MarkdownProps } from './markdown.js';
+export { Markdown, settledOnly } from './markdown.js';
+export type { FenceRenderContext, FenceRenderer, FenceRenderers, MarkdownComponents, MarkdownContentTrust, MarkdownProps, } from './markdown.js';
+export { BASALT_SANITIZE_SCHEMA, mergeSanitizeSchema } from './sanitize.js';
+export type { SanitizePropertyDefinition, SanitizeSchema, SanitizeSchemaExtension, SanitizeSchemaInput, } from './sanitize.js';
 export { MermaidDiagram } from './mermaid.js';
 export type { MermaidDiagramProps } from './mermaid.js';
 export { blockSplit } from './block-split.js';

package/dist/content/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AACvC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1D,YAAY,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE/F,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACzD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAExE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACjF,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,YAAY,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAChD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AACvC,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAClD,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACxE,YAAY,EACV,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1D,YAAY,EAAE,0BAA0B,EAAE,MAAM,OAAO,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE/F,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACzD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAExE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACjF,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,YAAY,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAChD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA"}

package/dist/content/index.js

@@ -5,7 +5,8 @@ import { TableOfContents } from "./toc.js";
 import { ReadingProgress } from "./reading-progress.js";
 import { headingSlug, readingTime, SlugTracker } from "./slug.js";
 import { HeadingAnchor } from "./heading-anchor.js";
-import { Markdown } from "./markdown.js";
+import { Markdown, settledOnly } from "./markdown.js";
+import { BASALT_SANITIZE_SCHEMA, mergeSanitizeSchema } from "./sanitize.js";
 import { MermaidDiagram } from "./mermaid.js";
 import { blockSplit } from "./block-split.js";
 import { createMdxComponents, mdxComponents } from "./mdx.js";
@@ -20,6 +21,7 @@ export {
   ArticleFilterBar,
   ArticleGrid,
   ArticleLayout,
+  BASALT_SANITIZE_SCHEMA,
   Callout,
   CodeBlock,
   GuideDrawer,
@@ -37,7 +39,9 @@ export {
   formatArticleDate,
   headingSlug,
   mdxComponents,
+  mergeSanitizeSchema,
   readingTime,
+  settledOnly,
   sortArticles,
   toArticleActions
 };