@solidjs/start 1.0.0 → 1.0.1

package/config/index.d.ts

@@ -6,7 +6,7 @@ import type { Options } from "vite-plugin-solid";
 // atleast until we sort which server options are good to use
 type ViteCustomizableConfig = CustomizableConfig & {
   server?: InlineConfig["server"];
-}
+};
 
 type SolidStartInlineConfig = {
   ssr?: boolean;
@@ -16,13 +16,19 @@ type SolidStartInlineConfig = {
   appRoot?: string;
   routeDir?: string;
   middleware?: string;
-  devOverlay?:  boolean;
+  devOverlay?: boolean;
   experimental?: {
     islands?: boolean;
-  }
+  };
   vite?:
     | ViteCustomizableConfig
     | ((options: { router: "server" | "client" | "server-function" }) => ViteCustomizableConfig);
 };
 
-export declare function defineConfig(baseConfig?: SolidStartInlineConfig): ReturnType<typeof createApp>;
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/entrypoints/app-config
+ */
+export declare function defineConfig(
+  baseConfig?: SolidStartInlineConfig
+): ReturnType<typeof createApp>;

package/dist/client/StartClient.d.ts

@@ -1,3 +1,7 @@
 import type { JSX } from "solid-js";
 import "./mount";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/client/start-client
+ */
 export declare function StartClient(): JSX.Element;

package/dist/client/StartClient.jsx

