@uniformdev/cli 19.38.2 → 19.38.3-alpha.78

package/dist/index.mjs

@@ -2,11 +2,11 @@
 
 // src/index.ts
 import * as dotenv from "dotenv";
-import yargs20 from "yargs";
+import yargs24 from "yargs";
 import { hideBin } from "yargs/helpers";
 
 // src/commands/canvas/index.ts
-import yargs5 from "yargs";
+import yargs8 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(yargs25) {
+  return yargs25.option("serialization", {
+    skipValidation: true,
+    hidden: true
+  });
+}
+function withApiOptions(yargs25) {
+  return yargs25.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(yargs25) {
+  return yargs25.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(yargs25) {
+  return yargs25.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(yargs25) {
+  return yargs25.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);
@@ -312,7 +411,9 @@ async function syncEngine({
   whatIf = false,
   // eslint-disable-next-line @typescript-eslint/no-empty-function
   log = () => {
-  }
+  },
+  onBeforeCompareObjects,
+  onBeforeWriteObject
 }) {
   var _a, _b;
   const targetItems = /* @__PURE__ */ new Map();
@@ -346,18 +447,20 @@ async function syncEngine({
   }
   const actions = [];
   let sourceHasItems = false;
-  for await (const sourceObject of source.objects) {
+  for await (let sourceObject of source.objects) {
     sourceHasItems = true;
     const ids = Array.isArray(sourceObject.id) ? sourceObject.id : [sourceObject.id];
     const targetObject = targetItems.get(ids[0]);
     const invalidTargetObjects = ids.map((i) => targetItems.get(i)).filter((o) => (o == null ? void 0 : o.object) !== (targetObject == null ? void 0 : targetObject.object));
     if (targetObject && invalidTargetObjects.length == 0) {
+      sourceObject = onBeforeCompareObjects ? await onBeforeCompareObjects(sourceObject, targetObject) : sourceObject;
       if (!compareContents(sourceObject, targetObject)) {
         if (mode === "createOrUpdate" || mode === "mirror") {
           const process2 = async (sourceObject2, targetObject2) => {
             if (!whatIf) {
               try {
-                await target.writeObject(sourceObject2, targetObject2);
+                const finalSourceObject = onBeforeWriteObject ? await onBeforeWriteObject(sourceObject2, targetObject2) : sourceObject2;
+                await target.writeObject(finalSourceObject, targetObject2);
               } catch (e) {
                 throw new SyncEngineError(e, sourceObject2);
               }
@@ -379,7 +482,8 @@ async function syncEngine({
       const process2 = async (sourceObject2, id) => {
         if (!whatIf) {
           try {
-            await target.writeObject(sourceObject2);
+            const finalSourceObject = onBeforeWriteObject ? await onBeforeWriteObject(sourceObject2) : sourceObject2;
+            await target.writeObject(finalSourceObject);
           } catch (e) {
             throw new SyncEngineError(e, sourceObject2);
           }
@@ -475,9 +579,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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", { demandOption: true, describe: "Category UUID to fetch" })
+        )
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, format, project: projectId, filename }) => {
@@ -500,7 +608,7 @@ var CategoryListModule = {
   command: "list",
   describe: "List categories",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21.options({})))),
+  builder: (yargs25) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs25.options({}))))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCategoryClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -510,7 +618,7 @@ var CategoryListModule = {
 };
 
 // src/commands/canvas/commands/category/pull.ts
-import { UncachedCanvasClient } from "@uniformdev/canvas";
+import { UncachedCategoryClient as UncachedCategoryClient3 } from "@uniformdev/canvas";
 
 // src/commands/canvas/commands/category/_util.ts
 var selectIdentifier = (category) => category.id;
@@ -557,30 +665,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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"
+          })
+        )
       )
     )
   ),
@@ -596,7 +706,7 @@ var CategoryPullModule = {
     diff: diffMode
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCategoryClient3({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createCategoriesEngineDataSource({ client });
     let target;
     const isPackage = isPathAPackageFile(directory);
@@ -630,28 +740,30 @@ var CategoryPullModule = {
 };
 
 // src/commands/canvas/commands/category/push.ts
-import { UncachedCanvasClient as UncachedCanvasClient2 } from "@uniformdev/canvas";
+import { UncachedCategoryClient as UncachedCategoryClient4 } from "@uniformdev/canvas";
 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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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"
+          })
+        )
       )
     )
   ),
@@ -666,7 +778,7 @@ var CategoryPushModule = {
     diff: diffMode
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient2({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCategoryClient4({ apiKey, apiHost, fetch: fetch3, projectId });
     let source;
     const isPackage = isPathAPackageFile(directory);
     if (isPackage) {
@@ -695,35 +807,41 @@ var CategoryPushModule = {
 };
 
 // src/commands/canvas/commands/category/remove.ts
-import { UncachedCanvasClient as UncachedCanvasClient3 } from "@uniformdev/canvas";
+import { UncachedCategoryClient as UncachedCategoryClient5 } from "@uniformdev/canvas";
 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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("id", { demandOption: true, describe: "Category UUID to delete" })
+      )
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient3({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCategoryClient5({ apiKey, apiHost, fetch: fetch3, projectId });
     await client.removeCategory({ categoryId: id });
   }
 };
 
 // src/commands/canvas/commands/category/update.ts
-import { UncachedCanvasClient as UncachedCanvasClient4 } from "@uniformdev/canvas";
+import { UncachedCategoryClient as UncachedCategoryClient6 } from "@uniformdev/canvas";
 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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("filename", { demandOption: true, describe: "Category file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient4({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCategoryClient6({ apiKey, apiHost, fetch: fetch3, projectId });
     const file = readFileToObject(filename);
     await client.upsertCategories([file]);
   }
@@ -734,7 +852,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: (yargs25) => yargs25.command(CategoryPullModule).command(CategoryPushModule).command(CategoryGetModule).command(CategoryRemoveModule).command(CategoryListModule).command(CategoryUpdateModule).demandCommand(),
   handler: () => {
     yargs.help();
   }
@@ -744,7 +862,7 @@ var CategoryModule = {
 import yargs2 from "yargs";
 
 // src/commands/canvas/commands/component/get.ts
-import { UncachedCanvasClient as UncachedCanvasClient5 } from "@uniformdev/canvas";
+import { UncachedCanvasClient } from "@uniformdev/canvas";
 
 // src/commands/canvas/commands/component/_util.ts
 var selectIdentifier2 = (component) => component.id;
@@ -755,16 +873,21 @@ 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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", {
+            demandOption: true,
+            describe: "Component definition public ID to fetch"
+          })
+        )
       )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, format, project: projectId, filename }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient5({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient({ apiKey, apiHost, fetch: fetch3, projectId });
     const res = await client.getComponentDefinitions({ componentId: id, limit: 1 });
     if (res.componentDefinitions.length === 0) {
       console.error("Component did not exist");
@@ -783,31 +906,33 @@ var ComponentGetModule = {
 };
 
 // src/commands/canvas/commands/component/list.ts
-import { UncachedCanvasClient as UncachedCanvasClient6 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient2 } from "@uniformdev/canvas";
 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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.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 }
+          })
+        )
       )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, limit, offset, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient6({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient2({ apiKey, apiHost, fetch: fetch3, projectId });
     const res = await client.getComponentDefinitions({ limit, offset });
     emitWithFormat(res.componentDefinitions, format, filename);
   }
 };
 
 // src/commands/canvas/commands/component/pull.ts
-import { UncachedCanvasClient as UncachedCanvasClient7 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient3 } from "@uniformdev/canvas";
 
 // src/commands/canvas/componentDefinitionEngineDataSource.ts
 function createComponentDefinitionEngineDataSource({
@@ -845,30 +970,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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"
+          })
+        )
       )
     )
   ),
@@ -884,7 +1011,7 @@ var ComponentPullModule = {
     diff: diffMode
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient7({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient3({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createComponentDefinitionEngineDataSource({ client });
     let target;
     const isPackage = isPathAPackageFile(directory);
@@ -919,28 +1046,30 @@ var ComponentPullModule = {
 };
 
 // src/commands/canvas/commands/component/push.ts
-import { UncachedCanvasClient as UncachedCanvasClient8 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient4 } from "@uniformdev/canvas";
 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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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"
+          })
+        )
       )
     )
   ),
