otomate 0.0.10 → 0.1.0

package/README.md

@@ -55,6 +55,7 @@ Output: serializable `DiffResult` with typed operations — `insert`, `delete`,
 | `@otomate/diff` | Tree diff engine + Myers string-level diffing |
 | `@otomate/html` | HTML ↔ UDM adapter (via hast) |
 | `@otomate/docx` | docx ↔ UDM adapter (via jszip + fast-xml-parser) |
+| `@otomate/inject` | Template injection — fill `{{placeholders}}` with data |
 | `@otomate/css-docx` | CSS properties → OOXML style mapping |
 | `@otomate/ui` | Web UI for testing conversions and diffs |
 
@@ -184,6 +185,49 @@ const result = diff(htmlTree, docxTree);
 // Structural comparison regardless of source format
 ```
 
+### Template injection
+
+Fill `{{placeholders}}` in a document template with data from any source.
+
+```typescript
+import { readDocx, writeDocx, inject } from "otomate";
+
+// 1. Read template (HTML or docx with content controls)
+const tree = await readDocx(templateBuffer);
+
+// 2. Inject data — any JSON object, keys match {{placeholders}}
+const filled = inject(tree, {
+  name: "John Doe",
+  position: "Senior Engineer",
+  benefits: [
+    { name: "Health", description: "Full medical coverage" },
+    { name: "401k", description: "6% company match" },
+  ],
+  showRelocation: true,
+  relocationAmount: "$15,000",
+});
+
+// 3. Export filled document
+const output = await writeDocx(filled);
+```
+
+**Placeholder syntax:**
+
+| Syntax | Description |
+|--------|-------------|
+| `{{fieldName}}` | Replace with value (inherits formatting) |
+| `{{obj.nested}}` | Dot-path into nested objects |
+| `{{#each items}}...{{/each}}` | Repeat block for each array item |
+| `{{#if condition}}...{{/if}}` | Conditional block |
+| `{{#if x}}...{{else}}...{{/if}}` | Conditional with else |
+| `{{@richField}}` | Replace paragraph with block-level content |
+
+**Word content controls:** When reading a `.docx` created with Word's Developer tab content controls, otomate automatically detects them and converts each control's tag name into a `{{placeholder}}`. No manual placeholder typing needed.
+
+**Data format:** Free-form JSON — no fixed schema. The keys in your data object map directly to the placeholder names in your template.
+
+**Interactive demo:** Open `examples/inject-demo.html` to try it live with editable JSON and instant preview.
+
 ## Web UI
 
 A built-in test interface for interactive conversion and diffing:

package/dist/index.d.ts

@@ -2,5 +2,6 @@ export { type UdmNode, type UdmParent, type UdmLiteral, type Root, type Paragrap
 export { diff, diffText, type DiffResult, type DiffOptions, type EditOperation, type TextChange, type NodeMapping, } from "@otomate/diff";
 export { readHtml, writeHtml, renderDiffHtml, parseCssClasses, parseCssRules, type HtmlReadOptions, type HtmlWriteOptions, type DiffHtmlOptions, type CssClassRules, type CssParsedRules, } from "@otomate/html";
 export { readDocx, writeDocx, type DocxReadOptions, type DocxWriteOptions, } from "@otomate/docx";
+export { inject, normalizeTextRuns, parseTokens, splitByPlaceholders, hasPlaceholders, resolveValue, valueToString, isTruthy, type InjectData, type InjectOptions, type PlaceholderToken, type PlaceholderHit, type RichContent, } from "@otomate/inject";
 export { cssToRunProps, cssToParaProps, parseColor, parseLengthTwips, parseLengthHalfPts, runPropsToXml, paraPropsToXml, buildStyleElement, type OoxmlRunProps, type OoxmlParaProps, } from "@otomate/css-docx";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAC7C,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EACxD,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EACxC,KAAK,KAAK,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EACzC,KAAK,aAAa,EAAE,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAC1D,KAAK,IAAI,EAAE,KAAK,kBAAkB,EAAE,KAAK,IAAI,EAC7C,KAAK,IAAI,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EACjC,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EACxD,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EACxD,KAAK,QAAQ,EAAE,KAAK,KAAK,EAEzB,QAAQ,EAAE,SAAS,EAAE,MAAM,EAE3B,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EACpD,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,EACzD,IAAI,EAAE,SAAS,EAAE,KAAK,EACtB,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EACjE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAE7B,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAElD,QAAQ,EAAE,cAAc,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,KAAK,UAAU,EAAE,KAAK,WAAW,EACjC,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,GACtD,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,QAAQ,EAAE,SAAS,EAAE,cAAc,EACnC,eAAe,EAAE,aAAa,EAC9B,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EACjE,KAAK,aAAa,EAAE,KAAK,cAAc,GACxC,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,QAAQ,EAAE,SAAS,EACnB,KAAK,eAAe,EAAE,KAAK,gBAAgB,GAC5C,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EAAE,cAAc,EAC7B,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAChD,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAChD,KAAK,aAAa,EAAE,KAAK,cAAc,GACxC,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAC7C,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EACxD,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EACxC,KAAK,KAAK,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EACzC,KAAK,aAAa,EAAE,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAC1D,KAAK,IAAI,EAAE,KAAK,kBAAkB,EAAE,KAAK,IAAI,EAC7C,KAAK,IAAI,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EACjC,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EACxD,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EACxD,KAAK,QAAQ,EAAE,KAAK,KAAK,EAEzB,QAAQ,EAAE,SAAS,EAAE,MAAM,EAE3B,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EACpD,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,EACzD,IAAI,EAAE,SAAS,EAAE,KAAK,EACtB,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EACjE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAE7B,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAElD,QAAQ,EAAE,cAAc,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,KAAK,UAAU,EAAE,KAAK,WAAW,EACjC,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,GACtD,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,QAAQ,EAAE,SAAS,EAAE,cAAc,EACnC,eAAe,EAAE,aAAa,EAC9B,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EACjE,KAAK,aAAa,EAAE,KAAK,cAAc,GACxC,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,QAAQ,EAAE,SAAS,EACnB,KAAK,eAAe,EAAE,KAAK,gBAAgB,GAC5C,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,WAAW,EAAE,mBAAmB,EAAE,eAAe,EACjD,YAAY,EAAE,aAAa,EAAE,QAAQ,EACrC,KAAK,UAAU,EAAE,KAAK,aAAa,EACnC,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,GAC7D,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,aAAa,EAAE,cAAc,EAC7B,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAChD,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAChD,KAAK,aAAa,EAAE,KAAK,cAAc,GACxC,MAAM,mBAAmB,CAAC"}