@nuucognition/ncm-ui 0.1.0-dev.1 → 0.1.1-beta.1

package/dist/blocks/spoiler/index.js

@@ -543,9 +543,10 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
     case "image": {
       const src = config.inline?.resolveAssetPath?.(token.src) ?? token.src;
       return /* @__PURE__ */ jsx(
-        "img",
+        EmbedImage,
         {
-          "data-ncm-token": "image",
+          attrs: { "data-ncm-token": "image" },
+          target: token.src,
           src,
           alt: token.alt,
           title: token.title
@@ -579,10 +580,13 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
       }
       if (embedType === "image") {
         return /* @__PURE__ */ jsx(
-          "img",
+          EmbedImage,
           {
-            "data-ncm-token": "wiki_embed",
-            "data-ncm-wikiembed-type": embedType,
+            attrs: {
+              "data-ncm-token": "wiki_embed",
+              "data-ncm-wikiembed-type": embedType
+            },
+            target: token.target,
             src: url,
             alt: token.display ?? token.target,
             className: config.embeddings?.imageClassName
@@ -613,6 +617,22 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
           }
         );
       }
+      const onEmbedClick = config.embeddings?.onEmbedClick;
+      if (onEmbedClick) {
+        const handleClick = (e) => {
+          onEmbedClick(token.target, result, e);
+        };
+        return /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            "data-ncm-token": "wiki_embed",
+            "data-ncm-wikiembed-type": embedType,
+            onClick: handleClick,
+            children: token.display ?? token.target
+          }
+        );
+      }
       return /* @__PURE__ */ jsx(
         "a",
         {
@@ -631,6 +651,31 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
       return null;
   }
 }
