@_linked/core 2.12.0 → 2.13.0

package/lib/cjs/queries/QueryContext.d.ts

@@ -1,50 +0,0 @@
-import { type QShape } from './SelectQuery.js';
-import { Shape } from '../shapes/Shape.js';
-/**
- * A live reference returned by getQueryContext when the context hasn't been set yet.
- * Its `id` getter resolves lazily from the global context map, so queries built with
- * a PendingQueryContext will pick up the value once it's set (e.g. after auth completes).
- */
-export declare class PendingQueryContext {
-    readonly contextName: string;
-    constructor(contextName: string);
-    get id(): string | undefined;
-}
-/**
- * Thrown when a query carrying a context reference is lowered but the context
- * isn't set in the current process. A context ref is carried in DSL-JSON and
- * resolves at lowering time against whatever context map is available (e.g.
- * server-side auth); if it can't resolve, lowering throws this rather than
- * silently producing a subject-less query.
- */
-export declare class UnresolvedContextError extends Error {
-    readonly contextName: string;
-    constructor(contextName: string);
-}
-/** Listener notified (with the changed context name) whenever a context is set or cleared. */
-export type QueryContextListener = (name: string) => void;
-/**
- * Subscribe to query-context changes. Returns an unsubscribe function.
- *
- * This is the primitive that makes context resolution reactive: a consuming layer
- * (e.g. React components) subscribes and re-runs affected queries when the context
- * lands — so a query that resolved to `null` while the context was unset simply
- * re-runs and resolves once it's available ("waiting"), and re-runs again on any
- * later change ("auto re-resolve"). Core only emits the change; re-execution is the
- * consumer's responsibility.
- */
-export declare function subscribeQueryContext(listener: QueryContextListener): () => void;
-/**
- * Normalize any query-context value to a {@link PendingQueryContext} carrying its name,
- * or return `undefined` if the value is not a context reference.
- *
- * A context appears in two runtime forms: a `PendingQueryContext` (the context was unset
- * when `getQueryContext()` was called) or a resolved `QueryShape` stamped with
- * `__queryContextName` (it was already set). Both must be treated as the same `{@ctx}`
- * reference wherever a node value/id is accepted (mutation field values, delete ids), so
- * that context-bound mutations behave identically whether the context is set or unset at
- * build time — resolution always happens at lowering.
- */
-export declare function asContextRef(value: unknown): PendingQueryContext | undefined;
-export declare function getQueryContext<T extends Shape>(name: string): QShape<T>;
-export declare function setQueryContext(name: string, value: any, shapeType?: any): void;

package/lib/cjs/queries/QueryContext.js

