refactor: rename bundler-shared to element-bundler with compatibility shim

Clarify the IIFE-only scope of the bundler package and migrate internal consumers to the new package name while preserving backward compatibility for existing bundler-shared imports.

Made-with: Cursor

Author: chillenious

apps/element-demo/CHANGELOG.md

@@ -6,4 +6,4 @@
 
 - Updated dependencies [e131840]
   - @pie-element/element-player@0.1.1
-  - @pie-element/bundler-shared@0.1.1
+  - @pie-element/element-bundler@0.1.1

apps/element-demo/DEPENDENCIES.md

@@ -8,7 +8,7 @@ The demo app is designed to work with PIE elements loaded as ESM web components.
 
 Only two packages are needed at runtime:
 
-- `@pie-element/bundler-shared` - Bundler infrastructure for IIFE operation
+- `@pie-element/element-bundler` - Bundler infrastructure for IIFE operation
 - `@pie-element/element-player` - Web component that loads and renders elements
 
 ### Why so minimal?
@@ -85,4 +85,4 @@ Currently the demo only supports local development mode. To support production C
 3. Configure CDN URL (e.g., `https://esm.sh` or `https://unpkg.com`)
 4. All element dependencies resolve automatically through CDN
 
-At that point, only `@pie-element/element-player` would be needed as a runtime dependency (bundler-shared is only for IIFE mode).
+At that point, only `@pie-element/element-player` would be needed as a runtime dependency (`@pie-element/element-bundler` is only for IIFE mode).

apps/element-demo/DEV_BUNDLER.md

@@ -7,6 +7,9 @@ The element demo supports both player modes:
 
 When `player=iife`, bundling is local-only.
 
+The local IIFE path uses `@pie-element/element-bundler`.
+ESM mode does not require `@pie-element/element-bundler`.
+
 ## dev:demo
 
 Use the CLI command:
@@ -108,4 +111,3 @@ Source maps policy:
    - keep parity versions as control
    - upgrade in a branch/canary path
    - compare build success, output behavior, and runtime compatibility across representative element sets
-

apps/element-demo/package.json

