@portel/photon-core 2.5.4 → 2.6.0

package/README.md

@@ -510,6 +510,104 @@ See [CHANNELS.md](./CHANNELS.md) for full architecture documentation.
 
 ---
 
+### Managed Collections
+
+Reactive collections that auto-emit events on mutations, enabling seamless real-time sync between server and client.
+
+#### Level 1: Zero Effort (just import)
+
+```typescript
+import { PhotonMCP } from '@portel/photon-core';
+
+export default class TodoList extends PhotonMCP {
+  items: Task[] = [];  // Compiler transforms to ReactiveArray
+
+  async add(text: string) {
+    this.items.push({ id: crypto.randomUUID(), text });
+    // Auto-emits 'items:added' — no manual wiring
+  }
+}
+```
+
+The compiler detects `extends PhotonMCP` with `= []` array initializers and transforms them to `ReactiveArray` instances. The runtime auto-wires `_propertyName` and `_emitter` after instantiation.
+
+**Available reactive types:** `Array` (alias for `ReactiveArray`), `Map` (`ReactiveMap`), `Set` (`ReactiveSet`)
+
+**Event naming (Firebase-style):**
+
+| Operation | Event | Data |
+|-----------|-------|------|
+| `push(item)` | `{prop}:added` | The item |
+| `pop()` / `splice(i, 1)` | `{prop}:removed` | The removed item |
+| `set(i, val)` | `{prop}:updated` | `{ index, value, previous }` |
+| `replaceAll(items)` | `{prop}:changed` | All items |
+
+#### Level 2: Rich Collections
+
+`Collection<T>` extends `ReactiveArray<T>` with Laravel-style query chaining and auto-UI rendering hints.
+
+```typescript
+import { PhotonMCP, Collection } from '@portel/photon-core';
+
+type Product = { name: string; price: number; stock: number; category: string };
+
+export default class ProductCatalog extends PhotonMCP {
+  products = new Collection<Product>();
+
+  async catalog() {
+    return this.products.where('stock', '>', 0).sortBy('price');
+  }
+
+  async dashboard() {
+    return this.products.where('category', 'Electronics').as('cards');
+  }
+
+  async cheapest() {
+    return this.products.sortBy('price').first();
+  }
+}
+```
+
+**Query methods** (immutable — return new `Collection<T>`):
+
+| Method | Example |
+|--------|---------|
+| `where(key, op?, val)` | `.where('price', '>', 100)` or `.where('status', 'active')` |
+| `query(fn)` | `.query(p => p.stock > 0)` |
+| `collect(fn)` | `.collect(p => ({ ...p, label: p.name }))` |
+| `pluck(key)` | `.pluck('name')` → `Collection<string>` |
+| `sortBy(key \| fn, dir?)` | `.sortBy('price', 'desc')` |
+| `groupBy(key \| fn)` | `.groupBy('category')` → `Record<string, Collection<T>>` |
+| `unique(key?)` | `.unique('category')` |
+| `take(n)` / `skip(n)` | `.take(10)` |
+
+**Terminal methods:**
+
+| Method | Return |
+|--------|--------|
+| `first(fn?)` / `last(fn?)` | `T \| undefined` |
+| `count()` / `isEmpty()` | `number` / `boolean` |
+| `sum(key?)` / `avg(key?)` | `number` |
+| `min(key?)` / `max(key?)` | `T \| undefined` |
+| `aggregate(fn, init)` | `U` |
+
+**Rendering hints** for auto-UI:
+
+```typescript
+// .as() attaches a format hint — auto-UI renders accordingly
+this.products.where('stock', '>', 0).as('table');
+this.products.where('category', 'Electronics').as('cards');
+```
+
+Formats: `'table'` | `'cards'` | `'list'` | `'chart'` | `'grid'` | `'chips'`
+
+Without `.as()`, `toJSON()` returns a plain array (backward compatible). With `.as()`, it returns:
+```json
+{ "_photonType": "collection:cards", "items": [...], "count": 3 }
+```
+
+---
+
 ## 🏗️ Building Custom Runtimes
 
 Photon Core is designed to be the foundation for custom runtimes. Here are examples:

package/dist/collections/Collection.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Collection<T> — Rich queryable collection with Laravel-style chaining
+ *
+ * Extends ReactiveArray<T> so mutations auto-emit events. Query methods return
+ * new immutable Collection instances (no emitter wired) that can be further
+ * chained or serialized.
+ *
+ * @example
+ * ```typescript
+ * import { PhotonMCP, Collection } from '@portel/photon-core';
+ *
+ * export default class ProductCatalog extends PhotonMCP {
+ *   products = new Collection<Product>();
+ *
+ *   async catalog() {
+ *     return this.products.where('stock', '>', 0).sortBy('price');
+ *   }
+ *
+ *   async dashboard() {
+ *     return this.products.where('category', 'Electronics').as('cards');
+ *   }
+ * }
+ * ```
+ */
+import { ReactiveArray, type Emitter } from './ReactiveArray.js';
+/** Comparison operators for where() clauses */
+export type CompareOp = '=' | '!=' | '>' | '<' | '>=' | '<=' | '===';
+/** Rendering format hints for auto-UI */
+export type RenderFormat = 'table' | 'cards' | 'list' | 'chart' | 'grid' | 'chips';
+/** Rendering hint attached via .as() */
+export interface RenderHint {
+    format: RenderFormat;
+    options?: Record<string, unknown>;
+}
+export declare class Collection<T> extends ReactiveArray<T> {
+    /** Rendering hint set by .as() */
+    _renderHint: RenderHint | null;
+    /**
+     * Create a new Collection with optional initial items.
+     * Items are loaded without triggering events.
+     */
+    constructor(items?: T[]);
+    /**
+     * Create a Collection bound to a property name and emitter (for runtime wiring).
+     */
+    static create<T>(propertyName: string, emitter: Emitter, initialItems?: T[]): Collection<T>;
+    /**
+     * Create a Collection from an existing array.
+     */
+    static from<T>(items: T[]): Collection<T>;
+    private _result;
+    /**
+     * Filter items by field comparison.
+     *
+     * Shorthand: `where('status', 'active')` → equality check
+     * Full:      `where('price', '>', 100)` → comparison
+     */
+    where(key: keyof T & string, opOrVal: CompareOp | T[keyof T], val?: T[keyof T]): Collection<T>;
+    /**
+     * Filter items with a predicate function.
+     */
+    query(fn: (item: T) => boolean): Collection<T>;
+    /**
+     * Transform each item.
+     */
+    collect<U>(fn: (item: T) => U): Collection<U>;
+    /**
+     * Extract a single field from each item.
+     */
+    pluck<K extends keyof T>(key: K): Collection<T[K]>;
+    /**
+     * Sort by a key or comparator function.
+     * Returns a new sorted Collection (does NOT mutate).
+     */
+    sortBy(keyOrFn: (keyof T & string) | ((a: T, b: T) => number), direction?: 'asc' | 'desc'): Collection<T>;
+    /**
+     * Group items by a key or function.
+     * Returns a record of group-name → Collection.
+     */
+    groupBy(keyOrFn: (keyof T & string) | ((item: T) => string)): Record<string, Collection<T>>;
+    /**
+     * Remove duplicates, optionally by a key.
+     */
+    unique(key?: keyof T & string): Collection<T>;
+    /**
+     * Take the first n items.
+     */
+    take(n: number): Collection<T>;
+    /**
+     * Skip the first n items.
+     */
+    skip(n: number): Collection<T>;
+    /**
+     * Get the first item, optionally matching a predicate.
+     */
+    first(fn?: (item: T) => boolean): T | undefined;
+    /**
+     * Get the last item, optionally matching a predicate.
+     */
+    last(fn?: (item: T) => boolean): T | undefined;
+    /**
+     * Count items.
+     */
+    count(): number;
+    /**
+     * Check if collection is empty.
+     */
+    isEmpty(): boolean;
+    /**
+     * Sum numeric values, optionally by key.
+     */
+    sum(key?: keyof T & string): number;
+    /**
+     * Average of numeric values, optionally by key.
+     */
+    avg(key?: keyof T & string): number;
+    /**
+     * Item with minimum value (by key or raw comparison).
+     */
+    min(key?: keyof T & string): T | undefined;
+    /**
+     * Item with maximum value (by key or raw comparison).
+     */
+    max(key?: keyof T & string): T | undefined;
+    /**
+     * Reduce the collection to a single value.
+     */
+    aggregate<U>(fn: (acc: U, item: T) => U, initial: U): U;
+    /**
+     * Attach a rendering hint for auto-UI.
+     * Returns `this` for chaining at the end of a query.
+     */
+    as(format: RenderFormat, options?: Record<string, unknown>): this;
+    /**
+     * Custom serialization.
+     * - Without `.as()`: plain array (backward compatible)
+     * - With `.as()`: metadata object with `_photonType`, items, and count
+     */
+    toJSON(): T[] | {
+        _photonType: string;
+        items: T[];
+        count: number;
+        renderOptions?: Record<string, unknown>;
+    };
+}
+//# sourceMappingURL=Collection.d.ts.map

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

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

package/dist/collections/Collection.js

