Function admitRefinementCandidate

admitRefinementCandidate(
    path: string,
    loader: RefinableLoader,
    residencyBudget?: RefinementResidencyBudget,
    isPathVisible?: (path: string) => boolean,
): RefinementAdmissionDecision
Decide whether one loader may refine this pass.

Four reasons to decline, in order of cost: it has no more levels; it has already failed MAX_CONSECUTIVE_REFINEMENT_FAILURES times; it is culled or hidden; or the shared residency ceiling refused it.

The first check also keeps single-level geometry out of the loop. This is especially important for meshes, where that is the overwhelmingly common case and whole-node loaders do not expose a ladder.
Parameters
- path: string
  Node path, used as the key for backoff and admission state.
- loader: RefinableLoader
  The loader being offered.
- OptionalresidencyBudget: RefinementResidencyBudget
  Shared residency ceiling; absent means unbounded.
- OptionalisPathVisible: (path: string) => boolean
  Live culling/layer-visibility predicate.
Returns RefinementAdmissionDecision
Whether to proceed, and the byte allowance if one was granted.
- Defined in src/data/scene-loader/progressive/refinement-wrapper.ts:122