@opendata-ai/openchart-core 6.4.1 → 6.5.1

package/src/styles/table.css

@@ -0,0 +1,380 @@
+/* ---------------------------------------------------------------------------
+ * Table base
+ * --------------------------------------------------------------------------- */
+
+.oc-table-wrapper {
+  font-family: var(--oc-font-family);
+  color: var(--oc-text);
+  background: var(--oc-bg);
+
+  & > .oc-chrome {
+    margin-bottom: 16px;
+  }
+
+  & table {
+    width: 100%;
+    border-collapse: collapse;
+  }
+
+  & th,
+  & td {
+    padding: 10px 16px;
+    text-align: left;
+    border-bottom: 1px solid var(--oc-border);
+  }
+
+  & th {
+    font-weight: 600;
+    font-size: 12px;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    color: var(--oc-text-secondary);
+    white-space: nowrap;
+  }
+
+  & thead {
+    position: sticky;
+    top: 0;
+    z-index: 2;
+    background: var(--oc-bg);
+  }
+
+  & thead th {
+    border-bottom-width: 2px;
+  }
+
+  & td {
+    font-size: 14px;
+    font-variant-numeric: tabular-nums;
+  }
+
+  & th:focus {
+    outline: 2px solid var(--oc-focus);
+    outline-offset: -2px;
+  }
+
+  & tbody:focus {
+    outline: none;
+  }
+}
+
+.oc-table-title {
+  margin-bottom: 4px;
+  font-size: var(--oc-title-computed-size, var(--oc-title-size));
+  font-weight: var(--oc-title-computed-weight, var(--oc-title-weight));
+  color: var(--oc-title-computed-color, var(--oc-text));
+}
+
+.oc-table-subtitle {
+  margin-bottom: 8px;
+  font-size: var(--oc-subtitle-computed-size, var(--oc-subtitle-size));
+  font-weight: var(--oc-subtitle-computed-weight, var(--oc-subtitle-weight));
+  color: var(--oc-subtitle-computed-color, var(--oc-text-secondary));
+}
+
+.oc-table-source {
+  font-size: var(--oc-source-computed-size, var(--oc-source-size));
+  color: var(--oc-source-computed-color, var(--oc-text-muted));
+}
+
+.oc-table-footer-text {
+  font-size: var(--oc-footer-computed-size, var(--oc-source-size));
+  color: var(--oc-footer-computed-color, var(--oc-text-muted));
+}
+
+.oc-table-scroll {
+  overflow-x: auto;
+}
+
+/* ---------------------------------------------------------------------------
+ * Sticky first column
+ * --------------------------------------------------------------------------- */
+
+.oc-table--sticky {
+  & th:first-child,
+  & td:first-child {
+    position: sticky;
+    left: 0;
+    z-index: 1;
+    background: var(--oc-bg);
+  }
+}
+
+/* ---------------------------------------------------------------------------
+ * Sort controls
+ * --------------------------------------------------------------------------- */
+
+.oc-table-sort-btn {
+  background: none;
+  border: none;
+  cursor: pointer;
+  padding: 2px;
+  margin-left: 6px;
+  display: inline-flex;
+  flex-direction: column;
+  align-items: center;
+  vertical-align: middle;
+  gap: 2px;
+
+  &::before,
+  &::after {
+    content: "";
+    display: block;
+    width: 0;
+    height: 0;
+    border-left: 5px solid transparent;
+    border-right: 5px solid transparent;
+    transition:
+      opacity 0.15s,
+      border-color 0.15s;
+  }
+
+  &::before {
+    border-bottom: 4.5px solid var(--oc-text-secondary);
+    opacity: 0.45;
+  }
+
+  &::after {
+    border-top: 4.5px solid var(--oc-text-secondary);
+    opacity: 0.45;
+  }
+
+  &:hover::before,
+  &:hover::after {
+    opacity: 0.75;
+  }
+}
+
+th[aria-sort="ascending"] .oc-table-sort-btn {
+  &::before {
+    opacity: 1;
+    border-bottom-color: var(--oc-text);
+  }
+
+  &::after {
+    opacity: 0.15;
+  }
+}
+
+th[aria-sort="descending"] .oc-table-sort-btn {
+  &::after {
+    opacity: 1;
+    border-top-color: var(--oc-text);
+  }
+
+  &::before {
+    opacity: 0.15;
+  }
+}
+
+/* ---------------------------------------------------------------------------
+ * Search
+ * --------------------------------------------------------------------------- */
+
+.oc-table-search {
+  padding: 8px 0;
+
+  & input {
+    width: 100%;
+    padding: 8px 12px;
+    border: 1px solid var(--oc-border);
+    border-radius: 6px;
+    font-size: 13px;
+    font-family: inherit;
+    background: var(--oc-bg);
+    color: var(--oc-text);
+    box-sizing: border-box;
+    transition: border-color 0.15s;
+
+    &::placeholder {
+      color: var(--oc-text-muted);
+      font-size: 13px;
+    }
+
+    &:focus {
+      outline: none;
+      border-color: var(--oc-focus);
+      box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
+    }
+  }
+}
+
+/* ---------------------------------------------------------------------------
+ * Pagination
+ * --------------------------------------------------------------------------- */
+
+.oc-table-pagination {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 12px 0 4px;
+  font-size: 13px;
+  color: var(--oc-text-secondary);
+
+  & button {
+    padding: 6px 14px;
+    border: 1px solid var(--oc-border);
+    border-radius: 6px;
+    background: var(--oc-bg);
+    color: var(--oc-text);
+    cursor: pointer;
+    font-size: 13px;
+    font-family: inherit;
+    transition:
+      background 0.15s,
+      border-color 0.15s;
+
+    &:disabled {
+      opacity: 0.35;
+      cursor: not-allowed;
+    }
+
+    &:hover:not(:disabled) {
+      background: var(--oc-hover-bg);
+      border-color: var(--oc-axis);
+    }
+
+    &:focus-visible {
+      outline: 2px solid var(--oc-focus);
+      outline-offset: 1px;
+    }
+  }
+}
+
+.oc-table-pagination-info {
+  font-variant-numeric: tabular-nums;
+}
+
+.oc-table-pagination-btns {
+  display: flex;
+  gap: 8px;
+}
+
+/* ---------------------------------------------------------------------------
+ * Bar cells
+ * --------------------------------------------------------------------------- */
+
+.oc-table-bar {
+  position: relative;
+}
+
+.oc-table-bar-fill {
+  position: absolute;
+  top: 6px;
+  left: 0;
+  bottom: 6px;
+  border-radius: 2px;
+  opacity: 0.15;
+  pointer-events: none;
+}
+
+.oc-table-bar-value {
+  position: relative;
+  z-index: 1;
+}
+
+/* ---------------------------------------------------------------------------
+ * Sparkline cells
+ * --------------------------------------------------------------------------- */
+
+.oc-table-sparkline {
+  display: block;
+  width: 100%;
+  position: relative;
+
+  & svg {
+    display: block;
+    width: 100%;
+    overflow: visible;
+  }
+}
+
+.oc-table-sparkline-dot {
+  position: absolute;
+  border-radius: 50%;
+  width: 5px;
+  height: 5px;
+}
+
+.oc-table-sparkline-labels {
+  display: flex;
+  justify-content: space-between;
+  font-size: 11px;
+  line-height: 1;
+}
+
+/* ---------------------------------------------------------------------------
+ * Image cells
+ * --------------------------------------------------------------------------- */
+
+.oc-table-image {
+  display: inline-block;
+  vertical-align: middle;
+
+  & img {
+    object-fit: cover;
+  }
+}
+
+.oc-table-image-rounded img {
+  border-radius: 50%;
+}
+
+/* ---------------------------------------------------------------------------
+ * Flag cells
+ * --------------------------------------------------------------------------- */
+
+.oc-table-flag {
+  font-size: 1.2em;
+}
+
+/* ---------------------------------------------------------------------------
+ * Compact mode
+ * --------------------------------------------------------------------------- */
+
+.oc-table--compact {
+  & th,
+  & td {
+    padding: 4px 8px;
+    font-size: 13px;
+  }
+
+  & th {
+    font-size: 11px;
+  }
+}
+
+/* ---------------------------------------------------------------------------
+ * Row hover (when onRowClick is set)
+ * --------------------------------------------------------------------------- */
+
+.oc-table--clickable tbody {
+  & tr {
+    cursor: pointer;
+  }
+
+  & tr:hover {
+    background: var(--oc-hover-bg);
+  }
+}
+
+/* ---------------------------------------------------------------------------
+ * Keyboard cell focus indicator
+ * --------------------------------------------------------------------------- */
+
+.oc-table-cell-focus {
+  outline: 2px solid var(--oc-focus);
+  outline-offset: -2px;
+}
+
+/* ---------------------------------------------------------------------------
+ * Empty state
+ * --------------------------------------------------------------------------- */
+
+.oc-table-empty {
+  padding: 32px 16px;
+  text-align: center;
+  color: var(--oc-text-secondary);
+  font-size: 14px;
+  font-style: italic;
+}

