framer-dalton 0.0.18 → 0.0.21

package/dist/cli.js

@@ -1,18 +1,32 @@
 #!/usr/bin/env node
-import fs3 from 'fs';
-import path4 from 'path';
+import fs6 from 'fs';
+import path6 from 'path';
 import { Command } from 'commander';
-import crypto from 'crypto';
+import crypto, { randomUUID } from 'crypto';
 import http from 'http';
 import { spawn, execFile } from 'child_process';
-import os from 'os';
 import { z } from 'zod';
+import os from 'os';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.18 */
+/* @framer/ai CLI v0.0.21 */
 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,20 +50,27 @@ function openUrl(url) {
 __name(openUrl, "openUrl");
 function getConfigDir() {
   if (process.env.XDG_CONFIG_HOME) {
-    return path4.join(process.env.XDG_CONFIG_HOME, "framer");
+    return path6.join(process.env.XDG_CONFIG_HOME, "framer");
   }
   if (process.platform === "win32") {
-    return path4.join(process.env.APPDATA || os.homedir(), "framer");
+    return path6.join(process.env.APPDATA || os.homedir(), "framer");
   }
-  return path4.join(os.homedir(), ".config", "framer");
+  return path6.join(os.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
+function ensureConfigDir() {
+  const configDir = getConfigDir();
+  fs6.mkdirSync(configDir, { recursive: true, mode: 448 });
+}
+__name(ensureConfigDir, "ensureConfigDir");
+
+// src/config/projects.ts
 function getProjectsConfigPath() {
-  return path4.join(getConfigDir(), "projects.json");
+  return path6.join(getConfigDir(), "projects.json");
 }
 __name(getProjectsConfigPath, "getProjectsConfigPath");
 function getLegacyCredentialsPath() {
-  return path4.join(getConfigDir(), "credentials.json");
+  return path6.join(getConfigDir(), "credentials.json");
 }
 __name(getLegacyCredentialsPath, "getLegacyCredentialsPath");
 var ProjectsConfigSchema = z.object({
@@ -58,6 +79,7 @@ var ProjectsConfigSchema = z.object({
     z.string(),
     z.object({
       apiKey: z.string(),
+      userId: z.string().optional(),
       name: z.string().optional(),
       lastUsedAt: z.string().optional()
     })
@@ -65,26 +87,16 @@ var ProjectsConfigSchema = z.object({
 });
 var LegacyCredentialsSchema = z.record(z.string(), z.string());
 function readJsonFile(filePath) {
-  if (!fs3.existsSync(filePath)) {
-    return null;
-  }
   try {
-    return JSON.parse(fs3.readFileSync(filePath, "utf-8"));
+    return JSON.parse(fs6.readFileSync(filePath, "utf-8"));
   } catch (_error) {
     return null;
   }
 }
 __name(readJsonFile, "readJsonFile");
-function ensureConfigDir() {
-  const configDir = getConfigDir();
-  if (!fs3.existsSync(configDir)) {
-    fs3.mkdirSync(configDir, { recursive: true, mode: 448 });
-  }
-}
-__name(ensureConfigDir, "ensureConfigDir");
 function writeProjectsConfig(config) {
   ensureConfigDir();
-  fs3.writeFileSync(
+  fs6.writeFileSync(
     getProjectsConfigPath(),
     JSON.stringify(config, null, "	"),
     {
@@ -111,7 +123,7 @@ function migrateLegacyCredentials() {
   }
   const config = { version: 2, projects };
   writeProjectsConfig(config);
-  fs3.rmSync(getLegacyCredentialsPath(), { force: true });
+  fs6.rmSync(getLegacyCredentialsPath(), { force: true });
   return config;
 }
 __name(migrateLegacyCredentials, "migrateLegacyCredentials");
@@ -124,23 +136,24 @@ function readProjectsConfig() {
       return result.data;
     }
   }
-  if (fs3.existsSync(getLegacyCredentialsPath())) {
+  if (fs6.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");
@@ -156,18 +169,21 @@ function listProjects() {
   });
 }
 __name(listProjects, "listProjects");
-function getApiKey(projectId) {
+function getProject(projectId) {
   const config = readProjectsConfig();
-  return config.projects[projectId]?.apiKey ?? null;
+  const project2 = config.projects[projectId];
+  if (!project2) return null;
+  return { projectId, ...project2 };
 }
-__name(getApiKey, "getApiKey");
+__name(getProject, "getProject");
 function saveProject(project2) {
   const config = readProjectsConfig();
-  config.projects[project2.projectId] = {
-    apiKey: project2.apiKey,
-    name: project2.name,
-    lastUsedAt: project2.lastUsedAt
-  };
+  const newProject = { ...config.projects[project2.projectId] };
+  newProject.apiKey = project2.apiKey;
+  if (project2.userId) newProject.userId = project2.userId;
+  if (project2.name) newProject.name = project2.name;
+  if (project2.lastUsedAt) newProject.lastUsedAt = project2.lastUsedAt;
+  config.projects[project2.projectId] = newProject;
   writeProjectsConfig(config);
 }
 __name(saveProject, "saveProject");
@@ -192,6 +208,216 @@ function debug(tag, message) {
   console.error(`[debug ${timestamp}] ${tag}: ${message}`);
 }
 __name(debug, "debug");
+var DEFAULT_FS_POLL_INTERVAL_MS = 1e3;
+var fsPollIntervalMs = DEFAULT_FS_POLL_INTERVAL_MS;
+var SettingsWatcher = class {
+  constructor(settingsPath) {
+    this.settingsPath = settingsPath;
+  }
+  settingsPath;
+  static {
+    __name(this, "SettingsWatcher");
+  }
+  start(callback) {
+    fs6.watchFile(
+      this.settingsPath,
+      { persistent: false, interval: fsPollIntervalMs },
+      (curr, prev) => {
+        if (
+          // File was modified
+          curr.mtimeMs !== prev.mtimeMs || // File was renamed and replaced by a new file with the same name
+          curr.ino !== prev.ino || // File changed without any of the above changing for some reason?
+          curr.size !== prev.size
+        ) {
+          callback();
+        }
+      }
+    );
+    return this;
+  }
+  stop() {
+    fs6.unwatchFile(this.settingsPath);
+    return this;
+  }
+};
+
+// src/config/settings.ts
+var DEFAULT_MACHINE_ID = "unknown-machine-id-this-should-never-be-persisted";
+var DEFAULT_SETTINGS = {
+  machineId: DEFAULT_MACHINE_ID,
+  telemetryEnabled: true,
+  telemetryNoticeShown: false
+};
+var SettingsFileSchema = z.object({
+  machineId: z.string().optional(),
+  telemetryEnabled: z.boolean().optional(),
+  telemetryNoticeShown: z.boolean().optional()
+});
+function getSettingsPath() {
+  return path6.join(getConfigDir(), "settings.json");
+}
+__name(getSettingsPath, "getSettingsPath");
+var settings;
+var settingsWatcher;
+function getSettings() {
+  if (settings) return settings;
+  settings = readSettingsFile();
+  if (!settingsWatcher) {
+    settingsWatcher = new SettingsWatcher(getSettingsPath()).start(() => {
+      settings = void 0;
+    });
+  }
+  return settings;
+}
+__name(getSettings, "getSettings");
+function readSettingsFile() {
+  const settingsPath = getSettingsPath();
+  try {
+    const raw = JSON.parse(fs6.readFileSync(settingsPath, "utf-8"));
+    const result = SettingsFileSchema.parse(raw);
+    return {
+      machineId: result.machineId ?? DEFAULT_SETTINGS.machineId,
+      telemetryEnabled: result.telemetryEnabled ?? DEFAULT_SETTINGS.telemetryEnabled,
+      telemetryNoticeShown: result.telemetryNoticeShown ?? DEFAULT_SETTINGS.telemetryNoticeShown
+    };
+  } catch {
+    return { ...DEFAULT_SETTINGS };
+  }
+}
+__name(readSettingsFile, "readSettingsFile");
+function setSettings(newSettings) {
+  settings = newSettings;
+  writeSettingsFile(newSettings);
+}
+__name(setSettings, "setSettings");
+function writeSettingsFile(settings2) {
+  ensureConfigDir();
+  fs6.writeFileSync(getSettingsPath(), JSON.stringify(settings2, null, "	"), {
+    mode: 384
+  });
+}
+__name(writeSettingsFile, "writeSettingsFile");
+function getMachineId() {
+  const settings2 = getSettings();
+  if (settings2.machineId === DEFAULT_MACHINE_ID) {
+    const machineId = crypto.randomUUID();
+    setSettings({ ...settings2, machineId });
+  }
+  return getSettings().machineId;
+}
+__name(getMachineId, "getMachineId");
+function isTelemetryEnabled() {
+  return getSettings().telemetryEnabled;
+}
+__name(isTelemetryEnabled, "isTelemetryEnabled");
+function setTelemetryEnabled(enabled2) {
+  const settings2 = getSettings();
+  setSettings({ ...settings2, telemetryEnabled: enabled2 });
+}
+__name(setTelemetryEnabled, "setTelemetryEnabled");
+function isTelemetryNoticeShown() {
+  return getSettings().telemetryNoticeShown;
+}
+__name(isTelemetryNoticeShown, "isTelemetryNoticeShown");
+function markTelemetryNoticeShown() {
+  const settings2 = getSettings();
+  setSettings({ ...settings2, telemetryNoticeShown: true });
+}
+__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.21" 
+);
+var trackingEndpoint = "https://events.framer.com/track";
+var inProgressTrackings = /* @__PURE__ */ new Set();
+function sharedFields() {
+  return {
+    machineId: getMachineId(),
+    cliVersion: VERSION
+  };
+}
+__name(sharedFields, "sharedFields");
+function wrapEvent(event) {
+  return {
+    source: "framer-dalton",
+    timestamp: Date.now(),
+    type: "track",
+    uuid: randomUUID(),
+    data: event
+  };
+}
+__name(wrapEvent, "wrapEvent");
+function postEvent(event) {
+  if (!isTelemetryEnabled()) return false;
+  if (process.env.NODE_ENV === "test" && true) return false;
+  const promise = fetch(trackingEndpoint, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "User-Agent": `framer-dalton/${VERSION}`
+    },
+    body: JSON.stringify([wrapEvent(event)]),
+    signal: AbortSignal.timeout(
+      5e3
+      /* 5 seconds */
+    )
+  }).then((response) => {
+    if (!response.ok) {
+      debug(
+        "tracking",
+        `failed to send ${event.event}: HTTP ${response.status}`
+      );
+    }
+  }).catch((error) => {
+    debug(
+      "tracking",
+      `failed to send ${event.event}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }).finally(() => {
+    inProgressTrackings.delete(promise);
+  });
+  inProgressTrackings.add(promise);
+  return true;
+}
+__name(postEvent, "postEvent");
+function waitForTrackingToFinish() {
+  return Promise.allSettled(Array.from(inProgressTrackings));
+}
+__name(waitForTrackingToFinish, "waitForTrackingToFinish");
+function trackAuthStart(payload) {
+  postEvent({
+    event: "local_agents_auth_start",
+    ...sharedFields(),
+    ...payload
+  });
+}
+__name(trackAuthStart, "trackAuthStart");
+function trackAuthSuccess(payload) {
+  postEvent({
+    event: "local_agents_auth_success",
+    ...sharedFields(),
+    ...payload
+  });
+}
+__name(trackAuthSuccess, "trackAuthSuccess");
+function trackSkillsInstall(payload) {
+  postEvent({
+    event: "local_agents_skills_install",
+    ...sharedFields(),
+    ...payload
+  });
+}
+__name(trackSkillsInstall, "trackSkillsInstall");
+function trackError(payload) {
+  postEvent({
+    event: "local_agents_error",
+    ...sharedFields(),
+    ...payload
+  });
+}
+__name(trackError, "trackError");
 
 // src/utils.ts
 function formatError(error) {
@@ -209,6 +435,10 @@ function print(message) {
   console.log(message);
 }
 __name(print, "print");
+function printWarning(message) {
+  console.warn(message);
+}
+__name(printWarning, "printWarning");
 function printError(message) {
   console.error(message);
 }
@@ -284,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
   });
 }
@@ -322,11 +552,34 @@ function parseCode(value) {
   return null;
 }
 __name(parseCode, "parseCode");
-async function acquireKeyFromBrowser(projectId) {
+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 {
+    const url = new URL(projectUrlOrId);
+    if (isFramerHostname(url.hostname.toLowerCase())) return url.origin;
+  } catch {
+  }
+  return "https://framer.com";
+}
+__name(resolveProjectOrigin, "resolveProjectOrigin");
+function runBrowserAuthFlow(options) {
+  const {
+    deeplinkParams,
+    expectProjectId,
+    successMessage,
+    browserSuccessMessage,
+    projectOrigin = "https://framer.com",
+    authType,
+    pollProjectId
+  } = options;
   const state = crypto.randomBytes(16).toString("hex");
+  trackAuthStart({ projectId: pollProjectId ?? "unknown", authType });
   return new Promise((resolve, reject) => {
     let settled = false;
-    let pendingApiKey = null;
+    let pendingAuth = null;
     function settle(fn) {
       if (settled) return;
       settled = true;
@@ -340,14 +593,20 @@ async function acquireKeyFromBrowser(projectId) {
       if (url.pathname === "/done") {
         const theme2 = parseTheme(url.searchParams.get("theme"));
         res.writeHead(200, { "Content-Type": "text/html" });
-        res.end(successHtml(theme2), () => {
-          if (pendingApiKey) {
-            const apiKey2 = pendingApiKey;
-            pendingApiKey = null;
+        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");
-              resolve(apiKey2);
+              print(`\u2713 ${successMessage}`);
+              trackAuthSuccess({
+                projectId: auth.projectId ?? pollProjectId ?? "unknown",
+                authMethod: "browser",
+                authType,
+                userId: auth.userId
+              });
+              resolve(auth);
             });
           }
         });
@@ -365,60 +624,85 @@ async function acquireKeyFromBrowser(projectId) {
         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(() => reject(new Error(codeMessages[code])));
+          settle(() => {
+            trackError({
+              errorType: "auth_error",
+              projectId: pollProjectId ?? "unknown",
+              errorMessage: codeMessages[code]
+            });
+            reject(new Error(codeMessages[code]));
+          });
         });
         return;
       }
       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");
-      pendingApiKey = apiKey;
+      pendingAuth = { apiKey, userId, projectId: returnedProjectId };
       res.writeHead(302, { Location: `/done?theme=${theme}` });
       res.end();
     });
     const POLL_INTERVAL_MS = 1e3;
-    const pollTimer = setInterval(() => {
-      const apiKey = getApiKey(projectId);
-      if (apiKey) {
+    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");
-          resolve(apiKey);
+          trackAuthSuccess({
+            projectId: pollProjectId,
+            authMethod: "config_poll",
+            authType,
+            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 = `https://framer.com/projects/${projectId}?view=settings%3Aproject`;
+    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(
-        () => reject(
+      settle(() => {
+        trackError({
+          errorType: "auth_timeout",
+          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."
           )
-        )
-      );
+        );
+      });
     }, TIMEOUT_MS);
     let cleaned = false;
     function cleanup() {
@@ -426,8 +710,8 @@ async function acquireKeyFromBrowser(projectId) {
       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();
     }
@@ -443,10 +727,12 @@ async function acquireKeyFromBrowser(projectId) {
       }
       debug("auth", `callback server listening on port ${addr.port}`);
       const callbackUrl = `http://127.0.0.1:${addr.port}/callback`;
-      const deeplink = new URL("https://framer.com/projects/server-api/auth");
+      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) => {
@@ -461,7 +747,48 @@ async function acquireKeyFromBrowser(projectId) {
     });
   });
 }
-__name(acquireKeyFromBrowser, "acquireKeyFromBrowser");
+__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"];
@@ -679,6 +1006,13 @@ var types = {
       }
     ]
   },
+  aiserviceversion: {
+    name: "AiServiceVersion",
+    description: "Major version segment for the Framer AI chat HTTP path (`/ai/v{version}/chat/`).",
+    kind: "alias",
+    alias: '"3"',
+    references: []
+  },
   allmethods: {
     name: "AllMethods",
     description: "",
@@ -3654,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",
@@ -3910,6 +4244,26 @@ var types = {
     alias: '"hover" | "pressed" | "loading" | "error"',
     references: []
   },
+  getlocalizationgroupsfilter: {
+    name: "GetLocalizationGroupsFilter",
+    description: "Filter options for {@link FramerPluginAPI.getLocalizationGroups}.",
+    kind: "interface",
+    references: ["LocalizationGroupId"],
+    members: [
+      {
+        name: "groupIds",
+        type: "LocalizationGroupId[]",
+        description: "Return only groups matching these IDs.",
+        optional: true
+      },
+      {
+        name: "type",
+        type: 'LocalizationGroup["type"]',
+        description: "Return only groups of this type.",
+        optional: true
+      }
+    ]
+  },
   gridcontentalignment: {
     name: "GridContentAlignment",
     description: "",
@@ -6779,6 +7133,12 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "reviewChangesForAgent",
+        type: "(options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "startAgentConversation",
         type: "(prompt: string, options?: StartAgentConversationOptions) => Promise<StartAgentConversationResult>",
@@ -6799,7 +7159,7 @@ var types = {
       },
       {
         name: "[getAiServiceInfoMessageType]",
-        type: "() => Promise<AiServiceInfo>",
+        type: "(version?: AiServiceVersion) => Promise<AiServiceInfo>",
         description: "",
         optional: false
       },
@@ -6835,7 +7195,7 @@ var types = {
       },
       {
         name: "getAiServiceInfo",
-        type: "() => Promise<AiServiceInfo>",
+        type: "(version?: AiServiceVersion) => Promise<AiServiceInfo>",
         description: "@deprecated Use `getAiServiceInfoMessageType`.",
         optional: false
       },
@@ -7774,6 +8134,13 @@ var types = {
       "ArrayFieldDefinitionData"
     ]
   },
+  supportedlinkrelvalue: {
+    name: "SupportedLinkRelValue",
+    description: "Supported rel values for links. See https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/rel",
+    kind: "alias",
+    alias: '"nofollow" | "noreferrer" | "me" | "ugc" | "sponsored"',
+    references: []
+  },
   svgdata: {
     name: "SVGData",
     description: "",
@@ -8919,7 +9286,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
       }
     ]
@@ -8973,7 +9340,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
       }
     ]
@@ -9057,7 +9424,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
       }
     ]
