@jakubmazanec/carson 1.2.5 → 1.3.0-unstable.4fde3536

package/build/template/internals/{unmergeUsingTemplateRender.js → unmergeUsingTemplateRenderSnapshot.js}

@@ -6,36 +6,30 @@ import yaml from "yaml";
 import { CarsonTemplateError } from "../CarsonTemplateError.js";
 import { prettify } from "./prettify.js";
 import { unmerge } from "./unmerge.js";
-export async function unmergeUsingTemplateRender(templateRender, outputPath) {
-  let to = path.join(outputPath, templateRender.attributes.to);
+export async function unmergeUsingTemplateRenderSnapshot(templateRenderSnapshot, outputPath) {
+  let to = path.join(outputPath, templateRenderSnapshot.attributes.to);
   let extension = path.extname(to);
+  if (!templateRenderSnapshot.content) {
+    throw new CarsonTemplateError("INVALID_SNAPSHOT");
+  }
   switch (extension) {
     case ".json": {
       let targetFile = await fs.readJson(to);
-      let fileToMerge = json.parse(templateRender.content);
+      let fileToMerge = json.parse(templateRenderSnapshot.content);
       let newFile = JSON.stringify(unmerge(targetFile, fileToMerge));
       await fs.writeFile(to, await prettify(newFile, to), { encoding: "utf8" });
       break;
     }
     case ".yaml": {
       let targetFile = yaml.parse(await fs.readFile(to, { encoding: "utf8" }));
-      let fileToMerge = yaml.parse(templateRender.content);
+      let fileToMerge = yaml.parse(templateRenderSnapshot.content);
       let newFile = yaml.stringify(unmerge(targetFile, fileToMerge));
       await fs.writeFile(to, await prettify(newFile, to), { encoding: "utf8" });
       break;
     }
     default: {
-      throw new CarsonTemplateError("STRATEGY_UNSUPPORTED_EXTENSION", {
-        messageParameters: [
-          templateRender.attributes.strategy,
-          templateRender.template.path,
-          extension
-        ],
-        data: {
-          path: templateRender.template.path
-        }
-      });
+      throw new CarsonTemplateError("INVALID_SNAPSHOT");
     }
   }
 }
-//# sourceMappingURL=unmergeUsingTemplateRender.js.map
+//# sourceMappingURL=unmergeUsingTemplateRenderSnapshot.js.map

package/build/template/internals/unmergeUsingTemplateRenderSnapshot.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../source/template/internals/unmergeUsingTemplateRenderSnapshot.ts"],
+  "sourcesContent": ["import {type Json} from '@jakubmazanec/zod-utils';\nimport fs from 'fs-extra';\nimport json from 'json5';\nimport path from 'node:path';\nimport yaml from 'yaml';\n\nimport {CarsonTemplateError} from '../CarsonTemplateError.js';\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {unmerge} from './unmerge.js';\n\nexport async function unmergeUsingTemplateRenderSnapshot(\n  templateRenderSnapshot: TemplateRenderSnapshot,\n  outputPath: string,\n) {\n  let to = path.join(outputPath, templateRenderSnapshot.attributes.to);\n  let extension = path.extname(to);\n\n  if (!templateRenderSnapshot.content) {\n    throw new CarsonTemplateError('INVALID_SNAPSHOT');\n  }\n\n  switch (extension) {\n    case '.json': {\n      let targetFile = (await fs.readJson(to)) as Json;\n      let fileToMerge = json.parse<Json>(templateRenderSnapshot.content);\n      let newFile = JSON.stringify(unmerge(targetFile, fileToMerge));\n\n      await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n\n      break;\n    }\n\n    case '.yaml': {\n      let targetFile = yaml.parse(await fs.readFile(to, {encoding: 'utf8'})) as unknown;\n      let fileToMerge = yaml.parse(templateRenderSnapshot.content) as unknown;\n      let newFile = yaml.stringify(unmerge(targetFile, fileToMerge));\n\n      await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n\n      break;\n    }\n\n    default: {\n      throw new CarsonTemplateError('INVALID_SNAPSHOT');\n    }\n  }\n}\n"],
+  "mappings": ";AACA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,OAAO,UAAU;AACjB,OAAO,UAAU;AAEjB,SAAQ,2BAA0B;AAClC,SAAQ,gBAAe;AAEvB,SAAQ,eAAc;AAEtB,sBAAsB,mCACpB,wBACA,YACA;AACA,MAAI,KAAK,KAAK,KAAK,YAAY,uBAAuB,WAAW,EAAE;AACnE,MAAI,YAAY,KAAK,QAAQ,EAAE;AAE/B,MAAI,CAAC,uBAAuB,SAAS;AACnC,UAAM,IAAI,oBAAoB,kBAAkB;AAAA,EAClD;AAEA,UAAQ,WAAW;AAAA,IACjB,KAAK,SAAS;AACZ,UAAI,aAAc,MAAM,GAAG,SAAS,EAAE;AACtC,UAAI,cAAc,KAAK,MAAY,uBAAuB,OAAO;AACjE,UAAI,UAAU,KAAK,UAAU,QAAQ,YAAY,WAAW,CAAC;AAE7D,YAAM,GAAG,UAAU,IAAI,MAAM,SAAS,SAAS,EAAE,GAAG,EAAC,UAAU,OAAM,CAAC;AAEtE;AAAA,IACF;AAAA,IAEA,KAAK,SAAS;AACZ,UAAI,aAAa,KAAK,MAAM,MAAM,GAAG,SAAS,IAAI,EAAC,UAAU,OAAM,CAAC,CAAC;AACrE,UAAI,cAAc,KAAK,MAAM,uBAAuB,OAAO;AAC3D,UAAI,UAAU,KAAK,UAAU,QAAQ,YAAY,WAAW,CAAC;AAE7D,YAAM,GAAG,UAAU,IAAI,MAAM,SAAS,SAAS,EAAE,GAAG,EAAC,UAAU,OAAM,CAAC;AAEtE;AAAA,IACF;AAAA,IAEA,SAAS;AACP,YAAM,IAAI,oBAAoB,kBAAkB;AAAA,IAClD;AAAA,EACF;AACF;",
+  "names": []
+}

