You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This internal architecture document mandates the precise structural logic, technical dependencies, caching behaviors, and quality integration required by the AppDimens Dynamic `library` package.
> **DOC_REF (maintainers):** bump every `3.1.4` URL in this skill and in `library-map.md` / `reference.md` together with the coordinate above on future releases.
10
+
> **DOC_REF (maintainers):** bump every `3.1.5` URL in this skill and in `library-map.md` / `reference.md` together with the coordinate above on future releases.
**Package map and strategy → doc index:**[library-map.md](library-map.md)
21
21
@@ -24,7 +24,7 @@ description: Use this skill for any Android responsive layout or scaling questio
24
24
## Agent Preflight (run before any non-trivial edit)
25
25
26
26
1. Read [library-map.md](library-map.md) for package layout and strategy ↔ doc mapping.
27
-
2. For the **specific packages/symbols** you'll touch: browse [`library/src/main/java/com/appdimens/dynamic/`](https://github.com/bodenberg/appdimens-dynamic/tree/3.1.4/library/src/main/java/com/appdimens/dynamic) on GitHub at `3.1.4`, **or** use IDE "Download Sources" / "Navigate to Declaration" on the Maven artifact. For API detail, see [DOCUMENTATION/index.md](https://github.com/bodenberg/appdimens-dynamic/blob/3.1.4/DOCUMENTATION/index.md) and per-package pages under [`DOCUMENTATION/KDOC/`](https://github.com/bodenberg/appdimens-dynamic/tree/3.1.4/DOCUMENTATION/KDOC). Do not rely on memory.
27
+
2. For the **specific packages/symbols** you'll touch: browse [`library/src/main/java/com/appdimens/dynamic/`](https://github.com/bodenberg/appdimens-dynamic/tree/3.1.5/library/src/main/java/com/appdimens/dynamic) on GitHub at `3.1.5`, **or** use IDE "Download Sources" / "Navigate to Declaration" on the Maven artifact. For API detail, see [DOCUMENTATION/index.md](https://github.com/bodenberg/appdimens-dynamic/blob/3.1.5/DOCUMENTATION/index.md) and per-package pages under [`DOCUMENTATION/KDOC/`](https://github.com/bodenberg/appdimens-dynamic/tree/3.1.5/DOCUMENTATION/KDOC). Do not rely on memory.
28
28
3. Skim the upstream example that matches the user's stack (links above). Restrict deep reading to **relevant packages and call sites** — full module audits only when explicitly requested.
29
29
30
30
**Hard rule:** never surface `ignoreMultiWindows`, `*i`, or `*ia` suffixes to users.
@@ -43,7 +43,7 @@ Which surface is in scope?
43
43
|--------|---------------|----------|
44
44
|**Jetpack Compose**|`com.appdimens.dynamic.compose.*`|`16.sdp`, `scaledDp { }`; needs `AppDimensProvider` for facilitators |
45
45
|**Kotlin (Views)**|`com.appdimens.dynamic.code.*`|`DimenSdp.sdp(context, 16)`; outputs px for layout |
46
-
|**Java (Views)**| same `code.*` entry points | see [ExampleActivity.java](https://github.com/bodenberg/appdimens-dynamic/blob/3.1.4/app/src/main/java/com/example/app/java/ExampleActivity.java)|
46
+
|**Java (Views)**| same `code.*` entry points | see [ExampleActivity.java](https://github.com/bodenberg/appdimens-dynamic/blob/3.1.5/app/src/main/java/com/example/app/java/ExampleActivity.java)|
47
47
48
48
Record: drives imports, `AppDimensProvider` need, and whether resize runs in `compose.resize` or `code.resize`.
49
49
@@ -54,7 +54,7 @@ Record: drives imports, `AppDimensProvider` need, and whether resize runs in `co
54
54
Which axis should `DpQualifier`-aware APIs use? (Affects `.sdpQualifier`, `.sdpScreen`, scaled `.sspRotate` vs strategy-prefixed Sp rotates such as `.asspRotate`, and their `code` mirrors.)
55
55
56
56
-**`SMALL_WIDTH` (default)** — smallest-width (swDP) baseline; correct for most phone/tablet layouts.
57
-
-**Explicit `WIDTH` / `HEIGHT` (or per-call-site mix)** — when design requires width-dp or height-dp branching. Read [COMPOSE-API-CONVENTIONS.md](https://github.com/bodenberg/appdimens-dynamic/blob/3.1.4/DOCUMENTATION/COMPOSE-API-CONVENTIONS.md) and `DpQualifier` KDoc before proposing thresholds.
57
+
-**Explicit `WIDTH` / `HEIGHT` (or per-call-site mix)** — when design requires width-dp or height-dp branching. Read [COMPOSE-API-CONVENTIONS.md](https://github.com/bodenberg/appdimens-dynamic/blob/3.1.5/DOCUMENTATION/COMPOSE-API-CONVENTIONS.md) and `DpQualifier` KDoc before proposing thresholds.
58
58
59
59
Record before suggesting any `.screen`, `.qualifier`, rotate, or power-curve APIs.
60
60
@@ -154,7 +154,7 @@ Ask in order, waiting for each answer before continuing:
154
154
4.**Bounds semantics** — clarify `ResizeBound.FixedDp` / `FixedSp` / `Percent` (sw/w/h axis). For percent-in-container resize, clarify `AutoResizePercentBasis` (min/max side, width, height) and use `autoResizeTextSpPercent` (Compose) or `fittingTextSpPercentPx` (code). Remind: `resolveToPx` requires `density > 0`; invalid inputs are clamped (library KDoc).
155
155
5.**Approach check** — global proportional sizing across the screen is usually scaled/percent/fluid, not resize. Reserve resize for fit-to-container problems.
0 commit comments