alchemy 0.2.5 → 0.3.0

package/lib/web/tailwind.js

@@ -0,0 +1,97 @@
+import { exec } from "child_process";
+import path from "path";
+import { promisify } from "util";
+import { Folder, StaticTextFile } from "../fs";
+import { Resource } from "../resource";
+const execAsync = promisify(exec);
+/**
+ * Installs and configures Tailwind CSS for a project
+ *
+ * @example
+ * // Install Tailwind for a Vite project
+ * const tailwind = await TailwindConfig("vite-tailwind", {
+ *   cwd: "my-vite-app",
+ *   framework: "vite"
+ * });
+ *
+ * @example
+ * // Install Tailwind for an Astro project
+ * const tailwind = await TailwindConfig("astro-tailwind", {
+ *   cwd: "my-astro-app",
+ *   framework: "astro"
+ * });
+ *
+ * @example
+ * // Install Tailwind as standalone with a custom CSS path
+ * const tailwind = await TailwindConfig("custom-tailwind", {
+ *   cwd: "my-project",
+ *   cssPath: "src/css/main.css",
+ *   additionalPackages: ["@tailwindcss/typography", "@tailwindcss/forms"]
+ * });
+ */
+export const TailwindConfig = Resource("config::TailwindConfig", async function (id, props) {
+    if (this.phase === "delete") {
+        // Nothing to clean up specifically for Tailwind
+        return this.destroy();
+    }
+    const framework = props.framework || "standalone";
+    // Setup execAsync with the correct cwd
+    const exec = (command) => execAsync(command, { cwd: props.cwd });
+    // Install Tailwind and framework-specific dependencies
+    await installTailwindDependencies(framework);
+    // Create CSS file with Tailwind directives
+    await createTailwindCssFile();
+    return this({
+        ...props,
+        framework: framework,
+    });
+    /**
+     * Install Tailwind and framework-specific dependencies
+     */
+    async function installTailwindDependencies(framework) {
+        const basePackages = ["tailwindcss", "postcss", "autoprefixer"];
+        // Add framework-specific packages
+        const frameworkPackages = getFrameworkPackages(framework);
+        // Add custom additional packages
+        const additionalPackages = props.additionalPackages || [];
+        // Combine all packages
+        const allPackages = [
+            ...basePackages,
+            ...frameworkPackages,
+            ...additionalPackages,
+        ];
+        // Install all packages
+        await exec(`bun add -D ${allPackages.join(" ")}`);
+    }
+    /**
+     * Get framework-specific packages for Tailwind
+     */
+    function getFrameworkPackages(framework) {
+        switch (framework) {
+            case "vite":
+                return ["@tailwindcss/vite"];
+            case "astro":
+                return ["@astrojs/tailwind"];
+            case "next":
+                return [];
+            case "standalone":
+            default:
+                return [];
+        }
+    }
+    /**
+     * Create or update CSS file with Tailwind directives
+     */
+    async function createTailwindCssFile() {
+        const tailwindDirectives = `@import 'tailwindcss';`;
+        // Determine CSS file path
+        const cssPath = props.cssPath || path.join(props.cwd, "src", "styles", "global.css");
+        // Create directory structure if needed
+        const cssDir = path.dirname(cssPath);
+        await Folder(path.join(id, "css-dir"), {
+            path: cssDir,
+        });
+        // Create CSS file with Tailwind directives
+        await StaticTextFile(cssPath, tailwindDirectives);
+    }
+});

package/lib/{vite → web}/vite.d.ts

