@nuucognition/ncm-ui 0.1.0-dev.1

package/dist/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { cn } from './utils.js';
+import 'clsx';

package/dist/lib/index.js

@@ -0,0 +1,10 @@
+"use client";
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+// src/lib/utils.ts
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+export { cn };

package/dist/lib/katex.d.ts

@@ -0,0 +1,3 @@
+declare function useKatexHtml(content: string, displayMode: boolean, enabled?: boolean): string | null;
+
+export { useKatexHtml };

package/dist/lib/katex.js

@@ -0,0 +1,45 @@
+"use client";
+import { useState, useEffect, useMemo } from 'react';
+
+var katexPromise = null;
+function loadKatex() {
+  if (!katexPromise) {
+    katexPromise = Promise.all([
+      import('katex'),
+      import('katex/dist/katex.min.css')
+    ]).then(([module]) => module.default).catch(() => null);
+  }
+  return katexPromise;
+}
+function useKatexHtml(content, displayMode, enabled = true) {
+  const [katexModule, setKatexModule] = useState(null);
+  useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+    let active = true;
+    loadKatex().then((loaded) => {
+      if (active) {
+        setKatexModule(loaded);
+      }
+    });
+    return () => {
+      active = false;
+    };
+  }, [enabled]);
+  return useMemo(() => {
+    if (!enabled || !katexModule) {
+      return null;
+    }
+    try {
+      return katexModule.renderToString(content, {
+        throwOnError: false,
+        displayMode
+      });
+    } catch {
+      return null;
+    }
+  }, [content, displayMode, enabled, katexModule]);
+}
+
+export { useKatexHtml };

package/dist/lib/utils.d.ts

@@ -0,0 +1,8 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * Merge Tailwind CSS classes with clsx
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+export { cn };

package/dist/lib/utils.js

@@ -0,0 +1,10 @@
+"use client";
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+// src/lib/utils.ts
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+export { cn };

package/dist/references-Bs5wJybr.d.ts