package/build/template/internals.d.ts

@@ -1,5 +1,5 @@
 export * from './internals/createUsingTemplateRender.js';
-export * from './internals/deleteUsingTemplateRender.js';
+export * from './internals/deleteUsingTemplateRenderSnapshot.js';
 export * from './internals/importCarsonTemplate.js';
 export * from './internals/insertUsingTemplateRender.js';
 export * from './internals/loadTemplateRenderSnapshots.js';
@@ -11,8 +11,9 @@ export * from './internals/prettify.js';
 export * from './internals/readCarsonTemplate.js';
 export * from './internals/resolveModule.js';
 export * from './internals/saveTemplateRenderSnapshots.js';
+export * from './internals/simplify.js';
 export * from './internals/TemplateRenderSnapshot.js';
 export * from './internals/TemplateRenderSnapshots.js';
-export * from './internals/uninsertUsingTemplateRender.js';
+export * from './internals/uninsertUsingTemplateRenderSnapshot.js';
 export * from './internals/unmerge.js';
-export * from './internals/unmergeUsingTemplateRender.js';
+export * from './internals/unmergeUsingTemplateRenderSnapshot.js';

package/build/template/internals.js

@@ -1,6 +1,6 @@
 "use strict";
 export * from "./internals/createUsingTemplateRender.js";
-export * from "./internals/deleteUsingTemplateRender.js";
+export * from "./internals/deleteUsingTemplateRenderSnapshot.js";
 export * from "./internals/importCarsonTemplate.js";
 export * from "./internals/insertUsingTemplateRender.js";
 export * from "./internals/loadTemplateRenderSnapshots.js";
@@ -12,9 +12,10 @@ export * from "./internals/prettify.js";
 export * from "./internals/readCarsonTemplate.js";
 export * from "./internals/resolveModule.js";
 export * from "./internals/saveTemplateRenderSnapshots.js";
+export * from "./internals/simplify.js";
 export * from "./internals/TemplateRenderSnapshot.js";
 export * from "./internals/TemplateRenderSnapshots.js";
-export * from "./internals/uninsertUsingTemplateRender.js";
+export * from "./internals/uninsertUsingTemplateRenderSnapshot.js";
 export * from "./internals/unmerge.js";
-export * from "./internals/unmergeUsingTemplateRender.js";
+export * from "./internals/unmergeUsingTemplateRenderSnapshot.js";
 //# sourceMappingURL=internals.js.map

