@gp-grid/core 0.20.0 → 0.22.0

package/README.md

@@ -37,6 +37,7 @@ A framework-agnostic TypeScript library for building high-performance data grids
 
 - [**@gp-grid/react**](https://www.npmjs.com/package/@gp-grid/react) | Official
 - [**@gp-grid/vue**](https://www.npmjs.com/package/@gp-grid/vue) | Official
+- [**@gp-grid/angular**](https://www.npmjs.com/package/@gp-grid/angular) | Official
 
 ## Philosophy
 

package/dist/index.d.ts

@@ -255,6 +255,14 @@ interface ColumnDefinition {
    * for cells whose custom renderer already provides its own tooltip.
    */
   tooltip?: boolean;
+  /**
+   * Whether long cell text wraps onto additional lines instead of being
+   * truncated with an ellipsis. Wrapped text is clipped to the fixed row
+   * height (rows do not auto-grow) — use `peekable` (double-click) or the
+   * native `tooltip` to read the full value. Only affects the default text
+   * renderer, not custom `cellRenderer` output. Default: false.
+   */
+  wrapText?: boolean;
   /** Renderer key for adapter lookup, or inline renderer function */
   cellRenderer?: string | ((params: CellRendererParams) => unknown);
   editRenderer?: string | ((params: EditRendererParams) => unknown);
@@ -2904,37 +2912,6 @@ declare const labelsForSelectedValues: (entries: readonly DistinctValueEntry[],
  */
 declare const rawValuesForLabels: (entries: readonly DistinctValueEntry[], labels: ReadonlySet<string>) => Set<CellValue>;
 //#endregion
-//#region src/styles/variables.d.ts
-declare const variablesStyles: string;
-//#endregion
-//#region src/styles/container.d.ts
-declare const containerStyles: string;
-//#endregion
-//#region src/styles/header.d.ts
-declare const headerStyles: string;
-//#endregion
-//#region src/styles/cells.d.ts
-declare const cellStyles: string;
-//#endregion
-//#region src/styles/states.d.ts
-declare const statesStyles: string;
-//#endregion
-//#region src/styles/scrollbar.d.ts
-declare const scrollbarStyles: string;
-//#endregion
-//#region src/styles/filters.d.ts
-declare const filtersStyles: string;
-//#endregion
-//#region src/styles/row-drag.d.ts
-declare const rowDragStyles: string;
-//#endregion
-//#region src/styles/index.d.ts
-/**
- * Combined grid styles from all modules.
- * Use `@gp-grid/core/dist/styles.css` in your app instead of consuming this directly.
- */
-declare const gridStyles: string;
-//#endregion
 //#region src/state-reducer.d.ts
 /**
  * Apply a single instruction to mutable slot/header Maps and return
@@ -2944,6 +2921,106 @@ declare const gridStyles: string;
  */
 declare const applyInstruction: <TData = unknown>(instruction: GridInstruction, slots: Map<string, SlotData<TData>>, headers: Map<number, HeaderData>) => Partial<GridState<TData>> | null;
 //#endregion
+//#region src/i18n.d.ts
+/** Labels for the filter operator dropdowns, keyed by semantic meaning. */
+interface GridFilterOperatorLabels {
+  /** Text operator: contains */
+  contains: string;
+  /** Text operator: does not contain */
+  notContains: string;
+  /** Text operator: starts with */
+  startsWith: string;
+  /** Text operator: ends with */
+  endsWith: string;
+  /** Shared "equals" (= for number/date, equals for text) */
+  equals: string;
+  /** Shared "does not equal" (!= / notEquals) */
+  notEquals: string;
+  /** Number/date operator: greater than */
+  greaterThan: string;
+  /** Number/date operator: less than */
+  lessThan: string;
+  /** Number operator: greater than or equal */
+  greaterThanOrEqual: string;
+  /** Number operator: less than or equal */
+  lessThanOrEqual: string;
+  /** Number/date operator: between */
+  between: string;
+  /** Shared "is blank" operator */
+  blank: string;
+  /** Shared "is not blank" operator */
+  notBlank: string;
+}
+/**
+ * All user-visible grid labels. Strings containing `{token}` placeholders are
+ * templates interpolated by {@link formatLabel}; the documented tokens are
+ * `{column}`, `{count}`, and `{message}`.
+ */
+interface GridLabels {
+  /** Filter popup title template. Token: `{column}`. */
+  filterTitle: string;
+  /** Combination toggle: AND */
+  and: string;
+  /** Combination toggle: OR */
+  or: string;
+  /** Filter value input placeholder */
+  valuePlaceholder: string;
+  /** "between" second-input separator */
+  betweenSeparator: string;
+  /** "+ Add condition" button */
+  addCondition: string;
+  /** Remove-condition button glyph */
+  removeCondition: string;
+  /** Clear button */
+  clear: string;
+  /** Apply button */
+  apply: string;
+  /** Values mode toggle */
+  valuesMode: string;
+  /** Condition mode toggle */
+  conditionMode: string;
+  /** Values-mode search input placeholder */
+  searchPlaceholder: string;
+  /** Select all button */
+  selectAll: string;
+  /** Deselect all button */
+  deselectAll: string;
+  /** "(Blanks)" checkbox label */
+  blanks: string;
+  /** Too-many-values message template. Token: `{count}`. */
+  tooManyValues: string;
+  /** Empty grid message */
+  emptyState: string;
+  /** Error message prefix template. Token: `{message}`. */
+  errorPrefix: string;
+  /** Filter operator labels */
+  operators: GridFilterOperatorLabels;
+}
+/** English defaults for every grid label. */
+declare const defaultGridLabels: GridLabels;
+/**
+ * Merge a partial label set over the English defaults, producing a complete
+ * `GridLabels`. Top-level keys are shallow-merged and `operators` is merged
+ * one level deep; the defaults are never mutated.
+ */
+declare const resolveGridLabels: (overrides?: Partial<GridLabels>) => GridLabels;
+/**
+ * Interpolate `{token}` placeholders in a label template. Unknown tokens are
+ * left untouched and missing params are skipped, so this never throws.
+ */
+declare const formatLabel: (template: string, params?: Record<string, string | number>) => string;
+/** A single operator option rendered in a filter dropdown. */
+interface FilterOperatorOption<TOperator extends string = string> {
+  value: TOperator;
+  label: string;
+}
+/** Text filter operators in display order. */
+declare const getTextOperatorOptions: (labels: GridLabels) => FilterOperatorOption<TextFilterOperator>[];
+/** Number filter operators in display order. */
+declare const getNumberOperatorOptions: (labels: GridLabels) => FilterOperatorOption<NumberFilterOperator>[];
+/** Date filter operators in display order. */
+declare const getDateOperatorOptions: (labels: GridLabels) => FilterOperatorOption<DateFilterOperator>[];
+//#endregion
 //#region src/adapter/pointer-event.d.ts
 /**
  * Convert a DOM PointerEvent into the framework-agnostic PointerEventData
@@ -3293,4 +3370,4 @@ declare class InputEventAdapter<TData = unknown> {
   private dispatchCellDragStart;
 }
 //#endregion
-export { type AssignSlotInstruction, AutoScrollDriver, type BatchChangeSetters, type BatchInstructionListener, type CalculateFillHandlePositionParams, type CancelColumnMoveInstruction, type CancelColumnResizeInstruction, type CancelFillInstruction, type CancelRowDragInstruction, type CellDataType, type CellPointerAction, type CellPosition, type CellRange, type CellRendererParams, type CellValue, type CellValueChangedEvent, type CloseFilterPopupInstruction, type ColumnDefinition, type ColumnFilterModel, type ColumnMoveDragState, type ColumnResizeDragState, type ColumnScrollGeometry, type ColumnsChangedInstruction, type CommitColumnMoveInstruction, type CommitColumnResizeInstruction, type CommitEditInstruction, type CommitFillInstruction, type CommitRowDragInstruction, type ContainerBounds, type CreateSlotInstruction, type DataChangeListener, type DataErrorInstruction, type DataLoadedInstruction, type DataLoadingInstruction, type DataSource, type DataSourceLoadMode, DataSourceOwner, type DataSourceRange, type DataSourceRequest, type DataSourceResponse, type DateFilterCondition, type DateFilterOperator, type DestroySlotInstruction, type Direction, type DistinctValueEntry, type DragEndResult, type DragMoveResult, type DragState, EditManager, type EditManagerOptions, type EditRendererParams, type EditState, type FillHandlePosition, type FillHandleState, FillManager, type FillPointerAction, type FilterCombination, type FilterCondition, type FilterModel, type FilterPopupState, GridCore, type GridCoreOptions, type GridInstruction, type GridState, type HeaderData, type HeaderRendererParams, type HighlightContext, HighlightManager, type HighlightingOptions, IndexedDataStore, type IndexedDataStoreOptions, type InitialStateArgs, InputEventAdapter, type InputEventAdapterDeps, InputHandler, type InputHandlerDeps, type InputResult, type InstructionListener, type KeyEventData, type KeyboardResult, type MoveSlotInstruction, type MultiColumnSortedChunk, type MutableClientDataSourceOptions, type MutableDataSource, type NumberFilterCondition, type NumberFilterOperator, type OpenFilterPopupInstruction, ParallelSortManager, type ParallelSortOptions, PendingCellTapController, type PendingCellTapDeps, PendingRowDragController, type PendingRowDragDeps, type PointerEventData, type PopupPosition, ROW_DRAG_HOLD_MS, type RowCacheEviction, type RowCacheOptions, RowDataManager, type RowDataManagerOptions, type RowDragState, type RowId, type RowLoadingMode, type RowLoadingOptions, RowMutationManager, type RowMutationManagerOptions, type RowSortCache, type RowsAddedInstruction, type RowsRemovedInstruction, type RowsUpdatedInstruction, ScrollVirtualizationManager, type ScrollVirtualizationManagerOptions, SelectionManager, type SelectionState, type ServerDataSourceOptions, type SetActiveCellInstruction, type SetContentSizeInstruction, type SetHoverPositionInstruction, type SetSelectionRangeInstruction, type SlotData, type BatchInstructionListener$1 as SlotPoolBatchListener, SlotPoolManager, type SlotPoolManagerOptions, type SlotState, type SortDirection, SortFilterManager, type SortFilterManagerOptions, type SortModel, type SortedChunk, type StartColumnMoveInstruction, type StartColumnResizeInstruction, type StartEditInstruction, type StartFillInstruction, type StartPeekInstruction, type StartRowDragInstruction, type StopEditInstruction, type StopPeekInstruction, TAP_SLOP_PX, type TextFilterCondition, type TextFilterOperator, TouchScrollController, type TouchScrollDeps, type Transaction, TransactionManager, type TransactionManagerOptions, type TransactionProcessedInstruction, type TransactionResult, type UpdateColumnMoveInstruction, type UpdateColumnResizeInstruction, type UpdateFillInstruction, type UpdateHeaderInstruction, type UpdateRowDragInstruction, type VisibleColumnInfo, WorkerPool, type WorkerPoolOptions, applyBatchInstructions, applyInstruction, bindPeekSelectAll, buildCellClasses, calculateColumnPositions, calculateFillHandlePosition, calculateFilterPopupPosition, calculateScaledColumnPositions, cellStyles, compareValues, computeValueHash, containerStyles, createClientDataSource, createDataSourceFromArray, createInitialState, createMutableClientDataSource, createServerDataSource, detectBoundaryCollisions, evaluateColumnFilter, evaluateDateCondition, evaluateNumberCondition, evaluateTextCondition, filtersStyles, findColumnAtX, findSlotForRow, formatCellValue, getFieldValue, getTotalWidth, gridStyles, groupDistinctValues, headerStyles, isBlankCellValue, isCellActive, isCellEditing, isCellInFillPreview, isCellSelected, isColumnInSelectionRange, isRowInSelectionRange, isRowVisible, isSameDay, kWayMerge, kWayMergeMultiColumn, labelsForSelectedValues, rawValueKey, rawValuesForLabels, rowDragStyles, rowPassesFilter, scrollCellIntoView, scrollbarStyles, setFieldValue, statesStyles, stringToSortableNumber, toPointerEventData, variablesStyles };
+export { type AssignSlotInstruction, AutoScrollDriver, type BatchChangeSetters, type BatchInstructionListener, type CalculateFillHandlePositionParams, type CancelColumnMoveInstruction, type CancelColumnResizeInstruction, type CancelFillInstruction, type CancelRowDragInstruction, type CellDataType, type CellPointerAction, type CellPosition, type CellRange, type CellRendererParams, type CellValue, type CellValueChangedEvent, type CloseFilterPopupInstruction, type ColumnDefinition, type ColumnFilterModel, type ColumnMoveDragState, type ColumnResizeDragState, type ColumnScrollGeometry, type ColumnsChangedInstruction, type CommitColumnMoveInstruction, type CommitColumnResizeInstruction, type CommitEditInstruction, type CommitFillInstruction, type CommitRowDragInstruction, type ContainerBounds, type CreateSlotInstruction, type DataChangeListener, type DataErrorInstruction, type DataLoadedInstruction, type DataLoadingInstruction, type DataSource, type DataSourceLoadMode, DataSourceOwner, type DataSourceRange, type DataSourceRequest, type DataSourceResponse, type DateFilterCondition, type DateFilterOperator, type DestroySlotInstruction, type Direction, type DistinctValueEntry, type DragEndResult, type DragMoveResult, type DragState, EditManager, type EditManagerOptions, type EditRendererParams, type EditState, type FillHandlePosition, type FillHandleState, FillManager, type FillPointerAction, type FilterCombination, type FilterCondition, type FilterModel, type FilterOperatorOption, type FilterPopupState, GridCore, type GridCoreOptions, type GridFilterOperatorLabels, type GridInstruction, type GridLabels, type GridState, type HeaderData, type HeaderRendererParams, type HighlightContext, HighlightManager, type HighlightingOptions, IndexedDataStore, type IndexedDataStoreOptions, type InitialStateArgs, InputEventAdapter, type InputEventAdapterDeps, InputHandler, type InputHandlerDeps, type InputResult, type InstructionListener, type KeyEventData, type KeyboardResult, type MoveSlotInstruction, type MultiColumnSortedChunk, type MutableClientDataSourceOptions, type MutableDataSource, type NumberFilterCondition, type NumberFilterOperator, type OpenFilterPopupInstruction, ParallelSortManager, type ParallelSortOptions, PendingCellTapController, type PendingCellTapDeps, PendingRowDragController, type PendingRowDragDeps, type PointerEventData, type PopupPosition, ROW_DRAG_HOLD_MS, type RowCacheEviction, type RowCacheOptions, RowDataManager, type RowDataManagerOptions, type RowDragState, type RowId, type RowLoadingMode, type RowLoadingOptions, RowMutationManager, type RowMutationManagerOptions, type RowSortCache, type RowsAddedInstruction, type RowsRemovedInstruction, type RowsUpdatedInstruction, ScrollVirtualizationManager, type ScrollVirtualizationManagerOptions, SelectionManager, type SelectionState, type ServerDataSourceOptions, type SetActiveCellInstruction, type SetContentSizeInstruction, type SetHoverPositionInstruction, type SetSelectionRangeInstruction, type SlotData, type BatchInstructionListener$1 as SlotPoolBatchListener, SlotPoolManager, type SlotPoolManagerOptions, type SlotState, type SortDirection, SortFilterManager, type SortFilterManagerOptions, type SortModel, type SortedChunk, type StartColumnMoveInstruction, type StartColumnResizeInstruction, type StartEditInstruction, type StartFillInstruction, type StartPeekInstruction, type StartRowDragInstruction, type StopEditInstruction, type StopPeekInstruction, TAP_SLOP_PX, type TextFilterCondition, type TextFilterOperator, TouchScrollController, type TouchScrollDeps, type Transaction, TransactionManager, type TransactionManagerOptions, type TransactionProcessedInstruction, type TransactionResult, type UpdateColumnMoveInstruction, type UpdateColumnResizeInstruction, type UpdateFillInstruction, type UpdateHeaderInstruction, type UpdateRowDragInstruction, type VisibleColumnInfo, WorkerPool, type WorkerPoolOptions, applyBatchInstructions, applyInstruction, bindPeekSelectAll, buildCellClasses, calculateColumnPositions, calculateFillHandlePosition, calculateFilterPopupPosition, calculateScaledColumnPositions, compareValues, computeValueHash, createClientDataSource, createDataSourceFromArray, createInitialState, createMutableClientDataSource, createServerDataSource, defaultGridLabels, detectBoundaryCollisions, evaluateColumnFilter, evaluateDateCondition, evaluateNumberCondition, evaluateTextCondition, findColumnAtX, findSlotForRow, formatCellValue, formatLabel, getDateOperatorOptions, getFieldValue, getNumberOperatorOptions, getTextOperatorOptions, getTotalWidth, groupDistinctValues, isBlankCellValue, isCellActive, isCellEditing, isCellInFillPreview, isCellSelected, isColumnInSelectionRange, isRowInSelectionRange, isRowVisible, isSameDay, kWayMerge, kWayMergeMultiColumn, labelsForSelectedValues, rawValueKey, rawValuesForLabels, resolveGridLabels, rowPassesFilter, scrollCellIntoView, setFieldValue, stringToSortableNumber, toPointerEventData };