phos 1.0.1 → 1.0.2

package/src/generators/single.ts

@@ -1,465 +0,0 @@
-import {
-  createDirectory,
-  writeFile,
-  getProjectPath,
-  logStep,
-  logSuccess,
-  logInfo,
-  initializeGit,
-  type GeneratorConfig,
-  capitalize,
-} from "@/utils/helpers.js";
-import { generateElysiaBackend } from "@/generators/backends/elysia.js";
-import { generateFastAPIBackend } from "@/generators/backends/fastapi.js";
-import { generateAstroFrontend } from "@/generators/frontends/astro.js";
-import { generateSvelteFrontend } from "@/generators/frontends/svelte.js";
-import { generateNextJSFrontend } from "@/generators/frontends/nextjs.js";
-
-export async function generateSingle(config: GeneratorConfig): Promise<void> {
-  const projectPath = getProjectPath(config.projectName);
-
-  logStep(`Creating single project at ${projectPath}`);
-  await createDirectory(projectPath);
-
-  const docsPath = `${projectPath}/Docs`;
-  await createDirectory(docsPath);
-
-  await generateGitIgnore(projectPath);
-  await generateReadme(projectPath, config);
-  await generateAgentsMd(projectPath, config);
-  await generateLicense(projectPath, config);
-  await generateEnvExample(projectPath);
-
-  if (config.backend?.framework) {
-    await createDirectory(`${projectPath}/src`);
-    switch (config.backend.framework) {
-      case "elysia":
-        await generateElysiaBackend(projectPath, config);
-        break;
-      case "fastapi":
-        await generateFastAPIBackend(projectPath, config);
-        break;
-    }
-  } else if (config.frontend?.framework) {
-    await createDirectory(`${projectPath}/src`);
-    switch (config.frontend.framework) {
-      case "astro":
-        await generateAstroFrontend(projectPath, config);
-        break;
-      case "svelte":
-        await generateSvelteFrontend(projectPath, config);
-        break;
-      case "nextjs":
-        await generateNextJSFrontend(projectPath, config);
-        break;
-    }
-  }
-
-  await createDirectory(`${docsPath}/Feature`);
-  await createDirectory(`${docsPath}/DatabaseSetup`);
-  await generateSchemaDocs(docsPath, config);
-
-  logSuccess(`Project created at ${config.projectName}`);
-  logSuccess("Docs folder created");
-
-  if (config.git) {
-    await initializeGit(projectPath);
-  }
-
-  if (config.backend?.framework) {
-    const backendInstallCmd =
-      config.backend.framework === "fastapi" && config.backend.packageManager === "venv"
-        ? `chmod +x setup.sh && ./setup.sh`
-        : config.backend.packageManager === "venv" || config.backend.packageManager === "pip"
-          ? `pip install -r requirements.txt`
-          : `${config.backend.packageManager} install`;
-    const backendRunCmd =
-      config.backend.framework === "fastapi"
-        ? `python src/main.py`
-        : `${config.backend.packageManager} run dev`;
-
-    logInfo("\n📦 Next steps:");
-    logInfo(`  cd ${config.projectName}`);
-    logInfo(`  ${backendInstallCmd}`);
-    logInfo(`  ${backendRunCmd}`);
-  } else if (config.frontend?.framework) {
-    logInfo("\n📦 Next steps:");
-    logInfo(`  cd ${config.projectName}`);
-    logInfo(`  ${config.frontend.packageManager} install`);
-    logInfo(`  ${config.frontend.packageManager} run dev`);
-  }
-}
-
-async function generateGitIgnore(projectPath: string): Promise<void> {
-  const content = `# Dependencies
-node_modules/
-.pnp
-.pnp.js
-
-# Testing
-coverage/
-*.lcov
-playwright-report/
-playwright/.cache/
-
-# Next.js
-.next/
-out/
-
-# Production
-build/
-dist/
-
-# Misc
-.DS_Store
-*.pem
-
-# Debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-
-# Local env files
-.env
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
-
-# Vercel
-.vercel
-
-# TypeScript
-*.tsbuildinfo
-
-# Astro
-.astro/
-
-# Svelte
-.svelte-kit/
-
-# Python
-__pycache__/
-*.py[cod]
-*$py.class
-*.so
-.Python
-venv/
-*.egg-info/
-.eggs/
-dist/
-build/
-
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
-*~
-`;
-
-  await writeFile(`${projectPath}/.gitignore`, content);
-  logSuccess(".gitignore created");
-}
-
-async function generateReadme(projectPath: string, config: GeneratorConfig): Promise<void> {
-  let content = `# ${config.projectName}
-
-This project was generated by [Phos](https://github.com/yourusername/phos).
-
-## Getting Started
-
-`;
-
-  if (config.backend?.framework) {
-    content += `\`\`\`bash
-${
-  config.backend!.packageManager === "venv" || config.backend!.packageManager === "pip"
-    ? "pip install -r requirements.txt"
-    : `${config.backend!.packageManager} install`
-}
-${config.backend!.framework === "fastapi" ? "python src/main.py" : `${config.backend!.packageManager} run dev`}
-\`\`\``;
-  } else if (config.frontend?.framework) {
-    content += `\`\`\`bash
-${config.frontend!.packageManager} install
-${config.frontend!.packageManager} run dev
-\`\`\``;
-  }
-
-  content += `
-
-## Tech Stack
-`;
-
-  if (config.backend?.framework) {
-    content += `- Framework: ${config.backend!.framework}
-- Package Manager: ${config.backend!.packageManager}
-- TypeScript: ${config.backend!.typescript ? "Yes" : "No"}
-- ESLint: ${config.backend!.eslint ? "Yes" : "No"}
-- Prettier: ${config.backend!.prettier ? "Yes" : "No"}
-`;
-  } else if (config.frontend?.framework) {
-    content += `- Framework: ${config.frontend!.framework}
-- Package Manager: ${config.frontend!.packageManager}
-- TypeScript: ${config.frontend!.typescript ? "Yes" : "No"}
-- ESLint: ${config.frontend!.eslint ? "Yes" : "No"}
-- Prettier: ${config.frontend!.prettier ? "Yes" : "No"}
-- CSS Framework: ${config.frontend!.cssFramework}
-- UI Components: ${config.frontend!.uiComponents}
-- Testing: ${config.frontend!.testing}
-`;
-  }
-
-  await writeFile(`${projectPath}/README.md`, content);
-  logSuccess("README.md created");
-}
-
-async function generateAgentsMd(projectPath: string, config: GeneratorConfig): Promise<void> {
-  const projectName = config.projectName;
-
-  const content = `# AGENTS Guidelines for This Repository
-
-## Project Name: ${projectName}
-
-This project was generated by [Phos](https://github.com/yourusername/phos).
-
-### Core Features:
-- Fast and interactive project setup
-- Modern framework support
-- Type-safe configurations
-- ESLint and Prettier support
-- Testing infrastructure
-
-### Project Structure:
-\`\`\`
-${projectName}/
-├── src/              # Source code
-├── Docs/              # Documentation
-│   ├── Feature/       # Feature documentation
-│   └── DatabaseSetup/ # Database scripts
-├── README.md          # Project documentation
-├── .gitignore         # Git ignore rules
-└── LICENSE            # License file
-\`\`\`
-
-### Development Workflow:
-1. Make changes to source code in \`src/\`
-2. Update documentation in \`Docs/\` as needed
-3. Test changes thoroughly
-4. Commit with clear, descriptive messages
-
-### Agent Guidelines:
-- Follow existing code style and conventions
-- Add proper type annotations where applicable
-- Write tests for new features
-- Update README.md for major changes
-- Use clear, descriptive variable/function names
-- Comment complex logic for maintainability
-
-### Best Practices:
-- Run linter before committing (ESLint, Prettier)
-- Test on different environments before deployment
-- Keep dependencies updated and secure
-- Write clear, concise commit messages
-- Review pull requests thoroughly before merging
-
-### Troubleshooting:
-- Check documentation first
-- Review recent changes if issues arise
-- Use version control to revert problematic changes
-- Ask for help in team channels when stuck
-`;
-
-  await writeFile(`${projectPath}/AGENTS.md`, content);
-  logSuccess("AGENTS.md created");
-}
-
-async function generateLicense(projectPath: string, config: GeneratorConfig): Promise<void> {
-  const year = new Date().getFullYear();
-  const content = `MIT License
-
-Copyright (c) ${year} ${config.projectName}
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense,
-and/or sell copies of the Software, and to permit persons to whom the
-Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-DEALINGS IN THE SOFTWARE.
-`;
-
-  await writeFile(`${projectPath}/LICENSE`, content);
-  logSuccess("LICENSE created");
-}
-
-async function generateEnvExample(projectPath: string): Promise<void> {
-  const content = `# Database
-DB_HOST=localhost
-DB_NAME=your_db_name
-DB_USER=postgres
-DB_PASSWORD=postgres
-DB_PORT=5433
-
-# URLs
-FRONTEND_BASE_URL=http://localhost:4200
-BACKEND_BASE_URL=http://localhost:4100
-
-# JWT Configuration for rest API
-JWT_SECRET=your-super-secret-jwt-key-change-in-production
-JWT_EXPIRES_IN=60m
-
-# Encryption
-ENCRYPTION_SALT=your-super-secret-salt-change-in-production
-
-# API Keys
-X_API_KEY=1234
-`;
-
-  await writeFile(`${projectPath}/env.example`, content);
-  logSuccess("env.example created");
-}
-
-async function generateSchemaDocs(docsPath: string, config: GeneratorConfig): Promise<void> {
-  const projectName = config.projectName;
-  const content = `# ${projectName} Database Schema
-
-## Table of Contents
-
-- [${projectName} Database Schema](#${projectName.toLowerCase()}-database-schema)
-  - [Table of Contents](#table-of-contents)
-  - [Overview](#overview)
-  - [Core Entities](#core-entities)
-    - [Entity Name](#entity-name)
-  - [Entity Relationships](#entity-relationships)
-  - [SQL Schema](#sql-schema)
-    - [Create Tables](#create-tables)
-  - [Sample Data](#sample-data)
-  - [Data Types Notes](#data-types-notes)
-  - [Migration Notes](#migration-notes)
-
----
-
-## Overview
-
-This document describes the complete database schema for ${projectName}, including all entities, relationships, and sample data.
-
----
-
-## Core Entities
-
-### Entity Name
-
-| Column      | Type     | Nullable | Description                        |
-| ----------- | -------- | -------- | ---------------------------------- |
-| id          | int      | No       | Primary key, auto-incremented ID   |
-| uuid        | string   | No       | Unique identifier                  |
-| column_name | str      | Yes/No   | Description of column              |
-| created_at  | datetime | No       | Record creation timestamp (UTC)    |
-| updated_at  | datetime | Yes      | Record last update timestamp (UTC) |
-
----
-
-## Entity Relationships
-
-\`\`\`
-table1 (1) ──── (many) table2
-table3 (many) ──── (1) table4
-\`\`\`
-
----
-
-## SQL Schema
-
-### Create Tables
-
-For PostgreSQL deployment, use the following schema:
-
-\`\`\`sql
--- Drop tables if they exist (for clean setup)
-DROP TABLE IF EXISTS child_table;
-DROP TABLE IF EXISTS parent_table;
-
--- Parent table
-CREATE TABLE parent_table (
-    id SERIAL PRIMARY KEY,
-    uuid TEXT NOT NULL UNIQUE,
-    name TEXT NOT NULL,
-    description TEXT,
-    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    updated_at TIMESTAMP
-);
-
--- Child table
-CREATE TABLE child_table (
-    id TEXT PRIMARY KEY,
-    parent_id TEXT NOT NULL,
-    content TEXT NOT NULL,
-    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    FOREIGN KEY (parent_id) REFERENCES parent_table(uuid)
-);
-
--- Add foreign key constraints if needed
-ALTER TABLE child_table ADD CONSTRAINT fk_child_parent FOREIGN KEY (parent_id) REFERENCES parent_table(uuid);
-
--- Performance indexes
-CREATE INDEX idx_parent_table_uuid ON parent_table(uuid);
-CREATE INDEX idx_child_table_parent_id ON child_table(parent_id);
-CREATE INDEX idx_child_table_created_at ON child_table(created_at);
-\`\`\`
-
----
-
-## Sample Data
-
-\`\`\`sql
--- Insert sample data for parent table
-INSERT INTO parent_table (uuid, name, description, created_at)
-VALUES ('550e8400-e29b-41d4-a716-4466554400000', 'Sample Name', 'Sample description', CURRENT_TIMESTAMP);
-
--- Insert sample data for child table
-INSERT INTO child_table (id, parent_id, content, created_at, updated_at)
-VALUES ('6ba7b810-9dad-11d1-80b4-00c04fd430c8', '550e8400-e29b-41d4-a716-4466554400000', 'Sample content', CURRENT_TIMESTAMP, CURRENT_TIMESTAMP);
-\`\`\`
-
----
-
-## Data Types Notes
-
-- **UUID**: Stored as TEXT for simplicity
-- **Arrays**: Stored as native PostgreSQL arrays (e.g., text[])
-- **JSON**: Stored as JSONB for PostgreSQL (or TEXT for SQLite)
-- **Boolean**: Stored as BOOLEAN for PostgreSQL (or INTEGER 0/1 for SQLite)
-- **Decimal**: Stored as DECIMAL for precision calculations
-- **Datetime**: Stored as TIMESTAMP with CURRENT_TIMESTAMP defaults
-
----
-
-## Migration Notes
-
-When deploying to production:
-
-1. Consider using PostgreSQL for better JSON support and performance
-2. Add proper UUID generation in application code
-3. Implement database migrations for schema changes
-4. Add database constraints and triggers as needed
-5. Run \`ALTER TABLE\` statements for schema additions
-6. Test migrations on staging environment before production
-`;
-
-  await writeFile(`${docsPath}/Schema.md`, content);
-  logSuccess("Schema.md created");
-}

