@constela/cli Command-line tools for the Constela UI framework.
Installation ``bash`
Or use with npx:
`bash`
Commands
$3 Compiles a Constela DSL file to a program.
`bash`
Arguments: - Input DSL file (JSON)
Options: - Output file path--pretty - Pretty-print JSON output--json - Output results as JSON (for tooling/AI integration)-w, --watch - Watch input file and recompile on changes-v, --verbose - Show detailed compilation progress--debug - Show internal debug information
Examples:
`bashCompile to stdout
Compile to file constela compile app.constela.json --out dist/app.compiled.json
Pretty-print output constela compile app.constela.json --pretty
JSON output for AI tools constela compile app.constela.json --json
Watch mode for development constela compile app.constela.json --watch
Verbose output with timing constela compile app.constela.json --verbose
Output: [1/3] Validating schema... OK (2ms) [2/3] Analyzing semantics... OK (1ms) [3/3] Transforming AST... OK (0ms) Compilation successful (5ms total)
Debug information constela compile app.constela.json --debug
Output: [DEBUG] Input file: app.constela.json (1234 bytes) [DEBUG] Parse time: 1ms [DEBUG] Validate pass: 15 nodes validated (2ms) ... `
$3 Validates Constela JSON files without full compilation (faster feedback).
`
bash`
Arguments:
[input]
- Input DSL file (JSON) or directory with --all
Options:
-a, --all
- Validate all JSON files in directory recursively--json
- Output results as JSONExamples:
`
bashValidate single file
Validate all JSON files in directory
JSON output for tooling `
Error Output with Suggestions:
`
Undefined state reference: 'count'
Did you mean 'counter'?
`
$3 Inspects Constela program structure without compilation.
`
bash`
Arguments:
- Input DSL file (JSON)Options:
--state
- Show only state information--actions
- Show only actions information--components
- Show only components information--view
- Show only view tree--json
- Output as JSONExamples:
`
bashShow all program structure
Show only state
JSON output `
Output:
`
Actions (2):
View Tree:
text: state.count
element
onClick=increment
$3 Starts the development server with hot reload.
bash`Options:
- Server port (default: 3000)--host - Server host (default: localhost)Examples:
`bashDefault settings
Custom port
Accessible from network `
$3 Builds the application for production.
bash`Options:
- Output directory (default: dist)Examples:
`bashDefault output to dist/
Custom output directory `Output:
$3 Starts the production server.
bash`Options:
- Server port (default: 3000)Examples:
`bashDefault settings
Custom port `The server binds to
by default for deployment compatibility.
$3 AI を使って DSL ファイルを分析し、改善提案を取得します。
`bash`Arguments:
- 分析対象の JSON ファイルOptions:
--aspect - 分析観点: accessibility, performance, security, ux (default: accessibility)--provider - AI プロバイダー: anthropic, openai (default: anthropic)--json - JSON 形式で出力環境変数:
ANTHROPIC_API_KEY - Anthropic プロバイダー使用時OPENAI_API_KEY - OpenAI プロバイダー使用時Examples:
`bashアクセシビリティの分析
セキュリティの分析（OpenAI 使用）
JSON 出力 `Output:
[HIGH] Missing aria-label on button
[MED] Low color contrast in text
Total: 2 suggestion(s)
Project Structure The CLI expects the following project structure:
Configuration Create a
file in your project root:
`typescriptexport default {
`
Debugging Guide
$3 Add
to any compile command to see internal processing:
`bash`Debug output includes:
$3 #### UNDEFINED_STATE Error
Solution: Check your state name spelling. The error shows suggested corrections.
#### SCHEMA_INVALID Error
Solution: Use correct node kind.
with tag: "button" for buttons.#### Component Not Found
`Solution: Define the component in the
section or check import paths.
$3 Use
inspect to understand your program without compilation:
`bashSee state structure
See view tree
Get JSON for tooling `
$3 For runtime debugging:
1. Open DevTools → Sources tab
in the source treeState changes are logged to console in development mode.
Exit Codes | Code | Description |
Signals The
start command handles graceful shutdown:-
SIGINT (Ctrl+C) - Graceful shutdownSIGTERM` - Graceful shutdown
License MIT