@manta-eu/lib 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Manta AI AS
+
+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/dist/ad-platform-links.d.ts

@@ -0,0 +1,7 @@
+export type MetaAdsManagerCampaignLinkOptions = {
+    adAccountExternalId: string;
+    campaignExternalId: string[];
+    marketerPartnerBusinessId: boolean;
+};
+export declare function generateMetaAdsManagerCampaignLink(args: MetaAdsManagerCampaignLinkOptions): string;
+//# sourceMappingURL=ad-platform-links.d.ts.map

package/dist/ad-platform-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ad-platform-links.d.ts","sourceRoot":"","sources":["../src/ad-platform-links.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iCAAiC,GAAG;IAC9C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yBAAyB,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,iCAAiC,UAYzF"}

package/dist/ad-platform-links.js

@@ -0,0 +1,13 @@
+export function generateMetaAdsManagerCampaignLink(args) {
+    const { adAccountExternalId, campaignExternalId, marketerPartnerBusinessId } = args;
+    const recordSeparator = String.fromCharCode(0x1e);
+    const campaignIds = campaignExternalId.map((id) => `"${id}"`).join(",");
+    const filterSet = `SEARCH_BY_CAMPAIGN_GROUP_IDS-STRING_SET${recordSeparator}ANY${recordSeparator}[${campaignIds}]`;
+    const url = new URL("https://adsmanager.facebook.com/adsmanager/manage/campaigns");
+    url.searchParams.set("act", adAccountExternalId);
+    if (marketerPartnerBusinessId) {
+        url.searchParams.set("business_id", "845646597259963");
+    }
+    url.searchParams.set("filter_set", filterSet);
+    return url.toString();
+}

package/dist/array.d.ts

@@ -0,0 +1,3 @@
+export declare function arrayWrap<T>(value: T | T[]): T[];
+export declare function replaceAtIndex<T>(arr: T[], index: number, item: T): T[];
+//# sourceMappingURL=array.d.ts.map

package/dist/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../src/array.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAEhD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAEvE"}

package/dist/array.js

@@ -0,0 +1,7 @@
+import { update } from "ramda";
+export function arrayWrap(value) {
+    return Array.isArray(value) ? value : [value];
+}
+export function replaceAtIndex(arr, index, item) {
+    return update(index, item, arr);
+}

package/dist/asset-upload-grouping.d.ts

@@ -0,0 +1,29 @@
+export type ParsedAssetFilename<TRatio> = {
+    baseName: string;
+    ratio: TRatio | undefined;
+};
+export type ParseAssetFilenameWithSuffixMapProps<TRatio> = {
+    filename: string;
+    suffixMap: Record<string, TRatio>;
+};
+export declare function parseAssetFilenameWithSuffixMap<TRatio>(props: ParseAssetFilenameWithSuffixMapProps<TRatio>): ParsedAssetFilename<TRatio>;
+export type UploadGroupingItem<TAsset, TRatio> = {
+    asset: TAsset;
+    ratio: TRatio | undefined;
+    baseName: string;
+};
+export type UploadedAssetGroup<TAsset, TRatio> = {
+    baseName: string;
+    assets: Array<{
+        asset: TAsset;
+        ratio: TRatio;
+    }>;
+};
+export type GroupUploadedAssetsByBaseNameProps<TAsset, TRatio> = {
+    results: UploadGroupingItem<TAsset, TRatio>[];
+};
+export declare function groupUploadedAssetsByBaseName<TAsset, TRatio>(props: GroupUploadedAssetsByBaseNameProps<TAsset, TRatio>): {
+    groups: UploadedAssetGroup<TAsset, TRatio>[];
+    unmatched: TAsset[];
+};
+//# sourceMappingURL=asset-upload-grouping.d.ts.map

