Skip to main content

jetleaf_tools 1.0.1 copy "jetleaf_tools: ^1.0.1" to clipboard
jetleaf_tools: ^1.0.1 copied to clipboard

Build, runtime scanning, code generation, and developer tooling for the Jetleaf framework.

example/lib/main.dart

// ignore_for_file: avoid_print, implementation_imports

import 'dart:io';

import 'package:jetleaf_tools/jetleaf_tools.dart';
import 'package:jetleaf_tools/src/cache/indexer/declaration_builder.dart';
import 'package:jetleaf_tools/src/cache/indexer/file_discovery.dart';

// ============================================================================
// 1. SAMPLE TARGET FOR RUNTIME EXECUTOR
// ============================================================================

class OrderProcessor {
  final String region;
  int processedCount = 0;

  OrderProcessor({this.region = 'US-EAST'});

  String processOrder(String orderId, double amount) {
    processedCount++;
    return 'Order #$orderId for \$$amount processed in region $region';
  }
}

// ============================================================================
// 2. MAIN ENTRYPOINT: BUILD & TOOLING DEMO
// ============================================================================

void main() async {
  print('========================================================');
  print('  🛠️  Jetleaf Tools 1.0.0 Feature Showcase');
  print('========================================================');

  // --- A. AST Declaration Analysis ---
  print('\n[1] AST Codebase Analysis (DeclarationBuilder):');
  final tempDir = Directory.systemTemp.createTempSync('jetleaf_tools_demo_');
  final libDir = Directory('${tempDir.path}/lib')..createSync(recursive: true);

  try {
    // Generate a sample Dart source file for static indexing
    final sampleFile = File('${libDir.path}/service.dart');
    sampleFile.writeAsStringSync('''
library demo.service;

abstract class BaseEntity {
  final String id;
  BaseEntity(this.id);
}

class InvoiceService extends BaseEntity {
  final String taxAuthority;
  int invoiceCount = 0;

  InvoiceService(String id, {this.taxAuthority = "IRS"}) : super(id);

  bool issueInvoice(String client, double total) {
    invoiceCount++;
    return total > 0;
  }
}
''');

    // Discover files
    final discovery = FileDiscovery(tempDir);
    final files = await discovery.discover(
      skipTests: true,
      packagesToExclude: [],
      packagesToScan: [],
      filesToExclude: [],
    );

    print('  Discovered ${files.length} source file(s) for indexing.');

    // Build declarations using the AST analyzer
    final builder = DeclarationBuilder();
    final declarations = await builder.build(
      files: files,
      packageName: 'demo_app',
    );

    print('  Extracted ${declarations.length} class component(s):');
    for (final decl in declarations) {
      print('    - Class: ${decl.getName()}');
      print('      Supertype: ${decl.getSuperClass()?.getName() ?? "Object"}');
      print('      Constructors (${decl.getConstructors().length}):');
      for (final ctor in decl.getConstructors()) {
        final ctorName = ctor.getName().isEmpty ? '(default)' : ctor.getName();
        final params = ctor.getParameters().map((p) => '${p.getType()} ${p.getName()}').join(', ');
        print('        • $ctorName($params)');
      }
      print('      Methods (${decl.getMethods().length}):');
      for (final method in decl.getMethods()) {
        print('        • ${method.getReturnType()} ${method.getName()}()');
      }
      print('      Fields (${decl.getFields().length}):');
      for (final field in decl.getFields()) {
        print('        • ${field.getType()} ${field.getName()}');
      }
    }

    // --- B. Runtime Manifest Generation ---
    print('\n[2] Runtime Manifest Serialization:');
    final manifest = RuntimeManifest(
      fingerprint: 'demo_fingerprint_hash_abc123',
      forTests: false,
      treeShakingEnabled: true,
      generatedAt: DateTime.now().toUtc(),
      componentQualifiedNames: declarations.map((d) => d.getName()).toList(),
      libraryUris: ['package:demo_app/service.dart'],
      packageNames: ['demo_app'],
      assetPaths: [],
      subclassIndex: [],
      annotatedMethods: [],
      runtimeHints: [],
    );
    print('  Manifest generated with ${manifest.componentQualifiedNames.length} components.');
    print('  Serialized JSON summary:\n  ${manifest.toJson()}');

    // --- C. AOT Runtime Executor Dispatch ---
    print('\n[3] AOT Runtime Executor (Zero-Reflection Dispatch):');

    // Register AOT constructor factory
    AotRuntimeExecutor.registerNamedConstructor('OrderProcessor', ([argument]) {
      final named = argument?.getNamedArguments() ?? {};
      final region = named['region'] as String? ?? 'US-WEST';
      return OrderProcessor(region: region);
    });

    // Register AOT method invoker
    AotRuntimeExecutor.registerMethod('OrderProcessor.processOrder', (inst, argument) {
      final pos = argument.getPositionalArguments();
      final processor = inst as OrderProcessor;
      return processor.processOrder(pos[0] as String, (pos[1] as num).toDouble());
    });

    // Register AOT field getter
    AotRuntimeExecutor.registerFieldGetter('OrderProcessor.processedCount', (inst) {
      return (inst as OrderProcessor).processedCount;
    });

    // Instantiate via AotRuntimeExecutor
    final instance = AotRuntimeExecutor.constructByName(
      'OrderProcessor',
      ExecutableArgument.unmodified({'region': 'EU-CENTRAL'}, const []),
    ) as OrderProcessor;

    print('  Instantiated: OrderProcessor(region: ${instance.region})');

    // Invoke method via executor
    final executor = AotRuntimeExecutor(DefaultRuntimeHintDescriptor());
    final result = executor.invokeMethod(
      instance,
      'processOrder',
      ExecutableArgument.unmodified(const {}, ['ORD-9901', 450.75]),
    );

    print('  Invoked processOrder: "$result"');

    final count = executor.getValue(instance, 'processedCount');
    print('  Field getValue (processedCount): $count');

    print('\n========================================================');
    print('  ✅ All Jetleaf Tools operations executed successfully!');
    print('========================================================');
  } finally {
    tempDir.deleteSync(recursive: true);
  }
}
0
likes
140
points
249
downloads

Documentation

Documentation
API reference

Publisher

verified publisherhapnium.com

Weekly Downloads

Build, runtime scanning, code generation, and developer tooling for the Jetleaf framework.

Homepage
Repository (GitHub)
View/report issues

Topics

#build #codegen #jetleaf #generator #tooling

License

BSD-2-Clause (license)

Dependencies

analyzer, frontend_server_client, meta, path, vm_service

More

Packages that depend on jetleaf_tools