@storybook-astro/framework 1.4.0 → 1.5.0-canary.2

package/dist/renderer/renderer-dev.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/renderer/renderer-dev.ts"],"sourcesContent":["import type {\n  RenderComponentInput,\n  RenderPromise,\n  RenderResponseMessage\n} from '@storybook-astro/renderer/types';\n\nconst pendingMessages = new Map<string, RenderPromise>();\nconst ASTRO_SERVER_UNAVAILABLE_ERROR_NAME = 'AstroRenderServerUnavailableError';\n\nexport async function render(data: RenderComponentInput, timeoutMs = 5000) {\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins\n  const id = crypto.randomUUID();\n\n  const promise = new Promise<RenderResponseMessage['data']>((resolve, reject) => {\n    const timeoutId = setTimeout(() => {\n      pendingMessages.delete(id);\n\n      const error = new Error(\n        `Unable to reach Astro rendering server. No render response was received within ${timeoutMs}ms.`\n      );\n\n      error.name = ASTRO_SERVER_UNAVAILABLE_ERROR_NAME;\n\n      reject(error);\n    }, timeoutMs);\n\n    pendingMessages.set(id, { resolve, reject, timeoutId });\n  });\n\n  import.meta.hot?.send('astro:render:request', {\n    ...data,\n    id\n  });\n\n  return promise;\n}\n\nexport function init() {\n  import.meta.hot?.on('vite:afterUpdate', (payload) => {\n    if (payload.updates.some((update) => isAstroStyleUpdate(update.path))) {\n      applyStyles();\n    }\n  });\n\n  import.meta.hot?.on('astro:render:response', (data: RenderResponseMessage['data']) => {\n    if (!data.id || !pendingMessages.has(data.id)) {\n      return;\n    }\n\n    const pendingMessage = pendingMessages.get(data.id);\n\n    if (!pendingMessage) {\n      return;\n    }\n\n    clearTimeout(pendingMessage.timeoutId);\n    pendingMessages.delete(data.id);\n    pendingMessage.resolve(data);\n  });\n}\n\nexport function applyStyles() {\n  Array.from(document.querySelectorAll('style[data-vite-dev-id]'))\n    .filter((element) => /__vite__updateStyle/.test(element.innerHTML))\n    .forEach((element) => {\n      const script = document.createElement('script');\n\n      script.type = 'module';\n\n      const safeScriptContent = element.innerHTML\n        .replaceAll('import.meta.hot.accept(', 'import.meta.hot?.accept(')\n        .replaceAll('import.meta.hot.prune(', 'import.meta.hot?.prune(');\n\n      script.appendChild(document.createTextNode(safeScriptContent));\n      document.head.appendChild(script);\n      document.head.removeChild(script);\n    });\n}\n\nfunction isAstroStyleUpdate(path: string): boolean {\n  return /\\.astro\\?astro&type=style&index=\\d+&lang\\.(css|scss|sass|less|stylus)$/.test(path);\n}\n"],"mappings":";;;AAMA,IAAM,kBAAkB,oBAAI,IAA2B;AACvD,IAAM,sCAAsC;AAE5C,eAAsB,OAAO,MAA4B,YAAY,KAAM;AAEzE,QAAM,KAAK,OAAO,WAAW;AAE7B,QAAM,UAAU,IAAI,QAAuC,CAAC,SAAS,WAAW;AAC9E,UAAM,YAAY,WAAW,MAAM;AACjC,sBAAgB,OAAO,EAAE;AAEzB,YAAM,QAAQ,IAAI;AAAA,QAChB,kFAAkF,SAAS;AAAA,MAC7F;AAEA,YAAM,OAAO;AAEb,aAAO,KAAK;AAAA,IACd,GAAG,SAAS;AAEZ,oBAAgB,IAAI,IAAI,EAAE,SAAS,QAAQ,UAAU,CAAC;AAAA,EACxD,CAAC;AAED,cAAY,KAAK,KAAK,wBAAwB;AAAA,IAC5C,GAAG;AAAA,IACH;AAAA,EACF,CAAC;AAED,SAAO;AACT;AAEO,SAAS,OAAO;AACrB,cAAY,KAAK,GAAG,oBAAoB,CAAC,YAAY;AACnD,QAAI,QAAQ,QAAQ,KAAK,CAAC,WAAW,mBAAmB,OAAO,IAAI,CAAC,GAAG;AACrE,kBAAY;AAAA,IACd;AAAA,EACF,CAAC;AAED,cAAY,KAAK,GAAG,yBAAyB,CAAC,SAAwC;AACpF,QAAI,CAAC,KAAK,MAAM,CAAC,gBAAgB,IAAI,KAAK,EAAE,GAAG;AAC7C;AAAA,IACF;AAEA,UAAM,iBAAiB,gBAAgB,IAAI,KAAK,EAAE;AAElD,QAAI,CAAC,gBAAgB;AACnB;AAAA,IACF;AAEA,iBAAa,eAAe,SAAS;AACrC,oBAAgB,OAAO,KAAK,EAAE;AAC9B,mBAAe,QAAQ,IAAI;AAAA,EAC7B,CAAC;AACH;AAEO,SAAS,cAAc;AAC5B,QAAM,KAAK,SAAS,iBAAiB,yBAAyB,CAAC,EAC5D,OAAO,CAAC,YAAY,sBAAsB,KAAK,QAAQ,SAAS,CAAC,EACjE,QAAQ,CAAC,YAAY;AACpB,UAAM,SAAS,SAAS,cAAc,QAAQ;AAE9C,WAAO,OAAO;AAEd,UAAM,oBAAoB,QAAQ,UAC/B,WAAW,2BAA2B,0BAA0B,EAChE,WAAW,0BAA0B,yBAAyB;AAEjE,WAAO,YAAY,SAAS,eAAe,iBAAiB,CAAC;AAC7D,aAAS,KAAK,YAAY,MAAM;AAChC,aAAS,KAAK,YAAY,MAAM;AAAA,EAClC,CAAC;AACL;AAEA,SAAS,mBAAmB,MAAuB;AACjD,SAAO,yEAAyE,KAAK,IAAI;AAC3F;","names":[]}
+{"version":3,"sources":["../../src/renderer/renderer-dev.ts"],"sourcesContent":["import type {\n  RenderComponentInput,\n  RenderPromise,\n  RenderResponseMessage\n} from '@storybook-astro/renderer/types';\n\nconst pendingMessages = new Map<string, RenderPromise>();\nconst ASTRO_SERVER_UNAVAILABLE_ERROR_NAME = 'AstroRenderServerUnavailableError';\n\nexport const isStaticMode = false;\n\nexport async function render(data: RenderComponentInput, timeoutMs = 5000) {\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins\n  const id = crypto.randomUUID();\n\n  const promise = new Promise<RenderResponseMessage['data']>((resolve, reject) => {\n    const timeoutId = setTimeout(() => {\n      pendingMessages.delete(id);\n\n      const error = new Error(\n        `Unable to reach Astro rendering server. No render response was received within ${timeoutMs}ms.`\n      );\n\n      error.name = ASTRO_SERVER_UNAVAILABLE_ERROR_NAME;\n\n      reject(error);\n    }, timeoutMs);\n\n    pendingMessages.set(id, { resolve, reject, timeoutId });\n  });\n\n  import.meta.hot?.send('astro:render:request', {\n    ...data,\n    id\n  });\n\n  return promise;\n}\n\nexport function init() {\n  import.meta.hot?.on('vite:afterUpdate', (payload) => {\n    if (payload.updates.some((update) => isAstroStyleUpdate(update.path))) {\n      applyStyles();\n    }\n  });\n\n  import.meta.hot?.on('astro:render:response', (data: RenderResponseMessage['data']) => {\n    if (!data.id || !pendingMessages.has(data.id)) {\n      return;\n    }\n\n    const pendingMessage = pendingMessages.get(data.id);\n\n    if (!pendingMessage) {\n      return;\n    }\n\n    clearTimeout(pendingMessage.timeoutId);\n    pendingMessages.delete(data.id);\n    pendingMessage.resolve(data);\n  });\n}\n\nexport function applyStyles() {\n  Array.from(document.querySelectorAll('style[data-vite-dev-id]'))\n    .filter((element) => /__vite__updateStyle/.test(element.innerHTML))\n    .forEach((element) => {\n      const script = document.createElement('script');\n\n      script.type = 'module';\n\n      const safeScriptContent = element.innerHTML\n        .replaceAll('import.meta.hot.accept(', 'import.meta.hot?.accept(')\n        .replaceAll('import.meta.hot.prune(', 'import.meta.hot?.prune(');\n\n      script.appendChild(document.createTextNode(safeScriptContent));\n      document.head.appendChild(script);\n      document.head.removeChild(script);\n    });\n}\n\nfunction isAstroStyleUpdate(path: string): boolean {\n  return /\\.astro\\?astro&type=style&index=\\d+&lang\\.(css|scss|sass|less|stylus)$/.test(path);\n}\n"],"mappings":";;;AAMA,IAAM,kBAAkB,oBAAI,IAA2B;AACvD,IAAM,sCAAsC;AAErC,IAAM,eAAe;AAE5B,eAAsB,OAAO,MAA4B,YAAY,KAAM;AAEzE,QAAM,KAAK,OAAO,WAAW;AAE7B,QAAM,UAAU,IAAI,QAAuC,CAAC,SAAS,WAAW;AAC9E,UAAM,YAAY,WAAW,MAAM;AACjC,sBAAgB,OAAO,EAAE;AAEzB,YAAM,QAAQ,IAAI;AAAA,QAChB,kFAAkF,SAAS;AAAA,MAC7F;AAEA,YAAM,OAAO;AAEb,aAAO,KAAK;AAAA,IACd,GAAG,SAAS;AAEZ,oBAAgB,IAAI,IAAI,EAAE,SAAS,QAAQ,UAAU,CAAC;AAAA,EACxD,CAAC;AAED,cAAY,KAAK,KAAK,wBAAwB;AAAA,IAC5C,GAAG;AAAA,IACH;AAAA,EACF,CAAC;AAED,SAAO;AACT;AAEO,SAAS,OAAO;AACrB,cAAY,KAAK,GAAG,oBAAoB,CAAC,YAAY;AACnD,QAAI,QAAQ,QAAQ,KAAK,CAAC,WAAW,mBAAmB,OAAO,IAAI,CAAC,GAAG;AACrE,kBAAY;AAAA,IACd;AAAA,EACF,CAAC;AAED,cAAY,KAAK,GAAG,yBAAyB,CAAC,SAAwC;AACpF,QAAI,CAAC,KAAK,MAAM,CAAC,gBAAgB,IAAI,KAAK,EAAE,GAAG;AAC7C;AAAA,IACF;AAEA,UAAM,iBAAiB,gBAAgB,IAAI,KAAK,EAAE;AAElD,QAAI,CAAC,gBAAgB;AACnB;AAAA,IACF;AAEA,iBAAa,eAAe,SAAS;AACrC,oBAAgB,OAAO,KAAK,EAAE;AAC9B,mBAAe,QAAQ,IAAI;AAAA,EAC7B,CAAC;AACH;AAEO,SAAS,cAAc;AAC5B,QAAM,KAAK,SAAS,iBAAiB,yBAAyB,CAAC,EAC5D,OAAO,CAAC,YAAY,sBAAsB,KAAK,QAAQ,SAAS,CAAC,EACjE,QAAQ,CAAC,YAAY;AACpB,UAAM,SAAS,SAAS,cAAc,QAAQ;AAE9C,WAAO,OAAO;AAEd,UAAM,oBAAoB,QAAQ,UAC/B,WAAW,2BAA2B,0BAA0B,EAChE,WAAW,0BAA0B,yBAAyB;AAEjE,WAAO,YAAY,SAAS,eAAe,iBAAiB,CAAC;AAC7D,aAAS,KAAK,YAAY,MAAM;AAChC,aAAS,KAAK,YAAY,MAAM;AAAA,EAClC,CAAC;AACL;AAEA,SAAS,mBAAmB,MAAuB;AACjD,SAAO,yEAAyE,KAAK,IAAI;AAC3F;","names":[]}

