@podosoft/podokit-template-engine 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,46 @@
+# @podosoft/podokit-template-engine
+
+Template utilities used by the [PodoKit](https://github.com/podosoft-dev/podokit) CLI: token rendering, recursive template copying, and `package.json` merging.
+
+> This package is primarily an internal building block for `@podosoft/podokit`. It is published so the CLI is installable from the registry, but the API is small and reusable on its own.
+
+## Install
+
+```bash
+npm install @podosoft/podokit-template-engine
+```
+
+## API
+
+```ts
+import {
+  renderTokens,
+  copyTemplate,
+  mergePackageJson,
+  resolveOutputName,
+} from "@podosoft/podokit-template-engine";
+```
+
+### `renderTokens(content, vars)`
+
+Replace `{{key}}` tokens with values from `vars`. Unknown tokens are left untouched.
+
+```ts
+renderTokens("# {{name}}", { name: "my-app" }); // "# my-app"
+```
+
+### `copyTemplate(srcDir, destDir, vars)`
+
+Recursively copy a template directory, rendering tokens in text files. Files named `dot-<x>` are written as `.<x>` (so `dot-gitignore` → `.gitignore`), which lets templates ship files that npm would otherwise strip.
+
+### `mergePackageJson(base, overlay)`
+
+Deep-merge two `package.json`-shaped objects: objects merge recursively, arrays concatenate and de-duplicate, and scalar overlay values win. Neither input is mutated.
+
+### `resolveOutputName(name)`
+
+Map a template file name to its output name (applies the `dot-` convention).
+
+## License
+
+[Apache-2.0](https://github.com/podosoft-dev/podokit/blob/main/LICENSE)

package/dist/index.d.ts

@@ -19,6 +19,13 @@ export declare function resolveOutputName(name: string): string;
  * as needed. Binary files are copied verbatim.
  */
 export declare function copyTemplate(srcDir: string, destDir: string, vars: TemplateVars): void;
+/**
+ * Insert `text` on its own line immediately after the first line containing
+ * `marker`, preserving the marker line and its indentation. No-op if `text`
+ * is already present (so re-applying a module is idempotent). Throws if the
+ * marker is not found.
+ */
+export declare function insertAtMarker(content: string, marker: string, text: string): string;
 /**
  * Deep-merge `overlay` onto `base`. Objects merge recursively, arrays are
  * concatenated and de-duplicated, and scalar overlay values win. Neither input

package/dist/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderTokens = renderTokens;
 exports.resolveOutputName = resolveOutputName;
 exports.copyTemplate = copyTemplate;
+exports.insertAtMarker = insertAtMarker;
 exports.mergePackageJson = mergePackageJson;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
@@ -52,6 +53,25 @@ function copyTemplate(srcDir, destDir, vars) {
         }
     }
 }
+/**
+ * Insert `text` on its own line immediately after the first line containing
+ * `marker`, preserving the marker line and its indentation. No-op if `text`
+ * is already present (so re-applying a module is idempotent). Throws if the
+ * marker is not found.
+ */
+function insertAtMarker(content, marker, text) {
+    if (content.includes(text)) {
+        return content;
+    }
+    const lines = content.split("\n");
+    const index = lines.findIndex((line) => line.includes(marker));
+    if (index === -1) {
+        throw new Error(`Marker not found: ${marker}`);
+    }
+    const indent = lines[index].match(/^\s*/)?.[0] ?? "";
+    lines.splice(index, 0, `${indent}${text}`);
+    return lines.join("\n");
+}
 function isPlainObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@podosoft/podokit-template-engine",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Template rendering, copying, and package.json merge utilities for PodoKit.",
   "license": "Apache-2.0",
   "repository": {
@@ -10,7 +10,9 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "engines": {
     "node": ">=20"
   },