photon-grid-vue 2.0.0 → 2.0.4

package/README.md

@@ -189,7 +189,10 @@ MIT License
 
 - **GitHub** — https://github.com/abdulwahid-csit/photon-grid
 - **Issues** — https://github.com/abdulwahid-csit/photon-grid/issues
-- **NPM** — https://www.npmjs.com/package/photon-grid-vue
+- **NPM Vue** — https://www.npmjs.com/package/photon-grid-vue
+- **NPM Angular** — https://www.npmjs.com/package/photon-grid-angular
+- **NPM React** — https://www.npmjs.com/package/photon-grid-react
+- **NPM Core** — https://www.npmjs.com/package/photon-grid-core
 
 ---
 

package/index.cjs

@@ -1 +1 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});let e=require("vue"),t=require("photon-grid-core");var n=[[t.GridEventType.DATA_CHANGED,`dataChanged`],[t.GridEventType.ROW_CLICKED,`rowClicked`],[t.GridEventType.ROW_DOUBLE_CLICKED,`rowDoubleClicked`],[t.GridEventType.ROW_SELECTED,`rowSelected`],[t.GridEventType.CELL_CLICKED,`cellClicked`],[t.GridEventType.CELL_DOUBLE_CLICKED,`cellDoubleClicked`],[t.GridEventType.CELL_VALUE_CHANGED,`cellValueChanged`],[t.GridEventType.CELL_SELECTION_CHANGED,`cellSelectionChanged`],[t.GridEventType.COLUMN_RESIZED,`columnResized`],[t.GridEventType.COLUMN_MOVED,`columnMoved`],[t.GridEventType.SORT_CHANGED,`sortChanged`],[t.GridEventType.FILTER_CHANGED,`filterChanged`],[t.GridEventType.PAGE_CHANGED,`pageChanged`],[t.GridEventType.COLUMNS_STATE_CHANGED,`columnsStateChanged`],[t.GridEventType.THEME_CHANGED,`themeChanged`],[t.GridEventType.EXPORT_COMPLETE,`exportComplete`]],r=(0,e.defineComponent)({name:`PhotonGrid`,props:{columns:{type:Array,default:()=>[]},dataSet:{type:Array,default:()=>[]},options:{type:Object,default:()=>({})}},emits:[`gridReady`,`dataChanged`,`rowClicked`,`rowDoubleClicked`,`rowSelected`,`cellClicked`,`cellDoubleClicked`,`cellValueChanged`,`cellSelectionChanged`,`columnResized`,`columnMoved`,`sortChanged`,`filterChanged`,`pageChanged`,`columnsStateChanged`,`themeChanged`,`exportComplete`],setup(r,{emit:i}){let a=(0,e.ref)(null),o=(0,e.shallowRef)(null),s=[],c=()=>{for(let e of s)e();s=[],o.value?.destroy(),o.value=null},l=()=>{if(!a.value)return;let e={...r.options??{},columns:r.columns??[],data:r.dataSet??[]},c=new t.GridCore(a.value,e);o.value=c;let l=i;for(let[e,t]of n)s.push(c.api.on(e,e=>l(t,e)));l(`gridReady`,c.api)};return(0,e.onMounted)(l),(0,e.onBeforeUnmount)(c),(0,e.watch)(()=>[r.columns,r.dataSet,r.options],()=>{c(),l()}),()=>(0,e.h)(`div`,{ref:a,class:`photon-grid__host`})}});exports.PhotonGrid=r,exports.default=r;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});let e=require("vue"),t=require("photon-grid-core");var n=[[t.GridEventType.DATA_CHANGED,`dataChanged`],[t.GridEventType.ROW_CLICKED,`rowClicked`],[t.GridEventType.ROW_DOUBLE_CLICKED,`rowDoubleClicked`],[t.GridEventType.ROW_SELECTED,`rowSelected`],[t.GridEventType.CELL_CLICKED,`cellClicked`],[t.GridEventType.CELL_DOUBLE_CLICKED,`cellDoubleClicked`],[t.GridEventType.CELL_VALUE_CHANGED,`cellValueChanged`],[t.GridEventType.CELL_SELECTION_CHANGED,`cellSelectionChanged`],[t.GridEventType.COLUMN_RESIZED,`columnResized`],[t.GridEventType.COLUMN_MOVED,`columnMoved`],[t.GridEventType.SORT_CHANGED,`sortChanged`],[t.GridEventType.FILTER_CHANGED,`filterChanged`],[t.GridEventType.PAGE_CHANGED,`pageChanged`],[t.GridEventType.COLUMNS_STATE_CHANGED,`columnsStateChanged`],[t.GridEventType.THEME_CHANGED,`themeChanged`],[t.GridEventType.EXPORT_COMPLETE,`exportComplete`]],r=(0,e.defineComponent)({name:`PhotonGrid`,props:{columns:{type:Array,default:()=>[]},dataSet:{type:Array,default:()=>[]},options:{type:Object,default:()=>({})}},emits:[`gridReady`,`dataChanged`,`rowClicked`,`rowDoubleClicked`,`rowSelected`,`cellClicked`,`cellDoubleClicked`,`cellValueChanged`,`cellSelectionChanged`,`columnResized`,`columnMoved`,`sortChanged`,`filterChanged`,`pageChanged`,`columnsStateChanged`,`themeChanged`,`exportComplete`],setup(r,{emit:i}){let a=(0,e.ref)(null),o=(0,e.shallowRef)(null),s=[],c=()=>{for(let e of s)e();s=[],o.value?.destroy(),o.value=null},l=()=>{if(!a.value)return;let e={...r.options??{},columns:r.columns??[],data:r.dataSet??[]},c=new t.GridCore(a.value,e);o.value=c;let l=i;for(let[e,t]of n)s.push(c.api.on(e,e=>l(t,e)));l(`gridReady`,c.api)};return(0,e.onMounted)(l),(0,e.onBeforeUnmount)(c),(0,e.watch)(()=>[r.columns,r.dataSet,r.options],()=>{c(),l()}),()=>(0,e.h)(`div`,{ref:a,class:`photon-grid__host`})}});Object.defineProperty(exports,"PhotonAIProviderType",{enumerable:!0,get:function(){return t.PhotonAIProviderType}}),exports.PhotonGrid=r,exports.default=r;