package/dist/renderer/renderer-server.js

@@ -1,6 +1,7 @@
 import "../chunk-G3PMV62Z.js";
 
 // src/renderer/renderer-server.ts
+var isStaticMode = false;
 var ASTRO_SERVER_UNAVAILABLE_ERROR_NAME = "AstroRenderServerUnavailableError";
 function createServerRenderer(defaults = {}) {
   return {
@@ -87,6 +88,7 @@ function createServerUnavailableError(serverUrl, reason) {
   return error;
 }
 export {
-  createServerRenderer
+  createServerRenderer,
+  isStaticMode
 };
 //# sourceMappingURL=renderer-server.js.map

package/dist/renderer/renderer-server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/renderer/renderer-server.ts"],"sourcesContent":["import type { RenderComponentInput, RenderResponseMessage } from '@storybook-astro/renderer/types';\n\ntype StorybookImportMetaEnv = ImportMeta & {\n  env?: Record<string, string | undefined>;\n};\n\ntype StorybookGlobalEnv = typeof globalThis & {\n  STORYBOOK_ASTRO_SERVER_URL?: string;\n  STORYBOOK_ASTRO_SERVER_TOKEN?: string;\n  STORYBOOK_ASTRO_SERVER_AUTH_HEADER?: string;\n};\n\ntype ServerRendererDefaults = {\n  serverUrl?: string;\n  authToken?: string;\n  authHeader?: string;\n};\n\nconst ASTRO_SERVER_UNAVAILABLE_ERROR_NAME = 'AstroRenderServerUnavailableError';\n\nexport function createServerRenderer(defaults: ServerRendererDefaults = {}) {\n  return {\n    render(data: RenderComponentInput, timeoutMs = 5000) {\n      return renderWithHttp(data, timeoutMs, defaults);\n    },\n    init() {\n      return;\n    },\n    applyStyles() {\n      return;\n    }\n  };\n}\n\nasync function renderWithHttp(\n  data: RenderComponentInput,\n  timeoutMs: number,\n  defaults: ServerRendererDefaults\n) {\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins\n  const id = crypto.randomUUID();\n  const serverUrl = resolveServerUrl(defaults);\n  const authToken = resolveAuthToken(defaults);\n  const authHeader = resolveAuthHeader(defaults);\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n  try {\n    const headers: Record<string, string> = {\n      'content-type': 'application/json'\n    };\n\n    if (authToken) {\n      headers[authHeader] =\n        authHeader.toLowerCase() === 'authorization' && !authToken.startsWith('Bearer ')\n          ? `Bearer ${authToken}`\n          : authToken;\n    }\n\n    // eslint-disable-next-line n/no-unsupported-features/node-builtins\n    const response = await fetch(`${serverUrl}/render`, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(data),\n      signal: controller.signal\n    });\n\n    clearTimeout(timeoutId);\n\n    if (response.status === 401 || response.status === 403) {\n      throw new Error(\n        `Astro rendering server rejected the request with ${response.status}. ` +\n          `Check STORYBOOK_ASTRO_SERVER_TOKEN and auth header configuration.`\n      );\n    }\n\n    if (!response.ok) {\n      throw new Error(`Server responded with ${response.status}: ${response.statusText}`);\n    }\n\n    const html = await response.text();\n\n    return {\n      id,\n      html\n    } satisfies RenderResponseMessage['data'];\n  } catch (error) {\n    clearTimeout(timeoutId);\n\n    if (error instanceof Error && error.name === 'AbortError') {\n      throw createServerUnavailableError(\n        serverUrl,\n        `Request timed out after ${timeoutMs}ms while waiting for a render response.`\n      );\n    }\n\n    if (error instanceof TypeError) {\n      throw createServerUnavailableError(\n        serverUrl,\n        'The Astro rendering server is not reachable over HTTP.'\n      );\n    }\n\n    throw error;\n  }\n}\n\nfunction resolveServerUrl(defaults: ServerRendererDefaults) {\n  const envServerUrl = (import.meta as StorybookImportMetaEnv).env?.STORYBOOK_ASTRO_SERVER_URL;\n  const globalServerUrl = (globalThis as StorybookGlobalEnv).STORYBOOK_ASTRO_SERVER_URL;\n\n  return defaults.serverUrl || envServerUrl || globalServerUrl || 'http://localhost:3000';\n}\n\nfunction resolveAuthToken(defaults: ServerRendererDefaults) {\n  const envAuthToken = (import.meta as StorybookImportMetaEnv).env?.STORYBOOK_ASTRO_SERVER_TOKEN;\n  const globalAuthToken = (globalThis as StorybookGlobalEnv).STORYBOOK_ASTRO_SERVER_TOKEN;\n\n  return defaults.authToken || envAuthToken || globalAuthToken;\n}\n\nfunction resolveAuthHeader(defaults: ServerRendererDefaults) {\n  const envAuthHeader = (import.meta as StorybookImportMetaEnv).env?.STORYBOOK_ASTRO_SERVER_AUTH_HEADER;\n  const globalAuthHeader = (globalThis as StorybookGlobalEnv).STORYBOOK_ASTRO_SERVER_AUTH_HEADER;\n\n  return (defaults.authHeader || envAuthHeader || globalAuthHeader || 'authorization').toLowerCase();\n}\n\nfunction createServerUnavailableError(serverUrl: string, reason: string) {\n  const error = new Error(`Unable to reach Astro rendering server at ${serverUrl}. ${reason}`);\n\n  error.name = ASTRO_SERVER_UNAVAILABLE_ERROR_NAME;\n\n  return error;\n}\n"],"mappings":";;;AAkBA,IAAM,sCAAsC;AAErC,SAAS,qBAAqB,WAAmC,CAAC,GAAG;AAC1E,SAAO;AAAA,IACL,OAAO,MAA4B,YAAY,KAAM;AACnD,aAAO,eAAe,MAAM,WAAW,QAAQ;AAAA,IACjD;AAAA,IACA,OAAO;AACL;AAAA,IACF;AAAA,IACA,cAAc;AACZ;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAe,eACb,MACA,WACA,UACA;AAEA,QAAM,KAAK,OAAO,WAAW;AAC7B,QAAM,YAAY,iBAAiB,QAAQ;AAC3C,QAAM,YAAY,iBAAiB,QAAQ;AAC3C,QAAM,aAAa,kBAAkB,QAAQ;AAC7C,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,YAAY,WAAW,MAAM,WAAW,MAAM,GAAG,SAAS;AAEhE,MAAI;AACF,UAAM,UAAkC;AAAA,MACtC,gBAAgB;AAAA,IAClB;AAEA,QAAI,WAAW;AACb,cAAQ,UAAU,IAChB,WAAW,YAAY,MAAM,mBAAmB,CAAC,UAAU,WAAW,SAAS,IAC3E,UAAU,SAAS,KACnB;AAAA,IACR;AAGA,UAAM,WAAW,MAAM,MAAM,GAAG,SAAS,WAAW;AAAA,MAClD,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU,IAAI;AAAA,MACzB,QAAQ,WAAW;AAAA,IACrB,CAAC;AAED,iBAAa,SAAS;AAEtB,QAAI,SAAS,WAAW,OAAO,SAAS,WAAW,KAAK;AACtD,YAAM,IAAI;AAAA,QACR,oDAAoD,SAAS,MAAM;AAAA,MAErE;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,yBAAyB,SAAS,MAAM,KAAK,SAAS,UAAU,EAAE;AAAA,IACpF;AAEA,UAAM,OAAO,MAAM,SAAS,KAAK;AAEjC,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,iBAAa,SAAS;AAEtB,QAAI,iBAAiB,SAAS,MAAM,SAAS,cAAc;AACzD,YAAM;AAAA,QACJ;AAAA,QACA,2BAA2B,SAAS;AAAA,MACtC;AAAA,IACF;AAEA,QAAI,iBAAiB,WAAW;AAC9B,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM;AAAA,EACR;AACF;AAEA,SAAS,iBAAiB,UAAkC;AAC1D,QAAM,eAAgB,YAAuC,KAAK;AAClE,QAAM,kBAAmB,WAAkC;AAE3D,SAAO,SAAS,aAAa,gBAAgB,mBAAmB;AAClE;AAEA,SAAS,iBAAiB,UAAkC;AAC1D,QAAM,eAAgB,YAAuC,KAAK;AAClE,QAAM,kBAAmB,WAAkC;AAE3D,SAAO,SAAS,aAAa,gBAAgB;AAC/C;AAEA,SAAS,kBAAkB,UAAkC;AAC3D,QAAM,gBAAiB,YAAuC,KAAK;AACnE,QAAM,mBAAoB,WAAkC;AAE5D,UAAQ,SAAS,cAAc,iBAAiB,oBAAoB,iBAAiB,YAAY;AACnG;AAEA,SAAS,6BAA6B,WAAmB,QAAgB;AACvE,QAAM,QAAQ,IAAI,MAAM,6CAA6C,SAAS,KAAK,MAAM,EAAE;AAE3F,QAAM,OAAO;AAEb,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/renderer/renderer-server.ts"],"sourcesContent":["import type { RenderComponentInput, RenderResponseMessage } from '@storybook-astro/renderer/types';\n\nexport const isStaticMode = false;\n\ntype StorybookImportMetaEnv = ImportMeta & {\n  env?: Record<string, string | undefined>;\n};\n\ntype StorybookGlobalEnv = typeof globalThis & {\n  STORYBOOK_ASTRO_SERVER_URL?: string;\n  STORYBOOK_ASTRO_SERVER_TOKEN?: string;\n  STORYBOOK_ASTRO_SERVER_AUTH_HEADER?: string;\n};\n\ntype ServerRendererDefaults = {\n  serverUrl?: string;\n  authToken?: string;\n  authHeader?: string;\n};\n\nconst ASTRO_SERVER_UNAVAILABLE_ERROR_NAME = 'AstroRenderServerUnavailableError';\n\nexport function createServerRenderer(defaults: ServerRendererDefaults = {}) {\n  return {\n    render(data: RenderComponentInput, timeoutMs = 5000) {\n      return renderWithHttp(data, timeoutMs, defaults);\n    },\n    init() {\n      return;\n    },\n    applyStyles() {\n      return;\n    }\n  };\n}\n\nasync function renderWithHttp(\n  data: RenderComponentInput,\n  timeoutMs: number,\n  defaults: ServerRendererDefaults\n) {\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins\n  const id = crypto.randomUUID();\n  const serverUrl = resolveServerUrl(defaults);\n  const authToken = resolveAuthToken(defaults);\n  const authHeader = resolveAuthHeader(defaults);\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n  try {\n    const headers: Record<string, string> = {\n      'content-type': 'application/json'\n    };\n\n    if (authToken) {\n      headers[authHeader] =\n        authHeader.toLowerCase() === 'authorization' && !authToken.startsWith('Bearer ')\n          ? `Bearer ${authToken}`\n          : authToken;\n    }\n\n    // eslint-disable-next-line n/no-unsupported-features/node-builtins\n    const response = await fetch(`${serverUrl}/render`, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(data),\n      signal: controller.signal\n    });\n\n    clearTimeout(timeoutId);\n\n    if (response.status === 401 || response.status === 403) {\n      throw new Error(\n        `Astro rendering server rejected the request with ${response.status}. ` +\n          `Check STORYBOOK_ASTRO_SERVER_TOKEN and auth header configuration.`\n      );\n    }\n\n    if (!response.ok) {\n      throw new Error(`Server responded with ${response.status}: ${response.statusText}`);\n    }\n\n    const html = await response.text();\n\n    return {\n      id,\n      html\n    } satisfies RenderResponseMessage['data'];\n  } catch (error) {\n    clearTimeout(timeoutId);\n\n    if (error instanceof Error && error.name === 'AbortError') {\n      throw createServerUnavailableError(\n        serverUrl,\n        `Request timed out after ${timeoutMs}ms while waiting for a render response.`\n      );\n    }\n\n    if (error instanceof TypeError) {\n      throw createServerUnavailableError(\n        serverUrl,\n        'The Astro rendering server is not reachable over HTTP.'\n      );\n    }\n\n    throw error;\n  }\n}\n\nfunction resolveServerUrl(defaults: ServerRendererDefaults) {\n  const envServerUrl = (import.meta as StorybookImportMetaEnv).env?.STORYBOOK_ASTRO_SERVER_URL;\n  const globalServerUrl = (globalThis as StorybookGlobalEnv).STORYBOOK_ASTRO_SERVER_URL;\n\n  return defaults.serverUrl || envServerUrl || globalServerUrl || 'http://localhost:3000';\n}\n\nfunction resolveAuthToken(defaults: ServerRendererDefaults) {\n  const envAuthToken = (import.meta as StorybookImportMetaEnv).env?.STORYBOOK_ASTRO_SERVER_TOKEN;\n  const globalAuthToken = (globalThis as StorybookGlobalEnv).STORYBOOK_ASTRO_SERVER_TOKEN;\n\n  return defaults.authToken || envAuthToken || globalAuthToken;\n}\n\nfunction resolveAuthHeader(defaults: ServerRendererDefaults) {\n  const envAuthHeader = (import.meta as StorybookImportMetaEnv).env?.STORYBOOK_ASTRO_SERVER_AUTH_HEADER;\n  const globalAuthHeader = (globalThis as StorybookGlobalEnv).STORYBOOK_ASTRO_SERVER_AUTH_HEADER;\n\n  return (defaults.authHeader || envAuthHeader || globalAuthHeader || 'authorization').toLowerCase();\n}\n\nfunction createServerUnavailableError(serverUrl: string, reason: string) {\n  const error = new Error(`Unable to reach Astro rendering server at ${serverUrl}. ${reason}`);\n\n  error.name = ASTRO_SERVER_UNAVAILABLE_ERROR_NAME;\n\n  return error;\n}\n"],"mappings":";;;AAEO,IAAM,eAAe;AAkB5B,IAAM,sCAAsC;AAErC,SAAS,qBAAqB,WAAmC,CAAC,GAAG;AAC1E,SAAO;AAAA,IACL,OAAO,MAA4B,YAAY,KAAM;AACnD,aAAO,eAAe,MAAM,WAAW,QAAQ;AAAA,IACjD;AAAA,IACA,OAAO;AACL;AAAA,IACF;AAAA,IACA,cAAc;AACZ;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAe,eACb,MACA,WACA,UACA;AAEA,QAAM,KAAK,OAAO,WAAW;AAC7B,QAAM,YAAY,iBAAiB,QAAQ;AAC3C,QAAM,YAAY,iBAAiB,QAAQ;AAC3C,QAAM,aAAa,kBAAkB,QAAQ;AAC7C,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,YAAY,WAAW,MAAM,WAAW,MAAM,GAAG,SAAS;AAEhE,MAAI;AACF,UAAM,UAAkC;AAAA,MACtC,gBAAgB;AAAA,IAClB;AAEA,QAAI,WAAW;AACb,cAAQ,UAAU,IAChB,WAAW,YAAY,MAAM,mBAAmB,CAAC,UAAU,WAAW,SAAS,IAC3E,UAAU,SAAS,KACnB;AAAA,IACR;AAGA,UAAM,WAAW,MAAM,MAAM,GAAG,SAAS,WAAW;AAAA,MAClD,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU,IAAI;AAAA,MACzB,QAAQ,WAAW;AAAA,IACrB,CAAC;AAED,iBAAa,SAAS;AAEtB,QAAI,SAAS,WAAW,OAAO,SAAS,WAAW,KAAK;AACtD,YAAM,IAAI;AAAA,QACR,oDAAoD,SAAS,MAAM;AAAA,MAErE;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,yBAAyB,SAAS,MAAM,KAAK,SAAS,UAAU,EAAE;AAAA,IACpF;AAEA,UAAM,OAAO,MAAM,SAAS,KAAK;AAEjC,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,iBAAa,SAAS;AAEtB,QAAI,iBAAiB,SAAS,MAAM,SAAS,cAAc;AACzD,YAAM;AAAA,QACJ;AAAA,QACA,2BAA2B,SAAS;AAAA,MACtC;AAAA,IACF;AAEA,QAAI,iBAAiB,WAAW;AAC9B,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM;AAAA,EACR;AACF;AAEA,SAAS,iBAAiB,UAAkC;AAC1D,QAAM,eAAgB,YAAuC,KAAK;AAClE,QAAM,kBAAmB,WAAkC;AAE3D,SAAO,SAAS,aAAa,gBAAgB,mBAAmB;AAClE;AAEA,SAAS,iBAAiB,UAAkC;AAC1D,QAAM,eAAgB,YAAuC,KAAK;AAClE,QAAM,kBAAmB,WAAkC;AAE3D,SAAO,SAAS,aAAa,gBAAgB;AAC/C;AAEA,SAAS,kBAAkB,UAAkC;AAC3D,QAAM,gBAAiB,YAAuC,KAAK;AACnE,QAAM,mBAAoB,WAAkC;AAE5D,UAAQ,SAAS,cAAc,iBAAiB,oBAAoB,iBAAiB,YAAY;AACnG;AAEA,SAAS,6BAA6B,WAAmB,QAAgB;AACvE,QAAM,QAAQ,IAAI,MAAM,6CAA6C,SAAS,KAAK,MAAM,EAAE;AAE3F,QAAM,OAAO;AAEb,SAAO;AACT;","names":[]}

package/dist/renderer/renderer-static.js

@@ -2,6 +2,7 @@ import "../chunk-G3PMV62Z.js";
 
 // src/renderer/renderer-static.ts
 var PRERENDERED_STORIES_FILE = "astro-prerendered-stories.json";
+var isStaticMode = true;
 var prerenderedStoriesPromise;
 async function render(data) {
   const id = crypto.randomUUID();
@@ -49,6 +50,7 @@ function resolvePrerenderedStoriesUrl() {
 export {
   applyStyles,
   init,
+  isStaticMode,
   render
 };
 //# sourceMappingURL=renderer-static.js.map

package/dist/renderer/renderer-static.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/renderer/renderer-static.ts"],"sourcesContent":["import type { RenderComponentInput, RenderResponseMessage } from '@storybook-astro/renderer/types';\n\nconst PRERENDERED_STORIES_FILE = 'astro-prerendered-stories.json';\n\nlet prerenderedStoriesPromise: Promise<Record<string, string>> | undefined;\n\nexport async function render(data: RenderComponentInput) {\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins\n  const id = crypto.randomUUID();\n  const storyId = data.story?.id;\n\n  if (!storyId) {\n    throw new Error(\n      'Astro static renderer expected a story id, but none was provided in the render payload.'\n    );\n  }\n\n  const prerenderedStories = await loadPrerenderedStories();\n  const html = prerenderedStories[storyId];\n\n  if (html === undefined) {\n    throw new Error(\n      `No prerendered HTML was found for story \"${storyId}\". Rebuild Storybook static output.`\n    );\n  }\n\n  return {\n    id,\n    html\n  } satisfies RenderResponseMessage['data'];\n}\n\nexport function init() {\n  return;\n}\n\nexport function applyStyles() {\n  return;\n}\n\nasync function loadPrerenderedStories() {\n  if (!prerenderedStoriesPromise) {\n    const jsonPath = resolvePrerenderedStoriesUrl();\n\n    // eslint-disable-next-line n/no-unsupported-features/node-builtins\n    prerenderedStoriesPromise = fetch(jsonPath).then(async (response) => {\n      if (!response.ok) {\n        throw new Error(\n          `Failed to load ${PRERENDERED_STORIES_FILE}. Received ${response.status} ${response.statusText}.`\n        );\n      }\n\n      return (await response.json()) as Record<string, string>;\n    });\n  }\n\n  return prerenderedStoriesPromise;\n}\n\nfunction resolvePrerenderedStoriesUrl() {\n  return new URL(PRERENDERED_STORIES_FILE, window.location.href).toString();\n}\n"],"mappings":";;;AAEA,IAAM,2BAA2B;AAEjC,IAAI;AAEJ,eAAsB,OAAO,MAA4B;AAEvD,QAAM,KAAK,OAAO,WAAW;AAC7B,QAAM,UAAU,KAAK,OAAO;AAE5B,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,qBAAqB,MAAM,uBAAuB;AACxD,QAAM,OAAO,mBAAmB,OAAO;AAEvC,MAAI,SAAS,QAAW;AACtB,UAAM,IAAI;AAAA,MACR,4CAA4C,OAAO;AAAA,IACrD;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,OAAO;AACrB;AACF;AAEO,SAAS,cAAc;AAC5B;AACF;AAEA,eAAe,yBAAyB;AACtC,MAAI,CAAC,2BAA2B;AAC9B,UAAM,WAAW,6BAA6B;AAG9C,gCAA4B,MAAM,QAAQ,EAAE,KAAK,OAAO,aAAa;AACnE,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,IAAI;AAAA,UACR,kBAAkB,wBAAwB,cAAc,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,QAChG;AAAA,MACF;AAEA,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAEA,SAAS,+BAA+B;AACtC,SAAO,IAAI,IAAI,0BAA0B,OAAO,SAAS,IAAI,EAAE,SAAS;AAC1E;","names":[]}
+{"version":3,"sources":["../../src/renderer/renderer-static.ts"],"sourcesContent":["import type { RenderComponentInput, RenderResponseMessage } from '@storybook-astro/renderer/types';\n\nconst PRERENDERED_STORIES_FILE = 'astro-prerendered-stories.json';\n\nexport const isStaticMode = true;\n\nlet prerenderedStoriesPromise: Promise<Record<string, string>> | undefined;\n\nexport async function render(data: RenderComponentInput) {\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins\n  const id = crypto.randomUUID();\n  const storyId = data.story?.id;\n\n  if (!storyId) {\n    throw new Error(\n      'Astro static renderer expected a story id, but none was provided in the render payload.'\n    );\n  }\n\n  const prerenderedStories = await loadPrerenderedStories();\n  const html = prerenderedStories[storyId];\n\n  if (html === undefined) {\n    throw new Error(\n      `No prerendered HTML was found for story \"${storyId}\". Rebuild Storybook static output.`\n    );\n  }\n\n  return {\n    id,\n    html\n  } satisfies RenderResponseMessage['data'];\n}\n\nexport function init() {\n  return;\n}\n\nexport function applyStyles() {\n  return;\n}\n\nasync function loadPrerenderedStories() {\n  if (!prerenderedStoriesPromise) {\n    const jsonPath = resolvePrerenderedStoriesUrl();\n\n    // eslint-disable-next-line n/no-unsupported-features/node-builtins\n    prerenderedStoriesPromise = fetch(jsonPath).then(async (response) => {\n      if (!response.ok) {\n        throw new Error(\n          `Failed to load ${PRERENDERED_STORIES_FILE}. Received ${response.status} ${response.statusText}.`\n        );\n      }\n\n      return (await response.json()) as Record<string, string>;\n    });\n  }\n\n  return prerenderedStoriesPromise;\n}\n\nfunction resolvePrerenderedStoriesUrl() {\n  return new URL(PRERENDERED_STORIES_FILE, window.location.href).toString();\n}\n"],"mappings":";;;AAEA,IAAM,2BAA2B;AAE1B,IAAM,eAAe;AAE5B,IAAI;AAEJ,eAAsB,OAAO,MAA4B;AAEvD,QAAM,KAAK,OAAO,WAAW;AAC7B,QAAM,UAAU,KAAK,OAAO;AAE5B,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,qBAAqB,MAAM,uBAAuB;AACxD,QAAM,OAAO,mBAAmB,OAAO;AAEvC,MAAI,SAAS,QAAW;AACtB,UAAM,IAAI;AAAA,MACR,4CAA4C,OAAO;AAAA,IACrD;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,OAAO;AACrB;AACF;AAEO,SAAS,cAAc;AAC5B;AACF;AAEA,eAAe,yBAAyB;AACtC,MAAI,CAAC,2BAA2B;AAC9B,UAAM,WAAW,6BAA6B;AAG9C,gCAA4B,MAAM,QAAQ,EAAE,KAAK,OAAO,aAAa;AACnE,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,IAAI;AAAA,UACR,kBAAkB,wBAAwB,cAAc,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,QAChG;AAAA,MACF;AAEA,aAAQ,MAAM,SAAS,KAAK;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAEA,SAAS,+BAA+B;AACtC,SAAO,IAAI,IAAI,0BAA0B,OAAO,SAAS,IAAI,EAAE,SAAS;AAC1E;","names":[]}

package/dist/testing.js

@@ -1,7 +1,7 @@
 import {
   renderViaTestingRendererDaemon,
   runWithWorkingDirectory
-} from "./chunk-BV6V2Z4X.js";
+} from "./chunk-XVVIGJV6.js";
 import {
   resolveTestingIntegrationsForRoot
 } from "./chunk-WUTCMEF5.js";
@@ -12,7 +12,7 @@ import {
 } from "./chunk-KXAAX3GN.js";
 import {
   ssrLoadModuleWithFsFallback
-} from "./chunk-VZXGPM6P.js";
+} from "./chunk-7UF6LK4Z.js";
 import "./chunk-PUTCAN6X.js";
 import "./chunk-7YBE4TTI.js";
 import "./chunk-B5HHF6FC.js";
@@ -213,7 +213,7 @@ async function getAstroContainer() {
 }
 async function getAstroSsrViteServer(resolveFrom) {
   if (!astroSsrViteServerPromises.has(resolveFrom)) {
-    const { createViteServer } = await import("./viteStorybookAstroMiddlewarePlugin-246I5D3Y.js");
+    const { createViteServer } = await import("./viteStorybookAstroMiddlewarePlugin-LUMKF7NG.js");
     const integrations = getTestingIntegrations(resolveFrom);
     astroSsrViteServerPromises.set(
       resolveFrom,

package/dist/{viteStorybookAstroMiddlewarePlugin-246I5D3Y.js → viteStorybookAstroMiddlewarePlugin-LUMKF7NG.js}

@@ -1,7 +1,7 @@
 import {
   createViteServer,
   vitePluginStorybookAstroMiddleware
-} from "./chunk-VZXGPM6P.js";
+} from "./chunk-7UF6LK4Z.js";
 import "./chunk-PUTCAN6X.js";
 import "./chunk-B5HHF6FC.js";
 import "./chunk-G3PMV62Z.js";
@@ -9,4 +9,4 @@ export {
   createViteServer,
   vitePluginStorybookAstroMiddleware
 };
-//# sourceMappingURL=viteStorybookAstroMiddlewarePlugin-246I5D3Y.js.map
+//# sourceMappingURL=viteStorybookAstroMiddlewarePlugin-LUMKF7NG.js.map

package/dist/vitest/global-setup.js

@@ -1,9 +1,9 @@
 import {
   TESTING_RENDERER_DAEMON_URL_ENV,
   startTestingRendererDaemon
-} from "../chunk-BV6V2Z4X.js";
+} from "../chunk-XVVIGJV6.js";
 import "../chunk-WUTCMEF5.js";
-import "../chunk-VZXGPM6P.js";
+import "../chunk-7UF6LK4Z.js";
 import "../chunk-PUTCAN6X.js";
 import "../chunk-7YBE4TTI.js";
 import "../chunk-B5HHF6FC.js";

package/dist/vitest/index.js

@@ -1,6 +1,6 @@
 import {
   vitePluginAstroComponentMarker
-} from "../chunk-E4LB75JN.js";
+} from "../chunk-6RIGYMZP.js";
 import {
   registerTestingIntegrationsForRoot
 } from "../chunk-WUTCMEF5.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storybook-astro/framework",
-  "version": "1.4.0",
+  "version": "1.5.0-canary.2",
   "description": "Community-supported Storybook framework for Astro 5 & 6 components",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -51,6 +51,9 @@
       "types": "./dist/preset.d.ts",
       "import": "./dist/preset.js"
     },
+    "./shim": {
+      "types": "./src/shim.d.ts"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -142,7 +145,7 @@
     }
   },
   "dependencies": {
-    "@storybook-astro/renderer": "1.4.0",
+    "@storybook-astro/renderer": "1.5.0-canary.2",
     "hono": "^4.11.12",
     "sanitize-html": "^2.17.0",
     "tsconfck": "^3.1.6",

package/src/loadUserAstroConfig.test.ts

@@ -0,0 +1,149 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, test } from 'vitest';
+import {
+  loadUserAstroFonts,
+  loadUserAstroIntegrations,
+  loadUserAstroVitePlugins
+} from './loadUserAstroConfig.ts';
+
+let tmpDir: string;
+
+beforeEach(async () => {
+  tmpDir = await mkdtemp(join(tmpdir(), 'storybook-astro-user-config-'));
+});
+
+afterEach(async () => {
+  await rm(tmpDir, { recursive: true, force: true });
+});
+
+async function writeConfig(body: string) {
+  await writeFile(join(tmpDir, 'astro.config.mjs'), body);
+}
+
+describe('loadUserAstroFonts', () => {
+  test('returns the fonts array from astro.config.*', async () => {
+    await writeConfig(`
+      export default {
+        fonts: [
+          {
+            provider: { name: 'fake', resolveFont: () => undefined },
+            name: 'Inter',
+            cssVariable: '--font-inter'
+          },
+          {
+            provider: { name: 'fake', resolveFont: () => undefined },
+            name: 'Roboto',
+            cssVariable: '--font-roboto'
+          }
+        ]
+      };
+    `);
+
+    const fonts = await loadUserAstroFonts(tmpDir);
+
+    expect(fonts).toHaveLength(2);
+    expect(fonts.map((f) => f.cssVariable)).toEqual(['--font-inter', '--font-roboto']);
+  });
+
+  test('returns [] when astro.config.* has no fonts', async () => {
+    await writeConfig(`export default { integrations: [] };`);
+
+    expect(await loadUserAstroFonts(tmpDir)).toEqual([]);
+  });
+
+  test('returns [] when no astro.config.* is present', async () => {
+    expect(await loadUserAstroFonts(tmpDir)).toEqual([]);
+  });
+
+  test('drops entries missing required font-family fields', async () => {
+    await writeConfig(`
+      export default {
+        fonts: [
+          { provider: { name: 'fake', resolveFont: () => undefined }, name: 'Inter', cssVariable: '--font-inter' },
+          { name: 'NoProvider', cssVariable: '--font-x' },
+          'not-an-object'
+        ]
+      };
+    `);
+
+    const fonts = await loadUserAstroFonts(tmpDir);
+
+    expect(fonts).toHaveLength(1);
+    expect(fonts[0].cssVariable).toBe('--font-inter');
+  });
+});
+
+describe('loadUserAstroVitePlugins', () => {
+  test('returns plugins from vite.plugins', async () => {
+    await writeConfig(`
+      export default {
+        vite: {
+          plugins: [
+            { name: 'tailwindcss', enforce: 'pre' },
+            { name: 'unocss/vite' }
+          ]
+        }
+      };
+    `);
+
+    const plugins = await loadUserAstroVitePlugins(tmpDir);
+
+    expect(plugins.map((p) => p.name)).toEqual(['tailwindcss', 'unocss/vite']);
+  });
+
+  test('flattens nested plugin arrays', async () => {
+    await writeConfig(`
+      export default {
+        vite: {
+          plugins: [
+            [{ name: 'a' }, { name: 'b' }],
+            { name: 'c' }
+          ]
+        }
+      };
+    `);
+
+    const plugins = await loadUserAstroVitePlugins(tmpDir);
+
+    expect(plugins.map((p) => p.name)).toEqual(['a', 'b', 'c']);
+  });
+
+  test('returns [] when vite.plugins is missing', async () => {
+    await writeConfig(`export default { vite: {} };`);
+
+    expect(await loadUserAstroVitePlugins(tmpDir)).toEqual([]);
+  });
+
+  test('drops entries without a name', async () => {
+    await writeConfig(`
+      export default {
+        vite: {
+          plugins: [{ name: 'real' }, false, null, undefined, { foo: 'bar' }]
+        }
+      };
+    `);
+
+    const plugins = await loadUserAstroVitePlugins(tmpDir);
+
+    expect(plugins.map((p) => p.name)).toEqual(['real']);
+  });
+});
+
+describe('loadUserAstroIntegrations (regression)', () => {
+  test('still picks up integrations after the refactor', async () => {
+    await writeConfig(`
+      export default {
+        integrations: [
+          { name: 'astro-icon', hooks: {} },
+          { name: 'unocss/astro', hooks: {} }
+        ]
+      };
+    `);
+
+    const integrations = await loadUserAstroIntegrations(tmpDir);
+
+    expect(integrations.map((i) => i.name)).toEqual(['astro-icon', 'unocss/astro']);
+  });
+});

package/src/loadUserAstroConfig.ts

@@ -1,7 +1,8 @@
-import { loadConfigFromFile } from 'vite';
+import { loadConfigFromFile, type Plugin } from 'vite';
 import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
 import type { AstroIntegration } from 'astro';
+import type { StorybookFontFamily } from './vitePluginAstroFonts.ts';
 
 const CONFIG_FILENAMES = [
   'astro.config.ts',
@@ -10,18 +11,45 @@ const CONFIG_FILENAMES = [
   'astro.config.cjs',
 ];
 
-/**
- * Loads integrations declared in the user's astro.config.* so that any Vite
- * plugins they register (e.g. astro-icon's virtual:astro-icon resolver) are
- * present in both the main Storybook Vite server and the internal Astro SSR
- * server.  Returns an empty array on any failure so the calling code can
- * continue with only the framework-level integrations.
- */
-export async function loadUserAstroIntegrations(resolveFrom: string): Promise<AstroIntegration[]> {
-  const configFile = CONFIG_FILENAMES.find(name => existsSync(resolve(resolveFrom, name)));
+interface UserAstroConfigData {
+  integrations: AstroIntegration[];
+  fonts: StorybookFontFamily[];
+  vitePlugins: Plugin[];
+}
+
+const EMPTY: UserAstroConfigData = {
+  integrations: [],
+  fonts: [],
+  vitePlugins: []
+};
+
+// Cache by resolveFrom — config rarely changes during a Storybook session and
+// several call sites read the same data.  Each entry stores the in-flight
+// promise so concurrent callers share the same load.
+const configCache = new Map<string, Promise<UserAstroConfigData>>();
+
+async function loadUserAstroConfigData(resolveFrom: string): Promise<UserAstroConfigData> {
+  let cached = configCache.get(resolveFrom);
+
+  if (!cached) {
+    cached = readUserAstroConfig(resolveFrom);
+    configCache.set(resolveFrom, cached);
+  }
+
+  return cached;
+}
+
+async function readUserAstroConfig(resolveFrom: string): Promise<UserAstroConfigData> {
+  // Vite's loadConfigFromFile resolves a relative configFile against
+  // process.cwd(), not the configRoot argument, so we always hand it an
+  // absolute path to make the lookup deterministic regardless of where
+  // Storybook is invoked from.
+  const configFile = CONFIG_FILENAMES
+    .map((name) => resolve(resolveFrom, name))
+    .find((path) => existsSync(path));
 
   if (!configFile) {
-    return [];
+    return EMPTY;
   }
 
   try {
@@ -32,28 +60,101 @@ export async function loadUserAstroIntegrations(resolveFrom: string): Promise<As
     );
 
     if (!result?.config) {
-      return [];
-    }
-
-    const config = result.config as { integrations?: unknown };
-    const raw = config.integrations;
-
-    if (!raw) {
-      return [];
+      return EMPTY;
     }
 
-    // Astro allows nested arrays from conditional spreads (e.g. ...whenX(() => mdx()))
-    const flat = (Array.isArray(raw) ? raw : [raw]).flat(Infinity);
+    const config = result.config as {
+      integrations?: unknown;
+      fonts?: unknown;
+      vite?: { plugins?: unknown };
+    };
 
-    return flat.filter(
-      (i): i is AstroIntegration => Boolean(i) && typeof i === 'object' && 'name' in i && 'hooks' in i
-    );
+    return {
+      integrations: extractIntegrations(config.integrations),
+      fonts: extractFonts(config.fonts),
+      vitePlugins: extractVitePlugins(config.vite?.plugins)
+    };
   } catch (err) {
     console.warn(
-      '[storybook-astro] Could not load astro.config to discover integrations:',
+      '[storybook-astro] Could not load astro.config to discover integrations / fonts / vite plugins:',
       err instanceof Error ? err.message : String(err)
     );
 
+    return EMPTY;
+  }
+}
+
+function extractIntegrations(raw: unknown): AstroIntegration[] {
+  if (!raw) {
+    return [];
+  }
+
+  // Astro allows nested arrays from conditional spreads (e.g. ...whenX(() => mdx()))
+  const flat = (Array.isArray(raw) ? raw : [raw]).flat(Infinity);
+
+  return flat.filter(
+    (i): i is AstroIntegration =>
+      Boolean(i) && typeof i === 'object' && 'name' in i && 'hooks' in i
+  );
+}
+
+function extractFonts(raw: unknown): StorybookFontFamily[] {
+  if (!Array.isArray(raw)) {
+    return [];
+  }
+
+  return raw.filter(
+    (f): f is StorybookFontFamily =>
+      Boolean(f) &&
+      typeof f === 'object' &&
+      typeof (f as { name?: unknown }).name === 'string' &&
+      typeof (f as { cssVariable?: unknown }).cssVariable === 'string' &&
+      typeof (f as { provider?: unknown }).provider === 'object'
+  );
+}
+
+function extractVitePlugins(raw: unknown): Plugin[] {
+  if (!raw) {
     return [];
   }
+
+  // vite.plugins accepts Plugin | Plugin[] | (Plugin | false | null | undefined)[][] etc.
+  const flat = (Array.isArray(raw) ? raw : [raw]).flat(Infinity);
+
+  return flat.filter(
+    (p): p is Plugin =>
+      Boolean(p) && typeof p === 'object' && 'name' in p && typeof (p as Plugin).name === 'string'
+  );
+}
+
+/**
+ * Loads integrations declared in the user's astro.config.* so that any Vite
+ * plugins they register (e.g. astro-icon's virtual:astro-icon resolver) are
+ * present in both the main Storybook Vite server and the internal Astro SSR
+ * server.  Returns an empty array on any failure so the calling code can
+ * continue with only the framework-level integrations.
+ */
+export async function loadUserAstroIntegrations(resolveFrom: string): Promise<AstroIntegration[]> {
+  return (await loadUserAstroConfigData(resolveFrom)).integrations;
+}
+
+/**
+ * Loads the `fonts:` array from the user's astro.config.* so the Astro 6
+ * Font Provider API works in Storybook without duplicating the array into
+ * `framework.options.fonts`.  Returns [] if the project has no fonts
+ * configured or the config can't be read.
+ */
+export async function loadUserAstroFonts(resolveFrom: string): Promise<StorybookFontFamily[]> {
+  return (await loadUserAstroConfigData(resolveFrom)).fonts;
+}
+
+/**
+ * Loads raw Vite plugins declared at `vite.plugins` in the user's
+ * astro.config.* (e.g. `@tailwindcss/vite`, `unocss/vite`).  These are not
+ * registered through Astro's integration API so `loadUserAstroIntegrations`
+ * does not pick them up; this loader fills the gap so CSS frameworks added
+ * as raw Vite plugins work in Storybook without `viteFinal`.
+ */
+export async function loadUserAstroVitePlugins(resolveFrom: string): Promise<Plugin[]> {
+  return (await loadUserAstroConfigData(resolveFrom)).vitePlugins;
 }

package/src/preset.ts

@@ -11,6 +11,7 @@ import { vitePluginAstroVueFallback } from './vitePluginAstroVueFallback.ts';
 import { vitePluginAstroToolbarFallback } from './vitePluginAstroToolbarFallback.ts';
 import { resolveSanitizationOptions } from './lib/sanitization.ts';
 import { mergeWithAstroConfig } from './vitePluginAstro.ts';
+import { loadUserAstroFonts, loadUserAstroVitePlugins } from './loadUserAstroConfig.ts';
 
 export const core = {
   builder: '@storybook/builder-vite',
@@ -27,9 +28,26 @@ export const core = {
 export const viteFinal: StorybookConfigVite['viteFinal'] = async (config, storybookOptions) => {
   const { configType, presets, configDir } = storybookOptions;
   const frameworkOptions = await presets.apply<FrameworkOptions>('frameworkOptions');
+  const resolveFrom = frameworkOptions.resolveFrom ?? dirname(configDir);
+
+  // Auto-load fonts from the user's astro.config.* when the framework option
+  // is omitted entirely. An explicit empty array means "I want no fonts" and
+  // is honored as-is.
+  const fonts =
+    frameworkOptions.fonts === undefined
+      ? await loadUserAstroFonts(resolveFrom)
+      : frameworkOptions.fonts;
+
+  if (frameworkOptions.fonts === undefined && fonts.length > 0) {
+    console.warn(
+      `[storybook-astro] Auto-loaded ${fonts.length} font famil${fonts.length === 1 ? 'y' : 'ies'} from astro.config: ${fonts.map((f) => f.cssVariable).join(', ')}`
+    );
+  }
+
   const options = {
     ...frameworkOptions,
-    resolveFrom: frameworkOptions.resolveFrom ?? dirname(configDir)
+    resolveFrom,
+    fonts
   } satisfies FrameworkOptions;
 
   if (!config.plugins) {
@@ -37,7 +55,7 @@ export const viteFinal: StorybookConfigVite['viteFinal'] = async (config, storyb
   }
 
   const integrations = options.integrations ?? [];
-  const renderMode = options.renderMode ?? 'server';
+  const renderMode = options.renderMode ?? 'static';
   const mode = configType === 'DEVELOPMENT' ? 'development' : 'production';
   const command = configType === 'DEVELOPMENT' ? 'serve' : 'build';
 
@@ -110,6 +128,31 @@ export const viteFinal: StorybookConfigVite['viteFinal'] = async (config, storyb
     command
   );
 
+  // Auto-merge raw Vite plugins declared at `vite.plugins` in the user's
+  // astro.config.*.  This covers CSS frameworks added as Vite plugins rather
+  // than Astro integrations (e.g. `@tailwindcss/vite`, `unocss/vite`) which
+  // the integration auto-loader does not pick up.
+  const userVitePlugins = await loadUserAstroVitePlugins(options.resolveFrom);
+
+  if (userVitePlugins.length > 0) {
+    const existingNames = new Set<string>();
+
+    for (const plugin of (finalConfig.plugins ?? []).flat(Infinity) as Array<{ name?: string }>) {
+      if (plugin && typeof plugin === 'object' && typeof plugin.name === 'string') {
+        existingNames.add(plugin.name);
+      }
+    }
+
+    const newPlugins = userVitePlugins.filter((plugin) => !existingNames.has(plugin.name));
+
+    if (newPlugins.length > 0) {
+      console.warn(
+        `[storybook-astro] Auto-loaded ${newPlugins.length} vite plugin${newPlugins.length === 1 ? '' : 's'} from astro.config: ${newPlugins.map((p) => p.name).join(', ')}`
+      );
+      finalConfig.plugins = [...(finalConfig.plugins ?? []), ...newPlugins];
+    }
+  }
+
   // Exclude Astro integration packages from dependency optimization because
   // they import virtual modules that esbuild cannot resolve.
   if (!finalConfig.optimizeDeps) {

package/src/renderer/renderer-dev.ts

@@ -7,6 +7,8 @@ import type {
 const pendingMessages = new Map<string, RenderPromise>();
 const ASTRO_SERVER_UNAVAILABLE_ERROR_NAME = 'AstroRenderServerUnavailableError';
 
+export const isStaticMode = false;
+
 export async function render(data: RenderComponentInput, timeoutMs = 5000) {
   // eslint-disable-next-line n/no-unsupported-features/node-builtins
   const id = crypto.randomUUID();

package/src/renderer/renderer-server.ts

@@ -1,5 +1,7 @@
 import type { RenderComponentInput, RenderResponseMessage } from '@storybook-astro/renderer/types';
 
+export const isStaticMode = false;
+
 type StorybookImportMetaEnv = ImportMeta & {
   env?: Record<string, string | undefined>;
 };

package/src/renderer/renderer-static.ts

@@ -2,6 +2,8 @@ import type { RenderComponentInput, RenderResponseMessage } from '@storybook-ast
 
 const PRERENDERED_STORIES_FILE = 'astro-prerendered-stories.json';
 
+export const isStaticMode = true;
+
 let prerenderedStoriesPromise: Promise<Record<string, string>> | undefined;
 
 export async function render(data: RenderComponentInput) {

package/src/shim.d.ts

@@ -0,0 +1,21 @@
+// Ambient type declarations for *.astro file imports.
+//
+// Without the Astro language server, TypeScript (and ESLint's type-checker)
+// cannot resolve `.astro` modules, so `import Foo from './Foo.astro'` is
+// treated as an error-typed value and fires
+// @typescript-eslint/no-unsafe-assignment on `component: Foo`.
+//
+// To opt in, add this to your project's src/env.d.ts:
+//
+//   /// <reference types="@storybook-astro/framework/shim" />
+
+declare module '*.astro' {
+  type AstroComponentFactory = {
+    (result: unknown, props: unknown, slots: unknown): unknown | Promise<unknown>;
+    isAstroComponentFactory?: boolean;
+    moduleId?: string | undefined;
+  };
+  const Component: AstroComponentFactory;
+
+  export default Component;
+}

package/src/virtual.d.ts

@@ -20,6 +20,7 @@ declare module 'virtual:storybook-astro-renderer' {
   ): Promise<RenderResponseMessage['data']>;
   export function init(): void;
   export function applyStyles(): void;
+  export const isStaticMode: boolean;
 }
 
 declare module 'virtual:storybook-astro/sanitize-config' {