micro-canvas-confetti-native 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moshe Hatab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,142 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# micro-canvas-confetti-native
+
+Confetti and coin bursts for React Native. Same presets and physics as [`micro-canvas-confetti-physics`](https://www.npmjs.com/package/micro-canvas-confetti-physics), plus image coins and a **collect** flight that starts big and shrinks into a label or box.
+
+Drawn with `View` and `Image` only. Peers are `react` and `react-native`. No Skia, no Reanimated, no extra native module.
+
+## Install
+
+```sh
+npm install micro-canvas-confetti-native
+```
+
+Mount one overlay at the root. It does not take touches.
+
+```tsx
+import { ParticleHost } from "micro-canvas-confetti-native";
+import { View } from "react-native";
+
+export function Root() {
+  return (
+    <View style={{ flex: 1 }}>
+      <App />
+      <ParticleHost />
+    </View>
+  );
+}
+```
+
+## Quick start
+
+```tsx
+import { confetti, measureCenter } from "micro-canvas-confetti-native";
+import { Circle, Svg } from "react-native-svg";
+
+confetti();
+confetti({ preset: "cannon", origin: { x: 180, y: 640 } });
+
+// coinType omitted → h-keystone. Or pass your own PNG / SVG node.
+confetti({ appearance: "coin", particleCount: 12, origin: { x: 200, y: 400 } });
+confetti({
+  appearance: "coin",
+  particleCount: 12,
+  coinSource: require("./coins/guess-and-draw.png"),
+});
+confetti({
+  appearance: "coin",
+  particleCount: 8,
+  renderCoin: () => (
+    <Svg width="100%" height="100%" viewBox="0 0 32 32">
+      <Circle cx="16" cy="16" r="14" fill="#f5b301" />
+    </Svg>
+  ),
+});
+
+await confetti.collect({
+  appearance: "coin",
+  coinSource: require("./coins/stellar-gateway.png"),
+  origin: { x: screenW / 2, y: screenH / 2 },
+  target: await measureCenter(coinsLabelRef),
+  particleCount: 8,
+  onArrive: () => addCoin(),
+});
+```
+
+`collect` flies pieces from `origin` to `target`. They start about 2.4× size, follow a short arc, and shrink to about 0.2× as they land. `target` is window coordinates. `measureCenter(ref)` reads a view with `measureInWindow` and returns its center. Pass `trackTarget: () => latestCenter` when that view can move, for example while the screen scrolls.
+
+Calls made before `ParticleHost` mounts are queued.
+
+## Coins
+
+The library ships one built-in, `h-keystone` (`DEFAULT_COIN_TYPE`). Pass your own art per burst:
+
+| Input | Use |
+| --- | --- |
+| `coinType` | Omit it, or `"h-keystone"` |
+| `coinSource` | A PNG or WebP. Anything `<Image source>` accepts: `require("./coin.png")` or `{ uri }` |
+| `renderCoin` | `(index) => ReactElement`. An SVG from `react-native-svg`, or any view you already render. This package does not parse SVG files |
+
+`renderCoin` wins over `coinSource`, which wins over `coinType`. The node should fill the piece (`width` and `height` `"100%"`). The host moves one wrapper view per coin.
+
+A shared PNG is decoded once. An SVG (or any custom tree) is copied once per coin, so keep that burst smaller when the graphic is heavy.
+
+### Artwork that reads well
+
+- PNG-24 or WebP, transparent, sRGB, square **256×256**
+- Disc centered with about **8%** padding so rotation does not clip the edge
+- Still readable at **~32dp** (the shrunk end) and **~96dp** (the big start)
+
+## API
+
+| Option | Burst default | Notes |
+| --- | --- | --- |
+| `appearance` | `"confetti"` | `"coin"` draws the coin image |
+| `coinType` | `"h-keystone"` | Built-in coin. Ignored when `coinSource` or `renderCoin` is set |
+| `coinSource` | — | Your PNG or WebP. Overrides `coinType` |
+| `renderCoin` | — | `(index) => node`. Your SVG or view. Overrides `coinSource` |
+| `particleCount` | 60 confetti / 12 coins | You choose the count. Each piece is a view, so a higher count costs more. Safety cap: **300** confetti and **150** coins. A higher request is clamped, and the library warns. |
+| `origin` | center of the host | Window coordinates |
+| `preset` | — | `celebration`, `subtle`, `cannon`, `spark` |
+| `angle` | `270` | Degrees, up |
+| `spread` | `45` | Cone in degrees |
+| `startVelocity` | `45` | |
+| `gravity` | `1.2` | |
+| `drag` | `0.08` | |
+| `duration` | `"normal"` | `short` \| `normal` \| `long` |
+| `scalar` | `1` | Size, `0.2`–`3` |
+| `burstRadius` | `0` | Max distance from origin. `0` = no limit |
+| `colors` / `shapes` | festive palette, rect + circle | Confetti only |
+| `disableForReducedMotion` | `true` | No-op when the OS reduce-motion setting is on |
+
+Collect-only: `target` (required), `flightMs` (900), `staggerMs` (60), `onArrive(index, total)`.
+
+- `confetti(options?)` → `{ reset, isActive }`
+- `confetti.promise(options?)` → resolves when that burst is gone
+- `confetti.collect(options)` → resolves when every piece has landed
+- `confettiSequence(steps)` (alias `sequence`) → `{ cancel, promise }`
+- `reset()` — clear the screen
+- `getActiveParticleCount()`
+- `measureCenter(ref)` → `Promise<{ x, y }>`
+
+## What stays on the web package
+
+Canvas snapshot, motion trails, and the velocity heatmap. Those need a canvas. This package draws each piece as a view, so `particleCount` is yours up to the safety cap (300 confetti, 150 coins).
+
+## Demo
+
+```sh
+cd example
+npm install
+npm run start
+```
+
+## Development
+
+```sh
+npm test
+npm run lint
+npm run typecheck
+npm run build
+```
+
+MIT © Moshe Hatab

package/lib/commonjs/api.js

@@ -0,0 +1,83 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.collect = collect;
+exports.engine = exports.confettiSequence = exports.confetti = void 0;
+exports.getActiveParticleCount = getActiveParticleCount;
+exports.measureCenter = measureCenter;
+exports.reset = reset;
+var _engine = require("./engine.js");
+var _sequence = require("./sequence.js");
+/** Shared store the `ParticleHost` draws. One per app. */
+const engine = exports.engine = new _engine.ParticleEngine();
+
+/** Stops every burst and flight, clears the screen, and resolves pending promises. */
+function reset() {
+  engine.reset();
+}
+function launchBurst(options) {
+  const {
+    batch,
+    promise
+  } = (0, _engine.createBatch)();
+  engine.burst(options, batch);
+  return {
+    handle: {
+      reset,
+      isActive: () => batch.remaining !== 0
+    },
+    promise
+  };
+}
+
+/** Flies pieces from `origin` into `target`, shrinking as they land. Resolves when all have landed. */
+function collect(options) {
+  const {
+    batch,
+    promise
+  } = (0, _engine.createBatch)(options?.onArrive);
+  try {
+    engine.collect(options, batch);
+  } catch (error) {
+    return Promise.reject(error);
+  }
+  return promise;
+}
+
+/** Main API — trigger a burst, await it, or run a collect flight. */
+const confetti = exports.confetti = Object.assign(options => launchBurst(options).handle, {
+  promise: options => launchBurst(options).promise,
+  collect
+});
+
+/** Fires a series of bursts on a timeline. Returns a handle to cancel or await. */
+const confettiSequence = exports.confettiSequence = (0, _sequence.createSequenceRunner)(confetti);
+
+/** Number of pieces currently on screen. */
+function getActiveParticleCount() {
+  return engine.activeCount;
+}
+
+/** Anything with React Native's `measureInWindow` — a `View`, `Text`, or `Pressable` ref. */
+
+/**
+ * Center of a mounted view in window coordinates — use it as a collect `target`
+ * (or a burst `origin`). Accepts the ref object or the instance.
+ */
+function measureCenter(ref) {
+  const node = ref !== null && "current" in ref ? ref.current : ref;
+  if (node === null || typeof node.measureInWindow !== "function") {
+    return Promise.reject(new TypeError("measureCenter: the ref is not attached to a view yet."));
+  }
+  return new Promise(resolve => {
+    node.measureInWindow((x, y, width, height) => {
+      resolve({
+        x: x + width / 2,
+        y: y + height / 2
+      });
+    });
+  });
+}
+//# sourceMappingURL=api.js.map

package/lib/commonjs/api.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_engine","require","_sequence","engine","exports","ParticleEngine","reset","launchBurst","options","batch","promise","createBatch","burst","handle","isActive","remaining","collect","onArrive","error","Promise","reject","confetti","Object","assign","confettiSequence","createSequenceRunner","getActiveParticleCount","activeCount","measureCenter","ref","node","current","measureInWindow","TypeError","resolve","x","y","width","height"],"sourceRoot":"..\\..\\src","sources":["api.ts"],"mappings":";;;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,SAAA,GAAAD,OAAA;AAUA;AACO,MAAME,MAAM,GAAAC,OAAA,CAAAD,MAAA,GAAG,IAAIE,sBAAc,CAAC,CAAC;;AAE1C;AACO,SAASC,KAAKA,CAAA,EAAS;EAC7BH,MAAM,CAACG,KAAK,CAAC,CAAC;AACf;AAEA,SAASC,WAAWA,CAACC,OAAyB,EAAsD;EACnG,MAAM;IAAEC,KAAK;IAAEC;EAAQ,CAAC,GAAG,IAAAC,mBAAW,EAAC,CAAC;EACxCR,MAAM,CAACS,KAAK,CAACJ,OAAO,EAAEC,KAAK,CAAC;EAC5B,OAAO;IACNI,MAAM,EAAE;MAAEP,KAAK;MAAEQ,QAAQ,EAAEA,CAAA,KAAML,KAAK,CAACM,SAAS,KAAK;IAAE,CAAC;IACxDL;EACD,CAAC;AACF;;AAEA;AACO,SAASM,OAAOA,CAACR,OAAuB,EAAiB;EAC/D,MAAM;IAAEC,KAAK;IAAEC;EAAQ,CAAC,GAAG,IAAAC,mBAAW,EAACH,OAAO,EAAES,QAAQ,CAAC;EACzD,IAAI;IACHd,MAAM,CAACa,OAAO,CAACR,OAAO,EAAEC,KAAK,CAAC;EAC/B,CAAC,CAAC,OAAOS,KAAK,EAAE;IACf,OAAOC,OAAO,CAACC,MAAM,CAACF,KAAK,CAAC;EAC7B;EACA,OAAOR,OAAO;AACf;;AAEA;AACO,MAAMW,QAAoB,GAAAjB,OAAA,CAAAiB,QAAA,GAAGC,MAAM,CAACC,MAAM,CAC/Cf,OAAyB,IAAqBD,WAAW,CAACC,OAAO,CAAC,CAACK,MAAM,EAC1E;EACCH,OAAO,EAAGF,OAAyB,IAAoBD,WAAW,CAACC,OAAO,CAAC,CAACE,OAAO;EACnFM;AACD,CACD,CAAC;;AAED;AACO,MAAMQ,gBAAoC,GAAApB,OAAA,CAAAoB,gBAAA,GAAG,IAAAC,8BAAoB,EAACJ,QAAQ,CAAC;;AAElF;AACO,SAASK,sBAAsBA,CAAA,EAAW;EAChD,OAAOvB,MAAM,CAACwB,WAAW;AAC1B;;AAEA;;AAKA;AACA;AACA;AACA;AACO,SAASC,aAAaA,CAC5BC,GAAgE,EACtC;EAC1B,MAAMC,IAAI,GAAGD,GAAG,KAAK,IAAI,IAAI,SAAS,IAAIA,GAAG,GAAGA,GAAG,CAACE,OAAO,GAAGF,GAAG;EACjE,IAAIC,IAAI,KAAK,IAAI,IAAI,OAAOA,IAAI,CAACE,eAAe,KAAK,UAAU,EAAE;IAChE,OAAOb,OAAO,CAACC,MAAM,CAAC,IAAIa,SAAS,CAAC,uDAAuD,CAAC,CAAC;EAC9F;EACA,OAAO,IAAId,OAAO,CAAEe,OAAO,IAAK;IAC/BJ,IAAI,CAACE,eAAe,CAAC,CAACG,CAAC,EAAEC,CAAC,EAAEC,KAAK,EAAEC,MAAM,KAAK;MAC7CJ,OAAO,CAAC;QAAEC,CAAC,EAAEA,CAAC,GAAGE,KAAK,GAAG,CAAC;QAAED,CAAC,EAAEA,CAAC,GAAGE,MAAM,GAAG;MAAE,CAAC,CAAC;IACjD,CAAC,CAAC;EACH,CAAC,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/coins.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.COIN_IMAGES = void 0;
+/** Built-in coin artwork, 256×256 transparent PNGs. */
+const COIN_IMAGES = exports.COIN_IMAGES = {
+  "h-keystone": require("./assets/coins/h-keystone.png")
+};
+//# sourceMappingURL=coins.js.map

package/lib/commonjs/coins.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["COIN_IMAGES","exports","require"],"sourceRoot":"..\\..\\src","sources":["coins.ts"],"mappings":";;;;;;AAIA;AACO,MAAMA,WAAkD,GAAAC,OAAA,CAAAD,WAAA,GAAG;EACjE,YAAY,EAAEE,OAAO,CAAC,+BAA+B;AACtD,CAAC","ignoreList":[]}

