photon-grid-core 0.0.1

package/photon-ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/photon-ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/photon-ai/intent-parser.d.ts

@@ -0,0 +1,20 @@
+import type { ParsedIntentMatch } from './photon-ai.types';
+import type { PhotonAICommandRegistry } from './photon-ai-registry';
+/**
+ * Matches normalized input tokens against every intent in a
+ * {@link PhotonAICommandRegistry} and returns the single best match.
+ *
+ * Matching is a "bag of words" containment check (see
+ * `IntentDefinition.aliases`) rather than exact-phrase or positional
+ * matching, so a column name or other entity words sitting between an
+ * intent's keywords (e.g. "pin **salary column** left") never breaks
+ * detection. When multiple intents match, the one whose winning alias has
+ * the most words wins — the more specific phrase is preferred (this is what
+ * lets `"show name column"` resolve to *show column* rather than the
+ * shorter, also-present `"show"` fragment of *filter*'s `"show only"` alias,
+ * since that alias isn't fully covered here at all).
+ */
+export declare class IntentParser {
+    parse(tokens: string[], registry: PhotonAICommandRegistry): ParsedIntentMatch | null;
+}
+//# sourceMappingURL=intent-parser.d.ts.map

package/photon-ai/intent-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-parser.d.ts","sourceRoot":"","sources":["../../src/photon-ai/intent-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAyBpE;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IACvB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,uBAAuB,GAAG,iBAAiB,GAAG,IAAI;CAmBrF"}

package/photon-ai/intent-parser.js

@@ -0,0 +1,52 @@
+function matchAlias(alias, tokens) {
+    const tokenSet = new Set(tokens);
+    const covered = alias.every((word) => tokenSet.has(word));
+    return { covered, words: alias };
+}
+/** The best-covered alias for one intent, or `null` if none of its phrases fully matched. */
+function bestAliasFor(intent, tokens) {
+    let best = null;
+    for (const alias of intent.aliases) {
+        const match = matchAlias(alias, tokens);
+        if (!match.covered)
+            continue;
+        if (!best || alias.length > best.length)
+            best = alias;
+    }
+    return best;
+}
+/**
+ * Matches normalized input tokens against every intent in a
+ * {@link PhotonAICommandRegistry} and returns the single best match.
+ *
+ * Matching is a "bag of words" containment check (see
+ * `IntentDefinition.aliases`) rather than exact-phrase or positional
+ * matching, so a column name or other entity words sitting between an
+ * intent's keywords (e.g. "pin **salary column** left") never breaks
+ * detection. When multiple intents match, the one whose winning alias has
+ * the most words wins — the more specific phrase is preferred (this is what
+ * lets `"show name column"` resolve to *show column* rather than the
+ * shorter, also-present `"show"` fragment of *filter*'s `"show only"` alias,
+ * since that alias isn't fully covered here at all).
+ */
+export class IntentParser {
+    parse(tokens, registry) {
+        let winner = null;
+        let winningAlias = null;
+        for (const intent of registry.getAll()) {
+            const alias = bestAliasFor(intent, tokens);
+            if (!alias)
+                continue;
+            if (!winningAlias || alias.length > winningAlias.length) {
+                winner = intent;
+                winningAlias = alias;
+            }
+        }
+        if (!winner || !winningAlias)
+            return null;
+        const usedWords = new Set(winningAlias);
+        const remainingTokens = tokens.filter((t) => !usedWords.has(t));
+        return { intent: winner, remainingTokens };
+    }
+}
+//# sourceMappingURL=intent-parser.js.map

package/photon-ai/intent-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-parser.js","sourceRoot":"","sources":["../../src/photon-ai/intent-parser.ts"],"names":[],"mappings":"AASA,SAAS,UAAU,CAAC,KAAwB,EAAE,MAAyB;IACrE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,6FAA6F;AAC7F,SAAS,YAAY,CAAC,MAAwB,EAAE,MAAyB;IACvE,IAAI,IAAI,GAA6B,IAAI,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,SAAS;QAC7B,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;YAAE,IAAI,GAAG,KAAK,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,YAAY;IACvB,KAAK,CAAC,MAAgB,EAAE,QAAiC;QACvD,IAAI,MAAM,GAA4B,IAAI,CAAC;QAC3C,IAAI,YAAY,GAA6B,IAAI,CAAC;QAElD,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;gBACxD,MAAM,GAAG,MAAM,CAAC;gBAChB,YAAY,GAAG,KAAK,CAAC;YACvB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAE1C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC7C,CAAC;CACF"}

