paths
Lists available canonical pack-relative file paths.
Return
caller-readable paths without leading separators or parent traversal.
Throws
when the source cannot be enumerated.
Lists paths under inclusive entry and path ceilings, checking while enumerating where possible. The default checks an already bounded original paths result before loader copying.
Return
caller-readable canonical paths, never retained by a snapshot.
Parameters
immutable ceilings, tightened to remaining aggregate entry capacity.
Throws
when a ceiling is exceeded; interrupted enumeration consumes its allowance and detection entry.
when ordinary enumeration fails; those failures are not converted into budget diagnostics.
Enumerates paths while reporting each examined entry before validation or filtering. Directory and ignored entries count even when absent from the returned set; implementations must stop if the callback throws. The callback is synchronous, owner-thread-only, and must not be retained; late or foreign-thread calls fail before changing loader counters. The default reports the bounded original result, so sources that filter physical entries must override this method.
Return
canonical file paths without transferring stream ownership.
Parameters
immutable ceilings tightened to remaining snapshot capacity.
synchronous callback that charges one entry and may throw when aggregate capacity is exhausted.
Throws
when enumeration, validation, or the callback fails; owned streams must still close.