@onerjs/core 8.54.4 → 8.54.6

package/FlowGraph/flowGraphHostResolver.js

@@ -0,0 +1,25 @@
+/** This file must only contain pure code and pure imports */
+/**
+ * Prefix used by the default event-reference format.
+ *
+ * A host that maps behavior graphs onto its own object model (for example the glTF
+ * `KHR_interactivity` loader) supplies its own format through {@link IFlowGraphHostResolver}.
+ */
+export const FlowGraphDefaultEventReferencePrefix = "flowgraph://events/";
+/**
+ * Builds the default reference for an event source key.
+ * @param key the event source key (e.g. `"sceneReady"`, `"sceneTick"`, or a custom event id)
+ * @returns the event reference
+ */
+export function GetDefaultEventReference(key) {
+    return FlowGraphDefaultEventReferencePrefix + key;
+}
+/**
+ * Extracts the event source key from a default-format event reference.
+ * @param reference the value to decode
+ * @returns the event source key, or `undefined` when the value is not an event reference
+ */
+export function GetDefaultEventReferenceKey(reference) {
+    return reference.startsWith(FlowGraphDefaultEventReferencePrefix) ? reference.substring(FlowGraphDefaultEventReferencePrefix.length) : undefined;
+}
+//# sourceMappingURL=flowGraphHostResolver.js.map

package/FlowGraph/flowGraphHostResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowGraphHostResolver.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphHostResolver.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,qBAAqB,CAAC;AAE1E;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAChD,OAAO,oCAAoC,GAAG,GAAG,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAAiB;IACzD,OAAO,SAAS,CAAC,UAAU,CAAC,oCAAoC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,oCAAoC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrJ,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\n/**\r\n * Prefix used by the default event-reference format.\r\n *\r\n * A host that maps behavior graphs onto its own object model (for example the glTF\r\n * `KHR_interactivity` loader) supplies its own format through {@link IFlowGraphHostResolver}.\r\n */\r\nexport const FlowGraphDefaultEventReferencePrefix = \"flowgraph://events/\";\r\n\r\n/**\r\n * Builds the default reference for an event source key.\r\n * @param key the event source key (e.g. `\"sceneReady\"`, `\"sceneTick\"`, or a custom event id)\r\n * @returns the event reference\r\n */\r\nexport function GetDefaultEventReference(key: string): string {\r\n    return FlowGraphDefaultEventReferencePrefix + key;\r\n}\r\n\r\n/**\r\n * Extracts the event source key from a default-format event reference.\r\n * @param reference the value to decode\r\n * @returns the event source key, or `undefined` when the value is not an event reference\r\n */\r\nexport function GetDefaultEventReferenceKey(reference: string): string | undefined {\r\n    return reference.startsWith(FlowGraphDefaultEventReferencePrefix) ? reference.substring(FlowGraphDefaultEventReferencePrefix.length) : undefined;\r\n}\r\n\r\n/**\r\n * Lets the environment hosting a flow graph decide how runtime entities are represented as opaque\r\n * reference values, so the graph engine itself stays agnostic of the host's object model.\r\n *\r\n * A host (e.g. a glTF loader extension) provides an implementation through\r\n * {@link IFlowGraphCoordinatorConfiguration.hostResolver}. Every member is optional; the engine\r\n * falls back to a neutral built-in representation for anything the host does not provide.\r\n */\r\nexport interface IFlowGraphHostResolver {\r\n    /**\r\n     * Encodes an event source key as the opaque reference exposed by event blocks on their\r\n     * `event` output.\r\n     *\r\n     * References must be stable: two calls with the same key must produce equal values so that\r\n     * equality comparisons of two `event` outputs of the same source succeed.\r\n     * @param key the event source key\r\n     * @returns the reference representing the event source\r\n     */\r\n    encodeEventReference?(key: string): string;\r\n\r\n    /**\r\n     * Decodes an event reference produced by {@link IFlowGraphHostResolver.encodeEventReference}\r\n     * back into its event source key. Must return `undefined` for values that are not event\r\n     * references.\r\n     * @param reference the reference to decode\r\n     * @returns the event source key, or `undefined` when the value is not an event reference\r\n     */\r\n    decodeEventReference?(reference: string): string | undefined;\r\n\r\n    /**\r\n     * Decodes the array index denoted by a reference, for cases where a reference addresses an\r\n     * element of one of the host's collections. Must return `undefined` for values the host does\r\n     * not recognise as an indexed reference.\r\n     * @param reference the reference to decode\r\n     * @returns the index the reference denotes, or `undefined` when it does not denote one\r\n     */\r\n    decodeIndexReference?(reference: string): number | undefined;\r\n\r\n    /**\r\n     * Maps a runtime object to the reference the host addresses it by, for example the JSON\r\n     * Pointer of the resource a loaded object originates from.\r\n     *\r\n     * Used when an object value is supplied to a templated path input. Returning `undefined`\r\n     * means the host cannot address the object, and the value is rejected.\r\n     * @param object the runtime object to address\r\n     * @param hint optional disambiguation hint, taken from the path segment preceding the template\r\n     * parameter being resolved. A single object may be addressable in several ways, and the hint\r\n     * tells the host which kind of reference the graph is asking for.\r\n     * @returns the reference for the object, or `undefined` when it cannot be addressed\r\n     */\r\n    getObjectReference?(object: object, hint?: string): string | undefined;\r\n}\r\n"]}

package/FlowGraph/flowGraphMath.d.ts

@@ -1,5 +1,5 @@
 import { type IQuaternionLike } from "../Maths/math.like.js";
-import { Quaternion, Vector3 } from "../Maths/math.vector.pure.js";
+import { Quaternion, Vector2, Vector3 } from "../Maths/math.vector.pure.js";
 import { type DeepImmutable } from "../types.js";
 /**
  * Returns the angle in radians between two quaternions
@@ -23,3 +23,50 @@ export declare function GetQuaternionFromDirections<T extends Vector3>(a: DeepIm
  * @returns the target quaternion
  */
 export declare function GetQuaternionFromDirectionsToRef<T extends Vector3, ResultT extends Quaternion>(a: DeepImmutable<T>, b: DeepImmutable<T>, result: ResultT): ResultT;
+/**
+ * Spherical linear interpolation between two 2D vectors.
+ * NaN and infinity values are propagated through the arithmetic.
+ * @param a the first vector
+ * @param b the second vector
+ * @param c the (unclamped) interpolation coefficient
+ * @returns the interpolated 2D vector
+ */
+export declare function GetVector2Slerp(a: DeepImmutable<Vector2>, b: DeepImmutable<Vector2>, c: number): Vector2;
+/**
+ * Spherical linear interpolation between two 3D vectors.
+ * NaN and infinity values are propagated through the arithmetic.
+ * @param a the first vector
+ * @param b the second vector
+ * @param c the (unclamped) interpolation coefficient
+ * @returns the interpolated 3D vector
+ */
+export declare function GetVector3Slerp(a: DeepImmutable<Vector3>, b: DeepImmutable<Vector3>, c: number): Vector3;
+/**
+ * Creates a quaternion from the specified up and forward directions, as defined by the
+ * up/forward quaternion operation. Both inputs are assumed to be unit length.
+ * @param up the up direction
+ * @param forward the forward direction
+ * @returns the rotation quaternion
+ */
+export declare function GetQuaternionFromUpForward(up: DeepImmutable<Vector3>, forward: DeepImmutable<Vector3>): Quaternion;
+/**
+ * The rotation orders accepted by the Euler-angle quaternion operation
+ * (and {@link GetQuaternionFromEulerAngles}). The default order is `yxz`.
+ */
+export declare const QuaternionEulerAngleOrders: readonly ["xyz", "xzy", "yxz", "yzx", "zxy", "zyx"];
+/**
+ * Builds a rotation quaternion from three Tait–Bryan intrinsic Euler angles applied in the
+ * specified order.
+ *
+ * Babylon only exposes the `yxz` order natively (via `Quaternion.RotationYawPitchRoll`), so the
+ * result is composed from the individual per-axis rotations to support every order. For an
+ * intrinsic order `o1o2o3` the result is the Hamilton product `q(o1) * q(o2) * q(o3)`, where each
+ * `q(axis)` is a rotation about that axis; this matches the corresponding reference intrinsic
+ * Tait–Bryan rotation matrices. NaN and infinite angle inputs propagate into the result.
+ * @param order the rotation order, one of {@link QuaternionEulerAngleOrders}; any other value uses the default `yxz`
+ * @param x rotation around the X axis, in radians
+ * @param y rotation around the Y axis, in radians
+ * @param z rotation around the Z axis, in radians
+ * @returns the composed rotation quaternion
+ */
+export declare function GetQuaternionFromEulerAngles(order: string, x: number, y: number, z: number): Quaternion;