package/photon-ai/photon-ai-memory.d.ts

@@ -0,0 +1,42 @@
+import type { PhotonCommand } from './photon-ai.types';
+/**
+ * Persistent "learning" layer for Photon AI. Every grid feature (sort,
+ * filter, pin, …) already resolves entities from scratch on every prompt;
+ * this store lets two kinds of resolution get *remembered* across page
+ * loads so the same or a similar prompt resolves instantly next time,
+ * without re-running fuzzy matching:
+ *
+ * - **Column aliases** — once a free-text phrase (e.g. "emp name") is
+ *   fuzzily resolved to a real column (e.g. `colId: "name"`), that mapping
+ *   is remembered so the next lookup is an exact hit rather than a fuzzy
+ *   guess.
+ * - **Phrase → commands** — once a whole clause (e.g. "show active items")
+ *   successfully resolves to a set of commands, the exact clause text is
+ *   remembered so retyping it later skips parsing entirely.
+ *
+ * Backed by `localStorage`, namespaced per grid instance (by its column
+ * signature) so unrelated grids on the same page/origin never share learned
+ * state. Falls back to an in-memory-only store when `localStorage` is
+ * unavailable (SSR, privacy mode) or throws — Photon AI must never fail a
+ * command because persistence isn't available.
+ */
+export declare class PhotonAIMemoryStore {
+    private readonly storageKey;
+    private snapshot;
+    constructor(namespace: string);
+    /** The colId previously learned for this exact free-text phrase, or `null`. */
+    getColumnAlias(phrase: string): string | null;
+    /** Remembers that `phrase` refers to `colId`, persisting immediately. */
+    learnColumnAlias(phrase: string, colId: string): void;
+    /** The commands previously learned for this exact normalized clause, or `null`. */
+    getPhraseCommands(clause: string): PhotonCommand[] | null;
+    /** Remembers that submitting `clause` should run `commands`, persisting immediately. */
+    learnPhrase(clause: string, commands: readonly PhotonCommand[]): void;
+    /** Clears every learned column alias and phrase for this namespace. */
+    clear(): void;
+    private load;
+    private persist;
+}
+/** Builds a stable namespace for a grid's column set, so learned memory doesn't leak between differently-shaped grids sharing an origin. */
+export declare function columnSignature(colIds: readonly string[]): string;
+//# sourceMappingURL=photon-ai-memory.d.ts.map

package/photon-ai/photon-ai-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-ai-memory.d.ts","sourceRoot":"","sources":["../../src/photon-ai/photon-ai-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAavD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAyB;gBAE7B,SAAS,EAAE,MAAM;IAK7B,+EAA+E;IAC/E,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI7C,yEAAyE;IACzE,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMrD,mFAAmF;IACnF,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,IAAI;IAIzD,wFAAwF;IACxF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI;IAMrE,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,OAAO;CAQhB;AAED,4IAA4I;AAC5I,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEjE"}

package/photon-ai/photon-ai-memory.js

