@graphty/webgpu-graph-algorithms 0.5.1 → 0.6.0

package/dist/src/layouts/model-common.d.ts

@@ -1,12 +1,50 @@
 /**
- * The option and value helpers every force model's resolver and stats decoder share (PD-7): moved verbatim from
- * src/layouts/forceatlas2.ts (P3-T2) so the Fruchterman-Reingold and spring-electrical models of P5 neither copy
- * them nor import a sibling model. Layout zone; imports errors.ts only.
+ * The option and value helpers every force model's resolver and stats decoder share (P5 PD-7): moved verbatim
+ * from src/layouts/forceatlas2.ts (P3-T2) so the Fruchterman-Reingold and spring-electrical models of P5 neither
+ * copy them nor import a sibling model; and, since P4-T6, the K2 tier binding and dispatch the three models share
+ * (`bindAttraction` / `recordAttraction`, P4 PD-7), so every model's bind() / recordIteration() calls one function
+ * instead of holding its own copy. Layout zone.
  */
 import { WebGpuGraphError } from "../errors.js";
+import { type DispatchPlan } from "../kernel/dispatch.js";
+import { type BoundKernel, type Kernel } from "../kernel/kernel.js";
 import { type UniformValues } from "../kernel/struct-block.js";
+import { type Binding } from "../types/memory.js";
+import { type ModelResources } from "./force-simulation.js";
 /** An override record as the kernel layer takes it. */
 export type Overrides = Readonly<Record<string, number | boolean>>;
+/** The K2 (`fa2-attraction`) dispatches of one iteration: `[kernel, bind group, plan]` in dispatch order TIER 2, TIER 1, TIER 0 (only the tiers whose row range is non-empty). */
+export interface AttractionBound {
+    readonly kernels: readonly (readonly [Kernel, BoundKernel, DispatchPlan])[];
+}
+/** The group-1 / group-2 bindings of K2 every tier dispatch shares: `pos` (vec4f, mass in w), `force` (stride-3 f32) and the Fa2Params slot of the UniformRing. @public the bindings parameter of bindAttraction */
+export interface AttractionBindings {
+    readonly pos: Binding;
+    readonly force: Binding;
+    readonly params: Binding;
+}
+/**
+ * Compiles (through the cache) and binds the `fa2-attraction` pipelines a load needs against the graph group and
+ * { pos, force, P } (P4 PD-7): TIER 0 always; TIER 1 when a row of degree 32..1023 exists (`[hiEnd, midEnd)` is
+ * non-empty); TIER 2 when a row of degree >= 1024 exists (`hiEnd > 0`). The dispatch plans are one workgroup per
+ * row for TIER 2, `WG / 32` rows per workgroup for TIER 1 and one row per thread for TIER 0, over each tier's row
+ * count (the K2 body reads its range from `Fa2Params.hiEnd` / `midEnd` / `tierStart` / `tierEnd`). The TIER 1 / 2
+ * pipelines compile on the first load that needs them (a one-time cost at that load); a model's `specs()` lists
+ * the TIER 0 spec only, because it has no `n` to know which tiers a load needs. A device whose workgroup size is
+ * below 32 cannot fold the mid tier: E_UNSUPPORTED { feature: "fa2-attraction.tiers" } when a permutation is bound.
+ * @param resources - the load's resources (core, tiers, weights, pipelines, caps)
+ * @param k2 - the K2 override record of the model (LINLOG / DISTRIBUTED / LAW plus USE_PERM / HAS_WEIGHTS; TIER is overwritten per dispatch)
+ * @param bindings - the group-1 / group-2 bindings shared by every tier
+ * @returns the bound dispatches in order TIER 2, 1, 0
+ */
+export declare function bindAttraction(resources: ModelResources, k2: Overrides, bindings: AttractionBindings): Promise<AttractionBound>;
+/**
+ * Records the K2 dispatches of one iteration in order TIER 2, TIER 1, TIER 0 with the iteration's params offset.
+ * @param pass - the open compute pass
+ * @param bound - what bindAttraction produced
+ * @param paramsOffset - the UniformRing byte offset of this iteration's Fa2Params
+ */
+export declare function recordAttraction(pass: GPUComputePassEncoder, bound: AttractionBound, paramsOffset: number): void;
 /** Bytes of the stride-3 f32 force arrays per node. */
 export declare const FORCE_BYTES_PER_NODE = 12;
 /** The name of the model-owned FillParams buffer (a BufferSpec, reached through ModelResources.buffer). */