package/FlowGraph/flowGraphMath.js

@@ -1,9 +1,36 @@
 import { Clamp } from "../Maths/math.scalar.functions.js";
-import { Quaternion, Vector3 } from "../Maths/math.vector.pure.js";
+import { Matrix, Quaternion, Vector2, Vector3 } from "../Maths/math.vector.pure.js";
 import { Vector3Dot, Vector4Dot } from "../Maths/math.vector.functions.js";
 // *** NOTE ***
 // These functions should ideally go in math.vector.functions.ts, but they require math.vector.ts to
 // be imported which is big. To avoid the larger bundle size, they are kept inside flow graph for now.
+/**
+ * Implementation-defined threshold used by the slerp and up/forward quaternion operations
+ * to detect near-zero lengths and (anti)parallel vectors.
+ */
+const SlerpEpsilon = 1e-6;
+/**
+ * Returns a unit vector perpendicular to the provided vector.
+ * @param v the input vector (does not need to be unit length)
+ * @returns a unit vector perpendicular to `v`
+ */
+function GetAnyPerpendicularVector(v) {
+    const absX = Math.abs(v.x);
+    const absY = Math.abs(v.y);
+    const absZ = Math.abs(v.z);
+    // Cross with whichever cardinal axis is least aligned with `v` to avoid a degenerate cross product.
+    let other;
+    if (absX <= absY && absX <= absZ) {
+        other = Vector3.RightReadOnly;
+    }
+    else if (absY <= absZ) {
+        other = Vector3.UpReadOnly;
+    }
+    else {
+        other = Vector3.LeftHandedForwardReadOnly;
+    }
+    return Vector3.Cross(v, other).normalize();
+}
 /**
  * Returns the angle in radians between two quaternions
  * @param q1 defines the first quaternion
@@ -32,9 +59,147 @@ export function GetQuaternionFromDirections(a, b) {
  * @returns the target quaternion
  */
 export function GetQuaternionFromDirectionsToRef(a, b, result) {
-    const axis = Vector3.Cross(a, b);
-    const angle = Math.acos(Clamp(Vector3Dot(a, b), -1, 1));
-    Quaternion.RotationAxisToRef(axis, angle, result);
+    const dot = Vector3Dot(a, b);
+    if (Number.isFinite(dot) && dot > 1 - SlerpEpsilon) {
+        result.copyFromFloats(0, 0, 0, 1);
+        return result;
+    }
+    if (Number.isFinite(dot) && dot < -1 + SlerpEpsilon) {
+        const axis = GetAnyPerpendicularVector(a);
+        result.copyFromFloats(axis.x, axis.y, axis.z, 0);
+        return result;
+    }
+    const axis = Vector3.Cross(a, b).normalize();
+    const axisScale = Math.sqrt(0.5 - 0.5 * dot);
+    result.copyFromFloats(axis.x * axisScale, axis.y * axisScale, axis.z * axisScale, Math.sqrt(0.5 + 0.5 * dot));
     return result;
 }
+/**
+ * Spherical linear interpolation between two 2D vectors.
+ * NaN and infinity values are propagated through the arithmetic.
+ * @param a the first vector
+ * @param b the second vector
+ * @param c the (unclamped) interpolation coefficient
+ * @returns the interpolated 2D vector
+ */
+export function GetVector2Slerp(a, b, c) {
+    const lengthA = Math.sqrt(a.x * a.x + a.y * a.y);
+    const lengthB = Math.sqrt(b.x * b.x + b.y * b.y);
+    // If either vector is (close to) zero length the rotation is undefined; fall back to a linear interpolation.
+    if (lengthA < SlerpEpsilon || lengthB < SlerpEpsilon) {
+        return new Vector2((1 - c) * a.x + c * b.x, (1 - c) * a.y + c * b.y);
+    }
+    const aHatX = a.x / lengthA;
+    const aHatY = a.y / lengthA;
+    const bHatX = b.x / lengthB;
+    const bHatY = b.y / lengthB;
+    let theta = Math.acos(Clamp(aHatX * bHatX + aHatY * bHatY, -1, 1));
+    if (aHatX * bHatY - aHatY * bHatX < 0) {
+        theta = -theta;
+    }
+    const length = (1 - c) * lengthA + c * lengthB;
+    const cosCTheta = Math.cos(c * theta);
+    const sinCTheta = Math.sin(c * theta);
+    return new Vector2((aHatX * cosCTheta - aHatY * sinCTheta) * length, (aHatX * sinCTheta + aHatY * cosCTheta) * length);
+}
+/**
+ * Spherical linear interpolation between two 3D vectors.
+ * NaN and infinity values are propagated through the arithmetic.
+ * @param a the first vector
+ * @param b the second vector
+ * @param c the (unclamped) interpolation coefficient
+ * @returns the interpolated 3D vector
+ */
+export function GetVector3Slerp(a, b, c) {
+    const lengthA = a.length();
+    const lengthB = b.length();
+    const lerp = () => new Vector3((1 - c) * a.x + c * b.x, (1 - c) * a.y + c * b.y, (1 - c) * a.z + c * b.z);
+    // If either vector is (close to) zero length the rotation is undefined; fall back to a linear interpolation.
+    if (lengthA < SlerpEpsilon || lengthB < SlerpEpsilon) {
+        return lerp();
+    }
+    const aHat = new Vector3(a.x / lengthA, a.y / lengthA, a.z / lengthA);
+    const bHat = new Vector3(b.x / lengthB, b.y / lengthB, b.z / lengthB);
+    const dot = Vector3Dot(aHat, bHat);
+    // Parallel vectors share a direction; a linear interpolation already produces the correct result.
+    if (dot > 1 - SlerpEpsilon) {
+        return lerp();
+    }
+    let rotationAxis;
+    if (dot < -1 + SlerpEpsilon) {
+        // Anti-parallel vectors: any axis perpendicular to aHat is a valid rotation axis.
+        rotationAxis = GetAnyPerpendicularVector(aHat);
+    }
+    else {
+        rotationAxis = Vector3.Cross(aHat, bHat).normalize();
+    }
+    const angle = c * Math.acos(Clamp(dot, -1, 1));
+    const rotation = Quaternion.RotationAxis(rotationAxis, angle);
+    const length = (1 - c) * lengthA + c * lengthB;
+    return aHat.applyRotationQuaternion(rotation).scaleInPlace(length);
+}
+/**
+ * Creates a quaternion from the specified up and forward directions, as defined by the
+ * up/forward quaternion operation. Both inputs are assumed to be unit length.
+ * @param up the up direction
+ * @param forward the forward direction
+ * @returns the rotation quaternion
+ */
+export function GetQuaternionFromUpForward(up, forward) {
+    const r = new Vector3(forward.x, forward.y, forward.z);
+    let s = Vector3.Cross(up, r);
+    if (s.lengthSquared() < SlerpEpsilon * SlerpEpsilon) {
+        // up and forward are colinear; pick any unit vector perpendicular to forward.
+        s = GetAnyPerpendicularVector(r);
+    }
+    else {
+        s.normalize();
+    }
+    const t = Vector3.Cross(r, s);
+    // Build the rotation matrix with columns s, t and r (Babylon matrices are column-major) and convert it.
+    const matrix = Matrix.FromValues(s.x, s.y, s.z, 0, t.x, t.y, t.z, 0, r.x, r.y, r.z, 0, 0, 0, 0, 1);
+    return Quaternion.FromRotationMatrix(matrix);
+}
+/**
+ * The rotation orders accepted by the Euler-angle quaternion operation
+ * (and {@link GetQuaternionFromEulerAngles}). The default order is `yxz`.
+ */
+export const QuaternionEulerAngleOrders = ["xyz", "xzy", "yxz", "yzx", "zxy", "zyx"];
+/**
+ * Builds a rotation quaternion from three Tait–Bryan intrinsic Euler angles applied in the
+ * specified order.
+ *
+ * Babylon only exposes the `yxz` order natively (via `Quaternion.RotationYawPitchRoll`), so the
+ * result is composed from the individual per-axis rotations to support every order. For an
+ * intrinsic order `o1o2o3` the result is the Hamilton product `q(o1) * q(o2) * q(o3)`, where each
+ * `q(axis)` is a rotation about that axis; this matches the corresponding reference intrinsic
+ * Tait–Bryan rotation matrices. NaN and infinite angle inputs propagate into the result.
+ * @param order the rotation order, one of {@link QuaternionEulerAngleOrders}; any other value uses the default `yxz`
+ * @param x rotation around the X axis, in radians
+ * @param y rotation around the Y axis, in radians
+ * @param z rotation around the Z axis, in radians
+ * @returns the composed rotation quaternion
+ */
+export function GetQuaternionFromEulerAngles(order, x, y, z) {
+    const qx = Quaternion.RotationAxis(Vector3.RightReadOnly, x);
+    const qy = Quaternion.RotationAxis(Vector3.UpReadOnly, y);
+    const qz = Quaternion.RotationAxis(Vector3.LeftHandedForwardReadOnly, z);
+    // `a.multiplyInPlace(b)` computes the Hamilton product `a * b` in place and returns `a`.
+    switch (order) {
+        case "xyz":
+            return qx.multiplyInPlace(qy).multiplyInPlace(qz);
+        case "xzy":
+            return qx.multiplyInPlace(qz).multiplyInPlace(qy);
+        case "yzx":
+            return qy.multiplyInPlace(qz).multiplyInPlace(qx);
+        case "zxy":
+            return qz.multiplyInPlace(qx).multiplyInPlace(qy);
+        case "zyx":
+            return qz.multiplyInPlace(qy).multiplyInPlace(qx);
+        case "yxz":
+        default:
+            // Default order.
+            return qy.multiplyInPlace(qx).multiplyInPlace(qz);
+    }
+}
 //# sourceMappingURL=flowGraphMath.js.map

