@gridui/metrics-section 1.1.1 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,10 +3,20 @@
3
3
  Landing family. Public API: `MetricsSection`, `MetricsSectionItem`, `MetricsSectionProps`.
4
4
 
5
5
  Import components from `@gridui/metrics-section` and load `@gridui/metrics-section/styles.css` after Theme.
6
- Load styles for any composed dependency used by this family. Applications own routes, labels, state persistence, and branding.
6
+ Applications own routes, labels, state persistence, and branding.
7
7
 
8
8
  See [component ownership](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/component-ownership.md) and [release history](https://github.com/sudo-ui/GridUI-React-Monorepo/tree/main/packages-landing/metrics-section/.changeset/history).
9
9
 
10
+ ## Styles
11
+
12
+ Load Theme once. Use `@gridui/metrics-section/styled` for automatic component CSS in
13
+ CSS-aware bundlers, or keep the CSS-free root import and load `@gridui/metrics-section/styles.css`.
14
+ Both entries expose the same root API. The standalone stylesheet includes component
15
+ dependency styles; Theme/reset remain separate. See the
16
+ [integration guide](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/usage/integration.md)
17
+ for static HTML loading, SSR limits, and avoiding duplicate CSS.
18
+
19
+
10
20
  ## Metric sections
11
21
 
12
22
  `MetricsSection` from `@gridui/metrics-section` composes a full-width summary heading and Metric
@@ -29,3 +39,10 @@ own requests, calculations, formatting, localized text, and retry actions.
29
39
 
30
40
  Each Metric item may also provide direction, align, valueSize and supplementary.
31
41
  The section retains ownership of its Grid layout and loading/error boundaries.
42
+
43
+ ## Sizing and density
44
+
45
+ MetricsSectionItem continues to accept Metric valueSize per item. Section padding and loading state are independent; a typography choice does not become a whole-section control size.
46
+
47
+ See the [shared sizing contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/usage/sizing.md)
48
+ for native attributes, scope precedence, tokens and target behavior.
package/dist/styled.js ADDED
@@ -0,0 +1,6 @@
1
+ import "@gridui/grid/styled";
2
+ import "@gridui/loading-surface/styled";
3
+ import "@gridui/metric/styled";
4
+ import "@gridui/panel/styled";
5
+ import "./styles.local.css";
6
+ export * from "./index.js";