@react-pakistan/util-functions 1.25.89 → 2.0.0

package/general/format-date.d.ts

@@ -1,4 +1,4 @@
-export declare enum DATE_FORMATS {
+declare enum DATE_FORMATS {
     LOCALE_DATE = "LOCALE_DATE",
     DD_MM = "DD_MM",
     YYYY_MM_DD = "YYYY_MM_DD",
@@ -7,4 +7,12 @@ export declare enum DATE_FORMATS {
     HH_MM_AM_PM = "HH_MM_AM_PM",
     HH_MM_SS_AM_PM = "HH_MM_SS_AM_PM"
 }
-export declare const formatDate: (str: string, format: DATE_FORMATS) => string;
+/**
+ * Formats a date string into the specified DATE_FORMATS format.
+ * @param str - A date string parsable by Date constructor.
+ * @param format - The target DATE_FORMATS format.
+ * @returns The formatted date string.
+ */
+declare const formatDate: (str: string, format: DATE_FORMATS) => string;
+
+export { DATE_FORMATS, formatDate };

package/general/format-date.js

@@ -1,49 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatDate = exports.DATE_FORMATS = void 0;
-var get_day_name_1 = require("./get-day-name");
-var get_month_name_1 = require("./get-month-name");
-var DATE_FORMATS;
-(function (DATE_FORMATS) {
-    DATE_FORMATS["LOCALE_DATE"] = "LOCALE_DATE";
-    DATE_FORMATS["DD_MM"] = "DD_MM";
-    DATE_FORMATS["YYYY_MM_DD"] = "YYYY_MM_DD";
-    DATE_FORMATS["DAY_DD_MM_YYYY"] = "DAY_DD_MM_YYYY";
-    DATE_FORMATS["DAY_DD_MM_YY_COMPACT"] = "DAY_DD_MM_YY_COMPACT";
-    DATE_FORMATS["HH_MM_AM_PM"] = "HH_MM_AM_PM";
-    DATE_FORMATS["HH_MM_SS_AM_PM"] = "HH_MM_SS_AM_PM";
-})(DATE_FORMATS || (exports.DATE_FORMATS = DATE_FORMATS = {}));
-var formatDate = function (str, format) {
-    var _a;
-    var _b, _c;
-    var dateObj = new Date(str);
-    var cleanMonthNumber = dateObj.getMonth() + 1;
-    var monthNumberInTwoDigits = String(cleanMonthNumber).length < 2
-        ? "0".concat(cleanMonthNumber)
-        : cleanMonthNumber;
-    var cleanDateNumber = dateObj.getDate();
-    var dateNumberInTowDigits = String(cleanDateNumber).length < 2
-        ? "0".concat(cleanDateNumber)
-        : cleanDateNumber;
-    // Format time for HH:MM AM/PM and HH:MM:SS AM/PM
-    var hours = dateObj.getHours();
-    var minutes = dateObj.getMinutes();
-    var seconds = dateObj.getSeconds();
-    var ampm = hours >= 12 ? 'PM' : 'AM';
-    hours = hours % 12;
-    hours = hours ? hours : 12; // the hour '0' should be '12'
-    var minutesInTwoDigits = minutes < 10 ? "0".concat(minutes) : minutes;
-    var secondsInTwoDigits = seconds < 10 ? "0".concat(seconds) : seconds;
-    var hoursInTwoDigits = hours < 10 ? "0".concat(hours) : hours;
-    var dateMap = (_a = {},
-        _a[DATE_FORMATS.LOCALE_DATE] = dateObj.toLocaleDateString(),
-        _a[DATE_FORMATS.DD_MM] = "".concat(dateObj.getDate(), " ").concat((0, get_month_name_1.getMonthName)(dateObj.getMonth())),
-        _a[DATE_FORMATS.YYYY_MM_DD] = "".concat(dateObj.getFullYear(), "-").concat(monthNumberInTwoDigits, "-").concat(dateNumberInTowDigits),
-        _a[DATE_FORMATS.DAY_DD_MM_YYYY] = "".concat((0, get_day_name_1.getDayName)(dateObj.getDay()), ", ").concat(dateObj.getDate(), " ").concat((0, get_month_name_1.getMonthName)(dateObj.getMonth()), " ").concat(dateObj.getFullYear()),
-        _a[DATE_FORMATS.DAY_DD_MM_YY_COMPACT] = "".concat((_b = (0, get_day_name_1.getDayName)(dateObj.getDay())) === null || _b === void 0 ? void 0 : _b.slice(0, 3), ", ").concat(dateObj.getDate(), " ").concat((0, get_month_name_1.getMonthName)(dateObj.getMonth()), " ").concat((_c = String(dateObj.getFullYear())) === null || _c === void 0 ? void 0 : _c.slice(2, 5)),
-        _a[DATE_FORMATS.HH_MM_AM_PM] = "".concat(hoursInTwoDigits, ":").concat(minutesInTwoDigits, " ").concat(ampm),
-        _a[DATE_FORMATS.HH_MM_SS_AM_PM] = "".concat(hoursInTwoDigits, ":").concat(minutesInTwoDigits, ":").concat(secondsInTwoDigits, " ").concat(ampm),
-        _a);
-    return dateMap[format];
-};
-exports.formatDate = formatDate;
+var a=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var S=(_,e)=>{for(var t in e)a(_,t,{get:e[t],enumerable:!0})},h=(_,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let D of H(e))!T.call(_,D)&&D!==t&&a(_,D,{get:()=>e[D],enumerable:!(n=l(e,D))||n.enumerable});return _};var P=_=>h(a({},"__esModule",{value:!0}),_);var O={};S(O,{DATE_FORMATS:()=>c,formatDate:()=>C});module.exports=P(O);var r=require("./get-day-name"),o=require("./get-month-name"),c=(M=>(M.LOCALE_DATE="LOCALE_DATE",M.DD_MM="DD_MM",M.YYYY_MM_DD="YYYY_MM_DD",M.DAY_DD_MM_YYYY="DAY_DD_MM_YYYY",M.DAY_DD_MM_YY_COMPACT="DAY_DD_MM_YY_COMPACT",M.HH_MM_AM_PM="HH_MM_AM_PM",M.HH_MM_SS_AM_PM="HH_MM_SS_AM_PM",M))(c||{});const C=(_,e)=>{const t=new Date(_),n=t.getMonth()+1,D=String(n).length<2?`0${n}`:n,Y=t.getDate(),m=String(Y).length<2?`0${Y}`:Y;let M=t.getHours();const s=t.getMinutes(),g=t.getSeconds(),$=M>=12?"PM":"AM";M=M%12,M=M||12;const A=s<10?`0${s}`:s,u=g<10?`0${g}`:g,i=M<10?`0${M}`:M;return{LOCALE_DATE:t.toLocaleDateString(),DD_MM:`${t.getDate()} ${(0,o.getMonthName)(t.getMonth())}`,YYYY_MM_DD:`${t.getFullYear()}-${D}-${m}`,DAY_DD_MM_YYYY:`${(0,r.getDayName)(t.getDay())}, ${t.getDate()} ${(0,o.getMonthName)(t.getMonth())} ${t.getFullYear()}`,DAY_DD_MM_YY_COMPACT:`${(0,r.getDayName)(t.getDay())?.slice(0,3)}, ${t.getDate()} ${(0,o.getMonthName)(t.getMonth())} ${String(t.getFullYear())?.slice(2,5)}`,HH_MM_AM_PM:`${i}:${A} ${$}`,HH_MM_SS_AM_PM:`${i}:${A}:${u} ${$}`}[e]};0&&(module.exports={DATE_FORMATS,formatDate});

package/general/format-number.d.ts

@@ -1,6 +1,16 @@
-export type FormatOptions = {
+type FormatOptions = {
     decimals?: number;
     useLocale?: boolean;
     customSuffixes?: Array<string>;
 };
-export declare const formatNumber: (input: any, options?: FormatOptions) => string;
+/**
+ * Formats a number with abbreviations (K, M, B, etc.) and optional locale formatting.
+ * @param input - The number or numeric string to format.
+ * @param options.decimals - Number of decimal places (default 2).
+ * @param options.useLocale - Whether to use locale separators (default true).
+ * @param options.customSuffixes - Custom suffix array for magnitudes.
+ * @returns The formatted number string.
+ */
+declare const formatNumber: (input: any, options?: FormatOptions) => string;
+
+export { type FormatOptions, formatNumber };

package/general/format-number.js

@@ -1,35 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatNumber = void 0;
-var formatNumber = function (input, options) {
-    if (options === void 0) { options = {}; }
-    var _a = options.decimals, decimals = _a === void 0 ? 2 : _a, _b = options.useLocale, useLocale = _b === void 0 ? true : _b, customSuffixes = options.customSuffixes;
-    // Attempt to convert input to a number
-    var number = Number(input);
-    if (Number.isNaN(number) || !Number.isFinite(number)) {
-        return 'Invalid number';
-    }
-    if (input === 0 || input === '0') {
-        return '0';
-    }
-    var absNumber = Math.abs(number);
-    var sign = number < 0 ? '-' : '';
-    // Define suffixes (default or custom)
-    var defaultSuffixes = ['', 'K', 'M', 'B', 'T', 'Q'];
-    var suffixes = customSuffixes || defaultSuffixes;
-    // Find magnitude
-    var tier = Math.floor(Math.log10(absNumber) / 3);
-    if (tier === 0) {
-        var formatted_1 = useLocale
-            ? absNumber.toLocaleString()
-            : absNumber.toFixed(decimals);
-        return sign + formatted_1;
-    }
-    var suffix = suffixes[tier] || "e".concat(tier * 3);
-    var scale = Math.pow(10, tier * 3);
-    var scaled = absNumber / scale;
-    var rounded = scaled.toFixed(decimals);
-    var formatted = useLocale ? Number(rounded).toLocaleString() : rounded;
-    return "".concat(sign).concat(formatted).concat(suffix);
-};
-exports.formatNumber = formatNumber;
+var u=Object.defineProperty;var N=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var F=(t,e)=>{for(var o in e)u(t,o,{get:e[o],enumerable:!0})},M=(t,e,o,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of g(e))!S.call(t,s)&&s!==o&&u(t,s,{get:()=>e[s],enumerable:!(r=N(e,s))||r.enumerable});return t};var h=t=>M(u({},"__esModule",{value:!0}),t);var L={};F(L,{formatNumber:()=>p});module.exports=h(L);const p=(t,e={})=>{const{decimals:o=2,useLocale:r=!0,customSuffixes:s}=e,n=Number(t);if(Number.isNaN(n)||!Number.isFinite(n))return"Invalid number";if(t===0||t==="0")return"0";const a=Math.abs(n),i=n<0?"-":"",m=s||["","K","M","B","T","Q"],c=Math.floor(Math.log10(a)/3);if(c===0){const x=r?a.toLocaleString():a.toFixed(o);return i+x}const l=m[c]||`e${c*3}`,d=Math.pow(10,c*3),f=(a/d).toFixed(o),b=r?Number(f).toLocaleString():f;return`${i}${b}${l}`};0&&(module.exports={formatNumber});

package/general/format-phone-display.d.ts

@@ -1 +1,9 @@
-export declare function formatPhoneDisplay(value: unknown, defaultCountry?: string): string | undefined;
+/**
+ * Formats a phone number for display in international format with fallback.
+ * @param value - The raw phone number value.
+ * @param defaultCountry - Optional default country code for parsing.
+ * @returns The formatted phone number, or undefined if invalid.
+ */
+declare function formatPhoneDisplay(value: unknown, defaultCountry?: string): string | undefined;
+
+export { formatPhoneDisplay };

package/general/format-phone-display.js

@@ -1,32 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatPhoneDisplay = formatPhoneDisplay;
-var libphonenumber_js_1 = require("libphonenumber-js");
-function formatPhoneDisplay(value, defaultCountry) {
-    if (value === null || value === undefined)
-        return undefined;
-    var input = String(value).trim();
-    if (input === '')
-        return undefined;
-    try {
-        // First attempt: parse the input as-is (handles +E.164 and numbers with punctuation)
-        var pn = (0, libphonenumber_js_1.parsePhoneNumberFromString)(input, defaultCountry);
-        // If parse failed and input is digits-only, try parsing as E.164 by prefixing +
-        if ((!pn || !pn.isValid()) && /^\d+$/.test(input)) {
-            pn = (0, libphonenumber_js_1.parsePhoneNumberFromString)("+".concat(input));
-        }
-        if (pn && pn.isValid()) {
-            return pn.formatInternational();
-        }
-    }
-    catch (_a) {
-        // fall through to digits-only fallback
-    }
-    // Fallback: return digits-only or prefixed with + for long international-like numbers
-    var digits = input.replace(/\D/g, '');
-    if (!digits)
-        return undefined;
-    if (digits.length > 12)
-        return "+".concat(digits);
-    return digits;
-}
+var f=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var a=(r,t)=>{for(var i in t)f(r,i,{get:t[i],enumerable:!0})},g=(r,t,i,e)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of o(t))!s.call(r,n)&&n!==i&&f(r,n,{get:()=>t[n],enumerable:!(e=u(t,n))||e.enumerable});return r};var l=r=>g(f({},"__esModule",{value:!0}),r);var p={};a(p,{formatPhoneDisplay:()=>m});module.exports=l(p);var d=require("libphonenumber-js");function m(r,t){if(r==null)return;const i=String(r).trim();if(i==="")return;try{let n=(0,d.parsePhoneNumberFromString)(i,t);if((!n||!n.isValid())&&/^\d+$/.test(i)&&(n=(0,d.parsePhoneNumberFromString)(`+${i}`)),n&&n.isValid())return n.formatInternational()}catch{}const e=i.replace(/\D/g,"");if(e)return e.length>12?`+${e}`:e}0&&(module.exports={formatPhoneDisplay});