@@ -1,147 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnresolvedContextError = exports.PendingQueryContext = void 0;
-exports.subscribeQueryContext = subscribeQueryContext;
-exports.asContextRef = asContextRef;
-exports.getQueryContext = getQueryContext;
-exports.setQueryContext = setQueryContext;
-const SelectQuery_js_1 = require("./SelectQuery.js");
-const Shape_js_1 = require("../shapes/Shape.js");
-const queryContext = new Map();
-/**
- * A live reference returned by getQueryContext when the context hasn't been set yet.
- * Its `id` getter resolves lazily from the global context map, so queries built with
- * a PendingQueryContext will pick up the value once it's set (e.g. after auth completes).
- */
-class PendingQueryContext {
-    constructor(contextName) {
-        this.contextName = contextName;
-    }
-    get id() {
-        var _a;
-        return (_a = queryContext.get(this.contextName)) === null || _a === void 0 ? void 0 : _a.id;
-    }
-}
-exports.PendingQueryContext = PendingQueryContext;
-/**
- * Thrown when a query carrying a context reference is lowered but the context
- * isn't set in the current process. A context ref is carried in DSL-JSON and
- * resolves at lowering time against whatever context map is available (e.g.
- * server-side auth); if it can't resolve, lowering throws this rather than
- * silently producing a subject-less query.
- */
-class UnresolvedContextError extends Error {
-    constructor(contextName) {
-        super(`Query context "${contextName}" is not set and could not be resolved at lowering time.`);
-        this.contextName = contextName;
-        this.name = 'UnresolvedContextError';
-    }
-}
-exports.UnresolvedContextError = UnresolvedContextError;
-const contextListeners = new Set();
-/**
- * Subscribe to query-context changes. Returns an unsubscribe function.
- *
- * This is the primitive that makes context resolution reactive: a consuming layer
- * (e.g. React components) subscribes and re-runs affected queries when the context
- * lands — so a query that resolved to `null` while the context was unset simply
- * re-runs and resolves once it's available ("waiting"), and re-runs again on any
- * later change ("auto re-resolve"). Core only emits the change; re-execution is the
- * consumer's responsibility.
- */
-function subscribeQueryContext(listener) {
-    contextListeners.add(listener);
-    return () => contextListeners.delete(listener);
-}
-function notifyContextChange(name) {
-    // Snapshot so a listener that (un)subscribes or re-sets a context during
-    // notification can't mutate the set mid-iteration.
-    for (const listener of [...contextListeners])
-        listener(name);
-}
-/**
- * Normalize any query-context value to a {@link PendingQueryContext} carrying its name,
- * or return `undefined` if the value is not a context reference.
- *
- * A context appears in two runtime forms: a `PendingQueryContext` (the context was unset
- * when `getQueryContext()` was called) or a resolved `QueryShape` stamped with
- * `__queryContextName` (it was already set). Both must be treated as the same `{@ctx}`
- * reference wherever a node value/id is accepted (mutation field values, delete ids), so
- * that context-bound mutations behave identically whether the context is set or unset at
- * build time — resolution always happens at lowering.
- */
-function asContextRef(value) {
-    var _a;
-    if (value instanceof PendingQueryContext)
-        return value;
-    if (!value || typeof value !== 'object')
-        return undefined;
-    // A resolved context is a QueryShape proxy wrapping a Shape stamped with
-    // `__queryContextName`. Read it via `originalValue` (a known QueryShape field)
-    // so we don't trip the proxy's "undecorated property" guard (it now throws);
-    // a bare Shape
-    // carries the stamp directly.
-    const v = value;
-    const source = (_a = v.originalValue) !== null && _a !== void 0 ? _a : v;
-    const name = source.__queryContextName;
-    if (typeof name === 'string')
-        return new PendingQueryContext(name);
-    return undefined;
-}
-function getQueryContext(name) {
-    if (queryContext.has(name)) {
-        return queryContext.get(name);
-    }
-    // Return a live reference that resolves lazily when the context is set.
-    // This avoids the timing issue where module-level queries capture null
-    // because the context hasn't been set yet (e.g. useEffect hasn't fired).
-    return new PendingQueryContext(name);
-}
-function setQueryContext(name, value, shapeType) {
-    // Clearing a context entry
-    if (!value) {
-        queryContext.delete(name);
-        notifyContextChange(name);
-        return;
-    }
-    // Already a QShape — stamp the underlying shape and store as-is. (Checked before
-    // the plain-`{id}` branch below: a QueryShape's `.id` getter is also a string, so
-    // testing for `{id}` first would wrongly require a shapeType and no-op.)
-    if (value instanceof SelectQuery_js_1.QueryShape) {
-        const orig = value.originalValue;
-        if (orig) {
-            orig.__queryContextName = name;
-            if (typeof orig.id === 'string')
-                orig.__queryContextId = orig.id;
-        }
-        queryContext.set(name, value);
-        notifyContextChange(name);
-        return;
-    }
-    // A Shape instance — stamp it and wrap as a QShape. Needs no shapeType (it is one).
-    if (value instanceof Shape_js_1.Shape) {
-        value.__queryContextName = name;
-        if (typeof value.id === 'string')
-            value.__queryContextId = value.id;
-        queryContext.set(name, new SelectQuery_js_1.QueryShape(value));
-        notifyContextChange(name);
-        return;
-    }
-    // A plain QResult `{id}` — materialize a shape (requires shapeType).
-    if (typeof value.id === 'string') {
-        if (!shapeType) {
-            // A silent no-op here is a trap: the context never sets and the caller
-            // gets no signal. A `{id}` value cannot be materialized without its shape.
-            throw new Error(`setQueryContext('${name}'): a {id} value requires a shapeType so the shape can be materialized. Pass the Shape class as the third argument.`);
-        }
-        const shape = new shapeType();
-        shape.id = value.id;
-        shape.__queryContextId = value.id;
-        shape.__queryContextName = name;
-        queryContext.set(name, SelectQuery_js_1.QueryShape.create(shape));
-        notifyContextChange(name);
-        return;
-    }
-    throw new Error(`setQueryContext('${name}'): value is not a QueryShape, Shape, or {id} result. Got ${typeof value}. Pass a Shape instance, a query-context shape, or a {id} result (with its shapeType).`);
-}
-//# sourceMappingURL=QueryContext.js.map

