nylo_framework

Changed

• Bump nylo_support dependency from ^7.27.5 to ^7.28.0, which brings:
  • name and path constructor parameters on NavigationHub, plus NyStatefulWidget.declaredStateName, so a hub and the NavigationHubStateActions driving it can agree on a single state name
  • State names are now built from the page's widget class on both the sending and listening end of a state update — fixes updates being silently dropped in obfuscated builds (flutter build --obfuscate)
  • NyPage no longer adopts another page's state data on init, and JourneyState.isLastStep no longer reports true for a journey with no steps
  • NyLogger.error now reports routes whose builder names no page, and NavigationHubStateActions calls addressing a name no hub listens on

Changed

• Bump nylo_support dependency from ^7.27.5 to ^7.28.0, which brings:
  • name and path constructor parameters on NavigationHub, plus NyStatefulWidget.declaredStateName, so a hub and the NavigationHubStateActions driving it can agree on a single state name
  • State names are now built from the page's widget class on both the sending and listening end of a state update — fixes updates being silently dropped in obfuscated builds (flutter build --obfuscate)
  • NyPage no longer adopts another page's state data on init, and JourneyState.isLastStep no longer reports true for a journey with no steps
  • NyLogger.error now reports routes whose builder names no page, and NavigationHubStateActions calls addressing a name no hub listens on

Changed

• patrol is now a dev dependency (was a regular dependency) and bumped from ^4.8.0 to ^4.9.0 — consumer apps no longer pull in patrol transitively; add it to your own dev_dependencies if your tests use it
• Bump nylo_support dependency from ^7.27.4 to ^7.27.5
• Bump flutter_local_notifications dependency from ^22.2.0 to ^22.3.0
• Analyzer now excludes build/ and platform folders (android/, ios/, web/, windows/, macos/, linux/) in analysis_options.yaml

Changed

• patrol is now a dev dependency (was a regular dependency) and bumped from ^4.8.0 to ^4.9.0 — consumer apps no longer pull in patrol transitively; add it to your own dev_dependencies if your tests use it
• Bump nylo_support dependency from ^7.27.4 to ^7.27.5
• Bump flutter_local_notifications dependency from ^22.2.0 to ^22.3.0
• Analyzer now excludes build/ and platform folders (android/, ios/, web/, windows/, macos/, linux/) in analysis_options.yaml

Changed

• Bump nylo_support dependency from ^7.27.3 to ^7.27.4
• Bump flutter_local_notifications dependency from ^22.0.1 to ^22.2.0
• Bump dio dependency from ^5.10.0 to ^5.11.0
• Bump error_stack dependency from ^2.1.4 to ^2.1.5
• Bump patrol dependency from ^4.6.1 to ^4.8.0

Changed

• Bump nylo_support dependency from ^7.27.3 to ^7.27.4
• Bump flutter_local_notifications dependency from ^22.0.1 to ^22.2.0
• Bump dio dependency from ^5.10.0 to ^5.11.0
• Bump error_stack dependency from ^2.1.4 to ^2.1.5
• Bump patrol dependency from ^4.6.1 to ^4.8.0

Fixed

