Struct CompileOptions 

pub struct CompileOptions {
    pub target: BuildTarget,
    pub platform: Platform,
    pub roots: Roots,
    pub import_ext: ImportExt,
    pub contracts: bool,
    pub sources: Option<HashMap<PathBuf, String>>,
    pub schema_registry: SchemaLock,
}

Options for compile_project. Construct with CompileOptions::single or CompileOptions::split, then chain .target(…) / .platform(…) / .import_ext(…) to override the bundle/default-platform/.js defaults.

Fields

target: BuildTarget

platform: Platform

roots: Roots

import_ext: ImportExt

The import-specifier extension (slice 2). Js (default) for normal builds; Ts for the bynkc test --inspect debug build.

contracts: bool

v0.115 (testing track slice 3, DECISION J): the build profile for function contracts. true (dev/test) emits the call-site guard around a contracted fn; false (release/deploy) strips it entirely for zero runtime cost. bynkc test and --inspect set it on; bynkc compile leaves it off.

sources: Option<HashMap<PathBuf, String>>

#57 (testing track): when Some, every file roots would otherwise discover on disk is instead read from here — keyed the same way discovery::read_source’s overlay is (a canonicalised absolute path, falling back to the literal path when the file has no on-disk counterpart to canonicalise). Filesystem discovery is skipped entirely; roots still supplies src_root/tests_root and their prefixes, so a Roots::Split project can drive both trees in-memory.

#1077/#1081: bynk-driver’s project_options/try_project_options do set this now — the real CLI entry points walk and read every project file themselves and hand the result here, so bynk-emit itself no longer discovers or reads anything on disk for the CLI path. bynkc/the LSP still don’t: bynkc routes through bynk-driver, and the LSP (analyse_project_with) has its own open-buffer overlay and depends on the on-disk fallback for the rest (#1079). bynk-emit’s own tests also set this, to exercise the full project pipeline (cross-context uses, multi-file layouts, workers-mode emission, …) without an on-disk fixture tree.

schema_registry: SchemaLock

Events track, slice 3c (#980): reconcile against bynk.schema.lock. Off by default — bynkc compile’s directory branch and bynk’s deploy/dev build turn it on; every library/test caller (in-memory builds, bynkc/tests/e2e.rs’s in-place fixture compiles, bynk-emit’s own sources-driven tests, the LSP) leaves it off, so a compile never mutates a project tree it wasn’t asked to.

#1078: this carries the lock’s pre-read content, not just an on/off switch — bynk-emit reads and writes no disk for this file (the same move #1077/#1081 already made for .bynk source content). See SchemaLock’s own doc for the read side; the reconciled content comes back out on ProjectOutput::schema_lock for the caller to persist.

Implementations

impl CompileOptions

pub fn single(root: impl Into<PathBuf>) -> CompileOptions

Single-root project (src == tests), bundle target, default platform.

pub fn split( project_root: impl Into<PathBuf>, paths: ProjectPaths, ) -> CompileOptions

v0.9.1 split layout (source and test units in separate subdirectories under project_root), bundle target, default platform. Use this from bynkc test so its rooting matches bynkc compile’s.

pub fn target(self, target: BuildTarget) -> CompileOptions

Select the build target. Bundle (default) is the v0.6+ single-bundle layout; Workers (v0.8) emits per-context Cloudflare Workers.

pub fn import_ext(self, ext: ImportExt) -> CompileOptions

Slice 2: select the import-specifier extension. Ts is the debug build for bynkc test --inspect (run the .ts directly under Node strip-only).

pub fn contracts(self, on: bool) -> CompileOptions

v0.115: enable the function-contract call-site guard (dev/test profile). bynkc test and --inspect call this; the deploy build leaves it off so contract checks never reach production (DECISION J).

pub fn platform(self, platform: Platform) -> CompileOptions

v0.17: select the deploy Platform (selects the bynk surface binding). The MVP ships cloudflare only.

pub fn sources(self, sources: HashMap<PathBuf, String>) -> CompileOptions

#57 (testing track): supply every file in-memory instead of walking roots on disk — keyed the same way discovery::read_source’s overlay is (see the sources field’s own doc).

pub fn schema_registry(self, mode: SchemaLock) -> CompileOptions

Events track, slice 3c (#980): turn on bynk.schema.lock reconciliation for this build, with its pre-read content (or verified-absent None, for a fresh project). See SchemaLock and the field’s own doc for who calls this and why everyone else leaves it off.

Trait Implementations

impl Clone for CompileOptions

fn clone(&self) -> CompileOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.