@@ -0,0 +1,312 @@
+/**
+ * Collection<T> — Rich queryable collection with Laravel-style chaining
+ *
+ * Extends ReactiveArray<T> so mutations auto-emit events. Query methods return
+ * new immutable Collection instances (no emitter wired) that can be further
+ * chained or serialized.
+ *
+ * @example
+ * ```typescript
+ * import { PhotonMCP, Collection } from '@portel/photon-core';
+ *
+ * export default class ProductCatalog extends PhotonMCP {
+ *   products = new Collection<Product>();
+ *
+ *   async catalog() {
+ *     return this.products.where('stock', '>', 0).sortBy('price');
+ *   }
+ *
+ *   async dashboard() {
+ *     return this.products.where('category', 'Electronics').as('cards');
+ *   }
+ * }
+ * ```
+ */
+import { ReactiveArray } from './ReactiveArray.js';
+// No-op emitter for query result collections (immutable — no events)
+const NOOP_EMITTER = () => { };
+export class Collection extends ReactiveArray {
+    /** Rendering hint set by .as() */
+    _renderHint = null;
+    /**
+     * Create a new Collection with optional initial items.
+     * Items are loaded without triggering events.
+     */
+    constructor(items) {
+        super();
+        if (items && items.length > 0) {
+            globalThis.Array.prototype.push.apply(this, items);
+        }
+    }
+    /**
+     * Create a Collection bound to a property name and emitter (for runtime wiring).
+     */
+    static create(propertyName, emitter, initialItems) {
+        const col = new Collection(initialItems);
+        col._propertyName = propertyName;
+        col._emitter = emitter;
+        return col;
+    }
+    /**
+     * Create a Collection from an existing array.
+     */
+    static from(items) {
+        return new Collection(items);
+    }
+    // ─── Helper: create an immutable query-result Collection ───
+    _result(items) {
+        const col = new Collection(items);
+        col._emitter = NOOP_EMITTER;
+        return col;
+    }
+    // ─── Query Methods (immutable — return new Collection) ───
+    /**
+     * Filter items by field comparison.
+     *
+     * Shorthand: `where('status', 'active')` → equality check
+     * Full:      `where('price', '>', 100)` → comparison
+     */
+    where(key, opOrVal, val) {
+        let op;
+        let compareVal;
+        if (val === undefined) {
+            // Shorthand: where('status', 'active') → equality
+            op = '=';
+            compareVal = opOrVal;
+        }
+        else {
+            op = opOrVal;
+            compareVal = val;
+        }
+        return this._result(globalThis.Array.prototype.filter.call(this, (item) => {
+            const fieldVal = item[key];
+            switch (op) {
+                case '=': return fieldVal == compareVal;
+                case '===': return fieldVal === compareVal;
+                case '!=': return fieldVal != compareVal;
+                case '>': return fieldVal > compareVal;
+                case '<': return fieldVal < compareVal;
+                case '>=': return fieldVal >= compareVal;
+                case '<=': return fieldVal <= compareVal;
+                default: return false;
+            }
+        }));
+    }
+    /**
+     * Filter items with a predicate function.
+     */
+    query(fn) {
+        return this._result(globalThis.Array.prototype.filter.call(this, fn));
+    }
+    /**
+     * Transform each item.
+     */
+    collect(fn) {
+        return this._result(globalThis.Array.prototype.map.call(this, fn));
+    }
+    /**
+     * Extract a single field from each item.
+     */
+    pluck(key) {
+        return this._result(globalThis.Array.prototype.map.call(this, (item) => item[key]));
+    }
+    /**
+     * Sort by a key or comparator function.
+     * Returns a new sorted Collection (does NOT mutate).
+     */
+    sortBy(keyOrFn, direction = 'asc') {
+        const items = globalThis.Array.from(this);
+        if (typeof keyOrFn === 'function') {
+            items.sort(keyOrFn);
+        }
+        else {
+            const key = keyOrFn;
+            items.sort((a, b) => {
+                const aVal = a[key];
+                const bVal = b[key];
+                if (aVal < bVal)
+                    return direction === 'asc' ? -1 : 1;
+                if (aVal > bVal)
+                    return direction === 'asc' ? 1 : -1;
+                return 0;
+            });
+        }
+        return this._result(items);
+    }
+    /**
+     * Group items by a key or function.
+     * Returns a record of group-name → Collection.
+     */
+    groupBy(keyOrFn) {
+        const groups = {};
+        for (let i = 0; i < this.length; i++) {
+            const item = this[i];
+            const groupKey = typeof keyOrFn === 'function'
+                ? keyOrFn(item)
+                : String(item[keyOrFn]);
+            if (!groups[groupKey])
+                groups[groupKey] = [];
+            groups[groupKey].push(item);
+        }
+        const result = {};
+        for (const [k, v] of Object.entries(groups)) {
+            result[k] = this._result(v);
+        }
+        return result;
+    }
+    /**
+     * Remove duplicates, optionally by a key.
+     */
+    unique(key) {
+        const seen = new globalThis.Set();
+        const items = [];
+        for (let i = 0; i < this.length; i++) {
+            const item = this[i];
+            const val = key ? item[key] : item;
+            if (!seen.has(val)) {
+                seen.add(val);
+                items.push(item);
+            }
+        }
+        return this._result(items);
+    }
+    /**
+     * Take the first n items.
+     */
+    take(n) {
+        return this._result(globalThis.Array.prototype.slice.call(this, 0, n));
+    }
+    /**
+     * Skip the first n items.
+     */
+    skip(n) {
+        return this._result(globalThis.Array.prototype.slice.call(this, n));
+    }
+    // ─── Terminal Methods ───
+    /**
+     * Get the first item, optionally matching a predicate.
+     */
+    first(fn) {
+        if (!fn)
+            return this[0];
+        for (let i = 0; i < this.length; i++) {
+            if (fn(this[i]))
+                return this[i];
+        }
+        return undefined;
+    }
+    /**
+     * Get the last item, optionally matching a predicate.
+     */
+    last(fn) {
+        if (!fn)
+            return this[this.length - 1];
+        for (let i = this.length - 1; i >= 0; i--) {
+            if (fn(this[i]))
+                return this[i];
+        }
+        return undefined;
+    }
+    /**
+     * Count items.
+     */
+    count() {
+        return this.length;
+    }
+    /**
+     * Check if collection is empty.
+     */
+    isEmpty() {
+        return this.length === 0;
+    }
+    /**
+     * Sum numeric values, optionally by key.
+     */
+    sum(key) {
+        let total = 0;
+        for (let i = 0; i < this.length; i++) {
+            const val = key ? this[i][key] : this[i];
+            total += Number(val) || 0;
+        }
+        return total;
+    }
+    /**
+     * Average of numeric values, optionally by key.
+     */
+    avg(key) {
+        if (this.length === 0)
+            return 0;
+        return this.sum(key) / this.length;
+    }
+    /**
+     * Item with minimum value (by key or raw comparison).
+     */
+    min(key) {
+        if (this.length === 0)
+            return undefined;
+        let minItem = this[0];
+        let minVal = key ? minItem[key] : minItem;
+        for (let i = 1; i < this.length; i++) {
+            const val = key ? this[i][key] : this[i];
+            if (val < minVal) {
+                minItem = this[i];
+                minVal = val;
+            }
+        }
+        return minItem;
+    }
+    /**
+     * Item with maximum value (by key or raw comparison).
+     */
+    max(key) {
+        if (this.length === 0)
+            return undefined;
+        let maxItem = this[0];
+        let maxVal = key ? maxItem[key] : maxItem;
+        for (let i = 1; i < this.length; i++) {
+            const val = key ? this[i][key] : this[i];
+            if (val > maxVal) {
+                maxItem = this[i];
+                maxVal = val;
+            }
+        }
+        return maxItem;
+    }
+    /**
+     * Reduce the collection to a single value.
+     */
+    aggregate(fn, initial) {
+        let acc = initial;
+        for (let i = 0; i < this.length; i++) {
+            acc = fn(acc, this[i]);
+        }
+        return acc;
+    }
+    // ─── Rendering Hints ───
+    /**
+     * Attach a rendering hint for auto-UI.
+     * Returns `this` for chaining at the end of a query.
+     */
+    as(format, options) {
+        this._renderHint = { format, options };
+        return this;
+    }
+    /**
+     * Custom serialization.
+     * - Without `.as()`: plain array (backward compatible)
+     * - With `.as()`: metadata object with `_photonType`, items, and count
+     */
+    toJSON() {
+        const items = globalThis.Array.from(this);
+        if (!this._renderHint) {
+            return items;
+        }
+        return {
+            _photonType: `collection:${this._renderHint.format}`,
+            items,
+            count: items.length,
+            ...(this._renderHint.options ? { renderOptions: this._renderHint.options } : {}),
+        };
+    }
+}
+//# sourceMappingURL=Collection.js.map

