@podosoft/podokit-template-engine 0.1.0 → 0.1.1

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@podosoft/podokit-template-engine",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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"
   },