@luigisbox/luma 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -5,6 +5,13 @@ before 1.0, a minor version may break the integration API.
 
 ## Unreleased
 
+## 0.7.1 — 2026-11-02
+
+### Fixed
+
+- iOS Safari: swiping Back from a product to a listing showed a blank page
+  for a moment; the swipe now shows the listing.
+
 ## 0.7.0 — 2026-10-29
 
 ### Added

package/README.md

@@ -12,7 +12,7 @@ its own repository and depends on `@luigisbox/luma`
 
 > **Pre-release.** Until 1.0, a minor version (0.8.0) may change the
 > integration API (config keys, template scope, the build); a patch version
-> (0.7.1) only fixes. Depend on `^0.7.0` to take fixes without breaking
+> (0.7.2) only fixes. Depend on `^0.7.1` to take fixes without breaking
 > changes. [`CHANGELOG.md`](CHANGELOG.md) says what each version changed.
 
 ## Core principles
@@ -474,7 +474,7 @@ built as on.
 | `search.prefetchWhileTyping` | the search result is fetched once the typed phrase settles, so Enter shows it at once | |
 | `search.pageWhileTyping` (`'prefetch'`, `'prerender'`, `false`) | the search page of the typed phrase is fetched ahead (Chrome, Edge; Firefox and Safari as they ship it), so Enter from another page skips the site's server render; `'prerender'` renders it ahead as well (Chrome, Edge) | the site cannot take a document request per typed phrase; `'prerender'` only where its tags wait for `prerenderingchange` |
 | `search.queryUrl` (an `_init.ts` hook, off unless set) | where the site's server redirects its search form to the query's page (`/search?q=x` to `/search/x/`), names that page: Enter, the autocomplete's "show all" and a picked query load it directly, without the redirect, and the result fetched while typing is shown there | the form's other fields decide the page, or the site must handle every search itself |
-| `restoreOnBack` | Back from a product restores the listing (every page shown) and the followed tile's position, as does the page loaded again within a minute of following a link (a reload, a link whose server redirects back to it); Luma turns the browser's own scroll restoration (`history.scrollRestoration`) off for the listing's history entry until it has placed the page, unless the site set it | |
+| `restoreOnBack` | Back from a product restores the listing (every page shown) and the followed tile's position, as does the page loaded again within a minute of following a link (a reload, a link whose server redirects back to it); Luma turns the browser's own scroll restoration (`history.scrollRestoration`) off for the listing's history entry until it has placed the page (not while the page is in the browser's back/forward cache, which restores it from memory), unless the site set it | |
 | `prefetchNextPage` | "show more" is fetched as the shopper nears the end | |
 | `contentVisibility` (opt-in) | tiles out of view skip style, layout and paint, each at its own measured size: a long list's re-render about halves | keep it off where a tile draws outside its box (a hover panel, a badge hanging out) or holds a `position: fixed` element |
 | `variants: { fields }` (opt-in) | each tile's result gets its variant group (`r.variants`, "Templates" above): one request to Luigi's Box per page of results, never waited for | the surface does not collapse variants (every group is a group of one) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luigisbox/luma",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "type": "module",
   "description": "Luma: Luigi's Box frontend integrations (autocomplete, search, category listings, recommenders) on the Luigi's Box AI API. Pre-release.",
   "license": "SEE LICENSE IN LICENSE.md",

package/src/widgets/listing/element.ts

@@ -403,7 +403,7 @@ export const startListing = async (ctx: WidgetContext<ListingConfig>, tk: Takeov
     private hiddenAt = 0;
     /** scrollY when a Back stash was last written (leave()): the page hidden from there is stashed already. */
     private leftAt = -1;
-    private onPageHide = () => {
+    private onPageHide = (e: PageTransitionEvent) => {
       this.hiddenAt = Date.now();
       // Left with more than the first page shown, not by a link of ours (a
       // reload, their menu, the address bar): stashed too, so a reload within
@@ -412,6 +412,8 @@ export const startListing = async (ctx: WidgetContext<ListingConfig>, tk: Takeov
       // shorter than where the shopper was). Into the back/forward cache
       // too: it may be evicted there (then Back is a page load).
       if (restoreOn && (this.last?.page ?? 0) > 1 && this.leftAt !== Math.round(scrollY)) this.leave();
+      // Into the back/forward cache: the browser's restoration on again (instant.ts `holdScroll`).
+      if (e.persisted) releaseScroll();
     };
     /**
      * Restored from the back/forward cache (pageshow, persisted): the page is as
@@ -424,14 +426,13 @@ export const startListing = async (ctx: WidgetContext<ListingConfig>, tk: Takeov
      */
     private onPageShow = (e: PageTransitionEvent) => {
       if (!e.persisted) return;
-      // Where the shopper was: the browser's own restoration is off for the
-      // entry (holdScroll), and iOS Safari reads scrollY 0 at this event
-      // even when it restores it. Placed again, then the browser's back on.
+      // Where the shopper was: iOS Safari reads scrollY 0 at this event even
+      // when it restores it. Placed again (the browser's restoration is on
+      // again since pagehide, a host's own setting kept).
       const st = peekStash(location.href);
       dropStash(location.href);
       mark(`${route.id} restored from the back/forward cache`);
-      if (st?.kind === 'back' && st.scroll && tk.state === 'ours') restoreScroll(this, st.scroll, releaseScroll);
-      else releaseScroll();
+      if (st?.kind === 'back' && st.scroll && tk.state === 'ours') restoreScroll(this, st.scroll);
       const away = this.hiddenAt ? Date.now() - this.hiddenAt : 0;
       if (away > BFCACHE_STALE_MS && this.last && this.lastQ && this.lastQ === this.current) this.revalidate(this.lastQ, this.last, new URL(location.href), this.href);
     };

package/src/widgets/listing/instant.ts

@@ -106,8 +106,10 @@ export const restoreScroll = (root: Element, s: Spot, after?: () => void) => {
  * after its render. The browser's restoration ran before it, on a page not
  * grown to the stashed pages yet, and could land after Luma's place too.
  * Only from `auto`: a host that set it (Turbo, a router) keeps its own.
- * Back on (`releaseScroll`) once Luma has placed the page, or when the
- * document moves on within itself (an SPA's navigation: theirs to restore).
+ * Back on (`releaseScroll`) once Luma has placed the page, when the
+ * document moves on within itself (an SPA's navigation: theirs to restore),
+ * or as the page goes into the back/forward cache (restored from memory:
+ * iOS Safari's swipe Back shows the page behind only with it on).
  */
 let ownScroll = false;
 /** Off for this entry, when it is the browser's (or already ours): 1, for the stash's `sr`. */
@@ -121,8 +123,16 @@ export const holdScroll = (): 1 | undefined => {
     return undefined;
   }
 };
-/** A page loaded on an entry Luma turned it off for (the stash's `sr`): Luma's to turn back on. */
-export const adoptScroll = () => void (ownScroll = true);
+/**
+ * A page loaded on an entry Luma turned it off for (the stash's `sr`): Luma's
+ * to turn back on. Off again where it was turned on as the page went into
+ * the back/forward cache (the page evicted from it since): the browser's
+ * restoration stops here, Luma places the page.
+ */
+export const adoptScroll = () => {
+  ownScroll = true;
+  holdScroll();
+};
 /** Back to the browser's, if Luma turned it off. */
 export const releaseScroll = () => {
   if (!ownScroll) return;