@accelint/design-toolkit 9.9.2 → 9.11.0

package/dist/components/gantt/utils/conversions.js

@@ -0,0 +1,34 @@
+/*
+ * 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 { TIMELINE_CHUNK_WIDTH_PX, TIMESCALE_MAPPING } from "../constants.js";
+
+//#region src/components/gantt/utils/conversions.ts
+function getMsPerPx(timescale) {
+	return TIMESCALE_MAPPING[timescale] / TIMELINE_CHUNK_WIDTH_PX;
+}
+/** @throws {RangeError} If endTimeMs < startTimeMs. */
+function getTotalTimelineMs(startTimeMs, endTimeMs) {
+	if (endTimeMs < startTimeMs) throw new RangeError(`endTimeMs (${endTimeMs}) must be >= startTimeMs (${startTimeMs})`);
+	return endTimeMs - startTimeMs;
+}
+function getTotalTimelineWidth(totalTimelineMs, msPerPx) {
+	return totalTimelineMs / msPerPx;
+}
+function getMsRepresentedInViewableRegion(viewableRegionWidth, msPerPx) {
+	return viewableRegionWidth * msPerPx;
+}
+
+//#endregion
+export { getMsPerPx, getMsRepresentedInViewableRegion, getTotalTimelineMs, getTotalTimelineWidth };
+//# sourceMappingURL=conversions.js.map

