schemantic
A lightweight library for type-safe data classes and runtime JSON Schemas, with built-in serialization and validation.
0.2.2
22K downloads/mo
#2102 most downloaded on pub.dev
genkit-ai/genkit-dart
What this package is like to depend on
Last release 1 months ago
17 Jul 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 7 of 7 stable releases
Nothing withdrawn
no release was ever pulled
7 months old
25 releases · first in 2026
25 releases in the last 12 months
see the full history below
Release timeline
25 releases · Jan 2026 to Jul 2026Releases
latest 25-
0.2.217 Jul 2026 -
0.2.117 Jul 2026 -
0.2.004 Jun 2026Release notes
Open source →- BREAKING REFACTOR: moved vertexAI plugin from genkit_google_genai into genkit_vertexai package (#202).
Release notes
Open source →Fixes
- correctly escape '$ref' in
allOfcase (#291)
Other Changes
- update model references to gemini-flash-latest (#293)
- split schemantic into runtime and schemantic_builder packages (#292)
-
0.2.0-rc.003 Jun 2026 pre-releaseNothing published for this version
-
0.1.306 May 2026Release notes
Open source →Features
- widen analyzer dependency range to include v13 (#277)
- generate docs for generated schemantic types (#274)
-
0.1.229 Apr 2026Release notes
Open source →Features
- add additionalProperties support to @Schema and implement strict object validation (#251)
Fixes
- support the latest pkg:analyzer in pkg:schemantic (#236)
Other Changes
- Add tests for SchemanticType.from's ad-hoc schema parsing and custom type integration. (#224)
-
0.1.119 Mar 2026Release notes
Open source →Features
- added support for bring-your-own-type and schema with schemantic (#223)
Fixes
- correctly handle enums in the generated constructor (#220)
-
0.1.004 Mar 2026Release notes
Open source →2026-03-04
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
genkit-v0.10.0-dev.19genkit_mcp-v0.1.0-dev.1genkit_google_genai-v0.1.0-dev.1genkit_vertex_auth-v0.1.0-dev.1genkit_openai-v0.1.0-dev.1genkit_anthropic-v0.1.0-dev.1genkit_shelf-v0.1.0-dev.1genkit_chrome-v0.0.1-dev.10genkit_middleware-v0.1.0-dev.1
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
genkit_mcp-v0.1.0-dev.1genkit_google_genai-v0.1.0-dev.1genkit_vertex_auth-v0.1.0-dev.1genkit_openai-v0.1.0-dev.1genkit_anthropic-v0.1.0-dev.1genkit_shelf-v0.1.0-dev.1genkit_chrome-v0.0.1-dev.10genkit_middleware-v0.1.0-dev.1
Release notes
Open source →- Graduate package to a stable release. See pre-releases prior to this version for changelog entries.
-
0.1.0-dev.004 Mar 2026 pre-release -
0.0.1-dev.1903 Mar 2026 pre-releaseRelease notes
Open source →- FIX: conditionally add
toolUsePromptTokenCountto custom metadata.
2026-03-02
Changes
Packages with breaking changes:
genkit-v0.10.0-dev.18genkit_anthropic-v0.0.1-dev.9genkit_google_genai-v0.0.1-dev.18genkit_mcp-v0.0.1-dev.7genkit_middleware-v0.0.1-dev.7genkit_openai-v0.0.1-dev.7genkit_shelf-v0.0.1-dev.18schemantic-v0.0.1-dev.19
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
genkit_chrome-v0.0.1-dev.9
Release notes
Open source →Note: This release has breaking changes.
- REFACTOR: Tweak RegExps and avoid non-linear complexity (#175).
- REFACTOR: make all classes
finalorbase(#179). - FEAT: introduce Genkit evaluation functionality (#191).
- BREAKING REFACTOR: Remove
SchemaHelpersutility class (#180). - BREAKING REFACTOR: renamed @Schematic() to @Schema() (#192).
- FIX: conditionally add
-
0.0.1-dev.1827 Feb 2026 pre-releaseRelease notes
Open source →- REFACTOR: migrate Vertex AI authentication to use the
genkit_vertex_auth(#193). - REFACTOR(google_genai): switch to rest api (#183).
- REFACTOR: make all classes
finalorbase(#179). - FEAT(genkit_google_genai): implemented vertexai support (#184).
- BREAKING REFACTOR: renamed @Schematic() to @Schema() (#192).
- BREAKING FEAT: introduced dynamic action provider and migrated MCP plugin to use DAP (#187).
Release notes
Open source →Note: This release has breaking changes.
- REFACTOR: hide package:json_schema_builder (#167).
- REFACTOR: Internal Dart style tweaks (#156).
- FIX: make static helper classes abstract final (#173).
- FIX: enable and fix a couple of lints (#174).
- FIX: be consistent with String quotes (#164).
- BREAKING FEAT: move basic type functions to static creation method on SchemanticType (#154).
- REFACTOR: migrate Vertex AI authentication to use the
-
0.0.1-dev.1619 Feb 2026 pre-releaseRelease notes
Open source →- REFACTOR: Introduce a dedicated plugin.dart entry point for plugin-related exports (#149).
- REFACTOR: remove GoogleSearchRetrieval option (deprecated) (#147).
Release notes
Open source →- FIX: correct string interpolation in
FormatExceptionmessages. - FEAT: implemented/fixed tools calling and structured output for firebase_ai (#138).
-
0.0.1-dev.1517 Feb 2026 pre-releaseRelease notes
Open source →- FEAT: Add remote model support and enable serving actions via shelf (#143).
2026-02-18
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
genkit-v0.10.0-dev.14genkit_anthropic-v0.0.1-dev.5genkit_google_genai-v0.0.1-dev.14genkit_openai-v0.0.1-dev.3genkit_shelf-v0.0.1-dev.14schemantic-v0.0.1-dev.16genkit_mcp-v0.0.1-dev.3genkit_chrome-v0.0.1-dev.5genkit_middleware-v0.0.1-dev.3
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
genkit_mcp-v0.0.1-dev.3genkit_chrome-v0.0.1-dev.5genkit_middleware-v0.0.1-dev.3
-
0.0.1-dev.1412 Feb 2026 pre-releaseRelease notes
Open source →- REFACTOR: automate telemetry exporter configuration (#131).
- DOCS: added skills (#132).
-
0.0.1-dev.1305 Feb 2026 pre-releaseRelease notes
Open source →- REFACTOR: remove detailed token usage arrays from usage metadata and add tests for usage extraction. (#127).
- FEAT: Implemented real-time tracing (#128).
- BREAKING REFACTOR: generate api cleanup (#125).
Release notes
Open source →- FIX: Coerce
numvalues todoublefor generated double fields during JSON parsing. (#65). - FEAT: Add
$GenerateResponsetype, refine schema types, and update generated class constructors to uselate finaland regular constructors. (#66).
-
0.0.1-dev.1230 Jan 2026 pre-releaseRelease notes
Open source →- REFACTOR: Identify schema types using a new
Type.isSchemagetter instead of string-based checks. - FEAT: updated AnyOf support for union types in Schemantic, including helper class generation and schema type handling. (#62).
- REFACTOR: Identify schema types using a new
-
0.0.1-dev.1130 Jan 2026 pre-releaseRelease notes
Open source →- FIX: Coerce
numvalues todoublefor generated double fields during JSON parsing. (#65). - FEAT: add Google Search and multi-speaker voice config support, extract usage metadata, and introduce reasoning parts (#82).
- FEAT: Add
$GenerateResponsetype, refine schema types, and update generated class constructors to uselate finaland regular constructors. (#66). - FEAT: added schemas for gemini models, made sure TTS and nano banana models are working (#63).
- BREAKING REFACTOR: update GenkitException to use a StatusCodes enum instead of raw integer status codes. (#68).
Release notes
Open source →Note: This release has breaking changes.
- REFACTOR: reimplement schema generation from extension types to classes, enhance
PartExtensiongetters, and simplifyGenerateResponseand tool invocation. (#53). - FEAT: Add support for specifying default values for schema fields and types, and generate them in the JSON Schema. (#61).
- FEAT:
AnyOfsupport and simplified license headers (#59). - FEAT: use combining builder and header option (#52).
- FEAT: allow referencing other schemas when using
Schemaschematic (#46). - BREAKING REFACTOR: removed support for generation from jsb Schema defs (#48).
- BREAKING FEAT: implement Schemantic API redesign with $ prefixed schema definitions and static
$schemafor unified schema access. (#60).
- FIX: Coerce
-
0.0.1-dev.919 Jan 2026 pre-releaseRelease notes
Open source →- REFACTOR: make all classes
finalorbase(#179). - FEAT(openai): add Vertex support with shared Vertex auth utilities (#185).
- FEAT(anthropic): add Vertex AI transport and sample app (#182).
- BREAKING REFACTOR: renamed @Schematic() to @Schema() (#192).
Release notes
Open source →Note: This release has breaking changes.
- FEAT: Enable schema generation from final Schema variables (#45).
- BREAKING REFACTOR: renamed JsonExtensionType to SchemanticType (#44).
- REFACTOR: make all classes
-
0.0.1-dev.818 Jan 2026 pre-releaseRelease notes
Open source →- REFACTOR: hide package:json_schema_builder (#167).
- FIX: do not default instructions for json format (should use native constrained generation) (#176).
- FIX: fix strict casts (#165).
- BREAKING FEAT: move basic type functions to static creation method on SchemanticType (#154).
-
0.0.1-dev.716 Jan 2026 pre-releaseRelease notes
Open source →- REFACTOR: Tweak RegExps and avoid non-linear complexity (#175).
- REFACTOR: make all classes
finalorbase(#179). - REFACTOR: centralize status-to-http mapping for transport errors (#181).
- BREAKING REFACTOR: renamed @Schematic() to @Schema() (#192).
- BREAKING FEAT: introduced dynamic action provider and migrated MCP plugin to use DAP (#187).
Release notes
Open source →Note: This release has breaking changes.
- BREAKING FEAT: Refactor basic types into factory functions to support schema constraints (#34).
-
0.0.1-dev.616 Jan 2026 pre-releaseRelease notes
Open source →- REFACTOR: hide package:json_schema_builder (#167).
- FIX: enable and fix a couple of lints (#174).
- FIX: fix strict casts (#165).
- FIX: better generics (#153).
- FIX: fix a couple of dartdoc issues (#151).
- BREAKING FEAT: move basic type functions to static creation method on SchemanticType (#154).
Release notes
Open source →Note: This release has breaking changes.
- REFACTOR: move the package-specific schema generator into a peer package (#31).
- FEAT: Add specialized
StringField,IntegerField, andNumberFieldannotations for detailed JSON schema constraint generation with type validation. (#32). - DOCS: add dynamic list and map type demonstrations.
- BREAKING REFACTOR: renamed @Key annotation to @Field (#30).
-
0.0.1-dev.516 Jan 2026 pre-releaseRelease notes
Open source →- REFACTOR: Introduce a dedicated plugin.dart entry point for plugin-related exports (#149).
Release notes
Open source →- REFACTOR: make generated JsonExtensionType factory classes (*TypeFactory) private (#29).
- FEAT: added support for defining listType and mapType in schemantic (#28).
-
0.0.1-dev.416 Jan 2026 pre-release -
0.0.1-dev.316 Jan 2026 pre-releaseRelease notes
Open source →- REFACTOR: automate telemetry exporter configuration (#131).
- DOCS: Add best practices, a Text-to-Speech example, and update the OpenAI package license to the full Apache 2.0 text.
-
0.0.1-dev.216 Jan 2026 pre-releaseRelease notes
Open source →- FEAT(openai): add Vertex support with shared Vertex auth utilities (#185).
2026-02-27
Changes
Packages with breaking changes:
genkit-v0.10.0-dev.17genkit_anthropic-v0.0.1-dev.8genkit_google_genai-v0.0.1-dev.17genkit_mcp-v0.0.1-dev.6genkit_middleware-v0.0.1-dev.6genkit_openai-v0.0.1-dev.6genkit_shelf-v0.0.1-dev.17schemantic-v0.0.1-dev.18
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
genkit_chrome-v0.0.1-dev.8
Release notes
Open source →Note: This release has breaking changes.
- BREAKING REFACTOR: renamed genkit_schema_builder package to schemantic (#26).