@_linked/core 1.1.0 → 1.2.0-next.20260302120536

package/lib/esm/shapes/Shape.js

@@ -5,6 +5,7 @@
  */
 import nextTick from 'next-tick';
 import { QueryShape, SelectQueryFactory, } from '../queries/SelectQuery.js';
+import { QueryParser } from '../queries/QueryParser.js';
 import { getPropertyShapeByLabel } from '../utils/ShapeClass.js';
 import { ShapeSet } from '../collections/ShapeSet.js';
 export class Shape {
@@ -68,8 +69,7 @@ export class Shape {
         const query = new SelectQueryFactory(this, _selectFn, subject);
         let p = new Promise((resolve, reject) => {
             nextTick(() => {
-                this.queryParser
-                    .selectQuery(query)
+                QueryParser.selectQuery(query)
                     .then((result) => {
                     resolve(result);
                 })
@@ -80,14 +80,20 @@ export class Shape {
         });
         return query.patchResultPromise(p);
     }
+    static selectAll(subject) {
+        const propertyLabels = this
+            .shape.getUniquePropertyShapes()
+            .map((propertyShape) => propertyShape.label);
+        return this.select(subject, (shape) => propertyLabels.map((label) => shape[label]));
+    }
     static update(id, updateObjectOrFn) {
-        return this.queryParser.updateQuery(id, updateObjectOrFn, this);
+        return QueryParser.updateQuery(id, updateObjectOrFn, this);
     }
     static create(updateObjectOrFn) {
-        return this.queryParser.createQuery(updateObjectOrFn, this);
+        return QueryParser.createQuery(updateObjectOrFn, this);
     }
     static delete(id) {
-        return this.queryParser.deleteQuery(id, this);
+        return QueryParser.deleteQuery(id, this);
     }
     static mapPropertyShapes(mapFunction) {
         let dummyShape = new this();

package/lib/esm/shapes/Shape.js.map

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

package/lib/esm/sparql/SparqlAlgebra.d.ts

@@ -0,0 +1,158 @@
+export type SparqlTerm = {
+    kind: 'variable';
+    name: string;
+} | {
+    kind: 'iri';
+    value: string;
+} | {
+    kind: 'literal';
+    value: string;
+    datatype?: string;
+    language?: string;
+};
+export type SparqlTriple = {
+    subject: SparqlTerm;
+    predicate: SparqlTerm;
+    object: SparqlTerm;
+};
+export type SparqlAlgebraNode = SparqlBGP | SparqlJoin | SparqlLeftJoin | SparqlFilter | SparqlUnion | SparqlMinus | SparqlExtend | SparqlGraph;
+export type SparqlBGP = {
+    type: 'bgp';
+    triples: SparqlTriple[];
+};
+export type SparqlJoin = {
+    type: 'join';
+    left: SparqlAlgebraNode;
+    right: SparqlAlgebraNode;
+};
+export type SparqlLeftJoin = {
+    type: 'left_join';
+    left: SparqlAlgebraNode;
+    right: SparqlAlgebraNode;
+    condition?: SparqlExpression;
+};
+export type SparqlFilter = {
+    type: 'filter';
+    expression: SparqlExpression;
+    inner: SparqlAlgebraNode;
+};
+export type SparqlUnion = {
+    type: 'union';
+    left: SparqlAlgebraNode;
+    right: SparqlAlgebraNode;
+};
+export type SparqlMinus = {
+    type: 'minus';
+    left: SparqlAlgebraNode;
+    right: SparqlAlgebraNode;
+};
+export type SparqlExtend = {
+    type: 'extend';
+    inner: SparqlAlgebraNode;
+    variable: string;
+    expression: SparqlExpression;
+};
+export type SparqlGraph = {
+    type: 'graph';
+    iri: string;
+    inner: SparqlAlgebraNode;
+};
+export type SparqlExpression = SparqlVariableExpr | SparqlIriExpr | SparqlLiteralExpr | SparqlBinaryExpr | SparqlLogicalExpr | SparqlNotExpr | SparqlFunctionExpr | SparqlAggregateExpr | SparqlExistsExpr | SparqlBoundExpr;
+export type SparqlVariableExpr = {
+    kind: 'variable_expr';
+    name: string;
+};
+export type SparqlIriExpr = {
+    kind: 'iri_expr';
+    value: string;
+};
+export type SparqlLiteralExpr = {
+    kind: 'literal_expr';
+    value: string;
+    datatype?: string;
+};
+export type SparqlBinaryExpr = {
+    kind: 'binary_expr';
+    op: string;
+    left: SparqlExpression;
+    right: SparqlExpression;
+};
+export type SparqlLogicalExpr = {
+    kind: 'logical_expr';
+    op: 'and' | 'or';
+    exprs: SparqlExpression[];
+};
+export type SparqlNotExpr = {
+    kind: 'not_expr';
+    inner: SparqlExpression;
+};
+export type SparqlFunctionExpr = {
+    kind: 'function_expr';
+    name: string;
+    args: SparqlExpression[];
+};
+export type SparqlAggregateExpr = {
+    kind: 'aggregate_expr';
+    name: string;
+    args: SparqlExpression[];
+    distinct?: boolean;
+};
+export type SparqlExistsExpr = {
+    kind: 'exists_expr';
+    pattern: SparqlAlgebraNode;
+    negated: boolean;
+};
+export type SparqlBoundExpr = {
+    kind: 'bound_expr';
+    variable: string;
+};
+export type SparqlProjectionItem = {
+    kind: 'variable';
+    name: string;
+} | {
+    kind: 'aggregate';
+    expression: SparqlAggregateExpr;
+    alias: string;
+} | {
+    kind: 'expression';
+    expression: SparqlExpression;
+    alias: string;
+};
+export type SparqlOrderCondition = {
+    expression: SparqlExpression;
+    direction: 'ASC' | 'DESC';
+};
+export type SparqlAggregateBinding = {
+    variable: string;
+    aggregate: SparqlAggregateExpr;
+};
+export type SparqlSelectPlan = {
+    type: 'select';
+    algebra: SparqlAlgebraNode;
+    projection: SparqlProjectionItem[];
+    distinct?: boolean;
+    orderBy?: SparqlOrderCondition[];
+    limit?: number;
+    offset?: number;
+    groupBy?: string[];
+    having?: SparqlExpression;
+    aggregates?: SparqlAggregateBinding[];
+};
+export type SparqlInsertDataPlan = {
+    type: 'insert_data';
+    triples: SparqlTriple[];
+    graph?: string;
+};
+export type SparqlDeleteInsertPlan = {
+    type: 'delete_insert';
+    deletePatterns: SparqlTriple[];
+    insertPatterns: SparqlTriple[];
+    whereAlgebra: SparqlAlgebraNode;
+    graph?: string;
+};
+export type SparqlDeleteWherePlan = {
+    type: 'delete_where';
+    patterns: SparqlAlgebraNode;
+    graph?: string;
+};
+export type SparqlPlan = SparqlSelectPlan | SparqlInsertDataPlan | SparqlDeleteInsertPlan | SparqlDeleteWherePlan;

package/lib/esm/sparql/SparqlAlgebra.js

@@ -0,0 +1,3 @@
+// --- Term types ---
+export {};
+//# sourceMappingURL=SparqlAlgebra.js.map

package/lib/esm/sparql/SparqlAlgebra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SparqlAlgebra.js","sourceRoot":"","sources":["../../../src/sparql/SparqlAlgebra.ts"],"names":[],"mappings":"AAAA,qBAAqB"}

package/lib/esm/sparql/SparqlStore.d.ts

@@ -0,0 +1,52 @@
+import type { IQuadStore } from '../interfaces/IQuadStore.js';
+import type { SelectQuery } from '../queries/SelectQuery.js';
+import type { CreateQuery } from '../queries/CreateQuery.js';
+import type { UpdateQuery } from '../queries/UpdateQuery.js';
+import type { DeleteQuery, DeleteResponse } from '../queries/DeleteQuery.js';
+import type { SelectResult, CreateResult, UpdateResult } from '../queries/IntermediateRepresentation.js';
+import type { SparqlJsonResults } from './resultMapping.js';
+import { type SparqlOptions } from './sparqlUtils.js';
+/**
+ * Abstract base class for SPARQL-backed quad stores.
+ *
+ * Handles the full pipeline: IR query → SPARQL string → execute → map results.
+ * Subclasses only need to implement the two transport methods:
+ * - `executeSparqlSelect` — send a SPARQL SELECT and return JSON results
+ * - `executeSparqlUpdate` — send a SPARQL UPDATE (INSERT DATA / DELETE..INSERT / etc.)
+ *
+ * Example subclass (Fuseki):
+ * ```ts
+ * class FusekiStore extends SparqlStore {
+ *   constructor(baseUrl: string, dataset: string) {
+ *     super({ dataRoot: 'http://data.example.org' });
+ *     this.queryEndpoint = `${baseUrl}/${dataset}/sparql`;
+ *     this.updateEndpoint = `${baseUrl}/${dataset}/update`;
+ *   }
+ *   protected async executeSparqlSelect(sparql: string) {
+ *     const res = await fetch(this.queryEndpoint, { ... });
+ *     return res.json();
+ *   }
+ *   protected async executeSparqlUpdate(sparql: string) {
+ *     await fetch(this.updateEndpoint, { ... });
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class SparqlStore implements IQuadStore {
+    protected options?: SparqlOptions;
+    constructor(options?: SparqlOptions);
+    /**
+     * Send a SPARQL SELECT/ASK/CONSTRUCT query and return the parsed
+     * SPARQL JSON Results (application/sparql-results+json).
+     */
+    protected abstract executeSparqlSelect(sparql: string): Promise<SparqlJsonResults>;
+    /**
+     * Send a SPARQL UPDATE request (INSERT DATA, DELETE/INSERT, etc.).
+     * No return value — the update is fire-and-forget at the SPARQL level.
+     */
+    protected abstract executeSparqlUpdate(sparql: string): Promise<void>;
+    selectQuery(query: SelectQuery): Promise<SelectResult>;
+    createQuery(query: CreateQuery): Promise<CreateResult>;
+    updateQuery(query: UpdateQuery): Promise<UpdateResult>;
+    deleteQuery(query: DeleteQuery): Promise<DeleteResponse>;
+}

package/lib/esm/sparql/SparqlStore.js

@@ -0,0 +1,77 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { selectToSparql, createToSparql, updateToSparql, deleteToSparql, } from './irToAlgebra.js';
+import { mapSparqlSelectResult, mapSparqlCreateResult, mapSparqlUpdateResult, } from './resultMapping.js';
+import { generateEntityUri } from './sparqlUtils.js';
+/**
+ * Abstract base class for SPARQL-backed quad stores.
+ *
+ * Handles the full pipeline: IR query → SPARQL string → execute → map results.
+ * Subclasses only need to implement the two transport methods:
+ * - `executeSparqlSelect` — send a SPARQL SELECT and return JSON results
+ * - `executeSparqlUpdate` — send a SPARQL UPDATE (INSERT DATA / DELETE..INSERT / etc.)
+ *
+ * Example subclass (Fuseki):
+ * ```ts
+ * class FusekiStore extends SparqlStore {
+ *   constructor(baseUrl: string, dataset: string) {
+ *     super({ dataRoot: 'http://data.example.org' });
+ *     this.queryEndpoint = `${baseUrl}/${dataset}/sparql`;
+ *     this.updateEndpoint = `${baseUrl}/${dataset}/update`;
+ *   }
+ *   protected async executeSparqlSelect(sparql: string) {
+ *     const res = await fetch(this.queryEndpoint, { ... });
+ *     return res.json();
+ *   }
+ *   protected async executeSparqlUpdate(sparql: string) {
+ *     await fetch(this.updateEndpoint, { ... });
+ *   }
+ * }
+ * ```
+ */
+export class SparqlStore {
+    constructor(options) {
+        this.options = options;
+    }
+    selectQuery(query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sparql = selectToSparql(query, this.options);
+            const json = yield this.executeSparqlSelect(sparql);
+            return mapSparqlSelectResult(json, query);
+        });
+    }
+    createQuery(query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const uri = generateEntityUri(query.data.shape, this.options);
+            query.data.id = uri;
+            const sparql = createToSparql(query, this.options);
+            yield this.executeSparqlUpdate(sparql);
+            return mapSparqlCreateResult(uri, query);
+        });
+    }
+    updateQuery(query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sparql = updateToSparql(query, this.options);
+            yield this.executeSparqlUpdate(sparql);
+            return mapSparqlUpdateResult(query);
+        });
+    }
+    deleteQuery(query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sparql = deleteToSparql(query, this.options);
+            yield this.executeSparqlUpdate(sparql);
+            return {
+                deleted: query.ids,
+                count: query.ids.length,
+            };
+        });
+    }
+}
+//# sourceMappingURL=SparqlStore.js.map