package/lib/cjs/queries/QueryContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"QueryContext.js","sourceRoot":"","sources":["../../../src/queries/QueryContext.ts"],"names":[],"mappings":";;;AAgDA,sDAGC;AAmBD,oCAaC;AAED,0CAQC;AAED,0CAoDC;AAnJD,qDAAyD;AACzD,iDAAyC;AAEzC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAiC,CAAC;AAE9D;;;;GAIG;AACH,MAAa,mBAAmB;IAC9B,YAA4B,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAEnD,IAAI,EAAE;;QACJ,OAAO,MAAA,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,0CAAE,EAAE,CAAC;IAChD,CAAC;CACF;AAND,kDAMC;AAED;;;;;;GAMG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAA4B,WAAmB;QAC7C,KAAK,CACH,kBAAkB,WAAW,0DAA0D,CACxF,CAAC;QAHwB,gBAAW,GAAX,WAAW,CAAQ;QAI7C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAPD,wDAOC;AAID,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEzD;;;;;;;;;GASG;AACH,SAAgB,qBAAqB,CAAC,QAA8B;IAClE,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,yEAAyE;IACzE,mDAAmD;IACnD,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,gBAAgB,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAAC,KAAc;;IACzC,IAAI,KAAK,YAAY,mBAAmB;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,yEAAyE;IACzE,+EAA+E;IAC/E,6EAA6E;IAC7E,eAAe;IACf,8BAA8B;IAC9B,MAAM,CAAC,GAAG,KAAuF,CAAC;IAClG,MAAM,MAAM,GAAG,MAAA,CAAC,CAAC,aAAa,mCAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAI,MAAyC,CAAC,kBAAkB,CAAC;IAC3E,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,eAAe,CAAkB,IAAY;IAC3D,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAQ,CAAC;AAC9C,CAAC;AAED,SAAgB,eAAe,CAAC,IAAY,EAAE,KAAU,EAAE,SAAU;IAClE,2BAA2B;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,iFAAiF;IACjF,kFAAkF;IAClF,yEAAyE;IACzE,IAAI,KAAK,YAAY,2BAAU,EAAE,CAAC;QAChC,MAAM,IAAI,GAAI,KAAa,CAAC,aAAa,CAAC;QAC1C,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;gBAAE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,CAAC;QACnE,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,KAAY,CAAC,CAAC;QACrC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,oFAAoF;IACpF,IAAI,KAAK,YAAY,gBAAK,EAAE,CAAC;QAC3B,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAChC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;YAAE,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,EAAE,CAAC;QACpE,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,2BAAU,CAAC,KAAK,CAAQ,CAAC,CAAC;QACrD,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,qEAAqE;IACrE,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QACjC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,uEAAuE;YACvE,2EAA2E;YAC3E,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,qHAAqH,CAC9I,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAK,SAAiB,EAAE,CAAC;QACvC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAChC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,2BAAU,CAAC,MAAM,CAAC,KAAK,CAAQ,CAAC,CAAC;QACxD,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,6DAA6D,OAAO,KAAK,wFAAwF,CAC1L,CAAC;AACJ,CAAC"}

package/lib/cjs/queries/QueryFactory.d.ts

@@ -1,80 +0,0 @@
-import type { NodeShape, PropertyShape } from '../shapes/SHACL.js';
-import { Shape } from '../shapes/Shape.js';
-import { ShapeSet } from '../collections/ShapeSet.js';
-import type { NodeReferenceValue } from '../utils/NodeReference.js';
-import { ExpressionNode } from '../expressions/ExpressionNode.js';
-export type Prettify<T> = T extends infer R ? {
-    [K in keyof R]: R[K];
-} : never;
-type WithId<U> = U & {
-    id: string;
-};
-type IsPlainObject<T> = T extends object ? T extends any[] ? false : T extends Function ? false : T extends Date ? false : T extends RegExp ? false : T extends Error ? false : T extends null ? false : T extends undefined ? false : T extends object ? true : false : false;
-type RecursiveTransform<T, IsCreate = false> = T extends string | number | boolean | Date | null | undefined ? T : T extends Array<infer U> ? UpdatedSet<Prettify<RecursiveTransform<U>>, IsCreate> : IsSetModification<T> extends true ? ModifiedSet<T, IsCreate> : IsPlainObject<T> extends true ? WithId<{
-    [K in keyof T]: Prettify<RecursiveTransform<T[K], IsCreate>>;
-}> : T;
-type UpdatedSet<U, IsCreate> = IsCreate extends true ? U[] : {
-    updatedTo: U[];
-};
-type IsSetModification<T> = T extends {
-    add?: any;
-    remove?: any;
-} ? true : false;
-type AddedType<T> = T extends {
-    add: (infer U)[];
-} ? U : T extends {
-    add: infer U;
-} ? U : never;
-type RemovedType<T> = T extends {
-    remove: (infer U)[];
-} ? U : T extends {
-    remove: infer U;
-} ? U : never;
-type ModifiedSet<T, IsCreate = false> = {
-    added: AddId<AddedType<T>, IsCreate>[];
-    removed: AddId<RemovedType<T>, IsCreate>[];
-};
-export type AddId<T, IsCreate = false> = Prettify<RecursiveTransform<T, IsCreate>>;
-export type UpdatePartial<S = Shape> = UpdateNodeDescription<S> | NodeReferenceValue;
-type UpdateNodeDescription<Shape> = Partial<Omit<{
-    [P in KeysWithoutFunctions<Shape>]: ShapePropValueToUpdatePartial<Shape[P]>;
-}, 'node' | 'nodeShape' | 'namedNode' | 'targetClass'>>;
-type KeysWithoutFunctions<T> = {
-    [K in keyof T]: T[K] extends Function ? never : K;
-}[keyof T];
-type ShapePropValueToUpdatePartial<ShapeProperty> = ShapeProperty extends Shape ? UpdatePartial<ShapeProperty> : ShapeProperty extends ShapeSet<infer SSType> ? SetUpdateValue<SSType> : ShapeProperty | ExpressionNode;
-type SetUpdateValue<SSType> = UpdatePartial<SSType>[] | SetModification<SSType>;
-export type SetModification<SSType> = {
-    add?: UpdatePartial<SSType>[] | UpdatePartial<SSType>;
-    remove?: UpdatePartial<SSType>[] | UpdatePartial<SSType>;
-};
-export type SetModificationValue = {
-    $add?: UpdatePartial[];
-    $remove?: NodeReferenceValue[];
-};
-type UnsetValue = undefined;
-export type LiteralUpdateValue = string | number | boolean | Date;
-export type PropUpdateValue = SinglePropertyUpdateValue | SinglePropertyUpdateValue[] | SetModificationValue;
-export type SinglePropertyUpdateValue = NodeDescriptionValue | NodeReferenceValue | LiteralUpdateValue | UnsetValue;
-export type NodeDescriptionValue = {
-    shape: NodeShape;
-    fields: UpdateNodePropertyValue[];
-    /**
-     * The id of the node to be created.
-     * Optional, if not provided a new id will be generated.
-     */
-    __id?: string;
-};
-export type UpdateNodePropertyValue = {
-    prop: PropertyShape;
-    val: PropUpdateValue;
-};
-export type ShapeReferenceValue = {
-    id: string;
-    shape: NodeReferenceValue;
-};
-export { toNodeReference } from '../utils/NodeReference.js';
-export type { NodeReferenceValue };
-export declare abstract class QueryFactory {
-}
-export declare function isSetModificationValue(value: any): value is SetModificationValue;

