footprintjs 9.41.0 → 9.43.0

package/dist/esm/lib/builder/FlowChartBuilder.d.ts

@@ -606,24 +606,27 @@ export declare class FlowChartBuilder<TOut = any, TScope = any> {
      * `addFunction(...).addListOfFunction(...)` already builds, which every
      * reader (engine, resume, structure, spec) handles. A second fan-out call
      * reuses that node, as it would any cursor. The id is reserved both ways:
-     * refused here when a stage already has it, and by `_addToMap` /
+     * refused here when a stage already has it, and by stage admission /
      * `_registerSubflowDef` when a later stage or mount asks for it.
      */
     private _needForkParent;
     /** Ids `_needForkParent` generated — no later stage or mount may take one. */
     private _forkNodeIds;
-    /** Asked by `_addToMap` / `_registerSubflowDef`: an id a generated fork node or a claiming door holds is refused. */
+    /** Shared by stage admission and subflow registration: reserved structural ids cannot be reused. */
     private _refuseForkNodeId;
     /** Ids the lazy-mount and parallelForEach doors claimed (they register in no map). */
     private _claimedIds;
+    /** Structural declarations without an embedded function; not function entries or loop targets. */
+    private _functionlessStageIds;
     /** True when an earlier stage, branch, fork child, mount or generated fork node holds `id`. */
     private _idTaken;
     /**
      * @internal The lazy-mount doors and `addParallelForEach` register their id
      * in no map, so through 9.37.0 they accepted an id another stage or mount
      * already had (and a later stage could take theirs). They claim it here:
-     * refused when taken, recorded when fresh. Loop-ref stubs never pass
-     * through a door, so they stay the one deliberate duplicate.
+     * refused when taken, recorded when fresh. Loop-ref stubs reference an
+     * existing stage rather than claiming a new id. Reusable function stages
+     * retain their separate `_addToMap` rule.
      */
     _claimFreshId(id: string, door: string): void;
     /**
@@ -656,6 +659,13 @@ export declare class FlowChartBuilder<TOut = any, TScope = any> {
      * here, at build time, where the id can still be changed.
      */
     _registerSubflowDef(id: string, root: StageNode<TOut, TScope>): void;
+    /**
+     * @internal One admission path for optional-function children and branches.
+     * A missing function does not erase the graph identity: check reservations
+     * and record it for future fresh-id claims, without adding a function or a
+     * loop target. Existing function references by id/name remain legal.
+     */
+    _registerStage(id: string, fn: StageFunction<TOut, TScope> | undefined): void;
     _addToMap(id: string, fn: StageFunction<TOut, TScope>): void;
     _mergeStageMap(other: Map<string, StageFunction<TOut, TScope>>, prefix?: string): void;
     /**