• `make:api_service` — acronym-spelled names (e.g. `PaymentsAPIService`) no longer produce a doubled `ApiServiceApiService` class name; the suffix is now stripped case-insensitively and falls back to `api` for suffix-only input
• Generated API service now always imports `package:nylo_framework/nylo_framework.dart` (previously omitted when a custom `--url` was supplied, breaking the `NyApiService` reference)
• Generated `env.g.dart` now escapes single quotes and backslashes in keys and values, so secrets containing `'` or `\` can't break the generated Dart string literal

Changed

• `make:api_service` info hint now points to `bootstrap/decoders.dart` (was `config/decoders.dart`)
• Generated `env.g.dart` adds explicit local variable type annotations and a `dart:typed_data` import (satisfies the `specify_nonobvious_local_variable_types` lint)
• Bump `nylo_support` dependency from `^7.27.2` to `^7.27.3`
• Bump `flutter_local_notifications` dependency from `^22.0.0` to `^22.0.1`
• Bump `dio` dependency from `^5.9.2` to `^5.10.0`

Fixed

• make:api_service — acronym-spelled names (e.g. PaymentsAPIService) no longer produce a doubled ApiServiceApiService class name; the suffix is now stripped case-insensitively and falls back to api for suffix-only input
• Generated API service now always imports package:nylo_framework/nylo_framework.dart (previously omitted when a custom --url was supplied, breaking the NyApiService reference)
• Generated env.g.dart now escapes single quotes and backslashes in keys and values, so secrets containing ' or \ can't break the generated Dart string literal

Changed

• make:api_service info hint now points to bootstrap/decoders.dart (was config/decoders.dart)
• Generated env.g.dart adds explicit local variable type annotations and a dart:typed_data import (satisfies the specify_nonobvious_local_variable_types lint)
• Bump nylo_support dependency from ^7.27.2 to ^7.27.3
• Bump flutter_local_notifications dependency from ^22.0.0 to ^22.0.1
• Bump dio dependency from ^5.9.2 to ^5.10.0

Changed

• Bump nylo_support dependency from ^7.27.1 to ^7.27.2
• Bump flutter_local_notifications dependency from ^21.0.0 to ^22.0.0
• Raise minimum environment constraints to Dart ^3.12.0 and Flutter >=3.44.0

Changed

• Bump nylo_support dependency from ^7.27.1 to ^7.27.2
• Bump flutter_local_notifications dependency from ^21.0.0 to ^22.0.0
• Raise minimum environment constraints to Dart ^3.12.0 and Flutter >=3.44.0

Changed

• Bump nylo_support dependency from ^7.26.2 to ^7.27.1
• Bump patrol dependency from ^4.6.0 to ^4.6.1

Changed

• Bump nylo_support dependency from ^7.26.2 to ^7.27.1
• Bump patrol dependency from ^4.6.0 to ^4.6.1

Changed

• Improved make:interceptor Metro stub: added docstrings for onRequest, onResponse, and onError, and replaced super.onRequest(...) with handler.next(options) so the generated interceptor passes the request through explicitly

Changed

• Improved make:interceptor Metro stub: added docstrings for onRequest, onResponse, and onError, and replaced super.onRequest(...) with handler.next(options) so the generated interceptor passes the request through explicitly

Changed

• Updated make:state_managed_widget Metro stub to use the new NyStateManaged API with baseState/id instead of stateName, simplifying the generated widget

Changed

• Updated make:state_managed_widget Metro stub to use the new NyStateManaged API with baseState/id instead of stateName, simplifying the generated widget

Changed

• Bump nylo_support dependency from ^7.26.1 to ^7.26.2
• Bump error_stack dependency from ^2.1.3 to ^2.1.4

Changed

• Bump nylo_support dependency from ^7.26.1 to ^7.26.2
• Bump error_stack dependency from ^2.1.3 to ^2.1.4

Changed

• Bump nylo_support dependency from ^7.26.0 to ^7.26.1
• Bump collection dependency from ^1.18.0 to ^1.19.1
• Bump patrol dependency from ^4.5.0 to ^4.6.0

Changed

• Bump nylo_support dependency from ^7.26.0 to ^7.26.1
• Bump collection dependency from ^1.18.0 to ^1.19.1
• Bump patrol dependency from ^4.5.0 to ^4.6.0

Added

• New make:deep_link_provider Metro command to scaffold a deep link provider pre-wired for Nylo's deep-link capture

Changed

• Bump nylo_support dependency from ^7.24.2 to ^7.26.0
• Raise minimum environment constraints to Dart ^3.10.7 and Flutter >=3.38.4
• Relax collection dependency constraint from ^1.19.1 to ^1.18.0

Changed

• Bump nylo_support dependency from ^7.24.1 to ^7.24.2
• Bump error_stack dependency from ^2.1.2 to ^2.1.3

Changed

• Bump nylo_support dependency from ^7.24.0 to ^7.24.1

Changed

• Bump nylo_support dependency from ^7.23.1 to ^7.24.0

Changed

• Bump nylo_support dependency from ^7.23.0 to ^7.23.1
• Bump error_stack dependency from ^2.1.1 to ^2.1.2

Changed

• Bump nylo_support dependency from ^7.22.0 to ^7.23.0
• Updated make:state_managed_widget stub to use the new NyStateManaged base widget, enabling multi-instance state isolation via stateName

Changed

• Bump nylo_support dependency from ^7.21.0 to ^7.22.0

Changed

• Bump nylo_support dependency from ^7.20.2 to ^7.21.0

Changed

• Bump nylo_support dependency from ^7.20.0 to ^7.20.2
• Bump error_stack dependency from ^2.0.1 to ^2.1.1

Changed

• Bump nylo_support dependency from ^7.19.0 to ^7.20.0

Changed

• Bump nylo_support dependency from ^7.18.1 to ^7.19.0

Changed

• Bump nylo_support dependency from ^7.16.0 to ^7.18.1

Changed

• Remove --force flag from make:key command, now always overwrites existing APP_KEY
• Page with controller stub now sets stateManaged to false by default

Changed

• Remove --force flag from make:env command, now always overwrites existing env.g.dart

Changed

• Bump nylo_support dependency from ^7.14.0 to ^7.14.1

Changed

• Bump nylo_support dependency from ^7.13.0 to ^7.14.0

Changed

• Bump nylo_support dependency from ^7.12.0 to ^7.13.0

Changed

• Page stub now sets stateManaged to false by default for newly scaffolded pages

Added

• Subdirectory support for all make:* Metro commands — users can now specify paths like make:stateless_widget login/BrandPanel to organize generated files into subdirectories
• Tests for subdirectory parsing, stub generation, and file path creation across all make commands

Changed

• Bump nylo_support dependency from ^7.11.2 to ^7.12.0
• Bump patrol dependency from ^4.3.0 to ^4.5.0

Changed

• Bump nylo_support dependency from ^7.11.1 to ^7.11.2

Changed

• Bump nylo_support dependency from ^7.10.0 to ^7.11.1
• Bump flutter_local_notifications dependency from ^20.1.0 to ^21.0.0

Changed

• Bump nylo_support dependency from ^7.9.1 to ^7.10.0
• Bump patrol dependency from ^4.2.0 to ^4.3.0

Changed

• Bump nylo_support dependency from ^7.9.0 to ^7.9.1

Changed

• Bump nylo_support dependency from ^7.8.1 to ^7.9.0
• Bump patrol dependency from ^4.1.1 to ^4.2.0

Changed

• Bump nylo_support dependency from ^7.7.0 to ^7.8.1
• Bump skeletonizer dependency from ^2.1.2 to ^2.1.3
• Bump flutter_local_notifications dependency from ^20.0.0 to ^20.1.0
• Bump dio dependency from ^5.9.0 to ^5.9.2
• Bump error_stack dependency from ^2.0.0 to ^2.0.1
• Bump patrol dependency from ^4.1.0 to ^4.1.1

Changed

• Bump nylo_support dependency from ^7.6.0 to ^7.7.0

Changed

• Bump nylo_support dependency from ^7.5.0 to ^7.6.0

Changed

• Simplify API service stub constructor by removing BuildContext parameter -- generated API services now use a no-argument constructor with super(decoders: modelDecoders)
• Remove package:flutter/material.dart import from API service stub since BuildContext is no longer needed

Fixed

• Fix malformed import statement in API service stub (duplicate import ' prefix)

Changed

• Bump nylo_support dependency from ^7.4.0 to ^7.5.0

Changed

• Bump nylo_support dependency from ^7.3.1 to ^7.4.0

Changed

• Bump nylo_support dependency from ^7.3.0 to ^7.3.1

Changed

• Bump nylo_support dependency from ^7.2.0 to ^7.3.0
• Refine Metro CLI library directive to library nylo_framework.metro for clearer sub-library naming

Added

• Dartdoc comment for JsonDef.customObjectString getter

Changed

• Add explicit return types to NyCustomCommand methods: runProcess() returns Future<int>, addPackage() and addPackages() return Future<void>, info(), error(), success(), and warning() return void
• Add explicit List<String> parameter type to all Metro main() entry points and explicit dynamic type to NyJson.tryDecode(), Test.fromJson()
• Update form stub init example to use define() and FormCollection.from() for field configuration
• Bump nylo_support dependency from ^7.1.0 to ^7.2.0
• Add lints: ^6.1.0 dev dependency and analysis_options.yaml with package:lints/core.yaml
• Improve NyTheme.set() doc comments for clarity

Added

• Comprehensive dartdoc comments across all public APIs: NyCustomCommand, ConsoleSpinner, ConsoleTable, ConsoleProgressBar, ApiService, exception classes, CommandBuilder, CommandResult, ClassType, DartCodeGenerator, JsonDef, ValueDef, ListInner, and string extension helpers
• Library-level documentation for nylo_framework and Metro CLI

Fixed

• Fix event stub listener parameter name from event to data for clarity
• Add missing {super.key} to navigation hub stub constructor

Added

• New modular command system - All Metro CLI commands are now individual classes under lib/metro/commands/make/, each extending NyCustomCommand with a builder pattern. Commands are registered in built_in_commands.dart as a simple map lookup
• make:bottom_sheet_modal command - Generate bottom sheet modal widgets with auto-registration in bottom_sheet_modals.dart
• make:button command - Generate button widgets with auto-registration in the Button class
• make:env command - Generate an encrypted env.g.dart file from your .env file using XOR encryption with APP_KEY. Supports --dart-define mode for build-time key injection
• make:key command - Generate a secure 32-character APP_KEY for environment variable encryption
• New env_stub.dart - Stub for generating encrypted environment configuration class with automatic type parsing and caching
• New bottom_sheet_modal_stub.dart - Stub for generating bottom sheet modal widgets and their static registration methods
• New button_stub.dart - Stub for generating button widgets and their static registration methods
• New lib/metro/helpers/metro_helpers.dart - Extracted NyJson helper class and createNyloModel helper function
• New lib/app/ directory - Added app directory structure with example model
• Extensive new helper methods in NyCustomCommand:
  • Output helpers: line(), newLine(), comment(), alert()
  • File system helpers: fileExists(), directoryExists(), readFile(), readFileSync(), writeFile(), writeFileSync(), appendFile(), ensureDirectory(), deleteFile(), copyFile()
  • Environment helpers: env(), isWindows, isMacOS, isLinux, workingDirectory
  • Input helpers: ask() (alias for prompt), promptSecret() for hidden input
  • Control flow: abort() to exit with error
  • Table display: table() with ConsoleTable class for formatted ASCII tables
  • Progress bar: progressBar() with ConsoleProgressBar class
  • String case conversion: snakeCase(), camelCase(), pascalCase(), titleCase(), kebabCase(), constantCase()
  • Flutter project path helpers: modelsPath, controllersPath, widgetsPath, pagesPath, commandsPath, configPath, providersPath, eventsPath, networkingPath, themesPath, projectPath()
  • File scaffolding: scaffold(), scaffoldMany() with ScaffoldFile class
  • JSON/YAML helpers: readJson(), readJsonArray(), writeJson(), appendToJsonArray(), readYaml()
  • Dart/Flutter command helpers: dartFormat(), dartAnalyze(), flutterPubGet(), flutterClean(), flutterBuild(), flutterTest()
  • Dart file manipulation: addImport(), insertBeforeClosingBrace(), fileContains(), fileContainsPattern()
  • Directory helpers: listDirectory(), findFiles(), deleteDirectory(), copyDirectory()
  • Validation: isValidDartIdentifier(), requireArgument(), cleanClassName(), cleanFileName()
  • Task runner: runTasks(), runTasksWithSpinner() with CommandTask class
• New ConsoleTable class - Renders formatted ASCII tables with box-drawing characters and bold headers
• New ConsoleProgressBar class - Displays progress bars with percentage tracking, tick/update/complete controls
• New SpinnerExtension methods - withProgress() and withProgressSync() for processing lists with progress bars
• New ScaffoldFile class - Data class for batch file scaffolding operations
• New CommandTask class - Data class for task runner operations with optional stop-on-error
• CommandResult.hasHelpFlag and hasForceFlag convenience getters
• New flutter_local_notifications export in nylo_framework.dart
• New dependency: patrol (^4.1.0) for testing
• New dependency: yaml (^3.1.3) for YAML file parsing
• New dependency: rename (^3.1.0) as dev dependency
• New executables section in pubspec.yaml - metro: main for direct CLI invocation
• Comprehensive test suite - New test directories: test/commands/, test/console/, test/json_dart_generator/, test/metro/, test/stubs/ with tests for command builder, console components, spinner, JSON processing, scaffold files, menu display, stubs, and API exceptions
• NyTheme class overhaul - New static methods: currentId(), current(), themeData(), isDark(), colors<T>(), setFollowSystem(), isFollowingSystem(), getById(), all(), lightThemes(), darkThemes(), getByType(), setPreferredDark(), setPreferredLight(), preferredDarkId(), preferredLightId(), clearSavedTheme()
• NyTheme.set() now supports remember parameter - Sets preferred theme for system theme following

Changed

• Metro CLI entry point (bin/main.dart) rewritten - Now uses direct command map lookup via builtInCommands instead of routing through the old metro.dart monolithic handler. Shows menu on no arguments, supports custom command discovery
• Framework exports simplified (lib/nylo_framework.dart) - Replaced 18+ individual nylo_support exports with single export 'package:nylo_support/ny_core.dart' re-export
• NyCustomCommand.run() is now async (Future<void> run()) and properly awaits handle()
• NyCustomCommand exports updated - Now exports from package:nylo_support/metro/ny_metro.dart and /metro/helpers/metro_helpers.dart instead of multiple individual support package paths
• CommandBuilder constructor - No longer auto-adds --help flag by default
• CommandResult return types made nullable - getString(), getBool(), getInt() now return nullable types with nullable defaults instead of non-nullable with required defaults
• Provider stub updated - boot() renamed to setup(), afterBoot() replaced with boot() (called after all providers are setup)
• Route guard stub updated - onRequest(PageRequest) replaced with onBefore(RouteContext) returning Future<GuardResult>, with new context helpers (context.data, context.queryParameters, context.routeName, context.context)
• Form stub updated - NyFormData renamed to NyFormWidget, constructor uses super.key, super.submitButton, super.onSubmit, super.onFailure. Fields use FormCollection.fromArray() for picker options, validator instead of validate, removed style: "compact". Added static NyFormActions getter
• API service stub updated - Import path changed from /config/decoders.dart to /bootstrap/decoders.dart, added interceptors getter override
• Config stub updated - Now generates a final class with static members instead of loose comments, docs link updated to 7.x
• Custom command stub updated - Simplified usage docs (removed duplicate terminal/metro instructions)
• Navigation hub stub rewritten - Now accepts layoutBuilder, imports, and navigationEntries parameters. Layout uses layout(BuildContext context) method instead of property assignment. Added initialIndex override. Navigation pages use a synchronous map constructor super(() => {...}) instead of async
• Navigation hub creation (make:navigation_hub) - Now interactive: prompts for layout type (navigation_tabs or journey_states) and child names. Generates hub and child widgets under organized folder structure (navigation_hubs/<hub>/tabs/ or navigation_hubs/<hub>/states/)
• Journey state stub improved - New isLastStep parameter. Last step gets onJourneyComplete callback. Navigation buttons (Back/Continue) now built inline. Removed onCannotContinue() and onAfterNext() overrides. Updated to use nextStep instead of onNextPressed
• Model stub formatting - Removed extra blank lines for cleaner output
• State managed widget stub updated - Added static action() method for easier state action invocation. Updated example comments to use new Follow.action() pattern. Simplified init to synchronous
• Stateful widget stub updated - widgetStatefulStub() now accepts optional content parameter
• NyTheme.set() is now async and delegates to NyThemeManager.instance.setTheme() instead of ThemeProvider
• JSON dart generator fixes - findCustomObject() now returns nullable ValueDef? with proper null checks, isStructSame handles empty list comparison, _summarizeData list merging fixed with proper nonNulls.toList() chain, fromJson uses correct key reference
• README.md - All documentation links updated from 6.x to 7.x
• LICENSE - Copyright year updated to 2026
• pubspec.yaml updates:
  • Repository URL updated to 7.x branch
  • nylo_support dependency changed to path reference (path: ../support)
  • skeletonizer updated to ^2.1.2
  • error_stack updated to ^2.0.0
  • Added flutter_local_notifications: ^20.0.0
  • Added yaml: ^3.1.3
  • Added patrol: ^4.1.0
  • Added rename: ^3.1.0 (dev dependency)
  • Added executables section with metro: main
  • Added uses-material-design: true

Removed

• lib/metro/metro.dart - Monolithic 1,400+ line command handler replaced by modular command classes
• lib/cli_dialog/ directory - Entire CLI dialog library removed (7 files: cli_dialog.dart, dialog.dart, keys.dart, list_chooser.dart, services.dart, stdin_service.dart, stdout_service.dart, xterm.dart)
• lib/metro/stubs/theme_stub.dart - Theme generation stub removed
• lib/metro/stubs/theme_colors_stub.dart - Theme colors generation stub removed
• lib/metro/stubs/network_method_stub.dart - Network method stub removed
• lib/metro/stubs/postman_api_service_stub.dart - Postman API service stub removed
• make:theme command - Removed from Metro CLI menu
• NyCustomCommand.makeFile() method - Removed in favor of scaffold() and writeFile() helpers
• theme_provider dependency - Replaced by NyThemeManager from nylo_support
• flutter_secure_storage dependency - Removed from direct exports
• flutter_dotenv dependency - Removed (replaced by encrypted env system)
• Individual nylo_support exports - 18+ individual exports replaced by single ny_core.dart barrel export
• nyloVersion updated from v6.9.2 to v7.0.0

• Fix controller stub
• Update state managed stub
• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates

• pubspec.yaml updates