@streamscloud/kit 0.62.0 → 0.63.0

package/dist/ui/table/cmp.table-draggable.svelte

@@ -7,9 +7,9 @@ import { columnWidthStyle, createTableView } from './table-view.svelte';
 import IconReorderDotsHorizontal from '@fluentui/svg-icons/icons/re_order_dots_horizontal_20_regular.svg?raw';
 import { flip } from 'svelte/animate';
 import { dndzone } from 'svelte-dnd-action';
-let { model, showAlternativeView = false, noItemsPlaceholder, on, alternativeView, customNoItemsPlaceholder } = $props();
+let { model, showAlternativeView = false, noItemsPlaceholderEnabled, noItemsPlaceholderDelay, on, alternativeView, customNoItemsPlaceholder } = $props();
 const localization = new TableLocalization();
-const view = createTableView(() => model, () => on, () => noItemsPlaceholder);
+const view = createTableView(() => model, () => on, () => noItemsPlaceholderEnabled, () => noItemsPlaceholderDelay);
 const flipDurationMs = 200;
 let tableRef = $state.raw(null);
 let dndItems = $state.raw(null);

package/dist/ui/table/cmp.table-draggable.svelte.d.ts

@@ -6,13 +6,11 @@ declare function $$render<T extends {
     props: {
         model: TableModel<T>;
         showAlternativeView?: boolean;
-        /**
-         * When an empty list turns into the no-items placeholder. A number delays it by that many ms (anti-flicker while the first page is in flight); a boolean
-         * decides outright — `true` shows it as soon as the list is empty, `false` never shows it (pair it with your own loading / empty UI). Rows always win:
-         * the placeholder is never rendered over a non-empty list.
-         * @default 700
-         */
-        noItemsPlaceholder?: number | boolean;
+        /** Whether an empty list turns into the no-items placeholder at all — `false` pairs with your own loading / empty UI. Rows always win: the placeholder
+         * is never rendered over a non-empty list. @default true */
+        noItemsPlaceholderEnabled?: boolean;
+        /** Anti-flicker delay in ms before the placeholder appears, once `noItemsPlaceholderEnabled`. `0` shows it as soon as the list is empty. @default 0 */
+        noItemsPlaceholderDelay?: number;
         on?: {
             selectionChanged?: (e: T[]) => void;
             itemsSelected?: (e: T[]) => void;

package/dist/ui/table/cmp.table.svelte

@@ -3,9 +3,9 @@ import { EmptyState } from '../empty-state';
 import { TableCell, TableHideableCell } from './table-cells';
 import { TableLocalization } from './table-localization';
 import { columnWidthStyle, createTableView } from './table-view.svelte';
-let { model, showAlternativeView = false, noItemsPlaceholder, grouping, on, alternativeView, customNoItemsPlaceholder } = $props();
+let { model, showAlternativeView = false, noItemsPlaceholderEnabled, noItemsPlaceholderDelay, grouping, on, alternativeView, customNoItemsPlaceholder } = $props();
 const localization = new TableLocalization();
-const view = createTableView(() => model, () => on, () => noItemsPlaceholder);
+const view = createTableView(() => model, () => on, () => noItemsPlaceholderEnabled, () => noItemsPlaceholderDelay);
 const displayRows = $derived.by(() => {
     const items = model.items;
     const grp = grouping;

package/dist/ui/table/cmp.table.svelte.d.ts

@@ -6,13 +6,11 @@ declare function $$render<T extends {
     props: {
         model: TableModel<T>;
         showAlternativeView?: boolean;
-        /**
-         * When an empty list turns into the no-items placeholder. A number delays it by that many ms (anti-flicker while the first page is in flight); a boolean
-         * decides outright — `true` shows it as soon as the list is empty, `false` never shows it (pair it with your own loading / empty UI). Rows always win:
-         * the placeholder is never rendered over a non-empty list.
-         * @default 700
-         */
-        noItemsPlaceholder?: number | boolean;
+        /** Whether an empty list turns into the no-items placeholder at all — `false` pairs with your own loading / empty UI. Rows always win: the placeholder
+         * is never rendered over a non-empty list. @default true */
+        noItemsPlaceholderEnabled?: boolean;
+        /** Anti-flicker delay in ms before the placeholder appears, once `noItemsPlaceholderEnabled`. `0` shows it as soon as the list is empty. @default 0 */
+        noItemsPlaceholderDelay?: number;
         /** Group consecutive (already-sorted) rows under section headers. `key` returns a group id per item (`null` = ungrouped); a header row renders wherever the key changes between neighbours. */
         grouping?: {
             key: (item: T) => string | null;

package/dist/ui/table/table-view.svelte.d.ts

@@ -8,8 +8,8 @@ type SelectionCallbacks<T> = {
 };
 /** Inline width declarations for a column's `th` / `td`: the preferred width plus, when set, the floor the browser must honour. */
 export declare const columnWidthStyle: <T extends WithId>(column: ResolvedColumn<T>) => string;
-/** Shared presentation wiring for the table views: selection-event subscriptions + the no-items placeholder decision (`number` = delay in ms, boolean = explicit). */
-export declare const createTableView: <T extends WithId>(model: () => TableModel<T>, on: () => SelectionCallbacks<T> | undefined, noItemsPlaceholder?: () => number | boolean | undefined) => {
+/** Shared presentation wiring for the table views: selection-event subscriptions + the no-items placeholder decision (on/off gate + anti-flicker delay). */
+export declare const createTableView: <T extends WithId>(model: () => TableModel<T>, on: () => SelectionCallbacks<T> | undefined, noItemsPlaceholderEnabled?: () => boolean | undefined, noItemsPlaceholderDelay?: () => number | undefined) => {
     readonly showNoItemsPlaceholder: boolean;
 };
 export {};

package/dist/ui/table/table-view.svelte.js

@@ -4,9 +4,8 @@ export const columnWidthStyle = (column) => {
     const width = column.cssWidth ? `width: ${column.cssWidth};` : 'width: auto;';
     return column.minCssWidth ? `${width} min-width: ${column.minCssWidth};` : width;
 };
-const NO_ITEMS_PLACEHOLDER_DELAY_MS = 700;
-/** Shared presentation wiring for the table views: selection-event subscriptions + the no-items placeholder decision (`number` = delay in ms, boolean = explicit). */
-export const createTableView = (model, on, noItemsPlaceholder = () => undefined) => {
+/** Shared presentation wiring for the table views: selection-event subscriptions + the no-items placeholder decision (on/off gate + anti-flicker delay). */
+export const createTableView = (model, on, noItemsPlaceholderEnabled = () => undefined, noItemsPlaceholderDelay = () => undefined) => {
     let showNoItemsPlaceholder = $state(false);
     let timeout = 0;
     $effect(() => untrack(() => {
@@ -19,20 +18,25 @@ export const createTableView = (model, on, noItemsPlaceholder = () => undefined)
         return () => subscriptions.forEach((unsubscribe) => unsubscribe());
     }));
     $effect(() => {
-        const decision = noItemsPlaceholder() ?? NO_ITEMS_PLACEHOLDER_DELAY_MS;
         if (model().items.length) {
             clearTimeout(timeout);
             showNoItemsPlaceholder = false;
             return;
         }
-        if (typeof decision === 'boolean') {
+        if (noItemsPlaceholderEnabled() === false) {
             clearTimeout(timeout);
-            showNoItemsPlaceholder = decision;
+            showNoItemsPlaceholder = false;
+            return;
+        }
+        const delay = noItemsPlaceholderDelay() ?? 0;
+        if (delay <= 0) {
+            clearTimeout(timeout);
+            showNoItemsPlaceholder = true;
             return;
         }
         timeout = window.setTimeout(() => {
             showNoItemsPlaceholder = !model().items.length;
-        }, decision);
+        }, delay);
         return () => clearTimeout(timeout);
     });
     return {

package/package.json

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