@tanstack/svelte-table 9.0.0-beta.51 → 9.0.0-beta.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/svelte-table",
-  "version": "9.0.0-beta.51",
+  "version": "9.0.0-beta.53",
   "description": "Headless UI for building powerful tables & datagrids for Svelte.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -53,12 +53,11 @@
   },
   "files": [
     "dist",
-    "src",
     "skills"
   ],
   "dependencies": {
     "@tanstack/svelte-store": "^0.12.0",
-    "@tanstack/table-core": "9.0.0-beta.51"
+    "@tanstack/table-core": "9.0.0-beta.53"
   },
   "devDependencies": {
     "@sveltejs/package": "^2.5.8",

package/skills/create-table-hook/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   type: framework
   library: '@tanstack/svelte-table'
   framework: svelte
-  library_version: '9.0.0-beta.51'
+  library_version: '9.0.0-beta.53'
 requires:
   - '@tanstack/table-core#core'
   - getting-started
@@ -165,4 +165,4 @@ Source: `docs/framework/svelte/guide/composable-tables.md`
 
 ## API Discovery
 
-Inspect `node_modules/@tanstack/svelte-table/src/createTableHook.svelte.ts` and the `App*.svelte` wrappers for exact returned helpers and component contracts.
+Inspect `node_modules/@tanstack/svelte-table/dist/createTableHook.svelte.d.ts` and the `App*.svelte` wrappers for exact returned helpers and component contracts.

package/skills/getting-started/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   type: framework
   library: '@tanstack/svelte-table'
   framework: svelte
-  library_version: '9.0.0-beta.51'
+  library_version: '9.0.0-beta.53'
 requires:
   - '@tanstack/table-core#core'
   - '@tanstack/table-core#table-features'
@@ -169,4 +169,4 @@ Source: `docs/framework/svelte/guide/migrating.md`
 
 ## API Discovery
 
-Inspect `node_modules/@tanstack/svelte-table/src/index.ts`, then the exported implementation. Inspect core and feature APIs through `node_modules/@tanstack/table-core/src/index.ts` and `src/features/<feature>/`.
+Inspect `node_modules/@tanstack/svelte-table/dist/index.d.ts`, then the exported implementation. Inspect core and feature APIs through `node_modules/@tanstack/table-core/dist/index.d.ts` and `dist/features/<feature>/`.

package/skills/migrate-v8-to-v9/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   type: lifecycle
   library: '@tanstack/svelte-table'
   framework: svelte
-  library_version: '9.0.0-beta.51'
+  library_version: '9.0.0-beta.53'
 requires:
   - '@tanstack/table-core#migrate-v8-to-v9'
   - getting-started
@@ -192,4 +192,4 @@ Keep calls bound to row/cell/column/header instances; shallow copies do not cont
 
 ## API Discovery
 
-Verify the installed target in `node_modules/@tanstack/svelte-table/src/index.ts` and its adapter sources. Verify feature slots and exact beta APIs in `node_modules/@tanstack/table-core/src`; do not reconstruct v9 APIs from v8 memory.
+Verify the installed target in `node_modules/@tanstack/svelte-table/dist/index.d.ts` and its adapter sources. Verify feature slots and exact beta APIs in `node_modules/@tanstack/table-core/dist/`; do not reconstruct v9 APIs from v8 memory.

package/skills/table-state/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   type: framework
   library: '@tanstack/svelte-table'
   framework: svelte
-  library_version: '9.0.0-beta.51'
+  library_version: '9.0.0-beta.53'
 requires:
   - '@tanstack/table-core#core'
   - getting-started
@@ -202,4 +202,4 @@ Source: `docs/framework/svelte/guide/pagination.md`
 
 ## API Discovery
 
-Inspect `node_modules/@tanstack/svelte-table/src/createTable.svelte.ts`, `createTableState.svelte.ts`, and `subscribe.ts`; inspect registered state slices in the matching core feature source.
+Inspect `node_modules/@tanstack/svelte-table/dist/createTable.svelte.d.ts`, `createTableState.svelte.d.ts`, and `subscribe.d.ts`; inspect registered state slices in the matching core feature source.

package/skills/with-tanstack-query/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   type: composition
   library: '@tanstack/svelte-table'
   framework: svelte
-  library_version: '9.0.0-beta.51'
+  library_version: '9.0.0-beta.53'
 requires:
   - '@tanstack/table-core#client-vs-server'
   - getting-started
@@ -144,4 +144,4 @@ Source: `docs/framework/svelte/guide/pagination.md`
 
 ## API Discovery
 
-Inspect `node_modules/@tanstack/svelte-table/src/index.ts` for adapter APIs and installed `@tanstack/svelte-query/src` for the exact Query version. Table manual-stage options live in the matching core feature source.
+Inspect `node_modules/@tanstack/svelte-table/dist/index.d.ts` for adapter APIs and installed `@tanstack/svelte-query/dist/` for the exact Query version. Table manual-stage options live in the matching core feature source.

package/skills/with-tanstack-virtual/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   type: composition
   library: '@tanstack/svelte-table'
   framework: svelte
-  library_version: '9.0.0-beta.51'
+  library_version: '9.0.0-beta.53'
 requires:
   - '@tanstack/table-core#core'
   - getting-started
@@ -147,4 +147,4 @@ Source: `docs/framework/svelte/guide/virtualization.md`
 
 ## API Discovery
 
-Inspect installed `@tanstack/svelte-table/src` for Table APIs and `@tanstack/svelte-virtual/src` for the exact virtualizer options. Use the maintained Svelte examples for layout combinations.
+Inspect installed `@tanstack/svelte-table/dist/` for Table APIs and `@tanstack/svelte-virtual/dist/` for the exact virtualizer options. Use the maintained Svelte examples for layout combinations.

package/src/AppCell.svelte

@@ -1,13 +0,0 @@
-<script lang="ts">
-  import type { Snippet } from 'svelte'
-
-  interface Props {
-    cell: any
-    cellComponents: any
-    children: Snippet<[any]>
-  }
-
-  let { children, cell, cellComponents }: Props = $props()
-</script>
-
-{@render children?.(Object.assign(cell, cellComponents))}

package/src/AppHeader.svelte

@@ -1,13 +0,0 @@
-<script lang="ts">
-  import type { Snippet } from 'svelte'
-
-  interface Props {
-    header: any
-    headerComponents: any
-    children: Snippet<[any]>
-  }
-
-  let { children, header, headerComponents }: Props = $props()
-</script>
-
-{@render children?.(Object.assign(header, headerComponents))}

package/src/AppTable.svelte

@@ -1,11 +0,0 @@
-<script lang="ts">
-  import type { Snippet } from 'svelte'
-
-  interface Props {
-    children: Snippet
-  }
-
-  let { children }: Props = $props()
-</script>
-
-{@render children?.()}

package/src/FlexRender.svelte

@@ -1,103 +0,0 @@
-<script
-  lang="ts"
-  generics="TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData"
->
-  import { isFunction } from '@tanstack/table-core'
-  import {
-    RenderComponentConfig,
-    RenderSnippetConfig,
-  } from './render-component'
-  import type {
-    Cell,
-    CellContext,
-    CellData,
-    ColumnDefTemplate,
-    Header,
-    HeaderContext,
-    RowData,
-    TableFeatures,
-  } from '@tanstack/table-core'
-
-  type Props =
-    | {
-        /** The cell or header field of the current cell's column definition. */
-        content?: ColumnDefTemplate<
-          | HeaderContext<TFeatures, TData, TValue>
-          | CellContext<TFeatures, TData, TValue>
-        >
-        /** The result of the `getContext()` function of the header or cell */
-        context:
-          | HeaderContext<TFeatures, TData, TValue>
-          | CellContext<TFeatures, TData, TValue>
-        cell?: never
-        header?: never
-        footer?: never
-      }
-    | {
-        cell: Cell<TFeatures, TData, TValue>
-        content?: never
-        context?: never
-        header?: never
-        footer?: never
-      }
-    | {
-        header: Header<TFeatures, TData, TValue>
-        content?: never
-        context?: never
-        cell?: never
-        footer?: never
-      }
-    | {
-        footer: Header<TFeatures, TData, TValue>
-        content?: never
-        context?: never
-        cell?: never
-        header?: never
-      }
-
-  let props: Props = $props()
-
-  // Resolve content and context from either the new cell/header/footer props
-  // or the legacy content/context props.
-  const resolved = $derived.by(() => {
-    if ('cell' in props && props.cell) {
-      return {
-        content: props.cell.column.columnDef.cell,
-        context: props.cell.getContext(),
-      }
-    }
-    if ('header' in props && props.header) {
-      return {
-        content: props.header.column.columnDef.header,
-        context: props.header.getContext(),
-      }
-    }
-    if ('footer' in props && props.footer) {
-      return {
-        content: props.footer.column.columnDef.footer,
-        context: props.footer.getContext(),
-      }
-    }
-    return {
-      content: props.content,
-      context: props.context,
-    }
-  })
-
-  // Compute the render result reactively
-  const result = $derived(
-    isFunction(resolved.content)
-      ? resolved.content(resolved.context as any)
-      : undefined,
-  )
-</script>
-
-{#if typeof resolved.content === 'string'}
-  {resolved.content}
-{:else if result instanceof RenderComponentConfig}
-  <result.component {...result.props} />
-{:else if result instanceof RenderSnippetConfig}
-  {@render result.snippet(result.params)}
-{:else if result !== undefined}
-  {result}
-{/if}

package/src/context-keys.ts

@@ -1,3 +0,0 @@
-export const tableContextKey = '__tanstack_table_context_key'
-export const cellContextKey = '__tanstack_cell_context_key'
-export const headerContextKey = '__tanstack_header_context_key'

package/src/createTable.svelte.ts

@@ -1,136 +0,0 @@
-import { constructTable } from '@tanstack/table-core'
-import { useSelector } from '@tanstack/svelte-store'
-import { untrack } from 'svelte'
-import { flatMerge, mergeObjects } from './merge-objects'
-import { svelteReactivity } from './reactivity.svelte'
-import type {
-  RowData,
-  Table,
-  TableFeatures,
-  TableOptions,
-  TableState,
-} from '@tanstack/table-core'
-
-export type SvelteTable<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
-  TSelected = TableState<TFeatures>,
-> = Omit<Table<TFeatures, TData>, 'store'> & {
-  /**
-   * @deprecated Prefer `table.state` for render reads,
-   * `table.atoms.<slice>.get()` for slice snapshots, or
-   * `useSelector(table.store, selector)` for explicit subscriptions.
-   * `table.store.state` is a current-value snapshot and is easy to misuse in
-   * render code.
-   */
-  readonly store: Table<TFeatures, TData>['store']
-  /**
-   * The selected state of the table. This state may not match the structure of
-   * the full table state because it is selected by the selector function that
-   * you pass as the 2nd argument to `createTable`.
-   *
-   * @example
-   * const table = createTable(options, (state) => ({ globalFilter: state.globalFilter })) // only globalFilter is part of the selected state
-   *
-   * console.log(table.state.globalFilter)
-   */
-  readonly state: Readonly<TSelected>
-}
-
-/**
- * Creates a Svelte 5 table instance backed by rune-aware TanStack Store atoms.
- *
- * The optional selector projects from `table.store`; the selected value is
- * exposed on `table.state`. The adapter syncs options in `$effect.pre`, so
- * reactive option getters and external `$state` values are applied before DOM
- * updates read table APIs such as `getRowModel()`.
- *
- * @example
- * ```svelte
- * <script lang="ts">
- *   const table = createTable(
- *     {
- *       features,
- *       columns,
- *       data,
- *     },
- *     (state) => ({ pagination: state.pagination }),
- *   )
- * </script>
- *
- * {table.state.pagination.pageIndex}
- * ```
- */
-export function createTable<
-  TFeatures extends TableFeatures,
-  TData extends RowData,
-  TSelected = TableState<TFeatures>,
->(
-  tableOptions: TableOptions<TFeatures, TData>,
-  selector?: (state: TableState<TFeatures>) => TSelected,
-): SvelteTable<TFeatures, TData, TSelected> {
-  // 1. Merge reactivity into options using mergeObjects (preserves getters)
-  const mergedOptions = mergeObjects(tableOptions, {
-    features: {
-      coreReactivityFeature: svelteReactivity(),
-      ...tableOptions.features,
-    },
-  }) as TableOptions<TFeatures, TData>
-
-  // 2. Set up resolved options with mergeOptions handler
-  const resolvedOptions = mergeObjects(
-    {
-      mergeOptions: (
-        defaultOptions: TableOptions<TFeatures, TData>,
-        newOptions: Partial<TableOptions<TFeatures, TData>>,
-      ) => {
-        return flatMerge(defaultOptions, newOptions)
-      },
-    },
-    mergedOptions,
-  ) as TableOptions<TFeatures, TData>
-
-  // 3. Construct table
-  const table = constructTable(resolvedOptions) as unknown as SvelteTable<
-    TFeatures,
-    TData,
-    TSelected
-  >
-
-  // 4. Sync options reactively. When controlled state changes (e.g., $state
-  // inside createTableState), the effect re-runs and calls setOptions.
-  // Use $effect.pre so the table sees updated options BEFORE the DOM renders,
-  // ensuring getRowModel() returns current data (not stale, one-frame-behind data).
-  // The reactive reads (state getters, data getter) happen OUTSIDE untrack
-  // so they become dependencies. The setOptions call is INSIDE untrack so
-  // option writes do not subscribe this effect to table internals.
-  $effect.pre(() => {
-    // Read reactive getters to create $effect dependencies on external state
-    const state: Record<string, unknown> | undefined = mergedOptions.state
-    if (state) {
-      for (const key in state) {
-        void state[key]
-      }
-    }
-    void mergedOptions.data
-
-    untrack(() => {
-      table.setOptions((prev) => {
-        return flatMerge(prev, mergedOptions)
-      })
-    })
-  })
-
-  // 5. State selector
-  const stateStore = useSelector(table.store, selector)
-
-  Object.defineProperty(table, 'state', {
-    get() {
-      return stateStore.current
-    },
-    configurable: true,
-    enumerable: true,
-  })
-
-  return table
-}