@@ -9071,7 +9438,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
       }
     ]
@@ -9433,37 +9800,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
       }
     ]
@@ -9498,7 +9865,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
       }
     ]
@@ -9540,7 +9907,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
       }
     ]
@@ -9574,19 +9941,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
       }
     ],
@@ -9596,18 +9963,42 @@ var types = {
     name: "WithLinkTrait",
     description: "",
     kind: "interface",
-    references: [],
+    references: ["SupportedLinkRelValue"],
     members: [
       {
         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
+      },
+      {
+        name: "linkSmoothScroll",
+        type: "boolean | null",
+        description: "Whether to use smooth scrolling for scroll-to-section links.\nSupported by FrameNode, TextNode.",
+        optional: false
+      },
+      {
+        name: "linkClickTrackingId",
+        type: "string | null",
+        description: "Click tracking identifier for analytics.\nSupported by FrameNode, TextNode.",
+        optional: false
+      },
+      {
+        name: "linkRelValues",
+        type: "readonly SupportedLinkRelValue[] | null",
+        description: "Array of rel attribute values for the link.\nSupported by FrameNode, TextNode.",
+        optional: false
+      },
+      {
+        name: "linkPreserveParams",
+        type: "boolean | null",
+        description: "Whether to preserve URL query parameters when navigating.\nSupported by FrameNode, TextNode.",
         optional: false
       }
     ]
@@ -9649,7 +10040,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
       }
     ]