package/dist/collections/Collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collection.js","sourceRoot":"","sources":["../../src/collections/Collection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,aAAa,EAAgB,MAAM,oBAAoB,CAAC;AAcjE,qEAAqE;AACrE,MAAM,YAAY,GAAY,GAAG,EAAE,GAAE,CAAC,CAAC;AAEvC,MAAM,OAAO,UAAc,SAAQ,aAAgB;IACjD,kCAAkC;IAClC,WAAW,GAAsB,IAAI,CAAC;IAEtC;;;OAGG;IACH,YAAY,KAAW;QACrB,KAAK,EAAE,CAAC;QACR,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAU,MAAM,CACpB,YAAoB,EACpB,OAAgB,EAChB,YAAkB;QAElB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAI,YAAY,CAAC,CAAC;QAC3C,GAAW,CAAC,aAAa,GAAG,YAAY,CAAC;QACzC,GAAW,CAAC,QAAQ,GAAG,OAAO,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAI,KAAU;QACvB,OAAO,IAAI,UAAU,CAAI,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,8DAA8D;IAEtD,OAAO,CAAI,KAAU;QAC3B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAI,KAAK,CAAC,CAAC;QACpC,GAAW,CAAC,QAAQ,GAAG,YAAY,CAAC;QACrC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,4DAA4D;IAE5D;;;;;OAKG;IACH,KAAK,CAAC,GAAqB,EAAE,OAA+B,EAAE,GAAgB;QAC5E,IAAI,EAAa,CAAC;QAClB,IAAI,UAAmB,CAAC;QAExB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,kDAAkD;YAClD,EAAE,GAAG,GAAG,CAAC;YACT,UAAU,GAAG,OAAO,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,OAAoB,CAAC;YAC1B,UAAU,GAAG,GAAG,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CACjB,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAO,EAAE,EAAE;YACvD,MAAM,QAAQ,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;YACxD,QAAQ,EAAE,EAAE,CAAC;gBACX,KAAK,GAAG,CAAC,CAAC,OAAO,QAAQ,IAAI,UAAU,CAAC;gBACxC,KAAK,KAAK,CAAC,CAAC,OAAO,QAAQ,KAAK,UAAU,CAAC;gBAC3C,KAAK,IAAI,CAAC,CAAC,OAAO,QAAQ,IAAI,UAAU,CAAC;gBACzC,KAAK,GAAG,CAAC,CAAC,OAAQ,QAAmB,GAAI,UAAqB,CAAC;gBAC/D,KAAK,GAAG,CAAC,CAAC,OAAQ,QAAmB,GAAI,UAAqB,CAAC;gBAC/D,KAAK,IAAI,CAAC,CAAC,OAAQ,QAAmB,IAAK,UAAqB,CAAC;gBACjE,KAAK,IAAI,CAAC,CAAC,OAAQ,QAAmB,IAAK,UAAqB,CAAC;gBACjE,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC;YACxB,CAAC;QACH,CAAC,CAAQ,CACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,EAAwB;QAC5B,OAAO,IAAI,CAAC,OAAO,CACjB,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAQ,CACxD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO,CAAI,EAAkB;QAC3B,OAAO,IAAI,CAAC,OAAO,CACjB,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAQ,CACrD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAoB,GAAM;QAC7B,OAAO,IAAI,CAAC,OAAO,CACjB,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAO,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAW,CAC5E,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAoD,EAAE,YAA4B,KAAK;QAC5F,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAQ,CAAC;QACjD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,OAAO,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAClB,MAAM,IAAI,GAAI,CAA6B,CAAC,GAAG,CAAW,CAAC;gBAC3D,MAAM,IAAI,GAAI,CAA6B,CAAC,GAAG,CAAW,CAAC;gBAC3D,IAAI,IAAI,GAAG,IAAI;oBAAE,OAAO,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,IAAI,IAAI,GAAG,IAAI;oBAAE,OAAO,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,OAAO,CAAC,CAAC;YACX,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,OAAiD;QACvD,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,QAAQ,GAAG,OAAO,OAAO,KAAK,UAAU;gBAC5C,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;gBACf,CAAC,CAAC,MAAM,CAAE,IAAgC,CAAC,OAAO,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAC7C,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,MAAM,GAAkC,EAAE,CAAC;QACjD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAsB;QAC3B,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,GAAG,EAAW,CAAC;QAC3C,MAAM,KAAK,GAAQ,EAAE,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,IAAgC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAChE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,CAAS;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAQ,CAAC,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,CAAS;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAQ,CAAC,CAAC;IAC7E,CAAC;IAED,2BAA2B;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAyB;QAC7B,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,EAAyB;QAC5B,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAsB;QACxB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAA6B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtE,KAAK,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAsB;QACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAsB;QACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACxC,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,CAAE,OAAmC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAA6B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtE,IAAK,GAAc,GAAI,MAAiB,EAAE,CAAC;gBACzC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,MAAM,GAAG,GAAG,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAsB;QACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACxC,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,CAAE,OAAmC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAA6B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtE,IAAK,GAAc,GAAI,MAAiB,EAAE,CAAC;gBACzC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,MAAM,GAAG,GAAG,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,SAAS,CAAI,EAA0B,EAAE,OAAU;QACjD,IAAI,GAAG,GAAG,OAAO,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,0BAA0B;IAE1B;;;OAGG;IACH,EAAE,CAAC,MAAoB,EAAE,OAAiC;QACxD,IAAI,CAAC,WAAW,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAQ,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO;YACL,WAAW,EAAE,cAAc,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE;YACpD,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjF,CAAC;IACJ,CAAC;CACF"}

