@20syldev/api 4.7.0 → 4.9.0

package/src/modules/v4/levenshtein.ts

@@ -1,46 +0,0 @@
-import { MAX_LEVENSHTEIN_LENGTH } from '../../constants.js';
-
-/**
- * Computes the Levenshtein edit distance between two strings.
- *
- * @param str1 - First string
- * @param str2 - Second string
- * @returns Object containing both strings and the minimum number of single-character edits to transform one into the other
- * @throws Error if either string is missing, not a string, or exceeds the maximum length
- */
-export default function levenshtein(str1: string, str2: string): { str1: string; str2: string; distance: number } {
-    if (!str1 || typeof str1 !== 'string') {
-        throw new Error('Please provide a valid first string');
-    }
-
-    if (!str2 || typeof str2 !== 'string') {
-        throw new Error('Please provide a valid second string');
-    }
-
-    if (str1.length > MAX_LEVENSHTEIN_LENGTH) {
-        throw new Error('First string exceeds 1000 characters');
-    }
-
-    if (str2.length > MAX_LEVENSHTEIN_LENGTH) {
-        throw new Error('Second string exceeds 1000 characters');
-    }
-
-    const m: number[][] = Array.from({ length: str1.length + 1 }, (_, i) => [i]);
-    for (let j = 0; j <= str2.length; j++) m[0]![j] = j;
-
-    for (let i = 1; i <= str1.length; i++) {
-        for (let j = 1; j <= str2.length; j++) {
-            m[i]![j] = Math.min(
-                m[i - 1]![j]! + 1,
-                m[i]![j - 1]! + 1,
-                m[i - 1]![j - 1]! + (str1[i - 1] !== str2[j - 1] ? 1 : 0),
-            );
-        }
-    }
-
-    return {
-        str1,
-        str2,
-        distance: m[str1.length]![str2.length]!,
-    };
-}

package/src/modules/v4/palette.ts

@@ -1,71 +0,0 @@
-import { hexToRgb, hslToRgb, rgbToHex, rgbToHsl } from '../../utils/colors.js';
-
-export interface PaletteColor {
-    hex: string;
-    rgb: string;
-    hsl: string;
-}
-
-export interface PaletteResult {
-    base: PaletteColor;
-    type: string;
-    colors: PaletteColor[];
-}
-
-function format(r: number, g: number, b: number): PaletteColor {
-    const [h, s, l] = rgbToHsl(r, g, b);
-    return {
-        hex: rgbToHex(r, g, b),
-        rgb: `rgb(${r}, ${g}, ${b})`,
-        hsl: `hsl(${h.toFixed(1)}, ${(s * 100).toFixed(1)}%, ${(l * 100).toFixed(1)}%)`,
-    };
-}
-
-function fromHueShifts(base: [number, number, number], shifts: number[]): PaletteColor[] {
-    const [h, s, l] = base;
-    return shifts.map((shift) => {
-        const newH = (h + shift + 360) % 360;
-        const [r, g, b] = hslToRgb(newH, s, l);
-        return format(r, g, b);
-    });
-}
-
-/**
- * Generates a color palette from a base hex color using a specified harmony type.
- *
- * @param color - Base hex color (e.g. "#ff5733")
- * @param type - Palette type: "complementary", "triadic", "analogous", "tetradic", or "split-complementary"
- * @returns Object containing the base color and the derived palette colors in hex, RGB, and HSL
- * @throws Error if color or type is missing, or the type is not one of the accepted values
- */
-export default function palette(color: string, type: string): PaletteResult {
-    if (!color) throw new Error('A base color is required');
-    if (!type) throw new Error('A palette type is required');
-
-    const [r, g, b] = hexToRgb(color);
-    const base = format(r, g, b);
-    const hsl = rgbToHsl(r, g, b);
-
-    let colors: PaletteColor[];
-    switch (type) {
-        case 'complementary':
-            colors = fromHueShifts(hsl, [0, 180]);
-            break;
-        case 'triadic':
-            colors = fromHueShifts(hsl, [0, 120, 240]);
-            break;
-        case 'analogous':
-            colors = fromHueShifts(hsl, [-60, -30, 0, 30, 60]);
-            break;
-        case 'tetradic':
-            colors = fromHueShifts(hsl, [0, 90, 180, 270]);
-            break;
-        case 'split-complementary':
-            colors = fromHueShifts(hsl, [0, 150, 210]);
-            break;
-        default:
-            throw new Error('Type must be one of: complementary, triadic, analogous, tetradic, split-complementary');
-    }
-
-    return { base, type, colors };
-}

package/src/modules/v4/personal.ts

