Enum Command 

pub enum Command {
    Compile {
        input: PathBuf,
        output: PathBuf,
        target: CliTarget,
        platform: CliPlatform,
        emit: EmitFormat,
    },
    Check {
        input: PathBuf,
        format: DiagFormat,
    },
    Fmt {
        inputs: Vec<PathBuf>,
        check: bool,
    },
    Test {
        input: PathBuf,
        output: Option<PathBuf>,
        no_run: bool,
        format: TestFormat,
        inspect: bool,
        seed: Option<String>,
    },
}

Variants

Compile

Compile a .bynk file (single-file commons) to a TypeScript file, or a directory project to a tree of TypeScript files mirroring the source layout.

Fields

input: PathBuf

Input .bynk file, or directory project root.

output: PathBuf

Output .ts file (for single-file input) or output root directory (for project input).

target: CliTarget

Build target. bundle (default) produces a single deployment unit; workers produces one Cloudflare Worker per context with Service Binding plumbing (v0.8).

platform: CliPlatform

Deploy platform selecting the bynk surface binding (v0.17). A new axis, distinct from --target: cloudflare (default), node, or browser (the in-browser playground binding; Bundle topology only).

emit: EmitFormat

Artefact language (v0.108). ts (default) writes typed TypeScript; js writes the same modules with types stripped — a JavaScript artefact that runs with no tsc in the loop (ADR 0137).

Check

Type-check a .bynk file or project without writing output.

Fields

input: PathBuf

Input .bynk file or project root.

format: DiagFormat

Diagnostic output format. rich (default) is the ariadne source-context rendering; short emits one terse path:line:col: severity[category]: message line per diagnostic, for tooling (the VS Code problem-matcher, CI, scripts).

Fmt

Format .bynk source files in place. Passing - reads from stdin and writes to stdout.

Fields

inputs: Vec<PathBuf>

Files to format. Use - for stdin → stdout.

check: bool

Check formatting without writing changes. Exits non-zero if any file is not already canonical.

Test

Discover and run test declarations in a project. Compiles the project (including all generated tests/*.test.ts modules), then invokes Node.js on the aggregated runner script. Requires tsc and node to be on PATH.

Fields

input: PathBuf

Input project root directory. Defaults to the current directory.

output: Option<PathBuf>

Where to write compiled TypeScript test runner modules. Defaults to <input>/out.

no_run: bool

Skip the runner invocation. With --format rich this emits the generated test files (for CI flows that drive the runner separately); with --format json it emits a discovery document listing every suite and case (each outcome: "discovered") without running them — a pure compile, no tsc/Node.

format: TestFormat

Output format. rich (default) is the grouped ✓ / ✗ human output; json is a single pinned JSON document of results, for tooling.

inspect: bool

Compile a debug build and launch the test runner under Node’s inspector (node --inspect-brk), printing the inspector URL for a JavaScript debugger to attach (slice 2, ADR 0104). The emitted .ts runs directly under Node’s line-preserving type-stripping, so source maps resolve breakpoints back to .bynk. Requires Node ≥ 22.18 (or ≥ 23.6 unflagged). Does not run tsc.

seed: Option<String>

v0.114: the root seed for generative property tests, as hex (e.g. 0x5f3a). A failing property prints the seed it used; re-running with --seed <hex> reproduces that run byte-for-byte. Omitted, each run draws a fresh random seed.

Trait Implementations

impl Debug for Command

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for Command

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Command

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut]

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut]

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand