@fullstack-webapp/document-shell 0.1.0-beta.1 → 0.1.0-beta.3

package/README.md

@@ -27,7 +27,7 @@ results, or interactive state that cannot be known while building the HTML.
 ## Install
 
 ```sh
-pnpm add -D @fullstack-webapp/document-shell@beta
+pnpm add -D @fullstack-webapp/document-shell
 ```
 
 Document Shell supports Vite 7 and 8. It emits standard ESM and declarations;
@@ -167,17 +167,19 @@ checklist, and failure guide, see [Integration guide](docs/integration.md).
 | `@fullstack-webapp/document-shell/client` | The framework-neutral, one-shot runtime handoff. |
 | `@fullstack-webapp/document-shell/reference` | Reference-application safe-area rollout used to retain existing evidence while profiles mature; it is not a consumer profile selector. |
 
-The current beta catalog contains no `sharedDefault` profile. Therefore the
-root `createSafeAreaBridge()` deliberately emits an empty profile list today;
-ordinary consumers receive no inferred reserve. This makes unsupported startup
-geometry a visible no-op instead of silently adopting provisional values from
-the reference application.
+The current beta catalog projects all four accepted iOS standalone portrait
+profiles through `sharedDefault`: `375×812@3x`, `393×852@3x`, `402×874@3x`, and
+`430×932@3x`. Root consumers receive their `34px` startup bottom floor without
+selecting or copying a profile. Maturity remains independent: `402×874@3x` is
+`verified`, while the other three remain `provisional` and can be narrowed or
+revised as production evidence arrives. Unsupported geometry remains a visible
+no-op.
 
-`./reference` is a pre-1.0 migration seam, not a second configuration model. It
-remains only while the source application switches from its incubated package
-to the public package. Remove the subpath after every reference profile has
-either been promoted to `sharedDefault` or retired and the source application
-uses the root entry; that removal may be part of a beta breaking release.
+`./reference` is a pre-1.0 migration seam, not a second configuration model.
+All current profiles are now shared defaults, so the subpath projects the same
+catalog as the root entry. It remains temporarily for source compatibility with
+the reference application and can be removed in a later beta breaking release
+after that consumer switches to the root entry.
 
 ## Ownership boundary
 
@@ -205,9 +207,9 @@ an arbitrary callback with `Function#toString()`.
 - Document Shell validates exactly one viewport meta, manifest link, title,
   mount point, critical-shell style, static-shell marker, and module entry.
 - The shared safe-area entry only emits profiles promoted to `sharedDefault`;
-  the current catalog has none, so the root bridge is intentionally inactive.
-  Reference-only profiles never enter ordinary consumer bytes. Consumers do
-  not choose individual device profiles or rollout maturity.
+  the current catalog emits all four accepted portrait profiles while retaining
+  their verified or provisional maturity. Consumers do not choose individual
+  device profiles or rollout maturity.
 - The current safe-area runtime matches observable browser geometry and
   platform signals, not marketing device names. Unsupported geometry fails
   open and receives no reserve.

package/dist/safe-area-profiles.d.ts

@@ -30,7 +30,7 @@ export declare const safeAreaCompatibilityProfiles: ({
         bottom: number;
     };
     maturity: "provisional";
-    rollout: "referenceProduction";
+    rollout: "sharedDefault";
 } | {
     id: string;
     platform: "ios";
@@ -46,5 +46,5 @@ export declare const safeAreaCompatibilityProfiles: ({
         bottom: number;
     };
     maturity: "verified";
-    rollout: "referenceProduction";
+    rollout: "sharedDefault";
 })[];

package/dist/safe-area-profiles.js

