@uniformdev/cli 19.79.0 → 19.79.1-alpha.7

package/dist/index.mjs

@@ -7,7 +7,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
-// ../../node_modules/.pnpm/tsup@7.2.0_postcss@8.4.31_ts-node@10.9.1_typescript@5.2.2/node_modules/tsup/assets/esm_shims.js
+// ../../node_modules/.pnpm/tsup@8.0.1_@microsoft+api-extractor@7.38.3_postcss@8.4.32_typescript@5.3.2/node_modules/tsup/assets/esm_shims.js
 import { fileURLToPath } from "url";
 import path from "path";
 var getFilename = () => fileURLToPath(import.meta.url);
@@ -16,11 +16,11 @@ var __dirname = /* @__PURE__ */ getDirname();
 
 // src/index.ts
 import * as dotenv from "dotenv";
-import yargs26 from "yargs";
+import yargs27 from "yargs";
 import { hideBin } from "yargs/helpers";
 
 // src/commands/canvas/index.ts
-import yargs10 from "yargs";
+import yargs11 from "yargs";
 
 // src/commands/canvas/commands/asset.ts
 import yargs from "yargs";
@@ -137,14 +137,14 @@ import httpsProxyAgent from "https-proxy-agent";
 import unfetch from "isomorphic-unfetch";
 import { dump, load } from "js-yaml";
 import { dirname, extname, isAbsolute, resolve, sep } from "path";
