@sharpee/queries 0.9.109

package/augmentation.d.ts

@@ -0,0 +1,46 @@
+/**
+ * IWorldModel augmentation — adds EntityQuery entry points via declaration merging.
+ *
+ * Importing this module patches WorldModel.prototype with getter properties
+ * and methods that return EntityQuery instances. This activates the fluent
+ * query API on any WorldModel instance (including through IWorldModel references).
+ *
+ * Entry points: entities, rooms, actors, objects, scenes, regions,
+ * contents(), allContents(), having(), visible(), inScope()
+ *
+ * Owner context: @sharpee/queries (ADR-150)
+ */
+import { TraitType } from "../world-model/index";
+import type { ContentsOptions } from "../if-domain/index";
+import { EntityQuery } from './entity-query';
+/** Query entry points added by @sharpee/queries. */
+interface QueryEntryPoints {
+    /** Query all entities in the world. */
+    readonly all: EntityQuery;
+    /** Query all rooms. */
+    readonly rooms: EntityQuery;
+    /** Query all actors. */
+    readonly actors: EntityQuery;
+    /** Query all objects (items, containers, supporters, scenery). */
+    readonly objects: EntityQuery;
+    /** Query all scenes (ADR-149). Returns empty query if no scenes exist. */
+    readonly scenes: EntityQuery;
+    /** Query all regions (ADR-149). Returns empty query if no regions exist. */
+    readonly regions: EntityQuery;
+    /** Query contents of a specific container/room. */
+    contents(parentId: string, options?: ContentsOptions): EntityQuery;
+    /** Query all contents recursively. */
+    allContents(parentId: string, options?: ContentsOptions): EntityQuery;
+    /** Query entities with a specific trait. */
+    having(traitType: TraitType | string): EntityQuery;
+    /** Query entities visible to an observer. */
+    visible(observerId: string): EntityQuery;
+    /** Query entities in interaction scope for an observer. */
+    inScope(observerId: string): EntityQuery;
+}
+declare module '@sharpee/world-model' {
+    interface WorldModel extends QueryEntryPoints {
+    }
+}
+export { EntityQuery } from './entity-query';
+//# sourceMappingURL=augmentation.d.ts.map