@@ -0,0 +1,86 @@
+function emptySnapshot() {
+    return { columnAliases: {}, phrases: {} };
+}
+/**
+ * Persistent "learning" layer for Photon AI. Every grid feature (sort,
+ * filter, pin, …) already resolves entities from scratch on every prompt;
+ * this store lets two kinds of resolution get *remembered* across page
+ * loads so the same or a similar prompt resolves instantly next time,
+ * without re-running fuzzy matching:
+ *
+ * - **Column aliases** — once a free-text phrase (e.g. "emp name") is
+ *   fuzzily resolved to a real column (e.g. `colId: "name"`), that mapping
+ *   is remembered so the next lookup is an exact hit rather than a fuzzy
+ *   guess.
+ * - **Phrase → commands** — once a whole clause (e.g. "show active items")
+ *   successfully resolves to a set of commands, the exact clause text is
+ *   remembered so retyping it later skips parsing entirely.
+ *
+ * Backed by `localStorage`, namespaced per grid instance (by its column
+ * signature) so unrelated grids on the same page/origin never share learned
+ * state. Falls back to an in-memory-only store when `localStorage` is
+ * unavailable (SSR, privacy mode) or throws — Photon AI must never fail a
+ * command because persistence isn't available.
+ */
+export class PhotonAIMemoryStore {
+    constructor(namespace) {
+        this.storageKey = `photon-ai:memory:${namespace}`;
+        this.snapshot = this.load();
+    }
+    /** The colId previously learned for this exact free-text phrase, or `null`. */
+    getColumnAlias(phrase) {
+        return this.snapshot.columnAliases[phrase] ?? null;
+    }
+    /** Remembers that `phrase` refers to `colId`, persisting immediately. */
+    learnColumnAlias(phrase, colId) {
+        if (!phrase || this.snapshot.columnAliases[phrase] === colId)
+            return;
+        this.snapshot.columnAliases[phrase] = colId;
+        this.persist();
+    }
+    /** The commands previously learned for this exact normalized clause, or `null`. */
+    getPhraseCommands(clause) {
+        return this.snapshot.phrases[clause] ?? null;
+    }
+    /** Remembers that submitting `clause` should run `commands`, persisting immediately. */
+    learnPhrase(clause, commands) {
+        if (!clause || commands.length === 0)
+            return;
+        this.snapshot.phrases[clause] = [...commands];
+        this.persist();
+    }
+    /** Clears every learned column alias and phrase for this namespace. */
+    clear() {
+        this.snapshot = emptySnapshot();
+        this.persist();
+    }
+    load() {
+        try {
+            if (typeof localStorage === 'undefined')
+                return emptySnapshot();
+            const raw = localStorage.getItem(this.storageKey);
+            if (!raw)
+                return emptySnapshot();
+            const parsed = JSON.parse(raw);
+            return { columnAliases: parsed.columnAliases ?? {}, phrases: parsed.phrases ?? {} };
+        }
+        catch {
+            return emptySnapshot();
+        }
+    }
+    persist() {
+        try {
+            if (typeof localStorage === 'undefined')
+                return;
+            localStorage.setItem(this.storageKey, JSON.stringify(this.snapshot));
+        }
+        catch {
+            // Storage unavailable/full/blocked — learning silently degrades to in-memory-only for this session.
+        }
+    }
+}
+/** Builds a stable namespace for a grid's column set, so learned memory doesn't leak between differently-shaped grids sharing an origin. */
+export function columnSignature(colIds) {
+    return [...colIds].sort().join('|');
+}
+//# sourceMappingURL=photon-ai-memory.js.map

package/photon-ai/photon-ai-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-ai-memory.js","sourceRoot":"","sources":["../../src/photon-ai/photon-ai-memory.ts"],"names":[],"mappings":"AASA,SAAS,aAAa;IACpB,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,mBAAmB;IAI9B,YAAY,SAAiB;QAC3B,IAAI,CAAC,UAAU,GAAG,oBAAoB,SAAS,EAAE,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,+EAA+E;IAC/E,cAAc,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IACrD,CAAC;IAED,yEAAyE;IACzE,gBAAgB,CAAC,MAAc,EAAE,KAAa;QAC5C,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,KAAK;YAAE,OAAO;QACrE,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,mFAAmF;IACnF,iBAAiB,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC/C,CAAC;IAED,wFAAwF;IACxF,WAAW,CAAC,MAAc,EAAE,QAAkC;QAC5D,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,uEAAuE;IACvE,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,aAAa,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,IAAI;QACV,IAAI,CAAC;YACH,IAAI,OAAO,YAAY,KAAK,WAAW;gBAAE,OAAO,aAAa,EAAE,CAAC;YAChE,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAClD,IAAI,CAAC,GAAG;gBAAE,OAAO,aAAa,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoC,CAAC;YAClE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,aAAa,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,OAAO;QACb,IAAI,CAAC;YACH,IAAI,OAAO,YAAY,KAAK,WAAW;gBAAE,OAAO;YAChD,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,oGAAoG;QACtG,CAAC;IACH,CAAC;CACF;AAED,4IAA4I;AAC5I,MAAM,UAAU,eAAe,CAAC,MAAyB;IACvD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/photon-ai/photon-ai-panel.d.ts

