refactor: unify element player runtime and harden IIFE workflows

Consolidate delivery/author/print rendering onto a single strategy-driven element player while removing legacy demo-specific hosts. Add per-bundle workspace-fingerprinted IIFE caching and resilient one-server orchestration so long test runs stay stable and incremental runs are faster.

Made-with: Cursor

Author: chillenious

apps/element-demo/package.json

@@ -13,6 +13,8 @@
     "predev": "bun run generate-imports && bun run --cwd ../.. verify:no-local-paths apps/element-demo/src/lib/element-imports.js apps/element-demo/src/lib/element-imports.d.ts",
     "test:e2e": "playwright test",
     "test:e2e:iife": "RUN_IIFE_E2E=1 playwright test iife-usefulness.spec.ts",
+    "test:e2e:iife:suite": "RUN_IIFE_E2E=1 playwright test iife-usefulness.spec.ts smoke-matrix.spec.ts",
+    "test:e2e:iife:suite:orchestrated": "PIE_IIFE_EXTERNAL_SERVER=1 RUN_IIFE_E2E=1 playwright test iife-usefulness.spec.ts smoke-matrix.spec.ts",
     "test:iife:bundle": "bun run scripts/test-iife-bundle-contract.ts",
     "test:e2e:ui": "playwright test --ui",
     "test:e2e:headed": "playwright test --headed",

apps/element-demo/playwright.config.ts

@@ -38,6 +38,7 @@ function resolveLocalBrowsersDir(): string | undefined {
 
 const localBrowsersDir = resolveLocalBrowsersDir();
 const runIifeE2e = process.env.RUN_IIFE_E2E === '1';
+const useExternalServer = process.env.PIE_IIFE_EXTERNAL_SERVER === '1';
 
 function resolveLocalChromium(): string | undefined {
   if (!localBrowsersDir || !existsSync(localBrowsersDir)) {
@@ -103,10 +104,12 @@ export default defineConfig({
       use: { ...devices['Desktop Chrome'] },
     },
   ],
-  webServer: {
-    command: 'bun run dev',
-    url: 'http://localhost:5222',
-    reuseExistingServer: true, // Use existing dev server
-    timeout: 120_000,
-  },
+  webServer: useExternalServer
+    ? undefined
+    : {
+        command: 'bun run dev',
+        url: 'http://localhost:5222',
+        reuseExistingServer: true, // Use existing dev server
+        timeout: 120_000,
+      },
 });

apps/element-demo/scripts/test-iife-bundle-contract.ts

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';
 import { join } from 'node:path';
 import { Bundler, mkDependencyHash, type BuildBundleName } from '@pie-element/bundler-shared';
 import { loadReactElementMatrix } from '../src/lib/testing/react-element-matrix';
+import { createWorkspaceCacheSalt } from '../src/lib/testing/workspace-fingerprint';
 
 interface ContractFailure {
   element: string;
@@ -56,7 +57,7 @@ function assertBundleContract(
 async function main() {
   const workspaceRoot = join(process.cwd(), '..', '..');
   const elementFilter = normalizeElementFilter(process.env.IIFE_ELEMENTS);
-  const clearCache = process.env.IIFE_CLEAR_CACHE !== '0';
+  const clearCache = process.env.IIFE_CLEAR_CACHE === '1';
   const instanceDir = join(process.cwd(), '.cache', 'iife-contract-tests');
   const outputDir = join(instanceDir, 'bundles');
   const cacheDir = join(instanceDir, 'cache');
@@ -86,10 +87,19 @@ async function main() {
     const requestedBundles: BuildBundleName[] = entry.hasAuthor
       ? ['client-player', 'editor']
       : ['client-player'];
-    const hash = mkDependencyHash([dependency]);
+    const baseHash = mkDependencyHash([dependency]);
+    const cacheSalt = createWorkspaceCacheSalt({
+      workspaceRoot,
+      dependencies: [dependency],
+      packageDirs: [entry.packageDir],
+      requestedBundles,
+      resolutionMode: 'workspace-fast',
+      sourceMaps: false,
+      extraFiles: [join('packages', 'shared', 'bundler-shared', 'src', 'index.ts')],
+    });
 
     console.log(
-      `[iife-contract][${entry.name}] building bundles=${requestedBundles.join(',')} hash=${hash}`
+      `[iife-contract][${entry.name}] building bundles=${requestedBundles.join(',')} hash=${baseHash} salt=${cacheSalt.slice(0, 20)}`
     );
 
     const result = await bundler.build({
@@ -99,6 +109,7 @@ async function main() {
         workspaceRoot,
         requestedBundles,
         sourceMaps: false,
+        cacheSalt,
       },
     });
 
@@ -111,6 +122,8 @@ async function main() {
       continue;
     }
 
+    const hash = result.hash;
+
     if (result.cached) {
       cacheHits += 1;
     }