@_linked/core 2.0.1 → 2.2.0-next.20260313111019

package/lib/cjs/expressions/Expr.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Expr = void 0;
+const ExpressionNode_js_1 = require("./ExpressionNode.js");
+function wrap(input) {
+    return input instanceof ExpressionNode_js_1.ExpressionNode
+        ? input
+        : new ExpressionNode_js_1.ExpressionNode((0, ExpressionNode_js_1.toIRExpression)(input));
+}
+exports.Expr = {
+    // ---------------------------------------------------------------------------
+    // Arithmetic
+    // ---------------------------------------------------------------------------
+    plus(a, b) {
+        return wrap(a).plus(b);
+    },
+    minus(a, b) {
+        return wrap(a).minus(b);
+    },
+    times(a, b) {
+        return wrap(a).times(b);
+    },
+    divide(a, b) {
+        return wrap(a).divide(b);
+    },
+    abs(a) {
+        return wrap(a).abs();
+    },
+    round(a) {
+        return wrap(a).round();
+    },
+    ceil(a) {
+        return wrap(a).ceil();
+    },
+    floor(a) {
+        return wrap(a).floor();
+    },
+    power(a, b) {
+        return wrap(a).power(b);
+    },
+    // ---------------------------------------------------------------------------
+    // Comparison (short names only)
+    // ---------------------------------------------------------------------------
+    eq(a, b) {
+        return wrap(a).eq(b);
+    },
+    neq(a, b) {
+        return wrap(a).neq(b);
+    },
+    gt(a, b) {
+        return wrap(a).gt(b);
+    },
+    gte(a, b) {
+        return wrap(a).gte(b);
+    },
+    lt(a, b) {
+        return wrap(a).lt(b);
+    },
+    lte(a, b) {
+        return wrap(a).lte(b);
+    },
+    // ---------------------------------------------------------------------------
+    // String
+    // ---------------------------------------------------------------------------
+    concat(...parts) {
+        if (parts.length < 2) {
+            throw new Error('Expr.concat() requires at least 2 arguments');
+        }
+        const [first, ...rest] = parts;
+        return new ExpressionNode_js_1.ExpressionNode({
+            kind: 'function_expr',
+            name: 'CONCAT',
+            args: parts.map(ExpressionNode_js_1.toIRExpression),
+        });
+    },
+    contains(a, b) {
+        return wrap(a).contains(b);
+    },
+    startsWith(a, b) {
+        return wrap(a).startsWith(b);
+    },
+    endsWith(a, b) {
+        return wrap(a).endsWith(b);
+    },
+    substr(a, start, len) {
+        return wrap(a).substr(start, len);
+    },
+    before(a, b) {
+        return wrap(a).before(b);
+    },
+    after(a, b) {
+        return wrap(a).after(b);
+    },
+    replace(a, pat, rep, flags) {
+        return wrap(a).replace(pat, rep, flags);
+    },
+    ucase(a) {
+        return wrap(a).ucase();
+    },
+    lcase(a) {
+        return wrap(a).lcase();
+    },
+    strlen(a) {
+        return wrap(a).strlen();
+    },
+    encodeForUri(a) {
+        return wrap(a).encodeForUri();
+    },
+    regex(a, pat, flags) {
+        return wrap(a).matches(pat, flags);
+    },
+    // ---------------------------------------------------------------------------
+    // Date/Time
+    // ---------------------------------------------------------------------------
+    now() {
+        return new ExpressionNode_js_1.ExpressionNode({ kind: 'function_expr', name: 'NOW', args: [] });
+    },
+    year(a) {
+        return wrap(a).year();
+    },
+    month(a) {
+        return wrap(a).month();
+    },
+    day(a) {
+        return wrap(a).day();
+    },
+    hours(a) {
+        return wrap(a).hours();
+    },
+    minutes(a) {
+        return wrap(a).minutes();
+    },
+    seconds(a) {
+        return wrap(a).seconds();
+    },
+    timezone(a) {
+        return wrap(a).timezone();
+    },
+    tz(a) {
+        return wrap(a).tz();
+    },
+    // ---------------------------------------------------------------------------
+    // Logical
+    // ---------------------------------------------------------------------------
+    and(a, b) {
+        return wrap(a).and(b);
+    },
+    or(a, b) {
+        return wrap(a).or(b);
+    },
+    not(a) {
+        return wrap(a).not();
+    },
+    // ---------------------------------------------------------------------------
+    // Null-handling / Conditional
+    // ---------------------------------------------------------------------------
+    firstDefined(...args) {
+        if (args.length < 2) {
+            throw new Error('Expr.firstDefined() requires at least 2 arguments');
+        }
+        return new ExpressionNode_js_1.ExpressionNode({
+            kind: 'function_expr',
+            name: 'COALESCE',
+            args: args.map(ExpressionNode_js_1.toIRExpression),
+        });
+    },
+    ifThen(cond, thenVal, elseVal) {
+        return new ExpressionNode_js_1.ExpressionNode({
+            kind: 'function_expr',
+            name: 'IF',
+            args: [(0, ExpressionNode_js_1.toIRExpression)(cond), (0, ExpressionNode_js_1.toIRExpression)(thenVal), (0, ExpressionNode_js_1.toIRExpression)(elseVal)],
+        });
+    },
+    bound(a) {
+        return wrap(a).isDefined();
+    },
+    // ---------------------------------------------------------------------------
+    // RDF introspection
+    // ---------------------------------------------------------------------------
+    lang(a) {
+        return wrap(a).lang();
+    },
+    datatype(a) {
+        return wrap(a).datatype();
+    },
+    str(a) {
+        return wrap(a).str();
+    },
+    iri(a) {
+        return wrap(a).iri();
+    },
+    isIri(a) {
+        return wrap(a).isIri();
+    },
+    isLiteral(a) {
+        return wrap(a).isLiteral();
+    },
+    isBlank(a) {
+        return wrap(a).isBlank();
+    },
+    isNumeric(a) {
+        return wrap(a).isNumeric();
+    },
+    // ---------------------------------------------------------------------------
+    // Hash
+    // ---------------------------------------------------------------------------
+    md5(a) {
+        return wrap(a).md5();
+    },
+    sha256(a) {
+        return wrap(a).sha256();
+    },
+    sha512(a) {
+        return wrap(a).sha512();
+    },
+};
+//# sourceMappingURL=Expr.js.map

