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

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

@@ -1,6 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, IInstalledProject, IInstalledProjectGenerationTarget, IInstalledProjectReference, IInstalledProjectShallowTransfer, IInstalledProjectTransfer, IProjectReference, InstalledProjectTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseCanvasDraggableState, BaseState, ChildEntityState, UserManagedEntityStateFunctionality } from '../base';
+import { BaseCanvasDraggableState, BaseState, ChildEntityState, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, UserManagedEntityStateFunctionality } from '../base';
 import { FunctionDeclarationState } from '../function-declaration';
 import { GlobalEventState } from '../global-event';
 import { ProjectState } from '../project/project';
@@ -24,6 +24,7 @@ export declare class InstalledProjectState implements IInstalledProject, UserMan
     project: ProjectState;
     initialized: boolean;
     constructor(initialInstalledProjectData: IInstalledProject | IInstalledProjectTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -46,16 +47,18 @@ export declare class InstalledProjectState implements IInstalledProject, UserMan
         errors: EntityGenerationError[];
         modifiedData: Partial<IInstalledProjectGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<InstalledProjectState>;
+    afterAllChildrenInitialized(): IChangeSet<InstalledProjectState>;
     addSelfToProject(): IChangeSet<InstalledProjectState>;
     setParent(parent: ProjectState): InstalledProjectState;
     initChildren(): InstalledProjectState;
     subscribe(): InstalledProjectState;
     unsubscribe(): InstalledProjectState;
     sync(data: Partial<IInstalledProject>): InstalledProjectState;
-    load(): Promise<InstalledProjectState>;
-    create(): Promise<InstalledProjectState>;
-    update(_: Partial<InstalledProjectTypesUnion>): Promise<InstalledProjectState>;
-    delete(): Promise<InstalledProjectState>;
+    load(_?: IEntityPersistanceOptions): Promise<InstalledProjectState>;
+    create(_?: IEntityPersistanceOptions): Promise<InstalledProjectState>;
+    update(_?: IEntityPersistanceOptions): Promise<InstalledProjectState>;
+    delete(_?: IEntityPersistanceOptions): Promise<InstalledProjectState>;
     remove({ ignoreUpstream: _, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -69,14 +72,15 @@ export declare class InstalledProjectState implements IInstalledProject, UserMan
         affected: EntityState[];
         self: InstalledProjectState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IInstalledProjectTransfer;
-    toReference(): IInstalledProjectReference;
-    toShallowJSON(): IInstalledProjectShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IInstalledProjectTransfer | IInstalledProjectReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IInstalledProjectTransfer | IInstalledProjectReference;
+    toReference(options?: IEntityRecursionOptions): IInstalledProjectReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IInstalledProjectShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IInstalledProjectGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): InstalledProjectState;
     validate(): {
         success: boolean;
@@ -85,6 +89,6 @@ export declare class InstalledProjectState implements IInstalledProject, UserMan
     };
     getErrors(): EntityError[];
     getShallowErrors(): EntityError[];
-    clone(): InstalledProjectState;
+    clone(parent?: ProjectState | null, newId?: string | null, subscribe?: boolean): InstalledProjectState;
 }
 export type InstalledProjectPayloadUnion = InstalledProjectState | InstalledProjectTypesUnion;

package/dist/tree/state/internal-call/internal-call.d.ts

@@ -1,6 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, IInternalCall, IInternalCallGenerationTarget, IInternalCallReference, IInternalCallShallowTransfer, IInternalCallTransfer, InternalCallTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseState, CallableEntityClass, ChildEntityState, PassThroughCallableEntityClass, UserManagedEntityStateFunctionality } from '../base';
+import { BaseState, CallableEntityClass, ChildEntityState, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, PassThroughCallableEntityClass, UserManagedEntityStateFunctionality } from '../base';
 import { ActionInputMapState } from '../input-map';
 import { ActionOutputMapState } from '../output-map';
 import { CallableEntityState, CallerEntityState, EntityState, EntryPointEntityState, IChangeSet, PassThroughCallableEntityState, ValueReadingEntityState, VariableState } from '../types';
