@alaarab/ogrid-angular 2.0.2

package/dist/types/components/marching-ants-overlay.component.d.ts

@@ -0,0 +1,23 @@
+import type { ISelectionRange } from '../types';
+interface OverlayRect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+export declare class MarchingAntsOverlayComponent {
+    private destroyRef;
+    readonly containerEl: import("@angular/core").InputSignal<HTMLElement | null>;
+    readonly selectionRange: import("@angular/core").InputSignal<ISelectionRange | null>;
+    readonly copyRange: import("@angular/core").InputSignal<ISelectionRange | null>;
+    readonly cutRange: import("@angular/core").InputSignal<ISelectionRange | null>;
+    readonly colOffset: import("@angular/core").InputSignal<number>;
+    readonly selRect: import("@angular/core").WritableSignal<OverlayRect | null>;
+    readonly clipRect: import("@angular/core").WritableSignal<OverlayRect | null>;
+    private rafId;
+    private resizeObserver;
+    constructor();
+    clipRangeMatchesSel(): boolean;
+    max0(n: number): number;
+}
+export {};

package/dist/types/components/ogrid-layout.component.d.ts

@@ -0,0 +1,9 @@
+import type { SideBarProps } from './sidebar.component';
+export declare class OGridLayoutComponent {
+    readonly className: import("@angular/core").InputSignal<string | undefined>;
+    readonly hasToolbar: import("@angular/core").InputSignal<boolean>;
+    readonly hasToolbarBelow: import("@angular/core").InputSignal<boolean>;
+    readonly hasPagination: import("@angular/core").InputSignal<boolean>;
+    readonly sideBar: import("@angular/core").InputSignal<SideBarProps | null>;
+    readonly borderRadius = 6;
+}

package/dist/types/components/sidebar.component.d.ts

@@ -0,0 +1,42 @@
+import type { IColumnDefinition, SideBarPanelId, IFilters, FilterValue } from '../types';
+/** Describes a filterable column for the sidebar filters panel. */
+export interface SideBarFilterColumn {
+    columnId: string;
+    name: string;
+    filterField: string;
+    filterType: 'text' | 'multiSelect' | 'people' | 'date';
+}
+export interface SideBarProps {
+    activePanel: SideBarPanelId | null;
+    onPanelChange: (panel: SideBarPanelId | null) => void;
+    panels: SideBarPanelId[];
+    position: 'left' | 'right';
+    columns: IColumnDefinition[];
+    visibleColumns: Set<string>;
+    onVisibilityChange: (columnKey: string, visible: boolean) => void;
+    onSetVisibleColumns: (columns: Set<string>) => void;
+    filterableColumns: SideBarFilterColumn[];
+    filters: IFilters;
+    onFilterChange: (key: string, value: FilterValue | undefined) => void;
+    filterOptions: Record<string, string[]>;
+}
+export declare class SideBarComponent {
+    readonly sideBarProps: import("@angular/core").InputSignal<SideBarProps | null>;
+    readonly panelLabels: Record<SideBarPanelId, string>;
+    readonly tabWidth = 36;
+    readonly panelWidth = 240;
+    onTabClick(panel: SideBarPanelId): void;
+    allVisible(): boolean;
+    onSelectAll(): void;
+    onClearAll(): void;
+    onVisibilityChange(columnKey: string, visible: boolean): void;
+    getTextFilterValue(filterField: string): string;
+    onTextFilterChange(filterField: string, value: string): void;
+    getDateFrom(filterField: string): string;
+    getDateTo(filterField: string): string;
+    onDateFromChange(filterField: string, value: string): void;
+    onDateToChange(filterField: string, value: string): void;
+    getFilterOptions(filterField: string): string[];
+    isMultiSelectChecked(filterField: string, opt: string): boolean;
+    onMultiSelectChange(filterField: string, opt: string, checked: boolean): void;
+}

package/dist/types/components/status-bar.component.d.ts

