photon-grid-core 0.0.1

package/photon-ai/builtins/move.commands.js

@@ -0,0 +1,53 @@
+function resolveMoveColumn(tokens, resolver, columns) {
+    return { column: resolver.resolveColumn(tokens, columns) ?? undefined };
+}
+function requireColumn(entities) {
+    return entities.column ? null : "I couldn't find a column matching your request.";
+}
+function currentVisibleIndex(api, colId) {
+    return api.getVisibleColumns().findIndex((c) => c.colId === colId);
+}
+const moveColumnToStart = {
+    key: 'moveColumnToStart',
+    aliases: [['move', 'start'], ['move', 'left'], ['move', 'beginning'], ['move', 'front'], ['move', 'first']],
+    description: 'Moves a column to the leftmost position — e.g. "move country column to the start".',
+    resolveEntities: resolveMoveColumn,
+    validate: requireColumn,
+    buildCommand: (entities) => ({
+        type: 'moveColumnToStart',
+        params: { colId: entities.column.colId, header: entities.column.header },
+    }),
+    execute: (command, api) => {
+        const colId = command.params.colId;
+        const idx = currentVisibleIndex(api, colId);
+        if (idx <= 0)
+            return `"${command.params.header}" is already at the start.`;
+        api.moveColumn(idx, 0);
+        return `Moved "${command.params.header}" to the start.`;
+    },
+};
+const moveColumnToEnd = {
+    key: 'moveColumnToEnd',
+    aliases: [['move', 'end'], ['move', 'right'], ['move', 'last']],
+    description: 'Moves a column to the rightmost position — e.g. "move country column to the end".',
+    resolveEntities: resolveMoveColumn,
+    validate: requireColumn,
+    buildCommand: (entities) => ({
+        type: 'moveColumnToEnd',
+        params: { colId: entities.column.colId, header: entities.column.header },
+    }),
+    execute: (command, api) => {
+        const colId = command.params.colId;
+        const idx = currentVisibleIndex(api, colId);
+        const lastIndex = api.getVisibleColumns().length - 1;
+        if (idx < 0 || idx === lastIndex)
+            return `"${command.params.header}" is already at the end.`;
+        api.moveColumn(idx, lastIndex);
+        return `Moved "${command.params.header}" to the end.`;
+    },
+};
+/** Registers all column-reordering Photon AI intents. */
+export function registerMoveCommands(registry) {
+    registry.registerAll([moveColumnToStart, moveColumnToEnd]);
+}
+//# sourceMappingURL=move.commands.js.map

package/photon-ai/builtins/move.commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move.commands.js","sourceRoot":"","sources":["../../../src/photon-ai/builtins/move.commands.ts"],"names":[],"mappings":"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"}

package/photon-ai/builtins/pin.commands.d.ts

@@ -0,0 +1,4 @@
+import type { PhotonAICommandRegistry } from '../photon-ai-registry';
+/** Registers all column-pinning Photon AI intents. */
+export declare function registerPinCommands(registry: PhotonAICommandRegistry): void;
+//# sourceMappingURL=pin.commands.d.ts.map

package/photon-ai/builtins/pin.commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin.commands.d.ts","sourceRoot":"","sources":["../../../src/photon-ai/builtins/pin.commands.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAyGrE,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAE3E"}

package/photon-ai/builtins/pin.commands.js

