@mova-ui/react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SYED  SUBHAN UDDIN
+
+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

@@ -0,0 +1,46 @@
+# @mova-ui/react
+
+**Make interfaces feel alive.**
+
+Reusable React animation components and an offline, copy-source CLI. Documentation: https://mova.zeeland.studio
+
+## Use as a React library
+
+```sh
+npm install @mova-ui/react react react-dom
+```
+
+```tsx
+'use client';
+import { FadeIn, GlowButton, ClassicSpinner } from '@mova-ui/react';
+import '@mova-ui/react/styles.css';
+
+export function Example() {
+  return <FadeIn><GlowButton>Continue</GlowButton><ClassicSpinner /></FadeIn>;
+}
+```
+
+ESM with TypeScript declarations. React 18.2+ or 19; Node 20+ for the CLI. Animation and class utility dependencies are installed automatically. Bundlers can tree-shake unused exports. The library entry is marked `use client` for React Server Component frameworks.
+
+The exported CSS contains the bundled components' Tailwind utility classes and theme tokens, **not** the website stylesheet or Tailwind preflight. Import it once; Tailwind is not required for the supplied styles. Its utility class names are global: applications that already use Tailwind may instead scan their installed package's JS or copied source using their own Tailwind configuration. Custom `className` values require your own CSS. Components include upstream demo defaults; check individual props before use. Motion accessibility behavior varies by component; applications should configure reduced-motion preferences and test accessibility for their use case.
+
+## Copy editable source
+
+Run from a project root containing `package.json`:
+
+```sh
+npx @mova-ui/react --help
+npx @mova-ui/react list
+npx @mova-ui/react add glow-button
+npx @mova-ui/react add fade-in --dir src/components/mova
+```
+
+The CLI copies TypeScript source, compiled `styles.css`, and `LICENSE.mova` to `src/components/mova` by default. It prints required dependencies (for example `npm install framer-motion`) but never installs packages, downloads component code, or edits project configuration. Import the copied CSS once, e.g. `import './components/mova/styles.css'` from `src/App.tsx`. Source uses React and, where needed, `framer-motion`, `clsx`, and `tailwind-merge`.
+
+Existing files are protected. Use `--overwrite` only when you intend to replace them. Identical shared CSS/license files can be reused when adding another component. Absolute paths, parent traversal, symlink targets, Git metadata, and `node_modules` destinations are refused. This is a local developer tool, not a sandbox against another process concurrently mutating your project's directories.
+
+`list` enumerates all packaged IDs, including loaders, text/entrance/hover/scroll/cursor effects, the page transition, a toggle, hooks, and utilities. The package is generated from the original reusable registry, not the documentation application; website-only chart/demo pages are not exported.
+
+## License and attribution
+
+MIT. Derived from Amicro by SYED SUBHAN UDDIN. The original copyright and complete license are retained in `LICENSE` and in source installations. Mova packaging, CLI, and compatibility adjustments preserve that attribution.