package/general/format-phone.d.ts

@@ -1,7 +1,15 @@
 import { CountryCode } from 'libphonenumber-js';
+
 interface FormattedPhoneNumber {
     e164: string;
     international: string;
 }
-export declare const formatPhone: (phone: string, defaultCountry?: CountryCode) => FormattedPhoneNumber | null;
-export {};
+/**
+ * Parses and formats a phone number into E.164 and international formats.
+ * @param phone - The phone number string.
+ * @param defaultCountry - Default country code (default 'US').
+ * @returns Object with `e164` and `international` strings, or null if invalid.
+ */
+declare const formatPhone: (phone: string, defaultCountry?: CountryCode) => FormattedPhoneNumber | null;
+
+export { formatPhone };

package/general/format-phone.js

@@ -1,20 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatPhone = void 0;
-var libphonenumber_js_1 = require("libphonenumber-js");
-var formatPhone = function (phone, defaultCountry) {
-    if (defaultCountry === void 0) { defaultCountry = 'US'; }
-    var updatedPhone = phone;
-    if (!phone.startsWith('+')) {
-        updatedPhone = "+".concat(phone);
-    }
-    var phoneNumber = (0, libphonenumber_js_1.parsePhoneNumberFromString)(updatedPhone, defaultCountry);
-    if (phoneNumber && phoneNumber.isValid()) {
-        return {
-            e164: phoneNumber.format('E.164'),
-            international: phoneNumber.formatInternational(),
-        };
-    }
-    return null;
-};
-exports.formatPhone = formatPhone;
+var a=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var s=(t,r)=>{for(var n in r)a(t,n,{get:r[n],enumerable:!0})},d=(t,r,n,e)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of u(r))!l.call(t,o)&&o!==n&&a(t,o,{get:()=>r[o],enumerable:!(e=m(r,o))||e.enumerable});return t};var f=t=>d(a({},"__esModule",{value:!0}),t);var P={};s(P,{formatPhone:()=>h});module.exports=f(P);var i=require("libphonenumber-js");const h=(t,r="US")=>{let n=t;t.startsWith("+")||(n=`+${t}`);const e=(0,i.parsePhoneNumberFromString)(n,r);return e&&e.isValid()?{e164:e.format("E.164"),international:e.formatInternational()}:null};0&&(module.exports={formatPhone});

