fix: minor improvements on clean install (#59)

* fix: minor issues clean install

* wip:

* fix: cls

Author: mxkaske

registry.json

@@ -193,6 +193,10 @@
           "path": "src/lib/data-table/types.ts",
           "type": "registry:lib"
         },
+        {
+          "path": "src/react-table.d.ts",
+          "type": "registry:lib"
+        },
         {
           "path": "src/constants/date-preset.ts",
           "type": "registry:lib"
@@ -290,7 +294,7 @@
         }
       ],
       "registryDependencies": [
-        "https://data-table-filters.com/r/data-table.json",
+        "https://data-table.openstatus.dev/r/data-table.json",
         "command",
         "kbd",
         "separator"
@@ -345,7 +349,7 @@
         }
       ],
       "registryDependencies": [
-        "https://data-table-filters.com/r/data-table.json",
+        "https://data-table.openstatus.dev/r/data-table.json",
         "tooltip",
         "hover-card"
       ],
@@ -379,8 +383,8 @@
         }
       ],
       "registryDependencies": [
-        "https://data-table-filters.com/r/data-table.json",
-        "https://data-table-filters.com/r/data-table-cell.json",
+        "https://data-table.openstatus.dev/r/data-table.json",
+        "https://data-table.openstatus.dev/r/data-table-cell.json",
         "button",
         "dropdown-menu",
         "kbd",
@@ -419,7 +423,7 @@
         }
       ],
       "registryDependencies": [
-        "https://data-table-filters.com/r/data-table.json"
+        "https://data-table.openstatus.dev/r/data-table.json"
       ],
       "dependencies": ["nuqs"]
     },
@@ -443,7 +447,7 @@
         }
       ],
       "registryDependencies": [
-        "https://data-table-filters.com/r/data-table.json"
+        "https://data-table.openstatus.dev/r/data-table.json"
       ],
       "dependencies": ["zustand"]
     },
@@ -503,8 +507,8 @@
         }
       ],
       "registryDependencies": [
-        "https://data-table-filters.com/r/data-table.json",
-        "https://data-table-filters.com/r/data-table-cell.json"
+        "https://data-table.openstatus.dev/r/data-table.json",
+        "https://data-table.openstatus.dev/r/data-table-cell.json"
       ],
       "dependencies": ["@tanstack/react-table"]
     },
@@ -544,8 +548,8 @@
         }
       ],
       "registryDependencies": [
-        "https://data-table-filters.com/r/data-table.json",
-        "https://data-table-filters.com/r/data-table-schema.json"
+        "https://data-table.openstatus.dev/r/data-table.json",
+        "https://data-table.openstatus.dev/r/data-table-schema.json"
       ],
       "dependencies": ["drizzle-orm", "date-fns"]
     },
