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

package/dist/blocks/footnote/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 })
@@ -1191,7 +1238,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 })
@@ -1229,7 +1277,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 }
       }
     );
@@ -1244,7 +1292,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 })
     }
   );
@@ -1268,10 +1316,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,
@@ -1283,6 +1333,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;
@@ -1299,7 +1352,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);
@@ -1309,7 +1362,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);
     }
@@ -1359,7 +1412,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 }
       }
     );
@@ -1375,7 +1428,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 })
@@ -1393,7 +1447,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 })
@@ -1454,7 +1509,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) => {
@@ -1468,6 +1523,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",
       {
@@ -1494,7 +1550,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
@@ -1539,7 +1595,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
       )
     },
@@ -1595,7 +1651,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/frontmatter/index.d.ts

@@ -1,7 +1,6 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { FrontmatterBlock as FrontmatterBlock$1 } from '@nuucognition/ncm';
 import { a as BlockRendererProps } from '../../renderers-C5f41FCy.js';
-import 'react';
 
 type FrontmatterBlockProps = BlockRendererProps<FrontmatterBlock$1>;
 /**
@@ -11,6 +10,6 @@ type FrontmatterBlockProps = BlockRendererProps<FrontmatterBlock$1>;
  * is a neutral default so the block is never silently dropped. Override the
  * `frontmatter` renderer key to hide it or render a richer header.
  */
-declare function FrontmatterBlock({ block, className }: FrontmatterBlockProps): react_jsx_runtime.JSX.Element;
+declare function FrontmatterBlock({ block, className }: FrontmatterBlockProps): react.JSX.Element;
 
 export { FrontmatterBlock, type FrontmatterBlockProps };

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

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

package/dist/blocks/header/index.js

@@ -468,9 +468,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
@@ -504,10 +505,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
@@ -538,6 +542,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",
         {
@@ -556,6 +576,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;

package/dist/blocks/horizontal-rule/index.d.ts

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

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

@@ -1,7 +1,6 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { HtmlBlock as HtmlBlock$1 } from '@nuucognition/ncm';
 import { a as BlockRendererProps } from '../../renderers-C5f41FCy.js';
-import 'react';
 
 type HtmlBlockProps = BlockRendererProps<HtmlBlock$1>;
 interface SanitizedHtmlBlockProps extends HtmlBlockProps {
@@ -19,13 +18,13 @@ interface SanitizedHtmlBlockProps extends HtmlBlockProps {
  * a sanitization step override the `html` renderer key to inject trusted
  * markup.
  */
-declare function HtmlBlock({ block, className }: HtmlBlockProps): react_jsx_runtime.JSX.Element;
+declare function HtmlBlock({ block, className }: HtmlBlockProps): react.JSX.Element;
 /**
  * Opt-in HTML renderer for consumers that want sanitized HTML injection.
  *
  * `HtmlBlock` remains the safe default and renders source as text. Use this
  * renderer as an explicit `html` override when your surface supports HTML.
  */
-declare function SanitizedHtmlBlock({ block, className, rawHtml, allowDataImages, }: SanitizedHtmlBlockProps): react_jsx_runtime.JSX.Element;
+declare function SanitizedHtmlBlock({ block, className, rawHtml, allowDataImages, }: SanitizedHtmlBlockProps): react.JSX.Element;
 
 export { HtmlBlock, type HtmlBlockProps, SanitizedHtmlBlock, type SanitizedHtmlBlockProps };

package/dist/blocks/html/index.js

@@ -18,7 +18,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 })

package/dist/blocks/index.d.ts

@@ -26,7 +26,6 @@ export { ParagraphBlock, ParagraphBlockProps } from './paragraph/index.js';
 export { SpoilerBlock, SpoilerBlockProps } from './spoiler/index.js';
 export { TableBlock, TableBlockProps } from './table/index.js';
 export { TaskListBlock, TaskListBlockProps } from './task-list/index.js';
-import 'react/jsx-runtime';
+import 'react';
 import '@nuucognition/ncm';
 import '../renderers-C5f41FCy.js';
-import 'react';