gridjs-spreadsheet 26.8.0 → 26.9.0

package/{9667af4182f3e39eec9844c10e1a6eb8.svg → 2540ca97f0253f1cda1c125495bb90fe.svg}

@@ -1194,4 +1194,24 @@
     <rect x="24" y="17" width="6" height="20" fill="#FFFFFF" id="redact-plus-v" />
   </g>
 </g>
-   &#10;    </svg>
+   &#10; <g id="RedactionSearchResult" transform="matrix(0.3033,0,0,0.3033,180,126)">
+
+  
+  
+  <!-- Unified blue-grey rounded background to indicate 'search' context -->
+  <rect x="4" y="4" width="54" height="54" fill="#56754B" rx="4" ry="4" id="bg-rect" />
+  <!-- Search results list: two white horizontal lines representing the searched content -->
+  <rect x="10" y="10" width="14" height="3" fill="#FFFFFF" rx="1.5" id="search-line-1" />
+  <rect x="10" y="16" width="14" height="3" fill="#FFFFFF" rx="1.5" id="search-line-2" />
+  
+  <!-- Magnifying glass: represents the 'search' action, positioned on the right side of the list -->
+  <circle cx="35" cy="18" r="7" fill="none" stroke="#FFFFFF" stroke-width="2.5" id="search-glass" />
+  <line x1="42" y1="23" x2="47" y2="28" stroke="#FFFFFF" stroke-width="4" stroke-linecap="round" id="search-handle" />
+
+   <g transform="translate(27, 27) scale(0.66) translate(-32, -16)">
+    <rect x="9" y="9" width="36" height="36" fill="#E53935" rx="4" ry="4" id="redact-rect" />
+    <line x1="9" y1="9" x2="45" y2="45" stroke="#FFFFFF" stroke-width="4" stroke-linecap="round" id="redact-line" />
+    <rect x="17" y="24" width="20" height="6" fill="#FFFFFF" id="redact-plus-h" />
+    <rect x="24" y="17" width="6" height="20" fill="#FFFFFF" id="redact-plus-v" />
+  </g>
+</g>  &#10;   </svg>

package/angular.d.ts

@@ -8,7 +8,7 @@ import type {
   SimpleChanges,
 } from '@angular/core';
 import type * as i0 from '@angular/core';
