@_linked/core 1.2.1 → 2.0.0-next.20260310082533

package/lib/esm/interfaces/IQuadStore.d.ts

@@ -10,7 +10,7 @@ import type { SelectResult, CreateResult, UpdateResult } from '../queries/Interm
  * (SPARQL endpoint, SQL database, in-memory store, etc.).
  *
  * Each method receives a canonical IR query object and returns the result.
- * The calling layer (LinkedStorage / QueryParser) threads the precise
+ * The calling layer (LinkedStorage via queryDispatch) threads the precise
  * DSL-level TypeScript result type back to the caller — the store only
  * needs to produce data that matches the structural result types.
  */

package/lib/esm/package.d.ts

@@ -1,4 +1,4 @@
 export declare const linkedShape: {
     <T extends typeof import("./shapes/Shape.js").Shape>(constructor: T): void;
     <T extends typeof import("./shapes/Shape.js").Shape>(config?: import("./utils/Package.js").ShapeConfig): (constructor: T) => void;
-}, linkedUtil: (constructor: any) => any, linkedOntology: (allFileExports: any, nameSpace: (term: string) => import("./utils/NodeReference.js").NodeReferenceValue, suggestedPrefixAndFileName: string, loadDataFunction?: () => Promise<any>, dataSource?: string | string[]) => void, registerPackageExport: (exportedObject: any) => void, registerPackageModule: (_module: any) => void, packageExports: any, getPackageShape: (name: string) => typeof import("./shapes/Shape.js").Shape;
+}, linkedUtil: (constructor: any) => any, linkedOntology: (allFileExports: any, nameSpace: (term: string) => import("./utils/NodeReference.js").NodeReferenceValue, suggestedPrefixAndFileName: string, loadDataFunction?: () => Promise<any>, dataSource?: string | string[]) => void, registerPackageExport: (exportedObject: any) => void, registerPackageModule: (_module: any) => void, packageExports: any, getPackageShape: (name: string) => import("./shapes/Shape.js").ShapeConstructor | undefined;

package/lib/esm/queries/CreateBuilder.d.ts