@@ -9691,7 +10082,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
       }
     ]
@@ -9775,7 +10166,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
       }
     ]
@@ -9810,19 +10201,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
       }
     ]
@@ -9836,37 +10227,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
       }
     ]
@@ -9894,7 +10285,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
       }
     ]
@@ -9940,13 +10331,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
       }
     ]
@@ -10016,7 +10407,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
       }
     ]
@@ -10100,7 +10491,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
       }
     ]
@@ -10114,7 +10505,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
       }
     ]
@@ -10143,55 +10534,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",
@@ -10199,35 +10590,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",
@@ -10235,35 +10626,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",
@@ -10283,43 +10674,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",
@@ -10327,31 +10718,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",
@@ -10359,15 +10750,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",
@@ -10379,15 +10770,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 = {
@@ -10632,7 +11023,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"]
     },
     {
@@ -10653,7 +11044,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"]
     },
     {
@@ -10681,7 +11072,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"]
     },
     {
@@ -10709,14 +11100,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: []
     },
     {
@@ -10753,7 +11144,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"]
     },
     {
@@ -10980,28 +11371,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"]
     },
     {
@@ -11043,7 +11434,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"]
     },
     {
@@ -11057,7 +11448,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"]
     },
     {
@@ -11071,7 +11462,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: []
     },
     {
@@ -11099,21 +11490,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: []
     },
     {
@@ -11148,21 +11539,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: []
     },
     {
@@ -11183,14 +11574,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: []
     },
     {
@@ -11204,21 +11595,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"]
     },
     {
@@ -11232,21 +11623,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"]
     },
     {
@@ -11315,7 +11706,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"]
     },
     {
@@ -11329,7 +11720,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"]
     },
     {
@@ -11343,7 +11734,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: []
     },
     {
@@ -11371,7 +11762,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"]
     },
     {
@@ -11399,14 +11790,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: []
     },
     {
@@ -11420,7 +11811,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"]
     },
     {
@@ -11540,7 +11931,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"]
     },
     {
@@ -11554,7 +11945,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"]
     },
     {
@@ -11568,7 +11959,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: []
     },
     {
@@ -11589,7 +11980,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"]
     },
     {
@@ -11610,21 +12001,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"]
     },
     {
@@ -11977,14 +12368,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"]
     },
     {
@@ -12005,35 +12396,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"]
     },
     {
@@ -12047,7 +12438,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: []
     },
     {
@@ -12061,7 +12452,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"]
     },
     {
@@ -12075,7 +12466,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"]
     },
     {
@@ -12089,7 +12480,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: []
     },
     {
@@ -12145,42 +12536,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: []
     },
     {
@@ -12208,14 +12599,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"]
     },
     {
@@ -12236,35 +12627,63 @@ 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: 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.',
+      signature: 'link: WithLinkTrait["link"]',
+      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: []
+    },
+    {
+      name: "linkClickTrackingId",
+      category: "FrameNode",
+      signature: 'linkClickTrackingId: WithLinkTrait["linkClickTrackingId"]',
+      description: "Click tracking identifier for analytics.\nSupported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "linkOpenInNewTab",
       category: "FrameNode",
-      signature: "linkOpenInNewTab: boolean | null",
-      description: "Whether to open the link in a new tab. Default is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
+      signature: 'linkOpenInNewTab: WithLinkTrait["linkOpenInNewTab"]',
+      description: "Whether to open the link in a new tab.\n\nDefault is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
+      references: []
+    },
+    {
+      name: "linkPreserveParams",
+      category: "FrameNode",
+      signature: 'linkPreserveParams: WithLinkTrait["linkPreserveParams"]',
+      description: "Whether to preserve URL query parameters when navigating.\nSupported by FrameNode, TextNode.",
+      references: []
+    },
+    {
+      name: "linkRelValues",
+      category: "FrameNode",
+      signature: 'linkRelValues: WithLinkTrait["linkRelValues"]',
+      description: "Array of rel attribute values for the link.\nSupported by FrameNode, TextNode.",
+      references: []
+    },
+    {
+      name: "linkSmoothScroll",
+      category: "FrameNode",
+      signature: 'linkSmoothScroll: WithLinkTrait["linkSmoothScroll"]',
+      description: "Whether to use smooth scrolling for scroll-to-section links.\nSupported by FrameNode, TextNode.",
       references: []
     },
     {
       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: []
     },
     {
@@ -12299,49 +12718,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: []
     },
     {
@@ -12362,14 +12781,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: []
     },
     {
@@ -12383,14 +12802,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: []
     },
     {
@@ -12425,35 +12844,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: []
     },
     {
@@ -12493,6 +12912,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",
@@ -12518,7 +12944,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"]
     },
     {
@@ -12535,42 +12961,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"]
     },
     {
@@ -12584,7 +13010,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"]
     },
     {
@@ -12601,21 +13027,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"]
     },
     {
@@ -12629,14 +13055,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"]
     },
     {
@@ -12650,7 +13076,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"]
     },
     {
@@ -12664,14 +13090,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"]
     },
     {
@@ -12713,7 +13139,7 @@ var methodsByCategory = {
       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"]
     },
     {
@@ -12734,70 +13160,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"]
     },
     {
@@ -12811,21 +13237,21 @@ 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: "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"]
     },
     {
@@ -12846,105 +13272,105 @@ 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(): Promise<readonly LocalizationGroup[]>",
-      description: "Get all Localization Groups in the project.\n\n@example\n```ts\nconst groups = await framer.getLocalizationGroups()\n\nfor (const group of groups) {\n    console.log(`Group: ${group.name}`)\n\n    for (const source of group.sources) {\n        console.log(`Source: ${source.value}`)\n    }\n}\n```",
-      references: ["LocalizationGroup"]
+      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```\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: "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: "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: "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"]
     },
     {
@@ -12958,7 +13384,7 @@ var methodsByCategory = {
       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"]
     },
     {
@@ -12986,14 +13412,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: []
     },
     {
@@ -13003,6 +13429,13 @@ 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: "screenshot",
       category: "framer",
@@ -13010,67 +13443,74 @@ var methodsByCategory = {
       description: "",
       references: ["ScreenshotOptions", "ScreenshotResult"]
     },
+    {
+      name: "sessionId",
+      category: "framer",
+      signature: "sessionId: string",
+      description: "",
+      references: []
+    },
     {
       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: []
     },
     {
@@ -13097,35 +13537,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"]
     }
   ],
@@ -13321,7 +13761,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"]
     },
     {
@@ -13363,7 +13803,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"]
     },
     {
@@ -13384,7 +13824,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"]
     },
     {
@@ -13398,7 +13838,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: []
     }
   ],
@@ -13638,21 +14078,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"]
     },
     {
@@ -13673,7 +14113,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"]
     },
     {
@@ -13687,7 +14127,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"]
     },
     {
@@ -13701,7 +14141,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: []
     },
     {
@@ -13722,42 +14162,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: []
     },
     {
@@ -13778,14 +14218,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: []
     },
     {
@@ -13799,14 +14239,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: []
     },
     {
@@ -13820,28 +14260,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"]
     },
     {
@@ -13857,21 +14297,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"]
     },
     {
@@ -13906,7 +14346,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"]
     },
     {
@@ -13920,7 +14360,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"]
     },
     {
@@ -13934,7 +14374,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: []
     },
     {
@@ -13955,91 +14395,119 @@ 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: 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.',
+      signature: 'link: WithLinkTrait["link"]',
+      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: []
+    },
+    {
+      name: "linkClickTrackingId",
+      category: "TextNode",
+      signature: 'linkClickTrackingId: WithLinkTrait["linkClickTrackingId"]',
+      description: "Click tracking identifier for analytics.\nSupported by FrameNode, TextNode.",
       references: []
     },
     {
       name: "linkOpenInNewTab",
       category: "TextNode",
-      signature: "linkOpenInNewTab: boolean | null",
-      description: "Whether to open the link in a new tab. Default is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
+      signature: 'linkOpenInNewTab: WithLinkTrait["linkOpenInNewTab"]',
+      description: "Whether to open the link in a new tab.\n\nDefault is automatically determined based on link type.\nSupported by FrameNode, TextNode.",
+      references: []
+    },
+    {
+      name: "linkPreserveParams",
+      category: "TextNode",
+      signature: 'linkPreserveParams: WithLinkTrait["linkPreserveParams"]',
+      description: "Whether to preserve URL query parameters when navigating.\nSupported by FrameNode, TextNode.",
+      references: []
+    },
+    {
+      name: "linkRelValues",
+      category: "TextNode",
+      signature: 'linkRelValues: WithLinkTrait["linkRelValues"]',
+      description: "Array of rel attribute values for the link.\nSupported by FrameNode, TextNode.",
+      references: []
+    },
+    {
+      name: "linkSmoothScroll",
+      category: "TextNode",
+      signature: 'linkSmoothScroll: WithLinkTrait["linkSmoothScroll"]',
+      description: "Whether to use smooth scrolling for scroll-to-section links.\nSupported by FrameNode, TextNode.",
       references: []
     },
     {
       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: []
     },
     {
@@ -14074,42 +14542,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: []
     },
     {
@@ -14130,14 +14598,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: []
     },
     {
@@ -14151,7 +14619,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: []
     },
     {
@@ -14165,56 +14633,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: []
     },
     {
@@ -14440,7 +14908,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"]
     },
     {
@@ -14454,7 +14922,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"]
     },
     {
@@ -14468,7 +14936,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: []
     },
     {
@@ -14489,7 +14957,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"]
     },
     {
@@ -14510,21 +14978,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"]
     },
     {
@@ -14604,21 +15072,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"]
     },
     {
@@ -14639,7 +15107,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"]
     },
     {
@@ -14653,7 +15121,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"]
     },
     {
@@ -14667,7 +15135,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: []
     },
     {
@@ -14688,35 +15156,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"]
     },
     {
@@ -14730,7 +15198,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"]
     },
     {
@@ -14744,42 +15212,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"]
     },
     {
@@ -14809,7 +15277,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"]
     },
     {
@@ -14823,7 +15291,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"]
     },
     {
@@ -14837,7 +15305,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: []
     },
     {
@@ -14858,7 +15326,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"]
     },
     {
@@ -14879,21 +15347,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"]
     },
     {
@@ -14930,7 +15398,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"]
     },
     {
@@ -14951,7 +15419,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"]
     },
     {
@@ -14965,7 +15433,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"]
     },
     {
@@ -14979,7 +15447,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: []
     },
     {
@@ -15000,7 +15468,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"]
     },
     {
@@ -15028,21 +15496,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"]
     },
     {
@@ -15061,15 +15529,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");
 
@@ -15086,10 +15554,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;
@@ -15219,15 +15687,58 @@ ${typeDef}`);
 }
 __name(renderDocs, "renderDocs");
 
