@entropicwarrior/sdoc 0.2.16 → 0.2.18

package/docs/reference/sdoc-authoring.sdoc

@@ -333,6 +333,22 @@ Content of Section B.
 
                     The \`Amount\` column is right-aligned and formatted as currency. The formula result and data cells all display as \`$1,000,000\` style. The \`**Total**\` label renders as bold text.
                 }
+
+                # Copyable Columns
+                {
+                    A \`copy\` token in the directive row gives every body cell in that column a click-to-copy icon (copying the cell's raw text). Ideal for columns of sequences, IDs, or commands.
+
+                    ```
+                    {[table]
+                        Gene | Sequence
+                             | copy
+                        BRCA1 | ACGTACGTGGCA
+                        TP53 | GGCATTACGATT
+                    }
+                    ```
+
+                    \`copy\` can share a directive row with alignment/format directives on other columns.
+                }
             }
 
             # Table Formulas @table-formulas
@@ -385,10 +401,13 @@ Content of Section B.
                 \`\{-text-\}\` | Negative marker (red)
                 \`\{~text~\}\` | Highlight (yellow)
                 \`#1a73e8\` | Hex color swatch (auto-readable text)
+                \`\{copy\}text\{/copy\}\` | Copyable text with click-to-copy icon
             }
 
             Hex color codes (\`#rgb\`, \`#rgba\`, \`#rrggbb\`, \`#rrggbbaa\`) render as inline swatches — a rounded box filled with the color and labelled with the code, with the text color chosen automatically (black or white) for legibility. They are detected in normal text, list items, table cells, and headings, but not inside \`\\\`inline code\\\`\` (which stays literal). A bare \`#\` at the start of a line is a heading; escape with \`\\#\` to keep a literal hash.
 
+            Copyable text: \`\{copy\}ACGTACGTGGCA\{/copy\}\` renders the inner text verbatim in monospace with a copy icon; clicking it copies the text. Great for DNA/protein sequences, IDs, hashes, and commands. Escape with \`\\\{copy\}\` for a literal. Copy icons show in HTML output (preview, exported HTML, web viewer) and are hidden when printed/exported to PDF.
+
             Links: \`[Link text](https://example.com)\` or \`[Other doc](./other-file.sdoc)\`. Relative paths resolve from the document's directory.
 
             Images: \`![Alt text](path/to/image.png)\`

package/lexica/specification.sdoc

@@ -435,9 +435,25 @@ Content of Section B.
                     All numeric values and formula results in the `Amount` column display as currency (`$3,500,000`). The `**Total**` label renders normally as bold text.
                 }
 
+                # Copyable Columns @column-copy
+                {
+                    A `copy` token (case-insensitive) in the directive row marks a column copyable: every body cell in that column is rendered with a click-to-copy icon whose target is the cell's raw text. Useful for sequences, identifiers, hashes, and commands.
+
+                    ```
+{[table]
+    Gene | Sequence
+         | copy
+    BRCA1 | ACGTACGTGGCA
+    TP53 | GGCATTACGATT
+}
+                    ```
+
+                    The `copy` token occupies a directive cell of its own and may coexist with alignment/format directives on other columns in the same row. The literal (unformatted) cell text is copied. Copy icons are interactive HTML only — they appear in preview, exported HTML, and the web viewer, and are hidden in printed/PDF output.
+                }
+
                 # Directive Row Detection @directive-detection
                 {
-                    A row is identified as a directive row when every non-empty cell contains only an alignment character (`<`, `>`, `=`), a format token, or both. It must be the first row after the header (or the first row in a headerless table), and at least one cell must contain a directive.
+                    A row is identified as a directive row when every non-empty cell contains only an alignment character (`<`, `>`, `=`), a format token, the `copy` keyword, or a combination of alignment and format. It must be the first row after the header (or the first row in a headerless table), and at least one cell must contain a directive.
 
                     For headerless tables, the directive row functions as a virtual header — it is consumed for its directives but no `<thead>` is rendered.
                 }
@@ -720,6 +736,7 @@ Content of Section B.
                 - Negative marker: `{-text-}` (red highlight)
                 - Highlight: `{~text~}` (yellow highlight)
                 - Hex color swatch: `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa` (e.g. `#9aa0a8`) renders as a filled inline box labelled with the code