package/lib/cjs/expressions/Expr.js.map

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

package/lib/cjs/expressions/ExpressionMethods.d.ts

@@ -0,0 +1,81 @@
+import { ExpressionInput, ExpressionNode } from './ExpressionNode.js';
+import { Shape } from '../shapes/Shape.js';
+import { ShapeSet } from '../collections/ShapeSet.js';
+export interface BaseExpressionMethods {
+    eq(v: ExpressionInput): ExpressionNode;
+    equals(v: ExpressionInput): ExpressionNode;
+    neq(v: ExpressionInput): ExpressionNode;
+    notEquals(v: ExpressionInput): ExpressionNode;
+    isDefined(): ExpressionNode;
+    isNotDefined(): ExpressionNode;
+    defaultTo(fallback: ExpressionInput): ExpressionNode;
+    str(): ExpressionNode;
+}
+export interface NumericExpressionMethods extends BaseExpressionMethods {
+    plus(n: ExpressionInput): ExpressionNode;
+    minus(n: ExpressionInput): ExpressionNode;
+    times(n: ExpressionInput): ExpressionNode;
+    divide(n: ExpressionInput): ExpressionNode;
+    abs(): ExpressionNode;
+    round(): ExpressionNode;
+    ceil(): ExpressionNode;
+    floor(): ExpressionNode;
+    power(n: number): ExpressionNode;
+    gt(v: ExpressionInput): ExpressionNode;
+    greaterThan(v: ExpressionInput): ExpressionNode;
+    gte(v: ExpressionInput): ExpressionNode;
+    greaterThanOrEqual(v: ExpressionInput): ExpressionNode;
+    lt(v: ExpressionInput): ExpressionNode;
+    lessThan(v: ExpressionInput): ExpressionNode;
+    lte(v: ExpressionInput): ExpressionNode;
+    lessThanOrEqual(v: ExpressionInput): ExpressionNode;
+}
+export interface StringExpressionMethods extends BaseExpressionMethods {
+    concat(...parts: ExpressionInput[]): ExpressionNode;
+    contains(s: ExpressionInput): ExpressionNode;
+    startsWith(s: ExpressionInput): ExpressionNode;
+    endsWith(s: ExpressionInput): ExpressionNode;
+    substr(start: number, len?: number): ExpressionNode;
+    before(s: ExpressionInput): ExpressionNode;
+    after(s: ExpressionInput): ExpressionNode;
+    replace(pat: string, rep: string, flags?: string): ExpressionNode;
+    ucase(): ExpressionNode;
+    lcase(): ExpressionNode;
+    strlen(): ExpressionNode;
+    encodeForUri(): ExpressionNode;
+    matches(pat: string, flags?: string): ExpressionNode;
+    gt(v: ExpressionInput): ExpressionNode;
+    lt(v: ExpressionInput): ExpressionNode;
+    gte(v: ExpressionInput): ExpressionNode;
+    lte(v: ExpressionInput): ExpressionNode;
+}
+export interface DateExpressionMethods extends BaseExpressionMethods {
+    year(): ExpressionNode;
+    month(): ExpressionNode;
+    day(): ExpressionNode;
+    hours(): ExpressionNode;
+    minutes(): ExpressionNode;
+    seconds(): ExpressionNode;
+    timezone(): ExpressionNode;
+    tz(): ExpressionNode;
+    gt(v: ExpressionInput): ExpressionNode;
+    lt(v: ExpressionInput): ExpressionNode;
+    gte(v: ExpressionInput): ExpressionNode;
+    lte(v: ExpressionInput): ExpressionNode;
+}
+export interface BooleanExpressionMethods extends BaseExpressionMethods {
+    and(expr: ExpressionInput): ExpressionNode;
+    or(expr: ExpressionInput): ExpressionNode;
+    not(): ExpressionNode;
+}
+type DataKeys<S> = {
+    [K in keyof S]: K extends 'node' | 'nodeShape' | 'namedNode' | 'targetClass' | 'toString' | 'id' | 'uri' | '__queryContextId' ? never : S[K] extends (...args: any[]) => any ? never : K;
+}[keyof S];
+type ToExpressionProxy<T> = T extends number ? number & NumericExpressionMethods : T extends string ? string & StringExpressionMethods : T extends Date ? Date & DateExpressionMethods : T extends boolean ? boolean & BooleanExpressionMethods : T extends Shape ? ExpressionUpdateProxy<T> : T;
+export type ExpressionUpdateProxy<S> = {
+    readonly [P in DataKeys<S>]: S[P] extends ShapeSet<any> ? never : ToExpressionProxy<S[P]>;
+};
+export type ExpressionUpdateResult<S> = {
+    [P in DataKeys<S>]?: S[P] extends Shape ? never : S[P] extends ShapeSet<any> ? never : S[P] | ExpressionNode;
+};
+export {};

