@moxon/api 6.0.0-pre

package/dist/modules/v4/placeholder.d.ts

@@ -0,0 +1,30 @@
+type AvatarShape = 'circle' | 'rounded' | 'square';
+type AnimateMode = 'shimmer' | 'pulse' | 'none';
+export interface PlaceholderOptions {
+    width: number;
+    height: number;
+    bg?: string;
+    color?: string;
+    text?: string;
+    rows?: number;
+    avatar?: AvatarShape;
+    lines?: number;
+    animate?: AnimateMode;
+    speed?: number;
+    radius?: number;
+}
+export interface PlaceholderResult {
+    type: string;
+    contentType: string;
+    body: string;
+}
+/**
+ * Generates an SVG placeholder image or skeleton loader with configurable dimensions and style.
+ *
+ * @param type - Placeholder type: "image" or "skeleton"
+ * @param query - Query parameters including width, height, bg, color, text, rows, avatar, animate, speed, and radius
+ * @returns Object containing the SVG body, content type, and placeholder type
+ * @throws Error if any parameter is invalid or out of range
+ */
+export default function placeholder(type: string, query: Record<string, string | undefined>): PlaceholderResult;
+export {};

package/dist/modules/v4/placeholder.js

@@ -0,0 +1,160 @@
+import { normalizeColor } from '../../utils/colors.js';
+function parseSize(value, name, def) {
+    if (value === undefined)
+        return def;
+    const n = Number(value);
+    if (isNaN(n))
+        throw new Error(`${name} must be a number`);
+    if (n < 1 || n > 4000)
+        throw new Error(`${name} must be between 1 and 4000`);
+    return Math.floor(n);
+}
+function escapeXml(str) {
+    return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function generateImage(opts) {
+    const { width, height } = opts;
+    const bg = normalizeColor(opts.bg, '#cccccc');
+    const color = normalizeColor(opts.color, '#333333');
+    const text = escapeXml(opts.text ?? `${width}\u00d7${height}`);
+    const fontSize = Math.max(12, Math.min(width, height) / 8);
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">
+  <rect width="${width}" height="${height}" fill="${bg}" rx="4" />
+  <text x="50%" y="50%" dominant-baseline="central" text-anchor="middle" font-family="system-ui,-apple-system,sans-serif" font-weight="600" font-size="${fontSize}" fill="${color}">${text}</text>
+</svg>`;
+}
+function avatarShape(shape, x, y, size) {
+    const r = size / 2;
+    switch (shape) {
+        case 'circle':
+            return `<circle cx="${x + r}" cy="${y + r}" r="${r}" />`;
+        case 'rounded':
+            return `<rect x="${x}" y="${y}" width="${size}" height="${size}" rx="${Math.round(size * 0.25)}" />`;
+        case 'square':
+            return `<rect x="${x}" y="${y}" width="${size}" height="${size}" rx="2" />`;
+    }
+}
+function animationDefs(mode, bg, highlight, speed) {
+    if (mode === 'none')
+        return '';
+    if (mode === 'pulse') {
+        return `<style>
+      @keyframes pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.5; } }
+      .sk { animation: pulse ${speed}s cubic-bezier(0.4, 0, 0.6, 1) infinite; }
+    </style>`;
+    }
+    return `<linearGradient id="g">
+      <stop offset="0.1" stop-color="${bg}" />
+      <stop offset="0.5" stop-color="${highlight}" />
+      <stop offset="0.9" stop-color="${bg}" />
+      <animateTransform attributeName="gradientTransform" type="translate" values="-2 0; 2 0" dur="${speed}s" repeatCount="indefinite" />
+    </linearGradient>`;
+}
+function generateSkeleton(opts) {
+    const { width, height } = opts;
+    const bg = normalizeColor(opts.bg, '#e5e5e5');
+    const highlight = normalizeColor(opts.color, '#f5f5f5');
+    const rows = Math.max(0, Math.min(20, opts.rows ?? 3));
+    const avatar = opts.avatar;
+    const animate = opts.animate ?? 'shimmer';
+    const speed = opts.speed ?? 1.5;
+    const rx = opts.radius ?? 4;
+    const pad = Math.round(width * 0.06);
+    const slots = rows + (avatar ? 4 : 0);
+    const available = height - pad * 2;
+    const lineH = Math.round(Math.max(8, (available / Math.max(1, slots)) * 0.65));
+    const gap = Math.round(Math.max(6, (available / Math.max(1, slots)) * 0.35));
+    const shapes = [];
+    let y = pad;
+    if (avatar) {
+        const size = Math.round(Math.min(width * 0.14, height * 0.24, 48));
+        shapes.push(avatarShape(avatar, pad, y, size));
+        const lx = pad + size + gap;
+        const lw = width - lx - pad;
+        const count = Math.max(0, Math.min(2, opts.lines ?? 2));
+        if (count === 2) {
+            const nameY = Math.max(pad, Math.round(y + size / 2 - (lineH * 2 + gap) / 2));
+            shapes.push(`<rect x="${lx}" y="${nameY}" width="${lw * 0.55}" height="${lineH}" rx="${rx}" />`);
+            shapes.push(`<rect x="${lx}" y="${nameY + lineH + gap}" width="${lw * 0.35}" height="${lineH}" rx="${rx}" />`);
+        }
+        else if (count === 1) {
+            const nameY = Math.max(pad, Math.round(y + size / 2 - lineH / 2));
+            shapes.push(`<rect x="${lx}" y="${nameY}" width="${lw * 0.55}" height="${lineH}" rx="${rx}" />`);
+        }
+        y += size + gap * 2;
+    }
+    for (let i = 0; i < rows; i++) {
+        const ratio = i === rows - 1 && rows > 1 ? 0.55 : i % 2 === 0 ? 0.92 : 0.78;
+        const w = Math.round((width - pad * 2) * ratio);
+        shapes.push(`<rect x="${pad}" y="${y}" width="${w}" height="${lineH}" rx="${rx}" />`);
+        y += lineH + gap;
+    }
+    const defs = animationDefs(animate, bg, highlight, speed);
+    const fill = animate === 'shimmer' ? 'url(#g)' : bg;
+    const cls = animate === 'pulse' ? ' class="sk"' : '';
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">
+  <defs>
+    <clipPath id="c">
+      ${shapes.join('\n      ')}
+    </clipPath>
+    ${defs}
+  </defs>
+  <rect width="${width}" height="${height}" clip-path="url(#c)" fill="${fill}"${cls} />
+</svg>`;
+}
+const AVATAR_SHAPES = new Set(['circle', 'rounded', 'square']);
+const ANIMATE_MODES = new Set(['shimmer', 'pulse', 'none']);
+function parseAvatar(value) {
+    if (!value)
+        return undefined;
+    if (value === 'true' || value === '1')
+        return 'circle';
+    if (AVATAR_SHAPES.has(value))
+        return value;
+    throw new Error('Avatar must be one of: circle, rounded, square');
+}
+function parseAnimate(value) {
+    if (!value)
+        return 'shimmer';
+    if (ANIMATE_MODES.has(value))
+        return value;
+    throw new Error('Animate must be one of: shimmer, pulse, none');
+}
+/**
+ * Generates an SVG placeholder image or skeleton loader with configurable dimensions and style.
+ *
+ * @param type - Placeholder type: "image" or "skeleton"
+ * @param query - Query parameters including width, height, bg, color, text, rows, avatar, animate, speed, and radius
+ * @returns Object containing the SVG body, content type, and placeholder type
+ * @throws Error if any parameter is invalid or out of range
+ */
+export default function placeholder(type, query) {
+    const speed = query.speed ? parseFloat(query.speed) : 1.5;
+    if (isNaN(speed) || speed < 0.1 || speed > 10)
+        throw new Error('Speed must be between 0.1 and 10');
+    const radius = query.radius ? parseInt(query.radius, 10) : 4;
+    if (isNaN(radius) || radius < 0 || radius > 50)
+        throw new Error('Radius must be between 0 and 50');
+    const opts = {
+        width: parseSize(query.width, 'width', 800),
+        height: parseSize(query.height, 'height', 600),
+        bg: query.bg,
+        color: query.color,
+        text: query.text,
+        rows: query.rows ? parseInt(query.rows, 10) : undefined,
+        avatar: parseAvatar(query.avatar),
+        lines: query.lines ? parseInt(query.lines, 10) : 2,
+        animate: parseAnimate(query.animate),
+        speed,
+        radius,
+    };
+    switch (type) {
+        case 'image':
+            return { type, contentType: 'image/svg+xml', body: generateImage(opts) };
+        case 'skeleton':
+            return { type, contentType: 'image/svg+xml', body: generateSkeleton(opts) };
+        default:
+            throw new Error('Type must be one of: image, skeleton');
+    }
+}
+//# sourceMappingURL=placeholder.js.map