@@ -0,0 +1,106 @@
+function resolvePinColumns(tokens, resolver, columns) {
+    return { columns: resolver.resolveColumns(tokens, columns) };
+}
+function requireColumns(entities) {
+    return entities.columns?.length ? null : "I couldn't find a column matching your request.";
+}
+function pinAll(colIds, header, api, side) {
+    for (const colId of colIds)
+        api.setColumnPin(colId, side);
+    const sideLabel = side ? ` to the ${side}` : '';
+    return `${side ? 'Pinned' : 'Unpinned'} ${header}${sideLabel}.`;
+}
+const pinLeft = {
+    key: 'pinLeft',
+    aliases: [['pin', 'left'], ['freeze', 'left']],
+    description: 'Pins one or more columns to the left side of the grid — e.g. "pin price and income to the left".',
+    resolveEntities: resolvePinColumns,
+    validate: requireColumns,
+    buildCommand: (entities) => ({
+        type: 'pinLeft',
+        params: { colIds: entities.columns.map((c) => c.colId), header: entities.columns.map((c) => c.header).join('", "') },
+    }),
+    execute: (command, api) => pinAll(command.params.colIds, `"${command.params.header}"`, api, 'left'),
+};
+const pinRight = {
+    key: 'pinRight',
+    aliases: [['pin', 'right'], ['freeze', 'right']],
+    description: 'Pins one or more columns to the right side of the grid — e.g. "pin price and income to the right".',
+    resolveEntities: resolvePinColumns,
+    validate: requireColumns,
+    buildCommand: (entities) => ({
+        type: 'pinRight',
+        params: { colIds: entities.columns.map((c) => c.colId), header: entities.columns.map((c) => c.header).join('", "') },
+    }),
+    execute: (command, api) => pinAll(command.params.colIds, `"${command.params.header}"`, api, 'right'),
+};
+const unpin = {
+    key: 'unpin',
+    aliases: [['unpin'], ['remove', 'pin'], ['un', 'pin']],
+    description: 'Unpins one or more columns — e.g. "unpin status, income and year".',
+    resolveEntities: resolvePinColumns,
+    validate: requireColumns,
+    buildCommand: (entities) => ({
+        type: 'unpin',
+        params: { colIds: entities.columns.map((c) => c.colId), header: entities.columns.map((c) => c.header).join('", "') },
+    }),
+    execute: (command, api) => pinAll(command.params.colIds, `"${command.params.header}"`, api, null),
+};
+const unpinAll = {
+    key: 'unpinAll',
+    aliases: [['unpin', 'all', 'column'], ['unpin', 'every', 'column'], ['remove', 'all', 'pin'], ['clear', 'all', 'pin'], ['clear', 'pin']],
+    description: 'Unpins every column in the grid.',
+    resolveEntities: () => ({}),
+    buildCommand: () => ({ type: 'unpinAll', params: {} }),
+    execute: (_command, api) => {
+        const columns = api.getAllColumns();
+        for (const col of columns)
+            api.setColumnPin(col.colId, null);
+        return `Unpinned all ${columns.length} columns.`;
+    },
+};
+/**
+ * "pin half the columns left and half right" — splits the grid's columns
+ * down the middle and pins each half to whichever side(s) were mentioned.
+ * Mentioning only one side pins just the first half there and leaves the
+ * rest untouched, matching how a user would read that sentence literally.
+ */
+const pinHalf = {
+    key: 'pinHalf',
+    aliases: [['pin', 'half'], ['freeze', 'half']],
+    description: 'Splits the grid\'s columns in half and pins them — "pin half the columns to the left and half to the right" pins the first half left and the second half right.',
+    resolveEntities: (tokens, resolver) => {
+        const words = new Set(tokens.map((t) => t.toLowerCase()));
+        const sides = [];
+        if (words.has('left'))
+            sides.push('left');
+        if (words.has('right'))
+            sides.push('right');
+        return { sides };
+    },
+    validate: (entities) => (entities.sides?.length ? null : 'Which side should I pin the columns to — left, right, or both?'),
+    buildCommand: (entities) => ({ type: 'pinHalf', params: { sides: entities.sides } }),
+    execute: (command, api) => {
+        const sides = command.params.sides;
+        const columns = api.getAllColumns();
+        const mid = Math.ceil(columns.length / 2);
+        const firstHalf = columns.slice(0, mid);
+        const secondHalf = columns.slice(mid);
+        if (sides.includes('left') && sides.includes('right')) {
+            for (const col of firstHalf)
+                api.setColumnPin(col.colId, 'left');
+            for (const col of secondHalf)
+                api.setColumnPin(col.colId, 'right');
+            return `Pinned ${firstHalf.length} columns left and ${secondHalf.length} columns right.`;
+        }
+        const side = sides[0];
+        for (const col of firstHalf)
+            api.setColumnPin(col.colId, side);
+        return `Pinned ${firstHalf.length} columns to the ${side}.`;
+    },
+};
+/** Registers all column-pinning Photon AI intents. */
+export function registerPinCommands(registry) {
+    registry.registerAll([unpinAll, pinHalf, pinLeft, pinRight, unpin]);
+}
+//# sourceMappingURL=pin.commands.js.map

