@elyx-code/project-logic-tree 0.0.6784 → 0.0.6786

package/dist/index.d.ts

@@ -139,6 +139,7 @@ export declare class ActionDescriptorState extends UserManagedVersionedState imp
     recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<ActionDescriptorState>;
     restoreVersion(versionId: EntityVersion): Promise<IChangeSet<ActionDescriptorState>>;
     updateWithShallowTransfer(transfer: IActionDescriptorShallowTransfer, changeSet?: ChangeSet | null): ActionDescriptorState;
+    updateWithGenerationTarget(transfer: Partial<IActionDescriptorGenerationTarget>, changeSet?: ChangeSet | null): ActionDescriptorState;
     hydrateAncestors(): IChangeSet<ActionDescriptorState>;
     afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<ActionDescriptorState>;
     addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<ActionDescriptorState>;
@@ -585,6 +586,7 @@ export declare class ArgumentDeclarationState extends UserManagedVersionedState
     recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<ArgumentDeclarationState>;
     restoreVersion(versionId: EntityVersion): Promise<IChangeSet<ArgumentDeclarationState>>;
     updateWithShallowTransfer(transfer: IArgumentDeclarationShallowTransfer, changeSet?: ChangeSet | null): ArgumentDeclarationState;
+    updateWithGenerationTarget(transfer: Partial<IArgumentDeclarationGenerationTarget>, changeSet?: ChangeSet | null): ArgumentDeclarationState;
     hydrateAncestors(): IChangeSet<ArgumentDeclarationState>;
     afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<ArgumentDeclarationState>;
     addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<ArgumentDeclarationState>;
@@ -868,6 +870,7 @@ export declare class BreakStatementState extends UserManagedVersionedState imple
     recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<BreakStatementState>;
     restoreVersion(versionId: EntityVersion): Promise<IChangeSet<BreakStatementState>>;
     updateWithShallowTransfer(transfer: IBreakStatementShallowTransfer, changeSet?: ChangeSet | null): BreakStatementState;
+    updateWithGenerationTarget(transfer: Partial<IBreakStatementGenerationTarget>, changeSet?: ChangeSet | null): BreakStatementState;
     hydrateAncestors(): IChangeSet<BreakStatementState>;
     afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<BreakStatementState>;
     addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<BreakStatementState>;
@@ -10123,6 +10126,7 @@ export declare class ConditionState extends UserManagedVersionedState implements
     recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<ConditionState>;
     restoreVersion(versionId: EntityVersion): Promise<IChangeSet<ConditionState>>;
     updateWithShallowTransfer(transfer: IConditionShallowTransfer, changeSet?: ChangeSet | null): ConditionState;
+    updateWithGenerationTarget(transfer: IConditionGenerationTarget, changeSet?: ChangeSet | null): ConditionState;
     hydrateAncestors(): IChangeSet<ConditionState>;
     afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<ConditionState>;
     addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<ConditionState>;
@@ -10302,6 +10306,7 @@ export declare class ContinueStatementState extends UserManagedVersionedState im
     recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<ContinueStatementState>;
     restoreVersion(versionId: EntityVersion): Promise<IChangeSet<ContinueStatementState>>;
     updateWithShallowTransfer(transfer: IContinueStatementShallowTransfer, changeSet?: ChangeSet | null): ContinueStatementState;
+    updateWithGenerationTarget(transfer: Partial<IContinueStatementGenerationTarget>, changeSet?: ChangeSet | null): ContinueStatementState;
     hydrateAncestors(): IChangeSet<ContinueStatementState>;
     afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<ContinueStatementState>;
     addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<ContinueStatementState>;
@@ -10930,6 +10935,7 @@ export declare class DataTypeState extends UserManagedVersionedState implements
     recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<DataTypeState>;
     restoreVersion(versionId: EntityVersion): Promise<IChangeSet<DataTypeState>>;
     updateWithShallowTransfer(transfer: IDataTypeShallowTransfer, changeSet?: ChangeSet | null): DataTypeState;
