@portel/photon-core 2.3.0 → 2.5.0

package/dist/asset-discovery.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Asset Discovery Utilities
+ *
+ * Discover and extract UI, prompt, and resource assets from Photon files.
+ * Extracted from photon's loader.ts.
+ *
+ * Depends on: getMimeType (from ./mime-types), SchemaExtractor (from ./schema-extractor)
+ */
+import type { PhotonAssets } from './types.js';
+/**
+ * Discover and extract assets from a Photon file
+ *
+ * Convention:
+ * - Asset folder: {photon-name}/ next to {photon-name}.photon.ts
+ * - Subfolder: ui/, prompts/, resources/
+ *
+ * @param photonPath - Absolute path to the .photon.ts file
+ * @param source - Source code content of the Photon file
+ */
+export declare function discoverAssets(photonPath: string, source: string): Promise<PhotonAssets | undefined>;
+/**
+ * Auto-discover assets from the ui/, prompts/, resources/ subdirectories
+ */
+export declare function autoDiscoverAssets(assetFolder: string, assets: PhotonAssets): Promise<void>;
+//# sourceMappingURL=asset-discovery.d.ts.map

package/dist/asset-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-discovery.d.ts","sourceRoot":"","sources":["../src/asset-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc/C;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA+CnC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAiEf"}

package/dist/asset-discovery.js