@@ -21,7 +21,7 @@
     "test:e2e:debug": "playwright test --debug"
   },
   "dependencies": {
-    "@pie-element/bundler-shared": "workspace:*",
+    "@pie-element/element-bundler": "workspace:*",
     "@pie-element/element-theme-daisyui": "workspace:*",
     "@pie-element/element-player": "workspace:*",
     "@tiptap/core": "3.18.0",

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

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';
 import { join } from 'node:path';
-import { Bundler, mkDependencyHash, type BuildBundleName } from '@pie-element/bundler-shared';
+import { Bundler, mkDependencyHash, type BuildBundleName } from '@pie-element/element-bundler';
 import { loadReactElementMatrix } from '../src/lib/testing/react-element-matrix';
 import { createWorkspaceCacheSalt } from '../src/lib/testing/workspace-fingerprint';
 

apps/element-demo/src/routes/api/bundle/+server.ts

@@ -6,11 +6,11 @@
 
 import { json } from '@sveltejs/kit';
 import type { RequestHandler } from './$types';
-import { Bundler } from '@pie-element/bundler-shared';
-import type { BuildBundleName } from '@pie-element/bundler-shared';
+import { Bundler } from '@pie-element/element-bundler';
+import type { BuildBundleName } from '@pie-element/element-bundler';
 import { join } from 'node:path';
 import { mkdirSync, rmSync, existsSync, writeFileSync } from 'node:fs';
-import { mkBundleCacheKey } from '@pie-element/bundler-shared';
+import { mkBundleCacheKey } from '@pie-element/element-bundler';
 import { createOrJoinBuild, emitBuildEvent, getBuildSnapshot } from './build-state';
 import { createWorkspaceCacheSaltForDependencies } from '$lib/testing/workspace-fingerprint';
 

apps/element-demo/src/routes/api/bundle/build-state.ts

@@ -3,7 +3,7 @@ import type {
   BuildRequest,
   BuildResult,
   BuildStage,
-} from '@pie-element/bundler-shared';
+} from '@pie-element/element-bundler';
 
 export interface BuildSnapshot {
   buildId: string;

bun.lock

@@ -8,13 +8,13 @@ This bundler service creates IIFE (Immediately Invoked Function Expression) bund
 
 ## Architecture
 
-```
+```text
 ┌─────────────────────────────────────────────────────────┐
 │                  pie-elements-ng                        │
 ├─────────────────────────────────────────────────────────┤
 │                                                         │
 │  ┌──────────────────────────────────────────────────┐  │
-│  │  @pie-element/bundler-shared                     │  │
+│  │  @pie-element/element-bundler                    │  │
 │  │  (Framework-agnostic bundler)                    │  │
 │  │                                                   │  │
 │  │  • Webpack 5 configuration                       │  │
@@ -50,7 +50,8 @@ This bundler service creates IIFE (Immediately Invoked Function Expression) bund
 ## Created Files
 
 ### Core Bundler Package
-- `packages/shared/bundler-shared/package.json` - Package configuration
+
+- `packages/shared/bundler-shared/package.json` - Package configuration for `@pie-element/element-bundler`
 - `packages/shared/bundler-shared/src/index.ts` - Main Bundler class
 - `packages/shared/bundler-shared/src/types.ts` - TypeScript types
 - `packages/shared/bundler-shared/src/installer.ts` - Package installer
@@ -61,6 +62,7 @@ This bundler service creates IIFE (Immediately Invoked Function Expression) bund
 - `packages/shared/bundler-shared/README.md` - Documentation
 
 ### SvelteKit Integration
+
 - `apps/element-demo/src/routes/api/bundle/+server.ts` - API endpoint
 - `apps/element-demo/src/routes/bundler/+page.svelte` - Test UI
 
@@ -74,11 +76,12 @@ bun run dev
 
 ### 2. Navigate to the Bundler UI
 
-Open http://localhost:5173/bundler
+Open [http://localhost:5173/bundler](http://localhost:5173/bundler)
 
 ### 3. Build a Bundle
 
 Enter an element name and version:
+
 - Element: `@pie-element/multiple-choice`
 - Version: `0.1.0`
 
@@ -87,6 +90,7 @@ Click "Build Bundle" and wait for the build to complete (~30-60 seconds).
 ### 4. Use the Bundle
 
 The bundles will be available at:
+
 - Player: `/bundles/{hash}/player.js`
 - Client Player: `/bundles/{hash}/client-player.js`
 - Editor: `/bundles/{hash}/editor.js`
@@ -108,6 +112,7 @@ Load them in your HTML:
 Build a bundle from dependencies.
 
 **Request:**
+
 ```json
 {
   "dependencies": [
@@ -120,6 +125,7 @@ Build a bundle from dependencies.
 ```
 
 **Response:**
+
 ```json
 {
   "success": true,
@@ -139,6 +145,7 @@ Build a bundle from dependencies.
 Check if a bundle exists.
 
 **Response:**
+
 ```json
 {
   "exists": true,
@@ -148,7 +155,7 @@ Check if a bundle exists.
     "editor": "/bundles/1234567890/editor.js"
   }
 }
-```
+```text
 
 ## How It Works
 
@@ -165,7 +172,7 @@ Check if a bundle exists.
 
 The bundler handles different versions of `@pie-lib` packages per element:
 
-```
+```text
 Element A uses @pie-lib/math-rendering@4.0.0
 Element B uses @pie-lib/math-rendering@4.1.0
 ```
@@ -175,20 +182,22 @@ The `NormalModuleReplacementPlugin` detects which element is importing and resol
 ## Benefits
 
 ### vs pie-api-aws Bundler
+
 - ✅ **Self-contained** - No Lambda, Temporal, SNS, or CloudWatch
 - ✅ **Open source** - Fully available in this repo
 - ✅ **Testable** - Easy to test locally
 - ✅ **Simpler** - ~600 lines vs ~5000 lines
 - ✅ **Framework agnostic** - Can be used in any Node.js environment
 
 ### vs Pre-publishing IIFE Bundles
+
 - ✅ **On-demand** - Build only what's needed
 - ✅ **Flexible** - Combine any elements and versions
 - ✅ **Space efficient** - Don't store all combinations
 
 ## Reusability
 
-The `@pie-element/bundler-shared` package is framework-agnostic and can be used in:
+The `@pie-element/element-bundler` package is framework-agnostic and can be used in:
 
 - ✅ SvelteKit (current implementation)
 - ✅ Express/Fastify/Hono
@@ -200,7 +209,7 @@ Example with Express:
 
 ```typescript
 import express from 'express';
-import { Bundler } from '@pie-element/bundler-shared';
+import { Bundler } from '@pie-element/element-bundler';
 
 const app = express();
 const bundler = new Bundler('./public/bundles');
@@ -224,8 +233,8 @@ Potential additions:
 
 ## Comparison with Upstream
 
-| Feature | pie-api-aws | bundler-shared |
-|---------|-------------|----------------|
+| Feature | pie-api-aws | element-bundler |
+| -------- | ----------- | ---------------- |
 | **Bundler** | Webpack 5 | Webpack 5 ✓ |
 | **Version resolution** | NormalModuleReplacementPlugin | Same ✓ |
 | **Entry generation** | code-generator.ts | Simplified ✓ |
@@ -237,6 +246,11 @@ Potential additions:
 | **Complexity** | ~5000 lines | ~600 lines |
 | **Open source** | No (private repo) | Yes ✓ |
 
+## Scope Clarification
+
+- `@pie-element/element-bundler` currently produces IIFE bundles for the local IIFE runtime path.
+- ESM bundle workflows do not require this package.
+
 ## License
 
 MIT

docs/BUNDLER_SERVICE.md

@@ -0,0 +1,7 @@
+# @pie-element/bundler-shared
+
+## 0.1.1
+
+### Patch Changes
+
+- Deprecated package name. This package now re-exports from `@pie-element/element-bundler`.