package/lib/cjs/queries/QueryFactory.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueryFactory = exports.toNodeReference = void 0;
-exports.isSetModificationValue = isSetModificationValue;
-var NodeReference_js_1 = require("../utils/NodeReference.js");
-Object.defineProperty(exports, "toNodeReference", { enumerable: true, get: function () { return NodeReference_js_1.toNodeReference; } });
-class QueryFactory {
-}
-exports.QueryFactory = QueryFactory;
-function isSetModificationValue(value) {
-    if (value === null || typeof value !== 'object')
-        return false;
-    let hasAddKey = value.$add;
-    let hasRemoveKey = value.$remove;
-    let numKeys = Object.keys(value).length;
-    //has no other keys
-    return ((hasAddKey && hasRemoveKey && numKeys === 2) ||
-        (hasAddKey && numKeys === 1) ||
-        (hasRemoveKey && numKeys === 1));
-}
-//# sourceMappingURL=QueryFactory.js.map

package/lib/cjs/queries/QueryFactory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"QueryFactory.js","sourceRoot":"","sources":["../../../src/queries/QueryFactory.ts"],"names":[],"mappings":";;;AAwKA,wDAcC;AAnBD,8DAA0D;AAAlD,mHAAA,eAAe,OAAA;AAGvB,MAAsB,YAAY;CAAG;AAArC,oCAAqC;AAErC,SAAgB,sBAAsB,CACpC,KAAU;IAEV,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE9D,IAAI,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3B,IAAI,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;IACjC,IAAI,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACxC,mBAAmB;IACnB,OAAO,CACL,CAAC,SAAS,IAAI,YAAY,IAAI,OAAO,KAAK,CAAC,CAAC;QAC5C,CAAC,SAAS,IAAI,OAAO,KAAK,CAAC,CAAC;QAC5B,CAAC,YAAY,IAAI,OAAO,KAAK,CAAC,CAAC,CAChC,CAAC;AACJ,CAAC"}

package/lib/cjs/queries/SelectQuery.d.ts

