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

package/dist/tree/state/project/project.d.ts

@@ -1,6 +1,6 @@
 import { EntityId, EntityType, EntityVersion, IProject, ICustomEntity, IFunctionDeclaration, IGlobalEvent, Element, IProjectTransfer, IGenericReference, ElementTransfer, Reference, IProjectReference, IFunctionCallTransfer, ICustomEntityTransfer, IFunctionDeclarationTransfer, IInstalledProjectTransfer, IVariableDeclarationTransfer, IProjectShallowTransfer, ElementShallowTransfer, ElementGenerationTarget, IProjectGenerationTarget, IConditionTransfer, IOperationTransfer, ProjectTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseState, UserManagedEntityStateFunctionality } from '../base';
+import { BaseState, IEntityPersistanceOptions, IEditableEntityPersistanceRepository, UserManagedEntityStateFunctionality, IEntityJSONCloneOptions, IEntityRecursionOptions } from '../base';
 import { FunctionDeclarationState } from '../function-declaration';
 import { GlobalEventState } from '../global-event';
 import { CustomEntityState } from '../custom-entity';
@@ -62,9 +62,11 @@ export declare class ProjectState implements IProject, UserManagedEntityStateFun
     };
     errors: EntityError[];
     references: IGenericReference[];
+    initialized: boolean;
     constructor(initialProjectData: IProject | IProjectTransfer);
     static UUID: UUIDModule;
     static injectUUIDModule(module: UUIDModule): void;
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -87,6 +89,8 @@ export declare class ProjectState implements IProject, UserManagedEntityStateFun
         errors: EntityGenerationError[];
         modifiedData: Partial<IProjectGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<ProjectState>;
+    afterAllChildrenInitialized(): IChangeSet<ProjectState>;
     addSelfToProject(): IChangeSet<ProjectState>;
     get instancesList(): EntityState[];
     isOperationDeclaration(entity: ActionDescriptorState): boolean;
@@ -110,10 +114,10 @@ export declare class ProjectState implements IProject, UserManagedEntityStateFun
         x: number;
         y: number;
     }>): ProjectState;
-    load(): Promise<ProjectState>;
-    create(): Promise<ProjectState>;
-    update(_: Partial<ProjectTypesUnion>): Promise<ProjectState>;
-    delete(): Promise<ProjectState>;
+    load(_?: IEntityPersistanceOptions): Promise<ProjectState>;
+    create(_?: IEntityPersistanceOptions): Promise<ProjectState>;
+    update(_?: IEntityPersistanceOptions): Promise<ProjectState>;
+    delete(_?: IEntityPersistanceOptions): Promise<ProjectState>;
     remove({ ignoreUpstream: _ }?: {
         ignoreUpstream: boolean;
     }): {
@@ -128,14 +132,15 @@ export declare class ProjectState implements IProject, UserManagedEntityStateFun
     };
     getAllBuiltInIds(): EntityId[];
     getAllBuiltIn(): EntityState[];
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IProjectTransfer;
-    toReference(): IProjectReference;
-    toShallowJSON(): IProjectShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IProjectTransfer | IProjectReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IProjectTransfer;
+    toReference(options?: IEntityRecursionOptions): IProjectReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IProjectShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IProjectGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): ProjectState;
     validate(): {
         success: boolean;

package/dist/tree/state/project/project.test.d.ts

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

package/dist/tree/state/property/property.d.ts

@@ -1,6 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, IProperty, IPropertyGenerationTarget, IPropertyReference, IPropertyShallowTransfer, IPropertyTransfer, PropertyTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseState, ChildEntityState, EntityWithValueClass, UserManagedEntityStateFunctionality } from '../base';
+import { BaseState, ChildEntityState, EntityWithValueClass, IEntityPersistanceOptions, IEditableEntityPersistanceRepository, UserManagedEntityStateFunctionality, IEntityJSONCloneOptions, IEntityRecursionOptions } from '../base';
 import { DataTypeState } from '../data-type';
 import { ProjectState } from '../project/project';
 import { PrimitiveEntityState } from '../primitive-entity';
