@sesionario/blocks 1.38.0 → 1.39.0-rc.10

package/README.md

@@ -95,6 +95,55 @@ the server-safe subpath:
 import { avatarFallbackStyle, getInitials } from "@sesionario/blocks/avatar";
 ```
 
+Theme boot for server layouts is also server-safe. Do not import it from the
+main entry:
+
+```tsx
+import {
+	THEME_STORAGE_KEY,
+	htmlThemeClass,
+	themeBootScript,
+	themeColorSchemeCss,
+} from "@sesionario/blocks/theme";
+```
+
+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
+on the bar.
+
+```tsx
+import { NavigationProgress } from "@sesionario/blocks/navigation-progress";
+import { RouteLoading } from "@sesionario/blocks/route-loading";
+```
+
+`RouteLoading` is server-safe. It marks a route shell with `data-route-loading`
+so the bar stays up until that shell unmounts.
+
+Mobile sheet sidebars should close only when the user activates a navigation
+link. Buttons (section toggles, account menus, org switchers) stay open.
+Call the hook while the sheet is open; it listens on `document` so links
+inside portaled menus count, and it closes after the click so navigation
+can start first.
+
+```tsx
+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`