@@ -0,0 +1,145 @@
+/**
+ * Asset Discovery Utilities
+ *
+ * Discover and extract UI, prompt, and resource assets from Photon files.
+ * Extracted from photon's loader.ts.
+ *
+ * Depends on: getMimeType (from ./mime-types), SchemaExtractor (from ./schema-extractor)
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { getMimeType } from './mime-types.js';
+import { SchemaExtractor } from './schema-extractor.js';
+/**
+ * Check if a file or directory exists
+ */
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Discover and extract assets from a Photon file
+ *
+ * Convention:
+ * - Asset folder: {photon-name}/ next to {photon-name}.photon.ts
+ * - Subfolder: ui/, prompts/, resources/
+ *
+ * @param photonPath - Absolute path to the .photon.ts file
+ * @param source - Source code content of the Photon file
+ */
+export async function discoverAssets(photonPath, source) {
+    const extractor = new SchemaExtractor();
+    const dir = path.dirname(photonPath);
+    const basename = path.basename(photonPath, '.photon.ts');
+    // Convention: asset folder has same name as photon (without .photon.ts)
+    const assetFolder = path.join(dir, basename);
+    // Check if asset folder exists
+    let folderExists = false;
+    try {
+        const stat = await fs.stat(assetFolder);
+        folderExists = stat.isDirectory();
+    }
+    catch {
+        // Folder doesn't exist
+    }
+    // Extract explicit asset declarations from source annotations
+    const assets = extractor.extractAssets(source, folderExists ? assetFolder : undefined);
+    // If no folder exists and no explicit declarations, skip
+    if (!folderExists &&
+        assets.ui.length === 0 &&
+        assets.prompts.length === 0 &&
+        assets.resources.length === 0) {
+        return undefined;
+    }
+    if (folderExists) {
+        // Resolve paths for explicitly declared assets
+        for (const ui of assets.ui) {
+            ui.resolvedPath = path.resolve(assetFolder, ui.path.replace(/^\.\//, ''));
+        }
+        for (const prompt of assets.prompts) {
+            prompt.resolvedPath = path.resolve(assetFolder, prompt.path.replace(/^\.\//, ''));
+        }
+        for (const resource of assets.resources) {
+            resource.resolvedPath = path.resolve(assetFolder, resource.path.replace(/^\.\//, ''));
+        }
+        // Auto-discover assets from folder structure
+        await autoDiscoverAssets(assetFolder, assets);
+    }
+    return assets;
+}
+/**
+ * Auto-discover assets from the ui/, prompts/, resources/ subdirectories
+ */
+export async function autoDiscoverAssets(assetFolder, assets) {
+    // Auto-discover UI files
+    const uiDir = path.join(assetFolder, 'ui');
+    if (await fileExists(uiDir)) {
+        try {
+            const files = await fs.readdir(uiDir);
+            for (const file of files) {
+                const id = path.basename(file, path.extname(file));
+                if (!assets.ui.find((u) => u.id === id)) {
+                    assets.ui.push({
+                        id,
+                        path: `./ui/${file}`,
+                        resolvedPath: path.join(uiDir, file),
+                        // Don't set mimeType for UI assets - let server decide based on client capabilities
+                        // Server will use getUIMimeType() to return text/html;profile=mcp-app for MCP Apps clients
+                    });
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    // Auto-discover prompt files
+    const promptsDir = path.join(assetFolder, 'prompts');
+    if (await fileExists(promptsDir)) {
+        try {
+            const files = await fs.readdir(promptsDir);
+            for (const file of files) {
+                if (file.endsWith('.md') || file.endsWith('.txt')) {
+                    const id = path.basename(file, path.extname(file));
+                    if (!assets.prompts.find((p) => p.id === id)) {
+                        assets.prompts.push({
+                            id,
+                            path: `./prompts/${file}`,
+                            resolvedPath: path.join(promptsDir, file),
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    // Auto-discover resource files
+    const resourcesDir = path.join(assetFolder, 'resources');
+    if (await fileExists(resourcesDir)) {
+        try {
+            const files = await fs.readdir(resourcesDir);
+            for (const file of files) {
+                const id = path.basename(file, path.extname(file));
+                if (!assets.resources.find((r) => r.id === id)) {
+                    assets.resources.push({
+                        id,
+                        path: `./resources/${file}`,
+                        resolvedPath: path.join(resourcesDir, file),
+                        mimeType: getMimeType(file),
+                    });
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+}
+//# sourceMappingURL=asset-discovery.js.map

package/dist/asset-discovery.js.map

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

package/dist/base.d.ts

@@ -47,6 +47,12 @@ import { MCPClient, MCPClientFactory } from '@portel/mcp';
  * - Return value = Tool result
  */
 export declare class PhotonMCP {
+    /**
+     * Photon name (MCP name) - set by runtime loader
+     * Used to identify the source of emitted events for injected photon routing
+     * @internal
+     */
+    _photonName?: string;
     /**
      * Emit an event/progress update
      *

package/dist/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAkB,MAAM,aAAa,CAAC;AAK1E;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IA0B/B;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAEzC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAsF;IAEzG;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM,EAAE;IAiCjC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAkBrH;;OAEG;IACG,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAC9B,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAoBhF;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAM9C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOzC;;;;;;;;;;;;;;;;;;;;;OAqBG;cACa,QAAQ,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC;CAGd"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAkB,MAAM,aAAa,CAAC;AAK1E;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IA+B/B;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAEzC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAsF;IAEzG;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAQ3B;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM,EAAE;IAiCjC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAkBrH;;OAEG;IACG,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAC9B,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAoBhF;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAM9C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOzC;;;;;;;;;;;;;;;;;;;;;OAqBG;cACa,QAAQ,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC;CAGd"}

package/dist/base.js

@@ -50,6 +50,12 @@ import { withLock as withLockHelper } from './decorators.js';
  * - Return value = Tool result
  */
 export class PhotonMCP {
+    /**
+     * Photon name (MCP name) - set by runtime loader
+     * Used to identify the source of emitted events for injected photon routing
+     * @internal
+     */
+    _photonName;
     /**
      * Emit an event/progress update
      *
@@ -73,9 +79,13 @@ export class PhotonMCP {
      */
     emit(data) {
         const store = executionContext.getStore();
+        // Include source photon name for injected photon event routing
+        const emitData = this._photonName && typeof data === 'object' && data !== null
+            ? { ...data, _source: this._photonName }
+            : data;
         // Send to local output handler (current caller)
         if (store?.outputHandler) {
-            store.outputHandler(data);
+            store.outputHandler(emitData);
         }
         // If channel is specified, also publish to broker for cross-process notification
         if (data && typeof data.channel === 'string') {

package/dist/base.js.map

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

package/dist/class-detection.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Class Detection Utilities
+ *
+ * Shared logic for detecting Photon classes in ES modules.
+ * Extracted from photon, ncp, and lumina loaders.
+ */
+/**
+ * Check if a value is a class constructor
+ */
+export declare function isClass(fn: unknown): fn is new (...args: unknown[]) => unknown;
+/**
+ * Check if a class has async methods (instance or static)
+ *
+ * Checks for AsyncFunction, AsyncGeneratorFunction, and GeneratorFunction
+ * on both prototype (instance methods) and the class itself (static methods).
+ */
+export declare function hasAsyncMethods(ClassConstructor: new (...args: unknown[]) => unknown): boolean;
+/**
+ * Find a single Photon class in a module
+ *
+ * Priority: default export first, then named exports.
+ * Returns the first class with async methods, or null.
+ */
+export declare function findPhotonClass(module: Record<string, unknown>): (new (...args: unknown[]) => unknown) | null;
+/**
+ * Find all Photon classes in a module
+ *
+ * Returns every exported class that has async methods.
+ * Used by NCP which may load multiple classes from one file.
+ */
+export declare function findPhotonClasses(module: Record<string, unknown>): Array<new (...args: unknown[]) => unknown>;
+//# sourceMappingURL=class-detection.d.ts.map

package/dist/class-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-detection.d.ts","sourceRoot":"","sources":["../src/class-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,OAAO,CA+B9F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,IAAI,CAgB7G;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAU7G"}

package/dist/class-detection.js

@@ -0,0 +1,86 @@
+/**
+ * Class Detection Utilities
+ *
+ * Shared logic for detecting Photon classes in ES modules.
+ * Extracted from photon, ncp, and lumina loaders.
+ */
+/**
+ * Check if a value is a class constructor
+ */
+export function isClass(fn) {
+    return typeof fn === 'function' && /^\s*class\s+/.test(fn.toString());
+}
+/**
+ * Check if a class has async methods (instance or static)
+ *
+ * Checks for AsyncFunction, AsyncGeneratorFunction, and GeneratorFunction
+ * on both prototype (instance methods) and the class itself (static methods).
+ */
+export function hasAsyncMethods(ClassConstructor) {
+    const asyncCtorNames = new Set([
+        'AsyncFunction',
+        'AsyncGeneratorFunction',
+        'GeneratorFunction',
+    ]);
+    // Check instance methods on prototype
+    const prototype = ClassConstructor.prototype;
+    for (const key of Object.getOwnPropertyNames(prototype)) {
+        if (key === 'constructor')
+            continue;
+        const descriptor = Object.getOwnPropertyDescriptor(prototype, key);
+        if (descriptor && typeof descriptor.value === 'function') {
+            if (asyncCtorNames.has(descriptor.value.constructor.name)) {
+                return true;
+            }
+        }
+    }
+    // Check static methods on the class itself
+    for (const key of Object.getOwnPropertyNames(ClassConstructor)) {
+        if (['length', 'name', 'prototype'].includes(key))
+            continue;
+        const descriptor = Object.getOwnPropertyDescriptor(ClassConstructor, key);
+        if (descriptor && typeof descriptor.value === 'function') {
+            if (asyncCtorNames.has(descriptor.value.constructor.name)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Find a single Photon class in a module
+ *
+ * Priority: default export first, then named exports.
+ * Returns the first class with async methods, or null.
+ */
+export function findPhotonClass(module) {
+    // Try default export first
+    if (module.default && isClass(module.default)) {
+        if (hasAsyncMethods(module.default)) {
+            return module.default;
+        }
+    }
+    // Try named exports
+    for (const exportedItem of Object.values(module)) {
+        if (isClass(exportedItem) && hasAsyncMethods(exportedItem)) {
+            return exportedItem;
+        }
+    }
+    return null;
+}
+/**
+ * Find all Photon classes in a module
+ *
+ * Returns every exported class that has async methods.
+ * Used by NCP which may load multiple classes from one file.
+ */
+export function findPhotonClasses(module) {
+    const classes = [];
+    for (const exportedItem of Object.values(module)) {
+        if (isClass(exportedItem) && hasAsyncMethods(exportedItem)) {
+            classes.push(exportedItem);
+        }
+    }
+    return classes;
+}
+//# sourceMappingURL=class-detection.js.map

package/dist/class-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-detection.js","sourceRoot":"","sources":["../src/class-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,EAAW;IACjC,OAAO,OAAO,EAAE,KAAK,UAAU,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,gBAAqD;IACnF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;QAC7B,eAAe;QACf,wBAAwB;QACxB,mBAAmB;KACpB,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,IAAI,GAAG,KAAK,aAAa;YAAE,SAAS;QACpC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACnE,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACzD,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1D,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAC1E,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACzD,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1D,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAA+B;IAC7D,2BAA2B;IAC3B,IAAI,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,IAAI,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA+B;IAC/D,MAAM,OAAO,GAA+C,EAAE,CAAC;IAE/D,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/collections/ReactiveArray.d.ts

@@ -0,0 +1,97 @@
+/**
+ * ReactiveArray - A managed array that auto-emits events on mutations
+ *
+ * When used as a class property, automatically emits events when items are
+ * added, removed, or updated.
+ *
+ * @example
+ * ```typescript
+ * import { ReactiveArray } from '@portel/photon-core';
+ *
+ * export default class TodoList {
+ *   items = ReactiveArray.create<Task>('items', (event, data) => this.emit(event, data));
+ *
+ *   add(text: string) {
+ *     this.items.push({ id: crypto.randomUUID(), text });
+ *     // Auto-emits 'items:added' with the new item
+ *   }
+ * }
+ * ```
+ *
+ * Event naming convention (inspired by Firebase):
+ * - `{prop}:added` - Item pushed/inserted
+ * - `{prop}:removed` - Item popped/spliced out
+ * - `{prop}:updated` - Item at index changed
+ * - `{prop}:changed` - Full array replaced
+ */
+export type Emitter = (event: string, data: unknown) => void;
+export declare class ReactiveArray<T> extends Array<T> {
+    private _propertyName;
+    private _emitter;
+    /**
+     * Create a new ReactiveArray bound to a property name and emitter function.
+     * The emitter is called with event names like 'items:added', 'items:removed', etc.
+     */
+    static create<T>(propertyName: string, emitter: Emitter, initialItems?: T[]): ReactiveArray<T>;
+    /**
+     * Add one or more elements to the end of the array.
+     * Emits `{prop}:added` for each item.
+     */
+    push(...items: T[]): number;
+    /**
+     * Remove the last element from the array.
+     * Emits `{prop}:removed` with the removed item.
+     */
+    pop(): T | undefined;
+    /**
+     * Remove the first element from the array.
+     * Emits `{prop}:removed` with the removed item.
+     */
+    shift(): T | undefined;
+    /**
+     * Add one or more elements to the beginning of the array.
+     * Emits `{prop}:added` for each item.
+     */
+    unshift(...items: T[]): number;
+    /**
+     * Remove/replace elements from the array.
+     * Emits `{prop}:removed` for deleted items and `{prop}:added` for inserted items.
+     */
+    splice(start: number, deleteCount?: number, ...items: T[]): T[];
+    /**
+     * Set an element at a specific index.
+     * Emits `{prop}:updated` with `{ index, value, previous }`.
+     */
+    set(index: number, value: T): void;
+    /**
+     * Replace all items in the array.
+     * Emits `{prop}:changed` with the full new array.
+     */
+    replaceAll(items: T[]): void;
+    /**
+     * Clear all items from the array.
+     * Emits `{prop}:changed` with an empty array.
+     */
+    clear(): void;
+    /**
+     * Sort the array in place.
+     * Emits `{prop}:changed` with the sorted array.
+     */
+    sort(compareFn?: (a: T, b: T) => number): this;
+    /**
+     * Reverse the array in place.
+     * Emits `{prop}:changed` with the reversed array.
+     */
+    reverse(): this;
+    /**
+     * Fill the array with a value.
+     * Emits `{prop}:changed` with the filled array.
+     */
+    fill(value: T, start?: number, end?: number): this;
+    /**
+     * Copy items within the array.
+     * Emits `{prop}:changed` with the modified array.
+     */
+    copyWithin(target: number, start: number, end?: number): this;
+}
+//# sourceMappingURL=ReactiveArray.d.ts.map

package/dist/collections/ReactiveArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactiveArray.d.ts","sourceRoot":"","sources":["../../src/collections/ReactiveArray.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAE7D,qBAAa,aAAa,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAqB;IAErC;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EACb,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,CAAC,EAAE,GACjB,aAAa,CAAC,CAAC,CAAC;IAWnB;;;OAGG;IACH,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM;IAM3B;;;OAGG;IACH,GAAG,IAAI,CAAC,GAAG,SAAS;IAQpB;;;OAGG;IACH,KAAK,IAAI,CAAC,GAAG,SAAS;IAQtB;;;OAGG;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM;IAM9B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAS/D;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAMlC;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAO5B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI;IAM9C;;;OAGG;IACH,OAAO,IAAI,IAAI;IAMf;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAMlD;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;CAK9D"}

package/dist/collections/ReactiveArray.js

@@ -0,0 +1,158 @@
+/**
+ * ReactiveArray - A managed array that auto-emits events on mutations
+ *
+ * When used as a class property, automatically emits events when items are
+ * added, removed, or updated.
+ *
+ * @example
+ * ```typescript
+ * import { ReactiveArray } from '@portel/photon-core';
+ *
+ * export default class TodoList {
+ *   items = ReactiveArray.create<Task>('items', (event, data) => this.emit(event, data));
+ *
+ *   add(text: string) {
+ *     this.items.push({ id: crypto.randomUUID(), text });
+ *     // Auto-emits 'items:added' with the new item
+ *   }
+ * }
+ * ```
+ *
+ * Event naming convention (inspired by Firebase):
+ * - `{prop}:added` - Item pushed/inserted
+ * - `{prop}:removed` - Item popped/spliced out
+ * - `{prop}:updated` - Item at index changed
+ * - `{prop}:changed` - Full array replaced
+ */
+export class ReactiveArray extends Array {
+    _propertyName = '';
+    _emitter = () => { };
+    /**
+     * Create a new ReactiveArray bound to a property name and emitter function.
+     * The emitter is called with event names like 'items:added', 'items:removed', etc.
+     */
+    static create(propertyName, emitter, initialItems) {
+        const arr = new ReactiveArray();
+        arr._propertyName = propertyName;
+        arr._emitter = emitter;
+        if (initialItems) {
+            // Use super.push to avoid triggering events during init
+            globalThis.Array.prototype.push.apply(arr, initialItems);
+        }
+        return arr;
+    }
+    /**
+     * Add one or more elements to the end of the array.
+     * Emits `{prop}:added` for each item.
+     */
+    push(...items) {
+        const result = super.push(...items);
+        items.forEach((item) => this._emitter(`${this._propertyName}:added`, item));
+        return result;
+    }
+    /**
+     * Remove the last element from the array.
+     * Emits `{prop}:removed` with the removed item.
+     */
+    pop() {
+        const item = super.pop();
+        if (item !== undefined) {
+            this._emitter(`${this._propertyName}:removed`, item);
+        }
+        return item;
+    }
+    /**
+     * Remove the first element from the array.
+     * Emits `{prop}:removed` with the removed item.
+     */
+    shift() {
+        const item = super.shift();
+        if (item !== undefined) {
+            this._emitter(`${this._propertyName}:removed`, item);
+        }
+        return item;
+    }
+    /**
+     * Add one or more elements to the beginning of the array.
+     * Emits `{prop}:added` for each item.
+     */
+    unshift(...items) {
+        const result = super.unshift(...items);
+        items.forEach((item) => this._emitter(`${this._propertyName}:added`, item));
+        return result;
+    }
+    /**
+     * Remove/replace elements from the array.
+     * Emits `{prop}:removed` for deleted items and `{prop}:added` for inserted items.
+     */
+    splice(start, deleteCount, ...items) {
+        const removed = super.splice(start, deleteCount ?? 0, ...items);
+        removed.forEach((item) => this._emitter(`${this._propertyName}:removed`, item));
+        items.forEach((item) => this._emitter(`${this._propertyName}:added`, item));
+        return removed;
+    }
+    /**
+     * Set an element at a specific index.
+     * Emits `{prop}:updated` with `{ index, value, previous }`.
+     */
+    set(index, value) {
+        const previous = this[index];
+        this[index] = value;
+        this._emitter(`${this._propertyName}:updated`, { index, value, previous });
+    }
+    /**
+     * Replace all items in the array.
+     * Emits `{prop}:changed` with the full new array.
+     */
+    replaceAll(items) {
+        // Clear and replace
+        this.length = 0;
+        globalThis.Array.prototype.push.apply(this, items);
+        this._emitter(`${this._propertyName}:changed`, [...items]);
+    }
+    /**
+     * Clear all items from the array.
+     * Emits `{prop}:changed` with an empty array.
+     */
+    clear() {
+        this.length = 0;
+        this._emitter(`${this._propertyName}:changed`, []);
+    }
+    /**
+     * Sort the array in place.
+     * Emits `{prop}:changed` with the sorted array.
+     */
+    sort(compareFn) {
+        super.sort(compareFn);
+        this._emitter(`${this._propertyName}:changed`, [...this]);
+        return this;
+    }
+    /**
+     * Reverse the array in place.
+     * Emits `{prop}:changed` with the reversed array.
+     */
+    reverse() {
+        super.reverse();
+        this._emitter(`${this._propertyName}:changed`, [...this]);
+        return this;
+    }
+    /**
+     * Fill the array with a value.
+     * Emits `{prop}:changed` with the filled array.
+     */
+    fill(value, start, end) {
+        super.fill(value, start, end);
+        this._emitter(`${this._propertyName}:changed`, [...this]);
+        return this;
+    }
+    /**
+     * Copy items within the array.
+     * Emits `{prop}:changed` with the modified array.
+     */
+    copyWithin(target, start, end) {
+        super.copyWithin(target, start, end);
+        this._emitter(`${this._propertyName}:changed`, [...this]);
+        return this;
+    }
+}
+//# sourceMappingURL=ReactiveArray.js.map

package/dist/collections/ReactiveArray.js.map

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