package/photon-ai/builtins/pin.commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin.commands.js","sourceRoot":"","sources":["../../../src/photon-ai/builtins/pin.commands.ts"],"names":[],"mappings":"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"}

package/photon-ai/builtins/selection.commands.d.ts

@@ -0,0 +1,4 @@
+import type { PhotonAICommandRegistry } from '../photon-ai-registry';
+/** Registers all row/cell selection Photon AI intents. */
+export declare function registerSelectionCommands(registry: PhotonAICommandRegistry): void;
+//# sourceMappingURL=selection.commands.d.ts.map

package/photon-ai/builtins/selection.commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.commands.d.ts","sourceRoot":"","sources":["../../../src/photon-ai/builtins/selection.commands.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAwGrE,0DAA0D;AAC1D,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAEjF"}

package/photon-ai/builtins/selection.commands.js

@@ -0,0 +1,102 @@
+/** Selects the full grid as one cell range — the shared "all cells" target for select/copy/cut. */
+function selectEveryCell(api) {
+    const cols = api.getVisibleColumns();
+    const rows = api.getVisibleRows();
+    if (cols.length === 0 || rows.length === 0)
+        return false;
+    api.setCellRange({ startRowIndex: 0, endRowIndex: rows.length - 1, startColIndex: 0, endColIndex: cols.length - 1 });
+    return true;
+}
+const selectRow = {
+    key: 'selectRow',
+    aliases: [['select', 'row']],
+    description: 'Selects a row by its (1-based) position.',
+    resolveEntities: (tokens, resolver) => ({ index: resolver.resolveIndex(tokens) ?? undefined }),
+    validate: (entities) => entities.index != null ? null : 'Tell me which row number to select, e.g. "select row 5".',
+    buildCommand: (entities) => ({ type: 'selectRow', params: { index: entities.index } }),
+    execute: (command, api) => {
+        const oneBasedIndex = command.params.index;
+        const row = api.getRowByIndex(oneBasedIndex - 1);
+        if (!row)
+            return `There's no row ${oneBasedIndex}.`;
+        api.selectRow(row.nodeId);
+        return `Selected row ${oneBasedIndex}.`;
+    },
+};
+const selectColumn = {
+    key: 'selectColumn',
+    aliases: [['select', 'column']],
+    description: 'Selects every cell in a column.',
+    resolveEntities: (tokens, resolver, columns) => ({
+        column: resolver.resolveColumn(tokens, columns) ?? undefined,
+    }),
+    validate: (entities) => entities.column ? null : "I couldn't find a column matching your request.",
+    buildCommand: (entities) => ({
+        type: 'selectColumn',
+        params: { colId: entities.column.colId, header: entities.column.header },
+    }),
+    execute: (command, api) => {
+        const colId = command.params.colId;
+        const visibleCols = api.getVisibleColumns();
+        const colIndex = visibleCols.findIndex((c) => c.colId === colId);
+        const rowCount = api.getVisibleRows().length;
+        if (colIndex < 0 || rowCount === 0)
+            return `"${command.params.header}" isn't visible right now.`;
+        api.setCellRange({ startRowIndex: 0, endRowIndex: rowCount - 1, startColIndex: colIndex, endColIndex: colIndex });
+        return `Selected the "${command.params.header}" column.`;
+    },
+};
+const clearSelection = {
+    key: 'clearSelection',
+    aliases: [['clear', 'selection'], ['clear', 'select'], ['deselect']],
+    description: 'Clears row and cell selection.',
+    resolveEntities: () => ({}),
+    buildCommand: () => ({ type: 'clearSelection', params: {} }),
+    execute: (_command, api) => {
+        api.deselectAll();
+        api.clearCellSelection();
+        return 'Cleared selection.';
+    },
+};
+const selectAllCells = {
+    key: 'selectAllCells',
+    aliases: [['select', 'all', 'cell'], ['select', 'every', 'cell']],
+    description: 'Selects every cell in the grid.',
+    resolveEntities: () => ({}),
+    buildCommand: () => ({ type: 'selectAllCells', params: {} }),
+    execute: (_command, api) => (selectEveryCell(api) ? 'Selected all cells.' : 'There are no cells to select.'),
+};
+const copyAllCells = {
+    key: 'copyAllCells',
+    // The 4-word variant must outrank selectAllCells's ["select","all","cell"] alias when both "select" and "copy" are
+    // present together with "all"/"cell" (e.g. "select and copy all the cells") — otherwise the longer alias would win
+    // and silently drop the copy action, only selecting.
+    aliases: [['copy'], ['select', 'copy'], ['select', 'copy', 'all', 'cell']],
+    description: 'Selects and copies every cell to the clipboard — e.g. "copy all cells", "select and copy all the cells".',
+    resolveEntities: () => ({}),
+    buildCommand: () => ({ type: 'copyAllCells', params: {} }),
+    execute: (_command, api) => {
+        if (!selectEveryCell(api))
+            return 'There are no cells to copy.';
+        void api.copySelectedCellsToClipboard();
+        return 'Copied all cells to the clipboard.';
+    },
+};
+const cutAllCells = {
+    key: 'cutAllCells',
+    aliases: [['cut'], ['select', 'cut'], ['select', 'cut', 'all', 'cell']],
+    description: 'Selects every cell and copies it to the clipboard — "cut" never deletes grid data via a command, to avoid irreversible data loss from a misheard instruction.',
+    resolveEntities: () => ({}),
+    buildCommand: () => ({ type: 'cutAllCells', params: {} }),
+    execute: (_command, api) => {
+        if (!selectEveryCell(api))
+            return 'There are no cells to cut.';
+        void api.copySelectedCellsToClipboard();
+        return "Cutting isn't supported, since it would permanently delete data — copied all cells instead.";
+    },
+};
+/** Registers all row/cell selection Photon AI intents. */
+export function registerSelectionCommands(registry) {
+    registry.registerAll([selectRow, selectColumn, selectAllCells, copyAllCells, cutAllCells, clearSelection]);
+}
+//# sourceMappingURL=selection.commands.js.map

