Files
webstudio/apps/builder/e2e/tests/pages-actions-pages.[shard-2].[shard-5].[shard-6].e2e.ts
T
ff4a081f80 fix: export text pages in static builds (#6513)
Fixes #6440

## Description

Static exports currently omit Text pages such as `/robots.txt`,
`/ads.txt`, and `/.well-known/security.txt`. This generates their
routes, evaluates content through the existing page-data loader, and
uses Vike's native `pageContext.content` to write the exact text at the
configured file path.

Internal route directories are separate from public URLs so dot-prefixed
paths work. No generated writer script, text-page manifest, HTML
wrapper, or post-build file rewrite is needed.

## Dependencies

- Pin Vike to `0.4.267-commit-feffb0f`: native non-HTML output is
published in this commit prerelease but is not yet in stable `0.4.267`.
- Use Vite `7.1.12` and the compatible React plugin for SSG. Build
through `vike build && vike prerender` so Vike uses its matching Vite
dependency.
- Update React Router's `vite-node` dependency to `3.2.4` for
compatibility with the CLI's Vite 7 test environment.

## Validation

- All 1,173 CLI tests pass locally across 72 files, including all 79
prebuild tests for normal HTML, dynamic SSG routes, and React Router
builds.
- Text export coverage checks exact output for `/robots.txt`,
resource-backed `/.well-known/security.txt`, empty text, Unicode, and
HTML-like content.
- CLI and SSG fixture type checks, lint, and formatting pass locally.
- SSG fixtures regenerated; the packaged SSG test passes locally.
- All executed GitHub CI checks pass at
`201fa971616bb607ca35ee24a970f107eddee754`, including all six browser
shards. Shard 4 passed on retry after an MDX template rename timeout.
Visual regression is skipped and preview deployment remains gated.
- Corrected the existing animation navigation test for fork CI: wait for
the rendered component with the public fallback and retain the animation
initialization assertion when the private module is present.

## Manual verification

1. Export a static project with Text pages at `/robots.txt` and
`/.well-known/security.txt`.
2. Run the generated project's build.
3. Confirm both files under `dist/client` contain exactly the configured
text, including resource expressions.
4. Confirm normal pages still render HTML.

- [ ] Original author tested the updated export and confirmed it works.
- [ ] Preview tested (deployment approval remains gated).

---------

Co-authored-by: Sviat Barbutsa <9897782+sviat-barbutsa@users.noreply.github.com>
Co-authored-by: Oleg Isonen <oleg008@gmail.com>
2026-10-12 11:41:04 +02:00

824 lines
24 KiB
TypeScript

import { expect, type Page } from "@playwright/test";
import { expectTextHidden } from "../flows/assertions";
import {
getCanvasFrame,
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 { test, withBrowserContext } from "../test";
import { measure } from "../perf";
import { loadDevBuild, updateBuild } from "../db";
let fixture: SeededContentModeProject;
let pasteFixture: SeededContentModeProject;
test.describe.configure({ mode: "parallel" });
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 getTreeButton = ({ page, itemName }: { page: Page; itemName: string }) =>
page
.locator("[data-tree-button]")
.filter({ has: page.getByText(itemName, { exact: true }) });
const waitForTemplate = async ({
page,
templateName,
}: {
page: Page;
templateName: string;
}) => {
await getTreeButton({ page, itemName: templateName }).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"
| "Mark as draft"
| "Stage for publish";
}) => {
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 getTreeButton({ page, itemName }).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 ({ browser }, workerInfo) => {
const workerSuffix = `worker-${workerInfo.parallelIndex}`;
await withBrowserContext(browser, async (context) => {
fixture = await createContentModeProject({
context,
email: `pages-actions-pages-${workerSuffix}@webstudio.test`,
title: "Pages Actions E2E",
assetNamePrefix: `pages-actions-pages-${workerSuffix}-`,
editorToken: `pages-actions-pages-${workerSuffix}-editor-token`,
builderToken: `pages-actions-pages-${workerSuffix}-builder-token`,
});
pasteFixture = await createContentModeProject({
context,
email: `pages-actions-pages-paste-${workerSuffix}@webstudio.test`,
title: "Pages Actions Paste E2E",
assetNamePrefix: `pages-actions-pages-paste-${workerSuffix}-`,
editorToken: `pages-actions-pages-paste-${workerSuffix}-editor-token`,
builderToken: `pages-actions-pages-paste-${workerSuffix}-builder-token`,
});
});
});
test("Canvas switches away from an AnimateText page without reloading", async ({
browser,
page,
}, workerInfo) => {
const animationFixture = await withBrowserContext(browser, (context) =>
createContentModeProject({
context,
email: `pages-animation-${workerInfo.parallelIndex}@webstudio.test`,
title: "Animated Page Switch E2E",
assetNamePrefix: `pages-animation-${workerInfo.parallelIndex}-`,
editorToken: `pages-animation-${workerInfo.parallelIndex}-editor-token`,
builderToken: `pages-animation-${workerInfo.parallelIndex}-builder-token`,
})
);
const build = await loadDevBuild({ projectId: animationFixture.projectId });
const instances = JSON.parse(build.instances) as Array<{
type: "instance";
id: string;
component: string;
tag?: string;
children: Array<{ type: "id" | "text"; value: string }>;
}>;
const templateRoot = instances.find(
(instance) => instance.id === "content-page-template-root"
);
if (templateRoot === undefined) {
throw new Error("Expected page template root");
}
templateRoot.children.push({ type: "id", value: "animated-children" });
instances.push(
{
type: "instance",
id: "animated-children",
component: "@webstudio-is/sdk-components-animation:AnimateChildren",
children: [{ type: "id", value: "animated-text" }],
},
{
type: "instance",
id: "animated-text",
component: "@webstudio-is/sdk-components-animation:AnimateText",
children: [{ type: "id", value: "animated-inner" }],
},
{
type: "instance",
id: "animated-inner",
component: "ws:element",
tag: "div",
children: [{ type: "id", value: "animated-span" }],
},
{
type: "instance",
id: "animated-span",
component: "ws:element",
tag: "span",
children: [{ type: "text", value: "Animated page text" }],
}
);
await updateBuild(build.id, { instances: JSON.stringify(instances) });
await openProjectBuilder({
page,
projectId: animationFixture.projectId,
authToken: animationFixture.builderToken,
});
await createPageFromTemplate({
page,
templateName: animationFixture.pageTemplateName,
pageName: "Animated Page",
canvasText: "Animated page text",
});
const canvas = await getCanvasFrame(page);
if (canvas === undefined) {
throw new Error("Expected canvas frame");
}
await canvas
.locator(
'[data-ws-component="@webstudio-is/sdk-components-animation:AnimateText"]'
)
.getByText("Animated page text")
.waitFor();
await openPage({
page,
pageName: "Home",
canvasText: animationFixture.shareLinkEditableText,
});
expect(await getCanvasFrame(page)).toBe(canvas);
await openPage({
page,
pageName: "Animated Page",
canvasText: "Animated page text",
});
expect(await getCanvasFrame(page)).toBe(canvas);
});
test("Builder can draft, stage, copy, duplicate, and delete a page from the header menu", async ({
page,
}) => {
const pageName = "Actions Menu Page";
const renamedPageName = "Renamed Actions Menu Page";
const copiedPageName = `${renamedPageName} (1)`;
const duplicatedPageName = `${renamedPageName} (2)`;
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 });
const draftSave = waitForChangeToBeSaved({ page });
await selectHeaderAction({
page,
menuLabel: "Page actions",
action: "Mark as draft",
});
await draftSave;
await waitForPageRow({ page, pageName: `[Draft] ${renamedPageName}` });
await openPageSettings({
page,
pageName: `[Draft] ${renamedPageName}`,
});
await page
.getByText("Stage this page for publish before setting it as the home page")
.waitFor();
const stageSave = waitForChangeToBeSaved({ page });
await selectHeaderAction({
page,
menuLabel: "Page actions",
action: "Stage for publish",
});
await stageSave;
await waitForPageRow({ page, pageName: renamedPageName });
await openPageSettings({ page, pageName: renamedPageName });
await selectHeaderAction({
page,
menuLabel: "Page actions",
action: "Copy",
});
await waitForCopiedPageTransferData({ page });
await pasteFromClipboardShortcut({ page });
await waitForPageRow({ page, pageName: copiedPageName });
const previousCanvas = await getCanvasFrame(page);
if (previousCanvas === undefined) {
throw new Error("Expected canvas before switching pages");
}
// Reproduce a component changing React-owned DOM before page teardown.
await previousCanvas
.getByText(fixture.pageTemplateText, { exact: true })
.first()
.evaluate((element) => element.remove());
await openPage({
page,
pageName: copiedPageName,
canvasText: fixture.pageTemplateText,
});
expect(await getCanvasFrame(page)).toBe(previousCanvas);
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);
});
test("Builder can copy, duplicate, and delete a folder from the context menu", async ({
page,
}) => {
const folderName = "Actions Menu Folder";
const renamedFolderName = "Renamed Actions Menu Folder";
const copiedFolderName = `${renamedFolderName} (1)`;
const duplicatedFolderName = `${renamedFolderName} (2)`;
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 });
const pasteSave = waitForChangeToBeSaved({ page });
await selectContextAction({ page, itemName: "Home", action: "Paste" });
await pasteSave;
await waitForFolderRow({ page, folderName: copiedFolderName });
const duplicateSave = waitForChangeToBeSaved({ page });
await selectContextAction({
page,
itemName: renamedFolderName,
action: "Duplicate",
});
await duplicateSave;
await waitForFolderRow({ page, folderName: duplicatedFolderName });
await selectContextAction({
page,
itemName: duplicatedFolderName,
action: "Delete",
});
const deleteSave = waitForChangeToBeSaved({ page });
await confirmDialogAction({ page, action: "Delete" });
await deleteSave;
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 });
});
test("Builder can copy, duplicate, and delete a page template from actions menus", async ({
page,
}) => {
const templateName = fixture.pageTemplateName;
const renamedTemplateName = "Renamed Content Page Template";
const copiedTemplateName = `${renamedTemplateName} (1)`;
const duplicatedTemplateName = `${renamedTemplateName} (2)`;
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 });
});
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 ({
page,
}) => {
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", "<h2>JSX paste heading</h2>", "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;
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}`
);
}
}
});