@@ -0,0 +1,54 @@
+import type { IconRenderer } from '../icons/icon-renderer';
+import type { PhotonAIConfig } from '../types/photon-ai.types';
+import type { PhotonCommandResult } from './photon-ai.types';
+/**
+ * The "Photon AI" panel — a docked sidebar sliding in from the right edge of
+ * the grid's own body viewport, where users type natural-language commands
+ * and questions for {@link PhotonAIService} to interpret, with a scrollable
+ * conversation history (not just a one-line status) so multi-turn use
+ * (a command, then a follow-up question, then another command) reads like a
+ * chat rather than a disappearing toast.
+ *
+ * Mounted as a sibling of the pinned-column panels (same pattern as
+ * `DetailRowRenderer`/the sticky layer — see `GridRenderer.buildLayout`), so
+ * it floats independently of virtualization and never affects row layout.
+ * It deliberately stays *inside* the grid's own body box (never
+ * `document.body`) — `bodyWrapEl`'s `overflow: hidden` is what keeps the
+ * whole widget contained to the grid the way an embeddable component should
+ * be, rather than taking over the host page. Unlike a modal, it never
+ * blocks interaction with the grid behind it — there is no backdrop.
+ *
+ * Pure UI: it knows nothing about intents, columns, or the `GridApi` — it
+ * only calls the submit handler wired in via {@link setSubmitHandler} and
+ * renders whatever `PhotonCommandResult` comes back.
+ */
+export declare class PhotonAIPanel {
+    private iconRenderer;
+    private launcherEl;
+    private panelEl;
+    private logEl;
+    private inputEl;
+    private sendBtnEl;
+    private submitHandler;
+    private isOpen;
+    private messages;
+    constructor(iconRenderer: IconRenderer);
+    /** Mounts the launcher + docked side panel into the grid body. Idempotent-safe: call once per grid instance. */
+    mount(bodyWrapEl: HTMLElement, config: PhotonAIConfig): void;
+    /** Wires the callback that turns typed text into a result — set once `GridApi`/`PhotonAIService` exist (after `GridCore` construction). */
+    setSubmitHandler(fn: (text: string) => PhotonCommandResult): void;
+    /** Programmatic equivalent of typing `text` and pressing send — also appends to the conversation log, so a scripted call and a manual one look identical. */
+    invoke(text: string): PhotonCommandResult;
+    open(): void;
+    close(): void;
+    destroy(): void;
+    private buildLauncher;
+    private buildPanel;
+    private buildHeader;
+    private buildInputArea;
+    private autoGrow;
+    private trySubmit;
+    private appendGreeting;
+    private appendMessage;
+}
+//# sourceMappingURL=photon-ai-panel.d.ts.map

package/photon-ai/photon-ai-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-ai-panel.d.ts","sourceRoot":"","sources":["../../src/photon-ai/photon-ai-panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAa7D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAa;IAWZ,OAAO,CAAC,YAAY;IAVhC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,SAAS,CAAkC;IAEnD,OAAO,CAAC,aAAa,CAAwD;IAC7E,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAqB;gBAEjB,YAAY,EAAE,YAAY;IAE9C,gHAAgH;IAChH,KAAK,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAS5D,2IAA2I;IAC3I,gBAAgB,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,mBAAmB,GAAG,IAAI;IAIjE,6JAA6J;IAC7J,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB;IAOzC,IAAI,IAAI,IAAI;IASZ,KAAK,IAAI,IAAI;IAOb,OAAO,IAAI,IAAI;IAcf,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,cAAc;IAmCtB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;CAkBtB"}

package/photon-ai/photon-ai-panel.js

