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

package/dist/inline/index.d.ts

@@ -1,7 +1,7 @@
 import { b as InlineToken } from '../inline-DwUYUmk4.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { ReactNode } from 'react';
-import { d as ReferenceKind } from '../references-Bs5wJybr.js';
+import { d as ReferenceKind } from '../references-BYW5pnj_.js';
 import '@nuucognition/ncm';
 
 /**
@@ -41,7 +41,7 @@ interface InlineContentProps {
  * Emits semantic HTML and `data-ncm-token` attributes; visual styling is owned
  * by the parent document's stylesheet (nuu.css or paper.css).
  */
-declare function InlineContent({ content, className, disableBionic, disableBeeline, }: InlineContentProps): react_jsx_runtime.JSX.Element;
+declare function InlineContent({ content, className, disableBionic, disableBeeline, }: InlineContentProps): react.JSX.Element;
 interface RenderReadingTextOptions {
     bionic?: boolean;
     bionicRatio?: number;
@@ -103,6 +103,6 @@ interface ReferenceMarkerProps {
  * so it never spills outside the reading pane — measured lazily, only for the
  * marker actually being hovered/focused, so the common case stays JS-free.
  */
-declare function ReferenceMarker({ kind, number, children }: ReferenceMarkerProps): react_jsx_runtime.JSX.Element;
+declare function ReferenceMarker({ kind, number, children }: ReferenceMarkerProps): react.JSX.Element;
 
 export { InlineContent, type InlineContentProps, ReferenceMarker, type ReferenceMarkerProps, type RenderReadingTextOptions, parseInline, renderBeelineText, renderBionicText, renderReadingText };

package/dist/inline/index.js

@@ -1,5 +1,5 @@
 "use client";
-import { createContext, useId, useRef, useCallback, useMemo, useContext, useState, useEffect } from 'react';
+import { createContext, useId, useRef, useCallback, useMemo, useState, useEffect, useContext } from 'react';
 import { extractExtension, embedTypeFromExtension } from '@nuucognition/mesh-core';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import '@nuucognition/ncm';
@@ -466,9 +466,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
@@ -502,10 +503,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
@@ -536,6 +540,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",
         {
@@ -554,6 +574,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/lib/defaults.js

@@ -22,7 +22,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/{references-Bs5wJybr.d.ts → references-BYW5pnj_.d.ts}

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { ReactNode } from 'react';
 import { Block } from '@nuucognition/ncm';
 
@@ -37,7 +37,7 @@ interface NcmReferencesProviderProps {
     children: ReactNode;
 }
 /** Document-root provider — runs the numbering pre-pass over `blocks`. */
-declare function NcmReferencesProvider({ blocks, children }: NcmReferencesProviderProps): react_jsx_runtime.JSX.Element;
+declare function NcmReferencesProvider({ blocks, children }: NcmReferencesProviderProps): react.JSX.Element;
 interface BlockReferenceScopeProps {
     /** Block id; resolves the base offset from the document pre-pass. */
     blockId?: string;
@@ -48,7 +48,7 @@ interface BlockReferenceScopeProps {
  * 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;
+declare function BlockReferenceScope({ blockId, children }: BlockReferenceScopeProps): react.JSX.Element;
 /** Read the active per-block reference scope, if any. */
 declare function useBlockReferenceScope(): BlockReferenceScopeValue | null;
 /**
@@ -58,6 +58,6 @@ declare function useBlockReferenceScope(): BlockReferenceScopeValue | null;
  */
 declare function InertReferenceScope({ children }: {
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.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 };