package/general/format-pricing.d.ts

@@ -1 +1,8 @@
-export declare const formatPricing: (value: string | number) => string;
+/**
+ * Formats a number or numeric string as a USD price with 2 decimal places.
+ * @param value - The price value as a number or string.
+ * @returns The formatted price string.
+ */
+declare const formatPricing: (value: string | number) => string;
+
+export { formatPricing };

package/general/format-pricing.js

@@ -1,23 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatPricing = void 0;
-var formatPricing = function (value) {
-    var result = '';
-    if (typeof value === 'string') {
-        var pricing = Number(value).toFixed(2);
-        var formattedPrice = new Intl.NumberFormat('en-US', {
-            minimumFractionDigits: 2,
-            maximumFractionDigits: 2,
-        }).format(Number(pricing));
-        result = formattedPrice;
-    }
-    if (typeof value === 'number') {
-        var formattedPrice = new Intl.NumberFormat('en-US', {
-            minimumFractionDigits: 2,
-            maximumFractionDigits: 2,
-        }).format(Number(value));
-        result = formattedPrice;
-    }
-    return result;
-};
-exports.formatPricing = formatPricing;
+var e=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var s=(r,t)=>{for(var i in t)e(r,i,{get:t[i],enumerable:!0})},f=(r,t,i,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let m of c(t))!a.call(r,m)&&m!==i&&e(r,m,{get:()=>t[m],enumerable:!(n=o(t,m))||n.enumerable});return r};var u=r=>f(e({},"__esModule",{value:!0}),r);var b={};s(b,{formatPricing:()=>g});module.exports=u(b);const g=r=>{let t="";if(typeof r=="string"){const i=Number(r).toFixed(2);t=new Intl.NumberFormat("en-US",{minimumFractionDigits:2,maximumFractionDigits:2}).format(Number(i))}return typeof r=="number"&&(t=new Intl.NumberFormat("en-US",{minimumFractionDigits:2,maximumFractionDigits:2}).format(Number(r))),t};0&&(module.exports={formatPricing});

