mikuru 1.0.8 → 1.0.10

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 1.0.10
+
+### Added
+
+- Added template discovery with `mikuru --list-templates`, `mikuru create --list-templates`, template descriptions, and `mikuru create -t <name>`.
+- Added interactive `mikuru create` prompts for missing project name/template values, with `--yes` / `-y` defaulting for non-interactive runs.
+- Added `mikuru create --dry-run` to preview the target, selected template, and generated files without writing them.
+- Added generated app `npm run typecheck` scripts, template `tsconfig.json` files, and CSS module declarations.
+- Added template version, generated app typecheck, docs smoke, and package smoke coverage for the create flow.
+
+### Changed
+
+- Made generated project templates use the installed Mikuru package version instead of hard-coded release versions.
+- Improved `mikuru create .` output so it does not print an unnecessary `cd .` next step.
+- Split create-template metadata out of the CLI entrypoint to keep future CLI options easier to add.
+- Clarified release checklist steps for pushing `master`, pushing tags, creating GitHub Releases, and deleting merged work branches.
+
+### Fixed
+
+- Added friendlier unknown-template errors with typo suggestions such as `Did you mean starter?`.
+- Removed the Windows npm pack smoke path that triggered Node's `DEP0190` shell warning.
+
+## 1.0.9
+
+- Updated generated project templates to depend on Mikuru `^1.0.9`.
+
 ## 1.0.8
 
 - Added a realworld app architecture guide and split the realworld example into page, feature, API, store, UI, and test layers.

package/README.md

@@ -17,6 +17,7 @@ The fastest way to try Mikuru is the package CLI:
 npx mikuru create my-app
 cd my-app
 npm install
+npm run typecheck
 npm run dev
 ```
 
@@ -25,10 +26,26 @@ The generated starter includes Vite, TypeScript, the package-provided `.mikuru`
 Use the `basic` template when you want a small component composition example:
 
 ```sh
-npx mikuru create my-basic-app --template basic
+npx mikuru create my-basic-app -t basic
+```
+
+List available templates:
+
+```sh
+npx mikuru --list-templates
+starter - minimal Vite app
+basic - component composition example
 ```
 
-`mikuru create` also accepts `--force` for non-empty directories and `--yes` / `-y` to use default answers for prompts.
+Run a dry-run to preview the target, template, and files without writing them:
+
+```sh
+npx mikuru create my-app -t basic --dry-run
+```
+
+When run in a terminal, `mikuru create` asks for a project name and template if they are omitted. Use `--yes` / `-y` to skip interactive prompts and accept defaults. `mikuru create` also accepts `--force` for non-empty directories.
+
+Generated apps include `npm run typecheck` for a quick TypeScript validation pass before running or building.
 
 ## Add Mikuru to a Vite App
 
@@ -153,7 +170,8 @@ The package also provides the `mikuru` binary:
 
 ```sh
 npx mikuru create my-app