package/FlowGraph/flowGraphMath.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphMath.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphMath.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAGxE,eAAe;AACf,oGAAoG;AACpG,sGAAsG;AAEtG;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,EAAkC,EAAE,EAAkC;IAC7G,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAoB,CAAmB,EAAE,CAAmB;IACnG,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAChC,gCAAgC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAAgD,CAAmB,EAAE,CAAmB,EAAE,MAAe;IACrJ,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["import { type IQuaternionLike } from \"../Maths/math.like\";\r\nimport { Clamp } from \"../Maths/math.scalar.functions\";\r\nimport { Quaternion, Vector3 } from \"../Maths/math.vector.pure\";\r\nimport { Vector3Dot, Vector4Dot } from \"../Maths/math.vector.functions\";\r\nimport { type DeepImmutable } from \"../types\";\r\n\r\n// *** NOTE ***\r\n// These functions should ideally go in math.vector.functions.ts, but they require math.vector.ts to\r\n// be imported which is big. To avoid the larger bundle size, they are kept inside flow graph for now.\r\n\r\n/**\r\n * Returns the angle in radians between two quaternions\r\n * @param q1 defines the first quaternion\r\n * @param q2 defines the second quaternion\r\n * @returns the angle in radians between the two quaternions\r\n */\r\nexport function GetAngleBetweenQuaternions(q1: DeepImmutable<IQuaternionLike>, q2: DeepImmutable<IQuaternionLike>): number {\r\n    return Math.acos(Clamp(Vector4Dot(q1, q2), -1, 1)) * 2;\r\n}\r\n\r\n/**\r\n * Creates a quaternion from two direction vectors\r\n * @param a defines the first direction vector\r\n * @param b defines the second direction vector\r\n * @returns the target quaternion\r\n */\r\nexport function GetQuaternionFromDirections<T extends Vector3>(a: DeepImmutable<T>, b: DeepImmutable<T>): Quaternion {\r\n    const result = new Quaternion();\r\n    GetQuaternionFromDirectionsToRef(a, b, result);\r\n    return result;\r\n}\r\n\r\n/**\r\n * Creates a quaternion from two direction vectors\r\n * @param a defines the first direction vector\r\n * @param b defines the second direction vector\r\n * @param result defines the target quaternion\r\n * @returns the target quaternion\r\n */\r\nexport function GetQuaternionFromDirectionsToRef<T extends Vector3, ResultT extends Quaternion>(a: DeepImmutable<T>, b: DeepImmutable<T>, result: ResultT): ResultT {\r\n    const axis = Vector3.Cross(a, b);\r\n    const angle = Math.acos(Clamp(Vector3Dot(a, b), -1, 1));\r\n    Quaternion.RotationAxisToRef(axis, angle, result);\r\n    return result;\r\n}\r\n"]}
+{"version":3,"file":"flowGraphMath.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphMath.ts"],"names":[],"mappings":"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","sourcesContent":["import { type IQuaternionLike } from \"../Maths/math.like\";\r\nimport { Clamp } from \"../Maths/math.scalar.functions\";\r\nimport { Matrix, Quaternion, Vector2, Vector3 } from \"../Maths/math.vector.pure\";\r\nimport { Vector3Dot, Vector4Dot } from \"../Maths/math.vector.functions\";\r\nimport { type DeepImmutable } from \"../types\";\r\n\r\n// *** NOTE ***\r\n// These functions should ideally go in math.vector.functions.ts, but they require math.vector.ts to\r\n// be imported which is big. To avoid the larger bundle size, they are kept inside flow graph for now.\r\n\r\n/**\r\n * Implementation-defined threshold used by the slerp and up/forward quaternion operations\r\n * to detect near-zero lengths and (anti)parallel vectors.\r\n */\r\nconst SlerpEpsilon = 1e-6;\r\n\r\n/**\r\n * Returns a unit vector perpendicular to the provided vector.\r\n * @param v the input vector (does not need to be unit length)\r\n * @returns a unit vector perpendicular to `v`\r\n */\r\nfunction GetAnyPerpendicularVector(v: DeepImmutable<Vector3>): Vector3 {\r\n    const absX = Math.abs(v.x);\r\n    const absY = Math.abs(v.y);\r\n    const absZ = Math.abs(v.z);\r\n    // Cross with whichever cardinal axis is least aligned with `v` to avoid a degenerate cross product.\r\n    let other: DeepImmutable<Vector3>;\r\n    if (absX <= absY && absX <= absZ) {\r\n        other = Vector3.RightReadOnly;\r\n    } else if (absY <= absZ) {\r\n        other = Vector3.UpReadOnly;\r\n    } else {\r\n        other = Vector3.LeftHandedForwardReadOnly;\r\n    }\r\n    return Vector3.Cross(v, other).normalize();\r\n}\r\n\r\n/**\r\n * Returns the angle in radians between two quaternions\r\n * @param q1 defines the first quaternion\r\n * @param q2 defines the second quaternion\r\n * @returns the angle in radians between the two quaternions\r\n */\r\nexport function GetAngleBetweenQuaternions(q1: DeepImmutable<IQuaternionLike>, q2: DeepImmutable<IQuaternionLike>): number {\r\n    return Math.acos(Clamp(Vector4Dot(q1, q2), -1, 1)) * 2;\r\n}\r\n\r\n/**\r\n * Creates a quaternion from two direction vectors\r\n * @param a defines the first direction vector\r\n * @param b defines the second direction vector\r\n * @returns the target quaternion\r\n */\r\nexport function GetQuaternionFromDirections<T extends Vector3>(a: DeepImmutable<T>, b: DeepImmutable<T>): Quaternion {\r\n    const result = new Quaternion();\r\n    GetQuaternionFromDirectionsToRef(a, b, result);\r\n    return result;\r\n}\r\n\r\n/**\r\n * Creates a quaternion from two direction vectors\r\n * @param a defines the first direction vector\r\n * @param b defines the second direction vector\r\n * @param result defines the target quaternion\r\n * @returns the target quaternion\r\n */\r\nexport function GetQuaternionFromDirectionsToRef<T extends Vector3, ResultT extends Quaternion>(a: DeepImmutable<T>, b: DeepImmutable<T>, result: ResultT): ResultT {\r\n    const dot = Vector3Dot(a, b);\r\n    if (Number.isFinite(dot) && dot > 1 - SlerpEpsilon) {\r\n        result.copyFromFloats(0, 0, 0, 1);\r\n        return result;\r\n    }\r\n    if (Number.isFinite(dot) && dot < -1 + SlerpEpsilon) {\r\n        const axis = GetAnyPerpendicularVector(a);\r\n        result.copyFromFloats(axis.x, axis.y, axis.z, 0);\r\n        return result;\r\n    }\r\n\r\n    const axis = Vector3.Cross(a, b).normalize();\r\n    const axisScale = Math.sqrt(0.5 - 0.5 * dot);\r\n    result.copyFromFloats(axis.x * axisScale, axis.y * axisScale, axis.z * axisScale, Math.sqrt(0.5 + 0.5 * dot));\r\n    return result;\r\n}\r\n\r\n/**\r\n * Spherical linear interpolation between two 2D vectors.\r\n * NaN and infinity values are propagated through the arithmetic.\r\n * @param a the first vector\r\n * @param b the second vector\r\n * @param c the (unclamped) interpolation coefficient\r\n * @returns the interpolated 2D vector\r\n */\r\nexport function GetVector2Slerp(a: DeepImmutable<Vector2>, b: DeepImmutable<Vector2>, c: number): Vector2 {\r\n    const lengthA = Math.sqrt(a.x * a.x + a.y * a.y);\r\n    const lengthB = Math.sqrt(b.x * b.x + b.y * b.y);\r\n    // If either vector is (close to) zero length the rotation is undefined; fall back to a linear interpolation.\r\n    if (lengthA < SlerpEpsilon || lengthB < SlerpEpsilon) {\r\n        return new Vector2((1 - c) * a.x + c * b.x, (1 - c) * a.y + c * b.y);\r\n    }\r\n    const aHatX = a.x / lengthA;\r\n    const aHatY = a.y / lengthA;\r\n    const bHatX = b.x / lengthB;\r\n    const bHatY = b.y / lengthB;\r\n    let theta = Math.acos(Clamp(aHatX * bHatX + aHatY * bHatY, -1, 1));\r\n    if (aHatX * bHatY - aHatY * bHatX < 0) {\r\n        theta = -theta;\r\n    }\r\n    const length = (1 - c) * lengthA + c * lengthB;\r\n    const cosCTheta = Math.cos(c * theta);\r\n    const sinCTheta = Math.sin(c * theta);\r\n    return new Vector2((aHatX * cosCTheta - aHatY * sinCTheta) * length, (aHatX * sinCTheta + aHatY * cosCTheta) * length);\r\n}\r\n\r\n/**\r\n * Spherical linear interpolation between two 3D vectors.\r\n * NaN and infinity values are propagated through the arithmetic.\r\n * @param a the first vector\r\n * @param b the second vector\r\n * @param c the (unclamped) interpolation coefficient\r\n * @returns the interpolated 3D vector\r\n */\r\nexport function GetVector3Slerp(a: DeepImmutable<Vector3>, b: DeepImmutable<Vector3>, c: number): Vector3 {\r\n    const lengthA = a.length();\r\n    const lengthB = b.length();\r\n    const lerp = () => new Vector3((1 - c) * a.x + c * b.x, (1 - c) * a.y + c * b.y, (1 - c) * a.z + c * b.z);\r\n    // If either vector is (close to) zero length the rotation is undefined; fall back to a linear interpolation.\r\n    if (lengthA < SlerpEpsilon || lengthB < SlerpEpsilon) {\r\n        return lerp();\r\n    }\r\n    const aHat = new Vector3(a.x / lengthA, a.y / lengthA, a.z / lengthA);\r\n    const bHat = new Vector3(b.x / lengthB, b.y / lengthB, b.z / lengthB);\r\n    const dot = Vector3Dot(aHat, bHat);\r\n    // Parallel vectors share a direction; a linear interpolation already produces the correct result.\r\n    if (dot > 1 - SlerpEpsilon) {\r\n        return lerp();\r\n    }\r\n    let rotationAxis: Vector3;\r\n    if (dot < -1 + SlerpEpsilon) {\r\n        // Anti-parallel vectors: any axis perpendicular to aHat is a valid rotation axis.\r\n        rotationAxis = GetAnyPerpendicularVector(aHat);\r\n    } else {\r\n        rotationAxis = Vector3.Cross(aHat, bHat).normalize();\r\n    }\r\n    const angle = c * Math.acos(Clamp(dot, -1, 1));\r\n    const rotation = Quaternion.RotationAxis(rotationAxis, angle);\r\n    const length = (1 - c) * lengthA + c * lengthB;\r\n    return aHat.applyRotationQuaternion(rotation).scaleInPlace(length);\r\n}\r\n\r\n/**\r\n * Creates a quaternion from the specified up and forward directions, as defined by the\r\n * up/forward quaternion operation. Both inputs are assumed to be unit length.\r\n * @param up the up direction\r\n * @param forward the forward direction\r\n * @returns the rotation quaternion\r\n */\r\nexport function GetQuaternionFromUpForward(up: DeepImmutable<Vector3>, forward: DeepImmutable<Vector3>): Quaternion {\r\n    const r = new Vector3(forward.x, forward.y, forward.z);\r\n    let s = Vector3.Cross(up, r);\r\n    if (s.lengthSquared() < SlerpEpsilon * SlerpEpsilon) {\r\n        // up and forward are colinear; pick any unit vector perpendicular to forward.\r\n        s = GetAnyPerpendicularVector(r);\r\n    } else {\r\n        s.normalize();\r\n    }\r\n    const t = Vector3.Cross(r, s);\r\n    // Build the rotation matrix with columns s, t and r (Babylon matrices are column-major) and convert it.\r\n    const matrix = Matrix.FromValues(s.x, s.y, s.z, 0, t.x, t.y, t.z, 0, r.x, r.y, r.z, 0, 0, 0, 0, 1);\r\n    return Quaternion.FromRotationMatrix(matrix);\r\n}\r\n\r\n/**\r\n * The rotation orders accepted by the Euler-angle quaternion operation\r\n * (and {@link GetQuaternionFromEulerAngles}). The default order is `yxz`.\r\n */\r\nexport const QuaternionEulerAngleOrders = [\"xyz\", \"xzy\", \"yxz\", \"yzx\", \"zxy\", \"zyx\"] as const;\r\n\r\n/**\r\n * Builds a rotation quaternion from three Tait–Bryan intrinsic Euler angles applied in the\r\n * specified order.\r\n *\r\n * Babylon only exposes the `yxz` order natively (via `Quaternion.RotationYawPitchRoll`), so the\r\n * result is composed from the individual per-axis rotations to support every order. For an\r\n * intrinsic order `o1o2o3` the result is the Hamilton product `q(o1) * q(o2) * q(o3)`, where each\r\n * `q(axis)` is a rotation about that axis; this matches the corresponding reference intrinsic\r\n * Tait–Bryan rotation matrices. NaN and infinite angle inputs propagate into the result.\r\n * @param order the rotation order, one of {@link QuaternionEulerAngleOrders}; any other value uses the default `yxz`\r\n * @param x rotation around the X axis, in radians\r\n * @param y rotation around the Y axis, in radians\r\n * @param z rotation around the Z axis, in radians\r\n * @returns the composed rotation quaternion\r\n */\r\nexport function GetQuaternionFromEulerAngles(order: string, x: number, y: number, z: number): Quaternion {\r\n    const qx = Quaternion.RotationAxis(Vector3.RightReadOnly, x);\r\n    const qy = Quaternion.RotationAxis(Vector3.UpReadOnly, y);\r\n    const qz = Quaternion.RotationAxis(Vector3.LeftHandedForwardReadOnly, z);\r\n    // `a.multiplyInPlace(b)` computes the Hamilton product `a * b` in place and returns `a`.\r\n    switch (order) {\r\n        case \"xyz\":\r\n            return qx.multiplyInPlace(qy).multiplyInPlace(qz);\r\n        case \"xzy\":\r\n            return qx.multiplyInPlace(qz).multiplyInPlace(qy);\r\n        case \"yzx\":\r\n            return qy.multiplyInPlace(qz).multiplyInPlace(qx);\r\n        case \"zxy\":\r\n            return qz.multiplyInPlace(qx).multiplyInPlace(qy);\r\n        case \"zyx\":\r\n            return qz.multiplyInPlace(qy).multiplyInPlace(qx);\r\n        case \"yxz\":\r\n        default:\r\n            // Default order.\r\n            return qy.multiplyInPlace(qx).multiplyInPlace(qz);\r\n    }\r\n}\r\n"]}

