xpine 0.0.59 → 0.0.60

package/.claude/worktrees/jolly-hofstadter-2764be/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "xpine",
+  "version": "0.0.59",
+  "main": "dist/index.js",
+  "dependencies": {
+    "@aws-sdk/client-secrets-manager": "^3.758.0",
+    "@tailwindcss/postcss": "^4.1.12",
+    "builtin-modules": "^4.0.0",
+    "chokidar": "^4.0.3",
+    "dotenv": "^16.4.7",
+    "esbuild": "^0.25.0",
+    "express": "^4.21.2",
+    "express-ws": "^5.0.2",
+    "fs-extra": "^11.3.0",
+    "glob": "^11.0.1",
+    "jsonwebtoken": "^9.0.2",
+    "micromatch": "^4.0.8",
+    "minify-xml": "^4.5.2",
+    "postcss": "^8.5.3",
+    "request-ip": "^3.3.0",
+    "shelljs": "^0.9.2",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.3",
+    "yargs": "^17.7.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/dan-caldwell/xpine.git"
+  },
+  "scripts": {
+    "build": "tsx ./src/scripts/run-build-module.ts && npm run build:types",
+    "build:types": "sh ./src/scripts/build-types.sh",
+    "xpine-dev-server": "tsx ./src/scripts/xpine-dev-server.ts",
+    "test": "cd ./tests && npm run test",
+    "test:dev": "cd ./tests && npm run dev",
+    "test:start": "cd ./tests && npm run build && npm start",
+    "test:build": "cd ./tests && npm run build",
+    "test:build:dev": "cd ./tests && npm run build:dev",
+    "lint": "npx eslint",
+    "fix": "npx eslint --fix",
+    "release:patch": "npm run build && npm version patch && npm publish"
+  },
+  "bin": {
+    "xpine-build": "dist/src/scripts/xpine-build.js",
+    "xpine-dev": "dist/src/scripts/xpine-dev.js"
+  },
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@tailwindcss/oxide-darwin-arm64": "^4.1.3",
+    "@types/express": "^5.0.0",
+    "@types/micromatch": "^4.0.9",
+    "@types/node": "^22.13.5",
+    "@types/request-ip": "^0.0.41",
+    "@types/shelljs": "^0.8.15",
+    "@types/yargs": "^17.0.33",
+    "axios": "^1.8.4",
+    "lightningcss-darwin-arm64": "^1.29.3",
+    "typescript-eslint": "^8.29.0"
+  }
+}

package/.claude/worktrees/jolly-hofstadter-2764be/tsconfig.json

@@ -0,0 +1,43 @@
+{
+  "compilerOptions": {
+    "jsx": "preserve",
+    "jsxFragmentFactory": "html.fragment",
+    "jsxFactory": "html.createElement",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": false,
+    "forceConsistentCasingInFileNames": false,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "target": "esnext",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsxImportSource": "xpine",
+    "incremental": true,
+    "allowImportingTsExtensions": true,
+    // Generate d.ts files
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "outDir": "dist",
+    "declarationMap": true,
+    "types": []
+  },
+  "include": [
+    "src/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "./node_modules",
+    "./node_modules/*",
+    "./node_modules/@types/node/index.d.ts",
+    "dist",
+    "**/*.js"
+  ],
+}

package/.claude/worktrees/jolly-hofstadter-2764be/types.ts

@@ -0,0 +1,55 @@
+import { NextFunction, Request, Response } from 'express';
+import ts from 'typescript';
+
+export type XPineConfig = {
+  [key: string]: any;
+}
+
+export type TokenUser = {
+  email?: string;
+  username?: string;
+}
+
+export type ServerRequest = Request & {
+  user?: TokenUser;
+  clientIp?: string;
+}
+
+export type WrapperProps = {
+  req: ServerRequest;
+  children: any;
+  config: ConfigFile;
+  data?: any;
+  routePath?: string;
+}
+
+export type ConfigFile = {
+  staticPaths?: boolean | (() => Promise<{ [key: string]: string }[]> | { [key: string]: string }[]);
+  wrapper?: (props: WrapperProps) => Promise<any>;
+  data?: (req: ServerRequest) => Promise<any>;
+  routeMiddleware?: (req: ServerRequest, res: Response, next: NextFunction) => void;
+  // For multi-segment dynamic routes ([...slug]): validate a slug that was not
+  // generated at build time so it can be resolved safely at request time.
+  // Return false (the default for unknown slugs) to fall through to the 404 handler.
+  isValid?: (slug: string, req: ServerRequest) => boolean | Promise<boolean>;
+}
+
+export type PageProps = {
+  req: ServerRequest;
+  res: Response;
+  data: any;
+  routePath: string;
+}
+
+export type FileItem = {
+  file: string;
+  size: number;
+}
+
+export type ComponentData = {
+  path: string;
+  contents: string;
+  clientContent: string;
+  configFiles: string[];
+  source: ts.SourceFile;
+}

