@stonecrop/nuxt 0.27.0 → 0.29.0

package/README.md

@@ -21,7 +21,7 @@ Stonecrop is a **schema-driven UI framework** that generates forms, tables, and
 
 - **Route Generation**: Scans your `/doctypes` folder and registers routes using your own page components
 - **Plugin System**: Auto-registers Stonecrop composables and utilities
-- **Theme Support**: Import and customize Stonecrop themes
+- **Styling**: Loads the Stonecrop token floor automatically; restyle by overriding `--sc-*` variables
 - **TypeScript First**: Full type safety and IntelliSense support
 - **Thin Wrapper**: The module is intentionally opinion-free — page rendering, queries, and navigation stay in your application
 
@@ -219,14 +219,12 @@ export default defineNuxtConfig({
 
     // Enable DocBuilder for visual schema editing
     docbuilder: false,
-
-    // The default theme (@stonecrop/themes/default.css) loads automatically.
-    // Override it, or set `false` to bring your own:
-    // theme: '@stonecrop/themes/dark.css',
   },
 })
 ```
 
+The Stonecrop token floor (`@stonecrop/themes/default.css`) is always loaded — see [Theming](#theming).
+
 ### Module Options
 
 | Option | Type | Description |
@@ -235,10 +233,28 @@ export default defineNuxtConfig({
 | `routeStrategy` | `RouteStrategyFn` | Custom function receiving all parsed doctypes; returns a `NuxtPage[]`. Takes priority over `pageComponent`. |
 | `docbuilder` | `boolean` | Enable the DocBuilder feature at `/docbuilder`. Defaults to `false`. |
 | `doctypesDir` | `string` | Override the doctypes directory path. Defaults to `doctypes/` inside `srcDir`. |
-| `theme` | `string \| false` | Base theme stylesheet loaded into the host app (supplies the `--sc-*` CSS variables). Defaults to `'@stonecrop/themes/default.css'`; set `false` to load none and bring your own. |
 
 If neither `pageComponent` nor `routeStrategy` is configured the module logs a warning and skips doctype route registration.
 
+## Theming
+
+The module loads `@stonecrop/themes/default.css` into `nuxt.options.css` unconditionally. There is no option to change or disable it: that sheet is the only definition of the `--sc-*` variables every Stonecrop component reads, so opting out could only produce an unstyled app.
+
+Restyle by overriding the variables in your own CSS:
+
+```css
+/* app/assets/tokens.css */
+:root {
+	--sc-primary-color: #6d28d9;
+	--sc-brand-color: #111827;
+	--sc-font-family: 'IBM Plex Sans', sans-serif;
+}
+```
+
+Your declaration wins. The floor wraps its own in the `stonecrop.tokens` cascade layer, and an unlayered declaration beats a layered one regardless of specificity or source order — so this works no matter where your stylesheet sits in `nuxt.options.css`. Keep the overrides on `:root`; scoping them to a container changes how they resolve outside it.
+
+See the [`@stonecrop/themes` README](../themes/README.md) for the full token list and the rules on adding one.
+
 ## Route Generation
 
 ### Default: routes the doctypes declare

package/dist/module.d.mts

@@ -78,19 +78,14 @@ interface ModuleOptions {
      * ```
      */
     routeStrategy?: RouteStrategyFn;
-    /**
-     * Base theme stylesheet loaded into the host app. Provides the `--sc-*` CSS variables,
-     * applies the document font, and normalizes form controls / code to inherit it. Defaults
-     * to Stonecrop's default theme. Set to `false` to load no theme (bring your own), or pass
-     * a different theme's module specifier / path (e.g. `'@stonecrop/themes/dark.css'`).
-     *
-     * The Stonecrop component packages are theme-agnostic — they consume `--sc-*` variables
-     * but never bundle a theme — so the host must supply one; the module does that here.
-     */
-    theme?: string | false;
 }
 declare const STONECROP_PACKAGES: string[];
