kokotable 0.95.0

package/contract/table-request.schema.json

@@ -0,0 +1,424 @@
+{
+  "$defs": {
+    "ColumnFilter": {
+      "properties": {
+        "id": {
+          "title": "Id",
+          "type": "string"
+        },
+        "value": {
+          "title": "Value"
+        }
+      },
+      "required": [
+        "id",
+        "value"
+      ],
+      "title": "ColumnFilter",
+      "type": "object"
+    },
+    "Pagination": {
+      "properties": {
+        "pageIndex": {
+          "default": 0,
+          "title": "Pageindex",
+          "type": "integer"
+        },
+        "pageSize": {
+          "default": 10,
+          "title": "Pagesize",
+          "type": "integer"
+        }
+      },
+      "title": "Pagination",
+      "type": "object"
+    },
+    "Sorting": {
+      "properties": {
+        "id": {
+          "title": "Id",
+          "type": "string"
+        },
+        "desc": {
+          "default": false,
+          "title": "Desc",
+          "type": "boolean"
+        },
+        "key": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Key"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "title": "Sorting",
+      "type": "object"
+    },
+    "StrictGroupExpansion": {
+      "additionalProperties": false,
+      "properties": {
+        "path": {
+          "default": [],
+          "items": {
+            "$ref": "#/$defs/StrictGroupPathItem"
+          },
+          "title": "Path",
+          "type": "array"
+        },
+        "offset": {
+          "default": 0,
+          "title": "Offset",
+          "type": "integer"
+        },
+        "limit": {
+          "default": 250,
+          "title": "Limit",
+          "type": "integer"
+        }
+      },
+      "title": "StrictGroupExpansion",
+      "type": "object"
+    },
+    "StrictGroupPathItem": {
+      "additionalProperties": false,
+      "properties": {
+        "key": {
+          "title": "Key",
+          "type": "string"
+        },
+        "value": {
+          "title": "Value"
+        }
+      },
+      "required": [
+        "key",
+        "value"
+      ],
+      "title": "StrictGroupPathItem",
+      "type": "object"
+    },
+    "StrictVirtualColumnDef": {
+      "additionalProperties": false,
+      "properties": {
+        "expr": {
+          "title": "Expr",
+          "type": "string"
+        },
+        "type": {
+          "default": "number",
+          "enum": [
+            "number",
+            "string",
+            "boolean"
+          ],
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "expr"
+      ],
+      "title": "StrictVirtualColumnDef",
+      "type": "object"
+    }
+  },
+  "additionalProperties": false,
+  "properties": {
+    "columnFilterFns": {
+      "additionalProperties": {
+        "anyOf": [
+          {
+            "enum": [
+              "equals",
+              "notEquals",
+              "lessThan",
+              "lessThanOrEqualTo",
+              "greaterThan",
+              "greaterThanOrEqualTo",
+              "contains",
+              "notContains",
+              "startsWith",
+              "endsWith",
+              "fuzzy",
+              "empty",
+              "notEmpty"
+            ],
+            "type": "string"
+          },
+          {
+            "enum": [
+              "equals",
+              "notEquals",
+              "lessThan",
+              "lessThanOrEqualTo",
+              "greaterThan",
+              "greaterThanOrEqualTo",
+              "between",
+              "betweenInclusive",
+              "outsideRange",
+              "isEmpty"
+            ],
+            "type": "string"
+          },
+          {
+            "enum": [
+              "equals",
+              "notEquals",
+              "lessThan",
+              "lessThanOrEqualTo",
+              "greaterThan",
+              "greaterThanOrEqualTo",
+              "between",
+              "betweenInclusive",
+              "dateBetween",
+              "inPeriod"
+            ],
+            "type": "string"
+          },
+          {
+            "enum": [
+              "in",
+              "notIn",
+              "between",
+              "arrIncludes",
+              "arrIncludesSome",
+              "arrIncludesAll",
+              "inArray",
+              "inArrayFilter",
+              "notInArray"
+            ],
+            "type": "string"
+          },
+          {
+            "enum": [
+              "hasAny",
+              "hasAll",
+              "hasChild",
+              "hasNotChild"
+            ],
+            "type": "string"
+          },
+          {
+            "enum": [
+              "linearExact",
+              "linearContains",
+              "linearExists"
+            ],
+            "type": "string"
+          },
+          {
+            "const": "equals",
+            "type": "string"
+          },
+          {
+            "enum": [
+              "scheduleContains",
+              "scheduleOverlaps"
+            ],
+            "type": "string"
+          },
+          {
+            "enum": [
+              "auto",
+              "custom"
+            ],
+            "type": "string"
+          }
+        ]
+      },
+      "default": {},
+      "title": "Columnfilterfns",
+      "type": "object"
+    },
+    "columnFilters": {
+      "default": [],
+      "items": {
+        "$ref": "#/$defs/ColumnFilter"
+      },
+      "title": "Columnfilters",
+      "type": "array"
+    },
+    "globalFilter": {
+      "default": "",
+      "title": "Globalfilter",
+      "type": "string"
+    },
+    "globalfilterFns": {
+      "anyOf": [
+        {
+          "enum": [
+            "equals",
+            "notEquals",
+            "lessThan",
+            "lessThanOrEqualTo",
+            "greaterThan",
+            "greaterThanOrEqualTo",
+            "contains",
+            "notContains",
+            "startsWith",
+            "endsWith",
+            "fuzzy",
+            "empty",
+            "notEmpty"
+          ],
+          "type": "string"
+        },
+        {
+          "enum": [
+            "equals",
+            "notEquals",
+            "lessThan",
+            "lessThanOrEqualTo",
+            "greaterThan",
+            "greaterThanOrEqualTo",
+            "between",
+            "betweenInclusive",
+            "outsideRange",
+            "isEmpty"
+          ],
+          "type": "string"
+        },
+        {
+          "enum": [
+            "equals",
+            "notEquals",
+            "lessThan",
+            "lessThanOrEqualTo",
+            "greaterThan",
+            "greaterThanOrEqualTo",
+            "between",
+            "betweenInclusive",
+            "dateBetween",
+            "inPeriod"
+          ],
+          "type": "string"
+        },
+        {
+          "enum": [
+            "in",
+            "notIn",
+            "between",
+            "arrIncludes",
+            "arrIncludesSome",
+            "arrIncludesAll",
+            "inArray",
+            "inArrayFilter",
+            "notInArray"
+          ],
+          "type": "string"
+        },
+        {
+          "enum": [
+            "hasAny",
+            "hasAll",
+            "hasChild",
+            "hasNotChild"
+          ],
+          "type": "string"
+        },
+        {
+          "enum": [
+            "linearExact",
+            "linearContains",
+            "linearExists"
+          ],
+          "type": "string"
+        },
+        {
+          "const": "equals",
+          "type": "string"
+        },
+        {
+          "enum": [
+            "scheduleContains",
+            "scheduleOverlaps"
+          ],
+          "type": "string"
+        },
+        {
+          "enum": [
+            "auto",
+            "custom"
+          ],
+          "type": "string"
+        }
+      ],
+      "default": "contains",
+      "title": "Globalfilterfns"
+    },
+    "virtualColumns": {
+      "additionalProperties": {
+        "$ref": "#/$defs/StrictVirtualColumnDef"
+      },
+      "default": {},
+      "title": "Virtualcolumns",
+      "type": "object"
+    },
+    "pagination": {
+      "$ref": "#/$defs/Pagination",
+      "default": {
+        "pageIndex": 0,
+        "pageSize": 10
+      }
+    },
+    "sorting": {
+      "default": [],
+      "items": {
+        "$ref": "#/$defs/Sorting"
+      },
+      "title": "Sorting",
+      "type": "array"
+    },
+    "grouping": {
+      "default": [],
+      "items": {
+        "type": "string"
+      },
+      "title": "Grouping",
+      "type": "array"
+    },
+    "groupExpansion": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/StrictGroupExpansion"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "aggregation": {
+      "anyOf": [
+        {
+          "additionalProperties": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Aggregation"
+    }
+  },
+  "title": "TableRequest",
+  "type": "object",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/kokotu0/koko-table/contract/table-request.schema.json",
+  "$comment": "ERP back `core/base/QueryBuilder/types.py` (koko-table-eval 레인 커밋 599bbeb96, 2026-09-06) 의 pydantic TableRequest 에 extra=forbid 를 씌워 생성. 재생성: scripts/contract/export-schema.py 를 백엔드 환경에서 실행."
+}

package/dist/core/src/adapters/sources.d.ts

@@ -0,0 +1,59 @@
+import type { RowData, Table } from "@tanstack/react-table";
+import type { ContentSource, FilterSource, PaginationSource, SelectionSource, SortSource } from "../types/sources";
+import type { TableSearch } from "../types/search";
+import type { TableData } from "../types/data";
+import type { AnyContentSource, AnyFilterSource, AnyPaginationSource, AnySelectionSource, AnySortSource } from "../types/table";
+/**
+ * 어댑터 — 테이블 인스턴스를 좁은 계약으로 좁힌다.
+ *
+ * MRT 를 걷어내면 `MRT_TableHeadCellFilterContainer` 가 하던
+ * "헤더 -> { value, onChange, operator }" 변환을 어차피 직접 짜야 한다.
+ * 그 변환의 결과 타입을 `FilterSource` 로 고정한 것이 이 어댑터고,
+ * 그래서 `TableSearch` 도 같은 자리에 꽂힌다 — 추가 비용이 거의 없다.
+ */
+export declare function isFilterSource(value: unknown): value is FilterSource;
+export declare function isPaginationSource(value: unknown): value is PaginationSource;
+export declare function isSelectionSource<T>(value: unknown): value is SelectionSource<T>;
+/**
+ * TanStack 인스턴스에서 필터 필드를 뽑는다.
+ *
+ * 대상 컬럼은 `getAllLeafColumns()` 기준이다 — 숨김·그룹핑으로
+ * `getLeafHeaders()` 에서 빠진 컬럼도 필터는 살아 있어야 하기 때문.
+ *
+ * `useDataTable` 로 만든 인스턴스는 `search` 를 들고 있으므로 그쪽에 위임한다.
+ * 그래야 값이 draft 한 곳에서만 관리된다 (이중 소스 방지).
+ */
+export declare function filterSourceFromTable<T extends RowData>(table: Table<T>): FilterSource;
+/**
+ * 페이지네이션 계약 — 현재 페이지는 검색 상태가, 총 건수는 데이터가 안다.
+ * 둘을 합쳐야 비로소 `PaginationSource` 가 성립한다.
+ */
+export declare function paginationSource<T extends RowData>(search: TableSearch<T>, data: TableData<T>): PaginationSource;
+export declare function paginationSourceFromTable<T extends RowData>(table: Table<T>): PaginationSource;
+export declare function selectionSourceFromTable<T extends RowData>(table: Table<T>): SelectionSource<T>;
+/** 컴포넌트 진입점에서 한 번 정규화한다 */
+export declare function toFilterSource<T extends RowData>(src: AnyFilterSource<T>): FilterSource;
+export declare function toPaginationSource<T extends RowData>(src: AnyPaginationSource<T>): PaginationSource;
+export declare function toSelectionSource<T extends RowData>(src: AnySelectionSource<T>): SelectionSource<T>;
+/**
+ * 콘텐츠 구역 — 데이터에서 직접.
+ * 카드 그리드·차트처럼 테이블 인스턴스가 없는 화면이 쓰는 경로다.
+ */
+export declare function contentSource<T extends RowData>(data: TableData<T>): ContentSource<T>;
+/**
+ * 콘텐츠 구역 — 테이블 인스턴스에서.
+ * `useDataTable` 로 만든 인스턴스는 `data` 를 들고 있으므로 상태를 그대로 쓴다.
+ */
+export declare function contentSourceFromTable<T extends RowData>(table: Table<T>): ContentSource<T>;
+export declare function isContentSource<T>(value: unknown): value is ContentSource<T>;
+export declare function toContentSource<T extends RowData>(src: AnyContentSource<T>): ContentSource<T>;
+/**
+ * 정렬 계약 — 검색 상태에서.
+ *
+ * 토글 순환은 TanStack 기본과 같다: 해제 -> 오름차순 -> 내림차순 -> 해제.
+ * `multi` 를 주면 기존 정렬을 유지한 채 뒤에 붙인다.
+ */
+export declare function sortSource<T extends RowData>(search: TableSearch<T>): SortSource;
+export declare function sortSourceFromTable<T extends RowData>(table: Table<T>): SortSource;
+export declare function isSortSource(value: unknown): value is SortSource;
+export declare function toSortSource<T extends RowData>(src: AnySortSource<T>): SortSource;