@ansh-ui/core 0.2.0

package/dist/easing.d.ts

@@ -0,0 +1,134 @@
+import { a as EasingFn, E as EasingInput } from './types-B1FLLf3-.js';
+export { b as EasingName } from './types-B1FLLf3-.js';
+
+/**
+ * Build an easing function from four cubic-bézier control coordinates.
+ *
+ * @param x1 First control point's x, clamped to `[0,1]` (as CSS requires — an x outside
+ *           that range makes the curve non-monotonic in time and thus not a valid timing
+ *           function). y values are unconstrained, which is what allows overshoot curves
+ *           like `easeOutBack`.
+ */
+declare function cubicBezier(x1: number, y1: number, x2: number, y2: number): EasingFn;
+/**
+ * A stepped (staircase) timing function, matching CSS `steps()`.
+ *
+ * @param count Number of discrete steps. Must be >= 1.
+ * @param position Where the jump happens within each step, matching the CSS keywords.
+ */
+declare function steps(count: number, position?: 'start' | 'end' | 'both' | 'none'): EasingFn;
+
+/**
+ * The built-in easing library.
+ *
+ * Curves follow the Penner definitions, which is what CSS, GSAP and Framer Motion all
+ * converged on — so `easeOutCubic` here is numerically identical to `easeOutCubic` there.
+ * Every function is exact at both endpoints.
+ */
+/** Turn an "in" curve into its mirrored "out" counterpart. */
+declare function reverseEasing(easeIn: EasingFn): EasingFn;
+/** Compose an "in" curve into a symmetric "in-out" curve. */
+declare function mirrorEasing(easeIn: EasingFn): EasingFn;
+/** Raise progress to a power — the family behind quad/cubic/quart/quint. */
+declare function power(exponent: number): EasingFn;
+declare const easeInSine: EasingFn;
+declare const easeOutSine: EasingFn;
+declare const easeInOutSine: EasingFn;
+declare const easeInQuad: EasingFn;
+declare const easeOutQuad: EasingFn;
+declare const easeInOutQuad: EasingFn;
+declare const easeInCubic: EasingFn;
+declare const easeOutCubic: EasingFn;
+declare const easeInOutCubic: EasingFn;
+declare const easeInQuart: EasingFn;
+declare const easeOutQuart: EasingFn;
+declare const easeInOutQuart: EasingFn;
+declare const easeInQuint: EasingFn;
+declare const easeOutQuint: EasingFn;
+declare const easeInOutQuint: EasingFn;
+declare const easeInExpo: EasingFn;
+declare const easeOutExpo: EasingFn;
+declare const easeInOutExpo: EasingFn;
+declare const easeInCirc: EasingFn;
+declare const easeOutCirc: EasingFn;
+declare const easeInOutCirc: EasingFn;
+declare const easeInBack: EasingFn;
+declare const easeOutBack: EasingFn;
+declare const easeInOutBack: EasingFn;
+/**
+ * A brief pull-back before moving forward. Reads as "gathering intent".
+ *
+ * The second half is an exponential decay, which approaches 1 asymptotically and never reaches it —
+ * at `t = 1` the raw expression gives `1 - 2⁻¹¹`. The explicit endpoint keeps the curve exact, which
+ * the animation driver relies on to land values on their targets rather than a fraction short.
+ */
+declare const anticipate: EasingFn;
+declare const easeInElastic: EasingFn;
+declare const easeOutElastic: EasingFn;
+declare const easeInOutElastic: EasingFn;
+declare const easeOutBounce: EasingFn;
+declare const easeInBounce: EasingFn;
+declare const easeInOutBounce: EasingFn;
+declare const linear: EasingFn;
+/**
+ * Named curve lookup.
+ *
+ * Kept as a mutable record so `registerEasing()` can extend it. Consumers should go through
+ * `resolveEasing()` rather than reading this directly.
+ */
+declare const easings: Record<string, EasingFn>;
+/**
+ * Signature curves used by the design system's motion hierarchy.
+ *
+ * These are the ones you should reach for by default. They are named for intent rather than
+ * for maths, because "what is this motion communicating" is the useful question at a call site.
+ */
+declare const signature: {
+    /** Entrances. Fast out of the gate, long gentle settle. The Ansh house curve. */
+    emphasized: EasingFn;
+    /** UI state changes that should feel instant but not abrupt. */
+    standard: EasingFn;
+    /** Exits. Accelerates away — the element is leaving, don't linger on it. */
+    exit: EasingFn;
+    /** Entrances from off-screen. Decelerates in. */
+    enter: EasingFn;
+    /** A confident, slightly springy overshoot without full elastic wobble. */
+    overshoot: EasingFn;
+    /** Long, cinematic reveals — hero sections, scroll-driven scenes. */
+    cinematic: EasingFn;
+};
+/**
+ * Register a custom named curve, making it resolvable everywhere an easing is accepted.
+ *
+ * @throws if the name collides with a built-in, to prevent one plugin silently changing
+ *         the meaning of `easeOutCubic` for the whole application.
+ */
+declare function registerEasing(name: string, fn: EasingFn): void;
+/** Remove a previously registered custom curve. Built-ins cannot be removed. */
+declare function unregisterEasing(name: string): void;
+/** Every currently resolvable easing name, built-in and custom. */
+declare function listEasings(): string[];
+
+/**
+ * Sample a curve into a lookup table.
+ *
+ * Useful for expensive curves evaluated per-particle per-frame, and for rendering easing
+ * previews in the docs site.
+ */
+declare function sampleEasing(easing: EasingFn, resolution?: number): Float32Array;
+/** Read a table produced by {@link sampleEasing}, interpolating between samples. */
+declare function readEasingTable(table: Float32Array, t: number): number;
+
+/**
+ * Normalise any accepted easing shape into a callable function.
+ *
+ * This is the single entry point every part of the engine uses, so authors can pass a name,
+ * a function, or bézier coordinates interchangeably and it always works the same way.
+ *
+ * An unknown *name* is a developer mistake worth surfacing loudly — silently falling back to
+ * linear would produce motion that looks subtly wrong with no explanation. We warn and fall
+ * back rather than throw, because a bad easing name should never take down a page in production.
+ */
+declare function resolveEasing(input: EasingInput | undefined | null): EasingFn;
+
+export { EasingFn, EasingInput, anticipate, cubicBezier, easeInBack, easeInBounce, easeInCirc, easeInCubic, easeInElastic, easeInExpo, easeInOutBack, easeInOutBounce, easeInOutCirc, easeInOutCubic, easeInOutElastic, easeInOutExpo, easeInOutQuad, easeInOutQuart, easeInOutQuint, easeInOutSine, easeInQuad, easeInQuart, easeInQuint, easeInSine, easeOutBack, easeOutBounce, easeOutCirc, easeOutCubic, easeOutElastic, easeOutExpo, easeOutQuad, easeOutQuart, easeOutQuint, easeOutSine, easings, linear, listEasings, mirrorEasing, power, readEasingTable, registerEasing, resolveEasing, reverseEasing, sampleEasing, signature, steps, unregisterEasing };

