@haklex/rich-litexml 0.36.1 → 0.37.0

package/.claude/skills/litexml-authoring/SKILL.md

@@ -55,6 +55,7 @@ Detailed `When` / `Avoid when` / params / body rules for each tag live in [`node
 | Paragraph, heading, list, table, link, inline format   | `<p>` / `<h*>` / `<ul>` / `<ol>` / `<table>` / `<a>` / `<b>` / `<code>` / … | structural |
 | Quote (with optional `attribution`)                    | `<blockquote>`                                                              | structural |
 | Single image / multi-image / video / embed / link card | `<img>` / `<gallery>` / `<video>` / `<embed>` / `<link-card>`               | extensions |
+| Downloadable file attachment                           | `<attachment>`                                                              | extensions |
 | Code (single / multi-file)                             | `<codeblock>` / `<code-snippet>`                                            | extensions |
 | Diagram (Mermaid / opaque)                             | `<mermaid>` / `<excalidraw>`                                                | extensions |
 | Math (inline / block)                                  | `<math>` / `<math display="block">`                                         | extensions |

package/.claude/skills/litexml-authoring/references/nodes-extensions.md

@@ -37,6 +37,18 @@ Every block-level extension may carry `id="..."` → `$.blockId`. Omit for fresh
 <video src="/clip.mp4" poster="/thumb.jpg" />
 ```
 
+### `<attachment>` — file attachment
+
+- **When**: A downloadable file attachment (PDF, archive, document).
+- **Avoid when**: Image — use `<img>`. Playable video — use `<video>`. A code file inside `<code-snippet>` — that is the unrelated `<file>` child tag.
+- **Required**: `src`, `name` (display file name).
+- **Optional**: `id`, `size` (bytes), `mime-type`, `ext` (lowercase extension shown on the card), `display` (`inline` for an in-text chip; omit for a block card).
+- **Body**: self-closing.
+
+```xml
+<attachment src="/spec.pdf" name="design-spec.pdf" size="2457600" mime-type="application/pdf" ext="pdf" />
+```
+
 ### `<link-card>` — rich link preview
 
 - **When**: A standalone reference URL that deserves a visible card (title, description, favicon, hero image).

package/dist/browser.mjs

@@ -1,4 +1,4 @@
-import { a as createDefaultRegistry, c as LitexmlRegistry, d as registerParseHTML, i as deserializeNodesFromXml, l as registerCustomReaders, n as serializeToXml, o as registerCustomWriters, r as deserializeFromXml, s as registerBuiltinWriters, t as serializeNodesToXml, u as registerBuiltinReaders } from "./src-D8TqVnUb.js";
+import { a as createDefaultRegistry, c as LitexmlRegistry, d as registerParseHTML, i as deserializeNodesFromXml, l as registerCustomReaders, n as serializeToXml, o as registerCustomWriters, r as deserializeFromXml, s as registerBuiltinWriters, t as serializeNodesToXml, u as registerBuiltinReaders } from "./src-h5Q0X5zw.js";
 //#region src/index-browser.ts
 registerParseHTML((html) => new DOMParser().parseFromString(html, "text/html"));
 //#endregion

package/dist/node.mjs

@@ -1,4 +1,4 @@
-import { a as createDefaultRegistry, c as LitexmlRegistry, d as registerParseHTML, i as deserializeNodesFromXml, l as registerCustomReaders, n as serializeToXml, o as registerCustomWriters, r as deserializeFromXml, s as registerBuiltinWriters, t as serializeNodesToXml, u as registerBuiltinReaders } from "./src-D8TqVnUb.js";
+import { a as createDefaultRegistry, c as LitexmlRegistry, d as registerParseHTML, i as deserializeNodesFromXml, l as registerCustomReaders, n as serializeToXml, o as registerCustomWriters, r as deserializeFromXml, s as registerBuiltinWriters, t as serializeNodesToXml, u as registerBuiltinReaders } from "./src-h5Q0X5zw.js";
 import { parseHTML } from "linkedom";
 //#region src/index-node.ts
 registerParseHTML((html) => parseHTML(html).document);

package/dist/readers/custom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/readers/custom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA0FnD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CA6erE"}
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/readers/custom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA0FnD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CA6frE"}

package/dist/{src-D8TqVnUb.js → src-h5Q0X5zw.js}

@@ -247,6 +247,17 @@ function registerCustomReaders(registry) {
 		height: numAttr(el, "height"),
 		version: 1
 	}));
