@huukhanhnguyen/model / nodes/ContainerNode

nodes/ContainerNode#

ContainerNode#

Extends#

• BaseNode

Constructors#

Constructor#

new ContainerNode(key): ContainerNode

Parameters#

key#

string

Returns#

ContainerNode

Overrides#

BaseNode.constructor

_dependents#

_dependents: Set<BaseNode>

Inherited from#

BaseNode._dependents

_epoch#

_epoch: number = 0

Bumped on every dirty (see setDirty/markDirty) — a stale async settle compares its captured epoch against the current one and discards itself on mismatch (a newer edit superseded it while it was in flight).

Inherited from#

BaseNode._epoch

_hooks?#

optional _hooks?: NodeHooks

Lifecycle observers attached to THIS node — see nodes/hooks.ts. Also carried by an DataDefinition, the declaration surface a node's hooks can be attached to before the node exists.

Inherited from#

BaseNode._hooks

_reads#

_reads: Set<BaseNode>

Reverse index of nodes this node currently reads (static expression refs + dynamic dependOn edges). Cleared at the start of every dirty recompute and on dispose so a dropped Table.get/sampleTexture edge stops cascading markDirty (and a disposed node is not retained).

Inherited from#

BaseNode._reads

attributes#

attributes: Record<string, unknown> = {}

Inherited from#

BaseNode.attributes

children#

children: NodeCollection<BaseNode>

Child collection holding this Group's operations list.

claims#

claims: ObjectClaims = {}

collection#

collection: BaseCollection

Inherited from#

BaseNode.collection

editorExpanded#

editorExpanded: boolean = true

enabled#

enabled: ArgumentNode | null = null

Optional enable expression — falsy = the Group contributes nothing.

error?#

optional error?: string = ""

Last error message; empty string when valid, undefined after a successful eval.

Inherited from#

BaseNode.error

id#

id: string

Inherited from#

BaseNode.id

instances?#

optional instances?: NodeInstance[]

Authored placements. Absent === one identity at the object door.

isDirty#

isDirty: boolean = true

True when the node needs re-evaluation before its value can be trusted.

Inherited from#

BaseNode.isDirty

key#

key: string = ""

Identifier naming this Group's fold result in expressions.

label#

label: ArgumentNode

Label argument rendered as the node's display name — always a live ArgumentNode (default expression ''), same contract as DataNode.label — see its doc comment.

lane#

lane: ModelLane = "scene"

Which model section this Group was declared in.

parent?#

optional parent?: any

Inherited from#

BaseNode.parent

pending#

pending: boolean = false

