registry/registry_tools library

Classes

ChartAutoSwitchResult

Non-throwing result for automatic chart-type switching.

ChartCapabilities

Capability metadata for a chart type.

ChartPayloadContract

Registry-owned payload contract for a chart type.

ChartRegistryHealthReport

Aggregated registry diagnostics for developer tooling and showcase views.

ChartSwitchCompatibility

Non-throwing compatibility result for a potential runtime chart switch.

ChartSwitchGroup

Runtime switch compatibility group for a data shape.

ChartSwitchOption

Ranked runtime switch candidate for a JSON chart payload.

ChartTypeSwitchResult

Non-throwing result for a requested chart-type switch.

RegistrationAuditIssue

Issue found while auditing a RegistrationBundle.

RegistrationBundleAudit

Audit result for a chart registration bundle.

Enums

ChartPayloadSeriesStrategy

Strategy used to derive series from shorthand JSON payload fields.

ChartSeriesDataShape

Data-shape groups used to pick compatible chart families.

RegistrationAuditSeverity

Properties

seriesShapeBundles → Map<ChartSeriesDataShape, RegistrationBundle>

Grouped bundles keyed by inferred data shape.

final

Functions

auditRegistrationBundle(RegistrationBundle bundle, {bool includeUnknownShapeWarnings = false}) → RegistrationBundleAudit

Audits bundle for duplicate types, duplicate keys, canonical drift, and missing shape data.

availableChartCapabilities({bool registeredOnly = true}) → List<ChartCapabilities>

Capability metadata for all compiled-in chart registrations.

chartCapabilitiesForRegistration(ChartRegistration reg) → ChartCapabilities

Returns capability metadata for a concrete ChartRegistration.

chartCapabilitiesForType(ChartType rawType) → ChartCapabilities

Returns capability metadata for type.

chartPayloadContractForType(ChartType rawType) → ChartPayloadContract

Returns the payload contract for type.

chartRegistryHealthReport({RegistrationBundle? bundle, bool registeredOnly = false, bool includeUnknownShapeWarnings = false}) → ChartRegistryHealthReport

Builds a consolidated health report for bundle.

chartSwitchCompatibilityForJson(Map<String, dynamic> source, {required ChartType targetType, bool registeredOnly = true}) → ChartSwitchCompatibility

Checks whether targetType can safely consume source without throwing.

chartSwitchOptionsForJson(Map<String, dynamic> source, {List<ChartType>? preferredOrder, bool includeCurrentType = false, bool registeredOnly = true}) → List<ChartSwitchOption>

Returns ranked switch candidates with capabilities and preview payloads.

chartTypeSupportsSeriesShape(ChartType type, ChartSeriesDataShape shape) → bool

Returns true when type can consume a series with shape.

chartUsesExternalDataModel(ChartType type) → bool

Returns true when type is parsed by a chart-specific data model instead of generic series validation.

compatibleChartTypesForConfig(BaseChartConfig config, {bool registeredOnly = true}) → List<ChartType>

Suggest chart types that can consume config based on series-data shape.

compatibleChartTypesForJson(Map<String, dynamic> json, {bool registeredOnly = true}) → List<ChartType>

Suggest chart types that can consume json based on series-data shape.

compatibleChartTypesForShape(ChartSeriesDataShape shape, {bool registeredOnly = true}) → List<ChartType>

Suggest chart types that can consume a series with shape.

getBundleForSeriesShape(ChartSeriesDataShape shape) → RegistrationBundle?

Returns a bundle with charts compatible to the provided data shape.

inferSeriesDataShape(Map<String, dynamic> json) → ChartSeriesDataShape

Detect the dominant data shape from JSON chart config.

rankedCompatibleChartTypesForJson(Map<String, dynamic> source, {List<ChartType>? preferredOrder, bool includeCurrentType = false, bool registeredOnly = true}) → List<ChartType>

Returns compatible target chart types ranked by preferredOrder.

registeredChartCapabilities() → List<ChartCapabilities>

Capability metadata for chart types known to the current registry.

switchChartTypeForSeriesShape(Map<String, dynamic> source, {required ChartType targetType, bool force = false}) → Map<String, dynamic>

Switch chart type while preserving/normalizing data where possible.

switchChartTypeForSeriesShapeAuto(Map<String, dynamic> source, {List<ChartType>? preferredOrder, bool includeCurrentType = false, bool registeredOnly = true}) → Map<String, dynamic>

Automatically switches source to the highest-ranked compatible chart type for its inferred data shape.

targetSeriesDataShape(ChartType rawType) → ChartSeriesDataShape

Returns the expected series-data shape for type.

trySwitchChartTypeForSeriesShape(Map<String, dynamic> source, {required ChartType targetType, bool force = false, bool registeredOnly = true}) → ChartTypeSwitchResult

Attempts to switch source to targetType without throwing.

trySwitchChartTypeForSeriesShapeAuto(Map<String, dynamic> source, {List<ChartType>? preferredOrder, bool includeCurrentType = false, bool registeredOnly = true}) → ChartAutoSwitchResult

Attempts to automatically switch source to the highest-ranked compatible chart type without throwing.