+	registry.registerReader("attachment", (el) => ({
+		type: "file",
+		...extractBlockId(el),
+		src: el.getAttribute("src") ?? "",
+		name: el.getAttribute("name") ?? "",
+		size: numAttr(el, "size"),
+		mimeType: el.getAttribute("mime-type") ?? void 0,
+		ext: el.getAttribute("ext") ?? void 0,
+		display: el.getAttribute("display") === "inline" ? "inline" : "block",
+		version: 1
+	}));
 	registry.registerReader("link-card", (el) => ({
 		type: "link-card",
 		...extractBlockId(el),
@@ -733,6 +744,22 @@ function registerCustomWriters(registry) {
 			selfClosing: true
 		};
 	});
+	registry.registerWriter("file", (node) => {
+		const n = node;
+		return {
+			tag: "attachment",
+			attrs: optAttr({
+				...blockId(n),
+				"src": n.src,
+				"name": n.name,
+				"size": n.size != null ? String(n.size) : void 0,
+				"mime-type": n.mimeType,
+				"ext": n.ext,
+				"display": n.display === "inline" ? "inline" : void 0
+			}),
+			selfClosing: true
+		};
+	});
 	registry.registerWriter("link-card", (node) => {
 		const n = node;
 		return {

package/dist/writers/custom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/writers/custom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAenD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAmWrE"}
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/writers/custom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAenD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAoXrE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haklex/rich-litexml",
-  "version": "0.36.1",
+  "version": "0.37.0",
   "description": "Bidirectional Lexical SerializedNode <-> XML conversion with plugin registry",
   "repository": {
     "type": "git",
@@ -11,20 +11,25 @@
   "type": "module",
   "exports": {
     ".": {
-      "browser": "./src/index-browser.ts",
-      "node": "./src/index-node.ts",
-      "default": "./src/index-node.ts"
+      "browser": {
+        "import": "./dist/browser.mjs",
+        "types": "./dist/index-browser.d.ts"
+      },
+      "node": {
+        "import": "./dist/node.mjs",
+        "types": "./dist/index-node.d.ts"
+      },
+      "default": {
+        "import": "./dist/node.mjs",
+        "types": "./dist/index-node.d.ts"
+      }
     }
   },
-  "main": "./src/index-node.ts",
+  "main": "./dist/node.mjs",
   "files": [
     ".claude/skills/litexml-authoring",
     "dist"
   ],
-  "scripts": {
-    "build": "vite build && node -e \"const fs=require('node:fs');fs.rmSync('.claude',{recursive:true,force:true});fs.cpSync('../../.claude/skills/litexml-authoring','.claude/skills/litexml-authoring',{recursive:true})\"",
-    "dev:build": "vite build --watch"
-  },
   "dependencies": {
     "lexical": "^0.49.0",
     "linkedom": "^0.18.13",
@@ -36,24 +41,11 @@
     "vite": "^8.2.2"
   },
   "publishConfig": {
-    "access": "public",
-    "exports": {
-      ".": {
-        "browser": {
-          "import": "./dist/browser.mjs",
-          "types": "./dist/index-browser.d.ts"
-        },
-        "node": {
-          "import": "./dist/node.mjs",
-          "types": "./dist/index-node.d.ts"
-        },
-        "default": {
-          "import": "./dist/node.mjs",
-          "types": "./dist/index-node.d.ts"
-        }
-      }
-    },
-    "main": "./dist/node.mjs",
-    "types": "./dist/index-node.d.ts"
-  }
-}
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build && node -e \"const fs=require('node:fs');fs.rmSync('.claude',{recursive:true,force:true});fs.cpSync('../../.claude/skills/litexml-authoring','.claude/skills/litexml-authoring',{recursive:true})\"",
+    "dev:build": "vite build --watch"
+  },
+  "types": "./dist/index-node.d.ts"
+}