-function withConfiguration(yargs27) {
-  return yargs27.option("serialization", {
+function withConfiguration(yargs28) {
+  return yargs28.option("serialization", {
     skipValidation: true,
     hidden: true
   });
 }
-function withApiOptions(yargs27) {
-  return yargs27.option("apiKey", {
+function withApiOptions(yargs28) {
+  return yargs28.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
@@ -183,8 +183,8 @@ function nodeFetchProxy(proxy) {
   };
   return wrappedFetch;
 }
-function withProjectOptions(yargs27) {
-  return yargs27.option("project", {
+function withProjectOptions(yargs28) {
+  return yargs28.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
@@ -194,8 +194,8 @@ function withProjectOptions(yargs27) {
     alias: ["p"]
   });
 }
-function withFormatOptions(yargs27) {
-  return yargs27.option("format", {
+function withFormatOptions(yargs28) {
+  return yargs28.option("format", {
     alias: ["f"],
     describe: "Output format",
     default: "yaml",
@@ -207,8 +207,8 @@ function withFormatOptions(yargs27) {
     type: "string"
   });
 }
-function withDiffOptions(yargs27) {
-  return yargs27.option("diff", {
+function withDiffOptions(yargs28) {
+  return yargs28.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",
@@ -295,6 +295,7 @@ async function* paginateAsync(fetchPage, options) {
 var defaultSyncConfiguration = {
   entitiesConfig: {},
   directory: "uniform-data",
+  allowEmptySource: false,
   format: "yaml",
   mode: "mirror"
 };
@@ -632,12 +633,12 @@ function createPublishStatusSyncEngineConsoleLogger(options) {
 var AssetGetModule = {
   command: "get <id>",
   describe: "Get an asset",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Asset ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Asset ID to fetch" })
         )
       )
     )
@@ -658,7 +659,7 @@ import { UncachedAssetClient as UncachedAssetClient2 } from "@uniformdev/assets"
 var AssetListModule = {
   command: "list",
   describe: "List assets",
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAssetClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -669,6 +670,7 @@ var AssetListModule = {
 
 // src/commands/canvas/commands/asset/pull.ts
 import { UncachedAssetClient as UncachedAssetClient3 } from "@uniformdev/assets";
+import { UncachedFileClient } from "@uniformdev/files";
 
 // src/files/index.ts
 import { preferredType } from "@thi.ng/mime";
@@ -679,20 +681,62 @@ import sizeOf from "image-size";
 import PQueue from "p-queue";
 import { dirname as dirname2, join as join2 } from "path";
 var FILES_DIRECTORY_NAME = "files";
+var escapeRegExp = (string) => {
+  return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+};
 var urlToHash = (url) => {
-  const hash = createHash("sha256");
-  hash.update(url);
-  return hash.digest("hex");
+  return Buffer.from(
+    // We take only the first 64 characters of the pathname as
+    // that's enough to guarantee uniqueness
+    new URL(url).pathname.substring(0, 64)
+  ).toString("base64");
+};
+var hashToPartialPathname = (hash) => {
+  try {
+    return Buffer.from(hash, "base64").toString("utf8");
+  } catch {
+    return null;
+  }
+};
+var findUrlMatchingPartialPathname = (source, pathname) => {
+  const escapedPathname = escapeRegExp(pathname);
+  const regex = new RegExp(`"(https://([^"]*?)?img.uniform.(rocks|global)${escapedPathname}([^"]*?))"`);
+  const match = source.match(regex);
+  if (match && match[1]) {
+    return match[1];
+  }
+  return null;
 };
-var urlToFileName = (url) => {
-  const fileName = urlToHash(url);
-  const fileNameChunks = url.split(".");
-  const fileExtension = fileNameChunks.length > 1 ? fileNameChunks.at(-1) : "";
+var urlToFileExtension = (url) => {
+  try {
+    const urlObject = new URL(url);
+    const fileNameChunks = urlObject.pathname.split(".");
+    return fileNameChunks.length > 1 ? fileNameChunks.at(-1) ?? null : null;
+  } catch {
+    return null;
+  }
+};
+var urlToFileName = (url, hash) => {
+  const fileName = hash ?? urlToHash(url);
+  const fileExtension = urlToFileExtension(url);
   return `${fileName}${fileExtension ? `.${fileExtension}` : ""}`;
 };
+var getFilesDirectory = (directory) => {
+  const isPackage = isPathAPackageFile(directory);
+  return isPackage ? dirname2(directory) : (
+    // If we are syncing to a directory, we want to write all files into a
+    // top-lvl folder. That way any entities that contain files will sync to the
+    // same directory, so there is no duplication
+    join2(directory, "..")
+  );
+};
+var getUniformFileUrlMatches = (string) => {
+  return string.matchAll(/"(https:\/\/([^"]*?)?img\.uniform\.(rocks|global)\/([^"]*?))"/g);
+};
 var deleteDownloadedFileByUrl = async (url, options) => {
+  const writeDirectory = getFilesDirectory(options.directory);
   const fileName = urlToFileName(url);
-  const fileToDelete = join2(options.directory, FILES_DIRECTORY_NAME, fileName);
+  const fileToDelete = join2(writeDirectory, FILES_DIRECTORY_NAME, fileName);
   try {
     await fsj.removeAsync(fileToDelete);
   } catch {
@@ -701,30 +745,43 @@ var deleteDownloadedFileByUrl = async (url, options) => {
 };
 var extractAndDownloadUniformFilesForObject = async (object, options) => {
   const objectAsString = JSON.stringify(object);
-  const uniformFileUrlMatches = objectAsString.matchAll(
-    /"(https:\/\/(.*)?img\.uniform\.(rocks|global)\/(.*?))"/g
-  );
+  const uniformFileUrlMatches = getUniformFileUrlMatches(objectAsString);
+  const writeDirectory = getFilesDirectory(options.directory);
   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)
+            join2(writeDirectory, FILES_DIRECTORY_NAME, fileName)
           );
           if (fileAlreadyExists) {
             return;
           }
+          const file = await options.fileClient.get({ url: url.toString() }).catch(() => null);
+          if (!file) {
+            console.warn(`Skipping file ${url} as it does not exist in the project anymore`);
+            return;
+          }
+          if (file.sourceId) {
+            try {
+              const hashAlreadyExists = await fsj.findAsync(join2(writeDirectory, FILES_DIRECTORY_NAME), {
+                matching: [file.sourceId, `${file.sourceId}.*`]
+              });
+              if (hashAlreadyExists.length > 0) {
+                return;
+              }
+            } catch {
+            }
+          }
+          const fetchUrl = `${url.origin}${url.pathname}?format=original`;
           const response = await fetch(fetchUrl);
           if (!response.ok) {
             return;
           }
           const fileBuffer = await response.arrayBuffer();
-          const isPackage = isPathAPackageFile(options.directory);
-          const writeDirectory = isPackage ? dirname2(options.directory) : options.directory;
           await fsj.writeAsync(join2(writeDirectory, FILES_DIRECTORY_NAME, fileName), Buffer.from(fileBuffer));
         } catch {
           console.warn(`Failed to download file ${url}`);
@@ -737,37 +794,45 @@ var extractAndDownloadUniformFilesForObject = async (object, options) => {
 };
 var extractAndUploadUniformFilesForObject = async (object, options) => {
   let objectAsString = JSON.stringify(object);
-  const uniformFileUrlMatches = objectAsString.matchAll(
-    /"(https:\/\/(.*)?img\.uniform\.(rocks|global)\/(.*?))"/g
-  );
+  const uniformFileUrlMatches = getUniformFileUrlMatches(objectAsString);
+  const writeDirectory = getFilesDirectory(options.directory);
+  const isPackage = isPathAPackageFile(options.directory);
+  const legacyWriteDirectory = isPackage ? dirname2(options.directory) : options.directory;
   if (uniformFileUrlMatches) {
     const fileUploadQueue = new PQueue({ concurrency: 3 });
     for (const match of uniformFileUrlMatches) {
       const url = match[1];
       const hash = urlToHash(url);
+      const legacyHash = legacyUrlToHash(url);
       fileUploadQueue.add(async () => {
         try {
           const fileAlreadyExistsChecks = await Promise.all([
             options.fileClient.get({ url }).catch(() => null),
-            options.fileClient.get({ sourceId: hash }).catch(() => null)
+            options.fileClient.get({ sourceId: hash }).catch(() => null),
+            options.fileClient.get({ sourceId: legacyHash }).catch(() => null)
           ]);
-          if (fileAlreadyExistsChecks.some((check) => check !== null)) {
+          const file = fileAlreadyExistsChecks.find((check) => check !== null);
+          if (file) {
+            objectAsString = objectAsString.replaceAll(`"${url}"`, `"${file.url}"`);
             return;
           }
           const localFileName = urlToFileName(url);
-          const fileExistsLocally = await fsj.existsAsync(
-            join2(options.directory, FILES_DIRECTORY_NAME, localFileName)
-          );
+          let expectedFilePath = join2(writeDirectory, FILES_DIRECTORY_NAME, localFileName);
+          let fileExistsLocally = await fsj.existsAsync(expectedFilePath);
+          if (!fileExistsLocally) {
+            const localFileName2 = legacyUrlToFileName(url);
+            expectedFilePath = join2(legacyWriteDirectory, FILES_DIRECTORY_NAME, localFileName2);
+            fileExistsLocally = await fsj.existsAsync(expectedFilePath);
+          }
           if (!fileExistsLocally) {
-            console.warn(`Skipping file ${url} as we couldn't find a local copy`);
+            console.warn(
+              `Skipping file ${url} as we couldn't find a local copy (looked at ${expectedFilePath})`
+            );
             return;
           }
-          const fileBuffer = await fsj.readAsync(
-            join2(options.directory, FILES_DIRECTORY_NAME, localFileName),
-            "buffer"
-          );
+          const fileBuffer = await fsj.readAsync(expectedFilePath, "buffer");
           if (!fileBuffer) {
-            console.warn(`Skipping file ${url} as we couldn't read it`);
+            console.warn(`Skipping file ${url} (${expectedFilePath}) as we couldn't read it`);
             return;
           }
           const fileName = getFileNameFromUrl(url);
@@ -799,20 +864,20 @@ var extractAndUploadUniformFilesForObject = async (object, options) => {
             }
           });
           if (!uploadResponse.ok) {
-            console.warn(`Failed to upload file ${url}`);
+            console.warn(`Failed to upload file ${url} (${expectedFilePath})`);
             return;
           }
           const checkForFile = async () => {
-            const file = await options.fileClient.get({ id });
-            if (!file || file.state !== FILE_READY_STATE || !file.url) {
+            const file2 = await options.fileClient.get({ id });
+            if (!file2 || file2.state !== FILE_READY_STATE || !file2.url) {
               await new Promise((resolve2) => setTimeout(resolve2, 500));
               return checkForFile();
             }
-            return file.url;
+            return file2.url;
           };
           const abortTimeout = setTimeout(() => {
-            throw new Error(`Failed to upload file ${url}`);
-          }, 1e4);
+            throw new Error(`Failed to upload file ${url} (${expectedFilePath}) - upload timed out`);
+          }, 3e4);
           const uploadedFileUrl = await checkForFile();
           clearTimeout(abortTimeout);
           objectAsString = objectAsString.replaceAll(`"${url}"`, `"${uploadedFileUrl}"`);
@@ -827,19 +892,19 @@ var extractAndUploadUniformFilesForObject = async (object, options) => {
 };
 var swapOutUniformFileUrlsForTargetProject = async (object, options) => {
   let objectAsString = JSON.stringify(object);
-  const uniformFileUrlMatches = objectAsString.matchAll(
-    /"(https:\/\/(.*)?img\.uniform\.(rocks|global)\/(.*?))"/g
-  );
+  const uniformFileUrlMatches = getUniformFileUrlMatches(objectAsString);
   if (uniformFileUrlMatches) {
     const fileUrlReplacementQueue = new PQueue({ concurrency: 3 });
     for (const match of uniformFileUrlMatches) {
       const url = match[1];
       const hash = urlToHash(url);
+      const legacyHash = legacyUrlToHash(url);
       fileUrlReplacementQueue.add(async () => {
         try {
           const fileAlreadyExistsChecks = await Promise.all([
             options.fileClient.get({ url }).catch(() => null),
-            options.fileClient.get({ sourceId: hash }).catch(() => null)
+            options.fileClient.get({ sourceId: hash }).catch(() => null),
+            options.fileClient.get({ sourceId: legacyHash }).catch(() => null)
           ]);
           const file = fileAlreadyExistsChecks.find((check) => check !== null);
           if (!file) {
@@ -854,19 +919,74 @@ var swapOutUniformFileUrlsForTargetProject = async (object, options) => {
   }
   return JSON.parse(objectAsString);
 };
+var replaceRemoteUrlsWithLocalReferences = async (sourceObject, targetObject, options) => {
+  let sourceObjectAsString = JSON.stringify(sourceObject);
+  const targetObjectAsString = JSON.stringify(targetObject);
+  const uniformFileUrlMatches = getUniformFileUrlMatches(sourceObjectAsString);
+  const writeDirectory = getFilesDirectory(options.directory);
+  if (uniformFileUrlMatches) {
+    const fileUrlReplacementQueue = new PQueue({ concurrency: 3 });
+    for (const match of uniformFileUrlMatches) {
+      const url = match[1];
+      fileUrlReplacementQueue.add(async () => {
+        try {
+          const localFileName = urlToFileName(url);
+          const fileExistsLocally = await fsj.existsAsync(
+            join2(writeDirectory, FILES_DIRECTORY_NAME, localFileName)
+          );
+          if (fileExistsLocally) {
+            return;
+          }
+          const file = await options.fileClient.get({ url }).catch(() => null);
+          if (!file || !file.sourceId) {
+            return;
+          }
+          const originalPartialPath = hashToPartialPathname(file.sourceId);
+          if (!originalPartialPath) {
+            return;
+          }
+          const originalUrl = findUrlMatchingPartialPathname(targetObjectAsString, originalPartialPath);
+          if (!originalUrl) {
+            return;
+          }
+          sourceObjectAsString = sourceObjectAsString.replaceAll(`"${url}"`, `"${originalUrl}"`);
+        } catch {
+        }
+      });
+    }
+    await fileUrlReplacementQueue.onIdle();
+  }
+  return JSON.parse(sourceObjectAsString);
+};
 var updateAssetFileIdBasedOnUrl = async (asset, options) => {
-  var _a, _b, _c;
-  const fileUrl = (_b = (_a = asset.asset.fields) == null ? void 0 : _a.url) == null ? void 0 : _b.value;
-  if (!fileUrl || !((_c = asset.asset.fields) == null ? void 0 : _c.file)) {
+  var _a;
+  if (!asset.asset.fields) {
+    return asset;
+  }
+  const fileUrl = (_a = asset.asset.fields.url) == null ? void 0 : _a.value;
+  if (!fileUrl) {
     return asset;
   }
   const file = await options.fileClient.get({ url: fileUrl }).catch(() => null);
   if (!file) {
     return asset;
   }
-  asset.asset.fields.file.value = file.id;
+  asset.asset.fields.file = {
+    type: "file",
+    value: file.id
+  };
   return asset;
 };
+var legacyUrlToHash = (url) => {
+  const hash = createHash("sha256");
+  hash.update(url);
+  return hash.digest("hex");
+};
+var legacyUrlToFileName = (url) => {
+  const fileName = legacyUrlToHash(url);
+  const fileExtension = urlToFileExtension(url);
+  return `${fileName}${fileExtension ? `.${fileExtension}` : ""}`;
+};
 
 // src/commands/canvas/assetEngineDataSource.ts
 import { convertAssetToPutAsset } from "@uniformdev/assets";
@@ -891,8 +1011,8 @@ function prepCompositionForDisk(composition) {
   delete prepped.state;
   return prepped;
 }
-function withStateOptions(yargs27) {
-  return yargs27.option("state", {
+function withStateOptions(yargs28) {
+  return yargs28.option("state", {
     type: "string",
     describe: `Composition state to fetch.`,
     choices: ["preview", "published"],
@@ -958,11 +1078,11 @@ function writeCanvasPackage(filename, packageContents) {
 var AssetPullModule = {
   command: "pull <directory>",
   describe: "Pulls all assets to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the assets 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", {
@@ -996,7 +1116,8 @@ var AssetPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAssetClient3({
@@ -1005,6 +1126,7 @@ var AssetPullModule = {
       fetch: fetch3,
       projectId
     });
+    const fileClient = new UncachedFileClient({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createAssetEngineDataSource({ client });
     let target;
     const isPackage = isPathAPackageFile(directory);
@@ -1044,16 +1166,29 @@ var AssetPullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode }),
-      onBeforeCompareObjects: async (sourceObject) => {
+      onBeforeCompareObjects: async (sourceObject, targetObject) => {
+        var _a, _b;
         delete sourceObject.object.asset._author;
-        return sourceObject;
+        const sourceObjectWithPotentiallySwappedUrl = await replaceRemoteUrlsWithLocalReferences(
+          sourceObject,
+          targetObject,
+          {
+            directory,
+            fileClient
+          }
+        );
+        if (((_a = sourceObjectWithPotentiallySwappedUrl.object.asset.fields) == null ? void 0 : _a.url) && ((_b = targetObject.object.asset.fields) == null ? void 0 : _b.url) && sourceObjectWithPotentiallySwappedUrl.object.asset.fields.url.value === targetObject.object.asset.fields.url.value) {
+          targetObject.object.asset.fields.file = sourceObjectWithPotentiallySwappedUrl.object.asset.fields.file;
+        }
+        return sourceObjectWithPotentiallySwappedUrl;
       },
       onBeforeWriteObject: async (sourceObject) => {
         delete sourceObject.object.asset._author;
         return extractAndDownloadUniformFilesForObject(sourceObject, {
-          directory
+          directory,
+          fileClient
         });
       }
     });
@@ -1062,15 +1197,15 @@ var AssetPullModule = {
 
 // src/commands/canvas/commands/asset/push.ts
 import { UncachedAssetClient as UncachedAssetClient4 } from "@uniformdev/assets";
-import { UncachedFileClient } from "@uniformdev/files";
+import { UncachedFileClient as UncachedFileClient2 } from "@uniformdev/files";
 var AssetPushModule = {
   command: "push <directory>",
   describe: "Pushes all assets from files in a directory to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the assets from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -1097,7 +1232,8 @@ var AssetPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAssetClient4({
@@ -1123,12 +1259,13 @@ var AssetPushModule = {
       });
     }
     const target = createAssetEngineDataSource({ client });
-    const fileClient = new UncachedFileClient({ apiKey, apiHost, fetch: fetch3, projectId });
+    const fileClient = new UncachedFileClient2({ apiKey, apiHost, fetch: fetch3, projectId });
     await syncEngine({
       source,
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode }),
       onBeforeCompareObjects: async (sourceObject, targetObject) => {
         if (targetObject) {
@@ -1168,9 +1305,9 @@ var AssetRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an asset",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("id", { demandOption: true, describe: "Asset ID to delete" }))
+      withProjectOptions(yargs28.positional("id", { demandOption: true, describe: "Asset ID to delete" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -1186,10 +1323,10 @@ var AssetUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update an asset",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Asset file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Asset file to put" })
       )
     )
   ),
@@ -1205,7 +1342,7 @@ var AssetUpdateModule = {
 var AssetModule = {
   command: "asset <command>",
   describe: "Commands for Assets",
-  builder: (yargs27) => yargs27.command(AssetGetModule).command(AssetListModule).command(AssetRemoveModule).command(AssetUpdateModule).command(AssetPullModule).command(AssetPushModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(AssetGetModule).command(AssetListModule).command(AssetRemoveModule).command(AssetUpdateModule).command(AssetPullModule).command(AssetPushModule).demandCommand(),
   handler: () => {
     yargs.help();
   }
@@ -1219,11 +1356,11 @@ import { UncachedCategoryClient } from "@uniformdev/canvas";
 var CategoryGetModule = {
   command: "get <id>",
   describe: "Fetch a category",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Category UUID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Category UUID to fetch" })
         )
       )
     )
@@ -1248,7 +1385,7 @@ var CategoryListModule = {
   command: "list",
   describe: "List categories",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27.options({}))))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28.options({}))))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCategoryClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -1297,11 +1434,11 @@ function createCategoriesEngineDataSource({
 var CategoryPullModule = {
   command: "pull <directory>",
   describe: "Pulls all categories to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -1335,7 +1472,8 @@ var CategoryPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCategoryClient3({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -1366,7 +1504,7 @@ var CategoryPullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -1377,11 +1515,11 @@ import { UncachedCategoryClient as UncachedCategoryClient4 } from "@uniformdev/c
 var CategoryPushModule = {
   command: "push <directory>",
   describe: "Pushes all categories from files in a directory to Uniform Canvas",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -1408,7 +1546,8 @@ var CategoryPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCategoryClient4({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -1434,6 +1573,7 @@ var CategoryPushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -1445,10 +1585,10 @@ var CategoryRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a category",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Category UUID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Category UUID to delete" })
       )
     )
   ),
@@ -1465,10 +1605,10 @@ var CategoryUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a category",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Category file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Category file to put" })
       )
     )
   ),
@@ -1485,7 +1625,7 @@ var CategoryModule = {
   command: "category <command>",
   aliases: ["cat"],
   describe: "Commands for Canvas categories",
-  builder: (yargs27) => yargs27.command(CategoryPullModule).command(CategoryPushModule).command(CategoryGetModule).command(CategoryRemoveModule).command(CategoryListModule).command(CategoryUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(CategoryPullModule).command(CategoryPushModule).command(CategoryGetModule).command(CategoryRemoveModule).command(CategoryListModule).command(CategoryUpdateModule).demandCommand(),
   handler: () => {
     yargs2.help();
   }
@@ -1506,11 +1646,11 @@ var selectSchemaUrl = () => "/schemas/json-schema/component-definition/v1.json";
 var ComponentGetModule = {
   command: "get <id>",
   describe: "Fetch a component definition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", {
+          yargs28.positional("id", {
             demandOption: true,
             describe: "Component definition public ID to fetch"
           })
@@ -1544,11 +1684,11 @@ var ComponentListModule = {
   command: "list",
   describe: "List component definitions",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.options({
+          yargs28.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 }
           })
@@ -1603,11 +1743,11 @@ function createComponentDefinitionEngineDataSource({
 var ComponentPullModule = {
   command: "pull <directory>",
   describe: "Pulls all component definitions to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -1641,7 +1781,8 @@ var ComponentPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCanvasClient3({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -1673,7 +1814,7 @@ var ComponentPullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -1684,11 +1825,11 @@ import { UncachedCanvasClient as UncachedCanvasClient4 } from "@uniformdev/canva
 var ComponentPushModule = {
   command: "push <directory>",
   describe: "Pushes all component definitions from files in a directory to Uniform Canvas",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -1715,7 +1856,8 @@ var ComponentPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCanvasClient4({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -1742,6 +1884,7 @@ var ComponentPushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -1753,10 +1896,10 @@ var ComponentRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a component definition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Component definition public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Component definition public ID to delete" })
       )
     )
   ),
@@ -1773,10 +1916,10 @@ var ComponentUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a component definition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Component definition file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Component definition file to put" })
       )
     )
   ),
@@ -1793,7 +1936,7 @@ var ComponentModule = {
   command: "component <command>",
   aliases: ["def"],
   describe: "Commands for Canvas component definitions",
-  builder: (yargs27) => yargs27.command(ComponentPullModule).command(ComponentPushModule).command(ComponentGetModule).command(ComponentRemoveModule).command(ComponentListModule).command(ComponentUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ComponentPullModule).command(ComponentPushModule).command(ComponentGetModule).command(ComponentRemoveModule).command(ComponentListModule).command(ComponentUpdateModule).demandCommand(),
   handler: () => {
     yargs3.help();
   }
@@ -1807,12 +1950,12 @@ import { UncachedCanvasClient as UncachedCanvasClient7 } from "@uniformdev/canva
 var CompositionGetModule = {
   command: "get <id>",
   describe: "Fetch a composition",
-  builder: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
           withStateOptions(
-            yargs27.positional("id", { demandOption: true, describe: "Composition/pattern public ID to fetch" }).option({
+            yargs28.positional("id", { demandOption: true, describe: "Composition/pattern public ID to fetch" }).option({
               resolvePatterns: {
                 type: "boolean",
                 default: false,
@@ -1883,12 +2026,12 @@ var CompositionListModule = {
   command: "list",
   describe: "List compositions",
   aliases: ["ls"],
-  builder: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
           withStateOptions(
-            yargs27.options({
+            yargs28.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: {
@@ -2009,11 +2152,11 @@ function createComponentInstanceEngineDataSource({
 var CompositionPublishModule = {
   command: "publish [ids]",
   describe: "Publishes composition(s)",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("ids", {
+          yargs28.positional("ids", {
             describe: "Publishes composition(s) by ID. Comma-separate multiple IDs. Use --all to publish all instead.",
             type: "string"
           }).option("all", {
@@ -2085,15 +2228,16 @@ var CompositionPublishModule = {
 
 // src/commands/canvas/commands/composition/pull.ts
 import { UncachedCanvasClient as UncachedCanvasClient10 } from "@uniformdev/canvas";
+import { UncachedFileClient as UncachedFileClient3 } from "@uniformdev/files";
 var CompositionPullModule = {
   command: "pull <directory>",
   describe: "Pulls all compositions to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.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", {
@@ -2140,10 +2284,12 @@ var CompositionPullModule = {
     whatIf,
     state,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCanvasClient10({ apiKey, apiHost, fetch: fetch3, projectId });
+    const fileClient = new UncachedFileClient3({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createComponentInstanceEngineDataSource({ client, state, onlyCompositions, onlyPatterns });
     const isPackage = isPathAPackageFile(directory);
     let target;
@@ -2171,11 +2317,18 @@ var CompositionPullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode }),
+      onBeforeCompareObjects: async (sourceObject, targetObject) => {
+        return replaceRemoteUrlsWithLocalReferences(sourceObject, targetObject, {
+          directory,
+          fileClient
+        });
+      },
       onBeforeWriteObject: async (sourceObject) => {
         return extractAndDownloadUniformFilesForObject(sourceObject, {
-          directory
+          directory,
+          fileClient
         });
       }
     });
@@ -2184,16 +2337,16 @@ var CompositionPullModule = {
 
 // src/commands/canvas/commands/composition/push.ts
 import { UncachedCanvasClient as UncachedCanvasClient11 } from "@uniformdev/canvas";
-import { UncachedFileClient as UncachedFileClient2 } from "@uniformdev/files";
+import { UncachedFileClient as UncachedFileClient4 } from "@uniformdev/files";
 var CompositionPushModule = {
   command: "push <directory>",
   describe: "Pushes all compositions from files in a directory to Uniform Canvas",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.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", {
@@ -2233,7 +2386,8 @@ var CompositionPushModule = {
     project: projectId,
     onlyCompositions,
     onlyPatterns,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCanvasClient11({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -2254,12 +2408,13 @@ var CompositionPushModule = {
       });
     }
     const target = createComponentInstanceEngineDataSource({ client, state, onlyCompositions, onlyPatterns });
-    const fileClient = new UncachedFileClient2({ apiKey, apiHost, fetch: fetch3, projectId });
+    const fileClient = new UncachedFileClient4({ apiKey, apiHost, fetch: fetch3, projectId });
     await syncEngine({
       source,
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode }),
       onBeforeCompareObjects: async (sourceObject) => {
         return swapOutUniformFileUrlsForTargetProject(sourceObject, {
@@ -2282,10 +2437,10 @@ var CompositionRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a composition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Composition/pattern public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Composition/pattern public ID to delete" })
       )
     )
   ),
@@ -2302,10 +2457,10 @@ import { diffJson as diffJson2 } from "diff";
 var CompositionUnpublishModule = {
   command: "unpublish [ids]",
   describe: "Unpublish a composition(s)",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("ids", {
+        yargs28.positional("ids", {
           describe: "Un-publishes composition(s) by ID. Comma-separate multiple IDs. Use --all to un-publish all instead.",
           type: "string"
         }).option("all", {
@@ -2399,11 +2554,11 @@ var CompositionUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a composition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
-          yargs27.positional("filename", { demandOption: true, describe: "Composition/pattern file to put" })
+          yargs28.positional("filename", { demandOption: true, describe: "Composition/pattern file to put" })
         )
       )
     )
@@ -2421,7 +2576,7 @@ var CompositionModule = {
   command: "composition <command>",
   describe: "Commands for Canvas compositions",
   aliases: ["comp"],
-  builder: (yargs27) => yargs27.command(CompositionPullModule).command(CompositionPushModule).command(CompositionGetModule).command(CompositionRemoveModule).command(CompositionListModule).command(CompositionUpdateModule).command(CompositionPublishModule).command(CompositionUnpublishModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(CompositionPullModule).command(CompositionPushModule).command(CompositionGetModule).command(CompositionRemoveModule).command(CompositionListModule).command(CompositionUpdateModule).command(CompositionPublishModule).command(CompositionUnpublishModule).demandCommand(),
   handler: () => {
     yargs4.help();
   }
@@ -2435,12 +2590,12 @@ import { ContentClient } from "@uniformdev/canvas";
 var ContentTypeGetModule = {
   command: "get <id>",
   describe: "Get a content type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Content type public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Content type public ID to fetch" })
         )
       )
     )
@@ -2462,7 +2617,7 @@ import { ContentClient as ContentClient2 } from "@uniformdev/canvas";
 var ContentTypeListModule = {
   command: "list",
   describe: "List content types",
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new ContentClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
@@ -2509,11 +2664,11 @@ function createContentTypeEngineDataSource({
 var ContentTypePullModule = {
   command: "pull <directory>",
   describe: "Pulls all content types to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -2547,7 +2702,8 @@ var ContentTypePullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new ContentClient3({
@@ -2584,7 +2740,7 @@ var ContentTypePullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -2595,11 +2751,11 @@ 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -2626,7 +2782,8 @@ var ContentTypePushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new ContentClient4({
@@ -2658,6 +2815,7 @@ var ContentTypePushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -2669,10 +2827,10 @@ var ContentTypeRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a content type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Content type public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Content type public ID to delete" })
       )
     )
   ),
@@ -2689,10 +2847,10 @@ var ContentTypeUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a content type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Content type file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Content type file to put" })
       )
     )
   ),
@@ -2709,7 +2867,7 @@ var ContentTypeModule = {
   command: "contenttype <command>",
   aliases: ["ct"],
   describe: "Commands for Content Types",
-  builder: (yargs27) => yargs27.command(ContentTypeGetModule).command(ContentTypeListModule).command(ContentTypeRemoveModule).command(ContentTypeUpdateModule).command(ContentTypePullModule).command(ContentTypePushModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ContentTypeGetModule).command(ContentTypeListModule).command(ContentTypeRemoveModule).command(ContentTypeUpdateModule).command(ContentTypePullModule).command(ContentTypePushModule).demandCommand(),
   handler: () => {
     yargs5.help();
   }
@@ -2724,12 +2882,12 @@ var DataTypeGetModule = {
   command: "get <id>",
   describe: "Get a data type",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Data type public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Data type public ID to fetch" })
         )
       )
     )
@@ -2752,7 +2910,7 @@ var DataTypeListModule = {
   command: "list",
   describe: "List data types",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new DataTypeClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
@@ -2801,11 +2959,11 @@ function createDataTypeEngineDataSource({
 var DataTypePullModule = {
   command: "pull <directory>",
   describe: "Pulls all data types to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -2839,7 +2997,8 @@ var DataTypePullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new DataTypeClient3({
@@ -2876,7 +3035,7 @@ var DataTypePullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -2887,11 +3046,11 @@ 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -2918,7 +3077,8 @@ var DataTypePushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new DataTypeClient4({
@@ -2950,6 +3110,7 @@ var DataTypePushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -2961,10 +3122,10 @@ var DataTypeRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a data type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Data type public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Data type public ID to delete" })
       )
     )
   ),
@@ -2981,10 +3142,10 @@ var DataTypeUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a data type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Data type file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Data type file to put" })
       )
     )
   ),
@@ -3001,7 +3162,7 @@ var DataTypeModule = {
   command: "datatype <command>",
   aliases: ["dt"],
   describe: "Commands for Data Type definitions",
-  builder: (yargs27) => yargs27.command(DataTypeGetModule).command(DataTypePullModule).command(DataTypePushModule).command(DataTypeRemoveModule).command(DataTypeListModule).command(DataTypeUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(DataTypeGetModule).command(DataTypePullModule).command(DataTypePushModule).command(DataTypeRemoveModule).command(DataTypeListModule).command(DataTypeUpdateModule).demandCommand(),
   handler: () => {
     yargs6.help();
   }
@@ -3015,12 +3176,12 @@ import { ContentClient as ContentClient7 } from "@uniformdev/canvas";
 var EntryGetModule = {
   command: "get <id>",
   describe: "Get an entry",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Entry public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Entry public ID to fetch" })
         )
       )
     )
@@ -3032,7 +3193,9 @@ var EntryGetModule = {
       offset: 0,
       limit: 1,
       entryIDs: [id],
-      skipOverridesResolution: true
+      skipOverridesResolution: true,
+      skipPatternResolution: true,
+      skipDataResolution: true
     });
     if (res.entries.length !== 1) {
       throw new Error(`Entry with ID ${id} not found`);
@@ -3046,17 +3209,24 @@ import { ContentClient as ContentClient8 } from "@uniformdev/canvas";
 var EntryListModule = {
   command: "list",
   describe: "List entries",
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new ContentClient8({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
-    const res = await client.getEntries({ offset: 0, limit: 1e3, skipOverridesResolution: true });
+    const res = await client.getEntries({
+      offset: 0,
+      limit: 1e3,
+      skipOverridesResolution: true,
+      skipPatternResolution: true,
+      skipDataResolution: true
+    });
     emitWithFormat(res.entries, format, filename);
   }
 };
 
 // src/commands/canvas/commands/entry/pull.ts
 import { ContentClient as ContentClient10 } from "@uniformdev/canvas";
+import { UncachedFileClient as UncachedFileClient5 } from "@uniformdev/files";
 
 // src/commands/canvas/entryEngineDataSource.ts
 import { convertEntryToPutEntry } from "@uniformdev/canvas";
@@ -3077,6 +3247,7 @@ function createEntryEngineDataSource({
       limit: 1e3,
       skipDataResolution: true,
       skipOverridesResolution: true,
+      skipPatternResolution: true,
       state: stateId,
       withComponentIDs: true
     });
@@ -3105,12 +3276,12 @@ function createEntryEngineDataSource({
 var EntryPullModule = {
   command: "pull <directory>",
   describe: "Pulls all entries to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.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", {
@@ -3146,7 +3317,8 @@ var EntryPullModule = {
     whatIf,
     state,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new ContentClient10({
@@ -3156,6 +3328,7 @@ var EntryPullModule = {
       projectId,
       bypassCache: true
     });
+    const fileClient = new UncachedFileClient5({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createEntryEngineDataSource({ client, state });
     let target;
     const isPackage = isPathAPackageFile(directory);
@@ -3183,23 +3356,36 @@ var EntryPullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
-      log: createSyncEngineConsoleLogger({ diffMode })
+      allowEmptySource: allowEmptySource ?? true,
+      log: createSyncEngineConsoleLogger({ diffMode }),
+      onBeforeCompareObjects: async (sourceObject, targetObject) => {
+        return replaceRemoteUrlsWithLocalReferences(sourceObject, targetObject, {
+          directory,
+          fileClient
+        });
+      },
+      onBeforeWriteObject: async (sourceObject) => {
+        return extractAndDownloadUniformFilesForObject(sourceObject, {
+          directory,
+          fileClient
+        });
+      }
     });
   }
 };
 
 // src/commands/canvas/commands/entry/push.ts
 import { ContentClient as ContentClient11 } from "@uniformdev/canvas";
+import { UncachedFileClient as UncachedFileClient6 } from "@uniformdev/files";
 var EntryPushModule = {
   command: "push <directory>",
   describe: "Pushes all entries from files in a directory to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.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", {
@@ -3228,7 +3414,8 @@ var EntryPushModule = {
     whatIf,
     state,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new ContentClient11({
@@ -3255,12 +3442,25 @@ var EntryPushModule = {
       });
     }
     const target = createEntryEngineDataSource({ client, state });
+    const fileClient = new UncachedFileClient6({ apiKey, apiHost, fetch: fetch3, projectId });
     await syncEngine({
       source,
       target,
       mode,
       whatIf,
-      log: createSyncEngineConsoleLogger({ diffMode })
+      allowEmptySource,
+      log: createSyncEngineConsoleLogger({ diffMode }),
+      onBeforeCompareObjects: async (sourceObject) => {
+        return swapOutUniformFileUrlsForTargetProject(sourceObject, {
+          fileClient
+        });
+      },
+      onBeforeWriteObject: async (sourceObject) => {
+        return extractAndUploadUniformFilesForObject(sourceObject, {
+          directory,
+          fileClient
+        });
+      }
     });
   }
 };
@@ -3271,10 +3471,10 @@ var EntryRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an entry",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Entry public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Entry public ID to delete" })
       )
     )
   ),
@@ -3291,10 +3491,10 @@ var EntryUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update an entry",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Entry file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Entry file to put" })
       )
     )
   ),
@@ -3310,15 +3510,221 @@ var EntryUpdateModule = {
 var EntryModule = {
   command: "entry <command>",
   describe: "Commands for Entries",
-  builder: (yargs27) => yargs27.command(EntryGetModule).command(EntryListModule).command(EntryRemoveModule).command(EntryUpdateModule).command(EntryPullModule).command(EntryPushModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(EntryGetModule).command(EntryListModule).command(EntryRemoveModule).command(EntryUpdateModule).command(EntryPullModule).command(EntryPushModule).demandCommand(),
   handler: () => {
     yargs7.help();
   }
 };
 
-// src/commands/canvas/commands/pattern.ts
+// src/commands/canvas/commands/locale.ts
 import yargs8 from "yargs";
 
+// src/commands/canvas/commands/locale/pull.ts
+import { LocaleClient } from "@uniformdev/canvas";
+
+// src/commands/canvas/localesEngineDataSource.ts
+function createLocaleEngineDataSource({
+  client
+}) {
+  async function* getObjects() {
+    const locales = (await client.get()).results;
+    for await (const locale of locales) {
+      const result = {
+        id: locale.locale,
+        displayName: locale.displayName,
+        providerId: locale.locale,
+        object: locale
+      };
+      yield result;
+    }
+  }
+  return {
+    objects: getObjects(),
+    deleteObject: async (providerId) => {
+      await client.remove({ locale: providerId });
+    },
+    writeObject: async (object) => {
+      await client.upsert({
+        locale: object.object
+      });
+    }
+  };
+}
+
+// src/commands/canvas/commands/locale/pull.ts
+var LocalePullModule = {
+  command: "pull <directory>",
+  describe: "Pulls all locales to local files in a directory",
+  builder: (yargs28) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs28.positional("directory", {
+            describe: "Directory to save the locales 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,
+    allowEmptySource
+  }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new LocaleClient({
+      apiKey,
+      apiHost,
+      fetch: fetch3,
+      projectId,
+      bypassCache: true
+    });
+    const source = createLocaleEngineDataSource({ client });
+    let target;
+    const isPackage = isPathAPackageFile(directory);
+    if (isPackage) {
+      const packageContents = readCanvasPackage(directory, false);
+      target = await createArraySyncEngineDataSource({
+        objects: packageContents.locales ?? [],
+        selectIdentifier: (i) => i.locale,
+        selectDisplayName: (i) => i.displayName,
+        onSyncComplete: async (_, synced) => {
+          packageContents.locales = synced;
+          writeCanvasPackage(directory, packageContents);
+        }
+      });
+    } else {
+      target = await createFileSyncEngineDataSource({
+        directory,
+        selectIdentifier: (i) => i.locale,
+        selectDisplayName: (i) => i.displayName,
+        format
+      });
+    }
+    await syncEngine({
+      source,
+      target,
+      mode,
+      whatIf,
+      allowEmptySource: allowEmptySource ?? true,
+      log: createSyncEngineConsoleLogger({ diffMode })
+    });
+  }
+};
+
+// src/commands/canvas/commands/locale/push.ts
+import { LocaleClient as LocaleClient2 } from "@uniformdev/canvas";
+var LocalePushModule = {
+  command: "push <directory>",
+  describe: "Pushes all locales from files in a directory to Uniform",
+  builder: (yargs28) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs28.positional("directory", {
+            describe: "Directory to read the locales 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,
+    allowEmptySource
+  }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new LocaleClient2({
+      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.locales ?? [],
+        selectIdentifier: (locale) => locale.locale,
+        selectDisplayName: (locale) => locale.displayName
+      });
+    } else {
+      source = await createFileSyncEngineDataSource({
+        directory,
+        selectIdentifier: (locale) => locale.locale,
+        selectDisplayName: (locale) => locale.displayName
+      });
+    }
+    const target = createLocaleEngineDataSource({ client });
+    await syncEngine({
+      source,
+      target,
+      mode,
+      whatIf,
+      allowEmptySource,
+      log: createSyncEngineConsoleLogger({ diffMode })
+    });
+  }
+};
+
+// src/commands/canvas/commands/locale.ts
+var LocaleModule = {
+  command: "locale <command>",
+  describe: "Commands for locale definitions",
+  builder: (yargs28) => yargs28.command(LocalePullModule).command(LocalePushModule),
+  handler: () => {
+    yargs8.help();
+  }
+};
+
+// src/commands/canvas/commands/pattern.ts
+import yargs9 from "yargs";
+
 // src/commands/canvas/commands/pattern/get.ts
 var PatternGetModule = {
   ...CompositionGetModule,
@@ -3329,12 +3735,12 @@ var PatternGetModule = {
 var PatternListModule = {
   ...CompositionListModule,
   describe: "List patterns",
-  builder: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
           withStateOptions(
-            yargs27.options({
+            yargs28.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: {
@@ -3372,11 +3778,11 @@ var PatternListModule = {
 var PatternPublishModule = {
   ...CompositionPublishModule,
   describe: "Publishes pattern(s)",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("ids", {
+          yargs28.positional("ids", {
             describe: "Publishes pattern(s) by ID. Comma-separate multiple IDs. Use --all to publish all instead.",
             type: "string"
           }).option("all", {
@@ -3414,12 +3820,12 @@ var PatternPublishModule = {
 var PatternPullModule = {
   ...CompositionPullModule,
   describe: "Pulls all patterns to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.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", {
@@ -3457,12 +3863,12 @@ var PatternPullModule = {
 var PatternPushModule = {
   ...CompositionPushModule,
   describe: "Pushes all patterns from files in a directory to Uniform Canvas",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.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", {
@@ -3500,10 +3906,10 @@ var PatternRemoveModule = {
 var PatternUnpublishModule = {
   command: "unpublish [ids]",
   describe: "Unpublish a pattern(s)",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("ids", {
+        yargs28.positional("ids", {
           describe: "Un-publishes composition(s) by ID. Comma-separate multiple IDs. Use --all to un-publish all instead.",
           type: "string"
         }).option("all", {
@@ -3542,26 +3948,26 @@ var PatternUpdateModule = {
 var PatternModule = {
   command: "pattern <command>",
   describe: "Commands for Canvas patterns",
-  builder: (yargs27) => yargs27.command(PatternPullModule).command(PatternPushModule).command(PatternGetModule).command(PatternRemoveModule).command(PatternListModule).command(PatternUpdateModule).command(PatternPublishModule).command(PatternUnpublishModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(PatternPullModule).command(PatternPushModule).command(PatternGetModule).command(PatternRemoveModule).command(PatternListModule).command(PatternUpdateModule).command(PatternPublishModule).command(PatternUnpublishModule).demandCommand(),
   handler: () => {
-    yargs8.help();
+    yargs9.help();
   }
 };
 
 // src/commands/canvas/commands/prompts.ts
-import yargs9 from "yargs";
+import yargs10 from "yargs";
 
 // src/commands/canvas/commands/prompts/get.ts
 import { PromptClient } from "@uniformdev/canvas";
 var PromptGetModule = {
   command: "get <id>",
   describe: "Get a prompt",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Prompt ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Prompt ID to fetch" })
         )
       )
     )
@@ -3582,7 +3988,7 @@ import { PromptClient as PromptClient2 } from "@uniformdev/canvas";
 var PromptListModule = {
   command: "list",
   describe: "List prompts",
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new PromptClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
@@ -3629,12 +4035,12 @@ function createPromptEngineDataSource({
 var PromptPullModule = {
   command: "pull <directory>",
   describe: "Pulls all entries to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.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", {
@@ -3669,7 +4075,8 @@ var PromptPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new PromptClient3({
@@ -3706,7 +4113,7 @@ var PromptPullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -3717,12 +4124,12 @@ import { PromptClient as PromptClient4 } from "@uniformdev/canvas";
 var PromptPushModule = {
   command: "push <directory>",
   describe: "Pushes all prompts from files in a directory to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.positional("directory", {
               describe: "Directory to read the prompts from. If a filename is used, a package will be read instead.",
               type: "string"
             }).option("what-if", {
@@ -3750,7 +4157,8 @@ var PromptPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new PromptClient4({
@@ -3782,6 +4190,7 @@ var PromptPushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -3793,9 +4202,9 @@ var PromptRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a prompt",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("id", { demandOption: true, describe: "Prompt ID to delete" }))
+      withProjectOptions(yargs28.positional("id", { demandOption: true, describe: "Prompt ID to delete" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -3811,10 +4220,10 @@ var PromptUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a prompt",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Prompt file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Prompt file to put" })
       )
     )
   ),
@@ -3831,9 +4240,9 @@ var PromptModule = {
   command: "prompt <command>",
   aliases: ["dt"],
   describe: "Commands for AI Prompt definitions",
-  builder: (yargs27) => yargs27.command(PromptGetModule).command(PromptListModule).command(PromptPullModule).command(PromptPushModule).command(PromptRemoveModule).command(PromptUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(PromptGetModule).command(PromptListModule).command(PromptPullModule).command(PromptPushModule).command(PromptRemoveModule).command(PromptUpdateModule).demandCommand(),
   handler: () => {
-    yargs9.help();
+    yargs10.help();
   }
 };
 
@@ -3842,28 +4251,28 @@ var CanvasCommand = {
   command: "canvas <command>",
   aliases: ["cv", "pm", "presentation"],
   describe: "Uniform Canvas commands",
-  builder: (yargs27) => yargs27.command(CompositionModule).command(ComponentModule).command(DataTypeModule).command(CategoryModule).command(PatternModule).command(ContentTypeModule).command(EntryModule).command(PromptModule).command(AssetModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(CompositionModule).command(ComponentModule).command(DataTypeModule).command(CategoryModule).command(PatternModule).command(ContentTypeModule).command(EntryModule).command(PromptModule).command(AssetModule).command(LocaleModule).demandCommand(),
   handler: () => {
-    yargs10.showHelp();
+    yargs11.showHelp();
   }
 };
 
 // src/commands/context/index.ts
-import yargs17 from "yargs";
+import yargs18 from "yargs";
 
 // src/commands/context/commands/aggregate.ts
-import yargs11 from "yargs";
+import yargs12 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Aggregate public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Aggregate public ID to fetch" })
         )
       )
     )
@@ -3887,7 +4296,7 @@ var AggregateListModule = {
   command: "list",
   describe: "List aggregates",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAggregateClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -3953,11 +4362,11 @@ function writeContextPackage(filename, packageContents) {
 var AggregatePullModule = {
   command: "pull <directory>",
   describe: "Pulls all aggregates to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -3991,7 +4400,8 @@ var AggregatePullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAggregateClient3({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4022,6 +4432,7 @@ var AggregatePullModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -4032,11 +4443,11 @@ import { UncachedAggregateClient as UncachedAggregateClient4 } from "@uniformdev
 var AggregatePushModule = {
   command: "push <directory>",
   describe: "Pushes all aggregates from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -4063,7 +4474,8 @@ var AggregatePushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAggregateClient4({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4089,6 +4501,7 @@ var AggregatePushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
     await target.complete();
@@ -4101,10 +4514,10 @@ var AggregateRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an aggregate",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Aggregate public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Aggregate public ID to delete" })
       )
     )
   ),
@@ -4121,10 +4534,10 @@ var AggregateUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update an aggregate",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Aggregate file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Aggregate file to put" })
       )
     )
   ),
@@ -4141,25 +4554,25 @@ var AggregateModule = {
   command: "aggregate <command>",
   aliases: ["agg", "intent", "audience"],
   describe: "Commands for Context aggregates (intents, audiences)",
-  builder: (yargs27) => yargs27.command(AggregatePullModule).command(AggregatePushModule).command(AggregateGetModule).command(AggregateRemoveModule).command(AggregateListModule).command(AggregateUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(AggregatePullModule).command(AggregatePushModule).command(AggregateGetModule).command(AggregateRemoveModule).command(AggregateListModule).command(AggregateUpdateModule).demandCommand(),
   handler: () => {
-    yargs11.help();
+    yargs12.help();
   }
 };
 
 // src/commands/context/commands/enrichment.ts
-import yargs12 from "yargs";
+import yargs13 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: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Enrichment category public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Enrichment category public ID to fetch" })
         )
       )
     )
@@ -4184,7 +4597,7 @@ var EnrichmentListModule = {
   command: "list",
   describe: "List enrichments",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedEnrichmentClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4285,11 +4698,11 @@ var createEnrichmentValueEngineDataSource = ({
 var EnrichmentPullModule = {
   command: "pull <directory>",
   describe: "Pulls all enrichments to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -4323,7 +4736,8 @@ var EnrichmentPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedEnrichmentClient3({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4354,6 +4768,7 @@ var EnrichmentPullModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -4364,11 +4779,11 @@ 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -4395,7 +4810,8 @@ var EnrichmentPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedEnrichmentClient4({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4421,6 +4837,7 @@ var EnrichmentPushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -4432,10 +4849,10 @@ var EnrichmentRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an enrichment category and its values",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Enrichment category public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Enrichment category public ID to delete" })
       )
     )
   ),
@@ -4451,14 +4868,14 @@ var EnrichmentModule = {
   command: "enrichment <command>",
   aliases: ["enr"],
   describe: "Commands for Context enrichments",
-  builder: (yargs27) => yargs27.command(EnrichmentPullModule).command(EnrichmentPushModule).command(EnrichmentGetModule).command(EnrichmentRemoveModule).command(EnrichmentListModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(EnrichmentPullModule).command(EnrichmentPushModule).command(EnrichmentGetModule).command(EnrichmentRemoveModule).command(EnrichmentListModule).demandCommand(),
   handler: () => {
-    yargs12.help();
+    yargs13.help();
   }
 };
 
 // src/commands/context/commands/manifest.ts
-import yargs13 from "yargs";
+import yargs14 from "yargs";
 
 // src/commands/context/commands/manifest/get.ts
 import { ApiClientError, UncachedManifestClient } from "@uniformdev/context/api";
@@ -4469,10 +4886,10 @@ var ManifestGetModule = {
   command: "get [output]",
   aliases: ["dl", "download"],
   describe: "Download the Uniform Context manifest for a project",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.option("preview", {
+        yargs28.option("preview", {
           describe: "If set, fetches the unpublished preview manifest (The API key must have permission)",
           default: false,
           type: "boolean",
@@ -4534,7 +4951,7 @@ import { exit as exit2 } from "process";
 var ManifestPublishModule = {
   command: "publish",
   describe: "Publish the Uniform Context manifest for a project",
-  builder: (yargs27) => withConfiguration(withApiOptions(withProjectOptions(yargs27))),
+  builder: (yargs28) => withConfiguration(withApiOptions(withProjectOptions(yargs28))),
   handler: async ({ apiKey, apiHost, proxy, project }) => {
     const fetch3 = nodeFetchProxy(proxy);
     try {
@@ -4567,25 +4984,25 @@ var ManifestModule = {
   command: "manifest <command>",
   describe: "Commands for context manifests",
   aliases: ["man"],
-  builder: (yargs27) => yargs27.command(ManifestGetModule).command(ManifestPublishModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ManifestGetModule).command(ManifestPublishModule).demandCommand(),
   handler: () => {
-    yargs13.help();
+    yargs14.help();
   }
 };
 
 // src/commands/context/commands/quirk.ts
-import yargs14 from "yargs";
+import yargs15 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Quirk public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Quirk public ID to fetch" })
         )
       )
     )
@@ -4609,11 +5026,11 @@ var QuirkListModule = {
   command: "list",
   describe: "List quirks",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.option("withIntegrations", {
+          yargs28.option("withIntegrations", {
             alias: ["i"],
             describe: "Whether to include meta-quirks created by integrations in the list. Defaults to false.",
             type: "boolean"
@@ -4670,11 +5087,11 @@ function createQuirkEngineDataSource({
 var QuirkPullModule = {
   command: "pull <directory>",
   describe: "Pulls all quirks to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -4708,7 +5125,8 @@ var QuirkPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedQuirkClient3({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4739,6 +5157,7 @@ var QuirkPullModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -4749,11 +5168,11 @@ 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -4780,7 +5199,8 @@ var QuirkPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedQuirkClient4({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4806,6 +5226,7 @@ var QuirkPushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -4817,10 +5238,10 @@ var QuirkRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a quirk",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Quirk public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Quirk public ID to delete" })
       )
     )
   ),
@@ -4837,10 +5258,10 @@ var QuirkUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a quirk",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Quirk file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Quirk file to put" })
       )
     )
   ),
@@ -4857,25 +5278,25 @@ var QuirkModule = {
   command: "quirk <command>",
   aliases: ["qk"],
   describe: "Commands for Context quirks",
-  builder: (yargs27) => yargs27.command(QuirkPullModule).command(QuirkPushModule).command(QuirkGetModule).command(QuirkRemoveModule).command(QuirkListModule).command(QuirkUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(QuirkPullModule).command(QuirkPushModule).command(QuirkGetModule).command(QuirkRemoveModule).command(QuirkListModule).command(QuirkUpdateModule).demandCommand(),
   handler: () => {
-    yargs14.help();
+    yargs15.help();
   }
 };
 
 // src/commands/context/commands/signal.ts
-import yargs15 from "yargs";
+import yargs16 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Signal public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Signal public ID to fetch" })
         )
       )
     )
@@ -4899,7 +5320,7 @@ var SignalListModule = {
   command: "list",
   describe: "List signals",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedSignalClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4948,11 +5369,11 @@ function createSignalEngineDataSource({
 var SignalPullModule = {
   command: "pull <directory>",
   describe: "Pulls all signals to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -4986,7 +5407,8 @@ var SignalPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedSignalClient3({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -5017,6 +5439,7 @@ var SignalPullModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -5027,11 +5450,11 @@ 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -5058,7 +5481,8 @@ var SignalPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedSignalClient4({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -5084,6 +5508,7 @@ var SignalPushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -5095,10 +5520,10 @@ var SignalRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a signal",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Signal public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Signal public ID to delete" })
       )
     )
   ),
@@ -5115,10 +5540,10 @@ var SignalUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a signal",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Signal file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Signal file to put" })
       )
     )
   ),
@@ -5135,25 +5560,25 @@ var SignalModule = {
   command: "signal <command>",
   aliases: ["sig"],
   describe: "Commands for Context signals",
-  builder: (yargs27) => yargs27.command(SignalPullModule).command(SignalPushModule).command(SignalGetModule).command(SignalRemoveModule).command(SignalListModule).command(SignalUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(SignalPullModule).command(SignalPushModule).command(SignalGetModule).command(SignalRemoveModule).command(SignalListModule).command(SignalUpdateModule).demandCommand(),
   handler: () => {
-    yargs15.help();
+    yargs16.help();
   }
 };
 
 // src/commands/context/commands/test.ts
-import yargs16 from "yargs";
+import yargs17 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Test public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Test public ID to fetch" })
         )
       )
     )
@@ -5177,7 +5602,7 @@ var TestListModule = {
   command: "list",
   describe: "List tests",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedTestClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -5226,11 +5651,11 @@ function createTestEngineDataSource({
 var TestPullModule = {
   command: "pull <directory>",
   describe: "Pulls all tests to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -5264,7 +5689,8 @@ var TestPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedTestClient3({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -5295,6 +5721,7 @@ var TestPullModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -5305,11 +5732,11 @@ 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -5336,7 +5763,8 @@ var TestPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedTestClient4({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -5362,6 +5790,7 @@ var TestPushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -5373,10 +5802,10 @@ var TestRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a test",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Test public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Test public ID to delete" })
       )
     )
   ),
@@ -5393,9 +5822,9 @@ var TestUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a test",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("filename", { demandOption: true, describe: "Test file to put" }))
+      withProjectOptions(yargs28.positional("filename", { demandOption: true, describe: "Test file to put" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -5410,9 +5839,9 @@ var TestUpdateModule = {
 var TestModule = {
   command: "test <command>",
   describe: "Commands for Context A/B tests",
-  builder: (yargs27) => yargs27.command(TestPullModule).command(TestPushModule).command(TestGetModule).command(TestRemoveModule).command(TestListModule).command(TestUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(TestPullModule).command(TestPushModule).command(TestGetModule).command(TestRemoveModule).command(TestListModule).command(TestUpdateModule).demandCommand(),
   handler: () => {
-    yargs16.help();
+    yargs17.help();
   }
 };
 
@@ -5421,9 +5850,9 @@ var ContextCommand = {
   command: "context <command>",
   aliases: ["ctx"],
   describe: "Uniform Context commands",
-  builder: (yargs27) => yargs27.command(ManifestModule).command(SignalModule).command(EnrichmentModule).command(AggregateModule).command(QuirkModule).command(TestModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ManifestModule).command(SignalModule).command(EnrichmentModule).command(AggregateModule).command(QuirkModule).command(TestModule).demandCommand(),
   handler: () => {
-    yargs17.showHelp();
+    yargs18.showHelp();
   }
 };
 
@@ -5451,7 +5880,7 @@ import { PostHog } from "posthog-node";
 // package.json
 var package_default = {
   name: "@uniformdev/cli",
-  version: "19.79.0",
+  version: "19.92.1",
   description: "Uniform command line interface tool",
   license: "SEE LICENSE IN LICENSE.txt",
   main: "./cli.js",
@@ -5486,7 +5915,7 @@ var package_default = {
     "graphql-request": "6.1.0",
     "https-proxy-agent": "^7.0.0",
     "image-size": "^1.0.2",
-    inquirer: "9.2.11",
+    inquirer: "9.2.12",
     "isomorphic-git": "1.24.5",
     "isomorphic-unfetch": "^4.0.0",
     "js-yaml": "^4.1.0",
@@ -5503,13 +5932,13 @@ var package_default = {
     zod: "3.22.4"
   },
   devDependencies: {
-    "@types/diff": "5.0.8",
-    "@types/inquirer": "9.0.3",
+    "@types/diff": "5.0.9",
+    "@types/inquirer": "9.0.7",
     "@types/js-yaml": "4.0.9",
     "@types/jsonwebtoken": "9.0.5",
-    "@types/lodash.isequalwith": "4.4.7",
-    "@types/node": "18.17.18",
-    "@types/yargs": "17.0.24"
+    "@types/lodash.isequalwith": "4.4.9",
+    "@types/node": "18.19.3",
+    "@types/yargs": "17.0.32"
   },
   bin: {
     uniform: "./cli.js"
@@ -6461,10 +6890,10 @@ var NewMeshCmd = {
 };
 
 // src/commands/optimize/index.ts
-import yargs19 from "yargs";
+import yargs20 from "yargs";
 
 // src/commands/optimize/manifest.ts
-import yargs18 from "yargs";
+import yargs19 from "yargs";
 
 // src/commands/optimize/manifest/download.ts
 import { gray as gray4, green as green3, red as red5, yellow as yellow2 } from "colorette";
@@ -6479,7 +6908,7 @@ var UniformBaseUrl = "https://uniform.app";
 var module = {
   command: "download [output]",
   describe: "Download intent manifest",
-  builder: (yargs27) => yargs27.option("apiKey", {
+  builder: (yargs28) => yargs28.option("apiKey", {
     alias: "k",
     demandOption: true,
     string: true,
@@ -6580,10 +7009,10 @@ var module2 = {
   command: "manifest <command>",
   describe: "Intent manifest commands",
   builder: () => {
-    return yargs18.command(download_default);
+    return yargs19.command(download_default);
   },
   handler: () => {
-    yargs18.showHelp();
+    yargs19.showHelp();
   }
 };
 var manifest_default = module2;
@@ -6594,29 +7023,29 @@ var OptimizeCommand = {
   aliases: ["opt"],
   describe: "Uniform Optimize commands",
   builder: () => {
-    return yargs19.command(manifest_default);
+    return yargs20.command(manifest_default);
   },
   handler: () => {
-    yargs19.showHelp();
+    yargs20.showHelp();
   }
 };
 
 // src/commands/project-map/index.ts
-import yargs22 from "yargs";
+import yargs23 from "yargs";
 
 // src/commands/project-map/commands/projectMapDefinition.ts
-import yargs20 from "yargs";
+import yargs21 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: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "ProjectMap UUID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "ProjectMap UUID to fetch" })
         )
       )
     )
@@ -6640,7 +7069,7 @@ var ProjectMapDefinitionListModule = {
   command: "list",
   describe: "List of project maps",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedProjectMapClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -6697,11 +7126,11 @@ function createProjectMapDefinitionEngineDataSource({
 var ProjectMapDefinitionPullModule = {
   command: "pull <directory>",
   describe: "Pulls all project maps to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -6735,7 +7164,8 @@ var ProjectMapDefinitionPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedProjectMapClient3({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -6766,7 +7196,7 @@ var ProjectMapDefinitionPullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -6777,11 +7207,11 @@ 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -6808,7 +7238,8 @@ var ProjectMapDefinitionPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedProjectMapClient4({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -6834,6 +7265,7 @@ var ProjectMapDefinitionPushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -6845,9 +7277,9 @@ var ProjectMapDefinitionRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a project map",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("id", { demandOption: true, describe: " UUID to delete" }))
+      withProjectOptions(yargs28.positional("id", { demandOption: true, describe: " UUID to delete" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -6863,10 +7295,10 @@ var ProjectMapDefinitionUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a project map",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Project map file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Project map file to put" })
       )
     )
   ),
@@ -6882,25 +7314,25 @@ var ProjectMapDefinitionUpdateModule = {
 var ProjectMapDefinitionModule = {
   command: "definition <command>",
   describe: "Commands for ProjectMap Definitions",
-  builder: (yargs27) => yargs27.command(ProjectMapDefinitionPullModule).command(ProjectMapDefinitionPushModule).command(ProjectMapDefinitionGetModule).command(ProjectMapDefinitionRemoveModule).command(ProjectMapDefinitionListModule).command(ProjectMapDefinitionUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ProjectMapDefinitionPullModule).command(ProjectMapDefinitionPushModule).command(ProjectMapDefinitionGetModule).command(ProjectMapDefinitionRemoveModule).command(ProjectMapDefinitionListModule).command(ProjectMapDefinitionUpdateModule).demandCommand(),
   handler: () => {
-    yargs20.help();
+    yargs21.help();
   }
 };
 
 // src/commands/project-map/commands/projectMapNode.ts
-import yargs21 from "yargs";
+import yargs22 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to fetch" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to fetch from" })
+          yargs28.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to fetch" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to fetch from" })
         )
       )
     )
@@ -6926,11 +7358,11 @@ var ProjectMapNodeListModule = {
   command: "list <projectMapId>",
   describe: "List project map nodes",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("projectMapId", {
+          yargs28.positional("projectMapId", {
             demandOption: true,
             describe: "ProjectMap UUID to fetch from"
           })
@@ -7001,11 +7433,11 @@ function createProjectMapNodeEngineDataSource({
 var ProjectMapNodePullModule = {
   command: "pull <directory>",
   describe: "Pulls all project maps nodes to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -7039,7 +7471,8 @@ var ProjectMapNodePullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedProjectMapClient9({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -7074,7 +7507,7 @@ var ProjectMapNodePullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -7085,11 +7518,11 @@ 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -7116,7 +7549,8 @@ var ProjectMapNodePushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedProjectMapClient10({
@@ -7151,6 +7585,7 @@ var ProjectMapNodePushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -7162,10 +7597,10 @@ var ProjectMapNodeRemoveModule = {
   command: "remove <id> <projectMapId>",
   aliases: ["delete", "rm"],
   describe: "Delete a project map node",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to delete" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to delete from" })
+        yargs28.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to delete" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to delete from" })
       )
     )
   ),
@@ -7182,10 +7617,10 @@ var ProjectMapNodeUpdateModule = {
   command: "update <filename> <projectMapId>",
   aliases: ["put"],
   describe: "Insert or update a project map node",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "ProjectMap node file with nodes data" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to put into" })
+        yargs28.positional("filename", { demandOption: true, describe: "ProjectMap node file with nodes data" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to put into" })
       )
     )
   ),
@@ -7201,9 +7636,9 @@ var ProjectMapNodeUpdateModule = {
 var ProjectMapNodeModule = {
   command: "node <command>",
   describe: "Commands for ProjectMap Nodes",
-  builder: (yargs27) => yargs27.command(ProjectMapNodePullModule).command(ProjectMapNodePushModule).command(ProjectMapNodeGetModule).command(ProjectMapNodeRemoveModule).command(ProjectMapNodeListModule).command(ProjectMapNodeUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ProjectMapNodePullModule).command(ProjectMapNodePushModule).command(ProjectMapNodeGetModule).command(ProjectMapNodeRemoveModule).command(ProjectMapNodeListModule).command(ProjectMapNodeUpdateModule).demandCommand(),
   handler: () => {
-    yargs21.help();
+    yargs22.help();
   }
 };
 
@@ -7212,28 +7647,28 @@ var ProjectMapCommand = {
   command: "project-map <command>",
   aliases: ["prm"],
   describe: "Uniform ProjectMap commands",
-  builder: (yargs27) => yargs27.command(ProjectMapNodeModule).command(ProjectMapDefinitionModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ProjectMapNodeModule).command(ProjectMapDefinitionModule).demandCommand(),
   handler: () => {
-    yargs22.showHelp();
+    yargs23.showHelp();
   }
 };
 
 // src/commands/redirect/index.ts
-import yargs24 from "yargs";
+import yargs25 from "yargs";
 
 // src/commands/redirect/commands/redirect.ts
-import yargs23 from "yargs";
+import yargs24 from "yargs";
 
 // src/commands/redirect/commands/RedirectDefinition/get.ts
 import { UncachedRedirectClient } from "@uniformdev/redirect";
 var RedirectDefinitionGetModule = {
   command: "get <id>",
   describe: "Fetch a redirect",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Redirect UUID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Redirect UUID to fetch" })
         )
       )
     )
@@ -7257,7 +7692,7 @@ var RedirectDefinitionListModule = {
   command: "list",
   describe: "List of redirects",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedRedirectClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -7323,11 +7758,11 @@ function createRedirectDefinitionEngineDataSource({
 var RedirectDefinitionPullModule = {
   command: "pull <directory>",
   describe: "Pulls all redirects to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.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", {
@@ -7361,7 +7796,8 @@ var RedirectDefinitionPullModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedRedirectClient3({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -7393,7 +7829,7 @@ var RedirectDefinitionPullModule = {
       target,
       mode,
       whatIf,
-      allowEmptySource: true,
+      allowEmptySource: allowEmptySource ?? true,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -7404,11 +7840,11 @@ 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: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read redirects from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -7435,7 +7871,8 @@ var RedirectDefinitionPushModule = {
     mode,
     whatIf,
     project: projectId,
-    diff: diffMode
+    diff: diffMode,
+    allowEmptySource
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedRedirectClient4({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -7461,6 +7898,7 @@ var RedirectDefinitionPushModule = {
       target,
       mode,
       whatIf,
+      allowEmptySource,
       log: createSyncEngineConsoleLogger({ diffMode })
     });
   }
@@ -7472,9 +7910,9 @@ var RedirectDefinitionRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a redirect",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("id", { demandOption: true, describe: " UUID to delete" }))
+      withProjectOptions(yargs28.positional("id", { demandOption: true, describe: " UUID to delete" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -7490,10 +7928,10 @@ var RedirectDefinitionUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a redirect",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Redirect file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Redirect file to put" })
       )
     )
   ),
@@ -7509,9 +7947,9 @@ var RedirectDefinitionUpdateModule = {
 var RedirectDefinitionModule = {
   command: "definition <command>",
   describe: "Commands for Redirect Definitions",
-  builder: (yargs27) => yargs27.command(RedirectDefinitionPullModule).command(RedirectDefinitionPushModule).command(RedirectDefinitionGetModule).command(RedirectDefinitionRemoveModule).command(RedirectDefinitionListModule).command(RedirectDefinitionUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(RedirectDefinitionPullModule).command(RedirectDefinitionPushModule).command(RedirectDefinitionGetModule).command(RedirectDefinitionRemoveModule).command(RedirectDefinitionListModule).command(RedirectDefinitionUpdateModule).demandCommand(),
   handler: () => {
-    yargs23.help();
+    yargs24.help();
   }
 };
 
@@ -7520,14 +7958,14 @@ var RedirectCommand = {
   command: "redirect <command>",
   aliases: ["red"],
   describe: "Uniform Redirect commands",
-  builder: (yargs27) => yargs27.command(RedirectDefinitionModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(RedirectDefinitionModule).demandCommand(),
   handler: () => {
-    yargs24.showHelp();
+    yargs25.showHelp();
   }
 };
 
 // src/commands/sync/index.ts
-import yargs25 from "yargs";
+import yargs26 from "yargs";
 
 // src/commands/sync/commands/util.ts
 import ora2 from "ora";
@@ -7546,10 +7984,12 @@ function spin(entityType) {
     stop: () => {
       spinner.stop();
       console.log = consoleLog;
+      return spinner;
     },
     succeed() {
       spinner.succeed();
       console.log = consoleLog;
+      return spinner;
     }
   };
 }
@@ -7558,11 +7998,11 @@ function spin(entityType) {
 var SyncPullModule = {
   command: "pull",
   describe: "Pulls whole project to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.option("what-if", {
+          yargs28.option("what-if", {
             alias: ["w"],
             describe: "What-if mode reports what would be done but changes no files",
             default: false,
@@ -7573,8 +8013,11 @@ var SyncPullModule = {
     )
   ),
   handler: async ({ serialization, ...otherParams }) => {
+    var _a;
     const config2 = serialization;
     const enabledEntities = Object.entries({
+      locale: LocalePullModule,
+      asset: AssetPullModule,
       category: CategoryPullModule,
       dataType: DataTypePullModule,
       prompt: PromptPullModule,
@@ -7590,11 +8033,10 @@ var SyncPullModule = {
       projectMapNode: ProjectMapNodePullModule,
       redirect: RedirectDefinitionPullModule,
       entry: EntryPullModule,
-      contentType: ContentTypePullModule,
-      asset: AssetPullModule
+      contentType: ContentTypePullModule
     }).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;
+      var _a2, _b, _c, _d, _e, _f;
+      return Boolean((_a2 = config2.entitiesConfig) == null ? void 0 : _a2[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;
     });
     if (enabledEntities.length === 0) {
       throw new Error(
@@ -7603,15 +8045,20 @@ var SyncPullModule = {
     }
     for (const [entityType, module3] of enabledEntities) {
       const spinner = spin(entityType);
+      const entityConfigSupportsPullState = (entityConfig2) => {
+        return entityConfig2 !== void 0 && "state" in entityConfig2;
+      };
+      const entityConfig = (_a = config2.entitiesConfig) == null ? void 0 : _a[entityType];
       try {
         await module3.handler({
           ...otherParams,
-          state: 0,
+          state: entityConfigSupportsPullState(entityConfig) ? entityConfig.state ?? 0 : 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)
+          directory: getPullFilename(entityType, config2),
+          allowEmptySource: config2.allowEmptySource
         });
         spinner.succeed();
       } catch (e) {
@@ -7649,11 +8096,11 @@ var getFormat = (entityType, config2) => {
 var SyncPushModule = {
   command: "push",
   describe: "Pushes whole project data from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.option("what-if", {
+          yargs28.option("what-if", {
             alias: ["w"],
             describe: "What-if mode reports what would be done but changes nothing",
             default: false,
@@ -7667,6 +8114,8 @@ var SyncPushModule = {
     var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
     const config2 = serialization;
     const enabledEntities = Object.entries({
+      locale: LocalePushModule,
+      asset: AssetPushModule,
       category: CategoryPushModule,
       dataType: DataTypePushModule,
       prompt: PromptPushModule,
@@ -7682,8 +8131,7 @@ var SyncPushModule = {
       projectMapNode: ProjectMapNodePushModule,
       redirect: RedirectDefinitionPushModule,
       contentType: ContentTypePushModule,
-      entry: EntryPushModule,
-      asset: AssetPushModule
+      entry: EntryPushModule
     }).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;
@@ -7703,7 +8151,8 @@ var SyncPushModule = {
           onlyCompositions: entityType === "composition" ? true : void 0,
           onlyPatterns: entityType === "pattern" ? true : void 0,
           mode: getPushMode(entityType, config2),
-          directory: getPushFilename(entityType, config2)
+          directory: getPushFilename(entityType, config2),
+          allowEmptySource: config2.allowEmptySource
         });
         spinner.succeed();
       } catch (e) {
@@ -7747,9 +8196,9 @@ var getFormat2 = (entityType, config2) => {
 var SyncCommand = {
   command: "sync <command>",
   describe: "Uniform Sync commands",
-  builder: (yargs27) => yargs27.command(SyncPullModule).command(SyncPushModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(SyncPullModule).command(SyncPushModule).demandCommand(),
   handler: () => {
-    yargs25.showHelp();
+    yargs26.showHelp();
   }
 };
 
@@ -8015,7 +8464,7 @@ First found was: v${firstVersion}`;
 
 // src/index.ts
 dotenv.config();
-var yarggery = yargs26(hideBin(process.argv));
+var yarggery = yargs27(hideBin(process.argv));
 var inlineConfigurationFilePath = "config" in yarggery.argv && yarggery.argv.config;
 var configuration = loadConfig(inlineConfigurationFilePath || null);
 yarggery.option("verbose", {