@bysages/nuxt 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 By Sages
+
+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,55 @@
+# @bysages/nuxt
+
+![npm version](https://img.shields.io/npm/v/@bysages/nuxt)
+![npm downloads](https://img.shields.io/npm/dw/@bysages/nuxt)
+![npm license](https://img.shields.io/npm/l/@bysages/nuxt)
+
+> The Nuxt module for By Sages Elements — registers every `@bysages/vue` family as an auto-imported component and ships the whole core style layer as one build-time stylesheet.
+
+## Features
+
+- 🧩 **Every family, auto-imported** — all 90+ `@bysages/vue` families register as Nuxt components; use `<Button>`, `<Dialog.Root>`, `<DataTable>` with no import lines
+- 🖥️ **Styled SSR out of the box** — the core style layer compiles into the build as a single stylesheet, so server-rendered pages carry styled HTML and the first paint never waits on runtime injection
+- 🌗 **Theme before mount** — an optional `theme` option applies mode, accent, scene, density, and contrast on the client before the app mounts
+- 🔤 **Prefixed names on demand** — a `prefix` option namespaces the registrations (`<BsButton>`) when they must not collide
+
+## Installation
+
+```bash
+# pnpm
+pnpm add @bysages/nuxt
+
+# npm
+npm install @bysages/nuxt
+
+# yarn
+yarn add @bysages/nuxt
+
+# bun
+bun add @bysages/nuxt
+```
+
+## Quick Start
+
+```ts
+// nuxt.config.ts
+export default defineNuxtConfig({
+  modules: ["@bysages/nuxt"],
+  bsElements: {
+    theme: { mode: "system", accent: "ink" },
+  },
+});
+```
+
+```vue
+<!-- app.vue -->
+<template>
+  <Button tone="ink">Publish</Button>
+</template>
+```
+
+The module wraps the [Vue package](../vue/README.md) — every family and prop documented there works here, and the token stylesheet is handled for you.
+
+## License
+
+- [MIT](../../LICENSE) © [By Sages](https://www.bysages.com/)

package/dist/module.d.mts

@@ -0,0 +1,15 @@
+import * as _nuxt_schema from '@nuxt/schema';
+import { ApplyThemeOptions } from '@bysages/core';
+
+interface BsElementsOptions {
+    /** Prefix for the auto-imported components — "Bs" renders `<BsButton>`.
+     * Empty by default. */
+    prefix?: string;
+    /** Theme applied on the client before the app mounts: mode, accent,
+     * scene, density, contrast — anything `applyTheme` accepts. */
+    theme?: ApplyThemeOptions;
+}
+declare const _default: _nuxt_schema.NuxtModule<BsElementsOptions, BsElementsOptions, false>;
+
+export { _default as default };
+export type { BsElementsOptions };

package/dist/module.json

@@ -0,0 +1,9 @@
+{
+  "name": "@bysages/nuxt",
+  "configKey": "bsElements",
+  "version": "0.1.1",
+  "builder": {
+    "@nuxt/module-builder": "1.0.3",
+    "unbuild": "3.6.1"
+  }
+}

package/dist/module.mjs

@@ -0,0 +1,49 @@
+import { tokensCss, componentStyles } from '@bysages/core';
+import { defineNuxtModule, createResolver, addComponent, addTemplate, addPlugin } from '@nuxt/kit';
+
+function isComponentExport(value) {
+  if (typeof value === "function") return true;
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+  if ("render" in value || "setup" in value) return true;
+  return Object.values(value).some(
+    (member) => typeof member === "function" || typeof member === "object" && member !== null && ("render" in member || "setup" in member)
+  );
+}
+const RESERVED = /* @__PURE__ */ new Set(["Icon"]);
+const module$1 = defineNuxtModule({
+  meta: {
+    name: "@bysages/nuxt",
+    configKey: "bsElements"
+  },
+  defaults: {
+    prefix: ""
+  },
+  async setup(options, nuxt) {
+    const resolver = createResolver(import.meta.url);
+    const families = await import('@bysages/vue');
+    for (const name of Object.keys(families)) {
+      if (!/^[A-Z]/.test(name) || !isComponentExport(families[name])) continue;
+      if (RESERVED.has(name)) continue;
+      addComponent({
+        name: options.prefix + name,
+        export: name,
+        filePath: "@bysages/vue"
+      });
+    }
+    nuxt.options.build.transpile.push("@bysages/nuxt", "@bysages/vue", "@bysages/core");
+    nuxt.options.runtimeConfig.public.bsElements = {
+      theme: options.theme ?? null
+    };
+    const styles = addTemplate({
+      filename: "bs-styles/core.css",
+      getContents: () => tokensCss + Object.values(componentStyles).join("\n"),
+      write: true
+    });
+    nuxt.options.css.push(styles.dst);
+    nuxt.options.app.head.meta ||= [];
+    nuxt.options.app.head.meta.push({ name: "bs-styles-shipped", content: "build" });
+    addPlugin(resolver.resolve("./runtime/plugin"));
+  }
+});
+
+export { module$1 as default };

package/dist/runtime/plugin.d.ts

@@ -0,0 +1,7 @@
+/** Applies the theme configured through module options on the client.
+ * The wrappers' own injection already stands down against the build-time
+ * stylesheet via the head marker the module plants. Published modules
+ * cannot lean on the application's auto-imports — the Nuxt APIs come
+ * in explicitly from `#imports`, which the consuming build resolves. */
+declare const _default: any;
+export default _default;

package/dist/runtime/plugin.js

@@ -0,0 +1,7 @@
+import { applyTheme } from "@bysages/core";
+import { defineNuxtPlugin, useRuntimeConfig } from "#imports";
+export default defineNuxtPlugin(() => {
+  if (import.meta.server) return;
+  const { theme } = useRuntimeConfig().public.bsElements;
+  if (theme) applyTheme(theme);
+});

package/dist/types.d.mts

@@ -0,0 +1,9 @@
+import type { NuxtModule } from '@nuxt/schema'
+
+import type { default as Module } from './module.mjs'
+
+export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
+
+export { default } from './module.mjs'
+
+export { type BsElementsOptions } from './module.mjs'

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@bysages/nuxt",
+  "version": "0.1.1",
+  "description": "Nuxt module for By Sages Elements — auto-imports the paper-and-ink Vue components and applies the theme",
+  "keywords": [
+    "components",
+    "design-system",
+    "design-tokens",
+    "nuxt",
+    "nuxt-module",
+    "theming",
+    "ui",
+    "vue"
+  ],
+  "homepage": "https://github.com/bysages/elements#readme",
+  "bugs": {
+    "url": "https://github.com/bysages/elements/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "By Sages",
+    "email": "contact@bysages.com",
+    "url": "https://www.bysages.com/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bysages/elements"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/module.mjs",
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types.d.mts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/module.mjs"
+    }
+  },
+  "dependencies": {
+    "@nuxt/kit": "^4.5.2",
+    "@bysages/vue": "0.1.1",
+    "@bysages/core": "0.1.1"
+  },
+  "devDependencies": {
+    "@nuxt/module-builder": "1.0.3",
+    "nuxt": "4.5.2"
+  },
+  "peerDependencies": {
+    "nuxt": "^4.0.0",
+    "vue": "^3.5"
+  },
+  "scripts": {
+    "dev": "nuxt-module-build build --stub",
+    "build": "nuxt-module-build build",
+    "release": "basis publish"
+  }
+}