@tishlang/create-tish-app 1.13.0 → 2.0.0

package/README.md

@@ -0,0 +1,45 @@
+# @tishlang/create-tish-app
+
+The official scaffolding tool for Tish projects. It provides templates to quickly bootstrap new applications with zero configuration.
+
+## Usage
+
+You can create a new project by running:
+
+```bash
+npx @tishlang/create-tish-app [template] [project-name]
+```
+
+If you run it without arguments, it will launch an interactive prompt to help you choose a template and name your project:
+
+```bash
+npx @tishlang/create-tish-app
+```
+
+### Available Templates
+
+- **`lattish`**: A client-side SPA with `@tishlang/lattish` and a Tish static file server.
+- **`http-hello`**: A simple standalone HTTP server written in Tish.
+- **`docs`**: A static site generator for Markdown documentation.
+
+## Local Development & Debugging
+
+If you are modifying the scaffolding tool or adding new templates in the `templates/` directory, you can easily test it locally.
+
+### Method 1: Direct Execution
+Run the `index.js` script directly using Node.js in a scratch directory:
+```bash
+mkdir -p /tmp/test-app && cd /tmp/test-app
+node ~/Projects/tish/tish/npm/create-tish-app/index.js
+```
+
+### Method 2: Using `npm link`
+You can link the package globally to test the CLI command exactly as an end-user would:
+```bash
+# From this directory:
+npm link
+
+# Now you can use it anywhere on your machine
+cd /tmp
+create-tish-app docs my-test-docs
+```

package/index.js