package/FlowGraph/flowGraphPathConverterComponent.d.ts

@@ -2,8 +2,15 @@ import { type IObjectInfo, type IPathToObjectConverter } from "../ObjectModel/ob
 import { type FlowGraphBlock } from "./flowGraphBlock.js";
 import { type FlowGraphContext } from "./flowGraphContext.js";
 import { type FlowGraphDataConnection } from "./flowGraphDataConnection.js";
-import { FlowGraphInteger } from "./CustomTypes/flowGraphInteger.pure.js";
 import { type IObjectAccessor } from "./typeDefinitions.js";
+interface IPathTemplateInfo {
+    /** Template variable name (without surrounding brackets). */
+    name: string;
+    /** Bracket style used in the source path; preserved so we replace the right placeholder. */
+    style: "curly" | "square";
+    /** The connection that supplies the runtime value for substitution. */
+    connection: FlowGraphDataConnection<any>;
+}
 /**
  * @experimental
  * A component that converts a path to an object accessor.
@@ -12,9 +19,12 @@ export declare class FlowGraphPathConverterComponent {
     path: string;
     ownerBlock: FlowGraphBlock;
     /**
-     * The templated inputs for the provided path.
+     * The templated inputs for the provided path. Values may be FlowGraphInteger, number, or
+     * string (an opaque reference encoded as a JSON Pointer).
      */
