@_linked/core 1.0.0-next.20260224083238 → 1.1.0

package/CHANGELOG.md

@@ -1,19 +1,9 @@
 # Changelog
 
-## 1.0.0
-
-### Major Changes
-
-- [#1](https://github.com/Semantu/linked/pull/1) [`0938ede`](https://github.com/Semantu/linked/commit/0938edec623e9d611767ae150b8d60270035ffeb) Thanks [@flyon](https://github.com/flyon)! - first major release
+## 1.1.0
 
 ### Minor Changes
 
-- [#9](https://github.com/Semantu/linked/pull/9) [`381067b`](https://github.com/Semantu/linked/commit/381067b0fbc25f4a0446c5f8cc0eec57ddded466) Thanks [@flyon](https://github.com/flyon)! - Introduce canonical Intermediate Representation (IR) support for query and mutation objects.
-
-  - Add select-query IR pipeline stages (desugar, canonicalize, projection, alias scope, pipeline helpers) and expose `getCanonicalIR()` on select factories.
-  - Add canonical mutation IR conversion for create/update/delete query objects.
-  - Add IR documentation and parity/golden test coverage for select and mutation conversion behavior.
-
 - [#4](https://github.com/Semantu/linked/pull/4) [`c35e686`](https://github.com/Semantu/linked/commit/c35e6861600d7aa8683b4b288fc4d1dc74c4aff2) Thanks [@flyon](https://github.com/flyon)! - - Added `Shape.selectAll()` plus nested `selectAll()` support on sub-queries.
   - Added inherited property deduplication via `NodeShape.getUniquePropertyShapes()` so subclass overrides win by label and are selected once.
   - Improved `selectAll()` type inference (including nested queries) and excluded base `Shape` keys from inferred results.
@@ -21,7 +11,9 @@
   - Fixed `createPropertyShape` to preserve explicit `minCount: 0` / `maxCount: 0`.
   - Expanded tests and README documentation for `selectAll`, CRUD return types, and multi-value update semantics.
 
-### 1.0.0 (from LINCD.js)
+## 1.0.0
+
+### Major Changes
 
 This is a rebranding + extraction release. It moves the core query/shape system into `@_linked/core` and removes RDF models and React-specific code.
 

package/README.md

@@ -1,7 +1,7 @@
 # @_linked/core
 Core Linked package for the query DSL, SHACL shape decorators/metadata, and package registration.
 
-Linked core gives you a type-safe, schema-parameterized query language and SHACL-driven Shape classes for linked data. It compiles queries into a normalized [Intermediate Representation (IR)](./documentation/intermediate-representation.md) that can be executed by any store.
+Linked core gives you a type-safe, schema-parameterized query language and SHACL-driven Shape classes for linked data. It compiles queries into a plain JS query object that can be executed by a store.
 
 ## Linked core offers
 
@@ -27,10 +27,6 @@ import {linkedPackage} from '@_linked/core/utils/Package';
 - `@_linked/rdf-mem-store`: in-memory RDF store that implements `IQuadStore`.
 - `@_linked/react`: React bindings for Linked queries and shapes.
 
-## Documentation
-
-- [Intermediate Representation (IR)](./documentation/intermediate-representation.md)
-
 ## Linked Package Setup
 
 Linked packages expose shapes, utilities, and ontologies through a small `package.ts` file. This makes module exports discoverable across Linked modules and enables linked decorators.
@@ -89,35 +85,41 @@ export class Person extends Shape {
 ## Queries: Create, Select, Update, Delete
 
 Queries are expressed with the same Shape classes and compile to a query object that a store executes.
-Use this section as a quick start. Detailed query variations are documented in `Query examples` below.
-
-A few quick examples:
 
-**1) Select one field for all matching nodes**
 ```typescript
+/* Result: Array<{id: string; name: string}> */
 const names = await Person.select((p) => p.name);
-/* names: {id: string; name: string}[] */
-```
 
-**2) Select all decorated fields of nested related nodes**
-```typescript
-const allFriends = await Person.select((p) => p.knows.selectAll());
-/* allFriends: {
-  id?: string; 
-  knows: {
-    id?: string; 
-    ...all decorated Person fields...
-  }[]
-	}[] */
-```
-
-**3) Apply a simple mutation**
-```typescript
 const myNode = {id: 'https://my.app/node1'};
+/* Result: {id: string; name: string} | null */
+const person = await Person.select(myNode, (p) => p.name);
+const missing = await Person.select({id: 'https://my.app/missing'}, (p) => p.name); // null
+
+/* Result: {id: string} & UpdatePartial<Person> */
+const created = await Person.create({
+  name: 'Alice',
+  knows: [{id: 'https://my.app/node2'}],
+});
+
 const updated = await Person.update(myNode, {
   name: 'Alicia',
 });
-/* updated: {id: string} & UpdatePartial<Person> */
+
+// Overwrite a multi-value property
+const overwriteFriends = await Person.update(myNode, {
+  knows: [{id: 'https://my.app/node2'}],
+});
+
+// Add/remove items in a multi-value property
+const addRemoveFriends = await Person.update(myNode, {
+  knows: {
+    add: [{id: 'https://my.app/node3'}],
+    remove: [{id: 'https://my.app/node2'}],
+  },
+});
+
+/* Result: {deleted: Array<{id: string}>, count: number} */
+await Person.delete(myNode);
 ```
 
 ## Storage configuration
@@ -170,13 +172,10 @@ Result types are inferred from your Shape definitions and the selected paths. Ex
 
 #### Basic selection
 ```typescript
-/* names: {id: string; name: string}[] */
+/* Result: Array<{id: string; name: string}> */
 const names = await Person.select((p) => p.name);
 
-/* friends: {
-  id: string; 
-  knows: { id: string }[]
-}[] */
+/* Result: Array<{id: string; knows: Array<{id: string}>}> */
 const friends = await Person.select((p) => p.knows);
 
 const dates = await Person.select((p) => [p.birthDate, p.name]);
@@ -203,12 +202,6 @@ const deep = await Person.select((p) => p.knows.bestFriend.name);
 const detailed = await Person.select((p) =>
   p.knows.select((f) => f.name),
 );
-
-const allPeople = await Person.selectAll();
-
-const detailedAll = await Person.select((p) =>
-  p.knows.selectAll(),
-);
 ```
 
 #### Where + equals
@@ -268,9 +261,7 @@ const custom = await Person.select((p) => ({
 }));
 ```
 
-#### Query As (type casting to a sub shape)
-If person.pets returns an array of Pets. And Dog extends Pet.
-And you want to select properties of those pets that are dogs:
+#### Query As (type casting)
 ```typescript
 const guards = await Person.select((p) => p.pets.as(Dog).guardDogLevel);
 ```
@@ -302,171 +293,34 @@ const preloaded = await Person.select((p) => [
 ]);
 ```
 
-#### Create
-
+#### Create / Update / Delete
 ```typescript
 /* Result: {id: string} & UpdatePartial<Person> */
 const created = await Person.create({name: 'Alice'});
-```
-Where UpdatePartial<Shape> reflects the created properties.
 
-#### Update
-
-Update will patch any property that you send as payload and leave the rest untouched.
-```typescript
-/* Result: {id: string} & UpdatePartial<Person> */
 const updated = await Person.update({id: 'https://my.app/node1'}, {name: 'Alicia'});
-```
-Returns:
-```json
-{
-  id:"https://my.app/node1",
-  name:"Alicia"
-}
-```
-
-**Updating multi-value properties**
-When updating a property that holds multiple values (one that returns an array in the results), you can either overwrite all the values with a new explicit array of values, or delete from/add to the current values.
 
-To overwrite all values:
-```typescript
-// Overwrite the full set of "knows" values.
-const overwriteFriends = await Person.update({id: 'https://my.app/person1'}, {
-  knows: [{id: 'https://my.app/person2'}],
+// Overwrite a multi-value property
+const overwriteFriends = await Person.update({id: 'https://my.app/node1'}, {
+  knows: [{id: 'https://my.app/node2'}],
 });
-```
-The result will contain an object with `updatedTo`, to indicate that previous values were overwritten to this new set of values:
-```json
-{
-  id: "https://my.app/person1",
-  knows: {
-    updatedTo: [{id:"https://my.app/person2"}],
-  }
-}
-``` 
 
-To make incremental changes to the current set of values you can provide an object with `add` and/or `remove` keys:
-```typescript
-// Add one value and remove one value without replacing the whole set.
-const addRemoveFriends = await Person.update({id: 'https://my.app/person1'}, {
+// Add/remove items in a multi-value property
+const addRemoveFriends = await Person.update({id: 'https://my.app/node1'}, {
   knows: {
-    add: [{id: 'https://my.app/person2'}],
-    remove: [{id: 'https://my.app/person3'}],
+    add: [{id: 'https://my.app/node3'}],
+    remove: [{id: 'https://my.app/node2'}],
   },
 });
-```
-This returns an object with the added and removed items
-```json
-{
-  id: "https://my.app/person1",
-  knows: {
-    added?: [{id:"https://my.app/person2"},
-    removed?: [{id:"https://my.app/person3"}],
-  }
-}
-```
 
-
-#### Delete
-To delete a node entirely:
-
-```typescript
-/* Result: {deleted: Array<{id: string}>, count: number} */
-const deleted = await Person.delete({id: 'https://my.app/node1'});
-```
-Returns
-```json
-{
-  deleted:[
-    {id:"https://my.app/node1"}
-  ],
-  count:1
-}
-```
-
-To delete multiple nodes pass an array:
-
-```typescript
-/* Result: {deleted: Array<{id: string}>, count: number} */
-const deleted = await Person.delete([{id: 'https://my.app/node1'},{id: 'https://my.app/node2'}]);
+await Person.delete({id: 'https://my.app/node1'});
 ```
 
-
-## Extending shapes
-
-Shape classes can extend other shape classes. Subclasses inherit property shapes from their superclasses and may override them.
-This example assumes `Person` from the `Shapes` section above.
-
-```typescript
-import {literalProperty} from '@_linked/core/shapes/SHACL';
-import {createNameSpace} from '@_linked/core/utils/NameSpace';
-import {linkedShape} from './package';
-
-const schema = createNameSpace('https://schema.org/');
-const EmployeeClass = schema('Employee');
-const name = schema('name');
-const employeeId = schema('employeeId');
-
-@linkedShape
-export class Employee extends Person {
-  static targetClass = EmployeeClass;
-
-  // Override inherited "name" with stricter constraints (still maxCount: 1)
-  @literalProperty({path: name, required: true, minLength: 2, maxCount: 1})
-  declare name: string;
-
-  @literalProperty({path: employeeId, required: true, maxCount: 1})
-  declare employeeId: string;
-}
-```
-
-Override behavior:
-
-- `NodeShape.getUniquePropertyShapes()` returns one property shape per label, with subclass overrides taking precedence.
-- Overrides must be tighten-only for `minCount`, `maxCount`, and `nodeKind` (widening is rejected at registration time).
-- If an override omits `minCount`, `maxCount`, or `nodeKind`, inherited values are kept.
-- Current scope: compatibility checks for `datatype`, `class`, and `pattern` are not enforced yet.
-
 ## TODO
 
 - Allow `preloadFor` to accept another query (not just a component).
 - Make and expose functions for auto syncing shapes to the graph.
 
-## Intermediate Representation (IR)
-
-Every Linked query compiles to a plain, JSON-serializable JavaScript object — the **Intermediate Representation**. This IR is the contract between the DSL and any storage backend. A store receives these objects and translates them into its native query language (SPARQL, SQL, etc.).
-
-For example, this DSL call:
-
-```typescript
-const names = await Person.select((p) => p.name);
-```
-
-produces the following IR object, which is passed to your store's `selectQuery()` method:
-
-```json
-{
-  "kind": "select",
-  "root": {"kind": "shape_scan", "shape": "https://schema.org/Person", "alias": "a0"},
-  "patterns": [],
-  "projection": [
-    {
-      "alias": "a1",
-      "expression": {"kind": "property_expr", "sourceAlias": "a0", "property": "https://schema.org/name"}
-    }
-  ],
-  "resultMap": [{"key": "name", "alias": "a1"}],
-  "singleResult": false
-}
-```
-
-All IR types are available from `@_linked/core/queries/IntermediateRepresentation`. See the full [Intermediate Representation docs](./documentation/intermediate-representation.md) for the complete type reference, examples, and a store implementer guide.
-
-**Store packages:**
-
-- `@_linked/sparql-store` — SPARQL endpoint store (coming soon)
-- `@_linked/rdf-mem-store` — in-memory RDF store
-
 ## Changelog
 
 See [CHANGELOG.md](./CHANGELOG.md).

package/lib/cjs/index.js

@@ -61,7 +61,6 @@ const DeleteQuery = __importStar(require("./queries/DeleteQuery.js"));
 const CreateQuery = __importStar(require("./queries/CreateQuery.js"));
 const QueryParser = __importStar(require("./queries/QueryParser.js"));
 const QueryFactory = __importStar(require("./queries/QueryFactory.js"));
-const IntermediateRepresentation = __importStar(require("./queries/IntermediateRepresentation.js"));
 const NameSpace = __importStar(require("./utils/NameSpace.js"));
 const ShapeClass = __importStar(require("./utils/ShapeClass.js"));
 const cached = __importStar(require("./utils/cached.js"));
@@ -104,7 +103,6 @@ function initModularApp() {
         CreateQuery,
         QueryParser,
         QueryFactory,
-        IntermediateRepresentation,
         SHACLShapes,
         rdf,
         rdfs,

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,wCAgDC;AAzFD;;;;GAIG;AACH,4DAA8C;AAC9C,kFAAoE;AACpE,gFAAkE;AAClE,wEAA0D;AAC1D,kEAAoD;AACpD,kEAAoD;AACpD,yDAA2C;AAC3C,+DAAiD;AACjD,oEAAsD;AACtD,0DAA4C;AAC5C,oDAAsC;AACtC,sEAAwD;AACxD,sEAAwD;AACxD,0EAA4D;AAC5D,sEAAwD;AACxD,sEAAwD;AACxD,sEAAwD;AACxD,wEAA0D;AAC1D,oGAAsF;AACtF,gEAAkD;AAClD,kEAAoD;AACpD,0DAA4C;AAC5C,uDAAyC;AACzC,6EAA+D;AAC/D,uEAAyD;AACzD,uEAAyD;AACzD,yDAA2C;AAC3C,2DAA6C;AAC7C,yDAA2C;AAC3C,6DAA+C;AAC/C,6DAA+C;AAC/C,yDAA2C;AAC3C,yDAA2C;AAC3C,0DAAiC;AACzB,mBADD,mBAAQ,CACC;AAEhB,SAAgB,cAAc;IAC5B,IAAI,WAAW,GAAG;QAChB,OAAO;QACP,kBAAkB;QAClB,iBAAiB;QACjB,aAAa;QACb,OAAO;QACP,OAAO;QACP,KAAK;QACL,QAAQ;QACR,MAAM;QACN,SAAS;QACT,MAAM;QACN,GAAG;QACH,UAAU;QACV,IAAI;QACJ,aAAa;QACb,UAAU;QACV,UAAU;QACV,WAAW;QACX,WAAW;QACX,aAAa;QACb,WAAW;QACX,WAAW;QACX,WAAW;QACX,YAAY;QACZ,0BAA0B;QAC1B,WAAW;QACX,GAAG;QACH,IAAI;QACJ,GAAG;QACH,KAAK;QACL,KAAK;QACL,GAAG;QACH,GAAG;KACJ,CAAC;IACF,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,KAAK,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3C,KAAK,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;YACtC,WAAW,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,wCA+CC;AAvFD;;;;GAIG;AACH,4DAA8C;AAC9C,kFAAoE;AACpE,gFAAkE;AAClE,wEAA0D;AAC1D,kEAAoD;AACpD,kEAAoD;AACpD,yDAA2C;AAC3C,+DAAiD;AACjD,oEAAsD;AACtD,0DAA4C;AAC5C,oDAAsC;AACtC,sEAAwD;AACxD,sEAAwD;AACxD,0EAA4D;AAC5D,sEAAwD;AACxD,sEAAwD;AACxD,sEAAwD;AACxD,wEAA0D;AAC1D,gEAAkD;AAClD,kEAAoD;AACpD,0DAA4C;AAC5C,uDAAyC;AACzC,6EAA+D;AAC/D,uEAAyD;AACzD,uEAAyD;AACzD,yDAA2C;AAC3C,2DAA6C;AAC7C,yDAA2C;AAC3C,6DAA+C;AAC/C,6DAA+C;AAC/C,yDAA2C;AAC3C,yDAA2C;AAC3C,0DAAiC;AACzB,mBADD,mBAAQ,CACC;AAEhB,SAAgB,cAAc;IAC5B,IAAI,WAAW,GAAG;QAChB,OAAO;QACP,kBAAkB;QAClB,iBAAiB;QACjB,aAAa;QACb,OAAO;QACP,OAAO;QACP,KAAK;QACL,QAAQ;QACR,MAAM;QACN,SAAS;QACT,MAAM;QACN,GAAG;QACH,UAAU;QACV,IAAI;QACJ,aAAa;QACb,UAAU;QACV,UAAU;QACV,WAAW;QACX,WAAW;QACX,aAAa;QACb,WAAW;QACX,WAAW;QACX,WAAW;QACX,YAAY;QACZ,WAAW;QACX,GAAG;QACH,IAAI;QACJ,GAAG;QACH,KAAK;QACL,KAAK;QACL,GAAG;QACH,GAAG;KACJ,CAAC;IACF,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,KAAK,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3C,KAAK,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;YACtC,WAAW,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

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

@@ -1,26 +1,14 @@
-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';
-/**
- * Store interface for executing IR queries.
- *
- * Implement this interface to back Linked with a custom storage engine
- * (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
- * DSL-level TypeScript result type back to the caller — the store only
- * needs to produce data that matches the structural result types.
- */
+import { CreateQuery } from '../queries/CreateQuery.js';
+import { DeleteQuery, DeleteResponse } from '../queries/DeleteQuery.js';
+import { SelectQuery } from '../queries/SelectQuery.js';
+import { UpdateQuery } from '../queries/UpdateQuery.js';
 export interface IQuadStore {
     /**
      * Prepares the store to be used.
      */
     init?(): Promise<any>;
-    selectQuery(query: SelectQuery): Promise<SelectResult>;
-    updateQuery?(query: UpdateQuery): Promise<UpdateResult>;
-    createQuery?(query: CreateQuery): Promise<CreateResult>;
+    selectQuery<ResultType>(query: SelectQuery<any>): Promise<ResultType>;
+    updateQuery?<RType>(q: UpdateQuery<RType>): Promise<RType>;
+    createQuery?<R>(q: CreateQuery<R>): Promise<R>;
     deleteQuery?(query: DeleteQuery): Promise<DeleteResponse>;
 }

package/lib/cjs/interfaces/IQueryParser.d.ts

@@ -0,0 +1,13 @@
+import { GetQueryResponseType, QueryResponseToResultType, SelectQueryFactory } from '../queries/SelectQuery.js';
+import { Shape } from '../shapes/Shape.js';
+import { AddId, NodeReferenceValue, UpdatePartial } from '../queries/QueryFactory.js';
+import { CreateResponse } from '../queries/CreateQuery.js';
+import { NodeId } from '../queries/MutationQuery.js';
+import { DeleteResponse } from '../queries/DeleteQuery.js';
+export interface IQueryParser {
+    selectQuery<ShapeType extends Shape, ResponseType, Source, ResultType = QueryResponseToResultType<GetQueryResponseType<SelectQueryFactory<ShapeType, ResponseType>>, ShapeType>[]>(query: SelectQueryFactory<ShapeType, ResponseType, Source>): Promise<ResultType>;
+    updateQuery<ShapeType extends Shape, U extends UpdatePartial<ShapeType>>(id: string | NodeReferenceValue, updateObjectOrFn: U, shapeClass: typeof Shape): Promise<AddId<U>>;
+    createQuery<ShapeType extends Shape, U extends UpdatePartial<ShapeType>>(updateObjectOrFn: U, shapeClass: typeof Shape): Promise<CreateResponse<U>>;
+    deleteQuery(id: NodeId | NodeId[] | NodeReferenceValue[], shapeClass: typeof Shape): Promise<DeleteResponse>;
+}
+export declare function staticImplements<T>(): <U extends T>(constructor: U) => void;

package/lib/cjs/interfaces/IQueryParser.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.staticImplements = staticImplements;
+/* class decorator */
+function staticImplements() {
+    return (constructor) => {
+        constructor;
+    };
+}
+//# sourceMappingURL=IQueryParser.js.map

package/lib/cjs/interfaces/IQueryParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IQueryParser.js","sourceRoot":"","sources":["../../../src/interfaces/IQueryParser.ts"],"names":[],"mappings":";;AA8CA,4CAIC;AALD,qBAAqB;AACrB,SAAgB,gBAAgB;IAC9B,OAAO,CAAc,WAAc,EAAE,EAAE;QACrC,WAAW,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

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

@@ -1,17 +1,18 @@
 import { Shape } from '../shapes/Shape.js';
+import { NodeShape } from '../shapes/SHACL.js';
+import { LinkedQuery } from './SelectQuery.js';
 import { AddId, NodeDescriptionValue, UpdatePartial } from './QueryFactory.js';
 import { MutationQueryFactory } from './MutationQuery.js';
-import { IRCreateMutation } from './IntermediateRepresentation.js';
-/**
- * The canonical CreateQuery type — an IR AST node representing a create mutation.
- * This is the type received by IQuadStore.createQuery().
- */
-export type CreateQuery = IRCreateMutation;
+export interface CreateQuery<ResponseType = null> extends LinkedQuery {
+    type: 'create';
+    shape: NodeShape;
+    description: NodeDescriptionValue;
+}
 export type CreateResponse<U> = AddId<U, true>;
 export declare class CreateQueryFactory<ShapeType extends Shape, U extends UpdatePartial<ShapeType>> extends MutationQueryFactory {
     shapeClass: typeof Shape;
     readonly id: string;
     readonly description: NodeDescriptionValue;
     constructor(shapeClass: typeof Shape, updateObjectOrFn: U);
-    build(): CreateQuery;
+    getQueryObject(): CreateQuery<AddId<U, true>>;
 }

package/lib/cjs/queries/CreateQuery.js

@@ -2,18 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateQueryFactory = void 0;
 const MutationQuery_js_1 = require("./MutationQuery.js");
-const IRMutation_js_1 = require("./IRMutation.js");
 class CreateQueryFactory extends MutationQuery_js_1.MutationQueryFactory {
     constructor(shapeClass, updateObjectOrFn) {
         super();
         this.shapeClass = shapeClass;
         this.description = this.convertUpdateObject(updateObjectOrFn, this.shapeClass.shape, true);
     }
-    build() {
-        return (0, IRMutation_js_1.buildCanonicalCreateMutationIR)({
+    getQueryObject() {
+        return {
+            type: 'create',
             shape: this.shapeClass.shape,
             description: this.description,
-        });
+        };
     }
 }
 exports.CreateQueryFactory = CreateQueryFactory;

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

@@ -1 +1 @@
-{"version":3,"file":"CreateQuery.js","sourceRoot":"","sources":["../../../src/queries/CreateQuery.ts"],"names":[],"mappings":";;;AAEA,yDAAwD;AAExD,mDAA+D;AAU/D,MAAa,kBAGX,SAAQ,uCAAoB;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,IAAA,8CAA8B,EAAC;YACpC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;CACF;AAzBD,gDAyBC"}
+{"version":3,"file":"CreateQuery.js","sourceRoot":"","sources":["../../../src/queries/CreateQuery.ts"],"names":[],"mappings":";;;AAIA,yDAAwD;AAUxD,MAAa,kBAGX,SAAQ,uCAAoB;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,cAAc;QACZ,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC;CACF;AA1BD,gDA0BC"}

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

@@ -1,12 +1,13 @@
 import { Shape } from '../shapes/Shape.js';
+import { NodeShape } from '../shapes/SHACL.js';
+import { LinkedQuery } from './SelectQuery.js';
 import { NodeReferenceValue, UpdatePartial } from './QueryFactory.js';
 import { MutationQueryFactory, NodeId } from './MutationQuery.js';
-import { IRDeleteMutation } from './IntermediateRepresentation.js';
-/**
- * The canonical DeleteQuery type — an IR AST node representing a delete mutation.
- * This is the type received by IQuadStore.deleteQuery().
- */
-export type DeleteQuery = IRDeleteMutation;
+export interface DeleteQuery extends LinkedQuery {
+    type: 'delete';
+    shape: NodeShape;
+    ids: NodeReferenceValue[];
+}
 export type DeleteResponse = {
     /**
      * The IDs of the items that were successfully deleted.
@@ -30,5 +31,5 @@ export declare class DeleteQueryFactory<ShapeType extends Shape, U extends Updat
     readonly id: string;
     readonly ids: NodeReferenceValue[];
     constructor(shapeClass: typeof Shape, ids: NodeId[] | NodeId);
-    build(): DeleteQuery;
+    getQueryObject(): DeleteQuery;
 }

package/lib/cjs/queries/DeleteQuery.js

@@ -2,18 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeleteQueryFactory = void 0;
 const MutationQuery_js_1 = require("./MutationQuery.js");
-const IRMutation_js_1 = require("./IRMutation.js");
 class DeleteQueryFactory extends MutationQuery_js_1.MutationQueryFactory {
     constructor(shapeClass, ids) {
         super();
         this.shapeClass = shapeClass;
         this.ids = this.convertNodeReferences(ids);
     }
-    build() {
-        return (0, IRMutation_js_1.buildCanonicalDeleteMutationIR)({
+    getQueryObject() {
+        return {
+            type: 'delete',
             shape: this.shapeClass.shape,
             ids: this.ids,
-        });
+        };
     }
 }
 exports.DeleteQueryFactory = DeleteQueryFactory;

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

@@ -1 +1 @@
-{"version":3,"file":"DeleteQuery.js","sourceRoot":"","sources":["../../../src/queries/DeleteQuery.ts"],"names":[],"mappings":";;;AAEA,yDAAgE;AAEhE,mDAA+D;AA2B/D,MAAa,kBAGX,SAAQ,uCAAoB;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,IAAA,8CAA8B,EAAC;YACpC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;CACF;AArBD,gDAqBC"}
+{"version":3,"file":"DeleteQuery.js","sourceRoot":"","sources":["../../../src/queries/DeleteQuery.ts"],"names":[],"mappings":";;;AAIA,yDAAgE;AA2BhE,MAAa,kBAGX,SAAQ,uCAAoB;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,cAAc;QACZ,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;YAC5B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;CACF;AAtBD,gDAsBC"}

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

@@ -1,3 +1,4 @@
+import { LinkedQuery } from './SelectQuery.js';
 import { NodeShape, PropertyShape } from '../shapes/SHACL.js';
 import { Shape } from '../shapes/Shape.js';
 import { ShapeSet } from '../collections/ShapeSet.js';
@@ -75,6 +76,7 @@ export type ShapeReferenceValue = {
 export { toNodeReference } from '../utils/NodeReference.js';
 export type { NodeReferenceValue };
 export declare abstract class QueryFactory {
+    getQueryObject(): LinkedQuery | Promise<LinkedQuery>;
 }
 export declare function isSetModificationValue(value: any): value is SetModificationValue;
 /**

package/lib/cjs/queries/QueryFactory.js

@@ -6,6 +6,9 @@ exports.checkNewCount = checkNewCount;
 var NodeReference_js_1 = require("../utils/NodeReference.js");
 Object.defineProperty(exports, "toNodeReference", { enumerable: true, get: function () { return NodeReference_js_1.toNodeReference; } });
 class QueryFactory {
+    getQueryObject() {
+        return null;
+    }
 }
 exports.QueryFactory = QueryFactory;
 function isSetModificationValue(value) {

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

@@ -1 +1 @@
-{"version":3,"file":"QueryFactory.js","sourceRoot":"","sources":["../../../src/queries/QueryFactory.ts"],"names":[],"mappings":";;;AAuKA,wDAcC;AAQD,sCAeC;AA1CD,8DAA0D;AAAlD,mHAAA,eAAe,OAAA;AAGvB,MAAsB,YAAY;CAAG;AAArC,oCAAqC;AAErC,SAAgB,sBAAsB,CACpC,KAAU;IAEV,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAE/C,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;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,SAAwB,EAAE,SAAiB;IACvE,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,IAAI,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,iCAAiC,SAAS,CAAC,KAAK,mBAAmB,SAAS,CAAC,QAAQ,4BAA4B,SAAS,EAAE,CAC7H,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,IAAI,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,gCAAgC,SAAS,CAAC,KAAK,mBAAmB,SAAS,CAAC,QAAQ,4BAA4B,SAAS,EAAE,CAC5H,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"QueryFactory.js","sourceRoot":"","sources":["../../../src/queries/QueryFactory.ts"],"names":[],"mappings":";;;AA6OA,wDAcC;AAQD,sCAeC;AA9CD,8DAA0D;AAAlD,mHAAA,eAAe,OAAA;AAGvB,MAAsB,YAAY;IAChC,cAAc;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAJD,oCAIC;AAED,SAAgB,sBAAsB,CACpC,KAAU;IAEV,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAE/C,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;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,SAAwB,EAAE,SAAiB;IACvE,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,IAAI,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,iCAAiC,SAAS,CAAC,KAAK,mBAAmB,SAAS,CAAC,QAAQ,4BAA4B,SAAS,EAAE,CAC7H,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,IAAI,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,gCAAgC,SAAS,CAAC,KAAK,mBAAmB,SAAS,CAAC,QAAQ,4BAA4B,SAAS,EAAE,CAC5H,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -1,14 +1,9 @@
 import { GetQueryResponseType, QueryResponseToResultType, SelectQueryFactory } from './SelectQuery.js';
 import { AddId, NodeReferenceValue, UpdatePartial } from './QueryFactory.js';
-import type { Shape } from '../shapes/Shape.js';
+import { Shape } from '../shapes/Shape.js';
 import { CreateResponse } from './CreateQuery.js';
 import { DeleteResponse } from './DeleteQuery.js';
 import { NodeId } from './MutationQuery.js';
-/**
- * Bridges the DSL layer (Shape.select/create/update/delete) to the storage
- * layer (LinkedStorage → IQuadStore). Each method builds the IR from a
- * factory and routes it to the appropriate store.
- */
 export declare class QueryParser {
     static selectQuery<ShapeType extends Shape, ResponseType, Source, ResultType = QueryResponseToResultType<GetQueryResponseType<SelectQueryFactory<ShapeType, ResponseType>>, ShapeType>[]>(query: SelectQueryFactory<ShapeType, ResponseType, Source>): Promise<ResultType>;
     static updateQuery<ShapeType extends Shape, U extends UpdatePartial<ShapeType>>(id: string | NodeReferenceValue, updateObjectOrFn: U, shapeClass: typeof Shape): Promise<AddId<U>>;