Added the Array Length node. (#521)

.changeset/quick-buckets-double.md

@@ -0,0 +1,5 @@
+---
+"@tokens-studio/graph-engine": minor
+---
+
+An Array Length node was added to get the length of an array.

packages/graph-engine/src/nodes/array/index.ts

@@ -6,6 +6,7 @@ import find from './find.js';
 import flatten from './flatten.js';
 import indexArray from './indexArray.js';
 import inject from './inject.js';
+import length from './length.js';
 import push from './push.js';
 import replace from './replace.js';
 import reverse from './reverse.js';
@@ -21,6 +22,7 @@ export const nodes = [
 	flatten,
 	indexArray,
 	inject,
+	length,
 	push,
 	replace,
 	reverse,

packages/graph-engine/src/nodes/array/length.ts

@@ -0,0 +1,33 @@
+import { AnyArraySchema, NumberSchema } from '../../schemas/index.js';
+import { INodeDefinition, ToInput, ToOutput } from '../../index.js';
+import { Node } from '../../programmatic/node.js';
+
+export default class NodeDefinition<T> extends Node {
+	static title = 'Array Length';
+	static type = 'studio.tokens.array.length';
+	static description = 'Determines the length of an array.';
+
+	declare inputs: ToInput<{
+		array: T[];
+	}>;
+
+	declare outputs: ToOutput<{
+		length: number;
+	}>;
+
+	constructor(props: INodeDefinition) {
+		super(props);
+		this.addInput('array', {
+			type: AnyArraySchema
+		});
+		this.addOutput('length', {
+			type: NumberSchema
+		});
+	}
+
+	execute(): void | Promise<void> {
+		const { array } = this.getAllInputs();
+
+		this.outputs.length.set(array.length);
+	}
+}

packages/graph-engine/tests/suites/nodes/array/length.test.ts

@@ -0,0 +1,16 @@
+import { Graph } from '../../../../src/graph/graph.js';
+import { describe, expect, test } from 'vitest';
+import Node from '../../../../src/nodes/array/length.js';
+
+describe('array/length', () => {
+	test('return length of array', async () => {
+		const graph = new Graph();
+		const node = new Node({ graph });
+
+		node.inputs.array.setValue([4, 5, 6]);
+
+		await node.execute();
+
+		expect(node.outputs.length.value).to.equal(3);
+	});
+});