generator-white-label 8.0.0 → 9.0.0

package/CLI.md

@@ -7,7 +7,7 @@ CLI ──────> createProject() ──────> project
 Node API ─┘
 ```
 
-`createProject()` owns the scaffold. The CLI translates command-line input into that API.
+`createProject()` owns the scaffold, including destination safety. The CLI translates command-line input into that API.
 
 ## Create a project
 
@@ -25,7 +25,7 @@ yarn dlx generator-white-label create my-project
 pnpm dlx generator-white-label create my-project
 ```
 
-The CLI creates into a new or existing **empty** directory. It refuses a non-empty destination so a mistyped path cannot overwrite existing project files.
+Project creation accepts a missing or existing **empty** directory. A non-empty destination is rejected before scaffold files are copied or written.
 
 Then install and test the generated project with npm, Yarn, or pnpm:
 
@@ -52,7 +52,7 @@ npx generator-white-label create my-project --no-jsx
 
 The same `--jsx` and `--no-jsx` flags work through `yarn dlx` and `pnpm dlx`.
 
-If no choice can be asked interactively and neither flag is supplied, JSX remains the default for backward compatibility.
+If no choice can be asked interactively and neither flag is supplied, JSX is the default.
 
 Run `white-label --help` for usage. See [`PACKAGE_MANAGERS.md`](PACKAGE_MANAGERS.md) for package-manager compatibility details.
 
