framer-dalton 0.0.20 → 0.0.22

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import fs6 from 'fs';
-import path6 from 'path';
+import fs7 from 'fs';
+import path7 from 'path';
 import { Command } from 'commander';
 import crypto, { randomUUID } from 'crypto';
 import http from 'http';
@@ -10,9 +10,23 @@ import os from 'os';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.20 */
+/* @framer/ai CLI v0.0.22 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// package.json
+var name = "framer-dalton";
+
+// src/check-node-version.ts
+var MINIMUM_NODE_VERSION = 22;
+var currentMajor = Number(process.versions.node.split(".")[0]);
+if (currentMajor < MINIMUM_NODE_VERSION) {
+  console.error(
+    `${name} requires Node.js >= ${MINIMUM_NODE_VERSION}. You are running Node.js ${process.versions.node}.
+Please upgrade: https://nodejs.org/`
+  );
+  process.exit(1);
+}
 function openUrl(url) {
   const platform = process.platform;
   let cmd;
@@ -36,27 +50,27 @@ function openUrl(url) {
 __name(openUrl, "openUrl");
 function getConfigDir() {
   if (process.env.XDG_CONFIG_HOME) {
-    return path6.join(process.env.XDG_CONFIG_HOME, "framer");
+    return path7.join(process.env.XDG_CONFIG_HOME, "framer");
   }
   if (process.platform === "win32") {
-    return path6.join(process.env.APPDATA || os.homedir(), "framer");
+    return path7.join(process.env.APPDATA || os.homedir(), "framer");
   }
-  return path6.join(os.homedir(), ".config", "framer");
+  return path7.join(os.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
 function ensureConfigDir() {
   const configDir = getConfigDir();
-  fs6.mkdirSync(configDir, { recursive: true, mode: 448 });
+  fs7.mkdirSync(configDir, { recursive: true, mode: 448 });
 }
 __name(ensureConfigDir, "ensureConfigDir");
 
 // src/config/projects.ts
 function getProjectsConfigPath() {
-  return path6.join(getConfigDir(), "projects.json");
+  return path7.join(getConfigDir(), "projects.json");
 }
 __name(getProjectsConfigPath, "getProjectsConfigPath");
 function getLegacyCredentialsPath() {
-  return path6.join(getConfigDir(), "credentials.json");
+  return path7.join(getConfigDir(), "credentials.json");
 }
 __name(getLegacyCredentialsPath, "getLegacyCredentialsPath");
 var ProjectsConfigSchema = z.object({
@@ -74,7 +88,7 @@ var ProjectsConfigSchema = z.object({
 var LegacyCredentialsSchema = z.record(z.string(), z.string());
 function readJsonFile(filePath) {
   try {
-    return JSON.parse(fs6.readFileSync(filePath, "utf-8"));
+    return JSON.parse(fs7.readFileSync(filePath, "utf-8"));
   } catch (_error) {
     return null;
   }
@@ -82,7 +96,7 @@ function readJsonFile(filePath) {
 __name(readJsonFile, "readJsonFile");
 function writeProjectsConfig(config) {
   ensureConfigDir();
-  fs6.writeFileSync(
+  fs7.writeFileSync(
     getProjectsConfigPath(),
     JSON.stringify(config, null, "	"),
     {
@@ -109,7 +123,7 @@ function migrateLegacyCredentials() {
   }
   const config = { version: 2, projects };
   writeProjectsConfig(config);
-  fs6.rmSync(getLegacyCredentialsPath(), { force: true });
+  fs7.rmSync(getLegacyCredentialsPath(), { force: true });
   return config;
 }
 __name(migrateLegacyCredentials, "migrateLegacyCredentials");
@@ -122,23 +136,24 @@ function readProjectsConfig() {
       return result.data;
     }
   }
-  if (fs6.existsSync(getLegacyCredentialsPath())) {
+  if (fs7.existsSync(getLegacyCredentialsPath())) {
     return migrateLegacyCredentials();
   }
   return { version: 2, projects: {} };
 }
 __name(readProjectsConfig, "readProjectsConfig");
+var REMIX_URL_PATTERN = /\/remix\/([a-zA-Z0-9]+)/;
 function extractProjectId(input) {
   if (/^[a-zA-Z0-9]+$/.test(input)) {
     return input;
   }
+  const remixMatch = input.match(REMIX_URL_PATTERN);
+  if (remixMatch) return remixMatch[1];
   const candidate = input.match(/\/projects\/([^/?#]+)/)?.[1] ?? input;
   const slugMatch = candidate.match(
     /^(?:.+--)?([a-zA-Z0-9]+)(?:-[a-zA-Z0-9]+)?$/
   );
-  if (slugMatch) {
-    return slugMatch[1];
-  }
+  if (slugMatch) return slugMatch[1];
   return input;
 }
 __name(extractProjectId, "extractProjectId");
@@ -204,7 +219,7 @@ var SettingsWatcher = class {
     __name(this, "SettingsWatcher");
   }
   start(callback) {
-    fs6.watchFile(
+    fs7.watchFile(
       this.settingsPath,
       { persistent: false, interval: fsPollIntervalMs },
       (curr, prev) => {
@@ -221,7 +236,7 @@ var SettingsWatcher = class {
     return this;
   }
   stop() {
-    fs6.unwatchFile(this.settingsPath);
+    fs7.unwatchFile(this.settingsPath);
     return this;
   }
 };
@@ -239,7 +254,7 @@ var SettingsFileSchema = z.object({
   telemetryNoticeShown: z.boolean().optional()
 });
 function getSettingsPath() {
-  return path6.join(getConfigDir(), "settings.json");
+  return path7.join(getConfigDir(), "settings.json");
 }
 __name(getSettingsPath, "getSettingsPath");
 var settings;
@@ -258,7 +273,7 @@ __name(getSettings, "getSettings");
 function readSettingsFile() {
   const settingsPath = getSettingsPath();
   try {
-    const raw = JSON.parse(fs6.readFileSync(settingsPath, "utf-8"));
+    const raw = JSON.parse(fs7.readFileSync(settingsPath, "utf-8"));
     const result = SettingsFileSchema.parse(raw);
     return {
       machineId: result.machineId ?? DEFAULT_SETTINGS.machineId,
@@ -277,7 +292,7 @@ function setSettings(newSettings) {
 __name(setSettings, "setSettings");
 function writeSettingsFile(settings2) {
   ensureConfigDir();
-  fs6.writeFileSync(getSettingsPath(), JSON.stringify(settings2, null, "	"), {
+  fs7.writeFileSync(getSettingsPath(), JSON.stringify(settings2, null, "	"), {
     mode: 384
   });
 }
@@ -313,7 +328,7 @@ __name(markTelemetryNoticeShown, "markTelemetryNoticeShown");
 // src/version.ts
 var VERSION = (
   // typeof is used to ensure this can be used just via tsx or node etc. without build
-  "0.0.20" 
+  "0.0.22" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
@@ -499,11 +514,11 @@ body{font-family:"Inter",system-ui,-apple-system,sans-serif;font-feature-setting
 </html>`;
 }
 __name(htmlPage, "htmlPage");
-function successHtml(theme) {
+function successHtml(theme, message) {
   return htmlPage({
     title: "Framer \u2014 Agent Approved",
     heading: "Agent Approved",
-    message: "Your local agent now has edit access to the project. You can close this tab and continue with the local agent.",
+    message: message ?? "Your local agent now has edit access to the project. You can close this tab and continue with the local agent.",
     theme
   });
 }
@@ -537,19 +552,31 @@ function parseCode(value) {
   return null;
 }
 __name(parseCode, "parseCode");
+function isFramerHostname(hostname) {
+  return hostname === "framer.com" || hostname === "framerlocal.com" || hostname.endsWith(".framer.com") || hostname.endsWith(".framerlocal.com");
+}
+__name(isFramerHostname, "isFramerHostname");
 function resolveProjectOrigin(projectUrlOrId) {
   try {
-    return new URL(projectUrlOrId).origin;
+    const url = new URL(projectUrlOrId);
+    if (isFramerHostname(url.hostname.toLowerCase())) return url.origin;
   } catch {
-    return "https://framer.com";
   }
+  return "https://framer.com";
 }
 __name(resolveProjectOrigin, "resolveProjectOrigin");
-async function acquireAuthFromBrowser(projectUrlOrId) {
-  const projectId = extractProjectId(projectUrlOrId);
-  const projectOrigin = resolveProjectOrigin(projectUrlOrId);
+function runBrowserAuthFlow(options) {
+  const {
+    deeplinkParams,
+    expectProjectId,
+    successMessage,
+    browserSuccessMessage,
+    projectOrigin = "https://framer.com",
+    authType,
+    pollProjectId
+  } = options;
   const state = crypto.randomBytes(16).toString("hex");
-  trackAuthStart({ projectId });
+  trackAuthStart({ projectId: pollProjectId ?? "unknown", authType });
   return new Promise((resolve, reject) => {
     let settled = false;
     let pendingAuth = null;
@@ -566,16 +593,17 @@ async function acquireAuthFromBrowser(projectUrlOrId) {
       if (url.pathname === "/done") {
         const theme2 = parseTheme(url.searchParams.get("theme"));
         res.writeHead(200, { "Content-Type": "text/html" });
-        res.end(successHtml(theme2), () => {
+        res.end(successHtml(theme2, browserSuccessMessage), () => {
           if (pendingAuth) {
             const auth = pendingAuth;
             pendingAuth = null;
             settle(() => {
               debug("auth", "received API key via /done, resolving");
-              print("\u2713 Agent authorized");
+              print(`\u2713 ${successMessage}`);
               trackAuthSuccess({
-                projectId,
+                projectId: auth.projectId ?? pollProjectId ?? "unknown",
                 authMethod: "browser",
+                authType,
                 userId: auth.userId
               });
               resolve(auth);
@@ -596,16 +624,14 @@ async function acquireAuthFromBrowser(projectUrlOrId) {
         return;
       }
       const theme = parseTheme(url.searchParams.get("theme"));
-      const legacyError = url.searchParams.get("error");
-      const legacyCode = legacyError === "denied" ? "user.denied" : legacyError === "failed" ? "project.unauthorized" : null;
-      const code = parseCode(url.searchParams.get("code")) ?? legacyCode;
+      const code = parseCode(url.searchParams.get("code"));
       if (code !== null) {
         res.writeHead(200, { "Content-Type": "text/html" });
         res.end(codeHtml(code, theme), () => {
           settle(() => {
             trackError({
               errorType: "auth_error",
-              projectId,
+              projectId: pollProjectId ?? "unknown",
               errorMessage: codeMessages[code]
             });
             reject(new Error(codeMessages[code]));
@@ -615,57 +641,65 @@ async function acquireAuthFromBrowser(projectUrlOrId) {
       }
       const apiKey = url.searchParams.get("apiKey");
       const userId = url.searchParams.get("userId") ?? void 0;
+      const returnedProjectId = url.searchParams.get("projectId") ?? void 0;
       const returnedState = url.searchParams.get("state");
-      if (!apiKey || returnedState !== state) {
+      if (!apiKey || returnedState !== state || expectProjectId && !returnedProjectId) {
         res.writeHead(302, { Location: `/error?theme=${theme}` });
         res.end();
         return;
       }
       debug("auth", "received valid callback, redirecting to /done");
-      pendingAuth = { apiKey, userId };
+      pendingAuth = { apiKey, userId, projectId: returnedProjectId };
       res.writeHead(302, { Location: `/done?theme=${theme}` });
       res.end();
     });
     const POLL_INTERVAL_MS = 1e3;
-    const pollTimer = setInterval(() => {
-      const project2 = getProject(projectId);
+    const pollTimer = pollProjectId ? setInterval(() => {
+      const project2 = getProject(pollProjectId);
       if (project2) {
         settle(() => {
           debug("auth", "API key detected from config file poll");
           print("\u2713 API key detected from config");
           trackAuthSuccess({
-            projectId,
+            projectId: pollProjectId,
             authMethod: "config_poll",
+            authType,
+            userId: project2.userId
+          });
+          resolve({
+            apiKey: project2.apiKey,
             userId: project2.userId
           });
-          resolve({ apiKey: project2.apiKey, userId: project2.userId });
         });
       }
-    }, POLL_INTERVAL_MS);
+    }, POLL_INTERVAL_MS) : null;
     const HINT_MS = 55e3;
-    const hintTimer = setTimeout(() => {
-      const settingsUrl = new URL(`/projects/${projectId}`, projectOrigin);
+    const hintTimer = pollProjectId ? setTimeout(() => {
+      const settingsUrl = new URL(
+        `/projects/${pollProjectId}`,
+        projectOrigin
+      );
       settingsUrl.searchParams.set("view", "settings:project");
       print("");
       printError("Taking a while? You can generate an API key manually:");
       printError(`  1. Open Site Settings \u2192 General: ${settingsUrl}`);
       printError("  2. Scroll to API Keys and create a new key");
       printError(
-        `  3. In another terminal, run: framer project auth ${projectId} <your-api-key>`
+        `  3. In another terminal, run: framer project auth ${pollProjectId} <your-api-key>`
       );
       print("");
       print("Waiting for authorization in browser...");
-    }, HINT_MS);
+    }, HINT_MS) : null;
     const timer = setTimeout(() => {
       settle(() => {
         trackError({
           errorType: "auth_timeout",
-          projectId,
+          projectId: pollProjectId ?? "unknown",
           errorMessage: "Browser authorization timed out"
         });
         reject(
           new Error(
-            "Browser authorization timed out. Use `framer project auth <projectUrlOrId> <apiKey>` instead."
+            pollProjectId ? "Browser authorization timed out. Use `framer project auth <projectUrlOrId> <apiKey>` instead." : "Browser authorization timed out."
           )
         );
       });
@@ -676,8 +710,8 @@ async function acquireAuthFromBrowser(projectUrlOrId) {
       cleaned = true;
       debug("auth", "cleanup: clearing timers and closing server");
       clearTimeout(timer);
-      clearTimeout(hintTimer);
-      clearInterval(pollTimer);
+      if (hintTimer) clearTimeout(hintTimer);
+      if (pollTimer) clearInterval(pollTimer);
       server.close();
       server.closeAllConnections();
     }
@@ -696,7 +730,9 @@ async function acquireAuthFromBrowser(projectUrlOrId) {
       const deeplink = new URL("/projects/server-api/auth", projectOrigin);
       deeplink.searchParams.set("callback", callbackUrl);
       deeplink.searchParams.set("state", state);
-      deeplink.searchParams.set("projectId", projectId);
+      for (const [key, value] of Object.entries(deeplinkParams)) {
+        deeplink.searchParams.set(key, value);
+      }
       const deeplinkStr = deeplink.toString();
       debug("auth", "opening browser for deeplink...");
       openUrl(deeplinkStr).then((opened) => {
@@ -711,7 +747,48 @@ async function acquireAuthFromBrowser(projectUrlOrId) {
     });
   });
 }
+__name(runBrowserAuthFlow, "runBrowserAuthFlow");
+async function acquireAuthFromBrowser(projectUrlOrId) {
+  const projectId = extractProjectId(projectUrlOrId);
+  const projectOrigin = resolveProjectOrigin(projectUrlOrId);
+  return runBrowserAuthFlow({
+    deeplinkParams: { projectId },
+    expectProjectId: false,
+    successMessage: "Agent authorized",
+    authType: "existing",
+    projectOrigin,
+    pollProjectId: projectId
+  });
+}
 __name(acquireAuthFromBrowser, "acquireAuthFromBrowser");
+async function acquireAuthWithNewProject() {
+  return runBrowserAuthFlow({
+    deeplinkParams: { createProject: "true" },
+    expectProjectId: true,
+    successMessage: "Project created and agent authorized",
+    authType: "new_project",
+    browserSuccessMessage: "A new project has been created and your local agent is authorized to edit it. You can close this tab."
+  });
+}
+__name(acquireAuthWithNewProject, "acquireAuthWithNewProject");
+async function acquireAuthWithRemixProject(sourceProjectUrlOrId) {
+  const sourceProjectId = extractProjectId(sourceProjectUrlOrId);
+  const projectOrigin = resolveProjectOrigin(sourceProjectUrlOrId);
+  const isRemixSlug = REMIX_URL_PATTERN.test(sourceProjectUrlOrId);
+  const deeplinkParams = {
+    duplicate: sourceProjectId
+  };
+  if (isRemixSlug) deeplinkParams.isRemixSlug = "true";
+  return runBrowserAuthFlow({
+    deeplinkParams,
+    expectProjectId: true,
+    successMessage: "Project remixed and agent authorized",
+    authType: "remix",
+    browserSuccessMessage: "The project has been remixed and your local agent is authorized to edit it. You can close this tab.",
+    projectOrigin
+  });
+}
+__name(acquireAuthWithRemixProject, "acquireAuthWithRemixProject");
 
 // src/connection-errors.ts
 var AUTH_ERROR_PATTERNS = ["does not have access", "UNAUTHORIZED"];
@@ -933,7 +1010,7 @@ var types = {
     name: "AiServiceVersion",
     description: "Major version segment for the Framer AI chat HTTP path (`/ai/v{version}/chat/`).",
     kind: "alias",
-    alias: '"2" | "3"',
+    alias: '"3"',
     references: []
   },
   allmethods: {
@@ -3911,8 +3988,8 @@ var types = {
     name: "FontStyle",
     description: "",
     kind: "alias",
-    alias: 'Pick<CSSProperties, "fontFamily" | "fontWeight" | "fontStyle" | "fontSize" | "lineHeight" | "textAlign" | "letterSpacing" | "fontFeatureSettings">',
-    references: ["CSSProperties"]
+    alias: 'Pick<CSS.Properties<string | number>, "fontFamily" | "fontWeight" | "fontStyle" | "fontSize" | "lineHeight" | "textAlign" | "letterSpacing" | "fontFeatureSettings">',
+    references: ["CSS.Properties"]
   },
   fontstyle$1: {
     name: "FontStyle$1",
@@ -7056,6 +7133,78 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "publishForAgent",
+        type: "(input?: Record<string, unknown>) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "queryImagesForAgent",
+        type: "(input: Record<string, unknown>) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "reviewChangesForAgent",
+        type: "(options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "flattenComponentInstanceForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "makeExternalComponentLocalForAgent",
+        type: "(input: {\n        id: string;\n        replaceAll?: boolean;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getNodeForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getNodesForAgent",
+        type: "(input: {\n        ids: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getNodesOfTypesForAgent",
+        type: "(input: {\n        types: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getScopeNodeForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getGroundNodeForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getParentNodeForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getAncestorsForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "startAgentConversation",
         type: "(prompt: string, options?: StartAgentConversationOptions) => Promise<StartAgentConversationResult>",
@@ -7074,6 +7223,12 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "runSupervisorAgentCommand",
+        type: "(options: RunSupervisorAgentCommandOptions) => Promise<RunSupervisorAgentCommandResult>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "[getAiServiceInfoMessageType]",
         type: "(version?: AiServiceVersion) => Promise<AiServiceInfo>",
@@ -7496,6 +7651,58 @@ var types = {
     alias: '"auto" | "lossless" | "small" | "medium" | "large" | "full"',
     references: []
   },
+  runsupervisoragentcommandoptions: {
+    name: "RunSupervisorAgentCommandOptions",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "goal",
+        type: "string",
+        description: "",
+        optional: false
+      },
+      {
+        name: "model",
+        type: "string",
+        description: "",
+        optional: false
+      },
+      {
+        name: "pagePath",
+        type: "string",
+        description: "",
+        optional: true
+      },
+      {
+        name: "maxSteps",
+        type: "number",
+        description: "",
+        optional: true
+      }
+    ]
+  },
+  runsupervisoragentcommandresult: {
+    name: "RunSupervisorAgentCommandResult",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "filename",
+        type: "string",
+        description: "",
+        optional: false
+      },
+      {
+        name: "archiveBase64",
+        type: "string",
+        description: "",
+        optional: false
+      }
+    ]
+  },
   screenshotoptions: {
     name: "ScreenshotOptions",
     description: "",
@@ -9203,7 +9410,7 @@ var types = {
       {
         name: "aspectRatio",
         type: "number | null",
-        description: "Width-to-height ratio (e.g. `1.5` for 3:2).\nSetting to `null` removes the aspect ratio constraint.\nSupported by FrameNode, ComponentInstanceNode.",
+        description: "Width-to-height ratio (e.g. `1.5` for 3:2).\n\nSetting to `null` removes the aspect ratio constraint.\nSupported by FrameNode, ComponentInstanceNode.",
         optional: false
       }
     ]
@@ -9257,7 +9464,7 @@ var types = {
       {
         name: "backgroundColor",
         type: "(T extends TraitVariantData ? ColorStyleData : ColorStyle) | string | null",
-        description: "Background color in RGBA format (e.g. `rgba(242, 59, 57, 1)`) or as a {@link ColorStyle} instance.\nSetting to `null` removes the background color. Supported by FrameNode.",
+        description: "Background color in RGBA format (e.g. `rgba(242, 59, 57, 1)`) or as a {@link ColorStyle} instance.\n\nSetting to `null` removes the background color. Supported by FrameNode.",
         optional: false
       }
     ]
@@ -9341,7 +9548,7 @@ var types = {
       {
         name: "borderRadius",
         type: "BorderRadius",
-        description: 'Border radius for rounded corners. Single value (e.g. `"10px"` or `"50%"`)\nor per-corner (e.g. `"10px 20px 30px 40px"` for top-left, top-right, bottom-right, bottom-left).\nSetting to `null` removes the border radius. Supported by FrameNode.',
+        description: 'Border radius for rounded corners.\n\nSingle value (e.g. `"10px"` or `"50%"`)\nor per-corner (e.g. `"10px 20px 30px 40px"` for top-left, top-right, bottom-right, bottom-left).\nSetting to `null` removes the border radius. Supported by FrameNode.',
         optional: false
       }
     ]
@@ -9355,7 +9562,7 @@ var types = {
       {
         name: "border",
         type: "(T extends TraitVariantData ? Marshaled<Border> : Border) | null",
-        description: 'Border properties including width, color, and style.\nStyles: `"solid"`, `"dashed"`, `"dotted"`, `"double"`.\nWidth can be per-side (e.g. `"1px 2px 3px 4px"`).\nSetting to `null` removes the border. Supported by FrameNode.',
+        description: 'Border properties including width, color, and style.\n\nStyles: `"solid"`, `"dashed"`, `"dotted"`, `"double"`.\nWidth can be per-side (e.g. `"1px 2px 3px 4px"`).\nSetting to `null` removes the border. Supported by FrameNode.',
         optional: false
       }
     ]
@@ -9717,37 +9924,37 @@ var types = {
       {
         name: "gridItemFillCellWidth",
         type: "boolean | null",
-        description: "Whether to fill the grid cell width. For nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
+        description: "Whether to fill the grid cell width.\n\nFor nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
         optional: false
       },
       {
         name: "gridItemFillCellHeight",
         type: "boolean | null",
-        description: "Whether to fill the grid cell height. For nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
+        description: "Whether to fill the grid cell height.\n\nFor nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
         optional: false
       },
       {
         name: "gridItemHorizontalAlignment",
         type: "GridItemAlignment | null",
-        description: 'Horizontal alignment within grid cell. For nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
+        description: 'Horizontal alignment within grid cell.\n\nFor nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
         optional: false
       },
       {
         name: "gridItemVerticalAlignment",
         type: "GridItemAlignment | null",
-        description: 'Vertical alignment within grid cell. For nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
+        description: 'Vertical alignment within grid cell.\n\nFor nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
         optional: false
       },
       {
         name: "gridItemColumnSpan",
         type: "GridItemColumnSpan | null",
-        description: 'Number of columns to span, or `"all"` for all columns. For nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.',
+        description: 'Number of columns to span, or `"all"` for all columns.\n\nFor nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.',
         optional: false
       },
       {
         name: "gridItemRowSpan",
         type: "number | null",
-        description: "Number of rows to span. For nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.",
+        description: "Number of rows to span.\n\nFor nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.",
         optional: false
       }
     ]
@@ -9782,7 +9989,7 @@ var types = {
       {
         name: "imageRendering",
         type: "ImageRendering | null",
-        description: 'How images should be rendered when scaled: `"auto"` or `"pixelated"`.\nOnly applies to frames with image backgrounds.\nSetting to `null` uses default rendering. Supported by FrameNode.',
+        description: 'How images should be rendered when scaled: `"auto"` or `"pixelated"`.\n\nOnly applies to frames with image backgrounds.\nSetting to `null` uses default rendering. Supported by FrameNode.',
         optional: false
       }
     ]
@@ -9824,7 +10031,7 @@ var types = {
       {
         name: "inlineTextStyle",
         type: "(T extends TraitVariantData ? TextStyleData : TextStyle) | null",
-        description: "Apply a text style preset. Setting to `null` removes the text style.\nSupported by TextNode.",
+        description: "Apply a text style preset.\n\nSetting to `null` removes the text style. Supported by TextNode.",
         optional: false
       }
     ]
@@ -9858,19 +10065,19 @@ var types = {
       {
         name: "layout",
         type: "LayoutType | null",
-        description: "Enables stack or grid layout. Setting to `null` disables any applied layout.\nOperation is deferred and applied after the current update cycle. Supported by FrameNode.",
+        description: "Enables stack or grid layout.\n\nSetting to `null` disables any applied layout.\nOperation is deferred and applied after the current update cycle. Supported by FrameNode.",
         optional: false
       },
       {
         name: "gap",
         type: "CSSDimension<CSSUnit.Pixel> | `${CSSDimension<CSSUnit.Pixel>} ${CSSDimension<CSSUnit.Pixel>}` | null",
-        description: 'Spacing between items in a layout. Single value (e.g. `"10px"`) applies to both axes;\ntwo values (e.g. `"10px 20px"`) set horizontal and vertical separately.\nOnly works with layout enabled. Supported by FrameNode.',
+        description: 'Spacing between items in a layout.\n\nSingle value (e.g. `"10px"`) applies to both axes;\ntwo values (e.g. `"10px 20px"`) set horizontal and vertical separately.\nOnly works with layout enabled. Supported by FrameNode.',
         optional: false
       },
       {
         name: "padding",
         type: "CSSDimension<CSSUnit.Pixel> | `${CSSDimension<CSSUnit.Pixel>} ${CSSDimension<CSSUnit.Pixel>} ${CSSDimension<CSSUnit.Pixel>} ${CSSDimension<CSSUnit.Pixel>}` | null",
-        description: 'Inner spacing of a container with layout. Single value (e.g. `"10px"`) applies to all sides;\nfour values (e.g. `"10px 20px 30px 40px"`) set top, right, bottom, left.\nOnly works with layout enabled. Supported by FrameNode.',
+        description: 'Inner spacing of a container with layout.\n\nSingle value (e.g. `"10px"`) applies to all sides;\nfour values (e.g. `"10px 20px 30px 40px"`) set top, right, bottom, left.\nOnly works with layout enabled. Supported by FrameNode.',
         optional: false
       }
     ],
@@ -9885,13 +10092,13 @@ var types = {
       {
         name: "link",
         type: "string | null",
-        description: 'URL or internal page link. External: `"https://example.com"`, internal: `"/about"`,\nemail: `"mailto:user@example.com"`. Setting to `null` removes the link.\nSupported by FrameNode, TextNode.',
+        description: 'URL or internal page link.\n\nExternal: `"https://example.com"`, internal: `"/about"`,\nemail: `"mailto:user@example.com"`. Setting to `null` removes the link.\nSupported by FrameNode, TextNode.',
         optional: false
       },
       {
         name: "linkOpenInNewTab",
         type: "boolean | null",
-        description: "Whether to open the link in a new tab. Default is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
+        description: "Whether to open the link in a new tab.\n\nDefault is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
         optional: false
       },
       {
@@ -9957,7 +10164,7 @@ var types = {
       {
         name: "locked",
         type: "boolean",
-        description: "Whether the node is locked for editing. Defaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+        description: "Whether the node is locked for editing.\n\nDefaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
         optional: false
       }
     ]
@@ -9999,7 +10206,7 @@ var types = {
       {
         name: "name",
         type: "string | null",
-        description: "The name of the node displayed in the layers panel.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
+        description: "The name of the node displayed in the layers panel.\n\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
         optional: false
       }
     ]
@@ -10083,7 +10290,7 @@ var types = {
       {
         name: "opacity",
         type: "number",
-        description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque). Defaults to `1`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+        description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque).\n\nDefaults to `1`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
         optional: false
       }
     ]
@@ -10118,19 +10325,19 @@ var types = {
       {
         name: "overflow",
         type: "Overflow | null",
-        description: "Controls how content that exceeds the element's box is handled.\nSetting to `null` removes the overflow property. Will overwrite `overflowX` or `overflowY`.\nSupported by FrameNode, TextNode.",
+        description: "Controls how content that exceeds the element's box is handled.\n\nSetting to `null` removes the overflow property. Will overwrite `overflowX` or `overflowY`.\nSupported by FrameNode, TextNode.",
         optional: false
       },
       {
         name: "overflowX",
         type: "AxisOverflow | null",
-        description: "Controls horizontal overflow behavior.\nSetting to `null` removes the overflow X property. Supported by FrameNode, TextNode.",
+        description: "Controls horizontal overflow behavior.\n\nSetting to `null` removes the overflow X property. Supported by FrameNode, TextNode.",
         optional: false
       },
       {
         name: "overflowY",
         type: "AxisOverflow | null",
-        description: "Controls vertical overflow behavior.\nSetting to `null` removes the overflow Y property. Supported by FrameNode, TextNode.",
+        description: "Controls vertical overflow behavior.\n\nSetting to `null` removes the overflow Y property. Supported by FrameNode, TextNode.",
         optional: false
       }
     ]
@@ -10144,37 +10351,37 @@ var types = {
       {
         name: "top",
         type: "CSSDimension<CSSUnit.Pixel> | null",
-        description: 'Distance from top edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+        description: 'Distance from top edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
         optional: false
       },
       {
         name: "right",
         type: "CSSDimension<CSSUnit.Pixel> | null",
-        description: 'Distance from right edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+        description: 'Distance from right edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
         optional: false
       },
       {
         name: "bottom",
         type: "CSSDimension<CSSUnit.Pixel> | null",
-        description: 'Distance from bottom edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+        description: 'Distance from bottom edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
         optional: false
       },
       {
         name: "left",
         type: "CSSDimension<CSSUnit.Pixel> | null",
-        description: 'Distance from left edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+        description: 'Distance from left edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
         optional: false
       },
       {
         name: "centerX",
         type: "CSSDimension<CSSUnit.Percentage> | null",
-        description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+        description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
         optional: false
       },
       {
         name: "centerY",
         type: "CSSDimension<CSSUnit.Percentage> | null",
-        description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+        description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
         optional: false
       }
     ]
@@ -10202,7 +10409,7 @@ var types = {
       {
         name: "rotation",
         type: "number",
-        description: "Rotation angle in degrees. Defaults to `0`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+        description: "Rotation angle in degrees.\n\nDefaults to `0`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
         optional: false
       }
     ]
@@ -10248,13 +10455,13 @@ var types = {
       {
         name: "width",
         type: "WidthLength | null",
-        description: 'Width of the node. Accepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+        description: 'Width of the node.\n\nAccepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
         optional: false
       },
       {
         name: "height",
         type: "HeightLength | null",
-        description: 'Height of the node. Accepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+        description: 'Height of the node.\n\nAccepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
         optional: false
       }
     ]
@@ -10324,7 +10531,7 @@ var types = {
       {
         name: "textTruncation",
         type: "number | null",
-        description: "Maximum number of lines a text node can display before being truncated with an ellipsis.\nMust be used alongside `overflow`. Setting to `null` removes the text truncation property.\nSupported by TextNode.",
+        description: "Maximum number of lines before text is truncated with an ellipsis.\n\nMust be used alongside `overflow`. Setting to `null` removes the text truncation property.\nSupported by TextNode.",
         optional: false
       }
     ]
@@ -10408,7 +10615,7 @@ var types = {
       {
         name: "visible",
         type: "boolean",
-        description: "Whether the node is visible on the canvas. Defaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+        description: "Whether the node is visible on the canvas.\n\nDefaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
         optional: false
       }
     ]
@@ -10422,7 +10629,7 @@ var types = {
       {
         name: "zIndex",
         type: "number | null",
-        description: "Stacking order of positioned elements. Higher values appear on top of lower values.\nSetting to `null` removes the z-index property. Supported by FrameNode, TextNode.",
+        description: "Stacking order of positioned elements.\n\nHigher values appear on top of lower values.\nSetting to `null` removes the z-index property. Supported by FrameNode, TextNode.",
         optional: false
       }
     ]
@@ -10451,55 +10658,55 @@ var types = {
 var classes = {
   arrayfield: {
     name: "ArrayField",
-    description: "A CMS Collection field that stores an array of nested fields. Currently only\nsupports a single image field, which creates a Gallery in the CMS."
+    description: "A CMS Collection field that stores an array of nested fields. Currently only\nsupports a single image field, which creates a Gallery in the CMS.\n@category cms"
   },
   booleanfield: {
     name: "BooleanField",
-    description: "A CMS Collection field that stores a boolean (true or false) value."
+    description: "A CMS Collection field that stores a boolean (true or false) value.\n@category cms"
   },
   booleanvariable: {
     name: "BooleanVariable",
-    description: ""
+    description: "A boolean variable.\n@category canvas"
   },
   bordervariable: {
     name: "BorderVariable",
-    description: ""
+    description: "A border variable.\n@category canvas"
   },
   codefile: {
     name: "CodeFile",
-    description: "Represents a code file in the Framer project, such as a code component\nor code override."
+    description: "Represents a code file in the Framer project, such as a code component\nor code override.\n@category code-files"
   },
   codefileversion: {
     name: "CodeFileVersion",
-    description: "A saved version (snapshot) of a code file."
+    description: "A saved version (snapshot) of a code file.\n@category code-files"
   },
   collection: {
     name: "Collection",
-    description: "A CMS Collection in the project. Collections can be created by users or\nmanaged by plugins. Use `managedBy` to check the owner.\n\nAny kind of Collection can be read from. Unmanaged Collections are those\ncreated and updated by people. Use the `collection` mode to access CMS\ndata from your plugin."
+    description: "A CMS Collection in the project.\n\nCollections can be created by users or managed by plugins. Use `managedBy`\nto check the owner. Any kind of Collection can be read from, while those\nmanaged by other plugins are read-only.\n@category cms"
   },
   collectionitem: {
     name: "CollectionItem",
-    description: "An item (row) in a CMS Collection. Each item contains field data keyed by\nfield ID, a unique slug, and a draft status."
+    description: "An item (row) in a CMS Collection.\n\nEach item contains field data keyed by field ID, a unique slug, and a\ndraft status.\n@category cms"
   },
   collectionreferencefield: {
     name: "CollectionReferenceField",
-    description: "A field that references an item in another collection."
+    description: "A field that references an item in another collection.\n@category cms"
   },
   colorfield: {
     name: "ColorField",
-    description: "A CMS Collection field that stores a color value (RGBA/HSL/HEX format)."
+    description: "A CMS Collection field that stores a color value (RGBA/HSL/HEX format).\n@category cms"
   },
   colorstyle: {
     name: "ColorStyle",
-    description: 'A reusable color style defined in the project. Supports light and dark\ntheme variants. Color styles let you manage color appearances from one\nplace in a project. In the UI, you can find them in the Assets panel.\nPlugins can use these styles to do things like sync design systems or\ncheck accessibility.\n\nColors are stored in RGBA format, e.g. `rgba(242, 59, 57, 1)`. The\n`light` attribute is the default color used in light theme. The `dark`\nattribute is an optional color used in the dark theme.\n\nTo organize color styles into folders, use `/` as a separator in the\nname, e.g. `"My Plugin/My Cool Color"`.\n\n@example\n```ts\n// Create a new color style with light and dark variants.\nconst colorStyle = await framer.createColorStyle({\n  name: "My Cool Color",\n  light: "rgba(242, 59, 57, 1)",\n  dark: "rgba(120, 22, 11, 1)"\n})\n\n// Update an existing color style.\nawait colorStyle.setAttributes({ dark: "rgba(10, 10, 10, 0.2)" })\n\n// Remove a color style from the project.\nawait colorStyle.remove()\n\n// Store plugin data on a color style.\nawait colorStyle.setPluginData("key", "value")\n```'
+    description: 'A reusable color style defined in the project. Supports light and dark\ntheme variants. Color styles let you manage color appearances from one\nplace in a project. In the UI, you can find them in the Assets panel.\nPlugins can use these styles to do things like sync design systems or\ncheck accessibility.\n\nColors are stored in RGBA format, e.g. `rgba(242, 59, 57, 1)`. The\n`light` attribute is the default color used in light theme. The `dark`\nattribute is an optional color used in the dark theme.\n\nTo organize color styles into folders, use `/` as a separator in the\nname, e.g. `"My Plugin/My Cool Color"`.\n\n@example\n```ts\n// Create a new color style with light and dark variants.\nconst colorStyle = await framer.createColorStyle({\n  name: "My Cool Color",\n  light: "rgba(242, 59, 57, 1)",\n  dark: "rgba(120, 22, 11, 1)"\n})\n\n// Update an existing color style.\nawait colorStyle.setAttributes({ dark: "rgba(10, 10, 10, 0.2)" })\n\n// Remove a color style from the project.\nawait colorStyle.remove()\n\n// Store plugin data on a color style.\nawait colorStyle.setPluginData("key", "value")\n```\n@category canvas'
   },
   colorvariable: {
     name: "ColorVariable",
-    description: ""
+    description: "A color variable.\n@category canvas"
   },
   componentinstancenode: {
     name: "ComponentInstanceNode",
-    description: "An instance of a code or design component on the canvas. Component\ninstances are identified by their {@link ComponentInstanceNode.componentIdentifier | componentIdentifier}\nand can have their control properties updated via\n{@link NodeMethods.setAttributes | setAttributes}.\n\n@example\n```ts\nif (isCodeComponentNode(selection)) {\n  selection.setAttributes({\n    controls: { radius: 10 }\n  })\n}\n```"
+    description: "An instance of a code or design component on the canvas.\n\nComponent instances are identified by their\n{@link ComponentInstanceNode.componentIdentifier | componentIdentifier}\nand can have their control properties updated via\n{@link NodeMethods.setAttributes | setAttributes}.\n\n@example\n```ts\nif (isCodeComponentNode(selection)) {\n  selection.setAttributes({\n    controls: { radius: 10 }\n  })\n}\n```\n@category canvas"
   },
   componentinstanceplaceholder: {
     name: "ComponentInstancePlaceholder",
@@ -10507,35 +10714,35 @@ var classes = {
   },
   componentnode: {
     name: "ComponentNode",
-    description: "A reusable design component definition. Component nodes contain\nvariants, gesture states, and variables. They can be inserted as\ninstances via their module URL."
+    description: "A reusable design component definition.\n\nComponent nodes contain variants, gesture states, and variables.\nThey can be inserted as instances via their module URL.\n@category canvas"
   },
   conicgradient: {
     name: "ConicGradient",
-    description: ""
+    description: "A conic (angular) gradient with two or more color stops.\n@category canvas"
   },
   datefield: {
     name: "DateField",
-    description: "A CMS Collection field that stores a date in UTC format. Optionally displays time."
+    description: "A CMS Collection field that stores a date in UTC format. Optionally displays time.\n@category cms"
   },
   datevariable: {
     name: "DateVariable",
-    description: ""
+    description: "A date variable.\n@category canvas"
   },
   designpagenode: {
     name: "DesignPageNode",
-    description: "A design page (non-web canvas) in the project."
+    description: "A design page (non-web canvas) in the project.\n@category canvas"
   },
   enumcase: {
     name: "EnumCase",
-    description: "An individual case (option) within an Enum Field or Enum Variable."
+    description: "An individual case (option) within an Enum Field or Enum Variable.\n@category cms"
   },
   enumfield: {
     name: "EnumField",
-    description: "A CMS Collection field with a fixed set of enum cases (options) that the user\ncan choose from. Enum cases must be defined as options before they can be\nassigned to CMS items."
+    description: "A CMS Collection field with a fixed set of enum cases (options) that the user\ncan choose from. Enum cases must be defined as options before they can be\nassigned to CMS items.\n@category cms"
   },
   enumvariable: {
     name: "EnumVariable",
-    description: ""
+    description: "An enum variable with a fixed set of cases.\n@category canvas"
   },
   fieldbasewithrequired: {
     name: "FieldBaseWithRequired",
@@ -10543,35 +10750,35 @@ var classes = {
   },
   fielddivider: {
     name: "FieldDivider",
-    description: "A visual divider between fields in the CMS UI. Not a data field."
+    description: "A visual divider between fields in the CMS UI. Not a data field.\n@category cms"
   },
   fileasset: {
     name: "FileAsset",
-    description: "A file asset uploaded to the Framer project."
+    description: "A file asset uploaded to the Framer project.\n@category canvas"
   },
   filefield: {
     name: "FileField",
-    description: "A CMS Collection field that stores a file asset (`FileAsset`)."
+    description: "A CMS Collection field that stores a file asset (`FileAsset`).\n@category cms"
   },
   filevariable: {
     name: "FileVariable",
-    description: ""
+    description: "A file variable.\n@category canvas"
   },
   font: {
     name: "Font",
-    description: "A font available in the project, including custom uploaded fonts."
+    description: "A font available in the project, including custom uploaded fonts.\n@category canvas"
   },
   formattedtextfield: {
     name: "FormattedTextField",
-    description: "A CMS Collection field that stores HTML-formatted text content (H1-H6, P, and other standard content elements)."
+    description: "A CMS Collection field that stores HTML-formatted text content (H1-H6, P, and other standard content elements).\n@category cms"
   },
   formattedtextvariable: {
     name: "FormattedTextVariable",
-    description: ""
+    description: "A formatted text (rich text) variable.\n@category canvas"
   },
   framenode: {
     name: "FrameNode",
-    description: "A frame layer on the canvas, the most common container node. Frames\ncan contain children, have layout settings, backgrounds, borders, and\ncan serve as breakpoint or component variants."
+    description: "A frame layer on the canvas, the most common container node.\n\nFrames can contain children, have layout settings, backgrounds, borders,\nand can serve as breakpoint or component variants.\n@category canvas"
   },
   framer: {
     name: "framer",
@@ -10591,43 +10798,43 @@ var classes = {
   },
   imageasset: {
     name: "ImageAsset",
-    description: "An image that has been uploaded to the Framer project. Provides methods\nto access image data, measure dimensions, and load as bitmap or HTML element."
+    description: "An image that has been uploaded to the Framer project. Provides methods\nto access image data, measure dimensions, and load as bitmap or HTML element.\n@category canvas"
   },
   imagefield: {
     name: "ImageField",
-    description: "A CMS Collection field that stores an image asset (`ImageAsset`)."
+    description: "A CMS Collection field that stores an image asset (`ImageAsset`).\n@category cms"
   },
   imagevariable: {
     name: "ImageVariable",
-    description: ""
+    description: "An image variable.\n@category canvas"
   },
   lineargradient: {
     name: "LinearGradient",
-    description: ""
+    description: "A linear gradient with two or more color stops.\n@category canvas"
   },
   linkfield: {
     name: "LinkField",
-    description: "A CMS Collection field that stores a URL in string format."
+    description: "A CMS Collection field that stores a URL in string format.\n@category cms"
   },
   linkvariable: {
     name: "LinkVariable",
-    description: ""
+    description: "A link variable.\n@category canvas"
   },
   managedcollection: {
     name: "ManagedCollection",
-    description: "A CMS Collection that is fully controlled by a plugin. Managed Collections\nallow plugins to define fields and sync items programmatically. Fields and\nitems can only be added, edited, and deleted by the owning plugin, not by\nthe user (unless a field is marked `userEditable`).\n\nA Managed Collection plugin becomes available within the CMS when it supports\nboth `configureManagedCollection` and `syncManagedCollection` modes.\n\nUse `framer.getManagedCollection()` to obtain an instance when the plugin is\nlaunched in either of those modes."
+    description: "A CMS Collection that is fully controlled by a plugin.\n\nManaged Collections allow plugins to define fields and sync items\nprogrammatically. Fields and items can only be added, edited, and deleted\nby the owning plugin, not by the user (unless a field is marked\n`userEditable`).\n\nA Managed Collection plugin becomes available within the CMS when it supports\nboth `configureManagedCollection` and `syncManagedCollection` modes.\n\nUse `framer.getManagedCollection()` to obtain an instance when the plugin is\nlaunched in either of those modes.\n@category cms"
   },
   multicollectionreferencefield: {
     name: "MultiCollectionReferenceField",
-    description: "A field that references multiple items in another collection."
+    description: "A field that references multiple items in another collection.\n@category cms"
   },
   numberfield: {
     name: "NumberField",
-    description: "A CMS Collection field that stores a numeric value."
+    description: "A CMS Collection field that stores a numeric value.\n@category cms"
   },
   numbervariable: {
     name: "NumberVariable",
-    description: ""
+    description: "A number variable.\n@category canvas"
   },
   pluginengine: {
     name: "PluginEngine",
@@ -10635,31 +10842,31 @@ var classes = {
   },
   radialgradient: {
     name: "RadialGradient",
-    description: ""
+    description: "A radial gradient with two or more color stops.\n@category canvas"
   },
   redirect: {
     name: "Redirect",
-    description: "A URL redirect configured in the project. Redirects are applied when\nthe site is published."
+    description: "A URL redirect configured in the project. Redirects are applied when\nthe site is published.\n@category settings"
   },
   stringfield: {
     name: "StringField",
-    description: "A CMS Collection field that stores a text string value."
+    description: "A CMS Collection field that stores a text string value.\n@category cms"
   },
   stringvariable: {
     name: "StringVariable",
-    description: ""
+    description: "A string variable.\n@category canvas"
   },
   svgnode: {
     name: "SVGNode",
-    description: "An SVG graphic layer on the canvas. Contains the raw SVG string and\nsupports positioning, sizing, rotation, and visibility."
+    description: "An SVG graphic layer on the canvas.\n\nContains the raw SVG string and supports positioning, sizing,\nrotation, and visibility.\n@category canvas"
   },
   textnode: {
     name: "TextNode",
-    description: 'A text layer on the canvas. Use {@link TextNode.setText | setText} and\n{@link TextNode.getText | getText} to work with plain text, or\n{@link TextNode.setHTML | setHTML} and {@link TextNode.getHTML | getHTML}\nfor rich text content.\n\n@example\n```ts\nconst selection = await framer.getSelection()\nfor (const node of selection) {\n  if (isTextNode(node)) {\n    node.setText("Hello!")\n  }\n}\n```'
+    description: 'A text layer on the canvas.\n\nUse {@link TextNode.setText | setText} and\n{@link TextNode.getText | getText} to work with plain text, or\n{@link TextNode.setHTML | setHTML} and {@link TextNode.getHTML | getHTML}\nfor rich text content.\n\n@example\n```ts\nconst selection = await framer.getSelection()\nfor (const node of selection) {\n  if (isTextNode(node)) {\n    node.setText("Hello!")\n  }\n}\n```\n@category canvas'
   },
   textstyle: {
     name: "TextStyle",
-    description: 'A reusable text style defined in the project, including font, size,\ncolor, and responsive breakpoints. Text styles let you manage text\nappearances from one place in a project. In the UI, you can find them\nin the Assets panel.\n\nText styles support responsive breakpoints that apply different values\nat different window widths. A maximum of four breakpoints can be added.\nBreakpoints are automatically ordered from largest to smallest `minWidth`.\nEach breakpoint must have a unique `minWidth` value.\n\nBy default, text styles use a built-in font. Use\n{@link Font} to customize a text style\'s typeface. All font variants\n(bold, italic, boldItalic) must share the same font family as the base\nfont.\n\nTo organize text styles into folders, use `/` as a separator in the\nname, e.g. `"My Plugin/Heading"`.\n\n@example\n```ts\n// Create a new text style.\nconst textStyle = await framer.createTextStyle({\n  name: "Heading",\n  tag: "h1",\n  fontSize: "30px",\n  lineHeight: "1.6em",\n})\n\n// Create a text style with responsive breakpoints.\nconst textStyle = await framer.createTextStyle({\n  fontSize: "24px",\n  minWidth: 1280,\n  breakpoints: [\n    { minWidth: 1024, fontSize: "18px" },\n    { minWidth: 320, fontSize: "16px" }\n  ]\n})\n\n// Update an existing text style.\nawait textStyle.setAttributes({\n  color: "rgba(242, 59, 57, 1)"\n})\n\n// Create a text style with a custom font.\nconst font = await framer.getFont("Open Sans")\nif (font) {\n  const textStyle = await framer.createTextStyle({ font })\n}\n\n// Remove a text style from the project.\nawait textStyle.remove()\n```'
+    description: 'A reusable text style defined in the project, including font, size,\ncolor, and responsive breakpoints. Text styles let you manage text\nappearances from one place in a project. In the UI, you can find them\nin the Assets panel.\n\nText styles support responsive breakpoints that apply different values\nat different window widths. A maximum of four breakpoints can be added.\nBreakpoints are automatically ordered from largest to smallest `minWidth`.\nEach breakpoint must have a unique `minWidth` value.\n\nBy default, text styles use a built-in font. Use\n{@link Font} to customize a text style\'s typeface. All font variants\n(bold, italic, boldItalic) must share the same font family as the base\nfont.\n\nTo organize text styles into folders, use `/` as a separator in the\nname, e.g. `"My Plugin/Heading"`.\n\n@example\n```ts\n// Create a new text style.\nconst textStyle = await framer.createTextStyle({\n  name: "Heading",\n  tag: "h1",\n  fontSize: "30px",\n  lineHeight: "1.6em",\n})\n\n// Create a text style with responsive breakpoints.\nconst textStyle = await framer.createTextStyle({\n  fontSize: "24px",\n  minWidth: 1280,\n  breakpoints: [\n    { minWidth: 1024, fontSize: "18px" },\n    { minWidth: 320, fontSize: "16px" }\n  ]\n})\n\n// Update an existing text style.\nawait textStyle.setAttributes({\n  color: "rgba(242, 59, 57, 1)"\n})\n\n// Create a text style with a custom font.\nconst font = await framer.getFont("Open Sans")\nif (font) {\n  const textStyle = await framer.createTextStyle({ font })\n}\n\n// Remove a text style from the project.\nawait textStyle.remove()\n```\n@category canvas'
   },
   unknownnode: {
     name: "UnknownNode",
@@ -10667,15 +10874,15 @@ var classes = {
   },
   unsupportedcomputedvalue: {
     name: "UnsupportedComputedValue",
-    description: ""
+    description: "A computed value type not yet supported by the plugin API.\n@category canvas"
   },
   unsupportedfield: {
     name: "UnsupportedField",
-    description: "A field type that is not yet supported by the plugin API.\nReturned when Framer uses a field type that the plugin API does not recognize."
+    description: "A field type that is not yet supported by the plugin API.\nReturned when Framer uses a field type that the plugin API does not recognize.\n@category cms"
   },
   unsupportedvariable: {
     name: "UnsupportedVariable",
-    description: ""
+    description: "A variable type not yet supported by the plugin API.\n@category canvas"
   },
   vectorset: {
     name: "VectorSet",
@@ -10687,15 +10894,15 @@ var classes = {
   },
   vectorsetitemnode: {
     name: "VectorSetItemNode",
-    description: "An individual item within a VectorSet node."
+    description: "An individual item within a VectorSet node.\n@category canvas"
   },
   vectorsetnode: {
     name: "VectorSetNode",
-    description: "A container node for a set of vector icons."
+    description: "A container node for a set of vector icons.\n@category canvas"
   },
   webpagenode: {
     name: "WebPageNode",
-    description: "A web page in the project's site map. Web pages have a\n{@link WebPageNode.path | path} and may be associated with a CMS\ncollection when used as a detail page."
+    description: "A web page in the project's site map.\n\nWeb pages have a {@link WebPageNode.path | path} and may be associated\nwith a CMS collection when used as a detail page.\n@category canvas"
   }
 };
 var methodsByCategory = {
@@ -10940,7 +11147,7 @@ var methodsByCategory = {
       name: "addFields",
       category: "Collection",
       signature: "addFields(fields: CreateField[]): Promise<Field[]>",
-      description: 'Create new unmanaged Collection fields. Use `Field.setAttributes` to\nupdate existing fields.\n\nUse `"Collection.addFields"` to check if this method is allowed.\n\n@param fields - The array of fields that should be added to the collection.\n@returns The newly created Field instances.\n\n@example\n```ts\nconst createdFields = await collection.addFields([\n  { type: "string", name: "Name" },\n  { type: "enum", name: "Status", cases: [{ name: "New" }, { name: "Done" }] },\n  { type: "file", name: "Text", allowedFileTypes: ["md"] },\n  { type: "collectionReference", name: "Author", collectionId: "ASh5SZOh" },\n])\n```',
+      description: 'Create new unmanaged Collection fields.\n\nUse `Field.setAttributes` to update existing fields.\n\nUse `"Collection.addFields"` to check if this method is allowed.\n\n@param fields - The array of fields that should be added to the collection.\n@returns The newly created Field instances.\n\n@example\n```ts\nconst createdFields = await collection.addFields([\n  { type: "string", name: "Name" },\n  { type: "enum", name: "Status", cases: [{ name: "New" }, { name: "Done" }] },\n  { type: "file", name: "Text", allowedFileTypes: ["md"] },\n  { type: "collectionReference", name: "Author", collectionId: "ASh5SZOh" },\n])\n```',
       references: ["CreateField", "Field"]
     },
     {
@@ -10961,7 +11168,7 @@ var methodsByCategory = {
       name: "getItems",
       category: "Collection",
       signature: "getItems(): Promise<CollectionItem[]>",
-      description: "Retrieve all items within this Collection, in their current order.\nItems may include drafts (unpublished items).\n\n@returns An array of CollectionItem instances.\n\n@example\n```ts\nconst items = await collection.getItems()\n```",
+      description: "Retrieve all items within this Collection, in their current order.\n\nItems may include drafts (unpublished items).\n\n@returns An array of CollectionItem instances.\n\n@example\n```ts\nconst items = await collection.getItems()\n```",
       references: ["CollectionItem"]
     },
     {
@@ -10989,7 +11196,7 @@ var methodsByCategory = {
       name: "navigateTo",
       category: "Collection",
       signature: "navigateTo(opts?: NavigableOptions): Promise<void>",
-      description: "Navigate to this collection. May switch modes to reveal the relevant view.",
+      description: "Navigate to this collection.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
@@ -11017,14 +11224,14 @@ var methodsByCategory = {
       name: "setFieldOrder",
       category: "Collection",
       signature: "setFieldOrder(fieldIds: string[]): Promise<void>",
-      description: 'Reorder the fields in this Collection based on an array of field IDs.\nUnknown field IDs are ignored.\n\nUse `"Collection.setFieldOrder"` to check if this method is allowed.\n\n@param fieldIds - An array of field IDs representing the desired order.\n\n@example\n```ts\nawait collection.setFieldOrder([nameField.id, ageField.id])\n```',
+      description: 'Reorder the fields in this Collection based on an array of field IDs.\n\nUnknown field IDs are ignored.\n\nUse `"Collection.setFieldOrder"` to check if this method is allowed.\n\n@param fieldIds - An array of field IDs representing the desired order.\n\n@example\n```ts\nawait collection.setFieldOrder([nameField.id, ageField.id])\n```',
       references: []
     },
     {
       name: "setItemOrder",
       category: "Collection",
       signature: "setItemOrder(ids: NodeId[]): Promise<void>",
-      description: 'Reorder the items in this Collection based on an array of item IDs.\nUnknown item IDs are ignored.\n\nUse `"Collection.setItemOrder"` to check if this method is allowed.\n\n@param ids - An array of item IDs representing the desired order.\n\n@example\n```ts\nawait collection.setItemOrder([item3.id, item1.id, item2.id])\n```',
+      description: 'Reorder the items in this Collection based on an array of item IDs.\n\nUnknown item IDs are ignored.\n\nUse `"Collection.setItemOrder"` to check if this method is allowed.\n\n@param ids - An array of item IDs representing the desired order.\n\n@example\n```ts\nawait collection.setItemOrder([item3.id, item1.id, item2.id])\n```',
       references: []
     },
     {
@@ -11061,7 +11268,7 @@ var methodsByCategory = {
       name: "fieldData",
       category: "CollectionItem",
       signature: "fieldData: Readonly<FieldData>",
-      description: 'The fields and corresponding values of this Collection item. Field data\nuses the field `id` as keys in an object.\n\n@example\n```ts\nconst titleFieldData = collectionItem.fieldData[titleField.id]\nconsole.log(titleFieldData.value) // "Getting Started"\n```',
+      description: 'The fields and corresponding values of this Collection item.\n\nField data uses the field `id` as keys in an object.\n\n@example\n```ts\nconst titleFieldData = collectionItem.fieldData[titleField.id]\nconsole.log(titleFieldData.value) // "Getting Started"\n```',
       references: ["FieldData"]
     },
     {
@@ -11288,28 +11495,28 @@ var methodsByCategory = {
       name: "aspectRatio",
       category: "ComponentInstanceNode",
       signature: "aspectRatio: number | null",
-      description: "Width-to-height ratio (e.g. `1.5` for 3:2).\nSetting to `null` removes the aspect ratio constraint.\nSupported by FrameNode, ComponentInstanceNode.",
+      description: "Width-to-height ratio (e.g. `1.5` for 3:2).\n\nSetting to `null` removes the aspect ratio constraint.\nSupported by FrameNode, ComponentInstanceNode.",
       references: []
     },
     {
       name: "bottom",
       category: "ComponentInstanceNode",
       signature: "bottom: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from bottom edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from bottom edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "centerX",
       category: "ComponentInstanceNode",
       signature: "centerX: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
       name: "centerY",
       category: "ComponentInstanceNode",
       signature: "centerY: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
@@ -11351,7 +11558,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "ComponentInstanceNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -11365,7 +11572,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "ComponentInstanceNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -11379,7 +11586,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "ComponentInstanceNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -11407,21 +11614,21 @@ var methodsByCategory = {
       name: "height",
       category: "ComponentInstanceNode",
       signature: "height: HeightLength | null",
-      description: 'Height of the node. Accepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Height of the node.\n\nAccepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["HeightLength"]
     },
     {
       name: "left",
       category: "ComponentInstanceNode",
       signature: "left: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from left edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from left edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "locked",
       category: "ComponentInstanceNode",
       signature: "locked: boolean",
-      description: "Whether the node is locked for editing. Defaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is locked for editing.\n\nDefaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
@@ -11456,21 +11663,21 @@ var methodsByCategory = {
       name: "name",
       category: "ComponentInstanceNode",
       signature: "name: string | null",
-      description: "The name of the node displayed in the layers panel.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
+      description: "The name of the node displayed in the layers panel.\n\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "navigateTo",
       category: "ComponentInstanceNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
       name: "opacity",
       category: "ComponentInstanceNode",
       signature: "opacity: number",
-      description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque). Defaults to `1`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+      description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque).\n\nDefaults to `1`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
       references: []
     },
     {
@@ -11491,14 +11698,14 @@ var methodsByCategory = {
       name: "right",
       category: "ComponentInstanceNode",
       signature: "right: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from right edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from right edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "rotation",
       category: "ComponentInstanceNode",
       signature: "rotation: number",
-      description: "Rotation angle in degrees. Defaults to `0`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+      description: "Rotation angle in degrees.\n\nDefaults to `0`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
       references: []
     },
     {
@@ -11512,21 +11719,21 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "ComponentInstanceNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setPluginData",
       category: "ComponentInstanceNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
       name: "top",
       category: "ComponentInstanceNode",
       signature: "top: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from top edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from top edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
@@ -11540,21 +11747,21 @@ var methodsByCategory = {
       name: "visible",
       category: "ComponentInstanceNode",
       signature: "visible: boolean",
-      description: "Whether the node is visible on the canvas. Defaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is visible on the canvas.\n\nDefaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "walk",
       category: "ComponentInstanceNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
       name: "width",
       category: "ComponentInstanceNode",
       signature: "width: WidthLength | null",
-      description: 'Width of the node. Accepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Width of the node.\n\nAccepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["WidthLength"]
     },
     {
@@ -11623,7 +11830,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "ComponentNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -11637,7 +11844,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "ComponentNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -11651,7 +11858,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "ComponentNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -11679,7 +11886,7 @@ var methodsByCategory = {
       name: "navigateTo",
       category: "ComponentNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
@@ -11707,14 +11914,14 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "ComponentNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setPluginData",
       category: "ComponentNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
@@ -11728,7 +11935,7 @@ var methodsByCategory = {
       name: "walk",
       category: "ComponentNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
@@ -11848,7 +12055,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "DesignPageNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -11862,7 +12069,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "DesignPageNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -11876,7 +12083,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "DesignPageNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -11897,7 +12104,7 @@ var methodsByCategory = {
       name: "navigateTo",
       category: "DesignPageNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
@@ -11918,21 +12125,21 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "DesignPageNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setPluginData",
       category: "DesignPageNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
       name: "walk",
       category: "DesignPageNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
@@ -12285,14 +12492,14 @@ var methodsByCategory = {
       name: "aspectRatio",
       category: "FrameNode",
       signature: "aspectRatio: number | null",
-      description: "Width-to-height ratio (e.g. `1.5` for 3:2).\nSetting to `null` removes the aspect ratio constraint.\nSupported by FrameNode, ComponentInstanceNode.",
+      description: "Width-to-height ratio (e.g. `1.5` for 3:2).\n\nSetting to `null` removes the aspect ratio constraint.\nSupported by FrameNode, ComponentInstanceNode.",
       references: []
     },
     {
       name: "backgroundColor",
       category: "FrameNode",
       signature: "backgroundColor: ColorStyle | string | null",
-      description: "Background color in RGBA format (e.g. `rgba(242, 59, 57, 1)`) or as a {@link ColorStyle} instance.\nSetting to `null` removes the background color. Supported by FrameNode.",
+      description: "Background color in RGBA format (e.g. `rgba(242, 59, 57, 1)`) or as a {@link ColorStyle} instance.\n\nSetting to `null` removes the background color. Supported by FrameNode.",
       references: ["ColorStyle"]
     },
     {
@@ -12313,35 +12520,35 @@ var methodsByCategory = {
       name: "border",
       category: "FrameNode",
       signature: "border: Border | null",
-      description: 'Border properties including width, color, and style.\nStyles: `"solid"`, `"dashed"`, `"dotted"`, `"double"`.\nWidth can be per-side (e.g. `"1px 2px 3px 4px"`).\nSetting to `null` removes the border. Supported by FrameNode.',
+      description: 'Border properties including width, color, and style.\n\nStyles: `"solid"`, `"dashed"`, `"dotted"`, `"double"`.\nWidth can be per-side (e.g. `"1px 2px 3px 4px"`).\nSetting to `null` removes the border. Supported by FrameNode.',
       references: ["Border"]
     },
     {
       name: "borderRadius",
       category: "FrameNode",
       signature: "borderRadius: BorderRadius",
-      description: 'Border radius for rounded corners. Single value (e.g. `"10px"` or `"50%"`)\nor per-corner (e.g. `"10px 20px 30px 40px"` for top-left, top-right, bottom-right, bottom-left).\nSetting to `null` removes the border radius. Supported by FrameNode.',
+      description: 'Border radius for rounded corners.\n\nSingle value (e.g. `"10px"` or `"50%"`)\nor per-corner (e.g. `"10px 20px 30px 40px"` for top-left, top-right, bottom-right, bottom-left).\nSetting to `null` removes the border radius. Supported by FrameNode.',
       references: ["BorderRadius"]
     },
     {
       name: "bottom",
       category: "FrameNode",
       signature: "bottom: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from bottom edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from bottom edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "centerX",
       category: "FrameNode",
       signature: "centerX: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
       name: "centerY",
       category: "FrameNode",
       signature: "centerY: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
@@ -12355,7 +12562,7 @@ var methodsByCategory = {
       name: "gap",
       category: "FrameNode",
       signature: 'gap: WithLayoutTrait["gap"]',
-      description: 'Spacing between items in a layout. Single value (e.g. `"10px"`) applies to both axes;\ntwo values (e.g. `"10px 20px"`) set horizontal and vertical separately.\nOnly works with layout enabled. Supported by FrameNode.',
+      description: 'Spacing between items in a layout.\n\nSingle value (e.g. `"10px"`) applies to both axes;\ntwo values (e.g. `"10px 20px"`) set horizontal and vertical separately.\nOnly works with layout enabled. Supported by FrameNode.',
       references: []
     },
     {
@@ -12369,7 +12576,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "FrameNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -12383,7 +12590,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "FrameNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -12397,7 +12604,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "FrameNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -12453,42 +12660,42 @@ var methodsByCategory = {
       name: "gridItemColumnSpan",
       category: "FrameNode",
       signature: 'gridItemColumnSpan: WithGridItemTrait["gridItemColumnSpan"]',
-      description: 'Number of columns to span, or `"all"` for all columns. For nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.',
+      description: 'Number of columns to span, or `"all"` for all columns.\n\nFor nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.',
       references: []
     },
     {
       name: "gridItemFillCellHeight",
       category: "FrameNode",
       signature: 'gridItemFillCellHeight: WithGridItemTrait["gridItemFillCellHeight"]',
-      description: "Whether to fill the grid cell height. For nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
+      description: "Whether to fill the grid cell height.\n\nFor nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "gridItemFillCellWidth",
       category: "FrameNode",
       signature: 'gridItemFillCellWidth: WithGridItemTrait["gridItemFillCellWidth"]',
-      description: "Whether to fill the grid cell width. For nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
+      description: "Whether to fill the grid cell width.\n\nFor nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "gridItemHorizontalAlignment",
       category: "FrameNode",
       signature: 'gridItemHorizontalAlignment: WithGridItemTrait["gridItemHorizontalAlignment"]',
-      description: 'Horizontal alignment within grid cell. For nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
+      description: 'Horizontal alignment within grid cell.\n\nFor nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
       references: []
     },
     {
       name: "gridItemRowSpan",
       category: "FrameNode",
       signature: 'gridItemRowSpan: WithGridItemTrait["gridItemRowSpan"]',
-      description: "Number of rows to span. For nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.",
+      description: "Number of rows to span.\n\nFor nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "gridItemVerticalAlignment",
       category: "FrameNode",
       signature: 'gridItemVerticalAlignment: WithGridItemTrait["gridItemVerticalAlignment"]',
-      description: 'Vertical alignment within grid cell. For nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
+      description: 'Vertical alignment within grid cell.\n\nFor nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
       references: []
     },
     {
@@ -12516,14 +12723,14 @@ var methodsByCategory = {
       name: "height",
       category: "FrameNode",
       signature: "height: HeightLength | null",
-      description: 'Height of the node. Accepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Height of the node.\n\nAccepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["HeightLength"]
     },
     {
       name: "imageRendering",
       category: "FrameNode",
       signature: "imageRendering: ImageRendering | null",
-      description: 'How images should be rendered when scaled: `"auto"` or `"pixelated"`.\nOnly applies to frames with image backgrounds.\nSetting to `null` uses default rendering. Supported by FrameNode.',
+      description: 'How images should be rendered when scaled: `"auto"` or `"pixelated"`.\n\nOnly applies to frames with image backgrounds.\nSetting to `null` uses default rendering. Supported by FrameNode.',
       references: ["ImageRendering"]
     },
     {
@@ -12544,21 +12751,21 @@ var methodsByCategory = {
       name: "layout",
       category: "FrameNode",
       signature: 'layout: WithLayoutTrait["layout"]',
-      description: "Enables stack or grid layout. Setting to `null` disables any applied layout.\nOperation is deferred and applied after the current update cycle. Supported by FrameNode.",
+      description: "Enables stack or grid layout.\n\nSetting to `null` disables any applied layout.\nOperation is deferred and applied after the current update cycle. Supported by FrameNode.",
       references: []
     },
     {
       name: "left",
       category: "FrameNode",
       signature: "left: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from left edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from left edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "link",
       category: "FrameNode",
       signature: 'link: WithLinkTrait["link"]',
-      description: 'URL or internal page link. External: `"https://example.com"`, internal: `"/about"`,\nemail: `"mailto:user@example.com"`. Setting to `null` removes the link.\nSupported by FrameNode, TextNode.',
+      description: 'URL or internal page link.\n\nExternal: `"https://example.com"`, internal: `"/about"`,\nemail: `"mailto:user@example.com"`. Setting to `null` removes the link.\nSupported by FrameNode, TextNode.',
       references: []
     },
     {
@@ -12572,7 +12779,7 @@ var methodsByCategory = {
       name: "linkOpenInNewTab",
       category: "FrameNode",
       signature: 'linkOpenInNewTab: WithLinkTrait["linkOpenInNewTab"]',
-      description: "Whether to open the link in a new tab. Default is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
+      description: "Whether to open the link in a new tab.\n\nDefault is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
       references: []
     },
     {
@@ -12600,7 +12807,7 @@ var methodsByCategory = {
       name: "locked",
       category: "FrameNode",
       signature: "locked: boolean",
-      description: "Whether the node is locked for editing. Defaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is locked for editing.\n\nDefaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
@@ -12635,49 +12842,49 @@ var methodsByCategory = {
       name: "name",
       category: "FrameNode",
       signature: "name: string | null",
-      description: "The name of the node displayed in the layers panel.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
+      description: "The name of the node displayed in the layers panel.\n\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "navigateTo",
       category: "FrameNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
       name: "opacity",
       category: "FrameNode",
       signature: "opacity: number",
-      description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque). Defaults to `1`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+      description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque).\n\nDefaults to `1`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
       references: []
     },
     {
       name: "overflow",
       category: "FrameNode",
       signature: 'overflow: WithOverflowTrait["overflow"]',
-      description: "Controls how content that exceeds the element's box is handled.\nSetting to `null` removes the overflow property. Will overwrite `overflowX` or `overflowY`.\nSupported by FrameNode, TextNode.",
+      description: "Controls how content that exceeds the element's box is handled.\n\nSetting to `null` removes the overflow property. Will overwrite `overflowX` or `overflowY`.\nSupported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "overflowX",
       category: "FrameNode",
       signature: 'overflowX: WithOverflowTrait["overflowX"]',
-      description: "Controls horizontal overflow behavior.\nSetting to `null` removes the overflow X property. Supported by FrameNode, TextNode.",
+      description: "Controls horizontal overflow behavior.\n\nSetting to `null` removes the overflow X property. Supported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "overflowY",
       category: "FrameNode",
       signature: 'overflowY: WithOverflowTrait["overflowY"]',
-      description: "Controls vertical overflow behavior.\nSetting to `null` removes the overflow Y property. Supported by FrameNode, TextNode.",
+      description: "Controls vertical overflow behavior.\n\nSetting to `null` removes the overflow Y property. Supported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "padding",
       category: "FrameNode",
       signature: 'padding: WithLayoutTrait["padding"]',
-      description: 'Inner spacing of a container with layout. Single value (e.g. `"10px"`) applies to all sides;\nfour values (e.g. `"10px 20px 30px 40px"`) set top, right, bottom, left.\nOnly works with layout enabled. Supported by FrameNode.',
+      description: 'Inner spacing of a container with layout.\n\nSingle value (e.g. `"10px"`) applies to all sides;\nfour values (e.g. `"10px 20px 30px 40px"`) set top, right, bottom, left.\nOnly works with layout enabled. Supported by FrameNode.',
       references: []
     },
     {
@@ -12698,14 +12905,14 @@ var methodsByCategory = {
       name: "right",
       category: "FrameNode",
       signature: "right: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from right edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from right edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "rotation",
       category: "FrameNode",
       signature: "rotation: number",
-      description: "Rotation angle in degrees. Defaults to `0`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+      description: "Rotation angle in degrees.\n\nDefaults to `0`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
       references: []
     },
     {
@@ -12719,14 +12926,14 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "FrameNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setPluginData",
       category: "FrameNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
@@ -12761,35 +12968,35 @@ var methodsByCategory = {
       name: "top",
       category: "FrameNode",
       signature: "top: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from top edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from top edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "visible",
       category: "FrameNode",
       signature: "visible: boolean",
-      description: "Whether the node is visible on the canvas. Defaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is visible on the canvas.\n\nDefaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "walk",
       category: "FrameNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
       name: "width",
       category: "FrameNode",
       signature: "width: WidthLength | null",
-      description: 'Width of the node. Accepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Width of the node.\n\nAccepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["WidthLength"]
     },
     {
       name: "zIndex",
       category: "FrameNode",
       signature: 'zIndex: WithZIndexTrait["zIndex"]',
-      description: "Stacking order of positioned elements. Higher values appear on top of lower values.\nSetting to `null` removes the z-index property. Supported by FrameNode, TextNode.",
+      description: "Stacking order of positioned elements.\n\nHigher values appear on top of lower values.\nSetting to `null` removes the z-index property. Supported by FrameNode, TextNode.",
       references: []
     },
     {
@@ -12808,6 +13015,13 @@ var methodsByCategory = {
       description: 'Applies commands to the canvas to create, update, remove, move, or duplicate nodes.\n\nThe command syntax is documented in the string returned by {@link getAgentSystemPrompt}.\nEach call is scoped to a single page.\n\n@param dsl - A string of commands separated by `;`. See {@link getAgentSystemPrompt} for syntax.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.',
       references: []
     },
+    {
+      name: "[$framerApiOnly.flattenComponentInstanceForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.flattenComponentInstanceForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Flattens a local component instance into raw editable layers.\n\n@param input - `{ id }`: the id of the component instance to flatten.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The flatten result \u2014 `success` with a `replacementId`, or `blocked` with a reason.',
+      references: []
+    },
     {
       name: "[$framerApiOnly.getAgentContext]",
       category: "framer",
@@ -12822,6 +13036,76 @@ var methodsByCategory = {
       description: "Returns the static agent system prompt as a string.\n\nThe prompt includes:\n- **Command reference** \u2014 syntax for adding, updating, removing, moving, and duplicating nodes.\n- **Design rules** \u2014 spacing, layout, typography, and responsive design guidance.\n- **Examples** \u2014 common UI patterns expressed as commands.\n- **`readProjectForAgent` query reference** \u2014 available query types and their parameters.\n\nThis is the sole documentation for the command syntax used by {@link applyAgentChanges}\nand the query types used by {@link readProjectForAgent}.\n\nThe prompt is static and does not depend on any specific project.\nCall {@link getAgentContext} to get the project-specific context.\n\n@returns A string containing the agent system prompt.",
       references: []
     },
+    {
+      name: "[$framerApiOnly.getAncestorsForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getAncestorsForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get every ancestor of a node, from the direct parent up to the page root.\n\n@param input - `{ id }`: the id of the node to start from.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The ancestors ordered from closest parent to the page root.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getGroundNodeForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getGroundNodeForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the top-level node on the canvas that contains the given node.\n\n@param input - `{ id }`: the id of a descendant node.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The top-level node, or `null` if none applies.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getNodeForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getNodeForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get a single node on the page, including its children.\n\n@param input - `{ id }`: the id of the node to read.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The node, or `null` if no node with that id exists on the page.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getNodesForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getNodesForAgent](input: { ids: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get multiple nodes on the page, including their children.\nIds that don\'t resolve to a node are skipped.\n\n@param input - `{ ids }`: the ids of the nodes to read.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The nodes that were found, in input order.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getNodesOfTypesForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getNodesOfTypesForAgent](input: { types: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get every node on the page of one or more kinds (e.g. `"FrameNode"`, `"RichTextNode"`, `"ComponentInstanceNode"`).\n\n@param input - `{ types }`: the node kinds to match.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching nodes without their children.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getParentNodeForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getParentNodeForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the direct parent of a node.\n\n@param input - `{ id }`: the id of the child node.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The parent node, or `null` if the node has no parent or doesn\'t exist.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getScopeNodeForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getScopeNodeForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the scope node (page or component) that contains the given node.\n\n@param input - `{ id }`: the id of a node inside the scope.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The enclosing scope node, or `null` if the node isn\'t in any scope.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.makeExternalComponentLocalForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.makeExternalComponentLocalForAgent](input: { id: string; replaceAll?: boolean; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Converts an external component into a local project component.\n\n@param input - `{ id, replaceAll? }`: the id of the external instance, and whether to replace all instances.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns `success` (with the local component name), `needs_confirmation` (retry with `replaceAll`), or `blocked` with a reason.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.publishForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.publishForAgent](input?: Record<string, unknown>): Promise<unknown>",
+      description: "Executes the publish flow on behalf of an agent.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Action-discriminated input object (preview / confirm_publish / deploy_to_production).\n@returns The action's result \u2014 status, publish URLs, and any errors, warnings, or changes.",
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.queryImagesForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.queryImagesForAgent](input: Record<string, unknown>): Promise<unknown>",
+      description: 'Searches for stock images to use on the canvas (e.g. `"FrameNode"` `fill` values). Returns\ncandidate images with preview thumbnails and a `url` field for each. The returned URLs are\nregistered as trusted for this session so they can be applied directly via `fill="<url>"`\nin a subsequent {@link applyAgentChanges} DSL command. Without calling this method first,\nexternal image URLs are rejected at apply time.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Search input object (source / query / count / orientation).\n@returns An object describing the candidates or an error.',
+      references: []
+    },
     {
       name: "[$framerApiOnly.readProjectForAgent]",
       category: "framer",
@@ -12829,6 +13113,13 @@ var methodsByCategory = {
       description: 'Reads project state by executing an array of queries against the project.\n\nReturns one result per query. Available query types and their parameters\nare documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param queries - Array of query objects. See {@link getAgentSystemPrompt} for available types.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns An object with a `results` array, one entry per query.',
       references: []
     },
+    {
+      name: "[$framerApiOnly.reviewChangesForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.reviewChangesForAgent](options?: { pagePath?: string; }): Promise<unknown>",
+      description: "Reviews changes made by prior {@link applyAgentChanges} calls in this session.\n\nConsumes accumulated diagnostics from the session's agent context.\n\n@param options.pagePath - Target page path (e.g. `\"/about\"`). Defaults to the active page.\n@returns The session's accumulated changes, errors, warnings, and deferred trait reports.",
+      references: []
+    },
     {
       name: "[$framerInternal.initialState]",
       category: "framer",
@@ -12854,7 +13145,7 @@ var methodsByCategory = {
       name: "addComponentInstance",
       category: "framer",
       signature: "addComponentInstance({ url, attributes, parentId, }: AddComponentInstanceOptions): Promise<ComponentInstanceNode>",
-      description: "Add a component instance by module URL.\n\n@param url - The component module URL. Can be copied from the components panel.\n@param attributes - Optional component attributes.\n\n@returns The newly created component instance node.",
+      description: "Add a component instance by module URL.\n\n@param url - The component module URL. Can be copied from the components panel.\n@param attributes - Optional component attributes.\n\n@returns The newly created component instance node.\n@category canvas",
       references: ["AddComponentInstanceOptions", "ComponentInstanceNode"]
     },
     {
@@ -12871,42 +13162,42 @@ var methodsByCategory = {
       name: "addDetachedComponentLayers",
       category: "framer",
       signature: "addDetachedComponentLayers({ url, layout, attributes }: AddDetachedComponentLayersOptions): Promise<FrameNode>",
-      description: "Adds the layers of a component by module URL.",
+      description: "Adds the layers of a component by module URL.\n@category canvas",
       references: ["AddDetachedComponentLayersOptions", "FrameNode"]
     },
     {
       name: "addImage",
       category: "framer",
       signature: "addImage(image: NamedImageAssetInput | File): Promise<void>",
-      description: "Upload an image, and insert on the canvas.",
+      description: "Upload an image, and insert on the canvas.\n@category canvas",
       references: ["NamedImageAssetInput", "File"]
     },
     {
       name: "addImages",
       category: "framer",
       signature: "addImages(images: readonly NamedImageAssetInput[]): Promise<void>",
-      description: "Add multiple images, replacing the selected images, or insert on the canvas.",
+      description: "Add multiple images, replacing the selected images, or insert on the canvas.\n@category canvas",
       references: ["NamedImageAssetInput"]
     },
     {
       name: "addRedirects",
       category: "framer",
       signature: "addRedirects(redirects: RedirectInput[]): Promise<Redirect[]>",
-      description: 'Add new redirects or update existing ones if their IDs match\n\n`from` paths can contain wildcards (`*`) which match any string, and\ncaptured groups can be referenced in the `to` path using `:1`, `:2`,\netc.\n\nThrows a `FramerPluginError` when the user lacks Site Settings permissions,\nwhen the project plan does not include Redirects, or when the maximum\nredirect count (2500) is reached.\n\n@param redirects - An array of redirect objects to add.\n@returns The added Redirects.\n\n@example\n```ts\nawait framer.addRedirects([\n  { from: "/business", to: "/enterprise", expandToAllLocales: true },\n  { from: "/posts/*", to: "/blog/:1", expandToAllLocales: false },\n])\n```',
+      description: 'Add new redirects or update existing ones if their IDs match\n\n`from` paths can contain wildcards (`*`) which match any string, and\ncaptured groups can be referenced in the `to` path using `:1`, `:2`,\netc.\n\nThrows a `FramerPluginError` when the user lacks Site Settings permissions,\nwhen the project plan does not include Redirects, or when the maximum\nredirect count (2500) is reached.\n\n@param redirects - An array of redirect objects to add.\n@returns The added Redirects.\n\n@example\n```ts\nawait framer.addRedirects([\n  { from: "/business", to: "/enterprise", expandToAllLocales: true },\n  { from: "/posts/*", to: "/blog/:1", expandToAllLocales: false },\n])\n```\n@category settings',
       references: ["RedirectInput", "Redirect"]
     },
     {
       name: "addSVG",
       category: "framer",
       signature: "addSVG(svg: SVGData): Promise<void>",
-      description: "Add an SVG, replacing the selected SVG, or insert on the canvas.",
+      description: "Add an SVG, replacing the selected SVG, or insert on the canvas.\n@category canvas",
       references: ["SVGData"]
     },
     {
       name: "addText",
       category: "framer",
       signature: "addText(text: string, options?: AddTextOptions): Promise<void>",
-      description: "Add a new text node to the canvas.",
+      description: "Add a new text node to the canvas.\n@category canvas",
       references: ["AddTextOptions"]
     },
     {
@@ -12920,7 +13211,7 @@ var methodsByCategory = {
       name: "cloneNode",
       category: "framer",
       signature: "cloneNode(nodeId: NodeId): Promise<AnyNode | null>",
-      description: "Clone a node.",
+      description: "Clone a node.\n@category canvas",
       references: ["AnyNode"]
     },
     {
@@ -12937,21 +13228,21 @@ var methodsByCategory = {
       name: "createCodeFile",
       category: "framer",
       signature: "createCodeFile(name: string, code: string, options?: { editViaPlugin?: boolean; }): Promise<CodeFile>",
-      description: 'Create a new code file in the project.\n\n@param name - The name of the code file (including extension).\n@param code - The initial content of the code file.\n@param options - Optional settings. `editViaPlugin`: when `true`, the "Edit Code" UI action will open the plugin which created the code file.\n@returns The newly created code file instance.\n\n@example\n```ts\nconst newFile = await framer.createCodeFile(\n  "MyComponent",\n  `export default function MyComponent() {\n    return <div>Hello World</div>\n  }`\n)\n```',
+      description: 'Create a new code file in the project.\n\n@param name - The name of the code file (including extension).\n@param code - The initial content of the code file.\n@param options - Optional settings. `editViaPlugin`: when `true`, the "Edit Code" UI action will open the plugin which created the code file.\n@returns The newly created code file instance.\n\n@example\n```ts\nconst newFile = await framer.createCodeFile(\n  "MyComponent",\n  `export default function MyComponent() {\n    return <div>Hello World</div>\n  }`\n)\n```\n@category code-files',
       references: ["CodeFile"]
     },
     {
       name: "createCollection",
       category: "framer",
       signature: "createCollection(name: string): Promise<Collection>",
-      description: "Create a new collection.\n\n@param name - The name to give the new collection.",
+      description: "Create a new collection.\n\n@param name - The name to give the new collection.\n@category cms",
       references: ["Collection"]
     },
     {
       name: "createColorStyle",
       category: "framer",
       signature: "createColorStyle(attributes: ColorStyleAttributes): Promise<ColorStyle>",
-      description: "Add a new color style to the project.",
+      description: "Add a new color style to the project.\n@category canvas",
       references: ["ColorStyleAttributes", "ColorStyle"]
     },
     {
@@ -12965,14 +13256,14 @@ var methodsByCategory = {
       name: "createDesignPage",
       category: "framer",
       signature: "createDesignPage(pageName: string): Promise<DesignPageNode>",
-      description: 'Create a new design page.\n\nIf you want to open the newly created design page, you can `.navigateTo()` the page after creation.\n\n@param pageName - The name for the new design page.\n\n@example\n```ts\nconst designPage = await framer.createDesignPage("About")\nawait designPage.navigateTo()\n```',
+      description: 'Create a new design page.\n\nIf you want to open the newly created design page, you can `.navigateTo()` the page after creation.\n\n@param pageName - The name for the new design page.\n\n@example\n```ts\nconst designPage = await framer.createDesignPage("About")\nawait designPage.navigateTo()\n```\n@category canvas',
       references: ["DesignPageNode"]
     },
     {
       name: "createFrameNode",
       category: "framer",
       signature: "createFrameNode(attributes: Partial<EditableFrameNodeAttributes>, parentId?: string): Promise<FrameNode | null>",
-      description: "Create a new node on the canvas.",
+      description: "Create a new node on the canvas.\n@category canvas",
       references: ["EditableFrameNodeAttributes", "FrameNode"]
     },
     {
@@ -12986,7 +13277,7 @@ var methodsByCategory = {
       name: "createManagedCollection",
       category: "framer",
       signature: "createManagedCollection(name: string): Promise<ManagedCollection>",
-      description: "Add a new plugin-managed CMS Collection.\n\nIf a name is provided which matches an existing Collection, the promise will reject.\n\n@param name - The name to give the new collection.\n\n@example\n```ts\nconst newCollection = await framer.createManagedCollection(name)\n```",
+      description: "Add a new plugin-managed CMS Collection.\n\nIf a name is provided which matches an existing Collection, the promise will reject.\n\n@param name - The name to give the new collection.\n\n@example\n```ts\nconst newCollection = await framer.createManagedCollection(name)\n```\n@category cms",
       references: ["ManagedCollection"]
     },
     {
@@ -13000,14 +13291,14 @@ var methodsByCategory = {
       name: "createTextStyle",
       category: "framer",
       signature: "createTextStyle(attributes: TextStyleAttributes): Promise<TextStyle>",
-      description: "Add a new text style to the project.",
+      description: "Add a new text style to the project.\n@category canvas",
       references: ["TextStyleAttributes", "TextStyle"]
     },
     {
       name: "createWebPage",
       category: "framer",
       signature: "createWebPage(pagePath: string): Promise<WebPageNode>",
-      description: 'Create a new web page.\n\nIf you want to open the newly created web page, you can `.navigateTo()` the page after creation.\n\n@param pagePath - The path for the new web page (e.g., "/about").\n\n@example\n```ts\nconst webPage = await framer.createWebPage("/about")\nawait webPage.navigateTo()\n```',
+      description: 'Create a new web page.\n\nIf you want to open the newly created web page, you can `.navigateTo()` the page after creation.\n\n@param pagePath - The path for the new web page (e.g., "/about").\n\n@example\n```ts\nconst webPage = await framer.createWebPage("/about")\nawait webPage.navigateTo()\n```\n@category canvas',
       references: ["WebPageNode"]
     },
     {
@@ -13031,6 +13322,13 @@ var methodsByCategory = {
       description: "",
       references: []
     },
+    {
+      name: "flattenComponentInstanceForAgent",
+      category: "framer",
+      signature: "flattenComponentInstanceForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Flattens a local component instance into raw editable layers.\n\n@param input - `{ id }`: the id of the component instance to flatten.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The flatten result \u2014 `success` with a `replacementId`, or `blocked` with a reason.',
+      references: []
+    },
     {
       name: "getAgentContext",
       category: "framer",
@@ -13045,11 +13343,18 @@ var methodsByCategory = {
       description: "Returns the static agent system prompt as a string.\n\nThe prompt includes:\n- **Command reference** \u2014 syntax for adding, updating, removing, moving, and duplicating nodes.\n- **Design rules** \u2014 spacing, layout, typography, and responsive design guidance.\n- **Examples** \u2014 common UI patterns expressed as commands.\n- **`readProjectForAgent` query reference** \u2014 available query types and their parameters.\n\nThis is the sole documentation for the command syntax used by {@link applyAgentChanges}\nand the query types used by {@link readProjectForAgent}.\n\nThe prompt is static and does not depend on any specific project.\nCall {@link getAgentContext} to get the project-specific context.\n\n@returns A string containing the agent system prompt.",
       references: []
     },
+    {
+      name: "getAncestorsForAgent",
+      category: "framer",
+      signature: "getAncestorsForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get every ancestor of a node, from the direct parent up to the page root.\n\n@param input - `{ id }`: the id of the node to start from.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The ancestors ordered from closest parent to the page root.',
+      references: []
+    },
     {
       name: "getCanvasRoot",
       category: "framer",
       signature: "getCanvasRoot(): Promise<CanvasRootNode>",
-      description: "Get the root of the current canvas.",
+      description: "Get the root of the current canvas.\n@category canvas",
       references: ["CanvasRootNode"]
     },
     {
@@ -13070,70 +13375,70 @@ var methodsByCategory = {
       name: "getChildren",
       category: "framer",
       signature: "getChildren(nodeId: NodeId): Promise<CanvasNode[]>",
-      description: "Get the children of a node.",
+      description: "Get the children of a node.\n@category canvas",
       references: ["CanvasNode"]
     },
     {
       name: "getCodeFile",
       category: "framer",
       signature: "getCodeFile(id: string): Promise<CodeFile | null>",
-      description: 'Get a specific code file by its ID.\n\n@param id - The unique identifier of the code file.\n@returns The CodeFile instance or `null` if not found.\n\n@example\n```ts\nconst codeFile = await framer.getCodeFile("code-file-id")\n```',
+      description: 'Get a specific code file by its ID.\n\n@param id - The unique identifier of the code file.\n@returns The CodeFile instance or `null` if not found.\n\n@example\n```ts\nconst codeFile = await framer.getCodeFile("code-file-id")\n```\n@category code-files',
       references: ["CodeFile"]
     },
     {
       name: "getCodeFiles",
       category: "framer",
       signature: "getCodeFiles(): Promise<readonly CodeFile[]>",
-      description: "Get all code files in the project.\n\n@returns An array of all CodeFile instances.\n\n@example\n```ts\nconst allFiles = await framer.getCodeFiles()\nconsole.log(`Project has ${allFiles.length} code files`)\n```",
+      description: "Get all code files in the project.\n\n@returns An array of all CodeFile instances.\n\n@example\n```ts\nconst allFiles = await framer.getCodeFiles()\nconsole.log(`Project has ${allFiles.length} code files`)\n```\n@category code-files",
       references: ["CodeFile"]
     },
     {
       name: "getCollection",
       category: "framer",
       signature: "getCollection(id: NodeId): Promise<Collection | null>",
-      description: "Get a collection by its id.",
+      description: "Get a collection by its id.\n@category cms",
       references: ["Collection"]
     },
     {
       name: "getCollections",
       category: "framer",
       signature: "getCollections(): Promise<Collection[]>",
-      description: "Get all Collections in the project, both managed and unmanaged.\n\n@example\n```ts\nconst collections = await framer.getCollections()\n```",
+      description: "Get all Collections in the project, both managed and unmanaged.\n\n@example\n```ts\nconst collections = await framer.getCollections()\n```\n@category cms",
       references: ["Collection"]
     },
     {
       name: "getColorStyle",
       category: "framer",
       signature: "getColorStyle(id: NodeId): Promise<ColorStyle | null>",
-      description: "Get a specific color style.",
+      description: "Get a specific color style.\n@category canvas",
       references: ["ColorStyle"]
     },
     {
       name: "getColorStyles",
       category: "framer",
       signature: "getColorStyles(): Promise<ColorStyle[]>",
-      description: "Get all color styles in the project.",
+      description: "Get all color styles in the project.\n@category canvas",
       references: ["ColorStyle"]
     },
     {
       name: "getCurrentUser",
       category: "framer",
       signature: "getCurrentUser(): Promise<User>",
-      description: "Get information about the user that's interacting with the plugin.\n\n@example\n```ts\nconst user = await framer.getCurrentUser();\n```",
+      description: "Get information about the user that's interacting with the plugin.\n\n@example\n```ts\nconst user = await framer.getCurrentUser();\n```\n@category user",
       references: ["User"]
     },
     {
       name: "getCustomCode",
       category: "framer",
       signature: "getCustomCode(): Promise<CustomCode>",
-      description: "Get custom code settings set by the plugin. Your plugin can detect if\ncustom code was set and whether the user has disabled it.\n\n@example\n```ts\nconst customCode = await framer.getCustomCode()\nif (customCode.bodyStart.disabled) {\n  // Custom code was disabled by the user in settings\n}\n```",
+      description: "Get custom code settings set by the plugin.\n\nYour plugin can detect if custom code was set and whether the user has\ndisabled it.\n\n@example\n```ts\nconst customCode = await framer.getCustomCode()\nif (customCode.bodyStart.disabled) {\n  // Custom code was disabled by the user in settings\n}\n```\n@category code-files",
       references: ["CustomCode"]
     },
     {
       name: "getDefaultLocale",
       category: "framer",
       signature: "getDefaultLocale(): Promise<Locale>",
-      description: "Get the default locale of the project.\n\n@example\n```ts\nconst defaultLocale = await framer.getDefaultLocale()\n```",
+      description: "Get the default locale of the project.\n\n@example\n```ts\nconst defaultLocale = await framer.getDefaultLocale()\n```\n@category localization",
       references: ["Locale"]
     },
     {
@@ -13147,21 +13452,28 @@ var methodsByCategory = {
       name: "getFont",
       category: "framer",
       signature: "getFont(family: string, attributes?: FontAttributes): Promise<Font | null>",
-      description: 'Get a specific font from a family by name. This is not case sensitive.\nBy default, returns a font with normal weight and style. Returns `null`\nif the font does not exist or lacks the requested weight/style combination.\n\nNote: Custom fonts are not available to plugins.\n\n@param family - The font family name (e.g., `"Noto Sans"`).\n@param attributes - Optional weight and style attributes.\n@returns The matched font or `null` if not found.\n\n@example\n```ts\n// Get Noto Sans with default weight (400) and normal style\nconst font = await framer.getFont("Noto Sans")\n\n// Get Noto Sans with a specific weight and style\nconst font = await framer.getFont("Noto Sans", {\n  weight: 800,\n  style: "italic"\n})\n```',
+      description: 'Get a specific font from a family by name.\n\nThis is not case sensitive. By default, returns a font with normal weight\nand style. Returns `null` if the font does not exist or lacks the\nrequested weight/style combination.\n\nNote: Custom fonts are not available to plugins.\n\n@param family - The font family name (e.g., `"Noto Sans"`).\n@param attributes - Optional weight and style attributes.\n@returns The matched font or `null` if not found.\n\n@example\n```ts\n// Get Noto Sans with default weight (400) and normal style\nconst font = await framer.getFont("Noto Sans")\n\n// Get Noto Sans with a specific weight and style\nconst font = await framer.getFont("Noto Sans", {\n  weight: 800,\n  style: "italic"\n})\n```\n@category canvas',
       references: ["FontAttributes", "Font"]
     },
     {
       name: "getFonts",
       category: "framer",
       signature: "getFonts(): Promise<Font[]>",
-      description: "Get all available fonts. Unlike the Font Picker which groups fonts by\ntypeface, this lists individual fonts for each weight and style (each\nrepresenting a separate font file).\n\nNote: Custom fonts are not available to plugins.\n\n@returns An array of all available fonts.\n\n@example\n```ts\nconst fonts = await framer.getFonts()\n```",
+      description: "Get all available fonts.\n\nUnlike the Font Picker which groups fonts by typeface, this lists\nindividual fonts for each weight and style (each representing a separate\nfont file).\n\nNote: Custom fonts are not available to plugins.\n\n@returns An array of all available fonts.\n\n@example\n```ts\nconst fonts = await framer.getFonts()\n```\n@category canvas",
       references: ["Font"]
     },
+    {
+      name: "getGroundNodeForAgent",
+      category: "framer",
+      signature: "getGroundNodeForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the top-level node on the canvas that contains the given node.\n\n@param input - `{ id }`: the id of a descendant node.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The top-level node, or `null` if none applies.',
+      references: []
+    },
     {
       name: "getImage",
       category: "framer",
       signature: "getImage(): Promise<ImageAsset | null>",
-      description: "Get the image of the current selection or `null` if there is no image.\n\nIn `editImage` mode, this returns the image the user already has set,\nwhich your plugin can then modify.",
+      description: "Get the image of the current selection or `null` if there is no image.\n\nIn `editImage` mode, this returns the image the user already has set,\nwhich your plugin can then modify.\n@category canvas",
       references: ["ImageAsset"]
     },
     {
@@ -13182,105 +13494,140 @@ var methodsByCategory = {
       name: "getLocales",
       category: "framer",
       signature: "getLocales(): Promise<readonly Locale[]>",
-      description: "Get all Locales in the project.\n\nDoes not include the default Locale. See `getDefaultLocale`.\n\n@example\n```ts\nconst locales = await framer.getLocales()\n```",
+      description: "Get all Locales in the project.\n\nDoes not include the default Locale. See `getDefaultLocale`.\n\n@example\n```ts\nconst locales = await framer.getLocales()\n```\n@category localization",
       references: ["Locale"]
     },
     {
       name: "getLocalizationGroups",
       category: "framer",
       signature: "getLocalizationGroups(filter?: GetLocalizationGroupsFilter): Promise<readonly LocalizationGroup[]>",
-      description: 'Get Localization Groups in the project, optionally filtered.\n\n@param filter - Optional filter to narrow down the returned groups.\n\n@example\n```ts\n// Get all groups\nconst groups = await framer.getLocalizationGroups()\n\n// Get only page groups\nconst pageGroups = await framer.getLocalizationGroups({ type: "page" })\n\n// Get specific groups by ID\nconst specific = await framer.getLocalizationGroups({ groupIds: ["id1", "id2"] })\n```',
+      description: 'Get Localization Groups in the project, optionally filtered.\n\n@param filter - Optional filter to narrow down the returned groups.\n\n@example\n```ts\n// Get all groups\nconst groups = await framer.getLocalizationGroups()\n\n// Get only page groups\nconst pageGroups = await framer.getLocalizationGroups({ type: "page" })\n\n// Get specific groups by ID\nconst specific = await framer.getLocalizationGroups({ groupIds: ["id1", "id2"] })\n```\n@category localization',
       references: ["GetLocalizationGroupsFilter", "LocalizationGroup"]
     },
     {
       name: "getManagedCollections",
       category: "framer",
       signature: "getManagedCollections(): Promise<ManagedCollection[]>",
-      description: "Retrieve Collections that are managed by the current Plugin.\n\n- Only Collections created or controlled by your Plugin appear in this list.\n- These Collections can be modified without the restrictions placed on user-created Collections.\n\n@example\n```ts\nconst managedCollections = await framer.getManagedCollections();\n```",
+      description: "Retrieve Collections that are managed by the current Plugin.\n\n- Only Collections created or controlled by your Plugin appear in this list.\n- These Collections can be modified without the restrictions placed on user-created Collections.\n\n@example\n```ts\nconst managedCollections = await framer.getManagedCollections();\n```\n@category cms",
       references: ["ManagedCollection"]
     },
     {
       name: "getNode",
       category: "framer",
       signature: "getNode(nodeId: NodeId): Promise<AnyNode | null>",
-      description: "Get a node by its id.",
+      description: "Get a node by its id.\n@category canvas",
       references: ["AnyNode"]
     },
+    {
+      name: "getNodeForAgent",
+      category: "framer",
+      signature: "getNodeForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get a single node on the page, including its children.\n\n@param input - `{ id }`: the id of the node to read.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The node, or `null` if no node with that id exists on the page.',
+      references: []
+    },
+    {
+      name: "getNodesForAgent",
+      category: "framer",
+      signature: "getNodesForAgent(input: { ids: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get multiple nodes on the page, including their children.\nIds that don\'t resolve to a node are skipped.\n\n@param input - `{ ids }`: the ids of the nodes to read.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The nodes that were found, in input order.',
+      references: []
+    },
+    {
+      name: "getNodesOfTypesForAgent",
+      category: "framer",
+      signature: "getNodesOfTypesForAgent(input: { types: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get every node on the page of one or more kinds (e.g. `"FrameNode"`, `"RichTextNode"`, `"ComponentInstanceNode"`).\n\n@param input - `{ types }`: the node kinds to match.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching nodes without their children.',
+      references: []
+    },
     {
       name: "getNodesWithAttribute",
       category: "framer",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: "Get all nodes with a certain attribute.",
+      description: "Get all nodes with a certain attribute.\n@category canvas",
       references: ["T", "Node"]
     },
     {
       name: "getNodesWithAttributeSet",
       category: "framer",
       signature: "getNodesWithAttributeSet(attribute: T): Promise<Node[]>",
-      description: "Get all nodes with a certain attribute which value is set.",
+      description: "Get all nodes with a certain attribute which value is set.\n@category canvas",
       references: ["T", "Node"]
     },
     {
       name: "getNodesWithType",
       category: "framer",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: "Get all nodes of a certain class.",
+      description: "Get all nodes of a certain class.\n@category canvas",
       references: ["FrameNode"]
     },
     {
       name: "getParent",
       category: "framer",
       signature: "getParent(nodeId: NodeId): Promise<AnyNode | null>",
-      description: "Get the parent of a node.",
+      description: "Get the parent of a node.\n@category canvas",
       references: ["AnyNode"]
     },
+    {
+      name: "getParentNodeForAgent",
+      category: "framer",
+      signature: "getParentNodeForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the direct parent of a node.\n\n@param input - `{ id }`: the id of the child node.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The parent node, or `null` if the node has no parent or doesn\'t exist.',
+      references: []
+    },
     {
       name: "getProjectInfo",
       category: "framer",
       signature: "getProjectInfo(): Promise<ProjectInfo>",
-      description: "Get the project info like name and id.",
+      description: "Get the project info like name and id.\n@category settings",
       references: ["ProjectInfo"]
     },
     {
       name: "getPublishInfo",
       category: "framer",
       signature: "getPublishInfo(): Promise<PublishInfo>",
-      description: "Get information about the published website, such as the time of the most\nrecent deploy, or the URL of the current page. Provides information about\nboth `staging` and `production` environments (either may be `null` if the\nsite has never been published).\n\n@returns The current publish info for both staging and production.",
+      description: "Get information about the published website.\n\nProvides details such as the time of the most recent deploy or the URL of\nthe current page. Covers both `staging` and `production` environments\n(either may be `null` if the site has never been published).\n\n@returns The current publish info for both staging and production.\n@category settings",
       references: ["PublishInfo"]
     },
     {
       name: "getRect",
       category: "framer",
       signature: "getRect(nodeId: NodeId): Promise<Rect$1 | null>",
-      description: "Get the rect of a node",
+      description: "Get the rect of a node\n@category canvas",
       references: ["Rect$1"]
     },
     {
       name: "getRedirects",
       category: "framer",
       signature: "getRedirects(): Promise<readonly Redirect[]>",
-      description: "Get all Redirects in the project.\n\n@returns All of the Redirects in the project.\n\n@example\n```ts\nconst redirects = await framer.getRedirects()\n```",
+      description: "Get all Redirects in the project.\n\n@returns All of the Redirects in the project.\n\n@example\n```ts\nconst redirects = await framer.getRedirects()\n```\n@category settings",
       references: ["Redirect"]
     },
+    {
+      name: "getScopeNodeForAgent",
+      category: "framer",
+      signature: "getScopeNodeForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the scope node (page or component) that contains the given node.\n\n@param input - `{ id }`: the id of a node inside the scope.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The enclosing scope node, or `null` if the node isn\'t in any scope.',
+      references: []
+    },
     {
       name: "getText",
       category: "framer",
       signature: "getText(): Promise<string | null>",
-      description: "Get plaintext of the current selection or null if there is no text.",
+      description: "Get plaintext of the current selection or null if there is no text.\n@category canvas",
       references: []
     },
     {
       name: "getTextStyle",
       category: "framer",
       signature: "getTextStyle(id: NodeId): Promise<TextStyle | null>",
-      description: "Get a specific text style.",
+      description: "Get a specific text style.\n@category canvas",
       references: ["TextStyle"]
     },
     {
       name: "getTextStyles",
       category: "framer",
       signature: "getTextStyles(): Promise<TextStyle[]>",
-      description: "Get all text styles in the project.",
+      description: "Get all text styles in the project.\n@category canvas",
       references: ["TextStyle"]
     },
     {
@@ -13290,11 +13637,18 @@ var methodsByCategory = {
       description: "Get all available vector sets.\n\n@alpha",
       references: ["VectorSet"]
     },
+    {
+      name: "makeExternalComponentLocalForAgent",
+      category: "framer",
+      signature: "makeExternalComponentLocalForAgent(input: { id: string; replaceAll?: boolean; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Converts an external component into a local project component.\n\n@param input - `{ id, replaceAll? }`: the id of the external instance, and whether to replace all instances.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns `success` (with the local component name), `needs_confirmation` (retry with `replaceAll`), or `blocked` with a reason.',
+      references: []
+    },
     {
       name: "mode",
       category: "framer",
       signature: "mode: Mode",
-      description: 'Get the current mode. A plugin can launch in a special mode where only a\nsubset of the API is allowed. The mode is set when the plugin launches\nand never changes while the plugin is active.\n\n@example\n```ts\nif (framer.mode === "image" || framer.mode === "editImage") {\n  // Do image mode specific logic\n  return\n}\n```',
+      description: 'Get the current mode.\n\nA plugin can launch in a special mode where only a subset of the API is\nallowed. The mode is set when the plugin launches and never changes while\nthe plugin is active.\n\n@example\n```ts\nif (framer.mode === "image" || framer.mode === "editImage") {\n  // Do image mode specific logic\n  return\n}\n```\n@category settings',
       references: ["Mode"]
     },
     {
@@ -13304,6 +13658,20 @@ var methodsByCategory = {
       description: "",
       references: ["PublishResult"]
     },
+    {
+      name: "publishForAgent",
+      category: "framer",
+      signature: "publishForAgent(input?: Record<string, unknown>): Promise<unknown>",
+      description: "Executes the publish flow on behalf of an agent.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Action-discriminated input object (preview / confirm_publish / deploy_to_production).\n@returns The action's result \u2014 status, publish URLs, and any errors, warnings, or changes.",
+      references: []
+    },
+    {
+      name: "queryImagesForAgent",
+      category: "framer",
+      signature: "queryImagesForAgent(input: Record<string, unknown>): Promise<unknown>",
+      description: 'Searches for stock images to use on the canvas (e.g. `"FrameNode"` `fill` values). Returns\ncandidate images with preview thumbnails and a `url` field for each. The returned URLs are\nregistered as trusted for this session so they can be applied directly via `fill="<url>"`\nin a subsequent {@link applyAgentChanges} DSL command. Without calling this method first,\nexternal image URLs are rejected at apply time.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Search input object (source / query / count / orientation).\n@returns An object describing the candidates or an error.',
+      references: []
+    },
     {
       name: "readProjectForAgent",
       category: "framer",
@@ -13322,14 +13690,14 @@ var methodsByCategory = {
       name: "removeNodes",
       category: "framer",
       signature: "removeNodes(nodeIds: NodeId[]): Promise<void>",
-      description: "Remove nodes from the canvas.",
+      description: "Remove nodes from the canvas.\n@category canvas",
       references: []
     },
     {
       name: "removeRedirects",
       category: "framer",
       signature: "removeRedirects(redirectIds: string[]): Promise<void>",
-      description: "Remove Redirects from the project. Unknown Redirect IDs are ignored.\n\nThrows a `FramerPluginError` when the user lacks Site Settings permissions\nor when the project plan does not include Redirects.\n\n@param redirectIds - An array of Redirect IDs to remove.\n\n@example\n```ts\nawait framer.removeRedirects([aboutPageRedirect.id, blogPageRedirect.id])\n```",
+      description: "Remove Redirects from the project.\n\nUnknown Redirect IDs are ignored.\n\nThrows a `FramerPluginError` when the user lacks Site Settings permissions\nor when the project plan does not include Redirects.\n\n@param redirectIds - An array of Redirect IDs to remove.\n\n@example\n```ts\nawait framer.removeRedirects([aboutPageRedirect.id, blogPageRedirect.id])\n```\n@category settings",
       references: []
     },
     {
@@ -13339,6 +13707,23 @@ var methodsByCategory = {
       description: "",
       references: []
     },
+    {
+      name: "reviewChangesForAgent",
+      category: "framer",
+      signature: "reviewChangesForAgent(options?: { pagePath?: string; }): Promise<unknown>",
+      description: "Reviews changes made by prior {@link applyAgentChanges} calls in this session.\n\nConsumes accumulated diagnostics from the session's agent context.\n\n@param options.pagePath - Target page path (e.g. `\"/about\"`). Defaults to the active page.\n@returns The session's accumulated changes, errors, warnings, and deferred trait reports.",
+      references: []
+    },
+    {
+      name: "runSupervisorAgentCommand",
+      category: "framer",
+      signature: "runSupervisorAgentCommand(options: RunSupervisorAgentCommandOptions): Promise<RunSupervisorAgentCommandResult>",
+      description: "",
+      references: [
+        "RunSupervisorAgentCommandOptions",
+        "RunSupervisorAgentCommandResult"
+      ]
+    },
     {
       name: "screenshot",
       category: "framer",
@@ -13357,63 +13742,63 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "framer",
       signature: "setAttributes(nodeId: NodeId, attributes: Partial<AnyEditableAttributes>): Promise<AnyNode | null>",
-      description: "Set the attributes of a node.",
+      description: "Set the attributes of a node.\n@category canvas",
       references: ["AnyEditableAttributes", "AnyNode"]
     },
     {
       name: "setCloseWarning",
       category: "framer",
       signature: "setCloseWarning(message: string | false): Promise<void>",
-      description: 'When enabled, a modal confirmation will appear before close to confirm the action.\n\nPass `false` to disable the warning.\n\n@param message - The message to show when attempting to close the plugin. `false` disables the warning.\n\n@example\n```ts\n// Show a close warning when the user attempts to close the plugin\nawait framer.setCloseWarning("Are you sure?")\n\n// Remove the close warning\nawait framer.setCloseWarning(false)\n```',
+      description: 'When enabled, a modal confirmation will appear before close to confirm the action.\n\nPass `false` to disable the warning.\n\n@param message - The message to show when attempting to close the plugin. `false` disables the warning.\n\n@example\n```ts\n// Show a close warning when the user attempts to close the plugin\nawait framer.setCloseWarning("Are you sure?")\n\n// Remove the close warning\nawait framer.setCloseWarning(false)\n```\n@category settings',
       references: []
     },
     {
       name: "setCustomCode",
       category: "framer",
       signature: "setCustomCode(options: SetCustomCodeOptions): Promise<void>",
-      description: 'Install a custom code snippet in the user\'s website via `<script>` tags.\nA plugin can only set custom HTML once per location. Custom code should be\nvalid HTML. Setting `html` to `null` clears the installed code snippet.\n\n@param options - The custom code options including `html` and `location`.\n\n@example\n```ts\nframer.setCustomCode({\n  html: \'<script src="https://example.com/script.js"></script>\',\n  location: "bodyEnd"\n})\n```',
+      description: 'Install a custom code snippet in the user\'s website via `<script>` tags.\n\nA plugin can only set custom HTML once per location. Custom code should be\nvalid HTML. Setting `html` to `null` clears the installed code snippet.\n\n@param options - The custom code options including `html` and `location`.\n\n@example\n```ts\nframer.setCustomCode({\n  html: \'<script src="https://example.com/script.js"></script>\',\n  location: "bodyEnd"\n})\n```\n@category code-files',
       references: ["SetCustomCodeOptions"]
     },
     {
       name: "setImage",
       category: "framer",
       signature: "setImage(image: NamedImageAssetInput | File): Promise<void>",
-      description: "Upload an image and set it on the selected node.\n\nIn `image` or `editImage` mode, this is the primary method to send the\nselected or edited image back to Framer.",
+      description: "Upload an image and set it on the selected node.\n\nIn `image` or `editImage` mode, this is the primary method to send the\nselected or edited image back to Framer.\n@category canvas",
       references: ["NamedImageAssetInput", "File"]
     },
     {
       name: "setLocalizationData",
       category: "framer",
       signature: "setLocalizationData(update: LocalizationData): Promise<SetLocalizationDataResult>",
-      description: 'Update localization data.\n\n@param update - An object representing the localization update.\n\n@example\n```ts\nawait framer.setLocalizationData({\n    valuesBySource: {\n        [titleSourceId]: {\n            [dutchLocaleId]: { action: "set", value: "Hallo Wereld" }\n        }\n    },\n    statusByLocaleByGroup: {\n        [blogPostGroupId]: {\n            [dutchLocaleId]: "ready",\n            [frenchLocaleId]: "excluded"\n        }\n    }\n})\n```',
+      description: 'Update localization data.\n\n@param update - An object representing the localization update.\n\n@example\n```ts\nawait framer.setLocalizationData({\n    valuesBySource: {\n        [titleSourceId]: {\n            [dutchLocaleId]: { action: "set", value: "Hallo Wereld" }\n        }\n    },\n    statusByLocaleByGroup: {\n        [blogPostGroupId]: {\n            [dutchLocaleId]: "ready",\n            [frenchLocaleId]: "excluded"\n        }\n    }\n})\n```\n@category localization',
       references: ["LocalizationData", "SetLocalizationDataResult"]
     },
     {
       name: "setParent",
       category: "framer",
       signature: "setParent(nodeId: NodeId, parentId: NodeId, index?: number | undefined): Promise<void>",
-      description: "Set the parent of a node.",
+      description: "Set the parent of a node.\n@category canvas",
       references: []
     },
     {
       name: "setRedirectOrder",
       category: "framer",
       signature: "setRedirectOrder(redirectIds: string[]): Promise<void>",
-      description: "Set the order of Redirects in the list. Unknown Redirect IDs are ignored.\n\nThrows a `FramerPluginError` when the user lacks Site Settings permissions\nor when the project plan does not include Redirects.\n\n@param redirectIds - An array of Redirect IDs representing the desired order.\n\n@example\n```ts\nawait framer.setRedirectOrder([aboutPageRedirect.id, blogPageRedirect.id])\n```",
+      description: "Set the order of Redirects in the list.\n\nUnknown Redirect IDs are ignored.\n\nThrows a `FramerPluginError` when the user lacks Site Settings permissions\nor when the project plan does not include Redirects.\n\n@param redirectIds - An array of Redirect IDs representing the desired order.\n\n@example\n```ts\nawait framer.setRedirectOrder([aboutPageRedirect.id, blogPageRedirect.id])\n```\n@category settings",
       references: []
     },
     {
       name: "setSelection",
       category: "framer",
       signature: "setSelection(nodeIds: string | Iterable<string>): Promise<void>",
-      description: "Set the current selection.",
+      description: "Set the current selection.\n@category canvas",
       references: []
     },
     {
       name: "setText",
       category: "framer",
       signature: "setText(text: string): Promise<void>",
-      description: "Set the text of the current selection or insert it onto the canvas.",
+      description: "Set the text of the current selection or insert it onto the canvas.\n@category canvas",
       references: []
     },
     {
@@ -13440,35 +13825,35 @@ var methodsByCategory = {
       name: "typecheckCode",
       category: "framer",
       signature: "typecheckCode(fileName: string, content: string, compilerOptions?: ts.server.protocol.CompilerOptions, sessionId?: string): Promise<TypecheckDiagnostic[]>",
-      description: "Type check a code file and return the diagnostics.\n\n@param fileName - The name of the code file, must include the extension. Use `*.tsx` for TSX files, otherwise the React JSX syntax will be rejected.\n@param content - The content of the code file.\n@param compilerOptions - Optional compiler options to override the default compiler options for type checking.\n@param sessionId - Optional session ID. Pass it when repeatedly type checking the same file. If not provided, a new session will be created for each type check, which is slow.",
+      description: "Type check a code file and return the diagnostics.\n\n@param fileName - The name of the code file, must include the extension. Use `*.tsx` for TSX files, otherwise the React JSX syntax will be rejected.\n@param content - The content of the code file.\n@param compilerOptions - Optional compiler options to override the default compiler options for type checking.\n@param sessionId - Optional session ID. Pass it when repeatedly type checking the same file. If not provided, a new session will be created for each type check, which is slow.\n@category code-files",
       references: ["ts.server.protocol.CompilerOptions", "TypecheckDiagnostic"]
     },
     {
       name: "uploadFile",
       category: "framer",
       signature: "uploadFile(file: NamedFileAssetInput | File): Promise<FileAsset>",
-      description: "Uploads a file without assigning it to a property.",
+      description: "Uploads a file without assigning it to a property.\n@category canvas",
       references: ["NamedFileAssetInput", "File", "FileAsset"]
     },
     {
       name: "uploadFiles",
       category: "framer",
       signature: "uploadFiles(files: readonly NamedFileAssetInput[]): Promise<FileAsset[]>",
-      description: "Upload multiple files without assigning them to properties.",
+      description: "Upload multiple files without assigning them to properties.\n@category canvas",
       references: ["NamedFileAssetInput", "FileAsset"]
     },
     {
       name: "uploadImage",
       category: "framer",
       signature: "uploadImage(image: NamedImageAssetInput | File): Promise<ImageAsset>",
-      description: "Upload an image without assigning it to a property.",
+      description: "Upload an image without assigning it to a property.\n@category canvas",
       references: ["NamedImageAssetInput", "File", "ImageAsset"]
     },
     {
       name: "uploadImages",
       category: "framer",
       signature: "uploadImages(images: readonly NamedImageAssetInput[]): Promise<ImageAsset[]>",
-      description: "Upload multiple images without assigning them to properties.",
+      description: "Upload multiple images without assigning them to properties.\n@category canvas",
       references: ["NamedImageAssetInput", "ImageAsset"]
     }
   ],
@@ -13664,7 +14049,7 @@ var methodsByCategory = {
       name: "addItems",
       category: "ManagedCollection",
       signature: "addItems(items: ManagedCollectionItemInput[]): Promise<void>",
-      description: 'Add new items or update existing ones if their IDs match. This method\nperforms an upsert: items with matching IDs are updated, new IDs are\ninserted.\n\nEach item requires an `id` and `slug`. Custom field data is provided via\nthe `fieldData` object, using field IDs as keys.\n\nCurrently, calling `addItems` with existing item IDs merges the provided\nfield data with the existing items\' current field data, meaning any\nomitted fields remain unchanged. In version 4.0.0, this behavior will\nchange to fully replace items, removing any fields not explicitly\nincluded. Always include all fields when updating existing items to avoid\nunexpected behavior.\n\nUse `"ManagedCollection.addItems"` to check if this method is allowed.\n\n@param items - An array of items to add or update.\n\n@example\n```ts\nawait collection.addItems([\n  {\n    id: "1",\n    slug: "item-1",\n    fieldData: {\n      [nameField.id]: { type: "string", value: "Eric" },\n      [ageField.id]: { type: "number", value: 47 },\n    },\n  },\n])\n```',
+      description: 'Add new items or update existing ones if their IDs match.\n\nThis method performs an upsert: items with matching IDs are updated,\nnew IDs are inserted.\n\nEach item requires an `id` and `slug`. Custom field data is provided via\nthe `fieldData` object, using field IDs as keys.\n\nCurrently, calling `addItems` with existing item IDs merges the provided\nfield data with the existing items\' current field data, meaning any\nomitted fields remain unchanged. In version 4.0.0, this behavior will\nchange to fully replace items, removing any fields not explicitly\nincluded. Always include all fields when updating existing items to avoid\nunexpected behavior.\n\nUse `"ManagedCollection.addItems"` to check if this method is allowed.\n\n@param items - An array of items to add or update.\n\n@example\n```ts\nawait collection.addItems([\n  {\n    id: "1",\n    slug: "item-1",\n    fieldData: {\n      [nameField.id]: { type: "string", value: "Eric" },\n      [ageField.id]: { type: "number", value: 47 },\n    },\n  },\n])\n```',
       references: ["ManagedCollectionItemInput"]
     },
     {
@@ -13706,7 +14091,7 @@ var methodsByCategory = {
       name: "navigateTo",
       category: "ManagedCollection",
       signature: "navigateTo(opts?: NavigableOptions): Promise<void>",
-      description: "Navigate to this collection. May switch modes to reveal the relevant view.",
+      description: "Navigate to this collection.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
@@ -13727,7 +14112,7 @@ var methodsByCategory = {
       name: "setFields",
       category: "ManagedCollection",
       signature: "setFields(fields: ManagedCollectionFieldInput[]): Promise<void>",
-      description: 'Add, update, or remove Collection fields. Fields not included in the\narray will be removed. You can configure up to 30 custom fields.\n\nEach field requires an `id`, `name`, and `type`. For the `id`, use a\nunique identifier that stays the same across future synchronizations.\nAny change in `id` can break data assignments on the canvas. The maximum\nlength for an `id` is 64 characters.\n\nBy default, managed collection fields set by a plugin are not editable by\nusers. Set `userEditable: true` on a field to allow user editing. Note\nthat fields marked as `userEditable` can no longer have their values set\nby the plugin when using `addItems`.\n\nUse `"ManagedCollection.setFields"` to check if this method is allowed.\n\n@param fields - The array of fields that should be used for the collection.\n\n@example\n```ts\nawait collection.setFields([\n  { id: "1", type: "string", name: "Name" },\n  { id: "2", type: "number", name: "Age" },\n  { id: "3", type: "string", name: "Description", userEditable: true },\n])\n```',
+      description: 'Add, update, or remove Collection fields.\n\nFields not included in the array will be removed. You can configure\nup to 30 custom fields.\n\nEach field requires an `id`, `name`, and `type`. For the `id`, use a\nunique identifier that stays the same across future synchronizations.\nAny change in `id` can break data assignments on the canvas. The maximum\nlength for an `id` is 64 characters.\n\nBy default, managed collection fields set by a plugin are not editable by\nusers. Set `userEditable: true` on a field to allow user editing. Note\nthat fields marked as `userEditable` can no longer have their values set\nby the plugin when using `addItems`.\n\nUse `"ManagedCollection.setFields"` to check if this method is allowed.\n\n@param fields - The array of fields that should be used for the collection.\n\n@example\n```ts\nawait collection.setFields([\n  { id: "1", type: "string", name: "Name" },\n  { id: "2", type: "number", name: "Age" },\n  { id: "3", type: "string", name: "Description", userEditable: true },\n])\n```',
       references: ["ManagedCollectionFieldInput"]
     },
     {
@@ -13741,7 +14126,7 @@ var methodsByCategory = {
       name: "setPluginData",
       category: "ManagedCollection",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Similar to local storage, you can store custom\ndata on the Managed Collection (e.g., the last synchronization date or a\nconnected database ID).\n\nUse `"ManagedCollection.setPluginData"` to check if this method is allowed.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\n@example\n```ts\nconst currentDate = new Date().toISOString()\nawait collection.setPluginData("lastSynchronizedAt", currentDate)\n```',
+      description: 'Set plugin data by key.\n\nSimilar to local storage, you can store custom data on the Managed\nCollection (e.g., the last synchronization date or a connected database\nID).\n\nUse `"ManagedCollection.setPluginData"` to check if this method is allowed.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\n@example\n```ts\nconst currentDate = new Date().toISOString()\nawait collection.setPluginData("lastSynchronizedAt", currentDate)\n```',
       references: []
     }
   ],
@@ -13981,21 +14366,21 @@ var methodsByCategory = {
       name: "bottom",
       category: "SVGNode",
       signature: "bottom: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from bottom edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from bottom edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "centerX",
       category: "SVGNode",
       signature: "centerX: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
       name: "centerY",
       category: "SVGNode",
       signature: "centerY: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
@@ -14016,7 +14401,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "SVGNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -14030,7 +14415,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "SVGNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -14044,7 +14429,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "SVGNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -14065,42 +14450,42 @@ var methodsByCategory = {
       name: "height",
       category: "SVGNode",
       signature: "height: HeightLength | null",
-      description: 'Height of the node. Accepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Height of the node.\n\nAccepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["HeightLength"]
     },
     {
       name: "left",
       category: "SVGNode",
       signature: "left: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from left edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from left edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "locked",
       category: "SVGNode",
       signature: "locked: boolean",
-      description: "Whether the node is locked for editing. Defaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is locked for editing.\n\nDefaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "name",
       category: "SVGNode",
       signature: "name: string | null",
-      description: "The name of the node displayed in the layers panel.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
+      description: "The name of the node displayed in the layers panel.\n\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "navigateTo",
       category: "SVGNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
       name: "opacity",
       category: "SVGNode",
       signature: "opacity: number",
-      description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque). Defaults to `1`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+      description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque).\n\nDefaults to `1`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
       references: []
     },
     {
@@ -14121,14 +14506,14 @@ var methodsByCategory = {
       name: "right",
       category: "SVGNode",
       signature: "right: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from right edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from right edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "rotation",
       category: "SVGNode",
       signature: "rotation: number",
-      description: "Rotation angle in degrees. Defaults to `0`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+      description: "Rotation angle in degrees.\n\nDefaults to `0`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
       references: []
     },
     {
@@ -14142,14 +14527,14 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "SVGNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setPluginData",
       category: "SVGNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
@@ -14163,28 +14548,28 @@ var methodsByCategory = {
       name: "top",
       category: "SVGNode",
       signature: "top: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from top edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from top edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "visible",
       category: "SVGNode",
       signature: "visible: boolean",
-      description: "Whether the node is visible on the canvas. Defaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is visible on the canvas.\n\nDefaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "walk",
       category: "SVGNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
       name: "width",
       category: "SVGNode",
       signature: "width: WidthLength | null",
-      description: 'Width of the node. Accepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Width of the node.\n\nAccepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["WidthLength"]
     },
     {
@@ -14200,21 +14585,21 @@ var methodsByCategory = {
       name: "bottom",
       category: "TextNode",
       signature: "bottom: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from bottom edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from bottom edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "centerX",
       category: "TextNode",
       signature: "centerX: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
       name: "centerY",
       category: "TextNode",
       signature: "centerY: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
@@ -14249,7 +14634,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "TextNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -14263,7 +14648,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "TextNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -14277,7 +14662,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "TextNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -14298,77 +14683,77 @@ var methodsByCategory = {
       name: "getText",
       category: "TextNode",
       signature: "getText(): Promise<string | null>",
-      description: "Get the text of this node. Plain text content, not HTML.",
+      description: "Get the text of this node.\n\nPlain text content, not HTML.",
       references: []
     },
     {
       name: "gridItemColumnSpan",
       category: "TextNode",
       signature: 'gridItemColumnSpan: WithGridItemTrait["gridItemColumnSpan"]',
-      description: 'Number of columns to span, or `"all"` for all columns. For nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.',
+      description: 'Number of columns to span, or `"all"` for all columns.\n\nFor nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.',
       references: []
     },
     {
       name: "gridItemFillCellHeight",
       category: "TextNode",
       signature: 'gridItemFillCellHeight: WithGridItemTrait["gridItemFillCellHeight"]',
-      description: "Whether to fill the grid cell height. For nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
+      description: "Whether to fill the grid cell height.\n\nFor nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "gridItemFillCellWidth",
       category: "TextNode",
       signature: 'gridItemFillCellWidth: WithGridItemTrait["gridItemFillCellWidth"]',
-      description: "Whether to fill the grid cell width. For nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
+      description: "Whether to fill the grid cell width.\n\nFor nodes inside a grid container. Defaults to `true`. Supported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "gridItemHorizontalAlignment",
       category: "TextNode",
       signature: 'gridItemHorizontalAlignment: WithGridItemTrait["gridItemHorizontalAlignment"]',
-      description: 'Horizontal alignment within grid cell. For nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
+      description: 'Horizontal alignment within grid cell.\n\nFor nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
       references: []
     },
     {
       name: "gridItemRowSpan",
       category: "TextNode",
       signature: 'gridItemRowSpan: WithGridItemTrait["gridItemRowSpan"]',
-      description: "Number of rows to span. For nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.",
+      description: "Number of rows to span.\n\nFor nodes inside a grid container. Defaults to `1`. Supported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "gridItemVerticalAlignment",
       category: "TextNode",
       signature: 'gridItemVerticalAlignment: WithGridItemTrait["gridItemVerticalAlignment"]',
-      description: 'Vertical alignment within grid cell. For nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
+      description: 'Vertical alignment within grid cell.\n\nFor nodes inside a grid container. Defaults to `"center"`. Supported by FrameNode, TextNode.',
       references: []
     },
     {
       name: "height",
       category: "TextNode",
       signature: "height: HeightLength | null",
-      description: 'Height of the node. Accepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Height of the node.\n\nAccepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["HeightLength"]
     },
     {
       name: "inlineTextStyle",
       category: "TextNode",
       signature: "inlineTextStyle: TextStyle | null",
-      description: "Apply a text style preset. Setting to `null` removes the text style.\nSupported by TextNode.",
+      description: "Apply a text style preset.\n\nSetting to `null` removes the text style. Supported by TextNode.",
       references: ["TextStyle"]
     },
     {
       name: "left",
       category: "TextNode",
       signature: "left: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from left edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from left edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "link",
       category: "TextNode",
       signature: 'link: WithLinkTrait["link"]',
-      description: 'URL or internal page link. External: `"https://example.com"`, internal: `"/about"`,\nemail: `"mailto:user@example.com"`. Setting to `null` removes the link.\nSupported by FrameNode, TextNode.',
+      description: 'URL or internal page link.\n\nExternal: `"https://example.com"`, internal: `"/about"`,\nemail: `"mailto:user@example.com"`. Setting to `null` removes the link.\nSupported by FrameNode, TextNode.',
       references: []
     },
     {
@@ -14382,7 +14767,7 @@ var methodsByCategory = {
       name: "linkOpenInNewTab",
       category: "TextNode",
       signature: 'linkOpenInNewTab: WithLinkTrait["linkOpenInNewTab"]',
-      description: "Whether to open the link in a new tab. Default is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
+      description: "Whether to open the link in a new tab.\n\nDefault is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
       references: []
     },
     {
@@ -14410,7 +14795,7 @@ var methodsByCategory = {
       name: "locked",
       category: "TextNode",
       signature: "locked: boolean",
-      description: "Whether the node is locked for editing. Defaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is locked for editing.\n\nDefaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
@@ -14445,42 +14830,42 @@ var methodsByCategory = {
       name: "name",
       category: "TextNode",
       signature: "name: string | null",
-      description: "The name of the node displayed in the layers panel.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
+      description: "The name of the node displayed in the layers panel.\n\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "navigateTo",
       category: "TextNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
       name: "opacity",
       category: "TextNode",
       signature: "opacity: number",
-      description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque). Defaults to `1`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+      description: "Opacity of the node, from `0` (fully transparent) to `1` (fully opaque).\n\nDefaults to `1`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
       references: []
     },
     {
       name: "overflow",
       category: "TextNode",
       signature: 'overflow: WithOverflowTrait["overflow"]',
-      description: "Controls how content that exceeds the element's box is handled.\nSetting to `null` removes the overflow property. Will overwrite `overflowX` or `overflowY`.\nSupported by FrameNode, TextNode.",
+      description: "Controls how content that exceeds the element's box is handled.\n\nSetting to `null` removes the overflow property. Will overwrite `overflowX` or `overflowY`.\nSupported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "overflowX",
       category: "TextNode",
       signature: 'overflowX: WithOverflowTrait["overflowX"]',
-      description: "Controls horizontal overflow behavior.\nSetting to `null` removes the overflow X property. Supported by FrameNode, TextNode.",
+      description: "Controls horizontal overflow behavior.\n\nSetting to `null` removes the overflow X property. Supported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "overflowY",
       category: "TextNode",
       signature: 'overflowY: WithOverflowTrait["overflowY"]',
-      description: "Controls vertical overflow behavior.\nSetting to `null` removes the overflow Y property. Supported by FrameNode, TextNode.",
+      description: "Controls vertical overflow behavior.\n\nSetting to `null` removes the overflow Y property. Supported by FrameNode, TextNode.",
       references: []
     },
     {
@@ -14501,14 +14886,14 @@ var methodsByCategory = {
       name: "right",
       category: "TextNode",
       signature: "right: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from right edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from right edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "rotation",
       category: "TextNode",
       signature: "rotation: number",
-      description: "Rotation angle in degrees. Defaults to `0`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
+      description: "Rotation angle in degrees.\n\nDefaults to `0`. Supported by FrameNode, TextNode, SVGNode, ComponentInstanceNode.",
       references: []
     },
     {
@@ -14522,7 +14907,7 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "TextNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
@@ -14536,56 +14921,56 @@ var methodsByCategory = {
       name: "setPluginData",
       category: "TextNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setText",
       category: "TextNode",
       signature: "setText(text: string): Promise<void>",
-      description: 'Set the text of this node. Plain text content, not HTML.\n\nUse `"TextNode.setText"` to check if this method is allowed.',
+      description: 'Set the text of this node.\n\nPlain text content, not HTML.\n\nUse `"TextNode.setText"` to check if this method is allowed.',
       references: []
     },
     {
       name: "textTruncation",
       category: "TextNode",
       signature: 'textTruncation: WithTextTruncationTrait["textTruncation"]',
-      description: "Maximum number of lines a text node can display before being truncated with an ellipsis.\nMust be used alongside `overflow`. Setting to `null` removes the text truncation property.\nSupported by TextNode.",
+      description: "Maximum number of lines before text is truncated with an ellipsis.\n\nMust be used alongside `overflow`. Setting to `null` removes the text truncation property.\nSupported by TextNode.",
       references: []
     },
     {
       name: "top",
       category: "TextNode",
       signature: "top: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from top edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from top edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "visible",
       category: "TextNode",
       signature: "visible: boolean",
-      description: "Whether the node is visible on the canvas. Defaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is visible on the canvas.\n\nDefaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "walk",
       category: "TextNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
       name: "width",
       category: "TextNode",
       signature: "width: WidthLength | null",
-      description: 'Width of the node. Accepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Width of the node.\n\nAccepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["WidthLength"]
     },
     {
       name: "zIndex",
       category: "TextNode",
       signature: 'zIndex: WithZIndexTrait["zIndex"]',
-      description: "Stacking order of positioned elements. Higher values appear on top of lower values.\nSetting to `null` removes the z-index property. Supported by FrameNode, TextNode.",
+      description: "Stacking order of positioned elements.\n\nHigher values appear on top of lower values.\nSetting to `null` removes the z-index property. Supported by FrameNode, TextNode.",
       references: []
     },
     {
@@ -14811,7 +15196,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "UnknownNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -14825,7 +15210,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "UnknownNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -14839,7 +15224,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "UnknownNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -14860,7 +15245,7 @@ var methodsByCategory = {
       name: "navigateTo",
       category: "UnknownNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
@@ -14881,21 +15266,21 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "UnknownNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setPluginData",
       category: "UnknownNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
       name: "walk",
       category: "UnknownNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
@@ -14975,21 +15360,21 @@ var methodsByCategory = {
       name: "bottom",
       category: "VectorSetItemNode",
       signature: "bottom: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from bottom edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from bottom edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "centerX",
       category: "VectorSetItemNode",
       signature: "centerX: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor horizontal position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
       name: "centerY",
       category: "VectorSetItemNode",
       signature: "centerY: CSSDimension<CSSUnit.Percentage> | null",
-      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Center anchor vertical position as percentage (e.g. `"50%"`).\n\nUsed when pins are not set.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Percentage"]
     },
     {
@@ -15010,7 +15395,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "VectorSetItemNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -15024,7 +15409,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "VectorSetItemNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -15038,7 +15423,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "VectorSetItemNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -15059,35 +15444,35 @@ var methodsByCategory = {
       name: "height",
       category: "VectorSetItemNode",
       signature: "height: HeightLength | null",
-      description: 'Height of the node. Accepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Height of the node.\n\nAccepts pixel, percentage, fraction, viewport-height values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["HeightLength"]
     },
     {
       name: "left",
       category: "VectorSetItemNode",
       signature: "left: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from left edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from left edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "locked",
       category: "VectorSetItemNode",
       signature: "locked: boolean",
-      description: "Whether the node is locked for editing. Defaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is locked for editing.\n\nDefaults to `false`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "name",
       category: "VectorSetItemNode",
       signature: "name: string | null",
-      description: "The name of the node displayed in the layers panel.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
+      description: "The name of the node displayed in the layers panel.\n\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode,\nComponentNode, VectorSetNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "navigateTo",
       category: "VectorSetItemNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
@@ -15101,7 +15486,7 @@ var methodsByCategory = {
       name: "right",
       category: "VectorSetItemNode",
       signature: "right: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from right edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from right edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
@@ -15115,42 +15500,42 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "VectorSetItemNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setPluginData",
       category: "VectorSetItemNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
       name: "top",
       category: "VectorSetItemNode",
       signature: "top: CSSDimension<CSSUnit.Pixel> | null",
-      description: 'Distance from top edge when using absolute/fixed positioning.\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Distance from top edge when using absolute/fixed positioning.\n\nOnly applies when position is not `"relative"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["CSSDimension", "CSSUnit.Pixel"]
     },
     {
       name: "visible",
       category: "VectorSetItemNode",
       signature: "visible: boolean",
-      description: "Whether the node is visible on the canvas. Defaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
+      description: "Whether the node is visible on the canvas.\n\nDefaults to `true`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.",
       references: []
     },
     {
       name: "walk",
       category: "VectorSetItemNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
       name: "width",
       category: "VectorSetItemNode",
       signature: "width: WidthLength | null",
-      description: 'Width of the node. Accepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
+      description: 'Width of the node.\n\nAccepts pixel, percentage, fraction values, or `"fit-content"`.\nSupported by FrameNode, TextNode, SVGNode, ComponentInstanceNode, VectorSetItemNode.',
       references: ["WidthLength"]
     },
     {
@@ -15180,7 +15565,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "VectorSetNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -15194,7 +15579,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "VectorSetNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -15208,7 +15593,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "VectorSetNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -15229,7 +15614,7 @@ var methodsByCategory = {
       name: "navigateTo",
       category: "VectorSetNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
@@ -15250,21 +15635,21 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "VectorSetNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setPluginData",
       category: "VectorSetNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
       name: "walk",
       category: "VectorSetNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
@@ -15301,7 +15686,7 @@ var methodsByCategory = {
       name: "getActiveCollectionItem",
       category: "WebPageNode",
       signature: "getActiveCollectionItem(): Promise<CollectionItem | null>",
-      description: "Get the active collection item for this CMS detail page.\nReturns null if this is not a detail page or the collection is empty.\n\n@alpha",
+      description: "Get the active collection item for this CMS detail page.\n\nReturns null if this is not a detail page or the collection is empty.\n\n@alpha",
       references: ["CollectionItem"]
     },
     {
@@ -15322,7 +15707,7 @@ var methodsByCategory = {
       name: "getNodesWithAttribute",
       category: "WebPageNode",
       signature: "getNodesWithAttribute(attribute: T): Promise<Node[]>",
-      description: 'Get the descendants of this node that support `attribute`. This\nreturns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
+      description: 'Get the descendants of this node that support `attribute`.\n\nThis returns nodes that have the given attribute defined in their type,\nregardless of whether it has been set.\n\n@param attribute - The attribute name to filter by.\n@returns An array of nodes that support the attribute.\n\n@example\n```ts\n// Get any kind of node that has a background color attribute.\nconst nodes = await framer.getNodesWithAttribute("backgroundColor")\n```',
       references: ["T", "Node"]
     },
     {
@@ -15336,7 +15721,7 @@ var methodsByCategory = {
       name: "getNodesWithType",
       category: "WebPageNode",
       signature: 'getNodesWithType(type: "FrameNode"): Promise<FrameNode[]>',
-      description: 'Get descendants of this node that match the given type. This can\nalso be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
+      description: 'Get descendants of this node that match the given type.\n\nThis can also be used to query within a selection subtree.\n\n@param type - The node type to search for.\n@returns An array of matching descendant nodes.\n\n@example\n```ts\n// Get all frame nodes in a project.\nconst frameNodes = await framer.getNodesWithType("FrameNode")\n\n// Query within a selection subtree.\nconst selection = await framer.getSelection()\nif (selection.length === 1) {\n  const frameNodes = await selection[0].getNodesWithType("FrameNode")\n}\n```',
       references: ["FrameNode"]
     },
     {
@@ -15350,7 +15735,7 @@ var methodsByCategory = {
       name: "getPluginData",
       category: "WebPageNode",
       signature: "getPluginData(key: string): Promise<string | null>",
-      description: "Get plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
+      description: "Get plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@returns The stored value, or `null` if no data exists for the key.",
       references: []
     },
     {
@@ -15371,7 +15756,7 @@ var methodsByCategory = {
       name: "navigateTo",
       category: "WebPageNode",
       signature: 'navigateTo(opts?: Pick<NavigableOptions, "select" | "zoomIntoView">): Promise<void>',
-      description: "Navigate to this node. May switch modes to reveal the relevant view.",
+      description: "Navigate to this node.\n\nMay switch modes to reveal the relevant view.",
       references: ["NavigableOptions"]
     },
     {
@@ -15399,21 +15784,21 @@ var methodsByCategory = {
       name: "setAttributes",
       category: "WebPageNode",
       signature: 'setAttributes(update: Partial<NodeClassToEditableAttributes[(typeof this)[ClassKey]]>): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Set the attributes of this node. Attributes are merged with existing\nvalues, so only the provided attributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
+      description: 'Set the attributes of this node.\n\nAttributes are merged with existing values, so only the provided\nattributes are updated.\n\n@param update - The attributes to update.\n@returns The updated node, or `null` if the node was not found.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.setAttributes"` to check if this method is allowed.',
       references: []
     },
     {
       name: "setPluginData",
       category: "WebPageNode",
       signature: "setPluginData(key: string, value: string | null): Promise<void>",
-      description: 'Set plugin data by key. Plugin data lets you store arbitrary\nstring values on individual nodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
+      description: 'Set plugin data by key.\n\nPlugin data lets you store arbitrary string values on individual\nnodes, scoped to your plugin.\n\n@param key - The plugin data key.\n@param value - The value to set, or `null` to remove.\n\nUse `"Node.setPluginData"` to check if this method is allowed.',
       references: []
     },
     {
       name: "walk",
       category: "WebPageNode",
       signature: "walk(this: AnyNode): AsyncGenerator<AnyNode>",
-      description: "Walk this node and its descendants recursively using an async\ngenerator. Yields nodes depth-first.",
+      description: "Walk this node and its descendants recursively.\n\nUses an async generator. Yields nodes depth-first.",
       references: ["AnyNode"]
     },
     {
@@ -15432,15 +15817,15 @@ function getMethod(query) {
   return methods?.find((m) => m.name === methodName);
 }
 __name(getMethod, "getMethod");
-function getClass(name) {
-  const info = classes[name.toLowerCase()];
+function getClass(name2) {
+  const info = classes[name2.toLowerCase()];
   if (!info) return void 0;
-  const methods = methodsByCategory[name.toLowerCase()] ?? [];
+  const methods = methodsByCategory[name2.toLowerCase()] ?? [];
   return { info, methods };
 }
 __name(getClass, "getClass");
-function getType(name) {
-  return types[name.toLowerCase()];
+function getType(name2) {
+  return types[name2.toLowerCase()];
 }
 __name(getType, "getType");
 
@@ -15457,10 +15842,10 @@ function formatDocComment(text, indent = "") {
   ].join("\n");
 }
 __name(formatDocComment, "formatDocComment");
-function formatClass(name, description, methods) {
+function formatClass(name2, description, methods) {
   const lines = [];
   if (description) lines.push(formatDocComment(description));
-  lines.push(`class ${name} {`);
+  lines.push(`class ${name2} {`);
   let first = true;
   for (const method of methods) {
     if (method.signature.startsWith("[")) continue;
@@ -15640,13 +16025,35 @@ function inferHeadlessServerUrl(projectUrlOrId) {
   }
 }
 __name(inferHeadlessServerUrl, "inferHeadlessServerUrl");
+function getRelayTokenPath() {
+  return path7.join(getConfigDir(), "relay-token");
+}
+__name(getRelayTokenPath, "getRelayTokenPath");
+function readRelayToken() {
+  try {
+    const token = fs7.readFileSync(getRelayTokenPath(), "utf-8").trim();
+    return token.length > 0 ? token : null;
+  } catch {
+    return null;
+  }
+}
+__name(readRelayToken, "readRelayToken");
+
+// src/relay-client.ts
 var __filename$1 = fileURLToPath(import.meta.url);
-var __dirname$1 = path6.dirname(__filename$1);
+var __dirname$1 = path7.dirname(__filename$1);
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var client = createTRPCClient({
   links: [
     httpLink({
-      url: `http://127.0.0.1:${RELAY_PORT}`
+      url: `http://127.0.0.1:${RELAY_PORT}`,
+      headers() {
+        const token = readRelayToken();
+        if (!token) {
+          return {};
+        }
+        return { Authorization: `Bearer ${token}` };
+      }
     })
   ]
 });
@@ -15709,7 +16116,7 @@ async function ensureRelayServerRunning(options = {}) {
     logger?.log("Relay server not running, starting it...");
   }
   const isRunningFromSource = __filename$1.endsWith(".ts");
-  const scriptPath = isRunningFromSource ? path6.resolve(__dirname$1, "./start-relay-server.ts") : path6.resolve(__dirname$1, "./start-relay-server.js");
+  const scriptPath = isRunningFromSource ? path7.resolve(__dirname$1, "./start-relay-server.ts") : path7.resolve(__dirname$1, "./start-relay-server.js");
   debug("relay", `spawning server process: ${scriptPath}`);
   const serverProcess = spawn(
     isRunningFromSource ? "tsx" : process.execPath,
@@ -15736,19 +16143,19 @@ async function ensureRelayServerRunning(options = {}) {
   throw new Error("Failed to start relay server after 5 seconds");
 }
 __name(ensureRelayServerRunning, "ensureRelayServerRunning");
-var FRAMER_TEMPORARY_DIR = path6.join(os.tmpdir(), "framer");
+var FRAMER_TEMPORARY_DIR = path7.join(os.tmpdir(), "framer");
 function ensureTemporaryDir() {
-  fs6.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
+  fs7.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
 }
 __name(ensureTemporaryDir, "ensureTemporaryDir");
 function cleanupStaleSessionCodeFiles(activeSessionIds) {
-  if (!fs6.existsSync(FRAMER_TEMPORARY_DIR)) return;
+  if (!fs7.existsSync(FRAMER_TEMPORARY_DIR)) return;
   const activeSessionIdsSet = new Set(activeSessionIds);
-  for (const entry of fs6.readdirSync(FRAMER_TEMPORARY_DIR)) {
+  for (const entry of fs7.readdirSync(FRAMER_TEMPORARY_DIR)) {
     const [sessionId] = entry.split("-");
     if (activeSessionIdsSet.has(sessionId)) continue;
-    const filePath = path6.join(FRAMER_TEMPORARY_DIR, entry);
-    fs6.rmSync(filePath, { recursive: true, force: true, maxRetries: 2 });
+    const filePath = path7.join(FRAMER_TEMPORARY_DIR, entry);
+    fs7.rmSync(filePath, { recursive: true, force: true, maxRetries: 2 });
   }
 }
 __name(cleanupStaleSessionCodeFiles, "cleanupStaleSessionCodeFiles");
@@ -15756,10 +16163,10 @@ __name(cleanupStaleSessionCodeFiles, "cleanupStaleSessionCodeFiles");
 // src/skills.ts
 var META_SKILL_NAME = "framer";
 var CODE_COMPONENTS_SKILL_NAME = "framer-code-components";
-var __dirname2 = path6.dirname(fileURLToPath(import.meta.url));
-var skillsDocsDir = path6.join(__dirname2, "..", "docs", "skills");
-function readSkillDoc(name) {
-  return fs6.readFileSync(path6.join(skillsDocsDir, name), "utf-8").trimEnd();
+var __dirname2 = path7.dirname(fileURLToPath(import.meta.url));
+var skillsDocsDir = path7.join(__dirname2, "..", "docs", "skills");
+function readSkillDoc(name2) {
+  return fs7.readFileSync(path7.join(skillsDocsDir, name2), "utf-8").trimEnd();
 }
 __name(readSkillDoc, "readSkillDoc");
 function buildMetaSkill() {
@@ -15802,27 +16209,27 @@ function buildProjectCanvasSkill(projectId, agentContext, canvasPrompt) {
 }
 __name(buildProjectCanvasSkill, "buildProjectCanvasSkill");
 function writeSkill(root, skillName, content) {
-  fs6.mkdirSync(root, { recursive: true });
-  const rootStat = fs6.statSync(root);
+  fs7.mkdirSync(root, { recursive: true });
+  const rootStat = fs7.statSync(root);
   if (!rootStat.isDirectory()) {
     throw new Error(`Skill root is not a directory: ${root}`);
   }
-  const skillDir = path6.join(root, skillName);
-  const filePath = path6.join(skillDir, "SKILL.md");
-  const current = fs6.lstatSync(skillDir, { throwIfNoEntry: false });
+  const skillDir = path7.join(root, skillName);
+  const filePath = path7.join(skillDir, "SKILL.md");
+  const current = fs7.lstatSync(skillDir, { throwIfNoEntry: false });
   if (current && (current.isSymbolicLink() || !current.isDirectory())) {
-    fs6.rmSync(skillDir, { recursive: true, force: true });
+    fs7.rmSync(skillDir, { recursive: true, force: true });
   }
-  fs6.mkdirSync(skillDir, { recursive: true });
-  fs6.writeFileSync(filePath, content, "utf-8");
+  fs7.mkdirSync(skillDir, { recursive: true });
+  fs7.writeFileSync(filePath, content, "utf-8");
   return filePath;
 }
 __name(writeSkill, "writeSkill");
 function getDefaultSkillRoots() {
   const home = os.homedir();
   return [
-    path6.join(home, ".agents", "skills"),
-    path6.join(home, ".claude", "skills")
+    path7.join(home, ".agents", "skills"),
+    path7.join(home, ".claude", "skills")
   ];
 }
 __name(getDefaultSkillRoots, "getDefaultSkillRoots");
@@ -15832,14 +16239,14 @@ function cleanupStaleSkills(activeProjectIds, skillRoots) {
     [...activeProjectIds].map(toSafeProjectId)
   );
   for (const root of roots) {
-    if (!fs6.existsSync(root)) continue;
-    for (const entry of fs6.readdirSync(root)) {
+    if (!fs7.existsSync(root)) continue;
+    for (const entry of fs7.readdirSync(root)) {
       if (!entry.startsWith(CANVAS_SKILL_PREFIX)) continue;
       const sanitizedProjectId = entry.slice(CANVAS_SKILL_PREFIX.length);
       const isActive = sanitizedActiveProjectIds.has(sanitizedProjectId);
       if (isActive) continue;
-      const skillDir = path6.join(root, entry);
-      fs6.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
+      const skillDir = path7.join(root, entry);
+      fs7.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
     }
   }
 }
@@ -15900,8 +16307,8 @@ function printSetupSummary(results) {
   const installLocations = /* @__PURE__ */ new Set();
   for (const result of results) {
     for (const filePath of result.paths) {
-      const skillDir = path6.dirname(filePath);
-      const root = path6.dirname(skillDir);
+      const skillDir = path7.dirname(filePath);
+      const root = path7.dirname(skillDir);
       installLocations.add(root);
     }
   }
