fancy-ui-react 0.3.0 → 0.4.0

package/dist/internals/motion/presence.js

@@ -3,162 +3,7 @@ import { useState } from "react";
 import { useConstant, useIsomorphicLayoutEffect } from "../dom/ssr.js";
 import { useEventCallback } from "../dom/use-event-callback.js";
 import { useLiveRef } from "../dom/use-live-ref.js";
-import { runTransition } from "./animate.js";
-const DEFAULT_KEY = "default";
-function createPresenceCore(deps) {
-  const slots = /* @__PURE__ */ new Map();
-  let leg = null;
-  let starting = false;
-  let inertApplied = false;
-  let firstRun = true;
-  function ensureSlot(key) {
-    const existing = slots.get(key);
-    if (existing) return existing;
-    const slot = {
-      node: null,
-      buildSpec: null,
-      run: void 0,
-      legTo: null,
-      finished: false,
-      pendingLeg: null,
-      // Block body, never a concise arrow: React 19 reads a returned value
-      // as a cleanup function (convention C-3).
-      ref: (node) => {
-        if (node) {
-          slot.node = node;
-          const pending = slot.pendingLeg;
-          slot.pendingLeg = null;
-          if (pending !== null && leg === pending) startSlot(slot, pending);
-          return;
-        }
-        slot.pendingLeg = leg !== null && !slot.finished ? leg : null;
-        slot.run?.abort();
-        slot.run = void 0;
-        slot.node = null;
-        slot.legTo = null;
-        slot.finished = false;
-      }
-    };
-    slots.set(key, slot);
-    return slot;
-  }
-  function register(a, b, c) {
-    const keyed = typeof a === "string";
-    const slot = ensureSlot(keyed ? a : DEFAULT_KEY);
-    const transition = keyed ? b : a;
-    const params = keyed ? c : b;
-    slot.buildSpec = (node, entering) => {
-      const resolved = typeof params === "function" ? params(entering) : params;
-      return transition(node, resolved, { direction: entering ? "in" : "out" });
-    };
-    return slot.ref;
-  }
-  function startSlot(slot, to) {
-    const node = slot.node;
-    const buildSpec = slot.buildSpec;
-    if (!node || !buildSpec) return;
-    const counterpart = slot.run;
-    slot.legTo = to;
-    slot.finished = false;
-    slot.run = void 0;
-    const handle = { current: void 0 };
-    const run = runTransition(node, buildSpec(node, to === 1), to, counterpart, () => {
-      slot.finished = true;
-      if (to === 1) {
-        handle.current?.abort();
-        slot.run = void 0;
-      }
-      settle(to);
-    });
-    handle.current = run;
-    if (!slot.finished) slot.run = run;
-  }
-  function startLegs(to) {
-    starting = true;
-    try {
-      for (const slot of slots.values()) {
-        if (!slot.node) continue;
-        if (slot.legTo === to) continue;
-        startSlot(slot, to);
-      }
-    } finally {
-      starting = false;
-    }
-    settle(to);
-  }
-  function settle(to) {
-    if (starting) return;
-    if (leg !== to) return;
-    for (const slot of slots.values()) {
-      if (!slot.node) continue;
-      if (slot.legTo !== to || !slot.finished) return;
-    }
-    leg = null;
-    if (to === 1) {
-      deps.setState("open");
-      deps.onEnterEnd();
-      return;
-    }
-    deps.setMounted(false);
-    deps.setState("open");
-    deps.onExitEnd();
-  }
-  function beginEnter() {
-    leg = 1;
-    if (inertApplied) {
-      inertApplied = false;
-      for (const slot of slots.values()) {
-        slot.node?.toggleAttribute("inert", false);
-      }
-    }
-    deps.setState("opening");
-    deps.onEnterStart();
-  }
-  function beginExit() {
-    leg = 0;
-    deps.onExitStart();
-    deps.setState("closing");
-    if (deps.inertRef.current) {
-      inertApplied = true;
-      for (const slot of slots.values()) {
-        slot.node?.toggleAttribute("inert", true);
-      }
-    }
-  }
-  function sync(open, mounted, appear) {
-    const first = firstRun;
-    firstRun = false;
-    if (open) {
-      if (!mounted) {
-        beginEnter();
-        deps.setMounted(true);
-        return;
-      }
-      if (first && !appear) {
-        return;
-      }
-      if (leg !== 1) beginEnter();
-      startLegs(1);
-      return;
-    }
-    if (!mounted) return;
-    if (leg !== 0) beginExit();
-    startLegs(0);
-  }
-  function teardown() {
-    for (const slot of slots.values()) {
-      slot.run?.abort();
-      slot.run = void 0;
-      slot.legTo = null;
-      slot.finished = false;
-      slot.pendingLeg = null;
-    }
-    leg = null;
-    inertApplied = false;
-    firstRun = true;
-  }
-  return { register, sync, teardown };
-}
+import { createPresenceCore } from "./presence-core.js";
 function usePresence(open, options = {}) {
   const { appear = false, inert = true } = options;
   const [mounted, setMounted] = useState(open);

package/dist/internals/motion/raf.d.ts

@@ -1,7 +1,7 @@
 /**
  * Trailing-edge rAF throttle, generalized from the hand-rolled
  * `if (id) cancelAnimationFrame(id); id = requestAnimationFrame(...)` pattern
- * already duplicated in this library (GlowingEffect's pointer sampling). Magnetic
+ * already duplicated in this repo (GlowingEffect's pointer sampling). Magnetic
  * (pointermove) and ScrollProgress (scroll/resize) both need "run at most
  * once per frame, with the freshest data" — this is that primitive, pulled
  * out once instead of re-hand-rolled a third and fourth time.

package/dist/internals/motion/stagger.d.ts

@@ -4,10 +4,9 @@
  * so "stagger from the center" or "stagger from the last item" means the
  * same thing everywhere in this family.
  *
- * Deliberately pure: no DOM, no timers, no side effects, no hook. A caller
- * is expected to call this once per item straight from the render path and
- * write the result into a CSS custom property or a transition `delay` param
- * — this file never schedules anything itself.
+ * Deliberately pure: no DOM, no timers, no side effects. A caller is expected
+ * to call this once per item and write the result into a CSS custom property
+ * or a transition `delay` param — this file never schedules anything itself.
  */
 export type StaggerFrom = "first" | "last" | "center" | number;
 /**

package/dist/internals/motion/tokens.js

@@ -7,11 +7,15 @@ const DURATIONS = {
   exit: 200,
   entrance: 600
 };
+const EASINGS = {
+  out: "cubic-bezier(0.16, 1, 0.3, 1)"
+};
 const JS_EASINGS = { out: expoOut, in: expoIn };
 const STAGGERS = { char: 15 };
 const STAGGER_CAPS = { text: 200, item: 600 };
 export {
   DURATIONS,
+  EASINGS,
   JS_EASINGS,
   STAGGERS,
   STAGGER_CAPS

package/dist/internals/motion/transitions.d.ts

@@ -5,20 +5,20 @@
  *
  * How the `easing` param actually reaches the screen is worth spelling out,
  * because it is easy to assume `css(t, u)` needs to apply the curve itself:
- * it does not. The sampler in `animate.ts` (`runTransition`) samples every
- * keyframe as `t = t1 + delta * easing(i / n)` BEFORE `css(t, 1 - t)` is
- * ever called — so the `t`/`u` a `css()` function receives are ALREADY
- * eased, and the curve lives entirely in the sample POSITIONS rather than in
- * a WAAPI `easing` option. `preset()` below does the same as the framework
- * built-ins it mirrors: `easing` is resolved once and returned as-is on the
- * spec; `cssFor` never touches it.
+ * it does not. Whichever runtime plays the transition samples every keyframe
+ * as `t = t1 + delta * easing(i / n)` BEFORE `css(t, 1 - t)` is ever called —
+ * so the `t`/`u` a `css()` function receives are ALREADY eased, and the curve
+ * lives entirely in the sample POSITIONS rather than in a WAAPI `easing`
+ * option. `preset()` below does the same as the framework built-ins it
+ * mirrors: `easing` is resolved once and returned as-is on the spec; `cssFor`
+ * never touches it.
  */
 import { type PresetName } from "./presets.js";
 /**
  * One transition's timing plus its per-frame CSS. Structurally identical to
- * the framework `TransitionConfig` the Svelte side imports, declared locally
- * so this package takes no runtime dependency on it. The `tick` field is
- * omitted: nothing in this library uses it.
+ * the `TransitionConfig` a framework transition runtime consumes, declared
+ * locally so this shared core takes no dependency on any one framework's
+ * types. The `tick` field is omitted: nothing in this library uses it.
  */
 export interface TransitionSpec {
     delay: number;
@@ -31,7 +31,7 @@ export interface TransitionSpec {
 }
 export type TransitionDirection = "in" | "out" | "both";
 /** A transition function's shape, preserved exactly — including the unused
- *  first parameter, so the existing test files transpose 1:1. */
+ *  first parameter, so the colocated test files transpose 1:1. */
 export type TransitionFn<P = unknown> = (node: Element, params?: P, options?: {
     direction: TransitionDirection;
 }) => TransitionSpec;
@@ -46,12 +46,12 @@ export interface PresetParams {
 }
 /**
  * Returns a transition function for the named preset, ready to hand to
- * `usePresence`. Resolution order for every param is caller-supplied
- * `params` → this function's own defaults; `duration` defaults to
- * `DURATIONS.base` and `distance` to 16px regardless of direction (a
- * component that wants a shorter/half-distance EXIT, like Presence, passes
- * those explicitly in its own `out`-side params — this factory does not
- * guess at that asymmetry).
+ * whichever presence/transition mechanism the host framework provides.
+ * Resolution order for every param is caller-supplied `params` → this
+ * function's own defaults; `duration` defaults to `DURATIONS.base` and
+ * `distance` to 16px regardless of direction (a component that wants a
+ * shorter/half-distance EXIT, like Presence, passes those explicitly in its
+ * own `out`-side params — this factory does not guess at that asymmetry).
  *
  * `easing` is the one default that DOES read `options.direction`: with no
  * explicit `params.easing`, an `"out"`-direction instance (an exit-only

package/dist/internals/motion/types.d.ts

@@ -1,12 +1,11 @@
 /**
  * Type-only aggregate of the shared unions component prop interfaces need to
- * reference. Re-exported from the package barrel as
- * `export type * from "./internals/motion/types.js"` (the barrel's edit, not
- * this file's) so a component's own `<ComponentName>Props` can `import type`
- * these from one place instead of reaching into individual foundation files
- * — and, per the common contract, so a component's `index.ts` barrel never
- * has to re-export a type itself (which would risk a name collision across
- * the ten components' barrels).
+ * reference. Re-exported from the package barrel with a wholesale
+ * `export type *` (the barrel's edit, not this file's) so a component's own
+ * `<ComponentName>Props` can `import type` these from one place instead of
+ * reaching into individual foundation files — and, per the common contract,
+ * so a component's `index.ts` barrel never has to re-export a type itself
+ * (which would risk a name collision across the ten components' barrels).
  *
  * `verbatimModuleSyntax` (this package's tsconfig) means every line here is
  * `export type` and compiles to nothing at runtime — this module has zero

package/dist/internals/relative-time.d.ts

@@ -8,7 +8,7 @@ export interface RelativeTimeOptions {
     locale?: string;
     /**
      * Epoch ms to measure against. Defaults to `Date.now()`. A non-finite
-     * value (the `useNow` "clock not started" sentinel) yields `""`.
+     * value (a shared clock's "not started yet" sentinel) yields `""`.
      */
     now?: number;
     /** Defaults to `"auto"`, which yields idiomatic words ("now", "yesterday"). */