package/dist/collections/index.d.ts

@@ -51,6 +51,7 @@
 export { ReactiveArray, type Emitter } from './ReactiveArray.js';
 export { ReactiveMap } from './ReactiveMap.js';
 export { ReactiveSet } from './ReactiveSet.js';
+export { Collection, type RenderHint, type RenderFormat, type CompareOp } from './Collection.js';
 export { ReactiveArray as Array } from './ReactiveArray.js';
 export { ReactiveMap as Map } from './ReactiveMap.js';
 export { ReactiveSet as Set } from './ReactiveSet.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjG,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/collections/index.js

@@ -51,6 +51,7 @@
 export { ReactiveArray } from './ReactiveArray.js';
 export { ReactiveMap } from './ReactiveMap.js';
 export { ReactiveSet } from './ReactiveSet.js';
+export { Collection } from './Collection.js';
 // Level 1 exports: Shadow global types for zero-effort reactivity
 // Just `import { Array } from '@portel/photon-core'` and use normally
 export { ReactiveArray as Array } from './ReactiveArray.js';

package/dist/collections/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAE,aAAa,EAAgB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,kEAAkE;AAClE,sEAAsE;AACtE,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EAAE,aAAa,EAAgB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAsD,MAAM,iBAAiB,CAAC;AAEjG,kEAAkE;AAClE,sEAAsE;AACtE,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,IAAI,GAAG,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -61,6 +61,6 @@ export { discoverAssets, autoDiscoverAssets, } from './asset-discovery.js';
 export { Array, // Shadows global Array
 Map, // Shadows global Map
 Set, // Shadows global Set
-ReactiveArray, ReactiveMap, ReactiveSet, type Emitter, } from './collections/index.js';
+ReactiveArray, ReactiveMap, ReactiveSet, type Emitter, Collection, type RenderHint, type RenderFormat, type CompareOp, } from './collections/index.js';
 export { PhotonUIType, isPhotonUIType, Field, type FieldDefinition, type FieldType, type FieldAlignment, type BaseFieldOptions, type TextFieldOptions, type NumberFieldOptions, type CurrencyFieldOptions, type DateFieldOptions, type DateFormat, type ImageFieldOptions, type BadgeFieldOptions, type RatingFieldOptions, type PriceFieldOptions, type StockFieldOptions, type ActionItem, type ActionsFieldOptions, type RenderFunction, getFieldValue, formatFieldLabel, interpolateTemplate, renderFieldToText, renderFieldToStructured, type RenderedField, Table, type TableColumn, type TableOptions, type ColumnType, Cards, type CardFieldMapping, type CardsOptions, Chart, type ChartType, type ChartSeries, type ChartDataPoint, type ChartOptions, Stats, type StatItem, type StatFormat, type StatsOptions, Progress, type ProgressBar, type ProgressStep, type ProgressStyle, type StepStatus, type ProgressOptions, Form, type FormField, type FieldType as FormFieldType, type FormOptions, } from './ui-types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,aAAa,EAGlB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,EAGN,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAGhB,gBAAgB,EAChB,cAAc,EACd,UAAU,EAGV,SAAS,EAGT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EAGb,MAAM,EACN,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AAIrB,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAGlB,SAAS,EACT,KAAK,gBAAgB,EACrB,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EAGd,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,gBAAgB,EAGhB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,cAAc,EAGd,MAAM,EACN,OAAO,EACP,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,OAAO,EAEL,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,WAAW,EAGX,wBAAwB,EACxB,gBAAgB,EAGhB,gBAAgB,EAGhB,WAAW,EAGX,uBAAuB,EACvB,eAAe,EAGf,eAAe,EAGf,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EAGX,KAAK,YAAY,EACjB,KAAK,kBAAkB,EAGvB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAG5B,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAGrB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,MAAM,EAGX,KAAK,eAAe,EAGpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAGlB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAGjB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,UAAU,EACV,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EACX,KAAK,eAAe,IAAI,uBAAuB,EAC/C,KAAK,aAAa,IAAI,qBAAqB,EAC3C,iBAAiB,IAAI,yBAAyB,EAC9C,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,KAAK,UAAU,EACf,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAIxC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,sBAAsB,CAAC;AAIrC,cAAc,gBAAgB,CAAC;AAI/B,cAAc,qBAAqB,CAAC;AAIpC,OAAO,EACL,QAAQ,EACR,cAAc,EACd,cAAc,EACd,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAIvB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAIrB,OAAO,EACL,OAAO,EACP,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9C,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,WAAW,EACX,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,cAAc,EACd,OAAO,EACP,KAAK,EACL,OAAO,EACP,UAAU,EACV,SAAS,EACT,cAAc,EACd,OAAO,EACP,SAAS,EACT,KAAK,EACL,QAAQ,EACR,eAAe,EACf,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAEL,KAAK,EAAG,uBAAuB;AAC/B,GAAG,EAAK,qBAAqB;AAC7B,GAAG,EAAK,qBAAqB;AAE7B,aAAa,EACb,WAAW,EACX,WAAW,EACX,KAAK,OAAO,EAEZ,UAAU,EACV,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAEL,YAAY,EACZ,cAAc,EAGd,KAAK,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,aAAa,EAGlB,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,EACL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAGjB,KAAK,EACL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,EACL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EAGpB,IAAI,EACJ,KAAK,SAAS,EACd,KAAK,SAAS,IAAI,aAAa,EAC/B,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -142,7 +142,9 @@ Array, // Shadows global Array
 Map, // Shadows global Map
 Set, // Shadows global Set
 // Level 2: Explicit control - use .create() for custom wiring
