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

package/dist/hooks/use-block-renderer.js

@@ -26,7 +26,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 }) })
@@ -650,9 +650,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
@@ -686,10 +687,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
@@ -720,6 +724,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",
         {
@@ -738,6 +758,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;
@@ -773,7 +818,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",
     {
@@ -783,7 +828,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))
     }
   );
 }
@@ -798,7 +843,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 })
@@ -923,7 +969,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
         ]
@@ -942,7 +988,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 }) })
@@ -978,7 +1024,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 })
@@ -1317,7 +1364,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 })
@@ -1355,7 +1403,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 }
       }
     );
@@ -1370,7 +1418,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 })
     }
   );
@@ -1394,10 +1442,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,
@@ -1409,6 +1459,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;
@@ -1425,7 +1478,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);
@@ -1435,7 +1488,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);
     }
@@ -1485,7 +1538,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 }
       }
     );
@@ -1501,7 +1554,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 })
@@ -1519,7 +1573,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 })
@@ -1580,7 +1635,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) => {
@@ -1594,6 +1649,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",
       {
@@ -1620,7 +1676,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
@@ -1665,7 +1721,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
       )
     },

package/dist/hooks/use-ncm-config.d.ts

@@ -1,5 +1,4 @@
-export { u as useNcmConfig } from '../use-ncm-config-D0doMYTH.js';
-import 'react/jsx-runtime';
+export { u as useNcmConfig } from '../use-ncm-config-CnntcShj.js';
 import 'react';
 import '@nuucognition/mesh-core';
 import '@nuucognition/ncm';

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { C as CodeConfig, E as EmbeddingsConfig, I as InlineConfig, N as NcmConfig, a as NcmProvider, b as NcmProviderProps, u as useNcmConfig } from './use-ncm-config-D0doMYTH.js';
-export { B as BlockReferenceScope, a as BlockReferenceScopeProps, b as BlockReferenceScopeValue, I as InertReferenceScope, N as NcmReferencesProvider, c as NcmReferencesProviderProps, R as ReferenceCounts, d as ReferenceKind, e as computeReferenceBases, u as useBlockReferenceScope } from './references-Bs5wJybr.js';
+export { C as CodeConfig, E as EmbeddingsConfig, I as ImageErrorProps, a as InlineConfig, N as NcmConfig, b as NcmProvider, c as NcmProviderProps, u as useNcmConfig } from './use-ncm-config-CnntcShj.js';
+export { B as BlockReferenceScope, a as BlockReferenceScopeProps, b as BlockReferenceScopeValue, I as InertReferenceScope, N as NcmReferencesProvider, c as NcmReferencesProviderProps, R as ReferenceCounts, d as ReferenceKind, e as computeReferenceBases, u as useBlockReferenceScope } from './references-BYW5pnj_.js';
 export { B as BlockRenderer, a as BlockRendererProps, b as BlockRendererRegistry, C as CompleteBlockRendererRegistry, E as EmbeddingRendererProps, c as EmbeddingRendererRegistry, K as KeyedBlockType } from './renderers-C5f41FCy.js';
 export { B as BoldToken, C as CodeToken, I as ImageToken, a as InlineRefToken, b as InlineToken, c as ItalicToken, L as LatexToken, d as LinkToken, S as StrikethroughToken, T as TextToken } from './inline-DwUYUmk4.js';
-export { BlockShell, BlockShellProps, ChildBlocks, ChildBlocksProps, blockDataAttributes, blockKey } from './components/index.js';
+export { BlockShell, BlockShellProps, ChildBlocks, ChildBlocksProps, NcmBlockPreview, NcmBlockPreviewProps, blockDataAttributes, blockKey } from './components/index.js';
 export { NcmBlock, NcmBlockProps } from './components/ncm-block.js';
 export { NcmDocument, NcmDocumentProps, NcmTheme } from './components/ncm-document.js';
 export { AdmonitionBlock, AdmonitionBlockProps } from './blocks/admonition/index.js';
@@ -36,7 +36,6 @@ export { InlineContent, InlineContentProps, ReferenceMarker, ReferenceMarkerProp
 export { useBlockRenderer, useCustomCodeRenderer } from './hooks/use-block-renderer.js';
 export { defaultRenderers } from './lib/defaults.js';
 export { cn } from './lib/utils.js';
-import 'react/jsx-runtime';
 import 'react';
 import '@nuucognition/mesh-core';
 import '@nuucognition/ncm';

package/dist/index.js

@@ -1,7 +1,7 @@
 "use client";
-import { createContext, useContext, useMemo, useRef, useId, useCallback, useState, createElement, useEffect, Component } from 'react';
+import { createContext, useContext, useMemo, useRef, useId, useCallback, useState, useEffect, createElement, Component } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { serializeInlineContent, sanitizeHtml, isTypedNestedList } from '@nuucognition/ncm';
+import { serializeInlineContent, sanitizeHtml, isTypedNestedList, parseNcm } from '@nuucognition/ncm';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { extractExtension, embedTypeFromExtension } from '@nuucognition/mesh-core';
@@ -614,9 +614,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
@@ -650,10 +651,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
@@ -684,6 +688,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",
         {
@@ -702,6 +722,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;
@@ -743,7 +788,7 @@ function renderBeelineText(content) {
   return renderReadingText(content, { beeline: true });
 }
 function BlockquoteBlock({ block, className }) {
-  const lines = block.content.split("\n").filter((line) => line.trim() !== "");
+  const lines = block.content.split("\n");
   return /* @__PURE__ */ jsx(
     "blockquote",
     {
@@ -753,7 +798,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))
     }
   );
 }
