Changed #

• README: added an Author section with GitHub and LinkedIn links. Docs only, no code changes.

Changed #

• README: added a table of contents, and retitled every method subsection by bare method name with the signature in a code block beneath, so in-page links are short and predictable on GitHub and pub.flutter-io.cn. Typed access and JSON are split into per-method subsections. Docs only, no code changes.

Changed #

• README: new "Plain maps and lists" subsection explaining getAs<Map<String, dynamic>> (returns the live underlying map), why a narrower value type such as Map<String, int> needs getMapOf, and why getAs<List> returns the MagicList view. Docs only, no code changes.

Added #

• Typed accessors on MagicMap and MagicList, available on nested views too: getAs<T>(), requireAs<T>(), getListOf<T>() and getMapOf<V>(). The collection variants rebuild the list or map with the requested element type, so getListOf<String>('tags') returns a real List<String> where a cast of the decoded List<dynamic> would throw. int widens to double, a whole double narrows to int, ISO-8601 strings convert to DateTime, and a MagicMap view converts to its plain Map<String, dynamic>. Parsing numbers and booleans out of strings is opt-in via parseStrings: true. requireAs throws a MagicMapException that names the path and the actual type.
• MagicMap.view() and MagicList.view() wrap an existing collection without copying it, for large data you already own.
• topics in the pubspec.

Changed #

• The package no longer depends on the Flutter SDK. It is a pure Dart package usable from server, CLI and Flutter projects alike. Dev dependencies moved from flutter_test / flutter_lints to test / lints. Nothing changes for existing Flutter users.
• README leads with typed and path-based access and states what the package is for: data whose shape you do not control.
• Clarified in the 2.0.0 notes that == and hashCode use the identity of the underlying collection, not its contents.

Changed #

• README and package description now lead with the path API (getPath, set, getWithGlob, setImmutable, JSON helpers) and present dynamic dot access as an optional extra with its trade-offs listed. No code changes.

Internal rewrite around one invariant: the underlying data is always plain Map<String, dynamic> / List<dynamic> containers, and every view writes through to it. Most of the previously documented behaviour now actually works.

Fixed #

• getPath() resolves list indices (user.hobbies.0); it returned the default before.
• set() through a list index (user.hobbies.0) no longer throws or replaces the list with an empty map.
• set() with a map or list value no longer stores wrapper objects in the data, which made toJsonString() and raw unusable afterwards.
• Direct list mutation through dot access (d.user.hobbies[1] = 'x', .add(...)) now writes through instead of modifying a throwaway copy.
• Writes into maps built from narrowly typed literals (for example {'name': 'Alice'} inferred as Map<String, String>) no longer throw type errors: input is deep-copied into Map<String, dynamic>.
• Non-string keys in the input are converted with toString() instead of failing lazily on access.
• getPath() no longer swallows every error with a bare catch.
• The replacer parameter of toJsonString() now behaves like the JavaScript JSON.stringify replacer it was documented as; the previous parameter was JsonEncoder's toEncodable and never saw string values.

Added #

• MagicList: a real List view returned for nested lists, with write-through []=, add, insert, removeAt, sort, and so on.
• Nested views are MagicMap instances, so getPath, set, getWithGlob, setImmutable, toJsonString, raw and friends work at any depth.
• Bracket index syntax in paths: users[0].name, items[*].id.
• Backslash escaping of . and [ inside keys.
• hasPath(), removePath(), clone(), toJson().
• Glob patterns support * and ? inside a segment and ** for any depth.
• MagicList.fromJsonString().
• toJsonString(toEncodable: ...) for values JSON cannot encode.
• MagicMap.omit sentinel for dropping entries from a replacer.
• set() creates intermediate lists for integer segments and appends when the index equals the list length.
• Cyclic input is rejected with MagicMapException instead of hanging.
• == and hashCode are based on the identity of the underlying collection, so two views over the same data are equal and a view is safe to use as a map key.
• A test suite (flutter test) covering the public API.

Changed (breaking) #

• MagicMap(...) deep-copies its argument; it used to hold a reference, so mutations no longer show up in the original map. It requires a Map (or MagicMap, or null) and throws MagicMapException for other input.
• toJsonString now takes named parameters: toJsonString(indent: 2, replacer: ..., toEncodable: ...).
• raw is typed Map<String, dynamic> and returns the live data.
• set() throws MagicMapException instead of silently replacing a scalar or a list with an empty map when a path descends through it, and for list indices that are out of range.
• toString() prints the plain map ({a: 1}) rather than MagicMap({a: 1}).
• Assigning a MagicMap/MagicList or a raw collection stores a deep copy rather than an alias.
• MagicMap.fromJsonString throws MagicMapException for invalid JSON or a non-object root.
• Removed the unused glob dependency.

Added #

• Introduced MagicMap class for flexible, dynamic map access.
• Support for dot-separated path-based value retrieval using getPath().
• Support for dot-separated dynamic nested value assignment using set().
• Bash-style glob pattern matching support with getWithGlob().
• Immutable data updates using setImmutable().
• JSON serialization via toJsonString() and fromJsonString().
• Dynamic property access using noSuchMethod on _MagicMapImpl.
• Custom MagicMapException class with detailed error messages.

Internal #

• Wrapped and unwrapped data to maintain consistent structure using _wrap() and _unwrap() utilities.
• Recursive collection of matched entries for glob matching.