@uniformdev/cli 19.41.0 → 19.42.0

package/dist/index.mjs

@@ -2,11 +2,11 @@
 
 // src/index.ts
 import * as dotenv from "dotenv";
-import yargs20 from "yargs";
+import yargs22 from "yargs";
 import { hideBin } from "yargs/helpers";
 
 // src/commands/canvas/index.ts
-import yargs5 from "yargs";
+import yargs6 from "yargs";
 
 // src/commands/canvas/commands/category.ts
 import yargs from "yargs";
@@ -75,6 +75,9 @@ import { readdir, unlink } from "fs/promises";
 import { extname as extname2, join } from "path";
 
 // src/util.ts
+import { cosmiconfigSync } from "cosmiconfig";
+import { TypeScriptLoader } from "cosmiconfig-typescript-loader";
+import fs from "fs";
 var omit = (object, keys) => {
   const result = keys.reduce((current, key) => {
     const { [key]: _, ...rest } = current;
@@ -85,6 +88,30 @@ var omit = (object, keys) => {
 var cleanFileName = (proposedFileName) => {
   return proposedFileName.replace(/[/<>$+%>!`&*'|{}?"=:\\@]/g, "-");
 };
+var loadConfig = (configPath) => {
+  const moduleName = "uniform";
+  const syncCosmicExplorer = cosmiconfigSync("uniform", {
+    searchPlaces: [`${moduleName}.config.js`, `${moduleName}.config.ts`, `${moduleName}.config.json`],
+    loaders: {
+      ".ts": TypeScriptLoader()
+    }
+  });
+  if (configPath) {
+    if (!fs.existsSync(configPath)) {
+      throw new Error(`Invalid configuration file path: ${configPath}. File does not exist.`);
+    }
+    const configFile = syncCosmicExplorer.load(configPath);
+    if (!(configFile == null ? void 0 : configFile.config.serialization)) {
+      throw new Error(
+        `Invalid configuration file: ${configPath}. Missing config.serialization configuration.`
+      );
+    }
+    return applyDefaultSyncConfiguration((configFile == null ? void 0 : configFile.config) ?? {});
+  } else {
+    const searchedForm = syncCosmicExplorer.search();
+    return applyDefaultSyncConfiguration((searchedForm == null ? void 0 : searchedForm.config) ?? {});
+  }
+};
 
 // src/sync/util.ts
 import { readFileSync, writeFileSync } from "fs";
@@ -92,8 +119,14 @@ import httpsProxyAgent from "https-proxy-agent";
 import unfetch from "isomorphic-unfetch";
 import { dump, load } from "js-yaml";
 import { extname } from "path";
-function withApiOptions(yargs21) {
-  return yargs21.option("apiKey", {
+function withConfiguration(yargs23) {
+  return yargs23.option("serialization", {
+    skipValidation: true,
+    hidden: true
+  });
+}
+function withApiOptions(yargs23) {
+  return yargs23.option("apiKey", {
     describe: "Uniform API key. Defaults to UNIFORM_CLI_API_KEY or UNIFORM_API_KEY env. Supports dotenv.",
     default: process.env.UNIFORM_CLI_API_KEY ?? // deprecated
     process.env.CANVAS_CLI_API_KEY ?? // deprecated
@@ -132,8 +165,8 @@ function nodeFetchProxy(proxy) {
   };
   return wrappedFetch;
 }
-function withProjectOptions(yargs21) {
-  return yargs21.option("project", {
+function withProjectOptions(yargs23) {
+  return yargs23.option("project", {
     describe: "Uniform project ID. Defaults to UNIFORM_CLI_PROJECT_ID or UNIFORM_PROJECT_ID env. Supports dotenv.",
     default: process.env.UNIFORM_CLI_PROJECT_ID ?? // deprecated
     process.env.CANVAS_CLI_PROJECT_ID ?? // deprecated
@@ -143,8 +176,8 @@ function withProjectOptions(yargs21) {
     alias: ["p"]
   });
 }
-function withFormatOptions(yargs21) {
-  return yargs21.option("format", {
+function withFormatOptions(yargs23) {
+  return yargs23.option("format", {
     alias: ["f"],
     describe: "Output format",
     default: "yaml",
@@ -156,8 +189,8 @@ function withFormatOptions(yargs21) {
     type: "string"
   });
 }
-function withDiffOptions(yargs21) {
-  return yargs21.option("diff", {
+function withDiffOptions(yargs23) {
+  return yargs23.option("diff", {
     describe: "Whether to show diffs in stdout. off = no diffs; update = on for updates; on = updates, creates, deletes. Can be set by UNIFORM_CLI_DIFF_MODE environment variable.",
     default: process.env.UNIFORM_CLI_DIFF_MODE ?? "off",
     type: "string",
@@ -217,6 +250,72 @@ async function* paginateAsync(fetchPage, options) {
     offset += perPage;
   } while (pageData.length === perPage);
 }
+var defaultSyncConfiguration = {
+  entitiesConfig: {},
+  directory: "uniform-data",
+  format: "yaml",
+  mode: "mirror"
+};
+var applyDefaultSyncConfiguration = (config2) => {
+  var _a;
+  const mergedConfig = {
+    serialization: {
+      ...defaultSyncConfiguration,
+      ...(config2 == null ? void 0 : config2.serialization) ?? {},
+      entitiesConfig: {
+        ...defaultSyncConfiguration.entitiesConfig,
+        ...((_a = config2 == null ? void 0 : config2.serialization) == null ? void 0 : _a.entitiesConfig) ?? {}
+      }
+    }
+  };
+  for (const entityType in mergedConfig.serialization.entitiesConfig) {
+    const entityTypeCasted = entityType;
+    const entityConfig = mergedConfig.serialization.entitiesConfig[entityTypeCasted];
+    if (Object.keys(entityConfig).length === 0) {
+      const separator = mergedConfig.serialization.directory[mergedConfig.serialization.directory.length - 1] === "/" ? "" : "/";
+      mergedConfig.serialization.entitiesConfig[entityTypeCasted].directory = isPathAPackageFile(
+        mergedConfig.serialization.directory
+      ) ? mergedConfig.serialization.directory : `${mergedConfig.serialization.directory}${separator}${entityTypeCasted}`;
+    }
+  }
+  return mergedConfig;
+};
+var getEntityOption = ({
+  optionName,
+  config: config2,
+  entityType,
+  operation
+}) => {
+  var _a, _b, _c, _d, _e, _f;
+  if ((_b = (_a = config2.entitiesConfig[entityType]) == null ? void 0 : _a[operation]) == null ? void 0 : _b[optionName]) {
+    return (_d = (_c = config2.entitiesConfig[entityType]) == null ? void 0 : _c[operation]) == null ? void 0 : _d[optionName];
+  }
+  if ((_e = config2.entitiesConfig[entityType]) == null ? void 0 : _e[optionName]) {
+    return (_f = config2.entitiesConfig[entityType]) == null ? void 0 : _f[optionName];
+  }
+  if (config2[optionName]) {
+    return config2[optionName];
+  }
+  throw `No ${optionName} option specified for ${entityType} ${operation}`;
+};
+var getDirectoryOrFilename = ({
+  config: config2,
+  entityType,
+  operation
+}) => {
+  var _a, _b, _c, _d, _e, _f;
+  if ((_b = (_a = config2.entitiesConfig[entityType]) == null ? void 0 : _a[operation]) == null ? void 0 : _b.directory) {
+    return (_d = (_c = config2.entitiesConfig[entityType]) == null ? void 0 : _c[operation]) == null ? void 0 : _d.directory;
+  }
+  if ((_e = config2.entitiesConfig[entityType]) == null ? void 0 : _e.directory) {
+    return (_f = config2.entitiesConfig[entityType]) == null ? void 0 : _f.directory;
+  }
+  const isPackage = isPathAPackageFile(config2.directory);
+  if (isPackage) {
+    return config2.directory;
+  }
+  return `${config2.directory}/${entityType}`;
+};
 
 // src/sync/fileSyncEngineDataSource.ts
 async function createFileSyncEngineDataSource({
@@ -279,9 +378,9 @@ ${e == null ? void 0 : e.message}`));
 }
 
 // src/sync/package.ts
-import fs from "fs";
+import fs2 from "fs";
 function readUniformPackage(filename, assertExists) {
-  if (!assertExists && !fs.existsSync(filename)) {
+  if (!assertExists && !fs2.existsSync(filename)) {
     return {};
   }
   const packageContents = readFileToObject(filename);
@@ -475,9 +574,13 @@ function createSyncEngineConsoleLogger(options) {
 var CategoryGetModule = {
   command: "get <id>",
   describe: "Fetch a category",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(yargs21.positional("id", { demandOption: true, describe: "Category UUID to fetch" }))
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", { demandOption: true, describe: "Category UUID to fetch" })
+        )
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, format, project: projectId, filename }) => {
@@ -500,7 +603,7 @@ var CategoryListModule = {
   command: "list",
   describe: "List categories",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21.options({})))),
+  builder: (yargs23) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs23.options({}))))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCategoryClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -557,30 +660,32 @@ function writeCanvasPackage(filename, packageContents) {
 var CategoryPullModule = {
   command: "pull <directory>",
   describe: "Pulls all categories to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save the categories to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save the categories to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -634,24 +739,26 @@ import { UncachedCategoryClient as UncachedCategoryClient4 } from "@uniformdev/c
 var CategoryPushModule = {
   command: "push <directory>",
   describe: "Pushes all categories from files in a directory to Uniform Canvas",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read the categories from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read the categories from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -700,8 +807,12 @@ var CategoryRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a category",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(yargs21.positional("id", { demandOption: true, describe: "Category UUID to delete" }))
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "Category UUID to delete" })
+      )
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -716,9 +827,11 @@ var CategoryUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a category",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("filename", { demandOption: true, describe: "Category file to put" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("filename", { demandOption: true, describe: "Category file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -734,7 +847,7 @@ var CategoryModule = {
   command: "category <command>",
   aliases: ["cat"],
   describe: "Commands for Canvas categories",
-  builder: (yargs21) => yargs21.command(CategoryPullModule).command(CategoryPushModule).command(CategoryGetModule).command(CategoryRemoveModule).command(CategoryListModule).command(CategoryUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(CategoryPullModule).command(CategoryPushModule).command(CategoryGetModule).command(CategoryRemoveModule).command(CategoryListModule).command(CategoryUpdateModule).demandCommand(),
   handler: () => {
     yargs.help();
   }
@@ -755,10 +868,15 @@ var selectSchemaUrl = () => "/schemas/json-schema/component-definition/v1.json";
 var ComponentGetModule = {
   command: "get <id>",
   describe: "Fetch a component definition",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.positional("id", { demandOption: true, describe: "Component definition public ID to fetch" })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", {
+            demandOption: true,
+            describe: "Component definition public ID to fetch"
+          })
+        )
       )
     )
   ),