package/src/styles/tokens.css

@@ -0,0 +1,93 @@
+/* ---------------------------------------------------------------------------
+ * Custom properties (light mode defaults)
+ * --------------------------------------------------------------------------- */
+
+.oc-root,
+.oc-chart-root,
+.oc-table-wrapper,
+.oc-table-root,
+.oc-graph-wrapper,
+.oc-graph-root {
+  --oc-font-family: Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+  --oc-font-mono: "JetBrains Mono", "Fira Code", "Cascadia Code", monospace;
+
+  /* Animation easing presets via CSS linear() */
+  --oc-ease-smooth: linear(
+    0,
+    0.157,
+    0.438,
+    0.64,
+    0.766,
+    0.85,
+    0.906,
+    0.941,
+    0.964,
+    0.978,
+    0.988,
+    0.994,
+    0.998,
+    1
+  );
+  --oc-ease-snappy: linear(
+    0,
+    0.012,
+    0.048,
+    0.108,
+    0.194,
+    0.302,
+    0.426,
+    0.559,
+    0.69,
+    0.808,
+    0.905,
+    0.973,
+    1.013,
+    1.028,
+    1.023,
+    1.006,
+    0.984,
+    0.966,
+    0.957,
+    0.957,
+    0.964,
+    0.975,
+    0.986,
+    0.995,
+    1,
+    1.003,
+    1.002,
+    1,
+    0.998,
+    0.998,
+    0.999,
+    1
+  );
+
+  /* Animation timing defaults */
+  --oc-animation-duration: 500ms;
+  --oc-animation-stagger: 80ms;
+  --oc-annotation-delay: 200ms;
+  --oc-title-size: 22px;
+  --oc-title-weight: 700;
+  --oc-title-tracking: -0.02em;
+  --oc-subtitle-size: 14px;
+  --oc-subtitle-weight: 400;
+  --oc-source-size: 12px;
+  --oc-source-weight: 400;
+  --oc-body-size: 13px;
+  --oc-bg: #ffffff;
+  --oc-text: #1d1d1d;
+  --oc-text-secondary: #5c5c5c;
+  --oc-text-muted: #999999;
+  --oc-gridline: #e8e8e8;
+  --oc-axis: #888888;
+  --oc-border: #e2e2e2;
+  --oc-border-radius: 4px;
+  --oc-focus: #3b82f6;
+  --oc-hover-bg: rgba(0, 0, 0, 0.025);
+  --oc-tooltip-bg: rgba(255, 255, 255, 0.88);
+  --oc-tooltip-border: rgba(0, 0, 0, 0.08);
+  --oc-tooltip-shadow: 0 2px 8px rgba(0, 0, 0, 0.08), 0 0 1px rgba(0, 0, 0, 0.12);
+  --oc-tooltip-text: #1d1d1d;
+  --oc-legend-text: #555555;
+}