+                - Copyable text: `{copy}...{/copy}` renders the inner text verbatim (monospace) with a click-to-copy icon
                 - Citation reference: `[@key]` (numbered superscript link to citation entry)
                 - Multiple citation references: `[@key1, @key2]` (each individually linked)
             }
@@ -728,6 +745,8 @@ Content of Section B.
 
             Hex color swatches are detected only when the `#` is at the start of the inline text or preceded by a non-alphanumeric character, the digit run is exactly 3, 4, 6, or 8 hexadecimal digits, and it is not immediately followed by another letter, digit, or underscore. The background is the literal color and the text color (black or white) is chosen by perceptual brightness (YIQ); for `#rgba`/`#rrggbbaa` the alpha channel is ignored when choosing the text color. Hex inside `` `inline code` `` stays literal, and a `#` at the start of a line is parsed as a heading (escape with `\#`).
 
+            Copyable text spans from `{copy}` to the next unescaped `{/copy}`. The inner text is captured verbatim — no nested inline formatting is applied — and is both displayed (monospace) and used as the copy target. An unterminated `{copy}` (no closing `{/copy}`) falls through as literal text. Escape with `\{copy}` to write a literal. As with other `{`-delimited constructs, a `{copy}` at the very start of a line is subject to block-level parsing; use it mid-line or within a cell.
+
             Citation references (`[@key]`) are parsed before link syntax. `[@key]` is always a citation reference even if followed by `(url)`. Use `\[@key]` for a literal `[@key]` in text.
         }
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@entropicwarrior/sdoc",
   "displayName": "SDOC - Docs for Human/Agent Teams",
   "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.16",
