@pibbl/core 0.0.1

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/particles/lib/curve.ts"],
+  "sourcesContent": ["import type { PibblEasing } from \"@pibbl/core\";\nimport { parseParticleColor } from \"./color.js\";\nimport { getParticleDescriptorRecord } from \"./particle.js\";\nimport type {\n  PibblParticleCurve,\n  PibblParticleCurveValue,\n  PibblParticleGradient,\n} from \"./types.js\";\n\nexport const PARTICLE_CURVE_POINT_COUNT = 257;\nconst PARTICLE_CURVE_SEGMENTS = PARTICLE_CURVE_POINT_COUNT - 1;\n\nexport interface CompiledParticleCurve {\n  readonly dimension: 1 | 2;\n  readonly pointCount: 257;\n  readonly samples: readonly number[];\n}\n\nexport interface CompiledParticleGradient {\n  readonly pointCount: 257;\n  readonly samples: readonly number[];\n  readonly cssSamples: readonly string[];\n}\n\nfunction clampProgress(progress: number): number {\n  return Math.min(1, Math.max(0, progress));\n}\n\nexport function compileEasingTable(easing?: PibblEasing): readonly number[] {\n  const samples: number[] = [];\n  for (let index = 0; index < PARTICLE_CURVE_POINT_COUNT; index += 1) {\n    const progress = index / PARTICLE_CURVE_SEGMENTS;\n    const value = easing === undefined ? progress : easing(progress);\n    if (!Number.isFinite(value)) {\n      throw new RangeError(\n        `Particle curve easing must return finite samples; received ${String(value)} at ${progress}.`,\n      );\n    }\n    samples.push(value);\n  }\n  return Object.freeze(samples);\n}\n\nexport function sampleEasingTable(\n  samples: readonly number[],\n  progress: number,\n): number {\n  const scaled = clampProgress(progress) * PARTICLE_CURVE_SEGMENTS;\n  const lower = Math.floor(scaled);\n  if (lower >= PARTICLE_CURVE_SEGMENTS)\n    return samples[PARTICLE_CURVE_SEGMENTS]!;\n  const fraction = scaled - lower;\n  const from = samples[lower]!;\n  return from + (samples[lower + 1]! - from) * fraction;\n}\n\nfunction findSegment(\n  keys: readonly (readonly [time: number, value: unknown])[],\n  time: number,\n): number {\n  let index = 0;\n  while (index + 1 < keys.length - 1 && time > keys[index + 1]![0]) index += 1;\n  return index;\n}\n\nfunction segmentProgress(\n  keys: readonly (readonly [time: number, value: unknown])[],\n  segment: number,\n  time: number,\n): number {\n  const from = keys[segment]![0];\n  const to = keys[segment + 1]![0];\n  return to === from ? 1 : (time - from) / (to - from);\n}\n\nfunction curveComponent(\n  value: PibblParticleCurveValue,\n  component: number,\n): number {\n  return typeof value === \"number\" ? value : value[component]!;\n}\n\nexport function compileParticleCurve(\n  descriptor: PibblParticleCurve<PibblParticleCurveValue>,\n): CompiledParticleCurve {\n  const record = getParticleDescriptorRecord(descriptor);\n  if (record?.type !== \"curve\") {\n    throw new TypeError(\"Expected a curve created by particleCurve().\");\n  }\n  const dimension: 1 | 2 = typeof record.keys[0]![1] === \"number\" ? 1 : 2;\n  const easing = compileEasingTable(record.options?.easing);\n  const samples: number[] = [];\n  for (let index = 0; index < PARTICLE_CURVE_POINT_COUNT; index += 1) {\n    const time = index / PARTICLE_CURVE_SEGMENTS;\n    const segment = findSegment(record.keys, time);\n    const from = record.keys[segment]![1];\n    const to = record.keys[segment + 1]![1];\n    const progress = sampleEasingTable(\n      easing,\n      segmentProgress(record.keys, segment, time),\n    );\n    for (let component = 0; component < dimension; component += 1) {\n      const start = curveComponent(from, component);\n      samples.push(start + (curveComponent(to, component) - start) * progress);\n    }\n  }\n  return Object.freeze({\n    dimension,\n    pointCount: PARTICLE_CURVE_POINT_COUNT,\n    samples: Object.freeze(samples),\n  });\n}\n\nexport function sampleParticleCurve(\n  curve: CompiledParticleCurve,\n  normalizedAge: number,\n  component: number,\n): number {\n  const scaled = clampProgress(normalizedAge) * PARTICLE_CURVE_SEGMENTS;\n  const lower = Math.floor(scaled);\n  const lowerValue = curve.samples[lower * curve.dimension + component]!;\n  if (lower >= PARTICLE_CURVE_SEGMENTS) return lowerValue;\n  const fraction = scaled - lower;\n  const upperValue = curve.samples[(lower + 1) * curve.dimension + component]!;\n  return lowerValue + (upperValue - lowerValue) * fraction;\n}\n\nexport function compileParticleGradient(\n  descriptor: PibblParticleGradient,\n): CompiledParticleGradient {\n  const record = getParticleDescriptorRecord(descriptor);\n  if (record?.type !== \"gradient\") {\n    throw new TypeError(\"Expected a gradient created by particleGradient().\");\n  }\n  const easing = compileEasingTable(record.options?.easing);\n  const samples: number[] = [];\n  const cssSamples: string[] = [];\n  for (let index = 0; index < PARTICLE_CURVE_POINT_COUNT; index += 1) {\n    const time = index / PARTICLE_CURVE_SEGMENTS;\n    const segment = findSegment(record.keys, time);\n    const from = parseParticleColor(record.keys[segment]![1]);\n    const to = parseParticleColor(record.keys[segment + 1]![1]);\n    const progress = sampleEasingTable(\n      easing,\n      segmentProgress(record.keys, segment, time),\n    );\n    const red = clampProgress(from[0] + (to[0] - from[0]) * progress);\n    const green = clampProgress(from[1] + (to[1] - from[1]) * progress);\n    const blue = clampProgress(from[2] + (to[2] - from[2]) * progress);\n    const alpha = clampProgress(from[3] + (to[3] - from[3]) * progress);\n    samples.push(red, green, blue, alpha);\n    cssSamples.push(\n      `rgba(${red * 255} ${green * 255} ${blue * 255} / ${alpha})`,\n    );\n  }\n  return Object.freeze({\n    pointCount: PARTICLE_CURVE_POINT_COUNT,\n    samples: Object.freeze(samples),\n    cssSamples: Object.freeze(cssSamples),\n  });\n}\n\nexport function sampleParticleGradient(\n  gradient: CompiledParticleGradient,\n  normalizedAge: number,\n  output: Float64Array,\n  offset: number,\n): void {\n  const index =\n    Math.round(clampProgress(normalizedAge) * PARTICLE_CURVE_SEGMENTS) * 4;\n  output[offset] = gradient.samples[index]!;\n  output[offset + 1] = gradient.samples[index + 1]!;\n  output[offset + 2] = gradient.samples[index + 2]!;\n  output[offset + 3] = gradient.samples[index + 3]!;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/features/particles/lib/definition-records.d.ts

@@ -0,0 +1,58 @@
+import type { PibblParticleAppearance, PibblParticleBounds2D, PibblParticleEffect2D, PibblParticleEmission, PibblParticleEmitter2D, PibblParticleParameterDefinitions, PibblParticleRenderer2D, PibblParticleScalar } from './types.js';
+export interface ParticleDefinitionCapabilities {
+    readonly statelessCanvas: boolean;
+    readonly requiresStateful: readonly string[];
+}
+type NativeParticleRenderer2D = Exclude<PibblParticleRenderer2D, {
+    type: 'path';
+}> | Readonly<{
+    type: 'path';
+    path: Path2D;
+    blend?: 'source-over' | 'additive';
+}>;
+export interface ParticleEmitter2DRecord extends Omit<PibblParticleEmitter2D, 'bounds' | 'renderer'> {
+    readonly renderer: NativeParticleRenderer2D;
+    readonly nameHash: number;
+    readonly bounds: PibblParticleBounds2D;
+    readonly boundsSource: 'explicit' | 'derived';
+}
+interface BaseParticleEffectRecord {
+    readonly debugName: string | undefined;
+    readonly parameters: PibblParticleParameterDefinitions;
+    readonly emitterNames: readonly string[];
+    readonly capabilities: ParticleDefinitionCapabilities;
+}
+export interface ParticleEffect2DRecord extends BaseParticleEffectRecord {
+    readonly dimension: 2;
+    readonly emitters: readonly ParticleEmitter2DRecord[];
+}
+export interface ParticleValidationContext {
+    readonly debugName?: string;
+    readonly emitter?: string;
+    readonly module?: string;
+    readonly property?: string;
+}
+export interface ParticleScalarRange {
+    readonly min: number;
+    readonly max: number;
+    readonly dynamic: boolean;
+}
+export declare function particleDefinitionError(context: ParticleValidationContext, message: string, value?: unknown, ErrorConstructor?: typeof TypeError | typeof RangeError): never;
+export declare function assertFiniteNumber(value: unknown, context: ParticleValidationContext): asserts value is number;
+export declare function assertNonnegativeNumber(value: unknown, context: ParticleValidationContext): asserts value is number;
+export declare function assertPositiveNumber(value: unknown, context: ParticleValidationContext): asserts value is number;
+export declare function assertFiniteVector(value: unknown, dimension: 2, context: ParticleValidationContext): asserts value is readonly number[];
+export declare function freezeParticleRecord<T>(value: T, seen?: WeakSet<object>): T;
+export declare function cloneParticleRecord<T>(value: T, seen?: WeakMap<object, unknown>): T;
+export declare function hashParticleEmitterName(name: string): number;
+export declare function normalizeParameters(parameters: PibblParticleParameterDefinitions | undefined, debugName: string | undefined): PibblParticleParameterDefinitions;
+export declare function particleScalarRange(value: PibblParticleScalar, parameters: PibblParticleParameterDefinitions, context: ParticleValidationContext): ParticleScalarRange;
+export declare function validateScalarVector(value: unknown, dimension: 2, parameters: PibblParticleParameterDefinitions, context: ParticleValidationContext): readonly ParticleScalarRange[];
+export declare function normalizeEmission(emission: readonly PibblParticleEmission[], context: ParticleValidationContext): readonly PibblParticleEmission[];
+export declare function validateAppearance(appearance: PibblParticleAppearance | undefined, context: ParticleValidationContext): PibblParticleAppearance | undefined;
+export declare function normalizeBounds2D(bounds: PibblParticleBounds2D, context: ParticleValidationContext): PibblParticleBounds2D;
+export declare function normalizeRenderer2D(renderer: PibblParticleRenderer2D, context: ParticleValidationContext): NativeParticleRenderer2D;
+export declare function createParticleEffect2D(record: ParticleEffect2DRecord): PibblParticleEffect2D;
+/** @internal Returns the immutable normalized record for a package-created 2D effect. */
+export declare function getParticleEffect2DRecord(effect: PibblParticleEffect2D): ParticleEffect2DRecord;
+export {};

package/dist/features/particles/lib/definition-records.js

@@ -0,0 +1,500 @@
+import { PathGeometry, toPath2D } from "@pibbl/core";
+import { getParticleDescriptorRecord } from "./particle.js";
+const effect2DRecords = /* @__PURE__ */ new WeakMap();
+function effectLabel(debugName) {
+  return debugName === void 0 ? "Pibbl particle effect" : `Pibbl particle effect "${debugName}"`;
+}
+function valueLabel(value) {
+  if (typeof value === "string") return `"${value}"`;
+  if (typeof value === "number" || typeof value === "boolean" || value == null) {
+    return String(value);
+  }
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return Object.prototype.toString.call(value);
+  }
+}
+function particleDefinitionError(context, message, value, ErrorConstructor = TypeError) {
+  const path = [
+    effectLabel(context.debugName),
+    context.emitter === void 0 ? void 0 : `emitter "${context.emitter}"`,
+    context.module,
+    context.property
+  ].filter((part) => part !== void 0).join(" ");
+  const received = arguments.length >= 3 ? `; received ${valueLabel(value)}` : "";
+  throw new ErrorConstructor(`${path} ${message}${received}.`);
+}
+function assertFiniteNumber(value, context) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    particleDefinitionError(context, "must be finite", value, RangeError);
+  }
+}
+function assertNonnegativeNumber(value, context) {
+  assertFiniteNumber(value, context);
+  if (value < 0) particleDefinitionError(context, "must be nonnegative", value, RangeError);
+}
+function assertPositiveNumber(value, context) {
+  assertFiniteNumber(value, context);
+  if (value <= 0) particleDefinitionError(context, "must be positive", value, RangeError);
+}
+function assertFiniteVector(value, dimension, context) {
+  if (!Array.isArray(value) || value.length !== dimension) {
+    particleDefinitionError(context, `must be a ${dimension}-dimensional vector`, value);
+  }
+  for (let index = 0; index < dimension; index += 1) {
+    assertFiniteNumber(value[index], {
+      ...context,
+      property: `${context.property ?? "value"}[${index}]`
+    });
+  }
+}
+function freezeParticleRecord(value, seen = /* @__PURE__ */ new WeakSet()) {
+  if (value === null || typeof value !== "object" || seen.has(value)) return value;
+  if (getParticleDescriptorRecord(value) !== void 0) return value;
+  const prototype = Object.getPrototypeOf(value);
+  if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {
+    return value;
+  }
+  seen.add(value);
+  for (const entry of Object.values(value)) freezeParticleRecord(entry, seen);
+  return Object.freeze(value);
+}
+function cloneParticleRecord(value, seen = /* @__PURE__ */ new WeakMap()) {
+  if (value === null || typeof value !== "object") return value;
+  if (getParticleDescriptorRecord(value) !== void 0) return value;
+  const existing = seen.get(value);
+  if (existing !== void 0) return existing;
+  if (Array.isArray(value)) {
+    const clone2 = [];
+    seen.set(value, clone2);
+    for (const entry of value) clone2.push(cloneParticleRecord(entry, seen));
+    return Object.freeze(clone2);
+  }
+  const prototype = Object.getPrototypeOf(value);
+  if (prototype !== Object.prototype && prototype !== null) return value;
+  const clone = Object.create(prototype);
+  seen.set(value, clone);
+  for (const [key, entry] of Object.entries(value)) {
+    clone[key] = cloneParticleRecord(entry, seen);
+  }
+  return Object.freeze(clone);
+}
+function hashParticleEmitterName(name) {
+  let hash = 2166136261;
+  for (let index = 0; index < name.length; index += 1) {
+    hash = Math.imul(hash ^ name.charCodeAt(index), 16777619);
+  }
+  return hash >>> 0;
+}
+function normalizeParameters(parameters, debugName) {
+  if (parameters === void 0) return Object.freeze({});
+  if (parameters === null || typeof parameters !== "object" || Array.isArray(parameters)) {
+    particleDefinitionError({ debugName, property: "parameters" }, "must be a record", parameters);
+  }
+  const normalized = {};
+  for (const [name, definition] of Object.entries(parameters)) {
+    if (name.trim().length === 0) {
+      particleDefinitionError(
+        { debugName, property: "parameters" },
+        "parameter names must be nonempty",
+        name
+      );
+    }
+    if (definition === null || typeof definition !== "object") {
+      particleDefinitionError(
+        { debugName, module: `parameter "${name}"`, property: "definition" },
+        "must be a record",
+        definition
+      );
+    }
+    if (!["spawn", "simulation", "render"].includes(definition.timing)) {
+      particleDefinitionError(
+        { debugName, module: `parameter "${name}"`, property: "timing" },
+        "must be spawn, simulation, or render",
+        definition.timing
+      );
+    }
+    switch (definition.type) {
+      case "number":
+        assertFiniteNumber(definition.default, {
+          debugName,
+          module: `parameter "${name}"`,
+          property: "default"
+        });
+        break;
+      case "vector2":
+        assertFiniteVector(definition.default, 2, {
+          debugName,
+          module: `parameter "${name}"`,
+          property: "default"
+        });
+        break;
+      case "color":
+        if (typeof definition.default !== "string" || definition.default.trim().length === 0) {
+          particleDefinitionError(
+            { debugName, module: `parameter "${name}"`, property: "default" },
+            "must be a nonempty color string",
+            definition.default
+          );
+        }
+        break;
+      default:
+        particleDefinitionError(
+          { debugName, module: `parameter "${name}"`, property: "type" },
+          "uses an unsupported parameter type",
+          definition.type
+        );
+    }
+    normalized[name] = cloneParticleRecord(definition);
+  }
+  return Object.freeze(normalized);
+}
+function descriptorScalarRange(value, parameters, context) {
+  const descriptor = getParticleDescriptorRecord(value);
+  if (descriptor === void 0) {
+    particleDefinitionError(
+      context,
+      "must use a descriptor created by particle",
+      value
+    );
+  }
+  switch (descriptor.type) {
+    case "between":
+    case "integer":
+      return Object.freeze({ min: descriptor.min, max: descriptor.max, dynamic: false });
+    case "choice": {
+      let min = Number.POSITIVE_INFINITY;
+      let max = Number.NEGATIVE_INFINITY;
+      for (let index = 0; index < descriptor.choices.length; index += 1) {
+        const choice = descriptor.choices[index];
+        assertFiniteNumber(choice.value, {
+          ...context,
+          property: `${context.property ?? "value"}.choices[${index}].value`
+        });
+        min = Math.min(min, choice.value);
+        max = Math.max(max, choice.value);
+      }
+      return Object.freeze({ min, max, dynamic: false });
+    }
+    case "parameter": {
+      const definition = parameters[descriptor.name];
+      if (definition === void 0) {
+        particleDefinitionError(
+          context,
+          "references an unknown parameter",
+          descriptor.name
+        );
+      }
+      if (definition.type !== "number") {
+        particleDefinitionError(
+          context,
+          "requires a number parameter",
+          `${descriptor.name}:${definition.type}`
+        );
+      }
+      return Object.freeze({
+        min: definition.default,
+        max: definition.default,
+        dynamic: true
+      });
+    }
+    default:
+      particleDefinitionError(context, "must be a scalar particle descriptor", descriptor.type);
+  }
+}
+function particleScalarRange(value, parameters, context) {
+  if (typeof value === "number") {
+    assertFiniteNumber(value, context);
+    return Object.freeze({ min: value, max: value, dynamic: false });
+  }
+  if (value === null || typeof value !== "object") {
+    particleDefinitionError(context, "must be a finite particle scalar", value);
+  }
+  return descriptorScalarRange(value, parameters, context);
+}
+function validateScalarVector(value, dimension, parameters, context) {
+  if (!Array.isArray(value)) {
+    const descriptor = getParticleDescriptorRecord(value);
+    if (descriptor?.type !== "parameter") {
+      particleDefinitionError(context, `must be a ${dimension}-dimensional particle vector`, value);
+    }
+    const definition = parameters[descriptor.name];
+    if (definition === void 0) {
+      particleDefinitionError(context, "references an unknown parameter", descriptor.name);
+    }
+    if (definition.type !== "vector2") {
+      particleDefinitionError(
+        context,
+        `parameter "${descriptor.name}" has type ${definition.type}; expected a ${dimension}-dimensional vector parameter`
+      );
+    }
+    return Object.freeze(definition.default.map((entry) => Object.freeze({
+      min: entry,
+      max: entry,
+      dynamic: true
+    })));
+  }
+  if (value.length !== dimension) {
+    particleDefinitionError(context, `must be a ${dimension}-dimensional particle vector`, value);
+  }
+  return Object.freeze(value.map((entry, index) => particleScalarRange(
+    entry,
+    parameters,
+    { ...context, property: `${context.property ?? "value"}[${index}]` }
+  )));
+}
+function validateRepeat(repeat, context) {
+  if (repeat === void 0) return;
+  if (repeat === null || typeof repeat !== "object") {
+    particleDefinitionError(context, "must be a record", repeat);
+  }
+  assertPositiveNumber(repeat.everyMilliseconds, {
+    ...context,
+    property: `${context.property}.everyMilliseconds`
+  });
+  if (!Number.isSafeInteger(repeat.count) || repeat.count <= 0) {
+    particleDefinitionError(
+      { ...context, property: `${context.property}.count` },
+      "must be a positive safe integer",
+      repeat.count,
+      RangeError
+    );
+  }
+}
+function validateProbability(value, context) {
+  if (value === void 0) return;
+  assertFiniteNumber(value, context);
+  if (value < 0 || value > 1) {
+    particleDefinitionError(context, "must be within [0, 1]", value, RangeError);
+  }
+}
+function validateCount(value, context) {
+  if (typeof value === "number") {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+      particleDefinitionError(context, "must be a positive safe integer", value, RangeError);
+    }
+    return;
+  }
+  const descriptor = getParticleDescriptorRecord(value);
+  if (descriptor?.type !== "integer" || descriptor.min <= 0) {
+    particleDefinitionError(
+      context,
+      "must be a positive integer or positive particleInteger range",
+      value,
+      RangeError
+    );
+  }
+}
+function normalizeEmission(emission, context) {
+  if (!Array.isArray(emission) || emission.length === 0) {
+    particleDefinitionError(
+      { ...context, property: "emission" },
+      "must be a nonempty array",
+      emission
+    );
+  }
+  for (let index = 0; index < emission.length; index += 1) {
+    const source = emission[index];
+    if (source === null || typeof source !== "object") {
+      particleDefinitionError(
+        { ...context, module: `emission[${index}]` },
+        "must be an emission record",
+        source
+      );
+    }
+    const module = `emission[${index}] ${String(source.type)}`;
+    switch (source.type) {
+      case "rate":
+        assertNonnegativeNumber(source.particlesPerSecond, {
+          ...context,
+          module,
+          property: "particlesPerSecond"
+        });
+        if (source.startMilliseconds !== void 0) {
+          assertNonnegativeNumber(source.startMilliseconds, {
+            ...context,
+            module,
+            property: "startMilliseconds"
+          });
+        }
+        if (source.durationMilliseconds !== void 0) {
+          assertNonnegativeNumber(source.durationMilliseconds, {
+            ...context,
+            module,
+            property: "durationMilliseconds"
+          });
+        }
+        validateProbability(source.probability, {
+          ...context,
+          module,
+          property: "probability"
+        });
+        validateRepeat(source.repeat, { ...context, module, property: "repeat" });
+        break;
+      case "burst":
+        assertNonnegativeNumber(source.atMilliseconds, {
+          ...context,
+          module,
+          property: "atMilliseconds"
+        });
+        validateCount(source.count, { ...context, module, property: "count" });
+        validateProbability(source.probability, {
+          ...context,
+          module,
+          property: "probability"
+        });
+        validateRepeat(source.repeat, { ...context, module, property: "repeat" });
+        break;
+      case "manual":
+        if (source.count !== void 0) {
+          validateCount(source.count, { ...context, module, property: "count" });
+        }
+        break;
+      default:
+        particleDefinitionError(
+          { ...context, module, property: "type" },
+          "uses an unsupported emission type",
+          source.type
+        );
+    }
+  }
+  return cloneParticleRecord(emission);
+}
+function validateAppearance(appearance, context) {
+  if (appearance === void 0) return void 0;
+  if (appearance === null || typeof appearance !== "object" || Array.isArray(appearance)) {
+    particleDefinitionError(
+      { ...context, property: "appearance" },
+      "must be a record",
+      appearance
+    );
+  }
+  for (const [property, descriptor] of Object.entries(appearance)) {
+    if (descriptor === void 0) continue;
+    const record = getParticleDescriptorRecord(descriptor);
+    const expected = property === "color" ? "gradient" : "curve";
+    if (record?.type !== expected) {
+      particleDefinitionError(
+        { ...context, module: "appearance", property },
+        `must use particle.${expected}`,
+        descriptor
+      );
+    }
+  }
+  return cloneParticleRecord(appearance);
+}
+function normalizeBounds2D(bounds, context) {
+  if (bounds === null || typeof bounds !== "object") {
+    particleDefinitionError({ ...context, property: "bounds" }, "must be a record", bounds);
+  }
+  assertFiniteVector(bounds.min, 2, { ...context, property: "bounds.min" });
+  assertFiniteVector(bounds.max, 2, { ...context, property: "bounds.max" });
+  for (let index = 0; index < 2; index += 1) {
+    if (bounds.min[index] > bounds.max[index]) {
+      particleDefinitionError(
+        { ...context, property: `bounds.min[${index}]` },
+        `must be at most bounds.max[${index}]`,
+        bounds.min[index],
+        RangeError
+      );
+    }
+  }
+  return cloneParticleRecord(bounds);
+}
+function normalizeRenderer2D(renderer, context) {
+  if (renderer === null || typeof renderer !== "object") {
+    particleDefinitionError(
+      { ...context, property: "renderer" },
+      "must be a record",
+      renderer
+    );
+  }
+  const module = `renderer ${String(renderer.type)}`;
+  const blend = renderer.blend ?? "source-over";
+  if (blend !== "source-over" && blend !== "additive") {
+    particleDefinitionError({ ...context, module, property: "blend" }, "is unsupported", blend);
+  }
+  switch (renderer.type) {
+    case "circle":
+      return Object.freeze({ type: "circle", blend });
+    case "rectangle":
+      if (renderer.aspectRatio !== void 0) {
+        assertPositiveNumber(renderer.aspectRatio, {
+          ...context,
+          module,
+          property: "aspectRatio"
+        });
+      }
+      return Object.freeze({
+        type: "rectangle",
+        ...renderer.aspectRatio === void 0 ? {} : { aspectRatio: renderer.aspectRatio },
+        blend
+      });
+    case "path":
+      if (renderer.path instanceof PathGeometry) {
+        return Object.freeze({ type: "path", path: toPath2D(renderer.path), blend });
+      }
+      if (typeof Path2D === "undefined" || !(renderer.path instanceof Path2D)) {
+        particleDefinitionError({ ...context, module, property: "path" }, "must be a Path2D or PathGeometry", renderer.path);
+      }
+      return Object.freeze({ type: "path", path: new Path2D(renderer.path), blend });
+    case "sprite":
+      if (renderer.source === null || typeof renderer.source !== "object" && typeof renderer.source !== "function") {
+        particleDefinitionError(
+          { ...context, module, property: "source" },
+          "must be a CanvasImageSource",
+          renderer.source
+        );
+      }
+      if (renderer.anchor !== void 0) {
+        assertFiniteVector(renderer.anchor, 2, { ...context, module, property: "anchor" });
+      }
+      return Object.freeze({
+        type: "sprite",
+        source: renderer.source,
+        ...renderer.anchor === void 0 ? {} : {
+          anchor: cloneParticleRecord(renderer.anchor)
+        },
+        blend
+      });
+    default:
+      particleDefinitionError(
+        { ...context, module, property: "type" },
+        "uses an unsupported Canvas renderer",
+        renderer.type
+      );
+  }
+}
+function createParticleEffect2D(record) {
+  const effect = Object.freeze({ dimension: 2 });
+  effect2DRecords.set(effect, freezeParticleRecord(record));
+  return effect;
+}
+function getParticleEffect2DRecord(effect) {
+  const record = effect2DRecords.get(effect);
+  if (record === void 0) {
+    throw new TypeError("Expected a 2D particle effect created by defineParticleEffect2D().");
+  }
+  return record;
+}
+export {
+  assertFiniteNumber,
+  assertFiniteVector,
+  assertNonnegativeNumber,
+  assertPositiveNumber,
+  cloneParticleRecord,
+  createParticleEffect2D,
+  freezeParticleRecord,
+  getParticleEffect2DRecord,
+  hashParticleEmitterName,
+  normalizeBounds2D,
+  normalizeEmission,
+  normalizeParameters,
+  normalizeRenderer2D,
+  particleDefinitionError,
+  particleScalarRange,
+  validateAppearance,
+  validateScalarVector
+};
+//# sourceMappingURL=definition-records.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/particles/lib/definition-records.ts"],
+  "sourcesContent": ["import { PathGeometry, toPath2D } from '@pibbl/core';\nimport type {\n  PibblParticleAppearance,\n  PibblParticleBounds2D,\n  PibblParticleEffect2D,\n  PibblParticleEmission,\n  PibblParticleEmitter2D,\n  PibblParticleParameterDefinition,\n  PibblParticleParameterDefinitions,\n  PibblParticleRenderer2D,\n  PibblParticleScalar,\n} from './types.js';\nimport { getParticleDescriptorRecord } from './particle.js';\n\nexport interface ParticleDefinitionCapabilities {\n  readonly statelessCanvas: boolean;\n  readonly requiresStateful: readonly string[];\n}\n\ntype NativeParticleRenderer2D = Exclude<PibblParticleRenderer2D, { type: 'path' }> | Readonly<{ type: 'path'; path: Path2D; blend?: 'source-over' | 'additive' }>;\n\nexport interface ParticleEmitter2DRecord\n  extends Omit<PibblParticleEmitter2D, 'bounds' | 'renderer'> {\n  readonly renderer: NativeParticleRenderer2D;\n  readonly nameHash: number;\n  readonly bounds: PibblParticleBounds2D;\n  readonly boundsSource: 'explicit' | 'derived';\n}\n\ninterface BaseParticleEffectRecord {\n  readonly debugName: string | undefined;\n  readonly parameters: PibblParticleParameterDefinitions;\n  readonly emitterNames: readonly string[];\n  readonly capabilities: ParticleDefinitionCapabilities;\n}\n\nexport interface ParticleEffect2DRecord extends BaseParticleEffectRecord {\n  readonly dimension: 2;\n  readonly emitters: readonly ParticleEmitter2DRecord[];\n}\n\nexport interface ParticleValidationContext {\n  readonly debugName?: string;\n  readonly emitter?: string;\n  readonly module?: string;\n  readonly property?: string;\n}\n\nexport interface ParticleScalarRange {\n  readonly min: number;\n  readonly max: number;\n  readonly dynamic: boolean;\n}\n\nconst effect2DRecords = new WeakMap<PibblParticleEffect2D, ParticleEffect2DRecord>();\n\nfunction effectLabel(debugName: string | undefined): string {\n  return debugName === undefined ? 'Pibbl particle effect' :\n    `Pibbl particle effect \"${debugName}\"`;\n}\n\nfunction valueLabel(value: unknown): string {\n  if (typeof value === 'string') return `\"${value}\"`;\n  if (typeof value === 'number' || typeof value === 'boolean' || value == null) {\n    return String(value);\n  }\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return Object.prototype.toString.call(value);\n  }\n}\n\nexport function particleDefinitionError(\n  context: ParticleValidationContext,\n  message: string,\n  value?: unknown,\n  ErrorConstructor: typeof TypeError | typeof RangeError = TypeError,\n): never {\n  const path = [\n    effectLabel(context.debugName),\n    context.emitter === undefined ? undefined : `emitter \"${context.emitter}\"`,\n    context.module,\n    context.property,\n  ].filter((part): part is string => part !== undefined).join(' ');\n  const received = arguments.length >= 3 ? `; received ${valueLabel(value)}` : '';\n  throw new ErrorConstructor(`${path} ${message}${received}.`);\n}\n\nexport function assertFiniteNumber(\n  value: unknown,\n  context: ParticleValidationContext,\n): asserts value is number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    particleDefinitionError(context, 'must be finite', value, RangeError);\n  }\n}\n\nexport function assertNonnegativeNumber(\n  value: unknown,\n  context: ParticleValidationContext,\n): asserts value is number {\n  assertFiniteNumber(value, context);\n  if (value < 0) particleDefinitionError(context, 'must be nonnegative', value, RangeError);\n}\n\nexport function assertPositiveNumber(\n  value: unknown,\n  context: ParticleValidationContext,\n): asserts value is number {\n  assertFiniteNumber(value, context);\n  if (value <= 0) particleDefinitionError(context, 'must be positive', value, RangeError);\n}\n\nexport function assertFiniteVector(\n  value: unknown,\n  dimension: 2,\n  context: ParticleValidationContext,\n): asserts value is readonly number[] {\n  if (!Array.isArray(value) || value.length !== dimension) {\n    particleDefinitionError(context, `must be a ${dimension}-dimensional vector`, value);\n  }\n  for (let index = 0; index < dimension; index += 1) {\n    assertFiniteNumber(value[index], {\n      ...context,\n      property: `${context.property ?? 'value'}[${index}]`,\n    });\n  }\n}\n\nexport function freezeParticleRecord<T>(\n  value: T,\n  seen = new WeakSet<object>(),\n): T {\n  if (value === null || typeof value !== 'object' || seen.has(value)) return value;\n  if (getParticleDescriptorRecord(value) !== undefined) return value;\n  const prototype = Object.getPrototypeOf(value);\n  if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {\n    return value;\n  }\n  seen.add(value);\n  for (const entry of Object.values(value)) freezeParticleRecord(entry, seen);\n  return Object.freeze(value);\n}\n\nexport function cloneParticleRecord<T>(\n  value: T,\n  seen = new WeakMap<object, unknown>(),\n): T {\n  if (value === null || typeof value !== 'object') return value;\n  if (getParticleDescriptorRecord(value) !== undefined) return value;\n  const existing = seen.get(value);\n  if (existing !== undefined) return existing as T;\n  if (Array.isArray(value)) {\n    const clone: unknown[] = [];\n    seen.set(value, clone);\n    for (const entry of value) clone.push(cloneParticleRecord(entry, seen));\n    return Object.freeze(clone) as T;\n  }\n  const prototype = Object.getPrototypeOf(value);\n  if (prototype !== Object.prototype && prototype !== null) return value;\n  const clone: Record<string, unknown> = Object.create(prototype);\n  seen.set(value, clone);\n  for (const [key, entry] of Object.entries(value)) {\n    clone[key] = cloneParticleRecord(entry, seen);\n  }\n  return Object.freeze(clone) as T;\n}\n\nexport function hashParticleEmitterName(name: string): number {\n  let hash = 0x811c9dc5;\n  for (let index = 0; index < name.length; index += 1) {\n    hash = Math.imul(hash ^ name.charCodeAt(index), 0x01000193);\n  }\n  return hash >>> 0;\n}\n\nexport function normalizeParameters(\n  parameters: PibblParticleParameterDefinitions | undefined,\n  debugName: string | undefined,\n): PibblParticleParameterDefinitions {\n  if (parameters === undefined) return Object.freeze({});\n  if (parameters === null || typeof parameters !== 'object' || Array.isArray(parameters)) {\n    particleDefinitionError({ debugName, property: 'parameters' }, 'must be a record', parameters);\n  }\n  const normalized: Record<string, PibblParticleParameterDefinition> = {};\n  for (const [name, definition] of Object.entries(parameters)) {\n    if (name.trim().length === 0) {\n      particleDefinitionError(\n        { debugName, property: 'parameters' },\n        'parameter names must be nonempty',\n        name,\n      );\n    }\n    if (definition === null || typeof definition !== 'object') {\n      particleDefinitionError(\n        { debugName, module: `parameter \"${name}\"`, property: 'definition' },\n        'must be a record',\n        definition,\n      );\n    }\n    if (!['spawn', 'simulation', 'render'].includes(definition.timing)) {\n      particleDefinitionError(\n        { debugName, module: `parameter \"${name}\"`, property: 'timing' },\n        'must be spawn, simulation, or render',\n        definition.timing,\n      );\n    }\n    switch (definition.type) {\n      case 'number':\n        assertFiniteNumber(definition.default, {\n          debugName, module: `parameter \"${name}\"`, property: 'default',\n        });\n        break;\n      case 'vector2':\n        assertFiniteVector(definition.default, 2, {\n          debugName, module: `parameter \"${name}\"`, property: 'default',\n        });\n        break;\n      case 'color':\n        if (typeof definition.default !== 'string' || definition.default.trim().length === 0) {\n          particleDefinitionError(\n            { debugName, module: `parameter \"${name}\"`, property: 'default' },\n            'must be a nonempty color string',\n            definition.default,\n          );\n        }\n        break;\n      default:\n        particleDefinitionError(\n          { debugName, module: `parameter \"${name}\"`, property: 'type' },\n          'uses an unsupported parameter type',\n          (definition as { type?: unknown }).type,\n        );\n    }\n    normalized[name] = cloneParticleRecord(definition);\n  }\n  return Object.freeze(normalized);\n}\n\nfunction descriptorScalarRange(\n  value: object,\n  parameters: PibblParticleParameterDefinitions,\n  context: ParticleValidationContext,\n): ParticleScalarRange {\n  const descriptor = getParticleDescriptorRecord(value);\n  if (descriptor === undefined) {\n    particleDefinitionError(\n      context,\n      'must use a descriptor created by particle',\n      value,\n    );\n  }\n  switch (descriptor.type) {\n    case 'between':\n    case 'integer':\n      return Object.freeze({ min: descriptor.min, max: descriptor.max, dynamic: false });\n    case 'choice': {\n      let min = Number.POSITIVE_INFINITY;\n      let max = Number.NEGATIVE_INFINITY;\n      for (let index = 0; index < descriptor.choices.length; index += 1) {\n        const choice = descriptor.choices[index]!;\n        assertFiniteNumber(choice.value, {\n          ...context, property: `${context.property ?? 'value'}.choices[${index}].value`,\n        });\n        min = Math.min(min, choice.value);\n        max = Math.max(max, choice.value);\n      }\n      return Object.freeze({ min, max, dynamic: false });\n    }\n    case 'parameter': {\n      const definition = parameters[descriptor.name];\n      if (definition === undefined) {\n        particleDefinitionError(\n          context,\n          'references an unknown parameter',\n          descriptor.name,\n        );\n      }\n      if (definition.type !== 'number') {\n        particleDefinitionError(\n          context,\n          'requires a number parameter',\n          `${descriptor.name}:${definition.type}`,\n        );\n      }\n      return Object.freeze({\n        min: definition.default,\n        max: definition.default,\n        dynamic: true,\n      });\n    }\n    default:\n      particleDefinitionError(context, 'must be a scalar particle descriptor', descriptor.type);\n  }\n}\n\nexport function particleScalarRange(\n  value: PibblParticleScalar,\n  parameters: PibblParticleParameterDefinitions,\n  context: ParticleValidationContext,\n): ParticleScalarRange {\n  if (typeof value === 'number') {\n    assertFiniteNumber(value, context);\n    return Object.freeze({ min: value, max: value, dynamic: false });\n  }\n  if (value === null || typeof value !== 'object') {\n    particleDefinitionError(context, 'must be a finite particle scalar', value);\n  }\n  return descriptorScalarRange(value, parameters, context);\n}\n\nexport function validateScalarVector(\n  value: unknown,\n  dimension: 2,\n  parameters: PibblParticleParameterDefinitions,\n  context: ParticleValidationContext,\n): readonly ParticleScalarRange[] {\n  if (!Array.isArray(value)) {\n    const descriptor = getParticleDescriptorRecord(value);\n    if (descriptor?.type !== 'parameter') {\n      particleDefinitionError(context, `must be a ${dimension}-dimensional particle vector`, value);\n    }\n    const definition = parameters[descriptor.name];\n    if (definition === undefined) {\n      particleDefinitionError(context, 'references an unknown parameter', descriptor.name);\n    }\n    if (definition.type !== 'vector2') {\n      particleDefinitionError(\n        context,\n        `parameter \"${descriptor.name}\" has type ${definition.type}; expected a ${dimension}-dimensional vector parameter`,\n      );\n    }\n    return Object.freeze(definition.default.map(entry => Object.freeze({\n      min: entry,\n      max: entry,\n      dynamic: true,\n    })));\n  }\n  if (value.length !== dimension) {\n    particleDefinitionError(context, `must be a ${dimension}-dimensional particle vector`, value);\n  }\n  return Object.freeze(value.map((entry, index) => particleScalarRange(\n    entry as PibblParticleScalar,\n    parameters,\n    { ...context, property: `${context.property ?? 'value'}[${index}]` },\n  )));\n}\n\nfunction validateRepeat(\n  repeat: { readonly everyMilliseconds: number; readonly count: number } | undefined,\n  context: ParticleValidationContext,\n): void {\n  if (repeat === undefined) return;\n  if (repeat === null || typeof repeat !== 'object') {\n    particleDefinitionError(context, 'must be a record', repeat);\n  }\n  assertPositiveNumber(repeat.everyMilliseconds, {\n    ...context, property: `${context.property}.everyMilliseconds`,\n  });\n  if (!Number.isSafeInteger(repeat.count) || repeat.count <= 0) {\n    particleDefinitionError(\n      { ...context, property: `${context.property}.count` },\n      'must be a positive safe integer',\n      repeat.count,\n      RangeError,\n    );\n  }\n}\n\nfunction validateProbability(value: number | undefined, context: ParticleValidationContext): void {\n  if (value === undefined) return;\n  assertFiniteNumber(value, context);\n  if (value < 0 || value > 1) {\n    particleDefinitionError(context, 'must be within [0, 1]', value, RangeError);\n  }\n}\n\nfunction validateCount(\n  value: number | PibblParticleScalar,\n  context: ParticleValidationContext,\n): void {\n  if (typeof value === 'number') {\n    if (!Number.isSafeInteger(value) || value <= 0) {\n      particleDefinitionError(context, 'must be a positive safe integer', value, RangeError);\n    }\n    return;\n  }\n  const descriptor = getParticleDescriptorRecord(value);\n  if (descriptor?.type !== 'integer' || descriptor.min <= 0) {\n    particleDefinitionError(\n      context,\n      'must be a positive integer or positive particleInteger range',\n      value,\n      RangeError,\n    );\n  }\n}\n\nexport function normalizeEmission(\n  emission: readonly PibblParticleEmission[],\n  context: ParticleValidationContext,\n): readonly PibblParticleEmission[] {\n  if (!Array.isArray(emission) || emission.length === 0) {\n    particleDefinitionError(\n      { ...context, property: 'emission' },\n      'must be a nonempty array',\n      emission,\n    );\n  }\n  for (let index = 0; index < emission.length; index += 1) {\n    const source = emission[index]!;\n    if (source === null || typeof source !== 'object') {\n      particleDefinitionError(\n        { ...context, module: `emission[${index}]` },\n        'must be an emission record',\n        source,\n      );\n    }\n    const module = `emission[${index}] ${String((source as { type?: unknown }).type)}`;\n    switch (source.type) {\n      case 'rate':\n        assertNonnegativeNumber(source.particlesPerSecond, {\n          ...context, module, property: 'particlesPerSecond',\n        });\n        if (source.startMilliseconds !== undefined) {\n          assertNonnegativeNumber(source.startMilliseconds, {\n            ...context, module, property: 'startMilliseconds',\n          });\n        }\n        if (source.durationMilliseconds !== undefined) {\n          assertNonnegativeNumber(source.durationMilliseconds, {\n            ...context, module, property: 'durationMilliseconds',\n          });\n        }\n        validateProbability(source.probability, {\n          ...context, module, property: 'probability',\n        });\n        validateRepeat(source.repeat, { ...context, module, property: 'repeat' });\n        break;\n      case 'burst':\n        assertNonnegativeNumber(source.atMilliseconds, {\n          ...context, module, property: 'atMilliseconds',\n        });\n        validateCount(source.count, { ...context, module, property: 'count' });\n        validateProbability(source.probability, {\n          ...context, module, property: 'probability',\n        });\n        validateRepeat(source.repeat, { ...context, module, property: 'repeat' });\n        break;\n      case 'manual':\n        if (source.count !== undefined) {\n          validateCount(source.count, { ...context, module, property: 'count' });\n        }\n        break;\n      default:\n        particleDefinitionError(\n          { ...context, module, property: 'type' },\n          'uses an unsupported emission type',\n          (source as { type?: unknown }).type,\n        );\n    }\n  }\n  return cloneParticleRecord(emission);\n}\n\nexport function validateAppearance(\n  appearance: PibblParticleAppearance | undefined,\n  context: ParticleValidationContext,\n): PibblParticleAppearance | undefined {\n  if (appearance === undefined) return undefined;\n  if (appearance === null || typeof appearance !== 'object' || Array.isArray(appearance)) {\n    particleDefinitionError(\n      { ...context, property: 'appearance' }, 'must be a record', appearance,\n    );\n  }\n  for (const [property, descriptor] of Object.entries(appearance)) {\n    if (descriptor === undefined) continue;\n    const record = getParticleDescriptorRecord(descriptor);\n    const expected = property === 'color' ? 'gradient' : 'curve';\n    if (record?.type !== expected) {\n      particleDefinitionError(\n        { ...context, module: 'appearance', property },\n        `must use particle.${expected}`,\n        descriptor,\n      );\n    }\n  }\n  return cloneParticleRecord(appearance);\n}\n\nexport function normalizeBounds2D(\n  bounds: PibblParticleBounds2D,\n  context: ParticleValidationContext,\n): PibblParticleBounds2D {\n  if (bounds === null || typeof bounds !== 'object') {\n    particleDefinitionError({ ...context, property: 'bounds' }, 'must be a record', bounds);\n  }\n  assertFiniteVector(bounds.min, 2, { ...context, property: 'bounds.min' });\n  assertFiniteVector(bounds.max, 2, { ...context, property: 'bounds.max' });\n  for (let index = 0; index < 2; index += 1) {\n    if (bounds.min[index]! > bounds.max[index]!) {\n      particleDefinitionError(\n        { ...context, property: `bounds.min[${index}]` },\n        `must be at most bounds.max[${index}]`,\n        bounds.min[index],\n        RangeError,\n      );\n    }\n  }\n  return cloneParticleRecord(bounds);\n}\n\nexport function normalizeRenderer2D(\n  renderer: PibblParticleRenderer2D,\n  context: ParticleValidationContext,\n): NativeParticleRenderer2D {\n  if (renderer === null || typeof renderer !== 'object') {\n    particleDefinitionError(\n      { ...context, property: 'renderer' }, 'must be a record', renderer,\n    );\n  }\n  const module = `renderer ${String((renderer as { type?: unknown }).type)}`;\n  const blend = renderer.blend ?? 'source-over';\n  if (blend !== 'source-over' && blend !== 'additive') {\n    particleDefinitionError({ ...context, module, property: 'blend' }, 'is unsupported', blend);\n  }\n  switch (renderer.type) {\n    case 'circle':\n      return Object.freeze({ type: 'circle', blend });\n    case 'rectangle':\n      if (renderer.aspectRatio !== undefined) {\n        assertPositiveNumber(renderer.aspectRatio, {\n          ...context, module, property: 'aspectRatio',\n        });\n      }\n      return Object.freeze({\n        type: 'rectangle',\n        ...(renderer.aspectRatio === undefined ? {} : { aspectRatio: renderer.aspectRatio }),\n        blend,\n      });\n    case 'path':\n      if (renderer.path instanceof PathGeometry) {\n        return Object.freeze({ type: 'path', path: toPath2D(renderer.path), blend });\n      }\n      if (typeof Path2D === 'undefined' || !(renderer.path instanceof Path2D)) {\n        particleDefinitionError({ ...context, module, property: 'path' }, 'must be a Path2D or PathGeometry', renderer.path);\n      }\n      return Object.freeze({ type: 'path', path: new Path2D(renderer.path), blend });\n    case 'sprite':\n      if (renderer.source === null ||\n        (typeof renderer.source !== 'object' && typeof renderer.source !== 'function')) {\n        particleDefinitionError(\n          { ...context, module, property: 'source' },\n          'must be a CanvasImageSource',\n          renderer.source,\n        );\n      }\n      if (renderer.anchor !== undefined) {\n        assertFiniteVector(renderer.anchor, 2, { ...context, module, property: 'anchor' });\n      }\n      return Object.freeze({\n        type: 'sprite',\n        source: renderer.source,\n        ...(renderer.anchor === undefined ? {} : {\n          anchor: cloneParticleRecord(renderer.anchor),\n        }),\n        blend,\n      });\n    default:\n      particleDefinitionError(\n        { ...context, module, property: 'type' },\n        'uses an unsupported Canvas renderer',\n        (renderer as { type?: unknown }).type,\n      );\n  }\n}\n\nexport function createParticleEffect2D(\n  record: ParticleEffect2DRecord,\n): PibblParticleEffect2D {\n  const effect = Object.freeze({ dimension: 2 as const }) as PibblParticleEffect2D;\n  effect2DRecords.set(effect, freezeParticleRecord(record));\n  return effect;\n}\n\n/** @internal Returns the immutable normalized record for a package-created 2D effect. */\nexport function getParticleEffect2DRecord(effect: PibblParticleEffect2D): ParticleEffect2DRecord {\n  const record = effect2DRecords.get(effect);\n  if (record === undefined) {\n    throw new TypeError('Expected a 2D particle effect created by defineParticleEffect2D().');\n  }\n  return record;\n}\n"],
+  "mappings": "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",
+  "names": ["clone"]
+}