vantage-md 0.5.5 → 0.5.7

package/dist/index.d.cts

@@ -1,32 +1,31 @@
-import { Root } from 'hast';
-import { Plugin, PluggableList } from 'unified';
-import { defaultSchema } from 'rehype-sanitize';
-
+import { PluggableList, Plugin } from "unified";
+import { defaultSchema } from "rehype-sanitize";
+//#region src/renderMarkdown.d.ts
 /**
  * Framework-agnostic markdown -> HTML rendering pipeline.
  * Uses the same remark/rehype chain as the Vantage viewer.
  */
 interface RenderOptions {
-    /** Enable GFM tables, strikethrough, task lists (default: true) */
-    gfm?: boolean;
-    /** Enable KaTeX math rendering (default: true) */
-    math?: boolean;
-    /** Enable syntax highlighting (default: true) */
-    highlight?: boolean;
-    /** Add data-source-line attributes for line anchors (default: true) */
-    sourceLines?: boolean;
-    /** Enable XSS sanitization (default: true) */
-    sanitize?: boolean;
-    /** Parse and strip frontmatter (default: true) */
-    frontmatter?: boolean;
+  /** Enable GFM tables, strikethrough, task lists (default: true) */
+  gfm?: boolean;
+  /** Enable KaTeX math rendering (default: true) */
+  math?: boolean;
+  /** Enable syntax highlighting (default: true) */
+  highlight?: boolean;
+  /** Add data-source-line attributes for line anchors (default: true) */
+  sourceLines?: boolean;
+  /** Enable XSS sanitization (default: true) */
+  sanitize?: boolean;
+  /** Parse and strip frontmatter (default: true) */
+  frontmatter?: boolean;
 }
 interface RenderResult {
-    /** The rendered HTML string */
-    html: string;
-    /** Parsed frontmatter (empty object if none or disabled) */
-    frontmatter: Record<string, unknown>;
-    /** The markdown body with frontmatter stripped */
-    body: string;
+  /** The rendered HTML string */
+  html: string;
+  /** Parsed frontmatter (empty object if none or disabled) */
+  frontmatter: Record<string, unknown>;
+  /** The markdown body with frontmatter stripped */
+  body: string;
 }
 /**
  * Render a markdown string to HTML using the full Vantage pipeline.
@@ -45,48 +44,1000 @@ interface RenderResult {
  * Use the React `<MarkdownViewer>` component for client-side mermaid rendering.
  */
 declare function renderMarkdown(content: string, options?: RenderOptions): Promise<RenderResult>;
-
+//#endregion
+//#region ../../node_modules/@types/unist/index.d.ts
+// ## Interfaces
 /**
- * Rehype plugin that adds `data-source-line` attributes to block-level
- * elements based on their position in the original markdown source.
+ * Info associated with nodes by the ecosystem.
  *
- * This enables GitHub-style line anchors (#L42, #L42-L50) by giving
- * each rendered block a traceable line number from the source.
+ * This space is guaranteed to never be specified by unist or specifications
+ * implementing unist.
+ * But you can use it in utilities and plugins to store data.
+ *
+ * This type can be augmented to register custom data.
+ * For example:
+ *
+ * ```ts
+ * declare module 'unist' {
+ *   interface Data {
+ *     // `someNode.data.myId` is typed as `number | undefined`
+ *     myId?: number | undefined
+ *   }
+ * }
+ * ```
  */