package/photon-ai/builtins/selection.commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.commands.js","sourceRoot":"","sources":["../../../src/photon-ai/builtins/selection.commands.ts"],"names":[],"mappings":"AAIA,mGAAmG;AACnG,SAAS,eAAe,CAAC,GAAY;IACnC,MAAM,IAAI,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;IAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,GAAG,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC;IACrH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,SAAS,GAAqB;IAClC,GAAG,EAAE,WAAW;IAChB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5B,WAAW,EAAE,0CAA0C;IACvD,eAAe,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;IAC9F,QAAQ,EAAE,CAAC,QAA0B,EAAE,EAAE,CACvC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0DAA0D;IAC5F,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;IACtF,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAe,CAAC;QACrD,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO,kBAAkB,aAAa,GAAG,CAAC;QACpD,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,gBAAgB,aAAa,GAAG,CAAC;IAC1C,CAAC;CACF,CAAC;AAEF,MAAM,YAAY,GAAqB;IACrC,GAAG,EAAE,cAAc;IACnB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,WAAW,EAAE,iCAAiC;IAC9C,eAAe,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,SAAS;KAC7D,CAAC;IACF,QAAQ,EAAE,CAAC,QAA0B,EAAE,EAAE,CACvC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iDAAiD;IAC5E,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAO,CAAC,MAAM,EAAE;KAC3E,CAAC;IACF,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAe,CAAC;QAC7C,MAAM,WAAW,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC;QAC7C,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,4BAA4B,CAAC;QACjG,GAAG,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,GAAG,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClH,OAAO,iBAAiB,OAAO,CAAC,MAAM,CAAC,MAAM,WAAW,CAAC;IAC3D,CAAC;CACF,CAAC;AAEF,MAAM,cAAc,GAAqB;IACvC,GAAG,EAAE,gBAAgB;IACrB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IACpE,WAAW,EAAE,gCAAgC;IAC7C,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IAC3B,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC5D,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;QACzB,GAAG,CAAC,WAAW,EAAE,CAAC;QAClB,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACzB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;CACF,CAAC;AAEF,MAAM,cAAc,GAAqB;IACvC,GAAG,EAAE,gBAAgB;IACrB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACjE,WAAW,EAAE,iCAAiC;IAC9C,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IAC3B,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC5D,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,+BAA+B,CAAC;CAC7G,CAAC;AAEF,MAAM,YAAY,GAAqB;IACrC,GAAG,EAAE,cAAc;IACnB,mHAAmH;IACnH,mHAAmH;IACnH,qDAAqD;IACrD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1E,WAAW,EAAE,0GAA0G;IACvH,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IAC3B,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC1D,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;QACzB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;YAAE,OAAO,6BAA6B,CAAC;QAChE,KAAK,GAAG,CAAC,4BAA4B,EAAE,CAAC;QACxC,OAAO,oCAAoC,CAAC;IAC9C,CAAC;CACF,CAAC;AAEF,MAAM,WAAW,GAAqB;IACpC,GAAG,EAAE,aAAa;IAClB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACvE,WAAW,EACT,+JAA+J;IACjK,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IAC3B,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACzD,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;QACzB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;YAAE,OAAO,4BAA4B,CAAC;QAC/D,KAAK,GAAG,CAAC,4BAA4B,EAAE,CAAC;QACxC,OAAO,6FAA6F,CAAC;IACvG,CAAC;CACF,CAAC;AAEF,0DAA0D;AAC1D,MAAM,UAAU,yBAAyB,CAAC,QAAiC;IACzE,QAAQ,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;AAC7G,CAAC"}