-// src/version.ts
-var VERSION = (
-  // typeof is used to ensure this can be used just via tsx or node etc. without build
-  "0.0.18" 
-);
-
-// src/relay-client.ts
+// src/headless-server-url.ts
+var PROD_HEADLESS_SERVER_URL = "wss://api.framer.com/channel/headless-plugin";
+var DEV_HEADLESS_SERVER_URL = "wss://api.development.framer.com/channel/headless-plugin";
+function normalizeHeadlessServerUrl(headlessServerUrl) {
+  const url = new URL(headlessServerUrl);
+  url.protocol = url.protocol === "https:" ? "wss:" : url.protocol === "http:" ? "ws:" : url.protocol;
+  return url.toString();
+}
+__name(normalizeHeadlessServerUrl, "normalizeHeadlessServerUrl");
+function resolveHeadlessServerUrl(projectUrlOrId, overrideHeadlessServerUrl) {
+  const override = overrideHeadlessServerUrl?.trim();
+  if (override) {
+    return normalizeHeadlessServerUrl(override);
+  }
+  return inferHeadlessServerUrl(projectUrlOrId);
+}
+__name(resolveHeadlessServerUrl, "resolveHeadlessServerUrl");
+function createProjectBaseUrl(origin) {
+  return new URL("/projects/", origin).toString();
+}
+__name(createProjectBaseUrl, "createProjectBaseUrl");
+function inferHeadlessServerUrl(projectUrlOrId) {
+  try {
+    const projectUrl = new URL(projectUrlOrId);
+    const hostname = projectUrl.hostname.toLowerCase();
+    if (hostname === "development.framer.com") {
+      return DEV_HEADLESS_SERVER_URL;
+    }
+    if (hostname.endsWith(".beta.framer.com")) {
+      const headlessServerUrl = new URL(PROD_HEADLESS_SERVER_URL);
+      headlessServerUrl.searchParams.set(
+        "baseUrl",
+        createProjectBaseUrl(projectUrl.origin)
+      );
+      return headlessServerUrl.toString();
+    }
+    if (hostname.endsWith(".beta.development.framer.com")) {
+      const headlessServerUrl = new URL(DEV_HEADLESS_SERVER_URL);
+      headlessServerUrl.searchParams.set(
+        "baseUrl",
+        createProjectBaseUrl(projectUrl.origin)
+      );
+      return headlessServerUrl.toString();
+    }
+    return PROD_HEADLESS_SERVER_URL;
+  } catch {
+    return PROD_HEADLESS_SERVER_URL;
+  }
+}
+__name(inferHeadlessServerUrl, "inferHeadlessServerUrl");
 var __filename$1 = fileURLToPath(import.meta.url);
