simple-table-core 4.0.0 → 4.0.1

package/dist/cjs/src/utils/loadingPlaceholderUtils.d.ts

@@ -0,0 +1,11 @@
+import type Row from "../types/Row";
+import type { GetRowId } from "../types/GetRowId";
+/** Mark and return a fresh empty row used as an `isLoading` skeleton placeholder. */
+export declare const createLoadingPlaceholderRow: () => Row;
+export declare const isLoadingPlaceholderRow: (row: Row) => boolean;
+/**
+ * Consumer `getRowId` often collapses empty placeholders to the same key.
+ * Skip it for placeholders so WeakMap identity / positional ids stay unique.
+ */
+export declare const wrapGetRowIdForLoadingPlaceholders: (getRowId: GetRowId | undefined) => GetRowId | undefined;
+export declare const createLoadingPlaceholderRows: (count: number) => Row[];

package/dist/cjs/src/utils/propSyncEqual.d.ts

@@ -44,8 +44,8 @@ export declare function collectHeaderAccessors(headers: ReadonlyArray<HeaderStru
  * invisible — callers must pass new object identities when data changes.
  */
 export declare function shallowEqualRow(a: object, b: object): boolean;
-/** Compatible with `GetRowId`; return may be undefined for sync helpers. */
-export type GetRowIdLike = (params: GetRowIdParams) => string | number | undefined;
+/** Compatible with `GetRowId`; return may be nullish for sync helpers. */
+export type GetRowIdLike = (params: GetRowIdParams) => string | number | null | undefined;
 /**
  * Above this length, skip per-field shallow compares when row object identity
  * differs. Same-array-ref and same-row-object cases stay O(1) / O(n) pointer

package/dist/cjs/stories/tests/22-LoadingStateTests.stories.d.ts

@@ -1,11 +1,14 @@
 /**
  * LOADING STATE TESTS
- * Tests for isLoading prop - skeleton loaders in cells when data is loading.
+ * Tests for isLoading prop - skeleton loaders when data is loading.
  */
 import type { Meta } from "@storybook/html";
 import { SimpleTableVanilla } from "../../src/index";
 declare const meta: Meta;
 export default meta;
+/**
+ * Rows + isLoading: real data stays visible and skeleton rows are appended below.
+ */
 export declare const LoadingStateShowsSkeletons: {
     render: () => HTMLDivElement & {
         _table?: SimpleTableVanilla | undefined;
@@ -54,14 +57,20 @@ export declare const LoadingToLoadedRemovesStaleCells: {
     }) => Promise<void>;
 };
 /**
- * Repro: `updateBodyCellElement` skips content rebuilds for expandable cells
- * so the expand-icon DOM node survives for CSS transitions. That bypass also
- * skips loading-skeleton swaps, so toggling `isLoading` on already-rendered
- * row-grouped rows leaves the expandable column out of sync with every other
- * column.
- *
- * Entering loading: non-expandable columns show skeletons; expandable columns
- * keep their stale expand icon + value.
+ * Pagination / infinite-scroll style: loaded rows stay put; skeletons append;
+ * clearing loading with more rows removes skeletons.
+ */
+export declare const LoadingAppendsSkeletonsUnderLoadedRows: {
+    render: () => HTMLDivElement & {
+        _table?: SimpleTableVanilla | undefined;
+    };
+    play: ({ canvasElement }: {
+        canvasElement: HTMLElement;
+    }) => Promise<void>;
+};
+/**
+ * Entering loading with existing expandable rows keeps their chevrons/content
+ * and only appends skeleton placeholder rows below.
  */
 export declare const ExpandableCellsShowSkeletonWhenEnteringLoading: {
     render: () => HTMLDivElement & {
@@ -72,10 +81,8 @@ export declare const ExpandableCellsShowSkeletonWhenEnteringLoading: {
     }) => Promise<void>;
 };
 /**
- * Repro (exit path): expandable cells created while `isLoading` is true render
- * as skeletons. When loading ends, content updates are still skipped for
- * expandable cells, so they stay stuck on the skeleton instead of restoring
- * the expand icon + value.
+ * Full-table skeleton (empty + loading) then resolve expandable rows: expandable
+ * cells must restore chevron + value instead of staying stuck on skeletons.
  */
 export declare const ExpandableCellsRestoreContentWhenLeavingLoading: {
     render: () => HTMLDivElement & {