webstudio 0.274.0 → 0.274.2

package/lib/{cli-DfnIxogH.js → cli-B3sZoyrv.js}

@@ -16,7 +16,7 @@ import path, { join, dirname, resolve, sep, normalize as normalize$2, basename,
 import envPaths from "env-paths";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
-import fs, { access, constants, writeFile, mkdir, readFile, rename, rm, copyFile, readdir, cp, mkdtemp } from "node:fs/promises";
+import fs, { access, constants, writeFile, readFile, mkdir, rename, rm, copyFile, readdir, cp, mkdtemp } from "node:fs/promises";
 import { text, isCancel, cancel, log, spinner, confirm, select as select$1 } from "@clack/prompts";
 import { createTRPCUntypedClient, httpBatchLink } from "@trpc/client";
 import { Upload } from "tus-js-client";
@@ -26,9 +26,9 @@ import { constants as constants$1, createWriteStream, existsSync } from "node:fs
 import { pipeline } from "node:stream/promises";
 import pLimit from "p-limit";
 import "warn-once";
+import { isDeepStrictEqual, promisify } from "node:util";
 import { pathToFileURL, fileURLToPath } from "node:url";
 import merge from "deepmerge";
-import { promisify } from "node:util";
 import { parseFragment, defaultTreeAdapter } from "parse5";
 import { kebabCase, camelCase } from "change-case";
 import reservedIdentifiers from "reserved-identifiers";
@@ -5139,6 +5139,10 @@ const getBundleVersion = (data) => {
   const version2 = data.bundleVersion;
   return typeof version2 === "number" || typeof version2 === "string" ? version2 : void 0;
 };
+const getBundleVersionMismatchMessage = ({
+  ignoreVersionCheckHint,
+  receivedVersion
+}) => `Project bundle format is incompatible. Expected version ${bundleVersion}, received ${receivedVersion ?? "missing"}. Sync with a compatible API/CLI version and retry, or ${ignoreVersionCheckHint}.`;
 const publicApiOperationDocumentation = [
   {
     command: "whoami",
@@ -7513,15 +7517,15 @@ const importProjectBundleWithAssets = async (params) => {
       if (missingAssets.length !== assetNames.length) {
         throw error;
       }
-      const readAssetData2 = params.skipAssets === true ? void 0 : params.readAssetData;
-      if (readAssetData2 === void 0) {
+      const readAssetData = params.skipAssets === true ? void 0 : params.readAssetData;
+      if (readAssetData === void 0) {
         throw error;
       }
       (_c = params.onMissingAssets) == null ? void 0 : _c.call(params, missingAssets);
       await uploadAssets({
         ...params,
         assets: missingAssets,
-        readAssetData: readAssetData2
+        readAssetData
       });
     }
   }
@@ -7631,7 +7635,7 @@ class HandledCliError extends Error {
 }
 const isHandledCliError = (error) => error instanceof HandledCliError;
 const name$N = "webstudio";
-const version = "0.274.0";
+const version = "0.274.2";
 const description = "Webstudio CLI";
 const author = "Webstudio <github@webstudio.is>";
 const homepage = "https://webstudio.is";
@@ -7713,6 +7717,9 @@ const getLocalAssetPath = (assetName, assetsDirectory = LOCAL_ASSETS_DIR) => {
   }
   throw new Error(`Asset path escapes ${assetsDirectory}: ${assetName}`);
 };
+const createLocalAssetDataReader = (readFile2, assetsDirectory) => async (asset2) => await readFile2(
+  getLocalAssetPath(asset2.name, assetsDirectory)
+);
 const downloadUrlToFile = async (url, filePath) => {
   const tempFilePath = `${filePath}.tmp`;
   if (await isFileExists(filePath)) {
@@ -7836,7 +7843,7 @@ const resolveApiConnection = async (dependencies2 = defaultApiConnectionDependen
     projectId: localConfig.projectId
   };
 };
-const defaultDependencies$2 = {
+const defaultDependencies$3 = {
   createFileIfNotExists,
   downloadAssetFiles,
   isFileExists,
@@ -7857,7 +7864,7 @@ const syncOptions = (yargs) => yargs.option("buildId", {
   type: "string",
   describe: "[Experimental] Service token"
 });
-const sync = async (options, dependencies2 = defaultDependencies$2) => {
+const sync = async (options, dependencies2 = defaultDependencies$3) => {
   const syncing = dependencies2.spinner();
   let project;
   syncing.start(`Synchronizing project bundle`);
@@ -7953,6 +7960,210 @@ const sync = async (options, dependencies2 = defaultDependencies$2) => {
   );
   syncing.stop("Project bundle synchronized successfully");
 };
+const LOCAL_AUTH_FILE = ".webstudio/auth.json";
+const createAuthConfigResources = (pages2) => {
+  var _a3;
+  return createWsAuthResources({
+    projectContent: (_a3 = pages2.meta) == null ? void 0 : _a3.auth,
+    pages: getAllPages(pages2).filter((page2) => page2.meta.auth !== void 0).map((page2) => ({
+      route: getPagePath(page2.id, pages2),
+      auth: page2.meta.auth
+    }))
+  });
+};
+const createAuthConfigContentFromBundle = (data) => createAuthConfigResources(migratePages(data.build.pages)).content;
+const assertAuthConfigMatchesBundle = ({
+  authFileContent,
+  data
+}) => {
+  let actual;
+  try {
+    actual = JSON.parse(authFileContent);
+  } catch {
+    throw new Error(`${LOCAL_AUTH_FILE} is invalid JSON`);
+  }
+  const expected = JSON.parse(createAuthConfigContentFromBundle(data));
+  if (isDeepStrictEqual(actual, expected) === false) {
+    throw new Error(`${LOCAL_AUTH_FILE} does not match .webstudio/data.json`);
+  }
+};
+const validateAuthConfigFile = async ({
+  data,
+  filePath
+}) => {
+  const authFileContent = await readFile(filePath, "utf8").catch((error) => {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return;
+    }
+    throw error;
+  });
+  if (authFileContent === void 0) {
+    return false;
+  }
+  assertAuthConfigMatchesBundle({ authFileContent, data });
+  return true;
+};
+const formatZodIssues = (issues) => issues.map((issue) => {
+  const path2 = issue.path.join(".");
+  return path2 === "" ? issue.message : `${path2}: ${issue.message}`;
+}).join(", ");
+const isInteractiveTerminal = () => stdin.isTTY === true && stdout.isTTY === true;
+const defaultDependencies$2 = {
+  importProjectBundleWithAssets,
+  loadJSONFile,
+  readFile,
+  text,
+  isInteractive: isInteractiveTerminal(),
+  log,
+  spinner
+};
+const missingDestinationMessage = "Please specify a destination share link with --to";
+const missingProjectBundleMessage = "Project bundle is missing. Please run webstudio sync before importing.";
+const invalidProjectBundleMessage = "Project bundle is invalid. Please run webstudio sync before importing.";
+const invalidAuthConfigMessage = "Project bundle auth config is invalid. Please run webstudio build before importing.";
+const invalidDestinationMessage = "Destination share link is invalid.";
+const importOptions = (yargs) => yargs.option("to", {
+  type: "string",
+  describe: "Share link with build permissions to import synced data into"
+}).option("assets-dir", {
+  type: "string",
+  default: LOCAL_ASSETS_DIR,
+  describe: "Directory containing local asset files referenced by the bundle"
+}).option("ignore-version-check", {
+  type: "boolean",
+  describe: "Import data without a compatible data version; import may fail if source and target API data formats differ"
+}).option("skip-assets", {
+  type: "boolean",
+  describe: "Import project data without uploading or importing asset files; referenced assets may be missing in the target project"
+}).check((options) => {
+  if (options.to === void 0 && isInteractiveTerminal() === false) {
+    return missingDestinationMessage;
+  }
+  return true;
+});
+const importProject = async (options, dependencies2 = defaultDependencies$2) => {
+  const importing = dependencies2.spinner();
+  importing.start("Importing project bundle");
+  if (options.to === void 0 && dependencies2.isInteractive === false) {
+    importing.stop(missingDestinationMessage, 2);
+    throw new HandledCliError();
+  }
+  importing.message(`Reading ${LOCAL_DATA_FILE}`);
+  let data;
+  try {
+    data = await dependencies2.loadJSONFile(
+      join(cwd(), LOCAL_DATA_FILE)
+    );
+  } catch {
+    importing.stop(invalidProjectBundleMessage, 2);
+    throw new HandledCliError();
+  }
+  if (data === null) {
+    importing.stop(missingProjectBundleMessage, 2);
+    throw new HandledCliError();
+  }
+  const localBundleVersion = getBundleVersion(data);
+  if (localBundleVersion !== bundleVersion && options.ignoreVersionCheck !== true) {
+    importing.stop(
+      getBundleVersionMismatchMessage({
+        ignoreVersionCheckHint: "pass --ignore-version-check if you know the source and target data formats are compatible",
+        receivedVersion: localBundleVersion
+      }),
+      2
+    );
+    throw new HandledCliError();
+  }
+  const parsedData = publishedProjectBundle.safeParse(data);
+  if (parsedData.success === false) {
+    importing.stop(
+      `${invalidProjectBundleMessage} Invalid fields: ${formatZodIssues(
+        parsedData.error.issues
+      )}`,
+      2
+    );
+    throw new HandledCliError();
+  }
+  const importData = parsedData.data;
+  importing.message(`Reading ${LOCAL_AUTH_FILE}`);
+  try {
+    if (await validateAuthConfigFile({
+      data: importData,
+      filePath: join(cwd(), LOCAL_AUTH_FILE)
+    })) {
+      dependencies2.log.info(`Read ${LOCAL_AUTH_FILE}`);
+    }
+  } catch (error) {
+    importing.stop(
+      error instanceof Error ? `${invalidAuthConfigMessage} ${error.message}` : invalidAuthConfigMessage,
+      2
+    );
+    throw new HandledCliError();
+  }
+  let destinationShareLink = options.to;
+  if (destinationShareLink === void 0 && dependencies2.isInteractive === true) {
+    importing.stop(`Read ${LOCAL_DATA_FILE}`);
+    const shareLink = await dependencies2.text({
+      message: "Please paste a destination share link with build permissions",
+      validate: validateShareLink
+    });
+    if (isCancel(shareLink)) {
+      cancel("Project import is cancelled");
+      throw new HandledCliError();
+    }
+    destinationShareLink = shareLink;
+    importing.start("Importing project bundle");
+  }
+  if (destinationShareLink === void 0) {
+    importing.stop(missingDestinationMessage, 2);
+    throw new HandledCliError();
+  }
+  let destination;
+  try {
+    destination = parseShareLink(destinationShareLink);
+  } catch {
+    importing.stop(invalidDestinationMessage, 2);
+    throw new HandledCliError();
+  }
+  dependencies2.log.info(`Read ${LOCAL_DATA_FILE}`);
+  dependencies2.log.info(`Destination project: ${destination.projectId}`);
+  dependencies2.log.info(`Destination origin: ${destination.origin}`);
+  const destinationRequest = {
+    projectId: destination.projectId,
+    authToken: destination.token,
+    origin: destination.origin,
+    headers: apiCompatibilityHeaders
+  };
+  try {
+    await dependencies2.importProjectBundleWithAssets({
+      ...destinationRequest,
+      data: importData,
+      ignoreVersionCheck: options.ignoreVersionCheck,
+      ...options.skipAssets === true ? { skipAssets: true } : {
+        readAssetData: createLocalAssetDataReader(
+          dependencies2.readFile,
+          options.assetsDir
+        )
+      },
+      onUploadAssets: (assets) => importing.message(`Uploading ${assets.length} assets`),
+      onMissingAssets: (assets) => importing.message(`Re-uploading ${assets.length} missing assets`),
+      onImportAttempt: () => importing.message(
+        `Waiting for API response while importing into ${destination.projectId}`
+      )
+    });
+  } catch (error) {
+    stopSpinnerWithError(
+      importing,
+      error,
+      "Unable to import project bundle",
+      "import"
+    );
+    throw new HandledCliError();
+  }
+  if (options.skipAssets === true) {
+    dependencies2.log.info("Skipped asset upload and asset rows");
+  }
+  importing.stop("Project imported successfully");
+};
 const getRemixSegment = (segment) => {
   var _a3, _b2;
   if (segment === "*") {
@@ -8666,17 +8877,6 @@ const generateWebstudioComponent = ({
 `;
   return generatedComponent;
 };
-const LOCAL_AUTH_FILE = ".webstudio/auth.json";
-const createAuthConfigResources = (pages2) => {
-  var _a3;
-  return createWsAuthResources({
-    projectContent: (_a3 = pages2.meta) == null ? void 0 : _a3.auth,
-    pages: getAllPages(pages2).filter((page2) => page2.meta.auth !== void 0).map((page2) => ({
-      route: getPagePath(page2.id, pages2),
-      auth: page2.meta.auth
-    }))
-  });
-};
 const BOOLEAN_ATTRIBUTES = /* @__PURE__ */ new Set([
   "async",
   "autofocus",
@@ -8788,13 +8988,9 @@ const htmlToJsx = (html2) => {
   }
   return result;
 };
-const formatZodIssues = (issues) => issues.map((issue) => {
-  const path2 = issue.path.join(".");
-  return path2 === "" ? issue.message : `${path2}: ${issue.message}`;
-}).join(", ");
-const createRemixFramework = async () => (await import("./framework-remix-B05uGrvd.js")).createFramework();
-const createReactRouterFramework = async () => (await import("./framework-react-router-CVBhO7ll.js")).createFramework();
-const createVikeSsgFramework = async () => (await import("./framework-vike-ssg-BOMCgE0f.js")).createFramework();
+const createRemixFramework = async () => (await import("./framework-remix-KhlqR_BH.js")).createFramework();
+const createReactRouterFramework = async () => (await import("./framework-react-router-BtDy2QPF.js")).createFramework();
+const createVikeSsgFramework = async () => (await import("./framework-vike-ssg-De0xD5T4.js")).createFramework();
 const mergeJsonInto = async (sourcePath, destinationPath) => {
   const sourceJson = await readFile(sourcePath, "utf8");
   const destinationJson = await readFile(destinationPath, "utf8").catch(
@@ -10837,10 +11033,38 @@ const previewInputSchema = {
     }
   }
 };
+const importInputSchema = {
+  ...emptyInputSchema,
+  description: "Import local .webstudio/data.json into another project using a destination share link with build permissions.",
+  properties: {
+    to: {
+      type: "string",
+      description: "Destination Builder share link with build permissions."
+    },
+    assetsDir: {
+      type: "string",
+      description: "Directory containing local asset files referenced by the bundle."
+    },
+    ignoreVersionCheck: {
+      type: "boolean",
+      description: "Import even when local bundle version differs from the current CLI/API contract."
+    },
+    skipAssets: {
+      type: "boolean",
+      description: "Import project data without uploading or importing asset files."
+    }
+  },
+  required: ["to"]
+};
 const mcpArgumentExamples = {
   "meta.guide": [{ brief: "Create a pricing page and style the hero" }],
   "meta.get_more_tools": [{ brief: "update-styles" }],
   refresh: [{ namespaces: ["pages", "instances", "styles"] }],
+  import: [
+    {
+      to: "https://p-destination-project-id.wstd.dev/?authToken=destination-token"
+    }
+  ],
   "preview.start": [{ host: "127.0.0.1", port: 5173 }],
   "preview.status": [{}],
   "list-pages": [{ includeFolders: true }],
@@ -11113,6 +11337,25 @@ const installOcrTool = {
     retryOnConflict: false
   }
 };
+const importTool = {
+  name: "import",
+  description: "Import the local synced project bundle into a destination project. Run sync first; pass a destination share link with build permissions.",
+  inputSchema: importInputSchema,
+  mcpExamples: getMcpExamples("import"),
+  annotations: {
+    command: "import",
+    operationId: "project.import",
+    method: "session",
+    permit: "build",
+    inputFields: ["to", "assetsDir", "ignoreVersionCheck", "skipAssets"],
+    localCapable: false,
+    serverOnly: true,
+    readNamespaces: [],
+    writeNamespaces: [],
+    invalidatesNamespaces: [],
+    retryOnConflict: false
+  }
+};
 const previewTools = [
   {
     name: "preview.start",
@@ -11179,6 +11422,7 @@ const listProjectSessionMcpTools = (operations, options = {}) => [
     ...tool,
     mcpExamples: getMcpExamples(tool.name)
   })),
+  ...options.includeImport ? [importTool] : [],
   ...options.includeScreenshot ? [screenshotTool] : [],
   ...options.includeScreenshotDiff ? [screenshotDiffTool] : [],
   ...options.includeInstallOcr ? [installOcrTool] : [],
@@ -11220,6 +11464,11 @@ const capabilityAreas = [
       "inspect"
     ]
   },
+  {
+    area: "project-lifecycle",
+    goal: "Refresh local project state and move synced project bundles between projects.",
+    tools: ["refresh", "reset-session", "import"]
+  },
   {
     area: "pages",
     goal: "Create, inspect, update, duplicate, delete, and organize pages and folders.",
@@ -11656,10 +11905,26 @@ const getPreviewInput = (input2) => {
     port
   };
 };
+const getImportInput = (input2) => {
+  if (isRecord(input2) === false) {
+    throw new Error("import input must be an object.");
+  }
+  if (typeof input2.to !== "string" || input2.to.length === 0) {
+    throw new Error("import requires destination share link in to.");
+  }
+  const assetsDir = typeof input2.assetsDir === "string" && input2.assetsDir.length > 0 ? input2.assetsDir : void 0;
+  return {
+    to: input2.to,
+    assetsDir,
+    ignoreVersionCheck: input2.ignoreVersionCheck === true,
+    skipAssets: input2.skipAssets === true
+  };
+};
 const createProjectSessionMcpCore = ({
   operations,
   createProjectSession: createProjectSession2,
   executeOperation,
+  importProject: importProject2,
   captureScreenshot: captureScreenshot2,
   diffScreenshots,
   installOcr,
@@ -11672,6 +11937,7 @@ const createProjectSessionMcpCore = ({
     operations.map((operation) => operation.command)
   );
   const listTools = () => listProjectSessionMcpTools(operations, {
+    includeImport: importProject2 !== void 0,
     includeScreenshot: captureScreenshot2 !== void 0,
     includeScreenshotDiff: diffScreenshots !== void 0,
     includeInstallOcr: installOcr !== void 0,
@@ -11752,6 +12018,9 @@ const createProjectSessionMcpCore = ({
         const session2 = getSession();
         return toCallResult(await session2.reset());
       }
+      if (name2 === "import" && importProject2 !== void 0) {
+        return toMetaResult(await importProject2(getImportInput(input2)));
+      }
       if (name2 === "screenshot" && captureScreenshot2 !== void 0) {
         return toMetaResult(await captureScreenshot2(getScreenshotInput(input2)));
       }
@@ -11810,6 +12079,7 @@ const createProjectSessionMcpServer = async ({
   operations,
   createProjectSession: createProjectSession2,
   executeOperation,
+  importProject: importProject2,
   captureScreenshot: captureScreenshot2,
   diffScreenshots,
   installOcr,
@@ -11822,6 +12092,7 @@ const createProjectSessionMcpServer = async ({
     operations,
     createProjectSession: createProjectSession2,
     executeOperation,
+    importProject: importProject2,
     captureScreenshot: captureScreenshot2,
     diffScreenshots,
     installOcr,
@@ -11903,7 +12174,7 @@ const createMcpStdioTransport = async ({
   return new StdioServerTransport(stdin2, stdout2);
 };
 const cliDocs = {
-  "api-use-cases": '# CLI API Use Cases\n\n## Link/configure one project\n\nCommands:\n\n- webstudio init --link <api-share-link> --json\n\nNotes:\n\n- Writes local project id and global origin/token config.\n\n## Identify current token\n\nCommands:\n\n- MCP tool: whoami {}\n\n## Check token permissions\n\nCommands:\n\n- webstudio permissions --json\n\n## Inspect project/build/version\n\nCommands:\n\n- MCP tool: inspect {}\n- MCP tool: snapshot {"include":["pages","instances","styles"]}\n\n## Discover CLI/API capabilities\n\nCommands:\n\n- webstudio schema api --json\n- webstudio man api --json\n- webstudio man llm --json\n- webstudio man mcp --json\n- MCP tool: meta.index {}\n- MCP tool: meta.guide {"brief":"Create a pricing page"}\n- MCP tool: meta.get_more_tools {"brief":"update-styles"}\n\nNotes:\n\n- Use `tools/list` for machine-readable MCP tool schemas.\n- Use `resources/list` and `resources/read` for longer MCP resources such as `webstudio://project/tools` and `webstudio://project/guide`.\n\n## Inspect and refresh MCP session cache\n\nCommands:\n\n- MCP tool: status {}\n- MCP tool: refresh {"namespaces":["pages","instances","styles"]}\n- MCP tool: reset-session {}\n\nNotes:\n\n- Use status before a task to understand the cached ProjectSession state.\n- Use refresh when project data may have changed outside the current MCP session.\n- Use reset-session when local cached state is corrupt or incompatible.\n\n## Visually verify rendered work with AI vision\n\nCommands:\n\n- MCP tool: preview.start {"host":"127.0.0.1","port":5173}\n- MCP tool: preview.status {}\n- MCP tool: screenshot {"path":"/","output":"current.png","viewport":{"width":1440,"height":900},"waitUntil":"load","waitForTimeout":250}\n- MCP tool: screenshot.diff {"baselinePath":"before.png","currentPath":"current.png","outputDir":".webstudio/screenshots"}\n- MCP tool: vision.install-ocr {"confirm":true}\n\nNotes:\n\n- Use this after page/content/style mutations and after generated project files are current so a vision-capable AI can see what was actually built.\n- Use waitForSelector when the rendered app has a reliable ready marker, waitUntil:"networkidle" for network-heavy pages, and waitForTimeout only for final visual settling.\n- For a fresh checkout, copied fixture, or newly generated app, run npm install or pnpm install in the generated project before preview.start or webstudio preview.\n- If preview fails with a missing generated-app command/package such as react-router or vite, install the generated app dependencies and retry.\n- When a baseline exists, use screenshot.diff to get changed regions, OCR textAnalysis, and diff artifact paths before deciding whether the result matches.\n- If screenshot.diff reports OCR unavailable and the user agrees to install it, call vision.install-ocr {"confirm":true}; otherwise continue with pixel diff and visual inspection.\n- Compare the PNG, OCR text evidence, and diff artifacts against the user\'s intent for layout, typography, colors, spacing, imagery, and responsive framing; then iterate with focused mutations.\n- Root CLI equivalent: webstudio preview --template ssg, then webstudio screenshot <url> --output current.png.\n\n## List pages\n\nCommands:\n\n- MCP tool: list-pages {"includeFolders":true}\n\n## Read page by id\n\nCommands:\n\n- MCP tool: get-page {"pageId":"<pageId>"}\n\n## Read page by path\n\nCommands:\n\n- MCP tool: get-page-by-path {"path":"/pricing"}\n\n## Create page\n\nCommands:\n\n- MCP tool: create-page {"name":"Pricing","path":"/pricing"}\n\n## Update page settings/metadata\n\nCommands:\n\n- MCP tool: update-page {"pageId":"<pageId>","title":"Pricing","description":"Plans","status":"200"}\n- MCP tool: update-page {"pageId":"<pageId>","auth":{"login":"<login>","password":"<password>"}}\n\n## Read project settings\n\nCommands:\n\n- MCP tool: get-project-settings {}\n\n## Update project settings\n\nCommands:\n\n- MCP tool: update-project-settings {"settings":"project-settings.json contents"}\n\n## List redirects\n\nCommands:\n\n- MCP tool: list-redirects {}\n\n## Create redirect\n\nCommands:\n\n- MCP tool: create-redirect {"oldPath":"/old","newPath":"/new","status":301}\n\n## Update redirect\n\nCommands:\n\n- MCP tool: update-redirect {"oldPath":"/old","newPath":"/newer","status":302}\n- MCP tool: update-redirect {"oldPath":"/old","status":null}\n\n## Delete redirect\n\nCommands:\n\n- MCP tool: delete-redirect {"oldPath":"/old"}\n\n## List breakpoints\n\nCommands:\n\n- MCP tool: list-breakpoints {}\n\n## Create breakpoint\n\nCommands:\n\n- MCP tool: create-breakpoint {"breakpointId":"tablet","label":"Tablet","maxWidth":991}\n\n## Update breakpoint\n\nCommands:\n\n- MCP tool: update-breakpoint {"breakpointId":"tablet","label":"Tablet","maxWidth":1023}\n- MCP tool: update-breakpoint {"breakpointId":"tablet","condition":null,"minWidth":768}\n- MCP tool: update-breakpoint {"breakpointId":"tablet","minWidth":null,"maxWidth":null,"condition":"(hover: hover)"}\n\n## Delete breakpoint\n\nCommands:\n\n- MCP tool: delete-breakpoint {"breakpointId":"tablet","confirm":true}\n\n## Duplicate page\n\nCommands:\n\n- MCP tool: duplicate-page {"pageId":"<pageId>","name":"Pricing Copy","path":"/pricing-copy"}\n\n## List page templates\n\nCommands:\n\n- MCP tool: list-page-templates {}\n\n## Create page from template\n\nCommands:\n\n- MCP tool: create-page-from-template {"templateId":"<templateId>","name":"Landing","path":"/landing"}\n\n## Delete page\n\nCommands:\n\n- MCP tool: delete-page {"pageId":"<pageId>"}\n\n## List folders\n\nCommands:\n\n- MCP tool: list-folders {"includePages":true}\n\n## Create folder\n\nCommands:\n\n- MCP tool: create-folder {"name":"Blog","slug":"blog"}\n\n## Update folder\n\nCommands:\n\n- MCP tool: update-folder {"folderId":"<folderId>","name":"Blog","slug":"blog"}\n\n## Delete folder\n\nCommands:\n\n- MCP tool: delete-folder {"folderId":"<folderId>"}\n\n## List element instances\n\nCommands:\n\n- MCP tool: list-instances {"pagePath":"/","maxDepth":3}\n\n## Inspect one element instance\n\nCommands:\n\n- MCP tool: inspect-instance {"instanceId":"<instanceId>","include":["props","styles","children"]}\n\n## Append/prepend/replace child elements\n\nCommands:\n\n- MCP tool: append-instance {"parentInstanceId":"<instanceId>","children":"children.json contents"}\n\n## Move elements\n\nCommands:\n\n- MCP tool: move-instance {"moves":"moves.json contents"}\n\n## Clone element subtree\n\nCommands:\n\n- MCP tool: clone-instance {"sourceInstanceId":"<instanceId>","parentInstanceId":"<targetParentId>"}\n\n## Delete element subtree\n\nCommands:\n\n- MCP tool: delete-instance {"instanceId":"<instanceId>"}\n\n## List text/expression children\n\nCommands:\n\n- MCP tool: list-texts {"pagePath":"/"}\n\n## Update text child\n\nCommands:\n\n- MCP tool: update-text {"instanceId":"<instanceId>","childIndex":0,"text":"Launch faster"}\n\n## Update props\n\nCommands:\n\n- MCP tool: update-props {"updates":"props.json contents"}\n\n## Delete props\n\nCommands:\n\n- MCP tool: delete-props {"deletions":"props.json contents"}\n\n## Bind props to expressions/resources/actions\n\nCommands:\n\n- MCP tool: bind-props {"bindings":"bindings.json contents"}\n\n## Read styles\n\nCommands:\n\n- MCP tool: get-styles {"instanceId":"<instanceId>","includeTokens":true}\n\n## Update local styles\n\nCommands:\n\n- MCP tool: update-styles {"updates":"styles.json contents"}\n\n## Delete local styles\n\nCommands:\n\n- MCP tool: delete-styles {"deletions":"styles.json contents"}\n\n## Replace matching style values\n\nCommands:\n\n- MCP tool: replace-styles {"replacements":"replace.json contents"}\n\n## List design tokens\n\nCommands:\n\n- MCP tool: list-design-tokens {"withUsage":true}\n\n## Create design tokens\n\nCommands:\n\n- MCP tool: create-design-token {"tokens":"tokens.json contents"}\n\n## Update design token styles\n\nCommands:\n\n- MCP tool: update-design-token-styles {"styleSourceId":"<tokenId>","updates":"styles.json contents"}\n\n## Delete design token styles\n\nCommands:\n\n- MCP tool: delete-design-token-styles {"styleSourceId":"<tokenId>","deletions":"styles.json contents"}\n\n## Attach design token to instances\n\nCommands:\n\n- MCP tool: attach-design-token {"styleSourceId":"<tokenId>","instanceIds":"instances.json contents"}\n\n## Detach design token from instances\n\nCommands:\n\n- MCP tool: detach-design-token {"styleSourceId":"<tokenId>","instanceIds":"instances.json contents"}\n\n## Extract design token from local styles\n\nCommands:\n\n- MCP tool: extract-design-token {"token":"token.json contents"}\n\n## List CSS variables\n\nCommands:\n\n- MCP tool: list-css-variables {"withUsage":true}\n\n## Define CSS variables\n\nCommands:\n\n- MCP tool: define-css-variable {"variables":"vars.json contents"}\n\n## Delete CSS variables\n\nCommands:\n\n- MCP tool: delete-css-variable {"names":"names.json contents","confirm":true}\n\n## Rewrite CSS variable references\n\nCommands:\n\n- MCP tool: rewrite-css-variable-refs {"variables":"variables.json contents"}\n\n## List data variables\n\nCommands:\n\n- MCP tool: list-variables {}\n\n## Create data variable\n\nCommands:\n\n- MCP tool: create-variable {"scopeInstanceId":"<instanceId>","name":"title","value":{"type":"string","value":"Hello"}}\n\n## Update data variable\n\nCommands:\n\n- MCP tool: update-variable {"variableId":"<variableId>","value":{"type":"json","value":{"count":1}}}\n\n## Delete data variable\n\nCommands:\n\n- MCP tool: delete-variable {"variableId":"<variableId>"}\n\n## List resources\n\nCommands:\n\n- MCP tool: list-resources {}\n\n## Create resource\n\nCommands:\n\n- MCP tool: create-resource {"name":"Posts","method":"get","url":"https://api.example.com/posts"}\n\n## Update resource\n\nCommands:\n\n- MCP tool: update-resource {"resourceId":"<resourceId>","url":"https://api.example.com/posts"}\n\n## Delete resource\n\nCommands:\n\n- MCP tool: delete-resource {"resourceId":"<resourceId>"}\n\n## List assets\n\nCommands:\n\n- MCP tool: list-assets {"withUsage":true}\n\n## Upload one asset\n\nCommands:\n\n- MCP tool: upload-asset {"asset":"asset.json contents","assetsDir":".webstudio/assets"}\n\n## Upload asset batch\n\nCommands:\n\n- MCP tool: upload-assets {"assets":"assets.json contents","assetsDir":".webstudio/assets"}\n\n## Find asset usage\n\nCommands:\n\n- MCP tool: find-asset-usage {"assetId":"<assetId>"}\n\n## Replace asset references\n\nCommands:\n\n- MCP tool: replace-asset {"fromAssetId":"<oldAssetId>","toAssetId":"<newAssetId>","confirm":true}\n\n## Delete assets\n\nCommands:\n\n- MCP tool: delete-asset {"assetId":"<assetId>","confirm":true}\n\n## Publish project\n\nCommands:\n\n- webstudio publish deploy --target production --json\n\n## List publishes\n\nCommands:\n\n- webstudio publish list --json\n\n## Check publish job\n\nCommands:\n\n- webstudio publish status --job <buildId> --json\n\n## Unpublish\n\nCommands:\n\n- webstudio publish unpublish --target production --confirm --json\n\n## List domains\n\nCommands:\n\n- webstudio domains list --json\n\n## Create domain\n\nCommands:\n\n- webstudio domains create --domain example.com --json\n\n## Update domain\n\nCommands:\n\n- webstudio domains update --domain-id <domainId> --domain www.example.com --json\n\n## Delete domain\n\nCommands:\n\n- webstudio domains delete --domain-id <domainId> --confirm --json\n\n## Verify domain\n\nCommands:\n\n- webstudio domains verify --domain-id <domainId> --json\n\n## Make arbitrary store-level changes\n\nCommands:\n\n- MCP tool: inspect {}\n- MCP tool: snapshot {"include":["<namespace>"]}\n- MCP tool: apply-patch {"baseVersion":"<version>","transactions":"patch.json contents"}\n\nNotes:\n\n- Use only when no semantic command exists.\n\n## Manage marketplace metadata\n\nCommands:\n\n- MCP tool: snapshot {"include":["marketplaceProduct"]}\n- MCP tool: apply-patch {"baseVersion":"<version>","transactions":"patch.json contents"}\n\nPatch namespaces:\n\n- marketplaceProduct\n\n## Search and inspect safely\n\nCommands:\n\n- MCP tool: list-instances {"pagePath":"/","maxDepth":5}\n- MCP tool: inspect-instance {"instanceId":"<instanceId>","include":["props","styles","children"]}\n- MCP tool: list-texts {"pagePath":"/"}\n- MCP tool: list-assets {"withUsage":true}\n- MCP tool: find-asset-usage {"assetId":"<assetId>"}\n- MCP tool: snapshot {"include":["pages","instances","props","resources","assets"]}\n\nNotes:\n\n- Use this for finding elements by label, type, href/resource patterns, HTML snippets, missing accessibility metadata, or asset usage.\n\n## Refactor targeted content\n\nCommands:\n\n- MCP tool: list-instances {"pagePath":"/"}\n- MCP tool: list-texts {"pagePath":"/"}\n- MCP tool: update-text {"instanceId":"<instanceId>","childIndex":0,"text":"Launch faster"}\n- MCP tool: update-props {"updates":"props.json contents"}\n- MCP tool: update-page {"pageId":"<pageId>","title":"Pricing","description":"Plans"}\n- MCP tool: update-resource {"resourceId":"<resourceId>","url":"https://api.example.com/posts"}\n- MCP tool: replace-asset {"fromAssetId":"<oldAssetId>","toAssetId":"<newAssetId>","confirm":true}\n- MCP tool: replace-styles {"replacements":"replace.json contents"}\n- MCP tool: rewrite-css-variable-refs {"variables":"variables.json contents"}\n\nNotes:\n\n- Use focused reads first, then mutate only matching instances, props, metadata, resource URLs, assets, or style references.\n\n## Optimize existing project\n\nCommands:\n\n- MCP tool: list-pages {"includeFolders":true}\n- MCP tool: update-page {"pageId":"<pageId>","title":"Pricing","description":"Plans"}\n- MCP tool: update-props {"updates":"props.json contents"}\n- MCP tool: list-breakpoints {}\n- MCP tool: update-breakpoint {"breakpointId":"tablet","maxWidth":1023}\n- MCP tool: get-styles {"instanceId":"<instanceId>","includeTokens":true}\n- MCP tool: update-styles {"updates":"styles.json contents"}\n- MCP tool: attach-design-token {"styleSourceId":"<tokenId>","instanceIds":"instances.json contents"}\n- MCP tool: update-project-settings {"settings":"project-settings.json contents"}\n\nNotes:\n\n- Use this for SEO metadata, accessibility labels, responsive behavior, token consistency, and project settings.\n\n## Connect external data\n\nCommands:\n\n- MCP tool: create-variable {"scopeInstanceId":"<instanceId>","name":"title","value":{"type":"string","value":"Hello"}}\n- MCP tool: create-resource {"name":"Posts","method":"get","url":"https://api.example.com/posts"}\n- MCP tool: update-resource {"resourceId":"<resourceId>","url":"https://api.example.com/posts"}\n- MCP tool: bind-props {"bindings":"bindings.json contents"}\n- MCP tool: append-instance {"parentInstanceId":"<instanceId>","children":"children.json contents"}\n\nNotes:\n\n- Use this for CMS sections, blog listings, Ghost/headless CMS pages, n8n-style integrations, and API URLs built from variables.\n\n## Support dynamic runtime behavior\n\nCommands:\n\n- MCP tool: append-instance {"parentInstanceId":"<instanceId>","children":"children.json contents"}\n- MCP tool: update-props {"updates":"props.json contents"}\n- MCP tool: bind-props {"bindings":"bindings.json contents"}\n- MCP tool: create-resource {"name":"Seats","method":"get","url":"https://api.example.com/seats"}\n- MCP tool: snapshot {"include":["instances","props","resources"]}\n- MCP tool: apply-patch {"baseVersion":"<version>","transactions":"patch.json contents"}\n\nNotes:\n\n- Use existing scripts/resources for behavior, then move presentational structure into editable Webstudio instances where possible.\n- There is no dedicated semantic command yet for converting script-generated UI into editable Webstudio structure.\n\n## Build authenticated pages\n\nCommands:\n\n- MCP tool: create-page {"name":"Account","path":"/account"}\n- MCP tool: update-page {"pageId":"<pageId>","auth":{"login":"<login>","password":"<password>"}}\n- MCP tool: create-resource {"name":"Session","method":"get","url":"https://api.example.com/session"}\n- MCP tool: create-variable {"scopeInstanceId":"<instanceId>","name":"user","value":{"type":"json","value":{}}}\n- MCP tool: update-props {"updates":"props.json contents"}\n- MCP tool: bind-props {"bindings":"bindings.json contents"}\n\nNotes:\n\n- Basic auth is semantic today. Provider-specific Supabase/Firebase setup still requires manual resources, props, embeds, or patches.\n\n## Generate from design input\n\nCommands:\n\n- MCP tool: create-page {"name":"Landing","path":"/landing"}\n- MCP tool: create-design-token {"tokens":"tokens.json contents"}\n- MCP tool: define-css-variable {"variables":"vars.json contents"}\n- MCP tool: append-instance {"parentInstanceId":"<instanceId>","children":"children.json contents"}\n- MCP tool: update-styles {"updates":"styles.json contents"}\n- MCP tool: preview.start {"host":"127.0.0.1","port":5173}\n- MCP tool: screenshot {"path":"/","output":"current.png","viewport":{"width":1440,"height":900},"waitUntil":"load","waitForTimeout":250}\n\nNotes:\n\n- Use this after external design interpretation. There is no dedicated import command for Figma, screenshots, Inception output, or design.md yet.\n\n## Cross-project maintenance\n\nCommands:\n\n- webstudio init --link <api-share-link> --json\n- webstudio permissions --json\n- webstudio mcp\n\nNotes:\n\n- Public API and CLI intentionally operate on one configured project at a time. Use an external script to loop over projects.\n\n# Known CLI Gaps\n\n## General project search and audit\n\nMissing:\nNo single semantic command searches across instance labels, props, hrefs, resource URLs, HTML embeds, asset references, and missing accessibility metadata.\n\nCurrent fallback:\nUse focused MCP reads such as list-instances, list-texts, list-assets, find-asset-usage, and snapshot.\n\nSuggested commands:\n\n- search-project\n- audit-accessibility\n- find-prop-usage\n\n## Save and manage page templates\n\nMissing:\nCLI can list page templates and create pages from existing templates, but cannot save a page as a template or update/delete templates semantically.\n\nCurrent fallback:\nUse MCP snapshot and apply-patch only when the template data model is understood.\n\nSuggested commands:\n\n- create-page-template\n- update-page-template\n- delete-page-template\n\n## Semantic marketplace metadata\n\nMissing:\nMarketplace metadata is only available through MCP snapshot/apply-patch, not dedicated semantic commands.\n\nCurrent fallback:\nUse MCP snapshot --include marketplaceProduct and apply-patch.\n\nSuggested commands:\n\n- get-marketplace\n- update-marketplace\n\n## Provider-specific authenticated pages\n\nMissing:\nCLI supports page basic auth and generic resources/props/embeds, but not guided Supabase/Firebase auth setup.\n\nCurrent fallback:\nCreate the page, resources, variables, props, and embeds manually with existing MCP semantic tools.\n\nSuggested commands:\n\n- setup-auth-page\n\n## Dynamic script/runtime integration helpers\n\nMissing:\nCLI can manipulate props/resources/embeds, but has no semantic workflow for converting script-generated UI into editable Webstudio structures.\n\nCurrent fallback:\nUse MCP append-instance, props, resources, and raw patch where necessary.\n\nSuggested commands:\n\n- integrate-runtime-ui\n\n## Generate from design input\n\nMissing:\nNo command imports Figma, screenshots, Inception output, or design.md and turns it into pages/tokens/layout.\n\nCurrent fallback:\nUse external generation, then apply semantic CLI commands or apply-patch.\n\nSuggested commands:\n\n- generate-from-design\n\n## Built-in cross-project maintenance\n\nMissing:\nPublic API and CLI intentionally operate on one configured project at a time; there is no built-in multi-project discovery or loop runner.\n\nCurrent fallback:\nRun the CLI from an external script that reconfigures one project/session at a time.\n\nSuggested commands:\n\n- none\n',
+  "api-use-cases": '# CLI API Use Cases\n\n## Link/configure one project\n\nCommands:\n\n- webstudio init --link <api-share-link> --json\n\nNotes:\n\n- Writes local project id and global origin/token config.\n\n## Import synced project bundle into another project\n\nCommands:\n\n- webstudio sync\n- webstudio import --to <destination-share-link>\n- MCP tool: import {"to":"<destination-share-link>"}\n\nNotes:\n\n- Imports local `.webstudio/data.json` into the destination project.\n- Destination share link must allow build/import access.\n- Use `--skip-assets` only when asset rows and files should not be imported.\n\n## Identify current token\n\nCommands:\n\n- MCP tool: whoami {}\n\n## Check token permissions\n\nCommands:\n\n- webstudio permissions --json\n\n## Inspect project/build/version\n\nCommands:\n\n- MCP tool: inspect {}\n- MCP tool: snapshot {"include":["pages","instances","styles"]}\n\n## Discover CLI/API capabilities\n\nCommands:\n\n- webstudio schema api --json\n- webstudio man api --json\n- webstudio man llm --json\n- webstudio man mcp --json\n- MCP tool: meta.index {}\n- MCP tool: meta.guide {"brief":"Create a pricing page"}\n- MCP tool: meta.get_more_tools {"brief":"update-styles"}\n\nNotes:\n\n- Use `tools/list` for machine-readable MCP tool schemas.\n- Use `resources/list` and `resources/read` for longer MCP resources such as `webstudio://project/tools` and `webstudio://project/guide`.\n\n## Inspect and refresh MCP session cache\n\nCommands:\n\n- MCP tool: status {}\n- MCP tool: refresh {"namespaces":["pages","instances","styles"]}\n- MCP tool: reset-session {}\n\nNotes:\n\n- Use status before a task to understand the cached ProjectSession state.\n- Use refresh when project data may have changed outside the current MCP session.\n- Use reset-session when local cached state is corrupt or incompatible.\n\n## Visually verify rendered work with AI vision\n\nCommands:\n\n- MCP tool: preview.start {"host":"127.0.0.1","port":5173}\n- MCP tool: preview.status {}\n- MCP tool: screenshot {"path":"/","output":"current.png","viewport":{"width":1440,"height":900},"waitUntil":"load","waitForTimeout":250}\n- MCP tool: screenshot.diff {"baselinePath":"before.png","currentPath":"current.png","outputDir":".webstudio/screenshots"}\n- MCP tool: vision.install-ocr {"confirm":true}\n\nNotes:\n\n- Use this after page/content/style mutations and after generated project files are current so a vision-capable AI can see what was actually built.\n- Use waitForSelector when the rendered app has a reliable ready marker, waitUntil:"networkidle" for network-heavy pages, and waitForTimeout only for final visual settling.\n- For a fresh checkout, copied fixture, or newly generated app, run npm install or pnpm install in the generated project before preview.start or webstudio preview.\n- If preview fails with a missing generated-app command/package such as react-router or vite, install the generated app dependencies and retry.\n- When a baseline exists, use screenshot.diff to get changed regions, OCR textAnalysis, and diff artifact paths before deciding whether the result matches.\n- If screenshot.diff reports OCR unavailable and the user agrees to install it, call vision.install-ocr {"confirm":true}; otherwise continue with pixel diff and visual inspection.\n- Compare the PNG, OCR text evidence, and diff artifacts against the user\'s intent for layout, typography, colors, spacing, imagery, and responsive framing; then iterate with focused mutations.\n- Root CLI equivalent: webstudio preview --template ssg, then webstudio screenshot <url> --output current.png.\n\n## List pages\n\nCommands:\n\n- MCP tool: list-pages {"includeFolders":true}\n\n## Read page by id\n\nCommands:\n\n- MCP tool: get-page {"pageId":"<pageId>"}\n\n## Read page by path\n\nCommands:\n\n- MCP tool: get-page-by-path {"path":"/pricing"}\n\n## Create page\n\nCommands:\n\n- MCP tool: create-page {"name":"Pricing","path":"/pricing"}\n\n## Update page settings/metadata\n\nCommands:\n\n- MCP tool: update-page {"pageId":"<pageId>","title":"Pricing","description":"Plans","status":"200"}\n- MCP tool: update-page {"pageId":"<pageId>","auth":{"login":"<login>","password":"<password>"}}\n\n## Read project settings\n\nCommands:\n\n- MCP tool: get-project-settings {}\n\n## Update project settings\n\nCommands:\n\n- MCP tool: update-project-settings {"settings":"project-settings.json contents"}\n\n## List redirects\n\nCommands:\n\n- MCP tool: list-redirects {}\n\n## Create redirect\n\nCommands:\n\n- MCP tool: create-redirect {"oldPath":"/old","newPath":"/new","status":301}\n\n## Update redirect\n\nCommands:\n\n- MCP tool: update-redirect {"oldPath":"/old","newPath":"/newer","status":302}\n- MCP tool: update-redirect {"oldPath":"/old","status":null}\n\n## Delete redirect\n\nCommands:\n\n- MCP tool: delete-redirect {"oldPath":"/old"}\n\n## List breakpoints\n\nCommands:\n\n- MCP tool: list-breakpoints {}\n\n## Create breakpoint\n\nCommands:\n\n- MCP tool: create-breakpoint {"breakpointId":"tablet","label":"Tablet","maxWidth":991}\n\n## Update breakpoint\n\nCommands:\n\n- MCP tool: update-breakpoint {"breakpointId":"tablet","label":"Tablet","maxWidth":1023}\n- MCP tool: update-breakpoint {"breakpointId":"tablet","condition":null,"minWidth":768}\n- MCP tool: update-breakpoint {"breakpointId":"tablet","minWidth":null,"maxWidth":null,"condition":"(hover: hover)"}\n\n## Delete breakpoint\n\nCommands:\n\n- MCP tool: delete-breakpoint {"breakpointId":"tablet","confirm":true}\n\n## Duplicate page\n\nCommands:\n\n- MCP tool: duplicate-page {"pageId":"<pageId>","name":"Pricing Copy","path":"/pricing-copy"}\n\n## List page templates\n\nCommands:\n\n- MCP tool: list-page-templates {}\n\n## Create page from template\n\nCommands:\n\n- MCP tool: create-page-from-template {"templateId":"<templateId>","name":"Landing","path":"/landing"}\n\n## Delete page\n\nCommands:\n\n- MCP tool: delete-page {"pageId":"<pageId>"}\n\n## List folders\n\nCommands:\n\n- MCP tool: list-folders {"includePages":true}\n\n## Create folder\n\nCommands:\n\n- MCP tool: create-folder {"name":"Blog","slug":"blog"}\n\n## Update folder\n\nCommands:\n\n- MCP tool: update-folder {"folderId":"<folderId>","name":"Blog","slug":"blog"}\n\n## Delete folder\n\nCommands:\n\n- MCP tool: delete-folder {"folderId":"<folderId>"}\n\n## List element instances\n\nCommands:\n\n- MCP tool: list-instances {"pagePath":"/","maxDepth":3}\n\n## Inspect one element instance\n\nCommands:\n\n- MCP tool: inspect-instance {"instanceId":"<instanceId>","include":["props","styles","children"]}\n\n## Append/prepend/replace child elements\n\nCommands:\n\n- MCP tool: append-instance {"parentInstanceId":"<instanceId>","children":"children.json contents"}\n\n## Move elements\n\nCommands:\n\n- MCP tool: move-instance {"moves":"moves.json contents"}\n\n## Clone element subtree\n\nCommands:\n\n- MCP tool: clone-instance {"sourceInstanceId":"<instanceId>","parentInstanceId":"<targetParentId>"}\n\n## Delete element subtree\n\nCommands:\n\n- MCP tool: delete-instance {"instanceId":"<instanceId>"}\n\n## List text/expression children\n\nCommands:\n\n- MCP tool: list-texts {"pagePath":"/"}\n\n## Update text child\n\nCommands:\n\n- MCP tool: update-text {"instanceId":"<instanceId>","childIndex":0,"text":"Launch faster"}\n\n## Update props\n\nCommands:\n\n- MCP tool: update-props {"updates":"props.json contents"}\n\n## Delete props\n\nCommands:\n\n- MCP tool: delete-props {"deletions":"props.json contents"}\n\n## Bind props to expressions/resources/actions\n\nCommands:\n\n- MCP tool: bind-props {"bindings":"bindings.json contents"}\n\n## Read styles\n\nCommands:\n\n- MCP tool: get-styles {"instanceId":"<instanceId>","includeTokens":true}\n\n## Update local styles\n\nCommands:\n\n- MCP tool: update-styles {"updates":"styles.json contents"}\n\n## Delete local styles\n\nCommands:\n\n- MCP tool: delete-styles {"deletions":"styles.json contents"}\n\n## Replace matching style values\n\nCommands:\n\n- MCP tool: replace-styles {"replacements":"replace.json contents"}\n\n## List design tokens\n\nCommands:\n\n- MCP tool: list-design-tokens {"withUsage":true}\n\n## Create design tokens\n\nCommands:\n\n- MCP tool: create-design-token {"tokens":"tokens.json contents"}\n\n## Update design token styles\n\nCommands:\n\n- MCP tool: update-design-token-styles {"styleSourceId":"<tokenId>","updates":"styles.json contents"}\n\n## Delete design token styles\n\nCommands:\n\n- MCP tool: delete-design-token-styles {"styleSourceId":"<tokenId>","deletions":"styles.json contents"}\n\n## Attach design token to instances\n\nCommands:\n\n- MCP tool: attach-design-token {"styleSourceId":"<tokenId>","instanceIds":"instances.json contents"}\n\n## Detach design token from instances\n\nCommands:\n\n- MCP tool: detach-design-token {"styleSourceId":"<tokenId>","instanceIds":"instances.json contents"}\n\n## Extract design token from local styles\n\nCommands:\n\n- MCP tool: extract-design-token {"token":"token.json contents"}\n\n## List CSS variables\n\nCommands:\n\n- MCP tool: list-css-variables {"withUsage":true}\n\n## Define CSS variables\n\nCommands:\n\n- MCP tool: define-css-variable {"variables":"vars.json contents"}\n\n## Delete CSS variables\n\nCommands:\n\n- MCP tool: delete-css-variable {"names":"names.json contents","confirm":true}\n\n## Rewrite CSS variable references\n\nCommands:\n\n- MCP tool: rewrite-css-variable-refs {"variables":"variables.json contents"}\n\n## List data variables\n\nCommands:\n\n- MCP tool: list-variables {}\n\n## Create data variable\n\nCommands:\n\n- MCP tool: create-variable {"scopeInstanceId":"<instanceId>","name":"title","value":{"type":"string","value":"Hello"}}\n\n## Update data variable\n\nCommands:\n\n- MCP tool: update-variable {"variableId":"<variableId>","value":{"type":"json","value":{"count":1}}}\n\n## Delete data variable\n\nCommands:\n\n- MCP tool: delete-variable {"variableId":"<variableId>"}\n\n## List resources\n\nCommands:\n\n- MCP tool: list-resources {}\n\n## Create resource\n\nCommands:\n\n- MCP tool: create-resource {"name":"Posts","method":"get","url":"https://api.example.com/posts"}\n\n## Update resource\n\nCommands:\n\n- MCP tool: update-resource {"resourceId":"<resourceId>","url":"https://api.example.com/posts"}\n\n## Delete resource\n\nCommands:\n\n- MCP tool: delete-resource {"resourceId":"<resourceId>"}\n\n## List assets\n\nCommands:\n\n- MCP tool: list-assets {"withUsage":true}\n\n## Upload one asset\n\nCommands:\n\n- MCP tool: upload-asset {"asset":"asset.json contents","assetsDir":".webstudio/assets"}\n\n## Upload asset batch\n\nCommands:\n\n- MCP tool: upload-assets {"assets":"assets.json contents","assetsDir":".webstudio/assets"}\n\n## Find asset usage\n\nCommands:\n\n- MCP tool: find-asset-usage {"assetId":"<assetId>"}\n\n## Replace asset references\n\nCommands:\n\n- MCP tool: replace-asset {"fromAssetId":"<oldAssetId>","toAssetId":"<newAssetId>","confirm":true}\n\n## Delete assets\n\nCommands:\n\n- MCP tool: delete-asset {"assetId":"<assetId>","confirm":true}\n\n## Publish project\n\nCommands:\n\n- webstudio publish deploy --target production --json\n\n## List publishes\n\nCommands:\n\n- webstudio publish list --json\n\n## Check publish job\n\nCommands:\n\n- webstudio publish status --job <buildId> --json\n\n## Unpublish\n\nCommands:\n\n- webstudio publish unpublish --target production --confirm --json\n\n## List domains\n\nCommands:\n\n- webstudio domains list --json\n\n## Create domain\n\nCommands:\n\n- webstudio domains create --domain example.com --json\n\n## Update domain\n\nCommands:\n\n- webstudio domains update --domain-id <domainId> --domain www.example.com --json\n\n## Delete domain\n\nCommands:\n\n- webstudio domains delete --domain-id <domainId> --confirm --json\n\n## Verify domain\n\nCommands:\n\n- webstudio domains verify --domain-id <domainId> --json\n\n## Make arbitrary store-level changes\n\nCommands:\n\n- MCP tool: inspect {}\n- MCP tool: snapshot {"include":["<namespace>"]}\n- MCP tool: apply-patch {"baseVersion":"<version>","transactions":"patch.json contents"}\n\nNotes:\n\n- Use only when no semantic command exists.\n\n## Manage marketplace metadata\n\nCommands:\n\n- MCP tool: snapshot {"include":["marketplaceProduct"]}\n- MCP tool: apply-patch {"baseVersion":"<version>","transactions":"patch.json contents"}\n\nPatch namespaces:\n\n- marketplaceProduct\n\n## Search and inspect safely\n\nCommands:\n\n- MCP tool: list-instances {"pagePath":"/","maxDepth":5}\n- MCP tool: inspect-instance {"instanceId":"<instanceId>","include":["props","styles","children"]}\n- MCP tool: list-texts {"pagePath":"/"}\n- MCP tool: list-assets {"withUsage":true}\n- MCP tool: find-asset-usage {"assetId":"<assetId>"}\n- MCP tool: snapshot {"include":["pages","instances","props","resources","assets"]}\n\nNotes:\n\n- Use this for finding elements by label, type, href/resource patterns, HTML snippets, missing accessibility metadata, or asset usage.\n\n## Refactor targeted content\n\nCommands:\n\n- MCP tool: list-instances {"pagePath":"/"}\n- MCP tool: list-texts {"pagePath":"/"}\n- MCP tool: update-text {"instanceId":"<instanceId>","childIndex":0,"text":"Launch faster"}\n- MCP tool: update-props {"updates":"props.json contents"}\n- MCP tool: update-page {"pageId":"<pageId>","title":"Pricing","description":"Plans"}\n- MCP tool: update-resource {"resourceId":"<resourceId>","url":"https://api.example.com/posts"}\n- MCP tool: replace-asset {"fromAssetId":"<oldAssetId>","toAssetId":"<newAssetId>","confirm":true}\n- MCP tool: replace-styles {"replacements":"replace.json contents"}\n- MCP tool: rewrite-css-variable-refs {"variables":"variables.json contents"}\n\nNotes:\n\n- Use focused reads first, then mutate only matching instances, props, metadata, resource URLs, assets, or style references.\n\n## Optimize existing project\n\nCommands:\n\n- MCP tool: list-pages {"includeFolders":true}\n- MCP tool: update-page {"pageId":"<pageId>","title":"Pricing","description":"Plans"}\n- MCP tool: update-props {"updates":"props.json contents"}\n- MCP tool: list-breakpoints {}\n- MCP tool: update-breakpoint {"breakpointId":"tablet","maxWidth":1023}\n- MCP tool: get-styles {"instanceId":"<instanceId>","includeTokens":true}\n- MCP tool: update-styles {"updates":"styles.json contents"}\n- MCP tool: attach-design-token {"styleSourceId":"<tokenId>","instanceIds":"instances.json contents"}\n- MCP tool: update-project-settings {"settings":"project-settings.json contents"}\n\nNotes:\n\n- Use this for SEO metadata, accessibility labels, responsive behavior, token consistency, and project settings.\n\n## Connect external data\n\nCommands:\n\n- MCP tool: create-variable {"scopeInstanceId":"<instanceId>","name":"title","value":{"type":"string","value":"Hello"}}\n- MCP tool: create-resource {"name":"Posts","method":"get","url":"https://api.example.com/posts"}\n- MCP tool: update-resource {"resourceId":"<resourceId>","url":"https://api.example.com/posts"}\n- MCP tool: bind-props {"bindings":"bindings.json contents"}\n- MCP tool: append-instance {"parentInstanceId":"<instanceId>","children":"children.json contents"}\n\nNotes:\n\n- Use this for CMS sections, blog listings, Ghost/headless CMS pages, n8n-style integrations, and API URLs built from variables.\n\n## Support dynamic runtime behavior\n\nCommands:\n\n- MCP tool: append-instance {"parentInstanceId":"<instanceId>","children":"children.json contents"}\n- MCP tool: update-props {"updates":"props.json contents"}\n- MCP tool: bind-props {"bindings":"bindings.json contents"}\n- MCP tool: create-resource {"name":"Seats","method":"get","url":"https://api.example.com/seats"}\n- MCP tool: snapshot {"include":["instances","props","resources"]}\n- MCP tool: apply-patch {"baseVersion":"<version>","transactions":"patch.json contents"}\n\nNotes:\n\n- Use existing scripts/resources for behavior, then move presentational structure into editable Webstudio instances where possible.\n- There is no dedicated semantic command yet for converting script-generated UI into editable Webstudio structure.\n\n## Build authenticated pages\n\nCommands:\n\n- MCP tool: create-page {"name":"Account","path":"/account"}\n- MCP tool: update-page {"pageId":"<pageId>","auth":{"login":"<login>","password":"<password>"}}\n- MCP tool: create-resource {"name":"Session","method":"get","url":"https://api.example.com/session"}\n- MCP tool: create-variable {"scopeInstanceId":"<instanceId>","name":"user","value":{"type":"json","value":{}}}\n- MCP tool: update-props {"updates":"props.json contents"}\n- MCP tool: bind-props {"bindings":"bindings.json contents"}\n\nNotes:\n\n- Basic auth is semantic today. Provider-specific Supabase/Firebase setup still requires manual resources, props, embeds, or patches.\n\n## Generate from design input\n\nCommands:\n\n- MCP tool: create-page {"name":"Landing","path":"/landing"}\n- MCP tool: create-design-token {"tokens":"tokens.json contents"}\n- MCP tool: define-css-variable {"variables":"vars.json contents"}\n- MCP tool: append-instance {"parentInstanceId":"<instanceId>","children":"children.json contents"}\n- MCP tool: update-styles {"updates":"styles.json contents"}\n- MCP tool: preview.start {"host":"127.0.0.1","port":5173}\n- MCP tool: screenshot {"path":"/","output":"current.png","viewport":{"width":1440,"height":900},"waitUntil":"load","waitForTimeout":250}\n\nNotes:\n\n- Use this after external design interpretation. There is no dedicated import command for Figma, screenshots, Inception output, or design.md yet.\n\n## Cross-project maintenance\n\nCommands:\n\n- webstudio init --link <api-share-link> --json\n- webstudio permissions --json\n- webstudio mcp\n\nNotes:\n\n- Public API and CLI intentionally operate on one configured project at a time. Use an external script to loop over projects.\n\n# Known CLI Gaps\n\n## General project search and audit\n\nMissing:\nNo single semantic command searches across instance labels, props, hrefs, resource URLs, HTML embeds, asset references, and missing accessibility metadata.\n\nCurrent fallback:\nUse focused MCP reads such as list-instances, list-texts, list-assets, find-asset-usage, and snapshot.\n\nSuggested commands:\n\n- search-project\n- audit-accessibility\n- find-prop-usage\n\n## Save and manage page templates\n\nMissing:\nCLI can list page templates and create pages from existing templates, but cannot save a page as a template or update/delete templates semantically.\n\nCurrent fallback:\nUse MCP snapshot and apply-patch only when the template data model is understood.\n\nSuggested commands:\n\n- create-page-template\n- update-page-template\n- delete-page-template\n\n## Semantic marketplace metadata\n\nMissing:\nMarketplace metadata is only available through MCP snapshot/apply-patch, not dedicated semantic commands.\n\nCurrent fallback:\nUse MCP snapshot --include marketplaceProduct and apply-patch.\n\nSuggested commands:\n\n- get-marketplace\n- update-marketplace\n\n## Provider-specific authenticated pages\n\nMissing:\nCLI supports page basic auth and generic resources/props/embeds, but not guided Supabase/Firebase auth setup.\n\nCurrent fallback:\nCreate the page, resources, variables, props, and embeds manually with existing MCP semantic tools.\n\nSuggested commands:\n\n- setup-auth-page\n\n## Dynamic script/runtime integration helpers\n\nMissing:\nCLI can manipulate props/resources/embeds, but has no semantic workflow for converting script-generated UI into editable Webstudio structures.\n\nCurrent fallback:\nUse MCP append-instance, props, resources, and raw patch where necessary.\n\nSuggested commands:\n\n- integrate-runtime-ui\n\n## Generate from design input\n\nMissing:\nNo command imports Figma, screenshots, Inception output, or design.md and turns it into pages/tokens/layout.\n\nCurrent fallback:\nUse external generation, then apply semantic CLI commands or apply-patch.\n\nSuggested commands:\n\n- generate-from-design\n\n## Built-in cross-project maintenance\n\nMissing:\nPublic API and CLI intentionally operate on one configured project at a time; there is no built-in multi-project discovery or loop runner.\n\nCurrent fallback:\nRun the CLI from an external script that reconfigures one project/session at a time.\n\nSuggested commands:\n\n- none\n',
   "manual-api": '# Webstudio API CLI Manual\n\nThe API commands operate on the single project configured by:\n\n- .webstudio/config.json: projectId\n- global Webstudio config: origin and token\n\nRules:\n\n- Always pass --json.\n- Never pass a project id. Commands use configured project only.\n- Read ids before writing. Do not invent ids for existing records.\n- stdout is one JSON object. stderr is diagnostics.\n- Prefer MCP semantic tools for detailed project edits. Use MCP apply-patch only when no semantic tool exists.\n\n## Start\n\n{{start}}\n\n## Read First\n\n{{readFirst}}\n\n## Project Session Cache\n\n- CLI commands use one local ProjectSession snapshot for the configured project.\n- Local-capable reads use cached namespaces when compatible and fetch only missing or stale namespaces.\n- Local-capable mutations build patches from the local snapshot, then commit with the cached build version.\n- Successful mutation commits update the local snapshot only after the remote commit succeeds.\n- Server-only commands run remotely and invalidate/refetch namespaces declared by the operation catalog.\n- Use --refresh on local-capable commands to refresh required namespaces before running.\n- Successful JSON responses include meta.session with operationId, buildId, version, source, committed, compatibility, namespace freshness, and diagnostics.\n\n## CLI Capability Inventory\n\n### Top-Level Commands\n\n{{topLevelCapabilityIndex}}\n\n### High-Level API Commands By Area\n\n{{apiCapabilityIndex}}\n\n### MCP-Only Operations\n\nThese are intentionally exposed through `webstudio mcp`, not as top-level shell commands:\n\n{{mcpOnlyCommandIndex}}\n\n## Task Recipes\n\n{{taskRecipeIndex}}\n\n## Use Case Index\n\n{{useCaseIndex}}\n\n## Known CLI Gaps\n\n{{knownCliGapIndex}}\n\n## Input File Shapes\n\n{{inputFileShapeIndex}}\n\n## Raw Patch Fallback\n\napply-patch accepts either BuildPatchTransaction[] or { "transactions": BuildPatchTransaction[] }.\n\nEach transaction has:\n\n{\n"id": "unique-client-transaction-id",\n"payload": [\n{\n"namespace": "pages",\n"patches": [\n{ "op": "replace", "path": ["meta", "siteName"], "value": "New Site" }\n]\n}\n]\n}\n\nPatch paths are JSON-patch-like paths into Builder store data. Map-like namespaces use ids as the first path item.\n\nSupported namespaces:\n\n- pages: site metadata, redirects, page records, folders, compiler settings\n- instances: element instances and children, including text/expression children\n- props: element props, bindings, page references, resource bindings\n- styles: CSS declarations keyed by style declaration key\n- styleSources: local style sources and reusable design tokens\n- styleSourceSelections: instance-to-style-source connections\n- dataSources: data variables, parameters, and resource data sources\n- resources: data resource definitions\n- assets: project asset records handled by the existing asset patch path\n- breakpoints: responsive breakpoints\n- marketplaceProduct: marketplace metadata\n\nCommit raw patch:\n\nMCP tool: apply-patch\n\n## Raw Patch Examples\n\nRename the site:\n\n[\n{\n"id": "tx-site-name",\n"payload": [\n{\n"namespace": "pages",\n"patches": [\n{ "op": "add", "path": ["meta", "siteName"], "value": "Acme Studio" }\n]\n}\n]\n}\n]\n\nUpdate page title metadata:\n\n[\n{\n"id": "tx-page-title",\n"payload": [\n{\n"namespace": "pages",\n"patches": [\n{ "op": "replace", "path": ["pages", "page-id", "meta", "title"], "value": "Pricing" }\n]\n}\n]\n}\n]\n\nUpdate a text child on an element:\n\n[\n{\n"id": "tx-text",\n"payload": [\n{\n"namespace": "instances",\n"patches": [\n{ "op": "replace", "path": ["instance-id", "children", 0, "value"], "value": "Launch faster" }\n]\n}\n]\n}\n]\n\nCreate a data variable:\n\n[\n{\n"id": "tx-variable",\n"payload": [\n{\n"namespace": "dataSources",\n"patches": [\n{\n"op": "add",\n"path": ["variable-id"],\n"value": {\n"type": "variable",\n"id": "variable-id",\n"scopeInstanceId": "instance-id",\n"name": "headline",\n"value": { "type": "string", "value": "Launch faster" }\n}\n}\n]\n}\n]\n}\n]\n\nCreate a design token:\n\n[\n{\n"id": "tx-token",\n"payload": [\n{\n"namespace": "styleSources",\n"patches": [\n{ "op": "add", "path": ["token-id"], "value": { "type": "token", "id": "token-id", "name": "Brand Primary" } }\n]\n},\n{\n"namespace": "styles",\n"patches": [\n{\n"op": "add",\n"path": ["token-id:base:color:"],\n"value": {\n"styleSourceId": "token-id",\n"breakpointId": "base",\n"property": "color",\n"value": { "type": "keyword", "value": "red" }\n}\n}\n]\n}\n]\n}\n]\n\n## Safety Rules\n\n- For MCP apply-patch, read the latest version with MCP snapshot before writing.\n- Reuse ids from MCP snapshot output when updating existing records.\n- Generate new unique ids when adding records.\n- If apply-patch reports a version conflict, read the latest build and regenerate the patch.\n- Prefer semantic MCP read tools for discovery, then use MCP snapshot for exact patch paths.\n\n## Command Index\n\n{{commandIndex}}\n',
   "manual-llm": "# Webstudio CLI Manual for LLMs\n\nUse this order. Stop only when a command returns ok:false.\n\n## Always\n\n1. webstudio permissions --json\n2. webstudio mcp\n3. Read MCP resource webstudio://project/tools.\n4. Pick focused MCP read tool.\n5. Pick semantic MCP write tool.\n\n## Pick Read Command\n\n{{readFirst}}\n\n## Pick Write Command\n\n{{taskRecipeIndex}}\n\n## Raw Patch Only If Needed\n\n1. Use MCP tool: snapshot.\n2. Write BuildPatchTransaction[].\n3. Use MCP tool: apply-patch.\n\n## MCP Argument Examples\n\nMCP tools receive JSON argument objects, not CLI flags. Use these shapes:\n\n{{mcpArgumentExampleIndex}}\n\n## Rules\n\n- Never guess ids for existing records. Read them first.\n- Never use project ids from user input. Commands use the configured project.\n- Use --refresh before a local-capable command when cached data may be stale.\n- On VERSION_CONFLICT, read MCP snapshot again, regenerate the patch, then retry.\n- Treat stdout JSON as the API contract and stderr as diagnostics.\n- Confirm destructive commands with --confirm only when user requested deletion/unpublish/replacement.\n- Use webstudio schema api --json for machine-readable command metadata.\n\n## Known Gaps\n\n{{knownCliGapIndex}}\n",
   "manual-mcp": "# Webstudio MCP Manual\n\n`webstudio mcp` starts a stdio MCP server for the configured project.\n\n## Startup\n\n1. Configure a project with `webstudio init --link <api-share-link> --json`.\n2. Check capabilities with `webstudio permissions --json`.\n3. Start the server with `webstudio mcp`.\n\nWhile the server is running, stdout is reserved for MCP JSON-RPC messages. Do not print human text from the server process.\n\n## Discovery\n\nUse MCP itself after startup:\n\n- `tools/list`: machine-readable available tools\n- `resources/list`: available longer JSON resources\n- `meta.index`: concise capability catalog\n- `meta.guide`: workflow for a user goal\n- `meta.get_more_tools`: detailed params, examples, namespaces, and local/server behavior\n\nUseful resources:\n\n- `webstudio://project/status`: current ProjectSession status\n- `webstudio://project/tools`: operation catalog\n- `webstudio://project/guide`: concise discovery guide\n\n## Core Rules\n\n- Operate on the configured project only.\n- Read ids before writing.\n- Prefer semantic tools over `apply-patch`.\n- Use `status` and `refresh` when cached namespaces may be stale.\n- A mutation is durable only when `meta.session.committed` is true.\n- For visual/design work, verify the rendered result with vision before finishing.\n\n## Vision Verification Loop\n\nVision-capable AI can use MCP to see what it is building:\n\n{{mcpVisionVerificationLoopMarkdown}}\n\nGenerated app setup:\n\n{{mcpGeneratedAppDependencyNotes}}\n\n## MCP Argument Examples\n\nMCP tools receive JSON argument objects:\n\n{{mcpArgumentExampleIndex}}\n\n## Screenshot Verification\n\n{{screenshotVerificationSummary}}\n",
@@ -32370,9 +32641,6 @@ const readJsonArray = async (dependencies2, path2, name2) => {
 };
 const readInputObject = async (dependencies2, options) => await readOptionalJsonObject(dependencies2, options.input);
 const readInputArray = async (dependencies2, options) => await readJsonArray(dependencies2, options.input, "--input");
-const readAssetData = (dependencies2, assetsDirectory) => async (asset2) => await dependencies2.readFile(
-  getLocalAssetPath(asset2.name, assetsDirectory)
-);
 const parseVariableValue = (type2, value2) => {
   const valueType = requireOption(type2, "--value-type");
   const rawValue = requireStringOption(value2, "--value");
@@ -33379,7 +33647,10 @@ const apiCommandHandlers = {
   "upload-asset": async (options, connection, dependencies2) => {
     const input2 = {
       asset: await readInputObject(dependencies2, options),
-      readAssetData: readAssetData(dependencies2, options.assetsDir)
+      readAssetData: createLocalAssetDataReader(
+        dependencies2.readFile,
+        options.assetsDir
+      )
     };
     return runProjectSessionCommand(
       "upload-asset",
@@ -33391,7 +33662,10 @@ const apiCommandHandlers = {
   "upload-assets": async (options, connection, dependencies2) => {
     const input2 = {
       assets: await readInputArray(dependencies2, options),
-      readAssetData: readAssetData(dependencies2, options.assetsDir)
+      readAssetData: createLocalAssetDataReader(
+        dependencies2.readFile,
+        options.assetsDir
+      )
     };
     return runProjectSessionCommand(
       "upload-assets",
@@ -33522,6 +33796,11 @@ const topLevelCliCommandMetadata = [
     description: "Download the configured project bundle and asset files into .webstudio",
     examples: ["webstudio sync"]
   },
+  {
+    command: "import",
+    description: "Import the synced .webstudio/data.json project bundle into a destination project",
+    examples: ["webstudio import --to <destination-share-link>"]
+  },
   {
     command: "build",
     description: "Build the synced project with the selected template",
@@ -39114,6 +39393,16 @@ const mcp = async () => {
     ...connection,
     headers: apiCompatibilityHeaders
   };
+  let importErrorMessage = "Project import failed.";
+  const silentImportIndicator = {
+    start: () => void 0,
+    message: () => void 0,
+    stop: (message) => {
+      if (message !== void 0) {
+        importErrorMessage = message;
+      }
+    }
+  };
   const session = createCliProjectSession({ connection: apiConnection });
   const preview2 = createPreviewController({ host: "127.0.0.1", port: 5173 });
   await connectProjectSessionMcpServer({
@@ -39126,6 +39415,36 @@ const mcp = async () => {
       createProjectSession: () => session,
       dryRun
     }),
+    async importProject(input2) {
+      importErrorMessage = "Project import failed.";
+      try {
+        await importProject(
+          {
+            to: input2.to,
+            assetsDir: input2.assetsDir,
+            ignoreVersionCheck: input2.ignoreVersionCheck,
+            skipAssets: input2.skipAssets
+          },
+          {
+            importProjectBundleWithAssets,
+            loadJSONFile,
+            readFile,
+            text: async () => {
+              throw new Error("MCP import requires to.");
+            },
+            isInteractive: false,
+            log: { info: () => void 0 },
+            spinner: () => silentImportIndicator
+          }
+        );
+      } catch (error) {
+        if (isHandledCliError(error)) {
+          throw new Error(importErrorMessage);
+        }
+        throw error;
+      }
+      return { imported: true };
+    },
     async startPreview(input2) {
       return preview2.startAndWait(input2);
     },
@@ -39676,6 +39995,12 @@ const registerCommands = (cmd) => {
   );
   cmd.command(["link"], "Link the project with the cloud", linkOptions, link);
   cmd.command(["sync"], "Sync your project", syncOptions, sync);
+  cmd.command(
+    ["import"],
+    "Import the synced project bundle into another project",
+    importOptions,
+    importProject
+  );
   cmd.command(
     ["preview"],
     "Run the generated project dev server for visual verification",

package/lib/cli.js

@@ -1,6 +1,6 @@
 import "node:process";
 import "yargs/helpers";
-import { ay, ax } from "./cli-DfnIxogH.js";
+import { ay, ax } from "./cli-B3sZoyrv.js";
 import "yargs";
 export {
   ay as main,

package/lib/{framework-react-router-CVBhO7ll.js → framework-react-router-BtDy2QPF.js}

@@ -1,7 +1,7 @@
 import { join } from "node:path";
 import { readFile, rm } from "node:fs/promises";
-import { b as baseComponentMetas, r as radixComponentMetas, a as animationComponentMetas } from "./metas-rxEC7Qu1.js";
-import { g as generateRemixRoute } from "./cli-DfnIxogH.js";
+import { b as baseComponentMetas, r as radixComponentMetas, a as animationComponentMetas } from "./metas-pq7CBZny.js";
+import { g as generateRemixRoute } from "./cli-B3sZoyrv.js";
 const createFramework = async () => {
   const routeTemplatesDir = join("app", "route-templates");
   const htmlTemplate = await readFile(

package/lib/{framework-remix-B05uGrvd.js → framework-remix-KhlqR_BH.js}

@@ -1,7 +1,7 @@
 import { join } from "node:path";
 import { readFile, rm } from "node:fs/promises";
-import { b as baseComponentMetas, r as radixComponentMetas, a as animationComponentMetas } from "./metas-rxEC7Qu1.js";
-import { g as generateRemixRoute } from "./cli-DfnIxogH.js";
+import { b as baseComponentMetas, r as radixComponentMetas, a as animationComponentMetas } from "./metas-pq7CBZny.js";
+import { g as generateRemixRoute } from "./cli-B3sZoyrv.js";
 const createFramework = async () => {
   const routeTemplatesDir = join("app", "route-templates");
   const htmlTemplate = await readFile(

package/lib/{framework-vike-ssg-BOMCgE0f.js → framework-vike-ssg-De0xD5T4.js}

@@ -1,7 +1,7 @@
 import { join } from "node:path";
 import { readFile, rm } from "node:fs/promises";
-import { b as baseComponentMetas, r as radixComponentMetas, a as animationComponentMetas } from "./metas-rxEC7Qu1.js";
-import { i as isPathnamePattern } from "./cli-DfnIxogH.js";
+import { b as baseComponentMetas, r as radixComponentMetas, a as animationComponentMetas } from "./metas-pq7CBZny.js";
+import { i as isPathnamePattern } from "./cli-B3sZoyrv.js";
 const generateVikeRoute = (pagePath) => {
   if (pagePath === "/") {
     return "index";

package/lib/{metas-rxEC7Qu1.js → metas-pq7CBZny.js}

@@ -1,4 +1,4 @@
-import { S as SlotComponentIcon, d as descendantComponent, E as EmbedIcon, M as MarkdownEmbedIcon, b as body, s as section, n as nav, m as main, h as header, f as footer, a as figure, c as aside, e as article, j as address, k as div, T as TextIcon, l as h6, o as h5, p as h4, q as h3, r as h2, t as h1, u as p, v as a, w as span, P as PaintBrushIcon, x as b, y as i, z as sup, A as sub, B as button, C as input, D as form, W as WebhookFormIcon, F as img, G as ul, H as ol, I as li, J as hr, K as code, L as BracesIcon, N as label, O as textarea, Q as radio, R as RadioCheckedIcon, U as checkbox, V as CheckboxCheckedIcon, X as VimeoIcon, Y as YoutubeIcon, Z as ButtonElementIcon, _ as BoxIcon, $ as XmlIcon, a0 as CalendarIcon, a1 as time, a2 as select, a3 as HeaderIcon, a4 as ResourceIcon, a5 as WindowInfoIcon, a6 as WindowTitleIcon, a7 as VideoIcon, a8 as AnimationGroupIcon, a9 as TextAnimationIcon, aa as StaggerAnimationIcon, ab as PlayIcon, ac as CollapsibleIcon, ad as TriggerIcon, ae as ContentIcon, af as DialogIcon, ag as OverlayIcon, ah as HeadingIcon, ai as PopoverIcon, aj as TooltipIcon, ak as TabsIcon, al as LabelIcon, am as AccordionIcon, an as ItemIcon, ao as NavigationMenuIcon, ap as ListIcon, aq as ListItemIcon, ar as ViewportIcon, as as SelectIcon, at as FormTextFieldIcon, au as CheckMarkIcon, av as SwitchIcon, aw as RadioGroupIcon } from "./cli-DfnIxogH.js";
+import { S as SlotComponentIcon, d as descendantComponent, E as EmbedIcon, M as MarkdownEmbedIcon, b as body, s as section, n as nav, m as main, h as header, f as footer, a as figure, c as aside, e as article, j as address, k as div, T as TextIcon, l as h6, o as h5, p as h4, q as h3, r as h2, t as h1, u as p, v as a, w as span, P as PaintBrushIcon, x as b, y as i, z as sup, A as sub, B as button, C as input, D as form, W as WebhookFormIcon, F as img, G as ul, H as ol, I as li, J as hr, K as code, L as BracesIcon, N as label, O as textarea, Q as radio, R as RadioCheckedIcon, U as checkbox, V as CheckboxCheckedIcon, X as VimeoIcon, Y as YoutubeIcon, Z as ButtonElementIcon, _ as BoxIcon, $ as XmlIcon, a0 as CalendarIcon, a1 as time, a2 as select, a3 as HeaderIcon, a4 as ResourceIcon, a5 as WindowInfoIcon, a6 as WindowTitleIcon, a7 as VideoIcon, a8 as AnimationGroupIcon, a9 as TextAnimationIcon, aa as StaggerAnimationIcon, ab as PlayIcon, ac as CollapsibleIcon, ad as TriggerIcon, ae as ContentIcon, af as DialogIcon, ag as OverlayIcon, ah as HeadingIcon, ai as PopoverIcon, aj as TooltipIcon, ak as TabsIcon, al as LabelIcon, am as AccordionIcon, an as ItemIcon, ao as NavigationMenuIcon, ap as ListIcon, aq as ListItemIcon, ar as ViewportIcon, as as SelectIcon, at as FormTextFieldIcon, au as CheckMarkIcon, av as SwitchIcon, aw as RadioGroupIcon } from "./cli-B3sZoyrv.js";
 const meta$N = {
   category: "general",
   description: "Slot is a container for content that you want to reference across the project. Changes made to a Slot's children will be reflected in all other instances of that Slot.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webstudio",
-  "version": "0.274.0",
+  "version": "0.274.2",
   "description": "Webstudio CLI",
   "author": "Webstudio <github@webstudio.is>",
   "homepage": "https://webstudio.is",
@@ -47,10 +47,10 @@
     "warn-once": "^0.1.1",
     "yargs": "^17.7.2",
     "zod": "^3.24.2",
-    "@webstudio-is/http-client": "0.274.0",
-    "@webstudio-is/project-migrations": "0.274.0",
+    "@webstudio-is/http-client": "0.274.2",
     "@webstudio-is/project-build": "0.0.0",
-    "@webstudio-is/protocol": "0.274.0"
+    "@webstudio-is/project-migrations": "0.274.2",
+    "@webstudio-is/protocol": "0.274.2"
   },
   "devDependencies": {
     "@cloudflare/vite-plugin": "^1.1.0",
@@ -80,17 +80,17 @@
     "vite": "^6.3.4",
     "vitest": "^3.1.2",
     "wrangler": "^3.63.2",
-    "@webstudio-is/css-engine": "0.274.0",
-    "@webstudio-is/image": "0.274.0",
-    "@webstudio-is/react-sdk": "0.274.0",
-    "@webstudio-is/sdk": "0.274.0",
-    "@webstudio-is/sdk-components-animation": "0.274.0",
-    "@webstudio-is/sdk-components-react": "0.274.0",
-    "@webstudio-is/sdk-components-react-remix": "0.274.0",
-    "@webstudio-is/sdk-components-react-router": "0.274.0",
-    "@webstudio-is/sdk-components-react-radix": "0.274.0",
+    "@webstudio-is/css-engine": "0.274.2",
+    "@webstudio-is/react-sdk": "0.274.2",
+    "@webstudio-is/image": "0.274.2",
+    "@webstudio-is/sdk": "0.274.2",
+    "@webstudio-is/sdk-components-animation": "0.274.2",
+    "@webstudio-is/sdk-components-react": "0.274.2",
+    "@webstudio-is/sdk-components-react-remix": "0.274.2",
+    "@webstudio-is/sdk-components-react-radix": "0.274.2",
+    "@webstudio-is/sdk-components-react-router": "0.274.2",
     "@webstudio-is/tsconfig": "1.0.7",
-    "@webstudio-is/wsauth": "0.274.0"
+    "@webstudio-is/wsauth": "0.274.2"
   },
   "scripts": {
     "typecheck": "tsgo --noEmit",

package/templates/cloudflare/package.json

@@ -12,7 +12,7 @@
     "build-cf-types": "wrangler types"
   },
   "dependencies": {
-    "@webstudio-is/wsauth": "0.274.0",
+    "@webstudio-is/wsauth": "0.274.2",
     "@remix-run/cloudflare": "2.16.5",
     "@remix-run/cloudflare-pages": "2.16.5"
   },

package/templates/defaults/package.json

@@ -11,14 +11,14 @@
     "@remix-run/node": "2.16.5",
     "@remix-run/react": "2.16.5",
     "@remix-run/server-runtime": "2.16.5",
-    "@webstudio-is/image": "0.274.0",
-    "@webstudio-is/react-sdk": "0.274.0",
-    "@webstudio-is/sdk": "0.274.0",
-    "@webstudio-is/sdk-components-react": "0.274.0",
-    "@webstudio-is/sdk-components-animation": "0.274.0",
-    "@webstudio-is/sdk-components-react-radix": "0.274.0",
-    "@webstudio-is/sdk-components-react-remix": "0.274.0",
-    "@webstudio-is/wsauth": "0.274.0",
+    "@webstudio-is/image": "0.274.2",
+    "@webstudio-is/react-sdk": "0.274.2",
+    "@webstudio-is/sdk": "0.274.2",
+    "@webstudio-is/sdk-components-react": "0.274.2",
+    "@webstudio-is/sdk-components-animation": "0.274.2",
+    "@webstudio-is/sdk-components-react-radix": "0.274.2",
+    "@webstudio-is/sdk-components-react-remix": "0.274.2",
+    "@webstudio-is/wsauth": "0.274.2",
     "isbot": "^5.1.25",
     "react": "18.3.0-canary-14898b6a9-20240318",
     "react-dom": "18.3.0-canary-14898b6a9-20240318"

package/templates/react-router/package.json

@@ -10,14 +10,14 @@
   "dependencies": {
     "@react-router/dev": "^7.5.3",
     "@react-router/fs-routes": "^7.5.3",
-    "@webstudio-is/image": "0.274.0",
-    "@webstudio-is/react-sdk": "0.274.0",
-    "@webstudio-is/sdk": "0.274.0",
-    "@webstudio-is/sdk-components-animation": "0.274.0",
-    "@webstudio-is/sdk-components-react-radix": "0.274.0",
-    "@webstudio-is/sdk-components-react-router": "0.274.0",
-    "@webstudio-is/sdk-components-react": "0.274.0",
-    "@webstudio-is/wsauth": "0.274.0",
+    "@webstudio-is/image": "0.274.2",
+    "@webstudio-is/react-sdk": "0.274.2",
+    "@webstudio-is/sdk": "0.274.2",
+    "@webstudio-is/sdk-components-animation": "0.274.2",
+    "@webstudio-is/sdk-components-react-radix": "0.274.2",
+    "@webstudio-is/sdk-components-react-router": "0.274.2",
+    "@webstudio-is/sdk-components-react": "0.274.2",
+    "@webstudio-is/wsauth": "0.274.2",
     "isbot": "^5.1.25",
     "react": "18.3.0-canary-14898b6a9-20240318",
     "react-dom": "18.3.0-canary-14898b6a9-20240318",

package/templates/react-router-cloudflare/package.json

@@ -7,7 +7,7 @@
   },
   "dependencies": {
     "@cloudflare/vite-plugin": "^1.1.0",
-    "@webstudio-is/wsauth": "0.274.0",
+    "@webstudio-is/wsauth": "0.274.2",
     "wrangler": "^4.14.1"
   }
 }

package/templates/ssg/package.json

@@ -8,12 +8,12 @@
     "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@webstudio-is/image": "0.274.0",
-    "@webstudio-is/react-sdk": "0.274.0",
-    "@webstudio-is/sdk": "0.274.0",
-    "@webstudio-is/sdk-components-react": "0.274.0",
-    "@webstudio-is/sdk-components-animation": "0.274.0",
-    "@webstudio-is/sdk-components-react-radix": "0.274.0",
+    "@webstudio-is/image": "0.274.2",
+    "@webstudio-is/react-sdk": "0.274.2",
+    "@webstudio-is/sdk": "0.274.2",
+    "@webstudio-is/sdk-components-react": "0.274.2",
+    "@webstudio-is/sdk-components-animation": "0.274.2",
+    "@webstudio-is/sdk-components-react-radix": "0.274.2",
     "react": "18.3.0-canary-14898b6a9-20240318",
     "react-dom": "18.3.0-canary-14898b6a9-20240318",
     "vike": "^0.4.229"