@jxsuite/parser 1.5.6 → 1.7.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/dist/csv.js

@@ -116,6 +116,101 @@ function parseCSV(csv) {
   }
   return rows;
 }
+function scanRows(csv) {
+  const rows = [];
+  let start = 0;
+  let inQuotes = false;
+  for (let i = 0;i < csv.length; i++) {
+    const ch = csv[i];
+    if (ch === '"') {
+      if (inQuotes && csv[i + 1] === '"') {
+        i += 1;
+      } else {
+        inQuotes = !inQuotes;
+      }
+    } else if ((ch === `
+` || ch === "\r" && csv[i + 1] === `
+`) && !inQuotes) {
+      rows.push({ end: i, start });
+      if (ch === "\r") {
+        i += 1;
+      }
+      start = i + 1;
+    }
+  }
+  if (csv.slice(start).trim()) {
+    rows.push({ end: csv.length, start });
+  }
+  return rows;
+}
+function scanRowFields(csv, row, span) {
+  const line = csv.slice(span.start, span.end);
+  const fields = [];
+  let fieldStart = 0;
+  let value = "";
+  let inQuotes = false;
+  for (let i = 0;i < line.length; i++) {
+    const ch = line[i];
+    if (ch === '"') {
+      if (inQuotes && line[i + 1] === '"') {
+        value += '"';
+        i += 1;
+      } else {
+        inQuotes = !inQuotes;
+      }
+    } else if (ch === "," && !inQuotes) {
+      fields.push({
+        end: span.start + i,
+        row,
+        start: span.start + fieldStart,
+        value: value.trim()
+      });
+      value = "";
+      fieldStart = i + 1;
+    } else {
+      value += ch;
+    }
+  }
+  fields.push({ end: span.end, row, start: span.start + fieldStart, value: value.trim() });
+  return fields;
+}
+function scanFields(csv) {
+  return scanRows(csv).flatMap((span, row) => scanRowFields(csv, row, span));
+}
+function encodeField(raw, value) {
+  const lead = raw.slice(0, raw.length - raw.trimStart().length);
+  const trail = raw.slice(raw.trimEnd().length);
+  const core = raw.trim();
+  const wasQuoted = core.length >= 2 && core.startsWith('"') && core.endsWith('"');
+  const mustQuote = /["\r\n,]/.test(value) || value.trim() !== value;
+  return lead + (wasQuoted || mustQuote ? `"${value.replaceAll('"', '""')}"` : value) + trail;
+}
+function rewriteCSV(source, edits) {
+  const replacements = new Map;
+  for (const edit of edits) {
+    if (edit.from !== edit.to) {
+      replacements.set(edit.from, edit.to);
+    }
+  }
+  if (replacements.size === 0) {
+    return source;
+  }
+  let out = "";
+  let cursor = 0;
+  for (const field of scanFields(source)) {
+    if (field.row === 0) {
+      continue;
+    }
+    const to = replacements.get(field.value);
+    if (to === undefined) {
+      continue;
+    }
+    out += source.slice(cursor, field.start);
+    out += encodeField(source.slice(field.start, field.end), to);
+    cursor = field.end;
+  }
+  return out + source.slice(cursor);
+}
 function coerceCSVRows(rows, schema, idField) {
   return rows.map((row, i) => {
     const data = { ...row };
@@ -154,6 +249,9 @@ class Csv {
   static parse(source, options = {}) {
     return coerceCSVRows(parseCSV(source), options.schema, options.idField);
   }
+  static rewrite(source, edits = []) {
+    return rewriteCSV(source, edits);
+  }
   static async discover(source, options = {}) {
     const { existsSync, readdirSync } = await import("node:fs");
     const { resolve, extname } = await import("node:path");
@@ -191,5 +289,6 @@ class Csv {
 export {
   Csv,
   coerceCSVRows,
-  parseCSV
+  parseCSV,
+  rewriteCSV
 };