@code0-tech/triangulum 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './src/index'
+export {}

package/dist/src/extraction/getTypeFromValue.d.ts

@@ -0,0 +1,5 @@
+import { LiteralValue } from '@code0-tech/sagittarius-graphql-types';
+/**
+ * Uses the TypeScript compiler to generate a precise type string from any runtime value.
+ */
+export declare const getTypeFromValue: (value: LiteralValue) => string;

package/dist/src/extraction/getTypeVariant.d.ts

@@ -0,0 +1,11 @@
+import { ExtendedDataType } from '../utils';
+export declare enum DataTypeVariant {
+    PRIMITIVE = 0,
+    TYPE = 1,
+    ARRAY = 2,
+    OBJECT = 3
+}
+/**
+ * Determines the variant of a given TypeScript type string using the TS compiler.
+ */
+export declare const getTypeVariant: (type: string, dataTypes: ExtendedDataType[]) => DataTypeVariant;

package/dist/src/extraction/getTypesFromNode.d.ts

@@ -0,0 +1,10 @@
+import { NodeFunction } from '@code0-tech/sagittarius-graphql-types';
+import { ExtendedDataType, ExtendedFunction } from '../utils';
+export interface NodeTypes {
+    parameters: string[];
+    returnType: string;
+}
+/**
+ * Resolves the types of the parameters and the return type of a NodeFunction.
+ */
+export declare const getTypesFromNode: (node: NodeFunction, functions: ExtendedFunction[], dataTypes: ExtendedDataType[]) => NodeTypes;

package/dist/src/extraction/getValueFromType.d.ts

@@ -0,0 +1,6 @@
+import { LiteralValue } from '@code0-tech/sagittarius-graphql-types';
+import { ExtendedDataType } from '../utils';
+/**
+ * Generates a sample LiteralValue from a TypeScript type string.
+ */
+export declare const getValueFromType: (type: string, dataTypes: ExtendedDataType[]) => LiteralValue;

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+export * from './validation/getFlowValidation';
+export * from './suggestion/getNodeSuggestions';
+export * from './validation/getNodeValidation';
+export * from './suggestion/getReferenceSuggestions';
+export * from './extraction/getTypeFromValue';
+export * from './extraction/getTypeVariant';
+export * from './extraction/getValueFromType';
+export * from './suggestion/getValueSuggestions';
+export * from './validation/getValueValidation';
+export * from './extraction/getTypesFromNode';

package/dist/src/suggestion/getNodeSuggestions.d.ts

@@ -0,0 +1,7 @@
+import { NodeFunction } from '@code0-tech/sagittarius-graphql-types';
+import { ExtendedFunction } from '../utils';
+/**
+ * Suggests NodeFunctions based on a given type and a list of available FunctionDefinitions.
+ * Returns functions whose return type is compatible with the target type.
+ */
+export declare function getNodeSuggestions(type: string, functions: ExtendedFunction[]): NodeFunction[];

package/dist/src/suggestion/getReferenceSuggestions.d.ts

@@ -0,0 +1,7 @@
+import { Flow, NodeFunction, ReferenceValue } from '@code0-tech/sagittarius-graphql-types';
+import { ExtendedDataType, ExtendedFunction } from '../utils';
+/**
+ * Calculates all available reference suggestions for a specific target node in a flow
+ * and filters them by a required type.
+ */
+export declare const getReferenceSuggestions: (flow: Flow, nodeId: NodeFunction["id"], type: string, functions: ExtendedFunction[], dataTypes: ExtendedDataType[]) => ReferenceValue[];

package/dist/src/suggestion/getValueSuggestions.d.ts

@@ -0,0 +1,5 @@
+import { LiteralValue } from '@code0-tech/sagittarius-graphql-types';
+/**
+ * Extracts possible literal values from a type string to provide suggestions.
+ */
+export declare const getValueSuggestions: (type: string) => LiteralValue[];

package/dist/src/utils.d.ts

@@ -0,0 +1,56 @@
+import { DataType, Flow, FunctionDefinition, NodeFunction, NodeParameter, ReferencePath, ReferenceValue } from '@code0-tech/sagittarius-graphql-types';
+import { default as ts } from 'typescript';
+/**
+ * Result of a node or flow validation.
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    inferredType: string;
+    errors: Array<{
+        message: string;
+        code: number;
+        severity: "error" | "warning";
+    }>;
+}
+export interface ExtendedDataType extends DataType {
+    type: string;
+    linkedDataTypeIdentifiers?: string[];
+}
+export interface ExtendedFunction extends Omit<FunctionDefinition, 'returnType'> {
+    signature: string;
+    linkedDataTypeIdentifiers?: string[];
+}
+/**
+ * Minimal TypeScript library definitions for the virtual compiler environment.
+ */
+export declare const MINIMAL_LIB = "\n    interface Array<T> { \n        [n: number]: T; \n        length: number; \n    }\n    interface String { readonly length: number; }\n    interface Number { }\n    interface Boolean { }\n    interface Object { }\n    interface Function { }\n    interface CallableFunction extends Function {}\n    interface NewableFunction extends Function {}\n    interface IArguments { }\n    interface RegExp { }\n    type ReturnType<T extends (...args: any) => any> = T extends (...args: any) => infer R ? R : any;\n";
+/**
+ * Common configuration for the TypeScript compiler host across different validation/inference tasks.
+ */
+export declare function createCompilerHost(fileName: string, sourceCode: string, sourceFile: ts.SourceFile): ts.CompilerHost;
+/**
+ * Common TypeScript compiler options used for validation and type inference.
+ */
+export declare const DEFAULT_COMPILER_OPTIONS: ts.CompilerOptions;
+/**
+ * Extracts and returns common type and generic declarations from DATA_TYPES.
+ */
+export declare function getSharedTypeDeclarations(dataTypes: ExtendedDataType[]): string;
+/**
+ * Determines the type along a reference path for objects.
+ * @param value The base value to traverse.
+ * @param referencePath The path of properties to follow.
+ * @returns The typeof the final value or 'unknown' if path is broken.
+ */
+export declare function getTypeFromReferencePath(value: any, referencePath: ReferencePath[]): string;
+/**
+ * Extracts and returns the TypeScript code representation for a NodeParameter.
+ */
+export declare function getParameterCode(param: NodeParameter, flow: Flow, getNodeValidation: (flow: Flow, node: NodeFunction) => ValidationResult): string;
+/**
+ * Validates if a reference is accessible from the current node's scope.
+ */
+export declare const validateReference: (flow: Flow, currentNode: NodeFunction, ref: ReferenceValue) => {
+    isValid: boolean;
+    error?: string;
+};

package/dist/src/validation/getFlowValidation.d.ts

@@ -0,0 +1,6 @@
+import { Flow } from '@code0-tech/sagittarius-graphql-types';
+import { ExtendedDataType, ExtendedFunction, ValidationResult } from '../utils';
+/**
+ * Validates a flow by generating virtual TypeScript code and running it through the TS compiler.
+ */
+export declare const getFlowValidation: (flow: Flow, functions: ExtendedFunction[], dataTypes: ExtendedDataType[]) => ValidationResult;

package/dist/src/validation/getNodeValidation.d.ts