+/**
+ * The Stonecrop token floor — the single definition of every `--sc-*` variable the component
+ * packages consume. Named once here so the specifier lives in one place.
+ */
+declare const STONECROP_TOKENS = "@stonecrop/themes/default.css";
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
 
-export { STONECROP_PACKAGES, _default as default };
+export { STONECROP_PACKAGES, STONECROP_TOKENS, _default as default };
 export type { ModuleOptions, ParsedDoctype, RouteStrategyFn };

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@stonecrop/nuxt",
   "configKey": "stonecrop",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -34,6 +34,7 @@ const STONECROP_PACKAGES = [
   "@stonecrop/utilities",
   "@stonecrop/themes"
 ];
+const STONECROP_TOKENS = "@stonecrop/themes/default.css";
 const module$1 = defineNuxtModule({
   meta: {
     name: "@stonecrop/nuxt",
@@ -42,8 +43,7 @@ const module$1 = defineNuxtModule({
   defaults: (_nuxt) => {
     return {
       docbuilder: false,
-      doctypesDir: "doctypes",
-      theme: "@stonecrop/themes/default.css"
+      doctypesDir: "doctypes"
     };
   },
   async setup(options, nuxt) {
@@ -68,9 +68,9 @@ const module$1 = defineNuxtModule({
       } catch {
       }
     }
-    if (options.theme && !nuxt.options.css.includes(options.theme)) {
-      nuxt.options.css.unshift(options.theme);
-      logger.log(`Added Stonecrop theme to app CSS: ${options.theme}`);
+    if (!nuxt.options.css.includes(STONECROP_TOKENS)) {
+      nuxt.options.css.unshift(STONECROP_TOKENS);
+      logger.log(`Added Stonecrop tokens to app CSS: ${STONECROP_TOKENS}`);
     }
     nuxt.hook("nitro:config", (config) => {
       config.externals = config.externals || {};
@@ -274,4 +274,4 @@ const module$1 = defineNuxtModule({
   }
 });
 
-export { STONECROP_PACKAGES, module$1 as default };
+export { STONECROP_PACKAGES, STONECROP_TOKENS, module$1 as default };

package/dist/types.d.mts

@@ -1,3 +1,3 @@
-export { type STONECROP_PACKAGES, default } from './module.mjs'
+export { type STONECROP_PACKAGES, type STONECROP_TOKENS, default } from './module.mjs'
 
 export { type ModuleOptions, type ParsedDoctype, type RouteStrategyFn } from './module.mjs'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/nuxt",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Nuxt module for Stonecrop",
   "repository": {
     "type": "git",
@@ -45,18 +45,18 @@
     "pathe": "^2.0.3",
     "pinia": "^3.0.4",
     "prompts": "^2.4.2",
-    "@stonecrop/aform": "0.27.0",
-    "@stonecrop/atable": "0.27.0",
-    "@stonecrop/code-editor": "0.27.0",
-    "@stonecrop/desktop": "0.27.0",
-    "@stonecrop/casl-middleware": "0.27.0",
-    "@stonecrop/graphql-client": "0.27.0",
-    "@stonecrop/node-editor": "0.27.0",
-    "@stonecrop/nuxt-grafserv": "0.27.0",
-    "@stonecrop/schema": "0.27.0",
-    "@stonecrop/stonecrop": "0.27.0",
-    "@stonecrop/graphql-middleware": "0.27.0",
-    "@stonecrop/themes": "0.27.0"
+    "@stonecrop/aform": "0.29.0",
+    "@stonecrop/casl-middleware": "0.29.0",
+    "@stonecrop/code-editor": "0.29.0",
+    "@stonecrop/desktop": "0.29.0",
+    "@stonecrop/atable": "0.29.0",
+    "@stonecrop/graphql-client": "0.29.0",
+    "@stonecrop/graphql-middleware": "0.29.0",
+    "@stonecrop/node-editor": "0.29.0",
+    "@stonecrop/nuxt-grafserv": "0.29.0",
+    "@stonecrop/schema": "0.29.0",
+    "@stonecrop/stonecrop": "0.29.0",
+    "@stonecrop/themes": "0.29.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",