@@ -1,140 +0,0 @@
-import { random, randomNumber } from '../../utils/helpers.js';
-import addressFn from './address.js';
-
-interface Person {
-    name: string;
-    social: string;
-    email: string;
-    country: string;
-}
-
-interface CountryInfo {
-    tel: string;
-    code: string;
-    lang: string;
-}
-
-/**
- * Generates a fictional personal profile with realistic demographic and contact data.
- *
- * @returns Object containing name, email, phone, address, job, hobbies, and other personal attributes
- */
-export default function personal(): Record<string, unknown> {
-    const people: Person[] = [
-        { name: 'John Doe', social: 'john_doe', email: 'john@example.com', country: 'US' },
-        { name: 'Jane Martin', social: 'jane_martin', email: 'jane@example.com', country: 'FR' },
-        { name: 'Michael Johnson', social: 'mike_johnson', email: 'michael@example.com', country: 'UK' },
-        { name: 'Emily Davis', social: 'emily_davis', email: 'emily@example.com', country: 'ES' },
-        { name: 'Alexis Barbos', social: 'alexis_barbos', email: 'alexis@example.com', country: 'DE' },
-        { name: 'Sarah Williams', social: 'sarah_williams', email: 'sarah@example.com', country: 'IT' },
-        { name: 'Daniel Brown', social: 'daniel_brown', email: 'daniel@example.com', country: 'JP' },
-        { name: 'Sophia Wilson', social: 'sophia_wilson', email: 'sophia@example.com', country: 'BR' },
-        { name: 'James Taylor', social: 'james_taylor', email: 'james@example.com', country: 'CA' },
-        { name: 'Olivia Thomas', social: 'olivia_thomas', email: 'olivia@example.com', country: 'AU' },
-    ];
-
-    const countries: Record<string, CountryInfo> = {
-        US: { tel: '123-456-7890', code: '1', lang: 'English' },
-        FR: { tel: '06 78 90 12 34', code: '33', lang: 'French' },
-        UK: { tel: '7911 123456', code: '44', lang: 'English' },
-        ES: { tel: '678 901 234', code: '34', lang: 'Spanish' },
-        DE: { tel: '163 555 1584', code: '49', lang: 'German' },
-        IT: { tel: '345 678 9012', code: '39', lang: 'Italian' },
-        JP: { tel: '080-1234-5678', code: '81', lang: 'Japanese' },
-        BR: { tel: '(11) 98765-4321', code: '55', lang: 'Portuguese' },
-        CA: { tel: '416-123-4567', code: '1', lang: 'English' },
-        AU: { tel: '0412 345 678', code: '61', lang: 'English' },
-    };
-
-    const jobs = ['Writer', 'Artist', 'Musician', 'Explorer', 'Scientist', 'Engineer', 'Athlete', 'Doctor'];
-    const hobbies = ['Reading', 'Traveling', 'Gaming', 'Cooking', 'Fitness', 'Music', 'Photography', 'Writing'];
-    const card = Array.from({ length: 4 }, () => randomNumber(1000, 9999)).join(' ');
-    const cvc = randomNumber(100, 999);
-    const expiration = `${String(randomNumber(1, 12)).padStart(2, '0')}/${(new Date().getFullYear() + randomNumber(0, 3)).toString().slice(-2)}`;
-
-    const person = random(people);
-    const social = person.social;
-    const country = person.country;
-    const countryCodes: Record<string, string> = { US: 'us', FR: 'fr', UK: 'uk', ES: 'es', DE: 'de' };
-    const addrCountry = countryCodes[country] ?? 'us';
-    const countryInfo = countries[country]!;
-    const phone = countryInfo.tel;
-    const lang = countryInfo.lang;
-
-    const age = randomNumber(18, 67);
-    const birthday = new Date(Date.now() - randomNumber(18, 67) * 365.25 * 24 * 60 * 60 * 1000).toISOString();
-
-    const emergencyContacts: { name: string; relationship: string; phone: string }[] = [];
-    const yearIncome = randomNumber(20000, 100000);
-    const subscriptions: string[] = [];
-    const pets: string[] = [];
-    const vehicles: string[] = [];
-    let civilStatus = 'Single';
-    let children = 0;
-
-    if (age >= 21 && Math.random() > 0.7) civilStatus = 'Married';
-    if (civilStatus === 'Married' && age >= 25) children = randomNumber(0, 3);
-
-    while (emergencyContacts.length < randomNumber(1, 3)) {
-        let emergencyContact = random(people);
-        while (
-            emergencyContact.email === person.email ||
-            emergencyContacts.some((e) => e.name === emergencyContact.name)
-        ) {
-            emergencyContact = random(people);
-        }
-        const emergencyPhone = `${randomNumber(100, 999)}-${randomNumber(100, 999)}-${randomNumber(1000, 9999)}`;
-        emergencyContacts.push({
-            name: emergencyContact.name,
-            relationship: random(['Spouse', 'Parent', 'Sibling', 'Friend']),
-            phone: `+${countryInfo.code} ${emergencyPhone}`,
-        });
-    }
-
-    while (subscriptions.length < randomNumber(1, 3)) {
-        const subscription = random(['Netflix', 'Spotify', 'Amazon Prime', 'Disney+', 'Hulu']);
-        if (!subscriptions.includes(subscription)) subscriptions.push(subscription);
-    }
-
-    while (pets.length < randomNumber(1, 3)) {
-        const pet = random(['Dog', 'Cat', 'Fish', 'Bird', 'None']);
-        if (!pets.includes(pet)) pets.push(pet);
-    }
-
-    while (vehicles.length < randomNumber(1, 3)) {
-        const vehicle = random(['Car', 'Bike', 'Motorcycle', 'Bus', 'None']);
-        if (!vehicles.includes(vehicle)) vehicles.push(vehicle);
-    }
-
-    return {
-        name: person.name,
-        email: person.email,
-        localisation: country,
-        phone: `+${countryInfo.code} ${phone}`,
-        job: random(jobs),
-        hobbies: random(hobbies),
-        language: lang,
-        card,
-        cvc,
-        expiration,
-        address: addressFn(addrCountry).addresses[0]!,
-        birthday,
-        civil_status: civilStatus,
-        children,
-        vehicle: vehicles,
-        social_profiles: {
-            twitter: `@${social}`,
-            facebook: `facebook.com/${social}`,
-            linkedin: `linkedin.com/in/${social}`,
-            instagram: `instagram.com/${social}`,
-        },
-        year_income: `${yearIncome} USD/year`,
-        month_income: `${(yearIncome / 12).toFixed(2)} USD/month`,
-        education: random(['High School', "Bachelor's", "Master's", 'PhD']),
-        work_experience: `${randomNumber(0, 20)} years`,
-        health_status: random(['Healthy', 'Minor Issues', 'Chronic Conditions']),
-        emergency_contacts: emergencyContacts,
-        subscriptions,
-        pets,
-    };
-}

