@podosoft/podokit-template-engine 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/** Variables available for token substitution in template files. */
+export type TemplateVars = Record<string, string>;
+/** Minimal JSON object shape used for package.json merging. */
+export type JsonObject = Record<string, unknown>;
+/**
+ * Replace `{{key}}` tokens in `content` with the matching value from `vars`.
+ * Unknown tokens are left untouched so unrelated braces are preserved.
+ */
+export declare function renderTokens(content: string, vars: TemplateVars): string;
+/**
+ * Map a template file name to its output name.
+ * A leading `dot-` becomes `.` so files like `dot-gitignore` are shipped
+ * inside npm packages (which strip real `.gitignore`) and restored on copy.
+ */
+export declare function resolveOutputName(name: string): string;
+/**
+ * Recursively copy a template directory to `destDir`, rendering tokens in
+ * text files and applying the `dot-` name convention. Directories are created
+ * as needed. Binary files are copied verbatim.
+ */
+export declare function copyTemplate(srcDir: string, destDir: string, vars: TemplateVars): void;
+/**
+ * Deep-merge `overlay` onto `base`. Objects merge recursively, arrays are
+ * concatenated and de-duplicated, and scalar overlay values win. Neither input
+ * is mutated. Used to combine a base package.json with module fragments.
+ */
+export declare function mergePackageJson(base: JsonObject, overlay: JsonObject): JsonObject;

package/dist/index.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTokens = renderTokens;
+exports.resolveOutputName = resolveOutputName;
+exports.copyTemplate = copyTemplate;
+exports.mergePackageJson = mergePackageJson;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Replace `{{key}}` tokens in `content` with the matching value from `vars`.
+ * Unknown tokens are left untouched so unrelated braces are preserved.
+ */
+function renderTokens(content, vars) {
+    return content.replace(/\{\{\s*([\w.-]+)\s*\}\}/g, (match, key) => {
+        const value = vars[key];
+        return value === undefined ? match : value;
+    });
+}
+/**
+ * Map a template file name to its output name.
+ * A leading `dot-` becomes `.` so files like `dot-gitignore` are shipped
+ * inside npm packages (which strip real `.gitignore`) and restored on copy.
+ */
+function resolveOutputName(name) {
+    return name.startsWith("dot-") ? `.${name.slice("dot-".length)}` : name;
+}
+const TEXT_FILE = /\.(json|md|ts|js|mjs|cjs|css|html|yml|yaml|txt|env|example|gitignore|svelte)$/i;
+function isTextFile(name) {
+    return name.startsWith("dot-") || TEXT_FILE.test(name);
+}
+/**
+ * Recursively copy a template directory to `destDir`, rendering tokens in
+ * text files and applying the `dot-` name convention. Directories are created
+ * as needed. Binary files are copied verbatim.
+ */
+function copyTemplate(srcDir, destDir, vars) {
+    (0, node_fs_1.mkdirSync)(destDir, { recursive: true });
+    for (const entry of (0, node_fs_1.readdirSync)(srcDir)) {
+        const srcPath = (0, node_path_1.join)(srcDir, entry);
+        const outName = resolveOutputName(entry);
+        const destPath = (0, node_path_1.join)(destDir, outName);
+        if ((0, node_fs_1.statSync)(srcPath).isDirectory()) {
+            copyTemplate(srcPath, destPath, vars);
+            continue;
+        }
+        if (isTextFile(entry)) {
+            const rendered = renderTokens((0, node_fs_1.readFileSync)(srcPath, "utf8"), vars);
+            (0, node_fs_1.writeFileSync)(destPath, rendered);
+        }
+        else {
+            (0, node_fs_1.writeFileSync)(destPath, (0, node_fs_1.readFileSync)(srcPath));
+        }
+    }
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Deep-merge `overlay` onto `base`. Objects merge recursively, arrays are
+ * concatenated and de-duplicated, and scalar overlay values win. Neither input
+ * is mutated. Used to combine a base package.json with module fragments.
+ */
+function mergePackageJson(base, overlay) {
+    const result = { ...base };
+    for (const [key, overlayValue] of Object.entries(overlay)) {
+        const baseValue = result[key];
+        if (isPlainObject(baseValue) && isPlainObject(overlayValue)) {
+            result[key] = mergePackageJson(baseValue, overlayValue);
+        }
+        else if (Array.isArray(baseValue) && Array.isArray(overlayValue)) {
+            result[key] = [...new Set([...baseValue, ...overlayValue])];
+        }
+        else {
+            result[key] = overlayValue;
+        }
+    }
+    return result;
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@podosoft/podokit-template-engine",
+  "version": "0.1.0",
+  "description": "Template rendering, copying, and package.json merge utilities for PodoKit.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/podosoft-dev/podokit.git",
+    "directory": "packages/template-engine"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}