{"id":25115,"library":"concordialang","title":"Concordia Language Compiler","description":"Concordia Language Compiler (concordialang) is a CLI tool for acceptance testing driven by natural language specifications. It compiles Gherkin-like feature files into executable test scripts using pluggable test frameworks (e.g., CodeceptJS, Playwright). Version 2.0.0-alpha.20 is the latest alpha, released sporadically with incremental features like multi-package-manager support (npm, yarn, pnpm), plugin updates, and XPath support. Differentiators: test-framework-agnostic plugin architecture, built-in report generation, and focus on BDD/ATDD workflows with support for actions like 'accept alert'.","status":"active","version":"2.0.0-alpha.20","language":"javascript","source_language":"en","source_url":"git://github.com/thiagodp/concordialang","tags":["javascript","concordia","concordialang","concordia-lang","agile","requirement","spec","specification","specification-by-example"],"install":[{"cmd":"npm install concordialang","lang":"bash","label":"npm"},{"cmd":"yarn add concordialang","lang":"bash","label":"yarn"},{"cmd":"pnpm add concordialang","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Used for CLI command parsing","package":"commander","optional":false}],"imports":[{"note":"ESM-only; CommonJS not supported.","wrong":"const concordia = require('concordialang')","symbol":"default","correct":"import { compile } from 'concordialang'"},{"note":"Named export, not default.","wrong":"const { compile } = require('concordialang')","symbol":"compile","correct":"import { compile } from 'concordialang'"},{"note":"TypeScript type import, not a runtime value.","wrong":"const { ConcordiaConfig } = require('concordialang')","symbol":"type definitions","correct":"import type { ConcordiaConfig } from 'concordialang'"}],"quickstart":{"code":"// Install the compiler and a plugin\nnpm install concordialang\nnpm install concordialang-plugin-codeceptjs\n\n// Create a feature file 'hello.feature'\n// Feature: Hello\n//   Scenario: Say hello\n//     Given I have a browser\n//     When I go to \"about:blank\"\n//     Then I see the page title is \"\"\n\n// Compile and run\nnpx concordia compile hello.feature --plugin=codeceptjs --runner=webdriverio","lang":"typescript","description":"Install concordialang and a plugin, create a feature file, then compile and run tests."},"warnings":[{"fix":"Update plugins to new structure; see concordialang-fake-plugin for example.","message":"Plugin structure changed in v2.0.0-alpha.19, breaking compatibility with older plugins.","severity":"breaking","affected_versions":">=2.0.0-alpha.19"},{"fix":"Use ES import syntax: import { compile } from 'concordialang'","message":"ESM-only since v2.0.0-alpha.14; CommonJS require() not supported.","severity":"breaking","affected_versions":">=2.0.0-alpha.14"},{"fix":"Review generated folder structure; output dir is now automatically created.","message":"--init option behavior changed; now creates output directory.","severity":"deprecated","affected_versions":">=2.0.0-alpha.16"},{"fix":"Pin exact version in package.json and test thoroughly.","message":"Version 2.0.0-alpha.20 is alpha; APIs unstable.","severity":"deprecated","affected_versions":">=2.0.0-alpha.1"},{"fix":"Use plugins marked for Concordia 2.","message":"Plugin version must match Concordia major version; v2 plugins incompatible with v1.","severity":"gotcha","affected_versions":">=2.0.0-alpha.1"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'npm install concordialang' which includes commander as a dependency.","cause":"Missing commander dependency, or incorrect install.","error":"Error: Cannot find module 'commander'"},{"fix":"Use ES import syntax, or switch to CJS build if available.","cause":"Using require() on an ESM-only package.","error":"SyntaxError: Unexpected token 'export'"},{"fix":"Install plugin: npm install concordialang-plugin-codeceptjs","cause":"Plugin not installed or name misspelled.","error":"Plugin 'concordialang-plugin-codeceptjs' not found."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}