@_linked/core 2.2.0-next.20260313111743 → 2.2.0

package/CHANGELOG.md

@@ -2,6 +2,43 @@
 
 ## 2.2.0
 
+### Patch Changes
+
+- [#34](https://github.com/Semantu/linked/pull/34) [`e2ae4a2`](https://github.com/Semantu/linked/commit/e2ae4a28e5be28716e1634ca81d9c379a291cbc6) Thanks [@flyon](https://github.com/flyon)! - ### SHACL property path support
+
+  Property decorators now accept full SPARQL property path syntax:
+
+  ```ts
+  @literalProperty({path: 'foaf:knows/foaf:name'})        // sequence
+  @literalProperty({path: '<http://ex.org/a>|<http://ex.org/b>'})  // alternative
+  @literalProperty({path: '^foaf:knows'})                  // inverse
+  @literalProperty({path: 'foaf:knows*'})                  // zeroOrMore
+  ```
+
+  New exports from `src/paths/`:
+
+  - `PathExpr`, `PathRef` — AST types for property paths
+  - `parsePropertyPath(input): PathExpr` — parser for SPARQL property path strings
+  - `normalizePropertyPath(input): PathExpr` — normalizes any input form to canonical AST
+  - `pathExprToSparql(expr): string` — renders PathExpr to SPARQL syntax
+  - `serializePathToSHACL(expr): SHACLPathResult` — serializes to SHACL RDF triples
+
+  `PropertyShape.path` is now typed as `PathExpr` (was opaque). Complex paths flow through the full IR pipeline and emit correct SPARQL property path syntax in generated queries.
+
+  ### Strict prefix resolution in query API
+
+  `QueryBuilder.for()` and `.forAll()` now throw on unregistered prefixes instead of silently passing through. New export:
+
+  - `resolveUriOrThrow(str): string` — strict prefix resolution (throws on unknown prefix)
+
+  ### SHACL constraint field fixes
+
+  - `hasValue` and `in` config fields now correctly handle literal values (`string`, `number`, `boolean`) — previously all values were wrapped as IRI nodes
+  - `lessThan` and `lessThanOrEquals` config fields are now wired into `createPropertyShape` and exposed via `getResult()`
+  - New `PropertyShapeResult` interface provides typed access to `getResult()` output
+
+## 2.1.0
+
 ### Minor Changes
 
 - [#31](https://github.com/Semantu/linked/pull/31) [`eb88865`](https://github.com/Semantu/linked/commit/eb8886564f2c9663805c4308a834ca615f9a1dab) Thanks [@flyon](https://github.com/flyon)! - Properties in `select()` and `update()` now support expressions — you can compute values dynamically instead of just reading or writing raw fields.
@@ -51,6 +88,222 @@
 
   See the [README](./README.md#computed-expressions) for the full method reference and more examples.
 
+## 2.0.1
+
+### Patch Changes
+
+- [#27](https://github.com/Semantu/linked/pull/27) [`d3c1e91`](https://github.com/Semantu/linked/commit/d3c1e918b2a63240ddbf3cb550ec43fa1e019c35) Thanks [@flyon](https://github.com/flyon)! - Add MINUS support on QueryBuilder with multiple call styles:
+
+  - `.minus(Shape)` — exclude by shape type
+  - `.minus(p => p.prop.equals(val))` — exclude by condition
+  - `.minus(p => p.prop)` — exclude by property existence
+  - `.minus(p => [p.prop1, p.nested.prop2])` — exclude by multi-property existence with nested path support
+
+  Add bulk delete operations:
+
+  - `Shape.deleteAll()` / `DeleteBuilder.from(Shape).all()` — delete all instances with schema-aware blank node cleanup
+  - `Shape.deleteWhere(fn)` / `DeleteBuilder.from(Shape).where(fn)` — conditional delete
+
+  Add conditional update operations:
+
+  - `.update(data).where(fn)` — update matching instances
+  - `.update(data).forAll()` — update all instances
+
+  API cleanup:
+
+  - Deprecate `sortBy()` in favor of `orderBy()`
+  - Remove `DeleteBuilder.for()` — use `DeleteBuilder.from(shape, ids)` instead
+  - Require `data` parameter in `Shape.update(data)`
+
+## 2.0.0
+
+### Major Changes
+
+- [#23](https://github.com/Semantu/linked/pull/23) [`d2d1eca`](https://github.com/Semantu/linked/commit/d2d1eca3517af11f39348dc83ba5e60703ef86d2) Thanks [@flyon](https://github.com/flyon)! - ## Breaking Changes
+
+  ### `Shape.select()` and `Shape.update()` no longer accept an ID as the first argument
+
+  Use `.for(id)` to target a specific entity instead.
+
+  **Select:**
+
+  ```typescript
+  // Before
+  const result = await Person.select({ id: "..." }, (p) => p.name);
+
+  // After
+  const result = await Person.select((p) => p.name).for({ id: "..." });
+  ```
+
+  `.for(id)` unwraps the result type from array to single object, matching the old single-subject overload behavior.
+
+  **Update:**
+
+  ```typescript
+  // Before
+  const result = await Person.update({ id: "..." }, { name: "Alice" });
+
+  // After
+  const result = await Person.update({ name: "Alice" }).for({ id: "..." });
+  ```
+
+  `Shape.selectAll(id)` also no longer accepts an id — use `Person.selectAll().for(id)`.
+
+  ### `ShapeType` renamed to `ShapeConstructor`
+
+  The type alias for concrete Shape subclass constructors has been renamed. Update any imports or references:
+
+  ```typescript
+  // Before
+  import type { ShapeType } from "@_linked/core/shapes/Shape";
+
+  // After
+  import type { ShapeConstructor } from "@_linked/core/shapes/Shape";
+  ```
+
+  ### `QueryString`, `QueryNumber`, `QueryBoolean`, `QueryDate` classes removed
+
+  These have been consolidated into a single generic `QueryPrimitive<T>` class. If you were using `instanceof` checks against these classes, use `instanceof QueryPrimitive` instead and check the value's type.
+
+  ### Internal IR types removed
+
+  The following types and functions have been removed from `SelectQuery`. These were internal pipeline types — if you were using them for custom store integrations, the replacement is `FieldSetEntry[]` (available from `FieldSet`):
+
+  - Types: `SelectPath`, `QueryPath`, `CustomQueryObject`, `SubQueryPaths`, `ComponentQueryPath`
+  - Functions: `fieldSetToSelectPath()`, `entryToQueryPath()`
+  - Methods: `QueryBuilder.getQueryPaths()`, `BoundComponent.getComponentQueryPaths()`
+  - `RawSelectInput.select` field renamed to `RawSelectInput.entries` (type changed from `SelectPath` to `FieldSetEntry[]`)
+
+  ### `getPackageShape()` return type is now nullable
+
+  Returns `ShapeConstructor | undefined` instead of `typeof Shape`. Code that didn't null-check the return value will now get TypeScript errors.
+
+  ## New Features
+
+  ### `.for(id)` and `.forAll(ids)` chaining
+
+  Consistent API for targeting entities across select and update operations:
+
+  ```typescript
+  // Single entity (result is unwrapped, not an array)
+  await Person.select((p) => p.name).for({ id: "..." });
+  await Person.select((p) => p.name).for("https://...");
+
+  // Multiple specific entities
+  await QueryBuilder.from(Person)
+    .select((p) => p.name)
+    .forAll([{ id: "..." }, { id: "..." }]);
+
+  // All instances (default — no .for() needed)
+  await Person.select((p) => p.name);
+  ```
+
+  ### Dynamic Query Building with `QueryBuilder` and `FieldSet`
+
+  Build queries programmatically at runtime — for CMS dashboards, API endpoints, configurable reports. See the [Dynamic Query Building](./README.md#dynamic-query-building) section in the README for full documentation and examples.
+
+  Key capabilities:
+
+  - `QueryBuilder.from(Person)` or `QueryBuilder.from('https://schema.org/Person')` — fluent, chainable, immutable query construction
+  - `FieldSet.for(Person, ['name', 'knows'])` — composable field selections with `.add()`, `.remove()`, `.pick()`, `FieldSet.merge()`
+  - `FieldSet.all(Person, {depth: 2})` — select all decorated properties with optional depth
+  - JSON serialization: `query.toJSON()` / `QueryBuilder.fromJSON(json)` and `fieldSet.toJSON()` / `FieldSet.fromJSON(json)`
+  - All builders are `PromiseLike` — `await` them directly or call `.build()` to inspect the IR
+
+  ### Mutation Builders
+
+  `CreateBuilder`, `UpdateBuilder`, and `DeleteBuilder` provide the programmatic equivalent of `Person.create()`, `Person.update()`, and `Person.delete()`, accepting Shape classes or shape IRI strings. See the [Mutation Builders](./README.md#mutation-builders) section in the README.
+
+  ### `PropertyPath` exported
+
+  The `PropertyPath` value object is now a public export — a type-safe representation of a sequence of property traversals through a shape graph.
+
+  ```typescript
+  import { PropertyPath, walkPropertyPath } from "@_linked/core";
+  ```
+
+  ### `ShapeConstructor<S>` type
+
+  New concrete constructor type for Shape subclasses. Eliminates ~30 `as any` casts across the codebase and provides better type safety at runtime boundaries (builder `.from()` methods, Shape static methods).
+
+## 1.3.0
+
+### Minor Changes
+
+- [#20](https://github.com/Semantu/linked/pull/20) [`33e9fb0`](https://github.com/Semantu/linked/commit/33e9fb0205343eca8c84723cbabc3f3342e40be5) Thanks [@flyon](https://github.com/flyon)! - **Breaking:** `QueryParser` has been removed. If you imported `QueryParser` directly, replace with `getQueryDispatch()` from `@_linked/core/queries/queryDispatch`. The Shape DSL (`Shape.select()`, `.create()`, `.update()`, `.delete()`) and `SelectQuery.exec()` are unchanged.
+
+  **New:** `getQueryDispatch()` and `setQueryDispatch()` are now exported, allowing custom query dispatch implementations (e.g. for testing or alternative storage backends) without subclassing `LinkedStorage`.
+
+## 1.2.1
+
+### Patch Changes
+
+- [#17](https://github.com/Semantu/linked/pull/17) [`0654780`](https://github.com/Semantu/linked/commit/06547807a7bae56e992eba73263f83e092b7788b) Thanks [@flyon](https://github.com/flyon)! - Preserve nested array sub-select branches in canonical IR so `build()` emits complete traversals, projection fields, and `resultMap` entries for nested selections.
+
+  This fixes cases where nested branches present in `toRawInput().select` were dropped during desugar/lowering (for example nested `friends.select([name, hobby])` branches under another sub-select).
+
+  Also adds regression coverage for desugar preservation, IR lowering completeness, and updated SPARQL golden output for nested query fixtures.
+
+## 1.2.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)! - Replaced internal query representation with a canonical backend-agnostic IR AST. `SelectQuery`, `CreateQuery`, `UpdateQuery`, and `DeleteQuery` are now typed IR objects with `kind` discriminators, compact shape/property ID references, and expression trees — replacing the previous ad-hoc nested arrays. The public Shape DSL is unchanged; what changed is what `IQuadStore` implementations receive. Store result types (`ResultRow`, `SelectResult`, `CreateResult`, `UpdateResult`) are now exported. All factories expose `build()` as the primary method. See `documentation/intermediate-representation.md` for the full IR reference and migration guidance.
+
+- [#14](https://github.com/Semantu/linked/pull/14) [`b65e156`](https://github.com/Semantu/linked/commit/b65e15688ac173478e58e1dbb9f26dbaf5fc5a37) Thanks [@flyon](https://github.com/flyon)! - Add SPARQL conversion layer — compiles Linked IR queries into executable SPARQL and maps results back to typed DSL objects.
+
+  **New exports from `@_linked/core/sparql`:**
+
+  - **`SparqlStore`** — abstract base class for SPARQL-backed stores. Extend it and implement two methods to connect any SPARQL 1.1 endpoint:
+
+    ```ts
+    import { SparqlStore } from "@_linked/core/sparql";
+
+    class MyStore extends SparqlStore {
+      protected async executeSparqlSelect(
+        sparql: string
+      ): Promise<SparqlJsonResults> {
+        /* ... */
+      }
+      protected async executeSparqlUpdate(sparql: string): Promise<void> {
+        /* ... */
+      }
+    }
+    ```
+
+  - **IR → SPARQL string** convenience functions (full pipeline in one call):
+
+    - `selectToSparql(query, options?)` — SelectQuery → SPARQL string
+    - `createToSparql(query, options?)` — CreateQuery → SPARQL string
+    - `updateToSparql(query, options?)` — UpdateQuery → SPARQL string
+    - `deleteToSparql(query, options?)` — DeleteQuery → SPARQL string
+
+  - **IR → SPARQL algebra** (for stores that want to inspect/optimize the algebra before serialization):
+
+    - `selectToAlgebra(query, options?)` — returns `SparqlSelectPlan`
+    - `createToAlgebra(query, options?)` — returns `SparqlInsertDataPlan`
+    - `updateToAlgebra(query, options?)` — returns `SparqlDeleteInsertPlan`
+    - `deleteToAlgebra(query, options?)` — returns `SparqlDeleteInsertPlan`
+
+  - **Algebra → SPARQL string** serialization:
+
+    - `selectPlanToSparql(plan, options?)`, `insertDataPlanToSparql(plan, options?)`, `deleteInsertPlanToSparql(plan, options?)`, `deleteWherePlanToSparql(plan, options?)`
+    - `serializeAlgebraNode(node)`, `serializeExpression(expr)`, `serializeTerm(term)`
+
+  - **Result mapping** (SPARQL JSON results → typed DSL objects):
+
+    - `mapSparqlSelectResult(json, query)` — handles flat/nested/aggregated results with XSD type coercion
+    - `mapSparqlCreateResult(uri, query)` — echoes created fields with generated URI
+    - `mapSparqlUpdateResult(query)` — echoes updated fields
+
+  - **All algebra types** re-exported: `SparqlTerm`, `SparqlTriple`, `SparqlAlgebraNode`, `SparqlExpression`, `SparqlSelectPlan`, `SparqlInsertDataPlan`, `SparqlDeleteInsertPlan`, `SparqlDeleteWherePlan`, `SparqlPlan`, `SparqlOptions`, etc.
+
+  **Bug fixes included:**
+
+  - Fixed `isNodeReference()` in MutationQuery.ts — nested creates with predefined IDs (e.g., `{id: '...', name: 'Bestie'}`) now correctly insert entity data instead of only creating the link.
+
+  See [SPARQL Algebra Layer docs](./documentation/sparql-algebra.md) for the full type reference, conversion rules, and store implementation guide.
+
 ## 1.1.0
 
 ### Minor Changes

package/lib/cjs/ontologies/shacl.d.ts

@@ -88,4 +88,9 @@ export declare const shacl: {
     MaxLengthConstraintComponent: NodeReferenceValue;
     AbstractResult: NodeReferenceValue;
     result: NodeReferenceValue;
+    alternativePath: NodeReferenceValue;
+    inversePath: NodeReferenceValue;
+    zeroOrMorePath: NodeReferenceValue;
+    oneOrMorePath: NodeReferenceValue;
+    zeroOrOnePath: NodeReferenceValue;
 };

package/lib/cjs/ontologies/shacl.js

@@ -30,6 +30,11 @@ const targetNode = (0, exports.ns)('targetNode');
 const node = (0, exports.ns)('node');
 const nodeKind = (0, exports.ns)('nodeKind');
 const Shape = (0, exports.ns)('Shape');
+const alternativePath = (0, exports.ns)('alternativePath');
+const inversePath = (0, exports.ns)('inversePath');
+const zeroOrMorePath = (0, exports.ns)('zeroOrMorePath');
+const oneOrMorePath = (0, exports.ns)('oneOrMorePath');
+const zeroOrOnePath = (0, exports.ns)('zeroOrOnePath');
 const BlankNode = (0, exports.ns)('BlankNode');
 const IRI = (0, exports.ns)('IRI');
 const Literal = (0, exports.ns)('Literal');
@@ -124,5 +129,10 @@ exports.shacl = {
     MaxLengthConstraintComponent: exports.MaxLengthConstraintComponent,
     AbstractResult: exports.AbstractResult,
     result: exports.result,
+    alternativePath,
+    inversePath,
+    zeroOrMorePath,
+    oneOrMorePath,
+    zeroOrOnePath,
 };
 //# sourceMappingURL=shacl.js.map

package/lib/cjs/ontologies/shacl.js.map

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

package/lib/cjs/paths/PropertyPathExpr.d.ts

@@ -0,0 +1,38 @@
+/** A simple path reference — either a raw string (prefixed/IRI) or a node ref. */
+export type PathRef = string | {
+    id: string;
+};
+/** Discriminated-object union for all SPARQL property path forms. */
+export type PathExpr = PathRef | {
+    seq: PathExpr[];
+} | {
+    alt: PathExpr[];
+} | {
+    inv: PathExpr;
+} | {
+    zeroOrMore: PathExpr;
+} | {
+    oneOrMore: PathExpr;
+} | {
+    zeroOrOne: PathExpr;
+} | {
+    negatedPropertySet: (PathRef | {
+        inv: PathRef;
+    })[];
+};
+export declare const isPathRef: (expr: PathExpr) => expr is PathRef;
+export declare const isComplexPathExpr: (expr: PathExpr) => boolean;
+/**
+ * Characters that signal a string contains path operators and should be parsed.
+ * Used by the normalizer to decide whether to invoke the parser.
+ */
+export declare const PATH_OPERATOR_CHARS: RegExp;
+/**
+ * Parse a SPARQL property path string into a PathExpr AST.
+ *
+ * Supports: sequence (/), alternative (|), inverse (^), zeroOrMore (*),
+ * oneOrMore (+), zeroOrOne (?), negatedPropertySet (!), and grouping (()).
+ *
+ * Does NOT resolve prefixes — raw strings are preserved in the AST.
+ */
+export declare function parsePropertyPath(input: string): PathExpr;

package/lib/cjs/paths/PropertyPathExpr.js

@@ -0,0 +1,221 @@
+"use strict";
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PATH_OPERATOR_CHARS = exports.isComplexPathExpr = exports.isPathRef = void 0;
+exports.parsePropertyPath = parsePropertyPath;
+// ---------------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------------
+const isPathRef = (expr) => typeof expr === 'string' || (typeof expr === 'object' && expr !== null && 'id' in expr && Object.keys(expr).length === 1);
+exports.isPathRef = isPathRef;
+const isComplexPathExpr = (expr) => !(0, exports.isPathRef)(expr);
+exports.isComplexPathExpr = isComplexPathExpr;
+// ---------------------------------------------------------------------------
+// Parser — recursive-descent for SPARQL property path grammar
+// ---------------------------------------------------------------------------
+/**
+ * Characters that signal a string contains path operators and should be parsed.
+ * Used by the normalizer to decide whether to invoke the parser.
+ */
+exports.PATH_OPERATOR_CHARS = /[/|^*+?()!<]/;
+class PathParser {
+    constructor(input) {
+        this.pos = 0;
+        this.input = input;
+    }
+    parse() {
+        this.skipWhitespace();
+        const result = this.parseAlt();
+        this.skipWhitespace();
+        if (this.pos < this.input.length) {
+            this.error(`Unexpected character '${this.input[this.pos]}'`);
+        }
+        return result;
+    }
+    // alt = seq ( '|' seq )*
+    parseAlt() {
+        const first = this.parseSeq();
+        const branches = [first];
+        while (this.peek() === '|') {
+            this.advance(); // consume '|'
+            this.skipWhitespace();
+            branches.push(this.parseSeq());
+        }
+        return branches.length === 1 ? branches[0] : { alt: branches };
+    }
+    // seq = unary ( '/' unary )*
+    parseSeq() {
+        const first = this.parseUnary();
+        const steps = [first];
+        while (this.peek() === '/') {
+            this.advance(); // consume '/'
+            this.skipWhitespace();
+            steps.push(this.parseUnary());
+        }
+        return steps.length === 1 ? steps[0] : { seq: steps };
+    }
+    // unary = '^' unary | primary ( '*' | '+' | '?' )?
+    parseUnary() {
+        this.skipWhitespace();
+        if (this.peek() === '^') {
+            this.advance(); // consume '^'
+            this.skipWhitespace();
+            const inner = this.parseUnary();
+            return { inv: inner };
+        }
+        let expr = this.parsePrimary();
+        this.skipWhitespace();
+        const postfix = this.peek();
+        if (postfix === '*') {
+            this.advance();
+            expr = { zeroOrMore: expr };
+        }
+        else if (postfix === '+') {
+            this.advance();
+            expr = { oneOrMore: expr };
+        }
+        else if (postfix === '?') {
+            this.advance();
+            expr = { zeroOrOne: expr };
+        }
+        this.skipWhitespace();
+        return expr;
+    }
+    // primary = '(' alt ')' | '!' negatedPropertySet | iri
+    parsePrimary() {
+        this.skipWhitespace();
+        const ch = this.peek();
+        // Grouped expression
+        if (ch === '(') {
+            this.advance(); // consume '('
+            this.skipWhitespace();
+            const inner = this.parseAlt();
+            this.skipWhitespace();
+            if (this.peek() !== ')') {
+                this.error("Expected ')'");
+            }
+            this.advance(); // consume ')'
+            return inner;
+        }
+        // Negated property set
+        if (ch === '!') {
+            this.advance(); // consume '!'
+            this.skipWhitespace();
+            return this.parseNegatedPropertySet();
+        }
+        // IRI or prefixed name
+        return this.parseIri();
+    }
+    // negatedPropertySet = '(' negatedItem ( '|' negatedItem )* ')' | negatedItem
+    parseNegatedPropertySet() {
+        this.skipWhitespace();
+        if (this.peek() === '(') {
+            this.advance(); // consume '('
+            this.skipWhitespace();
+            const items = this.parseNegatedItems();
+            this.skipWhitespace();
+            if (this.peek() !== ')') {
+                this.error("Expected ')' in negated property set");
+            }
+            this.advance(); // consume ')'
+            return { negatedPropertySet: items };
+        }
+        // Single negated item
+        const item = this.parseNegatedItem();
+        return { negatedPropertySet: [item] };
+    }
+    parseNegatedItems() {
+        const items = [this.parseNegatedItem()];
+        while (this.peek() === '|') {
+            this.advance(); // consume '|'
+            this.skipWhitespace();
+            items.push(this.parseNegatedItem());
+        }
+        return items;
+    }
+    parseNegatedItem() {
+        this.skipWhitespace();
+        if (this.peek() === '^') {
+            this.advance(); // consume '^'
+            this.skipWhitespace();
+            const ref = this.parseIri();
+            return { inv: ref };
+        }
+        return this.parseIri();
+    }
+    // iri = '<' chars '>' | prefixedName
+    parseIri() {
+        this.skipWhitespace();
+        if (this.peek() === '<') {
+            this.advance(); // consume '<'
+            const start = this.pos;
+            while (this.pos < this.input.length && this.input[this.pos] !== '>') {
+                this.pos++;
+            }
+            if (this.pos >= this.input.length) {
+                this.error("Expected '>' to close IRI");
+            }
+            const iri = this.input.slice(start, this.pos);
+            this.advance(); // consume '>'
+            return iri;
+        }
+        return this.parsePrefixedName();
+    }
+    // prefixedName = PNAME_NS PNAME_LOCAL | PNAME_NS
+    // We accept any characters until we hit a path operator or whitespace or end
+    parsePrefixedName() {
+        this.skipWhitespace();
+        const start = this.pos;
+        while (this.pos < this.input.length && !this.isTerminator(this.input[this.pos])) {
+            this.pos++;
+        }
+        if (this.pos === start) {
+            this.error('Expected IRI or prefixed name');
+        }
+        return this.input.slice(start, this.pos);
+    }
+    isTerminator(ch) {
+        return ch === '/' || ch === '|' || ch === '*' || ch === '+' || ch === '?' ||
+            ch === '(' || ch === ')' || ch === '^' || ch === '!' || ch === ' ' ||
+            ch === '\t' || ch === '\n' || ch === '\r';
+    }
+    peek() {
+        return this.pos < this.input.length ? this.input[this.pos] : undefined;
+    }
+    advance() {
+        this.pos++;
+    }
+    skipWhitespace() {
+        while (this.pos < this.input.length) {
+            const ch = this.input[this.pos];
+            if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r') {
+                this.pos++;
+            }
+            else {
+                break;
+            }
+        }
+    }
+    error(message) {
+        throw new Error(`Property path parse error at position ${this.pos}: ${message} (input: "${this.input}")`);
+    }
+}
+/**
+ * Parse a SPARQL property path string into a PathExpr AST.
+ *
+ * Supports: sequence (/), alternative (|), inverse (^), zeroOrMore (*),
+ * oneOrMore (+), zeroOrOne (?), negatedPropertySet (!), and grouping (()).
+ *
+ * Does NOT resolve prefixes — raw strings are preserved in the AST.
+ */
+function parsePropertyPath(input) {
+    if (!input || input.trim().length === 0) {
+        throw new Error('Property path input must not be empty');
+    }
+    return new PathParser(input.trim()).parse();
+}
+//# sourceMappingURL=PropertyPathExpr.js.map

package/lib/cjs/paths/PropertyPathExpr.js.map

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

package/lib/cjs/paths/normalizePropertyPath.d.ts

@@ -0,0 +1,23 @@
+import { PathExpr } from './PropertyPathExpr.js';
+/**
+ * Input type for property path decorators.
+ * Accepts all forms: string, {id}, array (sequence shorthand), or PathExpr.
+ */
+export type PropertyPathDecoratorInput = string | {
+    id: string;
+} | PropertyPathDecoratorInput[] | PathExpr;
+/**
+ * Normalize any property path decorator input into a canonical PathExpr.
+ *
+ * - `string` without path operators → preserved as-is (a PathRef)
+ * - `string` with operators → parsed via `parsePropertyPath`
+ * - `{id: string}` → preserved as PathRef
+ * - `PathExpr` structured object → passed through
+ * - `Array` → converted to `{seq: [...]}`
+ */
+export declare function normalizePropertyPath(input: PropertyPathDecoratorInput): PathExpr;
+/**
+ * Check whether a PathExpr is a simple single-IRI path (backward-compatible form).
+ * Returns the IRI string if simple, or null if complex.
+ */
+export declare function getSimplePathId(expr: PathExpr): string | null;