package/dist/modules/v4/placeholder.js.map

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

package/dist/modules/v4/qrcode.d.ts

@@ -0,0 +1,25 @@
+export interface QRCodeOptions {
+    url: string;
+    size?: number;
+    margin?: number;
+    correction?: 'L' | 'M' | 'Q' | 'H';
+    dark?: string;
+    light?: string;
+    icon?: string;
+    iconSize?: number;
+    iconPadding?: number;
+    iconRadius?: number;
+    format?: 'png' | 'base64';
+}
+export interface QRCodeResult {
+    contentType: string;
+    body: Buffer | string;
+}
+/**
+ * Generates a QR code image for a given URL, with optional icon overlay and color customization.
+ *
+ * @param options - QR code generation options including URL, size, margin, correction level, colors, and optional icon
+ * @returns Object containing the QR code as a PNG buffer or Base64 string, and the content type
+ * @throws Error if the URL is missing, any option is invalid, or the icon URL cannot be fetched
+ */
+export default function qrcode(options: QRCodeOptions): Promise<QRCodeResult>;

package/dist/modules/v4/qrcode.js

@@ -0,0 +1,92 @@
+import { createCanvas, loadImage } from 'canvas';
+import { toBuffer, toCanvas as qrToCanvas, toDataURL } from 'qrcode';
+import { MAX_QRCODE_LOGO_BYTES } from '../../constants.js';
+import { normalizeColor } from '../../utils/colors.js';
+const CORRECTIONS = new Set(['L', 'M', 'Q', 'H']);
+const FORMATS = new Set(['png', 'base64']);
+function clamp(value, name, def, min, max) {
+    if (value === undefined)
+        return def;
+    if (isNaN(value))
+        throw new Error(`${name} must be a number`);
+    if (value < min || value > max)
+        throw new Error(`${name} must be between ${min} and ${max}`);
+    return Math.floor(value);
+}
+async function fetchIcon(url) {
+    if (!/^https:\/\//i.test(url))
+        throw new Error('Icon URL must use HTTPS');
+    const response = await fetch(url, { signal: AbortSignal.timeout(5000) });
+    if (!response.ok)
+        throw new Error(`Failed to fetch icon: HTTP ${response.status}`);
+    const contentType = response.headers.get('content-type') ?? '';
+    if (!contentType.startsWith('image/'))
+        throw new Error('Icon URL must point to an image');
+    const buffer = Buffer.from(await response.arrayBuffer());
+    if (buffer.length > MAX_QRCODE_LOGO_BYTES)
+        throw new Error('Icon must be under 2MB');
+    return buffer;
+}
+/**
+ * Generates a QR code image for a given URL, with optional icon overlay and color customization.
+ *
+ * @param options - QR code generation options including URL, size, margin, correction level, colors, and optional icon
+ * @returns Object containing the QR code as a PNG buffer or Base64 string, and the content type
+ * @throws Error if the URL is missing, any option is invalid, or the icon URL cannot be fetched
+ */
+export default async function qrcode(options) {
+    const { url } = options;
+    if (!url || typeof url !== 'string')
+        throw new Error('Please provide a valid URL');
+    const format = options.format ?? 'png';
+    if (!FORMATS.has(format))
+        throw new Error('Format must be one of: png, base64');
+    const size = clamp(options.size, 'size', 200, 50, 2000);
+    const margin = clamp(options.margin, 'margin', 4, 0, 10);
+    const dark = normalizeColor(options.dark, '#000000');
+    const light = normalizeColor(options.light, '#ffffff');
+    let correction = options.correction ?? 'M';
+    if (!CORRECTIONS.has(correction))
+        throw new Error('Correction must be one of: L, M, Q, H');
+    if (options.icon)
+        correction = 'H';
+    const qrOpts = {
+        width: size,
+        margin,
+        errorCorrectionLevel: correction,
+        color: { dark, light },
+    };
+    if (!options.icon) {
+        if (format === 'base64') {
+            return { contentType: 'application/json', body: await toDataURL(url, qrOpts) };
+        }
+        return { contentType: 'image/png', body: await toBuffer(url, qrOpts) };
+    }
+    const canvas = createCanvas(size, size);
+    await qrToCanvas(canvas, url, qrOpts);
+    const iconBuffer = await fetchIcon(options.icon);
+    const iconImg = await loadImage(iconBuffer);
+    const iconSize = clamp(options.iconSize, 'iconSize', Math.round(size * 0.2), 10, Math.round(size * 0.4));
+    const iconPadding = clamp(options.iconPadding, 'iconPadding', 5, 0, 50);
+    const maxRadius = Math.floor((iconSize + iconPadding * 2) / 2);
+    const iconRadius = clamp(options.iconRadius, 'iconRadius', 0, 0, maxRadius);
+    const ctx = canvas.getContext('2d');
+    const totalSize = iconSize + iconPadding * 2;
+    const x = (canvas.width - totalSize) / 2;
+    const y = (canvas.height - totalSize) / 2;
+    ctx.beginPath();
+    ctx.roundRect(x, y, totalSize, totalSize, iconRadius);
+    ctx.fillStyle = light;
+    ctx.fill();
+    ctx.save();
+    ctx.beginPath();
+    ctx.roundRect(x + iconPadding, y + iconPadding, iconSize, iconSize, Math.max(0, iconRadius - iconPadding));
+    ctx.clip();
+    ctx.drawImage(iconImg, x + iconPadding, y + iconPadding, iconSize, iconSize);
+    ctx.restore();
+    if (format === 'base64') {
+        return { contentType: 'application/json', body: canvas.toDataURL('image/png') };
+    }
+    return { contentType: 'image/png', body: canvas.toBuffer('image/png') };
+}
+//# sourceMappingURL=qrcode.js.map

package/dist/modules/v4/qrcode.js.map

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

package/dist/modules/v4/regex.d.ts

@@ -0,0 +1,23 @@
+export interface RegexMatch {
+    match: string;
+    index: number;
+    groups: string[];
+    namedGroups: Record<string, string>;
+}
+export interface RegexResult {
+    valid: boolean;
+    pattern: string;
+    flags: string;
+    matches: RegexMatch[];
+    count: number;
+}
+/**
+ * Tests a regular expression pattern against a text and returns structured match results.
+ *
+ * @param pattern - The regex pattern to test (max 200 characters)
+ * @param text - The text to match against (max 1000 characters)
+ * @param flags - Optional regex flags; only g, i, m, s, u are accepted (g is always forced)
+ * @returns Match results with groups and named groups, or { valid: false } if the pattern is invalid
+ * @throws Error if pattern or text is missing or exceeds the maximum length
+ */
+export default function regex(pattern: string, text: string, flags?: string): RegexResult;

package/dist/modules/v4/regex.js

@@ -0,0 +1,48 @@
+import { MAX_PATTERN_LENGTH, MAX_REGEX_MATCHES, MAX_STRING_LENGTH } from '../../constants.js';
+const VALID_FLAGS = new Set(['g', 'i', 'm', 's', 'u']);
+/**
+ * Tests a regular expression pattern against a text and returns structured match results.
+ *
+ * @param pattern - The regex pattern to test (max 200 characters)
+ * @param text - The text to match against (max 1000 characters)
+ * @param flags - Optional regex flags; only g, i, m, s, u are accepted (g is always forced)
+ * @returns Match results with groups and named groups, or { valid: false } if the pattern is invalid
+ * @throws Error if pattern or text is missing or exceeds the maximum length
+ */
+export default function regex(pattern, text, flags = 'g') {
+    if (!pattern) {
+        throw new Error('Please provide a pattern (?pattern={regex})');
+    }
+    if (!text) {
+        throw new Error('Please provide a text (&text={string})');
+    }
+    if (pattern.length > MAX_PATTERN_LENGTH) {
+        throw new Error(`Pattern must be under ${MAX_PATTERN_LENGTH} characters`);
+    }
+    if (text.length > MAX_STRING_LENGTH) {
+        throw new Error(`Text must be under ${MAX_STRING_LENGTH} characters`);
+    }
+    const cleanedFlags = [...new Set(['g', ...flags.split('').filter((f) => VALID_FLAGS.has(f))])].join('');
+    let re;
+    try {
+        re = new RegExp(pattern, cleanedFlags);
+    }
+    catch {
+        return { valid: false, pattern, flags: cleanedFlags, matches: [], count: 0 };
+    }
+    const matches = [];
+    let result;
+    while ((result = re.exec(text)) !== null && matches.length < MAX_REGEX_MATCHES) {
+        matches.push({
+            match: result[0],
+            index: result.index,
+            groups: result.slice(1).map((g) => g ?? ''),
+            namedGroups: result.groups ? { ...result.groups } : {},
+        });
+        // Prevent infinite loop on zero-length matches
+        if (result[0].length === 0)
+            re.lastIndex++;
+    }
+    return { valid: true, pattern, flags: cleanedFlags, matches, count: matches.length };
+}
+//# sourceMappingURL=regex.js.map

package/dist/modules/v4/regex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.js","sourceRoot":"","sources":["../../../src/modules/v4/regex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE9F,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAiBvD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,OAAe,EAAE,IAAY,EAAE,QAAgB,GAAG;IAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,yBAAyB,kBAAkB,aAAa,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,sBAAsB,iBAAiB,aAAa,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAExG,IAAI,EAAU,CAAC;IACf,IAAI,CAAC;QACD,EAAE,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACjF,CAAC;IAED,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,MAA8B,CAAC;IAEnC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;SACzD,CAAC,CAAC;QACH,+CAA+C;QAC/C,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,EAAE,CAAC,SAAS,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACzF,CAAC"}

package/dist/modules/v4/statistics.d.ts

@@ -0,0 +1,20 @@
+export interface StatisticsResult {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    range: number;
+    mean: number;
+    median: number;
+    mode: number[];
+    variance: number;
+    stddev: number;
+}
+/**
+ * Computes descriptive statistics for a comma-separated list of numbers.
+ *
+ * @param values - Comma-separated numeric string (e.g. "1,2,3,4,5")
+ * @returns Object containing count, sum, min, max, range, mean, median, mode, variance, and standard deviation
+ * @throws Error if values is missing, contains non-numeric entries, or exceeds the maximum count
+ */
+export default function statistics(values: string): StatisticsResult;

package/dist/modules/v4/statistics.js

@@ -0,0 +1,48 @@
+import { MAX_STRING_LENGTH } from '../../constants.js';
+/**
+ * Computes descriptive statistics for a comma-separated list of numbers.
+ *
+ * @param values - Comma-separated numeric string (e.g. "1,2,3,4,5")
+ * @returns Object containing count, sum, min, max, range, mean, median, mode, variance, and standard deviation
+ * @throws Error if values is missing, contains non-numeric entries, or exceeds the maximum count
+ */
+export default function statistics(values) {
+    if (!values)
+        throw new Error('A list of values is required');
+    if (typeof values !== 'string')
+        throw new Error('Values must be a comma-separated string');
+    const arr = values.split(',').map((v) => Number(v.trim()));
+    if (arr.some(isNaN))
+        throw new Error('Values must contain only numbers');
+    if (arr.length < 1)
+        throw new Error('At least one value is required');
+    if (arr.length > MAX_STRING_LENGTH)
+        throw new Error(`Cannot process more than ${MAX_STRING_LENGTH} values`);
+    const count = arr.length;
+    const sum = arr.reduce((a, b) => a + b, 0);
+    const min = Math.min(...arr);
+    const max = Math.max(...arr);
+    const mean = sum / count;
+    const sorted = [...arr].sort((a, b) => a - b);
+    const median = count % 2 === 0 ? (sorted[count / 2 - 1] + sorted[count / 2]) / 2 : sorted[Math.floor(count / 2)];
+    const counts = new Map();
+    for (const n of arr)
+        counts.set(n, (counts.get(n) ?? 0) + 1);
+    const maxCount = Math.max(...counts.values());
+    const mode = maxCount === 1 ? [] : [...counts.entries()].filter(([, c]) => c === maxCount).map(([n]) => n);
+    const variance = arr.reduce((acc, n) => acc + (n - mean) ** 2, 0) / count;
+    const stddev = Math.sqrt(variance);
+    return {
+        count,
+        sum: +sum.toFixed(6),
+        min,
+        max,
+        range: max - min,
+        mean: +mean.toFixed(6),
+        median: +median.toFixed(6),
+        mode,
+        variance: +variance.toFixed(6),
+        stddev: +stddev.toFixed(6),
+    };
+}
+//# sourceMappingURL=statistics.js.map

package/dist/modules/v4/statistics.js.map

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

package/dist/modules/v4/text.d.ts

@@ -0,0 +1,43 @@
+export interface TextStats {
+    characters: number;
+    charactersNoSpaces: number;
+    words: number;
+    sentences: number;
+    paragraphs: number;
+    readingTime: string;
+    mostFrequentChar: string;
+}
+/**
+ * Analyzes a text string and returns character, word, sentence, and reading time statistics.
+ *
+ * @param value - The text to analyze
+ * @returns Object containing character counts, word/sentence/paragraph counts, reading time, and most frequent character
+ * @throws Error if value is missing, not a string, or too long
+ */
+export declare function stats(value: string): TextStats;
+/**
+ * Converts a string to a URL-friendly slug.
+ *
+ * @param value - The string to slugify
+ * @returns Lowercase hyphenated slug with diacritics and special characters removed
+ * @throws Error if value is missing, not a string, or too long
+ */
+export declare function slug(value: string): string;
+/**
+ * Generates Lorem Ipsum placeholder text.
+ *
+ * @param type - Content type: "words", "sentences", or "paragraphs"
+ * @param count - Number of words, sentences, or paragraphs to generate
+ * @returns Generated Lorem Ipsum text
+ * @throws Error if count is out of range or type is not one of the accepted values
+ */
+export declare function lorem(type: string, count: string): string;
+/**
+ * Converts an integer to its written-out word form in French or English.
+ *
+ * @param value - The integer to convert (must be less than 1 billion)
+ * @param lang - Language: "fr" for French or "en" for English
+ * @returns The number written out in words
+ * @throws Error if value is not an integer, exceeds the maximum, or lang is not supported
+ */
+export declare function number(value: string, lang: string): string;