@aurelia/storybook 2.1.0 → 2.3.0

package/dist/preset.js

@@ -16,29 +16,84 @@ function getRules() {
         },
     ];
 }
+/**
+ * Rsbuild/Rspack rules (avoid ts-loader; Rsbuild handles TS transpilation).
+ */
+function getRsbuildRules() {
+    return [
+        {
+            test: /\.ts$/i,
+            enforce: 'pre',
+            use: ['@aurelia/webpack-loader'],
+            exclude: /node_modules/,
+        },
+        {
+            test: /\.html$/i,
+            use: '@aurelia/webpack-loader',
+            exclude: /node_modules/,
+        },
+    ];
+}
 
 // src/preset.ts
 // Minimal preset for Storybook-Aurelia2
+function addUnique(existing, entries) {
+    return Array.from(new Set([...(existing ?? []), ...entries]));
+}
+function ruleKey(rule) {
+    const use = Array.isArray(rule.use) ? rule.use.join('|') : String(rule.use ?? '');
+    return `${String(rule.test)}::${use}::${String(rule.enforce ?? '')}`;
+}
+function appendUniqueRules(existing, rules) {
+    const seen = new Set(existing.map(ruleKey));
+    for (const rule of rules) {
+        const key = ruleKey(rule);
+        if (!seen.has(key)) {
+            existing.push(rule);
+            seen.add(key);
+        }
+    }
+    return existing;
+}
 /**
  * Optionally adjust the Vite configuration.
  */
 async function viteFinal(config) {
-    // Configure Vite to properly handle dependencies
-    config.define = config.define || {};
-    config.define['process.env.NODE_ENV'] = JSON.stringify(process.env.NODE_ENV || 'development');
-    // Configure optimization deps
-    config.optimizeDeps = config.optimizeDeps || {};
-    config.optimizeDeps.exclude = config.optimizeDeps.exclude || [];
-    // Only exclude Aurelia-specific dependencies that cause issues
-    const excludeList = [
-        '@aurelia/runtime-html'
-    ];
-    excludeList.forEach(dep => {
-        if (!config.optimizeDeps.exclude.includes(dep)) {
-            config.optimizeDeps.exclude.push(dep);
+    config.define = {
+        ...(config.define ?? {}),
+        'process.env.NODE_ENV': config.define?.['process.env.NODE_ENV'] ?? JSON.stringify(process.env.NODE_ENV || 'development'),
+    };
+    config.optimizeDeps = {
+        ...(config.optimizeDeps ?? {}),
+        exclude: addUnique(config.optimizeDeps?.exclude, ['@aurelia/runtime-html']),
+    };
+    return config;
+}
+async function loadMergeRsbuildConfig() {
+    try {
+        const { mergeRsbuildConfig } = await import('@rsbuild/core');
+        return mergeRsbuildConfig;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`@aurelia/storybook: rsbuild support requires @rsbuild/core to be installed. Original error: ${message}`);
+    }
+}
+/**
+ * Optionally adjust the Rsbuild configuration (Rspack-based).
+ */
+async function rsbuildFinal(config) {
+    const mergeRsbuildConfig = await loadMergeRsbuildConfig();
+    return mergeRsbuildConfig(config, {
+        tools: {
+            rspack: (rspackConfig) => {
+                const moduleConfig = rspackConfig.module ?? (rspackConfig.module = {});
+                const rules = moduleConfig.rules ?? (moduleConfig.rules = []);
+                appendUniqueRules(rules, getRsbuildRules());
+                return rspackConfig;
+            }
         }
     });
-    return config;
 }
 /**
  * A function to configure webpack.
@@ -46,15 +101,14 @@ async function viteFinal(config) {
  * @returns
  */
 async function webpackFinal(config) {
-    const rules = config.module?.rules;
-    if (rules) {
-        rules.push(...getRules());
-    }
+    const moduleConfig = config.module ?? (config.module = {});
+    const rules = moduleConfig.rules ?? (moduleConfig.rules = []);
+    appendUniqueRules(rules, getRules());
     return config;
 }
 // Export a default for compatibility.
-var preset = { viteFinal, webpackFinal };
+var preset = { viteFinal, rsbuildFinal, webpackFinal };
 const previewAnnotations = ['./preview.js'];
 
-export { preset as default, previewAnnotations, viteFinal, webpackFinal };
+export { preset as default, previewAnnotations, rsbuildFinal, viteFinal, webpackFinal };
 //# sourceMappingURL=preset.js.map

package/dist/preset.js.map

@@ -1 +1 @@
-{"version":3,"file":"preset.js","sources":["../src/webpack.ts","../src/preset.ts"],"sourcesContent":["// src/webpack.ts\nimport type { RuleSetRule } from 'webpack';\n\n/**\n * A set of rules to be added to the webpack configuration.\n * @returns\n */\nexport function getRules(): RuleSetRule[] {\n  return [\n    {\n      test: /\\.ts$/i,\n      use: ['ts-loader', '@aurelia/webpack-loader'],\n      exclude: /node_modules/,\n    },\n    {\n      test: /\\.html$/i,\n      use: '@aurelia/webpack-loader',\n      exclude: /node_modules/,\n    },\n  ];\n}\n","// src/preset.ts\n// Minimal preset for Storybook-Aurelia2\n\nimport { getRules } from './webpack';\n\n/**\n * Optionally adjust the Vite configuration.\n */\nexport async function viteFinal(config: any): Promise<any> {\n    // Configure Vite to properly handle dependencies\n    config.define = config.define || {};\n    config.define['process.env.NODE_ENV'] = JSON.stringify(process.env.NODE_ENV || 'development');\n    \n    // Configure optimization deps\n    config.optimizeDeps = config.optimizeDeps || {};\n    config.optimizeDeps.exclude = config.optimizeDeps.exclude || [];\n    \n    // Only exclude Aurelia-specific dependencies that cause issues\n    const excludeList = [\n        '@aurelia/runtime-html'\n    ];\n    \n    excludeList.forEach(dep => {\n        if (!config.optimizeDeps.exclude.includes(dep)) {\n            config.optimizeDeps.exclude.push(dep);\n        }\n    });\n    \n    return config;\n}\n\n/**\n * A function to configure webpack.\n * @param config\n * @returns\n */\nexport async function webpackFinal(config: any): Promise<any> {\n    const rules = config.module?.rules;\n    if (rules) {\n        rules.push(...getRules());\n    }\n\n    return config;\n}\n\n// Export a default for compatibility.\nexport default { viteFinal, webpackFinal };\n\nexport const previewAnnotations = ['./preview.js'];\n"],"names":[],"mappings":"AAGA;;;AAGG;SACa,QAAQ,GAAA;IACtB,OAAO;AACL,QAAA;AACE,YAAA,IAAI,EAAE,QAAQ;AACd,YAAA,GAAG,EAAE,CAAC,WAAW,EAAE,yBAAyB,CAAC;AAC7C,YAAA,OAAO,EAAE,cAAc;AACxB,SAAA;AACD,QAAA;AACE,YAAA,IAAI,EAAE,UAAU;AAChB,YAAA,GAAG,EAAE,yBAAyB;AAC9B,YAAA,OAAO,EAAE,cAAc;AACxB,SAAA;KACF;AACH;;ACpBA;AACA;AAIA;;AAEG;AACI,eAAe,SAAS,CAAC,MAAW,EAAA;;IAEvC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE;AACnC,IAAA,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;;IAG7F,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE;AAC/C,IAAA,MAAM,CAAC,YAAY,CAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE;;AAG/D,IAAA,MAAM,WAAW,GAAG;QAChB;KACH;AAED,IAAA,WAAW,CAAC,OAAO,CAAC,GAAG,IAAG;AACtB,QAAA,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;YAC5C,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QACzC;AACJ,IAAA,CAAC,CAAC;AAEF,IAAA,OAAO,MAAM;AACjB;AAEA;;;;AAIG;AACI,eAAe,YAAY,CAAC,MAAW,EAAA;AAC1C,IAAA,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK;IAClC,IAAI,KAAK,EAAE;AACP,QAAA,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC;IAC7B;AAEA,IAAA,OAAO,MAAM;AACjB;AAEA;AACA,aAAe,EAAE,SAAS,EAAE,YAAY,EAAE;AAEnC,MAAM,kBAAkB,GAAG,CAAC,cAAc;;;;"}
+{"version":3,"file":"preset.js","sources":["../src/webpack.ts","../src/preset.ts"],"sourcesContent":["// src/webpack.ts\nimport type { RuleSetRule } from 'webpack';\n\n/**\n * A set of rules to be added to the webpack configuration.\n * @returns\n */\nexport function getRules(): RuleSetRule[] {\n  return [\n    {\n      test: /\\.ts$/i,\n      use: ['ts-loader', '@aurelia/webpack-loader'],\n      exclude: /node_modules/,\n    },\n    {\n      test: /\\.html$/i,\n      use: '@aurelia/webpack-loader',\n      exclude: /node_modules/,\n    },\n  ];\n}\n\n/**\n * Rsbuild/Rspack rules (avoid ts-loader; Rsbuild handles TS transpilation).\n */\nexport function getRsbuildRules(): RuleSetRule[] {\n  return [\n    {\n      test: /\\.ts$/i,\n      enforce: 'pre',\n      use: ['@aurelia/webpack-loader'],\n      exclude: /node_modules/,\n    },\n    {\n      test: /\\.html$/i,\n      use: '@aurelia/webpack-loader',\n      exclude: /node_modules/,\n    },\n  ];\n}\n","// src/preset.ts\n// Minimal preset for Storybook-Aurelia2\n\nimport { getRules, getRsbuildRules } from './webpack';\n\nfunction addUnique<T>(existing: T[] | undefined, entries: T[]): T[] {\n    return Array.from(new Set([...(existing ?? []), ...entries]));\n}\n\nfunction ruleKey(rule: any): string {\n    const use = Array.isArray(rule.use) ? rule.use.join('|') : String(rule.use ?? '');\n    return `${String(rule.test)}::${use}::${String(rule.enforce ?? '')}`;\n}\n\nfunction appendUniqueRules(existing: any[], rules: any[]): any[] {\n    const seen = new Set(existing.map(ruleKey));\n    for (const rule of rules) {\n        const key = ruleKey(rule);\n        if (!seen.has(key)) {\n            existing.push(rule);\n            seen.add(key);\n        }\n    }\n    return existing;\n}\n\n/**\n * Optionally adjust the Vite configuration.\n */\nexport async function viteFinal(config: any): Promise<any> {\n    config.define = {\n        ...(config.define ?? {}),\n        'process.env.NODE_ENV': config.define?.['process.env.NODE_ENV'] ?? JSON.stringify(process.env.NODE_ENV || 'development'),\n    };\n\n    config.optimizeDeps = {\n        ...(config.optimizeDeps ?? {}),\n        exclude: addUnique(config.optimizeDeps?.exclude, ['@aurelia/runtime-html']),\n    };\n\n    return config;\n}\n\nasync function loadMergeRsbuildConfig() {\n    try {\n        const { mergeRsbuildConfig } = await import('@rsbuild/core');\n        return mergeRsbuildConfig;\n    } catch (error: any) {\n        const message = error instanceof Error ? error.message : String(error);\n        throw new Error(\n            `@aurelia/storybook: rsbuild support requires @rsbuild/core to be installed. Original error: ${message}`\n        );\n    }\n}\n\n/**\n * Optionally adjust the Rsbuild configuration (Rspack-based).\n */\nexport async function rsbuildFinal(config: any): Promise<any> {\n    const mergeRsbuildConfig = await loadMergeRsbuildConfig();\n\n    return mergeRsbuildConfig(config, {\n        tools: {\n            rspack: (rspackConfig: any) => {\n                const moduleConfig = rspackConfig.module ?? (rspackConfig.module = {});\n                const rules = moduleConfig.rules ?? (moduleConfig.rules = []);\n                appendUniqueRules(rules, getRsbuildRules());\n                return rspackConfig;\n            }\n        }\n    });\n}\n\n/**\n * A function to configure webpack.\n * @param config\n * @returns\n */\nexport async function webpackFinal(config: any): Promise<any> {\n    const moduleConfig = config.module ?? (config.module = {});\n    const rules = moduleConfig.rules ?? (moduleConfig.rules = []);\n    appendUniqueRules(rules, getRules());\n\n    return config;\n}\n\n// Export a default for compatibility.\nexport default { viteFinal, rsbuildFinal, webpackFinal };\n\nexport const previewAnnotations = ['./preview.js'];\n"],"names":[],"mappings":"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"}

package/dist/preview/helpers.d.ts

@@ -0,0 +1,2 @@
+import type { AureliaStoryResult } from './types';
+export declare function defineAureliaStory<TArgs = Record<string, unknown>>(story: AureliaStoryResult<TArgs>): AureliaStoryResult<TArgs>;

package/dist/preview/helpers.js

@@ -0,0 +1,6 @@
+function defineAureliaStory(story) {
+    return story;
+}
+
+export { defineAureliaStory };
+//# sourceMappingURL=helpers.js.map

package/dist/preview/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sources":["../../src/preview/helpers.ts"],"sourcesContent":["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"],"names":[],"mappings":"AAEM,SAAU,kBAAkB,CAChC,KAAgC,EAAA;AAEhC,IAAA,OAAO,KAAK;AACd;;;;"}

package/dist/preview/render.d.ts

@@ -0,0 +1,7 @@
+import type { RenderContext, ArgsStoryFn } from './storybook-types';
+import type { AureliaRenderer, AureliaStoryResult, AureliaStoryContext } from './types';
+import Aurelia, { Constructable } from 'aurelia';
+export declare const render: ArgsStoryFn<AureliaRenderer>;
+export declare function renderToCanvas({ storyFn, title, name, showMain, showError, storyContext, forceRemount, }: RenderContext<AureliaRenderer>, canvasElement: HTMLElement, bootstrapAppFn?: typeof createAureliaApp): Promise<() => void>;
+export declare function createAureliaApp(story: AureliaStoryResult, args: Record<string, any>, domElement: HTMLElement, component?: Constructable, storyContext?: AureliaStoryContext): Omit<Aurelia, "app" | "enhance" | "register">;
+export declare function createComponentTemplate(component: Constructable, innerHtml?: string): string;

package/dist/preview/render.js

@@ -1,22 +1,45 @@
 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();
     }
 }
 const render = (args, context) => {
     const { id, component: Component } = context;
     if (!Component) {
-        throw new Error(`Unable to render story ${id} as the component annotation is missing from the default export`);
+        const label = context.title && context.name ? `${context.title} / ${context.name}` : id;
+        throw new Error(`Unable to render story ${label} as the component annotation is missing from the default export`);
     }
-    return { Component, props: args, template: '' };
+    return { Component, props: args };
 };
 async function renderToCanvas({ storyFn, title, name, showMain, showError, storyContext, forceRemount, }, canvasElement, bootstrapAppFn) {
     // Store reference to the original storybook root element
@@ -38,10 +61,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}".`,
@@ -52,44 +75,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',
@@ -98,6 +164,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,
@@ -105,9 +174,11 @@ 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}>`;
 }
 
 export { createAureliaApp, createComponentTemplate, render, renderToCanvas };

package/dist/preview/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sources":["../../src/preview/render.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}"],"names":[],"mappings":"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"}
+{"version":3,"file":"render.js","sources":["../../src/preview/render.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"],"names":[],"mappings":"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"}

package/dist/preview/storybook-types-runtime.d.ts

@@ -0,0 +1 @@
+export declare const __AURELIA_STORYBOOK_STORYBOOK_TYPES__ = true;

package/dist/preview/storybook-types-runtime.js

@@ -0,0 +1,5 @@
+// Runtime stub so the export map has a JS target for type-only entries.
+const __AURELIA_STORYBOOK_STORYBOOK_TYPES__ = true;
+
+export { __AURELIA_STORYBOOK_STORYBOOK_TYPES__ };
+//# sourceMappingURL=storybook-types-runtime.js.map

package/dist/preview/storybook-types-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook-types-runtime.js","sources":["../../src/preview/storybook-types-runtime.ts"],"sourcesContent":["// Runtime stub so the export map has a JS target for type-only entries.\nexport const __AURELIA_STORYBOOK_STORYBOOK_TYPES__ = true;\n"],"names":[],"mappings":"AAAA;AACO,MAAM,qCAAqC,GAAG;;;;"}

package/dist/preview/storybook-types.d.ts

@@ -0,0 +1,27 @@
+export interface Renderer {
+    component?: unknown;
+    storyResult?: unknown;
+    canvasElement?: HTMLElement;
+}
+export interface StoryContext<TRenderer = Renderer, TArgs = Record<string, unknown>> {
+    id?: string;
+    component?: unknown;
+    args: TArgs;
+    parameters?: {
+        args?: Record<string, unknown>;
+    } & Record<string, unknown>;
+    [key: string]: unknown;
+}
+export type ArgsStoryFn<TRenderer = Renderer, TArgs = Record<string, unknown>> = (args: TArgs, context: StoryContext<TRenderer, TArgs>) => unknown;
+export interface RenderContext<TRenderer = Renderer, TArgs = Record<string, unknown>> {
+    storyFn: () => unknown;
+    title: string;
+    name: string;
+    showMain: () => void;
+    showError: (error: {
+        title: string;
+        description?: string;
+    }) => void;
+    storyContext: StoryContext<TRenderer, TArgs>;
+    forceRemount?: boolean;
+}

package/dist/preview/types-runtime.d.ts

@@ -0,0 +1 @@
+export declare const __AURELIA_STORYBOOK_TYPES__ = true;

package/dist/preview/types-runtime.js

@@ -0,0 +1,5 @@
+// Runtime stub so the export map has a JS target for type-only entries.
+const __AURELIA_STORYBOOK_TYPES__ = true;
+
+export { __AURELIA_STORYBOOK_TYPES__ };
+//# sourceMappingURL=types-runtime.js.map

package/dist/preview/types-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-runtime.js","sources":["../../src/preview/types-runtime.ts"],"sourcesContent":["// Runtime stub so the export map has a JS target for type-only entries.\nexport const __AURELIA_STORYBOOK_TYPES__ = true;\n"],"names":[],"mappings":"AAAA;AACO,MAAM,2BAA2B,GAAG;;;;"}

package/dist/preview/types.d.ts

@@ -0,0 +1,44 @@
+import type { IContainer } from 'aurelia';
+import type Aurelia from 'aurelia';
+import type { Renderer, StoryContext, RenderContext, ArgsStoryFn } from './storybook-types';
+export interface AureliaRenderer extends Renderer {
+    /** The DOM element in which the story is rendered */
+    canvasElement: HTMLElement;
+}
+export interface AureliaStoryResult<TArgs = Record<string, unknown>> {
+    template?: string;
+    components?: unknown[];
+    Component?: unknown;
+    container?: IContainer;
+    items?: unknown[];
+    innerHtml?: string;
+    props?: Partial<TArgs>;
+}
+export type AureliaStoryContext<TArgs = Record<string, unknown>> = StoryContext<AureliaRenderer, TArgs>;
+export type AureliaRenderContext<TArgs = Record<string, unknown>> = RenderContext<AureliaRenderer, TArgs>;
+export type AureliaArgsStoryFn<TArgs = Record<string, unknown>> = ArgsStoryFn<AureliaRenderer, TArgs>;
+export interface AureliaParameters<TArgs = Record<string, unknown>> {
+    /**
+     * Global resources/plugins to register with Aurelia (merged across preview + story parameters).
+     */
+    register?: unknown[];
+    /**
+     * Alias for register: match the story result `components` contract.
+     */
+    components?: unknown[];
+    /**
+     * Alias for register: match the story result `items` contract.
+     */
+    items?: unknown[];
+    /**
+     * Configure the container before the Aurelia app starts.
+     */
+    configureContainer?: (container: IContainer, context: AureliaStoryContext<TArgs>) => void;
+    /**
+     * Configure the Aurelia instance before the app starts.
+     */
+    configure?: (aurelia: Aurelia, context: AureliaStoryContext<TArgs>) => void;
+}
+export interface AureliaStoryParameters<TArgs = Record<string, unknown>> {
+    aurelia?: AureliaParameters<TArgs>;
+}

package/dist/preview.d.ts

@@ -0,0 +1,3 @@
+export { renderToCanvas, render } from './preview/render';
+export { defineAureliaStory } from './preview/helpers';
+export type { AureliaArgsStoryFn, AureliaParameters, AureliaRenderContext, AureliaRenderer, AureliaStoryParameters, AureliaStoryContext, AureliaStoryResult } from './preview/types';