-
-interface RehypeSourceLinesOptions {
-    /**
-     * Lines stripped off the front of the file before parsing — frontmatter,
-     * essentially. Added to every emitted line number so `data-source-line`
-     * names a line in the *file* rather than in the parsed body, which is what
-     * a `#L42` link written against the file means. Defaults to 0.
-     */
-    offset?: number;
+interface Data$1 {}
+/**
+ * One place in a source file.
+ */
+interface Point {
+  /**
+   * Line in a source file (1-indexed integer).
+   */
+  line: number;
+  /**
+   * Column in a source file (1-indexed integer).
+   */
+  column: number;
+  /**
+   * Character in a source file (0-indexed integer).
+   */
+  offset?: number | undefined;
+}
+/**
+ * Position of a node in a source document.
+ *
+ * A position is a range between two points.
+ */
+interface Position {
+  /**
+   * Place of the first character of the parsed source region.
+   */
+  start: Point;
+  /**
+   * Place of the first character after the parsed source region.
+   */
+  end: Point;
 }
-declare const rehypeSourceLines: Plugin<[RehypeSourceLinesOptions?], Root>;
-
 /**
- * Rehype plugin that compiles `<!-- vantage: … -->` directives into
- * `data-vantage-*` attributes on the block that follows them.
+ * Abstract unist node.
  *
- * It has to run between `rehype-raw` — which turns the comment into a hast node
- * — and `rehype-sanitize`, which deletes every comment node. That is the only
- * window in which the information exists (`docs/reference/inline-markup.md`, "Where the plugin runs"),
- * and `pipeline.ts` is where the slot is spelled out.
+ * The syntactic unit in unist syntax trees are called nodes.
  *
- * The grammar and the vocabulary live in `./vantageDirectives.js`, which the
- * CLI checker imports too: one parser, two callers, so a directive cannot mean
- * one thing in the viewer and another in the tool that validates it (D5).
+ * This interface is supposed to be extended.
+ * If you can use {@link Literal} or {@link Parent}, you should.
+ * But for example in markdown, a `thematicBreak` (`***`), is neither literal
+ * nor parent, but still a node.
+ */
+interface Node$1 {
+  /**
+   * Node type.
+   */
+  type: string;
+  /**
+   * Info from the ecosystem.
+   */
+  data?: Data$1 | undefined;
+  /**
+   * Position of a node in a source document.
+   *
+   * Nodes that are generated (not in the original source document) must not
+   * have a position.
+   */
+  position?: Position | undefined;
+}
+//#endregion
+//#region ../../node_modules/@types/hast/index.d.ts
+// ## Interfaces
+/**
+ * Info associated with hast nodes by the ecosystem.
+ *
+ * This space is guaranteed to never be specified by unist or hast.
+ * But you can use it in utilities and plugins to store data.
+ *
+ * This type can be augmented to register custom data.
+ * For example:
+ *
+ * ```ts
+ * declare module 'hast' {
+ *   interface Data {
+ *     // `someNode.data.myId` is typed as `number | undefined`
+ *     myId?: number | undefined
+ *   }
+ * }
+ * ```
+ */
+interface Data extends Data$1 {}
+/**
+ * Info associated with an element.
+ */
+interface Properties {
+  abbr?: string | undefined;
+  about?: Array<string> | undefined;
+  accentHeight?: number | string | undefined;
+  accept?: Array<string> | undefined;
+  acceptCharset?: Array<string> | undefined;
+  accessKey?: Array<string> | undefined;
+  accumulate?: string | undefined;
+  action?: string | undefined;
+  additive?: string | undefined;
+  align?: string | undefined;
+  alignmentBaseline?: string | undefined;
+  aLink?: string | undefined;
+  allow?: string | undefined;
+  allowFullScreen?: boolean | string | undefined;
+  allowPaymentRequest?: boolean | string | undefined;
+  allowTransparency?: string | undefined;
+  allowUserMedia?: boolean | string | undefined;
+  alpha?: boolean | string | undefined;
+  alphabetic?: number | string | undefined;
+  alt?: string | undefined;
+  amplitude?: number | string | undefined;
+  arabicForm?: string | undefined;
+  archive?: Array<string> | undefined;
+  ariaActiveDescendant?: string | undefined;
+  ariaAtomic?: "false" | "true" | (string & {}) | undefined;
+  ariaAutoComplete?: string | undefined;
+  ariaBusy?: "false" | "true" | (string & {}) | undefined;
+  ariaChecked?: "false" | "true" | (string & {}) | undefined;
+  ariaColCount?: number | string | undefined;
+  ariaColIndex?: number | string | undefined;
+  ariaColSpan?: number | string | undefined;
+  ariaControls?: Array<string> | undefined;
+  ariaCurrent?: string | undefined;
+  ariaDescribedBy?: Array<string> | undefined;
+  ariaDetails?: string | undefined;
+  ariaDisabled?: "false" | "true" | (string & {}) | undefined;
+  ariaDropEffect?: Array<string> | undefined;
+  ariaErrorMessage?: string | undefined;
+  ariaExpanded?: "false" | "true" | (string & {}) | undefined;
+  ariaFlowTo?: Array<string> | undefined;
+  ariaGrabbed?: "false" | "true" | (string & {}) | undefined;
+  ariaHasPopup?: string | undefined;
+  ariaHidden?: "false" | "true" | (string & {}) | undefined;
+  ariaInvalid?: string | undefined;
+  ariaKeyShortcuts?: string | undefined;
+  ariaLabel?: string | undefined;
+  ariaLabelledBy?: Array<string> | undefined;
+  ariaLevel?: number | string | undefined;
+  ariaLive?: string | undefined;
+  ariaModal?: "false" | "true" | (string & {}) | undefined;
+  ariaMultiLine?: "false" | "true" | (string & {}) | undefined;
+  ariaMultiSelectable?: "false" | "true" | (string & {}) | undefined;
+  ariaOrientation?: string | undefined;
+  ariaOwns?: Array<string> | undefined;
+  ariaPlaceholder?: string | undefined;
+  ariaPosInSet?: number | string | undefined;
+  ariaPressed?: "false" | "true" | (string & {}) | undefined;
+  ariaReadOnly?: "false" | "true" | (string & {}) | undefined;
+  ariaRelevant?: string | undefined;
+  ariaRequired?: "false" | "true" | (string & {}) | undefined;
+  ariaRoleDescription?: Array<string> | undefined;
+  ariaRowCount?: number | string | undefined;
+  ariaRowIndex?: number | string | undefined;
+  ariaRowSpan?: number | string | undefined;
+  ariaSelected?: "false" | "true" | (string & {}) | undefined;
+  ariaSetSize?: number | string | undefined;
+  ariaSort?: string | undefined;
+  ariaValueMax?: number | string | undefined;
+  ariaValueMin?: number | string | undefined;
+  ariaValueNow?: number | string | undefined;
+  ariaValueText?: string | undefined;
+  as?: string | undefined;
+  ascent?: number | string | undefined;
+  async?: boolean | string | undefined;
+  attributeName?: string | undefined;
+  attributeType?: string | undefined;
+  autoCapitalize?: string | undefined;
+  autoComplete?: Array<string> | undefined;
+  autoCorrect?: string | undefined;
+  autoFocus?: boolean | string | undefined;
+  autoPlay?: boolean | string | undefined;
+  autoSave?: string | undefined;
+  axis?: string | undefined;
+  azimuth?: number | string | undefined;
+  background?: string | undefined;
+  bandwidth?: string | undefined;
+  baseFrequency?: string | undefined;
+  baselineShift?: string | undefined;
+  baseProfile?: string | undefined;
+  bbox?: string | undefined;
+  begin?: string | undefined;
+  bgColor?: string | undefined;
+  bias?: number | string | undefined;
+  blocking?: Array<string> | undefined;
+  border?: number | string | undefined;
+  borderColor?: string | undefined;
+  bottomMargin?: number | string | undefined;
+  by?: string | undefined;
+  calcMode?: string | undefined;
+  capHeight?: number | string | undefined;
+  capture?: string | undefined;
+  cellPadding?: string | undefined;
+  cellSpacing?: string | undefined;
+  char?: string | undefined;
+  charOff?: string | undefined;
+  charSet?: string | undefined;
+  checked?: boolean | string | undefined;
+  cite?: string | undefined;
+  classId?: string | undefined;
+  className?: Array<string> | undefined;
+  clear?: string | undefined;
+  clip?: string | undefined;
+  clipPath?: string | undefined;
+  clipPathUnits?: string | undefined;
+  clipRule?: string | undefined;
+  closedBy?: string | undefined;
+  code?: string | undefined;
+  codeBase?: string | undefined;
+  codeType?: string | undefined;
+  color?: string | undefined;
+  colorInterpolation?: string | undefined;
+  colorInterpolationFilters?: string | undefined;
+  colorProfile?: string | undefined;
+  colorRendering?: string | undefined;
+  colorSpace?: string | undefined;
+  cols?: number | string | undefined;
+  colSpan?: number | string | undefined;
+  command?: string | undefined;
+  commandFor?: string | undefined;
+  compact?: boolean | string | undefined;
+  content?: string | undefined;
+  contentEditable?: "false" | "true" | (string & {}) | undefined;
+  contentScriptType?: string | undefined;
+  contentStyleType?: string | undefined;
+  controls?: boolean | string | undefined;
+  controlsList?: Array<string> | undefined;
+  coords?: Array<number | string> | undefined;
+  credentialless?: boolean | string | undefined;
+  crossOrigin?: string | undefined;
+  cursor?: string | undefined;
+  cx?: string | undefined;
+  cy?: string | undefined;
+  d?: string | undefined;
+  data?: string | undefined;
+  dataType?: string | undefined;
+  dateTime?: string | undefined;
+  declare?: boolean | string | undefined;
+  decoding?: string | undefined;
+  default?: boolean | string | undefined;
+  defaultAction?: string | undefined;
+  defer?: boolean | string | undefined;
+  descent?: number | string | undefined;
+  diffuseConstant?: number | string | undefined;
+  dir?: string | undefined;
+  direction?: string | undefined;
+  dirName?: string | undefined;
+  disabled?: boolean | string | undefined;
+  disablePictureInPicture?: boolean | string | undefined;
+  disableRemotePlayback?: boolean | string | undefined;
+  display?: string | undefined;
+  divisor?: number | string | undefined;
+  dominantBaseline?: string | undefined;
+  download?: boolean | string | undefined;
+  draggable?: "false" | "true" | (string & {}) | undefined;
+  dur?: string | undefined;
+  dx?: string | undefined;
+  dy?: string | undefined;
+  edgeMode?: string | undefined;
+  editable?: string | undefined;
+  elevation?: number | string | undefined;
+  enableBackground?: string | undefined;
+  encType?: string | undefined;
+  end?: string | undefined;
+  enterKeyHint?: string | undefined;
+  event?: string | undefined;
+  exponent?: number | string | undefined;
+  exportParts?: Array<string> | undefined;
+  externalResourcesRequired?: string | undefined;
+  face?: string | undefined;
+  fetchPriority?: string | undefined;
+  fill?: string | undefined;
+  fillOpacity?: number | string | undefined;
+  fillRule?: string | undefined;
+  filter?: string | undefined;
+  filterRes?: string | undefined;
+  filterUnits?: string | undefined;
+  floodColor?: string | undefined;
+  floodOpacity?: string | undefined;
+  focusable?: string | undefined;
+  focusHighlight?: string | undefined;
+  fontFamily?: string | undefined;
+  fontSize?: string | undefined;
+  fontSizeAdjust?: string | undefined;
+  fontStretch?: string | undefined;
+  fontStyle?: string | undefined;
+  fontVariant?: string | undefined;
+  fontWeight?: string | undefined;
+  form?: string | undefined;
+  formAction?: string | undefined;
+  format?: string | undefined;
+  formEncType?: string | undefined;
+  formMethod?: string | undefined;
+  formNoValidate?: boolean | string | undefined;
+  formTarget?: string | undefined;
+  fr?: string | undefined;
+  frame?: string | undefined;
+  frameBorder?: string | undefined;
+  from?: string | undefined;
+  fx?: string | undefined;
+  fy?: string | undefined;
+  g1?: Array<string> | undefined;
+  g2?: Array<string> | undefined;
+  glyphName?: Array<string> | undefined;
+  glyphOrientationHorizontal?: string | undefined;
+  glyphOrientationVertical?: string | undefined;
+  glyphRef?: string | undefined;
+  gradientTransform?: string | undefined;
+  gradientUnits?: string | undefined;
+  handler?: string | undefined;
+  hanging?: number | string | undefined;
+  hatchContentUnits?: string | undefined;
+  hatchUnits?: string | undefined;
+  headers?: Array<string> | undefined;
+  height?: number | string | undefined;
+  hidden?: boolean | string | undefined;
+  high?: number | string | undefined;
+  horizAdvX?: number | string | undefined;
+  horizOriginX?: number | string | undefined;
+  horizOriginY?: number | string | undefined;
+  href?: string | undefined;
+  hrefLang?: string | undefined;
+  hSpace?: number | string | undefined;
+  htmlFor?: Array<string> | undefined;
+  httpEquiv?: Array<string> | undefined;
+  id?: string | undefined;
+  ideographic?: number | string | undefined;
+  imageRendering?: string | undefined;
+  imageSizes?: string | undefined;
+  imageSrcSet?: string | undefined;
+  in?: string | undefined;
+  in2?: string | undefined;
+  inert?: boolean | string | undefined;
+  initialVisibility?: string | undefined;
+  inputMode?: string | undefined;
+  integrity?: string | undefined;
+  intercept?: number | string | undefined;
+  is?: string | undefined;
+  isMap?: boolean | string | undefined;
+  itemId?: string | undefined;
+  itemProp?: Array<string> | undefined;
+  itemRef?: Array<string> | undefined;
+  itemScope?: boolean | string | undefined;
+  itemType?: Array<string> | undefined;
+  k?: number | string | undefined;
+  k1?: number | string | undefined;
+  k2?: number | string | undefined;
+  k3?: number | string | undefined;
+  k4?: number | string | undefined;
+  kernelMatrix?: Array<string> | undefined;
+  kernelUnitLength?: string | undefined;
+  kerning?: string | undefined;
+  keyPoints?: string | undefined;
+  keySplines?: string | undefined;
+  keyTimes?: string | undefined;
+  kind?: string | undefined;
+  label?: string | undefined;
+  lang?: string | undefined;
+  language?: string | undefined;
+  leftMargin?: number | string | undefined;
+  lengthAdjust?: string | undefined;
+  letterSpacing?: string | undefined;
+  lightingColor?: string | undefined;
+  limitingConeAngle?: number | string | undefined;
+  link?: string | undefined;
+  list?: string | undefined;
+  loading?: string | undefined;
+  local?: string | undefined;
+  longDesc?: string | undefined;
+  loop?: boolean | string | undefined;
+  low?: number | string | undefined;
+  lowSrc?: string | undefined;
+  manifest?: string | undefined;
+  marginHeight?: number | string | undefined;
+  marginWidth?: number | string | undefined;
+  markerEnd?: string | undefined;
+  markerHeight?: string | undefined;
+  markerMid?: string | undefined;
+  markerStart?: string | undefined;
+  markerUnits?: string | undefined;
+  markerWidth?: string | undefined;
+  mask?: string | undefined;
+  maskContentUnits?: string | undefined;
+  maskType?: string | undefined;
+  maskUnits?: string | undefined;
+  mathematical?: string | undefined;
+  max?: string | undefined;
+  maxLength?: number | string | undefined;
+  media?: string | undefined;
+  mediaCharacterEncoding?: string | undefined;
+  mediaContentEncodings?: string | undefined;
+  mediaSize?: number | string | undefined;
+  mediaTime?: string | undefined;
+  method?: string | undefined;
+  min?: string | undefined;
+  minLength?: number | string | undefined;
+  mode?: string | undefined;
+  multiple?: boolean | string | undefined;
+  muted?: boolean | string | undefined;
+  name?: string | undefined;
+  navDown?: string | undefined;
+  navDownLeft?: string | undefined;
+  navDownRight?: string | undefined;
+  navLeft?: string | undefined;
+  navNext?: string | undefined;
+  navPrev?: string | undefined;
+  navRight?: string | undefined;
+  navUp?: string | undefined;
+  navUpLeft?: string | undefined;
+  navUpRight?: string | undefined;
+  noHref?: boolean | string | undefined;
+  noModule?: boolean | string | undefined;
+  nonce?: string | undefined;
+  noResize?: boolean | string | undefined;
+  noShade?: boolean | string | undefined;
+  noValidate?: boolean | string | undefined;
+  noWrap?: boolean | string | undefined;
+  numOctaves?: string | undefined;
+  object?: string | undefined;
+  observer?: string | undefined;
+  offset?: string | undefined;
+  onAbort?: string | undefined;
+  onActivate?: string | undefined;
+  onAfterPrint?: string | undefined;
+  onAuxClick?: string | undefined;
+  onBeforeMatch?: string | undefined;
+  onBeforePrint?: string | undefined;
+  onBeforeToggle?: string | undefined;
+  onBeforeUnload?: string | undefined;
+  onBegin?: string | undefined;
+  onBlur?: string | undefined;
+  onCancel?: string | undefined;
+  onCanPlay?: string | undefined;
+  onCanPlayThrough?: string | undefined;
+  onChange?: string | undefined;
+  onClick?: string | undefined;
+  onClose?: string | undefined;
+  onContextLost?: string | undefined;
+  onContextMenu?: string | undefined;
+  onContextRestored?: string | undefined;
+  onCopy?: string | undefined;
+  onCueChange?: string | undefined;
+  onCut?: string | undefined;
+  onDblClick?: string | undefined;
+  onDrag?: string | undefined;
+  onDragEnd?: string | undefined;
+  onDragEnter?: string | undefined;
+  onDragExit?: string | undefined;
+  onDragLeave?: string | undefined;
+  onDragOver?: string | undefined;
+  onDragStart?: string | undefined;
+  onDrop?: string | undefined;
+  onDurationChange?: string | undefined;
+  onEmptied?: string | undefined;
+  onEnd?: string | undefined;
+  onEnded?: string | undefined;
+  onError?: string | undefined;
+  onFocus?: string | undefined;
+  onFocusIn?: string | undefined;
+  onFocusOut?: string | undefined;
+  onFormData?: string | undefined;
+  onHashChange?: string | undefined;
+  onInput?: string | undefined;
+  onInvalid?: string | undefined;
+  onKeyDown?: string | undefined;
+  onKeyPress?: string | undefined;
+  onKeyUp?: string | undefined;
+  onLanguageChange?: string | undefined;
+  onLoad?: string | undefined;
+  onLoadedData?: string | undefined;
+  onLoadedMetadata?: string | undefined;
+  onLoadEnd?: string | undefined;
+  onLoadStart?: string | undefined;
+  onMessage?: string | undefined;
+  onMessageError?: string | undefined;
+  onMouseDown?: string | undefined;
+  onMouseEnter?: string | undefined;
+  onMouseLeave?: string | undefined;
+  onMouseMove?: string | undefined;
+  onMouseOut?: string | undefined;
+  onMouseOver?: string | undefined;
+  onMouseUp?: string | undefined;
+  onMouseWheel?: string | undefined;
+  onOffline?: string | undefined;
+  onOnline?: string | undefined;
+  onPageHide?: string | undefined;
+  onPageShow?: string | undefined;
+  onPaste?: string | undefined;
+  onPause?: string | undefined;
+  onPlay?: string | undefined;
+  onPlaying?: string | undefined;
+  onPopState?: string | undefined;
+  onProgress?: string | undefined;
+  onRateChange?: string | undefined;
+  onRejectionHandled?: string | undefined;
+  onRepeat?: string | undefined;
+  onReset?: string | undefined;
+  onResize?: string | undefined;
+  onScroll?: string | undefined;
+  onScrollEnd?: string | undefined;
+  onSecurityPolicyViolation?: string | undefined;
+  onSeeked?: string | undefined;
+  onSeeking?: string | undefined;
+  onSelect?: string | undefined;
+  onShow?: string | undefined;
+  onSlotChange?: string | undefined;
+  onStalled?: string | undefined;
+  onStorage?: string | undefined;
+  onSubmit?: string | undefined;
+  onSuspend?: string | undefined;
+  onTimeUpdate?: string | undefined;
+  onToggle?: string | undefined;
+  onUnhandledRejection?: string | undefined;
+  onUnload?: string | undefined;
+  onVolumeChange?: string | undefined;
+  onWaiting?: string | undefined;
+  onWheel?: string | undefined;
+  onZoom?: string | undefined;
+  opacity?: string | undefined;
+  open?: boolean | string | undefined;
+  operator?: string | undefined;
+  optimum?: number | string | undefined;
+  order?: string | undefined;
+  orient?: string | undefined;
+  orientation?: string | undefined;
+  origin?: string | undefined;
+  overflow?: string | undefined;
+  overlay?: string | undefined;
+  overlinePosition?: number | string | undefined;
+  overlineThickness?: number | string | undefined;
+  paintOrder?: string | undefined;
+  panose1?: string | undefined;
+  part?: Array<string> | undefined;
+  path?: string | undefined;
+  pathLength?: number | string | undefined;
+  pattern?: string | undefined;
+  patternContentUnits?: string | undefined;
+  patternTransform?: string | undefined;
+  patternUnits?: string | undefined;
+  phase?: string | undefined;
+  ping?: Array<string> | undefined;
+  pitch?: string | undefined;
+  placeholder?: string | undefined;
+  playbackOrder?: string | undefined;
+  playsInline?: boolean | string | undefined;
+  pointerEvents?: string | undefined;
+  points?: string | undefined;
+  pointsAtX?: number | string | undefined;
+  pointsAtY?: number | string | undefined;
+  pointsAtZ?: number | string | undefined;
+  popover?: string | undefined;
+  popoverTarget?: string | undefined;
+  popoverTargetAction?: string | undefined;
+  poster?: string | undefined;
+  prefix?: string | undefined;
+  preload?: string | undefined;
+  preserveAlpha?: string | undefined;
+  preserveAspectRatio?: string | undefined;
+  primitiveUnits?: string | undefined;
+  profile?: string | undefined;
+  prompt?: string | undefined;
+  propagate?: string | undefined;
+  property?: string | Array<string> | undefined;
+  r?: string | undefined;
+  radius?: string | undefined;
+  readOnly?: boolean | string | undefined;
+  referrerPolicy?: string | undefined;
+  refX?: string | undefined;
+  refY?: string | undefined;
+  rel?: Array<string> | undefined;
+  renderingIntent?: string | undefined;
+  repeatCount?: string | undefined;
+  repeatDur?: string | undefined;
+  required?: boolean | string | undefined;
+  requiredExtensions?: Array<string> | undefined;
+  requiredFeatures?: Array<string> | undefined;
+  requiredFonts?: Array<string> | undefined;
+  requiredFormats?: Array<string> | undefined;
+  resource?: string | undefined;
+  restart?: string | undefined;
+  result?: string | undefined;
+  results?: number | string | undefined;
+  rev?: string | Array<string> | undefined;
+  reversed?: boolean | string | undefined;
+  rightMargin?: number | string | undefined;
+  role?: string | undefined;
+  rotate?: string | undefined;
+  rows?: number | string | undefined;
+  rowSpan?: number | string | undefined;
+  rules?: string | undefined;
+  rx?: string | undefined;
+  ry?: string | undefined;
+  sandbox?: Array<string> | undefined;
+  scale?: string | undefined;
+  scheme?: string | undefined;
+  scope?: string | undefined;
+  scoped?: boolean | string | undefined;
+  scrolling?: "false" | "true" | (string & {}) | undefined;
+  seamless?: boolean | string | undefined;
+  security?: string | undefined;
+  seed?: string | undefined;
+  selected?: boolean | string | undefined;
+  shadowRootClonable?: boolean | string | undefined;
+  shadowRootCustomElementRegistry?: boolean | string | undefined;
+  shadowRootDelegatesFocus?: boolean | string | undefined;
+  shadowRootMode?: string | undefined;
+  shadowRootSerializable?: boolean | string | undefined;
+  shape?: string | undefined;
+  shapeRendering?: string | undefined;
+  side?: string | undefined;
+  size?: number | string | undefined;
+  sizes?: string | undefined;
+  slope?: string | undefined;
+  slot?: string | undefined;
+  snapshotTime?: string | undefined;
+  spacing?: string | undefined;
+  span?: number | string | undefined;
+  specularConstant?: number | string | undefined;
+  specularExponent?: number | string | undefined;
+  spellCheck?: "false" | "true" | (string & {}) | undefined;
+  spreadMethod?: string | undefined;
+  src?: string | undefined;
+  srcDoc?: string | undefined;
+  srcLang?: string | undefined;
+  srcSet?: string | undefined;
+  standby?: string | undefined;
+  start?: number | string | undefined;
+  startOffset?: string | undefined;
+  stdDeviation?: string | undefined;
+  stemh?: string | undefined;
+  stemv?: string | undefined;
+  step?: string | undefined;
+  stitchTiles?: string | undefined;
+  stopColor?: string | undefined;
+  stopOpacity?: string | undefined;
+  strikethroughPosition?: number | string | undefined;
+  strikethroughThickness?: number | string | undefined;
+  string?: string | undefined;
+  stroke?: string | undefined;
+  strokeDashArray?: Array<string> | undefined;
+  strokeDashOffset?: string | undefined;
+  strokeLineCap?: string | undefined;
+  strokeLineJoin?: string | undefined;
+  strokeMiterLimit?: number | string | undefined;
+  strokeOpacity?: number | string | undefined;
+  strokeWidth?: string | undefined;
+  style?: string | undefined;
+  summary?: string | undefined;
+  surfaceScale?: number | string | undefined;
+  syncBehavior?: string | undefined;
+  syncBehaviorDefault?: string | undefined;
+  syncMaster?: string | undefined;
+  syncTolerance?: string | undefined;
+  syncToleranceDefault?: string | undefined;
+  systemLanguage?: Array<string> | undefined;
+  tabIndex?: number | string | undefined;
+  tableValues?: string | undefined;
+  target?: string | undefined;
+  targetX?: number | string | undefined;
+  targetY?: number | string | undefined;
+  text?: string | undefined;
+  textAnchor?: string | undefined;
+  textDecoration?: string | undefined;
+  textLength?: string | undefined;
+  textRendering?: string | undefined;
+  timelineBegin?: string | undefined;
+  title?: string | undefined;
+  to?: string | undefined;
+  topMargin?: number | string | undefined;
+  transform?: string | undefined;
+  transformBehavior?: string | undefined;
+  transformOrigin?: string | undefined;
+  translate?: string | undefined;
+  type?: string | undefined;
+  typeMustMatch?: boolean | string | undefined;
+  typeOf?: Array<string> | undefined;
+  u1?: string | undefined;
+  u2?: string | undefined;
+  underlinePosition?: number | string | undefined;
+  underlineThickness?: number | string | undefined;
+  unicode?: string | undefined;
+  unicodeBidi?: string | undefined;
+  unicodeRange?: string | undefined;
+  unitsPerEm?: number | string | undefined;
+  unselectable?: string | undefined;
+  useMap?: string | undefined;
+  vAlign?: string | undefined;
+  vAlphabetic?: number | string | undefined;
+  value?: "false" | "true" | (string & {}) | undefined;
+  values?: string | undefined;
+  valueType?: string | undefined;
+  vectorEffect?: string | undefined;
+  version?: string | undefined;
+  vertAdvY?: number | string | undefined;
+  vertOriginX?: number | string | undefined;
+  vertOriginY?: number | string | undefined;
+  vHanging?: number | string | undefined;
+  vIdeographic?: number | string | undefined;
+  viewBox?: string | undefined;
+  viewTarget?: string | undefined;
+  visibility?: string | undefined;
+  vLink?: string | undefined;
+  vMathematical?: number | string | undefined;
+  vSpace?: number | string | undefined;
+  width?: number | string | undefined;
+  widths?: string | undefined;
+  wordSpacing?: string | undefined;
+  wrap?: string | undefined;
+  writingMode?: string | undefined;
+  writingSuggestions?: string | undefined;
+  x?: string | undefined;
+  x1?: string | undefined;
+  x2?: string | undefined;
+  xChannelSelector?: string | undefined;
+  xHeight?: number | string | undefined;
+  xLinkActuate?: string | undefined;
+  xLinkArcRole?: string | undefined;
+  xLinkHref?: string | undefined;
+  xLinkRole?: string | undefined;
+  xLinkShow?: string | undefined;
+  xLinkTitle?: string | undefined;
+  xLinkType?: string | undefined;
+  xmlBase?: string | undefined;
+  xmlLang?: string | undefined;
+  xmlns?: string | undefined;
+  xmlnsXLink?: string | undefined;
+  xmlSpace?: string | undefined;
+  y?: string | undefined;
+  y1?: string | undefined;
+  y2?: string | undefined;
+  yChannelSelector?: string | undefined;
+  z?: string | undefined;
+  zoomAndPan?: string | undefined;
+  [PropertyName: string]: boolean | number | string | null | undefined | Array<string | number>;
+}
+// ## Content maps
+/**
+ * Union of registered hast nodes that can occur in {@link Element}.
  *
- * Nothing here throws and nothing logs. An unknown name drops the whole
- * directive, an unknown key or value drops that pair only, and a directive with
- * no block after it does nothing at all (P3/D2/D6). The comment node is left
- * where it is: the sanitiser removes it, which is why no Vantage-specific
- * markup other than these attributes ever reaches the DOM.
+ * To register mote custom hast nodes, add them to {@link ElementContentMap}.
+ * They will be automatically added here.
  */
-
+type ElementContent = ElementContentMap[keyof ElementContentMap];
+/**
+ * Registry of all hast nodes that can occur as children of {@link Element}.
+ *
+ * For a union of all {@link Element} children, see {@link ElementContent}.
+ */
+interface ElementContentMap {
+  comment: Comment;
+  element: Element;
+  text: Text;
+}
+/**
+ * Union of registered hast nodes that can occur in {@link Root}.
+ *
+ * To register custom hast nodes, add them to {@link RootContentMap}.
+ * They will be automatically added here.
+ */
+type RootContent = RootContentMap[keyof RootContentMap];
+/**
+ * Registry of all hast nodes that can occur as children of {@link Root}.
+ *
+ * > 👉 **Note**: {@link Root} does not need to be an entire document.
+ * > it can also be a fragment.
+ *
+ * For a union of all {@link Root} children, see {@link RootContent}.
+ */
+interface RootContentMap {
+  comment: Comment;
+  doctype: Doctype;
+  element: Element;
+  text: Text;
+}
+// ## Abstract nodes
+/**
+ * Abstract hast node.
+ *
+ * This interface is supposed to be extended.
+ * If you can use {@link Literal} or {@link Parent}, you should.
+ * But for example in HTML, a `Doctype` is neither literal nor parent, but
+ * still a node.
+ *
+ * To register custom hast nodes, add them to {@link RootContentMap} and other
+ * places where relevant (such as {@link ElementContentMap}).
+ *
+ * For a union of all registered hast nodes, see {@link Nodes}.
+ */
+interface Node extends Node$1 {
+  /**
+   * Info from the ecosystem.
+   */
+  data?: Data | undefined;
+}
+/**
+ * Abstract hast node that contains the smallest possible value.
+ *
+ * This interface is supposed to be extended if you make custom hast nodes.
+ *
+ * For a union of all registered hast literals, see {@link Literals}.
+ */
+interface Literal extends Node {
+  /**
+   * Plain-text value.
+   */
+  value: string;
+}
+/**
+ * Abstract hast node that contains other hast nodes (*children*).
+ *
+ * This interface is supposed to be extended if you make custom hast nodes.
+ *
+ * For a union of all registered hast parents, see {@link Parents}.
+ */
+interface Parent extends Node {
+  /**
+   * List of children.
+   */
+  children: RootContent[];
+}
+// ## Concrete nodes
+/**
+ * HTML comment.
+ */
+interface Comment extends Literal {
+  /**
+   * Node type of HTML comments in hast.
+   */
+  type: "comment";
+  /**
+   * Data associated with the comment.
+   */
+  data?: CommentData | undefined;
+}
+/**
+ * Info associated with hast comments by the ecosystem.
+ */
+interface CommentData extends Data {}
+/**
+ * HTML document type.
+ */
+interface Doctype extends Node$1 {
+  /**
+   * Node type of HTML document types in hast.
+   */
+  type: "doctype";
+  /**
+   * Data associated with the doctype.
+   */
+  data?: DoctypeData | undefined;
+}
+/**
+ * Info associated with hast doctypes by the ecosystem.
+ */
+interface DoctypeData extends Data {}
+/**
+ * HTML element.
+ */
+interface Element extends Parent {
+  /**
+   * Node type of elements.
+   */
+  type: "element";
+  /**
+   * Tag name (such as `'body'`) of the element.
+   */
+  tagName: string;
+  /**
+   * Info associated with the element.
+   */
+  properties: Properties;
+  /**
+   * Children of element.
+   */
+  children: ElementContent[];
+  /**
+   * When the `tagName` field is `'template'`, a `content` field can be
+   * present.
+   */
+  content?: Root | undefined;
+  /**
+   * Data associated with the element.
+   */
+  data?: ElementData | undefined;
+}
+/**
+ * Info associated with hast elements by the ecosystem.
+ */
+interface ElementData extends Data {}
+/**
+ * Document fragment or a whole document.
+ *
+ * Should be used as the root of a tree and must not be used as a child.
+ *
+ * Can also be used as the value for the content field on a `'template'` element.
+ */
+interface Root extends Parent {
+  /**
+   * Node type of hast root.
+   */
+  type: "root";
+  /**
+   * Children of root.
+   */
+  children: RootContent[];
+  /**
+   * Data associated with the hast root.
+   */
+  data?: RootData | undefined;
+}
+/**
+ * Info associated with hast root nodes by the ecosystem.
+ */
+interface RootData extends Data {}
+/**
+ * HTML character data (plain text).
+ */
+interface Text extends Literal {
+  /**
+   * Node type of HTML character data (plain text) in hast.
+   */
+  type: "text";
+  /**
+   * Data associated with the text.
+   */
+  data?: TextData | undefined;
+}
+/**
+ * Info associated with hast texts by the ecosystem.
+ */
+interface TextData extends Data {}
+//#endregion
+//#region src/rehypeVantageAlerts.d.ts
+/**
+ * The five GFM alert kinds, lowercased.
+ *
+ * Deliberately *not* re-derived from `VANTAGE_TONES`: that list carries a sixth
+ * token, `muted`, which is ours and is not an alert word. The overlap is the
+ * point — the five that coincide share a palette — but the two vocabularies are
+ * closed by different authorities and a change to one must not silently move the
+ * other. A test asserts the five are a subset of the tones.
+ */
+declare const VANTAGE_ALERTS: readonly ["note", "tip", "important", "warning", "caution"];
+type VantageAlert = (typeof VANTAGE_ALERTS)[number];
+/** The visible label per kind. Title case, as GitHub renders it. */
+declare const ALERT_TITLES: Readonly<Record<VantageAlert, string>>;
+/**
+ * Compile `> [!KIND]` blockquotes into `data-vantage-alert="kind"`.
+ *
+ * Order in the chain matters twice, and both are stated in `pipeline.ts`:
+ *
+ * - **after `rehypeSourceLines`**, so the injected title carries no
+ *   `data-source-line`. That is what keeps it out of `anchorBlockWithin`, which
+ *   filters candidates to those with a finite line — otherwise a review comment
+ *   on an alert would anchor to the word "Warning" instead of to the prose.
+ * - **before `rehypeSanitize`**, so nothing reaches the DOM the schema has not
+ *   passed. `dataVantageAlert` is allowlisted there by name *and* value, like
+ *   every other `data-vantage-*` attribute.
+ */
+declare function rehypeVantageAlerts(): (tree: Root) => void;
+//#endregion
+//#region src/rehypeSourceLines.d.ts
+interface RehypeSourceLinesOptions {
+  /**
+   * Lines stripped off the front of the file before parsing — frontmatter,
+   * essentially. Added to every emitted line number so `data-source-line`
+   * names a line in the *file* rather than in the parsed body, which is what
+   * a `#L42` link written against the file means. Defaults to 0.
+   */
+  offset?: number;
+}
+declare const rehypeSourceLines: Plugin<[RehypeSourceLinesOptions?], Root>;
+//#endregion
+//#region src/rehypeVantageDirectives.d.ts
 declare const rehypeVantageDirectives: Plugin<[], Root>;
-
+//#endregion
+//#region src/vantageDirectives.d.ts
 /**
  * The directive grammar and the closed vocabulary — one parser, no renderer.
  *
@@ -196,31 +1147,31 @@ type DirectiveVocabulary = Readonly<Record<string, KeyTable | undefined>>;
  */
 declare const DIRECTIVE_VOCABULARY: DirectiveVocabulary;
 interface DirectivePair {
-    key: string;
-    /** The value with quotes stripped, if it was quoted. */
-    value: string;
-    /** Offset of `key` within the comment's inner text. */
-    keyOffset: number;
-    /** Offset of the value token — opening quote included — within it. */
-    valueOffset: number;
-    quoted: boolean;
+  key: string;
+  /** The value with quotes stripped, if it was quoted. */
+  value: string;
+  /** Offset of `key` within the comment's inner text. */
+  keyOffset: number;
+  /** Offset of the value token — opening quote included — within it. */
+  valueOffset: number;
+  quoted: boolean;
 }
 interface ParsedDirective {
-    kind: "directive";
-    name: string;
-    /** Offset of `name` within the comment's inner text. */
-    nameOffset: number;
-    /** In written order, duplicates included: a checker reports them, the
-     * renderer resolves them last-one-wins. */
-    pairs: DirectivePair[];
+  kind: "directive";
+  name: string;
+  /** Offset of `name` within the comment's inner text. */
+  nameOffset: number;
+  /** In written order, duplicates included: a checker reports them, the
+   * renderer resolves them last-one-wins. */
+  pairs: DirectivePair[];
 }
 /** Sentinel present, grammar not satisfied. The renderer ignores `reason`. */
 interface MalformedDirective {
-    kind: "malformed";
-    /** One clause a checker can quote verbatim, lowercase and unpunctuated. */
-    reason: string;
-    /** Offset of the first character the parse could not use. */
-    offset: number;
+  kind: "malformed";
+  /** One clause a checker can quote verbatim, lowercase and unpunctuated. */
+  reason: string;
+  /** Offset of the first character the parse could not use. */
+  offset: number;
 }
 type DirectiveParse = ParsedDirective | MalformedDirective | null;
 /**
@@ -240,60 +1191,30 @@ declare function hasVantageSentinel(comment: string): boolean;
  * point at the character that broke.
  */
 declare function parseVantageDirective(comment: string): DirectiveParse;
-
-/**
- * The one definition of the Vantage remark/rehype chain.
- *
- * Three call sites render Markdown — `renderMarkdown` (string in, HTML out,
- * which is what the CLI checker runs), the app's `<MarkdownViewer>`, and this
- * package's exported `<MarkdownViewer>` — and each one used to hand-write the
- * same plugin list in the same order. Three copies kept in sync by hand is how
- * a plugin lands in the viewer and not in the checker: a document that styles
- * in the app and renders bare through the tool that is supposed to validate it,
- * with no error anywhere.
- *
- * The order is load-bearing, not incidental:
- *
- * - `rehypeRaw` first: `remark-rehype` runs with `allowDangerousHtml: true`,
- *   so raw HTML is still a string until this plugin parses it.
- * - `rehypeSourceLines` before `rehypeSanitize`: `data-source-line` has to be
- *   an allowlisted attribute on an element the sanitiser keeps.
- * - `rehypeSlug`, `rehypeHighlight` and `rehypeKatex` after `rehypeSanitize`.
- *   For `rehypeSlug` this is not a preference: the sanitiser's default schema
- *   clobbers `id` with the prefix `user-content-`, so slugging before it turns
- *   every `#heading` link in every document into a dead anchor. For the other
- *   two it means their output is trusted rather than filtered — KaTeX emits
- *   inline `style` on nearly every glyph.
- *
- * Anything that reads HTML comments must sit between `rehypeRaw` and
- * `rehypeSanitize`: before `rehypeRaw` there are no comment nodes, and
- * `rehypeSanitize` deletes them. `rehypeVantageDirectives` is what occupies
- * that slot, and it is registered unconditionally — a renderer that skipped it
- * would disagree with the others about what a document means.
- */
-
+//#endregion
+//#region src/pipeline.d.ts
 interface PipelineOptions {
-    /** GFM tables, strikethrough, task lists (default: true) */
-    gfm?: boolean;
-    /** KaTeX math, `$$…$$` only (default: true) */
-    math?: boolean;
-    /** Syntax highlighting via highlight.js (default: true) */
-    highlight?: boolean;
-    /** `data-source-line` attributes for line anchors (default: true) */
-    sourceLines?: boolean;
-    /** XSS sanitisation (default: true) */
-    sanitize?: boolean;
-    /**
-     * Lines the frontmatter consumed, added to every emitted line number so
-     * `data-source-line` names a line in the *file* rather than in the parsed
-     * body — which is what a `#L42` link written against the file means.
-     * Defaults to 0. Ignored when `sourceLines` is false.
-     */
-    bodyLineOffset?: number;
+  /** GFM tables, strikethrough, task lists (default: true) */
+  gfm?: boolean;
+  /** KaTeX math, `$$…$$` only (default: true) */
+  math?: boolean;
+  /** Syntax highlighting via highlight.js (default: true) */
+  highlight?: boolean;
+  /** `data-source-line` attributes for line anchors (default: true) */
+  sourceLines?: boolean;
+  /** XSS sanitisation (default: true) */
+  sanitize?: boolean;
+  /**
+   * Lines the frontmatter consumed, added to every emitted line number so
+   * `data-source-line` names a line in the *file* rather than in the parsed
+   * body — which is what a `#L42` link written against the file means.
+   * Defaults to 0. Ignored when `sourceLines` is false.
+   */
+  bodyLineOffset?: number;
 }
 interface Pipeline {
-    remarkPlugins: PluggableList;
-    rehypePlugins: PluggableList;
+  remarkPlugins: PluggableList;
+  rehypePlugins: PluggableList;
 }
 /**
  * The mdast half of the chain. Exported on its own because there is a real
@@ -315,7 +1236,8 @@ declare function buildRemarkPlugins(options?: PipelineOptions): PluggableList;
  * the chain has been built.
  */
 declare function buildPipeline(options?: PipelineOptions): Pipeline;
-
+//#endregion
+//#region src/scrollToLineAnchor.d.ts
 /**
  * Framework-agnostic line anchor utilities.
  * Scroll to and highlight the elements a GitHub-style line anchor
@@ -334,7 +1256,8 @@ declare function clearLineAnchorHighlights(container: HTMLElement): void;
  * @returns A cleanup function that removes the highlights
  */
 declare function scrollToLineAnchor(container: HTMLElement, hash: string): (() => void) | null;
-
+//#endregion
+//#region src/lineAnchor.d.ts
 /**
  * Parsing for GitHub-style line anchors, with no DOM in sight.
  *
@@ -349,10 +1272,11 @@ declare function scrollToLineAnchor(container: HTMLElement, hash: string): (() =
  * Returns null if the hash is not a line anchor.
  */
 declare function parseLineAnchor(hash: string): {
-    start: number;
-    end: number;
+  start: number;
+  end: number;
 } | null;
-
+//#endregion
+//#region src/frontmatter.d.ts
 /**
  * Frontmatter parser for YAML (---) and TOML (+++) delimited content.
  * Works in both browser and server environments.
@@ -374,61 +1298,41 @@ type FrontmatterFormat = "yaml" | "toml" | "none";
  *   of fields, which is not something a metadata card can render.
  */
 interface FrontmatterProblem {
-    kind: "unterminated" | "invalid" | "not-a-mapping";
-    /** The delimiter the document opened with. */
-    delimiter: string;
-    message?: string;
-    line?: number;
-    column?: number;
+  kind: "unterminated" | "invalid" | "not-a-mapping";
+  /** The delimiter the document opened with. */
+  delimiter: string;
+  message?: string;
+  line?: number;
+  column?: number;
 }
 interface ParsedFrontmatter {
-    frontmatter: Record<string, unknown>;
-    body: string;
-    format: FrontmatterFormat;
-    /**
-     * How many source lines the frontmatter block consumed — the shift between a
-     * line number in `body` and the same line in the original file:
-     * `fileLine = bodyLine + bodyLineOffset`.
-     *
-     * Anything that renders `body` and reports line numbers (line anchors, review
-     * comment anchors) has to add this back, or every number it produces points
-     * `bodyLineOffset` lines short of the text it names.
-     */
-    bodyLineOffset: number;
-    /**
-     * Set when the document opens with a frontmatter delimiter that did not
-     * yield a metadata table. Everything else in this result is unchanged —
-     * this records *why*, it does not change what rendering does.
-     */
-    problem?: FrontmatterProblem;
+  frontmatter: Record<string, unknown>;
+  body: string;
+  format: FrontmatterFormat;
+  /**
+   * How many source lines the frontmatter block consumed — the shift between a
+   * line number in `body` and the same line in the original file:
+   * `fileLine = bodyLine + bodyLineOffset`.
+   *
+   * Anything that renders `body` and reports line numbers (line anchors, review
+   * comment anchors) has to add this back, or every number it produces points
+   * `bodyLineOffset` lines short of the text it names.
+   */
+  bodyLineOffset: number;
+  /**
+   * Set when the document opens with a frontmatter delimiter that did not
+   * yield a metadata table. Everything else in this result is unchanged —
+   * this records *why*, it does not change what rendering does.
+   */
+  problem?: FrontmatterProblem;
 }
 /**
  * Parse frontmatter from markdown content.
  * Supports YAML (delimited by ---) and TOML (delimited by +++).
  */
 declare function parseFrontmatter(content: string): ParsedFrontmatter;
-
-/**
- * The `vantage:` frontmatter key — file-scoped chrome (`docs/reference/inline-markup.md`, "File-scoped chrome").
- *
- * One reserved key at the top level of a document's frontmatter, holding the
- * chrome that belongs to the *file* rather than to a section. Today that is one
- * thing: whether the document's lifecycle `status:` is shown as a chip above the
- * metadata card, instead of being buried as one row inside it.
- *
- * Read only at the top level, and **inert on every failure** (P3): an unknown
- * key, a value outside the closed set, or a `vantage:` that is not a table
- * produces no chrome, no throw and no console output. The reasons are returned
- * as data in `issues`, for anything that wants to report them — `vantage-check`
- * does, and it is the only signal an author gets. That split is exactly the one
- * `FrontmatterProblem` already uses in `frontmatter.ts`: the viewer reads the
- * value, the checker reads the reasons.
- *
- * Like `vantageDirectives.ts`, this module is imported by the CLI checker **by
- * relative path**, so it must stay a pure function of already-parsed data: no
- * hast, no React, no filesystem.
- */
-
+//#endregion
+//#region src/vantageFrontmatter.d.ts
 /**
  * The document lifecycle vocabulary. Closed; extending it is a code change.
  *
@@ -462,29 +1366,29 @@ declare const DOC_STATUS_TONES: Readonly<Record<DocStatus, (typeof VANTAGE_TONES
  * says something the document's own `status:` does not.
  */
 type VantageFrontmatterIssue = {
-    kind: "not-a-table";
-    value: unknown;
+  kind: "not-a-table";
+  value: unknown;
 } | {
-    kind: "unknown-key";
-    key: string;
+  kind: "unknown-key";
+  key: string;
 } | {
-    kind: "bad-value";
-    key: string;
-    value: unknown;
-    legal: readonly string[];
+  kind: "bad-value";
+  key: string;
+  value: unknown;
+  legal: readonly string[];
 } | {
-    kind: "status-chip-orphan";
-    status: unknown;
+  kind: "status-chip-orphan";
+  status: unknown;
 } | {
-    kind: "status-chip-disagrees";
-    chip: DocStatus;
-    status: unknown;
+  kind: "status-chip-disagrees";
+  chip: DocStatus;
+  status: unknown;
 };
 interface VantageFrontmatter {
-    /** The chip's text, or `undefined` for no chip. */
-    statusChip?: DocStatus;
-    /** Why something was dropped. A viewer must never read this (P3). */
-    issues: VantageFrontmatterIssue[];
+  /** The chip's text, or `undefined` for no chip. */
+  statusChip?: DocStatus;
+  /** Why something was dropped. A viewer must never read this (P3). */
+  issues: VantageFrontmatterIssue[];
 }
 /** Narrowing helper the chip and the checker both use. */
 declare function isDocStatus(value: unknown): value is DocStatus;
@@ -495,13 +1399,8 @@ declare function isDocStatus(value: unknown): value is DocStatus;
  * in twice gives equal results out.
  */
 declare function readVantageFrontmatter(frontmatter: Record<string, unknown>): VantageFrontmatter;
-
-/**
- * Sanitization schema for the rendering pipeline.
- * Allows GFM, KaTeX MathML, syntax highlighting classes, and
- * data-source-line attributes while blocking XSS vectors.
- */
-
+//#endregion
+//#region src/sanitize.d.ts
 type Schema = typeof defaultSchema;
 declare const SAFE_STYLE: RegExp;
 /**
@@ -517,7 +1416,8 @@ declare const SAFE_STYLE: RegExp;
  * markup") is the guard.
  */
 declare const sanitizeSchema: Schema;
-
+//#endregion
+//#region src/renderMermaidBlocks.d.ts
 /**
  * Client-side utility to find and render mermaid code blocks in a container.
  *
@@ -528,10 +1428,10 @@ declare const sanitizeSchema: Schema;
  * Framework-agnostic — works in any browser environment.
  */
 interface RenderMermaidOptions {
-    /** CSS class to add to the SVG wrapper div (default: "mermaid") */
-    className?: string;
-    /** Called when a diagram fails to render */
-    onError?: (code: string, error: Error) => void;
+  /** CSS class to add to the SVG wrapper div (default: "mermaid") */
+  className?: string;
+  /** Called when a diagram fails to render */
+  onError?: (code: string, error: Error) => void;
 }
 /**
  * Find all `<pre><code class="language-mermaid">` blocks in a container
@@ -551,7 +1451,8 @@ interface RenderMermaidOptions {
  * ```
  */
 declare function renderMermaidBlocks(container: HTMLElement, options?: RenderMermaidOptions): Promise<void>;
-
+//#endregion
+//#region src/resolveLinks.d.ts
 /**
  * Rewrite relative links in rendered markdown HTML.
  *
@@ -560,16 +1461,16 @@ declare function renderMermaidBlocks(container: HTMLElement, options?: RenderMer
  * without requiring a DOM — it operates on the HTML string directly.
  */
 interface ResolveLinkOptions {
-    /** Base path to prepend to relative links (default: "/") */
-    basePath?: string;
-    /**
-     * Custom rewriter function. Called for every relative href.
-     * Return the rewritten href, or null to leave it unchanged.
-     * If provided, basePath is ignored.
-     */
-    rewriter?: (href: string, currentPath: string) => string | null;
-    /** Current file path — used to resolve relative references like `./other.md` */
-    currentPath?: string;
+  /** Base path to prepend to relative links (default: "/") */
+  basePath?: string;
+  /**
+   * Custom rewriter function. Called for every relative href.
+   * Return the rewritten href, or null to leave it unchanged.
+   * If provided, basePath is ignored.
+   */
+  rewriter?: (href: string, currentPath: string) => string | null;
+  /** Current file path — used to resolve relative references like `./other.md` */
+  currentPath?: string;
 }
 /**
  * Rewrite relative links in rendered HTML.
@@ -596,7 +1497,8 @@ interface ResolveLinkOptions {
  * ```
  */
 declare function resolveLinks(html: string, options?: ResolveLinkOptions): string;
-
+//#endregion
+//#region src/styleGuide.d.ts
 /**
  * The canonical Vantage Markdown style guide.
  *
@@ -611,6 +1513,7 @@ declare function resolveLinks(html: string, options?: ResolveLinkOptions): strin
  * Every rule stated here should be one a checker can enforce or a renderer
  * actually cares about — if a line is neither, it does not belong.
  */
-declare const STYLE_GUIDE = "## Markdown style guide (for Vantage viewer)\n\nWhen writing or updating markdown documents that will be viewed in Vantage, follow these conventions:\n\n### Structure\n- Use headings (## and ###) to organize content \u2014 they become navigable outline anchors.\n- Keep paragraphs focused and concise. Break up dense text with subheadings, lists, or tables.\n\n### Links and cross-references\n- **Relative paths only**: Always link relative to the *current file's directory*:\n  - Sibling in same folder: `[Other Doc](./other-doc.md)` or `[Other Doc](other-doc.md)`\n  - Subdirectory: `[Design Doc](./design/auth.md)`\n  - Parent / sibling folder: `[Overview](../overview.md)` or `[Spec](../specs/api.md)`\n- **Never use leading slashes**:\n  - \u274C `[Doc](/docs/guide.md)` (breaks web routing and multi-repo scoping)\n  - \u2705 `[Doc](../docs/guide.md)` or `[Doc](./guide.md)`\n- **Never use absolute filesystem paths or URI schemes**:\n  - \u274C `file:///workspace/docs/guide.md`, `/workspace/docs/guide.md`, `C:\\...`\n  - \u2705 `[Doc](./guide.md)` or `[Doc](../guide.md)`\n- **Always include the file extension**: Use `.md`, `.ts`, `.go`, etc. (e.g. `[Model](model.go)`).\n- **Line anchors and ranges**:\n  - Link to specific lines: `[Handler](../server/api.go#L42)` or `[Range](../server/api.go#L42-L58)`\n  - Same-file line anchor: `[See lines](#L10-L25)`\n  - Vantage scrolls to and highlights the target lines.\n- **Section anchors**:\n  - Same doc: `[Usage](#usage)`\n  - Cross-doc: `[Architecture](../overview.md#system-architecture)`\n  - Anchor slugs are lowercase, hyphenated, and punctuation-stripped.\n- **Backticks in links**: Place backticks inside the link label, not around the markdown link syntax:\n  - \u2705 `[`config.json`](./config.json)` or `[config.json](./config.json)`\n  - \u274C ``[config.json](./config.json)``\n\n### Frontmatter (Metadata)\n- Include structured metadata at the very top of docs delimited by `---` (YAML) or `+++` (TOML). Vantage renders this as a metadata card:\n```yaml\n---\ntitle: \"Feature Specification\"\nauthor: \"Agent\"\ndate: 2026-08-15\nstatus: in-review # draft | in-review | accepted | deprecated\ntags: [architecture, backend, api]\nsummary: \"Brief description of the document purpose.\"\nvantage:\n  status-chip: true # show `status` as a chip above the metadata card\n---\n```\n- **Nothing may sit above the opening delimiter** \u2014 not a blank line, not an editorial comment, not a `<!-- vantage: \u2026 -->` directive. Frontmatter is recognised only at the very first byte of the file (in Vantage, on GitHub, and in every other reader), so one line above it turns the whole block into body text: a horizontal rule followed by a heading made of the raw keys, with every field lost. `vantage-check` reports it as `frontmatter/not-at-top`.\n- **`vantage:` is Vantage's own reserved key.** It holds chrome that belongs to the file rather than to a section, it never shows up in the metadata card, and every other renderer ignores it. One key today: `status-chip`.\n- **Prefer `status-chip: true`**, which shows the document's own `status:` and therefore cannot disagree with it. A literal `status-chip: accepted` is accepted too, but it is a second value that goes stale on its own \u2014 `vantage-check` reports the disagreement.\n- The chip's vocabulary is `status`'s, exactly: `draft | in-review | accepted | deprecated`, lowercase. `Draft` renders no chip at all, silently.\n\n### Mermaid diagrams\n- Use ```mermaid code blocks for flowcharts, sequence diagrams, and architecture diagrams. Vantage provides interactive zoom, pan, dark/light theme adaptation, and SVG export.\n- **Quote labels with special characters**: Always quote node labels containing parentheses, brackets, or colons to prevent syntax errors:\n```mermaid\nflowchart TD\n    client[\"Client (React SPA)\"] -->|WebSocket| srv[\"Vantage Server (Go)\"]\n    srv --> git[\"Git CLI (git diff)\"]\n```\n\n### Code blocks and diffs\n- Always tag fenced code blocks with language identifiers (`ts`, `go`, `python`, `bash`, `json`, `yaml`, `diff`, `sql`, etc.) for syntax highlighting.\n- For proposed code modifications, use ```diff blocks with `+` and `-` prefixes:\n```diff\n-const oldUrl = \"/api/v1\";\n+const newUrl = \"/api/v2\";\n```\n\n### Callouts and alerts\n- Use GitHub-style blockquote callouts for notes, tips, and warnings:\n> [!NOTE]\n> Background context or helpful explanation.\n\n> [!TIP]\n> Best practice advice or optimization suggestions.\n\n> [!IMPORTANT]\n> Key requirements or crucial information.\n\n> [!WARNING]\n> Urgent caution, breaking changes, or potential pitfalls.\n\n> [!CAUTION]\n> High-risk actions that could cause data loss or security issues.\n\n### Vantage directives (optional, and Vantage-only)\n\nVantage reads a few styling hints from ordinary HTML comments. Every other renderer \u2014 GitHub included \u2014 drops them, so a document has to read exactly the same without them: directives decorate, they never carry meaning. One goes on a line of its own, with a blank line after it, and applies to the block that follows:\n\n```markdown\n<!-- vantage: section tone=warning badge=stale -->\n\n## Migration path\n\nThe steps below predate the rewrite.\n```\n\n- **Three names**: `section` (the heading and everything under it), `block` (the one block after it), `oq` (one answerable Open Question).\n- **The keys and values are a closed set**: `tone` = `note | tip | important | warning | caution | muted`; `emphasis` = `strong | normal | quiet`; `badge` = `draft | stale | blocked | done | wip`; `collapsed` = `true | false`. Name a *tone*, never a colour \u2014 the theme decides what a warning looks like, in light mode, in dark mode, and in print.\n- **Use them sparingly.** One or two per document, on the sections that genuinely differ. A document where everything is toned says nothing, and a rainbow one is harder to read than a plain one.\n- **Anything outside those sets is silently ignored** \u2014 nothing breaks, and nothing styles either. Run `vantage-check` on the document: the `vantage/*` rules are the only thing that will ever tell you a directive did nothing.\n- **Always close the comment with `-->`.** Never `--!>`, and never leave it open: Markdown reads every line below an unclosed `<!--` as part of the comment, and the whole rest of the document vanishes from the page. For the same reason `-->` cannot appear *inside* a value \u2014 it ends the comment early and spills the remainder into the page as literal text.\n- **In a list, indent the directive inside the item**, with blank lines around it (below). At the start of a line between two items it ends the list and starts a second one, which changes the numbering and the spacing in every renderer \u2014 the one thing a directive must never do.\n- **A `leaning` restates the leaning; it is never \"yes\".** The one-click button in review mode files that text as a review comment, and the comment is all the agent reading it has \u2014 nobody remembers which button was clicked. `leaning=\"Yes\"` beside a two-branch question is a support ticket.\n\n```markdown\n1. **OQ-9: Queue position on re-entry.**\n\n   <!-- vantage: oq id=OQ-9 leaning=\"Back of the queue \u2014 the fix might interact with what merged while it was out.\" -->\n\n   _Leaning:_ Back of the queue.\n```\n\n### Tables, task lists, and math\n- **Tables**: Use standard markdown tables for structured comparisons and schemas.\n- **Task lists**: Use `- [ ]` and `- [x]` for actionable checklists and status tracking.\n- **LaTeX Math**: Use `$$...$$` for *all* KaTeX math \u2014 display blocks (`$$` alone on its own lines) and inline alike (`$$E = mc^2$$` mid-sentence).\n  - Single dollars are **not** math delimiters: `$HOME` and `$100` stay literal, so prose and shell snippets are safe to write as-is.\n";
-
-export { DIRECTIVE_NAMES, DIRECTIVE_VOCABULARY, DOC_STATUSES, DOC_STATUS_TONES, type DirectivePair, type DirectiveParse, type DirectiveVocabulary, type DocStatus, type FrontmatterFormat, type FrontmatterProblem, type KeyTable, type KeyVocabulary, type MalformedDirective, type ParsedDirective, type ParsedFrontmatter, type Pipeline, type PipelineOptions, type RenderMermaidOptions, type RenderOptions, type RenderResult, type ResolveLinkOptions, SAFE_STYLE, STYLE_GUIDE, VANTAGE_BADGES, VANTAGE_COLLAPSED, VANTAGE_EMPHASIS, VANTAGE_FRONTMATTER_KEYS, VANTAGE_OQ_HOST_TARGETS, VANTAGE_RUNS, VANTAGE_SENTINEL, VANTAGE_TONES, type VantageFrontmatter, type VantageFrontmatterIssue, buildPipeline, buildRemarkPlugins, clearLineAnchorHighlights, hasVantageSentinel, isDocStatus, parseFrontmatter, parseLineAnchor, parseVantageDirective, readVantageFrontmatter, rehypeSourceLines, rehypeVantageDirectives, renderMarkdown, renderMermaidBlocks, resolveLinks, sanitizeSchema, scrollToLineAnchor };
+declare const STYLE_GUIDE = "## Markdown style guide (for Vantage viewer)\n\nWhen writing or updating markdown documents that will be viewed in Vantage, follow these conventions:\n\n### Structure\n- Use headings (## and ###) to organize content — they become navigable outline anchors.\n- Keep paragraphs focused and concise. Break up dense text with subheadings, lists, or tables.\n\n### Links and cross-references\n- **Relative paths only**: Always link relative to the *current file's directory*:\n  - Sibling in same folder: `[Other Doc](./other-doc.md)` or `[Other Doc](other-doc.md)`\n  - Subdirectory: `[Design Doc](./design/auth.md)`\n  - Parent / sibling folder: `[Overview](../overview.md)` or `[Spec](../specs/api.md)`\n- **Never use leading slashes**:\n  - ❌ `[Doc](/docs/guide.md)` (breaks web routing and multi-repo scoping)\n  - ✅ `[Doc](../docs/guide.md)` or `[Doc](./guide.md)`\n- **Never use absolute filesystem paths or URI schemes**:\n  - ❌ `file:///workspace/docs/guide.md`, `/workspace/docs/guide.md`, `C:\\...`\n  - ✅ `[Doc](./guide.md)` or `[Doc](../guide.md)`\n- **Always include the file extension**: Use `.md`, `.ts`, `.go`, etc. (e.g. `[Model](model.go)`).\n- **Line anchors and ranges**:\n  - Link to specific lines: `[Handler](../server/api.go#L42)` or `[Range](../server/api.go#L42-L58)`\n  - Same-file line anchor: `[See lines](#L10-L25)`\n  - Vantage scrolls to and highlights the target lines.\n- **Section anchors**:\n  - Same doc: `[Usage](#usage)`\n  - Cross-doc: `[Architecture](../overview.md#system-architecture)`\n  - Anchor slugs are lowercase, hyphenated, and punctuation-stripped.\n- **Backticks in links**: Place backticks inside the link label, not around the markdown link syntax:\n  - ✅ `[`config.json`](./config.json)` or `[config.json](./config.json)`\n  - ❌ ``[config.json](./config.json)``\n\n### Frontmatter (Metadata)\n- Include structured metadata at the very top of docs delimited by `---` (YAML) or `+++` (TOML). Vantage renders this as a metadata card:\n```yaml\n---\ntitle: \"Feature Specification\"\nauthor: \"Agent\"\ndate: 2026-08-15\nstatus: in-review # draft | in-review | accepted | deprecated\ntags: [architecture, backend, api]\nsummary: \"Brief description of the document purpose.\"\nvantage:\n  status-chip: true # show `status` as a chip above the metadata card\n---\n```\n- **Nothing may sit above the opening delimiter** — not a blank line, not an editorial comment, not a `<!-- vantage: … -->` directive. Frontmatter is recognised only at the very first byte of the file (in Vantage, on GitHub, and in every other reader), so one line above it turns the whole block into body text: a horizontal rule followed by a heading made of the raw keys, with every field lost. `vantage-check` reports it as `frontmatter/not-at-top`.\n- **`vantage:` is Vantage's own reserved key.** It holds chrome that belongs to the file rather than to a section, it never shows up in the metadata card, and every other renderer ignores it. One key today: `status-chip`.\n- **Prefer `status-chip: true`**, which shows the document's own `status:` and therefore cannot disagree with it. A literal `status-chip: accepted` is accepted too, but it is a second value that goes stale on its own — `vantage-check` reports the disagreement.\n- The chip's vocabulary is `status`'s, exactly: `draft | in-review | accepted | deprecated`, lowercase. `Draft` renders no chip at all, silently.\n\n### Mermaid diagrams\n- Use ```mermaid code blocks for flowcharts, sequence diagrams, and architecture diagrams. Vantage provides interactive zoom, pan, dark/light theme adaptation, and SVG export.\n- **Quote labels with special characters**: Always quote node labels containing parentheses, brackets, or colons to prevent syntax errors:\n```mermaid\nflowchart TD\n    client[\"Client (React SPA)\"] -->|WebSocket| srv[\"Vantage Server (Go)\"]\n    srv --> git[\"Git CLI (git diff)\"]\n```\n\n### Code blocks and diffs\n- Always tag fenced code blocks with language identifiers (`ts`, `go`, `python`, `bash`, `json`, `yaml`, `diff`, `sql`, etc.) for syntax highlighting.\n- For proposed code modifications, use ```diff blocks with `+` and `-` prefixes:\n```diff\n-const oldUrl = \"/api/v1\";\n+const newUrl = \"/api/v2\";\n```\n\n### Callouts and alerts\n- Use GitHub-style blockquote callouts for notes, tips, and warnings:\n> [!NOTE]\n> Background context or helpful explanation.\n\n> [!TIP]\n> Best practice advice or optimization suggestions.\n\n> [!IMPORTANT]\n> Key requirements or crucial information.\n\n> [!WARNING]\n> Urgent caution, breaking changes, or potential pitfalls.\n\n> [!CAUTION]\n> High-risk actions that could cause data loss or security issues.\n\n### Vantage directives (optional, and Vantage-only)\n\nVantage reads a few styling hints from ordinary HTML comments. Every other renderer — GitHub included — drops them, so a document has to read exactly the same without them: directives decorate, they never carry meaning. One goes on a line of its own, with a blank line after it, and applies to the block that follows:\n\n```markdown\n<!-- vantage: section tone=warning badge=stale -->\n\n## Migration path\n\nThe steps below predate the rewrite.\n```\n\n- **Three names**: `section` (the heading and everything under it), `block` (the one block after it), `oq` (one answerable Open Question).\n- **The keys and values are a closed set**: `tone` = `note | tip | important | warning | caution | muted`; `emphasis` = `strong | normal | quiet`; `badge` = `draft | stale | blocked | done | wip`; `collapsed` = `true | false`. Name a *tone*, never a colour — the theme decides what a warning looks like, in light mode, in dark mode, and in print.\n- **Use them sparingly.** One or two per document, on the sections that genuinely differ. A document where everything is toned says nothing, and a rainbow one is harder to read than a plain one.\n- **Anything outside those sets is silently ignored** — nothing breaks, and nothing styles either. Run `vantage-check` on the document: the `vantage/*` rules are the only thing that will ever tell you a directive did nothing.\n- **Always close the comment with `-->`.** Never `--!>`, and never leave it open: Markdown reads every line below an unclosed `<!--` as part of the comment, and the whole rest of the document vanishes from the page. For the same reason `-->` cannot appear *inside* a value — it ends the comment early and spills the remainder into the page as literal text.\n- **In a list, indent the directive inside the item**, with blank lines around it (below). At the start of a line between two items it ends the list and starts a second one, which changes the numbering and the spacing in every renderer — the one thing a directive must never do.\n- **Every open question (💬) with a stated leaning gets an `oq` directive.** The convention's prose — the emoji, the `OQ-N` id, the `_Leaning:_` line, the fill-in `**Answer:**` — produces no button on its own. Writing the convention and stopping there is the most common way this feature goes missing: the questions look complete, review mode is on, and there is nothing to click. **`vantage-check` reports it as an error** (`vantage/oq-missing`), because a question awaiting a ruling that the reviewer cannot file is not a style preference. Mark it 🔒 if it is blocked on something upstream and cannot be answered yet, or ✅ once it is decided; either state needs no directive.\n- **A `leaning` restates the leaning; it is never \"yes\".** The one-click button in review mode files that text as a review comment, and the comment is all the agent reading it has — nobody remembers which button was clicked. `leaning=\"Yes\"` beside a two-branch question is a support ticket.\n\n```markdown\n1. **OQ-9: Queue position on re-entry.**\n\n   <!-- vantage: oq id=OQ-9 leaning=\"Back of the queue — the fix might interact with what merged while it was out.\" -->\n\n   _Leaning:_ Back of the queue.\n```\n\n### Tables, task lists, and math\n- **Tables**: Use standard markdown tables for structured comparisons and schemas.\n- **Task lists**: Use `- [ ]` and `- [x]` for actionable checklists and status tracking.\n- **LaTeX Math**: Use `$$...$$` for *all* KaTeX math — display blocks (`$$` alone on its own lines) and inline alike (`$$E = mc^2$$` mid-sentence).\n  - Single dollars are **not** math delimiters: `$HOME` and `$100` stay literal, so prose and shell snippets are safe to write as-is.\n";
+//#endregion
+export { ALERT_TITLES, DIRECTIVE_NAMES, DIRECTIVE_VOCABULARY, DOC_STATUSES, DOC_STATUS_TONES, type DirectivePair, type DirectiveParse, type DirectiveVocabulary, type DocStatus, type FrontmatterFormat, type FrontmatterProblem, type KeyTable, type KeyVocabulary, type MalformedDirective, type ParsedDirective, type ParsedFrontmatter, type Pipeline, type PipelineOptions, type RenderMermaidOptions, type RenderOptions, type RenderResult, type ResolveLinkOptions, SAFE_STYLE, STYLE_GUIDE, VANTAGE_ALERTS, VANTAGE_BADGES, VANTAGE_COLLAPSED, VANTAGE_EMPHASIS, VANTAGE_FRONTMATTER_KEYS, VANTAGE_OQ_HOST_TARGETS, VANTAGE_RUNS, VANTAGE_SENTINEL, VANTAGE_TONES, type VantageAlert, type VantageFrontmatter, type VantageFrontmatterIssue, buildPipeline, buildRemarkPlugins, clearLineAnchorHighlights, hasVantageSentinel, isDocStatus, parseFrontmatter, parseLineAnchor, parseVantageDirective, readVantageFrontmatter, rehypeSourceLines, rehypeVantageAlerts, rehypeVantageDirectives, renderMarkdown, renderMermaidBlocks, resolveLinks, sanitizeSchema, scrollToLineAnchor };
+//# sourceMappingURL=index.d.cts.map