@graview/embed 0.1.15 → 0.1.17

package/README.md

@@ -2,7 +2,7 @@
 
 Mount a declared Graview app into any element — a paragraph of a docs page, a
 card on a dashboard, a preview in a builder — without the Shell, sized to the
-element, themed within it, and switchable between its faces.
+element, themed within it, under one app bar.
 
 ```ts
 import { mount } from "@graview/embed";
@@ -10,22 +10,58 @@ import { mount } from "@graview/embed";
 const handle = mount(document.querySelector("#garden")!, {
   app,                        // defineApp(...)
   seed,                       // the graph to open with, or nothing
-  face: "graview",            // "scene" | "graview" | "pages" | "picture" — one named lens, no chrome: stop "#view=<place>"
+  face: "graview",            // "scene" | "graview" | "pages" | "picture" — one named lens, no chrome: stop "#view=<place>"; leave it out and the app opens on its home view, else the scene
   stop: "#focus=plot-1",      // the scene's view state, as its URL fragment
   principal: { kind: "human", id: "june", roles: ["coordinator"] },
-  toggle: true,               // the face switcher and Standing, above the picture
+  bar: true,                  // the app bar over every face (the default)
 });
 
-handle.setFace("pages");      // the routed face, at the element's width
+handle.setPath("/plots");     // a place: the plots' list, at the element's width
+handle.setPath("/places/overview"); // the scene, at its own address
 handle.setStop("#overview=1&expand=kind:plot");
 handle.unmount();
 ```
 
 `<Embed {...options} />` is the same thing as a React component.
 
+## The app bar
+
+One bar stands over every face (FR-131). At the left, the app: its mark —
+the brand's logo, when the document has one — and its name, said once, as
+the page's heading (`heading`: `1` when the host's page is the app, `2`, the
+default, inside an article, `false` when the host's own heading says it),
+and the way home. Right after it, the switch between the app's two faces
+(FR-137): "Scene" and "Pages", an icon and a word each (the icons alone on
+a phone, the words their accessible names), two buttons whose
+`aria-pressed` says which is drawn. Scene draws the scene under the bar;
+Pages goes back to the page the reader was on. A declaration may call them
+something else (`pages: { scene: "The farm", pages: "Lists" }`); the
+scene's address is `/places/overview` whatever it is called. Then, on
+Pages, the place you are on as one control — its name and a chevron — that
+opens every place the app has (FR-138): the home first, then the Lists
+(one per kind) and the Pictures (each named lens, and how the kinds
+connect), each with its mark, a long name wrapped. Every place is two
+presses away, Escape gives the keyboard back to the control, and the bar
+is one row of 48 px however many places there are; on a phone the place
+control is the page's first line, under the bar. At the right, three tools
+of one size: Find (inline; ⌘K or Ctrl+K on a desk, a magnifier that opens
+the box on a phone), the standing (a dot in the tone of the rules, a number
+only when one is broken, opening what is broken; its name says "Everything
+is in order" otherwise), and the person (an avatar whose menu holds who is
+signed in, the seats, the host's own actions and, for whoever keeps the
+app, the installation and the studio). `bar: false` draws none of it, for a
+host whose own page already says all of that.
+
+A HOME VIEW IS THE FRONT PAGE (FR-136). An app with a home view — the
+declaration's `views.home`, or a worker view attached to `"home"` — opens
+on Pages at its home, full width under the bar, on a desk as on a phone,
+when the host names no face; under address routing it does so at the bare
+address whatever face the host names. Nothing floats over the scene. A
+declaration that names another first place (`pages.first`) opens there.
+
 ## What a page loads first
 
-The frame — the element's region, its theme, the strip, the provider — is
+The frame — the element's region, its theme, the app bar, the provider — is
 on the page when `mount` returns. Each face is a chunk of its own, fetched
 the first time it is drawn: a page that opens on the pages never loads the
 scene, one that opens on the scene never loads the router, and the
