create-caspian-app 0.1.0 → 0.1.1

package/dist/index.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import{execSync,spawnSync}from"child_process";import fs from"fs";import{fileURLToPath}from"url";import path from"path";import chalk from"chalk";import prompts from"prompts";import https from"https";import{randomBytes}from"crypto";const __filename=fileURLToPath(import.meta.url),__dirname=path.dirname(__filename);let updateAnswer=null;const nonBackendFiles=["favicon.ico","\\src\\app\\index.html","not-found.html","error.html"],STARTER_KITS={basic:{id:"basic",name:"Basic PHP Application",description:"Simple PHP backend with minimal dependencies",features:{backendOnly:!0,tailwindcss:!1,prisma:!1,mcp:!1},requiredFiles:["main.py",".prettierrc","pyproject.toml","src/app/layout.html","src/app/index.html"]},fullstack:{id:"fullstack",name:"Full-Stack Application",description:"Complete web application with frontend and backend",features:{backendOnly:!1,tailwindcss:!0,prisma:!0,mcp:!1},requiredFiles:["main.py",".prettierrc","pyproject.toml","postcss.config.js","src/app/layout.html","src/app/index.html","public/js/main.js","src/app/globals.css"]},api:{id:"api",name:"REST API",description:"Backend API with database and documentation",features:{backendOnly:!0,tailwindcss:!1,prisma:!0,mcp:!1},requiredFiles:["main.py","pyproject.toml"]},realtime:{id:"realtime",name:"Real-time Application",description:"Application with WebSocket support and MCP",features:{backendOnly:!1,tailwindcss:!0,prisma:!0,mcp:!0},requiredFiles:["main.py",".prettierrc","pyproject.toml","postcss.config.js","src/lib/mcp"]}};function bsConfigUrls(e){const s=e.indexOf("\\htdocs\\");if(-1===s)return console.error("Invalid PROJECT_ROOT_PATH. The path does not contain \\htdocs\\"),{bsTarget:"",bsPathRewrite:{}};const t=e.substring(0,s+8).replace(/\\/g,"\\\\"),n=e.replace(new RegExp(`^${t}`),"").replace(/\\/g,"/");let i=`http://localhost/${n}`;i=i.endsWith("/")?i.slice(0,-1):i;const c=i.replace(/(?<!:)(\/\/+)/g,"/"),a=n.replace(/\/\/+/g,"/");return{bsTarget:`${c}/`,bsPathRewrite:{"^/":`/${a.startsWith("/")?a.substring(1):a}/`}}}async function updatePackageJson(e,s){const t=path.join(e,"package.json");if(checkExcludeFiles(t))return;const n=JSON.parse(fs.readFileSync(t,"utf8"));n.scripts={...n.scripts,projectName:"tsx settings/project-name.ts"};let i=[];s.tailwindcss&&(n.scripts={...n.scripts,tailwind:"postcss src/app/globals.css -o public/css/styles.css --watch","tailwind:build":"postcss src/app/globals.css -o public/css/styles.css"},i.push("tailwind")),s.typescript&&!s.backendOnly&&(n.scripts={...n.scripts,"ts:watch":"vite build --watch","ts:build":"vite build"},i.push("ts:watch")),s.mcp&&(n.scripts={...n.scripts,mcp:"tsx settings/restart-mcp.ts"},i.push("mcp"));let c={...n.scripts};c.browserSync="tsx settings/bs-config.ts",c["browserSync:build"]="tsx settings/build.ts",c.dev=`npm-run-all projectName -p browserSync ${i.join(" ")}`;let a=["browserSync:build"];s.tailwindcss&&a.unshift("tailwind:build"),s.typescript&&!s.backendOnly&&a.unshift("ts:build"),c.build=`npm-run-all ${a.join(" ")}`,n.scripts=c,n.type="module",fs.writeFileSync(t,JSON.stringify(n,null,2))}function generateAuthSecret(){return randomBytes(33).toString("base64")}function generateHexEncodedKey(e=16){return randomBytes(e).toString("hex")}function copyRecursiveSync(e,s,t){const n=fs.existsSync(e),i=n&&fs.statSync(e);if(n&&i&&i.isDirectory()){const n=s.toLowerCase();if(!t.mcp&&n.includes("src\\lib\\mcp"))return;if((!t.typescript||t.backendOnly)&&(n.endsWith("\\ts")||n.includes("\\ts\\")))return;if((!t.typescript||t.backendOnly)&&(n.endsWith("\\vite-plugins")||n.includes("\\vite-plugins\\")||n.includes("\\vite-plugins")))return;if(t.backendOnly&&n.includes("public\\js")||t.backendOnly&&n.includes("public\\css")||t.backendOnly&&n.includes("public\\assets"))return;const i=s.replace(/\\/g,"/");if(updateAnswer?.excludeFilePath?.includes(i))return;fs.existsSync(s)||fs.mkdirSync(s,{recursive:!0}),fs.readdirSync(e).forEach(n=>{copyRecursiveSync(path.join(e,n),path.join(s,n),t)})}else{if(checkExcludeFiles(s))return;if(!t.tailwindcss&&(s.includes("globals.css")||s.includes("styles.css")))return;if(!t.mcp&&s.includes("restart-mcp.ts"))return;if(t.backendOnly&&nonBackendFiles.some(e=>s.includes(e)))return;if(t.backendOnly&&s.includes("layout.html"))return;if(t.tailwindcss&&s.includes("index.css"))return;if(!t.prisma&&s.includes("prisma-schema-config.json"))return;fs.copyFileSync(e,s,0)}}async function executeCopy(e,s,t){s.forEach(({src:s,dest:n})=>{copyRecursiveSync(path.join(__dirname,s),path.join(e,n),t)})}function modifyPostcssConfig(e){const s=path.join(e,"postcss.config.js");if(checkExcludeFiles(s))return;fs.writeFileSync(s,'export default {\n  plugins: {\n    "@tailwindcss/postcss": {},\n    cssnano: {},\n  },\n};',{flag:"w"})}function modifyLayoutPHP(e,s){const t=path.join(e,"src","app","layout.html");if(!checkExcludeFiles(t))try{let e=fs.readFileSync(t,"utf8"),n="";s.backendOnly||(s.tailwindcss||(n='\n    <link href="/css/index.css" rel="stylesheet" />'),n+='\n    <script type="module" src="/js/main.js"><\/script>');let i="";s.backendOnly||(i=s.tailwindcss?`  <link href="/css/styles.css" rel="stylesheet" />${n}`:n),e=e.replace("</head>",`${i}\n</head>`),fs.writeFileSync(t,e,{flag:"w"})}catch(e){console.error(chalk.red("Error modifying layout.html:"),e)}}async function createOrUpdateEnvFile(e,s){const t=path.join(e,".env");checkExcludeFiles(t)||fs.writeFileSync(t,s,{flag:"w"})}function checkExcludeFiles(e){if(!updateAnswer?.isUpdate)return!1;const s=e.replace(/\\/g,"/");return!!updateAnswer?.excludeFilePath?.includes(s)||!!updateAnswer?.excludeFiles&&updateAnswer.excludeFiles.some(e=>{const t=e.replace(/\\/g,"/");return s.endsWith("/"+t)||s===t})}async function createDirectoryStructure(e,s){const t=[{src:"/main.py",dest:"/main.py"},{src:"/.prettierrc",dest:"/.prettierrc"},{src:"/pyproject.toml",dest:"/pyproject.toml"},{src:"/tsconfig.json",dest:"/tsconfig.json"},{src:"/app-gitignore",dest:"/.gitignore"}];s.tailwindcss&&t.push({src:"/postcss.config.js",dest:"/postcss.config.js"}),s.typescript&&!s.backendOnly&&t.push({src:"/vite.config.ts",dest:"/vite.config.ts"});const n=[{src:"/settings",dest:"/settings"},{src:"/src",dest:"/src"},{src:"/public",dest:"/public"}];s.typescript&&!s.backendOnly&&n.push({src:"/ts",dest:"/ts"}),t.forEach(({src:s,dest:t})=>{const n=path.join(__dirname,s),i=path.join(e,t);if(checkExcludeFiles(i))return;const c=fs.readFileSync(n,"utf8");fs.writeFileSync(i,c,{flag:"w"})}),await executeCopy(e,n,s),await updatePackageJson(e,s),s.tailwindcss&&modifyPostcssConfig(e),!s.tailwindcss&&s.backendOnly||modifyLayoutPHP(e,s);const i=`# Authentication secret key for JWT or session encryption.\nAUTH_SECRET="${generateAuthSecret()}"\n# Name of the authentication cookie.\nAUTH_COOKIE_NAME="${generateHexEncodedKey(8)}"\nAUTH_TOKEN_VALIDITY="1h"\nAUTH_TOKEN_AUTO_REFRESH="true"\n\nAUTH_ALL_ROUTES_PRIVATE="true"\nAUTH_PUBLIC_ROUTES="/"\nAUTH_ROUTES="/signin,/signup"\nAUTH_PRIVATE_ROUTES=""\n\nAUTH_ROLE_BASED="false"\nAUTH_ROLE_IDENTIFIER="role"\n# Role-based route allowlist (JSON)\n# Format: {"roleName": ["/route1", "/route2"]}\n# Example:\n# AUTH_ROLE_BASED_ROUTES_JSON="{"admin": ["/admin", "/reports"], "user": ["/dashboard"]}"\nAUTH_ROLE_BASED_ROUTES_JSON="{}"\n\nAUTH_DEFAULT_SIGNIN_REDIRECT="/dashboard"\nAUTH_DEFAULT_SIGNOUT_REDIRECT="/signin"\nAUTH_API_PREFIX="/api/auth"\n\n# Show errors in the browser (development only). Set to false in production.\nSHOW_ERRORS="true"\n\n# Application timezone (default: UTC)\nAPP_TIMEZONE="UTC"\n\n# Application environment (development or production)\nAPP_ENV="development"\n\n# Enable or disable application cache (default: false)\nCACHE_ENABLED="false"\n# Cache time-to-live in seconds (default: 600)\nCACHE_TTL="600"\n\n# Secret key for encrypting function calls.\nFUNCTION_CALL_SECRET="${generateHexEncodedKey(32)}"\n\n# Single or multiple origins allowed for CORS (comma-separated)\nCORS_ALLOWED_ORIGINS=""\n\n# If you need cookies/Authorization across origins, keep this true\nCORS_ALLOW_CREDENTIALS="true"\n\n# Optional tuning\nCORS_ALLOWED_METHODS="GET,POST,PUT,PATCH,DELETE,OPTIONS"\nCORS_ALLOWED_HEADERS="Content-Type,Authorization,X-Requested-With"\nCORS_EXPOSE_HEADERS=""\nCORS_MAX_AGE="86400"\n\n# Session & Security\nSESSION_LIFETIME_HOURS="7"\nMAX_CONTENT_LENGTH_MB="16"\n\n# Rate Limiting\nRATE_LIMIT_DEFAULT="200 per minute"\nRATE_LIMIT_RPC="60 per minute"\nRATE_LIMIT_AUTH="60 per minute"`;if(s.prisma){const s=`${'# Environment variables declared in this file are automatically made available to Prisma.\n# See the documentation for more detail: https://pris.ly/d/prisma-schema#accessing-environment-variables-from-the-schema\n\n# Prisma supports the native connection string format for PostgreSQL, MySQL, SQLite, SQL Server, MongoDB and CockroachDB.\n# See the documentation for all the connection string options: https://pris.ly/d/connection-strings\n\nDATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public"'}\n\n${i}`;await createOrUpdateEnvFile(e,s)}else await createOrUpdateEnvFile(e,i)}async function getAnswer(e={},s=!1){if(s)return{projectName:e.projectName??"my-app",backendOnly:e.backendOnly??!1,tailwindcss:e.tailwindcss??!1,typescript:e.typescript??!1,mcp:e.mcp??!1,prisma:e.prisma??!1};if(e.starterKit){const s=e.starterKit;let t=null;if(STARTER_KITS[s]&&(t=STARTER_KITS[s]),t){const n={projectName:e.projectName??"my-app",starterKit:s,starterKitSource:e.starterKitSource,backendOnly:t.features.backendOnly??!1,tailwindcss:t.features.tailwindcss??!1,prisma:t.features.prisma??!1,mcp:t.features.mcp??!1,typescript:t.features.typescript??!1},i=process.argv.slice(2);return i.includes("--backend-only")&&(n.backendOnly=!0),i.includes("--tailwindcss")&&(n.tailwindcss=!0),i.includes("--mcp")&&(n.mcp=!0),i.includes("--prisma")&&(n.prisma=!0),i.includes("--typescript")&&(n.typescript=!0),n}if(e.starterKitSource){const t={projectName:e.projectName??"my-app",starterKit:s,starterKitSource:e.starterKitSource,backendOnly:!1,tailwindcss:!0,prisma:!0,mcp:!1,typescript:!1},n=process.argv.slice(2);return n.includes("--backend-only")&&(t.backendOnly=!0),n.includes("--tailwindcss")&&(t.tailwindcss=!0),n.includes("--mcp")&&(t.mcp=!0),n.includes("--prisma")&&(t.prisma=!0),n.includes("--typescript")&&(t.typescript=!0),t}}const t=[];e.projectName||t.push({type:"text",name:"projectName",message:"What is your project named?",initial:"my-app"}),e.backendOnly||updateAnswer?.isUpdate||t.push({type:"toggle",name:"backendOnly",message:`Would you like to create a ${chalk.blue("backend-only project")}?`,initial:!1,active:"Yes",inactive:"No"});const n=()=>{console.warn(chalk.red("Operation cancelled by the user.")),process.exit(0)},i=await prompts(t,{onCancel:n}),c=[];i.backendOnly??e.backendOnly??!1?(e.mcp||c.push({type:"toggle",name:"mcp",message:`Would you like to use ${chalk.blue("MCP (Model Context Protocol)")}?`,initial:!1,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma ORM")}?`,initial:!1,active:"Yes",inactive:"No"})):(e.tailwindcss||c.push({type:"toggle",name:"tailwindcss",message:`Would you like to use ${chalk.blue("Tailwind CSS")}?`,initial:!1,active:"Yes",inactive:"No"}),e.typescript||c.push({type:"toggle",name:"typescript",message:`Would you like to use ${chalk.blue("TypeScript")}?`,initial:!1,active:"Yes",inactive:"No"}),e.mcp||c.push({type:"toggle",name:"mcp",message:`Would you like to use ${chalk.blue("MCP (Model Context Protocol)")}?`,initial:!1,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma ORM")}?`,initial:!1,active:"Yes",inactive:"No"}));const a=await prompts(c,{onCancel:n});return{projectName:i.projectName?String(i.projectName).trim().replace(/ /g,"-"):e.projectName??"my-app",backendOnly:i.backendOnly??e.backendOnly??!1,tailwindcss:a.tailwindcss??e.tailwindcss??!1,typescript:a.typescript??e.typescript??!1,mcp:a.mcp??e.mcp??!1,prisma:a.prisma??e.prisma??!1}}async function uninstallNpmDependencies(e,s,t=!1){console.log("Uninstalling Node dependencies:"),s.forEach(e=>console.log(`- ${chalk.blue(e)}`));const n=`npm uninstall ${t?"--save-dev":"--save"} ${s.join(" ")}`;execSync(n,{stdio:"inherit",cwd:e})}function fetchPackageVersion(e){return new Promise((s,t)=>{https.get(`https://registry.npmjs.org/${e}`,e=>{let n="";e.on("data",e=>n+=e),e.on("end",()=>{try{const e=JSON.parse(n);s(e["dist-tags"].latest)}catch(e){t(new Error("Failed to parse JSON response"))}})}).on("error",e=>t(e))})}const readJsonFile=e=>{const s=fs.readFileSync(e,"utf8");return JSON.parse(s)};function compareVersions(e,s){const t=e.split(".").map(Number),n=s.split(".").map(Number);for(let e=0;e<t.length;e++){if(t[e]>n[e])return 1;if(t[e]<n[e])return-1}return 0}function getInstalledPackageVersion(e){try{const s=execSync(`npm list -g ${e} --depth=0`).toString().match(new RegExp(`${e}@(\\d+\\.\\d+\\.\\d+)`));return s?s[1]:(console.error(`Package ${e} is not installed`),null)}catch(e){return console.error(e instanceof Error?e.message:String(e)),null}}async function installNpmDependencies(e,s,t=!1){fs.existsSync(path.join(e,"package.json"))?console.log("Updating existing Node.js project..."):console.log("Initializing new Node.js project..."),fs.existsSync(path.join(e,"package.json"))||execSync("npm init -y",{stdio:"inherit",cwd:e}),console.log((t?"Installing development dependencies":"Installing dependencies")+":"),s.forEach(e=>console.log(`- ${chalk.blue(e)}`));const n=`npm install ${t?"--save-dev":""} ${s.join(" ")}`;execSync(n,{stdio:"inherit",cwd:e})}const npmPinnedVersions={"@tailwindcss/postcss":"4.1.18","@types/browser-sync":"2.29.1","@types/node":"25.0.3","@types/prompts":"2.4.9","browser-sync":"3.0.4",chalk:"5.6.2","chokidar-cli":"3.0.0",cssnano:"7.1.2","http-proxy-middleware":"3.0.5","npm-run-all":"4.1.5",postcss:"8.5.6","postcss-cli":"11.0.1",prompts:"2.4.2",tailwindcss:"4.1.18",tsx:"4.21.0",typescript:"5.9.3",vite:"7.3.0","fast-glob":"3.3.3","tree-sitter":"^0.25.0","tree-sitter-python":"^0.25.0"};function npmPkg(e){return npmPinnedVersions[e]?`${e}@${npmPinnedVersions[e]}`:e}async function setupStarterKit(e,s){if(!s.starterKit)return;let t=null;if(STARTER_KITS[s.starterKit]?t=STARTER_KITS[s.starterKit]:s.starterKitSource&&(t={id:s.starterKit,name:`Custom Starter Kit (${s.starterKit})`,description:"Custom starter kit from external source",features:{},requiredFiles:[],source:{type:"git",url:s.starterKitSource}}),t){if(console.log(chalk.green(`Setting up ${t.name}...`)),t.source)try{const n=t.source.branch?`git clone -b ${t.source.branch} --depth 1 ${t.source.url} ${e}`:`git clone --depth 1 ${t.source.url} ${e}`;execSync(n,{stdio:"inherit"});const i=path.join(e,".git");fs.existsSync(i)&&fs.rmSync(i,{recursive:!0,force:!0}),console.log(chalk.blue("Starter kit cloned successfully!"));const c=path.join(e,"caspian.config.json");if(fs.existsSync(c))try{const t=JSON.parse(fs.readFileSync(c,"utf8")),n=e.replace(/\\/g,"\\"),i=bsConfigUrls(n);t.projectName=s.projectName,t.projectRootPath=n,t.bsTarget=i.bsTarget,t.bsPathRewrite=i.bsPathRewrite;const a=await fetchPackageVersion("create-caspian-app");t.version=t.version||a,fs.writeFileSync(c,JSON.stringify(t,null,2)),console.log(chalk.green("Updated caspian.config.json with new project details"))}catch(e){console.warn(chalk.yellow("Failed to update caspian.config.json, will create new one"))}}catch(e){throw console.error(chalk.red(`Failed to setup starter kit: ${e}`)),e}t.customSetup&&await t.customSetup(e,s),console.log(chalk.green(`✓ ${t.name} setup complete!`))}else console.warn(chalk.yellow(`Starter kit '${s.starterKit}' not found. Skipping...`))}function showStarterKits(){console.log(chalk.blue("\n🚀 Available Starter Kits:\n")),Object.values(STARTER_KITS).forEach(e=>{const s=e.source?" (Custom)":" (Built-in)";console.log(chalk.green(`  ${e.id}${chalk.gray(s)}`)),console.log(`    ${e.name}`),console.log(chalk.gray(`    ${e.description}`)),e.source&&console.log(chalk.cyan(`    Source: ${e.source.url}`));const t=Object.entries(e.features).filter(([,e])=>!0===e).map(([e])=>e).join(", ");t&&console.log(chalk.magenta(`    Features: ${t}`)),console.log()}),console.log(chalk.yellow("Usage:")),console.log("  npx create-caspian-app my-project --starter-kit=basic"),console.log("  npx create-caspian-app my-project --starter-kit=custom --starter-kit-source=https://github.com/user/repo"),console.log()}function runCmd(e,s,t){const n=spawnSync(e,s,{cwd:t,stdio:"inherit",shell:!1,encoding:"utf8"});if(n.error)throw n.error;if(0!==n.status)throw new Error(`Command failed (${e} ${s.join(" ")}), exit=${n.status}`)}function tryRunCmd(e,s,t){const n=spawnSync(e,s,{cwd:t,stdio:"ignore",shell:!1,encoding:"utf8"});return!n.error&&0===n.status}function getVenvPythonPath(e){const s=path.join(e,".venv","Scripts","python.exe");if(fs.existsSync(s))return s;return path.join(e,".venv","bin","python")}async function uninstallPythonDependencies(e,s){const t=getVenvPythonPath(e);fs.existsSync(t)?(console.log("Uninstalling Python dependencies:"),s.forEach(e=>console.log(`- ${chalk.blue(e)}`)),runCmd(t,["-m","pip","uninstall","-y",...s],e)):console.warn(chalk.yellow("Virtual environment not found. Skipping Python dependency uninstallation."))}function fetchPyPiPackageVersion(e){return new Promise((s,t)=>{https.get(`https://pypi.org/pypi/${e}/json`,e=>{let n="";e.on("data",e=>n+=e),e.on("end",()=>{if(200===e.statusCode)try{const e=JSON.parse(n);s(e.info.version)}catch(e){t(new Error("Failed to parse PyPI JSON response"))}else t(new Error(`Request failed with status code ${e.statusCode}`))})}).on("error",e=>t(e))})}async function ensurePythonVenvAndDeps(e,s){console.log(chalk.green("\n=========================")),console.log(chalk.green("Python setup: creating venv + installing dependencies")),console.log(chalk.green("=========================\n"));const t=path.join(e,".venv");if(fs.existsSync(t)&&(fs.existsSync(path.join(e,".venv","Scripts","python.exe"))||fs.existsSync(path.join(e,".venv","bin","python"))))console.log(chalk.gray("Venv already exists: .venv"));else if(console.log(chalk.blue("Creating virtual environment: .venv")),tryRunCmd("py",["-m","venv",".venv"],e));else if(tryRunCmd("python",["-m","venv",".venv"],e));else if(!tryRunCmd("python3",["-m","venv",".venv"],e))throw new Error("Could not create venv. Install Python and ensure `py` or `python` is in PATH.");const n=getVenvPythonPath(e);if(!fs.existsSync(n))throw new Error(`Venv python not found at: ${n}`);console.log(chalk.blue("Upgrading pip...")),runCmd(n,["-m","pip","install","--upgrade","pip"],e);let i="caspian-utils";try{const e=await fetchPyPiPackageVersion("caspian-utils");i=`caspian-utils==${e}`,console.log(chalk.blue(`Pinned caspian-utils to version ${e}`))}catch(e){console.warn(chalk.yellow("Could not fetch latest caspian-utils version. Using unpinned dependency."))}const c=["fastapi>=0.110,<0.128","uvicorn>=0.27,<0.40","python-dotenv>=1.0,<2.0","jinja2>=3.1,<4.0","beautifulsoup4>=4.12,<5.0","slowapi>=0.1,<0.2","python-multipart>=0.0.9,<0.1","starsessions>=1.3,<2.2","httpx>=0.27,<0.29","werkzeug>=3.0,<4.0","cuid2>=2.0,<3.0","nanoid>=2.0,<3.0","python-ulid>=2.7,<3.1","cuid>=0.4.0,<0.5.0",i];s.tailwindcss&&c.push("tailwind-merge>=0.3.3,<0.4.0"),s.mcp&&c.push("fastmcp<3"),s.prisma&&(c.push("psycopg2-binary>=2.9,<3.0"),c.push("asyncpg>=0.31.0,<1.0"),c.push("aiosqlite>=0.22.1,<1.0"),c.push("aiomysql>=0.3.2,<1.0")),console.log(chalk.blue("Generating requirements.txt..."));const a=path.join(e,"requirements.txt"),r=c.join("\n")+"\n";fs.writeFileSync(a,r,"utf8"),console.log(chalk.gray(`Created requirements.txt with ${c.length} packages.`)),console.log(chalk.blue("Installing dependencies from requirements.txt...")),c.forEach(e=>console.log(`- ${chalk.gray(e)}`));runCmd(n,["-m","pip","install",...updateAnswer?.isUpdate?["--upgrade","--upgrade-strategy","only-if-needed"]:[],...updateAnswer?.isUpdate?["--no-cache-dir"]:[],"-r","requirements.txt"],e),console.log(chalk.green("\n✓ Python venv ready and FastAPI dependencies installed.\n"))}function setupVsCodeSettings(e){const s=path.join(e,".vscode");fs.existsSync(s)||fs.mkdirSync(s);const t={"python.defaultInterpreterPath":"win32"===process.platform?"${workspaceFolder}/.venv/Scripts/python.exe":"${workspaceFolder}/.venv/bin/python","python.terminal.activateEnvironment":!0,"python.analysis.typeCheckingMode":"basic","python.analysis.autoImportCompletions":!0};fs.writeFileSync(path.join(s,"settings.json"),JSON.stringify(t,null,2)),console.log(chalk.gray("Created .vscode/settings.json for auto-activation."))}async function main(){try{const e=process.argv.slice(2),s=e.includes("-y");let t=e[0];const n=e.find(e=>e.startsWith("--starter-kit=")),i=n?.split("=")[1],c=e.find(e=>e.startsWith("--starter-kit-source=")),a=c?.split("=")[1];if(e.includes("--list-starter-kits"))return void showStarterKits();let r=null,o=!1;if(t){const n=process.cwd(),c=path.join(n,"caspian.config.json");if(i&&a){o=!0;const n={projectName:t,starterKit:i,starterKitSource:a,backendOnly:e.includes("--backend-only"),tailwindcss:e.includes("--tailwindcss"),typescript:e.includes("--typescript"),mcp:e.includes("--mcp"),prisma:e.includes("--prisma")};r=await getAnswer(n,s)}else if(fs.existsSync(c)){const i=readJsonFile(c);let a=[];i.excludeFiles?.map(e=>{const s=path.join(n,e);fs.existsSync(s)&&a.push(s.replace(/\\/g,"/"))}),updateAnswer={projectName:t,backendOnly:i.backendOnly,tailwindcss:i.tailwindcss,mcp:i.mcp,prisma:i.prisma,typescript:i.typescript,isUpdate:!0,componentScanDirs:i.componentScanDirs??[],excludeFiles:i.excludeFiles??[],excludeFilePath:a??[],filePath:n};const o={projectName:t,backendOnly:e.includes("--backend-only")||i.backendOnly,tailwindcss:e.includes("--tailwindcss")||i.tailwindcss,typescript:e.includes("--typescript")||i.typescript,prisma:e.includes("--prisma")||i.prisma,mcp:e.includes("--mcp")||i.mcp};r=await getAnswer(o,s),null!==r&&(updateAnswer={projectName:t,backendOnly:r.backendOnly,tailwindcss:r.tailwindcss,mcp:r.mcp,prisma:r.prisma,typescript:r.typescript,isUpdate:!0,componentScanDirs:i.componentScanDirs??[],excludeFiles:i.excludeFiles??[],excludeFilePath:a??[],filePath:n})}else{const n={projectName:t,starterKit:i,starterKitSource:a,backendOnly:e.includes("--backend-only"),tailwindcss:e.includes("--tailwindcss"),typescript:e.includes("--typescript"),mcp:e.includes("--mcp"),prisma:e.includes("--prisma")};r=await getAnswer(n,s)}if(null===r)return void console.log(chalk.red("Installation cancelled."))}else r=await getAnswer({},s);if(null===r)return void console.warn(chalk.red("Installation cancelled."));const l=await fetchPackageVersion("create-caspian-app"),p=getInstalledPackageVersion("create-caspian-app");p?-1===compareVersions(p,l)&&(execSync("npm uninstall -g create-caspian-app",{stdio:"inherit"}),execSync("npm install -g create-caspian-app",{stdio:"inherit"})):execSync("npm install -g create-caspian-app",{stdio:"inherit"});const d=process.cwd();let u;if(t)if(o){const s=path.join(d,t);fs.existsSync(s)||fs.mkdirSync(s,{recursive:!0}),u=s,await setupStarterKit(u,r),process.chdir(u);const n=path.join(u,"caspian.config.json");if(fs.existsSync(n)){const s=JSON.parse(fs.readFileSync(n,"utf8"));e.includes("--backend-only")&&(s.backendOnly=!0),e.includes("--tailwindcss")&&(s.tailwindcss=!0),e.includes("--typescript")&&(s.typescript=!0),e.includes("--mcp")&&(s.mcp=!0),e.includes("--prisma")&&(s.prisma=!0),r={...r,backendOnly:s.backendOnly,tailwindcss:s.tailwindcss,typescript:s.typescript,mcp:s.mcp,prisma:s.prisma};let t=[];s.excludeFiles?.map(e=>{const s=path.join(u,e);fs.existsSync(s)&&t.push(s.replace(/\\/g,"/"))}),updateAnswer={...r,isUpdate:!0,componentScanDirs:s.componentScanDirs??[],excludeFiles:s.excludeFiles??[],excludeFilePath:t??[],filePath:u}}}else{const e=path.join(d,"caspian.config.json"),s=path.join(d,t),n=path.join(s,"caspian.config.json");fs.existsSync(e)?u=d:fs.existsSync(s)&&fs.existsSync(n)?(u=s,process.chdir(s)):(fs.existsSync(s)||fs.mkdirSync(s,{recursive:!0}),u=s,process.chdir(s))}else fs.mkdirSync(r.projectName,{recursive:!0}),u=path.join(d,r.projectName),process.chdir(r.projectName);let m=[npmPkg("typescript"),npmPkg("@types/node"),npmPkg("tsx"),npmPkg("http-proxy-middleware"),npmPkg("chalk"),npmPkg("npm-run-all"),npmPkg("browser-sync"),npmPkg("@types/browser-sync"),npmPkg("tree-sitter"),npmPkg("tree-sitter-python")];if(r.prisma&&m.push(npmPkg("prompts"),npmPkg("@types/prompts")),r.tailwindcss&&m.push(npmPkg("tailwindcss"),npmPkg("postcss"),npmPkg("postcss-cli"),npmPkg("@tailwindcss/postcss"),npmPkg("cssnano")),r.prisma&&execSync("npm install -g prisma-client-python@latest",{stdio:"inherit"}),r.typescript&&!r.backendOnly&&m.push(npmPkg("vite"),npmPkg("fast-glob")),r.starterKit&&!o&&await setupStarterKit(u,r),await installNpmDependencies(u,m,!0),t||execSync("npx tsc --init",{stdio:"inherit"}),await createDirectoryStructure(u,r),r.prisma&&execSync("npx ppy init --caspian",{stdio:"inherit"}),updateAnswer?.isUpdate){const e=[],s=[],t=e=>{try{const s=path.join(u,"package.json");if(fs.existsSync(s)){const t=JSON.parse(fs.readFileSync(s,"utf8"));return!!(t.dependencies&&t.dependencies[e]||t.devDependencies&&t.devDependencies[e])}return!1}catch{return!1}};if(updateAnswer.backendOnly){nonBackendFiles.forEach(e=>{const s=path.join(u,"src","app",e);fs.existsSync(s)&&(fs.unlinkSync(s),console.log(`${e} was deleted successfully.`))});["js","css"].forEach(e=>{const s=path.join(u,"src","app",e);fs.existsSync(s)&&(fs.rmSync(s,{recursive:!0,force:!0}),console.log(`${e} was deleted successfully.`))})}if(!updateAnswer.tailwindcss){["postcss.config.js"].forEach(e=>{const s=path.join(u,e);fs.existsSync(s)&&(fs.unlinkSync(s),console.log(`${e} was deleted successfully.`))});["tailwindcss","postcss","postcss-cli","@tailwindcss/postcss","cssnano"].forEach(s=>{t(s)&&e.push(s)}),s.push("tailwind-merge")}if(r.tailwindcss){const e=path.join(u,"public","css","index.css");if(fs.existsSync(e))try{fs.unlinkSync(e),console.log(`${e} was deleted successfully.`)}catch(s){console.warn(chalk.yellow(`Failed to delete ${e}: ${s}`))}}if(!updateAnswer.mcp){["restart-mcp.ts"].forEach(e=>{const s=path.join(u,"settings",e);fs.existsSync(s)&&(fs.unlinkSync(s),console.log(`${e} was deleted successfully.`))});const e=path.join(u,"src","lib","mcp");fs.existsSync(e)&&(fs.rmSync(e,{recursive:!0,force:!0}),console.log("MCP folder was deleted successfully.")),s.push("mcp")}if(!updateAnswer.prisma){["prisma","@prisma/client","@prisma/internals","better-sqlite3","@prisma/adapter-better-sqlite3","mariadb","@prisma/adapter-mariadb","pg","@prisma/adapter-pg","@types/pg"].forEach(s=>{t(s)&&e.push(s)}),s.push("psycopg2-binary","asyncpg","aiosqlite","aiomysql")}if(!updateAnswer.typescript||updateAnswer.backendOnly){["vite.config.ts"].forEach(e=>{const s=path.join(u,e);fs.existsSync(s)&&(fs.unlinkSync(s),console.log(`${e} was deleted successfully.`))});const s=path.join(u,"ts");fs.existsSync(s)&&(fs.rmSync(s,{recursive:!0,force:!0}),console.log("ts folder was deleted successfully."));const n=path.join(u,"settings","vite-plugins");fs.existsSync(n)&&(fs.rmSync(n,{recursive:!0,force:!0}),console.log("settings/vite-plugins folder was deleted successfully."));["vite","fast-glob"].forEach(s=>{t(s)&&e.push(s)})}const n=(e=>Array.from(new Set(e)))(e);n.length>0&&(console.log(`Uninstalling npm packages: ${n.join(", ")}`),await uninstallNpmDependencies(u,n,!0)),s.length>0&&await uninstallPythonDependencies(u,s)}if(!o||!fs.existsSync(path.join(u,"caspian.config.json"))){const e=u.replace(/\\/g,"\\"),s=bsConfigUrls(e),t={projectName:r.projectName,projectRootPath:e,bsTarget:s.bsTarget,bsPathRewrite:s.bsPathRewrite,backendOnly:r.backendOnly,tailwindcss:r.tailwindcss,mcp:r.mcp,prisma:r.prisma,typescript:r.typescript,version:l,componentScanDirs:updateAnswer?.componentScanDirs??["src"],excludeFiles:updateAnswer?.excludeFiles??[]};fs.writeFileSync(path.join(u,"caspian.config.json"),JSON.stringify(t,null,2),{flag:"w"})}await ensurePythonVenvAndDeps(u,r),setupVsCodeSettings(u),console.log("\n=========================\n"),console.log(`${chalk.green("Success!")} Caspian project successfully created in ${chalk.green(u.replace(/\\/g,"/"))}!`),console.log("\n=========================")}catch(e){console.error("Error while creating the project:",e),process.exit(1)}}main();
+import{execSync,spawnSync}from"child_process";import fs from"fs";import{fileURLToPath}from"url";import path from"path";import chalk from"chalk";import prompts from"prompts";import https from"https";import{randomBytes}from"crypto";const __filename=fileURLToPath(import.meta.url),__dirname=path.dirname(__filename);let updateAnswer=null;const nonBackendFiles=["favicon.ico","\\src\\app\\index.html","not-found.html","error.html"],STARTER_KITS={basic:{id:"basic",name:"Basic PHP Application",description:"Simple PHP backend with minimal dependencies",features:{backendOnly:!0,tailwindcss:!1,prisma:!1,mcp:!1},requiredFiles:["main.py",".prettierrc","pyproject.toml","src/app/layout.html","src/app/index.html"]},fullstack:{id:"fullstack",name:"Full-Stack Application",description:"Complete web application with frontend and backend",features:{backendOnly:!1,tailwindcss:!0,prisma:!0,mcp:!1},requiredFiles:["main.py",".prettierrc","pyproject.toml","postcss.config.js","src/app/layout.html","src/app/index.html","public/js/main.js","src/app/globals.css"]},api:{id:"api",name:"REST API",description:"Backend API with database and documentation",features:{backendOnly:!0,tailwindcss:!1,prisma:!0,mcp:!1},requiredFiles:["main.py","pyproject.toml"]},realtime:{id:"realtime",name:"Real-time Application",description:"Application with WebSocket support and MCP",features:{backendOnly:!1,tailwindcss:!0,prisma:!0,mcp:!0},requiredFiles:["main.py",".prettierrc","pyproject.toml","postcss.config.js","src/lib/mcp"]}};function bsConfigUrls(e){const s=e.indexOf("\\htdocs\\");if(-1===s)return console.error("Invalid PROJECT_ROOT_PATH. The path does not contain \\htdocs\\"),{bsTarget:"",bsPathRewrite:{}};const n=e.substring(0,s+8).replace(/\\/g,"\\\\"),t=e.replace(new RegExp(`^${n}`),"").replace(/\\/g,"/");let i=`http://localhost/${t}`;i=i.endsWith("/")?i.slice(0,-1):i;const c=i.replace(/(?<!:)(\/\/+)/g,"/"),a=t.replace(/\/\/+/g,"/");return{bsTarget:`${c}/`,bsPathRewrite:{"^/":`/${a.startsWith("/")?a.substring(1):a}/`}}}async function updatePackageJson(e,s){const n=path.join(e,"package.json");if(checkExcludeFiles(n))return;const t=JSON.parse(fs.readFileSync(n,"utf8"));t.scripts={...t.scripts,projectName:"tsx settings/project-name.ts"};let i=[];s.tailwindcss&&(t.scripts={...t.scripts,tailwind:"postcss src/app/globals.css -o public/css/styles.css --watch","tailwind:build":"postcss src/app/globals.css -o public/css/styles.css"},i.push("tailwind")),s.typescript&&!s.backendOnly&&(t.scripts={...t.scripts,"ts:watch":"vite build --watch","ts:build":"vite build"},i.push("ts:watch")),s.mcp&&(t.scripts={...t.scripts,mcp:"tsx settings/restart-mcp.ts"},i.push("mcp"));let c={...t.scripts};c.browserSync="tsx settings/bs-config.ts",c["browserSync:build"]="tsx settings/build.ts",c.dev=`npm-run-all projectName -p browserSync ${i.join(" ")}`;let a=["browserSync:build"];s.tailwindcss&&a.unshift("tailwind:build"),s.typescript&&!s.backendOnly&&a.unshift("ts:build"),c.build=`npm-run-all ${a.join(" ")}`,t.scripts=c,t.type="module",fs.writeFileSync(n,JSON.stringify(t,null,2))}function generateAuthSecret(){return randomBytes(33).toString("base64")}function generateHexEncodedKey(e=16){return randomBytes(e).toString("hex")}function copyRecursiveSync(e,s,n){const t=fs.existsSync(e),i=t&&fs.statSync(e);if(t&&i&&i.isDirectory()){const t=s.toLowerCase();if(!n.mcp&&t.includes("src\\lib\\mcp"))return;if((!n.typescript||n.backendOnly)&&(t.endsWith("\\ts")||t.includes("\\ts\\")))return;if((!n.typescript||n.backendOnly)&&(t.endsWith("\\vite-plugins")||t.includes("\\vite-plugins\\")||t.includes("\\vite-plugins")))return;if(n.backendOnly&&t.includes("public\\js")||n.backendOnly&&t.includes("public\\css")||n.backendOnly&&t.includes("public\\assets"))return;const i=s.replace(/\\/g,"/");if(updateAnswer?.excludeFilePath?.includes(i))return;fs.existsSync(s)||fs.mkdirSync(s,{recursive:!0}),fs.readdirSync(e).forEach(t=>{copyRecursiveSync(path.join(e,t),path.join(s,t),n)})}else{if(checkExcludeFiles(s))return;if(!n.tailwindcss&&(s.includes("globals.css")||s.includes("styles.css")))return;if(!n.mcp&&s.includes("restart-mcp.ts"))return;if(n.backendOnly&&nonBackendFiles.some(e=>s.includes(e)))return;if(n.backendOnly&&s.includes("layout.html"))return;if(n.tailwindcss&&s.includes("index.css"))return;if(!n.prisma&&s.includes("prisma-schema-config.json"))return;fs.copyFileSync(e,s,0)}}async function executeCopy(e,s,n){s.forEach(({src:s,dest:t})=>{copyRecursiveSync(path.join(__dirname,s),path.join(e,t),n)})}function modifyPostcssConfig(e){const s=path.join(e,"postcss.config.js");if(checkExcludeFiles(s))return;fs.writeFileSync(s,'export default {\n  plugins: {\n    "@tailwindcss/postcss": {},\n    cssnano: {},\n  },\n};',{flag:"w"})}function modifyLayoutPHP(e,s){const n=path.join(e,"src","app","layout.html");if(!checkExcludeFiles(n))try{let e=fs.readFileSync(n,"utf8"),t="";s.backendOnly||(s.tailwindcss||(t='\n    <link href="/css/index.css" rel="stylesheet" />'),t+='\n    <script type="module" src="/js/main.js"><\/script>');let i="";s.backendOnly||(i=s.tailwindcss?`  <link href="/css/styles.css" rel="stylesheet" />${t}`:t),e=e.replace("</head>",`${i}\n</head>`),fs.writeFileSync(n,e,{flag:"w"})}catch(e){console.error(chalk.red("Error modifying layout.html:"),e)}}async function createOrUpdateEnvFile(e,s){const n=path.join(e,".env");checkExcludeFiles(n)||fs.writeFileSync(n,s,{flag:"w"})}function checkExcludeFiles(e){if(!updateAnswer?.isUpdate)return!1;const s=e.replace(/\\/g,"/");return!!updateAnswer?.excludeFilePath?.includes(s)||!!updateAnswer?.excludeFiles&&updateAnswer.excludeFiles.some(e=>{const n=e.replace(/\\/g,"/");return s.endsWith("/"+n)||s===n})}async function createDirectoryStructure(e,s){const n=[{src:"/main.py",dest:"/main.py"},{src:"/.prettierrc",dest:"/.prettierrc"},{src:"/pyproject.toml",dest:"/pyproject.toml"},{src:"/tsconfig.json",dest:"/tsconfig.json"},{src:"/app-gitignore",dest:"/.gitignore"}];s.tailwindcss&&n.push({src:"/postcss.config.js",dest:"/postcss.config.js"}),s.typescript&&!s.backendOnly&&n.push({src:"/vite.config.ts",dest:"/vite.config.ts"});const t=[{src:"/settings",dest:"/settings"},{src:"/src",dest:"/src"},{src:"/public",dest:"/public"}];s.typescript&&!s.backendOnly&&t.push({src:"/ts",dest:"/ts"}),n.forEach(({src:s,dest:n})=>{const t=path.join(__dirname,s),i=path.join(e,n);if(checkExcludeFiles(i))return;const c=fs.readFileSync(t,"utf8");fs.writeFileSync(i,c,{flag:"w"})}),await executeCopy(e,t,s),await updatePackageJson(e,s),s.tailwindcss&&modifyPostcssConfig(e),!s.tailwindcss&&s.backendOnly||modifyLayoutPHP(e,s);const i=`# Authentication secret key for JWT or session encryption.\nAUTH_SECRET="${generateAuthSecret()}"\n# Name of the authentication cookie.\nAUTH_COOKIE_NAME="${generateHexEncodedKey(8)}"\nAUTH_TOKEN_VALIDITY="1h"\nAUTH_TOKEN_AUTO_REFRESH="true"\n\nAUTH_ALL_ROUTES_PRIVATE="true"\nAUTH_PUBLIC_ROUTES="/"\nAUTH_ROUTES="/signin,/signup"\nAUTH_PRIVATE_ROUTES=""\n\nAUTH_ROLE_BASED="false"\nAUTH_ROLE_IDENTIFIER="role"\n# Role-based route allowlist (JSON)\n# Format: {"roleName": ["/route1", "/route2"]}\n# Example:\n# AUTH_ROLE_BASED_ROUTES_JSON="{"admin": ["/admin", "/reports"], "user": ["/dashboard"]}"\nAUTH_ROLE_BASED_ROUTES_JSON="{}"\n\nAUTH_DEFAULT_SIGNIN_REDIRECT="/dashboard"\nAUTH_DEFAULT_SIGNOUT_REDIRECT="/signin"\nAUTH_API_PREFIX="/api/auth"\n\n# Show errors in the browser (development only). Set to false in production.\nSHOW_ERRORS="true"\n\n# Application timezone (default: UTC)\nAPP_TIMEZONE="UTC"\n\n# Application environment (development or production)\nAPP_ENV="development"\n\n# Enable or disable application cache (default: false)\nCACHE_ENABLED="false"\n# Cache time-to-live in seconds (default: 600)\nCACHE_TTL="600"\n\n# Secret key for encrypting function calls.\nFUNCTION_CALL_SECRET="${generateHexEncodedKey(32)}"\n\n# Single or multiple origins allowed for CORS (comma-separated)\nCORS_ALLOWED_ORIGINS=""\n\n# If you need cookies/Authorization across origins, keep this true\nCORS_ALLOW_CREDENTIALS="true"\n\n# Optional tuning\nCORS_ALLOWED_METHODS="GET,POST,PUT,PATCH,DELETE,OPTIONS"\nCORS_ALLOWED_HEADERS="Content-Type,Authorization,X-Requested-With"\nCORS_EXPOSE_HEADERS=""\nCORS_MAX_AGE="86400"\n\n# Session & Security\nSESSION_LIFETIME_HOURS="7"\nMAX_CONTENT_LENGTH_MB="16"\n\n# Rate Limiting\nRATE_LIMIT_DEFAULT="200 per minute"\nRATE_LIMIT_RPC="60 per minute"\nRATE_LIMIT_AUTH="60 per minute"`;if(s.prisma){const s=`${'# Environment variables declared in this file are automatically made available to Prisma.\n# See the documentation for more detail: https://pris.ly/d/prisma-schema#accessing-environment-variables-from-the-schema\n\n# Prisma supports the native connection string format for PostgreSQL, MySQL, SQLite, SQL Server, MongoDB and CockroachDB.\n# See the documentation for all the connection string options: https://pris.ly/d/connection-strings\n\nDATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public"'}\n\n${i}`;await createOrUpdateEnvFile(e,s)}else await createOrUpdateEnvFile(e,i)}async function getAnswer(e={},s=!1){if(s)return{projectName:e.projectName??"my-app",backendOnly:e.backendOnly??!1,tailwindcss:e.tailwindcss??!1,typescript:e.typescript??!1,mcp:e.mcp??!1,prisma:e.prisma??!1};if(e.starterKit){const s=e.starterKit;let n=null;if(STARTER_KITS[s]&&(n=STARTER_KITS[s]),n){const t={projectName:e.projectName??"my-app",starterKit:s,starterKitSource:e.starterKitSource,backendOnly:n.features.backendOnly??!1,tailwindcss:n.features.tailwindcss??!1,prisma:n.features.prisma??!1,mcp:n.features.mcp??!1,typescript:n.features.typescript??!1},i=process.argv.slice(2);return i.includes("--backend-only")&&(t.backendOnly=!0),i.includes("--tailwindcss")&&(t.tailwindcss=!0),i.includes("--mcp")&&(t.mcp=!0),i.includes("--prisma")&&(t.prisma=!0),i.includes("--typescript")&&(t.typescript=!0),t}if(e.starterKitSource){const n={projectName:e.projectName??"my-app",starterKit:s,starterKitSource:e.starterKitSource,backendOnly:!1,tailwindcss:!0,prisma:!0,mcp:!1,typescript:!1},t=process.argv.slice(2);return t.includes("--backend-only")&&(n.backendOnly=!0),t.includes("--tailwindcss")&&(n.tailwindcss=!0),t.includes("--mcp")&&(n.mcp=!0),t.includes("--prisma")&&(n.prisma=!0),t.includes("--typescript")&&(n.typescript=!0),n}}const n=[];e.projectName||n.push({type:"text",name:"projectName",message:"What is your project named?",initial:"my-app"}),e.backendOnly||updateAnswer?.isUpdate||n.push({type:"toggle",name:"backendOnly",message:`Would you like to create a ${chalk.blue("backend-only project")}?`,initial:!1,active:"Yes",inactive:"No"});const t=()=>{console.warn(chalk.red("Operation cancelled by the user.")),process.exit(0)},i=await prompts(n,{onCancel:t}),c=[];i.backendOnly??e.backendOnly??!1?(e.mcp||c.push({type:"toggle",name:"mcp",message:`Would you like to use ${chalk.blue("MCP (Model Context Protocol)")}?`,initial:!1,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma ORM")}?`,initial:!1,active:"Yes",inactive:"No"})):(e.tailwindcss||c.push({type:"toggle",name:"tailwindcss",message:`Would you like to use ${chalk.blue("Tailwind CSS")}?`,initial:!1,active:"Yes",inactive:"No"}),e.typescript||c.push({type:"toggle",name:"typescript",message:`Would you like to use ${chalk.blue("TypeScript")}?`,initial:!1,active:"Yes",inactive:"No"}),e.mcp||c.push({type:"toggle",name:"mcp",message:`Would you like to use ${chalk.blue("MCP (Model Context Protocol)")}?`,initial:!1,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma ORM")}?`,initial:!1,active:"Yes",inactive:"No"}));const a=await prompts(c,{onCancel:t});return{projectName:i.projectName?String(i.projectName).trim().replace(/ /g,"-"):e.projectName??"my-app",backendOnly:i.backendOnly??e.backendOnly??!1,tailwindcss:a.tailwindcss??e.tailwindcss??!1,typescript:a.typescript??e.typescript??!1,mcp:a.mcp??e.mcp??!1,prisma:a.prisma??e.prisma??!1}}async function uninstallNpmDependencies(e,s,n=!1){console.log("Uninstalling Node dependencies:"),s.forEach(e=>console.log(`- ${chalk.blue(e)}`));const t=`npm uninstall ${n?"--save-dev":"--save"} ${s.join(" ")}`;execSync(t,{stdio:"inherit",cwd:e})}function fetchPackageVersion(e){return new Promise((s,n)=>{https.get(`https://registry.npmjs.org/${e}`,e=>{let t="";e.on("data",e=>t+=e),e.on("end",()=>{try{const e=JSON.parse(t);s(e["dist-tags"].latest)}catch(e){n(new Error("Failed to parse JSON response"))}})}).on("error",e=>n(e))})}const readJsonFile=e=>{const s=fs.readFileSync(e,"utf8");return JSON.parse(s)};function compareVersions(e,s){const n=e.split(".").map(Number),t=s.split(".").map(Number);for(let e=0;e<n.length;e++){if(n[e]>t[e])return 1;if(n[e]<t[e])return-1}return 0}function getInstalledPackageVersion(e){try{const s=execSync(`npm list -g ${e} --depth=0`).toString().match(new RegExp(`${e}@(\\d+\\.\\d+\\.\\d+)`));return s?s[1]:(console.error(`Package ${e} is not installed`),null)}catch(e){return console.error(e instanceof Error?e.message:String(e)),null}}async function installNpmDependencies(e,s,n=!1){fs.existsSync(path.join(e,"package.json"))?console.log("Updating existing Node.js project..."):console.log("Initializing new Node.js project..."),fs.existsSync(path.join(e,"package.json"))||execSync("npm init -y",{stdio:"inherit",cwd:e}),console.log((n?"Installing development dependencies":"Installing dependencies")+":"),s.forEach(e=>console.log(`- ${chalk.blue(e)}`));const t=`npm install ${n?"--save-dev":""} ${s.join(" ")}`;execSync(t,{stdio:"inherit",cwd:e})}const npmPinnedVersions={"@tailwindcss/postcss":"4.1.18","@types/browser-sync":"2.29.1","@types/node":"25.0.3","@types/prompts":"2.4.9","browser-sync":"3.0.4",chalk:"5.6.2","chokidar-cli":"3.0.0",cssnano:"7.1.2","http-proxy-middleware":"3.0.5","npm-run-all":"4.1.5",postcss:"8.5.6","postcss-cli":"11.0.1",prompts:"2.4.2",tailwindcss:"4.1.18",tsx:"4.21.0",typescript:"5.9.3",vite:"7.3.0","fast-glob":"3.3.3","@lezer/common":"^1.5.1","@lezer/python":"^1.1.18"};function npmPkg(e){return npmPinnedVersions[e]?`${e}@${npmPinnedVersions[e]}`:e}async function setupStarterKit(e,s){if(!s.starterKit)return;let n=null;if(STARTER_KITS[s.starterKit]?n=STARTER_KITS[s.starterKit]:s.starterKitSource&&(n={id:s.starterKit,name:`Custom Starter Kit (${s.starterKit})`,description:"Custom starter kit from external source",features:{},requiredFiles:[],source:{type:"git",url:s.starterKitSource}}),n){if(console.log(chalk.green(`Setting up ${n.name}...`)),n.source)try{const t=n.source.branch?`git clone -b ${n.source.branch} --depth 1 ${n.source.url} ${e}`:`git clone --depth 1 ${n.source.url} ${e}`;execSync(t,{stdio:"inherit"});const i=path.join(e,".git");fs.existsSync(i)&&fs.rmSync(i,{recursive:!0,force:!0}),console.log(chalk.blue("Starter kit cloned successfully!"));const c=path.join(e,"caspian.config.json");if(fs.existsSync(c))try{const n=JSON.parse(fs.readFileSync(c,"utf8")),t=e.replace(/\\/g,"\\"),i=bsConfigUrls(t);n.projectName=s.projectName,n.projectRootPath=t,n.bsTarget=i.bsTarget,n.bsPathRewrite=i.bsPathRewrite;const a=await fetchPackageVersion("create-caspian-app");n.version=n.version||a,fs.writeFileSync(c,JSON.stringify(n,null,2)),console.log(chalk.green("Updated caspian.config.json with new project details"))}catch(e){console.warn(chalk.yellow("Failed to update caspian.config.json, will create new one"))}}catch(e){throw console.error(chalk.red(`Failed to setup starter kit: ${e}`)),e}n.customSetup&&await n.customSetup(e,s),console.log(chalk.green(`✓ ${n.name} setup complete!`))}else console.warn(chalk.yellow(`Starter kit '${s.starterKit}' not found. Skipping...`))}function showStarterKits(){console.log(chalk.blue("\n🚀 Available Starter Kits:\n")),Object.values(STARTER_KITS).forEach(e=>{const s=e.source?" (Custom)":" (Built-in)";console.log(chalk.green(`  ${e.id}${chalk.gray(s)}`)),console.log(`    ${e.name}`),console.log(chalk.gray(`    ${e.description}`)),e.source&&console.log(chalk.cyan(`    Source: ${e.source.url}`));const n=Object.entries(e.features).filter(([,e])=>!0===e).map(([e])=>e).join(", ");n&&console.log(chalk.magenta(`    Features: ${n}`)),console.log()}),console.log(chalk.yellow("Usage:")),console.log("  npx create-caspian-app my-project --starter-kit=basic"),console.log("  npx create-caspian-app my-project --starter-kit=custom --starter-kit-source=https://github.com/user/repo"),console.log()}function runCmd(e,s,n){const t=spawnSync(e,s,{cwd:n,stdio:"inherit",shell:!1,encoding:"utf8"});if(t.error)throw t.error;if(0!==t.status)throw new Error(`Command failed (${e} ${s.join(" ")}), exit=${t.status}`)}function tryRunCmd(e,s,n){const t=spawnSync(e,s,{cwd:n,stdio:"ignore",shell:!1,encoding:"utf8"});return!t.error&&0===t.status}function getVenvPythonPath(e){const s=path.join(e,".venv","Scripts","python.exe");if(fs.existsSync(s))return s;return path.join(e,".venv","bin","python")}async function uninstallPythonDependencies(e,s){const n=getVenvPythonPath(e);fs.existsSync(n)?(console.log("Uninstalling Python dependencies:"),s.forEach(e=>console.log(`- ${chalk.blue(e)}`)),runCmd(n,["-m","pip","uninstall","-y",...s],e)):console.warn(chalk.yellow("Virtual environment not found. Skipping Python dependency uninstallation."))}function fetchPyPiPackageVersion(e){return new Promise((s,n)=>{https.get(`https://pypi.org/pypi/${e}/json`,e=>{let t="";e.on("data",e=>t+=e),e.on("end",()=>{if(200===e.statusCode)try{const e=JSON.parse(t);s(e.info.version)}catch(e){n(new Error("Failed to parse PyPI JSON response"))}else n(new Error(`Request failed with status code ${e.statusCode}`))})}).on("error",e=>n(e))})}async function ensurePythonVenvAndDeps(e,s){console.log(chalk.green("\n=========================")),console.log(chalk.green("Python setup: creating venv + installing dependencies")),console.log(chalk.green("=========================\n"));const n=path.join(e,".venv");if(fs.existsSync(n)&&(fs.existsSync(path.join(e,".venv","Scripts","python.exe"))||fs.existsSync(path.join(e,".venv","bin","python"))))console.log(chalk.gray("Venv already exists: .venv"));else if(console.log(chalk.blue("Creating virtual environment: .venv")),tryRunCmd("py",["-m","venv",".venv"],e));else if(tryRunCmd("python",["-m","venv",".venv"],e));else if(!tryRunCmd("python3",["-m","venv",".venv"],e))throw new Error("Could not create venv. Install Python and ensure `py` or `python` is in PATH.");const t=getVenvPythonPath(e);if(!fs.existsSync(t))throw new Error(`Venv python not found at: ${t}`);console.log(chalk.blue("Upgrading pip...")),runCmd(t,["-m","pip","install","--upgrade","pip"],e);let i="caspian-utils";try{const e=await fetchPyPiPackageVersion("caspian-utils");i=`caspian-utils==${e}`,console.log(chalk.blue(`Pinned caspian-utils to version ${e}`))}catch(e){console.warn(chalk.yellow("Could not fetch latest caspian-utils version. Using unpinned dependency."))}const c=["fastapi>=0.110,<0.128","uvicorn>=0.27,<0.40","python-dotenv>=1.0,<2.0","jinja2>=3.1,<4.0","beautifulsoup4>=4.12,<5.0","slowapi>=0.1,<0.2","python-multipart>=0.0.9,<0.1","starsessions>=1.3,<2.2","httpx>=0.27,<0.29","werkzeug>=3.0,<4.0","cuid2>=2.0,<3.0","nanoid>=2.0,<3.0","python-ulid>=2.7,<3.1","cuid>=0.4.0,<0.5.0",i];s.tailwindcss&&c.push("tailwind-merge>=0.3.3,<0.4.0"),s.mcp&&c.push("fastmcp<3"),s.prisma&&(c.push("psycopg2-binary>=2.9,<3.0"),c.push("asyncpg>=0.31.0,<1.0"),c.push("aiosqlite>=0.22.1,<1.0"),c.push("aiomysql>=0.3.2,<1.0")),console.log(chalk.blue("Generating requirements.txt..."));const a=path.join(e,"requirements.txt"),r=c.join("\n")+"\n";fs.writeFileSync(a,r,"utf8"),console.log(chalk.gray(`Created requirements.txt with ${c.length} packages.`)),console.log(chalk.blue("Installing dependencies from requirements.txt...")),c.forEach(e=>console.log(`- ${chalk.gray(e)}`));runCmd(t,["-m","pip","install",...updateAnswer?.isUpdate?["--upgrade","--upgrade-strategy","only-if-needed"]:[],...updateAnswer?.isUpdate?["--no-cache-dir"]:[],"-r","requirements.txt"],e),console.log(chalk.green("\n✓ Python venv ready and FastAPI dependencies installed.\n"))}function setupVsCodeSettings(e){const s=path.join(e,".vscode");fs.existsSync(s)||fs.mkdirSync(s);const n={"python.defaultInterpreterPath":"win32"===process.platform?"${workspaceFolder}/.venv/Scripts/python.exe":"${workspaceFolder}/.venv/bin/python","python.terminal.activateEnvironment":!0,"python.analysis.typeCheckingMode":"basic","python.analysis.autoImportCompletions":!0};fs.writeFileSync(path.join(s,"settings.json"),JSON.stringify(n,null,2)),console.log(chalk.gray("Created .vscode/settings.json for auto-activation."))}async function main(){try{const e=process.argv.slice(2),s=e.includes("-y");let n=e[0];const t=e.find(e=>e.startsWith("--starter-kit=")),i=t?.split("=")[1],c=e.find(e=>e.startsWith("--starter-kit-source=")),a=c?.split("=")[1];if(e.includes("--list-starter-kits"))return void showStarterKits();let r=null,o=!1;if(n){const t=process.cwd(),c=path.join(t,"caspian.config.json");if(i&&a){o=!0;const t={projectName:n,starterKit:i,starterKitSource:a,backendOnly:e.includes("--backend-only"),tailwindcss:e.includes("--tailwindcss"),typescript:e.includes("--typescript"),mcp:e.includes("--mcp"),prisma:e.includes("--prisma")};r=await getAnswer(t,s)}else if(fs.existsSync(c)){const i=readJsonFile(c);let a=[];i.excludeFiles?.map(e=>{const s=path.join(t,e);fs.existsSync(s)&&a.push(s.replace(/\\/g,"/"))}),updateAnswer={projectName:n,backendOnly:i.backendOnly,tailwindcss:i.tailwindcss,mcp:i.mcp,prisma:i.prisma,typescript:i.typescript,isUpdate:!0,componentScanDirs:i.componentScanDirs??[],excludeFiles:i.excludeFiles??[],excludeFilePath:a??[],filePath:t};const o={projectName:n,backendOnly:e.includes("--backend-only")||i.backendOnly,tailwindcss:e.includes("--tailwindcss")||i.tailwindcss,typescript:e.includes("--typescript")||i.typescript,prisma:e.includes("--prisma")||i.prisma,mcp:e.includes("--mcp")||i.mcp};r=await getAnswer(o,s),null!==r&&(updateAnswer={projectName:n,backendOnly:r.backendOnly,tailwindcss:r.tailwindcss,mcp:r.mcp,prisma:r.prisma,typescript:r.typescript,isUpdate:!0,componentScanDirs:i.componentScanDirs??[],excludeFiles:i.excludeFiles??[],excludeFilePath:a??[],filePath:t})}else{const t={projectName:n,starterKit:i,starterKitSource:a,backendOnly:e.includes("--backend-only"),tailwindcss:e.includes("--tailwindcss"),typescript:e.includes("--typescript"),mcp:e.includes("--mcp"),prisma:e.includes("--prisma")};r=await getAnswer(t,s)}if(null===r)return void console.log(chalk.red("Installation cancelled."))}else r=await getAnswer({},s);if(null===r)return void console.warn(chalk.red("Installation cancelled."));const l=await fetchPackageVersion("create-caspian-app"),p=getInstalledPackageVersion("create-caspian-app");p?-1===compareVersions(p,l)&&(execSync("npm uninstall -g create-caspian-app",{stdio:"inherit"}),execSync("npm install -g create-caspian-app",{stdio:"inherit"})):execSync("npm install -g create-caspian-app",{stdio:"inherit"});const d=process.cwd();let u;if(n)if(o){const s=path.join(d,n);fs.existsSync(s)||fs.mkdirSync(s,{recursive:!0}),u=s,await setupStarterKit(u,r),process.chdir(u);const t=path.join(u,"caspian.config.json");if(fs.existsSync(t)){const s=JSON.parse(fs.readFileSync(t,"utf8"));e.includes("--backend-only")&&(s.backendOnly=!0),e.includes("--tailwindcss")&&(s.tailwindcss=!0),e.includes("--typescript")&&(s.typescript=!0),e.includes("--mcp")&&(s.mcp=!0),e.includes("--prisma")&&(s.prisma=!0),r={...r,backendOnly:s.backendOnly,tailwindcss:s.tailwindcss,typescript:s.typescript,mcp:s.mcp,prisma:s.prisma};let n=[];s.excludeFiles?.map(e=>{const s=path.join(u,e);fs.existsSync(s)&&n.push(s.replace(/\\/g,"/"))}),updateAnswer={...r,isUpdate:!0,componentScanDirs:s.componentScanDirs??[],excludeFiles:s.excludeFiles??[],excludeFilePath:n??[],filePath:u}}}else{const e=path.join(d,"caspian.config.json"),s=path.join(d,n),t=path.join(s,"caspian.config.json");fs.existsSync(e)?u=d:fs.existsSync(s)&&fs.existsSync(t)?(u=s,process.chdir(s)):(fs.existsSync(s)||fs.mkdirSync(s,{recursive:!0}),u=s,process.chdir(s))}else fs.mkdirSync(r.projectName,{recursive:!0}),u=path.join(d,r.projectName),process.chdir(r.projectName);let m=[npmPkg("typescript"),npmPkg("@types/node"),npmPkg("tsx"),npmPkg("http-proxy-middleware"),npmPkg("chalk"),npmPkg("npm-run-all"),npmPkg("browser-sync"),npmPkg("@types/browser-sync"),npmPkg("@lezer/common"),npmPkg("@lezer/python")];if(r.prisma&&m.push(npmPkg("prompts"),npmPkg("@types/prompts")),r.tailwindcss&&m.push(npmPkg("tailwindcss"),npmPkg("postcss"),npmPkg("postcss-cli"),npmPkg("@tailwindcss/postcss"),npmPkg("cssnano")),r.prisma&&execSync("npm install -g prisma-client-python@latest",{stdio:"inherit"}),r.typescript&&!r.backendOnly&&m.push(npmPkg("vite"),npmPkg("fast-glob")),r.starterKit&&!o&&await setupStarterKit(u,r),await installNpmDependencies(u,m,!0),n||execSync("npx tsc --init",{stdio:"inherit"}),await createDirectoryStructure(u,r),r.prisma&&execSync("npx ppy init --caspian",{stdio:"inherit"}),updateAnswer?.isUpdate){const e=[],s=[],n=e=>{try{const s=path.join(u,"package.json");if(fs.existsSync(s)){const n=JSON.parse(fs.readFileSync(s,"utf8"));return!!(n.dependencies&&n.dependencies[e]||n.devDependencies&&n.devDependencies[e])}return!1}catch{return!1}};if(updateAnswer.backendOnly){nonBackendFiles.forEach(e=>{const s=path.join(u,"src","app",e);fs.existsSync(s)&&(fs.unlinkSync(s),console.log(`${e} was deleted successfully.`))});["js","css"].forEach(e=>{const s=path.join(u,"src","app",e);fs.existsSync(s)&&(fs.rmSync(s,{recursive:!0,force:!0}),console.log(`${e} was deleted successfully.`))})}if(!updateAnswer.tailwindcss){["postcss.config.js"].forEach(e=>{const s=path.join(u,e);fs.existsSync(s)&&(fs.unlinkSync(s),console.log(`${e} was deleted successfully.`))});["tailwindcss","postcss","postcss-cli","@tailwindcss/postcss","cssnano"].forEach(s=>{n(s)&&e.push(s)}),s.push("tailwind-merge")}if(r.tailwindcss){const e=path.join(u,"public","css","index.css");if(fs.existsSync(e))try{fs.unlinkSync(e),console.log(`${e} was deleted successfully.`)}catch(s){console.warn(chalk.yellow(`Failed to delete ${e}: ${s}`))}}if(!updateAnswer.mcp){["restart-mcp.ts"].forEach(e=>{const s=path.join(u,"settings",e);fs.existsSync(s)&&(fs.unlinkSync(s),console.log(`${e} was deleted successfully.`))});const e=path.join(u,"src","lib","mcp");fs.existsSync(e)&&(fs.rmSync(e,{recursive:!0,force:!0}),console.log("MCP folder was deleted successfully.")),s.push("mcp")}if(!updateAnswer.prisma){["prisma","@prisma/client","@prisma/internals","better-sqlite3","@prisma/adapter-better-sqlite3","mariadb","@prisma/adapter-mariadb","pg","@prisma/adapter-pg","@types/pg"].forEach(s=>{n(s)&&e.push(s)}),s.push("psycopg2-binary","asyncpg","aiosqlite","aiomysql")}if(!updateAnswer.typescript||updateAnswer.backendOnly){["vite.config.ts"].forEach(e=>{const s=path.join(u,e);fs.existsSync(s)&&(fs.unlinkSync(s),console.log(`${e} was deleted successfully.`))});const s=path.join(u,"ts");fs.existsSync(s)&&(fs.rmSync(s,{recursive:!0,force:!0}),console.log("ts folder was deleted successfully."));const t=path.join(u,"settings","vite-plugins");fs.existsSync(t)&&(fs.rmSync(t,{recursive:!0,force:!0}),console.log("settings/vite-plugins folder was deleted successfully."));["vite","fast-glob"].forEach(s=>{n(s)&&e.push(s)})}const t=(e=>Array.from(new Set(e)))(e);t.length>0&&(console.log(`Uninstalling npm packages: ${t.join(", ")}`),await uninstallNpmDependencies(u,t,!0)),s.length>0&&await uninstallPythonDependencies(u,s)}if(!o||!fs.existsSync(path.join(u,"caspian.config.json"))){const e=u.replace(/\\/g,"\\"),s=bsConfigUrls(e),n={projectName:r.projectName,projectRootPath:e,bsTarget:s.bsTarget,bsPathRewrite:s.bsPathRewrite,backendOnly:r.backendOnly,tailwindcss:r.tailwindcss,mcp:r.mcp,prisma:r.prisma,typescript:r.typescript,version:l,componentScanDirs:updateAnswer?.componentScanDirs??["src"],excludeFiles:updateAnswer?.excludeFiles??[]};fs.writeFileSync(path.join(u,"caspian.config.json"),JSON.stringify(n,null,2),{flag:"w"})}await ensurePythonVenvAndDeps(u,r),setupVsCodeSettings(u),console.log("\n=========================\n"),console.log(`${chalk.green("Success!")} Caspian project successfully created in ${chalk.green(u.replace(/\\/g,"/"))}!`),console.log("\n=========================")}catch(e){console.error("Error while creating the project:",e),process.exit(1)}}main();

package/dist/settings/component-map.ts

@@ -1,7 +1,7 @@
 import * as fs from "fs";
 import * as path from "path";
-import Parser from "tree-sitter";
-import Python from "tree-sitter-python";
+import { parser as pythonParser } from "@lezer/python";
+import type { Tree, TreeCursor } from "@lezer/common";
 import { getFileMeta } from "./utils";
 
 const { __dirname } = getFileMeta();
@@ -42,291 +42,920 @@ const CONFIG_PATH = path.join(PROJECT_ROOT, CONFIG_FILENAME);
 
 /**
  * ---------------------------------------------------------
- * AST Helpers
+ * AST Helpers (Lezer)
  * ---------------------------------------------------------
  */
 
-const parser = new Parser();
-parser.setLanguage(Python as any);
+type NodeSpan = {
+  name: string;
+  from: number;
+  to: number;
+  children: NodeSpan[];
+};
+
+const PY_KEYWORDS = new Set([
+  "def",
+  "async",
+  "class",
+  "return",
+  "pass",
+  "if",
+  "elif",
+  "else",
+  "for",
+  "while",
+  "try",
+  "except",
+  "finally",
+  "with",
+  "lambda",
+  "yield",
+  "from",
+  "import",
+  "as",
+  "global",
+  "nonlocal",
+  "assert",
+  "raise",
+  "del",
+  "and",
+  "or",
+  "not",
+  "in",
+  "is",
+  "True",
+  "False",
+  "None",
+]);
+
+function slice(source: string, node: NodeSpan): string {
+  return source.slice(node.from, node.to);
+}
+
+function stripQuotes(value: string): string {
+  return value.replace(/^['"]|['"]$/g, "");
+}
+
+function lower(s: string): string {
+  return s.toLowerCase();
+}
+
+function isProbablyIdentifierText(text: string): boolean {
+  return /^[A-Za-z_][A-Za-z0-9_]*$/.test(text) && !PY_KEYWORDS.has(text);
+}
 
 /**
- * Extracts string values from a Dictionary node
+ * Convert Lezer cursor subtree into a plain recursive span tree.
+ * This makes traversals simpler and stable for custom heuristics.
  */
-function extractDictKeysFromNode(node: Parser.SyntaxNode): string[] {
-  const keys: string[] = [];
+function cursorToSpanTree(cursor: TreeCursor): NodeSpan {
+  const node: NodeSpan = {
+    name: cursor.name,
+    from: cursor.from,
+    to: cursor.to,
+    children: [],
+  };
+
+  if (cursor.firstChild()) {
+    do {
+      node.children.push(cursorToSpanTree(cursor));
+    } while (cursor.nextSibling());
+    cursor.parent();
+  }
+
+  return node;
+}
+
+function parsePythonToSpanTree(source: string): { tree: Tree; root: NodeSpan } {
+  const tree = pythonParser.parse(source);
+  const cursor = tree.cursor();
+  const root = cursorToSpanTree(cursor);
+  return { tree, root };
+}
+
+function walk(
+  node: NodeSpan,
+  cb: (node: NodeSpan, parent: NodeSpan | null) => void,
+  parent: NodeSpan | null = null,
+) {
+  cb(node, parent);
+  for (const child of node.children) walk(child, cb, node);
+}
+
+function findFirstDesc(
+  node: NodeSpan,
+  predicate: (n: NodeSpan) => boolean,
+): NodeSpan | null {
   for (const child of node.children) {
-    if (child.type === "dictionary_splat") continue;
+    if (predicate(child)) return child;
+    const deep = findFirstDesc(child, predicate);
+    if (deep) return deep;
+  }
+  return null;
+}
 
-    if (child.type === "pair") {
-      const keyNode = child.childForFieldName("key");
-      if (
-        keyNode &&
-        (keyNode.type === "string" || keyNode.type === "identifier")
-      ) {
-        keys.push(keyNode.text.replace(/^['"]|['"]$/g, ""));
-      }
+function isFunctionLikeNode(n: NodeSpan, source: string): boolean {
+  const name = lower(n.name);
+  if (
+    !(
+      name.includes("function") ||
+      name.includes("definition") ||
+      name.includes("def")
+    )
+  ) {
+    return false;
+  }
+  const text = slice(source, n).trimStart();
+  return text.startsWith("def ") || text.startsWith("async def ");
+}
+
+function isDecoratedLikeNode(n: NodeSpan, source: string): boolean {
+  const name = lower(n.name);
+  if (name.includes("decorated")) return true;
+
+  // fallback heuristic: node text starts with @ and contains a function definition
+  const text = slice(source, n).trimStart();
+  return (
+    text.startsWith("@") &&
+    (text.includes("\ndef ") ||
+      text.includes("\nasync def ") ||
+      text.includes("def "))
+  );
+}
+
+function splitTopLevelComma(input: string): string[] {
+  const parts: string[] = [];
+  let current = "";
+  let depthParen = 0;
+  let depthBracket = 0;
+  let depthBrace = 0;
+  let inSingle = false;
+  let inDouble = false;
+  let escape = false;
+
+  for (let i = 0; i < input.length; i++) {
+    const ch = input[i];
+
+    if (escape) {
+      current += ch;
+      escape = false;
+      continue;
     }
+    if (ch === "\\") {
+      current += ch;
+      escape = true;
+      continue;
+    }
+
+    if (!inDouble && ch === "'" && !inSingle) {
+      inSingle = true;
+      current += ch;
+      continue;
+    } else if (inSingle && ch === "'") {
+      inSingle = false;
+      current += ch;
+      continue;
+    }
+
+    if (!inSingle && ch === '"' && !inDouble) {
+      inDouble = true;
+      current += ch;
+      continue;
+    } else if (inDouble && ch === '"') {
+      inDouble = false;
+      current += ch;
+      continue;
+    }
+
+    if (inSingle || inDouble) {
+      current += ch;
+      continue;
+    }
+
+    if (ch === "(") depthParen++;
+    else if (ch === ")") depthParen--;
+    else if (ch === "[") depthBracket++;
+    else if (ch === "]") depthBracket--;
+    else if (ch === "{") depthBrace++;
+    else if (ch === "}") depthBrace--;
+
+    if (
+      ch === "," &&
+      depthParen === 0 &&
+      depthBracket === 0 &&
+      depthBrace === 0
+    ) {
+      if (current.trim()) parts.push(current.trim());
+      current = "";
+      continue;
+    }
+
+    current += ch;
   }
-  return keys;
+
+  if (current.trim()) parts.push(current.trim());
+  return parts;
 }
 
 /**
- * Extracts values from a Literal[...] or types from Union[...] node
+ * Extract values from Literal[...] / Union[...] strings.
+ * (Leaf text parsing is okay here)
  */
-function extractLiteralValues(node: Parser.SyntaxNode): string[] {
+function extractLiteralValuesFromTypeString(typeExpr: string): string[] {
+  const expr = typeExpr.trim();
   const values: string[] = [];
 
-  if (node.type !== "subscript" && node.type !== "generic_type") return values;
-
-  let typeName: string | undefined;
-  if (node.type === "subscript") {
-    typeName = node.childForFieldName("value")?.text;
-  } else if (node.type === "generic_type") {
-    typeName = node.children.find((c) => c.type === "identifier")?.text;
+  // Literal[...]
+  if (expr.startsWith("Literal[") && expr.endsWith("]")) {
+    const inner = expr.slice(expr.indexOf("[") + 1, -1);
+    for (const part of splitTopLevelComma(inner)) {
+      const p = part.trim();
+      if (!p) continue;
+      if (/^['"].*['"]$/s.test(p)) values.push(stripQuotes(p));
+      else values.push(p);
+    }
+    return values;
   }
 
-  // --- Handle Literal[...] ---
-  if (typeName === "Literal") {
-    const findValues = (n: Parser.SyntaxNode) => {
-      if (n.type === "string") {
-        // Strip quotes from strings
-        values.push(n.text.replace(/^['"]|['"]$/g, ""));
-      } else if (
-        ["integer", "float", "true", "false", "none"].includes(n.type)
-      ) {
-        // Capture raw values for primitives (e.g. Literal[1, True, None])
-        values.push(n.text);
+  // Union[...]
+  if (expr.startsWith("Union[") && expr.endsWith("]")) {
+    const inner = expr.slice(expr.indexOf("[") + 1, -1);
+    for (const part of splitTopLevelComma(inner)) {
+      const p = part.trim();
+      if (!p) continue;
+      if (p.startsWith("Literal[") && p.endsWith("]")) {
+        values.push(...extractLiteralValuesFromTypeString(p));
+      } else {
+        values.push(p);
       }
-      for (const child of n.children) {
-        findValues(child);
+    }
+    return values;
+  }
+
+  return values;
+}
+
+/**
+ * ---------------------------------------------------------
+ * AST-driven Python structure extraction
+ * ---------------------------------------------------------
+ */
+
+type DecoratedFunctionAst = {
+  decoratedNode: NodeSpan;
+  functionNode: NodeSpan;
+  decoratorNodes: NodeSpan[];
+};
+
+function getTopLevelStatements(root: NodeSpan): NodeSpan[] {
+  // Lezer root usually has direct statement nodes; keep generic
+  return root.children;
+}
+
+/**
+ * Find decorated functions by AST traversal (no regex structure scan)
+ */
+function findDecoratedFunctionsAst(
+  root: NodeSpan,
+  source: string,
+): DecoratedFunctionAst[] {
+  const results: DecoratedFunctionAst[] = [];
+
+  walk(root, (node) => {
+    if (!isDecoratedLikeNode(node, source)) return;
+
+    const functionNode =
+      node.children.find((c) => isFunctionLikeNode(c, source)) ||
+      findFirstDesc(node, (c) => isFunctionLikeNode(c, source));
+
+    if (!functionNode) return;
+
+    // Decorators are usually sibling children before function node
+    const decoratorNodes = node.children.filter((c) => {
+      if (c === functionNode) return false;
+      const txt = slice(source, c).trimStart();
+      return txt.startsWith("@");
+    });
+
+    results.push({
+      decoratedNode: node,
+      functionNode,
+      decoratorNodes,
+    });
+  });
+
+  return results;
+}
+
+function decoratorMatchesComponent(node: NodeSpan, source: string): boolean {
+  const txt = slice(source, node).trim();
+  // Supports @component and @component(...)
+  return txt === "@component" || txt.startsWith("@component(");
+}
+
+function extractFunctionNameAst(
+  functionNode: NodeSpan,
+  source: string,
+): string {
+  const txt = slice(source, functionNode);
+
+  // Header-based extraction (robust fix for "def" bug)
+  // Supports:
+  //   def Profile(...)
+  //   async def Profile(...)
+  const parenIndex = txt.indexOf("(");
+  if (parenIndex > 0) {
+    const header = txt.slice(0, parenIndex);
+    const defIndex = header.indexOf("def");
+
+    if (defIndex >= 0) {
+      const afterDef = header.slice(defIndex + 3).trim();
+
+      let i = 0;
+      while (i < afterDef.length && /\s/.test(afterDef[i])) i++;
+
+      let j = i;
+      while (j < afterDef.length && /[A-Za-z0-9_]/.test(afterDef[j])) j++;
+
+      const candidate = afterDef.slice(i, j).trim();
+      if (candidate && isProbablyIdentifierText(candidate)) {
+        return candidate;
       }
-    };
-    findValues(node);
+    }
+  }
+
+  // AST fallback: direct children identifiers excluding keywords
+  for (const child of functionNode.children) {
+    const t = slice(source, child).trim();
+    if (isProbablyIdentifierText(t)) return t;
+  }
+
+  // Deep fallback
+  const nameNode = findFirstDesc(functionNode, (n) => {
+    const t = slice(source, n).trim();
+    return isProbablyIdentifierText(t);
+  });
+  if (nameNode) return slice(source, nameNode).trim();
+
+  return "Unknown";
+}
+
+function findParamListNode(
+  functionNode: NodeSpan,
+  source: string,
+): NodeSpan | null {
+  // Prefer child whose text starts with "(" and ends with ")"
+  for (const child of functionNode.children) {
+    const txt = slice(source, child).trim();
+    if (txt.startsWith("(") && txt.endsWith(")")) return child;
   }
 
-  // --- Handle Union[...] ---
-  else if (typeName === "Union") {
-    for (const child of node.children) {
-      // Skip the "Union" keyword itself and punctuation
+  // fallback deep search
+  return findFirstDesc(functionNode, (n) => {
+    const txt = slice(source, n).trim();
+    return txt.startsWith("(") && txt.endsWith(")");
+  });
+}
+
+function extractParamListTextAst(
+  functionNode: NodeSpan,
+  source: string,
+): string {
+  const paramsNode = findParamListNode(functionNode, source);
+  if (!paramsNode) return "";
+
+  const txt = slice(source, paramsNode).trim();
+  if (txt.startsWith("(") && txt.endsWith(")")) {
+    return txt.slice(1, -1);
+  }
+  return txt;
+}
+
+function findFunctionBodyNode(
+  functionNode: NodeSpan,
+  source: string,
+): NodeSpan | null {
+  // Heuristic: child block after ":" with multiline content often is the body
+  const candidates = functionNode.children.filter((c) => {
+    const txt = slice(source, c);
+    return (
+      txt.includes("\n") ||
+      txt.trimStart().startsWith("return") ||
+      txt.trimStart().startsWith("pass")
+    );
+  });
+
+  if (candidates.length > 0) {
+    // last candidate tends to be body
+    return candidates[candidates.length - 1];
+  }
+
+  // fallback deep search for a block/suite-like name
+  return findFirstDesc(functionNode, (n) => {
+    const name = lower(n.name);
+    return (
+      name.includes("body") || name.includes("suite") || name.includes("block")
+    );
+  });
+}
+
+function extractFunctionBodyTextAst(
+  functionNode: NodeSpan,
+  source: string,
+): string {
+  const bodyNode = findFunctionBodyNode(functionNode, source);
+  if (!bodyNode) {
+    // fallback: slice after first colon in function text
+    const txt = slice(source, functionNode);
+    const idx = txt.indexOf(":");
+    return idx >= 0 ? txt.slice(idx + 1) : "";
+  }
+  return slice(source, bodyNode);
+}
+
+/**
+ * Parse a single parameter chunk (still text-level, but only for leaf content)
+ */
+function parseParameterChunk(raw: string): {
+  name: string;
+  type?: string;
+  defaultValue?: string;
+  arbitraryDict?: boolean;
+  listSplat?: boolean;
+} | null {
+  let s = raw.trim();
+  if (!s) return null;
+
+  // Positional-only / keyword-only separators
+  if (s === "/" || s === "*") return null;
+
+  // **kwargs
+  if (s.startsWith("**")) {
+    return { name: s.slice(2).trim(), arbitraryDict: true };
+  }
+
+  // *args
+  if (s.startsWith("*")) {
+    return { name: s.slice(1).trim(), listSplat: true };
+  }
+
+  // Split default at top-level "="
+  let left = s;
+  let defaultValue: string | undefined;
+
+  {
+    let depthParen = 0,
+      depthBracket = 0,
+      depthBrace = 0;
+    let inSingle = false,
+      inDouble = false,
+      escape = false;
+    let eqIndex = -1;
+
+    for (let i = 0; i < s.length; i++) {
+      const ch = s[i];
+
+      if (escape) {
+        escape = false;
+        continue;
+      }
+      if (ch === "\\") {
+        escape = true;
+        continue;
+      }
+
+      if (!inDouble && ch === "'" && !inSingle) {
+        inSingle = true;
+        continue;
+      } else if (inSingle && ch === "'") {
+        inSingle = false;
+        continue;
+      }
+
+      if (!inSingle && ch === '"' && !inDouble) {
+        inDouble = true;
+        continue;
+      } else if (inDouble && ch === '"') {
+        inDouble = false;
+        continue;
+      }
+
+      if (inSingle || inDouble) continue;
+
+      if (ch === "(") depthParen++;
+      else if (ch === ")") depthParen--;
+      else if (ch === "[") depthBracket++;
+      else if (ch === "]") depthBracket--;
+      else if (ch === "{") depthBrace++;
+      else if (ch === "}") depthBrace--;
+
       if (
-        (child.type === "identifier" && child.text === "Union") ||
-        ["[", "]", ","].includes(child.type)
+        ch === "=" &&
+        depthParen === 0 &&
+        depthBracket === 0 &&
+        depthBrace === 0
       ) {
+        eqIndex = i;
+        break;
+      }
+    }
+
+    if (eqIndex >= 0) {
+      left = s.slice(0, eqIndex).trim();
+      defaultValue = s.slice(eqIndex + 1).trim();
+    }
+  }
+
+  // Split type annotation at top-level ":"
+  let name = left;
+  let type: string | undefined;
+
+  {
+    let depthParen = 0,
+      depthBracket = 0,
+      depthBrace = 0;
+    let inSingle = false,
+      inDouble = false,
+      escape = false;
+    let colonIndex = -1;
+
+    for (let i = 0; i < left.length; i++) {
+      const ch = left[i];
+
+      if (escape) {
+        escape = false;
+        continue;
+      }
+      if (ch === "\\") {
+        escape = true;
         continue;
       }
 
-      // Capture Types (bool, str, etc.) and None
+      if (!inDouble && ch === "'" && !inSingle) {
+        inSingle = true;
+        continue;
+      } else if (inSingle && ch === "'") {
+        inSingle = false;
+        continue;
+      }
+
+      if (!inSingle && ch === '"' && !inDouble) {
+        inDouble = true;
+        continue;
+      } else if (inDouble && ch === '"') {
+        inDouble = false;
+        continue;
+      }
+
+      if (inSingle || inDouble) continue;
+
+      if (ch === "(") depthParen++;
+      else if (ch === ")") depthParen--;
+      else if (ch === "[") depthBracket++;
+      else if (ch === "]") depthBracket--;
+      else if (ch === "{") depthBrace++;
+      else if (ch === "}") depthBrace--;
+
       if (
-        child.type === "identifier" ||
-        child.type === "none" ||
-        child.type === "type" ||
-        child.type === "primitive_type"
+        ch === ":" &&
+        depthParen === 0 &&
+        depthBracket === 0 &&
+        depthBrace === 0
       ) {
-        values.push(child.text);
-      }
-      // Recursively handle nested structures (e.g. Union[str, Literal["a"]])
-      else if (child.type === "subscript" || child.type === "generic_type") {
-        values.push(...extractLiteralValues(child));
+        colonIndex = i;
+        break;
       }
     }
+
+    if (colonIndex >= 0) {
+      name = left.slice(0, colonIndex).trim();
+      type = left.slice(colonIndex + 1).trim();
+    }
   }
 
-  return values;
+  if (!name) return null;
+  return { name, type, defaultValue };
 }
 
 /**
- * Collects module-level type aliases
+ * AST-based top-level alias collection:
+ *   Size = Literal["sm","md"]
+ *   Foo = Union[str, Literal["x"]]
  */
-function collectTypeAliases(
-  rootNode: Parser.SyntaxNode
+function collectTypeAliasesAst(
+  root: NodeSpan,
+  source: string,
 ): Map<string, string[]> {
   const aliases = new Map<string, string[]>();
 
-  for (const child of rootNode.children) {
-    if (child.type === "expression_statement") {
-      const assignment = child.firstChild;
-      if (assignment?.type === "assignment") {
-        const left = assignment.childForFieldName("left");
-        const right = assignment.childForFieldName("right");
-
-        if (left?.type === "identifier" && right) {
-          const values = extractLiteralValues(right);
-          if (values.length > 0) {
-            aliases.set(left.text, values);
-          }
+  for (const stmt of getTopLevelStatements(root)) {
+    const stmtText = slice(source, stmt).trim();
+    if (!stmtText || stmtText.startsWith("@")) continue;
+
+    // structure is AST (top-level statement); leaf extraction uses text
+    const eqIndex = stmtText.indexOf("=");
+    if (eqIndex < 0) continue;
+
+    const left = stmtText.slice(0, eqIndex).trim();
+    const right = stmtText.slice(eqIndex + 1).trim();
+
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(left)) continue;
+
+    const values = extractLiteralValuesFromTypeString(right);
+    if (values.length > 0) {
+      aliases.set(left, values);
+    }
+  }
+
+  return aliases;
+}
+
+/**
+ * Dictionary key extraction from dict literal text (token-aware, no regex)
+ */
+function extractDictKeysFromText(dictText: string): string[] {
+  const keys: string[] = [];
+
+  const inner = dictText.trim();
+  if (!(inner.startsWith("{") && inner.endsWith("}"))) return keys;
+
+  const body = inner.slice(1, -1);
+  const pairs = splitTopLevelComma(body);
+
+  for (const part of pairs) {
+    const p = part.trim();
+    if (!p || p.startsWith("**")) continue;
+
+    // split top-level colon
+    let colonIndex = -1;
+    let depthParen = 0,
+      depthBracket = 0,
+      depthBrace = 0;
+    let inSingle = false,
+      inDouble = false,
+      escape = false;
+
+    for (let i = 0; i < p.length; i++) {
+      const ch = p[i];
+      if (escape) {
+        escape = false;
+        continue;
+      }
+      if (ch === "\\") {
+        escape = true;
+        continue;
+      }
+
+      if (!inDouble && ch === "'" && !inSingle) {
+        inSingle = true;
+        continue;
+      } else if (inSingle && ch === "'") {
+        inSingle = false;
+        continue;
+      }
+
+      if (!inSingle && ch === '"' && !inDouble) {
+        inDouble = true;
+        continue;
+      } else if (inDouble && ch === '"') {
+        inDouble = false;
+        continue;
+      }
+
+      if (inSingle || inDouble) continue;
+
+      if (ch === "(") depthParen++;
+      else if (ch === ")") depthParen--;
+      else if (ch === "[") depthBracket++;
+      else if (ch === "]") depthBracket--;
+      else if (ch === "{") depthBrace++;
+      else if (ch === "}") depthBrace--;
+
+      if (
+        ch === ":" &&
+        depthParen === 0 &&
+        depthBracket === 0 &&
+        depthBrace === 0
+      ) {
+        colonIndex = i;
+        break;
+      }
+    }
+
+    if (colonIndex < 0) continue;
+    const keyExpr = p.slice(0, colonIndex).trim();
+
+    if (/^['"].*['"]$/s.test(keyExpr)) {
+      keys.push(stripQuotes(keyExpr));
+    } else if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(keyExpr)) {
+      keys.push(keyExpr);
+    }
+  }
+
+  return [...new Set(keys)];
+}
+
+/**
+ * AST-ish body dictionary assignments:
+ * scoped body parsing (less fragile than whole-file regex)
+ */
+function extractBodyDictAssignmentsAst(
+  bodyText: string,
+): Map<string, string[]> {
+  const out = new Map<string, string[]>();
+  const lines = bodyText.split(/\r?\n/);
+
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i];
+    const trimmed = line.trim();
+
+    if (!trimmed || trimmed.startsWith("#")) {
+      i++;
+      continue;
+    }
+
+    // Look for `name = {`
+    const eq = line.indexOf("=");
+    if (eq < 0) {
+      i++;
+      continue;
+    }
+
+    const left = line.slice(0, eq).trim();
+    const rightStart = line.slice(eq + 1).trimStart();
+
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(left) || !rightStart.startsWith("{")) {
+      i++;
+      continue;
+    }
+
+    // collect balanced dict literal across lines
+    let dictText = line.slice(line.indexOf("{"));
+    let depth = 0;
+    let started = false;
+    let done = false;
+
+    const countBraces = (s: string) => {
+      let inSingle = false;
+      let inDouble = false;
+      let escape = false;
+
+      for (const ch of s) {
+        if (escape) {
+          escape = false;
+          continue;
+        }
+        if (ch === "\\") {
+          escape = true;
+          continue;
+        }
+
+        if (!inDouble && ch === "'" && !inSingle) {
+          inSingle = true;
+          continue;
+        } else if (inSingle && ch === "'") {
+          inSingle = false;
+          continue;
+        }
+
+        if (!inSingle && ch === '"' && !inDouble) {
+          inDouble = true;
+          continue;
+        } else if (inDouble && ch === '"') {
+          inDouble = false;
+          continue;
+        }
+
+        if (inSingle || inDouble) continue;
+
+        if (ch === "{") {
+          depth++;
+          started = true;
+        } else if (ch === "}") {
+          depth--;
+          if (started && depth === 0) done = true;
         }
       }
+    };
+
+    countBraces(dictText);
+
+    let j = i + 1;
+    while (!done && j < lines.length) {
+      dictText += "\n" + lines[j];
+      countBraces(lines[j]);
+      j++;
+    }
+
+    if (done) {
+      out.set(left, extractDictKeysFromText(dictText));
+      i = j;
+      continue;
     }
+
+    i++;
   }
-  return aliases;
+
+  return out;
 }
 
 /**
  * ---------------------------------------------------------
- * Core Analysis Logic (AST Based)
+ * Core Analysis Logic (AST-first)
  * ---------------------------------------------------------
  */
 
 function analyzeFile(filePath: string, rootDir: string): ComponentMetadata[] {
   const fileContent = fs.readFileSync(filePath, "utf-8");
-  const tree = parser.parse(fileContent);
+  const { root } = parsePythonToSpanTree(fileContent);
+
   const components: ComponentMetadata[] = [];
-  const typeAliases = collectTypeAliases(tree.rootNode);
-
-  const query = new Parser.Query(
-    Python as any,
-    `(decorated_definition 
-        (decorator) @dec 
-        (function_definition) @func
-     )`
-  );
+  const typeAliases = collectTypeAliasesAst(root, fileContent);
+  const decoratedFns = findDecoratedFunctionsAst(root, fileContent);
 
-  const matches = query.matches(tree.rootNode);
+  for (const item of decoratedFns) {
+    const hasComponentDecorator = item.decoratorNodes.some((d) =>
+      decoratorMatchesComponent(d, fileContent),
+    );
 
-  for (const match of matches) {
-    const decoratorNode = match.captures.find((c) => c.name === "dec")?.node;
-    if (decoratorNode?.text.trim() !== "@component") continue;
+    // fallback for grammars that don't expose decorator children cleanly
+    const decoratedText = slice(fileContent, item.decoratedNode);
+    const fallbackHasComponent =
+      decoratedText.trimStart().startsWith("@component") ||
+      decoratedText.includes("\n@component");
 
-    const funcNode = match.captures.find((c) => c.name === "func")?.node;
-    if (!funcNode) continue;
+    if (!hasComponentDecorator && !fallbackHasComponent) continue;
 
-    const nameNode = funcNode.childForFieldName("name");
-    const componentName = nameNode?.text || "Unknown";
-    const paramsNode = funcNode.childForFieldName("parameters");
-    const bodyNode = funcNode.childForFieldName("body");
+    const componentName = extractFunctionNameAst(
+      item.functionNode,
+      fileContent,
+    );
+    const paramsText = extractParamListTextAst(item.functionNode, fileContent);
+    const bodyText = extractFunctionBodyTextAst(item.functionNode, fileContent);
 
-    // 1. Parse Props (Parameters)
+    // 1) Parse Props (parameters)
     const props: ComponentProp[] = [];
     const propMap = new Map<string, ComponentProp>();
     let acceptsArbitraryProps = false;
 
-    if (paramsNode) {
-      for (const param of paramsNode.children) {
-        // --- Detect **props (dictionary_splat_pattern) ---
-        if (param.type === "dictionary_splat_pattern") {
-          acceptsArbitraryProps = true;
-          continue;
-        }
+    for (const rawParam of splitTopLevelComma(paramsText)) {
+      const parsed = parseParameterChunk(rawParam);
+      if (!parsed) continue;
 
-        // Skip punctuation and list splats (*args)
-        if (["(", ")", ",", "list_splat_pattern"].includes(param.type))
-          continue;
+      if (parsed.arbitraryDict) {
+        acceptsArbitraryProps = true;
+        continue;
+      }
+      if (parsed.listSplat) {
+        continue; // skip *args
+      }
 
-        let name = "";
-        let defaultValue: string | undefined = undefined;
-        let typeNode: Parser.SyntaxNode | null = null;
-
-        if (param.type === "identifier") {
-          name = param.text;
-        } else if (param.type === "default_parameter") {
-          name = param.childForFieldName("name")?.text || "";
-          defaultValue = param.childForFieldName("value")?.text;
-        } else if (param.type === "typed_parameter") {
-          const nameNode =
-            param.childForFieldName("name") ??
-            param.children.find((c) => c.type === "identifier") ??
-            null;
-
-          name = nameNode?.text || "";
-          typeNode =
-            param.childForFieldName("type") ??
-            param.children.find(
-              (c) => c.type !== "identifier" && c.type !== ":"
-            ) ??
-            null;
-        } else if (param.type === "typed_default_parameter") {
-          name = param.childForFieldName("name")?.text || "";
-          defaultValue = param.childForFieldName("value")?.text;
-          typeNode = param.childForFieldName("type") ?? null;
-        }
+      let { name, type, defaultValue } = parsed;
 
-        // Clean up quotes from default value
-        if (defaultValue)
-          defaultValue = defaultValue.replace(/^['"]|['"]$/g, "");
+      if (name === "self" || name === "cls") continue;
 
-        // Exclude standard python args
-        if (name === "self" || name === "cls") continue;
+      if (defaultValue && /^['"].*['"]$/s.test(defaultValue)) {
+        defaultValue = stripQuotes(defaultValue);
+      }
 
-        // --- Extract Type String ---
-        let propType = "Any";
-        if (typeNode) {
-          propType = typeNode.text;
-        }
+      const propType = type?.trim() || "Any";
 
-        // --- Extract Options ---
-        let options: string[] = [];
-        if (typeNode) {
-          let actualType: Parser.SyntaxNode | null = typeNode;
-          if (typeNode.type === "type") {
-            actualType = typeNode.firstChild;
-          }
-
-          if (actualType?.type === "identifier") {
-            options = typeAliases.get(actualType.text) || [];
-          } else if (
-            actualType?.type === "subscript" ||
-            actualType?.type === "generic_type"
-          ) {
-            options = extractLiteralValues(actualType);
-          } else if (actualType) {
-            const findSubscript = (
-              n: Parser.SyntaxNode
-            ): Parser.SyntaxNode | null => {
-              if (n.type === "subscript") return n;
-              for (const c of n.children) {
-                const found = findSubscript(c);
-                if (found) return found;
-              }
-              return null;
-            };
-            const subscript = findSubscript(actualType);
-            if (subscript) {
-              options = extractLiteralValues(subscript);
-            }
-          }
+      let options: string[] = [];
+      if (type) {
+        const t = type.trim();
+        if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(t)) {
+          options = typeAliases.get(t) || [];
+        } else {
+          options = extractLiteralValuesFromTypeString(t);
         }
+      }
 
-        const propObj: ComponentProp = {
-          name,
-          type: propType,
-          hasDefault: defaultValue !== undefined,
-          defaultValue,
-          options: options.length > 0 ? options : undefined,
-        };
+      const propObj: ComponentProp = {
+        name,
+        type: propType,
+        hasDefault: defaultValue !== undefined,
+        defaultValue,
+        options: options.length > 0 ? options : undefined,
+      };
 
-        props.push(propObj);
-        propMap.set(name, propObj);
-      }
+      props.push(propObj);
+      propMap.set(name, propObj);
     }
 
-    // 2. Parse Body for Dictionaries
-    if (bodyNode) {
-      for (const statement of bodyNode.children) {
-        if (statement.type === "expression_statement") {
-          const assignment = statement.firstChild;
-          if (assignment?.type === "assignment") {
-            const left = assignment.childForFieldName("left");
-            const right = assignment.childForFieldName("right");
-
-            if (left?.type === "identifier" && right?.type === "dictionary") {
-              const varName = left.text;
-              if (varName.endsWith("s")) {
-                const propName = varName.slice(0, -1);
-                const relatedProp = propMap.get(propName);
-
-                if (relatedProp) {
-                  if (!relatedProp.options) {
-                    relatedProp.options = extractDictKeysFromNode(right);
-                  }
-                }
-              }
-            }
-          }
-        }
+    // 2) Infer options from body dict assignments
+    const dictAssignments = extractBodyDictAssignmentsAst(bodyText);
+
+    for (const [varName, keys] of dictAssignments.entries()) {
+      if (!varName.endsWith("s")) continue;
+      const propName = varName.slice(0, -1);
+      const relatedProp = propMap.get(propName);
+      if (relatedProp && !relatedProp.options && keys.length > 0) {
+        relatedProp.options = keys;
       }
     }
 
-    // Generate Metadata Paths
+    // 3) Paths
     const relativePath = path.relative(rootDir, filePath).replace(/\\/g, "/");
     const pathNoExt = relativePath.replace(/\.py$/, "");
     const importRoute = pathNoExt.replace(/\//g, ".");
@@ -349,6 +978,7 @@ function analyzeFile(filePath: string, rootDir: string): ComponentMetadata[] {
  * File System Helpers
  * ---------------------------------------------------------
  */
+
 function loadConfig(): CaspianConfig {
   if (!fs.existsSync(CONFIG_PATH)) {
     console.error(`❌ Configuration file not found at: ${CONFIG_PATH}`);
@@ -360,18 +990,20 @@ function loadConfig(): CaspianConfig {
 function walkDirectory(
   dir: string,
   fileList: string[] = [],
-  excludeList: string[] = []
+  excludeList: string[] = [],
 ): string[] {
   if (!fs.existsSync(dir)) return fileList;
   const files = fs.readdirSync(dir);
+
   files.forEach((file) => {
     const fullPath = path.join(dir, file);
     const stat = fs.statSync(fullPath);
     const relativeCheck = path
       .relative(PROJECT_ROOT, fullPath)
       .replace(/\\/g, "/");
+
     const isExcluded = excludeList.some((ex) =>
-      relativeCheck.includes(ex.replace(/^\.\//, ""))
+      relativeCheck.includes(ex.replace(/^\.\//, "")),
     );
     if (isExcluded) return;
 
@@ -381,6 +1013,7 @@ function walkDirectory(
       fileList.push(fullPath);
     }
   });
+
   return fileList;
 }
 
@@ -389,8 +1022,9 @@ function walkDirectory(
  * Execution Entry Point
  * ---------------------------------------------------------
  */
+
 export async function componentMap() {
-  console.log(`🔍 Starting Component Analysis (AST Powered)...`);
+  console.log(`🔍 Starting Component Analysis (Lezer AST-first)...`);
   const config = loadConfig();
   let allFiles: string[] = [];
 
@@ -398,7 +1032,7 @@ export async function componentMap() {
     allFiles = walkDirectory(
       path.join(PROJECT_ROOT, scanDir),
       allFiles,
-      config.excludeFiles || []
+      config.excludeFiles || [],
     );
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-caspian-app",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Scaffold a new Caspian project (FastAPI-powered reactive Python framework).",
   "main": "dist/index.js",
   "type": "module",