@@ -0,0 +1,21 @@
+export declare class StatusBarComponent {
+    readonly totalCount: import("@angular/core").InputSignal<number>;
+    readonly filteredCount: import("@angular/core").InputSignal<number | undefined>;
+    readonly selectedCount: import("@angular/core").InputSignal<number | undefined>;
+    readonly selectedCellCount: import("@angular/core").InputSignal<number | undefined>;
+    readonly aggregation: import("@angular/core").InputSignal<{
+        sum: number;
+        avg: number;
+        min: number;
+        max: number;
+        count: number;
+    } | null | undefined>;
+    readonly suppressRowCount: import("@angular/core").InputSignal<boolean | undefined>;
+    readonly classNames: import("@angular/core").InputSignal<{
+        statusBar?: string;
+        statusBarItem?: string;
+        statusBarLabel?: string;
+        statusBarValue?: string;
+    } | undefined>;
+    protected readonly parts: () => import("@alaarab/ogrid-core").StatusBarPart[];
+}

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+export * from '@alaarab/ogrid-core';
+export type { IColumnDef, IColumnGroupDef, IColumnDefinition, ICellEditorProps, } from './types';
+export type { IOGridProps, IOGridClientProps, IOGridServerProps, IOGridDataGridProps, } from './types';
+export type { ColumnFilterType, IColumnFilterDef, IColumnMeta, ICellValueChangedEvent, CellEditorParams, IValueParserParams, IDateFilterValue, HeaderCell, HeaderRow, RowId, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, IOGridApi, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, SideBarPanelId, ISideBarDef, } from './types';
+export { toUserLike, isInSelectionRange, normalizeSelectionRange } from './types';
+export { OGridService } from './services/ogrid.service';
+export type { ColumnChooserPlacement, OGridPagination, OGridColumnChooser, OGridFilters, OGridSideBarState, } from './services/ogrid.service';
+export { DataGridStateService } from './services/datagrid-state.service';
+export type { DataGridLayoutState, DataGridRowSelectionState, DataGridEditingState, DataGridCellInteractionState, DataGridContextMenuState, DataGridViewModelState, DataGridStateResult, } from './services/datagrid-state.service';
+export { OGridLayoutComponent } from './components/ogrid-layout.component';
+export { StatusBarComponent } from './components/status-bar.component';
+export { GridContextMenuComponent } from './components/grid-context-menu.component';
+export { SideBarComponent } from './components/sidebar.component';
+export type { SideBarProps, SideBarFilterColumn } from './components/sidebar.component';
+export { MarchingAntsOverlayComponent } from './components/marching-ants-overlay.component';
+export { EmptyStateComponent } from './components/empty-state.component';

package/dist/types/services/datagrid-state.service.d.ts

