md-template-vars 0.1.2 → 0.2.1

package/README.md

@@ -29,11 +29,12 @@ md-template-vars <input> <output> [options]
 
 ### Options
 
-| Option      | Default          | Description                            |
-| ----------- | ---------------- | -------------------------------------- |
-| `--vars`    | `variables.yaml` | Path to the variables YAML file        |
-| `--include` | -                | Glob pattern to include specific files |
-| `--exclude` | -                | Glob pattern to exclude specific files |
+| Option      | Default          | Description                                      |
+| ----------- | ---------------- | ------------------------------------------------ |
+| `--vars`    | `variables.yaml` | Path to the variables YAML file                  |
+| `--include` | -                | Glob pattern to include specific files           |
+| `--exclude` | -                | Glob pattern to exclude specific files           |
+| `--watch`   | `false`          | Watch for file changes and rebuild automatically |
 
 ## Examples
 
@@ -59,6 +60,18 @@ md-template-vars ./templates ./output --include "api-*.md"
 md-template-vars ./templates ./output --exclude "draft-*.md"
 ```
 
+### Watch mode
+
+```bash
+md-template-vars ./templates ./output --watch
+```
+
+This will watch for changes in:
+- Template files in the input directory
+- The variables YAML file
+
+When changes are detected, templates are automatically rebuilt.
+
 ## Template Syntax
 
 Use `{{variableName}}` syntax in your Markdown files:
@@ -83,6 +96,34 @@ project: My Project
 Welcome to My Project!
 ```
 
+### Nested Variables
+
+You can use nested objects in your variables file and access them with dot notation:
+
+**Template:**
+```markdown
+# {{app.name}}
+
+Database: {{database.host}}:{{database.port}}
+```
+
+**Variables (variables.yaml):**
+```yaml
+app:
+  name: My App
+
+database:
+  host: localhost
+  port: 5432
+```
+
+**Output:**
+```markdown
+# My App
+
+Database: localhost:5432
+```
+
 ## Error Handling
 
 | Case                        | Behavior                                            |

package/dist/domain/services/template-renderer.js

@@ -1,4 +1,4 @@
-const VARIABLE_PATTERN = /\{\{(\w+)\}\}/g;
+const VARIABLE_PATTERN = /\{\{([\w.]+)\}\}/g;
 export function renderTemplate(content, variables) {
     const undefinedVariables = [];
     const renderedContent = content.replace(VARIABLE_PATTERN, (match, varName) => {

package/dist/domain/value-objects/variables.d.ts

@@ -1,3 +1,9 @@
 import { z } from "zod";
-export declare const VariablesSchema: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, string, string | number | boolean>>;
+declare const PrimitiveValueSchema: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+type NestedValue = z.infer<typeof PrimitiveValueSchema> | {
+    [key: string]: NestedValue;
+};
+export declare const VariablesSchema: z.ZodRecord<z.ZodString, z.ZodType<NestedValue, z.ZodTypeDef, NestedValue>>;
 export type Variables = Record<string, string>;
+export declare function flattenVariables(obj: Record<string, NestedValue>, prefix?: string): Variables;
+export {};

package/dist/domain/value-objects/variables.js

@@ -1,3 +1,17 @@
 import { z } from "zod";
-const VariableValueSchema = z.union([z.string(), z.number(), z.boolean()]).transform(String);
-export const VariablesSchema = z.record(z.string(), VariableValueSchema);
+const PrimitiveValueSchema = z.union([z.string(), z.number(), z.boolean()]);
+const NestedValueSchema = z.lazy(() => z.union([PrimitiveValueSchema, z.record(z.string(), NestedValueSchema)]));
+export const VariablesSchema = z.record(z.string(), NestedValueSchema);
+export function flattenVariables(obj, prefix = "") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === "object" && value !== null) {
+            Object.assign(result, flattenVariables(value, fullKey));
+        }
+        else {
+            result[fullKey] = String(value);
+        }
+    }
+    return result;
+}

package/dist/infrastructure/repositories/variables-repository.js

@@ -1,6 +1,6 @@
 import { readFileSync, existsSync } from "node:fs";
 import { parse } from "yaml";
