codama-renderers-dart 0.5.4 → 0.5.6

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;eAC7C,aAAa"}

package/dist/types/utils/discriminators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discriminators.d.ts","sourceRoot":"","sources":["../../../src/utils/discriminators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,eAAe,EAEhB,MAAM,eAAe,CAAC;AAIvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQ9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,KAAK,iBAAiB,GAAG,WAAW,GAAG,eAAe,CAAC;AAEvD;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,WAAW,GACjB,QAAQ,CAwDV"}
+{"version":3,"file":"discriminators.d.ts","sourceRoot":"","sources":["../../../src/utils/discriminators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,eAAe,EAEhB,MAAM,eAAe,CAAC;AAIvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQ9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,KAAK,iBAAiB,GAAG,WAAW,GAAG,eAAe,CAAC;AAEvD;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,WAAW,GACjB,QAAQ,CA+DV"}

package/dist/types/utils/importMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"importMap.d.ts","sourceRoot":"","sources":["../../../src/utils/importMap.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsB5D,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAqB;IAErC;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAOrC;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAEzB;IAED;;;OAGG;IACH,OAAO,CAAC,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,EAAE;IAgC3D;;OAEG;IACH,QAAQ,CAAC,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM;CAyB3D"}
+{"version":3,"file":"importMap.d.ts","sourceRoot":"","sources":["../../../src/utils/importMap.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsB5D,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAqB;IAErC;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGxB;IAED;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAKpC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAEzB;IAED;;;OAGG;IACH,OAAO,CAAC,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,EAAE,CA8B1D;IAED;;OAEG;IACH,QAAQ,CAAC,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,CAwBzD;CACF"}

package/dist/types/utils/options.d.ts

@@ -1,6 +1,28 @@
 import type { LinkableDictionary } from "@codama/visitors-core";
 import type { DartNameApi } from "./nameTransformers.js";
 import type { TypeManifestVisitor } from "../visitors/getTypeManifestVisitor.js";
+/**
+ * A hand-written codec that backs a defined-type link in the rendered IDL.
+ *
+ * Some IDL fields cannot be expressed with Codama type nodes and need a
+ * hand-written codec instead — for example, the Token-2022 TLV extension
+ * region, which stops at the first `Uninitialized` header rather than
+ * consuming every trailing byte. Codama has no "stop at a discriminator" type
+ * node, so the IDL is prepared to link the inner type to a name and the
+ * renderer is told which hand-written codec backs that link. Wrappers around
+ * the link (`Option`, `HiddenPrefix`, …) still come from the IDL, so the wire
+ * format is unchanged.
+ */
+export interface LinkOverride {
+    /** The Dart file the codec lives in, relative to the package's `lib/`. */
+    path: string;
+    /** The Dart type the link resolves to, e.g. `List<Extension>`. */
+    type: string;
+    /** The encoder expression, e.g. `getExtensionsEncoder()`. */
+    encoder: string;
+    /** The decoder expression, e.g. `getExtensionsDecoder()`. */
+    decoder: string;
+}
 /**
  * Options for the top-level renderVisitor.
  */
@@ -22,6 +44,13 @@ export interface GetRenderMapOptions {
     nameApi?: Partial<DartNameApi>;
     /** Dependency map overrides (logical module -> Dart package URI). */
     dependencyMap?: Record<string, string>;
+    /**
+     * Hand-written codec overrides for defined-type links, keyed by the link
+     * name as it appears in Codama nodes. A link with a matching key emits the
+     * override's type and codec expressions instead of resolving to a generated
+     * type file, and imports the override's Dart file.
+     */
+    linkOverrides?: Record<string, LinkOverride>;
 }
 /**
  * Shared rendering context passed to fragment generators.

package/dist/types/utils/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/utils/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACxD,2EAA2E;IAC3E,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/B,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,OAAO,EAAE,WAAW,CAAC;IACrB,0DAA0D;IAC1D,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,sDAAsD;IACtD,SAAS,EAAE,kBAAkB,CAAC;IAC9B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gEAAgE;IAChE,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/utils/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACxD,2EAA2E;IAC3E,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/B,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,OAAO,EAAE,WAAW,CAAC;IACrB,0DAA0D;IAC1D,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,sDAAsD;IACtD,SAAS,EAAE,kBAAkB,CAAC;IAC9B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gEAAgE;IAChE,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C"}

package/dist/types/utils/wellKnownAddresses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wellKnownAddresses.d.ts","sourceRoot":"","sources":["../../../src/utils/wellKnownAddresses.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAsD3D,CAAC"}
+{"version":3,"file":"wellKnownAddresses.d.ts","sourceRoot":"","sources":["../../../src/utils/wellKnownAddresses.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAuD3D,CAAC"}

package/dist/types/visitors/getRenderMapVisitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getRenderMapVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/getRenderMapVisitor.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,OAAO,EASb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,qBAAqB,CAAC;AAa5E;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,SAAS,CAAC,CA2K9H"}
+{"version":3,"file":"getRenderMapVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/getRenderMapVisitor.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,OAAO,EASb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,qBAAqB,CAAC;AAa5E;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,SAAS,CAAC,CA4K9H"}

package/dist/types/visitors/getTypeManifestVisitor.d.ts

@@ -2,6 +2,7 @@ import { type CamelCaseString } from "@codama/nodes";
 import { type LinkableDictionary, type NodeStack, type Visitor } from "@codama/visitors-core";
 import { type TypeManifest } from "../utils/index.js";
 import { type DartNameApi } from "../utils/nameTransformers.js";
+import type { LinkOverride } from "../utils/options.js";
 /**
  * Type alias for the type manifest visitor.
  */
@@ -15,5 +16,6 @@ export declare function getTypeManifestVisitor(input: {
     linkables: LinkableDictionary;
     stack: NodeStack;
     nonScalarEnums?: CamelCaseString[];
-}): Visitor<TypeManifest, "accountBumpValueNode" | "accountFieldValueNode" | "accountValueNode" | "argumentValueNode" | "conditionalValueNode" | "identityValueNode" | "payerValueNode" | "pdaValueNode" | "programIdValueNode" | "resolverValueNode" | "programLinkNode" | "arrayValueNode" | "booleanValueNode" | "bytesValueNode" | "constantValueNode" | "enumValueNode" | "injectedValueNode" | "mapValueNode" | "noneValueNode" | "numberValueNode" | "publicKeyValueNode" | "setValueNode" | "someValueNode" | "stringValueNode" | "structValueNode" | "tupleValueNode" | "amountTypeNode" | "arrayTypeNode" | "booleanTypeNode" | "bytesTypeNode" | "dateTimeTypeNode" | "enumTypeNode" | "fixedSizeTypeNode" | "hiddenPrefixTypeNode" | "hiddenSuffixTypeNode" | "mapTypeNode" | "numberTypeNode" | "optionTypeNode" | "postOffsetTypeNode" | "preOffsetTypeNode" | "publicKeyTypeNode" | "remainderOptionTypeNode" | "sentinelTypeNode" | "setTypeNode" | "sizePrefixTypeNode" | "solAmountTypeNode" | "stringTypeNode" | "structTypeNode" | "tupleTypeNode" | "zeroableOptionTypeNode" | "structFieldDisplayNode" | "constantDiscriminatorNode" | "fieldDiscriminatorNode" | "sizeDiscriminatorNode" | "instructionAccountDisplayNode" | "instructionStatusNode" | "accountNode" | "constantNode" | "definedTypeNode" | "errorNode" | "eventNode" | "instructionAccountNode" | "instructionArgumentNode" | "instructionByteDeltaNode" | "instructionNode" | "instructionRemainingAccountsNode" | "pdaNode" | "pluginNode" | "programNode" | "providedNode" | "pdaSeedValueNode" | "fixedCountNode" | "prefixedCountNode" | "remainderCountNode" | "amountNumberDisplayNode" | "dateTimeNumberDisplayNode" | "durationNumberDisplayNode" | "enumVariantDisplayNode" | "instructionDisplayNode" | "stringDisplayNode" | "accountLinkNode" | "definedTypeLinkNode" | "instructionAccountLinkNode" | "instructionArgumentLinkNode" | "instructionLinkNode" | "pdaLinkNode" | "constantPdaSeedNode" | "variablePdaSeedNode" | "enumEmptyVariantTypeNode" | "enumStructVariantTypeNode" | "enumTupleVariantTypeNode" | "structFieldTypeNode" | "mapEntryValueNode" | "structFieldValueNode" | "rootNode">;
+    linkOverrides?: Record<string, LinkOverride>;
+}): Visitor<TypeManifest, "accountBumpValueNode" | "accountFieldValueNode" | "accountLinkNode" | "accountNode" | "accountValueNode" | "amountNumberDisplayNode" | "amountTypeNode" | "argumentValueNode" | "arrayTypeNode" | "arrayValueNode" | "booleanTypeNode" | "booleanValueNode" | "bytesTypeNode" | "bytesValueNode" | "conditionalValueNode" | "constantDiscriminatorNode" | "constantNode" | "constantPdaSeedNode" | "constantValueNode" | "dateTimeNumberDisplayNode" | "dateTimeTypeNode" | "definedTypeLinkNode" | "definedTypeNode" | "durationNumberDisplayNode" | "enumEmptyVariantTypeNode" | "enumStructVariantTypeNode" | "enumTupleVariantTypeNode" | "enumTypeNode" | "enumValueNode" | "enumVariantDisplayNode" | "errorNode" | "eventNode" | "fieldDiscriminatorNode" | "fixedCountNode" | "fixedSizeTypeNode" | "hiddenPrefixTypeNode" | "hiddenSuffixTypeNode" | "identityValueNode" | "injectedValueNode" | "instructionAccountDisplayNode" | "instructionAccountLinkNode" | "instructionAccountNode" | "instructionArgumentLinkNode" | "instructionArgumentNode" | "instructionByteDeltaNode" | "instructionDisplayNode" | "instructionLinkNode" | "instructionNode" | "instructionRemainingAccountsNode" | "instructionStatusNode" | "mapEntryValueNode" | "mapTypeNode" | "mapValueNode" | "noneValueNode" | "numberTypeNode" | "numberValueNode" | "optionTypeNode" | "payerValueNode" | "pdaLinkNode" | "pdaNode" | "pdaSeedValueNode" | "pdaValueNode" | "pluginNode" | "postOffsetTypeNode" | "preOffsetTypeNode" | "prefixedCountNode" | "programIdValueNode" | "programLinkNode" | "programNode" | "providedNode" | "publicKeyTypeNode" | "publicKeyValueNode" | "remainderCountNode" | "remainderOptionTypeNode" | "resolverValueNode" | "rootNode" | "sentinelTypeNode" | "setTypeNode" | "setValueNode" | "sizeDiscriminatorNode" | "sizePrefixTypeNode" | "solAmountTypeNode" | "someValueNode" | "stringDisplayNode" | "stringTypeNode" | "stringValueNode" | "structFieldDisplayNode" | "structFieldTypeNode" | "structFieldValueNode" | "structTypeNode" | "structValueNode" | "tupleTypeNode" | "tupleValueNode" | "variablePdaSeedNode" | "zeroableOptionTypeNode">;
 //# sourceMappingURL=getTypeManifestVisitor.d.ts.map