package/lib/commonjs/constants.js

@@ -0,0 +1,161 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.WOBBLE_DRAG = exports.SUBTLE_COLORS = exports.SPARK_COLORS = exports.SKEW_FACTOR = exports.SIMULATION_TIME_SCALE = exports.SETTLE_Y_OFFSET = exports.SETTLE_VELOCITY_THRESHOLD = exports.ROTATION_DRAG = exports.PRESET_OPTIONS = exports.MIN_SCALAR = exports.MIN_PARTICLE_COUNT = exports.MIN_FLATNESS = exports.MAX_SCALAR = exports.MAX_FRAME_SECONDS = exports.MAX_CONFETTI_PIECES = exports.MAX_COLLECT_STAGGER_MS = exports.MAX_COLLECT_FLIGHT_MS = exports.MAX_COIN_PIECES = exports.MAX_BURST_RADIUS = exports.DURATION_TICKS = exports.DURATION_SCALAR = exports.DURATION_DRAG = exports.DEFAULT_START_VELOCITY = exports.DEFAULT_SPREAD = exports.DEFAULT_SHAPES = exports.DEFAULT_SCALAR = exports.DEFAULT_PHYSICS = exports.DEFAULT_PARTICLE_COUNT = exports.DEFAULT_GRAVITY = exports.DEFAULT_FRAME_SECONDS = exports.DEFAULT_DRAG = exports.DEFAULT_DECAY = exports.DEFAULT_COLORS = exports.DEFAULT_COLLECT_STAGGER_MS = exports.DEFAULT_COLLECT_FLIGHT_MS = exports.DEFAULT_COIN_TYPE = exports.DEFAULT_COIN_COUNT = exports.DEFAULT_BURST_RADIUS = exports.DEFAULT_ANGLE = exports.CULL_MARGIN = exports.CONFETTI_WIDTH_RANGE = exports.CONFETTI_HEIGHT_RANGE = exports.COLLECT_START_SCALE = exports.COLLECT_STAGGER_JITTER_MS = exports.COLLECT_SPIN_RANGE = exports.COLLECT_ORIGIN_SCATTER = exports.COLLECT_FLIGHT_JITTER_MS = exports.COLLECT_FADE_START = exports.COLLECT_END_SCALE = exports.COLLECT_ARC_BEND = exports.COIN_TYPES = exports.COIN_SIZE = exports.COIN_ROTATION_FACTOR = exports.CELEBRATION_COLORS = exports.CANNON_COLORS = void 0;
+const DEFAULT_PARTICLE_COUNT = exports.DEFAULT_PARTICLE_COUNT = 60;
+const DEFAULT_COIN_COUNT = exports.DEFAULT_COIN_COUNT = 12;
+const MIN_PARTICLE_COUNT = exports.MIN_PARTICLE_COUNT = 1;
+/**
+ * Safety ceilings. The caller chooses `particleCount`; each piece is a view,
+ * so a high count costs more. Requests above these are clamped and warned.
+ */
+const MAX_CONFETTI_PIECES = exports.MAX_CONFETTI_PIECES = 300;
+const MAX_COIN_PIECES = exports.MAX_COIN_PIECES = 150;
+const DEFAULT_ANGLE = exports.DEFAULT_ANGLE = 270;
+const DEFAULT_SPREAD = exports.DEFAULT_SPREAD = 45;
+const DEFAULT_START_VELOCITY = exports.DEFAULT_START_VELOCITY = 45;
+const DEFAULT_GRAVITY = exports.DEFAULT_GRAVITY = 1.2;
+const DEFAULT_DRAG = exports.DEFAULT_DRAG = 0.08;
+const DEFAULT_DECAY = exports.DEFAULT_DECAY = 0;
+const DEFAULT_SCALAR = exports.DEFAULT_SCALAR = 1;
+const MIN_SCALAR = exports.MIN_SCALAR = 0.2;
+const MAX_SCALAR = exports.MAX_SCALAR = 3;
+const ROTATION_DRAG = exports.ROTATION_DRAG = 0.12;
+const WOBBLE_DRAG = exports.WOBBLE_DRAG = 0.1;
+const MIN_FLATNESS = exports.MIN_FLATNESS = 0.15;
+const SKEW_FACTOR = exports.SKEW_FACTOR = 0.3;
+const CULL_MARGIN = exports.CULL_MARGIN = 50;
+const SETTLE_VELOCITY_THRESHOLD = exports.SETTLE_VELOCITY_THRESHOLD = 0.05;
+const SETTLE_Y_OFFSET = exports.SETTLE_Y_OFFSET = 50;
+
+/**
+ * The shared physics constants are tuned in small units; the host advances
+ * the simulation this many seconds per real second so bursts read at phone scale.
+ */
+const SIMULATION_TIME_SCALE = exports.SIMULATION_TIME_SCALE = 12;
+/** Longest frame step in seconds, so a dropped frame does not teleport pieces. */
+const MAX_FRAME_SECONDS = exports.MAX_FRAME_SECONDS = 0.05;
+const DEFAULT_FRAME_SECONDS = exports.DEFAULT_FRAME_SECONDS = 1 / 60;
+
+/** No limit — pieces can travel anywhere on screen. */
+const DEFAULT_BURST_RADIUS = exports.DEFAULT_BURST_RADIUS = 0;
+const MAX_BURST_RADIUS = exports.MAX_BURST_RADIUS = 5000;
+
+/** Lifespan in ticks when duration is set and ticks are not explicit. */
+const DURATION_TICKS = exports.DURATION_TICKS = {
+  short: 45,
+  normal: 0,
+  long: 220
+};
+
+/** Default drag per duration preset. */
+const DURATION_DRAG = exports.DURATION_DRAG = {
+  short: 0.16,
+  normal: DEFAULT_DRAG,
+  long: 0.05
+};
+
+/** Default size multiplier per duration preset. */
+const DURATION_SCALAR = exports.DURATION_SCALAR = {
+  short: 0.55,
+  normal: 1,
+  long: 1.15
+};
+const DEFAULT_COLORS = exports.DEFAULT_COLORS = ["#FF2D55", "#FFCC00", "#34C759", "#007AFF", "#AF52DE", "#FF9500", "#5AC8FA", "#FF6B9D"];
+const CELEBRATION_COLORS = exports.CELEBRATION_COLORS = ["#FFD700", "#FF2D55", "#FF1493", "#00E5FF", "#39FF14", "#FF9500", "#BF5AF2"];
+const SUBTLE_COLORS = exports.SUBTLE_COLORS = ["#B8C5D6", "#D4A5A5", "#A8D8EA", "#C9B1FF"];
+const CANNON_COLORS = exports.CANNON_COLORS = ["#FF4500", "#FFA500", "#FFFF00", "#FF2D55", "#FF6347"];
+const SPARK_COLORS = exports.SPARK_COLORS = ["#FFFFFF", "#FFFACD", "#FFE4E1", "#E0FFFF"];
+const DEFAULT_SHAPES = exports.DEFAULT_SHAPES = ["rect", "circle"];
+
+/** Confetti piece size range in dp before `scalar`. */
+const CONFETTI_WIDTH_RANGE = exports.CONFETTI_WIDTH_RANGE = [6, 12];
+const CONFETTI_HEIGHT_RANGE = exports.CONFETTI_HEIGHT_RANGE = [4, 10];
+const COIN_TYPES = exports.COIN_TYPES = ["h-keystone"];
+const DEFAULT_COIN_TYPE = exports.DEFAULT_COIN_TYPE = "h-keystone";
+/** Coin edge length in dp before `scalar`. */
+const COIN_SIZE = exports.COIN_SIZE = 40;
+/** Coins spin in-plane slower than paper confetti. */
+const COIN_ROTATION_FACTOR = exports.COIN_ROTATION_FACTOR = 0.25;
+
+/** Collect flight: average ms per piece and the random spread around it. */
+const DEFAULT_COLLECT_FLIGHT_MS = exports.DEFAULT_COLLECT_FLIGHT_MS = 900;
+const COLLECT_FLIGHT_JITTER_MS = exports.COLLECT_FLIGHT_JITTER_MS = 200;
+const DEFAULT_COLLECT_STAGGER_MS = exports.DEFAULT_COLLECT_STAGGER_MS = 60;
+const COLLECT_STAGGER_JITTER_MS = exports.COLLECT_STAGGER_JITTER_MS = 20;
+const MAX_COLLECT_FLIGHT_MS = exports.MAX_COLLECT_FLIGHT_MS = 5000;
+const MAX_COLLECT_STAGGER_MS = exports.MAX_COLLECT_STAGGER_MS = 1000;
+/** Scale at launch and at the target, relative to the piece size. */
+const COLLECT_START_SCALE = exports.COLLECT_START_SCALE = 2.4;
+const COLLECT_END_SCALE = exports.COLLECT_END_SCALE = 0.2;
+/** Fraction of the flight after which pieces fade out. */
+const COLLECT_FADE_START = exports.COLLECT_FADE_START = 0.85;
+/** Pieces start scattered this far (dp) around the origin. */
+const COLLECT_ORIGIN_SCATTER = exports.COLLECT_ORIGIN_SCATTER = 24;
+/** How far the arc bows sideways, as a fraction of the flight distance. */
+const COLLECT_ARC_BEND = exports.COLLECT_ARC_BEND = 0.35;
+/** Coin spin speed in radians per second during a collect flight. */
+const COLLECT_SPIN_RANGE = exports.COLLECT_SPIN_RANGE = [6, 10];
+
+/** Baseline simulation values used when options are resolved. */
+const DEFAULT_PHYSICS = exports.DEFAULT_PHYSICS = {
+  gravity: DEFAULT_GRAVITY,
+  drag: DEFAULT_DRAG,
+  rotationDrag: ROTATION_DRAG,
+  wobbleDrag: WOBBLE_DRAG,
+  minFlatness: MIN_FLATNESS,
+  skewFactor: SKEW_FACTOR,
+  decay: DEFAULT_DECAY
+};
+
+/** Default option overrides for each named preset. */
+const PRESET_OPTIONS = exports.PRESET_OPTIONS = {
+  celebration: {
+    particleCount: 150,
+    startVelocity: 62,
+    spread: 85,
+    gravity: 0.9,
+    duration: "normal",
+    scalar: 1.15,
+    colors: CELEBRATION_COLORS,
+    shapes: ["rect", "circle"]
+  },
+  subtle: {
+    particleCount: 14,
+    startVelocity: 16,
+    spread: 22,
+    gravity: 0.55,
+    duration: "short",
+    scalar: 0.6,
+    drag: 0.14,
+    colors: SUBTLE_COLORS,
+    shapes: ["circle"]
+  },
+  cannon: {
+    particleCount: 55,
+    startVelocity: 88,
+    spread: 14,
+    gravity: 2.2,
+    duration: "short",
+    scalar: 1,
+    angle: 270,
+    colors: CANNON_COLORS,
+    shapes: ["rect"]
+  },
+  spark: {
+    particleCount: 8,
+    startVelocity: 22,
+    spread: 360,
+    gravity: 0.4,
+    duration: "short",
+    scalar: 0.45,
+    drag: 0.2,
+    decay: 0.08,
+    burstRadius: 80,
+    colors: SPARK_COLORS,
+    shapes: ["circle"]
+  }
+};
+//# sourceMappingURL=constants.js.map