package/general/format-secs.d.ts

@@ -1 +1,8 @@
-export declare const formatSecs: (sec: number) => string;
+/**
+ * Formats seconds into a human-readable `Xh Ym Zs` string (handles negative values).
+ * @param sec - The number of seconds.
+ * @returns The formatted duration string.
+ */
+declare const formatSecs: (sec: number) => string;
+
+export { formatSecs };

package/general/format-secs.js

@@ -1,21 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatSecs = void 0;
-var formatSecs = function (sec) {
-    if (sec >= 0) {
-        var hours = Math.floor(sec / 3600);
-        var minutes = Math.floor((sec % 3600) / 60);
-        var secs = sec % 60;
-        return "".concat(hours, "h ").concat(minutes, "m ").concat(secs, "s");
-    }
-    else {
-        // For negative seconds, convert to negative hours and positive minutes/seconds
-        var absSec = Math.abs(sec);
-        var hours = -Math.ceil(absSec / 3600);
-        var remaining = absSec % 3600;
-        var minutes = Math.floor((3600 - remaining) / 60) % 60;
-        var secs = (60 - (absSec % 60)) % 60;
-        return "".concat(hours, "h ").concat(minutes, "m ").concat(secs, "s");
-    }
-};
-exports.formatSecs = formatSecs;
+var c=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var u=(o,t)=>{for(var s in t)c(o,s,{get:t[s],enumerable:!0})},i=(o,t,s,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of h(t))!m.call(o,n)&&n!==s&&c(o,n,{get:()=>t[n],enumerable:!(r=a(t,n))||r.enumerable});return o};var $=o=>i(c({},"__esModule",{value:!0}),o);var l={};u(l,{formatSecs:()=>f});module.exports=$(l);const f=o=>{if(o>=0){const t=Math.floor(o/3600),s=Math.floor(o%3600/60),r=o%60;return`${t}h ${s}m ${r}s`}else{const t=Math.abs(o),s=-Math.ceil(t/3600),r=t%3600,n=Math.floor((3600-r)/60)%60,e=(60-t%60)%60;return`${s}h ${n}m ${e}s`}};0&&(module.exports={formatSecs});

