@archbase/components 4.0.19 → 4.0.20

package/dist/datagrid/ag-grid/ag-grid-locale-ptbr.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AG Grid Portuguese (Brazil) Locale
+ *
+ * Complete translation for AG Grid Community in pt-BR
+ */
+export declare const AG_GRID_LOCALE_PTBR: Record<string, string>;
+export default AG_GRID_LOCALE_PTBR;

package/dist/datagrid/ag-grid/ag-grid-mantine-theme.d.ts

@@ -0,0 +1,24 @@
+import { Theme } from 'ag-grid-community';
+import { MantineTheme } from '@mantine/core';
+/**
+ * Options for creating AG Grid theme
+ */
+export interface ArchbaseAgGridThemeOptions {
+    headerFontWeight?: number | 'normal' | 'bold';
+}
+/**
+ * Creates an AG Grid theme integrated with Mantine's theming system
+ */
+export declare const createArchbaseAgGridTheme: (theme: MantineTheme, colorScheme: "light" | "dark", options?: ArchbaseAgGridThemeOptions) => Theme;
+/**
+ * Get CSS variables for additional styling not covered by theme params
+ */
+export declare const getAgGridMantineCssVars: (theme: MantineTheme, colorScheme: "light" | "dark") => Record<string, string>;
+/**
+ * Get custom CSS styles for AG Grid cell focus
+ */
+export declare const getAgGridCustomStyles: (theme: MantineTheme, colorScheme: "light" | "dark") => string;
+/**
+ * Default export for convenience
+ */
+export default createArchbaseAgGridTheme;

package/dist/datagrid/ag-grid/archbase-data-grid-ag-formatters.d.ts

@@ -0,0 +1,88 @@
+import { ReactNode } from 'react';
+import { MaskOptions } from '@archbase/core';
+import { ICellRendererParams } from 'ag-grid-community';
+import { FieldDataType } from './archbase-data-grid-ag-types';
+/**
+ * Text cell renderer with optional mask and auto base64 decoding
+ */
+export declare const TextCellRenderer: (params: ICellRendererParams, maskOptions?: MaskOptions) => ReactNode;
+/**
+ * Integer cell renderer
+ */
+export declare const IntegerCellRenderer: (params: ICellRendererParams) => ReactNode;
+/**
+ * Float cell renderer
+ */
+export declare const FloatCellRenderer: (params: ICellRendererParams) => ReactNode;
+/**
+ * Currency cell renderer (BRL format)
+ */
+export declare const CurrencyCellRenderer: (params: ICellRendererParams) => ReactNode;
+/**
+ * Percent cell renderer
+ */
+export declare const PercentCellRenderer: (params: ICellRendererParams, decimalPlaces?: number) => ReactNode;
+/**
+ * Boolean cell renderer with Mantine checkbox
+ */
+export declare const BooleanCellRenderer: (params: ICellRendererParams) => ReactNode;
+/**
+ * Date cell renderer
+ */
+export declare const DateCellRenderer: (params: ICellRendererParams, dateFormat?: string) => ReactNode;
+/**
+ * DateTime cell renderer
+ */
+export declare const DateTimeCellRenderer: (params: ICellRendererParams, dateTimeFormat?: string) => ReactNode;
+/**
+ * Time cell renderer
+ */
+export declare const TimeCellRenderer: (params: ICellRendererParams, timeFormat?: string) => ReactNode;
+/**
+ * Enum cell renderer
+ */
+export declare const EnumCellRenderer: (params: ICellRendererParams, enumValues: Array<{
+    label: string;
+    value: string;
+}>) => ReactNode;
+/**
+ * UUID cell renderer
+ */
+export declare const UUIDCellRenderer: (params: ICellRendererParams) => ReactNode;
+/**
+ * Image cell renderer
+ */
+export declare const ImageCellRenderer: (params: ICellRendererParams, options?: {
+    maxWidth?: number;
+    maxHeight?: number;
+}) => ReactNode;
+/**
+ * Get cell renderer by data type
+ */
+export declare const getCellRendererByDataType: (dataType: FieldDataType, customRender?: (params: ICellRendererParams) => ReactNode, options?: {
+    maskOptions?: MaskOptions;
+    dateFormat?: string;
+    dateTimeFormat?: string;
+    timeFormat?: string;
+    enumValues?: Array<{
+        label: string;
+        value: string;
+    }>;
+    decimalPlaces?: number;
+}) => ((params: ICellRendererParams) => ReactNode);
+/**
+ * Get recommended alignment by data type
+ */
+export declare const getAlignmentByDataType: (dataType: FieldDataType, customAlign?: "left" | "center" | "right") => "left" | "center" | "right";
+/**
+ * Create value formatter for AG Grid column
+ */
+export declare const createValueFormatter: (dataType: FieldDataType, options?: {
+    dateFormat?: string;
+    dateTimeFormat?: string;
+    timeFormat?: string;
+    enumValues?: Array<{
+        label: string;
+        value: string;
+    }>;
+}) => ((params: any) => string) | undefined;

