@epam/ai-dial-celebrations 1.2.0-dev.170

package/halloween/utils/halloween.d.ts

@@ -0,0 +1,101 @@
+import { CSSProperties } from 'react';
+import { HalloweenGhostVariant } from '../types/halloween';
+/** One abseiling spider of a `HalloweenScene.Spiders` celebration. */
+export interface HalloweenSpiderDrop {
+    /** Custom properties consumed by `.spiderDrop` in `Halloween.module.scss`. */
+    style: CSSProperties;
+}
+/**
+ * Lays out one drop. Each spider gets its own column, thread length, size,
+ * pace, sway and start delay, so they arrive as a scatter rather than a
+ * curtain. `--spider-depth` is both the thread's length and the distance the
+ * pair travels, which is what keeps the thread anchored to the top edge for
+ * the whole descent.
+ *
+ * Called once per burst rather than per render: the layer re-renders on every
+ * ancestor state change, and re-rolling the offsets would restart each
+ * spider's descent halfway down.
+ */
+export declare const buildHalloweenSpiderDrop: () => HalloweenSpiderDrop[];
+/** One ghost of a `HalloweenScene.Ghost` celebration, with its flight path. */
+export interface HalloweenGhostFlight {
+    variant: HalloweenGhostVariant;
+    /** Custom properties consumed by `.ghost` in `Halloween.module.scss`. */
+    style: CSSProperties;
+}
+/**
+ * Lays out one flock. Every ghost gets its own entry edge, arc, size, tilt and
+ * pace, so the flock reads as individuals rather than a row: it enters from
+ * off-screen left or right at a random height, curves upward across the
+ * viewport, and leaves past the opposite edge.
+ *
+ * `--ghost-rest-*` is where the ghost sits when animations are suppressed for
+ * reduced motion — spread across the viewport instead of stacked at the
+ * origin, which is where an un-animated element would otherwise sit.
+ *
+ * Distances are in `vw`/`vh` so a flight crosses the viewport at any size, and
+ * the path is deliberately direction-agnostic (each ghost picks its own side),
+ * so nothing here needs to flip under RTL.
+ */
+export declare const buildHalloweenGhostFlight: () => HalloweenGhostFlight[];
+/** A point in viewport pixels. */
+interface Point {
+    x: number;
+    y: number;
+}
+interface SpiderFleeInput {
+    /** Where the spider sits when undisturbed, in viewport pixels. */
+    perch: Point;
+    /** The pointer, in viewport pixels. */
+    pointer: Point;
+    /** The spider's current displacement from its perch. */
+    offset: Point;
+    /** How close the pointer gets before the spider bolts. */
+    fleeRadius: number;
+    /** How far the spider bolts per nudge. */
+    fleeStep: number;
+    /** How far the spider may stray from its perch. */
+    maxOffset: number;
+}
+/**
+ * The spider's next displacement from its perch, or `null` when the pointer
+ * is far enough away that it has no reason to move.
+ *
+ * It bolts straight along the line away from the pointer, which is what makes
+ * a chase work: the cursor pushes and the spider gives ground. Clamping the
+ * result to `maxOffset` is a circle, not a box, so a spider herded against
+ * the boundary keeps whatever part of the push runs along it and slides round
+ * instead of stopping dead. A push aimed exactly at the centre has no such
+ * component and does hold it against the leash, which is the one way to
+ * corner it.
+ *
+ * A pointer exactly on the spider has no direction to flee along, so it
+ * breaks the tie diagonally rather than dividing by zero.
+ */
+export declare const nextHalloweenSpiderOffset: ({ perch, pointer, offset, fleeRadius, fleeStep, maxOffset, }: SpiderFleeInput) => Point | null;
+/** Where an idle drop has the spider: thread paid out and pendulum angle. */
+export interface HalloweenSpiderDanglePose {
+    depth: number;
+    angle: number;
+}
+/**
+ * The pose `progress` (0–1) of the way through an idle drop: the spider pays
+ * out its thread, swings a little as it stops, hangs, and climbs back up.
+ * Evaluated rather than read back from the page, so an interrupted drop can
+ * reel in from exactly where it is.
+ */
+export declare const getHalloweenSpiderDanglePose: (depth: number, progress: number) => HalloweenSpiderDanglePose;
+/** Pendulum transform: rotate about the anchor, then hang down the thread. */
+export declare const getHalloweenSpiderDangleTransform: ({ depth, angle, }: HalloweenSpiderDanglePose) => string;
+/** Keyframes for the spider and its thread, which share one timeline. */
+export declare const buildHalloweenSpiderDangle: (depth: number) => {
+    dangle: Keyframe[];
+    thread: Keyframe[];
+};
+/** A random value in a `[min, max)` range tuple. */
+export declare const pickHalloweenRange: ([min, max]: readonly [number, number]) => number;
+export declare const buildHalloweenBatFlight: () => CSSProperties[];
+/** Dim little lights rise from separate columns, leaving the UI readable. */
+export declare const buildHalloweenWisps: () => CSSProperties[];
+export {};
+//# sourceMappingURL=halloween.d.ts.map

package/halloween/utils/halloween.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"halloween.d.ts","sourceRoot":"","sources":["../../../src/halloween/utils/halloween.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAQ3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAM3D,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,QAAO,mBAAmB,EAiB3D,CAAC;AAIL,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,yEAAyE;IACzE,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB,QAAO,oBAAoB,EAoC7D,CAAC;AAEL,kCAAkC;AAClC,UAAU,KAAK;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,UAAU,eAAe;IACvB,kEAAkE;IAClE,KAAK,EAAE,KAAK,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAC;IACf,wDAAwD;IACxD,MAAM,EAAE,KAAK,CAAC;IACd,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,yBAAyB,GAAI,8DAOvC,eAAe,KAAG,KAAK,GAAG,IAoB5B,CAAC;AAEF,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAOD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,MAAM,EACb,UAAU,MAAM,KACf,yBASF,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,iCAAiC,GAAI,mBAG/C,yBAAyB,KAAG,MACqC,CAAC;AAErE,yEAAyE;AACzE,eAAO,MAAM,0BAA0B,GACrC,OAAO,MAAM,KACZ;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,MAAM,EAAE,QAAQ,EAAE,CAAA;CAgB1C,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,GAAI,YAAY,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,WACrD,CAAC;AAEpB,eAAO,MAAM,uBAAuB,QAAO,aAAa,EAYrD,CAAC;AAEJ,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,QAAO,aAAa,EAWjD,CAAC"}