@@ -30,6 +30,7 @@ export declare class InternalCallState implements IInternalCall, UserManagedEnti
     initialized: boolean;
     suggestion: boolean;
     constructor(initialOperationData: IInternalCall | IInternalCallTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -52,6 +53,8 @@ export declare class InternalCallState implements IInternalCall, UserManagedEnti
         errors: EntityGenerationError[];
         modifiedData: Partial<IInternalCallGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<InternalCallState>;
+    afterAllChildrenInitialized(): IChangeSet<InternalCallState>;
     addSelfToProject(): IChangeSet<InternalCallState>;
     get calledBy(): CallerEntityState[];
     removeInput(input: ActionInputMapState): InternalCallState;
@@ -68,14 +71,15 @@ export declare class InternalCallState implements IInternalCall, UserManagedEnti
     removeCall(call: CallableEntityState): InternalCallState;
     removeCaller(caller: CallerEntityState): InternalCallState;
     setParent(parent: VariableState): InternalCallState;
+    setDeclaration(declaration: FunctionDeclarationState): InternalCallState;
     initChildren(): InternalCallState;
     subscribe(): InternalCallState;
     unsubscribe(): InternalCallState;
     sync(data: Partial<IInternalCall>): InternalCallState;
-    load(): Promise<InternalCallState>;
-    create(): Promise<InternalCallState>;
-    update(_: Partial<InternalCallTypesUnion>): Promise<InternalCallState>;
-    delete(): Promise<InternalCallState>;
+    load(_?: IEntityPersistanceOptions): Promise<InternalCallState>;
+    create(_?: IEntityPersistanceOptions): Promise<InternalCallState>;
+    update(_?: IEntityPersistanceOptions): Promise<InternalCallState>;
+    delete(_?: IEntityPersistanceOptions): Promise<InternalCallState>;
     remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -89,14 +93,15 @@ export declare class InternalCallState implements IInternalCall, UserManagedEnti
         affected: EntityState[];
         self: InternalCallState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IInternalCallTransfer;
-    toReference(): IInternalCallReference;
-    toShallowJSON(): IInternalCallShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IInternalCallTransfer | IInternalCallReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IInternalCallTransfer | IInternalCallReference;
+    toReference(options?: IEntityRecursionOptions): IInternalCallReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IInternalCallShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IInternalCallGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): InternalCallState;
     validate(): {
         success: boolean;
@@ -105,6 +110,10 @@ export declare class InternalCallState implements IInternalCall, UserManagedEnti
     };
     getErrors(): EntityError[];
     getShallowErrors(): EntityError[];
-    clone(_?: EntryPointEntityState): InternalCallState;
+    clone(parent?: VariableState | null, newId?: string | null, subscribe?: boolean): InternalCallState;
+    removeUnrecognizedInputs(): IChangeSet<InternalCallState>;
+    removeUnrecognizedOutputs(): IChangeSet<InternalCallState>;
+    syncMissingFixedInputs(): IChangeSet<InternalCallState>;
+    syncMissingFixedOutputs(): IChangeSet<InternalCallState>;
 }
 export type InternalCallPayloadUnion = InternalCallState | InternalCallTypesUnion;

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

@@ -4,7 +4,7 @@ import { CustomEntityState } from '../custom-entity';
 import { DataTypeState } from '../data-type';
 import { InputMapState } from '../input-map';
 import { ZodError } from 'zod';
-import { BaseState, ChildEntityState, UserManagedEntityStateFunctionality } from '../base';
+import { BaseState, ChildEntityState, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, UserManagedEntityStateFunctionality } from '../base';
 import { FunctionDeclarationState } from '../function-declaration';
 import { EntityError, EntityGenerationError } from '../error';
 import { OperationState } from '../operation';