package/lib/cjs/expressions/ExpressionMethods.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ExpressionMethods.js.map

package/lib/cjs/expressions/ExpressionMethods.js.map

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

package/lib/cjs/expressions/ExpressionNode.d.ts

@@ -0,0 +1,95 @@
+import type { IRExpression } from '../queries/IntermediateRepresentation.js';
+export type ExpressionInput = ExpressionNode | string | number | boolean | Date;
+/**
+ * Map from placeholder sourceAlias → PropertyShape ID segments.
+ * Used to track unresolved property references from proxy tracing
+ * that need to be resolved during IR lowering.
+ */
+export type PropertyRefMap = ReadonlyMap<string, readonly string[]>;
+export declare function toIRExpression(input: ExpressionInput): IRExpression;
+export declare class ExpressionNode {
+    readonly ir: IRExpression;
+    /** Property reference map for unresolved proxy-traced property references. */
+    readonly _refs: PropertyRefMap;
+    constructor(ir: IRExpression, refs?: PropertyRefMap);
+    /** Create a derived node that merges refs from this and other inputs. */
+    private _derive;
+    /** Create a derived node with no additional inputs. */
+    private _wrap;
+    plus(n: ExpressionInput): ExpressionNode;
+    minus(n: ExpressionInput): ExpressionNode;
+    times(n: ExpressionInput): ExpressionNode;
+    divide(n: ExpressionInput): ExpressionNode;
+    abs(): ExpressionNode;
+    round(): ExpressionNode;
+    ceil(): ExpressionNode;
+    floor(): ExpressionNode;
+    power(n: number): ExpressionNode;
+    eq(v: ExpressionInput): ExpressionNode;
+    equals(v: ExpressionInput): ExpressionNode;
+    neq(v: ExpressionInput): ExpressionNode;
+    notEquals(v: ExpressionInput): ExpressionNode;
+    gt(v: ExpressionInput): ExpressionNode;
+    greaterThan(v: ExpressionInput): ExpressionNode;
+    gte(v: ExpressionInput): ExpressionNode;
+    greaterThanOrEqual(v: ExpressionInput): ExpressionNode;
+    lt(v: ExpressionInput): ExpressionNode;
+    lessThan(v: ExpressionInput): ExpressionNode;
+    lte(v: ExpressionInput): ExpressionNode;
+    lessThanOrEqual(v: ExpressionInput): ExpressionNode;
+    concat(...parts: ExpressionInput[]): ExpressionNode;
+    contains(s: ExpressionInput): ExpressionNode;
+    startsWith(s: ExpressionInput): ExpressionNode;
+    endsWith(s: ExpressionInput): ExpressionNode;
+    substr(start: number, len?: number): ExpressionNode;
+    before(s: ExpressionInput): ExpressionNode;
+    after(s: ExpressionInput): ExpressionNode;
+    replace(pat: string, rep: string, flags?: string): ExpressionNode;
+    ucase(): ExpressionNode;
+    lcase(): ExpressionNode;
+    strlen(): ExpressionNode;
+    encodeForUri(): ExpressionNode;
+    matches(pat: string, flags?: string): ExpressionNode;
+    year(): ExpressionNode;
+    month(): ExpressionNode;
+    day(): ExpressionNode;
+    hours(): ExpressionNode;
+    minutes(): ExpressionNode;
+    seconds(): ExpressionNode;
+    timezone(): ExpressionNode;
+    tz(): ExpressionNode;
+    and(expr: ExpressionInput): ExpressionNode;
+    or(expr: ExpressionInput): ExpressionNode;
+    not(): ExpressionNode;
+    isDefined(): ExpressionNode;
+    isNotDefined(): ExpressionNode;
+    defaultTo(fallback: ExpressionInput): ExpressionNode;
+    lang(): ExpressionNode;
+    datatype(): ExpressionNode;
+    str(): ExpressionNode;
+    iri(): ExpressionNode;
+    isIri(): ExpressionNode;
+    isLiteral(): ExpressionNode;
+    isBlank(): ExpressionNode;
+    isNumeric(): ExpressionNode;
+    md5(): ExpressionNode;
+    sha256(): ExpressionNode;
+    sha512(): ExpressionNode;
+}
+/**
+ * Create an ExpressionNode from a proxy-traced property access.
+ * Uses a placeholder sourceAlias that gets resolved during IR lowering.
+ *
+ * The segments array maps to a property path (e.g. ['bestFriend', 'name']).
+ * Only the last segment becomes the property_expr's .property; earlier segments
+ * are stored in the refs map and resolved as traversals during lowering.
+ */
+export declare function tracedPropertyExpression(segmentIds: readonly string[]): ExpressionNode;
+/**
+ * Resolve unresolved property references in an IRExpression tree.
+ * Walks the tree and replaces placeholder sourceAlias values with
+ * real aliases resolved via pathOptions.
+ */
+export declare function resolveExpressionRefs(expr: IRExpression, refs: PropertyRefMap, rootAlias: string, resolveTraversal: (fromAlias: string, propertyShapeId: string) => string): IRExpression;
+/** Check if a value is an ExpressionNode. */
+export declare function isExpressionNode(value: unknown): value is ExpressionNode;