@@ -1,302 +0,0 @@
-import { Shape, type ShapeConstructor } from '../shapes/Shape.js';
-import type { NodeShape, PropertyShape } from '../shapes/SHACL.js';
-import type { RawSelectInput } from './IRDesugar.js';
-import { ShapeSet } from '../collections/ShapeSet.js';
-import { CoreSet } from '../collections/CoreSet.js';
-import { NodeReferenceValue, type Prettify, type ShapeReferenceValue } from './QueryFactory.js';
-import { FieldSet } from './FieldSet.js';
-import { PropertyPath } from './PropertyPath.js';
-import type { QueryBuilder, QueryBuilderJSON } from './QueryBuilder.js';
-import { ExpressionNode, ExistsCondition } from '../expressions/ExpressionNode.js';
-import { PendingQueryContext } from './QueryContext.js';
-/**
- * The closed, read-only select query a dataset receives (implemented by
- * `SelectBuilder`). It exposes the wire form (`toJSON`), the routing key
- * (`shape`), and the read-only lowering hook (`toRawInput`) — but none of the
- * fluent mutators, so a store cannot keep building on it. The IR algebra is
- * `IRSelectQuery`, produced on demand by `lower(query)`.
- */
-export interface SelectQuery {
-    readonly __queryKind: 'select';
-    readonly shape: NodeShape;
-    toJSON(): QueryBuilderJSON;
-    toRawInput(): RawSelectInput;
-}
-/**
- * ###################################
- * #### TYPES FOR QUERY BUILDING  ####
- * ###################################
- */
-export type JSPrimitive = JSNonNullPrimitive | null | undefined;
-export type JSNonNullPrimitive = string | number | boolean | Date;
-export type SingleResult<ResultType> = ResultType extends Array<infer R> ? R : ResultType extends Set<infer R> ? R : ResultType;
-/**
- * All the possible types that a regular get/set method of a Shape can return
- */
-export type AccessorReturnValue = Shape | ShapeSet | JSPrimitive | NodeReferenceValue;
-export type WhereClause<S extends Shape | AccessorReturnValue> = ExpressionNode | ExistsCondition | ((s: ToQueryBuilderObject<S>) => ExpressionNode | ExistsCondition);
-export type QueryBuildFn<T extends Shape, ResponseType> = (p: ToQueryBuilderObject<T>) => ResponseType;
-export type SortByPath = {
-    paths: PropertyPath[];
-    /** Per-path sort direction (parallel to `paths`). */
-    directions: ('ASC' | 'DESC')[];
-};
-/**
- * A property-only query path, used by where/sort proxy tracing.
- */
-export type QueryPropertyPath = QueryStep[];
-/**
- * A QueryStep is a single step in a query path.
- */
-export type QueryStep = PropertyQueryStep | SizeStep | ShapeReferenceValue;
-export type SizeStep = {
-    count: QueryPropertyPath;
-    label?: string;
-};
-export type PropertyQueryStep = {
-    property: PropertyShape;
-    where?: WherePath;
-};
-/**
- * Maps all the return types of get/set methods of a Shape and maps their return types to QueryBuilderObjects
- */
-export type QueryShapeProps<T extends Shape, Source, Property extends string | number | symbol = any> = {
-    [P in keyof T]: ToQueryBuilderObject<T[P], QShape<T, Source, Property>, P>;
-};
-export type SelectAllQueryResponse<T extends Shape> = Array<QueryShapeProps<T, null, ''>[Exclude<Extract<{
-    [K in keyof T]-?: T[K] extends (...args: any[]) => any ? never : K;
-}[keyof T], string>, Extract<keyof Shape, string>>]>;
-/**
- * This type states that the ShapeSet has access to the same methods as the shape of all the items in the set
- * (this is enabled with the QueryShapeSet.proxifyShapeSet method)
- * Each value of the shape is converted to a QueryBuilderObject
- */
-export type QueryShapeSetProps<SourceShapeSet, Shape> = {
-    [P in keyof Shape]: ToQueryBuilderObject<Shape[P], SourceShapeSet, P>;
-};
-/**
- * ShapeSets are converted to QueryShapeSets, but also inherit all the properties of the shape that each item in the set has (with converted result types)
- */
-export type QShapeSet<ShapeSetType extends Shape, Source = null, Property extends string | number | symbol = null> = QueryShapeSet<ShapeSetType, Source, Property> & QueryShapeSetProps<QueryShapeSet<ShapeSetType, Source, Property>, ShapeSetType>;
-/**
- * Shapes are converted to QueryShapes, but also inherit all the properties of the shape (with converted result types)
- */
-export type QShape<T extends Shape, Source = any, Property extends string | number | symbol = any> = QueryShape<T, Source, Property> & QueryShapeProps<T, Source, Property>;
-export type ToQueryBuilderObject<T, Source = null, Property extends string | number | symbol = ''> = T extends ShapeSet<infer ShapeSetType> ? QShapeSet<ShapeSetType, Source, Property> : T extends Shape ? QShape<T, Source, Property> : T extends string | number | Date | boolean ? ToQueryPrimitive<T, Source, Property> : T extends Array<infer AT> ? AT extends Date | string | number ? QueryPrimitiveSet<ToQueryPrimitive<AT, Source, Property>> : AT extends boolean ? QueryPrimitive<boolean> : AT[] : T extends NodeReferenceValue ? QShape<Shape, Source, Property> : QueryBuilderObject<T, Source, Property>;
-export type ToQueryPrimitive<T extends string | number | Date | boolean, Source, Property extends string | number | symbol = ''> = T extends string ? QueryPrimitive<string, Source, Property> : T extends number ? QueryPrimitive<number, Source, Property> : T extends Date ? QueryPrimitive<Date, Source, Property> : T extends boolean ? QueryPrimitive<boolean, Source, Property> : never & {
-    __error: 'ToQueryPrimitive: no matching primitive type';
-};
-export type WhereExpressionPath = {
-    expressionNode: ExpressionNode;
-};
-export type WhereExistsPath = {
-    existsCondition: ExistsCondition;
-};
-export type WherePath = WhereExpressionPath | WhereExistsPath;
-/**
- * An argument can be a direct reference to a node, a js primitive (boolean,number), a path to resolve (like from a query context variables)
- * Or a wherePath in the case of some() or every() (e.g. x.where(x.friends.some(f => f.age > 18) -> the argument is a wherePath)
- */
-export type QueryComponentLike<ShapeType extends Shape, CompQueryResult> = {
-    query: QueryBuilder<ShapeType> | FieldSet | Record<string, QueryBuilder<ShapeType>>;
-    fields?: FieldSet;
-};
-/**
- * Interface that linked components (e.g. from `@_linked/react`'s `linkedComponent()`)
- * must satisfy to participate in preloadFor.
- *
- * Components expose their data requirements as a QueryBuilder,
- * and optionally a FieldSet for declarative field access.
- */
-export interface LinkedComponentInterface<S extends Shape = Shape, R = any> {
-    /** The component's data query (QueryBuilder template, not executed). */
-    query: QueryBuilder<S, any, R>;
-    /** The component's field requirements as a FieldSet. */
-    fields?: FieldSet;
-}
-/**
- * ###################################
- * ####    QUERY RESULT TYPES     ####
- * ###################################
- */
-export type QResult<ShapeType extends Shape = Shape, Object = {}> = Object & {
-    id: string;
-};
-/**
- * MAIN ENTRY to convert the response of a query into a result object
- */
-export type QueryResponseToResultType<T, QShapeType extends Shape = null, HasName = false> = T extends QueryBuilderObject ? GetQueryObjectResultType<T, {}, false, HasName> : T extends FieldSet<infer Response, infer Source> ? GetNestedQueryResultType<Response, Source> : T extends Array<infer Type> ? UnionToIntersection<QueryResponseToResultType<Type>> : T extends ExpressionNode ? boolean : T extends Object ? QResult<QShapeType, Prettify<ObjectToPlainResult<T>>> : never & {
-    __error: 'QueryResponseToResultType: unmatched query response type';
-};
-/**
- * Turns a QueryBuilderObject into a plain JS object
- * @param QV the query value type
- * @param SubProperties to add extra properties into the result object (used to merge arrays into objects for example)
- * @param SourceOverwrite if the source of the query value should be overwritten
- */
-export type GetQueryObjectResultType<QV, SubProperties = {}, PrimitiveArray = false, HasName = false> = QV extends SetSize<infer Source> ? SetSizeToQueryResult<Source, HasName> : QV extends QueryPrimitive<infer Primitive, infer Source, infer Property> ? CreateQResult<Source, PrimitiveArray extends true ? Primitive[] : Primitive, Property, {}, HasName> : QV extends QueryShape<infer ShapeType, infer Source, infer Property> ? CreateQResult<Source, ShapeType, Property, SubProperties, HasName> : QV extends BoundComponent<infer Source, infer CompQueryResult> ? GetQueryObjectResultType<Source, SubProperties & QueryResponseToResultType<CompQueryResult>, PrimitiveArray, HasName> : QV extends QueryShapeSet<infer ShapeType, infer Source, infer Property> ? CreateShapeSetQResult<ShapeType, Source, Property, SubProperties, HasName> : QV extends QueryPrimitiveSet<infer QPrim extends QueryPrimitive<any>> ? GetQueryObjectResultType<QPrim, null, null, true> : QV extends Array<infer Type> ? UnionToIntersection<QueryResponseToResultType<Type>> : QV extends QueryPrimitive<boolean, any, any> ? 'bool' : never & {
-    __error: 'GetQueryObjectResultType: unmatched query value type';
-};
-export type SetSizeToQueryResult<Source, HasName = false> = Source extends QueryShapeSet<infer ShapeType, infer ParentSource, infer SourceProperty> ? HasName extends false ? CreateQResult<ParentSource, number, SourceProperty> : number : number;
-/**
- * If the source is an object (it extends shape)
- * then the result is a plain JS Object, with Property as its key, with type Value
- */
-export type CreateQResult<Source, Value = undefined, Property extends string | number | symbol = '', SubProperties = {}, HasName = false> = Source extends QueryShape<infer SourceShapeType, infer ParentSource, infer SourceProperty> ? ParentSource extends null ? HasName extends true ? Value : Value extends null ? QResult<SourceShapeType, {
-    [P in Property]: CreateQResult<Value, Value>;
-} & SubProperties> : QResult<SourceShapeType, {
-    [P in Property]: CreateQResult<Value, Value, '', SubProperties>;
-}> : CreateQResult<ParentSource, QResult<SourceShapeType, {
-    [P in Property]: CreateQResult<Value, Value>;
-} & SubProperties>, SourceProperty, {}, HasName> : Source extends QueryShapeSet<infer ShapeType, infer ParentSource, infer SourceProperty> ? CreateQResult<ParentSource, QResult<ShapeType, {
-    [P in Property]: CreateQResult<Value, Value, null, SubProperties>;
-}>[], SourceProperty, {}, HasName> : Value extends Shape ? QResult<Value, SubProperties> : NormaliseBoolean<Value>;
-type NormaliseBoolean<T> = [T] extends [boolean] ? boolean : T;
-export type CreateShapeSetQResult<ShapeType = undefined, Source = undefined, Property extends string | number | symbol = '', SubProperties = {}, HasName = false> = Source extends QueryShape<infer SourceShapeType, infer ParentSource> ? [
-    HasName,
-    ParentSource
-] extends [true, null] ? CreateQResult<Source, null, null>[] : ParentSource extends null ? QResult<SourceShapeType, {
-    [P in Property]: CreateQResult<Source, null, null, SubProperties>[];
-}> : CreateQResult<Source, null, null, {
-    [P in Property]: (ShapeType extends Shape ? QResult<ShapeType, SubProperties> : QResult<Shape, SubProperties>)[];
-}> : Source extends QueryShapeSet<infer ShapeType, infer ParentSource, infer SourceProperty> ? CreateQResult<ParentSource, QResult<ShapeType, {
-    [P in Property]: CreateQResult<ShapeType>[];
-}>[], SourceProperty, {}, HasName> : CreateQResult<ShapeType>;
-/**
- * Ignores the source and property, and returns the converted value
- */
-export type ObjectToPlainResult<T> = {
-    [P in keyof T]: QueryResponseToResultType<T[P], null, true>;
-};
-type GetNestedQueryResultType<Response, Source> = Source extends QueryBuilderObject ? GetQueryObjectResultType<Source, QueryResponseToResultType<Response>> : QueryResponseToResultType<Response>[];
-type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
-/**
- * ###################################
- * ####  QUERY BUILDING CLASSES   ####
- * ###################################
- */
-export declare class QueryBuilderObject<OriginalValue = any, Source = any, Property extends string | number | symbol = any> {
-    property?: PropertyShape;
-    subject?: QueryShape<any> | QueryShapeSet<any> | QueryPrimitiveSet;
-    wherePath?: WherePath;
-    protected originalValue?: OriginalValue;
-    protected source: Source;
-    protected prop: Property;
-    constructor(property?: PropertyShape, subject?: QueryShape<any> | QueryShapeSet<any> | QueryPrimitiveSet);
-    /**
-     * Create a Query Builder Object based on the requested PropertyShape
-     */
-    static generatePathValue(property: PropertyShape, subject: QueryShape<any> | QueryShapeSet<any> | QueryShape<any>): QueryBuilderObject;
-    getOriginalValue(): OriginalValue;
-    getPropertyStep(): QueryStep;
-    preloadFor<ShapeType extends Shape, CompQueryRes>(component: QueryComponentLike<ShapeType, CompQueryRes>): BoundComponent<this, CompQueryRes>;
-    /**
-     * Pagination is applied to a nested *select*, not to a bare traversal — use
-     * `p.friends.select(f => f.name).limit(n)`. Calling `.limit()` directly on a
-     * traversal would silently do nothing, so we fail loudly instead.
-     * (Top-level result pagination lives on the outer query builder.)
-     */
-    limit(lim: number): never;
-    /**
-     * Returns the path of properties that were requested to reach this value
-     */
-    getPropertyPath(currentPath?: QueryPropertyPath): QueryPropertyPath;
-}
-export declare class BoundComponent<Source extends QueryBuilderObject, CompQueryResult = any> extends QueryBuilderObject {
-    originalValue: QueryComponentLike<any, CompQueryResult>;
-    source: Source;
-    constructor(originalValue: QueryComponentLike<any, CompQueryResult>, source: Source);
-}
-export declare const processWhereClause: (validation: WhereClause<any>, shape?: any) => WherePath;
-/**
- * Evaluate a sort callback through the proxy and extract a SortByPath.
- * This is a standalone helper that replaces the need for the former SelectQueryFactory.sortBy().
- */
-export declare const evaluateSortCallback: <S extends Shape>(shape: ShapeConstructor<S>, sortFn: (p: any) => any, direction?: "ASC" | "DESC") => SortByPath;
-export declare class QueryShapeSet<S extends Shape = Shape, Source = any, Property extends string | number | symbol = any> extends QueryBuilderObject<ShapeSet<S>, Source, Property> {
-    queryShapes: CoreSet<QueryShape>;
-    private proxy;
-    constructor(_originalValue?: ShapeSet<S>, property?: PropertyShape, subject?: QueryShape<any> | QueryShapeSet<any>);
-    static create<S extends Shape = Shape>(originalValue: ShapeSet<S>, property: PropertyShape, subject: QueryShape<any> | QueryShapeSet<any>): any;
-    static proxifyShapeSet<T extends Shape = Shape>(queryShapeSet: QueryShapeSet<T>): any;
-    as<ShapeClass extends typeof Shape>(shape: ShapeClass): QShapeSet<InstanceType<ShapeClass>, Source, Property>;
-    add(item: any): void;
-    concat(other: QueryShapeSet): QueryShapeSet;
-    getOriginalValue(): ShapeSet<S>;
-    callPropertyShapeAccessor(propertyShape: PropertyShape): QueryShapeSet | QueryPrimitiveSet;
-    size(): SetSize<this>;
-    where(validation: WhereClause<S>): this;
-    select<QF = unknown>(subQueryFn: QueryBuildFn<S, QF>): FieldSet<QF, QueryShapeSet<S, Source, Property>>;
-    selectAll(): FieldSet<SelectAllQueryResponse<S>, QueryShapeSet<S, Source, Property>>;
-    some(validation: WhereClause<S>): ExistsCondition;
-    every(validation: WhereClause<S>): ExistsCondition;
-    none(validation: WhereClause<S>): ExistsCondition;
-    private buildPredicateExpression;
-}
-export declare class QueryShape<S extends Shape = Shape, Source = any, Property extends string | number | symbol = any> extends QueryBuilderObject<S, Source, Property> {
-    originalValue: S;
-    private proxy;
-    constructor(originalValue: S, property?: PropertyShape, subject?: QueryShape<any> | QueryShapeSet<any>);
-    get id(): string;
-    static create(original: Shape, property?: PropertyShape, subject?: QueryShape<any> | QueryShapeSet<any>): any;
-    private static proxifyQueryShape;
-    as<ShapeClass extends typeof Shape>(shape: ShapeClass): QShape<InstanceType<ShapeClass>, Source, Property>;
-    equals(otherValue: NodeReferenceValue | QShape<any> | PendingQueryContext): ExpressionNode;
-    oneOf(values: (NodeReferenceValue | QShape<any>)[]): ExpressionNode;
-    notOneOf(values: (NodeReferenceValue | QShape<any>)[]): ExpressionNode;
-    select<QF = unknown>(subQueryFn: QueryBuildFn<S, QF>): FieldSet<QF, QueryShape<S, Source, Property>>;
-    selectAll(): FieldSet<SelectAllQueryResponse<S>, QueryShape<S, Source, Property>>;
-}
-/**
- * Concrete query wrapper for JS primitive values (string, number, boolean, Date).
- *
- * Replaces the former abstract class + subclasses (QueryString, QueryNumber,
- * QueryBoolean, QueryDate) — the type parameter T carries the primitive type,
- * so separate subclasses are unnecessary.
- */
-export declare class QueryPrimitive<T, Source = any, Property extends string | number | symbol = any> extends QueryBuilderObject<T, Source, Property> {
-    originalValue?: T;
-    property?: PropertyShape;
-    subject?: QueryShape<any> | QueryShapeSet<any> | QueryPrimitiveSet;
-    constructor(originalValue?: T, property?: PropertyShape, subject?: QueryShape<any> | QueryShapeSet<any> | QueryPrimitiveSet);
-    equals(otherValue: JSPrimitive | QueryBuilderObject): ExpressionNode;
-    oneOf(values: (JSPrimitive | QueryBuilderObject)[]): ExpressionNode;
-    notOneOf(values: (JSPrimitive | QueryBuilderObject)[]): ExpressionNode;
-    where(validation: WhereClause<string>): this;
-}
-export declare class QueryPrimitiveSet<QPrimitive extends QueryPrimitive<any> = null> extends QueryBuilderObject<any, any, any> {
-    originalValue?: JSNonNullPrimitive[];
-    property?: PropertyShape;
-    subject?: QueryShapeSet<any> | QueryShape<any>;
-    contents: CoreSet<QPrimitive>;
-    constructor(originalValue?: JSNonNullPrimitive[], property?: PropertyShape, subject?: QueryShapeSet<any> | QueryShape<any>, items?: any);
-    add(item: any): void;
-    values(): QPrimitive[];
-    createNew(...args: any[]): this;
-    equals(other: any): ExpressionNode;
-    getPropertyStep(): QueryStep;
-    getPropertyPath(): QueryPropertyPath;
-    size(): SetSize<this>;
-}
-export declare class SetSize<Source = null> extends QueryPrimitive<number, Source> {
-    subject: QueryShapeSet | QueryShape | QueryPrimitiveSet;
-    countable?: QueryBuilderObject;
-    label?: string;
-    constructor(subject: QueryShapeSet | QueryShape | QueryPrimitiveSet, countable?: QueryBuilderObject, label?: string);
-    private toCountExpr;
-    equals(v: any): ExpressionNode;
-    eq(v: any): ExpressionNode;
-    neq(v: any): ExpressionNode;
-    notEquals(v: any): ExpressionNode;
-    gt(v: any): ExpressionNode;
-    greaterThan(v: any): ExpressionNode;
-    gte(v: any): ExpressionNode;
-    greaterThanOrEqual(v: any): ExpressionNode;
-    lt(v: any): ExpressionNode;
-    lessThan(v: any): ExpressionNode;
-    lte(v: any): ExpressionNode;
-    lessThanOrEqual(v: any): ExpressionNode;
-    as(label: string): this;
-    getPropertyPath(): QueryPropertyPath;
-}
-export {};