package/lib/esm/sparql/SparqlStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SparqlStore.js","sourceRoot":"","sources":["../../../src/sparql/SparqlStore.ts"],"names":[],"mappings":";;;;;;;;;AAWA,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,iBAAiB,EAAqB,MAAM,kBAAkB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAgB,WAAW;IAG/B,YAAY,OAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAgBK,WAAW,CAAC,KAAkB;;YAClC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACpD,OAAO,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;KAAA;IAEK,WAAW,CAAC,KAAkB;;YAClC,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;YACpB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;KAAA;IAEK,WAAW,CAAC,KAAkB;;YAClC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;KAAA;IAEK,WAAW,CAAC,KAAkB;;YAClC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,GAAG;gBAClB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;KAAA;CACF"}

package/lib/esm/sparql/algebraToString.d.ts

@@ -0,0 +1,13 @@
+import { SparqlAlgebraNode, SparqlExpression, SparqlTerm, SparqlSelectPlan, SparqlInsertDataPlan, SparqlDeleteInsertPlan, SparqlDeleteWherePlan } from './SparqlAlgebra.js';
+import { SparqlOptions } from './sparqlUtils.js';
+type UriCollector = {
+    uris: Set<string>;
+};
+export declare function serializeTerm(term: SparqlTerm, collector?: UriCollector): string;
+export declare function serializeExpression(expr: SparqlExpression, collector?: UriCollector): string;
+export declare function serializeAlgebraNode(node: SparqlAlgebraNode, collector?: UriCollector): string;
+export declare function selectPlanToSparql(plan: SparqlSelectPlan, _options?: SparqlOptions): string;
+export declare function insertDataPlanToSparql(plan: SparqlInsertDataPlan, _options?: SparqlOptions): string;
+export declare function deleteInsertPlanToSparql(plan: SparqlDeleteInsertPlan, _options?: SparqlOptions): string;
+export declare function deleteWherePlanToSparql(plan: SparqlDeleteWherePlan, _options?: SparqlOptions): string;
+export {};