-    readonly templatedInputs: FlowGraphDataConnection<FlowGraphInteger>[];
+    readonly templatedInputs: FlowGraphDataConnection<any>[];
+    /** Per-template metadata (name + bracket style + input connection). */
+    readonly templateInfos: IPathTemplateInfo[];
     constructor(path: string, ownerBlock: FlowGraphBlock);
     /**
      * Get the accessor for the path.
@@ -25,3 +35,4 @@ export declare class FlowGraphPathConverterComponent {
      */
     getAccessor(pathConverter: IPathToObjectConverter<IObjectAccessor>, context: FlowGraphContext): IObjectInfo<IObjectAccessor>;
 }
+export {};

package/FlowGraph/flowGraphPathConverterComponent.js

@@ -1,6 +1,16 @@
 import { FlowGraphInteger } from "./CustomTypes/flowGraphInteger.pure.js";
-import { RichTypeFlowGraphInteger } from "./flowGraphRichTypes.pure.js";
-const PathHasTemplatesRegex = new RegExp(/\/\{(\w+)\}(?=\/|$)/g);
+import { RichTypeAny } from "./flowGraphRichTypes.pure.js";
+// JSON Pointer templates may use either bracket style:
+//   {name}  → a reference template parameter.
+//   [name]  → an integer template parameter.
+// Real-world assets mix both conventions, so the bracket style by itself is not enough to determine
+// the input's type. We therefore accept both and decide how to substitute at resolution time based
+// on the runtime value supplied to the input socket (FlowGraphInteger / number → int substitution,
+// string → reference substitution by extracting the matching JSON-Pointer segment).
+// These are constructed per scan rather than shared, because a global regex carries `lastIndex`
+// state across calls and a scan that throws part-way would otherwise leave it set for the next one.
+const CreateRefTemplateRegex = () => new RegExp(/\/\{(\w+)\}(?=\/|$)/g);
+const CreateIntTemplateRegex = () => new RegExp(/\/\[(\w+)\](?=\/|$)/g);
 /**
  * @experimental
  * A component that converts a path to an object accessor.
@@ -10,20 +20,34 @@ export class FlowGraphPathConverterComponent {
         this.path = path;
         this.ownerBlock = ownerBlock;
         /**
-         * The templated inputs for the provided path.
+         * The templated inputs for the provided path. Values may be FlowGraphInteger, number, or
+         * string (an opaque reference encoded as a JSON Pointer).
          */
         this.templatedInputs = [];
-        let match = PathHasTemplatesRegex.exec(path);
+        /** Per-template metadata (name + bracket style + input connection). */
+        this.templateInfos = [];
         const templateSet = new Set();
-        while (match) {
-            const [, matchGroup] = match;
-            if (templateSet.has(matchGroup)) {
-                throw new Error("Duplicate template variable detected.");
+        const collect = (regex, style) => {
+            let match = regex.exec(path);
+            while (match) {
+                const [, name] = match;
+                if (templateSet.has(name)) {
+                    throw new Error("Duplicate template variable detected.");
+                }
+                templateSet.add(name);
+                // Use RichTypeAny so the same socket can receive either an integer (legacy /
+                // [name] style) or a string ref (post-ref-update {name} style); the value's
+                // runtime type drives the substitution behaviour in getAccessor. Default to
+                // FlowGraphInteger(0) — not undefined — so an unconnected index input still
+                // resolves to index 0 (the natural default) instead of throwing at path resolution.
+                const conn = ownerBlock.registerDataInput(name, RichTypeAny, new FlowGraphInteger(0));
+                this.templatedInputs.push(conn);
+                this.templateInfos.push({ name, style, connection: conn });
+                match = regex.exec(path);
             }
-            templateSet.add(matchGroup);
-            this.templatedInputs.push(ownerBlock.registerDataInput(matchGroup, RichTypeFlowGraphInteger, new FlowGraphInteger(0)));
-            match = PathHasTemplatesRegex.exec(path);
-        }
+        };
+        collect(CreateRefTemplateRegex(), "curly");
+        collect(CreateIntTemplateRegex(), "square");
     }
     /**
      * Get the accessor for the path.
@@ -34,14 +58,82 @@ export class FlowGraphPathConverterComponent {
      */
     getAccessor(pathConverter, context) {
         let finalPath = this.path;
-        for (const templatedInput of this.templatedInputs) {
-            const valueToReplace = templatedInput.getValue(context).value;
-            if (typeof valueToReplace !== "number" || valueToReplace < 0) {
-                throw new Error("Invalid value for templated input.");
-            }
-            finalPath = finalPath.replace(`{${templatedInput.name}}`, valueToReplace.toString());
+        for (const info of this.templateInfos) {
+            const raw = info.connection.getValue(context);
+            const placeholder = info.style === "curly" ? `{${info.name}}` : `[${info.name}]`;
+            const substitution = ResolveTemplateSubstitution(this.path, info.name, raw, context);
+            finalPath = finalPath.replace(placeholder, substitution);
         }
         return pathConverter.convert(finalPath);
     }
 }
+/**
+ * Decide what string to splice into a templated path for a given runtime value.
+ *
+ * - FlowGraphInteger / number → use the integer's decimal representation.
+ * - string → treat as a JSON Pointer to an object and pull the segment whose position
+ *   in the ref matches the position of `{name}` (or `[name]`) in the surrounding template.
+ *   Falls back to the last non-empty segment, then to the raw ref string.
+ * - object → ask the host environment for the reference addressing it, then substitute as above.
+ * @param template the original templated path (used to locate the placeholder position)
+ * @param name the name of the template parameter being resolved
+ * @param raw the runtime value supplied for the template parameter
+ * @param context the context used to reach the host resolver for object values
+ * @returns the substring to splice into the templated path in place of the placeholder
+ */
+function ResolveTemplateSubstitution(template, name, raw, context) {
+    if (raw instanceof FlowGraphInteger) {
+        AssertNonNegativeInt(raw.value, name);
+        return raw.value.toString();
+    }
+    if (typeof raw === "number") {
+        AssertNonNegativeInt(raw, name);
+        return raw.toString();
+    }
+    if (typeof raw === "string") {
+        if (raw === "") {
+            throw new Error(`Templated reference input "${name}" is null.`);
+        }
+        return ExtractRefSubstitution(template, name, raw);
+    }
+    // A runtime object (e.g. a Mesh delivered by a selection event). Mapping it back to a
+    // reference is knowledge the host environment owns, so it is delegated to the host resolver.
+    // The segment preceding the placeholder (e.g. "nodes" in `/nodes/{nodeRef}/globalMatrix`) is
+    // passed as a hint, because an object may be addressable in more than one way.
+    if (raw && typeof raw === "object") {
+        const pointer = context.getObjectReference(raw, GetPlaceholderParentSegment(template, name));
+        if (pointer) {
+            return ExtractRefSubstitution(template, name, pointer);
+        }
+    }
+    throw new Error(`Invalid value for templated input "${name}": got ${typeof raw}.`);
+}
+function GetPlaceholderIndex(template, name) {
+    const placeholders = [`{${name}}`, `[${name}]`];
+    return template.split("/").findIndex((segment) => placeholders.indexOf(segment) >= 0);
+}
+function GetPlaceholderParentSegment(template, name) {
+    const placeholderIndex = GetPlaceholderIndex(template, name);
+    return placeholderIndex > 0 ? template.split("/")[placeholderIndex - 1] : undefined;
+}
+function AssertNonNegativeInt(value, name) {
+    if (typeof value !== "number" || value < 0 || !Number.isFinite(value)) {
+        throw new Error(`Invalid value for templated input "${name}": ${value}.`);
+    }
+}
+function ExtractRefSubstitution(template, name, refValue) {
+    const templateSegments = template.split("/");
+    const placeholders = [`{${name}}`, `[${name}]`];
+    const placeholderIndex = templateSegments.findIndex((s) => placeholders.indexOf(s) >= 0);
+    const refSegments = refValue.split("/");
+    if (placeholderIndex >= 0 && placeholderIndex < refSegments.length && refSegments[placeholderIndex] !== "") {
+        return refSegments[placeholderIndex];
+    }
+    for (let i = refSegments.length - 1; i >= 0; i--) {
+        if (refSegments[i] !== "") {
+            return refSegments[i];
+        }
+    }
+    return refValue;
+}
 //# sourceMappingURL=flowGraphPathConverterComponent.js.map

