@dromney/mapthis 0.1.0

package/dist/utils/index.d.cts

@@ -0,0 +1,363 @@
+import { C as Coordinates } from '../schemas-Dy5coqXo.cjs';
+import 'zod';
+
+/**
+ * Capitalize the first character of a string, passing through null/undefined.
+ */
+declare const capitalizeFirstLetter: <T extends string | null | undefined>(s: T) => T;
+/**
+ * Map the values of a plain object while preserving keys.
+ */
+declare function objectMap<T>(obj: Record<string, T>, func: (key: string, val: T) => T): Record<string, T>;
+/**
+ * Normalize freeform list input for a textarea that expects one item per line.
+ *
+ * - Leading newline is swallowed so users cannot start a list with blank lines.
+ * - Internal blank lines are collapsed.
+ * - A trailing newline is preserved so the user can keep typing the next line.
+ */
+declare const enforceListTextInput: (val: string) => string;
+/**
+ * Alias of {@link enforceListTextInput} kept for semantic clarity in call sites.
+ */
+declare const preventMultipleBlankLines: (val: string) => string;
+
+/**
+ * Random integer in the half-open range [from, to).
+ */
+declare function randomIntBetween(from: number, to: number): number;
+
+declare const H_MIN = 50;
+declare const H_MAX = 300;
+declare const L_MIN = 90;
+declare const L_MAX = 95;
+declare const seedOffset = 50;
+declare function randomPastelHsl(): [number, number, number];
+declare function randomPastelHslString(): string;
+declare function randomPastelRgb(): [number, number, number];
+declare function randomPastelHex(): string;
+/**
+ * Deterministically map a non-negative integer seed to a hue in [min, max).
+ *
+ * The algorithm uses a base-2 level decomposition so that successive seeds
+ * (0, 1, 2, 3, ...) stay maximally spaced within the hue range.
+ */
+declare function seededHslH(seed: number, min?: number, max?: number): number;
+declare function seededPastelHsl(seed: number): [number, number, number];
+declare function seededPastelRgb(seed: number): [number, number, number];
+declare function seededPastelRgbA(seed: number, alpha: number): string;
+declare function seededPastelHex(seed: number): string;
+interface PastelDocColors {
+    bgColor: string;
+    txtColor: string;
+    primaryColor: string;
+    focusFocus: string;
+}
+declare function randomPastelHslDocColors(): PastelDocColors;
+/**
+ * Deterministic pastel hue derived from a UUID by interpreting its hex as a
+ * big integer mod 360.
+ */
+declare function uuidPastelHsl(uuid: string): [number, number, number];
+declare function uuidPastelRgb(uuid: string): [number, number, number];
+declare function uuidPastelRgbA(uuid: string, alpha: number): string;
+declare function uuidPastelHex(uuid: string): string;
+/**
+ * Choose a readable text color (dark or light) for a given hex background,
+ * using the standard ITU-R BT.601 luminance coefficients.
+ */
+declare function getTextColor(bgColor: string): string;
+
+/**
+ * Stopwatch that supports named laps. Useful for instrumenting multi-stage
+ * pipelines (e.g. URL fetch → summarize → LLM parse → geocode).
+ */
+declare class StopwatchLapped {
+    private name;
+    private startTime;
+    private endTime;
+    private _currentLap;
+    private laps;
+    log: boolean;
+    constructor(name?: string, log?: boolean);
+    get elapsed(): number;
+    get currentLap(): number;
+    private checkStopped;
+    private addLap;
+    private completeLap;
+    start(firstLapName?: string): this;
+    lap(newLapName?: string): this;
+    stop(): this;
+}
+/**
+ * Minimal stopwatch for quick one-shot timing.
+ */
+declare class Stopwatch {
+    private name;
+    private startTime;
+    constructor(name: string);
+    stop(): number;
+}
+
+/**
+ * Known lat/lng for major cities. Useful as default map centers, test
+ * fixtures, and fallback coordinates.
+ */
+declare const cities: {
+    readonly london: {
+        readonly lat: 51.5074;
+        readonly lng: -0.1278;
+    };
+    readonly washingtonDC: {
+        readonly lat: 38.9072;
+        readonly lng: -77.0369;
+    };
+    readonly newYorkCity: {
+        readonly lat: 40.7128;
+        readonly lng: -74.006;
+    };
+    readonly losAngeles: {
+        readonly lat: 34.0522;
+        readonly lng: -118.2437;
+    };
+    readonly tokyo: {
+        readonly lat: 35.6895;
+        readonly lng: 139.6917;
+    };
+    readonly paris: {
+        readonly lat: 48.8566;
+        readonly lng: 2.3522;
+    };
+    readonly sydney: {
+        readonly lat: -33.8688;
+        readonly lng: 151.2093;
+    };
+    readonly saoPaulo: {
+        readonly lat: -23.5505;
+        readonly lng: -46.6333;
+    };
+    readonly moscow: {
+        readonly lat: 55.7558;
+        readonly lng: 37.6173;
+    };
+    readonly beijing: {
+        readonly lat: 39.9042;
+        readonly lng: 116.4074;
+    };
+    readonly buenosAires: {
+        readonly lat: -34.6037;
+        readonly lng: -58.3816;
+    };
+    readonly rome: {
+        readonly lat: 41.9028;
+        readonly lng: 12.4964;
+    };
+    readonly sanFrancisco: {
+        readonly lat: 37.7749;
+        readonly lng: -122.4194;
+    };
+    readonly mexicoCity: {
+        readonly lat: 19.4326;
+        readonly lng: -99.1332;
+    };
+    readonly newDelhi: {
+        readonly lat: 28.6139;
+        readonly lng: 77.209;
+    };
+    readonly toronto: {
+        readonly lat: 43.6532;
+        readonly lng: -79.3832;
+    };
+    readonly berlin: {
+        readonly lat: 52.52;
+        readonly lng: 13.405;
+    };
+    readonly shanghai: {
+        readonly lat: 31.2304;
+        readonly lng: 121.4737;
+    };
+    readonly bangkok: {
+        readonly lat: 13.7563;
+        readonly lng: 100.5018;
+    };
+    readonly rioDeJaneiro: {
+        readonly lat: -22.9068;
+        readonly lng: -43.1729;
+    };
+    readonly singapore: {
+        readonly lat: 1.3521;
+        readonly lng: 103.8198;
+    };
+    readonly istanbul: {
+        readonly lat: 41.0082;
+        readonly lng: 28.9784;
+    };
+    readonly melbourne: {
+        readonly lat: -37.8136;
+        readonly lng: 144.9631;
+    };
+    readonly frankfurt: {
+        readonly lat: 50.1109;
+        readonly lng: 8.6821;
+    };
+    readonly johannesburg: {
+        readonly lat: -26.2041;
+        readonly lng: 28.0473;
+    };
+    readonly madrid: {
+        readonly lat: 40.4168;
+        readonly lng: -3.7038;
+    };
+    readonly kualaLumpur: {
+        readonly lat: 3.139;
+        readonly lng: 101.6869;
+    };
+    readonly helsinki: {
+        readonly lat: 60.1699;
+        readonly lng: 24.9384;
+    };
+    readonly copenhagen: {
+        readonly lat: 55.6761;
+        readonly lng: 12.5683;
+    };
+    readonly budapest: {
+        readonly lat: 47.4979;
+        readonly lng: 19.0402;
+    };
+    readonly ankara: {
+        readonly lat: 39.9334;
+        readonly lng: 32.8597;
+    };
+    readonly cairo: {
+        readonly lat: 30.0444;
+        readonly lng: 31.2357;
+    };
+    readonly osaka: {
+        readonly lat: 34.6937;
+        readonly lng: 135.5023;
+    };
+    readonly athens: {
+        readonly lat: 37.9838;
+        readonly lng: 23.7275;
+    };
+    readonly seoul: {
+        readonly lat: 37.5665;
+        readonly lng: 126.978;
+    };
+    readonly jakarta: {
+        readonly lat: -6.2088;
+        readonly lng: 106.8456;
+    };
+    readonly dubai: {
+        readonly lat: 25.276987;
+        readonly lng: 55.296249;
+    };
+    readonly telAviv: {
+        readonly lat: 32.0853;
+        readonly lng: 34.7818;
+    };
+    readonly mumbai: {
+        readonly lat: 19.075983;
+        readonly lng: 72.877655;
+    };
+    readonly nairobi: {
+        readonly lat: -1.2921;
+        readonly lng: 36.8219;
+    };
+    readonly casablanca: {
+        readonly lat: 33.5731;
+        readonly lng: -7.5898;
+    };
+    readonly calgary: {
+        readonly lat: 51.0447;
+        readonly lng: -114.0719;
+    };
+    readonly montreal: {
+        readonly lat: 45.5017;
+        readonly lng: -73.5673;
+    };
+    readonly zagreb: {
+        readonly lat: 45.815;
+        readonly lng: 15.9819;
+    };
+    readonly stockholm: {
+        readonly lat: 59.3293;
+        readonly lng: 18.0686;
+    };
+    readonly brasilia: {
+        readonly lat: -15.8267;
+        readonly lng: -47.9218;
+    };
+    readonly canberra: {
+        readonly lat: -35.282;
+        readonly lng: 149.1286;
+    };
+    readonly amman: {
+        readonly lat: 30.5852;
+        readonly lng: 36.2384;
+    };
+    readonly dublin: {
+        readonly lat: 53.3498;
+        readonly lng: -6.2603;
+    };
+    readonly phoenix: {
+        readonly lat: 33.4484;
+        readonly lng: -112.074;
+    };
+    readonly portLouis: {
+        readonly lat: -20.1609;
+        readonly lng: 57.5012;
+    };
+    readonly riyadh: {
+        readonly lat: 24.7136;
+        readonly lng: 46.6753;
+    };
+    readonly bucharest: {
+        readonly lat: 44.4268;
+        readonly lng: 26.1025;
+    };
+    readonly vancouver: {
+        readonly lat: 49.2827;
+        readonly lng: -123.1207;
+    };
+    readonly baghdad: {
+        readonly lat: 33.3128;
+        readonly lng: 44.3615;
+    };
+    readonly cancun: {
+        readonly lat: 21.1619;
+        readonly lng: -86.8515;
+    };
+    readonly denpasar: {
+        readonly lat: -8.4095;
+        readonly lng: 115.1889;
+    };
+    readonly vientiane: {
+        readonly lat: 17.9714;
+        readonly lng: 102.6141;
+    };
+    readonly pune: {
+        readonly lat: 18.5204;
+        readonly lng: 73.8567;
+    };
+    readonly karachi: {
+        readonly lat: 24.8607;
+        readonly lng: 67.0011;
+    };
+    readonly denver: {
+        readonly lat: 39.7392;
+        readonly lng: -104.9903;
+    };
+};
+type KnownCity = keyof typeof cities;
+declare const randomLat: () => number;
+declare const randomLng: () => number;
+/**
+ * Development-friendly coordinates (centered over central Europe) so seeded
+ * data never lands in the ocean during local testing.
+ */
+declare const randomLatDev: () => number;
+declare const randomLngDev: () => number;
+declare const randomDevCoordinates: () => Coordinates;
+
+export { H_MAX, H_MIN, type KnownCity, L_MAX, L_MIN, type PastelDocColors, Stopwatch, StopwatchLapped, capitalizeFirstLetter, cities, enforceListTextInput, getTextColor, objectMap, preventMultipleBlankLines, randomDevCoordinates, randomIntBetween, randomLat, randomLatDev, randomLng, randomLngDev, randomPastelHex, randomPastelHsl, randomPastelHslDocColors, randomPastelHslString, randomPastelRgb, seedOffset, seededHslH, seededPastelHex, seededPastelHsl, seededPastelRgb, seededPastelRgbA, uuidPastelHex, uuidPastelHsl, uuidPastelRgb, uuidPastelRgbA };

