@elyx-code/project-logic-tree 0.0.6812 → 0.0.6814

package/dist/index.d.ts

@@ -9518,7 +9518,6 @@ export declare enum BaseValueDescriptorIds {
      ValuesAlreadyConnected = "values-already-connected",
      CannotReadMoreThanOneValue = "cannot-read-more-than-one-value",
      CannotReadValueFromChildren = "cannot-read-value-from-children",
-     CannotWriteValueToChildren = "cannot-write-value-to-children",
      CannotBeCalledByChildren = "cannot-be-called-by-children",
      ExecutionsAlreadyConnected = "executions-already-connected",
      DataTypesNotCompatible = "data-types-not-compatible",
@@ -9542,7 +9541,11 @@ export declare enum BaseValueDescriptorIds {
      CannotInteractWithOutputInVariableWithInternalCalls = "cannot-interact-with-output-in-variable-with-internal-calls",
      PropertyIsConstantItsValueCantBeReset = "property-is-constant-its-value-cant-be-reset",
      CannotWriteValueOfGlobalVariableDeclaration = "cannot-write-value-of-global-variable-declaration",
-     CannotReSetValueOfConstantVariable = "cannot-reset-value-of-constant-variable"
+     CannotReSetValueOfConstantVariable = "cannot-reset-value-of-constant-variable",
+     CannotConnectToOwnNode = "cannot-connect-to-own-node",
+     VariableDeclarationCannotBeMovedToLowerScopeBecauseInstancesUsage = "variable-declaration-cannot-be-moved-to-lower-scope-because-instances-usage",
+     CannotChangeScopeBecauseItIsCalledByOtherEntities = "cannot-change-scope-because-it-is-called-by-other-entities",
+     CannotChangeScopeBecauseItCallsOtherEntities = "cannot-change-scope-because-it-calls-other-entities"
  }
 
  export declare type CanvasEntityDisabledReason = CanvasEntityConnectionDisabledReason | CanvasEntityTestingDisabledReason | CanvasEntityOtherDisabledReason | StateMutationErrorCode;
@@ -12451,6 +12454,8 @@ export declare enum BaseValueDescriptorIds {
 
  export declare type EntityActionPayload = PersistChangeSetEntityActionPayload;
 
+ export declare function entityDisabledReasonToShortReadableError(code: CanvasEntityConnectionDisabledReason | string): string;
+
  export declare class EntityError<TCode = SharedEntityErrorCode | EntityInstanceErrorCode> implements IEntityError<TCode> {
      id: string;
      message: string;
@@ -14234,9 +14239,13 @@ export declare enum BaseValueDescriptorIds {
 
  export declare function flattenCallers(entity: CallableEntityState): CallerEntityState[];
 
- export declare function flattenCalls(entities: CallableEntityState[]): CallableEntityState[];
+ export declare function flattenCalls(entities: CallableEntityState[], options?: {
+     sorting?: 'local-y-axis';
+ }): CallableEntityState[];
 
- export declare function flattenCallsAsync(entities: CallableEntityState[], options?: YieldOptions): Promise<CallableEntityState[]>;
+ export declare function flattenCallsAsync(entities: CallableEntityState[], options?: YieldOptions & {
+     sorting?: 'local-y-axis';
+ }): Promise<CallableEntityState[]>;
 
  export declare function flattenCanvasAncestorsUntil(entity: CanvasEntityState, until: CanvasEntityState): {
      list: CanvasEntityState[];
@@ -14331,9 +14340,20 @@ export declare enum BaseValueDescriptorIds {
 
  export declare function flattenDetachedBranch(entity: CanvasEntityState): CanvasEntityState[];
 
- export declare function flattenElementCalls(element: CallerEntityState): CallableEntityState[];
+ /**
+  * Recursively flattens all callable entities called by the given caller entity.
+  * It doesn't include itself
+  *
+  * @param {CallerEntityState} element
+  * @returns {CallableEntityState[]} Not including self
+  */
+ export declare function flattenElementCalls(element: CallerEntityState, options?: {
+     sorting?: 'local-y-axis';
+ }): CallableEntityState[];
 
- export declare function flattenElementCallsAsync(element: CallerEntityState, options?: YieldOptions): Promise<CallableEntityState[]>;
+ export declare function flattenElementCallsAsync(element: CallerEntityState, options?: YieldOptions & {
+     sorting?: 'local-y-axis';
+ }): Promise<CallableEntityState[]>;
 
  export declare function flattenElementCallsOnTheSameScope(element: CallerEntityState): CallableEntityState[];
 
@@ -15303,7 +15323,11 @@ export declare enum BaseValueDescriptorIds {
      InmutableMetaProperties = "inmutable-meta-properties-explanation",
      InmutableUpstreamProperties = "inmutable-upstream-properties-explanation",
      DownstreamProperties = "downstream-properties-explanation",
-     FullEditingProperties = "full-editing-properties-explanation"
+     FullEditingProperties = "full-editing-properties-explanation",
+     OutputMapsAutogeneration = "output-maps-autogeneration-explanation",
+     AvailableOutputMapsForGivenParentCallableEntity = "available-output-maps-for-given-parent-callable-entity-explanation",
+     InputMapsAutogeneration = "input-maps-autogeneration-explanation",
+     AvailableInputMapsForGivenParentCallableEntity = "available-input-maps-for-given-parent-callable-entity-explanation"
  }
 
  /** lodash-like get(obj, path, defaultValue) with precise "missing" detection */
@@ -15360,9 +15384,13 @@ export declare enum BaseValueDescriptorIds {
 
  export declare function getAllGloballyDeclaredFunctionDeclarationsExplanation(project: ProjectState): string;
 
+ export declare function getAllGlobalValueReadingEntities(project: ProjectState, options?: YieldOptions): Promise<ValueReadingEntityState[]>;
+
+ export declare function getAllGlobalValueWritingEntities(project: ProjectState, options?: YieldOptions): Promise<ValueWritingEntityState[]>;
+
  export declare function getAllValueReadingChildren(entity: CanvasEntityState | InternalCallState): ValueReadingEntityState[];
 
- export declare function getAllValueWrittingChildren(entity: CanvasEntityState | InternalCallState): ValueWritingEntityState[];
+ export declare function getAllValueWritingChildren(entity: CanvasEntityState | InternalCallState): ValueWritingEntityState[];
 
  export declare function getAllVariablesInScope(project: ProjectState, variableDeclarations: VariableDeclarationState[], targetEntity?: UserManagedEntityState): VariableDeclarationState[];
 
@@ -18554,14 +18582,23 @@ export declare enum BaseValueDescriptorIds {
 
  export declare function getImplementedBuiltInEntity(entity: DefinitionEntityState): BuiltInBaseEntityState | null;
 
- export declare function getIncompatibleConnectionEntitiesAsync(entity: ArgumentDeclarationState | InputMapState | OutputMapState | LoopState | CallerEntityState | VariableState | ValueDescriptorState | ExecutableEntityState, connectionType: ConnectionNodeType, options?: YieldOptions): Promise<{
+ export declare function getIncompatibleConnectionEntitiesAsync(entity: ArgumentDeclarationState | InputMapState | OutputMapState | LoopState | CallerEntityState | VariableState | ValueDescriptorState | ExecutableEntityState, connectionType: ConnectionNodeType, options?: YieldOptions & {
+     allowReadWriteToFixableScope?: boolean;
+ }): Promise<{
      compatible: {
-         [id: string]: EntityState;
+         [id: string]: {
+             requiresCallConnectionTo: CallableEntityState | null;
+             requiresCallConnectionToFrom: CallerEntityState | null;
+             entity: EntityState;
+         };
      };
      incompatible: {
          [id: string]: {
              entity: EntityState;
              reasons: CanvasEntityConnectionDisabledReason[];
+             fixable: boolean;
+             requiresCallConnectionTo: CallableEntityState | null;
+             requiresCallConnectionToFrom: CallerEntityState | null;
          };
      };
  }>;
@@ -22174,6 +22211,8 @@ export declare enum BaseValueDescriptorIds {
 
   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 const INPUT_MAPS_AUTOGENERATION_EXPLANATION = "Input-maps don't ever need to be explicitly created by the user. They are automatically generated to match the shape required by the parent callable entity. For example, a variable that contains an object will have one input-map for each property of the object. Or a function-declaration or operation will have one input-map for each property of the returned object, if any.";
+
   export declare enum InputMapDependencyField {
       Declaration = "declaration",
       DataTypeEntity = "data-type-entity"
@@ -29448,6 +29487,8 @@ export declare enum BaseValueDescriptorIds {
 
   export declare const outEncDefault: ILiteralValueTransfer;
 
+  export declare const OUTPUT_MAPS_AUTOGENERATION_EXPLANATION = "Output-maps don't ever need to be explicitly created by the user. They are automatically generated to match the shape required by the parent callable entity. For example, a variable that contains an object will have one output-map for each property of the object. Or a function-call or operation will have one output-map for each property of the returned object, if any. ONLY output-maps that have a 'parentRelationType' of 'error' can be added manually, to represent the value of a caught error, and as long as one doesn't already exist in the same parent callable node.";
+
   export declare enum OutputMapDependencyField {
       Declaration = "declaration",
       DataTypeEntity = "data-type-entity"
@@ -32524,7 +32565,11 @@ export declare enum BaseValueDescriptorIds {
       ValueReadingOverridesConstantProperty = "value-reading-overrides-constant-property",
       DefaultValueOverridesConstantProperty = "default-value-overrides-constant-property",
       ValueReadingOverridesConstantVariable = "value-reading-overrides-constant-variable",
-      DefaultValueOverridesConstantVariable = "default-value-overrides-constant-variable"
+      DefaultValueOverridesConstantVariable = "default-value-overrides-constant-variable",
+      CannotSuccessCallItself = "cannot-success-call-itself",
+      CannotErrorCallItself = "cannot-error-call-itself",
+      CannotEntryCallItself = "cannot-entry-call-itself",
+      CannotValueWriteItself = "cannot-value-write-itself"
   }
 
   export declare const STATIC_PROPERTY_HEIGHT = 49;