+function EmbedImage({ attrs, target, src, alt, title, className }) {
+  const config = useNcmConfig();
+  const Fallback = config.embeddings?.renderImageError;
+  const [failedSrc, setFailedSrc] = useState(null);
+  useEffect(() => {
+    setFailedSrc(null);
+  }, [src]);
+  if (!Fallback) {
+    return /* @__PURE__ */ jsx("img", { ...attrs, src, alt, title, className });
+  }
+  if (failedSrc === src) {
+    return /* @__PURE__ */ jsx(Fallback, { target, src, alt, retry: () => setFailedSrc(null) });
+  }
+  return /* @__PURE__ */ jsx(
+    "img",
+    {
+      ...attrs,
+      src,
+      alt,
+      title,
+      className,
+      onError: () => setFailedSrc(src)
+    }
+  );
+}
 function renderReadingText(content, opts) {
   if (!content) return /* @__PURE__ */ jsx(Fragment, { children: content });
   const { bionic = false, beeline = false } = opts;
@@ -666,7 +711,7 @@ function renderReadingText(content, opts) {
   return /* @__PURE__ */ jsx(Fragment, { children: pieces });
 }
 function BlockquoteBlock({ block, className }) {
-  const lines = block.content.split("\n").filter((line) => line.trim() !== "");
+  const lines = block.content.split("\n");
   return /* @__PURE__ */ jsx(
     "blockquote",
     {
@@ -676,7 +721,7 @@ function BlockquoteBlock({ block, className }) {
       "data-block-id": block.id,
       "data-ncm-blockquote": "",
       className,
-      children: lines.length <= 1 ? /* @__PURE__ */ jsx(InlineContent, { content: block.content }) : lines.map((line, index) => /* @__PURE__ */ jsx("p", { children: /* @__PURE__ */ jsx(InlineContent, { content: line }) }, index))
+      children: lines.length <= 1 ? /* @__PURE__ */ jsx(InlineContent, { content: block.content }) : lines.map((line, index) => /* @__PURE__ */ jsx("p", { children: line.trim().length > 0 ? /* @__PURE__ */ jsx(InlineContent, { content: line }) : /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\xA0" }) }, index))
     }
   );
 }
@@ -691,7 +736,8 @@ function ChartBlock({ block, className }) {
       "data-ncm-chart": "",
       "data-ncm-chart-type": block.chartType ?? "unknown",
       className: cn(
-        "overflow-x-auto rounded-lg border border-border bg-muted p-4 font-mono text-sm",
+        // `overflow-y-hidden` pairs with `overflow-x-auto` on purpose — see the note in `lib/defaults.ts`.
+        "overflow-x-auto overflow-y-hidden rounded-lg border border-border bg-muted p-4 font-mono text-sm",
         className
       ),
       children: /* @__PURE__ */ jsx("code", { children: block.content })
@@ -816,7 +862,7 @@ function CodeBlock({ block, className }) {
         "data-ncm-language": block.language,
         className: cn("relative", className),
         children: [
-          codeConfig.copyButton !== false && /* @__PURE__ */ jsx(CopyButton, { content: block.content }),
+          codeConfig.copyButton === true && /* @__PURE__ */ jsx(CopyButton, { content: block.content }),
           /* @__PURE__ */ jsx(CustomRenderer, { code: block.content, language: block.language }),
           languageLabel
         ]
@@ -835,7 +881,7 @@ function CodeBlock({ block, className }) {
       "data-ncm-language": block.language,
       className: cn("relative", className),
       children: [
-        codeConfig?.copyButton !== false && /* @__PURE__ */ jsx(CopyButton, { content: block.content }),
+        codeConfig?.copyButton === true && /* @__PURE__ */ jsx(CopyButton, { content: block.content }),
         /* @__PURE__ */ jsx("pre", { "data-ncm-code-pre": "", children: /* @__PURE__ */ jsxs("div", { className: "flex", children: [
           codeConfig?.lineNumbers && /* @__PURE__ */ jsx(LineNumbers, { count: lineCount }),
           /* @__PURE__ */ jsx("code", { "data-ncm-code": "", className: "flex-1", children: /* @__PURE__ */ jsx(DefaultShikiRenderer, { code: block.content, language: block.language }) })
@@ -871,7 +917,8 @@ function DataviewBlock({ block, className }) {
       "data-ncm-dataview": "",
       "data-ncm-query-type": block.queryType,
       className: cn(
-        "overflow-x-auto rounded-lg border border-border bg-muted p-4 font-mono text-sm",
+        // `overflow-y-hidden` pairs with `overflow-x-auto` on purpose — see the note in `lib/defaults.ts`.
+        "overflow-x-auto overflow-y-hidden rounded-lg border border-border bg-muted p-4 font-mono text-sm",
         className
       ),
       children: /* @__PURE__ */ jsx("code", { children: block.query })
@@ -1210,7 +1257,8 @@ function HtmlBlock({ block, className }) {
       "data-block-id": block.id,
       "data-ncm-html": "",
       className: cn(
-        "overflow-x-auto rounded-lg border border-border bg-muted p-4 font-mono text-sm",
+        // `overflow-y-hidden` pairs with `overflow-x-auto` on purpose — see the note in `lib/defaults.ts`.
+        "overflow-x-auto overflow-y-hidden rounded-lg border border-border bg-muted p-4 font-mono text-sm",
         className
       ),
       children: /* @__PURE__ */ jsx("code", { children: block.content })
@@ -1248,7 +1296,7 @@ function LatexDisplayBlock({ block, className }) {
         "data-ncm-type": block.type,
         "data-block-id": block.id,
         "data-ncm-latex-display": "",
-        className: cn("overflow-x-auto", className),
+        className: cn("overflow-x-auto overflow-y-hidden", className),
         dangerouslySetInnerHTML: { __html: html }
       }
     );
@@ -1263,7 +1311,7 @@ function LatexDisplayBlock({ block, className }) {
       "data-ncm-type": block.type,
       "data-block-id": block.id,
       "data-ncm-latex-display": "",
-      className: cn("overflow-x-auto rounded-lg border border-border bg-muted p-4 font-mono text-sm", className),
+      className: cn("overflow-x-auto overflow-y-hidden rounded-lg border border-border bg-muted p-4 font-mono text-sm", className),
       children: /* @__PURE__ */ jsx("code", { children: block.content })
     }
   );
@@ -1287,10 +1335,12 @@ function LinkBlock({ block, className }) {
 function ListBlock({ block, className }) {
   const isOrdered = block.type === "list_ordered";
   const Tag = isOrdered ? "ol" : "ul";
+  const start = isOrdered && typeof block.marker === "number" && block.marker !== 1 ? block.marker : void 0;
   return /* @__PURE__ */ jsx(
     Tag,
     {
       role: "list",
+      start,
       "data-ncm-block": block.id,
       "data-ncm-stable": block.stableId,
       "data-ncm-type": block.type,
@@ -1302,6 +1352,9 @@ function ListBlock({ block, className }) {
     }
   );
 }
+function ItemContent({ content }) {
+  return content.length > 0 ? /* @__PURE__ */ jsx(InlineContent, { content }) : /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\xA0" });
+}
 function nestedItemIdKey(id) {
   if (!id) {
     return void 0;
@@ -1318,7 +1371,7 @@ function ListItems({ items, itemIds, ordered }) {
   return /* @__PURE__ */ jsx(Fragment, { children: items.map((item, index) => {
     const key = nestedItemIdKey(itemIds?.[index]) ?? `item-${index}`;
     if (typeof item === "string") {
-      return /* @__PURE__ */ jsx("li", { "data-ncm-list-item": "", children: /* @__PURE__ */ jsx(InlineContent, { content: item }) }, key);
+      return /* @__PURE__ */ jsx("li", { "data-ncm-list-item": "", children: /* @__PURE__ */ jsx(ItemContent, { content: item }) }, key);
     }
     if (isTypedNestedList(item)) {
       return /* @__PURE__ */ jsx(NestedTypedList, { list: item }, key);
@@ -1328,7 +1381,7 @@ function ListItems({ items, itemIds, ordered }) {
       const content = typeof first === "string" ? first : "";
       const nestedContent = processNestedItems(rest, ordered);
       return /* @__PURE__ */ jsxs("li", { "data-ncm-list-item": "", children: [
-        /* @__PURE__ */ jsx(InlineContent, { content }),
+        /* @__PURE__ */ jsx(ItemContent, { content }),
         nestedContent
       ] }, key);
     }
@@ -1378,7 +1431,7 @@ function MathBlock({ block, className }) {
         "data-ncm-type": block.type,
         "data-block-id": block.id,
         "data-ncm-math": "",
-        className: cn("overflow-x-auto", className),
+        className: cn("overflow-x-auto overflow-y-hidden", className),
         dangerouslySetInnerHTML: { __html: html }
       }
     );
@@ -1394,7 +1447,8 @@ function MathBlock({ block, className }) {
       "data-block-id": block.id,
       "data-ncm-math": "",
       className: cn(
-        "overflow-x-auto rounded-lg border border-border bg-muted p-4 font-mono text-sm",
+        // `overflow-y-hidden` pairs with `overflow-x-auto` on purpose — see the note in `lib/defaults.ts`.
+        "overflow-x-auto overflow-y-hidden rounded-lg border border-border bg-muted p-4 font-mono text-sm",
         className
       ),
       children: /* @__PURE__ */ jsx("code", { children: block.content })
@@ -1412,7 +1466,8 @@ function MermaidBlock({ block, className }) {
       "data-ncm-mermaid": "",
       "data-ncm-diagram-type": block.diagramType,
       className: cn(
-        "overflow-x-auto rounded-lg border border-border bg-muted p-4 font-mono text-sm",
+        // `overflow-y-hidden` pairs with `overflow-x-auto` on purpose — see the note in `lib/defaults.ts`.
+        "overflow-x-auto overflow-y-hidden rounded-lg border border-border bg-muted p-4 font-mono text-sm",
         className
       ),
       children: /* @__PURE__ */ jsx("code", { children: block.content })
@@ -1457,7 +1512,7 @@ function TableBlock({ block, className }) {
       "data-ncm-type": block.type,
       "data-block-id": block.id,
       "data-ncm-table": "",
-      className: cn("w-full overflow-x-auto", className),
+      className: cn("w-full overflow-x-auto overflow-y-hidden", className),
       children: /* @__PURE__ */ jsxs("table", { role: "table", "data-ncm-table-element": "", children: [
         /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsx("tr", { "data-ncm-table-row": "", children: block.headers.map((header, index) => /* @__PURE__ */ jsx("th", { "data-ncm-table-header": "", children: /* @__PURE__ */ jsx(InlineContent, { content: header }) }, index)) }) }),
         /* @__PURE__ */ jsx("tbody", { children: block.rows.map((row, rowIndex) => {
@@ -1471,6 +1526,7 @@ function TableBlock({ block, className }) {
 function TaskItems({ items }) {
   return /* @__PURE__ */ jsx(Fragment, { children: items.map((item) => {
     const status = item.checked ? "Completed" : "Incomplete";
+    const text = serializeInlineContent(item.content);
     return /* @__PURE__ */ jsxs(
       "li",
       {
@@ -1497,7 +1553,7 @@ function TaskItems({ items }) {
                 ":",
                 " "
               ] }),
-              /* @__PURE__ */ jsx(InlineContent, { content: serializeInlineContent(item.content) })
+              text.length > 0 ? /* @__PURE__ */ jsx(InlineContent, { content: text }) : /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\xA0" })
             ] })
           ] }),
           item.children ? /* @__PURE__ */ jsx("ul", { role: "list", "data-ncm-list-nested": "", className: "ml-6 list-none", children: /* @__PURE__ */ jsx(TaskItems, { items: item.children.items }) }) : null
@@ -1542,7 +1598,7 @@ function FallbackBlock({ block, className }) {
       "data-block-id": block.id,
       "data-ncm-fallback": "",
       className: cn(
-        "overflow-x-auto rounded-lg border border-border bg-muted p-4 font-mono text-sm",
+        "overflow-x-auto overflow-y-hidden rounded-lg border border-border bg-muted p-4 font-mono text-sm",
         className
       )
     },
@@ -1598,7 +1654,7 @@ function CustomCodeBlock({ block, className }) {
       "data-block-id": block.id,
       "data-ncm-custom-code": "",
       "data-ncm-language": block.language,
-      className: cn("overflow-x-auto", className),
+      className: cn("overflow-x-auto overflow-y-hidden", className),
       children: [
         /* @__PURE__ */ jsx("div", { className: "mb-2 text-xs font-medium text-muted-foreground", children: block.language }),
         /* @__PURE__ */ jsx("pre", { children: /* @__PURE__ */ jsx("code", { children: block.content }) })

package/dist/blocks/table/index.d.ts

@@ -1,9 +1,8 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { TableBlock as TableBlock$1 } from '@nuucognition/ncm';
 import { a as BlockRendererProps } from '../../renderers-C5f41FCy.js';
-import 'react';
 
 type TableBlockProps = BlockRendererProps<TableBlock$1>;
-declare function TableBlock({ block, className }: TableBlockProps): react_jsx_runtime.JSX.Element;
+declare function TableBlock({ block, className }: TableBlockProps): react.JSX.Element;
 
 export { TableBlock, type TableBlockProps };

package/dist/blocks/table/index.js

@@ -470,9 +470,10 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
     case "image": {
       const src = config.inline?.resolveAssetPath?.(token.src) ?? token.src;
       return /* @__PURE__ */ jsx(
-        "img",
+        EmbedImage,
         {
-          "data-ncm-token": "image",
+          attrs: { "data-ncm-token": "image" },
+          target: token.src,
           src,
           alt: token.alt,
           title: token.title
@@ -506,10 +507,13 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
       }
       if (embedType === "image") {
         return /* @__PURE__ */ jsx(
-          "img",
+          EmbedImage,
           {
-            "data-ncm-token": "wiki_embed",
-            "data-ncm-wikiembed-type": embedType,
+            attrs: {
+              "data-ncm-token": "wiki_embed",
+              "data-ncm-wikiembed-type": embedType
+            },
+            target: token.target,
             src: url,
             alt: token.display ?? token.target,
             className: config.embeddings?.imageClassName
@@ -540,6 +544,22 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
           }
         );
       }
+      const onEmbedClick = config.embeddings?.onEmbedClick;
+      if (onEmbedClick) {
+        const handleClick = (e) => {
+          onEmbedClick(token.target, result, e);
+        };
+        return /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            "data-ncm-token": "wiki_embed",
+            "data-ncm-wikiembed-type": embedType,
+            onClick: handleClick,
+            children: token.display ?? token.target
+          }
+        );
+      }
       return /* @__PURE__ */ jsx(
         "a",
         {
@@ -558,6 +578,31 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
       return null;
   }
 }
+function EmbedImage({ attrs, target, src, alt, title, className }) {
+  const config = useNcmConfig();
+  const Fallback = config.embeddings?.renderImageError;
+  const [failedSrc, setFailedSrc] = useState(null);
+  useEffect(() => {
+    setFailedSrc(null);
+  }, [src]);
+  if (!Fallback) {
+    return /* @__PURE__ */ jsx("img", { ...attrs, src, alt, title, className });
+  }
+  if (failedSrc === src) {
+    return /* @__PURE__ */ jsx(Fallback, { target, src, alt, retry: () => setFailedSrc(null) });
+  }
+  return /* @__PURE__ */ jsx(
+    "img",
+    {
+      ...attrs,
+      src,
+      alt,
+      title,
+      className,
+      onError: () => setFailedSrc(src)
+    }
+  );
+}
 function renderReadingText(content, opts) {
   if (!content) return /* @__PURE__ */ jsx(Fragment, { children: content });
   const { bionic = false, beeline = false } = opts;
@@ -604,7 +649,7 @@ function TableBlock({ block, className }) {
       "data-ncm-type": block.type,
       "data-block-id": block.id,
       "data-ncm-table": "",
-      className: cn("w-full overflow-x-auto", className),
+      className: cn("w-full overflow-x-auto overflow-y-hidden", className),
       children: /* @__PURE__ */ jsxs("table", { role: "table", "data-ncm-table-element": "", children: [
         /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsx("tr", { "data-ncm-table-row": "", children: block.headers.map((header, index) => /* @__PURE__ */ jsx("th", { "data-ncm-table-header": "", children: /* @__PURE__ */ jsx(InlineContent, { content: header }) }, index)) }) }),
         /* @__PURE__ */ jsx("tbody", { children: block.rows.map((row, rowIndex) => {

package/dist/blocks/task-list/index.d.ts

@@ -1,13 +1,12 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { TaskListBlock as TaskListBlock$1 } from '@nuucognition/ncm';
 import { a as BlockRendererProps } from '../../renderers-C5f41FCy.js';
-import 'react';
 
 type TaskListBlockProps = BlockRendererProps<TaskListBlock$1>;
 /**
  * Task-list renderer — a checkbox list promoted from `[ ]` / `[x]` items.
  * Checkboxes are display-only (disabled); nested task lists recurse.
  */
-declare function TaskListBlock({ block, className }: TaskListBlockProps): react_jsx_runtime.JSX.Element;
+declare function TaskListBlock({ block, className }: TaskListBlockProps): react.JSX.Element;
 
 export { TaskListBlock, type TaskListBlockProps };

package/dist/blocks/task-list/index.js

@@ -473,9 +473,10 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
     case "image": {
       const src = config.inline?.resolveAssetPath?.(token.src) ?? token.src;
       return /* @__PURE__ */ jsx(
-        "img",
+        EmbedImage,
         {
-          "data-ncm-token": "image",
+          attrs: { "data-ncm-token": "image" },
+          target: token.src,
           src,
           alt: token.alt,
           title: token.title
@@ -509,10 +510,13 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
       }
       if (embedType === "image") {
         return /* @__PURE__ */ jsx(
-          "img",
+          EmbedImage,
           {
-            "data-ncm-token": "wiki_embed",
-            "data-ncm-wikiembed-type": embedType,
+            attrs: {
+              "data-ncm-token": "wiki_embed",
+              "data-ncm-wikiembed-type": embedType
+            },
+            target: token.target,
             src: url,
             alt: token.display ?? token.target,
             className: config.embeddings?.imageClassName
@@ -543,6 +547,22 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
           }
         );
       }
+      const onEmbedClick = config.embeddings?.onEmbedClick;
+      if (onEmbedClick) {
+        const handleClick = (e) => {
+          onEmbedClick(token.target, result, e);
+        };
+        return /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            "data-ncm-token": "wiki_embed",
+            "data-ncm-wikiembed-type": embedType,
+            onClick: handleClick,
+            children: token.display ?? token.target
+          }
+        );
+      }
       return /* @__PURE__ */ jsx(
         "a",
         {
@@ -561,6 +581,31 @@ function TokenRenderer({ token, disableBionic, disableBeeline }) {
       return null;
   }
 }
+function EmbedImage({ attrs, target, src, alt, title, className }) {
+  const config = useNcmConfig();
+  const Fallback = config.embeddings?.renderImageError;
+  const [failedSrc, setFailedSrc] = useState(null);
+  useEffect(() => {
+    setFailedSrc(null);
+  }, [src]);
+  if (!Fallback) {
+    return /* @__PURE__ */ jsx("img", { ...attrs, src, alt, title, className });
+  }
+  if (failedSrc === src) {
+    return /* @__PURE__ */ jsx(Fallback, { target, src, alt, retry: () => setFailedSrc(null) });
+  }
+  return /* @__PURE__ */ jsx(
+    "img",
+    {
+      ...attrs,
+      src,
+      alt,
+      title,
+      className,
+      onError: () => setFailedSrc(src)
+    }
+  );
+}
 function renderReadingText(content, opts) {
   if (!content) return /* @__PURE__ */ jsx(Fragment, { children: content });
   const { bionic = false, beeline = false } = opts;
@@ -617,6 +662,7 @@ function BlockShell({
 function TaskItems({ items }) {
   return /* @__PURE__ */ jsx(Fragment, { children: items.map((item) => {
     const status = item.checked ? "Completed" : "Incomplete";
+    const text = serializeInlineContent(item.content);
     return /* @__PURE__ */ jsxs(
       "li",
       {
@@ -643,7 +689,7 @@ function TaskItems({ items }) {
                 ":",
                 " "
               ] }),
-              /* @__PURE__ */ jsx(InlineContent, { content: serializeInlineContent(item.content) })
+              text.length > 0 ? /* @__PURE__ */ jsx(InlineContent, { content: text }) : /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\xA0" })
             ] })
           ] }),
           item.children ? /* @__PURE__ */ jsx("ul", { role: "list", "data-ncm-list-nested": "", className: "ml-6 list-none", children: /* @__PURE__ */ jsx(TaskItems, { items: item.children.items }) }) : null

package/dist/components/index.d.ts

@@ -2,10 +2,10 @@ import * as react from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
 import { Block } from '@nuucognition/ncm';
 export { NcmBlock, NcmBlockProps } from './ncm-block.js';
-export { NcmDocument, NcmDocumentProps, NcmTheme } from './ncm-document.js';
-import 'react/jsx-runtime';
+import { N as NcmConfig } from '../use-ncm-config-CnntcShj.js';
+import { NcmTheme } from './ncm-document.js';
+export { NcmDocument, NcmDocumentProps } from './ncm-document.js';
 import '../renderers-C5f41FCy.js';
-import '../use-ncm-config-D0doMYTH.js';
 import '@nuucognition/mesh-core';
 
 type BlockShellTag = "aside" | "details" | "div" | "dl" | "figure" | "section" | "ul";
@@ -596,4 +596,34 @@ declare function ChildBlocks({ as, blocks, ...props }: ChildBlocksProps): react.
     onTransitionStartCapture?: react.TransitionEventHandler<HTMLElement> | undefined;
 }, HTMLElement>;
 
-export { BlockShell, type BlockShellProps, ChildBlocks, type ChildBlocksProps, blockDataAttributes, blockKey };
+interface NcmBlockPreviewProps {
+    /** The block's markdown source, verbatim. */
+    source: string;
+    /**
+     * The NCM block type the source is expected to parse as. When set and the
+     * parse produces no block of this type, the preview shows the parse warning
+     * instead of falling back to whatever did parse. Absent, every parsed block
+     * renders.
+     */
+    expectedType?: string;
+    theme?: NcmTheme;
+    /** Optional provider config (renderers, code, inline …), mounted internally. */
+    config?: NcmConfig;
+    className?: string;
+}
+/**
+ * The one-block reader preview.
+ *
+ * Give it a source string, get the ncm-ui rendering back — or a quiet
+ * "cannot be parsed" state when the source does not parse as the expected
+ * block type. Self-sufficient by design: it mounts its own provider, so a
+ * host can render it anywhere (the NUU Editor's node views render it through
+ * the `previewProviders` seam, outside any app provider tree).
+ *
+ * Parse options mirror the playground gallery's (`ncm-full`, raw HTML,
+ * frontmatter optional), so the preview and the gallery agree on what a
+ * block's source means.
+ */
+declare function NcmBlockPreview({ source, expectedType, theme, config, className, }: NcmBlockPreviewProps): react.JSX.Element;
+
+export { BlockShell, type BlockShellProps, ChildBlocks, type ChildBlocksProps, NcmBlockPreview, type NcmBlockPreviewProps, NcmTheme, blockDataAttributes, blockKey };