package/FlowGraph/flowGraphPathConverterComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphPathConverterComponent.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphPathConverterComponent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,MAAM,qBAAqB,GAAG,IAAI,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,OAAO,+BAA+B;IAKxC,YACW,IAAY,EACZ,UAA0B;QAD1B,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAgB;QANrC;;WAEG;QACa,oBAAe,GAAgD,EAAE,CAAC;QAK9E,IAAI,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC;YAC7B,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC7D,CAAC;YACD,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC5B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,UAAU,EAAE,wBAAwB,EAAE,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvH,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,WAAW,CAAC,aAAsD,EAAE,OAAyB;QAChG,IAAI,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAChD,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;YAC9D,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAC1D,CAAC;YACD,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,IAAI,GAAG,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;CACJ","sourcesContent":["import { type IObjectInfo, type IPathToObjectConverter } from \"../ObjectModel/objectModelInterfaces\";\r\nimport { type FlowGraphBlock } from \"./flowGraphBlock\";\r\nimport { type FlowGraphContext } from \"./flowGraphContext\";\r\nimport { type FlowGraphDataConnection } from \"./flowGraphDataConnection\";\r\nimport { FlowGraphInteger } from \"./CustomTypes/flowGraphInteger.pure\";\r\nimport { RichTypeFlowGraphInteger } from \"./flowGraphRichTypes.pure\";\r\nimport { type IObjectAccessor } from \"./typeDefinitions\";\r\n\r\nconst PathHasTemplatesRegex = new RegExp(/\\/\\{(\\w+)\\}(?=\\/|$)/g);\r\n\r\n/**\r\n * @experimental\r\n * A component that converts a path to an object accessor.\r\n */\r\nexport class FlowGraphPathConverterComponent {\r\n    /**\r\n     * The templated inputs for the provided path.\r\n     */\r\n    public readonly templatedInputs: FlowGraphDataConnection<FlowGraphInteger>[] = [];\r\n    public constructor(\r\n        public path: string,\r\n        public ownerBlock: FlowGraphBlock\r\n    ) {\r\n        let match = PathHasTemplatesRegex.exec(path);\r\n        const templateSet = new Set<string>();\r\n        while (match) {\r\n            const [, matchGroup] = match;\r\n            if (templateSet.has(matchGroup)) {\r\n                throw new Error(\"Duplicate template variable detected.\");\r\n            }\r\n            templateSet.add(matchGroup);\r\n            this.templatedInputs.push(ownerBlock.registerDataInput(matchGroup, RichTypeFlowGraphInteger, new FlowGraphInteger(0)));\r\n            match = PathHasTemplatesRegex.exec(path);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get the accessor for the path.\r\n     * @param pathConverter the path converter to use to convert the path to an object accessor.\r\n     * @param context the context to use.\r\n     * @returns the accessor for the path.\r\n     * @throws if the value for a templated input is invalid.\r\n     */\r\n    public getAccessor(pathConverter: IPathToObjectConverter<IObjectAccessor>, context: FlowGraphContext): IObjectInfo<IObjectAccessor> {\r\n        let finalPath = this.path;\r\n        for (const templatedInput of this.templatedInputs) {\r\n            const valueToReplace = templatedInput.getValue(context).value;\r\n            if (typeof valueToReplace !== \"number\" || valueToReplace < 0) {\r\n                throw new Error(\"Invalid value for templated input.\");\r\n            }\r\n            finalPath = finalPath.replace(`{${templatedInput.name}}`, valueToReplace.toString());\r\n        }\r\n        return pathConverter.convert(finalPath);\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"flowGraphPathConverterComponent.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphPathConverterComponent.ts"],"names":[],"mappings":"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","sourcesContent":["import { type IObjectInfo, type IPathToObjectConverter } from \"../ObjectModel/objectModelInterfaces\";\r\nimport { type FlowGraphBlock } from \"./flowGraphBlock\";\r\nimport { type FlowGraphContext } from \"./flowGraphContext\";\r\nimport { type FlowGraphDataConnection } from \"./flowGraphDataConnection\";\r\nimport { FlowGraphInteger } from \"./CustomTypes/flowGraphInteger.pure\";\r\nimport { RichTypeAny } from \"./flowGraphRichTypes.pure\";\r\nimport { type IObjectAccessor } from \"./typeDefinitions\";\r\n\r\n// JSON Pointer templates may use either bracket style:\r\n//   {name}  → a reference template parameter.\r\n//   [name]  → an integer template parameter.\r\n// Real-world assets mix both conventions, so the bracket style by itself is not enough to determine\r\n// the input's type. We therefore accept both and decide how to substitute at resolution time based\r\n// on the runtime value supplied to the input socket (FlowGraphInteger / number → int substitution,\r\n// string → reference substitution by extracting the matching JSON-Pointer segment).\r\n// These are constructed per scan rather than shared, because a global regex carries `lastIndex`\r\n// state across calls and a scan that throws part-way would otherwise leave it set for the next one.\r\nconst CreateRefTemplateRegex = () => new RegExp(/\\/\\{(\\w+)\\}(?=\\/|$)/g);\r\nconst CreateIntTemplateRegex = () => new RegExp(/\\/\\[(\\w+)\\](?=\\/|$)/g);\r\n\r\ninterface IPathTemplateInfo {\r\n    /** Template variable name (without surrounding brackets). */\r\n    name: string;\r\n    /** Bracket style used in the source path; preserved so we replace the right placeholder. */\r\n    style: \"curly\" | \"square\";\r\n    /** The connection that supplies the runtime value for substitution. */\r\n    connection: FlowGraphDataConnection<any>;\r\n}\r\n\r\n/**\r\n * @experimental\r\n * A component that converts a path to an object accessor.\r\n */\r\nexport class FlowGraphPathConverterComponent {\r\n    /**\r\n     * The templated inputs for the provided path. Values may be FlowGraphInteger, number, or\r\n     * string (an opaque reference encoded as a JSON Pointer).\r\n     */\r\n    public readonly templatedInputs: FlowGraphDataConnection<any>[] = [];\r\n\r\n    /** Per-template metadata (name + bracket style + input connection). */\r\n    public readonly templateInfos: IPathTemplateInfo[] = [];\r\n\r\n    public constructor(\r\n        public path: string,\r\n        public ownerBlock: FlowGraphBlock\r\n    ) {\r\n        const templateSet = new Set<string>();\r\n\r\n        const collect = (regex: RegExp, style: \"curly\" | \"square\") => {\r\n            let match = regex.exec(path);\r\n            while (match) {\r\n                const [, name] = match;\r\n                if (templateSet.has(name)) {\r\n                    throw new Error(\"Duplicate template variable detected.\");\r\n                }\r\n                templateSet.add(name);\r\n                // Use RichTypeAny so the same socket can receive either an integer (legacy /\r\n                // [name] style) or a string ref (post-ref-update {name} style); the value's\r\n                // runtime type drives the substitution behaviour in getAccessor. Default to\r\n                // FlowGraphInteger(0) — not undefined — so an unconnected index input still\r\n                // resolves to index 0 (the natural default) instead of throwing at path resolution.\r\n                const conn = ownerBlock.registerDataInput(name, RichTypeAny, new FlowGraphInteger(0));\r\n                this.templatedInputs.push(conn);\r\n                this.templateInfos.push({ name, style, connection: conn });\r\n                match = regex.exec(path);\r\n            }\r\n        };\r\n\r\n        collect(CreateRefTemplateRegex(), \"curly\");\r\n        collect(CreateIntTemplateRegex(), \"square\");\r\n    }\r\n\r\n    /**\r\n     * Get the accessor for the path.\r\n     * @param pathConverter the path converter to use to convert the path to an object accessor.\r\n     * @param context the context to use.\r\n     * @returns the accessor for the path.\r\n     * @throws if the value for a templated input is invalid.\r\n     */\r\n    public getAccessor(pathConverter: IPathToObjectConverter<IObjectAccessor>, context: FlowGraphContext): IObjectInfo<IObjectAccessor> {\r\n        let finalPath = this.path;\r\n        for (const info of this.templateInfos) {\r\n            const raw = info.connection.getValue(context);\r\n            const placeholder = info.style === \"curly\" ? `{${info.name}}` : `[${info.name}]`;\r\n            const substitution = ResolveTemplateSubstitution(this.path, info.name, raw, context);\r\n            finalPath = finalPath.replace(placeholder, substitution);\r\n        }\r\n        return pathConverter.convert(finalPath);\r\n    }\r\n}\r\n\r\n/**\r\n * Decide what string to splice into a templated path for a given runtime value.\r\n *\r\n * - FlowGraphInteger / number → use the integer's decimal representation.\r\n * - string → treat as a JSON Pointer to an object and pull the segment whose position\r\n *   in the ref matches the position of `{name}` (or `[name]`) in the surrounding template.\r\n *   Falls back to the last non-empty segment, then to the raw ref string.\r\n * - object → ask the host environment for the reference addressing it, then substitute as above.\r\n * @param template the original templated path (used to locate the placeholder position)\r\n * @param name the name of the template parameter being resolved\r\n * @param raw the runtime value supplied for the template parameter\r\n * @param context the context used to reach the host resolver for object values\r\n * @returns the substring to splice into the templated path in place of the placeholder\r\n */\r\nfunction ResolveTemplateSubstitution(template: string, name: string, raw: any, context: FlowGraphContext): string {\r\n    if (raw instanceof FlowGraphInteger) {\r\n        AssertNonNegativeInt(raw.value, name);\r\n        return raw.value.toString();\r\n    }\r\n    if (typeof raw === \"number\") {\r\n        AssertNonNegativeInt(raw, name);\r\n        return raw.toString();\r\n    }\r\n    if (typeof raw === \"string\") {\r\n        if (raw === \"\") {\r\n            throw new Error(`Templated reference input \"${name}\" is null.`);\r\n        }\r\n        return ExtractRefSubstitution(template, name, raw);\r\n    }\r\n    // A runtime object (e.g. a Mesh delivered by a selection event). Mapping it back to a\r\n    // reference is knowledge the host environment owns, so it is delegated to the host resolver.\r\n    // The segment preceding the placeholder (e.g. \"nodes\" in `/nodes/{nodeRef}/globalMatrix`) is\r\n    // passed as a hint, because an object may be addressable in more than one way.\r\n    if (raw && typeof raw === \"object\") {\r\n        const pointer = context.getObjectReference(raw as object, GetPlaceholderParentSegment(template, name));\r\n        if (pointer) {\r\n            return ExtractRefSubstitution(template, name, pointer);\r\n        }\r\n    }\r\n    throw new Error(`Invalid value for templated input \"${name}\": got ${typeof raw}.`);\r\n}\r\n\r\nfunction GetPlaceholderIndex(template: string, name: string): number {\r\n    const placeholders = [`{${name}}`, `[${name}]`];\r\n    return template.split(\"/\").findIndex((segment) => placeholders.indexOf(segment) >= 0);\r\n}\r\n\r\nfunction GetPlaceholderParentSegment(template: string, name: string): string | undefined {\r\n    const placeholderIndex = GetPlaceholderIndex(template, name);\r\n    return placeholderIndex > 0 ? template.split(\"/\")[placeholderIndex - 1] : undefined;\r\n}\r\n\r\nfunction AssertNonNegativeInt(value: number, name: string): void {\r\n    if (typeof value !== \"number\" || value < 0 || !Number.isFinite(value)) {\r\n        throw new Error(`Invalid value for templated input \"${name}\": ${value}.`);\r\n    }\r\n}\r\n\r\nfunction ExtractRefSubstitution(template: string, name: string, refValue: string): string {\r\n    const templateSegments = template.split(\"/\");\r\n    const placeholders = [`{${name}}`, `[${name}]`];\r\n    const placeholderIndex = templateSegments.findIndex((s) => placeholders.indexOf(s) >= 0);\r\n    const refSegments = refValue.split(\"/\");\r\n    if (placeholderIndex >= 0 && placeholderIndex < refSegments.length && refSegments[placeholderIndex] !== \"\") {\r\n        return refSegments[placeholderIndex];\r\n    }\r\n    for (let i = refSegments.length - 1; i >= 0; i--) {\r\n        if (refSegments[i] !== \"\") {\r\n            return refSegments[i];\r\n        }\r\n    }\r\n    return refValue;\r\n}\r\n"]}

