@sesionario/blocks 1.39.0 → 1.40.0

package/README.md

@@ -101,12 +101,21 @@ main entry:
 ```tsx
 import {
 	THEME_STORAGE_KEY,
+	brandAppleWebApp,
+	brandIcons,
+	brandViewport,
 	htmlThemeClass,
 	themeBootScript,
 	themeColorSchemeCss,
 } from "@sesionario/blocks/theme";
+import { ThemeChrome } from "@sesionario/blocks/theme-chrome";
 ```
 
+`brandViewport` is the document `viewport` export (`theme-color` follows the page
+background). `ThemeChrome` is client-only: mount it inside `next-themes` and pass
+the light and dark icon URLs. An explicit light or dark choice overrides the OS
+media queries; `system` leaves them in place.
+
 The top progress bar is a separate client subpath so `loading.tsx` does not
 pull the main barrel. It does not import Next.js: pass `pathname` and
 `search`, and wrap `useSearchParams` in `<Suspense>`. Keyframes are inlined
@@ -132,6 +141,18 @@ import { useDismissSidebarOnLink } from "@sesionario/blocks/sidebar-dismiss";
 useDismissSidebarOnLink(isMobile && openMobile, () => setOpenMobile(false));
 ```
 
+Scroll restoration lives on the main client entry. Pass a route key from the
+app (`pathname` + search). Fresh navigations start at the top; back and
+forward restore the offset of the port that actually moved (the window, or
+a nested overflow pane registered with `useRegisterScrollContainer`).
+
+```tsx
+import {
+	ScrollRestorationProvider,
+	useRegisterScrollContainer,
+} from "@sesionario/blocks";
+```
+
 Peer dependencies (install in the consuming app as needed):
 
 - `react`, `react-dom`