@@ -0,0 +1,191 @@
+import { createDiv, createElement } from '../renderer/dom-utils';
+/** Textarea grows with content up to this height (px), then scrolls internally. */
+const INPUT_MAX_HEIGHT_PX = 120;
+/**
+ * The "Photon AI" panel — a docked sidebar sliding in from the right edge of
+ * the grid's own body viewport, where users type natural-language commands
+ * and questions for {@link PhotonAIService} to interpret, with a scrollable
+ * conversation history (not just a one-line status) so multi-turn use
+ * (a command, then a follow-up question, then another command) reads like a
+ * chat rather than a disappearing toast.
+ *
+ * Mounted as a sibling of the pinned-column panels (same pattern as
+ * `DetailRowRenderer`/the sticky layer — see `GridRenderer.buildLayout`), so
+ * it floats independently of virtualization and never affects row layout.
+ * It deliberately stays *inside* the grid's own body box (never
+ * `document.body`) — `bodyWrapEl`'s `overflow: hidden` is what keeps the
+ * whole widget contained to the grid the way an embeddable component should
+ * be, rather than taking over the host page. Unlike a modal, it never
+ * blocks interaction with the grid behind it — there is no backdrop.
+ *
+ * Pure UI: it knows nothing about intents, columns, or the `GridApi` — it
+ * only calls the submit handler wired in via {@link setSubmitHandler} and
+ * renders whatever `PhotonCommandResult` comes back.
+ */
+export class PhotonAIPanel {
+    constructor(iconRenderer) {
+        this.iconRenderer = iconRenderer;
+        this.launcherEl = null;
+        this.panelEl = null;
+        this.logEl = null;
+        this.inputEl = null;
+        this.sendBtnEl = null;
+        this.submitHandler = null;
+        this.isOpen = false;
+        this.messages = [];
+    }
+    /** Mounts the launcher + docked side panel into the grid body. Idempotent-safe: call once per grid instance. */
+    mount(bodyWrapEl, config) {
+        this.launcherEl = this.buildLauncher();
+        this.panelEl = this.buildPanel(config);
+        bodyWrapEl.appendChild(this.launcherEl);
+        bodyWrapEl.appendChild(this.panelEl);
+        if (config.defaultOpen)
+            this.open();
+    }
+    /** Wires the callback that turns typed text into a result — set once `GridApi`/`PhotonAIService` exist (after `GridCore` construction). */
+    setSubmitHandler(fn) {
+        this.submitHandler = fn;
+    }
+    /** Programmatic equivalent of typing `text` and pressing send — also appends to the conversation log, so a scripted call and a manual one look identical. */
+    invoke(text) {
+        this.appendMessage({ role: 'user', text });
+        const result = this.submitHandler?.(text) ?? { success: false, message: 'Photon AI is not ready yet.' };
+        this.appendMessage({ role: 'assistant', text: result.message, success: result.success });
+        return result;
+    }
+    open() {
+        if (this.isOpen || !this.panelEl || !this.launcherEl)
+            return;
+        this.isOpen = true;
+        this.launcherEl.classList.add('pg-ai-launcher--hidden');
+        this.panelEl.classList.add('pg-ai-panel--open');
+        if (this.messages.length === 0)
+            this.appendGreeting();
+        requestAnimationFrame(() => this.inputEl?.focus());
+    }
+    close() {
+        if (!this.isOpen || !this.panelEl || !this.launcherEl)
+            return;
+        this.isOpen = false;
+        this.panelEl.classList.remove('pg-ai-panel--open');
+        this.launcherEl.classList.remove('pg-ai-launcher--hidden');
+    }
+    destroy() {
+        this.launcherEl?.remove();
+        this.panelEl?.remove();
+        this.launcherEl = null;
+        this.panelEl = null;
+        this.logEl = null;
+        this.inputEl = null;
+        this.sendBtnEl = null;
+        this.submitHandler = null;
+        this.messages = [];
+    }
+    // ─── Private: construction ─────────────────────────────────────────────
+    buildLauncher() {
+        const btn = createElement('button', { type: 'button', 'aria-label': 'Open Photon AI' });
+        btn.className = 'pg-ai-launcher';
+        btn.appendChild(this.iconRenderer.render('sparkle', { size: 20 }));
+        btn.addEventListener('click', () => this.open());
+        return btn;
+    }
+    buildPanel(config) {
+        const panel = createDiv('pg-ai-panel');
+        panel.setAttribute('role', 'complementary');
+        panel.setAttribute('aria-label', 'Photon AI');
+        panel.appendChild(this.buildHeader());
+        this.logEl = createDiv('pg-ai-panel__log');
+        this.logEl.setAttribute('role', 'log');
+        this.logEl.setAttribute('aria-live', 'polite');
+        panel.appendChild(this.logEl);
+        panel.appendChild(this.buildInputArea(config));
+        return panel;
+    }
+    buildHeader() {
+        const header = createDiv('pg-ai-panel__header');
+        const title = createDiv('pg-ai-panel__title');
+        title.appendChild(this.iconRenderer.render('sparkle', { size: 16 }));
+        const label = document.createElement('span');
+        label.textContent = 'Photon AI';
+        title.appendChild(label);
+        header.appendChild(title);
+        const closeBtn = createElement('button', { type: 'button', 'aria-label': 'Close Photon AI' });
+        closeBtn.className = 'pg-ai-panel__close';
+        closeBtn.appendChild(this.iconRenderer.render('close', { size: 14 }));
+        closeBtn.addEventListener('click', () => this.close());
+        header.appendChild(closeBtn);
+        return header;
+    }
+    buildInputArea(config) {
+        const wrap = createDiv('pg-ai-panel__input-wrap');
+        const input = createElement('textarea', {
+            placeholder: config.placeholder ?? 'Ask Photon AI to do something...',
+            rows: 1,
+        });
+        input.className = 'pg-ai-panel__input';
+        this.inputEl = input;
+        const sendBtn = createElement('button', { type: 'button', 'aria-label': 'Send' });
+        sendBtn.className = 'pg-ai-panel__send';
+        sendBtn.disabled = true;
+        sendBtn.appendChild(this.iconRenderer.render('arrowUp', { size: 14 }));
+        this.sendBtnEl = sendBtn;
+        input.addEventListener('input', () => {
+            this.autoGrow(input);
+            sendBtn.disabled = input.value.trim().length === 0;
+        });
+        input.addEventListener('keydown', (e) => {
+            if (e.key === 'Enter' && !e.shiftKey) {
+                e.preventDefault();
+                this.trySubmit();
+            }
+        });
+        sendBtn.addEventListener('click', () => this.trySubmit());
+        wrap.appendChild(input);
+        wrap.appendChild(sendBtn);
+        return wrap;
+    }
+    // ─── Private: behavior ──────────────────────────────────────────────────
+    autoGrow(input) {
+        input.style.height = 'auto';
+        input.style.height = `${Math.min(input.scrollHeight, INPUT_MAX_HEIGHT_PX)}px`;
+    }
+    trySubmit() {
+        const input = this.inputEl;
+        const sendBtn = this.sendBtnEl;
+        if (!input || !sendBtn)
+            return;
+        const text = input.value.trim();
+        if (!text || sendBtn.disabled)
+            return;
+        this.invoke(text);
+        input.value = '';
+        sendBtn.disabled = true;
+        this.autoGrow(input);
+    }
+    appendGreeting() {
+        this.appendMessage({
+            role: 'assistant',
+            text: 'Hi! Tell me what to do — sort, filter, pin, group, hide/show columns, move columns, selection, and more — or ask me a question about the grid\'s current state (try "help" to see everything I understand).',
+            success: true,
+        });
+    }
+    appendMessage(message) {
+        this.messages.push(message);
+        if (!this.logEl)
+            return;
+        const bubble = createDiv(`pg-ai-panel__message pg-ai-panel__message--${message.role}`);
+        if (message.role === 'assistant') {
+            bubble.classList.toggle('pg-ai-panel__message--error', message.success === false);
+        }
+        // Multi-line responses (e.g. "help"'s bulleted list) render as separate lines.
+        for (const line of message.text.split('\n')) {
+            const lineEl = document.createElement('div');
+            lineEl.textContent = line;
+            bubble.appendChild(lineEl);
+        }
+        this.logEl.appendChild(bubble);
+        this.logEl.scrollTop = this.logEl.scrollHeight;
+    }
+}
+//# sourceMappingURL=photon-ai-panel.js.map

