@uniweb/semantic-parser 1.1.11 → 1.1.13

package/README.md

@@ -229,6 +229,29 @@ Bracketed spans (`[text]{.class}`) are converted to `<span>` elements with their
 
 Spans can have classes, IDs, and custom attributes. They combine with other marks—a span with bold becomes `<strong><span class="...">text</span></strong>`.
 
+### Inline Insets and Cross-references
+
+The parser handles inline `inset_placeholder` nodes — generated by
+`@uniweb/build`'s content collector when it pulls
+`![alt](@Component){k=v}`, `[text](@Component){k=v}`, `[@key]{k=v}`,
+or `[#id]{k=v}` references out of paragraph content. Two artifacts
+ship to consumers:
+
+1. **`children` carries an `inset` entry per placeholder** — each
+   carrying the `refId` and `embedKind` (`'text'` for textual sugars
+   like `[@key]` / `[#id]` / `[text](@Component)`; `'visual'` for
+   `![alt](@Component)`). Renderers that walk `paragraph.children`
+   pick these up alongside icons, math, and links.
+
+2. **`text` carries a `<uniweb-inset data-ref-id="…"></uniweb-inset>`
+   marker** at the placeholder position — useful for renderers that
+   read `paragraph.text` as a flat HTML string (kit's `<Prose>` is the
+   canonical example; it splits on the marker and intersperses
+   React-rendered insets via the framework's child-block renderer).
+
+The two views stay in lockstep — both record every inline inset the
+parser sees, in source order.
+
 ## Use Cases
 
 - **Component-based websites**: Extract structured data for React/Vue components

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/semantic-parser",
-  "version": "1.1.11",
+  "version": "1.1.13",
   "description": "Semantic parser for ProseMirror/TipTap content structures",
   "type": "module",
   "main": "./src/index.js",

package/src/processors/sequence.js

@@ -404,6 +404,17 @@ function getTextContent(content, options = {}) {
                 // dangerouslySetInnerHTML. The HTML5 parser handles <math>
                 // as MathML natively — zero runtime math library needed.
                 return prev + (curr.attrs?.mathml || "");
+            } else if (type === "inset_placeholder") {
+                // Inline inset (e.g. a `[@key]{...}` cite). Emit a marker
+                // tag the renderer can split on; the actual inset is
+                // rendered via React from `block.getInset(refId)`. The
+                // paragraph's `children` array also carries an ordered
+                // record of inset entries (see processInlineElements) so
+                // consumers that don't want to substring-walk the HTML
+                // have an alternative path.
+                const refId = curr.attrs?.refId;
+                if (!refId) return prev;
+                return prev + `<uniweb-inset data-ref-id="${refId}"></uniweb-inset>`;
             } else if (type === "hardBreak") {
                 return prev + "<br>";
             } else {
@@ -425,8 +436,18 @@ function processInlineElements(content) {
                 type: "icon",
                 attrs: parseUniwebIcon(item.attrs),
             });
-        } else if (item.type === "math-inline") {
+        } else if (item.type === "math-inline" || item.type === "math_inline") {
             items.push(item);
+        } else if (item.type === "inset_placeholder") {
+            // Inline inset (e.g., a `[@key]{...}` cite or a mid-prose
+            // visual inset). The Render path looks the actual block up
+            // via block.getInset(refId); we just carry the marker here so
+            // its position in the text flow is preserved.
+            items.push({
+                type: "inset",
+                refId: item.attrs?.refId,
+                embedKind: item.attrs?.embedKind || "visual",
+            });
         } else if (item.type === "text" && item.marks) {
             // Extract links from text nodes with link marks
             const linkMark = item.marks.find((m) => m.type === "link");
@@ -618,16 +639,24 @@ function parseVideoBlock(itemAttrs) {
 function stripTags(htmlString) {
     if (!htmlString || typeof htmlString !== "string") return "";
 
-    // Remove HTML tags using regular expression
+    // Remove HTML tags using regular expression.
     const plainString = htmlString.replace(/<[^>]*>/g, "");
 
-    // Decode HTML entities
-    const decodedString = new DOMParser().parseFromString(
-        plainString,
-        "text/html"
-    ).body.textContent;
-
-    return decodedString;
+    // Decode the HTML entity subset citestyle / content-reader / kit emit.
+    // The previous DOMParser-based path covered every entity in the spec,
+    // but DOMParser is browser-only and crashes Node SSR (which the
+    // unipress compile pipeline runs in). The regex below covers the
+    // entities that actually appear in this codebase's emitted HTML.
+    return plainString
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&apos;/g, "'")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(Number(n)))
+        .replace(/&#x([0-9a-fA-F]+);/g, (_, n) => String.fromCharCode(parseInt(n, 16)));
 }
 
 function isLink(item) {