create-avalon 0.1.24 → 0.1.25

package/README.md

@@ -22,6 +22,7 @@ The CLI walks you through:
 - Framework selection (React, Preact, Vue, Svelte, Solid, Lit, Qwik — or multiple)
 - Styling approach (CSS Modules, Tailwind, vanilla CSS)
 - Optional features (API routes, middleware, layouts, MDX)
+- Scheduled jobs (cron) — scaffolds an example task and wires up `nitro.cron`
 - Package manager preference
 
 ## What you get
@@ -43,6 +44,7 @@ my-project/
 ├── middleware/                  # Server middleware
 ├── routes/
 │   └── api/                    # API routes
+├── tasks/                      # Scheduled jobs (cron) — optional
 ├── server/                     # Server config & env
 ├── public/                     # Static assets
 ├── vite.config.ts

package/dist/cli.js

@@ -76,12 +76,65 @@ var require_src = __commonJS((exports, module) => {
 });
 
 // src/cli.ts
-import { basename, resolve } from "node:path";
 import { createRequire } from "node:module";
+import { basename, resolve } from "node:path";
 
 // src/cli-utils.ts
-import { parseArgs } from "node:util";
 import { existsSync, readdirSync } from "node:fs";
+import { parseArgs } from "node:util";
+
+// src/types.ts
+var RENDER_ENGINES = ["preact", "react"];
+var INTEGRATIONS = [
+  "preact",
+  "react",
+  "vue",
+  "svelte",
+  "solid",
+  "lit",
+  "qwik"
+];
+var STYLING_OPTIONS = [
+  "css-modules",
+  "tailwind",
+  "shadcn"
+];
+var PLUGINS = [
+  "seo",
+  "agent-optimization",
+  "syntax-highlighting"
+];
+var MIDDLEWARE_OPTIONS = [
+  "h3",
+  "hono",
+  "elysia"
+];
+var DEPLOY_TARGETS = ["netlify", "none"];
+var INTEGRATION_PACKAGES = {
+  preact: "@useavalon/preact",
+  react: "@useavalon/react",
+  vue: "@useavalon/vue",
+  svelte: "@useavalon/svelte",
+  solid: "@useavalon/solid",
+  lit: "@useavalon/lit",
+  qwik: "@useavalon/qwik"
+};
+var BASE_DIRS = [
+  "app/modules/main/pages",
+  "app/modules/main/components",
+  "app/modules/main/layouts",
+  "app/shared/layouts",
+  "app/shared/components",
+  "app/shared/styles",
+  "middleware",
+  "routes/api",
+  "public",
+  "server"
+];
+
+// src/cli-utils.ts
+class CliArgError extends Error {
+}
 function validateDirectory(dir) {
   if (!existsSync(dir)) {
     return { valid: true };
@@ -100,7 +153,15 @@ function parseCliArgs(argv) {
     args: argv,
     options: {
       help: { type: "boolean", default: false, short: "h" },
-      version: { type: "boolean", default: false, short: "v" }
+      version: { type: "boolean", default: false, short: "v" },
+      yes: { type: "boolean", default: false, short: "y" },
+      core: { type: "string" },
+      integrations: { type: "string" },
+      styling: { type: "string" },
+      plugins: { type: "string" },
+      middleware: { type: "string" },
+      deploy: { type: "string" },
+      cron: { type: "boolean", default: false }
     },
     strict: true,
     allowPositionals: true
@@ -108,7 +169,58 @@ function parseCliArgs(argv) {
   return {
     projectName: positionals[0] ?? undefined,
     help: values.help ?? false,
-    version: values.version ?? false
+    version: values.version ?? false,
+    yes: values.yes ?? false,
+    core: values.core,
+    integrations: values.integrations,
+    styling: values.styling,
+    plugins: values.plugins,
+    middleware: values.middleware,
+    deploy: values.deploy,
+    cron: values.cron ?? false
+  };
+}
+var csv = (value) => value ? value.split(",").map((v) => v.trim()).filter(Boolean) : undefined;
+function assertOneOf(value, allowed, flag) {
+  if (value === undefined)
+    return;
+  if (!allowed.includes(value)) {
+    throw new CliArgError(`Invalid value "${value}" for --${flag}. Allowed: ${allowed.join(", ")}.`);
+  }
+  return value;
+}
+function assertAllOf(values, allowed, flag) {
+  if (values === undefined)
+    return;
+  for (const value of values) {
+    if (!allowed.includes(value)) {
+      throw new CliArgError(`Invalid value "${value}" for --${flag}. Allowed: ${allowed.join(", ")}.`);
+    }
+  }
+  return values;
+}
+function resolveConfigNonInteractive(args) {
+  const core = assertOneOf(args.core, RENDER_ENGINES, "core") ?? "preact";
+  const integrations = assertAllOf(csv(args.integrations), INTEGRATIONS, "integrations") ?? [];
+  const styling = assertOneOf(args.styling, STYLING_OPTIONS, "styling") ?? "css-modules";
+  const plugins = assertAllOf(csv(args.plugins), PLUGINS, "plugins") ?? ["seo"];
+  const middleware = assertOneOf(args.middleware, MIDDLEWARE_OPTIONS, "middleware") ?? "h3";
+  const deploy = assertOneOf(args.deploy, DEPLOY_TARGETS, "deploy") ?? "none";
+  if (styling === "shadcn" && core !== "react") {
+    throw new CliArgError("--styling=shadcn requires --core=react (shadcn is Radix/React based).");
+  }
+  if (core === "react" && !integrations.includes("react")) {
+    integrations.push("react");
+  }
+  return {
+    projectName: args.projectName ?? ".",
+    core,
+    integrations,
+    styling,
+    plugins,
+    middleware,
+    deploy,
+    cron: args.cron
   };
 }
 
@@ -543,6 +655,25 @@ class Vt extends B {
     }
   }
 }
+
+class kt extends B {
+  get cursor() {
+    return this.value ? 0 : 1;
+  }
+  get _value() {
+    return this.cursor === 0;
+  }
+  constructor(e) {
+    super(e, false), this.value = !!e.initialValue, this.on("userInput", () => {
+      this.value = this._value;
+    }), this.on("confirm", (s) => {
+      this.output.write(import_sisteransi.cursor.move(0, -1)), this.value = s, this.state = "submit", this.close();
+    }), this.on("cursor", () => {
+      this.value = !this.value;
+    });
+  }
+}
+
 class yt extends B {
   options;
   cursor = 0;
@@ -961,6 +1092,33 @@ var X2 = ({ cursor: e, options: r, style: s, output: i = process.stdout, maxItem
       C.push(b);
   return $ && C.push(c), C;
 };
+var Rt = (e) => {
+  const r = e.active ?? "Yes", s = e.inactive ?? "No";
+  return new kt({ active: r, inactive: s, signal: e.signal, input: e.input, output: e.output, initialValue: e.initialValue ?? true, render() {
+    const i = e.withGuide ?? _.withGuide, a = `${i ? `${t("gray", h)}
+` : ""}${W2(this.state)}  ${e.message}
+`, o = this.value ? r : s;
+    switch (this.state) {
+      case "submit": {
+        const u = i ? `${t("gray", h)}  ` : "";
+        return `${a}${u}${t("dim", o)}`;
+      }
+      case "cancel": {
+        const u = i ? `${t("gray", h)}  ` : "";
+        return `${a}${u}${t(["strikethrough", "dim"], o)}${i ? `
+${t("gray", h)}` : ""}`;
+      }
+      default: {
+        const u = i ? `${t("cyan", h)}  ` : "", l = i ? t("cyan", x2) : "";
+        return `${a}${u}${this.value ? `${t("green", z2)} ${r}` : `${t("dim", H2)} ${t("dim", r)}`}${e.vertical ? i ? `
+${t("cyan", h)}  ` : `
+` : ` ${t("dim", "/")} `}${this.value ? `${t("dim", H2)} ${t("dim", s)}` : `${t("green", z2)} ${s}`}
+${l}
+`;
+      }
+    }
+  } }).prompt();
+};
 var Nt = (e = "", r) => {
   const s = r?.output ?? process.stdout, i = r?.withGuide ?? _.withGuide ? `${t("gray", x2)}  ` : "";
   s.write(`${i}${t("red", e)}
@@ -1124,6 +1282,26 @@ async function collectProjectConfig(initialName) {
     }
     projectName = nameResult;
   }
+  const coreResult = await Jt({
+    message: "Which rendering engine should render your pages (the shell)?",
+    options: [
+      {
+        value: "preact",
+        label: "Preact",
+        hint: "Smallest runtime (default). React libs run via preact/compat."
+      },
+      {
+        value: "react",
+        label: "React",
+        hint: "Real react-dom/server. React libs like Radix/shadcn work natively."
+      }
+    ],
+    initialValue: "preact"
+  });
+  if (Ct(coreResult)) {
+    Nt("Operation cancelled.");
+    process.exit(1);
+  }
   const integrationsResult = await Lt2({
     message: "Which integrations would you like to include? (use space to toggle, enter to confirm)",
     options: [
@@ -1141,13 +1319,20 @@ async function collectProjectConfig(initialName) {
     Nt("Operation cancelled.");
     process.exit(1);
   }
+  const stylingOptions = [
+    { value: "css-modules", label: "CSS Modules" },
+    { value: "tailwind", label: "Tailwind CSS" }
+  ];
+  if (coreResult === "react") {
+    stylingOptions.push({
+      value: "shadcn",
+      label: "shadcn",
+      hint: "Radix-based components — requires the React engine"
+    });
+  }
   const stylingResult = await Jt({
     message: "Which styling approach would you like to use?",
-    options: [
-      { value: "css-modules", label: "CSS Modules" },
-      { value: "tailwind", label: "Tailwind CSS" },
-      { value: "shadcn", label: "shadcn" }
-    ]
+    options: stylingOptions
   });
   if (Ct(stylingResult)) {
     Nt("Operation cancelled.");
@@ -1156,8 +1341,16 @@ async function collectProjectConfig(initialName) {
   const pluginsResult = await Lt2({
     message: "Which plugins would you like to include? (use space to toggle, enter to confirm)",
     options: [
-      { value: "seo", label: "seo", hint: "Auto-injects OG, Twitter cards, JSON-LD, canonical URLs" },
-      { value: "agent-optimization", label: "agent-optimization", hint: "LLM/AI optimization (llms.txt, markdown, sitemap)" },
+      {
+        value: "seo",
+        label: "seo",
+        hint: "Auto-injects OG, Twitter cards, JSON-LD, canonical URLs"
+      },
+      {
+        value: "agent-optimization",
+        label: "agent-optimization",
+        hint: "LLM/AI optimization (llms.txt, markdown, sitemap)"
+      },
       {
         value: "syntax-highlighting",
         label: "syntax-highlighting",
@@ -1186,7 +1379,11 @@ async function collectProjectConfig(initialName) {
   const deployResult = await Jt({
     message: "Where will you deploy?",
     options: [
-      { value: "netlify", label: "Netlify", hint: "Generates netlify.toml, build.mjs, post-build.mjs" },
+      {
+        value: "netlify",
+        label: "Netlify",
+        hint: "Generates netlify.toml, build.mjs, post-build.mjs"
+      },
       { value: "none", label: "None / Other", hint: "Node server preset, no deploy config" }
     ]
   });
@@ -1194,13 +1391,28 @@ async function collectProjectConfig(initialName) {
     Nt("Operation cancelled.");
     process.exit(1);
   }
+  const cronResult = await Rt({
+    message: "Set up scheduled jobs (cron)?",
+    initialValue: false
+  });
+  if (Ct(cronResult)) {
+    Nt("Operation cancelled.");
+    process.exit(1);
+  }
+  const core = coreResult;
+  const integrations = integrationsResult;
+  if (core === "react" && !integrations.includes("react")) {
+    integrations.push("react");
+  }
   return {
     projectName,
-    integrations: integrationsResult,
+    core,
+    integrations,
     styling: stylingResult,
     plugins: pluginsResult,
     middleware: middlewareResult,
-    deploy: deployResult
+    deploy: deployResult,
+    cron: cronResult
   };
 }
 
@@ -1218,6 +1430,31 @@ export default defineHandler(() => {
 `;
 }
 
+// src/templates/cron.ts
+var EXAMPLE_CRON_HANDLER = "tasks/cleanup.ts";
+var EXAMPLE_CRON_SCHEDULE = "0 * * * *";
+function generateExampleCronTask(_config) {
+  return `import { defineCronJob } from '@useavalon/avalon/cron';
+
+/**
+ * Example scheduled job. Runs on the schedule defined in vite.config.ts
+ * (\`nitro.cron\`). The task name is derived from this file path: "cleanup".
+ *
+ * In production this runs via your deployment preset's scheduler
+ * (Vercel Cron, Cloudflare Triggers, or the Node server's in-process
+ * scheduler). In development Avalon runs it inside the Vite dev server.
+ */
+export default defineCronJob({
+  meta: { description: 'Example scheduled job' },
+  async run() {
+    console.log('[cron] cleanup ran at', new Date().toISOString());
+    // TODO: replace with your scheduled work.
+    return { result: 'ok' };
+  },
+});
+`;
+}
+
 // src/templates/deploy.ts
 function generateNetlifyToml(_config) {
   return `[build]
@@ -1453,36 +1690,28 @@ export default defineHandler((event) => {
 `;
 }
 
-// src/types.ts
-var INTEGRATION_PACKAGES = {
-  preact: "@useavalon/preact",
-  react: "@useavalon/react",
-  vue: "@useavalon/vue",
-  svelte: "@useavalon/svelte",
-  solid: "@useavalon/solid",
-  lit: "@useavalon/lit",
-  qwik: "@useavalon/qwik"
-};
-var BASE_DIRS = [
-  "app/modules/main/pages",
-  "app/modules/main/components",
-  "app/modules/main/layouts",
-  "app/shared/layouts",
-  "app/shared/components",
-  "app/shared/styles",
-  "middleware",
-  "routes/api",
-  "public",
-  "server"
-];
-
 // src/templates/package-json.ts
+var INTEGRATION_RUNTIME_DEPS = {
+  preact: { preact: "^10.0.0", "preact-render-to-string": "^6.0.0" },
+  react: { react: "^19.0.0", "react-dom": "^19.0.0" },
+  vue: { vue: "^3.4.0" },
+  svelte: { svelte: "^5.0.0" },
+  solid: { "solid-js": "^1.8.0" },
+  lit: {
+    lit: "^3.0.0",
+    "@lit-labs/ssr": "^4.0.0",
+    "@lit-labs/ssr-client": "^1.0.0",
+    "@lit-labs/ssr-dom-shim": "^1.0.0"
+  },
+  qwik: { "@builder.io/qwik": "^1.5.0" }
+};
 function generatePackageJson(config) {
   const dependencies = {
     "@useavalon/avalon": "latest"
   };
   for (const integration of config.integrations) {
     dependencies[INTEGRATION_PACKAGES[integration]] = "latest";
+    Object.assign(dependencies, INTEGRATION_RUNTIME_DEPS[integration]);
   }
   if (config.plugins.includes("seo")) {
     dependencies["@useavalon/seo"] = "latest";
@@ -1830,7 +2059,7 @@ function generateShadcnComponentsJson(config) {
 }
 
 // src/templates/tsconfig.ts
-function generateTsConfig() {
+function generateTsConfig(core = "preact") {
   const tsconfig = {
     compilerOptions: {
       target: "ESNext",
@@ -1843,6 +2072,7 @@ function generateTsConfig() {
       allowImportingTsExtensions: true,
       noEmit: true,
       jsx: "react-jsx",
+      jsxImportSource: core,
       paths: {
         "@shared/*": ["./app/shared/*"],
         "@modules/*": ["./app/modules/*"]
@@ -1943,12 +2173,20 @@ function generateViteConfig(config) {
   if (needsTailwind) {
     pluginEntries.push(`    tailwindcss(),`);
   }
+  const cronLines = config.cron ? [
+    `      // Scheduled jobs (cron). Each entry maps a schedule to a task file`,
+    `      // in tasks/. See https://useavalon.dev/docs/cron-jobs`,
+    `      cron: [`,
+    `        { schedule: '${EXAMPLE_CRON_SCHEDULE}', handler: '${EXAMPLE_CRON_HANDLER}' },`,
+    `      ],`
+  ] : [];
   const lines = [
     imports.join(`
 `),
     "",
     `export default defineConfig(async (): Promise<UserConfig> => {`,
     `  const avalonPlugins = await avalon({`,
+    `    core: '${config.core}',`,
     `    integrations: [${integrationsList}],`,
     `    modules: 'app/modules',`,
     `    layoutsDir: 'app/shared/layouts',`,
@@ -1963,6 +2201,7 @@ function generateViteConfig(config) {
     `        crawlLinks: true,`,
     `        ignore: [],`,
     `      },`,
+    ...cronLines,
     `    },`,
     `  });`,
     "",
@@ -2053,7 +2292,7 @@ async function scaffoldProject(config, targetDir) {
     await mkdir(join(targetDir, dir), { recursive: true });
   }
   await writeFile(join(targetDir, "package.json"), generatePackageJson(config));
-  await writeFile(join(targetDir, "tsconfig.json"), generateTsConfig());
+  await writeFile(join(targetDir, "tsconfig.json"), generateTsConfig(config.core));
   await writeFile(join(targetDir, "vite.config.ts"), generateViteConfig(config));
   await writeFile(join(targetDir, "app/shared/layouts/_layout.tsx"), generateRootLayout(config));
   await writeFile(join(targetDir, "app/modules/main/layouts/_layout.tsx"), generateMainLayout(config));
@@ -2061,6 +2300,11 @@ async function scaffoldProject(config, targetDir) {
   await writeFile(join(targetDir, "app/modules/main/pages/404.tsx"), generate404Page());
   await writeFile(join(targetDir, "middleware/01.logger.ts"), generateSampleMiddleware(config));
   await writeFile(join(targetDir, "routes/api/hello.ts"), generateHelloRoute(config));
+  if (config.cron) {
+    const cronPath = join(targetDir, EXAMPLE_CRON_HANDLER);
+    await mkdir(dirname(cronPath), { recursive: true });
+    await writeFile(cronPath, generateExampleCronTask(config));
+  }
   if (config.middleware === "hono") {
     await writeFile(join(targetDir, "server.ts"), generateHonoServerEntry());
   } else if (config.middleware === "elysia") {
@@ -2076,6 +2320,8 @@ async function scaffoldProject(config, targetDir) {
   await writeFile(join(targetDir, "server/env.d.ts"), `/// <reference types="nitro" />
 `);
   await writeFile(join(targetDir, "app/env.d.ts"), generateEnvDts(config.integrations));
+  await writeFile(join(targetDir, "app/entry-client.ts"), `import "virtual:avalon/client-entry";
+`);
   await writeFile(join(targetDir, "server/renderer.ts"), [
     `/**`,
     ` * SSR Renderer — provided by Avalon's virtual module system.`,
@@ -2121,6 +2367,7 @@ function formatSummary(config, scaffoldedInPlace = false) {
     `  Plugins:        ${plugins}`,
     `  Middleware:     ${config.middleware}`,
     `  Deploy:        ${deploy}`,
+    `  Cron:           ${config.cron ? "yes" : "no"}`,
     "",
     "  Next steps:",
     ...nextSteps,
@@ -2142,11 +2389,28 @@ async function main() {
     process.exit(0);
   }
   if (args.help) {
-    console.log(`Usage: create-avalon [project-name]
-
-Options:
-  -v, --version  Show version number
-  -h, --help     Show help`);
+    console.log([
+      "Usage: create-avalon [project-name] [options]",
+      "",
+      "Runs interactively by default. Pass --yes (or run without a TTY, e.g. in",
+      "CI/Docker) to scaffold non-interactively from flags + defaults.",
+      "",
+      "Options:",
+      "  -v, --version        Show version number",
+      "  -h, --help           Show help",
+      "  -y, --yes            Skip prompts; use flags and defaults",
+      "      --core           Rendering engine: preact (default) | react",
+      "      --integrations   Comma list: preact,react,vue,svelte,solid,lit,qwik",
+      "      --styling        css-modules (default) | tailwind | shadcn",
+      "      --plugins        Comma list: seo (default),agent-optimization,syntax-highlighting",
+      "      --middleware     h3 (default) | hono | elysia",
+      "      --deploy         netlify | none (default)",
+      "      --cron           Scaffold an example cron task + config",
+      "",
+      "Example:",
+      "  create-avalon my-app --yes --core react --integrations react,vue --styling shadcn"
+    ].join(`
+`));
     process.exit(0);
   }
   if (args.projectName && args.projectName !== ".") {
@@ -2156,7 +2420,8 @@ Options:
       process.exit(1);
     }
   }
-  const config = await collectProjectConfig(args.projectName);
+  const nonInteractive = args.yes || !process.stdin.isTTY;
+  const config = nonInteractive ? resolveConfigNonInteractive(args) : await collectProjectConfig(args.projectName);
   if (!args.projectName && config.projectName !== ".") {
     const dirResult = validateDirectory(resolve(config.projectName));
     if (!dirResult.valid) {
@@ -2173,4 +2438,9 @@ Options:
   printSummary(config, scaffoldedInPlace);
   process.exit(0);
 }
-main();
+try {
+  await main();
+} catch (error) {
+  console.error(error instanceof CliArgError ? error.message : error);
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-avalon",
-	"version": "0.1.24",
+	"version": "0.1.25",
 	"description": "Scaffold a new Avalon project with multi-framework islands architecture",
 	"license": "MIT",
 	"type": "module",