package/lib/commonjs/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_PARTICLE_COUNT","exports","DEFAULT_COIN_COUNT","MIN_PARTICLE_COUNT","MAX_CONFETTI_PIECES","MAX_COIN_PIECES","DEFAULT_ANGLE","DEFAULT_SPREAD","DEFAULT_START_VELOCITY","DEFAULT_GRAVITY","DEFAULT_DRAG","DEFAULT_DECAY","DEFAULT_SCALAR","MIN_SCALAR","MAX_SCALAR","ROTATION_DRAG","WOBBLE_DRAG","MIN_FLATNESS","SKEW_FACTOR","CULL_MARGIN","SETTLE_VELOCITY_THRESHOLD","SETTLE_Y_OFFSET","SIMULATION_TIME_SCALE","MAX_FRAME_SECONDS","DEFAULT_FRAME_SECONDS","DEFAULT_BURST_RADIUS","MAX_BURST_RADIUS","DURATION_TICKS","short","normal","long","DURATION_DRAG","DURATION_SCALAR","DEFAULT_COLORS","CELEBRATION_COLORS","SUBTLE_COLORS","CANNON_COLORS","SPARK_COLORS","DEFAULT_SHAPES","CONFETTI_WIDTH_RANGE","CONFETTI_HEIGHT_RANGE","COIN_TYPES","DEFAULT_COIN_TYPE","COIN_SIZE","COIN_ROTATION_FACTOR","DEFAULT_COLLECT_FLIGHT_MS","COLLECT_FLIGHT_JITTER_MS","DEFAULT_COLLECT_STAGGER_MS","COLLECT_STAGGER_JITTER_MS","MAX_COLLECT_FLIGHT_MS","MAX_COLLECT_STAGGER_MS","COLLECT_START_SCALE","COLLECT_END_SCALE","COLLECT_FADE_START","COLLECT_ORIGIN_SCATTER","COLLECT_ARC_BEND","COLLECT_SPIN_RANGE","DEFAULT_PHYSICS","gravity","drag","rotationDrag","wobbleDrag","minFlatness","skewFactor","decay","PRESET_OPTIONS","celebration","particleCount","startVelocity","spread","duration","scalar","colors","shapes","subtle","cannon","angle","spark","burstRadius"],"sourceRoot":"..\\..\\src","sources":["constants.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/core.js