@@ -79,6 +79,11 @@ export interface ViteProjectProps {
      * @default false
      */
     overwrite?: boolean;
+    /**
+     * Whether to delete the project folder during the delete phase
+     * @default true
+     */
+    delete?: boolean;
 }
 export interface ViteProject extends ViteProjectProps, Resource {
     /**

package/lib/{vite → web}/vite.js

@@ -1,10 +1,11 @@
 import { exec } from "child_process";
-import fs from "fs/promises";
 import path from "path";
 import { promisify } from "util";
+import { Folder, StaticJsonFile, StaticTypeScriptFile } from "../fs";
 import { Resource } from "../resource";
-import { ShadcnComponent } from "../shadcn/component";
 import { rm } from "../util/rm";
+import { ShadcnComponent } from "./shadcn-component";
+import { TailwindConfig } from "./tailwind";
 const execAsync = promisify(exec);
 export const ViteProject = Resource("project::ViteProject", {
     alwaysUpdate: true,
@@ -12,9 +13,8 @@ export const ViteProject = Resource("project::ViteProject", {
     const phase = this.phase;
     if (this.phase === "delete") {
         try {
-            if (await fs.exists(props.name)) {
-                // TODO: OS agnostic - fs.rm is slow to delete node_modules/
-                await execAsync("rm -rf " + props.name);
+            if (props.delete !== false) {
+                await execAsync(`rm -rf ${props.name}`);
             }
         }
         catch (error) {
@@ -45,6 +45,11 @@ export const ViteProject = Resource("project::ViteProject", {
             "react()",
         ].filter((s) => typeof s === "string");
         const cwd = path.resolve(process.cwd(), props.name);
+        // Create folder for project
+        await Folder("project-dir", {
+            path: props.name,
+            delete: props.delete,
+        });
         const exec = (command) => execAsync(command, { cwd });
         if (phase === "create" || props.overwrite) {
             await removeUnnecessaryFiles();
@@ -65,8 +70,11 @@ export const ViteProject = Resource("project::ViteProject", {
             await execAsync(`bun vite build`, { cwd: props.name });
         }
         async function installTailwind() {
-            await exec(`bun add tailwindcss @tailwindcss/vite`);
-            await fs.writeFile(path.join(props.name, "vite.config.ts"), `import path from "path";
+            await TailwindConfig(`${id}-tailwind`, {
+                cwd: props.name,
+                framework: "vite",
+            });
+            await StaticTypeScriptFile(path.join(props.name, "vite.config.ts"), `import path from "path";
 import react from "@vitejs/plugin-react";
 import { defineConfig } from "vite";
 ${tailwind ? "import tailwindcss from '@tailwindcss/vite';" : ""}
@@ -81,12 +89,6 @@ export default defineConfig({
     },
   },
 });`);
-            // Add Tailwind CSS import to index.css
-            const indexCssPath = path.join(props.name, "src", "index.css");
-            const currentCss = await fs.readFile(indexCssPath, "utf-8");
-            if (!currentCss.includes('@import "tailwindcss";')) {
-                await fs.writeFile(indexCssPath, '@import "tailwindcss";\n\n' + currentCss);
-            }
         }
         async function installShadcn() {
             await exec("bun add -D @types/node");
@@ -120,8 +122,12 @@ export default defineConfig({
             await exec(`bun add -D @tanstack/router-plugin @tanstack/react-router-devtools`);
             const src = path.join(props.name, "src");
             const routes = path.join(src, "routes");
-            await fs.mkdir(routes, { recursive: true });
-            await fs.writeFile(path.join(routes, "__root.tsx"), `import { Link, Outlet, createRootRoute } from "@tanstack/react-router";
+            // Create routes directory
+            await Folder("routes-dir", {
+                path: routes,
+            });
+            // Create root route file
+            await StaticTypeScriptFile(path.join(routes, "__root.tsx"), `import { Link, Outlet, createRootRoute } from "@tanstack/react-router";
 import { TanStackRouterDevtools } from "@tanstack/react-router-devtools";
 
 export const Route = createRootRoute({
@@ -142,7 +148,8 @@ export const Route = createRootRoute({
   ),
 });
 `);
-            await fs.writeFile(path.join(routes, "index.tsx"), `import { createLazyFileRoute } from '@tanstack/react-router'
+            // Create index route file
+            await StaticTypeScriptFile(path.join(routes, "index.tsx"), `import { createLazyFileRoute } from '@tanstack/react-router'
 
 export const Route = createLazyFileRoute('/')({
   component: Index,
@@ -155,7 +162,8 @@ function Index() {
     </div>
   )
 }`);
-            await fs.writeFile(path.join(routes, "about.tsx"), `import { createLazyFileRoute } from '@tanstack/react-router'
+            // Create about route file
+            await StaticTypeScriptFile(path.join(routes, "about.tsx"), `import { createLazyFileRoute } from '@tanstack/react-router'
 
 export const Route = createLazyFileRoute('/about')({
   component: About,
@@ -164,7 +172,8 @@ export const Route = createLazyFileRoute('/about')({
 function About() {
   return <div className="p-2">Hello from About!</div>
 }`);
-            await fs.writeFile(path.join(src, "main.tsx"), `import { StrictMode } from 'react'
+            // Create main.tsx
+            await StaticTypeScriptFile(path.join(src, "main.tsx"), `import { StrictMode } from 'react'
 import ReactDOM from 'react-dom/client'
 import { RouterProvider, createRouter } from '@tanstack/react-router'
 import './index.css'
@@ -194,35 +203,26 @@ if (!rootElement.innerHTML) {
 }`);
         }
         async function removeUnnecessaryFiles() {
-            await Promise.all([
-                rm(path.join(props.name, "src", "App.tsx")),
-                rm(path.join(props.name, "src", "App.css")),
-            ]);
+            await rm(path.join(props.name, "src", "App.tsx"));
+            await rm(path.join(props.name, "src", "App.css"));
         }
         async function patchTsConfig() {
-            await Promise.all([
-                rm(path.join(props.name, "tsconfig.app.json")),
-                rm(path.join(props.name, "tsconfig.node.json")),
-                fs.writeFile(path.join(props.name, "tsconfig.json"), JSON.stringify({
-                    extends: props.extends,
-                    compilerOptions: {
-                        baseUrl: ".",
-                        paths: {
-                            "@/*": ["./src/*"],
-                        },
-                        types: ["@cloudflare/workers-types"],
-                        allowImportingTsExtensions: true,
-                        jsx: "react-jsx",
+            await rm(path.join(props.name, "tsconfig.app.json"));
+            await rm(path.join(props.name, "tsconfig.node.json"));
+            await StaticJsonFile(path.join(props.name, "tsconfig.json"), {
+                extends: props.extends,
+                compilerOptions: {
+                    baseUrl: ".",
+                    paths: {
+                        "@/*": ["./src/*"],
                     },
-                    include: [
-                        "vite/*.ts",
-                        "src/**/*.ts",
-                        "src/**/*.tsx",
-                        "src/env.d.ts",
-                    ],
-                    references: props.references?.map((path) => ({ path })),
-                }, null, 2)),
-            ]);
+                    types: ["@cloudflare/workers-types"],
+                    allowImportingTsExtensions: true,
+                    jsx: "react-jsx",
+                },
+                include: ["vite/*.ts", "src/**/*.ts", "src/**/*.tsx", "src/env.d.ts"],
+                references: props.references?.map((path) => ({ path })),
+            });
         }
     }
 });