package/dist/datagrid/ag-grid/archbase-data-grid-ag-types.d.ts

@@ -0,0 +1,329 @@
+import { default as React, MutableRefObject, ReactNode, RefObject } from 'react';
+import { ColDef, GridApi } from 'ag-grid-community';
+import { IArchbaseDataSourceBase } from '@archbase/data';
+import { ArchbaseFilterDefinition, ArchbaseActiveFilter } from '../../filters/ArchbaseCompositeFilters.types';
+/**
+ * Reference interface for external grid control
+ */
+export interface ArchbaseDataGridAGRef<T = any> {
+    /** Get selected rows */
+    getSelectedRows: () => T[];
+    /** Clear selection */
+    clearSelection: () => void;
+    /** Refresh grid data */
+    refreshData: () => void;
+    /** Export grid data */
+    exportData: () => void;
+    /** Print grid data */
+    printData: () => void;
+    /** Expand a specific row's detail panel */
+    expandRow: (rowId: string | number) => void;
+    /** Collapse a specific row's detail panel */
+    collapseRow: (rowId: string | number) => void;
+    /** Collapse all expanded detail panels */
+    collapseAllRows: () => void;
+    /** Get all expanded row IDs */
+    getExpandedRows: () => (string | number)[];
+    /** Get current filter model */
+    getFilterModel: () => any;
+    /** Get AG Grid API */
+    getGridApi: () => GridApi | null;
+    /** Auto-size all columns to fit their content */
+    autoSizeAllColumns: (skipHeader?: boolean) => void;
+    /** Size columns to fit the grid width */
+    sizeColumnsToFit: () => void;
+}
+/**
+ * Data types supported by grid columns
+ */
+export type FieldDataType = 'text' | 'integer' | 'float' | 'currency' | 'boolean' | 'date' | 'datetime' | 'time' | 'enum' | 'image' | 'uuid';
+/**
+ * Column props (same API as MUI version)
+ */
+export interface ArchbaseDataGridAGColumnProps<T = any> {
+    /** Column header text */
+    header: string;
+    /** Column footer text */
+    footer?: string;
+    /** Data field to bind */
+    dataField: string;
+    /** Enable column filtering */
+    enableColumnFilter?: boolean;
+    /** Enable global filter search on this column */
+    enableGlobalFilter?: boolean;
+    /** Custom accessor function */
+    dataFieldAcessorFn?: (originalRow: T) => any;
+    /** Data type for formatting and filtering */
+    dataType: FieldDataType;
+    /** Mask options for text formatting */
+    maskOptions?: any;
+    /** Input filter type */
+    inputFilterType?: string;
+    /** Enum values for select filters */
+    enumValues?: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** Minimum column width */
+    minSize?: number;
+    /** Maximum column width */
+    maxSize?: number;
+    /** Custom cell renderer */
+    render?: (data: any) => ReactNode;
+    /** Column visibility */
+    visible: boolean;
+    /** Column width */
+    size: number;
+    /** Enable click to copy */
+    enableClickToCopy: boolean;
+    /** Enable sorting */
+    enableSorting: boolean;
+    /** Cell alignment */
+    align?: 'left' | 'center' | 'right';
+    /** Header alignment */
+    headerAlign?: 'left' | 'center' | 'right';
+    /** Footer alignment */
+    footerAlign?: 'left' | 'center' | 'right';
+    /** Permission name to view this column */
+    viewPermission?: string;
+    /** Permission name to edit this column */
+    editPermission?: string;
+    /** Fallback content when no permission */
+    fallbackContent?: ReactNode | string;
+    /** Hide column completely when no permission */
+    hideWhenNoPermission?: boolean;
+    /** Auto-register column permission */
+    autoRegisterPermission?: boolean;
+}
+/**
+ * Default column props
+ */
+export declare const defaultColumnProps: Partial<ArchbaseDataGridAGColumnProps>;
+/**
+ * Props for toolbar actions
+ */
+export interface GridToolBarActionsProps {
+    children: ReactNode;
+}
+/**
+ * Props for columns wrapper
+ */
+export interface GridColumnsProps {
+    children: ReactNode;
+}
+/**
+ * Cell click event data
+ */
+export interface CellClickEvent<T = any> {
+    id: string | number;
+    columnName: string;
+    rowData: T;
+}
+/**
+ * Main ArchbaseDataGridAG props
+ */
+export interface ArchbaseDataGridAGProps<T extends object = any, ID = any> {
+    /** DataSource (V1 or V2 compatible) */
+    dataSource: IArchbaseDataSourceBase<T>;
+    /** Function to get row ID */
+    getRowId?: (row: T) => ID;
+    /** Resource name for grid security */
+    resourceName?: string;
+    /** Resource description */
+    resourceDescription?: string;
+    /** Column security options */
+    columnSecurityOptions?: {
+        defaultFallback?: ReactNode | string;
+        hideByDefault?: boolean;
+        permissionPrefix?: string;
+    };
+    /** Enable column resizing */
+    enableColumnResizing?: boolean;
+    /** Enable row numbers */
+    enableRowNumbers?: boolean;
+    /** Enable row selection with checkboxes */
+    enableRowSelection?: boolean;
+    /** Enable row actions column */
+    enableRowActions?: boolean;
+    /** Enable column filter modes */
+    enableColumnFilterModes?: boolean;
+    /** Enable global filter search */
+    enableGlobalFilter?: boolean;
+    /** Enable top toolbar */
+    enableTopToolbar?: boolean;
+    /** Enable toolbar actions */
+    enableTopToolbarActions?: boolean;
+    /** Show pagination */
+    showPagination?: boolean;
+    /** Manual filtering (server-side) */
+    manualFiltering?: boolean;
+    /** Manual pagination (server-side) */
+    manualPagination?: boolean;
+    /** Manual sorting (server-side) */
+    manualSorting?: boolean;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Error state */
+    isError?: boolean;
+    /** Error object */
+    error?: any;
+    /** Grid height */
+    height?: string | number;
+    /** Grid width */
+    width?: string | number;
+    /** Page size */
+    pageSize?: number;
+    /** Current page index */
+    pageIndex?: number;
+    /** Column definitions as children */
+    children?: ReactNode;
+    /** Render row actions */
+    renderRowActions?: (row: T) => ReactNode;
+    /** Render toolbar actions */
+    renderToolbarActions?: () => ReactNode;
+    /** Render internal toolbar actions */
+    renderToolbarInternalActions?: (props: {
+        table: any;
+    }) => ReactNode | null;
+    /** Custom top toolbar */
+    renderTopToolbar?: ReactNode;
+    /** Render detail panel content */
+    renderDetailPanel?: (props: {
+        row: T;
+    }) => ReactNode;
+    /** Allow multiple detail panels open */
+    allowMultipleDetailPanels?: boolean;
+    /** Minimum detail panel height */
+    detailPanelMinHeight?: number;
+    /** Detail panel style */
+    detailPanelStyle?: React.CSSProperties;
+    /** Detail panel class name */
+    detailPanelClassName?: string;
+    /** Callback when detail panels change */
+    onDetailPanelChange?: (expandedRowIds: (string | number)[]) => void;
+    /** Detail panel display mode */
+    detailPanelDisplayMode?: 'auto' | 'inline' | 'modal' | 'drawer';
+    /** Detail panel title */
+    detailPanelTitle?: string | ((rowId: string | number, rowData: T) => string);
+    /** Detail panel position (for drawer) */
+    detailPanelPosition?: 'right' | 'left' | 'bottom' | 'top';
+    /** Detail panel size (for modal/drawer) */
+    detailPanelSize?: string | number;
+    /** Allow column filters */
+    allowColumnFilters?: boolean;
+    /** Allow data export */
+    allowExportData?: boolean;
+    /** Allow data print */
+    allowPrintData?: boolean;
+    /** Use ArchbaseCompositeFilters */
+    useCompositeFilters?: boolean;
+    /** Filter definitions */
+    filterDefinitions?: ArchbaseFilterDefinition[];
+    /** Active filters */
+    activeFilters?: ArchbaseActiveFilter[];
+    /** Callback when filters change */
+    onFiltersChange?: (filters: ArchbaseActiveFilter[], rsql?: string) => void;
+    /** Hide AG Grid native filters */
+    hideAgGridFilters?: boolean;
+    /** Show border */
+    withBorder?: boolean;
+    /** Show column borders */
+    withColumnBorders?: boolean;
+    /** Highlight row on hover */
+    highlightOnHover?: boolean;
+    /** Striped rows */
+    striped?: boolean;
+    /** CSS class name */
+    className?: string;
+    /** Grid variant */
+    variant?: 'filled' | 'outlined';
+    /** Font size */
+    fontSize?: string | number;
+    /** Cell padding */
+    cellPadding?: string | number;
+    /** Table head cell padding */
+    tableHeadCellPadding?: string;
+    /** Auto column width (flex: 1 for all columns) */
+    columnAutoWidth?: boolean;
+    /**
+     * Auto-size strategy for columns
+     * - 'fitCellContents': Auto-size columns to fit their cell contents
+     * - 'fitGridWidth': Auto-size columns to fit the grid width
+     */
+    autoSizeStrategy?: 'fitCellContents' | 'fitGridWidth';
+    /** Skip header when calculating auto-size */
+    skipHeaderOnAutoSize?: boolean;
+    /** Row height */
+    rowHeight?: number;
+    /** Header font weight (default: 600 = bold) */
+    headerFontWeight?: number | 'normal' | 'bold';
+    /** Show toolbar border */
+    withToolbarBorder?: boolean;
+    /** Show pagination border */
+    withPaginationBorder?: boolean;
+    /** Toolbar padding */
+    toolbarPadding?: string | number;
+    /** Pagination padding */
+    paginationPadding?: string | number;
+    /** Print title */
+    printTitle?: string;
+    /** Print logo */
+    logoPrint?: string;
+    /** Global date format */
+    globalDateFormat?: string;
+    /** CSV export options */
+    csvOptions?: any;
+    /** Toolbar alignment */
+    toolbarAlignment?: 'left' | 'right' | 'center';
+    /** Actions column position */
+    positionActionsColumn?: 'first' | 'last';
+    /** Actions column width */
+    actionsColumnWidth?: number;
+    /** Toolbar left content */
+    toolbarLeftContent?: ReactNode;
+    /** Bottom toolbar min height */
+    bottomToolbarMinHeight?: string | number;
+    /** Pagination labels */
+    paginationLabels?: Record<string, string>;
+    /** Show progress bars */
+    showProgressBars?: boolean;
+    /** Hide footer */
+    hideFooter?: boolean;
+    /** Selected rows changed callback */
+    onSelectedRowsChanged?: (rows: T[]) => void;
+    /** Cell double click callback */
+    onCellDoubleClick?: (params: CellClickEvent<T>) => void;
+    /** Export callback */
+    onExport?: (callback: () => void) => void;
+    /** Print callback */
+    onPrint?: (callback: () => void) => void;
+    /** Filter model change callback */
+    onFilterModelChange?: (filterModel: any) => void;
+    /** Grid reference */
+    gridRef?: RefObject<ArchbaseDataGridAGRef<T>> | MutableRefObject<ArchbaseDataGridAGRef<T> | null>;
+}
+/**
+ * Declarative Column component
+ */
+export declare function ArchbaseDataGridAGColumn<T>(_props: ArchbaseDataGridAGColumnProps<T>): any;
+export declare namespace ArchbaseDataGridAGColumn {
+    var defaultProps: Partial<ArchbaseDataGridAGColumnProps<any>>;
+}
+/**
+ * Columns wrapper component
+ */
+export declare function Columns(props: GridColumnsProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Columns {
+    var componentName: string;
+}
+/**
+ * Toolbar actions wrapper
+ */
+export declare function GridToolBarActions(props: GridToolBarActionsProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Internal AG Grid ColDef with extended properties
+ */
+export interface ExtendedColDef<TData = any, TValue = any> extends ColDef<TData, TValue> {
+    enableGlobalFilter?: boolean;
+    dataType?: FieldDataType;
+}

package/dist/datagrid/ag-grid/archbase-data-grid-ag-utils.d.ts

@@ -0,0 +1,71 @@
+import { ColDef, SortModelItem } from 'ag-grid-community';
+import { IArchbaseDataSourceBase } from '@archbase/data';
+import { ArchbaseFilterDefinition, ArchbaseActiveFilter } from '../../filters/ArchbaseCompositeFilters.types';
+/**
+ * Maximum page size for MIT license compatibility
+ */
+export declare const MAX_PAGE_SIZE = 100;
+/**
+ * Safely get row ID from row data
+ */
+export declare const safeGetRowId: <T extends object>(row: T, getRowId?: (row: T) => any) => string | number | undefined;
+/**
+ * Check if DataSource is V2
+ */
+export declare const isDataSourceV2: (ds: any) => boolean;
+/**
+ * Get records from DataSource (V1/V2 compatible)
+ */
+export declare const getRecordsFromDataSource: <T>(ds: IArchbaseDataSourceBase<T>) => T[];
+/**
+ * Get options from DataSource (V1 only)
+ */
+export declare const getDataSourceOptions: (ds: any) => any;
+/**
+ * Get current page from DataSource
+ */
+export declare const getCurrentPageFromDataSource: (ds: any) => number;
+/**
+ * Convert hex color to RGB string
+ */
+export declare const hexToRgb: (hex: string) => string;
+/**
+ * Build global filter RSQL expression
+ */
+export declare const buildGlobalFilterExpression: (filterValue: string, columns: ColDef[]) => string | undefined;
+/**
+ * Build filter RSQL expression from AG Grid filter model
+ */
+export declare const buildFilterExpression: (filterModel: Record<string, any>, columns: ColDef[], quickFilterValue?: string) => string | undefined;
+/**
+ * Convert AG Grid sort model to DataSource format
+ */
+export declare const convertSortModelToDataSource: (sortModel: SortModelItem[]) => string[];
+/**
+ * Get initial sort model from DataSource
+ */
+export declare const getInitialSortModel: (dataSource: any) => SortModelItem[];
+/**
+ * Convert ArchbaseActiveFilter[] to AG Grid filter model
+ */
+export declare const convertActiveFiltersToAgGridModel: (activeFilters: ArchbaseActiveFilter[]) => Record<string, any>;
+/**
+ * Convert columns to ArchbaseFilterDefinition[]
+ */
+export declare const convertColumnsToFilterDefinitions: (columns: ColDef[], options?: {
+    includeColumns?: string[];
+    excludeColumns?: string[];
+    onlyFilterable?: boolean;
+}) => ArchbaseFilterDefinition[];
+/**
+ * Get AG Grid filter type from data type
+ */
+export declare const getAgGridFilterType: (dataType: string) => string;
+/**
+ * Get alignment class for AG Grid
+ */
+export declare const getAlignmentClass: (align?: "left" | "center" | "right") => string;
+/**
+ * Get default alignment by data type
+ */
+export declare const getDefaultAlignment: (dataType: string) => "left" | "center" | "right";

package/dist/datagrid/ag-grid/archbase-data-grid-ag.d.ts

@@ -0,0 +1,14 @@
+import { ArchbaseDataGridAGProps } from './archbase-data-grid-ag-types';
+/**
+ * ArchbaseDataGridAG Component
+ *
+ * A feature-rich data grid using AG Grid Community with:
+ * - Mantine theme integration
+ * - DataSource V1/V2 compatibility
+ * - Server-side pagination, sorting, filtering
+ * - Row selection
+ * - Detail panels
+ * - Export/Print functionality
+ */
+declare function ArchbaseDataGridAG<T extends object = any, ID = any>(props: ArchbaseDataGridAGProps<T, ID>): import("react/jsx-runtime").JSX.Element;
+export default ArchbaseDataGridAG;

package/dist/datagrid/ag-grid/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AG Grid Implementation Exports
+ *
+ * Export all AG Grid related components, types, and utilities.
+ * Also exports with original names (ArchbaseDataGrid, etc.) to replace MUI DataGrid implementation.
+ */
+export { default as ArchbaseDataGridAG } from './archbase-data-grid-ag';
+export { default as ArchbaseDataGrid } from './archbase-data-grid-ag';
+export type { ArchbaseDataGridAGProps, ArchbaseDataGridAGProps as ArchbaseDataGridProps, ArchbaseDataGridAGRef, ArchbaseDataGridAGRef as ArchbaseDataGridRef, ArchbaseDataGridAGColumnProps, ArchbaseDataGridAGColumnProps as ArchbaseDataGridColumnProps, FieldDataType, CellClickEvent, GridToolBarActionsProps, GridColumnsProps, ExtendedColDef, } from './archbase-data-grid-ag-types';
+export { ArchbaseDataGridAGColumn, ArchbaseDataGridAGColumn as ArchbaseDataGridColumn, Columns as AGColumns, Columns, GridToolBarActions as AGGridToolBarActions, GridToolBarActions, defaultColumnProps as defaultAGColumnProps, defaultColumnProps, } from './archbase-data-grid-ag-types';
+export { createArchbaseAgGridTheme, getAgGridMantineCssVars, } from './ag-grid-mantine-theme';
+export { AG_GRID_LOCALE_PTBR } from './ag-grid-locale-ptbr';
+export { safeGetRowId as agSafeGetRowId, isDataSourceV2 as agIsDataSourceV2, getRecordsFromDataSource as agGetRecordsFromDataSource, getDataSourceOptions as agGetDataSourceOptions, getCurrentPageFromDataSource as agGetCurrentPageFromDataSource, buildFilterExpression as agBuildFilterExpression, buildGlobalFilterExpression as agBuildGlobalFilterExpression, convertSortModelToDataSource as agConvertSortModelToDataSource, getInitialSortModel as agGetInitialSortModel, convertActiveFiltersToAgGridModel, convertColumnsToFilterDefinitions as agConvertColumnsToFilterDefinitions, getAgGridFilterType, getAlignmentClass, getDefaultAlignment, hexToRgb as agHexToRgb, MAX_PAGE_SIZE as AG_MAX_PAGE_SIZE, } from './archbase-data-grid-ag-utils';
+export { TextCellRenderer, IntegerCellRenderer, FloatCellRenderer, CurrencyCellRenderer, PercentCellRenderer, BooleanCellRenderer, DateCellRenderer, DateTimeCellRenderer, TimeCellRenderer, EnumCellRenderer, UUIDCellRenderer, ImageCellRenderer, getCellRendererByDataType, getAlignmentByDataType as agGetAlignmentByDataType, createValueFormatter, } from './archbase-data-grid-ag-formatters';

package/dist/datagrid/index.d.ts

@@ -1,7 +1,15 @@
-export * from './main';
+/**
+ * DataGrid Exports
+ *
+ * A implementação principal agora é AG Grid.
+ * Os exports principais (ArchbaseDataGrid, ArchbaseDataGridColumn, etc.) vêm do AG Grid.
+ * Utilitários auxiliares da implementação antiga ainda são exportados para compatibilidade.
+ */
+export * from './ag-grid';
 export * from './components';
 export * from './hooks';
 export * from './utils';
 export * from './modals';
 export * from './types';
 export * from './export';
+export { ArchbaseDetailPanel, ArchbaseDetailModal, ArchbaseDetailDrawer, ArchbaseDetailPopover, ArchbaseDetailHoverCard, ArchbaseDataGridToolbar, ArchbaseDataGridPagination, ArchbaseExpandButton, createExpandColumn, ArchbaseGridRowActions, createDataTableRowActions, renderText, renderInteger, renderCurrency, renderFloat, renderPercent, renderBoolean, renderDate, renderDateTime, renderTime, renderEnum, renderUUID, getRendererByDataType, safeGetRowId, buildGlobalFilterExpression, buildFilterExpression, getRgbValues, getInitialSortModel, } from './main';