@ansh-ui/nuxt 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ansh contributors
+
+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/dist/module.cjs

@@ -0,0 +1,230 @@
+'use strict';
+
+var kit = require('@nuxt/kit');
+
+// src/module.ts
+var COMPONENT_NAMES = [
+  // Backgrounds
+  "AuroraBackground",
+  "MeshGradient",
+  "AnimatedGradient",
+  "ParticleField",
+  "Constellation",
+  "MeteorShower",
+  "Rain",
+  "Snow",
+  "Fireflies",
+  "Waves",
+  "LiquidBlob",
+  "NoiseLayer",
+  "Spotlight",
+  // Behaviours
+  "MagneticButton",
+  "TiltCard",
+  "Ripple",
+  "Marquee",
+  "ScrollReveal",
+  "Parallax",
+  // Text
+  "GradientText",
+  "AnimatedText",
+  // Providers
+  "MotionConfig",
+  "ThemeProvider",
+  // Layout
+  "Stack",
+  "HStack",
+  "VStack",
+  "Grid",
+  "GridItem",
+  "Container",
+  "Divider",
+  "Spacer",
+  "Center",
+  "AspectRatio",
+  "ScrollArea",
+  "Resizable",
+  // Forms
+  "Field",
+  "Fieldset",
+  "VisuallyHidden",
+  "Input",
+  "NumberInput",
+  "Textarea",
+  "Checkbox",
+  "ChoiceCard",
+  "Radio",
+  "RadioGroup",
+  "Switch",
+  "OptionList",
+  "Select",
+  "Combobox",
+  "Slider",
+  "RangeSlider",
+  "PinInput",
+  "TagsInput",
+  "Rating",
+  "Dropzone",
+  "ColorPicker",
+  "Calendar",
+  "DatePicker",
+  "DateRangePicker",
+  // Overlays
+  "Popover",
+  "PopoverTrigger",
+  "PopoverContent",
+  "HoverCard",
+  "Tooltip",
+  "TooltipProvider",
+  "Dialog",
+  "AlertDialog",
+  "DialogFooter",
+  "Drawer",
+  "DropdownMenu",
+  "ContextMenu",
+  // Data
+  "Table",
+  "DataTable",
+  "Pagination",
+  "Badge",
+  "Avatar",
+  "AvatarGroup",
+  "Kbd",
+  "Stat",
+  "EmptyState",
+  "DescriptionList",
+  "Timeline",
+  "CodeBlock",
+  "Progress",
+  "CircularProgress",
+  "Meter",
+  // Navigation
+  "Tabs",
+  "Breadcrumbs",
+  "Stepper",
+  "Sidebar",
+  "AppShell",
+  "NavigationMenu",
+  // Feedback
+  "Alert",
+  "Banner",
+  "Callout",
+  // Disclosure
+  "Collapsible",
+  "Accordion",
+  "DisclosureList",
+  // Motion
+  "Motion",
+  "AnimatePresence",
+  "Draggable"
+];
+var COMPOSABLE_NAMES = [
+  "useMotionValue",
+  "useMotionRef",
+  "useMotionStyle",
+  "useSpringValue",
+  "useAnimate",
+  "useAnimatedFrom",
+  "useTicker",
+  "useInView",
+  "useElementSize",
+  "useScrollProgress",
+  "useWindowScroll",
+  "usePointer",
+  "useReducedMotion",
+  "useFrameBudget",
+  "useBehaviour",
+  "useMotionConfig",
+  "useTheme",
+  "useFieldControl",
+  "useFieldContext",
+  "useControllableState"
+];
+var module$1 = kit.defineNuxtModule({
+  meta: {
+    name: "@ansh-ui/nuxt",
+    configKey: "ansh",
+    compatibility: {
+      nuxt: ">=3.10.0"
+    }
+  },
+  defaults: {
+    components: true,
+    prefix: "",
+    composables: true,
+    css: true,
+    themeScript: true,
+    themeStorageKey: "ansh-theme",
+    reducedMotion: "auto",
+    timeScale: 1,
+    pauseWhenHidden: true,
+    respectBattery: true
+  },
+  setup(options, nuxt) {
+    nuxt.options.build.transpile.push("@ansh-ui/vue", "@ansh-ui/core", "@ansh-ui/tokens");
+    if (options.css) {
+      nuxt.options.css.unshift("@ansh-ui/tokens/ansh.css");
+    }
+    if (options.components) {
+      for (const name of COMPONENT_NAMES) {
+        kit.addComponent({
+          name: `${options.prefix ?? ""}${name}`,
+          export: name,
+          filePath: "@ansh-ui/vue",
+          // Every component mounts its effect in `onMounted`, so the server renders only the host
+          // element. That is intentional and correct: the canvas has no meaningful server
+          // representation, and rendering one would guarantee a hydration mismatch.
+          mode: "all"
+        });
+      }
+    }
+    if (options.composables) {
+      kit.addImports(
+        COMPOSABLE_NAMES.map((name) => ({
+          name,
+          from: "@ansh-ui/vue"
+        }))
+      );
+    }
+    if (options.themeScript) {
+      const key = options.themeStorageKey ?? "ansh-theme";
+      nuxt.options.app.head = nuxt.options.app.head ?? {};
+      nuxt.options.app.head.script = nuxt.options.app.head.script ?? [];
+      nuxt.options.app.head.script.unshift({
+        // `tagPosition: 'head'` plus being first means this executes before any stylesheet is
+        // applied, which is the only moment at which the theme can be set without a visible flash.
+        innerHTML: `(function(){try{var t=localStorage.getItem(${JSON.stringify(key)});if(t==='light'||t==='dark'){document.documentElement.setAttribute('data-theme',t)}}catch(e){}})()`,
+        tagPosition: "head"
+      });
+    }
+    kit.addPluginTemplate({
+      filename: "ansh-motion.client.mjs",
+      getContents: () => `
+import { defineNuxtPlugin } from '#app'
+import { setReducedMotionMode, getTicker, attachLifecycle } from '@ansh-ui/core'
+
+export default defineNuxtPlugin(() => {
+  setReducedMotionMode(${JSON.stringify(options.reducedMotion ?? "auto")})
+
+  const ticker = getTicker()
+  ticker.timeScale = ${JSON.stringify(options.timeScale ?? 1)}
+
+  const detach = attachLifecycle(ticker, {
+    pauseWhenHidden: ${JSON.stringify(options.pauseWhenHidden ?? true)},
+    respectBattery: ${JSON.stringify(options.respectBattery ?? true)},
+  })
+
+  // Released on HMR dispose so a dev-server reload doesn't accumulate listeners across edits.
+  if (import.meta.hot) import.meta.hot.dispose(detach)
+})
+`,
+      // Client-only: every one of these touches a browser global.
+      mode: "client"
+    });
+  }
+});
+var module_default = module$1;
+
+module.exports = module_default;
+//# sourceMappingURL=module.cjs.map
+//# sourceMappingURL=module.cjs.map

