@jakubmazanec/carson 0.2.0 → 0.2.1-unstable.9ab3865

package/README.md

@@ -329,14 +329,14 @@ file format detection by Prettier.
 Attribute `strategy` describes how exactly should the template render be written, or whether it
 should be written at all.
 
-| Strategy name | Example `strategy` value | Description                                                                                                                                                                                                                     |
-| ------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Create        | `'create'`               | The template render is written to the target file, but only when the Carson template is used to create a new workspace or project; when Carson performs an update, the template files with this strategy are not even rendered. |
-| Ensure        | `'ensure'`               | The template render is written to the target file, but only when the target file doesn't exist; if it does, it is left unchanged.                                                                                               |
-| Overwrite     | `'overwrite'`            | The template render is written to the target file, overwriting its existing content.                                                                                                                                            |
-| Merge         | `'merge'`                | The template render is merged with the target file's existing content. Only simple objects, not arrays, are merged recursively. The only supported file formats are JSON and YAML.                                              |
-| Check         | `'check'`                | Only the target file's existence is checked, the template render is discarded; when Carson doesn't perform an update, the template files with this strategy are not even rendered.                                              |
-| Insert        | `['insert', <string>]`   | The template render is inserted between the first and last occurrence of an HTML comment containing configured string, e.g. `<!-- foobar -->`. The only supported file format is Markdown.                                      |
+| Strategy name | Example `strategy` value | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| ------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Create        | `'create'`               | The template render is written to the target file, but only when the Carson template is used to create a new workspace or project; when Carson performs an update, the template files with this strategy are not even rendered. If the target file already exists and its format is JSON or YAML, the template render is merged with the target file's existing content (otherwise it's overwritten). Only simple objects, not arrays, are merged recursively. |
+| Ensure        | `'ensure'`               | The template render is written to the target file, but only when the target file doesn't exist; if it does, it is left unchanged.                                                                                                                                                                                                                                                                                                                              |
+| Overwrite     | `'overwrite'`            | The template render is written to the target file, overwriting its existing content.                                                                                                                                                                                                                                                                                                                                                                           |
+| Merge         | `'merge'`                | The template render is merged with the target file's existing content. Only simple objects, not arrays, are merged recursively. The only supported file formats are JSON and YAML. If the target file doesn't exist, it is created.                                                                                                                                                                                                                            |
+| Check         | `'check'`                | Only the target file's existence is checked, the template render is discarded; when Carson doesn't perform an update, the template files with this strategy are not even rendered.                                                                                                                                                                                                                                                                             |
+| Insert        | `['insert', <string>]`   | The template render is inserted between the first and last occurrence of an HTML comment containing configured string, e.g. `<!-- foobar -->`. The only supported file format is Markdown.                                                                                                                                                                                                                                                                     |
 
 The rest of the template file after the front matter is the actual EJS template. Please read
 [`ejs` documentation](https://ejs.co/#docs) to find out in more detail how they work.

package/dist/constants.d.ts

@@ -3,6 +3,8 @@ export declare const CARSON_CONFIG_DIRECTORY = ".carson";
 export declare const PROJECT_CONFIG_FILENAME = "project.json";
 export declare const WORKSPACE_CONFIG_FILENAME = "workspace.json";
 export declare const SNAPSHOTS_FILENAME = ".snapshots";
+export declare const PROJECT_SNAPSHOT_FILENAME = "project.snapshot";
+export declare const WORKSPACE_SNAPSHOT_FILENAME = "workspace.snapshot";
 export declare const TEMPLATES_PATH = "templates";
 export declare const TEMPLATE_CONFIG_FILENAME = "config.json";
 export declare const PACKAGE_JSON_FILENAME = "package.json";

package/dist/constants.js

@@ -6,6 +6,8 @@ export const CARSON_CONFIG_DIRECTORY = '.carson';
 export const PROJECT_CONFIG_FILENAME = 'project.json';
 export const WORKSPACE_CONFIG_FILENAME = 'workspace.json';
 export const SNAPSHOTS_FILENAME = '.snapshots';
+export const PROJECT_SNAPSHOT_FILENAME = 'project.snapshot';
+export const WORKSPACE_SNAPSHOT_FILENAME = 'workspace.snapshot';
 export const TEMPLATES_PATH = 'templates';
 export const TEMPLATE_CONFIG_FILENAME = 'config.json';
 export const PACKAGE_JSON_FILENAME = 'package.json';

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["import path from 'node:path';\nimport url from 'node:url';\n\nlet directory = path.dirname(url.fileURLToPath(import.meta.url));\n\nexport const PACKAGE_PATH = path.resolve(directory, '..');\n\nexport const CARSON_CONFIG_DIRECTORY = '.carson';\nexport const PROJECT_CONFIG_FILENAME = 'project.json';\nexport const WORKSPACE_CONFIG_FILENAME = 'workspace.json';\nexport const SNAPSHOTS_FILENAME = '.snapshots';\nexport const TEMPLATES_PATH = 'templates';\nexport const TEMPLATE_CONFIG_FILENAME = 'config.json';\nexport const PACKAGE_JSON_FILENAME = 'package.json';\n"],"names":["path","url","directory","dirname","fileURLToPath","PACKAGE_PATH","resolve","CARSON_CONFIG_DIRECTORY","PROJECT_CONFIG_FILENAME","WORKSPACE_CONFIG_FILENAME","SNAPSHOTS_FILENAME","TEMPLATES_PATH","TEMPLATE_CONFIG_FILENAME","PACKAGE_JSON_FILENAME"],"mappings":"AAAA,OAAOA,UAAU,YAAY;AAC7B,OAAOC,SAAS,WAAW;AAE3B,IAAIC,YAAYF,KAAKG,OAAO,CAACF,IAAIG,aAAa,CAAC,YAAYH,GAAG;AAE9D,OAAO,MAAMI,eAAeL,KAAKM,OAAO,CAACJ,WAAW,MAAM;AAE1D,OAAO,MAAMK,0BAA0B,UAAU;AACjD,OAAO,MAAMC,0BAA0B,eAAe;AACtD,OAAO,MAAMC,4BAA4B,iBAAiB;AAC1D,OAAO,MAAMC,qBAAqB,aAAa;AAC/C,OAAO,MAAMC,iBAAiB,YAAY;AAC1C,OAAO,MAAMC,2BAA2B,cAAc;AACtD,OAAO,MAAMC,wBAAwB,eAAe"}
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["import path from 'node:path';\nimport url from 'node:url';\n\nlet directory = path.dirname(url.fileURLToPath(import.meta.url));\n\nexport const PACKAGE_PATH = path.resolve(directory, '..');\n\nexport const CARSON_CONFIG_DIRECTORY = '.carson';\nexport const PROJECT_CONFIG_FILENAME = 'project.json';\nexport const WORKSPACE_CONFIG_FILENAME = 'workspace.json';\nexport const SNAPSHOTS_FILENAME = '.snapshots';\nexport const PROJECT_SNAPSHOT_FILENAME = 'project.snapshot';\nexport const WORKSPACE_SNAPSHOT_FILENAME = 'workspace.snapshot';\nexport const TEMPLATES_PATH = 'templates';\nexport const TEMPLATE_CONFIG_FILENAME = 'config.json';\nexport const PACKAGE_JSON_FILENAME = 'package.json';\n"],"names":["path","url","directory","dirname","fileURLToPath","PACKAGE_PATH","resolve","CARSON_CONFIG_DIRECTORY","PROJECT_CONFIG_FILENAME","WORKSPACE_CONFIG_FILENAME","SNAPSHOTS_FILENAME","PROJECT_SNAPSHOT_FILENAME","WORKSPACE_SNAPSHOT_FILENAME","TEMPLATES_PATH","TEMPLATE_CONFIG_FILENAME","PACKAGE_JSON_FILENAME"],"mappings":"AAAA,OAAOA,UAAU,YAAY;AAC7B,OAAOC,SAAS,WAAW;AAE3B,IAAIC,YAAYF,KAAKG,OAAO,CAACF,IAAIG,aAAa,CAAC,YAAYH,GAAG;AAE9D,OAAO,MAAMI,eAAeL,KAAKM,OAAO,CAACJ,WAAW,MAAM;AAE1D,OAAO,MAAMK,0BAA0B,UAAU;AACjD,OAAO,MAAMC,0BAA0B,eAAe;AACtD,OAAO,MAAMC,4BAA4B,iBAAiB;AAC1D,OAAO,MAAMC,qBAAqB,aAAa;AAC/C,OAAO,MAAMC,4BAA4B,mBAAmB;AAC5D,OAAO,MAAMC,8BAA8B,qBAAqB;AAChE,OAAO,MAAMC,iBAAiB,YAAY;AAC1C,OAAO,MAAMC,2BAA2B,cAAc;AACtD,OAAO,MAAMC,wBAAwB,eAAe"}