package/photon-ai/builtins/sort.commands.d.ts

@@ -0,0 +1,4 @@
+import type { PhotonAICommandRegistry } from '../photon-ai-registry';
+/** Registers all sorting-related Photon AI intents. */
+export declare function registerSortCommands(registry: PhotonAICommandRegistry): void;
+//# sourceMappingURL=sort.commands.d.ts.map

package/photon-ai/builtins/sort.commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.commands.d.ts","sourceRoot":"","sources":["../../../src/photon-ai/builtins/sort.commands.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAmErE,uDAAuD;AACvD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAE5E"}

package/photon-ai/builtins/sort.commands.js

@@ -0,0 +1,67 @@
+function resolveSortColumn(tokens, resolver, columns) {
+    return { column: resolver.resolveColumn(tokens, columns) ?? undefined };
+}
+function requireColumn(entities) {
+    if (!entities.column)
+        return "I couldn't find a column matching your request.";
+    if (entities.column.sortable === false)
+        return `"${entities.column.header}" isn't sortable.`;
+    return null;
+}
+const sortAscending = {
+    key: 'sortAscending',
+    aliases: [
+        ['sort', 'ascending'], ['sort', 'asc'],
+        ['ascending'], ['asc'],
+        ['low', 'high'], ['smallest', 'largest'],
+        ['sort'], // fallback: plain "sort <column>" defaults to ascending
+    ],
+    description: 'Sorts a column in ascending order.',
+    resolveEntities: resolveSortColumn,
+    validate: requireColumn,
+    buildCommand: (entities) => ({
+        type: 'sortAscending',
+        params: { colId: entities.column.colId, header: entities.column.header },
+    }),
+    execute: (command, api) => {
+        const colId = command.params.colId;
+        api.sortColumn(colId, 'asc');
+        return `Sorted "${command.params.header}" ascending.`;
+    },
+};
+const sortDescending = {
+    key: 'sortDescending',
+    aliases: [
+        ['sort', 'descending'], ['sort', 'desc'],
+        ['descending'], ['desc'],
+        ['high', 'low'], ['largest', 'smallest'],
+    ],
+    description: 'Sorts a column in descending order.',
+    resolveEntities: resolveSortColumn,
+    validate: requireColumn,
+    buildCommand: (entities) => ({
+        type: 'sortDescending',
+        params: { colId: entities.column.colId, header: entities.column.header },
+    }),
+    execute: (command, api) => {
+        const colId = command.params.colId;
+        api.sortColumn(colId, 'desc');
+        return `Sorted "${command.params.header}" descending.`;
+    },
+};
+const clearSort = {
+    key: 'clearSort',
+    aliases: [['clear', 'sort'], ['remove', 'sort'], ['unsort']],
+    description: 'Clears all sorting.',
+    resolveEntities: () => ({}),
+    buildCommand: () => ({ type: 'clearSort', params: {} }),
+    execute: (_command, api) => {
+        api.clearSort();
+        return 'Cleared sorting.';
+    },
+};
+/** Registers all sorting-related Photon AI intents. */
+export function registerSortCommands(registry) {
+    registry.registerAll([sortAscending, sortDescending, clearSort]);
+}
+//# sourceMappingURL=sort.commands.js.map

