pace-calculator 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nicholas Wallace
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# pace-calculator
+
+[![CI](https://github.com/nwallace534/pace-calculator/actions/workflows/ci.yml/badge.svg)](https://github.com/nwallace534/pace-calculator/actions/workflows/ci.yml)
+
+A small, UI-agnostic TypeScript library for running pace, time, distance, and split calculations.
+
+## Core tenets
+
+- **One conversion path.** Every distance conversion goes through a single meter↔yard ratio, so any rounding stays consistent and never compounds.
+- **UI-agnostic.** The library knows nothing about any app — the same package can power a web app, an iOS app, or anything else.
+
+## Install
+
+```bash
+npm install pace-calculator
+```
+
+## Usage
+
+```ts
+import {calculatePace, DistanceUnit} from 'pace-calculator';
+
+const pace = calculatePace({
+  time: {minutes: 20},
+  distance: {distanceValue: 5, distanceUnit: DistanceUnit.Kilometers},
+});
+// → {
+//     perKilometer: {hours: 0, minutes: 4, seconds: 0, milliseconds: 0},
+//     perMile: {hours: 0, minutes: 6, seconds: 26, milliseconds: 244},
+//     speedKph: 15,
+//     speedMph: 9.32,
+//   }
+```
+
+## API
+
+- `calculatePace({ time, distance })` — pace and speed across units
+- `calculateTime({ pace, distance })` — finish time
+- `calculateDistance({ pace, time })` — distance covered
+- `calculateSplits({ time, distance, splitInterval? })` — per-interval splits
+- `getDistanceInAllUnits(distance)` — a distance expressed in km, miles and meters
+- `getTimesForPace({ pace, distances? })` — finish times across multiple distances
+
+### getTimesForPace
+
+The most useful function: give it a pace and get the finish time for a whole set of distances at once.
+
+Called with just a pace, it uses a default set of standard races — 5K, 10K, half and full marathon:
+
+```ts
+import {getTimesForPace, DistanceUnit} from 'pace-calculator';
+
+getTimesForPace({pace: {minutes: 4, unit: DistanceUnit.Kilometers}});
+// → {
+//     '5K': {hours: 0, minutes: 20, seconds: 0, milliseconds: 0},
+//     '10K': {hours: 0, minutes: 40, seconds: 0, milliseconds: 0},
+//     '13.1mi': {hours: 1, minutes: 24, seconds: 19, milliseconds: 793},
+//     '26.2mi': {hours: 2, minutes: 48, seconds: 39, milliseconds: 586},
+//   }
+```
+
+Pass your own `distances` to use a different set — the keys are your labels, and the result is keyed to match:
+
+```ts
+getTimesForPace({
+  pace: {minutes: 4, unit: DistanceUnit.Kilometers},
+  distances: {
+    Parkrun: {distanceValue: 5, distanceUnit: DistanceUnit.Kilometers},
+    'Track lap': {distanceValue: 400, distanceUnit: DistanceUnit.Meters},
+  },
+});
+// → {
+//     Parkrun: {hours: 0, minutes: 20, seconds: 0, milliseconds: 0},
+//     'Track lap': {hours: 0, minutes: 1, seconds: 36, milliseconds: 0},
+//   }
+```
+
+## License
+
+MIT

package/dist/calculator.d.ts

@@ -0,0 +1,9 @@
+import { Distance, DistanceInAllUnits, DistanceInputs } from './types/distance';
+import { CalculateSplitsInput, CalculateSplitsOutput, MultiPace, PaceInputs, TimesForPaceInput } from './types/pace';
+import { Time, TimeInputs } from './types/time';
+export declare const calculatePace: ({ time, distance }: PaceInputs) => MultiPace;
+export declare const getTimesForPace: ({ pace, distances, }: TimesForPaceInput) => Record<string, Time>;
+export declare const calculateTime: ({ distance, pace }: TimeInputs) => Time;
+export declare const getDistanceInAllUnits: (distance: Distance) => DistanceInAllUnits;
+export declare const calculateDistance: ({ pace, time }: DistanceInputs) => Distance;
+export declare const calculateSplits: ({ time, distance, splitInterval, }: CalculateSplitsInput) => CalculateSplitsOutput;

package/dist/calculator.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateSplits = exports.calculateDistance = exports.getDistanceInAllUnits = exports.calculateTime = exports.getTimesForPace = exports.calculatePace = void 0;
+const conversion_constants_1 = require("./conversion.constants");
+const distance_1 = require("./types/distance");
+const validation_1 = require("./validation");
+const defaultDistanceList = [
+    { distanceValue: 5, distanceUnit: distance_1.DistanceUnit.Kilometers },
+    { distanceValue: 10, distanceUnit: distance_1.DistanceUnit.Kilometers },
+    { distanceValue: 13.1, distanceUnit: distance_1.DistanceUnit.Miles }, // half
+    { distanceValue: 26.2, distanceUnit: distance_1.DistanceUnit.Miles }, // full
+];
+const defaultDistances = defaultDistanceList.reduce((acc, dist) => {
+    acc[`${dist.distanceValue}${distance_1.DistanceUnitShorthand[dist.distanceUnit]}`] =
+        dist;
+    return acc;
+}, {});
+const calculatePace = ({ time, distance }) => {
+    (0, validation_1.validateTime)(time);
+    (0, validation_1.validateDistance)(distance);
+    const distanceInMeters = getDistanceInMeters(distance);
+    const timeInMilliseconds = getTimeInMilliseconds(time);
+    const millisecondsPerMeter = timeInMilliseconds / distanceInMeters;
+    // Conversion constants
+    const metersPerKilometer = conversion_constants_1.ConversionConstants.MetersInOneKilometer;
+    const metersPerMile = conversion_constants_1.ConversionConstants.YardsInOneMile / conversion_constants_1.ConversionConstants.YardsInOneMeter;
+    // Calculate paces
+    const millisecondsPerKilometer = millisecondsPerMeter * metersPerKilometer;
+    const millisecondsPerMile = millisecondsPerMeter * metersPerMile;
+    // Calculate speeds
+    const hours = timeInMilliseconds / (1000 * 60 * 60);
+    const kilometers = distanceInMeters / metersPerKilometer;
+    const miles = distanceInMeters / metersPerMile;
+    const speedKph = Math.round((kilometers / hours) * 100) / 100;
+    const speedMph = Math.round((miles / hours) * 100) / 100;
+    return {
+        perKilometer: getTimeFromMilliseconds(millisecondsPerKilometer),
+        perMile: getTimeFromMilliseconds(millisecondsPerMile),
+        speedKph,
+        speedMph,
+    };
+};
+exports.calculatePace = calculatePace;
+const getTimesForPace = ({ pace, distances = defaultDistances, }) => {
+    return Object.entries(distances).reduce((acc, [key, distance]) => {
+        acc[key] = (0, exports.calculateTime)({ pace, distance });
+        return acc;
+    }, {});
+};
+exports.getTimesForPace = getTimesForPace;
+const calculateTime = ({ distance, pace }) => {
+    (0, validation_1.validatePace)(pace);
+    (0, validation_1.validateDistance)(distance);
+    const distanceInMeters = getDistanceInMeters(distance);
+    const paceInMilliseconds = getTimeInMilliseconds(pace);
+    let millisecondsPerMeter;
+    switch (pace.unit) {
+        case distance_1.DistanceUnit.Meters:
+            millisecondsPerMeter = paceInMilliseconds;
+            break;
+        case distance_1.DistanceUnit.Kilometers:
+            millisecondsPerMeter =
+                paceInMilliseconds / conversion_constants_1.ConversionConstants.MetersInOneKilometer;
+            break;
+        case distance_1.DistanceUnit.Miles:
+            millisecondsPerMeter =
+                paceInMilliseconds /
+                    (conversion_constants_1.ConversionConstants.YardsInOneMile /
+                        conversion_constants_1.ConversionConstants.YardsInOneMeter);
+            break;
+    }
+    const totalMillisecondsForDistance = millisecondsPerMeter * distanceInMeters;
+    return getTimeFromMilliseconds(totalMillisecondsForDistance);
+};
+exports.calculateTime = calculateTime;
+const getDistanceInAllUnits = (distance) => {
+    const inputUnit = distance.distanceUnit;
+    const inputValue = distance.distanceValue;
+    const meters = getDistanceInMeters(distance);
+    const inKilometers = inputUnit === distance_1.DistanceUnit.Kilometers
+        ? { distanceValue: inputValue, distanceUnit: distance_1.DistanceUnit.Kilometers }
+        : {
+            distanceValue: Math.round((meters / conversion_constants_1.ConversionConstants.MetersInOneKilometer) * 100) / 100,
+            distanceUnit: distance_1.DistanceUnit.Kilometers,
+        };
+    const inMeters = inputUnit === distance_1.DistanceUnit.Meters
+        ? { distanceValue: inputValue, distanceUnit: distance_1.DistanceUnit.Meters }
+        : {
+            distanceValue: Math.round(meters * 100) / 100,
+            distanceUnit: distance_1.DistanceUnit.Meters,
+        };
+    const inMiles = inputUnit === distance_1.DistanceUnit.Miles
+        ? { distanceValue: inputValue, distanceUnit: distance_1.DistanceUnit.Miles }
+        : {
+            distanceValue: Math.round((MetersToYards(meters) / conversion_constants_1.ConversionConstants.YardsInOneMile) *
+                100) / 100,
+            distanceUnit: distance_1.DistanceUnit.Miles,
+        };
+    return { inKilometers, inMeters, inMiles };
+};
+exports.getDistanceInAllUnits = getDistanceInAllUnits;
+const calculateDistance = ({ pace, time }) => {
+    (0, validation_1.validatePace)(pace);
+    (0, validation_1.validateTime)(time);
+    const timeInMilliseconds = getTimeInMilliseconds(time);
+    const paceInMetersPerMillisecond = getPaceInMetersPerMillisecond(pace);
+    const totalMetersDistance = timeInMilliseconds * paceInMetersPerMillisecond;
+    return getDistanceInUnitFormat(totalMetersDistance, pace.unit);
+};
+exports.calculateDistance = calculateDistance;
+const calculateSplits = ({ time, distance, splitInterval = 1, }) => {
+    (0, validation_1.validateTime)(time);
+    (0, validation_1.validateDistance)(distance);
+    const totalDistanceInMeters = getDistanceInMeters(distance);
+    const totalTimeInMs = getTimeInMilliseconds(time);
+    const msPerMeter = totalTimeInMs / totalDistanceInMeters;
+    const unit = distance.distanceUnit;
+    // Convert split interval to meters
+    const splitIntervalInMeters = unit === distance_1.DistanceUnit.Miles
+        ? splitInterval *
+            (conversion_constants_1.ConversionConstants.YardsInOneMile /
+                conversion_constants_1.ConversionConstants.YardsInOneMeter)
+        : unit === distance_1.DistanceUnit.Kilometers
+            ? splitInterval * conversion_constants_1.ConversionConstants.MetersInOneKilometer
+            : splitInterval; // if already in meters
+    const splits = [];
+    let currentDistanceInMeters = 0;
+    let splitNumber = 1;
+    while (currentDistanceInMeters + splitIntervalInMeters <
+        totalDistanceInMeters) {
+        currentDistanceInMeters += splitIntervalInMeters;
+        const elapsedMs = currentDistanceInMeters * msPerMeter;
+        splits.push({
+            splitNumber,
+            distance: splitNumber * splitInterval,
+            time: getTimeFromMilliseconds(elapsedMs),
+        });
+        splitNumber++;
+    }
+    if (currentDistanceInMeters < totalDistanceInMeters) {
+        const elapsedMs = totalTimeInMs;
+        splits.push({
+            splitNumber,
+            distance: distance.distanceValue, // full distance
+            time: getTimeFromMilliseconds(elapsedMs),
+        });
+    }
+    return splits;
+};
+exports.calculateSplits = calculateSplits;
+const getDistanceInUnitFormat = (totalMetersDistance, distanceUnit) => {
+    let distanceValue;
+    switch (distanceUnit) {
+        case distance_1.DistanceUnit.Kilometers:
+            distanceValue =
+                totalMetersDistance / conversion_constants_1.ConversionConstants.MetersInOneKilometer;
+            break;
+        case distance_1.DistanceUnit.Miles:
+            distanceValue =
+                MetersToYards(totalMetersDistance) / conversion_constants_1.ConversionConstants.YardsInOneMile;
+            break;
+        case distance_1.DistanceUnit.Meters:
+            distanceValue = totalMetersDistance;
+            break;
+    }
+    distanceValue = Math.round(distanceValue * 100) / 100;
+    return {
+        distanceValue,
+        distanceUnit,
+    };
+};
+const MetersToYards = (meters) => {
+    return meters / conversion_constants_1.METER_YARD_RATIO;
+};
+const getPaceInMetersPerMillisecond = (pace) => {
+    const paceInMilliseconds = getTimeInMilliseconds(pace);
+    switch (pace.unit) {
+        case distance_1.DistanceUnit.Meters:
+            return 1 / paceInMilliseconds;
+        case distance_1.DistanceUnit.Kilometers:
+            return conversion_constants_1.ConversionConstants.MetersInOneKilometer / paceInMilliseconds;
+        case distance_1.DistanceUnit.Miles:
+            return (conversion_constants_1.ConversionConstants.YardsInOneMile /
+                conversion_constants_1.ConversionConstants.YardsInOneMeter /
+                paceInMilliseconds);
+    }
+};
+const getTimeFromMilliseconds = (totalMilliseconds) => {
+    const hours = Math.floor(totalMilliseconds / 3600000);
+    const minutes = Math.floor((totalMilliseconds / 60000) % 60);
+    const seconds = Math.floor((totalMilliseconds % 60000) / 1000);
+    const milliseconds = Math.round(totalMilliseconds % 1000);
+    return { hours, minutes, seconds, milliseconds };
+};
+const getDistanceInMeters = (distance) => {
+    switch (distance.distanceUnit) {
+        case distance_1.DistanceUnit.Kilometers:
+            return distance.distanceValue * conversion_constants_1.ConversionConstants.MetersInOneKilometer;
+        case distance_1.DistanceUnit.Miles:
+            return ((distance.distanceValue * conversion_constants_1.ConversionConstants.YardsInOneMile) /
+                conversion_constants_1.ConversionConstants.YardsInOneMeter);
+        default:
+            return distance.distanceValue;
+    }
+};
+const getTimeInMilliseconds = (time) => {
+    return ((time?.hours ?? 0) * 3600000 +
+        (time?.minutes ?? 0) * 60000 +
+        (time?.seconds ?? 0) * 1000 +
+        (time?.milliseconds ?? 0));
+};
+//# sourceMappingURL=calculator.js.map

package/dist/calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.js","sourceRoot":"","sources":["../src/calculator.ts"],"names":[],"mappings":"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"}

package/dist/conversion.constants.d.ts

@@ -0,0 +1,6 @@
+export declare const ConversionConstants: {
+    YardsInOneMeter: number;
+    YardsInOneMile: number;
+    MetersInOneKilometer: number;
+};
+export declare const METER_YARD_RATIO: number;

package/dist/conversion.constants.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.METER_YARD_RATIO = exports.ConversionConstants = void 0;
+exports.ConversionConstants = {
+    YardsInOneMeter: 1.09361,
+    YardsInOneMile: 1760,
+    MetersInOneKilometer: 1000,
+};
+exports.METER_YARD_RATIO = 1 / exports.ConversionConstants.YardsInOneMeter;
+//# sourceMappingURL=conversion.constants.js.map

package/dist/conversion.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion.constants.js","sourceRoot":"","sources":["../src/conversion.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG;IACjC,eAAe,EAAE,OAAO;IACxB,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,IAAI;CAC3B,CAAC;AAEW,QAAA,gBAAgB,GAAG,CAAC,GAAG,2BAAmB,CAAC,eAAe,CAAC"}

package/dist/distance.d.ts

@@ -0,0 +1,5 @@
+export declare enum DistanceUnit {
+    Kilometres = "Kilometres",
+    Miles = "Miles",
+    Metres = "Metres"
+}

package/dist/distance.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DistanceUnit = void 0;
+var DistanceUnit;
+(function (DistanceUnit) {
+    DistanceUnit["Kilometres"] = "Kilometres";
+    DistanceUnit["Miles"] = "Miles";
+    DistanceUnit["Metres"] = "Metres";
+})(DistanceUnit || (exports.DistanceUnit = DistanceUnit = {}));
+//# sourceMappingURL=distance.js.map

package/dist/distance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.js","sourceRoot":"","sources":["../src/distance.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,yCAAyB,CAAA;IACzB,+BAAe,CAAA;IACf,iCAAiB,CAAA;AACnB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB"}

package/dist/error.d.ts

@@ -0,0 +1,3 @@
+export declare class InvalidInputError extends Error {
+    constructor(message: string);
+}

package/dist/error.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidInputError = void 0;
+class InvalidInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidInputError';
+    }
+}
+exports.InvalidInputError = InvalidInputError;
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":";;;AAAA,MAAa,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AALD,8CAKC"}

