chore: changelog + df_log bump + formatter pass for 0.15.0

Expanded CHANGELOG to capture all 0.15.0 work (fieldPath dual-shape,
analyzer-driven enum sentinel, Equatable-by-inheritance, dialect
prefixes, DBML export, orNull contract fixes).

Bumped df_log constraint to ^0.5.1 to match the published latest.

Regenerated all integration test fixtures and let the formatter
canonicalise unrelated files.

Author: robelator

CHANGELOG.md

@@ -2,13 +2,18 @@
 
 ## [0.15.0]
 
-- Released @ 5/2026 (UTC)
-- Fix: AI prompt no longer collapses field path segments via `join('')` — uses `.` separator so the AI receives the structured field name (e.g. `user.name` instead of `username`)
-- Fix: AI generator now extracts field properties via the safe `FieldUtils` accessors instead of dynamic property access
-- Fix: `___FROM_JSON_OR_NULL_PARAMS___` template no longer crashes on fields with null `fieldPath` or null `fieldName`; comparator tolerates nulls
-- Fix: AI generator's top-level error path now logs the actual exception, not just a generic message
-- Fix: removed obsolete `df_generate_dart_models_gemeni` executable entry that referenced a non-existent script (superseded by `df_generate_dart_models_ai`)
-- Pulls in df_gen_core 0.8.0 with mapper robustness fixes
+- Released @ 6/2026 (UTC)
+- New: `fieldPath` dual-shape — dot-separated `String` or `Iterable<String>`; multi-segment paths emit deep null-aware accessors (`json?['profile']?['id']`)
+- New: enum detection without `Type`/`Enum` suffix — analyzer-driven via `@enum` sentinel; legacy suffix-based detection still works
+- New: Equatable opt-in by inheritance — `extends BaseModel` opts out (const-set-safe), everything else gets `EquatableMixin`
+- New: dialect support — `PG_*`, `SQLITE_*`, `FS_*`, `STRICT-` prefix vocabulary with composable mappers
+- New: DBML schema export via `df_generate_dbml` CLI — PKs, FKs, sized varchar/numeric, enums, JSONB columns
+- Fix: `fromOrNull` / `fromJsonStringOrNull` / `fromUriOrNull` templates honor the null-return contract (no more silent throws on the null/empty/wrong-path input)
+- Fix: AI prompt no longer collapses field path segments via `join('')` — uses `.` separator
+- Fix: AI generator uses safe `FieldUtils` accessors instead of dynamic property access
+- Fix: top-level catch logs the actual exception, not just a generic message
+- Removed: obsolete `df_generate_dart_models_gemeni` executable
+- Pulls in df_gen_core 0.8.0 and df_generate_dart_models_core 0.10.0
 
 ## [0.14.3]
 

example/lib/models/model_all_types/model_all_types.dart

