@particle-academy/last-word 0.1.0 → 0.2.0

package/README.md

@@ -85,6 +85,17 @@ Images are embedded from data URLs (PNG/JPEG); when `widthPx`/`heightPx` are
 omitted the intrinsic size is sniffed from the bytes (PNG IHDR / JPEG SOF)
 and capped at 6.5in width keeping aspect.
 
+## Cross-language parity
+
+As of 0.2.0 the metadata slots match the PHP mirror exactly: the title is
+carried in `docProps/core.xml` (`dc:title`) and the code block `language` in
+a `lastword:code:{lang}` content-control tag (quotes use `lastword:quote`),
+so the **same file opens in either engine** — title and code language
+round-trip Node ↔ PHP in both directions. Files written by PHP 0.1.x
+(Title-styled paragraph, `LastWordCode_{lang}` bookmark) still read fine;
+the sibling repo's canonical fixture is frozen into each test suite as a
+cross-read vector.
+
 ---
 
 ## ⭐ Star Fancy UI

package/dist/index.cjs

@@ -1097,6 +1097,7 @@ var DocxReader = class {
     const blocks = [];
     let listBuf = [];
     let codeBuf = null;
+    let codeLang = null;
     let quoteBuf = null;
     const flushList = () => {
       if (listBuf.length > 0) {
@@ -1106,8 +1107,11 @@ var DocxReader = class {
     };
     const flushCode = () => {
       if (codeBuf !== null) {
-        blocks.push({ type: "code", text: codeBuf.join("\n") });
+        const block = { type: "code", text: codeBuf.join("\n") };
+        if (codeLang !== null) block.language = codeLang;
+        blocks.push(orderCodeKeys(block));
         codeBuf = null;
+        codeLang = null;
       }
     };
     const flushQuote = () => {
@@ -1132,7 +1136,10 @@ var DocxReader = class {
           } else if (kind.kind === "codeLine") {
             flushList();
             flushQuote();
-            if (codeBuf === null) codeBuf = [];
+            if (codeBuf === null) {
+              codeBuf = [];
+              codeLang = kind.language ?? null;
+            }
             codeBuf.push(kind.text);
           } else if (kind.kind === "quoteParagraph" && !ctx.insideQuote) {
             flushList();
@@ -1201,7 +1208,8 @@ var DocxReader = class {
       return { kind: "listItem", item: { numId, ilvl, runs: this.parseRuns(p, void 0) } };
     }
     if (/^(CodeBlock|SourceCode|HTMLPreformatted|Code)$/i.test(styleId)) {
-      return { kind: "codeLine", text: this.plainText(p) };
+      const language = this.legacyBookmarkLanguage(p);
+      return language !== void 0 ? { kind: "codeLine", text: this.plainText(p), language } : { kind: "codeLine", text: this.plainText(p) };
     }
     const blocks = [];
     const drawings = findAll(p, "drawing");
@@ -1237,6 +1245,21 @@ var DocxReader = class {
     }
     return { kind: "blocks", blocks };
   }
+  /**
+   * Back-compat: the code language from a PHP last-word ≤0.1.x
+   * `LastWordCode_{lang}` bookmark on this paragraph, if present. The
+   * canonical carrier is the `lastword:code:{lang}` sdt tag.
+   */
+  legacyBookmarkLanguage(p) {
+    for (const child of p.children) {
+      if (child.name !== "bookmarkStart") continue;
+      const name = at(child, "name") ?? "";
+      if (name.startsWith("LastWordCode_") && name.length > "LastWordCode_".length) {
+        return name.slice("LastWordCode_".length);
+      }
+    }
+    return void 0;
+  }
   /** Concatenated visible text of a paragraph (tabs and soft breaks included). */
   plainText(p) {
     return this.parseRuns(p, void 0).map((r) => r.text).join("");
@@ -2285,7 +2308,7 @@ var Validator = class {
 };
 
 // src/agent.ts
-var VERSION = "0.1.0";
+var VERSION = "0.2.0";
 function toU8(input) {
   return input instanceof Uint8Array ? input : new Uint8Array(input);
 }