@@ -16076,7 +16483,7 @@ program.command("exec").description("Execute code in a session").requiredOption(
   let code = evalCode;
   if (!code && filePath) {
     try {
-      code = fs6.readFileSync(filePath, "utf-8");
+      code = fs7.readFileSync(filePath, "utf-8");
     } catch (err) {
       printError(`Failed to read file: ${formatError(err)}`);
       await waitForTrackingToFinish();
@@ -16254,9 +16661,9 @@ session.command("list").description("List all active sessions").action(async ()
 var project = program.command("project").description("Manage projects");
 project.command("list").description("List recently used projects").action(() => {
   printJson(
-    listProjects().map(({ projectId, name, lastUsedAt }) => ({
+    listProjects().map(({ projectId, name: name2, lastUsedAt }) => ({
       projectId,
-      name,
+      name: name2,
       lastUsedAt
     }))
   );
@@ -16277,6 +16684,32 @@ project.command("auth <projectUrlOrId> [apiKey]").description("Authorize and sav
   });
   print(`Project ${projectId} saved`);
 });
+async function saveAuthResult(verb, authFn) {
+  try {
+    const result = await authFn();
+    const { projectId } = result;
+    if (!projectId) throw new Error("No project ID returned from browser flow");
+    debug(`project.${verb}`, `${projectId} \u2014 saving credentials`);
+    saveProject({ projectId, apiKey: result.apiKey, userId: result.userId });
+    print(`Project ${projectId} saved`);
+  } catch (error) {
+    printError(`Failed to ${verb} project: ${formatError(error)}`);
+    await waitForTrackingToFinish();
+    process.exit(1);
+  }
+}
+__name(saveAuthResult, "saveAuthResult");
+project.command("new").description(
+  "Create a new Framer project via browser approval and save its credentials"
+).action(() => saveAuthResult("create", acquireAuthWithNewProject));
+project.command("remix <sourceProjectUrlOrId>").description(
+  "Remix (duplicate) an existing Framer project via browser approval and save its credentials"
+).action(
+  (sourceProjectUrlOrId) => saveAuthResult(
+    "remix",
+    () => acquireAuthWithRemixProject(sourceProjectUrlOrId)
+  )
+);
 session.command("destroy <sessionId>").description("Destroy a session").action(async (sessionId) => {
   await ensureRelayForCli();
   try {