@entropicwarrior/sdoc 0.2.3 → 0.2.5

package/docs/reference/sdoc-authoring.sdoc

@@ -265,6 +265,15 @@ Content of Section B.
             ```
 
             Width: \`auto\` (shrink to content), \`NN%\` (percentage), or \`NNpx\` (pixels). Default is 100%. Alignment: \`left\` (default), \`center\`, or \`right\`. All flags compose freely in any order.
+
+            To include a literal \`|\` in a cell (e.g. for math), escape it with \`\\|\`:
+
+            ```
+            {[table]
+                Expression | Value
+                \|x\| + \|y\| | 8
+            }
+            ```
         }
 
         # Inline Formatting @inline-formatting
@@ -470,7 +479,7 @@ Content of Section B.
         {
             Backslash escapes special characters: \`\\\\\` \`\\{\` \`\\}\` \`\\@\`
             \`\\[\` \`\\]\` \`\\(\` \`\\)\` \`\\*\` \`\\~\` \`\\#\` \`\\!\` \`\\\<\`
-            \`\\\>\` \`\\\$\` \`\\+\` \`\\=\` \`\\-\` \`\\^\` \`\\?\`
+            \`\\\>\` \`\\\$\` \`\\+\` \`\\=\` \`\\-\` \`\\^\` \`\\?\` \`\\|\`
 
             A line starting with \`\\#\` renders as a literal \`#\` (not a heading). Use \`\\\$\` to prevent a dollar sign from starting math mode.
         }

package/lexica/specification.sdoc

@@ -510,11 +510,11 @@ Content of Section B.
 
         # Escaping @escaping
         {
-            In normal text (including headings and paragraphs), a backslash escapes: `\\` `\{` `\}` `\@` `\[` `\]` `\(` `\)` `\*` `\~` `\#` `\!` `\<` `\>` `\$` `\+` `\=` `\-` `\^` `\?` and `` \` ``.
+            In normal text (including headings and paragraphs), a backslash escapes: `\\` `\{` `\}` `\@` `\[` `\]` `\(` `\)` `\*` `\~` `\#` `\!` `\<` `\>` `\$` `\+` `\=` `\-` `\^` `\?` `\|` and `` \` ``.
 
             Escapes are processed before reference detection.
 
-            If a line begins with `\#`, it is treated as a normal paragraph line (rendered with a literal `#`). If a line begins with `\>`, it is treated as a normal paragraph line (rendered with a literal `>`). Use `\$` to prevent a dollar sign from starting math mode.
+            If a line begins with `\#`, it is treated as a normal paragraph line (rendered with a literal `#`). If a line begins with `\>`, it is treated as a normal paragraph line (rendered with a literal `>`). Use `\$` to prevent a dollar sign from starting math mode. Use `\|` to include a literal pipe character inside a table cell without it being treated as a column delimiter.
         }
 
         # Code Blocks @code-blocks

package/package.json

@@ -2,7 +2,7 @@
   "name": "@entropicwarrior/sdoc",
   "displayName": "SDOC",
   "description": "A plain-text documentation format with explicit brace scoping — deterministic parsing, AI-agent efficiency, and 10-50x token savings vs Markdown.",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "publisher": "entropicwarrior",
   "license": "MIT",
   "repository": {

package/src/sdoc.js

@@ -13,7 +13,7 @@ const COMMAND_LIST_NUMBER = "{[#]";
 const COMMAND_TABLE = "{[table]";
 const COMMAND_CODE_FENCE = "```";
 
-const ESCAPABLE = new Set(["\\", "{", "}", "@", "[", "]", "(", ")", "*", "`", "#", "!", "~", "<", ">", "$", "+", "=", "-", "^", "?"]);
+const ESCAPABLE = new Set(["\\", "{", "}", "@", "[", "]", "(", ")", "*", "`", "#", "!", "~", "<", ">", "$", "+", "=", "-", "^", "?", "|"]);
 
 let _katex = null;
 let _katexLoaded = false;
@@ -797,7 +797,7 @@ function parseTableBody(cursor, tableStartLine, options) {
       break;
     }
 
-    const cells = trimmed.split("|").map((cell) => cell.trim());
+    const cells = trimmed.split(/(?<!\\)\|/).map((cell) => cell.trim().replace(/\\\|/g, "|"));
     rows.push(cells);
     cursor.next();
   }
@@ -1309,7 +1309,35 @@ function parseInline(text) {
       }
     }
 
-    if (ch === "@" && next && isIdentStart(next)) {
+    // Bare email autolink: local@domain.tld
+    if (ch === "@" && next && /[A-Za-z0-9]/.test(next)) {
+      const prevCh = i > 0 ? text[i - 1] : "";
+      if (/[A-Za-z0-9._+-]/.test(prevCh)) {
+        // Scan forward for domain part (letters, digits, dots, hyphens)
+        let j = i + 1;
+        while (j < text.length && /[A-Za-z0-9.-]/.test(text[j])) j++;
+        // Strip trailing dots/hyphens
+        while (j > i + 1 && /[.-]/.test(text[j - 1])) j--;
+        const domain = text.slice(i + 1, j);
+        // Must have at least one dot with content on both sides
+        if (/^[A-Za-z0-9]([A-Za-z0-9-]*\.)+[A-Za-z]{2,}$/.test(domain)) {
+          // Extract local part from buffer
+          let k = buffer.length;
+          while (k > 0 && /[A-Za-z0-9._+\-]/.test(buffer[k - 1])) k--;
+          const local = buffer.slice(k);
+          if (local.length > 0) {
+            buffer = buffer.slice(0, k);
+            const email = local + "@" + domain;
+            flush();
+            nodes.push({ type: "link", href: "mailto:" + email, children: [{ type: "text", value: email }] });
+            i = j;
+            continue;
+          }
+        }
+      }
+    }
+
+    if (ch === "@" && next && isIdentStart(next) && !(i > 0 && /[A-Za-z0-9._+-]/.test(text[i - 1]))) {
       let j = i + 1;
       while (j < text.length && isIdentChar(text[j])) {
         j += 1;