@@ -6,6 +6,10 @@ import "./mount";
 function Dummy(props) {
     return props.children;
 }
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/client/start-client
+ */
 export function StartClient() {
     return (<Dummy>
       <Dummy>

package/dist/client/islands.d.ts

@@ -1,3 +1,7 @@
 import "vinxi/client";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/client/start-client
+ */
 export declare function StartClient(): null;
 export { mount } from "./mount";

package/dist/client/islands.jsx

@@ -1,5 +1,9 @@
 // @refresh skip
 import "vinxi/client";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/client/start-client
+ */
 export function StartClient() {
     return null;
 }

package/dist/client/mount.d.ts

@@ -1,3 +1,7 @@
 import type { JSX } from "solid-js";
 import { type MountableElement } from "solid-js/web";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/client/mount
+ */
 export declare function mount(fn: () => JSX.Element, el: MountableElement): (() => void) | undefined;

package/dist/client/mount.js

@@ -1,5 +1,9 @@
 import { createStore } from "solid-js/store";
 import { createComponent, getHydrationKey, getOwner, hydrate } from "solid-js/web";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/client/mount
+ */
 export function mount(fn, el) {
     if (import.meta.env.START_ISLANDS) {
         const map = new WeakMap();
@@ -17,7 +21,8 @@ export function mount(fn, el) {
             }
             let mod = await import(
             /* @vite-ignore */
-            import.meta.env.MANIFEST["client"].chunks[el.dataset.id.split("#")[0]].output.path);
+            import.meta.env.MANIFEST["client"].chunks[el.dataset.id.split("#")[0]].output
+                .path);
             if (!mod || !el.dataset.hk)
                 return;
             let Component = mod[el.dataset.id.split("#")[1]];
@@ -58,7 +63,8 @@ export function mount(fn, el) {
             const islands = document.querySelectorAll("solid-island[data-hk]");
             const assets = new Set();
             islands.forEach((el) => el.dataset.id && assets.add(el.dataset.id));
-            Promise.all([...assets].map(asset => import(/* @vite-ignore */ import.meta.env.MANIFEST["client"].chunks[asset.split("#")[0]].output.path)))
+            Promise.all([...assets].map(asset => import(
+            /* @vite-ignore */ import.meta.env.MANIFEST["client"].chunks[asset.split("#")[0]].output.path)))
                 .then(() => {
                 islands.forEach((el) => {
                     if (el.dataset.when === "idle" && "requestIdleCallback" in window) {

package/dist/router/FileRoutes.d.ts

@@ -1,2 +1,6 @@
 export declare function createRoutes(): any[];
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/routing/file-routes
+ */
 export declare const FileRoutes: () => any[];

package/dist/router/FileRoutes.js

@@ -10,9 +10,10 @@ export function createRoutes() {
                 ...(route.$$route ? route.$$route.require().route.info : {}),
                 filesystem: true
             },
-            component: route.$component && lazyRoute(route.$component, import.meta.env.START_ISLANDS
-                ? import.meta.env.MANIFEST["ssr"]
-                : import.meta.env.MANIFEST["client"], import.meta.env.MANIFEST["ssr"]),
+            component: route.$component &&
+                lazyRoute(route.$component, import.meta.env.START_ISLANDS
+                    ? import.meta.env.MANIFEST["ssr"]
+                    : import.meta.env.MANIFEST["client"], import.meta.env.MANIFEST["ssr"]),
             children: route.children ? route.children.map(createRoute) : undefined
         };
     }
@@ -20,6 +21,10 @@ export function createRoutes() {
     return routes;
 }
 let routes;
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/routing/file-routes
+ */
 export const FileRoutes = isServer
     ? () => getRequestEvent().routes
     : () => routes || (routes = createRoutes());

package/dist/router/lazyRoute.js

@@ -6,11 +6,16 @@ export default function lazyRoute(component, clientManifest, serverManifest, exp
     return lazy(async () => {
         if (import.meta.env.DEV) {
             let manifest = import.meta.env.SSR ? serverManifest : clientManifest;
-            const mod = await manifest.inputs[component.src].import();
+            // import() throws if a module doesn't exist, which includes any
+            // modules loaded by the route itself, so it's important we catch here
+            const mod = await manifest.inputs[component.src].import().catch(() => null);
+            // fallback to an empty component as any errors will surface in the vite overlay
+            if (!mod)
+                return { default: () => [] };
             if (!mod[exported])
                 console.error(`Module ${component.src} does not export ${exported}`);
             const Component = mod[exported];
-            let assets = await clientManifest.inputs?.[component.src].assets();
+            let assets = await clientManifest.inputs?.[component.src]?.assets();
             const styles = assets.filter((asset) => asset.tag === "style");
             if (typeof window !== "undefined" && import.meta.hot) {
                 import.meta.hot.on("css-update", data => {

package/dist/server/StartServer.d.ts

@@ -1,5 +1,9 @@
 import type { Component, JSX } from "solid-js";
 import type { DocumentComponentProps } from "./types";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/start-server
+ */
 export declare function StartServer(props: {
     document: Component<DocumentComponentProps>;
 }): JSX.Element;

package/dist/server/StartServer.jsx

@@ -2,7 +2,7 @@
 // @ts-ignore
 import App from "#start/app";
 import { Hydration, HydrationScript, NoHydration, getRequestEvent, ssr, useAssets } from "solid-js/web";
-import { ErrorBoundary } from "../shared/ErrorBoundary";
+import { ErrorBoundary, TopErrorBoundary } from "../shared/ErrorBoundary";
 import { renderAsset } from "./renderAsset";
 const docType = ssr("<!DOCTYPE html>");
 function matchRoute(matches, routes, matched = []) {
@@ -22,11 +22,15 @@ function matchRoute(matches, routes, matched = []) {
         return next;
     }
 }
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/start-server
+ */
 export function StartServer(props) {
     const context = getRequestEvent();
     // @ts-ignore
     const nonce = context.nonce;
-    let assets;
+    let assets = [];
     Promise.resolve().then(async () => {
         let assetPromises = [];
         // @ts-ignore
@@ -57,23 +61,25 @@ export function StartServer(props) {
     useAssets(() => (assets.length ? assets.map(m => renderAsset(m)) : undefined));
     return (<NoHydration>
       {docType}
-      <props.document assets={<>
-            <HydrationScript />
-            {context.assets.map((m) => renderAsset(m, nonce))}
-          </>} scripts={nonce ? (<>
-              <script nonce={nonce} innerHTML={`window.manifest = ${JSON.stringify(context.manifest)}`}/>
-              <script type="module" nonce={nonce} async src={import.meta.env.MANIFEST["client"].inputs[import.meta.env.MANIFEST["client"].handler].output.path}/>
-            </>) : (<>
-              <script innerHTML={`window.manifest = ${JSON.stringify(context.manifest)}`}/>
-              <script type="module" async src={import.meta.env.MANIFEST["client"].inputs[import.meta.env.MANIFEST["client"].handler].output.path}/>
-            </>)}>
-        {!import.meta.env.START_ISLANDS ? (<Hydration>
-            <ErrorBoundary>
+      <TopErrorBoundary>
+        <props.document assets={<>
+              <HydrationScript />
+              {context.assets.map((m) => renderAsset(m, nonce))}
+            </>} scripts={nonce ? (<>
+                <script nonce={nonce} innerHTML={`window.manifest = ${JSON.stringify(context.manifest)}`}/>
+                <script type="module" nonce={nonce} async src={import.meta.env.MANIFEST["client"].inputs[import.meta.env.MANIFEST["client"].handler].output.path}/>
+              </>) : (<>
+                <script innerHTML={`window.manifest = ${JSON.stringify(context.manifest)}`}/>
+                <script type="module" async src={import.meta.env.MANIFEST["client"].inputs[import.meta.env.MANIFEST["client"].handler].output.path}/>
+              </>)}>
+          {!import.meta.env.START_ISLANDS ? (<Hydration>
+              <ErrorBoundary>
+                <App />
+              </ErrorBoundary>
+            </Hydration>) : (<ErrorBoundary>
               <App />
-            </ErrorBoundary>
-          </Hydration>) : (<ErrorBoundary>
-            <App />
-          </ErrorBoundary>)}
-      </props.document>
+            </ErrorBoundary>)}
+        </props.document>
+      </TopErrorBoundary>
     </NoHydration>);
 }

package/dist/server/handler.d.ts

@@ -5,4 +5,8 @@ import type { FetchEvent, HandlerOptions, PageEvent, ResponseStub } from "./type
  */
 export declare function getExpectedRedirectStatus(response: ResponseStub): number;
 export declare function createBaseHandler(fn: (context: PageEvent) => unknown, createPageEvent: (event: FetchEvent) => Promise<PageEvent>, options?: HandlerOptions | ((context: PageEvent) => HandlerOptions | Promise<HandlerOptions>)): import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<any>>;
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/create-handler
+ */
 export declare function createHandler(fn: (context: PageEvent) => unknown, options?: HandlerOptions | ((context: PageEvent) => HandlerOptions | Promise<HandlerOptions>)): import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<any>>;

package/dist/server/handler.js

@@ -108,6 +108,10 @@ function handleStreamCompleteRedirect(context) {
         to && write(`<script>window.location="${to}"</script>`);
     };
 }
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/create-handler
+ */
 export function createHandler(fn, options) {
     return createBaseHandler(fn, createPageEvent, options);
 }

package/dist/server/serverFunction.d.ts

@@ -1,2 +1,6 @@
 import type { ServerFunctionMeta } from "./types";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/get-server-function-meta
+ */
 export declare function getServerFunctionMeta(): ServerFunctionMeta | undefined;

package/dist/server/serverFunction.jsx

@@ -1,4 +1,8 @@
 import { getRequestEvent } from "solid-js/web";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/get-server-function-meta
+ */
 export function getServerFunctionMeta() {
     return getRequestEvent()?.locals.serverFunctionMeta;
 }

package/dist/server/spa/StartServer.d.ts

@@ -1,5 +1,9 @@
 import type { Component } from "solid-js";
 import type { DocumentComponentProps } from "../types";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/start-server
+ */
 export declare function StartServer(props: {
     document: Component<DocumentComponentProps>;
 }): import("solid-js").JSX.Element;

package/dist/server/spa/StartServer.jsx

@@ -1,18 +1,25 @@
 import { NoHydration, getRequestEvent, ssr } from "solid-js/web";
+import { TopErrorBoundary } from "../../shared/ErrorBoundary";
 import { renderAsset } from "../renderAsset";
 const docType = ssr("<!DOCTYPE html>");
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/start-server
+ */
 export function StartServer(props) {
     const context = getRequestEvent();
     // @ts-ignore
     const nonce = context.nonce;
     return (<NoHydration>
       {docType}
-      <props.document assets={<>{context.assets.map((m) => renderAsset(m))}</>} scripts={nonce ? (<>
-              <script nonce={nonce} innerHTML={`window.manifest = ${JSON.stringify(context.manifest)}`}/>
-              <script type="module" src={import.meta.env.MANIFEST["client"].inputs[import.meta.env.MANIFEST["client"].handler].output.path}/>
-            </>) : (<>
-              <script innerHTML={`window.manifest = ${JSON.stringify(context.manifest)}`}/>
-              <script type="module" src={import.meta.env.MANIFEST["client"].inputs[import.meta.env.MANIFEST["client"].handler].output.path}/>
-            </>)}/>
+      <TopErrorBoundary>
+        <props.document assets={<>{context.assets.map((m) => renderAsset(m))}</>} scripts={nonce ? (<>
+                <script nonce={nonce} innerHTML={`window.manifest = ${JSON.stringify(context.manifest)}`}/>
+                <script type="module" src={import.meta.env.MANIFEST["client"].inputs[import.meta.env.MANIFEST["client"].handler].output.path}/>
+              </>) : (<>
+                <script innerHTML={`window.manifest = ${JSON.stringify(context.manifest)}`}/>
+                <script type="module" src={import.meta.env.MANIFEST["client"].inputs[import.meta.env.MANIFEST["client"].handler].output.path}/>
+              </>)}/>
+      </TopErrorBoundary>
     </NoHydration>);
 }

package/dist/server/spa/handler.d.ts

@@ -1,3 +1,7 @@
 import { FetchEvent, HandlerOptions, PageEvent } from "../types";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/create-handler
+ */
 export declare function createHandler(fn: (context: PageEvent) => unknown, options?: HandlerOptions | ((context: PageEvent) => HandlerOptions)): import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<any>>;
 export declare function createPageEvent(ctx: FetchEvent): Promise<PageEvent>;

package/dist/server/spa/handler.js

@@ -1,4 +1,8 @@
 import { createBaseHandler } from "../handler";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/create-handler
+ */
 export function createHandler(fn, options) {
     return createBaseHandler(fn, createPageEvent, options);
 }

package/dist/shared/ErrorBoundary.d.ts

@@ -1,2 +1,3 @@
 import { type ParentProps } from "solid-js";
 export declare const ErrorBoundary: (props: ParentProps) => import("solid-js").JSX.Element;
+export declare const TopErrorBoundary: (props: ParentProps) => import("solid-js").JSX.Element;

package/dist/shared/ErrorBoundary.jsx

@@ -1,16 +1,36 @@
 // @refresh skip
-import { ErrorBoundary as DefaultErrorBoundary } from "solid-js";
+import { ErrorBoundary as DefaultErrorBoundary, catchError } from "solid-js";
 import { isServer } from "solid-js/web";
 import { HttpStatusCode } from "./HttpStatusCode";
 import { DevOverlay } from "./dev-overlay";
 export const ErrorBoundary = import.meta.env.DEV && import.meta.env.START_DEV_OVERLAY
     ? (props) => <DevOverlay>{props.children}</DevOverlay>
     : (props) => {
-        const message = isServer ? "500 | Internal Server Error" : "Error | Uncaught Client Exception";
-        return (<DefaultErrorBoundary fallback={<>
-            <span style="font-size:1.5em;text-align:center;position:fixed;left:0px;bottom:55%;width:100%;">{message}</span>
-            <HttpStatusCode code={500}/>
-          </>}>
-        {props.children}
-      </DefaultErrorBoundary>);
+        const message = isServer
+            ? "500 | Internal Server Error"
+            : "Error | Uncaught Client Exception";
+        return (<DefaultErrorBoundary fallback={error => {
+                console.error(error);
+                return (<>
+                  <span style="font-size:1.5em;text-align:center;position:fixed;left:0px;bottom:55%;width:100%;">
+                    {message}
+                  </span>
+                  <HttpStatusCode code={500}/>
+                </>);
+            }}>
+            {props.children}
+          </DefaultErrorBoundary>);
     };
+export const TopErrorBoundary = (props) => {
+    let isError = false;
+    const res = catchError(() => props.children, err => {
+        console.error(err);
+        isError = !!err;
+    });
+    return isError ? (<>
+      <span style="font-size:1.5em;text-align:center;position:fixed;left:0px;bottom:55%;width:100%;">
+        500 | Internal Server Error
+      </span>
+      <HttpStatusCode code={500}/>
+    </>) : (res);
+};

package/dist/shared/GET.d.ts

@@ -1 +1,5 @@
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/get
+ */
 export declare function GET<T extends (...args: any[]) => any>(fn: T): (...args: Parameters<T>) => ReturnType<T>;

package/dist/shared/GET.js

@@ -1,3 +1,7 @@
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/get
+ */
 export function GET(fn) {
     return (...args) => {
         return fn.GET(...args);

package/dist/shared/HttpHeader.d.ts

@@ -3,4 +3,8 @@ export interface HttpHeaderProps {
     value: string;
     append?: boolean;
 }
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/http-header
+ */
 export declare const HttpHeader: (props: HttpHeaderProps) => null;

package/dist/shared/HttpHeader.jsx

@@ -1,6 +1,10 @@
 // @refresh skip
 import { onCleanup } from "solid-js";
 import { getRequestEvent, isServer } from "solid-js/web";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/http-header
+ */
 export const HttpHeader = isServer
     ? (props) => {
         const event = getRequestEvent();

package/dist/shared/HttpStatusCode.d.ts

@@ -2,4 +2,8 @@ export interface HttpStatusCodeProps {
     code: number;
     text?: string;
 }
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/http-status-code
+ */
 export declare const HttpStatusCode: (props: HttpStatusCodeProps) => null;

package/dist/shared/HttpStatusCode.jsx

@@ -1,6 +1,10 @@
 // @refresh skip
 import { onCleanup } from "solid-js";
 import { getRequestEvent, isServer } from "solid-js/web";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/server/http-status-code
+ */
 export const HttpStatusCode = isServer
     ? (props) => {
         const event = getRequestEvent();

package/dist/shared/clientOnly.d.ts

@@ -1,4 +1,8 @@
 import type { Component, ComponentProps, JSX } from "solid-js";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/client/client-only
+ */
 export default function clientOnly<T extends Component<any>>(fn: () => Promise<{
     default: T;
 }>): (props: ComponentProps<T> & {

package/dist/shared/clientOnly.jsx

@@ -1,5 +1,9 @@
 import { createMemo, createSignal, onMount, sharedConfig, splitProps, untrack } from "solid-js";
 import { isServer } from "solid-js/web";
+/**
+ *
+ * Read more: https://docs.solidjs.com/solid-start/reference/client/client-only
+ */
 // not using Suspense
 export default function clientOnly(fn) {
     if (isServer)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidjs/start",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "author": "Ryan Carniato",
   "license": "MIT",
@@ -29,7 +29,11 @@
     "./server/spa": "./dist/server/spa/index.jsx",
     "./client": "./dist/client/index.jsx",
     "./client/islands": "./dist/client/islands.jsx",
-    "./client/spa": "./dist/client/spa/index.jsx"
+    "./client/spa": "./dist/client/spa/index.jsx",
+    "./env": {
+      "types": "./env.d.ts",
+      "import": null
+    }
   },
   "typesVersions": {
     "*": {