aspid-profiler-marker

this.Marker()

this.Marker() returns a ProfilerMarker.AutoScope for a marker that a source generator creates for that exact call site. No field, name string, attribute or partial is needed; works in classes, structs (including Burst jobs) and ref structs.

• If the user's scripts have an .asmdef, it must reference Aspid.FastTools. No using is needed.
• Without ENABLE_PROFILER (release players) every call returns default; do not add guards.

public void Step()
{
    using var _ = this.Marker();                          // FlockSimulation.Step (12)

    using (this.Marker().WithName("Steering"))            // FlockSimulation.Steering (14)
        foreach (var agent in _agents)
            using (this.Marker().WithName("Steering.Agent"))   // one row, Calls = agent count
                ComputeSteering(agent);
}

Profiler nesting follows using nesting. Markers in loops, lambdas and local functions are fine. A scope held across yield return or await resumes in a later frame or on another thread and leaves the samples unbalanced — warning AFT0013; put the marker inside each synchronous step.

Names

Type.Member (line), where line is the line of the Marker() call:

• constructor -> Ctor; static constructor -> StaticCtor; finalizer -> Finalize; property or indexer accessor -> property name / Indexer; event accessor -> event name; field or auto-property initializer -> field / property name; operator -> op_Addition and the like; lambda or local function -> the enclosing member; explicit interface implementation -> the interface member name;
• nested type -> only the innermost type name (Agent.Move (line)), so same-named types in different namespaces or outer types show the same name;
• generic class -> one marker per closed type (Worker<List<Int32>>.Run (line)); generic struct -> one marker for all (Job<T>.Execute (line)), so Burst can compile it.

WithName("X") replaces only the member part (FlockSimulation.X (line)). It is read from source at compile time, chained directly on this.Marker(): a literal, a const, nameof(...), or a concatenation or interpolation of them counts. Any other value (a variable, a static readonly field, a format or alignment in a hole) keeps the member name — warning AFT0014. For runtime-computed names use a hand-written static readonly ProfilerMarker.