@@ -788,13 +906,15 @@ var ComponentListModule = {
   command: "list",
   describe: "List component definitions",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.options({
-          offset: { describe: "Number of rows to skip before fetching", type: "number", default: 0 },
-          limit: { describe: "Number of rows to fetch", type: "number", default: 20 }
-        })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.options({
+            offset: { describe: "Number of rows to skip before fetching", type: "number", default: 0 },
+            limit: { describe: "Number of rows to fetch", type: "number", default: 20 }
+          })
+        )
       )
     )
   ),
@@ -845,30 +965,32 @@ function createComponentDefinitionEngineDataSource({
 var ComponentPullModule = {
   command: "pull <directory>",
   describe: "Pulls all component definitions to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save the component definitions to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save the component definitions to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -923,24 +1045,26 @@ import { UncachedCanvasClient as UncachedCanvasClient4 } from "@uniformdev/canva
 var ComponentPushModule = {
   command: "push <directory>",
   describe: "Pushes all component definitions from files in a directory to Uniform Canvas",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read the component definitions from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read the component definitions from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -990,9 +1114,11 @@ var ComponentRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a component definition",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Component definition public ID to delete" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "Component definition public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -1008,9 +1134,11 @@ var ComponentUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a component definition",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("filename", { demandOption: true, describe: "Component definition file to put" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("filename", { demandOption: true, describe: "Component definition file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -1026,7 +1154,7 @@ var ComponentModule = {
   command: "component <command>",
   aliases: ["def"],
   describe: "Commands for Canvas component definitions",
-  builder: (yargs21) => yargs21.command(ComponentPullModule).command(ComponentPushModule).command(ComponentGetModule).command(ComponentRemoveModule).command(ComponentListModule).command(ComponentUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(ComponentPullModule).command(ComponentPushModule).command(ComponentGetModule).command(ComponentRemoveModule).command(ComponentListModule).command(ComponentUpdateModule).demandCommand(),
   handler: () => {
     yargs2.help();
   }
@@ -1048,8 +1176,8 @@ function prepCompositionForDisk(composition) {
   delete prepped.state;
   return prepped;
 }
-function withStateOptions(yargs21) {
-  return yargs21.option("state", {
+function withStateOptions(yargs23) {
+  return yargs23.option("state", {
     type: "string",
     describe: `Composition state to fetch.`,
     choices: ["preview", "published"],
@@ -1074,37 +1202,39 @@ function convertCompositionState(state) {
 var CompositionGetModule = {
   command: "get <id>",
   describe: "Fetch a composition",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        withStateOptions(
-          yargs21.positional("id", { demandOption: true, describe: "Composition public ID to fetch" }).option({
-            resolvePatterns: {
-              type: "boolean",
-              default: false,
-              describe: "Resolve pattern references in the composition"
-            },
-            resolveOverrides: {
-              type: "boolean",
-              default: false,
-              describe: "Resolves pattern overrides in the composition and removes override definition data"
-            },
-            componentIDs: {
-              type: "boolean",
-              default: false,
-              describe: "Include individual component UIDs"
-            },
-            resolveData: {
-              type: "boolean",
-              default: false,
-              describe: "Resolve all data resources used by the composition"
-            },
-            diagnostics: {
-              type: "boolean",
-              default: false,
-              describe: "Include diagnostics information when resolving data"
-            }
-          })
+  builder: (yargs23) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          withStateOptions(
+            yargs23.positional("id", { demandOption: true, describe: "Composition/pattern public ID to fetch" }).option({
+              resolvePatterns: {
+                type: "boolean",
+                default: false,
+                describe: "Resolve pattern references in the composition"
+              },
+              resolveOverrides: {
+                type: "boolean",
+                default: false,
+                describe: "Resolves pattern overrides in the composition and removes override definition data"
+              },
+              componentIDs: {
+                type: "boolean",
+                default: false,
+                describe: "Include individual component UIDs"
+              },
+              resolveData: {
+                type: "boolean",
+                default: false,
+                describe: "Resolve all data resources used by the composition/pattern"
+              },
+              diagnostics: {
+                type: "boolean",
+                default: false,
+                describe: "Include diagnostics information when resolving data"
+              }
+            })
+          )
         )
       )
     )
@@ -1148,29 +1278,42 @@ var CompositionListModule = {
   command: "list",
   describe: "List compositions",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        withStateOptions(
-          yargs21.options({
-            offset: { describe: "Number of rows to skip before fetching", type: "number", default: 0 },
-            limit: { describe: "Number of rows to fetch", type: "number", default: 20 },
-            resolvePatterns: {
-              type: "boolean",
-              default: false,
-              describe: "Resolve pattern references in the composition"
-            },
-            resolveOverrides: {
-              type: "boolean",
-              default: false,
-              describe: "Resolves pattern overrides in the composition and removes override definition data"
-            },
-            componentIDs: {
-              type: "boolean",
-              default: false,
-              describe: "Include individual component UIDs"
-            }
-          })
+  builder: (yargs23) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          withStateOptions(
+            yargs23.options({
+              offset: { describe: "Number of rows to skip before fetching", type: "number", default: 0 },
+              limit: { describe: "Number of rows to fetch", type: "number", default: 20 },
+              resolvePatterns: {
+                type: "boolean",
+                default: false,
+                describe: "Resolve pattern references in the composition"
+              },
+              resolveOverrides: {
+                type: "boolean",
+                default: false,
+                describe: "Resolves pattern overrides in the composition and removes override definition data"
+              },
+              onlyCompositions: {
+                describe: "Only pulling compositions and not patterns",
+                default: false,
+                type: "boolean"
+              },
+              onlyPatterns: {
+                describe: "Only pulling patterns and not compositions",
+                default: false,
+                type: "boolean",
+                hidden: true
+              },
+              componentIDs: {
+                type: "boolean",
+                default: false,
+                describe: "Include individual component UIDs"
+              }
+            })
+          )
         )
       )
     )
@@ -1183,6 +1326,8 @@ var CompositionListModule = {
     offset,
     format,
     filename,
+    onlyCompositions,
+    onlyPatterns,
     project: projectId,
     state,
     resolvePatterns,
@@ -1194,6 +1339,7 @@ var CompositionListModule = {
     const res = await client.getCompositionList({
       limit,
       offset,
+      pattern: onlyCompositions ? false : onlyPatterns ? true : void 0,
       state: convertCompositionState(state),
       skipPatternResolution: !resolvePatterns,
       withComponentIDs: componentIDs,
@@ -1214,6 +1360,8 @@ var selectDisplayName3 = (component) => `${component.composition._name ?? compon
 function createComponentInstanceEngineDataSource({
   client,
   state,
+  onlyCompositions,
+  onlyPatterns,
   ...clientOptions
 }) {
   const stateId = convertCompositionState(state);
@@ -1223,6 +1371,7 @@ function createComponentInstanceEngineDataSource({
         ...clientOptions,
         limit,
         offset,
+        pattern: onlyCompositions ? false : onlyPatterns ? true : void 0,
         state: stateId,
         skipPatternResolution: true,
         skipOverridesResolution: true,
@@ -1253,43 +1402,36 @@ function createComponentInstanceEngineDataSource({
 
 // src/commands/canvas/commands/composition/publish.ts
 var CompositionPublishModule = {
-  command: "publish [compositionIDs]",
+  command: "publish [ids]",
   describe: "Publishes compositions",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("compositionIDs", {
-          describe: "Publishes composition(s) by ID. Comma-separate multiple IDs. Use --all to publish all instead.",
-          type: "string"
-        }).option("all", {
-          alias: ["a"],
-          describe: "Publishes all compositions. Use compositionId to publish one instead.",
-          default: false,
-          type: "boolean"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but does not perform any publishing",
-          default: false,
-          type: "boolean"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("ids", {
+            describe: "Publishes composition/pattern(s) by ID. Comma-separate multiple IDs. Use --all to publish all instead.",
+            type: "string"
+          }).option("all", {
+            alias: ["a"],
+            describe: "Publishes all compositions. Use compositionId to publish one instead.",
+            default: false,
+            type: "boolean"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but does not perform any publishing",
+            default: false,
+            type: "boolean"
+          })
+        )
       )
     )
   ),
-  handler: async ({
-    apiHost,
-    apiKey,
-    proxy,
-    compositionIDs,
-    all,
-    whatIf,
-    project: projectId,
-    diff: diffMode
-  }) => {
-    if (!all && !compositionIDs || all && compositionIDs) {
+  handler: async ({ apiHost, apiKey, proxy, ids, all, whatIf, project: projectId, diff: diffMode }) => {
+    if (!all && !ids || all && ids) {
       console.error(`Specify --all or composition ID(s) to publish.`);
       process.exit(1);
     }
-    const compositionIDsArray = compositionIDs ? compositionIDs.split(",").map((id) => id.trim()) : void 0;
+    const compositionIDsArray = ids ? ids.split(",").map((id) => id.trim()) : void 0;
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCanvasClient9({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createComponentInstanceEngineDataSource({
@@ -1317,31 +1459,42 @@ import { UncachedCanvasClient as UncachedCanvasClient10 } from "@uniformdev/canv
 var CompositionPullModule = {
   command: "pull <directory>",
   describe: "Pulls all compositions to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withStateOptions(
-        withDiffOptions(
-          yargs21.positional("directory", {
-            describe: "Directory to save the component definitions to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-            type: "string"
-          }).option("format", {
-            alias: ["f"],
-            describe: "Output format",
-            default: "yaml",
-            choices: ["yaml", "json"],
-            type: "string"
-          }).option("what-if", {
-            alias: ["w"],
-            describe: "What-if mode reports what would be done but changes no files",
-            default: false,
-            type: "boolean"
-          }).option("mode", {
-            alias: ["m"],
-            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-            choices: ["create", "createOrUpdate", "mirror"],
-            default: "mirror",
-            type: "string"
-          })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          withDiffOptions(
+            yargs23.positional("directory", {
+              describe: "Directory to save the component definitions to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+              type: "string"
+            }).option("format", {
+              alias: ["f"],
+              describe: "Output format",
+              default: "yaml",
+              choices: ["yaml", "json"],
+              type: "string"
+            }).option("onlyCompositions", {
+              describe: "Only pulling compositions and not patterns",
+              default: false,
+              type: "boolean"
+            }).option("onlyPatterns", {
+              describe: "Only pulling patterns and not compositions",
+              default: false,
+              type: "boolean",
+              hidden: true
+            }).option("what-if", {
+              alias: ["w"],
+              describe: "What-if mode reports what would be done but changes no files",
+              default: false,
+              type: "boolean"
+            }).option("mode", {
+              alias: ["m"],
+              describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+              choices: ["create", "createOrUpdate", "mirror"],
+              default: "mirror",
+              type: "string"
+            })
+          )
         )
       )
     )
@@ -1352,6 +1505,8 @@ var CompositionPullModule = {
     proxy,
     directory,
     format,
+    onlyCompositions,
+    onlyPatterns,
     mode,
     whatIf,
     state,
@@ -1360,7 +1515,7 @@ var CompositionPullModule = {
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCanvasClient10({ apiKey, apiHost, fetch: fetch3, projectId });
-    const source = createComponentInstanceEngineDataSource({ client, state });
+    const source = createComponentInstanceEngineDataSource({ client, state, onlyCompositions, onlyPatterns });
     const isPackage = isPathAPackageFile(directory);
     let target;
     if (isPackage) {
@@ -1397,30 +1552,41 @@ import { UncachedCanvasClient as UncachedCanvasClient11 } from "@uniformdev/canv
 var CompositionPushModule = {
   command: "push <directory>",
   describe: "Pushes all compositions from files in a directory to Uniform Canvas",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withStateOptions(
-        withDiffOptions(
-          yargs21.positional("directory", {
-            describe: "Directory to read the component definitions from. If a filename is used, a package will be read instead.",
-            type: "string"
-          }).option("what-if", {
-            alias: ["w"],
-            describe: "What-if mode reports what would be done but changes nothing",
-            default: false,
-            type: "boolean"
-          }).option("mode", {
-            alias: ["m"],
-            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-            choices: ["create", "createOrUpdate", "mirror"],
-            default: "mirror",
-            type: "string"
-          })
-        )
-      )
-    )
-  ),
-  handler: async ({
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          withDiffOptions(
+            yargs23.positional("directory", {
+              describe: "Directory to read the compositions/patterns from. If a filename is used, a package will be read instead.",
+              type: "string"
+            }).option("what-if", {
+              alias: ["w"],
+              describe: "What-if mode reports what would be done but changes nothing",
+              default: false,
+              type: "boolean"
+            }).option("mode", {
+              alias: ["m"],
+              describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+              choices: ["create", "createOrUpdate", "mirror"],
+              default: "mirror",
+              type: "string"
+            }).option("onlyCompositions", {
+              describe: "Only pulling compositions and not patterns",
+              default: false,
+              type: "boolean"
+            }).option("onlyPatterns", {
+              describe: "Only pulling patterns and not compositions",
+              default: false,
+              type: "boolean",
+              hidden: true
+            })
+          )
+        )
+      )
+    )
+  ),
+  handler: async ({
     apiHost,
     apiKey,
     proxy,
@@ -1429,6 +1595,8 @@ var CompositionPushModule = {
     whatIf,
     state,
     project: projectId,
+    onlyCompositions,
+    onlyPatterns,
     diff: diffMode
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -1449,7 +1617,7 @@ var CompositionPushModule = {
         selectDisplayName: selectDisplayName3
       });
     }
-    const target = createComponentInstanceEngineDataSource({ client, state });
+    const target = createComponentInstanceEngineDataSource({ client, state, onlyCompositions, onlyPatterns });
     await syncEngine({
       source,
       target,
@@ -1466,9 +1634,11 @@ var CompositionRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a composition",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Composition public ID to delete" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "Composition/pattern public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -1483,9 +1653,14 @@ import { CANVAS_PUBLISHED_STATE as CANVAS_PUBLISHED_STATE2, UncachedCanvasClient
 var CompositionUnpublishModule = {
   command: "unpublish <id>",
   describe: "Unpublish a composition",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Composition public ID to unpublish" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", {
+          demandOption: true,
+          describe: "Composition/pattern public ID to unpublish"
+        })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -1501,10 +1676,12 @@ var CompositionUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a composition",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withStateOptions(
-        yargs21.positional("filename", { demandOption: true, describe: "Composition file to put" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          yargs23.positional("filename", { demandOption: true, describe: "Composition/pattern file to put" })
+        )
       )
     )
   ),
@@ -1521,7 +1698,7 @@ var CompositionModule = {
   command: "composition <command>",
   describe: "Commands for Canvas compositions",
   aliases: ["comp"],
-  builder: (yargs21) => yargs21.command(CompositionPullModule).command(CompositionPushModule).command(CompositionGetModule).command(CompositionRemoveModule).command(CompositionListModule).command(CompositionUpdateModule).command(CompositionPublishModule).command(CompositionUnpublishModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(CompositionPullModule).command(CompositionPushModule).command(CompositionGetModule).command(CompositionRemoveModule).command(CompositionListModule).command(CompositionUpdateModule).command(CompositionPublishModule).command(CompositionUnpublishModule).demandCommand(),
   handler: () => {
     yargs3.help();
   }
@@ -1536,11 +1713,13 @@ var DataTypeGetModule = {
   command: "get <id>",
   describe: "Get a data type",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        yargs21.positional("id", { demandOption: true, describe: "Data type public ID to fetch" })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          yargs23.positional("id", { demandOption: true, describe: "Data type public ID to fetch" })
+        )
       )
     )
   ),
@@ -1562,7 +1741,7 @@ var DataTypeListModule = {
   command: "list",
   describe: "List data types",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs23) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs23)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new DataTypeClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
@@ -1611,30 +1790,32 @@ function createDataTypeEngineDataSource({
 var DataTypePullModule = {
   command: "pull <directory>",
   describe: "Pulls all data types to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save the data types to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save the data types to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -1694,24 +1875,26 @@ import { DataTypeClient as DataTypeClient4 } from "@uniformdev/canvas";
 var DataTypePushModule = {
   command: "push <directory>",
   describe: "Pushes all data types from files in a directory to Uniform",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read the data types from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read the data types from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -1766,9 +1949,11 @@ var DataTypeRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a data type",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Data type public ID to delete" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "Data type public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -1784,9 +1969,11 @@ var DataTypeUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a data type",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("filename", { demandOption: true, describe: "Data type file to put" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("filename", { demandOption: true, describe: "Data type file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -1802,38 +1989,206 @@ var DataTypeModule = {
   command: "datatype <command>",
   aliases: ["dt"],
   describe: "Commands for Data Type definitions",
-  builder: (yargs21) => yargs21.command(DataTypeGetModule).command(DataTypePullModule).command(DataTypePushModule).command(DataTypeRemoveModule).command(DataTypeListModule).command(DataTypeUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(DataTypeGetModule).command(DataTypePullModule).command(DataTypePushModule).command(DataTypeRemoveModule).command(DataTypeListModule).command(DataTypeUpdateModule).demandCommand(),
   handler: () => {
     yargs4.help();
   }
 };
 
+// src/commands/canvas/commands/pattern.ts
+import yargs5 from "yargs";
+
+// src/commands/canvas/commands/pattern/get.ts
+var PatternGetModule = {
+  ...CompositionGetModule,
+  describe: "Fetch a pattern"
+};
+
+// src/commands/canvas/commands/pattern/list.ts
+var PatternListModule = {
+  ...CompositionListModule,
+  describe: "List patterns",
+  builder: (yargs23) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          withStateOptions(
+            yargs23.options({
+              offset: { describe: "Number of rows to skip before fetching", type: "number", default: 0 },
+              limit: { describe: "Number of rows to fetch", type: "number", default: 20 },
+              resolvePatterns: {
+                type: "boolean",
+                default: false,
+                describe: "Resolve pattern references in the composition"
+              },
+              resolveOverrides: {
+                type: "boolean",
+                default: false,
+                describe: "Resolves pattern overrides in the composition and removes override definition data"
+              },
+              onlyPatterns: {
+                describe: "Only pulling patterns and not compositions",
+                // This default differentiate this list command from composition list command
+                default: true,
+                type: "boolean",
+                hidden: true
+              },
+              componentIDs: {
+                alias: ["componentIDs"],
+                type: "boolean",
+                default: false,
+                describe: "Include individual component UIDs"
+              }
+            })
+          )
+        )
+      )
+    )
+  )
+};
+
+// src/commands/canvas/commands/pattern/publish.ts
+var PatternPublishModule = {
+  ...CompositionPublishModule,
+  describe: "Publishes patterns"
+};
+
+// src/commands/canvas/commands/pattern/pull.ts
+var PatternPullModule = {
+  ...CompositionPullModule,
+  describe: "Pulls all patterns to local files in a directory",
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          withDiffOptions(
+            yargs23.positional("directory", {
+              describe: "Directory to save the component definitions to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+              type: "string"
+            }).option("format", {
+              alias: ["f"],
+              describe: "Output format",
+              default: "yaml",
+              choices: ["yaml", "json"],
+              type: "string"
+            }).option("onlyPatterns", {
+              describe: "Only pulling patterns and not compositions",
+              // This default differentiate this list command from composition list command
+              default: true,
+              type: "boolean",
+              hidden: true
+            }).option("what-if", {
+              alias: ["w"],
+              describe: "What-if mode reports what would be done but changes no files",
+              default: false,
+              type: "boolean"
+            }).option("mode", {
+              alias: ["m"],
+              describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+              choices: ["create", "createOrUpdate", "mirror"],
+              default: "mirror",
+              type: "string"
+            })
+          )
+        )
+      )
+    )
+  )
+};
+
+// src/commands/canvas/commands/pattern/push.ts
+var PatternPushModule = {
+  ...CompositionPushModule,
+  describe: "Pushes all patterns from files in a directory to Uniform Canvas",
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          withDiffOptions(
+            yargs23.positional("directory", {
+              describe: "Directory to read the compositions/patterns from. If a filename is used, a package will be read instead.",
+              type: "string"
+            }).option("what-if", {
+              alias: ["w"],
+              describe: "What-if mode reports what would be done but changes nothing",
+              default: false,
+              type: "boolean"
+            }).option("mode", {
+              alias: ["m"],
+              describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+              choices: ["create", "createOrUpdate", "mirror"],
+              default: "mirror",
+              type: "string"
+            }).option("onlyPatterns", {
+              describe: "Only pulling patterns and not compositions",
+              // This default differentiate this list command from composition list command
+              default: true,
+              type: "boolean",
+              hidden: true
+            })
+          )
+        )
+      )
+    )
+  )
+};
+
+// src/commands/canvas/commands/pattern/remove.ts
+var PatternRemoveModule = {
+  ...CompositionRemoveModule,
+  describe: "Delete a pattern"
+};
+
+// src/commands/canvas/commands/pattern/unpublish.ts
+var PatternUnpublishModule = {
+  ...CompositionUnpublishModule,
+  describe: "Unpublish a pattern"
+};
+
+// src/commands/canvas/commands/pattern/update.ts
+var PatternUpdateModule = {
+  ...CompositionUpdateModule,
+  describe: "Insert or update a pattern"
+};
+
+// src/commands/canvas/commands/pattern.ts
+var PatternModule = {
+  command: "pattern <command>",
+  describe: "Commands for Canvas patterns",
+  builder: (yargs23) => yargs23.command(PatternPullModule).command(PatternPushModule).command(PatternGetModule).command(PatternRemoveModule).command(PatternListModule).command(PatternUpdateModule).command(PatternPublishModule).command(PatternUnpublishModule).demandCommand(),
+  handler: () => {
+    yargs5.help();
+  }
+};
+
 // src/commands/canvas/index.ts
 var CanvasCommand = {
   command: "canvas <command>",
   aliases: ["cv", "pm", "presentation"],
   describe: "Uniform Canvas commands",
-  builder: (yargs21) => yargs21.command(CompositionModule).command(ComponentModule).command(DataTypeModule).command(CategoryModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(CompositionModule).command(ComponentModule).command(DataTypeModule).command(CategoryModule).command(PatternModule).demandCommand(),
   handler: () => {
-    yargs5.showHelp();
+    yargs6.showHelp();
   }
 };
 
 // src/commands/context/index.ts
-import yargs12 from "yargs";
+import yargs13 from "yargs";
 
 // src/commands/context/commands/aggregate.ts
-import yargs6 from "yargs";
+import yargs7 from "yargs";
 
 // src/commands/context/commands/aggregate/get.ts
 import { UncachedAggregateClient } from "@uniformdev/context/api";
 var AggregateGetModule = {
   command: "get <id>",
   describe: "Fetch an aggregate",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.positional("id", { demandOption: true, describe: "Aggregate public ID to fetch" })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", { demandOption: true, describe: "Aggregate public ID to fetch" })
+        )
       )
     )
   ),
@@ -1856,7 +2211,7 @@ var AggregateListModule = {
   command: "list",
   describe: "List aggregates",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs23) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs23)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAggregateClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -1922,30 +2277,32 @@ function writeContextPackage(filename, packageContents) {
 var AggregatePullModule = {
   command: "pull <directory>",
   describe: "Pulls all aggregates to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save the aggregates to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save the aggregates to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -1999,24 +2356,26 @@ import { UncachedAggregateClient as UncachedAggregateClient4 } from "@uniformdev
 var AggregatePushModule = {
   command: "push <directory>",
   describe: "Pushes all aggregates from files in a directory or package to Uniform",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read the aggregates from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read the aggregates from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -2066,9 +2425,11 @@ var AggregateRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an aggregate",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Aggregate public ID to delete" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "Aggregate public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -2084,9 +2445,11 @@ var AggregateUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update an aggregate",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("filename", { demandOption: true, describe: "Aggregate file to put" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("filename", { demandOption: true, describe: "Aggregate file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -2102,24 +2465,26 @@ var AggregateModule = {
   command: "aggregate <command>",
   aliases: ["agg", "intent", "audience"],
   describe: "Commands for Context aggregates (intents, audiences)",
-  builder: (yargs21) => yargs21.command(AggregatePullModule).command(AggregatePushModule).command(AggregateGetModule).command(AggregateRemoveModule).command(AggregateListModule).command(AggregateUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(AggregatePullModule).command(AggregatePushModule).command(AggregateGetModule).command(AggregateRemoveModule).command(AggregateListModule).command(AggregateUpdateModule).demandCommand(),
   handler: () => {
-    yargs6.help();
+    yargs7.help();
   }
 };
 
 // src/commands/context/commands/enrichment.ts
-import yargs7 from "yargs";
+import yargs8 from "yargs";
 
 // src/commands/context/commands/enrichment/get.ts
 import { UncachedEnrichmentClient } from "@uniformdev/context/api";
 var EnrichmentGetModule = {
   command: "get <id>",
   describe: "Fetch an enrichment category and its values",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.positional("id", { demandOption: true, describe: "Enrichment category public ID to fetch" })
+  builder: (yargs23) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", { demandOption: true, describe: "Enrichment category public ID to fetch" })
+        )
       )
     )
   ),
@@ -2143,7 +2508,7 @@ var EnrichmentListModule = {
   command: "list",
   describe: "List enrichments",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs23) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs23)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedEnrichmentClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -2244,30 +2609,32 @@ var createEnrichmentValueEngineDataSource = ({
 var EnrichmentPullModule = {
   command: "pull <directory>",
   describe: "Pulls all enrichments to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save the enrichments to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save the enrichments to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -2321,24 +2688,26 @@ import { UncachedEnrichmentClient as UncachedEnrichmentClient4 } from "@uniformd
 var EnrichmentPushModule = {
   command: "push <directory>",
   describe: "Pushes all enrichments from files in a directory or package to Uniform",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read the enrichments from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read the enrichments from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -2387,9 +2756,11 @@ var EnrichmentRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an enrichment category and its values",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Enrichment category public ID to delete" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "Enrichment category public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -2404,14 +2775,14 @@ var EnrichmentModule = {
   command: "enrichment <command>",
   aliases: ["enr"],
   describe: "Commands for Context enrichments",
-  builder: (yargs21) => yargs21.command(EnrichmentPullModule).command(EnrichmentPushModule).command(EnrichmentGetModule).command(EnrichmentRemoveModule).command(EnrichmentListModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(EnrichmentPullModule).command(EnrichmentPushModule).command(EnrichmentGetModule).command(EnrichmentRemoveModule).command(EnrichmentListModule).demandCommand(),
   handler: () => {
-    yargs7.help();
+    yargs8.help();
   }
 };
 
 // src/commands/context/commands/manifest.ts
-import yargs8 from "yargs";
+import yargs9 from "yargs";
 
 // src/commands/context/commands/manifest/get.ts
 import { ApiClientError, UncachedManifestClient } from "@uniformdev/context/api";
@@ -2422,20 +2793,22 @@ var ManifestGetModule = {
   command: "get [output]",
   aliases: ["dl", "download"],
   describe: "Download the Uniform Context manifest for a project",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.option("preview", {
-        describe: "If set, fetches the unpublished preview manifest (The API key must have permission)",
-        default: false,
-        type: "boolean",
-        alias: ["d"]
-      }).option("output", {
-        string: true,
-        alias: "o",
-        default: process.env.UNIFORM_MANIFEST_PATH,
-        describe: "Path to write manifest to. Defaults to UNIFORM_MANIFEST_PATH env if set.",
-        demandOption: true
-      })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.option("preview", {
+          describe: "If set, fetches the unpublished preview manifest (The API key must have permission)",
+          default: false,
+          type: "boolean",
+          alias: ["d"]
+        }).option("output", {
+          string: true,
+          alias: "o",
+          default: process.env.UNIFORM_MANIFEST_PATH,
+          describe: "Path to write manifest to. Defaults to UNIFORM_MANIFEST_PATH env if set.",
+          demandOption: true
+        })
+      )
     )
   ),
   handler: async ({ apiKey, apiHost, proxy, output, project, preview }) => {
@@ -2485,7 +2858,7 @@ import { exit as exit2 } from "process";
 var ManifestPublishModule = {
   command: "publish",
   describe: "Publish the Uniform Context manifest for a project",
-  builder: (yargs21) => withApiOptions(withProjectOptions(yargs21)),
+  builder: (yargs23) => withConfiguration(withApiOptions(withProjectOptions(yargs23))),
   handler: async ({ apiKey, apiHost, proxy, project }) => {
     const fetch3 = nodeFetchProxy(proxy);
     try {
@@ -2518,24 +2891,26 @@ var ManifestModule = {
   command: "manifest <command>",
   describe: "Commands for context manifests",
   aliases: ["man"],
-  builder: (yargs21) => yargs21.command(ManifestGetModule).command(ManifestPublishModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(ManifestGetModule).command(ManifestPublishModule).demandCommand(),
   handler: () => {
-    yargs8.help();
+    yargs9.help();
   }
 };
 
 // src/commands/context/commands/quirk.ts
-import yargs9 from "yargs";
+import yargs10 from "yargs";
 
 // src/commands/context/commands/quirk/get.ts
 import { UncachedQuirkClient } from "@uniformdev/context/api";
 var QuirkGetModule = {
   command: "get <id>",
   describe: "Fetch a quirk",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.positional("id", { demandOption: true, describe: "Quirk public ID to fetch" })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", { demandOption: true, describe: "Quirk public ID to fetch" })
+        )
       )
     )
   ),
@@ -2558,14 +2933,16 @@ var QuirkListModule = {
   command: "list",
   describe: "List quirks",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.option("withIntegrations", {
-          alias: ["i"],
-          describe: "Whether to include meta-quirks created by integrations in the list. Defaults to false.",
-          type: "boolean"
-        })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.option("withIntegrations", {
+            alias: ["i"],
+            describe: "Whether to include meta-quirks created by integrations in the list. Defaults to false.",
+            type: "boolean"
+          })
+        )
       )
     )
   ),
@@ -2617,30 +2994,32 @@ function createQuirkEngineDataSource({
 var QuirkPullModule = {
   command: "pull <directory>",
   describe: "Pulls all quirks to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save the quirks to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save the quirks to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -2694,24 +3073,26 @@ import { UncachedQuirkClient as UncachedQuirkClient4 } from "@uniformdev/context
 var QuirkPushModule = {
   command: "push <directory>",
   describe: "Pushes all quirks from files in a directory or package to Uniform",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read the quirks from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read the quirks from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -2760,9 +3141,11 @@ var QuirkRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a quirk",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Quirk public ID to delete" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "Quirk public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -2778,8 +3161,12 @@ var QuirkUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a quirk",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(yargs21.positional("filename", { demandOption: true, describe: "Quirk file to put" }))
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("filename", { demandOption: true, describe: "Quirk file to put" })
+      )
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -2794,24 +3181,26 @@ var QuirkModule = {
   command: "quirk <command>",
   aliases: ["qk"],
   describe: "Commands for Context quirks",
-  builder: (yargs21) => yargs21.command(QuirkPullModule).command(QuirkPushModule).command(QuirkGetModule).command(QuirkRemoveModule).command(QuirkListModule).command(QuirkUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(QuirkPullModule).command(QuirkPushModule).command(QuirkGetModule).command(QuirkRemoveModule).command(QuirkListModule).command(QuirkUpdateModule).demandCommand(),
   handler: () => {
-    yargs9.help();
+    yargs10.help();
   }
 };
 
 // src/commands/context/commands/signal.ts
-import yargs10 from "yargs";
+import yargs11 from "yargs";
 
 // src/commands/context/commands/signal/get.ts
 import { UncachedSignalClient } from "@uniformdev/context/api";
 var SignalGetModule = {
   command: "get <id>",
   describe: "Fetch a signal",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.positional("id", { demandOption: true, describe: "Signal public ID to fetch" })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", { demandOption: true, describe: "Signal public ID to fetch" })
+        )
       )
     )
   ),
@@ -2834,7 +3223,7 @@ var SignalListModule = {
   command: "list",
   describe: "List signals",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs23) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs23)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedSignalClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -2883,30 +3272,32 @@ function createSignalEngineDataSource({
 var SignalPullModule = {
   command: "pull <directory>",
   describe: "Pulls all signals to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save the signals to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save the signals to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -2960,24 +3351,26 @@ import { UncachedSignalClient as UncachedSignalClient4 } from "@uniformdev/conte
 var SignalPushModule = {
   command: "push <directory>",
   describe: "Pushes all signals from files in a directory or package to Uniform",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read the signals from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read the signals from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -3026,9 +3419,11 @@ var SignalRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a signal",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Signal public ID to delete" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "Signal public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -3044,8 +3439,12 @@ var SignalUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a signal",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(yargs21.positional("filename", { demandOption: true, describe: "Signal file to put" }))
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("filename", { demandOption: true, describe: "Signal file to put" })
+      )
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -3060,24 +3459,26 @@ var SignalModule = {
   command: "signal <command>",
   aliases: ["sig"],
   describe: "Commands for Context signals",
-  builder: (yargs21) => yargs21.command(SignalPullModule).command(SignalPushModule).command(SignalGetModule).command(SignalRemoveModule).command(SignalListModule).command(SignalUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(SignalPullModule).command(SignalPushModule).command(SignalGetModule).command(SignalRemoveModule).command(SignalListModule).command(SignalUpdateModule).demandCommand(),
   handler: () => {
-    yargs10.help();
+    yargs11.help();
   }
 };
 
 // src/commands/context/commands/test.ts
-import yargs11 from "yargs";
+import yargs12 from "yargs";
 
 // src/commands/context/commands/test/get.ts
 import { UncachedTestClient } from "@uniformdev/context/api";
 var TestGetModule = {
   command: "get <id>",
   describe: "Fetch a test",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.positional("id", { demandOption: true, describe: "Test public ID to fetch" })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", { demandOption: true, describe: "Test public ID to fetch" })
+        )
       )
     )
   ),
@@ -3100,7 +3501,7 @@ var TestListModule = {
   command: "list",
   describe: "List tests",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs23) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs23)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedTestClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -3149,30 +3550,32 @@ function createTestEngineDataSource({
 var TestPullModule = {
   command: "pull <directory>",
   describe: "Pulls all tests to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save the tests to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save the tests to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -3226,24 +3629,26 @@ import { UncachedTestClient as UncachedTestClient4 } from "@uniformdev/context/a
 var TestPushModule = {
   command: "push <directory>",
   describe: "Pushes all tests from files in a directory or package to Uniform",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read the tests from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read the tests from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -3292,8 +3697,12 @@ var TestRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a test",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(yargs21.positional("id", { demandOption: true, describe: "Test public ID to delete" }))
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "Test public ID to delete" })
+      )
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -3308,8 +3717,10 @@ var TestUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a test",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(yargs21.positional("filename", { demandOption: true, describe: "Test file to put" }))
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(yargs23.positional("filename", { demandOption: true, describe: "Test file to put" }))
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -3323,9 +3734,9 @@ var TestUpdateModule = {
 var TestModule = {
   command: "test <command>",
   describe: "Commands for Context A/B tests",
-  builder: (yargs21) => yargs21.command(TestPullModule).command(TestPushModule).command(TestGetModule).command(TestRemoveModule).command(TestListModule).command(TestUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(TestPullModule).command(TestPushModule).command(TestGetModule).command(TestRemoveModule).command(TestListModule).command(TestUpdateModule).demandCommand(),
   handler: () => {
-    yargs11.help();
+    yargs12.help();
   }
 };
 
@@ -3334,9 +3745,9 @@ var ContextCommand = {
   command: "context <command>",
   aliases: ["ctx"],
   describe: "Uniform Context commands",
-  builder: (yargs21) => yargs21.command(ManifestModule).command(SignalModule).command(EnrichmentModule).command(AggregateModule).command(QuirkModule).command(TestModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(ManifestModule).command(SignalModule).command(EnrichmentModule).command(AggregateModule).command(QuirkModule).command(TestModule).demandCommand(),
   handler: () => {
-    yargs12.showHelp();
+    yargs13.showHelp();
   }
 };
 
@@ -3364,11 +3775,11 @@ import { PostHog } from "posthog-node";
 // package.json
 var package_default = {
   name: "@uniformdev/cli",
-  version: "19.41.0",
+  version: "19.42.0",
   description: "Uniform command line interface tool",
   license: "SEE LICENSE IN LICENSE.txt",
   main: "./cli.js",
-  types: "./dist/index.d.ts",
+  types: "./dist/index.d.mts",
   sideEffects: false,
   scripts: {
     uniform: "node ./cli.js",
@@ -3385,7 +3796,8 @@ var package_default = {
     "@uniformdev/project-map": "workspace:*",
     "@uniformdev/redirect": "workspace:*",
     colorette: "2.0.20",
-    cosmiconfig: "^8.2.0",
+    cosmiconfig: "8.2.0",
+    "cosmiconfig-typescript-loader": "5.0.0",
     diff: "^5.0.0",
     dotenv: "^16.0.3",
     execa: "5.1.1",
@@ -3737,7 +4149,7 @@ ${err.message}`);
 
 // src/projects/cloneStarter.ts
 import crypto2 from "crypto";
-import fs2 from "fs";
+import fs3 from "fs";
 import fsj from "fs-jetpack";
 import * as git from "isomorphic-git";
 import * as http from "isomorphic-git/http/node/index.js";
@@ -3754,7 +4166,7 @@ async function cloneStarter({
   const [user, repo, ...pathSegments] = githubPath.split("/");
   try {
     await git.clone({
-      fs: fs2,
+      fs: fs3,
       http,
       url: `https://github.com/${user}/${repo}`,
       dir: cloneDir,
@@ -3765,13 +4177,13 @@ async function cloneStarter({
     throw new Error(`Failed to fetch starter code: ${err.message}`);
   }
   await done();
-  if (fs2.existsSync(targetDir) && fs2.readdirSync(targetDir).length > 0) {
+  if (fs3.existsSync(targetDir) && fs3.readdirSync(targetDir).length > 0) {
     throw new Error(`"${targetDir}" is not empty`);
   }
   const starterDir = path.join(cloneDir, ...pathSegments);
   fsj.copy(starterDir, targetDir, { overwrite: true });
   if (dotEnvFile) {
-    fs2.writeFileSync(path.resolve(targetDir, ".env"), dotEnvFile, "utf-8");
+    fs3.writeFileSync(path.resolve(targetDir, ".env"), dotEnvFile, "utf-8");
   }
   console.log(`
 Your project now lives in ${targetDir} \u2728`);
@@ -3787,7 +4199,7 @@ Installing project dependencies...
 }
 
 // src/projects/getOrCreateProject.ts
-import fs3, { existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
+import fs4, { existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
 import inquirer2 from "inquirer";
 import path2 from "path";
 import slugify from "slugify";
@@ -3914,9 +4326,9 @@ function validateProjectName(projectName, checkTargetDir, explicitTargetDir) {
     if (!existsSync2(targetDir)) {
       mkdirSync2(targetDir, { recursive: true });
     }
-    if (fs3.readdirSync(targetDir).length > 0) {
+    if (fs4.readdirSync(targetDir).length > 0) {
       targetDir = path2.resolve(targetDir, projectNameSlug);
-      if (fs3.existsSync(targetDir)) {
+      if (fs4.existsSync(targetDir)) {
         throw new Error(`${targetDir} already exists, choose a different name.`);
       }
     }
@@ -4324,24 +4736,26 @@ var disableTelemetryDefault = !["", "0", "false", "no"].includes(
 );
 var NewCmd = {
   command: "new [name]",
-  builder: (y) => y.positional("name", {
-    describe: "Name of a project",
-    type: "string"
-  }).option("apiHost", {
-    describe: `Uniform host. Defaults to UNIFORM_CLI_BASE_URL env or ${stableApiHost}. Supports dotenv.`,
-    default: apiHostDefault,
-    demandOption: true,
-    type: "string"
-  }).option("outputPath", {
-    alias: "o",
-    description: "Specify where to store integration files. Defaults to cwd.",
-    type: "string"
-  }).option("disableTelemetry", {
-    describe: "By default, usage information is sent to Uniform. Use this option or set UNIFORM_CLI_DISABLE_TELEMETRY to disable telemetry.",
-    default: disableTelemetryDefault,
-    demandOption: true,
-    type: "boolean"
-  }),
+  builder: (y) => withConfiguration(
+    y.positional("name", {
+      describe: "Name of a project",
+      type: "string"
+    }).option("apiHost", {
+      describe: `Uniform host. Defaults to UNIFORM_CLI_BASE_URL env or ${stableApiHost}. Supports dotenv.`,
+      default: apiHostDefault,
+      demandOption: true,
+      type: "string"
+    }).option("outputPath", {
+      alias: "o",
+      description: "Specify where to store integration files. Defaults to cwd.",
+      type: "string"
+    }).option("disableTelemetry", {
+      describe: "By default, usage information is sent to Uniform. Use this option or set UNIFORM_CLI_DISABLE_TELEMETRY to disable telemetry.",
+      default: disableTelemetryDefault,
+      demandOption: true,
+      type: "boolean"
+    })
+  ),
   describe: "Start a new Uniform project",
   handler: async function({ name, apiHost, outputPath, disableTelemetry }) {
     const { stopAllSpinners, spin } = makeSpinner();
@@ -4362,21 +4776,23 @@ var NewCmd = {
 };
 var NewMeshCmd = {
   command: "new-integration",
-  builder: (y) => y.option("apiHost", {
-    describe: `Uniform host. Defaults to UNIFORM_CLI_BASE_URL env or ${stableApiHost}. Supports dotenv.`,
-    default: apiHostDefault,
-    demandOption: true,
-    type: "string"
-  }).option("outputPath", {
-    alias: "o",
-    description: "Specify where to store integration files. Defaults to cwd.",
-    type: "string"
-  }).option("disableTelemetry", {
-    describe: "By default, usage information is sent to Uniform. Use this option or set UNIFORM_CLI_DISABLE_TELEMETRY to disable telemetry.",
-    default: disableTelemetryDefault,
-    demandOption: true,
-    type: "boolean"
-  }),
+  builder: (y) => withConfiguration(
+    y.option("apiHost", {
+      describe: `Uniform host. Defaults to UNIFORM_CLI_BASE_URL env or ${stableApiHost}. Supports dotenv.`,
+      default: apiHostDefault,
+      demandOption: true,
+      type: "string"
+    }).option("outputPath", {
+      alias: "o",
+      description: "Specify where to store integration files. Defaults to cwd.",
+      type: "string"
+    }).option("disableTelemetry", {
+      describe: "By default, usage information is sent to Uniform. Use this option or set UNIFORM_CLI_DISABLE_TELEMETRY to disable telemetry.",
+      default: disableTelemetryDefault,
+      demandOption: true,
+      type: "boolean"
+    })
+  ),
   describe: "Start a new Uniform project",
   handler: async function({ apiHost, outputPath, disableTelemetry }) {
     const { stopAllSpinners, spin } = makeSpinner();
@@ -4397,10 +4813,10 @@ var NewMeshCmd = {
 };
 
 // src/commands/optimize/index.ts
-import yargs14 from "yargs";
+import yargs15 from "yargs";
 
 // src/commands/optimize/manifest.ts
-import yargs13 from "yargs";
+import yargs14 from "yargs";
 
 // src/commands/optimize/manifest/download.ts
 import { gray as gray4, green as green3, red as red5, yellow as yellow2 } from "colorette";
@@ -4415,7 +4831,7 @@ var UniformBaseUrl = "https://uniform.app";
 var module = {
   command: "download [output]",
   describe: "Download intent manifest",
-  builder: (yargs21) => yargs21.option("apiKey", {
+  builder: (yargs23) => yargs23.option("apiKey", {
     alias: "k",
     demandOption: true,
     string: true,
@@ -4516,10 +4932,10 @@ var module2 = {
   command: "manifest <command>",
   describe: "Intent manifest commands",
   builder: () => {
-    return yargs13.command(download_default);
+    return yargs14.command(download_default);
   },
   handler: () => {
-    yargs13.showHelp();
+    yargs14.showHelp();
   }
 };
 var manifest_default = module2;
@@ -4530,28 +4946,30 @@ var OptimizeCommand = {
   aliases: ["opt"],
   describe: "Uniform Optimize commands",
   builder: () => {
-    return yargs14.command(manifest_default);
+    return yargs15.command(manifest_default);
   },
   handler: () => {
-    yargs14.showHelp();
+    yargs15.showHelp();
   }
 };
 
 // src/commands/project-map/index.ts
-import yargs17 from "yargs";
+import yargs18 from "yargs";
 
 // src/commands/project-map/commands/projectMapDefinition.ts
-import yargs15 from "yargs";
+import yargs16 from "yargs";
 
 // src/commands/project-map/commands/ProjectMapDefinition/get.ts
 import { UncachedProjectMapClient } from "@uniformdev/project-map";
 var ProjectMapDefinitionGetModule = {
   command: "get <id>",
   describe: "Fetch a project map",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.positional("id", { demandOption: true, describe: "ProjectMap UUID to fetch" })
+  builder: (yargs23) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", { demandOption: true, describe: "ProjectMap UUID to fetch" })
+        )
       )
     )
   ),
@@ -4574,7 +4992,7 @@ var ProjectMapDefinitionListModule = {
   command: "list",
   describe: "List of project maps",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs23) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs23)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedProjectMapClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4631,30 +5049,32 @@ function createProjectMapDefinitionEngineDataSource({
 var ProjectMapDefinitionPullModule = {
   command: "pull <directory>",
   describe: "Pulls all project maps to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save project maps to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save project maps to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -4708,24 +5128,26 @@ import { UncachedProjectMapClient as UncachedProjectMapClient4 } from "@uniformd
 var ProjectMapDefinitionPushModule = {
   command: "push <directory>",
   describe: "Pushes all project maps from files in a directory or package to Uniform",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read project maps from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read project maps from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -4774,8 +5196,10 @@ var ProjectMapDefinitionRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a project map",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(yargs21.positional("id", { demandOption: true, describe: " UUID to delete" }))
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(yargs23.positional("id", { demandOption: true, describe: " UUID to delete" }))
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -4790,9 +5214,11 @@ var ProjectMapDefinitionUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a project map",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("filename", { demandOption: true, describe: "Project map file to put" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("filename", { demandOption: true, describe: "Project map file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -4807,24 +5233,26 @@ var ProjectMapDefinitionUpdateModule = {
 var ProjectMapDefinitionModule = {
   command: "definition <command>",
   describe: "Commands for ProjectMap Definitions",
-  builder: (yargs21) => yargs21.command(ProjectMapDefinitionPullModule).command(ProjectMapDefinitionPushModule).command(ProjectMapDefinitionGetModule).command(ProjectMapDefinitionRemoveModule).command(ProjectMapDefinitionListModule).command(ProjectMapDefinitionUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(ProjectMapDefinitionPullModule).command(ProjectMapDefinitionPushModule).command(ProjectMapDefinitionGetModule).command(ProjectMapDefinitionRemoveModule).command(ProjectMapDefinitionListModule).command(ProjectMapDefinitionUpdateModule).demandCommand(),
   handler: () => {
-    yargs15.help();
+    yargs16.help();
   }
 };
 
 // src/commands/project-map/commands/projectMapNode.ts
-import yargs16 from "yargs";
+import yargs17 from "yargs";
 
 // src/commands/project-map/commands/ProjectMapNode/get.ts
 import { UncachedProjectMapClient as UncachedProjectMapClient7 } from "@uniformdev/project-map";
 var ProjectMapNodeGetModule = {
   command: "get <id> <projectMapId>",
   describe: "Fetch a project map node",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to fetch" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to fetch from" })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to fetch" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to fetch from" })
+        )
       )
     )
   ),
@@ -4849,10 +5277,15 @@ var ProjectMapNodeListModule = {
   command: "list <projectMapId>",
   describe: "List project map nodes",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(
-        yargs21.positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to fetch from" })
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("projectMapId", {
+            demandOption: true,
+            describe: "ProjectMap UUID to fetch from"
+          })
+        )
       )
     )
   ),
@@ -4919,30 +5352,32 @@ function createProjectMapNodeEngineDataSource({
 var ProjectMapNodePullModule = {
   command: "pull <directory>",
   describe: "Pulls all project maps nodes to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save project maps to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save project maps to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -5000,24 +5435,26 @@ import { UncachedProjectMapClient as UncachedProjectMapClient10 } from "@uniform
 var ProjectMapNodePushModule = {
   command: "push <directory>",
   describe: "Pushes all project maps nodes from files in a directory or package to Uniform",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read project maps from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read project maps from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -5075,9 +5512,11 @@ var ProjectMapNodeRemoveModule = {
   command: "remove <id> <projectMapId>",
   aliases: ["delete", "rm"],
   describe: "Delete a project map node",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to delete" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to delete from" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to delete" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to delete from" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, projectMapId, id, project: projectId }) => {
@@ -5093,9 +5532,11 @@ var ProjectMapNodeUpdateModule = {
   command: "update <filename> <projectMapId>",
   aliases: ["put"],
   describe: "Insert or update a project map node",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("filename", { demandOption: true, describe: "ProjectMap node file with nodes data" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to put into" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("filename", { demandOption: true, describe: "ProjectMap node file with nodes data" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to put into" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, projectMapId, filename, project: projectId }) => {
@@ -5110,9 +5551,9 @@ var ProjectMapNodeUpdateModule = {
 var ProjectMapNodeModule = {
   command: "node <command>",
   describe: "Commands for ProjectMap Nodes",
-  builder: (yargs21) => yargs21.command(ProjectMapNodePullModule).command(ProjectMapNodePushModule).command(ProjectMapNodeGetModule).command(ProjectMapNodeRemoveModule).command(ProjectMapNodeListModule).command(ProjectMapNodeUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(ProjectMapNodePullModule).command(ProjectMapNodePushModule).command(ProjectMapNodeGetModule).command(ProjectMapNodeRemoveModule).command(ProjectMapNodeListModule).command(ProjectMapNodeUpdateModule).demandCommand(),
   handler: () => {
-    yargs16.help();
+    yargs17.help();
   }
 };
 
@@ -5121,26 +5562,30 @@ var ProjectMapCommand = {
   command: "project-map <command>",
   aliases: ["prm"],
   describe: "Uniform ProjectMap commands",
-  builder: (yargs21) => yargs21.command(ProjectMapNodeModule).command(ProjectMapDefinitionModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(ProjectMapNodeModule).command(ProjectMapDefinitionModule).demandCommand(),
   handler: () => {
-    yargs17.showHelp();
+    yargs18.showHelp();
   }
 };
 
 // src/commands/redirect/index.ts
-import yargs19 from "yargs";
+import yargs20 from "yargs";
 
 // src/commands/redirect/commands/redirect.ts
-import yargs18 from "yargs";
+import yargs19 from "yargs";
 
 // src/commands/redirect/commands/RedirectDefinition/get.ts
 import { UncachedRedirectClient } from "@uniformdev/redirect";
 var RedirectDefinitionGetModule = {
   command: "get <id>",
   describe: "Fetch a redirect",
-  builder: (yargs21) => withFormatOptions(
-    withApiOptions(
-      withProjectOptions(yargs21.positional("id", { demandOption: true, describe: "Redirect UUID to fetch" }))
+  builder: (yargs23) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs23.positional("id", { demandOption: true, describe: "Redirect UUID to fetch" })
+        )
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, format, project: projectId, filename }) => {
@@ -5162,7 +5607,7 @@ var RedirectDefinitionListModule = {
   command: "list",
   describe: "List of redirects",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs23) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs23)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedRedirectClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -5228,30 +5673,32 @@ function createRedirectDefinitionEngineDataSource({
 var RedirectDefinitionPullModule = {
   command: "pull <directory>",
   describe: "Pulls all redirects to local files in a directory",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to save redirects to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
-          type: "string"
-        }).option("format", {
-          alias: ["f"],
-          describe: "Output format",
-          default: "yaml",
-          choices: ["yaml", "json"],
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes no files",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to save redirects to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -5306,24 +5753,26 @@ import { UncachedRedirectClient as UncachedRedirectClient4 } from "@uniformdev/r
 var RedirectDefinitionPushModule = {
   command: "push <directory>",
   describe: "Pushes all redirects from files in a directory or package to Uniform",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      withDiffOptions(
-        yargs21.positional("directory", {
-          describe: "Directory to read redirects from. If a filename is used, a package will be read instead.",
-          type: "string"
-        }).option("what-if", {
-          alias: ["w"],
-          describe: "What-if mode reports what would be done but changes nothing",
-          default: false,
-          type: "boolean"
-        }).option("mode", {
-          alias: ["m"],
-          describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
-          choices: ["create", "createOrUpdate", "mirror"],
-          default: "mirror",
-          type: "string"
-        })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.positional("directory", {
+            describe: "Directory to read redirects from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
       )
     )
   ),
@@ -5372,8 +5821,10 @@ var RedirectDefinitionRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a redirect",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(yargs21.positional("id", { demandOption: true, describe: " UUID to delete" }))
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(yargs23.positional("id", { demandOption: true, describe: " UUID to delete" }))
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -5388,9 +5839,11 @@ var RedirectDefinitionUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a redirect",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("filename", { demandOption: true, describe: "Redirect file to put" })
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs23.positional("filename", { demandOption: true, describe: "Redirect file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -5405,9 +5858,9 @@ var RedirectDefinitionUpdateModule = {
 var RedirectDefinitionModule = {
   command: "definition <command>",
   describe: "Commands for Redirect Definitions",
-  builder: (yargs21) => yargs21.command(RedirectDefinitionPullModule).command(RedirectDefinitionPushModule).command(RedirectDefinitionGetModule).command(RedirectDefinitionRemoveModule).command(RedirectDefinitionListModule).command(RedirectDefinitionUpdateModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(RedirectDefinitionPullModule).command(RedirectDefinitionPushModule).command(RedirectDefinitionGetModule).command(RedirectDefinitionRemoveModule).command(RedirectDefinitionListModule).command(RedirectDefinitionUpdateModule).demandCommand(),
   handler: () => {
-    yargs18.help();
+    yargs19.help();
   }
 };
 
@@ -5416,9 +5869,179 @@ var RedirectCommand = {
   command: "redirect <command>",
   aliases: ["red"],
   describe: "Uniform Redirect commands",
-  builder: (yargs21) => yargs21.command(RedirectDefinitionModule).demandCommand(),
+  builder: (yargs23) => yargs23.command(RedirectDefinitionModule).demandCommand(),
+  handler: () => {
+    yargs20.showHelp();
+  }
+};
+
+// src/commands/sync/index.ts
+import yargs21 from "yargs";
+
+// src/commands/sync/commands/pull.ts
+var SyncPullModule = {
+  command: "pull",
+  describe: "Pulls whole project to local files in a directory",
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          })
+        )
+      )
+    )
+  ),
+  handler: async ({ serialization, ...otherParams }) => {
+    const config2 = serialization;
+    const enabledEntities = Object.entries({
+      category: CategoryPullModule,
+      dataType: DataTypePullModule,
+      quirk: QuirkPullModule,
+      test: TestPullModule,
+      signal: SignalPullModule,
+      enrichment: EnrichmentPullModule,
+      aggregate: AggregatePullModule,
+      component: ComponentPullModule,
+      pattern: PatternPullModule,
+      composition: CompositionPullModule,
+      projectMapDefinition: ProjectMapDefinitionPullModule,
+      projectMapNode: ProjectMapNodePullModule,
+      redirect: RedirectDefinitionPullModule
+    }).filter(([entityType]) => {
+      var _a, _b, _c, _d, _e, _f;
+      return Boolean((_a = config2.entitiesConfig) == null ? void 0 : _a[entityType]) && ((_c = (_b = config2.entitiesConfig) == null ? void 0 : _b[entityType]) == null ? void 0 : _c.disabled) !== true && ((_f = (_e = (_d = config2.entitiesConfig) == null ? void 0 : _d[entityType]) == null ? void 0 : _e.pull) == null ? void 0 : _f.disabled) !== true;
+    });
+    for (const [entityType, module3] of enabledEntities) {
+      await module3.handler({
+        ...otherParams,
+        state: 0,
+        format: getFormat(entityType, config2),
+        onlyCompositions: entityType === "composition" ? true : void 0,
+        onlyPatterns: entityType === "pattern" ? true : void 0,
+        mode: getPullMode(entityType, config2),
+        directory: getPullFilename(entityType, config2)
+      });
+    }
+  }
+};
+var getPullMode = (entityType, config2) => {
+  return getEntityOption({
+    optionName: "mode",
+    operation: "pull",
+    config: config2,
+    entityType
+  });
+};
+var getPullFilename = (entityType, config2) => {
+  return getDirectoryOrFilename({
+    operation: "pull",
+    config: config2,
+    entityType
+  });
+};
+var getFormat = (entityType, config2) => {
+  return getEntityOption({
+    optionName: "format",
+    operation: "pull",
+    config: config2,
+    entityType
+  });
+};
+
+// src/commands/sync/commands/push.ts
+var SyncPushModule = {
+  command: "push",
+  describe: "Pushes whole project data from files in a directory or package to Uniform",
+  builder: (yargs23) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs23.option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          })
+        )
+      )
+    )
+  ),
+  handler: async ({ serialization, ...otherParams }) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
+    const config2 = serialization;
+    const enabledEntities = Object.entries({
+      category: CategoryPushModule,
+      dataType: DataTypePushModule,
+      quirk: QuirkPushModule,
+      test: TestPushModule,
+      signal: SignalPushModule,
+      enrichment: EnrichmentPushModule,
+      aggregate: AggregatePushModule,
+      component: ComponentPushModule,
+      pattern: PatternPushModule,
+      composition: CompositionPushModule,
+      projectMapDefinition: ProjectMapDefinitionPushModule,
+      projectMapNode: ProjectMapNodePushModule,
+      redirect: RedirectDefinitionPushModule
+    }).filter(([entityType]) => {
+      var _a2, _b2, _c2, _d2, _e2, _f2;
+      return Boolean((_a2 = config2.entitiesConfig) == null ? void 0 : _a2[entityType]) && ((_c2 = (_b2 = config2.entitiesConfig) == null ? void 0 : _b2[entityType]) == null ? void 0 : _c2.disabled) !== true && ((_f2 = (_e2 = (_d2 = config2.entitiesConfig) == null ? void 0 : _d2[entityType]) == null ? void 0 : _e2.push) == null ? void 0 : _f2.disabled) !== true;
+    });
+    for (const [entityType, module3] of enabledEntities) {
+      await module3.handler({
+        ...otherParams,
+        state: 0,
+        format: getFormat2(entityType, config2),
+        onlyCompositions: entityType === "composition" ? true : void 0,
+        onlyPatterns: entityType === "pattern" ? true : void 0,
+        mode: getPushMode(entityType, config2),
+        directory: getPushFilename(entityType, config2)
+      });
+    }
+    if (((_a = config2.entitiesConfig) == null ? void 0 : _a.pattern) && ((_d = (_c = (_b = config2.entitiesConfig) == null ? void 0 : _b.pattern) == null ? void 0 : _c.push) == null ? void 0 : _d.disabled) !== true && ((_f = (_e = config2.entitiesConfig) == null ? void 0 : _e.pattern) == null ? void 0 : _f.publish)) {
+      await PatternPublishModule.handler({ ...otherParams, all: true });
+    }
+    if (((_g = config2.entitiesConfig) == null ? void 0 : _g.composition) && ((_j = (_i = (_h = config2.entitiesConfig) == null ? void 0 : _h.composition) == null ? void 0 : _i.push) == null ? void 0 : _j.disabled) !== true && ((_l = (_k = config2.entitiesConfig) == null ? void 0 : _k.composition) == null ? void 0 : _l.publish)) {
+      await CompositionPublishModule.handler({ ...otherParams, all: true });
+    }
+  }
+};
+var getPushMode = (entityType, config2) => {
+  return getEntityOption({
+    optionName: "mode",
+    operation: "push",
+    config: config2,
+    entityType
+  });
+};
+var getPushFilename = (entityType, config2) => {
+  return getDirectoryOrFilename({
+    operation: "push",
+    config: config2,
+    entityType
+  });
+};
+var getFormat2 = (entityType, config2) => {
+  return getEntityOption({
+    optionName: "format",
+    operation: "push",
+    config: config2,
+    entityType
+  });
+};
+
+// src/commands/sync/index.ts
+var SyncCommand = {
+  command: "sync <command>",
+  describe: "Uniform Sync commands",
+  builder: (yargs23) => yargs23.command(SyncPullModule).command(SyncPushModule).demandCommand(),
   handler: () => {
-    yargs19.showHelp();
+    yargs21.showHelp();
   }
 };
 
@@ -5465,14 +6088,14 @@ import { magenta, red as red6 } from "colorette";
 import { join as join2 } from "path";
 
 // src/fs.ts
-import { promises as fs4 } from "fs";
+import { promises as fs5 } from "fs";
 async function readJSON(path4) {
-  const fileContents = await fs4.readFile(path4, "utf-8");
+  const fileContents = await fs5.readFile(path4, "utf-8");
   return JSON.parse(fileContents);
 }
 async function tryReadJSON(path4, missingValue = null) {
   try {
-    const stat = await fs4.stat(path4);
+    const stat = await fs5.stat(path4);
     return stat.isFile() ? await readJSON(path4) : missingValue;
   } catch (e) {
     return missingValue;
@@ -5534,9 +6157,13 @@ First found was: v${firstVersion}`;
 
 // src/index.ts
 dotenv.config();
-var yarggery = yargs20(hideBin(process.argv));
+var yarggery = yargs22(hideBin(process.argv));
+var inlineConfigurationFilePath = "config" in yarggery.argv && yarggery.argv.config;
+var configuration = loadConfig(inlineConfigurationFilePath || null);
 yarggery.option("verbose", {
   describe: "Include verbose logging",
   default: false,
   type: "boolean"
-}).command(CanvasCommand).command(ContextCommand).command(ProjectMapCommand).command(RedirectCommand).command(NewCmd).command(NewMeshCmd).command(OptimizeCommand).demandCommand(1, "").strict().help().middleware([checkForUpdateMiddleware, checkLocalDepsVersions]).argv;
+}).scriptName("uniform").config(configuration).config("config", function() {
+  return {};
+}).command(CanvasCommand).command(ContextCommand).command(ProjectMapCommand).command(RedirectCommand).command(SyncCommand).command(NewCmd).command(NewMeshCmd).command(OptimizeCommand).demandCommand(1, "").strict().help().middleware([checkForUpdateMiddleware, checkLocalDepsVersions]).argv;