package/dist/components/gantt/utils/conversions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversions.js","names":[],"sources":["../../../../src/components/gantt/utils/conversions.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 { TIMELINE_CHUNK_WIDTH_PX, TIMESCALE_MAPPING } from '../constants';\nimport type { GanttTimescale } from '../types';\n\nexport function getMsPerPx(timescale: GanttTimescale) {\n  return TIMESCALE_MAPPING[timescale] / TIMELINE_CHUNK_WIDTH_PX;\n}\n\n/** @throws {RangeError} If endTimeMs < startTimeMs. */\nexport function getTotalTimelineMs(startTimeMs: number, endTimeMs: number) {\n  if (endTimeMs < startTimeMs) {\n    throw new RangeError(\n      `endTimeMs (${endTimeMs}) must be >= startTimeMs (${startTimeMs})`,\n    );\n  }\n\n  return endTimeMs - startTimeMs;\n}\n\nexport function getTotalTimelineWidth(\n  totalTimelineMs: number,\n  msPerPx: number,\n) {\n  return totalTimelineMs / msPerPx;\n}\n\nexport function getMsRepresentedInViewableRegion(\n  viewableRegionWidth: number,\n  msPerPx: number,\n) {\n  return viewableRegionWidth * msPerPx;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,WAAW,WAA2B;AACpD,QAAO,kBAAkB,aAAa;;;AAIxC,SAAgB,mBAAmB,aAAqB,WAAmB;AACzE,KAAI,YAAY,YACd,OAAM,IAAI,WACR,cAAc,UAAU,4BAA4B,YAAY,GACjE;AAGH,QAAO,YAAY;;AAGrB,SAAgB,sBACd,iBACA,SACA;AACA,QAAO,kBAAkB;;AAG3B,SAAgB,iCACd,qBACA,SACA;AACA,QAAO,sBAAsB"}

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

@@ -0,0 +1,11 @@
+//#region src/components/gantt/utils/dates.d.ts
+/**
+ * Rounds a millisecond timestamp down to the nearest interval boundary.
+ * Uses pure integer arithmetic to avoid Date object allocations.
+ *
+ * @throws {RangeError} If selectedTimeIntervalMs does not match a known interval.
+ */
+declare function roundMsToInterval(timestampMs: number, selectedTimeIntervalMs: number): number;
+//#endregion
+export { roundMsToInterval };
+//# sourceMappingURL=dates.d.ts.map

package/dist/components/gantt/utils/dates.js

@@ -0,0 +1,41 @@
+/*
+ * 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 { HOURS_MAPPING, MINUTES_MAPPING, MS_PER_HOUR } from "../constants.js";
+
+//#region src/components/gantt/utils/dates.ts
+const MS_PER_SECOND = 1e3;
+const MS_PER_DAY = MS_PER_HOUR * 24;
+const hoursIntervals = Object.values(HOURS_MAPPING);
+const minutesIntervals = Object.values(MINUTES_MAPPING);
+/**
+* Rounds a millisecond timestamp down to the nearest interval boundary.
+* Uses pure integer arithmetic to avoid Date object allocations.
+*
+* @throws {RangeError} If selectedTimeIntervalMs does not match a known interval.
+*/
+function roundMsToInterval(timestampMs, selectedTimeIntervalMs) {
+	const secondAligned = timestampMs - (timestampMs % MS_PER_SECOND + MS_PER_SECOND) % MS_PER_SECOND;
+	if (minutesIntervals.includes(selectedTimeIntervalMs)) return secondAligned - (secondAligned % selectedTimeIntervalMs + selectedTimeIntervalMs) % selectedTimeIntervalMs;
+	if (hoursIntervals.includes(selectedTimeIntervalMs)) {
+		const msIntoDayRaw = secondAligned % MS_PER_DAY;
+		const msIntoDay = msIntoDayRaw < 0 ? msIntoDayRaw + MS_PER_DAY : msIntoDayRaw;
+		const hourAligned = msIntoDay - msIntoDay % selectedTimeIntervalMs;
+		return secondAligned - msIntoDay + hourAligned;
+	}
+	throw new RangeError(`Unrecognized time interval: ${selectedTimeIntervalMs}ms`);
+}
+
+//#endregion
+export { roundMsToInterval };
+//# sourceMappingURL=dates.js.map

package/dist/components/gantt/utils/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","names":[],"sources":["../../../../src/components/gantt/utils/dates.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 { HOURS_MAPPING, MINUTES_MAPPING, MS_PER_HOUR } from '../constants';\n\nconst MS_PER_SECOND = 1000;\nconst MS_PER_DAY = MS_PER_HOUR * 24;\n\nconst hoursIntervals = Object.values(HOURS_MAPPING);\nconst minutesIntervals = Object.values(MINUTES_MAPPING);\n\n/**\n * Rounds a millisecond timestamp down to the nearest interval boundary.\n * Uses pure integer arithmetic to avoid Date object allocations.\n *\n * @throws {RangeError} If selectedTimeIntervalMs does not match a known interval.\n */\nexport function roundMsToInterval(\n  timestampMs: number,\n  selectedTimeIntervalMs: number,\n): number {\n  // Zero out sub-second precision (handle negative timestamps correctly)\n  const msRemainder =\n    ((timestampMs % MS_PER_SECOND) + MS_PER_SECOND) % MS_PER_SECOND;\n  const secondAligned = timestampMs - msRemainder;\n\n  if (minutesIntervals.includes(selectedTimeIntervalMs)) {\n    const intervalRemainder =\n      ((secondAligned % selectedTimeIntervalMs) + selectedTimeIntervalMs) %\n      selectedTimeIntervalMs;\n    return secondAligned - intervalRemainder;\n  }\n\n  if (hoursIntervals.includes(selectedTimeIntervalMs)) {\n    // Hours interval — align to interval boundary within the day\n    const msIntoDayRaw = secondAligned % MS_PER_DAY;\n    const msIntoDay =\n      msIntoDayRaw < 0 ? msIntoDayRaw + MS_PER_DAY : msIntoDayRaw;\n    const hourAligned = msIntoDay - (msIntoDay % selectedTimeIntervalMs);\n    return secondAligned - msIntoDay + hourAligned;\n  }\n\n  throw new RangeError(\n    `Unrecognized time interval: ${selectedTimeIntervalMs}ms`,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,MAAM,gBAAgB;AACtB,MAAM,aAAa,cAAc;AAEjC,MAAM,iBAAiB,OAAO,OAAO,cAAc;AACnD,MAAM,mBAAmB,OAAO,OAAO,gBAAgB;;;;;;;AAQvD,SAAgB,kBACd,aACA,wBACQ;CAIR,MAAM,gBAAgB,eADlB,cAAc,gBAAiB,iBAAiB;AAGpD,KAAI,iBAAiB,SAAS,uBAAuB,CAInD,QAAO,iBAFH,gBAAgB,yBAA0B,0BAC5C;AAIJ,KAAI,eAAe,SAAS,uBAAuB,EAAE;EAEnD,MAAM,eAAe,gBAAgB;EACrC,MAAM,YACJ,eAAe,IAAI,eAAe,aAAa;EACjD,MAAM,cAAc,YAAa,YAAY;AAC7C,SAAO,gBAAgB,YAAY;;AAGrC,OAAM,IAAI,WACR,+BAA+B,uBAAuB,IACvD"}

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

@@ -0,0 +1,5 @@
+//#region src/components/gantt/utils/formatting.d.ts
+declare function formatTimestampLabel(timestampMs: number): string;
+//#endregion
+export { formatTimestampLabel };
+//# sourceMappingURL=formatting.d.ts.map

package/dist/components/gantt/utils/formatting.js

@@ -0,0 +1,54 @@
+/*
+ * 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.
+ */
+
+
+//#region src/components/gantt/utils/formatting.ts
+const formatter = new Intl.DateTimeFormat("en-US", {
+	minute: "2-digit",
+	hour: "2-digit",
+	day: "2-digit",
+	month: "short",
+	timeZone: "UTC",
+	hour12: false
+});
+const labelCache = /* @__PURE__ */ new Map();
+function formatTimestampLabel(timestampMs) {
+	const cached = labelCache.get(timestampMs);
+	if (cached !== void 0) return cached;
+	const parts = formatter.formatToParts(timestampMs);
+	let minute = "";
+	let hour = "";
+	let day = "";
+	let month = "";
+	for (const part of parts) switch (part.type) {
+		case "minute":
+			minute = part.value;
+			break;
+		case "hour":
+			hour = part.value;
+			break;
+		case "day":
+			day = part.value;
+			break;
+		case "month":
+			month = part.value;
+			break;
+	}
+	const label = hour === "00" && minute === "00" ? `${day} ${month.toUpperCase()}` : `${hour}:${minute}`;
+	labelCache.set(timestampMs, label);
+	if (labelCache.size > 500) labelCache.clear();
+	return label;
+}
+
+//#endregion
+export { formatTimestampLabel };
+//# sourceMappingURL=formatting.js.map

package/dist/components/gantt/utils/formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.js","names":[],"sources":["../../../../src/components/gantt/utils/formatting.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\n// TODO: Make locale and format options configurable via GanttProviderProps\nconst DEFAULT_LOCALE = 'en-US';\nconst options: Intl.DateTimeFormatOptions = {\n  minute: '2-digit',\n  hour: '2-digit',\n  day: '2-digit',\n  month: 'short',\n  timeZone: 'UTC',\n  hour12: false,\n};\n\nconst formatter = new Intl.DateTimeFormat(DEFAULT_LOCALE, options);\nconst labelCache = new Map<number, string>();\n\nexport function formatTimestampLabel(timestampMs: number): string {\n  const cached = labelCache.get(timestampMs);\n\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  const parts = formatter.formatToParts(timestampMs);\n  let minute = '';\n  let hour = '';\n  let day = '';\n  let month = '';\n\n  for (const part of parts) {\n    switch (part.type) {\n      case 'minute':\n        minute = part.value;\n        break;\n      case 'hour':\n        hour = part.value;\n        break;\n      case 'day':\n        day = part.value;\n        break;\n      case 'month':\n        month = part.value;\n        break;\n    }\n  }\n\n  const label =\n    hour === '00' && minute === '00'\n      ? `${day} ${month.toUpperCase()}`\n      : `${hour}:${minute}`;\n\n  labelCache.set(timestampMs, label);\n\n  if (labelCache.size > 500) {\n    labelCache.clear();\n  }\n\n  return label;\n}\n"],"mappings":";;;;;;;;;;;;;;AAwBA,MAAM,YAAY,IAAI,KAAK,eAVJ,SACqB;CAC1C,QAAQ;CACR,MAAM;CACN,KAAK;CACL,OAAO;CACP,UAAU;CACV,QAAQ;CACT,CAEiE;AAClE,MAAM,6BAAa,IAAI,KAAqB;AAE5C,SAAgB,qBAAqB,aAA6B;CAChE,MAAM,SAAS,WAAW,IAAI,YAAY;AAE1C,KAAI,WAAW,OACb,QAAO;CAGT,MAAM,QAAQ,UAAU,cAAc,YAAY;CAClD,IAAI,SAAS;CACb,IAAI,OAAO;CACX,IAAI,MAAM;CACV,IAAI,QAAQ;AAEZ,MAAK,MAAM,QAAQ,MACjB,SAAQ,KAAK,MAAb;EACE,KAAK;AACH,YAAS,KAAK;AACd;EACF,KAAK;AACH,UAAO,KAAK;AACZ;EACF,KAAK;AACH,SAAM,KAAK;AACX;EACF,KAAK;AACH,WAAQ,KAAK;AACb;;CAIN,MAAM,QACJ,SAAS,QAAQ,WAAW,OACxB,GAAG,IAAI,GAAG,MAAM,aAAa,KAC7B,GAAG,KAAK,GAAG;AAEjB,YAAW,IAAI,aAAa,MAAM;AAElC,KAAI,WAAW,OAAO,IACpB,YAAW,OAAO;AAGpB,QAAO"}

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

@@ -0,0 +1,19 @@
+/*
+ * 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 { GanttTimelineChunkObject } from "../types.js";
+
+//#region src/components/gantt/utils/generation.d.ts
+declare function generateTimelineChunks(currentPositionMs: number, viewableRegionWidth: number, selectedTimeIntervalMs: number, msPerPx: number): GanttTimelineChunkObject[];
+//#endregion
+export { generateTimelineChunks };
+//# sourceMappingURL=generation.d.ts.map

package/dist/components/gantt/utils/generation.js

@@ -0,0 +1,37 @@
+/*
+ * 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 { BUFFERED_CHUNK_COUNT, TIMELINE_CHUNK_WIDTH_PX } from "../constants.js";
+import { roundMsToInterval } from "./dates.js";
+import { getMsRepresentedInViewableRegion } from "./conversions.js";
+
+//#region src/components/gantt/utils/generation.ts
+function generateTimelineChunks(currentPositionMs, viewableRegionWidth, selectedTimeIntervalMs, msPerPx) {
+	if (viewableRegionWidth === 0) return [];
+	const offsetMs = getMsRepresentedInViewableRegion(viewableRegionWidth, msPerPx) / 2;
+	const proposedChunkCount = Math.ceil(viewableRegionWidth / TIMELINE_CHUNK_WIDTH_PX) + BUFFERED_CHUNK_COUNT;
+	const chunksInViewableRegion = proposedChunkCount % 2 === 0 ? proposedChunkCount + 1 : proposedChunkCount;
+	const midpointMs = currentPositionMs + offsetMs;
+	const midpointIndex = Math.floor(chunksInViewableRegion / 2);
+	const roundedMidpointMs = roundMsToInterval(midpointMs, selectedTimeIntervalMs);
+	const chunks = [];
+	for (let i = 0; i < chunksInViewableRegion; i++) {
+		const chunkTimestampMs = roundedMidpointMs + selectedTimeIntervalMs * (i - midpointIndex);
+		chunks.push({ timestampMs: chunkTimestampMs });
+	}
+	return chunks;
+}
+
+//#endregion
+export { generateTimelineChunks };
+//# sourceMappingURL=generation.js.map

package/dist/components/gantt/utils/generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.js","names":["chunks: GanttTimelineChunkObject[]"],"sources":["../../../../src/components/gantt/utils/generation.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 { BUFFERED_CHUNK_COUNT, TIMELINE_CHUNK_WIDTH_PX } from '../constants';\nimport { getMsRepresentedInViewableRegion } from './conversions';\nimport { roundMsToInterval } from './dates';\nimport type { GanttTimelineChunkObject } from '../types';\n\nexport function generateTimelineChunks(\n  currentPositionMs: number,\n  viewableRegionWidth: number,\n  selectedTimeIntervalMs: number,\n  msPerPx: number,\n): GanttTimelineChunkObject[] {\n  if (viewableRegionWidth === 0) {\n    return [];\n  }\n\n  const offsetMs =\n    getMsRepresentedInViewableRegion(viewableRegionWidth, msPerPx) / 2;\n\n  const proposedChunkCount =\n    Math.ceil(viewableRegionWidth / TIMELINE_CHUNK_WIDTH_PX) +\n    BUFFERED_CHUNK_COUNT;\n\n  const chunksInViewableRegion =\n    proposedChunkCount % 2 === 0 ? proposedChunkCount + 1 : proposedChunkCount;\n\n  const midpointMs = currentPositionMs + offsetMs;\n  const midpointIndex = Math.floor(chunksInViewableRegion / 2);\n\n  const roundedMidpointMs = roundMsToInterval(\n    midpointMs,\n    selectedTimeIntervalMs,\n  );\n\n  const chunks: GanttTimelineChunkObject[] = [];\n\n  for (let i = 0; i < chunksInViewableRegion; i++) {\n    const chunkTimestampMs =\n      roundedMidpointMs + selectedTimeIntervalMs * (i - midpointIndex);\n\n    chunks.push({\n      timestampMs: chunkTimestampMs,\n    });\n  }\n\n  return chunks;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,SAAgB,uBACd,mBACA,qBACA,wBACA,SAC4B;AAC5B,KAAI,wBAAwB,EAC1B,QAAO,EAAE;CAGX,MAAM,WACJ,iCAAiC,qBAAqB,QAAQ,GAAG;CAEnE,MAAM,qBACJ,KAAK,KAAK,sBAAsB,wBAAwB,GACxD;CAEF,MAAM,yBACJ,qBAAqB,MAAM,IAAI,qBAAqB,IAAI;CAE1D,MAAM,aAAa,oBAAoB;CACvC,MAAM,gBAAgB,KAAK,MAAM,yBAAyB,EAAE;CAE5D,MAAM,oBAAoB,kBACxB,YACA,uBACD;CAED,MAAMA,SAAqC,EAAE;AAE7C,MAAK,IAAI,IAAI,GAAG,IAAI,wBAAwB,KAAK;EAC/C,MAAM,mBACJ,oBAAoB,0BAA0B,IAAI;AAEpD,SAAO,KAAK,EACV,aAAa,kBACd,CAAC;;AAGJ,QAAO"}

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

@@ -0,0 +1,26 @@
+/*
+ * 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 { GanttTimeBounds, GanttTimelineChunkObject } from "../types.js";
+import { UIEvent } from "react";
+
+//#region src/components/gantt/utils/helpers.d.ts
+declare function getViewableRegionWidth(element: HTMLElement | null): number;
+declare function getHorizontalScrolledPixels(event: UIEvent<HTMLDivElement>): number;
+declare function getVerticalScrolledPixels(event: UIEvent<HTMLDivElement>): number;
+declare function getRenderedRegionBoundsMs(timeMarkers: GanttTimelineChunkObject[], msPerPx: number): GanttTimeBounds;
+declare function shouldRenderRangeElement(renderedRegionBoundary: GanttTimeBounds, rangeElementTimeBounds: GanttTimeBounds): boolean;
+declare function timestampWithinBounds(timestampMs: number, bounds: GanttTimeBounds): boolean;
+declare function shouldRenderCurrentTime(currentTimeMs: number, renderedRegionBounds: GanttTimeBounds): boolean;
+//#endregion
+export { getHorizontalScrolledPixels, getRenderedRegionBoundsMs, getVerticalScrolledPixels, getViewableRegionWidth, shouldRenderCurrentTime, shouldRenderRangeElement, timestampWithinBounds };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/components/gantt/utils/helpers.js

@@ -0,0 +1,55 @@
+/*
+ * 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 { TIMELINE_CHUNK_WIDTH_PX } from "../constants.js";
+
+//#region src/components/gantt/utils/helpers.ts
+function getViewableRegionWidth(element) {
+	if (!element) return 0;
+	return element.clientWidth;
+}
+function getHorizontalScrolledPixels(event) {
+	const { currentTarget } = event;
+	return currentTarget.scrollLeft;
+}
+function getVerticalScrolledPixels(event) {
+	const { currentTarget } = event;
+	return currentTarget.scrollTop;
+}
+function getRenderedRegionBoundsMs(timeMarkers, msPerPx) {
+	if (timeMarkers.length === 0) return {
+		startMs: 0,
+		endMs: 0
+	};
+	const firstMarker = timeMarkers[0];
+	const lastMarker = timeMarkers[timeMarkers.length - 1];
+	return {
+		startMs: firstMarker.timestampMs,
+		endMs: lastMarker.timestampMs + TIMELINE_CHUNK_WIDTH_PX * msPerPx
+	};
+}
+function shouldRenderRangeElement(renderedRegionBoundary, rangeElementTimeBounds) {
+	const { startMs: rangeStartMs, endMs: rangeEndMs } = rangeElementTimeBounds;
+	const { startMs, endMs } = renderedRegionBoundary;
+	return rangeStartMs < startMs && rangeEndMs > startMs || rangeStartMs >= startMs && rangeEndMs <= endMs || rangeStartMs < endMs && rangeEndMs > endMs;
+}
+function timestampWithinBounds(timestampMs, bounds) {
+	return timestampMs >= bounds.startMs && timestampMs <= bounds.endMs;
+}
+function shouldRenderCurrentTime(currentTimeMs, renderedRegionBounds) {
+	return timestampWithinBounds(currentTimeMs, renderedRegionBounds);
+}
+
+//#endregion
+export { getHorizontalScrolledPixels, getRenderedRegionBoundsMs, getVerticalScrolledPixels, getViewableRegionWidth, shouldRenderCurrentTime, shouldRenderRangeElement, timestampWithinBounds };
+//# sourceMappingURL=helpers.js.map

package/dist/components/gantt/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","names":[],"sources":["../../../../src/components/gantt/utils/helpers.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 { TIMELINE_CHUNK_WIDTH_PX } from '../constants';\nimport type { UIEvent } from 'react';\nimport type { GanttTimeBounds, GanttTimelineChunkObject } from '../types';\n\nexport function getViewableRegionWidth(element: HTMLElement | null) {\n  if (!element) {\n    return 0;\n  }\n\n  return element.clientWidth;\n}\n\nexport function getHorizontalScrolledPixels(event: UIEvent<HTMLDivElement>) {\n  const { currentTarget } = event;\n\n  return currentTarget.scrollLeft;\n}\n\nexport function getVerticalScrolledPixels(event: UIEvent<HTMLDivElement>) {\n  const { currentTarget } = event;\n\n  return currentTarget.scrollTop;\n}\n\nexport function getRenderedRegionBoundsMs(\n  timeMarkers: GanttTimelineChunkObject[],\n  msPerPx: number,\n): GanttTimeBounds {\n  if (timeMarkers.length === 0) {\n    return { startMs: 0, endMs: 0 };\n  }\n\n  const firstMarker = timeMarkers[0] as GanttTimelineChunkObject;\n  const lastMarker = timeMarkers[\n    timeMarkers.length - 1\n  ] as GanttTimelineChunkObject;\n\n  return {\n    startMs: firstMarker.timestampMs,\n    endMs: lastMarker.timestampMs + TIMELINE_CHUNK_WIDTH_PX * msPerPx,\n  };\n}\n\nexport function shouldRenderRangeElement(\n  renderedRegionBoundary: GanttTimeBounds,\n  rangeElementTimeBounds: GanttTimeBounds,\n) {\n  const { startMs: rangeStartMs, endMs: rangeEndMs } = rangeElementTimeBounds;\n  const { startMs, endMs } = renderedRegionBoundary;\n\n  const startsBeforeRegionStart =\n    rangeStartMs < startMs && rangeEndMs > startMs;\n  const isEntirelyWithinRegion = rangeStartMs >= startMs && rangeEndMs <= endMs;\n  const endsAfterRegionEnd = rangeStartMs < endMs && rangeEndMs > endMs;\n  return (\n    startsBeforeRegionStart || isEntirelyWithinRegion || endsAfterRegionEnd\n  );\n}\n\nexport function timestampWithinBounds(\n  timestampMs: number,\n  bounds: GanttTimeBounds,\n) {\n  return timestampMs >= bounds.startMs && timestampMs <= bounds.endMs;\n}\n\nexport function shouldRenderCurrentTime(\n  currentTimeMs: number,\n  renderedRegionBounds: GanttTimeBounds,\n) {\n  return timestampWithinBounds(currentTimeMs, renderedRegionBounds);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,SAAgB,uBAAuB,SAA6B;AAClE,KAAI,CAAC,QACH,QAAO;AAGT,QAAO,QAAQ;;AAGjB,SAAgB,4BAA4B,OAAgC;CAC1E,MAAM,EAAE,kBAAkB;AAE1B,QAAO,cAAc;;AAGvB,SAAgB,0BAA0B,OAAgC;CACxE,MAAM,EAAE,kBAAkB;AAE1B,QAAO,cAAc;;AAGvB,SAAgB,0BACd,aACA,SACiB;AACjB,KAAI,YAAY,WAAW,EACzB,QAAO;EAAE,SAAS;EAAG,OAAO;EAAG;CAGjC,MAAM,cAAc,YAAY;CAChC,MAAM,aAAa,YACjB,YAAY,SAAS;AAGvB,QAAO;EACL,SAAS,YAAY;EACrB,OAAO,WAAW,cAAc,0BAA0B;EAC3D;;AAGH,SAAgB,yBACd,wBACA,wBACA;CACA,MAAM,EAAE,SAAS,cAAc,OAAO,eAAe;CACrD,MAAM,EAAE,SAAS,UAAU;AAM3B,QAHE,eAAe,WAAW,aAAa,WACV,gBAAgB,WAAW,cAAc,SAC7C,eAAe,SAAS,aAAa;;AAMlE,SAAgB,sBACd,aACA,QACA;AACA,QAAO,eAAe,OAAO,WAAW,eAAe,OAAO;;AAGhE,SAAgB,wBACd,eACA,sBACA;AACA,QAAO,sBAAsB,eAAe,qBAAqB"}

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

@@ -0,0 +1,32 @@
+/*
+ * 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 { GanttTimeBounds, GanttTimelineChunkObject } from "../types.js";
+
+//#region src/components/gantt/utils/layout.d.ts
+declare function deriveTranslateXValue(msPerPx: number, timelineChunks: GanttTimelineChunkObject[], currentPositionMs: number): number;
+declare function deriveCurrentTimeTranslateX(currentTimeMs: number, msPerPx: number, currentPositionMs: number): number;
+declare function deriveRangeElementLayout(renderedRegionBounds: GanttTimeBounds, rangeElementBounds: GanttTimeBounds, totalBounds: GanttTimeBounds, msPerPx: number): {
+  translateX: number;
+  widthPx: number;
+};
+declare function derivePointElementLayout(renderedRegionBounds: GanttTimeBounds, pointElementMs: number, totalBounds: GanttTimeBounds, msPerPx: number): {
+  translateX: number;
+};
+declare function deriveRenderedSlice(scrollPx: number, rowHeightPx: number, viewableRegionHeightPx: number): {
+  start: number;
+  end: number;
+};
+declare function deriveHorizontalScrollPosition(timestampMs: number, msPerPx: number, totalBounds: GanttTimeBounds): number;
+//#endregion
+export { deriveCurrentTimeTranslateX, deriveHorizontalScrollPosition, derivePointElementLayout, deriveRangeElementLayout, deriveRenderedSlice, deriveTranslateXValue };
+//# sourceMappingURL=layout.d.ts.map

package/dist/components/gantt/utils/layout.js

@@ -0,0 +1,55 @@
+/*
+ * 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 { ROW_VIRTUALIZATION_OVERSCAN } from "../constants.js";
+
+//#region src/components/gantt/utils/layout.ts
+function deriveTranslateXValue(msPerPx, timelineChunks, currentPositionMs) {
+	const firstTimelineChunk = timelineChunks[0];
+	if (!firstTimelineChunk) return 0;
+	return (firstTimelineChunk.timestampMs - currentPositionMs) / msPerPx;
+}
+function deriveElementTranslateX(renderedRegionBounds, elementStartMs, totalBounds, msPerPx) {
+	const distanceFromTimelineStart = (elementStartMs - totalBounds.startMs) / msPerPx;
+	const offsetMs = renderedRegionBounds.startMs - elementStartMs;
+	return distanceFromTimelineStart + (offsetMs > 0 ? offsetMs / msPerPx : 0);
+}
+function deriveCurrentTimeTranslateX(currentTimeMs, msPerPx, currentPositionMs) {
+	return (currentTimeMs - currentPositionMs) / msPerPx;
+}
+function deriveRangeElementLayout(renderedRegionBounds, rangeElementBounds, totalBounds, msPerPx) {
+	const renderedStartMs = Math.max(renderedRegionBounds.startMs, rangeElementBounds.startMs);
+	const renderedEndMs = Math.min(renderedRegionBounds.endMs, rangeElementBounds.endMs);
+	return {
+		translateX: deriveElementTranslateX(renderedRegionBounds, rangeElementBounds.startMs, totalBounds, msPerPx),
+		widthPx: (renderedEndMs - renderedStartMs) / msPerPx
+	};
+}
+function derivePointElementLayout(renderedRegionBounds, pointElementMs, totalBounds, msPerPx) {
+	return { translateX: deriveElementTranslateX(renderedRegionBounds, pointElementMs, totalBounds, msPerPx) };
+}
+function deriveRenderedSlice(scrollPx, rowHeightPx, viewableRegionHeightPx) {
+	const startIndex = Math.floor(scrollPx / rowHeightPx);
+	const proposedRenderedItemsCount = Math.ceil(viewableRegionHeightPx / rowHeightPx) + ROW_VIRTUALIZATION_OVERSCAN;
+	return {
+		start: startIndex,
+		end: startIndex + (proposedRenderedItemsCount % 2 === 0 ? proposedRenderedItemsCount + 1 : proposedRenderedItemsCount)
+	};
+}
+function deriveHorizontalScrollPosition(timestampMs, msPerPx, totalBounds) {
+	return (timestampMs - totalBounds.startMs) / msPerPx;
+}
+
+//#endregion
+export { deriveCurrentTimeTranslateX, deriveHorizontalScrollPosition, derivePointElementLayout, deriveRangeElementLayout, deriveRenderedSlice, deriveTranslateXValue };
+//# sourceMappingURL=layout.js.map

package/dist/components/gantt/utils/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","names":[],"sources":["../../../../src/components/gantt/utils/layout.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 { ROW_VIRTUALIZATION_OVERSCAN } from '../constants';\nimport type { GanttTimeBounds, GanttTimelineChunkObject } from '../types';\n\nexport function deriveTranslateXValue(\n  msPerPx: number,\n  timelineChunks: GanttTimelineChunkObject[],\n  currentPositionMs: number,\n) {\n  const firstTimelineChunk = timelineChunks[0];\n\n  if (!firstTimelineChunk) {\n    return 0;\n  }\n\n  const timeOutsideViewableRegion =\n    firstTimelineChunk.timestampMs - currentPositionMs;\n\n  return timeOutsideViewableRegion / msPerPx;\n}\n\nfunction deriveElementTranslateX(\n  renderedRegionBounds: GanttTimeBounds,\n  elementStartMs: number,\n  totalBounds: GanttTimeBounds,\n  msPerPx: number,\n) {\n  const distanceFromTimelineStart =\n    (elementStartMs - totalBounds.startMs) / msPerPx;\n  const offsetMs = renderedRegionBounds.startMs - elementStartMs;\n  const offsetPx = offsetMs > 0 ? offsetMs / msPerPx : 0;\n\n  return distanceFromTimelineStart + offsetPx;\n}\n\nexport function deriveCurrentTimeTranslateX(\n  currentTimeMs: number,\n  msPerPx: number,\n  currentPositionMs: number,\n) {\n  return (currentTimeMs - currentPositionMs) / msPerPx;\n}\n\nexport function deriveRangeElementLayout(\n  renderedRegionBounds: GanttTimeBounds,\n  rangeElementBounds: GanttTimeBounds,\n  totalBounds: GanttTimeBounds,\n  msPerPx: number,\n) {\n  const renderedStartMs = Math.max(\n    renderedRegionBounds.startMs,\n    rangeElementBounds.startMs,\n  );\n  const renderedEndMs = Math.min(\n    renderedRegionBounds.endMs,\n    rangeElementBounds.endMs,\n  );\n\n  const translateX = deriveElementTranslateX(\n    renderedRegionBounds,\n    rangeElementBounds.startMs,\n    totalBounds,\n    msPerPx,\n  );\n\n  const widthPx = (renderedEndMs - renderedStartMs) / msPerPx;\n\n  return { translateX, widthPx };\n}\n\nexport function derivePointElementLayout(\n  renderedRegionBounds: GanttTimeBounds,\n  pointElementMs: number,\n  totalBounds: GanttTimeBounds,\n  msPerPx: number,\n) {\n  const translateX = deriveElementTranslateX(\n    renderedRegionBounds,\n    pointElementMs,\n    totalBounds,\n    msPerPx,\n  );\n\n  return { translateX };\n}\n\nexport function deriveRenderedSlice(\n  scrollPx: number,\n  rowHeightPx: number,\n  viewableRegionHeightPx: number,\n) {\n  const startIndex = Math.floor(scrollPx / rowHeightPx);\n\n  const viewableItems = Math.ceil(viewableRegionHeightPx / rowHeightPx);\n\n  const proposedRenderedItemsCount =\n    viewableItems + ROW_VIRTUALIZATION_OVERSCAN;\n\n  const itemsCountEven = proposedRenderedItemsCount % 2 === 0;\n  const itemsCount = itemsCountEven\n    ? proposedRenderedItemsCount + 1\n    : proposedRenderedItemsCount;\n\n  return {\n    start: startIndex,\n    end: startIndex + itemsCount,\n  };\n}\n\nexport function deriveHorizontalScrollPosition(\n  timestampMs: number,\n  msPerPx: number,\n  totalBounds: GanttTimeBounds,\n): number {\n  return (timestampMs - totalBounds.startMs) / msPerPx;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,sBACd,SACA,gBACA,mBACA;CACA,MAAM,qBAAqB,eAAe;AAE1C,KAAI,CAAC,mBACH,QAAO;AAMT,SAFE,mBAAmB,cAAc,qBAEA;;AAGrC,SAAS,wBACP,sBACA,gBACA,aACA,SACA;CACA,MAAM,6BACH,iBAAiB,YAAY,WAAW;CAC3C,MAAM,WAAW,qBAAqB,UAAU;AAGhD,QAAO,6BAFU,WAAW,IAAI,WAAW,UAAU;;AAKvD,SAAgB,4BACd,eACA,SACA,mBACA;AACA,SAAQ,gBAAgB,qBAAqB;;AAG/C,SAAgB,yBACd,sBACA,oBACA,aACA,SACA;CACA,MAAM,kBAAkB,KAAK,IAC3B,qBAAqB,SACrB,mBAAmB,QACpB;CACD,MAAM,gBAAgB,KAAK,IACzB,qBAAqB,OACrB,mBAAmB,MACpB;AAWD,QAAO;EAAE,YATU,wBACjB,sBACA,mBAAmB,SACnB,aACA,QACD;EAIoB,UAFJ,gBAAgB,mBAAmB;EAEtB;;AAGhC,SAAgB,yBACd,sBACA,gBACA,aACA,SACA;AAQA,QAAO,EAAE,YAPU,wBACjB,sBACA,gBACA,aACA,QACD,EAEoB;;AAGvB,SAAgB,oBACd,UACA,aACA,wBACA;CACA,MAAM,aAAa,KAAK,MAAM,WAAW,YAAY;CAIrD,MAAM,6BAFgB,KAAK,KAAK,yBAAyB,YAAY,GAGnD;AAOlB,QAAO;EACL,OAAO;EACP,KAAK,cAPgB,6BAA6B,MAAM,IAEtD,6BAA6B,IAC7B;EAKH;;AAGH,SAAgB,+BACd,aACA,SACA,aACQ;AACR,SAAQ,cAAc,YAAY,WAAW"}

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

@@ -0,0 +1,52 @@
+/*
+ * 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 { GanttDerivedThresholdValue, GanttMetThresholdData, GanttRegion, GanttThreshold, GanttTimeBounds, GanttTimescale } from "../types.js";
+
+//#region src/components/gantt/utils/thresholds.d.ts
+/**
+ * Derives the total data region from the total row count and bounds.
+ */
+declare function deriveTotalDataRegion(totalRowsCount: number, totalBounds: GanttTimeBounds): GanttRegion;
+/**
+ * Derives the rendered region from the rendered slice and bounds.
+ */
+declare function deriveRenderedRegion(renderedSlice: {
+  start: number;
+  end: number;
+}, renderedRegionBounds: GanttTimeBounds): GanttRegion;
+/**
+ * Derives temporal threshold values from the threshold object and total data region.
+ * Returns null if the threshold values are invalid.
+ */
+declare function deriveTemporalThresholds(threshold: GanttThreshold, totalDataRegion: GanttRegion, timescale: GanttTimescale): GanttDerivedThresholdValue | null;
+/**
+ * Derives row index threshold values from the threshold object and total data region.
+ * Returns null if the threshold values are invalid.
+ */
+declare function deriveRowIndexThresholds(threshold: GanttThreshold, totalDataRegion: GanttRegion): GanttDerivedThresholdValue | null;
+/**
+ * Examines if any thresholds have been met by comparing the rendered region
+ * against the derived threshold values.
+ * Returns an array of GanttMetThresholdData objects for thresholds that have been met.
+ */
+declare function examineThresholds(renderedRegion: GanttRegion, temporalThresholds: GanttDerivedThresholdValue | null, rowIndexThresholds: GanttDerivedThresholdValue | null): GanttMetThresholdData[];
+/**
+ * Validates if the threshold examination should proceed based on input parameters.
+ * Returns true if examination should proceed, false otherwise.
+ */
+declare function shouldExamineThresholds(totalRowsCount: number, verticalScrollElement: {
+  clientHeight: number;
+} | null, threshold: GanttThreshold | undefined): boolean;
+//#endregion
+export { deriveRenderedRegion, deriveRowIndexThresholds, deriveTemporalThresholds, deriveTotalDataRegion, examineThresholds, shouldExamineThresholds };
+//# sourceMappingURL=thresholds.d.ts.map

package/dist/components/gantt/utils/thresholds.js

@@ -0,0 +1,116 @@
+/*
+ * 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 { TIMESCALE_MAPPING } from "../constants.js";
+
+//#region src/components/gantt/utils/thresholds.ts
+/**
+* Derives the total data region from the total row count and bounds.
+*/
+function deriveTotalDataRegion(totalRowsCount, totalBounds) {
+	return {
+		startMs: totalBounds.startMs,
+		endMs: totalBounds.endMs,
+		startRowIndex: 0,
+		endRowIndex: totalRowsCount - 1
+	};
+}
+/**
+* Derives the rendered region from the rendered slice and bounds.
+*/
+function deriveRenderedRegion(renderedSlice, renderedRegionBounds) {
+	return {
+		startMs: renderedRegionBounds.startMs,
+		endMs: renderedRegionBounds.endMs,
+		startRowIndex: renderedSlice.start,
+		endRowIndex: renderedSlice.end - 1
+	};
+}
+/**
+* Derives temporal threshold values from the threshold object and total data region.
+* Returns null if the threshold values are invalid.
+*/
+function deriveTemporalThresholds(threshold, totalDataRegion, timescale) {
+	if (threshold.timescaleMultipleDistance < 0) return null;
+	const timescaleMs = TIMESCALE_MAPPING[timescale];
+	const relativeValue = threshold.timescaleMultipleDistance * timescaleMs;
+	const startThreshold = totalDataRegion.startMs + relativeValue;
+	const endThreshold = totalDataRegion.endMs - relativeValue;
+	if (startThreshold > endThreshold) return null;
+	return {
+		start: startThreshold,
+		end: endThreshold
+	};
+}
+/**
+* Derives row index threshold values from the threshold object and total data region.
+* Returns null if the threshold values are invalid.
+*/
+function deriveRowIndexThresholds(threshold, totalDataRegion) {
+	if (threshold.rowIndexBoundaryDistance < 0) return null;
+	const startThreshold = totalDataRegion.startRowIndex + threshold.rowIndexBoundaryDistance;
+	const endThreshold = totalDataRegion.endRowIndex - threshold.rowIndexBoundaryDistance;
+	if (startThreshold > endThreshold) return null;
+	return {
+		start: startThreshold,
+		end: endThreshold
+	};
+}
+/**
+* Examines if any thresholds have been met by comparing the rendered region
+* against the derived threshold values.
+* Returns an array of GanttMetThresholdData objects for thresholds that have been met.
+*/
+function examineThresholds(renderedRegion, temporalThresholds, rowIndexThresholds) {
+	const metThresholds = [];
+	if (temporalThresholds) {
+		if (renderedRegion.startMs <= temporalThresholds.start) metThresholds.push({
+			axis: "horizontal",
+			direction: "start",
+			value: temporalThresholds.start
+		});
+		if (renderedRegion.endMs >= temporalThresholds.end) metThresholds.push({
+			axis: "horizontal",
+			direction: "end",
+			value: temporalThresholds.end
+		});
+	}
+	if (rowIndexThresholds) {
+		if (renderedRegion.startRowIndex <= rowIndexThresholds.start) metThresholds.push({
+			axis: "vertical",
+			direction: "start",
+			value: rowIndexThresholds.start
+		});
+		if (renderedRegion.endRowIndex >= rowIndexThresholds.end) metThresholds.push({
+			axis: "vertical",
+			direction: "end",
+			value: rowIndexThresholds.end
+		});
+	}
+	return metThresholds;
+}
+/**
+* Validates if the threshold examination should proceed based on input parameters.
+* Returns true if examination should proceed, false otherwise.
+*/
+function shouldExamineThresholds(totalRowsCount, verticalScrollElement, threshold) {
+	if (!threshold) return false;
+	if (totalRowsCount <= 0) return false;
+	if (!verticalScrollElement || verticalScrollElement.clientHeight <= 0) return false;
+	if (threshold.timescaleMultipleDistance < 0 || threshold.rowIndexBoundaryDistance < 0) return false;
+	return true;
+}
+
+//#endregion
+export { deriveRenderedRegion, deriveRowIndexThresholds, deriveTemporalThresholds, deriveTotalDataRegion, examineThresholds, shouldExamineThresholds };
+//# sourceMappingURL=thresholds.js.map

package/dist/components/gantt/utils/thresholds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thresholds.js","names":["metThresholds: GanttMetThresholdData[]"],"sources":["../../../../src/components/gantt/utils/thresholds.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 { TIMESCALE_MAPPING } from '../constants';\nimport type {\n  GanttDerivedThresholdValue,\n  GanttRegion,\n  GanttMetThresholdData,\n  GanttThreshold,\n  GanttTimeBounds,\n  GanttTimescale,\n} from '../types';\n\n/**\n * Derives the total data region from the total row count and bounds.\n */\nexport function deriveTotalDataRegion(\n  totalRowsCount: number,\n  totalBounds: GanttTimeBounds,\n): GanttRegion {\n  return {\n    startMs: totalBounds.startMs,\n    endMs: totalBounds.endMs,\n    startRowIndex: 0,\n    endRowIndex: totalRowsCount - 1,\n  };\n}\n\n/**\n * Derives the rendered region from the rendered slice and bounds.\n */\nexport function deriveRenderedRegion(\n  renderedSlice: { start: number; end: number },\n  renderedRegionBounds: GanttTimeBounds,\n): GanttRegion {\n  return {\n    startMs: renderedRegionBounds.startMs,\n    endMs: renderedRegionBounds.endMs,\n    startRowIndex: renderedSlice.start,\n    endRowIndex: renderedSlice.end - 1, // End index is exclusive in slice\n  };\n}\n\n/**\n * Derives temporal threshold values from the threshold object and total data region.\n * Returns null if the threshold values are invalid.\n */\nexport function deriveTemporalThresholds(\n  threshold: GanttThreshold,\n  totalDataRegion: GanttRegion,\n  timescale: GanttTimescale,\n): GanttDerivedThresholdValue | null {\n  if (threshold.timescaleMultipleDistance < 0) {\n    return null;\n  }\n\n  const timescaleMs = TIMESCALE_MAPPING[timescale];\n  const relativeValue = threshold.timescaleMultipleDistance * timescaleMs;\n\n  const startThreshold = totalDataRegion.startMs + relativeValue;\n  const endThreshold = totalDataRegion.endMs - relativeValue;\n\n  // Validate thresholds\n  if (startThreshold > endThreshold) {\n    return null;\n  }\n\n  return {\n    start: startThreshold,\n    end: endThreshold,\n  };\n}\n\n/**\n * Derives row index threshold values from the threshold object and total data region.\n * Returns null if the threshold values are invalid.\n */\nexport function deriveRowIndexThresholds(\n  threshold: GanttThreshold,\n  totalDataRegion: GanttRegion,\n): GanttDerivedThresholdValue | null {\n  if (threshold.rowIndexBoundaryDistance < 0) {\n    return null;\n  }\n\n  const startThreshold =\n    totalDataRegion.startRowIndex + threshold.rowIndexBoundaryDistance;\n  const endThreshold =\n    totalDataRegion.endRowIndex - threshold.rowIndexBoundaryDistance;\n\n  // Validate thresholds\n  if (startThreshold > endThreshold) {\n    return null;\n  }\n\n  return {\n    start: startThreshold,\n    end: endThreshold,\n  };\n}\n\n/**\n * Examines if any thresholds have been met by comparing the rendered region\n * against the derived threshold values.\n * Returns an array of GanttMetThresholdData objects for thresholds that have been met.\n */\nexport function examineThresholds(\n  renderedRegion: GanttRegion,\n  temporalThresholds: GanttDerivedThresholdValue | null,\n  rowIndexThresholds: GanttDerivedThresholdValue | null,\n): GanttMetThresholdData[] {\n  const metThresholds: GanttMetThresholdData[] = [];\n\n  // Check temporal thresholds if they are valid\n  if (temporalThresholds) {\n    if (renderedRegion.startMs <= temporalThresholds.start) {\n      metThresholds.push({\n        axis: 'horizontal',\n        direction: 'start',\n        value: temporalThresholds.start,\n      });\n    }\n\n    if (renderedRegion.endMs >= temporalThresholds.end) {\n      metThresholds.push({\n        axis: 'horizontal',\n        direction: 'end',\n        value: temporalThresholds.end,\n      });\n    }\n  }\n\n  // Check row index thresholds if they are valid\n  if (rowIndexThresholds) {\n    if (renderedRegion.startRowIndex <= rowIndexThresholds.start) {\n      metThresholds.push({\n        axis: 'vertical',\n        direction: 'start',\n        value: rowIndexThresholds.start,\n      });\n    }\n\n    if (renderedRegion.endRowIndex >= rowIndexThresholds.end) {\n      metThresholds.push({\n        axis: 'vertical',\n        direction: 'end',\n        value: rowIndexThresholds.end,\n      });\n    }\n  }\n\n  return metThresholds;\n}\n\n/**\n * Validates if the threshold examination should proceed based on input parameters.\n * Returns true if examination should proceed, false otherwise.\n */\nexport function shouldExamineThresholds(\n  totalRowsCount: number,\n  verticalScrollElement: { clientHeight: number } | null,\n  threshold: GanttThreshold | undefined,\n): boolean {\n  if (!threshold) {\n    return false;\n  }\n\n  if (totalRowsCount <= 0) {\n    return false;\n  }\n\n  if (!verticalScrollElement || verticalScrollElement.clientHeight <= 0) {\n    return false;\n  }\n\n  if (\n    threshold.timescaleMultipleDistance < 0 ||\n    threshold.rowIndexBoundaryDistance < 0\n  ) {\n    return false;\n  }\n\n  return true;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,sBACd,gBACA,aACa;AACb,QAAO;EACL,SAAS,YAAY;EACrB,OAAO,YAAY;EACnB,eAAe;EACf,aAAa,iBAAiB;EAC/B;;;;;AAMH,SAAgB,qBACd,eACA,sBACa;AACb,QAAO;EACL,SAAS,qBAAqB;EAC9B,OAAO,qBAAqB;EAC5B,eAAe,cAAc;EAC7B,aAAa,cAAc,MAAM;EAClC;;;;;;AAOH,SAAgB,yBACd,WACA,iBACA,WACmC;AACnC,KAAI,UAAU,4BAA4B,EACxC,QAAO;CAGT,MAAM,cAAc,kBAAkB;CACtC,MAAM,gBAAgB,UAAU,4BAA4B;CAE5D,MAAM,iBAAiB,gBAAgB,UAAU;CACjD,MAAM,eAAe,gBAAgB,QAAQ;AAG7C,KAAI,iBAAiB,aACnB,QAAO;AAGT,QAAO;EACL,OAAO;EACP,KAAK;EACN;;;;;;AAOH,SAAgB,yBACd,WACA,iBACmC;AACnC,KAAI,UAAU,2BAA2B,EACvC,QAAO;CAGT,MAAM,iBACJ,gBAAgB,gBAAgB,UAAU;CAC5C,MAAM,eACJ,gBAAgB,cAAc,UAAU;AAG1C,KAAI,iBAAiB,aACnB,QAAO;AAGT,QAAO;EACL,OAAO;EACP,KAAK;EACN;;;;;;;AAQH,SAAgB,kBACd,gBACA,oBACA,oBACyB;CACzB,MAAMA,gBAAyC,EAAE;AAGjD,KAAI,oBAAoB;AACtB,MAAI,eAAe,WAAW,mBAAmB,MAC/C,eAAc,KAAK;GACjB,MAAM;GACN,WAAW;GACX,OAAO,mBAAmB;GAC3B,CAAC;AAGJ,MAAI,eAAe,SAAS,mBAAmB,IAC7C,eAAc,KAAK;GACjB,MAAM;GACN,WAAW;GACX,OAAO,mBAAmB;GAC3B,CAAC;;AAKN,KAAI,oBAAoB;AACtB,MAAI,eAAe,iBAAiB,mBAAmB,MACrD,eAAc,KAAK;GACjB,MAAM;GACN,WAAW;GACX,OAAO,mBAAmB;GAC3B,CAAC;AAGJ,MAAI,eAAe,eAAe,mBAAmB,IACnD,eAAc,KAAK;GACjB,MAAM;GACN,WAAW;GACX,OAAO,mBAAmB;GAC3B,CAAC;;AAIN,QAAO;;;;;;AAOT,SAAgB,wBACd,gBACA,uBACA,WACS;AACT,KAAI,CAAC,UACH,QAAO;AAGT,KAAI,kBAAkB,EACpB,QAAO;AAGT,KAAI,CAAC,yBAAyB,sBAAsB,gBAAgB,EAClE,QAAO;AAGT,KACE,UAAU,4BAA4B,KACtC,UAAU,2BAA2B,EAErC,QAAO;AAGT,QAAO"}