@@ -16,7 +16,7 @@ export const safeAreaCompatibilityProfiles = [
         devicePixelRatio: 3,
         reserve: { bottom: 34 },
         maturity: 'provisional',
-        rollout: 'referenceProduction',
+        rollout: 'sharedDefault',
     },
     {
         id: 'ios-393x852-3x-portrait-standalone',
@@ -28,7 +28,7 @@ export const safeAreaCompatibilityProfiles = [
         devicePixelRatio: 3,
         reserve: { bottom: 34 },
         maturity: 'provisional',
-        rollout: 'referenceProduction',
+        rollout: 'sharedDefault',
     },
     {
         id: 'ios-402x874-3x-portrait-standalone',
@@ -40,7 +40,7 @@ export const safeAreaCompatibilityProfiles = [
         devicePixelRatio: 3,
         reserve: { bottom: 34 },
         maturity: 'verified',
-        rollout: 'referenceProduction',
+        rollout: 'sharedDefault',
     },
     {
         id: 'ios-430x932-3x-portrait-standalone',
@@ -52,6 +52,6 @@ export const safeAreaCompatibilityProfiles = [
         devicePixelRatio: 3,
         reserve: { bottom: 34 },
         maturity: 'provisional',
-        rollout: 'referenceProduction',
+        rollout: 'sharedDefault',
     },
 ];

package/docs/integration.md

@@ -19,7 +19,7 @@ coordinates lifecycle; it cannot make two independently styled tab bars match.
 ## 1. Install and create the sentinel
 
 ```sh
-pnpm add -D @fullstack-webapp/document-shell@beta
+pnpm add -D @fullstack-webapp/document-shell
 ```
 
 Replace the checked-in `index.html` with only the Vite module entry and the
@@ -250,17 +250,19 @@ Then consume the variable from both shell implementations:
 ```
 
 The root entry projects only profiles whose package-owned rollout is
-`sharedDefault`. The current beta may therefore emit an empty catalog on an
-ordinary consumer. This is intentional fail-open behavior, not a configuration
-error. Consumers cannot pass a model name, reserve value, maturity, or rollout
-policy. Promotion happens in the package after evidence review.
-
-`@fullstack-webapp/document-shell/reference` temporarily contains the source
-application's `referenceProduction` profiles so migration can preserve its
-already verified behavior without silently enabling those provisional values
-for every consumer. New applications should not import that subpath. It exits
-after those profiles are promoted or retired and the source application can use
-the root entry.
+`sharedDefault`. The current beta includes all four accepted iOS standalone
+portrait profiles. Their maturity remains distinct: one is verified and three
+are provisional, but all receive the same bounded production rollout because a
+wrong startup floor has a low and reversible visual consequence. Unsupported
+signatures still fail open. Consumers cannot pass a model name, reserve value,
+maturity, or rollout policy; narrowing or promotion happens in the package
+after evidence review.
+
+`@fullstack-webapp/document-shell/reference` is a temporary source-compatibility
+entry for the reference application. The current catalog has no
+`referenceProduction`-only profile, so this subpath projects the same profiles
+as the root entry. New applications should not import it; it exits after the
+reference application migrates to the root entry.
 
 When a reserve matches, the bridge writes the declared CSS variable before
 paint. It removes the reserve after the native inset reaches the profile floor
@@ -329,9 +331,10 @@ rather than adding delay to the handoff.
 
 ### Safe-area reserve is inactive
 
-No `sharedDefault` profile matched the observable runtime signature. This is
-the safe failure mode. Capture evidence before proposing a package profile; do
-not hard-code an application-side model table.
+No `sharedDefault` profile matched the observable runtime signature, or the
+runtime platform/version/display-mode tuple did not qualify. This is the safe
+failure mode. Capture evidence before proposing a package profile; do not
+hard-code an application-side model table.
 
 ### A diagnostics marker appears in production
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullstack-webapp/document-shell",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.3",
   "description": "Parser-visible startup shell compiler, Vite HTML pipeline, and framework-neutral runtime handoff for web applications.",
   "license": "MIT",
   "type": "module",
@@ -46,7 +46,7 @@
   },
   "publishConfig": {
     "access": "public",
-    "tag": "beta"
+    "tag": "latest"
   },
   "peerDependencies": {
     "vite": ">=7 <9"