@hexidecibel/companion 0.0.1

package/dist/scaffold/templates/index.d.ts

@@ -0,0 +1,5 @@
+import { StackTemplate } from '../types';
+export declare const templates: StackTemplate[];
+export declare function getTemplate(id: string): StackTemplate | undefined;
+export declare function getTemplatesByType(type: StackTemplate['type']): StackTemplate[];
+//# sourceMappingURL=index.d.ts.map

package/dist/scaffold/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scaffold/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,eAAO,MAAM,SAAS,EAAE,aAAa,EAKpC,CAAC;AAEF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,EAAE,CAE/E"}

package/dist/scaffold/templates/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templates = void 0;
+exports.getTemplate = getTemplate;
+exports.getTemplatesByType = getTemplatesByType;
+const react_typescript_1 = require("./react-typescript");
+const react_mui_website_1 = require("./react-mui-website");
+const node_express_1 = require("./node-express");
+const python_fastapi_1 = require("./python-fastapi");
+exports.templates = [
+    react_typescript_1.reactTypescriptTemplate,
+    react_mui_website_1.reactMuiWebsiteTemplate,
+    node_express_1.nodeExpressTemplate,
+    python_fastapi_1.pythonFastapiTemplate,
+];
+function getTemplate(id) {
+    return exports.templates.find(t => t.id === id);
+}
+function getTemplatesByType(type) {
+    return exports.templates.filter(t => t.type === type);
+}
+//# sourceMappingURL=index.js.map

package/dist/scaffold/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scaffold/templates/index.ts"],"names":[],"mappings":";;;AAaA,kCAEC;AAED,gDAEC;AAlBD,yDAA6D;AAC7D,2DAA8D;AAC9D,iDAAqD;AACrD,qDAAyD;AAE5C,QAAA,SAAS,GAAoB;IACxC,0CAAuB;IACvB,2CAAuB;IACvB,kCAAmB;IACnB,sCAAqB;CACtB,CAAC;AAEF,SAAgB,WAAW,CAAC,EAAU;IACpC,OAAO,iBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,kBAAkB,CAAC,IAA2B;IAC5D,OAAO,iBAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/scaffold/templates/node-express.d.ts

@@ -0,0 +1,3 @@
+import { StackTemplate } from '../types';
+export declare const nodeExpressTemplate: StackTemplate;
+//# sourceMappingURL=node-express.d.ts.map

package/dist/scaffold/templates/node-express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-express.d.ts","sourceRoot":"","sources":["../../../src/scaffold/templates/node-express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,mBAAmB,EAAE,aAqNjC,CAAC"}