package/dist/template/applyTemplateRenders.d.ts

@@ -1,10 +1,11 @@
 import { type TemplateRenders } from './TemplateRenders.js';
 export type ApplyTemplateRendersOptions = {
     templateRenders: TemplateRenders;
-    path: string;
+    targetPath: string;
+    snapshotPath: string;
     ignoreStrategies: string[];
 };
 /**
  * Applies rendered Carson template to a specified path, i.e. creates and updates files based on the result of rendering each Carson template file.
  */
-export declare function applyTemplateRenders({ templateRenders, path: targetPath, ignoreStrategies, }: ApplyTemplateRendersOptions): Promise<void>;
+export declare function applyTemplateRenders({ templateRenders, targetPath, snapshotPath, ignoreStrategies, }: ApplyTemplateRendersOptions): Promise<void>;

package/dist/template/applyTemplateRenders.js

@@ -7,13 +7,19 @@ import { createUsingTemplateRender, deleteUsingTemplateRender, insertUsingTempla
 import { CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME } from '../constants.js';
 /**
  * Applies rendered Carson template to a specified path, i.e. creates and updates files based on the result of rendering each Carson template file.
- */ export async function applyTemplateRenders({ templateRenders, path: targetPath, ignoreStrategies }) {
+ */ export async function applyTemplateRenders({ templateRenders, targetPath, snapshotPath, ignoreStrategies }) {
     // we need to clear Prettier cache, because we are changing file system
     await prettier.clearConfigCache();
+    // TODO: remove all logic about legacy snapshots after Carson reaches v1
+    // use previous version of snapshot file if it exists
+    let legacySnapshotPath = path.join(targetPath, CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME);
+    if (await fs.pathExists(legacySnapshotPath)) {
+        // eslint-disable-next-line no-param-reassign -- needed; also, this is temporary feature
+        snapshotPath = legacySnapshotPath;
+    }
     // first, we read the existing snapshots and use them to undo previous changes
-    let templateRenderSnapshotsPath = path.join(targetPath, CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME);
-    if (await fs.pathExists(templateRenderSnapshotsPath)) {
-        let templateRenderSnapshots = await loadTemplateRenderSnapshots(templateRenderSnapshotsPath);
+    if (await fs.pathExists(snapshotPath)) {
+        let templateRenderSnapshots = await loadTemplateRenderSnapshots(snapshotPath);
         for (let templateRenderSnapshot of templateRenderSnapshots){
             let strategy = typeof templateRenderSnapshot.attributes.strategy === 'string' ? templateRenderSnapshot.attributes.strategy : templateRenderSnapshot.attributes.strategy[0];
             if (ignoreStrategies.includes(strategy)) {
@@ -85,7 +91,11 @@ import { CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME } from '../constants.js';
         }
     }
     await fs.ensureDir(path.join(targetPath, CARSON_CONFIG_DIRECTORY));
-    await saveTemplateRenderSnapshots(templateRenders, templateRenderSnapshotsPath);
+    await saveTemplateRenderSnapshots(templateRenders, snapshotPath);
+    // delete legacy snapshots
+    if (await fs.pathExists(legacySnapshotPath)) {
+        await fs.rm(legacySnapshotPath);
+    }
 }
 
 //# sourceMappingURL=applyTemplateRenders.js.map

package/dist/template/applyTemplateRenders.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/template/applyTemplateRenders.ts"],"sourcesContent":["// TODO: can this be fixed?\n/* eslint-disable complexity -- TODO */\nimport fs from 'fs-extra';\nimport path from 'node:path';\nimport prettier from 'prettier';\n\nimport {CarsonTemplateError} from './CarsonTemplateError.js';\nimport {\n  createUsingTemplateRender,\n  deleteUsingTemplateRender,\n  insertUsingTemplateRender,\n  loadTemplateRenderSnapshots,\n  mergeUsingTemplateRender,\n  overwriteUsingTemplateRender,\n  saveTemplateRenderSnapshots,\n  uninsertUsingTemplateRender,\n  unmergeUsingTemplateRender,\n} from './internals.js';\nimport {type TemplateRenders} from './TemplateRenders.js';\nimport {CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME} from '../constants.js';\n\nexport type ApplyTemplateRendersOptions = {\n  templateRenders: TemplateRenders;\n  path: string;\n  ignoreStrategies: string[];\n};\n\n/**\n * Applies rendered Carson template to a specified path, i.e. creates and updates files based on the result of rendering each Carson template file.\n */\nexport async function applyTemplateRenders({\n  templateRenders,\n  path: targetPath,\n  ignoreStrategies,\n}: ApplyTemplateRendersOptions) {\n  // we need to clear Prettier cache, because we are changing file system\n  await prettier.clearConfigCache();\n\n  // first, we read the existing snapshots and use them to undo previous changes\n  let templateRenderSnapshotsPath = path.join(\n    targetPath,\n    CARSON_CONFIG_DIRECTORY,\n    SNAPSHOTS_FILENAME,\n  );\n\n  if (await fs.pathExists(templateRenderSnapshotsPath)) {\n    let templateRenderSnapshots = await loadTemplateRenderSnapshots(templateRenderSnapshotsPath);\n\n    for (let templateRenderSnapshot of templateRenderSnapshots) {\n      let strategy =\n        typeof templateRenderSnapshot.attributes.strategy === 'string'\n          ? templateRenderSnapshot.attributes.strategy\n          : templateRenderSnapshot.attributes.strategy[0];\n\n      if (ignoreStrategies.includes(strategy)) {\n        continue;\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'ensure') {\n        await deleteUsingTemplateRender(templateRenderSnapshot, targetPath, {\n          onlyDeleteWhenContentsMatch: true,\n        });\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'overwrite') {\n        await deleteUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'merge') {\n        await unmergeUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n\n      if (templateRenderSnapshot.attributes.strategy[0] === 'insert') {\n        await uninsertUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n    }\n  }\n\n  // second, we apply strategies that create files\n  for (let templateRender of templateRenders) {\n    let strategy =\n      typeof templateRender.attributes.strategy === 'string'\n        ? templateRender.attributes.strategy\n        : templateRender.attributes.strategy[0];\n\n    if (ignoreStrategies.includes(strategy)) {\n      continue;\n    }\n\n    if (templateRender.attributes.strategy === 'create') {\n      await createUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'ensure') {\n      let to = path.join(targetPath, templateRender.attributes.to);\n      let doesToExist = await fs.pathExists(to);\n\n      if (!doesToExist) {\n        await createUsingTemplateRender(templateRender, targetPath);\n      }\n    }\n  }\n\n  // third, we apply strategies that change files\n  for (let templateRender of templateRenders) {\n    let strategy =\n      typeof templateRender.attributes.strategy === 'string'\n        ? templateRender.attributes.strategy\n        : templateRender.attributes.strategy[0];\n\n    if (ignoreStrategies.includes(strategy)) {\n      continue;\n    }\n\n    if (templateRender.attributes.strategy === 'overwrite') {\n      await overwriteUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'merge') {\n      await mergeUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy[0] === 'insert') {\n      await insertUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'check') {\n      let to = path.join(targetPath, templateRender.attributes.to);\n      let doesToExist = await fs.pathExists(to);\n\n      if (!doesToExist) {\n        throw new CarsonTemplateError('STRATEGY_MISSING_FILE', {\n          messageParameters: [templateRender.attributes.strategy, templateRender.template.path, to],\n          data: {\n            path: to,\n          },\n        });\n      }\n    }\n  }\n\n  await fs.ensureDir(path.join(targetPath, CARSON_CONFIG_DIRECTORY));\n\n  await saveTemplateRenderSnapshots(templateRenders, templateRenderSnapshotsPath);\n}\n"],"names":["fs","path","prettier","CarsonTemplateError","createUsingTemplateRender","deleteUsingTemplateRender","insertUsingTemplateRender","loadTemplateRenderSnapshots","mergeUsingTemplateRender","overwriteUsingTemplateRender","saveTemplateRenderSnapshots","uninsertUsingTemplateRender","unmergeUsingTemplateRender","CARSON_CONFIG_DIRECTORY","SNAPSHOTS_FILENAME","applyTemplateRenders","templateRenders","targetPath","ignoreStrategies","clearConfigCache","templateRenderSnapshotsPath","join","pathExists","templateRenderSnapshots","templateRenderSnapshot","strategy","attributes","includes","onlyDeleteWhenContentsMatch","templateRender","to","doesToExist","messageParameters","template","data","ensureDir"],"mappings":"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"}
+{"version":3,"sources":["../../src/template/applyTemplateRenders.ts"],"sourcesContent":["// TODO: can this be fixed?\n/* eslint-disable complexity -- TODO */\nimport fs from 'fs-extra';\nimport path from 'node:path';\nimport prettier from 'prettier';\n\nimport {CarsonTemplateError} from './CarsonTemplateError.js';\nimport {\n  createUsingTemplateRender,\n  deleteUsingTemplateRender,\n  insertUsingTemplateRender,\n  loadTemplateRenderSnapshots,\n  mergeUsingTemplateRender,\n  overwriteUsingTemplateRender,\n  saveTemplateRenderSnapshots,\n  uninsertUsingTemplateRender,\n  unmergeUsingTemplateRender,\n} from './internals.js';\nimport {type TemplateRenders} from './TemplateRenders.js';\nimport {CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME} from '../constants.js';\n\nexport type ApplyTemplateRendersOptions = {\n  templateRenders: TemplateRenders;\n  targetPath: string;\n  snapshotPath: string;\n  ignoreStrategies: string[];\n};\n\n/**\n * Applies rendered Carson template to a specified path, i.e. creates and updates files based on the result of rendering each Carson template file.\n */\nexport async function applyTemplateRenders({\n  templateRenders,\n  targetPath,\n  snapshotPath,\n  ignoreStrategies,\n}: ApplyTemplateRendersOptions) {\n  // we need to clear Prettier cache, because we are changing file system\n  await prettier.clearConfigCache();\n\n  // TODO: remove all logic about legacy snapshots after Carson reaches v1\n  // use previous version of snapshot file if it exists\n  let legacySnapshotPath = path.join(targetPath, CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME);\n\n  if (await fs.pathExists(legacySnapshotPath)) {\n    // eslint-disable-next-line no-param-reassign -- needed; also, this is temporary feature\n    snapshotPath = legacySnapshotPath;\n  }\n\n  // first, we read the existing snapshots and use them to undo previous changes\n  if (await fs.pathExists(snapshotPath)) {\n    let templateRenderSnapshots = await loadTemplateRenderSnapshots(snapshotPath);\n\n    for (let templateRenderSnapshot of templateRenderSnapshots) {\n      let strategy =\n        typeof templateRenderSnapshot.attributes.strategy === 'string'\n          ? templateRenderSnapshot.attributes.strategy\n          : templateRenderSnapshot.attributes.strategy[0];\n\n      if (ignoreStrategies.includes(strategy)) {\n        continue;\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'ensure') {\n        await deleteUsingTemplateRender(templateRenderSnapshot, targetPath, {\n          onlyDeleteWhenContentsMatch: true,\n        });\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'overwrite') {\n        await deleteUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'merge') {\n        await unmergeUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n\n      if (templateRenderSnapshot.attributes.strategy[0] === 'insert') {\n        await uninsertUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n    }\n  }\n\n  // second, we apply strategies that create files\n  for (let templateRender of templateRenders) {\n    let strategy =\n      typeof templateRender.attributes.strategy === 'string'\n        ? templateRender.attributes.strategy\n        : templateRender.attributes.strategy[0];\n\n    if (ignoreStrategies.includes(strategy)) {\n      continue;\n    }\n\n    if (templateRender.attributes.strategy === 'create') {\n      await createUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'ensure') {\n      let to = path.join(targetPath, templateRender.attributes.to);\n      let doesToExist = await fs.pathExists(to);\n\n      if (!doesToExist) {\n        await createUsingTemplateRender(templateRender, targetPath);\n      }\n    }\n  }\n\n  // third, we apply strategies that change files\n  for (let templateRender of templateRenders) {\n    let strategy =\n      typeof templateRender.attributes.strategy === 'string'\n        ? templateRender.attributes.strategy\n        : templateRender.attributes.strategy[0];\n\n    if (ignoreStrategies.includes(strategy)) {\n      continue;\n    }\n\n    if (templateRender.attributes.strategy === 'overwrite') {\n      await overwriteUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'merge') {\n      await mergeUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy[0] === 'insert') {\n      await insertUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'check') {\n      let to = path.join(targetPath, templateRender.attributes.to);\n      let doesToExist = await fs.pathExists(to);\n\n      if (!doesToExist) {\n        throw new CarsonTemplateError('STRATEGY_MISSING_FILE', {\n          messageParameters: [templateRender.attributes.strategy, templateRender.template.path, to],\n          data: {\n            path: to,\n          },\n        });\n      }\n    }\n  }\n\n  await fs.ensureDir(path.join(targetPath, CARSON_CONFIG_DIRECTORY));\n\n  await saveTemplateRenderSnapshots(templateRenders, snapshotPath);\n\n  // delete legacy snapshots\n  if (await fs.pathExists(legacySnapshotPath)) {\n    await fs.rm(legacySnapshotPath);\n  }\n}\n"],"names":["fs","path","prettier","CarsonTemplateError","createUsingTemplateRender","deleteUsingTemplateRender","insertUsingTemplateRender","loadTemplateRenderSnapshots","mergeUsingTemplateRender","overwriteUsingTemplateRender","saveTemplateRenderSnapshots","uninsertUsingTemplateRender","unmergeUsingTemplateRender","CARSON_CONFIG_DIRECTORY","SNAPSHOTS_FILENAME","applyTemplateRenders","templateRenders","targetPath","snapshotPath","ignoreStrategies","clearConfigCache","legacySnapshotPath","join","pathExists","templateRenderSnapshots","templateRenderSnapshot","strategy","attributes","includes","onlyDeleteWhenContentsMatch","templateRender","to","doesToExist","messageParameters","template","data","ensureDir","rm"],"mappings":"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"}

package/dist/template/internals/createUsingTemplateRender.js

@@ -1,12 +1,57 @@
 import fs from 'fs-extra';
+import json from 'json5';
 import path from 'node:path';
+import yaml from 'yaml';
+import { merge } from './merge.js';
 import { prettify } from './prettify.js';
 export async function createUsingTemplateRender(templateRender, basePath) {
     let to = path.join(basePath, templateRender.attributes.to);
-    await fs.ensureDir(path.dirname(to));
-    await fs.writeFile(to, await prettify(templateRender.content, to), {
-        encoding: 'utf8'
-    });
+    let extension = path.extname(to);
+    switch(extension){
+        case '.json':
+            {
+                if (await fs.pathExists(to)) {
+                    let targetFile = await fs.readJson(to);
+                    let fileToMerge = json.parse(templateRender.content);
+                    let newFile = JSON.stringify(merge(targetFile, fileToMerge), null, 2);
+                    await fs.writeFile(to, await prettify(newFile, to), {
+                        encoding: 'utf8'
+                    });
+                } else {
+                    await fs.ensureDir(path.dirname(to));
+                    await fs.writeFile(to, await prettify(templateRender.content, to), {
+                        encoding: 'utf8'
+                    });
+                }
+                break;
+            }
+        case '.yaml':
+            {
+                if (await fs.pathExists(to)) {
+                    let targetFile = yaml.parse(await fs.readFile(to, {
+                        encoding: 'utf8'
+                    }));
+                    let fileToMerge = yaml.parse(templateRender.content);
+                    let newFile = yaml.stringify(merge(targetFile, fileToMerge));
+                    await fs.writeFile(to, await prettify(newFile, to), {
+                        encoding: 'utf8'
+                    });
+                } else {
+                    await fs.writeFile(to, await prettify(templateRender.content, to), {
+                        encoding: 'utf8'
+                    });
+                }
+                break;
+            }
+        default:
+            {
+                await fs.ensureDir(path.dirname(to));
+                await fs.writeFile(to, await prettify(templateRender.content, to), {
+                    encoding: 'utf8'
+                });
+                break;
+            }
+    }
 }
 
 //# sourceMappingURL=createUsingTemplateRender.js.map

package/dist/template/internals/createUsingTemplateRender.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/template/internals/createUsingTemplateRender.ts"],"sourcesContent":["import fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport async function createUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n\n  await fs.ensureDir(path.dirname(to));\n  await fs.writeFile(to, await prettify(templateRender.content, to), {encoding: 'utf8'});\n}\n"],"names":["fs","path","prettify","createUsingTemplateRender","templateRender","basePath","to","join","attributes","ensureDir","dirname","writeFile","content","encoding"],"mappings":"AAAA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAE7B,SAAQC,QAAQ,QAAO,gBAAgB;AAIvC,OAAO,eAAeC,0BACpBC,cAAuD,EACvDC,QAAgB;IAEhB,IAAIC,KAAKL,KAAKM,IAAI,CAACF,UAAUD,eAAeI,UAAU,CAACF,EAAE;IAEzD,MAAMN,GAAGS,SAAS,CAACR,KAAKS,OAAO,CAACJ;IAChC,MAAMN,GAAGW,SAAS,CAACL,IAAI,MAAMJ,SAASE,eAAeQ,OAAO,EAAEN,KAAK;QAACO,UAAU;IAAM;AACtF"}
+{"version":3,"sources":["../../../src/template/internals/createUsingTemplateRender.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 {merge} from './merge.js';\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport async function createUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n  let extension = path.extname(to);\n\n  switch (extension) {\n    case '.json': {\n      if (await fs.pathExists(to)) {\n        let targetFile = (await fs.readJson(to)) as Json;\n        let fileToMerge = json.parse<Json>(templateRender.content);\n        let newFile = JSON.stringify(merge(targetFile, fileToMerge), null, 2);\n\n        await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n      } else {\n        await fs.ensureDir(path.dirname(to));\n        await fs.writeFile(to, await prettify(templateRender.content, to), {encoding: 'utf8'});\n      }\n\n      break;\n    }\n\n    case '.yaml': {\n      if (await fs.pathExists(to)) {\n        let targetFile = yaml.parse(await fs.readFile(to, {encoding: 'utf8'})) as unknown;\n        let fileToMerge = yaml.parse(templateRender.content) as unknown;\n        let newFile = yaml.stringify(merge(targetFile, fileToMerge));\n\n        await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n      } else {\n        await fs.writeFile(to, await prettify(templateRender.content, to), {encoding: 'utf8'});\n      }\n\n      break;\n    }\n\n    default: {\n      await fs.ensureDir(path.dirname(to));\n      await fs.writeFile(to, await prettify(templateRender.content, to), {encoding: 'utf8'});\n\n      break;\n    }\n  }\n}\n"],"names":["fs","json","path","yaml","merge","prettify","createUsingTemplateRender","templateRender","basePath","to","join","attributes","extension","extname","pathExists","targetFile","readJson","fileToMerge","parse","content","newFile","JSON","stringify","writeFile","encoding","ensureDir","dirname","readFile"],"mappings":"AACA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,QAAQ;AACzB,OAAOC,UAAU,YAAY;AAC7B,OAAOC,UAAU,OAAO;AAExB,SAAQC,KAAK,QAAO,aAAa;AACjC,SAAQC,QAAQ,QAAO,gBAAgB;AAIvC,OAAO,eAAeC,0BACpBC,cAAuD,EACvDC,QAAgB;IAEhB,IAAIC,KAAKP,KAAKQ,IAAI,CAACF,UAAUD,eAAeI,UAAU,CAACF,EAAE;IACzD,IAAIG,YAAYV,KAAKW,OAAO,CAACJ;IAE7B,OAAQG;QACN,KAAK;YAAS;gBACZ,IAAI,MAAMZ,GAAGc,UAAU,CAACL,KAAK;oBAC3B,IAAIM,aAAc,MAAMf,GAAGgB,QAAQ,CAACP;oBACpC,IAAIQ,cAAchB,KAAKiB,KAAK,CAAOX,eAAeY,OAAO;oBACzD,IAAIC,UAAUC,KAAKC,SAAS,CAAClB,MAAMW,YAAYE,cAAc,MAAM;oBAEnE,MAAMjB,GAAGuB,SAAS,CAACd,IAAI,MAAMJ,SAASe,SAASX,KAAK;wBAACe,UAAU;oBAAM;gBACvE,OAAO;oBACL,MAAMxB,GAAGyB,SAAS,CAACvB,KAAKwB,OAAO,CAACjB;oBAChC,MAAMT,GAAGuB,SAAS,CAACd,IAAI,MAAMJ,SAASE,eAAeY,OAAO,EAAEV,KAAK;wBAACe,UAAU;oBAAM;gBACtF;gBAEA;YACF;QAEA,KAAK;YAAS;gBACZ,IAAI,MAAMxB,GAAGc,UAAU,CAACL,KAAK;oBAC3B,IAAIM,aAAaZ,KAAKe,KAAK,CAAC,MAAMlB,GAAG2B,QAAQ,CAAClB,IAAI;wBAACe,UAAU;oBAAM;oBACnE,IAAIP,cAAcd,KAAKe,KAAK,CAACX,eAAeY,OAAO;oBACnD,IAAIC,UAAUjB,KAAKmB,SAAS,CAAClB,MAAMW,YAAYE;oBAE/C,MAAMjB,GAAGuB,SAAS,CAACd,IAAI,MAAMJ,SAASe,SAASX,KAAK;wBAACe,UAAU;oBAAM;gBACvE,OAAO;oBACL,MAAMxB,GAAGuB,SAAS,CAACd,IAAI,MAAMJ,SAASE,eAAeY,OAAO,EAAEV,KAAK;wBAACe,UAAU;oBAAM;gBACtF;gBAEA;YACF;QAEA;YAAS;gBACP,MAAMxB,GAAGyB,SAAS,CAACvB,KAAKwB,OAAO,CAACjB;gBAChC,MAAMT,GAAGuB,SAAS,CAACd,IAAI,MAAMJ,SAASE,eAAeY,OAAO,EAAEV,KAAK;oBAACe,UAAU;gBAAM;gBAEpF;YACF;IACF;AACF"}

package/dist/template/internals/mergeUsingTemplateRender.js

@@ -11,24 +11,36 @@ export async function mergeUsingTemplateRender(templateRender, basePath) {
     switch(extension){
         case '.json':
             {
-                let targetFile = await fs.readJson(to);
-                let fileToMerge = json.parse(templateRender.content);
-                let newFile = JSON.stringify(merge(targetFile, fileToMerge));
-                await fs.writeFile(to, await prettify(newFile, to), {
-                    encoding: 'utf8'
-                });
+                if (await fs.pathExists(to)) {
+                    let targetFile = await fs.readJson(to);
+                    let fileToMerge = json.parse(templateRender.content);
+                    let newFile = JSON.stringify(merge(targetFile, fileToMerge), null, 2);
+                    await fs.writeFile(to, await prettify(newFile, to), {
+                        encoding: 'utf8'
+                    });
+                } else {
+                    await fs.writeFile(to, await prettify(templateRender.content, to), {
+                        encoding: 'utf8'
+                    });
+                }
                 break;
             }
         case '.yaml':
             {
-                let targetFile = yaml.parse(await fs.readFile(to, {
-                    encoding: 'utf8'
-                }));
-                let fileToMerge = yaml.parse(templateRender.content);
-                let newFile = yaml.stringify(merge(targetFile, fileToMerge));
-                await fs.writeFile(to, await prettify(newFile, to), {
-                    encoding: 'utf8'
-                });
+                if (await fs.pathExists(to)) {
+                    let targetFile = yaml.parse(await fs.readFile(to, {
+                        encoding: 'utf8'
+                    }));
+                    let fileToMerge = yaml.parse(templateRender.content);
+                    let newFile = yaml.stringify(merge(targetFile, fileToMerge));
+                    await fs.writeFile(to, await prettify(newFile, to), {
+                        encoding: 'utf8'
+                    });
+                } else {
+                    await fs.writeFile(to, await prettify(templateRender.content, to), {
+                        encoding: 'utf8'
+                    });
+                }
                 break;
             }
         default:

package/dist/template/internals/mergeUsingTemplateRender.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/template/internals/mergeUsingTemplateRender.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 {merge} from './merge.js';\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {CarsonTemplateError} from '../CarsonTemplateError.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport async function mergeUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n  let extension = path.extname(to);\n\n  switch (extension) {\n    case '.json': {\n      let targetFile = (await fs.readJson(to)) as Json;\n      let fileToMerge = json.parse<Json>(templateRender.content);\n      let newFile = JSON.stringify(merge(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(templateRender.content) as unknown;\n      let newFile = yaml.stringify(merge(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('STRATEGY_UNSUPPORTED_EXTENSION', {\n        messageParameters: [\n          templateRender.attributes.strategy,\n          templateRender.template.path,\n          extension,\n        ],\n        data: {\n          path: templateRender.template.path,\n        },\n      });\n    }\n  }\n}\n"],"names":["fs","json","path","yaml","merge","prettify","CarsonTemplateError","mergeUsingTemplateRender","templateRender","basePath","to","join","attributes","extension","extname","targetFile","readJson","fileToMerge","parse","content","newFile","JSON","stringify","writeFile","encoding","readFile","messageParameters","strategy","template","data"],"mappings":"AACA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,QAAQ;AACzB,OAAOC,UAAU,YAAY;AAC7B,OAAOC,UAAU,OAAO;AAExB,SAAQC,KAAK,QAAO,aAAa;AACjC,SAAQC,QAAQ,QAAO,gBAAgB;AAEvC,SAAQC,mBAAmB,QAAO,4BAA4B;AAG9D,OAAO,eAAeC,yBACpBC,cAAuD,EACvDC,QAAgB;IAEhB,IAAIC,KAAKR,KAAKS,IAAI,CAACF,UAAUD,eAAeI,UAAU,CAACF,EAAE;IACzD,IAAIG,YAAYX,KAAKY,OAAO,CAACJ;IAE7B,OAAQG;QACN,KAAK;YAAS;gBACZ,IAAIE,aAAc,MAAMf,GAAGgB,QAAQ,CAACN;gBACpC,IAAIO,cAAchB,KAAKiB,KAAK,CAAOV,eAAeW,OAAO;gBACzD,IAAIC,UAAUC,KAAKC,SAAS,CAAClB,MAAMW,YAAYE;gBAE/C,MAAMjB,GAAGuB,SAAS,CAACb,IAAI,MAAML,SAASe,SAASV,KAAK;oBAACc,UAAU;gBAAM;gBAErE;YACF;QAEA,KAAK;YAAS;gBACZ,IAAIT,aAAaZ,KAAKe,KAAK,CAAC,MAAMlB,GAAGyB,QAAQ,CAACf,IAAI;oBAACc,UAAU;gBAAM;gBACnE,IAAIP,cAAcd,KAAKe,KAAK,CAACV,eAAeW,OAAO;gBACnD,IAAIC,UAAUjB,KAAKmB,SAAS,CAAClB,MAAMW,YAAYE;gBAE/C,MAAMjB,GAAGuB,SAAS,CAACb,IAAI,MAAML,SAASe,SAASV,KAAK;oBAACc,UAAU;gBAAM;gBAErE;YACF;QAEA;YAAS;gBACP,MAAM,IAAIlB,oBAAoB,kCAAkC;oBAC9DoB,mBAAmB;wBACjBlB,eAAeI,UAAU,CAACe,QAAQ;wBAClCnB,eAAeoB,QAAQ,CAAC1B,IAAI;wBAC5BW;qBACD;oBACDgB,MAAM;wBACJ3B,MAAMM,eAAeoB,QAAQ,CAAC1B,IAAI;oBACpC;gBACF;YACF;IACF;AACF"}
+{"version":3,"sources":["../../../src/template/internals/mergeUsingTemplateRender.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 {merge} from './merge.js';\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {CarsonTemplateError} from '../CarsonTemplateError.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport async function mergeUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n  let extension = path.extname(to);\n\n  switch (extension) {\n    case '.json': {\n      if (await fs.pathExists(to)) {\n        let targetFile = (await fs.readJson(to)) as Json;\n        let fileToMerge = json.parse<Json>(templateRender.content);\n        let newFile = JSON.stringify(merge(targetFile, fileToMerge), null, 2);\n\n        await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n      } else {\n        await fs.writeFile(to, await prettify(templateRender.content, to), {encoding: 'utf8'});\n      }\n\n      break;\n    }\n\n    case '.yaml': {\n      if (await fs.pathExists(to)) {\n        let targetFile = yaml.parse(await fs.readFile(to, {encoding: 'utf8'})) as unknown;\n        let fileToMerge = yaml.parse(templateRender.content) as unknown;\n        let newFile = yaml.stringify(merge(targetFile, fileToMerge));\n\n        await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n      } else {\n        await fs.writeFile(to, await prettify(templateRender.content, to), {encoding: 'utf8'});\n      }\n\n      break;\n    }\n\n    default: {\n      throw new CarsonTemplateError('STRATEGY_UNSUPPORTED_EXTENSION', {\n        messageParameters: [\n          templateRender.attributes.strategy,\n          templateRender.template.path,\n          extension,\n        ],\n        data: {\n          path: templateRender.template.path,\n        },\n      });\n    }\n  }\n}\n"],"names":["fs","json","path","yaml","merge","prettify","CarsonTemplateError","mergeUsingTemplateRender","templateRender","basePath","to","join","attributes","extension","extname","pathExists","targetFile","readJson","fileToMerge","parse","content","newFile","JSON","stringify","writeFile","encoding","readFile","messageParameters","strategy","template","data"],"mappings":"AACA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,QAAQ;AACzB,OAAOC,UAAU,YAAY;AAC7B,OAAOC,UAAU,OAAO;AAExB,SAAQC,KAAK,QAAO,aAAa;AACjC,SAAQC,QAAQ,QAAO,gBAAgB;AAEvC,SAAQC,mBAAmB,QAAO,4BAA4B;AAG9D,OAAO,eAAeC,yBACpBC,cAAuD,EACvDC,QAAgB;IAEhB,IAAIC,KAAKR,KAAKS,IAAI,CAACF,UAAUD,eAAeI,UAAU,CAACF,EAAE;IACzD,IAAIG,YAAYX,KAAKY,OAAO,CAACJ;IAE7B,OAAQG;QACN,KAAK;YAAS;gBACZ,IAAI,MAAMb,GAAGe,UAAU,CAACL,KAAK;oBAC3B,IAAIM,aAAc,MAAMhB,GAAGiB,QAAQ,CAACP;oBACpC,IAAIQ,cAAcjB,KAAKkB,KAAK,CAAOX,eAAeY,OAAO;oBACzD,IAAIC,UAAUC,KAAKC,SAAS,CAACnB,MAAMY,YAAYE,cAAc,MAAM;oBAEnE,MAAMlB,GAAGwB,SAAS,CAACd,IAAI,MAAML,SAASgB,SAASX,KAAK;wBAACe,UAAU;oBAAM;gBACvE,OAAO;oBACL,MAAMzB,GAAGwB,SAAS,CAACd,IAAI,MAAML,SAASG,eAAeY,OAAO,EAAEV,KAAK;wBAACe,UAAU;oBAAM;gBACtF;gBAEA;YACF;QAEA,KAAK;YAAS;gBACZ,IAAI,MAAMzB,GAAGe,UAAU,CAACL,KAAK;oBAC3B,IAAIM,aAAab,KAAKgB,KAAK,CAAC,MAAMnB,GAAG0B,QAAQ,CAAChB,IAAI;wBAACe,UAAU;oBAAM;oBACnE,IAAIP,cAAcf,KAAKgB,KAAK,CAACX,eAAeY,OAAO;oBACnD,IAAIC,UAAUlB,KAAKoB,SAAS,CAACnB,MAAMY,YAAYE;oBAE/C,MAAMlB,GAAGwB,SAAS,CAACd,IAAI,MAAML,SAASgB,SAASX,KAAK;wBAACe,UAAU;oBAAM;gBACvE,OAAO;oBACL,MAAMzB,GAAGwB,SAAS,CAACd,IAAI,MAAML,SAASG,eAAeY,OAAO,EAAEV,KAAK;wBAACe,UAAU;oBAAM;gBACtF;gBAEA;YACF;QAEA;YAAS;gBACP,MAAM,IAAInB,oBAAoB,kCAAkC;oBAC9DqB,mBAAmB;wBACjBnB,eAAeI,UAAU,CAACgB,QAAQ;wBAClCpB,eAAeqB,QAAQ,CAAC3B,IAAI;wBAC5BW;qBACD;oBACDiB,MAAM;wBACJ5B,MAAMM,eAAeqB,QAAQ,CAAC3B,IAAI;oBACpC;gBACF;YACF;IACF;AACF"}

package/dist/workspace/Project.js

@@ -7,7 +7,7 @@ import { z } from 'zod';
 import { projectConfigSchema } from './ProjectConfig.js';
 import { ProjectError } from './ProjectError.js';
 import { saveProjectConfig } from './saveProjectConfig.js';
-import { CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME } from '../constants.js';
+import { CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME, PROJECT_SNAPSHOT_FILENAME } from '../constants.js';
 import { applyTemplateRenders } from '../template/applyTemplateRenders.js';
 import { renderCarsonTemplate } from '../template/renderCarsonTemplate.js';
 /**
@@ -56,17 +56,20 @@ import { renderCarsonTemplate } from '../template/renderCarsonTemplate.js';
             },
             workspace
         });
-        try {
-            await ensureEmptyDirectory(project.path);
-        } catch  {
-            throw new ProjectError('PROJECT_PATH_NOT_EMPTY', {
-                messageParameters: [
-                    project.path
-                ],
-                data: {
-                    path: project.path
-                }
-            });
+        // if the workspace is single-project, it shares a directory with the project, so we can't insist on it being an empty directory
+        if (workspace.isMultiProject) {
+            try {
+                await ensureEmptyDirectory(project.path);
+            } catch  {
+                throw new ProjectError('PROJECT_PATH_NOT_EMPTY', {
+                    messageParameters: [
+                        project.path
+                    ],
+                    data: {
+                        path: project.path
+                    }
+                });
+            }
         }
         let templateRenders = await renderCarsonTemplate({
             templateId,
@@ -78,7 +81,8 @@ import { renderCarsonTemplate } from '../template/renderCarsonTemplate.js';
         });
         await applyTemplateRenders({
             templateRenders,
-            path: project.path,
+            targetPath: project.path,
+            snapshotPath: path.join(project.path, CARSON_CONFIG_DIRECTORY, PROJECT_SNAPSHOT_FILENAME),
             ignoreStrategies: [
                 'check'
             ]
@@ -186,7 +190,8 @@ import { renderCarsonTemplate } from '../template/renderCarsonTemplate.js';
         });
         await applyTemplateRenders({
             templateRenders,
-            path: this.path,
+            targetPath: this.path,
+            snapshotPath: path.join(this.path, CARSON_CONFIG_DIRECTORY, PROJECT_SNAPSHOT_FILENAME),
             ignoreStrategies: [
                 'create'
             ]

package/dist/workspace/Project.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/workspace/Project.ts"],"sourcesContent":["import {ensureEmptyDirectory, pathToPosixPath} from '@jakubmazanec/fs-utils';\nimport {readFile, packageJsonSchema, type PackageJson} from '@jakubmazanec/zod-utils';\nimport fs from 'fs-extra';\nimport json5 from 'json5';\nimport path from 'node:path';\nimport {z} from 'zod';\n\nimport {type ProjectConfig, projectConfigSchema} from './ProjectConfig.js';\nimport {type ProjectCreateOptions} from './ProjectCreateOptions.js';\nimport {ProjectError} from './ProjectError.js';\nimport {type ProjectOptions} from './ProjectOptions.js';\nimport {type ProjectUpdateOptions} from './ProjectUpdateOptions.js';\nimport {saveProjectConfig} from './saveProjectConfig.js';\nimport {type Workspace} from './Workspace.js';\nimport {CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME} from '../constants.js';\nimport {applyTemplateRenders} from '../template/applyTemplateRenders.js';\nimport {renderCarsonTemplate} from '../template/renderCarsonTemplate.js';\n\n/**\n * Project represent a self-contained piece of software (e.g. a package, or an app) that is part of a {@link Workspace}. Currently only Node.js projects are supported.\n *\n * @typeParam M If true, the project belongs to a multi-project workspace.\n */\nexport class Project<M extends boolean = true> {\n  /** Project name. */\n  name?: string;\n\n  /** Project path. */\n  path: string;\n\n  /** Project path relative to workspace path. */\n  relativePath: string;\n\n  /** Project configuration; if it's not found, the default is an empty object. */\n  config: ProjectConfig;\n\n  /** Parsed project `package.json` file; if it's not found, the default is an empty object. */\n  packageJson: PackageJson;\n\n  /** Parent {@link Workspace} instance. */\n  workspace: Workspace<M>;\n\n  /** Errors found during reading from the file system. */\n  errors: Array<InstanceType<typeof ProjectError>> = [];\n\n  constructor({\n    path: projectPath,\n    name,\n    config,\n    packageJson,\n    workspace,\n    errors,\n  }: ProjectOptions<M>) {\n    // TODO: check that this path and workspace path are correct, i.e. project path must always be inside of workspace path\n    this.path = projectPath;\n\n    if (name) {\n      this.name = name;\n    }\n\n    if (config) {\n      this.config = config;\n    } else {\n      this.config = {};\n    }\n\n    if (packageJson) {\n      this.packageJson = packageJson;\n    } else {\n      this.packageJson = {};\n    }\n\n    this.workspace = workspace;\n\n    if (errors) {\n      this.errors = errors;\n    }\n\n    if (this.packageJson.name?.length) {\n      this.name = this.packageJson.name;\n    }\n\n    this.relativePath = pathToPosixPath(path.relative(this.workspace.path, this.path));\n  }\n\n  static async create<M extends boolean>({\n    templateId,\n    workspace,\n    projectPath,\n    projectName,\n    args,\n  }: ProjectCreateOptions<M>): Promise<Project<M>> {\n    let project = new this({\n      path: projectPath,\n      name: projectName,\n      config: {\n        template: templateId,\n      },\n      workspace,\n    });\n\n    try {\n      await ensureEmptyDirectory(project.path);\n    } catch {\n      throw new ProjectError('PROJECT_PATH_NOT_EMPTY', {\n        messageParameters: [project.path],\n        data: {\n          path: project.path,\n        },\n      });\n    }\n\n    let templateRenders = await renderCarsonTemplate({\n      templateId,\n      templateData: {\n        workspace,\n        project,\n        args,\n      },\n    });\n\n    await applyTemplateRenders({\n      templateRenders,\n      path: project.path,\n      ignoreStrategies: ['check'],\n    });\n\n    await saveProjectConfig({projectPath: project.path, projectConfig: {template: templateId}});\n\n    await project.read();\n\n    return project;\n  }\n\n  static async read<M extends boolean>(\n    projectPath: string,\n    workspace: Workspace<M>,\n  ): Promise<Project<M>> {\n    let project = new this({\n      path: projectPath,\n      workspace,\n    });\n\n    await project.read();\n\n    return project;\n  }\n\n  async read() {\n    if (!(await fs.pathExists(this.path))) {\n      throw new ProjectError('NO_SUCH_PROJECT_PATH', {\n        messageParameters: [this.path],\n        data: {\n          path: this.path,\n        },\n      });\n    }\n\n    let errors: Array<InstanceType<typeof ProjectError>> = [];\n\n    // load project config\n    let projectConfigPath = path.join(this.path, CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME);\n    let doesProjectConfigExist = await fs.pathExists(projectConfigPath);\n    let projectConfig: ProjectConfig | z.ZodError;\n\n    if (doesProjectConfigExist) {\n      projectConfig = await readFile(projectConfigPath, projectConfigSchema, {\n        parser: (rawString: string) => json5.parse<unknown>(rawString),\n      });\n    } else {\n      projectConfig = {};\n    }\n\n    if (projectConfig instanceof z.ZodError) {\n      let zodError = projectConfig;\n\n      errors.push(\n        new ProjectError('INVALID_PROJECT_CONFIG', {\n          messageParameters: [projectConfigPath],\n          data: {\n            path: projectConfigPath,\n            zodIssues: zodError.issues,\n          },\n        }),\n      );\n\n      projectConfig = {};\n    }\n\n    // load package.json\n    let packageJsonPath = path.join(this.path, 'package.json');\n    let doesPackageJsonExist = await fs.pathExists(packageJsonPath);\n    let packageJson: PackageJson | z.ZodError;\n\n    if (doesPackageJsonExist) {\n      packageJson = await readFile(packageJsonPath, packageJsonSchema, {\n        parser: (rawString: string) => json5.parse<unknown>(rawString),\n      });\n    } else {\n      packageJson = {};\n    }\n\n    if (packageJson instanceof z.ZodError) {\n      let zodError = packageJson;\n\n      errors.push(\n        new ProjectError('INVALID_PACKAGE_JSON', {\n          messageParameters: [packageJsonPath],\n          data: {\n            path: packageJsonPath,\n            zodIssues: zodError.issues,\n          },\n        }),\n      );\n\n      packageJson = {};\n    }\n\n    if (packageJson.name?.length) {\n      this.name = packageJson.name;\n    }\n\n    this.config = projectConfig;\n    this.packageJson = packageJson;\n    this.errors = errors;\n\n    return this;\n  }\n\n  async update({args}: ProjectUpdateOptions): Promise<this> {\n    if (!this.config.template) {\n      throw new ProjectError('MISSING_CARSON_TEMPLATE_ID', {\n        messageParameters: [path.join(this.path, CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME)],\n      });\n    }\n\n    let templateRenders = await renderCarsonTemplate({\n      templateId: this.config.template,\n      templateData: {\n        workspace: this.workspace,\n        project: this,\n        args,\n      },\n    });\n\n    await applyTemplateRenders({\n      templateRenders,\n      path: this.path,\n      ignoreStrategies: ['create'],\n    });\n\n    await this.read();\n\n    return this;\n  }\n}\n"],"names":["ensureEmptyDirectory","pathToPosixPath","readFile","packageJsonSchema","fs","json5","path","z","projectConfigSchema","ProjectError","saveProjectConfig","CARSON_CONFIG_DIRECTORY","PROJECT_CONFIG_FILENAME","applyTemplateRenders","renderCarsonTemplate","Project","name","relativePath","config","packageJson","workspace","errors","constructor","projectPath","length","relative","create","templateId","projectName","args","project","template","messageParameters","data","templateRenders","templateData","ignoreStrategies","projectConfig","read","pathExists","projectConfigPath","join","doesProjectConfigExist","parser","rawString","parse","ZodError","zodError","push","zodIssues","issues","packageJsonPath","doesPackageJsonExist","update"],"mappings":"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"}
+{"version":3,"sources":["../../src/workspace/Project.ts"],"sourcesContent":["import {ensureEmptyDirectory, pathToPosixPath} from '@jakubmazanec/fs-utils';\nimport {readFile, packageJsonSchema, type PackageJson} from '@jakubmazanec/zod-utils';\nimport fs from 'fs-extra';\nimport json5 from 'json5';\nimport path from 'node:path';\nimport {z} from 'zod';\n\nimport {type ProjectConfig, projectConfigSchema} from './ProjectConfig.js';\nimport {type ProjectCreateOptions} from './ProjectCreateOptions.js';\nimport {ProjectError} from './ProjectError.js';\nimport {type ProjectOptions} from './ProjectOptions.js';\nimport {type ProjectUpdateOptions} from './ProjectUpdateOptions.js';\nimport {saveProjectConfig} from './saveProjectConfig.js';\nimport {type Workspace} from './Workspace.js';\nimport {\n  CARSON_CONFIG_DIRECTORY,\n  PROJECT_CONFIG_FILENAME,\n  PROJECT_SNAPSHOT_FILENAME,\n} from '../constants.js';\nimport {applyTemplateRenders} from '../template/applyTemplateRenders.js';\nimport {renderCarsonTemplate} from '../template/renderCarsonTemplate.js';\n\n/**\n * Project represent a self-contained piece of software (e.g. a package, or an app) that is part of a {@link Workspace}. Currently only Node.js projects are supported.\n *\n * @typeParam M If true, the project belongs to a multi-project workspace.\n */\nexport class Project<M extends boolean = true> {\n  /** Project name. */\n  name?: string;\n\n  /** Project path. */\n  path: string;\n\n  /** Project path relative to workspace path. */\n  relativePath: string;\n\n  /** Project configuration; if it's not found, the default is an empty object. */\n  config: ProjectConfig;\n\n  /** Parsed project `package.json` file; if it's not found, the default is an empty object. */\n  packageJson: PackageJson;\n\n  /** Parent {@link Workspace} instance. */\n  workspace: Workspace<M>;\n\n  /** Errors found during reading from the file system. */\n  errors: Array<InstanceType<typeof ProjectError>> = [];\n\n  constructor({\n    path: projectPath,\n    name,\n    config,\n    packageJson,\n    workspace,\n    errors,\n  }: ProjectOptions<M>) {\n    // TODO: check that this path and workspace path are correct, i.e. project path must always be inside of workspace path\n    this.path = projectPath;\n\n    if (name) {\n      this.name = name;\n    }\n\n    if (config) {\n      this.config = config;\n    } else {\n      this.config = {};\n    }\n\n    if (packageJson) {\n      this.packageJson = packageJson;\n    } else {\n      this.packageJson = {};\n    }\n\n    this.workspace = workspace;\n\n    if (errors) {\n      this.errors = errors;\n    }\n\n    if (this.packageJson.name?.length) {\n      this.name = this.packageJson.name;\n    }\n\n    this.relativePath = pathToPosixPath(path.relative(this.workspace.path, this.path));\n  }\n\n  static async create<M extends boolean>({\n    templateId,\n    workspace,\n    projectPath,\n    projectName,\n    args,\n  }: ProjectCreateOptions<M>): Promise<Project<M>> {\n    let project = new this({\n      path: projectPath,\n      name: projectName,\n      config: {\n        template: templateId,\n      },\n      workspace,\n    });\n\n    // if the workspace is single-project, it shares a directory with the project, so we can't insist on it being an empty directory\n    if (workspace.isMultiProject) {\n      try {\n        await ensureEmptyDirectory(project.path);\n      } catch {\n        throw new ProjectError('PROJECT_PATH_NOT_EMPTY', {\n          messageParameters: [project.path],\n          data: {\n            path: project.path,\n          },\n        });\n      }\n    }\n\n    let templateRenders = await renderCarsonTemplate({\n      templateId,\n      templateData: {\n        workspace,\n        project,\n        args,\n      },\n    });\n\n    await applyTemplateRenders({\n      templateRenders,\n      targetPath: project.path,\n      snapshotPath: path.join(project.path, CARSON_CONFIG_DIRECTORY, PROJECT_SNAPSHOT_FILENAME),\n      ignoreStrategies: ['check'],\n    });\n\n    await saveProjectConfig({projectPath: project.path, projectConfig: {template: templateId}});\n\n    await project.read();\n\n    return project;\n  }\n\n  static async read<M extends boolean>(\n    projectPath: string,\n    workspace: Workspace<M>,\n  ): Promise<Project<M>> {\n    let project = new this({\n      path: projectPath,\n      workspace,\n    });\n\n    await project.read();\n\n    return project;\n  }\n\n  async read() {\n    if (!(await fs.pathExists(this.path))) {\n      throw new ProjectError('NO_SUCH_PROJECT_PATH', {\n        messageParameters: [this.path],\n        data: {\n          path: this.path,\n        },\n      });\n    }\n\n    let errors: Array<InstanceType<typeof ProjectError>> = [];\n\n    // load project config\n    let projectConfigPath = path.join(this.path, CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME);\n    let doesProjectConfigExist = await fs.pathExists(projectConfigPath);\n    let projectConfig: ProjectConfig | z.ZodError;\n\n    if (doesProjectConfigExist) {\n      projectConfig = await readFile(projectConfigPath, projectConfigSchema, {\n        parser: (rawString: string) => json5.parse<unknown>(rawString),\n      });\n    } else {\n      projectConfig = {};\n    }\n\n    if (projectConfig instanceof z.ZodError) {\n      let zodError = projectConfig;\n\n      errors.push(\n        new ProjectError('INVALID_PROJECT_CONFIG', {\n          messageParameters: [projectConfigPath],\n          data: {\n            path: projectConfigPath,\n            zodIssues: zodError.issues,\n          },\n        }),\n      );\n\n      projectConfig = {};\n    }\n\n    // load package.json\n    let packageJsonPath = path.join(this.path, 'package.json');\n    let doesPackageJsonExist = await fs.pathExists(packageJsonPath);\n    let packageJson: PackageJson | z.ZodError;\n\n    if (doesPackageJsonExist) {\n      packageJson = await readFile(packageJsonPath, packageJsonSchema, {\n        parser: (rawString: string) => json5.parse<unknown>(rawString),\n      });\n    } else {\n      packageJson = {};\n    }\n\n    if (packageJson instanceof z.ZodError) {\n      let zodError = packageJson;\n\n      errors.push(\n        new ProjectError('INVALID_PACKAGE_JSON', {\n          messageParameters: [packageJsonPath],\n          data: {\n            path: packageJsonPath,\n            zodIssues: zodError.issues,\n          },\n        }),\n      );\n\n      packageJson = {};\n    }\n\n    if (packageJson.name?.length) {\n      this.name = packageJson.name;\n    }\n\n    this.config = projectConfig;\n    this.packageJson = packageJson;\n    this.errors = errors;\n\n    return this;\n  }\n\n  async update({args}: ProjectUpdateOptions): Promise<this> {\n    if (!this.config.template) {\n      throw new ProjectError('MISSING_CARSON_TEMPLATE_ID', {\n        messageParameters: [path.join(this.path, CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME)],\n      });\n    }\n\n    let templateRenders = await renderCarsonTemplate({\n      templateId: this.config.template,\n      templateData: {\n        workspace: this.workspace,\n        project: this,\n        args,\n      },\n    });\n\n    await applyTemplateRenders({\n      templateRenders,\n      targetPath: this.path,\n      snapshotPath: path.join(this.path, CARSON_CONFIG_DIRECTORY, PROJECT_SNAPSHOT_FILENAME),\n      ignoreStrategies: ['create'],\n    });\n\n    await this.read();\n\n    return this;\n  }\n}\n"],"names":["ensureEmptyDirectory","pathToPosixPath","readFile","packageJsonSchema","fs","json5","path","z","projectConfigSchema","ProjectError","saveProjectConfig","CARSON_CONFIG_DIRECTORY","PROJECT_CONFIG_FILENAME","PROJECT_SNAPSHOT_FILENAME","applyTemplateRenders","renderCarsonTemplate","Project","name","relativePath","config","packageJson","workspace","errors","constructor","projectPath","length","relative","create","templateId","projectName","args","project","template","isMultiProject","messageParameters","data","templateRenders","templateData","targetPath","snapshotPath","join","ignoreStrategies","projectConfig","read","pathExists","projectConfigPath","doesProjectConfigExist","parser","rawString","parse","ZodError","zodError","push","zodIssues","issues","packageJsonPath","doesPackageJsonExist","update"],"mappings":"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"}

package/dist/workspace/Workspace.d.ts

@@ -52,6 +52,9 @@ export declare class Workspace<M extends boolean = true> {
     static read(workspacePath: string): Promise<Workspace | Workspace<false>>;
     /**
      * Traverses file system up from the search path and tries to find a directory that is a root of a workspace.
+     *
+     * @param searchPath Search path.
+     * @returns Workspace path, if found.
      */
     static find(searchPath: string): Promise<string | undefined>;
     /**

package/dist/workspace/Workspace.js

@@ -5,13 +5,13 @@ import fs from 'fs-extra';
 import json5 from 'json5';
 import path from 'node:path';
 import { z } from 'zod';
-import { compareProjectPath, containsProject, getPackageJsonWorkspaces, getRepositoryBranches, getRepositoryUrl } from './internals.js';
+import { compareProjectPath, containsProject, containsWorkspace, getPackageJsonWorkspaces, getRepositoryBranches, getRepositoryUrl } from './internals.js';
 import { Project } from './Project.js';
 import { saveWorkspaceConfig } from './saveWorkspaceConfig.js';
 import { workspaceConfigSchema } from './WorkspaceConfig.js';
 import { WorkspaceDependencies } from './WorkspaceDependencies.js';
 import { WorkspaceError } from './WorkspaceError.js';
-import { CARSON_CONFIG_DIRECTORY, WORKSPACE_CONFIG_FILENAME } from '../constants.js';
+import { CARSON_CONFIG_DIRECTORY, WORKSPACE_CONFIG_FILENAME, PACKAGE_JSON_FILENAME, WORKSPACE_SNAPSHOT_FILENAME } from '../constants.js';
 import { applyTemplateRenders } from '../template/applyTemplateRenders.js';
 import { renderCarsonTemplate } from '../template/renderCarsonTemplate.js';
 /**
@@ -130,7 +130,8 @@ import { renderCarsonTemplate } from '../template/renderCarsonTemplate.js';
         });
         await applyTemplateRenders({
             templateRenders,
-            path: workspace.path,
+            targetPath: workspace.path,
+            snapshotPath: path.join(workspace.path, CARSON_CONFIG_DIRECTORY, WORKSPACE_SNAPSHOT_FILENAME),
             ignoreStrategies: [
                 'check'
             ]
@@ -208,25 +209,31 @@ import { renderCarsonTemplate } from '../template/renderCarsonTemplate.js';
     }
     /**
    * Traverses file system up from the search path and tries to find a directory that is a root of a workspace.
+   *
+   * @param searchPath Search path.
+   * @returns Workspace path, if found.
    */ static async find(searchPath) {
         let startingPath = await findExistingDirectory(path.resolve(searchPath));
         let currentPath = startingPath;
         let singlePackageWorkspacePath;
         let multiPackageWorkspacePath;
         while(!(isRootPath(currentPath) || singlePackageWorkspacePath && multiPackageWorkspacePath)){
-            let packageJsonPath = path.join(currentPath, 'package.json');
-            let doesPackageJsonExist = await fs.pathExists(packageJsonPath);
-            if (doesPackageJsonExist) {
-                let packageJson = await readFile(packageJsonPath, jsonSchema, {
-                    parser: (rawString)=>json5.parse(rawString)
-                });
-                if (!(packageJson instanceof Error)) {
-                    let projectGlobs = getPackageJsonWorkspaces(packageJson);
-                    if (projectGlobs?.length) {
-                        multiPackageWorkspacePath ??= currentPath;
-                    } else {
-                        singlePackageWorkspacePath ??= currentPath;
+            if (await containsWorkspace(currentPath)) {
+                const packageJsonPath = path.join(currentPath, PACKAGE_JSON_FILENAME);
+                if (await fs.pathExists(packageJsonPath)) {
+                    const packageJson = await readFile(packageJsonPath, jsonSchema, {
+                        parser: (rawString)=>json5.parse(rawString)
+                    });
+                    if (!(packageJson instanceof Error)) {
+                        const projectGlobs = getPackageJsonWorkspaces(packageJson);
+                        if (projectGlobs?.length) {
+                            multiPackageWorkspacePath ??= currentPath;
+                        } else {
+                            singlePackageWorkspacePath ??= currentPath;
+                        }
                     }
+                } else {
+                    singlePackageWorkspacePath ??= currentPath;
                 }
             }
             currentPath = path.dirname(currentPath);
@@ -372,7 +379,8 @@ import { renderCarsonTemplate } from '../template/renderCarsonTemplate.js';
         });
         await applyTemplateRenders({
             templateRenders,
-            path: this.path,
+            targetPath: this.path,
+            snapshotPath: path.join(this.path, CARSON_CONFIG_DIRECTORY, WORKSPACE_SNAPSHOT_FILENAME),
             ignoreStrategies: [
                 'create'
             ]
@@ -489,13 +497,15 @@ import { renderCarsonTemplate } from '../template/renderCarsonTemplate.js';
                 }
             }
             this.projects = projects;
-        } else {
+            this.sortProjects();
+            this.updateDependencies();
+        } else if (await containsProject(this.path)) {
             this.projects = [
                 await Project.read(this.path, this)
             ];
+            this.sortProjects();
+            this.updateDependencies();
         }
-        this.sortProjects();
-        this.updateDependencies();
         return this.projects;
     }
     sortProjects() {