package/bin/mova.mjs

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { readdirSync, readFileSync, writeFileSync, lstatSync, realpathSync, mkdirSync, renameSync, unlinkSync, constants, openSync, closeSync } from 'node:fs';
+import { resolve, dirname, join, isAbsolute, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { randomUUID } from 'node:crypto';
+const pkg = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const help = `Mova — Make interfaces feel alive.
+
+Usage:
+  npx @mova-ui/react list
+  npx @mova-ui/react add <id> [--dir src/components/mova] [--overwrite]
+  npx @mova-ui/react --help
+
+Run add from your project root (must contain package.json).
+Copies bundled TypeScript source, compiled styles.css and the MIT license.
+No downloads, package installation or project configuration changes are made.
+Import the copied styles.css once in your app. Required dependencies are printed.
+--dir must be a relative directory inside this project; symlinks are refused.
+--overwrite explicitly replaces existing regular files (never symlinks).
+`;
+function stat(path) { try { return lstatSync(path); } catch (e) { if(e.code === 'ENOENT') return null; throw e; } }
+function safePath(root, path) {
+  const rel = relative(root, path);
+  if (!rel || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) throw new Error('Target must be inside this project');
+  let current = root;
+  const parts = rel.split(sep);
+  for (let i=0; i<parts.length; i++) {
+    current = join(current, parts[i]); const s = stat(current);
+    if (s?.isSymbolicLink()) throw new Error('Symlink targets are not allowed');
+    if (s && i < parts.length-1 && !s.isDirectory()) throw new Error('Target parent is not a directory');
+    if (s && i === parts.length-1 && !s.isFile()) throw new Error('Target is not a regular file');
+  }
+}
+function main(args) {
+  if (!args.length || (args.length === 1 && ['--help','-h'].includes(args[0]))) { console.log(help); return; }
+  if (args[0] === 'list' && args.length === 1) {
+    console.log(readdirSync(join(pkg, 'registry')).filter(f => f.endsWith('.json')).map(f => f.slice(0,-5)).sort().join('\n')); return;
+  }
+  if (args[0] !== 'add' || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(args[1] ?? '')) throw new Error('Use add <id>, list, or --help');
+  const id = args[1]; let dir = 'src/components/mova'; let overwrite = false;
+  for (let i=2;i<args.length;i++) {
+    if (args[i] === '--overwrite' && !overwrite) overwrite = true;
+    else if (args[i] === '--dir' && args[i+1] && !args[i+1].startsWith('--')) dir = args[++i];
+    else throw new Error(`Unknown or incomplete option: ${args[i]}`);
+  }
+  if (!dir || isAbsolute(dir) || dir.includes('\\') || dir.includes(':') || dir.split('/').some(p => p === '..' || p.startsWith('.git') || p === 'node_modules')) throw new Error('Directory must be a relative path inside this project');
+  const root = realpathSync(process.cwd());
+  if (!stat(join(root, 'package.json'))?.isFile()) throw new Error('Run add from a project root containing package.json');
+  JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+  const registryFile = join(pkg, 'registry', `${id}.json`);
+  if (!stat(registryFile)?.isFile()) throw new Error(`Unknown component: ${id}. Run npx @mova-ui/react list`);
+  const item = JSON.parse(readFileSync(registryFile, 'utf8'));
+  if (!/^[a-z0-9-]+\.tsx?$/.test(item.file) || typeof item.content !== 'string') throw new Error('Invalid bundled registry entry');
+  const out = resolve(root, dir);
+  const files = [
+    { name: item.file, content: item.content },
+    { name: 'styles.css', content: readFileSync(join(pkg, 'dist/styles.css'), 'utf8') },
+    { name: 'LICENSE.mova', content: readFileSync(join(pkg, 'LICENSE'), 'utf8') }
+  ].map(f => ({...f, path: join(out, f.name)}));
+  // Preflight the entire operation before creating directories or replacing files.
+  for (const f of files) {
+    safePath(root, f.path);
+    const exists = stat(f.path);
+    f.skip = exists && f.name !== item.file && readFileSync(f.path, 'utf8') === f.content;
+    if (exists && !f.skip && !overwrite) throw new Error(`${relative(root, f.path)} already exists; use --overwrite to replace it`);
+  }
+  for (const f of files.filter(f => !f.skip)) {
+    mkdirSync(dirname(f.path), { recursive: true });
+    safePath(root, f.path);
+    if (!overwrite) {
+      const fd = openSync(f.path, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o644);
+      try { writeFileSync(fd, f.content); } finally { closeSync(fd); }
+    } else {
+      // Rename a new inode instead of following existing symlinks or hardlinks.
+      const temp = join(out, `.mova-${randomUUID()}.tmp`);
+      try { writeFileSync(temp, f.content, {flag:'wx',mode:0o644}); safePath(root, f.path); renameSync(temp, f.path); }
+      finally { if(stat(temp)) unlinkSync(temp); }
+    }
+  }
+  console.log(`Added ${id} to ${dir}\nImport '${dir}/styles.css' once in your app (adjust the relative import).`);
+  if (item.dependencies.length) console.log(`Dependencies: npm install ${item.dependencies.join(' ')}`);
+  console.log('Requires React 18.2+ or 19 and React DOM. MIT attribution is in LICENSE.mova.');
+}
+try { main(process.argv.slice(2)); } catch (error) { console.error(`Mova: ${error.message}`); process.exitCode = 1; }

package/dist/hooks/use-mouse-position.d.ts

@@ -0,0 +1,8 @@
+import { RefObject } from 'react';
+export interface MousePosition {
+    x: number;
+    y: number;
+    elementX: number;
+    elementY: number;
+}
+export declare function useMousePosition(ref?: RefObject<HTMLElement | null>): MousePosition;

package/dist/hooks/use-reduced-motion.d.ts

@@ -0,0 +1 @@
+export declare function useReducedMotion(): boolean;

package/dist/hooks/use-scroll-progress.d.ts

@@ -0,0 +1,2 @@
+import { RefObject } from 'react';
+export declare function useScrollProgress(ref?: RefObject<HTMLElement | null>): number;

package/dist/hooks/use-stagger.d.ts

@@ -0,0 +1,7 @@
+interface StaggerOptions {
+    baseDelay?: number;
+    staggerDelay?: number;
+    from?: 'first' | 'last' | 'center' | number;
+}
+export declare function useStagger(count: number, options?: StaggerOptions): number[];
+export {};

package/dist/hooks/use-web-haptics.d.ts

@@ -0,0 +1,4 @@
+export type HapticsType = 'light' | 'medium' | 'heavy' | 'success' | 'warning' | 'error';
+export declare function useWebHaptics(): {
+    trigger: (type?: HapticsType) => boolean;
+};

package/dist/index.d.ts

@@ -0,0 +1,164 @@
+export * from './hooks/use-mouse-position.js';
+export * from './hooks/use-reduced-motion.js';
+export * from './hooks/use-scroll-progress.js';
+export * from './hooks/use-stagger.js';
+export * from './hooks/use-web-haptics.js';
+export * from './lib/presets.js';
+export * from './lib/utils.js';
+export * from './ui/cursor/cursor-trail.js';
+export * from './ui/cursor/mouse-follow.js';
+export * from './ui/cursor/spotlight.js';
+export * from './ui/entrance/fade-down.js';
+export * from './ui/entrance/fade-in.js';
+export * from './ui/entrance/fade-up.js';
+export * from './ui/entrance/scale-in.js';
+export * from './ui/entrance/slide-left.js';
+export * from './ui/entrance/slide-right.js';
+export * from './ui/entrance/zoom-in.js';
+export * from './ui/hover/card-hover.js';
+export * from './ui/hover/glow-button.js';
+export * from './ui/hover/magnetic-button.js';
+export * from './ui/hover/tilt-card.js';
+export * from './ui/loading/accordion-loader.js';
+export * from './ui/loading/app-icon-load.js';
+export * from './ui/loading/apple-breathe.js';
+export * from './ui/loading/apple-equalizer.js';
+export * from './ui/loading/apple-icon-morph.js';
+export * from './ui/loading/apple-pulse-dots.js';
+export * from './ui/loading/apple-scale-pulse.js';
+export * from './ui/loading/apple-sound-wave.js';
+export * from './ui/loading/apple-text-reveal.js';
+export * from './ui/loading/apple-unlock.js';
+export * from './ui/loading/arc-tracer.js';
+export * from './ui/loading/bar-cascade.js';
+export * from './ui/loading/bar-sweep.js';
+export * from './ui/loading/bobbing-dots.js';
+export * from './ui/loading/bounce-dots.js';
+export * from './ui/loading/bouncing-bars.js';
+export * from './ui/loading/bouncing-dots.js';
+export * from './ui/loading/bouncing-lines.js';
+export * from './ui/loading/bouncing-square.js';
+export * from './ui/loading/breathe-ring.js';
+export * from './ui/loading/breathing-glow.js';
+export * from './ui/loading/breathing-square.js';
+export * from './ui/loading/circular-bars.js';
+export * from './ui/loading/classic-spinner.js';
+export * from './ui/loading/clock-spinner.js';
+export * from './ui/loading/comet-spinner.js';
+export * from './ui/loading/concentric-pulse.js';
+export * from './ui/loading/concentric-ring.js';
+export * from './ui/loading/concentric-squares.js';
+export * from './ui/loading/conveyor-loop.js';
+export * from './ui/loading/cross-spinner.js';
+export * from './ui/loading/cube-flip-spring.js';
+export * from './ui/loading/dash-ring.js';
+export * from './ui/loading/dashed-spiral.js';
+export * from './ui/loading/diamond-grid.js';
+export * from './ui/loading/diamond-rotate-spring.js';
+export * from './ui/loading/dot-spinner.js';
+export * from './ui/loading/dots-ring.js';
+export * from './ui/loading/double-ring.js';
+export * from './ui/loading/drop-dot.js';
+export * from './ui/loading/dual-arc.js';
+export * from './ui/loading/dynamic-island.js';
+export * from './ui/loading/elastic-bars.js';
+export * from './ui/loading/elastic-square.js';
+export * from './ui/loading/expanding-cross.js';
+export * from './ui/loading/face-id-scan.js';
+export * from './ui/loading/fade-arc.js';
+export * from './ui/loading/fade-dots.js';
+export * from './ui/loading/flip-square.js';
+export * from './ui/loading/floating-diamonds.js';
+export * from './ui/loading/fluid-bars.js';
+export * from './ui/loading/fluid-diamond.js';
+export * from './ui/loading/fluid-dot-orbit.js';
+export * from './ui/loading/fluid-skeleton.js';
+export * from './ui/loading/gears.js';
+export * from './ui/loading/glassmorphic-card.js';
+export * from './ui/loading/gradient-arc.js';
+export * from './ui/loading/grid-dots.js';
+export * from './ui/loading/haptic-ring.js';
+export * from './ui/loading/heartbeat.js';
+export * from './ui/loading/hexagon-spinner.js';
+export * from './ui/loading/hourglass.js';
+export * from './ui/loading/infinity-path.js';
+export * from './ui/loading/intersecting-rings.js';
+export * from './ui/loading/ios-spinner.js';
+export * from './ui/loading/line-spinner.js';
+export * from './ui/loading/liquid-dots.js';
+export * from './ui/loading/mac-terminal.js';
+export * from './ui/loading/magnetic-dots.js';
+export * from './ui/loading/minimal-triangle.js';
+export * from './ui/loading/morph-dot-ring.js';
+export * from './ui/loading/morph-loader.js';
+export * from './ui/loading/morphing-bars.js';
+export * from './ui/loading/morphing-infinity.js';
+export * from './ui/loading/morphing-ring.js';
+export * from './ui/loading/morphing-shape.js';
+export * from './ui/loading/newtons-cradle.js';
+export * from './ui/loading/offset-rings.js';
+export * from './ui/loading/orbiting-circles.js';
+export * from './ui/loading/orbiting-dot.js';
+export * from './ui/loading/origami-shape.js';
+export * from './ui/loading/pendulum.js';
+export * from './ui/loading/pulsating-dots.js';
+export * from './ui/loading/pulse-dot.js';
+export * from './ui/loading/pulse-dots.js';
+export * from './ui/loading/pulse-square.js';
+export * from './ui/loading/pulse.js';
+export * from './ui/loading/pumping-heart.js';
+export * from './ui/loading/radar-sweep.js';
+export * from './ui/loading/ring-sweep.js';
+export * from './ui/loading/ripple-effect.js';
+export * from './ui/loading/rotating-cross.js';
+export * from './ui/loading/rotating-triangle.js';
+export * from './ui/loading/shape-shift-grid.js';
+export * from './ui/loading/shimmer-line.js';
+export * from './ui/loading/siri-wave.js';
+export * from './ui/loading/skeleton-loader.js';
+export * from './ui/loading/skeleton.js';
+export * from './ui/loading/sliding-bars.js';
+export * from './ui/loading/smooth-dot-shift.js';
+export * from './ui/loading/smooth-ring.js';
+export * from './ui/loading/smooth-rounded-square.js';
+export * from './ui/loading/spinning-squares.js';
+export * from './ui/loading/spiral-spinner.js';
+export * from './ui/loading/spring-bars.js';
+export * from './ui/loading/spring-dot-matrix.js';
+export * from './ui/loading/spring-hexagon.js';
+export * from './ui/loading/spring-ring-expand.js';
+export * from './ui/loading/spring-text-pop.js';
+export * from './ui/loading/square-accordion.js';
+export * from './ui/loading/square-grid.js';
+export * from './ui/loading/square-snake.js';
+export * from './ui/loading/square-spinner.js';
+export * from './ui/loading/stacked-bar-pulse.js';
+export * from './ui/loading/swapping-dots.js';
+export * from './ui/loading/swirling-spinner.js';
+export * from './ui/loading/symmetric-wave.js';
+export * from './ui/loading/terminal-loader.js';
+export * from './ui/loading/text-blink.js';
+export * from './ui/loading/text-dots.js';
+export * from './ui/loading/text-morph.js';
+export * from './ui/loading/text-shimmer-wave.js';
+export * from './ui/loading/text-shimmer.js';
+export * from './ui/loading/trailing-dots.js';
+export * from './ui/loading/triple-dot-spinner.js';
+export * from './ui/loading/twin-orbit.js';
+export * from './ui/loading/typing-indicator.js';
+export * from './ui/loading/typing.js';
+export * from './ui/loading/wandering-cube.js';
+export * from './ui/loading/watch-spinner.js';
+export * from './ui/loading/wave-dots.js';
+export * from './ui/loading/wave-physics-loader.js';
+export * from './ui/loading/waveform-loader.js';
+export * from './ui/loading/zig-zag-pulse.js';
+export * from './ui/scroll/progress-indicator.js';
+export * from './ui/scroll/scroll-reveal.js';
+export * from './ui/scroll/sticky-reveal.js';
+export * from './ui/text/blur-text.js';
+export * from './ui/text/character-stagger.js';
+export * from './ui/text/text-reveal.js';
+export * from './ui/text/word-reveal.js';
+export * from './ui/toggles/classic-toggle.js';
+export * from './ui/transitions/page-transition.js';