@rsconcept/domain

Shared TypeScript domain layer for the Concept Portal stack.

This package implements the formal language RSLang (language of structural species explication), the schema model RSForm, the evaluation engine RSEngine, the operation-of-schemas model OSS, and supporting helpers (graphs, parsing utilities, concept-text grammemes). It is consumed both by the Portal frontend and by @rsconcept/rstool.

Install

npm install @rsconcept/domain

Subpath exports

import { RSLangAnalyzer, RSErrorCode } from '@rsconcept/domain/rslang';
import { CstType, type RSForm } from '@rsconcept/domain/library/rsform';
import { Graph } from '@rsconcept/domain/graph';
import { buildTree, type AstNode } from '@rsconcept/domain/parsing';

The root entry (@rsconcept/domain) re-exports the most common names. Subpath imports are recommended for tree-shaking and to make dependency graphs explicit.

Contents

| Subpath | Surface | | --------- | ---------------------------------------------------------------------------------------------- | | rslang | Lezer parser, semantic analyzer, evaluator, calculator, type system, value system, error codes | | library | RSForm, RSModel, RSEngine, OSS, library item metadata, structure planner | | graph | Generic directed-graph utilities used for dependency tracking | | parsing | Lezer AST helpers shared by all parsers | | cctext | Russian/multilingual grammemes for concept-text references | | shared | Branded<T> types, FNV-1a hash, stub id generation |

Build

npm run generate    # regenerates Lezer parser from rslang.grammar
npm run build       # produces ./dist via tsdown
npm test            # vitest run
npm run typecheck   # tsc --noEmit
npm run lint        # ESLint (TypeScript; same core rules as frontend, no React)
npm run lintFix     # ESLint --fix
npm run format:check

After editing src/rslang/parser/rslang.grammar, always run npm run generate before committing.

Publishing

Maintainers: see PUBLISHING.md for npm release steps.

License

MIT