Skip to content
Bit Quirky Behavior Trees and
State Machines

Search documentation

All topics and APIs

Close returns focus to Search.

What are you looking for?

Try a common topic or enter a complete API identifier.

Browse the reference instead

Esc closes · Tab reaches results · Enter opens the focused link

v0.11.0
Menu

BitQuirky.Behavior.Authoring

Public behavior trees and state machines: runtime backend symbols in BitQuirky.Behavior.Authoring.

Source snapshot 29003d8b1658.

On this page

Assembly: BitQuirky.Behavior.Runtime.Backend

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.ActionStateMachineValidationRule

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:22-935

Implements: IBehaviorValidationExtension

Package-owned validation profile for immediate-action state machines.

Responsibilities:

  • Identify the exact action-state-machine profile selected by source assets.
  • Append profile-specific structural and binding diagnostics.
  • Separate an active state-hosted Behavior Tree subtree from the state’s direct Entry, Update, and Exit action-list validation.

Does NOT:

  • Repair authored source or substitute fallback actions and conditions.

C#
public string ProfileToken { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:58

Gets the stable profile token selected by source.

C#
public const string ActionBindingCode = "action-state-binding"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:37

Diagnostic code for an action without one declared service binding.

C#
public const string ActionPhaseCode = "action-state-phase"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:43

Diagnostic code for an invalid or mixed action lifecycle-phase declaration.

C#
public const string ActionSettingScopeCode = "action-state-setting-scope"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:46

Diagnostic code for legacy and phase-specific settings on one state.

C#
public const string AwaitedActionCode = "action-state-awaited-action"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:40

Compatibility diagnostic code retained for legacy awaited-action reports.

C#
public const string EntryCountCode = "action-state-entry-count"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:34

Diagnostic code for an invalid entry-state count.

C#
public const string RootShapeCode = "action-state-root-shape"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:31

Diagnostic code for an invalid root count or containment edge.

C#
public const string StateActionCountCode = "action-state-count"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:28

Diagnostic code for a state without an ordered direct action list.

C#
public const string Token = "action_state_machine"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:25

Stable source header token for this validation profile.

C#
public const string TransitionConditionCode = "action-state-transition-condition"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:52

Diagnostic code for an invalid transition condition binding.

C#
public const string TransitionShapeCode = "action-state-transition-shape"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:49

Diagnostic code for an incomplete transition source or destination.

C#
public const string UnsupportedNodeCode = "action-state-unsupported-node"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:55

Diagnostic code for a node kind outside the flat action-state profile.

Validate(BehaviorValidationContext context, BehaviorValidationResult result)

Section titled “Validate(BehaviorValidationContext context, BehaviorValidationResult result)”
C#
public void Validate(BitQuirky.Behavior.Authoring.BehaviorValidationContext context, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStateMachineValidationRule.cs:61-143

Appends action-state-machine diagnostics for one source operation.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.ActionStatePhaseConversion

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStatePhaseConversion.cs:25-354

Deterministic first-save conversion from a legacy single-list action state into explicit source-format 1.5 phased source.

Responsibilities:

  • Classify one state’s stored lifecycle representation as legacy, phased, or the mixed shape forbids.
  • Rewrite a legacy state into explicit Active Update rows plus explicit Active Update execution and lifetime equal to its effective legacy values, removing the superseded legacy setting keys.

Does NOT:

  • Write files, raise undo entries, change unrelated states, rewrite an already phased state, or invent settings for a state that stores no legacy action list.

IsLegacyActionState(BehaviorSourceAst ast, string stateId)

Section titled “IsLegacyActionState(BehaviorSourceAst ast, string stateId)”
C#
public static bool IsLegacyActionState(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, string stateId)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStatePhaseConversion.cs:34-43

Gets whether one state still stores the legacy single-list representation: no direct action carriesActionPhase, the state carries no phase-specific setting key, and it owns something worth preserving, meaning at least one direct action or at least one legacy action-list setting. This is the exact preconditionTryConvertStateToPhasedconverts, so the two stay inverses.

IsMixedPhaseActionState(BehaviorSourceAst ast, string stateId)

Section titled “IsMixedPhaseActionState(BehaviorSourceAst ast, string stateId)”
C#
public static bool IsMixedPhaseActionState(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, string stateId)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStatePhaseConversion.cs:62-66

Gets whether one state combines the legacy and phased representations in a way forbids: some direct actions carry a lifecycle phase while others omit it, or legacy action-list settings coexist with phase-specific settings.

IsPhasedActionState(BehaviorSourceAst ast, string stateId)

Section titled “IsPhasedActionState(BehaviorSourceAst ast, string stateId)”
C#
public static bool IsPhasedActionState(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, string stateId)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStatePhaseConversion.cs:51-55

Gets whether one state authors the explicit source-format 1.5 lifecycle representation. Returns false for a mixed state, because makes that shape invalid rather than phased, and a projection that reported it as phased would read absent phase settings and print effective values the source does not contain.

TryConvertStateToPhased(BehaviorSourceDocument document, string stateId, out string failureReason)

Section titled “TryConvertStateToPhased(BehaviorSourceDocument document, string stateId, out string failureReason)”
C#
public static bool TryConvertStateToPhased(BitQuirky.Behavior.Authoring.BehaviorSourceDocument document, string stateId, out string failureReason)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/ActionStatePhaseConversion.cs:75-186

Stages explicit phased source for one legacy action state in the supplied document. Every mapped action receivesaction_phase: update, the state receives the effective legacy execution and lifetime as explicit Active Update settings, and the superseded legacy keys are removed. A state that owns no direct action converts only when it still carries a legacy setting key worth preserving.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorBakeOptions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:30-74

Optional inputs to the bake step. All fields are optional; defaults are deterministic.

Responsibilities:

  • Carry allocator, timestamp, determinism, field-type, and validation inputs into a bake.

Does NOT:

  • Bake source, retain an artifact, or supply hidden runtime fallbacks.

C#
public Unity.Collections.Allocator Allocator { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:36

Allocator for the resultingBakedBehaviorArtifact’s native arrays. Defaults toPersistent.

C#
public System.Func<string, UnityEngine.Object> AssetResolver { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:73

Optional stable-GUID asset lookup used while materializing customer class values and dictionary keys that contain Unity object or interface fields. Runtime callers may leave this unset when their source contains no such authored payload.

C#
public long? BakedAtUnixSeconds { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:44

Bake timestamp stamped into the artifact for diagnostics. Defaults toUtcNow’s Unix seconds at bake time. Set explicitly to make the timestamp deterministic (e.g. golden-fixture tests).

C#
public System.Collections.Generic.IReadOnlyDictionary<string, BitQuirky.Behavior.Baked.BakedFieldTypeCode> FieldTypeCodes { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:59

Optional explicit blackboard-slot type-code map. Maps a field name to aBakedFieldTypeCode. Fields not in the map default toInt32.

C#
public BitQuirky.Behavior.Authoring.BehaviorValidationOptions ValidationOptions { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:66

Optional validation options forwarded to Validate. When unset, package-owned node schemas are applied without consumer validation extensions.

C#
public bool VerifyDeterminismDoubleBake { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:52

If true, the bake runs twice and asserts equality of the two outputs to defensively catch non-determinism. Defaults to true for editor / dev builds and is overridden to false on the hot path (behavior load).

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorBakeResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:89-122

Outcome of a bake. On success,Artifactis non-null and owns its native arrays. On failure,Artifactis null andDiagnosticscontains the bake-time validation failures per.

Responsibilities:

  • Return either an owned baked artifact or deterministic bake diagnostics.
  • Report success only when an artifact exists and no error diagnostic is present.

Does NOT:

  • Dispose the artifact automatically or conceal bake failures.

C#
public BitQuirky.Behavior.Baked.BakedBehaviorArtifact Artifact { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:92

Gets the owned artifact produced by a successful bake.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> Diagnostics { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:95

Gets the ordered diagnostics produced during validation and baking.

C#
public bool HasErrors { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:108-121

Gets whether any diagnostic has error severity.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Member.BehaviorMemberBindingDiagnostic> MemberDiagnostics { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:101-102

Gets the structured member-binding diagnostics. Each entry also projects one error intoDiagnosticscarrying the same stable code.

C#
public bool Success { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:105

Gets whether baking produced an artifact without error diagnostics.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorBaker

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:158-6859

Bakes a parsedBehaviorSourceAstinto a deterministic Burst-friendlyBakedBehaviorArtifact.

Responsibilities:

  • Run bake-time validation per §Bake-time validation, including ValidateMemberDeclaredValueAccess: a member-node reference to a declared graph value without that node’s matching declared read or write access refuses the bake before an artifact exists (, ).
  • Intern node ids, field names, service names, and subgraph addresses; flatten per-node read/write/waits sets into dense integer-id arrays.
  • Compute a deterministic source-content hash over the semantic slice of the AST (layout / passthrough comments excluded).
  • Build the POD node table, transition table, blackboard layout, authority table, and subgraph reference table.
  • Stamp the source-content hash + behavior-version + baked-at timestamp into the artifact only, never back into the .bqbehavior (R-9 / FR-012g).
  • Optionally double-bake and assert byte-for-byte equality to defensively detect non-determinism.

Does NOT:

  • Mutate the canonical .bqbehavior file.
  • Resolve subgraph references (the loader handles that; this baker only validates that referenced addresses are present and unique).
  • Allocate managed garbage on the runtime hot path: the bake runs at editor time (preprocess + postprocessor) and at behavior load, never inside a tick.

Bake(BehaviorSourceAst ast, BehaviorBakeOptions options)

Section titled “Bake(BehaviorSourceAst ast, BehaviorBakeOptions options)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorBakeResult Bake(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorBakeOptions options = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorBaker.cs:169-302

Bake the AST. Always returns a result; check Successbefore consuming the artifact. On failure, the artifact is null and the caller does not need to dispose anything.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorCanonicalValueCodec

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:30-1617

The one canonical reader and writer of the declared-value grammar: one record per variable, written as the ordered name, type, key, shape and value lines, with one entry or element per line so an added entry is one added line in a diff.

Responsibilities:

  • Write and parse the ordered keys of every variable record, including outermost-first recursive shape levels and one recursively shaped key at every dictionary level.
  • Write and parse every readable value form with deterministic invariant spelling: numbers as authored, quoted text and char, enum members and bracketed flag sets, structs as fields by name, list block sequences, short inline arrays, dictionary entries one per line with the key first, assets as a GUID beside their name, the explicitnonereference token, and the reserved bracketed key markers.
  • Preserve author order and produce byte-identical output for identical input, so a save with no edits produces no diff.

Does NOT:

  • Resolve a type, adopt a same-named type, coerce a value, supply a default, or discard an invalid authored payload. Type-directed interpretation belongs to the resolver.

C#
public const string ConcreteTypeFieldKey = "#type"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:51

The reserved field key naming a polymorphic value’s concrete type.

C#
public const string EmptySequenceToken = "[]"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:48

The canonical empty-sequence token, distinct from NoneToken.

C#
public const string EntryKeyFieldKey = "key"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:54

The canonical dictionary entry key naming the entry’s key half.

C#
public const string EntryValueFieldKey = "value"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:57

The canonical dictionary entry key naming the entry’s value half.

C#
public const string NoneToken = "none"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:45

The explicit token of a reference holding no object.

C#
public const string NullKeyMarker = "<none>"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:42

The reserved marker of a saved null key the editor never writes.

C#
public const string UnsetKeyMarker = "<unset>"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:39

The reserved marker of a key the author has never committed.

C#
public const string VariablesBlockHeader = "variables:"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:36

The canonical header line body that opens the declared-value block.

FormatAssetReference(string guid, string assetName)

Section titled “FormatAssetReference(string guid, string assetName)”
C#
public static string FormatAssetReference(string guid, string assetName)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:602-606

Writes an asset reference as its stable GUID beside the asset’s name.

C#
public static string FormatBool(bool value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:568-571

Writes the canonical spelling of a boolean value.

C#
public static string FormatChar(char value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:533-540

Writes one character in single quotes with deterministic escaping.

C#
public static string FormatDouble(double value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:594-599

Writes an invariant round-trip double-precision number.

FormatEntryPayload(BehaviorSourceDictionaryEntry entry)

Section titled “FormatEntryPayload(BehaviorSourceDictionaryEntry entry)”
C#
public static string FormatEntryPayload(BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry entry)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:431-443

Writes one ordered dictionary entry with its key first. This is the one spelling of an entry, shared by the block writer and every surface that renders a single entry.

FormatFieldBlock(IReadOnlyList<KeyValuePair<string, string>> fields)

Section titled “FormatFieldBlock(IReadOnlyList<KeyValuePair<string, string>> fields)”
C#
public static string FormatFieldBlock(System.Collections.Generic.IReadOnlyList<System.Collections.Generic.KeyValuePair<string, string>> fields)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:647-666

Writes an ordered field block with the canonical spacing.

C#
public static string FormatFloat(float value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:586-591

Writes an invariant round-trip single-precision number.

C#
public static string FormatGuid(System.Guid value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:505-508

Writes a Guid as quoted, lowercase, hyphenated hexadecimal text.

FormatInlineSequence(IReadOnlyList<string> items)

Section titled “FormatInlineSequence(IReadOnlyList<string> items)”
C#
public static string FormatInlineSequence(System.Collections.Generic.IReadOnlyList<string> items)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:708-726

Writes an inline sequence with the canonical spacing.

FormatKeyMarker(BehaviorSourceDictionaryKeyState state, string committedPayload)

Section titled “FormatKeyMarker(BehaviorSourceDictionaryKeyState state, string committedPayload)”
C#
public static string FormatKeyMarker(BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryKeyState state, string committedPayload)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:416-425

Writes the exact key spelling of one entry state: a committed key writes its own saved payload, and each reserved state writes its own bracketed marker.

FormatShapeToken(BehaviorDeclaredValueShape shape)

Section titled “FormatShapeToken(BehaviorDeclaredValueShape shape)”
C#
public static string FormatShapeToken(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape shape)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:185-197

Writes the canonical shape token.

C#
public static string FormatSignedInteger(long value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:574-577

Writes an invariant whole number.

C#
public static string FormatText(string value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:470-484

Writes text with deterministic escaping, preserving empty separately from null.

FormatTypeToken(BehaviorSourceTypeIdentity identity)

Section titled “FormatTypeToken(BehaviorSourceTypeIdentity identity)”
C#
public static string FormatTypeToken(BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity identity)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:95-104

Writes one exact type identity. The six built-in scalars are written as their C# keyword with no assembly; everything else carries its assembly simple name.

C#
public static string FormatUnsignedInteger(ulong value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:580-583

Writes an invariant unsigned whole number.

GetComponentNames(BehaviorDeclaredValueKind kind)

Section titled “GetComponentNames(BehaviorDeclaredValueKind kind)”
C#
public static System.Collections.Generic.IReadOnlyList<string> GetComponentNames(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:167-182

Gets the one fixed ordered component schema of a UnityEngine value struct kind, shared by every writer and reader so a component name is spelled in exactly one place. The returned list is read-only, so callers cannot mutate the shared schema.

IndexOfTopLevel(string payload, char separator)

Section titled “IndexOfTopLevel(string payload, char separator)”
C#
public static int IndexOfTopLevel(string payload, char separator)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:806-845

Finds the first top-level occurrence of a separator, or -1.

C#
public static bool IsMarker(string payload)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:446-451

Returns whether the payload is a reserved bracketed marker.

C#
public static bool IsNone(string payload)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:463-467

Returns whether the payload is the explicit no-object token.

C#
public static bool IsQuotedText(string payload)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:454-460

Returns whether the payload is quoted text rather than a bare word.

ReadVariables(IReadOnlyList<string> lines, int headerIndex, ICollection<BehaviorSourceDeclaredValue> sink, ICollection<BehaviorSourceDiagnostic> diagnostics)

Section titled “ReadVariables(IReadOnlyList<string> lines, int headerIndex, ICollection<BehaviorSourceDeclaredValue> sink, ICollection<BehaviorSourceDiagnostic> diagnostics)”
C#
public static int ReadVariables(System.Collections.Generic.IReadOnlyList<string> lines, int headerIndex, System.Collections.Generic.ICollection<BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue> sink, System.Collections.Generic.ICollection<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> diagnostics)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:283-406

Reads the declared-value block that starts atheaderIndexand returns the index of the first line after it. Every record retains its author order and its exact saved payload, including a payload that is not valid for its type.

SplitTopLevel(string payload, char separator)

Section titled “SplitTopLevel(string payload, char separator)”
C#
public static System.Collections.Generic.IReadOnlyList<string> SplitTopLevel(string payload, char separator)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:760-803

Splits a payload on top-level separators, ignoring separators inside quotes, braces, brackets, and parentheses.

TryParseAssetReference(string payload, out string guid, out string assetName, out string error)

Section titled “TryParseAssetReference(string payload, out string guid, out string assetName, out string error)”
C#
public static bool TryParseAssetReference(string payload, out string guid, out string assetName, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:612-644

Parses an asset reference. The GUID is the exact stable identity; the name beside it is readable detail and never participates in resolution.

TryParseChar(string payload, out char value, out string error)

Section titled “TryParseChar(string payload, out char value, out string error)”
C#
public static bool TryParseChar(string payload, out char value, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:543-565

Parses one single-quoted character back to its exact value.

TryParseFieldBlock(string payload, out IReadOnlyList<KeyValuePair<string, string>> fields, out string error)

Section titled “TryParseFieldBlock(string payload, out IReadOnlyList<KeyValuePair<string, string>> fields, out string error)”
C#
public static bool TryParseFieldBlock(string payload, out System.Collections.Generic.IReadOnlyList<System.Collections.Generic.KeyValuePair<string, string>> fields, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:669-705

Parses an ordered field block into its exact key and payload pairs.

TryParseGuid(string payload, out Guid value, out string error)

Section titled “TryParseGuid(string payload, out Guid value, out string error)”
C#
public static bool TryParseGuid(string payload, out System.Guid value, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:511-530

Reads a Guid without exposing the framework type’s private fields.

TryParseInlineSequence(string payload, out IReadOnlyList<string> items, out string error)

Section titled “TryParseInlineSequence(string payload, out IReadOnlyList<string> items, out string error)”
C#
public static bool TryParseInlineSequence(string payload, out System.Collections.Generic.IReadOnlyList<string> items, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:729-754

Parses an inline sequence into its ordered element payloads.

TryParseShapeToken(string token, out BehaviorDeclaredValueShape shape)

Section titled “TryParseShapeToken(string token, out BehaviorDeclaredValueShape shape)”
C#
public static bool TryParseShapeToken(string token, out BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape shape)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:200-212

Parses the canonical shape token.

TryParseText(string payload, out string value, out string error)

Section titled “TryParseText(string payload, out string value, out string error)”
C#
public static bool TryParseText(string payload, out string value, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:487-502

Parses quoted text, or the explicit none token, back to its exact value.

TryParseTypeToken(string token, out BehaviorSourceTypeIdentity identity, out bool recordsAssembly, out string error)

Section titled “TryParseTypeToken(string token, out BehaviorSourceTypeIdentity identity, out bool recordsAssembly, out string error)”
C#
public static bool TryParseTypeToken(string token, out BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity identity, out bool recordsAssembly, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:110-160

Parses one exact type identity. A record written without an assembly is legal input and reportsrecordsAssemblyfalse so the author can confirm it.

WriteVariableRecord(StringBuilder builder, BehaviorSourceDeclaredValue value)

Section titled “WriteVariableRecord(StringBuilder builder, BehaviorSourceDeclaredValue value)”
C#
public static void WriteVariableRecord(System.Text.StringBuilder builder, BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:238-272

Writes one variable record with its four or five ordered keys.

WriteVariables(StringBuilder builder, IReadOnlyList<BehaviorSourceDeclaredValue> values)

Section titled “WriteVariables(StringBuilder builder, IReadOnlyList<BehaviorSourceDeclaredValue> values)”
C#
public static void WriteVariables(System.Text.StringBuilder builder, System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue> values)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorCanonicalValueCodec.cs:222-235

Writes the complete declared-value block in author order. Each line carries the %%comment prefix the rest of the Mermaid format uses.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorDeclaredValueDefaults

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1971-2131

The exact default value of one declared type, written in canonical form.

Responsibilities:

  • Write the declared type’s own default, so choosing a type, raising an array’s length, or adding a dictionary entry seeds that default rather than an invented value.
  • Keep none and a type default distinct: a reference defaults to none, and a value type defaults to its own zero state.

Does NOT:

  • Invent a value for a type that has no writable default, and never substitutes another type’s default.

FormatDefaultOrEmpty(BehaviorDeclaredValueKind kind, Type type)

Section titled “FormatDefaultOrEmpty(BehaviorDeclaredValueKind kind, Type type)”
C#
public static string FormatDefaultOrEmpty(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type type)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:2044-2047

Writes the exact canonical default payload, or the empty string when the declared type has no writable default. An empty payload is an unfinished value, never a substitute.

TryFormatDefault(BehaviorDeclaredValueKind kind, Type type, out string payload)

Section titled “TryFormatDefault(BehaviorDeclaredValueKind kind, Type type, out string payload)”
C#
public static bool TryFormatDefault(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type type, out string payload)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1976-2038

Writes the exact canonical default payload of one declared type.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorDeclaredValueDescriptor

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:336-425

The shared resolved contract authoring, validation, bake, and member compatibility read.

Responsibilities:

  • Pair the authored declaration with its resolved exact types, representation kind, derived storage and serialization classes, native footprint, and refusal reason.

Does NOT:

  • Substitute a same-named type, supply a default, or let a rejected declaration bake.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity> Candidates { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:385-386

Gets or sets the surviving same-name candidates offered, never adopted, when a record is not found or cannot resolve to one type.

C#
public System.Type ConstructedType { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:354

Gets or sets the exact recursively constructed declared value type.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue Declaration { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:339

Gets or sets the authored declaration this descriptor resolved.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity DeclaredIdentity { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:342

Gets or sets the exact authored element type identity.

C#
public int ElementStride { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:393

Gets or sets the native byte size of one carried element.

C#
public bool IsPureEntityCompatible { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:423-424

Gets whether the entity path carries this declaration, derived from the storage class and never authored.

C#
public bool IsValid { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:417

Gets whether the declaration resolved without a refusal.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity> KeyCandidates { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:389-390

Gets or sets the same-name candidates offered for the key type record.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity KeyIdentity { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:345

Gets or sets the exact authored key type identity of a dictionary.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind KeyKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:364

Gets or sets the key representation kind of a dictionary.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredTypeResolution KeyTypeResolution { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:379

Gets or sets the resolution outcome of the key type record.

C#
public int NativeSize { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:396

Gets or sets the native byte size of the whole carried value.

C#
public int RejectedDictionaryEntryIndex { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:411

Gets or sets the outer dictionary entry that owns the rejection, or -1.

C#
public bool RejectedDictionaryKey { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:414

Gets or sets whether a rejected dictionary entry points at its key half.

C#
public int RejectedElementIndex { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:408

Gets or sets the outer collection element that owns the rejected payload, or -1. Nested coordinates remain relative to this author-visible outer element.

C#
public string RejectionDetail { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:402

Gets or sets the exact actionable refusal detail.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueRejectionReason RejectionReason { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:399

Gets or sets the stable refusal reason, or none when the declaration is valid.

C#
public System.Type ResolvedKeyType { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:351

Gets or sets the exactly-once-resolved key type of a dictionary.

C#
public System.Type ResolvedType { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:348

Gets or sets the exactly-once-resolved element type.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueSerializationClass SerializationClass { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:370

Gets or sets the derived serialization class.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape Shape { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:373

Gets or sets the declared shape.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShapeLevel> ShapeLevels { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:357-358

Gets the resolved recursive levels from the authored declaration.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueStorageClass StorageClass { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:367

Gets or sets the derived storage class.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredTypeResolution TypeResolution { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:376

Gets or sets the resolution outcome of the element type record.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind ValueKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:361

Gets or sets the element representation kind.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorDeclaredValueResolutionResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:27-50

The complete resolved declared-value contract of one graph.

Responsibilities:

  • Carry every descriptor in author order beside the structured diagnostics resolution produced, so bake can refuse without re-resolving.

Does NOT:

  • Own native memory or decide bake ordering.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorDeclaredValueDescriptor> Descriptors { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:30

Gets the resolved descriptors in author order.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> Diagnostics { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:33

Gets the structured diagnostics produced while resolving.

C#
public bool HasErrors { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:36-49

Gets whether any declaration was refused.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorDeclaredValueResolver

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:71-2846

Resolves every saved declared value to exactly one type per half, derives its storage from the one rule, and reports every refusal with complete source-local coordinates.

Responsibilities:

  • Apply the three, and only three, type-resolution outcomes a saved type record can have (it resolves, it cannot be found, or it is ambiguous) to a value type and, for a dictionary, independently to its key type.
  • Derive storage from the one rule: unmanaged data is carried on the entity path, and a managed reference or a managed lookup is not.
  • Enforce serialization eligibility, encode canonical payloads into exact native default bytes, and retain every invalid authored payload and dictionary entry verbatim.

Does NOT:

  • Adopt a same-named survivor, change a collection element type, truncate, coerce, supply a default, or omit a variable. Resolution runs at import and bake, never during a tick.

C#
public static int BufferHeaderSize { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:603

Gets the byte size of the element-count header a carried buffer writes first.

C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind ClassifyKind(System.Type type)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:373-412

Classifies one resolved type into its declared-value representation kind.

ClassifyStorage(BehaviorDeclaredValueKind kind, BehaviorDeclaredValueShape shape, Type resolvedType)

Section titled “ClassifyStorage(BehaviorDeclaredValueKind kind, BehaviorDeclaredValueShape shape, Type resolvedType)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredValueStorageClass ClassifyStorage(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape shape, System.Type resolvedType)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:418-438

Derives storage from the one rule. Unmanaged data is carried on both surfaces; a managed reference or a managed lookup is a GameObject-path value.

ComparisonSupport(BehaviorDeclaredValueKind kind, BehaviorDeclaredValueShape shape, Type resolvedType)

Section titled “ComparisonSupport(BehaviorDeclaredValueKind kind, BehaviorDeclaredValueShape shape, Type resolvedType)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredComparisonSupport ComparisonSupport(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape shape, System.Type resolvedType)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:447-494

Derives the one comparison rule a declared value offers a transition predicate. Ordering and equality decide numbers,char, and a numeric-backed enum, because each is a single ordered scalar. Equality alone decidesbool, text, a flags enum, a reference, and a value struct, because none of them has a meaningful order. A collection, a lookup, and an unusable declaration offer no comparison at all.

ComputeNativeSize(BehaviorDeclaredValueDescriptor descriptor, BehaviorSourceDeclaredValue value)

Section titled “ComputeNativeSize(BehaviorDeclaredValueDescriptor descriptor, BehaviorSourceDeclaredValue value)”
C#
public static int ComputeNativeSize(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueDescriptor descriptor, BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:586-600

Gets the exact native footprint of one declared value: one element for a single value, or a four-byte element count followed by the authored elements for a buffer.

C#
public static System.Collections.Generic.IReadOnlyList<System.Reflection.FieldInfo> GetSerializedFields(System.Type type)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:913-947

Gets serialized fields in base-to-derived declaration order, including private Unity serialization attributes.

IsCarriedKind(BehaviorDeclaredValueKind kind, Type resolvedType)

Section titled “IsCarriedKind(BehaviorDeclaredValueKind kind, Type resolvedType)”
C#
public static bool IsCarriedKind(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type resolvedType)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:505-540

Returns whether the entity path carries one element kind as unmanaged data.

C#
public static bool IsFlagsEnum(System.Type resolvedType)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:497-502

Returns whether one resolved enum type is a flag set rather than one member.

NativeSize(BehaviorDeclaredValueKind kind, Type resolvedType)

Section titled “NativeSize(BehaviorDeclaredValueKind kind, Type resolvedType)”
C#
public static int NativeSize(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type resolvedType)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:543-580

Gets the exact native byte size of one carried element.

ProjectOverride(BehaviorSourceDeclaredValue declaration, string rawValue, int sourceLine, ICollection<BehaviorSourceDiagnostic> diagnostics)

Section titled “ProjectOverride(BehaviorSourceDeclaredValue declaration, string rawValue, int sourceLine, ICollection<BehaviorSourceDiagnostic> diagnostics)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue ProjectOverride(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue declaration, string rawValue, int sourceLine, System.Collections.Generic.ICollection<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> diagnostics)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:151-213

Projects one candidate-authored override through the declaration’s saved shape without resolving its type or materializing project assets. The returned declaration is a derived snapshot; the supplied module declaration is never mutated.

C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredValueResolutionResult Resolve(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:120-123

Resolves every declared value in one graph, in author order.

Resolve(BehaviorSourceAst ast, Func<string, Object> assetResolver)

Section titled “Resolve(BehaviorSourceAst ast, Func<string, Object> assetResolver)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredValueResolutionResult Resolve(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, System.Func<string, UnityEngine.Object> assetResolver)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:129-144

Resolves every declared value in author order, using the supplied project-asset lookup when a customer class contains an asset or interface field.

ResolveOne(BehaviorSourceDeclaredValue value, ICollection<BehaviorSourceDiagnostic> diagnostics)

Section titled “ResolveOne(BehaviorSourceDeclaredValue value, ICollection<BehaviorSourceDiagnostic> diagnostics)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredValueDescriptor ResolveOne(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, System.Collections.Generic.ICollection<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> diagnostics)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:241-246

Resolves one declared value. A refused declaration keeps its exact authored identity and payload, so nothing the author typed is discarded to clear the fault.

ResolveOne(BehaviorSourceDeclaredValue value, ICollection<BehaviorSourceDiagnostic> diagnostics, Func<string, Object> assetResolver)

Section titled “ResolveOne(BehaviorSourceDeclaredValue value, ICollection<BehaviorSourceDiagnostic> diagnostics, Func<string, Object> assetResolver)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredValueDescriptor ResolveOne(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, System.Collections.Generic.ICollection<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> diagnostics, System.Func<string, UnityEngine.Object> assetResolver)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:252-331

Resolves one declared value with project-asset lookup available to exact dictionary key materialization.

ResolveOverride(BehaviorSourceDeclaredValue declaration, string rawValue, int sourceLine, ICollection<BehaviorSourceDiagnostic> diagnostics, Func<string, Object> assetResolver)

Section titled “ResolveOverride(BehaviorSourceDeclaredValue declaration, string rawValue, int sourceLine, ICollection<BehaviorSourceDiagnostic> diagnostics, Func<string, Object> assetResolver)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredValueDescriptor ResolveOverride(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue declaration, string rawValue, int sourceLine, System.Collections.Generic.ICollection<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> diagnostics, System.Func<string, UnityEngine.Object> assetResolver = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:220-235

Projects one candidate-authored override and then resolves the derived declaration against its exact type contract. Type and asset validation remain at the caller’s existing resolution boundary.

ResolveTypeRecord(BehaviorSourceTypeIdentity identity, out Type resolved, out IReadOnlyList<BehaviorSourceTypeIdentity> candidates)

Section titled “ResolveTypeRecord(BehaviorSourceTypeIdentity identity, out Type resolved, out IReadOnlyList<BehaviorSourceTypeIdentity> candidates)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredTypeResolution ResolveTypeRecord(BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity identity, out System.Type resolved, out System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity> candidates)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:337-370

Applies the three, and only three, resolution outcomes to one saved type record. Any surviving same-named type is offered as a candidate and never adopted.

TryBuildStructValue(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, out object value, out string error)

Section titled “TryBuildStructValue(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, out object value, out string error)”
C#
public static bool TryBuildStructValue(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type resolvedType, string payload, out object value, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:757-766

Builds one boxed value of a fixed Unity value struct or project-defined unmanaged struct from its canonical field block. Boxing happens at import and bake only.

TryEncodeElement(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, byte[] destination, int offset, out string error)

Section titled “TryEncodeElement(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, byte[] destination, int offset, out string error)”
C#
public static bool TryEncodeElement(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type resolvedType, string payload, byte[] destination, int offset, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:662-751

Encodes one canonical element payload into exact native bytes. Invalid payloads are refused with their reason rather than truncated, coerced, or defaulted.

TryEncodeNativeDefault(BehaviorDeclaredValueDescriptor descriptor, byte[] destination, int offset, out string error)

Section titled “TryEncodeNativeDefault(BehaviorDeclaredValueDescriptor descriptor, byte[] destination, int offset, out string error)”
C#
public static bool TryEncodeNativeDefault(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueDescriptor descriptor, byte[] destination, int offset, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:609-656

Encodes the declared value’s authored payload into the exact native default bytes at the supplied offset. Returns false with an exact reason instead of coercing.

TryMaterializeValue(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, Func<string, Object> assetResolver, out object value, out string error)

Section titled “TryMaterializeValue(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, Func<string, Object> assetResolver, out object value, out string error)”
C#
public static bool TryMaterializeValue(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type resolvedType, string payload, System.Func<string, UnityEngine.Object> assetResolver, out object value, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:787-797

Materializes one canonical payload as its exact declared type, including nested asset and interface fields resolved by stable project-asset identity.

TryMaterializeValue(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, out object value, out string error)

Section titled “TryMaterializeValue(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, out object value, out string error)”
C#
public static bool TryMaterializeValue(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type resolvedType, string payload, out object value, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:773-781

Materializes one canonical payload as its exact declared type, without asset lookup. This is the one type-directed interpretation of a payload; the dictionary key contract and the editor both read keys and values through it rather than reimplementing it.

TryValidatePayload(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, out string error)

Section titled “TryValidatePayload(BehaviorDeclaredValueKind kind, Type resolvedType, string payload, out string error)”
C#
public static bool TryValidatePayload(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type resolvedType, string payload, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorDeclaredValueResolver.cs:903-910

Validates one canonical payload against one resolved type, reporting the exact reason it does not fit rather than coercing it. The editor’s fault presenter reports one element, entry or field at a time, so it needs the same per-payload verdict the bake uses rather than the first rejection of a whole declaration.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShapeChangeEffect

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:437-456

Underlying type: byte

What one shape change did to the declaration’s value.

Responsibilities:

  • Name the exact rebuild the shape-change rule applied, so the editor reports it in the same edit that made it.

Does NOT:

  • Carry presentation text; the report supplies the readable summary.

C#
FirstValueKept = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:446

The first value became the one value the single shape holds.

C#
Unchanged = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:440

The declaration already had the requested shape.

C#
ValuePromoted = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:455

The one value of a single shape became the one element of a sequence.

C#
ValueSeeded = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:449

There was no value to keep, so the type default seeded the single shape.

C#
ValuesDropped = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:452

Entering dictionary started at zero entries, so the values were dropped.

C#
ValuesKept = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:443

Every value moved across in authored order.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShapeChangeReport

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:467-492

What one shape change kept, seeded and dropped.

Responsibilities:

  • Report the exact counts the editor shows after a retype, so nothing is dropped silently.

Does NOT:

  • Undo the change; the edit command owns the undo step.

C#
public int DroppedKeyCount { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:485

Gets how many dictionary keys the change dropped.

C#
public int DroppedValueCount { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:482

Gets how many authored values the change dropped.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShapeChangeEffect Effect { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:476

Gets the exact rebuild the shape-change rule applied.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape FromShape { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:470

Gets the shape the declaration had.

C#
public int KeptValueCount { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:479

Gets how many authored values survived the change.

C#
public bool SeededTypeDefault { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:488

Gets whether the change seeded the declared type’s default.

C#
public string Summary { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:491

Gets the readable one-line summary of the change.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape ToShape { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:473

Gets the shape the declaration now has.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShapeModel

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:513-1058

The shape half of a declaration: which supported shape it uses, the type or types that shape needs, and the rebuild every shape change applies (``).

Responsibilities:

  • Commit a dictionary’s key and value identities together, and retype either half without touching the other or discarding an entry.
  • Apply the shape-change rules: entering dictionary starts at zero entries because no key may be invented, leaving dictionary keeps values in authored order and drops keys, and single retains the first value or seeds the declared type’s default.
  • Own an array’s length as a field, where raising appends type defaults and lowering drops trailing elements, and keep every dictionary entry operation in authored order.

Does NOT:

  • Resolve a type, validate a payload, or create an undo step. The edit command wraps these operations, and the resolver reports what no longer fits.

AddInnermostLevel(BehaviorSourceDeclaredValue value, BehaviorDeclaredValueShape shape, BehaviorDeclaredValueTypeShape key)

Section titled “AddInnermostLevel(BehaviorSourceDeclaredValue value, BehaviorDeclaredValueShape shape, BehaviorDeclaredValueTypeShape key)”
C#
public static void AddInnermostLevel(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape shape, BitQuirky.Behavior.Authoring.BehaviorDeclaredValueTypeShape key = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:686-749

Adds one innermost collection level and wraps every authored child in a one-element collection, retaining authored order and invalid payload text verbatim.

AppendEntry(BehaviorSourceDeclaredValue value, BehaviorSourceDictionaryEntry entry)

Section titled “AppendEntry(BehaviorSourceDeclaredValue value, BehaviorSourceDictionaryEntry entry)”
C#
public static void AppendEntry(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry entry)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:850-858

Appends one dictionary entry after every authored entry.

ChangeShape(BehaviorSourceDeclaredValue value, BehaviorDeclaredValueShape newShape, BehaviorSourceTypeIdentity keyType, string typeDefaultPayload)

Section titled “ChangeShape(BehaviorSourceDeclaredValue value, BehaviorDeclaredValueShape newShape, BehaviorSourceTypeIdentity keyType, string typeDefaultPayload)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShapeChangeReport ChangeShape(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape newShape, BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity keyType, string typeDefaultPayload)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:594-676

Applies the shape change. The value type is always kept; the value is rebuilt by the rule that belongs to the pair of shapes, and the report names what was kept, seeded and dropped.

DeclareDictionary(BehaviorSourceDeclaredValue value, BehaviorSourceTypeIdentity keyType, BehaviorSourceTypeIdentity valueType)

Section titled “DeclareDictionary(BehaviorSourceDeclaredValue value, BehaviorSourceTypeIdentity keyType, BehaviorSourceTypeIdentity valueType)”
C#
public static void DeclareDictionary(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity keyType, BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity valueType)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:537-552

Commits a dictionary declaration: the key identity and the value identity are chosen key first and value second, and are written together in one commit.

InsertEntry(BehaviorSourceDeclaredValue value, int index, BehaviorSourceDictionaryEntry entry)

Section titled “InsertEntry(BehaviorSourceDeclaredValue value, int index, BehaviorSourceDictionaryEntry entry)”
C#
public static void InsertEntry(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, int index, BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry entry)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:861-873

Inserts one dictionary entry at an exact authored position.

IsCollection(BehaviorDeclaredValueShape shape)

Section titled “IsCollection(BehaviorDeclaredValueShape shape)”
C#
public static bool IsCollection(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape shape)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:524-527

Returns whether the shape holds more than one value.

RemoveEntryAt(BehaviorSourceDeclaredValue value, int index)

Section titled “RemoveEntryAt(BehaviorSourceDeclaredValue value, int index)”
C#
public static void RemoveEntryAt(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, int index)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:876-885

Removes one dictionary entry, keeping the order of the rest.

RemoveInnermostLevel(BehaviorSourceDeclaredValue value)

Section titled “RemoveInnermostLevel(BehaviorSourceDeclaredValue value)”
C#
public static void RemoveInnermostLevel(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:755-812

Removes the innermost collection level and concatenates its children in authored order. A malformed child remains as one retained payload instead of being discarded.

ReplaceEntry(BehaviorSourceDeclaredValue value, int index, BehaviorSourceDictionaryEntry entry)

Section titled “ReplaceEntry(BehaviorSourceDeclaredValue value, int index, BehaviorSourceDictionaryEntry entry)”
C#
public static void ReplaceEntry(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, int index, BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry entry)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:888-899

Replaces one dictionary entry in place, keeping its authored position.

RequiresKeyType(BehaviorDeclaredValueShape shape)

Section titled “RequiresKeyType(BehaviorDeclaredValueShape shape)”
C#
public static bool RequiresKeyType(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape shape)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:518-521

Returns whether the shape carries a key type identity beside its value type.

RetypeKey(BehaviorSourceDeclaredValue value, BehaviorSourceTypeIdentity keyType)

Section titled “RetypeKey(BehaviorSourceDeclaredValue value, BehaviorSourceTypeIdentity keyType)”
C#
public static void RetypeKey(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity keyType)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:558-571

Retypes the key half of a dictionary. The value half and every authored entry are kept exactly; the resolver reports the keys that no longer fit.

RetypeValue(BehaviorSourceDeclaredValue value, BehaviorSourceTypeIdentity valueType)

Section titled “RetypeValue(BehaviorSourceDeclaredValue value, BehaviorSourceTypeIdentity valueType)”
C#
public static void RetypeValue(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity valueType)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:577-583

Retypes the value half. The key half of a dictionary and every authored payload are kept exactly; the resolver reports the values that no longer fit.

SetArrayLength(BehaviorSourceDeclaredValue value, int length, string typeDefaultPayload)

Section titled “SetArrayLength(BehaviorSourceDeclaredValue value, int length, string typeDefaultPayload)”
C#
public static void SetArrayLength(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value, int length, string typeDefaultPayload)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:822-847

Sets an authored collection’s length. Raising appends the declared type’s default, and lowering drops trailing elements.

SetEmpty(BehaviorSourceDeclaredValue value)

Section titled “SetEmpty(BehaviorSourceDeclaredValue value)”
C#
public static void SetEmpty(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:920-931

Sets a collection to zero elements or zero entries, which is not the none state.

SetNone(BehaviorSourceDeclaredValue value)

Section titled “SetNone(BehaviorSourceDeclaredValue value)”
C#
public static void SetNone(BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:905-917

Sets a collection to the explicit none state, which stays distinct from a collection that holds zero elements or zero entries.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorDictionaryKeyContract

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1074-1321

The one dictionary key contract: what makes two authored keys the same key (``).

Responsibilities:

  • Materialize one saved key payload as its exact declared key type, and compare two keys under that type’s runtime equality, so aliased enum members and reordered flags sets are one key while differing text, case and value are not.
  • Refuse a null key while keeping empty text a legal string key.
  • Answer whether a candidate key collides with an authored entry, so the editor and the importer reach the same verdict from the same rule.

Does NOT:

  • Repair, rewrite, or reorder a key. Every entry keeps the author’s saved text verbatim.

AreEqual(BehaviorDeclaredValueKind kind, Type keyType, string leftPayload, string rightPayload, Func<string, Object> assetResolver, out string error)

Section titled “AreEqual(BehaviorDeclaredValueKind kind, Type keyType, string leftPayload, string rightPayload, Func<string, Object> assetResolver, out string error)”
C#
public static bool AreEqual(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, string leftPayload, string rightPayload, System.Func<string, UnityEngine.Object> assetResolver, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1190-1211

Returns whether two saved payloads are one key, resolving nested project assets before invoking the customer’s exact equality contract.

AreEqual(BehaviorDeclaredValueKind kind, Type keyType, string leftPayload, string rightPayload, out string error)

Section titled “AreEqual(BehaviorDeclaredValueKind kind, Type keyType, string leftPayload, string rightPayload, out string error)”
C#
public static bool AreEqual(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, string leftPayload, string rightPayload, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1176-1184

Returns whether two saved key payloads are one key under the declared key type’s runtime equality.

AreMaterializedKeysEqual(BehaviorDeclaredValueKind kind, Type keyType, object left, object right)

Section titled “AreMaterializedKeysEqual(BehaviorDeclaredValueKind kind, Type keyType, object left, object right)”
C#
public static bool AreMaterializedKeysEqual(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, object left, object right)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1216-1235

Compares two already-materialized keys under the declared key type’s runtime equality.

IndexOfEqualKey(IReadOnlyList<BehaviorSourceDictionaryEntry> entries, BehaviorDeclaredValueKind kind, Type keyType, string payload)

Section titled “IndexOfEqualKey(IReadOnlyList<BehaviorSourceDictionaryEntry> entries, BehaviorDeclaredValueKind kind, Type keyType, string payload)”
C#
public static int IndexOfEqualKey(System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry> entries, BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, string payload)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1242-1249

Finds the authored entry whose committed key is the same key as the candidate payload, or -1. A required or saved-null key is local to its own entry and collides with nothing, and an unusable candidate collides with nothing either.

IndexOfEqualKey(IReadOnlyList<BehaviorSourceDictionaryEntry> entries, BehaviorDeclaredValueKind kind, Type keyType, string payload, Func<string, Object> assetResolver)

Section titled “IndexOfEqualKey(IReadOnlyList<BehaviorSourceDictionaryEntry> entries, BehaviorDeclaredValueKind kind, Type keyType, string payload, Func<string, Object> assetResolver)”
C#
public static int IndexOfEqualKey(System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry> entries, BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, string payload, System.Func<string, UnityEngine.Object> assetResolver)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1255-1296

Finds the authored entry equal to a candidate, resolving nested project assets before comparing customer-class keys.

IsAcceptableKeyPayload(BehaviorDeclaredValueKind kind, Type keyType, string payload, Func<string, Object> assetResolver, out string error)

Section titled “IsAcceptableKeyPayload(BehaviorDeclaredValueKind kind, Type keyType, string payload, Func<string, Object> assetResolver, out string error)”
C#
public static bool IsAcceptableKeyPayload(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, string payload, System.Func<string, UnityEngine.Object> assetResolver, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1152-1170

Returns whether a saved key can be committed, resolving nested project assets before applying the declared key type’s null and equality rules.

IsAcceptableKeyPayload(BehaviorDeclaredValueKind kind, Type keyType, string payload, out string error)

Section titled “IsAcceptableKeyPayload(BehaviorDeclaredValueKind kind, Type keyType, string payload, out string error)”
C#
public static bool IsAcceptableKeyPayload(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, string payload, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1141-1146

Returns whether a saved key payload can be a key at all. A dictionary holds no null key; empty text remains a legal string key.

TryMaterialize(BehaviorDeclaredValueKind kind, Type keyType, string payload, Func<string, Object> assetResolver, out object key, out string error)

Section titled “TryMaterialize(BehaviorDeclaredValueKind kind, Type keyType, string payload, Func<string, Object> assetResolver, out object key, out string error)”
C#
public static bool TryMaterialize(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, string payload, System.Func<string, UnityEngine.Object> assetResolver, out object key, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1104-1135

Materializes one saved key with project-asset lookup available to inline customer classes that contain asset or interface fields.

TryMaterialize(BehaviorDeclaredValueKind kind, Type keyType, string payload, out object key, out string error)

Section titled “TryMaterialize(BehaviorDeclaredValueKind kind, Type keyType, string payload, out object key, out string error)”
C#
public static bool TryMaterialize(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, string payload, out object key, out string error)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1090-1098

Materializes one saved key payload as its exact declared key type. An asset or interface key materializes as its stable asset identity, because asset identity is what that key compares by.

Category: Source authoring

C#
readonly struct BitQuirky.Behavior.Authoring.BehaviorDictionaryKeySeed

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1334-1360

The seed one Add entry will use, stated before the action (``).

Responsibilities:

  • Carry the exact key payload the next entry will hold, or say why no unique key can be computed, distinguishing a key space with no computable successor from one that holds no unused value at all.

Does NOT:

  • Add the entry; the edit command owns that undo step.

C#
public string Description { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1359

Gets the readable statement of the seed, shown before the action.

C#
public bool HasSeed { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1347

Gets whether a unique key was computed.

C#
public string KeyPayload { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1350

Gets the exact canonical key payload the next entry will hold.

C#
public bool SpaceExhausted { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1356

Gets whether the declared key type’s space holds no unused value. Add entry is unavailable only in this state.

BehaviorDictionaryKeySeed(bool hasSeed, string keyPayload, bool spaceExhausted, string description)

Section titled “BehaviorDictionaryKeySeed(bool hasSeed, string keyPayload, bool spaceExhausted, string description)”
C#
public BehaviorDictionaryKeySeed(bool hasSeed, string keyPayload, bool spaceExhausted, string description)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1337-1344

Creates one computed seed verdict.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorDictionaryKeySeeder

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1375-1956

Computes the deterministic key one Add entry will seed (``).

Responsibilities:

  • Walk the declared key type’s own value space in one fixed order, fill every unused value before reporting exhaustion, and state the seed before the action.
  • Report a key type with no computable successor separately from an exhausted key space, so Add entry still creates one real entry with a required key and a default value.

Does NOT:

  • Invent a key that already exists, reorder authored entries, or make Add entry unavailable for any reason other than an exhausted key space.

BuildSeededEntry(BehaviorDictionaryKeySeed seed, string valueDefaultPayload, int sourceLine)

Section titled “BuildSeededEntry(BehaviorDictionaryKeySeed seed, string valueDefaultPayload, int sourceLine)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry BuildSeededEntry(BitQuirky.Behavior.Authoring.BehaviorDictionaryKeySeed seed, string valueDefaultPayload, int sourceLine)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1448-1467

Builds the one real entry Add entry creates: the computed key when there is one, and otherwise a required key the author completes, always beside a default value.

ComputeNextKey(BehaviorDeclaredValueKind kind, Type keyType, IReadOnlyList<BehaviorSourceDictionaryEntry> entries)

Section titled “ComputeNextKey(BehaviorDeclaredValueKind kind, Type keyType, IReadOnlyList<BehaviorSourceDictionaryEntry> entries)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDictionaryKeySeed ComputeNextKey(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry> entries)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1390-1396

Computes the next unique key for one dictionary’s declared key type, given its authored entries. Entries whose keys are uncommitted, null or unreadable take part in nothing: they neither reserve a value nor block the seed.

ComputeNextKey(BehaviorDeclaredValueKind kind, Type keyType, IReadOnlyList<BehaviorSourceDictionaryEntry> entries, string variableName)

Section titled “ComputeNextKey(BehaviorDeclaredValueKind kind, Type keyType, IReadOnlyList<BehaviorSourceDictionaryEntry> entries, string variableName)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorDictionaryKeySeed ComputeNextKey(BitQuirky.Behavior.Authoring.BehaviorDeclaredValueKind kind, System.Type keyType, System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry> entries, string variableName)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:1404-1442

Computes the next unique key with the declaring variable’s own name available to the text seed: a dictionary with no committed string key yet seeds the variable’s own naming run (pace_by_sector seeds sector_1), and entries whose keys carry no common run fall back to the key_1, key_2 run.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorLoadResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:59-115

Outcome of a behavior load. On success,Artifactis non-null and the caller owns its native memory. On failure, the artifact is null andDiagnosticscontains parse or bake errors.

C#
public string AddressableKey { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:76

Source key the load was issued for. The property keeps its original name for public API compatibility.

C#
public BitQuirky.Behavior.Baked.BakedBehaviorArtifact Artifact { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:62

The baked artifact this load produced, or null when the load failed; the caller owns its native memory and must dispose it.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> Diagnostics { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:70

Parse diagnostics followed by bake diagnostics, each group in the order it was produced.

C#
public bool HasErrors { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:101-114

Whether any retained diagnostic has error severity, meaning the load produced no usable artifact.

C#
public string SourceContentHash { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:84

SHA-256 hex of the Mermaid source text used for this bake. Empty when the load failed before hashing or when constructed via failure helpers. Callers that cache artifacts can store this and pass it to BakeFromTextIfFresh.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Baked.BakedBehaviorArtifact> SubgraphArtifacts { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:68

Legacy compatibility view. Resolved subgraphs are now inlined into Artifact, so this collection is always empty.

C#
public bool Success { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:95

Whether an artifact was produced and no retained diagnostic has error severity.

C#
public bool UsedDefaultBakeOptions { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:92

True when the artifact was baked without caller-supplied BehaviorBakeOptions. Only these bakes are reusable by BakeFromTextIfFreshbecause explicit options can change artifact contents independently of source text.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorMemberBlackboardNaming

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:2004-2473

Deterministic automatic blackboard naming for member bindings.

Responsibilities:

  • Derive each projected entry’s canonical unqualified name, apply valid author overrides, prefix every member of a colliding group with the target identifier, and report residual collisions for rejection.

Does NOT:

  • Append numeric suffixes, truncate names, or build blackboard layout.

CollectDeclaredAccessNeeds(BehaviorSourceMemberBinding binding, string projectedName)

Section titled “CollectDeclaredAccessNeeds(BehaviorSourceMemberBinding binding, string projectedName)”
C#
public static System.Collections.Generic.IEnumerable<BitQuirky.Behavior.Authoring.BehaviorSourceMemberDeclaredAccessNeed> CollectDeclaredAccessNeeds(BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding binding, string projectedName)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:2059-2150

Enumerates every declared-value read or write needbinding’s own authored references, comparison right operand, and result projection place on its owning node. This is the single authority both ValidateMemberDeclaredValueAccessand the editor’s EditMemberBindingCommandcommit choke point consult, so a form that projects a blackboard write exactly asBehaviorMemberProviderGeneratoremits it - Outcome, BehaviorStatus, or Awaitable’s authored destination, not only the Blackboard form a narrower inline check once covered - can never again silently skip the node’s read=/write= access gate (, finding D2). Covers: a blackboard-mode target, each Blackboard-sourced argument and expanded/array params value, and a comparison’s blackboard right operand (read); each ref parameter’s effective write destination resolved throughBehaviorSourceMemberRefBindingexactly as bake and validation do, each non-ref output argument’s destination, and a method result that projects a write via its authored destination under the Blackboard, Outcome, BehaviorStatus, or Awaitable form (write); and, when projectedNamenames a declared value, an explicitly overridden property or field projection:to-blackboard writes it, to-memberreads it, andtwo-way is both. projectedNameis the caller’s own cross-binding collision result (DeriveNames); this per-binding rule never recomputes it. Yields nothing for a node-less (blackboard-authored) binding: it carries no node read/write set of its own.

DeriveNames(IReadOnlyList<BehaviorSourceMemberBinding> bindings, IReadOnlyDictionary<string, BehaviorSourceTypeIdentity> declaredVariableTypes, BehaviorMemberConverterRegistry registry, out List<string> residualCollisionBindingIds)

Section titled “DeriveNames(IReadOnlyList<BehaviorSourceMemberBinding> bindings, IReadOnlyDictionary<string, BehaviorSourceTypeIdentity> declaredVariableTypes, BehaviorMemberConverterRegistry registry, out List<string> residualCollisionBindingIds)”
C#
public static System.Collections.Generic.IReadOnlyDictionary<string, string> DeriveNames(System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding> bindings, System.Collections.Generic.IReadOnlyDictionary<string, BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity> declaredVariableTypes, BitQuirky.Behavior.Member.BehaviorMemberConverterRegistry registry, out System.Collections.Generic.List<string> residualCollisionBindingIds)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:2206-2315

Resolves declared-value aliases using the same registered converters as binding validation. A project-specific converter may therefore project directly into a declared value without creating a second blackboard slot.

DeriveNames(IReadOnlyList<BehaviorSourceMemberBinding> bindings, IReadOnlyDictionary<string, BehaviorSourceTypeIdentity> declaredVariableTypes, out List<string> residualCollisionBindingIds)

Section titled “DeriveNames(IReadOnlyList<BehaviorSourceMemberBinding> bindings, IReadOnlyDictionary<string, BehaviorSourceTypeIdentity> declaredVariableTypes, out List<string> residualCollisionBindingIds)”
C#
public static System.Collections.Generic.IReadOnlyDictionary<string, string> DeriveNames(System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding> bindings, System.Collections.Generic.IReadOnlyDictionary<string, BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity> declaredVariableTypes, out System.Collections.Generic.List<string> residualCollisionBindingIds)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:2192-2199

Computes names against declared values. An explicitly named, compatible member read or write may use its declared value’s own name. One read plus one write may share it when both conversion directions are independently supported. Unrelated or incompatible collisions remain prefixed.

DeriveNames(IReadOnlyList<BehaviorSourceMemberBinding> bindings, out List<string> residualCollisionBindingIds)

Section titled “DeriveNames(IReadOnlyList<BehaviorSourceMemberBinding> bindings, out List<string> residualCollisionBindingIds)”
C#
public static System.Collections.Generic.IReadOnlyDictionary<string, string> DeriveNames(System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding> bindings, out System.Collections.Generic.List<string> residualCollisionBindingIds)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:2179-2184

Computes the canonical projected name for every projecting binding in order. Names follow the fixed algorithm: exact member identifier for property and field bindings, lower-camel method identifier for method results, valid author override wins, every member of a group that shares an unqualified name gains the <targetLowerCamelIdentifier>.prefix, and residual collisions are returned for rejection instead of being suffixed.

Projects(BehaviorSourceMemberBinding binding)

Section titled “Projects(BehaviorSourceMemberBinding binding)”
C#
public static bool Projects(BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding binding)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:2012-2034

Returns whether the binding projects a blackboard entry: every property and field binding, and every method binding with a blackboard result.

C#
public static string ToLowerCamel(string identifier)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:2318-2341

Converts an exact C# identifier to its lower-camel spelling.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorRandomSelectorDirectFailureSource

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorRandomSelectorDirectFailureSource.cs:22-86

The one reading of a Random Selector’s optional Direct failure weight shared by source validation, bake, editor authoring, and every editor surface.

Responsibilities:

  • Report whether the outcome is present on a node at all, which is what separates an absent outcome from a present zero.
  • Decide whether the saved text is a usable finite weight of zero or greater, and hand back the parsed value without ever coercing, clearing, or defaulting the text.

Does NOT:

  • Mutate a node, format a readout, or decide how an unusable weight is presented.

ResolveDrawWeight(BehaviorSourceNode node)

Section titled “ResolveDrawWeight(BehaviorSourceNode node)”
C#
public static float ResolveDrawWeight(BitQuirky.Behavior.Authoring.BehaviorSourceNode node)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorRandomSelectorDirectFailureSource.cs:79-85

Returns the Direct failure weight this node contributes to a draw: zero when the outcome is absent, zero when its saved text is unusable, and the authored value otherwise. Only a value greater than zero can ever be drawn.

TryParseUsableWeight(string savedText, out float weight)

Section titled “TryParseUsableWeight(string savedText, out float weight)”
C#
public static bool TryParseUsableWeight(string savedText, out float weight)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorRandomSelectorDirectFailureSource.cs:56-72

Returns whether saved text is a usable Direct failure weight: a finite number zero or greater. Empty, nonnumeric, negative, and non-finite text are all unusable and keep their exact saved form for the author to repair.

TryReadSavedText(BehaviorSourceNode node, out string savedText)

Section titled “TryReadSavedText(BehaviorSourceNode node, out string savedText)”
C#
public static bool TryReadSavedText(BitQuirky.Behavior.Authoring.BehaviorSourceNode node, out string savedText)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorRandomSelectorDirectFailureSource.cs:29-49

Reads the node’s saved Direct failure weight text. Returns false when the outcome is absent; an emptysavedTextwith a true result is a present outcome whose weight the author cleared.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceActiveUpdateSource

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:176-186

Underlying type: byte

Explicit source selected for a state’s Active Update lifecycle.

C#
Actions = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:182

The state’s Active Update action list is active.

C#
BehaviorTree = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:185

The state’s non-action hosted behavior-tree root is active.

C#
Unspecified = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:179

No explicit source was authored, so legacy topology decides.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceAst

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1235-1298

Semantic AST extracted from the document. The bake step consumes this.

C#
public string BehaviorVersion { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1238

The author-controlled graph version from the %% behavior-version: header, independent of SourceFormat.

C#
public System.Collections.Generic.List<string> DeclaredFieldOrder { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1260

The declared field names in first-declaration order with repeats dropped. The baker starts the baked field table from this list in this order, so a declared field’s position here is its index in that table; variable-record values follow it.

C#
public System.Collections.Generic.Dictionary<string, BitQuirky.Behavior.Authoring.BehaviorSourceFieldType> DeclaredFieldTypes { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1264-1265

Declared non-default field types by field name; a declared field absent from this map bakes as Int32 unless a member binding supplies its type.

C#
public System.Collections.Generic.HashSet<string> DeclaredFields { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1256

Every declared blackboard field name, for ordinal membership tests; DeclaredFieldOrder holds the same names in authored order.

C#
public System.Collections.Generic.List<string> DeclaredServiceOrder { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1262

The declared external service ids in first-declaration order with repeats dropped. The baker starts the baked service table from this list in this order, so a declared service’s position here is its index in that table.

C#
public System.Collections.Generic.HashSet<string> DeclaredServices { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1258

Every declared external service id, for ordinal membership tests; DeclaredServiceOrder holds the same ids in authored order.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue> DeclaredValues { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1272

Gets every declared blackboard value in author order: authoritative format 1.3 variable records followed by the in-memory projection of legacy format 1.0 through 1.2 field declarations.

C#
public System.Collections.Generic.Dictionary<string, BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue> DeclaredValuesByName { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1275-1276

Gets the declared values addressed by their exact declared name.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceEdge> Edges { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1288

Every authored edge in source order.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding> GraphMemberBindings { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1297

Gets the graph-level blackboard-authored member bindings.

C#
public string Layer { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1240

The layer token from the %% layer: header; a behavior source declares behavior.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding> MemberBindings { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1294

Gets every member binding in the source: node-owned bindings in node order followed by graph-level blackboard-authored bindings sorted by stable binding id.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceNode> Nodes { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1286

Every authored node in source order. This is authoring order only: the baker assigns its own baked node indices and keeps a separate source-to-baked mapping.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceRuntimePath RuntimePath { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1253-1254

Gets or sets the object model this graph bakes for. GameObject is the default, so a source that never declares a Runtime path is a GameObject-path graph and its bytes are unchanged.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceFormatVersion SourceFormat { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1242-1243

Gets or sets the source format projected from the document header.

C#
public string ValidationProfile { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1246

Gets or sets the explicit consumer validation-profile token.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceAuthority

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:20-33

Underlying type: int

Authority context declared on a behavior source node. MirrorsAuthorityKindconceptually but lives at authoring layer where has not yet been defined; values are kept in lock-step intentionally.

C#
ClientPresentation = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:29

The node may run on a client instance for presentation only.

C#
EditorTestOnly = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:32

The node may run only in editor tests, never in a shipped session.

C#
HostAuthoritative = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:26

The node may run only on the authoritative host instance.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:23

No authority was authored on the node; the bake refuses it.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceBlackboardMemberBinding

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1445-1467

The graph-level blackboard projection of one member binding.

Responsibilities:

  • Carry the canonical projected name, value kind, direction, synchronization, exact notification identity, and origin consumed by the blackboard panel and runtime synchronization.

Does NOT:

  • Act as a separate manual variable declaration; it is projected deterministically from the member binding before blackboard layout is built.

C#
public string BindingId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1448

Gets or sets the stable identifier of the owning member binding.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberDirection Direction { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1457

Gets or sets the synchronization direction.

C#
public string Name { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1451

Gets or sets the canonical unique blackboard name.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberNotification NotificationIdentity { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1463

Gets or sets the exact notification event identity, when authored.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberBindingOrigin Origin { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1466

Gets or sets whether the binding was authored on a node or the blackboard.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberSynchronization Synchronization { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1460

Gets or sets the synchronization mode flags.

C#
public BitQuirky.Behavior.Member.BehaviorMemberValueKind ValueKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1454

Gets or sets the projected value kind.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceBlankLineBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1141-1143

Inherits: BehaviorSourceDocumentBlock

One blank line in the authored document, recorded so the writer can reproduce the author’s vertical spacing. Spacing is normalized rather than copied verbatim: the writer drops blank lines that precede the first emitted line and collapses a run of them into a single blank line.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceComparisonOperator

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:191-213

Underlying type: int

Authored comparison operator for a typed transition predicate.

C#
Equal = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:203

Holds when both operands compare equal. Source token ==.

C#
GreaterThan = 6

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:212

Holds when the left field is strictly above the right operand. Source token >.

C#
GreaterThanOrEqual = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:209

Holds when the left field is at or above the right operand. Source token >=.

C#
LessThan = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:197

Holds when the left field is strictly below the right operand. Source token <.

C#
LessThanOrEqual = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:200

Holds when the left field is at or below the right operand. Source token <=.

C#
NotEqual = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:206

Holds when the operands do not compare equal. Source token !=.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:194

No operator was authored; the predicate is rejected by validation.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceCompositionResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:27-51

Managed source composition shared by baking and typed provider generation.

Responsibilities:

  • Retain the resolved, mutable source AST and its composition diagnostics.
  • Report whether composition produced an AST without error diagnostics.

Does NOT:

  • Own native allocations or require disposal.
  • Bake or execute the AST, or persist caller changes to source assets.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceAst Ast { get; internal set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:30

The resolved source AST retained by this result; null when no AST was produced.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> Diagnostics { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:32

Composition diagnostics retained by this result in discovery order.

C#
public bool HasErrors { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:37-50

Whether any retained diagnostic has error severity.

C#
public bool Success { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:34

Whether an AST is present and no retained diagnostic has error severity.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredElement

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:64-78

One ordered element of a declared list or array value.

Responsibilities:

  • Carry the exact canonical payload text of one element in authored order.

Does NOT:

  • Interpret the payload; the codec parses it against the declared element type.

C#
public string Payload { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:74

Gets the exact canonical payload text of the element.

C#
public int SourceLine { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:77

Gets the one-based source line the element was written on.

BehaviorSourceDeclaredElement(string payload, int sourceLine)

Section titled “BehaviorSourceDeclaredElement(string payload, int sourceLine)”
C#
public BehaviorSourceDeclaredElement(string payload, int sourceLine)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:67-71

Creates one ordered element carrying its exact canonical payload.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:134-324

One graph-scoped authored blackboard variable, as saved in canonical format 1.3 text.

Responsibilities:

  • Own the declared name, the exact element type identity, the key type identity of a dictionary, the declared shape, and the exact canonical payload in authored order.
  • Retain an invalid authored payload verbatim so a fault never discards what the author typed.

Does NOT:

C#
public string CanonicalValue { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:219

Gets or sets the exact canonical payload of a single-shape value, including the explicitnonetoken for a reference with no object. Collection shapes carry their payload inElements or Entries.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity ConcreteValueType { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:155

Gets or sets the exact concrete type identity of a polymorphic managed value, when the saved value’s concrete type differs from the declared type.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity DeclaredType { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:143

Gets or sets the exact element type identity. For a dictionary this is its value type; for every shape it is the element type, never a constructed generic or array spelling.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredElement> Elements { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:228

Gets the ordered elements of a list or array value.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry> Entries { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:231

Gets the ordered entries of a dictionary value.

C#
public bool HasKeyType { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:250

Gets whether the declared shape carries a key type identity.

C#
public bool HasRecursiveShape { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:167-186

Gets whether this declaration uses recursive shape metadata.

C#
public bool IsCollection { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:253

Gets whether the declared shape holds more than one value.

C#
public bool IsNoneCollection { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:225

Gets whether a collection shape saved the explicitnonetoken rather than a sequence. A dictionary with none and a dictionary with zero entries stay distinct.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity KeyType { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:149

Gets or sets the exact key type identity. Present only when Shape is Dictionary.

C#
public string Name { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:137

Gets or sets the stable declared name nodes reference.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValueOrigin Origin { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:237-238

Gets or sets which declaration form this value came from.

C#
public bool RecordsKeyTypeAssembly { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:247

Gets whether a dictionary record wrote its own key-type assembly.

C#
public bool RecordsTypeAssembly { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:244

Gets whether the record wrote its own type assembly. A record without one is legal input and is the one case that may need confirmation on open.

C#
public BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShape Shape { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:158

Gets or sets the declared shape.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShapeLevel> ShapeLevels { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:164

Gets the collection levels from outermost to innermost. An empty list preserves the legacy one-level projection carried byShape and KeyType.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:234

Gets or sets the one-based source line of the variable record.

C#
public string BuildCanonicalIdentity()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:260-323

Builds the deterministic canonical identity string hashed into the declared value’s semantic hash. Name, ordering, complete type identities, concrete value type, shape, and the exact payload in authored order all participate.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorDeclaredValueShapeLevel> GetEffectiveShapeLevels()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:192-212

Gets the authored collection levels. Legacy single-level records project their root shape and key without mutating the source model.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValueBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1217-1221

Inherits: BehaviorSourceDocumentBlock

Document block owning the authoritative format 1.3 declared-value records.

Responsibilities:

  • Anchor the canonical position where the writer emits the variable block, preserving author order exactly as it was read.

Does NOT:

  • Own legacy field declarations, which keep their own blocks and project in memory only.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValue> Values { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1220

Gets the declared variables emitted at this position, in author order.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceDeclaredValueOrigin

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:23-30

Underlying type: byte

Which legacy declaration a projected declared value came from.

Responsibilities:

  • Mark a value the reader projected from a format 1.0 through 1.2 field declaration, so the writer never emits a duplicate record for it.

Does NOT:

  • Appear on a record authored as format 1.3.

C#
LegacyFieldDeclaration = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:29

Projected from a legacy %% fields: declaration.

C#
VariableRecord = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:26

Authored as a format 1.3 variable record.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceDiagramDeclBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1129-1133

Inherits: BehaviorSourceDocumentBlock

The Mermaid diagram declaration line, such asflowchart TD. The line is optional: Mermaid renderers want it and the bake ignores it. The writer emits RawLineback unchanged, so a read followed by a write preserves the author’s exact text apart from the trailing whitespace the reader already removed.

C#
public string RawLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1132

The declaration line exactly as authored, indent included, with trailing whitespace already removed.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryEntry

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:90-119

One ordered dictionary entry: its key state, exact key payload, and exact value payload.

Responsibilities:

  • Preserve the author’s saved key and value verbatim in authored order, including the two reserved marker key states, so nothing is sorted, merged, or repaired on open.

Does NOT:

  • Decide key equality or uniqueness; the resolver applies the declared key type’s rules.

C#
public string KeyPayload { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:112

Gets the exact saved key payload of a committed key, or the empty string for a reserved marker state, whose spelling the writer reproduces from the state.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryKeyState KeyState { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:106

Gets the saved key state.

C#
public int SourceLine { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:118

Gets the one-based source line the entry was written on.

C#
public string ValuePayload { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:115

Gets the exact saved value payload.

BehaviorSourceDictionaryEntry(BehaviorSourceDictionaryKeyState keyState, string keyPayload, string valuePayload, int sourceLine)

Section titled “BehaviorSourceDictionaryEntry(BehaviorSourceDictionaryKeyState keyState, string keyPayload, string valuePayload, int sourceLine)”
C#
public BehaviorSourceDictionaryEntry(BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryKeyState keyState, string keyPayload, string valuePayload, int sourceLine)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:93-103

Creates one ordered dictionary entry.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceDictionaryKeyState

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:43-53

Underlying type: byte

The state of one saved dictionary key: an ordinary committed key, an uncommitted key that is still required, or a saved null key that is invalid.

Responsibilities:

  • Keep the two reserved marker states distinct from a committed key and from a key whose saved spelling is not valid for the declared key type.

Does NOT:

  • Repair a key. Every state retains the author’s saved text verbatim.

C#
Committed = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:46

A key the author committed, written as a value of the declared key type.

C#
Null = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:52

The reserved <none> marker: invalid, red, never written by the editor.

C#
Unset = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceDeclaredValue.cs:49

The reserved <unset> marker: required, amber, nothing wrong yet.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceDocument

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1226-1230

Round-trip-preserving document model.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDocumentBlock> Blocks { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1229

Every block of the document in source order; the writer walks this list to produce the output text.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceDocumentBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1016-1020

One block in the authored document: a header line, the diagram-decl line, a node block (metadata + layout + node-line), an edge line, a blank line, or a passthrough comment. The writer iterates blocks in order to produce normalized output.

C#
public int LineNumber { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1019

One-based line this block occupied in the source it was read from; zero for a block built in memory. The writer emits blocks in list order and ignores this value.

BehaviorSourceDormantTransitionConditionCodec

Section titled “BehaviorSourceDormantTransitionConditionCodec”

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceDormantTransitionConditionCodec

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:836-1008

Deterministic source codec for a predicate group made dormant by an Event trigger.

Responsibilities:

  • Preserve group mode, predicate list order, fields, operators, literals, right operand kind, right field identity, and source order.
  • Reject malformed payloads without returning a partial group.
  • Stay byte-for-byte compatible: a group whose every right operand is a constant encodes in the original four-column layout, and both layouts decode.

Does NOT:

  • Decide whether a predicate group is active or validate its referenced fields.

Encode(BehaviorSourceTransitionConditionGroup group)

Section titled “Encode(BehaviorSourceTransitionConditionGroup group)”
C#
public static string Encode(BitQuirky.Behavior.Authoring.BehaviorSourceTransitionConditionGroup group)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:844-890

Encodes one complete condition group as a parameter-safe token.

TryDecode(string encoded, out BehaviorSourceTransitionConditionGroup group)

Section titled “TryDecode(string encoded, out BehaviorSourceTransitionConditionGroup group)”
C#
public static bool TryDecode(string encoded, out BitQuirky.Behavior.Authoring.BehaviorSourceTransitionConditionGroup group)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:893-988

Decodes one complete condition group, or returns false for malformed text.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceEdge

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:610-662

Semantic view of one authored edge between nodes.

C#
public bool BranchDisabled { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:632

Gets or sets whether this Random Selector branch is switched off. A switched-off branch keeps its authored weight but leaves the candidate set, the first-pick denominator, and the no-pick rule. Absent from source means enabled.

C#
public string HostedResultEventId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:625

Gets or sets the optional hosted result event consumed by this edge.

C#
public string Label { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:617

The trimmed text between the edge’s | bars exactly as authored; the branch weight, condition group and hosted result event are all parsed out of it.

C#
public string SourceId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:613

Authored id of the node the edge leaves; it names a node id, not a position in Nodes.

C#
public int SourceLineNumber { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:619

One-based source line of the edge line.

C#
public string TargetId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:615

Authored id of the node the edge enters; it names a node id, not a position in Nodes.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTransitionConditionGroup TransitionConditionGroup { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:623

The all: or any: predicate group guarding this transition; null when the label authors no condition group.

C#
public string UnusableWeightText { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:639

Gets or sets the authored weight text kept verbatim when it cannot be used. Empty, nonnumeric, negative, and non-finite text is preserved here rather than coerced or cleared, so the author’s intent survives save and reopen.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceUtilityAggregation? UtilityAggregation { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:654

Gets or sets how more than one consideration combines into this branch’s score; null when the label authored noaggregation:token. Required when UtilityConsiderationshas more than one entry; ignored (single value) when it has exactly one.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceUtilityConsideration> UtilityConsiderations { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:646

Gets the ordered Utility Selector considerations authored on this branch edge; empty when the edge authors noconsiderations:label. Each consideration names one declared field and, optionally, a curve sampling that field’s value.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceUtilityExecutionMode UtilityExecutionMode { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:661

Gets or sets whether this branch, while running, finishes before re-choosing or is compared against rivals every tick; defaults toFinishFirst when the label authors noexecution_mode:token (research D-R4).

C#
public float? Weight { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:621

The usable Random Selector branch weight; null when the label authored none, or when it authored text the runtime cannot use, which is kept verbatim in UnusableWeightText instead.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceEdgeBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1181-1189

Inherits: BehaviorSourceDocumentBlock

One authored edge line. The writer rebuilds the line fromEdgerather than copying source text, reusingIndent and ArrowTokenso the author’s indentation and arrow spelling survive a read/write round trip while the label is re-emitted in canonical form.

C#
public string ArrowToken { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1188

The arrow spelling as authored, --> or ->; the writer substitutes --> when it is empty.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceEdge Edge { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1184

The semantic view of this edge; the same instance is listed in Edges.

C#
public string Indent { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1186

The leading whitespace of the edge line, emitted ahead of the rebuilt line.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceFieldDeclarationBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1097-1101

Inherits: BehaviorSourceDocumentBlock

Document block declaring blackboard/context field ids that nodes may reference from read and write metadata.

C#
public System.Collections.Generic.IReadOnlyList<string> FieldIds { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1100

The field ids listed on this one %% fields: line, in authored order. A source may carry several such lines; DeclaredFieldOrder is their de-duplicated union.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceFieldType

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:134-144

Underlying type: int

Canonical scalar field types supported by behavior source declarations.

C#
Bool = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:143

A boolean field. Source type token bool.

C#
Float32 = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:140

An IEEE 754 single-precision field. Source type token float32.

C#
Int32 = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:137

A signed 32-bit integer field. Source type token int32.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceFieldTypeDeclarationBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1106-1111

Inherits: BehaviorSourceDocumentBlock

Document block declaring non-default blackboard field types.

C#
public System.Collections.Generic.IReadOnlyList<System.Collections.Generic.KeyValuePair<string, BitQuirky.Behavior.Authoring.BehaviorSourceFieldType>> FieldTypes { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1109-1110

The field=type pairs on this one %% field-types: line, in authored order; malformed, unknown and duplicate entries are reported and left out. A declared field with no entry bakes as Int32.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceFormatBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1056-1060

Inherits: BehaviorSourceDocumentBlock

Additive source-format header block.

Responsibilities:

  • Preserve the parsed canonical source-format version in document order.

Does NOT:

  • Replace the independent author-controlled behavior version.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceFormatVersion Version { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1059

Gets or sets the parsed additive source-format version.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceFormatTokens

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:343-383

Canonical header tokens for every additive behavior-source format version.

Responsibilities:

  • Own the one spelling of each %% source-format: token used by the reader, the writer, the importer, and diagnostics.

Does NOT:

  • Decide which version a document requires or validate its records.

C#
public const string Format10 = "bitquirky.behavior/1.0"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:346

Header token written as %% source-format: bitquirky.behavior/1.0, selecting Format10.

C#
public const string Format11 = "bitquirky.behavior/1.1"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:348

Header token written as %% source-format: bitquirky.behavior/1.1, selecting Format11.

C#
public const string Format12 = "bitquirky.behavior/1.2"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:350

Header token written as %% source-format: bitquirky.behavior/1.2, selecting Format12.

C#
public const string Format13 = "bitquirky.behavior/1.3"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:352

Header token written as %% source-format: bitquirky.behavior/1.3, selecting Format13.

C#
public const string Format14 = "bitquirky.behavior/1.4"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:354

Header token written as %% source-format: bitquirky.behavior/1.4, selecting Format14.

C#
public const string Format15 = "bitquirky.behavior/1.5"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:356

Header token written as %% source-format: bitquirky.behavior/1.5, selecting Format15.

C#
public const string Format16 = "bitquirky.behavior/1.6"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:358

Header token written as %% source-format: bitquirky.behavior/1.6, selecting Format16.

C#
public const string Format17 = "bitquirky.behavior/1.7"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:360

Header token written as %% source-format: bitquirky.behavior/1.7, selecting Format17.

C#
public const string Format18 = "bitquirky.behavior/1.8"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:362

Header token written as %% source-format: bitquirky.behavior/1.8, selecting Format18.

C#
public const string Format19 = "bitquirky.behavior/1.9"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:364

Header token written as %% source-format: bitquirky.behavior/1.9, selecting Format19.

Token(BehaviorSourceFormatVersion version)

Section titled “Token(BehaviorSourceFormatVersion version)”
C#
public static string Token(BitQuirky.Behavior.Authoring.BehaviorSourceFormatVersion version)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:367-382

Resolves the canonical header token for one format version.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceFormatVersion

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:275-331

Underlying type: byte

Additive canonical behavior-source format version.

Responsibilities:

  • Distinguish legacy sources from sources carrying semantic parameters.

Does NOT:

  • Replace the author-controlled behavior version.

C#
Format10 = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:278

Legacy source without semantic node parameter blocks.

C#
Format11 = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:281

Additive source with typed semantic node parameter blocks.

C#
Format12 = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:284

Additive source with dedicated member-binding records .

C#
Format13 = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:291

Additive source with blackboard-variable member targets and the authoritative declared-value variable records of . Accepts every valid 1.2 member record unchanged.

C#
Format14 = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:297

Additive source with exact open generic method definitions and arity-aligned optional concrete choices . Accepts every valid earlier source unchanged.

C#
Format15 = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:303

Additive source with explicit action-state lifecycle phases and phase-specific group settings . Accepts every valid earlier source unchanged.

C#
Format16 = 6

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:309

Additive source with exact method parameter names and the explicit Declared default parameter source . Accepts every valid earlier source unchanged.

C#
Format17 = 7

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:316

Additive source with explicit named output-only parameter arguments and their declared blackboard destinations . Accepts every valid earlier source unchanged.

C#
Format18 = 8

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:323

Additive source with expanded individual params element values, their ordered call positions, and the active params input form . Accepts every valid earlier source unchanged.

C#
Format19 = 9

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:330

Additive source with argument-level member-binding references: a member-argument row whose source is a sibling binding on the same node. Accepts every valid earlier source unchanged.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceGraphMemberBindingsBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1201-1205

Inherits: BehaviorSourceDocumentBlock

Document block owning the graph-level blackboard-authored member bindings.

Responsibilities:

  • Anchor the canonical position where the writer emits graph-level member records, sorted by stable binding id.

Does NOT:

  • Own node-attached member bindings; those live on their node blocks.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding> Bindings { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1204

Gets the graph-level member bindings emitted at this position.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceHeaderLayerBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1041-1045

Inherits: BehaviorSourceDocumentBlock

The%% layer:header line, which declares what kind of source the file is. The writer re-emits the line fromLayerin canonical form, so the authored token survives a read/write round trip while its surrounding spacing is normalized. This is also the line after which the writer inserts a missing source-format or runtime-path header when the document now needs one.

C#
public string Layer { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1044

The layer token exactly as authored; a Layer 2 behavior source declares behavior, and any other token is reported as a wrong-layer error.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceHeaderVersionBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1028-1032

Inherits: BehaviorSourceDocumentBlock

The%% behavior-version:header line, which carries the author-controlled version of the graph itself. The writer re-emits the line fromVersionin canonical form, so the authored token survives a read/write round trip while its surrounding spacing is normalized.

C#
public string Version { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1031

The version token exactly as authored, such as 1.0.0; the writer trims it before emitting the header.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceHostedBehaviorConfiguration

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:503-520

Additive lifecycle and terminal-result event settings for one state-hosted tree.

Responsibilities:

  • Preserve the normalized lifetime and optional Success and Failure event ids.
  • Record whether lifetime was explicit so legacy omission remains observable to tools.

Does NOT:

  • Resolve the hosted root or execute the hosted tree.

C#
public string FailureEventId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:516

Gets or sets the optional Failure result event id.

C#
public bool HasExplicitLifetime { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:510

Gets or sets whether the source explicitly declared the lifetime.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceHostedBehaviorLifetime Lifetime { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:506-507

Gets or sets the hosted lifetime. Omission defaults to Repeat.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:519

Gets or sets the one-based source line of the host parameter block.

C#
public string SuccessEventId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:513

Gets or sets the optional Success result event id.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceHostedBehaviorLifetime

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:164-171

Underlying type: byte

Authored lifetime for a behavior tree hosted by a state.

C#
Once = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:170

The hosted tree runs to completion once and then stays finished for the rest of the activation.

C#
Repeat = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:167

The hosted tree restarts from its root every time it completes while the state stays active.

BehaviorSourceHostedStateMachineParameterTokens

Section titled “BehaviorSourceHostedStateMachineParameterTokens”

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceHostedStateMachineParameterTokens

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:430-437

Canonical semantic parameter tokens authored directly on a Hosted State Machine Behavior Tree leaf (state_machine_host), naming states of the referenced machine that override its own result (FSM-013 P2).

Responsibilities:

  • Own the shared parameter spellings used by Runtime and Editor hosted-state-machine result-mapping authoring.

Does NOT:

  • Validate whether a named state exists in the referenced machine.

C#
public const string FailureState = "failure_state"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:436

The parameter naming the referenced machine’s Failure-mapped state.

C#
public const string SuccessState = "success_state"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:433

The parameter naming the referenced machine’s Success-mapped state.

Category: Source authoring

C#
readonly struct BitQuirky.Behavior.Authoring.BehaviorSourceLayoutEntry

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:446-462

One key/value pair inside a%% layout: { … }block. Authoring round-trip preserves keys verbatim; the writer normalizes the order alphabetically by key name.

C#
public string Key { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:459

The entry key exactly as authored, such as x or y, with surrounding whitespace removed.

C#
public string Value { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:461

The entry value as authored text with surrounding whitespace removed; the reader never parses it into a number.

BehaviorSourceLayoutEntry(string key, string value)

Section titled “BehaviorSourceLayoutEntry(string key, string value)”
C#
public BehaviorSourceLayoutEntry(string key, string value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:452-456

Captures one layout key and its authored value verbatim; a null argument is stored as an empty string. Neither argument is parsed or normalized.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceLoader

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:143-1336

Parses Mermaid behavior source text, runsBehaviorBaker, and returns the deterministicBakedBehaviorArtifact.

Responsibilities:

  • Parse the loaded source via Parse.
  • Bake viaBakeand return the artifact.
  • Surface parse + bake diagnostics in a single BehaviorLoadResult; refuse to return a partially baked artifact (FR-012g: runtime never silently uses stale derived data).
  • Resolve and inline nested subgraph sources through an explicit caller-provided text resolver before the single parent bake.
  • StampSourceContentHashfrom the Mermaid text for optional caller-side caches.

Does NOT:

  • Run inside a Burst job (it allocates managed memory; tick jobs MUST NOT parse Mermaid, per FR-012f).
  • Mutate the canonical .bqbehavior file (R-9).
  • Require Addressables. Optional Addressables loading lives in the separate BitQuirky.Behavior.Addressables assembly.

BakeFromText(string sourceText, string addressableKey, BehaviorBakeOptions options)

Section titled “BakeFromText(string sourceText, string addressableKey, BehaviorBakeOptions options)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorLoadResult BakeFromText(string sourceText, string addressableKey = "", BitQuirky.Behavior.Authoring.BehaviorBakeOptions options = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:265-276

Bake from in-memory Mermaid source text. Always re-bakes (behavior-tree policy: never reuse a prior artifact without an explicit cache handshake). Useful for tests, the toy graph sample, and the editor preview path.

BakeFromTextIfFresh(string sourceText, BehaviorLoadResult cachedResult, string addressableKey, BehaviorBakeOptions options)

Section titled “BakeFromTextIfFresh(string sourceText, BehaviorLoadResult cachedResult, string addressableKey, BehaviorBakeOptions options)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorLoadResult BakeFromTextIfFresh(string sourceText, BitQuirky.Behavior.Authoring.BehaviorLoadResult cachedResult, string addressableKey = "", BitQuirky.Behavior.Authoring.BehaviorBakeOptions options = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:287-313

WhencachedResultis a successful prior bake whose SourceContentHashand AddressableKeymatch the current Mermaid text and requested key, and both bakes use default options, returns that cache without re-baking or re-disposing it. Otherwise bakes fresh (same as BakeFromText). Caller remains responsible for disposing artifacts they no longer need.

BakeFromTextWithSubgraphs(string sourceText, string sourceKey, Func<string, string> sourceTextResolver, BehaviorBakeOptions options)

Section titled “BakeFromTextWithSubgraphs(string sourceText, string sourceKey, Func<string, string> sourceTextResolver, BehaviorBakeOptions options)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorLoadResult BakeFromTextWithSubgraphs(string sourceText, string sourceKey, System.Func<string, string> sourceTextResolver, BitQuirky.Behavior.Authoring.BehaviorBakeOptions options = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:194-213

Bake from in-memory source text and synchronously resolve every subgraph into the executable parent artifact.

BakeFromTextWithSubgraphsAsync(string sourceText, string addressableKey, Func<string, Task<string>> sourceTextResolver, BehaviorBakeOptions options)

Section titled “BakeFromTextWithSubgraphsAsync(string sourceText, string addressableKey, Func<string, Task<string>> sourceTextResolver, BehaviorBakeOptions options)”
C#
public static System.Threading.Tasks.Task<BitQuirky.Behavior.Authoring.BehaviorLoadResult> BakeFromTextWithSubgraphsAsync(string sourceText, string addressableKey, System.Func<string, System.Threading.Tasks.Task<string>> sourceTextResolver, BitQuirky.Behavior.Authoring.BehaviorBakeOptions options = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:220-258

Bake from in-memory source text and resolve any subgraph references throughsourceTextResolver. Always re-bakes (no cross-call cache).

ComposeFromText(string sourceText, string sourceKey, Func<string, string> sourceTextResolver)

Section titled “ComposeFromText(string sourceText, string sourceKey, Func<string, string> sourceTextResolver)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorSourceCompositionResult ComposeFromText(string sourceText, string sourceKey, System.Func<string, string> sourceTextResolver)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:148-160

Resolves the same source graph used by bake without allocating a native artifact.

ComposeFromTextAsync(string sourceText, string sourceKey, Func<string, Task<string>> sourceTextResolver)

Section titled “ComposeFromTextAsync(string sourceText, string sourceKey, Func<string, Task<string>> sourceTextResolver)”
C#
public static System.Threading.Tasks.Task<BitQuirky.Behavior.Authoring.BehaviorSourceCompositionResult> ComposeFromTextAsync(string sourceText, string sourceKey, System.Func<string, System.Threading.Tasks.Task<string>> sourceTextResolver)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceLoader.cs:163-188

Resolves nested declarations, member bindings, and machine ownership once.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberAccess

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:255-275

Underlying type: byte

Access requirements an operation places on its exact member.

C#
Add = 8

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:271

The event must accept a handler subscription. Canonical access token add.

C#
Invoke = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:262

The member must be callable. Canonical access token invoke.

C#
None = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:259

The operation requires no access at all.

C#
Read = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:265

The member’s value must be gettable. Canonical access token read.

C#
Remove = 16

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:274

The event must accept a handler removal. Canonical access token remove.

C#
Write = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:268

The member’s value must be settable. Canonical access token write.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberAgentResolve

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:210-226

Underlying type: byte

The exact agent-relative resolution shape for an agent-relative target.

C#
ChildPath = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:225

The descendant named by the target’s child path. Canonical textmode: child pluspath.

C#
Parent = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:219

The agent’s immediate parent GameObject. Canonical text mode: parent.

C#
Self = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:216

The agent GameObject running this graph. Canonical text mode: self.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:213

No agent-relative shape was authored; the target resolves to nothing.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgument

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:906-953

One ordered by-value argument of a method or message binding.

Responsibilities:

  • Pair one exact parameter type with its authored constant or blackboard source.

Does NOT:

  • Convert values; the baker validates and canonicalizes conversions.

C#
public string BindingRef { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:932

Gets or sets the sibling binding id feeding aBindingargument. The referenced binding lives on the same node and publishes the surfaced blackboard value this parameter reads.

C#
public string BlackboardName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:924

Gets or sets the blackboard field name for a blackboard argument.

C#
public string ConstantValue { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:921

Gets or sets the canonical constant literal for a constant argument.

C#
public BitQuirky.Behavior.Member.BehaviorMemberValueKind ConstantValueKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:918

Gets or sets the constant value kind for a constant argument.

C#
public int Ordinal { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:909

Gets or sets the zero-based contiguous parameter ordinal.

C#
public string OutputBlackboardName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:938

Gets or sets the blackboard destination written after a ref or out parameter returns.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity ParameterType { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:912

Gets or sets the exact parameter type identity.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgumentSource SourceKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:915

Gets or sets the argument value source.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:952

Gets the one-based source line of the argument record.

C#
public bool WriteDestinationSeparated { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:949

Gets or sets whether a ref parameter’s Write to destination is an explicit override rather than the conventional link to its own Blackboard Read source. Stored explicitly rather than inferred fromOutputBlackboardNameemptiness, so an override stays where the author put it when the Read source later changes; IsLinkedToReadSourcedecides what the legs currently share. Meaningless for an out parameter, which has no Read source to link to.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgumentSource

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:280-324

Underlying type: byte

Where a member argument value comes from.

C#
Binding = 6

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:323

The argument is fed by another member binding on the same node: the referenced sibling evaluates first and publishes its surfaced blackboard value, which this parameter then reads. Appended afterOutput; existing numeric values never move. Introduced by source format 1.9 for argument-level member bindings.

C#
Blackboard = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:295

The named blackboard entry, read at call time. Canonical text source: blackboard plus field.

C#
Constant = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:289

The authored literal itself. Canonical textsource: constantplus value-kind and value.

C#
DeclaredDefault = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:306

The parameter’s own current concrete compile-time declaration. Appended after RuntimeCancellation; existing numeric values never move. The choice carries no authored payload: canonical source stores the intent on the arity-aligned parameter record and never copies the live literal.

C#
Output = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:315

The parameter is output only: the member writes it and the graph stores it in one declared blackboard destination. Appended afterDeclaredDefault; existing numeric values never move. The row carries no input field, constant, or default payload, so it never materializes an input frame. Introduced by source format 1.7 forout parameters; refkeeps its existing read/write row.

C#
RuntimeCancellation = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:298

The runtime-owned cancellation token for the current deferred invocation.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:283

No source was authored; the argument record is rejected.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberBackendSelection

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1686-1730

Backend selection over one binding set.

Responsibilities:

  • Report whether one binding set mixes entity and GameObject target modes, naming both.

Does NOT:

  • Pick a winner, order candidates, or fall back to the first.

Classify(IReadOnlyList<BehaviorSourceMemberBinding> bindings)

Section titled “Classify(IReadOnlyList<BehaviorSourceMemberBinding> bindings)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorSourceMemberBackendVerdict Classify(System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding> bindings)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1691-1727

Classifies one binding set’s backend usage.

Category: Source authoring

C#
readonly struct BitQuirky.Behavior.Authoring.BehaviorSourceMemberBackendVerdict

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1479-1510

The verdict of backend selection over one binding set.

Responsibilities:

  • State whether one binding set mixes entity and GameObject target modes, and name both offending modes with the exact bindings that carry them.

Does NOT:

  • Choose a backend, discard a binding, or reinterpret a mode.

C#
public string EntityBindingId { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1503

Gets the binding id carrying the first entity mode found.

C#
public string EntityModeToken { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1500

Gets the canonical token of the first entity mode found.

C#
public string GameObjectBindingId { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1509

Gets the binding id carrying the first GameObject mode found.

C#
public string GameObjectModeToken { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1506

Gets the canonical token of the first GameObject mode found.

C#
public bool IsMixed { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1497

Gets whether the binding set mixes both backends.

BehaviorSourceMemberBackendVerdict(bool isMixed, string entityModeToken, string entityBindingId, string gameObjectModeToken, string gameObjectBindingId)

Section titled “BehaviorSourceMemberBackendVerdict(bool isMixed, string entityModeToken, string entityBindingId, string gameObjectModeToken, string gameObjectBindingId)”
C#
public BehaviorSourceMemberBackendVerdict(bool isMixed, string entityModeToken, string entityBindingId, string gameObjectModeToken, string gameObjectBindingId)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1482-1494

Creates one backend-selection verdict.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1108-1431

One authored member binding attached to a reusable member node or created directly from the blackboard.

Responsibilities:

  • Own the exact target, identity, arguments, result, direction, comparison, event outcome, notification, and surfaced-name records of one binding.

Does NOT:

  • Infer a target, overload, access direction, return destination, event, or conversion from a same-named alternative.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgument> Arguments { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1134

Gets the ordered by-value arguments, one per selected parameter.

C#
public string BindingId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1111

Gets or sets the stable source binding identifier, unique in the graph.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberComparison Comparison { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1171

Gets or sets the comparison required by a member condition.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberDirection Direction { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1168

Gets or sets the direction of a property or field binding. Direction is the authored flow of one value; the operations a declaration actually permits live in Access, so a read-only or literal field carries read access only and can never be written.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityContainer EntityContainer { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1186

Gets or sets the exact entity container. Null for a component target and for every GameObject-path binding.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityEvent EntityEvent { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1192

Gets or sets the backend-local entity event source. Null for every binding that is not an entity-path Event Condition.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberEventMode EventMode { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1177

Gets or sets the event’s predicate or explicit-wait semantics.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberConditionResult EventOutcome { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1174

Gets or sets the behavior result of a fired event condition.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberIdentity Identity { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1131

Gets or sets the exact member identity.

C#
public string NodeId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1116

Gets or sets the owning node identifier; empty for blackboard-authored bindings.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberNotification Notification { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1180

Gets or sets the optional exact notification event identity.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberOperationKind OperationKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1125

Gets or sets the member operation family.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberBindingOrigin Origin { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1208-1211

Gets whether the binding was authored on a node or from the blackboard.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgument ParamsArrayValue { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1157

Gets or sets the one explicit array or list value used when ParamsInputForm is Array. Null until authored. Retained verbatim whileParamsInputFormis Expanded.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgument> ParamsExpandedValues { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1149

Gets the ordered individual element values used whenParamsInputFormis Expanded. Each entry’s ParameterTypeis the params parameter’s element type, never its declared array type. Retained verbatim while ParamsInputForm is Array.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberParamsInputForm ParamsInputForm { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1140

Gets or sets which payload supplies the binding’s final params parameter. Expanded is the default so a binding authored before this form existed reads unchanged.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberResult Result { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1160

Gets or sets the optional result contract.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1205

Gets the one-based source line of the binding’s first record.

C#
public string SurfacedNameOverride { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1195

Gets or sets the author override applied after automatic name derivation.

C#
public int SurfacedNameSourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1202

Gets or sets the one-based source line of the record that stores SurfacedNameOverride. Zero when no override is authored, because a derived surfaced name is computed rather than stored and so has no source coordinate.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberTarget Target { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1128

Gets or sets the exactly-one explicit target contract.

C#
public string BuildCanonicalContractIdentity()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1226-1320

Builds the canonical exact identity string hashed into the 64-bit member contract hash. The explicit-reference slot key is part of exact target identity, so two same-type assigned objects remain distinct.

A field participates on exactly the same terms as every other member kind: its declaring assembly and type, member kind, exact case-sensitive name, static state, and the read and write access its mutability allows. The declaration’s C# access level and the access path a generated provider later selects for it are derived facts, never part of this identity, so opting a declaration in, widening it to public, or moving it between direct and prepared access leaves the identity and the graph’s meaning unchanged.

BuildCanonicalEventAccessorIdentity(string prefix, string canonicalIdentity)

Section titled “BuildCanonicalEventAccessorIdentity(string prefix, string canonicalIdentity)”
C#
public string BuildCanonicalEventAccessorIdentity(string prefix, string canonicalIdentity = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1323-1329

Builds an event accessor identity with independent persistent predicate ownership.

C#
public string BuildCanonicalOperationIdentity()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1347-1382

Builds the identity of the generated operation accessor for this binding: the exact CLR contract identity plus every authored choice the emitted call body depends on. Two bindings may name the same member while embedding different code, one leaving a parameter on its declaration while the other supplies it, so the argument source kinds, the body-discriminating constant and blackboard names, the result shape, the comparison shape, and, when the declaration carries a params final parameter, the authored input form and its expanded values or array value are part of this identity while never touching the CLR contract identity or its hash. Two bindings of the same params method authored with different individual values, a different value count, or a different explicit-array choice must therefore never share a generated accessor: each embeds its own packed invocation array or array-value read, so sharing one would silently run the wrong authored call for one of them. Dense frame payloads still carry live values at evaluation time; this identity only captures what the generated method text itself embeds.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberBindingOrigin

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:454-464

Underlying type: byte

Whether a member binding was authored on a node or directly from the blackboard.

C#
Blackboard = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:463

The binding was authored directly from the blackboard and projects a member onto an entry.

C#
Node = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:460

The binding was authored on a member node and lives with that node.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:457

No origin was recorded; a binding read before normalization assigned one.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberComparison

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1025-1060

The authored comparison contract of a member condition.

Responsibilities:

  • Pair one bounded operator with a constant or blackboard right operand and the authored true and false behavior results.
  • Name, for a void method that declares ref parameters, which ref parameter’s post-call value the condition tests. That choice is authored, never inferred from declaration order.

Does NOT:

  • Permit operators outside the value kind’s supported set.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberConditionResult FalseResult { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1055-1056

Gets or sets the behavior result when the comparison does not hold.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceComparisonOperator Operator { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1028

Gets or sets the comparison operator, limited by value kind.

C#
public string RightBlackboardName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1048

Gets or sets the blackboard field name for a blackboard right operand.

C#
public string RightConstantValue { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1045

Gets or sets the canonical constant literal for a constant right operand.

C#
public BitQuirky.Behavior.Member.BehaviorMemberValueKind RightConstantValueKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1042

Gets or sets the constant value kind for a constant right operand.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgumentSource RightSourceKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1039

Gets or sets the right operand source.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1059

Gets the one-based source line of the comparison record.

C#
public int TestedParameterOrdinal { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1036

Gets or sets the zero-based ordinal of the ref parameter whose post-call value the condition tests, or -1 when the condition tests the member’s own return or value. Required on a void method that declares at least one ref parameter; a void method has no return to test, and the product never picks a parameter on the author’s behalf.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberConditionResult TrueResult { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1051-1052

Gets or sets the behavior result when the comparison holds.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberConditionResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:405-430

Underlying type: byte

Behavior result returned by a satisfied or failed member condition outcome.

C#
AuthorityMismatch = 7

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:429

The node refused to run because the executing role lacks the required authority. Canonical text authority-mismatch.

C#
Blocked = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:423

The node could not proceed because a required resource was unavailable. Canonical text blocked.

C#
Failed = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:414

The node fails. Canonical text failed; the default false result, so canonical text omits it.

C#
Interrupted = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:420

The node was cut short before it settled. Canonical text interrupted.

C#
Running = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:417

The node stays running and is evaluated again next tick. Canonical text running.

C#
Succeeded = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:411

The node succeeds. Canonical text succeeded; the default true result, so canonical text omits it.

C#
Timeout = 6

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:426

The node gave up after its authored time budget elapsed. Canonical text timeout.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:408

No result was authored; the outcome leaves the node status untouched.

Category: Source authoring

C#
readonly struct BitQuirky.Behavior.Authoring.BehaviorSourceMemberDeclaredAccessNeed

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1973-1991

One declared-value read or write need one member binding’s own authored references or result projection place on its owning node.Nameis a raw candidate: the caller, not this type, decides whether it actually names a declared graph value.

C#
public bool IsWrite { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1987

Gets whether the need is a write; a read otherwise.

C#
public int Line { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1990

Gets the one-based source line of the authored reference this need came from.

C#
public string Name { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1984

Gets the candidate declared-value name.

BehaviorSourceMemberDeclaredAccessNeed(string name, bool isWrite, int line)

Section titled “BehaviorSourceMemberDeclaredAccessNeed(string name, bool isWrite, int line)”
C#
public BehaviorSourceMemberDeclaredAccessNeed(string name, bool isWrite, int line)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1976-1981

Creates one need.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberDirection

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:387-400

Underlying type: byte

Authored synchronization direction of a property or field binding.

C#
ToBlackboard = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:393

The member’s value is copied into the blackboard. Canonical text to-blackboard.

C#
ToMember = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:396

The blackboard value is copied into the member. Canonical text to-member.

C#
TwoWay = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:399

Both copies happen, member read first. Canonical text two-way.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:390

No direction was authored; the binding moves no value. Canonical text omits the direction record.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityContainer

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:626-701

The exact container of one entity member binding, present only when the target container is a buffer.

Responsibilities:

  • Carry the exact unmanaged buffer element type and the exact entry address: a non-negative constant index, or an identity field paired with its constant or blackboard operand.

Does NOT:

  • Search for an entry, or add, remove, resize, or reorder a buffer. Its internal inline capacity is a storage-placement choice and is not part of binding validity.

C#
public string BufferElementAssemblyName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:632-636

Gets or sets the exact assembly simple name of the buffer element type.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity BufferElementType { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:673-674

Gets the exact buffer element type identity pair.

C#
public string BufferElementTypeName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:640-644

Gets or sets the exact full CLR name of the buffer element type.

C#
public int ConstantIndex { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:651

Gets or sets the authored non-negative entry index.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityContainerKind ContainerKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:629

Gets or sets the container kind. Component is the default and is omitted.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityEntrySelector EntrySelector { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:648

Gets or sets how the one exact entry is addressed.

C#
public string IdentityBlackboardName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:667

Gets or sets the blackboard field name of the identity operand.

C#
public string IdentityConstantValue { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:664

Gets or sets the canonical constant literal of the identity operand.

C#
public BitQuirky.Behavior.Member.BehaviorMemberValueKind IdentityConstantValueKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:661

Gets or sets the constant value kind of the identity operand.

C#
public string IdentityFieldName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:654

Gets or sets the exact identity field declared by the buffer element.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgumentSource IdentityValueSource { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:657-658

Gets or sets whether the identity operand is a constant or a blackboard slot.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:670

Gets the one-based source line of the container record.

C#
public string BuildCanonicalIdentity()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:677-700

Builds the canonical exact container identity text.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityContainerKind

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:143-150

Underlying type: byte

Whether an entity member binding addresses a component or one exact buffer entry.

C#
BufferElement = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:149

One exact entry of an unmanaged dynamic buffer.

C#
Component = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:146

The default; canonical text omits the container record entirely.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityEntrySelector

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:156-163

Underlying type: byte

How one exact buffer entry is addressed. First, last, any, and value-search selection are deliberately absent: which entry the node acts on is part of the authored owner.

C#
ConstantIndex = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:159

A non-negative authored constant index.

C#
IdentityField = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:162

An exact identity field declared by the buffer element.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityEvent

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:714-757

The backend-local runtime source of one entity Event Condition.

Responsibilities:

  • Name the observed enableable component and its authored polarity, or state that the source is the retained buffer entry the Target card already addresses.

Does NOT:

  • Offer a second address control, a C# event, a UnityEvent, a coroutine, or any managed subscription. The portable event choice identity stays on the shared event record.

C#
public string AssemblyName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:720-724

Gets or sets the exact assembly simple name of an enableable source.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityPolarity Polarity { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:736

Gets or sets the authored enablement state that counts as one occurrence.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityEventSourceKind SourceKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:717

Gets or sets the observed source kind.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:739

Gets the one-based source line of the entity event record.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity TypeIdentity { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:742

Gets the exact enableable type identity pair.

C#
public string TypeName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:728-732

Gets or sets the exact full CLR name of an enableable source.

C#
public string BuildCanonicalIdentity()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:745-756

Builds the canonical exact entity event source identity text.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityEventSourceKind

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:183-193

Underlying type: byte

The backend-local runtime source an entity Event Condition observes.

C#
EnableableComponent = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:189

An enableable component’s observed state.

C#
EventBufferEntry = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:192

One exact retained entity event buffer entry.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:186

No event source was authored; validation rejects the entity event record.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityHopKind

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:168-178

Underlying type: byte

The one hop a Handle target takes from its fixed base.

C#
BlackboardEntry = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:174

A surfaced blackboard entry of the entity type.

C#
ComponentField = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:177

One entity-typed field on a component of the running entity.

C#
None = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:171

No hop; every mode other than Handle.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityPolarity

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:198-205

Underlying type: byte

The authored enablement state that counts as one occurrence.

C#
Disabled = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:204

The component becoming disabled is the occurrence. Canonical text polarity: disabled.

C#
Enabled = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:201

The component becoming enabled is the occurrence. Canonical text polarity: enabled.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberEventMode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:53-59

Underlying type: byte

Controls whether an event is a current-observation predicate or an activated wait. Responsibilities: preserve legacy waits and expose ordinary event predicates. Does NOT: subscribe to events or own observation state.

C#
Predicate = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:58

Report false while quiet and true for the observation receiving an event.

C#
Wait = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:56

Wait for one event during an activation; the legacy omitted value.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberIdentity

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:777-895

The exact identity of one bound member.

Responsibilities:

  • Carry the declaring type identity, member kind and identifier, static flag, ordered exact parameter types, an optional exact open generic definition with arity-aligned choices, exact return or value type, and required access flags. For an indexer (Propertywith one or more entries in ParameterTypes), the ordered parameter fields carry the exact index- parameter shape (declaration ordinal, modifier, and type) on exactly the same terms a method identity already uses; a get, set, and member-condition operation against the same indexer share this one identity .

Does NOT:

  • Substitute a same-named member with a different signature. Does not distinguish an indexer from an ordinary scalar property by any field other than a non-empty ParameterTypes; both remain Property.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberAccess Access { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:891

Gets or sets the access flags the operation requires.

C#
public string DeclaringAssemblyName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:780-784

Gets or sets the exact assembly simple name of the declaring type.

C#
public string DeclaringTypeName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:788-792

Gets or sets the exact full non-generic declaring CLR type name.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity> GenericArguments { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:857-858

Gets or sets the exact type arguments that close a generic method. Format 1.4 keeps this list arity-aligned and uses an empty identity for an unchosen slot; legacy source retains its existing dense completed list.

C#
public int GenericArity { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:838

Gets or sets the positive declared generic arity of a format 1.4 identity. Zero means this is either non-generic or a completed legacy dense generic identity.

C#
public string GenericDefinitionSignature { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:844

Gets or sets the exact portable open ordinary-parameter and return pattern that identifies the selected generic method definition before substitution.

C#
public System.Collections.Generic.IReadOnlyList<string> GenericParameterNames { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:850

Gets or sets every declared method generic parameter name in ordinal order. Format 1.4 carries exactlyGenericArityentries.

C#
public bool HasCompleteGenericArguments { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:866-885

Gets whether every format 1.4 generic slot has a concrete identity.

C#
public bool HasGenericDefinitionIdentity { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:861-863

Gets whether this identity carries the format 1.4 open definition contract.

C#
public bool HasParameterNames { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:832

Gets whether this identity persists exact parameter names.

C#
public bool IsStatic { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:802

Gets or sets whether the member is static; must agree with the target mode.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberKind MemberKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:796

Gets or sets the CLR member category.

C#
public string MemberName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:799

Gets or sets the exact C# member identifier.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceMemberParameterModifier> ParameterModifiers { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:821-822

Gets or sets the ordered parameter modifiers:Value, In, or Paramsfor an admitted index parameter (C# Language Specification section 15.9.1;this, ref, and outare grammatically impossible on an indexer), or the full method-parameter vocabulary for a Methodidentity.

C#
public System.Collections.Generic.IReadOnlyList<string> ParameterNames { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:829

Gets or sets the ordered exact CLR parameter names persisted by format 1.6. A named identity carries one non-empty name per parameter; a legacy identity carries none. A partially named identity is invalid and the reader rejects it.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity> ParameterTypes { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:811-812

Gets or sets the ordered exact parameter type identities. For a Methodidentity these are the method’s parameters; for aPropertyidentity with one or more entries, these are an indexer’s ordered index-parameter types instead of the empty list an ordinary scalar property carries.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity ReturnOrValueType { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:888

Gets or sets the exact return, property, field, or event delegate type.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:894

Gets the one-based source line of the identity record.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberKind

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:231-250

Underlying type: byte

The CLR member category of an exact bound member.

C#
Event = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:246

A CLR event. Canonical identity text kind: event.

C#
Field = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:243

A CLR field. Canonical identity text kind: field.

C#
Method = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:237

A CLR method. Canonical identity text kind: method.

C#
Property = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:240

A CLR property. Canonical identity text kind: property.

C#
State = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:249

A synthetic state exposed by the selected backend rather than a CLR member.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:234

No member category was authored; the identity record is rejected.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberNotification

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1071-1094

The exact event identity used for authored member-to-blackboard notification.

Responsibilities:

  • Name the exact event on the target used to observe member changes.

Does NOT:

  • Subscribe or infer an event from a similar name.

C#
public string AssemblyName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1074-1078

Gets or sets the exact assembly simple name of the declaring type.

C#
public string EventName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1090

Gets or sets the exact event member identifier.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1093

Gets the one-based source line of the notification record.

C#
public string TypeName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1082-1086

Gets or sets the exact full CLR name of the declaring type.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberOperationKind

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:16-46

Underlying type: byte

The six reusable member operation families.

C#
EventCondition = 6

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:45

Report whether the bound event occurred. Authored on amember_eventnode.

C#
Field = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:28

Read or write the bound field. Authored on a member_field node.

C#
MemberCondition = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:40

Compare the bound member’s value and report a condition result. Authored on a member_conditionnode.

C#
Message = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:34

Call a public void method fire-and-forget. Authored on amember_messagenode; a result, direction, comparison, event, or notification record is refused.

C#
Method = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:22

Invoke the bound method once. Authored on a member_method node.

C#
Property = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:25

Read or write the bound property. Authored on a member_property node.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:19

No operation family was authored; the binding is rejected by validation.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberParameterModifier

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:327-343

Underlying type: byte

The exact C# modifier of one authored method parameter.

C#
In = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:333

An in parameter. Canonical text modifier: in.

C#
Out = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:339

An out parameter. Canonical text modifier: out.

C#
Params = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:342

A params array parameter. Canonical text modifier: params.

C#
Ref = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:336

A ref parameter. Canonical text modifier: ref.

C#
Value = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:330

A plain by-value parameter; canonical text omits the modifier.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberParamsInputForm

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:348-355

Underlying type: byte

How the final params parameter of a member binding supplies its array argument.

C#
Array = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:354

One existing array or list value supplies the whole parameter.

C#
Expanded = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:351

Zero or more individual element values in authored call order. The default.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberPortableIdentity

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1742-1966

The split between the portable member binding identity and the backend-local identity.

Responsibilities:

  • Name the portable and backend-local field sets, and build each half’s canonical text so two bindings differing only by backend prove identical portable identity.

Does NOT:

  • Replace the complete contract identity, which is what the 64-bit contract hash covers.

C#
public static System.Collections.Generic.IReadOnlyList<string> BackendLocalFieldNames { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1775-1781

The authored fields that differ by backend and never enter portable equality.

C#
public static System.Collections.Generic.IReadOnlyList<string> PortableFieldNames { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1759-1772

The authored fields that must match across object models.

C#
public static System.Collections.Generic.IReadOnlyList<string> ProductNodeTokens { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1748-1756

The six reusable product member node tokens, shared by both backends.

BuildBackendLocalIdentity(BehaviorSourceMemberBinding binding)

Section titled “BuildBackendLocalIdentity(BehaviorSourceMemberBinding binding)”
C#
public static string BuildBackendLocalIdentity(BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding binding)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1950-1963

Builds the canonical backend-local identity text of one binding: the target mode and resolution data, the entity container, and the entity event source.

BuildPortableIdentity(BehaviorSourceMemberBinding binding)

Section titled “BuildPortableIdentity(BehaviorSourceMemberBinding binding)”
C#
public static string BuildPortableIdentity(BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding binding)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1787-1902

Builds the canonical portable identity text of one binding. Two bindings that differ only by backend produce the same text.

BuildTargetIdentity(BehaviorSourceMemberBinding binding)

Section titled “BuildTargetIdentity(BehaviorSourceMemberBinding binding)”
C#
public static string BuildTargetIdentity(BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding binding)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1910-1944

Builds the canonical backend-local target identity text of one binding: the target mode and resolution data plus the entity container, with no event observation. Two bindings that share one exact target share one identity, however their observations differ.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberRefBinding

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberRefBinding.cs:29-141

The one shared derivation of a ref parameter’s Write to destination and link state. Bake, source validation, the binding rail, the canvas projection, and generated source all resolve a ref slot’s effective destination through this single authority, so the convention default can never drift between what the author sees, what validates, what bakes, and what the generated call actually writes.

Responsibilities:

  • Decide whether a ref parameter’s Write to destination is linked to its Blackboard Read source: the Read source is itself a Blackboard variable, and either no explicit override is authored or the override names that same variable. A Constant Read source never supplies a fallback destination, so it is never linked; an explicit override naming any other variable is a separated destination.
  • Resolve the one effective Write to destination name: the explicit override when authored, otherwise the Read source’s own Blackboard variable while linked, otherwise empty (required).

Does NOT:

  • Validate compatibility, resolve blackboard slots or live declarations, or apply to an out parameter, which has no Read source to fall back to.

ConditionOperandParameterOrdinal(BehaviorSourceMemberBinding binding)

Section titled “ConditionOperandParameterOrdinal(BehaviorSourceMemberBinding binding)”
C#
public static int ConditionOperandParameterOrdinal(BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding binding)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberRefBinding.cs:105-115

Gets the zero-based ordinal of the ref parameter whose post-call value the member conditionbindingtests, or -1 when the binding is not a member condition, the declaration returns a value (its own return is tested), or the authoredTestedParameterOrdinaldoes not name one of the declaration’s ref parameters. Never falls back to declaration order: an unauthored choice is reported by validation, not made here.

EffectiveDestination(BehaviorSourceMemberArgument argument)

Section titled “EffectiveDestination(BehaviorSourceMemberArgument argument)”
C#
public static string EffectiveDestination(BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgument argument)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberRefBinding.cs:57-69

Gets the effective Write to destination of a ref slot: the explicit override when one is authored, the linked Read source variable while defaulted, or empty while the destination is required.

IsLinkedToReadSource(BehaviorSourceMemberArgument argument)

Section titled “IsLinkedToReadSource(BehaviorSourceMemberArgument argument)”
C#
public static bool IsLinkedToReadSource(BitQuirky.Behavior.Authoring.BehaviorSourceMemberArgument argument)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberRefBinding.cs:38-50

Gets whetherargumentis a ref slot whose Write to destination is linked to its Blackboard Read source: both legs name one variable, so the author sees one identity and validation reports it once. An explicit override that names the Read source’s own variable is that same state; the override stays stored, so a later Read change leaves it where the author put it and only then separates the legs.

IsTestedParameterCandidate(BehaviorSourceMemberIdentity identity, int ordinal)

Section titled “IsTestedParameterCandidate(BehaviorSourceMemberIdentity identity, int ordinal)”
C#
public static bool IsTestedParameterCandidate(BitQuirky.Behavior.Authoring.BehaviorSourceMemberIdentity identity, int ordinal)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberRefBinding.cs:86-95

Gets whetherordinalnames a ref parameter a member condition on identitymay test: the declaration is a void method and the ordinal is one of its declared ref parameters.

RequiresTestedParameter(BehaviorSourceMemberIdentity identity)

Section titled “RequiresTestedParameter(BehaviorSourceMemberIdentity identity)”
C#
public static bool RequiresTestedParameter(BitQuirky.Behavior.Authoring.BehaviorSourceMemberIdentity identity)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberRefBinding.cs:76-79

Gets whether a member condition onidentitymust name which ref parameter it tests: the declaration is a void method, so it has no return to test, and it declares at least one ref parameter whose post-call value can be tested.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:965-1010

The authored result contract of a method binding.

Responsibilities:

  • Declare what the operation does with its return value and, for a blackboard result, the exact destination name and value type.

Does NOT:

  • Apply to messages, which are always void with no result destination.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberConditionResult CompletionResult { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:983-984

Gets or sets the fixed behavior result reported after a non-tested invocation or deferred operation completes normally.

C#
public string DestinationName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:971

Gets or sets the blackboard destination name for a blackboard result.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberConditionResult FaultResult { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:991-992

Gets or sets the behavior result reported when the bound member throws. The deferred forms author it on the binding rail; the runtime honors it wherever a member throws, and its default of failure keeps synchronous behavior unchanged.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberResultForm Form { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:968

Gets or sets the result form.

C#
public bool GiveUpArmed { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:999

Gets or sets whether an authored give-up time bounds this deferred operation. When armed, the baker wraps the operation in the product’s existing time-limit decorator rather than introducing a second timing mechanism.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberConditionResult GiveUpResult { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1005-1006

Gets or sets the behavior result reported when the give-up budget elapses.

C#
public float GiveUpSeconds { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1002

Gets or sets the authored give-up budget in seconds; meaningful when armed.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1009

Gets the one-based source line of the result record.

C#
public string SurfacedNameOverride { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:977

Gets or sets the author rename of the automatically surfaced destination.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity ValueType { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:974

Gets or sets the exact value type identity of a blackboard result.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberResultForm

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:360-382

Underlying type: byte

What a method operation does with its return value.

C#
Awaitable = 6

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:381

The method returns an awaitable the runtime completes off-tick. Canonical text form: awaitable.

C#
BehaviorStatus = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:372

The return value is already a node status. Canonical text form: status.

C#
Blackboard = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:369

The return value is stored into a blackboard entry. Canonical text form: blackboard.

C#
Coroutine = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:375

The method returns a coroutine the runtime drives to completion. Canonical text form: coroutine.

C#
Outcome = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:378

The return value is an outcome mapped through the binding’s outcome rows. Canonical text form: outcome.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:363

No result form was authored; the return value is not consumed.

C#
Void = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:366

The method returns nothing. Canonical text form: void.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberSynchronization

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:435-449

Underlying type: byte

How a projected member blackboard entry synchronizes with its member.

C#
None = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:439

The entry never synchronizes; the binding is neither a property nor a field read or write.

C#
Notification = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:442

The entry is refreshed from the authored change notification event instead of by polling.

C#
PollEachSelectedTick = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:445

The entry is refreshed on every tick the binding is selected.

C#
PushOnWrite = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:448

Writing the entry pushes the new value straight to the member.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberTarget

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:477-611

The exact explicit target contract of one member binding.

Responsibilities:

  • Carry the target mode, agent-relative resolution, explicit-reference slot key, and exact declaring type identity, plus the identifier used for blackboard-name disambiguation.

Does NOT:

  • Resolve an instance, search a scene, or substitute a same-type object.

C#
public string AssemblyName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:549-553

Gets or sets the exact assembly simple name of the target type.

C#
public string AssetReference { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:496

Gets or sets the canonical asset GUID and display-name payload, or none.

C#
public string BlackboardVariableName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:504

Gets or sets the canonical name of the existing projected managed-reference blackboard variable this target reads. Required and non-empty only for BlackboardVariable, and forbidden on every other mode. Freeform object variables are out of scope .

C#
public string ChildPath { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:486

Gets or sets the exact child path for child resolution; empty otherwise.

C#
public string HopBlackboardName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:517

Gets or sets the exact surfaced blackboard entry the hop reads. Required and non-empty only forBlackboardEntry.

C#
public string HopFieldName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:523

Gets or sets the exact entity-typed field the hop reads. Required and non-empty only forComponentField.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberEntityHopKind HopKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:511

Gets or sets the one hop an entity Handle target takes from its fixed base. Noneon every other mode. A second hop and Handle-to-Handle chaining are not representable, so they cannot be authored.

C#
public string HopSourceAssemblyName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:530-534

Gets or sets the exact assembly simple name of the component declaring HopFieldName. Exact identity is always the (assembly, type) pair, so the hop source records both halves.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity HopSourceTypeIdentity { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:572-573

Gets the exact hop source type identity pair.

C#
public string HopSourceTypeName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:541-545

Gets or sets the exact full CLR name of the component declaring HopFieldName.

C#
public bool IsEntityMode { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:576

Gets whether this target resolves on the pure-entity backend.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberTargetMode Mode { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:480

Gets or sets the target resolution mode.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceMemberAgentResolve Resolve { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:483

Gets or sets the agent-relative resolution shape; Unknown otherwise.

C#
public string SlotKey { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:493

Gets or sets the stable serialized slot key of an explicit-reference target. The slot key names a serialized assignment point, is unique in the graph, and is part of exact target identity.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:565

Gets the one-based source line of the target record.

C#
public string TargetIdentifier { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:584-610

Gets the identifier used for automatic blackboard collision disambiguation: the explicit slot key for a reference target, the named variable for a blackboard target, otherwise the declaring type’s simple name, normalized to lower camel case only when a blackboard name is derived from it.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity TypeIdentity { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:568-569

Gets the exact target type identity pair.

C#
public string TypeName { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:557-561

Gets or sets the exact full CLR name of the target type.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceMemberTargetMode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:78-138

Underlying type: byte

How a member binding resolves its target instance.

C#
AgentRelative = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:88

A GameObject reached from the agent itself, its parent, or a child path; the exact shape is the binding’sBehaviorSourceMemberAgentResolve. Canonical text mode: self, mode: parent, or mode: child plus path.

C#
BlackboardVariable = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:106

The target is the Unity object currently held in one named projected managed-reference blackboard variable, resolved before every affected evaluation. Appended afterStatic; existing numeric values never move.

C#
DeclaredAssetIdentity = 10

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:137

A bake-resolved Unity asset identified by an unmanaged stable id on the entity path.

C#
DeclaredAssetReference = 9

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:134

A Unity asset declared by GUID in source and resolved into the managed companion.

C#
EntityHandle = 6

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:119

An exact entity reached by exactly one hop from a fixed base: a surfaced blackboard entry of the entity type, or one entity-typed field on a component of the entity this graph instance runs on.

C#
EntitySelf = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:112

The entity this graph instance runs on. Backend-local, appended; an entity has no children and no parent to walk, so this mode carries no scope.

C#
EntitySingleton = 7

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:125

The one entity in the graph world carrying the authored component type, taken from the world’s own singleton lookup. Zero and multiple are both live readings.

C#
EntityStatic = 8

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:131

A static declaring type with no entity instance. Its canonical spelling is shared with Static; the graph’s Runtime path decides which backend reads it.

C#
ExplicitReference = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:94

The object held in the named explicit-reference slot. Canonical text mode: reference plus slot.

C#
Static = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:99

A static declaring type with no instance at all. Canonical textmode: static.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:81

No target mode was authored. Canonical text mode: unknown.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceMemberTargetModes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1523-1675

The closed target-mode vocabulary and its backend classification.

Responsibilities:

  • Map every target mode to its canonical token and to exactly one backend.

Does NOT:

  • Decide which backend a graph uses; that is the graph’s Runtime path.

GetToken(BehaviorSourceMemberTarget target)

Section titled “GetToken(BehaviorSourceMemberTarget target)”
C#
public static string GetToken(BitQuirky.Behavior.Authoring.BehaviorSourceMemberTarget target)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1589-1605

Gets the canonical source token of one exact authored target.

GetToken(BehaviorSourceMemberTargetMode mode)

Section titled “GetToken(BehaviorSourceMemberTargetMode mode)”
C#
public static string GetToken(BitQuirky.Behavior.Authoring.BehaviorSourceMemberTargetMode mode)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1570-1586

Gets the canonical source token of a mode. The agent-relative modes need their scope, so the overload taking a target is the one canonical text uses.

IsEntityMode(BehaviorSourceMemberTargetMode mode)

Section titled “IsEntityMode(BehaviorSourceMemberTargetMode mode)”
C#
public static bool IsEntityMode(BitQuirky.Behavior.Authoring.BehaviorSourceMemberTargetMode mode)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1528-1541

Returns whether the mode resolves on the pure-entity backend.

IsGameObjectMode(BehaviorSourceMemberTargetMode mode)

Section titled “IsGameObjectMode(BehaviorSourceMemberTargetMode mode)”
C#
public static bool IsGameObjectMode(BitQuirky.Behavior.Authoring.BehaviorSourceMemberTargetMode mode)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1544-1557

Returns whether the mode resolves on the GameObject backend.

TryParseToken(string token, BehaviorSourceRuntimePath path, out BehaviorSourceMemberTargetMode mode, out BehaviorSourceMemberAgentResolve resolve)

Section titled “TryParseToken(string token, BehaviorSourceRuntimePath path, out BehaviorSourceMemberTargetMode mode, out BehaviorSourceMemberAgentResolve resolve)”
C#
public static bool TryParseToken(string token, BitQuirky.Behavior.Authoring.BehaviorSourceRuntimePath path, out BitQuirky.Behavior.Authoring.BehaviorSourceMemberTargetMode mode, out BitQuirky.Behavior.Authoring.BehaviorSourceMemberAgentResolve resolve)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:1611-1672

Maps one canonical token to its exact mode under the graph’s Runtime path. Returns false for a token the path does not offer, so a mode is never reinterpreted.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceNode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:526-605

Semantic view of one authored node. Keeps graph-owned metadata exactly as authored while allowing import, validation, and baking to resolve descriptor-owned facts separately.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceActiveUpdateSource ActiveUpdateSource { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:554-555

Gets or sets the parsed Active Update source selection.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceAuthority Authority { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:537

Which side owns this node’s effects, taken from its %% authority= metadata line; Unknown when the source omits that line.

C#
public bool HasExplicitActiveUpdateSource { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:557

Gets or sets whether the source explicitly selected Active Update content.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceHostedBehaviorConfiguration HostedBehavior { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:559

Gets or sets additive hosted-tree settings, or null when omitted.

C#
public string HostedStateMachineFailureStateId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:592

For a hosted state machine, the optional authored id of a state in the referenced machine that reports Failure for this host the moment the hosted instance enters it, overriding that state’s own authored completion and anyhost_failure_event mapping (FSM-013 P2). Empty when the author leaves Failure to the referenced machine’s own result.

C#
public string HostedStateMachineSuccessStateId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:584

For a hosted state machine (HostedStateMachine), the optional authored id of a state in the referenced machine that reports Success for this host the moment the hosted instance enters it, overriding that state’s own authored completion and anyhost_success_eventmapping (FSM-013 P2). Empty when the author leaves Success to the referenced machine’s own result.

C#
public string Id { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:529

The node’s authored stable id: the lowercase identifier that opens its source line and that edges name as their endpoints.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceNodeKind Kind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:531

The node kind mapped from NodeKindToken; an unrecognized token maps to Action while the token itself is kept.

C#
public string Label { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:535

The text inside the node’s shape brackets with the brackets and any wrapping quotes removed; empty when the line carries no shape segment. A subgraph reference authors @addr:<address> here.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceLayoutEntry> Layout { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:574

Editor placement hints read from the node’s %% layout: comment, such as x and y; they are authoring-only and never reach the baked artifact. Empty when the comment is absent.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceMemberBinding> MemberBindings { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:604

Gets the member bindings owned by this node ( member nodes).

C#
public int MetadataSourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:601

Gets or sets the one-based source line of the metadata block. Zero means either that the source omitted the block or that a programmatically created node has not yet been assigned source coordinates;HasAuthoredMetadatadistinguishes them.

C#
public string NodeKindToken { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:533

The exact ::: class token that closes the authored node line, such as state or member_method.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.BehaviorSourceParameter> Parameters { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:551-552

Gets or sets ordered semantic parameters attached to this node.

C#
public System.Collections.Generic.IReadOnlyList<string> ReadSet { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:539

Declared blackboard field names this node reads, in authored order; empty when the metadata line is absent. Each name must be declared by the graph.

C#
public int SourceLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:594

One-based line of the node’s own declaration line, not of the comment lines above it.

C#
public string SubgraphAddress { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:576

For a subgraph reference or a hosted state machine, the source address taken from its @addr: label and used to resolve the nested source; empty for every other node kind.

C#
public System.Collections.Generic.IReadOnlyList<string> Waits { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:543

Declared external service ids this node waits on for completion, in authored order.

C#
public System.Collections.Generic.IReadOnlyList<string> WriteSet { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:541

Declared blackboard field names or external service ids this node writes, in authored order; each name must resolve to exactly one of the two, never both.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceNodeBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1165-1173

Inherits: BehaviorSourceDocumentBlock

One authored node: its declaration line together with the%%metadata, parameter, member-record and layout comment lines that precede it. The writer regenerates those comment lines fromNodein canonical key-sorted form and then emits NodeLineRawback unchanged, so the node’s own line survives a read/write round trip exactly as authored.

C#
public string Indent { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1172

The leading whitespace of the node line, reused as the indent of the comment lines the writer emits above it.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceNode Node { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1168

The semantic view of this node; the same instance is listed in Nodes.

C#
public string NodeLineRaw { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1170

The node declaration line exactly as authored, indent included and with trailing whitespace already removed; the writer emits it unchanged.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceNodeKind

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:50-129

Underlying type: int

Behavior-tree / statechart node taxonomy as carried in the Mermaid source. Each node line carries one node-type token (the Mermaid:::class suffix) which the parser maps into this enum.

Responsibilities:

  • Enumerate every node and state kind the Mermaid source grammar accepts, including the leaf that hosts a separately authored State Machine graph in place (HostedStateMachine, source token state_machine_host) without flattening its nodes into the host (FSM-013).

Does NOT:

  • Resolve, validate, bake, or run the kind it names; those steps read this value and act on it elsewhere.

C#
Action = 11

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:86

A leaf performing work and reporting a status. Source token action.

C#
AnyState = 22

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:119

Statechart-wide transition source with deterministic global precedence.

C#
Condition = 12

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:89

A leaf testing a predicate and reporting success or failure. Source token condition.

C#
Conditional = 15

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:98

Decorator gating its child on a predicate each tick. Source token conditional.

C#
EntryState = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:59

The state the statechart activates first. Source token entry.

C#
HostedStateMachine = 25

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:128

A leaf hosting a separately authored State Machine graph without flattening it. Source token state_machine_host.

C#
Inverter = 8

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:77

Decorator swapping its child’s success and failure. Source token inverter.

C#
MemberCondition = 20

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:113

Reusable product condition comparing an exact member value.

C#
MemberEvent = 21

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:116

Reusable product condition waiting for one firing of an exact event.

C#
MemberField = 18

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:107

Reusable product node reading, writing, or binding an exact field.

C#
MemberMessage = 19

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:110

Reusable product node firing an exact public void method.

C#
MemberMethod = 16

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:101

Reusable product node invoking an exact method .

C#
MemberProperty = 17

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:104

Reusable product node reading, writing, or binding an exact property.

C#
Parallel = 7

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:74

Ticks every child on the same tick and combines their statuses. Source token parallel.

C#
ProbabilitySelector = 14

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:95

Picks one child by its authored branch weight. Source token probability_selector.

C#
Repeat = 9

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:80

Decorator re-running its child for the authored repeat count. Source token repeat.

C#
Selector = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:68

Ticks children in order and returns the first non-failure. Source token selector.

C#
Sequence = 6

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:71

Ticks children in order and returns the first non-success. Source token sequence.

C#
State = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:62

One statechart state with its own actions and outgoing transitions. Source token state.

C#
StateMachineReference = 23

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:122

Reusable referenced state machine with ordered candidate child assets.

C#
StatechartRoot = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:56

The single owner of a statechart graph. Source token root.

C#
SubgraphReference = 13

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:92

A leaf running another authored graph in place. Source token subgraph.

C#
TimeLimit = 10

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:83

Decorator failing its child once the authored time budget elapses. Source token timelimit.

C#
Transition = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:65

One edge between two states, taken when its condition group is satisfied. Source token transition.

C#
Unknown = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:53

No node kind has been resolved for the node; validation rejects it as missing metadata.

C#
UtilitySelector = 24

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:125

Picks the branch scoring highest against its authored considerations each tick. Source token utility_selector.

Category: Source authoring

C#
readonly struct BitQuirky.Behavior.Authoring.BehaviorSourceParameter

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:473-491

One ordered semantic parameter attached to a source node.

Responsibilities:

  • Preserve a stable key, its raw canonical value, and source location.

Does NOT:

  • Interpret the value without a node parameter descriptor.

C#
public string Key { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:484

Gets the stable lowercase parameter key.

C#
public string RawValue { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:487

Gets the raw canonical value text.

C#
public int SourceLine { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:490

Gets the one-based source line containing the parameter.

BehaviorSourceParameter(string key, string rawValue, int sourceLine)

Section titled “BehaviorSourceParameter(string key, string rawValue, int sourceLine)”
C#
public BehaviorSourceParameter(string key, string rawValue, int sourceLine)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:476-481

Creates one ordered, uninterpreted semantic source parameter.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceParseResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1304-1330

Result of a parse: the document (round-trip view), the AST (semantic view), and the diagnostics list.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceAst Ast { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1309

The semantic view the validator and the baker consume. It is always present; after an error-severity diagnostic it is incomplete rather than null.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> Diagnostics { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1311

Every diagnostic this parse produced, in emission order.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceDocument Document { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1307

The round-trip view of the parsed text: one ordered block per source line, ready to hand back to the writer.

C#
public bool HasErrors { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1316-1329

Whether any diagnostic has error severity, meaning the parse produced no usable AST.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourcePassthroughCommentBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1152-1156

Inherits: BehaviorSourceDocumentBlock

A%%comment line the reader does not interpret: anything that is not a header, a declaration, a node metadata, parameter or layout block, a member record, or a declared value block. The writer emitsRawLineback unchanged, so an unrecognized comment survives a read/write round trip apart from the trailing whitespace the reader already removed.

C#
public string RawLine { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1155

The comment line exactly as authored, indent included, with trailing whitespace already removed.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceRuntimePath

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:66-73

Underlying type: byte

The runtime a graph bakes for. The path is a property of the graph, set in the graph’s inspector home on the Runtime path row, and it decides how the shared canonical target-mode tokens read.

C#
Entity = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:72

The pure-entity object model.

C#
GameObject = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceMemberBinding.cs:69

The GameObject object model. The default, so canonical text omits it.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceRuntimePathBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1072-1076

Inherits: BehaviorSourceDocumentBlock

The graph’s Runtime path header block.

Responsibilities:

  • Preserve the parsed Runtime path in document order so the shared canonical target-mode tokens read against the object model the graph bakes for.

Does NOT:

  • Reinterpret, discard, or rewrite a binding the new path cannot carry.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceRuntimePath Path { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1075

Gets or sets the parsed Runtime path.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceServiceDeclarationBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1117-1121

Inherits: BehaviorSourceDocumentBlock

Document block declaring external service ids that nodes may reference from waits metadata and service-queue writes.

C#
public System.Collections.Generic.IReadOnlyList<string> ServiceIds { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1120

The service ids listed on this one %% services: line, in authored order. A source may carry several such lines; DeclaredServiceOrder is their de-duplicated union.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceStateParameterTokens

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:394-416

Canonical semantic parameter tokens for state-hosted Behavior Tree authoring.

Responsibilities:

  • Own the shared parameter and value spellings used by Runtime and Editor source handling.

Does NOT:

  • Infer a legacy source choice or validate whether the selected source has valid content.

C#
public const string ActionsUpdateSource = "actions"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:400

The Active Update source value selecting direct Update actions.

C#
public const string ActiveUpdateSource = "active_update_source"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:397

The parameter selecting the state’s Active Update source.

C#
public const string BehaviorTreeUpdateSource = "behavior_tree"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:403

The Active Update source value selecting a hosted Behavior Tree.

C#
public const string HostAssetName = "host_asset_name"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:415

The last authored display name of a hosted project asset.

C#
public const string HostFailureEvent = "host_failure_event"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:411

The parameter exposing a hosted tree’s Failure result event.

C#
public const string HostLifetime = "host_lifetime"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:405

The parameter selecting a hosted tree’s activation lifetime.

C#
public const string HostSuccessEvent = "host_success_event"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:408

The parameter exposing a hosted tree’s Success result event.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceTransitionConditionGroup

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:795-801

Ordered predicates and their authored all or any combination mode.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTransitionConditionGroupMode Mode { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:798

Whether every predicate must hold (all:) or any one of them (any:); None means the edge authors no condition group.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceTransitionPredicate> Predicates { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:800

The group’s predicates in authored order.

BehaviorSourceTransitionConditionGroupMode

Section titled “BehaviorSourceTransitionConditionGroupMode”

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceTransitionConditionGroupMode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:149-159

Underlying type: int

Authored transition predicate combination mode.

C#
All = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:155

Every authored predicate must hold for the transition to fire.

C#
Any = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:158

At least one authored predicate must hold for the transition to fire.

C#
None = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:152

The transition authored no predicates and fires whenever it is evaluated.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceTransitionOperandKind

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:227-234

Underlying type: byte

Which authored value a typed transition predicate compares its left field against.

Responsibilities:

  • Separate the existing typed constant from a same-type authored graph value, so an operand that names a field is never mistaken for a literal and a literal is never mistaken for a field (, FSM-006).

Does NOT:

  • Decide whether the named field exists, is readable, or has a comparable type. The validator owns every one of those verdicts.

C#
Constant = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:230

The existing typed constant literal. Every earlier source is this kind.

C#
GraphValue = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:233

A declared graph value named in canonical source as $<field>.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceTransitionOperandTokens

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:246-262

Canonical source tokens that mark a transition predicate’s right operand.

Responsibilities:

  • Own the one marker character that distinguishes a graph-value right operand from every constant literal, so the reader, the writer, and the editor never spell it separately.

Does NOT:

  • Validate the name the marker introduces.

C#
public const char GraphValueMarker = '$'

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:249

The character that introduces a graph-value right operand.

C#
public const string RequiredConstant = "<value>"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:254

Canonical visible placeholder for a required constant the author has not written. The reader projects it back to an empty literal so validation blocks bake.

C#
public static string FormatGraphValue(string fieldId)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:258-261

Renders one graph-value right operand in canonical source.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceTransitionPredicate

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:743-790

One parsed typed predicate in an authored transition condition group.

The right operand is either the authored constant inRawLiteralor the declared graph value named byRightFieldId, and RightOperandKindis the only thing that says which. Every predicate authored before reads back asConstant, so its meaning, its canonical text, and its baked row are unchanged.

C#
public string FieldId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:752

Name of the declared graph value used as the left operand; it names a declared value, not a blackboard slot index.

C#
public string MemberBindingId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:749

Gets or sets the exact sibling member binding evaluated instead of field operands.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceComparisonOperator Operator { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:754

The comparison applied between the left operand and the right operand.

C#
public string RawLiteral { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:756

The right-hand constant in canonical authored value text. Empty when the right operand is a graph value, and empty when the author left the <value> placeholder, which validation then rejects.

C#
public string RightFieldId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:770

Gets or sets the exact authored graph-value name, without its $ marker. It is active whenRightOperandKindis GraphValueand remains dormant when Constant is active, so source switching and save/reopen never discard authored intent. An unusable name is preserved for explicit repair rather than coerced or discarded.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTransitionOperandKind RightOperandKind { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:761

Gets or sets which value the right operand currently evaluates.

C#
public int SourceOrder { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:758

Zero-based position of this predicate within its authored group; the baked predicate rows are ordered by this value, so authored order survives the bake.

C#
public const string MemberPrefix = "member:"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:746

The canonical marker distinguishing a member binding from a graph field.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceTransitionPredicate Clone()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:777-789

Copies every authored column of this predicate. Every edit command and every document mutation clones through here, so a column added to the predicate can never be silently dropped by one copy site.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceTransitionTriggerTokens

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:812-821

Canonical semantic parameter tokens used to retain an inactive transition trigger.

Responsibilities:

  • Name the source parameter that carries a dormant predicate group while Event is active.

Does NOT:

  • Choose the active trigger or evaluate transition predicates.

C#
public const string DormantConditionGroup = "dormant_transition_conditions"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:815

The encoded predicate group retained while Event is active.

C#
public const string DormantOperandState = "dormant_transition_operands"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:819

Encoded active predicate group including each row’s dormant alternate operand.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceTypeForwarding

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceTypeForwarding.cs:23-92

Exact type identity resolved through assembly type forwarders.

Responsibilities:

  • Resolve one recorded (assembly simple name, full CLR type name) pair to its exact type, accepting a forwarding assembly name as well as the defining one.
  • Normalize a recorded identity to the defining assembly after forwarding, so a binding authored against an assembly whose types later moved keeps one stable identity.

Does NOT:

  • Substitute a same-named type from another assembly, search by simple name, or load an assembly that is not already in the domain.

Normalize(BehaviorSourceTypeIdentity identity)

Section titled “Normalize(BehaviorSourceTypeIdentity identity)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity Normalize(BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity identity)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceTypeForwarding.cs:67-72

Returns the identity carried by the assembly that defines the type after forwarding, or the recorded identity unchanged when it does not resolve. Resolution failure is not a licence to guess: the caller reports the exact saved identity verbatim.

TryResolve(BehaviorSourceTypeIdentity identity, out Type type, out BehaviorSourceTypeIdentity definingIdentity)

Section titled “TryResolve(BehaviorSourceTypeIdentity identity, out Type type, out BehaviorSourceTypeIdentity definingIdentity)”
C#
public static bool TryResolve(BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity identity, out System.Type type, out BitQuirky.Behavior.Authoring.BehaviorSourceTypeIdentity definingIdentity)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorSourceTypeForwarding.cs:32-60

Resolves one recorded identity to its exact type and to the identity of the assembly that actually defines it. Returns false when no loaded assembly declares or forwards the exact full type name.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceUtilityAggregation

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:683-693

Underlying type: int

How a Utility Selector branch combines more than one authored consideration into its score (research D-R2).

C#
Average = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:686

The mean of the branch’s considerations. Source token average.

C#
Maximum = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:692

The highest of the branch’s considerations. Source token maximum.

C#
Minimum = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:689

The lowest of the branch’s considerations. Source token minimum.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceUtilityConsideration

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:710-732

One authored live-value input to a Utility Selector branch’s score (research D-R2).

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceUtilityCurveKey> CurveKeys { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:731

Gets the ordered curve keys samplingFieldId’s live value when HasCurveis true. May contain fewer than two keys, or keys out of ascending order, for an authored clause that has not yet passed validation.

C#
public string FieldId { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:713

Name of the declared field this consideration reads; must be declared globally and in the owning Utility Selector node’s own read set.

C#
public bool HasCurve { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:724

Gets or sets whether this consideration authored a(curve: [...])clause at all, independent of how many keys it contains. False means the consideration reads FieldId’s value directly. A valid curve must author at least two strictly ascending keys; an authored clause with fewer keys, or with keys out of order, fails the bake with a precise diagnostic (see BehaviorValidator.ValidateUtilitySelectors) instead of silently reading as a direct-value consideration.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceUtilityCurveKey

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:698-705

One authored curve key sampled by a Utility Selector consideration (research D-R2).

C#
public float Time { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:701

The key’s input, compared against the consideration’s live field value.

C#
public float Value { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:704

The key’s output, the consideration’s value when its field reads exactly Time.

Category: Source authoring

C#
enum BitQuirky.Behavior.Authoring.BehaviorSourceUtilityExecutionMode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:668-677

Underlying type: int

Whether a running Utility Selector branch finishes before re-choosing or is compared against rivals every tick (research D-R4).

C#
FinishFirst = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:672

The running branch is never compared against a rival until it returns Success or Failure. Source tokenfinish_first; the authored default.

C#
Interrupt = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:676

Every other enabled branch’s score is compared against the running branch’s every tick. Source tokeninterrupt.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorSourceValidationProfileBlock

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1087-1091

Inherits: BehaviorSourceDocumentBlock

Explicit consumer validation-profile header block.

Responsibilities:

  • Preserve the stable profile token selected by canonical source.

Does NOT:

  • Discover, instantiate, or execute a validation extension.

C#
public string ProfileToken { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1090

Gets or sets the stable validation-profile token.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorValidationContext

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidationExtension.cs:18-40

Immutable input supplied to an explicitly composed validation extension.

Responsibilities:

  • Expose the source AST and the operation-local node authoring registry.
  • Fail immediately when either required validation dependency is missing.

Does NOT:

  • Discover extensions, mutate source, or retain global validation state.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceAst Ast { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidationExtension.cs:34

Source being validated for the current operation.

C#
public BitQuirky.Behavior.Nodes.NodeAuthoringRegistry Registry { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidationExtension.cs:39

Node schemas composed for the current operation.

BehaviorValidationContext(BehaviorSourceAst ast, NodeAuthoringRegistry registry)

Section titled “BehaviorValidationContext(BehaviorSourceAst ast, NodeAuthoringRegistry registry)”
C#
public BehaviorValidationContext(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Nodes.NodeAuthoringRegistry registry)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidationExtension.cs:23-29

Creates an extension context from the source and registry selected for one operation.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorValidationOptions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:67-118

Explicit inputs to one validator operation.

Responsibilities:

  • Supply the operation-local node registry and selected consumer validation extensions.

Does NOT:

  • Discover dependencies or hold global mutable registration state.

C#
public BitQuirky.Behavior.Member.IBehaviorEntityConverterBurstCompatibilityAnalyzer BurstConverterAnalyzer { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:116-117

The Editor-only Burst-compatibility judge for an entity-applicable custom converter registration (, Phase 5, ). Ordinary asset-import and live-editor validation always supply a real analyzer. Left null, an entity-applicable registration is rejected fail-closed with EntityConverterNotBurstCompatible (, Phase 5 fix round 1, finding C1): a missing decision is never treated as an accepted one, so package-level fixture tests that bind an entity graph to a registry must supply a real or stand-in analyzer, while a fixture that never sets ConverterRegistryat all is unaffected.

C#
public BitQuirky.Behavior.Member.BehaviorMemberConverterRegistry ConverterRegistry { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:103

The project’s injected extension-converter registry (, Phase 4, /), mirroringRegistry and Extensions: a plain instance a project constructs and supplies explicitly for the one bake or validate call that needs it. Consulted only when TryGetConversiondoes not already resolve a pair, so a built-in conversion always takes precedence and can never itself become ambiguous against a registered custom converter.

C#
public BitQuirky.Behavior.Member.IBehaviorEntityPropertyAccessorProofProvider EntityPropertyAccessorProofs { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:90-91

Optional build-time property-accessor proofs for runtimes, such as IL2CPP, that do not expose managed method bodies. Generated validation players supply their compiled proof; ordinary Editor validation proves the accessor directly and leaves this null.

C#
public System.Collections.Generic.IReadOnlyList<BitQuirky.Behavior.Authoring.IBehaviorValidationExtension> Extensions { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:82-83

Consumer validation extensions selected explicitly for this operation. The caller resolves source profile tokens and passes only the matching extensions.

C#
public BitQuirky.Behavior.Nodes.NodeAuthoringRegistry Registry { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:76

When provided, the validator cross-references each node’s :::<token>against the registry’s authoring descriptors and runs the determinism x authority compatibility check (section Required declarations).

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorValidationResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:29-56

Validation result for one source operation.

Responsibilities:

  • Own the structured diagnostics appended by package and extension validation rules.
  • Report whether any diagnostic has error severity.

Does NOT:

  • Mutate source or retain diagnostics between validation operations.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Authoring.BehaviorSourceDiagnostic> Diagnostics { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:32

Gets the operation-owned structured diagnostics.

C#
public bool HasErrors { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:42-55

Gets whether at least one diagnostic has error severity.

C#
public System.Collections.Generic.List<BitQuirky.Behavior.Member.BehaviorMemberBindingDiagnostic> MemberDiagnostics { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:38-39

Gets the structured member-binding diagnostics. Each entry also projects one error intoDiagnosticscarrying the same stable code.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.BehaviorValidator

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:871-4856

Bake-time validation hooks for the node-author contract per section Bake-time validation. The single source of truth for these checks;BehaviorBaker delegates here so the codes / messages stay consistent across the editor preprocess, the build preprocess, and the runtime load.

Responsibilities:

  • Header well-formedness (presence of%% behavior-version, %% layer: behavior).
  • Resolve omitted descriptor-owned node facts and typed-transition reads into a detached semantic view, while rejecting explicit descriptor contradictions.
  • Validate graph-owned read / write / waits membership against the source’s %% fields: and %% services:declarations. -ClientPresentationmay not write to slots co-owned byHostAuthoritative writers.
  • Either a single top-level behavior-tree root, or a single Statechart Root + exactly one entry state.
  • Subgraph references carry a source address; per-source self-cycle detection.
  • Deterministic +ClientPresentationis the only host+client tickable combination (HostOnlyNonDeterministicnodes MUST be host-authoritative). Activated when an authoring registry is supplied.

Does NOT:

  • Mutate the AST.
  • Resolve subgraphs across files - that’s the loader’s job.
  • Resolve parent / child or transition edges - that’s a structural resolution step done by the baker once validation passes.

C#
public const string MemberDeclaredValueReadMissingCode = "member-declared-value-read-missing"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:1228

Diagnostic code for a member node that reads a declared graph value itsread= access does not grant (ValidateMemberDeclaredValueAccess).

C#
public const string MemberDeclaredValueWriteMissingCode = "member-declared-value-write-missing"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:1234

Diagnostic code for a member node that writes a declared graph value its write= access does not grant (ValidateMemberDeclaredValueAccess).

IsConditionFieldComparable(BehaviorSourceFieldType leftType, BehaviorSourceFieldType rightType)

Section titled “IsConditionFieldComparable(BehaviorSourceFieldType leftType, BehaviorSourceFieldType rightType)”
C#
public static bool IsConditionFieldComparable(BitQuirky.Behavior.Authoring.BehaviorSourceFieldType leftType, BitQuirky.Behavior.Authoring.BehaviorSourceFieldType rightType)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3164-3171

Whether a built-in condition may compare a field ofleftType against a field ofrightType: the same type always, and int32 against float32 either way, because the runtime compares both in a representation that holds every value of each exactly, so the narrower side only ever widens.

Validate(BehaviorSourceAst ast, BehaviorValidationOptions options)

Section titled “Validate(BehaviorSourceAst ast, BehaviorValidationOptions options)”
C#
public static BitQuirky.Behavior.Authoring.BehaviorValidationResult Validate(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationOptions options = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:880-925

Run every validation pass overast. Always runs all passes (collects every diagnostic) - does not bail on the first error.

ValidateAuthority(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateAuthority(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateAuthority(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:2970-3009

ClientPresentationmay not write to a slot anyHostAuthoritativenode also writes (the slot would be host-authoritative and the client-presentation write would race the host).

ValidateBlackboardConditionComparisons(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateBlackboardConditionComparisons(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateBlackboardConditionComparisons(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3045-3105

Validates the built-in blackboard condition comparison against the selected field type. The compare-to value may be a literal or a blackboard field of the same type; a numeric field also compares against a numeric field of the other width, the int32 side widening to the comparison’s exact representation , while a bool field compares only against a bool.

ValidateConditionalDecorators(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateConditionalDecorators(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateConditionalDecorators(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:2869-2892

Validates that every conditional decorator owns exactly one guarded child.

ValidateDeclaredReferences(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateDeclaredReferences(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateDeclaredReferences(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:1152-1222

Read / write / waits set membership.

ValidateDeclaredValueNames(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateDeclaredValueNames(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateDeclaredValueNames(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:933-957

Declared blackboard variable names are references, so each is validated as one: a valid identifier, unique among declared variables, and never the name of a declared external service. An invalid name is reported with the rule stated and the authored name kept, never silently rewritten.

ValidateExtensions(BehaviorSourceAst ast, BehaviorValidationOptions options, BehaviorValidationResult result)

Section titled “ValidateExtensions(BehaviorSourceAst ast, BehaviorValidationOptions options, BehaviorValidationResult result)”
C#
public static void ValidateExtensions(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationOptions options, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3422-3503

Runs only the consumer validation extensions supplied for this operation.

ValidateGraphConnectivity(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateGraphConnectivity(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateGraphConnectivity(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:2763-2825

Every semantic node must be reachable from the single top-level graph root by following authored Mermaid edges.

ValidateHeader(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateHeader(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateHeader(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:1083-1095

Header well-formedness.

ValidateHostedBehaviorConfiguration(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateHostedBehaviorConfiguration(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateHostedBehaviorConfiguration(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:2166-2306

Hosted lifecycle settings belong only to states with one unambiguous immediate tree root, and result-event transition edges consume an event configured by their source state.

ValidateHostedStateMachineReferenceShape(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateHostedStateMachineReferenceShape(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateHostedStateMachineReferenceShape(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3260-3297

Validates a Hosted State Machine node’s resolved address: the referenced asset must be FSM-rooted (not a Behavior Tree). Mapping a terminal state or normal completion to Success or Failure is optional (FSM-013 P1, matching NodeCanvas’s SubFSM): a machine with no mapping at all, with only a Success mapping, or with only a Failure mapping is each a valid hosted reference. When the host node itself names a Success-state or Failure-state override (FSM-013 P2,success_state/failure_state), that named state must exist in the referenced machine as a State or Entry node.

ValidateMemberBindings(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateMemberBindings(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateMemberBindings(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3512-3553

Source-local structural member-binding validation: binding cardinality, unique binding ids, operation-appropriate records, access-flag agreement, static-target agreement, explicit-reference slot-key consistency, and deterministic blackboard projection collisions. Runs without loaded types; exact member resolution lives in ValidateMemberResolution.

ValidateMemberDeclaredValueAccess(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateMemberDeclaredValueAccess(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateMemberDeclaredValueAccess(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:1258-1297

Every authored member-node reference to a declared graph value must have that node’s matching declared read or write access before the graph can validate or bake (“Public graph authoring contract”; ). This is a thin loop over the single shared enumerator CollectDeclaredAccessNeeds, so a form that starts projecting a write (Blackboard, Outcome, BehaviorStatus, or Awaitable) cannot silently skip this gate the way an inlineForm == Blackboardcheck once did (, finding D2), and the editor’sEditMemberBindingCommandcommit choke point consults the exact same enumerator so it never grants access the validator would still refuse. Checks by-value member arguments (including a ref/out parameter’s write-back destination, whatever its authored argument source), expanded/array params values, a blackboard-mode target, a comparison’s blackboard right operand, a method result’s projected destination, and an explicitly overridden property/field projection that aliases a declared value:to-blackboardreads the member and writes the declared value,to-memberreads the declared value and writes the member, andtwo-wayrequires both. A projected member-surface output name that is not itself a declared graph value (see BehaviorSourceDeclaredValueOrigin) is never treated as a graph-value reference under this rule, and a value’s existence or correct type is never treated as permission for either direction.

ValidateMemberResolution(BehaviorSourceAst ast, BehaviorValidationResult result, BehaviorMemberConverterRegistry converterRegistry, IBehaviorEntityConverterBurstCompatibilityAnalyzer burstAnalyzer)

Section titled “ValidateMemberResolution(BehaviorSourceAst ast, BehaviorValidationResult result, BehaviorMemberConverterRegistry converterRegistry, IBehaviorEntityConverterBurstCompatibilityAnalyzer burstAnalyzer)”
C#
public static void ValidateMemberResolution(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result, BitQuirky.Behavior.Member.BehaviorMemberConverterRegistry converterRegistry = null, BitQuirky.Behavior.Member.IBehaviorEntityConverterBurstCompatibilityAnalyzer burstAnalyzer = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3694-3703

Exact member resolution over loaded types: target and declaring type resolution, exact member and overload selection, signature-shape and public-access rules, supported value kinds, argument, result, comparison, and notification conversions, and 64-bit contract-hash collision rejection. Emits one structured BehaviorMemberBindingDiagnosticper independent failure in source order and projects each into a plain error diagnostic.

ValidateNodeMetadata(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateNodeMetadata(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateNodeMetadata(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:1100-1147

Per-node metadata well-formedness.

ValidateProbabilitySelectors(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateProbabilitySelectors(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateProbabilitySelectors(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:1428-1538

Probability-selector edges must declare a bounded, usable weight set. The optional Direct failure outcome joins that set, so a positive Direct failure weight is enough on its own to make the composite pickable, including with no children at all.

ValidateReactiveConditions(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateReactiveConditions(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateReactiveConditions(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:2832-2864

Validates that every Lower Priority condition belongs to a selector branch with a lower-priority sibling that can be interrupted, and that every Self conditional decorator is nested within a selector branch that owns its fallback order.

ValidateRegistryDescriptors(BehaviorSourceAst ast, NodeAuthoringRegistry registry, BehaviorValidationResult result)

Section titled “ValidateRegistryDescriptors(BehaviorSourceAst ast, NodeAuthoringRegistry registry, BehaviorValidationResult result)”
C#
public static void ValidateRegistryDescriptors(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Nodes.NodeAuthoringRegistry registry, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3339-3349

Cross-check source metadata against registered C# node-author descriptors, then enforce determinism x authority compatibility.

ValidateSelfSubgraphCycle(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateSelfSubgraphCycle(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateSelfSubgraphCycle(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3244-3249

Convenience - runsValidateSelfSubgraphCycle with no address (a no-op) so the standard pipeline can still list the call without special-casing.

ValidateSelfSubgraphCycle(BehaviorSourceAst ast, string ownAddress, BehaviorValidationResult result)

Section titled “ValidateSelfSubgraphCycle(BehaviorSourceAst ast, string ownAddress, BehaviorValidationResult result)”
C#
public static void ValidateSelfSubgraphCycle(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, string ownAddress, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3214-3237

Detect a single-source cycle: a behavior source that contains a subgraph reference back to its own source address. The caller passes the source’s own address via ownAddress; when null/empty (e.g. a unit test usingBakeFromText), this check is skipped.

ValidateStateCompletionSemantics(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateStateCompletionSemantics(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateStateCompletionSemantics(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:2416-2581

Validates cadence, self-reentry, and Any State topology before those authored choices can reach the baked runtime contract.

ValidateSubgraphReferenceShape(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateSubgraphReferenceShape(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateSubgraphReferenceShape(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:3016-3036

Per-source check that every subgraph reference has a non-empty source address. Cross-source cycle detection is the loader’s job (it’s stream-driven over async resolution).

ValidateTopLevelStructure(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateTopLevelStructure(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateTopLevelStructure(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:2709-2757

Single behavior-tree root, or a single Statechart Root + one entry state.

ValidateTransitionConditionGroups(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateTransitionConditionGroups(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateTransitionConditionGroups(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:1663-1794

Explicit transition groups must target a transition node and compare fields in that node’s read set against either a type-compatible literal or a same-type graph value that is itself declared and in that read set ( through ).

ValidateUtilitySelectors(BehaviorSourceAst ast, BehaviorValidationResult result)

Section titled “ValidateUtilitySelectors(BehaviorSourceAst ast, BehaviorValidationResult result)”
C#
public static void ValidateUtilitySelectors(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidator.cs:1550-1656

Utility Selector branch edges must author 1 to MaximumUtilityConsiderationsPerBranchconsiderations, each naming a numeric field declared in the selector’s own read set; more than one consideration requires an authored aggregation; a present curve requires at least two keys (research D-R2, D-R11; contract utility-selector-node.md).

Category: Source authoring

C#
interface BitQuirky.Behavior.Authoring.IBehaviorStateMachineConditionProvider

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorStateMachineConditionProvider.cs:17-23

Consumer-owned source of condition fields available to State Machine authoring.

Responsibilities:

  • Advertise exact Int32 field identifiers that the consuming project can bind at runtime.
  • Filter suggestions against the State Machine source being edited when necessary.

Does NOT:

  • Mutate source, declare fields, provide runtime values, or select a condition automatically.

GetConditionFieldIds(BehaviorSourceAst ast)

Section titled “GetConditionFieldIds(BehaviorSourceAst ast)”
C#
System.Collections.Generic.IReadOnlyList<string> GetConditionFieldIds(BitQuirky.Behavior.Authoring.BehaviorSourceAst ast)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorStateMachineConditionProvider.cs:22

Returns the Int32 field identifiers available to the supplied source.

Category: Source authoring

C#
interface BitQuirky.Behavior.Authoring.IBehaviorValidationExtension

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidationExtension.cs:52-65

Game-neutral hook for validation rules supplied by an explicitly composed consumer.

Responsibilities:

  • Identify the source validation profile it implements with a stable token.
  • Append structured diagnostics for consumer-owned rules.

Does NOT:

  • Register itself globally, replace package validation, or substitute authored values.

C#
string ProfileToken { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidationExtension.cs:57

Stable lowercase profile token used by source format 1.1 selection.

Validate(BehaviorValidationContext context, BehaviorValidationResult result)

Section titled “Validate(BehaviorValidationContext context, BehaviorValidationResult result)”
C#
void Validate(BitQuirky.Behavior.Authoring.BehaviorValidationContext context, BitQuirky.Behavior.Authoring.BehaviorValidationResult result)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/BehaviorValidationExtension.cs:62-64

Appends extension diagnostics toresultwithout mutating the AST.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.MermaidBehaviorSourceReader

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1355-6681

Parser for the Mermaid behavior-source format defined in

and the consuming project’s behavior-authoring guide.

Responsibilities:

  • Tokenize a Mermaid.bqbehaviorinto a round-trip-preserving BehaviorSourceDocumentand a semantic BehaviorSourceAst.
  • Recognize optional per-node metadata blocks, layout blocks, node lines, and edge lines.
  • Preserve metadata omission for descriptor resolution and emit diagnostics for malformed structure and duplicate or malformed node ids. Custom operation tokens remain exact for registry validation.

Does NOT:

  • Validate cross-node semantic rules (subgraph cycles, statechart root cardinality, authority violations). Those live in BehaviorBaker / BehaviorValidator.
  • Resolve subgraph references. That is the loader’s job.
  • Mutate the source text. The parser is read-only.

C#
public static bool IsStableEventId(string eventId)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1545-1548

Gets whether text is a valid stable event id: lowercase ASCII letters, digits, and underscores, beginning with a lowercase letter or underscore.

C#
public static BitQuirky.Behavior.Authoring.BehaviorSourceParseResult Parse(string sourceText)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1571-1599

Parse a Mermaid behavior source. Always returns a result; check HasErrorsbefore use.

TryReadHostedResultEventLabel(string label, out string eventId)

Section titled “TryReadHostedResultEventLabel(string label, out string eventId)”
C#
public static bool TryReadHostedResultEventLabel(string label, out string eventId)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceReader.cs:1555-1565

Reads the authored identity text from an explicit lowercaseevent:edge label. Returns true for malformed and empty identities so editor validation can keep them visible and repairable.

Category: Source authoring

C#
class BitQuirky.Behavior.Authoring.MermaidBehaviorSourceWriter

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceWriter.cs:29-1992

Writer for the Mermaid behavior-source format defined in

and the consuming project’s behavior-authoring guide.

Responsibilities:

  • Serialize aBehaviorSourceDocumentback to normalized source, preserving whether each node omitted its descriptor-owned metadata block.
  • Normalize explicit metadata in authority / read / write / waits order, sort layout keys, collapse blank lines, remove trailing whitespace, and emit one trailing LF.
  • Preserve source order, node ids and casing, and passthrough comments verbatim.

Does NOT:

  • Re-allocate node ids or re-shape the graph.
  • Resolve subgraph references or run any bake-time validation.
  • Stamp the source-content hash into the canonical .bqbehavior (R-9: bake/build MUST NOT dirty .bqbehavior files).

C#
public static string Write(BitQuirky.Behavior.Authoring.BehaviorSourceDocument document)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceWriter.cs:39-255

Serialize the document to a normalized Mermaid behavior source. Open → no semantic edits → save → byte-for-byte identical, modulo the documented normalization rules in the consuming project’s behavior-authoring guide.

WriteToString(BehaviorSourceDocument document)

Section titled “WriteToString(BehaviorSourceDocument document)”
C#
public static string WriteToString(BitQuirky.Behavior.Authoring.BehaviorSourceDocument document)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Authoring/MermaidBehaviorSourceWriter.cs:262

Write the document to a text representation. Convenience overload that throws when given a null document, otherwise identical to Write.

Source fingerprint: sha256:29003d8b1658b98a79bebcd93e3b4030caf8511268b96817ab764d63df8d6c3b

Full-size image