package/photon-ai/builtins/sort.commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.commands.js","sourceRoot":"","sources":["../../../src/photon-ai/builtins/sort.commands.ts"],"names":[],"mappings":"AAKA,SAAS,iBAAiB,CAAC,MAAgB,EAAE,QAAwB,EAAE,OAAoB;IACzF,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC;AAC1E,CAAC;AAED,SAAS,aAAa,CAAC,QAA0B;IAC/C,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,iDAAiD,CAAC;IAC/E,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK;QAAE,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,mBAAmB,CAAC;IAC7F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,aAAa,GAAqB;IACtC,GAAG,EAAE,eAAe;IACpB,OAAO,EAAE;QACP,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;QACtC,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC;QACtB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;QACxC,CAAC,MAAM,CAAC,EAAE,wDAAwD;KACnE;IACD,WAAW,EAAE,oCAAoC;IACjD,eAAe,EAAE,iBAAiB;IAClC,QAAQ,EAAE,aAAa;IACvB,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAO,CAAC,MAAM,EAAE;KAC3E,CAAC;IACF,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAe,CAAC;QAC7C,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7B,OAAO,WAAW,OAAO,CAAC,MAAM,CAAC,MAAM,cAAc,CAAC;IACxD,CAAC;CACF,CAAC;AAEF,MAAM,cAAc,GAAqB;IACvC,GAAG,EAAE,gBAAgB;IACrB,OAAO,EAAE;QACP,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACxC,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC;QACxB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;KACzC;IACD,WAAW,EAAE,qCAAqC;IAClD,eAAe,EAAE,iBAAiB;IAClC,QAAQ,EAAE,aAAa;IACvB,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAO,CAAC,MAAM,EAAE;KAC3E,CAAC;IACF,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAe,CAAC;QAC7C,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,WAAW,OAAO,CAAC,MAAM,CAAC,MAAM,eAAe,CAAC;IACzD,CAAC;CACF,CAAC;AAEF,MAAM,SAAS,GAAqB;IAClC,GAAG,EAAE,WAAW;IAChB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC5D,WAAW,EAAE,qBAAqB;IAClC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IAC3B,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACvD,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;QACzB,GAAG,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;CACF,CAAC;AAEF,uDAAuD;AACvD,MAAM,UAAU,oBAAoB,CAAC,QAAiC;IACpE,QAAQ,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/photon-ai/builtins/visibility.commands.d.ts

@@ -0,0 +1,4 @@
+import type { PhotonAICommandRegistry } from '../photon-ai-registry';
+/** Registers all column-visibility Photon AI intents. */
+export declare function registerVisibilityCommands(registry: PhotonAICommandRegistry): void;
+//# sourceMappingURL=visibility.commands.d.ts.map

package/photon-ai/builtins/visibility.commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.commands.d.ts","sourceRoot":"","sources":["../../../src/photon-ai/builtins/visibility.commands.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AA4ErE,yDAAyD;AACzD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAElF"}

package/photon-ai/builtins/visibility.commands.js