package/dist/src/layouts/model-common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-common.d.ts","sourceRoot":"","sources":["../../../src/layouts/model-common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,uDAAuD;AACvD,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;AAEnE,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,2GAA2G;AAC3G,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAK/C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcpD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAM5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,EACjC,QAAQ,EAAE,MAAM,GACjB,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAMhG;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAMxE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACtB,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,EACpC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC5C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CA2BnC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CASjG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKpD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAM7E;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,SAAS,CAMxE"}
+{"version":3,"file":"model-common.d.ts","sourceRoot":"","sources":["../../../src/layouts/model-common.ts"],"names":[],"mappings":"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"}

package/dist/src/layouts/model-common.js

@@ -1,9 +1,80 @@
 /**
- * The option and value helpers every force model's resolver and stats decoder share (PD-7): moved verbatim from
- * src/layouts/forceatlas2.ts (P3-T2) so the Fruchterman-Reingold and spring-electrical models of P5 neither copy
- * them nor import a sibling model. Layout zone; imports errors.ts only.
+ * The option and value helpers every force model's resolver and stats decoder share (P5 PD-7): moved verbatim
+ * from src/layouts/forceatlas2.ts (P3-T2) so the Fruchterman-Reingold and spring-electrical models of P5 neither
+ * copy them nor import a sibling model; and, since P4-T6, the K2 tier binding and dispatch the three models share
+ * (`bindAttraction` / `recordAttraction`, P4 PD-7), so every model's bind() / recordIteration() calls one function
+ * instead of holding its own copy. Layout zone.
  */
 import { WebGpuGraphError } from "../errors.js";
+import { plan1d } from "../kernel/dispatch.js";
+import { graphBindings, kernelSpec } from "../kernels.js";
+import { MID_TIER_LANES } from "../primitives/core-shape.js";
+/**
+ * Compiles (through the cache) and binds the `fa2-attraction` pipelines a load needs against the graph group and
+ * { pos, force, P } (P4 PD-7): TIER 0 always; TIER 1 when a row of degree 32..1023 exists (`[hiEnd, midEnd)` is
+ * non-empty); TIER 2 when a row of degree >= 1024 exists (`hiEnd > 0`). The dispatch plans are one workgroup per
+ * row for TIER 2, `WG / 32` rows per workgroup for TIER 1 and one row per thread for TIER 0, over each tier's row
+ * count (the K2 body reads its range from `Fa2Params.hiEnd` / `midEnd` / `tierStart` / `tierEnd`). The TIER 1 / 2
+ * pipelines compile on the first load that needs them (a one-time cost at that load); a model's `specs()` lists
+ * the TIER 0 spec only, because it has no `n` to know which tiers a load needs. A device whose workgroup size is
+ * below 32 cannot fold the mid tier: E_UNSUPPORTED { feature: "fa2-attraction.tiers" } when a permutation is bound.
+ * @param resources - the load's resources (core, tiers, weights, pipelines, caps)
+ * @param k2 - the K2 override record of the model (LINLOG / DISTRIBUTED / LAW plus USE_PERM / HAS_WEIGHTS; TIER is overwritten per dispatch)
+ * @param bindings - the group-1 / group-2 bindings shared by every tier
+ * @returns the bound dispatches in order TIER 2, 1, 0
+ */
+export async function bindAttraction(resources, k2, bindings) {
+    const { n, core, perm, tiers, weights, pipelines, caps } = resources;
+    const so = tiers?.segmentOffsets;
+    const hiEnd = so?.[1] ?? 0;
+    const midEnd = so?.[2] ?? 0;
+    const ranges = [
+        { tier: 2, rows: hiEnd },
+        { tier: 1, rows: midEnd - hiEnd },
+        { tier: 0, rows: n - midEnd },
+    ];
+    const group = {
+        ...graphBindings(core, perm, weights),
+        pos: bindings.pos,
+        force: bindings.force,
+        P: bindings.params,
+    };
+    const kernels = [];
+    for (const { tier, rows } of ranges) {
+        if (tier !== 0 && rows <= 0) {
+            continue;
+        }
+        // sequential on purpose: PipelineCache.get compiles inside a validation scope, one stack per device
+        const kernel = await pipelines.kernel(kernelSpec("fa2-attraction", { ...k2, TIER: tier }));
+        const wg = kernel.workgroupSize;
+        if (tier !== 0 && wg < MID_TIER_LANES) {
+            throw new WebGpuGraphError("E_UNSUPPORTED", `fa2-attraction: the mid tier folds ${MID_TIER_LANES} lanes per row, more than the workgroup size ${wg}`, { feature: "fa2-attraction.tiers" });
+        }
+        if (rows <= 0) {
+            continue;
+        }
+        let rowsPerGroup = wg;
+        if (tier === 2) {
+            rowsPerGroup = 1;
+        }
+        else if (tier === 1) {
+            rowsPerGroup = wg / MID_TIER_LANES;
+        }
+        kernels.push([kernel, kernel.bind(group), plan1d(rows, rowsPerGroup, caps)]);
+    }
+    return { kernels };
+}
+/**
+ * Records the K2 dispatches of one iteration in order TIER 2, TIER 1, TIER 0 with the iteration's params offset.
+ * @param pass - the open compute pass
+ * @param bound - what bindAttraction produced
+ * @param paramsOffset - the UniformRing byte offset of this iteration's Fa2Params
+ */
+export function recordAttraction(pass, bound, paramsOffset) {
+    for (const [kernel, group, plan] of bound.kernels) {
+        kernel.dispatch(pass, group, plan, [paramsOffset]);
+    }
+}
 /** Bytes of the stride-3 f32 force arrays per node. */
 export const FORCE_BYTES_PER_NODE = 12;
 /** The name of the model-owned FillParams buffer (a BufferSpec, reached through ModelResources.buffer). */

