@hewnui/motion 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Himanshu Kumar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @hewnui/motion
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Shared motion tokens and reduced-motion-aware primitives (`full`, `reduced`, `off`) used by Hewn components.
+
+Part of [Hewn](https://hewnui.dev).
+
+## Install
+
+```bash
+pnpm add @hewnui/motion
+```
+
+## Usage
+
+```ts
+import { resolveMotionMode, durations } from "@hewnui/motion";
+```
+
+## Modes
+
+| Mode | Meaning |
+|---|---|
+| `full` | Motion enabled (default) |
+| `reduced` | Shorter / quieter motion |
+| `off` | No motion |
+
+OS `prefers-reduced-motion: reduce` never elevates above `reduced`. Legacy preference `"on"` is accepted as a deprecated alias of `"full"` (dev-only console warning).
+
+Docs: https://hewnui.dev/docs/motion
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/features.d.ts

@@ -0,0 +1 @@
+export declare function loadMotionFeatures(): Promise<import("motion/react").FeatureBundle>;

package/dist/features.js

@@ -0,0 +1,4 @@
+export async function loadMotionFeatures() {
+    const { domAnimation } = await import("motion/react");
+    return domAnimation;
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { durations, easings, motionCssVars, type MotionDuration, type MotionEasing, } from "./tokens.js";
+export { springs, springSnappy, springSoft, enterTransition, type MotionSpring, } from "./springs.js";
+export { motionModes, resolveMotionMode, isMotionMode, parseMotionPreference, coerceMotionMode, motionConfigReduced, type MotionMode, } from "./resolve.js";
+export { iconState, fadeIn, drawIn, iconPop } from "./presets.js";
+export { loadMotionFeatures } from "./features.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+export { durations, easings, motionCssVars, } from "./tokens.js";
+export { springs, springSnappy, springSoft, enterTransition, } from "./springs.js";
+export { motionModes, resolveMotionMode, isMotionMode, parseMotionPreference, coerceMotionMode, motionConfigReduced, } from "./resolve.js";
+export { iconState, fadeIn, drawIn, iconPop } from "./presets.js";
+export { loadMotionFeatures } from "./features.js";

package/dist/presets.d.ts

@@ -0,0 +1,26 @@
+export declare const iconState: {
+    hidden: {
+        opacity: number;
+        scale: number;
+        filter: string;
+    };
+    visible: {
+        opacity: number;
+        scale: number;
+        filter: string;
+    };
+};
+export declare const fadeIn: {
+    readonly duration: 0.2;
+};
+export declare const drawIn: {
+    readonly duration: 0.36;
+    readonly ease: readonly [0.2, 0, 0, 1];
+};
+export declare const iconPop: {
+    readonly bounce: 0;
+    readonly type: "spring";
+    readonly stiffness: 420;
+    readonly damping: 30;
+    readonly mass: 0.7;
+};

package/dist/presets.js

@@ -0,0 +1,17 @@
+import { durations, easings } from "./tokens.js";
+import { springs } from "./springs.js";
+export const iconState = {
+    hidden: { opacity: 0, scale: 0.25, filter: "blur(4px)" },
+    visible: { opacity: 1, scale: 1, filter: "blur(0px)" },
+};
+export const fadeIn = {
+    duration: durations.base,
+};
+export const drawIn = {
+    duration: durations.slow,
+    ease: easings.standard,
+};
+export const iconPop = {
+    ...springs.snappy,
+    bounce: 0,
+};

package/dist/resolve.d.ts

@@ -0,0 +1,17 @@
+export declare const motionModes: readonly ["full", "reduced", "off"];
+export type MotionMode = (typeof motionModes)[number];
+/**
+ * Resolve the effective motion mode.
+ * An explicit user preference may only reduce motion further — never override
+ * `prefers-reduced-motion: reduce` into `full`.
+ */
+export declare function resolveMotionMode(preference: MotionMode, osReduced: boolean): MotionMode;
+export declare function isMotionMode(value: string): value is MotionMode;
+/**
+ * Parse stored / prop motion preferences.
+ * Legacy `"on"` is accepted as a deprecated alias of `"full"` (breaking rename).
+ */
+export declare function parseMotionPreference(value: string | null): MotionMode | null;
+/** Accept `MotionMode` or the deprecated `"on"` alias (maps to `"full"`). */
+export declare function coerceMotionMode(value: MotionMode | "on" | string | null | undefined, fallback?: MotionMode): MotionMode;
+export declare function motionConfigReduced(effective: MotionMode): "never" | "always";

package/dist/resolve.js

@@ -0,0 +1,51 @@
+export const motionModes = ["full", "reduced", "off"];
+const rank = {
+    full: 2,
+    reduced: 1,
+    off: 0,
+};
+/**
+ * Resolve the effective motion mode.
+ * An explicit user preference may only reduce motion further — never override
+ * `prefers-reduced-motion: reduce` into `full`.
+ */
+export function resolveMotionMode(preference, osReduced) {
+    const ceiling = osReduced ? "reduced" : "full";
+    return rank[preference] <= rank[ceiling] ? preference : ceiling;
+}
+export function isMotionMode(value) {
+    return motionModes.includes(value);
+}
+/**
+ * Parse stored / prop motion preferences.
+ * Legacy `"on"` is accepted as a deprecated alias of `"full"` (breaking rename).
+ */
+export function parseMotionPreference(value) {
+    if (value === "on") {
+        if (!isProductionEnv()) {
+            console.warn('[Hewn] Motion mode "on" is deprecated; use "full". Mapping "on" → "full".');
+        }
+        return "full";
+    }
+    if (value === "full")
+        return "full";
+    if (value === "reduced")
+        return "reduced";
+    if (value === "off")
+        return "off";
+    return null;
+}
+/** Accept `MotionMode` or the deprecated `"on"` alias (maps to `"full"`). */
+export function coerceMotionMode(value, fallback = "full") {
+    if (value == null)
+        return fallback;
+    return parseMotionPreference(String(value)) ?? fallback;
+}
+export function motionConfigReduced(effective) {
+    return effective === "full" ? "never" : "always";
+}
+function isProductionEnv() {
+    const proc = globalThis
+        .process;
+    return proc?.env?.NODE_ENV === "production";
+}

package/dist/springs.d.ts

@@ -0,0 +1,42 @@
+export declare const springs: {
+    readonly snappy: {
+        readonly type: "spring";
+        readonly stiffness: 420;
+        readonly damping: 30;
+        readonly mass: 0.7;
+    };
+    readonly soft: {
+        readonly type: "spring";
+        readonly stiffness: 280;
+        readonly damping: 28;
+        readonly mass: 0.9;
+    };
+    readonly enter: {
+        readonly type: "spring";
+        readonly stiffness: 340;
+        readonly damping: 30;
+        readonly mass: 0.8;
+    };
+};
+export type MotionSpring = keyof typeof springs;
+/** @deprecated Prefer `springs.snappy`. */
+export declare const springSnappy: {
+    readonly type: "spring";
+    readonly stiffness: 420;
+    readonly damping: 30;
+    readonly mass: 0.7;
+};
+/** @deprecated Prefer `springs.soft`. */
+export declare const springSoft: {
+    readonly type: "spring";
+    readonly stiffness: 280;
+    readonly damping: 28;
+    readonly mass: 0.9;
+};
+/** @deprecated Prefer `springs.enter`. */
+export declare const enterTransition: {
+    readonly type: "spring";
+    readonly stiffness: 340;
+    readonly damping: 30;
+    readonly mass: 0.8;
+};

package/dist/springs.js

@@ -0,0 +1,26 @@
+export const springs = {
+    snappy: {
+        type: "spring",
+        stiffness: 420,
+        damping: 30,
+        mass: 0.7,
+    },
+    soft: {
+        type: "spring",
+        stiffness: 280,
+        damping: 28,
+        mass: 0.9,
+    },
+    enter: {
+        type: "spring",
+        stiffness: 340,
+        damping: 30,
+        mass: 0.8,
+    },
+};
+/** @deprecated Prefer `springs.snappy`. */
+export const springSnappy = springs.snappy;
+/** @deprecated Prefer `springs.soft`. */
+export const springSoft = springs.soft;
+/** @deprecated Prefer `springs.enter`. */
+export const enterTransition = springs.enter;

package/dist/tokens.d.ts

@@ -0,0 +1,30 @@
+/** Duration tokens in seconds for Motion `transition.duration`. */
+export declare const durations: {
+    readonly instant: 0;
+    readonly fast: 0.12;
+    readonly base: 0.2;
+    readonly slow: 0.36;
+};
+export type MotionDuration = keyof typeof durations;
+/** Cubic-bezier tuples for Motion `transition.ease`. */
+export declare const easings: {
+    readonly standard: readonly [0.2, 0, 0, 1];
+    readonly emphasized: readonly [0.16, 1, 0.3, 1];
+    readonly exit: readonly [0.4, 0, 1, 1];
+    readonly linear: "linear";
+};
+export type MotionEasing = keyof typeof easings;
+/** CSS custom property names mirrored in `@hewnui/themes/motion.css`. */
+export declare const motionCssVars: {
+    readonly durationInstant: "--kp-motion-duration-instant";
+    readonly durationFast: "--kp-motion-duration-fast";
+    readonly durationBase: "--kp-motion-duration";
+    readonly durationSlow: "--kp-motion-duration-slow";
+    readonly easeStandard: "--kp-motion-ease-standard";
+    readonly easeEmphasized: "--kp-motion-ease-emphasized";
+    readonly easeExit: "--kp-motion-ease-exit";
+    readonly easeLinear: "--kp-motion-ease-linear";
+    readonly ease: "--kp-motion-ease";
+    readonly stiffness: "--kp-motion-stiffness";
+    readonly damping: "--kp-motion-damping";
+};

package/dist/tokens.js

@@ -0,0 +1,28 @@
+/** Duration tokens in seconds for Motion `transition.duration`. */
+export const durations = {
+    instant: 0,
+    fast: 0.12,
+    base: 0.2,
+    slow: 0.36,
+};
+/** Cubic-bezier tuples for Motion `transition.ease`. */
+export const easings = {
+    standard: [0.2, 0, 0, 1],
+    emphasized: [0.16, 1, 0.3, 1],
+    exit: [0.4, 0, 1, 1],
+    linear: "linear",
+};
+/** CSS custom property names mirrored in `@hewnui/themes/motion.css`. */
+export const motionCssVars = {
+    durationInstant: "--kp-motion-duration-instant",
+    durationFast: "--kp-motion-duration-fast",
+    durationBase: "--kp-motion-duration",
+    durationSlow: "--kp-motion-duration-slow",
+    easeStandard: "--kp-motion-ease-standard",
+    easeEmphasized: "--kp-motion-ease-emphasized",
+    easeExit: "--kp-motion-ease-exit",
+    easeLinear: "--kp-motion-ease-linear",
+    ease: "--kp-motion-ease",
+    stiffness: "--kp-motion-stiffness",
+    damping: "--kp-motion-damping",
+};

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@hewnui/motion",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hewnui/Hewn.git",
+    "directory": "packages/motion"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "README.md",
+    "LICENSE",
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "motion": "^12.42.2",
+    "react": "^19.2.7"
+  },
+  "devDependencies": {
+    "motion": "12.42.2",
+    "react": "19.2.7",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10",
+    "@hewnui/tsconfig": "0.0.0"
+  },
+  "homepage": "https://hewnui.dev",
+  "bugs": {
+    "url": "https://github.com/hewnui/Hewn/issues"
+  },
+  "author": "Himanshu Kumar",
+  "description": "Shared motion tokens and reduced-motion-aware primitives (full, reduced, off) used by Hewn components.",
+  "keywords": [
+    "react",
+    "motion",
+    "framer-motion",
+    "animation",
+    "reduced-motion",
+    "accessibility",
+    "design-tokens",
+    "hewnui"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsx ../../tooling/fix-esm-relative-extensions.ts dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }