@jxsuite/parser 1.5.6 → 1.6.0

package/README.md

@@ -1,6 +1,6 @@
 # `@jxsuite/parser`
 
-> Content & Markdown extension for Jx — file-based content collections with Markdown and CSV formats.
+> Content & Markdown extension for Jx: file-based content collections with Markdown and CSV formats.
 
 ## Overview
 
@@ -23,7 +23,7 @@ Built on the [`unified`](https://unifiedjs.com/) / remark ecosystem.
 bun add @jxsuite/parser
 ```
 
-Registration is manifest-based — add the package to `project.json`:
+Registration is manifest-based. Add the package to `project.json`:
 
 ```json
 {
@@ -31,7 +31,7 @@ Registration is manifest-based — add the package to `project.json`:
 }
 ```
 
-That one entry registers the `.md`/`.csv` formats, the `content` project section, and the classes: `$prototype: "ContentEntry"` (etc.) resolves by name through the project's extension registry — no `$src` or imports wiring. There are no implicit defaults: a project without the extension supports only `.json` documents.
+That one entry registers the `.md`/`.csv` formats, the `content` project section, and the classes: `$prototype: "ContentEntry"` (etc.) resolves by name through the project's extension registry, with no `$src` or imports wiring. There are no implicit defaults: a project without the extension supports only `.json` documents.
 
 ## Content collections
 
@@ -79,10 +79,10 @@ Query them from any page or component:
 
 One class carries every format capability:
 
-- **static `parse`** — Jx Markdown source → Jx document (browser-safe; Studio opens `.md` files with it)
-- **static `serialize`** — Jx document → markdown, `roundtrip` (lossless, default) or `export` (lossy clean markdown)
-- **static `discover` / `load`** — compile-time content access: frontmatter → `data`, source preserved as `body`, parsed `$children`, and `_meta` (excerpt, toc, reading time, word count)
-- **instance `resolve`** — runtime on-demand access for a `$prototype: "Markdown"` state entry
+- **static `parse`**: Jx Markdown source → Jx document (browser-safe; Studio opens `.md` files with it)
+- **static `serialize`**: Jx document → markdown, `roundtrip` (lossless, default) or `export` (lossy clean markdown)
+- **static `discover` / `load`** give compile-time content access: frontmatter → `data`, source preserved as `body`, parsed `$children`, and `_meta` (excerpt, toc, reading time, word count)
+- **instance `resolve`**: runtime on-demand access for a `$prototype: "Markdown"` state entry
 
 ```json
 {
@@ -107,7 +107,7 @@ One class carries every format capability:
 
 ### Directives
 
-`:::name{attrs}` container syntax converts directly to Jx element nodes — `:::my-card{title="Hello"}` becomes a `my-card` element with its attributes routed to the right Jx locations (props, `$`-annotations, styles). Capitalized directives (e.g. `:::Array`) become tagName-less `$prototype` nodes. A content type's `$elements` list declares which components its entries may use.
+`:::name{attrs}` container syntax converts directly to Jx element nodes. `:::my-card{title="Hello"}` becomes a `my-card` element with its attributes routed to the right Jx locations (props, `$`-annotations, styles). Capitalized directives (e.g. `:::Array`) become tagName-less `$prototype` nodes. A content type's `$elements` list declares which components its entries may use.
 
 ## `Csv`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jxsuite/parser",
-  "version": "1.5.6",
+  "version": "1.6.0",
   "description": "Jx markdown parser and external class integration",
   "license": "MIT",
   "repository": {
@@ -45,11 +45,11 @@
     "build:metafile": "bun build src/content.ts src/content-loader.ts src/markdown.ts src/csv.ts src/serialize.ts --outdir=dist --format=esm --target=node --metafile=metafile.json",
     "test": "bun test --isolate",
     "test:coverage": "bun test --isolate --coverage",
-    "upgrade": "bunx npm-check-updates -u && bun install"
+    "upgrade": "bun update --latest && bun install"
   },
   "dependencies": {
-    "@jxsuite/markup": "^0.4.7",
-    "@jxsuite/schema": "^1.9.0",
+    "@jxsuite/markup": "^0.4.8",
+    "@jxsuite/schema": "^2.0.0",
     "@shikijs/langs": "^4.4.3",
     "@shikijs/themes": "^4.4.3",
     "glob": "^13.0.6",
@@ -66,8 +66,8 @@
     "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@happy-dom/global-registrator": "^20.11.6",
-    "@jxsuite/runtime": "^2.1.0",
+    "@happy-dom/global-registrator": "^20.11.8",
+    "@jxsuite/runtime": "^3.0.0",
     "@types/mdast": "^4.0.4",
     "ajv": "^8.20.0"
   },

package/src/serialize.ts

@@ -4,7 +4,8 @@
  * The single Jx → markdown serializer, replacing the studio's md-convert and the
  * compiler's compile-markdown. Two modes over a shared tag map:
  *
- * - `roundtrip` (default) — lossless: YAML frontmatter from non-children doc keys,
+ * - `roundtrip` (default) — lossless for everything it can express (a `tagName` chosen at render
+ *   time cannot be, and throws): YAML frontmatter from non-children doc keys,
  *   non-markdown elements emitted as remark directives with collapsed dot-path
  *   attributes. Inverse of `transpileJxMarkdown()`.
  * - `export` — lossy: strips all Jx decoration, unwraps wrapper tags, inlines custom
@@ -191,7 +192,7 @@ function codeLang(codeChild: JxElement | undefined): string | null {
 // ─── Options ────────────────────────────────────────────────────────────────
 
 export interface SerializeOptions {
-  /** `roundtrip` (lossless, default) or `export` (lossy clean markdown). */
+  /** `roundtrip` (default; lossless where expressible) or `export` (lossy clean markdown). */
   mode?: "roundtrip" | "export";
   /** Export mode: component definitions for inlining custom elements. */
   componentDefs?: Map<string, JxElement>;