aigpu 0.3.1

package/dist/errors.js

@@ -0,0 +1,616 @@
+import { AIGpuError as CoreAIGpuError } from "@aigpu/core";
+export class AIGpuError extends CoreAIGpuError {
+}
+export function storageStageLimitError(label, stage, entryPoint, count, limit, bindings) {
+    const title = stage === "vertex" ? "Vertex" : "Fragment";
+    const suffix = stage === "vertex" ? "VERTEX" : "FRAGMENT";
+    const limitName = `maxStorageBuffersIn${title}Stage`;
+    return new AIGpuError({
+        code: `AIGPU-LIMIT-STORAGE-${suffix}`,
+        message: `${title} entry '${entryPoint}' in '${label}' uses ${count} storage buffer(s), but device limit ${limitName} is ${limit}.`,
+        fix: stage === "vertex"
+            ? `Request init({ requiredLimits: { ${limitName}: ${count} } }) if the adapter supports it, or move vertex data to geometry(gpu, ...) vertex streams.`
+            : `Request init({ requiredLimits: { ${limitName}: ${count} } }) if the adapter supports it, or reduce fragment storage buffers.`,
+        where: `${label}.pipelineLayout`,
+        detail: { stage, entryPoint, count, limit, bindings: bindings.map(({ name, group, binding }) => ({ name, group, binding })) },
+    });
+}
+export function textureFilterabilityError(label, binding, format, resourceName, sampler) {
+    return new AIGpuError({
+        code: "AIGPU-SET-TEXTURE-FILTERABILITY",
+        message: `${resourceName} (${format}) cannot satisfy filtering texture '${binding.name}' @group(${binding.group}) @binding(${binding.binding}).`,
+        fix: "Use a filterable format; request float32-filterable for rgba32float when supported; or use textureLoad without a sampler.",
+        where: `${label}.set`,
+        detail: { format, group: binding.group, binding: binding.binding, bindingName: binding.name, resourceName, samplerName: sampler?.name, samplerGroup: sampler?.group, samplerBinding: sampler?.binding },
+    });
+}
+export function neverSetError(drawLabel, binding) {
+    const fix = missingBindingFix(drawLabel, binding);
+    return new AIGpuError({
+        code: "AIGPU-R1-BINDING-NEVER-SET",
+        message: `Unset \`${binding.name}\` @group(${binding.group}) @binding(${binding.binding}) in '${drawLabel}'. Fix: ${fix}; or ${drawLabel}.group(${binding.group}, bindGroup).`,
+        where: `${drawLabel}.draw`,
+    });
+}
+export function ownershipFlipError(name, previous) {
+    const previousText = previous === "lib" ? "lib-owned by its first JS set()" : "user-owned by its first resource set()";
+    const fix = previous === "lib"
+        ? `Fix: pass a resource from the start: wave.set({ ${name}: new Uniform(gpu.device, { size: 4 }) }).`
+        : `Fix: pass JS values from the first set(): wave.set({ ${name}: jsValue }).`;
+    return new AIGpuError({
+        code: "AIGPU-R1-OWNERSHIP-FLIP",
+        message: `\`${name}\` is ${previousText}; ownership cannot change. ${fix}`,
+        where: "set",
+    });
+}
+export function claimedGroupSetError(label, group) {
+    return new AIGpuError({
+        code: "AIGPU-R4-GROUP-CLAIMED",
+        message: `group ${group} of '${label}' is claimed; set() cannot update it.`,
+        fix: `Call set() first, or build from ${label}.layout(${group}); pass dynamic offsets to p.draw().`,
+        where: `${label}.set`,
+    });
+}
+export function claimedGroupIncompatibleError(label, group, reason, cause) {
+    return new AIGpuError({
+        code: "AIGPU-R4-GROUP-INCOMPATIBLE",
+        message: `claimed group ${group} in '${label}' is incompatible: ${reason}.`,
+        fix: `Build from ${label}.layout(${group}, { dynamicOffsets? }) then call ${label}.group(${group}, bindGroup).`,
+        where: `${label}.group`,
+        cause,
+    });
+}
+export function claimedGroupNativeValidationError(label, group, cause) {
+    return new AIGpuError({
+        code: "AIGPU-R4-GROUP-VALIDATION",
+        message: `WebGPU rejected claimed group ${group} in '${label}'.`,
+        fix: `Build from ${label}.layout(${group}); pass offsets via p.draw(draw, { offsets: { ${group}: [...] } }).`,
+        where: `${label}.draw`,
+        cause,
+        detail: { drawLabel: label, group },
+    });
+}
+export function blendInvalidError(label, value) {
+    return new AIGpuError({
+        code: "AIGPU-BLEND-INVALID",
+        message: `Invalid blend '${String(value)}' in '${label}'.`,
+        fix: `Use "alpha", "additive", "premultiplied", or { color, alpha? } components.`,
+        where: "draw",
+    });
+}
+export function blendConstantInvalidError(label, reason) {
+    return new AIGpuError({
+        code: "AIGPU-BLEND-CONSTANT-INVALID",
+        message: `Invalid blendConstant in '${label}': ${reason}`,
+        fix: `Use [r, g, b, a] finite numbers with a blend whose color or alpha uses "constant"/"one-minus-constant"; omit it to keep the pass default (0, 0, 0, 0).`,
+        where: "draw",
+    });
+}
+export function bundleBlendConstantError(bundleId, drawLabel) {
+    return new AIGpuError({
+        code: "AIGPU-BUNDLE-BLEND-CONSTANT",
+        message: `bundle '${bundleId}' cannot record draw '${drawLabel}': blendConstant is render-pass state and render bundle encoders cannot set it.`,
+        fix: `Encode the draw with p.draw(...) in a frame pass, or drop blendConstant from the draw.`,
+        where: "bundle",
+    });
+}
+export function writeMaskInvalidError(label, preview) {
+    return new AIGpuError({
+        code: "AIGPU-WRITEMASK-INVALID",
+        message: `Invalid writeMask ${preview} in '${label}'.`,
+        fix: `Use an array of r/g/b/a; omit it for all channels.`,
+        where: "draw",
+    });
+}
+export function colorsInvalidError(label, reason, where = "draw") {
+    return new AIGpuError({
+        code: "AIGPU-COLORS-INVALID",
+        message: `Invalid colors in '${label}': ${reason}`,
+        fix: `Use one { blend?, writeMask? } or null entry per color attachment of the target, aligned by index; omit colors to apply the top-level blend/writeMask to every attachment.`,
+        where,
+    });
+}
+export function cullInvalidError(label, value) {
+    return new AIGpuError({
+        code: "AIGPU-CULL-INVALID",
+        message: `Invalid cull '${String(value)}' in '${label}'.`,
+        fix: `Use "none", "front", or "back"; omit it for no culling.`,
+        where: "draw",
+    });
+}
+export function frontFaceInvalidError(label, value) {
+    return new AIGpuError({
+        code: "AIGPU-FRONTFACE-INVALID",
+        message: `Invalid frontFace '${String(value)}' in '${label}'.`,
+        fix: `Use "ccw" or "cw"; omit it for counter-clockwise.`,
+        where: "draw",
+    });
+}
+export function unclippedDepthInvalidError(label, reason) {
+    return new AIGpuError({
+        code: "AIGPU-UNCLIPPED-DEPTH-INVALID",
+        message: `Invalid unclippedDepth in '${label}': ${reason}`,
+        fix: `Use a boolean. unclippedDepth: true needs the "depth-clip-control" device feature — request it with init({ requiredFeatures: ["depth-clip-control"] }) on an adapter that supports it. Omit the option to keep depth clipping.`,
+        where: "draw",
+    });
+}
+export function depthInvalidError(label, reason) {
+    return new AIGpuError({
+        code: "AIGPU-DEPTH-INVALID",
+        message: `Invalid depth in '${label}': ${reason}`,
+        fix: `Use false or { write?, compare?, bias?, biasSlopeScale?, biasClamp? }; omit it for { write: true, compare: "less-equal" }.`,
+        where: "draw",
+    });
+}
+export function stencilInvalidError(label, reason, where = "draw") {
+    return new AIGpuError({
+        code: "AIGPU-STENCIL-INVALID",
+        message: `Invalid stencil in '${label}': ${reason}`,
+        fix: `Use { front?, back?, readMask?, writeMask?, ref? } with GPUCompareFunction/GPUStencilOperation faces and u32 masks, against a target whose depth format has a stencil aspect (depth: "depth24plus-stencil8"); omit it for WebGPU's pass-through defaults.`,
+        where,
+    });
+}
+export function bundleStencilReferenceError(bundleId, drawLabel) {
+    return new AIGpuError({
+        code: "AIGPU-BUNDLE-STENCIL-REF",
+        message: `bundle '${bundleId}' cannot record draw '${drawLabel}': stencil.ref is render-pass state and render bundle encoders cannot set it.`,
+        fix: `Encode the draw with p.draw(...) in a frame pass, or drop ref from the draw's stencil.`,
+        where: "bundle",
+    });
+}
+export function multisampleInvalidError(label, reason, where = "draw") {
+    return new AIGpuError({
+        code: "AIGPU-MULTISAMPLE-INVALID",
+        message: `Invalid multisample in '${label}': ${reason}`,
+        fix: `Use { alphaToCoverage?, mask? }: alphaToCoverage needs a target created with msaa: true, and mask must be an integer in [0, 0xFFFFFFFF] (bits above the target's sampleCount are ignored). Omit multisample for full-coverage defaults.`,
+        where,
+    });
+}
+export function constantsInvalidError(label, reason, where = "draw") {
+    return new AIGpuError({
+        code: "AIGPU-CONSTANTS-INVALID",
+        message: `Invalid constants in '${label}': ${reason}`,
+        fix: `Key WGSL \`override\` constants by name, or by the decimal string of N when the declaration has @id(N); values are finite numbers or booleans, converted to the override's WGSL type (bool/i32/u32/f32/f16). Every override without a default value must be provided. Omit constants to keep the WGSL defaults.`,
+        where,
+    });
+}
+export function entryInvalidError(label, reason, where = "draw") {
+    return new AIGpuError({
+        code: "AIGPU-ENTRY-INVALID",
+        message: `Invalid entry in '${label}': ${reason}`,
+        fix: `Name an entry point declared in the shader with the matching stage — { vertex?, fragment? } strings for draw, one @compute name string for compute. Omit entry (or a field) to use the first entry point of that stage.`,
+        where,
+    });
+}
+export function indirectInvalidError(label, reason, where) {
+    return new AIGpuError({
+        code: "AIGPU-INDIRECT-INVALID",
+        message: `Invalid indirect in '${label}': ${reason}`,
+        fix: `Pass a storage buffer created with storage(gpu, bytes, { indirect: true }) — bare, or as { buffer, offset? } with a 4-aligned byte offset — sized so the GPU-read arguments fit: 16 bytes for drawIndirect, 20 for drawIndexedIndirect, 12 for dispatchWorkgroupsIndirect. Omit indirect to use CPU-side counts.`,
+        where,
+    });
+}
+export function passPreserveMsaaError() {
+    return new AIGpuError({
+        code: "AIGPU-PASS-PRESERVE-MSAA",
+        message: "clear:false cannot preserve MSAA; use a non-MSAA target.",
+        fix: "Use non-MSAA for accumulation.",
+        where: "Frame.pass",
+    });
+}
+export function passClearDepthInvalidError(value, reason = "expected a number in [0, 1].", fix = `Use 1 (default), or 0 with depth: { compare: "greater" } for reversed-Z.`) {
+    return new AIGpuError({
+        code: "AIGPU-PASS-CLEARDEPTH-INVALID",
+        message: `clearDepth received ${String(value)}; ${reason}`,
+        fix,
+        where: "Frame.pass",
+    });
+}
+export function passViewportInvalidError(reason) {
+    return new AIGpuError({
+        code: "AIGPU-PASS-VIEWPORT-INVALID",
+        message: `Invalid viewport: ${reason}`,
+        fix: `Use { x?, y?, width, height, minDepth?, maxDepth? } finite numbers within device limits; omit it for the full target.`,
+        where: "Frame.pass",
+    });
+}
+export function passScissorInvalidError(reason) {
+    return new AIGpuError({
+        code: "AIGPU-PASS-SCISSOR-INVALID",
+        message: `Invalid scissor: ${reason}`,
+        fix: `Use [x, y, width, height] non-negative integers with x + width and y + height within the target's current pixel size; omit it for the full target.`,
+        where: "Frame.pass",
+    });
+}
+export function passPreserveClearDepthError() {
+    return new AIGpuError({
+        code: "AIGPU-PASS-PRESERVE-CLEARDEPTH",
+        message: "clear:false preserves depth; clearDepth cannot apply.",
+        fix: "Remove clearDepth, or let the pass clear.",
+        where: "Frame.pass",
+    });
+}
+export function passClearStencilInvalidError(reason) {
+    return new AIGpuError({
+        code: "AIGPU-PASS-CLEARSTENCIL-INVALID",
+        message: `clearStencil ${reason}`,
+        fix: `Use an integer in [0, 0xFFFFFFFF] on a target whose depth format has a stencil aspect, e.g. depth: "depth24plus-stencil8"; the value is masked to the stencil aspect's bit width.`,
+        where: "Frame.pass",
+    });
+}
+export function passPreserveClearStencilError() {
+    return new AIGpuError({
+        code: "AIGPU-PASS-PRESERVE-CLEARSTENCIL",
+        message: "clear:false preserves stencil; clearStencil cannot apply.",
+        fix: "Remove clearStencil, or let the pass clear.",
+        where: "Frame.pass",
+    });
+}
+export function passDepthReadOnlyError(reason, fix, where = "Frame.pass") {
+    return new AIGpuError({
+        code: "AIGPU-PASS-DEPTH-READONLY",
+        message: `depthReadOnly ${reason}`,
+        fix,
+        where,
+    });
+}
+export function passDepthReadOnlyMsaaError() {
+    return new AIGpuError({
+        code: "AIGPU-PASS-DEPTH-READONLY-MSAA",
+        message: "depthReadOnly cannot read an MSAA target's depth: multisampled depth is stored with storeOp \"discard\", so a read-only pass tests against discarded contents.",
+        fix: "Use a non-MSAA target for read-only depth, or drop depthReadOnly and let the pass own its depth.",
+        where: "Frame.pass",
+    });
+}
+export function timerInvalidError(reason, fix, where = "timer") {
+    return new AIGpuError({
+        code: "AIGPU-TIMER-INVALID",
+        message: `Invalid timer use: ${reason}`,
+        fix,
+        where,
+    });
+}
+export function timerCapacityError(maxSpans, maxQueries) {
+    return new AIGpuError({
+        code: "AIGPU-TIMER-CAPACITY",
+        message: `frame exceeds ${maxSpans} timed spans; a timer holds one timestamp query set and WebGPU createQuerySet requires count <= ${maxQueries} (2 queries per span).`,
+        fix: "Time fewer passes per frame, or spread timing across frames.",
+        where: "Frame.pass",
+    });
+}
+export function visibilityInvalidError(reason, fix, where = "visibility") {
+    return new AIGpuError({
+        code: "AIGPU-VIS-INVALID",
+        message: `Invalid visibility use: ${reason}`,
+        fix,
+        where,
+    });
+}
+export function visibilityCapacityLimitError(value, maxQueries) {
+    return new AIGpuError({
+        code: "AIGPU-VIS-CAPACITY-LIMIT",
+        message: `capacity received ${String(value)}; expected an integer in [1, ${maxQueries}] — a visibility instance holds one occlusion query set and WebGPU createQuerySet requires count <= ${maxQueries}.`,
+        fix: `Use visibility(gpu, { capacity }) with an integer capacity of at most ${maxQueries} (default 64), or create several visibility instances.`,
+        where: "visibility",
+    });
+}
+export function visibilityCapacityError(capacity) {
+    return new AIGpuError({
+        code: "AIGPU-VIS-CAPACITY",
+        message: `frame uses more than the declared ${capacity} occlusion query slot(s); the query set is bound to this frame's pass descriptors and cannot grow mid-frame.`,
+        fix: `Raise visibility(gpu, { capacity }) (max 4096), or dispose() unused query handles so fewer slots are needed per frame.`,
+        where: "FramePass.occlusion",
+    });
+}
+export function visibilityLabelDuplicateError(label) {
+    return new AIGpuError({
+        code: "AIGPU-VIS-LABEL-DUPLICATE",
+        message: `query label '${label}' is already live on this visibility instance.`,
+        fix: `Reuse the existing handle — vis.query(label) handles are stable, created once outside the loop — or dispose() the old handle first, or pick a distinct label.`,
+        where: "Visibility.query",
+    });
+}
+export function visibilityDisposedError(what, where) {
+    return new AIGpuError({
+        code: "AIGPU-VIS-DISPOSED",
+        message: `the ${what} is disposed.`,
+        fix: what === "visibility" ? "Create a new instance with visibility(gpu)." : "Create a new handle with vis.query(label).",
+        where,
+    });
+}
+export function visibilityNoDepthError() {
+    return new AIGpuError({
+        code: "AIGPU-VIS-NO-DEPTH",
+        message: "visibility is set, but the pass target has no depth attachment; without depth testing an occlusion query passes for anything rasterized, so it always reports \"visible\" and is useless for culling.",
+        fix: "Create the target with depth: true (or a depth format), or drop visibility from this pass.",
+        where: "Frame.pass",
+    });
+}
+export function queryNoVisibilityError() {
+    return new AIGpuError({
+        code: "AIGPU-QUERY-NO-VISIBILITY",
+        message: "occlusion() needs the pass to be opened with a visibility instance; the render pass has no occlusionQuerySet to write into.",
+        fix: "Open the pass with f.pass({ target, visibility: vis }, ...) using the visibility(gpu) instance that created the query handle.",
+        where: "FramePass.occlusion",
+    });
+}
+export function queryNestedError() {
+    return new AIGpuError({
+        code: "AIGPU-QUERY-NESTED",
+        message: "occlusion() cannot nest inside an active occlusion() body; WebGPU allows one active occlusion query per pass at a time.",
+        fix: "Encode each occlusion scope sequentially: p.occlusion(a, ...); p.occlusion(b, ...).",
+        where: "FramePass.occlusion",
+    });
+}
+export function queryDuplicateError(label) {
+    return new AIGpuError({
+        code: "AIGPU-QUERY-DUPLICATE",
+        message: `query '${label}' was already used this frame; a slot holds one result per frame, so reuse would silently overwrite it.`,
+        fix: `Use one handle per measured object per frame, e.g. vis.query("${label}-2") for a second scope.`,
+        where: "FramePass.occlusion",
+    });
+}
+export function targetRequiredError(where = "Frame.pass") {
+    return new AIGpuError({
+        code: "AIGPU-TARGET-REQUIRED",
+        message: "Target required. Fix: pass surface(gpu, canvas) or target(gpu, { size }) as { target }.",
+        where,
+    });
+}
+function meshError(code, where, message, fix) {
+    return new AIGpuError({ code, message: `${code}: ${message}`, fix, where });
+}
+export function meshLayoutInvalidError(where, message) {
+    return meshError("AIGPU-MESH-LAYOUT-INVALID", where, message, "Fix attributes/formats/offsets; use non-numeric names and 4-aligned stride <= 2048.");
+}
+export function meshLimitExceededError(where, message) {
+    return meshError("AIGPU-MESH-LIMIT-EXCEEDED", where, message, "Use <= 8 buffers and <= 16 attributes (or the device limits).");
+}
+export function meshLocationConflictError(where, location) {
+    return meshError("AIGPU-MESH-LOCATION-CONFLICT", where, `Duplicate geometry @location(${location}).`, "Use unique locations, or omit them for name matching.");
+}
+export function meshDataMisalignedError(where, message) {
+    return meshError("AIGPU-MESH-DATA-MISALIGNED", where, message, "Fix: repack data, set matching stride, or give raw buffers an explicit count.");
+}
+export function meshRangeInvalidError(where, message) {
+    return meshError("AIGPU-MESH-RANGE-INVALID", where, message, "Use index ranges for indexed geometries, vertex ranges otherwise, within geometry counts.");
+}
+export function meshWriteRangeError(where, message) {
+    return meshError("AIGPU-MESH-WRITE-RANGE", where, message, "Write within the buffer byteLength, or create a larger geometry.");
+}
+export function meshAttributeUnmatchedError(where, name, available = []) {
+    return meshError("AIGPU-MESH-ATTRIBUTE-UNMATCHED", where, `Geometry attribute '${name}' has no shader input.`, `Use shader name${available.length ? ` (${available.join(",")})` : ""} or { location:n }.`);
+}
+export function meshAttributeAmbiguousError(where, name, locations) {
+    return meshError("AIGPU-MESH-ATTRIBUTE-UNMATCHED", where, `Geometry attribute '${name}' matches locations ${locations.join(",")}.`, "Rename inputs or set { location:n }.");
+}
+export function meshInputMissingError(where, name, available = []) {
+    return meshError("AIGPU-MESH-INPUT-MISSING", where, `Geometry lacks shader input '${name}'.`, `Add/remove it. Geometry attributes: ${available.join(",") || "none"}.`);
+}
+export function meshFormatMismatchError(where, name, meshFormat, shaderType) {
+    return meshError("AIGPU-MESH-FORMAT-MISMATCH", where, `Attribute '${name}' ${meshFormat} != shader ${shaderType}.`, "Match the float/sint/uint shader base type; widths may differ.");
+}
+export function pipelineLayoutGapError(group) {
+    return new AIGpuError({
+        code: "AIGPU-PIPELINE-LAYOUT-GAP",
+        message: `Pipeline bind group ${group} is missing.`,
+        fix: "Use consecutive @group() indices starting at 0.",
+        where: "pipeline layout",
+    });
+}
+export function compileFailedError(where, cause, signature) {
+    return new AIGpuError({
+        code: "AIGPU-COMPILE-FAILED",
+        message: "WebGPU pipeline compilation failed.",
+        fix: "Check WGSL, vertex layouts, and target signature.",
+        where,
+        cause,
+        detail: signature ? { signature } : undefined,
+    });
+}
+export function compileDisposedError(where) {
+    return new AIGpuError({
+        code: "AIGPU-COMPILE-DISPOSED",
+        message: "GPU disposed during pipeline compilation.",
+        where,
+    });
+}
+export function compileSignatureInvalidError(where, reason) {
+    return new AIGpuError({
+        code: "AIGPU-COMPILE-SIGNATURE-INVALID",
+        message: `Invalid TargetSignature: ${reason}`,
+        fix: "Pass { colors, depth?, sampleCount?:1|4 } or a Target.",
+        where,
+    });
+}
+export function targetStencilOnlyDepthError(format) {
+    return new AIGpuError({
+        code: "AIGPU-TARGET-DEPTH-STENCIL-ONLY",
+        message: `depth received '${format}'; stencil-only depth targets are not supported yet.`,
+        fix: `Use a format with a depth aspect such as "depth24plus" or "depth24plus-stencil8".`,
+        where: "target",
+    });
+}
+export function targetSizeRequiredError() {
+    return new AIGpuError({
+        code: "AIGPU-TARGET-SIZE-REQUIRED",
+        message: "Target size required. Fix: target(gpu, { size: [w,h] }); update surface-derived targets in onResize.",
+        where: "target",
+    });
+}
+export function surfaceNotInFrameError(where) {
+    return new AIGpuError({
+        code: "AIGPU-SURFACE-NOT-IN-FRAME",
+        message: "Surface targets are only available inside frame(gpu).",
+        fix: "surface passes must run inside frame(gpu, ...); precompile against an offscreen target(gpu, ...) instead",
+        where,
+    });
+}
+export function surfaceContextError() {
+    return new AIGpuError({
+        code: "AIGPU-SURFACE-CONTEXT",
+        message: "Canvas WebGPU context failed. Fix: check navigator.gpu and remove any existing 2d/webgl context.",
+        where: "surface",
+    });
+}
+export function surfaceDuplicateError(label) {
+    return new AIGpuError({
+        code: "AIGPU-SURFACE-DUPLICATE",
+        message: `Canvas already has surface${label ? ` '${label}'` : ""}. Fix: reuse or dispose it.`,
+        where: "surface",
+    });
+}
+export function surfaceDisposedError(label) {
+    return new AIGpuError({
+        code: "AIGPU-SURFACE-DISPOSED",
+        message: `Surface '${label ?? "surface"}' is disposed. Fix: call surface(gpu, canvas).`,
+        where: "surface",
+    });
+}
+export function surfaceAutoResizeUnsupportedError() {
+    return new AIGpuError({
+        code: "AIGPU-SURFACE-AUTORESIZE-UNSUPPORTED",
+        message: "autoResize needs clientWidth. Fix: call surface.resize([w,h]) for OffscreenCanvas; onResize still fires.",
+        where: "surface",
+    });
+}
+export function surfaceResizeReentrantError(label) {
+    return new AIGpuError({
+        code: "AIGPU-SURFACE-RESIZE-REENTRANT",
+        message: `Cannot resize this surface${label ? ` '${label}'` : ""} in onResize. Fix: resize derived targets only.`,
+        where: "surface.resize",
+    });
+}
+export function clearColorInvalidError(where) {
+    return new AIGpuError({
+        code: "AIGPU-CLEAR-COLOR-INVALID",
+        message: `Invalid ${where}: expected four finite numbers.`,
+        fix: "Assign [r, g, b, a] or a GPUColor object ({ r, g, b, a }).",
+        where,
+    });
+}
+export function clockDeltaInvalidError(received) {
+    return new AIGpuError({
+        code: "AIGPU-CLOCK-DELTA-INVALID",
+        message: `clock.advance() received ${String(received)}; expected a finite, non-negative number of seconds.`,
+        fix: "Pass the elapsed seconds, e.g. clock(gpu).advance(1 / 60); use frame(gpu) alone to advance with wall-clock time.",
+        where: "clock.advance",
+    });
+}
+export function frameReentrantError() {
+    return new AIGpuError({
+        code: "AIGPU-FRAME-REENTRANT",
+        message: "Nested frame(gpu) is invalid. Fix: queue work for the next frame.",
+        where: "frame",
+    });
+}
+/**
+ * A query readback (timer span pair or occlusion slot) that could not be decoded: the map, the
+ * mapped-range copy, or the unmap failed. Reported on gpu.onError instead of rejecting the frame —
+ * the ring drops the readback and keeps going.
+ */
+export function queryReadbackError(label, cause) {
+    return new AIGpuError({
+        code: "AIGPU-QUERY-READBACK",
+        message: `${label} dropped a query readback: ${describeCause(cause)}`,
+        fix: "Usually a lost or destroyed device: recreate the gpu (and the timer/visibility instance) before reading queries again. Results resume on the next successful readback; the frame itself is unaffected.",
+        where: "QueryRing.onSubmitted",
+        cause,
+    });
+}
+/** Using a frame that `cancel()` closed: its encoder was dropped, so anything encoded into it would never run. */
+export function frameCanceledError(where) {
+    return new AIGpuError({
+        code: "AIGPU-FRAME-CANCELED",
+        message: "the frame was canceled; its command encoder was dropped and nothing more can be encoded or submitted on it.",
+        fix: "Open a new frame(gpu) for further work; cancel() is the last operation on a frame.",
+        where,
+    });
+}
+/** cancel() from inside an active pass would release resources still referenced by its descriptor. */
+export function framePassActiveError(where) {
+    return new AIGpuError({
+        code: "AIGPU-FRAME-PASS-ACTIVE",
+        message: "the frame cannot be canceled while a pass callback is active.",
+        fix: "Return from the frame.pass(...) callback first, then call frame.cancel(); this keeps pass descriptor resources alive until the pass is closed.",
+        where,
+    });
+}
+/** cancel() after submit(): the command buffer is already on the queue, so there is nothing left to release. */
+export function frameAlreadySubmittedError(where) {
+    return new AIGpuError({
+        code: "AIGPU-FRAME-SUBMITTED",
+        message: "the frame was already submitted; submitted GPU work cannot be canceled.",
+        fix: "Call cancel() only on a frame you decided not to submit; the frame you did submit needs no cleanup.",
+        where,
+    });
+}
+export function incompatibleResourceError(binding, expected, fix) {
+    return new AIGpuError({
+        code: "AIGPU-R1-BINDING-INCOMPATIBLE-RESOURCE",
+        message: `binding \`${binding.name}\` @group(${binding.group}) @binding(${binding.binding}) needs ${expected}.`,
+        fix,
+        where: "set",
+    });
+}
+export function unsupportedError(where, message, fix) {
+    return new AIGpuError({ code: "AIGPU-RING1-UNSUPPORTED", message, fix, where });
+}
+export function malformedShaderSourceError(input) {
+    if (hasVersion(input) && input.version !== 1) {
+        return new AIGpuError({
+            code: "AIGPU-SHADER-SOURCE-INVALID",
+            message: `AIGPU-SHADER-SOURCE-INVALID: unsupported ShaderSource v${String(input.version)}; expected v1. Fix: update aigpu or regenerate it.`,
+            where: "shader source",
+        });
+    }
+    return new AIGpuError({
+        code: "AIGPU-SHADER-SOURCE-INVALID",
+        message: `AIGPU-SHADER-SOURCE-INVALID: expected WGSL or { version, wgsl }, got ${previewShaderSource(input)}. Fix: configure @aigpu/wgsl loader-vite or loader-webpack.`,
+        where: "shader source",
+    });
+}
+export function writableStorageAliasingError(where) {
+    return new AIGpuError({
+        code: "AIGPU-R1-STORAGE-ALIASING",
+        message: "`src` and writable `dst` alias. Fix: alternate them with pingPongStorage(gpu).",
+        where,
+    });
+}
+export function sharedUniformLayoutMismatchError(opts) {
+    return new AIGpuError({
+        code: "AIGPU-R1-SHARED-UNIFORMS-LAYOUT-MISMATCH",
+        message: `Uniform '${opts.bindingName}' layout ${opts.adoptedLayout} from ${opts.adoptedSource} != ${opts.incomingLayout} from ${opts.incomingSource}. Fix: align structs or split uniforms.`,
+        where: "uniforms",
+    });
+}
+function describeCause(cause) {
+    if (cause instanceof Error)
+        return `${cause.name}: ${cause.message}`;
+    return String(cause);
+}
+function hasVersion(input) {
+    return typeof input === "object" && input !== null && "version" in input;
+}
+function previewShaderSource(input) {
+    if (typeof input !== "object" || input === null)
+        return typeof input;
+    try {
+        const json = JSON.stringify(input);
+        return json.length > 80 ? `${json.slice(0, 77)}...` : json;
+    }
+    catch {
+        return "object";
+    }
+}
+function missingBindingFix(drawLabel, binding) {
+    switch (binding.kind) {
+        case "sampler": return `${drawLabel}.set({${binding.name}:sampler(gpu)})`;
+        case "texture": return `${drawLabel}.set({${binding.name}:scene.color})`;
+        case "buffer": return binding.addressSpace === "uniform"
+            ? `${drawLabel}.set({${binding.name}:{ /* values */ }})`
+            : `${drawLabel}.set({${binding.name}:buffer})`;
+        default: return `${drawLabel}.set({${binding.name}:resource})`;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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