PIE-605: enforce dist-only publish surfaces in pie-elements-ng

Author: chillenious

docs/PUBLISHING.md

@@ -60,7 +60,16 @@ For each selected package, any local workspace dependency from `dependencies` or
 
 This prevents publishing an element whose npm install later fails in the PIE builder because a workspace dependency was never published. If the preflight fails, add the missing package to `--packages` or publish that dependency first.
 
-When a selected target is a Svelte element package under `packages/elements-svelte`, the same publish command also checks the package surface before publishing. It rejects Svelte runtime dependencies leaking to hosts, source-path exports, `src` in the packed tarball, test artifacts in the packed tarball, real Svelte imports in built JS, and runtime `customElements.define(...)` calls.
+All publishable packages use a dist-only public API. Package `exports`, `main`, `module`, `types`, CDN fields, and packed source-bearing files must resolve to generated `dist` artifacts only. Raw source (`src`, root `.ts`/`.tsx`, `.svelte`, `.svelte.ts`, and `development` conditions that point at source) is not a supported package API.
+
+Debuggability comes from generated sourcemaps, not from importable source files. TypeScript builds must emit sourcemaps with inline source content, and package validation rejects `.js.map` files that require unpacked source files to be present in the npm tarball.
+
+The shared publish command used by CI and local targeted publishes runs:
+
+- `bun run check:publish-surface`
+- `bun run check:sourcemaps`
+
+These checks reject source-path exports, `src` in packed tarballs, raw Svelte/TypeScript package surfaces, missing sourcemap source content, and stale generated maps.
 
 ## Dist-Tag Backfill Runbook
 

package.json

@@ -48,13 +48,14 @@
     "test:iife:e2e:orchestrated": "bun run --cwd apps/element-demo test:e2e:iife:suite:orchestrated",
     "test:iife:once-server": "node scripts/run-iife-suite.mjs",
     "lint": "biome check . && node scripts/verify-no-svelte-custom-element-tag.mjs",
+    "lint:all": "bun run lint && bun run check:publish-surface && bun run check:sourcemaps",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
     "changeset": "changeset",
     "changeset:plan": "node ./scripts/create-package-changeset.mjs",
     "version": "changeset version",
     "release": "bun run release:publish",
-    "release:publish": "bun run build && bun run verify:runtime-support && bun run cli verify:controllers && node ./scripts/changeset-publish-resolved-workspaces.mjs",
+    "release:publish": "bun run build && bun run verify:runtime-support && bun run cli verify:controllers && bun run check:publish-surface && bun run check:sourcemaps && node ./scripts/changeset-publish-resolved-workspaces.mjs",
     "release:manual": "bun run release:publish",
     "release:publish:packages": "node ./scripts/release-publish-selective.mjs",
     "release:publish:packages:env-token": "sh ./scripts/publish-with-env-token.sh",
@@ -87,6 +88,8 @@
     "verify:no-local-paths": "node scripts/check-no-local-paths.mjs",
     "verify:svelte-custom-element-tags": "node scripts/verify-no-svelte-custom-element-tag.mjs",
     "verify:runtime-support": "node scripts/verify-runtime-support-exports.mjs",
+    "check:publish-surface": "bun ./scripts/check-publish-surface.mjs",
+    "check:sourcemaps": "bun ./scripts/check-sourcemap-sources.mjs",
     "verify:dependency-integrity": "bun run cli verify:dependency-integrity",
     "evals": "turbo run test:evals",
     "evals:ui": "turbo run test:evals:ui",

packages/core/package.json

@@ -15,7 +15,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc",
     "dev": "tsc --watch",
     "test": "vitest run",
     "test:watch": "vitest",

packages/element-theme-daisyui/package.json

@@ -8,7 +8,6 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "development": "./src/index.ts",
       "default": "./dist/pie-element-theme-daisyui.js"
     }
   },

packages/element-theme/package.json

@@ -8,7 +8,6 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "development": "./src/index.ts",
       "default": "./dist/pie-element-theme.js"
     }
   },

packages/elements-react/categorize/package.json