@@ -955,7 +1084,7 @@ var ComponentPushModule = {
     diff: diffMode
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient8({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient4({ apiKey, apiHost, fetch: fetch3, projectId });
     let source;
     const isPackage = isPathAPackageFile(directory);
     if (isPackage) {
@@ -985,37 +1114,41 @@ var ComponentPushModule = {
 };
 
 // src/commands/canvas/commands/component/remove.ts
-import { UncachedCanvasClient as UncachedCanvasClient9 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient5 } from "@uniformdev/canvas";
 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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("id", { demandOption: true, describe: "Component definition public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient9({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient5({ apiKey, apiHost, fetch: fetch3, projectId });
     await client.removeComponentDefinition({ componentId: id });
   }
 };
 
 // src/commands/canvas/commands/component/update.ts
-import { UncachedCanvasClient as UncachedCanvasClient10 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient6 } from "@uniformdev/canvas";
 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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("filename", { demandOption: true, describe: "Component definition file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient10({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient6({ apiKey, apiHost, fetch: fetch3, projectId });
     const file = readFileToObject(filename);
     await client.updateComponentDefinition({ componentDefinition: file });
   }
@@ -1026,7 +1159,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: (yargs25) => yargs25.command(ComponentPullModule).command(ComponentPushModule).command(ComponentGetModule).command(ComponentRemoveModule).command(ComponentListModule).command(ComponentUpdateModule).demandCommand(),
   handler: () => {
     yargs2.help();
   }
@@ -1036,7 +1169,7 @@ var ComponentModule = {
 import yargs3 from "yargs";
 
 // src/commands/canvas/commands/composition/get.ts
-import { UncachedCanvasClient as UncachedCanvasClient11 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient7 } from "@uniformdev/canvas";
 
 // src/commands/canvas/util.ts
 import { CANVAS_DRAFT_STATE, CANVAS_PUBLISHED_STATE } from "@uniformdev/canvas";
@@ -1048,8 +1181,8 @@ function prepCompositionForDisk(composition) {
   delete prepped.state;
   return prepped;
 }
-function withStateOptions(yargs21) {
-  return yargs21.option("state", {
+function withStateOptions(yargs25) {
+  return yargs25.option("state", {
     type: "string",
     describe: `Composition state to fetch.`,
     choices: ["preview", "published"],
@@ -1074,37 +1207,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: (yargs25) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          withStateOptions(
+            yargs25.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"
+              }
+            })
+          )
         )
       )
     )
@@ -1126,7 +1261,7 @@ var CompositionGetModule = {
     diagnostics
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient11({ apiKey, edgeApiHost, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient7({ apiKey, edgeApiHost, apiHost, fetch: fetch3, projectId });
     const res = prepCompositionForDisk(
       await client.getCompositionById({
         compositionId: id,
@@ -1143,34 +1278,47 @@ var CompositionGetModule = {
 };
 
 // src/commands/canvas/commands/composition/list.ts
-import { UncachedCanvasClient as UncachedCanvasClient12 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient8 } from "@uniformdev/canvas";
 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: (yargs25) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          withStateOptions(
+            yargs25.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 +1331,8 @@ var CompositionListModule = {
     offset,
     format,
     filename,
+    onlyCompositions,
+    onlyPatterns,
     project: projectId,
     state,
     resolvePatterns,
@@ -1190,10 +1340,11 @@ var CompositionListModule = {
     componentIDs
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient12({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient8({ apiKey, apiHost, fetch: fetch3, projectId });
     const res = await client.getCompositionList({
       limit,
       offset,
+      pattern: onlyCompositions ? false : onlyPatterns ? true : void 0,
       state: convertCompositionState(state),
       skipPatternResolution: !resolvePatterns,
       withComponentIDs: componentIDs,
@@ -1204,7 +1355,7 @@ var CompositionListModule = {
 };
 
 // src/commands/canvas/commands/composition/publish.ts
-import { UncachedCanvasClient as UncachedCanvasClient13 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient9 } from "@uniformdev/canvas";
 
 // src/commands/canvas/commands/composition/_util.ts
 var selectIdentifier3 = (component) => component.composition._id;
@@ -1214,6 +1365,8 @@ var selectDisplayName3 = (component) => `${component.composition._name ?? compon
 function createComponentInstanceEngineDataSource({
   client,
   state,
+  onlyCompositions,
+  onlyPatterns,
   ...clientOptions
 }) {
   const stateId = convertCompositionState(state);
@@ -1223,6 +1376,7 @@ function createComponentInstanceEngineDataSource({
         ...clientOptions,
         limit,
         offset,
+        pattern: onlyCompositions ? false : onlyPatterns ? true : void 0,
         state: stateId,
         skipPatternResolution: true,
         skipOverridesResolution: true,
@@ -1253,25 +1407,36 @@ function createComponentInstanceEngineDataSource({
 
 // src/commands/canvas/commands/composition/publish.ts
 var CompositionPublishModule = {
-  command: "publish [compositionIDs]",
-  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"
-        })
+  command: "publish [ids]",
+  describe: "Publishes composition(s)",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.positional("ids", {
+            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"
+          }).option("onlyCompositions", {
+            describe: "Only publishing compositions and not patterns",
+            default: false,
+            type: "boolean"
+          }).option("onlyPatterns", {
+            describe: "Only pulling patterns and not compositions",
+            default: false,
+            type: "boolean",
+            hidden: true
+          })
+        )
       )
     )
   ),
@@ -1279,33 +1444,40 @@ var CompositionPublishModule = {
     apiHost,
     apiKey,
     proxy,
-    compositionIDs,
+    ids,
     all,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    onlyCompositions,
+    onlyPatterns
   }) => {
-    if (!all && !compositionIDs || all && compositionIDs) {
+    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 UncachedCanvasClient13({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient9({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createComponentInstanceEngineDataSource({
       client,
       state: "preview",
-      compositionIDs: compositionIDsArray
+      compositionIDs: compositionIDsArray,
+      onlyCompositions,
+      onlyPatterns
     });
     const target = createComponentInstanceEngineDataSource({
       client,
       state: "published",
-      compositionIDs: compositionIDsArray
+      compositionIDs: compositionIDsArray,
+      onlyCompositions,
+      onlyPatterns
     });
     await syncEngine({
       source,
       target,
-      mode: "mirror",
+      // Publishing is one-direction operation, so no need to support automatic un-publishing
+      mode: "createOrUpdate",
       whatIf,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
@@ -1313,35 +1485,221 @@ var CompositionPublishModule = {
 };
 
 // src/commands/canvas/commands/composition/pull.ts
-import { UncachedCanvasClient as UncachedCanvasClient14 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient10 } from "@uniformdev/canvas";
+
+// src/files/index.ts
+import { preferredType } from "@thi.ng/mime";
+import { FILE_READY_STATE, getFileNameFromUrl } from "@uniformdev/files";
+import { createHash } from "crypto";
+import fsj from "fs-jetpack";
+import sizeOf from "image-size";
+import PQueue from "p-queue";
+import { join as join2 } from "path";
+var FILES_DIRECTORY_NAME = "files";
+var urlToHash = (url) => {
+  const hash = createHash("sha256");
+  hash.update(url);
+  return hash.digest("hex");
+};
+var urlToFileName = (url) => {
+  const fileName = urlToHash(url);
+  const fileNameChunks = url.split(".");
+  const fileExtension = fileNameChunks.length > 1 ? fileNameChunks.at(-1) : "";
+  return `${fileName}${fileExtension ? `.${fileExtension}` : ""}`;
+};
+var extractAndDownloadUniformFilesForObject = async (object, options) => {
+  const objectAsString = JSON.stringify(object);
+  const uniformFileUrlMatches = objectAsString.matchAll(
+    /"(https:\/\/(.*)?img\.uniform\.(rocks|global)\/(.*?))"/g
+  );
+  if (uniformFileUrlMatches) {
+    const fileDownloadQueue = new PQueue({ concurrency: 10 });
+    for (const match of uniformFileUrlMatches) {
+      const url = new URL(match[1]);
+      fileDownloadQueue.add(async () => {
+        try {
+          const fetchUrl = `${url.origin}${url.pathname}?format=original`;
+          const fileName = urlToFileName(url.toString());
+          const fileAlreadyExists = await fsj.existsAsync(
+            join2(options.directory, FILES_DIRECTORY_NAME, fileName)
+          );
+          if (fileAlreadyExists) {
+            return;
+          }
+          const response = await fetch(fetchUrl);
+          if (!response.ok) {
+            return;
+          }
+          const fileBuffer = await response.arrayBuffer();
+          await fsj.writeAsync(
+            join2(options.directory, FILES_DIRECTORY_NAME, fileName),
+            Buffer.from(fileBuffer)
+          );
+        } catch {
+          console.warn(`Failed to download file ${url}`);
+        }
+      });
+    }
+    await fileDownloadQueue.onIdle();
+  }
+  return object;
+};
+var extractAndUploadUniformFilesForObject = async (object, options) => {
+  let objectAsString = JSON.stringify(object);
+  const uniformFileUrlMatches = objectAsString.matchAll(
+    /"(https:\/\/(.*)?img\.uniform\.(rocks|global)\/(.*?))"/g
+  );
+  if (uniformFileUrlMatches) {
+    const fileUploadQueue = new PQueue({ concurrency: 3 });
+    for (const match of uniformFileUrlMatches) {
+      const url = match[1];
+      const hash = urlToHash(url);
+      fileUploadQueue.add(async () => {
+        try {
+          const fileAlreadyExistsChecks = await Promise.all([
+            options.fileClient.getFile({ projectId: options.projectId, url }).catch(() => null),
+            options.fileClient.getFile({ projectId: options.projectId, sourceId: hash }).catch(() => null)
+          ]);
+          if (fileAlreadyExistsChecks.some((check) => check !== null)) {
+            return;
+          }
+          const localFileName = urlToFileName(url);
+          const fileExistsLocally = await fsj.existsAsync(
+            join2(options.directory, FILES_DIRECTORY_NAME, localFileName)
+          );
+          if (!fileExistsLocally) {
+            console.warn(`Skipping file ${url} as we couldn't find a local copy`);
+            return;
+          }
+          const fileBuffer = await fsj.readAsync(
+            join2(options.directory, FILES_DIRECTORY_NAME, localFileName),
+            "buffer"
+          );
+          if (!fileBuffer) {
+            console.warn(`Skipping file ${url} as we couldn't read it`);
+            return;
+          }
+          const fileName = getFileNameFromUrl(url);
+          const { width, height } = (() => {
+            try {
+              return sizeOf(fileBuffer);
+            } catch {
+              return {
+                width: void 0,
+                height: void 0
+              };
+            }
+          })();
+          const { id, method, uploadUrl } = await options.fileClient.createNewProjectFile({
+            name: fileName,
+            mediaType: preferredType(url.split(".").at(-1) ?? ""),
+            size: fileBuffer.length,
+            width,
+            height,
+            projectId: options.projectId,
+            sourceId: hash
+          });
+          const uploadResponse = await fetch(uploadUrl, {
+            method,
+            body: fileBuffer
+          });
+          if (!uploadResponse.ok) {
+            console.warn(`Failed to upload file ${url}`);
+            return;
+          }
+          const checkForFile = async () => {
+            const file = await options.fileClient.getFile({ id });
+            if (!file || file.state !== FILE_READY_STATE) {
+              await new Promise((resolve) => setTimeout(resolve, 500));
+              return checkForFile();
+            }
+            return file.url;
+          };
+          const abortTimeout = setTimeout(() => {
+            throw new Error(`Failed to upload file ${url}`);
+          }, 1e4);
+          const uploadedFileUrl = await checkForFile();
+          clearTimeout(abortTimeout);
+          objectAsString = objectAsString.replaceAll(`"${url}"`, `"${uploadedFileUrl}"`);
+        } catch {
+          console.warn(`Failed to upload file ${url}`);
+        }
+      });
+    }
+    await fileUploadQueue.onIdle();
+  }
+  return JSON.parse(objectAsString);
+};
+var swapOutUniformFileUrlsForTargetProject = async (object, options) => {
+  let objectAsString = JSON.stringify(object);
+  const uniformFileUrlMatches = objectAsString.matchAll(
+    /"(https:\/\/(.*)?img\.uniform\.(rocks|global)\/(.*?))"/g
+  );
+  if (uniformFileUrlMatches) {
+    const fileUrlReplacementQueue = new PQueue({ concurrency: 3 });
+    for (const match of uniformFileUrlMatches) {
+      const url = match[1];
+      const hash = urlToHash(url);
+      fileUrlReplacementQueue.add(async () => {
+        try {
+          const fileAlreadyExistsChecks = await Promise.all([
+            options.fileClient.getFile({ projectId: options.projectId, url }).catch(() => null),
+            options.fileClient.getFile({ projectId: options.projectId, sourceId: hash }).catch(() => null)
+          ]);
+          const file = fileAlreadyExistsChecks.find((check) => check !== null);
+          if (!file) {
+            return;
+          }
+          objectAsString = objectAsString.replaceAll(`"${url}"`, `"${file.url}"`);
+        } catch {
+        }
+      });
+    }
+    await fileUrlReplacementQueue.onIdle();
+  }
+  return JSON.parse(objectAsString);
+};
+
+// src/commands/canvas/commands/composition/pull.ts
 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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          withDiffOptions(
+            yargs25.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 +1710,8 @@ var CompositionPullModule = {
     proxy,
     directory,
     format,
+    onlyCompositions,
+    onlyPatterns,
     mode,
     whatIf,
     state,
@@ -1359,8 +1719,8 @@ var CompositionPullModule = {
     diff: diffMode
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient14({ apiKey, apiHost, fetch: fetch3, projectId });
-    const source = createComponentInstanceEngineDataSource({ client, state });
+    const client = new UncachedCanvasClient10({ apiKey, apiHost, fetch: fetch3, projectId });
+    const source = createComponentInstanceEngineDataSource({ client, state, onlyCompositions, onlyPatterns });
     const isPackage = isPathAPackageFile(directory);
     let target;
     if (isPackage) {
@@ -1387,35 +1747,52 @@ var CompositionPullModule = {
       target,
       mode,
       whatIf,
-      log: createSyncEngineConsoleLogger({ diffMode })
+      log: createSyncEngineConsoleLogger({ diffMode }),
+      onBeforeWriteObject: async (sourceObject) => {
+        return extractAndDownloadUniformFilesForObject(sourceObject, {
+          directory
+        });
+      }
     });
   }
 };
 
 // src/commands/canvas/commands/composition/push.ts
-import { UncachedCanvasClient as UncachedCanvasClient15 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient11 } from "@uniformdev/canvas";
+import { FileClient as FileClient2 } from "@uniformdev/files";
 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"
-          })
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          withDiffOptions(
+            yargs25.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
+            })
+          )
         )
       )
     )
@@ -1429,10 +1806,12 @@ var CompositionPushModule = {
     whatIf,
     state,
     project: projectId,
+    onlyCompositions,
+    onlyPatterns,
     diff: diffMode
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient15({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient11({ apiKey, apiHost, fetch: fetch3, projectId });
     let source;
     const isPackage = isPathAPackageFile(directory);
     if (isPackage) {
@@ -1449,147 +1828,811 @@ var CompositionPushModule = {
         selectDisplayName: selectDisplayName3
       });
     }
-    const target = createComponentInstanceEngineDataSource({ client, state });
+    const target = createComponentInstanceEngineDataSource({ client, state, onlyCompositions, onlyPatterns });
+    const fileClient = new FileClient2({ apiKey, apiHost, fetch: fetch3, projectId });
     await syncEngine({
       source,
       target,
       mode,
       whatIf,
-      log: createSyncEngineConsoleLogger({ diffMode })
+      log: createSyncEngineConsoleLogger({ diffMode }),
+      onBeforeCompareObjects: async (sourceObject) => {
+        return swapOutUniformFileUrlsForTargetProject(sourceObject, {
+          fileClient,
+          projectId
+        });
+      },
+      onBeforeWriteObject: async (sourceObject) => {
+        return extractAndUploadUniformFilesForObject(sourceObject, {
+          directory,
+          fileClient,
+          projectId
+        });
+      }
     });
   }
 };
 
 // src/commands/canvas/commands/composition/remove.ts
-import { UncachedCanvasClient as UncachedCanvasClient16 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient12 } from "@uniformdev/canvas";
 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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("id", { demandOption: true, describe: "Composition/pattern public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient16({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new UncachedCanvasClient12({ apiKey, apiHost, fetch: fetch3, projectId });
     await client.removeComposition({ compositionId: id });
   }
 };
 
 // src/commands/canvas/commands/composition/unpublish.ts
-import { CANVAS_PUBLISHED_STATE as CANVAS_PUBLISHED_STATE2, UncachedCanvasClient as UncachedCanvasClient17 } from "@uniformdev/canvas";
+import { CANVAS_PUBLISHED_STATE as CANVAS_PUBLISHED_STATE2, UncachedCanvasClient as UncachedCanvasClient13 } from "@uniformdev/canvas";
+import { diffJson as diffJson2 } from "diff";
 var CompositionUnpublishModule = {
-  command: "unpublish <id>",
-  describe: "Unpublish a composition",
-  builder: (yargs21) => withApiOptions(
-    withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Composition public ID to unpublish" })
+  command: "unpublish [ids]",
+  describe: "Unpublish a composition(s)",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("ids", {
+          describe: "Un-publishes composition(s) by ID. Comma-separate multiple IDs. Use --all to un-publish all instead.",
+          type: "string"
+        }).option("all", {
+          alias: ["a"],
+          describe: "Un-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"
+        }).option("onlyCompositions", {
+          describe: "Only publishing 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, id, project: projectId }) => {
+  handler: async ({
+    apiHost,
+    apiKey,
+    proxy,
+    ids,
+    all,
+    onlyCompositions,
+    onlyPatterns,
+    project: projectId,
+    diff,
+    whatIf
+  }) => {
+    if (!all && !ids || all && ids) {
+      console.error(`Specify --all or composition ID(s) to publish.`);
+      process.exit(1);
+    }
+    const compositionIDsArray = ids ? ids.split(",").map((id) => id.trim()) : void 0;
+    const targetItems = /* @__PURE__ */ new Map();
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient17({ apiKey, apiHost, fetch: fetch3, projectId });
-    await client.removeComposition({ compositionId: id, state: CANVAS_PUBLISHED_STATE2 });
+    const client = new UncachedCanvasClient13({ apiKey, apiHost, fetch: fetch3, projectId });
+    const source = createComponentInstanceEngineDataSource({
+      client,
+      state: "published",
+      compositionIDs: compositionIDsArray,
+      onlyCompositions,
+      onlyPatterns
+    });
+    const target = createComponentInstanceEngineDataSource({
+      client,
+      state: "preview",
+      compositionIDs: compositionIDsArray,
+      onlyCompositions,
+      onlyPatterns
+    });
+    const actions = [];
+    const log = createSyncEngineConsoleLogger({ diffMode: diff });
+    for await (const obj of target.objects) {
+      if (Array.isArray(obj.id)) {
+        obj.id.forEach((o) => targetItems.set(o, obj));
+      } else {
+        targetItems.set(obj.id, obj);
+      }
+    }
+    for await (const sourceObject of source.objects) {
+      const id = Array.isArray(sourceObject.id) ? sourceObject.id[0] : sourceObject.id;
+      const targetObject = targetItems.get(id);
+      if (!targetObject) {
+        console.log(`Composition ${id} was not found`);
+        return;
+      }
+      actions.push(client.removeComposition({ compositionId: id, state: CANVAS_PUBLISHED_STATE2 }));
+      log({
+        action: "update",
+        id,
+        providerId: sourceObject.providerId,
+        displayName: sourceObject.displayName ?? sourceObject.providerId,
+        whatIf,
+        diff: diffJson2(targetObject.object, sourceObject.object)
+      });
+    }
   }
 };
 
 // src/commands/canvas/commands/composition/update.ts
-import { UncachedCanvasClient as UncachedCanvasClient18 } from "@uniformdev/canvas";
+import { UncachedCanvasClient as UncachedCanvasClient14 } from "@uniformdev/canvas";
 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" })
+  describe: "Insert or update a composition",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          yargs25.positional("filename", { demandOption: true, describe: "Composition/pattern file to put" })
+        )
+      )
+    )
+  ),
+  handler: async ({ apiHost, apiKey, proxy, filename, project: projectId, state }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new UncachedCanvasClient14({ apiKey, apiHost, fetch: fetch3, projectId });
+    const file = readFileToObject(filename);
+    await client.updateComposition({ ...file, state: convertCompositionState(state) });
+  }
+};
+
+// src/commands/canvas/commands/composition.ts
+var CompositionModule = {
+  command: "composition <command>",
+  describe: "Commands for Canvas compositions",
+  aliases: ["comp"],
+  builder: (yargs25) => yargs25.command(CompositionPullModule).command(CompositionPushModule).command(CompositionGetModule).command(CompositionRemoveModule).command(CompositionListModule).command(CompositionUpdateModule).command(CompositionPublishModule).command(CompositionUnpublishModule).demandCommand(),
+  handler: () => {
+    yargs3.help();
+  }
+};
+
+// src/commands/canvas/commands/contentType.ts
+import yargs4 from "yargs";
+
+// src/commands/canvas/commands/contentType/get.ts
+import { ContentClient } from "@uniformdev/canvas";
+var ContentTypeGetModule = {
+  command: "get <id>",
+  describe: "Get a content type",
+  builder: (yargs25) => withFormatOptions(
+    withApiOptions(
+      withProjectOptions(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        yargs25.positional("id", { demandOption: true, describe: "Content type public ID to fetch" })
+      )
+    )
+  ),
+  handler: async ({ apiHost, apiKey, proxy, id, format, filename, project: projectId }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new ContentClient({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    const res = await client.getContentTypes({ offset: 0, limit: 1e3 });
+    const found = res.contentTypes.find((f) => f.id === id);
+    if (!found) {
+      throw new Error(`Content type with ID ${id} not found`);
+    }
+    emitWithFormat(found, format, filename);
+  }
+};
+
+// src/commands/canvas/commands/contentType/list.ts
+import { ContentClient as ContentClient2 } from "@uniformdev/canvas";
+var ContentTypeListModule = {
+  command: "list",
+  describe: "List content types",
+  builder: (yargs25) => withFormatOptions(withApiOptions(withProjectOptions(yargs25))),
+  handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new ContentClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    const res = await client.getContentTypes({ offset: 0, limit: 1e3 });
+    emitWithFormat(res.contentTypes, format, filename);
+  }
+};
+
+// src/commands/canvas/commands/contentType/pull.ts
+import { ContentClient as ContentClient3 } from "@uniformdev/canvas";
+
+// src/commands/canvas/commands/contentType/_util.ts
+var selectContentTypeIdentifier = (ct) => ct.id;
+var selectContentTypeDisplayName = (ct) => `${ct.name} (pid: ${ct.id})`;
+
+// src/commands/canvas/contentTypeEngineDataSource.ts
+function createContentTypeEngineDataSource({
+  client
+}) {
+  async function* getObjects() {
+    const { contentTypes } = await client.getContentTypes({ offset: 0, limit: 1e3 });
+    for await (const ct of contentTypes) {
+      const result = {
+        id: selectContentTypeIdentifier(ct),
+        displayName: selectContentTypeDisplayName(ct),
+        providerId: ct.id,
+        object: ct
+      };
+      yield result;
+    }
+  }
+  return {
+    objects: getObjects(),
+    deleteObject: async (providerId) => {
+      await client.deleteContentType({ contentTypeId: providerId });
+    },
+    writeObject: async ({ object }) => {
+      await client.upsertContentType({ contentType: object });
+    }
+  };
+}
+
+// src/commands/canvas/commands/contentType/pull.ts
+var ContentTypePullModule = {
+  command: "pull <directory>",
+  describe: "Pulls all content types to local files in a directory",
+  builder: (yargs25) => withApiOptions(
+    withProjectOptions(
+      withDiffOptions(
+        yargs25.positional("directory", {
+          describe: "Directory to save the content 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"
+        })
+      )
+    )
+  ),
+  handler: async ({
+    apiHost,
+    apiKey,
+    proxy,
+    directory,
+    format,
+    mode,
+    whatIf,
+    project: projectId,
+    diff: diffMode
+  }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new ContentClient3({
+      apiKey,
+      apiHost,
+      fetch: fetch3,
+      projectId,
+      bypassCache: true
+    });
+    const source = createContentTypeEngineDataSource({ client });
+    let target;
+    const isPackage = isPathAPackageFile(directory);
+    if (isPackage) {
+      const packageContents = readCanvasPackage(directory, false);
+      target = await createArraySyncEngineDataSource({
+        objects: packageContents.contentTypes ?? [],
+        selectIdentifier: selectContentTypeIdentifier,
+        selectDisplayName: selectContentTypeDisplayName,
+        onSyncComplete: async (_, synced) => {
+          packageContents.contentTypes = synced;
+          writeCanvasPackage(directory, packageContents);
+        }
+      });
+    } else {
+      target = await createFileSyncEngineDataSource({
+        directory,
+        selectIdentifier: selectContentTypeIdentifier,
+        selectDisplayName: selectContentTypeDisplayName,
+        format
+      });
+    }
+    await syncEngine({
+      source,
+      target,
+      mode,
+      whatIf,
+      log: createSyncEngineConsoleLogger({ diffMode })
+    });
+  }
+};
+
+// src/commands/canvas/commands/contentType/push.ts
+import { ContentClient as ContentClient4 } from "@uniformdev/canvas";
+var ContentTypePushModule = {
+  command: "push <directory>",
+  describe: "Pushes all content types from files in a directory to Uniform",
+  builder: (yargs25) => withApiOptions(
+    withProjectOptions(
+      withDiffOptions(
+        yargs25.positional("directory", {
+          describe: "Directory to read the content 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"
+        })
+      )
+    )
+  ),
+  handler: async ({
+    apiHost,
+    apiKey,
+    proxy,
+    directory,
+    mode,
+    whatIf,
+    project: projectId,
+    diff: diffMode
+  }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new ContentClient4({
+      apiKey,
+      apiHost,
+      fetch: fetch3,
+      projectId,
+      bypassCache: true
+    });
+    let source;
+    const isPackage = isPathAPackageFile(directory);
+    if (isPackage) {
+      const packageContents = readCanvasPackage(directory, true);
+      source = await createArraySyncEngineDataSource({
+        objects: packageContents.contentTypes ?? [],
+        selectIdentifier: selectContentTypeIdentifier,
+        selectDisplayName: selectContentTypeDisplayName
+      });
+    } else {
+      source = await createFileSyncEngineDataSource({
+        directory,
+        selectIdentifier: selectContentTypeIdentifier,
+        selectDisplayName: selectContentTypeDisplayName
+      });
+    }
+    const target = createContentTypeEngineDataSource({ client });
+    await syncEngine({
+      source,
+      target,
+      mode,
+      whatIf,
+      log: createSyncEngineConsoleLogger({ diffMode })
+    });
+  }
+};
+
+// src/commands/canvas/commands/contentType/remove.ts
+import { ContentClient as ContentClient5 } from "@uniformdev/canvas";
+var ContentTypeRemoveModule = {
+  command: "remove <id>",
+  aliases: ["delete", "rm"],
+  describe: "Delete a content type",
+  builder: (yargs25) => withApiOptions(
+    withProjectOptions(
+      yargs25.positional("id", { demandOption: true, describe: "Content type public ID to delete" })
+    )
+  ),
+  handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new ContentClient5({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    await client.deleteContentType({ contentTypeId: id });
+  }
+};
+
+// src/commands/canvas/commands/contentType/update.ts
+import { ContentClient as ContentClient6 } from "@uniformdev/canvas";
+var ContentTypeUpdateModule = {
+  command: "update <filename>",
+  aliases: ["put"],
+  describe: "Insert or update a content type",
+  builder: (yargs25) => withApiOptions(
+    withProjectOptions(
+      yargs25.positional("filename", { demandOption: true, describe: "Content type file to put" })
+    )
+  ),
+  handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new ContentClient6({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    const file = readFileToObject(filename);
+    await client.upsertContentType({ contentType: file });
+  }
+};
+
+// src/commands/canvas/commands/contentType.ts
+var ContentTypeModule = {
+  command: "contenttype <command>",
+  aliases: ["ct"],
+  describe: "Commands for Content Types",
+  builder: (yargs25) => yargs25.command(ContentTypeGetModule).command(ContentTypeListModule).command(ContentTypeRemoveModule).command(ContentTypeUpdateModule).command(ContentTypePullModule).command(ContentTypePushModule).demandCommand(),
+  handler: () => {
+    yargs4.help();
+  }
+};
+
+// src/commands/canvas/commands/dataType.ts
+import yargs5 from "yargs";
+
+// src/commands/canvas/commands/dataType/get.ts
+import { DataTypeClient } from "@uniformdev/canvas";
+var DataTypeGetModule = {
+  command: "get <id>",
+  describe: "Get a data type",
+  aliases: ["ls"],
+  builder: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          yargs25.positional("id", { demandOption: true, describe: "Data type public ID to fetch" })
+        )
+      )
+    )
+  ),
+  handler: async ({ apiHost, apiKey, proxy, id, format, filename, project: projectId }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new DataTypeClient({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    const res = await client.get();
+    const found = res.results.find((f) => f.id === id);
+    if (!found) {
+      throw new Error(`Data type with ID ${id} not found`);
+    }
+    emitWithFormat(found, format, filename);
+  }
+};
+
+// src/commands/canvas/commands/dataType/list.ts
+import { DataTypeClient as DataTypeClient2 } from "@uniformdev/canvas";
+var DataTypeListModule = {
+  command: "list",
+  describe: "List data types",
+  aliases: ["ls"],
+  builder: (yargs25) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs25)))),
+  handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new DataTypeClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    const res = await client.get();
+    emitWithFormat(res.results, format, filename);
+  }
+};
+
+// src/commands/canvas/commands/dataType/pull.ts
+import { DataTypeClient as DataTypeClient3 } from "@uniformdev/canvas";
+
+// src/commands/canvas/commands/dataType/_util.ts
+var selectIdentifier4 = (dataType) => dataType.id;
+var selectDisplayName4 = (dataType) => `${dataType.displayName} (pid: ${dataType.id})`;
+
+// src/commands/canvas/dataTypeEngineDataSource.ts
+function createDataTypeEngineDataSource({
+  client
+}) {
+  async function* getObjects() {
+    const dataTypes = (await client.get()).results;
+    for await (const dataType of dataTypes) {
+      const result = {
+        id: selectIdentifier4(dataType),
+        displayName: selectDisplayName4(dataType),
+        providerId: dataType.id,
+        object: dataType
+      };
+      yield result;
+    }
+  }
+  return {
+    objects: getObjects(),
+    deleteObject: async (providerId) => {
+      await client.remove({ typeId: providerId });
+    },
+    writeObject: async (object) => {
+      await client.upsert({
+        data: object.object
+      });
+    }
+  };
+}
+
+// src/commands/canvas/commands/dataType/pull.ts
+var DataTypePullModule = {
+  command: "pull <directory>",
+  describe: "Pulls all data types to local files in a directory",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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"
+          })
+        )
+      )
+    )
+  ),
+  handler: async ({
+    apiHost,
+    apiKey,
+    proxy,
+    directory,
+    format,
+    mode,
+    whatIf,
+    project: projectId,
+    diff: diffMode
+  }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new DataTypeClient3({
+      apiKey,
+      apiHost,
+      fetch: fetch3,
+      projectId,
+      bypassCache: true
+    });
+    const source = createDataTypeEngineDataSource({ client });
+    let target;
+    const isPackage = isPathAPackageFile(directory);
+    if (isPackage) {
+      const packageContents = readCanvasPackage(directory, false);
+      target = await createArraySyncEngineDataSource({
+        objects: packageContents.dataTypes ?? [],
+        selectIdentifier: selectIdentifier4,
+        selectDisplayName: selectDisplayName4,
+        onSyncComplete: async (_, synced) => {
+          packageContents.dataTypes = synced;
+          writeCanvasPackage(directory, packageContents);
+        }
+      });
+    } else {
+      target = await createFileSyncEngineDataSource({
+        directory,
+        selectIdentifier: selectIdentifier4,
+        selectDisplayName: selectDisplayName4,
+        format
+      });
+    }
+    await syncEngine({
+      source,
+      target,
+      mode,
+      whatIf,
+      log: createSyncEngineConsoleLogger({ diffMode })
+    });
+  }
+};
+
+// src/commands/canvas/commands/dataType/push.ts
+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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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"
+          })
+        )
+      )
+    )
+  ),
+  handler: async ({
+    apiHost,
+    apiKey,
+    proxy,
+    directory,
+    mode,
+    whatIf,
+    project: projectId,
+    diff: diffMode
+  }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new DataTypeClient4({
+      apiKey,
+      apiHost,
+      fetch: fetch3,
+      projectId,
+      bypassCache: true
+    });
+    let source;
+    const isPackage = isPathAPackageFile(directory);
+    if (isPackage) {
+      const packageContents = readCanvasPackage(directory, true);
+      source = await createArraySyncEngineDataSource({
+        objects: packageContents.dataTypes ?? [],
+        selectIdentifier: selectIdentifier4,
+        selectDisplayName: selectDisplayName4
+      });
+    } else {
+      source = await createFileSyncEngineDataSource({
+        directory,
+        selectIdentifier: selectIdentifier4,
+        selectDisplayName: selectDisplayName4
+      });
+    }
+    const target = createDataTypeEngineDataSource({ client });
+    await syncEngine({
+      source,
+      target,
+      mode,
+      whatIf,
+      log: createSyncEngineConsoleLogger({ diffMode })
+    });
+  }
+};
+
+// src/commands/canvas/commands/dataType/remove.ts
+import { DataTypeClient as DataTypeClient5 } from "@uniformdev/canvas";
+var DataTypeRemoveModule = {
+  command: "remove <id>",
+  aliases: ["delete", "rm"],
+  describe: "Delete a data type",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("id", { demandOption: true, describe: "Data type public ID to delete" })
+      )
+    )
+  ),
+  handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new DataTypeClient5({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    await client.remove({ typeId: id });
+  }
+};
+
+// src/commands/canvas/commands/dataType/update.ts
+import { DataTypeClient as DataTypeClient6 } from "@uniformdev/canvas";
+var DataTypeUpdateModule = {
+  command: "update <filename>",
+  aliases: ["put"],
+  describe: "Insert or update a data type",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("filename", { demandOption: true, describe: "Data type file to put" })
       )
     )
   ),
