graphein 0.10.0 → 0.12.0

package/dist/index.d.ts

@@ -1371,6 +1371,12 @@ interface BarSpec extends BaseSpec {
         x: FieldDef;
         y: FieldDef;
     };
+    /**
+     * Bar direction. `'vertical'` (default) draws columns growing up from the
+     * x-axis; `'horizontal'` draws bars growing rightward from the y-axis, with the
+     * `x` categories listed down the left — ideal when category names are long.
+     * The `encoding` is unchanged either way (`x` = category, `y` = value).
+     */
     orientation?: 'vertical' | 'horizontal';
     /** Stack series (default false). */
     stack?: boolean;
@@ -3100,6 +3106,23 @@ interface CartesianModel {
     series: ResolvedSeries[];
     seriesField?: string;
     stacked: boolean;
+    /**
+     * Bar orientation. Only `bar` ever sets `'horizontal'`; every other chart is
+     * `'vertical'`. In horizontal mode the `x` (category/band) axis runs vertically
+     * and the `y` (value) axis runs horizontally — so `x.pixel`/`x.bandwidth` are
+     * vertical extents and `y.pixel`/`y.baseline` are horizontal ones. Consumers map
+     * an (category-axis, value-axis) pixel pair to screen coords via {@link project}.
+     */
+    orientation: 'vertical' | 'horizontal';
+    /**
+     * Map a (category-axis pixel, value-axis pixel) pair to screen `{x, y}`,
+     * accounting for orientation. Vertical is the identity; horizontal swaps the
+     * pair (value → screen x, category → screen y).
+     */
+    project(catPixel: number, valPixel: number): {
+        x: number;
+        y: number;
+    };
     xTicks: Tick[];
     yTicks: Tick[];
     colorOf(key: string): string;