@@ -0,0 +1,6 @@
+import { Flow, NodeFunction } from '@code0-tech/sagittarius-graphql-types';
+import { ExtendedDataType, ExtendedFunction, ValidationResult } from '../utils';
+/**
+ * Validates a single node's parameters and scope, then infers its return type.
+ */
+export declare const getNodeValidation: (flow: Flow, node: NodeFunction, functions: ExtendedFunction[], dataTypes: ExtendedDataType[]) => ValidationResult;

package/dist/src/validation/getValueValidation.d.ts

@@ -0,0 +1,10 @@
+import { LiteralValue } from '@code0-tech/sagittarius-graphql-types';
+import { ExtendedDataType } from '../utils';
+/**
+ * Validates whether a literal value conforms to a specific TypeScript type string.
+ */
+export interface ValueValidationResult {
+    isValid: boolean;
+    error?: string;
+}
+export declare const getValueValidation: (type: string, value: LiteralValue, dataTypes: ExtendedDataType[]) => ValueValidationResult;

package/dist/triangulum.cjs.js

@@ -0,0 +1,68 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("typescript"),W=`
+    interface Array<T> { 
+        [n: number]: T; 
+        length: number; 
+    }
+    interface String { readonly length: number; }
+    interface Number { }
+    interface Boolean { }
+    interface Object { }
+    interface Function { }
+    interface CallableFunction extends Function {}
+    interface NewableFunction extends Function {}
+    interface IArguments { }
+    interface RegExp { }
+    type ReturnType<T extends (...args: any) => any> = T extends (...args: any) => infer R ? R : any;
+`;function I(n,s,r){return{getSourceFile:e=>{if(e===n)return r;if(e.includes("lib.")||e.endsWith(".d.ts"))return t.createSourceFile(e,W,t.ScriptTarget.Latest)},writeFile:()=>{},getDefaultLibFileName:()=>"lib.d.ts",useCaseSensitiveFileNames:()=>!0,getCanonicalFileName:e=>e,getCurrentDirectory:()=>"/",getNewLine:()=>`
+`,fileExists:e=>e===n||e.includes("lib.")||e.endsWith(".d.ts"),readFile:e=>e===n?s:e.includes("lib.")||e.endsWith(".d.ts")?W:void 0,directoryExists:()=>!0,getDirectories:()=>[]}}const V={target:t.ScriptTarget.Latest,lib:["lib.esnext.d.ts"],noEmit:!0,strictNullChecks:!0};function A(n){const s=Array.from(new Set(n.flatMap(e=>e.genericKeys||[]))).map(e=>`type ${e} = any;`).join(`
+`),r=n.map(e=>`type ${e.identifier}${e.genericKeys?`<${e.genericKeys.join(",")}>`:""} = ${e.type};`).join(`
+`);return`${s}
+${r}`}function z(n,s){let r=n;for(const e of s){if(r==null)return"unknown";typeof e.path=="string"&&(r=r[e.path])}return typeof r}function B(n,s){const r=n.nodes;if(r)return Array.isArray(r)?r.find(e=>e.id===s):r.nodes?.find(e=>e.id===s)}function K(n,s,r){const e=n?.value;if(!e)return"undefined";if(e.__typename==="ReferenceValue"){const o=e,c=B(s,o.nodeFunctionId);if(!c)return"undefined";let u=r(s,c).inferredType;if(o.referencePath&&o.referencePath.length>0){let d;const m=c.parameters?.nodes;if(m&&m.length>0){const p=m[0];p?.value?.__typename==="LiteralValue"&&(d=p.value.value)}u=z(d,o.referencePath)}return`({} as ${u})`}if(e.__typename==="NodeFunctionIdWrapper"){const o=e.id,c=B(s,o);if(!c)return"(() => undefined)";const u=p=>{if(p.functionDefinition?.identifier==="std::control::return")return p;const y=p.nextNodeId?B(s,p.nextNodeId):void 0;return y?u(y):void 0},d=u(c);return d?`(() => ({} as ${r(s,d).inferredType}))`:"(() => undefined)"}return e.__typename==="LiteralValue"?JSON.stringify(e.value):"undefined"}const U=(n,s)=>{const r=n.nodes?.nodes;if(r)return r.find(e=>e?.parameters?.nodes?.some(o=>o?.value?.__typename==="NodeFunctionIdWrapper"&&o.value.id===s))},J=(n,s,r,e=new Set)=>{const o=s.id;if(!o||e.has(o))return!1;e.add(o);const c=d=>{const m=n.nodes?.nodes?.find(p=>p?.nextNodeId===d);return m?m.id===r?!0:c(m.id):!1};if(c(o))return!0;const u=U(n,o);return u?u.id===r?!0:J(n,u,r,e):!1},G=(n,s,r)=>{if(!r.nodeFunctionId)return{isValid:!0};if(r.parameterIndex!==void 0&&r.inputIndex!==void 0){if(s.id===r.nodeFunctionId)return{isValid:!0};let e=U(n,s.id);for(;e;){if(e.id===r.nodeFunctionId)return{isValid:!0};e=U(n,e.id)}return{isValid:!1,error:`Invalid input reference: Node ${s.id} is not in the scope of Node ${r.nodeFunctionId}.`}}return J(n,s,r.nodeFunctionId)?{isValid:!0}:{isValid:!1,error:`Node ${r.nodeFunctionId} has not been executed yet or is not visible in this scope.`}},M=n=>n.replace(/[^a-zA-Z0-9]/g,"_"),H=(n,s,r)=>{const e=new Set,o=n.nodes?.nodes||[],c=new Map(s.map(f=>[f.identifier,f])),u=(f,N="")=>{if(e.has(f))return"";const l=o.find(E=>E?.id===f);if(!l||!l.functionDefinition)return"";e.add(f);const _=c.get(l.functionDefinition?.identifier);if(!_)return`${N}// Error: Function ${l.functionDefinition.identifier} not found
+`;const S=(l.parameters?.nodes||[]).map((E,R)=>{const C=E.value;if(!C)return"undefined";if(C.__typename==="ReferenceValue"){const L=C;if(!L.nodeFunctionId)return"undefined";let b=L.parameterIndex!==void 0?`p_${M(L.nodeFunctionId)}_${L.parameterIndex}`:`node_${M(L.nodeFunctionId)}`;return L.referencePath?.forEach(j=>{b+=`?.${j.path}`}),b}if(C.__typename==="LiteralValue")return JSON.stringify(C.value);if(C.__typename==="NodeFunctionIdWrapper"){const L=C,b=`p_${M(l.id)}_${R}`,j=u(L.id,N+"  ");return`(${b}) => {
+${j}${N}}`}return"undefined"}).join(", "),$=`node_${M(l.id)}`,P=`fn_${_.identifier?.replace(/::/g,"_")}`,x=S.includes("undefined")||(_.genericKeys?.length??0)>0;let D=`${N}const ${$} = ${P}(${S})${x?" as any":""} ;
+`;return l.nextNodeId&&(D+=u(l.nextNodeId,N)),D},d=A(r),m=s.map(f=>`declare function fn_${f.identifier?.replace(/::/g,"_")}${f.signature}`).join(`
+`),p=o.map(f=>f?.id?u(f.id):"").filter(f=>f!=="").join(`
+`),y=`${d}
+${m}
+
+// --- Flow ---
+${p}`,a="flow_virtual.ts",i=t.createSourceFile(a,y,t.ScriptTarget.Latest),g=I(a,y,i),h=t.createProgram([a],V,g).getSemanticDiagnostics(i).map(f=>{const N=t.flattenDiagnosticMessageText(f.messageText,`
+`);return N.includes("Argument of type 'undefined'")||N.includes("not assignable to type 'undefined'")?null:{message:N,code:f.code,severity:"error"}}).filter(f=>f!==null);return{isValid:h.length===0,inferredType:"void",errors:h}},q=[{identifier:"LIST",type:"T[]",genericKeys:["T"]},{identifier:"NUMBER",type:"number"},{identifier:"HTTP_METHOD",type:'"GET" | "POST" | "PUT" | "DELETE"'},{identifier:"STRING",type:"string"},{identifier:"CONSUMER",type:"(item:R) => void",genericKeys:["R"]},{identifier:"PREDICATE",type:"(item:R) => T",genericKeys:["R","T"]},{identifier:"NUMBER_ARRAY",type:"LIST<NUMBER>",linkedDataTypeIdentifiers:["LIST","NUMBER"]}];function Q(n,s){if(!n||!s||s.length===0)return[];const r="suggestions.ts",e=A(q);function o(a){const i=a.match(/<([^>]+)>/);return i?i[1].split(",").map(g=>g.trim()).filter(Boolean).length:0}const c=`
+        ${e}
+        type TargetType = ${n};
+        ${s.map((a,i)=>`
+        declare function Fu${i}${a.signature};
+        type F${i} = ReturnType<typeof Fu${i}${o(a.signature)>0?`<${Array(o(a.signature)).fill("any").join(", ")}>`:""}>;
+        `).join(`
+`)}
+        ${s.map((a,i)=>`const check${i}: TargetType = {} as F${i};`).join(`
+`)}
+    `;console.log(c);const u=t.createSourceFile(r,c,t.ScriptTarget.Latest),d=I(r,c,u),p=t.createProgram([r],{...V},d).getSemanticDiagnostics(),y=new Set;return p.forEach(a=>{a.file===u&&a.start!==void 0&&y.add(u.getLineAndCharacterOfPosition(a.start).line)}),s.map((a,i)=>{const g=`const check${i}: TargetType = {} as F${i};`,T=c.split(`
+`).findIndex(h=>h.includes(g));return T!==-1&&y.has(T)?null:{__typename:"NodeFunction",id:"gid://sagittarius/NodeFunction/1",functionDefinition:{__typename:"FunctionDefinition",id:a.identifier,identifier:a.identifier},parameters:{__typename:"NodeParameterConnection",nodes:(a.parameterDefinitions?.nodes||[]).map(h=>({__typename:"NodeParameter",parameterDefinition:{__typename:"ParameterDefinition",id:h?.identifier,identifier:h?.identifier},value:null}))}}}).filter(a=>a!==null)}const O=(n,s,r,e)=>{const c=new Map(r.map(F=>[F.identifier,F])).get(s.functionDefinition?.identifier);if(!c)return{isValid:!1,inferredType:"any",errors:[{message:`Function ${s.id} not found`,code:404,severity:"error"}]};const u=s.parameters?.nodes||[],d=[];for(const F of u){const S=F.value;if(S?.__typename==="ReferenceValue"){const $=G(n,s,S);$.isValid||d.push({message:$.error||"Scope error",code:403,severity:"error"})}}if(d.length>0)return{isValid:!1,inferredType:"any",errors:d};const p=u.map(F=>K(F,n,(S,$)=>O(S,$,r,e))).map(F=>F==="undefined"?"({} as any)":F).join(", ");let y=c.signature;const a=`
+        ${A(e)}
+        declare function testFunc${y};
+        const result = testFunc(${p});
+    `,i="node_virtual.ts",g=t.createSourceFile(i,a,t.ScriptTarget.Latest),v=I(i,a,g),T=t.createProgram([i],V,v),h=T.getTypeChecker(),f=T.getSemanticDiagnostics(g);let N="any";const l=F=>{if(t.isVariableDeclaration(F)&&F.name.getText()==="result"){const S=h.getTypeAtLocation(F);N=h.typeToString(S,F,t.TypeFormatFlags.NoTruncation|t.TypeFormatFlags.UseFullyQualifiedType)}t.forEachChild(F,l)};l(g);const _=f.map(F=>{const S=t.flattenDiagnosticMessageText(F.messageText,`
+`),$=/\b([TRKV])\b/.test(S),P=S.includes("not assignable to parameter of type")&&(S.includes("'{}'")||S.includes("undefined"))||S.includes("not assignable to type 'undefined'")||S.includes("not assignable to type 'void'")||S.includes("may be a mistake because neither type sufficiently overlaps");return{message:S,code:F.code,severity:$||P?"warning":"error"}});return{isValid:!_.some(F=>F.severity==="error"),inferredType:N,errors:_}},Z=(n,s,r,e,o)=>{const c=[],u=n.nodes?.nodes||[],d=u.find(i=>i?.id===s);if(!d)return[];const m=A(o),p=(i,g)=>{if(!r||r==="any"||i==="any")return!0;const v=`suggestion_check_${Math.random().toString(36).substring(7)}.ts`,T=`
+            ${m}
+            const val: ${i} = {} as any;
+            const test: ${r} = val${g?`.${g}`:""};
+        `,h=t.createSourceFile(v,T,t.ScriptTarget.Latest),f=I(v,T,h);return!t.createProgram([v],V,f).getSemanticDiagnostics(h).some(_=>_.category===t.DiagnosticCategory.Error)},y=(i,g)=>{const v=[],T=`probing_${Math.random().toString(36).substring(7)}.ts`,h=`
+            ${m}
+            const val: ${i} = {} as any;
+        `,f=t.createSourceFile(T,h,t.ScriptTarget.Latest),N=I(T,h,f),l=t.createProgram([T],V,N),_=l.getTypeChecker();p(i)&&v.push({...g,referencePath:[]});const F=($,P=[])=>{if(P.length>3)return;const x=$.getProperties();for(const D of x){const E=D.getName();let R;if(_.getPropertyOfType){const b=_.getPropertyOfType($,E);b&&(R=_.getTypeOfSymbolAtLocation(b,f))}else{const b=$.getProperty(E);b&&(R=_.getTypeOfSymbolAtLocation(b,f))}if(!R)continue;const C=[...P,E],L=C.join(".");p(i,L)&&v.push({...g,referencePath:C.map(b=>({__typename:"ReferencePath",path:b}))}),F(R,C)}};if(l.getSemanticDiagnostics(f).length===0){let $;const P=x=>{t.isVariableDeclaration(x)&&x.name.getText()==="val"&&($=_.getTypeAtLocation(x)),t.forEachChild(x,P)};P(f),$&&F($)}return v};if(n.inputType){const i=n.inputType.identifier||"any";c.push(...y(i,{__typename:"ReferenceValue",nodeFunctionId:null,parameterIndex:0,referencePath:[]}))}u.forEach(i=>{if(!(!i||i.id===s)&&X(n,i,d)){const g=O(n,i,e,o);c.push(...y(g.inferredType,{__typename:"ReferenceValue",nodeFunctionId:i.id,referencePath:[]}))}});let a=k(n,s);for(;a;){if(e.find(g=>g.identifier===a.functionDefinition?.identifier)){const g=a.parameters?.nodes?.findIndex(v=>{const T=v?.value;if(T?.__typename==="NodeFunctionIdWrapper"){const h=T;return h.id===s||w(n,h.id||void 0,s)}return!1});g!==void 0&&g!==-1&&c.push(...y("any",{__typename:"ReferenceValue",nodeFunctionId:a.id,parameterIndex:g,inputIndex:0,referencePath:[]}))}a=k(n,a.id)}return c};function X(n,s,r){const e=n.nodes?.nodes||[];let o=s.nextNodeId;const c=new Set;for(;o;){if(o===r.id)return!0;if(c.has(o))break;c.add(o),o=e.find(m=>m?.id===o)?.nextNodeId}let u=k(n,r.id);for(;u;){if(u.id===s.id)return!0;u=k(n,u.id)}return!1}function k(n,s){return n.nodes?.nodes?.find(e=>e?.parameters?.nodes?.some(o=>o?.value?.__typename==="NodeFunctionIdWrapper"&&o.value.id===s))||void 0}function w(n,s,r){if(!s)return!1;if(s===r)return!0;const o=(n.nodes?.nodes||[]).find(u=>u?.id===s);return o?o.nextNodeId&&w(n,o.nextNodeId||void 0,r)?!0:!!o.parameters?.nodes?.some(u=>{const d=u?.value;return d?.__typename==="NodeFunctionIdWrapper"?w(n,d.id||void 0,r):!1}):!1}const ee=n=>{const r=`const tempValue = ${JSON.stringify(n.value)};`,e="temp_value.ts",o=t.createSourceFile(e,r,t.ScriptTarget.Latest),c=I(e,r,o),d=t.createProgram([e],{target:t.ScriptTarget.Latest,noEmit:!0},c).getTypeChecker();let m="any";const p=y=>{if(t.isVariableDeclaration(y)&&y.name.getText()==="tempValue"){const a=d.getTypeAtLocation(y);m=d.typeToString(a,y,t.TypeFormatFlags.NoTruncation|t.TypeFormatFlags.UseFullyQualifiedType)}t.forEachChild(y,p)};return p(o),m};var Y=(n=>(n[n.PRIMITIVE=0]="PRIMITIVE",n[n.TYPE=1]="TYPE",n[n.ARRAY=2]="ARRAY",n[n.OBJECT=3]="OBJECT",n))(Y||{});const te=(n,s)=>{const r=A(s),e=`type_probe_${Math.random().toString(36).substring(7)}.ts`,o=`
+        ${r}
+        type TargetType = ${n};
+        const val: TargetType = {} as any;
+    `,c=t.createSourceFile(e,o,t.ScriptTarget.Latest),u=I(e,o,c),m=t.createProgram([e],V,u).getTypeChecker();let p=1;const y=a=>{if(t.isVariableDeclaration(a)&&a.name.getText()==="val"){const i=m.getTypeAtLocation(a);m.isArrayType(i)?p=2:i.isStringLiteral()||i.isNumberLiteral()||(i.getFlags()&(t.TypeFlags.String|t.TypeFlags.Number|t.TypeFlags.Boolean|t.TypeFlags.EnumLiteral|t.TypeFlags.BigInt|t.TypeFlags.ESSymbol))!==0?p=0:(i.isClassOrInterface()||(i.getFlags()&t.TypeFlags.Object)!==0)&&i.getProperties().length>0?p=3:p=1}t.forEachChild(a,y)};return y(c),p},ne=(n,s)=>{const r=`
+        ${A(s)}
+        type Target = ${n};
+    `,e="temp_type_to_value.ts",o=t.createSourceFile(e,r,t.ScriptTarget.Latest,!0),c=I(e,r,o),d=t.createProgram([e],V,c).getTypeChecker(),m=o.statements.find(i=>t.isTypeAliasDeclaration(i)&&i.name.text==="Target");if(!m)return{__typename:"LiteralValue",value:null};const p=d.getTypeAtLocation(m.type),y=(i,g,v=new Set)=>{if(v.has(i))return null;v.add(i);const T=i.getFlags();if(i.isUnion()){if(g.type,t.isTypeAliasDeclaration(g)&&g.type&&t.isUnionTypeNode(g.type)){const N=d.getTypeFromTypeNode(g.type.types[0]);return y(N,g,v)}const h=i.types.filter(N=>{const l=N.getFlags();return!(l&t.TypeFlags.Undefined)&&!(l&t.TypeFlags.Null)}),f=h.length>0?h[0]:i.types[0];return y(f,g,v)}if(T&t.TypeFlags.StringLiteral)return i.value;if(T&t.TypeFlags.String)return"sample";if(T&t.TypeFlags.NumberLiteral)return i.value;if(T&t.TypeFlags.Number)return 1;if(T&t.TypeFlags.BooleanLiteral)return i.intrinsicName==="true";if(T&t.TypeFlags.Boolean)return!1;if(d.isArrayType(i)){const f=i.typeArguments?.[0]||d.getAnyType();return[y(f,g,v)]}if(i.isClassOrInterface()||T&t.TypeFlags.Object||i.getProperties().length>0){const h={};return i.getProperties().forEach(N=>{const l=d.getTypeOfSymbolAtLocation(N,g);l&&(h[N.getName()]=y(l,g,v))}),h}return null};return{value:y(p,m)}},re=n=>{if(!n)return[];const s=`type T = ${n}; const val: T = {} as any;`,r="suggestions_virtual.ts",e=t.createSourceFile(r,s,t.ScriptTarget.Latest),o=I(r,s,e),u=t.createProgram([r],{...V,noLib:!0},o).getTypeChecker(),d=e.statements.find(t.isTypeAliasDeclaration);if(!d)return[];const m=u.getTypeAtLocation(d),p=a=>a.isUnion()?a.types.flatMap(p):a.isStringLiteral()?[a.value]:a.isNumberLiteral()?[a.value.toString()]:a.intrinsicName==="true"?["true"]:a.intrinsicName==="false"?["false"]:[];return Array.from(new Set(p(m))).map(a=>({__typename:"LiteralValue",value:a}))},ie=(n,s,r)=>{const e=JSON.stringify(s.value),o=`
+        ${A(r)}
+        const testValue: ${n} = ${e};
+    `,c="value_check.ts",u=t.createSourceFile(c,o,t.ScriptTarget.Latest),d=I(c,o,u),p=t.createProgram([c],V,d).getSemanticDiagnostics(u);return p.length>0?{isValid:!1,error:t.flattenDiagnosticMessageText(p[0].messageText,`
+`)}:{isValid:!0}},se=(n,s,r)=>{const o=new Map(s.map(l=>[l.identifier,l])).get(n.functionDefinition?.identifier);if(!o)return{parameters:[],returnType:"any"};const c={id:"gid://sagittarius/Flow/0",nodes:{__typename:"NodeFunctionConnection",nodes:[n]}},m=(n.parameters?.nodes||[]).map(l=>K(l,c,(_,F)=>O(_,F,s,r))).map(l=>l==="undefined"?"({} as any)":l).join(", "),p=o.signature,y=`
+        ${A(r)}
+        declare function testFunc${p};
+        const result = testFunc(${m});
+    `,a="node_types_virtual.ts",i=t.createSourceFile(a,y,t.ScriptTarget.Latest),g=I(a,y,i),T=t.createProgram([a],V,g).getTypeChecker();let h="any",f=[];const N=l=>{if(t.isVariableDeclaration(l)&&l.name.getText()==="result"){const _=T.getTypeAtLocation(l);if(h=T.typeToString(_,l,t.TypeFormatFlags.NoTruncation),t.isCallExpression(l.initializer)){const F=l.initializer,S=T.getResolvedSignature(F);S&&(f=S.getParameters().map($=>{const P=T.getTypeOfSymbolAtLocation($,F);return T.typeToString(P,F,t.TypeFormatFlags.NoTruncation)}))}}t.forEachChild(l,N)};return N(i),{parameters:f,returnType:h}};exports.DataTypeVariant=Y;exports.getFlowValidation=H;exports.getNodeSuggestions=Q;exports.getNodeValidation=O;exports.getReferenceSuggestions=Z;exports.getTypeFromValue=ee;exports.getTypeVariant=te;exports.getTypesFromNode=se;exports.getValueFromType=ne;exports.getValueSuggestions=re;exports.getValueValidation=ie;

