create-dalila 1.2.12 → 1.2.14

package/README.md

@@ -5,7 +5,7 @@ Scaffold a new Dalila project with one command.
 ## Usage
 
 ```bash
-npm create dalila my-app
+npm create dalila@latest my-app
 cd my-app
 npm install
 npm run dev
@@ -13,10 +13,14 @@ npm run dev
 
 Open http://localhost:4242 to see your app.
 
+## Requirements
+
+- Node.js `>=22.6.0`
+
 ## What's Included
 
-- Counter example with signals and computed values
-- Hot reload development server + route generation watcher
+- File-based router starter (`src/app`)
+- Dev server + route generation watcher
 - TypeScript support out of the box
 - Minimal CSS styling
 
@@ -24,9 +28,14 @@ Open http://localhost:4242 to see your app.
 
 ```
 my-app/
-├── index.html      # Main HTML file
+├── dev.mjs         # Runs route watcher + dev server
+├── index.html      # App shell
 ├── src/
-│   ├── main.ts     # Application entry point
+│   ├── app/
+│   │   ├── layout.html
+│   │   ├── page.html
+│   │   └── page.ts
+│   ├── main.ts     # Router bootstrap
 │   └── style.css   # Styles
 ├── package.json
 └── tsconfig.json
@@ -35,8 +44,10 @@ my-app/
 ## Scripts
 
 - `npm run dev` - Start dev server and route watcher
+- `npm run routes` - Generate route files once
+- `npm run routes:watch` - Watch route files and regenerate outputs
 - `npm run build` - Compile TypeScript
 
 ## Learn More
 
-- [Dalila Documentation](https://github.com/evertonccarvalho/dalila)
+- [Dalila Documentation](https://github.com/evertondsvieira/dalila)

package/index.js

@@ -15,6 +15,7 @@ const green = (text) => `\x1b[32m${text}\x1b[0m`;
 const cyan = (text) => `\x1b[36m${text}\x1b[0m`;
 const yellow = (text) => `\x1b[33m${text}\x1b[0m`;
 const bold = (text) => `\x1b[1m${text}\x1b[0m`;
+const MIN_NODE = { major: 22, minor: 6, patch: 0 };
 
 function printHelp() {
   console.log(`
@@ -34,6 +35,80 @@ ${bold('Options:')}
 `);
 }
 
+function compareVersions(a, b) {
+  if (a.major !== b.major) return a.major - b.major;
+  if (a.minor !== b.minor) return a.minor - b.minor;
+  return a.patch - b.patch;
+}
+
+function parseNodeVersion(version) {
+  const [major = '0', minor = '0', patch = '0'] = version.split('.');
+  return {
+    major: Number.parseInt(major, 10) || 0,
+    minor: Number.parseInt(minor, 10) || 0,
+    patch: Number.parseInt(patch, 10) || 0,
+  };
+}
+
+function ensureSupportedNode() {
+  const current = parseNodeVersion(process.versions.node);
+  if (compareVersions(current, MIN_NODE) >= 0) return;
+
+  console.error(
+    `${yellow('Error:')} Node.js ${MIN_NODE.major}.${MIN_NODE.minor}.${MIN_NODE.patch}+ is required to create and run Dalila apps.\n`
+  );
+  console.error(`Current version: ${process.versions.node}`);
+  console.error('Please upgrade Node.js and try again.\n');
+  process.exit(1);
+}
+
+function suggestPackageName(input) {
+  return (input || 'my-app')
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, '-')
+    .replace(/[^a-z0-9._~-]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^[._-]+/, '')
+    .replace(/[._-]+$/, '') || 'my-app';
+}
+
+function validateProjectName(name) {
+  const trimmed = name.trim();
+  const errors = [];
+
+  if (trimmed.length === 0) {
+    errors.push('Project name cannot be empty.');
+  }
+  if (trimmed !== name) {
+    errors.push('Project name cannot start or end with spaces.');
+  }
+  if (trimmed.length > 214) {
+    errors.push('Project name must be 214 characters or fewer.');
+  }
+  if (trimmed.includes('/')) {
+    errors.push('Use an unscoped package name (e.g. "my-app").');
+  }
+  if (/[A-Z]/.test(trimmed)) {
+    errors.push('Project name must be lowercase.');
+  }
+  if (trimmed.startsWith('.') || trimmed.startsWith('_')) {
+    errors.push('Project name cannot start with "." or "_".');
+  }
+  if (!/^[a-z0-9][a-z0-9._~-]*$/.test(trimmed)) {
+    errors.push('Use only lowercase letters, numbers, ".", "_", "~", and "-".');
+  }
+  if (trimmed === 'node_modules' || trimmed === 'favicon.ico') {
+    errors.push(`"${trimmed}" is not a valid package name.`);
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors,
+    suggested: suggestPackageName(trimmed),
+  };
+}
+
 function copyDir(src, dest) {
   fs.mkdirSync(dest, { recursive: true });
 
@@ -57,6 +132,8 @@ function updatePackageJson(projectPath, projectName) {
 }
 
 function main() {
+  ensureSupportedNode();
+
   // Handle flags
   if (args.includes('-h') || args.includes('--help')) {
     printHelp();
@@ -78,6 +155,17 @@ function main() {
     process.exit(1);
   }
 
+  const validation = validateProjectName(projectName);
+  if (!validation.valid) {
+    console.error(`${yellow('Error:')} Invalid project name "${projectName}".\n`);
+    for (const error of validation.errors) {
+      console.error(`- ${error}`);
+    }
+    console.error('\nTry something like:');
+    console.error(`  npm create dalila ${cyan(validation.suggested)}\n`);
+    process.exit(1);
+  }
+
   // Check if directory exists
   const projectPath = path.resolve(process.cwd(), projectName);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dalila",
-  "version": "1.2.12",
+  "version": "1.2.14",
   "description": "Create Dalila apps with one command",
   "bin": {
     "create-dalila": "index.js"
@@ -23,6 +23,9 @@
   ],
   "author": "Everton Da Silva Vieira",
   "license": "MIT",
+  "engines": {
+    "node": ">=22.6.0"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/evertondsvieira/dalila.git"

package/template/.nvmrc

@@ -0,0 +1 @@
+22

package/template/package.json

@@ -11,8 +11,11 @@
     "preview": "dalila-dev --dist",
     "postinstall": "dalila routes generate"
   },
+  "engines": {
+    "node": ">=22.6.0"
+  },
   "dependencies": {
-    "dalila": "latest"
+    "dalila": "^1.9.21"
   },
   "devDependencies": {
     "typescript": "^5.7.3"