@@ -0,0 +1,75 @@
+function resolveVisibilityColumn(tokens, resolver, columns) {
+    return { column: resolver.resolveColumn(tokens, columns) ?? undefined };
+}
+function requireColumn(entities) {
+    return entities.column ? null : "I couldn't find a column matching your request.";
+}
+const hideColumn = {
+    key: 'hideColumn',
+    aliases: [['hide', 'column'], ['hide']],
+    description: 'Hides a column.',
+    resolveEntities: resolveVisibilityColumn,
+    validate: requireColumn,
+    buildCommand: (entities) => ({
+        type: 'hideColumn',
+        params: { colId: entities.column.colId, header: entities.column.header },
+    }),
+    execute: (command, api) => {
+        api.setColumnVisible(command.params.colId, false);
+        return `Hid "${command.params.header}".`;
+    },
+};
+const showColumn = {
+    key: 'showColumn',
+    aliases: [['show', 'column'], ['unhide', 'column'], ['unhide']],
+    description: 'Shows a previously hidden column.',
+    resolveEntities: (tokens, resolver, columns) => {
+        // Match against every column, not just currently visible ones — the
+        // whole point of this intent is finding a column the user hid earlier.
+        return { column: resolver.resolveColumn(tokens, columns) ?? undefined };
+    },
+    validate: requireColumn,
+    buildCommand: (entities) => ({
+        type: 'showColumn',
+        params: { colId: entities.column.colId, header: entities.column.header },
+    }),
+    execute: (command, api) => {
+        api.setColumnVisible(command.params.colId, true);
+        return `Showed "${command.params.header}".`;
+    },
+};
+const hideAllColumns = {
+    key: 'hideAllColumns',
+    aliases: [['hide', 'all', 'column'], ['hide', 'every', 'column']],
+    description: 'Hides every column in the grid (columns marked `alwaysVisible` are left alone).',
+    resolveEntities: () => ({}),
+    buildCommand: () => ({ type: 'hideAllColumns', params: {} }),
+    execute: (_command, api) => {
+        let count = 0;
+        for (const col of api.getAllColumns()) {
+            if (col.alwaysVisible)
+                continue;
+            api.setColumnVisible(col.colId, false);
+            count++;
+        }
+        return `Hid ${count} column${count === 1 ? '' : 's'}.`;
+    },
+};
+const showAllColumns = {
+    key: 'showAllColumns',
+    aliases: [['show', 'all', 'column'], ['show', 'every', 'column'], ['unhide', 'all', 'column'], ['unhide', 'every', 'column']],
+    description: 'Shows every column in the grid.',
+    resolveEntities: () => ({}),
+    buildCommand: () => ({ type: 'showAllColumns', params: {} }),
+    execute: (_command, api) => {
+        const columns = api.getAllColumns();
+        for (const col of columns)
+            api.setColumnVisible(col.colId, true);
+        return `Showed all ${columns.length} columns.`;
+    },
+};
+/** Registers all column-visibility Photon AI intents. */
+export function registerVisibilityCommands(registry) {
+    registry.registerAll([hideAllColumns, showAllColumns, hideColumn, showColumn]);
+}
+//# sourceMappingURL=visibility.commands.js.map

package/photon-ai/builtins/visibility.commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.commands.js","sourceRoot":"","sources":["../../../src/photon-ai/builtins/visibility.commands.ts"],"names":[],"mappings":"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"}

package/photon-ai/command-builder.d.ts

@@ -0,0 +1,21 @@
+import type { ColumnDef } from '../types/column.types';
+import type { GridApi } from '../core/grid-api';
+import type { EntityResolver } from './entity-resolver';
+import type { IntentDefinition, PhotonCommand } from './photon-ai.types';
+/** Result of {@link CommandBuilder.build} — exactly one of `command` or `error` is set. */
+export interface BuildResult {
+    readonly command: PhotonCommand | null;
+    readonly error: string | null;
+}
+/**
+ * Turns a matched intent plus its raw remaining tokens into a validated
+ * {@link PhotonCommand}. Deliberately thin — entity extraction lives in
+ * `EntityResolver`, command shape lives in the intent itself
+ * (`IntentDefinition.buildCommand`) — this class exists as the one seam
+ * between "resolve" and "build" where validation, logging, or a future
+ * confirmation step can be added without touching either side.
+ */
+export declare class CommandBuilder {
+    build(intent: IntentDefinition, tokens: string[], resolver: EntityResolver, columns: ColumnDef[], api: GridApi): BuildResult;
+}
+//# sourceMappingURL=command-builder.d.ts.map

