@graphysdk/viz-engine 0.0.1-experimental.2 → 0.0.1-experimental.4

package/dist/index.d.ts

@@ -110,6 +110,29 @@ declare interface AnnotationDataPoint {
     rowValue?: DataValue;
 }
 
+/**
+ * Attach annotations to a spec. Multiple `annotations(...)` items append within
+ * each group (like `geom` layers and `highlight`s), they don't replace.
+ *
+ * @example
+ * pipe(
+ *   createSpec({ x: 'quarter', y: 'revenue' }),
+ *   geom.bar(),
+ *   scale.x(),
+ *   scale.y(),
+ *   annotations({
+ *     differenceArrows: [
+ *       {
+ *         start: { anchorValue: 'Q1', groupValue: null },
+ *         end: { anchorValue: 'Q3', groupValue: null },
+ *         label: 'relative-difference',
+ *       },
+ *     ],
+ *   }),
+ * );
+ */
+export declare const annotations: (input: AnnotationsInput) => AnnotationsItem;
+
 /**
  * Compiles annotations into a render-ready format.
  *
@@ -143,6 +166,12 @@ export declare interface AnnotationsInput {
     comments?: CommentAnnotationInput[];
 }
 
+/** Annotations as a pipeable spec item. Produced by {@link annotations}. */
+export declare interface AnnotationsItem {
+    type: 'annotations';
+    annotations: AnnotationsInput;
+}
+
 /** Resolved annotations for a chart, with every group present and all fields defaulted. */
 export declare interface AnnotationsSpec {
     differenceArrows: DifferenceArrowSpec[];
@@ -4309,10 +4338,12 @@ declare class LayerValidator {
 }
 
 /**
- * Outer padding around the whole chart, in pixels. Already baked into every {@link GraphLayout} rect
- * (rects start at this inset), so don't re-add it when painting — it is exported only so callers can
- * reconcile against the container edge. The per-region gaps below are intentionally internal; trust the
- * returned rects rather than reproducing the spacing.
+ * Default outer padding around the whole chart, in pixels. Used when {@link buildLayoutGrid} is called
+ * without an explicit `padding` (the renderer threads a resolved theme token in to override it). Once
+ * resolved it is baked into every {@link GraphLayout} rect (rects start at this inset), so don't re-add
+ * it when painting — the constant is exported only so callers can reconcile against the container edge.
+ * The per-region gaps below are intentionally internal; trust the returned rects rather than
+ * reproducing the spacing.
  */
 export declare const LAYOUT_PADDING = 24;
 
@@ -4401,6 +4432,12 @@ export declare interface LayoutCompilerInput {
      * right panel-edge padding; otherwise it is inert.
      */
     textScale?: number;
+    /**
+     * Outer padding around the whole chart, in pixels, applied uniformly on all four sides. Defaults to
+     * {@link LAYOUT_PADDING} when omitted. Renderers thread a resolved theme token here so a consumer can
+     * tighten or loosen the frame (e.g. a borderless, recolored chart that wants less surrounding space).
+     */
+    padding?: number;
 }
 
 /** Positions where axes/labels/legends can be placed around the panel. */
@@ -5917,7 +5954,7 @@ export declare interface SpecInput {
     config: ConfigInput;
 }
 
-declare type SpecItem = LayerInput | ScaleInput | CoordInput | ConfigItem | TransformInput | MappingItem | HighlightInput;
+declare type SpecItem = LayerInput | ScaleInput | CoordInput | ConfigItem | TransformInput | MappingItem | HighlightInput | AnnotationsItem;
 
 /**
  * Compiles a raw compiler input or graph config into a resolved Spec.