package/general/format-time.d.ts

@@ -1,5 +1,11 @@
 interface Params {
     seconds: number;
 }
-export declare const formatDuration: ({ seconds }: Params) => string;
-export {};
+/**
+ * Formats a duration in seconds into a human-friendly string (e.g. "2 mins and 30 secs").
+ * @param params.seconds - Duration in seconds (non-negative integer).
+ * @returns The formatted duration string.
+ */
+declare const formatDuration: ({ seconds }: Params) => string;
+
+export { formatDuration };

package/general/format-time.js

@@ -1,38 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatDuration = void 0;
-var units = [
-    { divisor: 86400, singular: 'day', plural: 'days' },
-    { divisor: 3600, singular: 'hour', plural: 'hours' },
-    { divisor: 60, singular: 'min', plural: 'mins' },
-    { divisor: 1, singular: 'sec', plural: 'secs' },
-];
-var formatDuration = function (_a) {
-    var seconds = _a.seconds;
-    /* Edge Case Handling */
-    if (typeof seconds !== 'number' ||
-        seconds < 0 ||
-        !Number.isInteger(seconds)) {
-        throw new Error('Invalid input: must be a non-negative integer');
-    }
-    var remaining = seconds;
-    var parts = [];
-    for (var _i = 0, units_1 = units; _i < units_1.length; _i++) {
-        var unit = units_1[_i];
-        var value = Math.floor(remaining / unit.divisor);
-        remaining %= unit.divisor;
-        if (value > 0) {
-            parts.push("".concat(value, " ").concat(value === 1 ? unit.singular : unit.plural));
-        }
-    }
-    /* Handle 0 seconds case */
-    if (parts.length === 0) {
-        var smallestUnit = units[units.length - 1];
-        return "0 ".concat(smallestUnit.plural);
-    }
-    /* Human-friendly joining */
-    return parts.length > 1
-        ? "".concat(parts.slice(0, -1).join(', '), " and ").concat(parts[parts.length - 1])
-        : parts[0];
-};
-exports.formatDuration = formatDuration;
+var a=Object.defineProperty;var e=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var o=Object.prototype.hasOwnProperty;var g=(r,i)=>{for(var n in i)a(r,n,{get:i[n],enumerable:!0})},m=(r,i,n,s)=>{if(i&&typeof i=="object"||typeof i=="function")for(let t of u(i))!o.call(r,t)&&t!==n&&a(r,t,{get:()=>i[t],enumerable:!(s=e(i,t))||s.enumerable});return r};var p=r=>m(a({},"__esModule",{value:!0}),r);var h={};g(h,{formatDuration:()=>f});module.exports=p(h);const l=[{divisor:86400,singular:"day",plural:"days"},{divisor:3600,singular:"hour",plural:"hours"},{divisor:60,singular:"min",plural:"mins"},{divisor:1,singular:"sec",plural:"secs"}],f=({seconds:r})=>{if(typeof r!="number"||r<0||!Number.isInteger(r))throw new Error("Invalid input: must be a non-negative integer");let i=r;const n=[];for(const s of l){const t=Math.floor(i/s.divisor);i%=s.divisor,t>0&&n.push(`${t} ${t===1?s.singular:s.plural}`)}return n.length===0?`0 ${l[l.length-1].plural}`:n.length>1?`${n.slice(0,-1).join(", ")} and ${n[n.length-1]}`:n[0]};0&&(module.exports={formatDuration});

package/general/format-value.d.ts

@@ -1 +1,8 @@
-export declare const formatValue: (v?: string | number | null) => string;
+/**
+ * Returns a string representation of a value, or an em dash if null/undefined/empty.
+ * @param v - The value to format.
+ * @returns The string representation or '—'.
+ */
+declare const formatValue: (v?: string | number | null) => string;
+
+export { formatValue };

package/general/format-value.js