package/dist/asset-upload-grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-upload-grouping.d.ts","sourceRoot":"","sources":["../src/asset-upload-grouping.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,CAAC,MAAM,IAAI;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,oCAAoC,CAAC,MAAM,IAAI;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,MAAM,EACpD,KAAK,EAAE,oCAAoC,CAAC,MAAM,CAAC,GAClD,mBAAmB,CAAC,MAAM,CAAC,CAc7B;AAED,MAAM,MAAM,kBAAkB,CAAC,MAAM,EAAE,MAAM,IAAI;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,MAAM,EAAE,MAAM,IAAI;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,kCAAkC,CAAC,MAAM,EAAE,MAAM,IAAI;IAC/D,OAAO,EAAE,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAC/C,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAC1D,KAAK,EAAE,kCAAkC,CAAC,MAAM,EAAE,MAAM,CAAC,GACxD;IACD,MAAM,EAAE,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAqBA"}

package/dist/asset-upload-grouping.js

@@ -0,0 +1,33 @@
+export function parseAssetFilenameWithSuffixMap(props) {
+    const { filename, suffixMap } = props;
+    const nameWithoutExt = filename.replace(/\.[^.]+$/, "");
+    const lower = nameWithoutExt.toLowerCase();
+    const suffixEntries = Object.entries(suffixMap).sort((a, b) => b[0].length - a[0].length);
+    for (const [suffix, ratio] of suffixEntries) {
+        if (!lower.endsWith(suffix))
+            continue;
+        const rawBaseName = nameWithoutExt.slice(0, -suffix.length);
+        const baseName = rawBaseName.replace(/[_\-\s]+$/, "").trim();
+        return { baseName: baseName || nameWithoutExt, ratio };
+    }
+    return { baseName: nameWithoutExt.trim(), ratio: undefined };
+}
+export function groupUploadedAssetsByBaseName(props) {
+    const { results } = props;
+    const groupMap = new Map();
+    const unmatched = [];
+    for (const result of results) {
+        if (result.ratio === undefined || result.baseName.trim() === "") {
+            unmatched.push(result.asset);
+            continue;
+        }
+        const key = result.baseName.toLowerCase();
+        const group = groupMap.get(key) ?? { baseName: result.baseName, assets: [] };
+        group.assets.push({ asset: result.asset, ratio: result.ratio });
+        groupMap.set(key, group);
+    }
+    return {
+        groups: [...groupMap.values()],
+        unmatched,
+    };
+}

package/dist/color.d.ts

@@ -0,0 +1,17 @@
+import type { DateArg } from "date-fns";
+export type RGBColor = {
+    r: number;
+    g: number;
+    b: number;
+};
+export type HexColor = `#${string}`;
+export declare const hexToRgb: (hex: HexColor) => RGBColor;
+export declare function rgbToHex({ r, g, b }: RGBColor): HexColor;
+export declare function capBrightness(hexColor: HexColor, maxBrightness?: number): string;
+export declare const generateHexColorBasedOnName: (name: string) => {
+    color: string;
+    contrast: string;
+};
+export declare const getAverageColor: (ctx: CanvasRenderingContext2D, width: number, height: number) => RGBColor;
+export declare function getAgeColor(date: DateArg<Date>): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,MAAM,MAAM,QAAQ,GAAG;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,IAAI,MAAM,EAAE,CAAC;AAEpC,eAAO,MAAM,QAAQ,GAAI,KAAK,QAAQ,KAAG,QAmBxC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAOxD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAE,MAAY,GAAG,MAAM,CAQrF;AAED,eAAO,MAAM,2BAA2B,GAAI,MAAM,MAAM;;;CAOvD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,KAAK,wBAAwB,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,QAsB9F,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAOvD"}

package/dist/color.js

