@macrostrat/column-views 3.6.1 → 3.9.0

package/CHANGELOG.md

@@ -1,5 +1,149 @@
 # Changelog
 
+## [3.9.0] - 2026-08-25 [_changes_](https://github.com/UW-Macrostrat/web-components/compare/@macrostrat/column-views-v3.8.0...@macrostrat/column-views-v3.9.0)
+
+### Minor Changes
+
+- Add `useAnimatedAgeWindow`: animates a column/correlation-chart's rendered
+  `t_age`/`b_age` for smooth pan-and-contract navigation at constant
+  `pixelScale` (density), driving the existing clipping + zig-zag unit edges. It
+  runs on the shared `useAnimatedDomain` core from `@macrostrat/timescale`.
+  Threads `isTransitioning` / `hideLabelsWhileTransitioning` flags through
+  `Column`/`CorrelationChart` → `ColumnProvider`; labels stay visible through
+  the animation by default, with an opt-in toggle to hide them. New stories for
+  the correlation chart and a single stratigraphic column, each with a
+  fixed-`pixelScale` variant and a label-hiding toggle.
+  [0247a5a2](https://github.com/UW-Macrostrat/web-components/commit/0247a5a2e12062fdb5e586b4b5dca9c3c6490127)
+
+  Add `windowPadding` (px): how much of the sections abutting the rendered
+  `t_age`/`b_age` window to reveal, so neighboring stratigraphy — and its
+  timescale intervals — stay visible and navigable when zoomed in. Available on
+  `Column` and `CorrelationChart`.
+
+  Unit density is now derived from the units the rendered window actually shows,
+  measured by their visible duration — so `targetUnitHeight` describes the units
+  on screen at any zoom depth, rather than the containing section's overall
+  average. A section the window doesn't reach falls back to its own units at
+  full duration and is drawn at its own scale. This removes the need for any
+  zoom-factor input: clipping shortens visible durations, which raises density,
+  so a column renders identically whether a window was animated to or set
+  directly.
+
+  Age columns now lay every section out at its **full extent** and apply the
+  rendered window as the last step, rather than clipping units and section
+  bounds up front. A section abutting the window therefore keeps its own density
+  and `minSectionHeight`, and is then trimmed to exactly the requested sliver —
+  previously such a fragment had its density re-derived from the few units that
+  survived the clip and was re-inflated to the floor, with its scale stretched
+  to match. Sections clipped by the window itself still honor
+  `minSectionHeight`, expanding their scale rather than rendering a sliver; only
+  the padding margin past the window renders at exactly its requested pixels.
+  Those final densities are resolved before the padding budget is spent, so a
+  margin measures the pixels requested rather than those pixels times whatever
+  stretch its neighbor needed — otherwise a short interval (a Holocene beside a
+  Pleistocene) is swallowed by its own margin. This also makes `windowPadding`
+  exact (it is spent against real section pixel heights; unconformity gaps
+  aren't charged, so padding smaller than `unconformityHeight` can still reach
+  across one) and stops unconformity-collapse decisions from shifting as the
+  window moves. Hybrid and externally-supplied scales keep the previous
+  clip-then-lay-out path.
+
+  Stabilize composite-scale package keys (positional index instead of
+  `package-${b_age}-${t_age}`) so the correlation chart's packages, columns, and
+  timescale reconcile instead of remounting on every animation frame. Unit
+  labels re-fit when a transition settles (via `SizeAwareLabel`'s
+  `remeasureKey`), not on intermediate frames.
+
+  `Column` now forwards `onClickTimescaleInterval` and `timescaleIntervalStyle`
+  to its composite timescale (via `CompositeTimescale`'s new
+  `onClickInterval`/`intervalStyle` props), so a standalone column supports
+  click-to-zoom interval navigation and per-interval styling (e.g. bolding the
+  selected interval).
+
+  Add an interval-zoom story (grouped with the other animation stories under
+  `Column views/Column animations`): clicking a timescale interval animates the
+  window to it, a preceding/postdating interval moves along the timescale, and
+  clicking the selected interval zooms out a level. The timescale shows a fixed
+  3-level window that slides with the selected interval's rank (always one
+  coarser level to navigate up, one finer to drill down), independent of the
+  layout. `targetUnitHeight`, `minSectionHeight` and `windowPadding` are plain
+  display controls — there is no zoom-level input.
+
+### Patch Changes
+
+- Fix two zoom-sync issues exposed by animated age-window zoom:
+  [0247a5a2](https://github.com/UW-Macrostrat/web-components/commit/0247a5a2e12062fdb5e586b4b5dca9c3c6490127)
+
+  - Age-axis (`AgeAxis`) now redraws when the scale's domain/range changes (not
+    just its object identity), and builds a fresh d3 axis generator each render.
+    Reusing the generator retained stale `.tickValues()` config, so a section
+    that was short (explicit first/last ticks) and later stretched kept those
+    out-of-domain tick values — leaving some axes with no labels. Both surfaced
+    once stable React keys stopped the axis remounting per frame.
+  - The inline-label/note tracker (`LabelTrackerProvider`) re-syncs to the
+    _current_ visible unit set on zoom. Its stale gate froze the "unlabeled" set
+    once the unit set changed, so a unit whose label now fit inline also kept
+    rendering as a note; it now recomputes over current units.
+
+- Updated dependencies
+  [0247a5a2](https://github.com/UW-Macrostrat/web-components/commit/0247a5a2e12062fdb5e586b4b5dca9c3c6490127)
+- Updated dependencies
+  [0247a5a2](https://github.com/UW-Macrostrat/web-components/commit/0247a5a2e12062fdb5e586b4b5dca9c3c6490127)
+- Updated dependencies
+  [0247a5a2](https://github.com/UW-Macrostrat/web-components/commit/0247a5a2e12062fdb5e586b4b5dca9c3c6490127)
+- Updated dependencies
+  [0247a5a2](https://github.com/UW-Macrostrat/web-components/commit/0247a5a2e12062fdb5e586b4b5dca9c3c6490127)
+- Updated dependencies
+  [0247a5a2](https://github.com/UW-Macrostrat/web-components/commit/0247a5a2e12062fdb5e586b4b5dca9c3c6490127)
+  - @macrostrat/timescale@3.2.0
+  - @macrostrat/column-components@2.1.0
+  - @macrostrat/ui-components@5.2.0
+  - @macrostrat/map-styles@2.2.7
+
+## [3.8.0] - 2026-08-02 [_changes_](https://github.com/UW-Macrostrat/web-components/compare/@macrostrat/column-views-v3.7.0...@macrostrat/column-views-v3.8.0)
+
+### Minor Changes
+
+- Move Identifier and UnitIdentifier to `@macrostrat/data-components`
+  [91fcea53](https://github.com/UW-Macrostrat/web-components/commit/91fcea536dd55e387b6f5bce1da0c07395da4635)
+
+### Patch Changes
+
+- Remove some unnecessarily bundled packages
+  [930edeae](https://github.com/UW-Macrostrat/web-components/commit/930edeaef23d42d62ee3f533d2e20c75dbf9ea42)
+- Updated dependencies
+  [1961f84a](https://github.com/UW-Macrostrat/web-components/commit/1961f84a397a341ce92eb032dcdc77c79f957707)
+- Updated dependencies
+  [930edeae](https://github.com/UW-Macrostrat/web-components/commit/930edeaef23d42d62ee3f533d2e20c75dbf9ea42)
+- Updated dependencies
+  [91fcea53](https://github.com/UW-Macrostrat/web-components/commit/91fcea536dd55e387b6f5bce1da0c07395da4635)
+  - @macrostrat/data-components@1.5.0
+  - @macrostrat/column-components@2.0.10
+  - @macrostrat/mapbox-react@3.3.3
+
+## [3.7.0] - 2026-07-30 [_changes_](https://github.com/UW-Macrostrat/web-components/compare/@macrostrat/column-views-v3.6.1...@macrostrat/column-views-v3.7.0)
+
+### Minor Changes
+
+- - Improve column correlation chart to support more options
+    [b21ea1fc](https://github.com/UW-Macrostrat/web-components/commit/b21ea1fc297a5449a91997b3d97ff3509e8cd824)
+  - Create a new column reorganization draggable control
+  - Update data provider for intervals fetching
+
+### Patch Changes
+
+- Updated dependencies
+  [b21ea1fc](https://github.com/UW-Macrostrat/web-components/commit/b21ea1fc297a5449a91997b3d97ff3509e8cd824)
+- Updated dependencies
+  [b21ea1fc](https://github.com/UW-Macrostrat/web-components/commit/b21ea1fc297a5449a91997b3d97ff3509e8cd824)
+- Updated dependencies
+  [b21ea1fc](https://github.com/UW-Macrostrat/web-components/commit/b21ea1fc297a5449a91997b3d97ff3509e8cd824)
+  - @macrostrat/map-interface@2.3.1
+  - @macrostrat/mapbox-react@3.3.2
+  - @macrostrat/data-components@1.4.1
+  - @macrostrat/data-provider@1.2.0
+  - @macrostrat/timescale@3.1.6
+
 ## [3.6.1] - 2026-07-28 [_changes_](https://github.com/UW-Macrostrat/web-components/compare/@macrostrat/column-views-v3.6.0...@macrostrat/column-views-v3.6.1)
 
 ### Patch Changes

package/dist/animated-age-window.cjs

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const React = require("react");
+const timescale = require("@macrostrat/timescale");
+function useAnimatedAgeWindow(options) {
+  const { fullExtent, duration } = options;
+  const extent = React.useMemo(() => toDomain(fullExtent), [
+    fullExtent?.t_age,
+    fullExtent?.b_age
+  ]);
+  const anim = timescale.useAnimatedDomain({ extent, duration });
+  const zoomToWindow = React.useCallback(
+    (target, opts = {}) => {
+      anim.animateTo([target.b_age, target.t_age], {
+        duration: opts.duration
+      });
+    },
+    [anim.animateTo]
+  );
+  const zoomToInterval = React.useCallback(
+    (interval, opts = {}) => {
+      zoomToWindow({ t_age: interval.lag, b_age: interval.eag }, opts);
+    },
+    [zoomToWindow]
+  );
+  const reset = React.useCallback(
+    (opts = {}) => {
+      if (fullExtent == null) return;
+      zoomToWindow(fullExtent, opts);
+    },
+    [zoomToWindow, fullExtent?.t_age, fullExtent?.b_age]
+  );
+  return {
+    window: toWindow(anim.domain),
+    isAnimating: anim.isAnimating,
+    isFullExtent: anim.isFullExtent,
+    zoomToWindow,
+    zoomToInterval,
+    reset
+  };
+}
+function toDomain(w) {
+  if (w == null) return null;
+  return [w.b_age, w.t_age];
+}
+function toWindow(d) {
+  if (d == null) return null;
+  return { t_age: d[1], b_age: d[0] };
+}
+exports.useAnimatedAgeWindow = useAnimatedAgeWindow;
+//# sourceMappingURL=animated-age-window.cjs.map

package/dist/animated-age-window.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"animated-age-window.cjs","sources":["../src/animated-age-window.ts"],"sourcesContent":["import { useCallback, useMemo } from \"react\";\nimport { AgeDomain, useAnimatedDomain } from \"@macrostrat/timescale\";\n\n/** A rendered age window, ordered as the column props expect:\n * `t_age` is the younger (top) bound, `b_age` the older (bottom) bound. */\nexport interface AgeWindow {\n  t_age: number;\n  b_age: number;\n}\n\nexport interface AnimateWindowOptions {\n  duration?: number;\n}\n\nexport interface UseAnimatedAgeWindowOptions {\n  /** The full data extent — the window to reset to, and the initial window.\n   * `null` until the data (and hence extent) is known. */\n  fullExtent: AgeWindow | null;\n  /** Animation duration in ms (default 750). */\n  duration?: number;\n}\n\nexport interface AnimatedAgeWindow {\n  /** The current animated window to feed to `t_age`/`b_age` column props\n   * (`null` until `fullExtent` is known). */\n  window: AgeWindow | null;\n  isAnimating: boolean;\n  /** True when the window is (approximately) the full extent. */\n  isFullExtent: boolean;\n  /** Pan-and-contract to an explicit window (clamped to the full extent).\n   * Density (`pixelScale`) is left untouched — this is not a zoom. */\n  zoomToWindow(target: AgeWindow, opts?: AnimateWindowOptions): void;\n  /** Pan-and-contract to a timescale interval, using `eag`/`lag`. */\n  zoomToInterval(\n    interval: { eag: number; lag: number },\n    opts?: AnimateWindowOptions,\n  ): void;\n  /** Ease back to the full extent. */\n  reset(opts?: AnimateWindowOptions): void;\n}\n\n/**\n * Animate the rendered age window (`t_age`/`b_age`) of a column or correlation\n * chart. This is the \"animate the current zoom approach\" model: narrowing the\n * window re-lays-out the column with explicit clipping — units past the bounds\n * get a zig-zag edge, unconformities keep their fixed `unconformityHeight`, and\n * `pixelScale` (density) is untouched, so a sub-interval click **pans and\n * contracts** at constant density rather than zooming. Joint domain/range\n * change (true zoom) stays under the user's direct control via `pixelScale`.\n *\n * The animation itself is `useAnimatedDomain` from `@macrostrat/timescale` —\n * the same state machine that drives the timescale's `useZoomableScale`. This\n * hook only maps an `[older, younger]` domain onto `{ b_age, t_age }`; it\n * animates the window you ask for and nothing more. Revealing a margin of the\n * neighboring column is the *layout's* job, via the `windowPadding` prop (px),\n * which is resolved against real section heights rather than predicted here.\n */\nexport function useAnimatedAgeWindow(\n  options: UseAnimatedAgeWindowOptions,\n): AnimatedAgeWindow {\n  const { fullExtent, duration } = options;\n\n  const extent = useMemo(() => toDomain(fullExtent), [\n    fullExtent?.t_age,\n    fullExtent?.b_age,\n  ]);\n\n  const anim = useAnimatedDomain({ extent, duration });\n\n  const zoomToWindow = useCallback(\n    (target: AgeWindow, opts: AnimateWindowOptions = {}) => {\n      anim.animateTo([target.b_age, target.t_age], {\n        duration: opts.duration,\n      });\n    },\n    [anim.animateTo],\n  );\n\n  const zoomToInterval = useCallback(\n    (\n      interval: { eag: number; lag: number },\n      opts: AnimateWindowOptions = {},\n    ) => {\n      zoomToWindow({ t_age: interval.lag, b_age: interval.eag }, opts);\n    },\n    [zoomToWindow],\n  );\n\n  const reset = useCallback(\n    (opts: AnimateWindowOptions = {}) => {\n      if (fullExtent == null) return;\n      zoomToWindow(fullExtent, opts);\n    },\n    [zoomToWindow, fullExtent?.t_age, fullExtent?.b_age],\n  );\n\n  return {\n    window: toWindow(anim.domain),\n    isAnimating: anim.isAnimating,\n    isFullExtent: anim.isFullExtent,\n    zoomToWindow,\n    zoomToInterval,\n    reset,\n  };\n}\n\n/** `{t_age, b_age}` ↔ the core's `[older, younger]` domain. */\nfunction toDomain(w: AgeWindow): AgeDomain;\nfunction toDomain(w: AgeWindow | null): AgeDomain | null;\nfunction toDomain(w: AgeWindow | null): AgeDomain | null {\n  if (w == null) return null;\n  return [w.b_age, w.t_age];\n}\n\nfunction toWindow(d: AgeDomain): AgeWindow;\nfunction toWindow(d: AgeDomain | null): AgeWindow | null;\nfunction toWindow(d: AgeDomain | null): AgeWindow | null {\n  if (d == null) return null;\n  return { t_age: d[1], b_age: d[0] };\n}\n"],"names":["useMemo","useAnimatedDomain","useCallback"],"mappings":";;;;AAyDO,SAAS,qBACd,SACmB;AACnB,QAAM,EAAE,YAAY,SAAA,IAAa;AAEjC,QAAM,SAASA,MAAAA,QAAQ,MAAM,SAAS,UAAU,GAAG;AAAA,IACjD,YAAY;AAAA,IACZ,YAAY;AAAA,EAAA,CACb;AAED,QAAM,OAAOC,UAAAA,kBAAkB,EAAE,QAAQ,UAAU;AAEnD,QAAM,eAAeC,MAAAA;AAAAA,IACnB,CAAC,QAAmB,OAA6B,OAAO;AACtD,WAAK,UAAU,CAAC,OAAO,OAAO,OAAO,KAAK,GAAG;AAAA,QAC3C,UAAU,KAAK;AAAA,MAAA,CAChB;AAAA,IACH;AAAA,IACA,CAAC,KAAK,SAAS;AAAA,EAAA;AAGjB,QAAM,iBAAiBA,MAAAA;AAAAA,IACrB,CACE,UACA,OAA6B,OAC1B;AACH,mBAAa,EAAE,OAAO,SAAS,KAAK,OAAO,SAAS,IAAA,GAAO,IAAI;AAAA,IACjE;AAAA,IACA,CAAC,YAAY;AAAA,EAAA;AAGf,QAAM,QAAQA,MAAAA;AAAAA,IACZ,CAAC,OAA6B,CAAA,MAAO;AACnC,UAAI,cAAc,KAAM;AACxB,mBAAa,YAAY,IAAI;AAAA,IAC/B;AAAA,IACA,CAAC,cAAc,YAAY,OAAO,YAAY,KAAK;AAAA,EAAA;AAGrD,SAAO;AAAA,IACL,QAAQ,SAAS,KAAK,MAAM;AAAA,IAC5B,aAAa,KAAK;AAAA,IAClB,cAAc,KAAK;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAKA,SAAS,SAAS,GAAuC;AACvD,MAAI,KAAK,KAAM,QAAO;AACtB,SAAO,CAAC,EAAE,OAAO,EAAE,KAAK;AAC1B;AAIA,SAAS,SAAS,GAAuC;AACvD,MAAI,KAAK,KAAM,QAAO;AACtB,SAAO,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAA;AAClC;;"}

package/dist/animated-age-window.d.ts

@@ -0,0 +1,51 @@
+/** A rendered age window, ordered as the column props expect:
+ * `t_age` is the younger (top) bound, `b_age` the older (bottom) bound. */
+export interface AgeWindow {
+    t_age: number;
+    b_age: number;
+}
+export interface AnimateWindowOptions {
+    duration?: number;
+}
+export interface UseAnimatedAgeWindowOptions {
+    /** The full data extent — the window to reset to, and the initial window.
+     * `null` until the data (and hence extent) is known. */
+    fullExtent: AgeWindow | null;
+    /** Animation duration in ms (default 750). */
+    duration?: number;
+}
+export interface AnimatedAgeWindow {
+    /** The current animated window to feed to `t_age`/`b_age` column props
+     * (`null` until `fullExtent` is known). */
+    window: AgeWindow | null;
+    isAnimating: boolean;
+    /** True when the window is (approximately) the full extent. */
+    isFullExtent: boolean;
+    /** Pan-and-contract to an explicit window (clamped to the full extent).
+     * Density (`pixelScale`) is left untouched — this is not a zoom. */
+    zoomToWindow(target: AgeWindow, opts?: AnimateWindowOptions): void;
+    /** Pan-and-contract to a timescale interval, using `eag`/`lag`. */
+    zoomToInterval(interval: {
+        eag: number;
+        lag: number;
+    }, opts?: AnimateWindowOptions): void;
+    /** Ease back to the full extent. */
+    reset(opts?: AnimateWindowOptions): void;
+}
+/**
+ * Animate the rendered age window (`t_age`/`b_age`) of a column or correlation
+ * chart. This is the "animate the current zoom approach" model: narrowing the
+ * window re-lays-out the column with explicit clipping — units past the bounds
+ * get a zig-zag edge, unconformities keep their fixed `unconformityHeight`, and
+ * `pixelScale` (density) is untouched, so a sub-interval click **pans and
+ * contracts** at constant density rather than zooming. Joint domain/range
+ * change (true zoom) stays under the user's direct control via `pixelScale`.
+ *
+ * The animation itself is `useAnimatedDomain` from `@macrostrat/timescale` —
+ * the same state machine that drives the timescale's `useZoomableScale`. This
+ * hook only maps an `[older, younger]` domain onto `{ b_age, t_age }`; it
+ * animates the window you ask for and nothing more. Revealing a margin of the
+ * neighboring column is the *layout's* job, via the `windowPadding` prop (px),
+ * which is resolved against real section heights rather than predicted here.
+ */
+export declare function useAnimatedAgeWindow(options: UseAnimatedAgeWindowOptions): AnimatedAgeWindow;

package/dist/animated-age-window.js

@@ -0,0 +1,51 @@
+import { useMemo, useCallback } from "react";
+import { useAnimatedDomain } from "@macrostrat/timescale";
+function useAnimatedAgeWindow(options) {
+  const { fullExtent, duration } = options;
+  const extent = useMemo(() => toDomain(fullExtent), [
+    fullExtent?.t_age,
+    fullExtent?.b_age
+  ]);
+  const anim = useAnimatedDomain({ extent, duration });
+  const zoomToWindow = useCallback(
+    (target, opts = {}) => {
+      anim.animateTo([target.b_age, target.t_age], {
+        duration: opts.duration
+      });
+    },
+    [anim.animateTo]
+  );
+  const zoomToInterval = useCallback(
+    (interval, opts = {}) => {
+      zoomToWindow({ t_age: interval.lag, b_age: interval.eag }, opts);
+    },
+    [zoomToWindow]
+  );
+  const reset = useCallback(
+    (opts = {}) => {
+      if (fullExtent == null) return;
+      zoomToWindow(fullExtent, opts);
+    },
+    [zoomToWindow, fullExtent?.t_age, fullExtent?.b_age]
+  );
+  return {
+    window: toWindow(anim.domain),
+    isAnimating: anim.isAnimating,
+    isFullExtent: anim.isFullExtent,
+    zoomToWindow,
+    zoomToInterval,
+    reset
+  };
+}
+function toDomain(w) {
+  if (w == null) return null;
+  return [w.b_age, w.t_age];
+}
+function toWindow(d) {
+  if (d == null) return null;
+  return { t_age: d[1], b_age: d[0] };
+}
+export {
+  useAnimatedAgeWindow
+};
+//# sourceMappingURL=animated-age-window.js.map

package/dist/animated-age-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animated-age-window.js","sources":["../src/animated-age-window.ts"],"sourcesContent":["import { useCallback, useMemo } from \"react\";\nimport { AgeDomain, useAnimatedDomain } from \"@macrostrat/timescale\";\n\n/** A rendered age window, ordered as the column props expect:\n * `t_age` is the younger (top) bound, `b_age` the older (bottom) bound. */\nexport interface AgeWindow {\n  t_age: number;\n  b_age: number;\n}\n\nexport interface AnimateWindowOptions {\n  duration?: number;\n}\n\nexport interface UseAnimatedAgeWindowOptions {\n  /** The full data extent — the window to reset to, and the initial window.\n   * `null` until the data (and hence extent) is known. */\n  fullExtent: AgeWindow | null;\n  /** Animation duration in ms (default 750). */\n  duration?: number;\n}\n\nexport interface AnimatedAgeWindow {\n  /** The current animated window to feed to `t_age`/`b_age` column props\n   * (`null` until `fullExtent` is known). */\n  window: AgeWindow | null;\n  isAnimating: boolean;\n  /** True when the window is (approximately) the full extent. */\n  isFullExtent: boolean;\n  /** Pan-and-contract to an explicit window (clamped to the full extent).\n   * Density (`pixelScale`) is left untouched — this is not a zoom. */\n  zoomToWindow(target: AgeWindow, opts?: AnimateWindowOptions): void;\n  /** Pan-and-contract to a timescale interval, using `eag`/`lag`. */\n  zoomToInterval(\n    interval: { eag: number; lag: number },\n    opts?: AnimateWindowOptions,\n  ): void;\n  /** Ease back to the full extent. */\n  reset(opts?: AnimateWindowOptions): void;\n}\n\n/**\n * Animate the rendered age window (`t_age`/`b_age`) of a column or correlation\n * chart. This is the \"animate the current zoom approach\" model: narrowing the\n * window re-lays-out the column with explicit clipping — units past the bounds\n * get a zig-zag edge, unconformities keep their fixed `unconformityHeight`, and\n * `pixelScale` (density) is untouched, so a sub-interval click **pans and\n * contracts** at constant density rather than zooming. Joint domain/range\n * change (true zoom) stays under the user's direct control via `pixelScale`.\n *\n * The animation itself is `useAnimatedDomain` from `@macrostrat/timescale` —\n * the same state machine that drives the timescale's `useZoomableScale`. This\n * hook only maps an `[older, younger]` domain onto `{ b_age, t_age }`; it\n * animates the window you ask for and nothing more. Revealing a margin of the\n * neighboring column is the *layout's* job, via the `windowPadding` prop (px),\n * which is resolved against real section heights rather than predicted here.\n */\nexport function useAnimatedAgeWindow(\n  options: UseAnimatedAgeWindowOptions,\n): AnimatedAgeWindow {\n  const { fullExtent, duration } = options;\n\n  const extent = useMemo(() => toDomain(fullExtent), [\n    fullExtent?.t_age,\n    fullExtent?.b_age,\n  ]);\n\n  const anim = useAnimatedDomain({ extent, duration });\n\n  const zoomToWindow = useCallback(\n    (target: AgeWindow, opts: AnimateWindowOptions = {}) => {\n      anim.animateTo([target.b_age, target.t_age], {\n        duration: opts.duration,\n      });\n    },\n    [anim.animateTo],\n  );\n\n  const zoomToInterval = useCallback(\n    (\n      interval: { eag: number; lag: number },\n      opts: AnimateWindowOptions = {},\n    ) => {\n      zoomToWindow({ t_age: interval.lag, b_age: interval.eag }, opts);\n    },\n    [zoomToWindow],\n  );\n\n  const reset = useCallback(\n    (opts: AnimateWindowOptions = {}) => {\n      if (fullExtent == null) return;\n      zoomToWindow(fullExtent, opts);\n    },\n    [zoomToWindow, fullExtent?.t_age, fullExtent?.b_age],\n  );\n\n  return {\n    window: toWindow(anim.domain),\n    isAnimating: anim.isAnimating,\n    isFullExtent: anim.isFullExtent,\n    zoomToWindow,\n    zoomToInterval,\n    reset,\n  };\n}\n\n/** `{t_age, b_age}` ↔ the core's `[older, younger]` domain. */\nfunction toDomain(w: AgeWindow): AgeDomain;\nfunction toDomain(w: AgeWindow | null): AgeDomain | null;\nfunction toDomain(w: AgeWindow | null): AgeDomain | null {\n  if (w == null) return null;\n  return [w.b_age, w.t_age];\n}\n\nfunction toWindow(d: AgeDomain): AgeWindow;\nfunction toWindow(d: AgeDomain | null): AgeWindow | null;\nfunction toWindow(d: AgeDomain | null): AgeWindow | null {\n  if (d == null) return null;\n  return { t_age: d[1], b_age: d[0] };\n}\n"],"names":[],"mappings":";;AAyDO,SAAS,qBACd,SACmB;AACnB,QAAM,EAAE,YAAY,SAAA,IAAa;AAEjC,QAAM,SAAS,QAAQ,MAAM,SAAS,UAAU,GAAG;AAAA,IACjD,YAAY;AAAA,IACZ,YAAY;AAAA,EAAA,CACb;AAED,QAAM,OAAO,kBAAkB,EAAE,QAAQ,UAAU;AAEnD,QAAM,eAAe;AAAA,IACnB,CAAC,QAAmB,OAA6B,OAAO;AACtD,WAAK,UAAU,CAAC,OAAO,OAAO,OAAO,KAAK,GAAG;AAAA,QAC3C,UAAU,KAAK;AAAA,MAAA,CAChB;AAAA,IACH;AAAA,IACA,CAAC,KAAK,SAAS;AAAA,EAAA;AAGjB,QAAM,iBAAiB;AAAA,IACrB,CACE,UACA,OAA6B,OAC1B;AACH,mBAAa,EAAE,OAAO,SAAS,KAAK,OAAO,SAAS,IAAA,GAAO,IAAI;AAAA,IACjE;AAAA,IACA,CAAC,YAAY;AAAA,EAAA;AAGf,QAAM,QAAQ;AAAA,IACZ,CAAC,OAA6B,CAAA,MAAO;AACnC,UAAI,cAAc,KAAM;AACxB,mBAAa,YAAY,IAAI;AAAA,IAC/B;AAAA,IACA,CAAC,cAAc,YAAY,OAAO,YAAY,KAAK;AAAA,EAAA;AAGrD,SAAO;AAAA,IACL,QAAQ,SAAS,KAAK,MAAM;AAAA,IAC5B,aAAa,KAAK;AAAA,IAClB,cAAc,KAAK;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAKA,SAAS,SAAS,GAAuC;AACvD,MAAI,KAAK,KAAM,QAAO;AACtB,SAAO,CAAC,EAAE,OAAO,EAAE,KAAK;AAC1B;AAIA,SAAS,SAAS,GAAuC;AACvD,MAAI,KAAK,KAAM,QAAO;AACtB,SAAO,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAA;AAClC;"}