@@ -0,0 +1,237 @@
+import type { RowId, IActiveCell, ISelectionRange, IStatusBarProps, IFilters, FilterValue, UserLike, ICellValueChangedEvent } from '../types';
+import type { IColumnDef as IAngularColumnDef } from '../types';
+import type { IOGridDataGridProps } from '../types';
+type IColumnDef<T> = IAngularColumnDef<T>;
+export interface DataGridLayoutState<T> {
+    flatColumns: IColumnDef<T>[];
+    visibleCols: IColumnDef<T>[];
+    visibleColumnCount: number;
+    totalColCount: number;
+    colOffset: number;
+    hasCheckboxCol: boolean;
+    rowIndexByRowId: Map<RowId, number>;
+    containerWidth: number;
+    minTableWidth: number;
+    desiredTableWidth: number;
+    columnSizingOverrides: Record<string, {
+        widthPx: number;
+    }>;
+    setColumnSizingOverrides: (overrides: Record<string, {
+        widthPx: number;
+    }>) => void;
+    onColumnResized?: (columnId: string, width: number) => void;
+}
+export interface DataGridRowSelectionState {
+    selectedRowIds: Set<RowId>;
+    updateSelection: (newSelectedIds: Set<RowId>) => void;
+    handleRowCheckboxChange: (rowId: RowId, checked: boolean, rowIndex: number, shiftKey: boolean) => void;
+    handleSelectAll: (checked: boolean) => void;
+    allSelected: boolean;
+    someSelected: boolean;
+}
+export interface DataGridEditingState<T> {
+    editingCell: {
+        rowId: RowId;
+        columnId: string;
+    } | null;
+    setEditingCell: (cell: {
+        rowId: RowId;
+        columnId: string;
+    } | null) => void;
+    pendingEditorValue: unknown;
+    setPendingEditorValue: (value: unknown) => void;
+    commitCellEdit: (item: T, columnId: string, oldValue: unknown, newValue: unknown, rowIndex: number, globalColIndex: number) => void;
+    cancelPopoverEdit: () => void;
+    popoverAnchorEl: HTMLElement | null;
+    setPopoverAnchorEl: (el: HTMLElement | null) => void;
+}
+export interface DataGridCellInteractionState {
+    activeCell: IActiveCell | null;
+    setActiveCell: (cell: IActiveCell | null) => void;
+    selectionRange: ISelectionRange | null;
+    setSelectionRange: (range: ISelectionRange | null) => void;
+    handleCellMouseDown: (e: MouseEvent, rowIndex: number, globalColIndex: number) => void;
+    handleSelectAllCells: () => void;
+    hasCellSelection: boolean;
+    handleGridKeyDown: (e: KeyboardEvent) => void;
+    handleFillHandleMouseDown: (e: MouseEvent) => void;
+    handleCopy: () => void;
+    handleCut: () => void;
+    handlePaste: () => Promise<void>;
+    cutRange: ISelectionRange | null;
+    copyRange: ISelectionRange | null;
+    clearClipboardRanges: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
+    onUndo?: () => void;
+    onRedo?: () => void;
+    isDragging: boolean;
+}
+export interface DataGridContextMenuState {
+    menuPosition: {
+        x: number;
+        y: number;
+    } | null;
+    setMenuPosition: (pos: {
+        x: number;
+        y: number;
+    } | null) => void;
+    handleCellContextMenu: (e: {
+        clientX: number;
+        clientY: number;
+        preventDefault?: () => void;
+    }) => void;
+    closeContextMenu: () => void;
+}
+export interface DataGridViewModelState<T> {
+    headerFilterInput: {
+        sortBy?: string;
+        sortDirection: 'asc' | 'desc';
+        onColumnSort: (columnKey: string) => void;
+        filters: IFilters;
+        onFilterChange: (key: string, value: FilterValue | undefined) => void;
+        filterOptions: Record<string, string[]>;
+        loadingFilterOptions: Record<string, boolean>;
+        peopleSearch?: (query: string) => Promise<UserLike[]>;
+    };
+    cellDescriptorInput: {
+        editingCell: {
+            rowId: RowId;
+            columnId: string;
+        } | null;
+        activeCell: IActiveCell | null;
+        selectionRange: ISelectionRange | null;
+        cutRange: ISelectionRange | null;
+        copyRange: ISelectionRange | null;
+        colOffset: number;
+        itemsLength: number;
+        getRowId: (item: T) => RowId;
+        editable?: boolean;
+        onCellValueChanged?: (event: ICellValueChangedEvent<T>) => void;
+        isDragging: boolean;
+    };
+    statusBarConfig: IStatusBarProps | null;
+    showEmptyInGrid: boolean;
+    onCellError?: (error: Error) => void;
+}
+export interface DataGridStateResult<T> {
+    layout: DataGridLayoutState<T>;
+    rowSelection: DataGridRowSelectionState;
+    editing: DataGridEditingState<T>;
+    interaction: DataGridCellInteractionState;
+    contextMenu: DataGridContextMenuState;
+    viewModels: DataGridViewModelState<T>;
+}
+/**
+ * Single orchestration service for DataGridTable. Takes grid props,
+ * returns all derived state and handlers so Angular UI packages can be thin view layers.
+ *
+ * Port of React's useDataGridState hook.
+ */
+export declare class DataGridStateService<T> {
+    private destroyRef;
+    readonly props: import("@angular/core").WritableSignal<IOGridDataGridProps<T> | null>;
+    readonly wrapperEl: import("@angular/core").WritableSignal<HTMLElement | null>;
+    private readonly editingCellSig;
+    private readonly pendingEditorValueSig;
+    private readonly activeCellSig;
+    private readonly selectionRangeSig;
+    private readonly isDraggingSig;
+    private readonly contextMenuPositionSig;
+    private readonly internalSelectedRows;
+    private readonly popoverAnchorElSig;
+    private readonly containerWidthSig;
+    private readonly columnSizingOverridesSig;
+    private readonly cutRangeSig;
+    private readonly copyRangeSig;
+    private internalClipboard;
+    private undoHistory;
+    private redoStack;
+    private batch;
+    private readonly undoLengthSig;
+    private readonly redoLengthSig;
+    private fillDragStart;
+    private lastClickedRow;
+    private dragStartPos;
+    private dragMoved;
+    private isDraggingRef;
+    private liveDragRange;
+    private rafId;
+    private lastMousePos;
+    private autoScrollInterval;
+    private windowCleanups;
+    private resizeObserver;
+    private readonly propsResolved;
+    readonly cellSelection: import("@angular/core").Signal<boolean>;
+    private readonly wrappedOnCellValueChanged;
+    readonly flatColumnsRaw: import("@angular/core").Signal<IColumnDef<T>[]>;
+    readonly flatColumns: import("@angular/core").Signal<IColumnDef<T>[]>;
+    readonly visibleCols: import("@angular/core").Signal<IColumnDef<T>[]>;
+    readonly visibleColumnCount: import("@angular/core").Signal<number>;
+    readonly hasCheckboxCol: import("@angular/core").Signal<boolean>;
+    readonly totalColCount: import("@angular/core").Signal<number>;
+    readonly colOffset: import("@angular/core").Signal<0 | 1>;
+    readonly rowIndexByRowId: import("@angular/core").Signal<Map<RowId, number>>;
+    readonly selectedRowIds: import("@angular/core").Signal<Set<RowId>>;
+    readonly allSelected: import("@angular/core").Signal<boolean>;
+    readonly someSelected: import("@angular/core").Signal<boolean>;
+    readonly hasCellSelection: import("@angular/core").Signal<boolean>;
+    readonly canUndo: import("@angular/core").Signal<boolean>;
+    readonly canRedo: import("@angular/core").Signal<boolean>;
+    readonly minTableWidth: import("@angular/core").Signal<number>;
+    readonly desiredTableWidth: import("@angular/core").Signal<number>;
+    readonly aggregation: import("@angular/core").Signal<import("@alaarab/ogrid-core").AggregationResult | null>;
+    readonly statusBarConfig: import("@angular/core").Signal<{
+        aggregation: import("@alaarab/ogrid-core").AggregationResult | undefined;
+        totalCount: number;
+        filteredCount?: number;
+        selectedCount?: number;
+        panels?: import("@alaarab/ogrid-core").StatusBarPanel[];
+        suppressRowCount?: boolean;
+    } | null>;
+    readonly showEmptyInGrid: import("@angular/core").Signal<boolean>;
+    constructor();
+    updateSelection(newSelectedIds: Set<RowId>): void;
+    handleRowCheckboxChange(rowId: RowId, checked: boolean, rowIndex: number, shiftKey: boolean): void;
+    handleSelectAll(checked: boolean): void;
+    setEditingCell(cell: {
+        rowId: RowId;
+        columnId: string;
+    } | null): void;
+    setPendingEditorValue(value: unknown): void;
+    setActiveCell(cell: IActiveCell | null): void;
+    setSelectionRange(range: ISelectionRange | null): void;
+    commitCellEdit(item: T, columnId: string, oldValue: unknown, newValue: unknown, rowIndex: number, globalColIndex: number): void;
+    cancelPopoverEdit(): void;
+    handleCellMouseDown(e: MouseEvent, rowIndex: number, globalColIndex: number): void;
+    handleSelectAllCells(): void;
+    setContextMenuPosition(pos: {
+        x: number;
+        y: number;
+    } | null): void;
+    handleCellContextMenu(e: {
+        clientX: number;
+        clientY: number;
+        preventDefault?: () => void;
+    }): void;
+    closeContextMenu(): void;
+    handleCopy(): void;
+    handleCut(): void;
+    handlePaste(): Promise<void>;
+    clearClipboardRanges(): void;
+    beginBatch(): void;
+    endBatch(): void;
+    undo(): void;
+    redo(): void;
+    handleGridKeyDown(e: KeyboardEvent): void;
+    handleFillHandleMouseDown(e: MouseEvent): void;
+    getState(): DataGridStateResult<T>;
+    private getEffectiveRange;
+    private onWindowMouseMove;
+    private onWindowMouseUp;
+    private resolveRangeFromMouse;
+    private applyDragAttrs;
+    private clearDragAttrs;
+    private setupFillHandleDrag;
+}
+export {};