package/dist/types/visitors/getTypeManifestVisitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getTypeManifestVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/getTypeManifestVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EAgCrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,OAAO,EAIb,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAEL,KAAK,YAAY,EAKlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,WAAW,EAAa,MAAM,8BAA8B,CAAC;AAG3E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;CACpC,8kEA8mBA"}
+{"version":3,"file":"getTypeManifestVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/getTypeManifestVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EAgCrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,OAAO,EAIb,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAEL,KAAK,YAAY,EAKlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,WAAW,EAAa,MAAM,8BAA8B,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC9C,8kEAooBA"}

package/dist/types/visitors/renderVisitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/renderVisitor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,6DAmE5B"}
+{"version":3,"file":"renderVisitor.d.ts","sourceRoot":"","sources":["../../../src/visitors/renderVisitor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,qBAAqB,CAAC;AAMvE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,6DA2E5B"}

package/package.json

@@ -9,12 +9,12 @@
   "devDependencies": {
     "@codama/nodes-from-anchor": "^1.5.5",
     "@codama/renderers-js": "^2.4.0",
-    "@types/node": "25.3.0",
-    "@vitest/coverage-v8": "4.1.0",
+    "@types/node": "26.5.1",
+    "@vitest/coverage-v8": "5.0.0",
     "rimraf": "6.1.3",
     "tsup": "8.5.1",
-    "typescript": "5.9.3",
-    "vitest": "4.1.0"
+    "typescript": "7.0.2",
+    "vitest": "5.0.0"
   },
   "engines": {
     "node": ">=18"
@@ -55,7 +55,7 @@
   "repository": "https://github.com/openbudgetfun/solana_kit/tree/main/packages/codama-renderers-dart",
   "type": "module",
   "types": "./dist/types/index.d.ts",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "scripts": {
     "build": "pnpm exec rimraf dist && pnpm exec tsup && pnpm exec tsc -p tsconfig.declarations.json",
     "lint": "eslint --ext .ts src",

package/src/utils/discriminators.ts

@@ -67,7 +67,14 @@ export function getDiscriminatorValidationFragment(
             `Discriminator size must be a non-negative safe integer, got ${discriminator.size}.`,
           );
         }
-        return fragment`if (bytes.length - offset != ${fragmentFromString(String(discriminator.size))}) {
+        // For an instruction, the discriminated size is the whole payload and
+        // identification depends on an exact match. For an account, the size
+        // describes the fixed prefix: accounts whose trailing fields are
+        // variable — a Token-2022 account with a TLV extension region, for
+        // example — are legitimately longer, so the check is a minimum.
+        const comparison =
+          node.kind === "accountNode" ? "<" : "!=";
+        return fragment`if (bytes.length - offset ${fragmentFromString(comparison)} ${fragmentFromString(String(discriminator.size))}) {
   throw ${use("SolanaError", "solanaErrors")}(
     ${use("SolanaErrorCode", "solanaErrors")}.codecsInvalidByteLength,
     {

package/src/utils/options.ts

@@ -5,6 +5,29 @@ import type {
 import type { DartNameApi } from "./nameTransformers.js";
 import type { TypeManifestVisitor } from "../visitors/getTypeManifestVisitor.js";
 
+/**
+ * A hand-written codec that backs a defined-type link in the rendered IDL.
+ *
+ * Some IDL fields cannot be expressed with Codama type nodes and need a
+ * hand-written codec instead — for example, the Token-2022 TLV extension
+ * region, which stops at the first `Uninitialized` header rather than
+ * consuming every trailing byte. Codama has no "stop at a discriminator" type
+ * node, so the IDL is prepared to link the inner type to a name and the
+ * renderer is told which hand-written codec backs that link. Wrappers around
+ * the link (`Option`, `HiddenPrefix`, …) still come from the IDL, so the wire
+ * format is unchanged.
+ */
+export interface LinkOverride {
+  /** The Dart file the codec lives in, relative to the package's `lib/`. */
+  path: string;
+  /** The Dart type the link resolves to, e.g. `List<Extension>`. */
+  type: string;
+  /** The encoder expression, e.g. `getExtensionsEncoder()`. */
+  encoder: string;
+  /** The decoder expression, e.g. `getExtensionsDecoder()`. */
+  decoder: string;
+}
+
 /**
  * Options for the top-level renderVisitor.
  */
@@ -27,6 +50,13 @@ export interface GetRenderMapOptions {
   nameApi?: Partial<DartNameApi>;
   /** Dependency map overrides (logical module -> Dart package URI). */
   dependencyMap?: Record<string, string>;
+  /**
+   * Hand-written codec overrides for defined-type links, keyed by the link
+   * name as it appears in Codama nodes. A link with a matching key emits the
+   * override's type and codec expressions instead of resolving to a generated
+   * type file, and imports the override's Dart file.
+   */
+  linkOverrides?: Record<string, LinkOverride>;
 }
 
 /**

package/src/utils/wellKnownAddresses.ts

@@ -46,7 +46,8 @@ export const WELL_KNOWN_ADDRESSES: ReadonlyMap<string, string> = new Map([
   ['TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA', 'tokenProgramAddress'],
   ['TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb', 'token2022ProgramAddress'],
   ['ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL', 'associatedTokenProgramAddress'],
-  ['MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr', 'memoProgramAddress'],
+  ['Memo4c2pN8afCj432Lb7RMVKi9PbQnnW7ewFFaV3oAH', 'memoProgramAddress'],
+  ['MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr', 'memoLegacyProgramAddressV3'],
   ['Memo1UhkJRfHyvLMcVucJwxXeuD728EqVDDwQDxFMNo', 'memoLegacyProgramAddress'],
 
   // Metaplex programs

package/src/visitors/getRenderMapVisitor.ts

@@ -57,6 +57,7 @@ export function getRenderMapVisitor(
     nameApi,
     linkables,
     stack,
+    linkOverrides: options.linkOverrides,
   });
 
   const scope: RenderScope = {

package/src/visitors/getTypeManifestVisitor.ts

@@ -57,6 +57,7 @@ import {
   use,
 } from "../utils/index.js";
 import { type DartNameApi, snakeCase } from "../utils/nameTransformers.js";
+import type { LinkOverride } from "../utils/options.js";
 import { getDartValueFragment, getNonNegativeInteger, toDartStringLiteral } from "../utils/valueNodes.js";
 
 /**
@@ -73,8 +74,14 @@ export function getTypeManifestVisitor(input: {
   linkables: LinkableDictionary;
   stack: NodeStack;
   nonScalarEnums?: CamelCaseString[];
+  linkOverrides?: Record<string, LinkOverride>;
 }) {
-  const { nameApi, linkables, nonScalarEnums = [] } = input;
+  const {
+    nameApi,
+    linkables,
+    nonScalarEnums = [],
+    linkOverrides = {},
+  } = input;
 
   const baseVisitor = staticVisitor<TypeManifest>(
     (node): TypeManifest => {
@@ -209,8 +216,8 @@ export function getTypeManifestVisitor(input: {
 
     visitArrayType(node: ArrayTypeNode, { self }) {
       const itemManifest = visit(node.item, self);
-      const encoderSizeExpr = getArraySizeExpression(node, "Encoder");
-      const decoderSizeExpr = getArraySizeExpression(node, "Decoder");
+      const encoderSizeExpr = getArraySizeExpression(node, "Encoder", self);
+      const decoderSizeExpr = getArraySizeExpression(node, "Decoder", self);
       const itemType = fragmentFromString(itemManifest.type.content);
       const itemEncoder = fragment`${use(
         "transformEncoder",
@@ -235,8 +242,8 @@ export function getTypeManifestVisitor(input: {
     visitMapType(node: MapTypeNode, { self }) {
       const keyManifest = visit(node.key, self);
       const valueManifest = visit(node.value, self);
-      const encoderSizeExpr = getMapSizeExpression(node, "Encoder");
-      const decoderSizeExpr = getMapSizeExpression(node, "Decoder");
+      const encoderSizeExpr = getMapSizeExpression(node, "Encoder", self);
+      const decoderSizeExpr = getMapSizeExpression(node, "Decoder", self);
 
       return {
         type: fragment`Map<${keyManifest.type}, ${valueManifest.type}>`,
@@ -255,8 +262,8 @@ export function getTypeManifestVisitor(input: {
 
     visitSetType(node: SetTypeNode, { self }) {
       const itemManifest = visit(node.item, self);
-      const encoderSizeExpr = getSetSizeExpression(node, "Encoder");
-      const decoderSizeExpr = getSetSizeExpression(node, "Decoder");
+      const encoderSizeExpr = getSetSizeExpression(node, "Encoder", self);
+      const decoderSizeExpr = getSetSizeExpression(node, "Decoder", self);
 
       return {
         type: fragment`Set<${itemManifest.type}>`,
@@ -670,6 +677,23 @@ export function getTypeManifestVisitor(input: {
       { self }: { self: Visitor<TypeManifest> },
     ) {
       const name = node.name as string;
+
+      // A link may be backed by a hand-written codec. This keeps whatever
+      // wrappers the IDL puts around the link (`Option`, `HiddenPrefix`, …)
+      // while replacing the inner type and codecs, which is what a type that
+      // Codama cannot express needs.
+      const override = linkOverrides[name];
+      if (override != null) {
+        const moduleKey = `linkOverride:${override.path}`;
+        return {
+          type: use(override.type, moduleKey),
+          encoder: use(override.encoder, moduleKey),
+          decoder: use(override.decoder, moduleKey),
+          value: emptyTypeManifest().value,
+          isEnum: false,
+        };
+      }
+
       const typeName = nameApi.dataType(name);
       const isNonScalar = nonScalarEnums.includes(node.name);
       const moduleKey = `definedType:${snakeCase(name)}`;
@@ -772,6 +796,7 @@ function getNumberCodecExpression(
 function getArraySizeExpression(
   node: ArrayTypeNode,
   codecType: "Encoder" | "Decoder",
+  self: Visitor<TypeManifest>,
 ): string | Fragment {
   if (!("count" in node) || !node.count) return "";
   const count = node.count;
@@ -781,11 +806,15 @@ function getArraySizeExpression(
     case "remainderCountNode":
       return ", size: RemainderArraySize()";
     case "prefixedCountNode": {
-      const resolvedPrefix = resolveNestedTypeNode(count.prefix);
-      if (resolvedPrefix.format === "u32" && (!resolvedPrefix.endian || resolvedPrefix.endian === "le")) {
+      if (
+        count.prefix.kind === "numberTypeNode" &&
+        count.prefix.format === "u32" &&
+        (!count.prefix.endian || count.prefix.endian === "le")
+      ) {
         return ""; // Default
       }
-      return fragment`, size: PrefixedArraySize(${getNumberCodecExpression(resolvedPrefix, codecType)})`;
+      const prefix = visit(count.prefix, self);
+      return fragment`, size: PrefixedArraySize(${codecType === "Encoder" ? prefix.encoder : prefix.decoder})`;
     }
     default:
       return "";
@@ -795,6 +824,7 @@ function getArraySizeExpression(
 function getMapSizeExpression(
   node: MapTypeNode,
   codecType: "Encoder" | "Decoder",
+  self: Visitor<TypeManifest>,
 ): string | Fragment {
   if (!("count" in node) || !node.count) return "";
   const count = node.count;
@@ -804,11 +834,15 @@ function getMapSizeExpression(
     case "remainderCountNode":
       return ", size: RemainderArraySize()";
     case "prefixedCountNode": {
-      const resolvedPrefix = resolveNestedTypeNode(count.prefix);
-      if (resolvedPrefix.format === "u32" && (!resolvedPrefix.endian || resolvedPrefix.endian === "le")) {
+      if (
+        count.prefix.kind === "numberTypeNode" &&
+        count.prefix.format === "u32" &&
+        (!count.prefix.endian || count.prefix.endian === "le")
+      ) {
         return "";
       }
-      return fragment`, size: PrefixedArraySize(${getNumberCodecExpression(resolvedPrefix, codecType)})`;
+      const prefix = visit(count.prefix, self);
+      return fragment`, size: PrefixedArraySize(${codecType === "Encoder" ? prefix.encoder : prefix.decoder})`;
     }
     default:
       return "";
@@ -818,6 +852,7 @@ function getMapSizeExpression(
 function getSetSizeExpression(
   node: SetTypeNode,
   codecType: "Encoder" | "Decoder",
+  self: Visitor<TypeManifest>,
 ): string | Fragment {
   if (!("count" in node) || !node.count) return "";
   const count = node.count;
@@ -827,11 +862,15 @@ function getSetSizeExpression(
     case "remainderCountNode":
       return ", size: RemainderArraySize()";
     case "prefixedCountNode": {
-      const resolvedPrefix = resolveNestedTypeNode(count.prefix);
-      if (resolvedPrefix.format === "u32" && (!resolvedPrefix.endian || resolvedPrefix.endian === "le")) {
+      if (
+        count.prefix.kind === "numberTypeNode" &&
+        count.prefix.format === "u32" &&
+        (!count.prefix.endian || count.prefix.endian === "le")
+      ) {
         return "";
       }
-      return fragment`, size: PrefixedArraySize(${getNumberCodecExpression(resolvedPrefix, codecType)})`;
+      const prefix = visit(count.prefix, self);
+      return fragment`, size: PrefixedArraySize(${codecType === "Encoder" ? prefix.encoder : prefix.decoder})`;
     }
     default:
       return "";

package/src/visitors/renderVisitor.ts

@@ -6,7 +6,7 @@ import { rootNodeVisitor, visit } from "@codama/visitors-core";
 import { deleteDirectory, writeRenderMap } from "@codama/renderers-core";
 
 import type { Fragment } from "../utils/fragment.js";
-import type { RenderOptions } from "../utils/options.js";
+import type { RenderOptions, LinkOverride } from "../utils/options.js";
 import { DartImportMap, DART_EXTERNAL_PACKAGE_MAP } from "../utils/importMap.js";
 import { formatDartDirectory } from "../utils/formatCode.js";
 import { normalizeRootNode } from "../utils/normalizeRootNode.js";
@@ -27,6 +27,7 @@ export function renderVisitor(
     formatCode = false,
     nameApi,
     dependencyMap,
+    linkOverrides,
   } = options;
 
   return rootNodeVisitor((root: RootNode) => {
@@ -35,7 +36,7 @@ export function renderVisitor(
     // 2. Build the render map
     const renderMap = visit(
       normalizedRoot,
-      getRenderMapVisitor({ nameApi, dependencyMap }),
+      getRenderMapVisitor({ nameApi, dependencyMap, linkOverrides }),
     );
 
     // 3. Build a map of definedType module keys to their render map paths
@@ -69,7 +70,14 @@ export function renderVisitor(
       }
 
       // Resolve fragment content with imports
-      const content = resolveFragmentContent(frag, dependencyMap ?? {}, internalMap);
+      const content = resolveFragmentContent(
+        frag,
+        {
+          ...(dependencyMap ?? {}),
+          ...linkOverrideImports(outputDir, filePath, options.linkOverrides ?? {}),
+        },
+        internalMap,
+      );
       files.push([fullPath, content]);
     }
 
@@ -89,6 +97,62 @@ export function renderVisitor(
   });
 }
 
+/**
+ * Resolve `linkOverride:` logical import keys into relative Dart imports.
+ *
+ * Override paths are relative to the package's `lib/` directory, while
+ * generated files live under `lib/src/generated/...`, so each consuming file
+ * needs its own relative path. Both sides are resolved against the package's
+ * `lib/` root, which is located by walking up from the output directory.
+ */
+function linkOverrideImports(
+  outputDir: string,
+  generatedFilePath: string,
+  overrides: Record<string, LinkOverride>,
+): Record<string, string> {
+  const resolved: Record<string, string> = {};
+  if (Object.keys(overrides).length === 0) return resolved;
+
+  // Override paths are resolved against the package's `lib/` directory, so
+  // without one there is nothing to anchor them to. Failing loudly beats
+  // emitting an import that cannot resolve.
+  const libRoot = findLibRoot(outputDir);
+  if (libRoot == null) {
+    throw new Error(
+      `Cannot resolve linkOverrides because the render output directory ` +
+        `"${outputDir}" has no "lib" ancestor.`,
+    );
+  }
+
+  const generatedAbsolute = posix.join(
+    posix.resolve(outputDir),
+    generatedFilePath,
+  );
+
+  for (const override of Object.values(overrides)) {
+    const overrideAbsolute = posix.join(libRoot, override.path);
+    let rel = posix.relative(posix.dirname(generatedAbsolute), overrideAbsolute);
+    if (!rel.startsWith(".")) {
+      rel = `./${rel}`;
+    }
+    resolved[`linkOverride:${override.path}`] = rel;
+  }
+
+  return resolved;
+}
+
+/**
+ * Find the package `lib/` directory containing the render output, so relative
+ * imports can point outside the generated tree. Returns null when the output
+ * directory has no `lib` ancestor, in which case overrides cannot be linked.
+ */
+function findLibRoot(outputDir: string): string | null {
+  const segments = posix.resolve(outputDir).split("/");
+  const libIndex = segments.lastIndexOf("lib");
+  if (libIndex < 0) return null;
+  return segments.slice(0, libIndex + 1).join("/");
+}
+
 /**
  * Resolve a fragment into its final Dart file content,
  * prepending the resolved import statements.