package/augmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augmentation.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/queries/src/augmentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAiD,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA0B7C,oDAAoD;AACpD,UAAU,gBAAgB;IACxB,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAE1B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAE9B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAE9B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,WAAW,CAAC;IAEnE,sCAAsC;IACtC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,WAAW,CAAC;IAEtE,4CAA4C;IAC5C,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IAEnD,6CAA6C;IAC7C,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;IAEzC,2DAA2D;IAC3D,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;CAC1C;AAED,OAAO,QAAQ,sBAAsB,CAAC;IAMpC,UAAU,UAAW,SAAQ,gBAAgB;KAAG;CACjD;AAuFD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/augmentation.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * IWorldModel augmentation — adds EntityQuery entry points via declaration merging.
+ *
+ * Importing this module patches WorldModel.prototype with getter properties
+ * and methods that return EntityQuery instances. This activates the fluent
+ * query API on any WorldModel instance (including through IWorldModel references).
+ *
+ * Entry points: entities, rooms, actors, objects, scenes, regions,
+ * contents(), allContents(), having(), visible(), inScope()
+ *
+ * Owner context: @sharpee/queries (ADR-150)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityQuery = void 0;
+const world_model_1 = require("../world-model/index.js");
+const entity_query_1 = require("./entity-query");
+// ---------------------------------------------------------------------------
+// ADR-149 forward declarations
+// ---------------------------------------------------------------------------
+/**
+ * Forward-declared entity type constants for Region and Scene.
+ * These match the values ADR-149 will register. Until ADR-149 is
+ * implemented, no entities of these types exist, so the corresponding
+ * entry points return empty queries.
+ */
+const ENTITY_TYPE_REGION = 'region';
+const ENTITY_TYPE_SCENE = 'scene';
+// ---------------------------------------------------------------------------
+// Prototype patches
+// ---------------------------------------------------------------------------
+const proto = world_model_1.WorldModel.prototype;
+// ── Readonly getters ─────────────────────────────────────────────────────
+Object.defineProperty(proto, 'all', {
+    get() {
+        return new entity_query_1.EntityQuery(this.getAllEntities());
+    },
+    enumerable: true,
+    configurable: true,
+});
+Object.defineProperty(proto, 'rooms', {
+    get() {
+        return new entity_query_1.EntityQuery(this.findByType(world_model_1.EntityType.ROOM));
+    },
+    enumerable: true,
+    configurable: true,
+});
+Object.defineProperty(proto, 'actors', {
+    get() {
+        return new entity_query_1.EntityQuery(this.findByType(world_model_1.EntityType.ACTOR));
+    },
+    enumerable: true,
+    configurable: true,
+});
+Object.defineProperty(proto, 'objects', {
+    get() {
+        // Objects = everything that isn't a room or actor
+        return new entity_query_1.EntityQuery(this.getAllEntities().filter((e) => e.type !== world_model_1.EntityType.ROOM
+            && e.type !== world_model_1.EntityType.ACTOR
+            && e.type !== ENTITY_TYPE_REGION
+            && e.type !== ENTITY_TYPE_SCENE));
+    },
+    enumerable: true,
+    configurable: true,
+});
+Object.defineProperty(proto, 'scenes', {
+    get() {
+        return new entity_query_1.EntityQuery(this.findByType(ENTITY_TYPE_SCENE));
+    },
+    enumerable: true,
+    configurable: true,
+});
+Object.defineProperty(proto, 'regions', {
+    get() {
+        return new entity_query_1.EntityQuery(this.findByType(ENTITY_TYPE_REGION));
+    },
+    enumerable: true,
+    configurable: true,
+});
+// ── Methods ──────────────────────────────────────────────────────────────
+proto.contents = function (parentId, options) {
+    return new entity_query_1.EntityQuery(this.getContents(parentId, options));
+};
+proto.allContents = function (parentId, options) {
+    return new entity_query_1.EntityQuery(this.getAllContents(parentId, options));
+};
+proto.having = function (traitType) {
+    return new entity_query_1.EntityQuery(this.findByTrait(traitType));
+};
+proto.visible = function (observerId) {
+    return new entity_query_1.EntityQuery(this.getVisible(observerId));
+};
+proto.inScope = function (observerId) {
+    return new entity_query_1.EntityQuery(this.getInScope(observerId));
+};
+// Re-export EntityQuery so consumers get it from the augmentation import
+var entity_query_2 = require("./entity-query");
+Object.defineProperty(exports, "EntityQuery", { enumerable: true, get: function () { return entity_query_2.EntityQuery; } });
+//# sourceMappingURL=augmentation.js.map

package/augmentation.js.map

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

package/entity-query.d.ts