package/dist/types/services/ogrid.service.d.ts

@@ -0,0 +1,191 @@
+import type { RowId, IOGridApi, IFilters, FilterValue, IRowSelectionChangeEvent, IStatusBarProps, IColumnDefinition, IDataSource, ISideBarDef, SideBarPanelId } from '../types';
+import type { IOGridProps, IOGridDataGridProps } from '../types';
+import type { IColumnDef, IColumnGroupDef, ICellValueChangedEvent } from '../types';
+/** Resolved column chooser placement. */
+export type ColumnChooserPlacement = 'toolbar' | 'sidebar' | 'none';
+/** Pagination state and handlers. */
+export interface OGridPagination {
+    page: number;
+    pageSize: number;
+    displayTotalCount: number;
+    setPage: (p: number) => void;
+    setPageSize: (size: number) => void;
+    pageSizeOptions?: number[];
+    entityLabelPlural: string;
+}
+/** Column chooser state and handlers. */
+export interface OGridColumnChooser {
+    columns: IColumnDefinition[];
+    visibleColumns: Set<string>;
+    onVisibilityChange: (columnKey: string, isVisible: boolean) => void;
+    placement: ColumnChooserPlacement;
+}
+/** Filter state. */
+export interface OGridFilters {
+    hasActiveFilters: boolean;
+    setFilters: (f: IFilters) => void;
+}
+/** Side bar state. */
+export interface OGridSideBarState {
+    isEnabled: boolean;
+    activePanel: SideBarPanelId | null;
+    setActivePanel: (panel: SideBarPanelId | null) => void;
+    panels: SideBarPanelId[];
+    position: 'left' | 'right';
+    isOpen: boolean;
+    toggle: (panel: SideBarPanelId) => void;
+    close: () => void;
+}
+/**
+ * Top-level orchestration service for OGrid: manages pagination, sorting, filtering,
+ * column visibility, sidebar, and server-side data fetching via Angular signals.
+ *
+ * Port of React's useOGrid hook.
+ */
+export declare class OGridService<T> {
+    private destroyRef;
+    readonly columnsProp: import("@angular/core").WritableSignal<(IColumnDef<T> | IColumnGroupDef<T>)[]>;
+    readonly getRowId: import("@angular/core").WritableSignal<(item: T) => RowId>;
+    readonly data: import("@angular/core").WritableSignal<T[] | undefined>;
+    readonly dataSource: import("@angular/core").WritableSignal<IDataSource<T> | undefined>;
+    readonly controlledPage: import("@angular/core").WritableSignal<number | undefined>;
+    readonly controlledPageSize: import("@angular/core").WritableSignal<number | undefined>;
+    readonly controlledSort: import("@angular/core").WritableSignal<{
+        field: string;
+        direction: "asc" | "desc";
+    } | undefined>;
+    readonly controlledFilters: import("@angular/core").WritableSignal<IFilters | undefined>;
+    readonly controlledVisibleColumns: import("@angular/core").WritableSignal<Set<string> | undefined>;
+    readonly controlledLoading: import("@angular/core").WritableSignal<boolean | undefined>;
+    readonly onPageChange: import("@angular/core").WritableSignal<((page: number) => void) | undefined>;
+    readonly onPageSizeChange: import("@angular/core").WritableSignal<((size: number) => void) | undefined>;
+    readonly onSortChange: import("@angular/core").WritableSignal<((sort: {
+        field: string;
+        direction: "asc" | "desc";
+    }) => void) | undefined>;
+    readonly onFiltersChange: import("@angular/core").WritableSignal<((filters: IFilters) => void) | undefined>;
+    readonly onVisibleColumnsChange: import("@angular/core").WritableSignal<((cols: Set<string>) => void) | undefined>;
+    readonly columnOrder: import("@angular/core").WritableSignal<string[] | undefined>;
+    readonly onColumnOrderChange: import("@angular/core").WritableSignal<((order: string[]) => void) | undefined>;
+    readonly onColumnResized: import("@angular/core").WritableSignal<((columnId: string, width: number) => void) | undefined>;
+    readonly onColumnPinned: import("@angular/core").WritableSignal<((columnId: string, pinned: "left" | "right" | null) => void) | undefined>;
+    readonly freezeRows: import("@angular/core").WritableSignal<number | undefined>;
+    readonly freezeCols: import("@angular/core").WritableSignal<number | undefined>;
+    readonly defaultPageSize: import("@angular/core").WritableSignal<number>;
+    readonly defaultSortBy: import("@angular/core").WritableSignal<string | undefined>;
+    readonly defaultSortDirection: import("@angular/core").WritableSignal<"asc" | "desc">;
+    readonly toolbar: import("@angular/core").WritableSignal<unknown>;
+    readonly toolbarBelow: import("@angular/core").WritableSignal<unknown>;
+    readonly emptyState: import("@angular/core").WritableSignal<{
+        message?: string;
+        render?: unknown;
+    } | undefined>;
+    readonly entityLabelPlural: import("@angular/core").WritableSignal<string>;
+    readonly className: import("@angular/core").WritableSignal<string | undefined>;
+    readonly layoutMode: import("@angular/core").WritableSignal<"content" | "fill">;
+    readonly suppressHorizontalScroll: import("@angular/core").WritableSignal<boolean | undefined>;
+    readonly editable: import("@angular/core").WritableSignal<boolean | undefined>;
+    readonly cellSelection: import("@angular/core").WritableSignal<boolean | undefined>;
+    readonly onCellValueChanged: import("@angular/core").WritableSignal<((event: ICellValueChangedEvent<T>) => void) | undefined>;
+    readonly onUndo: import("@angular/core").WritableSignal<(() => void) | undefined>;
+    readonly onRedo: import("@angular/core").WritableSignal<(() => void) | undefined>;
+    readonly canUndo: import("@angular/core").WritableSignal<boolean | undefined>;
+    readonly canRedo: import("@angular/core").WritableSignal<boolean | undefined>;
+    readonly rowSelection: import("@angular/core").WritableSignal<"none" | "single" | "multiple">;
+    readonly selectedRows: import("@angular/core").WritableSignal<Set<RowId> | undefined>;
+    readonly onSelectionChange: import("@angular/core").WritableSignal<((event: IRowSelectionChangeEvent<T>) => void) | undefined>;
+    readonly statusBar: import("@angular/core").WritableSignal<boolean | IStatusBarProps | undefined>;
+    readonly pageSizeOptions: import("@angular/core").WritableSignal<number[] | undefined>;
+    readonly sideBarConfig: import("@angular/core").WritableSignal<boolean | ISideBarDef | undefined>;
+    readonly onFirstDataRendered: import("@angular/core").WritableSignal<(() => void) | undefined>;
+    readonly onError: import("@angular/core").WritableSignal<((error: unknown) => void) | undefined>;
+    readonly columnChooserProp: import("@angular/core").WritableSignal<boolean | "toolbar" | "sidebar" | undefined>;
+    readonly ariaLabel: import("@angular/core").WritableSignal<string | undefined>;
+    readonly ariaLabelledBy: import("@angular/core").WritableSignal<string | undefined>;
+    private readonly internalData;
+    private readonly internalLoading;
+    private readonly internalPage;
+    private readonly internalPageSize;
+    private readonly internalSort;
+    private readonly internalFilters;
+    private readonly internalVisibleColumns;
+    private readonly internalSelectedRows;
+    private readonly columnWidthOverrides;
+    private readonly pinnedOverrides;
+    private readonly serverItems;
+    private readonly serverTotalCount;
+    private readonly serverLoading;
+    private fetchId;
+    private readonly refreshCounter;
+    private firstDataRendered;
+    private readonly sideBarActivePanel;
+    private readonly serverFilterOptions;
+    private readonly loadingFilterOptions;
+    private sortInitialized;
+    private visibleColumnsInitialized;
+    private pageSizeInitialized;
+    readonly columns: import("@angular/core").Signal<IColumnDef<T>[]>;
+    readonly isServerSide: import("@angular/core").Signal<boolean>;
+    readonly isClientSide: import("@angular/core").Signal<boolean>;
+    readonly displayData: import("@angular/core").Signal<T[]>;
+    readonly displayLoading: import("@angular/core").Signal<boolean>;
+    readonly defaultSortField: import("@angular/core").Signal<string>;
+    readonly page: import("@angular/core").Signal<number>;
+    readonly pageSize: import("@angular/core").Signal<number>;
+    readonly sort: import("@angular/core").Signal<{
+        field: string;
+        direction: "asc" | "desc";
+    }>;
+    readonly filters: import("@angular/core").Signal<IFilters>;
+    readonly visibleColumns: import("@angular/core").Signal<Set<string>>;
+    readonly effectiveSelectedRows: import("@angular/core").Signal<Set<RowId>>;
+    readonly columnChooserPlacement: import("@angular/core").Signal<ColumnChooserPlacement>;
+    readonly multiSelectFilterFields: import("@angular/core").Signal<string[]>;
+    readonly hasServerFilterOptions: import("@angular/core").Signal<boolean>;
+    readonly clientFilterOptions: import("@angular/core").Signal<Record<string, string[]>>;
+    readonly clientItemsAndTotal: import("@angular/core").Signal<{
+        items: T[];
+        totalCount: number;
+    } | null>;
+    readonly displayItems: import("@angular/core").Signal<T[]>;
+    readonly displayTotalCount: import("@angular/core").Signal<number>;
+    readonly hasActiveFilters: import("@angular/core").Signal<boolean>;
+    readonly columnChooserColumns: import("@angular/core").Signal<IColumnDefinition[]>;
+    readonly statusBarConfig: import("@angular/core").Signal<IStatusBarProps | undefined>;
+    readonly isLoadingResolved: import("@angular/core").Signal<boolean>;
+    readonly sideBarEnabled: import("@angular/core").Signal<boolean>;
+    readonly sideBarParsed: import("@angular/core").Signal<{
+        panels: SideBarPanelId[];
+        position: "left" | "right";
+        defaultPanel: SideBarPanelId | null;
+    }>;
+    readonly filterableColumns: import("@angular/core").Signal<{
+        columnId: string;
+        name: string;
+        filterField: string;
+        filterType: "text" | "multiSelect" | "people" | "date";
+    }[]>;
+    readonly sideBarState: import("@angular/core").Signal<OGridSideBarState>;
+    readonly dataGridProps: import("@angular/core").Signal<IOGridDataGridProps<T>>;
+    readonly pagination: import("@angular/core").Signal<OGridPagination>;
+    readonly columnChooser: import("@angular/core").Signal<OGridColumnChooser>;
+    readonly filtersResult: import("@angular/core").Signal<OGridFilters>;
+    readonly sideBarProps: import("@angular/core").Signal<unknown>;
+    constructor();
+    setPage(p: number): void;
+    setPageSize(size: number): void;
+    setSort(s: {
+        field: string;
+        direction: 'asc' | 'desc';
+    }): void;
+    setFilters(f: IFilters): void;
+    setVisibleColumns(cols: Set<string>): void;
+    handleSort(columnKey: string): void;
+    handleFilterChange(key: string, value: FilterValue | undefined): void;
+    handleVisibilityChange(columnKey: string, isVisible: boolean): void;
+    handleSelectionChange(event: IRowSelectionChangeEvent<T>): void;
+    handleColumnResized(columnId: string, width: number): void;
+    handleColumnPinned(columnId: string, pinned: 'left' | 'right' | null): void;
+    configure(props: IOGridProps<T>): void;
+    getApi(): IOGridApi<T>;
+}