@@ -69,13 +69,13 @@ await createProject({
 
 Set `jsx: true` for JSX/TSX templates or `jsx: false` for plain TypeScript and HTML strings. Use `jsx: false` as the starting point when another template engine should own rendering. Omitting `jsx` defaults to `true`.
 
-`createProject()` is the lower-level programmatic API and does not apply the CLI's non-empty-directory guard. Applications using it directly own destination-policy decisions.
+`createProject()` uses the same destination-safety rule as the CLI: missing and empty directories are allowed; non-empty directories are rejected before project content is written.
 
 ## Read the implementation
 
 The source is intentionally small enough to teach the design:
 
-- `scaffold/index.ts` — project creation
+- `scaffold/index.ts` — project creation and destination-safety boundary
 - `cli/index.ts` — command-line adapter
 - `test/` — executable contracts
 

package/README.md

@@ -60,6 +60,32 @@ DOM
 
 Both generated variants provide the same application behavior and progressive enhancement. The only difference is template syntax.
 
+## A simple View click event
+
+Use View lifecycle hooks to add and remove browser listeners with the same callback reference:
+
+```ts
+import View from 'white-label-view';
+
+class ButtonView extends View {
+    handleClick = () => {
+        console.log('Clicked');
+    };
+
+    addListeners() {
+        this.element.addEventListener('click', this.handleClick);
+        return this;
+    }
+
+    removeListeners() {
+        this.element.removeEventListener('click', this.handleClick);
+        return this;
+    }
+}
+```
+
+`addListeners()` runs when the View mounts. `removeListeners()` runs before replacement or destruction, so the listener lifecycle stays owned by the View.
+
 ## Read the source
 
 For the default JSX scaffold, a useful reading order is:
@@ -140,7 +166,9 @@ npx generator-white-label create my-project --no-jsx
 
 The same `--jsx` and `--no-jsx` options work through `yarn dlx` and `pnpm dlx`.
 
-If no interactive answer is available and neither flag is supplied, JSX is the default for backward compatibility.
+If no interactive answer is available and neither flag is supplied, JSX is the default.
+
+The generator refuses to layer a scaffold over an existing non-empty destination. This protection is enforced by the shared `createProject()` engine, so it applies to both the CLI and programmatic use. An existing empty directory is allowed; a missing directory is created as part of generation.
 
 See [`CLI.md`](CLI.md) for the CLI contract and [`PACKAGE_MANAGERS.md`](PACKAGE_MANAGERS.md) for package-manager compatibility details.
 
@@ -160,9 +188,9 @@ await createProject({
 
 Set `jsx: true` for JSX/TSX templates or `jsx: false` for plain TypeScript and HTML strings. Use `jsx: false` as the starting point for a third-party template engine. Omitting `jsx` defaults to `true`.
 
-`createProject(options)` returns `Promise<void>`. A successful call resolves with `undefined`; file-system failures reject the promise instead of returning a status value.
+`createProject(options)` returns `Promise<void>`. A successful call resolves with `undefined`; file-system failures reject the promise instead of returning a status value. If the destination already exists and contains files, it rejects before copying or writing project content.
 
-`createProject()` is the canonical creation API. The CLI and future integrations are adapters around it rather than separate generation systems.
+`createProject()` is the canonical creation API. The CLI and future integrations are adapters around it rather than separate generation systems. Keeping overwrite policy here prevents adapters from accidentally bypassing the same safety boundary.
 
 This is the same design principle used throughout White Label: one responsibility, one implementation, explicit adapters at environment boundaries.
 
@@ -170,7 +198,7 @@ This is the same design principle used throughout White Label: one responsibilit
 
 | Path | Purpose |
 | --- | --- |
-| `scaffold/index.ts` | Canonical `createProject()` implementation |
+| `scaffold/index.ts` | Canonical `createProject()` implementation and destination-safety boundary |
 | `scaffold/no-jsx/` | Plain-TypeScript template equivalents |
 | `cli/index.ts` | First-party command-line adapter |
 | `app/*.tsx` | Default JSX top-level static pages |
@@ -208,7 +236,7 @@ With `--no-jsx`, the equivalent page is ordinary TypeScript returning an HTML st
 
 For larger pages, compose focused views instead of growing one renderer indefinitely.
 
-JSX expressions are escaped by default. In plain-TypeScript templates or third-party engines, applications own the engine's escaping and raw-output configuration. See [Template engines and JSX options](https://whitelabeljs.org/docs/view/#template-engines) for the tested matrix and trust boundaries.
+White Label JSX HTML-escapes ordinary child text and ordinary attribute values by default, rejects intrinsic `on*` event-handler attributes, and uses runtime-owned identity for trusted JSX/raw values. That escaping is not a general-purpose sanitizer for URL or CSS semantics. Plain-TypeScript templates and third-party engines likewise remain responsible for their own contextual escaping, sanitization, raw-output features, and configuration. See [Template engines and JSX options](https://whitelabeljs.org/docs/view/#template-engines) for the tested matrix and trust boundaries.
 
 ## Progressive enhancement
 
@@ -231,7 +259,7 @@ Cloud-specific adapters should stay at the boundary. Translate an AWS/Vercel/Net
 
 Generated-project tests exercise sequential warm invocations, concurrent requests, request-data escaping, execution without browser globals, and a browser/Web-target bundle smoke test. They also enforce a 100 kB minified serverless-composition bundle budget and a 750 ms fresh-process handler-import budget. These are regression guards, not universal latency guarantees.
 
-The Web-target bundle smoke test catches unresolved Node built-ins, but it does **not** claim blanket Cloudflare/Deno/edge-provider compatibility. The published runtime packages still document Node as their supported server runtime; verify a specific edge provider before deployment.
+The Web-target bundle smoke test catches unresolved Node built-ins, but it does **not** claim blanket Cloudflare/Deno/edge-provider compatibility. The published runtime packages document Node as their supported server runtime; verify a specific edge provider before deployment.
 
 ## Build and verify
 
@@ -263,7 +291,7 @@ npm run audit
 npm pack --dry-run
 ```
 
-Tests are part of the documentation. They demonstrate intended contracts while protecting behavior. Executable project source is held to 100% statement, branch, function, and line coverage.
+Tests are part of the documentation. They demonstrate intended contracts while protecting behavior. Executable project source is held to 100% statement, branch, function, and line coverage. CI also checks the documented Node 22.18 minimum, the primary Node 24 line, packed CLI/programmatic API installation, and generated-project compatibility across npm, Yarn, and pnpm.
 
 ## White Label ecosystem
 
@@ -272,4 +300,4 @@ Tests are part of the documentation. They demonstrate intended contracts while p
 - [`white-label-mediator`](https://github.com/bshack/white-label-mediator) — application events.
 - [`white-label-router`](https://github.com/bshack/white-label-router) — routing and URL state.
 
-The generated project imports the real packages rather than reproducing their behavior locally. That makes it both an example and an ecosystem integration test.
+The generated project imports the real packages rather than reproducing their behavior locally. That makes it both an example and an ecosystem integration test.

package/app/README.md

@@ -48,6 +48,32 @@ The build output is `_deploy`. The test suite checks the starter content, progre
 
 Pages live in `app/*.tsx`, page data lives in `app/assets/data/view`, browser code lives in `app/assets/script`, the provider-neutral serverless example lives in `server/handler.ts`, and shared styles live in `app/assets/style`. TypeScript is configured with `jsx: react-jsx` and `jsxImportSource: white-label-view`, so this scaffold's JSX does not require React.
 
+## Simple View click event
+
+View lifecycle hooks are the simplest place to own a browser listener:
+
+```ts
+import View from 'white-label-view';
+
+class ButtonView extends View {
+    handleClick = () => {
+        console.log('Clicked');
+    };
+
+    addListeners() {
+        this.element.addEventListener('click', this.handleClick);
+        return this;
+    }
+
+    removeListeners() {
+        this.element.removeEventListener('click', this.handleClick);
+        return this;
+    }
+}
+```
+
+The same callback reference is used for both registration and cleanup. View calls `removeListeners()` before replacement or destruction.
+
 ## Serverless / function runtimes
 
 `server/handler.ts` demonstrates a cloud-agnostic server function using the Web `Request` and `Response` APIs. It composes a request-scoped Mediator, Model, Router, and server View, then destroys those mutable instances before the invocation completes.

package/app/assets/script/tasks/TaskApplication.ts

@@ -32,25 +32,25 @@ export function initializeTaskApplication(documentRoot: Document): TaskApplicati
     const status = parentElement.querySelector<HTMLElement>('[data-task-status]')!;
     const updateStatus = (): void => {status.textContent = describeTaskStatus(model.get());};
 
-    const addTask = (title: string): void => {model.add(title); updateStatus();};
-    const toggleTask = (id: number): void => {model.toggle(id); updateStatus();};
-    const setFilter = (filter: 'all' | 'active' | 'completed'): void => {model.setFilter(filter); updateStatus();};
-    mediator.on('task:add', addTask);
-    mediator.on('task:toggle', toggleTask);
-    mediator.on('task:filter', setFilter);
+    const addTask = (event: CustomEvent<string>): void => {model.add(event.detail); updateStatus();};
+    const toggleTask = (event: CustomEvent<number>): void => {model.toggle(event.detail); updateStatus();};
+    const setFilter = (event: CustomEvent<'all' | 'active' | 'completed'>): void => {model.setFilter(event.detail); updateStatus();};
+    mediator.addEventListener('task:add', addTask);
+    mediator.addEventListener('task:toggle', toggleTask);
+    mediator.addEventListener('task:filter', setFilter);
 
     const delegated = view.delegate(parentElement);
     delegated.on('submit', '[data-task-form]', (event: Event) => {
         event.preventDefault();
         const form = event.target as HTMLFormElement;
         const input = form.querySelector<HTMLInputElement>('[name="task"]')!;
-        mediator.emit('task:add', input.value);
+        mediator.dispatchEvent(new CustomEvent('task:add', {detail: input.value}));
         parentElement.querySelector<HTMLInputElement>('[name="task"]')!.focus();
     });
     delegated.on('change', '[data-task-toggle]', (event: Event) => {
         const input = event.target as HTMLInputElement;
         const id = Number(input.dataset.taskId);
-        mediator.emit('task:toggle', id);
+        mediator.dispatchEvent(new CustomEvent('task:toggle', {detail: id}));
         const focusTarget = parentElement.querySelector<HTMLInputElement>(`[data-task-id="${id}"]`)
             ?? parentElement.querySelector<HTMLAnchorElement>('[data-task-filter][aria-current="page"]')!;
         focusTarget.focus();
@@ -66,9 +66,9 @@ export function initializeTaskApplication(documentRoot: Document): TaskApplicati
         destroy() {
             delegated.clear();
             router.destroy();
-            mediator.removeListener('task:add', addTask);
-            mediator.removeListener('task:toggle', toggleTask);
-            mediator.removeListener('task:filter', setFilter);
+            mediator.removeEventListener('task:add', addTask);
+            mediator.removeEventListener('task:toggle', toggleTask);
+            mediator.removeEventListener('task:filter', setFilter);
             view.destroy();
             model.destroy();
             mediator.destroy();

package/app/assets/script/tasks/TaskMediator.ts

@@ -1,20 +1,15 @@
 import Mediator from 'white-label-mediator';
 import type {TaskFilter} from '../../view/examples/tasks/task-state.js';
 
-/**
- * Document the event protocol in one place even though the currently installed
- * Mediator exposes the EventEmitter-compatible runtime without a generic map.
- * Keeping names and payloads explicit still gives learners one clear contract
- * to follow when tracing the example.
- */
+/** Application event vocabulary shared by the generated task modules. */
 export type TaskEvents = {
-    'task:add': [title: string];
-    'task:filter': [filter: TaskFilter];
-    'task:toggle': [id: number];
+    'task:add': string;
+    'task:filter': TaskFilter;
+    'task:toggle': number;
 };
 
-export type TaskMediator = Mediator;
+export type TaskMediator = Mediator<TaskEvents>;
 
 export function createTaskMediator(): TaskMediator {
-    return new Mediator().initialize();
+    return new Mediator<TaskEvents>().initialize();
 }

package/app/assets/script/tasks/TaskRouter.ts

@@ -22,7 +22,7 @@ export function createTaskRouter(documentRoot: Document, mediator: TaskMediator)
     const route = (_scope: Element | null, location: {data: {query: Record<string, string>}}): void => {
         const filter = normalizeTaskFilter(location.data.query.tasks);
         const restoreFocus = documentRoot.activeElement?.hasAttribute('data-task-filter') === true;
-        mediator.emit('task:filter', filter);
+        mediator.dispatchEvent(new CustomEvent('task:filter', {detail: filter}));
         if (restoreFocus) {documentRoot.querySelector<HTMLAnchorElement>(`[data-task-filter="${filter}"]`)!.focus();}
     };
     router.routes = {'/': route, defaultRoute: route};

package/app/assets/view/sections/PackageDocsSection.tsx

@@ -28,7 +28,7 @@ export default function PackageDocsSection() {
                         <p className="eyebrow">Model</p><h3>State is observable, not magical.</h3>
                         <CodeBlock lines={[
                             <><span className={syntax.keyword}>const</span> model = <span className={syntax.keyword}>new</span> <span className={syntax.type}>Model</span>({'{'}count: 0{'}'});</>,
-                            <>model.on(<span className={syntax.value}>'change'</span>, state =&gt; render(state));</>,
+                            <>model.addEventListener(<span className={syntax.value}>'change'</span>, event =&gt; render(event.detail));</>,
                             <>model.update({'{'}count: 1{'}'});</>
                         ]} />
                         <p><a href={repositories.model}>Model documentation</a></p>
@@ -46,8 +46,8 @@ export default function PackageDocsSection() {
                     <article>
                         <p className="eyebrow">Mediator</p><h3>Modules communicate through events.</h3>
                         <CodeBlock lines={[
-                            <>mediator.on(<span className={syntax.value}>'counter:increment'</span>, increment);</>,
-                            <>mediator.emit(<span className={syntax.value}>'counter:increment'</span>);</>
+                            <>mediator.addEventListener(<span className={syntax.value}>'counter:increment'</span>, increment);</>,
+                            <>mediator.dispatchEvent(<span className={syntax.keyword}>new</span> <span className={syntax.type}>CustomEvent</span>(<span className={syntax.value}>'counter:increment'</span>));</>
                         ]} />
                         <p><a href={repositories.mediator}>Mediator documentation</a></p>
                     </article>
@@ -56,7 +56,7 @@ export default function PackageDocsSection() {
                         <CodeBlock lines={[
                             <>router.routes = {'{'}</>,
                             <>  <span className={syntax.value}>'/'</span>: (_scope, location) =&gt; {'{'}</>,
-                            <>    mediator.emit(<span className={syntax.value}>'filter:set'</span>, location.data.query.filter);</>,
+                            <>    mediator.dispatchEvent(<span className={syntax.keyword}>new</span> <span className={syntax.type}>CustomEvent</span>(<span className={syntax.value}>'filter:set'</span>, {'{'}detail: location.data.query.filter{'}'}));</>,
                             <>  {'}'}</>,
                             <>{'}'};</>
                         ]} />

package/cli/index.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import {realpathSync} from 'node:fs';
 import {readdir} from 'node:fs/promises';
 import path from 'node:path';
 import process from 'node:process';
@@ -106,7 +107,7 @@ export async function runCli(args: readonly string[], dependencies: CliDependenc
 
 const invokedPath = path.resolve(process.argv[1] as string);
 const modulePath = fileURLToPath(import.meta.url);
-if (invokedPath === modulePath) {
+if (realpathSync(invokedPath) === realpathSync(modulePath)) {
     runCli(process.argv.slice(2)).then(
         (exitCode) => {process.exitCode = exitCode;},
         (error: unknown) => {

package/dist/app/assets/script/tasks/TaskApplication.js

@@ -20,24 +20,24 @@ export function initializeTaskApplication(documentRoot) {
     const view = createTaskView(parentElement, model);
     const status = parentElement.querySelector('[data-task-status]');
     const updateStatus = () => { status.textContent = describeTaskStatus(model.get()); };
-    const addTask = (title) => { model.add(title); updateStatus(); };
-    const toggleTask = (id) => { model.toggle(id); updateStatus(); };
-    const setFilter = (filter) => { model.setFilter(filter); updateStatus(); };
-    mediator.on('task:add', addTask);
-    mediator.on('task:toggle', toggleTask);
-    mediator.on('task:filter', setFilter);
+    const addTask = (event) => { model.add(event.detail); updateStatus(); };
+    const toggleTask = (event) => { model.toggle(event.detail); updateStatus(); };
+    const setFilter = (event) => { model.setFilter(event.detail); updateStatus(); };
+    mediator.addEventListener('task:add', addTask);
+    mediator.addEventListener('task:toggle', toggleTask);
+    mediator.addEventListener('task:filter', setFilter);
     const delegated = view.delegate(parentElement);
     delegated.on('submit', '[data-task-form]', (event) => {
         event.preventDefault();
         const form = event.target;
         const input = form.querySelector('[name="task"]');
-        mediator.emit('task:add', input.value);
+        mediator.dispatchEvent(new CustomEvent('task:add', { detail: input.value }));
         parentElement.querySelector('[name="task"]').focus();
     });
     delegated.on('change', '[data-task-toggle]', (event) => {
         const input = event.target;
         const id = Number(input.dataset.taskId);
-        mediator.emit('task:toggle', id);
+        mediator.dispatchEvent(new CustomEvent('task:toggle', { detail: id }));
         const focusTarget = parentElement.querySelector(`[data-task-id="${id}"]`)
             ?? parentElement.querySelector('[data-task-filter][aria-current="page"]');
         focusTarget.focus();
@@ -51,9 +51,9 @@ export function initializeTaskApplication(documentRoot) {
         destroy() {
             delegated.clear();
             router.destroy();
-            mediator.removeListener('task:add', addTask);
-            mediator.removeListener('task:toggle', toggleTask);
-            mediator.removeListener('task:filter', setFilter);
+            mediator.removeEventListener('task:add', addTask);
+            mediator.removeEventListener('task:toggle', toggleTask);
+            mediator.removeEventListener('task:filter', setFilter);
             view.destroy();
             model.destroy();
             mediator.destroy();

package/dist/app/assets/script/tasks/TaskApplication.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskApplication.js","sourceRoot":"","sources":["../../../../../app/assets/script/tasks/TaskApplication.ts"],"names":[],"mappings":"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","sourcesContent":["import type Router from 'white-label-router';\nimport type View from 'white-label-view';\nimport {createInitialTaskState, describeTaskStatus} from '../../view/examples/tasks/task-state.js';\nimport {createTaskMediator, type TaskMediator} from './TaskMediator.js';\nimport TaskModel from './TaskModel.js';\nimport {createTaskRouter} from './TaskRouter.js';\nimport {createTaskView} from './TaskView.js';\n\n/** Public handles make the example straightforward to test and tear down. */\nexport interface TaskApplication {\n    mediator: TaskMediator;\n    model: TaskModel;\n    router: Router;\n    view: View;\n    destroy(): void;\n}\n\n/**\n * Compose the application at one explicit boundary.\n *\n * This is the only module that knows every moving part. Model, View, Router,\n * and Mediator stay independently understandable, while this file documents\n * the small amount of wiring needed to make them cooperate in a real feature.\n */\nexport function initializeTaskApplication(documentRoot: Document): TaskApplication {\n    const parentElement = documentRoot.querySelector<HTMLElement>('[data-task-example]');\n    if (!parentElement) {throw new TypeError('White Label task example requires a data-task-example container');}\n\n    const mediator = createTaskMediator();\n    const model = new TaskModel(createInitialTaskState());\n    const view = createTaskView(parentElement, model);\n    const status = parentElement.querySelector<HTMLElement>('[data-task-status]')!;\n    const updateStatus = (): void => {status.textContent = describeTaskStatus(model.get());};\n\n    const addTask = (title: string): void => {model.add(title); updateStatus();};\n    const toggleTask = (id: number): void => {model.toggle(id); updateStatus();};\n    const setFilter = (filter: 'all' | 'active' | 'completed'): void => {model.setFilter(filter); updateStatus();};\n    mediator.on('task:add', addTask);\n    mediator.on('task:toggle', toggleTask);\n    mediator.on('task:filter', setFilter);\n\n    const delegated = view.delegate(parentElement);\n    delegated.on('submit', '[data-task-form]', (event: Event) => {\n        event.preventDefault();\n        const form = event.target as HTMLFormElement;\n        const input = form.querySelector<HTMLInputElement>('[name=\"task\"]')!;\n        mediator.emit('task:add', input.value);\n        parentElement.querySelector<HTMLInputElement>('[name=\"task\"]')!.focus();\n    });\n    delegated.on('change', '[data-task-toggle]', (event: Event) => {\n        const input = event.target as HTMLInputElement;\n        const id = Number(input.dataset.taskId);\n        mediator.emit('task:toggle', id);\n        const focusTarget = parentElement.querySelector<HTMLInputElement>(`[data-task-id=\"${id}\"]`)\n            ?? parentElement.querySelector<HTMLAnchorElement>('[data-task-filter][aria-current=\"page\"]')!;\n        focusTarget.focus();\n    });\n\n    const router = createTaskRouter(documentRoot, mediator);\n\n    return {\n        mediator,\n        model,\n        router,\n        view,\n        destroy() {\n            delegated.clear();\n            router.destroy();\n            mediator.removeListener('task:add', addTask);\n            mediator.removeListener('task:toggle', toggleTask);\n            mediator.removeListener('task:filter', setFilter);\n            view.destroy();\n            model.destroy();\n            mediator.destroy();\n        }\n    };\n}\n"]}
+{"version":3,"file":"TaskApplication.js","sourceRoot":"","sources":["../../../../../app/assets/script/tasks/TaskApplication.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,sBAAsB,EAAE,kBAAkB,EAAC,MAAM,yCAAyC,CAAC;AACnG,OAAO,EAAC,kBAAkB,EAAoB,MAAM,mBAAmB,CAAC;AACxE,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAC,cAAc,EAAC,MAAM,eAAe,CAAC;AAW7C;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,YAAsB;IAC5D,MAAM,aAAa,GAAG,YAAY,CAAC,aAAa,CAAc,qBAAqB,CAAC,CAAC;IACrF,IAAI,CAAC,aAAa,EAAE,CAAC;QAAA,MAAM,IAAI,SAAS,CAAC,iEAAiE,CAAC,CAAC;IAAA,CAAC;IAE7G,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,cAAc,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,aAAa,CAAC,aAAa,CAAc,oBAAoB,CAAE,CAAC;IAC/E,MAAM,YAAY,GAAG,GAAS,EAAE,GAAE,MAAM,CAAC,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA,CAAC,CAAC;IAEzF,MAAM,OAAO,GAAG,CAAC,KAA0B,EAAQ,EAAE,GAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAA,CAAC,CAAC;IACjG,MAAM,UAAU,GAAG,CAAC,KAA0B,EAAQ,EAAE,GAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAA,CAAC,CAAC;IACvG,MAAM,SAAS,GAAG,CAAC,KAAkD,EAAQ,EAAE,GAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAA,CAAC,CAAC;IACjI,QAAQ,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACrD,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC/C,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC,KAAY,EAAE,EAAE;QACxD,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAyB,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAmB,eAAe,CAAE,CAAC;QACrE,QAAQ,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,UAAU,EAAE,EAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAC,CAAC,CAAC,CAAC;QAC3E,aAAa,CAAC,aAAa,CAAmB,eAAe,CAAE,CAAC,KAAK,EAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAC,KAAY,EAAE,EAAE;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,MAA0B,CAAC;QAC/C,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,QAAQ,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,aAAa,EAAE,EAAC,MAAM,EAAE,EAAE,EAAC,CAAC,CAAC,CAAC;QACrE,MAAM,WAAW,GAAG,aAAa,CAAC,aAAa,CAAmB,kBAAkB,EAAE,IAAI,CAAC;eACpF,aAAa,CAAC,aAAa,CAAoB,yCAAyC,CAAE,CAAC;QAClG,WAAW,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAExD,OAAO;QACH,QAAQ;QACR,KAAK;QACL,MAAM;QACN,IAAI;QACJ,OAAO;YACH,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,QAAQ,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAClD,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;YACxD,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YACvD,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,QAAQ,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACJ,CAAC;AACN,CAAC","sourcesContent":["import type Router from 'white-label-router';\nimport type View from 'white-label-view';\nimport {createInitialTaskState, describeTaskStatus} from '../../view/examples/tasks/task-state.js';\nimport {createTaskMediator, type TaskMediator} from './TaskMediator.js';\nimport TaskModel from './TaskModel.js';\nimport {createTaskRouter} from './TaskRouter.js';\nimport {createTaskView} from './TaskView.js';\n\n/** Public handles make the example straightforward to test and tear down. */\nexport interface TaskApplication {\n    mediator: TaskMediator;\n    model: TaskModel;\n    router: Router;\n    view: View;\n    destroy(): void;\n}\n\n/**\n * Compose the application at one explicit boundary.\n *\n * This is the only module that knows every moving part. Model, View, Router,\n * and Mediator stay independently understandable, while this file documents\n * the small amount of wiring needed to make them cooperate in a real feature.\n */\nexport function initializeTaskApplication(documentRoot: Document): TaskApplication {\n    const parentElement = documentRoot.querySelector<HTMLElement>('[data-task-example]');\n    if (!parentElement) {throw new TypeError('White Label task example requires a data-task-example container');}\n\n    const mediator = createTaskMediator();\n    const model = new TaskModel(createInitialTaskState());\n    const view = createTaskView(parentElement, model);\n    const status = parentElement.querySelector<HTMLElement>('[data-task-status]')!;\n    const updateStatus = (): void => {status.textContent = describeTaskStatus(model.get());};\n\n    const addTask = (event: CustomEvent<string>): void => {model.add(event.detail); updateStatus();};\n    const toggleTask = (event: CustomEvent<number>): void => {model.toggle(event.detail); updateStatus();};\n    const setFilter = (event: CustomEvent<'all' | 'active' | 'completed'>): void => {model.setFilter(event.detail); updateStatus();};\n    mediator.addEventListener('task:add', addTask);\n    mediator.addEventListener('task:toggle', toggleTask);\n    mediator.addEventListener('task:filter', setFilter);\n\n    const delegated = view.delegate(parentElement);\n    delegated.on('submit', '[data-task-form]', (event: Event) => {\n        event.preventDefault();\n        const form = event.target as HTMLFormElement;\n        const input = form.querySelector<HTMLInputElement>('[name=\"task\"]')!;\n        mediator.dispatchEvent(new CustomEvent('task:add', {detail: input.value}));\n        parentElement.querySelector<HTMLInputElement>('[name=\"task\"]')!.focus();\n    });\n    delegated.on('change', '[data-task-toggle]', (event: Event) => {\n        const input = event.target as HTMLInputElement;\n        const id = Number(input.dataset.taskId);\n        mediator.dispatchEvent(new CustomEvent('task:toggle', {detail: id}));\n        const focusTarget = parentElement.querySelector<HTMLInputElement>(`[data-task-id=\"${id}\"]`)\n            ?? parentElement.querySelector<HTMLAnchorElement>('[data-task-filter][aria-current=\"page\"]')!;\n        focusTarget.focus();\n    });\n\n    const router = createTaskRouter(documentRoot, mediator);\n\n    return {\n        mediator,\n        model,\n        router,\n        view,\n        destroy() {\n            delegated.clear();\n            router.destroy();\n            mediator.removeEventListener('task:add', addTask);\n            mediator.removeEventListener('task:toggle', toggleTask);\n            mediator.removeEventListener('task:filter', setFilter);\n            view.destroy();\n            model.destroy();\n            mediator.destroy();\n        }\n    };\n}\n"]}

package/dist/app/assets/script/tasks/TaskMediator.d.ts

@@ -1,15 +1,10 @@
 import Mediator from 'white-label-mediator';
 import type { TaskFilter } from '../../view/examples/tasks/task-state.js';
-/**
- * Document the event protocol in one place even though the currently installed
- * Mediator exposes the EventEmitter-compatible runtime without a generic map.
- * Keeping names and payloads explicit still gives learners one clear contract
- * to follow when tracing the example.
- */
+/** Application event vocabulary shared by the generated task modules. */
 export type TaskEvents = {
-    'task:add': [title: string];
-    'task:filter': [filter: TaskFilter];
-    'task:toggle': [id: number];
+    'task:add': string;
+    'task:filter': TaskFilter;
+    'task:toggle': number;
 };
-export type TaskMediator = Mediator;
+export type TaskMediator = Mediator<TaskEvents>;
 export declare function createTaskMediator(): TaskMediator;

package/dist/app/assets/script/tasks/TaskMediator.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskMediator.js","sourceRoot":"","sources":["../../../../../app/assets/script/tasks/TaskMediator.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAiB5C,MAAM,UAAU,kBAAkB;IAC9B,OAAO,IAAI,QAAQ,EAAE,CAAC,UAAU,EAAE,CAAC;AACvC,CAAC","sourcesContent":["import Mediator from 'white-label-mediator';\nimport type {TaskFilter} from '../../view/examples/tasks/task-state.js';\n\n/**\n * Document the event protocol in one place even though the currently installed\n * Mediator exposes the EventEmitter-compatible runtime without a generic map.\n * Keeping names and payloads explicit still gives learners one clear contract\n * to follow when tracing the example.\n */\nexport type TaskEvents = {\n    'task:add': [title: string];\n    'task:filter': [filter: TaskFilter];\n    'task:toggle': [id: number];\n};\n\nexport type TaskMediator = Mediator;\n\nexport function createTaskMediator(): TaskMediator {\n    return new Mediator().initialize();\n}\n"]}
+{"version":3,"file":"TaskMediator.js","sourceRoot":"","sources":["../../../../../app/assets/script/tasks/TaskMediator.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAY5C,MAAM,UAAU,kBAAkB;IAC9B,OAAO,IAAI,QAAQ,EAAc,CAAC,UAAU,EAAE,CAAC;AACnD,CAAC","sourcesContent":["import Mediator from 'white-label-mediator';\nimport type {TaskFilter} from '../../view/examples/tasks/task-state.js';\n\n/** Application event vocabulary shared by the generated task modules. */\nexport type TaskEvents = {\n    'task:add': string;\n    'task:filter': TaskFilter;\n    'task:toggle': number;\n};\n\nexport type TaskMediator = Mediator<TaskEvents>;\n\nexport function createTaskMediator(): TaskMediator {\n    return new Mediator<TaskEvents>().initialize();\n}\n"]}

package/dist/app/assets/script/tasks/TaskRouter.js

@@ -17,7 +17,7 @@ export function createTaskRouter(documentRoot, mediator) {
     const route = (_scope, location) => {
         const filter = normalizeTaskFilter(location.data.query.tasks);
         const restoreFocus = documentRoot.activeElement?.hasAttribute('data-task-filter') === true;
-        mediator.emit('task:filter', filter);
+        mediator.dispatchEvent(new CustomEvent('task:filter', { detail: filter }));
         if (restoreFocus) {
             documentRoot.querySelector(`[data-task-filter="${filter}"]`).focus();
         }

package/dist/app/assets/script/tasks/TaskRouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskRouter.js","sourceRoot":"","sources":["../../../../../app/assets/script/tasks/TaskRouter.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAIxC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAExE,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IACzD,OAAO,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,KAAmB,CAAC,CAAC,CAAC,CAAC,KAAmB,CAAC,CAAC,CAAC,KAAK,CAAC;AACvF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAsB,EAAE,QAAsB;IAC3E,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,MAAsB,EAAE,QAAiD,EAAQ,EAAE;QAC9F,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAG,YAAY,CAAC,aAAa,EAAE,YAAY,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC;QAC3F,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACrC,IAAI,YAAY,EAAE,CAAC;YAAA,YAAY,CAAC,aAAa,CAAoB,sBAAsB,MAAM,IAAI,CAAE,CAAC,KAAK,EAAE,CAAC;QAAA,CAAC;IACjH,CAAC,CAAC;IACF,MAAM,CAAC,MAAM,GAAG,EAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAC,CAAC;IAClD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC/B,CAAC","sourcesContent":["import Router from 'white-label-router';\nimport type {TaskFilter} from '../../view/examples/tasks/task-state.js';\nimport type {TaskMediator} from './TaskMediator.js';\n\nconst taskFilters = new Set<TaskFilter>(['all', 'active', 'completed']);\n\n/** Normalize URL input at the routing boundary before it reaches domain state. */\nexport function normalizeTaskFilter(value: string | undefined): TaskFilter {\n    return value && taskFilters.has(value as TaskFilter) ? value as TaskFilter : 'all';\n}\n\n/**\n * Router translates URL state into an application event.\n *\n * It does not update the Model or DOM directly. That separation keeps routing\n * usable in different applications and makes browser navigation easy to test.\n */\nexport function createTaskRouter(documentRoot: Document, mediator: TaskMediator): Router {\n    const router = new Router();\n    router.scope = documentRoot.querySelector('main');\n    router.mediator = mediator;\n    const route = (_scope: Element | null, location: {data: {query: Record<string, string>}}): void => {\n        const filter = normalizeTaskFilter(location.data.query.tasks);\n        const restoreFocus = documentRoot.activeElement?.hasAttribute('data-task-filter') === true;\n        mediator.emit('task:filter', filter);\n        if (restoreFocus) {documentRoot.querySelector<HTMLAnchorElement>(`[data-task-filter=\"${filter}\"]`)!.focus();}\n    };\n    router.routes = {'/': route, defaultRoute: route};\n    return router.initialize();\n}\n"]}
+{"version":3,"file":"TaskRouter.js","sourceRoot":"","sources":["../../../../../app/assets/script/tasks/TaskRouter.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAIxC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAExE,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IACzD,OAAO,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,KAAmB,CAAC,CAAC,CAAC,CAAC,KAAmB,CAAC,CAAC,CAAC,KAAK,CAAC;AACvF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAsB,EAAE,QAAsB;IAC3E,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,MAAsB,EAAE,QAAiD,EAAQ,EAAE;QAC9F,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAG,YAAY,CAAC,aAAa,EAAE,YAAY,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC;QAC3F,QAAQ,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,aAAa,EAAE,EAAC,MAAM,EAAE,MAAM,EAAC,CAAC,CAAC,CAAC;QACzE,IAAI,YAAY,EAAE,CAAC;YAAA,YAAY,CAAC,aAAa,CAAoB,sBAAsB,MAAM,IAAI,CAAE,CAAC,KAAK,EAAE,CAAC;QAAA,CAAC;IACjH,CAAC,CAAC;IACF,MAAM,CAAC,MAAM,GAAG,EAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAC,CAAC;IAClD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC/B,CAAC","sourcesContent":["import Router from 'white-label-router';\nimport type {TaskFilter} from '../../view/examples/tasks/task-state.js';\nimport type {TaskMediator} from './TaskMediator.js';\n\nconst taskFilters = new Set<TaskFilter>(['all', 'active', 'completed']);\n\n/** Normalize URL input at the routing boundary before it reaches domain state. */\nexport function normalizeTaskFilter(value: string | undefined): TaskFilter {\n    return value && taskFilters.has(value as TaskFilter) ? value as TaskFilter : 'all';\n}\n\n/**\n * Router translates URL state into an application event.\n *\n * It does not update the Model or DOM directly. That separation keeps routing\n * usable in different applications and makes browser navigation easy to test.\n */\nexport function createTaskRouter(documentRoot: Document, mediator: TaskMediator): Router {\n    const router = new Router();\n    router.scope = documentRoot.querySelector('main');\n    router.mediator = mediator;\n    const route = (_scope: Element | null, location: {data: {query: Record<string, string>}}): void => {\n        const filter = normalizeTaskFilter(location.data.query.tasks);\n        const restoreFocus = documentRoot.activeElement?.hasAttribute('data-task-filter') === true;\n        mediator.dispatchEvent(new CustomEvent('task:filter', {detail: filter}));\n        if (restoreFocus) {documentRoot.querySelector<HTMLAnchorElement>(`[data-task-filter=\"${filter}\"]`)!.focus();}\n    };\n    router.routes = {'/': route, defaultRoute: route};\n    return router.initialize();\n}\n"]}

package/dist/app/assets/view/sections/PackageDocsSection.js

@@ -10,7 +10,7 @@ const repositories = {
 export default function PackageDocsSection() {
     return (_jsx("section", { className: "section", id: "packages", "aria-labelledby": "packages-title", children: _jsxs("div", { className: "container", children: [_jsxs("div", { className: "section-intro", children: [_jsx("p", { className: "eyebrow", children: "Documentation" }), _jsx("h2", { id: "packages-title", children: "The core flow stays explicit." }), _jsx("p", { children: "Each package has one job, can be used independently, and stays easy to replace or test because application concerns are not hidden behind a framework." })] }), _jsx("div", { className: "architecture", children: _jsxs("ol", { children: [_jsxs("li", { children: [_jsx("strong", { children: "Router" }), _jsx("span", { children: "turns a URL into application intent" })] }), _jsxs("li", { children: [_jsx("strong", { children: "Mediator" }), _jsx("span", { children: "coordinates that intent between modules" })] }), _jsxs("li", { children: [_jsx("strong", { children: "Model" }), _jsx("span", { children: "stores and publishes application state" })] }), _jsxs("li", { children: [_jsx("strong", { children: "View" }), _jsx("span", { children: "renders the resulting interface" })] })] }) }), _jsxs("div", { className: "docs-grid", children: [_jsxs("article", { children: [_jsx("p", { className: "eyebrow", children: "Model" }), _jsx("h3", { children: "State is observable, not magical." }), _jsx(CodeBlock, { lines: [
                                         _jsxs(_Fragment, { children: [_jsx("span", { className: syntax.keyword, children: "const" }), " model = ", _jsx("span", { className: syntax.keyword, children: "new" }), " ", _jsx("span", { className: syntax.type, children: "Model" }), "(", '{', "count: 0", '}', ");"] }),
-                                        _jsxs(_Fragment, { children: ["model.on(", _jsx("span", { className: syntax.value, children: "'change'" }), ", state => render(state));"] }),
+                                        _jsxs(_Fragment, { children: ["model.addEventListener(", _jsx("span", { className: syntax.value, children: "'change'" }), ", event => render(event.detail));"] }),
                                         _jsxs(_Fragment, { children: ["model.update(", '{', "count: 1", '}', ");"] })
                                     ] }), _jsx("p", { children: _jsx("a", { href: repositories.model, children: "Model documentation" }) })] }), _jsxs("article", { children: [_jsx("p", { className: "eyebrow", children: "View" }), _jsx("h3", { children: "JSX renders through White Label." }), _jsx(CodeBlock, { lines: [
                                         _jsxs(_Fragment, { children: [_jsx("span", { className: syntax.keyword, children: "const" }), " view = ", _jsx("span", { className: syntax.keyword, children: "new" }), " ", _jsx("span", { className: syntax.type, children: "View" }), "(", '{'] }),
@@ -18,12 +18,12 @@ export default function PackageDocsSection() {
                                         _jsxs(_Fragment, { children: ["  template: state => <p>", '{', "state.count", '}', "</p>"] }),
                                         _jsxs(_Fragment, { children: ['}', ").initialize();"] })
                                     ] }), _jsx("p", { children: _jsx("a", { href: repositories.view, children: "View documentation" }) })] }), _jsxs("article", { children: [_jsx("p", { className: "eyebrow", children: "Mediator" }), _jsx("h3", { children: "Modules communicate through events." }), _jsx(CodeBlock, { lines: [
-                                        _jsxs(_Fragment, { children: ["mediator.on(", _jsx("span", { className: syntax.value, children: "'counter:increment'" }), ", increment);"] }),
-                                        _jsxs(_Fragment, { children: ["mediator.emit(", _jsx("span", { className: syntax.value, children: "'counter:increment'" }), ");"] })
+                                        _jsxs(_Fragment, { children: ["mediator.addEventListener(", _jsx("span", { className: syntax.value, children: "'counter:increment'" }), ", increment);"] }),
+                                        _jsxs(_Fragment, { children: ["mediator.dispatchEvent(", _jsx("span", { className: syntax.keyword, children: "new" }), " ", _jsx("span", { className: syntax.type, children: "CustomEvent" }), "(", _jsx("span", { className: syntax.value, children: "'counter:increment'" }), "));"] })
                                     ] }), _jsx("p", { children: _jsx("a", { href: repositories.mediator, children: "Mediator documentation" }) })] }), _jsxs("article", { children: [_jsx("p", { className: "eyebrow", children: "Router" }), _jsx("h3", { children: "Routes describe intent." }), _jsx(CodeBlock, { lines: [
                                         _jsxs(_Fragment, { children: ["router.routes = ", '{'] }),
                                         _jsxs(_Fragment, { children: ["  ", _jsx("span", { className: syntax.value, children: "'/'" }), ": (_scope, location) => ", '{'] }),
-                                        _jsxs(_Fragment, { children: ["    mediator.emit(", _jsx("span", { className: syntax.value, children: "'filter:set'" }), ", location.data.query.filter);"] }),
+                                        _jsxs(_Fragment, { children: ["    mediator.dispatchEvent(", _jsx("span", { className: syntax.keyword, children: "new" }), " ", _jsx("span", { className: syntax.type, children: "CustomEvent" }), "(", _jsx("span", { className: syntax.value, children: "'filter:set'" }), ", ", '{', "detail: location.data.query.filter", '}', "));"] }),
                                         _jsxs(_Fragment, { children: ["  ", '}'] }),
                                         _jsxs(_Fragment, { children: ['}', ";"] })
                                     ] }), _jsx("p", { children: _jsx("a", { href: repositories.router, children: "Router documentation" }) })] })] })] }) }));

package/dist/app/assets/view/sections/PackageDocsSection.js.map

@@ -1 +1 @@
-{"version":3,"file":"PackageDocsSection.js","sourceRoot":"","sources":["../../../../../app/assets/view/sections/PackageDocsSection.tsx"],"names":[],"mappings":"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","sourcesContent":["import CodeBlock, {syntax} from '../CodeBlock.js';\n\nconst repositories = {\n    mediator: 'https://github.com/bshack/white-label-mediator',\n    model: 'https://github.com/bshack/white-label-model',\n    router: 'https://github.com/bshack/white-label-router',\n    view: 'https://github.com/bshack/white-label-view'\n};\n\n/** Package documentation stays close to the example it describes. */\nexport default function PackageDocsSection() {\n    return (\n        <section className=\"section\" id=\"packages\" aria-labelledby=\"packages-title\">\n            <div className=\"container\">\n                <div className=\"section-intro\">\n                    <p className=\"eyebrow\">Documentation</p>\n                    <h2 id=\"packages-title\">The core flow stays explicit.</h2>\n                    <p>Each package has one job, can be used independently, and stays easy to replace or test because application concerns are not hidden behind a framework.</p>\n                </div>\n                <div className=\"architecture\"><ol>\n                    <li><strong>Router</strong><span>turns a URL into application intent</span></li>\n                    <li><strong>Mediator</strong><span>coordinates that intent between modules</span></li>\n                    <li><strong>Model</strong><span>stores and publishes application state</span></li>\n                    <li><strong>View</strong><span>renders the resulting interface</span></li>\n                </ol></div>\n                <div className=\"docs-grid\">\n                    <article>\n                        <p className=\"eyebrow\">Model</p><h3>State is observable, not magical.</h3>\n                        <CodeBlock lines={[\n                            <><span className={syntax.keyword}>const</span> model = <span className={syntax.keyword}>new</span> <span className={syntax.type}>Model</span>({'{'}count: 0{'}'});</>,\n                            <>model.on(<span className={syntax.value}>'change'</span>, state =&gt; render(state));</>,\n                            <>model.update({'{'}count: 1{'}'});</>\n                        ]} />\n                        <p><a href={repositories.model}>Model documentation</a></p>\n                    </article>\n                    <article>\n                        <p className=\"eyebrow\">View</p><h3>JSX renders through White Label.</h3>\n                        <CodeBlock lines={[\n                            <><span className={syntax.keyword}>const</span> view = <span className={syntax.keyword}>new</span> <span className={syntax.type}>View</span>({'{'}</>,\n                            <>  model,</>,\n                            <>  template: state =&gt; &lt;p&gt;{'{'}state.count{'}'}&lt;/p&gt;</>,\n                            <>{'}'}).initialize();</>\n                        ]} />\n                        <p><a href={repositories.view}>View documentation</a></p>\n                    </article>\n                    <article>\n                        <p className=\"eyebrow\">Mediator</p><h3>Modules communicate through events.</h3>\n                        <CodeBlock lines={[\n                            <>mediator.on(<span className={syntax.value}>'counter:increment'</span>, increment);</>,\n                            <>mediator.emit(<span className={syntax.value}>'counter:increment'</span>);</>\n                        ]} />\n                        <p><a href={repositories.mediator}>Mediator documentation</a></p>\n                    </article>\n                    <article>\n                        <p className=\"eyebrow\">Router</p><h3>Routes describe intent.</h3>\n                        <CodeBlock lines={[\n                            <>router.routes = {'{'}</>,\n                            <>  <span className={syntax.value}>'/'</span>: (_scope, location) =&gt; {'{'}</>,\n                            <>    mediator.emit(<span className={syntax.value}>'filter:set'</span>, location.data.query.filter);</>,\n                            <>  {'}'}</>,\n                            <>{'}'};</>\n                        ]} />\n                        <p><a href={repositories.router}>Router documentation</a></p>\n                    </article>\n                </div>\n            </div>\n        </section>\n    );\n}\n"]}
+{"version":3,"file":"PackageDocsSection.js","sourceRoot":"","sources":["../../../../../app/assets/view/sections/PackageDocsSection.tsx"],"names":[],"mappings":"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","sourcesContent":["import CodeBlock, {syntax} from '../CodeBlock.js';\n\nconst repositories = {\n    mediator: 'https://github.com/bshack/white-label-mediator',\n    model: 'https://github.com/bshack/white-label-model',\n    router: 'https://github.com/bshack/white-label-router',\n    view: 'https://github.com/bshack/white-label-view'\n};\n\n/** Package documentation stays close to the example it describes. */\nexport default function PackageDocsSection() {\n    return (\n        <section className=\"section\" id=\"packages\" aria-labelledby=\"packages-title\">\n            <div className=\"container\">\n                <div className=\"section-intro\">\n                    <p className=\"eyebrow\">Documentation</p>\n                    <h2 id=\"packages-title\">The core flow stays explicit.</h2>\n                    <p>Each package has one job, can be used independently, and stays easy to replace or test because application concerns are not hidden behind a framework.</p>\n                </div>\n                <div className=\"architecture\"><ol>\n                    <li><strong>Router</strong><span>turns a URL into application intent</span></li>\n                    <li><strong>Mediator</strong><span>coordinates that intent between modules</span></li>\n                    <li><strong>Model</strong><span>stores and publishes application state</span></li>\n                    <li><strong>View</strong><span>renders the resulting interface</span></li>\n                </ol></div>\n                <div className=\"docs-grid\">\n                    <article>\n                        <p className=\"eyebrow\">Model</p><h3>State is observable, not magical.</h3>\n                        <CodeBlock lines={[\n                            <><span className={syntax.keyword}>const</span> model = <span className={syntax.keyword}>new</span> <span className={syntax.type}>Model</span>({'{'}count: 0{'}'});</>,\n                            <>model.addEventListener(<span className={syntax.value}>'change'</span>, event =&gt; render(event.detail));</>,\n                            <>model.update({'{'}count: 1{'}'});</>\n                        ]} />\n                        <p><a href={repositories.model}>Model documentation</a></p>\n                    </article>\n                    <article>\n                        <p className=\"eyebrow\">View</p><h3>JSX renders through White Label.</h3>\n                        <CodeBlock lines={[\n                            <><span className={syntax.keyword}>const</span> view = <span className={syntax.keyword}>new</span> <span className={syntax.type}>View</span>({'{'}</>,\n                            <>  model,</>,\n                            <>  template: state =&gt; &lt;p&gt;{'{'}state.count{'}'}&lt;/p&gt;</>,\n                            <>{'}'}).initialize();</>\n                        ]} />\n                        <p><a href={repositories.view}>View documentation</a></p>\n                    </article>\n                    <article>\n                        <p className=\"eyebrow\">Mediator</p><h3>Modules communicate through events.</h3>\n                        <CodeBlock lines={[\n                            <>mediator.addEventListener(<span className={syntax.value}>'counter:increment'</span>, increment);</>,\n                            <>mediator.dispatchEvent(<span className={syntax.keyword}>new</span> <span className={syntax.type}>CustomEvent</span>(<span className={syntax.value}>'counter:increment'</span>));</>\n                        ]} />\n                        <p><a href={repositories.mediator}>Mediator documentation</a></p>\n                    </article>\n                    <article>\n                        <p className=\"eyebrow\">Router</p><h3>Routes describe intent.</h3>\n                        <CodeBlock lines={[\n                            <>router.routes = {'{'}</>,\n                            <>  <span className={syntax.value}>'/'</span>: (_scope, location) =&gt; {'{'}</>,\n                            <>    mediator.dispatchEvent(<span className={syntax.keyword}>new</span> <span className={syntax.type}>CustomEvent</span>(<span className={syntax.value}>'filter:set'</span>, {'{'}detail: location.data.query.filter{'}'}));</>,\n                            <>  {'}'}</>,\n                            <>{'}'};</>\n                        ]} />\n                        <p><a href={repositories.router}>Router documentation</a></p>\n                    </article>\n                </div>\n            </div>\n        </section>\n    );\n}\n"]}

package/dist/cli/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { realpathSync } from 'node:fs';
 import { readdir } from 'node:fs/promises';
 import path from 'node:path';
 import process from 'node:process';
@@ -88,7 +89,7 @@ export async function runCli(args, dependencies = {}) {
 }
 const invokedPath = path.resolve(process.argv[1]);
 const modulePath = fileURLToPath(import.meta.url);
-if (invokedPath === modulePath) {
+if (realpathSync(invokedPath) === realpathSync(modulePath)) {
     runCli(process.argv.slice(2)).then((exitCode) => { process.exitCode = exitCode; }, (error) => {
         process.stderr.write(`Unable to create White Label project: ${formatCliError(error)}\n`);
         process.exitCode = 1;

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../cli/index.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n\nimport {readdir} from 'node:fs/promises';\nimport path from 'node:path';\nimport process from 'node:process';\nimport {createInterface} from 'node:readline/promises';\nimport {fileURLToPath} from 'node:url';\nimport {createProject} from '../scaffold/index.js';\n\nexport interface CliDependencies {\n    cwd?: () => string;\n    createProject?: typeof createProject;\n    stdout?: Pick<NodeJS.WriteStream, 'write'>;\n    stderr?: Pick<NodeJS.WriteStream, 'write'>;\n    input?: NodeJS.ReadableStream;\n    output?: NodeJS.WritableStream;\n    isInteractive?: boolean;\n}\n\nfunction usage() {\n    return [\n        'Usage:',\n        '  white-label create <directory> [--jsx | --no-jsx]',\n        '',\n        'Commands:',\n        '  create <directory>  Create a White Label project.',\n        '',\n        'Options:',\n        '  --jsx              Generate TypeScript with JSX/TSX templates.',\n        '  --no-jsx           Generate plain TypeScript with HTML string templates.',\n        '  -h, --help         Show this help message.'\n    ].join('\\n');\n}\n\nexport function formatCliError(error: unknown) {\n    return error instanceof Error ? error.message : String(error);\n}\n\nasync function askForJsx(input: NodeJS.ReadableStream, output: NodeJS.WritableStream): Promise<boolean> {\n    const readline = createInterface({input, output});\n    try {\n        const answer = await readline.question(\n            'Use JSX/TSX for page and view templates? Choose Yes for JSX syntax like <section>...</section>, or No for plain TypeScript that returns HTML strings. (Y/n) '\n        );\n        return !/^n(?:o)?$/i.test(answer.trim());\n    } finally {\n        readline.close();\n    }\n}\n\n/** Reject an existing non-empty target so a mistyped CLI destination cannot overwrite project files. */\nasync function assertDestinationAvailable(destination: string) {\n    try {\n        const entries = await readdir(destination);\n        if (entries.length) {\n            throw new Error(`Destination directory must be empty: ${destination}`);\n        }\n    } catch (error) {\n        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {return;}\n        throw error;\n    }\n}\n\nexport async function runCli(args: readonly string[], dependencies: CliDependencies = {}) {\n    const cwd = dependencies.cwd ?? process.cwd;\n    const scaffold = dependencies.createProject ?? createProject;\n    const stdout = dependencies.stdout ?? process.stdout;\n    const stderr = dependencies.stderr ?? process.stderr;\n    const input = dependencies.input ?? process.stdin;\n    const output = dependencies.output ?? process.stdout;\n    const [command, destination, ...options] = args;\n\n    if (command === '--help' || command === '-h' || args.length === 0) {\n        stdout.write(`${usage()}\\n`);\n        return 0;\n    }\n\n    const allowedOptions = new Set(['--jsx', '--no-jsx']);\n    if (\n        command !== 'create' ||\n        !destination ||\n        options.some(option => !allowedOptions.has(option)) ||\n        (options.includes('--jsx') && options.includes('--no-jsx'))\n    ) {\n        stderr.write(`${usage()}\\n`);\n        return 1;\n    }\n\n    let jsx: boolean;\n    if (options.includes('--jsx')) {\n        jsx = true;\n    } else if (options.includes('--no-jsx')) {\n        jsx = false;\n    } else if (dependencies.isInteractive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY)) {\n        jsx = await askForJsx(input, output);\n    } else {\n        jsx = true;\n    }\n\n    const resolvedDestination = path.resolve(cwd(), destination);\n    await assertDestinationAvailable(resolvedDestination);\n    await scaffold({destination: resolvedDestination, jsx});\n    stdout.write(`Created White Label project at ${resolvedDestination}\\n`);\n    return 0;\n}\n\nconst invokedPath = path.resolve(process.argv[1] as string);\nconst modulePath = fileURLToPath(import.meta.url);\nif (invokedPath === modulePath) {\n    runCli(process.argv.slice(2)).then(\n        (exitCode) => {process.exitCode = exitCode;},\n        (error: unknown) => {\n            process.stderr.write(`Unable to create White Label project: ${formatCliError(error)}\\n`);\n            process.exitCode = 1;\n        }\n    );\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../cli/index.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n\nimport {realpathSync} from 'node:fs';\nimport {readdir} from 'node:fs/promises';\nimport path from 'node:path';\nimport process from 'node:process';\nimport {createInterface} from 'node:readline/promises';\nimport {fileURLToPath} from 'node:url';\nimport {createProject} from '../scaffold/index.js';\n\nexport interface CliDependencies {\n    cwd?: () => string;\n    createProject?: typeof createProject;\n    stdout?: Pick<NodeJS.WriteStream, 'write'>;\n    stderr?: Pick<NodeJS.WriteStream, 'write'>;\n    input?: NodeJS.ReadableStream;\n    output?: NodeJS.WritableStream;\n    isInteractive?: boolean;\n}\n\nfunction usage() {\n    return [\n        'Usage:',\n        '  white-label create <directory> [--jsx | --no-jsx]',\n        '',\n        'Commands:',\n        '  create <directory>  Create a White Label project.',\n        '',\n        'Options:',\n        '  --jsx              Generate TypeScript with JSX/TSX templates.',\n        '  --no-jsx           Generate plain TypeScript with HTML string templates.',\n        '  -h, --help         Show this help message.'\n    ].join('\\n');\n}\n\nexport function formatCliError(error: unknown) {\n    return error instanceof Error ? error.message : String(error);\n}\n\nasync function askForJsx(input: NodeJS.ReadableStream, output: NodeJS.WritableStream): Promise<boolean> {\n    const readline = createInterface({input, output});\n    try {\n        const answer = await readline.question(\n            'Use JSX/TSX for page and view templates? Choose Yes for JSX syntax like <section>...</section>, or No for plain TypeScript that returns HTML strings. (Y/n) '\n        );\n        return !/^n(?:o)?$/i.test(answer.trim());\n    } finally {\n        readline.close();\n    }\n}\n\n/** Reject an existing non-empty target so a mistyped CLI destination cannot overwrite project files. */\nasync function assertDestinationAvailable(destination: string) {\n    try {\n        const entries = await readdir(destination);\n        if (entries.length) {\n            throw new Error(`Destination directory must be empty: ${destination}`);\n        }\n    } catch (error) {\n        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {return;}\n        throw error;\n    }\n}\n\nexport async function runCli(args: readonly string[], dependencies: CliDependencies = {}) {\n    const cwd = dependencies.cwd ?? process.cwd;\n    const scaffold = dependencies.createProject ?? createProject;\n    const stdout = dependencies.stdout ?? process.stdout;\n    const stderr = dependencies.stderr ?? process.stderr;\n    const input = dependencies.input ?? process.stdin;\n    const output = dependencies.output ?? process.stdout;\n    const [command, destination, ...options] = args;\n\n    if (command === '--help' || command === '-h' || args.length === 0) {\n        stdout.write(`${usage()}\\n`);\n        return 0;\n    }\n\n    const allowedOptions = new Set(['--jsx', '--no-jsx']);\n    if (\n        command !== 'create' ||\n        !destination ||\n        options.some(option => !allowedOptions.has(option)) ||\n        (options.includes('--jsx') && options.includes('--no-jsx'))\n    ) {\n        stderr.write(`${usage()}\\n`);\n        return 1;\n    }\n\n    let jsx: boolean;\n    if (options.includes('--jsx')) {\n        jsx = true;\n    } else if (options.includes('--no-jsx')) {\n        jsx = false;\n    } else if (dependencies.isInteractive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY)) {\n        jsx = await askForJsx(input, output);\n    } else {\n        jsx = true;\n    }\n\n    const resolvedDestination = path.resolve(cwd(), destination);\n    await assertDestinationAvailable(resolvedDestination);\n    await scaffold({destination: resolvedDestination, jsx});\n    stdout.write(`Created White Label project at ${resolvedDestination}\\n`);\n    return 0;\n}\n\nconst invokedPath = path.resolve(process.argv[1] as string);\nconst modulePath = fileURLToPath(import.meta.url);\nif (realpathSync(invokedPath) === realpathSync(modulePath)) {\n    runCli(process.argv.slice(2)).then(\n        (exitCode) => {process.exitCode = exitCode;},\n        (error: unknown) => {\n            process.stderr.write(`Unable to create White Label project: ${formatCliError(error)}\\n`);\n            process.exitCode = 1;\n        }\n    );\n}\n"]}

package/dist/scaffold/index.d.ts

@@ -24,7 +24,7 @@ export declare function createSiteManifest(): {
     allowScripts: {
         '@parcel/watcher@2.5.1': boolean;
         'esbuild@0.28.2': boolean;
-        'white-label-view@5.1.0': boolean;
+        'white-label-view@6.0.0': boolean;
     };
     dependenciesMeta: {
         '@parcel/watcher@2.5.1': {
@@ -33,7 +33,7 @@ export declare function createSiteManifest(): {
         'esbuild@0.28.2': {
             built: boolean;
         };
-        'white-label-view@5.1.0': {
+        'white-label-view@6.0.0': {
             built: boolean;
         };
     };
@@ -55,10 +55,10 @@ export declare function createSiteManifest(): {
     };
 };
 /**
- * Create a White Label project.
+ * Create a White Label project without overwriting a non-empty destination.
  *
  * This is the shared implementation behind every creation interface. Adapters
- * translate their environment into these options instead of owning templates or
- * project-generation behavior themselves.
+ * translate their environment into these options instead of owning templates,
+ * overwrite policy, or project-generation behavior themselves.
  */
 export declare function createProject({ destination, fileSystem, jsx }: CreateProjectOptions): Promise<void>;

package/dist/scaffold/index.js

@@ -1,5 +1,5 @@
 /** @module scaffold */
-import { cp, mkdir, writeFile } from 'node:fs/promises';
+import { cp, mkdir, readdir, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
@@ -13,6 +13,21 @@ const nodeFileSystem = {
         await writeFile(destination, `${JSON.stringify(value, null, 2)}\n`);
     }
 };
+/** Refuse to layer a generated project over existing user files. */
+async function assertDestinationAvailable(destination) {
+    try {
+        const entries = await readdir(destination);
+        if (entries.length) {
+            throw new Error(`Destination directory must be empty: ${destination}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return;
+        }
+        throw error;
+    }
+}
 /** Return the package manifest used by generated White Label projects. */
 export function createSiteManifest() {
     return {
@@ -29,12 +44,12 @@ export function createSiteManifest() {
         allowScripts: {
             '@parcel/watcher@2.5.1': true,
             'esbuild@0.28.2': true,
-            'white-label-view@5.1.0': true
+            'white-label-view@6.0.0': true
         },
         dependenciesMeta: {
             '@parcel/watcher@2.5.1': { built: true },
             'esbuild@0.28.2': { built: true },
-            'white-label-view@5.1.0': { built: true }
+            'white-label-view@6.0.0': { built: true }
         },
         devDependencies: {
             '@tailwindcss/cli': '4.3.3',
@@ -47,10 +62,10 @@ export function createSiteManifest() {
             'typescript': '7.0.2'
         },
         dependencies: {
-            'white-label-mediator': '4.0.0',
-            'white-label-model': '6.0.0',
-            'white-label-router': '5.0.0',
-            'white-label-view': '5.1.0'
+            'white-label-mediator': '5.0.0',
+            'white-label-model': '7.0.1',
+            'white-label-router': '6.0.0',
+            'white-label-view': '6.0.0'
         }
     };
 }
@@ -74,13 +89,14 @@ const noJsxTemplateCopies = [
     ['tsconfig.site.no-jsx.json', 'tsconfig.json']
 ];
 /**
- * Create a White Label project.
+ * Create a White Label project without overwriting a non-empty destination.
  *
  * This is the shared implementation behind every creation interface. Adapters
- * translate their environment into these options instead of owning templates or
- * project-generation behavior themselves.
+ * translate their environment into these options instead of owning templates,
+ * overwrite policy, or project-generation behavior themselves.
  */
 export async function createProject({ destination, fileSystem = nodeFileSystem, jsx = true }) {
+    await assertDestinationAvailable(destination);
     const copies = jsx ? [
         ['.editorconfig', '.editorconfig'],
         ['.yarnrc.yml', '.yarnrc.yml'],

package/dist/scaffold/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../scaffold/index.ts"],"names":[],"mappings":"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","sourcesContent":["/** @module scaffold */\nimport {cp, mkdir, writeFile} from 'node:fs/promises';\nimport path from 'node:path';\nimport {fileURLToPath} from 'node:url';\n\nconst packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');\n\nexport interface ScaffoldFileSystem {\n    copy(source: string, destination: string): void | Promise<void>;\n    writeJSON(destination: string, value: unknown): void | Promise<void>;\n}\n\nexport interface CreateProjectOptions {\n    destination: string;\n    fileSystem?: ScaffoldFileSystem;\n    jsx?: boolean;\n}\n\nconst nodeFileSystem: ScaffoldFileSystem = {\n    async copy(source, destination) {\n        await mkdir(path.dirname(destination), {recursive: true});\n        await cp(source, destination, {recursive: true});\n    },\n    async writeJSON(destination, value) {\n        await mkdir(path.dirname(destination), {recursive: true});\n        await writeFile(destination, `${JSON.stringify(value, null, 2)}\\n`);\n    }\n};\n\n/** Return the package manifest used by generated White Label projects. */\nexport function createSiteManifest() {\n    return {\n        name: 'white-label-site',\n        version: '1.0.0',\n        private: true,\n        type: 'module',\n        engines: {node: '^22.18.0 || >=24.11.0'},\n        scripts: {\n            build: 'tsc -p tsconfig.json && node dist/scripts/build.js',\n            typecheck: 'tsc -p tsconfig.json --noEmit',\n            test: 'node --run typecheck && node --run build -- --version=test --production=true --site-url=https://example.com && node --test --experimental-test-coverage --test-coverage-include=dist/app/assets/script/index.js --test-coverage-lines=100 --test-coverage-functions=100 --test-coverage-branches=100 test/*.test.js'\n        },\n        allowScripts: {\n            '@parcel/watcher@2.5.1': true,\n            'esbuild@0.28.2': true,\n            'white-label-view@5.1.0': true\n        },\n        dependenciesMeta: {\n            '@parcel/watcher@2.5.1': {built: true},\n            'esbuild@0.28.2': {built: true},\n            'white-label-view@5.1.0': {built: true}\n        },\n        devDependencies: {\n            '@tailwindcss/cli': '4.3.3',\n            '@types/node': '24.13.3',\n            'axe-core': '4.13.0',\n            'esbuild': '0.28.2',\n            'html-validate': '11.15.0',\n            'jsdom': '30.0.1',\n            'tailwindcss': '4.3.3',\n            'typescript': '7.0.2'\n        },\n        dependencies: {\n            'white-label-mediator': '4.0.0',\n            'white-label-model': '6.0.0',\n            'white-label-router': '5.0.0',\n            'white-label-view': '5.1.0'\n        }\n    };\n}\n\nconst commonNoJsxCopies = [\n    ['app/assets/data', 'app/assets/data'],\n    ['app/assets/style', 'app/assets/style'],\n    ['app/assets/script/tasks/TaskApplication.ts', 'app/assets/script/tasks/TaskApplication.ts'],\n    ['app/assets/script/tasks/TaskMediator.ts', 'app/assets/script/tasks/TaskMediator.ts'],\n    ['app/assets/script/tasks/TaskModel.ts', 'app/assets/script/tasks/TaskModel.ts'],\n    ['app/assets/script/tasks/TaskRouter.ts', 'app/assets/script/tasks/TaskRouter.ts'],\n    ['app/assets/view/examples/tasks/task-state.ts', 'app/assets/view/examples/tasks/task-state.ts'],\n    ['app/package.json', 'app/package.json']\n] as const;\n\nconst noJsxTemplateCopies = [\n    ['scaffold/no-jsx/app/index.ts', 'app/index.ts'],\n    ['scaffold/no-jsx/app/404.ts', 'app/404.ts'],\n    ['scaffold/no-jsx/app/assets/script/index.ts', 'app/assets/script/index.ts'],\n    ['scaffold/no-jsx/app/assets/script/tasks/TaskView.ts', 'app/assets/script/tasks/TaskView.ts'],\n    ['scaffold/no-jsx/app/assets/view/examples/tasks/TaskExample.ts', 'app/assets/view/examples/tasks/TaskExample.ts'],\n    ['scaffold/no-jsx/README.md', 'README.md'],\n    ['tsconfig.site.no-jsx.json', 'tsconfig.json']\n] as const;\n\n/**\n * Create a White Label project.\n *\n * This is the shared implementation behind every creation interface. Adapters\n * translate their environment into these options instead of owning templates or\n * project-generation behavior themselves.\n */\nexport async function createProject({destination, fileSystem = nodeFileSystem, jsx = true}: CreateProjectOptions) {\n    const copies = jsx ? [\n        ['.editorconfig', '.editorconfig'],\n        ['.yarnrc.yml', '.yarnrc.yml'],\n        ['pnpm-workspace.yaml', 'pnpm-workspace.yaml'],\n        ['app', 'app'],\n        ['app/README.md', 'README.md'],\n        ['server', 'server'],\n        ['scripts', 'scripts'],\n        ['template-test', 'test'],\n        ['tsconfig.site.json', 'tsconfig.json']\n    ] as const : [\n        ['.editorconfig', '.editorconfig'],\n        ['.yarnrc.yml', '.yarnrc.yml'],\n        ['pnpm-workspace.yaml', 'pnpm-workspace.yaml'],\n        ...commonNoJsxCopies,\n        ...noJsxTemplateCopies,\n        ['server', 'server'],\n        ['scripts', 'scripts'],\n        ['template-test', 'test']\n    ] as const;\n\n    for (const [source, target] of copies) {\n        await fileSystem.copy(path.join(packageRoot, source), path.join(destination, target));\n    }\n\n    await fileSystem.writeJSON(path.join(destination, 'package.json'), createSiteManifest());\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../scaffold/index.ts"],"names":[],"mappings":"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","sourcesContent":["/** @module scaffold */\nimport {cp, mkdir, readdir, writeFile} from 'node:fs/promises';\nimport path from 'node:path';\nimport {fileURLToPath} from 'node:url';\n\nconst packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');\n\nexport interface ScaffoldFileSystem {\n    copy(source: string, destination: string): void | Promise<void>;\n    writeJSON(destination: string, value: unknown): void | Promise<void>;\n}\n\nexport interface CreateProjectOptions {\n    destination: string;\n    fileSystem?: ScaffoldFileSystem;\n    jsx?: boolean;\n}\n\nconst nodeFileSystem: ScaffoldFileSystem = {\n    async copy(source, destination) {\n        await mkdir(path.dirname(destination), {recursive: true});\n        await cp(source, destination, {recursive: true});\n    },\n    async writeJSON(destination, value) {\n        await mkdir(path.dirname(destination), {recursive: true});\n        await writeFile(destination, `${JSON.stringify(value, null, 2)}\\n`);\n    }\n};\n\n/** Refuse to layer a generated project over existing user files. */\nasync function assertDestinationAvailable(destination: string) {\n    try {\n        const entries = await readdir(destination);\n        if (entries.length) {throw new Error(`Destination directory must be empty: ${destination}`);}\n    } catch (error) {\n        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {return;}\n        throw error;\n    }\n}\n\n/** Return the package manifest used by generated White Label projects. */\nexport function createSiteManifest() {\n    return {\n        name: 'white-label-site',\n        version: '1.0.0',\n        private: true,\n        type: 'module',\n        engines: {node: '^22.18.0 || >=24.11.0'},\n        scripts: {\n            build: 'tsc -p tsconfig.json && node dist/scripts/build.js',\n            typecheck: 'tsc -p tsconfig.json --noEmit',\n            test: 'node --run typecheck && node --run build -- --version=test --production=true --site-url=https://example.com && node --test --experimental-test-coverage --test-coverage-include=dist/app/assets/script/index.js --test-coverage-lines=100 --test-coverage-functions=100 --test-coverage-branches=100 test/*.test.js'\n        },\n        allowScripts: {\n            '@parcel/watcher@2.5.1': true,\n            'esbuild@0.28.2': true,\n            'white-label-view@6.0.0': true\n        },\n        dependenciesMeta: {\n            '@parcel/watcher@2.5.1': {built: true},\n            'esbuild@0.28.2': {built: true},\n            'white-label-view@6.0.0': {built: true}\n        },\n        devDependencies: {\n            '@tailwindcss/cli': '4.3.3',\n            '@types/node': '24.13.3',\n            'axe-core': '4.13.0',\n            'esbuild': '0.28.2',\n            'html-validate': '11.15.0',\n            'jsdom': '30.0.1',\n            'tailwindcss': '4.3.3',\n            'typescript': '7.0.2'\n        },\n        dependencies: {\n            'white-label-mediator': '5.0.0',\n            'white-label-model': '7.0.1',\n            'white-label-router': '6.0.0',\n            'white-label-view': '6.0.0'\n        }\n    };\n}\n\nconst commonNoJsxCopies = [\n    ['app/assets/data', 'app/assets/data'],\n    ['app/assets/style', 'app/assets/style'],\n    ['app/assets/script/tasks/TaskApplication.ts', 'app/assets/script/tasks/TaskApplication.ts'],\n    ['app/assets/script/tasks/TaskMediator.ts', 'app/assets/script/tasks/TaskMediator.ts'],\n    ['app/assets/script/tasks/TaskModel.ts', 'app/assets/script/tasks/TaskModel.ts'],\n    ['app/assets/script/tasks/TaskRouter.ts', 'app/assets/script/tasks/TaskRouter.ts'],\n    ['app/assets/view/examples/tasks/task-state.ts', 'app/assets/view/examples/tasks/task-state.ts'],\n    ['app/package.json', 'app/package.json']\n] as const;\n\nconst noJsxTemplateCopies = [\n    ['scaffold/no-jsx/app/index.ts', 'app/index.ts'],\n    ['scaffold/no-jsx/app/404.ts', 'app/404.ts'],\n    ['scaffold/no-jsx/app/assets/script/index.ts', 'app/assets/script/index.ts'],\n    ['scaffold/no-jsx/app/assets/script/tasks/TaskView.ts', 'app/assets/script/tasks/TaskView.ts'],\n    ['scaffold/no-jsx/app/assets/view/examples/tasks/TaskExample.ts', 'app/assets/view/examples/tasks/TaskExample.ts'],\n    ['scaffold/no-jsx/README.md', 'README.md'],\n    ['tsconfig.site.no-jsx.json', 'tsconfig.json']\n] as const;\n\n/**\n * Create a White Label project without overwriting a non-empty destination.\n *\n * This is the shared implementation behind every creation interface. Adapters\n * translate their environment into these options instead of owning templates,\n * overwrite policy, or project-generation behavior themselves.\n */\nexport async function createProject({destination, fileSystem = nodeFileSystem, jsx = true}: CreateProjectOptions) {\n    await assertDestinationAvailable(destination);\n    const copies = jsx ? [\n        ['.editorconfig', '.editorconfig'],\n        ['.yarnrc.yml', '.yarnrc.yml'],\n        ['pnpm-workspace.yaml', 'pnpm-workspace.yaml'],\n        ['app', 'app'],\n        ['app/README.md', 'README.md'],\n        ['server', 'server'],\n        ['scripts', 'scripts'],\n        ['template-test', 'test'],\n        ['tsconfig.site.json', 'tsconfig.json']\n    ] as const : [\n        ['.editorconfig', '.editorconfig'],\n        ['.yarnrc.yml', '.yarnrc.yml'],\n        ['pnpm-workspace.yaml', 'pnpm-workspace.yaml'],\n        ...commonNoJsxCopies,\n        ...noJsxTemplateCopies,\n        ['server', 'server'],\n        ['scripts', 'scripts'],\n        ['template-test', 'test']\n    ] as const;\n\n    for (const [source, target] of copies) {\n        await fileSystem.copy(path.join(packageRoot, source), path.join(destination, target));\n    }\n\n    await fileSystem.writeJSON(path.join(destination, 'package.json'), createSiteManifest());\n}\n"]}

package/dist/server/handler.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Provider-neutral serverless example using the Web Request/Response contract.
+ *
+ * Keep mutable White Label instances request-scoped. Cloud adapters should only
+ * translate their provider event into a Request and translate the Response back.
+ */
+export declare function handleRequest(request: Request): Promise<Response>;

package/dist/server/handler.js

@@ -0,0 +1,67 @@
+import Mediator from 'white-label-mediator';
+import { Model } from 'white-label-model';
+import Router from 'white-label-router';
+import View from 'white-label-view/server';
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+/**
+ * Provider-neutral serverless example using the Web Request/Response contract.
+ *
+ * Keep mutable White Label instances request-scoped. Cloud adapters should only
+ * translate their provider event into a Request and translate the Response back.
+ */
+export async function handleRequest(request) {
+    const url = new URL(request.url);
+    const mediator = new Mediator();
+    const model = new Model({
+        status: 404,
+        title: 'Not found',
+        message: `No route for ${url.pathname}.`
+    });
+    const router = new Router();
+    const view = new View({
+        model,
+        template(data) {
+            const state = data;
+            return `<main><h1>${escapeHtml(state.title)}</h1><p>${escapeHtml(state.message)}</p></main>`;
+        }
+    });
+    router.mediator = mediator;
+    router.routes = {
+        '/health': () => model.update({
+            status: 200,
+            title: 'Healthy',
+            message: 'Serverless request handled.'
+        }),
+        '/hello': (_scope, location) => {
+            const name = String(location.data.query.name ?? 'world');
+            return model.update({
+                status: 200,
+                title: 'Hello',
+                message: `Hello ${name}.`
+            });
+        },
+        defaultRoute: () => true
+    };
+    try {
+        router.navigate(`${url.pathname}${url.search}`);
+        view.initialize();
+        return new Response(`<!doctype html>${view.toString()}`, {
+            status: model.get().status,
+            headers: { 'content-type': 'text/html; charset=utf-8' }
+        });
+    }
+    finally {
+        view.destroy();
+        router.destroy();
+        mediator.destroy();
+        model.destroy();
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/server/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../server/handler.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAC,KAAK,EAAC,MAAM,mBAAmB,CAAC;AACxC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,yBAAyB,CAAC;AAQ3C,SAAS,UAAU,CAAC,KAAa;IAC7B,OAAO,KAAK;SACP,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgB;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACpB,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,gBAAgB,GAAG,CAAC,QAAQ,GAAG;KAC3C,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;QAClB,KAAK;QACL,QAAQ,CAAC,IAAI;YACT,MAAM,KAAK,GAAG,IAAmB,CAAC;YAClC,OAAO,aAAa,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;QACjG,CAAC;KACJ,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,MAAM,CAAC,MAAM,GAAG;QACZ,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1B,MAAM,EAAE,GAAG;YACX,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,6BAA6B;SACzC,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;YAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;YACzD,OAAO,KAAK,CAAC,MAAM,CAAC;gBAChB,MAAM,EAAE,GAAG;gBACX,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,SAAS,IAAI,GAAG;aAC5B,CAAC,CAAC;QACP,CAAC;QACD,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI;KAC3B,CAAC;IAEF,IAAI,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,QAAQ,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE;YACrD,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM;YAC1B,OAAO,EAAE,EAAC,cAAc,EAAE,0BAA0B,EAAC;SACxD,CAAC,CAAC;IACP,CAAC;YAAS,CAAC;QACP,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;AACL,CAAC","sourcesContent":["import Mediator from 'white-label-mediator';\nimport {Model} from 'white-label-model';\nimport Router from 'white-label-router';\nimport View from 'white-label-view/server';\n\ntype ServerState = {\n    status: number;\n    title: string;\n    message: string;\n};\n\nfunction escapeHtml(value: string) {\n    return value\n        .replaceAll('&', '&amp;')\n        .replaceAll('<', '&lt;')\n        .replaceAll('>', '&gt;')\n        .replaceAll('\"', '&quot;')\n        .replaceAll(\"'\", '&#39;');\n}\n\n/**\n * Provider-neutral serverless example using the Web Request/Response contract.\n *\n * Keep mutable White Label instances request-scoped. Cloud adapters should only\n * translate their provider event into a Request and translate the Response back.\n */\nexport async function handleRequest(request: Request): Promise<Response> {\n    const url = new URL(request.url);\n    const mediator = new Mediator();\n    const model = new Model({\n        status: 404,\n        title: 'Not found',\n        message: `No route for ${url.pathname}.`\n    });\n    const router = new Router();\n    const view = new View({\n        model,\n        template(data) {\n            const state = data as ServerState;\n            return `<main><h1>${escapeHtml(state.title)}</h1><p>${escapeHtml(state.message)}</p></main>`;\n        }\n    });\n\n    router.mediator = mediator;\n    router.routes = {\n        '/health': () => model.update({\n            status: 200,\n            title: 'Healthy',\n            message: 'Serverless request handled.'\n        }),\n        '/hello': (_scope, location) => {\n            const name = String(location.data.query.name ?? 'world');\n            return model.update({\n                status: 200,\n                title: 'Hello',\n                message: `Hello ${name}.`\n            });\n        },\n        defaultRoute: () => true\n    };\n\n    try {\n        router.navigate(`${url.pathname}${url.search}`);\n        view.initialize();\n        return new Response(`<!doctype html>${view.toString()}`, {\n            status: model.get().status,\n            headers: {'content-type': 'text/html; charset=utf-8'}\n        });\n    } finally {\n        view.destroy();\n        router.destroy();\n        mediator.destroy();\n        model.destroy();\n    }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-white-label",
-  "version": "8.0.0",
+  "version": "9.0.0",
   "description": "Framework-independent TypeScript project generator for accessible, SEO-friendly sites with progressive enhancement, optional JSX, and a provider-neutral serverless handler example.",
   "type": "module",
   "main": "dist/scaffold/index.js",
@@ -79,10 +79,10 @@
     "jsdom": "30.0.1",
     "tailwindcss": "4.3.3",
     "typescript": "7.0.2",
-    "white-label-mediator": "4.0.0",
-    "white-label-model": "6.0.0",
-    "white-label-router": "5.0.0",
-    "white-label-view": "5.1.0",
+    "white-label-mediator": "5.0.0",
+    "white-label-model": "7.0.1",
+    "white-label-router": "6.0.0",
+    "white-label-view": "6.0.0",
     "@babel/core": "8.0.5",
     "@babel/eslint-parser": "8.0.5",
     "@babel/plugin-syntax-jsx": "8.0.1",
@@ -97,6 +97,7 @@
       "cli/**/*.ts",
       "scripts/**/*.ts",
       "scaffold/**/*.ts",
+      "server/**/*.ts",
       "app/**/*.ts",
       "app/**/*.tsx"
     ],

package/scaffold/AGENTS.md

@@ -0,0 +1,18 @@
+# generator-white-label scaffold instructions
+
+These instructions are more specific than the repository-root agent guide for files under `scaffold/`.
+
+## Generator 9 creation contract
+
+- `createProject()` is the canonical project-creation engine. CLI and future adapters must call it rather than reimplement scaffold copying or policy.
+- Destination safety belongs in `createProject()`: missing and empty destinations are allowed; an existing non-empty destination must be rejected before scaffold files are copied or package metadata is written.
+- Do not add a force/overwrite path unless the user explicitly requests and approves that product change.
+- JSX and no-JSX scaffolds must preserve equivalent White Label architecture and core behavior. JSX is a rendering-syntax choice, not a capability tier.
+- Keep third-party template engines application-owned. Start those integrations from the no-JSX scaffold; do not add renderer-specific adapters or runtime dependencies to the generator without an explicit requirement.
+- Generated JSX uses the `white-label-view` trust contract: ordinary text/attributes are HTML-escaped, intrinsic `on*` handlers are not supported, and URL/CSS semantics remain application validation concerns.
+- Keep generated serverless examples provider-neutral and request-scoped. Do not make Express, a cloud provider SDK, or mutable module-level request state a requirement.
+- Do not hand-edit dependency lockfiles. Regenerate them with the package manager only after the coordinated runtime versions actually exist in the registry.
+
+## Coordinated release dependency
+
+Generator 9 targets `white-label-mediator@5`, `white-label-model@7`, `white-label-router@6`, and `white-label-view@6`. Registry installation failures for unpublished target versions are a real release gate; do not bypass them with Git references in the release lockfile.

package/scaffold/index.ts

@@ -1,5 +1,5 @@
 /** @module scaffold */
-import {cp, mkdir, writeFile} from 'node:fs/promises';
+import {cp, mkdir, readdir, writeFile} from 'node:fs/promises';
 import path from 'node:path';
 import {fileURLToPath} from 'node:url';
 
@@ -27,6 +27,17 @@ const nodeFileSystem: ScaffoldFileSystem = {
     }
 };
 
+/** Refuse to layer a generated project over existing user files. */
+async function assertDestinationAvailable(destination: string) {
+    try {
+        const entries = await readdir(destination);
+        if (entries.length) {throw new Error(`Destination directory must be empty: ${destination}`);}
+    } catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {return;}
+        throw error;
+    }
+}
+
 /** Return the package manifest used by generated White Label projects. */
 export function createSiteManifest() {
     return {
@@ -43,12 +54,12 @@ export function createSiteManifest() {
         allowScripts: {
             '@parcel/watcher@2.5.1': true,
             'esbuild@0.28.2': true,
-            'white-label-view@5.1.0': true
+            'white-label-view@6.0.0': true
         },
         dependenciesMeta: {
             '@parcel/watcher@2.5.1': {built: true},
             'esbuild@0.28.2': {built: true},
-            'white-label-view@5.1.0': {built: true}
+            'white-label-view@6.0.0': {built: true}
         },
         devDependencies: {
             '@tailwindcss/cli': '4.3.3',
@@ -61,10 +72,10 @@ export function createSiteManifest() {
             'typescript': '7.0.2'
         },
         dependencies: {
-            'white-label-mediator': '4.0.0',
-            'white-label-model': '6.0.0',
-            'white-label-router': '5.0.0',
-            'white-label-view': '5.1.0'
+            'white-label-mediator': '5.0.0',
+            'white-label-model': '7.0.1',
+            'white-label-router': '6.0.0',
+            'white-label-view': '6.0.0'
         }
     };
 }
@@ -91,13 +102,14 @@ const noJsxTemplateCopies = [
 ] as const;
 
 /**
- * Create a White Label project.
+ * Create a White Label project without overwriting a non-empty destination.
  *
  * This is the shared implementation behind every creation interface. Adapters
- * translate their environment into these options instead of owning templates or
- * project-generation behavior themselves.
+ * translate their environment into these options instead of owning templates,
+ * overwrite policy, or project-generation behavior themselves.
  */
 export async function createProject({destination, fileSystem = nodeFileSystem, jsx = true}: CreateProjectOptions) {
+    await assertDestinationAvailable(destination);
     const copies = jsx ? [
         ['.editorconfig', '.editorconfig'],
         ['.yarnrc.yml', '.yarnrc.yml'],

package/scaffold/no-jsx/README.md

@@ -34,6 +34,32 @@ pnpm build
 pnpm test
 ```
 
+## Simple View click event
+
+View lifecycle hooks can own a browser listener directly:
+
+```ts
+import View from 'white-label-view';
+
+class ButtonView extends View {
+    handleClick = () => {
+        console.log('Clicked');
+    };
+
+    addListeners() {
+        this.element.addEventListener('click', this.handleClick);
+        return this;
+    }
+
+    removeListeners() {
+        this.element.removeEventListener('click', this.handleClick);
+        return this;
+    }
+}
+```
+
+The same callback reference is used for both registration and cleanup. View calls `removeListeners()` before replacement or destruction.
+
 ## Serverless / function runtimes
 
 `server/handler.ts` is the same provider-neutral serverless example included in the JSX scaffold. It uses Web `Request` and `Response`, request-scoped Model/View/Router/Mediator instances, and the server View entrypoint; it does not require JSX or a provider SDK.

package/template-test/site.test.js

@@ -141,7 +141,9 @@ test('all client packages cooperate through the task application without losing
 
     assert.equal(normalizeTaskFilter('nope'), 'all');
     application.destroy();
-    assert.equal(application.mediator.listenerCount('task:add'), 0);
+    assert.deepEqual(application.model.get(), {});
+    application.mediator.dispatchEvent(new CustomEvent('task:add', {detail: 'Ignored after destroy'}));
+    assert.deepEqual(application.model.get(), {});
 });
 
 test('serverless handler keeps warm and concurrent requests isolated', async () => {