@bgord/tools 1.3.12 → 1.3.14

package/dist/age.vo.js

@@ -42,7 +42,7 @@ export class Age {
         return this.value >= minimumAge.value;
     }
     toString() {
-        return this.value.toString();
+        return this.get().toString();
     }
     toJSON() {
         return this.get();

package/dist/date-range.vo.d.ts

@@ -11,6 +11,7 @@ export declare class DateRange {
     toRange(): [Timestamp, Timestamp];
     contains(timestamp: Timestamp): boolean;
     equals(other: DateRange): boolean;
+    toString(): string;
     toJSON(): {
         start: number;
         end: number;

package/dist/date-range.vo.js

@@ -5,7 +5,7 @@ export class DateRange {
     constructor(start, end) {
         this.start = start;
         this.end = end;
-        if (start.isAfter(end))
+        if (start.isAfterOrEqual(end))
             throw new Error(DateRangeError.Invalid);
     }
     getStart() {
@@ -23,6 +23,9 @@ export class DateRange {
     equals(other) {
         return this.start.equals(other.start) && this.end.equals(other.end);
     }
+    toString() {
+        return `${this.start.toString()} - ${this.end.toString()}`;
+    }
     toJSON() {
         return { start: this.getStart().ms, end: this.getEnd().ms };
     }

package/dist/dll.service.d.ts

@@ -23,7 +23,7 @@ export declare class DoublyLinkedList<T> {
     insertBefore(node: Node<T>, target: Node<T>): void;
     find(callback: (node: Node<T>) => boolean): Node<T> | null;
     reverse(): void;
-    toArray(): Node<T>[];
-    static fromArray<T>(array: T[]): DoublyLinkedList<T>;
+    toArray(): ReadonlyArray<Node<T>>;
+    static fromArray<T>(array: ReadonlyArray<T>): DoublyLinkedList<T>;
     [Symbol.iterator](): IterableIterator<Node<T>>;
 }

package/dist/hour.vo.d.ts

@@ -16,7 +16,7 @@ export declare class Hour {
     equals(another: Hour): boolean;
     isAfter(another: Hour): boolean;
     isBefore(another: Hour): boolean;
-    static list(): readonly Hour[];
+    static list(): ReadonlyArray<Hour>;
     toString(): string;
     toJSON(): number;
 }

package/dist/index.d.ts

@@ -2,8 +2,6 @@ export * from "./age.vo";
 export * from "./age-years.vo";
 export * from "./api-key.vo";
 export * from "./basename.vo";
-export * from "./clock.vo";
-export * from "./clock-format.service";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./date-range.vo";
@@ -99,6 +97,7 @@ export * from "./visually-unambiguous-characters-generator.service";
 export * from "./week.vo";
 export * from "./week-iso-id.vo";
 export * from "./weekday.vo";
+export * from "./weekday-iso-id.vo";
 export * from "./weight.vo";
 export * from "./weight-grams.vo";
 export * from "./year.vo";

package/dist/index.js

@@ -2,8 +2,6 @@ export * from "./age.vo";
 export * from "./age-years.vo";
 export * from "./api-key.vo";
 export * from "./basename.vo";
-export * from "./clock.vo";
-export * from "./clock-format.service";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./date-range.vo";
@@ -99,6 +97,7 @@ export * from "./visually-unambiguous-characters-generator.service";
 export * from "./week.vo";
 export * from "./week-iso-id.vo";
 export * from "./weekday.vo";
+export * from "./weekday-iso-id.vo";
 export * from "./weight.vo";
 export * from "./weight-grams.vo";
 export * from "./year.vo";

package/dist/linear-regression.service.d.ts

@@ -21,7 +21,7 @@ export declare class LinearRegression {
     private readonly params;
     private readonly rounding;
     constructor(params: LinearRegressionParamsType, rounding?: RoundingStrategy);
-    static fromPairs(pairs: LinearRegressionPairType[], rounding?: RoundingStrategy): LinearRegression;
+    static fromPairs(pairs: ReadonlyArray<LinearRegressionPairType>, rounding?: RoundingStrategy): LinearRegression;
     predict(x: LinearRegressionPairType["x"], rounding?: RoundingStrategy): LinearRegressionPredictionType;
     inspect(): LinearRegression["params"];
 }

package/dist/mean.service.d.ts

@@ -4,5 +4,5 @@ export declare const MeanError: {
 };
 export declare class Mean {
     private static readonly DEFAULT_ROUNDING;
-    static calculate(values: number[], rounding?: RoundingStrategy): number;
+    static calculate(values: ReadonlyArray<number>, rounding?: RoundingStrategy): number;
 }

package/dist/mime-registry-entry.vo.d.ts

@@ -2,6 +2,6 @@ import type { ExtensionType } from "./extension.vo";
 import type { Mime } from "./mime.vo";
 export declare class MimeRegistryEntry {
     readonly mime: Mime;
-    readonly extensions: ExtensionType[];
-    constructor(mime: Mime, extensions: ExtensionType[]);
+    readonly extensions: ReadonlyArray<ExtensionType>;
+    constructor(mime: Mime, extensions: ReadonlyArray<ExtensionType>);
 }

package/dist/mime-registry.service.d.ts

@@ -8,7 +8,7 @@ export declare const MimeRegistryError: {
 export declare class MimeRegistry {
     private readonly byExtension;
     private readonly byMime;
-    constructor(entries: readonly MimeRegistryEntry[]);
+    constructor(entries: ReadonlyArray<MimeRegistryEntry>);
     hasExtension(extension: ExtensionType): boolean;
     hasMime(mime: Mime): boolean;
     fromExtension(extension: ExtensionType): Mime | undefined;

package/dist/min-max-scaler.service.d.ts

@@ -38,7 +38,7 @@ export declare class MinMaxScaler {
     constructor(config: MinMaxScalerConfigType);
     scale(value: MinMaxScalerValueType): ScaleResult;
     descale(scaled: MinMaxScalerValueType): DescaleResult;
-    static getMinMax(values: MinMaxScalerValueType[]): {
+    static getMinMax(values: ReadonlyArray<MinMaxScalerValueType>): {
         min: number;
         max: number;
     };

package/dist/minute.vo.d.ts

@@ -14,7 +14,7 @@ export declare class Minute {
     equals(another: Minute): boolean;
     isBefore(another: Minute): boolean;
     isAfter(another: Minute): boolean;
-    static list(): readonly Minute[];
+    static list(): ReadonlyArray<Minute>;
     toString(): string;
     toJSON(): number;
 }

package/dist/outlier-detector.service.d.ts

@@ -4,6 +4,6 @@ export declare const OutlierDetectorError: {
 export declare class OutlierDetector {
     private readonly zScore;
     private readonly threshold;
-    constructor(values: number[], threshold: number);
+    constructor(values: ReadonlyArray<number>, threshold: number);
     isInlier(value: number): boolean;
 }

package/dist/pagination.service.d.ts

@@ -18,7 +18,7 @@ export type PaginationExhaustedConfig = {
 export type PaginationPrepareConfigType<T> = {
     total: TotalType;
     pagination: PaginationType;
-    result: T[];
+    result: ReadonlyArray<T>;
 };
 export declare class Pagination {
     static parse(values: PaginationValuesType, _take: TakeType): PaginationType;
@@ -41,7 +41,7 @@ export declare class Pagination {
     }): PaginationType;
 }
 export type Paged<T> = {
-    result: T[];
+    result: ReadonlyArray<T>;
     meta: {
         exhausted: ExhaustedType;
         currentPage: PageType;

package/dist/population-standard-deviation.service.d.ts

@@ -3,5 +3,5 @@ export declare const PopulationStandardDeviationError: {
     NotEnoughValues: string;
 };
 export declare class PopulationStandardDeviation {
-    static calculate(values: number[], rounding?: RoundingStrategy): number;
+    static calculate(values: ReadonlyArray<number>, rounding?: RoundingStrategy): number;
 }

package/dist/reordering.service.d.ts

@@ -44,7 +44,7 @@ export declare class ReorderingTransfer {
 export declare class ReorderingCalculator {
     private dll;
     constructor();
-    static fromArray(ids: ReorderingItem["id"][]): ReorderingCalculator;
+    static fromArray(ids: ReadonlyArray<ReorderingItem["id"]>): ReorderingCalculator;
     add(id: ReorderingItem["id"]): ReorderingItem;
     delete(id: ReorderingItem["id"]): void;
     transfer(transfer: ReorderingTransfer): ReturnType<ReorderingCalculator["read"]>;
@@ -55,7 +55,7 @@ export declare class ReorderingCalculator {
     private recalculate;
 }
 export declare class ReorderingIntegrator {
-    static appendPosition(reordering: ReorderingType[]): <T extends {
+    static appendPosition(reordering: ReadonlyArray<ReorderingType>): <T extends {
         id: ReorderingItemIdType;
     }>(item: T) => WithReorderingPositionValue<T>;
     static sortByPosition(): (a: WithReorderingPositionValue<unknown>, b: WithReorderingPositionValue<unknown>) => number;

package/dist/sum.service.d.ts

@@ -1,4 +1,4 @@
 export declare class Sum {
-    static of(values: readonly number[]): number;
-    static precise(values: readonly number[]): number;
+    static of(values: ReadonlyArray<number>): number;
+    static precise(values: ReadonlyArray<number>): number;
 }

package/dist/ts-utils.d.ts

@@ -1,3 +1,3 @@
-export type Constructor<T> = new (...args: any[]) => T;
+export type Constructor<T> = new (...args: ReadonlyArray<any>) => T;
 export type Falsy<T> = T | null | undefined;
 export type Nullable<T> = T | null;

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/age-years.vo.ts","../src/age.vo.ts","../src/api-key.vo.ts","../src/basename.vo.ts","../src/clock-format.service.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.vo.ts","../src/day-iso-id.vo.ts","../src/day.vo.ts","../src/directory-path-absolute.vo.ts","../src/directory-path-relative.vo.ts","../src/distance-value.vo.ts","../src/distance.vo.ts","../src/division-factor.vo.ts","../src/dll.service.ts","../src/duration-ms.vo.ts","../src/duration.service.ts","../src/email-mask.service.ts","../src/email.vo.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag-value.vo.ts","../src/feature-flag.vo.ts","../src/file-path-absolute-schema.vo.ts","../src/file-path-relative-schema.vo.ts","../src/file-path.vo.ts","../src/filename-affix.vo.ts","../src/filename-from-string.vo.ts","../src/filename.vo.ts","../src/height-milimiters.vo.ts","../src/height.vo.ts","../src/hour-format.service.ts","../src/hour-schema.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban-schema.vo.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/integer-non-negative.vo.ts","../src/integer-positive.vo.ts","../src/integer.vo.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-registry-entry.vo.ts","../src/mime-registry.service.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/mimes.ts","../src/min-max-scaler.service.ts","../src/minute-schema.vo.ts","../src/minute.vo.ts","../src/money-amount.vo.ts","../src/money.vo.ts","../src/month-iso-id.vo.ts","../src/month.vo.ts","../src/multiplication-factor.vo.ts","../src/noop.service.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version-schema.vo.ts","../src/package-version.vo.ts","../src/pagination-page.vo.ts","../src/pagination-skip.vo.ts","../src/pagination-take.vo.ts","../src/pagination.service.ts","../src/percentage.service.ts","../src/population-standard-deviation.service.ts","../src/quarter-iso-id.vo.ts","../src/quarter.vo.ts","../src/random.service.ts","../src/rate-limiter.service.ts","../src/relative-date.vo.ts","../src/reordering-item-position-value.vo.ts","../src/reordering.service.ts","../src/revision-value.vo.ts","../src/revision.vo.ts","../src/rounding-decimal.strategy.ts","../src/rounding-down.strategy.ts","../src/rounding-to-nearest.strategy.ts","../src/rounding-up.strategy.ts","../src/rounding.strategy.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/slug.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/timestamp-value.vo.ts","../src/timestamp.vo.ts","../src/timezone.vo.ts","../src/ts-utils.ts","../src/url-with-slash.vo.ts","../src/url-without-slash.vo.ts","../src/visually-unambiguous-characters-generator.service.ts","../src/week-iso-id.vo.ts","../src/week.vo.ts","../src/weekday.vo.ts","../src/weight-grams.vo.ts","../src/weight.vo.ts","../src/year-iso-id.vo.ts","../src/year.vo.ts","../src/z-score.service.ts"],"version":"5.9.3"}
+{"root":["../src/age-years.vo.ts","../src/age.vo.ts","../src/api-key.vo.ts","../src/basename.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.vo.ts","../src/day-iso-id.vo.ts","../src/day.vo.ts","../src/directory-path-absolute.vo.ts","../src/directory-path-relative.vo.ts","../src/distance-value.vo.ts","../src/distance.vo.ts","../src/division-factor.vo.ts","../src/dll.service.ts","../src/duration-ms.vo.ts","../src/duration.service.ts","../src/email-mask.service.ts","../src/email.vo.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag-value.vo.ts","../src/feature-flag.vo.ts","../src/file-path-absolute-schema.vo.ts","../src/file-path-relative-schema.vo.ts","../src/file-path.vo.ts","../src/filename-affix.vo.ts","../src/filename-from-string.vo.ts","../src/filename.vo.ts","../src/height-milimiters.vo.ts","../src/height.vo.ts","../src/hour-format.service.ts","../src/hour-schema.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban-schema.vo.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/integer-non-negative.vo.ts","../src/integer-positive.vo.ts","../src/integer.vo.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-registry-entry.vo.ts","../src/mime-registry.service.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/mimes.ts","../src/min-max-scaler.service.ts","../src/minute-schema.vo.ts","../src/minute.vo.ts","../src/money-amount.vo.ts","../src/money.vo.ts","../src/month-iso-id.vo.ts","../src/month.vo.ts","../src/multiplication-factor.vo.ts","../src/noop.service.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version-schema.vo.ts","../src/package-version.vo.ts","../src/pagination-page.vo.ts","../src/pagination-skip.vo.ts","../src/pagination-take.vo.ts","../src/pagination.service.ts","../src/percentage.service.ts","../src/population-standard-deviation.service.ts","../src/quarter-iso-id.vo.ts","../src/quarter.vo.ts","../src/random.service.ts","../src/rate-limiter.service.ts","../src/relative-date.vo.ts","../src/reordering-item-position-value.vo.ts","../src/reordering.service.ts","../src/revision-value.vo.ts","../src/revision.vo.ts","../src/rounding-decimal.strategy.ts","../src/rounding-down.strategy.ts","../src/rounding-to-nearest.strategy.ts","../src/rounding-up.strategy.ts","../src/rounding.strategy.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/slug.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/timestamp-value.vo.ts","../src/timestamp.vo.ts","../src/timezone.vo.ts","../src/ts-utils.ts","../src/url-with-slash.vo.ts","../src/url-without-slash.vo.ts","../src/visually-unambiguous-characters-generator.service.ts","../src/week-iso-id.vo.ts","../src/week.vo.ts","../src/weekday-iso-id.vo.ts","../src/weekday.vo.ts","../src/weight-grams.vo.ts","../src/weight.vo.ts","../src/year-iso-id.vo.ts","../src/year.vo.ts","../src/z-score.service.ts"],"version":"5.9.3"}

package/dist/weekday-iso-id.vo.d.ts

@@ -0,0 +1,7 @@
+import * as z from "zod/v4";
+export declare const WeekdayIsoIdError: {
+    Type: string;
+    Invalid: string;
+};
+export declare const WeekdayIsoId: z.core.$ZodBranded<z.ZodNumber, "WeekdayIsoId", "out">;
+export type WeekdayIsoIdType = z.infer<typeof WeekdayIsoId>;

package/dist/weekday-iso-id.vo.js

@@ -0,0 +1,10 @@
+import * as z from "zod/v4";
+export const WeekdayIsoIdError = { Type: "weekday.iso.id.type", Invalid: "weekday.iso.id.invalid" };
+// Stryker disable all
+export const WeekdayIsoId = z
+    // Stryker restore all
+    .number(WeekdayIsoIdError.Type)
+    .int(WeekdayIsoIdError.Type)
+    .min(0, WeekdayIsoIdError.Invalid)
+    .max(6, WeekdayIsoIdError.Invalid)
+    .brand("WeekdayIsoId");

package/dist/weekday.vo.d.ts

@@ -37,6 +37,6 @@ export declare class Weekday {
     isFriday(): boolean;
     isSaturday(): boolean;
     isSunday(): boolean;
-    static list(formatter?: WeekdayFormatter): readonly Weekday[];
-    static listMondayFirst(formatter?: WeekdayFormatter): readonly Weekday[];
+    static list(formatter?: WeekdayFormatter): ReadonlyArray<Weekday>;
+    static listMondayFirst(formatter?: WeekdayFormatter): ReadonlyArray<Weekday>;
 }

package/dist/z-score.service.d.ts

@@ -6,6 +6,6 @@ export declare class ZScore {
     private readonly rounding;
     private readonly mean;
     private readonly standardDeviation;
-    constructor(values: number[], rounding?: RoundingStrategy);
+    constructor(values: ReadonlyArray<number>, rounding?: RoundingStrategy);
     calculate(value: number): number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "1.3.12",
+  "version": "1.3.14",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -20,14 +20,14 @@
     "preinstall": "bunx only-allow bun"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.3.13",
-    "@commitlint/cli": "20.3.1",
-    "@commitlint/config-conventional": "20.3.1",
-    "@stryker-mutator/core": "9.4.0",
+    "@biomejs/biome": "2.3.14",
+    "@commitlint/cli": "20.4.1",
+    "@commitlint/config-conventional": "20.4.1",
+    "@stryker-mutator/core": "9.5.1",
     "@types/bun": "1.3.8",
-    "cspell": "9.6.2",
-    "knip": "5.82.1",
-    "lefthook": "2.0.16",
+    "cspell": "9.6.4",
+    "knip": "5.83.1",
+    "lefthook": "2.1.0",
     "lockfile-lint": "5.0.0",
     "only-allow": "1.2.2",
     "shellcheck": "4.1.0",

package/readme.md

@@ -28,8 +28,6 @@ src/
 ├── age.vo.ts
 ├── api-key.vo.ts
 ├── basename.vo.ts
-├── clock-format.service.ts
-├── clock.vo.ts
 ├── date-calculator.service.ts
 ├── date-formatter.service.ts
 ├── date-range.vo.ts
@@ -123,6 +121,7 @@ src/
 ├── visually-unambiguous-characters-generator.service.ts
 ├── week-iso-id.vo.ts
 ├── week.vo.ts
+├── weekday-iso-id.vo.ts
 ├── weekday.vo.ts
 ├── weight-grams.vo.ts
 ├── weight.vo.ts

package/dist/clock-format.service.d.ts

@@ -1,9 +0,0 @@
-import type { Hour } from "./hour.vo";
-import type { Minute } from "./minute.vo";
-export type ClockFormatter = (hour: Hour, minute: Minute) => string;
-declare enum ClockFormatterEnum {
-    TWENTY_FOUR_HOURS = "TWENTY_FOUR_HOURS",
-    TWELVE_HOURS = "TWELVE_HOURS"
-}
-export declare const ClockFormatters: Record<ClockFormatterEnum, ClockFormatter>;
-export {};

package/dist/clock-format.service.js

@@ -1,10 +0,0 @@
-import { HourFormatters } from "./hour-format.service";
-var ClockFormatterEnum;
-(function (ClockFormatterEnum) {
-    ClockFormatterEnum["TWENTY_FOUR_HOURS"] = "TWENTY_FOUR_HOURS";
-    ClockFormatterEnum["TWELVE_HOURS"] = "TWELVE_HOURS";
-})(ClockFormatterEnum || (ClockFormatterEnum = {}));
-export const ClockFormatters = {
-    TWENTY_FOUR_HOURS: (hour, minute) => `${hour.toString()}:${minute.toString()}`,
-    TWELVE_HOURS: (hour, minute) => `${hour.format(HourFormatters.TWELVE_HOURS)}:${minute.toString()}`,
-};

package/dist/clock.vo.d.ts

@@ -1,26 +0,0 @@
-import { type ClockFormatter } from "./clock-format.service";
-import { Hour } from "./hour.vo";
-import type { HourSchemaType } from "./hour-schema.vo";
-import { Minute } from "./minute.vo";
-import type { MinuteSchemaType } from "./minute-schema.vo";
-import type { Timestamp } from "./timestamp.vo";
-export declare class Clock {
-    private readonly hour;
-    private readonly minute;
-    private readonly formatter;
-    constructor(hour: Hour, minute: Minute, formatter?: ClockFormatter);
-    static fromTimestamp(timestamp: Timestamp, formatter?: ClockFormatter): Clock;
-    get(): {
-        hour: HourSchemaType;
-        minute: MinuteSchemaType;
-    };
-    format(): string;
-    equals(another: Clock): boolean;
-    isAfter(another: Clock): boolean;
-    isBefore(another: Clock): boolean;
-    toString(): string;
-    toJSON(): {
-        hour: HourSchemaType;
-        minute: MinuteSchemaType;
-    };
-}

package/dist/clock.vo.js

@@ -1,43 +0,0 @@
-import { ClockFormatters } from "./clock-format.service";
-import { Hour } from "./hour.vo";
-import { Minute } from "./minute.vo";
-export class Clock {
-    hour;
-    minute;
-    formatter;
-    constructor(hour, minute, formatter) {
-        this.hour = hour;
-        this.minute = minute;
-        this.formatter = formatter ?? ClockFormatters.TWENTY_FOUR_HOURS;
-    }
-    static fromTimestamp(timestamp, formatter) {
-        const hour = Hour.fromTimestamp(timestamp);
-        const minute = Minute.fromTimestamp(timestamp);
-        return new Clock(hour, minute, formatter);
-    }
-    get() {
-        return { hour: this.hour.get(), minute: this.minute.get() };
-    }
-    format() {
-        return this.formatter(this.hour, this.minute);
-    }
-    equals(another) {
-        return this.hour.equals(another.hour) && this.minute.equals(another.minute);
-    }
-    isAfter(another) {
-        if (!this.hour.equals(another.hour))
-            return this.hour.isAfter(another.hour);
-        return this.minute.isAfter(another.minute);
-    }
-    isBefore(another) {
-        if (!this.hour.equals(another.hour))
-            return this.hour.isBefore(another.hour);
-        return this.minute.isBefore(another.minute);
-    }
-    toString() {
-        return this.format();
-    }
-    toJSON() {
-        return this.get();
-    }
-}