@@ -0,0 +1,239 @@
+/**
+ * EntityQuery — Fluent, chainable query wrapper for IFEntity collections.
+ *
+ * Lightweight, immutable wrapper over IFEntity[] providing LINQ-style
+ * filtering, retrieval, aggregation, transformation, ordering, set
+ * operations, partitioning, grouping, and materialization methods.
+ * Each filtering method returns a new EntityQuery; the source is never mutated.
+ *
+ * Public interface: all chainable query methods.
+ * Owner context: @sharpee/queries (ADR-150)
+ */
+import { IFEntity } from "../world-model/index";
+import { TraitType } from "../world-model/index";
+/**
+ * Fluent query wrapper for entity collections.
+ * Implements Iterable so it works with for-of loops and spread.
+ */
+export declare class EntityQuery implements Iterable<IFEntity> {
+    private readonly items;
+    constructor(items: IFEntity[]);
+    /**
+     * Filter entities by predicate.
+     *
+     * @param predicate - Test function applied to each entity
+     * @returns New EntityQuery containing only entities where predicate returns true
+     */
+    where(predicate: (entity: IFEntity) => boolean): EntityQuery;
+    /**
+     * Filter to entities that have a specific trait.
+     *
+     * @param traitType - The trait type to check for
+     * @returns New EntityQuery containing only entities with the trait
+     */
+    withTrait(traitType: TraitType | string): EntityQuery;
+    /**
+     * Filter to entities that do NOT have a specific trait.
+     *
+     * @param traitType - The trait type to exclude
+     * @returns New EntityQuery containing only entities without the trait
+     */
+    withoutTrait(traitType: TraitType | string): EntityQuery;
+    /**
+     * Filter to entities of a specific EntityType.
+     *
+     * @param entityType - The entity type string (e.g., 'room', 'object')
+     * @returns New EntityQuery containing only entities of that type
+     */
+    ofType(entityType: string): EntityQuery;
+    /**
+     * Filter to entities whose IdentityTrait.name matches exactly (case-sensitive).
+     * Entities without an IdentityTrait are silently excluded.
+     *
+     * @param name - The exact name to match
+     * @returns New EntityQuery containing only matching entities
+     */
+    named(name: string): EntityQuery;
+    /**
+     * Filter to entities whose name or aliases contain the term (case-insensitive).
+     * Entities without an IdentityTrait are silently excluded.
+     *
+     * @param term - The search term (case-insensitive substring match)
+     * @returns New EntityQuery containing matching entities
+     */
+    matching(term: string): EntityQuery;
+    /**
+     * Filter to entities that are portable (no SceneryTrait).
+     *
+     * @returns New EntityQuery containing only non-scenery entities
+     */
+    portable(): EntityQuery;
+    /**
+     * Filter to entities visible to an observer.
+     * Delegates to the world model's visibility calculation.
+     *
+     * @param observerId - The observer entity ID
+     * @param world - The world model (needed for visibility calculation)
+     * @returns New EntityQuery containing only visible entities
+     */
+    visibleTo(observerId: string, world: {
+        getVisible(id: string): IFEntity[];
+    }): EntityQuery;
+    /**
+     * Filter rooms to those in a region (traverses parent hierarchy).
+     * Returns empty query until ADR-149 provides RegionTrait.
+     *
+     * @param regionId - The region entity ID
+     * @param world - The world model (needed for region traversal)
+     * @returns New EntityQuery containing rooms in the region
+     */
+    inRegion(regionId: string, world: {
+        isInRegion?(entityId: string, regionId: string): boolean;
+    }): EntityQuery;
+    /**
+     * Filter to entities located in rooms belonging to a region.
+     * Returns empty query until ADR-149 provides RegionTrait.
+     *
+     * @param regionId - The region entity ID
+     * @param world - The world model (needed for region and location lookup)
+     * @returns New EntityQuery containing entities within the region
+     */
+    withinRegion(regionId: string, world: {
+        isInRegion?(entityId: string, regionId: string): boolean;
+        getLocation(entityId: string): string | null;
+    }): EntityQuery;
+    /**
+     * Return the first entity, or undefined if empty.
+     */
+    first(): IFEntity | undefined;
+    /**
+     * Return the first entity, or throw if empty.
+     *
+     * @param message - Optional error message
+     * @throws Error if the query is empty
+     */
+    firstOrThrow(message?: string): IFEntity;
+    /**
+     * Return exactly one entity. Throws if zero or more than one.
+     *
+     * @throws Error if count is not exactly 1
+     */
+    single(): IFEntity;
+    /**
+     * Return the last entity, or undefined if empty.
+     */
+    last(): IFEntity | undefined;
+    /**
+     * Return entity at index, or undefined if out of bounds.
+     *
+     * @param index - Zero-based index
+     */
+    at(index: number): IFEntity | undefined;
+    /**
+     * True if any entity matches the optional predicate.
+     * If no predicate, true if the query is non-empty.
+     */
+    any(predicate?: (entity: IFEntity) => boolean): boolean;
+    /**
+     * True if all entities match the predicate.
+     * Returns true for empty collections (vacuous truth).
+     */
+    all(predicate: (entity: IFEntity) => boolean): boolean;
+    /**
+     * True if no entities match the optional predicate.
+     * If no predicate, true if the query is empty.
+     */
+    none(predicate?: (entity: IFEntity) => boolean): boolean;
+    /**
+     * Count of entities, optionally matching a predicate.
+     */
+    count(predicate?: (entity: IFEntity) => boolean): number;
+    /**
+     * Project entities to a new form.
+     *
+     * @param selector - Transform function applied to each entity
+     * @returns Array of transformed values
+     */
+    select<T>(selector: (entity: IFEntity) => T): T[];
+    /**
+     * Project and flatten.
+     *
+     * @param selector - Transform function returning an array per entity
+     * @returns Flattened array of all results
+     */
+    selectMany<T>(selector: (entity: IFEntity) => T[]): T[];
+    /**
+     * Extract a specific trait from all entities (undefined for those lacking it).
+     *
+     * @param traitType - The trait type to extract
+     * @returns Array of trait instances or undefined
+     */
+    traits<T>(traitType: TraitType | string): (T | undefined)[];
+    /**
+     * Extract a specific trait, filtering out entities that lack it.
+     *
+     * @param traitType - The trait type to extract
+     * @returns Array of trait instances (no undefined values)
+     */
+    traitsOf<T>(traitType: TraitType | string): T[];
+    /**
+     * Sort entities by a key function.
+     *
+     * @param keyFn - Function that extracts the sort key
+     * @param direction - 'asc' (default) or 'desc'
+     * @returns New EntityQuery in sorted order
+     */
+    orderBy<K>(keyFn: (entity: IFEntity) => K, direction?: 'asc' | 'desc'): EntityQuery;
+    /**
+     * Combine with another query (union, no duplicates by entity ID).
+     */
+    union(other: EntityQuery): EntityQuery;
+    /**
+     * Entities present in both queries (by entity ID).
+     */
+    intersect(other: EntityQuery): EntityQuery;
+    /**
+     * Entities in this query but not in the other (by entity ID).
+     */
+    except(other: EntityQuery): EntityQuery;
+    /**
+     * Remove duplicate entities (by entity ID).
+     */
+    distinct(): EntityQuery;
+    /**
+     * Skip the first N entities.
+     */
+    skip(count: number): EntityQuery;
+    /**
+     * Take at most N entities.
+     */
+    take(count: number): EntityQuery;
+    /**
+     * Group entities by a key function. Returns a Map of key → EntityQuery.
+     *
+     * @param keyFn - Function that extracts the group key
+     * @returns Map from group key to EntityQuery of members
+     */
+    groupBy<K>(keyFn: (entity: IFEntity) => K): Map<K, EntityQuery>;
+    /**
+     * Return as a plain array.
+     */
+    toArray(): IFEntity[];
+    /**
+     * Return as a Map keyed by entity ID.
+     */
+    toMap(): Map<string, IFEntity>;
+    /**
+     * Return as a Set of entity IDs.
+     */
+    toIdSet(): Set<string>;
+    /**
+     * Execute a side effect for each entity. Returns this for chaining.
+     */
+    forEach(fn: (entity: IFEntity) => void): EntityQuery;
+    /**
+     * Iterable protocol — works with for-of loops and spread.
+     */
+    [Symbol.iterator](): Iterator<IFEntity>;
+}
+//# sourceMappingURL=entity-query.d.ts.map

