@shipstatic/ship 3.4.0-beta.16 → 3.4.0-beta.18

package/SKILL.md

@@ -116,7 +116,7 @@ Visitors get an unlock page until they enter the password. Length: 6–128 chara
 
 ### Client-side routing
 
-A deployment whose only page is `index.html` serves it for every missing path, so a React, Vue, Svelte or Angular build works on its routes with nothing to configure. An app that ships other HTML files beside its shell declares the route itself: a `ship.json` rewrite from `/(.*)` to `/index.html`, the one the ship.json docs show. Your own rewrites run ahead of either. A root `404.html` of your own turns the automatic route off and is served for a missing path your rewrites do not claim. Every deployment states its default as `fallback`: the page declared for a missing path, or `null` when none is declared, so check it on the deploy response and add the rewrite when an app reads `null`.
+A deployment whose only page is `index.html` serves it for every missing path, so a React, Vue, Svelte or Angular build works on its routes with nothing to configure. An app that ships other HTML files beside its shell declares the route itself: a `ship.json` rewrite from `/(.*)` to `/index.html`, the one the ship.json docs show. One exception needs nothing: a React Router build that prerenders with `ssr: false` leaves its shell at `__spa-fallback.html`, and that file is served for every missing path (do not add a rewrite to `/index.html` there; it would serve the prerendered home page). Your own rewrites run ahead of either. A root `404.html` of your own turns the automatic route off and is served for a missing path your rewrites do not claim. Every deployment states its default as `fallback`: the page declared for a missing path, or `null` when none is declared, so check it on the deploy response and add the rewrite when an app reads `null`.
 
 ## Authentication
 

package/THIRD-PARTY-LICENSES.md

@@ -5,7 +5,7 @@ Their copyright notices travel with that copy, and are reproduced here in
 full. This file is GENERATED from the build's own metafile — edit the
 bundle, not this list.
 
-## @shipstatic/types 3.8.0-beta.12
+## @shipstatic/types 3.8.0-beta.13
 
 License: MIT
 

package/dist/browser.d.ts

@@ -117,12 +117,16 @@ interface Deployment {
     /** Whether deployment has a password set */
     readonly password: boolean;
     /**
-     * The page every missing path opens, when the deployment's rewrites end in
-     * a catch-all to one: the platform's single-page preset (a deployment whose
-     * only page is `index.html`), or a catch-all the author wrote. `null` when
-     * a missing path is a 404, which is what an application with pages beside
-     * its shell gets until its author declares the route. Absent from an API
-     * older than the field, as every new field on an existing entity is.
+     * The default page the deployment declares for a missing path: the
+     * platform's single-page preset (a deployment whose only page is
+     * `index.html`, or React Router's `__spa-fallback.html`), or the target of
+     * the author's own catch-all (`/(.*)` or `/:path*`) to one file. The
+     * author's other rules still run ahead of it. `null` when no default is
+     * declared, which is what an application with pages beside its shell gets
+     * until its author declares the route. Carried by a deployment, not by a
+     * list of deployments; omitted when the deployment's artifact cannot be
+     * read, and by an API older than the field. Absent is not `null`: `null`
+     * is a declaration of none.
      */
     readonly fallback?: string | null;
     /** Labels for categorization and filtering (lowercase, alphanumeric with separators). Always present, empty array when none. */