@pibbl/core 0.0.1

package/dist/features/particles/lib/canvas/primitive.js

@@ -0,0 +1,50 @@
+import {
+  definePrimitive,
+  resolveBox
+} from "@pibbl/core";
+import {
+  pibblInternalPaintTarget,
+  useInternalValueMemoSlot
+} from "@pibbl/core/internal";
+function renderParticleCanvas(props, style, context) {
+  const { borderBox, contentBox } = style;
+  const targetPath = useInternalValueMemoSlot("particleTargetPath", () => {
+    const path = new Path2D();
+    path.rect(borderBox.x, borderBox.y, borderBox.width, borderBox.height);
+    return path;
+  }, [borderBox.x, borderBox.y, borderBox.width, borderBox.height]);
+  const pointerEvents = props.interaction.pointerEvents ?? "none";
+  pibblInternalPaintTarget(
+    pointerEvents === "auto" ? props.interaction : {},
+    {
+      path: targetPath,
+      fill: true,
+      cursor: style.cursor,
+      keyboardFocusable: props.interaction.keyboardFocusable,
+      keyboardNavigationBounds: props.interaction.keyboardNavigationBounds ?? borderBox
+    },
+    pointerEvents
+  );
+  props.executor.draw(context, contentBox, style.opacity, style.overflow);
+}
+const ParticleCanvasPrimitive = definePrimitive(renderParticleCanvas, {
+  resolveStyle(style, context) {
+    return {
+      ...resolveBox(style, context.constraints, {
+        component: "Particles2D",
+        algorithm: "render-dispatch"
+      }),
+      opacity: style.opacity ?? 1,
+      overflow: style.overflow ?? "visible",
+      cursor: style.cursor
+    };
+  },
+  measure: () => ({
+    status: "unsupported",
+    reason: "Particles2D has no intrinsic size"
+  })
+});
+export {
+  ParticleCanvasPrimitive
+};
+//# sourceMappingURL=primitive.js.map

package/dist/features/particles/lib/canvas/primitive.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/features/particles/lib/canvas/primitive.ts"],
+  "sourcesContent": ["import {\n  definePrimitive,\n  resolveBox,\n  type PibblEventHandlers,\n  type PibblNode,\n  type ResolvedBoxStyle,\n  type SystemStyle,\n} from \"@pibbl/core\";\nimport {\n  pibblInternalPaintTarget,\n  useInternalValueMemoSlot,\n} from \"@pibbl/core/internal\";\nimport type {\n  PibblParticleCommonProps,\n  PibblParticleParameterValues,\n  Particles2DStyle,\n} from \"../types.js\";\nimport type { CanvasParticleExecutor } from \"./executor.js\";\n\nexport interface ParticleCanvasPrimitiveProps {\n  readonly executor: CanvasParticleExecutor;\n  readonly interaction: PibblParticleCommonProps<PibblParticleParameterValues>;\n}\n\nexport interface ResolvedParticles2DStyle\n  extends SystemStyle, ResolvedBoxStyle {\n  readonly opacity: number;\n  readonly overflow: \"visible\" | \"clip\";\n  readonly cursor?: string;\n}\n\nfunction renderParticleCanvas(\n  props: Readonly<ParticleCanvasPrimitiveProps>,\n  style: Readonly<ResolvedParticles2DStyle>,\n  context: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D,\n): PibblNode | void {\n  const { borderBox, contentBox } = style;\n  const targetPath = useInternalValueMemoSlot(\"particleTargetPath\", () => {\n    const path = new Path2D();\n    path.rect(borderBox.x, borderBox.y, borderBox.width, borderBox.height);\n    return path;\n  }, [borderBox.x, borderBox.y, borderBox.width, borderBox.height]);\n  const pointerEvents = props.interaction.pointerEvents ?? \"none\";\n  pibblInternalPaintTarget(\n    pointerEvents === \"auto\" ? (props.interaction as PibblEventHandlers) : {},\n    {\n      path: targetPath,\n      fill: true,\n      cursor: style.cursor,\n      keyboardFocusable: props.interaction.keyboardFocusable,\n      keyboardNavigationBounds:\n        props.interaction.keyboardNavigationBounds ?? borderBox,\n    },\n    pointerEvents,\n  );\n  props.executor.draw(context, contentBox, style.opacity, style.overflow);\n}\n\n/** The single private paint primitive returned by every Particles2D component. */\nexport const ParticleCanvasPrimitive = definePrimitive<\n  ParticleCanvasPrimitiveProps,\n  Particles2DStyle,\n  Particles2DStyle,\n  ResolvedParticles2DStyle\n>(renderParticleCanvas, {\n  resolveStyle(style, context) {\n    return {\n      ...resolveBox(style, context.constraints, {\n        component: \"Particles2D\",\n        algorithm: \"render-dispatch\",\n      }),\n      opacity: style.opacity ?? 1,\n      overflow: style.overflow ?? \"visible\",\n      cursor: style.cursor,\n    };\n  },\n  measure: () => ({\n    status: \"unsupported\",\n    reason: \"Particles2D has no intrinsic size\",\n  }),\n});\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAoBP,SAAS,qBACP,OACA,OACA,SACkB;AAClB,QAAM,EAAE,WAAW,WAAW,IAAI;AAClC,QAAM,aAAa,yBAAyB,sBAAsB,MAAM;AACtE,UAAM,OAAO,IAAI,OAAO;AACxB,SAAK,KAAK,UAAU,GAAG,UAAU,GAAG,UAAU,OAAO,UAAU,MAAM;AACrE,WAAO;AAAA,EACT,GAAG,CAAC,UAAU,GAAG,UAAU,GAAG,UAAU,OAAO,UAAU,MAAM,CAAC;AAChE,QAAM,gBAAgB,MAAM,YAAY,iBAAiB;AACzD;AAAA,IACE,kBAAkB,SAAU,MAAM,cAAqC,CAAC;AAAA,IACxE;AAAA,MACE,MAAM;AAAA,MACN,MAAM;AAAA,MACN,QAAQ,MAAM;AAAA,MACd,mBAAmB,MAAM,YAAY;AAAA,MACrC,0BACE,MAAM,YAAY,4BAA4B;AAAA,IAClD;AAAA,IACA;AAAA,EACF;AACA,QAAM,SAAS,KAAK,SAAS,YAAY,MAAM,SAAS,MAAM,QAAQ;AACxE;AAGO,MAAM,0BAA0B,gBAKrC,sBAAsB;AAAA,EACtB,aAAa,OAAO,SAAS;AAC3B,WAAO;AAAA,MACL,GAAG,WAAW,OAAO,QAAQ,aAAa;AAAA,QACxC,WAAW;AAAA,QACX,WAAW;AAAA,MACb,CAAC;AAAA,MACD,SAAS,MAAM,WAAW;AAAA,MAC1B,UAAU,MAAM,YAAY;AAAA,MAC5B,QAAQ,MAAM;AAAA,IAChB;AAAA,EACF;AAAA,EACA,SAAS,OAAO;AAAA,IACd,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV;AACF,CAAC;",
+  "names": []
+}

