terradart_core 0.26.0

terradart core runtime — Stack, Resource, Provider, Variable, Data, TfArg, TfRef, and LifecycleOptions for Dart-first Terraform synthesis.

terradart_core

Core runtime for TerraDart — a Dart-first infrastructure-as-code layer for Terraform that produces drop-in main.tf.json for the standard terraform CLI.

This package ships the small set of primitives every TerraDart Stack uses:

• Stack — abstract base for your infrastructure module. You subclass it (final class MyStack extends Stack), register Resource / Data instances via add(...) / addData(...), and call stack.writeTo('tf-out') from your own main() to emit main.tf.json.
• Resource / Data — typed nodes supplied by provider factory packages.
• TfArg.literal(...) / TfArg.ref(...) — the only two ways every settable field accepts input. TfArg<MyEnum>.literal(MyEnum.foo) encodes typed Dart enums (see below).
• LifecycleOptions — create_before_destroy, prevent_destroy, ignore_changes, replace_triggered_by.
• Stack.synth() returns an in-memory SynthResult with tfJson (Terraform JSON map) and optional dartConstants (typed Dart constants for the IaC ↔ application seam). Stack.writeTo(outDir) is the file-IO wrapper that calls synth() and writes main.tf.json (plus any dartConstants) under outDir.

This package is the runtime layer only. It is intentionally small and dependency-free.

Companion packages

Package	Description
terradart_google	Curated factory wrappers for Google Cloud resources (hashicorp/google).
terradart_google_beta	Curated factory wrappers for beta-only Google Cloud resources (hashicorp/google-beta).
terradart_appwrite	Curated factory wrappers for Appwrite resources (appwrite/appwrite).
terradart_cloudflare	Curated factory wrappers for Cloudflare resources (cloudflare/cloudflare).
terradart_agent	MCP server (terradart-mcp) exposing the curated factory catalog to AI agents.
terradart_codegen	Maintainer generation tooling and CLI (terradart wrap).

For project-level documentation, see the terradart repo README and terradart.dev.

Installation

dependencies:
  terradart_core: ^0.26.x

Check pub.dev for the latest patch. Read MIGRATING.md before minor bumps.

Typed enum serialization

Hand-rolled and wrap-emitted enums implement TerraformEnum with a terraformValue getter. TfArgLiteral.toTfJson() encodes them to Terraform strings; missing conventions throw ArgumentError at synth time.

enum RoutingMode implements TerraformEnum {
  regional('REGIONAL'),
  global('GLOBAL');

  const RoutingMode(this.terraformValue);
  @override
  final String terraformValue;
}