@@ -0,0 +1,61 @@
+import { differenceInHours } from "date-fns";
+export const hexToRgb = (hex) => {
+    let sanitizedHex = hex.replace("#", "");
+    if (sanitizedHex.length === 3) {
+        sanitizedHex = sanitizedHex
+            .split("")
+            .map((h) => `${h}${h}`)
+            .join("");
+    }
+    const bigint = parseInt(sanitizedHex, 16);
+    if (isNaN(bigint))
+        throw new Error(`Invalid hex value: ${hex}`);
+    return {
+        r: (bigint >> 16) & 255,
+        g: (bigint >> 8) & 255,
+        b: bigint & 255,
+    };
+};
+export function rgbToHex({ r, g, b }) {
+    const componentToHex = (c) => {
+        const hex = c.toString(16);
+        return hex.length === 1 ? `0${hex}` : hex;
+    };
+    return `#${componentToHex(r)}${componentToHex(g)}${componentToHex(b)}`;
+}
+export function capBrightness(hexColor, maxBrightness = 150) {
+    let { r, g, b } = hexToRgb(hexColor);
+    r = Math.min(r, maxBrightness);
+    g = Math.min(g, maxBrightness);
+    b = Math.min(b, maxBrightness);
+    return rgbToHex({ r, g, b });
+}
+export const generateHexColorBasedOnName = (name) => {
+    const hash = name.split("").reduce((acc, char) => acc + char.charCodeAt(0), 0);
+    const color = `hsl(${hash % 360}, 50%, 50%)`;
+    const contrast = hash % 360 > 180 ? "black" : "white";
+    return { color, contrast };
+};
+export const getAverageColor = (ctx, width, height) => {
+    const imageData = ctx.getImageData(0, 0, width, height);
+    const data = imageData.data;
+    const length = data.length;
+    let r = 0, g = 0, b = 0, count = 0;
+    for (let i = 0; i < length; i += 4) {
+        r += data[i];
+        g += data[i + 1];
+        b += data[i + 2];
+        count++;
+    }
+    return {
+        r: Math.floor(r / count),
+        g: Math.floor(g / count),
+        b: Math.floor(b / count),
+    };
+};
+export function getAgeColor(date) {
+    const diffInHours = differenceInHours(Date.now(), date);
+    const clampedHours = Math.min(Math.max(diffInHours, 0), 36);
+    const hue = Math.round(120 - clampedHours * 3.3333);
+    return `hsl(${hue}, 80%, 40%)`;
+}

package/dist/countries.d.ts

@@ -0,0 +1,3 @@
+export declare function getCountryName(countryCode: string): string;
+export declare function getLanguageName(languageCode: string): string;
+//# sourceMappingURL=countries.d.ts.map

package/dist/countries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries.d.ts","sourceRoot":"","sources":["../src/countries.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,UAMjD;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,UAMnD"}

package/dist/countries.js

@@ -0,0 +1,18 @@
+const regionDisplayNames = new Intl.DisplayNames(["en"], { type: "region" });
+const languageDisplayNames = new Intl.DisplayNames(["en"], { type: "language" });
+export function getCountryName(countryCode) {
+    try {
+        return regionDisplayNames.of(countryCode) ?? countryCode;
+    }
+    catch {
+        return countryCode;
+    }
+}
+export function getLanguageName(languageCode) {
+    try {
+        return languageDisplayNames.of(languageCode.toLowerCase()) ?? languageCode;
+    }
+    catch {
+        return languageCode;
+    }
+}

package/dist/date.d.ts

@@ -0,0 +1,9 @@
+import type { DateArg, FormatOptions } from "date-fns";
+export declare function setTime<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, time: string): ResultDate;
+export declare function setTime<DateType extends Date, ResultDate extends Date = DateType>(date: DateArg<DateType>, hours: number, minutes: number): ResultDate;
+export declare function formatDate(date: DateArg<Date> & {}): string;
+export declare function formatISODate(date: DateArg<Date>): string;
+export type FormatTimeOptions = Intl.DateTimeFormatOptions;
+export declare function formatTime(date: Date, options?: FormatTimeOptions): string;
+export declare function formatDateTime(date: DateArg<Date>, formatStr?: string, options?: FormatOptions): string;
+//# sourceMappingURL=date.d.ts.map

