@bian-womp/spark-graph 0.1.2 → 0.1.4

package/lib/cjs/src/builder/Registry.d.ts

@@ -17,7 +17,11 @@ export declare class Registry {
     private coercions;
     private asyncCoercions;
     private enums;
-    registerType(desc: DataTypeDescriptor): this;
+    registerType(desc: DataTypeDescriptor, opts?: {
+        withArray?: boolean;
+        arrayId?: string;
+        arrayPickFirstDefined?: boolean;
+    }): this;
     registerNode<I extends Record<string, string>, O extends Record<string, string>, State = unknown, Impl = (inputs: Record<string, unknown>, ctx: NodeContext<State>) => void | Record<string, unknown> | Promise<void | Record<string, unknown>>>(desc: NodeTypeDescriptor<I, O, State, Impl>): this;
     registerSerializer(typeId: string, s: {
         serialize: (value: unknown) => unknown;
@@ -28,6 +32,11 @@ export declare class Registry {
     canCoerce(fromTypeId: string | undefined, toTypeId: string | undefined): boolean;
     getCoercion(fromTypeId: string, toTypeId: string): ((value: unknown) => unknown) | undefined;
     getAsyncCoercion(fromTypeId: string, toTypeId: string): ((value: unknown, signal: AbortSignal) => Promise<unknown>) | undefined;
+    listCoercions(): Array<{
+        from: string;
+        to: string;
+        async: boolean;
+    }>;
     registerEnum(enumTypeId: string, options: Array<{
         value: number;
         label: string;

package/lib/cjs/src/builder/Registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Registry.d.ts","sourceRoot":"","sources":["../../../../src/builder/Registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Registry.d.ts","sourceRoot":"","sources":["../../../../src/builder/Registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAuD;IACzE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI;IAIrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS;IAG7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGzB;AAED,qBAAa,QAAQ;IACnB,QAAQ,CAAC,KAAK,uCAA8C;IAC5D,QAAQ,CAAC,KAAK,qOAAyC;IACvD,QAAQ,CAAC,UAAU,mBAA0B;IAC7C,QAAQ,CAAC,WAAW;mBAGL,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO;qBACzB,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO;OAEvC;IAEJ,OAAO,CAAC,SAAS,CAAkD;IACnE,OAAO,CAAC,cAAc,CAGlB;IACJ,OAAO,CAAC,KAAK,CAOT;IAEJ,YAAY,CACV,IAAI,EAAE,kBAAkB,EACxB,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,qBAAqB,CAAC,EAAE,OAAO,CAAC;KACjC,GACA,IAAI;IAyCP,YAAY,CACV,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,KAAK,GAAG,OAAO,EACf,IAAI,GAAG,CACL,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,KAErB,IAAI,GACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,IAAI,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI;IAKpD,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,CAAC,EAAE;QACD,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;QACvC,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;KACzC,GACA,IAAI;IAiBP,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GACnC,IAAI;IAMP,qBAAqB,CACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,GACtE,IAAI;IAKP,SAAS,CACP,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,OAAO;IAOV,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS;IAK5C,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS;IAM1E,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAcpE,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAChD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI;IAmDP,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAG3E,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAGnE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGpE"}

package/lib/cjs/src/examples/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/examples/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,eAAe,CAAC;AAGvB,wBAAgB,uBAAuB,IAAI,QAAQ,CA4ZlD;AAED,wBAAgB,wBAAwB,IAAI,eAAe,CAc1D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,QA2BnD;AAqBD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,QAyBvD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,6BAUrE"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/examples/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,eAAe,CAAC;AAGvB,wBAAgB,uBAAuB,IAAI,QAAQ,CAwYlD;AAED,wBAAgB,wBAAwB,IAAI,eAAe,CAc1D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,QA2BnD;AAqBD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,QA6BvD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,6BAUrE"}

package/lib/esm/index.js

@@ -23,8 +23,44 @@ class Registry {
         this.asyncCoercions = new Map();
         this.enums = new Map();
     }
-    registerType(desc) {
+    registerType(desc, opts) {
         this.types.set(desc.id, desc);
+        if (!this.serializers.has(desc.id)) {
+            this.registerSerializer(desc.id, {
+                serialize: (v) => v,
+                deserialize: (d) => d,
+            });
+        }
+        if (opts?.withArray) {
+            const arrayId = opts.arrayId ?? `${desc.id}[]`;
+            if (!this.types.has(arrayId)) {
+                const arrayDesc = {
+                    id: arrayId,
+                    validate: (v) => Array.isArray(v) &&
+                        v.every((x) => {
+                            try {
+                                return desc.validate(x);
+                            }
+                            catch {
+                                return false;
+                            }
+                        }),
+                };
+                this.types.set(arrayId, arrayDesc);
+            }
+            this.registerCoercion(desc.id, arrayId, (value) => Array.isArray(value) ? value : [value]);
+            this.registerCoercion(arrayId, desc.id, (value) => {
+                if (!Array.isArray(value))
+                    return value;
+                if (opts.arrayPickFirstDefined) {
+                    for (const x of value)
+                        if (x !== undefined)
+                            return x;
+                    return undefined;
+                }
+                return value[0];
+            });
+        }
         return this;
     }
     registerNode(desc) {
@@ -33,6 +69,15 @@ class Registry {
     }
     registerSerializer(typeId, s) {
         this.serializers.set(typeId, s);
+        // If an array variant of this type exists and doesn't have a serializer,
+        // auto-register an array serializer that maps each element using the base serializer.
+        const arrayId = `${typeId}[]`;
+        if (this.types.has(arrayId) && !this.serializers.has(arrayId)) {
+            this.serializers.set(arrayId, {
+                serialize: (value) => Array.isArray(value) ? value.map((el) => s.serialize(el)) : value,
+                deserialize: (data) => Array.isArray(data) ? data.map((el) => s.deserialize(el)) : data,
+            });
+        }
         return this;
     }
     // Register a type coercion from one type id to another
@@ -63,6 +108,19 @@ class Registry {
             return undefined;
         return this.asyncCoercions.get(`${fromTypeId}->${toTypeId}`);
     }
+    // Introspection for dynamic discovery
+    listCoercions() {
+        const out = [];
+        for (const key of this.coercions.keys()) {
+            const [from, to] = key.split("->");
+            out.push({ from, to, async: false });
+        }
+        for (const key of this.asyncCoercions.keys()) {
+            const [from, to] = key.split("->");
+            out.push({ from, to, async: true });
+        }
+        return out;
+    }
     // Enum support
     registerEnum(enumTypeId, options, labelType, valueType) {
         const valueToLabel = new Map();
@@ -1280,53 +1338,30 @@ function setupBasicGraphRegistry() {
     const registry = new Registry();
     registry.categories.register(ComputeCategory);
     const floatType = {
-        id: "float",
+        id: "base.float",
         validate: (v) => typeof v === "number" && !Number.isNaN(v),
     };
     registry.registerType(floatType);
-    registry.registerSerializer("float", {
+    registry.registerSerializer("base.float", {
         serialize: (v) => v,
         deserialize: (d) => Number(d),
     });
     const boolType = {
-        id: "bool",
+        id: "base.bool",
         validate: (v) => typeof v === "boolean",
     };
     const stringType = {
-        id: "string",
+        id: "base.string",
         validate: (v) => typeof v === "string",
     };
     const vec3Type = {
-        id: "vec3",
+        id: "base.vec3",
         validate: (v) => Array.isArray(v) &&
             v.length === 3 &&
             v.every((x) => typeof x === "number"),
     };
-    const floatArrayType = {
-        id: "float[]",
-        validate: (v) => Array.isArray(v) && v.every((x) => typeof x === "number"),
-    };
-    const boolArrayType = {
-        id: "bool[]",
-        validate: (v) => Array.isArray(v) && v.every((x) => typeof x === "boolean"),
-    };
-    const vec3ArrayType = {
-        id: "vec3[]",
-        validate: (v) => Array.isArray(v) &&
-            v.every((x) => Array.isArray(x) &&
-                x.length === 3 &&
-                x.every((n) => typeof n === "number")),
-    };
-    [
-        boolType,
-        stringType,
-        vec3Type,
-        floatType,
-        floatArrayType,
-        boolArrayType,
-        vec3ArrayType,
-    ].forEach((t) => {
-        registry.registerType(t);
+    [boolType, stringType, vec3Type, floatType].forEach((t) => {
+        registry.registerType(t, { withArray: true, arrayPickFirstDefined: true });
         registry.registerSerializer(t.id, {
             serialize: (v) => v,
             deserialize: (d) => d,
@@ -1334,23 +1369,13 @@ function setupBasicGraphRegistry() {
     });
     // Helpers
     const asArray = (v) => Array.isArray(v) ? v : [Number(v)];
-    // Register core coercions: float <-> float[]
-    registry.registerCoercion("float", "float[]", (v) => Array.isArray(v) ? v : [Number(v)]);
-    registry.registerCoercion("float[]", "float", (v) => Array.isArray(v) ? Number(v[0] ?? 0) : Number(v));
     // float[] -> vec3[] : map x to [x,0,0]
-    registry.registerCoercion("float[]", "vec3[]", (v) => {
+    registry.registerCoercion("base.float[]", "base.vec3[]", (v) => {
         const arr = asArray(v);
         return arr.map((x) => [Number(x) || 0, 0, 0]);
     });
-    // Example async coercion: simulate expensive conversion float[] -> vec3[] by computing magnitudes
-    registry.registerCoercion("float[]", "vec3[]", (v) => {
-        // synchronous fallback; async version can be provided on edge via convertAsync
-        if (!Array.isArray(v))
-            return [];
-        return v.map((t) => Math.hypot(Number(t?.[0] ?? 0), Number(t?.[1] ?? 0), Number(t?.[2] ?? 0)));
-    });
     // Async coercion variant for vec3[] -> float[] (chunked + abortable)
-    registry.registerAsyncCoercion("vec3[]", "float[]", async (value, signal) => {
+    registry.registerAsyncCoercion("base.vec3[]", "base.float[]", async (value, signal) => {
         const arr = Array.isArray(value)
             ? value
             : [];
@@ -1384,32 +1409,32 @@ function setupBasicGraphRegistry() {
     };
     // Number
     registry.registerNode({
-        id: "number",
+        id: "base.number",
         categoryId: "compute",
-        inputs: { Value: "float" },
-        outputs: { Result: "float" },
+        inputs: { Value: "base.float" },
+        outputs: { Result: "base.float" },
         impl: (ins) => ({ Result: Number(ins.Value) }),
     });
     // Integer
     registry.registerNode({
-        id: "integer",
+        id: "base.int",
         categoryId: "compute",
-        inputs: { Value: "float" },
-        outputs: { Result: "float" },
+        inputs: { Value: "base.float" },
+        outputs: { Result: "base.float" },
         impl: (ins) => ({
             Result: Math.trunc(Number(ins.Value)),
         }),
     });
     // Number to String
     registry.registerNode({
-        id: "numberToString",
+        id: "base.numberToString",
         categoryId: "compute",
-        inputs: { Value: "float" },
-        outputs: { Text: "string" },
+        inputs: { Value: "base.float" },
+        outputs: { Text: "base.string" },
         impl: (ins) => ({ Text: String(ins.Value) }),
     });
     // Enums: Math Operation
-    registry.registerEnum("enum:math.operation", [
+    registry.registerEnum("base.enum:math.operation", [
         { value: 0, label: "Add" },
         { value: 1, label: "Subtract" },
         { value: 2, label: "Multiply" },
@@ -1418,22 +1443,22 @@ function setupBasicGraphRegistry() {
         { value: 5, label: "Max" },
         { value: 6, label: "Modulo" },
         { value: 7, label: "Power" },
-    ], "string", "float");
+    ], "base.string", "base.float");
     // Enums: Compare Operation
-    registry.registerEnum("enum:compare.operation", [
+    registry.registerEnum("base.enum:compare.operation", [
         { value: 0, label: "LessThan" },
         { value: 1, label: "LessThanOrEqual" },
         { value: 2, label: "GreaterThan" },
         { value: 3, label: "GreaterThanOrEqual" },
         { value: 4, label: "Equal" },
         { value: 5, label: "NotEqual" },
-    ], "string", "float");
+    ], "base.string", "base.float");
     // Clamp
     registry.registerNode({
-        id: "clamp",
+        id: "base.clamp",
         categoryId: "compute",
-        inputs: { Value: "float[]", Min: "float", Max: "float" },
-        outputs: { Value: "float[]" },
+        inputs: { Value: "base.float[]", Min: "base.float", Max: "base.float" },
+        outputs: { Value: "base.float[]" },
         impl: (ins) => {
             const vals = asArray(ins.Value);
             const min = Number(ins.Min ?? 0);
@@ -1443,10 +1468,14 @@ function setupBasicGraphRegistry() {
     });
     // Interpolate (lerp)
     registry.registerNode({
-        id: "interpolate",
+        id: "base.interpolate",
         categoryId: "compute",
-        inputs: { ValueA: "float[]", ValueB: "float[]", Factor: "float" },
-        outputs: { Value: "float[]" },
+        inputs: {
+            ValueA: "base.float[]",
+            ValueB: "base.float[]",
+            Factor: "base.float",
+        },
+        outputs: { Value: "base.float[]" },
         impl: (ins) => {
             const [a, b] = broadcast(ins.ValueA, ins.ValueB);
             const t = Number(ins.Factor ?? 0);
@@ -1459,18 +1488,18 @@ function setupBasicGraphRegistry() {
     });
     // Map Range (linear)
     registry.registerNode({
-        id: "mapRange",
+        id: "base.mapRange",
         categoryId: "compute",
         inputs: {
-            Mode: "string",
-            Clamp: "bool",
-            Value: "float[]",
-            FromMin: "float",
-            FromMax: "float",
-            ToMin: "float",
-            ToMax: "float",
+            Mode: "base.string",
+            Clamp: "base.bool",
+            Value: "base.float[]",
+            FromMin: "base.float",
+            FromMax: "base.float",
+            ToMin: "base.float",
+            ToMax: "base.float",
         },
-        outputs: { Value: "float[]" },
+        outputs: { Value: "base.float[]" },
         impl: (ins) => {
             const vals = asArray(ins.Value);
             const fromMin = Number(ins.FromMin ?? 0);
@@ -1490,10 +1519,14 @@ function setupBasicGraphRegistry() {
     });
     // Math (subset) - scalar version for simple examples
     registry.registerNode({
-        id: "math",
+        id: "base.math",
         categoryId: "compute",
-        inputs: { Operation: "enum:math.operation", A: "float[]", B: "float[]" },
-        outputs: { Result: "float[]" },
+        inputs: {
+            Operation: "base.enum:math.operation",
+            A: "base.float[]",
+            B: "base.float[]",
+        },
+        outputs: { Result: "base.float[]" },
         impl: (ins) => {
             // Gracefully handle missing inputs by treating them as zeros
             const a = ins.A === undefined ? [] : asArray(ins.A);
@@ -1521,10 +1554,14 @@ function setupBasicGraphRegistry() {
     });
     // Compare
     registry.registerNode({
-        id: "compare",
+        id: "base.compare",
         categoryId: "compute",
-        inputs: { Operation: "enum:compare.operation", A: "float[]", B: "float[]" },
-        outputs: { Result: "bool[]" },
+        inputs: {
+            Operation: "base.enum:compare.operation",
+            A: "base.float[]",
+            B: "base.float[]",
+        },
+        outputs: { Result: "base.bool[]" },
         impl: (ins) => {
             const [a, b] = broadcast(ins.A, ins.B);
             const op = Number(ins.Operation ?? 4) | 0; // default Equal
@@ -1542,10 +1579,10 @@ function setupBasicGraphRegistry() {
     });
     // Combine XYZ
     registry.registerNode({
-        id: "combineXYZ",
+        id: "base.compareXYZ",
         categoryId: "compute",
-        inputs: { X: "float[]", Y: "float[]", Z: "float[]" },
-        outputs: { XYZ: "vec3[]" },
+        inputs: { X: "base.float[]", Y: "base.float[]", Z: "base.float[]" },
+        outputs: { XYZ: "base.vec3[]" },
         impl: (ins) => {
             const [x, y] = broadcast(ins.X, ins.Y);
             const [xx, z] = broadcast(x, ins.Z);
@@ -1558,10 +1595,10 @@ function setupBasicGraphRegistry() {
     });
     // Separate XYZ
     registry.registerNode({
-        id: "separateXYZ",
+        id: "base.separateXYZ",
         categoryId: "compute",
-        inputs: { XYZ: "vec3[]" },
-        outputs: { X: "float[]", Y: "float[]", Z: "float[]" },
+        inputs: { XYZ: "base.vec3[]" },
+        outputs: { X: "base.float[]", Y: "base.float[]", Z: "base.float[]" },
         impl: (ins) => {
             const arr = ins.XYZ ?? [];
             const X = arr.map((v) => Number(v?.[0] ?? 0));
@@ -1572,10 +1609,10 @@ function setupBasicGraphRegistry() {
     });
     // Indices
     registry.registerNode({
-        id: "indices",
+        id: "base.indices",
         categoryId: "compute",
-        inputs: { Domain: "float" },
-        outputs: { Indices: "float[]" },
+        inputs: { Domain: "base.float" },
+        outputs: { Indices: "base.float[]" },
         impl: (ins) => {
             const n = Math.trunc(ins.Domain);
             return { Indices: Array.from({ length: n }, (_, i) => i) };
@@ -1583,10 +1620,15 @@ function setupBasicGraphRegistry() {
     });
     // Random Numbers
     registry.registerNode({
-        id: "randomNumbers",
+        id: "base.randomNumbers",
         categoryId: "compute",
-        inputs: { Domain: "float", Min: "float", Max: "float", Seed: "float" },
-        outputs: { Values: "float[]" },
+        inputs: {
+            Domain: "base.float",
+            Min: "base.float",
+            Max: "base.float",
+            Seed: "base.float",
+        },
+        outputs: { Values: "base.float[]" },
         impl: (ins) => {
             const len = Math.trunc(ins.Domain);
             const min = Number(ins.Min ?? 0);
@@ -1598,10 +1640,15 @@ function setupBasicGraphRegistry() {
     });
     // Random Vectors
     registry.registerNode({
-        id: "randomVectors",
+        id: "base.randomXYZs",
         categoryId: "compute",
-        inputs: { Domain: "float", Min: "vec3", Max: "vec3", Seed: "float" },
-        outputs: { Values: "vec3[]" },
+        inputs: {
+            Domain: "base.float",
+            Min: "base.vec3",
+            Max: "base.vec3",
+            Seed: "base.float",
+        },
+        outputs: { Values: "base.vec3[]" },
         impl: (ins) => {
             const len = Math.trunc(ins.Domain);
             const min = ins.Min ?? [0, 0, 0];
@@ -1620,8 +1667,8 @@ function setupBasicGraphRegistry() {
 function makeBasicGraphDefinition() {
     return {
         nodes: [
-            { nodeId: "n1", typeId: "math" },
-            { nodeId: "n2", typeId: "math" },
+            { nodeId: "n1", typeId: "base.math" },
+            { nodeId: "n2", typeId: "base.math" },
         ],
         edges: [
             {
@@ -1634,10 +1681,10 @@ function makeBasicGraphDefinition() {
 }
 function registerDelayNode(registry) {
     registry.registerNode({
-        id: "delay",
+        id: "async.delay",
         categoryId: "compute",
-        inputs: { x: "float", ms: "float" },
-        outputs: { out: "float" },
+        inputs: { x: "base.float", ms: "base.float" },
+        outputs: { out: "base.float" },
         impl: async (ins, ctx) => {
             const ms = Number(ins.ms ?? 200);
             const xRaw = ins.x;
@@ -1679,10 +1726,14 @@ function sleepWithAbort(ms, signal) {
 }
 function registerProgressNodes(registry) {
     registry.registerNode({
-        id: "progressWorker",
+        id: "async.progress",
         categoryId: "compute",
-        inputs: { Steps: "float", DelayMs: "float", ShouldError: "bool" },
-        outputs: { Done: "string" },
+        inputs: {
+            Steps: "base.float",
+            DelayMs: "base.float",
+            ShouldError: "base.bool",
+        },
+        outputs: { Done: "base.string" },
         impl: async (ins, ctx) => {
             const steps = Math.max(1, Math.trunc(Number(ins.Steps ?? 10)));
             const delayMs = Math.max(0, Math.trunc(Number(ins.DelayMs ?? 50)));
@@ -1713,20 +1764,20 @@ function createAsyncGraphDef() {
         nodes: [
             {
                 nodeId: "n1",
-                typeId: "math",
+                typeId: "base.math",
             },
             {
                 nodeId: "n2",
-                typeId: "delay",
+                typeId: "async.delay",
                 params: { policy: { asyncConcurrency: "queue", maxQueue: 4 } },
             },
             {
                 nodeId: "n3",
-                typeId: "separateXYZ",
+                typeId: "base.separateXYZ",
             },
             {
                 nodeId: "n4",
-                typeId: "combineXYZ",
+                typeId: "base.compareXYZ",
             },
         ],
         edges: [
@@ -1740,7 +1791,7 @@ function createAsyncGraphDef() {
                 id: "e2",
                 source: { nodeId: "n4", handle: "XYZ" },
                 target: { nodeId: "n1", handle: "A" },
-                typeId: "vec3[]",
+                typeId: "base.vec3[]",
                 // convertAsync,
             },
             {
@@ -1771,9 +1822,9 @@ function createAsyncGraphRegistry() {
 function createProgressGraphDef() {
     const def = {
         nodes: [
-            { nodeId: "steps", typeId: "number" },
-            { nodeId: "delay", typeId: "number" },
-            { nodeId: "work", typeId: "progressWorker" },
+            { nodeId: "steps", typeId: "base.number" },
+            { nodeId: "async.delay", typeId: "base.number" },
+            { nodeId: "work", typeId: "async.progress" },
         ],
         edges: [
             {
@@ -1783,7 +1834,7 @@ function createProgressGraphDef() {
             },
             {
                 id: "e2",
-                source: { nodeId: "delay", handle: "Result" },
+                source: { nodeId: "async.delay", handle: "Result" },
                 target: { nodeId: "work", handle: "DelayMs" },
             },
             // not wiring ShouldError to show manual input driven error later
@@ -1804,11 +1855,11 @@ function createValidationGraphDef() {
     // - Multi inbound to same input
     const def = {
         nodes: [
-            { nodeId: "nA", typeId: "number" },
-            { nodeId: "nB", typeId: "number" },
-            { nodeId: "nC", typeId: "math" },
-            { nodeId: "s1", typeId: "numberToString" },
-            { nodeId: "cmp", typeId: "compare" },
+            { nodeId: "nA", typeId: "base.number" },
+            { nodeId: "nB", typeId: "base.number" },
+            { nodeId: "nC", typeId: "base.math" },
+            { nodeId: "s1", typeId: "base.numberToString" },
+            { nodeId: "cmp", typeId: "base.compare" },
             // Global validation issue: unknown node type (no nodeId/edgeId in data)
             { nodeId: "bad", typeId: "unknownType" },
         ],