@@ -34,6 +34,7 @@ export declare class LiteralValueState implements BaseState, UserManagedEntitySt
     initialized: boolean;
     standalone: boolean;
     constructor(initialEntityData: ILiteralValue | ILiteralValueTransfer, 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 LiteralValueState implements BaseState, UserManagedEntitySt
         errors: EntityGenerationError[];
         modifiedData: Partial<ILiteralValueGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<LiteralValueState>;
+    afterAllChildrenInitialized(): IChangeSet<LiteralValueState>;
     addSelfToProject(): IChangeSet<LiteralValueState>;
     setParent(parent: DataTypeState | InputMapState | PropertyState | ArgumentDeclarationState | ReturnDeclarationState | VariableDeclarationState | VariableInstanceState | ValueDescriptorState | OutputMapState): LiteralValueState;
     setStandaloneParent(parent: EntityWithValueState): LiteralValueState;
@@ -64,10 +67,10 @@ export declare class LiteralValueState implements BaseState, UserManagedEntitySt
     subscribe(): LiteralValueState;
     unsubscribe(): LiteralValueState;
     sync(data: Partial<ILiteralValue>): LiteralValueState;
-    load(): Promise<LiteralValueState>;
-    create(): Promise<LiteralValueState>;
-    update(_: Partial<LiteralValueTypesUnion>): Promise<LiteralValueState>;
-    delete(): Promise<LiteralValueState>;
+    load(_?: IEntityPersistanceOptions): Promise<LiteralValueState>;
+    create(_?: IEntityPersistanceOptions): Promise<LiteralValueState>;
+    update(_?: IEntityPersistanceOptions): Promise<LiteralValueState>;
+    delete(_?: IEntityPersistanceOptions): Promise<LiteralValueState>;
     remove({ ignoreUpstream: _, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -81,14 +84,15 @@ export declare class LiteralValueState implements BaseState, UserManagedEntitySt
         affected: EntityState[];
         self: LiteralValueState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): ILiteralValueTransfer;
-    toReference(): ILiteralValueReference;
-    toShallowJSON(): ILiteralValueShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): ILiteralValueTransfer | ILiteralValueReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): ILiteralValueTransfer | ILiteralValueReference;
+    toReference(options?: IEntityRecursionOptions): ILiteralValueReference;
+    toShallowJSON(options?: IEntityRecursionOptions): ILiteralValueShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): ILiteralValueGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): LiteralValueState;
     validate(): {
         success: boolean;

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

@@ -1,6 +1,6 @@
 import { ZodError } from 'zod';
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, ILoop, ILoopGenerationTarget, ILoopReference, ILoopShallowTransfer, ILoopTransfer, LoopTypesUnion } from '../../../definitions';
-import { BaseCanvasDraggableState, BaseState, CallableEntityClass, ChildEntityState, EntityWithLogicScopeClass, PassThroughCallableEntityClass, UserManagedEntityStateFunctionality } from '../base';
+import { BaseCanvasDraggableState, BaseState, CallableEntityClass, ChildEntityState, EntityWithLogicScopeClass, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, PassThroughCallableEntityClass, UserManagedEntityStateFunctionality } from '../base';
 import { ActionInputMapState } from '../input-map';
 import { ActionOutputMapState } from '../output-map';
 import { CallableEntityState, CallerEntityState, CanvasEntityState, EntityState, EntityWithLogicScopeState, EntryPointEntityState, IChangeSet, PassThroughCallableEntityState } from '../types';
@@ -45,6 +45,7 @@ export declare class LoopState implements ILoop, BaseState, UserManagedEntitySta
     project: ProjectState;
     initialized: boolean;
     constructor(initialOperationData: ILoop | ILoopTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static CURRENT_ITERATION_NUMBER_ARG_NAME: string;
     static CURRENT_VALUE_ARG_NAME: string;
     static MUTABLE_BASE_PROPERTIES: string[];
@@ -75,6 +76,8 @@ export declare class LoopState implements ILoop, BaseState, UserManagedEntitySta
         errors: EntityGenerationError[];
         modifiedData: Partial<ILoopGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<LoopState>;
+    afterAllChildrenInitialized(): IChangeSet<LoopState>;
     addSelfToProject(): IChangeSet<LoopState>;
     get calledBy(): CallerEntityState[];
     removeInput(input: ActionInputMapState): LoopState;
@@ -94,14 +97,15 @@ export declare class LoopState implements ILoop, BaseState, UserManagedEntitySta
     replaceDetachedChild(existingChild: CanvasEntityState, newChild: CanvasEntityState): LoopState;
     subscribeDetachedChild(child: CanvasEntityState): LoopState;
     setParent(parent: EntityWithLogicScopeState | ProjectState): LoopState;
+    setDeclaration(declaration: ActionDescriptorState): LoopState;
     initChildren(): LoopState;
     subscribe(): LoopState;
     unsubscribe(): LoopState;
     sync(data: Partial<ILoop>): LoopState;
-    load(): Promise<LoopState>;
-    create(): Promise<LoopState>;
-    update(_: Partial<LoopTypesUnion>): Promise<LoopState>;
-    delete(): Promise<LoopState>;
+    load(_?: IEntityPersistanceOptions): Promise<LoopState>;
+    create(_?: IEntityPersistanceOptions): Promise<LoopState>;
+    update(_?: IEntityPersistanceOptions): Promise<LoopState>;
+    delete(_?: IEntityPersistanceOptions): Promise<LoopState>;
     remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -115,14 +119,15 @@ export declare class LoopState implements ILoop, BaseState, UserManagedEntitySta
         affected: EntityState[];
         self: LoopState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): ILoopTransfer;
