@accelint/design-toolkit 9.9.2 → 9.11.0

package/dist/components/gantt/hooks/use-resize-intersection-effect/index.js

@@ -0,0 +1,50 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { useEffect, useReducer } from "react";
+
+//#region src/components/gantt/hooks/use-resize-intersection-effect/index.ts
+function getResizeElementsToObserve(timelineChunks, timelineContainerElement) {
+	if (timelineChunks.length < 3) return [null, null];
+	const expansionThresholdChunk = timelineChunks[timelineChunks.length - 1];
+	const contractionThresholdChunk = timelineChunks[timelineChunks.length - 3];
+	return [timelineContainerElement.querySelector(`[data-timestamp="${expansionThresholdChunk?.timestampMs}"]`), timelineContainerElement.querySelector(`[data-timestamp="${contractionThresholdChunk?.timestampMs}"]`)];
+}
+function useResizeIntersectionEffect({ timelineContainerElement, timelineChunks }) {
+	const [, bumpLayoutTick] = useReducer((prev) => prev + 1, 0);
+	useEffect(() => {
+		if (!timelineContainerElement) return;
+		const [expansionElement, contractionElement] = getResizeElementsToObserve(timelineChunks, timelineContainerElement);
+		if (!(expansionElement && contractionElement)) return;
+		const intersectionObserverOptions = {
+			root: timelineContainerElement,
+			threshold: 0
+		};
+		const intersectionObserver = new IntersectionObserver((entries) => {
+			for (const entry of entries) {
+				const isExpansionElement = entry.target === expansionElement;
+				const isContractionElement = entry.target === contractionElement;
+				if (isExpansionElement && entry.isIntersecting || isContractionElement && !entry.isIntersecting) bumpLayoutTick();
+			}
+		}, intersectionObserverOptions);
+		intersectionObserver.observe(expansionElement);
+		intersectionObserver.observe(contractionElement);
+		return () => {
+			intersectionObserver.disconnect();
+		};
+	}, [timelineContainerElement, timelineChunks]);
+}
+
+//#endregion
+export { useResizeIntersectionEffect };
+//# sourceMappingURL=index.js.map

package/dist/components/gantt/hooks/use-resize-intersection-effect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["intersectionObserverOptions: IntersectionObserverInit"],"sources":["../../../../../src/components/gantt/hooks/use-resize-intersection-effect/index.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useEffect, useReducer } from 'react';\nimport type { GanttTimelineChunkObject } from '../../types';\n\ntype UseResizeEffectProps = {\n  timelineContainerElement: HTMLDivElement | null;\n  timelineChunks: GanttTimelineChunkObject[];\n};\n\nfunction getResizeElementsToObserve(\n  timelineChunks: GanttTimelineChunkObject[],\n  timelineContainerElement: HTMLDivElement,\n): [Element | null, Element | null] {\n  if (timelineChunks.length < 3) {\n    return [null, null];\n  }\n\n  const expansionThresholdChunk = timelineChunks[timelineChunks.length - 1];\n  const contractionThresholdChunk = timelineChunks[timelineChunks.length - 3];\n\n  const expansionThresholdElement = timelineContainerElement.querySelector(\n    `[data-timestamp=\"${expansionThresholdChunk?.timestampMs}\"]`,\n  );\n  const contractionThresholdElement = timelineContainerElement.querySelector(\n    `[data-timestamp=\"${contractionThresholdChunk?.timestampMs}\"]`,\n  );\n\n  return [expansionThresholdElement, contractionThresholdElement];\n}\n\nexport function useResizeIntersectionEffect({\n  timelineContainerElement,\n  timelineChunks,\n}: UseResizeEffectProps) {\n  const [, bumpLayoutTick] = useReducer((prev) => prev + 1, 0);\n\n  useEffect(() => {\n    if (!timelineContainerElement) {\n      return;\n    }\n\n    const [expansionElement, contractionElement] = getResizeElementsToObserve(\n      timelineChunks,\n      timelineContainerElement,\n    );\n\n    const bothElementsDefined = expansionElement && contractionElement;\n\n    if (!bothElementsDefined) {\n      return;\n    }\n\n    const intersectionObserverOptions: IntersectionObserverInit = {\n      root: timelineContainerElement,\n      threshold: 0,\n    };\n\n    // IntersectionObserver fires an initial callback on observe(). This does not\n    // cause a loop because a bump re-renders with the new container width,\n    // producing new chunks whose expansion element is offscreen (not intersecting)\n    // and whose contraction element is onscreen (intersecting) — neither condition\n    // triggers another bump.\n    const intersectionObserver = new IntersectionObserver((entries) => {\n      for (const entry of entries) {\n        const isExpansionElement = entry.target === expansionElement;\n        const isContractionElement = entry.target === contractionElement;\n\n        const shouldBumpLayoutTick =\n          (isExpansionElement && entry.isIntersecting) ||\n          (isContractionElement && !entry.isIntersecting);\n\n        if (shouldBumpLayoutTick) {\n          bumpLayoutTick();\n        }\n      }\n    }, intersectionObserverOptions);\n\n    intersectionObserver.observe(expansionElement);\n    intersectionObserver.observe(contractionElement);\n\n    return () => {\n      intersectionObserver.disconnect();\n    };\n  }, [timelineContainerElement, timelineChunks]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAqBA,SAAS,2BACP,gBACA,0BACkC;AAClC,KAAI,eAAe,SAAS,EAC1B,QAAO,CAAC,MAAM,KAAK;CAGrB,MAAM,0BAA0B,eAAe,eAAe,SAAS;CACvE,MAAM,4BAA4B,eAAe,eAAe,SAAS;AASzE,QAAO,CAP2B,yBAAyB,cACzD,oBAAoB,yBAAyB,YAAY,IAC1D,EACmC,yBAAyB,cAC3D,oBAAoB,2BAA2B,YAAY,IAC5D,CAE8D;;AAGjE,SAAgB,4BAA4B,EAC1C,0BACA,kBACuB;CACvB,MAAM,GAAG,kBAAkB,YAAY,SAAS,OAAO,GAAG,EAAE;AAE5D,iBAAgB;AACd,MAAI,CAAC,yBACH;EAGF,MAAM,CAAC,kBAAkB,sBAAsB,2BAC7C,gBACA,yBACD;AAID,MAAI,EAFwB,oBAAoB,oBAG9C;EAGF,MAAMA,8BAAwD;GAC5D,MAAM;GACN,WAAW;GACZ;EAOD,MAAM,uBAAuB,IAAI,sBAAsB,YAAY;AACjE,QAAK,MAAM,SAAS,SAAS;IAC3B,MAAM,qBAAqB,MAAM,WAAW;IAC5C,MAAM,uBAAuB,MAAM,WAAW;AAM9C,QAHG,sBAAsB,MAAM,kBAC5B,wBAAwB,CAAC,MAAM,eAGhC,iBAAgB;;KAGnB,4BAA4B;AAE/B,uBAAqB,QAAQ,iBAAiB;AAC9C,uBAAqB,QAAQ,mBAAmB;AAEhD,eAAa;AACX,wBAAqB,YAAY;;IAElC,CAAC,0BAA0B,eAAe,CAAC"}

