exta2 0.0.1-beta.29

package/README.md

@@ -0,0 +1,43 @@
+# Exta
+
+SSG Framework for React
+
+## Features
+
+- **File-based Routing**: Generates routes based on file names.
+
+- **Fast startup**: Runs with the speed of Vite and Esbuild.
+
+- **Vite-based**: Leverages Vite's broad ecosystem within exta.
+
+- **`.tsx`, `.jsx` support**: Build type-safe apps with TypeScript.
+
+## Getting Started
+
+- **Download Template**
+
+You can download the current application template from [this repository](https://github.com/do4ng/exta-template).
+
+```bash
+git clone https://github.com/do4ng/exta-template my-app
+```
+
+- **Start Manually**
+
+exta is provided as a Vite plugin.
+Install the exta core package and the Vite React plugin to apply exta to an existing project.
+
+```ts
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+import { exta } from 'exta';
+
+export default defineConfig({
+  plugins: [react(), exta()],
+});
+```
+
+## LICENSE
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/client.js

@@ -0,0 +1,169 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_react = __toESM(require("react"), 1);
+var import_client = __toESM(require("react-dom/client"), 1);
+var import_exta_router = require("$exta-router");
+var import_react2 = __toESM(require("react"), 1);
+const import_meta = {};
+function matchUrlToRoute(url, routeResult) {
+  let { regex, params } = routeResult, match = regex.exec(url);
+  if (!match)
+    return null;
+  let result = {};
+  for (let i = 0; i < params.length; i++) {
+    let paramName = params[i], capturedValue = match[i + 1];
+    if (paramName.startsWith("..."))
+      throw new Error(
+        "[... file names are not supported due to static data generation issues."
+      );
+    result[paramName] = capturedValue;
+  }
+  return result;
+}
+var overlayEl = null;
+function ensureOverlay(style = "") {
+  overlayEl || (overlayEl = document.createElement("div"), overlayEl.className = "__exta_overlay", overlayEl.style.cssText = `
+      min-width: 100px;
+      position: fixed;
+      bottom: 16px;
+      left: 16px;
+      z-index: 99999;
+      font-family: Consolas, "Courier New", monospace;
+      background: rgba(0,0,0,0.78);
+      color: #fff;
+      padding: 10px 14px;
+      border-radius: 10px;
+      box-shadow: rgba(0, 0, 0, 0.12) 0px 1px 3px, rgba(0, 0, 0, 0.24) 0px 1px 2px;
+      font-size: 14px;
+      line-height: 1.35;
+      max-width: 320px;
+      backdrop-filter: blur(4px);
+      transition: opacity 400ms ease, transform 400ms ease;
+      opacity: 0;
+      transform: translateY(-6px) scale(0.98);
+      display: none;
+      ${style}
+    `, document.body.appendChild(overlayEl), overlayEl.addEventListener("transitionend", () => {
+    overlayEl.style.opacity === "0" && (overlayEl.style.display = "none");
+  }));
+}
+function show(text, error) {
+  ensureOverlay(error === true ? "color: #ff3c3c" : ""), error === true && import_meta.env.PROD && (text = "An internal client error occurred. See the console for details."), text && (overlayEl.textContent = text), overlayEl.style.display = "block", requestAnimationFrame(() => {
+    overlayEl.style.opacity = "1", overlayEl.style.transform = "translateY(0) scale(1)";
+  });
+}
+function setText(text) {
+  ensureOverlay(), overlayEl.textContent = text;
+}
+function hide() {
+  overlayEl && (overlayEl.style.opacity = "0", overlayEl.style.transform = "translateY(-6px) scale(0.98)");
+}
+typeof window < "u" && (window.__overlay__ = {
+  show,
+  setText,
+  hide
+});
+var ErrorBoundary = class extends import_react2.default.Component {
+  state = { hasError: false, error: null };
+  static getDerivedStateFromError(error) {
+    return { hasError: true, error };
+  }
+  componentDidCatch(error, info) {
+    this.props.onError ? this.props.onError(error, info) : console.error(error, info);
+  }
+  render() {
+    if (this.state.hasError) {
+      let ErrorComp = this.props.errorComponent;
+      return ErrorComp && this.state.error ? import_react2.default.createElement(ErrorComp, {
+        error: this.state.error,
+        status: "Client Error",
+        message: this.state.error.message
+      }) : import_react2.default.createElement("div", null, "Something went wrong.");
+    }
+    return import_react2.default.createElement(import_react2.default.Fragment, null, this.props.children);
+  }
+}, error_default = ErrorBoundary;
+function prettyURL(path) {
+  return path === "." && (path = ""), path.startsWith("/") || (path = `/${path}`), path.endsWith("/") && (path = path.slice(0, -1)), path;
+}
+function App() {
+  let isFirstRender = (0, import_react.useRef)(true), location = (0, import_exta_router.usePathname)(), search = (0, import_exta_router.useSearchQuery)(), url = decodeURIComponent(new URL(location, window.location.origin).pathname), props = import_exta_router.router.data.get(prettyURL(url).toLowerCase()), page = import_exta_router.router.findPage(url), Layout = import_exta_router.router.layout._page, rootElement = document.getElementById("_app");
+  (0, import_react.useEffect)(() => {
+    if (isFirstRender.current) {
+      isFirstRender.current = false;
+      return;
+    }
+    window.scrollTo({ top: 0, behavior: "instant" }), rootElement && rootElement.scrollTo({ top: 0, behavior: "instant" });
+  }, [location, search]);
+  let createError = (props2) => import_react.default.createElement(
+    Layout,
+    null,
+    import_react.default.createElement(import_exta_router.router.error._page, {
+      key: location,
+      ...props2
+    })
+  );
+  if (!page || props?.status === 404)
+    return createError({
+      key: location,
+      status: 404,
+      message: "Page not found"
+    });
+  if (props?.status === 500)
+    return show(`ERROR: ${props.detail}`, true), createError({
+      key: location,
+      status: 500,
+      message: "Internal Server Error"
+    });
+  let Page = import_exta_router.router.modules[page.path]._page, params = matchUrlToRoute(url, { params: page.params, regex: page.regexp });
+  return import_react.default.createElement(
+    Layout,
+    null,
+    import_react.default.createElement(Page, { key: location, ...props, params })
+  );
+}
+var compilingInterval;
+if (import_meta.env.DEV) {
+  let intervalIndex = 0;
+  compilingInterval = setInterval(() => {
+    if (intervalIndex * 250 >= 250) {
+      let num = intervalIndex % 3 + 1;
+      show(`compiling${".".repeat(num)}`);
+    }
+    intervalIndex += 1;
+  }, 250);
+}
+import_exta_router.router.goto(window.location.href).then(() => {
+  let mainComponent = import_react.default.createElement(
+    // Error Catcher
+    error_default,
+    {
+      errorComponent: import_exta_router.router.error._page,
+      onError(error) {
+        console.error(error), import_meta.env.PROD ? show("An internal client error occurred. See the console for details.", true) : show(`ERROR: ${error.message}`, true);
+      }
+    },
+    import_react.default.createElement(App, null)
+  );
+  import_meta.env.PROD ? import_client.default.hydrateRoot(document.getElementById("_app"), mainComponent) : (import_client.default.createRoot(document.getElementById("_app")).render(mainComponent), clearInterval(compilingInterval), hide());
+});

package/dist/client.mjs

@@ -0,0 +1,155 @@
+// packages/exta/src/client/client.ts
+import React2, { useEffect, useRef } from "react";
+import ReactDOM from "react-dom/client";
+import { router, usePathname, useSearchQuery } from "$exta-router";
+
+// packages/exta/src/utils/params.ts
+function matchUrlToRoute(url, routeResult) {
+  let { regex, params } = routeResult, match = regex.exec(url);
+  if (!match)
+    return null;
+  let result = {};
+  for (let i = 0; i < params.length; i++) {
+    let paramName = params[i], capturedValue = match[i + 1];
+    if (paramName.startsWith("..."))
+      throw new Error(
+        "[... file names are not supported due to static data generation issues."
+      );
+    result[paramName] = capturedValue;
+  }
+  return result;
+}
+
+// packages/exta/src/client/overlay.ts
+var overlayEl = null;
+function ensureOverlay(style = "") {
+  overlayEl || (overlayEl = document.createElement("div"), overlayEl.className = "__exta_overlay", overlayEl.style.cssText = `
+      min-width: 100px;
+      position: fixed;
+      bottom: 16px;
+      left: 16px;
+      z-index: 99999;
+      font-family: Consolas, "Courier New", monospace;
+      background: rgba(0,0,0,0.78);
+      color: #fff;
+      padding: 10px 14px;
+      border-radius: 10px;
+      box-shadow: rgba(0, 0, 0, 0.12) 0px 1px 3px, rgba(0, 0, 0, 0.24) 0px 1px 2px;
+      font-size: 14px;
+      line-height: 1.35;
+      max-width: 320px;
+      backdrop-filter: blur(4px);
+      transition: opacity 400ms ease, transform 400ms ease;
+      opacity: 0;
+      transform: translateY(-6px) scale(0.98);
+      display: none;
+      ${style}
+    `, document.body.appendChild(overlayEl), overlayEl.addEventListener("transitionend", () => {
+    overlayEl.style.opacity === "0" && (overlayEl.style.display = "none");
+  }));
+}
+function show(text, error) {
+  ensureOverlay(error === !0 ? "color: #ff3c3c" : ""), error === !0 && import.meta.env.PROD && (text = "An internal client error occurred. See the console for details."), text && (overlayEl.textContent = text), overlayEl.style.display = "block", requestAnimationFrame(() => {
+    overlayEl.style.opacity = "1", overlayEl.style.transform = "translateY(0) scale(1)";
+  });
+}
+function setText(text) {
+  ensureOverlay(), overlayEl.textContent = text;
+}
+function hide() {
+  overlayEl && (overlayEl.style.opacity = "0", overlayEl.style.transform = "translateY(-6px) scale(0.98)");
+}
+typeof window < "u" && (window.__overlay__ = {
+  show,
+  setText,
+  hide
+});
+
+// packages/exta/src/client/components/error.ts
+import React from "react";
+var ErrorBoundary = class extends React.Component {
+  state = { hasError: !1, error: null };
+  static getDerivedStateFromError(error) {
+    return { hasError: !0, error };
+  }
+  componentDidCatch(error, info) {
+    this.props.onError ? this.props.onError(error, info) : console.error(error, info);
+  }
+  render() {
+    if (this.state.hasError) {
+      let ErrorComp = this.props.errorComponent;
+      return ErrorComp && this.state.error ? React.createElement(ErrorComp, {
+        error: this.state.error,
+        status: "Client Error",
+        message: this.state.error.message
+      }) : React.createElement("div", null, "Something went wrong.");
+    }
+    return React.createElement(React.Fragment, null, this.props.children);
+  }
+}, error_default = ErrorBoundary;
+
+// packages/exta/src/client/client.ts
+function prettyURL(path) {
+  return path === "." && (path = ""), path.startsWith("/") || (path = `/${path}`), path.endsWith("/") && (path = path.slice(0, -1)), path;
+}
+function App() {
+  let isFirstRender = useRef(!0), location = usePathname(), search = useSearchQuery(), url = decodeURIComponent(new URL(location, window.location.origin).pathname), props = router.data.get(prettyURL(url).toLowerCase()), page = router.findPage(url), Layout = router.layout._page, rootElement = document.getElementById("_app");
+  useEffect(() => {
+    if (isFirstRender.current) {
+      isFirstRender.current = !1;
+      return;
+    }
+    window.scrollTo({ top: 0, behavior: "instant" }), rootElement && rootElement.scrollTo({ top: 0, behavior: "instant" });
+  }, [location, search]);
+  let createError = (props2) => React2.createElement(
+    Layout,
+    null,
+    React2.createElement(router.error._page, {
+      key: location,
+      ...props2
+    })
+  );
+  if (!page || props?.status === 404)
+    return createError({
+      key: location,
+      status: 404,
+      message: "Page not found"
+    });
+  if (props?.status === 500)
+    return show(`ERROR: ${props.detail}`, !0), createError({
+      key: location,
+      status: 500,
+      message: "Internal Server Error"
+    });
+  let Page = router.modules[page.path]._page, params = matchUrlToRoute(url, { params: page.params, regex: page.regexp });
+  return React2.createElement(
+    Layout,
+    null,
+    React2.createElement(Page, { key: location, ...props, params })
+  );
+}
+var compilingInterval;
+if (import.meta.env.DEV) {
+  let intervalIndex = 0;
+  compilingInterval = setInterval(() => {
+    if (intervalIndex * 250 >= 250) {
+      let num = intervalIndex % 3 + 1;
+      show(`compiling${".".repeat(num)}`);
+    }
+    intervalIndex += 1;
+  }, 250);
+}
+router.goto(window.location.href).then(() => {
+  let mainComponent = React2.createElement(
+    // Error Catcher
+    error_default,
+    {
+      errorComponent: router.error._page,
+      onError(error) {
+        console.error(error), import.meta.env.PROD ? show("An internal client error occurred. See the console for details.", !0) : show(`ERROR: ${error.message}`, !0);
+      }
+    },
+    React2.createElement(App, null)
+  );
+  import.meta.env.PROD ? ReactDOM.hydrateRoot(document.getElementById("_app"), mainComponent) : (ReactDOM.createRoot(document.getElementById("_app")).render(mainComponent), clearInterval(compilingInterval), hide());
+});

package/dist/components.d.ts

@@ -0,0 +1,23 @@
+import React, { ReactElement } from 'react';
+
+type AnchorBaseProps = Omit<React.ComponentPropsWithoutRef<'a'>, 'href' | 'onClick'> & {
+    href: string;
+    /**
+     * Download the data for that page in advance.
+     */
+    prefetch?: boolean;
+    /**
+     * Load page data from the SSR stage.
+     */
+    preload?: boolean;
+    onClick?: (e: React.MouseEvent<HTMLAnchorElement>) => void | Promise<void>;
+};
+declare function Link({ href, onClick, prefetch, preload, ...props }: AnchorBaseProps): React.JSX.Element;
+
+declare function Image({ src, ...props }: React.ComponentPropsWithoutRef<'img'>): React.JSX.Element;
+
+declare function Head({ children }: {
+    children: ReactElement | ReactElement[];
+}): any;
+
+export { Head, Image, Link };

package/dist/components.js

@@ -0,0 +1,96 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var components_exports = {};
+__export(components_exports, {
+  Head: () => Head,
+  Image: () => Image,
+  Link: () => Link
+});
+module.exports = __toCommonJS(components_exports);
+var import_react = __toESM(require("react"), 1);
+var import_react2 = __toESM(require("react"), 1);
+var import_react3 = require("react");
+var import_server = require("react-dom/server");
+function isExternal(url) {
+  try {
+    return new URL(url, window.location.href).origin !== window.location.origin;
+  } catch {
+    return false;
+  }
+}
+function Link({ href, onClick, prefetch, preload, ...props }) {
+  if (typeof window > "u")
+    return preload && global.__EXTA_SSR_DATA__.head.push({ type: "preload-data-link", data: href }), /* @__PURE__ */ import_react.default.createElement("a", { ...props, href }, props.children);
+  let useRouter = window._exta_useRouter, extaRouter = window._exta_router, router = useRouter();
+  if (!isExternal(href) && prefetch !== false) {
+    let url = new URL(href, window.location.origin);
+    extaRouter.prefetch(url.pathname);
+  }
+  return /* @__PURE__ */ import_react.default.createElement("a", { ...props, href, onClick: async (e) => {
+    if (e.defaultPrevented || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || props.target === "_blank")
+      return;
+    let current = window.location, target = new URL(href, current.href), isHashOnly = href.startsWith("#"), isSamePath = target.pathname === current.pathname, isHashChange = target.hash && target.hash !== current.hash;
+    if (!(isHashOnly || isSamePath && isHashChange) && (e.preventDefault(), e.stopPropagation(), !(onClick && (await onClick(e), e.defaultPrevented)))) {
+      if (isExternal(href)) {
+        window.location.href = href;
+        return;
+      }
+      await extaRouter.goto(target.pathname), router.push(target.pathname + target.search + target.hash);
+    }
+  } }, props.children);
+}
+function Image({ src, ...props }) {
+  return /* @__PURE__ */ import_react2.default.createElement("img", { ...props, src }, props.children);
+}
+function Head({ children }) {
+  if (typeof window > "u") {
+    if (global.__EXTA_SSR_DATA__) {
+      let wrapped = Array.isArray(children) ? children.map(
+        (c, i) => (0, import_react3.cloneElement)(c, { "data-ssr-head": "", key: i })
+      ) : (0, import_react3.cloneElement)(children, {
+        "data-ssr-head": ""
+      });
+      global.__EXTA_SSR_DATA__.head.push({
+        type: "html",
+        data: (0, import_server.renderToStaticMarkup)(wrapped).replace(/data-ssr-head=""/g, "data-ssr-head")
+      });
+    }
+    return null;
+  }
+  return (0, import_react3.useEffect)(() => {
+    document.head.querySelectorAll("[data-ssr-head]").forEach((el) => el.parentNode?.removeChild(el));
+    let html = (0, import_server.renderToStaticMarkup)(children), template = document.createElement("template");
+    template.innerHTML = html;
+    let nodes = Array.from(template.content.childNodes);
+    return nodes.forEach((node) => document.head.appendChild(node)), () => {
+      nodes.forEach((node) => {
+        document.head.contains(node) && document.head.removeChild(node);
+      });
+    };
+  }, [children]), null;
+}

package/dist/components.mjs

@@ -0,0 +1,72 @@
+// packages/exta/src/components/Link.tsx
+import React from "react";
+function isExternal(url) {
+  try {
+    return new URL(url, window.location.href).origin !== window.location.origin;
+  } catch {
+    return !1;
+  }
+}
+function Link({ href, onClick, prefetch, preload, ...props }) {
+  if (typeof window > "u")
+    return preload && global.__EXTA_SSR_DATA__.head.push({ type: "preload-data-link", data: href }), /* @__PURE__ */ React.createElement("a", { ...props, href }, props.children);
+  let useRouter = window._exta_useRouter, extaRouter = window._exta_router, router = useRouter();
+  if (!isExternal(href) && prefetch !== !1) {
+    let url = new URL(href, window.location.origin);
+    extaRouter.prefetch(url.pathname);
+  }
+  return /* @__PURE__ */ React.createElement("a", { ...props, href, onClick: async (e) => {
+    if (e.defaultPrevented || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || props.target === "_blank")
+      return;
+    let current = window.location, target = new URL(href, current.href), isHashOnly = href.startsWith("#"), isSamePath = target.pathname === current.pathname, isHashChange = target.hash && target.hash !== current.hash;
+    if (!(isHashOnly || isSamePath && isHashChange) && (e.preventDefault(), e.stopPropagation(), !(onClick && (await onClick(e), e.defaultPrevented)))) {
+      if (isExternal(href)) {
+        window.location.href = href;
+        return;
+      }
+      await extaRouter.goto(target.pathname), router.push(target.pathname + target.search + target.hash);
+    }
+  } }, props.children);
+}
+
+// packages/exta/src/components/Image.tsx
+import React2 from "react";
+function Image({ src, ...props }) {
+  return /* @__PURE__ */ React2.createElement("img", { ...props, src }, props.children);
+}
+
+// packages/exta/src/components/Head.tsx
+import { useEffect, cloneElement } from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+function Head({ children }) {
+  if (typeof window > "u") {
+    if (global.__EXTA_SSR_DATA__) {
+      let wrapped = Array.isArray(children) ? children.map(
+        (c, i) => cloneElement(c, { "data-ssr-head": "", key: i })
+      ) : cloneElement(children, {
+        "data-ssr-head": ""
+      });
+      global.__EXTA_SSR_DATA__.head.push({
+        type: "html",
+        data: renderToStaticMarkup(wrapped).replace(/data-ssr-head=""/g, "data-ssr-head")
+      });
+    }
+    return null;
+  }
+  return useEffect(() => {
+    document.head.querySelectorAll("[data-ssr-head]").forEach((el) => el.parentNode?.removeChild(el));
+    let html = renderToStaticMarkup(children), template = document.createElement("template");
+    template.innerHTML = html;
+    let nodes = Array.from(template.content.childNodes);
+    return nodes.forEach((node) => document.head.appendChild(node)), () => {
+      nodes.forEach((node) => {
+        document.head.contains(node) && document.head.removeChild(node);
+      });
+    };
+  }, [children]), null;
+}
+export {
+  Head,
+  Image,
+  Link
+};

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { Plugin } from 'vite';
+
+interface BaseConfig {
+    compileOptions?: CompileOptions;
+}
+interface CompileOptions {
+    /** @default {true} */
+    ignoreSideEffects?: boolean;
+    preserveSideEffects?: string[];
+    outdir?: string;
+    assetsExtensions?: string[];
+}
+
+declare function exta(options?: BaseConfig): Plugin[];
+
+interface ErrorProps {
+    status?: number | string;
+    message?: string;
+}
+
+declare const PAGE_STATIC_DATA_FUNCTION = "getStaticProps";
+declare const PAGE_STATIC_PARAMS_FUNCTION = "getStaticParams";
+
+interface StaticPropsContext {
+    params: Record<string, string>;
+}
+type StaticParamsOutput<T> = Array<T>;
+type StaticPropsFC<T = any> = (ctx: StaticPropsContext) => Promise<T> | T;
+type StaticParamsFC<T = Record<string, string>> = () => Promise<StaticParamsOutput<T>> | StaticParamsOutput<T>;
+type ServerModule = {
+    [PAGE_STATIC_DATA_FUNCTION]: StaticPropsFC;
+    [PAGE_STATIC_PARAMS_FUNCTION]: StaticParamsFC;
+};
+interface PageProps<PropsType = any, ParamsType = Record<string, string>> {
+    params: ParamsType;
+    props: PropsType;
+}
+type ExtaPage<PropsType = any, ParamsType = Record<string, string>> = (props: PageProps<PropsType, ParamsType>) => React.ReactNode;
+type ExtaLayout = (props: {
+    children: React.ReactNode;
+}) => React.ReactNode;
+type ExtaErrorComponent = (props: ErrorProps) => React.ReactNode;
+
+declare function compilePage(filename: string, options: CompileOptions, ignoreAssets: boolean): Promise<{
+    outfiles: {
+        client: string;
+        server: string;
+    };
+}>;
+
+export { compilePage, exta };
+export type { ExtaErrorComponent, ExtaLayout, ExtaPage, PageProps, ServerModule, StaticParamsFC, StaticParamsOutput, StaticPropsContext, StaticPropsFC };