@sammons/typed-mind

Core language parser and validator for TypedMind DSL - a declarative language for building software architectures.

Installation

npm install @sammons/typed-mind

Usage

import { TypedMindParser, TypedMindValidator } from '@sammons/typed-mind';

// Parse TypedMind source code
const parser = new TypedMindParser();
const program = parser.parse(source);

// Validate the parsed program
const validator = new TypedMindValidator();
const validationResult = validator.validate(program);

if (validationResult.isValid) {
  console.log('Program is valid!');
} else {
  console.log('Validation errors:', validationResult.errors);
}

What is TypedMind?

TypedMind is a Domain Specific Language (DSL) for declaratively describing software architectures, including:

• Data Transfer Objects (DTOs) - Pure data structures for configuration, serialization, and parameters (no functions allowed)
• Service classes - Business logic with methods and dependencies
• ClassFile entities - Fusion entities that combine class and file definitions - perfect for services and controllers
• UI components - User interface elements and their relationships
• Asset management - Static assets and routing configuration
• Cross-cutting concerns - Validation, security, and other system-wide concerns

Features

• Declarative syntax - Focus on what your system does, not how it's implemented
• Strong validation - Catch architectural issues before they become problems
• Dependency tracking - Understand relationships between components
• Import system - Modular architecture with file-based organization
• Type safety - Comprehensive validation of all language constructs

Example

program "User Management System"

dto UserDto {
  id: string
  email: string
  name: string
  createdAt: date
}

service UserService {
  method createUser(email: string, name: string): UserDto
  method getUserById(id: string): UserDto
  depends on DatabaseService
}

ui UserListComponent {
  displays UserDto[]
  triggers UserService.createUser
}

Grammar

The complete TypedMind grammar is documented in grammar.md and available in EBNF format in grammar.ebnf.

Requirements

• Node.js >= 22.0.0

Related Packages

• @sammons/typed-mind-cli - Command-line interface
• @sammons/typed-mind-lsp - Language Server Protocol implementation
• @sammons/typed-mind-renderer - HTML/D3.js renderer

License

MIT