-import type Spreadsheet from 'gridjs-spreadsheet';
+import type Spreadsheet, { SemanticAutomationOptions } from 'gridjs-spreadsheet';
 import type { GridJsAdapter } from './shared';
 
 export declare class GridJsSpreadsheetComponent implements AfterViewInit, OnChanges, OnDestroy {
@@ -21,6 +21,7 @@ export declare class GridJsSpreadsheetComponent implements AfterViewInit, OnChan
   height: string;
   showToolbar: boolean;
   showContextmenu: boolean;
+  semanticAutomation: SemanticAutomationOptions | null;
   ready: EventEmitter<{ instance: Spreadsheet; adapter: GridJsAdapter }>;
   change: EventEmitter<any[]>;
   error: EventEmitter<any>;
@@ -47,6 +48,7 @@ export declare class GridJsSpreadsheetComponent implements AfterViewInit, OnChan
       height: { alias: 'height'; required: false };
       showToolbar: { alias: 'showToolbar'; required: false };
       showContextmenu: { alias: 'showContextmenu'; required: false };
+      semanticAutomation: { alias: 'semanticAutomation'; required: false };
     },
     {
       ready: 'ready';

package/angular.js

@@ -29,6 +29,7 @@ export class GridJsSpreadsheetComponent {
   height = 'calc(100vh - 96px)';
   showToolbar = true;
   showContextmenu = true;
+  semanticAutomation = null;
 
   ready = new EventEmitter();
   change = new EventEmitter();
@@ -80,6 +81,7 @@ export class GridJsSpreadsheetComponent {
       this.locale,
       String(this.showToolbar),
       String(this.showContextmenu),
+      JSON.stringify(this.semanticAutomation || null),
     ].join('|');
 
     if (mountKey === this.lastMountKey && this.adapter) return;
@@ -100,6 +102,7 @@ export class GridJsSpreadsheetComponent {
         token: this.token,
         showToolbar: this.showToolbar,
         showContextmenu: this.showContextmenu,
+        semanticAutomation: this.semanticAutomation,
         callbacks: {
           ready: (instance, activeAdapter) => this.zone.run(() => this.ready.emit({ instance, adapter: activeAdapter })),
           change: (...args) => this.zone.run(() => this.change.emit(args)),
@@ -154,6 +157,7 @@ GridJsSpreadsheetComponent.ɵcmp = /* @__PURE__ */ i0.ɵɵngDeclareComponent({
     height: 'height',
     showToolbar: 'showToolbar',
     showContextmenu: 'showContextmenu',
+    semanticAutomation: 'semanticAutomation',
   },
   outputs: {
     ready: 'ready',

package/example/pom.xml

@@ -17,7 +17,7 @@
 	</repositories>
 	<groupId>com.aspose.gridjs</groupId>
 	<artifactId>gridjsdemo</artifactId>
-	<version>26.8</version>
+	<version>26.9</version>
 	<name>gridjsdemo</name>
 	<description>GridJs Demo project for Spring Boot</description>
 	<properties>
@@ -51,12 +51,12 @@
 		 <dependency>  
   			<groupId>com.aspose</groupId>  
  			<artifactId>aspose-cells</artifactId>  
- 			<version>26.7</version> 
+ 			<version>26.9</version> 
  	    </dependency> 
         <dependency>  
   			<groupId>com.aspose</groupId>  
  			<artifactId>aspose-cells</artifactId>  
- 			<version>26.7</version> 
+ 			<version>26.9</version> 
  			<classifier>gridjs</classifier>  
  	    </dependency>
 	<!--	<dependency>

package/index.d.ts

@@ -69,6 +69,123 @@ declare module 'gridjs-spreadsheet' {
      * @returns Promise<string> for the new reason, or null to cancel
      */
     onRedactionAddReason?: (existingReasons: string[]) => Promise<string | null>;
+    /** Versioned Object API for AI Agent and automated tests. Disabled by default. */
+    semanticAutomation?: SemanticAutomationOptions;
+  }
+
+  export interface SemanticAutomationOptions {
+    enabled?: boolean;
+    instanceId?: string;
+  }
+
+  export type SemanticRuntimePhase =
+    | 'disabled'
+    | 'initializing'
+    | 'loading'
+    | 'rendering'
+    | 'ready'
+    | 'updating'
+    | 'failed'
+    | 'destroyed';
+
+  export interface SemanticRuntimeState {
+    contractVersion: string;
+    instanceId: string;
+    instanceGeneration: string;
+    workbookSessionId: string | null;
+    phase: SemanticRuntimePhase;
+    revision: number;
+    failure: { code: string; message: string; retryable: boolean } | null;
+    activeOperationIds: string[];
+    lastOperationId: string | null;
+    activeSheetId: string | null;
+  }
+
+  export interface SemanticOperation {
+    operationId: string;
+    kind: string;
+    action: string;
+    instanceGeneration: string;
+    workbookSessionId: string | null;
+    parentOperationId: string | null;
+    phase: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+    progress: number;
+    revision: number | null;
+    result: Record<string, any> | null;
+    error: { code: string; message: string; retryable: boolean } | null;
+  }
+
+  export interface SemanticStateRequest {
+    kind: 'workbook' | 'sheets' | 'sheet' | 'cell' | 'range' | 'selection';
+    sheetId?: string;
+    address?: string;
+    range?: string;
+    offset?: number;
+    limit?: number;
+  }
+
+  export interface SemanticStateSnapshot {
+    contractVersion: string;
+    instanceId: string;
+    instanceGeneration: string;
+    workbookSessionId: string;
+    revision: number;
+    target: Record<string, any>;
+    state: Record<string, any>;
+  }
+
+  export type SemanticCellValue =
+    | { kind: 'blank' }
+    | { kind: 'text'; value: string }
+    | { kind: 'number'; value: number }
+    | { kind: 'boolean'; value: boolean };
+
+  export type SemanticEditableCellValue =
+    | { kind: 'blank' }
+    | { kind: 'text'; value: string };
+
+  export type SemanticActionRequest =
+    | { action: 'sheet.activate'; parameters: { sheetId: string }; invocationId?: string }
+    | { action: 'cell.activate'; parameters: { sheetId: string; address: string }; invocationId?: string }
+    | { action: 'range.select'; parameters: { sheetId: string; address?: string; range?: string }; invocationId?: string }
+    | { action: 'cell.setValue'; parameters: { sheetId: string; address: string; value: SemanticEditableCellValue }; invocationId?: string };
+
+  export interface SemanticActionReceipt {
+    operationId: string;
+    action: string;
+    instanceGeneration: string;
+    workbookSessionId: string;
+    phase: 'running';
+  }
+
+  export interface SemanticFacade {
+    describeContract(): Record<string, any>;
+    getCapabilities(): Record<string, any>;
+    getContract(): Record<string, any>;
+    getRuntimeState(): SemanticRuntimeState;
+    waitForRuntime(options?: { phase?: SemanticRuntimePhase; timeoutMs?: number; signal?: AbortSignal }): Promise<SemanticRuntimeState>;
+    subscribe(options: { event?: 'runtimechange' | 'operationchange' | 'sheetchange' | 'selectionchange' | 'cellchange' | '*'; fromRevision?: number; onEvent: (event: Record<string, any>) => void }): { unsubscribe(): void };
+    getOperation(operationId: string): SemanticOperation;
+    listOperations(): SemanticOperation[];
+    waitForOperation(options: { operationId: string; timeoutMs?: number; signal?: AbortSignal }): Promise<SemanticOperation>;
+    getState(request: SemanticStateRequest): SemanticStateSnapshot;
+    query(request: SemanticStateRequest): SemanticStateSnapshot;
+    getAvailableActions(request?: Pick<SemanticStateRequest, 'kind' | 'sheetId'>): ReadonlyArray<{ action: string; capability: string }>;
+    perform(request: SemanticActionRequest): SemanticActionReceipt;
+  }
+
+  export interface SemanticInstanceDescriptor {
+    instanceId: string;
+    instanceGeneration: string;
+    contractVersion: string;
+    runtimePhase: SemanticRuntimePhase;
+    workbookSessionId: string | null;
+  }
+
+  export interface GridJSSemanticAutomationRegistry {
+    readonly version: '1.0.0';
+    listInstances(): SemanticInstanceDescriptor[];
+    getInstance(instanceId: string): SemanticFacade | null;
   }
 
   export type CELL_SELECTED = 'cell-selected';
@@ -92,6 +209,7 @@ declare module 'gridjs-spreadsheet' {
   export type REDACTION_UPDATED = 'redaction-updated';
   export type REDACTION_REASON_INSERTED = 'redactionReason-inserted';
   export type REDACTION_TRANSPARENCY_TOGGLED = 'redactionTransparency-toggled';
+  export type SEARCH_REDACTED = 'search-redacted';
   export type CUSTOM_BUTTON = 'custom-button';
   export type UPDATE_SERVER_ERROR = 'updateServerError';
   export type UPDATE_CELL_ERROR = 'updateCellError';
@@ -279,6 +397,10 @@ declare module 'gridjs-spreadsheet' {
       envt: REDACTION_TRANSPARENCY_TOGGLED,
       callback: (isTransparent: boolean) => void
     ): void;
+    (
+      envt: SEARCH_REDACTED,
+      callback: (sheetNames: string[], detail: { keywords: string, isCaseSensitive: boolean, matchWholeCell: boolean, reason: string, color: string, baseId: string }) => void
+    ): void;
     (
       envt: CUSTOM_BUTTON,
       callback: (tag: string, button: CustomToolbarButton) => void
@@ -366,6 +488,8 @@ declare module 'gridjs-spreadsheet' {
     constructor(container: string | HTMLElement, opts?: Options);
     /** Build version string (injected at compile time) */
     readonly version: string;
+    /** Public Semantic Automation facade. */
+    semantic: SemanticFacade;
     on: SpreadsheetEventHandler;
     /**
      * retrieve cell
@@ -548,6 +672,7 @@ declare module 'gridjs-spreadsheet' {
   global {
     interface Window {
       x_spreadsheet(container: string | HTMLElement, opts?: Options): Spreadsheet; 
+      GridJSSemanticAutomation?: GridJSSemanticAutomationRegistry;
     }
   }
 }

package/package.json

@@ -1,170 +1,171 @@
-{
-  "name": "gridjs-spreadsheet",
-  "version": "26.8.0",
-  "description": "Lightweight, high-performance JavaScript spreadsheet component for building online Excel editors and web spreadsheet apps. Supports React, Vue 3, and Angular with TypeScript declarations. Features include formulas, charts, formatting, data validation, copy/paste from Excel, and server-side integration.",
-  "types": "index.d.ts",
-  "main": "xspreadsheet.js",
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "default": "./xspreadsheet.js"
-    },
-    "./xspreadsheet.css": "./xspreadsheet.css",
-    "./vue": {
-      "types": "./vue.d.ts",
-      "default": "./vue.js"
-    },
-    "./react": {
-      "types": "./react.d.ts",
-      "default": "./react.js"
-    },
-    "./angular": {
-      "types": "./angular.d.ts",
-      "default": "./angular.js"
-    },
-    "./shared": {
-      "types": "./shared.d.ts",
-      "default": "./shared.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "readme.md",
-    "preview.gif",
-    "xspreadsheet.js",
-    "xspreadsheet.css",
-    "*.svg",
-    "index.js",
-    "index.d.ts",
-    "shared.js",
-    "shared.d.ts",
-    "react.js",
-    "react.d.ts",
-    "vue.js",
-    "vue.d.ts",
-    "angular.js",
-    "angular.d.ts",
-    "example/.gitignore",
-    "example/README.md",
-    "example/HELP.md",
-    "example/Dockerfile",
-    "example/compose.yaml",
-    "example/pom.xml",
-    "example/mvnw",
-    "example/mvnw.cmd",
-    "example/src/main/java",
-    "example/src/main/resources",
-    "example/wb",
-    "example/react-gridjs/index.html",
-    "example/react-gridjs/package.json",
-    "example/react-gridjs/src",
-    "example/react-gridjs/vite.config.js",
-    "example/vue-gridjs/index.html",
-    "example/vue-gridjs/package.json",
-    "example/vue-gridjs/src",
-    "example/vue-gridjs/vite.config.js",
-    "example/angular-gridjs/.nvmrc",
-    "example/angular-gridjs/angular.json",
-    "example/angular-gridjs/package.json",
-    "example/angular-gridjs/proxy.conf.json",
-    "example/angular-gridjs/src",
-    "example/angular-gridjs/tsconfig.json",
-    "example/angular-gridjs/tsconfig.app.json",
-    "example/vanilla-gridjs/shared",
-    "example/vanilla-gridjs/npm/index.html",
-    "example/vanilla-gridjs/npm/main.js",
-    "example/vanilla-gridjs/npm/package.json",
-    "example/vanilla-gridjs/npm/vite.config.js",
-    "example/vanilla-gridjs/script/index.html",
-    "example/vanilla-gridjs/script/main.js",
-    "example/vanilla-gridjs/script/package.json",
-    "example/vanilla-gridjs/script/vite.config.js"
-  ],
-  "keywords": [
-    "excel",
-    "spreadsheet",
-    "web-excel",
-    "online-excel",
-    "excel-viewer",
-    "excel-editor",
-    "javascript-excel",
-    "javascript-spreadsheet",
-    "excel-component",
-    "spreadsheet-ui",
-    "react-spreadsheet",
-    "vue-excel",
-    "angular-spreadsheet",
-    "vue-spreadsheet",
-    "react-excel",
-    "angular-excel",
-    "typescript",
-    "xlsx",
-    "xls",
-    "csv",
-    "ods",
-    "numbers",
-    "xlsm",
-    "xlsb",
-    "excel-io",
-    "redact",
-    "redaction",
-    "data-redaction",
-    "collaborative-editing",
-    "excel-api",
-    "data-table",
-    "datagrid",
-    "convert-pdf",
-    "convert-html",
-    "sheets",
-    "web-spreadsheet",
-    "spreadsheet-editor",
-    "excel-online",
-    "excel-formula",
-    "excel-chart",
-    "data-validation",
-    "copy-paste-excel",
-    "spreadsheet-component",
-    "open-source-excel",
-    "free-excel-editor",
-    "gridjs"
-  ],
-  "author": "Aspose Cells Team",
-  "dependencies": {
-    "jszip": "~3.10.1"
-  },
-  "peerDependencies": {
-    "vue": ">=3.0.0",
-    "react": ">=16.8.0",
-    "@angular/core": ">=14.0.0",
-    "@angular/common": ">=14.0.0"
-  },
-  "peerDependenciesMeta": {
-    "vue": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    },
-    "@angular/core": {
-      "optional": true
-    },
-    "@angular/common": {
-      "optional": true
-    }
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/aspose-cells/Aspose.Cells.Grid-for-.NET.git"
-  },
-  "homepage": "https://products.aspose.app/cells/editor",
-  "bugs": {
-    "url": "https://forum.aspose.com/c/cells"
-  }
-}
+{
+  "name": "gridjs-spreadsheet",
+  "version": "26.9.0",
+  "description": "Lightweight, high-performance JavaScript spreadsheet component for building online Excel editors and web spreadsheet apps. Supports React, Vue 3, and Angular with TypeScript declarations. Features include formulas, charts, formatting, data validation, copy/paste from Excel, and server-side integration.",
+  "types": "index.d.ts",
+  "main": "xspreadsheet.js",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./xspreadsheet.js"
+    },
+    "./xspreadsheet.css": "./xspreadsheet.css",
+    "./vue": {
+      "types": "./vue.d.ts",
+      "default": "./vue.js"
+    },
+    "./react": {
+      "types": "./react.d.ts",
+      "default": "./react.js"
+    },
+    "./angular": {
+      "types": "./angular.d.ts",
+      "default": "./angular.js"
+    },
+    "./shared": {
+      "types": "./shared.d.ts",
+      "default": "./shared.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "readme.md",
+    "preview.gif",
+    "xspreadsheet.js",
+    "xspreadsheet.css",
+    "*.svg",
+    "*.jpg",
+    "index.js",
+    "index.d.ts",
+    "shared.js",
+    "shared.d.ts",
+    "react.js",
+    "react.d.ts",
+    "vue.js",
+    "vue.d.ts",
+    "angular.js",
+    "angular.d.ts",
+    "example/.gitignore",
+    "example/README.md",
+    "example/HELP.md",
+    "example/Dockerfile",
+    "example/compose.yaml",
+    "example/pom.xml",
+    "example/mvnw",
+    "example/mvnw.cmd",
+    "example/src/main/java",
+    "example/src/main/resources",
+    "example/wb",
+    "example/react-gridjs/index.html",
+    "example/react-gridjs/package.json",
+    "example/react-gridjs/src",
+    "example/react-gridjs/vite.config.js",
+    "example/vue-gridjs/index.html",
+    "example/vue-gridjs/package.json",
+    "example/vue-gridjs/src",
+    "example/vue-gridjs/vite.config.js",
+    "example/angular-gridjs/.nvmrc",
+    "example/angular-gridjs/angular.json",
+    "example/angular-gridjs/package.json",
+    "example/angular-gridjs/proxy.conf.json",
+    "example/angular-gridjs/src",
+    "example/angular-gridjs/tsconfig.json",
+    "example/angular-gridjs/tsconfig.app.json",
+    "example/vanilla-gridjs/shared",
+    "example/vanilla-gridjs/npm/index.html",
+    "example/vanilla-gridjs/npm/main.js",
+    "example/vanilla-gridjs/npm/package.json",
+    "example/vanilla-gridjs/npm/vite.config.js",
+    "example/vanilla-gridjs/script/index.html",
+    "example/vanilla-gridjs/script/main.js",
+    "example/vanilla-gridjs/script/package.json",
+    "example/vanilla-gridjs/script/vite.config.js"
+  ],
+  "keywords": [
+    "excel",
+    "spreadsheet",
+    "web-excel",
+    "online-excel",
+    "excel-viewer",
+    "excel-editor",
+    "javascript-excel",
+    "javascript-spreadsheet",
+    "excel-component",
+    "spreadsheet-ui",
+    "react-spreadsheet",
+    "vue-excel",
+    "angular-spreadsheet",
+    "vue-spreadsheet",
+    "react-excel",
+    "angular-excel",
+    "typescript",
+    "xlsx",
+    "xls",
+    "csv",
+    "ods",
+    "numbers",
+    "xlsm",
+    "xlsb",
+    "excel-io",
+    "redact",
+    "redaction",
+    "data-redaction",
+    "collaborative-editing",
+    "excel-api",
+    "data-table",
+    "datagrid",
+    "convert-pdf",
+    "convert-html",
+    "sheets",
+    "web-spreadsheet",
+    "spreadsheet-editor",
+    "excel-online",
+    "excel-formula",
+    "excel-chart",
+    "data-validation",
+    "copy-paste-excel",
+    "spreadsheet-component",
+    "open-source-excel",
+    "free-excel-editor",
+    "gridjs"
+  ],
+  "author": "Aspose Cells Team",
+  "dependencies": {
+    "jszip": "~3.10.1"
+  },
+  "peerDependencies": {
+    "vue": ">=3.0.0",
+    "react": ">=16.8.0",
+    "@angular/core": ">=14.0.0",
+    "@angular/common": ">=14.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@angular/common": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aspose-cells/Aspose.Cells.Grid-for-.NET.git"
+  },
+  "homepage": "https://products.aspose.app/cells/editor",
+  "bugs": {
+    "url": "https://forum.aspose.com/c/cells"
+  }
+}

package/react.d.ts

@@ -1,5 +1,5 @@
 import type { CSSProperties } from 'react';
-import type Spreadsheet from 'gridjs-spreadsheet';
+import type Spreadsheet, { SemanticAutomationOptions } from 'gridjs-spreadsheet';
 import type { GridJsAdapter } from './shared';
 
 export interface GridJsSpreadsheetProps {
@@ -12,6 +12,7 @@ export interface GridJsSpreadsheetProps {
   height?: string | number;
   showToolbar?: boolean;
   showContextmenu?: boolean;
+  semanticAutomation?: SemanticAutomationOptions;
   className?: string;
   style?: CSSProperties;
   onReady?: (instance: Spreadsheet, adapter: GridJsAdapter) => void;

package/react.js

@@ -22,6 +22,7 @@ export function GridJsSpreadsheet({
   height = 'calc(100vh - 96px)',
   showToolbar = true,
   showContextmenu = true,
+  semanticAutomation,
   className = 'gridjs-react-host',
   style,
   onReady,
@@ -54,6 +55,7 @@ export function GridJsSpreadsheet({
         token,
         showToolbar,
         showContextmenu,
+        semanticAutomation,
         callbacks: {
           ready: onReady,
           change: onChange,
@@ -88,7 +90,7 @@ export function GridJsSpreadsheet({
       adapterRef.current = null;
       if (hostRef.current) hostRef.current.innerHTML = '';
     };
-  }, [apiBase, dataKey, loader, mode, locale, token, showToolbar, showContextmenu]);
+  }, [apiBase, dataKey, loader, mode, locale, token, showToolbar, showContextmenu, semanticAutomation]);
 
   useEffect(() => {
     if (adapterRef.current && token) {