@alaarab/ogrid-mcp 2.15.3 → 2.17.0

package/bundled-docs/api/components-pagination-controls.mdx

@@ -28,8 +28,8 @@ A pagination UI component that displays page navigation buttons, current page in
 | `pageSize` | `number` | **Required** | Number of items per page. |
 | `totalCount` | `number` | **Required** | Total number of items across all pages. |
 | `onPageChange` | `(page: number) => void` | **Required** | Callback when user navigates to a different page. |
-| `onPageSizeChange` | `(pageSize: number) => void` | **Required** | Callback when user changes the page size. |
-| `pageSizeOptions` | `number[]` | `[10, 20, 50, 100]` | Available page size options in the dropdown. |
+| `onPageSizeChange` | `(pageSize: number \| 'all') => void` | **Required** | Callback when user changes the page size. |
+| `pageSizeOptions` | `(number \| 'all')[]` | `[10, 20, 50, 100]` | Available page size options in the dropdown. `'all'` renders as "All" and shows every row on one page. |
 | `entityLabelPlural` | `string` | `'rows'` | Plural label for items (e.g., `'products'`, `'users'`). |
 | `className` | `string` | `undefined` | Additional CSS class for the root element. |
 

package/bundled-docs/api/ogrid-props.mdx

@@ -49,9 +49,9 @@ Complete reference for `IOGridProps<T>`, the props accepted by the `OGrid` compo
 | `page` | `number` | `undefined` | Controlled current page (1-based). |
 | `pageSize` | `number` | `undefined` | Controlled page size. |
 | `onPageChange` | `(page: number) => void` | `undefined` | Callback fired when the user navigates to a different page. |
-| `onPageSizeChange` | `(size: number) => void` | `undefined` | Callback fired when the user changes the page size. |
-| `defaultPageSize` | `number` | `25` | Initial page size in uncontrolled mode. |
-| `pageSizeOptions` | `number[]` | `[10, 25, 50, 100]` | Options shown in the page size dropdown. The active page size is auto-inserted if missing. |
+| `onPageSizeChange` | `(size: number \| 'all') => void` | `undefined` | Callback fired when the user changes the page size. |
+| `defaultPageSize` | `number \| 'all'` | `25` | Initial page size in uncontrolled mode. `'all'` shows every row on one page. |
+| `pageSizeOptions` | `(number \| 'all')[]` | `[10, 25, 50, 100]` | Options shown in the page size dropdown. Include `'all'` to offer an "All" entry that shows every filtered row on one page. The active page size is auto-inserted if missing. |
 
 ## Column Visibility and Order
 

package/bundled-docs/features/pagination.mdx