package/dist/scaffold/templates/node-express.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeExpressTemplate = void 0;
+exports.nodeExpressTemplate = {
+    id: 'node-express',
+    name: 'Node.js + Express + TypeScript',
+    description: 'REST API with Express, TypeScript, and best practices',
+    type: 'backend',
+    icon: '🟢',
+    tags: ['node', 'express', 'typescript', 'backend', 'api'],
+    files: [
+        {
+            path: 'package.json',
+            template: `{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "description": "{{projectDescription}}",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "lint": "eslint src/"
+  },
+  "dependencies": {
+    "express": "^4.21.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.7.5",
+    "tsx": "^4.19.1",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4",
+    "eslint": "^9.13.0",
+    "@typescript-eslint/eslint-plugin": "^8.11.0",
+    "@typescript-eslint/parser": "^8.11.0"
+  }
+}`,
+        },
+        {
+            path: 'tsconfig.json',
+            template: `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}`,
+        },
+        {
+            path: 'src/index.ts',
+            template: `import express from 'express';
+import cors from 'cors';
+import { config } from 'dotenv';
+import { router } from './routes/index.js';
+
+config();
+
+const app = express();
+const port = process.env.PORT || 3000;
+
+app.use(cors());
+app.use(express.json());
+
+app.use('/api', router);
+
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok', timestamp: new Date().toISOString() });
+});
+
+app.listen(port, () => {
+  console.log(\`Server running on http://localhost:\${port}\`);
+});`,
+        },
+        {
+            path: 'src/routes/index.ts',
+            template: `import { Router } from 'express';
+
+export const router = Router();
+
+router.get('/', (req, res) => {
+  res.json({ message: 'Welcome to {{projectName}} API' });
+});
+
+// Add your routes here
+// router.use('/users', usersRouter);`,
+        },
+        {
+            path: 'src/types/index.ts',
+            template: `// Add your types here
+
+export interface ApiResponse<T> {
+  success: boolean;
+  data?: T;
+  error?: string;
+}`,
+        },
+        {
+            path: '.env',
+            template: `PORT=3000
+NODE_ENV=development`,
+        },
+        {
+            path: '.env.example',
+            template: `PORT=3000
+NODE_ENV=development`,
+        },
+        {
+            path: '.gitignore',
+            template: `# Dependencies
+node_modules
+
+# Build
+dist
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+
+# Editor
+.vscode/*
+!.vscode/extensions.json
+.idea
+
+# OS
+.DS_Store`,
+        },
+        {
+            path: 'CLAUDE.md',
+            template: `# {{projectName}}
+
+{{projectDescription}}
+
+## Tech Stack
+- Node.js with TypeScript
+- Express.js for HTTP server
+- tsx for development (hot reload)
+
+## Project Structure
+\`\`\`
+src/
+├── index.ts       # Entry point, server setup
+├── routes/        # API route handlers
+│   └── index.ts   # Route definitions
+└── types/         # TypeScript types
+    └── index.ts
+\`\`\`
+
+## Commands
+- \`npm run dev\` - Start dev server with hot reload
+- \`npm run build\` - Build TypeScript to dist/
+- \`npm start\` - Run production build
+- \`npm test\` - Run tests
+- \`npm run lint\` - Run linter
+
+## API Endpoints
+- \`GET /health\` - Health check
+- \`GET /api\` - API root
+
+## Development Notes
+- Add routes in \`src/routes/\`
+- Add middleware in \`src/middleware/\`
+- Add services/business logic in \`src/services/\`
+- Environment variables in \`.env\``,
+        },
+        {
+            path: 'README.md',
+            template: `# {{projectName}}
+
+{{projectDescription}}
+
+## Getting Started
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+Server will start at http://localhost:3000
+
+## Scripts
+
+- \`npm run dev\` - Start development server
+- \`npm run build\` - Build for production
+- \`npm start\` - Run production server
+- \`npm test\` - Run tests`,
+        },
+    ],
+    postCreate: [
+        {
+            command: 'npm install',
+            description: 'Installing dependencies',
+        },
+    ],
+    recommendedSkills: ['test', 'build', 'dev'],
+};
+//# sourceMappingURL=node-express.js.map

package/dist/scaffold/templates/node-express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-express.js","sourceRoot":"","sources":["../../../src/scaffold/templates/node-express.ts"],"names":[],"mappings":";;;AAEa,QAAA,mBAAmB,GAAkB;IAChD,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,uDAAuD;IACpE,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC;IACzD,KAAK,EAAE;QACL;YACE,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4Bd;SACG;QACD;YACE,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;EAkBd;SACG;QACD;YACE,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;IAqBZ;SACC;QACD;YACE,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE;;;;;;;;;sCASsB;SACjC;QACD;YACE,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE;;;;;;EAMd;SACG;QACD;YACE,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE;qBACK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE;qBACK;SAChB;QACD;YACE,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;UAqBN;SACL;QACD;YACE,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAkCoB;SAC/B;QACD;YACE,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;2BAkBW;SACtB;KACF;IACD,UAAU,EAAE;QACV;YACE,OAAO,EAAE,aAAa;YACtB,WAAW,EAAE,yBAAyB;SACvC;KACF;IACD,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;CAC5C,CAAC"}

package/dist/scaffold/templates/python-fastapi.d.ts

@@ -0,0 +1,3 @@
+import { StackTemplate } from '../types';
+export declare const pythonFastapiTemplate: StackTemplate;
+//# sourceMappingURL=python-fastapi.d.ts.map

package/dist/scaffold/templates/python-fastapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-fastapi.d.ts","sourceRoot":"","sources":["../../../src/scaffold/templates/python-fastapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,qBAAqB,EAAE,aAySnC,CAAC"}