@@ -30,22 +30,22 @@
   },
   "exports": {
     ".": {
-      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
     "./delivery": {
-      "development": "./src/delivery/index.ts",
       "types": "./dist/delivery/index.d.ts",
       "default": "./dist/delivery/index.js"
     },
     "./author": {
-      "development": "./src/author/index.ts",
       "types": "./dist/author/index.d.ts",
       "default": "./dist/author/index.js"
     },
     "./controller": {
-      "development": "./src/controller/index.ts",
+      "types": "./dist/controller/index.d.ts",
+      "default": "./dist/controller/index.js"
+    },
+    "./controller.js": {
       "types": "./dist/controller/index.d.ts",
       "default": "./dist/controller/index.js"
     }
@@ -54,8 +54,7 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "sideEffects": false,
   "devDependencies": {

packages/elements-react/charting/package.json

@@ -26,22 +26,22 @@
   },
   "exports": {
     ".": {
-      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
     "./delivery": {
-      "development": "./src/delivery/index.ts",
       "types": "./dist/delivery/index.d.ts",
       "default": "./dist/delivery/index.js"
     },
     "./author": {
-      "development": "./src/author/index.ts",
       "types": "./dist/author/index.d.ts",
       "default": "./dist/author/index.js"
     },
     "./controller": {
-      "development": "./src/controller/index.ts",
+      "types": "./dist/controller/index.d.ts",
+      "default": "./dist/controller/index.js"
+    },
+    "./controller.js": {
       "types": "./dist/controller/index.d.ts",
       "default": "./dist/controller/index.js"
     }
@@ -50,8 +50,7 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "sideEffects": false,
   "devDependencies": {

packages/elements-react/complex-rubric/package.json

@@ -25,27 +25,26 @@
   },
   "exports": {
     ".": {
-      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
     "./delivery": {
-      "development": "./src/delivery/index.ts",
       "types": "./dist/delivery/index.d.ts",
       "default": "./dist/delivery/index.js"
     },
     "./author": {
-      "development": "./src/author/index.ts",
       "types": "./dist/author/index.d.ts",
       "default": "./dist/author/index.js"
     },
     "./controller": {
-      "development": "./src/controller/index.ts",
+      "types": "./dist/controller/index.d.ts",
+      "default": "./dist/controller/index.js"
+    },
+    "./controller.js": {
       "types": "./dist/controller/index.d.ts",
       "default": "./dist/controller/index.js"
     },
     "./print": {
-      "development": "./src/print/index.ts",
       "types": "./dist/print/index.d.ts",
       "default": "./dist/print/index.js"
     }
@@ -54,8 +53,7 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "sideEffects": false,
   "devDependencies": {

packages/elements-react/drag-in-the-blank/package.json

@@ -28,22 +28,22 @@
   },
   "exports": {
     ".": {
-      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
     "./delivery": {
-      "development": "./src/delivery/index.ts",
       "types": "./dist/delivery/index.d.ts",
       "default": "./dist/delivery/index.js"
     },
     "./author": {
-      "development": "./src/author/index.tsx",
       "types": "./dist/author/index.d.ts",
       "default": "./dist/author/index.js"
     },
     "./controller": {
-      "development": "./src/controller/index.ts",
+      "types": "./dist/controller/index.d.ts",
+      "default": "./dist/controller/index.js"
+    },
+    "./controller.js": {
       "types": "./dist/controller/index.d.ts",
       "default": "./dist/controller/index.js"
     }
@@ -52,8 +52,7 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "sideEffects": false,
   "devDependencies": {

packages/elements-react/drawing-response/package.json

@@ -28,22 +28,22 @@
   },
   "exports": {
     ".": {
-      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
     "./delivery": {
-      "development": "./src/delivery/index.ts",
       "types": "./dist/delivery/index.d.ts",
       "default": "./dist/delivery/index.js"
     },
     "./author": {
-      "development": "./src/author/index.ts",
       "types": "./dist/author/index.d.ts",
       "default": "./dist/author/index.js"
     },
     "./controller": {
-      "development": "./src/controller/index.ts",
+      "types": "./dist/controller/index.d.ts",
+      "default": "./dist/controller/index.js"
+    },
+    "./controller.js": {
       "types": "./dist/controller/index.d.ts",
       "default": "./dist/controller/index.js"
     }
@@ -52,8 +52,7 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "sideEffects": false,
   "devDependencies": {