package/dist/utils/index.d.ts

@@ -0,0 +1,363 @@
+import { C as Coordinates } from '../schemas-Dy5coqXo.js';
+import 'zod';
+
+/**
+ * Capitalize the first character of a string, passing through null/undefined.
+ */
+declare const capitalizeFirstLetter: <T extends string | null | undefined>(s: T) => T;
+/**
+ * Map the values of a plain object while preserving keys.
+ */
+declare function objectMap<T>(obj: Record<string, T>, func: (key: string, val: T) => T): Record<string, T>;
+/**
+ * Normalize freeform list input for a textarea that expects one item per line.
+ *
+ * - Leading newline is swallowed so users cannot start a list with blank lines.
+ * - Internal blank lines are collapsed.
+ * - A trailing newline is preserved so the user can keep typing the next line.
+ */
+declare const enforceListTextInput: (val: string) => string;
+/**
+ * Alias of {@link enforceListTextInput} kept for semantic clarity in call sites.
+ */
+declare const preventMultipleBlankLines: (val: string) => string;
+
+/**
+ * Random integer in the half-open range [from, to).
+ */
+declare function randomIntBetween(from: number, to: number): number;
+
+declare const H_MIN = 50;
+declare const H_MAX = 300;
+declare const L_MIN = 90;
+declare const L_MAX = 95;
+declare const seedOffset = 50;
+declare function randomPastelHsl(): [number, number, number];
+declare function randomPastelHslString(): string;
+declare function randomPastelRgb(): [number, number, number];
+declare function randomPastelHex(): string;
+/**
+ * Deterministically map a non-negative integer seed to a hue in [min, max).
+ *
+ * The algorithm uses a base-2 level decomposition so that successive seeds
+ * (0, 1, 2, 3, ...) stay maximally spaced within the hue range.
+ */
+declare function seededHslH(seed: number, min?: number, max?: number): number;
+declare function seededPastelHsl(seed: number): [number, number, number];
+declare function seededPastelRgb(seed: number): [number, number, number];
+declare function seededPastelRgbA(seed: number, alpha: number): string;
+declare function seededPastelHex(seed: number): string;
+interface PastelDocColors {
+    bgColor: string;
+    txtColor: string;
+    primaryColor: string;
+    focusFocus: string;
+}
+declare function randomPastelHslDocColors(): PastelDocColors;
+/**
+ * Deterministic pastel hue derived from a UUID by interpreting its hex as a
+ * big integer mod 360.
+ */
+declare function uuidPastelHsl(uuid: string): [number, number, number];
+declare function uuidPastelRgb(uuid: string): [number, number, number];
+declare function uuidPastelRgbA(uuid: string, alpha: number): string;
+declare function uuidPastelHex(uuid: string): string;
+/**
+ * Choose a readable text color (dark or light) for a given hex background,
+ * using the standard ITU-R BT.601 luminance coefficients.
+ */
+declare function getTextColor(bgColor: string): string;
+
+/**
+ * Stopwatch that supports named laps. Useful for instrumenting multi-stage
+ * pipelines (e.g. URL fetch → summarize → LLM parse → geocode).
+ */
+declare class StopwatchLapped {
+    private name;
+    private startTime;
+    private endTime;
+    private _currentLap;
+    private laps;
+    log: boolean;
+    constructor(name?: string, log?: boolean);
+    get elapsed(): number;
+    get currentLap(): number;
+    private checkStopped;
+    private addLap;
+    private completeLap;
+    start(firstLapName?: string): this;
+    lap(newLapName?: string): this;
+    stop(): this;
+}
+/**
+ * Minimal stopwatch for quick one-shot timing.
+ */
+declare class Stopwatch {
+    private name;
+    private startTime;
+    constructor(name: string);
+    stop(): number;
+}
+
+/**
+ * Known lat/lng for major cities. Useful as default map centers, test
+ * fixtures, and fallback coordinates.
+ */
+declare const cities: {
+    readonly london: {
+        readonly lat: 51.5074;
+        readonly lng: -0.1278;
+    };
+    readonly washingtonDC: {
+        readonly lat: 38.9072;
+        readonly lng: -77.0369;
+    };
+    readonly newYorkCity: {
+        readonly lat: 40.7128;
+        readonly lng: -74.006;
+    };
+    readonly losAngeles: {
+        readonly lat: 34.0522;
+        readonly lng: -118.2437;
+    };
+    readonly tokyo: {
+        readonly lat: 35.6895;
+        readonly lng: 139.6917;
+    };
+    readonly paris: {
+        readonly lat: 48.8566;
+        readonly lng: 2.3522;
+    };
+    readonly sydney: {
+        readonly lat: -33.8688;
+        readonly lng: 151.2093;
+    };
+    readonly saoPaulo: {
+        readonly lat: -23.5505;
+        readonly lng: -46.6333;
+    };
+    readonly moscow: {
+        readonly lat: 55.7558;
+        readonly lng: 37.6173;
+    };
+    readonly beijing: {
+        readonly lat: 39.9042;
+        readonly lng: 116.4074;
+    };
+    readonly buenosAires: {
+        readonly lat: -34.6037;
+        readonly lng: -58.3816;
+    };
+    readonly rome: {
+        readonly lat: 41.9028;
+        readonly lng: 12.4964;
+    };
+    readonly sanFrancisco: {
+        readonly lat: 37.7749;
+        readonly lng: -122.4194;
+    };
+    readonly mexicoCity: {
+        readonly lat: 19.4326;
+        readonly lng: -99.1332;
+    };
+    readonly newDelhi: {
+        readonly lat: 28.6139;
+        readonly lng: 77.209;
+    };
+    readonly toronto: {
+        readonly lat: 43.6532;
+        readonly lng: -79.3832;
+    };
+    readonly berlin: {
+        readonly lat: 52.52;
+        readonly lng: 13.405;
+    };
+    readonly shanghai: {
+        readonly lat: 31.2304;
+        readonly lng: 121.4737;
+    };
+    readonly bangkok: {
+        readonly lat: 13.7563;
+        readonly lng: 100.5018;
+    };
+    readonly rioDeJaneiro: {
+        readonly lat: -22.9068;
+        readonly lng: -43.1729;
+    };
+    readonly singapore: {
+        readonly lat: 1.3521;
+        readonly lng: 103.8198;
+    };
+    readonly istanbul: {
+        readonly lat: 41.0082;
+        readonly lng: 28.9784;
+    };
+    readonly melbourne: {
+        readonly lat: -37.8136;
+        readonly lng: 144.9631;
+    };
+    readonly frankfurt: {
+        readonly lat: 50.1109;
+        readonly lng: 8.6821;
+    };
+    readonly johannesburg: {
+        readonly lat: -26.2041;
+        readonly lng: 28.0473;
+    };
+    readonly madrid: {
+        readonly lat: 40.4168;
+        readonly lng: -3.7038;
+    };
+    readonly kualaLumpur: {
+        readonly lat: 3.139;
+        readonly lng: 101.6869;
+    };
+    readonly helsinki: {
+        readonly lat: 60.1699;
+        readonly lng: 24.9384;
+    };
+    readonly copenhagen: {
+        readonly lat: 55.6761;
+        readonly lng: 12.5683;
+    };
+    readonly budapest: {
+        readonly lat: 47.4979;
+        readonly lng: 19.0402;
+    };
+    readonly ankara: {
+        readonly lat: 39.9334;
+        readonly lng: 32.8597;
+    };
+    readonly cairo: {
+        readonly lat: 30.0444;
+        readonly lng: 31.2357;
+    };
+    readonly osaka: {
+        readonly lat: 34.6937;
+        readonly lng: 135.5023;
+    };
+    readonly athens: {
+        readonly lat: 37.9838;
+        readonly lng: 23.7275;
+    };
+    readonly seoul: {
+        readonly lat: 37.5665;
+        readonly lng: 126.978;
+    };
+    readonly jakarta: {
+        readonly lat: -6.2088;
+        readonly lng: 106.8456;
+    };
+    readonly dubai: {
+        readonly lat: 25.276987;
+        readonly lng: 55.296249;
+    };
+    readonly telAviv: {
+        readonly lat: 32.0853;
+        readonly lng: 34.7818;
+    };
+    readonly mumbai: {
+        readonly lat: 19.075983;
+        readonly lng: 72.877655;
+    };
+    readonly nairobi: {
+        readonly lat: -1.2921;
+        readonly lng: 36.8219;
+    };
+    readonly casablanca: {
+        readonly lat: 33.5731;
+        readonly lng: -7.5898;
+    };
+    readonly calgary: {
+        readonly lat: 51.0447;
+        readonly lng: -114.0719;
+    };
+    readonly montreal: {
+        readonly lat: 45.5017;
+        readonly lng: -73.5673;
+    };
+    readonly zagreb: {
+        readonly lat: 45.815;
+        readonly lng: 15.9819;
+    };
+    readonly stockholm: {
+        readonly lat: 59.3293;
+        readonly lng: 18.0686;
+    };
+    readonly brasilia: {
+        readonly lat: -15.8267;
+        readonly lng: -47.9218;
+    };
+    readonly canberra: {
+        readonly lat: -35.282;
+        readonly lng: 149.1286;
+    };
+    readonly amman: {
+        readonly lat: 30.5852;
+        readonly lng: 36.2384;
+    };
+    readonly dublin: {
+        readonly lat: 53.3498;
+        readonly lng: -6.2603;
+    };
+    readonly phoenix: {
+        readonly lat: 33.4484;
+        readonly lng: -112.074;
+    };
+    readonly portLouis: {
+        readonly lat: -20.1609;
+        readonly lng: 57.5012;
+    };
+    readonly riyadh: {
+        readonly lat: 24.7136;
+        readonly lng: 46.6753;
+    };
+    readonly bucharest: {
+        readonly lat: 44.4268;
+        readonly lng: 26.1025;
+    };
+    readonly vancouver: {
+        readonly lat: 49.2827;
+        readonly lng: -123.1207;
+    };
+    readonly baghdad: {
+        readonly lat: 33.3128;
+        readonly lng: 44.3615;
+    };
+    readonly cancun: {
+        readonly lat: 21.1619;
+        readonly lng: -86.8515;
+    };
+    readonly denpasar: {
+        readonly lat: -8.4095;
+        readonly lng: 115.1889;
+    };
+    readonly vientiane: {
+        readonly lat: 17.9714;
+        readonly lng: 102.6141;
+    };
+    readonly pune: {
+        readonly lat: 18.5204;
+        readonly lng: 73.8567;
+    };
+    readonly karachi: {
+        readonly lat: 24.8607;
+        readonly lng: 67.0011;
+    };
+    readonly denver: {
+        readonly lat: 39.7392;
+        readonly lng: -104.9903;
+    };
+};
+type KnownCity = keyof typeof cities;
+declare const randomLat: () => number;
+declare const randomLng: () => number;
+/**
+ * Development-friendly coordinates (centered over central Europe) so seeded
+ * data never lands in the ocean during local testing.
+ */
+declare const randomLatDev: () => number;
+declare const randomLngDev: () => number;
+declare const randomDevCoordinates: () => Coordinates;
+
+export { H_MAX, H_MIN, type KnownCity, L_MAX, L_MIN, type PastelDocColors, Stopwatch, StopwatchLapped, capitalizeFirstLetter, cities, enforceListTextInput, getTextColor, objectMap, preventMultipleBlankLines, randomDevCoordinates, randomIntBetween, randomLat, randomLatDev, randomLng, randomLngDev, randomPastelHex, randomPastelHsl, randomPastelHslDocColors, randomPastelHslString, randomPastelRgb, seedOffset, seededHslH, seededPastelHex, seededPastelHsl, seededPastelRgb, seededPastelRgbA, uuidPastelHex, uuidPastelHsl, uuidPastelRgb, uuidPastelRgbA };