astro 4.0.8 → 4.1.0

package/dist/core/cookies/cookies.js

@@ -62,7 +62,7 @@ class AstroCookies {
    * @param key The cookie to get.
    * @returns An object containing the cookie value as well as convenience methods for converting its value.
    */
-  get(key) {
+  get(key, options = void 0) {
     if (this.#outgoing?.has(key)) {
       let [serializedValue, , isSetValue] = this.#outgoing.get(key);
       if (isSetValue) {
@@ -71,7 +71,7 @@ class AstroCookies {
         return void 0;
       }
     }
-    const values = this.#ensureParsed();
+    const values = this.#ensureParsed(options);
     if (key in values) {
       const value = values[key];
       return new AstroCookie(value);
@@ -83,12 +83,12 @@ class AstroCookies {
    * @param key The cookie to check for.
    * @returns
    */
-  has(key) {
+  has(key, options = void 0) {
     if (this.#outgoing?.has(key)) {
       let [, , isSetValue] = this.#outgoing.get(key);
       return isSetValue;
     }
-    const values = this.#ensureParsed();
+    const values = this.#ensureParsed(options);
     return !!values[key];
   }
   /**
@@ -140,9 +140,9 @@ class AstroCookies {
       yield value[1];
     }
   }
-  #ensureParsed() {
+  #ensureParsed(options = void 0) {
     if (!this.#requestValues) {
-      this.#parse();
+      this.#parse(options);
     }
     if (!this.#requestValues) {
       this.#requestValues = {};
@@ -155,12 +155,12 @@ class AstroCookies {
     }
     return this.#outgoing;
   }
-  #parse() {
+  #parse(options = void 0) {
     const raw = this.#request.headers.get("cookie");
     if (!raw) {
       return;
     }
-    this.#requestValues = parse(raw);
+    this.#requestValues = parse(raw, options);
   }
 }
 export {

package/dist/core/cookies/index.d.ts

@@ -1,2 +1,3 @@
 export { AstroCookies } from './cookies.js';
 export { attachCookiesToResponse, getSetCookiesFromResponse, responseHasCookies, } from './response.js';
+export type { AstroCookieSetOptions, AstroCookieGetOptions } from './cookies.js';

package/dist/core/dev/container.js

@@ -26,9 +26,9 @@ async function createContainer({
   settings = injectImageEndpoint(settings, "dev");
   const {
     base,
-    server: { host, headers, open: shouldOpen }
+    server: { host, headers, open: serverOpen }
   } = settings.config;
-  const open = shouldOpen ? base : false;
+  const open = typeof serverOpen == "string" ? serverOpen : serverOpen ? base : false;
   const rendererClientEntries = settings.renderers.map((r) => r.clientEntrypoint).filter(Boolean);
   const viteConfig = await createVite(
     {

package/dist/core/dev/dev.js

@@ -6,7 +6,9 @@ import { telemetry } from "../../events/index.js";
 import * as msg from "../messages.js";
 import { startContainer } from "./container.js";
 import { createContainerWithAutomaticRestart } from "./restart.js";
+import { ensureProcessNodeEnv } from "../util.js";
 async function dev(inlineConfig) {
+  ensureProcessNodeEnv("development");
   const devStart = performance.now();
   await telemetry.record([]);
   const restart = await createContainerWithAutomaticRestart({ inlineConfig, fs });
@@ -21,7 +23,7 @@ async function dev(inlineConfig) {
       base: restart.container.settings.config.base
     })
   );
-  const currentVersion = "4.0.8";
+  const currentVersion = "4.1.0";
   if (currentVersion.includes("-")) {
     logger.warn("SKIP_FORMAT", msg.prerelease({ currentVersion }));
   }

package/dist/core/errors/dev/utils.js

@@ -15,7 +15,7 @@ function collectErrorMetadata(e, rootFolder) {
   err.forEach((error) => {
     if (e.stack) {
       const stackInfo = collectInfoFromStacktrace(e);
-      error.stack = stackInfo.stack;
+      error.stack = stripAnsi(stackInfo.stack);
       error.loc = stackInfo.loc;
       error.plugin = stackInfo.plugin;
       error.pluginCode = stackInfo.pluginCode;
@@ -30,7 +30,7 @@ function collectErrorMetadata(e, rootFolder) {
         const fileContents = fs.readFileSync(error.loc.file, "utf8");
         if (!error.frame) {
           const frame = codeFrame(fileContents, error.loc);
-          error.frame = frame;
+          error.frame = stripAnsi(frame);
         }
         if (!error.fullCode) {
           error.fullCode = fileContents;
@@ -39,6 +39,9 @@ function collectErrorMetadata(e, rootFolder) {
       }
     }
     error.hint = generateHint(e);
+    if (error.message) {
+      error.message = stripAnsi(error.message);
+    }
   });
   if (!AggregateError.is(e) && Array.isArray(e.errors)) {
     e.errors.forEach((buildError, i) => {

package/dist/core/errors/dev/vite.d.ts

@@ -16,7 +16,7 @@ export interface AstroErrorPayload {
         hint?: string;
         docslink?: string;
         highlightedCode?: string;
-        loc: {
+        loc?: {
             file?: string;
             line?: number;
             column?: number;

package/dist/core/errors/overlay.js

@@ -621,7 +621,7 @@ class ErrorOverlay extends HTMLElement {
       docslink.appendChild(this.createLink(`See Docs Reference${openNewWindowIcon}`, err.docslink));
     }
     const code = this.root.querySelector("#code");
-    if (code && err.loc.file) {
+    if (code && err.loc?.file) {
       code.style.display = "block";
       const codeHeader = code.querySelector("#code header");
       const codeContent = code.querySelector("#code-content");
@@ -647,7 +647,7 @@ class ErrorOverlay extends HTMLElement {
             if (errorLine.parentElement?.parentElement) {
               errorLine.parentElement.parentElement.scrollTop = errorLine.offsetTop - errorLine.parentElement.parentElement.offsetTop - 8;
             }
-            if (err.loc.column) {
+            if (err.loc?.column) {
               errorLine.insertAdjacentHTML(
                 "afterend",
                 `

package/dist/core/messages.js

@@ -36,7 +36,7 @@ function serverStart({
   host,
   base
 }) {
-  const version = "4.0.8";
+  const version = "4.1.0";
   const localPrefix = `${dim("\u2503")} Local    `;
   const networkPrefix = `${dim("\u2503")} Network  `;
   const emptyPrefix = " ".repeat(11);
@@ -258,7 +258,7 @@ function printHelp({
     message.push(
       linebreak(),
       `  ${bgGreen(black(` ${commandName} `))} ${green(
-        `v${"4.0.8"}`
+        `v${"4.1.0"}`
       )} ${headline}`
     );
   }

package/dist/core/preview/index.js

@@ -1,3 +1,4 @@
+import fs from "node:fs";
 import { createRequire } from "node:module";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { AstroIntegrationLogger } from "../../core/logger/core.js";
@@ -9,7 +10,9 @@ import { createNodeLogger } from "../config/logging.js";
 import { createSettings } from "../config/settings.js";
 import createStaticPreviewServer from "./static-preview-server.js";
 import { getResolvedHostForHttpServer } from "./util.js";
+import { ensureProcessNodeEnv } from "../util.js";
 async function preview(inlineConfig) {
+  ensureProcessNodeEnv("production");
   const logger = createNodeLogger(inlineConfig);
   const { userConfig, astroConfig } = await resolveConfig(inlineConfig ?? {}, "preview");
   telemetry.record(eventCliSession("preview", userConfig));
@@ -21,6 +24,12 @@ async function preview(inlineConfig) {
   });
   await runHookConfigDone({ settings, logger });
   if (settings.config.output === "static") {
+    if (!fs.existsSync(settings.config.outDir)) {
+      const outDirPath = fileURLToPath(settings.config.outDir);
+      throw new Error(
+        `[preview] The output directory ${outDirPath} does not exist. Did you run \`astro build\`?`
+      );
+    }
     const server2 = await createStaticPreviewServer(settings, logger);
     return server2;
   }

package/dist/core/render/result.js

@@ -198,6 +198,7 @@ function createResult(args) {
     response,
     _metadata: {
       hasHydrationScript: false,
+      rendererSpecificHydrationScripts: /* @__PURE__ */ new Set(),
       hasRenderedHead: false,
       hasDirectives: /* @__PURE__ */ new Set(),
       headInTree: false,

package/dist/core/routing/manifest/create.js

@@ -224,7 +224,7 @@ function createRouteManifest({ settings, cwd, fsMod }, logger) {
       } else {
         components.push(item.file);
         const component = item.file;
-        const trailingSlash = item.isPage ? settings.config.trailingSlash : "never";
+        const { trailingSlash } = settings.config;
         const pattern = getPattern(segments, settings.config, trailingSlash);
         const generate = getRouteGenerator(segments, trailingSlash);
         const pathname = segments.every((segment) => segment.length === 1 && !segment[0].dynamic) ? `/${segments.map((segment) => segment[0].content).join("/")}` : null;

package/dist/core/sync/index.js

@@ -15,7 +15,9 @@ import { createNodeLogger } from "../config/logging.js";
 import { createSettings } from "../config/settings.js";
 import { createVite } from "../create-vite.js";
 import { AstroError, AstroErrorData, createSafeError, isAstroError } from "../errors/index.js";
+import { ensureProcessNodeEnv } from "../util.js";
 async function sync(inlineConfig, options) {
+  ensureProcessNodeEnv("production");
   const logger = createNodeLogger(inlineConfig);
   const { userConfig, astroConfig } = await resolveConfig(inlineConfig ?? {}, "sync");
   telemetry.record(eventCliSession("sync", userConfig));

package/dist/core/util.d.ts

@@ -50,3 +50,7 @@ export declare function resolveJsToTs(filePath: string): string;
  * Resolve the hydration paths so that it can be imported in the client
  */
 export declare function resolvePath(specifier: string, importer: string): string;
+/**
+ * Set a default NODE_ENV so Vite doesn't set an incorrect default when loading the Astro config
+ */
+export declare function ensureProcessNodeEnv(defaultNodeEnv: string): void;

package/dist/core/util.js

@@ -174,11 +174,17 @@ function resolvePath(specifier, importer) {
     return specifier;
   }
 }
+function ensureProcessNodeEnv(defaultNodeEnv) {
+  if (!process.env.NODE_ENV) {
+    process.env.NODE_ENV = defaultNodeEnv;
+  }
+}
 export {
   NULL_BYTE_PLACEHOLDER,
   VALID_ID_PREFIX,
   arraify,
   emoji,
+  ensureProcessNodeEnv,
   getOutputFilename,
   isEndpoint,
   isMarkdownFile,

package/dist/i18n/index.d.ts

@@ -53,7 +53,7 @@ export declare function getPathByLocale(locale: string, locales: Locales): strin
 /**
  * An utility function that retrieves the preferred locale that correspond to a path.
  *
- * @param locale
+ * @param path
  * @param locales
  */
 export declare function getLocaleByPath(path: string, locales: Locales): string | undefined;

package/dist/i18n/index.js

@@ -99,10 +99,13 @@ function getPathByLocale(locale, locales) {
 function getLocaleByPath(path, locales) {
   for (const locale of locales) {
     if (typeof locale !== "string") {
-      const code = locale.codes.at(0);
-      return code;
+      if (locale.path === path) {
+        const code = locale.codes.at(0);
+        return code;
+      }
+    } else if (locale === path) {
+      return locale;
     }
-    1;
   }
   return void 0;
 }

package/dist/i18n/vite-plugin-i18n.js

@@ -54,7 +54,7 @@ function astroInternationalization({
 					export const getAbsoluteLocaleUrlList = (path = "", opts) => _getLocaleAbsoluteUrlList({ base, path, trailingSlash, format, site, ...i18n, ...opts });
 					
 					export const getPathByLocale = (locale) => _getPathByLocale(locale, i18n.locales);
-					export const getLocaleByPath = (locale) => _getLocaleByPath(locale, i18n.locales);
+					export const getLocaleByPath = (path) => _getLocaleByPath(path, i18n.locales);
 				`;
       }
     }

package/dist/prefetch/index.js

@@ -17,6 +17,7 @@ function init(defaultOpts) {
   initTapStrategy();
   initHoverStrategy();
   initViewportStrategy();
+  initLoadStrategy();
 }
 function initTapStrategy() {
   for (const event of ["touchstart", "mousedown"]) {
@@ -111,6 +112,15 @@ function createViewportIntersectionObserver() {
     }
   });
 }
+function initLoadStrategy() {
+  onPageLoad(() => {
+    for (const anchor of document.getElementsByTagName("a")) {
+      if (elMatchesStrategy(anchor, "load")) {
+        prefetch(anchor.href, { with: "link" });
+      }
+    }
+  });
+}
 function prefetch(url, opts) {
   const ignoreSlowConnection = opts?.ignoreSlowConnection ?? false;
   if (!canPrefetchUrl(url, ignoreSlowConnection))
@@ -163,7 +173,7 @@ function elMatchesStrategy(el, strategy) {
 function isSlowConnection() {
   if ("connection" in navigator) {
     const conn = navigator.connection;
-    return conn.saveData || /(2|3)g/.test(conn.effectiveType);
+    return conn.saveData || /2g/.test(conn.effectiveType);
   }
   return false;
 }

package/dist/runtime/client/dev-overlay/overlay.js

@@ -3,6 +3,7 @@ import { getIconElement, isDefinedIcon } from "./ui-library/icons.js";
 const WS_EVENT_NAME = "astro-dev-toolbar";
 const WS_EVENT_NAME_DEPRECATED = "astro-dev-overlay";
 const HOVER_DELAY = 2 * 1e3;
+const DEVBAR_HITBOX_ABOVE = 42;
 class AstroDevOverlay extends HTMLElement {
   shadowRoot;
   delayedHideTimeout;
@@ -62,7 +63,7 @@ class AstroDevOverlay extends HTMLElement {
 				pointer-events: auto;
 			}
 			#dev-bar-hitbox-above {
-				height: 42px;
+				height: ${DEVBAR_HITBOX_ABOVE}px;
 			}
 			#dev-bar-hitbox-below {
 				height: 16px;
@@ -131,7 +132,7 @@ class AstroDevOverlay extends HTMLElement {
 				border-radius: 4px;
 				padding: 4px 8px;
 				position: absolute;
-				top: 4px;
+				top: ${4 - DEVBAR_HITBOX_ABOVE}px;
 				font-size: 14px;
 				opacity: 0;
 				transition: opacity 0.2s ease-in-out 0s;
@@ -423,16 +424,21 @@ class AstroDevOverlay extends HTMLElement {
   setOverlayVisible(newStatus) {
     const barContainer = this.shadowRoot.querySelector("#bar-container");
     const devBar = this.shadowRoot.querySelector("#dev-bar");
+    const devBarHitboxAbove = this.shadowRoot.querySelector("#dev-bar-hitbox-above");
     if (newStatus === true) {
       this.devOverlay?.removeAttribute("data-hidden");
       barContainer?.removeAttribute("inert");
       devBar?.removeAttribute("tabindex");
+      if (devBarHitboxAbove)
+        devBarHitboxAbove.style.height = "0";
       return;
     }
     if (newStatus === false) {
       this.devOverlay?.setAttribute("data-hidden", "");
       barContainer?.setAttribute("inert", "");
       devBar?.setAttribute("tabindex", "0");
+      if (devBarHitboxAbove)
+        devBarHitboxAbove.style.height = `${DEVBAR_HITBOX_ABOVE}px`;
       return;
     }
   }

package/dist/runtime/client/dev-overlay/plugins/audit/a11y.js

@@ -22,6 +22,8 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
+import { aria, roles } from "aria-query";
+import { AXObjectRoles, elementAXObjects } from "axobject-query";
 const a11y_required_attributes = {
   a: ["href"],
   area: ["alt", "aria-label", "aria-labelledby"],
@@ -413,6 +415,58 @@ const a11y = [
     message: "This will move elements out of the expected tab order, creating a confusing experience for keyboard users.",
     selector: '[tabindex]:not([tabindex="-1"]):not([tabindex="0"])'
   },
+  {
+    code: "a11y-role-has-required-aria-props",
+    title: "Missing attributes required for ARIA role",
+    message: (element) => {
+      const { __astro_role: role, __astro_missing_attributes: required } = element;
+      return `${element.localName} element is missing required attributes for its role (${role}): ${required.join(", ")}`;
+    },
+    selector: "*",
+    match(element) {
+      const role = getRole(element);
+      if (!role)
+        return false;
+      if (is_semantic_role_element(role, element.localName, getAttributeObject(element))) {
+        return;
+      }
+      const { requiredProps } = roles.get(role);
+      const required_role_props = Object.keys(requiredProps);
+      const missingProps = required_role_props.filter((prop) => !element.hasAttribute(prop));
+      if (missingProps.length > 0) {
+        element.__astro_role = role;
+        element.__astro_missing_attributes = missingProps;
+        return true;
+      }
+    }
+  },
+  {
+    code: "a11y-role-supports-aria-props",
+    title: "Unsupported ARIA attribute",
+    message: (element) => {
+      const { __astro_role: role, __astro_unsupported_attributes: unsupported } = element;
+      return `${element.localName} element has ARIA attributes that are not supported by its role (${role}): ${unsupported.join(
+        ", "
+      )}`;
+    },
+    selector: "*",
+    match(element) {
+      const role = getRole(element);
+      if (!role)
+        return false;
+      const { props } = roles.get(role);
+      const attributes = getAttributeObject(element);
+      const unsupportedAttributes = aria.keys().filter((attribute) => !(attribute in props));
+      const invalidAttributes = Object.keys(attributes).filter(
+        (key) => key.startsWith("aria-") && unsupportedAttributes.includes(key)
+      );
+      if (invalidAttributes.length > 0) {
+        element.__astro_role = role;
+        element.__astro_unsupported_attributes = invalidAttributes;
+        return true;
+      }
+    }
+  },
   {
     code: "a11y-structure",
     title: "Invalid DOM structure",
@@ -447,6 +501,16 @@ const a11y = [
     }
   }
 ];
+const a11y_labelable = [
+  "button",
+  "input",
+  "keygen",
+  "meter",
+  "output",
+  "progress",
+  "select",
+  "textarea"
+];
 const a11y_non_interactive_element_to_interactive_role_exceptions = {
   ul: ["listbox", "menu", "menubar", "radiogroup", "tablist", "tree", "treegrid"],
   ol: ["listbox", "menu", "menubar", "radiogroup", "tablist", "tree", "treegrid"],
@@ -455,6 +519,68 @@ const a11y_non_interactive_element_to_interactive_role_exceptions = {
   td: ["gridcell"],
   fieldset: ["radiogroup", "presentation"]
 };
+const combobox_if_list = ["email", "search", "tel", "text", "url"];
+function input_implicit_role(attributes) {
+  if (!("type" in attributes))
+    return;
+  const { type, list } = attributes;
+  if (!type)
+    return;
+  if (list && combobox_if_list.includes(type)) {
+    return "combobox";
+  }
+  return input_type_to_implicit_role.get(type);
+}
+function menuitem_implicit_role(attributes) {
+  if (!("type" in attributes))
+    return;
+  const { type } = attributes;
+  if (!type)
+    return;
+  return menuitem_type_to_implicit_role.get(type);
+}
+function getRole(element) {
+  if (element.hasAttribute("role")) {
+    return element.getAttribute("role");
+  }
+  return getImplicitRole(element);
+}
+function getImplicitRole(element) {
+  const name = element.localName;
+  const attrs = getAttributeObject(element);
+  if (name === "menuitem") {
+    return menuitem_implicit_role(attrs);
+  } else if (name === "input") {
+    return input_implicit_role(attrs);
+  } else {
+    return a11y_implicit_semantics.get(name);
+  }
+}
+function getAttributeObject(element) {
+  let obj = {};
+  for (let i = 0; i < element.attributes.length; i++) {
+    const attribute = element.attributes.item(i);
+    obj[attribute.name] = attribute.value;
+  }
+  return obj;
+}
+function is_semantic_role_element(role, tag_name, attributes) {
+  for (const [schema, ax_object] of elementAXObjects.entries()) {
+    if (schema.name === tag_name && (!schema.attributes || schema.attributes.every((attr) => attributes[attr.name] === attr.value))) {
+      for (const name of ax_object) {
+        const axRoles = AXObjectRoles.get(name);
+        if (axRoles) {
+          for (const { name: _name } of axRoles) {
+            if (_name === role) {
+              return true;
+            }
+          }
+        }
+      }
+    }
+  }
+  return false;
+}
 export {
   a11y
 };

package/dist/runtime/client/visible.js

@@ -1,8 +1,12 @@
-const visibleDirective = (load, _options, el) => {
+const visibleDirective = (load, options, el) => {
   const cb = async () => {
     const hydrate = await load();
     await hydrate();
   };
+  const rawOptions = typeof options.value === "object" ? options.value : void 0;
+  const ioOptions = {
+    rootMargin: rawOptions?.rootMargin
+  };
   const io = new IntersectionObserver((entries) => {
     for (const entry of entries) {
       if (!entry.isIntersecting)
@@ -11,7 +15,7 @@ const visibleDirective = (load, _options, el) => {
       cb();
       break;
     }
-  });
+  }, ioOptions);
   for (const child of el.children) {
     io.observe(child);
   }

package/dist/runtime/client/visible.prebuilt.d.ts

@@ -3,5 +3,5 @@
  * Do not edit this directly, but instead edit that file and rerun the prebuild
  * to generate this file.
  */
-declare const _default: "(()=>{var r=(i,c,s)=>{let n=async()=>{await(await i())()},t=new IntersectionObserver(e=>{for(let o of e)if(o.isIntersecting){t.disconnect(),n();break}});for(let e of s.children)t.observe(e)};(self.Astro||(self.Astro={})).visible=r;window.dispatchEvent(new Event(\"astro:visible\"));})();";
+declare const _default: "(()=>{var l=(s,i,o)=>{let r=async()=>{await(await s())()},t=typeof i.value==\"object\"?i.value:void 0,c={rootMargin:t==null?void 0:t.rootMargin},n=new IntersectionObserver(e=>{for(let a of e)if(a.isIntersecting){n.disconnect(),r();break}},c);for(let e of o.children)n.observe(e)};(self.Astro||(self.Astro={})).visible=l;window.dispatchEvent(new Event(\"astro:visible\"));})();";
 export default _default;

package/dist/runtime/client/visible.prebuilt.js

@@ -1,4 +1,4 @@
-var visible_prebuilt_default = `(()=>{var r=(i,c,s)=>{let n=async()=>{await(await i())()},t=new IntersectionObserver(e=>{for(let o of e)if(o.isIntersecting){t.disconnect(),n();break}});for(let e of s.children)t.observe(e)};(self.Astro||(self.Astro={})).visible=r;window.dispatchEvent(new Event("astro:visible"));})();`;
+var visible_prebuilt_default = `(()=>{var l=(s,i,o)=>{let r=async()=>{await(await s())()},t=typeof i.value=="object"?i.value:void 0,c={rootMargin:t==null?void 0:t.rootMargin},n=new IntersectionObserver(e=>{for(let a of e)if(a.isIntersecting){n.disconnect(),r();break}},c);for(let e of o.children)n.observe(e)};(self.Astro||(self.Astro={})).visible=l;window.dispatchEvent(new Event("astro:visible"));})();`;
 export {
   visible_prebuilt_default as default
 };

package/dist/runtime/server/render/common.js

@@ -39,6 +39,15 @@ function stringifyChunk(result, chunk) {
         }
         return renderAllHeadContent(result);
       }
+      case "renderer-hydration-script": {
+        const { rendererSpecificHydrationScripts } = result._metadata;
+        const { rendererName } = instruction;
+        if (!rendererSpecificHydrationScripts.has(rendererName)) {
+          rendererSpecificHydrationScripts.add(rendererName);
+          return instruction.render();
+        }
+        return "";
+      }
       default: {
         throw new Error(`Unknown chunk type: ${chunk.type}`);
       }

package/dist/runtime/server/render/component.js

@@ -291,6 +291,15 @@ ${serializeProps(
         }
       }
       destination.write(createRenderInstruction({ type: "directive", hydration }));
+      if (hydration.directive !== "only" && renderer?.ssr.renderHydrationScript) {
+        destination.write(
+          createRenderInstruction({
+            type: "renderer-hydration-script",
+            rendererName: renderer.name,
+            render: renderer.ssr.renderHydrationScript
+          })
+        );
+      }
       destination.write(markHTMLString(renderElement("astro-island", island, false)));
     }
   };

package/dist/runtime/server/render/instruction.d.ts

@@ -6,11 +6,21 @@ export type RenderDirectiveInstruction = {
 export type RenderHeadInstruction = {
     type: 'head';
 };
+/**
+ * Render a renderer-specific hydration script before the first component of that
+ * framework
+ */
+export type RendererHydrationScriptInstruction = {
+    type: 'renderer-hydration-script';
+    rendererName: string;
+    render: () => string;
+};
 export type MaybeRenderHeadInstruction = {
     type: 'maybe-head';
 };
-export type RenderInstruction = RenderDirectiveInstruction | RenderHeadInstruction | MaybeRenderHeadInstruction;
+export type RenderInstruction = RenderDirectiveInstruction | RenderHeadInstruction | MaybeRenderHeadInstruction | RendererHydrationScriptInstruction;
 export declare function createRenderInstruction(instruction: RenderDirectiveInstruction): RenderDirectiveInstruction;
+export declare function createRenderInstruction(instruction: RendererHydrationScriptInstruction): RendererHydrationScriptInstruction;
 export declare function createRenderInstruction(instruction: RenderHeadInstruction): RenderHeadInstruction;
 export declare function createRenderInstruction(instruction: MaybeRenderHeadInstruction): MaybeRenderHeadInstruction;
 export declare function isRenderInstruction(chunk: any): chunk is RenderInstruction;