package/dist/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKvD,wBAAgB,OAAO,CAAC,QAAQ,SAAS,IAAI,EAAE,UAAU,SAAS,IAAI,GAAG,QAAQ,EAC/E,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,EACvB,IAAI,EAAE,MAAM,GACX,UAAU,CAAC;AAEd,wBAAgB,OAAO,CAAC,QAAQ,SAAS,IAAI,EAAE,UAAU,SAAS,IAAI,GAAG,QAAQ,EAC/E,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,UAAU,CAAC;AAoBd,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAEzD;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,qBAAqB,CAAC;AAE3D,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAE9E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,SAAqB,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAEnH"}

package/dist/date.js

@@ -0,0 +1,27 @@
+import { format, formatISO, set } from "date-fns";
+import { take } from "ramda";
+import { parseInteger } from "./number.js";
+export function setTime(date, timeOrHour, optMinutes) {
+    let hours;
+    let minutes;
+    if (typeof timeOrHour === "string") {
+        [hours, minutes] = take(2, timeOrHour.split(":", 3)).map(parseInteger);
+    }
+    else {
+        hours = timeOrHour;
+        minutes = optMinutes;
+    }
+    return set(date, { hours, minutes, seconds: 0, milliseconds: 0 });
+}
+export function formatDate(date) {
+    return format(date, "yyyy-MM-dd");
+}
+export function formatISODate(date) {
+    return formatISO(date, { representation: "date" });
+}
+export function formatTime(date, options = {}) {
+    return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit", ...options });
+}
+export function formatDateTime(date, formatStr = "yyyy-MM-dd HH:mm", options) {
+    return format(date, formatStr, options);
+}

package/dist/enum.d.ts

@@ -0,0 +1,6 @@
+export type Option<T extends string> = {
+    id: T;
+    label: string;
+};
+export declare function enumToOptions<T extends string>(enums: T[], labelFunction?: (value: T) => string): Option<T>[];
+//# sourceMappingURL=enum.d.ts.map

package/dist/enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../src/enum.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,MAAM,IAAI;IACrC,EAAE,EAAE,CAAC,CAAC;IACN,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,KAAK,EAAE,CAAC,EAAE,EACV,aAAa,GAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAiB,GAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,CAOb"}

package/dist/enum.js

@@ -0,0 +1,9 @@
+import { identity } from "ramda";
+export function enumToOptions(enums, labelFunction = identity) {
+    return enums
+        .map((value) => ({
+        id: value,
+        label: labelFunction(value),
+    }))
+        .sort((a, b) => a.label.localeCompare(b.label));
+}

package/dist/file.d.ts

@@ -0,0 +1,4 @@
+export declare function getExtension(filename: string): string | undefined;
+export declare function getBasename(filename: string): string;
+export declare function fileIdentityKey(file: File): string;
+//# sourceMappingURL=file.d.ts.map

package/dist/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,sBAQ5C;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,UAI3C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,UAEzC"}

package/dist/file.js

@@ -0,0 +1,14 @@
+export function getExtension(filename) {
+    const lastDotIndex = filename.lastIndexOf(".");
+    if (lastDotIndex <= 0 || lastDotIndex === filename.length - 1) {
+        return undefined;
+    }
+    return filename.slice(lastDotIndex + 1).toLowerCase();
+}
+export function getBasename(filename) {
+    const lastDotIndex = filename.lastIndexOf(".");
+    return lastDotIndex === -1 ? filename : filename.slice(0, lastDotIndex);
+}
+export function fileIdentityKey(file) {
+    return `${file.name}-${file.size}-${file.lastModified}`;
+}

package/dist/humanize.d.ts

@@ -0,0 +1,22 @@
+import type { DateArg } from "date-fns";
+export declare function humanBytes(input: number): string;
+export declare function humanCount(count: number, word: string): string;
+export declare function humanNumber(num: bigint | number): string;
+export declare function humanizeEnum(value: string | undefined): string | undefined;
+export declare function humanDimensions({ width, height }: {
+    width: number;
+    height: number;
+}): string;
+export declare function humanPlural(word: string, count: number): string;
+export type HumanListOptions = {
+    truncateAt?: number;
+    conjunction?: string;
+};
+export declare function humanList(list: string[], options?: HumanListOptions): string;
+export type HumanDurationArgs = {
+    start: DateArg<Date>;
+    end: DateArg<Date>;
+    largest?: number;
+};
+export declare function humanDuration(args: HumanDurationArgs): string;
+//# sourceMappingURL=humanize.d.ts.map