@@ -126,12 +126,12 @@ function App() {
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `defaultPageSize` | `number` | `25` | Initial page size (uncontrolled mode). |
-| `pageSizeOptions` | `number[]` | `[10, 25, 50, 100]` | Options shown in the page size dropdown. If the active page size isn't in the list, it's auto-inserted. |
+| `defaultPageSize` | `number \| 'all'` | `25` | Initial page size (uncontrolled mode). `'all'` shows every row on one page. |
+| `pageSizeOptions` | `(number \| 'all')[]` | `[10, 25, 50, 100]` | Options shown in the page size dropdown. Include `'all'` for an "All" entry that shows every filtered row on one page (e.g. `[50, 250, 500, 'all']`). If the active page size isn't in the list, it's auto-inserted. |
 | `page` | `number` | -- | Current page number (controlled mode, 1-indexed). |
-| `pageSize` | `number` | -- | Rows per page (controlled mode). |
+| `pageSize` | `number \| 'all'` | -- | Rows per page (controlled mode). |
 | `onPageChange` | `(page: number) => void` | -- | Called when page changes. |
-| `onPageSizeChange` | `(size: number) => void` | -- | Called when page size changes. |
+| `onPageSizeChange` | `(size: number \| 'all') => void` | -- | Called when page size changes. |
 | `entityLabelPlural` | `string` | `'items'` | Label used in the row count summary (e.g., "Showing 1-25 of 100 **projects**"). |
 
 ## Related

package/dist/esm/bridge-client.d.ts

@@ -25,18 +25,18 @@
  *
  * This module contains NO Node.js-specific imports  -  safe to bundle in browsers.
  */
-interface BridgeColumnInfo {
+export interface BridgeColumnInfo {
     columnId: string;
     headerName?: string;
     type?: string;
 }
-interface BridgeCommand {
+export interface BridgeCommand {
     id: string;
     type: 'update_cell' | 'set_filter' | 'clear_filters' | 'set_sort' | 'go_to_page';
     payload: Record<string, unknown>;
 }
 /** Minimal subset of IOGridApi used by the bridge. */
-interface BridgeGridApi {
+export interface BridgeGridApi {
     updateSort?: (model: Array<{
         columnId: string;
         direction: 'asc' | 'desc';
@@ -46,7 +46,7 @@ interface BridgeGridApi {
     goToPage?: (page: number) => void;
     getSelectedRows?: () => unknown[];
 }
-interface ConnectGridOptions {
+export interface ConnectGridOptions {
     /** Unique identifier for this grid instance (shown in list_grids). */
     gridId: string;
     /** Returns the currently displayed rows. Called on every state push. */
@@ -76,12 +76,10 @@ interface ConnectGridOptions {
     /** How often to push state and poll commands (ms, default: 500). */
     pollIntervalMs?: number;
 }
-interface BridgeConnection {
+export interface BridgeConnection {
     /** Stop polling and disconnect. */
     disconnect: () => void;
     /** Manually push current state immediately. */
     push: () => Promise<void>;
 }
-declare function connectGridToBridge(options: ConnectGridOptions): BridgeConnection;
-
-export { type BridgeColumnInfo, type BridgeCommand, type BridgeConnection, type BridgeGridApi, type ConnectGridOptions, connectGridToBridge };
+export declare function connectGridToBridge(options: ConnectGridOptions): BridgeConnection;

package/dist/esm/bridge.d.ts

@@ -0,0 +1,66 @@
+/**
+ * OGrid Live Testing Bridge
+ *
+ * An HTTP server (default port 7890) that running OGrid instances connect to.
+ * The MCP server holds a BridgeStore in-process and queries it directly when
+ * tools like list_grids / get_grid_state / send_grid_command are invoked.
+ *
+ * Protocol (used by bridge-client.ts in the browser):
+ *   POST   /grids/connect                -  register / heartbeat
+ *   PUT    /grids/:id/state              -  push current grid state
+ *   GET    /grids/:id/commands           -  poll for pending commands
+ *   POST   /grids/:id/commands/:cmdId/result   -  post command result
+ *
+ * Internal (used by MCP tools via BridgeStore directly):
+ *   bridgeStore.listGrids()
+ *   bridgeStore.getState(gridId)
+ *   bridgeStore.enqueueCommand(gridId, cmd)
+ *   bridgeStore.waitForResult(cmdId, timeoutMs)
+ */
+export interface GridColumnInfo {
+    columnId: string;
+    headerName?: string;
+    type?: string;
+}
+export interface GridStateSnapshot {
+    gridId: string;
+    connectedAt: number;
+    lastSeen: number;
+    rowCount: number;
+    totalCount: number;
+    page: number;
+    pageSize: number;
+    pageCount: number;
+    data: unknown[];
+    columns: GridColumnInfo[];
+    sortModel: Array<{
+        columnId: string;
+        direction: 'asc' | 'desc';
+    }>;
+    filterModel: Record<string, unknown>;
+    selectedRowIndices: number[];
+}
+export type GridCommandType = 'update_cell' | 'set_filter' | 'clear_filters' | 'set_sort' | 'go_to_page';
+export interface GridCommand {
+    id: string;
+    type: GridCommandType;
+    payload: Record<string, unknown>;
+    createdAt: number;
+    status: 'pending' | 'completed' | 'error';
+    result?: unknown;
+    error?: string;
+}
+export declare class BridgeStore {
+    private readonly grids;
+    private readonly commandQueues;
+    private readonly commandResults;
+    private cmdSeq;
+    upsertGrid(gridId: string, partial: Partial<GridStateSnapshot>): void;
+    popPendingCommands(gridId: string): GridCommand[];
+    resolveCommand(cmdId: string, result: unknown, error?: string): void;
+    listGrids(): GridStateSnapshot[];
+    getState(gridId: string): GridStateSnapshot | undefined;
+    enqueueCommand(gridId: string, type: GridCommandType, payload: Record<string, unknown>): GridCommand | null;
+    waitForResult(cmdId: string, timeoutMs?: number): Promise<GridCommand>;
+}
+export declare function startBridgeServer(store: BridgeStore, port?: number): Promise<() => Promise<void>>;

package/dist/esm/docsLoader.d.ts

@@ -0,0 +1,24 @@
+export interface CodeBlock {
+    language: string;
+    code: string;
+    framework?: string;
+}
+export interface DocEntry {
+    path: string;
+    title: string;
+    description: string;
+    category: string;
+    content: string;
+    codeBlocks: CodeBlock[];
+}
+export interface DocsIndex {
+    entries: DocEntry[];
+    search(query: string, limit?: number): DocEntry[];
+    getByPath(path: string): DocEntry | undefined;
+    getByCategory(category: string): DocEntry[];
+    getCodeExamples(query: string, framework?: string): Array<{
+        entry: DocEntry;
+        block: CodeBlock;
+    }>;
+}
+export declare function loadDocsIndex(docsDir: string): DocsIndex;

package/dist/esm/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { DocsIndex } from './docsLoader.js';
+import type { BridgeStore } from './bridge.js';
+export declare function createOGridMcpServer(index: DocsIndex, bridge?: BridgeStore): McpServer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alaarab/ogrid-mcp",
-  "version": "2.15.3",
+  "version": "2.17.0",
   "description": "MCP server for OGrid documentation",
   "type": "module",
   "repository": {
@@ -28,18 +28,18 @@
   ],
   "scripts": {
     "prebuild": "node scripts/bundle-docs.mjs",
-    "build": "tsup",
+    "build": "tsup && tsc -p tsconfig.json --emitDeclarationOnly --outDir dist/esm",
     "dev": "tsup --watch",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "bun test --preload ../../bun-test.setup.ts"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "zod": "^4.4.3"
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.5.4"
   },
   "devDependencies": {
     "tsup": "^8.5.1",
-    "typescript": "^6.0.3"
+    "typescript": "^7.0.2"
   },
   "engines": {
     "node": ">=18"