package/dist/easing.js

@@ -0,0 +1,4 @@
+export { anticipate, cubicBezier, easeInBack, easeInBounce, easeInCirc, easeInCubic, easeInElastic, easeInExpo, easeInOutBack, easeInOutBounce, easeInOutCirc, easeInOutCubic, easeInOutElastic, easeInOutExpo, easeInOutQuad, easeInOutQuart, easeInOutQuint, easeInOutSine, easeInQuad, easeInQuart, easeInQuint, easeInSine, easeOutBack, easeOutBounce, easeOutCirc, easeOutCubic, easeOutElastic, easeOutExpo, easeOutQuad, easeOutQuart, easeOutQuint, easeOutSine, easings, linear, listEasings, mirrorEasing, power, readEasingTable, registerEasing, resolveEasing, reverseEasing, sampleEasing, signature, steps, unregisterEasing } from './chunk-7MEIXWPH.js';
+import './chunk-KU2C6GEA.js';
+//# sourceMappingURL=easing.js.map
+//# sourceMappingURL=easing.js.map

package/dist/easing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"easing.js"}

package/dist/effects.cjs

@@ -0,0 +1,99 @@
+'use strict';
+
+var chunkR7UJ7MWP_cjs = require('./chunk-R7UJ7MWP.cjs');
+require('./chunk-23GSSIMK.cjs');
+require('./chunk-DXJ63QAR.cjs');
+require('./chunk-FNR35HTL.cjs');
+require('./chunk-MMO7KO53.cjs');
+require('./chunk-LGA3N3YJ.cjs');
+require('./chunk-GJRIHN76.cjs');
+require('./chunk-ILKUL7GD.cjs');
+
+
+
+Object.defineProperty(exports, "ParticleBuffer", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.ParticleBuffer; }
+});
+Object.defineProperty(exports, "SpatialGrid", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.SpatialGrid; }
+});
+Object.defineProperty(exports, "ageAndCull", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.ageAndCull; }
+});
+Object.defineProperty(exports, "animatedGradient", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.animatedGradient; }
+});
+Object.defineProperty(exports, "aurora", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.aurora; }
+});
+Object.defineProperty(exports, "blob", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.blob; }
+});
+Object.defineProperty(exports, "constellation", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.constellation; }
+});
+Object.defineProperty(exports, "defineEffect", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.defineEffect; }
+});
+Object.defineProperty(exports, "effects", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.effects; }
+});
+Object.defineProperty(exports, "fireflies", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.fireflies; }
+});
+Object.defineProperty(exports, "integrate", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.integrate; }
+});
+Object.defineProperty(exports, "meshGradient", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.meshGradient; }
+});
+Object.defineProperty(exports, "meteors", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.meteors; }
+});
+Object.defineProperty(exports, "mountEffect", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.mountEffect; }
+});
+Object.defineProperty(exports, "noiseLayer", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.noiseLayer; }
+});
+Object.defineProperty(exports, "particleField", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.particleField; }
+});
+Object.defineProperty(exports, "rain", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.rain; }
+});
+Object.defineProperty(exports, "snow", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.snow; }
+});
+Object.defineProperty(exports, "spotlight", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.spotlight; }
+});
+Object.defineProperty(exports, "waves", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.waves; }
+});
+Object.defineProperty(exports, "wrapBounds", {
+  enumerable: true,
+  get: function () { return chunkR7UJ7MWP_cjs.wrapBounds; }
+});
+//# sourceMappingURL=effects.cjs.map
+//# sourceMappingURL=effects.cjs.map

