@shd101wyy/yo 0.1.25 → 0.1.27

package/std/build.yo

@@ -13,28 +13,24 @@
 //! install :: build.step("install", "Build all artifacts");
 //! install.depend_on(exe);
 //! ```
-
 // ── Optimization levels ──────────────────────────────────────────────
-
 /// Optimization level for compiled artifacts.
 Optimize :: enum(
-  /// No optimizations, full debug info.  
+  /// No optimizations, full debug info.
   /// Compiler Flags: `-O0 -g`
   Debug,
-  /// Optimized with safety checks.  
+  /// Optimized with safety checks.
   /// Compiler Flags: `-O2 -g`
   ReleaseSafe,
-  /// Maximum speed optimizations.  
+  /// Maximum speed optimizations.
   /// Compiler Flags: `-O3`
   ReleaseFast,
-  /// Optimize for binary size.  
+  /// Optimize for binary size.
   /// Compiler Flags `-O2`
   ReleaseSmall
 );
-export Optimize;
-
+export(Optimize);
 // ── Memory allocators ────────────────────────────────────────────────
-
 /// Memory allocator to use in the compiled artifact.
 Allocator :: enum(
   /// High-performance allocator (mimalloc).
@@ -42,10 +38,8 @@ Allocator :: enum(
   /// Standard C library malloc.
   Libc
 );
-export Allocator;
-
+export(Allocator);
 // ── Sanitizers ───────────────────────────────────────────────────────
-
 /// Runtime sanitizer to enable.
 Sanitize :: enum(
   /// No sanitizer.
@@ -55,10 +49,8 @@ Sanitize :: enum(
   /// LeakSanitizer — detects memory leaks only.
   Leak
 );
-export Sanitize;
-
+export(Sanitize);
 // ── Step kinds ───────────────────────────────────────────────────────
-
 /// Kind of build step.
 StepKind :: enum(
   Executable,
@@ -70,31 +62,15 @@ StepKind :: enum(
   Custom,
   Documentation
 );
-export StepKind;
-
+export(StepKind);
 // ── Compilation targets ──────────────────────────────────────────────
-
-CompilationTarget :: {
-  X86_64_Linux_Gnu: "x86_64-linux-gnu",
-  X86_64_Linux_Musl: "x86_64-linux-musl",
-  Aarch64_Linux_Gnu: "aarch64-linux-gnu",
-  Aarch64_Linux_Musl: "aarch64-linux-musl",
-  Aarch64_Macos: "aarch64-macos",
-  X86_64_Macos: "x86_64-macos",
-  X86_64_Windows_Msvc: "x86_64-windows-msvc",
-  Wasm32_Emscripten: "wasm32-emscripten",
-  Wasm32_Wasi: "wasm32-wasi"
-};
-export CompilationTarget;
-
+CompilationTarget :: { X86_64_Linux_Gnu : "x86_64-linux-gnu", X86_64_Linux_Musl : "x86_64-linux-musl", Aarch64_Linux_Gnu : "aarch64-linux-gnu", Aarch64_Linux_Musl : "aarch64-linux-musl", Aarch64_Macos : "aarch64-macos", X86_64_Macos : "x86_64-macos", X86_64_Windows_Msvc : "x86_64-windows-msvc", Wasm32_Emscripten : "wasm32-emscripten", Wasm32_Wasi : "wasm32-wasi" };
+export(CompilationTarget);
 // ── Target utilities ─────────────────────────────────────────────────
-
 /// Host compilation target string.
 target_host :: __yo_build_target_host();
-export target_host;
-
+export(target_host);
 // ── Config struct types ──────────────────────────────────────────────
-
 /// Configuration for building an executable.
 Executable :: struct(
   /// Artifact name.
@@ -110,8 +86,7 @@ Executable :: struct(
   /// Runtime sanitizer.
   (sanitize : Sanitize) ?= Sanitize.None
 );
-export Executable;
-
+export(Executable);
 /// Configuration for building a static library.
 StaticLibrary :: struct(
   /// Artifact name.
@@ -123,8 +98,7 @@ StaticLibrary :: struct(
   /// Optimization level.
   (optimize : Optimize) ?= Optimize.Debug
 );
-export StaticLibrary;
-
+export(StaticLibrary);
 /// Configuration for building a shared/dynamic library.
 SharedLibrary :: struct(
   /// Artifact name.
@@ -136,8 +110,7 @@ SharedLibrary :: struct(
   /// Optimization level.
   (optimize : Optimize) ?= Optimize.Debug
 );
-export SharedLibrary;
-
+export(SharedLibrary);
 /// Configuration for a test suite.
 TestSuite :: struct(
   /// Suite name.
@@ -147,10 +120,8 @@ TestSuite :: struct(
   /// Compilation target triple (defaults to host).
   (target : comptime_string) ?= __yo_build_target_host()
 );
-export TestSuite;
-
+export(TestSuite);
 // ── Build module type ────────────────────────────────────────────────
-
 /// Represents a named source module that declares system library requirements.
 /// Modules are the unit of reuse across Yo dependencies.
 BuildModule :: struct(
@@ -160,10 +131,8 @@ BuildModule :: struct(
   root : comptime_string,
   _dep : comptime_string
 );
-export BuildModule;
-
+export(BuildModule);
 // ── Import entry type ────────────────────────────────────────────────
-
 /// Pairs an import name with a module for use with `add_import`/`add_import_list`.
 ImportEntry :: struct(
   /// Import alias used in source code.
@@ -171,10 +140,8 @@ ImportEntry :: struct(
   /// The module to import.
   module : BuildModule
 );
-export ImportEntry;
-
+export(ImportEntry);
 // ── Step type ────────────────────────────────────────────────────────
-
 /// A build step returned by all registration functions.
 /// Use `step.depend_on(dep)` to wire dependencies between steps.
 Step :: struct(
@@ -183,11 +150,10 @@ Step :: struct(
   /// Kind of step.
   kind : StepKind
 );
-export Step;
-
+export(Step);
 // ── Step methods ─────────────────────────────────────────────────────
-
-impl(Step,
+impl(
+  Step,
   /// Add a dependency — `dep` must complete before this step runs.
   depend_on : (fn(comptime(self) : Self, comptime(dep) : Step) -> comptime(unit))({
     __yo_build_step_depend_on(self.name, dep.name, dep.kind);
@@ -215,20 +181,17 @@ impl(Step,
     __yo_build_add_cflags(self.name, flags);
   })
 );
-
 // ── Build module methods ─────────────────────────────────────────────
-
-impl(BuildModule,
+impl(
+  BuildModule,
   /// Link a system library into this module.
   link : (fn(comptime(self) : Self, comptime(library) : Step) -> comptime(unit))({
     __yo_build_module_link(self.name, library.name);
   })
 );
-
 // ── Build option config types ────────────────────────────────────────
 // Like Zig's b.option(), declare user-configurable options.
 // CLI usage: yo build -Dname=value
-
 /// User-configurable build option (declared in `build.yo`, set via `yo build -Dname=value`).
 BuildOption :: struct(
   /// Option name (used with `-D`).
@@ -238,10 +201,8 @@ BuildOption :: struct(
   /// Default value if not provided.
   (default : comptime_string) ?= ""
 );
-export BuildOption;
-
+export(BuildOption);
 // ── Dependency config types ──────────────────────────────────────────
-
 /// Git-hosted dependency configuration.
 GitDependency :: struct(
   /// Dependency name.
@@ -253,8 +214,7 @@ GitDependency :: struct(
   /// Subdirectory within the repository.
   (path : comptime_string) ?= ""
 );
-export GitDependency;
-
+export(GitDependency);
 /// Local path dependency configuration.
 PathDependency :: struct(
   /// Dependency name.
@@ -262,8 +222,7 @@ PathDependency :: struct(
   /// Filesystem path to the dependency root.
   path : comptime_string
 );
-export PathDependency;
-
+export(PathDependency);
 /// System C library discovered via `pkg-config`.
 SystemLibrary :: struct(
   /// Library name (passed to `pkg-config`).
@@ -277,130 +236,124 @@ SystemLibrary :: struct(
   /// Extra C preprocessor defines.
   (defines : comptime_string) ?= ""
 );
-export SystemLibrary;
-
+export(SystemLibrary);
 // ── Dependency handle ────────────────────────────────────────────────
 // Returned by build.dependency() and build.path_dependency().
 // Provides access to artifacts defined in the dependency's build.yo.
-
 /// Handle to a registered dependency. Use `.artifact()` or `.module()` to access its exports.
 Dependency :: struct(
   name : comptime_string
 );
-export Dependency;
-
-impl(Dependency,
+export(Dependency);
+impl(
+  Dependency,
   /// Access a named artifact from the dependency's `build.yo`.
   /// Returns a `Step` that can be linked to the consumer's artifacts.
   artifact : (fn(comptime(self) : Self, comptime(artifact_name) : comptime_string) -> comptime(Step))({
     __yo_build_dep_artifact(self.name, artifact_name);
-    Step(name: artifact_name, kind: StepKind.StaticLibrary)
+    Step(name : artifact_name, kind : StepKind.StaticLibrary)
   }),
   /// Get a module from the dependency's `build.yo`.
   /// Empty `module_name` defaults to the sole module if exactly one exists.
   module : (fn(comptime(self) : Self, (comptime(module_name) : comptime_string) ?= "") -> comptime(BuildModule))({
     _encoded :: __yo_build_dep_module(self.name, module_name);
-    BuildModule(name: module_name, root: "", _dep: self.name)
+    BuildModule(name : module_name, root : "", _dep : self.name)
   })
 );
-
 // ── Build functions ──────────────────────────────────────────────────
 // All registration functions return a Step value, allowing steps to be
 // wired together as dependencies via step.depend_on(dep).
-
 /// Register an executable artifact. Returns a `Step` for dependency wiring.
-executable :: (fn(comptime(config) : Executable) -> comptime(Step)) {
-  opt_str :: match(config.optimize,
+executable :: (fn(comptime(config) : Executable) -> comptime(Step))({
+  opt_str :: match(
+    config.optimize,
     .Debug => "debug",
     .ReleaseSafe => "release-safe",
     .ReleaseFast => "release-fast",
     .ReleaseSmall => "release-small"
   );
-  alloc_str :: match(config.allocator,
+  alloc_str :: match(
+    config.allocator,
     .Mimalloc => "mimalloc",
     .Libc => "libc"
   );
-  san_str :: match(config.sanitize,
+  san_str :: match(
+    config.sanitize,
     .None => "none",
     .Address => "address",
     .Leak => "leak"
   );
   __yo_build_executable(config.name, config.root, config.target, opt_str, alloc_str, san_str);
-  Step(name: config.name, kind: StepKind.Executable)
-};
-export executable;
-
+  Step(name : config.name, kind : StepKind.Executable)
+});
+export(executable);
 /// Register a static library artifact. Returns a `Step` for dependency wiring.
-static_library :: (fn(comptime(config) : StaticLibrary) -> comptime(Step)) {
-  opt_str :: match(config.optimize,
+static_library :: (fn(comptime(config) : StaticLibrary) -> comptime(Step))({
+  opt_str :: match(
+    config.optimize,
     .Debug => "debug",
     .ReleaseSafe => "release-safe",
     .ReleaseFast => "release-fast",
     .ReleaseSmall => "release-small"
   );
   __yo_build_static_library(config.name, config.root, config.target, opt_str);
-  Step(name: config.name, kind: StepKind.StaticLibrary)
-};
-export static_library;
-
+  Step(name : config.name, kind : StepKind.StaticLibrary)
+});
+export(static_library);
 /// Register a shared/dynamic library artifact. Returns a `Step` for dependency wiring.
-shared_library :: (fn(comptime(config) : SharedLibrary) -> comptime(Step)) {
-  opt_str :: match(config.optimize,
+shared_library :: (fn(comptime(config) : SharedLibrary) -> comptime(Step))({
+  opt_str :: match(
+    config.optimize,
     .Debug => "debug",
     .ReleaseSafe => "release-safe",
     .ReleaseFast => "release-fast",
     .ReleaseSmall => "release-small"
   );
   __yo_build_shared_library(config.name, config.root, config.target, opt_str);
-  Step(name: config.name, kind: StepKind.SharedLibrary)
-};
-export shared_library;
-
+  Step(name : config.name, kind : StepKind.SharedLibrary)
+});
+export(shared_library);
 /// Register a test-suite artifact. Returns a `Step` for dependency wiring.
-test :: (fn(comptime(config) : TestSuite) -> comptime(Step)) {
+test :: (fn(comptime(config) : TestSuite) -> comptime(Step))({
   __yo_build_test(config.name, config.root, config.target);
-  Step(name: config.name, kind: StepKind.TestSuite)
-};
-export test;
-
+  Step(name : config.name, kind : StepKind.TestSuite)
+});
+export(test);
 /// Create a run step (compile + execute an artifact). Returns a `Step`.
-run :: (fn(comptime(artifact) : Step) -> comptime(Step)) {
+run :: (fn(comptime(artifact) : Step) -> comptime(Step))({
   __yo_build_run(artifact.name);
-  Step(name: artifact.name, kind: StepKind.Run)
-};
-export run;
-
+  Step(name : artifact.name, kind : StepKind.Run)
+});
+export(run);
 /// Register a named build step. Use `step.depend_on(dep)` to add dependencies.
-step :: (fn(
-  comptime(name) : comptime_string,
-  comptime(description) : comptime_string
-) -> comptime(Step)) {
+step :: (
+  fn(
+    comptime(name) : comptime_string,
+    comptime(description) : comptime_string
+  ) -> comptime(Step)
+)({
   __yo_build_step(name, description);
-  Step(name: name, kind: StepKind.Custom)
-};
-export step;
-
+  Step(name : name, kind : StepKind.Custom)
+});
+export(step);
 /// Register a git-hosted dependency. Returns a `Dependency` handle for accessing artifacts.
-dependency :: (fn(comptime(config) : GitDependency) -> comptime(Dependency)) {
+dependency :: (fn(comptime(config) : GitDependency) -> comptime(Dependency))({
   __yo_build_dependency(config.name, config.url, config.ref, config.path);
-  Dependency(name: config.name)
-};
-export dependency;
-
+  Dependency(name : config.name)
+});
+export(dependency);
 /// Register a local path dependency. Returns a `Dependency` handle for accessing artifacts.
-path_dependency :: (fn(comptime(config) : PathDependency) -> comptime(Dependency)) {
+path_dependency :: (fn(comptime(config) : PathDependency) -> comptime(Dependency))({
   __yo_build_path_dependency(config.name, config.path);
-  Dependency(name: config.name)
-};
-export path_dependency;
-
+  Dependency(name : config.name)
+});
+export(path_dependency);
 /// Register a system C library discovered via `pkg-config`. Returns a `Step` for linking.
-system_library :: (fn(comptime(config) : SystemLibrary) -> comptime(Step)) {
+system_library :: (fn(comptime(config) : SystemLibrary) -> comptime(Step))({
   __yo_build_system_library(config.name, config.fallback_include, config.fallback_lib, config.fallback_link, config.defines);
-  Step(name: config.name, kind: StepKind.SystemLibrary)
-};
-export system_library;
-
+  Step(name : config.name, kind : StepKind.SystemLibrary)
+});
+export(system_library);
 /// Module configuration for shared compilation units.
 ModuleConfig :: struct(
   /// Module name.
@@ -408,16 +361,14 @@ ModuleConfig :: struct(
   /// Root source file for the module.
   root : comptime_string
 );
-export ModuleConfig;
-
+export(ModuleConfig);
 /// Register a named module. Returns a `BuildModule` for linking system libraries
 /// and importing into executables/libraries.
-_module :: (fn(comptime(config) : ModuleConfig) -> comptime(BuildModule)) {
+_module :: (fn(comptime(config) : ModuleConfig) -> comptime(BuildModule))({
   __yo_build_module(config.name, config.root);
-  BuildModule(name: config.name, root: config.root, _dep: "")
-};
-export module : _module;
-
+  BuildModule(name : config.name, root : config.root, _dep : "")
+});
+export(module : _module);
 /// Declare a user-configurable build option.
 /// Returns the option value (from CLI `-Dname=value`, or the default).
 ///
@@ -432,18 +383,15 @@ export module : _module;
 option :: (fn(comptime(config) : BuildOption) -> comptime(str))(
   __yo_build_option(config.name, config.description, config.default)
 );
-export option;
-
+export(option);
 // ── Documentation generation ─────────────────────────────────────────
-
 /// Output format for documentation generation.
 DocFormat :: enum(
   Html,
   Markdown,
   Json
 );
-export DocFormat;
-
+export(DocFormat);
 /// Configuration for documentation generation.
 DocConfig :: struct(
   /// Step name (e.g., "doc").
@@ -468,8 +416,7 @@ DocConfig :: struct(
   /// Path to favicon.
   (favicon : comptime_string) ?= ""
 );
-export DocConfig;
-
+export(DocConfig);
 /// Register a documentation generation step. Returns a Step for dependency wiring.
 ///
 /// # Examples
@@ -493,18 +440,25 @@ export DocConfig;
 /// install :: build.step("install", "Build all artifacts");
 /// install.depend_on(doc_step);
 /// ```
-doc :: (fn(comptime(config) : DocConfig) -> comptime(Step)) {
-  fmt_str :: match(config.format,
+doc :: (fn(comptime(config) : DocConfig) -> comptime(Step))({
+  fmt_str :: match(
+    config.format,
     .Html => "html",
     .Markdown => "markdown",
     .Json => "json"
   );
   __yo_build_doc(
-    config.name, config.root, config.output, fmt_str,
-    config.include_private, config.include_deps,
-    config.title, config.logo, config.favicon,
+    config.name,
+    config.root,
+    config.output,
+    fmt_str,
+    config.include_private,
+    config.include_deps,
+    config.title,
+    config.logo,
+    config.favicon,
     config.version
   );
-  Step(name: config.name, kind: StepKind.Documentation)
-};
-export doc;
+  Step(name : config.name, kind : StepKind.Documentation)
+});
+export(doc);