# Ack — branch-local API index > Dart/Flutter schema validation, codecs, JSON Schema, and optional code generation. This checkout documents Ack 2.0.0-beta.3. Read the local files linked below so examples match the checked-out version. Package `pubspec.yaml` files own SDK and dependency constraints. ## Find the owning guide - [Core concepts and packages](https://github.com/btwld/ack/blob/main/README.md) - [Architecture choices and superseded designs](https://github.com/btwld/ack/blob/main/ARCHITECTURE.md) - [Agent workflow and generator safeguards](https://github.com/btwld/ack/blob/main/AGENTS.md) - [Installation](https://github.com/btwld/ack/blob/main/docs/getting-started/installation.mdx) - [Schema types and composition](https://github.com/btwld/ack/blob/main/docs/core-concepts/schemas.mdx) - [Presence, null, defaults, configuration](https://github.com/btwld/ack/blob/main/docs/core-concepts/configuration.mdx) - [Validation](https://github.com/btwld/ack/blob/main/docs/core-concepts/validation.mdx) - [Errors and safe parsing](https://github.com/btwld/ack/blob/main/docs/core-concepts/error-handling.mdx) - [Codecs and encoding](https://github.com/btwld/ack/blob/main/docs/core-concepts/codecs.mdx) - [JSON serialization](https://github.com/btwld/ack/blob/main/docs/core-concepts/json-serialization.mdx) - [Model code generation](https://github.com/btwld/ack/blob/main/docs/core-concepts/typesafe-schemas.mdx) - [Generator limitations and JSON Schema codegen](https://github.com/btwld/ack/blob/main/packages/ack_generator/README.md) - [JSON Schema import/export](https://github.com/btwld/ack/blob/main/docs/guides/json-schema-integration.mdx) - [Using ecosystem adapters](https://github.com/btwld/ack/blob/main/docs/guides/ecosystem-integrations.mdx) - [Writing an adapter](https://github.com/btwld/ack/blob/main/docs/guides/creating-schema-converter-packages.mdx) - [1.x to 2.0 migration and removed symbols](https://github.com/btwld/ack/blob/main/docs/getting-started/migration-guide.mdx) - [API quick reference](https://github.com/btwld/ack/blob/main/docs/api-reference/index.mdx) - [Contribution checks](https://github.com/btwld/ack/blob/main/CONTRIBUTING.md) and [release runbook](https://github.com/btwld/ack/blob/main/PUBLISHING.md) ## Contracts easy to miss - `AckSchema` distinguishes wire data from Dart runtime values. Parsing decodes; encoding validates and converts back. One-way transforms are runtime parse helpers and cannot back generated models that must encode. - `safeParse` returns `SchemaResult`; programmer `Error` values in callbacks can still propagate. Use the error-handling guide for the failure contract. - `optional` permits an omitted key; `nullable` permits a present null. Use `JsonMaybe` when a class must preserve omitted versus explicit-null keys. - `@Schemable`, `@AckKey`, and the `Is…`/`Has…` rule annotations (`@IsRequired`, `@HasMinLength`, `@IsEmail`, …) come from `package:ack/ack.dart`. The `Validate` namespace is deprecated and removed before Ack 2.0.0. Generation uses one `part '.g.dart';` and `dart run build_runner build`. There is no `@AckSchema` annotation. - Generated constructors are unchecked. Use `parse`/`fromJson` for untrusted input; generated JSON encoding validates. Hand-written constructors own any defensive copying required for direct construction. - Generated models store typed fields or a `.value`; they do not implement Map, List, or scalar interfaces. The model-generation guide owns supported shapes, custom schema resolution, recursion, and unknown-property policies. - `Ack.preserveBoundary` validates through the inner object parser but returns a detached immutable copy of the original JSON map, without invoking an encoder. Inner defaults do not materialize into that copy. - Native schemas export Draft-7. Imported 2020-12 resources are preserved by default; request Draft-7 lowering explicitly and handle unsupported conversion. Formats are annotations unless assertion is requested or required by the dialect. - Non-JSON adapters traverse `AckSchemaModel`; JSON-map adapters can use `toJsonSchema()`. Imported raw resources and references need explicit support. - MCP adapters validate typed inputs; callbacks own outputs. Firebase's adapter passes JSON Schema through for `responseJsonSchema`, without provider-specific keyword normalization. Validate generated or received data with Ack. Keep API examples and substitution tables in their owning guides. When a public contract changes, update that guide and the index only where its links or sharp limitations change. Preserve decision history in ARCHITECTURE.md.