package/dist/features/particles/lib/canvas/raster-cache.d.ts

@@ -0,0 +1,13 @@
+export interface CanvasOwnedRaster {
+    close?(): void;
+}
+export interface CanvasRasterCache {
+    get<T extends CanvasOwnedRaster>(source: object, key: string | number, create: () => T): T;
+    find<T extends CanvasOwnedRaster>(source: object, key: string | number): T | undefined;
+    insert<T extends CanvasOwnedRaster>(source: object, key: string | number, raster: T): T;
+    sizeFor(source: object): number;
+    readonly totalSize: number;
+    dispose(): void;
+}
+/** A renderer-owned, deterministic LRU cache with an independent source budget. */
+export declare function createCanvasRasterCache(maximumEntriesPerSource?: number): CanvasRasterCache;

package/dist/features/particles/lib/canvas/raster-cache.js

@@ -0,0 +1,106 @@
+import { recordCanvasParticleRasterEntryCreated } from "../system/ownership.js";
+function createCanvasRasterCache(maximumEntriesPerSource = 16) {
+  if (!Number.isInteger(maximumEntriesPerSource) || maximumEntriesPerSource < 1) {
+    throw new RangeError(
+      "Pibbl Canvas particle raster cache size must be a positive integer."
+    );
+  }
+  let clock = 0;
+  let disposed = false;
+  let totalSize = 0;
+  const sources = /* @__PURE__ */ new WeakMap();
+  const ownedCaches = /* @__PURE__ */ new Set();
+  function requireCache(source) {
+    let cache = sources.get(source);
+    if (cache === void 0) {
+      cache = { entries: /* @__PURE__ */ new Map() };
+      sources.set(source, cache);
+      ownedCaches.add(cache);
+    }
+    return cache;
+  }
+  function close(raster) {
+    raster.close?.();
+  }
+  function find(source, key) {
+    if (disposed) {
+      throw new Error("Pibbl Canvas particle raster cache is disposed.");
+    }
+    const present = sources.get(source)?.entries.get(key);
+    if (present === void 0) return void 0;
+    present.lastUsed = ++clock;
+    return present.raster;
+  }
+  function insert(source, key, raster) {
+    if (disposed) {
+      throw new Error("Pibbl Canvas particle raster cache is disposed.");
+    }
+    const cache = requireCache(source);
+    const present = cache.entries.get(key);
+    if (present !== void 0) {
+      present.lastUsed = ++clock;
+      close(raster);
+      return present.raster;
+    }
+    cache.entries.set(key, {
+      raster,
+      releaseOwnership: recordCanvasParticleRasterEntryCreated(),
+      lastUsed: ++clock
+    });
+    totalSize += 1;
+    if (cache.entries.size > maximumEntriesPerSource) {
+      let oldestKey;
+      let oldestUse = Number.POSITIVE_INFINITY;
+      for (const [candidateKey, candidate] of cache.entries) {
+        if (candidate.lastUsed < oldestUse) {
+          oldestKey = candidateKey;
+          oldestUse = candidate.lastUsed;
+        }
+      }
+      if (oldestKey !== void 0) {
+        const evicted = cache.entries.get(oldestKey);
+        cache.entries.delete(oldestKey);
+        totalSize -= 1;
+        evicted.releaseOwnership();
+        close(evicted.raster);
+      }
+    }
+    return raster;
+  }
+  return {
+    get(source, key, create) {
+      return find(source, key) ?? insert(source, key, create());
+    },
+    find,
+    insert,
+    sizeFor(source) {
+      return sources.get(source)?.entries.size ?? 0;
+    },
+    get totalSize() {
+      return totalSize;
+    },
+    dispose() {
+      if (disposed) return;
+      disposed = true;
+      let firstError;
+      for (const cache of ownedCaches) {
+        for (const entry of cache.entries.values()) {
+          entry.releaseOwnership();
+          try {
+            close(entry.raster);
+          } catch (error) {
+            firstError ??= error;
+          }
+        }
+        cache.entries.clear();
+      }
+      ownedCaches.clear();
+      totalSize = 0;
+      if (firstError !== void 0) throw firstError;
+    }
+  };
+}
+export {
+  createCanvasRasterCache
+};
+//# sourceMappingURL=raster-cache.js.map

