feat(labels): add boolean shorthand for labels spec

Accept `labels: false` to disable all labels or `labels: true` for
defaults, in addition to the existing LabelConfig object. Works in
top-level specs, layer specs, and responsive breakpoint overrides.

Author: rileyhilliard

packages/core/src/types/index.ts

@@ -127,6 +127,7 @@ export type {
   GraphSpecWithoutData,
   LabelConfig,
   LabelDensity,
+  LabelSpec,
   LayerSpec,
   LegendConfig,
   LinearGradient,

packages/core/src/types/spec.ts

@@ -705,6 +705,9 @@ export interface LabelConfig {
   offsets?: Record<string, AnnotationOffset>;
 }
 
+/** Shorthand: `false` disables all labels, `true` uses defaults, or pass a full config object. */
+export type LabelSpec = boolean | LabelConfig;
+
 // ---------------------------------------------------------------------------
 // Legend configuration
 // ---------------------------------------------------------------------------
@@ -813,7 +816,7 @@ export interface ChartSpecOverride {
   /** Override editorial chrome at this breakpoint. */
   chrome?: Chrome;
   /** Override label configuration at this breakpoint. */
-  labels?: LabelConfig;
+  labels?: LabelSpec;
   /** Override legend configuration at this breakpoint. */
   legend?: LegendConfig;
   /** Override annotations at this breakpoint. */
@@ -846,8 +849,8 @@ export interface ChartSpec {
   chrome?: Chrome;
   /** Data annotations (text callouts, highlighted ranges, reference lines). */
   annotations?: Annotation[];
-  /** Label display configuration (density, format). */
-  labels?: LabelConfig;
+  /** Label display configuration. `false` disables all labels, `true` uses defaults. */
+  labels?: LabelSpec;
   /** Legend display configuration (position override). */
   legend?: LegendConfig;
   /** Whether the chart adapts to container width. Defaults to true. */
@@ -1019,8 +1022,8 @@ export interface LayerSpec {
   chrome?: Chrome;
   /** Annotations on the layered view. */
   annotations?: Annotation[];
-  /** Label display configuration. */
-  labels?: LabelConfig;
+  /** Label display configuration. `false` disables all labels, `true` uses defaults. */
+  labels?: LabelSpec;
   /** Legend display configuration. */
   legend?: LegendConfig;
   /** Whether the chart adapts to container width. Defaults to true. */

packages/engine/src/compile.ts

@@ -237,14 +237,23 @@ export function compileChart(spec: unknown, options: CompileOptions): ChartLayou
         },
       };
     }
-    if (bp.labels) {
-      chartSpec = {
-        ...chartSpec,
-        labels: {
-          ...chartSpec.labels,
-          ...(bp.labels as NormalizedChartSpec['labels']),
-        },
-      };
+    if (bp.labels !== undefined) {
+      if (typeof bp.labels === 'boolean') {
+        chartSpec = {
+          ...chartSpec,
+          labels: bp.labels
+            ? { density: 'auto', format: '', prefix: '' }
+            : { density: 'none', format: '', prefix: '' },
+        };
+      } else {
+        chartSpec = {
+          ...chartSpec,
+          labels: {
+            ...chartSpec.labels,
+            ...(bp.labels as NormalizedChartSpec['labels']),
+          },
+        };
+      }
     }
     if (bp.legend) {
       chartSpec = {

packages/engine/src/compiler/normalize.ts

@@ -17,6 +17,7 @@ import type {
   Encoding,
   FieldType,
   GraphSpec,
+  LabelSpec,
   LayerSpec,
   SankeySpec,
   TableSpec,
@@ -189,6 +190,21 @@ function normalizeAnnotations(annotations: Annotation[] | undefined): Annotation
   });
 }
 
+// ---------------------------------------------------------------------------
+// Label normalization
+// ---------------------------------------------------------------------------
+
+function normalizeLabels(labels?: LabelSpec): NormalizedChartSpec['labels'] {
+  if (labels === false) return { density: 'none', format: '', prefix: '' };
+  if (labels === true || labels === undefined) return { density: 'auto', format: '', prefix: '' };
+  return {
+    density: labels.density ?? 'auto',
+    format: labels.format ?? '',
+    prefix: labels.prefix ?? '',
+    offsets: labels.offsets,
+  };
+}
+
 // ---------------------------------------------------------------------------
 // Spec-level normalization
 // ---------------------------------------------------------------------------
@@ -205,12 +221,7 @@ function normalizeChartSpec(spec: ChartSpec, warnings: string[]): NormalizedChar
     encoding,
     chrome: normalizeChrome(spec.chrome),
     annotations: normalizeAnnotations(spec.annotations),
-    labels: {
-      density: spec.labels?.density ?? 'auto',
-      format: spec.labels?.format ?? '',
-      prefix: spec.labels?.prefix ?? '',
-      offsets: spec.labels?.offsets,
-    },
+    labels: normalizeLabels(spec.labels),
     legend: spec.legend,
     responsive: spec.responsive ?? true,
     theme: spec.theme ?? {},

packages/vanilla/src/mount.ts

@@ -1181,8 +1181,9 @@ function wireSeriesLabelDrag(
   const labels = svg.querySelectorAll('.oc-mark-label');
   const cleanups: Array<() => void> = [];
 
-  // Read existing label offsets from the spec
-  const labelsConfig = 'labels' in spec ? spec.labels : undefined;
+  // Read existing label offsets from the spec (skip boolean shorthand)
+  const rawLabels = 'labels' in spec ? spec.labels : undefined;
+  const labelsConfig = typeof rawLabels === 'object' ? rawLabels : undefined;
 
   for (const label of labels) {
     const labelEl = label as SVGTextElement;