@macrostrat/column-views 3.4.2 → 3.5.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [3.5.0] - 2026-05-24 [_changes_](https://github.com/UW-Macrostrat/web-components/compare/@macrostrat/column-views-v3.4.2...@macrostrat/column-views-v3.5.0)
+
+### Minor Changes
+
+- Createa a basic ColumnRef interface
+
+### Patch Changes
+
+- Updated dependencies
+- Updated dependencies
+  - @macrostrat/data-components@1.1.12
+  - @macrostrat/data-provider@1.1.0
+
 ## [3.4.2] - 2026-05-22 [_changes_](https://github.com/UW-Macrostrat/web-components/compare/@macrostrat/column-views-v3.4.1...@macrostrat/column-views-v3.4.2)
 
 ### Patch Changes

package/dist/column.cjs

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const columnComponents = require("@macrostrat/column-components");
-const h$1 = require("@macrostrat/hyper");
 const uiComponents = require("@macrostrat/ui-components");
 const classNames = require("classnames");
 const React = require("react");
@@ -20,7 +19,6 @@ const identifiers = require("./unit-details/identifiers.cjs");
 const panel = require("./unit-details/panel.cjs");
 const _interopDefault = (e) => e && e.__esModule ? e : { default: e };
 const classNames__default = /* @__PURE__ */ _interopDefault(classNames);
-const h = h$1.hyperStyled(column_module.default);
 function Column(props) {
   const {
     showUnitPopover = false,
@@ -44,6 +42,7 @@ function Column(props) {
     hybridScale,
     scale,
     axisType,
+    ref,
     ...rest
   } = props;
   let _targetUnitHeight = targetUnitHeight;
@@ -78,16 +77,16 @@ function Column(props) {
     hybridScale
   });
   if (sections.length === 0) {
-    return h(
+    return column_module.default(
       "div.column-container.empty",
-      h(core.NonIdealState, {
+      column_module.default(core.NonIdealState, {
         title: "Empty column",
         description: "No sections found in this column.",
         icon: "warning-sign"
       })
     );
   }
-  return h(
+  return column_module.default(
     store.MacrostratColumnDataProvider,
     {
       units,
@@ -96,12 +95,13 @@ function Column(props) {
       axisType: _axisType,
       allowUnitSelection: showUnitPopover || allowUnitSelection,
       onUnitSelected,
-      selectedUnit
+      selectedUnit,
+      ref
     },
-    h(ColumnInner, { ageAxisComponent, ...rest }, [
+    column_module.default(ColumnInner, { ageAxisComponent, ...rest }, [
       children,
-      h.if(showUnitPopover)(popover.UnitSelectionPopover),
-      h.if(keyboardNavigation)(unitSelection.UnitKeyboardNavigation, { units })
+      column_module.default.if(showUnitPopover)(popover.UnitSelectionPopover),
+      column_module.default.if(keyboardNavigation)(unitSelection.UnitKeyboardNavigation, { units })
     ])
   );
 }
@@ -152,20 +152,20 @@ function ColumnInner(props) {
     _showTimescale = true;
   }
   _showTimescale = axisType == columnComponents.ColumnAxisType.AGE && _showTimescale;
-  return h(
+  return column_module.default(
     ColumnContainer,
     {
       ...useMouseEventHandlers(onMouseOver),
       style: paddingVars,
       className
     },
-    h("div.column", { ref: columnRef }, [
-      h(ageAxisComponent),
-      h.if(_showTimescale)(section.CompositeTimescale, {
+    column_module.default("div.column", { ref: columnRef }, [
+      column_module.default(ageAxisComponent),
+      column_module.default.if(_showTimescale)(section.CompositeTimescale, {
         levels: timescaleLevels,
         unconformityLabels: _timescaleUnconformityLabels
       }),
-      h(section.SectionsColumn, {
+      column_module.default(section.SectionsColumn, {
         unitComponent,
         showLabels,
         width,
@@ -213,7 +213,7 @@ function useMouseEventHandlers(_onMouseOver = null) {
 function ColumnContainer(props) {
   const { className, ...rest } = props;
   const darkMode = uiComponents.useDarkMode();
-  return h(uiComponents.Box, {
+  return column_module.default(uiComponents.Box, {
     className: classNames__default.default(
       className,
       {
@@ -230,13 +230,13 @@ function ColumnBasicInfo({
   showReferences = true
 }) {
   if (data == null) return null;
-  return h("div.column-info", [
-    h("div.column-title-row", [
-      h("h2", data.col_name),
-      h.if(showColumnID)("h4", h(identifiers.Identifier, { id: data.col_id }))
+  return column_module.default("div.column-info", [
+    column_module.default("div.column-title-row", [
+      column_module.default("h2", data.col_name),
+      column_module.default.if(showColumnID)("h4", column_module.default(identifiers.Identifier, { id: data.col_id }))
     ]),
-    h(dataComponents.DataField, { row: true, label: "Group", value: data.col_group }),
-    h.if(showReferences)(panel.ReferencesField, {
+    column_module.default(dataComponents.DataField, { row: true, label: "Group", value: data.col_group }),
+    column_module.default.if(showReferences)(panel.ReferencesField, {
       refs: data.refs,
       inline: false,
       row: false,

package/dist/column.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"column.cjs","sources":["../src/column.ts"],"sourcesContent":["import { ColumnAxisType } from \"@macrostrat/column-components\";\nimport { hyperStyled } from \"@macrostrat/hyper\";\nimport {\n  Box,\n  extractPadding,\n  Padding,\n  useDarkMode,\n} from \"@macrostrat/ui-components\";\nimport classNames from \"classnames\";\nimport {\n  HTMLAttributes,\n  useCallback,\n  CSSProperties,\n  ComponentType,\n} from \"react\";\nimport styles from \"./column.module.sass\";\nimport { UnitComponent } from \"./units\";\nimport {\n  UnitKeyboardNavigation,\n  useColumnRef,\n  useUnitSelectionDispatch,\n} from \"./data-provider\";\n\nimport {\n  Identifier,\n  ReferencesField,\n  UnitSelectionPopover,\n} from \"./unit-details\";\nimport {\n  MacrostratColumnDataProvider,\n  useCompositeScale,\n  useMacrostratColumnData,\n} from \"./data-provider\";\nimport {\n  SectionSharedProps,\n  CompositeTimescale,\n  SectionsColumn,\n} from \"./section\";\nimport { ApproximateHeightAxis, CompositeAgeAxis } from \"./age-axis\";\nimport {\n  MergeSectionsMode,\n  usePreparedColumnUnits,\n  HybridScaleType,\n  ColumnHeightScaleOptions,\n} from \"./prepare-units\";\nimport { UnitLong } from \"@macrostrat/api-types\";\nimport { NonIdealState } from \"@blueprintjs/core\";\nimport { DataField } from \"@macrostrat/data-components\";\nimport { ScaleContinuousNumeric } from \"d3-scale\";\n\nconst h = hyperStyled(styles);\n\ninterface BaseColumnProps extends Omit<\n  SectionSharedProps,\n  \"unconformityLabels\"\n> {\n  className?: string;\n  showLabelColumn?: boolean;\n  keyboardNavigation?: boolean;\n  showLabels?: boolean;\n  maxInternalColumns?: number;\n  // Timescale properties\n  showTimescale?: boolean;\n  timescaleLevels?: number | [number, number];\n  unconformityLabels?: boolean | UnconformityLabelPlacement;\n  onMouseOver?: (\n    unit: UnitLong | null,\n    height: number | null,\n    evt: MouseEvent,\n  ) => void;\n}\n\nexport type UnconformityLabelPlacement = \"minimal\" | \"prominent\" | \"none\";\n\nexport interface ColumnProps\n  extends Padding, BaseColumnProps, ColumnHeightScaleOptions {\n  // Macrostrat units\n  units: UnitLong[];\n  t_age?: number;\n  b_age?: number;\n  t_pos?: number;\n  b_pos?: number;\n  mergeSections?: MergeSectionsMode;\n  showUnitPopover?: boolean;\n  allowUnitSelection?: boolean;\n  selectedUnit?: number | null;\n  onUnitSelected?: (unitID: number | null, unit: any) => void;\n  // Unconformity height in pixels\n  unconformityHeight?: number;\n  scale?: ScaleContinuousNumeric<number, number>;\n}\n\nexport function Column(props: ColumnProps) {\n  const {\n    showUnitPopover = false,\n    keyboardNavigation = false,\n    mergeSections,\n    onUnitSelected,\n    selectedUnit,\n    children,\n    units: rawUnits,\n    t_age,\n    b_age,\n    t_pos,\n    b_pos,\n    unconformityHeight = 30,\n    targetUnitHeight = 20,\n    pixelScale,\n    minPixelScale = 0.2,\n    minSectionHeight = 50,\n    collapseSmallUnconformities = true,\n    allowUnitSelection = false,\n    hybridScale,\n    scale,\n    axisType,\n    ...rest\n  } = props;\n\n  /* Make pixelScale and targetUnitHeight mutually exclusive. PixelScale implies\n   * standardization of scales in all sections */\n  let _targetUnitHeight: number | null = targetUnitHeight;\n  let _minSectionHeight = minSectionHeight;\n  let _minPixelScale = minPixelScale;\n  if (pixelScale != null) {\n    _targetUnitHeight = null;\n    _minSectionHeight = 0;\n    _minPixelScale = pixelScale;\n  }\n\n  // Handle special cases for hybrid scales (WIP, we need to regularize this)\n  let _axisType = axisType ?? ColumnAxisType.AGE;\n  let ageAxisComponent = CompositeAgeAxis;\n  if (\n    hybridScale?.type === HybridScaleType.ApproximateHeight &&\n    _axisType != ColumnAxisType.AGE\n  ) {\n    // Use approximate height axis for non-age columns if a non-age axis type is requested\n    ageAxisComponent = ApproximateHeightAxis;\n    _axisType = ColumnAxisType.AGE;\n  }\n\n  const { sections, units, totalHeight } = usePreparedColumnUnits(rawUnits, {\n    axisType: _axisType,\n    t_age,\n    b_age,\n    t_pos,\n    b_pos,\n    mergeSections,\n    targetUnitHeight: _targetUnitHeight,\n    unconformityHeight,\n    pixelScale,\n    minPixelScale: _minPixelScale,\n    minSectionHeight: _minSectionHeight,\n    collapseSmallUnconformities,\n    // TODO: consider unifying scale and hybridScale options\n    scale,\n    hybridScale,\n  });\n\n  if (sections.length === 0) {\n    return h(\n      \"div.column-container.empty\",\n      h(NonIdealState, {\n        title: \"Empty column\",\n        description: \"No sections found in this column.\",\n        icon: \"warning-sign\",\n      }),\n    );\n  }\n\n  return h(\n    MacrostratColumnDataProvider,\n    {\n      units,\n      sections,\n      totalHeight,\n      axisType: _axisType,\n      allowUnitSelection: showUnitPopover || allowUnitSelection,\n      onUnitSelected,\n      selectedUnit,\n    },\n    h(ColumnInner, { ageAxisComponent, ...rest }, [\n      children,\n      h.if(showUnitPopover)(UnitSelectionPopover),\n      h.if(keyboardNavigation)(UnitKeyboardNavigation, { units }),\n    ]),\n  );\n}\n\ninterface ColumnInnerProps extends BaseColumnProps {\n  ageAxisComponent?: ComponentType;\n}\n\nfunction ColumnInner(props: ColumnInnerProps) {\n  const padding = extractPadding(props);\n\n  // TODO: integrate padding vars more closely with the rest of the spacing (right now padding is a bit ad-hoc)\n  const paddingVars: any = {\n    \"--column-padding-top\": `${padding.paddingTop}px`,\n    \"--column-padding-bottom\": `${padding.paddingBottom}px`,\n    \"--column-padding-left\": `${padding.paddingLeft}px`,\n    \"--column-padding-right\": `${padding.paddingRight}px`,\n  };\n\n  const {\n    unitComponent = UnitComponent,\n    unconformityLabels = \"minimal\",\n    showLabels = true,\n    width: _width = 300,\n    columnWidth: _columnWidth = 150,\n    showLabelColumn: _showLabelColumn = true,\n    className,\n    clipUnits = false,\n    children,\n    showTimescale,\n    timescaleLevels,\n    maxInternalColumns,\n    onMouseOver,\n    ageAxisComponent = CompositeAgeAxis,\n  } = props;\n\n  const { axisType } = useMacrostratColumnData();\n\n  const columnRef = useColumnRef();\n\n  // Coalesce unconformity label setting to a boolean\n  let _timescaleUnconformityLabels = false;\n  let _sectionUnconformityLabels = false;\n  if (unconformityLabels === true || unconformityLabels === \"prominent\") {\n    _sectionUnconformityLabels = true;\n  } else if (unconformityLabels === \"minimal\") {\n    _timescaleUnconformityLabels = true;\n  }\n\n  let width = _width;\n  let columnWidth = _columnWidth;\n  if (columnWidth > width) {\n    columnWidth = width;\n  }\n  let showLabelColumn = _showLabelColumn;\n  if (columnWidth > width - 10) {\n    showLabelColumn = false;\n  }\n\n  let _showTimescale = showTimescale ?? true;\n  if (timescaleLevels != null) {\n    _showTimescale = true;\n  }\n  _showTimescale = axisType == ColumnAxisType.AGE && _showTimescale;\n\n  return h(\n    ColumnContainer,\n    {\n      ...useMouseEventHandlers(onMouseOver),\n      style: paddingVars,\n      className,\n    },\n    h(\"div.column\", { ref: columnRef }, [\n      h(ageAxisComponent),\n      h.if(_showTimescale)(CompositeTimescale, {\n        levels: timescaleLevels,\n        unconformityLabels: _timescaleUnconformityLabels,\n      }),\n      h(SectionsColumn, {\n        unitComponent,\n        showLabels,\n        width,\n        columnWidth,\n        showLabelColumn,\n        clipUnits,\n        unconformityLabels: _sectionUnconformityLabels,\n        maxInternalColumns,\n      }),\n      children,\n    ]),\n  );\n}\n\ntype ColumnMouseOverHandler = (\n  unit: UnitLong | null,\n  height: number | null,\n  evt: MouseEvent,\n) => void;\n\nfunction useMouseEventHandlers(\n  _onMouseOver: ColumnMouseOverHandler | null = null,\n) {\n  /** Click event handler */\n\n  // Click handler for unit selection\n  const dispatch = useUnitSelectionDispatch();\n  const onClick = useCallback(\n    (evt) => {\n      dispatch?.(null, null);\n    },\n    [dispatch],\n  );\n\n  /** Hover event handlers */\n  const scale = useCompositeScale();\n\n  const onMouseOver = useCallback(\n    (evt) => {\n      const height = scale.invert(\n        evt.clientY - evt.currentTarget.getBoundingClientRect().top,\n      );\n      _onMouseOver?.(null, height, evt);\n    },\n    [scale, _onMouseOver],\n  );\n\n  const onMouseOut = useCallback(() => {\n    _onMouseOver?.(null, null, null);\n  }, [_onMouseOver]);\n\n  if (_onMouseOver == null) {\n    return {\n      onClick,\n      onMouseOver: undefined,\n      onMouseMove: undefined,\n      onMouseOut: undefined,\n    };\n  }\n\n  return { onMouseOver, onMouseMove: onMouseOver, onMouseOut, onClick };\n}\n\nexport interface ColumnContainerProps extends HTMLAttributes<HTMLDivElement> {\n  className?: string;\n  style?: CSSProperties;\n}\n\nexport function ColumnContainer(props: ColumnContainerProps) {\n  const { className, ...rest } = props;\n  const darkMode = useDarkMode();\n\n  return h(Box, {\n    className: classNames(\n      className,\n      {\n        \"dark-mode\": darkMode?.isEnabled ?? false,\n      },\n      \"column-container\",\n    ),\n    ...rest,\n  });\n}\n\nexport function ColumnBasicInfo({\n  data,\n  showColumnID = true,\n  showReferences = true,\n}) {\n  if (data == null) return null;\n  return h(\"div.column-info\", [\n    h(\"div.column-title-row\", [\n      h(\"h2\", data.col_name),\n      h.if(showColumnID)(\"h4\", h(Identifier, { id: data.col_id })),\n    ]),\n    h(DataField, { row: true, label: \"Group\", value: data.col_group }),\n    h.if(showReferences)(ReferencesField, {\n      refs: data.refs,\n      inline: false,\n      row: false,\n      className: \"column-refs\",\n    }),\n  ]);\n}\n"],"names":["hyperStyled","styles","ColumnAxisType","CompositeAgeAxis","HybridScaleType","ApproximateHeightAxis","usePreparedColumnUnits","NonIdealState","MacrostratColumnDataProvider","UnitSelectionPopover","UnitKeyboardNavigation","extractPadding","UnitComponent","useMacrostratColumnData","useColumnRef","CompositeTimescale","SectionsColumn","useUnitSelectionDispatch","useCallback","useCompositeScale","useDarkMode","Box","classNames","Identifier","DataField","ReferencesField"],"mappings":"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"}
+{"version":3,"file":"column.cjs","sources":["../src/column.ts"],"sourcesContent":["import { ColumnAxisType } from \"@macrostrat/column-components\";\nimport {\n  Box,\n  extractPadding,\n  Padding,\n  useDarkMode,\n} from \"@macrostrat/ui-components\";\nimport classNames from \"classnames\";\nimport {\n  HTMLAttributes,\n  useCallback,\n  CSSProperties,\n  ComponentType,\n  RefObject,\n} from \"react\";\nimport h from \"./column.module.sass\";\nimport { UnitComponent } from \"./units\";\nimport {\n  ColumnRef,\n  UnitKeyboardNavigation,\n  useColumnRef,\n  useUnitSelectionDispatch,\n} from \"./data-provider\";\n\nimport {\n  Identifier,\n  ReferencesField,\n  UnitSelectionPopover,\n} from \"./unit-details\";\nimport {\n  MacrostratColumnDataProvider,\n  useCompositeScale,\n  useMacrostratColumnData,\n} from \"./data-provider\";\nimport {\n  SectionSharedProps,\n  CompositeTimescale,\n  SectionsColumn,\n} from \"./section\";\nimport { ApproximateHeightAxis, CompositeAgeAxis } from \"./age-axis\";\nimport {\n  MergeSectionsMode,\n  usePreparedColumnUnits,\n  HybridScaleType,\n  ColumnHeightScaleOptions,\n} from \"./prepare-units\";\nimport { UnitLong } from \"@macrostrat/api-types\";\nimport { NonIdealState } from \"@blueprintjs/core\";\nimport { DataField } from \"@macrostrat/data-components\";\nimport { ScaleContinuousNumeric } from \"d3-scale\";\n\ninterface BaseColumnProps extends Omit<\n  SectionSharedProps,\n  \"unconformityLabels\"\n> {\n  className?: string;\n  showLabelColumn?: boolean;\n  keyboardNavigation?: boolean;\n  showLabels?: boolean;\n  maxInternalColumns?: number;\n  // Timescale properties\n  showTimescale?: boolean;\n  timescaleLevels?: number | [number, number];\n  unconformityLabels?: boolean | UnconformityLabelPlacement;\n  onMouseOver?: (\n    unit: UnitLong | null,\n    height: number | null,\n    evt: MouseEvent,\n  ) => void;\n}\n\nexport type UnconformityLabelPlacement = \"minimal\" | \"prominent\" | \"none\";\n\nexport interface ColumnProps\n  extends Padding, BaseColumnProps, ColumnHeightScaleOptions {\n  // Macrostrat units\n  units: UnitLong[];\n  t_age?: number;\n  b_age?: number;\n  t_pos?: number;\n  b_pos?: number;\n  mergeSections?: MergeSectionsMode;\n  showUnitPopover?: boolean;\n  allowUnitSelection?: boolean;\n  selectedUnit?: number | null;\n  onUnitSelected?: (unitID: number | null, unit: any) => void;\n  // Unconformity height in pixels\n  unconformityHeight?: number;\n  scale?: ScaleContinuousNumeric<number, number>;\n  ref?: RefObject<ColumnRef>;\n}\n\nexport function Column(props: ColumnProps) {\n  const {\n    showUnitPopover = false,\n    keyboardNavigation = false,\n    mergeSections,\n    onUnitSelected,\n    selectedUnit,\n    children,\n    units: rawUnits,\n    t_age,\n    b_age,\n    t_pos,\n    b_pos,\n    unconformityHeight = 30,\n    targetUnitHeight = 20,\n    pixelScale,\n    minPixelScale = 0.2,\n    minSectionHeight = 50,\n    collapseSmallUnconformities = true,\n    allowUnitSelection = false,\n    hybridScale,\n    scale,\n    axisType,\n    ref,\n    ...rest\n  } = props;\n\n  /* Make pixelScale and targetUnitHeight mutually exclusive. PixelScale implies\n   * standardization of scales in all sections */\n  let _targetUnitHeight: number | null = targetUnitHeight;\n  let _minSectionHeight = minSectionHeight;\n  let _minPixelScale = minPixelScale;\n  if (pixelScale != null) {\n    _targetUnitHeight = null;\n    _minSectionHeight = 0;\n    _minPixelScale = pixelScale;\n  }\n\n  // Handle special cases for hybrid scales (WIP, we need to regularize this)\n  let _axisType = axisType ?? ColumnAxisType.AGE;\n  let ageAxisComponent = CompositeAgeAxis;\n  if (\n    hybridScale?.type === HybridScaleType.ApproximateHeight &&\n    _axisType != ColumnAxisType.AGE\n  ) {\n    // Use approximate height axis for non-age columns if a non-age axis type is requested\n    ageAxisComponent = ApproximateHeightAxis;\n    _axisType = ColumnAxisType.AGE;\n  }\n\n  const { sections, units, totalHeight } = usePreparedColumnUnits(rawUnits, {\n    axisType: _axisType,\n    t_age,\n    b_age,\n    t_pos,\n    b_pos,\n    mergeSections,\n    targetUnitHeight: _targetUnitHeight,\n    unconformityHeight,\n    pixelScale,\n    minPixelScale: _minPixelScale,\n    minSectionHeight: _minSectionHeight,\n    collapseSmallUnconformities,\n    // TODO: consider unifying scale and hybridScale options\n    scale,\n    hybridScale,\n  });\n\n  if (sections.length === 0) {\n    return h(\n      \"div.column-container.empty\",\n      h(NonIdealState, {\n        title: \"Empty column\",\n        description: \"No sections found in this column.\",\n        icon: \"warning-sign\",\n      }),\n    );\n  }\n\n  return h(\n    MacrostratColumnDataProvider,\n    {\n      units,\n      sections,\n      totalHeight,\n      axisType: _axisType,\n      allowUnitSelection: showUnitPopover || allowUnitSelection,\n      onUnitSelected,\n      selectedUnit,\n      ref,\n    },\n    h(ColumnInner, { ageAxisComponent, ...rest }, [\n      children,\n      h.if(showUnitPopover)(UnitSelectionPopover),\n      h.if(keyboardNavigation)(UnitKeyboardNavigation, { units }),\n    ]),\n  );\n}\n\ninterface ColumnInnerProps extends BaseColumnProps {\n  ageAxisComponent?: ComponentType;\n}\n\nfunction ColumnInner(props: ColumnInnerProps) {\n  const padding = extractPadding(props);\n\n  // TODO: integrate padding vars more closely with the rest of the spacing (right now padding is a bit ad-hoc)\n  const paddingVars: any = {\n    \"--column-padding-top\": `${padding.paddingTop}px`,\n    \"--column-padding-bottom\": `${padding.paddingBottom}px`,\n    \"--column-padding-left\": `${padding.paddingLeft}px`,\n    \"--column-padding-right\": `${padding.paddingRight}px`,\n  };\n\n  const {\n    unitComponent = UnitComponent,\n    unconformityLabels = \"minimal\",\n    showLabels = true,\n    width: _width = 300,\n    columnWidth: _columnWidth = 150,\n    showLabelColumn: _showLabelColumn = true,\n    className,\n    clipUnits = false,\n    children,\n    showTimescale,\n    timescaleLevels,\n    maxInternalColumns,\n    onMouseOver,\n    ageAxisComponent = CompositeAgeAxis,\n  } = props;\n\n  const { axisType } = useMacrostratColumnData();\n\n  const columnRef = useColumnRef();\n\n  // Coalesce unconformity label setting to a boolean\n  let _timescaleUnconformityLabels = false;\n  let _sectionUnconformityLabels = false;\n  if (unconformityLabels === true || unconformityLabels === \"prominent\") {\n    _sectionUnconformityLabels = true;\n  } else if (unconformityLabels === \"minimal\") {\n    _timescaleUnconformityLabels = true;\n  }\n\n  let width = _width;\n  let columnWidth = _columnWidth;\n  if (columnWidth > width) {\n    columnWidth = width;\n  }\n  let showLabelColumn = _showLabelColumn;\n  if (columnWidth > width - 10) {\n    showLabelColumn = false;\n  }\n\n  let _showTimescale = showTimescale ?? true;\n  if (timescaleLevels != null) {\n    _showTimescale = true;\n  }\n  _showTimescale = axisType == ColumnAxisType.AGE && _showTimescale;\n\n  return h(\n    ColumnContainer,\n    {\n      ...useMouseEventHandlers(onMouseOver),\n      style: paddingVars,\n      className,\n    },\n    h(\"div.column\", { ref: columnRef }, [\n      h(ageAxisComponent),\n      h.if(_showTimescale)(CompositeTimescale, {\n        levels: timescaleLevels,\n        unconformityLabels: _timescaleUnconformityLabels,\n      }),\n      h(SectionsColumn, {\n        unitComponent,\n        showLabels,\n        width,\n        columnWidth,\n        showLabelColumn,\n        clipUnits,\n        unconformityLabels: _sectionUnconformityLabels,\n        maxInternalColumns,\n      }),\n      children,\n    ]),\n  );\n}\n\ntype ColumnMouseOverHandler = (\n  unit: UnitLong | null,\n  height: number | null,\n  evt: MouseEvent,\n) => void;\n\nfunction useMouseEventHandlers(\n  _onMouseOver: ColumnMouseOverHandler | null = null,\n) {\n  /** Click event handler */\n\n  // Click handler for unit selection\n  const dispatch = useUnitSelectionDispatch();\n  const onClick = useCallback(\n    (evt) => {\n      dispatch?.(null, null);\n    },\n    [dispatch],\n  );\n\n  /** Hover event handlers */\n  const scale = useCompositeScale();\n\n  const onMouseOver = useCallback(\n    (evt) => {\n      const height = scale.invert(\n        evt.clientY - evt.currentTarget.getBoundingClientRect().top,\n      );\n      _onMouseOver?.(null, height, evt);\n    },\n    [scale, _onMouseOver],\n  );\n\n  const onMouseOut = useCallback(() => {\n    _onMouseOver?.(null, null, null);\n  }, [_onMouseOver]);\n\n  if (_onMouseOver == null) {\n    return {\n      onClick,\n      onMouseOver: undefined,\n      onMouseMove: undefined,\n      onMouseOut: undefined,\n    };\n  }\n\n  return { onMouseOver, onMouseMove: onMouseOver, onMouseOut, onClick };\n}\n\nexport interface ColumnContainerProps extends HTMLAttributes<HTMLDivElement> {\n  className?: string;\n  style?: CSSProperties;\n}\n\nexport function ColumnContainer(props: ColumnContainerProps) {\n  const { className, ...rest } = props;\n  const darkMode = useDarkMode();\n\n  return h(Box, {\n    className: classNames(\n      className,\n      {\n        \"dark-mode\": darkMode?.isEnabled ?? false,\n      },\n      \"column-container\",\n    ),\n    ...rest,\n  });\n}\n\nexport function ColumnBasicInfo({\n  data,\n  showColumnID = true,\n  showReferences = true,\n}) {\n  if (data == null) return null;\n  return h(\"div.column-info\", [\n    h(\"div.column-title-row\", [\n      h(\"h2\", data.col_name),\n      h.if(showColumnID)(\"h4\", h(Identifier, { id: data.col_id })),\n    ]),\n    h(DataField, { row: true, label: \"Group\", value: data.col_group }),\n    h.if(showReferences)(ReferencesField, {\n      refs: data.refs,\n      inline: false,\n      row: false,\n      className: \"column-refs\",\n    }),\n  ]);\n}\n"],"names":["ColumnAxisType","CompositeAgeAxis","HybridScaleType","ApproximateHeightAxis","usePreparedColumnUnits","h","NonIdealState","MacrostratColumnDataProvider","UnitSelectionPopover","UnitKeyboardNavigation","extractPadding","UnitComponent","useMacrostratColumnData","useColumnRef","CompositeTimescale","SectionsColumn","useUnitSelectionDispatch","useCallback","useCompositeScale","useDarkMode","Box","classNames","Identifier","DataField","ReferencesField"],"mappings":"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"}

package/dist/column.d.ts

@@ -1,5 +1,6 @@
 import { Padding } from '@macrostrat/ui-components';
-import { HTMLAttributes, CSSProperties } from 'react';
+import { HTMLAttributes, CSSProperties, RefObject } from 'react';
+import { ColumnRef } from './data-provider';
 import { SectionSharedProps } from './section';
 import { MergeSectionsMode, ColumnHeightScaleOptions } from './prepare-units';
 import { UnitLong } from '@macrostrat/api-types';
@@ -29,6 +30,7 @@ export interface ColumnProps extends Padding, BaseColumnProps, ColumnHeightScale
     onUnitSelected?: (unitID: number | null, unit: any) => void;
     unconformityHeight?: number;
     scale?: ScaleContinuousNumeric<number, number>;
+    ref?: RefObject<ColumnRef>;
 }
 export declare function Column(props: ColumnProps): import('react').ReactElement<import('react').FunctionComponentElement<import('@blueprintjs/core').NonIdealStateProps>, string | import('react').JSXElementConstructor<any>> | import('react').FunctionComponentElement<import('./data-provider').ColumnDataProviderProps<import('@macrostrat/api-types').BaseUnit>>;
 export interface ColumnContainerProps extends HTMLAttributes<HTMLDivElement> {

package/dist/column.js

@@ -1,9 +1,8 @@
 import { ColumnAxisType } from "@macrostrat/column-components";
-import { hyperStyled } from "@macrostrat/hyper";
 import { useDarkMode, Box, extractPadding } from "@macrostrat/ui-components";
 import classNames from "classnames";
 import { useCallback } from "react";
-import h$1 from "./column.module.sass.js";
+import h from "./column.module.sass.js";
 import { UnitComponent } from "./units/index.js";
 import { CompositeTimescale, SectionsColumn } from "./section.js";
 import { CompositeAgeAxis, ApproximateHeightAxis } from "./age-axis.js";
@@ -16,7 +15,6 @@ import { UnitSelectionPopover } from "./unit-details/popover.js";
 import { UnitKeyboardNavigation, useColumnRef, useUnitSelectionDispatch } from "./data-provider/unit-selection.js";
 import { Identifier } from "./unit-details/identifiers.js";
 import { ReferencesField } from "./unit-details/panel.js";
-const h = hyperStyled(h$1);
 function Column(props) {
   const {
     showUnitPopover = false,
@@ -40,6 +38,7 @@ function Column(props) {
     hybridScale,
     scale,
     axisType,
+    ref,
     ...rest
   } = props;
   let _targetUnitHeight = targetUnitHeight;
@@ -92,7 +91,8 @@ function Column(props) {
       axisType: _axisType,
       allowUnitSelection: showUnitPopover || allowUnitSelection,
       onUnitSelected,
-      selectedUnit
+      selectedUnit,
+      ref
     },
     h(ColumnInner, { ageAxisComponent, ...rest }, [
       children,

package/dist/column.js.map

@@ -1 +1 @@
-{"version":3,"file":"column.js","sources":["../src/column.ts"],"sourcesContent":["import { ColumnAxisType } from \"@macrostrat/column-components\";\nimport { hyperStyled } from \"@macrostrat/hyper\";\nimport {\n  Box,\n  extractPadding,\n  Padding,\n  useDarkMode,\n} from \"@macrostrat/ui-components\";\nimport classNames from \"classnames\";\nimport {\n  HTMLAttributes,\n  useCallback,\n  CSSProperties,\n  ComponentType,\n} from \"react\";\nimport styles from \"./column.module.sass\";\nimport { UnitComponent } from \"./units\";\nimport {\n  UnitKeyboardNavigation,\n  useColumnRef,\n  useUnitSelectionDispatch,\n} from \"./data-provider\";\n\nimport {\n  Identifier,\n  ReferencesField,\n  UnitSelectionPopover,\n} from \"./unit-details\";\nimport {\n  MacrostratColumnDataProvider,\n  useCompositeScale,\n  useMacrostratColumnData,\n} from \"./data-provider\";\nimport {\n  SectionSharedProps,\n  CompositeTimescale,\n  SectionsColumn,\n} from \"./section\";\nimport { ApproximateHeightAxis, CompositeAgeAxis } from \"./age-axis\";\nimport {\n  MergeSectionsMode,\n  usePreparedColumnUnits,\n  HybridScaleType,\n  ColumnHeightScaleOptions,\n} from \"./prepare-units\";\nimport { UnitLong } from \"@macrostrat/api-types\";\nimport { NonIdealState } from \"@blueprintjs/core\";\nimport { DataField } from \"@macrostrat/data-components\";\nimport { ScaleContinuousNumeric } from \"d3-scale\";\n\nconst h = hyperStyled(styles);\n\ninterface BaseColumnProps extends Omit<\n  SectionSharedProps,\n  \"unconformityLabels\"\n> {\n  className?: string;\n  showLabelColumn?: boolean;\n  keyboardNavigation?: boolean;\n  showLabels?: boolean;\n  maxInternalColumns?: number;\n  // Timescale properties\n  showTimescale?: boolean;\n  timescaleLevels?: number | [number, number];\n  unconformityLabels?: boolean | UnconformityLabelPlacement;\n  onMouseOver?: (\n    unit: UnitLong | null,\n    height: number | null,\n    evt: MouseEvent,\n  ) => void;\n}\n\nexport type UnconformityLabelPlacement = \"minimal\" | \"prominent\" | \"none\";\n\nexport interface ColumnProps\n  extends Padding, BaseColumnProps, ColumnHeightScaleOptions {\n  // Macrostrat units\n  units: UnitLong[];\n  t_age?: number;\n  b_age?: number;\n  t_pos?: number;\n  b_pos?: number;\n  mergeSections?: MergeSectionsMode;\n  showUnitPopover?: boolean;\n  allowUnitSelection?: boolean;\n  selectedUnit?: number | null;\n  onUnitSelected?: (unitID: number | null, unit: any) => void;\n  // Unconformity height in pixels\n  unconformityHeight?: number;\n  scale?: ScaleContinuousNumeric<number, number>;\n}\n\nexport function Column(props: ColumnProps) {\n  const {\n    showUnitPopover = false,\n    keyboardNavigation = false,\n    mergeSections,\n    onUnitSelected,\n    selectedUnit,\n    children,\n    units: rawUnits,\n    t_age,\n    b_age,\n    t_pos,\n    b_pos,\n    unconformityHeight = 30,\n    targetUnitHeight = 20,\n    pixelScale,\n    minPixelScale = 0.2,\n    minSectionHeight = 50,\n    collapseSmallUnconformities = true,\n    allowUnitSelection = false,\n    hybridScale,\n    scale,\n    axisType,\n    ...rest\n  } = props;\n\n  /* Make pixelScale and targetUnitHeight mutually exclusive. PixelScale implies\n   * standardization of scales in all sections */\n  let _targetUnitHeight: number | null = targetUnitHeight;\n  let _minSectionHeight = minSectionHeight;\n  let _minPixelScale = minPixelScale;\n  if (pixelScale != null) {\n    _targetUnitHeight = null;\n    _minSectionHeight = 0;\n    _minPixelScale = pixelScale;\n  }\n\n  // Handle special cases for hybrid scales (WIP, we need to regularize this)\n  let _axisType = axisType ?? ColumnAxisType.AGE;\n  let ageAxisComponent = CompositeAgeAxis;\n  if (\n    hybridScale?.type === HybridScaleType.ApproximateHeight &&\n    _axisType != ColumnAxisType.AGE\n  ) {\n    // Use approximate height axis for non-age columns if a non-age axis type is requested\n    ageAxisComponent = ApproximateHeightAxis;\n    _axisType = ColumnAxisType.AGE;\n  }\n\n  const { sections, units, totalHeight } = usePreparedColumnUnits(rawUnits, {\n    axisType: _axisType,\n    t_age,\n    b_age,\n    t_pos,\n    b_pos,\n    mergeSections,\n    targetUnitHeight: _targetUnitHeight,\n    unconformityHeight,\n    pixelScale,\n    minPixelScale: _minPixelScale,\n    minSectionHeight: _minSectionHeight,\n    collapseSmallUnconformities,\n    // TODO: consider unifying scale and hybridScale options\n    scale,\n    hybridScale,\n  });\n\n  if (sections.length === 0) {\n    return h(\n      \"div.column-container.empty\",\n      h(NonIdealState, {\n        title: \"Empty column\",\n        description: \"No sections found in this column.\",\n        icon: \"warning-sign\",\n      }),\n    );\n  }\n\n  return h(\n    MacrostratColumnDataProvider,\n    {\n      units,\n      sections,\n      totalHeight,\n      axisType: _axisType,\n      allowUnitSelection: showUnitPopover || allowUnitSelection,\n      onUnitSelected,\n      selectedUnit,\n    },\n    h(ColumnInner, { ageAxisComponent, ...rest }, [\n      children,\n      h.if(showUnitPopover)(UnitSelectionPopover),\n      h.if(keyboardNavigation)(UnitKeyboardNavigation, { units }),\n    ]),\n  );\n}\n\ninterface ColumnInnerProps extends BaseColumnProps {\n  ageAxisComponent?: ComponentType;\n}\n\nfunction ColumnInner(props: ColumnInnerProps) {\n  const padding = extractPadding(props);\n\n  // TODO: integrate padding vars more closely with the rest of the spacing (right now padding is a bit ad-hoc)\n  const paddingVars: any = {\n    \"--column-padding-top\": `${padding.paddingTop}px`,\n    \"--column-padding-bottom\": `${padding.paddingBottom}px`,\n    \"--column-padding-left\": `${padding.paddingLeft}px`,\n    \"--column-padding-right\": `${padding.paddingRight}px`,\n  };\n\n  const {\n    unitComponent = UnitComponent,\n    unconformityLabels = \"minimal\",\n    showLabels = true,\n    width: _width = 300,\n    columnWidth: _columnWidth = 150,\n    showLabelColumn: _showLabelColumn = true,\n    className,\n    clipUnits = false,\n    children,\n    showTimescale,\n    timescaleLevels,\n    maxInternalColumns,\n    onMouseOver,\n    ageAxisComponent = CompositeAgeAxis,\n  } = props;\n\n  const { axisType } = useMacrostratColumnData();\n\n  const columnRef = useColumnRef();\n\n  // Coalesce unconformity label setting to a boolean\n  let _timescaleUnconformityLabels = false;\n  let _sectionUnconformityLabels = false;\n  if (unconformityLabels === true || unconformityLabels === \"prominent\") {\n    _sectionUnconformityLabels = true;\n  } else if (unconformityLabels === \"minimal\") {\n    _timescaleUnconformityLabels = true;\n  }\n\n  let width = _width;\n  let columnWidth = _columnWidth;\n  if (columnWidth > width) {\n    columnWidth = width;\n  }\n  let showLabelColumn = _showLabelColumn;\n  if (columnWidth > width - 10) {\n    showLabelColumn = false;\n  }\n\n  let _showTimescale = showTimescale ?? true;\n  if (timescaleLevels != null) {\n    _showTimescale = true;\n  }\n  _showTimescale = axisType == ColumnAxisType.AGE && _showTimescale;\n\n  return h(\n    ColumnContainer,\n    {\n      ...useMouseEventHandlers(onMouseOver),\n      style: paddingVars,\n      className,\n    },\n    h(\"div.column\", { ref: columnRef }, [\n      h(ageAxisComponent),\n      h.if(_showTimescale)(CompositeTimescale, {\n        levels: timescaleLevels,\n        unconformityLabels: _timescaleUnconformityLabels,\n      }),\n      h(SectionsColumn, {\n        unitComponent,\n        showLabels,\n        width,\n        columnWidth,\n        showLabelColumn,\n        clipUnits,\n        unconformityLabels: _sectionUnconformityLabels,\n        maxInternalColumns,\n      }),\n      children,\n    ]),\n  );\n}\n\ntype ColumnMouseOverHandler = (\n  unit: UnitLong | null,\n  height: number | null,\n  evt: MouseEvent,\n) => void;\n\nfunction useMouseEventHandlers(\n  _onMouseOver: ColumnMouseOverHandler | null = null,\n) {\n  /** Click event handler */\n\n  // Click handler for unit selection\n  const dispatch = useUnitSelectionDispatch();\n  const onClick = useCallback(\n    (evt) => {\n      dispatch?.(null, null);\n    },\n    [dispatch],\n  );\n\n  /** Hover event handlers */\n  const scale = useCompositeScale();\n\n  const onMouseOver = useCallback(\n    (evt) => {\n      const height = scale.invert(\n        evt.clientY - evt.currentTarget.getBoundingClientRect().top,\n      );\n      _onMouseOver?.(null, height, evt);\n    },\n    [scale, _onMouseOver],\n  );\n\n  const onMouseOut = useCallback(() => {\n    _onMouseOver?.(null, null, null);\n  }, [_onMouseOver]);\n\n  if (_onMouseOver == null) {\n    return {\n      onClick,\n      onMouseOver: undefined,\n      onMouseMove: undefined,\n      onMouseOut: undefined,\n    };\n  }\n\n  return { onMouseOver, onMouseMove: onMouseOver, onMouseOut, onClick };\n}\n\nexport interface ColumnContainerProps extends HTMLAttributes<HTMLDivElement> {\n  className?: string;\n  style?: CSSProperties;\n}\n\nexport function ColumnContainer(props: ColumnContainerProps) {\n  const { className, ...rest } = props;\n  const darkMode = useDarkMode();\n\n  return h(Box, {\n    className: classNames(\n      className,\n      {\n        \"dark-mode\": darkMode?.isEnabled ?? false,\n      },\n      \"column-container\",\n    ),\n    ...rest,\n  });\n}\n\nexport function ColumnBasicInfo({\n  data,\n  showColumnID = true,\n  showReferences = true,\n}) {\n  if (data == null) return null;\n  return h(\"div.column-info\", [\n    h(\"div.column-title-row\", [\n      h(\"h2\", data.col_name),\n      h.if(showColumnID)(\"h4\", h(Identifier, { id: data.col_id })),\n    ]),\n    h(DataField, { row: true, label: \"Group\", value: data.col_group }),\n    h.if(showReferences)(ReferencesField, {\n      refs: data.refs,\n      inline: false,\n      row: false,\n      className: \"column-refs\",\n    }),\n  ]);\n}\n"],"names":["styles"],"mappings":"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"}
+{"version":3,"file":"column.js","sources":["../src/column.ts"],"sourcesContent":["import { ColumnAxisType } from \"@macrostrat/column-components\";\nimport {\n  Box,\n  extractPadding,\n  Padding,\n  useDarkMode,\n} from \"@macrostrat/ui-components\";\nimport classNames from \"classnames\";\nimport {\n  HTMLAttributes,\n  useCallback,\n  CSSProperties,\n  ComponentType,\n  RefObject,\n} from \"react\";\nimport h from \"./column.module.sass\";\nimport { UnitComponent } from \"./units\";\nimport {\n  ColumnRef,\n  UnitKeyboardNavigation,\n  useColumnRef,\n  useUnitSelectionDispatch,\n} from \"./data-provider\";\n\nimport {\n  Identifier,\n  ReferencesField,\n  UnitSelectionPopover,\n} from \"./unit-details\";\nimport {\n  MacrostratColumnDataProvider,\n  useCompositeScale,\n  useMacrostratColumnData,\n} from \"./data-provider\";\nimport {\n  SectionSharedProps,\n  CompositeTimescale,\n  SectionsColumn,\n} from \"./section\";\nimport { ApproximateHeightAxis, CompositeAgeAxis } from \"./age-axis\";\nimport {\n  MergeSectionsMode,\n  usePreparedColumnUnits,\n  HybridScaleType,\n  ColumnHeightScaleOptions,\n} from \"./prepare-units\";\nimport { UnitLong } from \"@macrostrat/api-types\";\nimport { NonIdealState } from \"@blueprintjs/core\";\nimport { DataField } from \"@macrostrat/data-components\";\nimport { ScaleContinuousNumeric } from \"d3-scale\";\n\ninterface BaseColumnProps extends Omit<\n  SectionSharedProps,\n  \"unconformityLabels\"\n> {\n  className?: string;\n  showLabelColumn?: boolean;\n  keyboardNavigation?: boolean;\n  showLabels?: boolean;\n  maxInternalColumns?: number;\n  // Timescale properties\n  showTimescale?: boolean;\n  timescaleLevels?: number | [number, number];\n  unconformityLabels?: boolean | UnconformityLabelPlacement;\n  onMouseOver?: (\n    unit: UnitLong | null,\n    height: number | null,\n    evt: MouseEvent,\n  ) => void;\n}\n\nexport type UnconformityLabelPlacement = \"minimal\" | \"prominent\" | \"none\";\n\nexport interface ColumnProps\n  extends Padding, BaseColumnProps, ColumnHeightScaleOptions {\n  // Macrostrat units\n  units: UnitLong[];\n  t_age?: number;\n  b_age?: number;\n  t_pos?: number;\n  b_pos?: number;\n  mergeSections?: MergeSectionsMode;\n  showUnitPopover?: boolean;\n  allowUnitSelection?: boolean;\n  selectedUnit?: number | null;\n  onUnitSelected?: (unitID: number | null, unit: any) => void;\n  // Unconformity height in pixels\n  unconformityHeight?: number;\n  scale?: ScaleContinuousNumeric<number, number>;\n  ref?: RefObject<ColumnRef>;\n}\n\nexport function Column(props: ColumnProps) {\n  const {\n    showUnitPopover = false,\n    keyboardNavigation = false,\n    mergeSections,\n    onUnitSelected,\n    selectedUnit,\n    children,\n    units: rawUnits,\n    t_age,\n    b_age,\n    t_pos,\n    b_pos,\n    unconformityHeight = 30,\n    targetUnitHeight = 20,\n    pixelScale,\n    minPixelScale = 0.2,\n    minSectionHeight = 50,\n    collapseSmallUnconformities = true,\n    allowUnitSelection = false,\n    hybridScale,\n    scale,\n    axisType,\n    ref,\n    ...rest\n  } = props;\n\n  /* Make pixelScale and targetUnitHeight mutually exclusive. PixelScale implies\n   * standardization of scales in all sections */\n  let _targetUnitHeight: number | null = targetUnitHeight;\n  let _minSectionHeight = minSectionHeight;\n  let _minPixelScale = minPixelScale;\n  if (pixelScale != null) {\n    _targetUnitHeight = null;\n    _minSectionHeight = 0;\n    _minPixelScale = pixelScale;\n  }\n\n  // Handle special cases for hybrid scales (WIP, we need to regularize this)\n  let _axisType = axisType ?? ColumnAxisType.AGE;\n  let ageAxisComponent = CompositeAgeAxis;\n  if (\n    hybridScale?.type === HybridScaleType.ApproximateHeight &&\n    _axisType != ColumnAxisType.AGE\n  ) {\n    // Use approximate height axis for non-age columns if a non-age axis type is requested\n    ageAxisComponent = ApproximateHeightAxis;\n    _axisType = ColumnAxisType.AGE;\n  }\n\n  const { sections, units, totalHeight } = usePreparedColumnUnits(rawUnits, {\n    axisType: _axisType,\n    t_age,\n    b_age,\n    t_pos,\n    b_pos,\n    mergeSections,\n    targetUnitHeight: _targetUnitHeight,\n    unconformityHeight,\n    pixelScale,\n    minPixelScale: _minPixelScale,\n    minSectionHeight: _minSectionHeight,\n    collapseSmallUnconformities,\n    // TODO: consider unifying scale and hybridScale options\n    scale,\n    hybridScale,\n  });\n\n  if (sections.length === 0) {\n    return h(\n      \"div.column-container.empty\",\n      h(NonIdealState, {\n        title: \"Empty column\",\n        description: \"No sections found in this column.\",\n        icon: \"warning-sign\",\n      }),\n    );\n  }\n\n  return h(\n    MacrostratColumnDataProvider,\n    {\n      units,\n      sections,\n      totalHeight,\n      axisType: _axisType,\n      allowUnitSelection: showUnitPopover || allowUnitSelection,\n      onUnitSelected,\n      selectedUnit,\n      ref,\n    },\n    h(ColumnInner, { ageAxisComponent, ...rest }, [\n      children,\n      h.if(showUnitPopover)(UnitSelectionPopover),\n      h.if(keyboardNavigation)(UnitKeyboardNavigation, { units }),\n    ]),\n  );\n}\n\ninterface ColumnInnerProps extends BaseColumnProps {\n  ageAxisComponent?: ComponentType;\n}\n\nfunction ColumnInner(props: ColumnInnerProps) {\n  const padding = extractPadding(props);\n\n  // TODO: integrate padding vars more closely with the rest of the spacing (right now padding is a bit ad-hoc)\n  const paddingVars: any = {\n    \"--column-padding-top\": `${padding.paddingTop}px`,\n    \"--column-padding-bottom\": `${padding.paddingBottom}px`,\n    \"--column-padding-left\": `${padding.paddingLeft}px`,\n    \"--column-padding-right\": `${padding.paddingRight}px`,\n  };\n\n  const {\n    unitComponent = UnitComponent,\n    unconformityLabels = \"minimal\",\n    showLabels = true,\n    width: _width = 300,\n    columnWidth: _columnWidth = 150,\n    showLabelColumn: _showLabelColumn = true,\n    className,\n    clipUnits = false,\n    children,\n    showTimescale,\n    timescaleLevels,\n    maxInternalColumns,\n    onMouseOver,\n    ageAxisComponent = CompositeAgeAxis,\n  } = props;\n\n  const { axisType } = useMacrostratColumnData();\n\n  const columnRef = useColumnRef();\n\n  // Coalesce unconformity label setting to a boolean\n  let _timescaleUnconformityLabels = false;\n  let _sectionUnconformityLabels = false;\n  if (unconformityLabels === true || unconformityLabels === \"prominent\") {\n    _sectionUnconformityLabels = true;\n  } else if (unconformityLabels === \"minimal\") {\n    _timescaleUnconformityLabels = true;\n  }\n\n  let width = _width;\n  let columnWidth = _columnWidth;\n  if (columnWidth > width) {\n    columnWidth = width;\n  }\n  let showLabelColumn = _showLabelColumn;\n  if (columnWidth > width - 10) {\n    showLabelColumn = false;\n  }\n\n  let _showTimescale = showTimescale ?? true;\n  if (timescaleLevels != null) {\n    _showTimescale = true;\n  }\n  _showTimescale = axisType == ColumnAxisType.AGE && _showTimescale;\n\n  return h(\n    ColumnContainer,\n    {\n      ...useMouseEventHandlers(onMouseOver),\n      style: paddingVars,\n      className,\n    },\n    h(\"div.column\", { ref: columnRef }, [\n      h(ageAxisComponent),\n      h.if(_showTimescale)(CompositeTimescale, {\n        levels: timescaleLevels,\n        unconformityLabels: _timescaleUnconformityLabels,\n      }),\n      h(SectionsColumn, {\n        unitComponent,\n        showLabels,\n        width,\n        columnWidth,\n        showLabelColumn,\n        clipUnits,\n        unconformityLabels: _sectionUnconformityLabels,\n        maxInternalColumns,\n      }),\n      children,\n    ]),\n  );\n}\n\ntype ColumnMouseOverHandler = (\n  unit: UnitLong | null,\n  height: number | null,\n  evt: MouseEvent,\n) => void;\n\nfunction useMouseEventHandlers(\n  _onMouseOver: ColumnMouseOverHandler | null = null,\n) {\n  /** Click event handler */\n\n  // Click handler for unit selection\n  const dispatch = useUnitSelectionDispatch();\n  const onClick = useCallback(\n    (evt) => {\n      dispatch?.(null, null);\n    },\n    [dispatch],\n  );\n\n  /** Hover event handlers */\n  const scale = useCompositeScale();\n\n  const onMouseOver = useCallback(\n    (evt) => {\n      const height = scale.invert(\n        evt.clientY - evt.currentTarget.getBoundingClientRect().top,\n      );\n      _onMouseOver?.(null, height, evt);\n    },\n    [scale, _onMouseOver],\n  );\n\n  const onMouseOut = useCallback(() => {\n    _onMouseOver?.(null, null, null);\n  }, [_onMouseOver]);\n\n  if (_onMouseOver == null) {\n    return {\n      onClick,\n      onMouseOver: undefined,\n      onMouseMove: undefined,\n      onMouseOut: undefined,\n    };\n  }\n\n  return { onMouseOver, onMouseMove: onMouseOver, onMouseOut, onClick };\n}\n\nexport interface ColumnContainerProps extends HTMLAttributes<HTMLDivElement> {\n  className?: string;\n  style?: CSSProperties;\n}\n\nexport function ColumnContainer(props: ColumnContainerProps) {\n  const { className, ...rest } = props;\n  const darkMode = useDarkMode();\n\n  return h(Box, {\n    className: classNames(\n      className,\n      {\n        \"dark-mode\": darkMode?.isEnabled ?? false,\n      },\n      \"column-container\",\n    ),\n    ...rest,\n  });\n}\n\nexport function ColumnBasicInfo({\n  data,\n  showColumnID = true,\n  showReferences = true,\n}) {\n  if (data == null) return null;\n  return h(\"div.column-info\", [\n    h(\"div.column-title-row\", [\n      h(\"h2\", data.col_name),\n      h.if(showColumnID)(\"h4\", h(Identifier, { id: data.col_id })),\n    ]),\n    h(DataField, { row: true, label: \"Group\", value: data.col_group }),\n    h.if(showReferences)(ReferencesField, {\n      refs: data.refs,\n      inline: false,\n      row: false,\n      className: \"column-refs\",\n    }),\n  ]);\n}\n"],"names":[],"mappings":"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"}

package/dist/data-provider/store.cjs

@@ -61,7 +61,8 @@ function MacrostratColumnDataProvider({
   axisType,
   allowUnitSelection,
   onUnitSelected,
-  selectedUnit
+  selectedUnit,
+  ref
 }) {
   const value = React.useMemo(() => {
     return {
@@ -77,11 +78,33 @@ function MacrostratColumnDataProvider({
       units,
       allowUnitSelection,
       onUnitSelected,
-      selectedUnit
+      selectedUnit,
+      ref
     },
-    h__default.default(MacrostratColumnDataContext.Provider, { value }, children)
+    [
+      h__default.default(ColumnRefManager, { ref }),
+      h__default.default(MacrostratColumnDataContext.Provider, { value }, children)
+    ]
   );
 }
+function ColumnRefManager({ ref }) {
+  const selectedUnitElement = scope.useAtomValue(unitSelection.selectedUnitElementAtom);
+  React.useEffect(() => {
+    if (ref == null) return;
+    ref.current = {
+      scrollSelectedUnitIntoView(opts) {
+        selectedUnitElement?.scrollIntoView(
+          opts ?? {
+            behavior: "smooth",
+            block: "center",
+            inline: "nearest"
+          }
+        );
+      }
+    };
+  }, [ref, selectedUnitElement]);
+  return null;
+}
 function UnitSelectionProvider(props) {
   return h__default.default(MacrostratColumnStateProvider, {
     ...props,

package/dist/data-provider/store.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"store.cjs","sources":["../../src/data-provider/store.ts"],"sourcesContent":["import { createContext, ReactNode, useContext, useMemo } from \"react\";\nimport h from \"@macrostrat/hyper\";\nimport {\n  CompositeColumnScale,\n  createCompositeScale,\n} from \"../prepare-units/composite-scale\";\nimport { ColumnAxisType, ColumnProvider } from \"@macrostrat/column-components\";\nimport type { ExtUnit, PackageLayoutData } from \"../prepare-units\";\nimport {\n  allowUnitSelectionAtom,\n  selectedUnitIDAtom,\n  UnitSelectionCallbacks,\n  UnitSelectionCallbackManager,\n} from \"./unit-selection\";\nimport type { BaseUnit } from \"@macrostrat/api-types\";\nimport { type AtomMap, createScopedStore } from \"@macrostrat/data-components\";\nimport { atom } from \"jotai\";\nimport { useEffect } from \"react\";\n\nexport const scope = createScopedStore();\n\nexport const columnUnitsAtom = atom<BaseUnit[]>();\n\nexport const columnUnitsMapAtom = atom<Map<number, BaseUnit> | null>((get) => {\n  const units = get(columnUnitsAtom);\n  if (!units) return null;\n  const unitMap = new Map<number, BaseUnit>();\n  units.forEach((unit) => {\n    unitMap.set(unit.unit_id, unit);\n  });\n  return unitMap;\n});\n\nexport interface ColumnStateProviderProps<\n  T extends BaseUnit,\n> extends Partial<UnitSelectionCallbacks> {\n  children: ReactNode;\n  units: T[];\n  selectedUnit: number | null;\n  allowUnitSelection?: boolean;\n}\n\nexport function MacrostratColumnStateProvider<T extends BaseUnit>({\n  children,\n  units,\n  allowUnitSelection = false,\n  onUnitSelected,\n  selectedUnit,\n}: ColumnStateProviderProps<T>) {\n  /** Top-level provider for Macrostrat column data.\n   * It is either provided by the Column component itself, or\n   * can be hoisted higher in the tree to provide a common data context\n   */\n\n  /* By default, unit selection is disabled. However, if any related props are passed,\n  we enable it.\n  */\n  const _allowSelection = useMemo(() => {\n    if (allowUnitSelection) {\n      return true;\n    }\n    return selectedUnit != null || onUnitSelected != null;\n  }, []);\n\n  const atomMap: AtomMap = [\n    [columnUnitsAtom, units],\n    [allowUnitSelectionAtom, _allowSelection],\n    [selectedUnitIDAtom, selectedUnit],\n  ];\n\n  let selectionHandlers: ReactNode = null;\n  if (_allowSelection) {\n    selectionHandlers = h(UnitSelectionCallbackManager, { onUnitSelected });\n  }\n\n  return h(\n    scope.Provider,\n    {\n      atoms: atomMap,\n      keepUpdated: true,\n      inherit: true,\n    },\n    [selectionHandlers, children],\n  );\n}\n\nexport interface MacrostratColumnDataContext<T extends BaseUnit> {\n  units: T[];\n  sections: PackageLayoutData[];\n  totalHeight?: number;\n  axisType?: ColumnAxisType;\n  allowUnitSelection?: boolean;\n}\n\nexport interface ColumnDataProviderProps<T extends BaseUnit>\n  extends MacrostratColumnDataContext<T>, ColumnStateProviderProps<T> {\n  children: ReactNode;\n}\n\nconst MacrostratColumnDataContext =\n  createContext<MacrostratColumnDataContext<any>>(null);\n\nexport function MacrostratColumnDataProvider<T extends BaseUnit>({\n  children,\n  units,\n  sections,\n  totalHeight,\n  axisType,\n  allowUnitSelection,\n  onUnitSelected,\n  selectedUnit,\n}: ColumnDataProviderProps<T>) {\n  /** Internal provider for Macrostrat column data.\n   * As a general rule, we want to provide data and column-axis\n   * height calculations through the context, since these need to\n   * be accessed by any component that lays out information on the\n   * column.\n   *\n   * Cross-axis layout and view configuration (e.g., showing and hiding\n   * of different components or labels) should be handled through passing\n   * props to the components themselves.\n   * */\n\n  const value = useMemo(() => {\n    // For now, change ordinal axis types to age axis types\n    return {\n      units,\n      sections,\n      totalHeight,\n      axisType,\n    };\n  }, [units, sections, totalHeight, axisType]);\n\n  return h(\n    MacrostratColumnStateProvider,\n    {\n      units,\n      allowUnitSelection,\n      onUnitSelected,\n      selectedUnit,\n    },\n    h(MacrostratColumnDataContext.Provider, { value }, children),\n  );\n}\n\nexport function UnitSelectionProvider(props: ColumnStateProviderProps<any>) {\n  /* A basic unit selection provider without column data context.\n  Mostly for use with the CorrelationChart component.\n   */\n  return h(MacrostratColumnStateProvider, {\n    ...props,\n    allowUnitSelection: true,\n  });\n}\n\nexport function useMacrostratColumnData() {\n  const ctx = useContext(MacrostratColumnDataContext);\n  if (!ctx) {\n    throw new Error(\n      \"useMacrostratColumnData must be used within a MacrostratColumnDataProvider\",\n    );\n  }\n  return ctx;\n}\n\nexport function useMacrostratUnits() {\n  return scope.useAtomValue(columnUnitsAtom);\n}\n\nexport function useColumnUnitsMap(): Map<number, ExtUnit> | null {\n  try {\n    return scope.useAtomValue(columnUnitsMapAtom) as Map<number, ExtUnit>;\n  } catch {\n    return null;\n  }\n}\n\nexport function useCompositeScale(): CompositeColumnScale {\n  const ctx = useMacrostratColumnData();\n  return useMemo(\n    () => createCompositeScale(ctx.sections, true),\n    [ctx.sections],\n  );\n}\n\nexport function MacrostratColumnProvider(props) {\n  /** A column provider specialized the Macrostrat API. Maps more\n   * generic concepts to Macrostrat-specific ones.\n   */\n\n  const { axisType } = useMacrostratColumnData();\n  const { units, domain, pixelScale, scale, children } = props;\n  return h(\n    ColumnProvider,\n    {\n      axisType,\n      divisions: units,\n      range: domain,\n      pixelsPerMeter: pixelScale,\n      scale,\n    },\n    children,\n  );\n}\n\n/** This is now a legacy provider */\nexport function LithologiesProvider({ children }) {\n  useEffect(() => {\n    console.warn(\n      \"LithologiesProvider is deprecated. Replace with MacrostratDataProvider\",\n    );\n  }, []);\n  return children;\n}\n"],"names":["createScopedStore","atom","useMemo","allowUnitSelectionAtom","selectedUnitIDAtom","h","UnitSelectionCallbackManager","createContext","useContext","createCompositeScale","ColumnProvider","useEffect"],"mappings":"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"}
+{"version":3,"file":"store.cjs","sources":["../../src/data-provider/store.ts"],"sourcesContent":["import {\n  createContext,\n  ReactNode,\n  RefObject,\n  useContext,\n  useMemo,\n} from \"react\";\nimport h from \"@macrostrat/hyper\";\nimport {\n  CompositeColumnScale,\n  createCompositeScale,\n} from \"../prepare-units/composite-scale\";\nimport { ColumnAxisType, ColumnProvider } from \"@macrostrat/column-components\";\nimport type { ExtUnit, PackageLayoutData } from \"../prepare-units\";\nimport {\n  allowUnitSelectionAtom,\n  selectedUnitIDAtom,\n  UnitSelectionCallbacks,\n  UnitSelectionCallbackManager,\n  selectedUnitElementAtom,\n} from \"./unit-selection\";\nimport type { BaseUnit } from \"@macrostrat/api-types\";\nimport {\n  type AtomMap,\n  createScopedStore,\n  StateIsolation,\n} from \"@macrostrat/data-components\";\nimport { atom } from \"jotai\";\nimport { useEffect } from \"react\";\n\nexport const scope: StateIsolation = createScopedStore();\n\nexport const columnUnitsAtom = atom<BaseUnit[]>();\n\nexport const columnUnitsMapAtom = atom<Map<number, BaseUnit> | null>((get) => {\n  const units = get(columnUnitsAtom);\n  if (!units) return null;\n  const unitMap = new Map<number, BaseUnit>();\n  units.forEach((unit) => {\n    unitMap.set(unit.unit_id, unit);\n  });\n  return unitMap;\n});\n\nexport interface ColumnStateProviderProps<\n  T extends BaseUnit,\n> extends Partial<UnitSelectionCallbacks> {\n  children: ReactNode;\n  units: T[];\n  selectedUnit: number | null;\n  allowUnitSelection?: boolean;\n}\n\nexport function MacrostratColumnStateProvider<T extends BaseUnit>({\n  children,\n  units,\n  allowUnitSelection = false,\n  onUnitSelected,\n  selectedUnit,\n}: ColumnStateProviderProps<T>) {\n  /** Top-level provider for Macrostrat column data.\n   * It is either provided by the Column component itself, or\n   * can be hoisted higher in the tree to provide a common data context\n   */\n\n  /* By default, unit selection is disabled. However, if any related props are passed,\n  we enable it.\n  */\n  const _allowSelection = useMemo(() => {\n    if (allowUnitSelection) {\n      return true;\n    }\n    return selectedUnit != null || onUnitSelected != null;\n  }, []);\n\n  const atomMap: AtomMap = [\n    [columnUnitsAtom, units],\n    [allowUnitSelectionAtom, _allowSelection],\n    [selectedUnitIDAtom, selectedUnit],\n  ];\n\n  let selectionHandlers: ReactNode = null;\n  if (_allowSelection) {\n    selectionHandlers = h(UnitSelectionCallbackManager, { onUnitSelected });\n  }\n\n  return h(\n    scope.Provider,\n    {\n      atoms: atomMap,\n      keepUpdated: true,\n      inherit: true,\n    },\n    [selectionHandlers, children],\n  );\n}\n\n/** Interface for imperative handlers that can\n * be invoked outside of the column's react context\n */\nexport interface ColumnRef {\n  scrollSelectedUnitIntoView(): void;\n}\n\nexport interface MacrostratColumnDataContext<T extends BaseUnit> {\n  units: T[];\n  sections: PackageLayoutData[];\n  totalHeight?: number;\n  axisType?: ColumnAxisType;\n  allowUnitSelection?: boolean;\n}\n\nexport interface ColumnDataProviderProps<T extends BaseUnit>\n  extends MacrostratColumnDataContext<T>, ColumnStateProviderProps<T> {\n  children: ReactNode;\n  ref: RefObject<ColumnRef>;\n}\n\nconst MacrostratColumnDataContext =\n  createContext<MacrostratColumnDataContext<any>>(null);\n\nexport function MacrostratColumnDataProvider<T extends BaseUnit>({\n  children,\n  units,\n  sections,\n  totalHeight,\n  axisType,\n  allowUnitSelection,\n  onUnitSelected,\n  selectedUnit,\n  ref,\n}: ColumnDataProviderProps<T>) {\n  /** Internal provider for Macrostrat column data.\n   * As a general rule, we want to provide data and column-axis\n   * height calculations through the context, since these need to\n   * be accessed by any component that lays out information on the\n   * column.\n   *\n   * Cross-axis layout and view configuration (e.g., showing and hiding\n   * of different components or labels) should be handled through passing\n   * props to the components themselves.\n   * */\n\n  const value = useMemo(() => {\n    // For now, change ordinal axis types to age axis types\n    return {\n      units,\n      sections,\n      totalHeight,\n      axisType,\n    };\n  }, [units, sections, totalHeight, axisType]);\n\n  return h(\n    MacrostratColumnStateProvider,\n    {\n      units,\n      allowUnitSelection,\n      onUnitSelected,\n      selectedUnit,\n      ref,\n    },\n    [\n      h(ColumnRefManager, { ref }),\n      h(MacrostratColumnDataContext.Provider, { value }, children),\n    ],\n  );\n}\n\nfunction ColumnRefManager({ ref }: { ref?: RefObject<ColumnRef> }) {\n  const selectedUnitElement = scope.useAtomValue(selectedUnitElementAtom);\n  useEffect(() => {\n    if (ref == null) return;\n    ref.current = {\n      scrollSelectedUnitIntoView(opts?: ScrollIntoViewOptions) {\n        selectedUnitElement?.scrollIntoView(\n          opts ?? {\n            behavior: \"smooth\",\n            block: \"center\",\n            inline: \"nearest\",\n          },\n        );\n      },\n    };\n  }, [ref, selectedUnitElement]);\n\n  return null;\n}\n\nexport function UnitSelectionProvider(props: ColumnStateProviderProps<any>) {\n  /* A basic unit selection provider without column data context.\n  Mostly for use with the CorrelationChart component.\n   */\n  return h(MacrostratColumnStateProvider, {\n    ...props,\n    allowUnitSelection: true,\n  });\n}\n\nexport function useMacrostratColumnData() {\n  const ctx = useContext(MacrostratColumnDataContext);\n  if (!ctx) {\n    throw new Error(\n      \"useMacrostratColumnData must be used within a MacrostratColumnDataProvider\",\n    );\n  }\n  return ctx;\n}\n\nexport function useMacrostratUnits() {\n  return scope.useAtomValue(columnUnitsAtom);\n}\n\nexport function useColumnUnitsMap(): Map<number, ExtUnit> | null {\n  try {\n    return scope.useAtomValue(columnUnitsMapAtom) as Map<number, ExtUnit>;\n  } catch {\n    return null;\n  }\n}\n\nexport function useCompositeScale(): CompositeColumnScale {\n  const ctx = useMacrostratColumnData();\n  return useMemo(\n    () => createCompositeScale(ctx.sections, true),\n    [ctx.sections],\n  );\n}\n\nexport function MacrostratColumnProvider(props) {\n  /** A column provider specialized the Macrostrat API. Maps more\n   * generic concepts to Macrostrat-specific ones.\n   */\n\n  const { axisType } = useMacrostratColumnData();\n  const { units, domain, pixelScale, scale, children } = props;\n  return h(\n    ColumnProvider,\n    {\n      axisType,\n      divisions: units,\n      range: domain,\n      pixelsPerMeter: pixelScale,\n      scale,\n    },\n    children,\n  );\n}\n\n/** This is now a legacy provider */\nexport function LithologiesProvider({ children }) {\n  useEffect(() => {\n    console.warn(\n      \"LithologiesProvider is deprecated. Replace with MacrostratDataProvider\",\n    );\n  }, []);\n  return children;\n}\n"],"names":["createScopedStore","atom","useMemo","allowUnitSelectionAtom","selectedUnitIDAtom","h","UnitSelectionCallbackManager","createContext","selectedUnitElementAtom","useEffect","useContext","createCompositeScale","ColumnProvider"],"mappings":"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"}

package/dist/data-provider/store.d.ts

@@ -0,0 +1,52 @@
+import { ReactNode, RefObject } from 'react';
+import { CompositeColumnScale } from '../prepare-units/composite-scale';
+import { ColumnAxisType } from '@macrostrat/column-components';
+import { ExtUnit, PackageLayoutData } from '../prepare-units';
+import { UnitSelectionCallbacks } from './unit-selection';
+import { BaseUnit } from '@macrostrat/api-types';
+import { AtomMap, StateIsolation } from '@macrostrat/data-components';
+export declare const scope: StateIsolation;
+export declare const columnUnitsAtom: import('jotai').PrimitiveAtom<BaseUnit[] | undefined> & {
+    init: BaseUnit[] | undefined;
+};
+export declare const columnUnitsMapAtom: import('jotai').Atom<Map<number, BaseUnit> | null>;
+export interface ColumnStateProviderProps<T extends BaseUnit> extends Partial<UnitSelectionCallbacks> {
+    children: ReactNode;
+    units: T[];
+    selectedUnit: number | null;
+    allowUnitSelection?: boolean;
+}
+export declare function MacrostratColumnStateProvider<T extends BaseUnit>({ children, units, allowUnitSelection, onUnitSelected, selectedUnit, }: ColumnStateProviderProps<T>): import('react').FunctionComponentElement<{
+    children: ReactNode;
+    atoms?: AtomMap;
+    keepUpdated?: boolean;
+    inherit?: boolean;
+}>;
+/** Interface for imperative handlers that can
+ * be invoked outside of the column's react context
+ */
+export interface ColumnRef {
+    scrollSelectedUnitIntoView(): void;
+}
+export interface MacrostratColumnDataContext<T extends BaseUnit> {
+    units: T[];
+    sections: PackageLayoutData[];
+    totalHeight?: number;
+    axisType?: ColumnAxisType;
+    allowUnitSelection?: boolean;
+}
+export interface ColumnDataProviderProps<T extends BaseUnit> extends MacrostratColumnDataContext<T>, ColumnStateProviderProps<T> {
+    children: ReactNode;
+    ref: RefObject<ColumnRef>;
+}
+export declare function MacrostratColumnDataProvider<T extends BaseUnit>({ children, units, sections, totalHeight, axisType, allowUnitSelection, onUnitSelected, selectedUnit, ref, }: ColumnDataProviderProps<T>): import('react').FunctionComponentElement<ColumnStateProviderProps<BaseUnit>>;
+export declare function UnitSelectionProvider(props: ColumnStateProviderProps<any>): import('react').FunctionComponentElement<ColumnStateProviderProps<BaseUnit>>;
+export declare function useMacrostratColumnData(): MacrostratColumnDataContext<any>;
+export declare function useMacrostratUnits(): any;
+export declare function useColumnUnitsMap(): Map<number, ExtUnit> | null;
+export declare function useCompositeScale(): CompositeColumnScale;
+export declare function MacrostratColumnProvider(props: any): import('react').FunctionComponentElement<import('@macrostrat/column-components').ColumnProviderProps<import('@macrostrat/column-components').ColumnDivision>>;
+/** This is now a legacy provider */
+export declare function LithologiesProvider({ children }: {
+    children: any;
+}): any;

package/dist/data-provider/store.js

@@ -2,7 +2,7 @@ import { useEffect, useMemo, useContext, createContext } from "react";
 import h from "@macrostrat/hyper";
 import { createCompositeScale } from "../prepare-units/composite-scale.js";
 import { ColumnProvider } from "@macrostrat/column-components";
-import { UnitSelectionCallbackManager, allowUnitSelectionAtom, selectedUnitIDAtom } from "./unit-selection.js";
+import { UnitSelectionCallbackManager, allowUnitSelectionAtom, selectedUnitIDAtom, selectedUnitElementAtom } from "./unit-selection.js";
 import { createScopedStore } from "@macrostrat/data-components";
 import { atom } from "jotai";
 const scope = createScopedStore();
@@ -57,7 +57,8 @@ function MacrostratColumnDataProvider({
   axisType,
   allowUnitSelection,
   onUnitSelected,
-  selectedUnit
+  selectedUnit,
+  ref
 }) {
   const value = useMemo(() => {
     return {
@@ -73,11 +74,33 @@ function MacrostratColumnDataProvider({
       units,
       allowUnitSelection,
       onUnitSelected,
-      selectedUnit
+      selectedUnit,
+      ref
     },
-    h(MacrostratColumnDataContext.Provider, { value }, children)
+    [
+      h(ColumnRefManager, { ref }),
+      h(MacrostratColumnDataContext.Provider, { value }, children)
+    ]
   );
 }
+function ColumnRefManager({ ref }) {
+  const selectedUnitElement = scope.useAtomValue(selectedUnitElementAtom);
+  useEffect(() => {
+    if (ref == null) return;
+    ref.current = {
+      scrollSelectedUnitIntoView(opts) {
+        selectedUnitElement?.scrollIntoView(
+          opts ?? {
+            behavior: "smooth",
+            block: "center",
+            inline: "nearest"
+          }
+        );
+      }
+    };
+  }, [ref, selectedUnitElement]);
+  return null;
+}
 function UnitSelectionProvider(props) {
   return h(MacrostratColumnStateProvider, {
     ...props,

package/dist/data-provider/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sources":["../../src/data-provider/store.ts"],"sourcesContent":["import { createContext, ReactNode, useContext, useMemo } from \"react\";\nimport h from \"@macrostrat/hyper\";\nimport {\n  CompositeColumnScale,\n  createCompositeScale,\n} from \"../prepare-units/composite-scale\";\nimport { ColumnAxisType, ColumnProvider } from \"@macrostrat/column-components\";\nimport type { ExtUnit, PackageLayoutData } from \"../prepare-units\";\nimport {\n  allowUnitSelectionAtom,\n  selectedUnitIDAtom,\n  UnitSelectionCallbacks,\n  UnitSelectionCallbackManager,\n} from \"./unit-selection\";\nimport type { BaseUnit } from \"@macrostrat/api-types\";\nimport { type AtomMap, createScopedStore } from \"@macrostrat/data-components\";\nimport { atom } from \"jotai\";\nimport { useEffect } from \"react\";\n\nexport const scope = createScopedStore();\n\nexport const columnUnitsAtom = atom<BaseUnit[]>();\n\nexport const columnUnitsMapAtom = atom<Map<number, BaseUnit> | null>((get) => {\n  const units = get(columnUnitsAtom);\n  if (!units) return null;\n  const unitMap = new Map<number, BaseUnit>();\n  units.forEach((unit) => {\n    unitMap.set(unit.unit_id, unit);\n  });\n  return unitMap;\n});\n\nexport interface ColumnStateProviderProps<\n  T extends BaseUnit,\n> extends Partial<UnitSelectionCallbacks> {\n  children: ReactNode;\n  units: T[];\n  selectedUnit: number | null;\n  allowUnitSelection?: boolean;\n}\n\nexport function MacrostratColumnStateProvider<T extends BaseUnit>({\n  children,\n  units,\n  allowUnitSelection = false,\n  onUnitSelected,\n  selectedUnit,\n}: ColumnStateProviderProps<T>) {\n  /** Top-level provider for Macrostrat column data.\n   * It is either provided by the Column component itself, or\n   * can be hoisted higher in the tree to provide a common data context\n   */\n\n  /* By default, unit selection is disabled. However, if any related props are passed,\n  we enable it.\n  */\n  const _allowSelection = useMemo(() => {\n    if (allowUnitSelection) {\n      return true;\n    }\n    return selectedUnit != null || onUnitSelected != null;\n  }, []);\n\n  const atomMap: AtomMap = [\n    [columnUnitsAtom, units],\n    [allowUnitSelectionAtom, _allowSelection],\n    [selectedUnitIDAtom, selectedUnit],\n  ];\n\n  let selectionHandlers: ReactNode = null;\n  if (_allowSelection) {\n    selectionHandlers = h(UnitSelectionCallbackManager, { onUnitSelected });\n  }\n\n  return h(\n    scope.Provider,\n    {\n      atoms: atomMap,\n      keepUpdated: true,\n      inherit: true,\n    },\n    [selectionHandlers, children],\n  );\n}\n\nexport interface MacrostratColumnDataContext<T extends BaseUnit> {\n  units: T[];\n  sections: PackageLayoutData[];\n  totalHeight?: number;\n  axisType?: ColumnAxisType;\n  allowUnitSelection?: boolean;\n}\n\nexport interface ColumnDataProviderProps<T extends BaseUnit>\n  extends MacrostratColumnDataContext<T>, ColumnStateProviderProps<T> {\n  children: ReactNode;\n}\n\nconst MacrostratColumnDataContext =\n  createContext<MacrostratColumnDataContext<any>>(null);\n\nexport function MacrostratColumnDataProvider<T extends BaseUnit>({\n  children,\n  units,\n  sections,\n  totalHeight,\n  axisType,\n  allowUnitSelection,\n  onUnitSelected,\n  selectedUnit,\n}: ColumnDataProviderProps<T>) {\n  /** Internal provider for Macrostrat column data.\n   * As a general rule, we want to provide data and column-axis\n   * height calculations through the context, since these need to\n   * be accessed by any component that lays out information on the\n   * column.\n   *\n   * Cross-axis layout and view configuration (e.g., showing and hiding\n   * of different components or labels) should be handled through passing\n   * props to the components themselves.\n   * */\n\n  const value = useMemo(() => {\n    // For now, change ordinal axis types to age axis types\n    return {\n      units,\n      sections,\n      totalHeight,\n      axisType,\n    };\n  }, [units, sections, totalHeight, axisType]);\n\n  return h(\n    MacrostratColumnStateProvider,\n    {\n      units,\n      allowUnitSelection,\n      onUnitSelected,\n      selectedUnit,\n    },\n    h(MacrostratColumnDataContext.Provider, { value }, children),\n  );\n}\n\nexport function UnitSelectionProvider(props: ColumnStateProviderProps<any>) {\n  /* A basic unit selection provider without column data context.\n  Mostly for use with the CorrelationChart component.\n   */\n  return h(MacrostratColumnStateProvider, {\n    ...props,\n    allowUnitSelection: true,\n  });\n}\n\nexport function useMacrostratColumnData() {\n  const ctx = useContext(MacrostratColumnDataContext);\n  if (!ctx) {\n    throw new Error(\n      \"useMacrostratColumnData must be used within a MacrostratColumnDataProvider\",\n    );\n  }\n  return ctx;\n}\n\nexport function useMacrostratUnits() {\n  return scope.useAtomValue(columnUnitsAtom);\n}\n\nexport function useColumnUnitsMap(): Map<number, ExtUnit> | null {\n  try {\n    return scope.useAtomValue(columnUnitsMapAtom) as Map<number, ExtUnit>;\n  } catch {\n    return null;\n  }\n}\n\nexport function useCompositeScale(): CompositeColumnScale {\n  const ctx = useMacrostratColumnData();\n  return useMemo(\n    () => createCompositeScale(ctx.sections, true),\n    [ctx.sections],\n  );\n}\n\nexport function MacrostratColumnProvider(props) {\n  /** A column provider specialized the Macrostrat API. Maps more\n   * generic concepts to Macrostrat-specific ones.\n   */\n\n  const { axisType } = useMacrostratColumnData();\n  const { units, domain, pixelScale, scale, children } = props;\n  return h(\n    ColumnProvider,\n    {\n      axisType,\n      divisions: units,\n      range: domain,\n      pixelsPerMeter: pixelScale,\n      scale,\n    },\n    children,\n  );\n}\n\n/** This is now a legacy provider */\nexport function LithologiesProvider({ children }) {\n  useEffect(() => {\n    console.warn(\n      \"LithologiesProvider is deprecated. Replace with MacrostratDataProvider\",\n    );\n  }, []);\n  return children;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"store.js","sources":["../../src/data-provider/store.ts"],"sourcesContent":["import {\n  createContext,\n  ReactNode,\n  RefObject,\n  useContext,\n  useMemo,\n} from \"react\";\nimport h from \"@macrostrat/hyper\";\nimport {\n  CompositeColumnScale,\n  createCompositeScale,\n} from \"../prepare-units/composite-scale\";\nimport { ColumnAxisType, ColumnProvider } from \"@macrostrat/column-components\";\nimport type { ExtUnit, PackageLayoutData } from \"../prepare-units\";\nimport {\n  allowUnitSelectionAtom,\n  selectedUnitIDAtom,\n  UnitSelectionCallbacks,\n  UnitSelectionCallbackManager,\n  selectedUnitElementAtom,\n} from \"./unit-selection\";\nimport type { BaseUnit } from \"@macrostrat/api-types\";\nimport {\n  type AtomMap,\n  createScopedStore,\n  StateIsolation,\n} from \"@macrostrat/data-components\";\nimport { atom } from \"jotai\";\nimport { useEffect } from \"react\";\n\nexport const scope: StateIsolation = createScopedStore();\n\nexport const columnUnitsAtom = atom<BaseUnit[]>();\n\nexport const columnUnitsMapAtom = atom<Map<number, BaseUnit> | null>((get) => {\n  const units = get(columnUnitsAtom);\n  if (!units) return null;\n  const unitMap = new Map<number, BaseUnit>();\n  units.forEach((unit) => {\n    unitMap.set(unit.unit_id, unit);\n  });\n  return unitMap;\n});\n\nexport interface ColumnStateProviderProps<\n  T extends BaseUnit,\n> extends Partial<UnitSelectionCallbacks> {\n  children: ReactNode;\n  units: T[];\n  selectedUnit: number | null;\n  allowUnitSelection?: boolean;\n}\n\nexport function MacrostratColumnStateProvider<T extends BaseUnit>({\n  children,\n  units,\n  allowUnitSelection = false,\n  onUnitSelected,\n  selectedUnit,\n}: ColumnStateProviderProps<T>) {\n  /** Top-level provider for Macrostrat column data.\n   * It is either provided by the Column component itself, or\n   * can be hoisted higher in the tree to provide a common data context\n   */\n\n  /* By default, unit selection is disabled. However, if any related props are passed,\n  we enable it.\n  */\n  const _allowSelection = useMemo(() => {\n    if (allowUnitSelection) {\n      return true;\n    }\n    return selectedUnit != null || onUnitSelected != null;\n  }, []);\n\n  const atomMap: AtomMap = [\n    [columnUnitsAtom, units],\n    [allowUnitSelectionAtom, _allowSelection],\n    [selectedUnitIDAtom, selectedUnit],\n  ];\n\n  let selectionHandlers: ReactNode = null;\n  if (_allowSelection) {\n    selectionHandlers = h(UnitSelectionCallbackManager, { onUnitSelected });\n  }\n\n  return h(\n    scope.Provider,\n    {\n      atoms: atomMap,\n      keepUpdated: true,\n      inherit: true,\n    },\n    [selectionHandlers, children],\n  );\n}\n\n/** Interface for imperative handlers that can\n * be invoked outside of the column's react context\n */\nexport interface ColumnRef {\n  scrollSelectedUnitIntoView(): void;\n}\n\nexport interface MacrostratColumnDataContext<T extends BaseUnit> {\n  units: T[];\n  sections: PackageLayoutData[];\n  totalHeight?: number;\n  axisType?: ColumnAxisType;\n  allowUnitSelection?: boolean;\n}\n\nexport interface ColumnDataProviderProps<T extends BaseUnit>\n  extends MacrostratColumnDataContext<T>, ColumnStateProviderProps<T> {\n  children: ReactNode;\n  ref: RefObject<ColumnRef>;\n}\n\nconst MacrostratColumnDataContext =\n  createContext<MacrostratColumnDataContext<any>>(null);\n\nexport function MacrostratColumnDataProvider<T extends BaseUnit>({\n  children,\n  units,\n  sections,\n  totalHeight,\n  axisType,\n  allowUnitSelection,\n  onUnitSelected,\n  selectedUnit,\n  ref,\n}: ColumnDataProviderProps<T>) {\n  /** Internal provider for Macrostrat column data.\n   * As a general rule, we want to provide data and column-axis\n   * height calculations through the context, since these need to\n   * be accessed by any component that lays out information on the\n   * column.\n   *\n   * Cross-axis layout and view configuration (e.g., showing and hiding\n   * of different components or labels) should be handled through passing\n   * props to the components themselves.\n   * */\n\n  const value = useMemo(() => {\n    // For now, change ordinal axis types to age axis types\n    return {\n      units,\n      sections,\n      totalHeight,\n      axisType,\n    };\n  }, [units, sections, totalHeight, axisType]);\n\n  return h(\n    MacrostratColumnStateProvider,\n    {\n      units,\n      allowUnitSelection,\n      onUnitSelected,\n      selectedUnit,\n      ref,\n    },\n    [\n      h(ColumnRefManager, { ref }),\n      h(MacrostratColumnDataContext.Provider, { value }, children),\n    ],\n  );\n}\n\nfunction ColumnRefManager({ ref }: { ref?: RefObject<ColumnRef> }) {\n  const selectedUnitElement = scope.useAtomValue(selectedUnitElementAtom);\n  useEffect(() => {\n    if (ref == null) return;\n    ref.current = {\n      scrollSelectedUnitIntoView(opts?: ScrollIntoViewOptions) {\n        selectedUnitElement?.scrollIntoView(\n          opts ?? {\n            behavior: \"smooth\",\n            block: \"center\",\n            inline: \"nearest\",\n          },\n        );\n      },\n    };\n  }, [ref, selectedUnitElement]);\n\n  return null;\n}\n\nexport function UnitSelectionProvider(props: ColumnStateProviderProps<any>) {\n  /* A basic unit selection provider without column data context.\n  Mostly for use with the CorrelationChart component.\n   */\n  return h(MacrostratColumnStateProvider, {\n    ...props,\n    allowUnitSelection: true,\n  });\n}\n\nexport function useMacrostratColumnData() {\n  const ctx = useContext(MacrostratColumnDataContext);\n  if (!ctx) {\n    throw new Error(\n      \"useMacrostratColumnData must be used within a MacrostratColumnDataProvider\",\n    );\n  }\n  return ctx;\n}\n\nexport function useMacrostratUnits() {\n  return scope.useAtomValue(columnUnitsAtom);\n}\n\nexport function useColumnUnitsMap(): Map<number, ExtUnit> | null {\n  try {\n    return scope.useAtomValue(columnUnitsMapAtom) as Map<number, ExtUnit>;\n  } catch {\n    return null;\n  }\n}\n\nexport function useCompositeScale(): CompositeColumnScale {\n  const ctx = useMacrostratColumnData();\n  return useMemo(\n    () => createCompositeScale(ctx.sections, true),\n    [ctx.sections],\n  );\n}\n\nexport function MacrostratColumnProvider(props) {\n  /** A column provider specialized the Macrostrat API. Maps more\n   * generic concepts to Macrostrat-specific ones.\n   */\n\n  const { axisType } = useMacrostratColumnData();\n  const { units, domain, pixelScale, scale, children } = props;\n  return h(\n    ColumnProvider,\n    {\n      axisType,\n      divisions: units,\n      range: domain,\n      pixelsPerMeter: pixelScale,\n      scale,\n    },\n    children,\n  );\n}\n\n/** This is now a legacy provider */\nexport function LithologiesProvider({ children }) {\n  useEffect(() => {\n    console.warn(\n      \"LithologiesProvider is deprecated. Replace with MacrostratDataProvider\",\n    );\n  }, []);\n  return children;\n}\n"],"names":[],"mappings":"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"}

package/dist/data-provider/unit-selection.cjs

@@ -16,6 +16,7 @@ function useSelectedUnit() {
 }
 const allowUnitSelectionAtom = jotai.atom(true);
 const selectedUnitIDAtom = jotai.atom();
+const selectedUnitElementAtom = jotai.atom();
 const overlayPositionAtom = jotai.atom();
 const columnRefAtom = jotai.atom({ current: null });
 function useColumnRef() {
@@ -64,6 +65,7 @@ const selectedUnitAtom = jotai.atom(
         height: targetRect.height
       };
     }
+    set(selectedUnitElementAtom, target);
     set(selectedUnitIDAtom, unitID);
     set(overlayPositionAtom, overlayPosition);
     return unit;
@@ -85,6 +87,7 @@ function useUnitSelectionTarget(unit) {
   const ref = React.useRef(null);
   const [selectedUnit, selectUnit] = useUnitSelection();
   const selected = selectedUnit?.unit_id == unit.unit_id;
+  const selectedUnitElement = store.scope.useAtomValue(selectedUnitElementAtom);
   const onClick = React.useCallback(
     (evt) => {
       selectUnit?.(unit, ref.current);
@@ -93,14 +96,16 @@ function useUnitSelectionTarget(unit) {
     [unit, selectUnit]
   );
   React.useEffect(() => {
-    if (!selected || selectUnit == null) return;
-    selectUnit(unit, ref.current);
-    ref.current?.scrollIntoView({
+    if (!selected) return;
+    selectUnit?.(unit, ref.current);
+  }, [ref.current, selected, selectUnit]);
+  React.useEffect(() => {
+    selectedUnitElement?.scrollIntoView({
       behavior: "smooth",
       block: "center",
       inline: "nearest"
     });
-  }, [selected, selectUnit]);
+  }, [selectedUnitElement]);
   return [ref, selected, onClick];
 }
 function UnitKeyboardNavigation({
@@ -219,6 +224,7 @@ function getMostOverlappingUnit(targetUnit, candidateUnits) {
 exports.UnitKeyboardNavigation = UnitKeyboardNavigation;
 exports.UnitSelectionCallbackManager = UnitSelectionCallbackManager;
 exports.allowUnitSelectionAtom = allowUnitSelectionAtom;
+exports.selectedUnitElementAtom = selectedUnitElementAtom;
 exports.selectedUnitIDAtom = selectedUnitIDAtom;
 exports.useAtomOverlayPosition = useAtomOverlayPosition;
 exports.useColumnRef = useColumnRef;

package/dist/data-provider/unit-selection.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"unit-selection.cjs","sources":["../../src/data-provider/unit-selection.ts"],"sourcesContent":["import type { BaseUnit, UnitLong } from \"@macrostrat/api-types\";\nimport { useKeyHandler } from \"@macrostrat/ui-components\";\nimport { useEffect, useRef, useCallback, useMemo } from \"react\";\nimport type { RectBounds, IUnit } from \"../units/types\";\nimport { atom } from \"jotai\";\nimport { scope, columnUnitsMapAtom } from \"./store\";\nimport {\n  AgeRangeQuantifiedDifference,\n  ageRangeQuantifiedDifference,\n  AgeRangeRelationship,\n} from \"@macrostrat/stratigraphy-utils\";\nimport type { ColumnData } from \"@macrostrat/data-provider\";\n\ntype UnitSelectDispatch = (\n  unit: number | BaseUnit | null,\n  target: HTMLElement | null,\n) => void;\n\nexport function useUnitSelection() {\n  return scope.use(selectedUnitAtom);\n}\n\nexport function useUnitSelectionDispatch(): UnitSelectDispatch {\n  return scope.useSetAtom(selectedUnitAtom);\n}\n\nexport function useSelectedUnit() {\n  return scope.useAtomValue(selectedUnitAtom);\n}\n\nexport interface ColumnClickData {\n  unitID: number | null;\n  unit: BaseUnit | null;\n  target: HTMLElement | null;\n  height: number;\n  // Room for boundary IDs eventually\n}\n\nexport interface UnitSelectionCallbacks {\n  // It's sort of unfortunate that we need to pass in the column ref here\n  onClickedColumn?: (columnClickData: ColumnClickData, event: Event) => void;\n  onUnitSelected?: <T extends BaseUnit>(\n    unitID: number | null,\n    unit: T | null,\n  ) => void;\n}\n\nexport const allowUnitSelectionAtom = atom<boolean>(true);\n\nexport const selectedUnitIDAtom = atom<number | null>();\n\nconst overlayPositionAtom = atom<RectBounds | null>();\n\nconst columnRefAtom = atom<{ current: HTMLElement | null }>({ current: null });\n\nexport function useColumnRef() {\n  return scope.useAtomValue(columnRefAtom);\n}\n\nconst selectedUnitAtom = atom(\n  (get) => {\n    if (!get(allowUnitSelectionAtom)) return null;\n\n    const unitID = get(selectedUnitIDAtom);\n    if (unitID == null) return null;\n    const unitsMap = get(columnUnitsMapAtom);\n    return unitsMap?.get(unitID) || null;\n  },\n  (\n    get,\n    set,\n    selectedUnit: number | BaseUnit | null,\n    target: HTMLElement | null = null,\n  ): BaseUnit | null => {\n    if (!get(allowUnitSelectionAtom)) {\n      console.error(\"Unit selection is disabled.\");\n      return null;\n    }\n\n    let unitID: number | null = null;\n    let unit: BaseUnit | null = null;\n    if (selectedUnit == null) {\n      unitID = null;\n    } else if (typeof selectedUnit === \"number\") {\n      unitID = selectedUnit;\n    } else if (\"unit_id\" in selectedUnit) {\n      unitID = selectedUnit.unit_id;\n    }\n\n    if (unitID != null) {\n      const unitsMap = get(columnUnitsMapAtom);\n      // Verify that the unit exists in the current colum, else throw\n      if (!unitsMap?.has(unitID)) {\n        throw new Error(\n          `Unit with ID ${unitID} not found in current column units.`,\n        );\n      }\n      unit = unitsMap.get(unitID) ?? null;\n    }\n\n    let overlayPosition: RectBounds | null = null;\n\n    const columnEl = get(columnRefAtom)?.current;\n\n    if (unit != null && columnEl != null && target != null) {\n      const rect = columnEl.getBoundingClientRect();\n      const targetRect = target.getBoundingClientRect();\n      overlayPosition = {\n        x: targetRect.left - rect.left,\n        y: targetRect.top - rect.top,\n        width: targetRect.width,\n        height: targetRect.height,\n      };\n    }\n\n    set(selectedUnitIDAtom, unitID);\n    set(overlayPositionAtom, overlayPosition);\n\n    return unit;\n  },\n);\n\nexport function useAtomOverlayPosition() {\n  return scope.useAtomValue(overlayPositionAtom);\n}\n\nexport function UnitSelectionCallbackManager({\n  onUnitSelected,\n}: UnitSelectionCallbacks) {\n  const selectedUnit = scope.useAtomValue(selectedUnitAtom);\n  useEffect(() => {\n    onUnitSelected?.(selectedUnit?.unit_id ?? null, selectedUnit ?? null);\n  }, [selectedUnit?.unit_id]);\n  return null;\n}\n\n/** TODO: figure out if onClickedColumn is still needed\n /** This is not the natural place to get positions within the column,\n * but it will work for now.\nif (props.onClickedColumn) {\n  // Infer height from top and bottom height of unit (because that's passed back with the call)\n  //const py = event.y;\n  //const [bottom, top] = getUnitHeightRange(unit, axisType);\n  //const height = Math.abs(bottom - top);\n\n  const columnClickData: ColumnClickData = {\n    unitID: unit?.unit_id,\n    unit,\n    target,\n    height: el?.getBoundingClientRect().height || 0,\n  };\n  props.onClickedColumn(columnClickData, event);\n}*/\n\nexport function useUnitSelectionTarget(\n  unit: IUnit,\n): [React.RefObject<HTMLElement>, boolean, (evt: Event) => void] {\n  const ref = useRef<HTMLElement>(null);\n  const [selectedUnit, selectUnit] = useUnitSelection();\n  const selected = selectedUnit?.unit_id == unit.unit_id;\n\n  const onClick = useCallback(\n    (evt: Event) => {\n      selectUnit?.(unit, ref.current);\n      evt.stopPropagation();\n    },\n    [unit, selectUnit],\n  );\n\n  useEffect(() => {\n    if (!selected || selectUnit == null) return;\n    // In case we haven't set the position of the unit (if we don't have a target), set the selected unit\n    selectUnit(unit, ref.current);\n\n    // Scroll the unit into view\n    ref.current?.scrollIntoView({\n      behavior: \"smooth\",\n      block: \"center\",\n      inline: \"nearest\",\n    });\n  }, [selected, selectUnit]);\n\n  return [ref, selected, onClick];\n}\n\nexport function UnitKeyboardNavigation({\n  columnData,\n  units,\n  allowHorizontalNavigation,\n}: {\n  columnData?: ColumnData[];\n  units?: UnitLong[];\n  allowHorizontalNavigation?: boolean;\n}) {\n  if (units == null && columnData == null) {\n    throw new Error(\"Either units or columnData must be provided.\");\n  }\n\n  let _columnData: ColumnData[] = useMemo(() => {\n    if (columnData != null) return columnData;\n    // Build column data from units\n    const colMap = new Map<number, UnitLong[]>();\n    for (const unit of units!) {\n      if (!colMap.has(unit.col_id)) {\n        colMap.set(unit.col_id, []);\n      }\n      colMap.get(unit.col_id)!.push(unit);\n    }\n    const cols: ColumnData[] = [];\n    for (const [colID, units] of colMap) {\n      cols.push({ columnID: colID, units });\n    }\n    // Sort columns by columnID\n    cols.sort((a, b) => a.columnID - b.columnID);\n    return cols;\n  }, [columnData, units]);\n\n  // Default to allowing horizontal navigation only if columnData is provided\n  const _allowHorizontalNavigation =\n    allowHorizontalNavigation ?? columnData != null;\n\n  const selectedUnit = useSelectedUnit() as UnitLong | null;\n  const selectUnit = useUnitSelectionDispatch();\n\n  const keyMap: Record<number, Direction> = {\n    38: \"up\",\n    40: \"down\",\n  };\n  if (_allowHorizontalNavigation) {\n    keyMap[37] = \"left\";\n    keyMap[39] = \"right\";\n  }\n\n  useKeyHandler(\n    (event) => {\n      const direction = keyMap[event.keyCode];\n      if (direction == null) return;\n      const nextUnit = getBestUnit(_columnData, selectedUnit, direction);\n      if (nextUnit == null) return;\n      selectUnit(nextUnit, null);\n      event.stopPropagation();\n    },\n    [_columnData, selectedUnit],\n  );\n  return null;\n}\n\ntype Direction = \"up\" | \"down\" | \"left\" | \"right\";\n\nfunction getBestUnit(\n  columnData: ColumnData[],\n  targetUnit: UnitLong,\n  direction: Direction,\n): UnitLong | null {\n  const thisColIndex = columnData.findIndex(\n    (col) => col.columnID === targetUnit.col_id,\n  );\n  if (thisColIndex === -1) return null;\n\n  // If up or down, stay in the same column\n  if (direction === \"up\" || direction === \"down\") {\n    const units = columnData[thisColIndex].units;\n    const ix = units.findIndex((unit) => unit.unit_id === targetUnit.unit_id);\n    if (ix === -1) return null;\n    if (direction === \"up\") {\n      return units[ix - 1] || null;\n    } else {\n      return units[ix + 1] || null;\n    }\n  }\n\n  // If left or right, move to adjacent column\n  let adjacentColIndex: number;\n  if (direction === \"left\") {\n    adjacentColIndex =\n      (thisColIndex - 1 + columnData.length) % columnData.length;\n  } else {\n    adjacentColIndex = (thisColIndex + 1) % columnData.length;\n  }\n\n  const adjacentColUnits = columnData[adjacentColIndex].units;\n  return getMostOverlappingUnit(targetUnit, adjacentColUnits);\n}\n\ntype UnitAgeRangeRelationship = AgeRangeQuantifiedDifference & {\n  unit: UnitLong;\n};\n\nfunction getMostOverlappingUnit(\n  targetUnit: UnitLong,\n  candidateUnits: UnitLong[],\n): UnitLong | null {\n  const targetAgeRange = [targetUnit.b_age, targetUnit.t_age];\n\n  const overlaps: UnitAgeRangeRelationship[] = [];\n  for (const candidate of candidateUnits) {\n    const candidateAgeRange = [candidate.b_age, candidate.t_age];\n\n    const rel = ageRangeQuantifiedDifference(targetAgeRange, candidateAgeRange);\n    if (rel.type === AgeRangeRelationship.Identical) {\n      return candidate;\n    }\n    overlaps.push({ ...rel, unit: candidate });\n  }\n\n  let bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Containing,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Contained,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.PartialOverlap,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Disjoint,\n  );\n  bestOverlaps.sort((a, b) => a.distance - b.distance);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n  return null;\n}\n"],"names":["scope","atom","columnUnitsMapAtom","useEffect","useRef","useCallback","useMemo","units","useKeyHandler","ageRangeQuantifiedDifference","AgeRangeRelationship"],"mappings":"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"}
+{"version":3,"file":"unit-selection.cjs","sources":["../../src/data-provider/unit-selection.ts"],"sourcesContent":["import type { BaseUnit, UnitLong } from \"@macrostrat/api-types\";\nimport { useKeyHandler } from \"@macrostrat/ui-components\";\nimport { useEffect, useRef, useCallback, useMemo } from \"react\";\nimport type { RectBounds, IUnit } from \"../units/types\";\nimport { atom } from \"jotai\";\nimport { scope, columnUnitsMapAtom } from \"./store\";\nimport {\n  AgeRangeQuantifiedDifference,\n  ageRangeQuantifiedDifference,\n  AgeRangeRelationship,\n} from \"@macrostrat/stratigraphy-utils\";\nimport type { ColumnData } from \"@macrostrat/data-provider\";\n\ntype UnitSelectDispatch = (\n  unit: number | BaseUnit | null,\n  target: HTMLElement | null,\n) => void;\n\nexport function useUnitSelection() {\n  return scope.use(selectedUnitAtom);\n}\n\nexport function useUnitSelectionDispatch(): UnitSelectDispatch {\n  return scope.useSetAtom(selectedUnitAtom);\n}\n\nexport function useSelectedUnit() {\n  return scope.useAtomValue(selectedUnitAtom);\n}\n\nexport interface ColumnClickData {\n  unitID: number | null;\n  unit: BaseUnit | null;\n  target: HTMLElement | null;\n  height: number;\n  // Room for boundary IDs eventually\n}\n\nexport interface UnitSelectionCallbacks {\n  // It's sort of unfortunate that we need to pass in the column ref here\n  onClickedColumn?: (columnClickData: ColumnClickData, event: Event) => void;\n  onUnitSelected?: <T extends BaseUnit>(\n    unitID: number | null,\n    unit: T | null,\n  ) => void;\n}\n\nexport const allowUnitSelectionAtom = atom<boolean>(true);\n\nexport const selectedUnitIDAtom = atom<number | null>();\nexport const selectedUnitElementAtom = atom<HTMLElement | null>();\n\nconst overlayPositionAtom = atom<RectBounds | null>();\n\nconst columnRefAtom = atom<{ current: HTMLElement | null }>({ current: null });\n\nexport function useColumnRef() {\n  return scope.useAtomValue(columnRefAtom);\n}\n\nconst selectedUnitAtom = atom(\n  (get) => {\n    if (!get(allowUnitSelectionAtom)) return null;\n\n    const unitID = get(selectedUnitIDAtom);\n    if (unitID == null) return null;\n    const unitsMap = get(columnUnitsMapAtom);\n    return unitsMap?.get(unitID) || null;\n  },\n  (\n    get,\n    set,\n    selectedUnit: number | BaseUnit | null,\n    target: HTMLElement | null = null,\n  ): BaseUnit | null => {\n    if (!get(allowUnitSelectionAtom)) {\n      console.error(\"Unit selection is disabled.\");\n      return null;\n    }\n\n    let unitID: number | null = null;\n    let unit: BaseUnit | null = null;\n    if (selectedUnit == null) {\n      unitID = null;\n    } else if (typeof selectedUnit === \"number\") {\n      unitID = selectedUnit;\n    } else if (\"unit_id\" in selectedUnit) {\n      unitID = selectedUnit.unit_id;\n    }\n\n    if (unitID != null) {\n      const unitsMap = get(columnUnitsMapAtom);\n      // Verify that the unit exists in the current colum, else throw\n      if (!unitsMap?.has(unitID)) {\n        throw new Error(\n          `Unit with ID ${unitID} not found in current column units.`,\n        );\n      }\n      unit = unitsMap.get(unitID) ?? null;\n    }\n\n    let overlayPosition: RectBounds | null = null;\n\n    const columnEl = get(columnRefAtom)?.current;\n\n    if (unit != null && columnEl != null && target != null) {\n      const rect = columnEl.getBoundingClientRect();\n      const targetRect = target.getBoundingClientRect();\n      overlayPosition = {\n        x: targetRect.left - rect.left,\n        y: targetRect.top - rect.top,\n        width: targetRect.width,\n        height: targetRect.height,\n      };\n    }\n\n    set(selectedUnitElementAtom, target);\n    set(selectedUnitIDAtom, unitID);\n    set(overlayPositionAtom, overlayPosition);\n\n    return unit;\n  },\n);\n\nexport function useAtomOverlayPosition() {\n  return scope.useAtomValue(overlayPositionAtom);\n}\n\nexport function UnitSelectionCallbackManager({\n  onUnitSelected,\n}: UnitSelectionCallbacks) {\n  const selectedUnit = scope.useAtomValue(selectedUnitAtom);\n  useEffect(() => {\n    onUnitSelected?.(selectedUnit?.unit_id ?? null, selectedUnit ?? null);\n  }, [selectedUnit?.unit_id]);\n  return null;\n}\n\n/** TODO: figure out if onClickedColumn is still needed\n /** This is not the natural place to get positions within the column,\n * but it will work for now.\nif (props.onClickedColumn) {\n  // Infer height from top and bottom height of unit (because that's passed back with the call)\n  //const py = event.y;\n  //const [bottom, top] = getUnitHeightRange(unit, axisType);\n  //const height = Math.abs(bottom - top);\n\n  const columnClickData: ColumnClickData = {\n    unitID: unit?.unit_id,\n    unit,\n    target,\n    height: el?.getBoundingClientRect().height || 0,\n  };\n  props.onClickedColumn(columnClickData, event);\n}*/\n\nexport function useUnitSelectionTarget(\n  unit: IUnit,\n): [React.RefObject<HTMLElement>, boolean, (evt: Event) => void] {\n  const ref = useRef<HTMLElement>(null);\n  const [selectedUnit, selectUnit] = useUnitSelection();\n  const selected = selectedUnit?.unit_id == unit.unit_id;\n  const selectedUnitElement = scope.useAtomValue(selectedUnitElementAtom);\n\n  const onClick = useCallback(\n    (evt: Event) => {\n      selectUnit?.(unit, ref.current);\n      evt.stopPropagation();\n    },\n    [unit, selectUnit],\n  );\n\n  useEffect(() => {\n    // Sync selection with unit element...\n    if (!selected) return;\n    selectUnit?.(unit, ref.current);\n  }, [ref.current, selected, selectUnit]);\n\n  useEffect(() => {\n    // Scroll the unit into view\n    selectedUnitElement?.scrollIntoView({\n      behavior: \"smooth\",\n      block: \"center\",\n      inline: \"nearest\",\n    });\n  }, [selectedUnitElement]);\n\n  return [ref, selected, onClick];\n}\n\nexport function UnitKeyboardNavigation({\n  columnData,\n  units,\n  allowHorizontalNavigation,\n}: {\n  columnData?: ColumnData[];\n  units?: UnitLong[];\n  allowHorizontalNavigation?: boolean;\n}) {\n  if (units == null && columnData == null) {\n    throw new Error(\"Either units or columnData must be provided.\");\n  }\n\n  let _columnData: ColumnData[] = useMemo(() => {\n    if (columnData != null) return columnData;\n    // Build column data from units\n    const colMap = new Map<number, UnitLong[]>();\n    for (const unit of units!) {\n      if (!colMap.has(unit.col_id)) {\n        colMap.set(unit.col_id, []);\n      }\n      colMap.get(unit.col_id)!.push(unit);\n    }\n    const cols: ColumnData[] = [];\n    for (const [colID, units] of colMap) {\n      cols.push({ columnID: colID, units });\n    }\n    // Sort columns by columnID\n    cols.sort((a, b) => a.columnID - b.columnID);\n    return cols;\n  }, [columnData, units]);\n\n  // Default to allowing horizontal navigation only if columnData is provided\n  const _allowHorizontalNavigation =\n    allowHorizontalNavigation ?? columnData != null;\n\n  const selectedUnit = useSelectedUnit() as UnitLong | null;\n  const selectUnit = useUnitSelectionDispatch();\n\n  const keyMap: Record<number, Direction> = {\n    38: \"up\",\n    40: \"down\",\n  };\n  if (_allowHorizontalNavigation) {\n    keyMap[37] = \"left\";\n    keyMap[39] = \"right\";\n  }\n\n  useKeyHandler(\n    (event) => {\n      const direction = keyMap[event.keyCode];\n      if (direction == null) return;\n      const nextUnit = getBestUnit(_columnData, selectedUnit, direction);\n      if (nextUnit == null) return;\n      selectUnit(nextUnit, null);\n      event.stopPropagation();\n    },\n    [_columnData, selectedUnit],\n  );\n  return null;\n}\n\ntype Direction = \"up\" | \"down\" | \"left\" | \"right\";\n\nfunction getBestUnit(\n  columnData: ColumnData[],\n  targetUnit: UnitLong,\n  direction: Direction,\n): UnitLong | null {\n  const thisColIndex = columnData.findIndex(\n    (col) => col.columnID === targetUnit.col_id,\n  );\n  if (thisColIndex === -1) return null;\n\n  // If up or down, stay in the same column\n  if (direction === \"up\" || direction === \"down\") {\n    const units = columnData[thisColIndex].units;\n    const ix = units.findIndex((unit) => unit.unit_id === targetUnit.unit_id);\n    if (ix === -1) return null;\n    if (direction === \"up\") {\n      return units[ix - 1] || null;\n    } else {\n      return units[ix + 1] || null;\n    }\n  }\n\n  // If left or right, move to adjacent column\n  let adjacentColIndex: number;\n  if (direction === \"left\") {\n    adjacentColIndex =\n      (thisColIndex - 1 + columnData.length) % columnData.length;\n  } else {\n    adjacentColIndex = (thisColIndex + 1) % columnData.length;\n  }\n\n  const adjacentColUnits = columnData[adjacentColIndex].units;\n  return getMostOverlappingUnit(targetUnit, adjacentColUnits);\n}\n\ntype UnitAgeRangeRelationship = AgeRangeQuantifiedDifference & {\n  unit: UnitLong;\n};\n\nfunction getMostOverlappingUnit(\n  targetUnit: UnitLong,\n  candidateUnits: UnitLong[],\n): UnitLong | null {\n  const targetAgeRange = [targetUnit.b_age, targetUnit.t_age];\n\n  const overlaps: UnitAgeRangeRelationship[] = [];\n  for (const candidate of candidateUnits) {\n    const candidateAgeRange = [candidate.b_age, candidate.t_age];\n\n    const rel = ageRangeQuantifiedDifference(targetAgeRange, candidateAgeRange);\n    if (rel.type === AgeRangeRelationship.Identical) {\n      return candidate;\n    }\n    overlaps.push({ ...rel, unit: candidate });\n  }\n\n  let bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Containing,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Contained,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.PartialOverlap,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Disjoint,\n  );\n  bestOverlaps.sort((a, b) => a.distance - b.distance);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n  return null;\n}\n"],"names":["scope","atom","columnUnitsMapAtom","useEffect","useRef","useCallback","useMemo","units","useKeyHandler","ageRangeQuantifiedDifference","AgeRangeRelationship"],"mappings":"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"}

package/dist/data-provider/unit-selection.d.ts

@@ -21,6 +21,9 @@ export declare const allowUnitSelectionAtom: import('jotai').PrimitiveAtom<boole
 export declare const selectedUnitIDAtom: import('jotai').PrimitiveAtom<number | null | undefined> & {
     init: number | null | undefined;
 };
+export declare const selectedUnitElementAtom: import('jotai').PrimitiveAtom<HTMLElement | null | undefined> & {
+    init: HTMLElement | null | undefined;
+};
 export declare function useColumnRef(): any;
 export declare function useAtomOverlayPosition(): any;
 export declare function UnitSelectionCallbackManager({ onUnitSelected, }: UnitSelectionCallbacks): null;

package/dist/data-provider/unit-selection.js

@@ -14,6 +14,7 @@ function useSelectedUnit() {
 }
 const allowUnitSelectionAtom = atom(true);
 const selectedUnitIDAtom = atom();
+const selectedUnitElementAtom = atom();
 const overlayPositionAtom = atom();
 const columnRefAtom = atom({ current: null });
 function useColumnRef() {
@@ -62,6 +63,7 @@ const selectedUnitAtom = atom(
         height: targetRect.height
       };
     }
+    set(selectedUnitElementAtom, target);
     set(selectedUnitIDAtom, unitID);
     set(overlayPositionAtom, overlayPosition);
     return unit;
@@ -83,6 +85,7 @@ function useUnitSelectionTarget(unit) {
   const ref = useRef(null);
   const [selectedUnit, selectUnit] = useUnitSelection();
   const selected = selectedUnit?.unit_id == unit.unit_id;
+  const selectedUnitElement = scope.useAtomValue(selectedUnitElementAtom);
   const onClick = useCallback(
     (evt) => {
       selectUnit?.(unit, ref.current);
@@ -91,14 +94,16 @@ function useUnitSelectionTarget(unit) {
     [unit, selectUnit]
   );
   useEffect(() => {
-    if (!selected || selectUnit == null) return;
-    selectUnit(unit, ref.current);
-    ref.current?.scrollIntoView({
+    if (!selected) return;
+    selectUnit?.(unit, ref.current);
+  }, [ref.current, selected, selectUnit]);
+  useEffect(() => {
+    selectedUnitElement?.scrollIntoView({
       behavior: "smooth",
       block: "center",
       inline: "nearest"
     });
-  }, [selected, selectUnit]);
+  }, [selectedUnitElement]);
   return [ref, selected, onClick];
 }
 function UnitKeyboardNavigation({
@@ -218,6 +223,7 @@ export {
   UnitKeyboardNavigation,
   UnitSelectionCallbackManager,
   allowUnitSelectionAtom,
+  selectedUnitElementAtom,
   selectedUnitIDAtom,
   useAtomOverlayPosition,
   useColumnRef,

package/dist/data-provider/unit-selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"unit-selection.js","sources":["../../src/data-provider/unit-selection.ts"],"sourcesContent":["import type { BaseUnit, UnitLong } from \"@macrostrat/api-types\";\nimport { useKeyHandler } from \"@macrostrat/ui-components\";\nimport { useEffect, useRef, useCallback, useMemo } from \"react\";\nimport type { RectBounds, IUnit } from \"../units/types\";\nimport { atom } from \"jotai\";\nimport { scope, columnUnitsMapAtom } from \"./store\";\nimport {\n  AgeRangeQuantifiedDifference,\n  ageRangeQuantifiedDifference,\n  AgeRangeRelationship,\n} from \"@macrostrat/stratigraphy-utils\";\nimport type { ColumnData } from \"@macrostrat/data-provider\";\n\ntype UnitSelectDispatch = (\n  unit: number | BaseUnit | null,\n  target: HTMLElement | null,\n) => void;\n\nexport function useUnitSelection() {\n  return scope.use(selectedUnitAtom);\n}\n\nexport function useUnitSelectionDispatch(): UnitSelectDispatch {\n  return scope.useSetAtom(selectedUnitAtom);\n}\n\nexport function useSelectedUnit() {\n  return scope.useAtomValue(selectedUnitAtom);\n}\n\nexport interface ColumnClickData {\n  unitID: number | null;\n  unit: BaseUnit | null;\n  target: HTMLElement | null;\n  height: number;\n  // Room for boundary IDs eventually\n}\n\nexport interface UnitSelectionCallbacks {\n  // It's sort of unfortunate that we need to pass in the column ref here\n  onClickedColumn?: (columnClickData: ColumnClickData, event: Event) => void;\n  onUnitSelected?: <T extends BaseUnit>(\n    unitID: number | null,\n    unit: T | null,\n  ) => void;\n}\n\nexport const allowUnitSelectionAtom = atom<boolean>(true);\n\nexport const selectedUnitIDAtom = atom<number | null>();\n\nconst overlayPositionAtom = atom<RectBounds | null>();\n\nconst columnRefAtom = atom<{ current: HTMLElement | null }>({ current: null });\n\nexport function useColumnRef() {\n  return scope.useAtomValue(columnRefAtom);\n}\n\nconst selectedUnitAtom = atom(\n  (get) => {\n    if (!get(allowUnitSelectionAtom)) return null;\n\n    const unitID = get(selectedUnitIDAtom);\n    if (unitID == null) return null;\n    const unitsMap = get(columnUnitsMapAtom);\n    return unitsMap?.get(unitID) || null;\n  },\n  (\n    get,\n    set,\n    selectedUnit: number | BaseUnit | null,\n    target: HTMLElement | null = null,\n  ): BaseUnit | null => {\n    if (!get(allowUnitSelectionAtom)) {\n      console.error(\"Unit selection is disabled.\");\n      return null;\n    }\n\n    let unitID: number | null = null;\n    let unit: BaseUnit | null = null;\n    if (selectedUnit == null) {\n      unitID = null;\n    } else if (typeof selectedUnit === \"number\") {\n      unitID = selectedUnit;\n    } else if (\"unit_id\" in selectedUnit) {\n      unitID = selectedUnit.unit_id;\n    }\n\n    if (unitID != null) {\n      const unitsMap = get(columnUnitsMapAtom);\n      // Verify that the unit exists in the current colum, else throw\n      if (!unitsMap?.has(unitID)) {\n        throw new Error(\n          `Unit with ID ${unitID} not found in current column units.`,\n        );\n      }\n      unit = unitsMap.get(unitID) ?? null;\n    }\n\n    let overlayPosition: RectBounds | null = null;\n\n    const columnEl = get(columnRefAtom)?.current;\n\n    if (unit != null && columnEl != null && target != null) {\n      const rect = columnEl.getBoundingClientRect();\n      const targetRect = target.getBoundingClientRect();\n      overlayPosition = {\n        x: targetRect.left - rect.left,\n        y: targetRect.top - rect.top,\n        width: targetRect.width,\n        height: targetRect.height,\n      };\n    }\n\n    set(selectedUnitIDAtom, unitID);\n    set(overlayPositionAtom, overlayPosition);\n\n    return unit;\n  },\n);\n\nexport function useAtomOverlayPosition() {\n  return scope.useAtomValue(overlayPositionAtom);\n}\n\nexport function UnitSelectionCallbackManager({\n  onUnitSelected,\n}: UnitSelectionCallbacks) {\n  const selectedUnit = scope.useAtomValue(selectedUnitAtom);\n  useEffect(() => {\n    onUnitSelected?.(selectedUnit?.unit_id ?? null, selectedUnit ?? null);\n  }, [selectedUnit?.unit_id]);\n  return null;\n}\n\n/** TODO: figure out if onClickedColumn is still needed\n /** This is not the natural place to get positions within the column,\n * but it will work for now.\nif (props.onClickedColumn) {\n  // Infer height from top and bottom height of unit (because that's passed back with the call)\n  //const py = event.y;\n  //const [bottom, top] = getUnitHeightRange(unit, axisType);\n  //const height = Math.abs(bottom - top);\n\n  const columnClickData: ColumnClickData = {\n    unitID: unit?.unit_id,\n    unit,\n    target,\n    height: el?.getBoundingClientRect().height || 0,\n  };\n  props.onClickedColumn(columnClickData, event);\n}*/\n\nexport function useUnitSelectionTarget(\n  unit: IUnit,\n): [React.RefObject<HTMLElement>, boolean, (evt: Event) => void] {\n  const ref = useRef<HTMLElement>(null);\n  const [selectedUnit, selectUnit] = useUnitSelection();\n  const selected = selectedUnit?.unit_id == unit.unit_id;\n\n  const onClick = useCallback(\n    (evt: Event) => {\n      selectUnit?.(unit, ref.current);\n      evt.stopPropagation();\n    },\n    [unit, selectUnit],\n  );\n\n  useEffect(() => {\n    if (!selected || selectUnit == null) return;\n    // In case we haven't set the position of the unit (if we don't have a target), set the selected unit\n    selectUnit(unit, ref.current);\n\n    // Scroll the unit into view\n    ref.current?.scrollIntoView({\n      behavior: \"smooth\",\n      block: \"center\",\n      inline: \"nearest\",\n    });\n  }, [selected, selectUnit]);\n\n  return [ref, selected, onClick];\n}\n\nexport function UnitKeyboardNavigation({\n  columnData,\n  units,\n  allowHorizontalNavigation,\n}: {\n  columnData?: ColumnData[];\n  units?: UnitLong[];\n  allowHorizontalNavigation?: boolean;\n}) {\n  if (units == null && columnData == null) {\n    throw new Error(\"Either units or columnData must be provided.\");\n  }\n\n  let _columnData: ColumnData[] = useMemo(() => {\n    if (columnData != null) return columnData;\n    // Build column data from units\n    const colMap = new Map<number, UnitLong[]>();\n    for (const unit of units!) {\n      if (!colMap.has(unit.col_id)) {\n        colMap.set(unit.col_id, []);\n      }\n      colMap.get(unit.col_id)!.push(unit);\n    }\n    const cols: ColumnData[] = [];\n    for (const [colID, units] of colMap) {\n      cols.push({ columnID: colID, units });\n    }\n    // Sort columns by columnID\n    cols.sort((a, b) => a.columnID - b.columnID);\n    return cols;\n  }, [columnData, units]);\n\n  // Default to allowing horizontal navigation only if columnData is provided\n  const _allowHorizontalNavigation =\n    allowHorizontalNavigation ?? columnData != null;\n\n  const selectedUnit = useSelectedUnit() as UnitLong | null;\n  const selectUnit = useUnitSelectionDispatch();\n\n  const keyMap: Record<number, Direction> = {\n    38: \"up\",\n    40: \"down\",\n  };\n  if (_allowHorizontalNavigation) {\n    keyMap[37] = \"left\";\n    keyMap[39] = \"right\";\n  }\n\n  useKeyHandler(\n    (event) => {\n      const direction = keyMap[event.keyCode];\n      if (direction == null) return;\n      const nextUnit = getBestUnit(_columnData, selectedUnit, direction);\n      if (nextUnit == null) return;\n      selectUnit(nextUnit, null);\n      event.stopPropagation();\n    },\n    [_columnData, selectedUnit],\n  );\n  return null;\n}\n\ntype Direction = \"up\" | \"down\" | \"left\" | \"right\";\n\nfunction getBestUnit(\n  columnData: ColumnData[],\n  targetUnit: UnitLong,\n  direction: Direction,\n): UnitLong | null {\n  const thisColIndex = columnData.findIndex(\n    (col) => col.columnID === targetUnit.col_id,\n  );\n  if (thisColIndex === -1) return null;\n\n  // If up or down, stay in the same column\n  if (direction === \"up\" || direction === \"down\") {\n    const units = columnData[thisColIndex].units;\n    const ix = units.findIndex((unit) => unit.unit_id === targetUnit.unit_id);\n    if (ix === -1) return null;\n    if (direction === \"up\") {\n      return units[ix - 1] || null;\n    } else {\n      return units[ix + 1] || null;\n    }\n  }\n\n  // If left or right, move to adjacent column\n  let adjacentColIndex: number;\n  if (direction === \"left\") {\n    adjacentColIndex =\n      (thisColIndex - 1 + columnData.length) % columnData.length;\n  } else {\n    adjacentColIndex = (thisColIndex + 1) % columnData.length;\n  }\n\n  const adjacentColUnits = columnData[adjacentColIndex].units;\n  return getMostOverlappingUnit(targetUnit, adjacentColUnits);\n}\n\ntype UnitAgeRangeRelationship = AgeRangeQuantifiedDifference & {\n  unit: UnitLong;\n};\n\nfunction getMostOverlappingUnit(\n  targetUnit: UnitLong,\n  candidateUnits: UnitLong[],\n): UnitLong | null {\n  const targetAgeRange = [targetUnit.b_age, targetUnit.t_age];\n\n  const overlaps: UnitAgeRangeRelationship[] = [];\n  for (const candidate of candidateUnits) {\n    const candidateAgeRange = [candidate.b_age, candidate.t_age];\n\n    const rel = ageRangeQuantifiedDifference(targetAgeRange, candidateAgeRange);\n    if (rel.type === AgeRangeRelationship.Identical) {\n      return candidate;\n    }\n    overlaps.push({ ...rel, unit: candidate });\n  }\n\n  let bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Containing,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Contained,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.PartialOverlap,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Disjoint,\n  );\n  bestOverlaps.sort((a, b) => a.distance - b.distance);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n  return null;\n}\n"],"names":["units"],"mappings":"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"}
+{"version":3,"file":"unit-selection.js","sources":["../../src/data-provider/unit-selection.ts"],"sourcesContent":["import type { BaseUnit, UnitLong } from \"@macrostrat/api-types\";\nimport { useKeyHandler } from \"@macrostrat/ui-components\";\nimport { useEffect, useRef, useCallback, useMemo } from \"react\";\nimport type { RectBounds, IUnit } from \"../units/types\";\nimport { atom } from \"jotai\";\nimport { scope, columnUnitsMapAtom } from \"./store\";\nimport {\n  AgeRangeQuantifiedDifference,\n  ageRangeQuantifiedDifference,\n  AgeRangeRelationship,\n} from \"@macrostrat/stratigraphy-utils\";\nimport type { ColumnData } from \"@macrostrat/data-provider\";\n\ntype UnitSelectDispatch = (\n  unit: number | BaseUnit | null,\n  target: HTMLElement | null,\n) => void;\n\nexport function useUnitSelection() {\n  return scope.use(selectedUnitAtom);\n}\n\nexport function useUnitSelectionDispatch(): UnitSelectDispatch {\n  return scope.useSetAtom(selectedUnitAtom);\n}\n\nexport function useSelectedUnit() {\n  return scope.useAtomValue(selectedUnitAtom);\n}\n\nexport interface ColumnClickData {\n  unitID: number | null;\n  unit: BaseUnit | null;\n  target: HTMLElement | null;\n  height: number;\n  // Room for boundary IDs eventually\n}\n\nexport interface UnitSelectionCallbacks {\n  // It's sort of unfortunate that we need to pass in the column ref here\n  onClickedColumn?: (columnClickData: ColumnClickData, event: Event) => void;\n  onUnitSelected?: <T extends BaseUnit>(\n    unitID: number | null,\n    unit: T | null,\n  ) => void;\n}\n\nexport const allowUnitSelectionAtom = atom<boolean>(true);\n\nexport const selectedUnitIDAtom = atom<number | null>();\nexport const selectedUnitElementAtom = atom<HTMLElement | null>();\n\nconst overlayPositionAtom = atom<RectBounds | null>();\n\nconst columnRefAtom = atom<{ current: HTMLElement | null }>({ current: null });\n\nexport function useColumnRef() {\n  return scope.useAtomValue(columnRefAtom);\n}\n\nconst selectedUnitAtom = atom(\n  (get) => {\n    if (!get(allowUnitSelectionAtom)) return null;\n\n    const unitID = get(selectedUnitIDAtom);\n    if (unitID == null) return null;\n    const unitsMap = get(columnUnitsMapAtom);\n    return unitsMap?.get(unitID) || null;\n  },\n  (\n    get,\n    set,\n    selectedUnit: number | BaseUnit | null,\n    target: HTMLElement | null = null,\n  ): BaseUnit | null => {\n    if (!get(allowUnitSelectionAtom)) {\n      console.error(\"Unit selection is disabled.\");\n      return null;\n    }\n\n    let unitID: number | null = null;\n    let unit: BaseUnit | null = null;\n    if (selectedUnit == null) {\n      unitID = null;\n    } else if (typeof selectedUnit === \"number\") {\n      unitID = selectedUnit;\n    } else if (\"unit_id\" in selectedUnit) {\n      unitID = selectedUnit.unit_id;\n    }\n\n    if (unitID != null) {\n      const unitsMap = get(columnUnitsMapAtom);\n      // Verify that the unit exists in the current colum, else throw\n      if (!unitsMap?.has(unitID)) {\n        throw new Error(\n          `Unit with ID ${unitID} not found in current column units.`,\n        );\n      }\n      unit = unitsMap.get(unitID) ?? null;\n    }\n\n    let overlayPosition: RectBounds | null = null;\n\n    const columnEl = get(columnRefAtom)?.current;\n\n    if (unit != null && columnEl != null && target != null) {\n      const rect = columnEl.getBoundingClientRect();\n      const targetRect = target.getBoundingClientRect();\n      overlayPosition = {\n        x: targetRect.left - rect.left,\n        y: targetRect.top - rect.top,\n        width: targetRect.width,\n        height: targetRect.height,\n      };\n    }\n\n    set(selectedUnitElementAtom, target);\n    set(selectedUnitIDAtom, unitID);\n    set(overlayPositionAtom, overlayPosition);\n\n    return unit;\n  },\n);\n\nexport function useAtomOverlayPosition() {\n  return scope.useAtomValue(overlayPositionAtom);\n}\n\nexport function UnitSelectionCallbackManager({\n  onUnitSelected,\n}: UnitSelectionCallbacks) {\n  const selectedUnit = scope.useAtomValue(selectedUnitAtom);\n  useEffect(() => {\n    onUnitSelected?.(selectedUnit?.unit_id ?? null, selectedUnit ?? null);\n  }, [selectedUnit?.unit_id]);\n  return null;\n}\n\n/** TODO: figure out if onClickedColumn is still needed\n /** This is not the natural place to get positions within the column,\n * but it will work for now.\nif (props.onClickedColumn) {\n  // Infer height from top and bottom height of unit (because that's passed back with the call)\n  //const py = event.y;\n  //const [bottom, top] = getUnitHeightRange(unit, axisType);\n  //const height = Math.abs(bottom - top);\n\n  const columnClickData: ColumnClickData = {\n    unitID: unit?.unit_id,\n    unit,\n    target,\n    height: el?.getBoundingClientRect().height || 0,\n  };\n  props.onClickedColumn(columnClickData, event);\n}*/\n\nexport function useUnitSelectionTarget(\n  unit: IUnit,\n): [React.RefObject<HTMLElement>, boolean, (evt: Event) => void] {\n  const ref = useRef<HTMLElement>(null);\n  const [selectedUnit, selectUnit] = useUnitSelection();\n  const selected = selectedUnit?.unit_id == unit.unit_id;\n  const selectedUnitElement = scope.useAtomValue(selectedUnitElementAtom);\n\n  const onClick = useCallback(\n    (evt: Event) => {\n      selectUnit?.(unit, ref.current);\n      evt.stopPropagation();\n    },\n    [unit, selectUnit],\n  );\n\n  useEffect(() => {\n    // Sync selection with unit element...\n    if (!selected) return;\n    selectUnit?.(unit, ref.current);\n  }, [ref.current, selected, selectUnit]);\n\n  useEffect(() => {\n    // Scroll the unit into view\n    selectedUnitElement?.scrollIntoView({\n      behavior: \"smooth\",\n      block: \"center\",\n      inline: \"nearest\",\n    });\n  }, [selectedUnitElement]);\n\n  return [ref, selected, onClick];\n}\n\nexport function UnitKeyboardNavigation({\n  columnData,\n  units,\n  allowHorizontalNavigation,\n}: {\n  columnData?: ColumnData[];\n  units?: UnitLong[];\n  allowHorizontalNavigation?: boolean;\n}) {\n  if (units == null && columnData == null) {\n    throw new Error(\"Either units or columnData must be provided.\");\n  }\n\n  let _columnData: ColumnData[] = useMemo(() => {\n    if (columnData != null) return columnData;\n    // Build column data from units\n    const colMap = new Map<number, UnitLong[]>();\n    for (const unit of units!) {\n      if (!colMap.has(unit.col_id)) {\n        colMap.set(unit.col_id, []);\n      }\n      colMap.get(unit.col_id)!.push(unit);\n    }\n    const cols: ColumnData[] = [];\n    for (const [colID, units] of colMap) {\n      cols.push({ columnID: colID, units });\n    }\n    // Sort columns by columnID\n    cols.sort((a, b) => a.columnID - b.columnID);\n    return cols;\n  }, [columnData, units]);\n\n  // Default to allowing horizontal navigation only if columnData is provided\n  const _allowHorizontalNavigation =\n    allowHorizontalNavigation ?? columnData != null;\n\n  const selectedUnit = useSelectedUnit() as UnitLong | null;\n  const selectUnit = useUnitSelectionDispatch();\n\n  const keyMap: Record<number, Direction> = {\n    38: \"up\",\n    40: \"down\",\n  };\n  if (_allowHorizontalNavigation) {\n    keyMap[37] = \"left\";\n    keyMap[39] = \"right\";\n  }\n\n  useKeyHandler(\n    (event) => {\n      const direction = keyMap[event.keyCode];\n      if (direction == null) return;\n      const nextUnit = getBestUnit(_columnData, selectedUnit, direction);\n      if (nextUnit == null) return;\n      selectUnit(nextUnit, null);\n      event.stopPropagation();\n    },\n    [_columnData, selectedUnit],\n  );\n  return null;\n}\n\ntype Direction = \"up\" | \"down\" | \"left\" | \"right\";\n\nfunction getBestUnit(\n  columnData: ColumnData[],\n  targetUnit: UnitLong,\n  direction: Direction,\n): UnitLong | null {\n  const thisColIndex = columnData.findIndex(\n    (col) => col.columnID === targetUnit.col_id,\n  );\n  if (thisColIndex === -1) return null;\n\n  // If up or down, stay in the same column\n  if (direction === \"up\" || direction === \"down\") {\n    const units = columnData[thisColIndex].units;\n    const ix = units.findIndex((unit) => unit.unit_id === targetUnit.unit_id);\n    if (ix === -1) return null;\n    if (direction === \"up\") {\n      return units[ix - 1] || null;\n    } else {\n      return units[ix + 1] || null;\n    }\n  }\n\n  // If left or right, move to adjacent column\n  let adjacentColIndex: number;\n  if (direction === \"left\") {\n    adjacentColIndex =\n      (thisColIndex - 1 + columnData.length) % columnData.length;\n  } else {\n    adjacentColIndex = (thisColIndex + 1) % columnData.length;\n  }\n\n  const adjacentColUnits = columnData[adjacentColIndex].units;\n  return getMostOverlappingUnit(targetUnit, adjacentColUnits);\n}\n\ntype UnitAgeRangeRelationship = AgeRangeQuantifiedDifference & {\n  unit: UnitLong;\n};\n\nfunction getMostOverlappingUnit(\n  targetUnit: UnitLong,\n  candidateUnits: UnitLong[],\n): UnitLong | null {\n  const targetAgeRange = [targetUnit.b_age, targetUnit.t_age];\n\n  const overlaps: UnitAgeRangeRelationship[] = [];\n  for (const candidate of candidateUnits) {\n    const candidateAgeRange = [candidate.b_age, candidate.t_age];\n\n    const rel = ageRangeQuantifiedDifference(targetAgeRange, candidateAgeRange);\n    if (rel.type === AgeRangeRelationship.Identical) {\n      return candidate;\n    }\n    overlaps.push({ ...rel, unit: candidate });\n  }\n\n  let bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Containing,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Contained,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.PartialOverlap,\n  );\n  bestOverlaps.sort((a, b) => b.overlap - a.overlap);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n\n  bestOverlaps = overlaps.filter(\n    (d) => d.type === AgeRangeRelationship.Disjoint,\n  );\n  bestOverlaps.sort((a, b) => a.distance - b.distance);\n  if (bestOverlaps.length > 0) {\n    return bestOverlaps[0].unit;\n  }\n  return null;\n}\n"],"names":["units"],"mappings":"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"}

package/dist/index.cjs

@@ -151,6 +151,7 @@ exports.UnitSelectionPopover = popover.UnitSelectionPopover;
 exports.UnitKeyboardNavigation = unitSelection.UnitKeyboardNavigation;
 exports.UnitSelectionCallbackManager = unitSelection.UnitSelectionCallbackManager;
 exports.allowUnitSelectionAtom = unitSelection.allowUnitSelectionAtom;
+exports.selectedUnitElementAtom = unitSelection.selectedUnitElementAtom;
 exports.selectedUnitIDAtom = unitSelection.selectedUnitIDAtom;
 exports.useAtomOverlayPosition = unitSelection.useAtomOverlayPosition;
 exports.useColumnRef = unitSelection.useColumnRef;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.js

@@ -32,7 +32,7 @@ import { SGPMeasurementsColumn } from "./facets/measurements/sgp.js";
 import { StratNameField } from "./unit-details/strat-names.js";
 import { UnitDetailsPanelWithNavigation } from "./unit-details/modal-panel.js";
 import { UnitDetailsPopover, UnitSelectionPopover } from "./unit-details/popover.js";
-import { UnitKeyboardNavigation, UnitSelectionCallbackManager, allowUnitSelectionAtom, selectedUnitIDAtom, useAtomOverlayPosition, useColumnRef, useSelectedUnit, useUnitSelection, useUnitSelectionDispatch, useUnitSelectionTarget } from "./data-provider/unit-selection.js";
+import { UnitKeyboardNavigation, UnitSelectionCallbackManager, allowUnitSelectionAtom, selectedUnitElementAtom, selectedUnitIDAtom, useAtomOverlayPosition, useColumnRef, useSelectedUnit, useUnitSelection, useUnitSelectionDispatch, useUnitSelectionTarget } from "./data-provider/unit-selection.js";
 import { flattenLithologies, getMixedColorForData, getMixedUnitColor } from "./units/colors.js";
 import { parseLineFromString, stringifyLine } from "./correlation-chart/hash-string.js";
 import { preprocessUnits } from "./prepare-units/helpers.js";
@@ -142,6 +142,7 @@ export {
   prepareColumnUnits,
   preprocessUnits,
   scope,
+  selectedUnitElementAtom,
   selectedUnitIDAtom,
   standardizeMeasurementHeight,
   stringifyLine,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@macrostrat/column-views",
-  "version": "3.4.2",
+  "version": "3.5.0",
   "description": "Data views for Macrostrat stratigraphic columns",
   "repository": {
     "type": "git",
@@ -49,8 +49,8 @@
     "@macrostrat/api-types": "^1.2.0",
     "@macrostrat/color-utils": "^1.2.2",
     "@macrostrat/column-components": "^2.0.8",
-    "@macrostrat/data-components": "^1.1.11",
-    "@macrostrat/data-provider": "^1.0.5",
+    "@macrostrat/data-components": "^1.1.12",
+    "@macrostrat/data-provider": "^1.1.0",
     "@macrostrat/hyper": "^3.1.1",
     "@macrostrat/map-interface": "^2.2.6",
     "@macrostrat/map-styles": "^2.2.4",

package/src/column.ts

@@ -1,5 +1,4 @@
 import { ColumnAxisType } from "@macrostrat/column-components";
-import { hyperStyled } from "@macrostrat/hyper";
 import {
   Box,
   extractPadding,
@@ -12,10 +11,12 @@ import {
   useCallback,
   CSSProperties,
   ComponentType,
+  RefObject,
 } from "react";
-import styles from "./column.module.sass";
+import h from "./column.module.sass";
 import { UnitComponent } from "./units";
 import {
+  ColumnRef,
   UnitKeyboardNavigation,
   useColumnRef,
   useUnitSelectionDispatch,
@@ -48,8 +49,6 @@ import { NonIdealState } from "@blueprintjs/core";
 import { DataField } from "@macrostrat/data-components";
 import { ScaleContinuousNumeric } from "d3-scale";
 
-const h = hyperStyled(styles);
-
 interface BaseColumnProps extends Omit<
   SectionSharedProps,
   "unconformityLabels"
@@ -88,6 +87,7 @@ export interface ColumnProps
   // Unconformity height in pixels
   unconformityHeight?: number;
   scale?: ScaleContinuousNumeric<number, number>;
+  ref?: RefObject<ColumnRef>;
 }
 
 export function Column(props: ColumnProps) {
@@ -113,6 +113,7 @@ export function Column(props: ColumnProps) {
     hybridScale,
     scale,
     axisType,
+    ref,
     ...rest
   } = props;
 
@@ -178,6 +179,7 @@ export function Column(props: ColumnProps) {
       allowUnitSelection: showUnitPopover || allowUnitSelection,
       onUnitSelected,
       selectedUnit,
+      ref,
     },
     h(ColumnInner, { ageAxisComponent, ...rest }, [
       children,

package/src/data-provider/store.ts

@@ -1,4 +1,10 @@
-import { createContext, ReactNode, useContext, useMemo } from "react";
+import {
+  createContext,
+  ReactNode,
+  RefObject,
+  useContext,
+  useMemo,
+} from "react";
 import h from "@macrostrat/hyper";
 import {
   CompositeColumnScale,
@@ -11,13 +17,18 @@ import {
   selectedUnitIDAtom,
   UnitSelectionCallbacks,
   UnitSelectionCallbackManager,
+  selectedUnitElementAtom,
 } from "./unit-selection";
 import type { BaseUnit } from "@macrostrat/api-types";
-import { type AtomMap, createScopedStore } from "@macrostrat/data-components";
+import {
+  type AtomMap,
+  createScopedStore,
+  StateIsolation,
+} from "@macrostrat/data-components";
 import { atom } from "jotai";
 import { useEffect } from "react";
 
-export const scope = createScopedStore();
+export const scope: StateIsolation = createScopedStore();
 
 export const columnUnitsAtom = atom<BaseUnit[]>();
 
@@ -84,6 +95,13 @@ export function MacrostratColumnStateProvider<T extends BaseUnit>({
   );
 }
 
+/** Interface for imperative handlers that can
+ * be invoked outside of the column's react context
+ */
+export interface ColumnRef {
+  scrollSelectedUnitIntoView(): void;
+}
+
 export interface MacrostratColumnDataContext<T extends BaseUnit> {
   units: T[];
   sections: PackageLayoutData[];
@@ -95,6 +113,7 @@ export interface MacrostratColumnDataContext<T extends BaseUnit> {
 export interface ColumnDataProviderProps<T extends BaseUnit>
   extends MacrostratColumnDataContext<T>, ColumnStateProviderProps<T> {
   children: ReactNode;
+  ref: RefObject<ColumnRef>;
 }
 
 const MacrostratColumnDataContext =
@@ -109,6 +128,7 @@ export function MacrostratColumnDataProvider<T extends BaseUnit>({
   allowUnitSelection,
   onUnitSelected,
   selectedUnit,
+  ref,
 }: ColumnDataProviderProps<T>) {
   /** Internal provider for Macrostrat column data.
    * As a general rule, we want to provide data and column-axis
@@ -138,11 +158,35 @@ export function MacrostratColumnDataProvider<T extends BaseUnit>({
       allowUnitSelection,
       onUnitSelected,
       selectedUnit,
+      ref,
     },
-    h(MacrostratColumnDataContext.Provider, { value }, children),
+    [
+      h(ColumnRefManager, { ref }),
+      h(MacrostratColumnDataContext.Provider, { value }, children),
+    ],
   );
 }
 
+function ColumnRefManager({ ref }: { ref?: RefObject<ColumnRef> }) {
+  const selectedUnitElement = scope.useAtomValue(selectedUnitElementAtom);
+  useEffect(() => {
+    if (ref == null) return;
+    ref.current = {
+      scrollSelectedUnitIntoView(opts?: ScrollIntoViewOptions) {
+        selectedUnitElement?.scrollIntoView(
+          opts ?? {
+            behavior: "smooth",
+            block: "center",
+            inline: "nearest",
+          },
+        );
+      },
+    };
+  }, [ref, selectedUnitElement]);
+
+  return null;
+}
+
 export function UnitSelectionProvider(props: ColumnStateProviderProps<any>) {
   /* A basic unit selection provider without column data context.
   Mostly for use with the CorrelationChart component.

package/src/data-provider/unit-selection.ts

@@ -48,6 +48,7 @@ export interface UnitSelectionCallbacks {
 export const allowUnitSelectionAtom = atom<boolean>(true);
 
 export const selectedUnitIDAtom = atom<number | null>();
+export const selectedUnitElementAtom = atom<HTMLElement | null>();
 
 const overlayPositionAtom = atom<RectBounds | null>();
 
@@ -113,6 +114,7 @@ const selectedUnitAtom = atom(
       };
     }
 
+    set(selectedUnitElementAtom, target);
     set(selectedUnitIDAtom, unitID);
     set(overlayPositionAtom, overlayPosition);
 
@@ -158,6 +160,7 @@ export function useUnitSelectionTarget(
   const ref = useRef<HTMLElement>(null);
   const [selectedUnit, selectUnit] = useUnitSelection();
   const selected = selectedUnit?.unit_id == unit.unit_id;
+  const selectedUnitElement = scope.useAtomValue(selectedUnitElementAtom);
 
   const onClick = useCallback(
     (evt: Event) => {
@@ -168,17 +171,19 @@ export function useUnitSelectionTarget(
   );
 
   useEffect(() => {
-    if (!selected || selectUnit == null) return;
-    // In case we haven't set the position of the unit (if we don't have a target), set the selected unit
-    selectUnit(unit, ref.current);
+    // Sync selection with unit element...
+    if (!selected) return;
+    selectUnit?.(unit, ref.current);
+  }, [ref.current, selected, selectUnit]);
 
+  useEffect(() => {
     // Scroll the unit into view
-    ref.current?.scrollIntoView({
+    selectedUnitElement?.scrollIntoView({
       behavior: "smooth",
       block: "center",
       inline: "nearest",
     });
-  }, [selected, selectUnit]);
+  }, [selectedUnitElement]);
 
   return [ref, selected, onClick];
 }