nitrogen_cli 0.5.4

CLI for Nitrogen Modules. Scaffold new Flutter FFI plugins and generate native bridge code.

0.5.4

• Fixed: Multi-spec C++ plugin — NitroOptInt64 typedef conflict in generated C++ bridge headers — cpp_record_generator.dart now excludes the built-in library record types (NitroOptInt64, NitroOptFloat64, NitroOptBool, NitroNullableInt, NitroNullableDouble, NitrNullableBool) from C++ forward declarations and struct definitions. These types are already defined as anonymous C typedefs in the generated bridge.g.h; emitting a named struct NitroOptInt64; in the same compilation unit caused a hard compiler error (definition of type 'NitroOptInt64' conflicts with typedef of the same name).
• Fixed: Multi-spec Swift plugin — NitroRecordWriter not found in scope for NativeImpl.cpp bridges — swift_record_generator.dart now skips library record type struct definitions when emitBoilerplate: false (the NativeImpl.cpp bridge path). Previously, NitroNullableInt and friends were emitted in the cpp bridge file even without the preamble, causing 'NitroNullableInt' is ambiguous for type lookup errors when multiple bridge files compiled into the same Swift module.
• Fixed: Multi-spec macOS — Static initialization order fiasco (SIOF) crash on startup — cpp_direct_emitter.dart now generates Meyers' Singleton wrapper functions (_g_instances(), _g_instances_mtx(), _g_next_instance_id(), _g_factory()) for all C++ registry globals. The previous static global variables could be accessed by __attribute__((constructor)) callbacks before the globals were initialized, manifesting as a std::__next_prime overflow/abort on macOS.
• Fixed: Multi-spec SPM — C++ bridge files copied before preamble-defining Swift bridge — _syncSwiftBridgesToSpmSources in link_command.dart now sorts bridge files so that those containing public protocol NitroEncodable (the shared preamble) are placed first. The first file is copied verbatim; subsequent files have the preamble stripped. This ensures NitroRecordWriter and related types are always defined before they are referenced in the same Swift module.
• Tests: 55 new per-spec integration tests in integration_test.dart verifying generator output for all three native-spec combinations: testing_project (Swift/Kotlin), testing_cpp (NativeImpl.cpp all platforms), and testing_mixed (Swift iOS / Kotlin Android / C++ macOS). Covers Dart binding symbols, C bridge signatures, Swift protocol declarations, Kotlin interface signatures, native.g.h abstract class, impl.g.cpp editable starter, and SPM file placement.
• Integration: 25/25 device integration tests pass on macOS across all 3 specs — add, getGreeting, multiply, pi, isEven, tryDivide (nullable int return), platform, optionalFlag (nullable bool), optionalValue (nullable double).

0.5.3

• Fixed: Multi-spec plugin — symbol not found: nitro_<spec>_init_dart_api_dl crash (root cause) — The stale-forwarder cleanup loop in _syncCppModuleSourcesToSpm was deleting ${lib}.bridge.g.mm for every module where isAppleCpp=false, including modules that use ios: NativeImpl.swift alongside windows: WindowsNativeImpl.cpp. Because the bridge mm is required for ALL modules on Apple to compile ${lib}_init_dart_api_dl into the SPM binary (even for Swift-backed modules), this deletion caused a runtime symbol-not-found crash. The stale cleanup now only removes the HybridXxx.cpp impl forwarder, never the bridge forwarder.
• Tests: 4 new regression tests in link_command_test.dart verifying that (1) bridge.g.mm is created for a Swift-on-iOS/C++-on-Windows module, (2) it is not deleted by the stale cleanup, (3) the HybridXxx.cpp impl forwarder is correctly removed for Swift-on-Apple modules, and (4) all three bridge mm forwarders are present for a full 3-spec plugin (the nitro_view scenario).
• Integration tests: 35 tests added to nitro_view/example/integration_test/multi_spec_bridge_test.dart exercising real FFI calls across all 3 specs (NitroSystem, NitroUI, NitroView) on iOS, Android, and macOS. Includes a cross-spec group as a definitive regression guard for the symbol-not-found crash. Added ACCESS_NETWORK_STATE and VIBRATE permissions to the Android example manifest.

0.5.2

• Fixed: Multi-spec Swift plugin — invalid redeclaration persists after every nitrogen generate / nitrogen link — _copySwiftBridgesToClasses and _syncSwiftBridgesToSpmSources in the link step always copied bridge files without preamble-stripping, overwriting any correctly-stripped copies. The fix moves preamble-stripping into these two functions (sorted alphabetically; first file keeps the full preamble, subsequent files have it removed) and relocates stripSharedSwiftPreamble to utils.dart so it is shared by both the generate and link code paths. Standalone nitrogen link now also produces correctly-stripped bridge files.
• Fixed: Multi-spec plugin — symbol not found: nitro_<spec>_init_dart_api_dl crash when 2nd/3rd spec uses Swift on iOS/macOS but C++ on Windows/Linux — _syncCppModuleSourcesToSpm created per-module ${lib}.bridge.g.mm SPM forwarders only for modules where isCpp=true AND isAppleCpp=true. Modules with ios: NativeImpl.swift, windows: WindowsNativeImpl.cpp had isCpp=true (triggering the stale-cleanup loop) but isAppleCpp=false (triggering deletion of the bridge mm). The bridge mm is required for ALL modules on Apple to compile ${lib}_init_dart_api_dl into the SPM binary; the stale cleanup now only removes the impl forwarder (HybridXxx.cpp), never the bridge forwarder (${lib}.bridge.g.mm).