package/src/modules/v4/placeholder.ts

@@ -1,197 +0,0 @@
-import { normalizeColor } from '../../utils/colors.js';
-
-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;
-}
-
-function parseSize(value: string | undefined, name: string, def: number): number {
-    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: string): string {
-    return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
-}
-
-function generateImage(opts: PlaceholderOptions): string {
-    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: AvatarShape, x: number, y: number, size: number): string {
-    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: AnimateMode, bg: string, highlight: string, speed: number): string {
-    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: PlaceholderOptions): string {
-    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: string[] = [];
-    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>`;
-}
-
-export interface PlaceholderResult {
-    type: string;
-    contentType: string;
-    body: string;
-}
-
-const AVATAR_SHAPES = new Set(['circle', 'rounded', 'square']);
-const ANIMATE_MODES = new Set(['shimmer', 'pulse', 'none']);
-
-function parseAvatar(value: string | undefined): AvatarShape | undefined {
-    if (!value) return undefined;
-    if (value === 'true' || value === '1') return 'circle';
-    if (AVATAR_SHAPES.has(value)) return value as AvatarShape;
-    throw new Error('avatar must be one of: circle, rounded, square');
-}
-
-function parseAnimate(value: string | undefined): AnimateMode {
-    if (!value) return 'shimmer';
-    if (ANIMATE_MODES.has(value)) return value as AnimateMode;
-    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: string, query: Record<string, string | undefined>): PlaceholderResult {
-    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: PlaceholderOptions = {
-        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');
-    }
-}

package/src/modules/v4/qrcode.ts

@@ -1,121 +0,0 @@
-import { createCanvas, loadImage } from 'canvas';
-import { toBuffer, toCanvas as qrToCanvas, toDataURL } from 'qrcode';
-
-import { normalizeColor } from '../../utils/colors.js';
-
-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;
-}
-
-const CORRECTIONS = new Set(['L', 'M', 'Q', 'H']);
-const FORMATS = new Set(['png', 'base64']);
-const MAX_LOGO_BYTES = 2 * 1024 * 1024;
-
-function clamp(value: number | undefined, name: string, def: number, min: number, max: number): number {
-    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: string): Promise<Buffer> {
-    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_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: QRCodeOptions): Promise<QRCodeResult> {
-    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 as 'L' | 'M' | 'Q' | 'H',
-        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 as unknown as HTMLCanvasElement, 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') };
-}

package/src/modules/v4/statistics.ts

@@ -1,62 +0,0 @@
-import { MAX_STRING_LENGTH } from '../../constants.js';
-
-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 {
-    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<number, number>();
-    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),
-    };
-}