@@ -3,9 +3,9 @@
 
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 
 function prompt(question) {
-  const readline = require('readline');
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise(resolve => {
     rl.question(question, answer => {
@@ -15,14 +15,63 @@ function prompt(question) {
   });
 }
 
+function copyDirSync(src, dest, safeName) {
+  fs.mkdirSync(dest, { recursive: true });
+  let entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (let entry of entries) {
+    let srcPath = path.join(src, entry.name);
+    let destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, destPath, safeName);
+    } else {
+      let content = fs.readFileSync(srcPath, 'utf8');
+      content = content.replace(/\{\{PROJECT_NAME\}\}/g, safeName);
+      fs.writeFileSync(destPath, content, 'utf8');
+    }
+  }
+}
+
 async function main() {
-  let name = (process.argv[2] && String(process.argv[2]).trim()) || '';
+  const templatesDir = path.join(__dirname, 'templates');
+  const TEMPLATES = fs.existsSync(templatesDir) ? fs.readdirSync(templatesDir).filter(f => fs.statSync(path.join(templatesDir, f)).isDirectory()) : [];
+
+  let template = (process.argv[2] && String(process.argv[2]).trim()) || '';
+  let name = (process.argv[3] && String(process.argv[3]).trim()) || '';
+
+  // Shift arguments if the first arg is not a template (allow `create-tish-app my-app` but prompt for template)
+  if (template && !TEMPLATES.includes(template)) {
+    if (!name) {
+      name = template;
+      template = '';
+    }
+  }
+
+  if (!template) {
+    console.log('Available templates:');
+    TEMPLATES.forEach((t, i) => console.log(`  ${i + 1}) ${t}`));
+    let selection = await prompt('Select a template (1-' + TEMPLATES.length + '): ');
+    const index = parseInt(selection, 10) - 1;
+    if (index >= 0 && index < TEMPLATES.length) {
+      template = TEMPLATES[index];
+    } else if (TEMPLATES.includes(selection)) {
+      template = selection;
+    }
+    
+    if (!TEMPLATES.includes(template)) {
+      console.error('Invalid template selection.');
+      process.exit(1);
+    }
+  }
+
   if (!name) {
     name = await prompt('Project name: ');
     name = name.trim();
   }
+  
   if (!name) {
-    console.error('Please provide a project name (argument or when prompted). Example: npx @tishlang/create-tish-app my-app');
+    console.error('Please provide a project name.');
     process.exit(1);
   }
 
@@ -30,6 +79,7 @@ async function main() {
     console.error('Project name must be a single folder name, not a path.');
     process.exit(1);
   }
+  
   if (name === '.' || name === '..') {
     console.error('Invalid project name.');
     process.exit(1);
@@ -41,57 +91,28 @@ async function main() {
     process.exit(1);
   }
 
-  fs.mkdirSync(dir, { recursive: true });
-  fs.mkdirSync(path.join(dir, 'src'), { recursive: true });
-
   const safeName = name.replace(/[^a-z0-9-]/gi, '-').replace(/-+/g, '-').toLowerCase() || 'tish-app';
-  const files = {
-    'src/main.tish': `// ${name} - Tish app
-let message = "Hello, Tish!"
-console.log(message)
-`,
-    'zectre.yaml': `name: ${safeName}
-`,
-    'package.json': JSON.stringify({
-      name: safeName,
-      version: '0.1.0',
-      private: true,
-      tish: { source: './src/main.tish' },
-    }, null, 2),
-    '.gitignore': `# Build output
-/tish_out
-*.exe
-`,
-    'README.md': `# ${name}
-
-A [Tish](https://github.com/tishlang/tish) project.
-
-## Run (interpret)
-
-\`\`\`bash
-npx @tishlang/tish run src/main.tish
-# or after installing: tish run src/main.tish
-\`\`\`
-
-## Build to native
-
-\`\`\`bash
-npx @tishlang/tish build src/main.tish -o app
-./app
-\`\`\`
-`,
-  };
-
-  for (const [file, content] of Object.entries(files)) {
-    fs.writeFileSync(path.join(dir, file), content, 'utf8');
+
+  const tplDir = path.join(templatesDir, template);
+  if (!fs.existsSync(tplDir)) {
+    console.error('Template not found: ' + template);
+    process.exit(1);
   }
 
-  console.log(`Created ${name} at ${dir}`);
-  console.log('');
-  console.log('Next steps:');
-  console.log(`  cd ${name}`);
-  console.log('  npx @tishlang/tish run src/main.tish');
-  console.log('  # or: npx @tishlang/tish build src/main.tish -o app && ./app');
+  console.log(`Copying files from ${template} template...`);
+  copyDirSync(tplDir, dir, safeName);
+
+  console.log(`\nSuccess! Created ${name} at ${dir}`);
+  console.log('Inside that directory, you can run several commands:');
+  console.log('\n  npm run dev');
+  console.log('    Starts the development server.');
+  console.log('\n  npm run build');
+  console.log('    Builds the app for production.');
+  console.log('\n  npm run start');
+  console.log('    Runs the built app in production mode.\n');
+  console.log('We suggest that you begin by typing:');
+  console.log(`\n  cd ${name}`);
+  console.log('  npm run dev\n');
 }
 
 main().catch(err => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tishlang/create-tish-app",
-  "version": "1.13.0",
+  "version": "2.0.0",
   "description": "Scaffold a new Tish project",
   "license": "PIF",
   "repository": {

package/templates/docs/build.tish

@@ -0,0 +1,27 @@
+import { fileExists, readFile, writeFile, mkdir } from "fs"
+
+fn buildDocs() {
+  let content = ""
+  if (fileExists("content/index.md")) {
+    content = readFile("content/index.md")
+  }
+  
+  let html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>Docs</title>
+  <style>body { font-family: system-ui, sans-serif; max-width: 800px; margin: 0 auto; padding: 2rem; }</style>
+</head>
+<body>
+  <div class="content">${content}</div>
+  <p><em>(In a full implementation, you would convert Markdown to HTML here)</em></p>
+</body>
+</html>`
+
+  mkdir("public")
+  writeFile("public/index.html", html)
+  console.log("Built docs to public/index.html")
+}
+
+buildDocs()

package/templates/docs/content/index.md

@@ -0,0 +1,3 @@
+# Welcome to {{PROJECT_NAME}}
+
+This is a fully prerendered static site using Tish.

package/templates/docs/dev-server.tish

@@ -0,0 +1,42 @@
+import { fileExists, isDir } from "fs"
+import { serve } from "http"
+import { process } from "process"
+
+fn contentType(path) {
+  if (path.endsWith(".html")) { return "text/html; charset=utf-8" }
+  if (path.endsWith(".css")) { return "text/css; charset=utf-8" }
+  if (path.endsWith(".js") || path.endsWith(".mjs")) { return "application/javascript; charset=utf-8" }
+  return "application/octet-stream"
+}
+
+fn serveFile(path) {
+  let ct = contentType(path)
+  return { status: 200, headers: { "Content-Type": ct, "Cache-Control": "no-store" }, file: path }
+}
+
+fn handleRequest(req) {
+  let p = req.path
+  if (p === "/" || p === "") { p = "/index.html" }
+  if (p.charAt(0) === "/") { p = p.substring(1) }
+
+  let candidates = ["public/" + p, p]
+  let i = 0
+  while (i < candidates.length) {
+    let path = candidates[i]
+    if (fileExists(path) && !isDir(path)) { return serveFile(path) }
+    i = i + 1
+  }
+  
+  if (fileExists("public/index.html") && req.path.indexOf(".") < 0) {
+    return serveFile("public/index.html")
+  }
+  
+  return { status: 404, body: "Not found: " + req.path }
+}
+
+let port = 8080
+if (process !== null && "env" in process && process.env !== null && "PORT" in process.env) {
+  port = parseInt(process.env["PORT"])
+}
+console.log("Dev server running at http://127.0.0.1:" + port)
+serve(port, handleRequest)

package/templates/docs/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "tish run --feature fs build.tish && tish run --feature http,fs,process dev-server.tish",
+    "build": "tish run --feature fs build.tish",
+    "start": "tish run --feature http,fs,process dev-server.tish"
+  }
+}

package/templates/http-hello/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "tish run --feature http src/main.tish",
+    "build": "tish build src/main.tish -o app",
+    "start": "./app"
+  }
+}

package/templates/http-hello/src/main.tish

@@ -0,0 +1,14 @@
+fn handleRequest(req) {
+    console.log("Request:", req.method, req.path)
+    if (req.path === "/health") { return { status: 200, body: "OK" } }
+    
+    return {
+        status: 200,
+        headers: { contentType: "application/json" },
+        body: JSON.stringify({ message: "Hello from Tish HTTP Server!" })
+    }
+}
+
+let port = 8080
+console.log(`Starting server on port ${port}...`)
+serve(port, handleRequest)

package/templates/lattish/dev-server.tish

@@ -0,0 +1,42 @@
+import { fileExists, isDir } from "fs"
+import { serve } from "http"
+import { process } from "process"
+
+fn contentType(path) {
+  if (path.endsWith(".html")) { return "text/html; charset=utf-8" }
+  if (path.endsWith(".css")) { return "text/css; charset=utf-8" }
+  if (path.endsWith(".js") || path.endsWith(".mjs")) { return "application/javascript; charset=utf-8" }
+  return "application/octet-stream"
+}
+
+fn serveFile(path) {
+  let ct = contentType(path)
+  return { status: 200, headers: { "Content-Type": ct, "Cache-Control": "no-store" }, file: path }
+}
+
+fn handleRequest(req) {
+  let p = req.path
+  if (p === "/" || p === "") { p = "/index.html" }
+  if (p.charAt(0) === "/") { p = p.substring(1) }
+
+  let candidates = ["public/" + p, p]
+  let i = 0
+  while (i < candidates.length) {
+    let path = candidates[i]
+    if (fileExists(path) && !isDir(path)) { return serveFile(path) }
+    i = i + 1
+  }
+  
+  if (fileExists("public/index.html") && req.path.indexOf(".") < 0) {
+    return serveFile("public/index.html")
+  }
+  
+  return { status: 404, body: "Not found: " + req.path }
+}
+
+let port = 8080
+if (process !== null && "env" in process && process.env !== null && "PORT" in process.env) {
+  port = parseInt(process.env["PORT"])
+}
+console.log("Dev server running at http://127.0.0.1:" + port)
+serve(port, handleRequest)

package/templates/lattish/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "tish run --feature http,fs,process dev-server.tish",
+    "build": "tish build --target js src/App.tish -o public/dist/App",
+    "start": "tish run --feature http,fs,process dev-server.tish"
+  },
+  "dependencies": {
+    "@tishlang/lattish": "latest"
+  }
+}

package/templates/lattish/public/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{PROJECT_NAME}}</title>
+  <style>body { font-family: system-ui, sans-serif; padding: 2rem; }</style>
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="/dist/App.js"></script>
+</body>
+</html>

package/templates/lattish/src/App.tish

@@ -0,0 +1,12 @@
+import { useState, createRoot } from 'lattish'
+
+fn App() {
+  let [count, setCount] = useState(0)
+  return <div class="container">
+    <h1>Hello, Tish + Lattish!</h1>
+    <p>Count: {count}</p>
+    <button onclick={() => setCount(count + 1)}>Increment</button>
+  </div>
+}
+
+createRoot(document.getElementById("root")).render(App)