@keenmate/web-grid 1.0.0-rc04 → 1.0.0-rc05

package/README.md

@@ -71,7 +71,10 @@ npm install @keenmate/web-grid
 | `hoverable` | `boolean` | `false` | Highlight row on hover |
 | `showRowToolbar` | `boolean` | `false` | Show row action toolbar |
 | `rowToolbar` | `Array` | `[]` | Toolbar items configuration |
-| `toolbarTrigger` | `string` | `'hover'` | Toolbar trigger: `'hover'`, `'button'` |
+| `toolbarTrigger` | `string` | `'hover'` | Toolbar trigger: `'hover'`, `'click'`, `'button'` |
+| `toolbarPosition` | `string` | `'auto'` | Toolbar position: `'auto'`, `'left'`, `'right'`, `'top'` |
+| `toolbarAlign` | `string` | `'center'` | Vertical alignment for left/right: `'center'`, `'top'` |
+| `toolbarTopPosition` | `string` | `'center'` | Horizontal position for top: `'start'`, `'center'`, `'end'`, `'cursor'` |
 | `contextMenu` | `Array` | `[]` | Context menu items |
 | `validationTooltipCallback` | `Function` | `undefined` | Custom HTML tooltip for validation errors: `({ field, error, value, row, rowIndex }) => htmlString` |
 
@@ -128,6 +131,11 @@ grid.rowToolbar = [
     onclick: ({ row, rowIndex }) => { /* ... */ }
   }
 ]
+
+// Positioning
+grid.toolbarPosition = 'left'     // Prefer left side (falls back if no space)
+grid.toolbarAlign = 'top'         // Align to top of row (for left/right position)
+grid.toolbarTopPosition = 'cursor' // Position at cursor (for top position)
 ```
 
 ## Context Menu

package/component-variables.manifest.json

@@ -14,6 +14,7 @@
     { "name": "base-main-bg", "required": true, "usage": "Table background, cell background, inputs" },
     { "name": "base-elevated-bg", "required": true, "usage": "Header background, striped rows, pagination buttons" },
     { "name": "base-hover-bg", "required": false, "usage": "Hover states, sorted header, active buttons" },
+    { "name": "base-disabled-bg", "required": false, "usage": "Readonly/disabled cell backgrounds" },
     { "name": "base-dropdown-bg", "required": false, "usage": "Toolbar, context menu, floating surfaces" },
     { "name": "base-border-color", "required": true, "usage": "Table, cell, header, toolbar borders" },
     { "name": "base-input-bg", "required": false, "usage": "Filter input, editor backgrounds" },

package/dist/grid.d.ts

@@ -30,6 +30,7 @@ export declare class WebGrid<T = unknown> {
     protected _toolbarAlign: 'center' | 'top';
     protected _toolbarTopPosition: 'start' | 'center' | 'end' | 'cursor';
     protected _toolbarTrigger: 'hover' | 'click' | 'button';
+    protected _toolbarPosition: 'auto' | 'left' | 'right' | 'top';
     protected _contextMenu: ContextMenuItem<T>[] | undefined;
     protected _onrowchange: ((detail: RowChangeDetail<T>) => void) | undefined;
     protected _onroweditstart: ((detail: {
@@ -148,6 +149,8 @@ export declare class WebGrid<T = unknown> {
     set toolbarTopPosition(value: 'start' | 'center' | 'end' | 'cursor');
     get toolbarTrigger(): 'hover' | 'click' | 'button';
     set toolbarTrigger(value: 'hover' | 'click' | 'button');
+    get toolbarPosition(): 'auto' | 'left' | 'right' | 'top';
+    set toolbarPosition(value: 'auto' | 'left' | 'right' | 'top');
     get contextMenu(): ContextMenuItem<T>[] | undefined;
     set contextMenu(value: ContextMenuItem<T>[] | undefined);
     get sort(): SortState[];

package/dist/modules/toolbar/index.d.ts

@@ -47,6 +47,7 @@ export declare function getConnectorState(): ConnectorState;
 /**
  * Update connector path after row has moved
  * Call this after a moveUp/moveDown action to draw the bracket-shaped connector
+ * The connector is clipped at grid container boundaries
  */
 export declare function updateConnector<T>(ctx: GridContext<T>, displayItems: T[]): void;
 /**

package/dist/types.d.ts

@@ -224,6 +224,7 @@ export type QuickGridProps<T> = {
     toolbarAlign?: 'center' | 'top';
     toolbarTopPosition?: 'start' | 'center' | 'end' | 'cursor';
     toolbarTrigger?: 'hover' | 'click' | 'button';
+    toolbarPosition?: 'auto' | 'left' | 'right' | 'top';
     showRowActions?: boolean;
     rowActions?: RowToolbarConfig<T>[];
     contextMenu?: ContextMenuItem<T>[];

package/dist/web-component.d.ts

@@ -109,6 +109,8 @@ export declare class GridElement<T = unknown> extends HTMLElement implements Gri
     set toolbarTopPosition(value: 'start' | 'center' | 'end' | 'cursor');
     get toolbarTrigger(): 'hover' | 'click' | 'button';
     set toolbarTrigger(value: 'hover' | 'click' | 'button');
+    get toolbarPosition(): 'auto' | 'left' | 'right' | 'top';
+    set toolbarPosition(value: 'auto' | 'left' | 'right' | 'top');
     get contextMenu(): ContextMenuItem<T>[] | undefined;
     set contextMenu(value: ContextMenuItem<T>[] | undefined);
     get showRowActions(): boolean;