package/src/utils/helpers.ts

@@ -1,198 +0,0 @@
-import fs from "fs-extra";
-import Handlebars from "handlebars";
-import pc from "picocolors";
-import { execSync } from "child_process";
-import { resolve, join } from "path";
-
-Handlebars.registerHelper("eq", function (a, b) {
-  return a === b;
-});
-
-Handlebars.registerHelper("or", function (...args) {
-  return args.slice(0, -1).some(Boolean);
-});
-
-export interface GeneratorConfig {
-  projectName: string;
-  projectType: "monorepo" | "single";
-  backend?: {
-    framework: "elysia" | "fastapi";
-    packageManager: "npm" | "yarn" | "pnpm" | "bun" | "venv" | "pip";
-    typescript: boolean;
-    eslint: boolean;
-    prettier: boolean;
-  };
-  frontend?: {
-    framework: "astro" | "svelte" | "nextjs";
-    packageManager: "npm" | "yarn" | "pnpm" | "bun";
-    typescript: boolean;
-    eslint: boolean;
-    prettier: boolean;
-    cssFramework: "none" | "tailwind" | "scss" | "css-modules";
-    uiComponents: "none" | "shadcn" | "radix";
-    testing: "none" | "vitest" | "playwright" | "both";
-  };
-  git: boolean;
-  install: boolean;
-}
-
-export async function createDirectory(dirPath: string): Promise<void> {
-  await fs.ensureDir(dirPath);
-}
-
-export async function writeFile(filePath: string, content: string): Promise<void> {
-  await fs.ensureFile(filePath);
-  await fs.writeFile(filePath, content, "utf-8");
-}
-
-export async function copyTemplate(
-  templatePath: string,
-  outputPath: string,
-  data: Record<string, unknown>
-): Promise<void> {
-  const files = await fs.readdir(templatePath, { withFileTypes: true });
-
-  const binaryExtensions = [
-    ".png",
-    ".jpg",
-    ".jpeg",
-    ".gif",
-    ".svg",
-    ".ico",
-    ".webp",
-    ".woff",
-    ".woff2",
-    ".ttf",
-    ".otf",
-    ".eot",
-    ".pdf",
-    ".zip",
-    ".tar",
-    ".gz",
-    ".7z",
-    ".bin",
-    ".exe",
-    ".dll",
-    ".so",
-    ".dylib",
-  ];
-
-  for (const file of files) {
-    const srcPath = join(templatePath, file.name);
-    const destPath = join(outputPath, file.name);
-
-    if (file.isDirectory()) {
-      await createDirectory(destPath);
-      await copyTemplate(srcPath, destPath, data);
-    } else {
-      const ext = file.name.toLowerCase();
-      const isBinary = binaryExtensions.some((binExt) => ext.endsWith(binExt));
-
-      if (isBinary) {
-        await fs.copy(srcPath, destPath);
-      } else {
-        let content = await fs.readFile(srcPath, "utf-8");
-        const template = Handlebars.compile(content);
-        const rendered = template(data);
-        await writeFile(destPath, rendered);
-      }
-    }
-  }
-}
-
-export function getPackageManagerInstallCmd(packageManager: string): string {
-  switch (packageManager) {
-    case "npm":
-      return "npm install";
-    case "yarn":
-      return "yarn";
-    case "pnpm":
-      return "pnpm install";
-    case "bun":
-      return "bun install";
-    case "venv":
-      return "source venv/bin/activate && pip install -r requirements.txt";
-    case "pip":
-      return "pip install -r requirements.txt";
-    default:
-      return "npm install";
-  }
-}
-
-export function getPackageManagerRunCmd(packageManager: string, script: string): string {
-  switch (packageManager) {
-    case "npm":
-      return `npm run ${script}`;
-    case "yarn":
-      return `yarn ${script}`;
-    case "pnpm":
-      return `pnpm run ${script}`;
-    case "bun":
-      return `bun run ${script}`;
-    case "venv":
-      return `source venv/bin/activate && python src/main.py`;
-    case "pip":
-      return `python src/main.py`;
-    default:
-      return `npm run ${script}`;
-  }
-}
-
-export function logStep(message: string): void {
-  console.log(pc.cyan(`  ${message}`));
-}
-
-export function logSuccess(message: string): void {
-  console.log(pc.green(`  ✅ ${message}`));
-}
-
-export function logInfo(message: string): void {
-  console.log(pc.blue(`  ℹ️  ${message}`));
-}
-
-export async function installDependencies(
-  projectPath: string,
-  packageManager: string
-): Promise<void> {
-  try {
-    logStep(`Installing dependencies with ${packageManager}...`);
-    execSync(getPackageManagerInstallCmd(packageManager), {
-      cwd: projectPath,
-      stdio: "inherit",
-    });
-    logSuccess("Dependencies installed");
-  } catch (error) {
-    throw new Error(`Failed to install dependencies: ${error}`);
-  }
-}
-
-export async function initializeGit(projectPath: string): Promise<void> {
-  try {
-    logStep("Initializing Git repository...");
-    execSync("git init", { cwd: projectPath, stdio: "inherit" });
-    execSync("git add .", { cwd: projectPath, stdio: "inherit" });
-    execSync('git commit -m "Initial commit from Phos"', {
-      cwd: projectPath,
-      stdio: "inherit",
-    });
-    logSuccess("Git repository initialized");
-  } catch (error) {
-    throw new Error(`Failed to initialize Git: ${error}`);
-  }
-}
-
-export function getProjectPath(projectName: string): string {
-  return resolve(process.cwd(), projectName);
-}
-
-export function capitalize(str: string): string {
-  return str.charAt(0).toUpperCase() + str.slice(1);
-}
-
-export function toKebabCase(str: string): string {
-  return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
-}
-
-export function toPascalCase(str: string): string {
-  return str.replace(/[-_](.)/g, (_, c) => c.toUpperCase()).replace(/^(.)/, (c) => c.toUpperCase());
-}

package/tsconfig.json

@@ -1,24 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "lib": ["ES2022"],
-    "moduleResolution": "bundler",
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "src/templates/**/*"]
-}