@noy-db/in-tanstack-table 0.2.0-pre.8 → 0.3.0-pre.1

package/README.md

@@ -26,7 +26,7 @@ See the [main repository](https://github.com/vLannaAi/noy-db#readme) for setup,
 
 - Source — [`packages/in-tanstack-table`](https://github.com/vLannaAi/noy-db/tree/main/packages/in-tanstack-table)
 - Issues — [github.com/vLannaAi/noy-db/issues](https://github.com/vLannaAi/noy-db/issues)
-- Spec — [`SPEC.md`](https://github.com/vLannaAi/noy-db/blob/main/SPEC.md)
+- Spec — [`SPEC.md`](https://github.com/vLannaAi/noy-db-docs/blob/main/SPEC.md)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noy-db/in-tanstack-table",
-  "version": "0.2.0-pre.8",
+  "version": "0.3.0-pre.1",
   "description": "TanStack Table bridge for noy-db — map Collection query state (sort, filter, pagination) into Table state and back, so a useSmartTable pattern drives the DB's query DSL without glue code.",
   "license": "MIT",
   "author": "vLannaAi <vicio@lanna.ai>",
@@ -17,17 +17,10 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
-  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -36,15 +29,15 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "peerDependencies": {
     "@tanstack/table-core": "^8.0.0",
-    "@noy-db/hub": "0.2.0-pre.8"
+    "@noy-db/hub": "0.3.0-pre.1"
   },
   "devDependencies": {
     "@tanstack/table-core": "^8.20.0",
-    "@noy-db/hub": "0.2.0-pre.8"
+    "@noy-db/hub": "0.3.0-pre.1"
   },
   "keywords": [
     "noy-db",

package/dist/index.cjs

@@ -1,79 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  buildQueryFromTableState: () => buildQueryFromTableState,
-  resetTableState: () => resetTableState,
-  tableStateFromQuery: () => tableStateFromQuery
-});
-module.exports = __toCommonJS(index_exports);
-function buildQueryFromTableState(query, state) {
-  let chain = query;
-  for (const filter of state.columnFilters ?? []) {
-    if (filter.value === void 0 || filter.value === null || filter.value === "") continue;
-    if (Array.isArray(filter.value)) {
-      chain = chain.where(filter.id, "in", filter.value);
-    } else {
-      chain = chain.where(filter.id, "==", filter.value);
-    }
-  }
-  for (const sort of state.sorting ?? []) {
-    chain = chain.orderBy(sort.id, sort.desc ? "desc" : "asc");
-  }
-  const pag = state.pagination;
-  if (pag) {
-    const offset = pag.pageIndex * pag.pageSize;
-    if (offset > 0) chain = chain.offset(offset);
-    if (pag.pageSize > 0) chain = chain.limit(pag.pageSize);
-  }
-  return chain;
-}
-function tableStateFromQuery(query) {
-  const q = query;
-  const columnFilters = q.__clauses?.filter((c) => c.op === "==" || c.op === "in").map((c) => ({ id: c.field, value: c.value }));
-  const sorting = q.__sorts?.map((s) => ({
-    id: s.field,
-    desc: s.direction === "desc"
-  }));
-  const pagination = q.__limit !== void 0 ? {
-    pageSize: q.__limit,
-    pageIndex: q.__offset && q.__limit ? Math.floor(q.__offset / q.__limit) : 0
-  } : void 0;
-  const state = {};
-  if (columnFilters && columnFilters.length > 0) state.columnFilters = columnFilters;
-  if (sorting && sorting.length > 0) state.sorting = sorting;
-  if (pagination) state.pagination = pagination;
-  return state;
-}
-function resetTableState(pageSize = 25) {
-  return {
-    sorting: [],
-    columnFilters: [],
-    pagination: { pageIndex: 0, pageSize }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildQueryFromTableState,
-  resetTableState,
-  tableStateFromQuery
-});
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/in-tanstack-table** — TanStack Table bridge for noy-db.\n *\n * Two-way binding between TanStack Table's state (sorting, filtering,\n * pagination) and noy-db's query DSL:\n *\n *   - {@link buildQueryFromTableState}  applies Table state to a\n *     noy-db `Query<T>` chain — the returned chain is ready for a\n *     terminal `.toArray()` / `.count()` / `.aggregate()`.\n *\n *   - {@link tableStateFromQuery}        pulls the Table-shaped state\n *     back out of a query chain, for consumers that want\n *     round-tripping (URL state, localStorage, etc.).\n *\n * This is a pure adapter — no React / Vue / Solid coupling. Pair with\n * the framework binding of your choice (`@tanstack/react-table`,\n * `@tanstack/vue-table`, …) to wire it up in a component.\n *\n * @packageDocumentation\n */\n\nimport type { Query } from '@noy-db/hub'\n\nexport interface TableSortDescriptor {\n  readonly id: string\n  readonly desc: boolean\n}\n\nexport interface TableFilterDescriptor {\n  readonly id: string\n  readonly value: unknown\n}\n\nexport interface TablePaginationState {\n  readonly pageIndex: number\n  readonly pageSize: number\n}\n\nexport interface TableState {\n  readonly sorting?: readonly TableSortDescriptor[]\n  readonly columnFilters?: readonly TableFilterDescriptor[]\n  readonly pagination?: TablePaginationState\n}\n\n/**\n * Apply TanStack Table state to a noy-db `Query<T>` chain. Filters\n * are applied as `.where(id, '==', value)`; sorts as repeated\n * `.orderBy(id, 'desc' | 'asc')`; pagination as `.offset().limit()`.\n *\n * Consumers that need richer operators (`in`, `>=`, range) should\n * extend this with a custom `filterMapper` argument — this adapter\n * covers the 80% case cleanly.\n */\nexport function buildQueryFromTableState<T>(\n  query: Query<T>,\n  state: TableState,\n): Query<T> {\n  let chain = query\n  for (const filter of state.columnFilters ?? []) {\n    if (filter.value === undefined || filter.value === null || filter.value === '') continue\n    // Treat arrays as `in`, everything else as `==`.\n    if (Array.isArray(filter.value)) {\n      chain = chain.where(filter.id as keyof T & string, 'in', filter.value as unknown[])\n    } else {\n      chain = chain.where(filter.id as keyof T & string, '==', filter.value)\n    }\n  }\n  for (const sort of state.sorting ?? []) {\n    chain = chain.orderBy(sort.id as keyof T & string, sort.desc ? 'desc' : 'asc')\n  }\n  const pag = state.pagination\n  if (pag) {\n    const offset = pag.pageIndex * pag.pageSize\n    if (offset > 0) chain = chain.offset(offset)\n    if (pag.pageSize > 0) chain = chain.limit(pag.pageSize)\n  }\n  return chain\n}\n\n/**\n * Extract TanStack-Table-shaped state from a query chain for\n * serialization (URL, localStorage). Returns only what the query has\n * explicitly set — undefined fields stay undefined.\n */\nexport function tableStateFromQuery<T>(query: Query<T>): TableState {\n  const q = query as unknown as {\n    __clauses?: Array<{ field: string; op: string; value: unknown }>\n    __sorts?: Array<{ field: string; direction: 'asc' | 'desc' }>\n    __limit?: number\n    __offset?: number\n  }\n\n  const columnFilters: TableFilterDescriptor[] | undefined = q.__clauses\n    ?.filter(c => c.op === '==' || c.op === 'in')\n    .map(c => ({ id: c.field, value: c.value }))\n  const sorting: TableSortDescriptor[] | undefined = q.__sorts?.map(s => ({\n    id: s.field,\n    desc: s.direction === 'desc',\n  }))\n  const pagination: TablePaginationState | undefined =\n    q.__limit !== undefined\n      ? {\n          pageSize: q.__limit,\n          pageIndex: q.__offset && q.__limit ? Math.floor(q.__offset / q.__limit) : 0,\n        }\n      : undefined\n\n  const state: TableState = {}\n  if (columnFilters && columnFilters.length > 0) (state as { columnFilters?: readonly TableFilterDescriptor[] }).columnFilters = columnFilters\n  if (sorting && sorting.length > 0) (state as { sorting?: readonly TableSortDescriptor[] }).sorting = sorting\n  if (pagination) (state as { pagination?: TablePaginationState }).pagination = pagination\n  return state\n}\n\n/**\n * Produce a `TableState` that represents \"no filter / no sort /\n * first-page pagination\". Useful as a reset function for user-facing\n * clear-all buttons.\n */\nexport function resetTableState(pageSize = 25): TableState {\n  return {\n    sorting: [],\n    columnFilters: [],\n    pagination: { pageIndex: 0, pageSize },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqDO,SAAS,yBACd,OACA,OACU;AACV,MAAI,QAAQ;AACZ,aAAW,UAAU,MAAM,iBAAiB,CAAC,GAAG;AAC9C,QAAI,OAAO,UAAU,UAAa,OAAO,UAAU,QAAQ,OAAO,UAAU,GAAI;AAEhF,QAAI,MAAM,QAAQ,OAAO,KAAK,GAAG;AAC/B,cAAQ,MAAM,MAAM,OAAO,IAAwB,MAAM,OAAO,KAAkB;AAAA,IACpF,OAAO;AACL,cAAQ,MAAM,MAAM,OAAO,IAAwB,MAAM,OAAO,KAAK;AAAA,IACvE;AAAA,EACF;AACA,aAAW,QAAQ,MAAM,WAAW,CAAC,GAAG;AACtC,YAAQ,MAAM,QAAQ,KAAK,IAAwB,KAAK,OAAO,SAAS,KAAK;AAAA,EAC/E;AACA,QAAM,MAAM,MAAM;AAClB,MAAI,KAAK;AACP,UAAM,SAAS,IAAI,YAAY,IAAI;AACnC,QAAI,SAAS,EAAG,SAAQ,MAAM,OAAO,MAAM;AAC3C,QAAI,IAAI,WAAW,EAAG,SAAQ,MAAM,MAAM,IAAI,QAAQ;AAAA,EACxD;AACA,SAAO;AACT;AAOO,SAAS,oBAAuB,OAA6B;AAClE,QAAM,IAAI;AAOV,QAAM,gBAAqD,EAAE,WACzD,OAAO,OAAK,EAAE,OAAO,QAAQ,EAAE,OAAO,IAAI,EAC3C,IAAI,QAAM,EAAE,IAAI,EAAE,OAAO,OAAO,EAAE,MAAM,EAAE;AAC7C,QAAM,UAA6C,EAAE,SAAS,IAAI,QAAM;AAAA,IACtE,IAAI,EAAE;AAAA,IACN,MAAM,EAAE,cAAc;AAAA,EACxB,EAAE;AACF,QAAM,aACJ,EAAE,YAAY,SACV;AAAA,IACE,UAAU,EAAE;AAAA,IACZ,WAAW,EAAE,YAAY,EAAE,UAAU,KAAK,MAAM,EAAE,WAAW,EAAE,OAAO,IAAI;AAAA,EAC5E,IACA;AAEN,QAAM,QAAoB,CAAC;AAC3B,MAAI,iBAAiB,cAAc,SAAS,EAAG,CAAC,MAA+D,gBAAgB;AAC/H,MAAI,WAAW,QAAQ,SAAS,EAAG,CAAC,MAAuD,UAAU;AACrG,MAAI,WAAY,CAAC,MAAgD,aAAa;AAC9E,SAAO;AACT;AAOO,SAAS,gBAAgB,WAAW,IAAgB;AACzD,SAAO;AAAA,IACL,SAAS,CAAC;AAAA,IACV,eAAe,CAAC;AAAA,IAChB,YAAY,EAAE,WAAW,GAAG,SAAS;AAAA,EACvC;AACF;","names":[]}

package/dist/index.d.cts

@@ -1,64 +0,0 @@
-import { Query } from '@noy-db/hub';
-
-/**
- * **@noy-db/in-tanstack-table** — TanStack Table bridge for noy-db.
- *
- * Two-way binding between TanStack Table's state (sorting, filtering,
- * pagination) and noy-db's query DSL:
- *
- *   - {@link buildQueryFromTableState}  applies Table state to a
- *     noy-db `Query<T>` chain — the returned chain is ready for a
- *     terminal `.toArray()` / `.count()` / `.aggregate()`.
- *
- *   - {@link tableStateFromQuery}        pulls the Table-shaped state
- *     back out of a query chain, for consumers that want
- *     round-tripping (URL state, localStorage, etc.).
- *
- * This is a pure adapter — no React / Vue / Solid coupling. Pair with
- * the framework binding of your choice (`@tanstack/react-table`,
- * `@tanstack/vue-table`, …) to wire it up in a component.
- *
- * @packageDocumentation
- */
-
-interface TableSortDescriptor {
-    readonly id: string;
-    readonly desc: boolean;
-}
-interface TableFilterDescriptor {
-    readonly id: string;
-    readonly value: unknown;
-}
-interface TablePaginationState {
-    readonly pageIndex: number;
-    readonly pageSize: number;
-}
-interface TableState {
-    readonly sorting?: readonly TableSortDescriptor[];
-    readonly columnFilters?: readonly TableFilterDescriptor[];
-    readonly pagination?: TablePaginationState;
-}
-/**
- * Apply TanStack Table state to a noy-db `Query<T>` chain. Filters
- * are applied as `.where(id, '==', value)`; sorts as repeated
- * `.orderBy(id, 'desc' | 'asc')`; pagination as `.offset().limit()`.
- *
- * Consumers that need richer operators (`in`, `>=`, range) should
- * extend this with a custom `filterMapper` argument — this adapter
- * covers the 80% case cleanly.
- */
-declare function buildQueryFromTableState<T>(query: Query<T>, state: TableState): Query<T>;
-/**
- * Extract TanStack-Table-shaped state from a query chain for
- * serialization (URL, localStorage). Returns only what the query has
- * explicitly set — undefined fields stay undefined.
- */
-declare function tableStateFromQuery<T>(query: Query<T>): TableState;
-/**
- * Produce a `TableState` that represents "no filter / no sort /
- * first-page pagination". Useful as a reset function for user-facing
- * clear-all buttons.
- */
-declare function resetTableState(pageSize?: number): TableState;
-
-export { type TableFilterDescriptor, type TablePaginationState, type TableSortDescriptor, type TableState, buildQueryFromTableState, resetTableState, tableStateFromQuery };