-  handler: async ({ apiHost, apiKey, proxy, filename, project: projectId, state }) => {
+  handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new UncachedCanvasClient18({ apiKey, apiHost, fetch: fetch3, projectId });
+    const client = new DataTypeClient6({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
     const file = readFileToObject(filename);
-    await client.updateComposition({ ...file, state: convertCompositionState(state) });
+    await client.upsert({ data: file });
   }
 };
 
-// src/commands/canvas/commands/composition.ts
-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(),
+// src/commands/canvas/commands/dataType.ts
+var DataTypeModule = {
+  command: "datatype <command>",
+  aliases: ["dt"],
+  describe: "Commands for Data Type definitions",
+  builder: (yargs25) => yargs25.command(DataTypeGetModule).command(DataTypePullModule).command(DataTypePushModule).command(DataTypeRemoveModule).command(DataTypeListModule).command(DataTypeUpdateModule).demandCommand(),
   handler: () => {
-    yargs3.help();
+    yargs5.help();
   }
 };
 
-// src/commands/canvas/commands/dataType.ts
-import yargs4 from "yargs";
+// src/commands/canvas/commands/entry.ts
+import yargs6 from "yargs";
 
-// src/commands/canvas/commands/dataType/get.ts
-import { DataTypeClient } from "@uniformdev/canvas";
-var DataTypeGetModule = {
+// src/commands/canvas/commands/entry/get.ts
+import { ContentClient as ContentClient7 } from "@uniformdev/canvas";
+var EntryGetModule = {
   command: "get <id>",
-  describe: "Get a data type",
-  aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(
+  describe: "Get an entry",
+  builder: (yargs25) => withFormatOptions(
     withApiOptions(
       withProjectOptions(
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        yargs21.positional("id", { demandOption: true, describe: "Data type public ID to fetch" })
+        yargs25.positional("id", { demandOption: true, describe: "Entry public ID to fetch" })
       )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new DataTypeClient({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
-    const res = await client.get();
-    const found = res.results.find((f) => f.id === id);
-    if (!found) {
-      throw new Error(`Data type with ID ${id} not found`);
+    const client = new ContentClient7({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    const res = await client.getEntries({ offset: 0, limit: 1, entryIDs: [id] });
+    if (res.entries.length !== 1) {
+      throw new Error(`Entry with ID ${id} not found`);
     }
-    emitWithFormat(found, format, filename);
+    emitWithFormat(res.entries[0], format, filename);
   }
 };
 
-// src/commands/canvas/commands/dataType/list.ts
-import { DataTypeClient as DataTypeClient2 } from "@uniformdev/canvas";
-var DataTypeListModule = {
+// src/commands/canvas/commands/entry/list.ts
+import { ContentClient as ContentClient8 } from "@uniformdev/canvas";
+var EntryListModule = {
   command: "list",
-  describe: "List data types",
-  aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  describe: "List entries",
+  builder: (yargs25) => withFormatOptions(withApiOptions(withProjectOptions(yargs25))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new DataTypeClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
-    const res = await client.get();
-    emitWithFormat(res.results, format, filename);
+    const client = new ContentClient8({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    const res = await client.getEntries({ offset: 0, limit: 1e3 });
+    emitWithFormat(res.entries, format, filename);
   }
 };
 
-// src/commands/canvas/commands/dataType/pull.ts
-import { DataTypeClient as DataTypeClient3 } from "@uniformdev/canvas";
+// src/commands/canvas/commands/entry/pull.ts
+import { ContentClient as ContentClient9 } from "@uniformdev/canvas";
 
-// src/commands/canvas/commands/dataType/_util.ts
-var selectIdentifier4 = (dataType) => dataType.id;
-var selectDisplayName4 = (dataType) => `${dataType.displayName} (pid: ${dataType.id})`;
+// src/commands/canvas/commands/entry/_util.ts
+var selectEntryIdentifier = (e) => e.entry._id;
+var selectEntryDisplayName = (e) => `${e.entry._name ?? "Untitled"} (pid: ${e.entry._id})`;
 
-// src/commands/canvas/dataTypeEngineDataSource.ts
-function createDataTypeEngineDataSource({
+// src/commands/canvas/entryEngineDataSource.ts
+function createEntryEngineDataSource({
   client
 }) {
   async function* getObjects() {
-    const dataTypes = (await client.get()).results;
-    for await (const dataType of dataTypes) {
+    const { entries } = await client.getEntries({ offset: 0, limit: 1e3 });
+    for await (const e of entries) {
       const result = {
-        id: selectIdentifier4(dataType),
-        displayName: selectDisplayName4(dataType),
-        providerId: dataType.id,
-        object: dataType
+        id: selectEntryIdentifier(e),
+        displayName: selectEntryDisplayName(e),
+        providerId: e.entry._id,
+        object: e
       };
       yield result;
     }
@@ -1597,25 +2640,23 @@ function createDataTypeEngineDataSource({
   return {
     objects: getObjects(),
     deleteObject: async (providerId) => {
-      await client.remove({ typeId: providerId });
+      await client.deleteEntry({ entryId: providerId });
     },
-    writeObject: async (object) => {
-      await client.upsert({
-        data: object.object
-      });
+    writeObject: async ({ object }) => {
+      await client.upsertEntry(object);
     }
   };
 }
 
-// src/commands/canvas/commands/dataType/pull.ts
-var DataTypePullModule = {
+// src/commands/canvas/commands/entry/pull.ts
+var EntryPullModule = {
   command: "pull <directory>",
-  describe: "Pulls all data types to local files in a directory",
-  builder: (yargs21) => withApiOptions(
+  describe: "Pulls all entries to local files in a directory",
+  builder: (yargs25) => 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.",
+        yargs25.positional("directory", {
+          describe: "Directory to save the entries 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"],
@@ -1650,32 +2691,32 @@ var DataTypePullModule = {
     diff: diffMode
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new DataTypeClient3({
+    const client = new ContentClient9({
       apiKey,
       apiHost,
       fetch: fetch3,
       projectId,
       bypassCache: true
     });
-    const source = createDataTypeEngineDataSource({ client });
+    const source = createEntryEngineDataSource({ client });
     let target;
     const isPackage = isPathAPackageFile(directory);
     if (isPackage) {
       const packageContents = readCanvasPackage(directory, false);
       target = await createArraySyncEngineDataSource({
-        objects: packageContents.dataTypes ?? [],
-        selectIdentifier: selectIdentifier4,
-        selectDisplayName: selectDisplayName4,
+        objects: packageContents.entries ?? [],
+        selectIdentifier: selectEntryIdentifier,
+        selectDisplayName: selectEntryDisplayName,
         onSyncComplete: async (_, synced) => {
-          packageContents.dataTypes = synced;
+          packageContents.entries = synced;
           writeCanvasPackage(directory, packageContents);
         }
       });
     } else {
       target = await createFileSyncEngineDataSource({
         directory,
-        selectIdentifier: selectIdentifier4,
-        selectDisplayName: selectDisplayName4,
+        selectIdentifier: selectEntryIdentifier,
+        selectDisplayName: selectEntryDisplayName,
         format
       });
     }
@@ -1689,16 +2730,16 @@ var DataTypePullModule = {
   }
 };
 
-// src/commands/canvas/commands/dataType/push.ts
-import { DataTypeClient as DataTypeClient4 } from "@uniformdev/canvas";
-var DataTypePushModule = {
+// src/commands/canvas/commands/entry/push.ts
+import { ContentClient as ContentClient10 } from "@uniformdev/canvas";
+var EntryPushModule = {
   command: "push <directory>",
-  describe: "Pushes all data types from files in a directory to Uniform",
-  builder: (yargs21) => withApiOptions(
+  describe: "Pushes all entries from files in a directory to Uniform",
+  builder: (yargs25) => 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.",
+        yargs25.positional("directory", {
+          describe: "Directory to read the entries from. If a filename is used, a package will be read instead.",
           type: "string"
         }).option("what-if", {
           alias: ["w"],
@@ -1726,7 +2767,7 @@ var DataTypePushModule = {
     diff: diffMode
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new DataTypeClient4({
+    const client = new ContentClient10({
       apiKey,
       apiHost,
       fetch: fetch3,
@@ -1738,18 +2779,18 @@ var DataTypePushModule = {
     if (isPackage) {
       const packageContents = readCanvasPackage(directory, true);
       source = await createArraySyncEngineDataSource({
-        objects: packageContents.dataTypes ?? [],
-        selectIdentifier: selectIdentifier4,
-        selectDisplayName: selectDisplayName4
+        objects: packageContents.entries ?? [],
+        selectIdentifier: selectEntryIdentifier,
+        selectDisplayName: selectEntryDisplayName
       });
     } else {
       source = await createFileSyncEngineDataSource({
         directory,
-        selectIdentifier: selectIdentifier4,
-        selectDisplayName: selectDisplayName4
+        selectIdentifier: selectEntryIdentifier,
+        selectDisplayName: selectEntryDisplayName
       });
     }
-    const target = createDataTypeEngineDataSource({ client });
+    const target = createEntryEngineDataSource({ client });
     await syncEngine({
       source,
       target,
@@ -1760,51 +2801,280 @@ var DataTypePushModule = {
   }
 };
 
-// src/commands/canvas/commands/dataType/remove.ts
-import { DataTypeClient as DataTypeClient5 } from "@uniformdev/canvas";
-var DataTypeRemoveModule = {
+// src/commands/canvas/commands/entry/remove.ts
+import { ContentClient as ContentClient11 } from "@uniformdev/canvas";
+var EntryRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
-  describe: "Delete a data type",
-  builder: (yargs21) => withApiOptions(
+  describe: "Delete an entry",
+  builder: (yargs25) => withApiOptions(
     withProjectOptions(
-      yargs21.positional("id", { demandOption: true, describe: "Data type public ID to delete" })
+      yargs25.positional("id", { demandOption: true, describe: "Entry public ID to delete" })
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new DataTypeClient5({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
-    await client.remove({ typeId: id });
+    const client = new ContentClient11({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    await client.deleteEntry({ entryId: id });
   }
 };
 
-// src/commands/canvas/commands/dataType/update.ts
-import { DataTypeClient as DataTypeClient6 } from "@uniformdev/canvas";
-var DataTypeUpdateModule = {
+// src/commands/canvas/commands/entry/update.ts
+import { ContentClient as ContentClient12 } from "@uniformdev/canvas";
+var EntryUpdateModule = {
   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" })
-    )
+  describe: "Insert or update an entry",
+  builder: (yargs25) => withApiOptions(
+    withProjectOptions(yargs25.positional("filename", { demandOption: true, describe: "Entry file to put" }))
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
-    const client = new DataTypeClient6({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
+    const client = new ContentClient12({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
     const file = readFileToObject(filename);
-    await client.upsert({ data: file });
+    await client.upsertEntry(file);
   }
 };
 
-// src/commands/canvas/commands/dataType.ts
-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(),
+// src/commands/canvas/commands/entry.ts
+var EntryModule = {
+  command: "entry <command>",
+  describe: "Commands for Entries",
+  builder: (yargs25) => yargs25.command(EntryGetModule).command(EntryListModule).command(EntryRemoveModule).command(EntryUpdateModule).command(EntryPullModule).command(EntryPushModule).demandCommand(),
   handler: () => {
-    yargs4.help();
+    yargs6.help();
+  }
+};
+
+// src/commands/canvas/commands/pattern.ts
+import yargs7 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: (yargs25) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          withStateOptions(
+            yargs25.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 pattern(s)",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.positional("ids", {
+            describe: "Publishes pattern(s) by ID. Comma-separate multiple IDs. Use --all to publish all instead.",
+            type: "string"
+          }).option("all", {
+            alias: ["a"],
+            describe: "Publishes all patterns. 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 un-publishing",
+            default: false,
+            type: "boolean"
+          }).option("publishingState", {
+            describe: 'Publishing state to update to. Can be "published" or "preview".',
+            default: "published",
+            type: "string",
+            hidden: true
+          }).option("onlyCompositions", {
+            describe: "Only publishing compositions and not patterns",
+            default: false,
+            type: "boolean"
+          }).option("onlyPatterns", {
+            describe: "Only pulling patterns and not compositions",
+            default: true,
+            type: "boolean",
+            hidden: true
+          })
+        )
+      )
+    )
+  )
+};
+
+// src/commands/canvas/commands/pattern/pull.ts
+var PatternPullModule = {
+  ...CompositionPullModule,
+  describe: "Pulls all patterns to local files in a directory",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          withDiffOptions(
+            yargs25.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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withStateOptions(
+          withDiffOptions(
+            yargs25.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 = {
+  command: "unpublish [ids]",
+  describe: "Unpublish a pattern(s)",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("ids", {
+          describe: "Un-publishes composition(s) by ID. Comma-separate multiple IDs. Use --all to un-publish all instead.",
+          type: "string"
+        }).option("all", {
+          alias: ["a"],
+          describe: "Un-pPublishes 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"
+        }).option("onlyCompositions", {
+          describe: "Only publishing compositions and not patterns",
+          default: false,
+          type: "boolean"
+        }).option("onlyPatterns", {
+          describe: "Only pulling patterns and not compositions",
+          default: true,
+          type: "boolean",
+          hidden: true
+        })
+      )
+    )
+  ),
+  handler: CompositionUnpublishModule.handler
+};
+
+// 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: (yargs25) => yargs25.command(PatternPullModule).command(PatternPushModule).command(PatternGetModule).command(PatternRemoveModule).command(PatternListModule).command(PatternUpdateModule).command(PatternPublishModule).command(PatternUnpublishModule).demandCommand(),
+  handler: () => {
+    yargs7.help();
   }
 };
 
@@ -1813,27 +3083,29 @@ 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: (yargs25) => yargs25.command(CompositionModule).command(ComponentModule).command(DataTypeModule).command(CategoryModule).command(PatternModule).command(ContentTypeModule).command(EntryModule).demandCommand(),
   handler: () => {
-    yargs5.showHelp();
+    yargs8.showHelp();
   }
 };
 
 // src/commands/context/index.ts
-import yargs12 from "yargs";
+import yargs15 from "yargs";
 
 // src/commands/context/commands/aggregate.ts
-import yargs6 from "yargs";
+import yargs9 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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", { demandOption: true, describe: "Aggregate public ID to fetch" })
+        )
       )
     )
   ),
@@ -1856,7 +3128,7 @@ var AggregateListModule = {
   command: "list",
   describe: "List aggregates",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs25) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs25)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAggregateClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -1922,30 +3194,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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"
+          })
+        )
       )
     )
   ),
@@ -1997,26 +3271,28 @@ var AggregatePullModule = {
 // src/commands/context/commands/aggregate/push.ts
 import { UncachedAggregateClient as UncachedAggregateClient4 } from "@uniformdev/context/api";
 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"
-        })
+  command: "push <directory>",
+  describe: "Pushes all aggregates from files in a directory or package to Uniform",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +3342,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("id", { demandOption: true, describe: "Aggregate public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -2084,9 +3362,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("filename", { demandOption: true, describe: "Aggregate file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -2102,24 +3382,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: (yargs25) => yargs25.command(AggregatePullModule).command(AggregatePushModule).command(AggregateGetModule).command(AggregateRemoveModule).command(AggregateListModule).command(AggregateUpdateModule).demandCommand(),
   handler: () => {
-    yargs6.help();
+    yargs9.help();
   }
 };
 
 // src/commands/context/commands/enrichment.ts
-import yargs7 from "yargs";
+import yargs10 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: (yargs25) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", { demandOption: true, describe: "Enrichment category public ID to fetch" })
+        )
       )
     )
   ),
@@ -2143,7 +3425,7 @@ var EnrichmentListModule = {
   command: "list",
   describe: "List enrichments",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs25) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs25)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedEnrichmentClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -2244,30 +3526,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +3605,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +3673,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("id", { demandOption: true, describe: "Enrichment category public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -2404,14 +3692,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: (yargs25) => yargs25.command(EnrichmentPullModule).command(EnrichmentPushModule).command(EnrichmentGetModule).command(EnrichmentRemoveModule).command(EnrichmentListModule).demandCommand(),
   handler: () => {
-    yargs7.help();
+    yargs10.help();
   }
 };
 
 // src/commands/context/commands/manifest.ts
-import yargs8 from "yargs";
+import yargs11 from "yargs";
 
 // src/commands/context/commands/manifest/get.ts
 import { ApiClientError, UncachedManifestClient } from "@uniformdev/context/api";
@@ -2422,20 +3710,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.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 +3775,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: (yargs25) => withConfiguration(withApiOptions(withProjectOptions(yargs25))),
   handler: async ({ apiKey, apiHost, proxy, project }) => {
     const fetch3 = nodeFetchProxy(proxy);
     try {
@@ -2518,24 +3808,26 @@ var ManifestModule = {
   command: "manifest <command>",
   describe: "Commands for context manifests",
   aliases: ["man"],
-  builder: (yargs21) => yargs21.command(ManifestGetModule).command(ManifestPublishModule).demandCommand(),
+  builder: (yargs25) => yargs25.command(ManifestGetModule).command(ManifestPublishModule).demandCommand(),
   handler: () => {
-    yargs8.help();
+    yargs11.help();
   }
 };
 
 // src/commands/context/commands/quirk.ts
-import yargs9 from "yargs";
+import yargs12 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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", { demandOption: true, describe: "Quirk public ID to fetch" })
+        )
       )
     )
   ),
@@ -2558,14 +3850,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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.option("withIntegrations", {
+            alias: ["i"],
+            describe: "Whether to include meta-quirks created by integrations in the list. Defaults to false.",
+            type: "boolean"
+          })
+        )
       )
     )
   ),
@@ -2617,30 +3911,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +3990,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +4058,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("id", { demandOption: true, describe: "Quirk public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -2778,8 +4078,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("filename", { demandOption: true, describe: "Quirk file to put" })
+      )
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -2794,24 +4098,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: (yargs25) => yargs25.command(QuirkPullModule).command(QuirkPushModule).command(QuirkGetModule).command(QuirkRemoveModule).command(QuirkListModule).command(QuirkUpdateModule).demandCommand(),
   handler: () => {
-    yargs9.help();
+    yargs12.help();
   }
 };
 
 // src/commands/context/commands/signal.ts
-import yargs10 from "yargs";
+import yargs13 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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", { demandOption: true, describe: "Signal public ID to fetch" })
+        )
       )
     )
   ),
@@ -2834,7 +4140,7 @@ var SignalListModule = {
   command: "list",
   describe: "List signals",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs25) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs25)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedSignalClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -2876,37 +4182,39 @@ function createSignalEngineDataSource({
         signal: object.object
       });
     }
-  };
-}
-
-// src/commands/context/commands/signal/pull.ts
-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"
-        })
+  };
+}
+
+// src/commands/context/commands/signal/pull.ts
+var SignalPullModule = {
+  command: "pull <directory>",
+  describe: "Pulls all signals to local files in a directory",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +4268,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +4336,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("id", { demandOption: true, describe: "Signal public ID to delete" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -3044,8 +4356,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("filename", { demandOption: true, describe: "Signal file to put" })
+      )
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -3060,24 +4376,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: (yargs25) => yargs25.command(SignalPullModule).command(SignalPushModule).command(SignalGetModule).command(SignalRemoveModule).command(SignalListModule).command(SignalUpdateModule).demandCommand(),
   handler: () => {
-    yargs10.help();
+    yargs13.help();
   }
 };
 
 // src/commands/context/commands/test.ts
-import yargs11 from "yargs";
+import yargs14 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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", { demandOption: true, describe: "Test public ID to fetch" })
+        )
       )
     )
   ),
@@ -3100,7 +4418,7 @@ var TestListModule = {
   command: "list",
   describe: "List tests",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs25) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs25)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedTestClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -3149,30 +4467,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +4546,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +4614,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("id", { demandOption: true, describe: "Test public ID to delete" })
+      )
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -3308,8 +4634,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(yargs25.positional("filename", { demandOption: true, describe: "Test file to put" }))
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -3323,9 +4651,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: (yargs25) => yargs25.command(TestPullModule).command(TestPushModule).command(TestGetModule).command(TestRemoveModule).command(TestListModule).command(TestUpdateModule).demandCommand(),
   handler: () => {
-    yargs11.help();
+    yargs14.help();
   }
 };
 
@@ -3334,9 +4662,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: (yargs25) => yargs25.command(ManifestModule).command(SignalModule).command(EnrichmentModule).command(AggregateModule).command(QuirkModule).command(TestModule).demandCommand(),
   handler: () => {
-    yargs12.showHelp();
+    yargs15.showHelp();
   }
 };
 