-import { VariablesSchema } from "../../domain/value-objects/variables.js";
+import { VariablesSchema, flattenVariables } from "../../domain/value-objects/variables.js";
 import { VariablesFileNotFoundError, InvalidVariablesError } from "../../shared/errors.js";
 export function loadVariables(filePath) {
     if (!existsSync(filePath)) {
@@ -12,5 +12,5 @@ export function loadVariables(filePath) {
     if (!result.success) {
         throw new InvalidVariablesError(result.error.message);
     }
-    return result.data;
+    return flattenVariables(result.data);
 }

package/dist/presentation/cli/commands/main.d.ts

@@ -22,4 +22,9 @@ export declare const mainCommand: import("citty").CommandDef<{
         type: "string";
         description: string;
     };
+    watch: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
 }>;

package/dist/presentation/cli/commands/main.js

@@ -1,6 +1,49 @@
 import { defineCommand } from "citty";
+import { watch } from "node:fs";
+import { resolve } from "node:path";
 import { processTemplates } from "../../../application/use-cases/process-templates.js";
-import { VariablesFileNotFoundError, SameInputOutputError, InvalidVariablesError, } from "../../../shared/errors.js";
+import { VariablesFileNotFoundError, SameInputOutputError, InvalidVariablesError } from "../../../shared/errors.js";
+async function runProcess(options) {
+    try {
+        const result = await processTemplates(options);
+        for (const warning of result.warnings) {
+            console.warn(warning);
+        }
+        console.log(`Processed ${result.processedFiles.length} file(s)`);
+        for (const file of result.processedFiles) {
+            console.log(`  - ${file}`);
+        }
+        return true;
+    }
+    catch (error) {
+        if (error instanceof VariablesFileNotFoundError ||
+            error instanceof SameInputOutputError ||
+            error instanceof InvalidVariablesError) {
+            console.error(`Error: ${error.message}`);
+            return false;
+        }
+        throw error;
+    }
+}
+function startWatch(options) {
+    const inputPath = resolve(options.input);
+    const varsPath = resolve(options.vars);
+    let debounceTimer = null;
+    const handleChange = () => {
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        debounceTimer = setTimeout(async () => {
+            console.log("\n--- Change detected, rebuilding... ---\n");
+            await runProcess(options);
+        }, 100);
+    };
+    console.log(`\nWatching for changes...`);
+    console.log(`  - Templates: ${inputPath}`);
+    console.log(`  - Variables: ${varsPath}\n`);
+    watch(inputPath, { recursive: true }, handleChange);
+    watch(varsPath, handleChange);
+}
 export const mainCommand = defineCommand({
     meta: {
         name: "md-template-vars",
@@ -30,32 +73,29 @@ export const mainCommand = defineCommand({
             type: "string",
             description: "Glob pattern to exclude files",
         },
+        watch: {
+            type: "boolean",
+            description: "Watch for file changes and rebuild automatically",
+            default: false,
+        },
     },
     async run({ args }) {
-        try {
-            const result = await processTemplates({
-                input: args.input,
-                output: args.output,
-                vars: args.vars,
-                include: args.include,
-                exclude: args.exclude,
-            });
-            for (const warning of result.warnings) {
-                console.warn(warning);
-            }
-            console.log(`Processed ${result.processedFiles.length} file(s)`);
-            for (const file of result.processedFiles) {
-                console.log(`  - ${file}`);
+        const options = {
+            input: args.input,
+            output: args.output,
+            vars: args.vars,
+            include: args.include,
+            exclude: args.exclude,
+        };
+        const success = await runProcess(options);
+        if (args.watch) {
+            if (!success) {
+                console.log("\nFix errors and save to retry...\n");
             }
+            startWatch(options);
         }
-        catch (error) {
-            if (error instanceof VariablesFileNotFoundError ||
-                error instanceof SameInputOutputError ||
-                error instanceof InvalidVariablesError) {
-                console.error(`Error: ${error.message}`);
-                process.exit(1);
-            }
-            throw error;
+        else if (!success) {
+            process.exit(1);
         }
     },
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "md-template-vars",
   "author": "Shunta Toda",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "Replace {{variables}} in markdown templates with YAML values",
   "type": "module",
   "main": "./dist/application/use-cases/process-templates.js",