package/dist/humanize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"humanize.d.ts","sourceRoot":"","sources":["../src/humanize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA0B,MAAM,UAAU,CAAC;AAOhE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CASxD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAS1E;AAED,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE5F;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAc5E;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAYF,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAW7D"}

package/dist/humanize.js

@@ -0,0 +1,70 @@
+import { formatDuration, intervalToDuration } from "date-fns";
+import { filesize } from "filesize";
+import humanizeList from "humanize-list";
+import pluralize from "pluralize";
+import { isPresent } from "./present.js";
+export function humanBytes(input) {
+    return filesize(input, {
+        base: 2,
+        separator: ".",
+        standard: "jedec",
+    });
+}
+export function humanCount(count, word) {
+    return pluralize(word, count, true);
+}
+export function humanNumber(num) {
+    const n = Number(num);
+    if (n >= 1000000) {
+        return `${(n / 1000000).toFixed(1)}M`;
+    }
+    if (n >= 1000) {
+        return `${(n / 1000).toFixed(1)}K`;
+    }
+    return n.toString();
+}
+export function humanizeEnum(value) {
+    if (!isPresent(value))
+        return undefined;
+    return value
+        .toLowerCase()
+        .split(/[_-]/)
+        .filter(isPresent)
+        .map((word) => `${word.charAt(0).toUpperCase()}${word.slice(1)}`)
+        .join(" ");
+}
+export function humanDimensions({ width, height }) {
+    return `${width}x${height}`;
+}
+export function humanPlural(word, count) {
+    return pluralize(word, count, false);
+}
+export function humanList(list, options) {
+    const { truncateAt, conjunction = "and" } = options || {};
+    if (!truncateAt || list.length <= truncateAt) {
+        return humanizeList(list, {
+            oxfordComma: list.length > 2,
+            conjunction,
+        });
+    }
+    const remaining = list.length - truncateAt;
+    const truncated = [...list.slice(0, truncateAt), `+${remaining} more`];
+    return humanizeList(truncated, { oxfordComma: true, conjunction });
+}
+const periods = ["years", "months", "weeks", "days", "hours", "minutes", "seconds"];
+function getDurationFormat(duration, largest) {
+    const formats = periods.reduce((acc, period) => {
+        return acc.length < largest && duration[period] ? [...acc, period] : acc;
+    }, []);
+    return formats.length === 0 ? ["seconds"] : formats;
+}
+export function humanDuration(args) {
+    const { start, end, largest } = args;
+    const duration = intervalToDuration({
+        start,
+        end,
+    });
+    return formatDuration(duration, {
+        format: largest ? getDurationFormat(duration, largest) : undefined,
+    });
+}

package/dist/identifier-words.d.ts

@@ -0,0 +1,3 @@
+export declare const identifierWordRules: ReadonlyArray<readonly [pattern: string, replacement: string]>;
+export declare function splitIdentifierWords(raw: string): string;
+//# sourceMappingURL=identifier-words.d.ts.map

package/dist/identifier-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier-words.d.ts","sourceRoot":"","sources":["../src/identifier-words.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAQ9F,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIxD"}

package/dist/identifier-words.js

@@ -0,0 +1,15 @@
+// Splits a programmer identifier into words: `actionPlan_v2` becomes `action Plan v2`.
+export const identifierWordRules = [
+    ["_", " "],
+    ["([a-z])([A-Z])", "$1 $2"],
+    ["([A-Z])([A-Z][a-z])", "$1 $2"],
+    ["([a-z])([0-9])", "$1 $2"],
+    ["([0-9])([A-Z][a-z])", "$1 $2"],
+    ["([0-9]+)x", " $1x"],
+    ["  *", " "],
+];
+export function splitIdentifierWords(raw) {
+    return identifierWordRules
+        .reduce((text, [pattern, replacement]) => text.replace(new RegExp(pattern, "g"), replacement), raw)
+        .trim();
+}