package/entity-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-query.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/queries/src/entity-query.ts"],"names":[],"mappings":"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"}

package/entity-query.js

@@ -0,0 +1,414 @@
+"use strict";
+/**
+ * EntityQuery — Fluent, chainable query wrapper for IFEntity collections.
+ *
+ * Lightweight, immutable wrapper over IFEntity[] providing LINQ-style
+ * filtering, retrieval, aggregation, transformation, ordering, set
+ * operations, partitioning, grouping, and materialization methods.
+ * Each filtering method returns a new EntityQuery; the source is never mutated.
+ *
+ * Public interface: all chainable query methods.
+ * Owner context: @sharpee/queries (ADR-150)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityQuery = void 0;
+/**
+ * Fluent query wrapper for entity collections.
+ * Implements Iterable so it works with for-of loops and spread.
+ */
+class EntityQuery {
+    items;
+    constructor(items) {
+        this.items = items;
+    }
+    // ── Filtering ──────────────────────────────────────────────────────────
+    /**
+     * Filter entities by predicate.
+     *
+     * @param predicate - Test function applied to each entity
+     * @returns New EntityQuery containing only entities where predicate returns true
+     */
+    where(predicate) {
+        return new EntityQuery(this.items.filter(predicate));
+    }
+    /**
+     * Filter to entities that have a specific trait.
+     *
+     * @param traitType - The trait type to check for
+     * @returns New EntityQuery containing only entities with the trait
+     */
+    withTrait(traitType) {
+        return new EntityQuery(this.items.filter(e => e.has(traitType)));
+    }
+    /**
+     * Filter to entities that do NOT have a specific trait.
+     *
+     * @param traitType - The trait type to exclude
+     * @returns New EntityQuery containing only entities without the trait
+     */
+    withoutTrait(traitType) {
+        return new EntityQuery(this.items.filter(e => !e.has(traitType)));
+    }
+    /**
+     * Filter to entities of a specific EntityType.
+     *
+     * @param entityType - The entity type string (e.g., 'room', 'object')
+     * @returns New EntityQuery containing only entities of that type
+     */
+    ofType(entityType) {
+        return new EntityQuery(this.items.filter(e => e.type === entityType));
+    }
+    /**
+     * Filter to entities whose IdentityTrait.name matches exactly (case-sensitive).
+     * Entities without an IdentityTrait are silently excluded.
+     *
+     * @param name - The exact name to match
+     * @returns New EntityQuery containing only matching entities
+     */
+    named(name) {
+        return new EntityQuery(this.items.filter(e => {
+            const identity = e.get('identity');
+            return identity && identity.name === name;
+        }));
+    }
+    /**
+     * Filter to entities whose name or aliases contain the term (case-insensitive).
+     * Entities without an IdentityTrait are silently excluded.
+     *
+     * @param term - The search term (case-insensitive substring match)
+     * @returns New EntityQuery containing matching entities
+     */
+    matching(term) {
+        const lower = term.toLowerCase();
+        return new EntityQuery(this.items.filter(e => {
+            const identity = e.get('identity');
+            if (!identity)
+                return false;
+            if (identity.name && identity.name.toLowerCase().includes(lower))
+                return true;
+            if (identity.aliases) {
+                return identity.aliases.some(a => a.toLowerCase().includes(lower));
+            }
+            return false;
+        }));
+    }
+    /**
+     * Filter to entities that are portable (no SceneryTrait).
+     *
+     * @returns New EntityQuery containing only non-scenery entities
+     */
+    portable() {
+        return new EntityQuery(this.items.filter(e => !e.has('scenery')));
+    }
+    /**
+     * Filter to entities visible to an observer.
+     * Delegates to the world model's visibility calculation.
+     *
+     * @param observerId - The observer entity ID
+     * @param world - The world model (needed for visibility calculation)
+     * @returns New EntityQuery containing only visible entities
+     */
+    visibleTo(observerId, world) {
+        const visibleIds = new Set(world.getVisible(observerId).map(e => e.id));
+        return new EntityQuery(this.items.filter(e => visibleIds.has(e.id)));
+    }
+    // ── Spatial/Temporal Filters (ADR-149 forward) ─────────────────────────
+    /**
+     * Filter rooms to those in a region (traverses parent hierarchy).
+     * Returns empty query until ADR-149 provides RegionTrait.
+     *
+     * @param regionId - The region entity ID
+     * @param world - The world model (needed for region traversal)
+     * @returns New EntityQuery containing rooms in the region
+     */
+    inRegion(regionId, world) {
+        if (!world.isInRegion)
+            return new EntityQuery([]);
+        return new EntityQuery(this.items.filter(e => world.isInRegion(e.id, regionId)));
+    }
+    /**
+     * Filter to entities located in rooms belonging to a region.
+     * Returns empty query until ADR-149 provides RegionTrait.
+     *
+     * @param regionId - The region entity ID
+     * @param world - The world model (needed for region and location lookup)
+     * @returns New EntityQuery containing entities within the region
+     */
+    withinRegion(regionId, world) {
+        if (!world.isInRegion)
+            return new EntityQuery([]);
+        return new EntityQuery(this.items.filter(e => {
+            const loc = world.getLocation(e.id);
+            return loc !== null && world.isInRegion(loc, regionId);
+        }));
+    }
+    // ── Retrieval ──────────────────────────────────────────────────────────
+    /**
+     * Return the first entity, or undefined if empty.
+     */
+    first() {
+        return this.items[0];
+    }
+    /**
+     * Return the first entity, or throw if empty.
+     *
+     * @param message - Optional error message
+     * @throws Error if the query is empty
+     */
+    firstOrThrow(message) {
+        if (this.items.length === 0) {
+            throw new Error(message ?? 'Expected at least one entity, found none');
+        }
+        return this.items[0];
+    }
+    /**
+     * Return exactly one entity. Throws if zero or more than one.
+     *
+     * @throws Error if count is not exactly 1
+     */
+    single() {
+        if (this.items.length === 0) {
+            throw new Error('Expected exactly one entity, found none');
+        }
+        if (this.items.length > 1) {
+            throw new Error(`Expected exactly one entity, found ${this.items.length}`);
+        }
+        return this.items[0];
+    }
+    /**
+     * Return the last entity, or undefined if empty.
+     */
+    last() {
+        return this.items[this.items.length - 1];
+    }
+    /**
+     * Return entity at index, or undefined if out of bounds.
+     *
+     * @param index - Zero-based index
+     */
+    at(index) {
+        return this.items[index];
+    }
+    // ── Aggregation ────────────────────────────────────────────────────────
+    /**
+     * True if any entity matches the optional predicate.
+     * If no predicate, true if the query is non-empty.
+     */
+    any(predicate) {
+        if (!predicate)
+            return this.items.length > 0;
+        return this.items.some(predicate);
+    }
+    /**
+     * True if all entities match the predicate.
+     * Returns true for empty collections (vacuous truth).
+     */
+    all(predicate) {
+        return this.items.every(predicate);
+    }
+    /**
+     * True if no entities match the optional predicate.
+     * If no predicate, true if the query is empty.
+     */
+    none(predicate) {
+        if (!predicate)
+            return this.items.length === 0;
+        return !this.items.some(predicate);
+    }
+    /**
+     * Count of entities, optionally matching a predicate.
+     */
+    count(predicate) {
+        if (!predicate)
+            return this.items.length;
+        return this.items.filter(predicate).length;
+    }
+    // ── Transformation ─────────────────────────────────────────────────────
+    /**
+     * Project entities to a new form.
+     *
+     * @param selector - Transform function applied to each entity
+     * @returns Array of transformed values
+     */
+    select(selector) {
+        return this.items.map(selector);
+    }
+    /**
+     * Project and flatten.
+     *
+     * @param selector - Transform function returning an array per entity
+     * @returns Flattened array of all results
+     */
+    selectMany(selector) {
+        const result = [];
+        for (const item of this.items) {
+            result.push(...selector(item));
+        }
+        return result;
+    }
+    /**
+     * Extract a specific trait from all entities (undefined for those lacking it).
+     *
+     * @param traitType - The trait type to extract
+     * @returns Array of trait instances or undefined
+     */
+    traits(traitType) {
+        return this.items.map(e => e.get(traitType));
+    }
+    /**
+     * Extract a specific trait, filtering out entities that lack it.
+     *
+     * @param traitType - The trait type to extract
+     * @returns Array of trait instances (no undefined values)
+     */
+    traitsOf(traitType) {
+        const result = [];
+        for (const item of this.items) {
+            const trait = item.get(traitType);
+            if (trait !== undefined) {
+                result.push(trait);
+            }
+        }
+        return result;
+    }
+    // ── Ordering ───────────────────────────────────────────────────────────
+    /**
+     * Sort entities by a key function.
+     *
+     * @param keyFn - Function that extracts the sort key
+     * @param direction - 'asc' (default) or 'desc'
+     * @returns New EntityQuery in sorted order
+     */
+    orderBy(keyFn, direction = 'asc') {
+        const sorted = [...this.items].sort((a, b) => {
+            const ka = keyFn(a);
+            const kb = keyFn(b);
+            if (ka < kb)
+                return direction === 'asc' ? -1 : 1;
+            if (ka > kb)
+                return direction === 'asc' ? 1 : -1;
+            return 0;
+        });
+        return new EntityQuery(sorted);
+    }
+    // ── Set Operations ─────────────────────────────────────────────────────
+    /**
+     * Combine with another query (union, no duplicates by entity ID).
+     */
+    union(other) {
+        const seen = new Set(this.items.map(e => e.id));
+        const combined = [...this.items];
+        for (const item of other.items) {
+            if (!seen.has(item.id)) {
+                seen.add(item.id);
+                combined.push(item);
+            }
+        }
+        return new EntityQuery(combined);
+    }
+    /**
+     * Entities present in both queries (by entity ID).
+     */
+    intersect(other) {
+        const otherIds = new Set(other.items.map(e => e.id));
+        return new EntityQuery(this.items.filter(e => otherIds.has(e.id)));
+    }
+    /**
+     * Entities in this query but not in the other (by entity ID).
+     */
+    except(other) {
+        const otherIds = new Set(other.items.map(e => e.id));
+        return new EntityQuery(this.items.filter(e => !otherIds.has(e.id)));
+    }
+    /**
+     * Remove duplicate entities (by entity ID).
+     */
+    distinct() {
+        const seen = new Set();
+        const unique = [];
+        for (const item of this.items) {
+            if (!seen.has(item.id)) {
+                seen.add(item.id);
+                unique.push(item);
+            }
+        }
+        return new EntityQuery(unique);
+    }
+    // ── Partitioning ───────────────────────────────────────────────────────
+    /**
+     * Skip the first N entities.
+     */
+    skip(count) {
+        return new EntityQuery(this.items.slice(count));
+    }
+    /**
+     * Take at most N entities.
+     */
+    take(count) {
+        return new EntityQuery(this.items.slice(0, count));
+    }
+    // ── Grouping ───────────────────────────────────────────────────────────
+    /**
+     * Group entities by a key function. Returns a Map of key → EntityQuery.
+     *
+     * @param keyFn - Function that extracts the group key
+     * @returns Map from group key to EntityQuery of members
+     */
+    groupBy(keyFn) {
+        const groups = new Map();
+        for (const item of this.items) {
+            const key = keyFn(item);
+            const group = groups.get(key);
+            if (group) {
+                group.push(item);
+            }
+            else {
+                groups.set(key, [item]);
+            }
+        }
+        const result = new Map();
+        for (const [key, items] of groups) {
+            result.set(key, new EntityQuery(items));
+        }
+        return result;
+    }
+    // ── Materialization ────────────────────────────────────────────────────
+    /**
+     * Return as a plain array.
+     */
+    toArray() {
+        return [...this.items];
+    }
+    /**
+     * Return as a Map keyed by entity ID.
+     */
+    toMap() {
+        const map = new Map();
+        for (const item of this.items) {
+            map.set(item.id, item);
+        }
+        return map;
+    }
+    /**
+     * Return as a Set of entity IDs.
+     */
+    toIdSet() {
+        return new Set(this.items.map(e => e.id));
+    }
+    // ── Iteration ──────────────────────────────────────────────────────────
+    /**
+     * Execute a side effect for each entity. Returns this for chaining.
+     */
+    forEach(fn) {
+        this.items.forEach(fn);
+        return new EntityQuery(this.items);
+    }
+    /**
+     * Iterable protocol — works with for-of loops and spread.
+     */
+    [Symbol.iterator]() {
+        return this.items[Symbol.iterator]();
+    }
+}
+exports.EntityQuery = EntityQuery;
+//# sourceMappingURL=entity-query.js.map

