Sample
collection 1.19.1: Handle the TypeError thrown by CanonicalizedMap.cast at runtime due to incorrect delegation to the raw base map.
Verified sample for pub collection 1.19.1: Handle the TypeError thrown by CanonicalizedMap.cast at runtime due to incorrect delegation to the raw base map.…
sha256:cf308bbee26813399fb73688e6165e0aeefaf817bcc5dd4586f013f6d8045ad3
This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured.
How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people.
MIT-0
Execution evidence
The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.
- Evidence basis
- Signed contract pass
- Verification receipts
- 2
- Signing keys that built it
- 2
Declared environment
dart linux x64 dart dart pub
Verification-run environments
| Environment | Contract | Stages | Run |
|---|---|---|---|
| dart 3 · linux debian/x64 · docker ed25519:d91480838ac982c9 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · pub@1 |
2026-08-16 |
| dart 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · pub@1 |
2026-08-18 |
Case
HOW- Goal
- Handle the TypeError thrown by CanonicalizedMap.cast at runtime due to incorrect delegation to the raw base map.
- Packages
- Symbols
-
- CanonicalizedMap
- CanonicalizedMap.cast
- Environment
- dart
- Created
- 2026-08-17T02:04:15Z
Contract
- Calling cast on a CanonicalizedMap returns a map view that throws a TypeError on value retrieval, because it delegates to the underlying map containing MapEntry elements instead of unpacking them.
- Accessing values on the casted map throws a TypeError because elements of the returned collection are not of the casted value type.
- Looking up a key in the casted map throws a TypeError when attempting to cast the returned MapEntry to the value type.
- Accessing entries on the casted map throws a TypeError when accessing the entry value.
Files
- NOTES.md
- csx.json
- pubspec.lock
- pubspec.yaml
- test/contract.dart
Source
# Runtime Type Error in CanonicalizedMap cast Delegation
## Search Results
`search_known_solution` returned no prior samples for `CanonicalizedMap` type errors in the Dart `collection` package. It only returned unrelated solutions for general collection equality (`ListEquality`/`MapEquality` for cache keys) and subtype generic constraints in `mergeSort`.
## Failure Mode
Loudly: Calling `.cast<K2, V2>()` on a `CanonicalizedMap` compiles successfully and passes static type checks, but fails loudly at runtime with a `TypeError` (e.g., `type 'MapEntry<String, int>' is not a subtype of type 'int?' in type cast`) on any value lookup, value iteration, or entry access. This occurs because the implementation delegates the cast to the underlying raw map (which stores internal `MapEntry` elements as values) rather than projecting the actual user-facing values.
{"case":{"believed":"Calling cast on a CanonicalizedMap returns a valid Map wrapper that soundly checks and casts its keys and values for runtime lookups and iterations.","caseId":"case:sha256:f5571d0e9d8e56facf3c72d9c8fa967b289baec8f12e32cd8ecd2f54230553fc","contract":["Calling cast on a CanonicalizedMap returns a map view that throws a TypeError on value retrieval, because it delegates to the underlying map containing MapEntry elements instead of unpacking them.","Accessing values on the casted map throws a TypeError because elements of the returned collection are not of the casted value type.","Looking up a key in the casted map throws a TypeError when attempting to cast the returned MapEntry to the value type.","Accessing entries on the casted map throws a TypeError when accessing the entry value."],"goal":"Handle the TypeError thrown by CanonicalizedMap.cast at runtime due to incorrect delegation to the raw base map.","kind":"HOW","packages":["pkg:pub/collection@1.19.1"],"schemaVersion":1,"symbols":["CanonicalizedMap","CanonicalizedMap.cast"]},"contractCommand":["dart","test/contract.dart"],"environment":{"arch":"x64","ecosystem":"pub","executionContext":"dart","language":"dart","os":"linux","packageManager":"pub","runtime":"dart","schemaVersion":1},"license":"MIT-0","packages":["pkg:pub/collection@1.19.1"],"schemaVersion":1,"symbols":["CanonicalizedMap","CanonicalizedMap.cast"],"verifierAdapter":"pub@1"}
# Generated by pub
# See https://dart.dev/tools/pub/glossary#lockfile
packages:
collection:
dependency: "direct main"
description:
name: collection
sha256: "2f5709ae4d3d59dd8f7cd309b4e023046b57d8a6c82130785d2b0e5868084e76"
url: "https://pub.dev"
source: hosted
version: "1.19.1"
sdks:
dart: ">=3.5.0 <4.0.0"
name: collection_cast_contract
environment:
sdk: '>=3.5.0 <4.0.0'
dependencies:
collection: 1.19.1
import 'package:collection/collection.dart';
void main() {
final map = CanonicalizedMap<String, String, int>((key) => key.toLowerCase());
map['A'] = 1;
// Statically, the map cast compiles perfectly to Map<String, int>.
final Map<String, int> casted = map.cast<String, int>();
// 1. Assert that accessing values throws a TypeError.
// A naive model/developer expects this to succeed and yield an int.
bool threwOnValues = false;
try {
final firstVal = casted.values.first;
// Check type if it somehow returned without a type error.
if (firstVal is! int) {
throw StateError('Expected first value to throw TypeError, but got: $firstVal');
}
} on TypeError {
threwOnValues = true;
}
if (!threwOnValues) {
throw StateError('Expected accessing values to throw a TypeError, but it did not.');
}
// 2. Assert that looking up a key throws a TypeError.
bool threwOnLookup = false;
try {
final val = casted['a'];
if (val is! int) {
throw StateError('Expected lookup to throw TypeError, but got: $val');
}
} on TypeError {
threwOnLookup = true;
}
if (!threwOnLookup) {
throw StateError('Expected looking up a key to throw a TypeError, but it did not.');
}
// 3. Assert that accessing entries throws a TypeError.
bool threwOnEntries = false;
try {
final entry = casted.entries.first;
final val = entry.value;
if (val is! int) {
throw StateError('Expected entry value to throw TypeError, but got: $val');
}
} on TypeError {
threwOnEntries = true;
}
if (!threwOnEntries) {
throw StateError('Expected entry value access to throw a TypeError, but it did not.');
}
}