package/lib/web/vitepress/custom-theme.d.ts

@@ -0,0 +1,173 @@
+import type { ModelConfig } from "../../ai/client";
+import type { Context } from "../../context";
+import { Resource } from "../../resource";
+import type { Secret } from "../../secret";
+/**
+ * Theme component props for customizing the layout
+ */
+export interface ThemeComponentProps {
+    /**
+     * Name of the component
+     */
+    name: string;
+    /**
+     * Description of what the component does
+     */
+    description: string;
+    /**
+     * Features or functionality to include in the component
+     */
+    features?: string[];
+}
+/**
+ * Properties for creating or updating a VitePress custom theme
+ */
+export interface CustomThemeProps {
+    /**
+     * Output directory for the theme files
+     */
+    outDir: string;
+    /**
+     * Title of the theme
+     */
+    title: string;
+    /**
+     * Description of the theme
+     */
+    description: string;
+    /**
+     * Components to include in the theme
+     */
+    components?: ThemeComponentProps[];
+    /**
+     * Whether to include dark mode support
+     * @default true
+     */
+    darkMode?: boolean;
+    /**
+     * Custom CSS variables for theming
+     */
+    customCssVars?: Record<string, string>;
+    /**
+     * Custom plugins to add to the theme
+     */
+    plugins?: string[];
+    /**
+     * User prompt describing the design of the theme
+     */
+    prompt: string;
+    /**
+     * Optional extension to the built-in system prompt
+     */
+    systemPromptExtension?: string;
+    /**
+     * Base URL for the OpenAI API
+     * @default 'https://api.openai.com/v1'
+     */
+    baseURL?: string;
+    /**
+     * OpenAI API key to use for generating content
+     * If not provided, will use OPENAI_API_KEY environment variable
+     */
+    apiKey?: Secret;
+    /**
+     * Model configuration for the AI generator
+     */
+    model?: ModelConfig;
+    /**
+     * Temperature for controlling randomness in generation
+     * @default 0.7
+     */
+    temperature?: number;
+}
+/**
+ * A generated file in the custom theme
+ */
+export interface ThemeFile {
+    /**
+     * Path to the file
+     */
+    path: string;
+    /**
+     * Content of the file
+     */
+    content: string;
+}
+/**
+ * Output for the VitePress custom theme resource
+ */
+export interface CustomTheme extends CustomThemeProps, Resource<"vitepress::CustomTheme"> {
+    /**
+     * Path to the generated theme directory
+     */
+    themePath: string;
+    /**
+     * List of generated files
+     */
+    files: ThemeFile[];
+    /**
+     * Time at which the theme was created
+     */
+    createdAt: number;
+    /**
+     * Time at which the theme was last updated
+     */
+    updatedAt: number;
+}
+/**
+ * Resource for generating a custom VitePress theme using AI.
+ *
+ * Generates the necessary theme files including:
+ * - Theme entry file (index.ts)
+ * - Layout component (Layout.vue)
+ * - Additional components based on configuration
+ * - Style sheets and utilities
+ *
+ * @example
+ * // Create a basic custom theme
+ * const theme = await CustomTheme("docs-theme", {
+ *   outDir: "./.vitepress/theme",
+ *   title: "My Custom Theme",
+ *   description: "A clean, minimal theme for documentation",
+ *   prompt: "Create a clean documentation theme with a sidebar and search"
+ * });
+ *
+ * @example
+ * // Create a theme with specific components
+ * const complexTheme = await CustomTheme("blog-theme", {
+ *   outDir: "./.vitepress/theme",
+ *   title: "Blog Theme",
+ *   description: "A theme for technical blogs",
+ *   components: [
+ *     {
+ *       name: "PostList",
+ *       description: "Component that displays a list of blog posts with pagination",
+ *       features: ["thumbnail images", "post dates", "categories", "excerpts"]
+ *     },
+ *     {
+ *       name: "TableOfContents",
+ *       description: "Component that displays the current page's table of contents",
+ *       features: ["sticky positioning", "active link highlighting"]
+ *     }
+ *   ],
+ *   darkMode: true,
+ *   prompt: "Create a modern blog theme with post listings and detailed article pages"
+ * });
+ *
+ * @example
+ * // Create a theme with custom CSS variables
+ * const brandedTheme = await CustomTheme("branded-theme", {
+ *   outDir: "./.vitepress/theme",
+ *   title: "Branded Docs",
+ *   description: "A themed documentation site with custom branding",
+ *   customCssVars: {
+ *     "--vp-c-brand": "#3a70b0",
+ *     "--vp-c-brand-light": "#5785bc",
+ *     "--vp-c-brand-lighter": "#79a1ce",
+ *     "--vp-c-brand-dark": "#2c5989",
+ *     "--vp-c-brand-darker": "#1e3d5c"
+ *   },
+ *   prompt: "Create a documentation theme with custom branding and color scheme"
+ * });
+ */
+export declare const CustomTheme: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<CustomTheme>, id: string, props: CustomThemeProps) => Promise<CustomTheme>);