@@ -111,7 +111,10 @@ class PaymentModel {
     // Special string-case types — base.
     Field(fieldPath: ['trimmed'], fieldType: 'Trimmed-String', nullable: true),
     Field(
-        fieldPath: ['noSpaces'], fieldType: 'NoSpaces-String', nullable: true,),
+      fieldPath: ['noSpaces'],
+      fieldType: 'NoSpaces-String',
+      nullable: true,
+    ),
     Field(
       fieldPath: ['searchable'],
       fieldType: 'Searchable-String',
@@ -143,7 +146,10 @@ class PaymentModel {
     ),
     Field(fieldPath: ['camel'], fieldType: 'CamelCase-String', nullable: true),
     Field(
-        fieldPath: ['pascal'], fieldType: 'PascalCase-String', nullable: true,),
+      fieldPath: ['pascal'],
+      fieldType: 'PascalCase-String',
+      nullable: true,
+    ),
 
     // Trimmed case conversions.
     Field(
@@ -192,7 +198,10 @@ class PaymentModel {
     Field(fieldPath: ['flags'], fieldType: Set<bool>, nullable: true),
     Field(fieldPath: ['scores'], fieldType: Iterable<int>, nullable: true),
     Field(
-        fieldPath: ['lookup'], fieldType: Map<String, double>, nullable: true,),
+      fieldPath: ['lookup'],
+      fieldType: Map<String, double>,
+      nullable: true,
+    ),
 
     // Queue (from-side was missing — verifies the asymmetry fix).
     Field(fieldPath: ['todo'], fieldType: Queue<String>, nullable: true),

lib/src/dart_firestore_type_mappers.dart

@@ -52,8 +52,7 @@ class DartFirestoreTypeMappers extends TypeMappers {
   //
 
   @override
-  TTypeMappers<CollectionMapperEvent> get collectionToMappers =>
-      newTypeMap({});
+  TTypeMappers<CollectionMapperEvent> get collectionToMappers => newTypeMap({});
 
   //
   //

lib/src/dart_postgres_type_mappers.dart

@@ -130,22 +130,22 @@ class DartPostgresTypeMappers extends TypeMappers {
                 _pgTail +
                 r'-(?:(Type-?\w+|\w+-?Type|Enum-?\w+|\w+-?Enum)|(\w+)@enum)\??$':
             (e) {
-          final typeName = (e.matchGroups?.elementAt(1)) ??
-              (e.matchGroups?.elementAt(2));
+          final typeName =
+              (e.matchGroups?.elementAt(1)) ?? (e.matchGroups?.elementAt(2));
           return '$typeName.values.valueOf(${e.name}?.toString())';
         },
 
         // ─── DDL-only ───────────────────────────────────────────────────────
         // All of these forward to the same code [DartCoreTypeMappers] uses
         // for the bare Dart type. The prefix only exists for schema export.
-        r'^PG_(?:text|varchar|char|citext|name|xml|uuid|inet|cidr|macaddr|macaddr8|tsvector|tsquery|money|pg_lsn|bit|oid)'
-                + _pgTail +
-                r'-(String)\??$': (e) {
+        r'^PG_(?:text|varchar|char|citext|name|xml|uuid|inet|cidr|macaddr|macaddr8|tsvector|tsquery|money|pg_lsn|bit|oid)' +
+            _pgTail +
+            r'-(String)\??$': (e) {
           return '${e.name}?.toString().trim().nullIfEmpty';
         },
-        r'^PG_(?:smallint|integer|bigint|int2|int4|int8|smallserial|serial|bigserial)'
-                + _pgTail +
-                r'-(int)\??$': (e) {
+        r'^PG_(?:smallint|integer|bigint|int2|int4|int8|smallserial|serial|bigserial)' +
+            _pgTail +
+            r'-(int)\??$': (e) {
           return 'letIntOrNull(${e.name})';
         },
         r'^PG_(?:real|float4|float8|double)' + _pgTail + r'-(double)\??$': (e) {
@@ -162,9 +162,8 @@ class DartPostgresTypeMappers extends TypeMappers {
         r'^PG_boolean' + _pgTail + r'-(bool)\??$': (e) {
           return 'letBoolOrNull(${e.name})';
         },
-        r'^PG_(?:timestamp|timestamptz|date)' +
-                _pgTail +
-                r'-(DateTime)\??$': (e) {
+        r'^PG_(?:timestamp|timestamptz|date)' + _pgTail + r'-(DateTime)\??$':
+            (e) {
           return '(){ final a = ${e.name}?.toString().trim().nullIfEmpty; return a != null ? DateTime.tryParse(a)?.toUtc(): null; }()';
         },
         r'^PG_interval' + _pgTail + r'-(Duration)\??$': (e) {
@@ -198,22 +197,21 @@ class DartPostgresTypeMappers extends TypeMappers {
         },
 
         // ─── DDL-only — same code Core emits for the bare type ───────────
-        r'^PG_(?:text|varchar|char|citext|name|xml|uuid|inet|cidr|macaddr|macaddr8|tsvector|tsquery|money|pg_lsn|bit|oid)'
-                + _pgTail +
-                r'-(String)\??$': (e) {
+        r'^PG_(?:text|varchar|char|citext|name|xml|uuid|inet|cidr|macaddr|macaddr8|tsvector|tsquery|money|pg_lsn|bit|oid)' +
+            _pgTail +
+            r'-(String)\??$': (e) {
           return '${e.name}?.trim().nullIfEmpty';
         },
-        r'^PG_(?:smallint|integer|bigint|int2|int4|int8|smallserial|serial|bigserial|real|float4|float8|double|boolean)'
-                + _pgTail +
-                r'-(int|double|bool)\??$': (e) {
+        r'^PG_(?:smallint|integer|bigint|int2|int4|int8|smallserial|serial|bigserial|real|float4|float8|double|boolean)' +
+            _pgTail +
+            r'-(int|double|bool)\??$': (e) {
           return '${e.name}';
         },
         r'^PG_numeric' + _pgTail + r'-(String|double)\??$': (e) {
           return '${e.name}';
         },
-        r'^PG_(?:timestamp|timestamptz|date)' +
-                _pgTail +
-                r'-(DateTime)\??$': (e) {
+        r'^PG_(?:timestamp|timestamptz|date)' + _pgTail + r'-(DateTime)\??$':
+            (e) {
           return '${e.name}?.toUtc().toIso8601String()';
         },
         r'^PG_interval' + _pgTail + r'-(Duration)\??$': (e) {

lib/src/dart_sqlite_type_mappers.dart

@@ -81,8 +81,8 @@ class DartSqliteTypeMappers extends TypeMappers {
           return '(){ final a = ${e.name}; return a != null ? jsonEncode(a.map((${e.args}) => MapEntry(${e.hashes},)).nonNulls.nullIfEmpty) : null; }()';
         },
         r'^SQLITE_(?:json|jsonb)' +
-                _sqliteTail +
-                r'-(List|Set|Iterable|Queue)\??$': (e) {
+            _sqliteTail +
+            r'-(List|Set|Iterable|Queue)\??$': (e) {
           return '(){ final a = ${e.name}; return a != null ? jsonEncode(a.map((${e.args}) => ${e.hashes},).nonNulls.nullIfEmpty?.toList()) : null; }()';
         },
       });
@@ -111,16 +111,16 @@ class DartSqliteTypeMappers extends TypeMappers {
           return '(){ final a = letDoubleOrNull(${e.name}); return a != null ? DateTime.fromMillisecondsSinceEpoch(((a - 2440587.5) * 86400000).round(), isUtc: true) : null; }()';
         },
         // JSON column with a nested model — same shape as PG_jsonb.
-        r'^SQLITE_(?:json|jsonb)' + _sqliteTail + r'-(Model-?\w+|\w+-?Model)\??$':
-            (e) {
+        r'^SQLITE_(?:json|jsonb)' +
+            _sqliteTail +
+            r'-(Model-?\w+|\w+-?Model)\??$': (e) {
           final typeName = e.matchGroups?.elementAt(1);
           return '() { final a = letMapOrNull<String, dynamic>(${e.name}); return a != null ? $typeName.fromJson(a): null; }()';
         },
 
         // ─── DDL-only — forward to Core's behaviour for the bare type ────
-        r'^SQLITE_(?:text|varchar|char|clob)' +
-                _sqliteTail +
-                r'-(String)\??$': (e) {
+        r'^SQLITE_(?:text|varchar|char|clob)' + _sqliteTail + r'-(String)\??$':
+            (e) {
           return '${e.name}?.toString().trim().nullIfEmpty';
         },
         r'^SQLITE_integer' + _sqliteTail + r'-(int)\??$': (e) {
@@ -163,15 +163,15 @@ class DartSqliteTypeMappers extends TypeMappers {
         r'^SQLITE_julianday' + _sqliteTail + r'-(DateTime)\??$': (e) {
           return '${e.name} != null ? (${e.name}!.toUtc().millisecondsSinceEpoch / 86400000) + 2440587.5 : null';
         },
-        r'^SQLITE_(?:json|jsonb)' + _sqliteTail + r'-(Model-?\w+|\w+-?Model)\??$':
-            (e) {
+        r'^SQLITE_(?:json|jsonb)' +
+            _sqliteTail +
+            r'-(Model-?\w+|\w+-?Model)\??$': (e) {
           return '${e.name} != null ? jsonEncode(${e.name}!.toJson()) : null';
         },
 
         // ─── DDL-only ────────────────────────────────────────────────────
-        r'^SQLITE_(?:text|varchar|char|clob)' +
-                _sqliteTail +
-                r'-(String)\??$': (e) {
+        r'^SQLITE_(?:text|varchar|char|clob)' + _sqliteTail + r'-(String)\??$':
+            (e) {
           return '${e.name}?.trim().nullIfEmpty';
         },
         r'^SQLITE_integer' + _sqliteTail + r'-(int)\??$': (e) {

lib/src/extract_insights_from_file.dart

@@ -51,7 +51,8 @@ Future<List<ClassInsight<GenerateDartModel>>> extractInsightsFromFile(
       final fullPathName = params.fullFilePath;
       final fileName = p.basename(fullPathName);
       final dirPath = p.dirname(fullPathName);
-      final supertypeName = _extractSupertypeName(fullPathName, params.className);
+      final supertypeName =
+          _extractSupertypeName(fullPathName, params.className);
       final insight = ClassInsight<GenerateDartModel>(
         className: params.className,
         annotation: temp,
@@ -257,9 +258,9 @@ String? _extractSupertypeName(String fullPathName, String className) {
     // The `extends` clause is optional (a class without it has no specific
     // supertype to inherit from); we only return a name when it's present.
     final pattern = RegExp(
-      r'(?:^|\n)\s*(?:abstract\s+)?(?:base\s+|final\s+|sealed\s+|interface\s+|mixin\s+)?class\s+'
-      + RegExp.escape(className) +
-      r'\b(?:<[^>]*>)?\s+extends\s+([A-Za-z_][\w]*)',
+      r'(?:^|\n)\s*(?:abstract\s+)?(?:base\s+|final\s+|sealed\s+|interface\s+|mixin\s+)?class\s+' +
+          RegExp.escape(className) +
+          r'\b(?:<[^>]*>)?\s+extends\s+([A-Za-z_][\w]*)',
     );
     final match = pattern.firstMatch(src);
     return match?.group(1);

lib/src/generate_dbml.dart

@@ -39,14 +39,12 @@ Future<void> generateDbml(
 
   final parser = CliParser(
     title: 'dev-cetera.com',
-    description:
-        'Generates a DBML schema file from classes annotated with '
+    description: 'Generates a DBML schema file from classes annotated with '
         '@GenerateDartModel. The PG_*-/SQLITE_*- prefixes on fieldType drive '
         'column types, `references:` drives FK Ref lines, and `primaryKey:` '
         'drives the `[pk]` constraint.',
     example: 'generate-dbml -i lib/src/db_models -o schema.dbml',
-    additional:
-        'For contributions, error reports and information, visit: '
+    additional: 'For contributions, error reports and information, visit: '
         'https://github.com/dev-cetera.',
     params: [
       DefaultFlags.HELP.flag,

pubspec.yaml

@@ -43,7 +43,7 @@ dependencies:
   df_config: ^0.8.0
   df_gen_core: ^0.8.0
   df_generate_dart_models_core: ^0.10.0
-  df_log: ^0.5.0
+  df_log: ^0.5.1
   df_string: ^0.3.0
   df_type: ^0.16.0
 

test/dart_composite_type_mappers_test.dart

@@ -36,8 +36,7 @@ class _Sentinel extends TypeMappers {
       newTypeMap({});
 
   @override
-  TTypeMappers<CollectionMapperEvent> get collectionToMappers =>
-      newTypeMap({});
+  TTypeMappers<CollectionMapperEvent> get collectionToMappers => newTypeMap({});
 
   @override
   TTypeMappers<MapperEvent> get objectFromMappers => newTypeMap({

test/dart_core_type_mappers_test.dart

@@ -227,8 +227,7 @@ void main() {
       expect(r, contains('toUtc()'));
     });
 
-    test('PG_jsonb-ModelXxx decodes via letMapOrNull then nested fromJson',
-        () {
+    test('PG_jsonb-ModelXxx decodes via letMapOrNull then nested fromJson', () {
       final r = mapFrom('PG_jsonb-ModelBulletinPage', name: 'v');
       expect(r, contains('letMapOrNull'));
       expect(r, contains('ModelBulletinPage.fromJson(a)'));
@@ -347,7 +346,9 @@ void main() {
   group('Tier 2 Flutter geometry types', () {
     test('Offset uses dx/dy map', () {
       expect(
-          mapFrom('Offset'), contains("Offset(letAsOrNull<double>(a['dx'])"),);
+        mapFrom('Offset'),
+        contains("Offset(letAsOrNull<double>(a['dx'])"),
+      );
       expect(mapTo('Offset'), "x != null ? {'dx': x!.dx, 'dy': x!.dy} : null");
     });
 
@@ -501,7 +502,8 @@ void main() {
       expect(r, contains('v!.toUtc()'));
     });
 
-    test('FS_server_timestamp-DateTime emits FieldValue.serverTimestamp() on '
+    test(
+        'FS_server_timestamp-DateTime emits FieldValue.serverTimestamp() on '
         'write', () {
       expect(
         mapTo('FS_server_timestamp-DateTime', name: 'v'),