@@ -569,7 +573,7 @@
         }
       ],
       "registryDependencies": [
-        "https://data-table-filters.com/r/data-table.json"
+        "https://data-table.openstatus.dev/r/data-table.json"
       ],
       "dependencies": [
         "@tanstack/react-query",

skills/SKILL.md

@@ -47,10 +47,11 @@ All URLs use base `https://data-table.openstatus.dev`.
 
 ### Minimal Working Table (Memory Adapter)
 
+> **Note:** `DataTableInfinite` internally renders `DataTableProvider`, which already wraps children with `ControlsProvider` and `DataTableStoreSync`. You do NOT need to add these separately. The only wrapper you need is `DataTableStoreProvider` (for the BYOS adapter).
+
 ```tsx
 "use client";
 import { DataTableInfinite } from "@/components/data-table/data-table-infinite";
-import { DataTableProvider } from "@/components/data-table/data-table-provider";
 import type { DataTableFilterField } from "@/components/data-table/types";
 import { useMemoryAdapter } from "@/lib/store/adapters/memory";
 import { DataTableStoreProvider } from "@/lib/store/provider/DataTableStoreProvider";
@@ -167,6 +168,9 @@ See [references/fetch-layer.md](references/fetch-layer.md).
 
 - **Missing CSS vars**: Core injects `--color-success/warning/error/info`. Check cssVars applied to CSS.
 - **Import path mismatches**: shadcn CLI rewrites `@/` paths per `components.json` aliases.
-- **nuqs framework setup**: Next.js App Router requires `<NuqsAdapter>` in root layout.
+- **nuqs: silent failure or crash**: Two required setup steps — `<NuqsAdapter>` in root layout AND `<Suspense>` around the table component. See [references/store-adapters.md](references/store-adapters.md).
+- **nuqs: filters not applied from URL on load**: Pass server-parsed search params as `initialState` to the nuqs adapter. See the SSR Hydration section in [references/store-adapters.md](references/store-adapters.md).
+- **nuqs: phantom filters with empty string**: Use `field.string()` (null default), not `field.string().default("")`.
+- **Sheet dropdown missing**: `SheetField.type` must match the filter type (not `"readonly"`) to get the filter dropdown. Use `generateSheetFields()` to auto-derive from filter config.
 - **Filter not rendering**: Verify filter type string matches `FILTER_COMPONENTS` key.
 - **Tailwind v4**: Registry targets v4. Class syntax differs from v3.

skills/references/component-catalog.md

@@ -1,6 +1,6 @@
 # Component Catalog
 
-All extension blocks install via `npx shadcn@latest add <url>` (base: `https://data-table-filters.com`).
+All extension blocks install via `npx shadcn@latest add <url>` (base: `https://data-table.openstatus.dev`).
 
 ## Table of Contents
 
@@ -17,7 +17,7 @@ All extension blocks install via `npx shadcn@latest add <url>` (base: `https://d
 ## Command Palette
 
 **Block:** `data-table-filter-command`
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-filter-command.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-filter-command.json`
 **Auto-resolves:** core block, shadcn `command` + `kbd` + `separator`, `date-fns`, `lucide-react`
 
 ### Props
@@ -54,7 +54,7 @@ The command palette uses `useDataTable()` internally to access table context. No
 ## Cell Renderers
 
 **Block:** `data-table-cell`
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-cell.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-cell.json`
 **Auto-resolves:** core block, shadcn `tooltip` + `hover-card`, `sonner`, `@date-fns/utc`
 
 ### Available Cells
@@ -93,7 +93,7 @@ const columns: ColumnDef<MyData>[] = [
 ## Sheet Detail Panel
 
 **Block:** `data-table-sheet`
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-sheet.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-sheet.json`
 **Auto-resolves:** core block + cell renderers block, shadcn `button` + `dropdown-menu` + `kbd` + `separator` + `skeleton` + `tooltip`
 
 ### Components
@@ -142,19 +142,19 @@ See [store-adapters.md](store-adapters.md) for full setup details.
 ### nuqs (URL state)
 
 **Block:** `data-table-nuqs`
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-nuqs.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-nuqs.json`
 
 ### zustand (client state)
 
 **Block:** `data-table-zustand`
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-zustand.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-zustand.json`
 
 ---
 
 ## Schema System
 
 **Block:** `data-table-schema`
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-schema.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-schema.json`
 
 See [schema-api.md](schema-api.md) for full API.
 
@@ -163,7 +163,7 @@ See [schema-api.md](schema-api.md) for full API.
 ## Drizzle Helpers
 
 **Block:** `data-table-drizzle`
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-drizzle.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-drizzle.json`
 
 See [drizzle-integration.md](drizzle-integration.md) for handler API.
 
@@ -172,7 +172,7 @@ See [drizzle-integration.md](drizzle-integration.md) for handler API.
 ## Query Layer
 
 **Block:** `data-table-query`
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-query.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-query.json`
 
 See [fetch-layer.md](fetch-layer.md) for setup.
 

skills/references/drizzle-integration.md

@@ -1,6 +1,6 @@
 # Drizzle Integration
 
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-drizzle.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-drizzle.json`
 
 Auto-installs the schema block. Requires `drizzle-orm` in the project.
 

skills/references/fetch-layer.md

@@ -1,6 +1,6 @@
 # Fetch Layer (React Query)
 
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-query.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-query.json`
 
 Auto-installs `@tanstack/react-query` and `superjson`.
 

skills/references/schema-api.md

@@ -1,6 +1,6 @@
 # Schema API
 
-**Install:** `npx shadcn@latest add https://data-table-filters.com/r/data-table-schema.json`
+**Install:** `npx shadcn@latest add https://data-table.openstatus.dev/r/data-table-schema.json`
 
 ## Table of Contents
 
@@ -150,6 +150,20 @@ const sheetFields = generateSheetFields<Row>(tableSchema.definition);
 | `generateFilterSchema()` | Store schema definition     | BYOS adapter filter schema        |
 | `generateSheetFields()`  | `SheetField<T>[]`           | Sheet detail panel fields         |
 
+### Sheet Fields & Filter Dropdowns
+
+`generateSheetFields()` auto-derives each field's `type` from its filter config. This controls whether the sheet row gets a filter dropdown:
+
+| `SheetField.type` | Derived from               | Sheet dropdown options                          |
+| ----------------- | -------------------------- | ----------------------------------------------- |
+| `"readonly"`      | No filter config           | No dropdown — plain display + copy only         |
+| `"checkbox"`      | `.filterable("checkbox")`  | "Include" (adds value to array filter)          |
+| `"input"`         | `.filterable("input")`     | "Include" (sets text filter)                    |
+| `"slider"`        | `.filterable("slider")`    | "Less or equal", "Greater or equal", "Equal to" |
+| `"timerange"`     | `.filterable("timerange")` | "Exact timestamp", "Same hour", "Same day"      |
+
+Use `generateSheetFields()` whenever possible — it handles this mapping automatically. If manually defining `sheetFields`, set `type` to match the corresponding `filterFields` entry to get the dropdown.
+
 ### Filter Schema for Store Adapters
 
 `generateFilterSchema` produces a schema compatible with all adapters: