mirror of
https://github.com/webstudio-is/webstudio.git
synced 2026-10-23 03:27:27 +09:00
## Summary This update adds new MCP and CLI capabilities for project auditing, structured data, project-specific agent instructions, focused project search, safer bulk editing, image descriptions, font discovery, visual verification, and external registry inspection. ## New Capabilities ### Audit projects - Run a single `audit` command across accessibility, SEO, security, assets, styles, and performance. - Limit an audit to selected scopes, pages, or severity levels. - Receive stable findings with locations and suggested fixes. - Run rendered audits across desktop, mobile, and Builder breakpoint widths. - Detect horizontal overflow, broken images, oversized images, eager below-fold images, render-blocking resources, and legacy font formats. - Identify unused assets, tokens, CSS variables, local styles, and breakpoints. - Identify duplicate token declarations. - Detect accessibility issues involving names, labels, headings, landmarks, IDs, keyboard focus, ARIA, iframes, and autoplaying media. - Detect SEO issues involving titles, descriptions, language, social images, and structured data. - Detect unsafe new-tab links and write resources exposed during page rendering. ### Search an entire project - Search project text, labels, props, resources, assets, and styles through `search-project`. - Find relevant records without downloading and reparsing the full project snapshot. - Scope searches to the relevant project-data areas. ### Add validated JSON-LD - Add structured data with a dedicated JSON-LD component. - Place JSON-LD inside the page Head Slot. - Edit JSON in a purpose-built code editor. - Prevent structurally invalid JSON-LD from being saved. - Validate Schema.org types, properties, and values. - Find invalid, missing, unknown, deprecated, or incompatible structured data through the SEO audit. - Let agents discover the correct JSON-LD workflow without using page custom metadata or a generic HTML embed. ### Configure project-specific agent instructions - Add AI-agent instructions from the new **Agents** section in Project Settings. - Synchronize those instructions into a managed root `AGENTS.md`. - Update or remove the managed file automatically during project sync. - Protect existing user-owned `AGENTS.md` files from being overwritten. - Share the instructions with authenticated CLI and MCP agents. - Keep agent instructions out of publicly readable production bundles. ### Generate and manage image descriptions - Audit image assets for missing descriptions. - Let a vision-capable agent inspect each image in its rendered context. - Save generated descriptions to multiple image assets in one operation. - Mark images as intentionally decorative. - Reuse the saved asset description wherever the image is used. - Re-run the audit to verify that missing-description findings are resolved. ### Perform bounded bulk replacements - Replace matching literal text across selected pages with `replace-text`. - Replace matching fixed prop text with `replace-prop-text`. - Replace matching resource names or URLs with `replace-resource-text`. - Restrict replacements by page, instance, prop, resource, field, match mode, and maximum change count. - Leave dynamic expressions unchanged. ### Inspect element ancestry - Return an element’s direct parent in instance listings. - Request the complete ancestor chain when inspecting an element. - Understand tree placement without rebuilding the instance hierarchy from raw project data. ### Discover available fonts - List uploaded font families through `list-fonts`. - Discover available system font stacks. - Inspect font family, style, weight, format, and associated asset information before applying typography. ### Inspect external component registries - Inspect a local or remote shadcn-style registry item. - Read its description, files, dependencies, targets, and documentation. - Receive an explicit Webstudio compatibility report. - Inspect registry metadata without installing or executing external code. ### Capture generated project routes directly - Run `webstudio screenshot --path /route` against the configured project. - Generate a temporary production-style preview automatically. - Capture the requested route. - Stop the temporary preview after capture. - Avoid manually building and starting a preview for a single screenshot. ### Assert visual changes - Add expected text to screenshot comparisons. - Set maximum pixel mismatch limits. - Set minimum or maximum changed-region counts. - Assert whether overall brightness or a color channel moved in the expected direction. - Use these assertions as pass/fail evidence for visual changes. ### Require compatible CLI versions - Send the project-bundle contract version with CLI synchronization requests. - Stop incompatible CLI versions before they receive incomplete project data. - Tell users exactly how to update the CLI or run the latest version once. - Prevent older clients from silently dropping project settings. ## Upgrade Note This branch introduces a new synchronized project-bundle contract. Older CLI versions must update before synchronizing against the new API. ```sh npm install -g webstudio@latest ``` Or run the latest version once: ```sh npx webstudio@latest <command> ``` --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
693 lines
20 KiB
TypeScript
693 lines
20 KiB
TypeScript
import type { Page } from "playwright";
|
|
import { expectTextHidden } from "../flows/assertions";
|
|
import { openProjectBuilder, waitForCanvasText } from "../flows/builder";
|
|
import { expectGeneratedAppBuild } from "../flows/generated-app";
|
|
import {
|
|
createFolder,
|
|
createPageFromTemplate,
|
|
openFolderSettings,
|
|
openPage,
|
|
openPageSettings,
|
|
openPagesPanel,
|
|
openTemplateSettings,
|
|
} from "../flows/pages-panel";
|
|
import {
|
|
waitForChangeToBeSaved,
|
|
waitForSyncStatus,
|
|
} from "../flows/sync-status";
|
|
import { createContentModeProject } from "../fixtures/content-mode-suite";
|
|
import type { SeededContentModeProject } from "../fixtures/content-mode-project";
|
|
import { newIsolatedPage, test } from "../harness";
|
|
import { measure } from "../perf";
|
|
import { loadDevBuild } from "../db";
|
|
|
|
let fixture: SeededContentModeProject;
|
|
let pasteFixture: SeededContentModeProject;
|
|
|
|
const copiedPageTransferMarker = "@webstudio/page/v0.1";
|
|
|
|
const getPageRow = ({ page, pageName }: { page: Page; pageName: string }) =>
|
|
page.getByRole("group", { name: `Page ${pageName}`, exact: true });
|
|
|
|
const waitForPageRow = async ({
|
|
page,
|
|
pageName,
|
|
}: {
|
|
page: Page;
|
|
pageName: string;
|
|
}) => {
|
|
await getPageRow({ page, pageName }).waitFor();
|
|
};
|
|
|
|
const expectPageRowHidden = async ({
|
|
page,
|
|
pageName,
|
|
}: {
|
|
page: Page;
|
|
pageName: string;
|
|
}) => {
|
|
await getPageRow({ page, pageName }).waitFor({ state: "hidden" });
|
|
};
|
|
|
|
const waitForFolderRow = async ({
|
|
page,
|
|
folderName,
|
|
}: {
|
|
page: Page;
|
|
folderName: string;
|
|
}) => {
|
|
await page
|
|
.getByRole("group", { name: `Folder ${folderName}`, exact: true })
|
|
.waitFor();
|
|
};
|
|
|
|
const waitForTemplate = async ({
|
|
page,
|
|
templateName,
|
|
}: {
|
|
page: Page;
|
|
templateName: string;
|
|
}) => {
|
|
await page.getByText(templateName, { exact: true }).first().waitFor();
|
|
};
|
|
|
|
const waitForCopiedPageTransferData = async ({ page }: { page: Page }) => {
|
|
await page.waitForFunction(async (marker) => {
|
|
try {
|
|
return (await navigator.clipboard.readText()).includes(marker as string);
|
|
} catch {
|
|
return false;
|
|
}
|
|
}, copiedPageTransferMarker);
|
|
};
|
|
|
|
const getDataResourceCounts = async (fixture: SeededContentModeProject) => {
|
|
const build = await loadDevBuild({ projectId: fixture.projectId });
|
|
const dataSources = JSON.parse(build.dataSources) as Array<{
|
|
type: string;
|
|
name: string;
|
|
value?: { value?: unknown };
|
|
}>;
|
|
const resources = JSON.parse(build.resources) as Array<{
|
|
name: string;
|
|
control?: string;
|
|
}>;
|
|
|
|
return {
|
|
staticVariables: dataSources.filter(
|
|
(dataSource) =>
|
|
dataSource.name === fixture.dataResourceStaticVariableName &&
|
|
dataSource.value?.value ===
|
|
fixture.dataResourceStaticVariableVisibleValue
|
|
).length,
|
|
httpVariables: dataSources.filter(
|
|
(dataSource) =>
|
|
dataSource.type === "resource" &&
|
|
dataSource.name === fixture.dataResourceHttpVariableName
|
|
).length,
|
|
graphqlVariables: dataSources.filter(
|
|
(dataSource) =>
|
|
dataSource.type === "resource" &&
|
|
dataSource.name === fixture.dataResourceGraphqlVariableName
|
|
).length,
|
|
systemVariables: dataSources.filter(
|
|
(dataSource) =>
|
|
dataSource.type === "resource" &&
|
|
dataSource.name === fixture.dataResourceSystemVariableName
|
|
).length,
|
|
httpResources: resources.filter(
|
|
(resource) =>
|
|
resource.name === fixture.dataResourceHttpResourceLabel &&
|
|
resource.control === undefined
|
|
).length,
|
|
graphqlResources: resources.filter(
|
|
(resource) =>
|
|
resource.name === fixture.dataResourceGraphqlResourceLabel &&
|
|
resource.control === "graphql"
|
|
).length,
|
|
systemResources: resources.filter(
|
|
(resource) =>
|
|
resource.name === fixture.dataResourceSystemResourceLabel &&
|
|
resource.control === "system"
|
|
).length,
|
|
};
|
|
};
|
|
|
|
const expectDataResourceCopies = async (
|
|
fixture: SeededContentModeProject,
|
|
before: Awaited<ReturnType<typeof getDataResourceCounts>>
|
|
) => {
|
|
const after = await getDataResourceCounts(fixture);
|
|
const entries = Object.entries(after) as Array<[keyof typeof after, number]>;
|
|
for (const [key, count] of entries) {
|
|
if (count <= before[key]) {
|
|
throw new Error(
|
|
`Expected page template to copy ${key}; before ${before[key]}, after ${count}`
|
|
);
|
|
}
|
|
}
|
|
};
|
|
|
|
const selectHeaderAction = async ({
|
|
page,
|
|
menuLabel,
|
|
action,
|
|
}: {
|
|
page: Page;
|
|
menuLabel: string;
|
|
action: "Copy" | "Duplicate" | "Delete";
|
|
}) => {
|
|
await page.getByRole("button", { name: menuLabel }).click();
|
|
await page.getByRole("menuitem", { name: action }).click();
|
|
};
|
|
|
|
const selectContextAction = async ({
|
|
page,
|
|
itemName,
|
|
action,
|
|
}: {
|
|
page: Page;
|
|
itemName: string;
|
|
action: "Paste" | "Copy" | "Duplicate" | "Delete";
|
|
}) => {
|
|
await page.getByText(itemName, { exact: true }).first().click({
|
|
button: "right",
|
|
});
|
|
await page.getByRole("menuitem", { name: action }).click();
|
|
};
|
|
|
|
const pasteFromClipboardShortcut = async ({ page }: { page: Page }) => {
|
|
await page.keyboard.press("ControlOrMeta+V");
|
|
await waitForSyncStatus({ page, status: "idle" });
|
|
};
|
|
|
|
const confirmDialogAction = async ({
|
|
page,
|
|
action,
|
|
}: {
|
|
page: Page;
|
|
action: string;
|
|
}) => {
|
|
const button = page.getByRole("button", { name: action });
|
|
await button.click();
|
|
await button.waitFor({ state: "hidden" });
|
|
};
|
|
|
|
test.beforeAll(async () => {
|
|
fixture = await createContentModeProject({
|
|
email: "pages-actions-e2e@webstudio.test",
|
|
title: "Pages Actions E2E",
|
|
assetNamePrefix: "pages-actions-",
|
|
editorToken: "pages-actions-e2e-editor-token",
|
|
builderToken: "pages-actions-e2e-builder-token",
|
|
});
|
|
pasteFixture = await createContentModeProject({
|
|
email: "pages-actions-paste-e2e@webstudio.test",
|
|
title: "Pages Actions Paste E2E",
|
|
assetNamePrefix: "pages-actions-paste-",
|
|
editorToken: "pages-actions-paste-e2e-editor-token",
|
|
builderToken: "pages-actions-paste-e2e-builder-token",
|
|
});
|
|
});
|
|
|
|
test("Builder can copy, duplicate, and delete a page from the header menu", async () => {
|
|
const { page, close } = await newIsolatedPage();
|
|
const pageName = "Actions Menu Page";
|
|
const renamedPageName = "Renamed Actions Menu Page";
|
|
const copiedPageName = `${renamedPageName} (1)`;
|
|
const duplicatedPageName = `${renamedPageName} (2)`;
|
|
|
|
try {
|
|
await measure("pages actions open builder for page actions", async () => {
|
|
await openProjectBuilder({
|
|
page,
|
|
projectId: fixture.projectId,
|
|
authToken: fixture.builderToken,
|
|
});
|
|
});
|
|
const dataResourceCountsBefore = await getDataResourceCounts(fixture);
|
|
|
|
await createPageFromTemplate({
|
|
page,
|
|
templateName: fixture.pageTemplateName,
|
|
pageName,
|
|
canvasText: fixture.pageTemplateText,
|
|
});
|
|
await waitForCanvasText({
|
|
page,
|
|
text: fixture.dataResourceStaticVariableVisibleValue,
|
|
});
|
|
await waitForCanvasText({
|
|
page,
|
|
text: "HTTP resource variable configured",
|
|
});
|
|
await waitForCanvasText({
|
|
page,
|
|
text: "GraphQL resource variable configured",
|
|
});
|
|
await waitForCanvasText({ page, text: "2026" });
|
|
await expectDataResourceCopies(fixture, dataResourceCountsBefore);
|
|
await measure(
|
|
"pages actions generated app build for copied resources",
|
|
async () => {
|
|
await expectGeneratedAppBuild({ projectId: fixture.projectId });
|
|
}
|
|
);
|
|
|
|
await openPageSettings({ page, pageName });
|
|
const renameSave = waitForChangeToBeSaved({ page });
|
|
await page.getByLabel("Page name", { exact: true }).fill(renamedPageName);
|
|
await page.getByLabel("Page name", { exact: true }).blur();
|
|
await renameSave;
|
|
await waitForPageRow({ page, pageName: renamedPageName });
|
|
await expectPageRowHidden({ page, pageName });
|
|
|
|
await openPageSettings({ page, pageName: renamedPageName });
|
|
await selectHeaderAction({
|
|
page,
|
|
menuLabel: "Page actions",
|
|
action: "Copy",
|
|
});
|
|
await waitForCopiedPageTransferData({ page });
|
|
await pasteFromClipboardShortcut({ page });
|
|
await waitForPageRow({ page, pageName: copiedPageName });
|
|
|
|
await openPage({
|
|
page,
|
|
pageName: copiedPageName,
|
|
canvasText: fixture.pageTemplateText,
|
|
});
|
|
|
|
await openPageSettings({ page, pageName: renamedPageName });
|
|
await selectHeaderAction({
|
|
page,
|
|
menuLabel: "Page actions",
|
|
action: "Duplicate",
|
|
});
|
|
await waitForPageRow({ page, pageName: duplicatedPageName });
|
|
|
|
await openPageSettings({ page, pageName: duplicatedPageName });
|
|
await selectHeaderAction({
|
|
page,
|
|
menuLabel: "Page actions",
|
|
action: "Delete",
|
|
});
|
|
const deleteSave = waitForChangeToBeSaved({ page });
|
|
await confirmDialogAction({ page, action: "Delete Page" });
|
|
await deleteSave;
|
|
await waitForSyncStatus({ page, status: "idle" });
|
|
await expectPageRowHidden({ page, pageName: duplicatedPageName });
|
|
|
|
await measure(
|
|
"pages actions reload for page action persistence",
|
|
async () => {
|
|
await openProjectBuilder({
|
|
page,
|
|
projectId: fixture.projectId,
|
|
authToken: fixture.builderToken,
|
|
});
|
|
}
|
|
);
|
|
await openPagesPanel({ page });
|
|
await waitForPageRow({ page, pageName: renamedPageName });
|
|
await expectPageRowHidden({ page, pageName });
|
|
await waitForPageRow({ page, pageName: copiedPageName });
|
|
await expectPageRowHidden({ page, pageName: duplicatedPageName });
|
|
await openPage({
|
|
page,
|
|
pageName: renamedPageName,
|
|
canvasText: fixture.pageTemplateText,
|
|
});
|
|
await waitForCanvasText({
|
|
page,
|
|
text: fixture.dataResourceStaticVariableVisibleValue,
|
|
});
|
|
await waitForCanvasText({
|
|
page,
|
|
text: "HTTP resource variable configured",
|
|
});
|
|
await waitForCanvasText({
|
|
page,
|
|
text: "GraphQL resource variable configured",
|
|
});
|
|
await waitForCanvasText({ page, text: "2026" });
|
|
await expectDataResourceCopies(fixture, dataResourceCountsBefore);
|
|
} finally {
|
|
await close();
|
|
}
|
|
});
|
|
|
|
test("Builder can copy, duplicate, and delete a folder from the context menu", async () => {
|
|
const { page, close } = await newIsolatedPage();
|
|
const folderName = "Actions Menu Folder";
|
|
const renamedFolderName = "Renamed Actions Menu Folder";
|
|
const copiedFolderName = `${renamedFolderName} (1)`;
|
|
const duplicatedFolderName = `${renamedFolderName} (2)`;
|
|
|
|
try {
|
|
await measure("pages actions open builder for folder actions", async () => {
|
|
await openProjectBuilder({
|
|
page,
|
|
projectId: fixture.projectId,
|
|
authToken: fixture.builderToken,
|
|
});
|
|
});
|
|
|
|
await createFolder({ page, folderName });
|
|
|
|
await openFolderSettings({ page, folderName });
|
|
const renameSave = waitForChangeToBeSaved({ page });
|
|
await page
|
|
.getByLabel("Folder name", { exact: true })
|
|
.fill(renamedFolderName);
|
|
await page.getByLabel("Folder name", { exact: true }).blur();
|
|
await renameSave;
|
|
await waitForFolderRow({ page, folderName: renamedFolderName });
|
|
await expectTextHidden({ page, text: folderName });
|
|
|
|
await selectContextAction({
|
|
page,
|
|
itemName: renamedFolderName,
|
|
action: "Copy",
|
|
});
|
|
await waitForCopiedPageTransferData({ page });
|
|
await selectContextAction({ page, itemName: "Home", action: "Paste" });
|
|
await waitForSyncStatus({ page, status: "idle" });
|
|
await waitForFolderRow({ page, folderName: copiedFolderName });
|
|
|
|
await selectContextAction({
|
|
page,
|
|
itemName: renamedFolderName,
|
|
action: "Duplicate",
|
|
});
|
|
await waitForFolderRow({ page, folderName: duplicatedFolderName });
|
|
|
|
await selectContextAction({
|
|
page,
|
|
itemName: duplicatedFolderName,
|
|
action: "Delete",
|
|
});
|
|
await confirmDialogAction({ page, action: "Delete" });
|
|
await expectTextHidden({ page, text: duplicatedFolderName });
|
|
|
|
await measure(
|
|
"pages actions reload for folder action persistence",
|
|
async () => {
|
|
await openProjectBuilder({
|
|
page,
|
|
projectId: fixture.projectId,
|
|
authToken: fixture.builderToken,
|
|
});
|
|
}
|
|
);
|
|
await openPagesPanel({ page });
|
|
await waitForFolderRow({ page, folderName: renamedFolderName });
|
|
await expectTextHidden({ page, text: folderName });
|
|
await waitForFolderRow({ page, folderName: copiedFolderName });
|
|
await openFolderSettings({ page, folderName: copiedFolderName });
|
|
await expectTextHidden({ page, text: duplicatedFolderName });
|
|
} finally {
|
|
await close();
|
|
}
|
|
});
|
|
|
|
test("Builder can copy, duplicate, and delete a page template from actions menus", async () => {
|
|
const { page, close } = await newIsolatedPage();
|
|
const templateName = fixture.pageTemplateName;
|
|
const renamedTemplateName = "Renamed Content Page Template";
|
|
const copiedTemplateName = `${renamedTemplateName} (1)`;
|
|
const duplicatedTemplateName = `${renamedTemplateName} (2)`;
|
|
|
|
try {
|
|
await measure(
|
|
"pages actions open builder for template actions",
|
|
async () => {
|
|
await openProjectBuilder({
|
|
page,
|
|
projectId: fixture.projectId,
|
|
authToken: fixture.builderToken,
|
|
});
|
|
}
|
|
);
|
|
await openPagesPanel({ page });
|
|
|
|
await openTemplateSettings({ page, templateName });
|
|
const renameSave = waitForChangeToBeSaved({ page });
|
|
await page
|
|
.getByLabel("Template name", { exact: true })
|
|
.fill(renamedTemplateName);
|
|
await page.getByLabel("Template name", { exact: true }).blur();
|
|
await renameSave;
|
|
await waitForTemplate({ page, templateName: renamedTemplateName });
|
|
|
|
await openTemplateSettings({ page, templateName: renamedTemplateName });
|
|
await selectHeaderAction({
|
|
page,
|
|
menuLabel: "Template actions",
|
|
action: "Copy",
|
|
});
|
|
await waitForCopiedPageTransferData({ page });
|
|
await pasteFromClipboardShortcut({ page });
|
|
await waitForTemplate({ page, templateName: copiedTemplateName });
|
|
|
|
await openTemplateSettings({ page, templateName: renamedTemplateName });
|
|
await selectHeaderAction({
|
|
page,
|
|
menuLabel: "Template actions",
|
|
action: "Duplicate",
|
|
});
|
|
await waitForTemplate({ page, templateName: duplicatedTemplateName });
|
|
|
|
await selectContextAction({
|
|
page,
|
|
itemName: duplicatedTemplateName,
|
|
action: "Delete",
|
|
});
|
|
const deleteSave = waitForChangeToBeSaved({ page });
|
|
await confirmDialogAction({ page, action: "Delete Template" });
|
|
await deleteSave;
|
|
await expectTextHidden({ page, text: duplicatedTemplateName });
|
|
|
|
await measure(
|
|
"pages actions reload for template action persistence",
|
|
async () => {
|
|
await openProjectBuilder({
|
|
page,
|
|
projectId: fixture.projectId,
|
|
authToken: fixture.builderToken,
|
|
});
|
|
}
|
|
);
|
|
await openPagesPanel({ page });
|
|
await waitForTemplate({ page, templateName: renamedTemplateName });
|
|
await waitForTemplate({ page, templateName: copiedTemplateName });
|
|
await expectTextHidden({ page, text: duplicatedTemplateName });
|
|
} finally {
|
|
await close();
|
|
}
|
|
});
|
|
|
|
const createInstanceTransfer = ({ id, text }: { id: string; text: string }) =>
|
|
JSON.stringify({
|
|
"@webstudio/instance/v0.1": {
|
|
instanceSelector: [id, "source-body"],
|
|
children: [{ type: "id", value: id }],
|
|
instances: [
|
|
{
|
|
type: "instance",
|
|
id,
|
|
component: "ws:element",
|
|
tag: "p",
|
|
children: [{ type: "text", value: text }],
|
|
},
|
|
],
|
|
assets: [],
|
|
dataSources: [],
|
|
resources: [],
|
|
props: [],
|
|
breakpoints: [],
|
|
styleSourceSelections: [],
|
|
styleSources: [],
|
|
styles: [],
|
|
},
|
|
});
|
|
|
|
const selectPasteBody = async ({ page }: { page: Page }) => {
|
|
const navigatorTab = page.getByRole("tab", { name: "Navigator" });
|
|
if ((await navigatorTab.getAttribute("aria-selected")) !== "true") {
|
|
await navigatorTab.click();
|
|
}
|
|
const body = page
|
|
.locator("[data-navigator-tree] [data-tree-button]")
|
|
.filter({ hasText: "Body" })
|
|
.last();
|
|
await body.dblclick();
|
|
};
|
|
|
|
const pasteClipboardData = async ({
|
|
page,
|
|
data,
|
|
}: {
|
|
page: Page;
|
|
data: Record<string, string>;
|
|
}) => {
|
|
const save = waitForChangeToBeSaved({ page });
|
|
await page.evaluate((data) => {
|
|
const clipboardData = new DataTransfer();
|
|
for (const [mimeType, value] of Object.entries(data)) {
|
|
clipboardData.setData(mimeType, value);
|
|
}
|
|
document.dispatchEvent(
|
|
new ClipboardEvent("paste", {
|
|
bubbles: true,
|
|
cancelable: true,
|
|
clipboardData,
|
|
})
|
|
);
|
|
}, data);
|
|
await save;
|
|
await waitForSyncStatus({ page, status: "idle" });
|
|
};
|
|
|
|
const countPastedElements = async ({
|
|
tag,
|
|
text,
|
|
}: {
|
|
tag: string;
|
|
text: string;
|
|
}) => {
|
|
const build = await loadDevBuild({ projectId: pasteFixture.projectId });
|
|
const instances = JSON.parse(build.instances) as Array<{
|
|
component?: string;
|
|
tag?: string;
|
|
children?: Array<{ type: string; value?: string }>;
|
|
}>;
|
|
return instances.filter(
|
|
(instance) =>
|
|
instance.component === "ws:element" &&
|
|
instance.tag === tag &&
|
|
instance.children?.some(
|
|
(child) => child.type === "text" && child.value?.includes(text)
|
|
)
|
|
).length;
|
|
};
|
|
|
|
const countBuildInstancesWithText = async (text: string) => {
|
|
const build = await loadDevBuild({ projectId: pasteFixture.projectId });
|
|
const instances = JSON.parse(build.instances) as Array<{
|
|
id: string;
|
|
children?: Array<{ type: string; value?: string }>;
|
|
}>;
|
|
const instancesById = new Map(
|
|
instances.map((instance) => [instance.id, instance])
|
|
);
|
|
const containsText = (instanceId: string): boolean => {
|
|
const instance = instancesById.get(instanceId);
|
|
return (
|
|
instance?.children?.some(
|
|
(child) =>
|
|
(child.type === "text" && child.value?.includes(text)) ||
|
|
(child.type === "id" &&
|
|
child.value !== undefined &&
|
|
containsText(child.value))
|
|
) ?? false
|
|
);
|
|
};
|
|
return instances.filter((instance) => containsText(instance.id)).length;
|
|
};
|
|
|
|
test("Builder runs paste plugins through generic browser paste events", async () => {
|
|
const { page, close } = await newIsolatedPage();
|
|
const entries = [
|
|
[
|
|
"application/json",
|
|
createInstanceTransfer({
|
|
id: "paste-json",
|
|
text: "Instance JSON paste heading",
|
|
}),
|
|
"Instance JSON paste heading",
|
|
"p",
|
|
],
|
|
[
|
|
"text/plain",
|
|
createInstanceTransfer({
|
|
id: "paste-text",
|
|
text: "Instance text paste heading",
|
|
}),
|
|
"Instance text paste heading",
|
|
"p",
|
|
],
|
|
[
|
|
"text/plain",
|
|
'<ws.element ws:tag="h2">JSX paste heading</ws.element>',
|
|
"JSX paste heading",
|
|
"h2",
|
|
],
|
|
[
|
|
"text/plain",
|
|
"<section><h2>HTML paste heading</h2></section>",
|
|
"HTML paste heading",
|
|
"h2",
|
|
],
|
|
["text/plain", "## Markdown paste heading", "Markdown paste heading", "h2"],
|
|
[
|
|
"application/json",
|
|
JSON.stringify({
|
|
type: "@webflow/XscpData",
|
|
payload: {
|
|
nodes: [
|
|
{
|
|
_id: "webflow-heading",
|
|
type: "Heading",
|
|
tag: "h1",
|
|
children: ["webflow-heading-text"],
|
|
classes: [],
|
|
},
|
|
{
|
|
_id: "webflow-heading-text",
|
|
v: "Webflow paste heading",
|
|
text: true,
|
|
},
|
|
],
|
|
styles: [],
|
|
assets: [],
|
|
},
|
|
}),
|
|
"Webflow paste heading",
|
|
undefined,
|
|
],
|
|
] as const;
|
|
|
|
try {
|
|
await openProjectBuilder({
|
|
page,
|
|
projectId: pasteFixture.projectId,
|
|
authToken: pasteFixture.builderToken,
|
|
});
|
|
await waitForCanvasText({ page, text: "Initial content" });
|
|
|
|
for (const [mimeType, value, text, tag] of entries) {
|
|
await selectPasteBody({ page });
|
|
await pasteClipboardData({ page, data: { [mimeType]: value } });
|
|
await waitForCanvasText({ page, text });
|
|
if (tag === undefined) {
|
|
const count = await countBuildInstancesWithText(text);
|
|
if (count === 0) {
|
|
throw new Error(
|
|
`Expected generic Webflow paste to persist ${JSON.stringify(text)}`
|
|
);
|
|
}
|
|
continue;
|
|
}
|
|
const count = await countPastedElements({ tag, text });
|
|
if (count !== 1) {
|
|
throw new Error(
|
|
`Expected one ${tag} containing ${JSON.stringify(text)}, found ${count}`
|
|
);
|
|
}
|
|
}
|
|
} finally {
|
|
await close();
|
|
}
|
|
});
|