package/dist/scaffold/templates/python-fastapi.js

@@ -0,0 +1,302 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pythonFastapiTemplate = void 0;
+exports.pythonFastapiTemplate = {
+    id: 'python-fastapi',
+    name: 'Python + FastAPI',
+    description: 'Modern Python API with FastAPI, async support, and auto-generated docs',
+    type: 'backend',
+    icon: '🐍',
+    tags: ['python', 'fastapi', 'backend', 'api', 'async'],
+    files: [
+        {
+            path: 'pyproject.toml',
+            template: `[project]
+name = "{{projectName}}"
+version = "0.1.0"
+description = "{{projectDescription}}"
+requires-python = ">=3.11"
+dependencies = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "pydantic>=2.9.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3.0",
+    "pytest-asyncio>=0.24.0",
+    "httpx>=0.27.0",
+    "ruff>=0.7.0",
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"`,
+        },
+        {
+            path: 'app/__init__.py',
+            template: `"""{{projectName}} - {{projectDescription}}"""
+
+__version__ = "0.1.0"`,
+        },
+        {
+            path: 'app/main.py',
+            template: `from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from app.routers import api
+
+app = FastAPI(
+    title="{{projectName}}",
+    description="{{projectDescription}}",
+    version="0.1.0",
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+app.include_router(api.router, prefix="/api")
+
+
+@app.get("/health")
+async def health_check():
+    """Health check endpoint."""
+    return {"status": "ok"}
+
+
+@app.get("/")
+async def root():
+    """Root endpoint."""
+    return {"message": "Welcome to {{projectName}}"}`,
+        },
+        {
+            path: 'app/routers/__init__.py',
+            template: `"""API routers."""`,
+        },
+        {
+            path: 'app/routers/api.py',
+            template: `from fastapi import APIRouter
+
+router = APIRouter()
+
+
+@router.get("/")
+async def api_root():
+    """API root endpoint."""
+    return {"message": "API v1"}
+
+
+# Add your routes here
+# @router.get("/items")
+# async def get_items():
+#     return {"items": []}`,
+        },
+        {
+            path: 'app/models/__init__.py',
+            template: `"""Pydantic models."""`,
+        },
+        {
+            path: 'app/models/schemas.py',
+            template: `from pydantic import BaseModel
+
+
+class HealthResponse(BaseModel):
+    """Health check response."""
+    status: str
+
+
+class MessageResponse(BaseModel):
+    """Generic message response."""
+    message: str
+
+
+# Add your models here
+# class Item(BaseModel):
+#     id: int
+#     name: str
+#     description: str | None = None`,
+        },
+        {
+            path: 'app/services/__init__.py',
+            template: `"""Business logic services."""`,
+        },
+        {
+            path: 'tests/__init__.py',
+            template: `"""Tests for {{projectName}}."""`,
+        },
+        {
+            path: 'tests/test_main.py',
+            template: `import pytest
+from httpx import ASGITransport, AsyncClient
+
+from app.main import app
+
+
+@pytest.fixture
+async def client():
+    async with AsyncClient(
+        transport=ASGITransport(app=app),
+        base_url="http://test"
+    ) as ac:
+        yield ac
+
+
+@pytest.mark.asyncio
+async def test_health(client: AsyncClient):
+    response = await client.get("/health")
+    assert response.status_code == 200
+    assert response.json() == {"status": "ok"}
+
+
+@pytest.mark.asyncio
+async def test_root(client: AsyncClient):
+    response = await client.get("/")
+    assert response.status_code == 200
+    assert "message" in response.json()`,
+        },
+        {
+            path: '.env',
+            template: `# Environment variables
+DEBUG=true
+HOST=0.0.0.0
+PORT=8000`,
+        },
+        {
+            path: '.env.example',
+            template: `# Environment variables
+DEBUG=true
+HOST=0.0.0.0
+PORT=8000`,
+        },
+        {
+            path: '.gitignore',
+            template: `# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Virtual environments
+venv/
+.venv/
+ENV/
+
+# Environment
+.env
+.env.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# OS
+.DS_Store`,
+        },
+        {
+            path: 'CLAUDE.md',
+            template: `# {{projectName}}
+
+{{projectDescription}}
+
+## Tech Stack
+- Python 3.11+
+- FastAPI for async web framework
+- Pydantic for data validation
+- Uvicorn for ASGI server
+
+## Project Structure
+\`\`\`
+app/
+├── __init__.py
+├── main.py          # FastAPI app setup
+├── routers/         # API route handlers
+│   └── api.py
+├── models/          # Pydantic schemas
+│   └── schemas.py
+└── services/        # Business logic
+tests/
+└── test_main.py     # API tests
+\`\`\`
+
+## Commands
+- \`uv run uvicorn app.main:app --reload\` - Start dev server
+- \`uv run pytest\` - Run tests
+- \`uv run ruff check .\` - Lint code
+- \`uv run ruff format .\` - Format code
+
+## API Docs
+- Swagger UI: http://localhost:8000/docs
+- ReDoc: http://localhost:8000/redoc
+
+## Development Notes
+- Add routes in \`app/routers/\`
+- Add Pydantic models in \`app/models/\`
+- Add business logic in \`app/services/\`
+- Environment variables in \`.env\``,
+        },
+        {
+            path: 'README.md',
+            template: `# {{projectName}}
+
+{{projectDescription}}
+
+## Getting Started
+
+\`\`\`bash
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # or venv\\Scripts\\activate on Windows
+
+# Install dependencies
+pip install -e ".[dev]"
+
+# Run server
+uvicorn app.main:app --reload
+\`\`\`
+
+Server will start at http://localhost:8000
+
+API docs available at http://localhost:8000/docs
+
+## Scripts
+
+- \`uvicorn app.main:app --reload\` - Development server
+- \`pytest\` - Run tests
+- \`ruff check .\` - Lint code
+- \`ruff format .\` - Format code`,
+        },
+    ],
+    postCreate: [
+        {
+            command: 'python -m venv venv && . venv/bin/activate && pip install -e ".[dev]"',
+            description: 'Creating virtual environment and installing dependencies',
+        },
+    ],
+    recommendedSkills: ['test', 'dev'],
+};
+//# sourceMappingURL=python-fastapi.js.map