-ReactiveArray, ReactiveMap, ReactiveSet, } from './collections/index.js';
+ReactiveArray, ReactiveMap, ReactiveSet, 
+// Level 2+: Rich queryable collection with rendering hints
+Collection, } from './collections/index.js';
 // ===== PURPOSE-DRIVEN UI TYPES =====
 // Polymorphic return types that auto-render with appropriate UI
 export { 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,yCAAyC;AACzC,gEAAgE;AAChE,OAAO;AASL,iBAAiB;AACjB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM;AAEN,WAAW;AACX,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,gBAAgB;AAEhB,oBAAoB;AACpB,gBAAgB,EAChB,cAAc,EACd,UAAU;AAEV,aAAa;AACb,SAAS;AAET,iBAAiB;AACjB,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa;AAEb,SAAS;AACT,MAAM,EACN,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,yCAAyC;AACzC,oDAAoD;AACpD,OAAO;AAeL,aAAa;AACb,SAAS,EAET,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,cAAc;AAEd,oBAAoB;AACpB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,gBAAgB;AAEhB,oBAAoB;AACpB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,cAAc;AAEd,cAAc;AACd,MAAM,EACN,OAAO,EACP,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,sCAAsC;AAEtC,uCAAuC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,wBAAwB;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,0CAA0C;AAC1C,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAE5B,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,8CAA8C;AAC9C,OAAO;AACL,cAAc;AACd,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,WAAW;AAEX,sBAAsB;AACtB,wBAAwB,EACxB,gBAAgB;AAEhB,WAAW;AACX,gBAAgB;AAEhB,iBAAiB;AACjB,WAAW;AAEX,qBAAqB;AACrB,uBAAuB,EACvB,eAAe;AAEf,UAAU;AACV,eAAe;AAmDf,uBAAuB;AACvB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,UAAU,EACV,aAAa,GAQd,MAAM,gBAAgB,CAAC;AAExB,8BAA8B;AAC9B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EAGX,iBAAiB,IAAI,yBAAyB,GAM/C,MAAM,eAAe,CAAC;AAEvB,iBAAiB;AACjB,OAAO,EAKL,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,cAAc,EAEd,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,kBAAkB;AAClB,OAAO,EACL,aAAa,EACb,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,gBAAgB;AAChB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAExC,4CAA4C;AAC5C,qCAAqC;AACrC,cAAc,0BAA0B,CAAC;AAEzC,iDAAiD;AACjD,cAAc,sBAAsB,CAAC;AAErC,gDAAgD;AAChD,qEAAqE;AACrE,cAAc,gBAAgB,CAAC;AAE/B,oCAAoC;AACpC,6EAA6E;AAC7E,cAAc,qBAAqB,CAAC;AAEpC,2BAA2B;AAC3B,qDAAqD;AACrD,OAAO,EACL,QAAQ,EACR,cAAc,EACd,cAAc,GAEf,MAAM,iBAAiB,CAAC;AAEzB,gCAAgC;AAChC,mEAAmE;AACnE,OAAO,EAQL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAEvB,uCAAuC;AACvC,gEAAgE;AAChE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,8BAA8B;AAC9B,4CAA4C;AAC5C,OAAO,EACL,OAAO,EACP,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,oCAAoC;AACpC,+CAA+C;AAC/C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,cAAc,GAGf,MAAM,gBAAgB,CAAC;AAExB,kCAAkC;AAClC,oDAAoD;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,yBAAyB;AACzB,uCAAuC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,4BAA4B;AAC5B,2DAA2D;AAC3D,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,yBAAyB;AACzB,oDAAoD;AACpD,OAAO,EACL,WAAW,EACX,eAAe,EAGf,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,cAAc,EACd,OAAO,EACP,KAAK,EACL,OAAO,EACP,UAAU,EACV,SAAS,EACT,cAAc,EACd,OAAO,EACP,SAAS,EACT,KAAK,EACL,QAAQ,EACR,eAAe,EACf,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,8BAA8B;AAC9B,6DAA6D;AAC7D,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,kCAAkC;AAClC,4DAA4D;AAC5D,OAAO;AACL,kEAAkE;AAClE,KAAK,EAAG,uBAAuB;AAC/B,GAAG,EAAK,qBAAqB;AAC7B,GAAG,EAAK,qBAAqB;AAC7B,8DAA8D;AAC9D,aAAa,EACb,WAAW,EACX,WAAW;AAEX,2DAA2D;AAC3D,UAAU,GAIX,MAAM,wBAAwB,CAAC;AAEhC,sCAAsC;AACtC,gEAAgE;AAChE,OAAO;AACL,OAAO;AACP,YAAY,EACZ,cAAc;AAEd,mCAAmC;AACnC,KAAK,EAkBL,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB;AAGvB,eAAe;AACf,KAAK,EAIL,KAAK;AAIL,gBAAgB;AAChB,KAAK,EAKL,KAAK,EAIL,QAAQ;AAOR,cAAc;AACd,IAAI,GAIL,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portel/photon-core",
-  "version": "2.5.4",
+  "version": "2.6.0",
   "description": "Core library for parsing, loading, and managing .photon.ts files - runtime-agnostic foundation for building custom Photon runtimes",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/collections/Collection.ts

@@ -0,0 +1,356 @@
+/**
+ * Collection<T> — Rich queryable collection with Laravel-style chaining
+ *
+ * Extends ReactiveArray<T> so mutations auto-emit events. Query methods return
+ * new immutable Collection instances (no emitter wired) that can be further
+ * chained or serialized.
+ *
+ * @example
+ * ```typescript
+ * import { PhotonMCP, Collection } from '@portel/photon-core';
+ *
+ * export default class ProductCatalog extends PhotonMCP {
+ *   products = new Collection<Product>();
+ *
+ *   async catalog() {
+ *     return this.products.where('stock', '>', 0).sortBy('price');
+ *   }
+ *
+ *   async dashboard() {
+ *     return this.products.where('category', 'Electronics').as('cards');
+ *   }
+ * }
+ * ```
+ */
+
+import { ReactiveArray, type Emitter } from './ReactiveArray.js';
+
+/** Comparison operators for where() clauses */
+export type CompareOp = '=' | '!=' | '>' | '<' | '>=' | '<=' | '===';
+
+/** Rendering format hints for auto-UI */
+export type RenderFormat = 'table' | 'cards' | 'list' | 'chart' | 'grid' | 'chips';
+
+/** Rendering hint attached via .as() */
+export interface RenderHint {
+  format: RenderFormat;
+  options?: Record<string, unknown>;
+}
+
+// No-op emitter for query result collections (immutable — no events)
+const NOOP_EMITTER: Emitter = () => {};
+
+export class Collection<T> extends ReactiveArray<T> {
+  /** Rendering hint set by .as() */
+  _renderHint: RenderHint | null = null;
+
+  /**
+   * Create a new Collection with optional initial items.
+   * Items are loaded without triggering events.
+   */
+  constructor(items?: T[]) {
+    super();
+    if (items && items.length > 0) {
+      globalThis.Array.prototype.push.apply(this, items);
+    }
+  }
+
+  /**
+   * Create a Collection bound to a property name and emitter (for runtime wiring).
+   */
+  static override create<T>(
+    propertyName: string,
+    emitter: Emitter,
+    initialItems?: T[]
+  ): Collection<T> {
+    const col = new Collection<T>(initialItems);
+    (col as any)._propertyName = propertyName;
+    (col as any)._emitter = emitter;
+    return col;
+  }
+
+  /**
+   * Create a Collection from an existing array.
+   */
+  static from<T>(items: T[]): Collection<T> {
+    return new Collection<T>(items);
+  }
+
+  // ─── Helper: create an immutable query-result Collection ───
+
+  private _result<U>(items: U[]): Collection<U> {
+    const col = new Collection<U>(items);
+    (col as any)._emitter = NOOP_EMITTER;
+    return col;
+  }
+
+  // ─── Query Methods (immutable — return new Collection) ───
+
+  /**
+   * Filter items by field comparison.
+   *
+   * Shorthand: `where('status', 'active')` → equality check
+   * Full:      `where('price', '>', 100)` → comparison
+   */
+  where(key: keyof T & string, opOrVal: CompareOp | T[keyof T], val?: T[keyof T]): Collection<T> {
+    let op: CompareOp;
+    let compareVal: unknown;
+
+    if (val === undefined) {
+      // Shorthand: where('status', 'active') → equality
+      op = '=';
+      compareVal = opOrVal;
+    } else {
+      op = opOrVal as CompareOp;
+      compareVal = val;
+    }
+
+    return this._result(
+      globalThis.Array.prototype.filter.call(this, (item: T) => {
+        const fieldVal = (item as Record<string, unknown>)[key];
+        switch (op) {
+          case '=': return fieldVal == compareVal;
+          case '===': return fieldVal === compareVal;
+          case '!=': return fieldVal != compareVal;
+          case '>': return (fieldVal as number) > (compareVal as number);
+          case '<': return (fieldVal as number) < (compareVal as number);
+          case '>=': return (fieldVal as number) >= (compareVal as number);
+          case '<=': return (fieldVal as number) <= (compareVal as number);
+          default: return false;
+        }
+      }) as T[]
+    );
+  }
+
+  /**
+   * Filter items with a predicate function.
+   */
+  query(fn: (item: T) => boolean): Collection<T> {
+    return this._result(
+      globalThis.Array.prototype.filter.call(this, fn) as T[]
+    );
+  }
+
+  /**
+   * Transform each item.
+   */
+  collect<U>(fn: (item: T) => U): Collection<U> {
+    return this._result(
+      globalThis.Array.prototype.map.call(this, fn) as U[]
+    );
+  }
+
+  /**
+   * Extract a single field from each item.
+   */
+  pluck<K extends keyof T>(key: K): Collection<T[K]> {
+    return this._result(
+      globalThis.Array.prototype.map.call(this, (item: T) => item[key]) as T[K][]
+    );
+  }
+
+  /**
+   * Sort by a key or comparator function.
+   * Returns a new sorted Collection (does NOT mutate).
+   */
+  sortBy(keyOrFn: keyof T & string | ((a: T, b: T) => number), direction: 'asc' | 'desc' = 'asc'): Collection<T> {
+    const items = globalThis.Array.from(this) as T[];
+    if (typeof keyOrFn === 'function') {
+      items.sort(keyOrFn);
+    } else {
+      const key = keyOrFn;
+      items.sort((a, b) => {
+        const aVal = (a as Record<string, unknown>)[key] as number;
+        const bVal = (b as Record<string, unknown>)[key] as number;
+        if (aVal < bVal) return direction === 'asc' ? -1 : 1;
+        if (aVal > bVal) return direction === 'asc' ? 1 : -1;
+        return 0;
+      });
+    }
+    return this._result(items);
+  }
+
+  /**
+   * Group items by a key or function.
+   * Returns a record of group-name → Collection.
+   */
+  groupBy(keyOrFn: keyof T & string | ((item: T) => string)): Record<string, Collection<T>> {
+    const groups: Record<string, T[]> = {};
+    for (let i = 0; i < this.length; i++) {
+      const item = this[i];
+      const groupKey = typeof keyOrFn === 'function'
+        ? keyOrFn(item)
+        : String((item as Record<string, unknown>)[keyOrFn]);
+      if (!groups[groupKey]) groups[groupKey] = [];
+      groups[groupKey].push(item);
+    }
+    const result: Record<string, Collection<T>> = {};
+    for (const [k, v] of Object.entries(groups)) {
+      result[k] = this._result(v);
+    }
+    return result;
+  }
+
+  /**
+   * Remove duplicates, optionally by a key.
+   */
+  unique(key?: keyof T & string): Collection<T> {
+    const seen = new globalThis.Set<unknown>();
+    const items: T[] = [];
+    for (let i = 0; i < this.length; i++) {
+      const item = this[i];
+      const val = key ? (item as Record<string, unknown>)[key] : item;
+      if (!seen.has(val)) {
+        seen.add(val);
+        items.push(item);
+      }
+    }
+    return this._result(items);
+  }
+
+  /**
+   * Take the first n items.
+   */
+  take(n: number): Collection<T> {
+    return this._result(globalThis.Array.prototype.slice.call(this, 0, n) as T[]);
+  }
+
+  /**
+   * Skip the first n items.
+   */
+  skip(n: number): Collection<T> {
+    return this._result(globalThis.Array.prototype.slice.call(this, n) as T[]);
+  }
+
+  // ─── Terminal Methods ───
+
+  /**
+   * Get the first item, optionally matching a predicate.
+   */
+  first(fn?: (item: T) => boolean): T | undefined {
+    if (!fn) return this[0];
+    for (let i = 0; i < this.length; i++) {
+      if (fn(this[i])) return this[i];
+    }
+    return undefined;
+  }
+
+  /**
+   * Get the last item, optionally matching a predicate.
+   */
+  last(fn?: (item: T) => boolean): T | undefined {
+    if (!fn) return this[this.length - 1];
+    for (let i = this.length - 1; i >= 0; i--) {
+      if (fn(this[i])) return this[i];
+    }
+    return undefined;
+  }
+
+  /**
+   * Count items.
+   */
+  count(): number {
+    return this.length;
+  }
+
+  /**
+   * Check if collection is empty.
+   */
+  isEmpty(): boolean {
+    return this.length === 0;
+  }
+
+  /**
+   * Sum numeric values, optionally by key.
+   */
+  sum(key?: keyof T & string): number {
+    let total = 0;
+    for (let i = 0; i < this.length; i++) {
+      const val = key ? (this[i] as Record<string, unknown>)[key] : this[i];
+      total += Number(val) || 0;
+    }
+    return total;
+  }
+
+  /**
+   * Average of numeric values, optionally by key.
+   */
+  avg(key?: keyof T & string): number {
+    if (this.length === 0) return 0;
+    return this.sum(key) / this.length;
+  }
+
+  /**
+   * Item with minimum value (by key or raw comparison).
+   */
+  min(key?: keyof T & string): T | undefined {
+    if (this.length === 0) return undefined;
+    let minItem = this[0];
+    let minVal = key ? (minItem as Record<string, unknown>)[key] : minItem;
+    for (let i = 1; i < this.length; i++) {
+      const val = key ? (this[i] as Record<string, unknown>)[key] : this[i];
+      if ((val as number) < (minVal as number)) {
+        minItem = this[i];
+        minVal = val;
+      }
+    }
+    return minItem;
+  }
+
+  /**
+   * Item with maximum value (by key or raw comparison).
+   */
+  max(key?: keyof T & string): T | undefined {
+    if (this.length === 0) return undefined;
+    let maxItem = this[0];
+    let maxVal = key ? (maxItem as Record<string, unknown>)[key] : maxItem;
+    for (let i = 1; i < this.length; i++) {
+      const val = key ? (this[i] as Record<string, unknown>)[key] : this[i];
+      if ((val as number) > (maxVal as number)) {
+        maxItem = this[i];
+        maxVal = val;
+      }
+    }
+    return maxItem;
+  }
+
+  /**
+   * Reduce the collection to a single value.
+   */
+  aggregate<U>(fn: (acc: U, item: T) => U, initial: U): U {
+    let acc = initial;
+    for (let i = 0; i < this.length; i++) {
+      acc = fn(acc, this[i]);
+    }
+    return acc;
+  }
+
+  // ─── Rendering Hints ───
+
+  /**
+   * Attach a rendering hint for auto-UI.
+   * Returns `this` for chaining at the end of a query.
+   */
+  as(format: RenderFormat, options?: Record<string, unknown>): this {
+    this._renderHint = { format, options };
+    return this;
+  }
+
+  /**
+   * Custom serialization.
+   * - Without `.as()`: plain array (backward compatible)
+   * - With `.as()`: metadata object with `_photonType`, items, and count
+   */
+  toJSON(): T[] | { _photonType: string; items: T[]; count: number; renderOptions?: Record<string, unknown> } {
+    const items = globalThis.Array.from(this) as T[];
+    if (!this._renderHint) {
+      return items;
+    }
+    return {
+      _photonType: `collection:${this._renderHint.format}`,
+      items,
+      count: items.length,
+      ...(this._renderHint.options ? { renderOptions: this._renderHint.options } : {}),
+    };
+  }
+}

package/src/collections/index.ts

@@ -52,6 +52,7 @@
 export { ReactiveArray, type Emitter } from './ReactiveArray.js';
 export { ReactiveMap } from './ReactiveMap.js';
 export { ReactiveSet } from './ReactiveSet.js';
+export { Collection, type RenderHint, type RenderFormat, type CompareOp } from './Collection.js';
 
 // Level 1 exports: Shadow global types for zero-effort reactivity
 // Just `import { Array } from '@portel/photon-core'` and use normally

package/src/index.ts

@@ -453,6 +453,11 @@ export {
   ReactiveMap,
   ReactiveSet,
   type Emitter,
+  // Level 2+: Rich queryable collection with rendering hints
+  Collection,
+  type RenderHint,
+  type RenderFormat,
+  type CompareOp,
 } from './collections/index.js';
 
 // ===== PURPOSE-DRIVEN UI TYPES =====