@pibbl/core 0.0.1

package/dist/features/particles/lib/definition.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/particles/lib/definition.ts"],
+  "sourcesContent": ["import {\n  assertFiniteVector,\n  assertNonnegativeNumber,\n  assertPositiveNumber,\n  cloneParticleRecord,\n  createParticleEffect2D,\n  hashParticleEmitterName,\n  normalizeBounds2D,\n  normalizeEmission,\n  normalizeParameters,\n  normalizeRenderer2D,\n  particleDefinitionError,\n  particleScalarRange,\n  validateAppearance,\n  validateScalarVector,\n  type ParticleEffect2DRecord,\n  type ParticleEmitter2DRecord,\n  type ParticleScalarRange,\n  type ParticleValidationContext,\n} from './definition-records.js';\nimport { getParticleDescriptorRecord } from './particle.js';\nimport { compileParticleEffect2D } from './compiler.js';\nimport type {\n  PibblParticleAppearance,\n  PibblParticleBounds2D,\n  PibblParticleEffect2D,\n  PibblParticleEffect2DInput,\n  PibblParticleInitial2D,\n  PibblParticleMotion2D,\n  PibblParticleParameterDefinitions,\n  PibblParticleShape2D,\n  PibblParticleValuesOf,\n} from './types.js';\n\ninterface MutableBounds {\n  min: number[];\n  max: number[];\n}\n\nfunction minimumDisplacement(range: ParticleScalarRange, seconds: number): number {\n  return Math.min(0, range.min * seconds, range.max * seconds);\n}\n\nfunction maximumDisplacement(range: ParticleScalarRange, seconds: number): number {\n  return Math.max(0, range.min * seconds, range.max * seconds);\n}\n\nfunction maximumMagnitude(range: ParticleScalarRange): number {\n  return Math.max(Math.abs(range.min), Math.abs(range.max));\n}\n\nfunction normalizeShape(\n  shape: PibblParticleShape2D,\n  context: ParticleValidationContext,\n): { readonly shape: PibblParticleShape2D; readonly bounds: MutableBounds } {\n  if (shape === null || typeof shape !== 'object') {\n    particleDefinitionError({ ...context, property: 'shape' }, 'must be a record', shape);\n  }\n  const module = `shape ${String((shape as { type?: unknown }).type)}`;\n  switch (shape.type) {\n    case 'point': {\n      const position = shape.position ?? [0, 0] as const;\n      assertFiniteVector(position, 2, { ...context, module, property: 'shape.position' });\n      return {\n        shape: Object.freeze({ type: 'point', position: cloneParticleRecord(position) }),\n        bounds: { min: [...position], max: [...position] },\n      };\n    }\n    case 'line':\n      assertFiniteVector(shape.from, 2, { ...context, module, property: 'shape.from' });\n      assertFiniteVector(shape.to, 2, { ...context, module, property: 'shape.to' });\n      return {\n        shape: cloneParticleRecord(shape),\n        bounds: {\n          min: [Math.min(shape.from[0], shape.to[0]), Math.min(shape.from[1], shape.to[1])],\n          max: [Math.max(shape.from[0], shape.to[0]), Math.max(shape.from[1], shape.to[1])],\n        },\n      };\n    case 'rectangle':\n      assertPositiveNumber(shape.width, { ...context, module, property: 'shape.width' });\n      assertPositiveNumber(shape.height, { ...context, module, property: 'shape.height' });\n      if (shape.sample !== 'interior' && shape.sample !== 'edge') {\n        particleDefinitionError(\n          { ...context, module, property: 'shape.sample' },\n          'must be interior or edge',\n          shape.sample,\n        );\n      }\n      return {\n        shape: cloneParticleRecord(shape),\n        bounds: {\n          min: [-shape.width / 2, -shape.height / 2],\n          max: [shape.width / 2, shape.height / 2],\n        },\n      };\n    case 'circle':\n      assertNonnegativeNumber(shape.radius, {\n        ...context, module, property: 'shape.radius',\n      });\n      if (shape.sample !== 'interior' && shape.sample !== 'circumference') {\n        particleDefinitionError(\n          { ...context, module, property: 'shape.sample' },\n          'must be interior or circumference',\n          shape.sample,\n        );\n      }\n      return {\n        shape: cloneParticleRecord(shape),\n        bounds: {\n          min: [-shape.radius, -shape.radius],\n          max: [shape.radius, shape.radius],\n        },\n      };\n    case 'ring':\n      assertNonnegativeNumber(shape.innerRadius, {\n        ...context, module, property: 'shape.innerRadius',\n      });\n      assertNonnegativeNumber(shape.outerRadius, {\n        ...context, module, property: 'shape.outerRadius',\n      });\n      if (shape.innerRadius > shape.outerRadius) {\n        particleDefinitionError(\n          { ...context, module, property: 'shape.outerRadius' },\n          'must be at least shape.innerRadius',\n          shape.outerRadius,\n          RangeError,\n        );\n      }\n      return {\n        shape: cloneParticleRecord(shape),\n        bounds: {\n          min: [-shape.outerRadius, -shape.outerRadius],\n          max: [shape.outerRadius, shape.outerRadius],\n        },\n      };\n    default:\n      particleDefinitionError(\n        { ...context, module, property: 'shape.type' },\n        'uses an unsupported 2D shape',\n        (shape as { type?: unknown }).type,\n      );\n  }\n}\n\nfunction requireRange(\n  value: Parameters<typeof particleScalarRange>[0],\n  parameters: PibblParticleParameterDefinitions,\n  context: ParticleValidationContext,\n  minimum?: number,\n  maximum?: number,\n): ParticleScalarRange {\n  const range = particleScalarRange(value, parameters, context);\n  if (minimum !== undefined && range.min < minimum) {\n    particleDefinitionError(context, `must be at least ${minimum}`, range.min, RangeError);\n  }\n  if (maximum !== undefined && range.max > maximum) {\n    particleDefinitionError(context, `must be at most ${maximum}`, range.max, RangeError);\n  }\n  return range;\n}\n\nfunction validateColor(\n  value: PibblParticleInitial2D['color'],\n  parameters: PibblParticleParameterDefinitions,\n  context: ParticleValidationContext,\n): void {\n  if (value === undefined) return;\n  if (typeof value === 'string') {\n    if (value.trim().length === 0) {\n      particleDefinitionError(context, 'must be a nonempty color string', value);\n    }\n    return;\n  }\n  const record = getParticleDescriptorRecord(value);\n  if (record?.type === 'parameter') {\n    const definition = parameters[record.name];\n    if (definition === undefined) {\n      particleDefinitionError(context, 'references an unknown parameter', record.name);\n    }\n    if (definition.type !== 'color') {\n      particleDefinitionError(\n        context,\n        `parameter \"${record.name}\" must have type color; received ${definition.type}`,\n      );\n    }\n    return;\n  }\n  if (record?.type !== 'choice') {\n    particleDefinitionError(context, 'must use particleChoice for variable colors', value);\n  }\n  for (let index = 0; index < record.choices.length; index += 1) {\n    const choice = record.choices[index]!.value;\n    if (typeof choice !== 'string' || choice.trim().length === 0) {\n      particleDefinitionError(\n        { ...context, property: `${context.property}.choices[${index}].value` },\n        'must be a nonempty color string',\n        choice,\n      );\n    }\n  }\n}\n\nfunction normalizeInitial(\n  initial: PibblParticleInitial2D,\n  parameters: PibblParticleParameterDefinitions,\n  context: ParticleValidationContext,\n): {\n  readonly initial: PibblParticleInitial2D;\n  readonly lifetime: ParticleScalarRange;\n  readonly velocity: readonly ParticleScalarRange[];\n  readonly maximumSize: number;\n  readonly dynamic: boolean;\n} {\n  if (initial === null || typeof initial !== 'object') {\n    particleDefinitionError(\n      { ...context, property: 'initial' }, 'must be a record', initial,\n    );\n  }\n  const lifetime = requireRange(\n    initial.lifetimeMilliseconds,\n    parameters,\n    { ...context, module: 'initial', property: 'initial.lifetimeMilliseconds' },\n  );\n  if (lifetime.min <= 0) {\n    particleDefinitionError(\n      { ...context, module: 'initial', property: 'initial.lifetimeMilliseconds' },\n      'must be positive',\n      lifetime.min,\n      RangeError,\n    );\n  }\n  const velocity = initial.velocity === undefined ? Object.freeze([\n    Object.freeze({ min: 0, max: 0, dynamic: false }),\n    Object.freeze({ min: 0, max: 0, dynamic: false }),\n  ]) : validateScalarVector(\n    initial.velocity,\n    2,\n    parameters,\n    { ...context, module: 'initial', property: 'initial.velocity' },\n  );\n  let maximumSize = 1;\n  let sizeDynamic = false;\n  if (initial.size !== undefined) {\n    const sizeDescriptor = getParticleDescriptorRecord(initial.size);\n    const vectorSize = sizeDescriptor?.type === 'parameter' &&\n      parameters[sizeDescriptor.name]?.type === 'vector2';\n    const ranges = Array.isArray(initial.size) || vectorSize ? validateScalarVector(\n      initial.size,\n      2,\n      parameters,\n      { ...context, module: 'initial', property: 'initial.size' },\n    ) : [requireRange(\n      initial.size as Parameters<typeof particleScalarRange>[0],\n      parameters,\n      { ...context, module: 'initial', property: 'initial.size' },\n      0,\n    )];\n    for (const range of ranges) {\n      if (range.min < 0) {\n        particleDefinitionError(\n          { ...context, module: 'initial', property: 'initial.size' },\n          'must be nonnegative',\n          range.min,\n          RangeError,\n        );\n      }\n      maximumSize = Math.max(maximumSize, maximumMagnitude(range));\n      sizeDynamic ||= range.dynamic;\n    }\n  }\n  if (initial.rotationDegrees !== undefined) {\n    requireRange(initial.rotationDegrees, parameters, {\n      ...context, module: 'initial', property: 'initial.rotationDegrees',\n    });\n  }\n  if (initial.angularVelocityDegreesPerSecond !== undefined) {\n    requireRange(initial.angularVelocityDegreesPerSecond, parameters, {\n      ...context, module: 'initial',\n      property: 'initial.angularVelocityDegreesPerSecond',\n    });\n  }\n  validateColor(initial.color, parameters, {\n    ...context, module: 'initial', property: 'initial.color',\n  });\n  if (initial.opacity !== undefined) {\n    requireRange(initial.opacity, parameters, {\n      ...context, module: 'initial', property: 'initial.opacity',\n    }, 0, 1);\n  }\n  return Object.freeze({\n    initial: cloneParticleRecord(initial),\n    lifetime,\n    velocity,\n    maximumSize,\n    dynamic: lifetime.dynamic || velocity.some(range => range.dynamic) || sizeDynamic,\n  });\n}\n\nfunction maximumAppearanceSize(\n  appearance: PibblParticleAppearance | undefined,\n  current: number,\n): number {\n  const curve = appearance?.size;\n  if (curve === undefined) return current;\n  let result = current;\n  for (const [, value] of curve.keys) {\n    if (typeof value === 'number') result = Math.max(result, Math.abs(value));\n    else result = Math.max(result, Math.abs(value[0]), Math.abs(value[1]));\n  }\n  return result;\n}\n\nfunction normalizeMotion(\n  motion: readonly PibblParticleMotion2D[] | undefined,\n  parameters: PibblParticleParameterDefinitions,\n  context: ParticleValidationContext,\n): { readonly motion: readonly PibblParticleMotion2D[]; readonly ranges: readonly unknown[]; readonly dynamic: boolean } {\n  if (motion === undefined) {\n    return Object.freeze({ motion: Object.freeze([]), ranges: Object.freeze([]), dynamic: false });\n  }\n  if (!Array.isArray(motion)) {\n    particleDefinitionError({ ...context, property: 'motion' }, 'must be an array', motion);\n  }\n  let orbitWriter: number | undefined;\n  let additivePositionWriter: number | undefined;\n  const ranges: unknown[] = [];\n  let dynamic = false;\n  for (let index = 0; index < motion.length; index += 1) {\n    const moduleValue = motion[index]!;\n    if (moduleValue === null || typeof moduleValue !== 'object') {\n      particleDefinitionError(\n        { ...context, module: `motion[${index}]`, property: 'motion' },\n        'must be a record',\n        moduleValue,\n      );\n    }\n    const module = `motion[${index}] ${String((moduleValue as { type?: unknown }).type)}`;\n    if (moduleValue.type === 'orbit') {\n      const earlier = orbitWriter ?? additivePositionWriter;\n      if (earlier !== undefined) {\n        particleDefinitionError(\n          { ...context, module, property: 'position' },\n          `ambiguously writes position already written by motion[${earlier}]`,\n          moduleValue.type,\n        );\n      }\n      orbitWriter = index;\n    } else if (moduleValue.type === 'drift' || moduleValue.type === 'sway') {\n      if (orbitWriter !== undefined) {\n        particleDefinitionError(\n          { ...context, module, property: 'position' },\n          `ambiguously writes position already written by motion[${orbitWriter}]`,\n          moduleValue.type,\n        );\n      }\n      additivePositionWriter ??= index;\n    }\n    switch (moduleValue.type) {\n      case 'acceleration':\n      case 'gravity':\n      case 'drift': {\n        const vector = moduleValue.type === 'drift' ?\n          moduleValue.velocity : moduleValue.value;\n        const valueRanges = validateScalarVector(vector, 2, parameters, {\n          ...context, module,\n          property: moduleValue.type === 'drift' ? 'motion.velocity' : 'motion.value',\n        });\n        ranges.push({ type: moduleValue.type, value: valueRanges });\n        dynamic ||= valueRanges.some(range => range.dynamic);\n        break;\n      }\n      case 'drag': {\n        const amount = requireRange(moduleValue.amount, parameters, {\n          ...context, module, property: 'motion.amount',\n        }, 0);\n        ranges.push({ type: 'drag', amount });\n        dynamic ||= amount.dynamic;\n        break;\n      }\n      case 'radialAcceleration': {\n        assertFiniteVector(moduleValue.center, 2, {\n          ...context, module, property: 'motion.center',\n        });\n        const amount = requireRange(moduleValue.amount, parameters, {\n          ...context, module, property: 'motion.amount',\n        });\n        ranges.push({ type: 'radialAcceleration', center: moduleValue.center, amount });\n        dynamic ||= amount.dynamic;\n        break;\n      }\n      case 'orbit': {\n        assertFiniteVector(moduleValue.center, 2, {\n          ...context, module, property: 'motion.center',\n        });\n        const speed = requireRange(moduleValue.degreesPerSecond, parameters, {\n          ...context, module, property: 'motion.degreesPerSecond',\n        });\n        ranges.push({ type: 'orbit', center: moduleValue.center, speed });\n        dynamic ||= speed.dynamic;\n        break;\n      }\n      case 'sway': {\n        const amplitude = requireRange(moduleValue.amplitude, parameters, {\n          ...context, module, property: 'motion.amplitude',\n        }, 0);\n        const frequency: readonly ParticleScalarRange[] =\n          Array.isArray(moduleValue.frequency) ? moduleValue.frequency.map(\n            (value: number, valueIndex: number) => requireRange(value, parameters, {\n              ...context, module, property: `motion.frequency[${valueIndex}]`,\n            }, 0),\n          ) : [requireRange(moduleValue.frequency, parameters, {\n            ...context, module, property: 'motion.frequency',\n          }, 0)];\n        ranges.push({ type: 'sway', amplitude, frequency });\n        dynamic ||= amplitude.dynamic || frequency.some(range => range.dynamic);\n        break;\n      }\n      case 'angularVelocity': {\n        const speed = requireRange(moduleValue.degreesPerSecond, parameters, {\n          ...context, module, property: 'motion.degreesPerSecond',\n        });\n        ranges.push({ type: 'angularVelocity', speed });\n        dynamic ||= speed.dynamic;\n        break;\n      }\n      default:\n        particleDefinitionError(\n          { ...context, module, property: 'motion.type' },\n          'uses an unsupported 2D motion module',\n          (moduleValue as { type?: unknown }).type,\n        );\n    }\n  }\n  return Object.freeze({\n    motion: cloneParticleRecord(motion),\n    ranges: Object.freeze(ranges.map(range => cloneParticleRecord(range))),\n    dynamic,\n  });\n}\n\nfunction deriveBounds(\n  shape: MutableBounds,\n  lifetimeMilliseconds: number,\n  velocity: readonly ParticleScalarRange[],\n  motionRanges: readonly unknown[],\n  size: number,\n): PibblParticleBounds2D {\n  const seconds = lifetimeMilliseconds / 1_000;\n  const bounds: MutableBounds = { min: [...shape.min], max: [...shape.max] };\n  for (let axis = 0; axis < 2; axis += 1) {\n    bounds.min[axis]! += minimumDisplacement(velocity[axis]!, seconds);\n    bounds.max[axis]! += maximumDisplacement(velocity[axis]!, seconds);\n  }\n  for (const untyped of motionRanges) {\n    const motion = untyped as {\n      type: string;\n      value?: readonly ParticleScalarRange[];\n      amount?: ParticleScalarRange;\n      amplitude?: ParticleScalarRange;\n      center?: readonly [number, number];\n    };\n    if (motion.type === 'acceleration' || motion.type === 'gravity') {\n      for (let axis = 0; axis < 2; axis += 1) {\n        const scale = 0.5 * seconds * seconds;\n        bounds.min[axis]! += minimumDisplacement(motion.value![axis]!, scale);\n        bounds.max[axis]! += maximumDisplacement(motion.value![axis]!, scale);\n      }\n    } else if (motion.type === 'drift') {\n      for (let axis = 0; axis < 2; axis += 1) {\n        bounds.min[axis]! += minimumDisplacement(motion.value![axis]!, seconds);\n        bounds.max[axis]! += maximumDisplacement(motion.value![axis]!, seconds);\n      }\n    } else if (motion.type === 'radialAcceleration') {\n      const expansion = 0.5 * maximumMagnitude(motion.amount!) * seconds * seconds;\n      for (let axis = 0; axis < 2; axis += 1) {\n        bounds.min[axis]! -= expansion;\n        bounds.max[axis]! += expansion;\n      }\n    } else if (motion.type === 'sway') {\n      const expansion = maximumMagnitude(motion.amplitude!);\n      for (let axis = 0; axis < 2; axis += 1) {\n        bounds.min[axis]! -= expansion;\n        bounds.max[axis]! += expansion;\n      }\n    } else if (motion.type === 'orbit') {\n      const center = motion.center!;\n      const radius = Math.max(\n        Math.hypot(bounds.min[0]! - center[0], bounds.min[1]! - center[1]),\n        Math.hypot(bounds.min[0]! - center[0], bounds.max[1]! - center[1]),\n        Math.hypot(bounds.max[0]! - center[0], bounds.min[1]! - center[1]),\n        Math.hypot(bounds.max[0]! - center[0], bounds.max[1]! - center[1]),\n      );\n      bounds.min = [center[0] - radius, center[1] - radius];\n      bounds.max = [center[0] + radius, center[1] + radius];\n    }\n  }\n  const rendererExpansion = size / 2;\n  return Object.freeze({\n    min: Object.freeze([\n      bounds.min[0]! - rendererExpansion,\n      bounds.min[1]! - rendererExpansion,\n    ]) as readonly [number, number],\n    max: Object.freeze([\n      bounds.max[0]! + rendererExpansion,\n      bounds.max[1]! + rendererExpansion,\n    ]) as readonly [number, number],\n  });\n}\n\nfunction normalizeEmitter(\n  input: import('./types.js').PibblParticleEmitter2D,\n  parameters: PibblParticleParameterDefinitions,\n  debugName: string | undefined,\n): ParticleEmitter2DRecord {\n  if (input === null || typeof input !== 'object') {\n    particleDefinitionError(\n      { debugName, property: 'emitter' }, 'must be a record', input,\n    );\n  }\n  const context = { debugName, emitter: input.name };\n  if (typeof input.name !== 'string' || input.name.trim().length === 0) {\n    particleDefinitionError(\n      { debugName, emitter: String(input.name), property: 'name' },\n      'must be a nonempty string',\n      input.name,\n    );\n  }\n  if (!Number.isSafeInteger(input.capacity) || input.capacity <= 0) {\n    particleDefinitionError(\n      { ...context, property: 'capacity' },\n      'must be a positive finite safe integer',\n      input.capacity,\n      RangeError,\n    );\n  }\n  if (input.space !== undefined && input.space !== 'local') {\n    particleDefinitionError(\n      { ...context, property: 'space' }, 'must be local in Project 1', input.space,\n    );\n  }\n  if (input.overflow !== undefined &&\n    input.overflow !== 'reject-newest' && input.overflow !== 'recycle-oldest') {\n    particleDefinitionError(\n      { ...context, property: 'overflow' }, 'is unsupported', input.overflow,\n    );\n  }\n  const emission = normalizeEmission(input.emission, context);\n  const normalizedShape = normalizeShape(input.shape, context);\n  const normalizedInitial = normalizeInitial(input.initial, parameters, context);\n  const normalizedMotion = normalizeMotion(input.motion, parameters, context);\n  const appearance = validateAppearance(input.appearance, context);\n  const renderer = normalizeRenderer2D(input.renderer, context);\n  const cannotDerive = normalizedInitial.dynamic || normalizedMotion.dynamic ||\n    renderer.type === 'path' || renderer.type === 'sprite';\n  let bounds: PibblParticleBounds2D;\n  let boundsSource: 'explicit' | 'derived';\n  if (input.bounds !== undefined) {\n    bounds = normalizeBounds2D(input.bounds, context);\n    boundsSource = 'explicit';\n  } else if (cannotDerive) {\n    particleDefinitionError(\n      { ...context, property: 'bounds' },\n      'must be explicit and finite for dynamic, parameterized, or renderer-unbounded motion',\n    );\n  } else {\n    bounds = normalizeBounds2D(\n      deriveBounds(\n        normalizedShape.bounds,\n        normalizedInitial.lifetime.max,\n        normalizedInitial.velocity,\n        normalizedMotion.ranges,\n        maximumAppearanceSize(appearance, normalizedInitial.maximumSize),\n      ),\n      context,\n    );\n    boundsSource = 'derived';\n  }\n  return Object.freeze({\n    name: input.name,\n    nameHash: hashParticleEmitterName(input.name),\n    capacity: input.capacity,\n    overflow: input.overflow ?? 'reject-newest',\n    space: 'local',\n    emission,\n    shape: normalizedShape.shape,\n    initial: normalizedInitial.initial,\n    motion: normalizedMotion.motion,\n    ...(appearance === undefined ? {} : { appearance }),\n    renderer,\n    bounds,\n    boundsSource,\n  });\n}\n\n/**\n * Validates and brands a reusable Canvas 2D particle effect while preserving emitter names and\n * parameter types.\n *\n * @param input - Emitter definitions, parameter declarations, and effect configuration.\n * @returns A validated particle effect preserving emitter names and parameter types. See\n * {@link PibblParticleEffect2D} , {@link PibblParticleValuesOf} ,\n * {@link PibblParticleParameterDefinitions} .\n *\n * @see {@link PibblParticleEffect2D}\n * @see {@link PibblParticleValuesOf}\n * @see {@link PibblParticleParameterDefinitions}\n * @see {@link PibblParticleEffect2DInput}\n */\nexport function defineParticleEffect2D<\n  const Input extends PibblParticleEffect2DInput,\n>(\n  input: Input,\n): PibblParticleEffect2D<\n  Input['emitters'][number]['name'],\n  PibblParticleValuesOf<\n    Input extends { readonly parameters: infer Definitions }\n      ? Extract<Definitions, PibblParticleParameterDefinitions>\n      : undefined\n  >\n> {\n  if (input === null || typeof input !== 'object') {\n    particleDefinitionError({}, 'input must be a record', input);\n  }\n  const debugName = input.debugName;\n  if (debugName !== undefined &&\n    (typeof debugName !== 'string' || debugName.trim().length === 0)) {\n    particleDefinitionError({ property: 'debugName' }, 'must be a nonempty string', debugName);\n  }\n  if (!Array.isArray(input.emitters) || input.emitters.length === 0) {\n    particleDefinitionError({ debugName, property: 'emitters' }, 'must be nonempty', input.emitters);\n  }\n  const parameters = normalizeParameters(input.parameters, debugName);\n  const seenNames = new Set<string>();\n  const emitters: ParticleEmitter2DRecord[] = [];\n  for (const emitter of input.emitters) {\n    if (emitter === null || typeof emitter !== 'object') {\n      particleDefinitionError(\n        { debugName, property: 'emitter' }, 'must be a record', emitter,\n      );\n    }\n    if (seenNames.has(emitter.name)) {\n      particleDefinitionError(\n        { debugName, emitter: emitter.name, property: 'name' },\n        'must be unique; duplicate emitter name',\n        emitter.name,\n      );\n    }\n    seenNames.add(emitter.name);\n    emitters.push(normalizeEmitter(emitter, parameters, debugName));\n  }\n  const record: ParticleEffect2DRecord = Object.freeze({\n    dimension: 2,\n    debugName,\n    parameters,\n    emitters: Object.freeze(emitters),\n    emitterNames: Object.freeze(emitters.map(emitter => emitter.name)),\n    capabilities: Object.freeze({\n      statelessCanvas: true,\n      requiresStateful: Object.freeze([]),\n    }),\n  });\n  const effect = createParticleEffect2D(record) as PibblParticleEffect2D<\n    Input['emitters'][number]['name'],\n    PibblParticleValuesOf<\n      Input extends { readonly parameters: infer Definitions }\n        ? Extract<Definitions, PibblParticleParameterDefinitions>\n        : undefined\n    >\n  >;\n  compileParticleEffect2D(effect);\n  return effect;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/particles/lib/emission.d.ts

@@ -0,0 +1,54 @@
+import type { PibblParticleEmission } from "./types.js";
+export type ParticleCompletion = "finite" | "automatic-infinite" | "manual-open";
+export type CompiledMaximumLifetime = Readonly<{
+    kind: "fixed";
+    milliseconds: number;
+}> | Readonly<{
+    kind: "parameter";
+    offset: number;
+}>;
+export interface CompiledRateEmission {
+    readonly type: "rate";
+    readonly sourceIndex: number;
+    readonly startMilliseconds: number;
+    readonly durationMilliseconds: number | null;
+    readonly intervalMilliseconds: number;
+    readonly probability: number;
+    readonly probabilityChannel: number;
+    readonly repeatEveryMilliseconds: number | null;
+    readonly cycleCount: number;
+}
+export interface CompiledBurstEmission {
+    readonly type: "burst";
+    readonly sourceIndex: number;
+    readonly cycleIndex: number;
+    readonly atMilliseconds: number;
+    readonly minimumCount: number;
+    readonly maximumCount: number;
+    readonly countChannel: number;
+    readonly probability: number;
+    readonly probabilityChannel: number;
+}
+export interface CompiledManualEmission {
+    readonly type: "manual";
+    readonly sourceIndex: number;
+    readonly minimumCount: number;
+    readonly maximumCount: number;
+    readonly countChannel: number;
+}
+export interface CompiledEmissionSchedule {
+    readonly rates: readonly CompiledRateEmission[];
+    readonly bursts: readonly CompiledBurstEmission[];
+    readonly manual: readonly CompiledManualEmission[];
+    readonly completion: ParticleCompletion;
+    readonly maximumLifetime: CompiledMaximumLifetime;
+    readonly earliestAutomaticBirthMilliseconds: number | null;
+    readonly latestAutomaticBirthMilliseconds: number | null;
+    readonly completionMilliseconds: number | null;
+    readonly maximumPotentiallyLiveOrdinals: number | null;
+}
+export declare function rateBirthTimeAt(rate: CompiledRateEmission, birthIndex: number, cycleIndex: number): number;
+export declare function countRateBirthsThrough(rate: CompiledRateEmission, effectTimeMilliseconds: number): number;
+export declare function isPotentialBirthAccepted(probability: number, seed: number, emitterHash: number, potentialOrdinal: number, probabilityChannel: number): boolean;
+export declare function sampleBurstCount(burst: CompiledBurstEmission | CompiledManualEmission, seed: number, emitterHash: number, potentialOrdinal: number): number;
+export declare function compileEmissionSchedule(sources: readonly PibblParticleEmission[], maximumLifetimeInput: number | CompiledMaximumLifetime): CompiledEmissionSchedule;

package/dist/features/particles/lib/emission.js

@@ -0,0 +1,184 @@
+import { getParticleDescriptorRecord } from "./particle.js";
+import { hashEmitterName, sampleInteger, sampleUnit } from "./random.js";
+function channelFor(sourceIndex, property) {
+  return hashEmitterName(`emission[${sourceIndex}].${property}`);
+}
+function countRange(count, fallback) {
+  if (count === void 0) return [fallback, fallback];
+  if (typeof count === "number") return [count, count];
+  const record = getParticleDescriptorRecord(count);
+  if (record?.type !== "integer") {
+    throw new TypeError("Particle emission count must use particleInteger().");
+  }
+  return [record.min, record.max];
+}
+function rateCycleCount(source) {
+  return source.repeat?.count ?? 1;
+}
+function rateCycleOffset(rate, cycleIndex) {
+  return cycleIndex * (rate.repeatEveryMilliseconds ?? 0);
+}
+function birthsInOneRateCycle(rate) {
+  if (!Number.isFinite(rate.intervalMilliseconds)) return 0;
+  if (rate.durationMilliseconds === null) return Number.POSITIVE_INFINITY;
+  return Math.floor(rate.durationMilliseconds / rate.intervalMilliseconds);
+}
+function rateBirthTimeAt(rate, birthIndex, cycleIndex) {
+  return rate.startMilliseconds + rateCycleOffset(rate, cycleIndex) + (birthIndex + 1) * rate.intervalMilliseconds;
+}
+function countRateBirthsThrough(rate, effectTimeMilliseconds) {
+  if (!Number.isFinite(rate.intervalMilliseconds)) return 0;
+  let total = 0;
+  const perCycle = birthsInOneRateCycle(rate);
+  for (let cycle = 0; cycle < rate.cycleCount; cycle += 1) {
+    const elapsed = effectTimeMilliseconds - rate.startMilliseconds - rateCycleOffset(rate, cycle);
+    if (elapsed < rate.intervalMilliseconds) continue;
+    const count = Math.floor(elapsed / rate.intervalMilliseconds);
+    total += Math.min(count, perCycle);
+  }
+  return total;
+}
+function isPotentialBirthAccepted(probability, seed, emitterHash, potentialOrdinal, probabilityChannel) {
+  if (probability <= 0) return false;
+  if (probability >= 1) return true;
+  return sampleUnit(seed, emitterHash, potentialOrdinal, probabilityChannel) < probability;
+}
+function sampleBurstCount(burst, seed, emitterHash, potentialOrdinal) {
+  if (burst.minimumCount === burst.maximumCount) return burst.minimumCount;
+  return sampleInteger(
+    sampleUnit(seed, emitterHash, potentialOrdinal, burst.countChannel),
+    burst.minimumCount,
+    burst.maximumCount
+  );
+}
+function finiteRateBirthTimes(rate) {
+  const birthsPerCycle = birthsInOneRateCycle(rate);
+  if (!Number.isFinite(birthsPerCycle) || birthsPerCycle <= 0 || rate.probability <= 0) {
+    return null;
+  }
+  return [
+    rateBirthTimeAt(rate, 0, 0),
+    rateBirthTimeAt(rate, birthsPerCycle - 1, rate.cycleCount - 1)
+  ];
+}
+function compileEmissionSchedule(sources, maximumLifetimeInput) {
+  const maximumLifetime = typeof maximumLifetimeInput === "number" ? Object.freeze({
+    kind: "fixed",
+    milliseconds: maximumLifetimeInput
+  }) : maximumLifetimeInput;
+  const rates = [];
+  const bursts = [];
+  const manual = [];
+  for (let sourceIndex = 0; sourceIndex < sources.length; sourceIndex += 1) {
+    const source = sources[sourceIndex];
+    switch (source.type) {
+      case "rate": {
+        const rate = Object.freeze({
+          type: "rate",
+          sourceIndex,
+          startMilliseconds: source.startMilliseconds ?? 0,
+          durationMilliseconds: source.durationMilliseconds ?? null,
+          intervalMilliseconds: source.particlesPerSecond === 0 ? Number.POSITIVE_INFINITY : 1e3 / source.particlesPerSecond,
+          probability: source.probability ?? 1,
+          probabilityChannel: channelFor(sourceIndex, "probability"),
+          repeatEveryMilliseconds: source.repeat?.everyMilliseconds ?? null,
+          cycleCount: rateCycleCount(source)
+        });
+        rates.push(rate);
+        break;
+      }
+      case "burst": {
+        const [minimumCount, maximumCount] = countRange(source.count, 1);
+        const cycles = source.repeat?.count ?? 1;
+        const every = source.repeat?.everyMilliseconds ?? 0;
+        for (let cycleIndex = 0; cycleIndex < cycles; cycleIndex += 1) {
+          bursts.push(
+            Object.freeze({
+              type: "burst",
+              sourceIndex,
+              cycleIndex,
+              atMilliseconds: source.atMilliseconds + cycleIndex * every,
+              minimumCount,
+              maximumCount,
+              countChannel: channelFor(sourceIndex, "count"),
+              probability: source.probability ?? 1,
+              probabilityChannel: channelFor(sourceIndex, "probability")
+            })
+          );
+        }
+        break;
+      }
+      case "manual": {
+        const [minimumCount, maximumCount] = countRange(source.count, 1);
+        manual.push(
+          Object.freeze({
+            type: "manual",
+            sourceIndex,
+            minimumCount,
+            maximumCount,
+            countChannel: channelFor(sourceIndex, "count")
+          })
+        );
+        break;
+      }
+    }
+  }
+  bursts.sort(
+    (left, right) => left.atMilliseconds - right.atMilliseconds || left.sourceIndex - right.sourceIndex || left.cycleIndex - right.cycleIndex
+  );
+  let earliest = null;
+  let latest = null;
+  let automaticInfinite = false;
+  let maximumPotentiallyLiveOrdinals = 0;
+  for (const burst of bursts) {
+    if (burst.probability <= 0) continue;
+    earliest = earliest === null ? burst.atMilliseconds : Math.min(earliest, burst.atMilliseconds);
+    latest = latest === null ? burst.atMilliseconds : Math.max(latest, burst.atMilliseconds);
+    if (maximumPotentiallyLiveOrdinals !== null) {
+      maximumPotentiallyLiveOrdinals += burst.maximumCount;
+    }
+  }
+  for (const rate of rates) {
+    if (rate.probability <= 0 || !Number.isFinite(rate.intervalMilliseconds))
+      continue;
+    if (rate.durationMilliseconds === null) {
+      automaticInfinite = true;
+      const first = rateBirthTimeAt(rate, 0, 0);
+      earliest = earliest === null ? first : Math.min(earliest, first);
+      if (maximumLifetime.kind === "parameter") {
+        maximumPotentiallyLiveOrdinals = null;
+      } else if (maximumPotentiallyLiveOrdinals !== null) {
+        maximumPotentiallyLiveOrdinals += Math.ceil(maximumLifetime.milliseconds / rate.intervalMilliseconds) + 1;
+      }
+      continue;
+    }
+    const interval = finiteRateBirthTimes(rate);
+    if (interval === null) continue;
+    earliest = earliest === null ? interval[0] : Math.min(earliest, interval[0]);
+    latest = latest === null ? interval[1] : Math.max(latest, interval[1]);
+    if (maximumPotentiallyLiveOrdinals !== null) {
+      maximumPotentiallyLiveOrdinals += birthsInOneRateCycle(rate) * rate.cycleCount;
+    }
+  }
+  const completion = manual.length > 0 ? "manual-open" : automaticInfinite ? "automatic-infinite" : "finite";
+  const finiteLatest = automaticInfinite ? null : latest;
+  return Object.freeze({
+    rates: Object.freeze(rates),
+    bursts: Object.freeze(bursts),
+    manual: Object.freeze(manual),
+    completion,
+    maximumLifetime,
+    earliestAutomaticBirthMilliseconds: earliest,
+    latestAutomaticBirthMilliseconds: finiteLatest,
+    completionMilliseconds: completion !== "finite" ? null : maximumLifetime.kind === "parameter" ? null : finiteLatest === null ? 0 : finiteLatest + maximumLifetime.milliseconds,
+    maximumPotentiallyLiveOrdinals
+  });
+}
+export {
+  compileEmissionSchedule,
+  countRateBirthsThrough,
+  isPotentialBirthAccepted,
+  rateBirthTimeAt,
+  sampleBurstCount
+};
+//# sourceMappingURL=emission.js.map

package/dist/features/particles/lib/emission.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/particles/lib/emission.ts"],
+  "sourcesContent": ["import { getParticleDescriptorRecord } from \"./particle.js\";\nimport type { PibblParticleEmission } from \"./types.js\";\nimport { hashEmitterName, sampleInteger, sampleUnit } from \"./random.js\";\n\nexport type ParticleCompletion =\n  \"finite\" | \"automatic-infinite\" | \"manual-open\";\n\nexport type CompiledMaximumLifetime =\n  | Readonly<{ kind: \"fixed\"; milliseconds: number }>\n  | Readonly<{ kind: \"parameter\"; offset: number }>;\n\nexport interface CompiledRateEmission {\n  readonly type: \"rate\";\n  readonly sourceIndex: number;\n  readonly startMilliseconds: number;\n  readonly durationMilliseconds: number | null;\n  readonly intervalMilliseconds: number;\n  readonly probability: number;\n  readonly probabilityChannel: number;\n  readonly repeatEveryMilliseconds: number | null;\n  readonly cycleCount: number;\n}\n\nexport interface CompiledBurstEmission {\n  readonly type: \"burst\";\n  readonly sourceIndex: number;\n  readonly cycleIndex: number;\n  readonly atMilliseconds: number;\n  readonly minimumCount: number;\n  readonly maximumCount: number;\n  readonly countChannel: number;\n  readonly probability: number;\n  readonly probabilityChannel: number;\n}\n\nexport interface CompiledManualEmission {\n  readonly type: \"manual\";\n  readonly sourceIndex: number;\n  readonly minimumCount: number;\n  readonly maximumCount: number;\n  readonly countChannel: number;\n}\n\nexport interface CompiledEmissionSchedule {\n  readonly rates: readonly CompiledRateEmission[];\n  readonly bursts: readonly CompiledBurstEmission[];\n  readonly manual: readonly CompiledManualEmission[];\n  readonly completion: ParticleCompletion;\n  readonly maximumLifetime: CompiledMaximumLifetime;\n  readonly earliestAutomaticBirthMilliseconds: number | null;\n  readonly latestAutomaticBirthMilliseconds: number | null;\n  readonly completionMilliseconds: number | null;\n  readonly maximumPotentiallyLiveOrdinals: number | null;\n}\n\nfunction channelFor(sourceIndex: number, property: string): number {\n  return hashEmitterName(`emission[${sourceIndex}].${property}`);\n}\n\nfunction countRange(\n  count: number | object | undefined,\n  fallback: number,\n): readonly [minimum: number, maximum: number] {\n  if (count === undefined) return [fallback, fallback];\n  if (typeof count === \"number\") return [count, count];\n  const record = getParticleDescriptorRecord(count);\n  if (record?.type !== \"integer\") {\n    throw new TypeError(\"Particle emission count must use particleInteger().\");\n  }\n  return [record.min, record.max];\n}\n\nfunction rateCycleCount(\n  source: Extract<PibblParticleEmission, { type: \"rate\" }>,\n): number {\n  return source.repeat?.count ?? 1;\n}\n\nfunction rateCycleOffset(\n  rate: CompiledRateEmission,\n  cycleIndex: number,\n): number {\n  return cycleIndex * (rate.repeatEveryMilliseconds ?? 0);\n}\n\nfunction birthsInOneRateCycle(rate: CompiledRateEmission): number {\n  if (!Number.isFinite(rate.intervalMilliseconds)) return 0;\n  if (rate.durationMilliseconds === null) return Number.POSITIVE_INFINITY;\n  return Math.floor(rate.durationMilliseconds / rate.intervalMilliseconds);\n}\n\nexport function rateBirthTimeAt(\n  rate: CompiledRateEmission,\n  birthIndex: number,\n  cycleIndex: number,\n): number {\n  return (\n    rate.startMilliseconds +\n    rateCycleOffset(rate, cycleIndex) +\n    (birthIndex + 1) * rate.intervalMilliseconds\n  );\n}\n\nexport function countRateBirthsThrough(\n  rate: CompiledRateEmission,\n  effectTimeMilliseconds: number,\n): number {\n  if (!Number.isFinite(rate.intervalMilliseconds)) return 0;\n  let total = 0;\n  const perCycle = birthsInOneRateCycle(rate);\n  for (let cycle = 0; cycle < rate.cycleCount; cycle += 1) {\n    const elapsed =\n      effectTimeMilliseconds -\n      rate.startMilliseconds -\n      rateCycleOffset(rate, cycle);\n    if (elapsed < rate.intervalMilliseconds) continue;\n    const count = Math.floor(elapsed / rate.intervalMilliseconds);\n    total += Math.min(count, perCycle);\n  }\n  return total;\n}\n\nexport function isPotentialBirthAccepted(\n  probability: number,\n  seed: number,\n  emitterHash: number,\n  potentialOrdinal: number,\n  probabilityChannel: number,\n): boolean {\n  if (probability <= 0) return false;\n  if (probability >= 1) return true;\n  return (\n    sampleUnit(seed, emitterHash, potentialOrdinal, probabilityChannel) <\n    probability\n  );\n}\n\nexport function sampleBurstCount(\n  burst: CompiledBurstEmission | CompiledManualEmission,\n  seed: number,\n  emitterHash: number,\n  potentialOrdinal: number,\n): number {\n  if (burst.minimumCount === burst.maximumCount) return burst.minimumCount;\n  return sampleInteger(\n    sampleUnit(seed, emitterHash, potentialOrdinal, burst.countChannel),\n    burst.minimumCount,\n    burst.maximumCount,\n  );\n}\n\nfunction finiteRateBirthTimes(\n  rate: CompiledRateEmission,\n): readonly [number, number] | null {\n  const birthsPerCycle = birthsInOneRateCycle(rate);\n  if (\n    !Number.isFinite(birthsPerCycle) ||\n    birthsPerCycle <= 0 ||\n    rate.probability <= 0\n  ) {\n    return null;\n  }\n  return [\n    rateBirthTimeAt(rate, 0, 0),\n    rateBirthTimeAt(rate, birthsPerCycle - 1, rate.cycleCount - 1),\n  ];\n}\n\nexport function compileEmissionSchedule(\n  sources: readonly PibblParticleEmission[],\n  maximumLifetimeInput: number | CompiledMaximumLifetime,\n): CompiledEmissionSchedule {\n  const maximumLifetime =\n    typeof maximumLifetimeInput === \"number\"\n      ? Object.freeze({\n          kind: \"fixed\" as const,\n          milliseconds: maximumLifetimeInput,\n        })\n      : maximumLifetimeInput;\n  const rates: CompiledRateEmission[] = [];\n  const bursts: CompiledBurstEmission[] = [];\n  const manual: CompiledManualEmission[] = [];\n\n  for (let sourceIndex = 0; sourceIndex < sources.length; sourceIndex += 1) {\n    const source = sources[sourceIndex]!;\n    switch (source.type) {\n      case \"rate\": {\n        const rate = Object.freeze({\n          type: \"rate\" as const,\n          sourceIndex,\n          startMilliseconds: source.startMilliseconds ?? 0,\n          durationMilliseconds: source.durationMilliseconds ?? null,\n          intervalMilliseconds:\n            source.particlesPerSecond === 0\n              ? Number.POSITIVE_INFINITY\n              : 1_000 / source.particlesPerSecond,\n          probability: source.probability ?? 1,\n          probabilityChannel: channelFor(sourceIndex, \"probability\"),\n          repeatEveryMilliseconds: source.repeat?.everyMilliseconds ?? null,\n          cycleCount: rateCycleCount(source),\n        });\n        rates.push(rate);\n        break;\n      }\n      case \"burst\": {\n        const [minimumCount, maximumCount] = countRange(source.count, 1);\n        const cycles = source.repeat?.count ?? 1;\n        const every = source.repeat?.everyMilliseconds ?? 0;\n        for (let cycleIndex = 0; cycleIndex < cycles; cycleIndex += 1) {\n          bursts.push(\n            Object.freeze({\n              type: \"burst\",\n              sourceIndex,\n              cycleIndex,\n              atMilliseconds: source.atMilliseconds + cycleIndex * every,\n              minimumCount,\n              maximumCount,\n              countChannel: channelFor(sourceIndex, \"count\"),\n              probability: source.probability ?? 1,\n              probabilityChannel: channelFor(sourceIndex, \"probability\"),\n            }),\n          );\n        }\n        break;\n      }\n      case \"manual\": {\n        const [minimumCount, maximumCount] = countRange(source.count, 1);\n        manual.push(\n          Object.freeze({\n            type: \"manual\",\n            sourceIndex,\n            minimumCount,\n            maximumCount,\n            countChannel: channelFor(sourceIndex, \"count\"),\n          }),\n        );\n        break;\n      }\n    }\n  }\n\n  bursts.sort(\n    (left, right) =>\n      left.atMilliseconds - right.atMilliseconds ||\n      left.sourceIndex - right.sourceIndex ||\n      left.cycleIndex - right.cycleIndex,\n  );\n\n  let earliest: number | null = null;\n  let latest: number | null = null;\n  let automaticInfinite = false;\n  let maximumPotentiallyLiveOrdinals: number | null = 0;\n\n  for (const burst of bursts) {\n    if (burst.probability <= 0) continue;\n    earliest =\n      earliest === null\n        ? burst.atMilliseconds\n        : Math.min(earliest, burst.atMilliseconds);\n    latest =\n      latest === null\n        ? burst.atMilliseconds\n        : Math.max(latest, burst.atMilliseconds);\n    if (maximumPotentiallyLiveOrdinals !== null) {\n      maximumPotentiallyLiveOrdinals += burst.maximumCount;\n    }\n  }\n\n  for (const rate of rates) {\n    if (rate.probability <= 0 || !Number.isFinite(rate.intervalMilliseconds))\n      continue;\n    if (rate.durationMilliseconds === null) {\n      automaticInfinite = true;\n      const first = rateBirthTimeAt(rate, 0, 0);\n      earliest = earliest === null ? first : Math.min(earliest, first);\n      if (maximumLifetime.kind === \"parameter\") {\n        maximumPotentiallyLiveOrdinals = null;\n      } else if (maximumPotentiallyLiveOrdinals !== null) {\n        maximumPotentiallyLiveOrdinals +=\n          Math.ceil(maximumLifetime.milliseconds / rate.intervalMilliseconds) +\n          1;\n      }\n      continue;\n    }\n    const interval = finiteRateBirthTimes(rate);\n    if (interval === null) continue;\n    earliest =\n      earliest === null ? interval[0] : Math.min(earliest, interval[0]);\n    latest = latest === null ? interval[1] : Math.max(latest, interval[1]);\n    if (maximumPotentiallyLiveOrdinals !== null) {\n      maximumPotentiallyLiveOrdinals +=\n        birthsInOneRateCycle(rate) * rate.cycleCount;\n    }\n  }\n\n  const completion: ParticleCompletion =\n    manual.length > 0\n      ? \"manual-open\"\n      : automaticInfinite\n        ? \"automatic-infinite\"\n        : \"finite\";\n  const finiteLatest = automaticInfinite ? null : latest;\n  return Object.freeze({\n    rates: Object.freeze(rates),\n    bursts: Object.freeze(bursts),\n    manual: Object.freeze(manual),\n    completion,\n    maximumLifetime,\n    earliestAutomaticBirthMilliseconds: earliest,\n    latestAutomaticBirthMilliseconds: finiteLatest,\n    completionMilliseconds:\n      completion !== \"finite\"\n        ? null\n        : maximumLifetime.kind === \"parameter\"\n          ? null\n          : finiteLatest === null\n            ? 0\n            : finiteLatest + maximumLifetime.milliseconds,\n    maximumPotentiallyLiveOrdinals,\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/particles/lib/flow/field.d.ts

@@ -0,0 +1,81 @@
+export interface FlowSource2D {
+    readonly x: number;
+    readonly y: number;
+    readonly radius: number;
+    readonly acceleration?: readonly [number, number];
+    /** Normalized heat injected per second; carried and dissipated by the field. */
+    readonly heat?: number;
+}
+export interface FlowObstacleGeometry2D {
+    readonly boxes?: Float64Array;
+    readonly ellipses?: Float64Array;
+    /** count, vx, vy, omega, COM x/y, followed by interleaved world vertices. */
+    readonly polygons?: Float64Array;
+}
+/**
+ * Renderer-independent MAC grid. Velocities are logical units/second; pressure
+ * stores the velocity potential (dt / density folded in). Open domain edges
+ * use zero pressure. Solids prescribe face-normal velocity (free slip).
+ * All numerical storage is allocated once; advancement and sampling allocate
+ * no per-cell or per-particle objects. This kernel owns no clock or WASM memory.
+ */
+export declare class FlowFieldKernel2D {
+    readonly columns: number;
+    readonly rows: number;
+    readonly width: number;
+    readonly height: number;
+    private u;
+    private v;
+    private nextU;
+    private nextV;
+    private readonly solid;
+    private readonly wallU;
+    private readonly wallV;
+    private readonly fixedU;
+    private readonly fixedV;
+    private readonly pressure;
+    private readonly divergence;
+    private readonly neighbors;
+    private readonly inverseWeight;
+    private readonly solveOrder;
+    private solveCount;
+    private readonly cellVX;
+    private readonly cellVY;
+    private temperature;
+    private nextTemperature;
+    readonly dx: number;
+    readonly dy: number;
+    projectionIterations: number;
+    projectionResidual: number;
+    constructor(columns: number, rows: number, width: number, height: number);
+    /** Copy committed state into a reusable candidate before a transactional frame. */
+    copyFrom(other: FlowFieldKernel2D): void;
+    get byteLength(): number;
+    /** Packed boxes: cx, cy, hx, hy, angle radians, vx, vy, omega, COM x, COM y.
+     * Copies into grid storage; the caller retains and may reuse its own buffer.
+     * Overlapping solids resolve in batch order, with the last solid owning motion.
+     */
+    setBoxes(boxes: Float64Array): void;
+    setObstacles(geometry: FlowObstacleGeometry2D): void;
+    isSolid(x: number, y: number): boolean;
+    private interpolate;
+    private velocityX;
+    private velocityY;
+    sampleBatch(positions: Float32Array, velocities: Float32Array, count: number): void;
+    /** Swept grid traversal, O(cells crossed), independent of obstacle count.
+     * A particle already covered by a moved solid is left for the population's
+     * explicit retire/reseed policy. Domain edges are open.
+     */
+    moveBatch(positions: Float32Array, velocities: Float32Array, count: number, seconds: number): void;
+    private sweepFraction;
+    /** One accepted fixed step. Sources touch only their bounded footprints. */
+    advance(seconds: number, sources?: readonly FlowSource2D[], buoyancy?: number): void;
+    private enforceWalls;
+    /** Cache the Poisson stencil in red/black order once per obstacle update. */
+    private rebuildStencil;
+    private project;
+    private pressureResidual;
+    /** Diagnostic scans; not used by normal advancement. */
+    maximumSolidFluxError(): number;
+    maximumDivergence(): number;
+}