+    updateWithGenerationTarget(transfer: Partial<IDataTypeGenerationTarget>, changeSet?: ChangeSet | null): DataTypeState;
     hydrateAncestors(): IChangeSet<DataTypeState>;
     afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<DataTypeState>;
     addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<DataTypeState>;
@@ -11898,6 +11904,7 @@ export declare class DefinitionEntityState extends UserManagedVersionedState imp
     recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<DefinitionEntityState>;
     restoreVersion(versionId: EntityVersion): Promise<IChangeSet<DefinitionEntityState>>;
     updateWithShallowTransfer(transfer: IDefinitionEntityShallowTransfer, changeSet?: ChangeSet | null): DefinitionEntityState;
+    updateWithGenerationTarget(transfer: Partial<IDefinitionEntityGenerationTarget>, changeSet?: ChangeSet | null): DefinitionEntityState;
     hydrateAncestors(): IChangeSet<DefinitionEntityState>;
     afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<DefinitionEntityState>;
     addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<DefinitionEntityState>;
@@ -12063,6 +12070,8 @@ export declare const downSqlRowTransformerEntityMethodVoidDataType: IDataTypeTra
 
 export declare const downSqlRowTransformerEntityMethodVoidDataTypeParentRef: IDataTypeReference;
 
+export declare const DOWNSTREAM_PROPERTIES_EXPLANATION = "Some fields on an entity point to a downstream/nested entity, which means it is a child of the current entity in the tree. Downstream properties are owned and managed by the downstream entity itself, and cannot be modified directly on the upstream entity.\nFor example, a 'function-declaration' entity has a list of downstream references to its 'argument-declaration' in the property called 'inputs'. To edit the relationship, or modify any of the inputs, the input itself must be targeted directly.";
+
 export declare const DRAGGABLE_CALLABLE_TYPES: EntityType[];
 
 export declare const DRAGGABLE_CALLER_TYPES: EntityType[];