@@ -768,7 +813,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 })
@@ -893,7 +939,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
         ]
@@ -912,7 +958,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 }) })
@@ -948,7 +994,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 })
@@ -1287,7 +1334,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 })
@@ -1348,7 +1396,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 }
       }
     );
@@ -1363,7 +1411,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 })
     }
   );
@@ -1387,10 +1435,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,
@@ -1402,6 +1452,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;
@@ -1418,7 +1471,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);
@@ -1428,7 +1481,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);
     }
@@ -1478,7 +1531,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 }
       }
     );
@@ -1494,7 +1547,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 })
@@ -1512,7 +1566,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 })
@@ -1573,7 +1628,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) => {
@@ -1587,6 +1642,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",
       {
@@ -1613,7 +1669,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
@@ -1658,7 +1714,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
       )
     },
@@ -1714,7 +1770,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 }) })
@@ -1865,6 +1921,42 @@ function NcmDocument({
     }
   );
 }
+function NcmBlockPreview({
+  source,
+  expectedType,
+  theme = "nuu",
+  config,
+  className
+}) {
+  const parsed = useMemo(() => {
+    try {
+      const doc = parseNcm(source, {
+        preset: "ncm-full",
+        allowMissingFrontmatter: true,
+        rawHtml: true
+      });
+      const all = doc.blocks ?? [];
+      const blocks = expectedType ? all.filter((b) => b.type === expectedType) : all;
+      return { blocks, failed: blocks.length === 0 };
+    } catch {
+      return { blocks: [], failed: true };
+    }
+  }, [source, expectedType]);
+  if (parsed.failed) {
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        "data-ncm-parse-warning": "",
+        "data-ncm-theme": theme,
+        className: `ncm-theme-${theme}${className ? ` ${className}` : ""}`,
+        role: "status",
+        children: expectedType ? `Cannot be parsed as ${expectedType}` : "Cannot be parsed"
+      }
+    );
+  }
+  const document2 = /* @__PURE__ */ jsx(NcmDocument, { blocks: parsed.blocks, theme, className });
+  return config ? /* @__PURE__ */ jsx(NcmProvider, { config, children: document2 }) : document2;
+}
 
 // src/hooks/use-block-renderer.ts
 function useBlockRenderer(blockType) {
@@ -1884,4 +1976,4 @@ function useCustomCodeRenderer(language) {
   return customCodeRenderers[language];
 }
 
-export { AdmonitionBlock, AsideBlock, AttributionBlock, BlockReferenceScope, BlockShell, BlockquoteBlock, ChartBlock, ChildBlocks, CodeBlock, ContainerBlock, CustomCodeBlock, DataviewBlock, DefinitionBlock, EmbeddingBlock, FigureBlock, FootnoteBlock, FrontmatterBlock, HeaderBlock, HorizontalRuleBlock, HtmlBlock, InertReferenceScope, InlineContent, LatexDisplayBlock, LinkBlock, ListBlock, MathBlock, MermaidBlock, NcmBlock, NcmDocument, NcmProvider, NcmReferencesProvider, PageBreakerBlock, ParagraphBlock, ReferenceMarker, SanitizedHtmlBlock, SpoilerBlock, TableBlock, TaskListBlock, blockDataAttributes, blockKey, cn, computeReferenceBases, defaultRenderers, parseInline, renderBeelineText, renderBionicText, renderReadingText, useBlockReferenceScope, useBlockRenderer, useCustomCodeRenderer, useNcmConfig };
+export { AdmonitionBlock, AsideBlock, AttributionBlock, BlockReferenceScope, BlockShell, BlockquoteBlock, ChartBlock, ChildBlocks, CodeBlock, ContainerBlock, CustomCodeBlock, DataviewBlock, DefinitionBlock, EmbeddingBlock, FigureBlock, FootnoteBlock, FrontmatterBlock, HeaderBlock, HorizontalRuleBlock, HtmlBlock, InertReferenceScope, InlineContent, LatexDisplayBlock, LinkBlock, ListBlock, MathBlock, MermaidBlock, NcmBlock, NcmBlockPreview, NcmDocument, NcmProvider, NcmReferencesProvider, PageBreakerBlock, ParagraphBlock, ReferenceMarker, SanitizedHtmlBlock, SpoilerBlock, TableBlock, TaskListBlock, blockDataAttributes, blockKey, cn, computeReferenceBases, defaultRenderers, parseInline, renderBeelineText, renderBionicText, renderReadingText, useBlockReferenceScope, useBlockRenderer, useCustomCodeRenderer, useNcmConfig };