@x12i/data 1.0.0 → 1.1.0

package/dist/index.js

@@ -1,55 +1,219 @@
-// src/index.ts
-function defineColumns(columns) {
-  return columns;
-}
-var SAVED_VIEW_VERSION = 1;
-var FILTER_OPERATORS = [
-  "contains",
-  "not-contains",
-  "starts-with",
-  "equals",
-  "not-equals",
-  "gt",
-  "gte",
-  "lt",
-  "lte",
-  "between",
-  "in",
-  "before",
-  "after",
-  "is-empty",
-  "is-not-empty"
-];
-var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var isOptionalNumber = (value) => value === void 0 || typeof value === "number" && Number.isFinite(value);
-function parseSavedView(value) {
-  if (!isRecord(value) || value.version !== SAVED_VIEW_VERSION) return null;
-  if (value.name !== void 0 && typeof value.name !== "string") return null;
-  const { columns, sort, filter, group } = value;
-  if (!Array.isArray(columns) || !Array.isArray(sort) || !Array.isArray(filter)) return null;
-  if (group !== void 0 && !Array.isArray(group)) return null;
-  for (const column of columns) {
-    if (!isRecord(column) || typeof column.id !== "string") return null;
-    if (!isOptionalNumber(column.width)) return null;
-    if (column.hidden !== void 0 && typeof column.hidden !== "boolean") return null;
-    if (column.pinned !== void 0 && column.pinned !== "start" && column.pinned !== "end") {
-      return null;
-    }
-  }
-  for (const item of sort) {
-    if (!isRecord(item) || typeof item.field !== "string") return null;
-    if (item.direction !== "asc" && item.direction !== "desc") return null;
-  }
-  for (const item of filter) {
-    if (!isRecord(item) || typeof item.field !== "string") return null;
-    if (!FILTER_OPERATORS.includes(item.operator)) return null;
-  }
-  for (const item of group ?? []) {
-    if (!isRecord(item) || typeof item.field !== "string") return null;
-  }
-  return value;
-}
-
-export { FILTER_OPERATORS, SAVED_VIEW_VERSION, defineColumns, parseSavedView };
-//# sourceMappingURL=index.js.map
+import {
+  DEFAULT_COLUMN_MAX_WIDTH,
+  DEFAULT_COLUMN_MIN_WIDTH,
+  DEFAULT_COLUMN_WIDTH,
+  EMPTY_SELECTION,
+  FILTER_OPERATORS,
+  OPERATORS_BY_FILTER_TYPE,
+  SAVED_VIEW_VERSION,
+  aggregateValues,
+  applySavedView,
+  buildDisplayRows,
+  buildGroupTree,
+  captureView,
+  clampColumnWidth,
+  clampNav,
+  clearSelection,
+  columnFieldName,
+  compareValues,
+  computeAggregate,
+  computeAggregates,
+  computeViewIndexes,
+  countSelected,
+  createAbortError,
+  createCellFormatter,
+  createClientDataSource,
+  createCollator,
+  createLocalStorageSavedViewStore,
+  createMemorySavedViewStore,
+  createSearchIndex,
+  createSelection,
+  createServerRowStore,
+  createValuePredicate,
+  createViewState,
+  dayStart,
+  defaultFormatLabels,
+  defaultMessages,
+  defineColumns,
+  deserializeSelection,
+  distinctValues,
+  escapeCsvField,
+  escapeDelimitedField,
+  exportableColumns,
+  filterIndexes,
+  formatCellValue,
+  formatMessage,
+  fromServerQuery,
+  getColumnValue,
+  gridToCsv,
+  gridToTsv,
+  indexColumns,
+  initialColumnWidth,
+  isAbortError,
+  isDateOnlyString,
+  isEditable,
+  isEmptyValue,
+  isFilterEffective,
+  isFilterable,
+  isNavigationKey,
+  isNumericCellType,
+  isResizable,
+  isSearchable,
+  isSelected,
+  isSelectionEmpty,
+  isSortable,
+  isValuelessOperator,
+  layoutColumns,
+  matchesFilter,
+  moveColumn,
+  moveColumnTo,
+  navigate,
+  nextDay,
+  normalizeText,
+  operatorsFor,
+  parseDelimited,
+  parseQuickFilter,
+  parseSavedView,
+  resizeColumn,
+  resolveColumnAlign,
+  resolveColumnOrder,
+  resolveDateFormatOptions,
+  resolveEditor,
+  resolveFilterType,
+  resolveMessages,
+  resolveNumberFormatOptions,
+  resolveSelectedIds,
+  selectAll,
+  selectAllExceptNone,
+  selectOnly,
+  selectRange,
+  serializeSelection,
+  setColumnFilter,
+  setPinning,
+  setSort,
+  sortIndexes,
+  sortRank,
+  sortRows,
+  summarizeSelection,
+  toBoolean,
+  toDate,
+  toDayString,
+  toNumber,
+  toServerQuery,
+  toSortKey,
+  toText,
+  toTimestamp,
+  toggleGroup,
+  toggleRow,
+  toggleSort
+} from "./chunk-ASP4ABDG.js";
+export {
+  DEFAULT_COLUMN_MAX_WIDTH,
+  DEFAULT_COLUMN_MIN_WIDTH,
+  DEFAULT_COLUMN_WIDTH,
+  EMPTY_SELECTION,
+  FILTER_OPERATORS,
+  OPERATORS_BY_FILTER_TYPE,
+  SAVED_VIEW_VERSION,
+  aggregateValues,
+  applySavedView,
+  buildDisplayRows,
+  buildGroupTree,
+  captureView,
+  clampColumnWidth,
+  clampNav,
+  clearSelection,
+  columnFieldName,
+  compareValues,
+  computeAggregate,
+  computeAggregates,
+  computeViewIndexes,
+  countSelected,
+  createAbortError,
+  createCellFormatter,
+  createClientDataSource,
+  createCollator,
+  createLocalStorageSavedViewStore,
+  createMemorySavedViewStore,
+  createSearchIndex,
+  createSelection,
+  createServerRowStore,
+  createValuePredicate,
+  createViewState,
+  dayStart,
+  defaultFormatLabels,
+  defaultMessages,
+  defineColumns,
+  deserializeSelection,
+  distinctValues,
+  escapeCsvField,
+  escapeDelimitedField,
+  exportableColumns,
+  filterIndexes,
+  formatCellValue,
+  formatMessage,
+  fromServerQuery,
+  getColumnValue,
+  gridToCsv,
+  gridToTsv,
+  indexColumns,
+  initialColumnWidth,
+  isAbortError,
+  isDateOnlyString,
+  isEditable,
+  isEmptyValue,
+  isFilterEffective,
+  isFilterable,
+  isNavigationKey,
+  isNumericCellType,
+  isResizable,
+  isSearchable,
+  isSelected,
+  isSelectionEmpty,
+  isSortable,
+  isValuelessOperator,
+  layoutColumns,
+  matchesFilter,
+  moveColumn,
+  moveColumnTo,
+  navigate,
+  nextDay,
+  normalizeText,
+  operatorsFor,
+  parseDelimited,
+  parseQuickFilter,
+  parseSavedView,
+  resizeColumn,
+  resolveColumnAlign,
+  resolveColumnOrder,
+  resolveDateFormatOptions,
+  resolveEditor,
+  resolveFilterType,
+  resolveMessages,
+  resolveNumberFormatOptions,
+  resolveSelectedIds,
+  selectAll,
+  selectAllExceptNone,
+  selectOnly,
+  selectRange,
+  serializeSelection,
+  setColumnFilter,
+  setPinning,
+  setSort,
+  sortIndexes,
+  sortRank,
+  sortRows,
+  summarizeSelection,
+  toBoolean,
+  toDate,
+  toDayString,
+  toNumber,
+  toServerQuery,
+  toSortKey,
+  toText,
+  toTimestamp,
+  toggleGroup,
+  toggleRow,
+  toggleSort
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAuGO,SAAS,cAAmB,OAAA,EAA6C;AAC9E,EAAA,OAAO,OAAA;AACT;AASO,IAAM,kBAAA,GAAqB;AAa3B,IAAM,gBAAA,GAAmB;AAAA,EAC9B,UAAA;AAAA,EACA,cAAA;AAAA,EACA,aAAA;AAAA,EACA,QAAA;AAAA,EACA,YAAA;AAAA,EACA,IAAA;AAAA,EACA,KAAA;AAAA,EACA,IAAA;AAAA,EACA,KAAA;AAAA,EACA,SAAA;AAAA,EACA,IAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AASA,IAAM,QAAA,GAAW,CAAC,KAAA,KAChB,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,IAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA;AAErE,IAAM,gBAAA,GAAmB,CAAC,KAAA,KACxB,KAAA,KAAU,MAAA,IAAc,OAAO,KAAA,KAAU,QAAA,IAAY,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA;AAOrE,SAAS,eAAe,KAAA,EAAkC;AAC/D,EAAA,IAAI,CAAC,QAAA,CAAS,KAAK,KAAK,KAAA,CAAM,OAAA,KAAY,oBAAoB,OAAO,IAAA;AACrE,EAAA,IAAI,MAAM,IAAA,KAAS,MAAA,IAAa,OAAO,KAAA,CAAM,IAAA,KAAS,UAAU,OAAO,IAAA;AAEvE,EAAA,MAAM,EAAE,OAAA,EAAS,IAAA,EAAM,MAAA,EAAQ,OAAM,GAAI,KAAA;AACzC,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,KAAK,CAAC,KAAA,CAAM,OAAA,CAAQ,IAAI,KAAK,CAAC,KAAA,CAAM,OAAA,CAAQ,MAAM,GAAG,OAAO,IAAA;AACtF,EAAA,IAAI,UAAU,MAAA,IAAa,CAAC,MAAM,OAAA,CAAQ,KAAK,GAAG,OAAO,IAAA;AAEzD,EAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,IAAA,IAAI,CAAC,SAAS,MAAM,CAAA,IAAK,OAAO,MAAA,CAAO,EAAA,KAAO,UAAU,OAAO,IAAA;AAC/D,IAAA,IAAI,CAAC,gBAAA,CAAiB,MAAA,CAAO,KAAK,GAAG,OAAO,IAAA;AAC5C,IAAA,IAAI,OAAO,MAAA,KAAW,MAAA,IAAa,OAAO,MAAA,CAAO,MAAA,KAAW,WAAW,OAAO,IAAA;AAC9E,IAAA,IAAI,MAAA,CAAO,WAAW,MAAA,IAAa,MAAA,CAAO,WAAW,OAAA,IAAW,MAAA,CAAO,WAAW,KAAA,EAAO;AACvF,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,KAAA,MAAW,QAAQ,IAAA,EAAM;AACvB,IAAA,IAAI,CAAC,SAAS,IAAI,CAAA,IAAK,OAAO,IAAA,CAAK,KAAA,KAAU,UAAU,OAAO,IAAA;AAC9D,IAAA,IAAI,KAAK,SAAA,KAAc,KAAA,IAAS,IAAA,CAAK,SAAA,KAAc,QAAQ,OAAO,IAAA;AAAA,EACpE;AACA,EAAA,KAAA,MAAW,QAAQ,MAAA,EAAQ;AACzB,IAAA,IAAI,CAAC,SAAS,IAAI,CAAA,IAAK,OAAO,IAAA,CAAK,KAAA,KAAU,UAAU,OAAO,IAAA;AAC9D,IAAA,IAAI,CAAE,gBAAA,CAAwC,QAAA,CAAS,IAAA,CAAK,QAAQ,GAAG,OAAO,IAAA;AAAA,EAChF;AACA,EAAA,KAAA,MAAW,IAAA,IAAQ,KAAA,IAAS,EAAC,EAAG;AAC9B,IAAA,IAAI,CAAC,SAAS,IAAI,CAAA,IAAK,OAAO,IAAA,CAAK,KAAA,KAAU,UAAU,OAAO,IAAA;AAAA,EAChE;AAEA,EAAA,OAAO,KAAA;AACT","file":"index.js","sourcesContent":["/**\r\n * Contracts for the kit's DataGrid (spec section 7). The grid is built on\r\n * TanStack Table and TanStack Virtual; these types are the stable surface that\r\n * apps, reports and charts depend on.\r\n */\r\n\r\nexport type SortDirection = \"asc\" | \"desc\";\r\n\r\nexport interface SortModelItem {\r\n  field: string;\r\n  direction: SortDirection;\r\n}\r\n\r\nexport type FilterOperator =\r\n  | \"contains\"\r\n  | \"not-contains\"\r\n  | \"starts-with\"\r\n  | \"equals\"\r\n  | \"not-equals\"\r\n  | \"gt\"\r\n  | \"gte\"\r\n  | \"lt\"\r\n  | \"lte\"\r\n  | \"between\"\r\n  | \"in\"\r\n  | \"before\"\r\n  | \"after\"\r\n  | \"is-empty\"\r\n  | \"is-not-empty\";\r\n\r\nexport interface FilterModelItem {\r\n  field: string;\r\n  operator: FilterOperator;\r\n  /** Absent for `is-empty` and `is-not-empty`. An array for `in` and `between`. */\r\n  value?: unknown;\r\n}\r\n\r\nexport interface GroupModelItem {\r\n  field: string;\r\n}\r\n\r\n/** What the grid asks a server for. Row indexes are zero-based and `endRow` is exclusive. */\r\nexport interface GetRowsRequest {\r\n  startRow: number;\r\n  endRow: number;\r\n  sort: SortModelItem[];\r\n  filter: FilterModelItem[];\r\n  group: GroupModelItem[];\r\n}\r\n\r\nexport interface GetRowsResult<Row> {\r\n  rows: Row[];\r\n  /** Total rows matching the filter, so the grid can size its scrollbar. */\r\n  total: number;\r\n}\r\n\r\nexport interface GetRowsOptions {\r\n  /** Aborted when the grid no longer needs the answer, for example after a new sort. */\r\n  signal?: AbortSignal;\r\n}\r\n\r\n/** The server data source: `getRows({ startRow, endRow, sort, filter, group })` returns `{ rows, total }`. */\r\nexport interface ServerDataSource<Row> {\r\n  getRows(request: GetRowsRequest, options?: GetRowsOptions): Promise<GetRowsResult<Row>>;\r\n}\r\n\r\n/** Cell renderers the grid ships (spec section 7). */\r\nexport type CellType =\r\n  | \"text\"\r\n  | \"number\"\r\n  | \"currency\"\r\n  | \"percent\"\r\n  | \"date\"\r\n  | \"status\"\r\n  | \"avatar\"\r\n  | \"progress\"\r\n  | \"sparkline\"\r\n  | \"link\"\r\n  | \"actions\";\r\n\r\n/** Logical sides, so a pinned column follows the reading direction in RTL. */\r\nexport type ColumnPin = \"start\" | \"end\";\r\n\r\nexport interface ColumnDef<Row> {\r\n  /** Stable identifier, also used in saved views. */\r\n  id: string;\r\n  /** Header text. Pass a translated string. */\r\n  header: string;\r\n  /** Property of the row to read. */\r\n  field?: Extract<keyof Row, string>;\r\n  cellType?: CellType;\r\n  /** An `Intl`-based format name or options key, by cell type. */\r\n  format?: string;\r\n  width?: number;\r\n  minWidth?: number;\r\n  pinned?: ColumnPin;\r\n  sortable?: boolean;\r\n  filterable?: boolean;\r\n  resizable?: boolean;\r\n  editable?: boolean;\r\n}\r\n\r\n/** Identity helper that infers `Row` for column authoring. */\r\nexport function defineColumns<Row>(columns: ColumnDef<Row>[]): ColumnDef<Row>[] {\r\n  return columns;\r\n}\r\n\r\nexport interface ColumnState {\r\n  id: string;\r\n  width?: number;\r\n  hidden?: boolean;\r\n  pinned?: ColumnPin;\r\n}\r\n\r\nexport const SAVED_VIEW_VERSION = 1;\r\n\r\n/** Column state, filters and sort, serialized to JSON. */\r\nexport interface SavedView {\r\n  version: typeof SAVED_VIEW_VERSION;\r\n  name?: string;\r\n  columns: ColumnState[];\r\n  sort: SortModelItem[];\r\n  filter: FilterModelItem[];\r\n  group?: GroupModelItem[];\r\n}\r\n\n/** Every filter operator, as a runtime list for validation and pickers. */\nexport const FILTER_OPERATORS = [\n  \"contains\",\n  \"not-contains\",\n  \"starts-with\",\n  \"equals\",\n  \"not-equals\",\n  \"gt\",\n  \"gte\",\n  \"lt\",\n  \"lte\",\n  \"between\",\n  \"in\",\n  \"before\",\n  \"after\",\n  \"is-empty\",\n  \"is-not-empty\",\n] as const satisfies readonly FilterOperator[];\n\n// Compile-time guard: adding an operator to `FilterOperator` without listing it\n// above makes this line fail to type-check.\nconst _everyOperatorListed: Exclude<FilterOperator, (typeof FILTER_OPERATORS)[number]> extends never\n  ? true\n  : never = true;\nvoid _everyOperatorListed;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst isOptionalNumber = (value: unknown) =>\n  value === undefined || (typeof value === \"number\" && Number.isFinite(value));\n\n/**\n * Reads a saved view from untrusted JSON (storage, a URL, a server). Returns\n * `null` when the value is not a view this version understands, so a bad or\n * newer record is ignored instead of crashing the grid.\n */\nexport function parseSavedView(value: unknown): SavedView | null {\n  if (!isRecord(value) || value.version !== SAVED_VIEW_VERSION) return null;\n  if (value.name !== undefined && typeof value.name !== \"string\") return null;\n\n  const { columns, sort, filter, group } = value;\n  if (!Array.isArray(columns) || !Array.isArray(sort) || !Array.isArray(filter)) return null;\n  if (group !== undefined && !Array.isArray(group)) return null;\n\n  for (const column of columns) {\n    if (!isRecord(column) || typeof column.id !== \"string\") return null;\n    if (!isOptionalNumber(column.width)) return null;\n    if (column.hidden !== undefined && typeof column.hidden !== \"boolean\") return null;\n    if (column.pinned !== undefined && column.pinned !== \"start\" && column.pinned !== \"end\") {\n      return null;\n    }\n  }\n  for (const item of sort) {\n    if (!isRecord(item) || typeof item.field !== \"string\") return null;\n    if (item.direction !== \"asc\" && item.direction !== \"desc\") return null;\n  }\n  for (const item of filter) {\n    if (!isRecord(item) || typeof item.field !== \"string\") return null;\n    if (!(FILTER_OPERATORS as readonly unknown[]).includes(item.operator)) return null;\n  }\n  for (const item of group ?? []) {\n    if (!isRecord(item) || typeof item.field !== \"string\") return null;\n  }\n\n  return value as unknown as SavedView;\n}\n\n/** One saved view in a list, without loading its body. */\nexport interface SavedViewSummary {\n  id: string;\n  name?: string;\n}\n\n/**\n * Where an app keeps saved views. The grid does not care: pass any\n * implementation (local storage, your API, `@x12i/flowix-ui`'s Flowix adapter).\n */\nexport interface SavedViewStore {\n  list(): Promise<SavedViewSummary[]>;\n  /** `null` when the id does not exist or holds something `parseSavedView` rejects. */\n  load(id: string): Promise<SavedView | null>;\n  save(id: string, view: SavedView): Promise<void>;\n  delete(id: string): Promise<void>;\n}\n"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}