@@ -12199,6 +12208,8 @@ export declare enum DynamicValueTypes {
 
 export declare const EDITABLE_PERSISTANCE_REPOSITORY_DEFAULTS: IEditableEntityPersistanceRepository;
 
+export declare const EDITING_PROPERTIES_EXPLANATION = "Entities of any type have two types of fields: primitive meta-data fields, and relational fields that point to other entities.\nRelational fields can be upstream or downstream.\nOnly upstream fields are owned and can be edited by the entity itself.\nDownstream fields are owned and edited by the downstream entity that points to this entity.\nFor example, many entities have a 'parent' field that points to their parent entity. Once the parent is set, they show up in one of the downstream fields of the parent entity, like 'inputs' or 'body'.";
+
 export declare class EfimeralValueStore implements IValueStoreClient {
     initialized: boolean;
     id: string;
@@ -12443,6 +12454,22 @@ export declare enum EntityErrorSeverity {
     Warning = "warning"
 }
 
+export declare enum EntityFieldType {
+    MUTABLE_BASE_PROPERTIES = "MUTABLE_BASE_PROPERTIES",
+    INMUTABLE_BASE_PROPERTIES = "INMUTABLE_BASE_PROPERTIES",
+    BASE_PROPERTIES = "BASE_PROPERTIES",
+    MUTABLE_META_PROPERTIES = "MUTABLE_META_PROPERTIES",
+    INMUTABLE_META_PROPERTIES = "INMUTABLE_META_PROPERTIES",
+    META_PROPERTIES = "META_PROPERTIES",
+    MUTABLE_UPSTREAM_PROPERTIES = "MUTABLE_UPSTREAM_PROPERTIES",
+    INMUTABLE_UPSTREAM_PROPERTIES = "INMUTABLE_UPSTREAM_PROPERTIES",
+    UPSTREAM_PROPERTIES = "UPSTREAM_PROPERTIES",
+    MUTABLE_DOWNSTREAM_PROPERTIES = "MUTABLE_DOWNSTREAM_PROPERTIES",
+    INMUTABLE_DOWNSTREAM_PROPERTIES = "INMUTABLE_DOWNSTREAM_PROPERTIES",
+    DOWNSTREAM_PROPERTIES = "DOWNSTREAM_PROPERTIES",
+    PROPERTIES = "PROPERTIES"
+}
+
 export declare class EntityGenerationError implements IEntityGenerationError {
     id: string;
     message: string;
@@ -14090,6 +14117,8 @@ export declare enum ExternalIntegrationRootProviders {
     'zuora' = "zuora"
 }
 
+export declare function fieldTypeToReadableString(fieldType: EntityFieldType): string;
+
 export declare const filesIntegrationBuiltInActionDescriptorTransfer: IActionDescriptorTransfer;
 
 /**
@@ -14109,6 +14138,8 @@ export declare function filterOutDuplicateErrorsAsync(errors: (EntityGenerationE
 
 export declare function findEntityFromKeys(keys: string[], project: ProjectState): DefinitionEntityState | null;
 
+export declare function findEntityTypeWithFieldName(fieldName: string): Map<EntityType, EntityFieldType>;
+
 export declare function findNextAvailableName(baseName: string, allEntitiesOfType: EntityWithNames[]): string;
 
 export declare function findNextCombinedSingleCallerAncestor(targetA: CallableEntityState | CallerEntityState, targetB: CallableEntityState | CallerEntityState, from?: CallerEntityState): {
@@ -14613,6 +14644,8 @@ export declare function fromZodParseToEntityGenerationErrors(data: Partial<Eleme
     type: EntityType;
 }, result: SafeParseReturnType<any, any>): EntityGenerationError[];
 
+export declare const FULL_EDITING_PROPERTIES_EXPLANATION = "Entities of any type have two types of fields: primitive meta-data fields, and relational fields that point to other entities.\nRelational fields can be upstream or downstream.\nOnly upstream fields are owned and can be edited by the entity itself.\nDownstream fields are owned and edited by the downstream entity that points to this entity.\nFor example, many entities have a 'parent' field that points to their parent entity. Once the parent is set, they show up in one of the downstream fields of the parent entity, like 'inputs' or 'body'.\n\nSome meta-data properties of entities can be changed after the initial creation, like 'name', 'description', etc...\nThese are called mutable meta-properties.\n\nSome meta-data properties of entities cannot be changed after the initial creation, like 'type', 'id', etc...\nThese are called inmutable meta-properties.\n\nSome upstream relational properties of entities cannot be changed after the initial creation, like 'parent' for some entities, etc...\nThese are called inmutable upstream properties.\n\nSome fields on an entity point to a downstream/nested entity, which means it is a child of the current entity in the tree. Downstream properties are owned and managed by the downstream entity itself, and cannot be modified directly on the upstream entity.\nFor example, a 'function-declaration' entity has a list of downstream references to its 'argument-declaration' in the property called 'inputs'. To edit the relationship, or modify any of the inputs, the input itself must be targeted directly.";
+
 export declare enum FunctionCallDependencyField {
     FunctionCallParentField = "function-call-parent-field",
     FunctionCallDeclarationField = "function-call-declaration-field"
@@ -14702,6 +14735,7 @@ export declare class FunctionCallState extends UserManagedVersionedState impleme
     recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<FunctionCallState>;
     restoreVersion(versionId: EntityVersion): Promise<IChangeSet<FunctionCallState>>;
     updateWithShallowTransfer(transfer: IFunctionCallShallowTransfer, changeSet?: ChangeSet | null): FunctionCallState;
+    updateWithGenerationTarget(transfer: Partial<IFunctionCallGenerationTarget>, changeSet?: ChangeSet | null): FunctionCallState;
     hydrateAncestors(): IChangeSet<FunctionCallState>;
     afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<FunctionCallState>;
     addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<FunctionCallState>;
@@ -14874,6 +14908,7 @@ export declare class FunctionDeclarationState extends UserManagedVersionedState
     recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<FunctionDeclarationState>;
     restoreVersion(versionId: EntityVersion): Promise<IChangeSet<FunctionDeclarationState>>;
     updateWithShallowTransfer(transfer: IFunctionDeclarationShallowTransfer, changeSet?: ChangeSet | null): FunctionDeclarationState;
+    updateWithGenerationTarget(transfer: Partial<IFunctionDeclarationGenerationTarget>, changeSet?: ChangeSet | null): FunctionDeclarationState;
     hydrateAncestors(): IChangeSet<FunctionDeclarationState>;
     afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<FunctionDeclarationState>;
     addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<FunctionDeclarationState>;
@@ -15181,7 +15216,14 @@ export declare enum GenerationExplanationIds {
     AllLoopActionDescriptors = "all-loop-action-descriptors-explanation",
     AllGlobalEventsActionDescriptors = "all-global-events-action-descriptors-explanation",
     DefinitionEntities = "definition-entities-explanation",
-    PropertyImplementationAndExtensionAutoEnrichment = "property-implementation-and-extension-auto-enrichment-explanation"
+    PropertyImplementationAndExtensionAutoEnrichment = "property-implementation-and-extension-auto-enrichment-explanation",
+    ActualOwnersOfMisplacedProperties = "actual-owners-of-misplaced-properties-explanation",
+    EditingProperties = "editing-properties-explanation",
+    MutableMetaProperties = "mutable-meta-properties-explanation",
+    InmutableMetaProperties = "inmutable-meta-properties-explanation",
+    InmutableUpstreamProperties = "inmutable-upstream-properties-explanation",
+    DownstreamProperties = "downstream-properties-explanation",
+    FullEditingProperties = "full-editing-properties-explanation"
 }
 
 /** lodash-like get(obj, path, defaultValue) with precise "missing" detection */
@@ -19707,6 +19749,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<GlobalEventState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<GlobalEventState>>;
      updateWithShallowTransfer(transfer: IGlobalEventShallowTransfer, changeSet?: ChangeSet | null): GlobalEventState;
+     updateWithGenerationTarget(transfer: Partial<IGlobalEventGenerationTarget>, changeSet?: ChangeSet | null): GlobalEventState;
      hydrateAncestors(): IChangeSet<GlobalEventState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<GlobalEventState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<GlobalEventState>;
@@ -21099,8 +21142,6 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      id: EntityId;
      type: EntityType.Condition;
      declaration: EntityId;
-     andChildrenGroup?: EntityId[];
-     orChildrenGroup?: EntityId[];
      calledBySuccess: EntityId[];
      calledByError: EntityId[];
      calledByEntry: EntityId[];
@@ -21459,6 +21500,12 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      cascade?: boolean;
  }
 
+ export declare interface IEntityPrintoutOptions {
+     singleLine?: boolean;
+     indentSize?: number;
+     singleLineSpacer?: string;
+ }
+
  export declare interface IEntityRecursionOptions {
      seenEntityMaps?: Map<EntityId, EntityId>;
      seenEntities?: Set<EntityId>;
@@ -21532,7 +21579,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      catchesError: boolean;
  }
 
- export declare interface IFunctionCallGenerationTarget extends IBaseActionCallGenerationTarget, IUserManagedGenericBase {
+ export declare interface IFunctionCallGenerationTarget extends IBaseActionCallGenerationTarget, IChildEntityGenerationTarget, ICalledEntityGenerationTarget {
      type: EntityType.FunctionCall;
      declaration: EntityId;
      catchesError?: boolean;
@@ -22010,6 +22057,10 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      yieldEvery?: number;
  }, parentContext?: IProjectInstanceParentContext): Promise<ProjectState>;
 
+ export declare const INMUTABLE_META_PROPERTIES_EXPLANATION = "Some meta-data properties of entities cannot be changed after the initial creation, like 'type', 'id', etc...\nThese are called inmutable meta-properties.";
+
+ export declare const INMUTABLE_UPSTREAM_PROPERTIES_EXPLANATION = "Some upstream relational properties of entities cannot be changed after the initial creation, like 'parent' for some entities, etc...\nThese are called inmutable upstream properties.";
+
  export declare enum InputMapDependencyField {
      Declaration = "declaration",
      DataTypeEntity = "data-type-entity"
@@ -22102,6 +22153,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<InputMapState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<InputMapState>>;
      updateWithShallowTransfer(transfer: IInputMapShallowTransfer, changeSet?: ChangeSet | null): InputMapState;
+     updateWithGenerationTarget(transfer: Partial<IInputMapGenerationTarget>, changeSet?: ChangeSet | null): InputMapState;
      hydrateAncestors(): IChangeSet<InputMapState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<InputMapState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<InputMapState>;
@@ -22245,6 +22297,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<InstalledProjectState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<InstalledProjectState>>;
      updateWithShallowTransfer(transfer: IInstalledProjectShallowTransfer, changeSet?: ChangeSet | null): InstalledProjectState;
+     updateWithGenerationTarget(transfer: Partial<IInstalledProjectGenerationTarget>, changeSet?: ChangeSet | null): InstalledProjectState;
      hydrateAncestors(): IChangeSet<InstalledProjectState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<InstalledProjectState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<InstalledProjectState>;
@@ -22389,6 +22442,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<InternalCallState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<InternalCallState>>;
      updateWithShallowTransfer(transfer: IInternalCallShallowTransfer, changeSet?: ChangeSet | null): InternalCallState;
+     updateWithGenerationTarget(transfer: Partial<IInternalCallGenerationTarget>, changeSet?: ChangeSet | null): InternalCallState;
      hydrateAncestors(): IChangeSet<InternalCallState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<InternalCallState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<InternalCallState>;
@@ -22706,6 +22760,19 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      autogeneration: UUIDAutogenerationOptions | null;
  }
 
+ export declare interface IPrintEntityOptions {
+     nested?: boolean;
+     omitTopLevelType?: boolean;
+     firstLabel?: 'name' | 'id';
+     omitIdsFor?: EntityType[];
+     omitTypesFor?: EntityType[];
+     metadataIndent?: number;
+     ownMetadataIndent?: number;
+     omitFields?: EntityPrintingFields[];
+     onlyFields?: EntityPrintingFields[];
+     onPrefix?: (entity: EntityState) => string;
+ }
+
  export declare interface IProject extends IProjectTransfer {
      projects: IInstalledProject[];
      entities: IDefinitionEntity[];
@@ -24731,6 +24798,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<LiteralValueState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<LiteralValueState>>;
      updateWithShallowTransfer(transfer: ILiteralValueShallowTransfer, changeSet?: ChangeSet | null): LiteralValueState;
+     updateWithGenerationTarget(transfer: Partial<ILiteralValueGenerationTarget>, changeSet?: ChangeSet | null): LiteralValueState;
      hydrateAncestors(): IChangeSet<LiteralValueState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<LiteralValueState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<LiteralValueState>;
@@ -24895,6 +24963,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<LoopState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<LoopState>>;
      updateWithShallowTransfer(transfer: ILoopShallowTransfer, changeSet?: ChangeSet | null): LoopState;
+     updateWithGenerationTarget(transfer: Partial<ILoopGenerationTarget>, changeSet?: ChangeSet | null): LoopState;
      hydrateAncestors(): IChangeSet<LoopState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<LoopState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<LoopState>;
@@ -25248,6 +25317,8 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
 
  export declare function modifyEditableAndDeletableDownstreamEntitiesFromGiven(entity: UserManagedEntityState, changeSet: ChangeSet, newValue: boolean, seenEntities?: Set<string>): void;
 
+ export declare const MUTABLE_META_PROPERTIES_EXPLANATION = "Some meta-data properties of entities can be changed after the initial creation, like 'name', 'description', etc...\nThese are called mutable meta-properties.";
+
  export declare const NESTED_PROPERTY_HEIGHT = 26;
 
  export declare function nestedObjectKeyValueEquals(obj: unknown, path: unknown, expected: unknown): boolean;
@@ -29162,6 +29233,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<OperationState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<OperationState>>;
      updateWithShallowTransfer(transfer: IOperationShallowTransfer, changeSet?: ChangeSet | null): OperationState;
+     updateWithGenerationTarget(transfer: Partial<IOperationGenerationTarget>, changeSet?: ChangeSet | null): OperationState;
      hydrateAncestors(): IChangeSet<OperationState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<OperationState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<OperationState>;
@@ -29352,6 +29424,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<OutputMapState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<OutputMapState>>;
      updateWithShallowTransfer(transfer: IOutputMapShallowTransfer, changeSet?: ChangeSet | null): OutputMapState;
+     updateWithGenerationTarget(transfer: Partial<IOutputMapGenerationTarget>, changeSet?: ChangeSet | null): OutputMapState;
      hydrateAncestors(): IChangeSet<OutputMapState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<OutputMapState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<OutputMapState>;
@@ -29790,49 +29863,22 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      Untyped = "untyped"
  }
 
- export declare function printDataType(dataType: DataTypeState | null, options?: {
-     nested?: boolean;
-     omitTopLevelType?: boolean;
-     firstLabel?: 'name' | 'id';
-     omitIdsFor?: EntityType[];
-     omitTypesFor?: EntityType[];
-     metadataIndent?: number;
-     ownMetadataIndent?: number;
-     omitFields?: EntityPrintingFields[];
-     onlyFields?: EntityPrintingFields[];
- }): {
+ export declare function printDataType(dataType: DataTypeState | null, options?: IPrintEntityOptions): {
      lines: {
          text: string;
          indentLevel: number;
      }[];
  };
 
- export declare function printEntity(entity: EntityState, options?: {
-     nested?: boolean;
-     omitTopLevelType?: boolean;
-     firstLabel?: 'name' | 'id';
-     omitIdsFor?: EntityType[];
-     omitTypesFor?: EntityType[];
-     metadataIndent?: number;
-     ownMetadataIndent?: number;
-     omitFields?: EntityPrintingFields[];
-     onlyFields?: EntityPrintingFields[];
- }): {
+ export declare function printEntity(entity: EntityState, options?: IPrintEntityOptions): {
      lines: {
          text: string;
          indentLevel: number;
      }[];
  };
 
- export declare function printEntityList(entities: EntityState[], options?: {
-     nested?: boolean;
-     omitTopLevelType?: boolean;
-     firstLabel?: 'name' | 'id';
-     omitIdsFor?: EntityType[];
-     omitTypesFor?: EntityType[];
+ export declare function printEntityList(entities: EntityState[], options?: IPrintEntityOptions, printoutOptions?: IEntityPrintoutOptions & {
      newLinesBetweenItems?: number;
-     omitFields?: EntityPrintingFields[];
-     onlyFields?: EntityPrintingFields[];
  }): string;
 
  export declare function printGenerationTarget(entity: ElementGenerationTarget, project: ProjectState): string;
@@ -29995,6 +30041,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(_sharedTimestamp: null | string): IChangeSet<ProjectState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<ProjectState>>;
      updateWithShallowTransfer(transfer: IProjectShallowTransfer, changeSet?: ChangeSet | null): ProjectState;
+     updateWithGenerationTarget(transfer: Partial<IProjectGenerationTarget>, changeSet?: ChangeSet | null): ProjectState;
      hydrateAncestors(): IChangeSet<ProjectState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<ProjectState>;
      addSelfToProject(_changeSet: ChangeSet | null): IChangeSet<ProjectState>;
@@ -30283,6 +30330,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<PropertyState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<PropertyState>>;
      updateWithShallowTransfer(transfer: IPropertyShallowTransfer, changeSet?: ChangeSet | null): PropertyState;
+     updateWithGenerationTarget(transfer: Partial<IPropertyGenerationTarget>, changeSet?: ChangeSet | null): PropertyState;
      hydrateAncestors(): IChangeSet<PropertyState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<PropertyState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<PropertyState>;
@@ -31034,6 +31082,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<ReturnStatementState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<ReturnStatementState>>;
      updateWithShallowTransfer(transfer: IReturnStatementShallowTransfer, changeSet?: ChangeSet | null): ReturnStatementState;
+     updateWithGenerationTarget(transfer: Partial<IReturnStatementGenerationTarget>, changeSet?: ChangeSet | null): ReturnStatementState;
      hydrateAncestors(): IChangeSet<ReturnStatementState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<ReturnStatementState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<ReturnStatementState>;
@@ -31279,6 +31328,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<SearchState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<SearchState>>;
      updateWithShallowTransfer(transfer: ISearchShallowTransfer, changeSet?: ChangeSet | null): SearchState;
+     updateWithGenerationTarget(transfer: Partial<ISearchGenerationTarget>, changeSet?: ChangeSet | null): SearchState;
      hydrateAncestors(): IChangeSet<SearchState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<SearchState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<SearchState>;
@@ -32284,6 +32334,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      SetStandaloneParent = "set-standalone-parent",
      AfterAllChildrenInitialized = "after-all-children-initialized",
      UpdateWithShallowTransfer = "update-with-shallow-transfer",
+     UpdateWithGenerationTarget = "update-with-generation-target",
      RemoveFromParent = "remove-from-parent",
      RemoveEntity = "remove-entity",
      RestoreEntity = "restore-entity",
@@ -33573,6 +33624,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      abstract recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<UserManagedEntityState>;
      abstract restoreVersion(version: EntityVersion): Promise<IChangeSet<UserManagedEntityState>>;
      abstract updateWithShallowTransfer(transfer: UserManagedElementShallowTransfer, changeSet: ChangeSet | null): UserManagedEntityState;
+     abstract updateWithGenerationTarget(target: Partial<ElementGenerationTarget>, changeSet: ChangeSet | null): UserManagedEntityState;
      abstract hydrateAncestors(): IChangeSet<UserManagedEntityState>;
      abstract addSelfToProject(changeSet: ChangeSet | null): IChangeSet<UserManagedEntityState>;
      abstract afterAllChildrenInitialized(changeSet: ChangeSet | null): IChangeSet<UserManagedEntityState>;
@@ -33860,7 +33912,13 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      modifiedData: ElementGenerationTarget | null;
  };
 
- export declare function validateGenerationTarget(data: ElementGenerationTarget, _: ProjectState): EntityGenerationError[];
+ export declare function validateGenerationTarget(data: ElementGenerationTarget, _: ProjectState): {
+     errors: EntityGenerationError[];
+     explanations: {
+         id: GenerationExplanationIds;
+         message: string;
+     }[];
+ };
 
  export declare function validateGenerationUpdate(generatedPayload: Partial<UserManagedElementGenerationTarget>, entityToUpdate: UserManagedEntityState): {
      errors: EntityGenerationError[];
@@ -34486,6 +34544,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<ValueDescriptorState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<ValueDescriptorState>>;
      updateWithShallowTransfer(transfer: IValueDescriptorShallowTransfer, changeSet?: ChangeSet | null): ValueDescriptorState;
+     updateWithGenerationTarget(transfer: Partial<IValueDescriptorGenerationTarget>, changeSet?: ChangeSet | null): ValueDescriptorState;
      hydrateAncestors(): IChangeSet<ValueDescriptorState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<ValueDescriptorState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<ValueDescriptorState>;
@@ -34710,6 +34769,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<VariableDeclarationState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<VariableDeclarationState>>;
      updateWithShallowTransfer(transfer: IVariableDeclarationShallowTransfer, changeSet?: ChangeSet | null): VariableDeclarationState;
+     updateWithGenerationTarget(transfer: Partial<IVariableDeclarationGenerationTarget>, changeSet?: ChangeSet | null): VariableDeclarationState;
      hydrateAncestors(): IChangeSet<VariableDeclarationState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<VariableDeclarationState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<VariableDeclarationState>;
@@ -34927,6 +34987,7 @@ export declare function getReferencedEntityStateOrErrors(data: ElementGeneration
      recursiveCaptureUpstreamVersions(sharedTimestamp: null | string): IChangeSet<VariableInstanceState>;
      restoreVersion(versionId: EntityVersion): Promise<IChangeSet<VariableInstanceState>>;
      updateWithShallowTransfer(transfer: IVariableInstanceShallowTransfer, changeSet?: ChangeSet | null): VariableInstanceState;
+     updateWithGenerationTarget(transfer: Partial<IVariableInstanceGenerationTarget>, changeSet?: ChangeSet | null): VariableInstanceState;
      hydrateAncestors(): IChangeSet<VariableInstanceState>;
      afterAllChildrenInitialized(changeSet?: ChangeSet | null): IChangeSet<VariableInstanceState>;
      addSelfToProject(changeSet?: ChangeSet | null): IChangeSet<VariableInstanceState>;