True while an async compute() is in flight (its result hasn't settled yet).

Inherited from#

BaseNode.pending

properties?#

optional properties?: PropertyNode[]

Steps writing instances[] fields — evaluated at the object door, never part of this Group's fold.

sourceId#

sourceId: string = ""

Inherited from#

BaseNode.sourceId

value#

value: ChainState = undefined

Cached stream produced by the last evaluate() call (own fold result).

Overrides#

BaseNode.value

Accessors#

dependents#

Get Signature#

get dependents(): Set<any>

Returns#

Set<any>

Overrides#

BaseNode.dependents

errorLogPrefix#

Get Signature#

get protected errorLogPrefix(): string

console.error prefix on a compute failure — override to match a subclass's existing log message (includes node-specific context).

Returns#

string

Overrides#

BaseNode.errorLogPrefix

globalKey#

Get Signature#

get globalKey(): string

Returns#

string

model#

Get Signature#

get model(): any

Returns#

any

Inherited from#

BaseNode.model

operations#

Get Signature#

get operations(): (DataNode | ContainerNode)[]

Operation/Group children in declaration order (the fold list).

Returns#

(DataNode | ContainerNode)[]

owner#

Get Signature#

get owner(): any

Walk up to the nearest owner that has a nodes collection (ModelScope).

Returns#

any

Inherited from#

BaseNode.owner

return#

Get Signature#

get return(): string

Containers hold mixed kinds — reference values never single-unwrap.

Returns#

string

symbol#

Get Signature#

get symbol(): string

Returns#

string

Inherited from#

BaseNode.symbol

valueType#

Get Signature#

get valueType(): string

Returns#

string

Overrides#

BaseNode.valueType

Methods#

_commit()#

protected _commit(raw, isAsync, settle?): void

Protected (not private): ExpressionNode/ContainerNode's evaluate() overrides call this directly to reuse the exact same commit path for a volatile step that bypasses the isDirty gate.

Parameters#

raw#

unknown

isAsync#

boolean

settle?#

EvaluateSettle

Returns#

void

Inherited from#

BaseNode._commit

_dispose()#

_dispose(): void

Returns#

void

Inherited from#

BaseNode._dispose

_fail()#

protected _fail(err, isAsync, settle?): void

Protected (not private) — see _commit's doc.

Parameters#

err#

unknown

isAsync#

boolean

settle?#

EvaluateSettle

Returns#

void

Inherited from#

BaseNode._fail

addListener()#

addListener(event, listener): () => void

Parameters#

event#

string

listener#

Listener

Returns#

() => void

Inherited from#

BaseNode.addListener

compute()#

compute(): ChainState | Promise<ChainState>

Compute the raw value for this node; override in subclasses to produce actual output.

Returns#

ChainState | Promise<ChainState>

Overrides#

BaseNode.compute

computeUntil()#

computeUntil(stopBefore): ChainState

The fold state up to (not including) stopBefore, baked to concrete geometry — what that step sees as input. Reads the per-step caches (pulling the fold fresh first), so this is cheap. Used by the UI for filter-arg hover previews.

Parameters#

stopBefore#

DataNode | ContainerNode

Returns#

ChainState

copy()#

copy(): ContainerNode | null

Duplicate this node in its collection, inserting it right after the original.

Returns#

ContainerNode | null

Overrides#

BaseNode.copy

display()#

display(listener?): string

Return the human-readable display string for this node's value (or its error message).

Parameters#

listener?#

() => void

Returns#

string

Inherited from#

BaseNode.display

errorValue()#

protected errorValue(): unknown

Value to fall back to when compute()/postCompute() throws. Override for a node whose "empty" isn't undefined (ContainerNode: []).

Returns#

unknown

Overrides#

BaseNode.errorValue

evaluate()#

evaluate(listener?): unknown

Evaluate this node, cache the result, and notify dependents; returns the cached value. When compute() returns a thenable, this returns the prior (stale) value synchronously and settles later — see core/maybeAsync.ts.

Parameters#

listener?#

() => void

Returns#

unknown

Inherited from#

BaseNode.evaluate

finishInit()#

finishInit(): void

Assembly is complete: this node has its full structure and its children. Every assembly path calls it at the point wiring is genuinely done, which is NOT one line:

• the classes that take everything as constructor parameters (the LaneNode family, ExpressionNode, OptionNode, ArgumentNode) call it at the end of their own constructor;
• DataNode calls it after its args are pushed — fromRegistry and copy, never its constructor, which sets only method+definition;
• ContainerNode after its children are attached, ParameterNode after its args are wired (NodeCollection: createFromJSON, addContainer, addEntry).

Guarded to fire at most once. That is what makes NESTED assembly safe — createFromJSON delegates to fromRegistry, and one node must see one init, not two — and makes a redundant call harmless rather than wrong.

Returns#

void

Inherited from#

BaseNode.finishInit

getError()#

getError(listener?): string | undefined

Parameters#

listener?#

() => void

Returns#

string | undefined

Inherited from#

BaseNode.getError

isPending()#

isPending(listener?): boolean

True while an async compute() is still settling (see pending).

Parameters#

listener?#

() => void

Returns#

boolean

Inherited from#

BaseNode.isPending

isValid()#

isValid(listener?): boolean

Parameters#

listener?#

() => void

Returns#

boolean

Inherited from#

BaseNode.isValid

notify()#

notify(event, ...args): void

Parameters#

event#

string

args#

...unknown[]

Returns#

void

Inherited from#

BaseNode.notify

postCompute()#

protected postCompute(raw): unknown

Post-process compute()'s raw result into this.value; throw to signal a failure (caught by evaluate()'s template, same as a compute() throw). Override for a node whose value isn't a sanitizer-typed scalar: ContainerNode returns the data list as-is; ArgumentNode routes through the domain coercion pipeline (nodeMethods/parameter.ts + data/ asset resolution) instead of convert/validate.

Parameters#

raw#

unknown

Returns#

unknown

Overrides#

BaseNode.postCompute

remove()#

remove(): void

The removal door. BaseObject.remove() detaches from the collection and notifies "remove"; the pair brackets that, so beforeRemove still sees the node in its collection with its read edges intact.

afterRemove means "AFTER THE NODE LEFT ITS COLLECTION" — it does NOT promise the node's read edges are gone. Deliberately does not retractReads(): removing a node does not retract its edges today, only the disposal call sites do (tables.ts), and adding it here would be a behaviour change rather than an observation point.

Not anchored at retractReads() — that runs on EVERY dirty recompute (3 of its 6 call sites: evaluate, LaneNode.pull, evaluateStep), so hooks there would report a live node as removed on every evaluate.

Returns#

void

Inherited from#

BaseNode.remove

removeListener()#

removeListener(event, listener): void

Parameters#

event#

string

listener#

Listener

Returns#

void

Inherited from#

BaseNode.removeListener

retractReads()#

retractReads(): void

Drop every reverse read edge recorded in _reads.

Returns#

void

Inherited from#

BaseNode.retractReads

setEnabled()#

setEnabled(expr): void

Parameters#

expr#

string | null

Returns#

void

setError()#

setError(message): void

Set an error message on this node and notify listeners. Fires "error" (specific) and "change" (the universal event — see ParameterNode.setKey's doc).

Parameters#

message#

string

Returns#

void

Inherited from#

BaseNode.setError

setKey()#

setKey(key): void

Parameters#

key#

string

Returns#

void

setLabel()#

setLabel(expr): void

Parameters#

expr#

string | null

Returns#

void

toJSON()#

toJSON(): BaseObjectJSON

Returns#

BaseObjectJSON

Overrides#

BaseNode.toJSON

FoldRunner#

Constructors#

Constructor#

new FoldRunner(): FoldRunner

Returns#

FoldRunner

claims#

claims: ObjectClaims = {}

Methods#

run()#

run(children, settle?): ChainState | Promise<ChainState>

settle is the scope's end-of-fold phase (the block behaviors — see behaviors.ts). It runs on the FREE remainder, BEFORE the shielded documents rejoin: a lock partitions the stream against every LATER step, and the settle phase is the last of them. Running it after the rejoin cut locked content — a wall shielded by applyLocked still lost its doorway.

Parameters#

children#

readonly BaseNode[]

settle?#

(state) => ChainState

Returns#

ChainState | Promise<ChainState>