package/photon-ai/command-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-builder.d.ts","sourceRoot":"","sources":["../../src/photon-ai/command-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAoB,MAAM,mBAAmB,CAAC;AAE3F,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,KAAK,CACH,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,SAAS,EAAE,EACpB,GAAG,EAAE,OAAO,GACX,WAAW;CAQf"}

package/photon-ai/command-builder.js

@@ -0,0 +1,18 @@
+/**
+ * Turns a matched intent plus its raw remaining tokens into a validated
+ * {@link PhotonCommand}. Deliberately thin — entity extraction lives in
+ * `EntityResolver`, command shape lives in the intent itself
+ * (`IntentDefinition.buildCommand`) — this class exists as the one seam
+ * between "resolve" and "build" where validation, logging, or a future
+ * confirmation step can be added without touching either side.
+ */
+export class CommandBuilder {
+    build(intent, tokens, resolver, columns, api) {
+        const entities = intent.resolveEntities(tokens, resolver, columns, api);
+        const validationError = intent.validate?.(entities);
+        if (validationError)
+            return { command: null, error: validationError };
+        return { command: intent.buildCommand(entities), error: null };
+    }
+}
+//# sourceMappingURL=command-builder.js.map

package/photon-ai/command-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-builder.js","sourceRoot":"","sources":["../../src/photon-ai/command-builder.ts"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IACzB,KAAK,CACH,MAAwB,EACxB,MAAgB,EAChB,QAAwB,EACxB,OAAoB,EACpB,GAAY;QAEZ,MAAM,QAAQ,GAAqB,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAE1F,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,eAAe;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QAEtE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;CACF"}

package/photon-ai/command-executor.d.ts

@@ -0,0 +1,15 @@
+import type { GridApi } from '../core/grid-api';
+import type { PhotonAICommandRegistry } from './photon-ai-registry';
+import type { PhotonCommand, PhotonCommandResult } from './photon-ai.types';
+/**
+ * Executes a validated {@link PhotonCommand} against the live `GridApi`.
+ * Never bypasses it — every intent's `execute` (see `IntentDefinition`) is
+ * itself written purely in terms of `GridApi` calls, and this class's only
+ * job is to look the right one up by `command.type` and run it safely.
+ */
+export declare class CommandExecutor {
+    private registry;
+    constructor(registry: PhotonAICommandRegistry);
+    execute(command: PhotonCommand, api: GridApi): PhotonCommandResult;
+}
+//# sourceMappingURL=command-executor.d.ts.map

package/photon-ai/command-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/photon-ai/command-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;;;GAKG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,uBAAuB;IAErD,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,GAAG,mBAAmB;CAcnE"}

package/photon-ai/command-executor.js

@@ -0,0 +1,26 @@
+/**
+ * Executes a validated {@link PhotonCommand} against the live `GridApi`.
+ * Never bypasses it — every intent's `execute` (see `IntentDefinition`) is
+ * itself written purely in terms of `GridApi` calls, and this class's only
+ * job is to look the right one up by `command.type` and run it safely.
+ */
+export class CommandExecutor {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    execute(command, api) {
+        const intent = this.registry.get(command.type);
+        if (!intent) {
+            return { success: false, message: `No handler registered for "${command.type}".` };
+        }
+        try {
+            const message = intent.execute(command, api);
+            return { success: true, message, command };
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            return { success: false, message: `Couldn't run that command: ${detail}`, command };
+        }
+    }
+}
+//# sourceMappingURL=command-executor.js.map

package/photon-ai/command-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.js","sourceRoot":"","sources":["../../src/photon-ai/command-executor.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAC1B,YAAoB,QAAiC;QAAjC,aAAQ,GAAR,QAAQ,CAAyB;IAAG,CAAC;IAEzD,OAAO,CAAC,OAAsB,EAAE,GAAY;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,8BAA8B,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QACrF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,8BAA8B,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC;QACtF,CAAC;IACH,CAAC;CACF"}