@@ -32,6 +32,7 @@ export declare class PropertyState implements IProperty, UserManagedEntityStateF
     initialized: boolean;
     suggestion: boolean;
     constructor(initialPropertyData: IProperty | IPropertyTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -55,16 +56,19 @@ export declare class PropertyState implements IProperty, UserManagedEntityStateF
         errors: EntityGenerationError[];
         modifiedData: Partial<IPropertyGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<PropertyState>;
+    afterAllChildrenInitialized(): IChangeSet<PropertyState>;
     addSelfToProject(): IChangeSet<PropertyState>;
     setParent(parent: CustomEntityState | PrimitiveEntityState | BuiltInBaseEntityState): PropertyState;
+    setImplements(implementsEntity: PropertyState): PropertyState;
     initChildren(): PropertyState;
     subscribe(): PropertyState;
     unsubscribe(): PropertyState;
     sync(data: Partial<IProperty>): PropertyState;
-    load(): Promise<PropertyState>;
-    create(): Promise<PropertyState>;
-    update(_: Partial<PropertyTypesUnion>): Promise<PropertyState>;
-    delete(): Promise<PropertyState>;
+    load(_?: IEntityPersistanceOptions): Promise<PropertyState>;
+    create(_?: IEntityPersistanceOptions): Promise<PropertyState>;
+    update(_?: IEntityPersistanceOptions): Promise<PropertyState>;
+    delete(_?: IEntityPersistanceOptions): Promise<PropertyState>;
     remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -78,14 +82,15 @@ export declare class PropertyState implements IProperty, UserManagedEntityStateF
         affected: EntityState[];
         self: PropertyState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IPropertyTransfer;
-    toReference(): IPropertyReference;
-    toShallowJSON(): IPropertyShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IPropertyTransfer | IPropertyReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IPropertyTransfer | IPropertyReference;
+    toReference(options?: IEntityRecursionOptions): IPropertyReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IPropertyShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IPropertyGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): PropertyState;
     validate(): {
         success: boolean;

package/dist/tree/state/property/validation/validation-schema.d.ts

@@ -40,8 +40,8 @@ export declare function getPropertyBaseSchema(): z.ZodObject<{
     description: string | null;
     required: boolean;
     private: boolean;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }, {
     id: string;
     type: EntityType.Property;
@@ -49,8 +49,8 @@ export declare function getPropertyBaseSchema(): z.ZodObject<{
     description: string | null;
     required: boolean;
     private: boolean;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }>;
 export declare function getPropertyMetaSchema(): z.ZodObject<z.objectUtil.extendShape<{
     id: z.ZodString;
@@ -72,9 +72,9 @@ export declare function getPropertyMetaSchema(): z.ZodObject<z.objectUtil.extend
     required: boolean;
     private: boolean;
     version: number;
-    index: number;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
+    index: number;
 }, {
     id: string;
     type: EntityType.Property;
@@ -83,9 +83,9 @@ export declare function getPropertyMetaSchema(): z.ZodObject<z.objectUtil.extend
     required: boolean;
     private: boolean;
     version: number;
-    index: number;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
+    index: number;
 }>;
 export declare function getPropertyGenerationTargetSchema(): z.ZodObject<z.objectUtil.extendShape<{
     id: z.ZodString;
@@ -103,8 +103,8 @@ export declare function getPropertyGenerationTargetSchema(): z.ZodObject<z.objec
     description: string | null;
     required: boolean;
     private: boolean;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }, {
     id: string;
     type: EntityType.Property;
@@ -112,8 +112,8 @@ export declare function getPropertyGenerationTargetSchema(): z.ZodObject<z.objec
     description: string | null;
     required: boolean;
     private: boolean;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }>;
 export declare function getPropertyNestedEntitiesSchema(): z.ZodObject<{
     dataType: z.ZodUnion<[z.ZodObject<{
@@ -323,12 +323,12 @@ export declare function getPropertySchema(): z.ZodObject<z.objectUtil.extendShap
         entityId: string;
     };
     version: number;
+    static: boolean;
+    abstract: boolean;
     dataType: Record<string, any> | {
         type: EntityType.DataType;
     };
     index: number;
-    abstract: boolean;
-    static: boolean;
 }, {
     id: string;
     type: EntityType.Property;
@@ -356,10 +356,10 @@ export declare function getPropertySchema(): z.ZodObject<z.objectUtil.extendShap
         entityId: string;
     };
     version: number;
+    static: boolean;
+    abstract: boolean;
     dataType: Record<string, any> | {
         type: EntityType.DataType;
     };
     index: number;
-    abstract: boolean;
-    static: boolean;
 }>;

package/dist/tree/state/return-declaration/return-declaration.d.ts

@@ -1,6 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, IReturnDeclaration, IReturnDeclarationGenerationTarget, IReturnDeclarationReference, IReturnDeclarationShallowTransfer, IReturnDeclarationTransfer, ReturnDeclarationTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseState, ChildEntityState, EntityWithValueClass, UserManagedEntityStateFunctionality, ValueReadingEntityClass } from '../base';
+import { BaseState, ChildEntityState, EntityWithValueClass, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, UserManagedEntityStateFunctionality, ValueReadingEntityClass } from '../base';
 import { DataTypeState } from '../data-type';
 import { EntityState, IChangeSet, ValueWritingEntityState } from '../types';
 import { ProjectState } from '../project/project';
@@ -31,6 +31,7 @@ export declare class ReturnDeclarationState implements IReturnDeclaration, UserM
     initialized: boolean;
     suggestion: boolean;
     constructor(initialReturnVariableMapData: IReturnDeclaration | IReturnDeclarationTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -53,6 +54,8 @@ export declare class ReturnDeclarationState implements IReturnDeclaration, UserM
         errors: EntityGenerationError[];
         modifiedData: Partial<IReturnDeclarationGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<ReturnDeclarationState>;
+    afterAllChildrenInitialized(): IChangeSet<ReturnDeclarationState>;
     addSelfToProject(): IChangeSet<ReturnDeclarationState>;
     setParent(parent: ReturnStatementState | BreakStatementState | ContinueStatementState): ReturnDeclarationState;
     setImplements(implementsEntity: ValueDescriptorState): ReturnDeclarationState;
@@ -62,10 +65,10 @@ export declare class ReturnDeclarationState implements IReturnDeclaration, UserM
     subscribe(): ReturnDeclarationState;
     unsubscribe(): ReturnDeclarationState;
     sync(data: Partial<IReturnDeclaration>): ReturnDeclarationState;
-    load(): Promise<ReturnDeclarationState>;
-    create(): Promise<ReturnDeclarationState>;
-    update(data: Partial<ReturnDeclarationTypesUnion>): Promise<ReturnDeclarationState>;
-    delete(): Promise<ReturnDeclarationState>;
+    load(_?: IEntityPersistanceOptions): Promise<ReturnDeclarationState>;
+    create(_?: IEntityPersistanceOptions): Promise<ReturnDeclarationState>;
+    update(_?: IEntityPersistanceOptions): Promise<ReturnDeclarationState>;
+    delete(_?: IEntityPersistanceOptions): Promise<ReturnDeclarationState>;
     remove({ ignoreUpstream: _, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -79,14 +82,15 @@ export declare class ReturnDeclarationState implements IReturnDeclaration, UserM
         affected: EntityState[];
         self: EntityState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IReturnDeclarationTransfer;
-    toReference(): IReturnDeclarationReference;
-    toShallowJSON(): IReturnDeclarationShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IReturnDeclarationTransfer | IReturnDeclarationReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IReturnDeclarationTransfer | IReturnDeclarationReference;
+    toReference(options?: IEntityRecursionOptions): IReturnDeclarationReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IReturnDeclarationShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IReturnDeclarationGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): ReturnDeclarationState;
     validate(): {
         success: boolean;

package/dist/tree/state/return-statement/return-statement.d.ts

@@ -1,7 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, IReturnStatement, IReturnStatementGenerationTarget, IReturnStatementReference, IReturnStatementShallowTransfer, IReturnStatementTransfer, ReturnStatementTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseCanvasDraggableState, BaseState, CallableEntityClass, ChildEntityState, UserManagedEntityStateFunctionality } from '../base';
-import { FunctionDeclarationState } from '../function-declaration';
+import { BaseCanvasDraggableState, BaseState, CallableEntityClass, ChildEntityState, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, UserManagedEntityStateFunctionality } from '../base';
 import { ReturnDeclarationState } from '../return-declaration';
 import { CallerEntityState, EntityState, EntityWithLogicScopeState, EntryPointEntityState, IChangeSet, PassThroughCallableEntityState } from '../types';
 import { ProjectState } from '../project/project';
@@ -25,6 +24,7 @@ export declare class ReturnStatementState implements IReturnStatement, UserManag
     initialized: boolean;
     suggestion: boolean;
     constructor(initialReturnStatementData: IReturnStatement | IReturnStatementTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -47,6 +47,8 @@ export declare class ReturnStatementState implements IReturnStatement, UserManag
         errors: EntityGenerationError[];
         modifiedData: Partial<IReturnStatementGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<ReturnStatementState>;
+    afterAllChildrenInitialized(): IChangeSet<ReturnStatementState>;
     addSelfToProject(): IChangeSet<ReturnStatementState>;
     get calledBy(): CallerEntityState[];
     addSuccessCaller(caller: PassThroughCallableEntityState): ReturnStatementState;
@@ -60,10 +62,10 @@ export declare class ReturnStatementState implements IReturnStatement, UserManag
     subscribe(): ReturnStatementState;
     unsubscribe(): ReturnStatementState;
     sync(data: Partial<IReturnStatement>): ReturnStatementState;
-    load(): Promise<ReturnStatementState>;
-    create(): Promise<ReturnStatementState>;
-    update(_: Partial<ReturnStatementTypesUnion>): Promise<ReturnStatementState>;
-    delete(): Promise<ReturnStatementState>;
+    load(_?: IEntityPersistanceOptions): Promise<ReturnStatementState>;
+    create(_?: IEntityPersistanceOptions): Promise<ReturnStatementState>;
+    update(_?: IEntityPersistanceOptions): Promise<ReturnStatementState>;
+    delete(_?: IEntityPersistanceOptions): Promise<ReturnStatementState>;
     remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -77,14 +79,15 @@ export declare class ReturnStatementState implements IReturnStatement, UserManag
         affected: EntityState[];
         self: EntityState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IReturnStatementTransfer;
-    toReference(): IReturnStatementReference;
-    toShallowJSON(): IReturnStatementShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IReturnStatementTransfer | IReturnStatementReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IReturnStatementTransfer | IReturnStatementReference;
+    toReference(options?: IEntityRecursionOptions): IReturnStatementReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IReturnStatementShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IReturnStatementGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): ReturnStatementState;
     validate(): {
         success: boolean;
@@ -93,6 +96,6 @@ export declare class ReturnStatementState implements IReturnStatement, UserManag
     };
     getErrors(): EntityError[];
     getShallowErrors(): EntityError[];
-    clone(_?: FunctionDeclarationState): ReturnStatementState;
+    clone(parent?: EntityWithLogicScopeState | null, newId?: string | null, subscribe?: boolean): ReturnStatementState;
 }
 export type ReturnStatementPayloadUnion = ReturnStatementState | ReturnStatementTypesUnion;

package/dist/tree/state/search/search.d.ts

@@ -1,6 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, ISearch, ISearchGenerationTarget, ISearchReference, ISearchShallowTransfer, ISearchTransfer, SearchTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseCanvasDraggableState, BaseState, CallableEntityClass, ChildEntityState, PassThroughCallableEntityClass, UserManagedEntityStateFunctionality } from '../base';
+import { BaseCanvasDraggableState, BaseState, CallableEntityClass, ChildEntityState, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, PassThroughCallableEntityClass, UserManagedEntityStateFunctionality } from '../base';
 import { CallableEntityState, CallerEntityState, EntityState, EntityWithLogicScopeState, EntryPointEntityState, IChangeSet, PassThroughCallableEntityState } from '../types';
 import { ActionInputMapState } from '../input-map';
 import { ActionOutputMapState } from '../output-map';
@@ -33,6 +33,7 @@ export declare class SearchState implements ISearch, BaseState, UserManagedEntit
     project: ProjectState;
     initialized: boolean;
     constructor(initialFunctionCallData: ISearch | ISearchTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -56,6 +57,8 @@ export declare class SearchState implements ISearch, BaseState, UserManagedEntit
         errors: EntityGenerationError[];
         modifiedData: Partial<ISearchGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<SearchState>;
+    afterAllChildrenInitialized(): IChangeSet<SearchState>;
     addSelfToProject(): IChangeSet<SearchState>;
     get calledBy(): CallerEntityState[];
     removeInput(input: ActionInputMapState): SearchState;
@@ -78,10 +81,10 @@ export declare class SearchState implements ISearch, BaseState, UserManagedEntit
     subscribe(): SearchState;
     unsubscribe(): SearchState;
     sync(data: Partial<ISearch>): SearchState;
-    load(): Promise<SearchState>;
-    create(): Promise<SearchState>;
-    update(_: Partial<SearchTypesUnion>): Promise<SearchState>;
-    delete(): Promise<SearchState>;
+    load(_?: IEntityPersistanceOptions): Promise<SearchState>;
+    create(_?: IEntityPersistanceOptions): Promise<SearchState>;
+    update(_?: IEntityPersistanceOptions): Promise<SearchState>;
+    delete(_?: IEntityPersistanceOptions): Promise<SearchState>;
     remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -95,14 +98,15 @@ export declare class SearchState implements ISearch, BaseState, UserManagedEntit
         affected: EntityState[];
         self: EntityState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): ISearchTransfer;
-    toReference(): ISearchReference;
-    toShallowJSON(): ISearchShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): ISearchTransfer | ISearchReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): ISearchTransfer | ISearchReference;
+    toReference(options?: IEntityRecursionOptions): ISearchReference;
+    toShallowJSON(options?: IEntityRecursionOptions): ISearchShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): ISearchGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): SearchState;
     validate(): {
         success: boolean;
@@ -111,7 +115,7 @@ export declare class SearchState implements ISearch, BaseState, UserManagedEntit
     };
     getErrors(): EntityError[];
     getShallowErrors(): EntityError[];