-    toReference(): ILoopReference;
-    toShallowJSON(): ILoopShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): ILoopTransfer | ILoopReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): ILoopTransfer | ILoopReference;
+    toReference(options?: IEntityRecursionOptions): ILoopReference;
+    toShallowJSON(options?: IEntityRecursionOptions): ILoopShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): ILoopGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): LoopState;
     validate(): {
         success: boolean;
@@ -131,7 +136,7 @@ export declare class LoopState implements ILoop, BaseState, UserManagedEntitySta
     };
     getErrors(): EntityError[];
     getShallowErrors(): EntityError[];
-    clone(_?: EntryPointEntityState): LoopState;
+    clone(parent?: EntryPointEntityState | ProjectState | null, newId?: string | null, subscribe?: boolean): LoopState;
     getVariableInstances(): VariableInstanceState[];
     addReturnStatement(statement: ReturnStatementState): LoopState;
     removeReturnStatement(statement: ReturnStatementState): LoopState;

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

@@ -1,6 +1,6 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, IOperation, IOperationGenerationTarget, IOperationReference, IOperationShallowTransfer, IOperationTransfer, OperationTypesUnion } 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 { ActionDescriptorState } from '../action-descriptor/action-descriptor';
 import { ActionInputMapState } from '../input-map';
 import { ActionOutputMapState } from '../output-map';
@@ -30,6 +30,7 @@ export declare class OperationState implements IOperation, BaseState, UserManage
     project: ProjectState;
     initialized: boolean;
     constructor(initialOperationData: IOperation | IOperationTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -52,6 +53,8 @@ export declare class OperationState implements IOperation, BaseState, UserManage
         errors: EntityGenerationError[];
         modifiedData: Partial<IOperationGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<OperationState>;
+    afterAllChildrenInitialized(): IChangeSet<OperationState>;
     addSelfToProject(): IChangeSet<OperationState>;
     get calledBy(): CallerEntityState[];
     removeInput(input: ActionInputMapState): OperationState;
@@ -68,14 +71,15 @@ export declare class OperationState implements IOperation, BaseState, UserManage
     removeCall(call: CallableEntityState): OperationState;
     removeCaller(caller: CallerEntityState): OperationState;
     setParent(parent: EntityWithLogicScopeState | ProjectState): OperationState;
+    setDeclaration(declaration: ActionDescriptorState): OperationState;
     initChildren(): OperationState;
     subscribe(): OperationState;
     unsubscribe(): OperationState;
     sync(data: Partial<IOperation>): OperationState;
-    load(): Promise<OperationState>;
-    create(): Promise<OperationState>;
-    update(_: Partial<OperationTypesUnion>): Promise<OperationState>;
-    delete(): Promise<OperationState>;
+    load(_?: IEntityPersistanceOptions): Promise<OperationState>;
+    create(_?: IEntityPersistanceOptions): Promise<OperationState>;
+    update(_?: IEntityPersistanceOptions): Promise<OperationState>;
+    delete(_?: IEntityPersistanceOptions): Promise<OperationState>;
     remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -89,14 +93,15 @@ export declare class OperationState implements IOperation, BaseState, UserManage
         affected: EntityState[];
         self: EntityState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IOperationTransfer;
-    toReference(): IOperationReference;
-    toShallowJSON(): IOperationShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IOperationTransfer | IOperationReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IOperationTransfer | IOperationReference;
+    toReference(options?: IEntityRecursionOptions): IOperationReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IOperationShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IOperationGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): OperationState;
     validate(): {
         success: boolean;
@@ -105,7 +110,7 @@ export declare class OperationState implements IOperation, BaseState, UserManage
     };
     getErrors(): EntityError[];
     getShallowErrors(): EntityError[];
-    clone(_?: EntryPointEntityState): OperationState;
+    clone(parent?: EntryPointEntityState | ProjectState | null, newId?: string | null, subscribe?: boolean): OperationState;
     removeUnrecognizedInputs(): IChangeSet<OperationState>;
     removeUnrecognizedOutputs(): IChangeSet<OperationState>;
     syncMissingFixedInputs(): IChangeSet<OperationState>;