@@ -0,0 +1,63 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { Block } from '@nuucognition/ncm';
+
+/**
+ * Document-order numbering for inline references (`^[ref: ...]` /
+ * `^[footnote: ...]`).
+ *
+ * The two kinds are counted **independently**: refs produce `[1] [2] …` and
+ * footnotes produce `¹ ² …`, each with its own running counter across the
+ * whole document.
+ *
+ * Numbering is computed from the `blocks` array — a pure pre-pass that does not
+ * depend on React render order — so markers stay stable even if a host
+ * virtualises blocks or renders them out of order. The pre-pass yields, per
+ * block, the count of each kind in all *preceding* blocks (the "base"); within
+ * a block, a `BlockReferenceScope` hands out sequential numbers in render
+ * order. Only the within-block step relies on the block's inline content
+ * rendering as a synchronous subtree (it always does).
+ */
+type ReferenceKind = "ref" | "footnote";
+interface ReferenceCounts {
+    ref: number;
+    footnote: number;
+}
+/**
+ * Map each block id to the number of refs/footnotes that precede it in
+ * document order — the starting offset for that block's own markers.
+ */
+declare function computeReferenceBases(blocks: readonly Block[]): Map<string, ReferenceCounts>;
+interface BlockReferenceScopeValue {
+    /** Allocate the next document-order number for `kind` within this block. */
+    next(kind: ReferenceKind): number;
+}
+interface NcmReferencesProviderProps {
+    blocks: readonly Block[];
+    children: ReactNode;
+}
+/** Document-root provider — runs the numbering pre-pass over `blocks`. */
+declare function NcmReferencesProvider({ blocks, children }: NcmReferencesProviderProps): react_jsx_runtime.JSX.Element;
+interface BlockReferenceScopeProps {
+    /** Block id; resolves the base offset from the document pre-pass. */
+    blockId?: string;
+    children: ReactNode;
+}
+/**
+ * Per-block numbering scope. Seeds a fresh counter from the block's base offset
+ * on every render and hands out sequential numbers as markers render. Resetting
+ * each render keeps numbering idempotent under React re-renders / StrictMode.
+ */
+declare function BlockReferenceScope({ blockId, children }: BlockReferenceScopeProps): react_jsx_runtime.JSX.Element;
+/** Read the active per-block reference scope, if any. */
+declare function useBlockReferenceScope(): BlockReferenceScopeValue | null;
+/**
+ * Wrap a subtree so any inline references inside it do NOT allocate
+ * document-order numbers — used for a reference's own popover content, which
+ * the numbering pre-pass deliberately does not descend into.
+ */
+declare function InertReferenceScope({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+export { BlockReferenceScope as B, InertReferenceScope as I, NcmReferencesProvider as N, type ReferenceCounts as R, type BlockReferenceScopeProps as a, type BlockReferenceScopeValue as b, type NcmReferencesProviderProps as c, type ReferenceKind as d, computeReferenceBases as e, useBlockReferenceScope as u };

package/dist/renderers-C5f41FCy.d.ts

@@ -0,0 +1,99 @@
+import { ComponentType } from 'react';
+import { Block, ParagraphBlock, HeaderBlock, BlockquoteBlock, CodeBlock, ContainerBlock, FrontmatterBlock, HtmlBlock, ListBlock, TableBlock, EmbedBlock, EmbeddingBlock, LatexDisplayBlock, HorizontalRuleBlock, PageBreakerBlock, LinkBlock, FigureBlock, AdmonitionBlock, FootnoteBlock, TaskListBlock, DefinitionBlock, SpoilerBlock, AsideBlock, AttributionBlock, MermaidBlock, DataviewBlock, MathBlock, ChartBlock, CustomCodeBlock, EmbedType } from '@nuucognition/ncm';
+
+/**
+ * Base props for all block renderers
+ */
+interface BlockRendererProps<T extends Block = Block> {
+    block: T;
+    className?: string;
+}
+/**
+ * Type for a block renderer component
+ */
+type BlockRenderer<T extends Block = Block> = ComponentType<BlockRendererProps<T>>;
+/**
+ * Registry of block renderers by type.
+ *
+ * Every key (except the language-keyed `custom_code` sub-registry and
+ * `fallback`) corresponds 1:1 to a `block.type` the parser can emit. All keys
+ * are optional here so consumers can pass partial overrides; the shipped
+ * `defaultRenderers` is typed as {@link CompleteBlockRendererRegistry}, which
+ * requires coverage for every parser block type.
+ */
+interface BlockRendererRegistry {
+    paragraph?: BlockRenderer<ParagraphBlock>;
+    header?: BlockRenderer<HeaderBlock>;
+    blockquote?: BlockRenderer<BlockquoteBlock>;
+    code?: BlockRenderer<CodeBlock>;
+    container?: BlockRenderer<ContainerBlock>;
+    frontmatter?: BlockRenderer<FrontmatterBlock>;
+    html?: BlockRenderer<HtmlBlock>;
+    list_ordered?: BlockRenderer<ListBlock>;
+    list_unordered?: BlockRenderer<ListBlock>;
+    table?: BlockRenderer<TableBlock>;
+    embed?: BlockRenderer<EmbedBlock>;
+    embedding?: BlockRenderer<EmbeddingBlock>;
+    latex_display?: BlockRenderer<LatexDisplayBlock>;
+    horizontal_rule?: BlockRenderer<HorizontalRuleBlock>;
+    page_breaker?: BlockRenderer<PageBreakerBlock>;
+    link?: BlockRenderer<LinkBlock>;
+    figure?: BlockRenderer<FigureBlock>;
+    admonition?: BlockRenderer<AdmonitionBlock>;
+    footnote?: BlockRenderer<FootnoteBlock>;
+    task_list?: BlockRenderer<TaskListBlock>;
+    definition?: BlockRenderer<DefinitionBlock>;
+    spoiler?: BlockRenderer<SpoilerBlock>;
+    aside?: BlockRenderer<AsideBlock>;
+    attribution?: BlockRenderer<AttributionBlock>;
+    mermaid?: BlockRenderer<MermaidBlock>;
+    dataview?: BlockRenderer<DataviewBlock>;
+    math?: BlockRenderer<MathBlock>;
+    chart?: BlockRenderer<ChartBlock>;
+    /** Custom code renderers keyed by language identifier */
+    custom_code?: Record<string, BlockRenderer<CustomCodeBlock>>;
+    /** Fallback renderer for unknown block types */
+    fallback?: BlockRenderer<Block>;
+}
+/**
+ * Every concrete `block.type` dispatched through the keyed registry — i.e. all
+ * parser block types except the language-keyed `custom_code`. Derived from the
+ * parser's `Block` union, so adding a block type upstream automatically widens
+ * this and breaks {@link CompleteBlockRendererRegistry} until a renderer exists.
+ */
+type KeyedBlockType = Exclude<Block["type"], "custom_code">;
+/**
+ * The `Block` union member whose discriminant covers literal `K`. Distributes
+ * over `Block` and matches on `K extends T` (not `Block extends { type: K }`),
+ * so block types with a union discriminant resolve correctly — e.g. `ListBlock`
+ * (`"list_ordered" | "list_unordered"`) is found for either list key.
+ */
+type BlockOfType<K extends string, B = Block> = B extends {
+    type: infer T;
+} ? K extends T ? B : never : never;
+/**
+ * A registry that MUST provide a renderer for every keyed block type, plus the
+ * `custom_code` sub-registry. `defaultRenderers` is typed as this — the
+ * compile-time guard that keeps the block→UI mapping 1:1: omit a renderer for
+ * any parser block type and `tsc` fails.
+ */
+type CompleteBlockRendererRegistry = {
+    [K in KeyedBlockType]-?: BlockRenderer<BlockOfType<K> & Block>;
+} & {
+    custom_code: Record<string, BlockRenderer<CustomCodeBlock>>;
+    fallback: BlockRenderer<Block>;
+};
+/**
+ * Props for embedding sub-renderers
+ */
+interface EmbeddingRendererProps {
+    block: EmbeddingBlock;
+    className?: string;
+    resolvedUrl: string;
+}
+/**
+ * Registry of embedding renderers by embed type
+ */
+type EmbeddingRendererRegistry = Partial<Record<EmbedType, ComponentType<EmbeddingRendererProps>>>;
+
+export type { BlockRenderer as B, CompleteBlockRendererRegistry as C, EmbeddingRendererProps as E, KeyedBlockType as K, BlockRendererProps as a, BlockRendererRegistry as b, EmbeddingRendererRegistry as c };

package/dist/styles/nuu.css

@@ -0,0 +1,364 @@
+/*
+ * NCM UI — NUU theme
+ *
+ * Styles NCM blocks against the @nuucognition/ui token system.
+ * Inherits --foreground, --background, --muted, --border, etc. from the host.
+ * Light/dark switches automatically when the host toggles `.dark` on the root.
+ *
+ * Selectors target the data attributes emitted by ncm-ui block components.
+ */
+
+[data-ncm-document].ncm-theme-nuu {
+  font-family: var(--font-sans);
+  font-size: calc(0.875rem * var(--surf-reading-scale, 1));
+  line-height: 1.55;
+  color: var(--foreground);
+}
+
+[data-ncm-document].ncm-theme-nuu > * + * {
+  margin-top: 1rem;
+}
+
+/* Headings — Geist Sans, tracking-tight, normal weight on h1–h3 */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="header"] {
+  font-family: var(--font-heading);
+  color: var(--foreground);
+  scroll-margin-top: 5rem;
+  margin-bottom: 0;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="header"][data-ncm-level="1"] {
+  font-size: calc(1.875rem * var(--surf-reading-scale, 1));
+  line-height: 2.25rem;
+  letter-spacing: -0.025em;
+  font-weight: 400;
+  margin-top: 1.5rem;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="header"][data-ncm-level="1"]:first-child {
+  margin-top: 0;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="header"][data-ncm-level="2"] {
+  font-size: calc(1.5rem * var(--surf-reading-scale, 1));
+  line-height: 2rem;
+  letter-spacing: -0.025em;
+  font-weight: 400;
+  margin-top: 1.25rem;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="header"][data-ncm-level="3"] {
+  font-size: calc(1.25rem * var(--surf-reading-scale, 1));
+  line-height: 1.75rem;
+  letter-spacing: -0.025em;
+  font-weight: 400;
+  margin-top: 1rem;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="header"][data-ncm-level="4"] {
+  font-size: calc(0.875rem * var(--surf-reading-scale, 1));
+  line-height: 1.25rem;
+  font-weight: 500;
+  margin-top: 0.75rem;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="header"][data-ncm-level="5"] {
+  font-size: calc(0.75rem * var(--surf-reading-scale, 1));
+  line-height: 1rem;
+  font-weight: 500;
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+  margin-top: 0.75rem;
+}
+
+/* Paragraph */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="paragraph"] {
+  color: var(--foreground);
+  line-height: 1.55;
+}
+
+/* Blockquote */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="blockquote"] {
+  border-left: 2px solid var(--border);
+  padding-left: 0.875rem;
+  color: color-mix(in srgb, var(--foreground) 80%, transparent);
+  line-height: 1.55;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="blockquote"] p + p {
+  margin-top: 0.25rem;
+}
+
+/* Lists */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_ordered"],
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_unordered"] {
+  padding-left: 1.25rem;
+  color: var(--foreground);
+  line-height: 1.55;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_ordered"] {
+  list-style-type: decimal;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_unordered"] {
+  list-style-type: disc;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_ordered"] li + li,
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_unordered"] li + li {
+  margin-top: 0.125rem;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_ordered"] ol,
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_ordered"] ul,
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_unordered"] ol,
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_unordered"] ul {
+  margin-top: 0.125rem;
+  padding-left: 1.25rem;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_ordered"] li::marker,
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_unordered"] li::marker {
+  color: var(--muted-foreground);
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_ordered"] ol {
+  list-style-type: decimal;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_ordered"] ul,
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_unordered"] ul {
+  list-style-type: disc;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="list_unordered"] ol {
+  list-style-type: decimal;
+}
+
+/* Tables */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="table"] {
+  width: 100%;
+  overflow-x: auto;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="table"] table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: calc(0.75rem * var(--surf-reading-scale, 1));
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="table"] th {
+  border: 1px solid var(--border);
+  padding: 0.5rem 0.75rem;
+  text-align: left;
+  font-weight: 500;
+  background-color: var(--muted);
+  color: var(--foreground);
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="table"] td {
+  border: 1px solid var(--border);
+  padding: 0.5rem 0.75rem;
+  text-align: left;
+  color: var(--foreground);
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="table"] tbody tr:nth-child(even) td {
+  background-color: color-mix(in srgb, var(--muted) 50%, transparent);
+}
+
+/* Code (block) */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="code"] {
+  position: relative;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="code"] pre {
+  overflow-x: auto;
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 0.625rem);
+  padding: 0.75rem;
+  background-color: var(--muted);
+  color: var(--foreground);
+  font-family: var(--font-mono);
+  font-size: calc(0.875rem * var(--surf-reading-scale, 1));
+  line-height: 1.6;
+}
+
+/* Inline code */
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="code"] {
+  font-family: var(--font-mono);
+  font-size: calc(0.75rem * var(--surf-reading-scale, 1));
+  padding: 0.125rem 0.25rem;
+  border-radius: 0.25rem;
+  background-color: var(--muted);
+  color: var(--foreground);
+}
+
+/* Links */
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="link"],
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="wiki_link"][data-ncm-wikilink-status="resolved"],
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="wiki_embed"]:not([data-ncm-wikiembed-status]) {
+  color: var(--brand, var(--primary));
+  text-decoration: underline;
+  text-underline-offset: 4px;
+  font-weight: 500;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="wiki_link"][data-ncm-wikilink-status="missing"],
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="wiki_embed"][data-ncm-wikiembed-status="missing"] {
+  color: var(--muted-foreground);
+  text-decoration: underline dashed;
+  text-underline-offset: 4px;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="wiki_link"][data-ncm-wikilink-status="ambiguous"],
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="wiki_embed"][data-ncm-wikiembed-status="ambiguous"] {
+  color: var(--fire-text, var(--destructive));
+}
+
+/* Horizontal rule */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="horizontal_rule"] {
+  border: 0;
+  border-top: 1px solid var(--border);
+  margin-top: 1.25rem;
+  margin-bottom: 1.25rem;
+}
+
+/* Embeddings */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="embedding"] img,
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="embedding"] video {
+  max-width: 100%;
+  border-radius: var(--radius, 0.625rem);
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="embedding"] figcaption {
+  margin-top: 0.5rem;
+  text-align: left;
+  font-size: 0.75rem;
+  color: var(--muted-foreground);
+}
+
+/* LaTeX display */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="latex_display"] {
+  overflow-x: auto;
+  color: var(--foreground);
+}
+
+/* Custom code (fallback for promoted blocks without renderer) */
+[data-ncm-document].ncm-theme-nuu [data-ncm-type="custom_code"] {
+  border: 1px dashed var(--border);
+  border-radius: var(--radius, 0.625rem);
+  padding: 0.75rem;
+  background-color: var(--muted);
+  color: var(--foreground);
+  font-family: var(--font-mono);
+  font-size: 0.875rem;
+}
+
+/* OpenDyslexic3 — newest, refined letterforms of the OpenDyslexic family
+ * (the original v2 that @fontsource/opendyslexic ships has visibly different
+ * glyph shapes). Fonts are bundled locally under ./fonts/ so the bundle is
+ * self-contained — no CDN dependency.
+ *
+ * Spacing matches opendyslexic.org's own About page CSS:
+ *   body { font-family: OpenDyslexic3; letter-spacing: 0.07rem }
+ *   article { line-height: 1.75rem }
+ * — weight stays at 400 (Regular), small letter-spacing bump separates the
+ * chunky glyphs, generous line-height gives them room to breathe. */
+@font-face {
+  font-family: "OpenDyslexic3";
+  src: url("./fonts/OpenDyslexic3-Regular.woff2") format("woff2"),
+       url("./fonts/OpenDyslexic3-Regular.woff") format("woff");
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: "OpenDyslexic3";
+  src: url("./fonts/OpenDyslexic3-Bold.woff2") format("woff2"),
+       url("./fonts/OpenDyslexic3-Bold.woff") format("woff");
+  font-weight: 700;
+  font-style: normal;
+  font-display: swap;
+}
+
+[data-ncm-document].ncm-theme-nuu[data-ncm-dyslexic-font="true"],
+[data-ncm-document].ncm-theme-nuu[data-ncm-dyslexic-font="true"] [data-ncm-type="header"],
+[data-ncm-document].ncm-theme-nuu[data-ncm-dyslexic-font="true"] [data-ncm-type="paragraph"],
+[data-ncm-document].ncm-theme-nuu[data-ncm-dyslexic-font="true"] [data-ncm-type="list"],
+[data-ncm-document].ncm-theme-nuu[data-ncm-dyslexic-font="true"] [data-ncm-type="blockquote"],
+[data-ncm-document].ncm-theme-nuu[data-ncm-dyslexic-font="true"] [data-ncm-type="table"] {
+  font-family: "OpenDyslexic3", var(--font-sans);
+}
+
+[data-ncm-document].ncm-theme-nuu[data-ncm-dyslexic-font="true"] {
+  letter-spacing: 0.07rem;
+  line-height: 1.75;
+}
+
+/* Inline references — ^[ref: …] (citation, [1]) and ^[footnote: …] (¹) */
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="reference"],
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="footnote"] {
+  position: relative;
+  white-space: nowrap;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-ref-marker] {
+  cursor: pointer;
+  color: var(--brand, var(--primary));
+  font-weight: 500;
+  border-radius: 0.1875rem;
+  outline: none;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="reference"] [data-ncm-ref-marker] {
+  font-size: 0.85em;
+  padding: 0 0.0625rem;
+}
+
+[data-ncm-document].ncm-theme-nuu sup[data-ncm-ref-marker] {
+  font-size: 0.7em;
+  line-height: 0;
+  padding-left: 0.0625rem;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-ref-marker]:hover,
+[data-ncm-document].ncm-theme-nuu [data-ncm-ref-marker]:focus-visible {
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+
+/* Popover — content revealed on marker hover/focus */
+[data-ncm-document].ncm-theme-nuu [data-ncm-ref-popover] {
+  position: absolute;
+  left: 0;
+  top: 1.6em;
+  z-index: 20;
+  width: max-content;
+  max-width: min(22rem, 80vw);
+  padding: 0.5rem 0.625rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius, 0.5rem);
+  background: var(--popover, var(--background, var(--muted)));
+  color: var(--popover-foreground, var(--foreground));
+  box-shadow: 0 4px 12px rgb(0 0 0 / 0.12);
+  font-size: calc(0.8125rem * var(--surf-reading-scale, 1));
+  font-weight: 400;
+  line-height: 1.5;
+  white-space: normal;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.12s ease, visibility 0.12s ease;
+  pointer-events: none;
+}
+
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="reference"]:hover [data-ncm-ref-popover],
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="reference"]:focus-within [data-ncm-ref-popover],
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="footnote"]:hover [data-ncm-ref-popover],
+[data-ncm-document].ncm-theme-nuu [data-ncm-token="footnote"]:focus-within [data-ncm-ref-popover] {
+  opacity: 1;
+  visibility: visible;
+  pointer-events: auto;
+}