-    clone(_?: EntryPointEntityState): SearchState;
+    clone(parent?: EntryPointEntityState | ProjectState | null, newId?: string | null, subscribe?: boolean): SearchState;
     syncInputMaps(): IChangeSet<SearchState>;
 }
 export type SearchPayloadUnion = SearchState | SearchTypesUnion;

package/dist/tree/state/store.d.ts

@@ -7,6 +7,7 @@ export declare const CACHED_PROJECTS_BY_ID: {
 export interface IGetProjectOptions {
     empty?: boolean;
 }
+export declare function initBaseProjectEntity(data: IProjectTransfer): ProjectState;
 export declare function initProject(data: IProjectTransfer): ProjectState;
 export declare function getProject(where: {
     id: string;

package/dist/tree/state/value-descriptor/value-descriptor.d.ts

@@ -1,6 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, ValueDescriptorParentChildRelation, IValueDescriptor, IValueDescriptorGenerationTarget, IValueDescriptorReference, IValueDescriptorShallowTransfer, IValueDescriptorTransfer, ValueDescriptorTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseState, ChildEntityState, UserManagedEntityStateFunctionality } from '../base';
+import { BaseState, ChildEntityState, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, UserManagedEntityStateFunctionality } from '../base';
 import { DataTypeState } from '../data-type';
 import { ProjectState } from '../project/project';
 import { ActionDescriptorState } from '../action-descriptor';
@@ -27,6 +27,7 @@ export declare class ValueDescriptorState implements IValueDescriptor, UserManag
     parent: ActionDescriptorState | LoopState | SearchState | null;
     initialized: boolean;
     constructor(initialVariableDeclarationData: IValueDescriptor | IValueDescriptorTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -49,17 +50,19 @@ export declare class ValueDescriptorState implements IValueDescriptor, UserManag
         errors: EntityGenerationError[];
         modifiedData: Partial<IValueDescriptorGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<ValueDescriptorState>;
+    afterAllChildrenInitialized(): IChangeSet<ValueDescriptorState>;
     addSelfToProject(): IChangeSet<ValueDescriptorState>;
     setParent(parent: ActionDescriptorState | LoopState | SearchState): ValueDescriptorState;
     initChildren(): ValueDescriptorState;
     subscribe(): ValueDescriptorState;
     unsubscribe(): ValueDescriptorState;
     sync(data: Partial<IValueDescriptor>): ValueDescriptorState;
-    load(): Promise<ValueDescriptorState>;
-    create(): Promise<ValueDescriptorState>;
-    update(_: Partial<ValueDescriptorTypesUnion>): Promise<ValueDescriptorState>;
-    delete(): Promise<ValueDescriptorState>;
-    remove({ ignoreUpstream: _, seenEntities, }?: {
+    load(_?: IEntityPersistanceOptions): Promise<ValueDescriptorState>;
+    create(_?: IEntityPersistanceOptions): Promise<ValueDescriptorState>;
+    update(_?: IEntityPersistanceOptions): Promise<ValueDescriptorState>;
+    delete(_?: IEntityPersistanceOptions): Promise<ValueDescriptorState>;
+    remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
     }): {
@@ -72,14 +75,15 @@ export declare class ValueDescriptorState implements IValueDescriptor, UserManag
         affected: EntityState[];
         self: EntityState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IValueDescriptorTransfer;
-    toReference(): IValueDescriptorReference;
-    toShallowJSON(): IValueDescriptorShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IValueDescriptorTransfer | IValueDescriptorReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IValueDescriptorTransfer | IValueDescriptorReference;
+    toReference(options?: IEntityRecursionOptions): IValueDescriptorReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IValueDescriptorShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IValueDescriptorGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): ValueDescriptorState;
     validate(): {
         success: boolean;

package/dist/tree/state/variable-declaration/validation/validation-schema.d.ts

@@ -2264,11 +2264,11 @@ export declare function getVariableDeclarationSchema(): z.ZodObject<z.objectUtil
         entityId: string;
     };
     version: number;
+    x: number;
+    y: number;
     dataType: Record<string, any> | {
         type: EntityType.DataType;
     } | null;
-    x: number;
-    y: number;
     inputs: (Record<string, any> | {
         type: EntityType.InputMap;
     })[];
@@ -2534,11 +2534,11 @@ export declare function getVariableDeclarationSchema(): z.ZodObject<z.objectUtil
         entityId: string;
     };
     version: number;
+    x: number;
+    y: number;
     dataType: Record<string, any> | {
         type: EntityType.DataType;
     } | null;
-    x: number;
-    y: number;
     inputs: (Record<string, any> | {
         type: EntityType.InputMap;
     })[];

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

@@ -1,6 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, IVariableDeclaration, IVariableDeclarationGenerationTarget, IVariableDeclarationReference, IVariableDeclarationShallowTransfer, IVariableDeclarationTransfer, IVariableInstanceTransfer, VariableDeclarationTypesUnion } 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 { DataTypeState } from '../data-type';
 import { CallableEntityState, CallerEntityState, EntityState, EntityWithLogicScopeState, EntryPointEntityState, IChangeSet, PassThroughCallableEntityState, ValueReadingEntityState, ValueWritingEntityState } from '../types';
 import { ProjectState } from '../project/project';
@@ -39,6 +39,7 @@ export declare class VariableDeclarationState implements IVariableDeclaration, B
     initialized: boolean;
     suggestion: boolean;
     constructor(initialVariableDeclarationData: IVariableDeclaration | IVariableDeclarationTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -61,6 +62,8 @@ export declare class VariableDeclarationState implements IVariableDeclaration, B
         errors: EntityGenerationError[];
         modifiedData: Partial<IVariableDeclarationGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<VariableDeclarationState>;
+    afterAllChildrenInitialized(): IChangeSet<VariableDeclarationState>;
     addSelfToProject(): IChangeSet<VariableDeclarationState>;
     get calledBy(): CallerEntityState[];
     get usedInputs(): VariableInputMapState[];
@@ -93,10 +96,10 @@ export declare class VariableDeclarationState implements IVariableDeclaration, B
     getMasterInputWithValueWritterFromAllInstances(input: VariableInputMapState): VariableInputMapState;
     inferDataTypeAndSyncInstancesInputsAndOutputs(): VariableDeclarationState;
     sync(data: Partial<IVariableDeclaration>): VariableDeclarationState;
-    load(): Promise<VariableDeclarationState>;
-    create(): Promise<VariableDeclarationState>;
-    update(data: Partial<VariableDeclarationTypesUnion>): Promise<VariableDeclarationState>;
-    delete(): Promise<VariableDeclarationState>;
+    load(_?: IEntityPersistanceOptions): Promise<VariableDeclarationState>;
+    create(_?: IEntityPersistanceOptions): Promise<VariableDeclarationState>;
+    update(_?: IEntityPersistanceOptions): Promise<VariableDeclarationState>;
+    delete(_?: IEntityPersistanceOptions): Promise<VariableDeclarationState>;
     remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -110,14 +113,15 @@ export declare class VariableDeclarationState implements IVariableDeclaration, B
         affected: EntityState[];
         self: VariableDeclarationState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IVariableDeclarationTransfer;
-    toReference(): IVariableDeclarationReference;
-    toShallowJSON(): IVariableDeclarationShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IVariableDeclarationTransfer | IVariableDeclarationReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IVariableDeclarationTransfer | IVariableDeclarationReference;
+    toReference(options?: IEntityRecursionOptions): IVariableDeclarationReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IVariableDeclarationShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IVariableDeclarationGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): VariableDeclarationState;
     validate(): {
         success: boolean;
@@ -128,7 +132,7 @@ export declare class VariableDeclarationState implements IVariableDeclaration, B
     getShallowErrors(): EntityError[];
     getDefaultValue(): LiteralValueState | null;
     setDefaultValue(defaultValue: LiteralValueState): VariableDeclarationState;
-    clone(_?: EntryPointEntityState): VariableDeclarationState;
+    clone(parent?: EntryPointEntityState | ProjectState | null, newId?: string | null, subscribe?: boolean): VariableDeclarationState;
     addInternalCall(internalCall: InternalCallState): VariableDeclarationState;
     createInstance(parent?: EntityWithLogicScopeState | ProjectState, overrides?: Partial<IVariableInstanceTransfer>): VariableInstanceState;
     generateUnusedInputs(): VariableInputMapState[];

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

@@ -2265,11 +2265,11 @@ export declare function getVariableInstanceSchema(): z.ZodObject<z.objectUtil.ex
         entityId: string;
     };
     version: number;
+    x: number;
+    y: number;
     dataType: Record<string, any> | {
         type: EntityType.DataType;
     } | null;
-    x: number;
-    y: number;
     inputs: (Record<string, any> | {
         type: EntityType.InputMap;
     })[];
@@ -2536,11 +2536,11 @@ export declare function getVariableInstanceSchema(): z.ZodObject<z.objectUtil.ex
         entityId: string;
     };
     version: number;
+    x: number;
+    y: number;
     dataType: Record<string, any> | {
         type: EntityType.DataType;
     } | null;
-    x: number;
-    y: number;
     inputs: (Record<string, any> | {
         type: EntityType.InputMap;
     })[];