package/dist/tree/state/output-map/output-map.d.ts

@@ -1,8 +1,8 @@
 import { ElementGenerationTarget, ElementShallowTransfer, EntityId, EntityType, EntityVersion, IActionOutputMap, IActionOutputMapTransfer, IOutputMap, IOutputMapGenerationTarget, IOutputMapReference, IOutputMapShallowTransfer, IOutputMapTransfer, IVariableOutputMap, IVariableOutputMapTransfer, OutputMapParentChildRelation, OutputMapTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseState, ChildEntityState, EntityWithValueClass, UserManagedEntityStateFunctionality, ValueWritingEntityClass } from '../base';
+import { BaseState, ChildEntityState, EntityWithValueClass, IEditableEntityPersistanceRepository, IEntityJSONCloneOptions, IEntityPersistanceOptions, IEntityRecursionOptions, UserManagedEntityStateFunctionality, ValueWritingEntityClass } from '../base';
 import { ReturnDeclarationState } from '../return-declaration';
-import { EntityState, IChangeSet, PassThroughCallableEntityState, PassThroughCallableEntityWithOutputsState, ValueReadingEntityState } from '../types';
+import { EntityState, IChangeSet, PassThroughCallableEntityWithOutputsState, ValueReadingEntityState } from '../types';
 import { ProjectState } from '../project/project';
 import { VariableDeclarationState } from '../variable-declaration';
 import { VariableInstanceState } from '../variable-instance';
@@ -29,6 +29,7 @@ export declare class OutputMapState implements IOutputMap, UserManagedEntityStat
     initialized: boolean;
     suggestion: boolean;
     constructor(initialReturnVariableMapData: IOutputMap | IOutputMapTransfer, parentProjectState: ProjectState);
+    static repository: IEditableEntityPersistanceRepository;
     static MUTABLE_BASE_PROPERTIES: string[];
     static INMUTABLE_BASE_PROPERTIES: string[];
     static BASE_PROPERTIES: string[];
@@ -51,6 +52,8 @@ export declare class OutputMapState implements IOutputMap, UserManagedEntityStat
         errors: EntityGenerationError[];
         modifiedData: Partial<IOutputMapGenerationTarget>;
     };
+    hydrateAncestors(): IChangeSet<OutputMapState>;
+    afterAllChildrenInitialized(): IChangeSet<OutputMapState>;
     addSelfToProject(): IChangeSet<OutputMapState>;
     addValueReader(entity: ValueReadingEntityState): OutputMapState;
     removeValueReader(valueReader: ValueReadingEntityState): OutputMapState;
@@ -62,10 +65,10 @@ export declare class OutputMapState implements IOutputMap, UserManagedEntityStat
     subscribe(): OutputMapState;
     unsubscribe(): OutputMapState;
     sync(data: Partial<IOutputMap>): OutputMapState;
