semiotic 3.5.2 → 3.5.4

package/dist/components/types/marginType.d.ts

@@ -8,8 +8,22 @@ export interface MarginType {
     left: number;
     right: number;
 }
+/** Public margin side value. Numbers pin a side to an exact pixel value.
+ *  `"auto"` and `null` explicitly leave that side to chart defaults plus
+ *  auto-reservation such as legends. */
+export type MarginSide = number | "auto" | null | undefined;
 /** Public-API margin shape. Users can pass any subset of sides (`{ left: 120 }`
  *  for wide y-axis labels is a common pattern) or a single number as shorthand
- *  for "same on all sides". The frame fills missing sides from the chart-mode
- *  defaults before handing a fully-resolved `MarginType` to the layout code. */
-export type PartialMargin = number | Partial<MarginType>;
+ *  for "same on all sides". Pass a side as `"auto"` or `null` to explicitly
+ *  opt back into chart auto-reservation for that side, e.g.
+ *  `{ right: "auto" }` with a right-side legend. The frame fills missing/auto
+ *  sides from chart-mode defaults before handing a fully-resolved
+ *  `MarginType` to the layout code. */
+export type PartialMargin = number | {
+    top?: MarginSide;
+    right?: MarginSide;
+    bottom?: MarginSide;
+    left?: MarginSide;
+};
+export declare function resolveMarginSide(value: MarginSide, fallback: number): number;
+export declare function normalizePartialMargin(m: PartialMargin | undefined): Partial<MarginType> | undefined;