package/index.d.ts

@@ -1,2 +1,3 @@
 export { PhotonGrid, default } from './photon-grid';
 export type * from 'photon-grid-core';
+export { PhotonAIProviderType } from 'photon-grid-core';

package/index.js

@@ -1,7 +1,7 @@
 import { defineComponent as e, h as t, onBeforeUnmount as n, onMounted as r, ref as i, shallowRef as a, watch as o } from "vue";
-import { GridCore as s, GridEventType as c } from "photon-grid-core";
+import { GridCore as s, GridEventType as c, PhotonAIProviderType as l } from "photon-grid-core";
 //#region src/photon-grid.ts
-var l = [
+var u = [
 	[c.DATA_CHANGED, "dataChanged"],
 	[c.ROW_CLICKED, "rowClicked"],
 	[c.ROW_DOUBLE_CLICKED, "rowDoubleClicked"],
@@ -18,7 +18,7 @@ var l = [
 	[c.COLUMNS_STATE_CHANGED, "columnsStateChanged"],
 	[c.THEME_CHANGED, "themeChanged"],
 	[c.EXPORT_COMPLETE, "exportComplete"]
-], u = e({
+], d = e({
 	name: "PhotonGrid",
 	props: {
 		columns: {
@@ -54,19 +54,19 @@ var l = [
 		"exportComplete"
 	],
 	setup(e, { emit: c }) {
-		let u = i(null), d = a(null), f = [], p = () => {
+		let l = i(null), d = a(null), f = [], p = () => {
 			for (let e of f) e();
 			f = [], d.value?.destroy(), d.value = null;
 		}, m = () => {
-			if (!u.value) return;
+			if (!l.value) return;
 			let t = {
 				...e.options ?? {},
 				columns: e.columns ?? [],
 				data: e.dataSet ?? []
-			}, n = new s(u.value, t);
+			}, n = new s(l.value, t);
 			d.value = n;
 			let r = c;
-			for (let [e, t] of l) f.push(n.api.on(e, (e) => r(t, e)));
+			for (let [e, t] of u) f.push(n.api.on(e, (e) => r(t, e)));
 			r("gridReady", n.api);
 		};
 		return r(m), n(p), o(() => [
@@ -76,10 +76,10 @@ var l = [
 		], () => {
 			p(), m();
 		}), () => t("div", {
-			ref: u,
+			ref: l,
 			class: "photon-grid__host"
 		});
 	}
 });
 //#endregion
-export { u as PhotonGrid, u as default };
+export { l as PhotonAIProviderType, d as PhotonGrid, d as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "photon-grid-vue",
-  "version": "2.0.0",
+  "version": "2.0.4",
   "description": "Vue 3 wrapper for Photon Grid — an enterprise-grade, framework-agnostic TypeScript data grid.",
   "author": "Abdul Wahid",
   "license": "MIT",
@@ -21,7 +21,7 @@
   ],
   "sideEffects": false,
   "peerDependencies": {
-    "photon-grid-core": "^2.0.0",
+    "photon-grid-core": "^2.0.4",
     "vue": "^3.4.0"
   },
   "keywords": [

package/photon-grid.d.ts

@@ -1,5 +1,5 @@
 import { PropType } from 'vue';
-import { ColumnDef, GridOptions } from 'photon-grid-core';
+import { ColumnDefInput, GridOptions } from 'photon-grid-core';
 /**
  * Vue 3 wrapper around the framework-agnostic {@link GridCore}. Renders a single
  * host element, instantiates the grid on mount, forwards the grid's typed events
@@ -13,9 +13,13 @@ import { ColumnDef, GridOptions } from 'photon-grid-core';
  * ```
  */
 export declare const PhotonGrid: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
-    /** Column definitions. */
+    /**
+     * Column definitions. Only `field` is required per column — `colId`,
+     * `header` and `type` are optional and defaulted by the core (auto `colId`,
+     * header from the field in Title Case, `type` defaulting to `'string'`).
+     */
     columns: {
-        type: PropType<ColumnDef[]>;
+        type: PropType<ColumnDefInput[]>;
         default: () => never[];
     };
     /** Row data. */
@@ -23,7 +27,27 @@ export declare const PhotonGrid: import('vue').DefineComponent<import('vue').Ext
         type: PropType<Record<string, unknown>[]>;
         default: () => never[];
     };
-    /** Additional grid options (theme, selection, features…). */
+    /**
+     * Additional grid options (theme, selection, features…), forwarded to the
+     * core. Enable the natural-language AI panel — and, optionally, its Gemini
+     * generative back-end — through `options.photonAI`:
+     *
+     * @example Gemini-powered AI panel
+     * ```ts
+     * import { PhotonAIProviderType } from 'photon-grid-vue';
+     *
+     * const options = {
+     *   photonAI: {
+     *     enabled: true,
+     *     provider: {
+     *       type: PhotonAIProviderType.Gemini,
+     *       apiKey: import.meta.env.VITE_GEMINI_API_KEY,
+     *       model: 'gemini-2.5-flash',
+     *     },
+     *   },
+     * };
+     * ```
+     */
     options: {
         type: PropType<Partial<GridOptions>>;
         default: () => {};
@@ -31,9 +55,13 @@ export declare const PhotonGrid: import('vue').DefineComponent<import('vue').Ext
 }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("dataChanged" | "rowClicked" | "rowDoubleClicked" | "rowSelected" | "cellClicked" | "cellDoubleClicked" | "cellValueChanged" | "cellSelectionChanged" | "columnResized" | "columnMoved" | "sortChanged" | "filterChanged" | "pageChanged" | "columnsStateChanged" | "themeChanged" | "exportComplete" | "gridReady")[], "dataChanged" | "rowClicked" | "rowDoubleClicked" | "rowSelected" | "cellClicked" | "cellDoubleClicked" | "cellValueChanged" | "cellSelectionChanged" | "columnResized" | "columnMoved" | "sortChanged" | "filterChanged" | "pageChanged" | "columnsStateChanged" | "themeChanged" | "exportComplete" | "gridReady", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
-    /** Column definitions. */
+    /**
+     * Column definitions. Only `field` is required per column — `colId`,
+     * `header` and `type` are optional and defaulted by the core (auto `colId`,
+     * header from the field in Title Case, `type` defaulting to `'string'`).
+     */
     columns: {
-        type: PropType<ColumnDef[]>;
+        type: PropType<ColumnDefInput[]>;
         default: () => never[];
     };
     /** Row data. */
@@ -41,7 +69,27 @@ export declare const PhotonGrid: import('vue').DefineComponent<import('vue').Ext
         type: PropType<Record<string, unknown>[]>;
         default: () => never[];
     };
-    /** Additional grid options (theme, selection, features…). */
+    /**
+     * Additional grid options (theme, selection, features…), forwarded to the
+     * core. Enable the natural-language AI panel — and, optionally, its Gemini
+     * generative back-end — through `options.photonAI`:
+     *
+     * @example Gemini-powered AI panel
+     * ```ts
+     * import { PhotonAIProviderType } from 'photon-grid-vue';
+     *
+     * const options = {
+     *   photonAI: {
+     *     enabled: true,
+     *     provider: {
+     *       type: PhotonAIProviderType.Gemini,
+     *       apiKey: import.meta.env.VITE_GEMINI_API_KEY,
+     *       model: 'gemini-2.5-flash',
+     *     },
+     *   },
+     * };
+     * ```
+     */
     options: {
         type: PropType<Partial<GridOptions>>;
         default: () => {};
@@ -65,7 +113,7 @@ export declare const PhotonGrid: import('vue').DefineComponent<import('vue').Ext
     onExportComplete?: ((...args: any[]) => any) | undefined;
     onGridReady?: ((...args: any[]) => any) | undefined;
 }>, {
-    columns: ColumnDef[];
+    columns: ColumnDefInput[];
     dataSet: Record<string, unknown>[];
     options: Partial<GridOptions>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;