bank20baht-cli 0.2.0 → 0.3.0

package/README.md

@@ -0,0 +1,155 @@
+# bank20baht-cli
+
+Scaffolding CLI for bun workspaces and [bahtui](https://github.com/bank20baht/bahtui) form
+projects. Ships the `bahtui` binary.
+
+```sh
+bun add -g bank20baht-cli      # or: npm i -g bank20baht-cli
+bahtui --help
+
+# one-off, no install
+bunx bank20baht-cli new my-workspace
+```
+
+Requires Node ≥ 20.12 (or bun). `bun` and `git` must be on `PATH` for the post-scaffold
+steps.
+
+## Commands
+
+| Command                                  | What it does                                                      |
+| ---------------------------------------- | ----------------------------------------------------------------- |
+| `bahtui new <name>`                      | Bare bun workspace in `./<name>` — toolchain only, no apps         |
+| `bahtui create <name>`                   | Full DDD monorepo in `./<name>` — React + Elysia + Eden           |
+| `bahtui init`                            | Write `bahtui.json` into an existing repo (enables the generators) |
+| `bahtui g model <domain>`                | `libs/domain/<domain>/model` package                              |
+| `bahtui g form <domain>/<name> --fields` | Engine-validated `FormDefinition` JSON inside that model package  |
+
+### `bahtui new <name>`
+
+Angular-style project bootstrap. Generates a bun workspace with the shared toolchain and
+nothing else — you add `apps/*` and `packages/*` yourself.
+
+```sh
+bahtui new acme
+cd acme
+bun run check      # lint + format:check + knip + typecheck — green on the empty repo
+```
+
+What you get:
+
+```
+package.json         workspaces apps/* + packages/*, lint-staged, check script
+tsconfig.base.json   strict, moduleResolution bundler, verbatimModuleSyntax
+tsconfig.json        typechecks scripts/ (extend the base from each workspace)
+eslint.config.ts     ESLint 10 + typescript-eslint + eslint-config-prettier
+.prettierrc          no semicolons, single quotes, printWidth 100
+knip.json            dead-code / unused-dependency checks
+commitlint.config.js Conventional Commits
+.husky/              pre-commit → lint-staged · commit-msg → commitlint · pre-push → bun run check
+scripts/dev.ts       runs every apps/*/ "dev" script in parallel with prefixed output
+scripts/each.ts      `bun run scripts/each.ts <script>` in every workspace that defines it
+.mcp.json, CLAUDE.md zvec_grep code-search MCP wiring for Claude Code
+apps/, packages/     empty (.gitkeep)
+```
+
+By default the CLI runs `git init`, `bun install`, then makes the first commit — so the
+husky hooks prove themselves before you touch anything. Flags:
+
+```
+--skip-install   (alias --no-install)  skip bun install and the initial commit
+--skip-git       (alias --no-git)      skip git init and the initial commit
+--dry-run                              print the file list, write nothing
+--force                                write into a non-empty directory
+```
+
+Add a workspace by creating `apps/<name>/package.json` with `dev` / `build` / `typecheck`
+scripts; `bun run dev`, `bun run build` and `bun run typecheck` pick it up automatically.
+Add a matching entry to `knip.json` so dead-code checks cover it.
+
+### `bahtui create <name>`
+
+Same flags as `new`, but scaffolds a complete stack:
+
+```
+apps/web                 React 19 + Vite
+apps/api                 Elysia — exports `type App`, the Eden type anchor
+libs/shared/eden         treaty<App> — the one typed HTTP client
+bahtui.json              generator config (see below)
+```
+
+```sh
+bahtui create shop
+cd shop
+bun run dev              # web on :5173, api on :3001
+```
+
+### `bahtui init`
+
+Writes `bahtui.json` into the current directory so `bahtui g …` knows where things live.
+
+```sh
+bahtui init                          # frontend react, backend elysia
+bahtui init --frontend none          # no React feature slices
+bahtui init --backend none           # no Elysia plugins
+```
+
+```json
+{
+  "apps": { "web": "apps/web", "api": "apps/api" },
+  "libsDir": "libs",
+  "frontend": "react",
+  "backend": "elysia",
+  "edenClient": "libs/shared/eden"
+}
+```
+
+### `bahtui g model <domain>`
+
+Creates `<libsDir>/domain/<domain>/model` — a framework-free package for entities and form
+JSON. `<domain>` is kebab-case.
+
+### `bahtui g form <domain>/<name> --fields "<dsl>"`
+
+Builds a `FormDefinition`, validates it with
+[`bank20baht-validator`](https://www.npmjs.com/package/bank20baht-validator) (the same
+engine the browser components run), and writes
+`<libsDir>/domain/<domain>/model/src/<name>.form.json`.
+
+```sh
+bahtui g form ticket/create \
+  --fields "title:text:required,priority:dropdown:options=low|medium|high,qty:number:min=1"
+```
+
+Field DSL — comma-separated `key:type[:modifier…]`:
+
+| Part       | Values                                                                                                         |
+| ---------- | -------------------------------------------------------------------------------------------------------------- |
+| `key`      | `[a-z][a-z0-9_]*`; the label is derived (`due_date` → "Due Date")                                              |
+| `type`     | `text` `textarea` `number` `email` `password` `dropdown` `multiselect` `checkbox` `radio` `toggle` `date` `file` |
+| modifiers  | `required` · `options=a\|b\|c` · `min=N` · `max=N` · `flag=NAME`                                                 |
+
+Invalid DSL (unknown type, empty options, non-numeric `min`) fails before anything is
+written.
+
+## Global flags
+
+```
+--dry-run      print what would be generated, write nothing
+--force        overwrite existing files / write into non-empty dirs
+-h, --help
+-v, --version
+```
+
+## How it works
+
+Every command produces a **blueprint** — plain data listing files and post-commands — then
+adapters write it to disk and run the commands. `--dry-run` prints the blueprint. Template
+files ending in `.hbs` get `{{name}}` substitution; everything else is copied verbatim, and a
+leading `_` in a template filename becomes `.` (so `.gitignore` survives `npm pack`).
+
+Generated file paths are confined to the target directory; a hostile `bahtui.json` cannot
+write outside the project root.
+
+## License
+
+MIT

package/dist/domain/form-dsl.js

@@ -91,9 +91,9 @@ export function parseFieldsDsl(dsl) {
 /** DSL -> FormDefinition, engine-validated. Throws FormDslError on any problem. */
 export function buildFormDefinition(domain, name, dsl) {
     const form = {
-        formId: `${domain}-${name}`,
-        formName: titleCase(name.replace(/-/g, '_')).replace(/ /g, '_'),
-        field_data: parseFieldsDsl(dsl),
+        form_id: `${domain}-${name}`,
+        form_name: titleCase(name.replace(/-/g, '_')).replace(/ /g, '_'),
+        fields: parseFieldsDsl(dsl),
     };
     try {
         return parseSchema(JSON.stringify(form));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bank20baht-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Scaffold bun workspaces (bahtui new) and DDD monorepos (React + Elysia + Eden, bahtui create) plus bahtui generators.",
   "license": "MIT",
@@ -43,7 +43,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "bank20baht-validator": "^0.1.0"
+    "bank20baht-validator": "^0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22",