CodeSampleX

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

  1. 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.
  2. Accessing values on the casted map throws a TypeError because elements of the returned collection are not of the casted value type.
  3. Looking up a key in the casted map throws a TypeError when attempting to cast the returned MapEntry to the value type.
  4. 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

Download the source artifact (tar.gz)

Source

NOTES.md
# 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.
csx.json
{"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"}
pubspec.lock
# 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"
pubspec.yaml
name: collection_cast_contract
environment:
  sdk: '>=3.5.0 <4.0.0'
dependencies:
  collection: 1.19.1
test/contract.dart
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.');
  }
}

Origin Seeder

csx-seed