package/dist/src/layouts/model-common.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-common.js","sourceRoot":"","sources":["../../../src/layouts/model-common.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model-common.js","sourceRoot":"","sources":["../../../src/layouts/model-common.ts"],"names":[],"mappings":"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"}

package/dist/src/layouts/repulsion-grid.d.ts

@@ -0,0 +1,152 @@
+/**
+ * The grid-tier repulsion stage of the force models (spec 7.7, 7.4; P4-T10): G1-G3 through the T8 grid build, G4-G5
+ * through the T9 pyramid, then G6 (`grid-far-field`) and G7 (`grid-near-field`, K3's pair law and epilogue) over
+ * `plan1d(n)`, followed by K4 (`fa2-speed-finalize`) exactly as `RepulsionExact` records it. The named grid buffers
+ * are the model's `BufferSpec`s (`buffers()`, so `inspect(name)` reaches them); the anonymous scratch of the sort
+ * and the scan and the static params of the pyramid draw on ONE `Lease` of the context's pool taken at `create()`
+ * (the scan planner takes its block-sum levels at prepare time) and released by `dispose()` (PD-11, DEP-P4-D: a
+ * per-batch lease would rebuild the G2-G4 bind groups every batch; a model creates one stage per bind(), so a stage
+ * is bound once). The stage is the ONE class every model reaches the grid tier through (PD-22): the FR and
+ * spring-electrical models pass `LAW` 1 / 2 in their override set, which reaches G6's per-cell law and G7's pair law
+ * (P4-T13).
+ */
+import { type PipelineCache } from "../kernel/pipeline-cache.js";
+import { type WgslModuleSpec } from "../kernel/wgsl.js";
+import { type BufferPool } from "../memory/buffer-pool.js";
+import { type GridSpec } from "../primitives/grid.js";
+import { type PlanCaps } from "../types/context.js";
+import { type Binding } from "../types/memory.js";
+import { type BufferSpec } from "./force-simulation.js";
+import { type RepulsionExactOverrides, type RepulsionExactResources } from "./repulsion-exact.js";
+/** The stage names the grid tier records, in dispatch order (the `upTo` vocabulary of recordRepulsion). */
+declare const GRID_STAGES: readonly ["G1", "G2", "G3", "G4", "G5", "G6", "G7"];
+/** A grid stage name. */
+export type GridStage = (typeof GRID_STAGES)[number];
+/**
+ * The buffers the grid-tier repulsion stage binds: the exact tier's plus the named grid buffers of `buffers()`. The
+ * parameter type of RepulsionGrid.bind (knip: exported for the signature, not imported by name).
+ * @public
+ */
+export interface RepulsionGridResources extends RepulsionExactResources {
+    readonly cellKey: Binding;
+    readonly cellVal: Binding;
+    readonly sortedKey: Binding;
+    readonly sortedIdx: Binding;
+    readonly cellHist: Binding;
+    readonly cellStart: Binding;
+    readonly hubList: Binding;
+    readonly hubCounters: Binding;
+    readonly hubArgs: Binding;
+    readonly pyramid: Binding;
+}
+/**
+ * The override set G6 / G7 / K4 compile with: K3's three plus the repulsion law (0 FA2, 1 FR, 2 coulomb; P4-T13,
+ * PD-22).
+ * @public
+ */
+export interface RepulsionGridOverrides extends RepulsionExactOverrides {
+    readonly LAW: 0 | 1 | 2;
+}
+/**
+ * What the stage needs of the context to build its scope: the pieces `ModelResources` carries. The parameter type
+ * of RepulsionGrid.create (knip: exported for the signature, not imported by name).
+ * @public
+ */
+export interface RepulsionGridScope {
+    readonly device: GPUDevice;
+    readonly caps: PlanCaps;
+    readonly pipelines: PipelineCache;
+    readonly pool: BufferPool;
+}
+/** G1-G7 then K4 (spec 7.7, 7.4): the grid tier's repulsion stage. */
+export declare class RepulsionGrid {
+    /** The overrides G6 / G7 / K4 were compiled with (a frozen copy of the argument of create()). */
+    readonly overrides: RepulsionGridOverrides;
+    /** The grid geometry the stage was prepared for. */
+    readonly spec: GridSpec;
+    private readonly caps;
+    private readonly workgroupSize;
+    private readonly box;
+    private readonly build;
+    private readonly pyramid;
+    private readonly far;
+    private readonly near;
+    private readonly speedFinalize;
+    private bound;
+    /**
+     * Holds the planners and kernels; create() is the only caller.
+     * @param scope - the context pieces
+     * @param workgroupSize - the device's workgroup size (every kernel compiles with it)
+     * @param overrides - the override set G6 / G7 / K4 were compiled with
+     * @param spec - the grid
+     * @param box - the lease box the scope's scratch() and params() read
+     * @param build - the T8 planner (G1-G3)
+     * @param pyramid - the T9 planner (G4-G5)
+     * @param kernels - G6 (`far`), G7 (`near`) and K4 (`speedFinalize`)
+     */
+    private constructor();
+    /**
+     * The model-owned buffers of the grid tier (spec 7.3; PD-11): `cellKey` / `cellVal` / `sortedKey` / `sortedIdx`
+     * 4n, `cellHist` / `cellStart` 4 (cells + 2) zeroed, `hubList` one word per possible hub cell, `hubArgs` one
+     * indirect slot, `pyramid` 16 B per pyramid cell zeroed. `hubCounters` (16 B, zeroed) is the MODEL's on every
+     * tier (PD-14: K1 binds it on the exact tier too). n = 0 reports one node's worth of bytes (spec 3.6).
+     * @param n - the node count
+     * @param spec - the grid
+     * @returns the specs
+     */
+    static buffers(n: number, spec: GridSpec): readonly BufferSpec[];
+    /**
+     * The module specs of the grid tier under an override set (for warm() and the compile matrix): the build's
+     * (G1, the sort path `spec.deterministic` selects, the histogram, the scan, the fill), the pyramid's (G4, the
+     * finalize, G4b, G5), G6, G7 and K4.
+     * @param overrides - the override set of the stage
+     * @param spec - the grid (only its `deterministic` flag matters: the pipeline key carries no geometry)
+     * @returns the specs
+     */
+    static specs(overrides: RepulsionGridOverrides, spec: GridSpec): readonly WgslModuleSpec[];
+    /**
+     * Compiles every kernel of the tier through the cache (sequentially: PipelineCache.get compiles inside a
+     * validation scope, one stack per device) over a scope whose scratch and params draw on the stage's lease.
+     * @param scope - the context pieces (device, caps, pipelines, pool)
+     * @param workgroupSize - the device's workgroup size
+     * @param overrides - the SWING_MODE / STRONG_GRAVITY / GRAVITY_CENTER / LAW set of this stage
+     * @param spec - the grid
+     * @returns the stage, ready for bind()
+     */
+    static create(scope: RepulsionGridScope, workgroupSize: number, overrides: RepulsionGridOverrides, spec: GridSpec): Promise<RepulsionGrid>;
+    /**
+     * Builds every bind group once per load(): the build's and the pyramid's bind() (which take their scratch and
+     * write their static params through the lease), then G6, G7 and K4 against the named buffers (the 3.10.1
+     * binding names). A second bind() takes fresh scratch from the same lease and the first bind()'s scratch stays
+     * held until dispose(): the one lease also holds the prepare-time allocations (the scan's block-sum levels), so
+     * it cannot be released on a rebind (the model creates one stage per bind(), so a rebind never happens).
+     * @param resources - the buffers of spec 7.3 plus the grid's
+     */
+    bind(resources: RepulsionGridResources): void;
+    /**
+     * Records G1..G7 for `n` nodes with the params slot's dynamic offset, stopping after `upTo` when given (spec 7.4
+     * grid sequence; the inspect() stage split, spec 11.9 item 2): G1-G3 through the build planner, G4-G5 through the
+     * pyramid planner, then G6 and G7 over plan1d(n).
+     * @param pass - the open compute pass of the batch
+     * @param n - the node count (in [1, the capacity of the grid buffers])
+     * @param paramsOffset - the dynamic offset of this iteration's Fa2Params slot in the uniform ring
+     * @param upTo - the last grid stage to record (default "G7")
+     */
+    recordRepulsion(pass: GPUComputePassEncoder, n: number, paramsOffset: number, upTo?: GridStage): void;
+    /**
+     * Records K4 only (one workgroup).
+     * @param pass - the open compute pass
+     * @param paramsOffset - the dynamic offset of the Fa2Params slot
+     */
+    recordSpeedFinalize(pass: GPUComputePassEncoder, paramsOffset: number): void;
+    /** Releases the lease (the sort and scan scratch, the static params) and drops the bind groups; idempotent. */
+    dispose(): void;
+    /**
+     * The bound groups, or E_NOT_LOADED when bind() has not run.
+     * @param method - the caller's name for the message
+     * @returns the bound groups
+     */
+    private requireBound;
+}
+export {};
+//# sourceMappingURL=repulsion-grid.d.ts.map