package/dist/triangulum.es.js

@@ -0,0 +1,584 @@
+import t from "typescript";
+const w = `
+    interface Array<T> { 
+        [n: number]: T; 
+        length: number; 
+    }
+    interface String { readonly length: number; }
+    interface Number { }
+    interface Boolean { }
+    interface Object { }
+    interface Function { }
+    interface CallableFunction extends Function {}
+    interface NewableFunction extends Function {}
+    interface IArguments { }
+    interface RegExp { }
+    type ReturnType<T extends (...args: any) => any> = T extends (...args: any) => infer R ? R : any;
+`;
+function I(n, s, r) {
+  return {
+    getSourceFile: (e) => {
+      if (e === n) return r;
+      if (e.includes("lib.") || e.endsWith(".d.ts")) return t.createSourceFile(e, w, t.ScriptTarget.Latest);
+    },
+    writeFile: () => {
+    },
+    getDefaultLibFileName: () => "lib.d.ts",
+    useCaseSensitiveFileNames: () => !0,
+    getCanonicalFileName: (e) => e,
+    getCurrentDirectory: () => "/",
+    getNewLine: () => `
+`,
+    fileExists: (e) => e === n || e.includes("lib.") || e.endsWith(".d.ts"),
+    readFile: (e) => e === n ? s : e.includes("lib.") || e.endsWith(".d.ts") ? w : void 0,
+    directoryExists: () => !0,
+    getDirectories: () => []
+  };
+}
+const x = {
+  target: t.ScriptTarget.Latest,
+  lib: ["lib.esnext.d.ts"],
+  noEmit: !0,
+  strictNullChecks: !0
+};
+function E(n) {
+  const s = Array.from(new Set(n.flatMap((e) => e.genericKeys || []))).map((e) => `type ${e} = any;`).join(`
+`), r = n.map(
+    (e) => `type ${e.identifier}${e.genericKeys ? `<${e.genericKeys.join(",")}>` : ""} = ${e.type};`
+  ).join(`
+`);
+  return `${s}
+${r}`;
+}
+function Y(n, s) {
+  let r = n;
+  for (const e of s) {
+    if (r == null) return "unknown";
+    typeof e.path == "string" && (r = r[e.path]);
+  }
+  return typeof r;
+}
+function j(n, s) {
+  const r = n.nodes;
+  if (r)
+    return Array.isArray(r) ? r.find((e) => e.id === s) : r.nodes?.find((e) => e.id === s);
+}
+function K(n, s, r) {
+  const e = n?.value;
+  if (!e) return "undefined";
+  if (e.__typename === "ReferenceValue") {
+    const o = e, c = j(s, o.nodeFunctionId);
+    if (!c) return "undefined";
+    let u = r(s, c).inferredType;
+    if (o.referencePath && o.referencePath.length > 0) {
+      let d;
+      const y = c.parameters?.nodes;
+      if (y && y.length > 0) {
+        const p = y[0];
+        p?.value?.__typename === "LiteralValue" && (d = p.value.value);
+      }
+      u = Y(d, o.referencePath);
+    }
+    return `({} as ${u})`;
+  }
+  if (e.__typename === "NodeFunctionIdWrapper") {
+    const o = e.id, c = j(s, o);
+    if (!c) return "(() => undefined)";
+    const u = (p) => {
+      if (p.functionDefinition?.identifier === "std::control::return")
+        return p;
+      const m = p.nextNodeId ? j(s, p.nextNodeId) : void 0;
+      return m ? u(m) : void 0;
+    }, d = u(c);
+    return d ? `(() => ({} as ${r(s, d).inferredType}))` : "(() => undefined)";
+  }
+  return e.__typename === "LiteralValue" ? JSON.stringify(e.value) : "undefined";
+}
+const B = (n, s) => {
+  const r = n.nodes?.nodes;
+  if (r)
+    return r.find(
+      (e) => e?.parameters?.nodes?.some(
+        (o) => o?.value?.__typename === "NodeFunctionIdWrapper" && o.value.id === s
+      )
+    );
+}, J = (n, s, r, e = /* @__PURE__ */ new Set()) => {
+  const o = s.id;
+  if (!o || e.has(o)) return !1;
+  e.add(o);
+  const c = (d) => {
+    const y = n.nodes?.nodes?.find((p) => p?.nextNodeId === d);
+    return y ? y.id === r ? !0 : c(y.id) : !1;
+  };
+  if (c(o)) return !0;
+  const u = B(n, o);
+  return u ? u.id === r ? !0 : J(n, u, r, e) : !1;
+}, z = (n, s, r) => {
+  if (!r.nodeFunctionId)
+    return { isValid: !0 };
+  if (r.parameterIndex !== void 0 && r.inputIndex !== void 0) {
+    if (s.id === r.nodeFunctionId) return { isValid: !0 };
+    let e = B(n, s.id);
+    for (; e; ) {
+      if (e.id === r.nodeFunctionId) return { isValid: !0 };
+      e = B(n, e.id);
+    }
+    return {
+      isValid: !1,
+      error: `Invalid input reference: Node ${s.id} is not in the scope of Node ${r.nodeFunctionId}.`
+    };
+  }
+  return J(n, s, r.nodeFunctionId) ? { isValid: !0 } : {
+    isValid: !1,
+    error: `Node ${r.nodeFunctionId} has not been executed yet or is not visible in this scope.`
+  };
+}, M = (n) => n.replace(/[^a-zA-Z0-9]/g, "_"), Z = (n, s, r) => {
+  const e = /* @__PURE__ */ new Set(), o = n.nodes?.nodes || [], c = new Map(s.map((f) => [f.identifier, f])), u = (f, N = "") => {
+    if (e.has(f)) return "";
+    const l = o.find((R) => R?.id === f);
+    if (!l || !l.functionDefinition) return "";
+    e.add(f);
+    const v = c.get(l.functionDefinition?.identifier);
+    if (!v) return `${N}// Error: Function ${l.functionDefinition.identifier} not found
+`;
+    const S = (l.parameters?.nodes || []).map((R, D) => {
+      const P = R.value;
+      if (!P) return "undefined";
+      if (P.__typename === "ReferenceValue") {
+        const L = P;
+        if (!L.nodeFunctionId) return "undefined";
+        let b = L.parameterIndex !== void 0 ? `p_${M(L.nodeFunctionId)}_${L.parameterIndex}` : `node_${M(L.nodeFunctionId)}`;
+        return L.referencePath?.forEach((O) => {
+          b += `?.${O.path}`;
+        }), b;
+      }
+      if (P.__typename === "LiteralValue")
+        return JSON.stringify(P.value);
+      if (P.__typename === "NodeFunctionIdWrapper") {
+        const L = P, b = `p_${M(l.id)}_${D}`, O = u(L.id, N + "  ");
+        return `(${b}) => {
+${O}${N}}`;
+      }
+      return "undefined";
+    }).join(", "), $ = `node_${M(l.id)}`, C = `fn_${v.identifier?.replace(/::/g, "_")}`, A = S.includes("undefined") || (v.genericKeys?.length ?? 0) > 0;
+    let V = `${N}const ${$} = ${C}(${S})${A ? " as any" : ""} ;
+`;
+    return l.nextNodeId && (V += u(l.nextNodeId, N)), V;
+  }, d = E(r), y = s.map((f) => `declare function fn_${f.identifier?.replace(/::/g, "_")}${f.signature}`).join(`
+`), p = o.map((f) => f?.id ? u(f.id) : "").filter((f) => f !== "").join(`
+`), m = `${d}
+${y}
+
+// --- Flow ---
+${p}`, a = "flow_virtual.ts", i = t.createSourceFile(a, m, t.ScriptTarget.Latest), g = I(a, m, i), h = t.createProgram([a], x, g).getSemanticDiagnostics(i).map((f) => {
+    const N = t.flattenDiagnosticMessageText(f.messageText, `
+`);
+    return N.includes("Argument of type 'undefined'") || N.includes("not assignable to type 'undefined'") ? null : {
+      message: N,
+      code: f.code,
+      severity: "error"
+    };
+  }).filter((f) => f !== null);
+  return {
+    isValid: h.length === 0,
+    inferredType: "void",
+    errors: h
+  };
+}, G = [
+  { identifier: "LIST", type: "T[]", genericKeys: ["T"] },
+  { identifier: "NUMBER", type: "number" },
+  { identifier: "HTTP_METHOD", type: '"GET" | "POST" | "PUT" | "DELETE"' },
+  { identifier: "STRING", type: "string" },
+  { identifier: "CONSUMER", type: "(item:R) => void", genericKeys: ["R"] },
+  { identifier: "PREDICATE", type: "(item:R) => T", genericKeys: ["R", "T"] },
+  { identifier: "NUMBER_ARRAY", type: "LIST<NUMBER>", linkedDataTypeIdentifiers: ["LIST", "NUMBER"] }
+];
+function X(n, s) {
+  if (!n || !s || s.length === 0)
+    return [];
+  const r = "suggestions.ts", e = E(G);
+  function o(a) {
+    const i = a.match(/<([^>]+)>/);
+    return i ? i[1].split(",").map((g) => g.trim()).filter(Boolean).length : 0;
+  }
+  const c = `
+        ${e}
+        type TargetType = ${n};
+        ${s.map((a, i) => `
+        declare function Fu${i}${a.signature};
+        type F${i} = ReturnType<typeof Fu${i}${o(a.signature) > 0 ? `<${Array(o(a.signature)).fill("any").join(", ")}>` : ""}>;
+        `).join(`
+`)}
+        ${s.map((a, i) => `const check${i}: TargetType = {} as F${i};`).join(`
+`)}
+    `;
+  console.log(c);
+  const u = t.createSourceFile(r, c, t.ScriptTarget.Latest), d = I(r, c, u), p = t.createProgram([r], {
+    ...x
+  }, d).getSemanticDiagnostics(), m = /* @__PURE__ */ new Set();
+  return p.forEach((a) => {
+    a.file === u && a.start !== void 0 && m.add(u.getLineAndCharacterOfPosition(a.start).line);
+  }), s.map((a, i) => {
+    const g = `const check${i}: TargetType = {} as F${i};`, T = c.split(`
+`).findIndex((h) => h.includes(g));
+    return T !== -1 && m.has(T) ? null : {
+      __typename: "NodeFunction",
+      id: "gid://sagittarius/NodeFunction/1",
+      functionDefinition: {
+        __typename: "FunctionDefinition",
+        id: a.identifier,
+        identifier: a.identifier
+      },
+      parameters: {
+        __typename: "NodeParameterConnection",
+        nodes: (a.parameterDefinitions?.nodes || []).map((h) => ({
+          __typename: "NodeParameter",
+          parameterDefinition: {
+            __typename: "ParameterDefinition",
+            id: h?.identifier,
+            identifier: h?.identifier
+          },
+          value: null
+        }))
+      }
+    };
+  }).filter((a) => a !== null);
+}
+const W = (n, s, r, e) => {
+  const c = new Map(r.map((F) => [F.identifier, F])).get(s.functionDefinition?.identifier);
+  if (!c)
+    return {
+      isValid: !1,
+      inferredType: "any",
+      errors: [{ message: `Function ${s.id} not found`, code: 404, severity: "error" }]
+    };
+  const u = s.parameters?.nodes || [], d = [];
+  for (const F of u) {
+    const S = F.value;
+    if (S?.__typename === "ReferenceValue") {
+      const $ = z(n, s, S);
+      $.isValid || d.push({
+        message: $.error || "Scope error",
+        code: 403,
+        severity: "error"
+      });
+    }
+  }
+  if (d.length > 0)
+    return {
+      isValid: !1,
+      inferredType: "any",
+      errors: d
+    };
+  const p = u.map((F) => K(F, n, (S, $) => W(S, $, r, e))).map(
+    (F) => F === "undefined" ? "({} as any)" : F
+  ).join(", ");
+  let m = c.signature;
+  const a = `
+        ${E(e)}
+        declare function testFunc${m};
+        const result = testFunc(${p});
+    `, i = "node_virtual.ts", g = t.createSourceFile(i, a, t.ScriptTarget.Latest), _ = I(i, a, g), T = t.createProgram([i], x, _), h = T.getTypeChecker(), f = T.getSemanticDiagnostics(g);
+  let N = "any";
+  const l = (F) => {
+    if (t.isVariableDeclaration(F) && F.name.getText() === "result") {
+      const S = h.getTypeAtLocation(F);
+      N = h.typeToString(
+        S,
+        F,
+        t.TypeFormatFlags.NoTruncation | t.TypeFormatFlags.UseFullyQualifiedType
+      );
+    }
+    t.forEachChild(F, l);
+  };
+  l(g);
+  const v = f.map((F) => {
+    const S = t.flattenDiagnosticMessageText(F.messageText, `
+`), $ = /\b([TRKV])\b/.test(S), C = S.includes("not assignable to parameter of type") && (S.includes("'{}'") || S.includes("undefined")) || S.includes("not assignable to type 'undefined'") || S.includes("not assignable to type 'void'") || S.includes("may be a mistake because neither type sufficiently overlaps");
+    return {
+      message: S,
+      code: F.code,
+      severity: $ || C ? "warning" : "error"
+    };
+  });
+  return {
+    isValid: !v.some((F) => F.severity === "error"),
+    inferredType: N,
+    errors: v
+  };
+}, ee = (n, s, r, e, o) => {
+  const c = [], u = n.nodes?.nodes || [], d = u.find((i) => i?.id === s);
+  if (!d) return [];
+  const y = E(o), p = (i, g) => {
+    if (!r || r === "any" || i === "any") return !0;
+    const _ = `suggestion_check_${Math.random().toString(36).substring(7)}.ts`, T = `
+            ${y}
+            const val: ${i} = {} as any;
+            const test: ${r} = val${g ? `.${g}` : ""};
+        `, h = t.createSourceFile(_, T, t.ScriptTarget.Latest), f = I(_, T, h);
+    return !t.createProgram([_], x, f).getSemanticDiagnostics(h).some((v) => v.category === t.DiagnosticCategory.Error);
+  }, m = (i, g) => {
+    const _ = [], T = `probing_${Math.random().toString(36).substring(7)}.ts`, h = `
+            ${y}
+            const val: ${i} = {} as any;
+        `, f = t.createSourceFile(T, h, t.ScriptTarget.Latest), N = I(T, h, f), l = t.createProgram([T], x, N), v = l.getTypeChecker();
+    p(i) && _.push({ ...g, referencePath: [] });
+    const F = ($, C = []) => {
+      if (C.length > 3) return;
+      const A = $.getProperties();
+      for (const V of A) {
+        const R = V.getName();
+        let D;
+        if (v.getPropertyOfType) {
+          const b = v.getPropertyOfType($, R);
+          b && (D = v.getTypeOfSymbolAtLocation(b, f));
+        } else {
+          const b = $.getProperty(R);
+          b && (D = v.getTypeOfSymbolAtLocation(b, f));
+        }
+        if (!D) continue;
+        const P = [...C, R], L = P.join(".");
+        p(i, L) && _.push({
+          ...g,
+          referencePath: P.map((b) => ({
+            __typename: "ReferencePath",
+            path: b
+          }))
+        }), F(D, P);
+      }
+    };
+    if (l.getSemanticDiagnostics(f).length === 0) {
+      let $;
+      const C = (A) => {
+        t.isVariableDeclaration(A) && A.name.getText() === "val" && ($ = v.getTypeAtLocation(A)), t.forEachChild(A, C);
+      };
+      C(f), $ && F($);
+    }
+    return _;
+  };
+  if (n.inputType) {
+    const i = n.inputType.identifier || "any";
+    c.push(...m(i, {
+      __typename: "ReferenceValue",
+      nodeFunctionId: null,
+      parameterIndex: 0,
+      referencePath: []
+    }));
+  }
+  u.forEach((i) => {
+    if (!(!i || i.id === s) && H(n, i, d)) {
+      const g = W(n, i, e, o);
+      c.push(...m(g.inferredType, {
+        __typename: "ReferenceValue",
+        nodeFunctionId: i.id,
+        referencePath: []
+      }));
+    }
+  });
+  let a = k(n, s);
+  for (; a; ) {
+    if (e.find((g) => g.identifier === a.functionDefinition?.identifier)) {
+      const g = a.parameters?.nodes?.findIndex((_) => {
+        const T = _?.value;
+        if (T?.__typename === "NodeFunctionIdWrapper") {
+          const h = T;
+          return h.id === s || U(n, h.id || void 0, s);
+        }
+        return !1;
+      });
+      g !== void 0 && g !== -1 && c.push(...m("any", {
+        __typename: "ReferenceValue",
+        nodeFunctionId: a.id,
+        parameterIndex: g,
+        inputIndex: 0,
+        referencePath: []
+      }));
+    }
+    a = k(n, a.id);
+  }
+  return c;
+};
+function H(n, s, r) {
+  const e = n.nodes?.nodes || [];
+  let o = s.nextNodeId;
+  const c = /* @__PURE__ */ new Set();
+  for (; o; ) {
+    if (o === r.id) return !0;
+    if (c.has(o)) break;
+    c.add(o), o = e.find((y) => y?.id === o)?.nextNodeId;
+  }
+  let u = k(n, r.id);
+  for (; u; ) {
+    if (u.id === s.id) return !0;
+    u = k(n, u.id);
+  }
+  return !1;
+}
+function k(n, s) {
+  return n.nodes?.nodes?.find(
+    (e) => e?.parameters?.nodes?.some(
+      (o) => o?.value?.__typename === "NodeFunctionIdWrapper" && o.value.id === s
+    )
+  ) || void 0;
+}
+function U(n, s, r) {
+  if (!s) return !1;
+  if (s === r) return !0;
+  const o = (n.nodes?.nodes || []).find((u) => u?.id === s);
+  return o ? o.nextNodeId && U(n, o.nextNodeId || void 0, r) ? !0 : !!o.parameters?.nodes?.some((u) => {
+    const d = u?.value;
+    return d?.__typename === "NodeFunctionIdWrapper" ? U(n, d.id || void 0, r) : !1;
+  }) : !1;
+}
+const te = (n) => {
+  const r = `const tempValue = ${JSON.stringify(n.value)};`, e = "temp_value.ts", o = t.createSourceFile(e, r, t.ScriptTarget.Latest), c = I(e, r, o), d = t.createProgram([e], { target: t.ScriptTarget.Latest, noEmit: !0 }, c).getTypeChecker();
+  let y = "any";
+  const p = (m) => {
+    if (t.isVariableDeclaration(m) && m.name.getText() === "tempValue") {
+      const a = d.getTypeAtLocation(m);
+      y = d.typeToString(
+        a,
+        m,
+        t.TypeFormatFlags.NoTruncation | t.TypeFormatFlags.UseFullyQualifiedType
+      );
+    }
+    t.forEachChild(m, p);
+  };
+  return p(o), y;
+};
+var q = /* @__PURE__ */ ((n) => (n[n.PRIMITIVE = 0] = "PRIMITIVE", n[n.TYPE = 1] = "TYPE", n[n.ARRAY = 2] = "ARRAY", n[n.OBJECT = 3] = "OBJECT", n))(q || {});
+const ne = (n, s) => {
+  const r = E(s), e = `type_probe_${Math.random().toString(36).substring(7)}.ts`, o = `
+        ${r}
+        type TargetType = ${n};
+        const val: TargetType = {} as any;
+    `, c = t.createSourceFile(e, o, t.ScriptTarget.Latest), u = I(e, o, c), y = t.createProgram([e], x, u).getTypeChecker();
+  let p = 1;
+  const m = (a) => {
+    if (t.isVariableDeclaration(a) && a.name.getText() === "val") {
+      const i = y.getTypeAtLocation(a);
+      y.isArrayType(i) ? p = 2 : i.isStringLiteral() || i.isNumberLiteral() || (i.getFlags() & (t.TypeFlags.String | t.TypeFlags.Number | t.TypeFlags.Boolean | t.TypeFlags.EnumLiteral | t.TypeFlags.BigInt | t.TypeFlags.ESSymbol)) !== 0 ? p = 0 : (i.isClassOrInterface() || (i.getFlags() & t.TypeFlags.Object) !== 0) && i.getProperties().length > 0 ? p = 3 : p = 1;
+    }
+    t.forEachChild(a, m);
+  };
+  return m(c), p;
+}, re = (n, s) => {
+  const r = `
+        ${E(s)}
+        type Target = ${n};
+    `, e = "temp_type_to_value.ts", o = t.createSourceFile(e, r, t.ScriptTarget.Latest, !0), c = I(e, r, o), d = t.createProgram([e], x, c).getTypeChecker(), y = o.statements.find(
+    (i) => t.isTypeAliasDeclaration(i) && i.name.text === "Target"
+  );
+  if (!y)
+    return { __typename: "LiteralValue", value: null };
+  const p = d.getTypeAtLocation(y.type), m = (i, g, _ = /* @__PURE__ */ new Set()) => {
+    if (_.has(i)) return null;
+    _.add(i);
+    const T = i.getFlags();
+    if (i.isUnion()) {
+      if (g.type, t.isTypeAliasDeclaration(g) && g.type && t.isUnionTypeNode(g.type)) {
+        const N = d.getTypeFromTypeNode(g.type.types[0]);
+        return m(N, g, _);
+      }
+      const h = i.types.filter((N) => {
+        const l = N.getFlags();
+        return !(l & t.TypeFlags.Undefined) && !(l & t.TypeFlags.Null);
+      }), f = h.length > 0 ? h[0] : i.types[0];
+      return m(f, g, _);
+    }
+    if (T & t.TypeFlags.StringLiteral) return i.value;
+    if (T & t.TypeFlags.String) return "sample";
+    if (T & t.TypeFlags.NumberLiteral) return i.value;
+    if (T & t.TypeFlags.Number) return 1;
+    if (T & t.TypeFlags.BooleanLiteral) return i.intrinsicName === "true";
+    if (T & t.TypeFlags.Boolean) return !1;
+    if (d.isArrayType(i)) {
+      const f = i.typeArguments?.[0] || d.getAnyType();
+      return [m(f, g, _)];
+    }
+    if (i.isClassOrInterface() || T & t.TypeFlags.Object || i.getProperties().length > 0) {
+      const h = {};
+      return i.getProperties().forEach((N) => {
+        const l = d.getTypeOfSymbolAtLocation(N, g);
+        l && (h[N.getName()] = m(l, g, _));
+      }), h;
+    }
+    return null;
+  };
+  return {
+    value: m(p, y)
+  };
+}, ie = (n) => {
+  if (!n) return [];
+  const s = `type T = ${n}; const val: T = {} as any;`, r = "suggestions_virtual.ts", e = t.createSourceFile(r, s, t.ScriptTarget.Latest), o = I(r, s, e), u = t.createProgram([r], { ...x, noLib: !0 }, o).getTypeChecker(), d = e.statements.find(t.isTypeAliasDeclaration);
+  if (!d) return [];
+  const y = u.getTypeAtLocation(d), p = (a) => a.isUnion() ? a.types.flatMap(p) : a.isStringLiteral() ? [a.value] : a.isNumberLiteral() ? [a.value.toString()] : a.intrinsicName === "true" ? ["true"] : a.intrinsicName === "false" ? ["false"] : [];
+  return Array.from(new Set(p(y))).map((a) => ({
+    __typename: "LiteralValue",
+    value: a
+  }));
+}, se = (n, s, r) => {
+  const e = JSON.stringify(s.value), o = `
+        ${E(r)}
+        const testValue: ${n} = ${e};
+    `, c = "value_check.ts", u = t.createSourceFile(c, o, t.ScriptTarget.Latest), d = I(c, o, u), p = t.createProgram([c], x, d).getSemanticDiagnostics(u);
+  return p.length > 0 ? {
+    isValid: !1,
+    error: t.flattenDiagnosticMessageText(p[0].messageText, `
+`)
+  } : { isValid: !0 };
+}, oe = (n, s, r) => {
+  const o = new Map(s.map((l) => [l.identifier, l])).get(n.functionDefinition?.identifier);
+  if (!o)
+    return {
+      parameters: [],
+      returnType: "any"
+    };
+  const c = {
+    id: "gid://sagittarius/Flow/0",
+    nodes: { __typename: "NodeFunctionConnection", nodes: [n] }
+  }, y = (n.parameters?.nodes || []).map((l) => K(l, c, (v, F) => W(v, F, s, r))).map((l) => l === "undefined" ? "({} as any)" : l).join(", "), p = o.signature, m = `
+        ${E(r)}
+        declare function testFunc${p};
+        const result = testFunc(${y});
+    `, a = "node_types_virtual.ts", i = t.createSourceFile(a, m, t.ScriptTarget.Latest), g = I(a, m, i), T = t.createProgram([a], x, g).getTypeChecker();
+  let h = "any", f = [];
+  const N = (l) => {
+    if (t.isVariableDeclaration(l) && l.name.getText() === "result") {
+      const v = T.getTypeAtLocation(l);
+      if (h = T.typeToString(
+        v,
+        l,
+        t.TypeFormatFlags.NoTruncation
+      ), t.isCallExpression(l.initializer)) {
+        const F = l.initializer, S = T.getResolvedSignature(F);
+        S && (f = S.getParameters().map(($) => {
+          const C = T.getTypeOfSymbolAtLocation($, F);
+          return T.typeToString(
+            C,
+            F,
+            t.TypeFormatFlags.NoTruncation
+          );
+        }));
+      }
+    }
+    t.forEachChild(l, N);
+  };
+  return N(i), {
+    parameters: f,
+    returnType: h
+  };
+};
+export {
+  q as DataTypeVariant,
+  Z as getFlowValidation,
+  X as getNodeSuggestions,
+  W as getNodeValidation,
+  ee as getReferenceSuggestions,
+  te as getTypeFromValue,
+  ne as getTypeVariant,
+  oe as getTypesFromNode,
+  re as getValueFromType,
+  ie as getValueSuggestions,
+  se as getValueValidation
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@code0-tech/triangulum",
+  "version": "0.1.0",
+  "description": "",
+  "homepage": "https://github.com/code0-tech/triangulum#readme",
+  "bugs": {
+    "url": "https://github.com/code0-tech/triangulum/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/code0-tech/triangulum.git"
+  },
+  "author": "CodeZero",
+  "type": "module",
+  "main": "./dist/triangulum.cjs.js",
+  "module": "./dist/triangulum.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/triangulum.es.js",
+      "require": "./dist/triangulum.cjs.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@code0-tech/sagittarius-graphql-types": "0.0.0-experimental-2342308809-931efb40b4bf3245999c53abbdd9164cea82e82d",
+    "@types/node": "^25.3.2",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.18"
+  }
+}