@aurelia/storybook 2.1.0 → 2.3.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+## [2.3.0](https://github.com/aurelia/storybook/compare/v2.2.1...v2.3.0) (2026-06-02)
+
+### Features
+
+* **package:** update storybook and deps ([a79e567](https://github.com/aurelia/storybook/commit/a79e5674fe13b8ebe0eb6542d03f4b6742196ff9))
+
+## [2.2.1](https://github.com/aurelia/storybook/compare/2.1.0...2.2.1) (2026-01-23)
+
+### Features
+
+* **storybook:** update packages, tooling, rsbuild support ([3a97a99](https://github.com/aurelia/storybook/commit/3a97a9950693183b5880756a943e620895f9457b))

package/README.md

@@ -1,23 +1,23 @@
 # @aurelia/storybook
 
-> **Note:** Storybook support is still early-stage. Expect a few rough edges while Aurelia 2 finishes its beta cycle, and please report anything that feels off.
+> **Note:** Storybook support is still release-candidate stage. Please report anything that feels off while Aurelia 2 and Storybook 10 continue to settle.
 
-`@aurelia/storybook` is the glue between Aurelia 2 components and Storybook 10. It wires Aurelia's `enhance()` API into Storybook's rendering pipeline so you can preview, test, and document your components with either the Vite or Webpack builders.
+`@aurelia/storybook` is the glue between Aurelia 2 components and Storybook 10. It wires an Aurelia app into Storybook's rendering pipeline so you can preview, test, and document your components with Vite, Webpack, or Rsbuild/Rspack.
 
 ## Compatibility at a Glance
 
 | Item | Supported versions | Notes |
 | --- | --- | --- |
-| Storybook | 10.x (ESM) | Tested with 10.0.5+; works with `storybook dev`/`storybook build` commands. |
-| Aurelia | 2.0.0-beta.25+ | Uses Aurelia's `enhance()` APIs under the hood. |
-| Bundlers | `@storybook/builder-vite` (Vite 5) · `@storybook/builder-webpack5` | Pick whichever matches your app; both share the same Aurelia preview runtime. |
+| Storybook | 10.x (ESM) | Tested with 10.4.x; works with `storybook dev`/`storybook build` commands. |
+| Aurelia | 2.0.0-rc.1+ | Uses Aurelia's app APIs under the hood. |
+| Bundlers | `@storybook/builder-vite` (Vite 5-8) · `@storybook/builder-webpack5` · `storybook-builder-rsbuild` (Rsbuild/Rspack) | Pick whichever matches your app; they share the same Aurelia preview runtime. |
 | Node.js | ≥ 20.19.0 or ≥ 22.12.0 | Matches the engines field in `package.json` and Storybook 10's baseline.
 
 ## Requirements
 
-- An Aurelia 2 application (TypeScript or JavaScript) already set up with either Vite or Webpack.
+- An Aurelia 2 application (TypeScript or JavaScript) already set up with Vite, Webpack, or Rsbuild/Rspack.
 - Storybook 10.x installed in the project. (Run `npx storybook@latest init` if you are starting fresh.)
-- The peer dependencies listed in [`package.json`](package.json) that align with the Aurelia 2 beta train you are targeting.
+- The peer dependencies listed in [`package.json`](package.json) that align with the Aurelia 2 release-candidate train you are targeting.
 
 ## Installation
 
@@ -25,6 +25,8 @@
 npm install --save-dev @aurelia/storybook storybook @storybook/builder-vite
 # or, for Webpack builds:
 npm install --save-dev @aurelia/storybook storybook @storybook/builder-webpack5
+# or, for Rsbuild/Rspack builds:
+npm install --save-dev @aurelia/storybook storybook storybook-builder-rsbuild @rsbuild/core
 ```
 
 Add whichever addons you need (`@storybook/addon-links`, `@storybook/addon-actions`, etc.). Essentials functionality now ships with Storybook 10 core, so most projects only add optional extras.
@@ -43,7 +45,7 @@ Add whichever addons you need (`@storybook/addon-links`, `@storybook/addon-actio
 
    const config: StorybookConfig & { viteFinal?: (config: InlineConfig) => InlineConfig | Promise<InlineConfig> } = {
      stories: ['../src/stories/**/*.stories.@(ts|tsx|js|jsx|mdx)'],
-     addons: ['@storybook/addon-links'],
+     addons: [],
      framework: {
        name: '@aurelia/storybook',
        options: {},
@@ -52,7 +54,7 @@ Add whichever addons you need (`@storybook/addon-links`, `@storybook/addon-actio
        builder: '@storybook/builder-vite',
      },
      viteFinal: async (viteConfig) => {
-       // Ensure problematic Aurelia deps are excluded from pre-bundling.
+       // Optional: extend this when your app needs extra Vite config.
        viteConfig.optimizeDeps = viteConfig.optimizeDeps ?? {};
        viteConfig.optimizeDeps.exclude = Array.from(new Set([...(viteConfig.optimizeDeps.exclude ?? []), '@aurelia/runtime-html']));
 
@@ -67,8 +69,7 @@ Add whichever addons you need (`@storybook/addon-links`, `@storybook/addon-actio
    export default config;
    ```
 
-   - Excluding `@aurelia/runtime-html` keeps Vite from trying to pre-bundle Aurelia's DOM runtime, which is already ESM friendly.
-   - The `define` shim avoids `process is not defined` errors when Storybook code (or Aurelia plugins) look for `process.env.NODE_ENV` in the preview iframe.
+   The Aurelia preset already excludes `@aurelia/runtime-html` from pre-bundling and defines `process.env.NODE_ENV`; keep a `viteFinal` hook only when your app needs to merge additional Vite settings.
 
 3. **Create `.storybook/preview.ts`:**
 
@@ -100,7 +101,7 @@ Add whichever addons you need (`@storybook/addon-links`, `@storybook/addon-actio
 
    const config: StorybookConfig = {
      stories: ['../src/**/*.stories.@(ts|tsx|js|jsx|mdx)'],
-     addons: ['@storybook/addon-links'],
+     addons: [],
      framework: {
        name: '@aurelia/storybook',
        options: {},
@@ -119,6 +120,37 @@ Add whichever addons you need (`@storybook/addon-links`, `@storybook/addon-actio
 
 ---
 
+## Quick Start (Rsbuild/Rspack Builder)
+
+1. Install `storybook-builder-rsbuild` and `@rsbuild/core`.
+2. Create `.storybook/main.ts`:
+
+   ```ts
+   import type { StorybookConfig } from 'storybook/internal/types';
+
+   const config: StorybookConfig = {
+     stories: ['../src/**/*.stories.@(ts|tsx|js|jsx|mdx)'],
+     addons: [],
+     framework: {
+       name: '@aurelia/storybook',
+       options: {},
+     },
+     core: {
+       builder: 'storybook-builder-rsbuild',
+     },
+   };
+
+   export default config;
+   ```
+
+   The Aurelia preset injects `@aurelia/webpack-loader` via `rsbuildFinal`,
+   so most projects do not need extra Rsbuild configuration. If you do, add your own `rsbuildFinal`
+   and merge with `@rsbuild/core`'s `mergeRsbuildConfig`.
+
+3. Reuse the same `.storybook/preview.ts` and `package.json` scripts as in the Vite quick start.
+
+---
+
 ## Writing Aurelia Stories
 
 Story files look exactly like standard Storybook CSF stories. The framework export automatically:
@@ -178,6 +210,22 @@ export const WithCustomTemplate = {
 };
 ```
 
+### Helper for Typed Story Results
+
+If you want stronger typing (especially for `props`), you can use the helper and types exported by the package:
+
+```ts
+import { defineAureliaStory, type AureliaStoryResult } from '@aurelia/storybook';
+
+const render = (args: { title: string }): AureliaStoryResult<{ title: string }> =>
+  defineAureliaStory({
+    template: `<my-card title.bind="title"></my-card>`,
+    props: args,
+  });
+```
+
+You can also import directly from `@aurelia/storybook/preview` or `@aurelia/storybook/preview/types` if you prefer.
+
 ### Story Result Contract
 
 When you provide a custom `render` function, return an object with any of the following fields. The Aurelia runtime consumes them while creating the preview app:
@@ -220,10 +268,122 @@ export const WithServices = {
 
 Because the Aurelia app lives for the lifetime of the story iframe, DI registrations persist until the story is torn down or Storybook forces a remount. If you need a clean state between stories, set `parameters: { forceRemount: true }` on the story or click the *Remount component* toolbar button in Storybook.
 
+### Global Aurelia Configuration (Preview + Story Parameters)
+
+You can register global resources/plugins and customize the DI container via Storybook parameters. The framework reads `parameters.aurelia` from the merged Storybook context (preview + component + story):
+
+```ts
+// .storybook/preview.ts
+import { Registration } from 'aurelia';
+import { CurrencyValueConverter } from '../src/resources/currency';
+import { FeatureFlags } from '../src/services/feature-flags';
+
+export const parameters = {
+  aurelia: {
+    register: [CurrencyValueConverter],
+    configureContainer: (container) => {
+      container.register(Registration.instance(FeatureFlags, { beta: true }));
+    },
+  },
+};
+```
+
+You can also override or extend per story:
+
+```ts
+export const WithOverrides = {
+  parameters: {
+    aurelia: {
+      configureContainer: (container) => {
+        container.register(Registration.instance('apiBaseUrl', 'https://staging.example.com'));
+      },
+    },
+  },
+};
+```
+
+These hooks run when the Aurelia app is created. If you rely on different container setups per story, use `parameters: { forceRemount: true }` to ensure a fresh app instance.
+
+#### Parameters API (Quick Reference)
+
+```ts
+export const parameters = {
+  aurelia: {
+    // Register global resources/plugins
+    register: [MyElement, MyValueConverter],
+    // Optional aliases for parity with story results
+    components: [MyElement],
+    items: [Registration.instance(MyService, new MyService())],
+    // Configure the DI container
+    configureContainer: (container, context) => {
+      // ...
+    },
+    // Configure the Aurelia instance
+    configure: (aurelia, context) => {
+      // ...
+    },
+  },
+};
+```
+
+## Cookbook
+
+### 1) Register global resources once
+
+```ts
+// .storybook/preview.ts
+import { Registration } from 'aurelia';
+import { CurrencyValueConverter } from '../src/resources/currency';
+import { FeatureFlags } from '../src/services/feature-flags';
+
+export const parameters = {
+  aurelia: {
+    register: [CurrencyValueConverter],
+    configureContainer: (container) => {
+      container.register(Registration.instance(FeatureFlags, { beta: true }));
+    },
+  },
+};
+```
+
+### 2) Mock a service per story
+
+```ts
+import { Registration } from 'aurelia';
+import { IWeatherService } from '../src/services/weather-service';
+
+export const WithMockedService = {
+  render: (args) =>
+    defineAureliaStory({
+      template: `<weather-widget location.bind="location"></weather-widget>`,
+      props: args,
+      items: [
+        Registration.instance(IWeatherService, {
+          getWeather: async () => ({ location: 'Seattle', condition: 'Sunny' }),
+        }),
+      ],
+    }),
+};
+```
+
+### 3) Force a clean DI container per story
+
+```ts
+export const CleanState = {
+  parameters: { forceRemount: true },
+  render: (args) =>
+    defineAureliaStory({
+      template: `<my-component value.bind="value"></my-component>`,
+      props: args,
+    }),
+};
+```
+
 ## Example Apps Inside This Repo
 
 - `apps/hello-world` – Vite-based Aurelia starter that consumes `@aurelia/storybook`.
 - `apps/hello-world-webpack` – Equivalent Webpack example.
+- `apps/hello-world-rsbuild` – Rsbuild/Rspack example for projects using `storybook-builder-rsbuild`.
 
 To try them out:
 
@@ -235,6 +395,10 @@ npm run storybook
 cd ../hello-world-webpack
 npm install
 npm run storybook
+
+cd ../hello-world-rsbuild
+npm install
+npm run storybook
 ```
 
 Each sample project now includes a small library of showcase stories you can open in Storybook to see different aspects of the integration:
@@ -265,6 +429,25 @@ This repository publishes the Storybook framework itself. Helpful scripts:
 
 While developing, you can link the package into one of the sample apps in `apps/` to manual-test Storybook changes end to end.
 
+## Releases & Changelog
+
+- Keep `CHANGELOG.md` updated for each release (use the **Unreleased** section while working).
+- Align example app versions with the root package before tagging:
+  - `npm run sync:versions`
+- Tag releases as `vX.Y.Z` so the publish workflow can run.
+
+Publish flow (automated via GitHub Actions):
+1. Update `package.json` version.
+2. Generate `CHANGELOG.md` from conventional commits: `npm run changelog`.
+3. Run `npm run sync:versions` and commit changes.
+4. Create tag `vX.Y.Z` and push it.
+
+## Troubleshooting
+
+- **AUR0153 duplicate element registration**: ensure the same component isn't registered multiple times within the same story/container.
+- **Args undefined during first render**: defensively handle optional args in components (e.g., fallbacks for arrays/strings).
+- **Rsbuild `loader.loadModule is not a function`**: avoid `ts-loader` in Rsbuild/Rspack builds; use the built-in Rsbuild TS handling.
+
 ## Contributing
 
 Bug reports, docs tweaks, and feature PRs are all welcome. Please open an issue to discuss significant changes, and spin up one of the example apps to verify the behavior you are touching.

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { renderToCanvas } from './preview/render';
+import { defineAureliaStory } from './preview/helpers';
+export { renderToCanvas };
+export declare const render: typeof renderToCanvas;
+export { defineAureliaStory };
+export type { AureliaRenderer, AureliaStoryResult, AureliaArgsStoryFn, AureliaRenderContext, AureliaStoryContext, AureliaParameters, AureliaStoryParameters } from './preview/types';
+export declare const framework: {
+    name: string;
+    options: {};
+};
+export declare const frameworkOptions: {
+    builder: {
+        name: string;
+        options: {};
+    };
+};
+export declare const aureliaFramework: {
+    name: string;
+    options: {};
+    builder: string;
+};
+export declare const externals: {
+    react: string;
+    'react-dom': string;
+};

package/dist/index.js

@@ -1,14 +1,36 @@
 import Aurelia, { CustomElement } from 'aurelia';
 
-// Track Aurelia apps for cleanup
 const appMap = new Map();
-async function teardown(element) {
-    if (appMap.has(element)) {
-        const app = appMap.get(element);
-        if (app) {
-            await app.stop();
-            appMap.delete(element);
-        }
+function mergeStoryProps(parameters, storyArgs, storyProps) {
+    return { ...parameters?.args, ...storyArgs, ...storyProps };
+}
+function getAureliaParameters(storyContext) {
+    const parameters = storyContext?.parameters?.aurelia;
+    if (!parameters || typeof parameters !== 'object') {
+        return undefined;
+    }
+    return parameters;
+}
+function normalizeRegistrations(parameters) {
+    if (!parameters) {
+        return [];
+    }
+    const register = Array.isArray(parameters.register) ? parameters.register : [];
+    const components = Array.isArray(parameters.components) ? parameters.components : [];
+    const items = Array.isArray(parameters.items) ? parameters.items : [];
+    return [...register, ...components, ...items].filter(Boolean);
+}
+async function teardown(element, expectedApp) {
+    const mounted = appMap.get(element);
+    if (!mounted) {
+        return;
+    }
+    if (expectedApp && mounted.app !== expectedApp) {
+        return;
+    }
+    appMap.delete(element);
+    if (typeof mounted.app?.stop === 'function') {
+        await mounted.app.stop();
     }
 }
 async function renderToCanvas({ storyFn, title, name, showMain, showError, storyContext, forceRemount, }, canvasElement, bootstrapAppFn) {
@@ -31,10 +53,10 @@ async function renderToCanvas({ storyFn, title, name, showMain, showError, story
     // All app instances are now tracked by the *root* element, ensuring we only ever have one per story iframe
     const appBootstrapFn = bootstrapAppFn ?? createAureliaApp;
     const { parameters, component, args } = storyContext;
-    let app = appMap.get(rootElement);
+    const storyId = storyContext.id ?? `${title}--${name}`;
+    const mounted = appMap.get(rootElement);
+    let app = mounted?.app;
     const story = storyFn();
-    // Temporary debug logging
-    console.log(`[DEBUG] Story: ${name}, forceRemount: ${forceRemount}, hasExistingApp: ${!!app}, canvasId: ${canvasElement.className}`);
     if (!story) {
         showError({
             title: `Expecting an Aurelia component from the story: "${name}" of "${title}".`,
@@ -45,44 +67,87 @@ async function renderToCanvas({ storyFn, title, name, showMain, showError, story
         });
         return () => { };
     }
+    if (!component && !story.template) {
+        showError({
+            title: `Expecting a template or component from the story: "${name}" of "${title}".`,
+            description: `
+        Provide a component on the default export or return "{ template: '<custom-component></custom-component>' }" from the story.
+      `,
+        });
+        return () => { };
+    }
     showMain();
-    if (!app || forceRemount) {
+    const shouldRemount = !app || forceRemount || mounted?.id !== storyId;
+    if (shouldRemount) {
         if (forceRemount && app) {
-            await teardown(rootElement);
+            await teardown(rootElement, app);
+            app = undefined;
+        }
+        if (mounted?.id !== storyId && app) {
+            await teardown(rootElement, app);
             app = undefined;
         }
         // Clear container before mounting new app
         hostElement.innerHTML = '';
-        const mergedProps = { ...parameters?.args, ...args, ...story.props };
-        const aureliaApp = appBootstrapFn(story, mergedProps, hostElement, component);
+        const mergedProps = mergeStoryProps(parameters, args, story.props);
+        const aureliaApp = appBootstrapFn(story, mergedProps, hostElement, component, storyContext);
         await aureliaApp.start();
-        appMap.set(rootElement, aureliaApp);
+        appMap.set(rootElement, { id: storyId, app: aureliaApp });
         app = aureliaApp;
     }
     else {
         // update existing app props
-        const mergedProps = { ...parameters?.args, ...args, ...story.props };
+        const mergedProps = mergeStoryProps(parameters, args, story.props);
         if (app?.root?.controller?.viewModel) {
             Object.assign(app.root.controller.viewModel, mergedProps);
         }
     }
     // Return cleanup fn
+    const appForCleanup = app;
     return async () => {
-        await teardown(rootElement);
+        await teardown(rootElement, appForCleanup);
     };
 }
-function createAureliaApp(story, args, domElement, component) {
+function createAureliaApp(story, args, domElement, component, storyContext) {
     const aurelia = new Aurelia(story.container);
-    if (story.items?.length) {
-        aurelia.register(...story.items);
+    const { container } = aurelia;
+    const aureliaParameters = getAureliaParameters(storyContext);
+    const registerIfNeeded = (resource) => {
+        if (!resource) {
+            return;
+        }
+        if (CustomElement.isType(resource)) {
+            const definition = CustomElement.getDefinition(resource);
+            if (container.has(definition.key, false)) {
+                return;
+            }
+        }
+        aurelia.register(resource);
+    };
+    const registerAll = (resources) => {
+        if (!resources?.length) {
+            return;
+        }
+        for (const resource of resources) {
+            registerIfNeeded(resource);
+        }
+    };
+    if (aureliaParameters?.configureContainer && storyContext) {
+        aureliaParameters.configureContainer(container, storyContext);
     }
-    if (story.components?.length) {
-        aurelia.register(...story.components);
+    registerAll(normalizeRegistrations(aureliaParameters));
+    registerAll(story.items);
+    const storyComponents = (story.components ?? []).filter(Boolean);
+    const dedupedComponents = component
+        ? storyComponents.filter((entry) => entry !== component)
+        : storyComponents;
+    for (const entry of dedupedComponents) {
+        registerIfNeeded(entry);
     }
     let { template } = story;
     if (component) {
         template = template ?? createComponentTemplate(component, story.innerHtml);
-        aurelia.register(component);
+        registerIfNeeded(component);
     }
     const App = CustomElement.define({
         name: 'sb-app',
@@ -91,6 +156,9 @@ function createAureliaApp(story, args, domElement, component) {
     }, class {
     });
     const app = Object.assign(new App(), args);
+    if (aureliaParameters?.configure && storyContext) {
+        aureliaParameters.configure(aurelia, storyContext);
+    }
     return aurelia.app({
         host: domElement,
         component: app,
@@ -98,9 +166,15 @@ function createAureliaApp(story, args, domElement, component) {
 }
 function createComponentTemplate(component, innerHtml) {
     const def = CustomElement.getDefinition(component);
-    return `<${def.name} ${Object.values(def.bindables)
+    const bindings = Object.values(def.bindables ?? {})
         .map((bindable) => `${bindable.attribute}.bind="${bindable.name}"`)
-        .join(' ')}>${innerHtml ?? ''}</${def.name}>`;
+        .join(' ');
+    const bindingAttributes = bindings ? ` ${bindings}` : '';
+    return `<${def.name}${bindingAttributes}>${innerHtml ?? ''}</${def.name}>`;
+}
+
+function defineAureliaStory(story) {
+    return story;
 }
 
 const render = renderToCanvas;
@@ -128,5 +202,5 @@ const externals = {
     'react-dom': 'ReactDOM'
 };
 
-export { aureliaFramework, externals, framework, frameworkOptions, render, renderToCanvas };
+export { aureliaFramework, defineAureliaStory, externals, framework, frameworkOptions, render, renderToCanvas };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/preview/render.ts","../src/index.ts"],"sourcesContent":["import { STORY_CHANGED } from 'storybook/internal/core-events';\nimport type { RenderContext, ArgsStoryFn } from 'storybook/internal/types';\nimport type { AureliaRenderer } from './types';\nimport Aurelia, { Constructable, CustomElement } from 'aurelia';\n\ninterface AureliaStoryResult {\n  template: string;\n  components?: unknown[];\n  Component?: unknown;\n  container?: any;\n  items?: unknown[];\n  innerHtml?: string;\n  props?: Record<string, any>;\n}\n\n// Track Aurelia apps for cleanup\nconst appMap = new Map<HTMLElement, any>();\n\nasync function teardown(element: HTMLElement) {\n  if (appMap.has(element)) {\n    const app = appMap.get(element);\n    if (app) {\n      await app.stop();\n      appMap.delete(element);\n    }\n  }\n}\n\nexport const render: ArgsStoryFn<AureliaRenderer> = (args, context) => {\n  const { id, component: Component } = context;\n  \n  if (!Component) {\n    throw new Error(\n      `Unable to render story ${id} as the component annotation is missing from the default export`\n    );\n  }\n  return { Component, props: args, template: '' };\n};\n\nexport async function renderToCanvas(\n  {\n    storyFn,\n    title,\n    name,\n    showMain,\n    showError,\n    storyContext,\n    forceRemount,\n  }: RenderContext<AureliaRenderer>,\n  canvasElement: HTMLElement,\n  bootstrapAppFn?: typeof createAureliaApp\n) {\n  // Store reference to the original storybook root element\n  const rootElement = canvasElement;\n\n  // Ensure we have (or create) a single container inside the root where the Aurelia app actually renders\n  let hostElement: HTMLElement;\n  if (rootElement.id === 'storybook-root') {\n    hostElement = rootElement.querySelector('.aurelia-story-container') as HTMLElement;\n    if (!hostElement) {\n      hostElement = document.createElement('div');\n      hostElement.className = 'aurelia-story-container';\n      hostElement.style.height = '100%';\n      rootElement.appendChild(hostElement);\n    }\n  } else {\n    hostElement = rootElement;\n  }\n\n  // All app instances are now tracked by the *root* element, ensuring we only ever have one per story iframe\n  const appBootstrapFn = bootstrapAppFn ?? createAureliaApp;\n  const { parameters, component, args } = storyContext;\n  \n  let app = appMap.get(rootElement);\n  const story = storyFn() as AureliaStoryResult;\n  \n  // Temporary debug logging\n  console.log(`[DEBUG] Story: ${name}, forceRemount: ${forceRemount}, hasExistingApp: ${!!app}, canvasId: ${canvasElement.className}`);\n\n  if (!story) {\n    showError({\n      title: `Expecting an Aurelia component from the story: \"${name}\" of \"${title}\".`,\n      description: `\n        Did you forget to return the Aurelia component from the story?\n        Use \"() => ({ template: '<custom-component></custom-component>' })\" when defining the story.\n      `,\n    });\n    return () => {};\n  }\n\n  showMain();\n\n  if (!app || forceRemount) {\n    if (forceRemount && app) {\n      await teardown(rootElement);\n      app = undefined;\n    }\n    // Clear container before mounting new app\n    hostElement.innerHTML = '';\n\n    const mergedProps = { ...parameters?.args, ...args, ...story.props };\n\n    const aureliaApp = appBootstrapFn(\n      story,\n      mergedProps,\n      hostElement,\n      component as Constructable\n    );\n    await aureliaApp.start();\n    appMap.set(rootElement, aureliaApp);\n    app = aureliaApp;\n  } else {\n    // update existing app props\n    const mergedProps = { ...parameters?.args, ...args, ...story.props };\n    if (app?.root?.controller?.viewModel) {\n      Object.assign(app.root.controller.viewModel, mergedProps);\n    }\n  }\n\n  // Return cleanup fn\n  return async () => {\n    await teardown(rootElement);\n  };\n}\n\nexport function createAureliaApp(\n  story: AureliaStoryResult,\n  args: Record<string, any>,\n  domElement: HTMLElement,\n  component?: Constructable\n) {\n  const aurelia = new Aurelia(story.container);\n\n  if (story.items?.length) {\n    aurelia.register(...story.items);\n  }\n\n  if (story.components?.length) {\n    aurelia.register(...story.components);\n  }\n\n  let { template } = story;\n\n  if (component) {\n    template = template ?? createComponentTemplate(component, story.innerHtml);\n    aurelia.register(component);\n  }\n\n  const App = CustomElement.define(\n    {\n      name: 'sb-app',\n      template,\n      containerless: true,\n    },\n    class {}\n  );\n\n  const app = Object.assign(new App(), args);\n\n  return aurelia.app({\n    host: domElement,\n    component: app,\n  });\n}\n\nexport function createComponentTemplate(\n  component: Constructable,\n  innerHtml?: string\n): string {\n  const def = CustomElement.getDefinition(component);\n\n  return `<${def.name} ${Object.values(def.bindables)\n    .map((bindable) => `${bindable.attribute}.bind=\"${bindable.name}\"`)\n    .join(' ')}>${innerHtml ?? ''}</${def.name}>`;\n}","import type { StorybookConfig } from 'storybook/internal/types';\nimport { renderToCanvas } from './preview/render';\n\nexport { renderToCanvas };\nexport const render = renderToCanvas;\n\n// Define the framework\nexport const framework = {\n  name: '@aurelia/storybook',\n  options: {}\n};\n\n// Framework configuration for Storybook\nexport const frameworkOptions = {\n  builder: {\n    name: '@storybook/builder-vite',\n    options: {}\n  }\n};\n\n// Export a complete framework configuration\nexport const aureliaFramework = {\n  name: '@aurelia/storybook',\n  options: {},\n  builder: '@storybook/builder-vite'\n};\n\n// Provide external dependencies configuration\nexport const externals = {\n  'react': 'React',\n  'react-dom': 'ReactDOM'\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/preview/render.ts","../src/preview/helpers.ts","../src/index.ts"],"sourcesContent":["import type { RenderContext, ArgsStoryFn } from './storybook-types';\nimport type {\n  AureliaRenderer,\n  AureliaStoryResult,\n  AureliaParameters,\n  AureliaStoryContext,\n} from './types';\nimport Aurelia, { Constructable, CustomElement } from 'aurelia';\n\ninterface MountedAureliaApp {\n  id?: string;\n  app: any;\n}\n\nconst appMap = new Map<HTMLElement, MountedAureliaApp>();\n\nfunction mergeStoryProps(\n  parameters: { args?: Record<string, any> } | undefined,\n  storyArgs: Record<string, any> | undefined,\n  storyProps: Record<string, any> | undefined\n) {\n  return { ...parameters?.args, ...storyArgs, ...storyProps };\n}\n\nfunction getAureliaParameters(\n  storyContext?: AureliaStoryContext\n): AureliaParameters | undefined {\n  const parameters = storyContext?.parameters?.aurelia;\n  if (!parameters || typeof parameters !== 'object') {\n    return undefined;\n  }\n  return parameters as AureliaParameters;\n}\n\nfunction normalizeRegistrations(\n  parameters: AureliaParameters | undefined\n): unknown[] {\n  if (!parameters) {\n    return [];\n  }\n\n  const register = Array.isArray(parameters.register) ? parameters.register : [];\n  const components = Array.isArray(parameters.components) ? parameters.components : [];\n  const items = Array.isArray(parameters.items) ? parameters.items : [];\n\n  return [...register, ...components, ...items].filter(Boolean);\n}\n\nasync function teardown(element: HTMLElement, expectedApp?: any) {\n  const mounted = appMap.get(element);\n  if (!mounted) {\n    return;\n  }\n\n  if (expectedApp && mounted.app !== expectedApp) {\n    return;\n  }\n\n  appMap.delete(element);\n\n  if (typeof mounted.app?.stop === 'function') {\n    await mounted.app.stop();\n  }\n}\n\nexport const render: ArgsStoryFn<AureliaRenderer> = (args, context) => {\n  const { id, component: Component } = context;\n  \n  if (!Component) {\n    const label = context.title && context.name ? `${context.title} / ${context.name}` : id;\n    throw new Error(\n      `Unable to render story ${label} as the component annotation is missing from the default export`\n    );\n  }\n  return { Component, props: args };\n};\n\nexport async function renderToCanvas(\n  {\n    storyFn,\n    title,\n    name,\n    showMain,\n    showError,\n    storyContext,\n    forceRemount,\n  }: RenderContext<AureliaRenderer>,\n  canvasElement: HTMLElement,\n  bootstrapAppFn?: typeof createAureliaApp\n) {\n  // Store reference to the original storybook root element\n  const rootElement = canvasElement;\n\n  // Ensure we have (or create) a single container inside the root where the Aurelia app actually renders\n  let hostElement: HTMLElement;\n  if (rootElement.id === 'storybook-root') {\n    hostElement = rootElement.querySelector('.aurelia-story-container') as HTMLElement;\n    if (!hostElement) {\n      hostElement = document.createElement('div');\n      hostElement.className = 'aurelia-story-container';\n      hostElement.style.height = '100%';\n      rootElement.appendChild(hostElement);\n    }\n  } else {\n    hostElement = rootElement;\n  }\n\n  // All app instances are now tracked by the *root* element, ensuring we only ever have one per story iframe\n  const appBootstrapFn = bootstrapAppFn ?? createAureliaApp;\n  const { parameters, component, args } = storyContext;\n  const storyId = storyContext.id ?? `${title}--${name}`;\n  \n  const mounted = appMap.get(rootElement);\n  let app = mounted?.app;\n  const story = storyFn() as AureliaStoryResult;\n  \n  if (!story) {\n    showError({\n      title: `Expecting an Aurelia component from the story: \"${name}\" of \"${title}\".`,\n      description: `\n        Did you forget to return the Aurelia component from the story?\n        Use \"() => ({ template: '<custom-component></custom-component>' })\" when defining the story.\n      `,\n    });\n    return () => {};\n  }\n\n  if (!component && !story.template) {\n    showError({\n      title: `Expecting a template or component from the story: \"${name}\" of \"${title}\".`,\n      description: `\n        Provide a component on the default export or return \"{ template: '<custom-component></custom-component>' }\" from the story.\n      `,\n    });\n    return () => {};\n  }\n\n  showMain();\n\n  const shouldRemount = !app || forceRemount || mounted?.id !== storyId;\n\n  if (shouldRemount) {\n    if (forceRemount && app) {\n      await teardown(rootElement, app);\n      app = undefined;\n    }\n    if (mounted?.id !== storyId && app) {\n      await teardown(rootElement, app);\n      app = undefined;\n    }\n\n    // Clear container before mounting new app\n    hostElement.innerHTML = '';\n\n    const mergedProps = mergeStoryProps(parameters, args, story.props);\n\n    const aureliaApp = appBootstrapFn(\n      story,\n      mergedProps,\n      hostElement,\n      component as Constructable,\n      storyContext\n    );\n    await aureliaApp.start();\n    appMap.set(rootElement, { id: storyId, app: aureliaApp });\n    app = aureliaApp;\n  } else {\n    // update existing app props\n    const mergedProps = mergeStoryProps(parameters, args, story.props);\n    if (app?.root?.controller?.viewModel) {\n      Object.assign(app.root.controller.viewModel, mergedProps);\n    }\n  }\n\n  // Return cleanup fn\n  const appForCleanup = app;\n  return async () => {\n    await teardown(rootElement, appForCleanup);\n  };\n}\n\nexport function createAureliaApp(\n  story: AureliaStoryResult,\n  args: Record<string, any>,\n  domElement: HTMLElement,\n  component?: Constructable,\n  storyContext?: AureliaStoryContext\n) {\n  const aurelia = new Aurelia(story.container);\n  const { container } = aurelia;\n  const aureliaParameters = getAureliaParameters(storyContext);\n\n  const registerIfNeeded = (resource: unknown) => {\n    if (!resource) {\n      return;\n    }\n\n    if (CustomElement.isType(resource)) {\n      const definition = CustomElement.getDefinition(resource);\n      if (container.has(definition.key, false)) {\n        return;\n      }\n    }\n\n    aurelia.register(resource);\n  };\n\n  const registerAll = (resources?: unknown[]) => {\n    if (!resources?.length) {\n      return;\n    }\n\n    for (const resource of resources) {\n      registerIfNeeded(resource);\n    }\n  };\n\n  if (aureliaParameters?.configureContainer && storyContext) {\n    aureliaParameters.configureContainer(container, storyContext);\n  }\n\n  registerAll(normalizeRegistrations(aureliaParameters));\n  registerAll(story.items);\n\n  const storyComponents = (story.components ?? []).filter(Boolean);\n  const dedupedComponents = component\n    ? storyComponents.filter((entry) => entry !== component)\n    : storyComponents;\n\n  for (const entry of dedupedComponents) {\n    registerIfNeeded(entry);\n  }\n\n  let { template } = story;\n\n  if (component) {\n    template = template ?? createComponentTemplate(component, story.innerHtml);\n    registerIfNeeded(component);\n  }\n\n  const App = CustomElement.define(\n    {\n      name: 'sb-app',\n      template,\n      containerless: true,\n    },\n    class {}\n  );\n\n  const app = Object.assign(new App(), args);\n\n  if (aureliaParameters?.configure && storyContext) {\n    aureliaParameters.configure(aurelia, storyContext);\n  }\n\n  return aurelia.app({\n    host: domElement,\n    component: app,\n  });\n}\n\nexport function createComponentTemplate(\n  component: Constructable,\n  innerHtml?: string\n): string {\n  const def = CustomElement.getDefinition(component);\n\n  const bindings = Object.values(def.bindables ?? {})\n    .map((bindable) => `${bindable.attribute}.bind=\"${bindable.name}\"`)\n    .join(' ');\n  const bindingAttributes = bindings ? ` ${bindings}` : '';\n\n  return `<${def.name}${bindingAttributes}>${innerHtml ?? ''}</${def.name}>`;\n}\n","import type { AureliaStoryResult } from './types';\n\nexport function defineAureliaStory<TArgs = Record<string, unknown>>(\n  story: AureliaStoryResult<TArgs>\n): AureliaStoryResult<TArgs> {\n  return story;\n}\n","import { renderToCanvas } from './preview/render';\nimport { defineAureliaStory } from './preview/helpers';\n\nexport { renderToCanvas };\nexport const render = renderToCanvas;\nexport { defineAureliaStory };\nexport type {\n  AureliaRenderer,\n  AureliaStoryResult,\n  AureliaArgsStoryFn,\n  AureliaRenderContext,\n  AureliaStoryContext,\n  AureliaParameters,\n  AureliaStoryParameters\n} from './preview/types';\n\n// Define the framework\nexport const framework = {\n  name: '@aurelia/storybook',\n  options: {}\n};\n\n// Framework configuration for Storybook\nexport const frameworkOptions = {\n  builder: {\n    name: '@storybook/builder-vite',\n    options: {}\n  }\n};\n\n// Export a complete framework configuration\nexport const aureliaFramework = {\n  name: '@aurelia/storybook',\n  options: {},\n  builder: '@storybook/builder-vite'\n};\n\n// Provide external dependencies configuration\nexport const externals = {\n  'react': 'React',\n  'react-dom': 'ReactDOM'\n};\n"],"names":[],"mappings":"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"}

package/dist/preset.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Optionally adjust the Vite configuration.
+ */
+export declare function viteFinal(config: any): Promise<any>;
+/**
+ * Optionally adjust the Rsbuild configuration (Rspack-based).
+ */
+export declare function rsbuildFinal(config: any): Promise<any>;
+/**
+ * A function to configure webpack.
+ * @param config
+ * @returns
+ */
+export declare function webpackFinal(config: any): Promise<any>;
+declare const _default: {
+    viteFinal: typeof viteFinal;
+    rsbuildFinal: typeof rsbuildFinal;
+    webpackFinal: typeof webpackFinal;
+};
+export default _default;
+export declare const previewAnnotations: string[];