package/dist/events.d.ts

@@ -0,0 +1,22 @@
+import { DistanceUnit } from "./distance";
+export type Event = {
+    value: string;
+    distanceValue: string;
+    distanceDecimal: string;
+    distanceUnit: DistanceUnit;
+    eventName: string;
+};
+export declare const Events: {
+    value: string;
+    label: string;
+    distanceValue: string;
+    distanceDecimal: string;
+    distanceUnit: DistanceUnit;
+}[];
+export declare const EventsOther: {
+    value: string;
+    label: string;
+    distanceValue: string;
+    distanceDecimal: string;
+    distanceUnit: DistanceUnit;
+}[];

package/dist/events.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsOther = exports.Events = void 0;
+const distance_1 = require("./distance");
+exports.Events = [
+    { value: 'fiveK', label: '5K', distanceValue: '5', distanceDecimal: '0', distanceUnit: distance_1.DistanceUnit.Kilometres },
+    // { value: 'tenK', label: '10K', distanceValue: '10', distanceDecimal: '0', distanceUnit: DistanceUnit.Kilometres },
+    // { value: 'halfMarathon', label: 'Half-marathon', distanceValue: '13', distanceDecimal: '1', distanceUnit: DistanceUnit.Miles },
+    // { value: 'marathon', label: 'Marathon', distanceValue: '26', distanceDecimal: '2', distanceUnit: DistanceUnit.Miles }
+];
+exports.EventsOther = [
+    { value: 'oneHundredMetres', label: '100m', distanceValue: '100', distanceDecimal: '0', distanceUnit: distance_1.DistanceUnit.Metres },
+    { value: 'twoHundredMetres', label: '200m', distanceValue: '200', distanceDecimal: '0', distanceUnit: distance_1.DistanceUnit.Metres },
+    { value: 'fourHundredMeters', label: '400m', distanceValue: '400', distanceDecimal: '0', distanceUnit: distance_1.DistanceUnit.Metres },
+    { value: 'oneK', label: '1K', distanceValue: '1', distanceDecimal: '0', distanceUnit: distance_1.DistanceUnit.Kilometres }
+];
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";;;AAAA,yCAA0C;AAU7B,QAAA,MAAM,GAAG;IAClB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,uBAAY,CAAC,UAAU,EAAE;IAChH,qHAAqH;IACrH,kIAAkI;IAClI,wHAAwH;CAC3H,CAAA;AAEY,QAAA,WAAW,GAAG;IACvB,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,uBAAY,CAAC,MAAM,EAAE;IAC3H,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,uBAAY,CAAC,MAAM,EAAE;IAC3H,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,uBAAY,CAAC,MAAM,EAAE;IAC5H,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,uBAAY,CAAC,UAAU,EAAE;CAClH,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './calculator';
+export * from './types';

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./calculator"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,0CAAwB"}

