codama-idl · codama-releases · Aug 27, 2026
diff --git a/.changeset/calm-moons-carry.md b/.changeset/calm-moons-carry.md
diff --git a/.changeset/eighty-crabs-decode.md b/.changeset/eighty-crabs-decode.md
diff --git a/.changeset/fancy-shrimps-exist.md b/.changeset/fancy-shrimps-exist.md
diff --git a/.changeset/open-banks-wash.md b/.changeset/open-banks-wash.md
diff --git a/.changeset/plain-taxis-transform.md b/.changeset/plain-taxis-transform.md
diff --git a/.changeset/slow-doodles-carry.md b/.changeset/slow-doodles-carry.md
diff --git a/.changeset/social-bats-travel.md b/.changeset/social-bats-travel.md
diff --git a/.changeset/sweet-pianos-glow.md b/.changeset/sweet-pianos-glow.md
diff --git a/.changeset/wacky-hairs-bathe.md b/.changeset/wacky-hairs-bathe.md
diff --git a/.changeset/wise-areas-see.md b/.changeset/wise-areas-see.md
diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/cli",
-    "version": "1.6.2",
+    "version": "1.6.3",
     "description": "A CLI for setting up and managing Codama IDLs",
     "keywords": [
         "cli",

diff --git a/packages/dynamic-address-resolution/package.json b/packages/dynamic-address-resolution/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/dynamic-address-resolution",
-    "version": "0.3.3",
+    "version": "1.0.0",
     "description": "Address resolution functionality for instruction accounts in Codama IDLs",
     "keywords": [
         "address-resolution",

diff --git a/packages/dynamic-client/package.json b/packages/dynamic-client/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/dynamic-client",
-    "version": "0.1.6",
+    "version": "1.0.0",
     "description": "Client to dynamically interact with Solana programs using Codama IDLs",
     "keywords": [
         "dynamic client",

diff --git a/packages/dynamic-codecs/package.json b/packages/dynamic-codecs/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/dynamic-codecs",
-    "version": "1.2.6",
+    "version": "1.3.0",
     "description": "Get codecs on demand for Codama IDLs",
     "keywords": [
         "codecs",

diff --git a/packages/dynamic-instructions/package.json b/packages/dynamic-instructions/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/dynamic-instructions",
-    "version": "0.4.1",
+    "version": "1.0.0",
     "description": "Runtime instruction creation for Codama IDLs",
     "keywords": [
         "framework",

diff --git a/packages/dynamic-parsers/package.json b/packages/dynamic-parsers/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/dynamic-parsers",
-    "version": "1.4.1",
+    "version": "1.4.2",
     "description": "Helpers to dynamically identify and parse accounts and instructions",
     "keywords": [
         "framework",

diff --git a/packages/errors/CHANGELOG.md b/packages/errors/CHANGELOG.md
@@ -1,5 +1,17 @@
 # @codama/errors
 
+## 1.11.0
+
+### Minor Changes
+
+- [#1095](https://github.com/codama-idl/codama/pull/1095) [`b418a9e`](https://github.com/codama-idl/codama/commit/b418a9e19b0b15a3dc1c79edb246d78694d6310e) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Add the `CODAMA_ERROR__UNSUPPORTED_VERSION` error code for Codama IDLs that predate the 1.0.0 specification. The `CODAMA_ERROR__VERSION_MISMATCH` message now points older versions at the `@codama/upgrade` package and newer versions at updating their Codama dependencies.
+
+### Patch Changes
+
+- [#1094](https://github.com/codama-idl/codama/pull/1094) [`abefbeb`](https://github.com/codama-idl/codama/commit/abefbeb3ae369b01a46794ca3824a23391548040) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Fix `validateCodamaVersion` to compare the document's version against the Codama spec version (`CODAMA_VERSION`) instead of the npm package version, which is an unrelated namespace and caused false mismatches whenever the two drifted apart. The function now accepts any string and narrows it to `CodamaVersion` on success, rejects unparsable versions, and no longer special-cases 0.x versions. The `CODAMA_ERROR__VERSION_MISMATCH` message is reworded accordingly.
+- Updated dependencies [[`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6), [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28), [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835)]:
+  - @codama/node-types@1.11.0
+
 ## 1.10.2
 
 ### Patch Changes

diff --git a/packages/errors/package.json b/packages/errors/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/errors",
-    "version": "1.10.2",
+    "version": "1.11.0",
     "description": "Error management for Codama",
     "keywords": [
         "framework",

diff --git a/packages/fragments/package.json b/packages/fragments/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/fragments",
-    "version": "0.1.5",
+    "version": "1.0.0",
     "description": "Composable code-generation fragments and language-aware import maps for Codama renderers",
     "keywords": [
         "codama",

diff --git a/packages/library/CHANGELOG.md b/packages/library/CHANGELOG.md
@@ -1,5 +1,17 @@
 # codama
 
+## 1.11.0
+
+### Patch Changes
+
+- [#1094](https://github.com/codama-idl/codama/pull/1094) [`abefbeb`](https://github.com/codama-idl/codama/commit/abefbeb3ae369b01a46794ca3824a23391548040) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Fix `validateCodamaVersion` to compare the document's version against the Codama spec version (`CODAMA_VERSION`) instead of the npm package version, which is an unrelated namespace and caused false mismatches whenever the two drifted apart. The function now accepts any string and narrows it to `CodamaVersion` on success, rejects unparsable versions, and no longer special-cases 0.x versions. The `CODAMA_ERROR__VERSION_MISMATCH` message is reworded accordingly.
+- Updated dependencies [[`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6), [`abefbeb`](https://github.com/codama-idl/codama/commit/abefbeb3ae369b01a46794ca3824a23391548040), [`362f618`](https://github.com/codama-idl/codama/commit/362f618127d6642b3ec09d3016cb801629b2aa53), [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28), [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835), [`b418a9e`](https://github.com/codama-idl/codama/commit/b418a9e19b0b15a3dc1c79edb246d78694d6310e)]:
+  - @codama/nodes@1.11.0
+  - @codama/errors@1.11.0
+  - @codama/visitors@1.11.0
+  - @codama/cli@1.6.3
+  - @codama/validators@1.11.0
+
 ## 1.10.2
 
 ### Patch Changes

diff --git a/packages/library/package.json b/packages/library/package.json
@@ -1,6 +1,6 @@
 {
     "name": "codama",
-    "version": "1.10.2",
+    "version": "1.11.0",
     "description": "A Solana framework for building standardised programs",
     "keywords": [
         "code generation",

diff --git a/packages/node-types/CHANGELOG.md b/packages/node-types/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @codama/node-types
 
+## 1.11.0
+
+### Patch Changes
+
+- [#1090](https://github.com/codama-idl/codama/pull/1090) [`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Update the generated node types and constructors to `@codama/spec@1.9.1`. Generated docblocks now carry the enriched spec documentation (strategy walkthroughs with buffer diagrams for the offset type nodes, serialisation caveats, and worked examples), the `CodamaVersion` type moves from `'1.8.0'` to `'1.9.1'`, and new documents created via `rootNode()` are stamped with version `1.9.1`.
+
+- [#1093](https://github.com/codama-idl/codama/pull/1093) [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Widen the `CodamaVersion` type from the exact pinned literal (`'1.9.1'`) to a major-pinned template literal (`1.${number}.${number}`), so any document of the current spec major type-checks as a `RootNode` rather than only documents carrying the exact pinned version. Add a `getCodamaVersionMajor(version)` helper to `@codama/nodes` that defensively extracts the major from an arbitrary version string, returning `null` when it cannot be parsed.
+
+- [#1099](https://github.com/codama-idl/codama/pull/1099) [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Bump the generated `CODAMA_VERSION` to 1.9.2 and refresh the generated documentation from the latest spec.
+
 ## 1.10.2
 
 ## 1.10.1

diff --git a/packages/node-types/package.json b/packages/node-types/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/node-types",
-    "version": "1.10.2",
+    "version": "1.11.0",
     "description": "Node specifications for the Codama standard",
     "keywords": [
         "framework",

diff --git a/packages/nodes-from-anchor/CHANGELOG.md b/packages/nodes-from-anchor/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @codama/nodes-from-anchor
 
+## 1.5.6
+
+### Patch Changes
+
+- Updated dependencies [[`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6), [`abefbeb`](https://github.com/codama-idl/codama/commit/abefbeb3ae369b01a46794ca3824a23391548040), [`362f618`](https://github.com/codama-idl/codama/commit/362f618127d6642b3ec09d3016cb801629b2aa53), [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28), [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835), [`b418a9e`](https://github.com/codama-idl/codama/commit/b418a9e19b0b15a3dc1c79edb246d78694d6310e)]:
+  - @codama/nodes@1.11.0
+  - @codama/errors@1.11.0
+  - @codama/visitors@1.11.0
+
 ## 1.5.5
 
 ### Patch Changes

diff --git a/packages/nodes-from-anchor/package.json b/packages/nodes-from-anchor/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/nodes-from-anchor",
-    "version": "1.5.5",
+    "version": "1.5.6",
     "description": "Node specifications and helpers for the Codama standard",
     "keywords": [
         "framework",

diff --git a/packages/nodes/CHANGELOG.md b/packages/nodes/CHANGELOG.md
@@ -1,5 +1,18 @@
 # @codama/nodes
 
+## 1.11.0
+
+### Patch Changes
+
+- [#1090](https://github.com/codama-idl/codama/pull/1090) [`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Update the generated node types and constructors to `@codama/spec@1.9.1`. Generated docblocks now carry the enriched spec documentation (strategy walkthroughs with buffer diagrams for the offset type nodes, serialisation caveats, and worked examples), the `CodamaVersion` type moves from `'1.8.0'` to `'1.9.1'`, and new documents created via `rootNode()` are stamped with version `1.9.1`.
+
+- [#1093](https://github.com/codama-idl/codama/pull/1093) [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Widen the `CodamaVersion` type from the exact pinned literal (`'1.9.1'`) to a major-pinned template literal (`1.${number}.${number}`), so any document of the current spec major type-checks as a `RootNode` rather than only documents carrying the exact pinned version. Add a `getCodamaVersionMajor(version)` helper to `@codama/nodes` that defensively extracts the major from an arbitrary version string, returning `null` when it cannot be parsed.
+
+- [#1099](https://github.com/codama-idl/codama/pull/1099) [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Bump the generated `CODAMA_VERSION` to 1.9.2 and refresh the generated documentation from the latest spec.
+- Updated dependencies [[`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6), [`abefbeb`](https://github.com/codama-idl/codama/commit/abefbeb3ae369b01a46794ca3824a23391548040), [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28), [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835), [`b418a9e`](https://github.com/codama-idl/codama/commit/b418a9e19b0b15a3dc1c79edb246d78694d6310e)]:
+  - @codama/node-types@1.11.0
+  - @codama/errors@1.11.0
+
 ## 1.10.2
 
 ### Patch Changes

diff --git a/packages/nodes/package.json b/packages/nodes/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/nodes",
-    "version": "1.10.2",
+    "version": "1.11.0",
     "description": "Node specifications and helpers for the Codama standard",
     "keywords": [
         "framework",

diff --git a/packages/renderers-core/CHANGELOG.md b/packages/renderers-core/CHANGELOG.md
@@ -1,5 +1,15 @@
 # @codama/renderers-core
 
+## 1.4.1
+
+### Patch Changes
+
+- Updated dependencies [[`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6), [`abefbeb`](https://github.com/codama-idl/codama/commit/abefbeb3ae369b01a46794ca3824a23391548040), [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28), [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835), [`b418a9e`](https://github.com/codama-idl/codama/commit/b418a9e19b0b15a3dc1c79edb246d78694d6310e), [`b81b87d`](https://github.com/codama-idl/codama/commit/b81b87d32f021ed12f96b9866da119acbd77c10d)]:
+  - @codama/nodes@1.11.0
+  - @codama/errors@1.11.0
+  - @codama/fragments@1.0.0
+  - @codama/visitors-core@1.11.0
+
 ## 1.4.0
 
 ### Minor Changes

diff --git a/packages/renderers-core/package.json b/packages/renderers-core/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/renderers-core",
-    "version": "1.4.0",
+    "version": "1.4.1",
     "description": "Core types and helpers for Codama renderers to use",
     "keywords": [
         "framework",

diff --git a/packages/upgrade/package.json b/packages/upgrade/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/upgrade",
-    "version": "0.0.0",
+    "version": "1.0.0",
     "description": "Upgrade Codama IDLs to the latest major version of the standard",
     "keywords": [
         "framework",

diff --git a/packages/validators/CHANGELOG.md b/packages/validators/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @codama/validators
 
+## 1.11.0
+
+### Patch Changes
+
+- Updated dependencies [[`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6), [`abefbeb`](https://github.com/codama-idl/codama/commit/abefbeb3ae369b01a46794ca3824a23391548040), [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28), [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835), [`b418a9e`](https://github.com/codama-idl/codama/commit/b418a9e19b0b15a3dc1c79edb246d78694d6310e)]:
+  - @codama/nodes@1.11.0
+  - @codama/errors@1.11.0
+  - @codama/visitors-core@1.11.0
+
 ## 1.10.2
 
 ### Patch Changes

diff --git a/packages/validators/package.json b/packages/validators/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/validators",
-    "version": "1.10.2",
+    "version": "1.11.0",
     "description": "Validator visitors for the Codama framework",
     "keywords": [
         "framework",

diff --git a/packages/visitors-core/CHANGELOG.md b/packages/visitors-core/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @codama/visitors-core
 
+## 1.11.0
+
+### Patch Changes
+
+- Updated dependencies [[`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6), [`abefbeb`](https://github.com/codama-idl/codama/commit/abefbeb3ae369b01a46794ca3824a23391548040), [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28), [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835), [`b418a9e`](https://github.com/codama-idl/codama/commit/b418a9e19b0b15a3dc1c79edb246d78694d6310e)]:
+  - @codama/nodes@1.11.0
+  - @codama/errors@1.11.0
+
 ## 1.10.2
 
 ### Patch Changes

diff --git a/packages/visitors-core/package.json b/packages/visitors-core/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/visitors-core",
-    "version": "1.10.2",
+    "version": "1.11.0",
     "description": "Core visitors for the Codama framework",
     "keywords": [
         "framework",

diff --git a/packages/visitors/CHANGELOG.md b/packages/visitors/CHANGELOG.md
@@ -1,5 +1,18 @@
 # @codama/visitors
 
+## 1.11.0
+
+### Minor Changes
+
+- [#1096](https://github.com/codama-idl/codama/pull/1096) [`362f618`](https://github.com/codama-idl/codama/commit/362f618127d6642b3ec09d3016cb801629b2aa53) Thanks [@lorisleiva](https://github.com/lorisleiva)! - Add `checkCodamaVersionVisitor`. It checks the version of the visited Codama IDL against the Codama spec version supported by the installed packages, throwing a `CODAMA_ERROR__VERSION_MISMATCH` error when the majors differ. It is mainly useful at IDL-ingestion boundaries that bypass `createFromRoot`, such as a `before` visitor in a Codama CLI config.
+
+### Patch Changes
+
+- Updated dependencies [[`fa4a453`](https://github.com/codama-idl/codama/commit/fa4a45315028a9cb125ebaf31695df82a6ffc1c6), [`abefbeb`](https://github.com/codama-idl/codama/commit/abefbeb3ae369b01a46794ca3824a23391548040), [`55b9ede`](https://github.com/codama-idl/codama/commit/55b9edef01767a29d7ebeeeaed3bd75610150e28), [`dabfe42`](https://github.com/codama-idl/codama/commit/dabfe42211380aa16109058142dec6b21ced3835), [`b418a9e`](https://github.com/codama-idl/codama/commit/b418a9e19b0b15a3dc1c79edb246d78694d6310e)]:
+  - @codama/nodes@1.11.0
+  - @codama/errors@1.11.0
+  - @codama/visitors-core@1.11.0
+
 ## 1.10.2
 
 ### Patch Changes

diff --git a/packages/visitors/package.json b/packages/visitors/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@codama/visitors",
-    "version": "1.10.2",
+    "version": "1.11.0",
     "description": "All visitors for the Codama framework",
     "keywords": [
         "framework",