package/dist/module.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/module.ts"],"names":["module","defineNuxtModule","addComponent","addImports","addPluginTemplate"],"mappings":"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","file":"module.cjs","sourcesContent":["import { addComponent, addImports, addPluginTemplate, defineNuxtModule } from '@nuxt/kit'\nimport type { NuxtModule } from '@nuxt/schema'\nimport type { ReducedMotionMode } from '@ansh-ui/core'\n\n/**\n * The Ansh Nuxt module.\n *\n * Nuxt gets its own package rather than instructions in the docs because there are four things a\n * Nuxt app needs that a bare Vue app does not, and every one of them is a footgun if left to the\n * consumer:\n *\n * 1. **Auto-imports.** Nuxt users expect `<AuroraBackground />` to work with no import statement.\n *    That requires registering each component with `addComponent`, which only a module can do.\n * 2. **Transpilation.** Nuxt's server bundle externalises dependencies by default. Our packages\n *    ship ESM that Nitro can consume, but the `'use client'`-free Vue build still needs to be in\n *    the transpile list for older Nuxt versions to resolve it consistently.\n * 3. **The theme flash.** A themed app renders server-side with no knowledge of the user's stored\n *    preference, so the first paint is the wrong theme. The only fix is a blocking inline script in\n *    `<head>`, injected before any stylesheet — which is a `nuxt.options.app.head` concern.\n * 4. **Motion configuration.** `reducedMotion`, `timeScale` and lifecycle pausing need to be applied\n *    once, on the client, after hydration. A generated plugin is the right place.\n */\n\nexport interface ModuleOptions {\n  /**\n   * Register every component for auto-import. Default `true`.\n   *\n   * Nuxt's component discovery is lazy per-component, so registering all of them does not increase\n   * bundle size — only the ones actually used in templates are included.\n   */\n  components?: boolean\n\n  /**\n   * Prefix for auto-imported component names. Default `''` (no prefix), giving\n   * `<AuroraBackground />`. Set to `'A'` for `<AAuroraBackground />` if you need to avoid a clash\n   * with your own components.\n   */\n  prefix?: string\n\n  /** Register the composables (`useMotionValue`, `useInView`, …) for auto-import. Default `true`. */\n  composables?: boolean\n\n  /**\n   * Inject `@ansh-ui/tokens/ansh.css` into the app's global CSS. Default `true`.\n   *\n   * Set `false` if you import it yourself, or if you are overriding the token layer and need\n   * control over cascade order.\n   */\n  css?: boolean\n\n  /**\n   * Inject the blocking theme script into `<head>`. Default `true`.\n   *\n   * Without this a themed app paints the wrong theme for one frame on every cold load. The script\n   * is ~150 bytes and runs before the first stylesheet, which is the only point at which the flash\n   * can be prevented.\n   */\n  themeScript?: boolean\n\n  /** `localStorage` key the theme script reads. Default `'ansh-theme'`. */\n  themeStorageKey?: string\n\n  /** Application-level reduced-motion override. Default `'auto'` (follow the OS). */\n  reducedMotion?: ReducedMotionMode\n\n  /** Global playback rate. `0.5` is slow motion everywhere. Default `1`. */\n  timeScale?: number\n\n  /** Pause all animation while the document is hidden. Default `true`. */\n  pauseWhenHidden?: boolean\n\n  /** Reduce quality on low battery where the platform exposes it. Default `true`. */\n  respectBattery?: boolean\n}\n\n/** Components exported by `@ansh-ui/vue`, registered individually for lazy auto-import. */\nconst COMPONENT_NAMES = [\n  // Backgrounds\n  'AuroraBackground',\n  'MeshGradient',\n  'AnimatedGradient',\n  'ParticleField',\n  'Constellation',\n  'MeteorShower',\n  'Rain',\n  'Snow',\n  'Fireflies',\n  'Waves',\n  'LiquidBlob',\n  'NoiseLayer',\n  'Spotlight',\n  // Behaviours\n  'MagneticButton',\n  'TiltCard',\n  'Ripple',\n  'Marquee',\n  'ScrollReveal',\n  'Parallax',\n  // Text\n  'GradientText',\n  'AnimatedText',\n  // Providers\n  'MotionConfig',\n  'ThemeProvider',\n  // Layout\n  'Stack',\n  'HStack',\n  'VStack',\n  'Grid',\n  'GridItem',\n  'Container',\n  'Divider',\n  'Spacer',\n  'Center',\n  'AspectRatio',\n  'ScrollArea',\n  'Resizable',\n  // Forms\n  'Field',\n  'Fieldset',\n  'VisuallyHidden',\n  'Input',\n  'NumberInput',\n  'Textarea',\n  'Checkbox',\n  'ChoiceCard',\n  'Radio',\n  'RadioGroup',\n  'Switch',\n  'OptionList',\n  'Select',\n  'Combobox',\n  'Slider',\n  'RangeSlider',\n  'PinInput',\n  'TagsInput',\n  'Rating',\n  'Dropzone',\n  'ColorPicker',\n  'Calendar',\n  'DatePicker',\n  'DateRangePicker',\n  // Overlays\n  'Popover',\n  'PopoverTrigger',\n  'PopoverContent',\n  'HoverCard',\n  'Tooltip',\n  'TooltipProvider',\n  'Dialog',\n  'AlertDialog',\n  'DialogFooter',\n  'Drawer',\n  'DropdownMenu',\n  'ContextMenu',\n  // Data\n  'Table',\n  'DataTable',\n  'Pagination',\n  'Badge',\n  'Avatar',\n  'AvatarGroup',\n  'Kbd',\n  'Stat',\n  'EmptyState',\n  'DescriptionList',\n  'Timeline',\n  'CodeBlock',\n  'Progress',\n  'CircularProgress',\n  'Meter',\n  // Navigation\n  'Tabs',\n  'Breadcrumbs',\n  'Stepper',\n  'Sidebar',\n  'AppShell',\n  'NavigationMenu',\n  // Feedback\n  'Alert',\n  'Banner',\n  'Callout',\n  // Disclosure\n  'Collapsible',\n  'Accordion',\n  'DisclosureList',\n  // Motion\n  'Motion',\n  'AnimatePresence',\n  'Draggable',\n] as const\n\n/** Composables exported by `@ansh-ui/vue`, registered for auto-import. */\nconst COMPOSABLE_NAMES = [\n  'useMotionValue',\n  'useMotionRef',\n  'useMotionStyle',\n  'useSpringValue',\n  'useAnimate',\n  'useAnimatedFrom',\n  'useTicker',\n  'useInView',\n  'useElementSize',\n  'useScrollProgress',\n  'useWindowScroll',\n  'usePointer',\n  'useReducedMotion',\n  'useFrameBudget',\n  'useBehaviour',\n  'useMotionConfig',\n  'useTheme',\n  'useFieldControl',\n  'useFieldContext',\n  'useControllableState',\n] as const\n\n/**\n * The return type is annotated explicitly rather than inferred.\n *\n * Without it TypeScript emits a declaration referencing `@nuxt/schema` by its resolved pnpm path,\n * which is not portable — the generated `.d.ts` would only typecheck on a machine with an\n * identically-hashed store directory.\n */\nconst module: NuxtModule<ModuleOptions> = defineNuxtModule<ModuleOptions>({\n  meta: {\n    name: '@ansh-ui/nuxt',\n    configKey: 'ansh',\n    compatibility: {\n      nuxt: '>=3.10.0',\n    },\n  },\n\n  defaults: {\n    components: true,\n    prefix: '',\n    composables: true,\n    css: true,\n    themeScript: true,\n    themeStorageKey: 'ansh-theme',\n    reducedMotion: 'auto',\n    timeScale: 1,\n    pauseWhenHidden: true,\n    respectBattery: true,\n  },\n\n  setup(options, nuxt) {\n    // --- Transpile ---------------------------------------------------------\n    // Nuxt externalises dependencies for the server build. Our packages are ESM-only and reference\n    // browser globals inside functions (never at module scope), so they are SSR-safe — but Vite's\n    // SSR resolver needs them in `noExternal` to consistently pick the ESM entry across the Nuxt\n    // versions we support.\n    nuxt.options.build.transpile.push('@ansh-ui/vue', '@ansh-ui/core', '@ansh-ui/tokens')\n\n    // --- Global CSS --------------------------------------------------------\n    if (options.css) {\n      // Unshifted rather than pushed so the token layer lands *before* the application's own CSS.\n      // Tokens are defaults meant to be overridden; if they came last they would win against the\n      // consumer's overrides, which is the opposite of what a token layer should do.\n      nuxt.options.css.unshift('@ansh-ui/tokens/ansh.css')\n    }\n\n    // --- Components --------------------------------------------------------\n    if (options.components) {\n      for (const name of COMPONENT_NAMES) {\n        addComponent({\n          name: `${options.prefix ?? ''}${name}`,\n          export: name,\n          filePath: '@ansh-ui/vue',\n          // Every component mounts its effect in `onMounted`, so the server renders only the host\n          // element. That is intentional and correct: the canvas has no meaningful server\n          // representation, and rendering one would guarantee a hydration mismatch.\n          mode: 'all',\n        })\n      }\n    }\n\n    // --- Composables -------------------------------------------------------\n    if (options.composables) {\n      addImports(\n        COMPOSABLE_NAMES.map((name) => ({\n          name,\n          from: '@ansh-ui/vue',\n        })),\n      )\n    }\n\n    // --- Theme flash prevention -------------------------------------------\n    if (options.themeScript) {\n      const key = options.themeStorageKey ?? 'ansh-theme'\n      nuxt.options.app.head = nuxt.options.app.head ?? {}\n      nuxt.options.app.head.script = nuxt.options.app.head.script ?? []\n      nuxt.options.app.head.script.unshift({\n        // `tagPosition: 'head'` plus being first means this executes before any stylesheet is\n        // applied, which is the only moment at which the theme can be set without a visible flash.\n        innerHTML:\n          `(function(){try{var t=localStorage.getItem(${JSON.stringify(key)});` +\n          `if(t==='light'||t==='dark'){document.documentElement.setAttribute('data-theme',t)}}` +\n          `catch(e){}})()`,\n        tagPosition: 'head',\n      })\n    }\n\n    // --- Runtime plugin ----------------------------------------------------\n    // Generated rather than shipped as a file so the module's options are baked in at build time,\n    // which avoids a runtime config read on every request.\n    addPluginTemplate({\n      filename: 'ansh-motion.client.mjs',\n      getContents: () => `\nimport { defineNuxtPlugin } from '#app'\nimport { setReducedMotionMode, getTicker, attachLifecycle } from '@ansh-ui/core'\n\nexport default defineNuxtPlugin(() => {\n  setReducedMotionMode(${JSON.stringify(options.reducedMotion ?? 'auto')})\n\n  const ticker = getTicker()\n  ticker.timeScale = ${JSON.stringify(options.timeScale ?? 1)}\n\n  const detach = attachLifecycle(ticker, {\n    pauseWhenHidden: ${JSON.stringify(options.pauseWhenHidden ?? true)},\n    respectBattery: ${JSON.stringify(options.respectBattery ?? true)},\n  })\n\n  // Released on HMR dispose so a dev-server reload doesn't accumulate listeners across edits.\n  if (import.meta.hot) import.meta.hot.dispose(detach)\n})\n`,\n      // Client-only: every one of these touches a browser global.\n      mode: 'client',\n    })\n  },\n})\n\nexport default module\n"]}

package/dist/module.d.cts

@@ -0,0 +1,73 @@
+import { NuxtModule } from '@nuxt/schema';
+import { ReducedMotionMode } from '@ansh-ui/core';
+
+/**
+ * The Ansh Nuxt module.
+ *
+ * Nuxt gets its own package rather than instructions in the docs because there are four things a
+ * Nuxt app needs that a bare Vue app does not, and every one of them is a footgun if left to the
+ * consumer:
+ *
+ * 1. **Auto-imports.** Nuxt users expect `<AuroraBackground />` to work with no import statement.
+ *    That requires registering each component with `addComponent`, which only a module can do.
+ * 2. **Transpilation.** Nuxt's server bundle externalises dependencies by default. Our packages
+ *    ship ESM that Nitro can consume, but the `'use client'`-free Vue build still needs to be in
+ *    the transpile list for older Nuxt versions to resolve it consistently.
+ * 3. **The theme flash.** A themed app renders server-side with no knowledge of the user's stored
+ *    preference, so the first paint is the wrong theme. The only fix is a blocking inline script in
+ *    `<head>`, injected before any stylesheet — which is a `nuxt.options.app.head` concern.
+ * 4. **Motion configuration.** `reducedMotion`, `timeScale` and lifecycle pausing need to be applied
+ *    once, on the client, after hydration. A generated plugin is the right place.
+ */
+interface ModuleOptions {
+    /**
+     * Register every component for auto-import. Default `true`.
+     *
+     * Nuxt's component discovery is lazy per-component, so registering all of them does not increase
+     * bundle size — only the ones actually used in templates are included.
+     */
+    components?: boolean;
+    /**
+     * Prefix for auto-imported component names. Default `''` (no prefix), giving
+     * `<AuroraBackground />`. Set to `'A'` for `<AAuroraBackground />` if you need to avoid a clash
+     * with your own components.
+     */
+    prefix?: string;
+    /** Register the composables (`useMotionValue`, `useInView`, …) for auto-import. Default `true`. */
+    composables?: boolean;
+    /**
+     * Inject `@ansh-ui/tokens/ansh.css` into the app's global CSS. Default `true`.
+     *
+     * Set `false` if you import it yourself, or if you are overriding the token layer and need
+     * control over cascade order.
+     */
+    css?: boolean;
+    /**
+     * Inject the blocking theme script into `<head>`. Default `true`.
+     *
+     * Without this a themed app paints the wrong theme for one frame on every cold load. The script
+     * is ~150 bytes and runs before the first stylesheet, which is the only point at which the flash
+     * can be prevented.
+     */
+    themeScript?: boolean;
+    /** `localStorage` key the theme script reads. Default `'ansh-theme'`. */
+    themeStorageKey?: string;
+    /** Application-level reduced-motion override. Default `'auto'` (follow the OS). */
+    reducedMotion?: ReducedMotionMode;
+    /** Global playback rate. `0.5` is slow motion everywhere. Default `1`. */
+    timeScale?: number;
+    /** Pause all animation while the document is hidden. Default `true`. */
+    pauseWhenHidden?: boolean;
+    /** Reduce quality on low battery where the platform exposes it. Default `true`. */
+    respectBattery?: boolean;
+}
+/**
+ * The return type is annotated explicitly rather than inferred.
+ *
+ * Without it TypeScript emits a declaration referencing `@nuxt/schema` by its resolved pnpm path,
+ * which is not portable — the generated `.d.ts` would only typecheck on a machine with an
+ * identically-hashed store directory.
+ */
+declare const module$1: NuxtModule<ModuleOptions>;
+
+export { type ModuleOptions, module$1 as default };

package/dist/module.d.ts

@@ -0,0 +1,73 @@
+import { NuxtModule } from '@nuxt/schema';
+import { ReducedMotionMode } from '@ansh-ui/core';
+
+/**
+ * The Ansh Nuxt module.
+ *
+ * Nuxt gets its own package rather than instructions in the docs because there are four things a
+ * Nuxt app needs that a bare Vue app does not, and every one of them is a footgun if left to the
+ * consumer:
+ *
+ * 1. **Auto-imports.** Nuxt users expect `<AuroraBackground />` to work with no import statement.
+ *    That requires registering each component with `addComponent`, which only a module can do.
+ * 2. **Transpilation.** Nuxt's server bundle externalises dependencies by default. Our packages
+ *    ship ESM that Nitro can consume, but the `'use client'`-free Vue build still needs to be in
+ *    the transpile list for older Nuxt versions to resolve it consistently.
+ * 3. **The theme flash.** A themed app renders server-side with no knowledge of the user's stored
+ *    preference, so the first paint is the wrong theme. The only fix is a blocking inline script in
+ *    `<head>`, injected before any stylesheet — which is a `nuxt.options.app.head` concern.
+ * 4. **Motion configuration.** `reducedMotion`, `timeScale` and lifecycle pausing need to be applied
+ *    once, on the client, after hydration. A generated plugin is the right place.
+ */
+interface ModuleOptions {
+    /**
+     * Register every component for auto-import. Default `true`.
+     *
+     * Nuxt's component discovery is lazy per-component, so registering all of them does not increase
+     * bundle size — only the ones actually used in templates are included.
+     */
+    components?: boolean;
+    /**
+     * Prefix for auto-imported component names. Default `''` (no prefix), giving
+     * `<AuroraBackground />`. Set to `'A'` for `<AAuroraBackground />` if you need to avoid a clash
+     * with your own components.
+     */
+    prefix?: string;
+    /** Register the composables (`useMotionValue`, `useInView`, …) for auto-import. Default `true`. */
+    composables?: boolean;
+    /**
+     * Inject `@ansh-ui/tokens/ansh.css` into the app's global CSS. Default `true`.
+     *
+     * Set `false` if you import it yourself, or if you are overriding the token layer and need
+     * control over cascade order.
+     */
+    css?: boolean;
+    /**
+     * Inject the blocking theme script into `<head>`. Default `true`.
+     *
+     * Without this a themed app paints the wrong theme for one frame on every cold load. The script
+     * is ~150 bytes and runs before the first stylesheet, which is the only point at which the flash
+     * can be prevented.
+     */
+    themeScript?: boolean;
+    /** `localStorage` key the theme script reads. Default `'ansh-theme'`. */
+    themeStorageKey?: string;
+    /** Application-level reduced-motion override. Default `'auto'` (follow the OS). */
+    reducedMotion?: ReducedMotionMode;
+    /** Global playback rate. `0.5` is slow motion everywhere. Default `1`. */
+    timeScale?: number;
+    /** Pause all animation while the document is hidden. Default `true`. */
+    pauseWhenHidden?: boolean;
+    /** Reduce quality on low battery where the platform exposes it. Default `true`. */
+    respectBattery?: boolean;
+}
+/**
+ * The return type is annotated explicitly rather than inferred.
+ *
+ * Without it TypeScript emits a declaration referencing `@nuxt/schema` by its resolved pnpm path,
+ * which is not portable — the generated `.d.ts` would only typecheck on a machine with an
+ * identically-hashed store directory.
+ */
+declare const module$1: NuxtModule<ModuleOptions>;
+
+export { type ModuleOptions, module$1 as default };

package/dist/module.js

@@ -0,0 +1,228 @@
+import { defineNuxtModule, addComponent, addImports, addPluginTemplate } from '@nuxt/kit';
+
+// src/module.ts
+var COMPONENT_NAMES = [
+  // Backgrounds
+  "AuroraBackground",
+  "MeshGradient",
+  "AnimatedGradient",
+  "ParticleField",
+  "Constellation",
+  "MeteorShower",
+  "Rain",
+  "Snow",
+  "Fireflies",
+  "Waves",
+  "LiquidBlob",
+  "NoiseLayer",
+  "Spotlight",
+  // Behaviours
+  "MagneticButton",
+  "TiltCard",
+  "Ripple",
+  "Marquee",
+  "ScrollReveal",
+  "Parallax",
+  // Text
+  "GradientText",
+  "AnimatedText",
+  // Providers
+  "MotionConfig",
+  "ThemeProvider",
+  // Layout
+  "Stack",
+  "HStack",
+  "VStack",
+  "Grid",
+  "GridItem",
+  "Container",
+  "Divider",
+  "Spacer",
+  "Center",
+  "AspectRatio",
+  "ScrollArea",
+  "Resizable",
+  // Forms
+  "Field",
+  "Fieldset",
+  "VisuallyHidden",
+  "Input",
+  "NumberInput",
+  "Textarea",
+  "Checkbox",
+  "ChoiceCard",
+  "Radio",
+  "RadioGroup",
+  "Switch",
+  "OptionList",
+  "Select",
+  "Combobox",
+  "Slider",
+  "RangeSlider",
+  "PinInput",
+  "TagsInput",
+  "Rating",
+  "Dropzone",
+  "ColorPicker",
+  "Calendar",
+  "DatePicker",
+  "DateRangePicker",
+  // Overlays
+  "Popover",
+  "PopoverTrigger",
+  "PopoverContent",
+  "HoverCard",
+  "Tooltip",
+  "TooltipProvider",
+  "Dialog",
+  "AlertDialog",
+  "DialogFooter",
+  "Drawer",
+  "DropdownMenu",
+  "ContextMenu",
+  // Data
+  "Table",
+  "DataTable",
+  "Pagination",
+  "Badge",
+  "Avatar",
+  "AvatarGroup",
+  "Kbd",
+  "Stat",
+  "EmptyState",
+  "DescriptionList",
+  "Timeline",
+  "CodeBlock",
+  "Progress",
+  "CircularProgress",
+  "Meter",
+  // Navigation
+  "Tabs",
+  "Breadcrumbs",
+  "Stepper",
+  "Sidebar",
+  "AppShell",
+  "NavigationMenu",
+  // Feedback
+  "Alert",
+  "Banner",
+  "Callout",
+  // Disclosure
+  "Collapsible",
+  "Accordion",
+  "DisclosureList",
+  // Motion
+  "Motion",
+  "AnimatePresence",
+  "Draggable"
+];
+var COMPOSABLE_NAMES = [
+  "useMotionValue",
+  "useMotionRef",
+  "useMotionStyle",
+  "useSpringValue",
+  "useAnimate",
+  "useAnimatedFrom",
+  "useTicker",
+  "useInView",
+  "useElementSize",
+  "useScrollProgress",
+  "useWindowScroll",
+  "usePointer",
+  "useReducedMotion",
+  "useFrameBudget",
+  "useBehaviour",
+  "useMotionConfig",
+  "useTheme",
+  "useFieldControl",
+  "useFieldContext",
+  "useControllableState"
+];
+var module$1 = defineNuxtModule({
+  meta: {
+    name: "@ansh-ui/nuxt",
+    configKey: "ansh",
+    compatibility: {
+      nuxt: ">=3.10.0"
+    }
+  },
+  defaults: {
+    components: true,
+    prefix: "",
+    composables: true,
+    css: true,
+    themeScript: true,
+    themeStorageKey: "ansh-theme",
+    reducedMotion: "auto",
+    timeScale: 1,
+    pauseWhenHidden: true,
+    respectBattery: true
+  },
+  setup(options, nuxt) {
+    nuxt.options.build.transpile.push("@ansh-ui/vue", "@ansh-ui/core", "@ansh-ui/tokens");
+    if (options.css) {
+      nuxt.options.css.unshift("@ansh-ui/tokens/ansh.css");
+    }
+    if (options.components) {
+      for (const name of COMPONENT_NAMES) {
+        addComponent({
+          name: `${options.prefix ?? ""}${name}`,
+          export: name,
+          filePath: "@ansh-ui/vue",
+          // Every component mounts its effect in `onMounted`, so the server renders only the host
+          // element. That is intentional and correct: the canvas has no meaningful server
+          // representation, and rendering one would guarantee a hydration mismatch.
+          mode: "all"
+        });
+      }
+    }
+    if (options.composables) {
+      addImports(
+        COMPOSABLE_NAMES.map((name) => ({
+          name,
+          from: "@ansh-ui/vue"
+        }))
+      );
+    }
+    if (options.themeScript) {
+      const key = options.themeStorageKey ?? "ansh-theme";
+      nuxt.options.app.head = nuxt.options.app.head ?? {};
+      nuxt.options.app.head.script = nuxt.options.app.head.script ?? [];
+      nuxt.options.app.head.script.unshift({
+        // `tagPosition: 'head'` plus being first means this executes before any stylesheet is
+        // applied, which is the only moment at which the theme can be set without a visible flash.
+        innerHTML: `(function(){try{var t=localStorage.getItem(${JSON.stringify(key)});if(t==='light'||t==='dark'){document.documentElement.setAttribute('data-theme',t)}}catch(e){}})()`,
+        tagPosition: "head"
+      });
+    }
+    addPluginTemplate({
+      filename: "ansh-motion.client.mjs",
+      getContents: () => `
+import { defineNuxtPlugin } from '#app'
+import { setReducedMotionMode, getTicker, attachLifecycle } from '@ansh-ui/core'
+
+export default defineNuxtPlugin(() => {
+  setReducedMotionMode(${JSON.stringify(options.reducedMotion ?? "auto")})
+
+  const ticker = getTicker()
+  ticker.timeScale = ${JSON.stringify(options.timeScale ?? 1)}
+
+  const detach = attachLifecycle(ticker, {
+    pauseWhenHidden: ${JSON.stringify(options.pauseWhenHidden ?? true)},
+    respectBattery: ${JSON.stringify(options.respectBattery ?? true)},
+  })
+
+  // Released on HMR dispose so a dev-server reload doesn't accumulate listeners across edits.
+  if (import.meta.hot) import.meta.hot.dispose(detach)
+})
+`,
+      // Client-only: every one of these touches a browser global.
+      mode: "client"
+    });
+  }
+});
+var module_default = module$1;
+
+export { module_default as default };
+//# sourceMappingURL=module.js.map
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/module.ts"],"names":["module"],"mappings":"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","file":"module.js","sourcesContent":["import { addComponent, addImports, addPluginTemplate, defineNuxtModule } from '@nuxt/kit'\nimport type { NuxtModule } from '@nuxt/schema'\nimport type { ReducedMotionMode } from '@ansh-ui/core'\n\n/**\n * The Ansh Nuxt module.\n *\n * Nuxt gets its own package rather than instructions in the docs because there are four things a\n * Nuxt app needs that a bare Vue app does not, and every one of them is a footgun if left to the\n * consumer:\n *\n * 1. **Auto-imports.** Nuxt users expect `<AuroraBackground />` to work with no import statement.\n *    That requires registering each component with `addComponent`, which only a module can do.\n * 2. **Transpilation.** Nuxt's server bundle externalises dependencies by default. Our packages\n *    ship ESM that Nitro can consume, but the `'use client'`-free Vue build still needs to be in\n *    the transpile list for older Nuxt versions to resolve it consistently.\n * 3. **The theme flash.** A themed app renders server-side with no knowledge of the user's stored\n *    preference, so the first paint is the wrong theme. The only fix is a blocking inline script in\n *    `<head>`, injected before any stylesheet — which is a `nuxt.options.app.head` concern.\n * 4. **Motion configuration.** `reducedMotion`, `timeScale` and lifecycle pausing need to be applied\n *    once, on the client, after hydration. A generated plugin is the right place.\n */\n\nexport interface ModuleOptions {\n  /**\n   * Register every component for auto-import. Default `true`.\n   *\n   * Nuxt's component discovery is lazy per-component, so registering all of them does not increase\n   * bundle size — only the ones actually used in templates are included.\n   */\n  components?: boolean\n\n  /**\n   * Prefix for auto-imported component names. Default `''` (no prefix), giving\n   * `<AuroraBackground />`. Set to `'A'` for `<AAuroraBackground />` if you need to avoid a clash\n   * with your own components.\n   */\n  prefix?: string\n\n  /** Register the composables (`useMotionValue`, `useInView`, …) for auto-import. Default `true`. */\n  composables?: boolean\n\n  /**\n   * Inject `@ansh-ui/tokens/ansh.css` into the app's global CSS. Default `true`.\n   *\n   * Set `false` if you import it yourself, or if you are overriding the token layer and need\n   * control over cascade order.\n   */\n  css?: boolean\n\n  /**\n   * Inject the blocking theme script into `<head>`. Default `true`.\n   *\n   * Without this a themed app paints the wrong theme for one frame on every cold load. The script\n   * is ~150 bytes and runs before the first stylesheet, which is the only point at which the flash\n   * can be prevented.\n   */\n  themeScript?: boolean\n\n  /** `localStorage` key the theme script reads. Default `'ansh-theme'`. */\n  themeStorageKey?: string\n\n  /** Application-level reduced-motion override. Default `'auto'` (follow the OS). */\n  reducedMotion?: ReducedMotionMode\n\n  /** Global playback rate. `0.5` is slow motion everywhere. Default `1`. */\n  timeScale?: number\n\n  /** Pause all animation while the document is hidden. Default `true`. */\n  pauseWhenHidden?: boolean\n\n  /** Reduce quality on low battery where the platform exposes it. Default `true`. */\n  respectBattery?: boolean\n}\n\n/** Components exported by `@ansh-ui/vue`, registered individually for lazy auto-import. */\nconst COMPONENT_NAMES = [\n  // Backgrounds\n  'AuroraBackground',\n  'MeshGradient',\n  'AnimatedGradient',\n  'ParticleField',\n  'Constellation',\n  'MeteorShower',\n  'Rain',\n  'Snow',\n  'Fireflies',\n  'Waves',\n  'LiquidBlob',\n  'NoiseLayer',\n  'Spotlight',\n  // Behaviours\n  'MagneticButton',\n  'TiltCard',\n  'Ripple',\n  'Marquee',\n  'ScrollReveal',\n  'Parallax',\n  // Text\n  'GradientText',\n  'AnimatedText',\n  // Providers\n  'MotionConfig',\n  'ThemeProvider',\n  // Layout\n  'Stack',\n  'HStack',\n  'VStack',\n  'Grid',\n  'GridItem',\n  'Container',\n  'Divider',\n  'Spacer',\n  'Center',\n  'AspectRatio',\n  'ScrollArea',\n  'Resizable',\n  // Forms\n  'Field',\n  'Fieldset',\n  'VisuallyHidden',\n  'Input',\n  'NumberInput',\n  'Textarea',\n  'Checkbox',\n  'ChoiceCard',\n  'Radio',\n  'RadioGroup',\n  'Switch',\n  'OptionList',\n  'Select',\n  'Combobox',\n  'Slider',\n  'RangeSlider',\n  'PinInput',\n  'TagsInput',\n  'Rating',\n  'Dropzone',\n  'ColorPicker',\n  'Calendar',\n  'DatePicker',\n  'DateRangePicker',\n  // Overlays\n  'Popover',\n  'PopoverTrigger',\n  'PopoverContent',\n  'HoverCard',\n  'Tooltip',\n  'TooltipProvider',\n  'Dialog',\n  'AlertDialog',\n  'DialogFooter',\n  'Drawer',\n  'DropdownMenu',\n  'ContextMenu',\n  // Data\n  'Table',\n  'DataTable',\n  'Pagination',\n  'Badge',\n  'Avatar',\n  'AvatarGroup',\n  'Kbd',\n  'Stat',\n  'EmptyState',\n  'DescriptionList',\n  'Timeline',\n  'CodeBlock',\n  'Progress',\n  'CircularProgress',\n  'Meter',\n  // Navigation\n  'Tabs',\n  'Breadcrumbs',\n  'Stepper',\n  'Sidebar',\n  'AppShell',\n  'NavigationMenu',\n  // Feedback\n  'Alert',\n  'Banner',\n  'Callout',\n  // Disclosure\n  'Collapsible',\n  'Accordion',\n  'DisclosureList',\n  // Motion\n  'Motion',\n  'AnimatePresence',\n  'Draggable',\n] as const\n\n/** Composables exported by `@ansh-ui/vue`, registered for auto-import. */\nconst COMPOSABLE_NAMES = [\n  'useMotionValue',\n  'useMotionRef',\n  'useMotionStyle',\n  'useSpringValue',\n  'useAnimate',\n  'useAnimatedFrom',\n  'useTicker',\n  'useInView',\n  'useElementSize',\n  'useScrollProgress',\n  'useWindowScroll',\n  'usePointer',\n  'useReducedMotion',\n  'useFrameBudget',\n  'useBehaviour',\n  'useMotionConfig',\n  'useTheme',\n  'useFieldControl',\n  'useFieldContext',\n  'useControllableState',\n] as const\n\n/**\n * The return type is annotated explicitly rather than inferred.\n *\n * Without it TypeScript emits a declaration referencing `@nuxt/schema` by its resolved pnpm path,\n * which is not portable — the generated `.d.ts` would only typecheck on a machine with an\n * identically-hashed store directory.\n */\nconst module: NuxtModule<ModuleOptions> = defineNuxtModule<ModuleOptions>({\n  meta: {\n    name: '@ansh-ui/nuxt',\n    configKey: 'ansh',\n    compatibility: {\n      nuxt: '>=3.10.0',\n    },\n  },\n\n  defaults: {\n    components: true,\n    prefix: '',\n    composables: true,\n    css: true,\n    themeScript: true,\n    themeStorageKey: 'ansh-theme',\n    reducedMotion: 'auto',\n    timeScale: 1,\n    pauseWhenHidden: true,\n    respectBattery: true,\n  },\n\n  setup(options, nuxt) {\n    // --- Transpile ---------------------------------------------------------\n    // Nuxt externalises dependencies for the server build. Our packages are ESM-only and reference\n    // browser globals inside functions (never at module scope), so they are SSR-safe — but Vite's\n    // SSR resolver needs them in `noExternal` to consistently pick the ESM entry across the Nuxt\n    // versions we support.\n    nuxt.options.build.transpile.push('@ansh-ui/vue', '@ansh-ui/core', '@ansh-ui/tokens')\n\n    // --- Global CSS --------------------------------------------------------\n    if (options.css) {\n      // Unshifted rather than pushed so the token layer lands *before* the application's own CSS.\n      // Tokens are defaults meant to be overridden; if they came last they would win against the\n      // consumer's overrides, which is the opposite of what a token layer should do.\n      nuxt.options.css.unshift('@ansh-ui/tokens/ansh.css')\n    }\n\n    // --- Components --------------------------------------------------------\n    if (options.components) {\n      for (const name of COMPONENT_NAMES) {\n        addComponent({\n          name: `${options.prefix ?? ''}${name}`,\n          export: name,\n          filePath: '@ansh-ui/vue',\n          // Every component mounts its effect in `onMounted`, so the server renders only the host\n          // element. That is intentional and correct: the canvas has no meaningful server\n          // representation, and rendering one would guarantee a hydration mismatch.\n          mode: 'all',\n        })\n      }\n    }\n\n    // --- Composables -------------------------------------------------------\n    if (options.composables) {\n      addImports(\n        COMPOSABLE_NAMES.map((name) => ({\n          name,\n          from: '@ansh-ui/vue',\n        })),\n      )\n    }\n\n    // --- Theme flash prevention -------------------------------------------\n    if (options.themeScript) {\n      const key = options.themeStorageKey ?? 'ansh-theme'\n      nuxt.options.app.head = nuxt.options.app.head ?? {}\n      nuxt.options.app.head.script = nuxt.options.app.head.script ?? []\n      nuxt.options.app.head.script.unshift({\n        // `tagPosition: 'head'` plus being first means this executes before any stylesheet is\n        // applied, which is the only moment at which the theme can be set without a visible flash.\n        innerHTML:\n          `(function(){try{var t=localStorage.getItem(${JSON.stringify(key)});` +\n          `if(t==='light'||t==='dark'){document.documentElement.setAttribute('data-theme',t)}}` +\n          `catch(e){}})()`,\n        tagPosition: 'head',\n      })\n    }\n\n    // --- Runtime plugin ----------------------------------------------------\n    // Generated rather than shipped as a file so the module's options are baked in at build time,\n    // which avoids a runtime config read on every request.\n    addPluginTemplate({\n      filename: 'ansh-motion.client.mjs',\n      getContents: () => `\nimport { defineNuxtPlugin } from '#app'\nimport { setReducedMotionMode, getTicker, attachLifecycle } from '@ansh-ui/core'\n\nexport default defineNuxtPlugin(() => {\n  setReducedMotionMode(${JSON.stringify(options.reducedMotion ?? 'auto')})\n\n  const ticker = getTicker()\n  ticker.timeScale = ${JSON.stringify(options.timeScale ?? 1)}\n\n  const detach = attachLifecycle(ticker, {\n    pauseWhenHidden: ${JSON.stringify(options.pauseWhenHidden ?? true)},\n    respectBattery: ${JSON.stringify(options.respectBattery ?? true)},\n  })\n\n  // Released on HMR dispose so a dev-server reload doesn't accumulate listeners across edits.\n  if (import.meta.hot) import.meta.hot.dispose(detach)\n})\n`,\n      // Client-only: every one of these touches a browser global.\n      mode: 'client',\n    })\n  },\n})\n\nexport default module\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@ansh-ui/nuxt",
+  "version": "0.2.0",
+  "description": "Ansh Nuxt module — auto-imports, SSR-safe components and theme setup for Nuxt 3 and 4.",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "nuxt",
+    "nuxt-module",
+    "vue",
+    "animation",
+    "motion",
+    "ui"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jithin003/ui-library.git",
+    "directory": "packages/nuxt"
+  },
+  "homepage": "https://github.com/jithin003/ui-library",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/module.cjs",
+  "module": "./dist/module.js",
+  "types": "./dist/module.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js",
+      "require": "./dist/module.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@nuxt/kit": "^3.15.0",
+    "@ansh-ui/tokens": "0.2.0",
+    "@ansh-ui/vue": "0.2.0",
+    "@ansh-ui/core": "0.2.0"
+  },
+  "devDependencies": {
+    "@nuxt/schema": "^3.15.0"
+  },
+  "peerDependencies": {
+    "nuxt": "^3.10.0 || ^4.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}