-npx mikuru create my-basic-app --template basic
+npx mikuru create my-basic-app -t basic
+npx mikuru --list-templates
 ```
 
 ## Not Included in v1

package/dist/cli/create.d.ts

@@ -0,0 +1 @@
+export declare function handleCreateCommand(createArgs: string[], packageVersion: string): Promise<void>;

package/dist/cli/create.js

@@ -0,0 +1,263 @@
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, relative, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import { availableTemplates, formatTemplateList, formatTemplatesForError, isTemplateName, suggestTemplateName, templateDescriptions } from "./templates.js";
+export async function handleCreateCommand(createArgs, packageVersion) {
+    const createOptions = parseCreateArgs(createArgs);
+    if (!createOptions) {
+        process.exit(1);
+    }
+    const resolvedOptions = await resolveCreateOptions(createOptions);
+    const { dryRun, force, targetArg, templateName } = resolvedOptions;
+    const targetDir = resolve(process.cwd(), targetArg ?? "mikuru-app");
+    const appName = toPackageName(basename(targetDir));
+    const templateDir = resolve(dirname(fileURLToPath(import.meta.url)), `../../templates/${templateName}`);
+    if (!dryRun && !force && existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+        console.error(`Cannot create a Mikuru app in a non-empty directory: ${targetDir}`);
+        console.error("Choose a new directory name, empty the target directory, or pass --force to overwrite template files.");
+        process.exit(1);
+    }
+    if (dryRun) {
+        printCreateDryRun(templateDir, targetDir, { appName, packageVersion, templateName });
+        process.exit(0);
+    }
+    copyTemplate(templateDir, targetDir, { appName, packageVersion });
+    printCreateSuccess(targetDir, appName, templateName);
+}
+function printCreateHelp() {
+    console.log(`Usage:
+  mikuru create [project-name] [--template starter|basic]
+
+Options:
+  -t, --template <name>  Template to use. Available: ${availableTemplates.join(", ")}.
+  --list-templates       List available create templates with descriptions.
+  --dry-run              Print the target, template, and files without writing them.
+  --force                Create into a non-empty directory and overwrite template files.
+  -y, --yes              Use default answers and skip interactive prompts.
+  -h, --help             Show create help.`);
+}
+function printTemplates() {
+    console.log(formatTemplateList());
+}
+function printTemplateNextStep(templateName) {
+    if (templateName === "basic") {
+        console.log("  edit src/App.mikuru and src/MoodBadge.mikuru");
+        return;
+    }
+    console.log("  edit src/App.mikuru");
+}
+function parseCreateArgs(createArgs) {
+    let dryRun = false;
+    let force = false;
+    let targetArg;
+    let templateName = "starter";
+    let templateProvided = false;
+    let yes = false;
+    for (let i = 0; i < createArgs.length; i++) {
+        const arg = createArgs[i];
+        if (arg === "--help" || arg === "-h") {
+            printCreateHelp();
+            process.exit(0);
+        }
+        if (arg === "--force") {
+            force = true;
+            continue;
+        }
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        if (arg === "--yes" || arg === "-y") {
+            yes = true;
+            continue;
+        }
+        if (arg === "--list-templates") {
+            printTemplates();
+            process.exit(0);
+        }
+        if (arg === "--template" || arg === "-t") {
+            const nextValue = createArgs[++i];
+            if (!nextValue) {
+                console.error(`Missing value for ${arg}.`);
+                printCreateHelp();
+                return undefined;
+            }
+            templateName = nextValue;
+            templateProvided = true;
+            continue;
+        }
+        if (arg.startsWith("--template=")) {
+            templateName = arg.slice("--template=".length);
+            templateProvided = true;
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            console.error(`Unknown create option: ${arg}`);
+            printCreateHelp();
+            return undefined;
+        }
+        if (targetArg) {
+            console.error(`Unexpected extra argument: ${arg}`);
+            printCreateHelp();
+            return undefined;
+        }
+        targetArg = arg;
+    }
+    if (!isTemplateName(templateName)) {
+        console.error(`Unknown template: ${templateName}`);
+        const suggestion = suggestTemplateName(templateName);
+        if (suggestion) {
+            console.error(`Did you mean ${suggestion}?`);
+        }
+        console.error("Available templates:");
+        console.error(formatTemplatesForError());
+        console.error("Run `mikuru create --list-templates` to see template descriptions.");
+        return undefined;
+    }
+    return { dryRun, force, targetArg, templateName, templateProvided, yes };
+}
+async function resolveCreateOptions(options) {
+    if (options.yes || !canPrompt()) {
+        return options;
+    }
+    if (process.env.MIKURU_TEST_FORCE_PROMPTS === "1") {
+        return resolveCreateOptionsFromInput(options, readFileSync(0, "utf8").split(/\r?\n/));
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        let targetArg = options.targetArg;
+        let templateName = options.templateName;
+        let templateProvided = options.templateProvided;
+        if (!targetArg) {
+            const answer = (await rl.question("Project name (mikuru-app): ")).trim();
+            targetArg = answer || "mikuru-app";
+        }
+        if (!templateProvided) {
+            printTemplates();
+            const answer = (await rl.question("Template (starter): ")).trim();
+            if (answer) {
+                const suggestion = isTemplateName(answer) ? undefined : suggestTemplateName(answer);
+                if (!isTemplateName(answer)) {
+                    console.error(`Unknown template: ${answer}`);
+                    if (suggestion) {
+                        console.error(`Did you mean ${suggestion}?`);
+                    }
+                    console.error("Available templates:");
+                    console.error(formatTemplatesForError());
+                    process.exit(1);
+                }
+                templateName = answer;
+                templateProvided = true;
+            }
+        }
+        return { ...options, targetArg, templateName, templateProvided };
+    }
+    finally {
+        rl.close();
+    }
+}
+function resolveCreateOptionsFromInput(options, answers) {
+    let targetArg = options.targetArg;
+    let templateName = options.templateName;
+    let templateProvided = options.templateProvided;
+    if (!targetArg) {
+        process.stdout.write("Project name (mikuru-app): ");
+        targetArg = answers.shift()?.trim() || "mikuru-app";
+    }
+    if (!templateProvided) {
+        printTemplates();
+        process.stdout.write("Template (starter): ");
+        const answer = answers.shift()?.trim();
+        if (answer) {
+            if (!isTemplateName(answer)) {
+                console.error(`Unknown template: ${answer}`);
+                const suggestion = suggestTemplateName(answer);
+                if (suggestion) {
+                    console.error(`Did you mean ${suggestion}?`);
+                }
+                console.error("Available templates:");
+                console.error(formatTemplatesForError());
+                process.exit(1);
+            }
+            templateName = answer;
+            templateProvided = true;
+        }
+    }
+    return { ...options, targetArg, templateName, templateProvided };
+}
+function canPrompt() {
+    return process.env.MIKURU_TEST_FORCE_PROMPTS === "1" || Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+function printCreateSuccess(targetDir, appName, templateName) {
+    console.log(`Created ${appName}`);
+    console.log(`  Template: ${templateName}`);
+    console.log(`  Location: ${targetDir}`);
+    console.log("");
+    console.log("Next steps:");
+    const relativeTargetDir = relative(process.cwd(), targetDir);
+    if (relativeTargetDir && relativeTargetDir !== ".") {
+        console.log(`  cd ${relativeTargetDir}`);
+    }
+    console.log("  npm install");
+    console.log("  npm run dev");
+    printTemplateNextStep(templateName);
+}
+function printCreateDryRun(templateDir, targetDir, variables) {
+    console.log("Dry run: no files will be written.");
+    console.log(`  App name: ${variables.appName}`);
+    console.log(`  Template: ${variables.templateName} - ${templateDescriptions[variables.templateName]}`);
+    console.log(`  Location: ${targetDir}`);
+    console.log("");
+    console.log("Files:");
+    for (const filePath of listTemplateFiles(templateDir, targetDir)) {
+        console.log(`  ${relative(process.cwd(), filePath)}`);
+    }
+}
+function listTemplateFiles(sourceDir, targetDir) {
+    const files = [];
+    for (const entry of readdirSync(sourceDir)) {
+        const sourcePath = join(sourceDir, entry);
+        const targetName = entry === "_gitignore" ? ".gitignore" : entry;
+        const targetPath = join(targetDir, targetName);
+        const stat = statSync(sourcePath);
+        if (stat.isDirectory()) {
+            files.push(...listTemplateFiles(sourcePath, targetPath));
+            continue;
+        }
+        files.push(targetPath);
+    }
+    return files;
+}
+function copyTemplate(sourceDir, targetDir, variables) {
+    mkdirSync(targetDir, { recursive: true });
+    for (const entry of readdirSync(sourceDir)) {
+        const sourcePath = join(sourceDir, entry);
+        const targetName = entry === "_gitignore" ? ".gitignore" : entry;
+        const targetPath = join(targetDir, targetName);
+        const stat = statSync(sourcePath);
+        if (stat.isDirectory()) {
+            copyTemplate(sourcePath, targetPath, variables);
+            continue;
+        }
+        if (isTextTemplate(sourcePath)) {
+            const content = readFileSync(sourcePath, "utf8")
+                .replaceAll("__MIKURU_APP_NAME__", variables.appName)
+                .replaceAll("__MIKURU_VERSION__", variables.packageVersion);
+            writeFileSync(targetPath, content);
+            continue;
+        }
+        copyFileSync(sourcePath, targetPath);
+    }
+}
+function isTextTemplate(path) {
+    return /\.(css|html|json|mikuru|svg|ts)$/.test(path) || path.endsWith("_gitignore");
+}
+function toPackageName(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "") || "mikuru-app";
+}
+//# sourceMappingURL=create.js.map

package/dist/cli/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"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"}

package/dist/cli/templates.d.ts

@@ -0,0 +1,7 @@
+export declare const availableTemplates: readonly ["starter", "basic"];
+export type TemplateName = (typeof availableTemplates)[number];
+export declare const templateDescriptions: Record<TemplateName, string>;
+export declare function formatTemplateList(): string;
+export declare function formatTemplatesForError(): string;
+export declare function isTemplateName(value: string): value is TemplateName;
+export declare function suggestTemplateName(value: string): TemplateName | undefined;

package/dist/cli/templates.js

@@ -0,0 +1,40 @@
+export const availableTemplates = ["starter", "basic"];
+export const templateDescriptions = {
+    starter: "minimal Vite app",
+    basic: "component composition example"
+};
+export function formatTemplateList() {
+    return availableTemplates.map((name) => `${name} - ${templateDescriptions[name]}`).join("\n");
+}
+export function formatTemplatesForError() {
+    return availableTemplates.map((name) => `  ${name} - ${templateDescriptions[name]}`).join("\n");
+}
+export function isTemplateName(value) {
+    return availableTemplates.includes(value);
+}
+export function suggestTemplateName(value) {
+    let bestName;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const templateName of availableTemplates) {
+        const distance = levenshtein(value, templateName);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            bestName = templateName;
+        }
+    }
+    return bestDistance <= 2 ? bestName : undefined;
+}
+function levenshtein(left, right) {
+    const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+    const current = Array.from({ length: right.length + 1 }, () => 0);
+    for (let leftIndex = 1; leftIndex <= left.length; leftIndex++) {
+        current[0] = leftIndex;
+        for (let rightIndex = 1; rightIndex <= right.length; rightIndex++) {
+            const cost = left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1;
+            current[rightIndex] = Math.min(current[rightIndex - 1] + 1, previous[rightIndex] + 1, previous[rightIndex - 1] + cost);
+        }
+        previous.splice(0, previous.length, ...current);
+    }
+    return previous[right.length];
+}
+//# sourceMappingURL=templates.js.map

package/dist/cli/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/cli/templates.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,OAAO,CAAU,CAAC;AAIhE,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,OAAO,EAAE,kBAAkB;IAC3B,KAAK,EAAE,+BAA+B;CACvC,CAAC;AAEF,MAAM,UAAU,kBAAkB;IAChC,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,MAAM,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,MAAM,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,QAAkC,CAAC;IACvC,IAAI,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAE5C,KAAK,MAAM,YAAY,IAAI,kBAAkB,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAClD,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;YAC5B,YAAY,GAAG,QAAQ,CAAC;YACxB,QAAQ,GAAG,YAAY,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAElE,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;QAC9D,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QACvB,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;YAClE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,CAC5B,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,EAC3B,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EACxB,QAAQ,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAChC,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/cli.js

@@ -1,151 +1,46 @@
 #!/usr/bin/env node
-import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import { basename, dirname, join, resolve } from "node:path";
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-const availableTemplates = ["starter", "basic"];
-const args = process.argv.slice(2);
-const command = args[0];
-if (command === "--help" || command === "-h" || !command) {
-    printHelp();
-    process.exit(0);
-}
-if (command === "--version" || command === "-v") {
-    console.log(readPackageVersion());
-    process.exit(0);
-}
-if (command !== "create") {
-    console.error(`Unknown command: ${command}`);
-    printHelp();
-    process.exit(1);
-}
-const createOptions = parseCreateArgs(args.slice(1));
-if (!createOptions) {
-    process.exit(1);
-}
-const { force, targetArg, templateName } = createOptions;
-const targetDir = resolve(process.cwd(), targetArg ?? "mikuru-app");
-const appName = toPackageName(basename(targetDir));
-if (!force && existsSync(targetDir) && readdirSync(targetDir).length > 0) {
-    console.error(`Cannot create a Mikuru app in a non-empty directory: ${targetDir}`);
-    console.error("Choose a new directory name, empty the target directory, or pass --force to overwrite template files.");
-    process.exit(1);
+import { handleCreateCommand } from "./cli/create.js";
+import { formatTemplateList } from "./cli/templates.js";
+await main();
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (command === "--help" || command === "-h" || !command) {
+        printHelp();
+        process.exit(0);
+    }
+    if (command === "--version" || command === "-v") {
+        console.log(readPackageVersion());
+        process.exit(0);
+    }
+    if (command === "--list-templates") {
+        console.log(formatTemplateList());
+        process.exit(0);
+    }
+    if (command !== "create") {
+        console.error(`Unknown command: ${command}`);
+        printHelp();
+        process.exit(1);
+    }
+    await handleCreateCommand(args.slice(1), readPackageVersion());
 }
-const templateDir = resolve(dirname(fileURLToPath(import.meta.url)), `../templates/${templateName}`);
-copyTemplate(templateDir, targetDir, { appName });
-console.log(`Created ${appName}`);
-console.log(`  Template: ${templateName}`);
-console.log(`  Location: ${targetDir}`);
-console.log("");
-console.log("Next steps:");
-console.log(`  cd ${basename(targetDir)}`);
-console.log("  npm install");
-console.log("  npm run dev");
 function printHelp() {
     console.log(`Usage:
   mikuru create [project-name] [--template starter|basic]
   mikuru --version
   mikuru --help