package/src/styles/tooltip.css

@@ -0,0 +1,88 @@
+/* ---------------------------------------------------------------------------
+ * Tooltip
+ * --------------------------------------------------------------------------- */
+
+.oc-tooltip {
+  position: absolute;
+  display: none;
+  pointer-events: none;
+  z-index: 1000;
+  background: var(--oc-tooltip-bg);
+  backdrop-filter: blur(12px);
+  border: 1px solid var(--oc-tooltip-border);
+  border-radius: 8px;
+  box-shadow: var(--oc-tooltip-shadow);
+  color: var(--oc-tooltip-text);
+  font-family: var(--oc-font-family);
+  font-size: 12px;
+  padding: 0;
+  max-width: 260px;
+  min-width: 140px;
+  line-height: 1.4;
+  animation: oc-tooltip-in 120ms ease-out;
+
+  & .oc-tooltip-header {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    padding: 8px 12px 6px;
+  }
+
+  & .oc-tooltip-dot {
+    width: 8px;
+    height: 8px;
+    border-radius: 50%;
+    flex-shrink: 0;
+  }
+
+  & .oc-tooltip-title {
+    font-weight: 600;
+    font-size: 12px;
+    letter-spacing: -0.01em;
+    color: var(--oc-tooltip-text);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  & .oc-tooltip-body {
+    padding: 4px 12px 8px;
+    border-top: 1px solid var(--oc-tooltip-border);
+  }
+
+  /* Only add separator when header is present */
+  & .oc-tooltip-header + .oc-tooltip-body {
+    padding-top: 6px;
+  }
+
+  /* No separator when body is the only child */
+  & .oc-tooltip-body:first-child {
+    border-top: none;
+    padding-top: 8px;
+  }
+
+  & .oc-tooltip-row {
+    display: flex;
+    align-items: baseline;
+    justify-content: space-between;
+    gap: 12px;
+    padding: 1px 0;
+  }
+
+  & .oc-tooltip-label {
+    color: var(--oc-text-muted);
+    font-size: 11px;
+    white-space: nowrap;
+    flex-shrink: 0;
+  }
+
+  & .oc-tooltip-value {
+    font-weight: 500;
+    font-size: 11px;
+    font-variant-numeric: tabular-nums;
+    text-align: right;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+}

package/src/types/index.ts

@@ -57,6 +57,7 @@ export type {
   PointMark,
   Rect,
   RectMark,
+  ResolvedAnimation,
   ResolvedAnnotation,
   ResolvedChrome,
   ResolvedChromeElement,
@@ -80,6 +81,11 @@ export type {
 // Spec types (user input)
 export type {
   AggregateOp,
+  AnimationConfig,
+  AnimationEase,
+  AnimationPhaseConfig,
+  AnimationSpec,
+  AnimationStagger,
   Annotation,
   AnnotationAnchor,
   AnnotationOffset,

package/src/types/layout.ts

@@ -217,6 +217,8 @@ export interface LineMark {
   label?: ResolvedLabel;
   /** Accessibility attributes. */
   aria: MarkAria;
+  /** Index for stagger animation ordering. */
+  animationIndex?: number;
 }
 
 /**
@@ -257,6 +259,8 @@ export interface AreaMark {
   }>;
   /** Accessibility attributes. */
   aria: MarkAria;
+  /** Index for stagger animation ordering. */
+  animationIndex?: number;
 }
 
 /**
@@ -287,6 +291,14 @@ export interface RectMark {
   label?: ResolvedLabel;
   /** Accessibility attributes. */
   aria: MarkAria;
+  /** Index for stagger animation ordering. */
+  animationIndex?: number;
+  /** Bar orientation for animation direction. Set by the engine based on encoding. */
+  orient?: 'horizontal' | 'vertical';
+  /** Stacking group key (e.g. category name). Segments sharing this key animate together. */
+  stackGroup?: string;
+  /** Position of this segment within its stack group (0, 1, 2...). Set by engine for stacked bars. */
+  stackPos?: number;
 }
 
 /**
@@ -321,6 +333,8 @@ export interface ArcMark {
   label?: ResolvedLabel;
   /** Accessibility attributes. */
   aria: MarkAria;
+  /** Index for stagger animation ordering. */
+  animationIndex?: number;
 }
 
 /**
@@ -349,6 +363,8 @@ export interface PointMark {
   label?: ResolvedLabel;
   /** Accessibility attributes. */
   aria: MarkAria;
+  /** Index for stagger animation ordering. */
+  animationIndex?: number;
 }
 
 /**
@@ -381,6 +397,8 @@ export interface TextMarkLayout {
   label?: ResolvedLabel;
   /** Accessibility attributes. */
   aria: MarkAria;
+  /** Index for stagger animation ordering. */
+  animationIndex?: number;
 }
 
 /**
@@ -409,6 +427,8 @@ export interface RuleMarkLayout {
   data: Record<string, unknown>;
   /** Accessibility attributes. */
   aria: MarkAria;
