feat(mix_protocol): support contributed styler vocabularies (#1027)

Author: leoafarias

melos.yaml

@@ -28,6 +28,7 @@ categories:
   flutter_projects:
     - packages/mix
     - packages/mix_protocol
+    - packages/mix_chart_protocol
     - packages/mix_winds
     - packages/mix_winds/example
     - packages/mix_chart
@@ -46,8 +47,8 @@ scripts:
     description: Run all static analysis checks.
 
   schema:inventory:
-    run: melos exec --scope="mix_protocol" -- dart run tool/inventory_check.dart --check
-    description: Verify mix_protocol inventory coverage decisions.
+    run: melos exec --scope="mix_protocol" -- dart run tool/inventory_check.dart --check && melos exec --scope="mix_chart_protocol" -- dart run tool/inventory_check.dart
+    description: Verify protocol vocabulary inventory coverage decisions.
 
   analyze:dart:
     run: melos exec -c 4 -- dart analyze .

packages/mix_chart_protocol/CHANGELOG.md

@@ -0,0 +1,10 @@
+## Unreleased
+
+- Added the version-one `mix_chart` vocabulary with codecs and generated
+  runtime and command-line inventory coverage for all 15 public chart stylers.
+- Added the ready-to-use `mixChartProtocol` composition and centralized styler
+  metadata wiring without changing the chart v1 wire contract.
+
+## 0.0.1-dev.0
+
+- Initial unpublished sidecar package.

packages/mix_chart_protocol/README.md

@@ -0,0 +1,43 @@
+# mix_chart_protocol
+
+`mix_chart_protocol` is the optional integration between the publishable
+`mix_chart` runtime and `mix_protocol`. It depends on both packages so
+`mix_chart` does not have to make serialization part of every chart app.
+
+Use the ready-to-use protocol for the common core-plus-chart composition:
+
+```dart
+import 'package:mix_chart_protocol/mix_chart_protocol.dart';
+
+final encoded = mixChartProtocol.encodeStyle(chartStyle);
+```
+
+Applications, servers, and tooling opt into this sidecar only when they cross a
+JSON boundary. `mix_chart` itself must not depend on it: Dart packages have no
+optional dependencies, and most chart rendering does not need the protocol.
+
+Use the exported vocabulary directly only when combining charts with another
+package vocabulary:
+
+```dart
+import 'package:mix_chart_protocol/mix_chart_protocol.dart';
+
+final protocol = MixProtocol.compose([
+  mixProtocolCoreVocabulary,
+  mixChartVocabulary,
+  anotherVocabulary,
+]);
+```
+
+The sidecar re-exports the protocol API used by `mixChartProtocol`, so this
+integration needs only one protocol import.
+
+The vocabulary uses the `mix_chart.v1.*` namespace and contains all 15 chart
+stylers, including shared nested stylers. Core stylers such as `TextStyler`
+inside chart labels recurse through the same composed union. Variants,
+modifiers, animation, property terms, tokens, and lenient decoding use the
+ordinary `mix_protocol` grammar.
+
+This sidecar is unpublished while `mix_protocol` is unpublished. Keeping it
+separate preserves `mix_chart`'s existing publish contract and avoids exposing
+the private Ack implementation.

packages/mix_chart_protocol/analysis_options.yaml

@@ -0,0 +1,8 @@
+include: ../../lints_with_dcm.yaml
+
+dart_code_metrics:
+  rules:
+    avoid-inferrable-type-arguments:
+      # Dart cannot infer the F-bounded Spec type from Styler alone.
+      ignored-invocations:
+        - MixProtocolStylerCodec.forStyler

packages/mix_chart_protocol/lib/mix_chart_protocol.dart

@@ -0,0 +1,16 @@
+/// `mix_protocol` vocabulary for every public `mix_chart` styler.
+library;
+
+import 'package:mix_protocol/mix_protocol.dart'
+    show MixProtocol, mixProtocolCoreVocabulary;
+
+import 'src/mix_chart_vocabulary.dart';
+
+export 'package:mix_protocol/mix_protocol.dart';
+export 'src/mix_chart_vocabulary.dart' show mixChartVocabulary;
+
+/// Ready-to-use protocol containing the core Mix and chart vocabularies.
+final MixProtocol mixChartProtocol = MixProtocol.compose([
+  mixProtocolCoreVocabulary,
+  mixChartVocabulary,
+]);