@@ -1,7 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatValue = void 0;
-var formatValue = function (v) {
-    return v === undefined || v === null || v === '' ? '—' : String(v);
-};
-exports.formatValue = formatValue;
+var t=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var d=(n,e)=>{for(var r in e)t(n,r,{get:e[r],enumerable:!0})},f=(n,e,r,u)=>{if(e&&typeof e=="object"||typeof e=="function")for(let l of o(e))!a.call(n,l)&&l!==r&&t(n,l,{get:()=>e[l],enumerable:!(u=i(e,l))||u.enumerable});return n};var g=n=>f(t({},"__esModule",{value:!0}),n);var s={};d(s,{formatValue:()=>m});module.exports=g(s);const m=n=>n==null||n===""?"\u2014":String(n);0&&(module.exports={formatValue});

package/general/full-month-range.d.ts

@@ -8,5 +8,6 @@ interface Return {
  * @param year - The year. Defaults to current year.
  * @returns An object containing startOfMonth and endOfMonth dates in UTC
  */
-export declare const fullMonthRange: (month?: number, year?: number) => Return;
-export {};
+declare const fullMonthRange: (month?: number, year?: number) => Return;
+
+export { fullMonthRange };

package/general/full-month-range.js

@@ -1,24 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fullMonthRange = void 0;
-/**
- * Get the full month range for a given month and year
- * @param month - The month (0-11, where 0 is January). Defaults to current month.
- * @param year - The year. Defaults to current year.
- * @returns An object containing startOfMonth and endOfMonth dates in UTC
- */
-var fullMonthRange = function (month, year) {
-    var now = new Date();
-    var targetYear = year !== null && year !== void 0 ? year : now.getUTCFullYear();
-    var targetMonth = month !== null && month !== void 0 ? month : now.getUTCMonth();
-    // Start of month: first day at 00:00:00.000 UTC
-    var startOfMonth = new Date(Date.UTC(targetYear, targetMonth, 1, 0, 0, 0, 0));
-    // End of month: last day at 23:59:59.999 UTC
-    // Setting day to 0 of next month gives us the last day of current month
-    var endOfMonth = new Date(Date.UTC(targetYear, targetMonth + 1, 0, 23, 59, 59, 999));
-    return {
-        startOfMonth: startOfMonth,
-        endOfMonth: endOfMonth,
-    };
-};
-exports.fullMonthRange = fullMonthRange;
+var r=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var M=(e,t)=>{for(var a in t)r(e,a,{get:t[a],enumerable:!0})},f=(e,t,a,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of u(t))!D.call(e,n)&&n!==a&&r(e,n,{get:()=>t[n],enumerable:!(o=h(t,n))||o.enumerable});return e};var g=e=>f(r({},"__esModule",{value:!0}),e);var w={};M(w,{fullMonthRange:()=>l});module.exports=g(w);const l=(e,t)=>{const a=new Date,o=t??a.getUTCFullYear(),n=e??a.getUTCMonth(),s=new Date(Date.UTC(o,n,1,0,0,0,0)),c=new Date(Date.UTC(o,n+1,0,23,59,59,999));return{startOfMonth:s,endOfMonth:c}};0&&(module.exports={fullMonthRange});

package/general/full-year-range.d.ts

@@ -7,5 +7,6 @@ interface Return {
  * @param year - The year. Defaults to current year.
  * @returns An object containing startOfYear and endOfYear dates
  */
-export declare const fullYearRange: (year?: number) => Return;
-export {};
+declare const fullYearRange: (year?: number) => Return;
+
+export { fullYearRange };

package/general/full-year-range.js

@@ -1,20 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fullYearRange = void 0;
-/**
- * Get the full year range for a given year
- * @param year - The year. Defaults to current year.
- * @returns An object containing startOfYear and endOfYear dates
- */
-var fullYearRange = function (year) {
-    var targetYear = year !== null && year !== void 0 ? year : new Date().getUTCFullYear();
-    // Start of year: January 1st at 00:00:00.000
-    var startOfYear = new Date(Date.UTC(targetYear, 0, 1, 0, 0, 0, 0));
-    // End of year: December 31st at 23:59:59.999
-    var endOfYear = new Date(Date.UTC(targetYear, 11, 31, 23, 59, 59, 999));
-    return {
-        startOfYear: startOfYear,
-        endOfYear: endOfYear,
-    };
-};
-exports.fullYearRange = fullYearRange;
+var D=Object.defineProperty;var Y=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var u=(t,e)=>{for(var a in e)D(t,a,{get:e[a],enumerable:!0})},c=(t,e,a,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of f(e))!s.call(t,r)&&r!==a&&D(t,r,{get:()=>e[r],enumerable:!(n=Y(e,r))||n.enumerable});return t};var o=t=>c(D({},"__esModule",{value:!0}),t);var O={};u(O,{fullYearRange:()=>l});module.exports=o(O);const l=t=>{const e=t??new Date().getUTCFullYear(),a=new Date(Date.UTC(e,0,1,0,0,0,0)),n=new Date(Date.UTC(e,11,31,23,59,59,999));return{startOfYear:a,endOfYear:n}};0&&(module.exports={fullYearRange});