package/dist/components/gantt/hooks/use-root-element-height/index.d.ts

@@ -0,0 +1,5 @@
+//#region src/components/gantt/hooks/use-root-element-height/index.d.ts
+declare function useRootElementHeight(): number;
+//#endregion
+export { useRootElementHeight };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/gantt/hooks/use-root-element-height/index.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { useGanttContext } from "../../context/index.js";
+
+//#region src/components/gantt/hooks/use-root-element-height/index.ts
+function useRootElementHeight() {
+	const { rootElement } = useGanttContext();
+	return rootElement?.clientHeight ?? 0;
+}
+
+//#endregion
+export { useRootElementHeight };
+//# sourceMappingURL=index.js.map

package/dist/components/gantt/hooks/use-root-element-height/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/components/gantt/hooks/use-root-element-height/index.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useGanttContext } from '@/components/gantt/context';\n\nexport function useRootElementHeight() {\n  const { rootElement } = useGanttContext();\n\n  const rootElementHeight = rootElement?.clientHeight ?? 0;\n\n  return rootElementHeight;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAgB,uBAAuB;CACrC,MAAM,EAAE,gBAAgB,iBAAiB;AAIzC,QAF0B,aAAa,gBAAgB"}

package/dist/components/gantt/hooks/use-scrollbar-height/index.d.ts

@@ -0,0 +1,5 @@
+//#region src/components/gantt/hooks/use-scrollbar-height/index.d.ts
+declare function useScrollbarHeight(): number;
+//#endregion
+export { useScrollbarHeight };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/gantt/hooks/use-scrollbar-height/index.js

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { useGanttContext } from "../../context/index.js";
+import { useEffect, useState } from "react";
+
+//#region src/components/gantt/hooks/use-scrollbar-height/index.ts
+function useScrollbarHeight() {
+	const { ganttContentElement } = useGanttContext();
+	const [scrollbarHeight, setScrollbarHeight] = useState(0);
+	useEffect(() => {
+		if (!ganttContentElement) return;
+		const calculateScrollbarHeight = () => {
+			setScrollbarHeight(ganttContentElement.offsetHeight - ganttContentElement.clientHeight);
+		};
+		calculateScrollbarHeight();
+		const resizeObserver = new ResizeObserver(() => {
+			calculateScrollbarHeight();
+		});
+		resizeObserver.observe(ganttContentElement);
+		return () => {
+			resizeObserver.disconnect();
+		};
+	}, [ganttContentElement]);
+	return scrollbarHeight;
+}
+
+//#endregion
+export { useScrollbarHeight };
+//# sourceMappingURL=index.js.map

package/dist/components/gantt/hooks/use-scrollbar-height/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/components/gantt/hooks/use-scrollbar-height/index.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useEffect, useState } from 'react';\nimport { useGanttContext } from '../../context';\n\nexport function useScrollbarHeight() {\n  const { ganttContentElement } = useGanttContext();\n  const [scrollbarHeight, setScrollbarHeight] = useState<number>(0);\n\n  useEffect(() => {\n    if (!ganttContentElement) {\n      return;\n    }\n\n    const calculateScrollbarHeight = () => {\n      const height =\n        ganttContentElement.offsetHeight - ganttContentElement.clientHeight;\n      setScrollbarHeight(height);\n    };\n\n    // Calculate on mount\n    calculateScrollbarHeight();\n\n    // Set up ResizeObserver to recalculate when dimensions change. This is\n    // needed because the height of ganttContentElement can change following\n    // a re-render. This hook does not access any of the values from\n    // TemporalDataProvider which would affect the height of ganttContentElement,\n    // so a ResizeObserver is used to detect changes.\n    const resizeObserver = new ResizeObserver(() => {\n      calculateScrollbarHeight();\n    });\n\n    resizeObserver.observe(ganttContentElement);\n\n    // Clean up observer on unmount\n    return () => {\n      resizeObserver.disconnect();\n    };\n  }, [ganttContentElement]);\n\n  return scrollbarHeight;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,SAAgB,qBAAqB;CACnC,MAAM,EAAE,wBAAwB,iBAAiB;CACjD,MAAM,CAAC,iBAAiB,sBAAsB,SAAiB,EAAE;AAEjE,iBAAgB;AACd,MAAI,CAAC,oBACH;EAGF,MAAM,iCAAiC;AAGrC,sBADE,oBAAoB,eAAe,oBAAoB,aAC/B;;AAI5B,4BAA0B;EAO1B,MAAM,iBAAiB,IAAI,qBAAqB;AAC9C,6BAA0B;IAC1B;AAEF,iBAAe,QAAQ,oBAAoB;AAG3C,eAAa;AACX,kBAAe,YAAY;;IAE5B,CAAC,oBAAoB,CAAC;AAEzB,QAAO"}

package/dist/components/gantt/hooks/use-total-data-region-thresholds/index.d.ts

@@ -0,0 +1,19 @@
+//#region src/components/gantt/hooks/use-total-data-region-thresholds/index.d.ts
+type UseTotalDataRegionThresholdsProps = {
+  totalRowsCount: number;
+  verticalScrollElement: HTMLDivElement | null;
+};
+/**
+ * A hook that notifies the Gantt component consumer when certain thresholds are
+ * reached in the total data region currently being virtualized.
+ *
+ * This allows the consumer to perform actions when the rendered region reaches
+ * certain thresholds (like fetching additional data to provide to the Gantt component).
+ */
+declare function useTotalDataRegionThresholds({
+  totalRowsCount,
+  verticalScrollElement
+}: UseTotalDataRegionThresholdsProps): void;
+//#endregion
+export { useTotalDataRegionThresholds };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/gantt/hooks/use-total-data-region-thresholds/index.js

@@ -0,0 +1,87 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { selectors } from "../../store.js";
+import { useGanttStore } from "../../context/store/index.js";
+import { useGanttContext } from "../../context/index.js";
+import { useTemporalDataContext } from "../../context/temporal-data/index.js";
+import { deriveRenderedSlice } from "../../utils/layout.js";
+import { deriveRenderedRegion, deriveRowIndexThresholds, deriveTemporalThresholds, deriveTotalDataRegion, examineThresholds, shouldExamineThresholds } from "../../utils/thresholds.js";
+import { useEffect, useRef } from "react";
+
+//#region src/components/gantt/hooks/use-total-data-region-thresholds/index.ts
+function toThresholdKey(item) {
+	return `${item.axis}:${item.direction}:${item.value}`;
+}
+function createThresholdProjection() {
+	const state = /* @__PURE__ */ new Set();
+	function update(metThresholds) {
+		const keys = [];
+		const newlyEntered = [];
+		for (let i = 0; i < metThresholds.length; i++) {
+			const item = metThresholds[i];
+			if (!item) continue;
+			const key = toThresholdKey(item);
+			keys.push(key);
+			if (!state.has(key)) newlyEntered.push(item);
+		}
+		state.clear();
+		for (const key of keys) state.add(key);
+		return newlyEntered;
+	}
+	function reset() {
+		state.clear();
+	}
+	return {
+		update,
+		reset
+	};
+}
+/**
+* A hook that notifies the Gantt component consumer when certain thresholds are
+* reached in the total data region currently being virtualized.
+*
+* This allows the consumer to perform actions when the rendered region reaches
+* certain thresholds (like fetching additional data to provide to the Gantt component).
+*/
+function useTotalDataRegionThresholds({ totalRowsCount, verticalScrollElement }) {
+	const projectionRef = useRef(null);
+	if (projectionRef.current === null) projectionRef.current = createThresholdProjection();
+	const roundedCurrentRowScrollPx = useGanttStore(selectors.roundedCurrentRowScrollPx);
+	const { totalBounds, renderedRegionBounds, threshold, onThresholdMet, timescale } = useTemporalDataContext();
+	const { rowHeightPx } = useGanttContext();
+	useEffect(() => {
+		if (!threshold || !onThresholdMet || !shouldExamineThresholds(totalRowsCount, verticalScrollElement, threshold)) {
+			projectionRef.current?.reset();
+			return;
+		}
+		const totalDataRegion = deriveTotalDataRegion(totalRowsCount, totalBounds);
+		const metThresholds = examineThresholds(deriveRenderedRegion(deriveRenderedSlice(roundedCurrentRowScrollPx, rowHeightPx, verticalScrollElement?.clientHeight ?? 0), renderedRegionBounds), deriveTemporalThresholds(threshold, totalDataRegion, timescale), deriveRowIndexThresholds(threshold, totalDataRegion));
+		const newlyMet = projectionRef.current?.update(metThresholds) ?? [];
+		if (newlyMet.length > 0) onThresholdMet(newlyMet);
+	}, [
+		totalRowsCount,
+		totalBounds,
+		renderedRegionBounds,
+		threshold,
+		onThresholdMet,
+		timescale,
+		roundedCurrentRowScrollPx,
+		verticalScrollElement,
+		rowHeightPx
+	]);
+}
+
+//#endregion
+export { useTotalDataRegionThresholds };
+//# sourceMappingURL=index.js.map

package/dist/components/gantt/hooks/use-total-data-region-thresholds/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["keys: string[]","newlyEntered: GanttMetThresholdData[]"],"sources":["../../../../../src/components/gantt/hooks/use-total-data-region-thresholds/index.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { useGanttStore } from '@/components/gantt/context/store';\nimport { useTemporalDataContext } from '@/components/gantt/context/temporal-data';\nimport { selectors } from '@/components/gantt/store';\nimport { deriveRenderedSlice } from '@/components/gantt/utils/layout';\nimport {\n  deriveRenderedRegion,\n  deriveRowIndexThresholds,\n  deriveTemporalThresholds,\n  deriveTotalDataRegion,\n  examineThresholds,\n  shouldExamineThresholds,\n} from '@/components/gantt/utils/thresholds';\nimport { useGanttContext } from '../../context';\nimport type { GanttMetThresholdData } from '@/components/gantt/types';\n\nfunction toThresholdKey(item: GanttMetThresholdData): string {\n  return `${item.axis}:${item.direction}:${item.value}`;\n}\n\nfunction createThresholdProjection() {\n  const state = new Set<string>();\n\n  function update(\n    metThresholds: GanttMetThresholdData[],\n  ): GanttMetThresholdData[] {\n    const keys: string[] = [];\n    const newlyEntered: GanttMetThresholdData[] = [];\n\n    for (let i = 0; i < metThresholds.length; i++) {\n      const item = metThresholds[i];\n\n      if (!item) {\n        continue;\n      }\n\n      const key = toThresholdKey(item);\n      keys.push(key);\n      if (!state.has(key)) {\n        newlyEntered.push(item);\n      }\n    }\n\n    state.clear();\n    for (const key of keys) {\n      state.add(key);\n    }\n\n    return newlyEntered;\n  }\n\n  function reset() {\n    state.clear();\n  }\n\n  return { update, reset };\n}\n\ntype UseTotalDataRegionThresholdsProps = {\n  totalRowsCount: number;\n  verticalScrollElement: HTMLDivElement | null;\n};\n\n/**\n * A hook that notifies the Gantt component consumer when certain thresholds are\n * reached in the total data region currently being virtualized.\n *\n * This allows the consumer to perform actions when the rendered region reaches\n * certain thresholds (like fetching additional data to provide to the Gantt component).\n */\nexport function useTotalDataRegionThresholds({\n  totalRowsCount,\n  verticalScrollElement,\n}: UseTotalDataRegionThresholdsProps) {\n  const projectionRef = useRef<ReturnType<\n    typeof createThresholdProjection\n  > | null>(null);\n  if (projectionRef.current === null) {\n    projectionRef.current = createThresholdProjection();\n  }\n\n  const roundedCurrentRowScrollPx = useGanttStore(\n    selectors.roundedCurrentRowScrollPx,\n  );\n\n  const {\n    totalBounds,\n    renderedRegionBounds,\n    threshold,\n    onThresholdMet,\n    timescale,\n  } = useTemporalDataContext();\n  const { rowHeightPx } = useGanttContext();\n\n  useEffect(() => {\n    // Early return if threshold examination should not proceed\n    if (\n      // biome-ignore lint/complexity/useSimplifiedLogicExpression: <clear expression>\n      !threshold ||\n      !onThresholdMet ||\n      !shouldExamineThresholds(totalRowsCount, verticalScrollElement, threshold)\n    ) {\n      projectionRef.current?.reset();\n      return;\n    }\n\n    const totalDataRegion = deriveTotalDataRegion(totalRowsCount, totalBounds);\n\n    const renderedSlice = deriveRenderedSlice(\n      roundedCurrentRowScrollPx,\n      rowHeightPx,\n      verticalScrollElement?.clientHeight ?? 0,\n    );\n\n    const renderedRegion = deriveRenderedRegion(\n      renderedSlice,\n      renderedRegionBounds,\n    );\n\n    const temporalThresholds = deriveTemporalThresholds(\n      threshold,\n      totalDataRegion,\n      timescale,\n    );\n\n    const rowIndexThresholds = deriveRowIndexThresholds(\n      threshold,\n      totalDataRegion,\n    );\n\n    const metThresholds = examineThresholds(\n      renderedRegion,\n      temporalThresholds,\n      rowIndexThresholds,\n    );\n\n    const newlyMet = projectionRef.current?.update(metThresholds) ?? [];\n\n    if (newlyMet.length > 0) {\n      onThresholdMet(newlyMet);\n    }\n  }, [\n    totalRowsCount,\n    totalBounds,\n    renderedRegionBounds,\n    threshold,\n    onThresholdMet,\n    timescale,\n    roundedCurrentRowScrollPx,\n    verticalScrollElement,\n    rowHeightPx,\n  ]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAS,eAAe,MAAqC;AAC3D,QAAO,GAAG,KAAK,KAAK,GAAG,KAAK,UAAU,GAAG,KAAK;;AAGhD,SAAS,4BAA4B;CACnC,MAAM,wBAAQ,IAAI,KAAa;CAE/B,SAAS,OACP,eACyB;EACzB,MAAMA,OAAiB,EAAE;EACzB,MAAMC,eAAwC,EAAE;AAEhD,OAAK,IAAI,IAAI,GAAG,IAAI,cAAc,QAAQ,KAAK;GAC7C,MAAM,OAAO,cAAc;AAE3B,OAAI,CAAC,KACH;GAGF,MAAM,MAAM,eAAe,KAAK;AAChC,QAAK,KAAK,IAAI;AACd,OAAI,CAAC,MAAM,IAAI,IAAI,CACjB,cAAa,KAAK,KAAK;;AAI3B,QAAM,OAAO;AACb,OAAK,MAAM,OAAO,KAChB,OAAM,IAAI,IAAI;AAGhB,SAAO;;CAGT,SAAS,QAAQ;AACf,QAAM,OAAO;;AAGf,QAAO;EAAE;EAAQ;EAAO;;;;;;;;;AAe1B,SAAgB,6BAA6B,EAC3C,gBACA,yBACoC;CACpC,MAAM,gBAAgB,OAEZ,KAAK;AACf,KAAI,cAAc,YAAY,KAC5B,eAAc,UAAU,2BAA2B;CAGrD,MAAM,4BAA4B,cAChC,UAAU,0BACX;CAED,MAAM,EACJ,aACA,sBACA,WACA,gBACA,cACE,wBAAwB;CAC5B,MAAM,EAAE,gBAAgB,iBAAiB;AAEzC,iBAAgB;AAEd,MAEE,CAAC,aACD,CAAC,kBACD,CAAC,wBAAwB,gBAAgB,uBAAuB,UAAU,EAC1E;AACA,iBAAc,SAAS,OAAO;AAC9B;;EAGF,MAAM,kBAAkB,sBAAsB,gBAAgB,YAAY;EAwB1E,MAAM,gBAAgB,kBAhBC,qBAND,oBACpB,2BACA,aACA,uBAAuB,gBAAgB,EACxC,EAIC,qBACD,EAE0B,yBACzB,WACA,iBACA,UACD,EAE0B,yBACzB,WACA,gBACD,CAMA;EAED,MAAM,WAAW,cAAc,SAAS,OAAO,cAAc,IAAI,EAAE;AAEnE,MAAI,SAAS,SAAS,EACpB,gBAAe,SAAS;IAEzB;EACD;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC"}

package/dist/components/gantt/hooks/use-vertical-scroll-update/index.d.ts

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { UIEvent } from "react";
+
+//#region src/components/gantt/hooks/use-vertical-scroll-update/index.d.ts
+type UseVerticalScrollUpdateValue = {
+  onScroll: (event: UIEvent<HTMLDivElement>) => void;
+};
+declare function useVerticalScrollUpdate(): UseVerticalScrollUpdateValue;
+//#endregion
+export { useVerticalScrollUpdate };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/gantt/hooks/use-vertical-scroll-update/index.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { selectors } from "../../store.js";
+import { useGanttStore } from "../../context/store/index.js";
+import { getVerticalScrolledPixels } from "../../utils/helpers.js";
+import { useGanttContext } from "../../context/index.js";
+import { useCallback } from "react";
+
+//#region src/components/gantt/hooks/use-vertical-scroll-update/index.ts
+function useVerticalScrollUpdate() {
+	const { ganttContentElement, ganttPanelElement } = useGanttContext();
+	const setCurrentRowScrollPx = useGanttStore(selectors.setCurrentRowScrollPx);
+	return { onScroll: useCallback((event) => {
+		const scrolledPixels = getVerticalScrolledPixels(event);
+		setCurrentRowScrollPx(scrolledPixels);
+		ganttPanelElement?.scrollTo({ top: scrolledPixels });
+		ganttContentElement?.scrollTo({ top: scrolledPixels });
+	}, [
+		setCurrentRowScrollPx,
+		ganttPanelElement,
+		ganttContentElement
+	]) };
+}
+
+//#endregion
+export { useVerticalScrollUpdate };
+//# sourceMappingURL=index.js.map

package/dist/components/gantt/hooks/use-vertical-scroll-update/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/components/gantt/hooks/use-vertical-scroll-update/index.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useCallback, type UIEvent } from 'react';\nimport { useGanttContext } from '../../context';\nimport { useGanttStore } from '../../context/store';\nimport { selectors } from '../../store';\nimport { getVerticalScrolledPixels } from '../../utils/helpers';\n\ntype UseVerticalScrollUpdateValue = {\n  onScroll: (event: UIEvent<HTMLDivElement>) => void;\n};\n\nexport function useVerticalScrollUpdate(): UseVerticalScrollUpdateValue {\n  const { ganttContentElement, ganttPanelElement } = useGanttContext();\n  const setCurrentRowScrollPx = useGanttStore(selectors.setCurrentRowScrollPx);\n\n  const onScroll = useCallback(\n    (event: UIEvent<HTMLDivElement>) => {\n      const scrolledPixels = getVerticalScrolledPixels(event);\n\n      setCurrentRowScrollPx(scrolledPixels);\n      ganttPanelElement?.scrollTo({ top: scrolledPixels });\n      ganttContentElement?.scrollTo({ top: scrolledPixels });\n    },\n    [setCurrentRowScrollPx, ganttPanelElement, ganttContentElement],\n  );\n\n  return { onScroll };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,0BAAwD;CACtE,MAAM,EAAE,qBAAqB,sBAAsB,iBAAiB;CACpE,MAAM,wBAAwB,cAAc,UAAU,sBAAsB;AAa5E,QAAO,EAAE,UAXQ,aACd,UAAmC;EAClC,MAAM,iBAAiB,0BAA0B,MAAM;AAEvD,wBAAsB,eAAe;AACrC,qBAAmB,SAAS,EAAE,KAAK,gBAAgB,CAAC;AACpD,uBAAqB,SAAS,EAAE,KAAK,gBAAgB,CAAC;IAExD;EAAC;EAAuB;EAAmB;EAAoB,CAChE,EAEkB"}

package/dist/components/gantt/public-types.d.ts

@@ -0,0 +1,31 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { GanttMetThresholdData as GanttMetThresholdData$1, GanttRowElementColorProp as GanttRowElementColorProp$1, GanttThreshold as GanttThreshold$1, GanttThresholdProps as GanttThresholdProps$1, GanttTimescale as GanttTimescale$1 } from "./types.js";
+import { GanttProviderProps as GanttProviderProps$1 } from "./context/index.js";
+
+//#region src/components/gantt/public-types.d.ts
+/**
+ * Public type exports for the Gantt component.
+ *
+ * NOTE: These types are for EXTERNAL consumption only.
+ * Internal gantt files should import directly from './types'.
+ */
+type GanttTimescale = GanttTimescale$1;
+type GanttThreshold = GanttThreshold$1;
+type GanttMetThresholdData = GanttMetThresholdData$1;
+type GanttThresholdProps = GanttThresholdProps$1;
+type GanttRowElementColorProp = GanttRowElementColorProp$1;
+type GanttProviderProps = GanttProviderProps$1;
+//#endregion
+export { GanttMetThresholdData, GanttProviderProps, GanttRowElementColorProp, GanttThreshold, GanttThresholdProps, GanttTimescale };
+//# sourceMappingURL=public-types.d.ts.map

package/dist/components/gantt/public-types.js

@@ -0,0 +1,12 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+

package/dist/components/gantt/store.d.ts

@@ -0,0 +1,51 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import * as zustand0 from "zustand";
+
+//#region src/components/gantt/store.d.ts
+type GanttState = {
+  currentPositionMs: number;
+  currentRowScrollPx: number;
+  virtualizedHeightPx: number;
+};
+type GanttActions = {
+  setCurrentPositionMs: (ms: number) => void;
+  setCurrentRowScrollPx: (px: number) => void;
+  setVirtualizedHeightPx: (px: number) => void;
+};
+declare const selectors: {
+  currentPositionMs: (state: GanttState) => number;
+  roundedCurrentPositionMs: (selectedTimeIntervalMs: number) => (state: GanttState) => number;
+  roundedCurrentRowScrollPx: (state: GanttState) => number;
+  virtualizedHeightPx: (state: GanttState) => number;
+  setCurrentPositionMs: (state: GanttState & GanttActions) => (ms: number) => void;
+  setCurrentRowScrollPx: (state: GanttState & GanttActions) => (px: number) => void;
+};
+type GanttStoreProps = {
+  startTimeMs: number;
+};
+declare const createGanttStore: ({
+  startTimeMs
+}: GanttStoreProps) => Omit<zustand0.StoreApi<GanttState & GanttActions>, "subscribe"> & {
+  subscribe: {
+    (listener: (selectedState: GanttState & GanttActions, previousSelectedState: GanttState & GanttActions) => void): () => void;
+    <U>(selector: (state: GanttState & GanttActions) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+      equalityFn?: ((a: U, b: U) => boolean) | undefined;
+      fireImmediately?: boolean;
+    } | undefined): () => void;
+  };
+};
+type GanttStore = ReturnType<typeof createGanttStore>;
+//#endregion
+export { GanttActions, GanttState, GanttStore, GanttStoreProps, createGanttStore, selectors };
+//# sourceMappingURL=store.d.ts.map

package/dist/components/gantt/store.js

@@ -0,0 +1,46 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { GANTT_ROW_HEIGHT_PX } from "./constants.js";
+import { roundMsToInterval } from "./utils/dates.js";
+import { createStore } from "zustand";
+import { subscribeWithSelector } from "zustand/middleware";
+
+//#region src/components/gantt/store.ts
+const selectors = {
+	currentPositionMs: (state) => state.currentPositionMs,
+	roundedCurrentPositionMs: (selectedTimeIntervalMs) => (state) => {
+		return roundMsToInterval(state.currentPositionMs, selectedTimeIntervalMs);
+	},
+	roundedCurrentRowScrollPx: (state) => {
+		const scrollPxValue = state.currentRowScrollPx;
+		return Math.floor(scrollPxValue / GANTT_ROW_HEIGHT_PX) * GANTT_ROW_HEIGHT_PX;
+	},
+	virtualizedHeightPx: (state) => state.virtualizedHeightPx,
+	setCurrentPositionMs: (state) => state.setCurrentPositionMs,
+	setCurrentRowScrollPx: (state) => state.setCurrentRowScrollPx
+};
+const createGanttStore = ({ startTimeMs }) => {
+	return createStore()(subscribeWithSelector((set) => ({
+		currentPositionMs: startTimeMs,
+		currentRowScrollPx: 0,
+		virtualizedHeightPx: 0,
+		setCurrentPositionMs: (ms) => set({ currentPositionMs: ms }),
+		setCurrentRowScrollPx: (px) => set({ currentRowScrollPx: px }),
+		setVirtualizedHeightPx: (px) => set({ virtualizedHeightPx: px })
+	})));
+};
+
+//#endregion
+export { createGanttStore, selectors };
+//# sourceMappingURL=store.js.map

package/dist/components/gantt/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","names":[],"sources":["../../../src/components/gantt/store.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { createStore } from 'zustand';\nimport { subscribeWithSelector } from 'zustand/middleware';\nimport { GANTT_ROW_HEIGHT_PX } from './constants';\nimport { roundMsToInterval } from './utils/dates';\n\nexport type GanttState = {\n  currentPositionMs: number;\n  currentRowScrollPx: number;\n  virtualizedHeightPx: number;\n};\n\nexport type GanttActions = {\n  setCurrentPositionMs: (ms: number) => void;\n  setCurrentRowScrollPx: (px: number) => void;\n  setVirtualizedHeightPx: (px: number) => void;\n};\n\nexport const selectors = {\n  currentPositionMs: (state: GanttState) => state.currentPositionMs,\n  roundedCurrentPositionMs:\n    (selectedTimeIntervalMs: number) => (state: GanttState) => {\n      return roundMsToInterval(state.currentPositionMs, selectedTimeIntervalMs);\n    },\n  roundedCurrentRowScrollPx: (state: GanttState) => {\n    const scrollPxValue = state.currentRowScrollPx;\n\n    return (\n      Math.floor(scrollPxValue / GANTT_ROW_HEIGHT_PX) * GANTT_ROW_HEIGHT_PX\n    );\n  },\n  virtualizedHeightPx: (state: GanttState) => state.virtualizedHeightPx,\n  setCurrentPositionMs: (state: GanttState & GanttActions) =>\n    state.setCurrentPositionMs,\n  setCurrentRowScrollPx: (state: GanttState & GanttActions) =>\n    state.setCurrentRowScrollPx,\n};\n\nexport type GanttStoreProps = {\n  startTimeMs: number;\n};\n\nexport const createGanttStore = ({ startTimeMs }: GanttStoreProps) => {\n  return createStore<GanttState & GanttActions>()(\n    subscribeWithSelector((set) => ({\n      currentPositionMs: startTimeMs,\n      currentRowScrollPx: 0,\n      virtualizedHeightPx: 0,\n      setCurrentPositionMs: (ms: number) => set({ currentPositionMs: ms }),\n      setCurrentRowScrollPx: (px: number) => set({ currentRowScrollPx: px }),\n      setVirtualizedHeightPx: (px: number) => set({ virtualizedHeightPx: px }),\n    })),\n  );\n};\n\nexport type GanttStore = ReturnType<typeof createGanttStore>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA8BA,MAAa,YAAY;CACvB,oBAAoB,UAAsB,MAAM;CAChD,2BACG,4BAAoC,UAAsB;AACzD,SAAO,kBAAkB,MAAM,mBAAmB,uBAAuB;;CAE7E,4BAA4B,UAAsB;EAChD,MAAM,gBAAgB,MAAM;AAE5B,SACE,KAAK,MAAM,gBAAgB,oBAAoB,GAAG;;CAGtD,sBAAsB,UAAsB,MAAM;CAClD,uBAAuB,UACrB,MAAM;CACR,wBAAwB,UACtB,MAAM;CACT;AAMD,MAAa,oBAAoB,EAAE,kBAAmC;AACpE,QAAO,aAAwC,CAC7C,uBAAuB,SAAS;EAC9B,mBAAmB;EACnB,oBAAoB;EACpB,qBAAqB;EACrB,uBAAuB,OAAe,IAAI,EAAE,mBAAmB,IAAI,CAAC;EACpE,wBAAwB,OAAe,IAAI,EAAE,oBAAoB,IAAI,CAAC;EACtE,yBAAyB,OAAe,IAAI,EAAE,qBAAqB,IAAI,CAAC;EACzE,EAAE,CACJ"}

package/dist/components/gantt/styles.module.css

@@ -0,0 +1,30 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+@reference '@accelint/design-foundation/styles';
+
+@layer components.l1 {
+  .container {
+    --padding-top: attr(data-padding-top px);
+
+    @apply relative flex h-full max-h-full w-full flex-col overflow-x-hidden overflow-y-auto;
+    padding-top: var(--padding-top);
+  }
+
+  .rows-container {
+    @apply flex-1 overflow-hidden;
+  }
+
+  .row-scroll-container {
+    @apply pr-px;
+  }
+}

package/dist/components/gantt/types.d.ts

@@ -0,0 +1,67 @@
+//#region src/components/gantt/types.d.ts
+/** Shorthand strings representing hour-based timeline interval durations. */
+type GanttHoursTimescale = '1h' | '2h' | '6h' | '12h' | '24h';
+/** Shorthand strings representing minute-based timeline interval durations. */
+type GanttMinutesTimescale = '1m' | '5m' | '10m' | '30m';
+/**
+ * Timeline interval duration controlling the spacing between tick marks.
+ * Determines the granularity of the timeline display.
+ */
+type GanttTimescale = GanttHoursTimescale | GanttMinutesTimescale;
+type GanttTimelineChunkObject = {
+  /** Epoch milliseconds for this timeline chunk's position. */
+  timestampMs: number;
+};
+type GanttTimeBounds = {
+  /** Start of the time range in epoch milliseconds. */
+  startMs: number;
+  /** End of the time range in epoch milliseconds. */
+  endMs: number;
+};
+/**
+ * Visual color variant for row elements (blocks, markers, spacers, brackets).
+ * Maps to design token color scales.
+ */
+type GanttRowElementColorProp = 'serious' | 'accent' | 'critical';
+/**
+ * Configuration for threshold-based data loading notifications.
+ * When the rendered region approaches the edges of the total data region,
+ * the Gantt fires `onThresholdMet` so consumers can load additional data.
+ */
+type GanttThreshold = {
+  /** Number of timescale intervals from the timeline boundary that triggers a threshold event. */
+  timescaleMultipleDistance: number;
+  /** Number of rows from the visible row boundary that triggers a threshold event. */
+  rowIndexBoundaryDistance: number;
+};
+type GanttDerivedThresholdValue = {
+  /** Derived threshold boundary at the start of the axis. */
+  start: number;
+  /** Derived threshold boundary at the end of the axis. */
+  end: number;
+};
+/** Data describing a threshold that was met during rendering. */
+type GanttMetThresholdData = {
+  /** Which axis the threshold was met on (time or rows). */
+  axis: 'horizontal' | 'vertical';
+  /** Whether the threshold was met at the beginning or end of the axis. */
+  direction: 'start' | 'end';
+  /** The timestamp (horizontal) or row index (vertical) at which the threshold was met. */
+  value: number;
+};
+type GanttRegion = {
+  startMs: number;
+  endMs: number;
+  startRowIndex: number;
+  endRowIndex: number;
+};
+/** Props for configuring threshold-based data loading on the Gantt component. */
+type GanttThresholdProps = {
+  /** Threshold distances that define when edge-of-data notifications fire. */
+  threshold: GanttThreshold;
+  /** Callback invoked when the rendered region enters a threshold zone. */
+  onThresholdMet: (metThresholds: GanttMetThresholdData[]) => void;
+};
+//#endregion
+export { GanttDerivedThresholdValue, GanttHoursTimescale, GanttMetThresholdData, GanttMinutesTimescale, GanttRegion, GanttRowElementColorProp, GanttThreshold, GanttThresholdProps, GanttTimeBounds, GanttTimelineChunkObject, GanttTimescale };
+//# sourceMappingURL=types.d.ts.map

package/dist/components/gantt/types.js

@@ -0,0 +1,12 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+

package/dist/components/gantt/utils/conversions.d.ts

@@ -0,0 +1,23 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { GanttTimescale } from "../types.js";
+
+//#region src/components/gantt/utils/conversions.d.ts
+declare function getMsPerPx(timescale: GanttTimescale): number;
+/** @throws {RangeError} If endTimeMs < startTimeMs. */
+declare function getTotalTimelineMs(startTimeMs: number, endTimeMs: number): number;
+declare function getTotalTimelineWidth(totalTimelineMs: number, msPerPx: number): number;
+declare function getMsRepresentedInViewableRegion(viewableRegionWidth: number, msPerPx: number): number;
+//#endregion
+export { getMsPerPx, getMsRepresentedInViewableRegion, getTotalTimelineMs, getTotalTimelineWidth };
+//# sourceMappingURL=conversions.d.ts.map