package/FlowGraph/flowGraphSignalConnection.pure.js

@@ -47,11 +47,17 @@ export class FlowGraphSignalConnection extends FlowGraphConnection {
             if (context._shouldBreak(this._ownerBlock, this)) {
                 return; // Execution paused — stored as pending activation
             }
+            // Start a new execution frame BEFORE executing the node: an output value socket (a random
+            // value, for instance) retains its value until a node with one or more flow sockets is
+            // executed, after which it is recomputed on the next access. Because flow execution is
+            // synchronous and nested, the id must be increased before the block runs so each flow
+            // socket activation (including loop self-activations) observes a fresh frame, while
+            // staying constant within a single block execution so per-frame value caching still works.
+            context._increaseExecutionId();
             context._notifyExecuteNode(this._ownerBlock);
             const startTime = performance.now();
             this._ownerBlock._execute(context, this);
             this._ownerBlock._lastExecutionTime = performance.now() - startTime;
-            context._increaseExecutionId();
         }
         else {
             for (const connectedPoint of this._connectedPoint) {

package/FlowGraph/flowGraphSignalConnection.pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphSignalConnection.pure.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphSignalConnection.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAG7D,OAAO,EAAE,mBAAmB,EAA2B,MAAM,uBAAuB,CAAC;AAGrF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,mBAAuE;IAAtH;;QAMI;;;WAGG;QACI,aAAQ,GAAW,CAAC,CAAC;QAY5B;;;WAGG;QACI,wBAAmB,GAAW,CAAC,CAAC,CAAC;IAgC5C,CAAC;IA9CmB,qBAAqB;QACjC,OAAO,KAAK,CAAC;IACjB,CAAC;IAEe,SAAS,CAAC,KAAgC;QACtD,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvB,uDAAuD;QACvD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;IAQD;;OAEG;IACI,eAAe,CAAC,OAAyB;QAC5C,IAAI,CAAC,mBAAmB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC7C,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC;YACvB,MAAM,uDAAgC;YACtC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;YAC1C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ;YACnC,OAAO,EAAE;gBACL,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;aAClB;SACJ,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,0CAAkC,EAAE,CAAC;YACxD,oCAAoC;YACpC,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC/C,OAAO,CAAC,kDAAkD;YAC9D,CAAC;YACD,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,WAAW,CAAC,kBAAkB,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACpE,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACnC,CAAC;aAAM,CAAC;YACJ,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAChD,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC;IACL,CAAC;CACJ;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB;;;GAGG;AACH,MAAM,UAAU,iCAAiC;IAC7C,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IAEnB,aAAa,CAAC,2BAA2B,EAAE,yBAAyB,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { type FlowGraphExecutionBlock } from \"./flowGraphExecutionBlock\";\r\nimport { FlowGraphConnection, FlowGraphConnectionType } from \"./flowGraphConnection\";\r\nimport { type FlowGraphContext } from \"./flowGraphContext\";\r\nimport { FlowGraphAction } from \"./flowGraphLogger\";\r\nimport { RegisterClass } from \"../Misc/typeStore\";\r\n\r\n/**\r\n * Represents a connection point for a signal.\r\n * When an output point is activated, it will activate the connected input point.\r\n * When an input point is activated, it will execute the block it belongs to.\r\n */\r\nexport class FlowGraphSignalConnection extends FlowGraphConnection<FlowGraphExecutionBlock, FlowGraphSignalConnection> {\r\n    /**\r\n     * Optional payload. Can be used, for example, when an error is thrown to pass additional information.\r\n     */\r\n    public payload: any;\r\n\r\n    /**\r\n     * The priority of the signal. Signals with higher priority will be executed first.\r\n     * Set priority before adding the connection as sorting happens only when the connection is added.\r\n     */\r\n    public priority: number = 0;\r\n\r\n    public override _isSingularConnection(): boolean {\r\n        return false;\r\n    }\r\n\r\n    public override connectTo(point: FlowGraphSignalConnection): void {\r\n        super.connectTo(point);\r\n        // sort according to priority to handle execution order\r\n        this._connectedPoint.sort((a, b) => b.priority - a.priority);\r\n    }\r\n\r\n    /**\r\n     * Timestamp of the last activation (set on output signals when they fire).\r\n     * @internal\r\n     */\r\n    public _lastActivationTime: number = -1;\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public _activateSignal(context: FlowGraphContext): void {\r\n        this._lastActivationTime = performance.now();\r\n        context.logger?.addLogItem({\r\n            action: FlowGraphAction.ActivateSignal,\r\n            className: this._ownerBlock.getClassName(),\r\n            uniqueId: this._ownerBlock.uniqueId,\r\n            payload: {\r\n                connectionType: this.connectionType,\r\n                name: this.name,\r\n            },\r\n        });\r\n        if (this.connectionType === FlowGraphConnectionType.Input) {\r\n            // Check breakpoint before executing\r\n            if (context._shouldBreak(this._ownerBlock, this)) {\r\n                return; // Execution paused — stored as pending activation\r\n            }\r\n            context._notifyExecuteNode(this._ownerBlock);\r\n            const startTime = performance.now();\r\n            this._ownerBlock._execute(context, this);\r\n            this._ownerBlock._lastExecutionTime = performance.now() - startTime;\r\n            context._increaseExecutionId();\r\n        } else {\r\n            for (const connectedPoint of this._connectedPoint) {\r\n                connectedPoint._activateSignal(context);\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphSignalConnection.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphSignalConnection(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(\"FlowGraphSignalConnection\", FlowGraphSignalConnection);\r\n}\r\n"]}
+{"version":3,"file":"flowGraphSignalConnection.pure.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphSignalConnection.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAG7D,OAAO,EAAE,mBAAmB,EAA2B,MAAM,uBAAuB,CAAC;AAGrF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,mBAAuE;IAAtH;;QAMI;;;WAGG;QACI,aAAQ,GAAW,CAAC,CAAC;QAY5B;;;WAGG;QACI,wBAAmB,GAAW,CAAC,CAAC,CAAC;IAsC5C,CAAC;IApDmB,qBAAqB;QACjC,OAAO,KAAK,CAAC;IACjB,CAAC;IAEe,SAAS,CAAC,KAAgC;QACtD,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvB,uDAAuD;QACvD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;IAQD;;OAEG;IACI,eAAe,CAAC,OAAyB;QAC5C,IAAI,CAAC,mBAAmB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC7C,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC;YACvB,MAAM,uDAAgC;YACtC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;YAC1C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ;YACnC,OAAO,EAAE;gBACL,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;aAClB;SACJ,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,0CAAkC,EAAE,CAAC;YACxD,oCAAoC;YACpC,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC/C,OAAO,CAAC,kDAAkD;YAC9D,CAAC;YACD,0FAA0F;YAC1F,uFAAuF;YACvF,uFAAuF;YACvF,sFAAsF;YACtF,oFAAoF;YACpF,2FAA2F;YAC3F,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAC/B,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,WAAW,CAAC,kBAAkB,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxE,CAAC;aAAM,CAAC;YACJ,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAChD,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC;IACL,CAAC;CACJ;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB;;;GAGG;AACH,MAAM,UAAU,iCAAiC;IAC7C,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IAEnB,aAAa,CAAC,2BAA2B,EAAE,yBAAyB,CAAC,CAAC;AAC1E,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { type FlowGraphExecutionBlock } from \"./flowGraphExecutionBlock\";\r\nimport { FlowGraphConnection, FlowGraphConnectionType } from \"./flowGraphConnection\";\r\nimport { type FlowGraphContext } from \"./flowGraphContext\";\r\nimport { FlowGraphAction } from \"./flowGraphLogger\";\r\nimport { RegisterClass } from \"../Misc/typeStore\";\r\n\r\n/**\r\n * Represents a connection point for a signal.\r\n * When an output point is activated, it will activate the connected input point.\r\n * When an input point is activated, it will execute the block it belongs to.\r\n */\r\nexport class FlowGraphSignalConnection extends FlowGraphConnection<FlowGraphExecutionBlock, FlowGraphSignalConnection> {\r\n    /**\r\n     * Optional payload. Can be used, for example, when an error is thrown to pass additional information.\r\n     */\r\n    public payload: any;\r\n\r\n    /**\r\n     * The priority of the signal. Signals with higher priority will be executed first.\r\n     * Set priority before adding the connection as sorting happens only when the connection is added.\r\n     */\r\n    public priority: number = 0;\r\n\r\n    public override _isSingularConnection(): boolean {\r\n        return false;\r\n    }\r\n\r\n    public override connectTo(point: FlowGraphSignalConnection): void {\r\n        super.connectTo(point);\r\n        // sort according to priority to handle execution order\r\n        this._connectedPoint.sort((a, b) => b.priority - a.priority);\r\n    }\r\n\r\n    /**\r\n     * Timestamp of the last activation (set on output signals when they fire).\r\n     * @internal\r\n     */\r\n    public _lastActivationTime: number = -1;\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public _activateSignal(context: FlowGraphContext): void {\r\n        this._lastActivationTime = performance.now();\r\n        context.logger?.addLogItem({\r\n            action: FlowGraphAction.ActivateSignal,\r\n            className: this._ownerBlock.getClassName(),\r\n            uniqueId: this._ownerBlock.uniqueId,\r\n            payload: {\r\n                connectionType: this.connectionType,\r\n                name: this.name,\r\n            },\r\n        });\r\n        if (this.connectionType === FlowGraphConnectionType.Input) {\r\n            // Check breakpoint before executing\r\n            if (context._shouldBreak(this._ownerBlock, this)) {\r\n                return; // Execution paused — stored as pending activation\r\n            }\r\n            // Start a new execution frame BEFORE executing the node: an output value socket (a random\r\n            // value, for instance) retains its value until a node with one or more flow sockets is\r\n            // executed, after which it is recomputed on the next access. Because flow execution is\r\n            // synchronous and nested, the id must be increased before the block runs so each flow\r\n            // socket activation (including loop self-activations) observes a fresh frame, while\r\n            // staying constant within a single block execution so per-frame value caching still works.\r\n            context._increaseExecutionId();\r\n            context._notifyExecuteNode(this._ownerBlock);\r\n            const startTime = performance.now();\r\n            this._ownerBlock._execute(context, this);\r\n            this._ownerBlock._lastExecutionTime = performance.now() - startTime;\r\n        } else {\r\n            for (const connectedPoint of this._connectedPoint) {\r\n                connectedPoint._activateSignal(context);\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphSignalConnection.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphSignalConnection(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(\"FlowGraphSignalConnection\", FlowGraphSignalConnection);\r\n}\r\n"]}

package/FlowGraph/index.d.ts

@@ -13,6 +13,8 @@ export * from "./flowGraphAssetsContext.js";
 export * from "./flowGraphParser.js";
 export * from "./flowGraphPathConverter.js";
 export * from "./flowGraphPathConverterComponent.js";
+export * from "./flowGraphHostResolver.js";
+export * from "./flowGraphDelayRegistry.js";
 export * from "./flowGraphLogger.js";
 export * from "./flowGraphValidator.js";
 export * from "./Blocks/index.js";