[Blueprints] Import versioned ZIP user content while retaining legacy defaults

[adamziel]

A version-2 Playground ZIP now defines user-owned wp-content: archived files replace the boot defaults, and a missing user file means it was deleted. Legacy runtime artifacts remain owned by the importing Playground through #4141.

Pre-versioned exports remain partial. When one omits a stock plugin, theme, or database directory, import retains the fresh installation's copy. An archived copy still wins when present.

This preserves customized default themes such as BrewCommerce's purple Twenty Twenty-Five background through export, import, and reload without treating stock themes as runtime files.

Testing

Browser coverage imports a pre-versioned partial export, then separately customizes Twenty Twenty-Five, exports it, imports it into a new Playground, reloads, and checks both the theme file and rendered background. The full stack passes 488 Blueprint tests, 347 website tests, both packages' lint and typecheck, and 10 Chromium ZIP-import scenarios.

Stack

1. #4139 — Export complete versioned Playground ZIP snapshots
2. #4141 — Exclude legacy runtime artifacts from site snapshots
3. #4130 — Import versioned ZIP user content while retaining legacy defaults
4. #4131 — Import ZIP contents before initial browser persistence
5. #4132 — Keep ZIP preparation visible until the imported site is ready
6. #4121 — Accept ZIP drops across the page

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Makes versioned Playground ZIP exports “complete” by exporting full user-owned wp-content plus wp-config.php, and updates imports to treat versioned exports as authoritative while preserving Playground runtime-managed files and maintaining legacy behavior for older partial exports.

Changes:

• Replace wpContentFilesExcludedFromExport with playgroundRuntimeWpContentPaths and update export/import call sites.
• Make zipWpContent() always produce a versioned (v2) complete export including wp-config.php and playground-export.json.
• Add/extend automated tests (unit + Playwright) to validate legacy restore behavior and round-trip preservation of default-theme customizations.

Reviewed changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/playground/website/src/github/import-from-github.ts	Switch to runtime-path list and adjust restore behavior for runtime-managed wp-content paths.
packages/playground/website/src/github/github-export-form/form.tsx	Update GitHub export exclusions to use runtime-path list.
packages/playground/website/src/github/github-export-form/form.spec.tsx	Update mocks for renamed exported constant.
packages/playground/website/src/components/toolbar-buttons/download-as-zip.tsx	Update ZIP download to new zipWpContent() signature (always complete).
packages/playground/website/playwright/e2e/opfs.spec.ts	Add e2e coverage for legacy partial import restore and versioned export/import theme customization persistence.
packages/playground/remote-access/src/remote-access-direct-tunnel.ts	Update ZIP export call to new zipWpContent() signature.
packages/playground/personal-wp/src/lib/hooks/use-backup.ts	Update backup ZIP export call to new zipWpContent() signature.
packages/playground/blueprints/src/tests/steps/import-wordpress-files.spec.ts	Add tests asserting format v2 manifest, complete exports, runtime-file retention, and legacy restore behavior.
packages/playground/blueprints/src/lib/utils/wp-content-paths.ts	Introduce runtime-managed path list + legacy omitted-path list.
packages/playground/blueprints/src/lib/utils/wp-content-files-excluded-from-exports.ts	Remove deprecated combined exclusion list.
packages/playground/blueprints/src/lib/steps/zip-wp-content.ts	Make ZIP exports versioned and complete; include wp-config.php; remove exclude-path handling.
packages/playground/blueprints/src/lib/steps/index.ts	Re-export renamed constant from new utility module.
packages/playground/blueprints/src/lib/steps/import-wordpress-files.ts	Preserve runtime-managed paths on import; restore omitted stock paths only for legacy exports.
packages/playground/blueprints/src/index.ts	Re-export renamed constant from new utility module.
packages/playground/blueprints/public/blueprint-v2-schema-validator.js	Regenerate schema validator artifacts.
packages/playground/blueprints/public/blueprint-schema.json	Regenerate schema JSON artifacts.

Comments suppressed due to low confidence (1)

packages/playground/blueprints/src/lib/steps/zip-wp-content.ts:43

• zipWpContent() now zips the entire wp-content tree, which will also include Playground runtime-managed paths (e.g., SQLite integration drop-ins) even though imports explicitly preserve the target runtime’s versions. If those runtime-managed paths are intentionally non-authoritative, consider excluding playgroundRuntimeWpContentPaths during ZIP creation to reduce archive size and avoid shipping potentially incompatible runtime artifacts.

	await runPhpWithZipFunctions(
		playground,
		`zipDir(${js.wpContentPath}, ${js.zipPath}, array(
			'zip_root'      => ${js.documentRoot},
			'additional_paths' => ${js.additionalPaths}
		));`
	);

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.