package/photon-ai/photon-ai-panel.js.map

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

package/photon-ai/photon-ai-registry.d.ts

@@ -0,0 +1,25 @@
+import type { IntentDefinition } from './photon-ai.types';
+/**
+ * Catalog of every intent Photon AI can recognize. Pure storage — matching
+ * input against the catalog is `IntentParser`'s job, not this class's; this
+ * keeps "what intents exist" fully decoupled from "how text is matched to
+ * one of them".
+ *
+ * Any grid feature can extend the catalog at runtime via {@link register} —
+ * built-in intents (sort, filter, pin, …) register themselves exactly the
+ * same way a future custom feature would, so there is no special-casing
+ * between "built-in" and "user-defined" commands.
+ */
+export declare class PhotonAICommandRegistry {
+    private readonly intents;
+    /** Registers an intent, replacing any existing one with the same `key`. */
+    register(intent: IntentDefinition): void;
+    /** Registers several intents in one call — a small convenience for a feature's `registerAI()` entry point. */
+    registerAll(intents: readonly IntentDefinition[]): void;
+    unregister(key: string): void;
+    get(key: string): IntentDefinition | undefined;
+    getAll(): IntentDefinition[];
+    has(key: string): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=photon-ai-registry.d.ts.map

package/photon-ai/photon-ai-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-ai-registry.d.ts","sourceRoot":"","sources":["../../src/photon-ai/photon-ai-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIxC,8GAA8G;IAC9G,WAAW,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI;IAIvD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI9C,MAAM,IAAI,gBAAgB,EAAE;IAI5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,KAAK,IAAI,IAAI;CAGd"}

package/photon-ai/photon-ai-registry.js

@@ -0,0 +1,41 @@
+/**
+ * Catalog of every intent Photon AI can recognize. Pure storage — matching
+ * input against the catalog is `IntentParser`'s job, not this class's; this
+ * keeps "what intents exist" fully decoupled from "how text is matched to
+ * one of them".
+ *
+ * Any grid feature can extend the catalog at runtime via {@link register} —
+ * built-in intents (sort, filter, pin, …) register themselves exactly the
+ * same way a future custom feature would, so there is no special-casing
+ * between "built-in" and "user-defined" commands.
+ */
+export class PhotonAICommandRegistry {
+    constructor() {
+        this.intents = new Map();
+    }
+    /** Registers an intent, replacing any existing one with the same `key`. */
+    register(intent) {
+        this.intents.set(intent.key, intent);
+    }
+    /** Registers several intents in one call — a small convenience for a feature's `registerAI()` entry point. */
+    registerAll(intents) {
+        for (const intent of intents)
+            this.register(intent);
+    }
+    unregister(key) {
+        this.intents.delete(key);
+    }
+    get(key) {
+        return this.intents.get(key);
+    }
+    getAll() {
+        return Array.from(this.intents.values());
+    }
+    has(key) {
+        return this.intents.has(key);
+    }
+    clear() {
+        this.intents.clear();
+    }
+}
+//# sourceMappingURL=photon-ai-registry.js.map

package/photon-ai/photon-ai-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-ai-registry.js","sourceRoot":"","sources":["../../src/photon-ai/photon-ai-registry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,uBAAuB;IAApC;QACmB,YAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IA+BjE,CAAC;IA7BC,2EAA2E;IAC3E,QAAQ,CAAC,MAAwB;QAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,8GAA8G;IAC9G,WAAW,CAAC,OAAoC;QAC9C,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/photon-ai/photon-ai-service.d.ts

@@ -0,0 +1,71 @@
+import type { GridApi } from '../core/grid-api';
+import { PhotonAICommandRegistry } from './photon-ai-registry';
+import type { PhotonCommandResult } from './photon-ai.types';
+/**
+ * The only public entry point into Photon AI. Runs the full deterministic
+ * pipeline for one prompt:
+ *
+ * ```
+ * split into clauses → (learned-phrase replay | normalize → parse intent →
+ * resolve entities → build command) → execute → learn
+ * ```
+ *
+ * A compound sentence ("hide the id column and sort by price descending")
+ * is split into independent clauses by {@link splitClauses} and each is run
+ * through the pipeline in order, so multi-step natural-language requests
+ * work without any single intent needing to know about the others.
+ *
+ * Every successfully-executed clause is remembered by a
+ * {@link PhotonAIMemoryStore}, namespaced to this grid's current columns:
+ * the *next* time the same clause is typed, it replays the learned command
+ * directly (skipping intent matching and entity resolution entirely) as
+ * long as the column it refers to still exists — this is what makes Photon
+ * AI "learn" a user's phrasing over time, including phrasings that only
+ * resolved on the first try via fuzzy/implicit matching.
+ *
+ * Every stage past clause-splitting is a small, independent, replaceable
+ * collaborator (`IntentParser`, `EntityResolver`, `CommandBuilder`,
+ * `CommandExecutor`); this class only sequences them and never contains
+ * matching or execution logic itself.
+ */
+export declare class PhotonAIService {
+    private api;
+    private readonly registry;
+    private readonly memory;
+    private readonly parser;
+    private readonly resolver;
+    private readonly builder;
+    private readonly executor;
+    /**
+     * @param api - The grid's own `GridApi` — every command runs through it, never around it.
+     * @param registry - Supply a custom registry to fully replace the built-ins, or omit to get sort/filter/pin/visibility/grouping/selection out of the box.
+     */
+    constructor(api: GridApi, registry?: PhotonAICommandRegistry);
+    /** A registry pre-populated with every built-in intent — the default `PhotonAIService` uses when none is supplied. */
+    static createDefaultRegistry(): PhotonAICommandRegistry;
+    /** Registers additional custom intents at runtime (e.g. a third-party feature's own `registerAI()`). */
+    getRegistry(): PhotonAICommandRegistry;
+    /** Forgets every column alias and phrase this service has learned for the current grid — useful after a large schema change or for testing. */
+    forgetLearnedMemory(): void;
+    /**
+     * Runs one prompt through the full pipeline. Always resolves —
+     * parsing/resolution failures come back as `{ success: false }`, never a
+     * thrown error. A compound sentence runs each clause independently and
+     * aggregates their results.
+     */
+    submit(rawInput: string): PhotonCommandResult;
+    private runClause;
+    private runCommands;
+    /**
+     * Handles a clause that normalized away to nothing — every one of its
+     * words was filler. Rather than a blanket parse error, greetings and
+     * thanks get a friendly, on-brand reply; anything else (stray filler with
+     * no real words at all) still reports that it couldn't be parsed.
+     */
+    private replyToSmallTalk;
+    /** A learned command referencing a column that's since been removed/renamed can't be safely replayed — falls back to re-parsing the clause instead. */
+    private commandStillValid;
+    /** The set of verbs `splitClauses` treats as "this starts a new command" — every registered intent's leading alias word, recomputed per call so custom intents registered at runtime are picked up immediately. */
+    private clauseVerbs;
+}
+//# sourceMappingURL=photon-ai-service.d.ts.map

package/photon-ai/photon-ai-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-ai-service.d.ts","sourceRoot":"","sources":["../../src/photon-ai/photon-ai-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAkB5E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,eAAe;IAYd,OAAO,CAAC,GAAG;IAXvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAE3C;;;OAGG;gBACiB,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,uBAAuB;IAOpE,sHAAsH;IACtH,MAAM,CAAC,qBAAqB,IAAI,uBAAuB;IAMvD,wGAAwG;IACxG,WAAW,IAAI,uBAAuB;IAItC,+IAA+I;IAC/I,mBAAmB,IAAI,IAAI;IAI3B;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IAe7C,OAAO,CAAC,SAAS;IAwBjB,OAAO,CAAC,WAAW;IAUnB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAgBxB,uJAAuJ;IACvJ,OAAO,CAAC,iBAAiB;IAKzB,mNAAmN;IACnN,OAAO,CAAC,WAAW;CASpB"}