package/entity-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-query.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/queries/src/entity-query.ts"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @sharpee/queries — Fluent entity query API (ADR-150).
+ *
+ * Provides EntityQuery, a LINQ-style chainable wrapper over IFEntity[].
+ * Importing this package activates the WorldModel augmentation, adding
+ * entry points like w.rooms, w.entities, w.contents(), etc.
+ *
+ * Public interface: EntityQuery, IWorldModel augmentation
+ * Owner context: @sharpee/queries
+ */
+export { EntityQuery } from './entity-query';
+import './augmentation';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/queries/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,gBAAgB,CAAC"}

package/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @sharpee/queries — Fluent entity query API (ADR-150).
+ *
+ * Provides EntityQuery, a LINQ-style chainable wrapper over IFEntity[].
+ * Importing this package activates the WorldModel augmentation, adding
+ * entry points like w.rooms, w.entities, w.contents(), etc.
+ *
+ * Public interface: EntityQuery, IWorldModel augmentation
+ * Owner context: @sharpee/queries
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityQuery = void 0;
+var entity_query_1 = require("./entity-query");
+Object.defineProperty(exports, "EntityQuery", { enumerable: true, get: function () { return entity_query_1.EntityQuery; } });
+// Side-effect import: patches WorldModel.prototype with query entry points
+require("./augmentation");
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/queries/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAEpB,2EAA2E;AAC3E,0BAAwB"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@sharpee/queries",
+  "version": "0.9.109",
+  "description": "LINQ-style fluent entity query API for Sharpee Interactive Fiction Platform",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "dependencies": {
+    "@sharpee/world-model": "^0.9.109",
+    "@sharpee/if-domain": "^0.9.109"
+  },
+  "keywords": [
+    "interactive-fiction",
+    "if",
+    "text-adventure",
+    "sharpee",
+    "queries",
+    "linq"
+  ],
+  "author": "Sharpee Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChicagoDave/sharpee.git",
+    "directory": "packages/queries"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}