AppDimens Flutter

Packages (3.2.0): DOCUMENTATION/MODULES.md

Doc base (Git ref main): https://github.com/bodenberg/appdimens-flutter/blob/main/

This file supplements SKILL.md. Read it when you need package locations, resolution-mode symmetry, or core types.

Package layout

Paths at Git ref main. Full graph: MODULES.md · library-map.md.

• packages/appdimens_flutter/lib/src/common — DpQualifier, Inverter, DimensOrientation, UiModeType, UnitType.
• packages/appdimens_flutter/lib/src/core — ScreenConfiguration (immutable window config), DimenMetrics (per-window snapshot, eager factors), DimenCache (snapshot-partitioned; bypass rules; AppDimensScope fast-lane slot), DimenCalculationPlumbing, DimenScaledEngine, DesignScaleConstants, resize math (ResizeMath, ResizeBound, AutoResizePercentBasis).
• packages/appdimens_flutter/lib/src/scaled — num.sdp/hdp/wdp extensions + facilitators + Plain pairs, ssp/hsp/wsp + sem/hem/wem, DimenSdp/DimenSsp facades, explicit-context extensions, DimenScaled/ScaledSp builders.
• packages/appdimens_flutter/lib/src/flutter — AppDimensApp, AppDimensScopeBinder, AppDimensProvider, publishAppDimensContext.
• packages/appdimens_<strategy> — satellites: <strategy>_engine.dart + <strategy>_extensions.dart; generated by scripts/generate_satellites.py.
• packages/appdimens_resize — constraint resize widgets and range search (not a scaling curve).

Regenerate package metadata with scripts/generate_package_docs.py; publish order in PUBLISHING.md.

Strategy → documentation file

Package suffix	Doc
scaled	DOCUMENTATION/scaled.md
percent	DOCUMENTATION/percent.md
power	DOCUMENTATION/power.md
fluid	DOCUMENTATION/fluid.md
auto	DOCUMENTATION/auto.md
diagonal	DOCUMENTATION/diagonal.md
fill	DOCUMENTATION/fill.md
fit	DOCUMENTATION/fit.md
interpolated	DOCUMENTATION/interpolated.md
logarithmic	DOCUMENTATION/logarithmic.md
perimeter	DOCUMENTATION/perimeter.md
density	DOCUMENTATION/density.md
resize	DOCUMENTATION/resize.md
units (physical)	DOCUMENTATION/physical-units.md

Formal math: MATHEMATICS-AND-CALCULUS.md Migration from the deprecated 2.x API: MIGRATION.md

Example application modules

Upstream sample apps only (not part of the published packages); use for pattern reference:

• Sample — main.dart, demo_routing.dart, benchmark_screen.dart
• BenchLab — main.dart, benchmark_runner.dart, benchmark_models.dart

Internal CalcType (debug / cache tagging)

Maps to package families: auto, diagonal, fill, fit, fluid, interpolated, logarithmic, percent, perimeter, power, resize, scaled, unities, aspectRatio, density — see dimen_cache.dart. End users think in strategy names and imports, not this enum.

What this reference intentionally skips

Per the skill: do not expand on ignoreMultiWindows or *i / *ia suffix workflows when guiding users — those are omitted from the interactive workflow.