package/dist/number.d.ts

@@ -0,0 +1,2 @@
+export declare function parseInteger(input?: string | null): number | undefined;
+//# sourceMappingURL=number.d.ts.map

package/dist/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../src/number.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAStE"}

package/dist/number.js

@@ -0,0 +1,9 @@
+export function parseInteger(input) {
+    if (input && input.trim().length > 0) {
+        const number = parseInt(input, 10);
+        if (!isNaN(number)) {
+            return number;
+        }
+    }
+    return;
+}

package/dist/object-url.d.ts

@@ -0,0 +1,3 @@
+export declare const createObjectURL: (file: File | Blob | undefined) => string;
+export declare const revokeObjectURL: (url: string) => void;
+//# sourceMappingURL=object-url.d.ts.map

package/dist/object-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-url.d.ts","sourceRoot":"","sources":["../src/object-url.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,GAAI,MAAM,IAAI,GAAG,IAAI,GAAG,SAAS,KAAG,MAG/D,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,IAI7C,CAAC"}

package/dist/object-url.js

@@ -0,0 +1,10 @@
+export const createObjectURL = (file) => {
+    if (!file)
+        return "";
+    return URL.createObjectURL(file);
+};
+export const revokeObjectURL = (url) => {
+    if (url && url.startsWith("blob:")) {
+        URL.revokeObjectURL(url);
+    }
+};

package/dist/present.d.ts

@@ -0,0 +1,5 @@
+export declare function isPresent(value: string | null | undefined): value is string;
+export declare function isPresent<T>(value: T[] | null | undefined): value is [T, ...T[]];
+export declare function isPresent(value: Record<string, unknown> | null | undefined): value is Record<string, unknown>;
+export declare function isPresent<T>(value: T | null | undefined): value is T;
+//# sourceMappingURL=present.d.ts.map

package/dist/present.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"present.d.ts","sourceRoot":"","sources":["../src/present.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAAC;AAC7E,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC/G,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAAC"}

package/dist/present.js

@@ -0,0 +1,23 @@
+// After https://apidock.com/rails/Object/blank%3F
+export function isPresent(value) {
+    if (value === null || value === undefined || value === false) {
+        return false;
+    }
+    if (typeof value === "string") {
+        return value.trim().length > 0;
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    if (typeof value === "object") {
+        if (Object.keys(value).length > 0)
+            return true;
+        if (value instanceof Map || value instanceof Set)
+            return value.size > 0;
+        if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer)
+            return value.byteLength > 0;
+        const prototype = Object.getPrototypeOf(value);
+        return prototype !== Object.prototype && prototype !== null;
+    }
+    return true;
+}

package/dist/set.d.ts

@@ -0,0 +1,3 @@
+export declare function addAll<T>(set: Set<T>, items: Array<T>): void;
+export declare function addAll<T>(set: Set<T>, other: Set<T>): void;
+//# sourceMappingURL=set.d.ts.map

package/dist/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../src/set.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAC9D,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC"}

package/dist/set.js

@@ -0,0 +1,11 @@
+export function addAll(set, items) {
+    if (Array.isArray(items)) {
+        items.forEach((item) => set.add(item));
+        return;
+    }
+    if (items instanceof Set) {
+        items.forEach((item) => set.add(item));
+        return;
+    }
+    throw new Error("Unsupported type");
+}

package/dist/sleep.d.ts

@@ -0,0 +1,2 @@
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../src/sleep.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/sleep.js

@@ -0,0 +1,3 @@
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/string.d.ts

@@ -0,0 +1,8 @@
+export declare function trimLines(input: string): string;
+export type GetInitialsArgs = {
+    name: string;
+    separator?: " ";
+    maxCount?: number;
+};
+export declare function getInitials(args: GetInitialsArgs): string;
+//# sourceMappingURL=string.d.ts.map

