@opendata-ai/openchart-core 6.3.0 → 6.5.0

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/events.ts

@@ -25,13 +25,45 @@ import type {
 /** Identifies a specific chrome text element (title, subtitle, source, byline, footer). */
 export type ChromeKey = 'title' | 'subtitle' | 'source' | 'byline' | 'footer';
 
+// ---------------------------------------------------------------------------
+// Element references (identity for selection/edit callbacks)
+// ---------------------------------------------------------------------------
+
+/**
+ * Reference to an editable chart element.
+ * Carries enough info to find the element in both the spec and the DOM.
+ * The `annotation` variant uses two-tier identity: `id` (when the consumer provides one)
+ * and `index` (always available, position in the spec's annotations array).
+ */
+export type ElementRef =
+  | { type: 'annotation'; index: number; id?: string }
+  | { type: 'chrome'; key: ChromeKey }
+  | { type: 'series-label'; series: string }
+  | { type: 'legend' }
+  | { type: 'legend-entry'; series: string; index: number };
+
+/** Helper constructors for ergonomic ElementRef creation. */
+export const elementRef = {
+  annotation: (index: number, id?: string): ElementRef => ({ type: 'annotation', index, id }),
+  chrome: (key: ChromeKey): ElementRef => ({ type: 'chrome', key }),
+  seriesLabel: (series: string): ElementRef => ({ type: 'series-label', series }),
+  legend: (): ElementRef => ({ type: 'legend' }),
+  legendEntry: (series: string, index: number): ElementRef => ({
+    type: 'legend-entry',
+    series,
+    index,
+  }),
+} as const;
+
 // ---------------------------------------------------------------------------
 // Element edit events
 // ---------------------------------------------------------------------------
 
 /**
  * Discriminated union of all element edit events.
- * Fired by the `onEdit` callback when any editable chart element is repositioned.
+ * Fired by the `onEdit` callback when any editable chart element is modified.
+ * Covers repositioning (drag), deletion (Delete key), and text editing (double-click).
+ * Selection events (onSelect/onDeselect) are separate callbacks, not part of this union.
  */
 export type ElementEdit =
   | { type: 'annotation'; annotation: TextAnnotation; offset: AnnotationOffset }
@@ -46,7 +78,9 @@ export type ElementEdit =
   | { type: 'chrome'; key: ChromeKey; text: string; offset: AnnotationOffset }
   | { type: 'series-label'; series: string; offset: AnnotationOffset }
   | { type: 'legend'; offset: AnnotationOffset }
-  | { type: 'legend-toggle'; series: string; hidden: boolean };
+  | { type: 'legend-toggle'; series: string; hidden: boolean }
+  | { type: 'delete'; element: ElementRef }
+  | { type: 'text-edit'; element: ElementRef; oldText: string; newText: string };
 
 // ---------------------------------------------------------------------------
 // Mark events
@@ -92,6 +126,12 @@ export interface ChartEventHandlers {
   onAnnotationClick?: (annotation: Annotation, event: MouseEvent) => void;
   /** Called when a text annotation label is dragged to a new position. */
   onAnnotationEdit?: (annotation: TextAnnotation, updatedOffset: AnnotationOffset) => void;
-  /** Unified edit callback. Fires for any editable chart element (annotations, chrome, legend, series labels). */
+  /** Unified edit callback. Fires for any spec-modifying edit (repositioning, deletion, text editing). */
   onEdit?: (edit: ElementEdit) => void;
+  /** Fired when an element is selected via click or programmatic select(). */
+  onSelect?: (element: ElementRef) => void;
+  /** Fired when the current element is deselected (click empty, Escape, or new selection replaces old). */
+  onDeselect?: (element: ElementRef) => void;
+  /** Fired when inline text editing commits. Also flows through onEdit as a 'text-edit' event. */
+  onTextEdit?: (element: ElementRef, oldText: string, newText: string) => void;
 }

package/src/types/index.ts

@@ -21,8 +21,10 @@ export type {
   ChartEventHandlers,
   ChromeKey,
   ElementEdit,
+  ElementRef,
   MarkEvent,
 } from './events';
+export { elementRef } from './events';
 // Layout types (engine output)
 export type {
   A11yMetadata,
@@ -55,6 +57,7 @@ export type {
   PointMark,
   Rect,
   RectMark,
+  ResolvedAnimation,
   ResolvedAnnotation,
   ResolvedChrome,
   ResolvedChromeElement,
@@ -78,6 +81,11 @@ export type {
 // Spec types (user input)
 export type {
   AggregateOp,
+  AnimationConfig,
+  AnimationEase,
+  AnimationPhaseConfig,
+  AnimationSpec,
+  AnimationStagger,
   Annotation,
   AnnotationAnchor,
   AnnotationOffset,