-    load(): Promise<OutputMapState>;
-    create(): Promise<OutputMapState>;
-    update(_: Partial<OutputMapTypesUnion>): Promise<OutputMapState>;
-    delete(): Promise<OutputMapState>;
+    load(_?: IEntityPersistanceOptions): Promise<OutputMapState>;
+    create(_?: IEntityPersistanceOptions): Promise<OutputMapState>;
+    update(_?: IEntityPersistanceOptions): Promise<OutputMapState>;
+    delete(_?: IEntityPersistanceOptions): Promise<OutputMapState>;
     remove({ ignoreUpstream, seenEntities, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -79,14 +82,15 @@ export declare class OutputMapState implements IOutputMap, UserManagedEntityStat
         affected: EntityState[];
         self: OutputMapState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IOutputMapTransfer;
-    toReference(): IOutputMapReference;
-    toShallowJSON(): IOutputMapShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IOutputMapTransfer | IOutputMapReference;
+    toJSONClone(options?: IEntityJSONCloneOptions): IOutputMapTransfer | IOutputMapReference;
+    toReference(options?: IEntityRecursionOptions): IOutputMapReference;
+    toShallowJSON(options?: IEntityRecursionOptions): IOutputMapShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IOutputMapGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): OutputMapState;
     validate(): {
         success: boolean;
@@ -97,7 +101,7 @@ export declare class OutputMapState implements IOutputMap, UserManagedEntityStat
     getShallowErrors(): EntityError[];
     getDefaultValue(): LiteralValueState | null;
     setDefaultValue(defaultValue: LiteralValueState): OutputMapState;
-    clone(_?: PassThroughCallableEntityState): OutputMapState;
+    clone(parent?: PassThroughCallableEntityWithOutputsState | null, newId?: string | null, subscribe?: boolean): OutputMapState;
     getDataType(): DataTypeState | null;
 }
 export declare class VariableOutputMapState extends OutputMapState implements IVariableOutputMap {
@@ -105,13 +109,13 @@ export declare class VariableOutputMapState extends OutputMapState implements IV
     parent: VariableInstanceState | VariableDeclarationState;
     errors: EntityError[];
     constructor(initialVariableInputMapData: IVariableOutputMap | IVariableOutputMapTransfer, parentProjectState: ProjectState);
-    toJSON(): IVariableOutputMap;
+    toJSON(seenEntities?: Set<EntityId>): IVariableOutputMap | IOutputMapReference;
 }
 export declare class ActionOutputMapState extends OutputMapState implements IActionOutputMap {
     declaration: ReturnDeclarationState | ValueDescriptorState;
     parent: PassThroughCallableEntityWithOutputsState;
     errors: EntityError[];
     constructor(initialActionOutputMapData: IActionOutputMap | IActionOutputMapTransfer, parentProjectState: ProjectState);
-    toJSON(): IActionOutputMap;
+    toJSON(seenEntities?: Set<EntityId>): IActionOutputMap | IOutputMapReference;
 }
 export type OutputMapPayloadUnion = OutputMapState | OutputMapTypesUnion;

package/dist/tree/state/primitive-entity/primitive-entity.d.ts

@@ -1,6 +1,6 @@
 import { EntityId, EntityType, EntityVersion, IPrimitiveEntity, PrimitiveTypes, IPrimitiveEntityTransfer, IPrimitiveEntityReference, IPrimitiveEntityShallowTransfer, ElementShallowTransfer, IPrimitiveEntityGenerationTarget, ElementGenerationTarget, PrimitiveEntityTypesUnion } from '../../../definitions';
 import { ZodError } from 'zod';
-import { BaseState } from '../base';
+import { BaseState, IEntityPersistanceOptions, IEntityRecursionOptions, IReadOnlyEntityPersistanceRepository } from '../base';
 import { PropertyState } from '../property';
 import { ProjectState } from '../project/project';
 import { BuiltInBaseEntityState } from '../built-in-base-entity';
@@ -25,6 +25,7 @@ export declare class PrimitiveEntityState implements BaseState, IPrimitiveEntity
     errors: EntityError[];
     project: ProjectState;
     constructor(initialEntityData: IPrimitiveEntity | IPrimitiveEntityTransfer, parentProjectState: ProjectState);
+    static repository: IReadOnlyEntityPersistanceRepository;
     get allBasePropertiesFromExtendedAndImplementedEntities(): PropertyState[];
     get extendedPropertiesFromOriginalParents(): PropertyState[];
     get implementedPropertiesFromOriginalParents(): PropertyState[];
@@ -32,7 +33,7 @@ export declare class PrimitiveEntityState implements BaseState, IPrimitiveEntity
     get ownDeclaredProperties(): PropertyState[];
     subscribe(): PrimitiveEntityState;
     unsubscribe(): PrimitiveEntityState;
-    load(): Promise<PrimitiveEntityState>;
+    load(_?: IEntityPersistanceOptions): Promise<PrimitiveEntityState>;
     remove({ ignoreUpstream: _, seenEntities: _1, }?: {
         ignoreUpstream: boolean;
         seenEntities: Set<string>;
@@ -46,14 +47,14 @@ export declare class PrimitiveEntityState implements BaseState, IPrimitiveEntity
         affected: EntityState[];
         self: PrimitiveEntityState;
     };
-    toFlat(seenEntities?: Set<string>): EntityState[];
-    toFlatIds(seenEntities?: Set<string>): EntityId[];
-    toJSON(): IPrimitiveEntityTransfer;
-    toReference(): IPrimitiveEntityReference;
-    toShallowJSON(): IPrimitiveEntityShallowTransfer;
-    toFlatJSON(seenEntities?: Set<string>): ElementShallowTransfer[];
+    toFlat(seenEntities?: Set<EntityId>): EntityState[];
+    toFlatIds(seenEntities?: Set<EntityId>): EntityId[];
+    toJSON(seenEntities?: Set<EntityId>): IPrimitiveEntityTransfer | IPrimitiveEntityReference;
+    toReference(_?: IEntityRecursionOptions): IPrimitiveEntityReference;
+    toShallowJSON(_?: IEntityRecursionOptions): IPrimitiveEntityShallowTransfer;
+    toFlatJSON(seenEntities?: Set<EntityId>): ElementShallowTransfer[];
     toGenerationTarget(): IPrimitiveEntityGenerationTarget;
-    toFlatGenerationTarget(seenEntities?: Set<string>): ElementGenerationTarget[];
+    toFlatGenerationTarget(seenEntities?: Set<EntityId>): ElementGenerationTarget[];
     clearErrors(): PrimitiveEntityState;
     validate(): {
         success: boolean;
@@ -62,7 +63,6 @@ export declare class PrimitiveEntityState implements BaseState, IPrimitiveEntity
     };
     getErrors(): EntityError[];
     getShallowErrors(): EntityError[];
-    clone(): PrimitiveEntityState;
     getAllInteractiveMethods(): FunctionDeclarationState[];
 }
 export type PrimitiveEntityPayloadUnion = PrimitiveEntityState | PrimitiveEntityTypesUnion;

package/dist/tree/state/primitive-entity/validation/validation-schema.d.ts

@@ -36,15 +36,15 @@ export declare function getPrimitiveEntityBaseSchema(): z.ZodObject<{
     type: EntityType.PrimitiveEntity;
     name: string;
     description: string | null;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }, {
     id: string;
     type: EntityType.PrimitiveEntity;
     name: string;
     description: string | null;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }>;
 export declare function getPrimitiveEntityMetaSchema(): z.ZodObject<z.objectUtil.extendShape<{
     id: z.ZodString;
@@ -61,16 +61,16 @@ export declare function getPrimitiveEntityMetaSchema(): z.ZodObject<z.objectUtil
     name: string;
     description: string | null;
     version: number;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }, {
     id: string;
     type: EntityType.PrimitiveEntity;
     name: string;
     description: string | null;
     version: number;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }>;
 export declare function getPrimitiveEntityGenericGenerationTargetSchema(): z.ZodObject<z.objectUtil.extendShape<{
     id: z.ZodString;
@@ -84,15 +84,15 @@ export declare function getPrimitiveEntityGenericGenerationTargetSchema(): z.Zod
     type: EntityType.PrimitiveEntity;
     name: string;
     description: string | null;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }, {
     id: string;
     type: EntityType.PrimitiveEntity;
     name: string;
     description: string | null;
-    abstract: boolean;
     static: boolean;
+    abstract: boolean;
 }>;
 export declare function getPrimitiveEntityNestedEntitiesSchema(): z.ZodObject<{
     properties: z.ZodArray<z.ZodUnion<[z.ZodObject<{
@@ -215,8 +215,6 @@ export declare function getPrimitiveEntitySchema(): z.ZodObject<z.objectUtil.ext
         type: EntityType.BuiltInBaseEntity;
     })[];
     version: number;
-    abstract: boolean;
-    static: boolean;
     methods: (Record<string, any> | {
         type: EntityType.FunctionDeclaration;
     })[];
@@ -226,6 +224,8 @@ export declare function getPrimitiveEntitySchema(): z.ZodObject<z.objectUtil.ext
     abstractMethods: (Record<string, any> | {
         type: EntityType.ActionDescriptor;
     })[];
+    static: boolean;
+    abstract: boolean;
 }, {
     id: string;
     type: EntityType.PrimitiveEntity;
@@ -237,8 +237,6 @@ export declare function getPrimitiveEntitySchema(): z.ZodObject<z.objectUtil.ext
         type: EntityType.BuiltInBaseEntity;
     })[];
     version: number;
-    abstract: boolean;
-    static: boolean;
     methods: (Record<string, any> | {
         type: EntityType.FunctionDeclaration;
     })[];
@@ -248,4 +246,6 @@ export declare function getPrimitiveEntitySchema(): z.ZodObject<z.objectUtil.ext
     abstractMethods: (Record<string, any> | {
         type: EntityType.ActionDescriptor;
     })[];
+    static: boolean;
+    abstract: boolean;
 }>;