-var __dirname$1 = path4.dirname(__filename$1);
+var __dirname$1 = path6.dirname(__filename$1);
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var client = createTRPCClient({
   links: [
@@ -15295,7 +15806,7 @@ async function ensureRelayServerRunning(options = {}) {
     logger?.log("Relay server not running, starting it...");
   }
   const isRunningFromSource = __filename$1.endsWith(".ts");
-  const scriptPath = isRunningFromSource ? path4.resolve(__dirname$1, "./start-relay-server.ts") : path4.resolve(__dirname$1, "./start-relay-server.js");
+  const scriptPath = isRunningFromSource ? path6.resolve(__dirname$1, "./start-relay-server.ts") : path6.resolve(__dirname$1, "./start-relay-server.js");
   debug("relay", `spawning server process: ${scriptPath}`);
   const serverProcess = spawn(
     isRunningFromSource ? "tsx" : process.execPath,
@@ -15322,32 +15833,30 @@ async function ensureRelayServerRunning(options = {}) {
   throw new Error("Failed to start relay server after 5 seconds");
 }
 __name(ensureRelayServerRunning, "ensureRelayServerRunning");
-var FRAMER_TEMPORARY_DIR = path4.join(os.tmpdir(), "framer");
+var FRAMER_TEMPORARY_DIR = path6.join(os.tmpdir(), "framer");
 function ensureTemporaryDir() {
-  fs3.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
+  fs6.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
 }
 __name(ensureTemporaryDir, "ensureTemporaryDir");
-function isTemporaryFile(filePath) {
-  const absolutePath = path4.resolve(filePath);
-  const isInTemporaryDir = absolutePath.startsWith(
-    FRAMER_TEMPORARY_DIR + path4.sep
-  );
-  const isFile = fs3.statSync(absolutePath, { throwIfNoEntry: false })?.isFile() ?? false;
-  return isInTemporaryDir && isFile;
-}
-__name(isTemporaryFile, "isTemporaryFile");
-function removeTemporaryFile(filePath) {
-  fs3.unlinkSync(filePath);
+function cleanupStaleSessionCodeFiles(activeSessionIds) {
+  if (!fs6.existsSync(FRAMER_TEMPORARY_DIR)) return;
+  const activeSessionIdsSet = new Set(activeSessionIds);
+  for (const entry of fs6.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 });
+  }
 }
-__name(removeTemporaryFile, "removeTemporaryFile");
+__name(cleanupStaleSessionCodeFiles, "cleanupStaleSessionCodeFiles");
 
 // src/skills.ts
 var META_SKILL_NAME = "framer";
 var CODE_COMPONENTS_SKILL_NAME = "framer-code-components";
-var __dirname2 = path4.dirname(fileURLToPath(import.meta.url));
-var skillsDocsDir = path4.join(__dirname2, "..", "docs", "skills");
-function readSkillDoc(name) {
-  return fs3.readFileSync(path4.join(skillsDocsDir, name), "utf-8").trimEnd();
+var __dirname2 = path6.dirname(fileURLToPath(import.meta.url));
+var skillsDocsDir = path6.join(__dirname2, "..", "docs", "skills");
+function readSkillDoc(name2) {
+  return fs6.readFileSync(path6.join(skillsDocsDir, name2), "utf-8").trimEnd();
 }
 __name(readSkillDoc, "readSkillDoc");
 function buildMetaSkill() {
@@ -15369,13 +15878,13 @@ function renderTemplate(template, values) {
   return rendered;
 }
 __name(renderTemplate, "renderTemplate");
-function toProjectSkillName(projectId) {
-  const safeProjectId = projectId.replace(/[^a-zA-Z0-9_-]/g, "-");
-  return `framer-canvas-editing-project-${safeProjectId}`;
+var CANVAS_SKILL_PREFIX = "framer-canvas-editing-project-";
+function toSafeProjectId(projectId) {
+  return projectId.replace(/[^a-zA-Z0-9_-]/g, "-");
 }
-__name(toProjectSkillName, "toProjectSkillName");
+__name(toSafeProjectId, "toSafeProjectId");
 function buildProjectCanvasSkill(projectId, agentContext, canvasPrompt) {
-  const skillName = toProjectSkillName(projectId);
+  const skillName = `${CANVAS_SKILL_PREFIX}${toSafeProjectId(projectId)}`;
   const template = readSkillDoc("framer-canvas-editing-project.md");
   const content = `${renderTemplate(template, {
     SKILL_NAME: skillName,
@@ -15390,32 +15899,48 @@ function buildProjectCanvasSkill(projectId, agentContext, canvasPrompt) {
 }
 __name(buildProjectCanvasSkill, "buildProjectCanvasSkill");
 function writeSkill(root, skillName, content) {
-  fs3.mkdirSync(root, { recursive: true });
-  const rootStat = fs3.statSync(root);
+  fs6.mkdirSync(root, { recursive: true });
+  const rootStat = fs6.statSync(root);
   if (!rootStat.isDirectory()) {
     throw new Error(`Skill root is not a directory: ${root}`);
   }
-  const skillDir = path4.join(root, skillName);
-  const filePath = path4.join(skillDir, "SKILL.md");
-  if (fs3.existsSync(skillDir)) {
-    const current = fs3.lstatSync(skillDir);
-    if (current.isSymbolicLink() || !current.isDirectory()) {
-      fs3.rmSync(skillDir, { recursive: true, force: true });
-    }
+  const skillDir = path6.join(root, skillName);
+  const filePath = path6.join(skillDir, "SKILL.md");
+  const current = fs6.lstatSync(skillDir, { throwIfNoEntry: false });
+  if (current && (current.isSymbolicLink() || !current.isDirectory())) {
+    fs6.rmSync(skillDir, { recursive: true, force: true });
   }
-  fs3.mkdirSync(skillDir, { recursive: true });
-  fs3.writeFileSync(filePath, content, "utf-8");
+  fs6.mkdirSync(skillDir, { recursive: true });
+  fs6.writeFileSync(filePath, content, "utf-8");
   return filePath;
 }
 __name(writeSkill, "writeSkill");
 function getDefaultSkillRoots() {
   const home = os.homedir();
   return [
-    path4.join(home, ".agents", "skills"),
-    path4.join(home, ".claude", "skills")
+    path6.join(home, ".agents", "skills"),
+    path6.join(home, ".claude", "skills")
   ];
 }
 __name(getDefaultSkillRoots, "getDefaultSkillRoots");
+function cleanupStaleSkills(activeProjectIds, skillRoots) {
+  const roots = skillRoots ?? getDefaultSkillRoots();
+  const sanitizedActiveProjectIds = new Set(
+    [...activeProjectIds].map(toSafeProjectId)
+  );
+  for (const root of roots) {
+    if (!fs6.existsSync(root)) continue;
+    for (const entry of fs6.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 });
+    }
+  }
+}
+__name(cleanupStaleSkills, "cleanupStaleSkills");
 function installSkills(options = { type: "base" }) {
   const skillRoots = options.skillRoots ?? getDefaultSkillRoots();
   const skills = [
@@ -15436,18 +15961,24 @@ function installSkills(options = { type: "base" }) {
       content: projectSkill.content
     });
   }
-  return skills.map((skill) => ({
+  const results = skills.map((skill) => ({
     skillName: skill.name,
     paths: skillRoots.map(
       (root) => writeSkill(root, skill.name, skill.content)
     )
   }));
+  trackSkillsInstall({
+    skillType: options.type,
+    skillCount: results.length
+  });
+  return results;
 }
 __name(installSkills, "installSkills");
 
 // src/cli.ts
+var PROGRAM_NAME = "framer-dalton";
 var program = new Command();
-program.name("framer").version(VERSION).description("Framer Server API CLI").option("--debug", "Enable debug logging").hook("preAction", (thisCommand) => {
+program.name(PROGRAM_NAME).version(VERSION).description("Framer Server API CLI").option("--debug", "Enable debug logging").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.debug) {
     setDebugEnabled(true);
@@ -15466,8 +15997,8 @@ function printSetupSummary(results) {
   const installLocations = /* @__PURE__ */ new Set();
   for (const result of results) {
     for (const filePath of result.paths) {
-      const skillDir = path4.dirname(filePath);
-      const root = path4.dirname(skillDir);
+      const skillDir = path6.dirname(filePath);
+      const root = path6.dirname(skillDir);
       installLocations.add(root);
     }
   }
@@ -15476,6 +16007,17 @@ function printSetupSummary(results) {
   );
 }
 __name(printSetupSummary, "printSetupSummary");
+function printTelemetryNotice() {
+  if (isTelemetryNoticeShown()) {
+    return;
+  }
+  printWarning("");
+  printWarning(
+    `Note: Framer collects telemetry. This helps us analyze errors and improve agent UX. Thank you for helping us. You can opt out at any time by running: ${PROGRAM_NAME} telemetry disable`
+  );
+  markTelemetryNoticeShown();
+}
+__name(printTelemetryNotice, "printTelemetryNotice");
 async function getAgentSystemPrompt(sessionId) {
   debug("exec", "getAgentSystemPrompt: calling relay...");
   const result = await client.exec.mutate({
@@ -15528,29 +16070,35 @@ async function refreshSkillsFromSession(sessionId, projectId) {
     });
     debug("skills", "skills installed");
   } catch (err) {
-    printError(
+    throw new Error(
       `Failed to refresh skills for session ${sessionId}: ${formatError(err)}`
     );
-    process.exit(1);
   }
 }
 __name(refreshSkillsFromSession, "refreshSkillsFromSession");
 async function resolveSessionCredentials(projectUrlOrId) {
+  const projectId = extractProjectId(projectUrlOrId);
   try {
-    const projectId = extractProjectId(projectUrlOrId);
     debug("credentials", `projectId=${projectId}`);
-    const cachedApiKey = getApiKey(projectId);
-    if (cachedApiKey) {
+    const cachedProject = getProject(projectId);
+    if (cachedProject) {
       debug("credentials", "using cached API key");
-      return { projectId, apiKey: cachedApiKey };
+      return { apiKey: cachedProject.apiKey, userId: cachedProject.userId };
     }
     debug("credentials", "no cached key, starting browser auth flow...");
-    const newApiKey = await acquireKeyFromBrowser(projectId);
+    const { apiKey, userId } = await acquireAuthFromBrowser(projectUrlOrId);
     debug("credentials", "browser auth complete, saving project");
-    saveProject({ projectId, apiKey: newApiKey });
-    return { projectId, apiKey: newApiKey };
+    saveProject({ projectId, apiKey, userId });
+    return { apiKey, userId };
   } catch (err) {
-    printError(`Failed to resolve credentials: ${formatError(err)}`);
+    const message = formatError(err);
+    trackError({
+      errorType: "credentials_resolve_error",
+      projectId,
+      errorMessage: message
+    });
+    printError(`Failed to resolve credentials: ${message}`);
+    await waitForTrackingToFinish();
     process.exit(1);
   }
 }
@@ -15573,13 +16121,22 @@ async function getProjectName(sessionId) {
   return projectName;
 }
 __name(getProjectName, "getProjectName");
-async function ensureRelayForCli() {
+async function ensureRelayForCli(context) {
   try {
     debug("relay", "ensuring relay server is running...");
     await ensureRelayServerRunning({ logger: { log: print } });
     debug("relay", "relay server ready");
   } catch (err) {
-    printError(`Failed to check relay status: ${formatError(err)}`);
+    const message = formatError(err);
+    trackError({
+      errorType: context?.errorType ?? "relay_check_error",
+      projectId: context?.projectId,
+      sessionId: context?.sessionId,
+      userId: context?.userId,
+      errorMessage: message
+    });
+    printError(`Failed to check relay status: ${message}`);
+    await waitForTrackingToFinish();
     process.exit(1);
   }
 }
@@ -15597,10 +16154,12 @@ async function execAndPrint(sessionId, code) {
     }
     if (result.error) {
       printError(`Error: ${result.error}`);
+      await waitForTrackingToFinish();
       process.exit(1);
     }
   } catch (err) {
     printError(`Execution failed: ${formatError(err)}`);
+    await waitForTrackingToFinish();
     process.exit(1);
   }
 }
@@ -15614,14 +16173,12 @@ program.command("exec").description("Execute code in a session").requiredOption(
   let code = evalCode;
   if (!code && filePath) {
     try {
-      code = fs3.readFileSync(filePath, "utf-8");
+      code = fs6.readFileSync(filePath, "utf-8");
     } catch (err) {
       printError(`Failed to read file: ${formatError(err)}`);
+      await waitForTrackingToFinish();
       process.exit(1);
     }
-    if (isTemporaryFile(filePath)) {
-      removeTemporaryFile(filePath);
-    }
   }
   if (!code && !process.stdin.isTTY) {
     code = await readStdin();
@@ -15657,6 +16214,7 @@ program.command("read-project").description("Read project state for a page").req
     queries = JSON.parse(queriesJson);
   } catch {
     printError("Invalid JSON for --queries");
+    await waitForTrackingToFinish();
     process.exit(1);
   }
   const code = `
@@ -15666,53 +16224,104 @@ program.command("read-project").description("Read project state for a page").req
   await execAndPrint(sessionId, code);
 });
 var session = program.command("session").description("Manage sessions");
-session.command("new <projectUrlOrId>").description("Create a new session and print the session ID").action(async (projectUrlOrId) => {
-  debug("session.new", `starting for ${projectUrlOrId}`);
-  debug("session.new", "resolving credentials + ensuring relay...");
-  const [credentials] = await Promise.all([
-    resolveSessionCredentials(projectUrlOrId),
-    ensureRelayForCli()
-  ]);
-  debug(
-    "session.new",
-    `credentials resolved for project=${credentials.projectId}`
-  );
-  try {
-    debug("session.new", "calling createSession on relay...");
-    const result = await client.createSession.mutate({
-      projectId: credentials.projectId,
-      apiKey: credentials.apiKey
-    });
-    const sessionId = result.id;
-    debug("session.new", `session created id=${sessionId}`);
-    debug("session.new", "fetching project name + refreshing skills...");
-    const [projectName] = await Promise.all([
-      getProjectName(sessionId),
-      refreshSkillsFromSession(sessionId, credentials.projectId)
-    ]);
-    debug("session.new", `project name="${projectName}", skills refreshed`);
-    saveProject({
-      projectId: credentials.projectId,
-      apiKey: credentials.apiKey,
-      name: projectName,
-      lastUsedAt: (/* @__PURE__ */ new Date()).toISOString()
-    });
-    debug("session.new", "project saved, printing session id");
-    print(sessionId);
-    debug("session.new", "done \u2014 process should exit now");
-  } catch (err) {
-    const message = formatError(err);
-    printError(`Failed to create session: ${message}`);
-    if (isAuthError(message)) {
-      clearApiKey(credentials.projectId);
-      printError("The stored API key was invalid and has been removed.");
-      printError(
-        `Please try creating a session again. This will start a browser authentication flow`
+session.command("new <projectUrlOrId>").description("Create a new session and print the session ID").option(
+  "--server-url <url>",
+  "Override the headless server URL for this session"
+).action(
+  async (projectUrlOrId, options) => {
+    const projectId = extractProjectId(projectUrlOrId);
+    let sessionId;
+    let userId;
+    try {
+      debug("session.new", `starting for ${projectUrlOrId}`);
+      const headlessServerUrl = resolveHeadlessServerUrl(
+        projectUrlOrId,
+        options.serverUrl
       );
+      debug("session.new", `headlessServerUrl=${headlessServerUrl}`);
+      debug("session.new", "resolving credentials + ensuring relay...");
+      const [credentials] = await Promise.all([
+        resolveSessionCredentials(projectUrlOrId),
+        ensureRelayForCli({
+          projectId,
+          errorType: "session_new_relay_error"
+        })
+      ]);
+      userId = credentials.userId;
+      debug("session.new", `credentials resolved for project=${projectId}`);
+      debug("session.new", "calling createSession on relay...");
+      const result = await client.createSession.mutate({
+        projectId,
+        apiKey: credentials.apiKey,
+        userId: credentials.userId,
+        headlessServerUrl
+      });
+      sessionId = result.id;
+      debug("session.new", `session created id=${sessionId}`);
+      debug("session.new", "fetching project name + refreshing skills...");
+      const [projectName] = await Promise.all([
+        getProjectName(sessionId),
+        refreshSkillsFromSession(sessionId, projectId)
+      ]);
+      debug("session.new", `project name="${projectName}", skills refreshed`);
+      saveProject({
+        projectId,
+        apiKey: credentials.apiKey,
+        userId: credentials.userId,
+        name: projectName,
+        lastUsedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      debug("session.new", "cleaning up stale artifacts...");
+      const activeSessions = await client.listSessions.query();
+      const activeProjectIds = activeSessions.map(
+        (activeSession) => activeSession.projectId
+      );
+      try {
+        cleanupStaleSkills(activeProjectIds);
+      } catch (error) {
+        printWarning(
+          `Failed to clean up stale skills: ${formatError(error)}`
+        );
+      }
+      const activeSessionIds = activeSessions.map(
+        (activeSession) => activeSession.id
+      );
+      try {
+        cleanupStaleSessionCodeFiles(activeSessionIds);
+      } catch (error) {
+        printWarning(
+          `Failed to clean up stale session code files: ${formatError(error)}`
+        );
+      }
+      debug(
+        "session.new",
+        `finished cleaning up stale artifacts: projects=${activeProjectIds.join(", ")}, sessions=${activeSessionIds.join(", ")}`
+      );
+      debug("session.new", "project saved, printing session id");
+      print(sessionId);
+      printTelemetryNotice();
+      debug("session.new", "done \u2014 process should exit now");
+    } catch (err) {
+      const message = formatError(err);
+      trackError({
+        errorType: "session_new_error",
+        projectId,
+        userId,
+        errorMessage: message
+      });
+      printError(`Failed to create session: ${message}`);
+      if (isAuthError(message)) {
+        clearApiKey(projectId);
+        printError("The stored API key was invalid and has been removed.");
+        printError(
+          `Please try creating a session again. This will start a browser authentication flow`
+        );
+      }
+      await waitForTrackingToFinish();
+      process.exit(1);
     }
-    process.exit(1);
   }
-});
+);
 session.command("list").description("List all active sessions").action(async () => {
   await ensureRelayForCli();
   try {
@@ -15721,32 +16330,76 @@ session.command("list").description("List all active sessions").action(async ()
       print("No active sessions");
       return;
     }
-    printJson(sessions);
+    printJson(
+      sessions.map((session2) => {
+        if (session2.headlessServerUrl !== PROD_HEADLESS_SERVER_URL) {
+          return session2;
+        }
+        return {
+          id: session2.id,
+          projectId: session2.projectId,
+          stateKeys: session2.stateKeys
+        };
+      })
+    );
   } catch (err) {
     printError(`Failed to list sessions: ${formatError(err)}`);
+    await waitForTrackingToFinish();
     process.exit(1);
   }
 });
 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
     }))
   );
 });
 project.command("auth <projectUrlOrId> [apiKey]").description("Authorize and save a project").action(async (projectUrlOrId, apiKey) => {
   const projectId = extractProjectId(projectUrlOrId);
+  const credentials = apiKey ? { apiKey } : await resolveSessionCredentials(projectUrlOrId);
   if (apiKey) {
-    saveProject({ projectId, apiKey });
-  } else {
-    const credentials = await resolveSessionCredentials(projectUrlOrId);
-    saveProject(credentials);
+    trackAuthSuccess({
+      projectId,
+      authMethod: "manual"
+    });
   }
+  saveProject({
+    projectId,
+    apiKey: credentials.apiKey,
+    userId: credentials.userId
+  });
   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 {
@@ -15754,6 +16407,7 @@ session.command("destroy <sessionId>").description("Destroy a session").action(a
     print(`Session ${sessionId} destroyed`);
   } catch (err) {
     printError(`Failed to destroy session: ${formatError(err)}`);
+    await waitForTrackingToFinish();
     process.exit(1);
   }
 });
@@ -15777,23 +16431,38 @@ relay.command("restart").description("Restart the relay server").action(async ()
 });
 program.command("setup").description(
   "Install Framer skills into ~/.agents/skills and ~/.claude/skills"
-).action(() => {
+).action(async () => {
   try {
     const results = installSkills();
     printSetupSummary(results);
+    printTelemetryNotice();
   } catch (err) {
     printError(`Setup failed: ${formatError(err)}`);
+    await waitForTrackingToFinish();
     process.exit(1);
   }
 });
 program.command("docs [queries...]").description(
   "Look up API documentation. Use: docs, docs ClassName, docs Class.method, or docs TypeName"
-).action((queries) => {
+).action(async (queries) => {
   const { lines, errors } = renderDocs(queries);
   for (const line of lines) print(line);
   if (errors.length > 0) {
     for (const error of errors) printError(error);
+    await waitForTrackingToFinish();
     process.exit(1);
   }
 });
+var telemetry = program.command("telemetry").description("Manage telemetry");
+telemetry.command("enable").description("Enable telemetry").action(() => {
+  setTelemetryEnabled(true);
+  print("Telemetry enabled");
+});
+telemetry.command("disable").description("Disable telemetry").action(() => {
+  setTelemetryEnabled(false);
+  print("Telemetry disabled");
+});
+telemetry.command("status").description("Show current telemetry status").action(() => {
+  print(`Telemetry is ${isTelemetryEnabled() ? "enabled" : "disabled"}`);
+});
 program.parse();