+  /** Index for stagger animation ordering. */
+  animationIndex?: number;
 }
 
 /**
@@ -435,6 +455,8 @@ export interface TickMarkLayout {
   data: Record<string, unknown>;
   /** Accessibility attributes. */
   aria: MarkAria;
+  /** Index for stagger animation ordering. */
+  animationIndex?: number;
 }
 
 /** Discriminated union of all mark types. */
@@ -586,6 +608,26 @@ export interface A11yMetadata {
   keyboardNavigable: boolean;
 }
 
+// ---------------------------------------------------------------------------
+// Animation (resolved)
+// ---------------------------------------------------------------------------
+
+/** Resolved entrance animation config with all defaults applied. */
+export interface ResolvedAnimation {
+  /** Whether entrance animation is enabled. */
+  enabled: boolean;
+  /** Duration in ms. */
+  duration: number;
+  /** Easing preset name. */
+  ease: import('./spec').AnimationEase;
+  /** Stagger delay between elements in ms. */
+  staggerDelay: number;
+  /** Stagger ordering. */
+  staggerOrder: 'index' | 'value' | 'reverse';
+  /** Delay before annotations animate in (ms after marks). */
+  annotationDelay: number;
+}
+
 // ---------------------------------------------------------------------------
 // ChartLayout (the main engine output for charts)
 // ---------------------------------------------------------------------------
@@ -622,6 +664,8 @@ export interface ChartLayout {
   theme: ResolvedTheme;
   /** Total SVG dimensions. */
   dimensions: { width: number; height: number };
+  /** Resolved animation config. Present only when animation is enabled. */
+  animation?: ResolvedAnimation;
 }
 
 // ---------------------------------------------------------------------------
@@ -796,6 +840,8 @@ export interface TableLayout {
   a11y: { caption: string; summary: string };
   /** The resolved theme. */
   theme: ResolvedTheme;
+  /** Resolved animation config. Present only when animation is enabled. */
+  animation?: ResolvedAnimation;
 }
 
 // ---------------------------------------------------------------------------