package/build/template/internals.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../source/template/internals.ts"],
-  "sourcesContent": ["export * from './internals/createUsingTemplateRender.js';\nexport * from './internals/deleteUsingTemplateRender.js';\nexport * from './internals/importCarsonTemplate.js';\nexport * from './internals/insertUsingTemplateRender.js';\nexport * from './internals/loadTemplateRenderSnapshots.js';\nexport * from './internals/merge.js';\nexport * from './internals/mergeUsingTemplateRender.js';\nexport * from './internals/overwriteUsingTemplateRender.js';\nexport * from './internals/parseCarsonTemplateId.js';\nexport * from './internals/prettify.js';\nexport * from './internals/readCarsonTemplate.js';\nexport * from './internals/resolveModule.js';\nexport * from './internals/saveTemplateRenderSnapshots.js';\nexport * from './internals/TemplateRenderSnapshot.js';\nexport * from './internals/TemplateRenderSnapshots.js';\nexport * from './internals/uninsertUsingTemplateRender.js';\nexport * from './internals/unmerge.js';\nexport * from './internals/unmergeUsingTemplateRender.js';\n"],
-  "mappings": ";AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from './internals/createUsingTemplateRender.js';\nexport * from './internals/deleteUsingTemplateRenderSnapshot.js';\nexport * from './internals/importCarsonTemplate.js';\nexport * from './internals/insertUsingTemplateRender.js';\nexport * from './internals/loadTemplateRenderSnapshots.js';\nexport * from './internals/merge.js';\nexport * from './internals/mergeUsingTemplateRender.js';\nexport * from './internals/overwriteUsingTemplateRender.js';\nexport * from './internals/parseCarsonTemplateId.js';\nexport * from './internals/prettify.js';\nexport * from './internals/readCarsonTemplate.js';\nexport * from './internals/resolveModule.js';\nexport * from './internals/saveTemplateRenderSnapshots.js';\nexport * from './internals/simplify.js';\nexport * from './internals/TemplateRenderSnapshot.js';\nexport * from './internals/TemplateRenderSnapshots.js';\nexport * from './internals/uninsertUsingTemplateRenderSnapshot.js';\nexport * from './internals/unmerge.js';\nexport * from './internals/unmergeUsingTemplateRenderSnapshot.js';\n"],
+  "mappings": ";AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakubmazanec/carson",
-  "version": "1.2.5",
+  "version": "1.3.0-unstable.4fde3536",
   "description": "Tool for managing workspace and project configuration.",
   "repository": {
     "type": "git",
@@ -32,13 +32,13 @@
     "typecheck": "tsc --project tsconfig.typecheck.json"
   },
   "dependencies": {
-    "@jakubmazanec/args": "^2.0.0",
-    "@jakubmazanec/cli": "^0.3.0",
-    "@jakubmazanec/error": "^3.0.0",
-    "@jakubmazanec/fs-utils": "^0.2.0",
-    "@jakubmazanec/template": "^2.0.0",
-    "@jakubmazanec/ts-utils": "^3.0.0",
-    "@jakubmazanec/zod-utils": "^2.0.0",
+    "@jakubmazanec/args": "2.0.8-unstable.4fde3536",
+    "@jakubmazanec/cli": "0.3.8-unstable.4fde3536",
+    "@jakubmazanec/error": "3.0.8-unstable.4fde3536",
+    "@jakubmazanec/fs-utils": "0.2.8-unstable.4fde3536",
+    "@jakubmazanec/template": "2.0.9-unstable.4fde3536",
+    "@jakubmazanec/ts-utils": "3.0.9-unstable.4fde3536",
+    "@jakubmazanec/zod-utils": "2.0.8-unstable.4fde3536",
     "chalk": "^5.3.0",
     "fast-glob": "^3.3.2",
     "fflate": "^0.8.2",
@@ -46,16 +46,16 @@
     "json5": "^2.2.3",
     "lodash": "^4.17.21",
     "micromatch": "^4.0.8",
-    "prettier": "^3.3.3",
-    "prettier-plugin-packagejson": "^2.5.3",
+    "prettier": "^3.4.2",
+    "prettier-plugin-packagejson": "^2.5.6",
     "semver": "^7.6.3",
     "simple-git": "^3.27.0",
     "yaml": "^2.6.1",
     "zen-observable": "^0.10.0",
-    "zod": "^3.23.8"
+    "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@jakubmazanec/eslint-config": "^4.1.0",
+    "@jakubmazanec/eslint-config": "4.1.2-unstable.4fde3536",
     "@types/fs-extra": "^11.0.4",
     "@types/lodash": "^4.17.13",
     "@types/micromatch": "^4.0.9",
@@ -64,19 +64,19 @@
     "@types/semver": "^7.5.8",
     "@types/zen-observable": "^0.8.7",
     "@vitest/coverage-v8": "^2.1.5",
-    "concurrently": "^9.1.0",
+    "concurrently": "^9.1.2",
     "del-cli": "^6.0.0",
-    "esbuild": "^0.24.0",
+    "esbuild": "^0.24.2",
     "eslint": "^9.15.0",
-    "ink": "^5.0.1",
+    "ink": "^5.1.0",
     "lodash": "^4.17.21",
-    "prettier": "^3.3.3",
-    "prettier-plugin-packagejson": "^2.5.3",
+    "prettier": "^3.4.2",
+    "prettier-plugin-packagejson": "^2.5.6",
     "react": "^18.3.1",
     "ts-node": "^10.9.2",
     "typedoc": "^0.27.6",
     "typedoc-plugin-markdown": "^4.3.3",
-    "typescript": "^5.6.3",
+    "typescript": "^5.7.2",
     "vitest": "^2.1.5"
   },
   "peerDependencies": {

package/source/template/CarsonTemplateError.ts

@@ -12,6 +12,7 @@ export const CarsonTemplateError = createCustomErrorWithData(
     STRATEGY_UNSUPPORTED_EXTENSION:
       'Strategy "{0}" in the template file "{1}" doesn\'t support extension "{2}".',
     STRATEGY_MISSING_FILE: 'Strategy "{0}" in the template file "{1}" is missing file "{2}".',
+    INVALID_SNAPSHOT: 'Invalid Carson template render snapshot.',
   },
   class CarsonTemplateErrorData {
     path?: string;

package/source/template/applyTemplateRenders.ts

@@ -6,14 +6,14 @@ import {CARSON_CONFIG_DIRECTORY} from '../constants.js';
 import {CarsonTemplateError} from './CarsonTemplateError.js';
 import {
   createUsingTemplateRender,
-  deleteUsingTemplateRender,
+  deleteUsingTemplateRenderSnapshot,
   insertUsingTemplateRender,
   loadTemplateRenderSnapshots,
   mergeUsingTemplateRender,
   overwriteUsingTemplateRender,
   saveTemplateRenderSnapshots,
-  uninsertUsingTemplateRender,
-  unmergeUsingTemplateRender,
+  uninsertUsingTemplateRenderSnapshot,
+  unmergeUsingTemplateRenderSnapshot,
 } from './internals.js';
 import {type TemplateRenders} from './TemplateRenders.js';
 
@@ -51,21 +51,21 @@ export async function applyTemplateRenders({
       }
 
       if (templateRenderSnapshot.attributes.strategy === 'ensure') {
-        await deleteUsingTemplateRender(templateRenderSnapshot, targetPath, {
+        await deleteUsingTemplateRenderSnapshot(templateRenderSnapshot, targetPath, {
           onlyDeleteWhenContentsMatch: true,
         });
       }
 
       if (templateRenderSnapshot.attributes.strategy === 'overwrite') {
-        await deleteUsingTemplateRender(templateRenderSnapshot, targetPath);
+        await deleteUsingTemplateRenderSnapshot(templateRenderSnapshot, targetPath);
       }
 
       if (templateRenderSnapshot.attributes.strategy === 'merge') {
-        await unmergeUsingTemplateRender(templateRenderSnapshot, targetPath);
+        await unmergeUsingTemplateRenderSnapshot(templateRenderSnapshot, targetPath);
       }
 
       if (templateRenderSnapshot.attributes.strategy[0] === 'insert') {
-        await uninsertUsingTemplateRender(templateRenderSnapshot, targetPath);
+        await uninsertUsingTemplateRenderSnapshot(templateRenderSnapshot, targetPath);
       }
     }
   }

package/source/template/internals/TemplateRenderSnapshot.ts

@@ -6,12 +6,7 @@ import {templateAttributesSchema} from '../TemplateAttributes.js';
 export const templateRenderSnapshotSchema = z
   .object({
     attributes: baseTemplateAttributesSchema.pick({to: true}).merge(templateAttributesSchema),
-    content: z.string(),
-    template: z
-      .object({
-        path: z.string(),
-      })
-      .strict(),
+    content: z.string().optional(),
   })
   .strict();
 

package/source/template/internals/createUsingTemplateRender.ts

@@ -7,12 +7,8 @@ import yaml from 'yaml';
 import {type TemplateRender} from '../TemplateRender.js';
 import {merge} from './merge.js';
 import {prettify} from './prettify.js';
-import {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';
 
-export async function createUsingTemplateRender(
-  templateRender: TemplateRender | TemplateRenderSnapshot,
-  basePath: string,
-) {
+export async function createUsingTemplateRender(templateRender: TemplateRender, basePath: string) {
   let to = path.join(basePath, templateRender.attributes.to);
   let extension = path.extname(to);
 

package/source/template/internals/{deleteUsingTemplateRender.ts → deleteUsingTemplateRenderSnapshot.ts}

@@ -1,7 +1,7 @@
 import fs from 'fs-extra';
 import path from 'node:path';
 
-import {type TemplateRender} from '../TemplateRender.js';
+import {CarsonTemplateError} from '../CarsonTemplateError.js';
 import {prettify} from './prettify.js';
 import {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';
 
@@ -9,20 +9,24 @@ export type DeleteUsingTemplateRenderOptions = {
   onlyDeleteWhenContentsMatch?: boolean;
 };
 
-export async function deleteUsingTemplateRender(
-  templateRender: TemplateRender | TemplateRenderSnapshot,
+export async function deleteUsingTemplateRenderSnapshot(
+  templateRenderSnapshot: TemplateRenderSnapshot,
   basePath: string,
   options?: DeleteUsingTemplateRenderOptions,
 ) {
-  let to = path.join(basePath, templateRender.attributes.to);
+  let to = path.join(basePath, templateRenderSnapshot.attributes.to);
 
   if (!(await fs.pathExists(to))) {
     return;
   }
 
   if (options?.onlyDeleteWhenContentsMatch) {
+    if (!templateRenderSnapshot.content) {
+      throw new CarsonTemplateError('INVALID_SNAPSHOT');
+    }
+
     let existingContent = await fs.readFile(to, {encoding: 'utf8'});
-    let newContent = await prettify(templateRender.content, to);
+    let newContent = await prettify(templateRenderSnapshot.content, to);
 
     if (existingContent.trim() === newContent.trim()) {
       await fs.rm(to);

package/source/template/internals/insertUsingTemplateRender.ts

@@ -5,12 +5,8 @@ import path from 'node:path';
 import {CarsonTemplateError} from '../CarsonTemplateError.js';
 import {type TemplateRender} from '../TemplateRender.js';
 import {prettify} from './prettify.js';
-import {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';
 
-export async function insertUsingTemplateRender(
-  templateRender: TemplateRender | TemplateRenderSnapshot,
-  basePath: string,
-) {
+export async function insertUsingTemplateRender(templateRender: TemplateRender, basePath: string) {
   let to = path.join(basePath, templateRender.attributes.to);
   let extension = path.extname(to);
 

package/source/template/internals/mergeUsingTemplateRender.ts

@@ -8,12 +8,8 @@ import {CarsonTemplateError} from '../CarsonTemplateError.js';
 import {type TemplateRender} from '../TemplateRender.js';
 import {merge} from './merge.js';
 import {prettify} from './prettify.js';
-import {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';
 
-export async function mergeUsingTemplateRender(
-  templateRender: TemplateRender | TemplateRenderSnapshot,
-  basePath: string,
-) {
+export async function mergeUsingTemplateRender(templateRender: TemplateRender, basePath: string) {
   let to = path.join(basePath, templateRender.attributes.to);
   let extension = path.extname(to);
 

package/source/template/internals/overwriteUsingTemplateRender.ts

@@ -3,10 +3,9 @@ import path from 'node:path';
 
 import {type TemplateRender} from '../TemplateRender.js';
 import {prettify} from './prettify.js';
-import {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';
 
 export async function overwriteUsingTemplateRender(
-  templateRender: TemplateRender | TemplateRenderSnapshot,
+  templateRender: TemplateRender,
   basePath: string,
 ) {
   let to = path.join(basePath, templateRender.attributes.to);

package/source/template/internals/saveTemplateRenderSnapshots.ts

@@ -1,7 +1,10 @@
 import {deflateSync, strToU8} from 'fflate';
 import fs from 'fs-extra';
+import path from 'node:path';
+import yaml from 'yaml';
 
 import {type TemplateRenders} from '../TemplateRenders.js';
+import {simplify} from './simplify.js';
 import {type TemplateRenderSnapshots} from './TemplateRenderSnapshots.js';
 
 export async function saveTemplateRenderSnapshots(
@@ -12,19 +15,62 @@ export async function saveTemplateRenderSnapshots(
 
   for (let templateRender of templateRenders) {
     if (
-      templateRender.attributes.strategy === 'ensure' ||
       templateRender.attributes.strategy === 'overwrite' ||
-      templateRender.attributes.strategy === 'merge' ||
       templateRender.attributes.strategy[0] === 'insert'
     ) {
+      templateRendersSnapshots.push({
+        attributes: {
+          to: templateRender.attributes.to,
+          strategy: templateRender.attributes.strategy,
+        },
+      });
+
+      continue;
+    }
+
+    if (templateRender.attributes.strategy === 'ensure') {
       templateRendersSnapshots.push({
         attributes: {
           to: templateRender.attributes.to,
           strategy: templateRender.attributes.strategy,
         },
         content: templateRender.content,
-        template: templateRender.template,
       });
+
+      continue;
+    }
+
+    if (templateRender.attributes.strategy === 'merge') {
+      let extension = path.extname(templateRender.attributes.to);
+      let content;
+
+      switch (extension) {
+        case '.json': {
+          content = JSON.stringify(simplify(JSON.parse(templateRender.content)));
+
+          break;
+        }
+
+        case '.yaml': {
+          content = yaml.stringify(simplify(yaml.parse(templateRender.content)));
+
+          break;
+        }
+
+        default: {
+          content = templateRender.content;
+        }
+      }
+
+      templateRendersSnapshots.push({
+        attributes: {
+          to: templateRender.attributes.to,
+          strategy: templateRender.attributes.strategy,
+        },
+        content,
+      });
+
+      continue;
     }
   }
 

package/source/template/internals/simplify.ts

@@ -0,0 +1,30 @@
+/**
+ * Simplifies JSON for usage in snapshots: string, number or boolean values are replaced with `null`.
+ */
+export function simplify(a: unknown) {
+  if (a === undefined || a == null) {
+    return null;
+  }
+
+  if (typeof a !== 'object' || Array.isArray(a)) {
+    return null;
+  }
+
+  const newA: Record<string, unknown> = {...a};
+
+  for (let [key] of Object.entries(a)) {
+    if (
+      (a as Record<string, unknown>)[key] &&
+      typeof (a as Record<string, unknown>)[key] === 'object' &&
+      !Array.isArray((a as Record<string, unknown>)[key])
+    ) {
+      const result = simplify((a as Record<string, unknown>)[key]);
+
+      newA[key] = result;
+    } else {
+      newA[key] = null;
+    }
+  }
+
+  return newA;
+}

package/source/template/internals/{uninsertUsingTemplateRender.ts → uninsertUsingTemplateRenderSnapshot.ts}

@@ -3,26 +3,25 @@ import _ from 'lodash';
 import path from 'node:path';
 
 import {CarsonTemplateError} from '../CarsonTemplateError.js';
-import {type TemplateRender} from '../TemplateRender.js';
 import {prettify} from './prettify.js';
 import {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';
 
-export async function uninsertUsingTemplateRender(
-  templateRender: TemplateRender | TemplateRenderSnapshot,
+export async function uninsertUsingTemplateRenderSnapshot(
+  templateRenderSnapshot: TemplateRenderSnapshot,
   basePath: string,
 ) {
-  let to = path.join(basePath, templateRender.attributes.to);
+  let to = path.join(basePath, templateRenderSnapshot.attributes.to);
   let extension = path.extname(to);
 
   switch (extension) {
     case '.md': {
       if (await fs.pathExists(to)) {
         let targetFile = await fs.readFile(to, {encoding: 'utf8'});
-        let newContent = `<!-- ${templateRender.attributes.strategy[1]} --><!-- ${templateRender.attributes.strategy[1]} -->`;
+        let newContent = `<!-- ${templateRenderSnapshot.attributes.strategy[1]} --><!-- ${templateRenderSnapshot.attributes.strategy[1]} -->`;
         let oldContentRegexp = new RegExp(
           `<!--\\s*${_.escapeRegExp(
-            templateRender.attributes.strategy[1],
-          )}\\s-->[\\s\\S]*<!--\\s*${_.escapeRegExp(templateRender.attributes.strategy[1])}\\s-->`,
+            templateRenderSnapshot.attributes.strategy[1],
+          )}\\s-->[\\s\\S]*<!--\\s*${_.escapeRegExp(templateRenderSnapshot.attributes.strategy[1])}\\s-->`,
           'u',
         );
         let newFile = targetFile.replace(oldContentRegexp, newContent);
@@ -34,16 +33,7 @@ export async function uninsertUsingTemplateRender(
     }
 
     default: {
-      throw new CarsonTemplateError('STRATEGY_UNSUPPORTED_EXTENSION', {
-        messageParameters: [
-          templateRender.attributes.strategy,
-          templateRender.template.path,
-          extension,
-        ],
-        data: {
-          path: templateRender.template.path,
-        },
-      });
+      throw new CarsonTemplateError('INVALID_SNAPSHOT');
     }
   }
 }

package/source/template/internals/{unmergeUsingTemplateRender.ts → unmergeUsingTemplateRenderSnapshot.ts}

@@ -5,22 +5,25 @@ import path from 'node:path';
 import yaml from 'yaml';
 
 import {CarsonTemplateError} from '../CarsonTemplateError.js';
-import {type TemplateRender} from '../TemplateRender.js';
 import {prettify} from './prettify.js';
 import {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';
 import {unmerge} from './unmerge.js';
 
-export async function unmergeUsingTemplateRender(
-  templateRender: TemplateRender | TemplateRenderSnapshot,
+export async function unmergeUsingTemplateRenderSnapshot(
+  templateRenderSnapshot: TemplateRenderSnapshot,
   outputPath: string,
 ) {
-  let to = path.join(outputPath, templateRender.attributes.to);
+  let to = path.join(outputPath, templateRenderSnapshot.attributes.to);
   let extension = path.extname(to);
 
+  if (!templateRenderSnapshot.content) {
+    throw new CarsonTemplateError('INVALID_SNAPSHOT');
+  }
+
   switch (extension) {
     case '.json': {
       let targetFile = (await fs.readJson(to)) as Json;
-      let fileToMerge = json.parse<Json>(templateRender.content);
+      let fileToMerge = json.parse<Json>(templateRenderSnapshot.content);
       let newFile = JSON.stringify(unmerge(targetFile, fileToMerge));
 
       await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});
@@ -30,7 +33,7 @@ export async function unmergeUsingTemplateRender(
 
     case '.yaml': {
       let targetFile = yaml.parse(await fs.readFile(to, {encoding: 'utf8'})) as unknown;
-      let fileToMerge = yaml.parse(templateRender.content) as unknown;
+      let fileToMerge = yaml.parse(templateRenderSnapshot.content) as unknown;
       let newFile = yaml.stringify(unmerge(targetFile, fileToMerge));
 
       await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});
@@ -39,16 +42,7 @@ export async function unmergeUsingTemplateRender(
     }
 
     default: {
-      throw new CarsonTemplateError('STRATEGY_UNSUPPORTED_EXTENSION', {
-        messageParameters: [
-          templateRender.attributes.strategy,
-          templateRender.template.path,
-          extension,
-        ],
-        data: {
-          path: templateRender.template.path,
-        },
-      });
+      throw new CarsonTemplateError('INVALID_SNAPSHOT');
     }
   }
 }

package/source/template/internals.ts

@@ -1,5 +1,5 @@
 export * from './internals/createUsingTemplateRender.js';
-export * from './internals/deleteUsingTemplateRender.js';
+export * from './internals/deleteUsingTemplateRenderSnapshot.js';
 export * from './internals/importCarsonTemplate.js';
 export * from './internals/insertUsingTemplateRender.js';
 export * from './internals/loadTemplateRenderSnapshots.js';
@@ -11,8 +11,9 @@ export * from './internals/prettify.js';
 export * from './internals/readCarsonTemplate.js';
 export * from './internals/resolveModule.js';
 export * from './internals/saveTemplateRenderSnapshots.js';
+export * from './internals/simplify.js';
 export * from './internals/TemplateRenderSnapshot.js';
 export * from './internals/TemplateRenderSnapshots.js';
-export * from './internals/uninsertUsingTemplateRender.js';
+export * from './internals/uninsertUsingTemplateRenderSnapshot.js';
 export * from './internals/unmerge.js';
-export * from './internals/unmergeUsingTemplateRender.js';
+export * from './internals/unmergeUsingTemplateRenderSnapshot.js';

package/build/template/internals/deleteUsingTemplateRender.d.ts

@@ -1,6 +0,0 @@
-import { type TemplateRender } from '../TemplateRender.js';
-import { type TemplateRenderSnapshot } from './TemplateRenderSnapshot.js';
-export type DeleteUsingTemplateRenderOptions = {
-    onlyDeleteWhenContentsMatch?: boolean;
-};
-export declare function deleteUsingTemplateRender(templateRender: TemplateRender | TemplateRenderSnapshot, basePath: string, options?: DeleteUsingTemplateRenderOptions): Promise<void>;

package/build/template/internals/deleteUsingTemplateRender.js

@@ -1,20 +0,0 @@
-"use strict";
-import fs from "fs-extra";
-import path from "node:path";
-import { prettify } from "./prettify.js";
-export async function deleteUsingTemplateRender(templateRender, basePath, options) {
-  let to = path.join(basePath, templateRender.attributes.to);
-  if (!await fs.pathExists(to)) {
-    return;
-  }
-  if (options?.onlyDeleteWhenContentsMatch) {
-    let existingContent = await fs.readFile(to, { encoding: "utf8" });
-    let newContent = await prettify(templateRender.content, to);
-    if (existingContent.trim() === newContent.trim()) {
-      await fs.rm(to);
-    }
-    return;
-  }
-  await fs.rm(to);
-}
-//# sourceMappingURL=deleteUsingTemplateRender.js.map

package/build/template/internals/deleteUsingTemplateRender.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../source/template/internals/deleteUsingTemplateRender.ts"],
-  "sourcesContent": ["import fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {type TemplateRender} from '../TemplateRender.js';\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\n\nexport type DeleteUsingTemplateRenderOptions = {\n  onlyDeleteWhenContentsMatch?: boolean;\n};\n\nexport async function deleteUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n  options?: DeleteUsingTemplateRenderOptions,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n\n  if (!(await fs.pathExists(to))) {\n    return;\n  }\n\n  if (options?.onlyDeleteWhenContentsMatch) {\n    let existingContent = await fs.readFile(to, {encoding: 'utf8'});\n    let newContent = await prettify(templateRender.content, to);\n\n    if (existingContent.trim() === newContent.trim()) {\n      await fs.rm(to);\n    }\n\n    return;\n  }\n\n  await fs.rm(to);\n}\n"],
-  "mappings": ";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAGjB,SAAQ,gBAAe;AAOvB,sBAAsB,0BACpB,gBACA,UACA,SACA;AACA,MAAI,KAAK,KAAK,KAAK,UAAU,eAAe,WAAW,EAAE;AAEzD,MAAI,CAAE,MAAM,GAAG,WAAW,EAAE,GAAI;AAC9B;AAAA,EACF;AAEA,MAAI,SAAS,6BAA6B;AACxC,QAAI,kBAAkB,MAAM,GAAG,SAAS,IAAI,EAAC,UAAU,OAAM,CAAC;AAC9D,QAAI,aAAa,MAAM,SAAS,eAAe,SAAS,EAAE;AAE1D,QAAI,gBAAgB,KAAK,MAAM,WAAW,KAAK,GAAG;AAChD,YAAM,GAAG,GAAG,EAAE;AAAA,IAChB;AAEA;AAAA,EACF;AAEA,QAAM,GAAG,GAAG,EAAE;AAChB;",
-  "names": []
-}

package/build/template/internals/uninsertUsingTemplateRender.d.ts

@@ -1,3 +0,0 @@
-import { type TemplateRender } from '../TemplateRender.js';
-import { type TemplateRenderSnapshot } from './TemplateRenderSnapshot.js';
-export declare function uninsertUsingTemplateRender(templateRender: TemplateRender | TemplateRenderSnapshot, basePath: string): Promise<void>;