package/dist/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,UAEtC;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,UAShD"}

package/dist/string.js

@@ -0,0 +1,13 @@
+import { trim } from "ramda";
+export function trimLines(input) {
+    return input.split("\n").map(trim).join("\n");
+}
+export function getInitials(args) {
+    const { name, separator = " ", maxCount = 2 } = args;
+    return name
+        .split(separator)
+        .map((part) => part.match(/[a-zA-Z]/)?.[0]?.toUpperCase())
+        .filter(Boolean)
+        .slice(0, maxCount)
+        .join("");
+}

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+export type Awaitable<T> = T | Promise<T>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/url.d.ts

@@ -0,0 +1,9 @@
+export type URLLike = URL | string;
+export declare function toURL(url: URLLike): URL;
+export declare function ensureProtocol(input: string): string;
+export declare function getHostname(url: URLLike): string;
+export declare function isHttpURL(url: URLLike): boolean;
+export type ParamsInput = URLSearchParams | Map<string, string> | Record<string, string>;
+export declare function mergeAll(to: URLSearchParams, params: ParamsInput): URLSearchParams;
+export declare function mergeURLParams(url: URL, params: ParamsInput): URL;
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,GAAG,GAAG,MAAM,CAAC;AAEnC,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAEvC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQ/C;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzF,wBAAgB,QAAQ,CAAC,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,GAAG,eAAe,CAelF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,GAAG,GAAG,CAGjE"}

package/dist/url.js

@@ -0,0 +1,40 @@
+export function toURL(url) {
+    return typeof url === "string" ? new URL(url) : url;
+}
+export function ensureProtocol(input) {
+    return /^https?:\/\//i.test(input) ? input : `https://${input}`;
+}
+export function getHostname(url) {
+    return toURL(url).hostname;
+}
+export function isHttpURL(url) {
+    try {
+        const parsed = toURL(url);
+        return parsed.protocol === "http:" || parsed.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+export function mergeAll(to, params) {
+    if (params instanceof URLSearchParams) {
+        for (const [key, value] of params) {
+            to.set(key, value);
+        }
+    }
+    else if (params instanceof Map) {
+        for (const [key, value] of params) {
+            to.set(key, value);
+        }
+    }
+    else {
+        for (const [key, value] of Object.entries(params)) {
+            to.set(key, value);
+        }
+    }
+    return to;
+}
+export function mergeURLParams(url, params) {
+    mergeAll(url.searchParams, params);
+    return url;
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@manta-eu/lib",
+  "version": "0.1.0",
+  "description": "Pure TypeScript helpers shared across the Manta packages",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "date-fns": "^4.1.0",
+    "filesize": "^11.0.2",
+    "humanize-list": "^1.0.1",
+    "pluralize": "^8.0.0",
+    "ramda": "^0.32.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.100.10",
+    "@types/node": "^20.0.0",
+    "@types/pluralize": "^0.0.33",
+    "@types/ramda": "^0.31.1",
+    "@types/react": "^19.2.7",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.0.0",
+    "prettier": "^3.6.2",
+    "react": "^19.2.3",
+    "sonner": "^1.7.4",
+    "tsc-alias": "^1.9.5",
+    "typescript": "^5.0.0",
+    "usehooks-ts": "^3.1.1",
+    "vitest": "^3.0.0",
+    "@manta-eu/eslint-config": "0.1.0"
+  },
+  "prettier": {
+    "printWidth": 120
+  },
+  "imports": {
+    "#*": {
+      "manta-source": [
+        "./src/*",
+        "./src/*.ts",
+        "./src/*.tsx",
+        "./src/*/index.ts",
+        "./src/*/index.tsx"
+      ],
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json && tsc-alias --project tsconfig.build.json --resolve-full-paths",
+    "build:lib": "tsc --project tsconfig.build.json",
+    "test": "vitest --run",
+    "test:watch": "vitest --watch",
+    "check": "vitest --run",
+    "types": "tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  }
+}