package/general/generate-article-schema.d.ts

@@ -45,5 +45,6 @@ interface ArticleSchema {
     articleSection?: string;
     wordCount?: number;
 }
-export declare const generateArticleSchema: ({ type, headline, description, image, author, publisher, datePublished, dateModified, url, keywords, articleSection, wordCount, }: ArticleSchema) => any;
-export {};
+declare const generateArticleSchema: ({ type, headline, description, image, author, publisher, datePublished, dateModified, url, keywords, articleSection, wordCount, }: ArticleSchema) => any;
+
+export { generateArticleSchema };

package/general/generate-article-schema.js

@@ -1,100 +1 @@
-"use strict";
-/**
- * Generate schema.org JSON-LD for `Article`, `NewsArticle`, or `BlogPosting`.
- *
- * This helper accepts `ArticleSchema` inputs and formats authors,
- * publisher/logo, images, and optional fields such as `keywords`,
- * `articleSection`, and `wordCount`. Only supplied fields are emitted in
- * the resulting object, making the output safe to merge into page
- * metadata bundles.
- *
- * Examples are provided in the interface comments below — consult the
- * `ArticleSchema` type for full details of supported inputs.
- *
- * @param options - Article metadata and optional fields
- * @returns A JSON-LD compatible Article/NewsArticle/BlogPosting object
- */
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateArticleSchema = void 0;
-var formatAuthor = function (author) {
-    if (typeof author === 'string') {
-        return {
-            '@type': 'Person',
-            name: author,
-        };
-    }
-    if (Array.isArray(author)) {
-        return author.map(function (a) { return (__assign({ '@type': 'Person', name: a.name }, (a.url && { url: a.url }))); });
-    }
-    return __assign({ '@type': 'Person', name: author.name }, (author.url && { url: author.url }));
-};
-var formatImage = function (image) {
-    if (typeof image === 'string') {
-        return image;
-    }
-    if (Array.isArray(image)) {
-        return image.map(function (img) {
-            if (typeof img === 'string') {
-                return img;
-            }
-            return __assign(__assign({ '@type': 'ImageObject', url: img.url }, (img.width && { width: img.width })), (img.height && { height: img.height }));
-        });
-    }
-    return __assign(__assign({ '@type': 'ImageObject', url: image.url }, (image.width && { width: image.width })), (image.height && { height: image.height }));
-};
-var formatPublisher = function (publisher) {
-    var publisherData = {
-        '@type': 'Organization',
-        name: publisher.name,
-    };
-    if (publisher.logo) {
-        publisherData.logo = __assign(__assign({ '@type': 'ImageObject', url: publisher.logo.url }, (publisher.logo.width && { width: publisher.logo.width })), (publisher.logo.height && { height: publisher.logo.height }));
-    }
-    return publisherData;
-};
-var generateArticleSchema = function (_a) {
-    var _b = _a.type, type = _b === void 0 ? 'Article' : _b, headline = _a.headline, description = _a.description, image = _a.image, author = _a.author, publisher = _a.publisher, datePublished = _a.datePublished, dateModified = _a.dateModified, url = _a.url, keywords = _a.keywords, articleSection = _a.articleSection, wordCount = _a.wordCount;
-    var schema = {
-        '@context': 'https://schema.org',
-        '@type': type,
-        headline: headline,
-        image: formatImage(image),
-        author: formatAuthor(author),
-        publisher: formatPublisher(publisher),
-        datePublished: datePublished,
-    };
-    if (description) {
-        schema.description = description;
-    }
-    if (dateModified) {
-        schema.dateModified = dateModified;
-    }
-    if (url) {
-        schema.mainEntityOfPage = {
-            '@type': 'WebPage',
-            '@id': url,
-        };
-    }
-    if (keywords && keywords.length > 0) {
-        schema.keywords = keywords.join(', ');
-    }
-    if (articleSection) {
-        schema.articleSection = articleSection;
-    }
-    if (wordCount) {
-        schema.wordCount = wordCount;
-    }
-    return schema;
-};
-exports.generateArticleSchema = generateArticleSchema;
+var h=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var d=(t,e)=>{for(var r in e)h(t,r,{get:e[r],enumerable:!0})},p=(t,e,r,l)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of y(e))!m.call(t,i)&&i!==r&&h(t,i,{get:()=>e[i],enumerable:!(l=f(e,i))||l.enumerable});return t};var w=t=>p(h({},"__esModule",{value:!0}),t);var j={};d(j,{generateArticleSchema:()=>O});module.exports=w(j);const b=t=>typeof t=="string"?{"@type":"Person",name:t}:Array.isArray(t)?t.map(e=>({"@type":"Person",name:e.name,...e.url&&{url:e.url}})):{"@type":"Person",name:t.name,...t.url&&{url:t.url}},P=t=>typeof t=="string"?t:Array.isArray(t)?t.map(e=>typeof e=="string"?e:{"@type":"ImageObject",url:e.url,...e.width&&{width:e.width},...e.height&&{height:e.height}}):{"@type":"ImageObject",url:t.url,...t.width&&{width:t.width},...t.height&&{height:t.height}},I=t=>{const e={"@type":"Organization",name:t.name};return t.logo&&(e.logo={"@type":"ImageObject",url:t.logo.url,...t.logo.width&&{width:t.logo.width},...t.logo.height&&{height:t.logo.height}}),e},O=({type:t="Article",headline:e,description:r,image:l,author:i,publisher:u,datePublished:A,dateModified:o,url:c,keywords:g,articleSection:s,wordCount:a})=>{const n={"@context":"https://schema.org","@type":t,headline:e,image:P(l),author:b(i),publisher:I(u),datePublished:A};return r&&(n.description=r),o&&(n.dateModified=o),c&&(n.mainEntityOfPage={"@type":"WebPage","@id":c}),g&&g.length>0&&(n.keywords=g.join(", ")),s&&(n.articleSection=s),a&&(n.wordCount=a),n};0&&(module.exports={generateArticleSchema});