package/dist/types/distance.d.ts

@@ -0,0 +1,26 @@
+import { PaceInput } from './pace';
+import { PartialTime } from './time';
+export declare enum DistanceUnit {
+    Kilometers = "Kilometers",
+    Miles = "Miles",
+    Meters = "Meters"
+}
+export declare enum ShorthandUnit {
+    K = "K",
+    M = "M",
+    mi = "mi"
+}
+export declare const DistanceUnitShorthand: Record<DistanceUnit, ShorthandUnit>;
+export interface Distance {
+    distanceValue: number;
+    distanceUnit: DistanceUnit;
+}
+export interface DistanceInputs {
+    pace: PaceInput;
+    time: PartialTime;
+}
+export interface DistanceInAllUnits {
+    inKilometers: Distance;
+    inMeters: Distance;
+    inMiles: Distance;
+}

package/dist/types/distance.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DistanceUnitShorthand = exports.ShorthandUnit = exports.DistanceUnit = void 0;
+var DistanceUnit;
+(function (DistanceUnit) {
+    DistanceUnit["Kilometers"] = "Kilometers";
+    DistanceUnit["Miles"] = "Miles";
+    DistanceUnit["Meters"] = "Meters";
+})(DistanceUnit || (exports.DistanceUnit = DistanceUnit = {}));
+var ShorthandUnit;
+(function (ShorthandUnit) {
+    ShorthandUnit["K"] = "K";
+    ShorthandUnit["M"] = "M";
+    ShorthandUnit["mi"] = "mi";
+})(ShorthandUnit || (exports.ShorthandUnit = ShorthandUnit = {}));
+exports.DistanceUnitShorthand = {
+    [DistanceUnit.Kilometers]: ShorthandUnit.K,
+    [DistanceUnit.Miles]: ShorthandUnit.mi,
+    [DistanceUnit.Meters]: ShorthandUnit.M,
+};
+//# sourceMappingURL=distance.js.map

