kwechiri
v1.2.0
Published
An Igbo-first programming language
Maintainers
Readme
Kwechiri
Kwechiri is an Igbo-first programming language designed to make programming more accessible to Igbo speakers while maintaining a coherent, professional language and compiler architecture.
The compiler is currently implemented in TypeScript, generates JavaScript, and
uses an injected Kwechiri runtime with Node.js as its first host. Kwechiri source
files use the .kwe extension.
Current status
Language Milestones 0–10 and the post-milestone Lexical Foundations, Core Values & Logic, Collections, Functions, and Control Flow phases are closed. Modules and the pre-1.0 Language Foundations phase are closed. Standard Library Batches 11A, 11B, and 11C are certified and closed. The browser playground and VS Code support milestones, Batches 12A, 12B, and 13, are also certified and closed.
Kwechiri 1.2.0 is the current release. The Milestone 14 contract closed 1.0, and Milestone 15 adds the Batch 11C string functions. Milestone 16 adds multiline string literals. The CLI is published on npm, and the VS Code extension is public in the Marketplace. The implemented language includes:
- Unicode Igbo identifiers and located diagnostics
- strings, numbers, booleans, variables, arithmetic, and comparisons
"""..."""multiline string literals withKWE-LEX-006diagnosticsbipụta,ọ bụrụ/ọzọ,mgbe,kwụsị, andgaa n'ihu- named
ọrụfunctions withlaghachi - homogeneous arrays and typed objects
- named relative modules using
webata,bupụ, andsite na - nine explicit string functions imported from
kwechiri:eriri - an explicit runtime boundary with a Node.js implementation
- a public VS Code extension for
.kwesyntax highlighting and diagnostics
Quick start
Requires Node.js 20 or newer.
Install the current release:
npm install --global [email protected]
kwechiri hello.kwenpm install
npm run build
node dist/cli/index.js hello.kweExpected output:
Ndewo Ụwa!After linking the package locally with npm link, run a program with either
the compatible shorthand or the explicit command:
kwechiri hello.kwe
kwechiri run hello.kweValidate without executing, or compile directly runnable Node.js output:
kwechiri check hello.kwe
kwechiri compile hello.kwe
node hello.js
kwechiri compile hello.kwe --out build/hello.js --forceThe parent of an explicit output path must already exist. Compilation refuses to overwrite by default. See the CLI specification for help, version, streams, exit codes, and generated-artifact requirements.
Example
ọrụ gbakọọ(a, b) {
laghachi a + b
}
nsonaazụ = gbakọọ(10, 20)
ọ bụrụ (nsonaazụ >= 30) {
bipụta("Nsonaazụ zuru oke")
}Additional executable examples are available in examples/.
Development
Install the locked dependencies and run the canonical quality gate:
npm ci
npm run checkThe gate covers linting, strict source and test type checking, all tests, and a production build. See the development workflow and testing guide.
The static public website lives in website/. Install its locked
dependencies and validate it separately:
npm ci --prefix website
npm run website:checkThe VS Code integration lives in extensions/vscode/.
Install its locked dependencies, validate it, and produce a local VSIX:
npm ci --prefix extensions/vscode
npm run vscode:checkThe build command does not publish. The released extension is available from the VS Code Marketplace.
Documentation
- Official website
- Documentation index
- Current language specification
- Changelog
- Architecture index
- Design-decision index
- Project status and roadmap
- Recorded technical debt
- Website foundation plan
- VS Code support contract
- Contributing guide
- Code of conduct
- Security policy
- Third-party notices
Historical milestone-*.md files remain available as incremental records and
may be superseded by the current topic-oriented specification and later ADRs.
License and publication
Kwechiri is licensed under the MIT License. See LICENSE for the
full text and copyright notice.
The compiler package is published on npm as [email protected]. The separate VS
Code extension is publicly distributed through the Visual Studio Marketplace.
The source repository is public at
https://github.com/Jmmadubuike/kwechiri-programming-language.