package/dist/features/particles/lib/canvas/raster-cache.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/features/particles/lib/canvas/raster-cache.ts"],
+  "sourcesContent": ["import { recordCanvasParticleRasterEntryCreated } from \"../system/ownership.js\";\n\nexport interface CanvasOwnedRaster {\n  close?(): void;\n}\n\nexport interface CanvasRasterCache {\n  get<T extends CanvasOwnedRaster>(\n    source: object,\n    key: string | number,\n    create: () => T,\n  ): T;\n  find<T extends CanvasOwnedRaster>(\n    source: object,\n    key: string | number,\n  ): T | undefined;\n  insert<T extends CanvasOwnedRaster>(\n    source: object,\n    key: string | number,\n    raster: T,\n  ): T;\n  sizeFor(source: object): number;\n  readonly totalSize: number;\n  dispose(): void;\n}\n\ninterface CacheEntry {\n  readonly raster: CanvasOwnedRaster;\n  readonly releaseOwnership: () => void;\n  lastUsed: number;\n}\n\ninterface SourceCache {\n  readonly entries: Map<string | number, CacheEntry>;\n}\n\n/** A renderer-owned, deterministic LRU cache with an independent source budget. */\nexport function createCanvasRasterCache(\n  maximumEntriesPerSource = 16,\n): CanvasRasterCache {\n  if (\n    !Number.isInteger(maximumEntriesPerSource) ||\n    maximumEntriesPerSource < 1\n  ) {\n    throw new RangeError(\n      \"Pibbl Canvas particle raster cache size must be a positive integer.\",\n    );\n  }\n\n  let clock = 0;\n  let disposed = false;\n  let totalSize = 0;\n  const sources = new WeakMap<object, SourceCache>();\n  const ownedCaches = new Set<SourceCache>();\n\n  function requireCache(source: object): SourceCache {\n    let cache = sources.get(source);\n    if (cache === undefined) {\n      cache = { entries: new Map() };\n      sources.set(source, cache);\n      ownedCaches.add(cache);\n    }\n    return cache;\n  }\n\n  function close(raster: CanvasOwnedRaster): void {\n    raster.close?.();\n  }\n\n  function find<T extends CanvasOwnedRaster>(\n    source: object,\n    key: string | number,\n  ): T | undefined {\n    if (disposed) {\n      throw new Error(\"Pibbl Canvas particle raster cache is disposed.\");\n    }\n    const present = sources.get(source)?.entries.get(key);\n    if (present === undefined) return undefined;\n    present.lastUsed = ++clock;\n    return present.raster as T;\n  }\n\n  function insert<T extends CanvasOwnedRaster>(\n    source: object,\n    key: string | number,\n    raster: T,\n  ): T {\n    if (disposed) {\n      throw new Error(\"Pibbl Canvas particle raster cache is disposed.\");\n    }\n    const cache = requireCache(source);\n    const present = cache.entries.get(key);\n    if (present !== undefined) {\n      present.lastUsed = ++clock;\n      close(raster);\n      return present.raster as T;\n    }\n    cache.entries.set(key, {\n      raster,\n      releaseOwnership: recordCanvasParticleRasterEntryCreated(),\n      lastUsed: ++clock,\n    });\n    totalSize += 1;\n\n    if (cache.entries.size > maximumEntriesPerSource) {\n      let oldestKey: string | number | undefined;\n      let oldestUse = Number.POSITIVE_INFINITY;\n      for (const [candidateKey, candidate] of cache.entries) {\n        if (candidate.lastUsed < oldestUse) {\n          oldestKey = candidateKey;\n          oldestUse = candidate.lastUsed;\n        }\n      }\n      if (oldestKey !== undefined) {\n        const evicted = cache.entries.get(oldestKey)!;\n        cache.entries.delete(oldestKey);\n        totalSize -= 1;\n        evicted.releaseOwnership();\n        close(evicted.raster);\n      }\n    }\n    return raster;\n  }\n\n  return {\n    get<T extends CanvasOwnedRaster>(\n      source: object,\n      key: string | number,\n      create: () => T,\n    ): T {\n      return find<T>(source, key) ?? insert(source, key, create());\n    },\n\n    find,\n\n    insert,\n\n    sizeFor(source: object): number {\n      return sources.get(source)?.entries.size ?? 0;\n    },\n\n    get totalSize(): number {\n      return totalSize;\n    },\n\n    dispose(): void {\n      if (disposed) return;\n      disposed = true;\n      let firstError: unknown;\n      for (const cache of ownedCaches) {\n        for (const entry of cache.entries.values()) {\n          entry.releaseOwnership();\n          try {\n            close(entry.raster);\n          } catch (error) {\n            firstError ??= error;\n          }\n        }\n        cache.entries.clear();\n      }\n      ownedCaches.clear();\n      totalSize = 0;\n      if (firstError !== undefined) throw firstError;\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,8CAA8C;AAqChD,SAAS,wBACd,0BAA0B,IACP;AACnB,MACE,CAAC,OAAO,UAAU,uBAAuB,KACzC,0BAA0B,GAC1B;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,MAAI,QAAQ;AACZ,MAAI,WAAW;AACf,MAAI,YAAY;AAChB,QAAM,UAAU,oBAAI,QAA6B;AACjD,QAAM,cAAc,oBAAI,IAAiB;AAEzC,WAAS,aAAa,QAA6B;AACjD,QAAI,QAAQ,QAAQ,IAAI,MAAM;AAC9B,QAAI,UAAU,QAAW;AACvB,cAAQ,EAAE,SAAS,oBAAI,IAAI,EAAE;AAC7B,cAAQ,IAAI,QAAQ,KAAK;AACzB,kBAAY,IAAI,KAAK;AAAA,IACvB;AACA,WAAO;AAAA,EACT;AAEA,WAAS,MAAM,QAAiC;AAC9C,WAAO,QAAQ;AAAA,EACjB;AAEA,WAAS,KACP,QACA,KACe;AACf,QAAI,UAAU;AACZ,YAAM,IAAI,MAAM,iDAAiD;AAAA,IACnE;AACA,UAAM,UAAU,QAAQ,IAAI,MAAM,GAAG,QAAQ,IAAI,GAAG;AACpD,QAAI,YAAY,OAAW,QAAO;AAClC,YAAQ,WAAW,EAAE;AACrB,WAAO,QAAQ;AAAA,EACjB;AAEA,WAAS,OACP,QACA,KACA,QACG;AACH,QAAI,UAAU;AACZ,YAAM,IAAI,MAAM,iDAAiD;AAAA,IACnE;AACA,UAAM,QAAQ,aAAa,MAAM;AACjC,UAAM,UAAU,MAAM,QAAQ,IAAI,GAAG;AACrC,QAAI,YAAY,QAAW;AACzB,cAAQ,WAAW,EAAE;AACrB,YAAM,MAAM;AACZ,aAAO,QAAQ;AAAA,IACjB;AACA,UAAM,QAAQ,IAAI,KAAK;AAAA,MACrB;AAAA,MACA,kBAAkB,uCAAuC;AAAA,MACzD,UAAU,EAAE;AAAA,IACd,CAAC;AACD,iBAAa;AAEb,QAAI,MAAM,QAAQ,OAAO,yBAAyB;AAChD,UAAI;AACJ,UAAI,YAAY,OAAO;AACvB,iBAAW,CAAC,cAAc,SAAS,KAAK,MAAM,SAAS;AACrD,YAAI,UAAU,WAAW,WAAW;AAClC,sBAAY;AACZ,sBAAY,UAAU;AAAA,QACxB;AAAA,MACF;AACA,UAAI,cAAc,QAAW;AAC3B,cAAM,UAAU,MAAM,QAAQ,IAAI,SAAS;AAC3C,cAAM,QAAQ,OAAO,SAAS;AAC9B,qBAAa;AACb,gBAAQ,iBAAiB;AACzB,cAAM,QAAQ,MAAM;AAAA,MACtB;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,IACE,QACA,KACA,QACG;AACH,aAAO,KAAQ,QAAQ,GAAG,KAAK,OAAO,QAAQ,KAAK,OAAO,CAAC;AAAA,IAC7D;AAAA,IAEA;AAAA,IAEA;AAAA,IAEA,QAAQ,QAAwB;AAC9B,aAAO,QAAQ,IAAI,MAAM,GAAG,QAAQ,QAAQ;AAAA,IAC9C;AAAA,IAEA,IAAI,YAAoB;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,UAAgB;AACd,UAAI,SAAU;AACd,iBAAW;AACX,UAAI;AACJ,iBAAW,SAAS,aAAa;AAC/B,mBAAW,SAAS,MAAM,QAAQ,OAAO,GAAG;AAC1C,gBAAM,iBAAiB;AACvB,cAAI;AACF,kBAAM,MAAM,MAAM;AAAA,UACpB,SAAS,OAAO;AACd,2BAAe;AAAA,UACjB;AAAA,QACF;AACA,cAAM,QAAQ,MAAM;AAAA,MACtB;AACA,kBAAY,MAAM;AAClB,kBAAY;AACZ,UAAI,eAAe,OAAW,OAAM;AAAA,IACtC;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,7 @@
+export type ParticleColor = readonly [
+    red: number,
+    green: number,
+    blue: number,
+    alpha: number
+];
+export declare function parseParticleColor(source: string): ParticleColor;

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

@@ -0,0 +1,159 @@
+const namedColorHex = /* @__PURE__ */ new Map();
+for (const entry of "aliceblue:f0f8ff,antiquewhite:faebd7,aqua:00ffff,aquamarine:7fffd4,azure:f0ffff,beige:f5f5dc,bisque:ffe4c4,black:000000,blanchedalmond:ffebcd,blue:0000ff,blueviolet:8a2be2,brown:a52a2a,burlywood:deb887,cadetblue:5f9ea0,chartreuse:7fff00,chocolate:d2691e,coral:ff7f50,cornflowerblue:6495ed,cornsilk:fff8dc,crimson:dc143c,cyan:00ffff,darkblue:00008b,darkcyan:008b8b,darkgoldenrod:b8860b,darkgray:a9a9a9,darkgreen:006400,darkgrey:a9a9a9,darkkhaki:bdb76b,darkmagenta:8b008b,darkolivegreen:556b2f,darkorange:ff8c00,darkorchid:9932cc,darkred:8b0000,darksalmon:e9967a,darkseagreen:8fbc8f,darkslateblue:483d8b,darkslategray:2f4f4f,darkslategrey:2f4f4f,darkturquoise:00ced1,darkviolet:9400d3,deeppink:ff1493,deepskyblue:00bfff,dimgray:696969,dimgrey:696969,dodgerblue:1e90ff,firebrick:b22222,floralwhite:fffaf0,forestgreen:228b22,fuchsia:ff00ff,gainsboro:dcdcdc,ghostwhite:f8f8ff,gold:ffd700,goldenrod:daa520,gray:808080,green:008000,greenyellow:adff2f,grey:808080,honeydew:f0fff0,hotpink:ff69b4,indianred:cd5c5c,indigo:4b0082,ivory:fffff0,khaki:f0e68c,lavender:e6e6fa,lavenderblush:fff0f5,lawngreen:7cfc00,lemonchiffon:fffacd,lightblue:add8e6,lightcoral:f08080,lightcyan:e0ffff,lightgoldenrodyellow:fafad2,lightgray:d3d3d3,lightgreen:90ee90,lightgrey:d3d3d3,lightpink:ffb6c1,lightsalmon:ffa07a,lightseagreen:20b2aa,lightskyblue:87cefa,lightslategray:778899,lightslategrey:778899,lightsteelblue:b0c4de,lightyellow:ffffe0,lime:00ff00,limegreen:32cd32,linen:faf0e6,magenta:ff00ff,maroon:800000,mediumaquamarine:66cdaa,mediumblue:0000cd,mediumorchid:ba55d3,mediumpurple:9370db,mediumseagreen:3cb371,mediumslateblue:7b68ee,mediumspringgreen:00fa9a,mediumturquoise:48d1cc,mediumvioletred:c71585,midnightblue:191970,mintcream:f5fffa,mistyrose:ffe4e1,moccasin:ffe4b5,navajowhite:ffdead,navy:000080,oldlace:fdf5e6,olive:808000,olivedrab:6b8e23,orange:ffa500,orangered:ff4500,orchid:da70d6,palegoldenrod:eee8aa,palegreen:98fb98,paleturquoise:afeeee,palevioletred:db7093,papayawhip:ffefd5,peachpuff:ffdab9,peru:cd853f,pink:ffc0cb,plum:dda0dd,powderblue:b0e0e6,purple:800080,rebeccapurple:663399,red:ff0000,rosybrown:bc8f8f,royalblue:4169e1,saddlebrown:8b4513,salmon:fa8072,sandybrown:f4a460,seagreen:2e8b57,seashell:fff5ee,sienna:a0522d,silver:c0c0c0,skyblue:87ceeb,slateblue:6a5acd,slategray:708090,slategrey:708090,snow:fffafa,springgreen:00ff7f,steelblue:4682b4,tan:d2b48c,teal:008080,thistle:d8bfd8,tomato:ff6347,turquoise:40e0d0,violet:ee82ee,wheat:f5deb3,white:ffffff,whitesmoke:f5f5f5,yellow:ffff00,yellowgreen:9acd32".split(",")) {
+  const separator = entry.indexOf(":");
+  namedColorHex.set(entry.slice(0, separator), entry.slice(separator + 1));
+}
+const colorCache = /* @__PURE__ */ new Map();
+function clampUnit(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function parseNumericToken(token) {
+  if (!/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(token)) {
+    return void 0;
+  }
+  const value = Number(token);
+  return Number.isFinite(value) ? value : void 0;
+}
+function parseAlpha(token) {
+  const percentage = token.endsWith("%");
+  const value = parseNumericToken(percentage ? token.slice(0, -1) : token);
+  return value === void 0 ? void 0 : clampUnit(percentage ? value / 100 : value);
+}
+function parseRGBChannel(token) {
+  const percentage = token.endsWith("%");
+  const value = parseNumericToken(percentage ? token.slice(0, -1) : token);
+  return value === void 0 ? void 0 : clampUnit(percentage ? value / 100 : value / 255);
+}
+function parseHue(token) {
+  let numeric;
+  let scale = 1;
+  if (token.endsWith("deg")) numeric = parseNumericToken(token.slice(0, -3));
+  else if (token.endsWith("grad")) {
+    numeric = parseNumericToken(token.slice(0, -4));
+    scale = 0.9;
+  } else if (token.endsWith("rad")) {
+    numeric = parseNumericToken(token.slice(0, -3));
+    scale = 180 / Math.PI;
+  } else if (token.endsWith("turn")) {
+    numeric = parseNumericToken(token.slice(0, -4));
+    scale = 360;
+  } else numeric = parseNumericToken(token);
+  if (numeric === void 0) return void 0;
+  const degrees = numeric * scale;
+  return (degrees % 360 + 360) % 360 / 360;
+}
+function parsePercentage(token) {
+  if (!token.endsWith("%")) return void 0;
+  const value = parseNumericToken(token.slice(0, -1));
+  return value === void 0 ? void 0 : clampUnit(value / 100);
+}
+function hueToRGB(p, q, hue) {
+  if (hue < 0) hue += 1;
+  if (hue > 1) hue -= 1;
+  if (hue < 1 / 6) return p + (q - p) * 6 * hue;
+  if (hue < 1 / 2) return q;
+  if (hue < 2 / 3) return p + (q - p) * (2 / 3 - hue) * 6;
+  return p;
+}
+function parseHex(source) {
+  const match = /^#([\da-f]{3}|[\da-f]{4}|[\da-f]{6}|[\da-f]{8})$/i.exec(
+    source
+  );
+  if (match === null) return void 0;
+  const value = match[1];
+  const expanded = value.length <= 4 ? [...value].map((character) => character + character).join("") : value;
+  const withAlpha = expanded.length === 6 ? `${expanded}ff` : expanded;
+  return Object.freeze([
+    Number.parseInt(withAlpha.slice(0, 2), 16) / 255,
+    Number.parseInt(withAlpha.slice(2, 4), 16) / 255,
+    Number.parseInt(withAlpha.slice(4, 6), 16) / 255,
+    Number.parseInt(withAlpha.slice(6, 8), 16) / 255
+  ]);
+}
+function splitFunctionalBody(body) {
+  if (body.includes(",")) {
+    if (body.includes("/")) return void 0;
+    const tokens = body.split(",").map((token) => token.trim());
+    if (tokens.length !== 3 && tokens.length !== 4 || tokens.some((token) => token.length === 0)) {
+      return void 0;
+    }
+    return {
+      syntax: "legacy",
+      channels: [tokens[0], tokens[1], tokens[2]],
+      alpha: tokens[3]
+    };
+  }
+  const slashParts = body.split("/");
+  if (slashParts.length > 2) return void 0;
+  const channelSource = slashParts[0].trim();
+  if (channelSource.length === 0) return void 0;
+  const channels = channelSource.split(/\s+/);
+  if (channels.length !== 3) return void 0;
+  const alpha = slashParts.length === 2 ? slashParts[1].trim() : void 0;
+  if (alpha !== void 0 && alpha.length === 0) return void 0;
+  return {
+    syntax: "modern",
+    channels: [channels[0], channels[1], channels[2]],
+    alpha
+  };
+}
+function parseRGB(source) {
+  const match = /^rgba?\((.*)\)$/.exec(source);
+  if (match === null) return void 0;
+  const body = splitFunctionalBody(match[1]);
+  if (body === void 0) return void 0;
+  const red = parseRGBChannel(body.channels[0]);
+  const green = parseRGBChannel(body.channels[1]);
+  const blue = parseRGBChannel(body.channels[2]);
+  const alpha = body.alpha === void 0 ? 1 : parseAlpha(body.alpha);
+  if (red === void 0 || green === void 0 || blue === void 0 || alpha === void 0) {
+    return void 0;
+  }
+  return Object.freeze([red, green, blue, alpha]);
+}
+function parseHSL(source) {
+  const match = /^hsla?\((.*)\)$/.exec(source);
+  if (match === null) return void 0;
+  const body = splitFunctionalBody(match[1]);
+  if (body === void 0) return void 0;
+  const hue = parseHue(body.channels[0]);
+  const saturation = parsePercentage(body.channels[1]);
+  const lightness = parsePercentage(body.channels[2]);
+  const alpha = body.alpha === void 0 ? 1 : parseAlpha(body.alpha);
+  if (hue === void 0 || saturation === void 0 || lightness === void 0 || alpha === void 0) {
+    return void 0;
+  }
+  if (saturation === 0) {
+    return Object.freeze([lightness, lightness, lightness, alpha]);
+  }
+  const q = lightness < 0.5 ? lightness * (1 + saturation) : lightness + saturation - lightness * saturation;
+  const p = 2 * lightness - q;
+  return Object.freeze([
+    hueToRGB(p, q, hue + 1 / 3),
+    hueToRGB(p, q, hue),
+    hueToRGB(p, q, hue - 1 / 3),
+    alpha
+  ]);
+}
+function parseParticleColor(source) {
+  const canonical = source.trim().toLowerCase();
+  const cached = colorCache.get(canonical);
+  if (cached !== void 0) return cached;
+  let color;
+  if (canonical === "transparent") color = Object.freeze([0, 0, 0, 0]);
+  else {
+    const named = namedColorHex.get(canonical);
+    color = parseHex(named === void 0 ? canonical : `#${named}`) ?? parseRGB(canonical) ?? parseHSL(canonical);
+  }
+  if (color === void 0) {
+    throw new TypeError(
+      `Particle color uses unsupported syntax; received "${source}".`
+    );
+  }
+  colorCache.set(canonical, color);
+  return color;
+}
+export {
+  parseParticleColor
+};
+//# sourceMappingURL=color.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/features/particles/lib/color.ts"],
+  "sourcesContent": ["export type ParticleColor = readonly [\n  red: number,\n  green: number,\n  blue: number,\n  alpha: number,\n];\n\nconst namedColorHex = new Map<string, string>();\nfor (const entry of (\n  \"aliceblue:f0f8ff,antiquewhite:faebd7,aqua:00ffff,aquamarine:7fffd4,\" +\n  \"azure:f0ffff,beige:f5f5dc,bisque:ffe4c4,black:000000,\" +\n  \"blanchedalmond:ffebcd,blue:0000ff,blueviolet:8a2be2,brown:a52a2a,\" +\n  \"burlywood:deb887,cadetblue:5f9ea0,chartreuse:7fff00,chocolate:d2691e,\" +\n  \"coral:ff7f50,cornflowerblue:6495ed,cornsilk:fff8dc,crimson:dc143c,\" +\n  \"cyan:00ffff,darkblue:00008b,darkcyan:008b8b,darkgoldenrod:b8860b,\" +\n  \"darkgray:a9a9a9,darkgreen:006400,darkgrey:a9a9a9,darkkhaki:bdb76b,\" +\n  \"darkmagenta:8b008b,darkolivegreen:556b2f,darkorange:ff8c00,\" +\n  \"darkorchid:9932cc,darkred:8b0000,darksalmon:e9967a,\" +\n  \"darkseagreen:8fbc8f,darkslateblue:483d8b,darkslategray:2f4f4f,\" +\n  \"darkslategrey:2f4f4f,darkturquoise:00ced1,darkviolet:9400d3,\" +\n  \"deeppink:ff1493,deepskyblue:00bfff,dimgray:696969,dimgrey:696969,\" +\n  \"dodgerblue:1e90ff,firebrick:b22222,floralwhite:fffaf0,\" +\n  \"forestgreen:228b22,fuchsia:ff00ff,gainsboro:dcdcdc,ghostwhite:f8f8ff,\" +\n  \"gold:ffd700,goldenrod:daa520,gray:808080,green:008000,\" +\n  \"greenyellow:adff2f,grey:808080,honeydew:f0fff0,hotpink:ff69b4,\" +\n  \"indianred:cd5c5c,indigo:4b0082,ivory:fffff0,khaki:f0e68c,\" +\n  \"lavender:e6e6fa,lavenderblush:fff0f5,lawngreen:7cfc00,\" +\n  \"lemonchiffon:fffacd,lightblue:add8e6,lightcoral:f08080,\" +\n  \"lightcyan:e0ffff,lightgoldenrodyellow:fafad2,lightgray:d3d3d3,\" +\n  \"lightgreen:90ee90,lightgrey:d3d3d3,lightpink:ffb6c1,\" +\n  \"lightsalmon:ffa07a,lightseagreen:20b2aa,lightskyblue:87cefa,\" +\n  \"lightslategray:778899,lightslategrey:778899,lightsteelblue:b0c4de,\" +\n  \"lightyellow:ffffe0,lime:00ff00,limegreen:32cd32,linen:faf0e6,\" +\n  \"magenta:ff00ff,maroon:800000,mediumaquamarine:66cdaa,\" +\n  \"mediumblue:0000cd,mediumorchid:ba55d3,mediumpurple:9370db,\" +\n  \"mediumseagreen:3cb371,mediumslateblue:7b68ee,\" +\n  \"mediumspringgreen:00fa9a,mediumturquoise:48d1cc,\" +\n  \"mediumvioletred:c71585,midnightblue:191970,mintcream:f5fffa,\" +\n  \"mistyrose:ffe4e1,moccasin:ffe4b5,navajowhite:ffdead,navy:000080,\" +\n  \"oldlace:fdf5e6,olive:808000,olivedrab:6b8e23,orange:ffa500,\" +\n  \"orangered:ff4500,orchid:da70d6,palegoldenrod:eee8aa,\" +\n  \"palegreen:98fb98,paleturquoise:afeeee,palevioletred:db7093,\" +\n  \"papayawhip:ffefd5,peachpuff:ffdab9,peru:cd853f,pink:ffc0cb,\" +\n  \"plum:dda0dd,powderblue:b0e0e6,purple:800080,\" +\n  \"rebeccapurple:663399,red:ff0000,rosybrown:bc8f8f,\" +\n  \"royalblue:4169e1,saddlebrown:8b4513,salmon:fa8072,\" +\n  \"sandybrown:f4a460,seagreen:2e8b57,seashell:fff5ee,sienna:a0522d,\" +\n  \"silver:c0c0c0,skyblue:87ceeb,slateblue:6a5acd,slategray:708090,\" +\n  \"slategrey:708090,snow:fffafa,springgreen:00ff7f,\" +\n  \"steelblue:4682b4,tan:d2b48c,teal:008080,thistle:d8bfd8,\" +\n  \"tomato:ff6347,turquoise:40e0d0,violet:ee82ee,wheat:f5deb3,\" +\n  \"white:ffffff,whitesmoke:f5f5f5,yellow:ffff00,yellowgreen:9acd32\"\n).split(\",\")) {\n  const separator = entry.indexOf(\":\");\n  namedColorHex.set(entry.slice(0, separator), entry.slice(separator + 1));\n}\n\nconst colorCache = new Map<string, ParticleColor>();\n\nfunction clampUnit(value: number): number {\n  return Math.min(1, Math.max(0, value));\n}\n\nfunction parseNumericToken(token: string): number | undefined {\n  if (!/^[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:e[+-]?\\d+)?$/i.test(token)) {\n    return undefined;\n  }\n  const value = Number(token);\n  return Number.isFinite(value) ? value : undefined;\n}\n\nfunction parseAlpha(token: string): number | undefined {\n  const percentage = token.endsWith(\"%\");\n  const value = parseNumericToken(percentage ? token.slice(0, -1) : token);\n  return value === undefined\n    ? undefined\n    : clampUnit(percentage ? value / 100 : value);\n}\n\nfunction parseRGBChannel(token: string): number | undefined {\n  const percentage = token.endsWith(\"%\");\n  const value = parseNumericToken(percentage ? token.slice(0, -1) : token);\n  return value === undefined\n    ? undefined\n    : clampUnit(percentage ? value / 100 : value / 255);\n}\n\nfunction parseHue(token: string): number | undefined {\n  let numeric: number | undefined;\n  let scale = 1;\n  if (token.endsWith(\"deg\")) numeric = parseNumericToken(token.slice(0, -3));\n  else if (token.endsWith(\"grad\")) {\n    numeric = parseNumericToken(token.slice(0, -4));\n    scale = 0.9;\n  } else if (token.endsWith(\"rad\")) {\n    numeric = parseNumericToken(token.slice(0, -3));\n    scale = 180 / Math.PI;\n  } else if (token.endsWith(\"turn\")) {\n    numeric = parseNumericToken(token.slice(0, -4));\n    scale = 360;\n  } else numeric = parseNumericToken(token);\n  if (numeric === undefined) return undefined;\n  const degrees = numeric * scale;\n  return (((degrees % 360) + 360) % 360) / 360;\n}\n\nfunction parsePercentage(token: string): number | undefined {\n  if (!token.endsWith(\"%\")) return undefined;\n  const value = parseNumericToken(token.slice(0, -1));\n  return value === undefined ? undefined : clampUnit(value / 100);\n}\n\nfunction hueToRGB(p: number, q: number, hue: number): number {\n  if (hue < 0) hue += 1;\n  if (hue > 1) hue -= 1;\n  if (hue < 1 / 6) return p + (q - p) * 6 * hue;\n  if (hue < 1 / 2) return q;\n  if (hue < 2 / 3) return p + (q - p) * (2 / 3 - hue) * 6;\n  return p;\n}\n\nfunction parseHex(source: string): ParticleColor | undefined {\n  const match = /^#([\\da-f]{3}|[\\da-f]{4}|[\\da-f]{6}|[\\da-f]{8})$/i.exec(\n    source,\n  );\n  if (match === null) return undefined;\n  const value = match[1]!;\n  const expanded =\n    value.length <= 4\n      ? [...value].map((character) => character + character).join(\"\")\n      : value;\n  const withAlpha = expanded.length === 6 ? `${expanded}ff` : expanded;\n  return Object.freeze([\n    Number.parseInt(withAlpha.slice(0, 2), 16) / 255,\n    Number.parseInt(withAlpha.slice(2, 4), 16) / 255,\n    Number.parseInt(withAlpha.slice(4, 6), 16) / 255,\n    Number.parseInt(withAlpha.slice(6, 8), 16) / 255,\n  ]);\n}\n\ninterface FunctionalColorBody {\n  readonly syntax: \"legacy\" | \"modern\";\n  readonly channels: readonly [string, string, string];\n  readonly alpha: string | undefined;\n}\n\nfunction splitFunctionalBody(body: string): FunctionalColorBody | undefined {\n  if (body.includes(\",\")) {\n    if (body.includes(\"/\")) return undefined;\n    const tokens = body.split(\",\").map((token) => token.trim());\n    if (\n      (tokens.length !== 3 && tokens.length !== 4) ||\n      tokens.some((token) => token.length === 0)\n    ) {\n      return undefined;\n    }\n    return {\n      syntax: \"legacy\",\n      channels: [tokens[0]!, tokens[1]!, tokens[2]!],\n      alpha: tokens[3],\n    };\n  }\n\n  const slashParts = body.split(\"/\");\n  if (slashParts.length > 2) return undefined;\n  const channelSource = slashParts[0]!.trim();\n  if (channelSource.length === 0) return undefined;\n  const channels = channelSource.split(/\\s+/);\n  if (channels.length !== 3) return undefined;\n  const alpha = slashParts.length === 2 ? slashParts[1]!.trim() : undefined;\n  if (alpha !== undefined && alpha.length === 0) return undefined;\n  return {\n    syntax: \"modern\",\n    channels: [channels[0]!, channels[1]!, channels[2]!],\n    alpha,\n  };\n}\n\nfunction parseRGB(source: string): ParticleColor | undefined {\n  const match = /^rgba?\\((.*)\\)$/.exec(source);\n  if (match === null) return undefined;\n  const body = splitFunctionalBody(match[1]!);\n  if (body === undefined) return undefined;\n  const red = parseRGBChannel(body.channels[0]);\n  const green = parseRGBChannel(body.channels[1]);\n  const blue = parseRGBChannel(body.channels[2]);\n  const alpha = body.alpha === undefined ? 1 : parseAlpha(body.alpha);\n  if (\n    red === undefined ||\n    green === undefined ||\n    blue === undefined ||\n    alpha === undefined\n  ) {\n    return undefined;\n  }\n  return Object.freeze([red, green, blue, alpha]);\n}\n\nfunction parseHSL(source: string): ParticleColor | undefined {\n  const match = /^hsla?\\((.*)\\)$/.exec(source);\n  if (match === null) return undefined;\n  const body = splitFunctionalBody(match[1]!);\n  if (body === undefined) return undefined;\n  const hue = parseHue(body.channels[0]);\n  const saturation = parsePercentage(body.channels[1]);\n  const lightness = parsePercentage(body.channels[2]);\n  const alpha = body.alpha === undefined ? 1 : parseAlpha(body.alpha);\n  if (\n    hue === undefined ||\n    saturation === undefined ||\n    lightness === undefined ||\n    alpha === undefined\n  ) {\n    return undefined;\n  }\n  if (saturation === 0) {\n    return Object.freeze([lightness, lightness, lightness, alpha]);\n  }\n  const q =\n    lightness < 0.5\n      ? lightness * (1 + saturation)\n      : lightness + saturation - lightness * saturation;\n  const p = 2 * lightness - q;\n  return Object.freeze([\n    hueToRGB(p, q, hue + 1 / 3),\n    hueToRGB(p, q, hue),\n    hueToRGB(p, q, hue - 1 / 3),\n    alpha,\n  ]);\n}\n\nexport function parseParticleColor(source: string): ParticleColor {\n  const canonical = source.trim().toLowerCase();\n  const cached = colorCache.get(canonical);\n  if (cached !== undefined) return cached;\n\n  let color: ParticleColor | undefined;\n  if (canonical === \"transparent\") color = Object.freeze([0, 0, 0, 0]);\n  else {\n    const named = namedColorHex.get(canonical);\n    color =\n      parseHex(named === undefined ? canonical : `#${named}`) ??\n      parseRGB(canonical) ??\n      parseHSL(canonical);\n  }\n  if (color === undefined) {\n    throw new TypeError(\n      `Particle color uses unsupported syntax; received \"${source}\".`,\n    );\n  }\n  colorCache.set(canonical, color);\n  return color;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,134 @@
+import { type ParticleColor } from "./color.js";
+import { type CompiledParticleCurve, type CompiledParticleGradient } from "./curve.js";
+import { type ParticleEmitter2DRecord } from "./definition-records.js";
+import { type CompiledEmissionSchedule, type CompiledMaximumLifetime } from "./emission.js";
+import { type CompiledWeightedChoice } from "./random.js";
+import type { PibblParticleEffect2D, PibblParticleParameterDefinition, PibblParticleParameterReference, PibblParticleShape2D } from "./types.js";
+export declare const ParameterTimingMask: Readonly<{
+    readonly Spawn: 1;
+    readonly Simulation: 2;
+    readonly Render: 4;
+}>;
+export type ParameterTimingMaskValue = (typeof ParameterTimingMask)[keyof typeof ParameterTimingMask];
+export interface CompiledParameterEntry {
+    readonly name: string;
+    readonly type: PibblParticleParameterDefinition["type"];
+    readonly timing: PibblParticleParameterDefinition["timing"];
+    readonly offset: number;
+    readonly length: 1 | 2 | 4;
+}
+export interface CompiledParameterLayout {
+    readonly entries: readonly CompiledParameterEntry[];
+    readonly defaults: Readonly<Float64Array>;
+    readonly spawnMask: Readonly<Uint8Array>;
+    readonly simulationMask: Readonly<Uint8Array>;
+    readonly renderMask: Readonly<Uint8Array>;
+    readonly byName: ReadonlyMap<string, CompiledParameterEntry>;
+}
+export interface CompiledParameterReference<Length extends 1 | 2 | 4 = 1 | 2 | 4> {
+    readonly kind: "parameter";
+    readonly offset: number;
+    readonly length: Length;
+    readonly timingMask: ParameterTimingMaskValue;
+    readonly channel: number;
+}
+export type CompiledScalar = Readonly<{
+    kind: "constant";
+    value: number;
+    channel: number;
+}> | Readonly<{
+    kind: "between";
+    min: number;
+    max: number;
+    channel: number;
+}> | Readonly<{
+    kind: "integer";
+    min: number;
+    max: number;
+    channel: number;
+}> | Readonly<{
+    kind: "choice";
+    choice: CompiledWeightedChoice<number>;
+    channel: number;
+}> | CompiledParameterReference<1>;
+export type CompiledVector2 = readonly [CompiledScalar, CompiledScalar] | CompiledParameterReference<2>;
+export type CompiledColor = Readonly<{
+    kind: "constant";
+    color: ParticleColor;
+    channel: number;
+}> | Readonly<{
+    kind: "choice";
+    samples: readonly ParticleColor[];
+    cumulativeWeights: readonly number[];
+    totalWeight: number;
+    channel: number;
+}> | CompiledParameterReference<4>;
+export interface CompiledAppearance {
+    readonly size: CompiledParticleCurve | null;
+    readonly rotation: CompiledParticleCurve | null;
+    readonly color: CompiledParticleGradient | null;
+    readonly opacity: CompiledParticleCurve | null;
+}
+export interface CompiledInitial2D {
+    readonly lifetime: CompiledScalar;
+    readonly velocity: CompiledVector2;
+    readonly size: CompiledVector2;
+    readonly rotation: CompiledScalar;
+    readonly angularVelocity: CompiledScalar;
+    readonly color: CompiledColor;
+    readonly opacity: CompiledScalar;
+}
+export type CompiledMotion2D = Readonly<{
+    type: "acceleration" | "gravity" | "drift";
+    value: CompiledVector2;
+}> | Readonly<{
+    type: "drag";
+    amount: CompiledScalar;
+}> | Readonly<{
+    type: "radialAcceleration";
+    center: readonly [number, number];
+    amount: CompiledScalar;
+}> | Readonly<{
+    type: "orbit";
+    center: readonly [number, number];
+    degreesPerSecond: CompiledScalar;
+}> | Readonly<{
+    type: "sway";
+    amplitude: CompiledScalar;
+    frequency: CompiledScalar;
+}> | Readonly<{
+    type: "angularVelocity";
+    degreesPerSecond: CompiledScalar;
+}>;
+export interface CompiledEmitter2D {
+    readonly dimension: 2;
+    readonly name: string;
+    readonly emitterHash: number;
+    readonly capacity: number;
+    readonly overflow: "reject-newest" | "recycle-oldest";
+    readonly shape: PibblParticleShape2D;
+    readonly shapeChannels: readonly [number, number, number];
+    readonly initial: CompiledInitial2D;
+    readonly motion: readonly CompiledMotion2D[];
+    readonly appearance: CompiledAppearance;
+    readonly emission: CompiledEmissionSchedule;
+    readonly maximumLifetime: CompiledMaximumLifetime;
+    readonly renderer: ParticleEmitter2DRecord["renderer"];
+    readonly bounds: ParticleEmitter2DRecord["bounds"];
+}
+export interface CompiledExecutionCapability {
+    readonly supported: boolean;
+    readonly reasons: readonly string[];
+}
+export interface CompiledExecutionCapabilities {
+    readonly "stateless-canvas": CompiledExecutionCapability;
+    readonly "flow-canvas": CompiledExecutionCapability;
+}
+export interface CompiledEffect2D {
+    readonly dimension: 2;
+    readonly parameterLayout: CompiledParameterLayout;
+    readonly emitters: readonly CompiledEmitter2D[];
+    readonly execution: CompiledExecutionCapabilities;
+}
+export declare function compileParameterReference<Length extends 1 | 2 | 4>(reference: PibblParticleParameterReference<string>, layout: CompiledParameterLayout, expectedDimension: Length, path: string): CompiledParameterReference<Length>;
+export declare function compileParticleEffect2D(effect: PibblParticleEffect2D): CompiledEffect2D;