@baybreezy/docd 0.1.11 → 0.2.0

package/app/assets/css/shadcn.css

@@ -610,3 +610,107 @@
     -webkit-text-fill-color: currentColor;
   }
 }
+
+/* Message entrance animations for the MessageScroller demos. */
+@keyframes ms-anim-fade {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+@keyframes ms-anim-slide-up {
+  from {
+    opacity: 0;
+    transform: translateY(10px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+@keyframes ms-anim-slide-side {
+  from {
+    opacity: 0;
+    transform: translateX(18px);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+@keyframes ms-anim-pop {
+  from {
+    opacity: 0;
+    transform: translateY(6px) scale(0.94);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0) scale(1);
+  }
+}
+@keyframes ms-anim-spring-bounce {
+  0% {
+    opacity: 0;
+    transform: translateY(12px) scale(0.96);
+  }
+  60% {
+    opacity: 1;
+    transform: translateY(-2px) scale(1.01);
+  }
+  100% {
+    opacity: 1;
+    transform: translateY(0) scale(1);
+  }
+}
+@keyframes ms-anim-blur-fade {
+  from {
+    opacity: 0;
+    filter: blur(4px);
+    transform: translateY(6px);
+  }
+  to {
+    opacity: 1;
+    filter: blur(0);
+    transform: translateY(0);
+  }
+}
+@keyframes ms-anim-scale-fade {
+  from {
+    opacity: 0;
+    transform: scale(0.98);
+  }
+  to {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+
+.ms-anim-fade {
+  animation: ms-anim-fade 0.26s cubic-bezier(0.16, 1, 0.3, 1) both;
+}
+.ms-anim-slide-up {
+  animation: ms-anim-slide-up 0.26s cubic-bezier(0.16, 1, 0.3, 1) both;
+}
+.ms-anim-slide-side {
+  animation: ms-anim-slide-side 0.3s cubic-bezier(0.16, 1, 0.3, 1) both;
+}
+.ms-anim-pop {
+  animation: ms-anim-pop 0.28s cubic-bezier(0.34, 1.56, 0.64, 1) both;
+}
+.ms-anim-spring-bounce {
+  animation: ms-anim-spring-bounce 0.5s cubic-bezier(0.34, 1.56, 0.64, 1) both;
+}
+.ms-anim-blur-fade {
+  animation: ms-anim-blur-fade 0.3s cubic-bezier(0.16, 1, 0.3, 1) both;
+}
+.ms-anim-scale-fade {
+  animation: ms-anim-scale-fade 0.24s cubic-bezier(0.16, 1, 0.3, 1) both;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  [class*="ms-anim-"] {
+    animation: none;
+  }
+}

package/index.d.ts

@@ -1,7 +1,9 @@
+import type { CssModuleOptions } from "./modules/css";
 import type { SkillsModuleOptions } from "./modules/skills";
 
 export interface DocdNuxtConfig {
   skills?: SkillsModuleOptions;
+  css?: CssModuleOptions;
 }
 
 declare module "@nuxt/schema" {

package/modules/css.ts

@@ -1,8 +1,33 @@
+import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
+import { dirname, isAbsolute, relative, resolve as resolvePath } from "node:path";
 
-import { addVitePlugin, createResolver, defineNuxtModule } from "@nuxt/kit";
+import { addVitePlugin, createResolver, defineNuxtModule, logger } from "@nuxt/kit";
+import { defu } from "defu";
 
-export default defineNuxtModule({
+export interface CssModuleOptions {
+  /**
+   * Paths (relative to the consuming app root, or absolute) to CSS files that
+   * should be merged into the layer's Tailwind entry.
+   *
+   * Files that only use `@apply` already work without this — they get
+   * `@reference` injected automatically.
+   *
+   * Use `extend` for anything that needs
+   * more than that (`@theme`, `@utility`, `@custom-variant`, etc.), since those
+   * only take effect when the file is part of the same Tailwind build as the
+   * layer, not a separate one started by its own `@import "tailwindcss"`.
+   */
+  extend?: string[];
+}
+
+const defaults: Required<CssModuleOptions> = {
+  extend: [],
+};
+
+const log = logger.withTag("Docd");
+
+export default defineNuxtModule<CssModuleOptions>({
   meta: {
     name: "docd:css",
   },
@@ -12,11 +37,30 @@ export default defineNuxtModule({
     // Absolute path to the layer's tailwind entry — resolved from this module's
     // location so it stays correct whether docd is local or installed from npm.
     const tailwindCssPath = resolver.resolve("../app/assets/css/tailwind.css").replace(/\\/g, "/");
+    const tailwindCssDir = dirname(tailwindCssPath);
 
     // Absolute paths that Tailwind needs to scan.
     const rootDir = nuxt.options.rootDir.replace(/\\/g, "/");
     const layerAppDir = resolver.resolve("../app").replace(/\\/g, "/");
 
+    const options = defu(
+      (nuxt.options as unknown as { docd?: { css?: CssModuleOptions } }).docd?.css,
+      defaults
+    ) as Required<CssModuleOptions>;
+
+    // Resolve and validate consumer-provided files that opt into being merged
+    // into the layer's single Tailwind build.
+    const extendPaths = options.extend
+      .map((file) =>
+        (isAbsolute(file) ? file : resolvePath(nuxt.options.rootDir, file)).replace(/\\/g, "/")
+      )
+      .filter((file) => {
+        if (existsSync(file)) return true;
+        log.warn(`docd.css.extend: CSS file not found, skipping: ${file}`);
+        return false;
+      });
+    const extendPathSet = new Set(extendPaths);
+
     // Use the `load` hook rather than `transform` so our modified source is
     // visible to @tailwindcss/vite's transform hook (which has enforce:"pre"
     // and is registered earlier). Vite always runs `load` before `transform`.
@@ -28,10 +72,21 @@ export default defineNuxtModule({
         if (cleanId !== tailwindCssPath) return null;
 
         const code = await readFile(tailwindCssPath, "utf8");
+
+        // `@import` each consumer-registered file so it's part of this same
+        // Tailwind compilation (one theme/base/utilities pass) instead of
+        // starting its own via a separate `@import "tailwindcss"`.
+        const extendImports = extendPaths.map((file) => {
+          this.addWatchFile(file);
+          const rel = relative(tailwindCssDir, file).replace(/\\/g, "/");
+          return `@import ${JSON.stringify(rel.startsWith(".") ? rel : `./${rel}`)};`;
+        });
+
         return [
           code,
           `@source ${JSON.stringify(`${rootDir}/**/*`)};`,
           `@source ${JSON.stringify(`${layerAppDir}/**/*`)};`,
+          ...extendImports,
         ].join("\n");
       },
     });
@@ -48,6 +103,10 @@ export default defineNuxtModule({
         if (!cleanId?.endsWith(".css")) return null;
         // Skip the layer's own tailwind entry — it already has @import "tailwindcss".
         if (cleanId === tailwindCssPath) return null;
+        // Skip files merged in via `docd.css.extend` — they're already `@import`ed
+        // into the tailwind entry above, so injecting `@reference` back to that
+        // same entry here would create a circular import.
+        if (extendPathSet.has(cleanId)) return null;
         // Only touch files inside the consuming app root, not node_modules or the layer.
         if (!cleanId.startsWith(`${rootDir}/`)) return null;
         if (cleanId.startsWith(`${layerAppDir}/`)) return null;
@@ -76,11 +135,11 @@ export default defineNuxtModule({
 
     // Suppress noisy Vite warnings produced during Tailwind's build pass.
     nuxt.hook("vite:extendConfig", (config) => {
-      const logger = config.customLogger;
-      if (!logger) return;
+      const viteLogger = config.customLogger;
+      if (!viteLogger) return;
       const ignore = ["@tailwindcss/vite:generate:build", "nuxt:module-preload-polyfill"];
-      const originalWarn = logger.warn.bind(logger);
-      logger.warn = (msg, options) => {
+      const originalWarn = viteLogger.warn.bind(viteLogger);
+      viteLogger.warn = (msg, options) => {
         if (ignore.some((p) => msg.includes(p))) return;
         originalWarn(msg, options);
       };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baybreezy/docd",
-  "version": "0.1.11",
+  "version": "0.2.0",
   "description": "A Nuxt layer for building documentation sites with UI Thing.",
   "repository": {
     "type": "git",
@@ -31,42 +31,42 @@
   },
   "dependencies": {
     "@baybreezy/file-extension-icon": "^0.0.5",
-    "@iconify-json/lucide": "^1.2.114",
-    "@iconify-json/material-icon-theme": "^1.2.67",
-    "@iconify-json/simple-icons": "^1.2.86",
-    "@iconify/utils": "^3.1.3",
+    "@iconify-json/lucide": "^1.2.116",
+    "@iconify-json/material-icon-theme": "^1.2.69",
+    "@iconify-json/simple-icons": "^1.2.89",
+    "@iconify/utils": "^3.1.4",
     "@morev/vue-transitions": "^3.0.5",
-    "@nuxt/content": "3.14.0",
+    "@nuxt/content": "3.15.0",
     "@nuxt/fonts": "^0.14.0",
-    "@nuxt/icon": "^2.2.3",
+    "@nuxt/icon": "^2.3.1",
     "@nuxt/image": "2.0.0",
     "@nuxt/kit": "^4.4.8",
     "@nuxtjs/color-mode": "^4.0.1",
     "@nuxtjs/mcp-toolkit": "^0.17.2",
-    "@nuxtjs/mdc": "^0.22.0",
-    "@nuxtjs/robots": "^6.1.1",
+    "@nuxtjs/mdc": "^0.22.1",
+    "@nuxtjs/robots": "^6.1.2",
     "@tailwindcss/forms": "^0.5.11",
     "@tailwindcss/typography": "^0.5.20",
-    "@tailwindcss/vite": "^4.3.1",
-    "@takumi-rs/core": "^1.8.7",
+    "@tailwindcss/vite": "^4.3.2",
+    "@takumi-rs/core": "^2.0.3",
     "@vueuse/core": "^14.3.0",
     "@vueuse/nuxt": "^14.3.0",
     "better-sqlite3": "^12.11.1",
     "defu": "^6.1.7",
     "git-url-parse": "^16.1.0",
     "lodash-es": "^4.18.1",
-    "mermaid": "^11.15.0",
+    "mermaid": "^11.16.0",
     "motion-v": "^2.3.0",
     "nuxt-component-meta": "^0.17.2",
     "nuxt-gtag": "4.1.0",
     "nuxt-llms": "^0.2.0",
-    "nuxt-og-image": "^6.6.0",
+    "nuxt-og-image": "^6.7.2",
     "pkg-types": "^2.3.1",
-    "reka-ui": "^2.10.0",
-    "shiki": "^4.2.0",
+    "reka-ui": "^2.10.1",
+    "shiki": "^4.3.1",
     "tailwind-merge": "^3.6.0",
     "tailwind-variants": "^3.2.2",
-    "tailwindcss": "^4.3.1",
+    "tailwindcss": "^4.3.2",
     "tw-animate-css": "^1.4.0",
     "ufo": "^1.6.4",
     "vaul-vue": "^0.4.1",