@ansh-ui/core 0.2.0 → 0.3.1

package/dist/{chunk-GHBRGMSO.cjs → chunk-PZF3YXVE.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk23GSSIMK_cjs = require('./chunk-23GSSIMK.cjs');
+var chunk4ORYTFY3_cjs = require('./chunk-4ORYTFY3.cjs');
 var chunkLGA3N3YJ_cjs = require('./chunk-LGA3N3YJ.cjs');
 var chunkILKUL7GD_cjs = require('./chunk-ILKUL7GD.cjs');
 
@@ -8,7 +8,7 @@ var chunkILKUL7GD_cjs = require('./chunk-ILKUL7GD.cjs');
 function contrastRatio(foreground, background) {
   const bg = chunkLGA3N3YJ_cjs.parseColor(background);
   const fgRaw = chunkLGA3N3YJ_cjs.parseColor(foreground);
-  const fg = fgRaw.a < 1 ? chunk23GSSIMK_cjs.composite(bg, fgRaw) : fgRaw;
+  const fg = fgRaw.a < 1 ? chunk4ORYTFY3_cjs.composite(bg, fgRaw) : fgRaw;
   const l1 = chunkLGA3N3YJ_cjs.relativeLuminance(fg);
   const l2 = chunkLGA3N3YJ_cjs.relativeLuminance(bg);
   const lighter = Math.max(l1, l2);
@@ -43,7 +43,7 @@ function ensureContrast(foreground, background, target = 4.5) {
   const limit = direction > 0 ? 1 - lch.l : lch.l;
   for (let i = 1; i <= STEPS; i++) {
     const l = chunkILKUL7GD_cjs.clamp(lch.l + direction * (limit * (i / STEPS)), 0, 1);
-    const candidate = chunk23GSSIMK_cjs.oklchToRgbMapped({ l, c: lch.c, h: lch.h, alpha: fg.a });
+    const candidate = chunk4ORYTFY3_cjs.oklchToRgbMapped({ l, c: lch.c, h: lch.h, alpha: fg.a });
     const ratio = contrastRatio(candidate, bg);
     if (ratio > bestRatio) {
       bestRatio = ratio;
@@ -54,7 +54,7 @@ function ensureContrast(foreground, background, target = 4.5) {
   for (let i = 1; i <= 8; i++) {
     const c = lch.c * (1 - i / 8);
     const l = direction > 0 ? 1 : 0;
-    const candidate = chunk23GSSIMK_cjs.oklchToRgbMapped({ l, c, h: lch.h, alpha: fg.a });
+    const candidate = chunk4ORYTFY3_cjs.oklchToRgbMapped({ l, c, h: lch.h, alpha: fg.a });
     const ratio = contrastRatio(candidate, bg);
     if (ratio > bestRatio) {
       bestRatio = ratio;
@@ -87,5 +87,5 @@ exports.perceivedLightness = perceivedLightness;
 exports.pickReadable = pickReadable;
 exports.requiredRatio = requiredRatio;
 exports.worstContrast = worstContrast;
-//# sourceMappingURL=chunk-GHBRGMSO.cjs.map
-//# sourceMappingURL=chunk-GHBRGMSO.cjs.map
+//# sourceMappingURL=chunk-PZF3YXVE.cjs.map
+//# sourceMappingURL=chunk-PZF3YXVE.cjs.map

package/dist/{chunk-GHBRGMSO.cjs.map → chunk-PZF3YXVE.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/color/contrast.ts"],"names":["parseColor","composite","relativeLuminance","rgbToOklch","clamp","oklchToRgbMapped"],"mappings":"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","file":"chunk-GHBRGMSO.cjs","sourcesContent":["import { clamp } from '../math/scalar'\nimport { relativeLuminance, rgbToOklch } from './convert'\nimport { oklchToRgbMapped } from './gamut'\nimport { parseColor } from './parse'\nimport { composite } from './interpolate'\nimport type { ColorInput, Rgb } from './types'\n\n/**\n * Contrast and legibility.\n *\n * Animated backgrounds are the single most common way a design ends up failing WCAG: the text\n * was legible against the mockup's midpoint and illegible against the animation's brightest\n * frame. These helpers let components check contrast against the *extremes* of their own\n * palette and adapt, rather than hoping.\n */\n\nexport type WcagLevel = 'AA' | 'AAA'\nexport type TextSize = 'normal' | 'large'\n\n/**\n * WCAG 2.x contrast ratio, from 1 (identical) to 21 (black on white).\n *\n * Semi-transparent colours are composited over `background` first, because a ratio computed\n * from a colour's own alpha is meaningless — what matters is what the eye actually receives.\n */\nexport function contrastRatio(foreground: ColorInput, background: ColorInput): number {\n  const bg = parseColor(background)\n  const fgRaw = parseColor(foreground)\n  const fg = fgRaw.a < 1 ? composite(bg, fgRaw) : fgRaw\n\n  const l1 = relativeLuminance(fg)\n  const l2 = relativeLuminance(bg)\n  const lighter = Math.max(l1, l2)\n  const darker = Math.min(l1, l2)\n  return (lighter + 0.05) / (darker + 0.05)\n}\n\n/** Minimum ratio required by WCAG 2.2 for the given level and text size. */\nexport function requiredRatio(level: WcagLevel, size: TextSize): number {\n  if (level === 'AAA') return size === 'large' ? 4.5 : 7\n  return size === 'large' ? 3 : 4.5\n}\n\nexport interface ContrastResult {\n  ratio: number\n  passes: boolean\n  required: number\n  level: WcagLevel\n  size: TextSize\n}\n\n/** Check a foreground/background pair against a WCAG threshold. */\nexport function checkContrast(\n  foreground: ColorInput,\n  background: ColorInput,\n  level: WcagLevel = 'AA',\n  size: TextSize = 'normal',\n): ContrastResult {\n  const ratio = contrastRatio(foreground, background)\n  const required = requiredRatio(level, size)\n  return { ratio, passes: ratio >= required, required, level, size }\n}\n\n/**\n * Pick whichever of `light`/`dark` reads better on `background`.\n *\n * This is the function to reach for when a component renders text over a user-supplied\n * colour, which is most of them.\n */\nexport function pickReadable(\n  background: ColorInput,\n  light: ColorInput = '#ffffff',\n  dark: ColorInput = '#0b0b0f',\n): Rgb {\n  const lightRatio = contrastRatio(light, background)\n  const darkRatio = contrastRatio(dark, background)\n  return parseColor(lightRatio >= darkRatio ? light : dark)\n}\n\n/**\n * Adjust a colour's lightness until it meets a contrast target against `background`.\n *\n * Works in OKLCH so hue and chroma survive the adjustment — the brand colour stays\n * recognisably itself, it just gets light or dark enough to read. Searches in whichever\n * direction has more headroom, and returns the best achievable colour if the target is\n * unreachable (a mid-grey background cannot support 7:1 with a saturated hue at any lightness).\n */\nexport function ensureContrast(\n  foreground: ColorInput,\n  background: ColorInput,\n  target = 4.5,\n): { color: Rgb; ratio: number; achieved: boolean } {\n  const fg = parseColor(foreground)\n  const bg = parseColor(background)\n\n  const initial = contrastRatio(fg, bg)\n  if (initial >= target) return { color: fg, ratio: initial, achieved: true }\n\n  const lch = rgbToOklch(fg)\n  const bgLuminance = relativeLuminance(bg)\n  // Move away from the background: darken against a light background, lighten against a dark one.\n  const direction = bgLuminance > 0.35 ? -1 : 1\n\n  let best = fg\n  let bestRatio = initial\n\n  // 24 steps across the available lightness range lands within ~4% of optimal, which is\n  // finer than the eye can distinguish and costs 24 cheap conversions.\n  const STEPS = 24\n  const limit = direction > 0 ? 1 - lch.l : lch.l\n\n  for (let i = 1; i <= STEPS; i++) {\n    const l = clamp(lch.l + direction * (limit * (i / STEPS)), 0, 1)\n    const candidate = oklchToRgbMapped({ l, c: lch.c, h: lch.h, alpha: fg.a })\n    const ratio = contrastRatio(candidate, bg)\n    if (ratio > bestRatio) {\n      bestRatio = ratio\n      best = candidate\n      if (ratio >= target) return { color: candidate, ratio, achieved: true }\n    }\n  }\n\n  // Last resort: drop chroma too. Desaturating buys real lightness range at the extremes.\n  for (let i = 1; i <= 8; i++) {\n    const c = lch.c * (1 - i / 8)\n    const l = direction > 0 ? 1 : 0\n    const candidate = oklchToRgbMapped({ l, c, h: lch.h, alpha: fg.a })\n    const ratio = contrastRatio(candidate, bg)\n    if (ratio > bestRatio) {\n      bestRatio = ratio\n      best = candidate\n      if (ratio >= target) return { color: candidate, ratio, achieved: true }\n    }\n  }\n\n  return { color: best, ratio: bestRatio, achieved: bestRatio >= target }\n}\n\n/**\n * Worst-case contrast of a foreground against every colour in a set.\n *\n * An animated gradient background cycles through many colours; text must be legible against\n * all of them. Components call this with their resolved palette and surface a dev warning when\n * it fails, which turns an invisible accessibility bug into a console message during development.\n */\nexport function worstContrast(\n  foreground: ColorInput,\n  backgrounds: readonly ColorInput[],\n): { ratio: number; against: Rgb | null } {\n  let worst = Infinity\n  let against: Rgb | null = null\n  for (const bg of backgrounds) {\n    const ratio = contrastRatio(foreground, bg)\n    if (ratio < worst) {\n      worst = ratio\n      against = parseColor(bg)\n    }\n  }\n  return { ratio: Number.isFinite(worst) ? worst : 21, against }\n}\n\n/**\n * APCA-style perceptual lightness, used for ordering colours by visual weight.\n *\n * Not a WCAG 3 implementation — that specification is still in flux and we won't ship a\n * moving target as if it were stable. This is OKLab's `L`, which is a better predictor of\n * perceived lightness than WCAG's relative luminance and is entirely sufficient for the\n * internal job of sorting a palette light-to-dark.\n */\nexport function perceivedLightness(color: ColorInput): number {\n  return rgbToOklch(parseColor(color)).l\n}\n"]}
+{"version":3,"sources":["../src/color/contrast.ts"],"names":["parseColor","composite","relativeLuminance","rgbToOklch","clamp","oklchToRgbMapped"],"mappings":"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","file":"chunk-PZF3YXVE.cjs","sourcesContent":["import { clamp } from '../math/scalar'\nimport { relativeLuminance, rgbToOklch } from './convert'\nimport { oklchToRgbMapped } from './gamut'\nimport { parseColor } from './parse'\nimport { composite } from './interpolate'\nimport type { ColorInput, Rgb } from './types'\n\n/**\n * Contrast and legibility.\n *\n * Animated backgrounds are the single most common way a design ends up failing WCAG: the text\n * was legible against the mockup's midpoint and illegible against the animation's brightest\n * frame. These helpers let components check contrast against the *extremes* of their own\n * palette and adapt, rather than hoping.\n */\n\nexport type WcagLevel = 'AA' | 'AAA'\nexport type TextSize = 'normal' | 'large'\n\n/**\n * WCAG 2.x contrast ratio, from 1 (identical) to 21 (black on white).\n *\n * Semi-transparent colours are composited over `background` first, because a ratio computed\n * from a colour's own alpha is meaningless — what matters is what the eye actually receives.\n */\nexport function contrastRatio(foreground: ColorInput, background: ColorInput): number {\n  const bg = parseColor(background)\n  const fgRaw = parseColor(foreground)\n  const fg = fgRaw.a < 1 ? composite(bg, fgRaw) : fgRaw\n\n  const l1 = relativeLuminance(fg)\n  const l2 = relativeLuminance(bg)\n  const lighter = Math.max(l1, l2)\n  const darker = Math.min(l1, l2)\n  return (lighter + 0.05) / (darker + 0.05)\n}\n\n/** Minimum ratio required by WCAG 2.2 for the given level and text size. */\nexport function requiredRatio(level: WcagLevel, size: TextSize): number {\n  if (level === 'AAA') return size === 'large' ? 4.5 : 7\n  return size === 'large' ? 3 : 4.5\n}\n\nexport interface ContrastResult {\n  ratio: number\n  passes: boolean\n  required: number\n  level: WcagLevel\n  size: TextSize\n}\n\n/** Check a foreground/background pair against a WCAG threshold. */\nexport function checkContrast(\n  foreground: ColorInput,\n  background: ColorInput,\n  level: WcagLevel = 'AA',\n  size: TextSize = 'normal',\n): ContrastResult {\n  const ratio = contrastRatio(foreground, background)\n  const required = requiredRatio(level, size)\n  return { ratio, passes: ratio >= required, required, level, size }\n}\n\n/**\n * Pick whichever of `light`/`dark` reads better on `background`.\n *\n * This is the function to reach for when a component renders text over a user-supplied\n * colour, which is most of them.\n */\nexport function pickReadable(\n  background: ColorInput,\n  light: ColorInput = '#ffffff',\n  dark: ColorInput = '#0b0b0f',\n): Rgb {\n  const lightRatio = contrastRatio(light, background)\n  const darkRatio = contrastRatio(dark, background)\n  return parseColor(lightRatio >= darkRatio ? light : dark)\n}\n\n/**\n * Adjust a colour's lightness until it meets a contrast target against `background`.\n *\n * Works in OKLCH so hue and chroma survive the adjustment — the brand colour stays\n * recognisably itself, it just gets light or dark enough to read. Searches in whichever\n * direction has more headroom, and returns the best achievable colour if the target is\n * unreachable (a mid-grey background cannot support 7:1 with a saturated hue at any lightness).\n */\nexport function ensureContrast(\n  foreground: ColorInput,\n  background: ColorInput,\n  target = 4.5,\n): { color: Rgb; ratio: number; achieved: boolean } {\n  const fg = parseColor(foreground)\n  const bg = parseColor(background)\n\n  const initial = contrastRatio(fg, bg)\n  if (initial >= target) return { color: fg, ratio: initial, achieved: true }\n\n  const lch = rgbToOklch(fg)\n  const bgLuminance = relativeLuminance(bg)\n  // Move away from the background: darken against a light background, lighten against a dark one.\n  const direction = bgLuminance > 0.35 ? -1 : 1\n\n  let best = fg\n  let bestRatio = initial\n\n  // 24 steps across the available lightness range lands within ~4% of optimal, which is\n  // finer than the eye can distinguish and costs 24 cheap conversions.\n  const STEPS = 24\n  const limit = direction > 0 ? 1 - lch.l : lch.l\n\n  for (let i = 1; i <= STEPS; i++) {\n    const l = clamp(lch.l + direction * (limit * (i / STEPS)), 0, 1)\n    const candidate = oklchToRgbMapped({ l, c: lch.c, h: lch.h, alpha: fg.a })\n    const ratio = contrastRatio(candidate, bg)\n    if (ratio > bestRatio) {\n      bestRatio = ratio\n      best = candidate\n      if (ratio >= target) return { color: candidate, ratio, achieved: true }\n    }\n  }\n\n  // Last resort: drop chroma too. Desaturating buys real lightness range at the extremes.\n  for (let i = 1; i <= 8; i++) {\n    const c = lch.c * (1 - i / 8)\n    const l = direction > 0 ? 1 : 0\n    const candidate = oklchToRgbMapped({ l, c, h: lch.h, alpha: fg.a })\n    const ratio = contrastRatio(candidate, bg)\n    if (ratio > bestRatio) {\n      bestRatio = ratio\n      best = candidate\n      if (ratio >= target) return { color: candidate, ratio, achieved: true }\n    }\n  }\n\n  return { color: best, ratio: bestRatio, achieved: bestRatio >= target }\n}\n\n/**\n * Worst-case contrast of a foreground against every colour in a set.\n *\n * An animated gradient background cycles through many colours; text must be legible against\n * all of them. Components call this with their resolved palette and surface a dev warning when\n * it fails, which turns an invisible accessibility bug into a console message during development.\n */\nexport function worstContrast(\n  foreground: ColorInput,\n  backgrounds: readonly ColorInput[],\n): { ratio: number; against: Rgb | null } {\n  let worst = Infinity\n  let against: Rgb | null = null\n  for (const bg of backgrounds) {\n    const ratio = contrastRatio(foreground, bg)\n    if (ratio < worst) {\n      worst = ratio\n      against = parseColor(bg)\n    }\n  }\n  return { ratio: Number.isFinite(worst) ? worst : 21, against }\n}\n\n/**\n * APCA-style perceptual lightness, used for ordering colours by visual weight.\n *\n * Not a WCAG 3 implementation — that specification is still in flux and we won't ship a\n * moving target as if it were stable. This is OKLab's `L`, which is a better predictor of\n * perceived lightness than WCAG's relative luminance and is entirely sufficient for the\n * internal job of sorting a palette light-to-dark.\n */\nexport function perceivedLightness(color: ColorInput): number {\n  return rgbToOklch(parseColor(color)).l\n}\n"]}

package/dist/{chunk-UJBXY6QC.cjs → chunk-SSAWZIO2.cjs}

@@ -1,13 +1,14 @@
 'use strict';
 
-var chunkMMO7KO53_cjs = require('./chunk-MMO7KO53.cjs');
+var chunkFNR4B3KY_cjs = require('./chunk-FNR4B3KY.cjs');
 var chunkLGA3N3YJ_cjs = require('./chunk-LGA3N3YJ.cjs');
 var chunkGJRIHN76_cjs = require('./chunk-GJRIHN76.cjs');
+var chunkFNR35HTL_cjs = require('./chunk-FNR35HTL.cjs');
 var chunkILKUL7GD_cjs = require('./chunk-ILKUL7GD.cjs');
 
 // src/behaviours/types.ts
 function mountBehaviour(definition, element, userOptions = {}) {
-  chunkMMO7KO53_cjs.getRegistry().requireCapability(definition.capability ?? "behaviour:core");
+  chunkFNR4B3KY_cjs.getRegistry().requireCapability(definition.capability ?? "behaviour:core");
   let options = { ...definition.defaults, ...stripUndefined(userOptions) };
   let instance = definition.setup(element, options);
   let destroyed = false;
@@ -33,7 +34,7 @@ function mountBehaviour(definition, element, userOptions = {}) {
   };
 }
 function defineBehaviour(definition) {
-  const registry = chunkMMO7KO53_cjs.getRegistry();
+  const registry = chunkFNR4B3KY_cjs.getRegistry();
   if (!registry.has("behaviour", definition.name)) {
     registry.register("behaviour", definition.name, definition);
   }
@@ -85,7 +86,7 @@ var magnetic = defineBehaviour({
     let opts = options;
     const target = opts.target ? element.querySelector(opts.target) ?? element : element;
     const restoreStyles = captureStyles(target, ["transform", "willChange"]);
-    const pointer = chunkMMO7KO53_cjs.trackPointer(element, { trackOutside: true, smoothing: 1e-3 });
+    const pointer = chunkFNR4B3KY_cjs.trackPointer(element, { trackOutside: true, smoothing: 1e-3 });
     let x = 0;
     let y = 0;
     let vx = 0;
@@ -94,9 +95,9 @@ var magnetic = defineBehaviour({
     let scaleVelocity = 0;
     let rotation = 0;
     let rotationVelocity = 0;
-    let motion = chunkMMO7KO53_cjs.resolveMotion(opts.reducedMotion);
+    let motion = chunkFNR4B3KY_cjs.resolveMotion(opts.reducedMotion);
     target.style.willChange = "transform";
-    const ticker = chunkMMO7KO53_cjs.getTicker();
+    const ticker = chunkFNR4B3KY_cjs.getTicker();
     const stop = ticker.add(
       ({ delta }) => {
         if (opts.disabled || !motion.animate) return;
@@ -153,7 +154,7 @@ var magnetic = defineBehaviour({
     return {
       update(next) {
         opts = { ...opts, ...next };
-        motion = chunkMMO7KO53_cjs.resolveMotion(opts.reducedMotion);
+        motion = chunkFNR4B3KY_cjs.resolveMotion(opts.reducedMotion);
         if (opts.disabled || !motion.animate) {
           x = y = vx = vy = 0;
           scaleValue = 1;
@@ -192,14 +193,14 @@ var tilt = defineBehaviour({
   setup(element, options) {
     let opts = options;
     const restoreStyles = captureStyles(element, ["transform", "transformStyle", "willChange"]);
-    const pointer = chunkMMO7KO53_cjs.trackPointer(element, { smoothing: 2e-3 });
+    const pointer = chunkFNR4B3KY_cjs.trackPointer(element, { smoothing: 2e-3 });
     let rotateX = 0;
     let rotateY = 0;
     let velocityX = 0;
     let velocityY = 0;
     let presence = 0;
     let presenceVelocity = 0;
-    let motion = chunkMMO7KO53_cjs.resolveMotion(opts.reducedMotion);
+    let motion = chunkFNR4B3KY_cjs.resolveMotion(opts.reducedMotion);
     element.style.willChange = "transform";
     element.style.transformStyle = "preserve-3d";
     let glareElement = null;
@@ -233,7 +234,7 @@ var tilt = defineBehaviour({
       glareElement = null;
     }
     ensureGlare();
-    const ticker = chunkMMO7KO53_cjs.getTicker();
+    const ticker = chunkFNR4B3KY_cjs.getTicker();
     const stop = ticker.add(
       ({ delta }) => {
         if (opts.disabled || !motion.animate) return;
@@ -279,7 +280,7 @@ var tilt = defineBehaviour({
       update(next) {
         const previousGlare = opts.glare;
         opts = { ...opts, ...next };
-        motion = chunkMMO7KO53_cjs.resolveMotion(opts.reducedMotion);
+        motion = chunkFNR4B3KY_cjs.resolveMotion(opts.reducedMotion);
         if (opts.glare !== previousGlare) ensureGlare();
         if (opts.disabled || !motion.animate) {
           rotateX = rotateY = velocityX = velocityY = 0;
@@ -344,7 +345,7 @@ var marquee = defineBehaviour({
     let offset = 0;
     let currentSpeed = 0;
     let hovering = false;
-    let motion = chunkMMO7KO53_cjs.resolveMotion(opts.reducedMotion);
+    let motion = chunkFNR4B3KY_cjs.resolveMotion(opts.reducedMotion);
     function rebuild() {
       for (const clone of clones) clone.remove();
       clones = [];
@@ -373,8 +374,8 @@ var marquee = defineBehaviour({
       element.style.setProperty("mask-image", mask);
       element.style.setProperty("-webkit-mask-image", mask);
     }
-    const stopResize = chunkMMO7KO53_cjs.observeResize(element, rebuild);
-    const stopTrackResize = chunkMMO7KO53_cjs.observeResize(track, rebuild);
+    const stopResize = chunkFNR4B3KY_cjs.observeResize(element, rebuild);
+    const stopTrackResize = chunkFNR4B3KY_cjs.observeResize(track, rebuild);
     const onEnter = () => {
       hovering = true;
     };
@@ -385,7 +386,7 @@ var marquee = defineBehaviour({
     element.addEventListener("pointerleave", onLeave, { passive: true });
     applyEdgeFade();
     rebuild();
-    const ticker = chunkMMO7KO53_cjs.getTicker();
+    const ticker = chunkFNR4B3KY_cjs.getTicker();
     const stop = ticker.add(
       ({ delta }) => {
         if (opts.disabled || !motion.animate || cycleSize <= 0) return;
@@ -407,7 +408,7 @@ var marquee = defineBehaviour({
         const previousGap = opts.gap;
         const previousFade = opts.fadeEdges;
         opts = { ...opts, ...next };
-        motion = chunkMMO7KO53_cjs.resolveMotion(opts.reducedMotion);
+        motion = chunkFNR4B3KY_cjs.resolveMotion(opts.reducedMotion);
         if (opts.gap !== previousGap) {
           track.style.gap = opts.gap ? `${opts.gap}px` : "";
           rebuild();
@@ -795,7 +796,7 @@ var scrollReveal = defineBehaviour({
       target.time = 0;
       applyProgress(target, 0);
     }
-    const ticker = chunkMMO7KO53_cjs.getTicker();
+    const ticker = chunkFNR4B3KY_cjs.getTicker();
     function startTicker() {
       if (stopTicker) return;
       stopTicker = ticker.add(
@@ -830,12 +831,12 @@ var scrollReveal = defineBehaviour({
       );
     }
     collectTargets();
-    const skipAnimation = opts.disabled || chunkMMO7KO53_cjs.prefersReducedMotion() && opts.reducedMotion !== "none";
+    const skipAnimation = opts.disabled || chunkFNR4B3KY_cjs.prefersReducedMotion() && opts.reducedMotion !== "none";
     if (!skipAnimation) {
       for (const target of targets) hide(target);
     }
     const stopObserver = skipAnimation ? () => {
-    } : chunkMMO7KO53_cjs.observeIntersection(
+    } : chunkFNR4B3KY_cjs.observeIntersection(
       element,
       (entry) => {
         if (entry.isIntersecting) {
@@ -904,7 +905,7 @@ var parallax = defineBehaviour({
     let containerSize = 0;
     let needsMeasure = true;
     let currentTranslate = 0;
-    let motion = chunkMMO7KO53_cjs.resolveMotion(opts.reducedMotion);
+    let motion = chunkFNR4B3KY_cjs.resolveMotion(opts.reducedMotion);
     element.style.willChange = "transform";
     function measure() {
       const rect = element.getBoundingClientRect();
@@ -925,10 +926,10 @@ var parallax = defineBehaviour({
       needsMeasure = true;
     };
     window.addEventListener("resize", invalidate, { passive: true });
-    const stopResize = chunkMMO7KO53_cjs.observeResize(element, invalidate);
+    const stopResize = chunkFNR4B3KY_cjs.observeResize(element, invalidate);
     let scroll = 0;
     let progress = 0;
-    const ticker = chunkMMO7KO53_cjs.getTicker();
+    const ticker = chunkFNR4B3KY_cjs.getTicker();
     const stopRead = ticker.add(
       () => {
         if (opts.disabled || !motion.animate) return;
@@ -981,7 +982,7 @@ var parallax = defineBehaviour({
     return {
       update(next) {
         opts = { ...opts, ...next };
-        motion = chunkMMO7KO53_cjs.resolveMotion(opts.reducedMotion);
+        motion = chunkFNR4B3KY_cjs.resolveMotion(opts.reducedMotion);
         needsMeasure = true;
         if (opts.disabled || !motion.animate) {
           element.style.transform = "";
@@ -1039,7 +1040,7 @@ var ripple = defineBehaviour({
     element.appendChild(layer);
     const active = [];
     let stopTicker = null;
-    const ticker = chunkMMO7KO53_cjs.getTicker();
+    const ticker = chunkFNR4B3KY_cjs.getTicker();
     function resolveColor() {
       const raw = opts.color;
       if (raw === "currentColor") {
@@ -1097,7 +1098,7 @@ var ripple = defineBehaviour({
       if (stopTicker) return;
       stopTicker = ticker.add(
         ({ delta }) => {
-          const scale = chunkMMO7KO53_cjs.prefersReducedMotion() && opts.reducedMotion === "slow" ? 0.4 : 1;
+          const scale = chunkFNR4B3KY_cjs.prefersReducedMotion() && opts.reducedMotion === "slow" ? 0.4 : 1;
           const duration = Math.max(0.01, opts.duration * scale);
           const fade = Math.max(0, opts.fadeDuration * scale);
           const total = duration + fade;
@@ -1156,6 +1157,125 @@ var ripple = defineBehaviour({
   }
 });
 
+// src/behaviours/text-scramble.ts
+var DEFAULTS8 = {
+  intensity: 1,
+  // `static` rather than `slow`: the churn is high-frequency flicker in the reader's focal area,
+  // which is exactly the kind of motion the preference exists to suppress. Reduced-motion users
+  // get the finished text immediately.
+  reducedMotion: "static",
+  disabled: false,
+  chars: "!<>-_\\/[]{}\u2014=+*^?#________",
+  duration: 0.55,
+  stagger: 0.035,
+  cycleSpeed: 26,
+  trigger: "view",
+  repeat: false,
+  threshold: 0.3,
+  seed: 1
+};
+var textScramble = defineBehaviour({
+  name: "text-scramble",
+  defaults: DEFAULTS8,
+  setup(element, options) {
+    let opts = options;
+    const original = element.textContent ?? "";
+    const length = original.length;
+    const pool = opts.chars.length > 0 ? opts.chars : DEFAULTS8.chars;
+    const rng = chunkFNR35HTL_cjs.createRng(opts.seed);
+    const current = Array.from(original);
+    const lastTick = new Int32Array(Math.max(1, length));
+    let elapsed = 0;
+    let running = false;
+    let hasRun = false;
+    let stopFrame = null;
+    const isWhitespace = (character) => character.trim() === "";
+    const totalDuration = () => Math.max(0, length - 1) * opts.stagger + opts.duration;
+    function writeFinal() {
+      element.textContent = original;
+    }
+    function stopFrames() {
+      stopFrame?.();
+      stopFrame = null;
+      running = false;
+    }
+    function run() {
+      if (opts.disabled) return;
+      if (hasRun && !opts.repeat) return;
+      const motion = chunkFNR4B3KY_cjs.resolveMotion(opts.reducedMotion);
+      if (!motion.animate) {
+        hasRun = true;
+        writeFinal();
+        return;
+      }
+      hasRun = true;
+      elapsed = 0;
+      lastTick.fill(-1);
+      running = true;
+      if (stopFrame) return;
+      const ticker = chunkFNR4B3KY_cjs.getTicker();
+      stopFrame = ticker.add(
+        ({ delta }) => {
+          if (!running || opts.disabled) return;
+          elapsed += delta * motion.timeScale * opts.intensity;
+          const total = totalDuration();
+          if (elapsed >= total) {
+            writeFinal();
+            stopFrames();
+            return;
+          }
+          const tick = Math.floor(elapsed * opts.cycleSpeed);
+          for (let i = 0; i < length; i++) {
+            const character = original[i];
+            if (isWhitespace(character)) continue;
+            if (elapsed >= i * opts.stagger + opts.duration) {
+              current[i] = character;
+              continue;
+            }
+            if (lastTick[i] !== tick) {
+              lastTick[i] = tick;
+              current[i] = pool[rng.int(0, pool.length - 1)];
+            }
+          }
+          element.textContent = current.join("");
+        },
+        { phase: "write" }
+      );
+    }
+    let stopObserver = null;
+    let detachHover = null;
+    if (chunkFNR4B3KY_cjs.prefersReducedMotion() && opts.reducedMotion === "static") ; else if (opts.trigger === "mount") {
+      run();
+    } else if (opts.trigger === "hover") {
+      const onEnter = () => run();
+      element.addEventListener("pointerenter", onEnter);
+      detachHover = () => element.removeEventListener("pointerenter", onEnter);
+    } else {
+      stopObserver = chunkFNR4B3KY_cjs.observeIntersection(
+        element,
+        (entry) => {
+          if (entry.isIntersecting) run();
+          else if (opts.repeat) hasRun = false;
+        },
+        { threshold: opts.threshold }
+      );
+    }
+    return {
+      update(next) {
+        opts = { ...opts, ...next };
+      },
+      destroy() {
+        stopFrames();
+        stopObserver?.();
+        detachHover?.();
+        stopObserver = null;
+        detachHover = null;
+        writeFinal();
+      }
+    };
+  }
+});
+
 // src/behaviours/index.ts
 var behaviours = {
   magnetic,
@@ -1164,7 +1284,8 @@ var behaviours = {
   "split-text": splitText,
   "scroll-reveal": scrollReveal,
   parallax,
-  ripple
+  ripple,
+  "text-scramble": textScramble
 };
 
 exports.behaviours = behaviours;
@@ -1181,6 +1302,7 @@ exports.split = split;
 exports.splitText = splitText;
 exports.stagger = stagger;
 exports.staggerDuration = staggerDuration;
+exports.textScramble = textScramble;
 exports.tilt = tilt;
-//# sourceMappingURL=chunk-UJBXY6QC.cjs.map
-//# sourceMappingURL=chunk-UJBXY6QC.cjs.map
+//# sourceMappingURL=chunk-SSAWZIO2.cjs.map
+//# sourceMappingURL=chunk-SSAWZIO2.cjs.map