package/.claude/worktrees/jolly-hofstadter-2764be/xpine.config.mjs

@@ -0,0 +1 @@
+export default {};

package/README.md

@@ -2,6 +2,17 @@
 
 Combines JSX with Alpine.js for a simpler, easier development experience. Includes a static site generator.
 
+### Quick start
+
+Scaffold a new app with pages, demo content, and an API endpoint already set up:
+
+```
+npx create-xpine-app my-app
+cd my-app
+npm install
+npm run dev
+```
+
 ### Install
 
 `npm install xpine`

package/create-xpine-app/README.md

@@ -0,0 +1,20 @@
+# create-xpine-app
+
+Scaffold a new [XPine](https://github.com/dan-caldwell/xpine) app (Alpine.js + JSX + Tailwind) with one command:
+
+```
+npx create-xpine-app my-app
+cd my-app
+npm install
+npm run dev
+```
+
+Run `npx create-xpine-app .` to scaffold into the current directory.
+
+The generated app includes:
+
+- File-based routing with a shared page wrapper
+- Server-side data fetching from the [JSONPlaceholder API](https://jsonplaceholder.typicode.com) (posts and users pages)
+- A dynamic route (`/posts/[id]`) with static generation for known paths
+- An Express API endpoint (`/api/posts`)
+- Alpine.js interactivity examples and Tailwind CSS styling

package/create-xpine-app/index.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import readline from 'node:readline/promises';
+
+const templateDir = path.join(path.dirname(fileURLToPath(import.meta.url)), 'template');
+
+const helpMessage = `
+Usage: npx create-xpine-app [project-name]
+
+Scaffolds a new XPine app in a directory named [project-name].
+Pass "." to scaffold into the current directory.
+
+Options:
+  -h, --help  Show this message
+`;
+
+function exitWithError(message) {
+  console.error(`\x1b[31m${message}\x1b[0m`);
+  process.exit(1);
+}
+
+function isValidProjectName(name) {
+  return /^[a-z0-9~-][a-z0-9._~-]*$/.test(name);
+}
+
+function isEmptyDir(dir) {
+  return fs.readdirSync(dir).filter((file) => file !== '.git').length === 0;
+}
+
+async function getProjectName() {
+  const arg = process.argv[2];
+  if (arg) return arg;
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const answer = await rl.question('Project name: (my-xpine-app) ');
+  rl.close();
+  return answer.trim() || 'my-xpine-app';
+}
+
+if (['-h', '--help'].includes(process.argv[2])) {
+  console.log(helpMessage);
+  process.exit(0);
+}
+
+const projectName = await getProjectName();
+const useCurrentDir = projectName === '.';
+const targetDir = useCurrentDir ? process.cwd() : path.resolve(process.cwd(), projectName);
+const packageName = useCurrentDir ? path.basename(targetDir) : projectName;
+
+if (!isValidProjectName(packageName)) {
+  exitWithError(`Invalid project name: "${packageName}". Use lowercase letters, numbers, dashes, dots, and underscores.`);
+}
+
+if (fs.existsSync(targetDir) && !isEmptyDir(targetDir)) {
+  exitWithError(`The directory ${useCurrentDir ? 'you are in' : `"${projectName}"`} already exists and is not empty.`);
+}
+
+console.log(`\nScaffolding XPine app in ${targetDir}...`);
+
+fs.cpSync(templateDir, targetDir, { recursive: true });
+
+// npm strips .gitignore files from published packages, so the template ships
+// it as "gitignore" and it gets renamed here
+fs.renameSync(path.join(targetDir, 'gitignore'), path.join(targetDir, '.gitignore'));
+
+const packageJsonPath = path.join(targetDir, 'package.json');
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+packageJson.name = packageName;
+fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+
+console.log(`
+Done! Next steps:
+${useCurrentDir ? '' : `
+  cd ${projectName}`}
+  npm install
+  npm run dev
+
+Your app will be running at http://localhost:3000
+`);

package/create-xpine-app/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "create-xpine-app",
+  "version": "0.0.1",
+  "description": "Scaffold a new XPine app with one command",
+  "type": "module",
+  "bin": {
+    "create-xpine-app": "index.js"
+  },
+  "files": [
+    "index.js",
+    "template"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/dan-caldwell/xpine.git",
+    "directory": "create-xpine-app"
+  },
+  "keywords": [
+    "xpine",
+    "create-xpine-app",
+    "alpinejs",
+    "jsx",
+    "tailwind",
+    "scaffold"
+  ],
+  "license": "ISC"
+}

package/create-xpine-app/template/README.md

@@ -0,0 +1,50 @@
+# My XPine App
+
+A starter app built with [XPine](https://github.com/dan-caldwell/xpine) — Alpine.js + JSX + Tailwind. Demo content comes from the [JSONPlaceholder API](https://jsonplaceholder.typicode.com).
+
+## Getting started
+
+```
+npm install
+npm run dev
+```
+
+Then open http://localhost:3000
+
+## Scripts
+
+| Command | Description |
+| --- | --- |
+| `npm run dev` | Start the dev server with live reload |
+| `npm run build` | Build the app for production (includes static page generation) |
+| `npm start` | Run the production build |
+| `npm run lint` | Lint the code |
+
+## Project structure
+
+```
+src/
+  components/       Shared JSX components (Base layout, Navbar)
+  pages/            File-based routes
+    +config.tsx     Shared page wrapper (applies to all pages in this folder and below)
+    index.tsx       / — home page with Alpine.js examples
+    posts/
+      index.tsx     /posts — post list fetched server-side
+      [id].tsx      /posts/:id — dynamic route with static generation for known ids
+    users/
+      index.tsx     /users
+    api/
+      posts.GET.ts  /api/posts — Express API endpoint
+    404.tsx         Not-found page
+  public/
+    scripts/        Client-side entry (starts Alpine.js)
+    styles/         Global CSS (Tailwind)
+  server/           Express server setup
+  util/             Shared server-side helpers
+```
+
+## Learn more
+
+- Page routing, static generation, API endpoints, and more: [XPine README](https://github.com/dan-caldwell/xpine#readme)
+- Alpine.js docs: https://alpinejs.dev
+- Tailwind CSS docs: https://tailwindcss.com

package/create-xpine-app/template/eslint.config.mjs

@@ -0,0 +1,27 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  tseslint.configs.recommended,
+  {
+    rules: {
+      'eol-last': 2,
+      'quotes': ['error', 'single'],
+      'comma-dangle': ['error', {
+        'objects': 'always',
+        'arrays': 'never',
+        'imports': 'never',
+        'exports': 'never',
+        'functions': 'never',
+      }],
+      'semi': 'error',
+      '@typescript-eslint/ban-ts-comment': 'off',
+      '@typescript-eslint/no-require-imports': 'off',
+    },
+    files: ['src/**/*.{js,mjs,ts,tsx,jsx}'],
+  },
+  {
+    ignores: ['dist/'],
+  }
+);

package/create-xpine-app/template/gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+.env*
+*.tsbuildinfo
+.DS_Store

package/create-xpine-app/template/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "xpine-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "PORT=3000 LOCALHOST=1 xpine-dev",
+    "build": "xpine-build --removePreviousBuild",
+    "start": "PORT=3000 node ./dist/server/run/prod.js",
+    "lint": "npx eslint",
+    "fix": "npx eslint --fix"
+  },
+  "dependencies": {
+    "alpinejs": "^3.14.8",
+    "cookie-parser": "^1.4.7",
+    "express": "^4.21.2",
+    "morgan": "^1.10.0",
+    "tailwindcss": "^4.1.12",
+    "xpine": "^0.0.59"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@types/alpinejs": "^3.13.11",
+    "@types/cookie-parser": "^1.4.8",
+    "@types/express": "^5.0.0",
+    "@types/morgan": "^1.9.9",
+    "@types/node": "^22.13.5",
+    "eslint": "^9.24.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.29.0"
+  }
+}

package/create-xpine-app/template/tsconfig.json

@@ -0,0 +1,36 @@
+{
+  "compilerOptions": {
+    "jsx": "preserve",
+    "jsxFragmentFactory": "html.fragment",
+    "jsxFactory": "html.createElement",
+    "jsxImportSource": "xpine",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "target": "esnext",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": false,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "forceConsistentCasingInFileNames": false,
+    "incremental": true,
+    "allowImportingTsExtensions": true
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "eslint.config.mjs"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "**/*.js"
+  ]
+}

package/create-xpine-app/template/xpine.config.mjs

@@ -0,0 +1 @@
+export default {};

package/eslint.config.mjs

@@ -22,6 +22,6 @@ export default tseslint.config(
     files: ["src/**/*.{js,mjs,ts,tsx,jsx}"],
   },
   {
-    ignores: ["dist/", "cdk.out/", "tests/dist/", "tests/playwright-report/"]
+    ignores: ["dist/", "cdk.out/", "tests/dist/", "tests/playwright-report/", "create-xpine-app/"]
   }
 )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xpine",
-  "version": "0.0.59",
+  "version": "0.0.60",
   "main": "dist/index.js",
   "dependencies": {
     "@aws-sdk/client-secrets-manager": "^3.758.0",