@@ -3364,15 +4692,15 @@ import { PostHog } from "posthog-node";
 // package.json
 var package_default = {
   name: "@uniformdev/cli",
-  version: "19.38.2",
+  version: "19.46.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",
-    build: "tsup",
+    build: "tsc --noEmit && tsup",
     dev: "tsup --watch",
     clean: "rimraf dist",
     test: "jest --maxWorkers=1 --passWithNoTests",
@@ -3380,20 +4708,24 @@ var package_default = {
     format: 'prettier --write "src/**/*.{js,ts,tsx}"'
   },
   dependencies: {
+    "@thi.ng/mime": "^2.2.23",
     "@uniformdev/canvas": "workspace:*",
     "@uniformdev/context": "workspace:*",
+    "@uniformdev/files": "workspace:*",
     "@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",
     "fs-jetpack": "5.1.0",
-    graphql: "16.6.0",
+    graphql: "16.8.0",
     "graphql-request": "6.1.0",
     "https-proxy-agent": "^7.0.0",
-    inquirer: "9.2.8",
+    "image-size": "^1.0.2",
+    inquirer: "9.2.10",
     "isomorphic-git": "1.24.5",
     "isomorphic-unfetch": "^3.1.0",
     "js-yaml": "^4.1.0",
@@ -3401,6 +4733,7 @@ var package_default = {
     "lodash.isequalwith": "^4.4.0",
     open: "9.1.0",
     ora: "6.3.1",
+    "p-queue": "7.3.4",
     "posthog-node": "3.1.1",
     slugify: "1.6.6",
     "update-check": "^1.5.4",
@@ -3413,7 +4746,7 @@ var package_default = {
     "@types/js-yaml": "4.0.5",
     "@types/jsonwebtoken": "9.0.2",
     "@types/lodash.isequalwith": "4.4.7",
-    "@types/node": "18.17.1",
+    "@types/node": "18.17.5",
     "@types/yargs": "17.0.24"
   },
   bin: {
@@ -3737,8 +5070,8 @@ ${err.message}`);
 
 // src/projects/cloneStarter.ts
 import crypto2 from "crypto";
-import fs2 from "fs";
-import fsj from "fs-jetpack";
+import fs3 from "fs";
+import fsj2 from "fs-jetpack";
 import * as git from "isomorphic-git";
 import * as http from "isomorphic-git/http/node/index.js";
 import os from "os";
@@ -3754,7 +5087,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 +5098,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 });
+  fsj2.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 +5120,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 +5247,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 +5657,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 +5697,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 +5734,10 @@ var NewMeshCmd = {
 };
 
 // src/commands/optimize/index.ts
-import yargs14 from "yargs";
+import yargs17 from "yargs";
 
 // src/commands/optimize/manifest.ts
-import yargs13 from "yargs";
+import yargs16 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 +5752,7 @@ var UniformBaseUrl = "https://uniform.app";
 var module = {
   command: "download [output]",
   describe: "Download intent manifest",
-  builder: (yargs21) => yargs21.option("apiKey", {
+  builder: (yargs25) => yargs25.option("apiKey", {
     alias: "k",
     demandOption: true,
     string: true,
@@ -4516,10 +5853,10 @@ var module2 = {
   command: "manifest <command>",
   describe: "Intent manifest commands",
   builder: () => {
-    return yargs13.command(download_default);
+    return yargs16.command(download_default);
   },
   handler: () => {
-    yargs13.showHelp();
+    yargs16.showHelp();
   }
 };
 var manifest_default = module2;
@@ -4530,28 +5867,30 @@ var OptimizeCommand = {
   aliases: ["opt"],
   describe: "Uniform Optimize commands",
   builder: () => {
-    return yargs14.command(manifest_default);
+    return yargs17.command(manifest_default);
   },
   handler: () => {
-    yargs14.showHelp();
+    yargs17.showHelp();
   }
 };
 
 // src/commands/project-map/index.ts
-import yargs17 from "yargs";
+import yargs20 from "yargs";
 
 // src/commands/project-map/commands/projectMapDefinition.ts
-import yargs15 from "yargs";
+import yargs18 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: (yargs25) => withFormatOptions(
+    withConfiguration(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", { demandOption: true, describe: "ProjectMap UUID to fetch" })
+        )
       )
     )
   ),
@@ -4574,7 +5913,7 @@ var ProjectMapDefinitionListModule = {
   command: "list",
   describe: "List of project maps",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs25) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs25)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedProjectMapClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4631,30 +5970,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +6049,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +6117,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(yargs25.positional("id", { demandOption: true, describe: " UUID to delete" }))
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -4790,9 +6135,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("filename", { demandOption: true, describe: "Project map file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -4807,24 +6154,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: (yargs25) => yargs25.command(ProjectMapDefinitionPullModule).command(ProjectMapDefinitionPushModule).command(ProjectMapDefinitionGetModule).command(ProjectMapDefinitionRemoveModule).command(ProjectMapDefinitionListModule).command(ProjectMapDefinitionUpdateModule).demandCommand(),
   handler: () => {
-    yargs15.help();
+    yargs18.help();
   }
 };
 
 // src/commands/project-map/commands/projectMapNode.ts
-import yargs16 from "yargs";
+import yargs19 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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to fetch" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to fetch from" })
+        )
       )
     )
   ),
@@ -4849,10 +6198,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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("projectMapId", {
+            demandOption: true,
+            describe: "ProjectMap UUID to fetch from"
+          })
+        )
       )
     )
   ),
@@ -4919,30 +6273,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +6356,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +6433,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.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 +6453,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.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 +6472,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: (yargs25) => yargs25.command(ProjectMapNodePullModule).command(ProjectMapNodePushModule).command(ProjectMapNodeGetModule).command(ProjectMapNodeRemoveModule).command(ProjectMapNodeListModule).command(ProjectMapNodeUpdateModule).demandCommand(),
   handler: () => {
-    yargs16.help();
+    yargs19.help();
   }
 };
 
@@ -5121,26 +6483,30 @@ var ProjectMapCommand = {
   command: "project-map <command>",
   aliases: ["prm"],
   describe: "Uniform ProjectMap commands",
-  builder: (yargs21) => yargs21.command(ProjectMapNodeModule).command(ProjectMapDefinitionModule).demandCommand(),
+  builder: (yargs25) => yargs25.command(ProjectMapNodeModule).command(ProjectMapDefinitionModule).demandCommand(),
   handler: () => {
-    yargs17.showHelp();
+    yargs20.showHelp();
   }
 };
 
 // src/commands/redirect/index.ts
-import yargs19 from "yargs";
+import yargs22 from "yargs";
 
 // src/commands/redirect/commands/redirect.ts
-import yargs18 from "yargs";
+import yargs21 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: (yargs25) => withConfiguration(
+    withFormatOptions(
+      withApiOptions(
+        withProjectOptions(
+          yargs25.positional("id", { demandOption: true, describe: "Redirect UUID to fetch" })
+        )
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, format, project: projectId, filename }) => {
@@ -5162,7 +6528,7 @@ var RedirectDefinitionListModule = {
   command: "list",
   describe: "List of redirects",
   aliases: ["ls"],
-  builder: (yargs21) => withFormatOptions(withApiOptions(withProjectOptions(yargs21))),
+  builder: (yargs25) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs25)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedRedirectClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -5228,30 +6594,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +6674,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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 +6742,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(yargs25.positional("id", { demandOption: true, describe: " UUID to delete" }))
+    )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
@@ -5388,9 +6760,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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        yargs25.positional("filename", { demandOption: true, describe: "Redirect file to put" })
+      )
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -5405,9 +6779,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: (yargs25) => yargs25.command(RedirectDefinitionPullModule).command(RedirectDefinitionPushModule).command(RedirectDefinitionGetModule).command(RedirectDefinitionRemoveModule).command(RedirectDefinitionListModule).command(RedirectDefinitionUpdateModule).demandCommand(),
   handler: () => {
-    yargs18.help();
+    yargs21.help();
   }
 };
 
@@ -5416,9 +6790,179 @@ var RedirectCommand = {
   command: "redirect <command>",
   aliases: ["red"],
   describe: "Uniform Redirect commands",
-  builder: (yargs21) => yargs21.command(RedirectDefinitionModule).demandCommand(),
+  builder: (yargs25) => yargs25.command(RedirectDefinitionModule).demandCommand(),
+  handler: () => {
+    yargs22.showHelp();
+  }
+};
+
+// src/commands/sync/index.ts
+import yargs23 from "yargs";
+
+// src/commands/sync/commands/pull.ts
+var SyncPullModule = {
+  command: "pull",
+  describe: "Pulls whole project to local files in a directory",
+  builder: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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: (yargs25) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs25.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: (yargs25) => yargs25.command(SyncPullModule).command(SyncPushModule).demandCommand(),
   handler: () => {
-    yargs19.showHelp();
+    yargs23.showHelp();
   }
 };
 
@@ -5462,17 +7006,17 @@ async function checkForUpdateMiddleware() {
 
 // src/middleware/checkLocalDepsVersionsMiddleware.ts
 import { magenta, red as red6 } from "colorette";
-import { join as join2 } from "path";
+import { join as join3 } 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;
@@ -5501,7 +7045,7 @@ var checkLocalDepsVersions = async (args) => {
   try {
     let isOutside = false;
     let warning = `${magenta("Warning:")} Installed Uniform packages should be the same version`;
-    const localPackages = await tryReadJSON(join2(process.cwd(), "package.json"));
+    const localPackages = await tryReadJSON(join3(process.cwd(), "package.json"));
     if (!localPackages)
       return;
     let firstVersion;
@@ -5534,9 +7078,13 @@ First found was: v${firstVersion}`;
 
 // src/index.ts
 dotenv.config();
-var yarggery = yargs20(hideBin(process.argv));
+var yarggery = yargs24(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;