package/dist/src/layouts/repulsion-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repulsion-grid.d.ts","sourceRoot":"","sources":["../../../src/layouts/repulsion-grid.ts"],"names":[],"mappings":"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"}

package/dist/src/layouts/repulsion-grid.js

@@ -0,0 +1,318 @@
+/**
+ * The grid-tier repulsion stage of the force models (spec 7.7, 7.4; P4-T10): G1-G3 through the T8 grid build, G4-G5
+ * through the T9 pyramid, then G6 (`grid-far-field`) and G7 (`grid-near-field`, K3's pair law and epilogue) over
+ * `plan1d(n)`, followed by K4 (`fa2-speed-finalize`) exactly as `RepulsionExact` records it. The named grid buffers
+ * are the model's `BufferSpec`s (`buffers()`, so `inspect(name)` reaches them); the anonymous scratch of the sort
+ * and the scan and the static params of the pyramid draw on ONE `Lease` of the context's pool taken at `create()`
+ * (the scan planner takes its block-sum levels at prepare time) and released by `dispose()` (PD-11, DEP-P4-D: a
+ * per-batch lease would rebuild the G2-G4 bind groups every batch; a model creates one stage per bind(), so a stage
+ * is bound once). The stage is the ONE class every model reaches the grid tier through (PD-22): the FR and
+ * spring-electrical models pass `LAW` 1 / 2 in their override set, which reaches G6's per-cell law and G7's pair law
+ * (P4-T13).
+ */
+import { GRID_HUB_CELL } from "../constants.js";
+import { BufferUsage } from "../device/webgpu-constants.js";
+import { WebGpuGraphError } from "../errors.js";
+import { plan1d } from "../kernel/dispatch.js";
+import { INDIRECT_ARGS_STRIDE } from "../kernel/kernel.js";
+import { kernelSpec } from "../kernels.js";
+import { gridPyramidBytes, prepareGridBuild, } from "../primitives/grid.js";
+import { preparePyramid } from "../primitives/grid-pyramid.js";
+/** The stage names the grid tier records, in dispatch order (the `upTo` vocabulary of recordRepulsion). */
+const GRID_STAGES = ["G1", "G2", "G3", "G4", "G5", "G6", "G7"];
+/** The storage usage of every grid buffer. */
+const STORAGE_RW = BufferUsage.STORAGE | BufferUsage.COPY_SRC | BufferUsage.COPY_DST;
+/**
+ * The stage's lease, or E_DISPOSED after dispose().
+ * @param box - the stage's lease box
+ * @returns the lease
+ */
+function leaseOf(box) {
+    if (box.lease === null) {
+        throw new WebGpuGraphError("E_DISPOSED", "RepulsionGrid: the stage was disposed", { label: "RepulsionGrid" });
+    }
+    return box.lease;
+}
+/**
+ * A uniform buffer of the lease holding one written record of `block` (the pyramid's static params, PD-11).
+ * @param device - the device
+ * @param lease - the stage's lease
+ * @param block - the uniform block
+ * @param values - the values to write
+ * @returns the whole-buffer binding and a zero dynamic offset
+ */
+function writeParams(device, lease, block, values) {
+    const buffer = lease.uniform(block.byteLength, `grid/${block.name}`);
+    const bytes = new ArrayBuffer(block.byteLength);
+    block.write(new DataView(bytes), values);
+    device.queue.writeBuffer(buffer, 0, bytes);
+    return { binding: { buffer, offset: 0, size: block.byteLength, window: null }, offset: 0 };
+}
+/**
+ * The G6 spec of an override set (the law alone).
+ * @param overrides - the override set of the stage
+ * @returns the spec
+ */
+function farFieldSpec(overrides) {
+    return kernelSpec("grid-far-field", { LAW: overrides.LAW });
+}
+/**
+ * The G7 spec of an override set (K3's four).
+ * @param overrides - the override set of the stage
+ * @returns the spec
+ */
+function nearFieldSpec(overrides) {
+    return kernelSpec("grid-near-field", {
+        SWING_MODE: overrides.SWING_MODE,
+        STRONG_GRAVITY: overrides.STRONG_GRAVITY,
+        GRAVITY_CENTER: overrides.GRAVITY_CENTER,
+        LAW: overrides.LAW,
+    });
+}
+/** G1-G7 then K4 (spec 7.7, 7.4): the grid tier's repulsion stage. */
+export class RepulsionGrid {
+    /**
+     * Holds the planners and kernels; create() is the only caller.
+     * @param scope - the context pieces
+     * @param workgroupSize - the device's workgroup size (every kernel compiles with it)
+     * @param overrides - the override set G6 / G7 / K4 were compiled with
+     * @param spec - the grid
+     * @param box - the lease box the scope's scratch() and params() read
+     * @param build - the T8 planner (G1-G3)
+     * @param pyramid - the T9 planner (G4-G5)
+     * @param kernels - G6 (`far`), G7 (`near`) and K4 (`speedFinalize`)
+     */
+    constructor(scope, workgroupSize, overrides, spec, box, build, pyramid, kernels) {
+        this.bound = null;
+        this.caps = scope.caps;
+        this.box = box;
+        this.workgroupSize = workgroupSize;
+        this.overrides = Object.freeze({
+            SWING_MODE: overrides.SWING_MODE,
+            STRONG_GRAVITY: overrides.STRONG_GRAVITY,
+            GRAVITY_CENTER: overrides.GRAVITY_CENTER,
+            LAW: overrides.LAW,
+        });
+        this.spec = spec;
+        this.build = build;
+        this.pyramid = pyramid;
+        this.far = kernels.far;
+        this.near = kernels.near;
+        this.speedFinalize = kernels.speedFinalize;
+    }
+    /**
+     * The model-owned buffers of the grid tier (spec 7.3; PD-11): `cellKey` / `cellVal` / `sortedKey` / `sortedIdx`
+     * 4n, `cellHist` / `cellStart` 4 (cells + 2) zeroed, `hubList` one word per possible hub cell, `hubArgs` one
+     * indirect slot, `pyramid` 16 B per pyramid cell zeroed. `hubCounters` (16 B, zeroed) is the MODEL's on every
+     * tier (PD-14: K1 binds it on the exact tier too). n = 0 reports one node's worth of bytes (spec 3.6).
+     * @param n - the node count
+     * @param spec - the grid
+     * @returns the specs
+     */
+    static buffers(n, spec) {
+        const words = 4 * Math.max(1, n);
+        return [
+            { name: "cellKey", byteLength: words, usage: STORAGE_RW, zero: false },
+            { name: "cellVal", byteLength: words, usage: STORAGE_RW, zero: false },
+            { name: "sortedKey", byteLength: words, usage: STORAGE_RW, zero: false },
+            { name: "sortedIdx", byteLength: words, usage: STORAGE_RW, zero: false },
+            { name: "cellHist", byteLength: 4 * spec.histWords, usage: STORAGE_RW, zero: true },
+            { name: "cellStart", byteLength: 4 * spec.histWords, usage: STORAGE_RW, zero: true },
+            {
+                name: "hubList",
+                byteLength: 4 * Math.max(1, Math.ceil(n / GRID_HUB_CELL)),
+                usage: STORAGE_RW,
+                zero: false,
+            },
+            { name: "hubArgs", byteLength: INDIRECT_ARGS_STRIDE, usage: STORAGE_RW | BufferUsage.INDIRECT, zero: true },
+            { name: "pyramid", byteLength: gridPyramidBytes(spec), usage: STORAGE_RW, zero: true },
+        ];
+    }
+    /**
+     * The module specs of the grid tier under an override set (for warm() and the compile matrix): the build's
+     * (G1, the sort path `spec.deterministic` selects, the histogram, the scan, the fill), the pyramid's (G4, the
+     * finalize, G4b, G5), G6, G7 and K4.
+     * @param overrides - the override set of the stage
+     * @param spec - the grid (only its `deterministic` flag matters: the pipeline key carries no geometry)
+     * @returns the specs
+     */
+    static specs(overrides, spec) {
+        const sort = spec.deterministic
+            ? [kernelSpec("radix-hist"), kernelSpec("radix-scatter"), kernelSpec("scan-block"), kernelSpec("scan-add")]
+            : [kernelSpec("counting-scatter"), kernelSpec("scan-block"), kernelSpec("scan-add")];
+        return [
+            kernelSpec("grid-cell-key"),
+            ...sort,
+            kernelSpec("histogram"),
+            kernelSpec("fill"),
+            kernelSpec("grid-centroid"),
+            kernelSpec("indirect-finalize"),
+            kernelSpec("grid-centroid-hub"),
+            kernelSpec("grid-downsample"),
+            farFieldSpec(overrides),
+            nearFieldSpec(overrides),
+            kernelSpec("fa2-speed-finalize", { SWING_MODE: overrides.SWING_MODE }),
+        ];
+    }
+    /**
+     * Compiles every kernel of the tier through the cache (sequentially: PipelineCache.get compiles inside a
+     * validation scope, one stack per device) over a scope whose scratch and params draw on the stage's lease.
+     * @param scope - the context pieces (device, caps, pipelines, pool)
+     * @param workgroupSize - the device's workgroup size
+     * @param overrides - the SWING_MODE / STRONG_GRAVITY / GRAVITY_CENTER / LAW set of this stage
+     * @param spec - the grid
+     * @returns the stage, ready for bind()
+     */
+    static async create(scope, workgroupSize, overrides, spec) {
+        const box = { lease: scope.pool.lease() };
+        const reduceScope = {
+            device: scope.device,
+            caps: scope.caps,
+            pipelines: scope.pipelines,
+            pool: scope.pool,
+            workgroupSize,
+            scratch: (byteLength, label) => leaseOf(box).storage(byteLength, label),
+            params: (block, values) => writeParams(scope.device, leaseOf(box), block, values),
+        };
+        try {
+            const build = await prepareGridBuild(reduceScope, spec);
+            const pyramid = await preparePyramid(reduceScope, spec);
+            const far = await scope.pipelines.kernel(farFieldSpec(overrides));
+            const near = await scope.pipelines.kernel(nearFieldSpec(overrides));
+            const speedFinalize = await scope.pipelines.kernel(kernelSpec("fa2-speed-finalize", { SWING_MODE: overrides.SWING_MODE }));
+            return new RepulsionGrid(scope, workgroupSize, overrides, spec, box, build, pyramid, {
+                far,
+                near,
+                speedFinalize,
+            });
+        }
+        catch (error) {
+            leaseOf(box).release();
+            throw error;
+        }
+    }
+    /**
+     * Builds every bind group once per load(): the build's and the pyramid's bind() (which take their scratch and
+     * write their static params through the lease), then G6, G7 and K4 against the named buffers (the 3.10.1
+     * binding names). A second bind() takes fresh scratch from the same lease and the first bind()'s scratch stays
+     * held until dispose(): the one lease also holds the prepare-time allocations (the scan's block-sum levels), so
+     * it cannot be released on a rebind (the model creates one stage per bind(), so a rebind never happens).
+     * @param resources - the buffers of spec 7.3 plus the grid's
+     */
+    bind(resources) {
+        leaseOf(this.box);
+        const r = resources;
+        this.build.bind({
+            pos: r.pos,
+            state: r.state,
+            params: r.params,
+            cellKey: r.cellKey,
+            cellVal: r.cellVal,
+            sortedKey: r.sortedKey,
+            sortedIdx: r.sortedIdx,
+            cellHist: r.cellHist,
+            cellStart: r.cellStart,
+        });
+        this.pyramid.bind({
+            pos: r.pos,
+            params: r.params,
+            sortedIdx: r.sortedIdx,
+            cellStart: r.cellStart,
+            pyramid: r.pyramid,
+            hubList: r.hubList,
+            hubCounters: r.hubCounters,
+            hubArgs: r.hubArgs,
+        });
+        this.bound = {
+            far: this.far.bind({
+                pos: r.pos,
+                sortedIdx: r.sortedIdx,
+                pyramid: r.pyramid,
+                S: r.state,
+                force: r.force,
+                P: r.params,
+            }),
+            near: this.near.bind({
+                pos: r.pos,
+                sortedIdx: r.sortedIdx,
+                cellStart: r.cellStart,
+                S: r.state,
+                force: r.force,
+                oldForce: r.oldForce,
+                fixedMask: r.fixedMask,
+                partials: r.partials,
+                P: r.params,
+            }),
+            speedFinalize: this.speedFinalize.bind({ partials: r.partials, S: r.state, T: r.trace, P: r.params }),
+        };
+    }
+    /**
+     * Records G1..G7 for `n` nodes with the params slot's dynamic offset, stopping after `upTo` when given (spec 7.4
+     * grid sequence; the inspect() stage split, spec 11.9 item 2): G1-G3 through the build planner, G4-G5 through the
+     * pyramid planner, then G6 and G7 over plan1d(n).
+     * @param pass - the open compute pass of the batch
+     * @param n - the node count (in [1, the capacity of the grid buffers])
+     * @param paramsOffset - the dynamic offset of this iteration's Fa2Params slot in the uniform ring
+     * @param upTo - the last grid stage to record (default "G7")
+     */
+    recordRepulsion(pass, n, paramsOffset, upTo) {
+        const bound = this.requireBound("recordRepulsion");
+        const stop = GRID_STAGES.indexOf(upTo ?? "G7");
+        let buildStop = "G3";
+        if (stop === 0) {
+            buildStop = "G1";
+        }
+        else if (stop === 1) {
+            buildStop = "G2";
+        }
+        this.build.record(pass, n, paramsOffset, buildStop);
+        if (stop < 3) {
+            return;
+        }
+        this.pyramid.record(pass, paramsOffset, stop === 3 ? "G4" : "G5");
+        if (stop < 5) {
+            return;
+        }
+        const plan = plan1d(n, this.workgroupSize, this.caps);
+        this.far.dispatch(pass, bound.far, plan, [paramsOffset]);
+        if (stop < 6) {
+            return;
+        }
+        this.near.dispatch(pass, bound.near, plan, [paramsOffset]);
+    }
+    /**
+     * Records K4 only (one workgroup).
+     * @param pass - the open compute pass
+     * @param paramsOffset - the dynamic offset of the Fa2Params slot
+     */
+    recordSpeedFinalize(pass, paramsOffset) {
+        const bound = this.requireBound("recordSpeedFinalize");
+        const one = plan1d(this.speedFinalize.workgroupSize, this.speedFinalize.workgroupSize, this.caps);
+        this.speedFinalize.dispatch(pass, bound.speedFinalize, one, [paramsOffset]);
+    }
+    /** Releases the lease (the sort and scan scratch, the static params) and drops the bind groups; idempotent. */
+    dispose() {
+        if (this.box.lease !== null) {
+            this.box.lease.release();
+            this.box.lease = null;
+        }
+        for (const kernel of [this.far, this.near, this.speedFinalize]) {
+            kernel.invalidate();
+        }
+        this.bound = null;
+    }
+    /**
+     * The bound groups, or E_NOT_LOADED when bind() has not run.
+     * @param method - the caller's name for the message
+     * @returns the bound groups
+     */
+    requireBound(method) {
+        if (this.bound === null) {
+            throw new WebGpuGraphError("E_NOT_LOADED", `RepulsionGrid.${method}(): bind() has not been called for this stage`, {
+                state: "unbound",
+            });
+        }
+        return this.bound;
+    }
+}
+//# sourceMappingURL=repulsion-grid.js.map