package/dist/types/types/columnTypes.d.ts

@@ -0,0 +1,27 @@
+import type { Type, TemplateRef } from '@angular/core';
+import type { IColumnDef as ICoreColumnDef, CellEditorParams } from '@alaarab/ogrid-core';
+export type { ColumnFilterType, IDateFilterValue, IColumnFilterDef, IColumnMeta, IValueParserParams, ICellValueChangedEvent, CellEditorParams, IColumnGroupDef, HeaderCell, HeaderRow, IColumnDefinition, } from '@alaarab/ogrid-core';
+/** Props passed to custom cell editor components. */
+export interface ICellEditorProps<T = unknown> {
+    value: unknown;
+    onValueChange: (value: unknown) => void;
+    onCommit: () => void;
+    onCancel: () => void;
+    item: T;
+    column: IColumnDef<T>;
+    cellEditorParams?: CellEditorParams;
+}
+/**
+ * Angular-specific column definition. Extends core's framework-agnostic IColumnDef
+ * with renderCell, cellStyle, and a narrowed cellEditor type.
+ */
+export interface IColumnDef<T = unknown> extends ICoreColumnDef<T> {
+    /** Custom cell renderer — TemplateRef or string function (Angular-specific). */
+    renderCell?: TemplateRef<{
+        $implicit: T;
+    }> | ((item: T) => string);
+    /** Static or per-row cell inline styles (Angular-specific). */
+    cellStyle?: Record<string, string> | ((item: T) => Record<string, string>);
+    /** Built-in editor type or custom Angular component class. */
+    cellEditor?: 'text' | 'select' | 'checkbox' | 'richSelect' | 'date' | Type<unknown>;
+}