+  "version": "0.2.18",
   "publisher": "entropicwarrior-msenfin",
   "license": "MIT",
   "repository": {

package/src/sdoc.js

@@ -72,6 +72,7 @@ function isDirectiveRow(cells) {
   for (const cell of cells) {
     const trimmed = cell.trim();
     if (trimmed === "") continue;
+    if (trimmed.toLowerCase() === "copy") { hasDirective = true; continue; }
     if (!pattern.test(trimmed)) return false;
     hasDirective = true;
   }
@@ -102,12 +103,23 @@ function parseFormatSpec(spec) {
 function parseDirectiveRow(cells) {
   const align = [];
   const format = [];
+  const copy = [];
   let hasAlign = false;
   let hasFormat = false;
+  let hasCopy = false;
   const fmtPattern = /(\$(?:\.\d+)?|,(?:\.\d+)?|\.\d+|%(?:\.\d+)?)$/;
 
   for (const cell of cells) {
     const trimmed = cell.trim();
+
+    if (trimmed.toLowerCase() === "copy") {
+      align.push(null);
+      format.push(null);
+      copy.push(true);
+      hasCopy = true;
+      continue;
+    }
+
     const alignMatch = trimmed.match(/^([<>=])/);
     const fmtMatch = trimmed.match(fmtPattern);
 
@@ -124,11 +136,13 @@ function parseDirectiveRow(cells) {
       hasFormat = true;
     }
     format.push(f);
+    copy.push(false);
   }
 
   return {
     align: hasAlign ? align : null,
     format: hasFormat ? format : null,
+    copy: hasCopy ? copy : null,
   };
 }
 
@@ -940,10 +954,12 @@ function parseTableBody(cursor, tableStartLine, options) {
   const directiveIndex = options.headerless ? 0 : 1;
   let columnAlign = null;
   let columnFormat = null;
+  let columnCopy = null;
   if (rows.length > directiveIndex && isDirectiveRow(rows[directiveIndex])) {
     const directives = parseDirectiveRow(rows[directiveIndex]);
     columnAlign = directives.align;
     columnFormat = directives.format;
+    columnCopy = directives.copy;
     rows.splice(directiveIndex, 1);
   }
 
@@ -960,6 +976,7 @@ function parseTableBody(cursor, tableStartLine, options) {
   if (hasOptions) tableNode.options = options;
   if (columnAlign) tableNode.columnAlign = columnAlign;
   if (columnFormat) tableNode.columnFormat = columnFormat;
+  if (columnCopy) tableNode.columnCopy = columnCopy;
   return tableNode;
 }
 
@@ -1429,6 +1446,18 @@ function parseInline(text) {
       }
     }
 
+    // Copyable inline text: {copy}literal text{/copy}. The inner text is copied
+    // verbatim (no nested formatting), rendered monospace with a copy icon.
+    if (text.startsWith("{copy}", i)) {
+      const end = findUnescaped(text, i + 6, "{/copy}");
+      if (end !== -1) {
+        flush();
+        nodes.push({ type: "copyable", value: text.slice(i + 6, end) });
+        i = end + 7; // length of "{/copy}"
+        continue;
+      }
+    }
+
     if (ch === "{") {
       const mc = next;
       let mt = null;
@@ -1821,6 +1850,8 @@ function renderInlineNodes(nodes) {
         }
         case "code":
           return `<code class="sdoc-inline-code">${escapeHtml(node.value)}</code>`;
+        case "copyable":
+          return `<span class="sdoc-copyable"><code class="sdoc-inline-code">${escapeHtml(node.value)}</code><button class="sdoc-copy-btn sdoc-copy-inline" data-copy="${escapeAttr(node.value)}" title="Copy">⧉</button></span>`;
         case "color_swatch":
           return colorSwatchHtml(node.value);
         case "em":
@@ -2304,6 +2335,14 @@ function renderTable(table) {
   const opts = table.options || {};
   const colAlign = table.columnAlign || [];
   const colFormat = table.columnFormat || [];
+  const colCopy = table.columnCopy || [];
+
+  // Copy icon appended to body cells in a `copy` directive column. data-copy
+  // carries the raw cell text so the shared copy handler copies it verbatim.
+  function copyBtn(cell, c) {
+    if (!colCopy[c]) return "";
+    return ` <button class="sdoc-copy-btn sdoc-copy-inline" data-copy="${escapeAttr(cell.trim())}" title="Copy">⧉</button>`;
+  }
   const classes = ["sdoc-table"];
   if (opts.borderless) classes.push("sdoc-table-borderless");
   if (opts.headerless) classes.push("sdoc-table-headerless");
@@ -2343,20 +2382,20 @@ function renderTable(table) {
             }
             const formula = escapeAttr(cell.trim());
             if (result.error) {
-              return `<td class="sdoc-table-td sdoc-formula-error"${style} title="${formula}">${display}</td>`;
+              return `<td class="sdoc-table-td sdoc-formula-error"${style} title="${formula}">${display}${copyBtn(cell, c)}</td>`;
             }
-            return `<td class="sdoc-table-td sdoc-formula-cell"${style} title="${formula}">${display}</td>`;
+            return `<td class="sdoc-table-td sdoc-formula-cell"${style} title="${formula}">${display}${copyBtn(cell, c)}</td>`;
           }
 
           // Apply column format to numeric data cells
           if (fmt) {
             const parsed = parseCellValue(cell);
             if (!isNaN(parsed.value)) {
-              return `<td class="sdoc-table-td"${style}>${escapeHtml(formatNumber(parsed.value, fmt))}</td>`;
+              return `<td class="sdoc-table-td"${style}>${escapeHtml(formatNumber(parsed.value, fmt))}${copyBtn(cell, c)}</td>`;
             }
           }
 
-          return `<td class="sdoc-table-td"${style}>${renderInline(cell)}</td>`;
+          return `<td class="sdoc-table-td"${style}>${renderInline(cell)}${copyBtn(cell, c)}</td>`;
         })
         .join("");
       return `<tr>${cells}</tr>`;
@@ -3052,10 +3091,6 @@ const PRINT_STYLE = `
     position: relative;
   }
   .sdoc-copy-btn {
-    position: absolute;
-    top: 6px;
-    right: 6px;
-    z-index: 1;
     background: transparent;
     border: none;
     border-radius: 4px;
@@ -3063,15 +3098,35 @@ const PRINT_STYLE = `
     font-size: 0.85rem;
     line-height: 1;
     padding: 2px 6px;
+    color: inherit;
+  }
+  .sdoc-code-wrap .sdoc-copy-btn {
+    position: absolute;
+    top: 6px;
+    right: 6px;
+    z-index: 1;
     opacity: 0;
     transition: opacity 0.15s;
   }
   .sdoc-code-wrap:hover .sdoc-copy-btn {
     opacity: 0.75;
   }
-  .sdoc-copy-btn:hover {
+  .sdoc-code-wrap .sdoc-copy-btn:hover {
     opacity: 1 !important;
   }
+  .sdoc-copyable {
+    white-space: nowrap;
+  }
+  .sdoc-copy-inline {
+    font-size: 0.8em;
+    padding: 0 0.15em;
+    opacity: 0.45;
+    vertical-align: baseline;
+    transition: opacity 0.15s;
+  }
+  .sdoc-copy-inline:hover {
+    opacity: 1;
+  }
   @media print {
     html {
       font-size: 80%;
@@ -3110,7 +3165,7 @@ const PRINT_STYLE = `
 
 const COLLAPSE_SCRIPT = `document.addEventListener("click",function(e){if(!e.target.classList.contains("sdoc-toggle"))return;e.stopPropagation();var s=e.target.closest(".sdoc-scope");if(s)s.classList.toggle("sdoc-collapsed")});`;
 
-const COPY_SCRIPT = `document.addEventListener("click",function(e){if(!e.target.classList.contains("sdoc-copy-btn"))return;e.stopPropagation();e.preventDefault();var w=e.target.closest(".sdoc-code-wrap");if(!w)return;var c=w.querySelector("code");if(!c)return;var t=c.textContent;var b=e.target;if(navigator.clipboard){navigator.clipboard.writeText(t).then(function(){b.textContent="\\u2713";setTimeout(function(){b.textContent="\\u29C9"},1500)})}else{var a=document.createElement("textarea");a.value=t;a.style.position="fixed";a.style.opacity="0";document.body.appendChild(a);a.select();document.execCommand("copy");document.body.removeChild(a);b.textContent="\\u2713";setTimeout(function(){b.textContent="\\u29C9"},1500)}});`;
+const COPY_SCRIPT = `document.addEventListener("click",function(e){var b=e.target.closest(".sdoc-copy-btn");if(!b)return;e.stopPropagation();e.preventDefault();var t=b.getAttribute("data-copy");if(t===null){var w=b.closest(".sdoc-code-wrap");if(!w)return;var c=w.querySelector("code");if(!c)return;t=c.textContent}if(navigator.clipboard){navigator.clipboard.writeText(t).then(function(){b.textContent="\\u2713";setTimeout(function(){b.textContent="\\u29C9"},1500)})}else{var a=document.createElement("textarea");a.value=t;a.style.position="fixed";a.style.opacity="0";document.body.appendChild(a);a.select();document.execCommand("copy");document.body.removeChild(a);b.textContent="\\u2713";setTimeout(function(){b.textContent="\\u29C9"},1500)}});`;
 
 const MERMAID_CDN = "https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js";
 const KATEX_CDN_CSS = "https://cdn.jsdelivr.net/npm/katex@0.16/dist/katex.min.css";
@@ -3232,7 +3287,10 @@ function renderHtmlDocumentFromParsed(parsed, title, options = {}) {
   const footerHtml = meta.footerNodes ? renderFragment(meta.footerNodes, 2)
     : meta.footerText ? renderTextParagraphs(meta.footerText)
     : renderTextParagraphs(config.footer);
-  const footerContent = [footerHtml, companyHtml].filter(Boolean).join("\n");
+  // A specific footer (footer: meta, or config.footer) overrides the company
+  // auto-footer so the two do not stack into a doubled footer. The company name
+  // is used only as the fallback footer when no footer text is provided.
+  const footerContent = footerHtml || companyHtml;
 
   const cssBase = options.cssOverride ?? DEFAULT_STYLE;
   const cssAppend = options.cssAppend ? `\n${options.cssAppend}\n${PRINT_STYLE}` : `\n${PRINT_STYLE}`;

package/src/slide-renderer.js

@@ -21,6 +21,9 @@ function renderInlineNodes(nodes) {
           return escapeHtml(node.value);
         case "code":
           return `<code>${escapeHtml(node.value)}</code>`;
+        case "copyable":
+          // Slides have no copy handler; render the literal text as monospace.
+          return `<code>${escapeHtml(node.value)}</code>`;
         case "color_swatch":
           return colorSwatchHtml(node.value);
         case "em":
@@ -319,8 +322,15 @@ function renderSlides(nodes, options = {}) {
     slideScopes = nodes;
   }
 
-  // Filter to scope nodes only (skip stray paragraphs and :comment scopes)
-  const slides = slideScopes.filter((n) => n.type === "scope" && n.scopeType !== "comment");
+  // Filter to scope nodes only (skip stray paragraphs, :comment scopes, and the
+  // reserved @meta / @about metadata scopes — these are document metadata, not slides).
+  const RESERVED_SCOPE_IDS = new Set(["meta", "about"]);
+  const slides = slideScopes.filter(
+    (n) =>
+      n.type === "scope" &&
+      n.scopeType !== "comment" &&
+      !(n.id && RESERVED_SCOPE_IDS.has(n.id.toLowerCase()))
+  );
 
   // Build per-slide footer:
   //   <  CONFIDENTIAL  ---gap---  Company  N/Total  >
@@ -384,7 +394,37 @@ function renderSlides(nodes, options = {}) {
 
   // Structural styles — always injected regardless of theme.
   const structuralCss = `
-.slide { position: relative; }
+/* --- Fixed design box + fit-to-window scaling ---------------------------
+   Slides are laid out at a fixed design size (1280x720 CSS px, which is
+   exactly the 13.333in x 7.5in print page at 96dpi) and then scaled as a
+   whole to fill the window.  This is the standard deck technique: the
+   author's layout is preserved verbatim at every window size, and screen
+   and PDF are the same geometry by construction.
+
+   --sdoc-slide-scale is written by the theme runtime (fitSlidesToWindow in
+   themes/default/theme.js) on load and on resize.  If JS never runs the
+   scale stays 1 and the deck renders at its natural design size, which is
+   the pre-scaling behaviour rather than a broken one.
+
+   Themes must NOT set width/height/max-width/margin on .slide — those come
+   from the design-box variables below.  A theme that wants a different
+   aspect ratio should override --sdoc-slide-w / --sdoc-slide-h on :root
+   (and the @page size in the print block, if PDF output matters). */
+:root {
+  --sdoc-slide-w: 1280px;
+  --sdoc-slide-h: 720px;
+  --sdoc-slide-scale: 1;
+}
+.slide {
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  width: var(--sdoc-slide-w);
+  height: var(--sdoc-slide-h);
+  transform: translate(-50%, -50%) scale(var(--sdoc-slide-scale));
+  transform-origin: center center;
+  overflow: hidden;
+}
 .slide-footer {
   position: absolute; bottom: 20px; left: 32px; right: 32px;
   display: flex; align-items: baseline;
@@ -430,7 +470,14 @@ function renderSlides(nodes, options = {}) {
     opacity: 1 !important;
     pointer-events: auto !important;
     page-break-after: always; break-after: page;
-    width: 100vw; height: 100vh; max-width: none;
+    /* The design box IS the page (1280x720px == 13.333in x 7.5in @96dpi),
+       so no fit-to-window scaling applies here — each slide flows as one
+       page at its natural size.  Overflowing content is still shrunk by
+       the inner .slide-content-scale wrapper (see fitSlidesForPrint). */
+    top: auto !important; left: auto !important;
+    transform: none !important;
+    margin: 0 !important;
+    width: var(--sdoc-slide-w); height: var(--sdoc-slide-h); max-width: none;
     overflow: hidden;
     page-break-inside: avoid; break-inside: avoid;
   }