@elyx-code/project-logic-tree 0.0.6113 → 0.0.6114

package/dist/tree/state/variable-instance/variable-instance.d.ts

@@ -1,6 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, IVariableInstance, IVariableInstanceGenerationTarget, IVariableInstanceReference, IVariableInstanceShallowTransfer, IVariableInstanceTransfer, VariableInstanceTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseCanvasDraggableState, BaseState, CallableEntityClass, ChildEntityState, EntityWithValueClass, PassThroughCallableEntityClass, UserManagedEntityStateFunctionality, ValueReadingEntityClass, ValueWritingEntityClass } from '../base';
+import { BaseCanvasDraggableState, BaseState, CallableEntityClass, ChildEntityState, EntityWithValueClass, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, PassThroughCallableEntityClass, UserManagedEntityStateFunctionality, ValueReadingEntityClass, ValueWritingEntityClass } from '../base';
 import { CallableEntityState, CallerEntityState, EntityState, EntityWithLogicScopeState, EntryPointEntityState, IChangeSet, PassThroughCallableEntityState, ValueReadingEntityState, ValueWritingEntityState } from '../types';
 import { ProjectState } from '../project';
 import { VariableInputMapState } from '../input-map';
@@ -36,6 +36,7 @@ export declare class VariableInstanceState implements IVariableInstance, BaseSta
     initialized: boolean;
     suggestion: boolean;
     constructor(initialVariableDeclarationData: IVariableInstance | IVariableInstanceTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -58,6 +59,8 @@ export declare class VariableInstanceState implements IVariableInstance, BaseSta
         errors: EntityGenerationError[];
         modifiedData: Partial<IVariableInstanceGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<VariableInstanceState>;
+    afterAllChildrenInitialized(): IChangeSet<VariableInstanceState>;
     addSelfToProject(): IChangeSet<VariableInstanceState>;
     get calledBy(): CallerEntityState[];
     get usedInputs(): VariableInputMapState[];
@@ -86,10 +89,10 @@ export declare class VariableInstanceState implements IVariableInstance, BaseSta
     subscribe(): VariableInstanceState;
     unsubscribe(): VariableInstanceState;
     sync(data: Partial<IVariableInstance>): VariableInstanceState;
-    load(): Promise<VariableInstanceState>;
-    create(): Promise<VariableInstanceState>;
-    update(data: Partial<VariableInstanceTypesUnion>): Promise<VariableInstanceState>;
-    delete(): Promise<VariableInstanceState>;
+    load(_?: IEntityPersistanceOptions): Promise<VariableInstanceState>;
+    create(_?: IEntityPersistanceOptions): Promise<VariableInstanceState>;
+    update(_?: IEntityPersistanceOptions): Promise<VariableInstanceState>;
+    delete(_?: IEntityPersistanceOptions): Promise<VariableInstanceState>;
     remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -103,14 +106,15 @@ export declare class VariableInstanceState implements IVariableInstance, BaseSta
         affected: EntityState[];
         self: VariableInstanceState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IVariableInstanceTransfer;
-    toReference(): IVariableInstanceReference;
-    toShallowJSON(): IVariableInstanceShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IVariableInstanceTransfer | IVariableInstanceReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IVariableInstanceTransfer | IVariableInstanceReference;
+    toReference(options?: IEntityRecursionOptions): IVariableInstanceReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IVariableInstanceShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IVariableInstanceGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): VariableInstanceState;
     validate(): {
         success: boolean;
@@ -121,7 +125,7 @@ export declare class VariableInstanceState implements IVariableInstance, BaseSta
     getShallowErrors(): EntityError[];
     getDefaultValue(): LiteralValueState | null;
     setDefaultValue(value: LiteralValueState): VariableInstanceState;
-    clone(_?: EntryPointEntityState): VariableInstanceState;
+    clone(parent?: EntryPointEntityState | ProjectState | null, newId?: string | null, subscribe?: boolean): VariableInstanceState;
     addInternalCall(internalCall: InternalCallState): VariableInstanceState;
     setDeclaration(declaration: VariableDeclarationState): VariableInstanceState;
     generateUnusedInputs(): VariableInputMapState[];

package/dist/tree/utils/index.d.ts

@@ -1,4 +1,4 @@
-import { BaseEntityNames, ElementGenerationTarget, ElementShallowTransfer, ElementTransfer, EntityType, Element, IGenericReference, ValueReadingEntityTypesUnion } from '../../definitions';
+import { BaseEntityNames, ElementGenerationTarget, ElementShallowTransfer, ElementTransfer, EntityType, Element, IGenericReference, EntityId, ValueReadingEntityTypesUnion, ValueReadingEntity, IActionDescriptor, IActionDescriptorTransfer, IArgumentDeclaration, IArgumentDeclarationTransfer, DraggableElement, Reference, IBreakStatement, IBreakStatementTransfer, IBuiltInBaseEntity, IBuiltInBaseEntityTransfer, ICondition, IConditionTransfer, IContinueStatement, IContinueStatementTransfer, CallableEntity, CallableEntityTransfer, CallerEntity, CallerEntityTransfer, ICustomEntity, ICustomEntityTransfer, IDataType, IDataTypeTransfer, IFunctionCall, IFunctionCallTransfer, IFunctionDeclaration, IFunctionDeclarationTransfer, IGlobalEvent, IGlobalEventTransfer, IInputMap, IInputMapTransfer, IInstalledProject, IInstalledProjectTransfer, IInternalCall, IInternalCallTransfer, ILiteralValue, ILiteralValueTransfer, ILoop, ILoopTransfer, IOperation, IOperationTransfer, IOutputMap, IOutputMapTransfer, IPrimitiveEntity, IPrimitiveEntityTransfer, IProject, IProjectTransfer, IProperty, IPropertyTransfer, IReturnDeclaration, IReturnDeclarationTransfer, IReturnStatement, IReturnStatementTransfer, ISearch, ISearchTransfer, IValueDescriptor, IValueDescriptorTransfer, IVariableDeclarationTransfer, IVariableDeclaration, IVariableInstance, IVariableInstanceTransfer, DraggableElementTransfer, ValueReadingEntityTransfer } from '../../definitions';
 import { DraggableCallableEntityState, CanvasEntityState, EntityState, EntityWithLogicScopeState, EntryPointEntityState, DraggableExecutableEntityState, DraggablePassThroughCallableEntityState, ValueReadingEntityState, ValueWritingEntityState, EntityWithValueState, VariableState, BuiltInBaseEntityState, TerminationState, InstalledProjectState, ExecutableEntityState, ValueDescriptorState, CallableEntityState, CallerEntityState, PassThroughCallableEntityState, PrimitiveEntityState, InternalCallState } from '../state';
 import { FunctionCallState } from '../state/function-call';
 import { InputMapState } from '../state/input-map';
@@ -28,12 +28,13 @@ export declare function flattenCanvasAncestorsUntil(entity: CanvasEntityState, u
     list: CanvasEntityState[];
     last: CanvasEntityState | null;
 };
-export declare function getCommonChildren(entityA: CanvasEntityState, entityB: CanvasEntityState, seenEntities?: Set<string>): CanvasEntityState[];
+export declare function getCommonChildren(entityA: CanvasEntityState, entityB: CanvasEntityState, seenEntities?: Set<EntityId>): CanvasEntityState[];
 export declare function checkIsBranchDependentButNotDirectlyOnBranch(branchA: CanvasEntityState, branchB: CanvasEntityState): boolean;
 export declare function checkIsBranchDependentOnBranch(branchA: CanvasEntityState, branchB: CanvasEntityState): boolean;
 export declare function getParentEntryPoint(entity: EntityState): EntryPointEntityState | null;
 export declare function getCommonAncestor(entityA: EntityState, entityB: EntityState): EntityState | null;
 export declare function getParentCanvasEntity(entity: EntityState): CanvasEntityState | null;
+export declare function getParentCanvasEntityFromTransfer(entity: Element | ElementTransfer | IGenericReference, allKnownEntities: Record<EntityId, Element | ElementTransfer>): DraggableElement | DraggableElementTransfer | null;
 export declare function getParentCallableEntity(entity: EntityState): CallableEntityState | null;
 export declare function getParentPassthroughCallableEntity(entity: EntityState): PassThroughCallableEntityState | null;
 export declare function getParentCallerEntity(entity: EntityState): CallerEntityState | null;
@@ -59,12 +60,101 @@ export declare function flattenElementCallsOnTheSameScope(element: CallerEntityS
 export declare function flattenVariableWrites(variable: VariableState, seenVariables?: Set<string>): VariableState[];
 export declare function flattenVariableReads(variable: VariableState, seenVariables?: Set<string>): VariableState[];
 export declare function flattenVariables(element: CanvasEntityState, seenVariables?: Set<string>): VariableState[];
-export declare function flattenDerivedCanvasEntities(entity: CanvasEntityState, seenEntities?: Set<string>): CanvasEntityState[];
+export declare function flattenDerivedCanvasEntities(entity: CanvasEntityState, seenEntities?: Set<EntityId>): CanvasEntityState[];
 export declare function flattenCalls(entities: CallableEntityState[]): CallableEntityState[];
 export declare function flattenProjectElements(project: ProjectState): EntityState[];
 export declare function findReferenceToSelfInList(element: EntityState, elements: EntityState[]): EntityState[];
 export declare function findReferencesToSelfInProject(element: EntityState): EntityState[];
+export declare function enrichFromKnownEntities(entity: ElementTransfer | Element | IGenericReference | EntityId, allKnownEntities: Record<EntityId, Element | ElementTransfer>): Element | ElementTransfer | null;
+export declare function getRelatedCanvasElementsOnTheLeftFromTransfer(entity: DraggableElement | DraggableElementTransfer, allKnownEntities: Record<EntityId, Element | ElementTransfer>): (DraggableElement | DraggableElementTransfer)[];
 export declare function getRelatedCanvasElementsOnTheLeft(entity: CanvasEntityState): CanvasEntityState[];
+export declare function getCalledBy(entity: CallableEntityState | CallableEntity | CallableEntityTransfer): (CallerEntityState | CallerEntity | CallerEntityTransfer)[];
+export declare function flattenActionDescriptor(entity: IActionDescriptor | IActionDescriptorTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenArgumentDeclaration(entity: IArgumentDeclaration | IArgumentDeclarationTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenBreakStatement(entity: IBreakStatement | IBreakStatementTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenBuiltInBaseEntity(entity: IBuiltInBaseEntity | IBuiltInBaseEntityTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenCondition(entity: ICondition | IConditionTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenContinueStatement(entity: IContinueStatement | IContinueStatementTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenCustomEntity(entity: ICustomEntity | ICustomEntityTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenDataType(entity: IDataType | IDataTypeTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenFunctionCall(entity: IFunctionCall | IFunctionCallTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenFunctionDeclaration(entity: IFunctionDeclaration | IFunctionDeclarationTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenGlobalEvent(entity: IGlobalEvent | IGlobalEventTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenInputMap(entity: IInputMap | IInputMapTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenInstalledProject(entity: IInstalledProject | IInstalledProjectTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenInternalCall(entity: IInternalCall | IInternalCallTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenLiteralValue(entity: ILiteralValue | ILiteralValueTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenLoop(entity: ILoop | ILoopTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenOperation(entity: IOperation | IOperationTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenOutputMap(entity: IOutputMap | IOutputMapTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenPrimitiveEntity(entity: IPrimitiveEntity | IPrimitiveEntityTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenProject(entity: IProject | IProjectTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenProperty(entity: IProperty | IPropertyTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenReturnDeclaration(entity: IReturnDeclaration | IReturnDeclarationTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenReturnStatement(entity: IReturnStatement | IReturnStatementTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenSearch(entity: ISearch | ISearchTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenValueDescriptor(entity: IValueDescriptor | IValueDescriptorTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenVariableDeclaration(entity: IVariableDeclaration | IVariableDeclarationTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function flattenVariableInstance(entity: IVariableInstance | IVariableInstanceTransfer, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare const ALL_BUILT_IN_ENTITY_IDS: EntityId[];
+export declare function flattenEntity(entity: Element | ElementTransfer | Reference, seenEntities?: Set<EntityId>, options?: {
+    ignoreBuiltInBaseEntities?: boolean;
+}): (Element | ElementTransfer)[];
+export declare function getDependencyIds(element: ElementTransfer, allKnownEntities: Record<EntityId, ElementTransfer>): Set<EntityId>;
 export declare function getEntityArgumentDeclarations(entity: ExecutableEntityState): (ArgumentDeclarationState | ValueDescriptorState)[];
 export declare function getUsedArgFromDeclaration(argumentDeclaration: ArgumentDeclarationState, entity: ConditionState | FunctionCallState | OperationState): InputMapState | null;
 export declare function getEntityInputMaps(entity: DraggablePassThroughCallableEntityState): InputMapState[];
@@ -72,6 +162,7 @@ export declare function getEntityReturnDeclarations(entity: TerminationState | F
 export declare function getUsedReturnFromDeclaration(returnDeclaration: ReturnDeclarationState, entity: ConditionState | FunctionCallState | OperationState): OutputMapState | null;
 export declare function getEntityOutputMaps(entity: DraggablePassThroughCallableEntityState): OutputMapState[];
 export declare function getCanvasEntityDerivedFromValueReadingEntity(valueReadingEntity: ValueReadingEntityState): CanvasEntityState | null;
+export declare function getCanvasEntityDerivedFromValueReadingEntityFromTransfer(valueReadingEntity: ValueReadingEntity | ValueReadingEntityTransfer, allKnownEntities: Record<EntityId, ElementTransfer>): DraggableElement | DraggableElementTransfer | null;
 export declare function getCanvasEntitiesDerivedFromInternalCalls(entity: VariableState): CanvasEntityState[];
 export declare function getCanvasEntitiesDerivedFromWrites(valueWrittingEntity: ValueWritingEntityState): CanvasEntityState[];
 export declare function filterOutDuplicateEntities(entities: (EntityState | Element | ElementTransfer | ElementShallowTransfer | ElementGenerationTarget)[]): (Element | ElementTransfer | ElementShallowTransfer | ElementGenerationTarget | EntityState)[];
@@ -97,7 +188,7 @@ export declare function getHeadIfPartOfDetachedBranch(entity: CanvasEntityState,
 export declare function flattenDetachedBranch(entity: CanvasEntityState): CanvasEntityState[];
 export declare function checkIsMethod(entity: EntityState): boolean;
 export declare function mergeListOfEntities(oldErrors: EntityState[], newErrors: EntityState[]): EntityState[];
-export declare function getPrototypeByType(type: EntityType): typeof InputMapState | typeof OutputMapState | typeof ProjectState | typeof SearchState | typeof ReturnDeclarationState | typeof ConditionState | typeof OperationState | typeof InstalledProjectState | typeof CustomEntityState | typeof PropertyState | typeof FunctionDeclarationState | typeof FunctionCallState | typeof VariableDeclarationState | typeof VariableInstanceState | typeof ArgumentDeclarationState | typeof LoopState | typeof ReturnStatementState | typeof BuiltInBaseEntityState | null;
+export declare function getPrototypeByType(type: EntityType): typeof ProjectState | typeof InputMapState | typeof OutputMapState | typeof SearchState | typeof ReturnDeclarationState | typeof ConditionState | typeof OperationState | typeof InstalledProjectState | typeof CustomEntityState | typeof PropertyState | typeof FunctionDeclarationState | typeof FunctionCallState | typeof VariableDeclarationState | typeof VariableInstanceState | typeof ArgumentDeclarationState | typeof LoopState | typeof ReturnStatementState | typeof BuiltInBaseEntityState | null;
 export declare function getScopeOwner(entity: EntityState | Element | ElementTransfer | ElementGenerationTarget | ElementShallowTransfer, project: ProjectState): EntityWithLogicScopeState | ProjectState | null;
 export declare function getRootEntryPointScopeOwner(entity: EntityState | Element | ElementTransfer | ElementGenerationTarget | ElementShallowTransfer, project: ProjectState): EntityWithLogicScopeState | null;
 export declare function checkIsNestedScope(parent: EntityWithLogicScopeState | ProjectState, child: EntityWithLogicScopeState | ProjectState, project: ProjectState): boolean;
@@ -173,3 +264,4 @@ export declare function getDatabaseEntities(project: ProjectState): CustomEntity
 export declare function resolvePrimaryKeyProperty(entity: CustomEntityState): PropertyState | null;
 export declare function getColumnProperties(entity: CustomEntityState): PropertyState[];
 export declare function getDatabaseEntity(entity: CustomEntityState): CustomEntityState | null;
+export declare function resolveClonedEntityProject(newParent: EntityState | null, self: EntityState): ProjectState;

package/dist/tree/utils/traverser.d.ts

@@ -0,0 +1,17 @@
+import { ElementTransfer, Element, EntityId } from '../../definitions';
+
+export declare enum TraverseStrategy {
+    Hirarchy = "hirarchy",
+    ReverseHirarchy = "reverse-hirarchy"
+}
+export declare class Traverser {
+    private strategy;
+    order: EntityId[];
+    flatRecord: Record<EntityId, Element | ElementTransfer>;
+    constructor(root: Element | ElementTransfer, strategy?: TraverseStrategy);
+    private flatten;
+    private moveEntityAfterDependencies;
+    private orderEntities;
+    private visitEntities;
+    visit(callback: (entity: Element | ElementTransfer) => void): Traverser;
+}

package/dist/tree/utils/traverser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tree/utils/uuid.d.ts

@@ -1,5 +1,7 @@
 import { ElementGenerationTarget, EntityType } from '../../definitions';
+import { EntityState } from '../state';
 import { ProjectState } from '../state/project/project';
 
 export declare function createSemanticId(entityName: string, entityType: EntityType, project: ProjectState): string;
 export declare function suggestNewIdForEntity(generatedEntity: ElementGenerationTarget, projectState: ProjectState): string;
+export declare function generateIdFromStrategy(entity: EntityState, project: ProjectState, strategy?: 'uuid' | 'semantic'): string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@elyx-code/project-logic-tree",
-	"version": "0.0.6113",
+	"version": "0.0.6114",
 	"author": "Sergio Herrero",
 	"license": "UNLICENSED",
 	"description": "An installable module which contains the type definitions and ephemeral state management for a projects' logic tree data structure",