@streamscloud/kit 0.70.0 → 0.72.0

package/dist/ui/infinite-scroll/cmp.infinite-scroll.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">import { Button } from '../button';
 import { Spinner } from '../spinner';
 import { InfiniteScrollLocalization } from './infinite-scroll-localization';
-let { loadMore, container = null, rootMargin = '200px', children, loading, retry } = $props();
+let { loadMore, container = null, rootMargin = '200px', children, showLoading = false, loading, retry } = $props();
 const localization = new InfiniteScrollLocalization();
 const source = $derived(typeof loadMore === 'function' ? { loadMore, failed: false, canLoadMore: true } : loadMore);
 let isLoading = $state(false);
@@ -61,7 +61,7 @@ const onRetry = () => {
   {#if isLoading}
     {#if loading}
       {@render loading()}
-    {:else}
+    {:else if showLoading}
       <div class="infinite-scroll__loading-container">
         <Spinner timeout={500} />
       </div>
@@ -79,7 +79,7 @@ const onRetry = () => {
 
 <!--
 @component
-Triggers an async `loadMore` callback when a sentinel element scrolls into view, using IntersectionObserver. Re-observes the sentinel on container resize so layout shifts inside the parent re-evaluate visibility (a known IntersectionObserver gotcha). Internal `isLoading` guard prevents overlapping fires while a load is in flight.
+Triggers an async `loadMore` callback when a sentinel element scrolls into view, using IntersectionObserver. Re-observes the sentinel on container resize so layout shifts inside the parent re-evaluate visibility (a known IntersectionObserver gotcha). Internal `isLoading` guard prevents overlapping fires while a load is in flight. No loading indicator by default — opt in with `showLoading` or a `loading` snippet.
 
 Pairs with `core/data-loaders` (`CursorDataLoader`, `PageDataLoader`, `CursorDataLoaderWithSearch`) — wire `loadMore={loader.loadMore}` and `{#each loader.items as item}` directly.
 

package/dist/ui/infinite-scroll/cmp.infinite-scroll.svelte.d.ts

@@ -16,13 +16,15 @@ type Props = {
     /** IntersectionObserver `rootMargin`. Default `'200px'` — fires the load a viewport-screen before reaching the bottom. */
     rootMargin?: string;
     children: Snippet;
-    /** Custom loading indicator snippet. Defaults to the kit `Spinner`. */
+    /** Shows the kit `Spinner` while a batch loads. Off by default — the list owner usually renders its own loading state. */
+    showLoading?: boolean;
+    /** Custom loading indicator snippet. Passing it turns the indicator on regardless of `showLoading`. */
     loading?: Snippet;
     /** Manual continue shown while `failed`, taking the callback that retries the failed page. Defaults to a kit `Button`. */
     retry?: Snippet<[() => void]>;
 };
 /**
- * Triggers an async `loadMore` callback when a sentinel element scrolls into view, using IntersectionObserver. Re-observes the sentinel on container resize so layout shifts inside the parent re-evaluate visibility (a known IntersectionObserver gotcha). Internal `isLoading` guard prevents overlapping fires while a load is in flight.
+ * Triggers an async `loadMore` callback when a sentinel element scrolls into view, using IntersectionObserver. Re-observes the sentinel on container resize so layout shifts inside the parent re-evaluate visibility (a known IntersectionObserver gotcha). Internal `isLoading` guard prevents overlapping fires while a load is in flight. No loading indicator by default — opt in with `showLoading` or a `loading` snippet.
  *
  * Pairs with `core/data-loaders` (`CursorDataLoader`, `PageDataLoader`, `CursorDataLoaderWithSearch`) — wire `loadMore={loader.loadMore}` and `{#each loader.items as item}` directly.
  *

package/dist/ui/page-layout/cmp.page-layout.svelte

@@ -1,13 +1,16 @@
-<script lang="ts">import LayoutControlButton from './layout-control-button.svelte';
+<script lang="ts">import { Spinner } from '../spinner';
+import LayoutControlButton from './layout-control-button.svelte';
 import { PageLayoutLocalization } from './page-layout-localization';
+import { resolvePageLoading } from './page-loading';
 import IconDismiss from '@fluentui/svg-icons/icons/dismiss_20_regular.svg?raw';
 import IconWindow from '@fluentui/svg-icons/icons/window_20_regular.svg?raw';
 import IconWindowMultiple from '@fluentui/svg-icons/icons/window_multiple_20_regular.svg?raw';
-const { children, title, actions, navigationToggle, editorControls, scrollable = false, inert = false } = $props();
+const { children, title, actions, navigationToggle, editorControls, scrollable = false, inert = false, loading = false } = $props();
 const localization = new PageLayoutLocalization();
+const { timeout: loadingTimeout, blocking: loadingBlocking } = $derived(resolvePageLoading(loading));
 </script>
 
-<div class="page-layout" class:page-layout--scrollable={scrollable} inert={inert}>
+<div class="page-layout" class:page-layout--scrollable={scrollable} inert={inert || loadingBlocking}>
   <div class="page-layout__header">
     <div class="page-layout__title">
       {#if typeof title === 'function'}
@@ -50,6 +53,9 @@ const localization = new PageLayoutLocalization();
   <div class="page-layout__body">
     {@render children()}
   </div>
+  {#if loading}
+    <Spinner position="absolute-center" timeout={loadingTimeout} blocking={loadingBlocking} />
+  {/if}
 </div>
 
 <!--
@@ -63,6 +69,12 @@ outlined squares. Every entry takes `{ active?, onClick }`, and the group render
 navigation → panels → close. Set `scrollable` to let the whole page scroll as one document with
 sticky panel headers.
 
+`loading` (`true` or `{ timeout, blocking }`) shows a delayed `Spinner` centered over the layout.
+`blocking` makes the whole layout — header included — `inert` at once and dims it with the
+`Spinner` overlay after the same `timeout`; `inert` alone blocks without a spinner. With
+`scrollable` the layout itself scrolls, so the spinner and overlay stay at the top of the scroll.
+A loading `PagePanel` inside a loading layout draws its own spinner and overlay on top.
+
 ### CSS Custom Properties
 | Property | Description | Default |
 |---|---|---|
@@ -84,6 +96,7 @@ sticky panel headers.
   flex-direction: column;
   height: 100%;
   max-height: 100%;
+  position: relative;
   background: var(--_page-layout--background);
   color: var(--_page-layout--color);
 }

package/dist/ui/page-layout/cmp.page-layout.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { EditorControls, PageLayoutAction } from './types';
+import type { EditorControls, PageLayoutAction, PageLoading } from './types';
 import type { Snippet } from 'svelte';
 type Props = {
     children: Snippet;
@@ -11,6 +11,8 @@ type Props = {
     scrollable?: boolean;
     /** Sets `inert` on the whole layout — header and body stop taking focus, clicks and assistive-tech interaction. */
     inert?: boolean;
+    /** Shows a `Spinner` centered over the layout; `blocking` also makes the whole layout `inert` and dims it. @default false */
+    loading?: PageLoading;
 };
 /**
  * PageLayout — top-level window chrome. Renders a fixed-height header (title + actions + an optional
@@ -22,6 +24,12 @@ type Props = {
  * navigation → panels → close. Set `scrollable` to let the whole page scroll as one document with
  * sticky panel headers.
  *
+ * `loading` (`true` or `{ timeout, blocking }`) shows a delayed `Spinner` centered over the layout.
+ * `blocking` makes the whole layout — header included — `inert` at once and dims it with the
+ * `Spinner` overlay after the same `timeout`; `inert` alone blocks without a spinner. With
+ * `scrollable` the layout itself scrolls, so the spinner and overlay stay at the top of the scroll.
+ * A loading `PagePanel` inside a loading layout draws its own spinner and overlay on top.
+ *
  * ### CSS Custom Properties
  * | Property | Description | Default |
  * |---|---|---|

package/dist/ui/page-layout/cmp.page-panel.svelte

@@ -1,13 +1,16 @@
 <script lang="ts">import { horizontalWheelScroll } from '../../core/actions';
 import { slideHorizontally, transitionDuration } from '../../core/transitions';
 import { Icon } from '../icon';
+import { Spinner } from '../spinner';
 import PanelCollapseButton from './cmp.panel-collapse-button.svelte';
 import { PageLayoutLocalization } from './page-layout-localization';
+import { resolvePageLoading } from './page-loading';
 import IconChevronLeft from '@fluentui/svg-icons/icons/chevron_left_20_regular.svg?raw';
 import IconChevronRight from '@fluentui/svg-icons/icons/chevron_right_20_regular.svg?raw';
 import { untrack } from 'svelte';
-const { panelState, children, id, header, footer, title, actionsLeft, actionsCenter, actionsRight, collapseButtons, hideHeader = false, balanceHeaderCenter = false, resizing = null, borders = [], on } = $props();
+const { panelState, children, id, header, footer, title, actionsLeft, actionsCenter, actionsRight, collapseButtons, hideHeader = false, balanceHeaderCenter = false, resizing = null, borders = [], loading = false, on } = $props();
 const localization = new PageLayoutLocalization();
+const { timeout: loadingTimeout, blocking: loadingBlocking } = $derived(resolvePageLoading(loading));
 const isFlex = untrack(() => !resizing);
 const HEADER_SCROLL_STEP = 160;
 let panelRef = $state(undefined);
@@ -137,7 +140,8 @@ $effect(() => {
     class:page-panel--border-top={borders.includes('top')}
     class:page-panel--border-right={borders.includes('right')}
     class:page-panel--border-bottom={borders.includes('bottom')}
-    class:page-panel--border-left={borders.includes('left')}>
+    class:page-panel--border-left={borders.includes('left')}
+    inert={loadingBlocking}>
     {#if !hideHeader}
       <div class="page-panel__header" class:page-panel__header--balanced={balanceHeaderCenter}>
         {#if header}
@@ -239,6 +243,10 @@ $effect(() => {
         aria-valuenow={entry.width ?? 0}>
       </button>
     {/if}
+
+    {#if loading}
+      <Spinner position="absolute-center" timeout={loadingTimeout} blocking={loadingBlocking} />
+    {/if}
   </div>
 {/if}
 
@@ -250,6 +258,11 @@ instance, and configurable borders. Collapse uses the `slideHorizontally` transi
 
 Pass the same `panelState` instance to every panel + collapse button that should coordinate.
 
+`loading` (`true` or `{ timeout, blocking }`) shows a delayed `Spinner` centered over the panel.
+`blocking` makes the whole panel — header and footer included — `inert` at once and dims it with
+the `Spinner` overlay after the same `timeout`. Inside a `scrollable` `PageLayout` the panel is as
+tall as its content, so the spinner sits in the middle of the whole panel, not of the viewport.
+
 ### Header modes
 - `title` (string | Snippet) — renders in the left section; `actionsLeft` / `actionsRight` and
   `collapseButtons` are placed alongside.

package/dist/ui/page-layout/cmp.page-panel.svelte.d.ts

@@ -1,5 +1,5 @@
 import type { PanelState } from './panel-state.svelte';
-import type { PanelBorder, PanelResizingSettings } from './types';
+import type { PageLoading, PanelBorder, PanelResizingSettings } from './types';
 import type { Snippet } from 'svelte';
 type Props = {
     /** The shared `PanelState` instance this panel registers with. */
@@ -22,6 +22,8 @@ type Props = {
     /** Resize / collapse config. `null` ⇒ the panel is `flex: 1` (no resizing). @default null */
     resizing?: PanelResizingSettings | null;
     borders?: PanelBorder[];
+    /** Shows a `Spinner` centered over the panel; `blocking` also makes the whole panel `inert` and dims it. @default false */
+    loading?: PageLoading;
     on?: {
         collapse?: (collapsed: boolean) => void;
     };
@@ -33,6 +35,11 @@ type Props = {
  *
  * Pass the same `panelState` instance to every panel + collapse button that should coordinate.
  *
+ * `loading` (`true` or `{ timeout, blocking }`) shows a delayed `Spinner` centered over the panel.
+ * `blocking` makes the whole panel — header and footer included — `inert` at once and dims it with
+ * the `Spinner` overlay after the same `timeout`. Inside a `scrollable` `PageLayout` the panel is as
+ * tall as its content, so the spinner sits in the middle of the whole panel, not of the viewport.
+ *
  * ### Header modes
  * - `title` (string | Snippet) — renders in the left section; `actionsLeft` / `actionsRight` and
  * `collapseButtons` are placed alongside.

package/dist/ui/page-layout/index.d.ts

@@ -5,4 +5,4 @@ export { default as PagePanels } from './cmp.page-panels.svelte';
 export { default as PanelCollapseButton } from './cmp.panel-collapse-button.svelte';
 export { default as PanelContent } from './cmp.panel-content.svelte';
 export { PanelEntry, PanelState, SidebarsToggle } from './panel-state.svelte';
-export type { EditorControls, PageLayoutAction, PanelBorder, PanelResizingSettings } from './types';
+export type { EditorControls, PageLayoutAction, PageLoading, PanelBorder, PanelResizingSettings } from './types';

package/dist/ui/page-layout/page-loading.d.ts

@@ -0,0 +1,5 @@
+import type { PageLoading } from './types';
+export declare const resolvePageLoading: (loading: PageLoading) => {
+    timeout: number;
+    blocking: boolean;
+};

package/dist/ui/page-layout/page-loading.js

@@ -0,0 +1,7 @@
+const DEFAULT_LOADING_TIMEOUT = 500;
+export const resolvePageLoading = (loading) => {
+    if (typeof loading === 'object') {
+        return { timeout: loading.timeout ?? DEFAULT_LOADING_TIMEOUT, blocking: loading.blocking === true };
+    }
+    return { timeout: DEFAULT_LOADING_TIMEOUT, blocking: false };
+};

package/dist/ui/page-layout/types.d.ts

@@ -30,3 +30,11 @@ export type EditorControls = {
     panelsToggle: PageLayoutAction;
     close: PageLayoutAction;
 };
+/**
+ * `PageLayout` / `PagePanel` loading state. `true` shows a non-blocking `Spinner` after 500ms. The object form sets the delay in ms (`timeout`, default
+ * 500) and, with `blocking`, makes the whole component `inert` at once and dims it with the `Spinner` overlay after the same delay.
+ */
+export type PageLoading = boolean | {
+    timeout?: number;
+    blocking?: boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamscloud/kit",
-  "version": "0.70.0",
+  "version": "0.72.0",
   "author": "StreamsCloud",
   "repository": {
     "type": "git",