@rootnative/inertia 0.0.0-alpha.2 → 0.0.0-alpha.4

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@rootnative/inertia` are documented here. The format fol
 
 ## [Unreleased]
 
+## [0.0.0-alpha.2] - 2026-07-20
+
+### Added
+
+- **`useGestureLayer` returns per-state progress** — the result now carries `states: GestureLayerProgress`, the five 0↔1 progress shared values behind the composed style (`hovered` / `focused` / `focusVisible` / `pressed` from the underlying `useGesture`, plus the hook-owned `disabled` progress). Lets styles derived from the same gesture wiring — an elevation crossfade via `useShadow({ from, to, progress: states.hovered })`, an icon tint — reuse the hook's progress values instead of duplicating the cascade through a parallel `useGesture` call. Purely additive; the exposed shared values are identity-stable across renders and are the same objects the worklet reads (treat as read-only — the handlers own the writes). The `GestureLayerProgress` type is exported from the `/gesture-layer` subpath.
+
+### Changed
+
+- Published bundles no longer include sourcemaps, and the `__type-tests__` directories are excluded from the npm package (packaging-only; no runtime change).
+
+## [0.0.0-alpha.1] - 2026-07-19
+
 ### Added
 
 - **Named transition registry** — `<MotionConfig transitions={{ name: TransitionConfig }}>` registers named transitions for the subtree; the name is accepted everywhere a `TransitionConfig` is: the `transition` prop (top-level, per-property, per gesture layer), the `layout` prop, and `useAnimation` / `useSpring` / `useBooleanSpring` / `useGesture` / `useGestureLayer`. Names resolve at the nearest provider; nested providers merge with child-overrides-per-name; unknown names warn in dev and fall back to the default spring. No presets ship — names are consumer vocabulary. New exports: `useNamedTransitions()`, `resolveNamedTransition()`, and the `TransitionName` / `TransitionInput` / `NamedTransitions` / `RegisteredTransitions` types (`RegisteredTransitions` is the augmentation point for compile-time-typed names).
@@ -39,5 +51,7 @@ Initial alpha publish. The full v0.1 surface is in place; APIs are still subject
 - SVG path morphing, gradient interpolation, and shared-element transitions across screens are out of scope until `0.2.x` / `1.x` per the roadmap.
 - `react-native-gesture-handler` integration (drag, pan, swipe sub-states) lands in `0.2` via the optional `@rootnative/inertia-gestures` adapter.
 
-[unreleased]: https://github.com/rootnative/inertia/compare/v0.0.0-alpha.0...HEAD
+[unreleased]: https://github.com/rootnative/inertia/compare/core+gestures+gradients+svg@0.0.0-alpha.2...HEAD
+[0.0.0-alpha.2]: https://github.com/rootnative/inertia/releases/tag/core+gestures+gradients+svg@0.0.0-alpha.2
+[0.0.0-alpha.1]: https://github.com/rootnative/inertia/releases/tag/core+gestures+gradients+svg@0.0.0-alpha.1
 [0.0.0-alpha.0]: https://github.com/rootnative/inertia/releases/tag/v0.0.0-alpha.0

package/dist/chunk-5I3G43XA.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var chunk6UQ4KA6V_js = require('./chunk-6UQ4KA6V.js');
+var reactNative = require('react-native');
+
+var MotionScrollView = chunk6UQ4KA6V_js.createMotionComponent(reactNative.ScrollView);
+
+exports.MotionScrollView = MotionScrollView;

package/dist/chunk-6EP3S2PN.js

@@ -0,0 +1,113 @@
+'use strict';
+
+var chunkSFRNO6AW_js = require('./chunk-SFRNO6AW.js');
+var react = require('react');
+var reactNativeReanimated = require('react-native-reanimated');
+var jsxRuntime = require('react/jsx-runtime');
+var reactNative = require('react-native');
+
+var DEFAULT_MOTION_CONFIG = {
+  reducedMotion: "user",
+  transitions: {}
+};
+var MotionConfigContext = react.createContext(
+  DEFAULT_MOTION_CONFIG
+);
+function useMotionConfig() {
+  return react.useContext(MotionConfigContext);
+}
+function useNamedTransitions() {
+  return useMotionConfig().transitions;
+}
+function useShouldReduceMotion() {
+  const { reducedMotion } = useMotionConfig();
+  const osReduced = reactNativeReanimated.useReducedMotion();
+  if (reducedMotion === "never") return false;
+  if (reducedMotion === "always") return true;
+  return osReduced;
+}
+function MotionConfig({
+  reducedMotion,
+  transitions,
+  children
+}) {
+  const parent = useMotionConfig();
+  const transitionsSig = chunkSFRNO6AW_js.stableSig(transitions);
+  const value = react.useMemo(
+    () => ({
+      reducedMotion: reducedMotion ?? parent.reducedMotion,
+      transitions: transitions ? { ...parent.transitions, ...transitions } : parent.transitions
+    }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [reducedMotion, transitionsSig, parent]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(MotionConfigContext.Provider, { value, children });
+}
+
+// src/config/namedTransitions.ts
+var UNKNOWN_NAME_FALLBACK = { type: "spring" };
+function lookupNamedTransition(name, registry) {
+  const cfg = registry[name];
+  if (cfg) return cfg;
+  if (__DEV__) {
+    console.warn(
+      `[inertia] Unknown transition name "${name}" \u2014 falling back to the default spring. Register it on a provider: <MotionConfig transitions={{ '${name}': { ... } }}>.`
+    );
+  }
+  return UNKNOWN_NAME_FALLBACK;
+}
+function resolveNamedTransition(input, registry) {
+  if (input === void 0) return void 0;
+  if (typeof input === "string") return lookupNamedTransition(input, registry);
+  return input;
+}
+function resolveNamedTransitionProp(transition, registry) {
+  if (transition === void 0) return void 0;
+  if (typeof transition === "string") {
+    return lookupNamedTransition(transition, registry);
+  }
+  if (chunkSFRNO6AW_js.isTopLevelTransition(transition)) return transition;
+  const map = transition;
+  let out = null;
+  for (const key in map) {
+    const value = map[key];
+    if (typeof value === "string") {
+      if (out === null) out = { ...map };
+      out[key] = lookupNamedTransition(value, registry);
+    }
+  }
+  return out ?? transition;
+}
+var modality = "keyboard";
+var installed = false;
+function setKeyboard() {
+  modality = "keyboard";
+}
+function setPointer() {
+  modality = "pointer";
+}
+function ensureInstalled() {
+  if (installed) return;
+  if (reactNative.Platform.OS !== "web") return;
+  if (typeof document === "undefined") return;
+  document.addEventListener("keydown", setKeyboard, true);
+  document.addEventListener("mousedown", setPointer, true);
+  document.addEventListener("pointerdown", setPointer, true);
+  document.addEventListener("touchstart", setPointer, true);
+  installed = true;
+}
+ensureInstalled();
+function isFocusVisible() {
+  if (reactNative.Platform.OS !== "web") return true;
+  ensureInstalled();
+  return modality === "keyboard";
+}
+
+exports.MotionConfig = MotionConfig;
+exports.isFocusVisible = isFocusVisible;
+exports.lookupNamedTransition = lookupNamedTransition;
+exports.resolveNamedTransition = resolveNamedTransition;
+exports.resolveNamedTransitionProp = resolveNamedTransitionProp;
+exports.useMotionConfig = useMotionConfig;
+exports.useNamedTransitions = useNamedTransitions;
+exports.useShouldReduceMotion = useShouldReduceMotion;

package/dist/chunk-6FENLMCA.mjs

@@ -0,0 +1,257 @@
+import { isWorkletFunction } from 'react-native-worklets';
+import { withSequence, Easing, withDecay, withTiming, withSpring, withRepeat, withDelay } from 'react-native-reanimated';
+
+// src/transitions/easing.ts
+function ensureWorkletEasing(easing) {
+  if (!easing) return void 0;
+  const fn = isEasingFactory(easing) ? easing.factory() : easing;
+  if (isWorkletFunction(fn)) return fn;
+  const wrapped = (t) => {
+    "worklet";
+    return fn(t);
+  };
+  return wrapped;
+}
+function isEasingFactory(value) {
+  return typeof value === "object" && value !== null && "factory" in value && typeof value.factory === "function";
+}
+
+// src/transitions/spring.ts
+var DEFAULT_SPRING = {
+  tension: 170,
+  friction: 26,
+  mass: 1
+};
+function springToReanimated(t) {
+  "worklet";
+  return {
+    stiffness: t.tension ?? DEFAULT_SPRING.tension,
+    damping: t.friction ?? DEFAULT_SPRING.friction,
+    mass: t.mass ?? DEFAULT_SPRING.mass,
+    velocity: t.velocity,
+    restSpeedThreshold: t.restSpeedThreshold,
+    restDisplacementThreshold: t.restDisplacementThreshold
+  };
+}
+
+// src/transitions/resolve.ts
+var DEFAULT_TIMING_DURATION = 250;
+function buildSpring(cfg, toValue, cb) {
+  return withSpring(toValue, springToReanimated(cfg), cb);
+}
+function buildTiming(cfg, toValue, cb) {
+  return withTiming(
+    toValue,
+    {
+      duration: cfg.duration ?? DEFAULT_TIMING_DURATION,
+      easing: ensureWorkletEasing(cfg.easing) ?? Easing.inOut(Easing.ease)
+    },
+    cb
+  );
+}
+function buildDecay(cfg, cb) {
+  return withDecay(
+    {
+      velocity: cfg.velocity ?? 0,
+      deceleration: cfg.deceleration,
+      clamp: cfg.clamp
+    },
+    cb
+  );
+}
+function buildOne(cfg, toValue, cb) {
+  if (cfg.type === "no-animation") {
+    if (cb) cb(true, toValue);
+    return toValue;
+  }
+  if (cfg.type === "decay") return buildDecay(cfg, cb);
+  if (cfg.type === "timing") return buildTiming(cfg, toValue, cb);
+  return buildSpring(cfg, toValue, cb);
+}
+function applyRepeat(animation, repeat) {
+  if (repeat === void 0) return animation;
+  if (repeat === "infinite") {
+    return withRepeat(animation, -1, true);
+  }
+  if (typeof repeat === "number") {
+    return withRepeat(animation, repeat, true);
+  }
+  const count = repeat.count === "infinite" ? -1 : repeat.count;
+  const alternate = repeat.alternate ?? true;
+  return withRepeat(animation, count, alternate);
+}
+function applyDelay(animation, delay) {
+  if (!delay || delay <= 0) return animation;
+  return withDelay(delay, animation);
+}
+function resolveTransition(config, toValue, callback) {
+  const cfg = config ?? { type: "spring" };
+  const base = buildOne(cfg, toValue, callback);
+  const repeated = applyRepeat(base, repeatOf(cfg));
+  return applyDelay(repeated, delayOf(cfg));
+}
+function repeatOf(cfg) {
+  if (cfg.type === "no-animation" || cfg.type === "decay") return void 0;
+  return cfg.repeat;
+}
+function stripRepeat(cfg) {
+  if (!cfg) return cfg;
+  if (cfg.type === "no-animation" || cfg.type === "decay") return cfg;
+  if (cfg.repeat === void 0) return cfg;
+  const next = { ...cfg };
+  delete next.repeat;
+  return next;
+}
+function delayOf(cfg) {
+  if (cfg.type === "no-animation") return void 0;
+  return cfg.delay;
+}
+function isStepObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v) && "to" in v;
+}
+function resolveAnimatableValue(value, base, factory) {
+  if (Array.isArray(value)) {
+    const steps = value;
+    const stepBase = stripRepeat(base);
+    const animations = steps.map(
+      (step2, i) => resolveStep(step2, stepBase, factory?.("step", i))
+    );
+    const seq = withSequence(...animations);
+    return applyRepeat(seq, base ? repeatOf(base) : void 0);
+  }
+  const step = value;
+  const cb = factory?.("animation", void 0);
+  if (isStepObject(step)) {
+    return resolveStep(step, base, cb);
+  }
+  return resolveTransition(base, step, cb);
+}
+function resolveStep(step, base, cb) {
+  if (isStepObject(step)) {
+    const { to, ...override } = step;
+    const merged = mergeTransition(base, override);
+    return resolveTransition(merged, to, cb);
+  }
+  return resolveTransition(base, step, cb);
+}
+function mergeTransition(base, override) {
+  if (override.type && base && override.type !== base.type) {
+    return override;
+  }
+  return { ...base ?? { type: "spring" }, ...override };
+}
+var CSS_KEYWORDS = {
+  ease: [0.25, 0.1, 0.25, 1],
+  "ease-in": [0.42, 0, 1, 1],
+  "ease-out": [0, 0, 0.58, 1],
+  "ease-in-out": [0.42, 0, 0.58, 1]
+};
+var CSS_FUNCTION = /^cubic-bezier\((.*)\)$/;
+function cubicBezier(first, y1, x2, y2) {
+  if (typeof first === "string") return fromCss(first);
+  return bezier(first, y1, x2, y2, void 0);
+}
+function fromCss(input) {
+  const token = input.trim().toLowerCase();
+  if (token === "linear") return Easing.linear;
+  const keyword = CSS_KEYWORDS[token];
+  if (keyword) return bezier(...keyword, input);
+  const match = CSS_FUNCTION.exec(token);
+  if (!match) {
+    throw new Error(
+      `[inertia] cubicBezier: unsupported easing token ${JSON.stringify(input)}. Expected four numbers, a 'cubic-bezier(x1, y1, x2, y2)' string, or one of the CSS keywords 'linear' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out'.`
+    );
+  }
+  const parts = match[1].split(",").map((p) => Number(p.trim()));
+  if (parts.length !== 4 || parts.some((n) => !Number.isFinite(n))) {
+    throw new Error(
+      `[inertia] cubicBezier: could not parse ${JSON.stringify(input)} \u2014 expected exactly four finite numbers inside cubic-bezier(...).`
+    );
+  }
+  return bezier(parts[0], parts[1], parts[2], parts[3], input);
+}
+function bezier(x1, y1, x2, y2, source) {
+  const describe = () => source !== void 0 ? JSON.stringify(source) : `cubicBezier(${x1}, ${y1}, ${x2}, ${y2})`;
+  for (const n of [x1, y1, x2, y2]) {
+    if (typeof n !== "number" || !Number.isFinite(n)) {
+      throw new Error(
+        `[inertia] cubicBezier: ${describe()} \u2014 every control point must be a finite number.`
+      );
+    }
+  }
+  if (x1 < 0 || x1 > 1 || x2 < 0 || x2 > 1) {
+    throw new Error(
+      `[inertia] cubicBezier: ${describe()} \u2014 x1 and x2 must be within [0, 1] (got x1=${x1}, x2=${x2}).`
+    );
+  }
+  return Easing.bezier(x1, y1, x2, y2);
+}
+var DEFAULT_TIMING_DURATION2 = 250;
+function buildReleaseAnimation(transition, toValue) {
+  "worklet";
+  if (transition.type === "no-animation") return toValue;
+  if (transition.type === "decay") {
+    const cfg = { velocity: transition.velocity ?? 0 };
+    if (transition.deceleration !== void 0) {
+      cfg.deceleration = transition.deceleration;
+    }
+    if (transition.clamp !== void 0) cfg.clamp = transition.clamp;
+    return withDecay(cfg);
+  }
+  if (transition.type === "timing") {
+    const e = transition.easing;
+    const easingFn = e && typeof e === "object" && "factory" in e ? e.factory() : e ?? Easing.inOut(Easing.ease);
+    return withTiming(toValue, {
+      duration: transition.duration ?? DEFAULT_TIMING_DURATION2,
+      easing: easingFn
+    });
+  }
+  return withSpring(toValue, springToReanimated(transition));
+}
+
+// src/transitions/keys.ts
+var TRANSITION_CONFIG_KEYS = /* @__PURE__ */ new Set([
+  "type",
+  "tension",
+  "friction",
+  "mass",
+  "velocity",
+  "restSpeedThreshold",
+  "restDisplacementThreshold",
+  "duration",
+  "easing",
+  "delay",
+  "repeat",
+  "deceleration",
+  "clamp"
+]);
+function isTopLevelTransition(t) {
+  if (t === null || typeof t !== "object") return false;
+  const keys = Object.keys(t);
+  if (keys.length === 0) return false;
+  return keys.every((k) => TRANSITION_CONFIG_KEYS.has(k));
+}
+
+// src/transitions/sig.ts
+function stableSig(value) {
+  if (value === void 0) return "";
+  try {
+    return stableStringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function stableStringify(v) {
+  if (v === null || typeof v !== "object") {
+    if (typeof v === "function" || v === void 0) return "null";
+    return JSON.stringify(v);
+  }
+  if (Array.isArray(v)) {
+    return "[" + v.map(stableStringify).join(",") + "]";
+  }
+  const obj = v;
+  const keys = Object.keys(obj).sort();
+  return "{" + keys.map((k) => JSON.stringify(k) + ":" + stableStringify(obj[k])).join(",") + "}";
+}
+
+export { DEFAULT_SPRING, buildReleaseAnimation, cubicBezier, ensureWorkletEasing, isTopLevelTransition, resolveAnimatableValue, resolveTransition, springToReanimated, stableSig };