package/lib/esm/sparql/algebraToString.js

@@ -0,0 +1,289 @@
+import { formatUri, formatLiteral, escapeSparqlString, collectPrefixes, } from './sparqlUtils.js';
+function collectUri(collector, uri) {
+    collector.uris.add(uri);
+}
+// ---------------------------------------------------------------------------
+// Term serialization
+// ---------------------------------------------------------------------------
+export function serializeTerm(term, collector) {
+    switch (term.kind) {
+        case 'variable':
+            return `?${term.name}`;
+        case 'iri':
+            if (collector)
+                collectUri(collector, term.value);
+            return formatUri(term.value);
+        case 'literal': {
+            if (term.language) {
+                return `"${escapeSparqlString(term.value)}"@${term.language}`;
+            }
+            if (term.datatype) {
+                if (collector)
+                    collectUri(collector, term.datatype);
+            }
+            return formatLiteral(term.value, term.datatype);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Triple serialization
+// ---------------------------------------------------------------------------
+function serializeTriple(triple, collector) {
+    const s = serializeTerm(triple.subject, collector);
+    const p = serializeTerm(triple.predicate, collector);
+    const o = serializeTerm(triple.object, collector);
+    return `${s} ${p} ${o}`;
+}
+function serializeTriples(triples, collector) {
+    return triples
+        .map((t) => serializeTriple(t, collector) + ' .')
+        .join('\n');
+}
+// ---------------------------------------------------------------------------
+// Expression serialization
+// ---------------------------------------------------------------------------
+export function serializeExpression(expr, collector) {
+    switch (expr.kind) {
+        case 'variable_expr':
+            return `?${expr.name}`;
+        case 'iri_expr':
+            if (collector)
+                collectUri(collector, expr.value);
+            return formatUri(expr.value);
+        case 'literal_expr': {
+            if (expr.datatype && collector)
+                collectUri(collector, expr.datatype);
+            return formatLiteral(expr.value, expr.datatype);
+        }
+        case 'binary_expr': {
+            const left = serializeExpression(expr.left, collector);
+            const right = serializeExpression(expr.right, collector);
+            return `${left} ${expr.op} ${right}`;
+        }
+        case 'logical_expr': {
+            const op = expr.op === 'and' ? '&&' : '||';
+            const parts = expr.exprs.map((e) => {
+                const s = serializeExpression(e, collector);
+                // Parenthesize OR children inside AND (AND binds tighter than OR)
+                if (expr.op === 'and' && e.kind === 'logical_expr' && e.op === 'or') {
+                    return `(${s})`;
+                }
+                return s;
+            });
+            return parts.join(` ${op} `);
+        }
+        case 'not_expr':
+            return `!(${serializeExpression(expr.inner, collector)})`;
+        case 'function_expr': {
+            const args = expr.args
+                .map((a) => serializeExpression(a, collector))
+                .join(', ');
+            return `${expr.name}(${args})`;
+        }
+        case 'aggregate_expr': {
+            const args = expr.args
+                .map((a) => serializeExpression(a, collector))
+                .join(', ');
+            const distinctPrefix = expr.distinct ? 'DISTINCT ' : '';
+            return `${expr.name}(${distinctPrefix}${args})`;
+        }
+        case 'exists_expr': {
+            const inner = serializeAlgebraNode(expr.pattern, collector);
+            const prefix = expr.negated ? 'NOT EXISTS' : 'EXISTS';
+            return `${prefix} {\n${indent(inner)}\n}`;
+        }
+        case 'bound_expr':
+            return `BOUND(?${expr.variable})`;
+    }
+}
+// ---------------------------------------------------------------------------
+// Algebra node serialization
+// ---------------------------------------------------------------------------
+export function serializeAlgebraNode(node, collector) {
+    switch (node.type) {
+        case 'bgp':
+            return serializeTriples(node.triples, collector);
+        case 'join': {
+            const left = serializeAlgebraNode(node.left, collector);
+            const right = serializeAlgebraNode(node.right, collector);
+            return `${left}\n${right}`;
+        }
+        case 'left_join': {
+            const left = serializeAlgebraNode(node.left, collector);
+            const right = serializeAlgebraNode(node.right, collector);
+            let optionalBlock = `OPTIONAL {\n${indent(right)}\n}`;
+            if (node.condition) {
+                const cond = serializeExpression(node.condition, collector);
+                // OPTIONAL with filter: OPTIONAL { pattern FILTER(cond) }
+                // Re-build to include filter inside the OPTIONAL block
+                optionalBlock = `OPTIONAL {\n${indent(right)}\n  FILTER(${cond})\n}`;
+            }
+            // If left side is empty (e.g. UPDATE WHERE with all-OPTIONAL triples),
+            // omit the empty prefix to avoid blank lines
+            return left ? `${left}\n${optionalBlock}` : optionalBlock;
+        }
+        case 'filter': {
+            const inner = serializeAlgebraNode(node.inner, collector);
+            const expr = serializeExpression(node.expression, collector);
+            return `${inner}\nFILTER(${expr})`;
+        }
+        case 'union': {
+            const left = serializeAlgebraNode(node.left, collector);
+            const right = serializeAlgebraNode(node.right, collector);
+            return `{\n${indent(left)}\n}\nUNION\n{\n${indent(right)}\n}`;
+        }
+        case 'minus': {
+            const left = serializeAlgebraNode(node.left, collector);
+            const right = serializeAlgebraNode(node.right, collector);
+            return `${left}\nMINUS {\n${indent(right)}\n}`;
+        }
+        case 'extend': {
+            const inner = serializeAlgebraNode(node.inner, collector);
+            const expr = serializeExpression(node.expression, collector);
+            return `${inner}\nBIND(${expr} AS ?${node.variable})`;
+        }
+        case 'graph': {
+            if (collector)
+                collectUri(collector, node.iri);
+            const inner = serializeAlgebraNode(node.inner, collector);
+            return `GRAPH ${formatUri(node.iri)} {\n${indent(inner)}\n}`;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function indent(text, level = 1) {
+    const prefix = '  '.repeat(level);
+    return text
+        .split('\n')
+        .map((line) => prefix + line)
+        .join('\n');
+}
+function buildPrefixBlock(usedUris) {
+    const prefixes = collectPrefixes([...usedUris]);
+    const lines = Object.entries(prefixes)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([prefix, uri]) => `PREFIX ${prefix}: <${uri}>`);
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Top-level plan serializers
+// ---------------------------------------------------------------------------
+export function selectPlanToSparql(plan, _options) {
+    const collector = { uris: new Set() };
+    // 1. Serialize WHERE body
+    const body = serializeAlgebraNode(plan.algebra, collector);
+    // 2. Build SELECT line
+    const projectionParts = plan.projection.map((item) => {
+        if (item.kind === 'variable') {
+            return `?${item.name}`;
+        }
+        else {
+            // aggregate or expression projection: (expr AS ?alias)
+            const expr = serializeExpression(item.expression, collector);
+            return `(${expr} AS ?${item.alias})`;
+        }
+    });
+    const distinctStr = plan.distinct ? 'DISTINCT ' : '';
+    const selectLine = `SELECT ${distinctStr}${projectionParts.join(' ')}`;
+    // 3. Build WHERE block
+    const whereBlock = `WHERE {\n${indent(body)}\n}`;
+    // 4. Build trailing clauses
+    const clauses = [];
+    if (plan.groupBy && plan.groupBy.length > 0) {
+        clauses.push(`GROUP BY ${plan.groupBy.map((v) => `?${v}`).join(' ')}`);
+    }
+    if (plan.having) {
+        const havingExpr = serializeExpression(plan.having, collector);
+        clauses.push(`HAVING(${havingExpr})`);
+    }
+    if (plan.orderBy && plan.orderBy.length > 0) {
+        const orderParts = plan.orderBy.map((cond) => {
+            const expr = serializeExpression(cond.expression, collector);
+            return `${cond.direction}(${expr})`;
+        });
+        clauses.push(`ORDER BY ${orderParts.join(' ')}`);
+    }
+    if (plan.limit !== undefined) {
+        clauses.push(`LIMIT ${plan.limit}`);
+    }
+    if (plan.offset !== undefined) {
+        clauses.push(`OFFSET ${plan.offset}`);
+    }
+    // 5. Build PREFIX block (after collecting all URIs)
+    const prefixBlock = buildPrefixBlock(collector.uris);
+    // 6. Assemble
+    const parts = [];
+    if (prefixBlock)
+        parts.push(prefixBlock);
+    parts.push(selectLine);
+    parts.push(whereBlock);
+    parts.push(...clauses);
+    return parts.join('\n');
+}
+export function insertDataPlanToSparql(plan, _options) {
+    const collector = { uris: new Set() };
+    let triplesStr;
+    if (plan.graph) {
+        if (collector)
+            collectUri(collector, plan.graph);
+        const innerTriples = serializeTriples(plan.triples, collector);
+        triplesStr = `GRAPH ${formatUri(plan.graph)} {\n${indent(innerTriples)}\n}`;
+    }
+    else {
+        triplesStr = serializeTriples(plan.triples, collector);
+    }
+    const body = `INSERT DATA {\n${indent(triplesStr)}\n}`;
+    const prefixBlock = buildPrefixBlock(collector.uris);
+    const parts = [];
+    if (prefixBlock)
+        parts.push(prefixBlock);
+    parts.push(body);
+    return parts.join('\n');
+}
+export function deleteInsertPlanToSparql(plan, _options) {
+    const collector = { uris: new Set() };
+    // DELETE block
+    const deleteTriples = serializeTriples(plan.deletePatterns, collector);
+    const deletePart = `DELETE {\n${indent(deleteTriples)}\n}`;
+    // INSERT block (may be empty)
+    let insertPart = '';
+    if (plan.insertPatterns.length > 0) {
+        const insertTriples = serializeTriples(plan.insertPatterns, collector);
+        insertPart = `INSERT {\n${indent(insertTriples)}\n}\n`;
+    }
+    // WHERE block
+    const whereBody = serializeAlgebraNode(plan.whereAlgebra, collector);
+    const wherePart = `WHERE {\n${indent(whereBody)}\n}`;
+    const prefixBlock = buildPrefixBlock(collector.uris);
+    const parts = [];
+    if (prefixBlock)
+        parts.push(prefixBlock);
+    parts.push(deletePart);
+    if (insertPart)
+        parts.push(insertPart.trimEnd());
+    parts.push(wherePart);
+    return parts.join('\n');
+}
+export function deleteWherePlanToSparql(plan, _options) {
+    const collector = { uris: new Set() };
+    const body = serializeAlgebraNode(plan.patterns, collector);
+    let content;
+    if (plan.graph) {
+        if (collector)
+            collectUri(collector, plan.graph);
+        content = `GRAPH ${formatUri(plan.graph)} {\n${indent(body)}\n}`;
+    }
+    else {
+        content = body;
+    }
+    const result = `DELETE WHERE {\n${indent(content)}\n}`;
+    const prefixBlock = buildPrefixBlock(collector.uris);
+    const parts = [];
+    if (prefixBlock)
+        parts.push(prefixBlock);
+    parts.push(result);
+    return parts.join('\n');
+}
+//# sourceMappingURL=algebraToString.js.map