0.5.1

• Fixed: Multi-spec Swift plugin — runtime symbol not found crash — _syncCppModuleSourcesToSpm now creates a ${lib}.bridge.g.mm forwarder in the SPM <PluginName>Cpp target for every non-plugin Swift module. Previously only C++ modules got per-module wrappers; the allCppModules.isEmpty guard skipped all per-module work for pure-Swift plugins, so 2nd and 3rd specs (e.g. nitro_ui, nitro_system) were never compiled into the binary. Result: dlsym('nitro_ui_init_dart_api_dl'): symbol not found crash on first use. Applies to both iOS and macOS SPM targets.
• Fixed: Multi-spec Swift plugin — invalid redeclaration compile error — _syncSwiftBridgesToClasses now strips the shared public-type preamble (NitroEncodable, NitroNullableInt, NitroRecordWriter, etc.) from the 2nd and subsequent bridge .swift files before writing them to ios/Classes/, macos/Classes/, and SPM Sources/<ClassName>/ directories. All bridge files compile into the same Swift module; duplicate public declarations cause a Swift compiler invalid redeclaration error. The first file (alphabetically) retains the full preamble; later files keep only their file-private string helpers and spec-specific protocol/registry/stubs.
• New: stripSharedSwiftPreamble(String content) — Exported top-level function implementing the preamble-stripping logic, enabling direct unit testing without filesystem scaffolding.

0.5.0

• Ecosystem sync — Aligned with nitro, nitro_annotations, and nitro_generator 0.5.0.

0.4.6

• Ecosystem sync — Aligned with nitro, nitro_annotations, and nitro_generator 0.4.6.

0.4.5

• Ecosystem sync — Aligned with nitro, nitro_annotations, and nitro_generator 0.4.5.

0.4.4

• Ecosystem sync — Aligned with nitro, nitro_annotations, and nitro_generator 0.4.4.

0.4.3