@@ -49,12 +85,16 @@ const handle = mount(root, { app, face });  // drawn in this commit
 ```
 
 What this asks of the framework, and what it adds: the theme scopes to the
-element (`themeBaseCss(scheme, brand, { scope })`, and the scene's own rules,
-`sceneCss`, drawn by the scene face beside it) rather than the document, every
+element (`themeBaseCss(scheme, brand, { scope })`, and the blocks a view is
+drawn with, `viewsCss`, and the scene's own rules, `sceneCss`, drawn by the
+face that needs them beside it) rather than the document, every
 rule of it held inside that element, so nothing of the host's is restyled; the
 panes size against the picture's own box (`cqh`) rather than the viewport;
 the routed face runs on a memory router, so the host page's address is never
-touched (unless the host's page is the app: see below); the brand's fonts are fetched by the embed rather than assumed. The
+touched (unless the host's page is the app: see below); the brand's fonts are fetched by the embed rather than assumed. The page's icon is
+the host's: only a host whose page is the app passes `favicon: true` to wear
+the brand's (FR-124), and an app that prefers dark is drawn dark until the host
+stamps a scheme of its own. The
 store is in memory and starts from the seed on every mount, unless the host
 hands it one.
 
@@ -80,14 +120,15 @@ Shell spells it:
 | Address | Drawn |
 |---|---|
 | `/apps/a1/places/the-board`, `/apps/a1/tasks/t1` | the routed face, at that page |
-| `/apps/a1#overview=1`, `/apps/a1#focus=t1` | the scene, at that stop (the Graview at altitude) |
-| `/apps/a1` | the routed face's home, or on arrival the host's `face` |
+| `/apps/a1/places/overview#focus=t1`, `/apps/a1/places/overview#overview=1` | the scene, at that stop (the Graview at altitude) |
+| `/apps/a1#focus=t1` | the scene too — a link written before the scene had an address — tidied on arrival to the scene's address |
+| `/apps/a1` | the routed face's home; on arrival, the home when the app has a home view, else the host's `face` (the Graview or the scene land on the scene's address) |
 
 Each page the routed face opens is pushed, and Back returns. The scene
 keeps its stop in the fragment the way the Shell does: a step is pushed,
-moving the furniture replaces. The face toggle pushes the address of the
-face it goes to, so Back undoes it, and the page you left is where the
-toggle returns you. A reload stays where it was. `faceAtAddress(options)`
+moving the furniture replaces. The switch and the place list push the
+address of where they go, the scene's included, so Back undoes it. A reload stays where it
+was. `faceAtAddress(options)`
 is the face an address opens on, for a host that renders `<Embed>` itself.
 `placesOf(app)` gives each place's `address` within the app, and
 `addressOf(place, { basePath })` from `@graview/core` gives it under the
@@ -96,9 +137,11 @@ base, spelled as the face's own links are (`pathWithin` reads one back).
 `routing: "memory"`, the default, is for somebody else's page: it never
 writes `history` and leaves `location` as it was. A host that keeps its
 own history stays on memory routing: `onNavigate(path, how)` is told each
-page the routed face opens (the path within the app, and `"push"`,
-`"replace"` or `"pop"`), and `handle.setPath(path)` sends it back to one
-when the host's own Back arrives.
+place the reader goes to (the path within the app — `/places/overview` for
+the scene — and `"push"`, `"replace"` or `"pop"`), and `handle.setPath(path)`
+sends the reader back to one when the host's own Back arrives: the
+scene's path draws the scene, any other the page. `where().path` is the
+place's path the same way.
 
 ## When the declaration changes
 
@@ -122,6 +165,14 @@ the scheme, the brand and the notices stay; the faces are drawn again, so
 an open menu, a scroll position and a half-typed field do not. `drawn()`
 resolves once the new app is on the page.
 
+A renamed app says its new name at once (FR-128). A `label` that was the
+app's own name — as a host that mounts with `label: app.name` gives it —
+follows the new app: the embed's accessible name and each landmark inside
+say the new name, and the bar's name — its heading — is the new app's. A label the host chose ("Chapter 13") stays;
+`setApp(app, store, { label })` gives another, and `handle.setLabel(label)`
+renames the embed in place. `handle.setHostActions(actions)` changes the
+host's own actions in the profile menu the same way.
+
 A host that must remount reads the place first and hands it back:
 
 ```ts
@@ -148,7 +199,7 @@ the embed reads the rung it means rather than guessing a number.
 ## The host's own actions
 
 A host's links about the app and the person — "Change the app", "Your
-apps", "Report this app" — go in the strip's profile menu, under who is
+apps", "Report this app" — go in the person's menu on the app bar, under who is
 signed in, rather than in a menu of the host's own laid over the scene:
 
 ```ts
@@ -231,7 +282,7 @@ mount(root, {
 });
 ```
 
-A view, a page, the strip or the studio that throws is contained where it
+A view, a page, the bar or the studio that throws is contained where it
 threw: it says it could not draw and offers to try again, and the rest of
 the embed keeps working. The host is told the error's class (a TypeError,
 a `GraphError`) and the framework module that caught it, never the message,
@@ -240,7 +291,7 @@ how many milliseconds it took.
 
 ## What the host can keep
 
-The Studio is on the strip for the seat that keeps the app, and writes
+The Studio is in the person's menu on the scene for the seat that keeps the app, and writes
 through a dev server's door or hands over files. A host whose readers
 cannot save a declaration leaves it off, or keeps what it applies:
 

package/dist/address.d.ts

@@ -4,30 +4,38 @@ import type { EmbedFace, FrameOptions } from "./frame.js";
 /**
  * THE FACE AN EMBED OPENS ON (FR-106): under memory routing, the host's
  * (`face`, else the one its `stop` implies); under address routing, the one
- * the address names — a page past the home is the routed face, a fragment
- * at the home is the scene's stop — and the host's when it names none.
+ * the address names — the overview's place is the scene (FR-132), any other
+ * page the routed face, a fragment at the home the scene's stop — and the
+ * host's when it names none.
  * `mount` asks this itself; a host that renders `<Embed>` passes it as `face`.
  */
 export declare function faceAtAddress(options: Pick<FrameOptions, "routing" | "basePath"> & {
     readonly face?: EmbedFace;
     readonly stop?: string;
 }): EmbedFace;
-/** The stop the address holds for the scene on arrival, if it holds one. */
+/**
+ * WHETHER THE ADDRESS IS THE BARE HOME, NAMING NO FACE (FR-136): under
+ * address routing, the app's own address on arrival with no fragment and
+ * no entry the router wrote. An app with a home view opens on it there,
+ * whatever face the host would otherwise draw.
+ */
+export declare function atTheBareHome(options: Pick<FrameOptions, "routing" | "basePath">): boolean;
+/** The stop the address holds for the scene on arrival, if it holds one: on the overview's address, or the home's. */
 export declare function stopAtAddress(basePath: string | undefined): string | undefined;
 /**
  * Keeps the face in step with the address: Back and Forward move between
- * the routed face and the scene, and the face toggle pushes the address of
- * the face it goes to. Inside the provider; the scene's own fragment sync
+ * the routed face and the overview, and the bar pushes the address of the
+ * place it goes to. Inside the provider; the scene's own fragment sync
  * (`UrlSync`) is drawn by the scene face, so it is fetched with the scene.
  */
 export declare function AddressBar({ basePath, pagesWere, shown, onFace, toggle, kinds, places, }: {
     readonly basePath: string | undefined;
-    /** The page the routed face had before a new declaration (FR-116), for the toggle to go back to. */
+    /** The page the routed face had before a new declaration (FR-116), to go back to. */
     readonly pagesWere?: string | undefined;
     readonly shown: EmbedFace;
     readonly onFace: ((face: EmbedFace) => void) | undefined;
-    /** Where the strip's toggle is handed this bar's way of changing face. */
-    readonly toggle: MutableRefObject<((face: EmbedFace) => void) | undefined>;
+    /** Where the app bar is handed this one's way of changing face: to a page's path, or to the overview at a stop. */
+    readonly toggle: MutableRefObject<((face: EmbedFace, path?: string, stop?: string) => void) | undefined>;
     readonly kinds: readonly string[];
     readonly places: readonly Place[];
 }): null;

package/dist/address.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAIlE,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA+B1D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIpJ;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,MAAM,GACP,EAAE;IACD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,oGAAoG;IACpG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACzD,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAC3E,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CACnC,QA8CA"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAIjF,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqC1D;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIpJ;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG,OAAO,CAG1F;AAED,sHAAsH;AACtH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI9E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,MAAM,GACP,EAAE;IACD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACzD,mHAAmH;IACnH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACzG,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CACnC,QA4CA"}

package/dist/address.js

@@ -1,4 +1,4 @@
-import { addressOf, pathWithin } from "@graview/core";
+import { addressOf, OVERVIEW_PATH, pathWithin } from "@graview/core";
 import { aggregateId, fromUrl, toUrl, withFocus, withOverview } from "@graview/layout/view";
 import { descentTarget } from "@graview/primitives/frame";
 import { useNavigation } from "@graview/react/provider";
@@ -10,14 +10,19 @@ import { useEffect, useRef } from "react";
  * where on it, the way the whole-page Shell spells it:
  *
  *   <base>/places/the-board, <base>/tasks/t1   a page: the routed face, on its router
- *   <base>#overview=1, <base>#focus=t1         a stop: the scene (the Graview at altitude),
- *                                              its view state in the fragment
+ *   <base>/places/overview#focus=t1            the overview (FR-132): the scene, its
+ *                                              view state in the fragment — at altitude
+ *                                              (`#overview=1`), the Graview
+ *   <base>#focus=t1                            a stop written before the scene was a
+ *                                              place: the scene still, tidied to the
+ *                                              overview's address on arrival
  *   <base>                                     the routed face's home — or, on arrival
- *                                              with no entry the router wrote, the host's face
+ *                                              with no entry the router wrote, the home
+ *                                              when the app has a home view (FR-136),
+ *                                              else the host's face
  *
- * The scene always writes a fragment, even an empty `#`, so an address
- * without one past arrival is a page. The face toggle is a step like any
- * other: it pushes the address of the face it goes to, and Back undoes it.
+ * Moving between the overview and a page is a step like any other: the bar
+ * pushes the address of the place it goes to, and Back undoes it.
  */
 /** The router's own mark on an entry it wrote: `{ idx }` (react-router), kept across a reload. */
 const routerWrote = (state) => typeof state === "object" && state !== null && "idx" in state;
@@ -26,6 +31,8 @@ function faceNamed(basePath) {
     const path = pathWithin(window.location.pathname, basePath);
     if (path === null)
         return null;
+    if (path === OVERVIEW_PATH)
+        return fromUrl(window.location.hash).overview ? "graview" : "scene";
     if (path !== "/")
         return "pages";
     if (window.location.href.includes("#"))
@@ -35,8 +42,9 @@ function faceNamed(basePath) {
 /**
  * THE FACE AN EMBED OPENS ON (FR-106): under memory routing, the host's
  * (`face`, else the one its `stop` implies); under address routing, the one
- * the address names — a page past the home is the routed face, a fragment
- * at the home is the scene's stop — and the host's when it names none.
+ * the address names — the overview's place is the scene (FR-132), any other
+ * page the routed face, a fragment at the home the scene's stop — and the
+ * host's when it names none.
  * `mount` asks this itself; a host that renders `<Embed>` passes it as `face`.
  */
 export function faceAtAddress(options) {
@@ -45,38 +53,51 @@ export function faceAtAddress(options) {
         return asked;
     return faceNamed(options.basePath) ?? asked;
 }
-/** The stop the address holds for the scene on arrival, if it holds one. */
+/**
+ * WHETHER THE ADDRESS IS THE BARE HOME, NAMING NO FACE (FR-136): under
+ * address routing, the app's own address on arrival with no fragment and
+ * no entry the router wrote. An app with a home view opens on it there,
+ * whatever face the host would otherwise draw.
+ */
+export function atTheBareHome(options) {
+    if (options.routing !== "address" || typeof window === "undefined")
+        return false;
+    return pathWithin(window.location.pathname, options.basePath) === "/" && faceNamed(options.basePath) === null;
+}
+/** The stop the address holds for the scene on arrival, if it holds one: on the overview's address, or the home's. */
 export function stopAtAddress(basePath) {
     if (typeof window === "undefined")
         return undefined;
-    return pathWithin(window.location.pathname, basePath) === "/" && window.location.href.includes("#") ? window.location.hash || "#" : undefined;
+    const path = pathWithin(window.location.pathname, basePath);
+    return (path === "/" || path === OVERVIEW_PATH) && window.location.href.includes("#") ? window.location.hash || "#" : undefined;
 }
 /**
  * Keeps the face in step with the address: Back and Forward move between
- * the routed face and the scene, and the face toggle pushes the address of
- * the face it goes to. Inside the provider; the scene's own fragment sync
+ * the routed face and the overview, and the bar pushes the address of the
+ * place it goes to. Inside the provider; the scene's own fragment sync
  * (`UrlSync`) is drawn by the scene face, so it is fetched with the scene.
  */
 export function AddressBar({ basePath, pagesWere, shown, onFace, toggle, kinds, places, }) {
     const { view, go } = useNavigation();
     const latest = useRef({ shown, view, onFace });
     latest.current = { shown, view, onFace };
-    // The page the routed face was on when the scene was asked for, to go back to by the toggle.
+    // The page the routed face was on when the overview was asked for, to go back to.
     const pagesAt = useRef(pagesWere ?? "/");
     const leaving = () => {
         pagesAt.current = `${pathWithin(window.location.pathname, basePath) ?? "/"}${window.location.search}`;
     };
-    toggle.current = (next) => {
+    toggle.current = (next, path, asked) => {
         const { shown: from, view: here, onFace: tell } = latest.current;
         if (next === "pages" && from !== "pages") {
-            window.history.pushState(null, "", addressOf(pagesAt.current, { basePath }));
+            window.history.pushState(null, "", addressOf(path ?? pagesAt.current, { basePath }));
         }
         else if (next !== "pages" && from === "pages") {
             leaving();
             // The view the scene will draw, decided here so the fragment pushed is the one it lands on.
-            const stop = next === "graview" ? withOverview(here, true) : here.overview ? withFocus(withOverview(here, false), descentTarget(here, kinds)) : here;
+            const given = asked === undefined ? here : placed(fromUrl(asked), places);
+            const stop = next === "graview" ? withOverview(given, true) : given.overview ? withFocus(withOverview(given, false), descentTarget(given, kinds)) : given;
             go(stop);
-            window.history.pushState(null, "", `${addressOf("/", { basePath })}${toUrl(stop)}`);
+            window.history.pushState(null, "", `${addressOf(OVERVIEW_PATH, { basePath })}${toUrl(stop)}`);
         }
         tell?.(next);
     };
@@ -95,10 +116,7 @@ export function AddressBar({ basePath, pagesWere, shown, onFace, toggle, kinds,
             // Between the scene and the Graview the fragment sync follows by itself; from the pages, the scene comes back where the fragment says.
             if (from !== "pages")
                 return;
-            const parsed = fromUrl(window.location.hash);
-            const name = parsed.within?.["view"];
-            const place = name !== undefined && !parsed.focusId ? places.find((candidate) => candidate.as === name) : undefined;
-            go(place ? { ...parsed, focusId: aggregateId(place.kind) } : parsed);
+            go(placed(fromUrl(window.location.hash), places));
             tell?.(named);
         };
         window.addEventListener("popstate", onPop);
@@ -106,4 +124,10 @@ export function AddressBar({ basePath, pagesWere, shown, onFace, toggle, kinds,
     }, [basePath, go, places]);
     return null;
 }
+/** A stop that names a place by its name alone (`#view=the-board`) goes to the group it is a picture of. */
+function placed(parsed, places) {
+    const name = parsed.within?.["view"];
+    const place = name !== undefined && !parsed.focusId ? places.find((candidate) => candidate.as === name) : undefined;
+    return place ? { ...parsed, focusId: aggregateId(place.kind) } : parsed;
+}
 //# sourceMappingURL=address.js.map

package/dist/address.js.map

@@ -1 +1 @@
-{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.tsx"],"names":[],"mappings":"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"}

package/dist/embed.d.ts

@@ -27,26 +27,32 @@ export declare function preload(...faces: readonly EmbedFace[]): Promise<void>;
  */
 export { AUTO_SCENE_HEIGHT };
 export interface EmbedOptions<S extends AnySchema = AnySchema> extends FrameOptions<S> {
-    /** Which face to open on. Omitted, the stop decides: altitude opens the Graview, anything else the scene. */
+    /**
+     * Which face to open on. Omitted, the stop decides: at altitude the
+     * Graview, anything else the scene — the app's overview, one of its
+     * places (FR-132).
+     */
     readonly face?: EmbedFace;
     /** The scene's view state, as the fragment the app itself would put in its address bar. */
     readonly stop?: string;
     /**
-     * THE WORKBENCH'S HEADING (FR-25): the level the embed's name is said at,
-     * for a reader moving by headings — `1` when the host's page is the app,
-     * `2` (the default) inside somebody else's article, `false` when the
-     * host's own heading already names it. The pages face brings its own.
+     * THE APP'S NAME AS A HEADING (FR-25, FR-131): the level the app bar says
+     * the name at, for a reader moving by headings — `1` when the host's page
+     * is the app, `2` (the default) inside somebody else's article, `false`
+     * when the host's own heading already names it. Each page's own title is
+     * said under it, at the level below the app's.
      */
     readonly heading?: 1 | 2 | 3 | 4 | 5 | 6 | false;
     /**
-     * Below this width the scene and the Graview give way to the pages face,
-     * and come back above it. A phone's chat is no place for a map. Off by default.
+     * Below this width the scene and the Graview give way to the routed face,
+     * and come back above it — unless the reader asks for the overview on the
+     * bar, which is then drawn whatever the width. Off by default.
      */
     readonly pagesBelow?: number;
     /**
-     * WHAT BECOMES OF THE STUDIO (FR-19). Offered by default, for the seat
-     * that keeps the app, writing through a dev server's door or handing
-     * over files. `false` leaves it off the strip: a hosted reader cannot
+     * WHAT BECOMES OF THE STUDIO (FR-19). Offered by default, in the
+     * person's menu for the seat that keeps the app, writing through a dev
+     * server's door or handing over files. `false` leaves it out: a hosted reader cannot
      * save a declaration, so is not offered one to change. `{ onApply }`
      * keeps it and hands the host what the checker passed, writing nothing
      * itself: the host makes it a proposal, a version, a review.
@@ -85,7 +91,7 @@ export interface EmbedStudio {
     readonly onApply: StudioOnApply;
     /**
      * What the studio's picture is to the host's page (FR-58). Inside an
-     * embed it is a labelled region by default, never a second `<main>`;
+     * embed it is a labeled region by default, never a second `<main>`;
      * "main" is for a host whose page has none of its own and whose whole
      * body is the studio.
      */
@@ -110,19 +116,30 @@ export interface EmbedStudio {
     readonly place?: typeof StudioPlaceType;
 }
 export interface EmbedProps<S extends AnySchema = AnySchema> extends EmbedOptions<S> {
-    /** Called when the strip's switcher is pressed; the host decides the face. */
+    /** Called when the bar's switch moves between the scene and the pages (FR-137); the host decides the face. */
     readonly onFace?: (face: EmbedFace) => void;
-    /** Called when a seat on the strip is pressed; the host decides who sits. */
+    /** Told, once, the face the embed opened on when the host named none (FR-136): the home's, or the scene. */
+    readonly onOpening?: (face: EmbedFace) => void;
+    /** Called when a seat is taken in the person's menu; the host decides who sits. */
     readonly onSeat?: (principal: Principal) => void;
 }
-/** The face a stop implies: a stop at altitude opens the Graview. */
+/** The face a stop implies: a stop at altitude opens the Graview, anything else the scene (FR-132). */
 export declare function faceOf(stop: string | undefined): EmbedFace;
+/**
+ * WHETHER AN APP OPENS ON ITS HOME (FR-136): it has a home view — the
+ * declaration's home blocks, or a worker view attached to "home" — and its
+ * declaration names no other first place (`pages.first`).
+ */
+export declare function opensOnTheHome(app: Pick<GraviewApp<AnySchema>, "pages">, views: {
+    homeView?(): unknown;
+}): boolean;
 export declare function Embed<S extends AnySchema>(props: EmbedProps<S>): import("react").JSX.Element;
 export interface EmbedHandle {
     /**
-     * WHERE THE READER IS (FR-116): the face, the page on Pages (or the one it
-     * last had) and the scene's stop — for a host that must remount to hand
-     * back as `mount(…, { at })`.
+     * WHERE THE READER IS (FR-116): the face, the path of the place they are
+     * on — the overview's (`/places/overview`) on the scene (FR-132) — and the
+     * scene's stop, for a host that must remount to hand back as
+     * `mount(…, { at })`.
      */
     where(): EmbedWhere;
     /**
@@ -132,13 +149,25 @@ export interface EmbedHandle {
      * falls back to its nearest parent. The seat, the seats, the people, the
      * scheme, the brand asked for and the notices stay; what is drawn is drawn
      * again, so an open menu, a scroll and a half-typed field do not.
+     *
+     * THE NEW APP'S NAME (FR-128): a `label` that was the app's own name
+     * follows the app, so a renamed app says its new name — the embed's
+     * accessible name, its heading, each landmark inside — without a reload;
+     * a label the host chose stays. `{ label }` says which.
      */
-    setApp(app: GraviewApp<AnySchema>, store: Store<AnySchema> | EmbedRemote<AnySchema>): void;
+    setApp(app: GraviewApp<AnySchema>, store: Store<AnySchema> | EmbedRemote<AnySchema>, options?: {
+        readonly label?: string;
+    }): void;
+    /** What the embed is called (FR-128): its accessible name, its heading, and the name each landmark inside is said after. */
+    setLabel(label: string): void;
+    /** The host's own actions in the profile menu (FR-72), now. */
+    setHostActions(actions: EmbedOptions["hostActions"]): void;
     setFace(face: EmbedFace): void;
     setStop(stop: string): void;
     /**
-     * Sends the routed face to a path within the app's own routes (FR-106): a
-     * host that keeps its own history hands back the path its Back arrived at.
+     * Goes to a path within the app's own routes (FR-106): a host that keeps
+     * its own history hands back the path its Back arrived at. The overview's
+     * path (`/places/overview`) is the scene (FR-132); any other is a page.
      */
     setPath(path: string): void;
     setScheme(scheme: Scheme): void;

package/dist/embed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../src/embed.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../src/embed.tsx"],"names":[],"mappings":"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"}