@shival99/z-ui 2.6.0 → 2.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shival99/z-ui",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Z-UI: Modern Angular UI Component Library - A comprehensive, high-performance design system built with Angular 22, featuring 45+ customizable components with dark mode, accessibility, and enterprise-ready features.",
   "keywords": [
     "angular",

package/types/shival99-z-ui-components-z-editor.d.ts

@@ -24,7 +24,8 @@ declare const zEditorVariants: (props?: ({
 type ZEditorVariants = VariantProps<typeof zEditorVariants>;
 type ZEditorSize = 'sm' | 'default' | 'lg';
 type ZEditorContentType = 'html' | 'json' | 'markdown';
-type ZEditorToolbarCommand = 'bold' | 'italic' | 'underline' | 'strike' | 'code' | 'blockStyle' | 'heading1' | 'heading2' | 'heading3' | 'heading4' | 'small' | 'paragraph' | 'bulletList' | 'orderedList' | 'blockquote' | 'codeBlock' | 'horizontalRule' | 'link' | 'image' | 'emoji' | 'textColor' | 'backgroundColor' | 'align' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'undo' | 'redo' | 'clearFormatting';
+type ZEditorLineHeight = '1' | '1.15' | '1.5' | '1.75' | '2';
+type ZEditorToolbarCommand = 'bold' | 'italic' | 'underline' | 'strike' | 'code' | 'blockStyle' | 'heading1' | 'heading2' | 'heading3' | 'heading4' | 'small' | 'paragraph' | 'bulletList' | 'orderedList' | 'blockquote' | 'codeBlock' | 'lineHeight' | 'horizontalRule' | 'link' | 'image' | 'emoji' | 'textColor' | 'backgroundColor' | 'align' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'undo' | 'redo' | 'clearFormatting';
 interface ZEditorToolbarItem {
     id: ZEditorToolbarCommand;
     icon: ZIcon;
@@ -166,6 +167,7 @@ declare class ZEditorComponent implements OnInit, ControlValueAccessor {
     protected readonly linkValidators: ZInputValidator[];
     protected readonly textColorSwatches: readonly string[];
     protected readonly backgroundColorSwatches: readonly string[];
+    protected readonly lineHeightOptions: readonly ZEditorLineHeight[];
     protected readonly slashCommands: readonly ZEditorSlashCommandItem[];
     protected readonly blockStyleOptions: readonly {
         command: Extract<ZEditorToolbarCommand, 'paragraph' | 'heading1' | 'heading2' | 'heading3' | 'heading4'>;
@@ -195,6 +197,7 @@ declare class ZEditorComponent implements OnInit, ControlValueAccessor {
     private _alignPopoverControl;
     private _textColorPopoverControl;
     private _backgroundColorPopoverControl;
+    private _lineHeightPopoverControl;
     private _slashMenuPopoverControl;
     private _dismissedSlashMenu;
     private _linkPopoverControl;
@@ -223,6 +226,7 @@ declare class ZEditorComponent implements OnInit, ControlValueAccessor {
     protected readonly activeAlign: _angular_core.Signal<"alignLeft" | "alignCenter" | "alignRight" | "alignJustify">;
     protected readonly activeAlignLabel: _angular_core.Signal<string>;
     protected readonly activeAlignIcon: _angular_core.Signal<ZIcon>;
+    protected readonly activeLineHeight: _angular_core.Signal<ZEditorLineHeight | null>;
     protected readonly filteredSlashCommands: _angular_core.Signal<ZEditorSlashCommandViewItem[]>;
     protected readonly canApplyLink: _angular_core.Signal<boolean>;
     protected readonly effectivePlaceholder: _angular_core.Signal<string>;
@@ -275,12 +279,14 @@ declare class ZEditorComponent implements OnInit, ControlValueAccessor {
     protected applySlashCommand(item: ZEditorSlashCommandItem): void;
     protected applyBlockStyle(command: Extract<ZEditorToolbarCommand, 'paragraph' | 'heading1' | 'heading2' | 'heading3' | 'heading4'>, closePopover?: () => void): void;
     protected applyAlign(command: Extract<ZEditorToolbarCommand, 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify'>, closePopover?: () => void): void;
+    protected applyLineHeight(value: ZEditorLineHeight, closePopover?: () => void): void;
     protected insertEmoji(emoji: string): void;
     protected setEmojiCategory(categoryId: string): void;
     protected onEmojiPopoverControl(control: ZPopoverControl): void;
     protected onEmojiPopoverShow(): void;
     protected onBlockStylePopoverControl(control: ZPopoverControl): void;
     protected onAlignPopoverControl(control: ZPopoverControl): void;
+    protected onLineHeightPopoverControl(control: ZPopoverControl): void;
     protected onTextColorPopoverControl(control: ZPopoverControl): void;
     protected onBackgroundColorPopoverControl(control: ZPopoverControl): void;
     protected onSlashMenuPopoverControl(control: ZPopoverControl): void;
@@ -325,6 +331,7 @@ declare class ZEditorComponent implements OnInit, ControlValueAccessor {
     private _getActiveBlockStyle;
     private _getActiveAlign;
     private _getActiveAlignFromEditor;
+    private _getActiveLineHeight;
     private _createImageExtension;
     private static _getImageAlignStyle;
     private _placeholderConfig;
@@ -336,4 +343,4 @@ declare class ZEditorComponent implements OnInit, ControlValueAccessor {
 declare const Z_EDITOR_DEFAULT_TOOLBAR: readonly ZEditorToolbarItem[];
 
 export { ZEditorComponent, Z_EDITOR_DEFAULT_TOOLBAR, zEditorVariants };
-export type { ZEditorContentType, ZEditorControl, ZEditorResolvedToolbarItem, ZEditorSize, ZEditorTipTapOptions, ZEditorToolbarCommand, ZEditorToolbarItem, ZEditorValidator, ZEditorVariants };
+export type { ZEditorContentType, ZEditorControl, ZEditorLineHeight, ZEditorResolvedToolbarItem, ZEditorSize, ZEditorTipTapOptions, ZEditorToolbarCommand, ZEditorToolbarItem, ZEditorValidator, ZEditorVariants };

package/types/shival99-z-ui-components-z-table.d.ts

@@ -35,7 +35,7 @@ import * as _shival99_z_ui_components_z_table from '@shival99/z-ui/components/z-
  */
 
 /** Z-UI's backwards-compatible physical pinning contract. */
-interface ColumnPinningState {
+interface ZColumnPinningState {
     left?: string[];
     right?: string[];
 }
@@ -60,6 +60,7 @@ interface ZTableIconPart {
     strokeWidth?: number;
 }
 type ZTableAlign = 'left' | 'center' | 'right';
+type ZTableVerticalAlign = 'top' | 'middle' | 'bottom';
 type ZTableBodyContentType = 'default' | 'tag';
 type ZTableColumnType = 'data' | 'select' | 'expand' | 'rowDrag' | 'rowPin' | 'actions';
 type ZTableTagColor = ZTagColor;
@@ -328,6 +329,12 @@ interface ZTableBodyColumnConfig<T> {
     class?: string | ((info: CellContext<T, unknown>) => string);
     style?: Record<string, string> | ((info: CellContext<T, unknown>) => Record<string, string>);
     align?: ZTableAlign;
+    /**
+     * Vertical alignment of the cell's content. Defaults to 'top' when the cell has an active
+     * rowSpan (merging multiple rows) so tall merged cells stay readable, and to the browser's
+     * normal 'middle' otherwise. Set explicitly to center content in a merged cell instead.
+     */
+    verticalAlign?: ZTableVerticalAlign | ((info: CellContext<T, unknown>) => ZTableVerticalAlign);
     /** Static rowSpan or function returning 0 to hide the cell (merged into neighbor) */
     rowSpan?: number | ((info: CellContext<T, unknown>) => number);
     colSpan?: number | ((info: CellContext<T, unknown>) => number);
@@ -813,7 +820,7 @@ interface ZTableCellEditChange<T> extends ZTableChangeEventBase {
 type ZTableChangeEvent<T> = ZTablePageChange | ZTableSortChange | ZTableFilterChange | ZTableSearchChange | ZTableSelectChange | ZTableExpandChange | ZTableGroupingChange | ZTableGroupExpandChange | ZTableRowSelectChange<T> | ZTableRowSelectAllChange<T> | ZTableRowExpandChange<T> | ZTableRowDragChange<T> | ZTableRowInsertChange<T> | ZTableRowDeleteChange<T> | ZTableRowCopyChange<T> | ZTableRowPasteChange<T> | ZTableRowMoveChange<T> | ZTableCellClickChange<T> | ZTableCellEditChange<T> | ZTableActionChange<T> | ZTableBulkActionChange<T>;
 /** Initial table state — applied on first render, before any cached config is loaded */
 interface ZTableInitialState {
-    columnPinning?: ColumnPinningState;
+    columnPinning?: ZColumnPinningState;
     rowPinning?: RowPinningState;
     sorting?: SortingState;
     columnFilters?: ColumnFiltersState;
@@ -1161,7 +1168,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly expandedRowTemplate: _angular_core.Signal<TemplateRef<unknown> | undefined>;
     protected readonly virtualRowElements: _angular_core.Signal<readonly ElementRef<HTMLDivElement>[]>;
     protected readonly groupRowElements: _angular_core.Signal<readonly ElementRef<HTMLTableRowElement>[]>;
-    protected readonly columnPinning: _angular_core.WritableSignal<ColumnPinningState>;
+    protected readonly columnPinning: _angular_core.WritableSignal<ZColumnPinningState>;
     protected readonly columnVisibility: _angular_core.WritableSignal<ColumnVisibilityState>;
     protected readonly columnOrder: _angular_core.WritableSignal<ColumnOrderState>;
     protected readonly expanded: _angular_core.WritableSignal<ExpandedState>;
@@ -1239,6 +1246,10 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly showHorizontalBorder: _angular_core.WritableSignal<boolean>;
     protected readonly showVerticalBorder: _angular_core.WritableSignal<boolean>;
     protected readonly showHeaderFooterShadow: _angular_core.WritableSignal<boolean>;
+    /** True when the body viewport is at its top boundary. */
+    protected readonly isBodyAtTop: _angular_core.WritableSignal<boolean>;
+    /** True when the body viewport is at its bottom boundary. */
+    protected readonly isBodyAtBottom: _angular_core.WritableSignal<boolean>;
     protected readonly bulkBarMounted: _angular_core.WritableSignal<boolean>;
     protected readonly bulkBarClosing: _angular_core.WritableSignal<boolean>;
     protected readonly bulkBarConfig: _angular_core.WritableSignal<ZTableBulkActionOptions<T> | null>;
@@ -2168,7 +2179,7 @@ declare class ZTableFilterComponent<T> {
     protected readonly filterBadgeCount: _angular_core.Signal<number>;
     protected readonly hasFilterValue: _angular_core.Signal<boolean>;
     protected readonly isActive: _angular_core.Signal<boolean>;
-    protected readonly draftSortValue: _angular_core.Signal<"none" | "asc" | "desc">;
+    protected readonly draftSortValue: _angular_core.Signal<"asc" | "desc" | "none">;
     protected readonly rangeMinValue: _angular_core.Signal<any>;
     protected readonly rangeMaxValue: _angular_core.Signal<any>;
     protected readonly dateValue: _angular_core.Signal<Date | null>;
@@ -2240,7 +2251,7 @@ declare class ZTableActionsComponent<T = unknown> {
     readonly zConfig: _angular_core.InputSignal<ZTableActionColumnConfig<T>>;
     readonly zRow: _angular_core.InputSignal<T>;
     readonly zRowId: _angular_core.InputSignal<string>;
-    readonly zDropdownButtonSize: _angular_core.InputSignal<"sm" | "default" | "lg" | "xs" | "xl" | null | undefined>;
+    readonly zDropdownButtonSize: _angular_core.InputSignal<"default" | "sm" | "lg" | "xs" | "xl" | null | undefined>;
     readonly zActionClick: _angular_core.OutputEmitterRef<ZTableActionClickEvent<T>>;
     protected readonly allActions: _angular_core.Signal<ZTableActionItem<T>[]>;
     protected readonly shouldShowAsButtons: _angular_core.Signal<boolean>;
@@ -2340,6 +2351,7 @@ declare const getBodyConfig: <T>(col: ZTableColumnConfig<T> | undefined, ctx?: C
     class: string | undefined;
     style: Record<string, string> | undefined;
     align: string | undefined;
+    verticalAlign: ZTableVerticalAlign | undefined;
     rowSpan: number | undefined;
     colSpan: number | undefined;
     contentClass: string | undefined;
@@ -2353,6 +2365,7 @@ declare const getBodyConfig: <T>(col: ZTableColumnConfig<T> | undefined, ctx?: C
     class: string | ((info: CellContext<T, unknown>) => string) | undefined;
     style: Record<string, string> | undefined;
     align: ZTableAlign | undefined;
+    verticalAlign: ZTableVerticalAlign | ((info: CellContext<T, unknown>) => ZTableVerticalAlign) | undefined;
     rowSpan: number | undefined;
     colSpan: number | undefined;
     contentClass: string | ((info: CellContext<T, unknown>) => string) | undefined;
@@ -2397,4 +2410,4 @@ declare const findColumnConfig: <T>(columnId: string, columns: ZTableColumnConfi
 declare function columnConfigToColumnDef<T>(config: ZTableColumnConfig<T>): ColumnDef<T>;
 
 export { ZTableActionsComponent, ZTableComponent, ZTableEditCellComponent, ZTableFilterComponent, ZTableIconTextComponent, columnConfigToColumnDef, findColumnConfig, getBodyConfig, getFooterConfig, getHeaderConfig, isBodyConfig, isFooterConfig, isHeaderConfig };
-export type { Cell, CellContext, Column, ColumnDef, Header, HeaderContext, Row, Table, ZTableActionBodyConfig, ZTableActionClickEvent, ZTableActionColumnConfig, ZTableActionItem, ZTableActionList, ZTableAdvancedFilterType, ZTableBodyContentType, ZTableBulkActionClickEvent, ZTableBulkActionConfig, ZTableBulkActionContext, ZTableBulkActionHandlerContext, ZTableBulkActionItem, ZTableBulkActionList, ZTableBulkActionOptions, ZTableBulkActionViewItem, ZTableCellEditChange, ZTableCellEditEvent, ZTableChangeEvent, ZTableColumn, ZTableColumnConfig, ZTableConfig, ZTableControl, ZTableEditCellChangeEvent, ZTableEditConfig, ZTableEditContentConfig, ZTableEditContentType, ZTableEditSize, ZTableEditType, ZTableExcelExportConfig, ZTableExcelExportContext, ZTableExcelExportScope, ZTableFilterChangeEvent, ZTableFilterCondition, ZTableFilterConfig, ZTableFilterJoinOperator, ZTableFilterOperator, ZTableFilterOptionSource, ZTableFilterUi, ZTableFilterValueType, ZTableGroupExpandChange, ZTableGroupExpandEvent, ZTableGroupingConfig, ZTableGroupingMode, ZTablePageChangeEvent, ZTablePaginationConfig, ZTableRowCopyChange, ZTableRowCopyEvent, ZTableRowDeleteChange, ZTableRowDeleteEvent, ZTableRowExpandEvent, ZTableRowInsertChange, ZTableRowInsertEvent, ZTableRowInsertPosition, ZTableRowMoveChange, ZTableRowMoveDirection, ZTableRowMoveEvent, ZTableRowPasteChange, ZTableRowPasteEvent, ZTableRowSelectEvent, ZTableSearchChangeEvent, ZTableSearchConfig, ZTableServerGroup, ZTableSortChangeEvent, ZTableSortConfig, ZTableTagColor };
+export type { Cell, CellContext, Column, ColumnDef, Header, HeaderContext, Row, Table, ZTableActionBodyConfig, ZTableActionClickEvent, ZTableActionColumnConfig, ZTableActionItem, ZTableActionList, ZTableAdvancedFilterType, ZTableBodyContentType, ZTableBulkActionClickEvent, ZTableBulkActionConfig, ZTableBulkActionContext, ZTableBulkActionHandlerContext, ZTableBulkActionItem, ZTableBulkActionList, ZTableBulkActionOptions, ZTableBulkActionViewItem, ZTableCellEditChange, ZTableCellEditEvent, ZTableChangeEvent, ZTableColumn, ZTableColumnConfig, ZTableConfig, ZTableControl, ZTableEditCellChangeEvent, ZTableEditConfig, ZTableEditContentConfig, ZTableEditContentType, ZTableEditSize, ZTableEditType, ZTableExcelExportConfig, ZTableExcelExportContext, ZTableExcelExportScope, ZTableFilterChangeEvent, ZTableFilterCondition, ZTableFilterConfig, ZTableFilterJoinOperator, ZTableFilterOperator, ZTableFilterOptionSource, ZTableFilterUi, ZTableFilterValueType, ZTableGroupExpandChange, ZTableGroupExpandEvent, ZTableGroupingConfig, ZTableGroupingMode, ZTablePageChangeEvent, ZTablePaginationConfig, ZTableRowCopyChange, ZTableRowCopyEvent, ZTableRowDeleteChange, ZTableRowDeleteEvent, ZTableRowExpandEvent, ZTableRowInsertChange, ZTableRowInsertEvent, ZTableRowInsertPosition, ZTableRowMoveChange, ZTableRowMoveDirection, ZTableRowMoveEvent, ZTableRowPasteChange, ZTableRowPasteEvent, ZTableRowSelectEvent, ZTableSearchChangeEvent, ZTableSearchConfig, ZTableServerGroup, ZTableSortChangeEvent, ZTableSortConfig, ZTableTagColor, ZTableVerticalAlign };