+  mikuru --list-templates
 
 Commands:
   create    Create a new Mikuru app.
 
 Options:
-  -h, --help       Show help.
-  -v, --version    Show the installed Mikuru version.`);
-}
-function printCreateHelp() {
-    console.log(`Usage:
-  mikuru create [project-name] [--template starter|basic]
-
-Options:
-  --template <name>    Template to use. Available: ${availableTemplates.join(", ")}.
-  --force              Create into a non-empty directory and overwrite template files.
-  -y, --yes            Use default answers for prompts. Currently accepted for future compatibility.
-  -h, --help           Show create help.`);
-}
-function parseCreateArgs(createArgs) {
-    let force = false;
-    let targetArg;
-    let templateName = "starter";
-    let yes = false;
-    for (let i = 0; i < createArgs.length; i++) {
-        const arg = createArgs[i];
-        if (arg === "--help" || arg === "-h") {
-            printCreateHelp();
-            process.exit(0);
-        }
-        if (arg === "--force") {
-            force = true;
-            continue;
-        }
-        if (arg === "--yes" || arg === "-y") {
-            yes = true;
-            continue;
-        }
-        if (arg === "--template") {
-            const nextValue = createArgs[++i];
-            if (!nextValue) {
-                console.error("Missing value for --template.");
-                printCreateHelp();
-                return undefined;
-            }
-            templateName = nextValue;
-            continue;
-        }
-        if (arg.startsWith("--template=")) {
-            templateName = arg.slice("--template=".length);
-            continue;
-        }
-        if (arg.startsWith("-")) {
-            console.error(`Unknown create option: ${arg}`);
-            printCreateHelp();
-            return undefined;
-        }
-        if (targetArg) {
-            console.error(`Unexpected extra argument: ${arg}`);
-            printCreateHelp();
-            return undefined;
-        }
-        targetArg = arg;
-    }
-    if (!isTemplateName(templateName)) {
-        console.error(`Unknown template: ${templateName}`);
-        console.error(`Available templates: ${availableTemplates.join(", ")}`);
-        return undefined;
-    }
-    return { force, targetArg, templateName, yes };
-}
-function isTemplateName(value) {
-    return availableTemplates.includes(value);
-}
-function copyTemplate(sourceDir, targetDir, variables) {
-    mkdirSync(targetDir, { recursive: true });
-    for (const entry of readdirSync(sourceDir)) {
-        const sourcePath = join(sourceDir, entry);
-        const targetName = entry === "_gitignore" ? ".gitignore" : entry;
-        const targetPath = join(targetDir, targetName);
-        const stat = statSync(sourcePath);
-        if (stat.isDirectory()) {
-            copyTemplate(sourcePath, targetPath, variables);
-            continue;
-        }
-        if (isTextTemplate(sourcePath)) {
-            const content = readFileSync(sourcePath, "utf8").replaceAll("__MIKURU_APP_NAME__", variables.appName);
-            writeFileSync(targetPath, content);
-            continue;
-        }
-        copyFileSync(sourcePath, targetPath);
-    }
-}
-function isTextTemplate(path) {
-    return /\.(css|html|json|mikuru|svg|ts)$/.test(path) || path.endsWith("_gitignore");
-}
-function toPackageName(value) {
-    return value
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9._-]+/g, "-")
-        .replace(/^-+|-+$/g, "") || "mikuru-app";
+  -h, --help          Show help.
+  -v, --version       Show the installed Mikuru version.
+  --list-templates    List available create templates with descriptions.`);
 }
 function readPackageVersion() {
     const packageJsonPath = resolve(dirname(fileURLToPath(import.meta.url)), "../package.json");

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,IAAI,EAAE,CAAC;AAEb,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACzD,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,KAAK,kBAAkB,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QAC7C,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;yEAY2D,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC5F,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAyB,CAAC;IAC9F,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mikuru",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "private": false,
   "type": "module",
   "description": "A compile-first JavaScript framework with Vue-like authoring and Svelte-like generated DOM updates.",
@@ -54,7 +54,7 @@
     "build:realworld": "vite build --config examples/realworld/vite.config.ts",
     "build:mikuru-sample": "vite build --config examples/mikuru-sample/vite.config.ts",
     "build:mikuru-vue-like": "vite build --config examples/mikuru-vue-like/vite.config.ts",
-    "ci": "npm run typecheck && npm test && npm run build && npm run test:create && npm run build:basic && npm run build:realworld && npm run build:dogfood && npm run test:package && npm run test:pack && npm run test:e2e && npm run test:e2e:dogfood",
+    "ci": "npm run typecheck && npm test && npm run test:templates && npm run test:docs && npm run build && npm run test:create && npm run build:basic && npm run build:realworld && npm run build:dogfood && npm run test:package && npm run test:pack && npm run test:e2e && npm run test:e2e:dogfood",
     "dev:basic": "vite --config examples/basic/vite.config.ts",
     "dev:dogfood": "vite --config examples/dogfood/vite.config.ts",
     "dev:realworld": "vite --config examples/realworld/vite.config.ts",
@@ -64,8 +64,10 @@
     "test:e2e": "playwright test",
     "test:e2e:dogfood": "playwright test --config playwright.dogfood.config.ts",
     "test:create": "node tests/create-cli-smoke.mjs",
+    "test:docs": "node tests/docs-smoke.mjs",
     "test:pack": "node tests/npm-pack-smoke.mjs",
     "test:package": "node tests/package-usage.mjs",
+    "test:templates": "node tests/template-version-smoke.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "keywords": [

package/templates/basic/package.json

@@ -3,13 +3,14 @@
   "private": true,
   "version": "0.0.0",
   "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "preview": "vite preview"
-  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
-    "mikuru": "^1.0.6"
+    "mikuru": "^__MIKURU_VERSION__"
   },
   "devDependencies": {
     "typescript": "^6.0.3",

package/templates/basic/src/css-env.d.ts

@@ -0,0 +1 @@
+declare module "*.css";

package/templates/basic/src/mikuru-env.d.ts

@@ -1 +1 @@
-import "mikuru/env";
+import "mikuru/env";

package/templates/basic/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.d.ts"]
+}

package/templates/starter/package.json

@@ -6,10 +6,11 @@
   "scripts": {
     "dev": "vite",
     "build": "vite build",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "mikuru": "^1.0.6"
+    "mikuru": "^__MIKURU_VERSION__"
   },
   "devDependencies": {
     "typescript": "^6.0.3",

package/templates/starter/src/css-env.d.ts

@@ -0,0 +1 @@
+declare module "*.css";

package/templates/starter/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.d.ts"]
+}