forgebook 0.1.3 → 0.1.4

package/dist/src/shell/strings.d.ts

@@ -27,6 +27,15 @@ declare const shellStrings: {
     related: string;
     view: string;
     viewChanged: string;
+    controlChanged: (control: string) => string;
+    controlKey: (control: string, key: string | undefined) => string;
+    cycleKey: (control: string, key: string) => string;
+    changeKey: string;
+    pressAKey: string;
+    namedViews: string;
+    saveView: string;
+    viewName: string;
+    removeView: (name: string) => string;
     backdrop: string;
     backdropPlain: string;
     sheets: string;
@@ -39,6 +48,21 @@ declare const shellStrings: {
     textScale: (scale: TextScale) => string;
     resetView: string;
     viewInAddress: string;
+    pinControl: (label: string) => string;
+    hideControl: (label: string) => string;
+    showControl: (label: string) => string;
+    moveControl: (label: string) => string;
+    moveControlHint: string;
+    controlMoved: (label: string, position: number, count: number) => string;
+    controlMenu: (label: string) => string;
+    unpinControl: string;
+    hideInView: string;
+    showInView: string;
+    pinnedNoRoom: string;
+    resetToolbar: string;
+    wrapToolbar: string;
+    hiddenControls: (count: number) => string;
+    toolbarInBrowser: string;
     compare: string;
     compareOff: string;
     compareText: string;
@@ -127,6 +151,17 @@ declare const shellStrings: {
     showCode: string;
     hideCode: string;
     openStory: string;
+    usedIn: string;
+    usedInLoading: string;
+    usedInNone: string;
+    usedInThrough: string;
+    usedInMore: (count: number) => string;
+    usedInStories: (count: number) => string;
+    openStoryNamed: (name: string) => string;
+    fillPage: string;
+    fillPageNamed: (name: string) => string;
+    backToPlace: string;
+    backToPlaceNamed: (name: string) => string;
     examples: string;
     pageError: string;
     storyLabel: string;
@@ -156,6 +191,16 @@ declare const shellStrings: {
     setByStory: string;
     required: string;
     resetArgs: string;
+    appearance: string;
+    appearanceOf: (name: string) => string;
+    appearances: {
+        light: string;
+        dark: string;
+        system: string;
+    };
+    worstCase: string;
+    worstCaseHint: string;
+    spills: (count: number) => string;
     events: string;
     calls: string;
     noCalls: string;

package/dist/src/shell/strings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../../src/shell/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE/D,4GAA4G;AAE5G,QAAA,MAAM,YAAY;;;;;;;;wBAQI,MAAM,KAAG,MAAM;;yBAEd,MAAM,KAAG,MAAM;uBACjB,MAAM,KAAG,MAAM;qBACjB,MAAM,KAAG,MAAM;;;;;;;;;;;;;uBAYb,SAAS,KAAG,MAAM;;;;;;;wBAOjB,SAAS,MAAM,EAAE,KAAG,MAAM;0BACxB,SAAS,MAAM,EAAE,KAAG,MAAM;;;qBAG/B,MAAM,KAAG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAmCjB,MAAM,KAAG,MAAM;;;;;;;;;;;;;;;;;;;uBAmBX,MAAM,KAAG,MAAM;;;;;;;;;;sBAUhB,MAAM,KAAG,MAAM;;;;;;;;;;;;;;;4BAeT,MAAM,SAAS,MAAM,KAAG,MAAM;;;8BAG5B,MAAM,WAAW,MAAM,KAAG,MAAM;;;6BAIjC,MAAM,KAAG,MAAM;qBACvB,MAAM,KAAG,MAAM;;uBAEb,MAAM,KAAG,MAAM;2BAEX,MAAM,KAAG,MAAM;;;;;;;;;0BAMhB,MAAM,KAAG,MAAM;;sBAEnB,MAAM,KAAG,MAAM;uBACd,MAAM,KAAG,MAAM;;;;;;;;;uBASf,MAAM,KAAG,MAAM;;;;;;;;CAQnC,CAAC;AAEF,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAE/C,mCAAmC;AACnC,eAAO,MAAM,OAAO,EAAE,YAA2B,CAAC;AA6BlD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,cAAc,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAG,IAEjF,CAAC"}
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../../src/shell/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE/D,4GAA4G;AAE5G,QAAA,MAAM,YAAY;;;;;;;;wBAQI,MAAM,KAAG,MAAM;;yBAEd,MAAM,KAAG,MAAM;uBACjB,MAAM,KAAG,MAAM;qBACjB,MAAM,KAAG,MAAM;;;;8BAIN,MAAM,KAAG,MAAM;0BACnB,MAAM,OAAO,MAAM,GAAG,SAAS,KAAG,MAAM;wBAE1C,MAAM,OAAO,MAAM,KAAG,MAAM;;;;;;uBAO7B,MAAM,KAAG,MAAM;;;;;;;;;;uBASf,SAAS,KAAG,MAAM;;;wBAGjB,MAAM,KAAG,MAAM;yBACd,MAAM,KAAG,MAAM;yBACf,MAAM,KAAG,MAAM;yBACf,MAAM,KAAG,MAAM;;0BAEd,MAAM,YAAY,MAAM,SAAS,MAAM,KAAG,MAAM;yBAEjD,MAAM,KAAG,MAAM;;;;;;;4BAOZ,MAAM,KAAG,MAAM;;;;;;wBAMnB,SAAS,MAAM,EAAE,KAAG,MAAM;0BACxB,SAAS,MAAM,EAAE,KAAG,MAAM;;;qBAG/B,MAAM,KAAG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAmCjB,MAAM,KAAG,MAAM;;;;;;;;;;;;;;;;;;;uBAmBX,MAAM,KAAG,MAAM;;;;;;;;;;sBAUhB,MAAM,KAAG,MAAM;;;;;;;;;;;;;;;;wBAgBb,MAAM,KAAG,MAAM;2BACZ,MAAM,KAAG,MAAM;2BACf,MAAM,KAAG,MAAM;;0BAEhB,MAAM,KAAG,MAAM;;6BAEZ,MAAM,KAAG,MAAM;;;;4BAIhB,MAAM,SAAS,MAAM,KAAG,MAAM;;;8BAG5B,MAAM,WAAW,MAAM,KAAG,MAAM;;;6BAIjC,MAAM,KAAG,MAAM;qBACvB,MAAM,KAAG,MAAM;;uBAEb,MAAM,KAAG,MAAM;2BAEX,MAAM,KAAG,MAAM;;;;;;;;;0BAMhB,MAAM,KAAG,MAAM;;sBAEnB,MAAM,KAAG,MAAM;uBACd,MAAM,KAAG,MAAM;;;;;yBAKb,MAAM,KAAG,MAAM;;;;;;;;oBAKpB,MAAM,KAAG,MAAM;;;;;;uBASZ,MAAM,KAAG,MAAM;;;;;;;;CAQnC,CAAC;AAEF,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAE/C,mCAAmC;AACnC,eAAO,MAAM,OAAO,EAAE,YAA2B,CAAC;AA6BlD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,cAAc,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAG,IAEjF,CAAC"}

package/dist/src/shell/strings.js

@@ -16,6 +16,15 @@ const shellStrings = {
     related: "Related",
     view: "View",
     viewChanged: "A view setting is changed",
+    controlChanged: (control) => `${control}: changed`,
+    controlKey: (control, key) => key === undefined ? `${control}: no key` : `${control}: key ${key.toUpperCase()}`,
+    cycleKey: (control, key) => `${control}: press ${key} for the next value, Shift+${key} for the one before`,
+    changeKey: "Change the key: press it, then the new key; Backspace takes it away",
+    pressAKey: "Press a key",
+    namedViews: "Views",
+    saveView: "Save view…",
+    viewName: "View name",
+    removeView: (name) => `Remove the view ${name}`,
     backdrop: "Background",
     backdropPlain: "Plain",
     sheets: "Styles",
@@ -24,6 +33,21 @@ const shellStrings = {
     textScale: (scale) => `${scale}%`,
     resetView: "Reset to defaults",
     viewInAddress: "Saved in the address",
+    pinControl: (label) => `Pin ${label} to the toolbar`,
+    hideControl: (label) => `Hide ${label} in View`,
+    showControl: (label) => `Show ${label}`,
+    moveControl: (label) => `Move ${label}`,
+    moveControlHint: "Drag, or press the arrow keys",
+    controlMoved: (label, position, count) => `${label}, ${position} of ${count}`,
+    controlMenu: (label) => `${label} on the toolbar`,
+    unpinControl: "Remove from the toolbar",
+    hideInView: "Hide in View",
+    showInView: "Show in View",
+    pinnedNoRoom: "Pinned: back on the toolbar when there is room",
+    resetToolbar: "Reset toolbar",
+    wrapToolbar: "Wrap the toolbar onto more lines when it is full",
+    hiddenControls: (count) => `${count} hidden`,
+    toolbarInBrowser: "The toolbar is kept in this browser",
     compare: "Compare",
     compareOff: "Off",
     compareText: "Text sizes",
@@ -108,6 +132,17 @@ const shellStrings = {
     showCode: "Show code",
     hideCode: "Hide code",
     openStory: "Open the story",
+    usedIn: "Used in",
+    usedInLoading: "Looking for the stories that use it…",
+    usedInNone: "No other component's stories use it.",
+    usedInThrough: "through another component",
+    usedInMore: (count) => `and ${count} more`,
+    usedInStories: (count) => (count === 1 ? "1 story" : `${count} stories`),
+    openStoryNamed: (name) => `Open the story ${name}`,
+    fillPage: "Fill the page",
+    fillPageNamed: (name) => `Fill the page with ${name}`,
+    backToPlace: "Back to its place",
+    backToPlaceNamed: (name) => `Put ${name} back in its place`,
     examples: "Examples",
     pageError: "The component's page could not be read",
     storyLabel: "Story",
@@ -133,6 +168,16 @@ const shellStrings = {
     setByStory: "Set by the story",
     required: "Required",
     resetArgs: "Reset",
+    appearance: "Appearance",
+    appearanceOf: (name) => `Appearance: ${name}`,
+    appearances: { light: "Light", dark: "Dark", system: "System" },
+    worstCase: "Worst case",
+    worstCaseHint: "Long texts with a word too long to break, huge numbers: the elements that spill are outlined",
+    spills: (count) => {
+        if (count === 0)
+            return "Nothing spills";
+        return count === 1 ? "1 element spills" : `${count} elements spill`;
+    },
     events: "Events",
     calls: "Calls",
     noCalls: "No call yet",

package/dist/src/shell/strings.js.map

@@ -1 +1 @@
-{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../../src/shell/strings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../../src/shell/strings.ts"],"names":[],"mappings":"AAaA,4GAA4G;AAC5G,uIAAuI;AACvI,MAAM,YAAY,GAAG;IACnB,iBAAiB,EAAE,QAAQ;IAC3B,WAAW,EAAE,+BAA+B;IAC5C,aAAa,EAAE,YAAY;IAC3B,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EAAE,kBAAkB;IAC/B,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,OAAO,KAAK,UAAU;IAC7D,OAAO,EAAE,sBAAsB;IAC/B,UAAU,EAAE,CAAC,MAAc,EAAU,EAAE,CAAC,MAAM,MAAM,EAAE;IACtD,SAAS,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,YAAY,KAAK,mBAAmB;IAC1E,MAAM,EAAE,CAAC,MAAc,EAAU,EAAE,CAAC,kBAAkB,MAAM,EAAE;IAC9D,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,2BAA2B;IACxC,cAAc,EAAE,CAAC,OAAe,EAAU,EAAE,CAAC,GAAG,OAAO,WAAW;IAClE,UAAU,EAAE,CAAC,OAAe,EAAE,GAAuB,EAAU,EAAE,CAC/D,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,SAAS,GAAG,CAAC,WAAW,EAAE,EAAE;IACnF,QAAQ,EAAE,CAAC,OAAe,EAAE,GAAW,EAAU,EAAE,CACjD,GAAG,OAAO,WAAW,GAAG,8BAA8B,GAAG,qBAAqB;IAChF,SAAS,EAAE,qEAAqE;IAChF,SAAS,EAAE,aAAa;IACxB,UAAU,EAAE,OAAO;IACnB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,mBAAmB,IAAI,EAAE;IAC/D,QAAQ,EAAE,YAAY;IACtB,aAAa,EAAE,OAAO;IACtB,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAG9E;IACD,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,CAAC,KAAgB,EAAU,EAAE,CAAC,GAAG,KAAK,GAAG;IACpD,SAAS,EAAE,mBAAmB;IAC9B,aAAa,EAAE,sBAAsB;IACrC,UAAU,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,OAAO,KAAK,iBAAiB;IACpE,WAAW,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,QAAQ,KAAK,UAAU;IAC/D,WAAW,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,QAAQ,KAAK,EAAE;IACvD,WAAW,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,QAAQ,KAAK,EAAE;IACvD,eAAe,EAAE,+BAA+B;IAChD,YAAY,EAAE,CAAC,KAAa,EAAE,QAAgB,EAAE,KAAa,EAAU,EAAE,CACvE,GAAG,KAAK,KAAK,QAAQ,OAAO,KAAK,EAAE;IACrC,WAAW,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,KAAK,iBAAiB;IACjE,YAAY,EAAE,yBAAyB;IACvC,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,gDAAgD;IAC9D,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,kDAAkD;IAC/D,cAAc,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,KAAK,SAAS;IAC5D,gBAAgB,EAAE,qCAAqC;IACvD,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,YAAY;IACzB,aAAa,EAAE,QAAQ;IACvB,SAAS,EAAE,CAAC,MAAyB,EAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;IACpE,WAAW,EAAE,CAAC,MAAyB,EAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;IACtE,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,KAAK,EAAE;IAC9C,WAAW,EAAE,qBAAqB;IAClC,WAAW,EAAE,kBAAkB;IAC/B,SAAS,EAAE,yBAAyB;IACpC,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE,aAAa;IACzB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,cAAc;IACzB,UAAU,EAAE,0BAA0B;IACtC,KAAK,EAAE;QACL,OAAO,EAAE,uBAAuB;QAChC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,uCAAuC;KACjD;IACD,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,4DAA4D;IAC7E,YAAY,EAAE,cAAc;IAC5B,gBAAgB,EAAE,6DAA6D;IAC/E,aAAa,EAAE,uCAAuC;IACtD,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,cAAc;IAC3B,UAAU,EAAE,iBAAiB;IAC7B,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,eAAe;KACtB;IACD,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IACtE,QAAQ,EAAE,CAAC,EAAU,EAAU,EAAE,CAAC,GAAG,EAAE,KAAK;IAC5C,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,+EAA+E;IAC5F,aAAa,EAAE,4FAA4F;IAC3G,QAAQ,EAAE,OAAO;IACjB,SAAS,EAAE,mBAAmB;IAC9B,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,eAAe;IAC7B,UAAU,EAAE,oBAAoB;IAChC,SAAS,EAAE,oCAAoC;IAC/C,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,GAAG;IACf,aAAa,EAAE,gBAAgB;IAC/B,IAAI,EAAE,eAAe;IACrB,SAAS,EAAE,iBAAiB;IAC5B,WAAW,EAAE,WAAW;IACxB,UAAU,EAAE,QAAQ;IACpB,SAAS,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE;IACxF,QAAQ,EAAE,+DAA+D;IACzE,SAAS,EAAE,yBAAyB;IACpC,gBAAgB,EAAE,gDAAgD;IAClE,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE,iBAAiB;IAC7B,WAAW,EAAE,kBAAkB;IAC/B,YAAY,EAAE,SAAS;IACvB,UAAU,EAAE,aAAa;IACzB,SAAS,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,IAAI,EAAE;IAC/C,YAAY,EAAE,oBAAoB;IAClC,YAAY,EAAE,eAAe;IAC7B,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,MAAM;IACf,YAAY,EAAE,WAAW;IACzB,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,SAAS;IACjB,aAAa,EAAE,sCAAsC;IACrD,UAAU,EAAE,sCAAsC;IAClD,aAAa,EAAE,2BAA2B;IAC1C,UAAU,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,OAAO,KAAK,OAAO;IAC1D,aAAa,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,CAAC;IACxF,cAAc,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,kBAAkB,IAAI,EAAE;IAClE,QAAQ,EAAE,eAAe;IACzB,aAAa,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,sBAAsB,IAAI,EAAE;IACrE,WAAW,EAAE,mBAAmB;IAChC,gBAAgB,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,OAAO,IAAI,oBAAoB;IAC3E,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,wCAAwC;IACnD,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,CAAC,SAAiB,EAAE,KAAa,EAAU,EAAE,CAAC,GAAG,SAAS,KAAK,KAAK,EAAE;IAClF,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,oEAAoE;IAC/E,WAAW,EAAE,CAAC,UAAkB,EAAE,OAAe,EAAU,EAAE,CAC3D,GAAG,UAAU,IAAI,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,OAAO,OAAO,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,GAAG;IAC5H,cAAc,EAAE,8CAA8C;IAC9D,cAAc,EAAE,iBAAiB;IACjC,eAAe,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,EAAE;IAClG,OAAO,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,YAAY,KAAK,EAAE;IACvD,SAAS,EAAE,YAAY;IACvB,YAAY,EAAE,CAAC,EAAU,EAAU,EAAE,CACnC,aAAa,EAAE,uDAAuD;IACxE,gBAAgB,EAAE,CAAC,EAAU,EAAU,EAAE,CACvC,iBAAiB,EAAE,uDAAuD;IAC5E,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,SAAS,EAAE;IAC9E,UAAU,EAAE,aAAa;IACzB,KAAK,EAAE,GAAG;IACV,YAAY,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,KAAK,GAAG;IACvD,SAAS,EAAE,UAAU;IACrB,SAAS,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,GAAG,IAAI,iBAAiB;IAC7D,UAAU,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,GAAG,IAAI,SAAS;IACtD,UAAU,EAAE,kBAAkB;IAC9B,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,OAAO;IAClB,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,eAAe,IAAI,EAAE;IAC7D,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC/D,SAAS,EAAE,YAAY;IACvB,aAAa,EACX,8FAA8F;IAChG,MAAM,EAAE,CAAC,KAAa,EAAU,EAAE;QAChC,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,gBAAgB,CAAC;QACzC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,KAAK,iBAAiB,CAAC;IACtE,CAAC;IACD,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,OAAO;IACnB,KAAK,EAAE,mBAAmB;IAC1B,SAAS,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE;IAClF,SAAS,EAAE,OAAO;IAClB,UAAU,EAAE,oBAAoB;IAChC,OAAO,EAAE,UAAU;IACnB,OAAO,EAAE,wBAAwB;IACjC,WAAW,EAAE,wBAAwB;IACrC,SAAS,EAAE,iCAAiC;IAC5C,aAAa,EAAE,sCAAsC;CACtD,CAAC;AAKF,mCAAmC;AACnC,MAAM,CAAC,MAAM,OAAO,GAAiB,YAAY,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,KAAc,EAAoC,EAAE,CACvE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,WAAW,GAAG,CAAC,KAA8B,EAAE,IAAuB,EAAE,IAAY,EAAQ,EAAE;IAClG,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACpD,OAAO;IACT,CAAC;IACD,IAAI,WAAW,CAAC,OAAO,CAAC;QAAE,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,YAA8C,EAAQ,EAAE;IACvF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;QAAE,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AACvG,CAAC,CAAC"}

package/dist/src/shell/useAppearance.d.ts

@@ -0,0 +1,17 @@
+import { type Appearance } from "../catalogue.ts";
+/** The root's attribute the palettes read: `light` or `dark`, the system's resolved. */
+export declare const APPEARANCE_ATTRIBUTE = "data-forgebook-appearance";
+/** The shell's appearance and its setter. */
+export type AppearanceState = {
+    /** The appearance shown: the reader's, or the catalogue's default. */
+    readonly appearance: Appearance;
+    /** Picks an appearance, kept for the next visit. */
+    readonly setAppearance: (appearance: Appearance) => void;
+};
+/**
+ * The shell's appearance, applied to the page's root.
+ *
+ * @returns the appearance shown and its setter.
+ */
+export declare const useAppearance: () => AppearanceState;
+//# sourceMappingURL=useAppearance.d.ts.map

package/dist/src/shell/useAppearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppearance.d.ts","sourceRoot":"","sources":["../../../src/shell/useAppearance.ts"],"names":[],"mappings":"AAYA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK/D,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAMhE,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,oDAAoD;IACpD,QAAQ,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAO,eAUhC,CAAC"}

package/dist/src/shell/useAppearance.js

@@ -0,0 +1,36 @@
+/**
+ * The shell's own appearance: light, dark or the system's, a reader's choice kept in their browser, the catalogue's
+ * default before they pick one; written on the page's root, where the palettes of `shell.scss` read it.
+ *
+ * @remarks
+ * Only the reader's own choice is stored: a reader who never picked follows the catalogue's default even after the
+ * catalogue changes it. The frames are not touched: a story's look is the view's switches'.
+ *
+ * @module
+ */
+import { useEffect } from "react";
+import { APPEARANCES } from "../catalogue.js";
+import { useCatalogue } from "./catalogueContext.js";
+import { useStored } from "./useStored.js";
+import { useSystemDark } from "./useSystemDark.js";
+/** The root's attribute the palettes read: `light` or `dark`, the system's resolved. */
+export const APPEARANCE_ATTRIBUTE = "data-forgebook-appearance";
+/** The appearance a stored text holds; none when the reader never picked one. */
+const storedAppearance = (stored) => APPEARANCES.find((appearance) => appearance === stored);
+/**
+ * The shell's appearance, applied to the page's root.
+ *
+ * @returns the appearance shown and its setter.
+ */
+export const useAppearance = () => {
+    const catalogue = useCatalogue();
+    const [chosen, setChosen] = useStored("appearance", storedAppearance, (value) => value ?? "");
+    const appearance = chosen ?? catalogue.appearance;
+    const isSystemDark = useSystemDark();
+    const isDark = appearance === "dark" || (appearance === "system" && isSystemDark);
+    useEffect(() => {
+        document.documentElement.setAttribute(APPEARANCE_ATTRIBUTE, isDark ? "dark" : "light");
+    }, [isDark]);
+    return { appearance, setAppearance: setChosen };
+};
+//# sourceMappingURL=useAppearance.js.map

package/dist/src/shell/useAppearance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppearance.js","sourceRoot":"","sources":["../../../src/shell/useAppearance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAEhE,iFAAiF;AACjF,MAAM,gBAAgB,GAAG,CAAC,MAAqB,EAA0B,EAAE,CACzE,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC;AAU1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAoB,EAAE;IACjD,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC9F,MAAM,UAAU,GAAG,MAAM,IAAI,SAAS,CAAC,UAAU,CAAC;IAClD,MAAM,YAAY,GAAG,aAAa,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,UAAU,KAAK,MAAM,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,YAAY,CAAC,CAAC;IAClF,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACb,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAClD,CAAC,CAAC"}

package/dist/src/shell/useControlKeys.d.ts

@@ -0,0 +1,23 @@
+import { type ControlKeys } from "../controlKeys.ts";
+import type { FixedView } from "../storyGlobals.ts";
+import type { ViewState } from "../viewState.ts";
+/** What the keys read and change. */
+export type ControlKeysInput = {
+    /** The keys in use. */
+    readonly keys: ControlKeys;
+    /** The view shown. */
+    readonly view: ViewState;
+    /** Called with the changed view. */
+    readonly onViewChange: (view: ViewState) => void;
+    /** What the shown story fixes of the view. */
+    readonly fixed: FixedView;
+    /** Whether a story's page is shown. */
+    readonly isStoryPage: boolean;
+};
+/**
+ * Listens to the controls' keys.
+ *
+ * @param input - the keys, the view and its setter, what the story fixes and the page shown.
+ */
+export declare const useControlKeys: (input: ControlKeysInput) => void;
+//# sourceMappingURL=useControlKeys.d.ts.map

package/dist/src/shell/useControlKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControlKeys.d.ts","sourceRoot":"","sources":["../../../src/shell/useControlKeys.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACjD,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,gBAAgB,KAAG,IAuBxD,CAAC"}

package/dist/src/shell/useControlKeys.js

@@ -0,0 +1,44 @@
+/**
+ * Listens to the keys that cycle the toolbar's controls: a control's key moves it to its next value (Shift to the
+ * one before), anywhere in the shell but while typing.
+ *
+ * @module
+ */
+import { useEffect, useRef } from "react";
+import { pressedControl } from "../controlKeys.js";
+import { useCatalogue } from "./catalogueContext.js";
+import { cycledView } from "./controlCycle.js";
+import { isTyping } from "./keyboard.js";
+/**
+ * Listens to the controls' keys.
+ *
+ * @param input - the keys, the view and its setter, what the story fixes and the page shown.
+ */
+export const useControlKeys = (input) => {
+    const catalogue = useCatalogue();
+    // the latest view and keys, without listening again on every render
+    const latest = useRef(input);
+    latest.current = input;
+    useEffect(() => {
+        const cycle = (event) => {
+            if (isTyping(event.target))
+                return;
+            const { keys, view, onViewChange, fixed, isStoryPage } = latest.current;
+            const pressed = pressedControl(keys, {
+                key: event.key,
+                shiftKey: event.shiftKey,
+                hasModifier: event.metaKey || event.ctrlKey || event.altKey
+            });
+            if (pressed === undefined)
+                return;
+            const changed = cycledView(view, pressed.id, pressed.step, catalogue, fixed, isStoryPage);
+            if (changed === undefined)
+                return;
+            event.preventDefault();
+            onViewChange(changed);
+        };
+        document.addEventListener("keydown", cycle);
+        return () => document.removeEventListener("keydown", cycle);
+    }, [catalogue]);
+};
+//# sourceMappingURL=useControlKeys.js.map

package/dist/src/shell/useControlKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControlKeys.js","sourceRoot":"","sources":["../../../src/shell/useControlKeys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAoB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAgBzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAuB,EAAQ,EAAE;IAC9D,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,oEAAoE;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,CAAC,KAAoB,EAAQ,EAAE;YAC3C,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;gBAAE,OAAO;YACnC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;YACxE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE;gBACnC,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,WAAW,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM;aAC5D,CAAC,CAAC;YACH,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO;YAClC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YAC1F,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO;YAClC,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC5C,OAAO,GAAS,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC"}

package/dist/src/shell/useFold.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A part that folds open and shut animated (a sidebar family's components): its height grows from nothing to its
+ * content's and back, and it stays drawn until its closing has played.
+ *
+ * @remarks
+ * A fold changed again while it moves starts from the height it has then, so a quick open and close never jumps. A
+ * fold that must not move (a search opening every family it finds something in, a reduced-motion preference) opens
+ * and shuts at once.
+ *
+ * @module
+ */
+import { type RefObject } from "react";
+/** What a folding part wires to its element. */
+export type Fold = {
+    /** Whether its content is drawn: open, or still shutting. */
+    readonly isDrawn: boolean;
+    /** The element whose height moves. */
+    readonly ref: RefObject<HTMLDivElement | null>;
+};
+/**
+ * A part that folds open and shut.
+ *
+ * @param isOpen - whether it is open.
+ * @param isInstant - whether it opens and shuts at once this time.
+ */
+export declare const useFold: (isOpen: boolean, isInstant: boolean) => Fold;
+//# sourceMappingURL=useFold.d.ts.map

package/dist/src/shell/useFold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFold.d.ts","sourceRoot":"","sources":["../../../src/shell/useFold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,SAAS,EAAqC,MAAM,OAAO,CAAC;AAQ1E,gDAAgD;AAChD,MAAM,MAAM,IAAI,GAAG;IACjB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAChD,CAAC;AA+BF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,OAAO,EAAE,WAAW,OAAO,KAAG,IAoC7D,CAAC"}

package/dist/src/shell/useFold.js

@@ -0,0 +1,87 @@
+/**
+ * A part that folds open and shut animated (a sidebar family's components): its height grows from nothing to its
+ * content's and back, and it stays drawn until its closing has played.
+ *
+ * @remarks
+ * A fold changed again while it moves starts from the height it has then, so a quick open and close never jumps. A
+ * fold that must not move (a search opening every family it finds something in, a reduced-motion preference) opens
+ * and shuts at once.
+ *
+ * @module
+ */
+import { useLayoutEffect, useRef, useState } from "react";
+/** How long a fold takes to open, in ms. */
+const OPEN_MS = 200;
+/** How long it takes to shut, in ms: shorter, as a thing going away. */
+const SHUT_MS = 160;
+/**
+ * The height a fold starts its move from: the height a running move left it at, else shut or its content's.
+ *
+ * @param element - the folding element.
+ * @param isMoving - whether a move is running.
+ * @param isOpening - whether it opens.
+ */
+const startHeight = (element, isMoving, isOpening) => {
+    if (isMoving)
+        return element.offsetHeight;
+    return isOpening ? 0 : element.scrollHeight;
+};
+/**
+ * Moves a fold's height to open or shut, clipped while it moves so its items' focus rings show the rest of the time.
+ *
+ * @param element - the folding element.
+ * @param from - the height it starts from, in CSS px.
+ * @param isOpening - whether it opens.
+ */
+const moveFold = (element, from, isOpening) => {
+    element.style.overflow = "hidden";
+    return element.animate([{ height: `${from}px` }, { height: `${isOpening ? element.scrollHeight : 0}px` }], isOpening
+        ? { duration: OPEN_MS, easing: "cubic-bezier(0.22, 1, 0.36, 1)" }
+        : { duration: SHUT_MS, easing: "cubic-bezier(0.4, 0, 1, 1)" });
+};
+/**
+ * A part that folds open and shut.
+ *
+ * @param isOpen - whether it is open.
+ * @param isInstant - whether it opens and shuts at once this time.
+ */
+export const useFold = (isOpen, isInstant) => {
+    const ref = useRef(null);
+    const [isDrawn, setIsDrawn] = useState(isOpen);
+    const running = useRef(undefined);
+    const isFirst = useRef(true);
+    // an opening part is drawn at once, so its content can be measured as it grows
+    if (isOpen && !isDrawn)
+        setIsDrawn(true);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: it moves when it opens or shuts, not when told how
+    useLayoutEffect(() => {
+        const element = ref.current;
+        if (isFirst.current || element === null) {
+            isFirst.current = false;
+            return;
+        }
+        const from = startHeight(element, running.current !== undefined, isOpen);
+        running.current?.cancel();
+        running.current = undefined;
+        if (isInstant || window.matchMedia("(prefers-reduced-motion: reduce)").matches) {
+            if (!isOpen)
+                setIsDrawn(false);
+            return;
+        }
+        const animation = moveFold(element, from, isOpen);
+        running.current = animation;
+        animation.finished
+            .then(() => {
+            if (running.current !== animation)
+                return;
+            running.current = undefined;
+            element.style.overflow = "";
+            if (!isOpen)
+                setIsDrawn(false);
+        })
+            // a move cancelled by the next one leaves the rest to it
+            .catch(() => undefined);
+    }, [isOpen]);
+    return { isDrawn, ref };
+};
+//# sourceMappingURL=useFold.js.map

package/dist/src/shell/useFold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFold.js","sourceRoot":"","sources":["../../../src/shell/useFold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAkB,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE1E,4CAA4C;AAC5C,MAAM,OAAO,GAAG,GAAG,CAAC;AAEpB,wEAAwE;AACxE,MAAM,OAAO,GAAG,GAAG,CAAC;AAUpB;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAAC,OAAoB,EAAE,QAAiB,EAAE,SAAkB,EAAU,EAAE;IAC1F,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,YAAY,CAAC;IAC1C,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;AAC9C,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,CAAC,OAAoB,EAAE,IAAY,EAAE,SAAkB,EAAa,EAAE;IACrF,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAClC,OAAO,OAAO,CAAC,OAAO,CACpB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAClF,SAAS;QACP,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,gCAAgC,EAAE;QACjE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAChE,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAe,EAAE,SAAkB,EAAQ,EAAE;IACnE,MAAM,GAAG,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAwB,SAAS,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,+EAA+E;IAC/E,IAAI,MAAM,IAAI,CAAC,OAAO;QAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAEzC,8GAA8G;IAC9G,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;YACxB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,MAAM,CAAC,CAAC;QACzE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;QAC5B,IAAI,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/E,IAAI,CAAC,MAAM;gBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;QAC5B,SAAS,CAAC,QAAQ;aACf,IAAI,CAAC,GAAG,EAAE;YACT,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;gBAAE,OAAO;YAC1C,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM;gBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC;YACF,yDAAyD;aACxD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAC1B,CAAC,CAAC"}

package/dist/src/shell/useFrameMessages.d.ts

@@ -35,6 +35,8 @@ export type FrameHandlers = {
     readonly onPlay?: (storyId: string, trace: PlayTrace) => void;
     /** An accessibility check is over: the rules broken, or why it could not run; none where nothing asks for one. */
     readonly onChecked?: (result: CheckResult) => void;
+    /** A frame measured its spills again (while the stage asks for them); none where nothing shows them. */
+    readonly onSpills?: (storyId: string, count: number) => void;
 };
 /** An accessibility check's result, as a frame reported it. */
 export type CheckResult = {

package/dist/src/shell/useFrameMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFrameMessages.d.ts","sourceRoot":"","sources":["../../../src/shell/useFrameMessages.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAAC;AAE9E,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,EAAE,MAAM,CAAC,GAAG;IACxF,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qCAAqC;AACrC,MAAM,MAAM,YAAY,GAAG;IACzB,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,uGAAuG;IACvG,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC1B,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACjE,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC9D,kHAAkH;IAClH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAsEzD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,aAAa,KAAG,YA2B1D,CAAC"}
+{"version":3,"file":"useFrameMessages.d.ts","sourceRoot":"","sources":["../../../src/shell/useFrameMessages.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAAC;AAE9E,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,EAAE,MAAM,CAAC,GAAG;IACxF,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qCAAqC;AACrC,MAAM,MAAM,YAAY,GAAG;IACzB,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,uGAAuG;IACvG,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC1B,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACjE,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC9D,kHAAkH;IAClH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACnD,wGAAwG;IACxG,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAyEzD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,aAAa,KAAG,YA2B1D,CAAC"}

package/dist/src/shell/useFrameMessages.js

@@ -43,6 +43,9 @@ const onFrameMessage = (message, frame, targets) => {
         case "forgebook:check-error":
             handlers.onChecked?.({ storyId: message.storyId, error: message.message });
             return;
+        case "forgebook:spills":
+            handlers.onSpills?.(message.storyId, message.count);
+            return;
         case "forgebook:call":
             handlers.onCall({
                 storyId: message.storyId,

package/dist/src/shell/useFrameMessages.js.map

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

package/dist/src/shell/useFullPage.d.ts

@@ -0,0 +1,45 @@
+/**
+ * An example's box opened to fill the page, over it, without leaving it: the box grows from where it sits to the
+ * page's size and shrinks back into its place, animated; Escape, a press on the shade or its button brings it back.
+ *
+ * @remarks
+ * The box is never moved in the page: an iframe moved to another parent loads again, and the story would lose its
+ * state. It is drawn fixed over the page instead, and a slot of its height keeps its place in the list, so nothing
+ * under it moves. Its size and place are animated (not scaled), so the story lays itself out at each size as it would
+ * in a window being resized. A reduced-motion preference opens and closes it at once. The address does not remember
+ * it: it is a moment's look, not a page.
+ *
+ * @module
+ */
+import { type RefObject } from "react";
+/** What an example wires to its box, its slot and its shade. */
+export type FullPage = {
+    /** Whether the box fills the page: what its button's state and a press on it read. */
+    readonly isFull: boolean;
+    /** Whether it is drawn over the page: filling it, or still going back to its place. */
+    readonly isOver: boolean;
+    /** The height the slot keeps in the list while the box is over the page, in CSS px. */
+    readonly slotHeight: number;
+    /** The box. */
+    readonly boxRef: RefObject<HTMLDivElement | null>;
+    /** The slot that keeps the box's place. */
+    readonly slotRef: RefObject<HTMLDivElement | null>;
+    /** The shade under the box. */
+    readonly shadeRef: RefObject<HTMLDivElement | null>;
+    /** The box's stage, whose room the story fills while the box is over the page. */
+    readonly stageRef: RefObject<HTMLDivElement | null>;
+    /** The stage's height while the box is over the page, in CSS px: the story is drawn at least this tall. */
+    readonly stageHeight: number | undefined;
+    /**
+     * Opens the box to fill the page, or brings it back.
+     *
+     * @param press - the press that asked, when one did: a press by the pointer (`detail` above 0) leaves no focus ring
+     *   on the button when Escape closes the box later.
+     */
+    readonly toggle: (press?: {
+        readonly detail: number;
+    }) => void;
+};
+/** An example's box opened to fill the page. */
+export declare const useFullPage: () => FullPage;
+//# sourceMappingURL=useFullPage.d.ts.map

package/dist/src/shell/useFullPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFullPage.d.ts","sourceRoot":"","sources":["../../../src/shell/useFullPage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,KAAK,SAAS,EAAgD,MAAM,OAAO,CAAC;AAWrF,gEAAgE;AAChE,MAAM,MAAM,QAAQ,GAAG;IACrB,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,eAAe;IACf,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAClD,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACnD,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACpD,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACpD,2GAA2G;IAC3G,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAChE,CAAC;AAaF,gDAAgD;AAChD,eAAO,MAAM,WAAW,QAAO,QAyH9B,CAAC"}