package/dist/types/distance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.js","sourceRoot":"","sources":["../../src/types/distance.ts"],"names":[],"mappings":";;;AAGA,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,yCAAyB,CAAA;IACzB,+BAAe,CAAA;IACf,iCAAiB,CAAA;AACnB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB;AAED,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,wBAAO,CAAA;IACP,wBAAO,CAAA;IACP,0BAAS,CAAA;AACX,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAEY,QAAA,qBAAqB,GAAwC;IACxE,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC;IAC1C,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,EAAE;IACtC,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC;CACvC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './time';
+export * from './distance';
+export * from './pace';

package/dist/types/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./time"), exports);
+__exportStar(require("./distance"), exports);
+__exportStar(require("./pace"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,6CAA2B;AAC3B,yCAAuB"}

package/dist/types/pace.d.ts

@@ -0,0 +1,36 @@
+import { Distance, DistanceUnit } from './distance';
+import { PartialTime, Time } from './time';
+export interface PaceInputs {
+    distance: Distance;
+    time: PartialTime;
+}
+export interface Pace extends Time {
+    unit: DistanceUnit;
+}
+export interface PaceInput extends PartialTime {
+    unit: DistanceUnit;
+}
+export interface MultiPace {
+    perKilometer: Time;
+    perMile: Time;
+    speedKph: number;
+    speedMph: number;
+}
+export interface CalculateSplitsInput {
+    time: PartialTime;
+    distance: {
+        distanceValue: number;
+        distanceUnit: DistanceUnit;
+    };
+    splitInterval?: number;
+}
+export interface Split {
+    splitNumber: number;
+    distance: number;
+    time: Time;
+}
+export type CalculateSplitsOutput = Split[];
+export interface TimesForPaceInput {
+    pace: PaceInput;
+    distances?: Record<string, Distance>;
+}

package/dist/types/pace.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pace.js.map

package/dist/types/pace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pace.js","sourceRoot":"","sources":["../../src/types/pace.ts"],"names":[],"mappings":""}

package/dist/types/time.d.ts

@@ -0,0 +1,13 @@
+import { Distance } from './distance';
+import { PaceInput } from './pace';
+export interface Time {
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}
+export type PartialTime = Partial<Time>;
+export interface TimeInputs {
+    pace: PaceInput;
+    distance: Distance;
+}

package/dist/types/time.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=time.js.map

package/dist/types/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/types/time.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,6 @@
+import { Distance } from './types/distance';
+import { PaceInput } from './types/pace';
+import { Time } from './types/time';
+export declare const validateTime: (time: Partial<Time>) => void;
+export declare const validatePace: (pace: PaceInput) => void;
+export declare const validateDistance: (distanceValue: Distance) => void;

package/dist/validation.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDistance = exports.validatePace = exports.validateTime = void 0;
+const error_1 = require("./error");
+const distance_1 = require("./types/distance");
+const validateTimeUnits = (time, source) => {
+    // Validate time object: no negative values, at least one > 0
+    const timeValues = [
+        time.hours ?? 0,
+        time.minutes ?? 0,
+        time.seconds ?? 0,
+        time.milliseconds ?? 0,
+    ];
+    if (timeValues.some(v => v < 0)) {
+        throw new error_1.InvalidInputError(`${source} values cannot be negative.`);
+    }
+    if (timeValues.every(v => v === 0)) {
+        throw new error_1.InvalidInputError(`At least one ${source.toLowerCase()} value must be greater than zero.`);
+    }
+};
+const validateTime = (time) => {
+    validateTimeUnits(time, 'Time');
+};
+exports.validateTime = validateTime;
+const validatePace = (pace) => {
+    validateTimeUnits(pace, 'Pace time');
+    if (!Object.values(distance_1.DistanceUnit).includes(pace.unit)) {
+        throw new error_1.InvalidInputError('Invalid distance unit provided.');
+    }
+};
+exports.validatePace = validatePace;
+const validateDistance = (distanceValue) => {
+    if (distanceValue.distanceValue <= 0) {
+        throw new error_1.InvalidInputError('Distance value must be greater than zero.');
+    }
+    if (!Object.values(distance_1.DistanceUnit).includes(distanceValue.distanceUnit)) {
+        throw new error_1.InvalidInputError('Invalid distance unit provided.');
+    }
+};
+exports.validateDistance = validateDistance;
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":";;;AAAA,mCAA0C;AAC1C,+CAAwD;AAIxD,MAAM,iBAAiB,GAAG,CAAC,IAAmB,EAAE,MAAc,EAAQ,EAAE;IACtE,6DAA6D;IAC7D,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,KAAK,IAAI,CAAC;QACf,IAAI,CAAC,OAAO,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,IAAI,CAAC;QACjB,IAAI,CAAC,YAAY,IAAI,CAAC;KACvB,CAAC;IAEF,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,yBAAiB,CAAC,GAAG,MAAM,6BAA6B,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,yBAAiB,CACzB,gBAAgB,MAAM,CAAC,WAAW,EAAE,mCAAmC,CACxE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEK,MAAM,YAAY,GAAG,CAAC,IAAmB,EAAQ,EAAE;IACxD,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC,CAAC;AAFW,QAAA,YAAY,gBAEvB;AAEK,MAAM,YAAY,GAAG,CAAC,IAAe,EAAQ,EAAE;IACpD,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAErC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,uBAAY,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,yBAAiB,CAAC,iCAAiC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC,CAAC;AANW,QAAA,YAAY,gBAMvB;AAEK,MAAM,gBAAgB,GAAG,CAAC,aAAuB,EAAE,EAAE;IAC1D,IAAI,aAAa,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,yBAAiB,CAAC,2CAA2C,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,uBAAY,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,yBAAiB,CAAC,iCAAiC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC,CAAC;AAPW,QAAA,gBAAgB,oBAO3B"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "pace-calculator",
+  "version": "1.0.0",
+  "description": "A small, UI-agnostic TypeScript library for running pace, time, distance and split calculations.",
+  "keywords": [
+    "running",
+    "pace",
+    "pace-calculator",
+    "splits",
+    "marathon",
+    "distance",
+    "speed",
+    "typescript"
+  ],
+  "homepage": "https://github.com/nwallace534/pace-calculator#readme",
+  "bugs": {
+    "url": "https://github.com/nwallace534/pace-calculator/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nwallace534/pace-calculator.git"
+  },
+  "license": "MIT",
+  "author": "Nicholas Wallace",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "lint": "gts lint",
+    "clean": "gts clean",
+    "compile": "tsc",
+    "compile:clean": "tsc --build --clean && tsc --build",
+    "fix": "gts fix",
+    "prepare": "npm run compile",
+    "prepublishOnly": "npm test",
+    "pretest": "npm run compile",
+    "posttest": "npm run lint",
+    "test": "jest --coverage"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.8.0",
+    "gts": "^7.0.0",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.9",
+    "typescript": "^6.0.3"
+  }
+}