package/dist/scaffold/templates/python-fastapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-fastapi.js","sourceRoot":"","sources":["../../../src/scaffold/templates/python-fastapi.ts"],"names":[],"mappings":";;;AAEa,QAAA,qBAAqB,GAAkB;IAClD,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,wEAAwE;IACrF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC;IACtD,KAAK,EAAE;QACL;YACE,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA4BM;SACjB;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE;;sBAEM;SACjB;QACD;YACE,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDA+BqC;SAChD;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,QAAQ,EAAE,oBAAoB;SAC/B;QACD;YACE,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE;;;;;;;;;;;;;;2BAcW;SACtB;QACD;YACE,IAAI,EAAE,wBAAwB;YAC9B,QAAQ,EAAE,wBAAwB;SACnC;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,QAAQ,EAAE;;;;;;;;;;;;;;;;;qCAiBqB;SAChC;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,QAAQ,EAAE,gCAAgC;SAC3C;QACD;YACE,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,kCAAkC;SAC7C;QACD;YACE,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;wCA0BwB;SACnC;QACD;YACE,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE;;;UAGN;SACL;QACD;YACE,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE;;;UAGN;SACL;QACD;YACE,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAgCN;SACL;QACD;YACE,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAsCoB;SAC/B;QACD;YACE,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA2BkB;SAC7B;KACF;IACD,UAAU,EAAE;QACV;YACE,OAAO,EAAE,uEAAuE;YAChF,WAAW,EAAE,0DAA0D;SACxE;KACF;IACD,iBAAiB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;CACnC,CAAC"}

package/dist/scaffold/templates/react-mui-website.d.ts

@@ -0,0 +1,3 @@
+import { StackTemplate } from '../types';
+export declare const reactMuiWebsiteTemplate: StackTemplate;
+//# sourceMappingURL=react-mui-website.d.ts.map

package/dist/scaffold/templates/react-mui-website.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-mui-website.d.ts","sourceRoot":"","sources":["../../../src/scaffold/templates/react-mui-website.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,uBAAuB,EAAE,aAgZrC,CAAC"}