package/general/generate-blog-schema.d.ts

@@ -18,7 +18,7 @@ interface Blog {
     updatedAt: string;
     url: string;
 }
-export declare const generateBlogSchema: ({ authorImage, authorName, banner, createdAt, excerpt, title, updatedAt, url, }: Blog) => {
+declare const generateBlogSchema: ({ authorImage, authorName, banner, createdAt, excerpt, title, updatedAt, url, }: Blog) => {
     '@context': string;
     '@type': string;
     headline: string;
@@ -33,4 +33,5 @@ export declare const generateBlogSchema: ({ authorImage, authorName, banner, cre
         url: string;
     };
 };
-export {};
+
+export { generateBlogSchema };

package/general/generate-blog-schema.js

@@ -1,32 +1 @@
-"use strict";
-/**
- * Generate schema.org `BlogPosting` JSON-LD for a blog entry.
- *
- * Produces a compact `BlogPosting` object using headline, dates, image and
- * author information. Only provided fields are emitted, and the returned
- * object is ready to be stringified as JSON-LD.
- *
- * See the `Blog` interface below for the accepted properties.
- * @returns A JSON-LD compatible `BlogPosting` object
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateBlogSchema = void 0;
-var generateBlogSchema = function (_a) {
-    var authorImage = _a.authorImage, authorName = _a.authorName, banner = _a.banner, createdAt = _a.createdAt, excerpt = _a.excerpt, title = _a.title, updatedAt = _a.updatedAt, url = _a.url;
-    return {
-        '@context': 'https://schema.org',
-        '@type': 'BlogPosting',
-        headline: "".concat(title),
-        dateModified: "".concat(updatedAt),
-        datePublished: "".concat(createdAt),
-        description: "".concat(excerpt),
-        image: "".concat(banner),
-        url: "".concat(url),
-        author: {
-            '@type': 'Person',
-            name: "".concat(authorName),
-            url: "".concat(authorImage),
-        },
-    };
-};
-exports.generateBlogSchema = generateBlogSchema;
+var a=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var c=(e,t)=>{for(var n in t)a(e,n,{get:t[n],enumerable:!0})},h=(e,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of l(t))!u.call(e,r)&&r!==n&&a(e,r,{get:()=>t[r],enumerable:!(i=d(t,r))||i.enumerable});return e};var $=e=>h(a({},"__esModule",{value:!0}),e);var m={};c(m,{generateBlogSchema:()=>p});module.exports=$(m);const p=({authorImage:e,authorName:t,banner:n,createdAt:i,excerpt:r,title:g,updatedAt:o,url:s})=>({"@context":"https://schema.org","@type":"BlogPosting",headline:`${g}`,dateModified:`${o}`,datePublished:`${i}`,description:`${r}`,image:`${n}`,url:`${s}`,author:{"@type":"Person",name:`${t}`,url:`${e}`}});0&&(module.exports={generateBlogSchema});

package/general/generate-book-schema.d.ts

@@ -53,5 +53,6 @@ interface BookSchemaOptions {
     keywords?: string[];
     bookFormat?: string;
 }
-export declare const generateBookSchema: ({ title, author, isbn, numberOfPages, inLanguage, publisher, datePublished, image, description, url, keywords, bookFormat, }: BookSchemaOptions) => any;
-export {};
+declare const generateBookSchema: ({ title, author, isbn, numberOfPages, inLanguage, publisher, datePublished, image, description, url, keywords, bookFormat, }: BookSchemaOptions) => any;
+
+export { generateBookSchema };