@storybook-astro/framework 0.1.0-beta.9 → 1.0.0

package/dist/middleware.js

@@ -0,0 +1,179 @@
+import {
+  applyMswHandlers,
+  resolveSanitizationOptions,
+  resolveStoryModuleMock,
+  sanitizeRenderPayload,
+  selectStoryRules,
+  withStoryModuleMocks
+} from "./chunk-C5OH4VBR.js";
+import "./chunk-G3PMV62Z.js";
+
+// src/middleware.ts
+import { pathToFileURL } from "url";
+import { experimental_AstroContainer as AstroContainer } from "astro/container";
+import { addRenderers, resolveClientModules } from "virtual:astro-container-renderers";
+async function handlerFactory(_integrations, options) {
+  const mode = options?.mode ?? "development";
+  const container = await AstroContainer.create({
+    // Somewhat hacky way to force client-side Storybook's Vite to resolve modules properly
+    resolve: async (specifier) => {
+      const mockedModule = resolveStoryModuleMock(specifier);
+      if (mockedModule) {
+        return mockedModule;
+      }
+      if (specifier.startsWith("astro:scripts")) {
+        return `/@id/${specifier}`;
+      }
+      const resolution = resolveClientModules(specifier);
+      if (resolution) {
+        return resolution;
+      }
+      return specifier;
+    }
+  });
+  addRenderers(container);
+  const sanitizationOptions = resolveSanitizationOptions(options?.sanitization);
+  const loadModule = options?.loadModule ?? ((id) => {
+    const normalizedId = /^[a-zA-Z]:[/\\]/.test(id) ? pathToFileURL(id).href : id;
+    return import(
+      /* @vite-ignore */
+      normalizedId
+    );
+  });
+  const componentCache = /* @__PURE__ */ new Map();
+  let renderQueue = Promise.resolve(void 0);
+  async function loadPatchedComponent(componentId, useCache = true) {
+    if (!useCache) {
+      const { default: component } = await loadModule(componentId);
+      return patchCreateAstroCompat(component);
+    }
+    if (!componentCache.has(componentId)) {
+      componentCache.set(componentId, (async () => {
+        const { default: component } = await loadModule(componentId);
+        return patchCreateAstroCompat(component);
+      })());
+    }
+    const cachedComponent = componentCache.get(componentId);
+    if (!cachedComponent) {
+      throw new Error(`Failed to load Astro component: ${componentId}`);
+    }
+    try {
+      return await cachedComponent;
+    } catch (error) {
+      componentCache.delete(componentId);
+      throw error;
+    }
+  }
+  return async function handler(data) {
+    const executeRender = async () => {
+      const rulesConfigModule = options?.resolveRulesConfigModule ? await options.resolveRulesConfigModule() : void 0;
+      const selectedRules = await selectStoryRules({
+        configModule: rulesConfigModule,
+        configFilePath: options?.rulesConfigFilePath,
+        mode,
+        story: data.story
+      });
+      await applyMswHandlers(selectedRules.mswHandlers);
+      return withStoryModuleMocks(selectedRules.moduleMocks, async () => {
+        const patchedComponent = await loadPatchedComponent(
+          data.component,
+          selectedRules.moduleMocks.size === 0
+        );
+        const processedArgs = await processImageMetadata(data.args ?? {});
+        const sanitizedPayload = sanitizeRenderPayload(
+          {
+            args: processedArgs,
+            slots: data.slots ?? {}
+          },
+          sanitizationOptions
+        );
+        return container.renderToString(
+          patchedComponent,
+          {
+            props: sanitizedPayload.args,
+            slots: sanitizedPayload.slots
+          }
+        );
+      });
+    };
+    const resultPromise = renderQueue.then(executeRender, executeRender);
+    renderQueue = resultPromise.then(
+      () => void 0,
+      () => void 0
+    );
+    return resultPromise;
+  };
+}
+function patchCreateAstroCompat(component) {
+  if (typeof component !== "function") {
+    throw new Error("Expected Astro component factory to be a function.");
+  }
+  const originalComponent = component;
+  const wrapped = ((result, props, slots) => {
+    if (result && typeof result.createAstro === "function") {
+      const originalCreateAstro = result.createAstro;
+      const runtimeExpectsAstroGlobal = originalCreateAstro.length >= 3;
+      result.createAstro = (...args) => {
+        if (args.length === 3 && !runtimeExpectsAstroGlobal) {
+          return originalCreateAstro(args[1], args[2]);
+        }
+        return originalCreateAstro(...args);
+      };
+    }
+    return originalComponent(result, props, slots);
+  });
+  wrapped.isAstroComponentFactory = originalComponent.isAstroComponentFactory;
+  wrapped.moduleId = originalComponent.moduleId;
+  wrapped.propagation = originalComponent.propagation;
+  return wrapped;
+}
+async function processImageMetadata(args) {
+  const processed = {};
+  for (const [key, value] of Object.entries(args)) {
+    if (isImageMetadata(value)) {
+      processed[key] = convertImageMetadataToUrl(value);
+      continue;
+    }
+    if (Array.isArray(value)) {
+      processed[key] = await Promise.all(
+        value.map(async (item) => {
+          if (isImageMetadata(item)) {
+            return convertImageMetadataToUrl(item);
+          }
+          if (isRecord(item)) {
+            return processImageMetadata(item);
+          }
+          return item;
+        })
+      );
+      continue;
+    }
+    if (isRecord(value)) {
+      processed[key] = await processImageMetadata(value);
+      continue;
+    }
+    processed[key] = value;
+  }
+  return processed;
+}
+function isImageMetadata(value) {
+  return isRecord(value) && typeof value.src === "string" && ("width" in value || "height" in value || "format" in value);
+}
+function convertImageMetadataToUrl(imageMetadata) {
+  const src = imageMetadata.src;
+  const fsPath = imageMetadata.fsPath;
+  if (typeof src === "string") {
+    return src;
+  }
+  if (typeof fsPath === "string") {
+    return fsPath;
+  }
+  return String(imageMetadata);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+export {
+  handlerFactory
+};
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/middleware.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\nimport { experimental_AstroContainer as AstroContainer } from 'astro/container';\nimport type { Integration } from './integrations/index.ts';\nimport type { SanitizationOptions } from './lib/sanitization.ts';\nimport { resolveSanitizationOptions, sanitizeRenderPayload } from './lib/sanitization.ts';\nimport { resolveStoryModuleMock, withStoryModuleMocks } from './module-mocks.ts';\nimport { applyMswHandlers } from './msw.ts';\nimport { selectStoryRules } from './rules.ts';\nimport type { RenderStoryInput } from './types.ts';\nimport { addRenderers, resolveClientModules } from 'virtual:astro-container-renderers';\n\ntype ResolveRulesConfigModule = () => unknown | Promise<unknown>;\n\ntype AstroCreateResult = {\n  createAstro?: (...args: unknown[]) => unknown;\n};\n\ntype AstroComponentFactory = ((\n  result: AstroCreateResult,\n  props: unknown,\n  slots: unknown\n) => unknown) & {\n  isAstroComponentFactory?: boolean;\n  moduleId?: string;\n  propagation?: unknown;\n};\n\nexport type HandlerProps = {\n  component: string;\n  args?: Record<string, unknown>;\n  slots?: Record<string, unknown>;\n  story?: RenderStoryInput;\n};\n\ntype HandlerFactoryOptions = {\n  mode?: 'development' | 'production';\n  sanitization?: SanitizationOptions;\n  rulesConfigFilePath?: string;\n  resolveRulesConfigModule?: ResolveRulesConfigModule;\n  loadModule?: (id: string) => Promise<{ default: unknown }>;\n};\n\nexport async function handlerFactory(_integrations: Integration[], options?: HandlerFactoryOptions) {\n  const mode = options?.mode ?? 'development';\n  const container = await AstroContainer.create({\n    // Somewhat hacky way to force client-side Storybook's Vite to resolve modules properly\n    resolve: async (specifier) => {\n      const mockedModule = resolveStoryModuleMock(specifier);\n\n      if (mockedModule) {\n        return mockedModule;\n      }\n\n      if (specifier.startsWith('astro:scripts')) {\n        return `/@id/${specifier}`;\n      }\n\n      const resolution = resolveClientModules(specifier);\n\n      if (resolution) {\n        return resolution;\n      }\n\n      return specifier;\n    }\n  });\n\n  addRenderers(container);\n  const sanitizationOptions = resolveSanitizationOptions(options?.sanitization);\n  const loadModule =\n    options?.loadModule ??\n    ((id: string) => {\n      const normalizedId = /^[a-zA-Z]:[/\\\\]/.test(id) ? pathToFileURL(id).href : id;\n\n      return import(/* @vite-ignore */ normalizedId);\n    });\n  const componentCache = new Map<string, Promise<AstroComponentFactory>>();\n  let renderQueue = Promise.resolve<void>(undefined);\n\n  async function loadPatchedComponent(componentId: string, useCache = true) {\n    if (!useCache) {\n      const { default: component } = await loadModule(componentId);\n\n      return patchCreateAstroCompat(component);\n    }\n\n    if (!componentCache.has(componentId)) {\n      componentCache.set(componentId, (async () => {\n        const { default: component } = await loadModule(componentId);\n\n        return patchCreateAstroCompat(component);\n      })());\n    }\n\n    const cachedComponent = componentCache.get(componentId);\n\n    if (!cachedComponent) {\n      throw new Error(`Failed to load Astro component: ${componentId}`);\n    }\n\n    try {\n      return await cachedComponent;\n    } catch (error) {\n      // Drop failed entries so transient/module errors can recover on the next request.\n      componentCache.delete(componentId);\n      throw error;\n    }\n  }\n\n  return async function handler(data: HandlerProps) {\n    const executeRender = async () => {\n      const rulesConfigModule = options?.resolveRulesConfigModule\n        ? await options.resolveRulesConfigModule()\n        : undefined;\n\n      const selectedRules = await selectStoryRules({\n        configModule: rulesConfigModule,\n        configFilePath: options?.rulesConfigFilePath,\n        mode,\n        story: data.story\n      });\n\n      await applyMswHandlers(selectedRules.mswHandlers);\n\n      return withStoryModuleMocks(selectedRules.moduleMocks, async () => {\n        const patchedComponent = await loadPatchedComponent(\n          data.component,\n          selectedRules.moduleMocks.size === 0\n        );\n        const processedArgs = await processImageMetadata(data.args ?? {});\n        const sanitizedPayload = sanitizeRenderPayload(\n          {\n            args: processedArgs,\n            slots: data.slots ?? {}\n          },\n          sanitizationOptions\n        );\n\n        return container.renderToString(\n          patchedComponent as Parameters<typeof container.renderToString>[0],\n          {\n            props: sanitizedPayload.args,\n            slots: sanitizedPayload.slots\n          }\n        );\n      });\n    };\n\n    const resultPromise = renderQueue.then(executeRender, executeRender);\n\n    renderQueue = resultPromise.then(\n      () => undefined,\n      () => undefined\n    );\n\n    return resultPromise;\n  };\n}\n\nfunction patchCreateAstroCompat(component: unknown): AstroComponentFactory {\n  if (typeof component !== 'function') {\n    throw new Error('Expected Astro component factory to be a function.');\n  }\n\n  const originalComponent = component as AstroComponentFactory;\n  const wrapped = ((result: AstroCreateResult, props: unknown, slots: unknown) => {\n    if (result && typeof result.createAstro === 'function') {\n      const originalCreateAstro = result.createAstro;\n      const runtimeExpectsAstroGlobal = originalCreateAstro.length >= 3;\n\n      result.createAstro = (...args: unknown[]) => {\n        if (args.length === 3 && !runtimeExpectsAstroGlobal) {\n          return originalCreateAstro(args[1], args[2]);\n        }\n\n        return originalCreateAstro(...args);\n      };\n    }\n\n    return originalComponent(result, props, slots);\n  }) as AstroComponentFactory;\n\n  wrapped.isAstroComponentFactory = originalComponent.isAstroComponentFactory;\n  wrapped.moduleId = originalComponent.moduleId;\n  wrapped.propagation = originalComponent.propagation;\n\n  return wrapped;\n}\n\nasync function processImageMetadata(\n  args: Record<string, unknown>\n): Promise<Record<string, unknown>> {\n  const processed: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(args)) {\n    if (isImageMetadata(value)) {\n      processed[key] = convertImageMetadataToUrl(value);\n\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      processed[key] = await Promise.all(\n        value.map(async (item) => {\n          if (isImageMetadata(item)) {\n            return convertImageMetadataToUrl(item);\n          }\n\n          if (isRecord(item)) {\n            return processImageMetadata(item);\n          }\n\n          return item;\n        })\n      );\n\n      continue;\n    }\n\n    if (isRecord(value)) {\n      processed[key] = await processImageMetadata(value);\n\n      continue;\n    }\n\n    processed[key] = value;\n  }\n\n  return processed;\n}\n\nfunction isImageMetadata(value: unknown): value is Record<string, unknown> {\n  return (\n    isRecord(value) &&\n    typeof value.src === 'string' &&\n    ('width' in value || 'height' in value || 'format' in value)\n  );\n}\n\nfunction convertImageMetadataToUrl(imageMetadata: Record<string, unknown>): string {\n  const src = imageMetadata.src;\n  const fsPath = imageMetadata.fsPath;\n\n  if (typeof src === 'string') {\n    return src;\n  }\n\n  if (typeof fsPath === 'string') {\n    return fsPath;\n  }\n\n  return String(imageMetadata);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n"],"mappings":";;;;;;;;;;;AAAA,SAAS,qBAAqB;AAC9B,SAAS,+BAA+B,sBAAsB;AAQ9D,SAAS,cAAc,4BAA4B;AAiCnD,eAAsB,eAAe,eAA8B,SAAiC;AAClG,QAAM,OAAO,SAAS,QAAQ;AAC9B,QAAM,YAAY,MAAM,eAAe,OAAO;AAAA;AAAA,IAE5C,SAAS,OAAO,cAAc;AAC5B,YAAM,eAAe,uBAAuB,SAAS;AAErD,UAAI,cAAc;AAChB,eAAO;AAAA,MACT;AAEA,UAAI,UAAU,WAAW,eAAe,GAAG;AACzC,eAAO,QAAQ,SAAS;AAAA,MAC1B;AAEA,YAAM,aAAa,qBAAqB,SAAS;AAEjD,UAAI,YAAY;AACd,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AAED,eAAa,SAAS;AACtB,QAAM,sBAAsB,2BAA2B,SAAS,YAAY;AAC5E,QAAM,aACJ,SAAS,eACR,CAAC,OAAe;AACf,UAAM,eAAe,kBAAkB,KAAK,EAAE,IAAI,cAAc,EAAE,EAAE,OAAO;AAE3E,WAAO;AAAA;AAAA,MAA0B;AAAA;AAAA,EACnC;AACF,QAAM,iBAAiB,oBAAI,IAA4C;AACvE,MAAI,cAAc,QAAQ,QAAc,MAAS;AAEjD,iBAAe,qBAAqB,aAAqB,WAAW,MAAM;AACxE,QAAI,CAAC,UAAU;AACb,YAAM,EAAE,SAAS,UAAU,IAAI,MAAM,WAAW,WAAW;AAE3D,aAAO,uBAAuB,SAAS;AAAA,IACzC;AAEA,QAAI,CAAC,eAAe,IAAI,WAAW,GAAG;AACpC,qBAAe,IAAI,cAAc,YAAY;AAC3C,cAAM,EAAE,SAAS,UAAU,IAAI,MAAM,WAAW,WAAW;AAE3D,eAAO,uBAAuB,SAAS;AAAA,MACzC,GAAG,CAAC;AAAA,IACN;AAEA,UAAM,kBAAkB,eAAe,IAAI,WAAW;AAEtD,QAAI,CAAC,iBAAiB;AACpB,YAAM,IAAI,MAAM,mCAAmC,WAAW,EAAE;AAAA,IAClE;AAEA,QAAI;AACF,aAAO,MAAM;AAAA,IACf,SAAS,OAAO;AAEd,qBAAe,OAAO,WAAW;AACjC,YAAM;AAAA,IACR;AAAA,EACF;AAEA,SAAO,eAAe,QAAQ,MAAoB;AAChD,UAAM,gBAAgB,YAAY;AAChC,YAAM,oBAAoB,SAAS,2BAC/B,MAAM,QAAQ,yBAAyB,IACvC;AAEJ,YAAM,gBAAgB,MAAM,iBAAiB;AAAA,QAC3C,cAAc;AAAA,QACd,gBAAgB,SAAS;AAAA,QACzB;AAAA,QACA,OAAO,KAAK;AAAA,MACd,CAAC;AAED,YAAM,iBAAiB,cAAc,WAAW;AAEhD,aAAO,qBAAqB,cAAc,aAAa,YAAY;AACjE,cAAM,mBAAmB,MAAM;AAAA,UAC7B,KAAK;AAAA,UACL,cAAc,YAAY,SAAS;AAAA,QACrC;AACA,cAAM,gBAAgB,MAAM,qBAAqB,KAAK,QAAQ,CAAC,CAAC;AAChE,cAAM,mBAAmB;AAAA,UACvB;AAAA,YACE,MAAM;AAAA,YACN,OAAO,KAAK,SAAS,CAAC;AAAA,UACxB;AAAA,UACA;AAAA,QACF;AAEA,eAAO,UAAU;AAAA,UACf;AAAA,UACA;AAAA,YACE,OAAO,iBAAiB;AAAA,YACxB,OAAO,iBAAiB;AAAA,UAC1B;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAEA,UAAM,gBAAgB,YAAY,KAAK,eAAe,aAAa;AAEnE,kBAAc,cAAc;AAAA,MAC1B,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAEA,WAAO;AAAA,EACT;AACF;AAEA,SAAS,uBAAuB,WAA2C;AACzE,MAAI,OAAO,cAAc,YAAY;AACnC,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AAEA,QAAM,oBAAoB;AAC1B,QAAM,WAAW,CAAC,QAA2B,OAAgB,UAAmB;AAC9E,QAAI,UAAU,OAAO,OAAO,gBAAgB,YAAY;AACtD,YAAM,sBAAsB,OAAO;AACnC,YAAM,4BAA4B,oBAAoB,UAAU;AAEhE,aAAO,cAAc,IAAI,SAAoB;AAC3C,YAAI,KAAK,WAAW,KAAK,CAAC,2BAA2B;AACnD,iBAAO,oBAAoB,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;AAAA,QAC7C;AAEA,eAAO,oBAAoB,GAAG,IAAI;AAAA,MACpC;AAAA,IACF;AAEA,WAAO,kBAAkB,QAAQ,OAAO,KAAK;AAAA,EAC/C;AAEA,UAAQ,0BAA0B,kBAAkB;AACpD,UAAQ,WAAW,kBAAkB;AACrC,UAAQ,cAAc,kBAAkB;AAExC,SAAO;AACT;AAEA,eAAe,qBACb,MACkC;AAClC,QAAM,YAAqC,CAAC;AAE5C,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,QAAI,gBAAgB,KAAK,GAAG;AAC1B,gBAAU,GAAG,IAAI,0BAA0B,KAAK;AAEhD;AAAA,IACF;AAEA,QAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,gBAAU,GAAG,IAAI,MAAM,QAAQ;AAAA,QAC7B,MAAM,IAAI,OAAO,SAAS;AACxB,cAAI,gBAAgB,IAAI,GAAG;AACzB,mBAAO,0BAA0B,IAAI;AAAA,UACvC;AAEA,cAAI,SAAS,IAAI,GAAG;AAClB,mBAAO,qBAAqB,IAAI;AAAA,UAClC;AAEA,iBAAO;AAAA,QACT,CAAC;AAAA,MACH;AAEA;AAAA,IACF;AAEA,QAAI,SAAS,KAAK,GAAG;AACnB,gBAAU,GAAG,IAAI,MAAM,qBAAqB,KAAK;AAEjD;AAAA,IACF;AAEA,cAAU,GAAG,IAAI;AAAA,EACnB;AAEA,SAAO;AACT;AAEA,SAAS,gBAAgB,OAAkD;AACzE,SACE,SAAS,KAAK,KACd,OAAO,MAAM,QAAQ,aACpB,WAAW,SAAS,YAAY,SAAS,YAAY;AAE1D;AAEA,SAAS,0BAA0B,eAAgD;AACjF,QAAM,MAAM,cAAc;AAC1B,QAAM,SAAS,cAAc;AAE7B,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO;AAAA,EACT;AAEA,SAAO,OAAO,aAAa;AAC7B;AAEA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;","names":[]}

package/dist/portable-stories-BvdaQigq.d.ts

@@ -0,0 +1,83 @@
+import * as storybook_internal_types from 'storybook/internal/types';
+import { WebRenderer, ProjectAnnotations, Args, StoryAnnotationsOrFn, ComponentAnnotations, NamedOrDefaultProjectAnnotations, NormalizedProjectAnnotations } from 'storybook/internal/types';
+
+interface AstroRenderer extends WebRenderer {
+    component: any;
+    storyResult: any;
+}
+/**
+ * Function that sets the globalConfig of your storybook. The global config is the preview module of
+ * your .storybook folder.
+ *
+ * It should be run a single time, so that your global config (e.g. decorators) is applied to your
+ * stories when using `composeStories` or `composeStory`.
+ *
+ * Example:
+ *
+ * ```jsx
+ * // setup-file.js
+ * import { setProjectAnnotations } from '@storybook-astro/framework';
+ * import projectAnnotations from './.storybook/preview';
+ *
+ * setProjectAnnotations(projectAnnotations);
+ * ```
+ *
+ * @param projectAnnotations - E.g. (import projectAnnotations from '../.storybook/preview')
+ */
+declare function setProjectAnnotations(projectAnnotations: NamedOrDefaultProjectAnnotations<AstroRenderer> | NamedOrDefaultProjectAnnotations<AstroRenderer>[]): NormalizedProjectAnnotations<AstroRenderer>;
+/**
+ * Function that will receive a story along with meta (e.g. a default export from a .stories file)
+ * and optionally projectAnnotations e.g. (import * as projectAnnotations from '../.storybook/preview')
+ * and will return a composed component that has all args/parameters/decorators/etc combined and applied to it.
+ *
+ * It's very useful for reusing a story in scenarios outside of Storybook like unit testing.
+ *
+ * Example:
+ * ```jsx
+ * import { render } from '@testing-library/react';
+ * import { composeStory } from '@storybook-astro/framework';
+ * import meta, { Primary as PrimaryStory } from './Button.stories';
+ *
+ * const Primary = composeStory(PrimaryStory, meta);
+ *
+ * test('renders primary button', () => {
+ *   const { getByRole } = render(<Primary>Hello world</Primary>);
+ *   expect(getByRole('button')).toBeInTheDocument();
+ * });
+ * ```
+ *
+ * @param story - E.g. (import { Primary } from './Button.stories')
+ * @param componentAnnotations - E.g. (import meta from './Button.stories')
+ * @param projectAnnotations - E.g. (import * as projectAnnotations from '../.storybook/preview') this can be applied automatically if you use `setProjectAnnotations` in your setup files.
+ * @param exportsName - In case your story does not contain a name and you want it to have a name.
+ */
+declare function composeStory<TArgs extends Args = Args>(story: StoryAnnotationsOrFn<AstroRenderer, TArgs>, componentAnnotations: ComponentAnnotations<AstroRenderer, TArgs>, projectAnnotations?: ProjectAnnotations<AstroRenderer>, exportsName?: string): storybook_internal_types.ComposedStoryFn<AstroRenderer, Partial<TArgs>>;
+/**
+ * Function that will receive a stories import (e.g. `import * as stories from './Button.stories'`)
+ * and optionally a globalConfig (e.g. `import * from '../.storybook/preview`)
+ * and will return an object containing all the stories passed, but now as a composed component that has all args/parameters/decorators/etc combined and applied to it.
+ *
+ * It's very useful for reusing stories in scenarios outside of Storybook like unit testing.
+ *
+ * Example:
+ * ```jsx
+ * import { render } from '@testing-library/react';
+ * import { composeStories } from '@storybook-astro/framework';
+ * import * as stories from './Button.stories';
+ *
+ * const { Primary, Secondary } = composeStories(stories);
+ *
+ * test('renders primary button', () => {
+ *   const { getByRole } = render(<Primary>Hello world</Primary>);
+ *   expect(getByRole('button')).toBeInTheDocument();
+ * });
+ * ```
+ *
+ * @param storiesImport - E.g. (import * as stories from './Button.stories')
+ * @param projectAnnotations - E.g. (import * as globalConfig from '../.storybook/preview') this can be applied automatically if you use `setProjectAnnotations` in your setup files.
+ */
+declare function composeStories<TModule extends Record<string, any>>(storiesImport: TModule, projectAnnotations?: ProjectAnnotations<AstroRenderer>): {
+    [K in keyof Omit<TModule, 'default'>]: any;
+};
+
+export { type AstroRenderer as A, composeStory as a, composeStories as c, setProjectAnnotations as s };

package/dist/preset.d.ts

@@ -0,0 +1,14 @@
+import { c as StorybookConfigVite } from './types-CHTsRtA7.js';
+import 'storybook/internal/types';
+import 'vite';
+import './base-IRZo3zgK.js';
+import 'astro';
+import 'sanitize-html';
+
+declare const core: {
+    builder: string;
+    renderer: string;
+};
+declare const viteFinal: StorybookConfigVite['viteFinal'];
+
+export { core, viteFinal };

package/dist/preset.js

@@ -1,7 +1,11 @@
 import {
   core,
   viteFinal
-} from "./chunk-KTGNRGDJ.js";
+} from "./chunk-UK43WNEA.js";
+import "./chunk-C5OH4VBR.js";
+import "./chunk-E4LB75JN.js";
+import "./chunk-7GHEQUPV.js";
+import "./chunk-DNGQBPT7.js";
 import "./chunk-G3PMV62Z.js";
 export {
   core,

package/dist/testing.d.ts

@@ -0,0 +1,27 @@
+import { A as AstroRenderer, a as composeStory$1, s as setProjectAnnotations$1 } from './portable-stories-BvdaQigq.js';
+import { Store_CSFExports, ProjectAnnotations } from 'storybook/internal/types';
+
+declare function composeStories<TModule extends Store_CSFExports<AstroRenderer> & Record<string, unknown>>(storiesImport: TModule, projectAnnotations?: ProjectAnnotations<AstroRenderer>): { [K in keyof Omit<TModule, "default">]: any; };
+declare const composeStory: typeof composeStory$1;
+declare const setProjectAnnotations: typeof setProjectAnnotations$1;
+
+type StoryMeta = {
+    component: unknown;
+    args?: Record<string, unknown>;
+};
+type ComposedStory = {
+    (...args: unknown[]): unknown;
+    args?: Record<string, unknown>;
+    component?: unknown;
+    run?: () => unknown | Promise<unknown>;
+    storyName?: string;
+    __storybookAstroMeta?: StoryMeta;
+    __storybookAstroStoryExport?: {
+        args?: Record<string, unknown>;
+    };
+};
+
+declare function renderStory(story: ComposedStory): Promise<any>;
+declare const renderAstroStory: typeof renderStory;
+
+export { composeStories, composeStory, renderAstroStory, renderStory, setProjectAnnotations };