@@ -0,0 +1,38 @@
+import { Shape, ShapeConstructor } from '../shapes/Shape.js';
+import { UpdatePartial } from './QueryFactory.js';
+import { CreateQuery, CreateResponse } from './CreateQuery.js';
+/**
+ * An immutable, fluent builder for create mutations.
+ *
+ * Every mutation method returns a new CreateBuilder — the original is never modified.
+ *
+ * Implements PromiseLike so mutations execute on `await`:
+ * ```ts
+ * const result = await CreateBuilder.from(Person).set({name: 'Alice'});
+ * ```
+ *
+ * Internally delegates to CreateQueryFactory for IR generation.
+ */
+export declare class CreateBuilder<S extends Shape = Shape, U extends UpdatePartial<S> = UpdatePartial<S>> implements PromiseLike<CreateResponse<U>>, Promise<CreateResponse<U>> {
+    private readonly _shape;
+    private readonly _data?;
+    private readonly _fixedId?;
+    private constructor();
+    private clone;
+    /**
+     * Create a CreateBuilder for the given shape.
+     */
+    static from<S extends Shape>(shape: ShapeConstructor<S> | string): CreateBuilder<S>;
+    /** Set the data for the entity to create. */
+    set<NewU extends UpdatePartial<S>>(data: NewU): CreateBuilder<S, NewU>;
+    /** Pre-assign a node ID for the created entity. */
+    withId(id: string): CreateBuilder<S, U>;
+    /** Build the IR mutation. Throws if no data was set via .set(). */
+    build(): CreateQuery;
+    /** Execute the mutation. */
+    exec(): Promise<CreateResponse<U>>;
+    then<TResult1 = CreateResponse<U>, TResult2 = never>(onfulfilled?: ((value: CreateResponse<U>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null): Promise<CreateResponse<U> | TResult>;
+    finally(onfinally?: (() => void) | null): Promise<CreateResponse<U>>;
+    get [Symbol.toStringTag](): string;
+}

package/lib/esm/queries/CreateBuilder.js

@@ -0,0 +1,96 @@
+import { resolveShape } from './resolveShape.js';
+import { CreateQueryFactory } from './CreateQuery.js';
+import { getQueryDispatch } from './queryDispatch.js';
+/**
+ * An immutable, fluent builder for create mutations.
+ *
+ * Every mutation method returns a new CreateBuilder — the original is never modified.
+ *
+ * Implements PromiseLike so mutations execute on `await`:
+ * ```ts
+ * const result = await CreateBuilder.from(Person).set({name: 'Alice'});
+ * ```
+ *
+ * Internally delegates to CreateQueryFactory for IR generation.
+ */
+export class CreateBuilder {
+    constructor(init) {
+        this._shape = init.shape;
+        this._data = init.data;
+        this._fixedId = init.fixedId;
+    }
+    clone(overrides = {}) {
+        return new CreateBuilder(Object.assign({ shape: this._shape, data: this._data, fixedId: this._fixedId }, overrides));
+    }
+    // ---------------------------------------------------------------------------
+    // Static constructors
+    // ---------------------------------------------------------------------------
+    /**
+     * Create a CreateBuilder for the given shape.
+     */
+    static from(shape) {
+        const resolved = resolveShape(shape);
+        return new CreateBuilder({ shape: resolved });
+    }
+    // ---------------------------------------------------------------------------
+    // Fluent API
+    // ---------------------------------------------------------------------------
+    /** Set the data for the entity to create. */
+    set(data) {
+        return this.clone({ data });
+    }
+    /** Pre-assign a node ID for the created entity. */
+    withId(id) {
+        return this.clone({ fixedId: id });
+    }
+    // ---------------------------------------------------------------------------
+    // Build & execute
+    // ---------------------------------------------------------------------------
+    /** Build the IR mutation. Throws if no data was set via .set(). */
+    build() {
+        if (!this._data) {
+            throw new Error('CreateBuilder requires .set(data) before .build(). Specify what to create.');
+        }
+        const data = this._data;
+        // Validate that required properties (minCount >= 1) are present in data
+        const shapeObj = this._shape.shape;
+        if (shapeObj) {
+            const requiredProps = shapeObj
+                .getUniquePropertyShapes()
+                .filter((ps) => ps.minCount && ps.minCount >= 1);
+            const dataKeys = new Set(Object.keys(data));
+            const missing = requiredProps
+                .filter((ps) => !dataKeys.has(ps.label))
+                .map((ps) => ps.label);
+            if (missing.length > 0) {
+                throw new Error(`Missing required fields for '${shapeObj.label || shapeObj.id}': ${missing.join(', ')}`);
+            }
+        }
+        // TODO: Full data validation against the shape (type checking, maxCount, nested shapes, etc.)
+        // Inject __id if fixedId is set
+        const dataWithId = this._fixedId
+            ? Object.assign(Object.assign({}, data), { __id: this._fixedId }) : data;
+        const factory = new CreateQueryFactory(this._shape, dataWithId);
+        return factory.build();
+    }
+    /** Execute the mutation. */
+    exec() {
+        return getQueryDispatch().createQuery(this.build());
+    }
+    // ---------------------------------------------------------------------------
+    // Promise interface
+    // ---------------------------------------------------------------------------
+    then(onfulfilled, onrejected) {
+        return this.exec().then(onfulfilled, onrejected);
+    }
+    catch(onrejected) {
+        return this.then().catch(onrejected);
+    }
+    finally(onfinally) {
+        return this.then().finally(onfinally);
+    }
+    get [Symbol.toStringTag]() {
+        return 'CreateBuilder';
+    }
+}
+//# sourceMappingURL=CreateBuilder.js.map

package/lib/esm/queries/CreateBuilder.js.map

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

package/lib/esm/queries/CreateQuery.d.ts

@@ -1,4 +1,4 @@
-import { Shape } from '../shapes/Shape.js';
+import { Shape, ShapeConstructor } from '../shapes/Shape.js';
 import { AddId, NodeDescriptionValue, UpdatePartial } from './QueryFactory.js';
 import { MutationQueryFactory } from './MutationQuery.js';
 import { IRCreateMutation } from './IntermediateRepresentation.js';
@@ -9,9 +9,9 @@ import { IRCreateMutation } from './IntermediateRepresentation.js';
 export type CreateQuery = IRCreateMutation;
 export type CreateResponse<U> = AddId<U, true>;
 export declare class CreateQueryFactory<ShapeType extends Shape, U extends UpdatePartial<ShapeType>> extends MutationQueryFactory {
-    shapeClass: typeof Shape;
+    shapeClass: ShapeConstructor<ShapeType>;
     readonly id: string;
     readonly description: NodeDescriptionValue;
-    constructor(shapeClass: typeof Shape, updateObjectOrFn: U);
+    constructor(shapeClass: ShapeConstructor<ShapeType>, updateObjectOrFn: U);
     build(): CreateQuery;
 }

package/lib/esm/queries/CreateQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"CreateQuery.js","sourceRoot":"","sources":["../../../src/queries/CreateQuery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAC,8BAA8B,EAAC,MAAM,iBAAiB,CAAC;AAU/D,MAAM,OAAO,kBAGX,SAAQ,oBAAoB;IAI5B,YACS,UAAwB,EAC/B,gBAAmB;QAEnB,KAAK,EAAE,CAAC;QAHD,eAAU,GAAV,UAAU,CAAc;QAI/B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,mBAAmB,CACzC,gBAAgB,EAChB,IAAI,CAAC,UAAU,CAAC,KAAK,EACrB,IAAI,CACL,CAAC;IACJ,CAAC;IAED,KAAK;QACH,OAAO,8BAA8B,CAAC;YACpC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"CreateQuery.js","sourceRoot":"","sources":["../../../src/queries/CreateQuery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAC,8BAA8B,EAAC,MAAM,iBAAiB,CAAC;AAU/D,MAAM,OAAO,kBAGX,SAAQ,oBAAoB;IAI5B,YACS,UAAuC,EAC9C,gBAAmB;QAEnB,KAAK,EAAE,CAAC;QAHD,eAAU,GAAV,UAAU,CAA6B;QAI9C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,mBAAmB,CACzC,gBAAgB,EAChB,IAAI,CAAC,UAAU,CAAC,KAAK,EACrB,IAAI,CACL,CAAC;IACJ,CAAC;IAED,KAAK;QACH,OAAO,8BAA8B,CAAC;YACpC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/esm/queries/DeleteBuilder.d.ts

@@ -0,0 +1,39 @@
+import { Shape, ShapeConstructor } from '../shapes/Shape.js';
+import { DeleteQuery, DeleteResponse } from './DeleteQuery.js';
+import { NodeId } from './MutationQuery.js';
+/**
+ * An immutable, fluent builder for delete mutations.
+ *
+ * Implements PromiseLike so mutations execute on `await`:
+ * ```ts
+ * const result = await DeleteBuilder.from(Person).for({id: '...'});
+ * ```
+ *
+ * Internally delegates to DeleteQueryFactory for IR generation.
+ */
+export declare class DeleteBuilder<S extends Shape = Shape> implements PromiseLike<DeleteResponse>, Promise<DeleteResponse> {
+    private readonly _shape;
+    private readonly _ids?;
+    private constructor();
+    private clone;
+    /**
+     * Create a DeleteBuilder for the given shape.
+     *
+     * Optionally accepts IDs inline for backwards compatibility:
+     * ```ts
+     * DeleteBuilder.from(Person).for({id: '...'})       // preferred
+     * DeleteBuilder.from(Person, {id: '...'})            // also supported
+     * ```
+     */
+    static from<S extends Shape>(shape: ShapeConstructor<S> | string, ids?: NodeId | NodeId[]): DeleteBuilder<S>;
+    /** Specify the target IDs to delete. */
+    for(ids: NodeId | NodeId[]): DeleteBuilder<S>;
+    /** Build the IR mutation. Throws if no IDs were specified via .for(). */
+    build(): DeleteQuery;
+    /** Execute the mutation. */
+    exec(): Promise<DeleteResponse>;
+    then<TResult1 = DeleteResponse, TResult2 = never>(onfulfilled?: ((value: DeleteResponse) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null): Promise<DeleteResponse | TResult>;
+    finally(onfinally?: (() => void) | null): Promise<DeleteResponse>;
+    get [Symbol.toStringTag](): string;
+}

package/lib/esm/queries/DeleteBuilder.js

@@ -0,0 +1,81 @@
+import { resolveShape } from './resolveShape.js';
+import { DeleteQueryFactory } from './DeleteQuery.js';
+import { getQueryDispatch } from './queryDispatch.js';
+/**
+ * An immutable, fluent builder for delete mutations.
+ *
+ * Implements PromiseLike so mutations execute on `await`:
+ * ```ts
+ * const result = await DeleteBuilder.from(Person).for({id: '...'});
+ * ```
+ *
+ * Internally delegates to DeleteQueryFactory for IR generation.
+ */
+export class DeleteBuilder {
+    constructor(init) {
+        this._shape = init.shape;
+        this._ids = init.ids;
+    }
+    clone(overrides = {}) {
+        return new DeleteBuilder(Object.assign({ shape: this._shape, ids: this._ids }, overrides));
+    }
+    // ---------------------------------------------------------------------------
+    // Static constructors
+    // ---------------------------------------------------------------------------
+    /**
+     * Create a DeleteBuilder for the given shape.
+     *
+     * Optionally accepts IDs inline for backwards compatibility:
+     * ```ts
+     * DeleteBuilder.from(Person).for({id: '...'})       // preferred
+     * DeleteBuilder.from(Person, {id: '...'})            // also supported
+     * ```
+     */
+    static from(shape, ids) {
+        const resolved = resolveShape(shape);
+        if (ids !== undefined) {
+            const idsArray = Array.isArray(ids) ? ids : [ids];
+            return new DeleteBuilder({ shape: resolved, ids: idsArray });
+        }
+        return new DeleteBuilder({ shape: resolved });
+    }
+    // ---------------------------------------------------------------------------
+    // Fluent API
+    // ---------------------------------------------------------------------------
+    /** Specify the target IDs to delete. */
+    for(ids) {
+        const idsArray = Array.isArray(ids) ? ids : [ids];
+        return this.clone({ ids: idsArray });
+    }
+    // ---------------------------------------------------------------------------
+    // Build & execute
+    // ---------------------------------------------------------------------------
+    /** Build the IR mutation. Throws if no IDs were specified via .for(). */
+    build() {
+        if (!this._ids || this._ids.length === 0) {
+            throw new Error('DeleteBuilder requires at least one ID to delete. Specify targets with .for(ids).');
+        }
+        const factory = new DeleteQueryFactory(this._shape, this._ids);
+        return factory.build();
+    }
+    /** Execute the mutation. */
+    exec() {
+        return getQueryDispatch().deleteQuery(this.build());
+    }
+    // ---------------------------------------------------------------------------
+    // Promise interface
+    // ---------------------------------------------------------------------------
+    then(onfulfilled, onrejected) {
+        return this.exec().then(onfulfilled, onrejected);
+    }
+    catch(onrejected) {
+        return this.then().catch(onrejected);
+    }
+    finally(onfinally) {
+        return this.then().finally(onfinally);
+    }
+    get [Symbol.toStringTag]() {
+        return 'DeleteBuilder';
+    }
+}
+//# sourceMappingURL=DeleteBuilder.js.map

package/lib/esm/queries/DeleteBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeleteBuilder.js","sourceRoot":"","sources":["../../../src/queries/DeleteBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,kBAAkB,EAA8B,MAAM,kBAAkB,CAAC;AAEjF,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AAUpD;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAa;IAMxB,YAAoB,IAA0B;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,YAA2C,EAAE;QACzD,OAAO,IAAI,aAAa,iBACtB,KAAK,EAAE,IAAI,CAAC,MAAM,EAClB,GAAG,EAAE,IAAI,CAAC,IAAI,IACX,SAAS,EACZ,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,sBAAsB;IACtB,8EAA8E;IAE9E;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,CACT,KAAmC,EACnC,GAAuB;QAEvB,MAAM,QAAQ,GAAG,YAAY,CAAI,KAAK,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAClD,OAAO,IAAI,aAAa,CAAI,EAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,aAAa,CAAI,EAAC,KAAK,EAAE,QAAQ,EAAC,CAAC,CAAC;IACjD,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E,wCAAwC;IACxC,GAAG,CAAC,GAAsB;QACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAC,GAAG,EAAE,QAAQ,EAAC,CAAC,CAAC;IACrC,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E,yEAAyE;IACzE,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CACpC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,IAAI,CACV,CAAC;QACF,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,4BAA4B;IAC5B,IAAI;QACF,OAAO,gBAAgB,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,8EAA8E;IAC9E,oBAAoB;IACpB,8EAA8E;IAE9E,IAAI,CACF,WAAkF,EAClF,UAAuE;QAEvE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CACH,UAAqE;QAErE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,CAAC,SAA+B;QACrC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,OAAO,eAAe,CAAC;IACzB,CAAC;CACF"}

package/lib/esm/queries/DeleteQuery.d.ts

@@ -1,4 +1,4 @@
-import { Shape } from '../shapes/Shape.js';
+import { Shape, ShapeConstructor } from '../shapes/Shape.js';
 import { NodeReferenceValue, UpdatePartial } from './QueryFactory.js';
 import { MutationQueryFactory, NodeId } from './MutationQuery.js';
 import { IRDeleteMutation } from './IntermediateRepresentation.js';
@@ -26,9 +26,9 @@ export type DeleteResponse = {
     errors?: Record<string, string>;
 };
 export declare class DeleteQueryFactory<ShapeType extends Shape, U extends UpdatePartial<ShapeType>> extends MutationQueryFactory {
-    shapeClass: typeof Shape;
+    shapeClass: ShapeConstructor<ShapeType>;
     readonly id: string;
     readonly ids: NodeReferenceValue[];
-    constructor(shapeClass: typeof Shape, ids: NodeId[] | NodeId);
+    constructor(shapeClass: ShapeConstructor<ShapeType>, ids: NodeId[] | NodeId);
     build(): DeleteQuery;
 }

package/lib/esm/queries/DeleteQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"DeleteQuery.js","sourceRoot":"","sources":["../../../src/queries/DeleteQuery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,oBAAoB,EAAS,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAC,8BAA8B,EAAC,MAAM,iBAAiB,CAAC;AA2B/D,MAAM,OAAO,kBAGX,SAAQ,oBAAoB;IAI5B,YACS,UAAwB,EAC/B,GAAsB;QAEtB,KAAK,EAAE,CAAC;QAHD,eAAU,GAAV,UAAU,CAAc;QAI/B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK;QACH,OAAO,8BAA8B,CAAC;YACpC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"DeleteQuery.js","sourceRoot":"","sources":["../../../src/queries/DeleteQuery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,oBAAoB,EAAS,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAC,8BAA8B,EAAC,MAAM,iBAAiB,CAAC;AA2B/D,MAAM,OAAO,kBAGX,SAAQ,oBAAoB;IAI5B,YACS,UAAuC,EAC9C,GAAsB;QAEtB,KAAK,EAAE,CAAC;QAHD,eAAU,GAAV,UAAU,CAA6B;QAI9C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK;QACH,OAAO,8BAA8B,CAAC;YACpC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/esm/queries/FieldSet.d.ts

@@ -0,0 +1,203 @@
+import type { NodeShape, PropertyShape } from '../shapes/SHACL.js';
+import type { Shape, ShapeConstructor } from '../shapes/Shape.js';
+import { PropertyPath } from './PropertyPath.js';
+import type { WherePath } from './SelectQuery.js';
+type QueryBuilderObjectLike = {
+    property?: PropertyShape;
+    subject?: QueryBuilderObjectLike;
+    wherePath?: unknown;
+};
+/**
+ * A single entry in a FieldSet: a property path with optional alias, scoped filter,
+ * sub-selection, aggregation, and custom key.
+ */
+export type FieldSetEntry = {
+    path: PropertyPath;
+    alias?: string;
+    scopedFilter?: WherePath;
+    /** Nested object selection — the user explicitly selected sub-fields (e.g. `p.friends.select(...)`) */
+    subSelect?: FieldSet;
+    aggregation?: 'count';
+    customKey?: string;
+    evaluation?: {
+        method: string;
+        wherePath: any;
+    };
+    /** Component preload composition — the FieldSet comes from a linked component's own query,
+     *  merged in via `preloadFor()`. Distinct from subSelect which is a user-authored nested query. */
+    preloadSubSelect?: FieldSet;
+};
+/**
+ * Input types accepted by FieldSet construction methods.
+ *
+ * - `string` — resolved via walkPropertyPath (dot-separated)
+ * - `PropertyPath` — used directly
+ * - `FieldSet` — merged in
+ * - `Record<string, string[] | FieldSet>` — nested fields
+ */
+export type FieldSetInput = string | PropertyPath | FieldSet | Record<string, string[] | FieldSet>;
+/** JSON representation of a FieldSet field entry. */
+export type FieldSetFieldJSON = {
+    path: string;
+    as?: string;
+    subSelect?: FieldSetJSON;
+    aggregation?: string;
+    customKey?: string;
+    evaluation?: {
+        method: string;
+        wherePath: any;
+    };
+};
+/** JSON representation of a FieldSet. */
+export type FieldSetJSON = {
+    shape: string;
+    fields: FieldSetFieldJSON[];
+};
+/**
+ * An immutable, composable collection of property paths for a shape.
+ *
+ * FieldSet describes which properties to select, independent of
+ * how the query is built. It integrates with QueryBuilder via
+ * `.select(fieldSet)`.
+ *
+ * Every mutation method returns a new FieldSet — the original is never modified.
+ */
+export declare class FieldSet<R = any, Source = any> {
+    readonly shape: NodeShape;
+    readonly entries: readonly FieldSetEntry[];
+    /** Phantom field — carries the callback response type for conditional type inference. */
+    readonly __response: R;
+    /** Phantom field — carries the source context (QueryShapeSet/QueryShape) for conditional type inference. */
+    readonly __source: Source;
+    /**
+     * For sub-select FieldSets: the raw callback return value (proxy trace objects).
+     * Stored so conditional types can extract the response type.
+     */
+    readonly traceResponse?: R;
+    /**
+     * For sub-select FieldSets: the parent property segments leading to this sub-select.
+     */
+    readonly parentSegments?: PropertyShape[];
+    /**
+     * For sub-select FieldSets: the shape class (ShapeType) of the sub-select's target.
+     */
+    readonly shapeType?: any;
+    private constructor();
+    /**
+     * Create a FieldSet for the given shape with the specified fields.
+     *
+     * Accepts a ShapeClass (e.g. Person), NodeShape, or shape IRI string.
+     * Fields can be string paths, PropertyPath instances, nested objects,
+     * or a callback receiving a proxy for dot-access.
+     */
+    static for<S extends Shape>(shape: ShapeConstructor<S>, fields: FieldSetInput[]): FieldSet<any>;
+    static for<S extends Shape, R>(shape: ShapeConstructor<S>, fn: (p: any) => R): FieldSet<R>;
+    static for(shape: NodeShape | string, fields: FieldSetInput[]): FieldSet<any>;
+    static for(shape: NodeShape | string, fn: (p: any) => any): FieldSet<any>;
+    /**
+     * Create a typed FieldSet for a sub-select. Traces the callback through the proxy,
+     * stores parentSegments and traceResponse for runtime compatibility, and preserves
+     * R and Source generics for conditional type inference.
+     */
+    static forSubSelect<R, Source>(shapeClass: any, fn: (p: any) => R, parentSegments: PropertyShape[]): FieldSet<R, Source>;
+    /**
+     * Create a FieldSet containing all decorated properties of the shape.
+     *
+     * @param opts.depth Controls how deep to include nested shape properties:
+     *   - `depth=1` (default): this level only — properties of the root shape.
+     *   - `depth=0`: throws — use a node reference instead.
+     *   - `depth>1`: recursively includes nested shape properties up to the given depth.
+     */
+    static all<S extends Shape>(shape: ShapeConstructor<S>, opts?: {
+        depth?: number;
+    }): FieldSet;
+    static all(shape: NodeShape | string, opts?: {
+        depth?: number;
+    }): FieldSet;
+    /**
+     * Recursive helper for all(). Tracks visited shape IDs to prevent infinite loops
+     * from circular shape references.
+     */
+    private static allForShape;
+    /**
+     * Merge multiple FieldSets into one, deduplicating by path equality.
+     * All FieldSets must share the same root shape.
+     */
+    static merge(sets: FieldSet[]): FieldSet;
+    /** Returns a new FieldSet with only the given fields. */
+    select(fields: FieldSetInput[]): FieldSet;
+    /** Returns a new FieldSet with additional entries. */
+    add(fields: FieldSetInput[]): FieldSet;
+    /** Returns a new FieldSet without entries matching the given labels. */
+    remove(labels: string[]): FieldSet;
+    /** Synonym for replacing all entries — returns a new FieldSet with only the given fields. */
+    set(fields: FieldSetInput[]): FieldSet;
+    /** Returns a new FieldSet keeping only entries matching the given labels. */
+    pick(labels: string[]): FieldSet;
+    /** Returns all PropertyPaths in this FieldSet. */
+    paths(): PropertyPath[];
+    /** Returns terminal property labels of all entries. */
+    labels(): string[];
+    /**
+     * Serialize this FieldSet to a plain JSON object.
+     * Shape is identified by its IRI, paths by dot-separated labels.
+     */
+    toJSON(): FieldSetJSON;
+    /**
+     * Reconstruct a FieldSet from a JSON object.
+     * Resolves shape IRI via getShapeClass() and paths via walkPropertyPath().
+     */
+    static fromJSON(json: FieldSetJSON): FieldSet;
+    /**
+     * Resolves any of the accepted shape input types to a NodeShape and optional ShapeClass.
+     * Accepts: ShapeConstructor (class with .shape), NodeShape, or IRI string.
+     */
+    private static resolveShapeInput;
+    /** @deprecated Use resolveShapeInput instead. Kept for fromJSON which only passes NodeShape|string. */
+    private static resolveShape;
+    private static resolveInputs;
+    /**
+     * Trace fields using the full ProxiedPathBuilder proxy (createProxiedPathBuilder).
+     * Handles nested paths, where conditions, aggregations, and sub-selects.
+     */
+    private static traceFieldsWithProxy;
+    /**
+     * Convert a single proxy trace result (QueryBuilderObject, SetSize, or FieldSet sub-select)
+     * into a FieldSetEntry.
+     */
+    private static convertTraceResult;
+    /**
+     * Walk a QueryBuilderObject-like chain (via .subject) collecting PropertyShape segments
+     * from leaf to root, then reverse to get root-to-leaf order.
+     */
+    static collectPropertySegments(obj: QueryBuilderObjectLike): PropertyShape[];
+    /**
+     * Extract a FieldSet from a component-like object for preload composition.
+     *
+     * Supports multiple component interfaces:
+     * - `.fields` as a FieldSet directly
+     * - `.query` as a FieldSet, QueryBuilder (duck-typed via .fields()), or
+     *   Record<string, QueryBuilder> (e.g. `{person: PersonQuery}`)
+     */
+    static extractComponentFieldSet(component: any): FieldSet | undefined;
+    /**
+     * Internal factory that bypasses the private constructor for use by static methods.
+     */
+    private static createInternal;
+    /**
+     * Create a FieldSet from raw entries. Used by QueryBuilder to merge preload entries.
+     */
+    static createFromEntries(shape: NodeShape, entries: FieldSetEntry[]): FieldSet;
+    /**
+     * Extract FieldSetEntry[] from a sub-query's traceResponse.
+     * Public alias for use by lightweight sub-select wrappers.
+     */
+    static extractSubSelectEntriesPublic(rootShape: NodeShape, traceResponse: any): FieldSetEntry[];
+    /**
+     * Extract FieldSetEntry[] from a sub-select's traceResponse.
+     * The traceResponse is the result of calling the sub-query callback with a proxy,
+     * containing QueryBuilderObjects, arrays, custom objects, etc.
+     */
+    private static extractSubSelectEntries;
+}
+export {};