@shipstatic/ship 3.4.0-beta.12 → 3.4.0-beta.14

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 is served for a missing path instead.
+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 the answer as `fallback`: the page a missing path opens, or `null` for a 404, 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.10
+## @shipstatic/types 3.8.0-beta.11
 
 License: MIT
 

package/dist/browser.d.ts

@@ -116,6 +116,14 @@ interface Deployment {
     readonly config: boolean;
     /** 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.
+     */
+    readonly fallback: string | null;
     /** Labels for categorization and filtering (lowercase, alphanumeric with separators). Always present, empty array when none. */
     labels: string[];
     /**