package/dist/effects.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"effects.cjs"}

package/dist/effects.d.cts

@@ -0,0 +1,5 @@
+export { A as AnimatedGradientOptions, a as AuroraOptions, B as BaseEffectOptions, c as BlobOptions, C as ConstellationOptions, E as EffectContext, d as EffectDefinition, e as EffectFrame, f as EffectHandle, g as EffectInstance, h as EffectName, F as FirefliesOptions, M as MeshGradientOptions, i as MeteorsOptions, N as NoiseLayerOptions, P as ParticleBuffer, j as ParticleFieldOptions, R as RainOptions, n as SnowOptions, o as SpatialGrid, p as SpotlightOptions, W as WavesOptions, s as ageAndCull, t as animatedGradient, u as aurora, v as blob, w as constellation, y as defineEffect, H as effects, I as fireflies, J as integrate, K as meshGradient, L as meteors, O as mountEffect, Q as noiseLayer, T as particleField, V as rain, Y as snow, Z as spotlight, a5 as waves, a6 as wrapBounds } from './index-DHOfsEIn.cjs';
+import './reduced-motion-D0LUgZle.cjs';
+import './random--4mSc5Lp.cjs';
+import './noise.cjs';
+import './palette-6HkVltYU.cjs';

package/dist/effects.d.ts

@@ -0,0 +1,5 @@
+export { A as AnimatedGradientOptions, a as AuroraOptions, B as BaseEffectOptions, c as BlobOptions, C as ConstellationOptions, E as EffectContext, d as EffectDefinition, e as EffectFrame, f as EffectHandle, g as EffectInstance, h as EffectName, F as FirefliesOptions, M as MeshGradientOptions, i as MeteorsOptions, N as NoiseLayerOptions, P as ParticleBuffer, j as ParticleFieldOptions, R as RainOptions, n as SnowOptions, o as SpatialGrid, p as SpotlightOptions, W as WavesOptions, s as ageAndCull, t as animatedGradient, u as aurora, v as blob, w as constellation, y as defineEffect, H as effects, I as fireflies, J as integrate, K as meshGradient, L as meteors, O as mountEffect, Q as noiseLayer, T as particleField, V as rain, Y as snow, Z as spotlight, a5 as waves, a6 as wrapBounds } from './index-CCdpefMp.js';
+import './reduced-motion-D0LUgZle.js';
+import './random--4mSc5Lp.js';
+import './noise.js';
+import './palette-6HkVltYU.js';

package/dist/effects.js

@@ -0,0 +1,10 @@
+export { ParticleBuffer, SpatialGrid, ageAndCull, animatedGradient, aurora, blob, constellation, defineEffect, effects, fireflies, integrate, meshGradient, meteors, mountEffect, noiseLayer, particleField, rain, snow, spotlight, waves, wrapBounds } from './chunk-56NNBIAO.js';
+import './chunk-KTUBCQC3.js';
+import './chunk-FAVIEION.js';
+import './chunk-YFQXRC5R.js';
+import './chunk-BOQQHICI.js';
+import './chunk-QALZKHWH.js';
+import './chunk-7MEIXWPH.js';
+import './chunk-KU2C6GEA.js';
+//# sourceMappingURL=effects.js.map
+//# sourceMappingURL=effects.js.map

package/dist/effects.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"effects.js"}