@kteneyck/cesium-timeline-core 0.2.0 → 0.4.0

package/dist/cesium-timeline-core.js

@@ -1,5 +1,5 @@
-import * as k from "cesium";
-const ye = {
+import * as L from "cesium";
+const ke = {
   backgroundColor: "#1a1a1a",
   tickColor: "#666666",
   majorTickColor: "#999999",
@@ -17,8 +17,8 @@ const ye = {
   swimLaneItemBorderColor: "#666666",
   swimLaneItemBorderWidth: 0
 };
-var ae = /* @__PURE__ */ ((e) => (e[e.FIFTEEN_MIN = 15] = "FIFTEEN_MIN", e[e.THIRTY_MIN = 30] = "THIRTY_MIN", e[e.HOURLY = 60] = "HOURLY", e[e.CUSTOM = -1] = "CUSTOM", e))(ae || {});
-const w = {
+var ce = /* @__PURE__ */ ((e) => (e[e.FIFTEEN_MIN = 15] = "FIFTEEN_MIN", e[e.THIRTY_MIN = 30] = "THIRTY_MIN", e[e.HOURLY = 60] = "HOURLY", e[e.CUSTOM = -1] = "CUSTOM", e))(ce || {});
+const $ = {
   color: "#4da6ff",
   borderColor: "#2980b9",
   borderWidth: 1,
@@ -28,22 +28,22 @@ const w = {
   labelColor: "#cccccc",
   backgroundColor: "transparent"
 }, R = 24;
-function He(e) {
-  return e instanceof k.JulianDate ? k.JulianDate.clone(e) : k.JulianDate.fromDate(e);
+function Le(e) {
+  return e instanceof L.JulianDate ? L.JulianDate.clone(e) : L.JulianDate.fromDate(e);
 }
-function ce(e) {
-  return e instanceof k.JulianDate ? k.JulianDate.toDate(e) : e;
+function te(e) {
+  return e instanceof L.JulianDate ? L.JulianDate.toDate(e) : e;
 }
-function W(e) {
-  return ce(e).getTime();
+function N(e) {
+  return te(e).getTime();
 }
-function ke(e) {
-  return k.JulianDate.fromDate(new Date(e));
+function Ce(e) {
+  return L.JulianDate.fromDate(new Date(e));
 }
-function ue(e, t) {
-  return W(t) - W(e);
+function Me(e, t) {
+  return N(t) - N(e);
 }
-const he = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], Me = ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], me = {
+const ge = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"], de = ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"], fe = {
   /** e.g. "Feb 24 2026 14:04:07" — default */
   DEFAULT: "MMM DD YYYY HH:mm:ss",
   /** e.g. "Feb 24 2026 02:04:07 PM" */
@@ -58,33 +58,70 @@ const he = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct"
   TIME_ONLY: "HH:mm:ss",
   /** e.g. "02:04:07 PM" */
   TIME_12: "hh:mm:ss A"
+}, Ae = {
+  /** Use the browser's local timezone (default behavior). */
+  LOCAL: "local",
+  /** Coordinated Universal Time. */
+  UTC: "UTC"
 };
-function ge(e, t = me.DEFAULT) {
-  const o = ce(e), l = o.getFullYear(), r = o.getMonth(), s = o.getDate(), a = o.getHours(), i = a % 12 || 12, u = o.getMinutes(), c = o.getSeconds(), d = o.getMilliseconds(), M = a < 12 ? "AM" : "PM", m = (Y) => String(Y).padStart(2, "0"), f = (Y) => String(Y).padStart(3, "0"), T = {
-    YYYY: String(l),
-    YY: String(l).slice(-2),
-    MMMM: Me[r],
-    MMM: he[r],
-    MM: m(r + 1),
-    M: String(r + 1),
-    DD: m(s),
-    D: String(s),
-    HH: m(a),
-    H: String(a),
-    hh: m(i),
-    h: String(i),
-    mm: m(u),
-    ss: m(c),
-    SSS: f(d),
-    A: M,
-    a: M.toLowerCase()
+function oe(e, t) {
+  if (!t || t === "local") {
+    const g = e.getFullYear(), f = e.getMonth(), u = e.getDate(), y = e.getHours(), H = y % 12 || 12, d = e.getMinutes(), E = e.getSeconds(), I = e.getMilliseconds();
+    return { yr: g, mo: f, day: u, hr24: y, hr12: H, min: d, sec: E, ms: I, ampm: y < 12 ? "AM" : "PM" };
+  }
+  const o = new Intl.DateTimeFormat("en-US", {
+    timeZone: t,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: !1
+  }), l = {};
+  for (const g of o.formatToParts(e))
+    g.type !== "literal" && (l[g.type] = g.value);
+  const r = parseInt(l.year), s = parseInt(l.month) - 1, a = parseInt(l.day);
+  let n = parseInt(l.hour);
+  n === 24 && (n = 0);
+  const m = n % 12 || 12, c = parseInt(l.minute), h = parseInt(l.second), M = e.getMilliseconds();
+  return { yr: r, mo: s, day: a, hr24: n, hr12: m, min: c, sec: h, ms: M, ampm: n < 12 ? "AM" : "PM" };
+}
+function Ye(e, t) {
+  var r;
+  if (!t || t === "local") return null;
+  const o = te(e);
+  return ((r = new Intl.DateTimeFormat("en-US", {
+    timeZone: t,
+    timeZoneName: "short"
+  }).formatToParts(o).find((s) => s.type === "timeZoneName")) == null ? void 0 : r.value) ?? null;
+}
+function Te(e, t = fe.DEFAULT, o) {
+  const l = te(e), { yr: r, mo: s, day: a, hr24: n, hr12: m, min: c, sec: h, ms: M, ampm: g } = oe(l, o), f = (H) => String(H).padStart(2, "0"), u = (H) => String(H).padStart(3, "0"), y = {
+    YYYY: String(r),
+    YY: String(r).slice(-2),
+    MMMM: de[s],
+    MMM: ge[s],
+    MM: f(s + 1),
+    M: String(s + 1),
+    DD: f(a),
+    D: String(a),
+    HH: f(n),
+    H: String(n),
+    hh: f(m),
+    h: String(m),
+    mm: f(c),
+    ss: f(h),
+    SSS: u(M),
+    A: g,
+    a: g.toLowerCase()
   };
   return t.replace(
     /YYYY|YY|MMMM|MMM|MM|M|DD|D|HH|H|hh|h|mm|ss|SSS|A|a/g,
-    (Y) => T[Y] ?? Y
+    (H) => y[H] ?? H
   );
 }
-function Le(e = me.DEFAULT) {
+function Ee(e = fe.DEFAULT) {
   const t = ["YYYY", "YY", "MMMM", "MMM", "MM", "M", "DD", "D"], o = ["HH", "H", "hh", "h", "mm", "ss", "SSS", "A", "a"], l = (a) => a.replace(/\s{2,}/g, " ").trim().replace(/^[\s\W]+|[\s\W]+$/g, "").trim();
   let r = e;
   for (const a of t) r = r.replace(a, "");
@@ -92,27 +129,27 @@ function Le(e = me.DEFAULT) {
   for (const a of o) s = s.replace(a, "");
   return { timeFormat: l(r), dateFormat: l(s) };
 }
-function Ye(e, t = !1) {
-  return ge(e, t ? "HH:mm:ss" : "HH:mm");
+function Ie(e, t = !1) {
+  return Te(e, t ? "HH:mm:ss" : "HH:mm");
 }
-function de(e, t, o, l) {
-  const r = W(e), s = W(t), a = W(o);
+function pe(e, t, o, l) {
+  const r = N(e), s = N(t), a = N(o);
   if (a === s) return 0;
-  const i = (r - s) / (a - s);
-  return Math.max(0, Math.min(1, i)) * l;
+  const n = (r - s) / (a - s);
+  return Math.max(0, Math.min(1, n)) * l;
 }
-function Ce(e, t, o, l) {
-  const r = Math.max(0, Math.min(1, e / l)), s = W(t), a = W(o), i = s + r * (a - s);
-  return k.JulianDate.fromDate(new Date(i));
+function we(e, t, o, l) {
+  const r = Math.max(0, Math.min(1, e / l)), s = N(t), a = N(o), n = s + r * (a - s);
+  return L.JulianDate.fromDate(new Date(n));
 }
-function Ae(e, t, o, l) {
-  const r = [], s = ue(e, t), a = W(e);
-  let i;
-  typeof o == "number" && o in ae || typeof o == "number" ? i = o * 60 * 1e3 : i = 3600 * 1e3;
-  const u = i * 4;
-  let c = a, d = 0;
+function _e(e, t, o, l) {
+  const r = [], s = Me(e, t), a = N(e);
+  let n;
+  typeof o == "number" && o in ce || typeof o == "number" ? n = o * 60 * 1e3 : n = 3600 * 1e3;
+  const m = n * 4;
+  let c = a, h = 0;
   for (; c <= a + s; ) {
-    const M = d * i % u === 0, m = de(
+    const M = h * n % m === 0, g = pe(
       new Date(c),
       e,
       t,
@@ -120,18 +157,18 @@ function Ae(e, t, o, l) {
     );
     let f;
     if (M) {
-      const T = new Date(c), Y = T.getHours().toString().padStart(2, "0"), b = T.getMinutes().toString().padStart(2, "0");
-      f = `${Y}:${b}`;
+      const u = new Date(c), y = u.getHours().toString().padStart(2, "0"), H = u.getMinutes().toString().padStart(2, "0");
+      f = `${y}:${H}`;
     }
     r.push({
-      position: m,
+      position: g,
       isMajor: M,
       label: f
-    }), c += i, d++;
+    }), c += n, h++;
   }
   return r;
 }
-function Ee(e, t, o = 10) {
+function Pe(e, t, o = 10) {
   let l = t[0], r = Math.abs(l.position - e);
   for (const s of t) {
     const a = Math.abs(s.position - e);
@@ -139,7 +176,7 @@ function Ee(e, t, o = 10) {
   }
   return r <= o ? l.position : e;
 }
-const Se = 1e3, Te = 31536e9, S = [
+const Se = 1e3, be = 31536e9, S = [
   1e-3,
   2e-3,
   5e-3,
@@ -188,73 +225,78 @@ const Se = 1e3, Te = 31536e9, S = [
   126144e5,
   15768e6,
   31536e6
-], G = 36, P = 1, be = 6, Z = 6, _e = 0.3, x = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
-function A(e) {
+], G = 36, F = 1, De = 6, Q = 6, $e = 0.3, x = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+function Y(e) {
   return e < 10 ? `0${e}` : `${e}`;
 }
-function le(e, t) {
-  const o = new Date(e), l = o.getFullYear(), r = o.getMonth(), s = o.getDate(), a = o.getHours(), i = o.getMinutes(), u = o.getSeconds(), c = o.getMilliseconds();
-  if (t > 31536e4) return `${l}`;
-  if (t > 31536e3) return `${x[r]} ${l}`;
-  if (t > 604800) return `${x[r]} ${s}`;
-  if (t > 86400) return `${x[r]} ${s} ${A(a)}:${A(i)}`;
-  if (t > 3600) return `${A(a)}:${A(i)}`;
-  if (t > 60) return `${A(a)}:${A(i)}:${A(u)}`;
-  const d = c > 0 ? `.${String(c).padStart(3, "0")}` : "";
-  return `${A(a)}:${A(i)}:${A(u)}${d}`;
+function me(e, t, o) {
+  const l = new Date(e), { yr: r, mo: s, day: a, hr24: n, min: m, sec: c, ms: h } = oe(l, o);
+  if (t > 31536e4) return `${r}`;
+  if (t > 31536e3) return `${x[s]} ${r}`;
+  if (t > 604800) return `${x[s]} ${a}`;
+  if (t > 86400) return `${x[s]} ${a} ${Y(n)}:${Y(m)}`;
+  if (t > 3600) return `${Y(n)}:${Y(m)}`;
+  if (t > 60) return `${Y(n)}:${Y(m)}:${Y(c)}`;
+  const M = h > 0 ? `.${String(h).padStart(3, "0")}` : "";
+  return `${Y(n)}:${Y(m)}:${Y(c)}${M}`;
 }
-function pe(e, t) {
-  const o = new Date(e), l = o.getFullYear(), r = o.getMonth(), s = o.getDate();
-  return t > 31536e4 ? new Date(Math.floor(l / 100) * 100, 0).getTime() : t > 31536e3 ? new Date(Math.floor(l / 10) * 10, 0).getTime() : t > 86400 ? new Date(l, 0).getTime() : new Date(l, r, s).getTime();
+function ye(e, t, o) {
+  const l = new Date(e);
+  if (!o || o === "local") {
+    const m = l.getFullYear(), c = l.getMonth(), h = l.getDate();
+    return t > 31536e4 ? new Date(Math.floor(m / 100) * 100, 0).getTime() : t > 31536e3 ? new Date(Math.floor(m / 10) * 10, 0).getTime() : t > 86400 ? new Date(m, 0).getTime() : new Date(m, c, h).getTime();
+  }
+  const { yr: r, hr24: s, min: a, sec: n } = oe(l, o);
+  return t > 31536e4 ? Date.UTC(Math.floor(r / 100) * 100, 0, 1) : t > 31536e3 ? Date.UTC(Math.floor(r / 10) * 10, 0, 1) : t > 86400 ? Date.UTC(r, 0, 1) : e - (s * 3600 + a * 60 + n) * 1e3;
 }
 function ee(e, t) {
   return Math.ceil(e / t + 0.5) * t;
 }
-function fe(e, t, o) {
-  var l, r, s, a, i, u, c, d, M, m, f, T;
+function ue(e, t, o) {
+  var l, r, s, a, n, m, c, h, M, g, f, u;
   return {
-    color: ((l = t.style) == null ? void 0 : l.color) ?? ((r = e.style) == null ? void 0 : r.color) ?? w.color,
-    borderColor: ((s = t.style) == null ? void 0 : s.borderColor) ?? ((a = e.style) == null ? void 0 : a.borderColor) ?? (o == null ? void 0 : o.swimLaneItemBorderColor) ?? w.borderColor,
-    borderWidth: ((i = t.style) == null ? void 0 : i.borderWidth) ?? ((u = e.style) == null ? void 0 : u.borderWidth) ?? (o == null ? void 0 : o.swimLaneItemBorderWidth) ?? w.borderWidth,
-    opacity: ((c = t.style) == null ? void 0 : c.opacity) ?? ((d = e.style) == null ? void 0 : d.opacity) ?? w.opacity,
-    markerShape: ((M = t.style) == null ? void 0 : M.markerShape) ?? ((m = e.style) == null ? void 0 : m.markerShape) ?? w.markerShape,
-    markerSize: ((f = t.style) == null ? void 0 : f.markerSize) ?? ((T = e.style) == null ? void 0 : T.markerSize) ?? w.markerSize
+    color: ((l = t.style) == null ? void 0 : l.color) ?? ((r = e.style) == null ? void 0 : r.color) ?? $.color,
+    borderColor: ((s = t.style) == null ? void 0 : s.borderColor) ?? ((a = e.style) == null ? void 0 : a.borderColor) ?? (o == null ? void 0 : o.swimLaneItemBorderColor) ?? $.borderColor,
+    borderWidth: ((n = t.style) == null ? void 0 : n.borderWidth) ?? ((m = e.style) == null ? void 0 : m.borderWidth) ?? (o == null ? void 0 : o.swimLaneItemBorderWidth) ?? $.borderWidth,
+    opacity: ((c = t.style) == null ? void 0 : c.opacity) ?? ((h = e.style) == null ? void 0 : h.opacity) ?? $.opacity,
+    markerShape: ((M = t.style) == null ? void 0 : M.markerShape) ?? ((g = e.style) == null ? void 0 : g.markerShape) ?? $.markerShape,
+    markerSize: ((f = t.style) == null ? void 0 : f.markerSize) ?? ((u = e.style) == null ? void 0 : u.markerSize) ?? $.markerSize
   };
 }
-function De(e) {
-  return Math.max(Se, Math.min(Te, e));
+function He(e) {
+  return Math.max(Se, Math.min(be, e));
 }
-function $e(e, t, o) {
-  const l = t - e, r = (e + t) / 2, s = De(l * o);
+function Re(e, t, o) {
+  const l = t - e, r = (e + t) / 2, s = He(l * o);
   return {
     startMs: r - s / 2,
     endMs: r + s / 2
   };
 }
-function we(e) {
+function Ne(e) {
   let t = 0;
-  for (const o of e) t += (o.height ?? R) + P;
+  for (const o of e) t += (o.height ?? R) + F;
   return t;
 }
-function Re(e, t, o, l, r) {
-  const { swimLanes: s, showSwimLanes: a, scrollTop: i, startMs: u, endMs: c, theme: d } = r;
+function We(e, t, o, l, r) {
+  const { swimLanes: s, showSwimLanes: a, scrollTop: n, startMs: m, endMs: c, theme: h } = r;
   if (!a || s.length === 0) return null;
   const M = Math.max(0, l - G);
   if (t < 0 || t >= M) return null;
-  let m = -i;
+  let g = -n;
   for (const f of s) {
-    const T = f.height ?? R, Y = m, b = m + T;
-    if (m += T + P, !(t < Y || t >= b)) {
-      for (const y of f.items) {
-        if (y.interval) {
-          const F = k.JulianDate.toDate(y.interval.start).getTime(), O = k.JulianDate.toDate(y.interval.stop).getTime(), B = (F - u) / (c - u) * o, X = (O - u) / (c - u) * o;
-          if (e >= Math.max(0, B) && e <= Math.min(o, X))
-            return { lane: f, item: y };
+    const u = f.height ?? R, y = g, H = g + u;
+    if (g += u + F, !(t < y || t >= H)) {
+      for (const d of f.items) {
+        if (d.interval) {
+          const E = L.JulianDate.toDate(d.interval.start).getTime(), I = L.JulianDate.toDate(d.interval.stop).getTime(), U = (E - m) / (c - m) * o, X = (I - m) / (c - m) * o;
+          if (e >= Math.max(0, U) && e <= Math.min(o, X))
+            return { lane: f, item: d };
         }
-        if (y.instant) {
-          const O = (k.JulianDate.toDate(y.instant).getTime() - u) / (c - u) * o, B = fe(f, y, d);
-          if (Math.abs(e - O) <= B.markerSize / 2 + 2)
-            return { lane: f, item: y };
+        if (d.instant) {
+          const I = (L.JulianDate.toDate(d.instant).getTime() - m) / (c - m) * o, U = ue(f, d, h);
+          if (Math.abs(e - I) <= U.markerSize / 2 + 2)
+            return { lane: f, item: d };
         }
       }
       return null;
@@ -262,186 +304,190 @@ function Re(e, t, o, l, r) {
   }
   return null;
 }
-function We(e, t, o, l) {
+function Je(e, t, o, l) {
   const { swimLanes: r, showSwimLanes: s, scrollTop: a } = l;
   if (!s || r.length === 0 || e > 80) return null;
-  const i = Math.max(0, o - G);
-  if (t < 0 || t >= i) return null;
-  let u = -a;
+  const n = Math.max(0, o - G);
+  if (t < 0 || t >= n) return null;
+  let m = -a;
   for (const c of r) {
-    const d = c.height ?? R;
-    if (t >= u && t < u + d) return c;
-    u += d + P;
+    const h = c.height ?? R;
+    if (t >= m && t < m + h) return c;
+    m += h + F;
   }
   return null;
 }
-function Je(e, t, o) {
+function Fe(e, t, o) {
   if (!o.showSwimLanes || o.swimLanes.length === 0) return !1;
   const l = Math.max(0, t - G);
   return e >= 0 && e < l;
 }
-function Ne(e, t, o, l) {
+function Oe(e, t, o, l) {
   const {
     startMs: r,
     endMs: s,
     currentMs: a,
-    theme: i,
-    maxTicks: u,
+    theme: n,
+    maxTicks: m,
     swimLanes: c,
-    showSwimLanes: d,
-    reorderState: M
+    showSwimLanes: h,
+    reorderState: M,
+    timezone: g
   } = l;
-  let { scrollTop: m } = l;
-  const f = (s - r) / 1e3;
-  if (f <= 0) return m;
-  e.fillStyle = i.backgroundColor, e.fillRect(0, 0, t, o);
-  const T = d && c.length > 0, b = T ? Math.max(0, o - G) : 0;
-  let y = 0;
-  if (T)
-    for (const n of c) y += (n.height ?? R) + P;
-  const F = Math.max(0, y - b);
-  if (m > F && (m = F), m < 0 && (m = 0), T && b > 0) {
-    e.save(), e.beginPath(), e.rect(0, 0, t, b), e.clip();
-    let n = -m;
-    const p = (D) => (D - r) / (s - r) * t;
+  let { scrollTop: f } = l;
+  const u = (s - r) / 1e3;
+  if (u <= 0) return f;
+  e.fillStyle = n.backgroundColor, e.fillRect(0, 0, t, o);
+  const y = h && c.length > 0, d = y ? Math.max(0, o - G) : 0;
+  let E = 0;
+  if (y)
+    for (const i of c) E += (i.height ?? R) + F;
+  const I = Math.max(0, E - d);
+  if (f > I && (f = I), f < 0 && (f = 0), y && d > 0) {
+    e.save(), e.beginPath(), e.rect(0, 0, t, d), e.clip();
+    let i = -f;
+    const b = (D) => (D - r) / (s - r) * t;
     for (const D of c) {
-      const g = D.height ?? R, L = n + g;
-      if (L > 0 && n < b) {
-        const h = D.style, I = (h == null ? void 0 : h.backgroundColor) ?? w.backgroundColor;
-        I && I !== "transparent" && (e.fillStyle = I, e.fillRect(0, n, t, g)), e.strokeStyle = i.tickColor + "44", e.lineWidth = 0.5, e.beginPath(), e.moveTo(0, L), e.lineTo(t, L), e.stroke();
-        for (const E of D.items) {
-          const H = fe(D, E, i);
-          if (E.interval) {
-            const V = k.JulianDate.toDate(E.interval.start).getTime(), C = k.JulianDate.toDate(E.interval.stop).getTime(), J = p(V), N = p(C), q = Math.max(0, J), Q = Math.min(t, N) - q;
-            if (Q > 0) {
-              e.globalAlpha = H.opacity, e.fillStyle = H.color;
-              const re = 3, ie = n + re, se = g - re * 2;
-              e.fillRect(q, ie, Q, se), H.borderWidth > 0 && (e.strokeStyle = H.borderColor, e.lineWidth = H.borderWidth, e.strokeRect(q, ie, Q, se)), e.globalAlpha = 1;
+      const p = D.height ?? R, C = i + p;
+      if (C > 0 && i < d) {
+        const T = D.style, O = (T == null ? void 0 : T.backgroundColor) ?? $.backgroundColor;
+        O && O !== "transparent" && (e.fillStyle = O, e.fillRect(0, i, t, p)), e.strokeStyle = n.tickColor + "44", e.lineWidth = 0.5, e.beginPath(), e.moveTo(0, C), e.lineTo(t, C), e.stroke();
+        for (const w of D.items) {
+          const k = ue(D, w, n);
+          if (w.interval) {
+            const K = L.JulianDate.toDate(w.interval.start).getTime(), A = L.JulianDate.toDate(w.interval.stop).getTime(), W = b(K), J = b(A), V = Math.max(0, W), q = Math.min(t, J) - V;
+            if (q > 0) {
+              e.globalAlpha = k.opacity, e.fillStyle = k.color;
+              const se = 3, le = i + se, ae = p - se * 2;
+              e.fillRect(V, le, q, ae), k.borderWidth > 0 && (e.strokeStyle = k.borderColor, e.lineWidth = k.borderWidth, e.strokeRect(V, le, q, ae)), e.globalAlpha = 1;
             }
           }
-          if (E.instant) {
-            const V = k.JulianDate.toDate(E.instant).getTime(), C = p(V);
-            if (C >= -H.markerSize && C <= t + H.markerSize) {
-              const J = n + g / 2, N = H.markerSize;
-              e.globalAlpha = H.opacity, e.fillStyle = H.color, H.markerShape === "diamond" ? (e.beginPath(), e.moveTo(C, J - N / 2), e.lineTo(C + N / 2, J), e.lineTo(C, J + N / 2), e.lineTo(C - N / 2, J), e.closePath(), e.fill()) : H.markerShape === "circle" ? (e.beginPath(), e.arc(C, J, N / 2, 0, Math.PI * 2), e.fill()) : (e.strokeStyle = H.color, e.lineWidth = 2, e.beginPath(), e.moveTo(C, n + 2), e.lineTo(C, n + g - 2), e.stroke()), e.globalAlpha = 1;
+          if (w.instant) {
+            const K = L.JulianDate.toDate(w.instant).getTime(), A = b(K);
+            if (A >= -k.markerSize && A <= t + k.markerSize) {
+              const W = i + p / 2, J = k.markerSize;
+              e.globalAlpha = k.opacity, e.fillStyle = k.color, k.markerShape === "diamond" ? (e.beginPath(), e.moveTo(A, W - J / 2), e.lineTo(A + J / 2, W), e.lineTo(A, W + J / 2), e.lineTo(A - J / 2, W), e.closePath(), e.fill()) : k.markerShape === "circle" ? (e.beginPath(), e.arc(A, W, J / 2, 0, Math.PI * 2), e.fill()) : (e.strokeStyle = k.color, e.lineWidth = 2, e.beginPath(), e.moveTo(A, i + 2), e.lineTo(A, i + p - 2), e.stroke()), e.globalAlpha = 1;
             }
           }
         }
-        e.font = `${Math.min(11, g - 4)}px system-ui, sans-serif`, e.textAlign = "left", e.textBaseline = "middle", e.fillStyle = (h == null ? void 0 : h.labelColor) ?? w.labelColor, e.fillText(D.label, be, n + g / 2);
+        e.font = `${Math.min(11, p - 4)}px system-ui, sans-serif`, e.textAlign = "left", e.textBaseline = "middle", e.fillStyle = (T == null ? void 0 : T.labelColor) ?? $.labelColor, e.fillText(D.label, De, i + p / 2);
       }
-      if (n += g + P, n >= b) break;
+      if (i += p + F, i >= d) break;
     }
     if (M && M.dragging) {
       const D = M.currentY - M.dragStartY;
-      let g = -m;
-      for (let h = 0; h < c.length && h < M.insertIndex; h++)
-        g += (c[h].height ?? R) + P;
-      e.strokeStyle = i.indicatorColor, e.lineWidth = 2, e.beginPath(), e.moveTo(0, g), e.lineTo(t, g), e.stroke();
-      const L = c.find((h) => h.id === M.dragLaneId);
-      if (L) {
-        const h = L.height ?? R;
-        let I = -m;
-        for (const E of c) {
-          if (E.id === M.dragLaneId) break;
-          I += (E.height ?? R) + P;
+      let p = -f;
+      for (let T = 0; T < c.length && T < M.insertIndex; T++)
+        p += (c[T].height ?? R) + F;
+      e.strokeStyle = n.indicatorColor, e.lineWidth = 2, e.beginPath(), e.moveTo(0, p), e.lineTo(t, p), e.stroke();
+      const C = c.find((T) => T.id === M.dragLaneId);
+      if (C) {
+        const T = C.height ?? R;
+        let O = -f;
+        for (const w of c) {
+          if (w.id === M.dragLaneId) break;
+          O += (w.height ?? R) + F;
         }
-        e.globalAlpha = 0.4, e.fillStyle = i.indicatorColor, e.fillRect(0, I + D, t, h), e.globalAlpha = 1;
+        e.globalAlpha = 0.4, e.fillStyle = n.indicatorColor, e.fillRect(0, O + D, t, T), e.globalAlpha = 1;
       }
     }
-    if (y > b) {
-      const D = t - Z - 2, g = b / y, L = Math.max(20, b * g), h = m / F * (b - L);
-      e.fillStyle = i.tickColor + "22", e.fillRect(D, 0, Z, b), e.fillStyle = i.tickColor + "88", e.fillRect(D, h, Z, L);
+    if (E > d) {
+      const D = t - Q - 2, p = d / E, C = Math.max(20, d * p), T = f / I * (d - C);
+      e.fillStyle = n.tickColor + "22", e.fillRect(D, 0, Q, d), e.fillStyle = n.tickColor + "88", e.fillRect(D, T, Q, C);
     }
     e.restore();
   }
-  e.font = `${i.fontSize}px monospace`;
-  const O = le(r + f * 500, f), B = e.measureText(O).width + 24, X = Math.max(B / t * f, f / 1e3);
-  let _ = S[S.length - 1], z = S.length - 1;
-  for (let n = 0; n < S.length; n++)
-    if (S[n] > X) {
-      _ = S[n], z = n;
+  e.font = `${n.fontSize}px monospace`;
+  const U = me(r + u * 500, u, g), X = e.measureText(U).width + 24, he = Math.max(X / t * u, u / 1e3);
+  let _ = S[S.length - 1], B = S.length - 1;
+  for (let i = 0; i < S.length; i++)
+    if (S[i] > he) {
+      _ = S[i], B = i;
       break;
     }
-  if (u != null && u > 0)
-    for (; z < S.length - 1 && f / _ > u; )
-      z++, _ = S[z];
-  let $ = 0;
-  for (let n = z - 1; n >= 0; n--)
-    if (_ % S[n] < 1e-4) {
-      t * (S[n] / f) >= 3 && ($ = S[n]);
+  if (m != null && m > 0)
+    for (; B < S.length - 1 && u / _ > m; )
+      B++, _ = S[B];
+  let P = 0;
+  for (let i = B - 1; i >= 0; i--)
+    if (_ % S[i] < 1e-4) {
+      t * (S[i] / u) >= 3 && (P = S[i]);
       break;
     }
-  let U = 0;
-  if ($ > 0) {
-    for (let n = 0; n < S.length && S[n] < $; n++)
-      if ($ % S[n] < 1e-4 && t * (S[n] / f) >= 3) {
-        U = S[n];
+  let z = 0;
+  if (P > 0) {
+    for (let i = 0; i < S.length && S[i] < P; i++)
+      if (P % S[i] < 1e-4 && t * (S[i] / u) >= 3) {
+        z = S[i];
         break;
       }
   }
-  const te = pe(r, f), j = (r - te) / 1e3, K = j + f, v = (n) => t * ((n - j) / f);
-  if (U > 0) {
-    e.strokeStyle = i.tickColor, e.lineWidth = 1;
-    for (let n = Math.floor(j / U) * U; n <= K; n = ee(n, U)) {
-      const p = v(n);
-      e.beginPath(), e.moveTo(p, o - i.minorTickHeight), e.lineTo(p, o), e.stroke();
+  const ne = ye(r, u, g), j = (r - ne) / 1e3, Z = j + u, v = (i) => t * ((i - j) / u);
+  if (z > 0) {
+    e.strokeStyle = n.tickColor, e.lineWidth = 1;
+    for (let i = Math.floor(j / z) * z; i <= Z; i = ee(i, z)) {
+      const b = v(i);
+      e.beginPath(), e.moveTo(b, o - n.minorTickHeight), e.lineTo(b, o), e.stroke();
     }
   }
-  if ($ > 0) {
-    e.strokeStyle = i.tickColor, e.lineWidth = 1;
-    for (let n = Math.floor(j / $) * $; n <= K; n = ee(n, $)) {
-      const p = v(n);
-      e.beginPath(), e.moveTo(p, o - i.minorTickHeight), e.lineTo(p, o), e.stroke();
+  if (P > 0) {
+    e.strokeStyle = n.tickColor, e.lineWidth = 1;
+    for (let i = Math.floor(j / P) * P; i <= Z; i = ee(i, P)) {
+      const b = v(i);
+      e.beginPath(), e.moveTo(b, o - n.minorTickHeight), e.lineTo(b, o), e.stroke();
     }
   }
   e.textAlign = "center", e.textBaseline = "bottom";
-  let oe = -1 / 0;
-  for (let n = Math.floor(j / _) * _; n <= K + _; n = ee(n, _)) {
-    const p = v(n), D = te + n * 1e3;
-    e.strokeStyle = i.majorTickColor, e.lineWidth = 1, e.beginPath(), e.moveTo(p, o - i.majorTickHeight), e.lineTo(p, o), e.stroke();
-    const g = le(D, f), L = e.measureText(g).width, h = p - L / 2;
-    h > oe && (e.fillStyle = i.labelColor, e.fillText(g, p, o - i.majorTickHeight - 4), oe = h + L + 5);
+  let re = -1 / 0;
+  for (let i = Math.floor(j / _) * _; i <= Z + _; i = ee(i, _)) {
+    const b = v(i), D = ne + i * 1e3;
+    e.strokeStyle = n.majorTickColor, e.lineWidth = 1, e.beginPath(), e.moveTo(b, o - n.majorTickHeight), e.lineTo(b, o), e.stroke();
+    const p = me(D, u, g), C = e.measureText(p).width, T = b - C / 2;
+    T > re && (e.fillStyle = n.labelColor, e.fillText(p, b, o - n.majorTickHeight - 4), re = T + C + 5);
   }
-  const ne = (a - r) / (s - r) * t;
-  return e.strokeStyle = i.indicatorColor, e.lineWidth = i.indicatorLineWidth, e.beginPath(), e.moveTo(ne, 0), e.lineTo(ne, o), e.stroke(), m;
+  const ie = (a - r) / (s - r) * t;
+  return e.strokeStyle = n.indicatorColor, e.lineWidth = n.indicatorLineWidth, e.beginPath(), e.moveTo(ie, 0), e.lineTo(ie, o), e.stroke(), f;
 }
 export {
   R as DEFAULT_LANE_HEIGHT,
-  me as DateTimeFormats,
-  be as LABEL_PAD_LEFT,
-  P as LANE_GAP,
-  Te as MAX_SPAN_MS,
+  fe as DateTimeFormats,
+  De as LABEL_PAD_LEFT,
+  F as LANE_GAP,
+  be as MAX_SPAN_MS,
   Se as MIN_SPAN_MS,
   x as MONTHS,
-  Z as SCROLLBAR_WIDTH,
-  _e as SWIM_LANE_SCROLL_SPEED,
+  Q as SCROLLBAR_WIDTH,
+  $e as SWIM_LANE_SCROLL_SPEED,
   G as TICK_AREA_HEIGHT,
   S as TIC_SCALES,
-  ae as TickInterval,
-  pe as calcEpochMs,
-  De as clampSpan,
-  w as defaultSwimLaneStyle,
-  ye as defaultTheme,
-  Ne as drawTimeline,
-  ge as formatDateTime,
-  Ye as formatTime,
-  ke as fromMilliseconds,
-  Ae as generateTicks,
-  ue as getDurationMs,
-  We as hitTestLaneLabel,
-  Re as hitTestSwimLane,
-  Je as isInSwimLaneRegion,
-  le as makeLabel,
+  ce as TickInterval,
+  Ae as Timezones,
+  ye as calcEpochMs,
+  He as clampSpan,
+  $ as defaultSwimLaneStyle,
+  ke as defaultTheme,
+  Oe as drawTimeline,
+  Te as formatDateTime,
+  Ie as formatTime,
+  Ce as fromMilliseconds,
+  _e as generateTicks,
+  oe as getDateParts,
+  Me as getDurationMs,
+  Ye as getTimezoneAbbr,
+  Je as hitTestLaneLabel,
+  We as hitTestSwimLane,
+  Fe as isInSwimLaneRegion,
+  me as makeLabel,
   ee as nextTic,
-  Ce as positionToTime,
-  fe as resolveItemStyle,
-  Ee as snapToTick,
-  Le as splitForDisplay,
-  de as timeToPosition,
-  ce as toDate,
-  He as toJulianDate,
-  W as toMilliseconds,
-  we as totalSwimLaneHeight,
-  A as twoD,
-  $e as zoomRange
+  we as positionToTime,
+  ue as resolveItemStyle,
+  Pe as snapToTick,
+  Ee as splitForDisplay,
+  pe as timeToPosition,
+  te as toDate,
+  Le as toJulianDate,
+  N as toMilliseconds,
+  Ne as totalSwimLaneHeight,
+  Y as twoD,
+  Re as zoomRange
 };

package/dist/cesium-timeline-core.umd.cjs

@@ -1 +1 @@
-(function(r,B){typeof exports=="object"&&typeof module<"u"?B(exports,require("cesium")):typeof define=="function"&&define.amd?define(["exports","cesium"],B):(r=typeof globalThis<"u"?globalThis:r||self,B(r.CesiumTimelineCore={},r.Cesium))})(this,(function(r,B){"use strict";function Le(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const o in e)if(o!=="default"){const a=Object.getOwnPropertyDescriptor(e,o);Object.defineProperty(t,o,a.get?a:{enumerable:!0,get:()=>e[o]})}}return t.default=e,Object.freeze(t)}const H=Le(B),He={backgroundColor:"#1a1a1a",tickColor:"#666666",majorTickColor:"#999999",labelColor:"#cccccc",indicatorColor:"#d69826",indicatorLineWidth:5,majorTickHeight:10,minorTickHeight:5,fontSize:12,controlBarBackground:"#242424",controlBarBorder:"#333333",buttonColor:"#666666",buttonHoverColor:"#888888",buttonActiveColor:"#d69826",swimLaneItemBorderColor:"#666666",swimLaneItemBorderWidth:0};var Q=(e=>(e[e.FIFTEEN_MIN=15]="FIFTEEN_MIN",e[e.THIRTY_MIN=30]="THIRTY_MIN",e[e.HOURLY=60]="HOURLY",e[e.CUSTOM=-1]="CUSTOM",e))(Q||{});const E={color:"#4da6ff",borderColor:"#2980b9",borderWidth:1,opacity:.8,markerShape:"diamond",markerSize:10,labelColor:"#cccccc",backgroundColor:"transparent"},w=24;function ke(e){return e instanceof H.JulianDate?H.JulianDate.clone(e):H.JulianDate.fromDate(e)}function Z(e){return e instanceof H.JulianDate?H.JulianDate.toDate(e):e}function I(e){return Z(e).getTime()}function pe(e){return H.JulianDate.fromDate(new Date(e))}function se(e,t){return I(t)-I(e)}const Ae=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],Ce=["January","February","March","April","May","June","July","August","September","October","November","December"],x={DEFAULT:"MMM DD YYYY HH:mm:ss",TWELVE_HR:"MMM DD YYYY hh:mm:ss A",ISO:"YYYY-MM-DD HH:mm:ss",US:"MM/DD/YYYY HH:mm",EU:"DD/MM/YYYY HH:mm",TIME_ONLY:"HH:mm:ss",TIME_12:"hh:mm:ss A"};function ce(e,t=x.DEFAULT){const o=Z(e),a=o.getFullYear(),i=o.getMonth(),s=o.getDate(),c=o.getHours(),l=c%12||12,M=o.getMinutes(),m=o.getSeconds(),T=o.getMilliseconds(),g=c<12?"AM":"PM",f=_=>String(_).padStart(2,"0"),u=_=>String(_).padStart(3,"0"),b={YYYY:String(a),YY:String(a).slice(-2),MMMM:Ce[i],MMM:Ae[i],MM:f(i+1),M:String(i+1),DD:f(s),D:String(s),HH:f(c),H:String(c),hh:f(l),h:String(l),mm:f(M),ss:f(m),SSS:u(T),A:g,a:g.toLowerCase()};return t.replace(/YYYY|YY|MMMM|MMM|MM|M|DD|D|HH|H|hh|h|mm|ss|SSS|A|a/g,_=>b[_]??_)}function _e(e=x.DEFAULT){const t=["YYYY","YY","MMMM","MMM","MM","M","DD","D"],o=["HH","H","hh","h","mm","ss","SSS","A","a"],a=c=>c.replace(/\s{2,}/g," ").trim().replace(/^[\s\W]+|[\s\W]+$/g,"").trim();let i=e;for(const c of t)i=i.replace(c,"");let s=e;for(const c of o)s=s.replace(c,"");return{timeFormat:a(i),dateFormat:a(s)}}function Ye(e,t=!1){return ce(e,t?"HH:mm:ss":"HH:mm")}function me(e,t,o,a){const i=I(e),s=I(t),c=I(o);if(c===s)return 0;const l=(i-s)/(c-s);return Math.max(0,Math.min(1,l))*a}function Ee(e,t,o,a){const i=Math.max(0,Math.min(1,e/a)),s=I(t),c=I(o),l=s+i*(c-s);return H.JulianDate.fromDate(new Date(l))}function we(e,t,o,a){const i=[],s=se(e,t),c=I(e);let l;typeof o=="number"&&o in Q||typeof o=="number"?l=o*60*1e3:l=3600*1e3;const M=l*4;let m=c,T=0;for(;m<=c+s;){const g=T*l%M===0,f=me(new Date(m),e,t,a);let u;if(g){const b=new Date(m),_=b.getHours().toString().padStart(2,"0"),D=b.getMinutes().toString().padStart(2,"0");u=`${_}:${D}`}i.push({position:f,isMajor:g,label:u}),m+=l,T++}return i}function Ie(e,t,o=10){let a=t[0],i=Math.abs(a.position-e);for(const s of t){const c=Math.abs(s.position-e);c<i&&(i=c,a=s)}return i<=o?a.position:e}const fe=1e3,ue=31536e9,d=[.001,.002,.005,.01,.02,.05,.1,.25,.5,1,2,5,10,15,30,60,120,300,600,900,1800,3600,7200,14400,21600,43200,86400,172800,345600,604800,1296e3,2592e3,5184e3,7776e3,15552e3,31536e3,63072e3,126144e3,15768e4,31536e4,63072e4,126144e4,15768e5,31536e5,63072e5,126144e5,15768e6,31536e6],z=36,R=1,Me=6,K=6,Pe=.3,q=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];function C(e){return e<10?`0${e}`:`${e}`}function ee(e,t){const o=new Date(e),a=o.getFullYear(),i=o.getMonth(),s=o.getDate(),c=o.getHours(),l=o.getMinutes(),M=o.getSeconds(),m=o.getMilliseconds();if(t>31536e4)return`${a}`;if(t>31536e3)return`${q[i]} ${a}`;if(t>604800)return`${q[i]} ${s}`;if(t>86400)return`${q[i]} ${s} ${C(c)}:${C(l)}`;if(t>3600)return`${C(c)}:${C(l)}`;if(t>60)return`${C(c)}:${C(l)}:${C(M)}`;const T=m>0?`.${String(m).padStart(3,"0")}`:"";return`${C(c)}:${C(l)}:${C(M)}${T}`}function he(e,t){const o=new Date(e),a=o.getFullYear(),i=o.getMonth(),s=o.getDate();return t>31536e4?new Date(Math.floor(a/100)*100,0).getTime():t>31536e3?new Date(Math.floor(a/10)*10,0).getTime():t>86400?new Date(a,0).getTime():new Date(a,i,s).getTime()}function V(e,t){return Math.ceil(e/t+.5)*t}function te(e,t,o){var a,i,s,c,l,M,m,T,g,f,u,b;return{color:((a=t.style)==null?void 0:a.color)??((i=e.style)==null?void 0:i.color)??E.color,borderColor:((s=t.style)==null?void 0:s.borderColor)??((c=e.style)==null?void 0:c.borderColor)??(o==null?void 0:o.swimLaneItemBorderColor)??E.borderColor,borderWidth:((l=t.style)==null?void 0:l.borderWidth)??((M=e.style)==null?void 0:M.borderWidth)??(o==null?void 0:o.swimLaneItemBorderWidth)??E.borderWidth,opacity:((m=t.style)==null?void 0:m.opacity)??((T=e.style)==null?void 0:T.opacity)??E.opacity,markerShape:((g=t.style)==null?void 0:g.markerShape)??((f=e.style)==null?void 0:f.markerShape)??E.markerShape,markerSize:((u=t.style)==null?void 0:u.markerSize)??((b=e.style)==null?void 0:b.markerSize)??E.markerSize}}function ge(e){return Math.max(fe,Math.min(ue,e))}function Re(e,t,o){const a=t-e,i=(e+t)/2,s=ge(a*o);return{startMs:i-s/2,endMs:i+s/2}}function Ne(e){let t=0;for(const o of e)t+=(o.height??w)+R;return t}function Oe(e,t,o,a,i){const{swimLanes:s,showSwimLanes:c,scrollTop:l,startMs:M,endMs:m,theme:T}=i;if(!c||s.length===0)return null;const g=Math.max(0,a-z);if(t<0||t>=g)return null;let f=-l;for(const u of s){const b=u.height??w,_=f,D=f+b;if(f+=b+R,!(t<_||t>=D)){for(const k of u.items){if(k.interval){const F=H.JulianDate.toDate(k.interval.start).getTime(),j=H.JulianDate.toDate(k.interval.stop).getTime(),U=(F-M)/(m-M)*o,oe=(j-M)/(m-M)*o;if(e>=Math.max(0,U)&&e<=Math.min(o,oe))return{lane:u,item:k}}if(k.instant){const j=(H.JulianDate.toDate(k.instant).getTime()-M)/(m-M)*o,U=te(u,k,T);if(Math.abs(e-j)<=U.markerSize/2+2)return{lane:u,item:k}}}return null}}return null}function We(e,t,o,a){const{swimLanes:i,showSwimLanes:s,scrollTop:c}=a;if(!s||i.length===0||e>80)return null;const l=Math.max(0,o-z);if(t<0||t>=l)return null;let M=-c;for(const m of i){const T=m.height??w;if(t>=M&&t<M+T)return m;M+=T+R}return null}function $e(e,t,o){if(!o.showSwimLanes||o.swimLanes.length===0)return!1;const a=Math.max(0,t-z);return e>=0&&e<a}function Fe(e,t,o,a){const{startMs:i,endMs:s,currentMs:c,theme:l,maxTicks:M,swimLanes:m,showSwimLanes:T,reorderState:g}=a;let{scrollTop:f}=a;const u=(s-i)/1e3;if(u<=0)return f;e.fillStyle=l.backgroundColor,e.fillRect(0,0,t,o);const b=T&&m.length>0,D=b?Math.max(0,o-z):0;let k=0;if(b)for(const n of m)k+=(n.height??w)+R;const F=Math.max(0,k-D);if(f>F&&(f=F),f<0&&(f=0),b&&D>0){e.save(),e.beginPath(),e.rect(0,0,t,D),e.clip();let n=-f;const y=L=>(L-i)/(s-i)*t;for(const L of m){const S=L.height??w,A=n+S;if(A>0&&n<D){const h=L.style,J=(h==null?void 0:h.backgroundColor)??E.backgroundColor;J&&J!=="transparent"&&(e.fillStyle=J,e.fillRect(0,n,t,S)),e.strokeStyle=l.tickColor+"44",e.lineWidth=.5,e.beginPath(),e.moveTo(0,A),e.lineTo(t,A),e.stroke();for(const P of L.items){const p=te(L,P,l);if(P.interval){const re=H.JulianDate.toDate(P.interval.start).getTime(),Y=H.JulianDate.toDate(P.interval.stop).getTime(),W=y(re),$=y(Y),le=Math.max(0,W),ae=Math.min(t,$)-le;if(ae>0){e.globalAlpha=p.opacity,e.fillStyle=p.color;const be=3,De=n+be,ye=S-be*2;e.fillRect(le,De,ae,ye),p.borderWidth>0&&(e.strokeStyle=p.borderColor,e.lineWidth=p.borderWidth,e.strokeRect(le,De,ae,ye)),e.globalAlpha=1}}if(P.instant){const re=H.JulianDate.toDate(P.instant).getTime(),Y=y(re);if(Y>=-p.markerSize&&Y<=t+p.markerSize){const W=n+S/2,$=p.markerSize;e.globalAlpha=p.opacity,e.fillStyle=p.color,p.markerShape==="diamond"?(e.beginPath(),e.moveTo(Y,W-$/2),e.lineTo(Y+$/2,W),e.lineTo(Y,W+$/2),e.lineTo(Y-$/2,W),e.closePath(),e.fill()):p.markerShape==="circle"?(e.beginPath(),e.arc(Y,W,$/2,0,Math.PI*2),e.fill()):(e.strokeStyle=p.color,e.lineWidth=2,e.beginPath(),e.moveTo(Y,n+2),e.lineTo(Y,n+S-2),e.stroke()),e.globalAlpha=1}}}e.font=`${Math.min(11,S-4)}px system-ui, sans-serif`,e.textAlign="left",e.textBaseline="middle",e.fillStyle=(h==null?void 0:h.labelColor)??E.labelColor,e.fillText(L.label,Me,n+S/2)}if(n+=S+R,n>=D)break}if(g&&g.dragging){const L=g.currentY-g.dragStartY;let S=-f;for(let h=0;h<m.length&&h<g.insertIndex;h++)S+=(m[h].height??w)+R;e.strokeStyle=l.indicatorColor,e.lineWidth=2,e.beginPath(),e.moveTo(0,S),e.lineTo(t,S),e.stroke();const A=m.find(h=>h.id===g.dragLaneId);if(A){const h=A.height??w;let J=-f;for(const P of m){if(P.id===g.dragLaneId)break;J+=(P.height??w)+R}e.globalAlpha=.4,e.fillStyle=l.indicatorColor,e.fillRect(0,J+L,t,h),e.globalAlpha=1}}if(k>D){const L=t-K-2,S=D/k,A=Math.max(20,D*S),h=f/F*(D-A);e.fillStyle=l.tickColor+"22",e.fillRect(L,0,K,D),e.fillStyle=l.tickColor+"88",e.fillRect(L,h,K,A)}e.restore()}e.font=`${l.fontSize}px monospace`;const j=ee(i+u*500,u),U=e.measureText(j).width+24,oe=Math.max(U/t*u,u/1e3);let N=d[d.length-1],G=d.length-1;for(let n=0;n<d.length;n++)if(d[n]>oe){N=d[n],G=n;break}if(M!=null&&M>0)for(;G<d.length-1&&u/N>M;)G++,N=d[G];let O=0;for(let n=G-1;n>=0;n--)if(N%d[n]<1e-4){t*(d[n]/u)>=3&&(O=d[n]);break}let v=0;if(O>0){for(let n=0;n<d.length&&d[n]<O;n++)if(O%d[n]<1e-4&&t*(d[n]/u)>=3){v=d[n];break}}const de=he(i,u),X=(i-de)/1e3,ne=X+u,ie=n=>t*((n-X)/u);if(v>0){e.strokeStyle=l.tickColor,e.lineWidth=1;for(let n=Math.floor(X/v)*v;n<=ne;n=V(n,v)){const y=ie(n);e.beginPath(),e.moveTo(y,o-l.minorTickHeight),e.lineTo(y,o),e.stroke()}}if(O>0){e.strokeStyle=l.tickColor,e.lineWidth=1;for(let n=Math.floor(X/O)*O;n<=ne;n=V(n,O)){const y=ie(n);e.beginPath(),e.moveTo(y,o-l.minorTickHeight),e.lineTo(y,o),e.stroke()}}e.textAlign="center",e.textBaseline="bottom";let Se=-1/0;for(let n=Math.floor(X/N)*N;n<=ne+N;n=V(n,N)){const y=ie(n),L=de+n*1e3;e.strokeStyle=l.majorTickColor,e.lineWidth=1,e.beginPath(),e.moveTo(y,o-l.majorTickHeight),e.lineTo(y,o),e.stroke();const S=ee(L,u),A=e.measureText(S).width,h=y-A/2;h>Se&&(e.fillStyle=l.labelColor,e.fillText(S,y,o-l.majorTickHeight-4),Se=h+A+5)}const Te=(c-i)/(s-i)*t;return e.strokeStyle=l.indicatorColor,e.lineWidth=l.indicatorLineWidth,e.beginPath(),e.moveTo(Te,0),e.lineTo(Te,o),e.stroke(),f}r.DEFAULT_LANE_HEIGHT=w,r.DateTimeFormats=x,r.LABEL_PAD_LEFT=Me,r.LANE_GAP=R,r.MAX_SPAN_MS=ue,r.MIN_SPAN_MS=fe,r.MONTHS=q,r.SCROLLBAR_WIDTH=K,r.SWIM_LANE_SCROLL_SPEED=Pe,r.TICK_AREA_HEIGHT=z,r.TIC_SCALES=d,r.TickInterval=Q,r.calcEpochMs=he,r.clampSpan=ge,r.defaultSwimLaneStyle=E,r.defaultTheme=He,r.drawTimeline=Fe,r.formatDateTime=ce,r.formatTime=Ye,r.fromMilliseconds=pe,r.generateTicks=we,r.getDurationMs=se,r.hitTestLaneLabel=We,r.hitTestSwimLane=Oe,r.isInSwimLaneRegion=$e,r.makeLabel=ee,r.nextTic=V,r.positionToTime=Ee,r.resolveItemStyle=te,r.snapToTick=Ie,r.splitForDisplay=_e,r.timeToPosition=me,r.toDate=Z,r.toJulianDate=ke,r.toMilliseconds=I,r.totalSwimLaneHeight=Ne,r.twoD=C,r.zoomRange=Re,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})}));
+(function(a,B){typeof exports=="object"&&typeof module<"u"?B(exports,require("cesium")):typeof define=="function"&&define.amd?define(["exports","cesium"],B):(a=typeof globalThis<"u"?globalThis:a||self,B(a.CesiumTimelineCore={},a.Cesium))})(this,(function(a,B){"use strict";function Le(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const o in e)if(o!=="default"){const l=Object.getOwnPropertyDescriptor(e,o);Object.defineProperty(t,o,l.get?l:{enumerable:!0,get:()=>e[o]})}}return t.default=e,Object.freeze(t)}const L=Le(B),He={backgroundColor:"#1a1a1a",tickColor:"#666666",majorTickColor:"#999999",labelColor:"#cccccc",indicatorColor:"#d69826",indicatorLineWidth:5,majorTickHeight:10,minorTickHeight:5,fontSize:12,controlBarBackground:"#242424",controlBarBorder:"#333333",buttonColor:"#666666",buttonHoverColor:"#888888",buttonActiveColor:"#d69826",swimLaneItemBorderColor:"#666666",swimLaneItemBorderWidth:0};var x=(e=>(e[e.FIFTEEN_MIN=15]="FIFTEEN_MIN",e[e.THIRTY_MIN=30]="THIRTY_MIN",e[e.HOURLY=60]="HOURLY",e[e.CUSTOM=-1]="CUSTOM",e))(x||{});const E={color:"#4da6ff",borderColor:"#2980b9",borderWidth:1,opacity:.8,markerShape:"diamond",markerSize:10,labelColor:"#cccccc",backgroundColor:"transparent"},I=24;function ke(e){return e instanceof L.JulianDate?L.JulianDate.clone(e):L.JulianDate.fromDate(e)}function K(e){return e instanceof L.JulianDate?L.JulianDate.toDate(e):e}function P(e){return K(e).getTime()}function Ae(e){return L.JulianDate.fromDate(new Date(e))}function me(e,t){return P(t)-P(e)}const Ce=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],_e=["January","February","March","April","May","June","July","August","September","October","November","December"],ee={DEFAULT:"MMM DD YYYY HH:mm:ss",TWELVE_HR:"MMM DD YYYY hh:mm:ss A",ISO:"YYYY-MM-DD HH:mm:ss",US:"MM/DD/YYYY HH:mm",EU:"DD/MM/YYYY HH:mm",TIME_ONLY:"HH:mm:ss",TIME_12:"hh:mm:ss A"},Ye={LOCAL:"local",UTC:"UTC"};function Z(e,t){if(!t||t==="local"){const T=e.getFullYear(),u=e.getMonth(),h=e.getDate(),H=e.getHours(),k=H%12||12,d=e.getMinutes(),w=e.getSeconds(),N=e.getMilliseconds();return{yr:T,mo:u,day:h,hr24:H,hr12:k,min:d,sec:w,ms:N,ampm:H<12?"AM":"PM"}}const o=new Intl.DateTimeFormat("en-US",{timeZone:t,year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",hour12:!1}),l={};for(const T of o.formatToParts(e))T.type!=="literal"&&(l[T.type]=T.value);const i=parseInt(l.year),s=parseInt(l.month)-1,m=parseInt(l.day);let n=parseInt(l.hour);n===24&&(n=0);const c=n%12||12,f=parseInt(l.minute),M=parseInt(l.second),g=e.getMilliseconds();return{yr:i,mo:s,day:m,hr24:n,hr12:c,min:f,sec:M,ms:g,ampm:n<12?"AM":"PM"}}function Ee(e,t){var i;if(!t||t==="local")return null;const o=K(e);return((i=new Intl.DateTimeFormat("en-US",{timeZone:t,timeZoneName:"short"}).formatToParts(o).find(s=>s.type==="timeZoneName"))==null?void 0:i.value)??null}function ce(e,t=ee.DEFAULT,o){const l=K(e),{yr:i,mo:s,day:m,hr24:n,hr12:c,min:f,sec:M,ms:g,ampm:T}=Z(l,o),u=k=>String(k).padStart(2,"0"),h=k=>String(k).padStart(3,"0"),H={YYYY:String(i),YY:String(i).slice(-2),MMMM:_e[s],MMM:Ce[s],MM:u(s+1),M:String(s+1),DD:u(m),D:String(m),HH:u(n),H:String(n),hh:u(c),h:String(c),mm:u(f),ss:u(M),SSS:h(g),A:T,a:T.toLowerCase()};return t.replace(/YYYY|YY|MMMM|MMM|MM|M|DD|D|HH|H|hh|h|mm|ss|SSS|A|a/g,k=>H[k]??k)}function Ie(e=ee.DEFAULT){const t=["YYYY","YY","MMMM","MMM","MM","M","DD","D"],o=["HH","H","hh","h","mm","ss","SSS","A","a"],l=m=>m.replace(/\s{2,}/g," ").trim().replace(/^[\s\W]+|[\s\W]+$/g,"").trim();let i=e;for(const m of t)i=i.replace(m,"");let s=e;for(const m of o)s=s.replace(m,"");return{timeFormat:l(i),dateFormat:l(s)}}function Pe(e,t=!1){return ce(e,t?"HH:mm:ss":"HH:mm")}function fe(e,t,o,l){const i=P(e),s=P(t),m=P(o);if(m===s)return 0;const n=(i-s)/(m-s);return Math.max(0,Math.min(1,n))*l}function we(e,t,o,l){const i=Math.max(0,Math.min(1,e/l)),s=P(t),m=P(o),n=s+i*(m-s);return L.JulianDate.fromDate(new Date(n))}function Ne(e,t,o,l){const i=[],s=me(e,t),m=P(e);let n;typeof o=="number"&&o in x||typeof o=="number"?n=o*60*1e3:n=3600*1e3;const c=n*4;let f=m,M=0;for(;f<=m+s;){const g=M*n%c===0,T=fe(new Date(f),e,t,l);let u;if(g){const h=new Date(f),H=h.getHours().toString().padStart(2,"0"),k=h.getMinutes().toString().padStart(2,"0");u=`${H}:${k}`}i.push({position:T,isMajor:g,label:u}),f+=n,M++}return i}function Re(e,t,o=10){let l=t[0],i=Math.abs(l.position-e);for(const s of t){const m=Math.abs(s.position-e);m<i&&(i=m,l=s)}return i<=o?l.position:e}const ue=1e3,he=31536e9,b=[.001,.002,.005,.01,.02,.05,.1,.25,.5,1,2,5,10,15,30,60,120,300,600,900,1800,3600,7200,14400,21600,43200,86400,172800,345600,604800,1296e3,2592e3,5184e3,7776e3,15552e3,31536e3,63072e3,126144e3,15768e4,31536e4,63072e4,126144e4,15768e5,31536e5,63072e5,126144e5,15768e6,31536e6],z=36,O=1,Me=6,q=6,Oe=.3,V=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];function _(e){return e<10?`0${e}`:`${e}`}function te(e,t,o){const l=new Date(e),{yr:i,mo:s,day:m,hr24:n,min:c,sec:f,ms:M}=Z(l,o);if(t>31536e4)return`${i}`;if(t>31536e3)return`${V[s]} ${i}`;if(t>604800)return`${V[s]} ${m}`;if(t>86400)return`${V[s]} ${m} ${_(n)}:${_(c)}`;if(t>3600)return`${_(n)}:${_(c)}`;if(t>60)return`${_(n)}:${_(c)}:${_(f)}`;const g=M>0?`.${String(M).padStart(3,"0")}`:"";return`${_(n)}:${_(c)}:${_(f)}${g}`}function ge(e,t,o){const l=new Date(e);if(!o||o==="local"){const c=l.getFullYear(),f=l.getMonth(),M=l.getDate();return t>31536e4?new Date(Math.floor(c/100)*100,0).getTime():t>31536e3?new Date(Math.floor(c/10)*10,0).getTime():t>86400?new Date(c,0).getTime():new Date(c,f,M).getTime()}const{yr:i,hr24:s,min:m,sec:n}=Z(l,o);return t>31536e4?Date.UTC(Math.floor(i/100)*100,0,1):t>31536e3?Date.UTC(Math.floor(i/10)*10,0,1):t>86400?Date.UTC(i,0,1):e-(s*3600+m*60+n)*1e3}function Q(e,t){return Math.ceil(e/t+.5)*t}function oe(e,t,o){var l,i,s,m,n,c,f,M,g,T,u,h;return{color:((l=t.style)==null?void 0:l.color)??((i=e.style)==null?void 0:i.color)??E.color,borderColor:((s=t.style)==null?void 0:s.borderColor)??((m=e.style)==null?void 0:m.borderColor)??(o==null?void 0:o.swimLaneItemBorderColor)??E.borderColor,borderWidth:((n=t.style)==null?void 0:n.borderWidth)??((c=e.style)==null?void 0:c.borderWidth)??(o==null?void 0:o.swimLaneItemBorderWidth)??E.borderWidth,opacity:((f=t.style)==null?void 0:f.opacity)??((M=e.style)==null?void 0:M.opacity)??E.opacity,markerShape:((g=t.style)==null?void 0:g.markerShape)??((T=e.style)==null?void 0:T.markerShape)??E.markerShape,markerSize:((u=t.style)==null?void 0:u.markerSize)??((h=e.style)==null?void 0:h.markerSize)??E.markerSize}}function Te(e){return Math.max(ue,Math.min(he,e))}function Fe(e,t,o){const l=t-e,i=(e+t)/2,s=Te(l*o);return{startMs:i-s/2,endMs:i+s/2}}function We(e){let t=0;for(const o of e)t+=(o.height??I)+O;return t}function $e(e,t,o,l,i){const{swimLanes:s,showSwimLanes:m,scrollTop:n,startMs:c,endMs:f,theme:M}=i;if(!m||s.length===0)return null;const g=Math.max(0,l-z);if(t<0||t>=g)return null;let T=-n;for(const u of s){const h=u.height??I,H=T,k=T+h;if(T+=h+O,!(t<H||t>=k)){for(const d of u.items){if(d.interval){const w=L.JulianDate.toDate(d.interval.start).getTime(),N=L.JulianDate.toDate(d.interval.stop).getTime(),j=(w-c)/(f-c)*o,ne=(N-c)/(f-c)*o;if(e>=Math.max(0,j)&&e<=Math.min(o,ne))return{lane:u,item:d}}if(d.instant){const N=(L.JulianDate.toDate(d.instant).getTime()-c)/(f-c)*o,j=oe(u,d,M);if(Math.abs(e-N)<=j.markerSize/2+2)return{lane:u,item:d}}}return null}}return null}function Je(e,t,o,l){const{swimLanes:i,showSwimLanes:s,scrollTop:m}=l;if(!s||i.length===0||e>80)return null;const n=Math.max(0,o-z);if(t<0||t>=n)return null;let c=-m;for(const f of i){const M=f.height??I;if(t>=c&&t<c+M)return f;c+=M+O}return null}function Ue(e,t,o){if(!o.showSwimLanes||o.swimLanes.length===0)return!1;const l=Math.max(0,t-z);return e>=0&&e<l}function Be(e,t,o,l){const{startMs:i,endMs:s,currentMs:m,theme:n,maxTicks:c,swimLanes:f,showSwimLanes:M,reorderState:g,timezone:T}=l;let{scrollTop:u}=l;const h=(s-i)/1e3;if(h<=0)return u;e.fillStyle=n.backgroundColor,e.fillRect(0,0,t,o);const H=M&&f.length>0,d=H?Math.max(0,o-z):0;let w=0;if(H)for(const r of f)w+=(r.height??I)+O;const N=Math.max(0,w-d);if(u>N&&(u=N),u<0&&(u=0),H&&d>0){e.save(),e.beginPath(),e.rect(0,0,t,d),e.clip();let r=-u;const y=p=>(p-i)/(s-i)*t;for(const p of f){const D=p.height??I,C=r+D;if(C>0&&r<d){const S=p.style,U=(S==null?void 0:S.backgroundColor)??E.backgroundColor;U&&U!=="transparent"&&(e.fillStyle=U,e.fillRect(0,r,t,D)),e.strokeStyle=n.tickColor+"44",e.lineWidth=.5,e.beginPath(),e.moveTo(0,C),e.lineTo(t,C),e.stroke();for(const R of p.items){const A=oe(p,R,n);if(R.interval){const ae=L.JulianDate.toDate(R.interval.start).getTime(),Y=L.JulianDate.toDate(R.interval.stop).getTime(),$=y(ae),J=y(Y),le=Math.max(0,$),se=Math.min(t,J)-le;if(se>0){e.globalAlpha=A.opacity,e.fillStyle=A.color;const De=3,ye=r+De,pe=D-De*2;e.fillRect(le,ye,se,pe),A.borderWidth>0&&(e.strokeStyle=A.borderColor,e.lineWidth=A.borderWidth,e.strokeRect(le,ye,se,pe)),e.globalAlpha=1}}if(R.instant){const ae=L.JulianDate.toDate(R.instant).getTime(),Y=y(ae);if(Y>=-A.markerSize&&Y<=t+A.markerSize){const $=r+D/2,J=A.markerSize;e.globalAlpha=A.opacity,e.fillStyle=A.color,A.markerShape==="diamond"?(e.beginPath(),e.moveTo(Y,$-J/2),e.lineTo(Y+J/2,$),e.lineTo(Y,$+J/2),e.lineTo(Y-J/2,$),e.closePath(),e.fill()):A.markerShape==="circle"?(e.beginPath(),e.arc(Y,$,J/2,0,Math.PI*2),e.fill()):(e.strokeStyle=A.color,e.lineWidth=2,e.beginPath(),e.moveTo(Y,r+2),e.lineTo(Y,r+D-2),e.stroke()),e.globalAlpha=1}}}e.font=`${Math.min(11,D-4)}px system-ui, sans-serif`,e.textAlign="left",e.textBaseline="middle",e.fillStyle=(S==null?void 0:S.labelColor)??E.labelColor,e.fillText(p.label,Me,r+D/2)}if(r+=D+O,r>=d)break}if(g&&g.dragging){const p=g.currentY-g.dragStartY;let D=-u;for(let S=0;S<f.length&&S<g.insertIndex;S++)D+=(f[S].height??I)+O;e.strokeStyle=n.indicatorColor,e.lineWidth=2,e.beginPath(),e.moveTo(0,D),e.lineTo(t,D),e.stroke();const C=f.find(S=>S.id===g.dragLaneId);if(C){const S=C.height??I;let U=-u;for(const R of f){if(R.id===g.dragLaneId)break;U+=(R.height??I)+O}e.globalAlpha=.4,e.fillStyle=n.indicatorColor,e.fillRect(0,U+p,t,S),e.globalAlpha=1}}if(w>d){const p=t-q-2,D=d/w,C=Math.max(20,d*D),S=u/N*(d-C);e.fillStyle=n.tickColor+"22",e.fillRect(p,0,q,d),e.fillStyle=n.tickColor+"88",e.fillRect(p,S,q,C)}e.restore()}e.font=`${n.fontSize}px monospace`;const j=te(i+h*500,h,T),ne=e.measureText(j).width+24,ze=Math.max(ne/t*h,h/1e3);let F=b[b.length-1],v=b.length-1;for(let r=0;r<b.length;r++)if(b[r]>ze){F=b[r],v=r;break}if(c!=null&&c>0)for(;v<b.length-1&&h/F>c;)v++,F=b[v];let W=0;for(let r=v-1;r>=0;r--)if(F%b[r]<1e-4){t*(b[r]/h)>=3&&(W=b[r]);break}let G=0;if(W>0){for(let r=0;r<b.length&&b[r]<W;r++)if(W%b[r]<1e-4&&t*(b[r]/h)>=3){G=b[r];break}}const de=ge(i,h,T),X=(i-de)/1e3,ie=X+h,re=r=>t*((r-X)/h);if(G>0){e.strokeStyle=n.tickColor,e.lineWidth=1;for(let r=Math.floor(X/G)*G;r<=ie;r=Q(r,G)){const y=re(r);e.beginPath(),e.moveTo(y,o-n.minorTickHeight),e.lineTo(y,o),e.stroke()}}if(W>0){e.strokeStyle=n.tickColor,e.lineWidth=1;for(let r=Math.floor(X/W)*W;r<=ie;r=Q(r,W)){const y=re(r);e.beginPath(),e.moveTo(y,o-n.minorTickHeight),e.lineTo(y,o),e.stroke()}}e.textAlign="center",e.textBaseline="bottom";let Se=-1/0;for(let r=Math.floor(X/F)*F;r<=ie+F;r=Q(r,F)){const y=re(r),p=de+r*1e3;e.strokeStyle=n.majorTickColor,e.lineWidth=1,e.beginPath(),e.moveTo(y,o-n.majorTickHeight),e.lineTo(y,o),e.stroke();const D=te(p,h,T),C=e.measureText(D).width,S=y-C/2;S>Se&&(e.fillStyle=n.labelColor,e.fillText(D,y,o-n.majorTickHeight-4),Se=S+C+5)}const be=(m-i)/(s-i)*t;return e.strokeStyle=n.indicatorColor,e.lineWidth=n.indicatorLineWidth,e.beginPath(),e.moveTo(be,0),e.lineTo(be,o),e.stroke(),u}a.DEFAULT_LANE_HEIGHT=I,a.DateTimeFormats=ee,a.LABEL_PAD_LEFT=Me,a.LANE_GAP=O,a.MAX_SPAN_MS=he,a.MIN_SPAN_MS=ue,a.MONTHS=V,a.SCROLLBAR_WIDTH=q,a.SWIM_LANE_SCROLL_SPEED=Oe,a.TICK_AREA_HEIGHT=z,a.TIC_SCALES=b,a.TickInterval=x,a.Timezones=Ye,a.calcEpochMs=ge,a.clampSpan=Te,a.defaultSwimLaneStyle=E,a.defaultTheme=He,a.drawTimeline=Be,a.formatDateTime=ce,a.formatTime=Pe,a.fromMilliseconds=Ae,a.generateTicks=Ne,a.getDateParts=Z,a.getDurationMs=me,a.getTimezoneAbbr=Ee,a.hitTestLaneLabel=Je,a.hitTestSwimLane=$e,a.isInSwimLaneRegion=Ue,a.makeLabel=te,a.nextTic=Q,a.positionToTime=we,a.resolveItemStyle=oe,a.snapToTick=Re,a.splitForDisplay=Ie,a.timeToPosition=fe,a.toDate=K,a.toJulianDate=ke,a.toMilliseconds=P,a.totalSwimLaneHeight=We,a.twoD=_,a.zoomRange=Fe,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})}));

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as Cesium from 'cesium';
 
 /** Pick a round epoch near startMs so tick offsets are clean integers (mirrors Cesium). */
-export declare function calcEpochMs(startMs: number, durationSec: number): number;
+export declare function calcEpochMs(startMs: number, durationSec: number, timezone?: string): number;
 
 /** Clamp a time span to the allowed zoom range. */
 export declare function clampSpan(span: number): number;
@@ -18,6 +18,8 @@ export declare interface ControlsBaseProps {
     multiplier: number;
     /** @see TimelineBaseProps.dateTimeFormat */
     dateTimeFormat?: string;
+    /** @see TimelineBaseProps.timezone */
+    timezone?: string;
     /** @see TimelineBaseProps.onDateTimeClick */
     onDateTimeClick?: () => void;
     /** Toggle play / pause. */
@@ -36,10 +38,14 @@ export declare interface ControlsBaseProps {
     onResetSpeed: () => void;
     /** Whether the needle is near the current wall-clock time (within 10 s). */
     isLive: boolean;
-    /** Whether to show the ⏮ jump-to-start button (true when startTime prop was provided). */
+    /** Whether to enable the ⏮ jump-to-start button (true when startTime prop was provided). */
     hasStartTime: boolean;
-    /** Whether to show the ⏭ jump-to-end button (true when endTime prop was provided). */
+    /** Whether to enable the ⏭ jump-to-end button (true when endTime prop was provided). */
     hasEndTime: boolean;
+    /** Whether to show the ⏮ jump-to-start button at all. @default true */
+    showJumpToStart?: boolean;
+    /** Whether to show the ⏭ jump-to-end button at all. @default true */
+    showJumpToEnd?: boolean;
     /** Resolved theme object applied to control bar elements. */
     theme: TimelineTheme;
     /** Whether swim lanes are currently visible. When defined, the chevron toggle is rendered. */
@@ -48,6 +54,19 @@ export declare interface ControlsBaseProps {
     onToggleSwimLanes?: () => void;
 }
 
+/** Decomposed date/time fields extracted in a specific timezone. `mo` is 0-indexed. */
+export declare interface DateParts {
+    yr: number;
+    mo: number;
+    day: number;
+    hr24: number;
+    hr12: number;
+    min: number;
+    sec: number;
+    ms: number;
+    ampm: 'AM' | 'PM';
+}
+
 /** Built-in format presets. Pass one of these (or any custom string) as `dateTimeFormat`. */
 export declare const DateTimeFormats: {
     /** e.g. "Feb 24 2026 14:04:07" — default */
@@ -109,7 +128,7 @@ export declare function drawTimeline(ctx: CanvasRenderingContext2D, w: number, h
  *  A     – AM / PM uppercase
  *  a     – am / pm lowercase
  */
-export declare function formatDateTime(date: Cesium.JulianDate | Date, format?: string): string;
+export declare function formatDateTime(date: Cesium.JulianDate | Date, format?: string, timezone?: string): string;
 
 /** @deprecated Use formatDateTime instead */
 export declare function formatTime(date: Cesium.JulianDate | Date, includeSeconds?: boolean): string;
@@ -118,8 +137,21 @@ export declare function fromMilliseconds(ms: number): Cesium.JulianDate;
 
 export declare function generateTicks(startTime: Cesium.JulianDate | Date, endTime: Cesium.JulianDate | Date, tickInterval: TickInterval | number, width: number): Tick[];
 
+/**
+ * Extract date/time components in the given timezone.
+ * When `timezone` is `undefined` or `'local'`, the browser's local time methods are used.
+ * Otherwise, `Intl.DateTimeFormat#formatToParts` is used for timezone-accurate extraction.
+ */
+export declare function getDateParts(date: Date, timezone?: string): DateParts;
+
 export declare function getDurationMs(startTime: Cesium.JulianDate | Date, endTime: Cesium.JulianDate | Date): number;
 
+/**
+ * Return the short timezone abbreviation for the given date in the given timezone,
+ * e.g. `"UTC"`, `"EST"`, `"PDT"`. Returns `null` when timezone is `undefined` or `'local'`.
+ */
+export declare function getTimezoneAbbr(date: Cesium.JulianDate | Date, timezone?: string): string | null;
+
 /** Check if a Y coordinate is in the swim lane label area (leftmost ~80px). */
 export declare function hitTestLaneLabel(canvasX: number, canvasY: number, canvasH: number, state: Pick<TimelineRenderState, 'swimLanes' | 'showSwimLanes' | 'scrollTop'>): SwimLane | null;
 
@@ -137,7 +169,7 @@ export declare const LABEL_PAD_LEFT = 6;
 /** Gap in pixels between swim lane rows. */
 export declare const LANE_GAP = 1;
 
-export declare function makeLabel(ms: number, durationSec: number): string;
+export declare function makeLabel(ms: number, durationSec: number, timezone?: string): string;
 
 /** Maximum visible span: ~1 000 years — stays within TIC_SCALES range. */
 export declare const MAX_SPAN_MS = 31536000000000;
@@ -293,6 +325,10 @@ export declare interface TimelineBaseProps {
     showLabels?: boolean;
     /** Whether to render the transport control bar above the canvas. @default true */
     showControls?: boolean;
+    /** Whether to show the ⏮ jump-to-start button in the control bar. @default true */
+    showJumpToStart?: boolean;
+    /** Whether to show the ⏭ jump-to-end button in the control bar. @default true */
+    showJumpToEnd?: boolean;
     /** When `true`, ticks snap to round time boundaries during scrub. */
     snapToTicks?: boolean;
     /** Whether the user can scrub / drag the timeline. @default true */
@@ -331,6 +367,14 @@ export declare interface TimelineBaseProps {
      * Defaults to [1, 2, 4, 8, 16, 32].
      */
     rwSpeeds?: number[];
+    /**
+     * IANA timezone string used for all datetime display on the timeline.
+     * Examples: `'UTC'`, `'America/New_York'`, `'Europe/London'`.
+     * Use `'local'` (default) to use the browser's local timezone.
+     * When set to a value other than `'local'`, a timezone abbreviation label
+     * (e.g. "UTC", "EST", "PDT") is shown to the right of the date display.
+     */
+    timezone?: string;
     /** Partial theme overrides merged with the default theme. */
     theme?: Partial<TimelineTheme>;
     /**
@@ -378,6 +422,8 @@ export declare interface TimelineRenderState {
     showSwimLanes: boolean;
     scrollTop: number;
     reorderState: ReorderState | null;
+    /** @see TimelineBaseProps.timezone */
+    timezone?: string;
 }
 
 export declare interface TimelineTheme {
@@ -409,6 +455,14 @@ export declare interface TimePosition {
 
 export declare function timeToPosition(time: Cesium.JulianDate | Date, startTime: Cesium.JulianDate | Date, endTime: Cesium.JulianDate | Date, width: number): number;
 
+/** Convenience constants for the `timezone` prop. */
+export declare const Timezones: {
+    /** Use the browser's local timezone (default behavior). */
+    readonly LOCAL: "local";
+    /** Coordinated Universal Time. */
+    readonly UTC: "UTC";
+};
+
 export declare function toDate(date: Cesium.JulianDate | Date): Date;
 
 export declare function toJulianDate(date: Cesium.JulianDate | Date): Cesium.JulianDate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kteneyck/cesium-timeline-core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Framework-agnostic core logic for the Cesium timeline component",
   "license": "MIT",
   "author": "kteneyck",