• New: nitrogen generate --no-ui — Headless plain-text output mode with no ANSI colours, auto-enabled when stdout is not a TTY (great for CI pipelines and scripts).
• New: nitrogen generate --fail-on-warn — Exits with code 2 if build_runner emits any [WARNING] lines, so CI catches generation warnings as failures.
• New: nitrogen generate --verbose / -v — Prints a per-phase timing breakdown (e.g. "resolve: 120ms, codegen: 340ms") at the end of generation.
• New: nitrogen clean command — Deletes all Nitrogen-generated files (*.g.dart, *.bridge.g.*, *.native.g.h, etc.) and the build_runner cache in one command.
• New: --no-ui headless mode for all commands — Every command (init, generate, clean, link, doctor, migrate, update, watch, open) now supports --no-ui. Output is plain text prefixed with [nitro], [nitro:warn], or [nitro:error]; auto-enabled when stdout is not a TTY.
• TUI: Animated NITRO logo — The dashboard now displays a large block-art "NITRO" logo with rocket animation at the top of the main content area, pulsing between cyan and magenta in sync with the header.
• TUI: Improved credits — Credits updated to "Inspired by Nitro — @mrousavy" with clickable links; added a row for Shreeman Arjun with X and GitHub links.
• CLI: Nitro credit in --version and --help — nitrogen --version now prints the Nitro inspiration line; nitrogen --help description includes the @mrousavy attribution.
• Fixed: Doctor false positives on FlutterFramework/Package.swift — detectSpmStatus was picking up ios/FlutterFramework/Package.swift (the Flutter SDK's SPM manifest, symlinked by CocoaPods) before the plugin's own ios/<name>/Package.swift. The scanner now skips directories whose name is not a valid Dart package identifier (lowercase snake_case), eliminating false-positive SPM errors on real-world plugins.
• Fixed: SPM Package.swift missing FlutterFramework dependency — nitrogen link now patches older plugin Package.swift files to add the FlutterFramework target dependency if it is missing, preventing SPM build failures after upgrading Flutter.
• Fixed: ANSI escape codes in headless build_runner output — runStreamingInspected strips ANSI sequences from subprocess output when running in --no-ui mode, so log files stay clean.

0.4.2

• Fixed: Apple C++ forwarder incorrectly deleted — link_command.dart now uses a safe default: forwarders are kept when no spec file exists for a library. Previously any lib not in platformCppLibs was deleted, removing valid Apple forwarders from plugins without a local spec.
• Fixed: Pure-Swift plugin files not copied to SPM target — _syncSwiftPluginToSpm is now called for plugins with no C/C++ content before the early continue, ensuring Swift plugin files reach Sources/<className>/ when building with SPM.
• Fixed: SPM sync crash for macOS-only plugins — _syncSwiftPluginToSpm now returns early when the target directory doesn't exist, preventing a PathNotFoundException for platforms that have no SPM layout.
• Fixed: Scaffold generated double "Plugin" suffix — scaffold_templates.dart was generating Swift${pascal}Plugin.swift; corrected to Swift${pascal}.swift to match the expected filename.
• Ecosystem sync — Aligned with nitro, nitro_annotations, and nitro_generator 0.4.2.

0.4.1

• Fixed: SPM Package.swift invalid header search paths — Removed external paths (../../lib/src/generated/cpp, ../../.symlinks/plugins/nitro/src/native) from SPM Swift target configuration. The Swift target accesses types through its ${className}Cpp dependency via publicHeadersPath: "include".
• Fixed: Swift plugin not found under SPM — Added _syncSwiftPluginToSpm() which copies *Plugin.swift and *Impl.swift from Classes/ to Sources/<className>/, ensuring GeneratedPluginRegistrant.m can find the Swift plugin class when building with SPM.
• Fixed: Mixed Apple platform linking — nitrogen link now correctly handles modules with different implementations per Apple platform (e.g. ios: NativeImpl.swift + macos: NativeImpl.cpp). iOS and macOS Plugin.swift registration and HybridXxx.cpp forwarders are managed independently per platform.
• Fixed: Portable dart_api_dl header — dart_api_dl.h is now written from the resolved pub-cache path rather than a relative .symlinks path, making it stable across both CocoaPods and SPM build trees and on CI machines.
• Fixed: Release-mode nitro.h export macros — createSharedHeaders and nitrogen doctor now validate that NITRO_EXPORT is present in nitro.h, fixing linker errors in archive/release builds.
• Fixed: Android multi-module stabilization — nitrogen init and nitrogen link CMake templates no longer produce duplicate library targets in multi-module projects; build.gradle source-set configuration avoids AGP 8.x routing issues.
• Refactored: Template extraction — All inline string templates moved from command files into lib/templates/ (forwarder_templates.dart, podspec_templates.dart, cpp_stubs.dart, swift_templates.dart, cmake_templates.dart, native_headers.dart, scaffold_templates.dart). Command files now contain only logic.
• Fixed: Lint warnings in generated and test code — Removed underscore-prefixed local identifiers (_scaffoldSpm, _scaffoldMacosSpm) and unused variables from test files; no_leading_underscores_for_local_identifiers warnings eliminated.

0.4.0

• New: Mixed Apple platform support — nitrogen link now correctly handles modules with different implementation languages per Apple platform (e.g. ios: NativeImpl.swift + macos: NativeImpl.cpp). iOS Plugin.swift registration and macOS Plugin.swift registration are managed independently, and HybridXxx.cpp forwarders are only written for the platform that actually uses C++.
• SPM and CocoaPods — Both build systems are fully supported. SPM targets (Sources/<PluginCpp>/) and CocoaPods targets (ios/Classes/, macos/Classes/) are wired automatically by nitrogen link. nitrogen doctor validates both layouts.
• Fixed: bridge.g.mm always written — bridge.g.mm is now written unconditionally (relative #include path), so plugins build correctly even when nitrogen link is run before nitrogen generate.
• Fixed: nitrogen link no longer deletes the main plugin bridge when the module lib name matches the plugin name.
• Fixed: nitrogen generate / nitrogen watch no longer hang when build_runner is already running.

0.3.4

• Fixed: createSharedHeaders now populates SPM Cpp target include dirs — Previously, createSharedHeaders only wrote nitro.h and Dart API headers to src/, ios/Classes/, and macos/Classes/. Plugins using the nested Flutter 3.41+ SPM layout ({platform}/<plugin>/Sources/<ClassName>Cpp/include/) were left without those headers until linkPodspec ran. createSharedHeaders now scans for any existing *Cpp/include/ directories under ios/<plugin>/Sources/ and macos/<plugin>/Sources/ and writes nitro.h plus copies all dart_api*.h headers into them.

0.3.3

• Fixed: linkPodspec operation order causing re-added stale Swift bridges — _cleanStaleSwiftBridges was called before syncBridgeFiles, so any stale .bridge.g.swift copies deleted from ios/Classes/ were immediately re-added by the subsequent syncBridgeFiles call. The order is now syncBridgeFiles first, then _cleanStaleSwiftBridges, ensuring stale copies are permanently removed.
• Fixed: syncBridgeFiles missing stale Swift bridge deletion for C++ modules — Previously, syncBridgeFiles skipped Swift bridges for NativeImpl.cpp/AppleNativeImpl.cpp modules but never deleted any stale copies that already existed in Classes/ or Sources/<ClassName>/. It now explicitly deletes those stale files, preventing "Invalid redeclaration" compile errors in projects upgrading from earlier layouts.
• Fixed: syncBridgeFiles SPM layout support — The function previously returned early when ios/Classes/ was missing, so the ios/Sources/<ClassName>/ target (used by SPM-enabled plugins) never received Swift bridge copies. It now checks both layouts independently and copies to whichever target directories exist.
• Fixed: _syncCppModuleSourcesToSpm spurious files when no C++ modules present — When moduleInfos contained no isCpp modules, the function still wrote dart_api_dl.c and the main plugin forwarder into ios/Sources/<PluginCpp>/ because the guard was placed after those writes. It now returns early if allCppModules is empty, leaving the SPM directory untouched.
• Improved: Test coverage — All 339 tests pass. Added and corrected assertions in utils_test.dart and link_command_test.dart covering: stale Swift bridge deletion for C++ modules in both ios/Classes/ and macos/Classes/, SPM-layout Swift bridge copying, linkPodspec operation order, and _syncCppModuleSourcesToSpm no-op behaviour.

0.3.2

• Fixed: Swift bridge duplicate compilation ("Invalid redeclaration") — Generated .bridge.g.swift files are now compiled directly from lib/src/generated/swift/ via the podspec source_files pattern. nitrogen generate and nitrogen link no longer copy these files into ios/Classes/ or macos/Classes/; instead, they delete any stale copies that were left from earlier versions. This eliminates the "Invalid redeclaration" Swift compiler error that occurred when both locations were compiled.
• Fixed: Android "Unresolved reference: XxxJniBridge" in AGP 8.x — The generated build.gradle template in nitrogen init and the benchmark project no longer include java.srcDirs += "...lib/src/generated/kotlin". In AGP 8.x that line routes .kt files through the Java compiler path, making Kotlin-only constructs unresolvable. kotlin.srcDirs alone is sufficient and correct.
• Improved: nitrogen doctor AGP 8.x diagnostic — The Android section now detects java.srcDirs pointing at generated/kotlin and reports an actionable error: java.srcDirs includes generated/kotlin — causes "Unresolved reference: XxxJniBridge" in AGP 8.x, with a hint to remove the line and use kotlin.srcDirs only.
• Improved: nitrogen doctor mixed-platform module detection — Generated-files checks now use platform-specific helpers (_isAndroidKotlinModule / _isAppleSwiftModule) instead of the broad isCppModule guard. This correctly handles mixed modules such as windows: WindowsNativeImpl.cpp, android: NativeImpl.kotlin: the .bridge.g.kt check is no longer skipped just because another platform uses C++.
• Improved: nitrogen link podspec source_files — linkPodspec() and linkMacosPodspec() now append '../lib/src/generated/swift/**/*.swift' to the podspec source_files pattern so Swift bridges are compiled without manual copying.
• Improved: Test coverage — 14 new tests across doctor_command_test.dart, link_command_test.dart, and utils_test.dart covering: java.srcDirs error detection, sourceSets missing error, android:cpp .bridge.g.kt skip, mixed-module .bridge.g.kt check, apple:cpp .bridge.g.swift skip, partial-Swift .bridge.g.swift check, podspec source_files injection, stale Swift bridge cleanup, and AGP 8.x regression guard.

0.3.1

• Improved: Ecosystem Sync — Synchronized to version 0.3.1.
• New: macOS nitrogen link step — linkMacosPodspec() now wires macos/$plugin.podspec with the correct s.platform = :osx, '10.15', HEADER_SEARCH_PATHS, swift_version, DEFINES_MODULE, dart_api_dl.c forwarder, and per-module C++ impl forwarders in macos/Classes/. The new step appears in the link progress view at index 3.
• Improved: macOS nitrogen link auto-fixes — linkMacosSwiftPlugin() now automatically creates a default ${ClassName}Plugin.swift if missing and injects the required Registry.register() calls. It also handles implementation naming fallbacks (e.g. BenchmarkImpl).
• Improved: nitrogen link podspec auto-dependency — linkPodspec() and linkMacosPodspec() now automatically inject s.dependency 'nitro' if it's missing, ensuring the 1.5 µs FFI bridge headers are always visible to the compiler.
• Fixed: nitrogen link symlink corruption — Hardened linkMacosSwiftPlugin() and linkSwiftPlugin() to use followLinks: false and filter out .symlinks/ directories, preventing recursive modification of external packages in the pub_cache.
• New: macOS Swift plugin wiring — linkMacosSwiftPlugin() injects NitroModules bridge registration calls into macos/*Plugin.swift, mirroring the existing iOS linkSwiftPlugin(). Both iOS and macOS Swift wiring now run in a single link step that marks done if either platform directory is present.
• New: macOS nitrogen doctor section — A dedicated macOS doctor section checks podspec HEADER_SEARCH_PATHS, C++17 flag, dart_api_dl.c, nitro.h, NITRO_EXPORT macro, stale .bridge.g.cpp presence, .bridge.g.mm bridges, .native.g.h header sync, and Swift plugin registration — parallel to the existing iOS section.
• Improved: nitrogen doctor platform diagnostics — Added explicit checks for s.dependency 'nitro' in both iOS and macOS podspecs, providing better DX for troubleshooting native linkage issues.
• New: macOS pubspec check — nitrogen doctor now validates the macos: platform block in pubspec.yaml, checking for pluginClass or ffiPlugin: true.
• Fixed: isCppModule() detection for macOS-only and mixed-platform specs — The old implementation required two occurrences of NativeImpl.cpp in the annotation string, so macos: NativeImpl.cpp alone (or ios: NativeImpl.cpp, macos: NativeImpl.cpp with no Android) was falsely classified as non-cpp. Now uses a platform-arg regex \b(?:ios|android|macos)\s*:\s*NativeImpl\.cpp\b — any platform being cpp marks the module as cpp.
• Fixed: _discoverCppLibs() same two-occurrence bug — The internal bridge-sync utility had identical broken logic; stale .bridge.g.swift files were not cleaned from ios/Classes/ or macos/Classes/ for macOS-only cpp specs. Fixed with the same platform-arg regex.
• New: syncBridgeFiles(platform:) parameter — syncBridgeFiles now accepts an optional platform parameter ('ios' or 'macos', default 'ios') so macOS bridge files are correctly synced to macos/Classes/ with the same Swift-exclusion and .cpp → .mm rename logic.
• New: nitro.h copied to macos/Classes/ — createSharedHeaders() now writes nitro.h into macos/Classes/ when that directory exists, in addition to ios/Classes/.
• Fixed: dashboard_test Watch description assertion — the TUI right-panel column truncates long strings; test now checks the visible prefix 'Run the Nitro gen' instead of the full description.
• Improved: Test coverage — 30+ new edge-case tests across link_command_test.dart, doctor_command_test.dart, and utils_test.dart: multi-line/comment-above annotation parsing, macOS-only discoverModuleInfos, tri-platform specs, linkMacosPodspec no-op/insertion/idempotency, linkMacosSwiftPlugin injection/deduplication/no-op, syncBridgeFiles(platform: 'macos') variants, macOS doctor section states, and macOS pubspec check variants.

0.3.0

• Fixed: PascalCase derivation for filenames with underscores — discoverModuleInfos now uses a robust _toPascalCase helper with empty-segment guards. This prevents RangeError exceptions when processing filenames with consecutive underscores (e.g., my__module.native.dart).
• Improved: Ecosystem Sync: Synchronized the Nitro ecosystem to version 0.3.0.

0.2.4

• Fixed: iOS build failure for NativeImpl.cpp modules — Three issues that blocked NativeImpl.cpp modules from linking on iOS have been resolved:
  • linkPodspec now creates ios/Classes/Hybrid<Lib>.cpp forwarders for C++ module impl files. On Android each module is its own .so; on iOS everything is one binary — the impl must be compiled in ios/Classes/.
  • syncBridgeFiles now auto-discovers NativeImpl.cpp modules by reading .native.dart specs and skips copying their .bridge.g.swift to ios/Classes/. The C++ bridge calls g_impl directly; the @_cdecl("_call_*") stubs in the Swift file are never called and their names clash with the non-cpp Swift bridge, causing a duplicate-symbol linker error.
  • ensureIosPackageSwift + new _syncCppModuleSourcesToSpm syncs the .bridge.g.mm and Hybrid<Lib>.cpp forwarders into the SPM Sources/<Main>Cpp/ target, and copies only the C-compatible .bridge.g.h into include/ (never .native.g.h, which uses C++ types that break the CocoaPods umbrella header).
• New: NativeImpl.cpp Direct C++ Support — All CLI commands now fully support @NitroModule(ios: NativeImpl.cpp, android: NativeImpl.cpp) modules:
  • nitrogen generate: syncs .native.g.h headers to ios/Classes/; skips "Not applicable" Swift placeholder files; shows a tailored next-steps hint for cpp modules.
  • nitrogen link: skips Swift bridge registration and Kotlin JniBridge.register steps for all-cpp plugins; adds generated/cpp/test/ to .clangd for GoogleMock IDE support.
  • nitrogen doctor: new NativeImpl.cpp Direct Implementation section checks whether ${lib}_register_impl() is wired up in src/ and whether .clangd includes the test directory; Android/iOS sections show ℹ info (not errors) for checks irrelevant to cpp modules.
• Improved: nitrogen doctor — cpp-aware Android/iOS sections:
  • Android: when all specs use NativeImpl.cpp, Kotlin JNI bridge checks are shown as info.
  • iOS: Registry.register check skipped for all-cpp plugins; checks for .native.g.h headers in ios/Classes/ instead; .bridge.g.mm warning suppressed.
  • Generated files: .bridge.g.kt/.bridge.g.swift shown as ℹ info (placeholder) for cpp modules; .native.g.h, .mock.g.h, .test.g.cpp checked as required outputs.
• New: isCppModule() + ModuleInfo — link_command.dart exports isCppModule(File) (detects two NativeImpl.cpp occurrences in annotation) and ModuleInfo (carries isCpp flag). Legacy discoverModules() preserved for compatibility.
• Improved: Test Coverage — 28 new tests covering isCppModule edge cases, discoverModuleInfos with mixed cpp/kotlin projects, doctor Android/iOS cpp sections, NativeImpl.cpp doctor section (register_impl check, clangd check).

0.2.3

• Automated Native Healing: Commands now proactively fix common native build errors.
  • nitrogen link and nitrogen generate automatically scan your C++ source files and strip redundant #include "*.bridge.g.cpp" directives that previously caused duplicate symbol errors in Xcode.
  • Added a dedicated cleanRedundantIncludes utility to the CLI core for robust source cleanup.
• Native Visibility Synchronization:
  • The CLI now maintains a canonical nitro.h with NITRO_EXPORT visibility macros for cross-platform FFI compatibility.
  • nitrogen link, nitrogen generate, and nitrogen init all strictly enforce that your project's nitro.h is up to date, automatically repairing it if it's outdated or corrupted.
• Enhanced nitrogen doctor Diagnostics:
  • New check for redundant bridge includes in src/.
  • New check for NITRO_EXPORT visibility macros in nitro.h.
  • Improved HEADER_SEARCH_PATHS validation in iOS podspecs to ensure all generated code is discoverable.
• Improved Code Generation: Fixed an issue in nitro_generator where large Uint8List buffers were incorrectly passed as Array<UInt8> instead of Data in some Swift bridge signatures.
• Dependency Sync: Synchronized the Nitro ecosystem to version 0.2.3.

0.2.2

• Standardized on Nitrogen 0.2.2 ecosystem versions.

0.2.1

• New Watch Mode: Added the nitrogen watch command to handle continuous code generation. This feature includes an automatic iOS Bridge Sync that copies and renames generated C++/Swift bridges to ios/Classes on every successful build. This ensures that your iOS project always has the latest generated bridge files without manual intervention.
• Better TUI Experience: Overhauled the Nitro Dashboard with a new multi-project sidebar, improved focus management (using [Tab]), and consistent ESC-based navigation.
• New: Multi-Project Discovery: Automatically detects and switches between multiple Nitrogen modules in a monorepo.
• Improved: Enhanced Doctor: Expanded nitrogen doctor to verify system compiler toolchains (Clang, Xcode, NDK, Java) and validate plugin registration.
• Performance: Optimized Android and JNI bridge performance with static caching and persistent thread pools.
• Improved: TUI Navigation & Error Handling — Standardized "ESC back" and "ESC exit" navigation logic across all views. Implemented a centered, high-visibility error UI for all command failures (e.g., missing pubspec.yaml, network/process errors).
• Improved: JNI Performance — All FindClass, GetStaticMethodID, GetFieldID, and GetMethodID calls are now cached as static globals and initialized once in JNI_OnLoad, eliminating per-call classloader traversal.
• Improved: Android Async Throughput — Kotlin bridge async methods now delegate to a newCachedThreadPool executor instead of calling runBlocking directly.
• Improved: Generator O(1) Type Lookups — KotlinGenerator and CppBridgeGenerator now pre-build type name tables once per generation, reducing lookup complexity from O(n) to O(1).
• Improved: Process Feedback — ProcessView now uses visual cues (red borders) and explicit status text when a long-running process fails.
• Fixed: Arena Use-After-Free in Async FFI Bridges — Generated code now uses Arena() directly with try/finally to ensure the arena lives until after the async native call completes.
• Fixed: Typed callAsync<T> Removes Raw Pointer Casts — Generated Dart now uses the typed form callAsync<T>(...), eliminating unsafe as casts.
• Fixed: Null Safety for JNI Pack — Added null guards for zero-copy ByteBuffer fields in pack_*_from_jni helpers.
• Fixed: nitrogen doctor Unmodifiable List Error — Resolved a runtime exception by ensuring diagnostic lists are growable.
• Fixed: nitrogen exit command — Properly terminates the application from the menu.
• Refactored Link Logic: Decoupled core linking logic (CMake, Podspec, Swift/Kotlin plugins, .clangd) from the TUI-specific LinkView. All linking tasks are now top-level, testable functions that support a baseDir parameter for programmatic execution in monorepos or test environments.
• Improved: iOS Podspec Wiring: Updated linkPodspec to automatically enforce Swift 5.9 and iOS 13.0 as minimums, ensuring compatibility with the latest Nitrogen generated code.
• Fixed: PathNotFoundException in Tests: Updated getAllProjects to accept an optional baseDir, eliminating reliance on the process-global Directory.current and fixing parallel test execution failures.
• Improved Test Coverage: Added a comprehensive test suite for CLI command registration, module discovery, and path resolution.

0.2.0

• New: High-Performance Binary Codec Integration — All generated bridges now default to the compact binary protocol for @HybridRecord types, matching the updates in package:nitro 0.2.0.
• Improved: nitrogen doctor Reliability — Fixed a runtime exception ("Unsupported operation: Cannot add to an unmodifiable list") when running checks on pubspec.yaml, generated files, and build system wiring.
• Improved: nitrogen generate Stability — Updated the generator backbone to remove unreferenced helper methods and redundant type lookups in Swift bridges.
• Improved: Linter Integration — Updated analysis options to prefer wider page widths (220) and cleaner formatting for generated code across all packages.
• Dependency Sync: Synchronized core ecosystem versions to 0.2.0 across nitro, nitro_generator, and nitrogen_cli.

0.1.13

• Full Zero-Copy TypedData Support:
  • Fixed JNI bridging for @HybridStruct (descriptors, casts, and byte counts).
  • Added ZeroCopyBuffer variants for ALL TypedData types with GC finalizers.
  • Int64List and Uint64List are now correctly handled in all generators.
• iOS & Swift Safety:
  • Renamed bridge files to .bridge.g.mm to enable Objective-C++ exception handling.
  • Fixed memory corruption when passing typed lists (Float32List, etc.) by using ABI-safe pointers and companion length parameters.
  • Replaced fatalError with catchable NSException.raise for bridge validation errors.
• CLI Workflow & Tooling:
  • nitrogen generate now automatically syncs Swift bridges to ios/Classes/ and runs pod install.
  • Added new nitrogen doctor checks for iOS project health and FFI plugin configuration.
  • Stale bridge files are now automatically cleaned up during link.
• Generator Enhancements: Added cyclic dependency detection in structs and support for @HybridEnum as struct fields.
• Testing & Quality: Added 150+ new tests covering zero-copy TypedData, cyclic dependencies, and bridge safety. Fixed minor TUI lints and improved CLI feedback.

0.1.12

• Fix static version in lib/version.dart
• nitrogen init: src/dart_api_dl.c and src/CMakeLists.txt now resolve the correct pub-cache nitro path at scaffold time instead of writing a monorepo placeholder. After pubspec dependencies are installed, nitrogen init reads .dart_tool/package_config.json (using the same resolveNitroNativePath logic as nitrogen link) and overwrites both files with the absolute path — so the generated plugin builds immediately without needing a separate nitrogen link run.

0.1.11

• nitrogen init: generated example/lib/main.dart now showcases the plugin API with a proper Flutter app — WidgetsFlutterBinding.ensureInitialized(), a StatelessWidget MyApp, try-catch error screen, async FutureBuilder, and a reusable _FeatureCard widget. Fixes broken template syntax (const .all(10), .center) from the previous scaffold.
• Added docs/swift-type-mapping.md: comprehensive reference covering the two-layer Swift type system, full Dart → C → @_cdecl → protocol type mapping table, memory ownership for String returns, async bridging pattern, Bool conversion, struct returns, and a crash diagnosis guide for EXC_BAD_ACCESS.
• Updated docs/getting-started.md: added @_cdecl bridge type callout in the Supported Types section, Step 6 note reminding plugin authors to use native Swift types in *Impl.swift, and an EXC_BAD_ACCESS troubleshooting entry.

0.1.10

• Editor Quick Links: Instantly open your active Nitro project in VS Code or Antigravity via clickable links in the dashboard header or the nitrogen open command.
• Smart Project Discovery:
  • generate, link, and doctor commands now automatically search for a Nitro project in the current directory and its direct subdirectories. This allows running Nitrogen commands from a parent folder (e.g., right after init) without needing to manually cd.
  • Dashboard now reflects the active project found in subdirectories.
• Improved Navigation: Added visible ‹ Back buttons to all menu views (Init, Doctor, Link, and Generate) for easier dashboard navigation.
• UI Stability Fix:
  • Fixed flickering and layout jumps in the "✨ SUCCESS ✨" pulse animation during generation and initialization.
  • The success status now maintains a stable height, preventing the log view from shifting.
• TUI Menu Refinement: Rearranged core commands with Exit consistently at the bottom and editor options moved to a cleaner header position.

0.1.9

• TUI Visual Overhaul (Neon Premium Theme):
  • New pulsing header logo (cycles between ⚡ Cyan and 🔥 Magenta).
  • Added "by Shreeman Arjun" author attribution to the dashboard.
  • Improved readability with high-contrast color palettes for menus and logs.
• Mouse & Interactive Features:
  • Full mouse support: Hover over menu items to highlight them.
  • Click anywhere on a command row to execute it instantly.
  • Clickable footer links for Documentation, Shreeman.dev, and Marc Rousavy.
• Context-Aware Dashboard:
  • Project Bar: Displays the name and version of the currently active Nitrogen project in the header.
  • Status Bar: Added a fixed bottom bar showing Dart version and current Git branch.
• Enhanced Process Feedback:
  • Added a pulsing "✨ SUCCESS ✨" animation and green color shift when a generation or initialization completes successfully.
• Usability Fixes:
  • Added an explicit Exit command to the TUI menu for easy quitting.
  • Standardized menu alignment (labels and descriptions now align vertically in the center).
  • Automatic TUI versioning: the dashboard always displays the actual package version from pubspec.yaml.

0.1.8

• nitrogen link: fix Android/iOS build failure where dart_api_dl.c and dart_api_dl.h were not found when nitro is installed from pub.dev (e.g. via puro's pub cache) rather than a local monorepo path.
  • link now reads .dart_tool/package_config.json to resolve the actual installed nitro package path (absolute file:// URI or relative URI).
  • Creates a local src/dart_api_dl.c forwarder (#include "<resolved path>") so the Android CMake build never references a path outside the project directory.
  • ios/Classes/dart_api_dl.c now chains through ../../src/dart_api_dl.c, giving both Android CMake and iOS CocoaPods/SPM a single resolution point.
  • Migrates legacy "${NITRO_NATIVE}/dart_api_dl.c" entries in existing CMakeLists.txt to the new local "dart_api_dl.c" form automatically.
  • Updates a stale NITRO_NATIVE cmake variable if the path it currently points to no longer contains dart_api_dl.h.
• nitrogen init: generated CMakeLists.txt and ios/Classes/dart_api_dl.c now use the same local-forwarder pattern from day one.
• Extracted resolveNitroNativePath, nitroNativePathExists, and dartApiDlForwarderContent as package-level functions for testability; private _LinkViewState helpers now delegate to them.
• Added tests covering resolveNitroNativePath (file:// URI, relative URI, absent config, fallback), nitroNativePathExists, and dartApiDlForwarderContent.

0.1.7

• nitrogen init: nitro and nitro_generator dependency versions are now resolved automatically from pub.dev at scaffold time instead of being hardcoded.
• Fallback: if pub.dev is unreachable, flutter pub add nitro and flutter pub add --dev nitro_generator are run in the generated plugin directory so pub resolves the latest compatible versions itself.

0.1.6

• Fix nitrogen doctor always reporting ios/Classes/dart_api_dl.cpp missing: the check now correctly looks for dart_api_dl.c, matching what nitrogen link actually creates (.cpp is deleted by link because C++ rejects the void*/function-pointer cast inside it).

0.1.5

• nitrogen init now generates starter ${ClassName}Impl.swift and ${ClassName}Impl.kt files so the plugin compiles immediately without any manual steps.
• iOS: switched from @objc/NSObject to @_cdecl C-bridge stubs — Swift structs and Swift-only protocols can now cross the native boundary correctly.
• iOS: HEADER_SEARCH_PATHS in podspec now uses ${PODS_ROOT}/../.symlinks/plugins/nitro/src/native so the path resolves correctly whether nitro is a local path dependency or installed from pub.dev.
• iOS: dart_api_dl is created as .c (not .cpp) so the Dart DL API compiles as C; C++ rejects the void*/function-pointer cast inside it.
• iOS: nitrogen init now creates a Package.swift alongside the podspec, enabling Swift Package Manager distribution in addition to CocoaPods.
• iOS: SPM Sources/ layout uses symlinks into Classes/ so a single file exists at one location and is shared between both build systems.
• nitrogen link: extracted discoverModuleLibs and extractLibNameFromSpec as package-level functions for testability.
• Added comprehensive link_command_test.dart covering lib-name extraction, module discovery, podspec path correctness, and template content validation.

0.1.4

• nitrogen init always prompts for plugin name via an interactive PluginNameForm TUI; the name can no longer be passed as a positional argument.
• Added NitrogenInitApp (public) to handle the form → scaffold flow, reusable in both CLI and TUI dashboard.
• TUI dashboard /init route updated to use NitrogenInitApp instead of a hardcoded InitView.
• ESC on the plugin name form navigates back to the dashboard (TUI) or is a no-op (CLI).
• Added pluginName field to InitResult for post-run reporting.
• Added comprehensive tests for InitResult, InitStep, InitStepRow, PluginNameForm, and plugin name validation.

0.1.3

• Implement String type conversion in the struct generator and add braces to the CLI's plugin name extraction.

0.1.2

• Rename generator package folder to nitro_generator.
• Update doctor and init commands with new path references.

0.1.1

• Update nitrogen package reference to nitro_generator.

0.1.0

• Initial release with nocterm dashboard.
• Integrated nitrogen init, generate, link, doctor, and update.