@@ -0,0 +1,120 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "COIN_TYPES", {
+  enumerable: true,
+  get: function () {
+    return _constants.COIN_TYPES;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_COIN_TYPE", {
+  enumerable: true,
+  get: function () {
+    return _constants.DEFAULT_COIN_TYPE;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_COLORS", {
+  enumerable: true,
+  get: function () {
+    return _constants.DEFAULT_COLORS;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_PHYSICS", {
+  enumerable: true,
+  get: function () {
+    return _constants.DEFAULT_PHYSICS;
+  }
+});
+Object.defineProperty(exports, "PRESET_OPTIONS", {
+  enumerable: true,
+  get: function () {
+    return _constants.PRESET_OPTIONS;
+  }
+});
+Object.defineProperty(exports, "SIMULATION_TIME_SCALE", {
+  enumerable: true,
+  get: function () {
+    return _constants.SIMULATION_TIME_SCALE;
+  }
+});
+Object.defineProperty(exports, "applyDrag", {
+  enumerable: true,
+  get: function () {
+    return _drag.applyDrag;
+  }
+});
+Object.defineProperty(exports, "applyDrag2D", {
+  enumerable: true,
+  get: function () {
+    return _drag.applyDrag2D;
+  }
+});
+Object.defineProperty(exports, "computeSkewX", {
+  enumerable: true,
+  get: function () {
+    return _wobble.computeSkewX;
+  }
+});
+Object.defineProperty(exports, "computeWobbleScale", {
+  enumerable: true,
+  get: function () {
+    return _wobble.computeWobbleScale;
+  }
+});
+Object.defineProperty(exports, "integrateParticle", {
+  enumerable: true,
+  get: function () {
+    return _spawn.integrateParticle;
+  }
+});
+Object.defineProperty(exports, "isParticleDead", {
+  enumerable: true,
+  get: function () {
+    return _spawn.isParticleDead;
+  }
+});
+Object.defineProperty(exports, "parseCollectOptions", {
+  enumerable: true,
+  get: function () {
+    return _validation.parseCollectOptions;
+  }
+});
+Object.defineProperty(exports, "parseConfettiOptions", {
+  enumerable: true,
+  get: function () {
+    return _validation.parseConfettiOptions;
+  }
+});
+Object.defineProperty(exports, "resolveCoinType", {
+  enumerable: true,
+  get: function () {
+    return _validation.resolveCoinType;
+  }
+});
+Object.defineProperty(exports, "sampleCollectPiece", {
+  enumerable: true,
+  get: function () {
+    return _collect.sampleCollectPiece;
+  }
+});
+Object.defineProperty(exports, "spawnCollectPieces", {
+  enumerable: true,
+  get: function () {
+    return _collect.spawnCollectPieces;
+  }
+});
+Object.defineProperty(exports, "spawnParticles", {
+  enumerable: true,
+  get: function () {
+    return _spawn.spawnParticles;
+  }
+});
+var _constants = require("./constants.js");
+var _collect = require("./physics/collect.js");
+var _drag = require("./physics/drag.js");
+var _spawn = require("./physics/spawn.js");
+var _wobble = require("./physics/wobble.js");
+var _validation = require("./utils/validation.js");
+//# sourceMappingURL=core.js.map

package/lib/commonjs/core.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_constants","require","_collect","_drag","_spawn","_wobble","_validation"],"sourceRoot":"..\\..\\src","sources":["core.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,IAAAA,UAAA,GAAAC,OAAA;AAQA,IAAAC,QAAA,GAAAD,OAAA;AACA,IAAAE,KAAA,GAAAF,OAAA;AACA,IAAAG,MAAA,GAAAH,OAAA;AACA,IAAAI,OAAA,GAAAJ,OAAA;AAEA,IAAAK,WAAA,GAAAL,OAAA","ignoreList":[]}