@kikorin/util 1.0.0

package/dist/index.cjs

@@ -0,0 +1,383 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Crono: () => Crono,
+  blockKeywords: () => blockKeywords,
+  clamp: () => clamp,
+  colorFrmRange: () => colorFrmRange,
+  createChillUpdater: () => createChillUpdater,
+  createChronoTrigger: () => createChronoTrigger,
+  createRingBuffer: () => createRingBuffer,
+  currentLogLevel: () => currentLogLevel,
+  filterKeywords: () => filterKeywords,
+  getColorPair: () => getColorPair,
+  getContrastingColor: () => getContrastingColor,
+  getRndColor: () => getRndColor,
+  log: () => log,
+  logLevels: () => logLevels,
+  randomItem: () => randomItem,
+  rng: () => rng
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/logging.ts
+var logLevels = {
+  off: 0,
+  error: 1,
+  warning: 2,
+  debug: 3
+};
+var currentLogLevel = { value: logLevels.off };
+var filterKeywords = [];
+var blockKeywords = ["getRandomWord", "applyCooldowns", "calculateBoundingBox", "rollingAverage"];
+function log(level = logLevels.debug, message, keywords = [], ...data) {
+  if (!Object.values(logLevels).includes(level)) {
+    console.error(`[LOG ERROR] Invalid log level: ${level}`);
+    return;
+  }
+  if (currentLogLevel.value < level) return;
+  if (blockKeywords.some((keyword) => keywords.includes(keyword))) return;
+  if (filterKeywords.length > 0 && !filterKeywords.some((keyword) => keywords.includes(keyword))) return;
+  const copiedData = data.map((item) => {
+    try {
+      return JSON.parse(JSON.stringify(item));
+    } catch {
+      return item;
+    }
+  });
+  const method = level === logLevels.error ? "error" : level === logLevels.warning ? "warn" : "log";
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const keywordInfo = keywords.length > 0 ? ` [Keywords: ${keywords.join(", ")}]` : "";
+  console[method](`[${timestamp}] ${message}
+${keywordInfo}
+`, ...copiedData);
+}
+
+// src/ringBuffer.ts
+function createRingBuffer(capacity) {
+  if (capacity <= 0) {
+    throw new Error("RingBuffer capacity must be > 0");
+  }
+  const buffer = new Float64Array(capacity);
+  let head = 0;
+  let length = 0;
+  let total = 0;
+  return {
+    push(value) {
+      if (length < capacity) {
+        buffer[(head + length) % capacity] = value;
+        total += value;
+        length++;
+      } else {
+        const old = buffer[head];
+        total -= old;
+        buffer[head] = value;
+        total += value;
+        head = (head + 1) % capacity;
+      }
+    },
+    average() {
+      return length === 0 ? 0 : total / length;
+    },
+    sum() {
+      return total;
+    },
+    size() {
+      return length;
+    },
+    capacity() {
+      return capacity;
+    },
+    clear() {
+      head = 0;
+      length = 0;
+      total = 0;
+    }
+  };
+}
+
+// src/chillUpdate.ts
+function createChillUpdater() {
+  const records = /* @__PURE__ */ new Map();
+  const pendingKeys = /* @__PURE__ */ new Set();
+  const getNow = () => {
+    if (typeof performance !== "undefined" && typeof performance.now === "function") {
+      return performance.now();
+    }
+    return Date.now();
+  };
+  const check = () => {
+    if (records.size === 0 || pendingKeys.size === 0) return false;
+    const now = getNow();
+    let didSend = false;
+    for (const updateKey of pendingKeys) {
+      const record = records.get(updateKey);
+      if (record === void 0) {
+        pendingKeys.delete(updateKey);
+        continue;
+      }
+      if (record.lastSentAt !== 0 && now - record.lastSentAt < record.minMS) continue;
+      record.lastSentAt = now;
+      pendingKeys.delete(updateKey);
+      try {
+        record.updateFunction(record.value);
+      } catch (e) {
+        log(logLevels.error, "chillUpdater update failed", ["chillUpdate"], updateKey, e);
+      }
+      didSend = true;
+    }
+    return didSend;
+  };
+  const setUpdate = ({
+    updateKey,
+    updateFunction,
+    value,
+    minMS = 0
+  }) => {
+    const safeMinMS = minMS > 0 ? minMS : 0;
+    const existing = records.get(updateKey);
+    if (existing !== void 0) {
+      existing.updateFunction = updateFunction;
+      existing.value = value;
+      if (safeMinMS !== 0) existing.minMS = safeMinMS;
+      pendingKeys.add(updateKey);
+      return;
+    }
+    pendingKeys.add(updateKey);
+    records.set(updateKey, {
+      updateFunction,
+      value,
+      minMS: safeMinMS,
+      lastSentAt: 0
+    });
+  };
+  return {
+    check,
+    setUpdate
+  };
+}
+
+// src/chronoTrigger.ts
+function createChronoTrigger() {
+  const scheduledTasks = [];
+  const taskIndexById = /* @__PURE__ */ new Map();
+  let nextTaskId = 1;
+  const maxTicks = 5;
+  const catchupWarningThrottleMs = 5e3;
+  let running = false;
+  let rafId = 0;
+  let fps = 0;
+  const fpsHist = createRingBuffer(100);
+  let lastFrameTime = 0;
+  const Start = () => {
+    if (running) return;
+    running = true;
+    const frame = (time) => {
+      if (!running) return;
+      let delta = 0;
+      if (lastFrameTime > 0) {
+        delta = time - lastFrameTime;
+        if (delta > 0) {
+          const newFps = Math.round(1e3 / Math.max(delta, 1));
+          fps = newFps !== 1e3 ? newFps : fps;
+          fpsHist.push(fps);
+        }
+      }
+      lastFrameTime = time;
+      for (let i = 0; i < scheduledTasks.length; i++) {
+        const task = scheduledTasks[i];
+        if (task.intervalMs <= 0) {
+          task.callback(delta);
+          continue;
+        }
+        task.accumulatorMs += delta;
+        if (task.accumulatorMs > task.intervalMs * maxTicks) {
+          task.accumulatorMs = task.intervalMs * maxTicks;
+          if (time - task.lastCatchupWarningMs >= catchupWarningThrottleMs) {
+            task.lastCatchupWarningMs = time;
+            log(
+              logLevels.warning,
+              `${task.callbackName} fell behind and attempted catch-up ticks, but catch-up was capped at ${maxTicks}.`,
+              ["chronoTrigger"]
+            );
+          }
+        }
+        const ticks = task.accumulatorMs / task.intervalMs | 0;
+        if (ticks <= 0) continue;
+        task.accumulatorMs -= ticks * task.intervalMs;
+        for (let t = 0; t < ticks; t++) {
+          task.callback(task.intervalMs);
+        }
+      }
+      rafId = requestAnimationFrame(frame);
+    };
+    rafId = requestAnimationFrame(frame);
+  };
+  const Stop = () => {
+    running = false;
+    lastFrameTime = 0;
+    if (rafId) {
+      cancelAnimationFrame(rafId);
+      rafId = 0;
+    }
+  };
+  const dispose = (id) => {
+    const index = taskIndexById.get(id);
+    if (index === void 0) return false;
+    const lastIndex = scheduledTasks.length - 1;
+    if (index !== lastIndex) {
+      const lastTask = scheduledTasks[lastIndex];
+      scheduledTasks[index] = lastTask;
+      taskIndexById.set(lastTask.id, index);
+    }
+    scheduledTasks.pop();
+    taskIndexById.delete(id);
+    return true;
+  };
+  const runAt = ({
+    name,
+    fpsTarget,
+    callback
+  }) => {
+    if (typeof callback !== "function") {
+      throw new Error("runAt requires a callback function.");
+    }
+    let intervalMs = 0;
+    if (fpsTarget !== void 0) {
+      if (!Number.isFinite(fpsTarget) || fpsTarget <= 0) {
+        throw new Error("fpsTarget must be a positive number when provided.");
+      }
+      intervalMs = 1e3 / fpsTarget;
+    }
+    const id = nextTaskId++;
+    const callbackName = name || callback.name || "anonymous";
+    const accumulatorMs = intervalMs > 0 ? intervalMs : 0;
+    scheduledTasks.push({
+      id,
+      callback,
+      callbackName,
+      intervalMs,
+      accumulatorMs,
+      lastCatchupWarningMs: -Infinity
+    });
+    taskIndexById.set(id, scheduledTasks.length - 1);
+    return id;
+  };
+  const CurrentFPS = () => fps;
+  const AverageFPS = () => Math.round(fpsHist.average());
+  return { Start, Stop, runAt, dispose, CurrentFPS, AverageFPS };
+}
+var Crono = createChronoTrigger();
+
+// src/random.ts
+function rng(low, high, decimals = null) {
+  const min = low < high ? low : high;
+  const max = low < high ? high : low;
+  const lowDecimals = (Math.abs(low).toString().split(".")[1] || "").length;
+  const highDecimals = (Math.abs(high).toString().split(".")[1] || "").length;
+  const derivedDecimals = Math.max(lowDecimals, highDecimals);
+  const precision = decimals !== null ? decimals : derivedDecimals;
+  const factor = 10 ** precision;
+  const randomValue = Math.random() * (max - min) + min;
+  return Math.round(randomValue * factor) / factor;
+}
+function clamp(value, low, high) {
+  return Math.max(low, Math.min(high, value));
+}
+function randomItem(collection) {
+  if (collection.length === 0) {
+    log(logLevels.error, "Cannot select a random item from an empty array.", ["randomItem"], collection);
+  }
+  return collection[Math.floor(rng(0, collection.length - 1))];
+}
+function getRndColor() {
+  const red = Math.round(Math.random() * 234 + 10);
+  const green = Math.round(Math.random() * 234 + 20);
+  const blue = Math.round(Math.random() * 234 + 20);
+  const color = "#" + red.toString(16) + green.toString(16) + blue.toString(16);
+  return color;
+}
+function getColorPair() {
+  const red = Math.round(Math.random() * 234 + 10);
+  const antiRed = Math.abs(red - 234) + 20;
+  const green = Math.round(Math.random() * 234 + 20);
+  const antiGreen = Math.abs(green - 234) + 20;
+  const blue = Math.round(Math.random() * 234 + 20);
+  const antiblue = Math.abs(blue - 234) + 20;
+  const color = "#" + red.toString(16) + green.toString(16) + blue.toString(16);
+  const antiColor = "#" + antiRed.toString(16) + antiGreen.toString(16) + antiblue.toString(16);
+  return { c1: color, c2: antiColor };
+}
+function colorFrmRange(c1, c2, percent) {
+  percent = percent / 100;
+  const c1R = parseInt(c1.slice(1, 3), 16);
+  const c1G = parseInt(c1.slice(3, 5), 16);
+  const c1B = parseInt(c1.slice(5, 7), 16);
+  const c2R = parseInt(c2.slice(1, 3), 16);
+  const c2G = parseInt(c2.slice(3, 5), 16);
+  const c2B = parseInt(c2.slice(5, 7), 16);
+  const rDif = c1R - c2R;
+  const gDif = c1G - c2G;
+  const bDif = c1B - c2B;
+  let red = Math.round(c1R - percent * rDif).toString(16);
+  let green = Math.round(c1G - percent * gDif).toString(16);
+  let blue = Math.round(c1B - percent * bDif).toString(16);
+  if (red.length < 2) {
+    red = "0" + red;
+  }
+  if (green.length < 2) {
+    green = "0" + green;
+  }
+  if (blue.length < 2) {
+    blue = "0" + blue;
+  }
+  const color = "#" + red + green + blue;
+  return color;
+}
+function getContrastingColor(hexColor) {
+  const normalizedHex = hexColor.replace(/^#/, "");
+  const r = parseInt(normalizedHex.slice(0, 2), 16);
+  const g = parseInt(normalizedHex.slice(2, 4), 16);
+  const b = parseInt(normalizedHex.slice(4, 6), 16);
+  const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+  return luminance > 0.5 ? "#000000" : "#FFFFFF";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Crono,
+  blockKeywords,
+  clamp,
+  colorFrmRange,
+  createChillUpdater,
+  createChronoTrigger,
+  createRingBuffer,
+  currentLogLevel,
+  filterKeywords,
+  getColorPair,
+  getContrastingColor,
+  getRndColor,
+  log,
+  logLevels,
+  randomItem,
+  rng
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/logging.ts","../src/ringBuffer.ts","../src/chillUpdate.ts","../src/chronoTrigger.ts","../src/random.ts"],"sourcesContent":["export * from './logging'\nexport * from './ringBuffer'\nexport * from './chillUpdate'\nexport * from './chronoTrigger'\nexport * from './random'\n","export const logLevels = {\n    off: 0,\n    error: 1,\n    warning: 2,\n    debug: 3,\n};\n\n// Mutable object so any module can update the level at runtime.\n// Off by default so production builds are quiet; set to logLevels.debug to enable.\nexport const currentLogLevel = { value: logLevels.off };\n\n// filterKeywords: when non-empty, only messages tagged with one of these pass through.\n// blockKeywords: messages tagged with any of these are always suppressed.\nexport const filterKeywords: string[] = [];\nexport const blockKeywords: string[] = [\"getRandomWord\", \"applyCooldowns\", \"calculateBoundingBox\", \"rollingAverage\"];\n\nexport function log(\n    level: number = logLevels.debug,\n    message: string,\n    keywords: string[] = [],\n    ...data: unknown[]\n  ): void {\n      if (!Object.values(logLevels).includes(level)) {\n          console.error(`[LOG ERROR] Invalid log level: ${level}`);\n          return;\n      }\n\n      if (currentLogLevel.value < level) return;\n\n      if (blockKeywords.some(keyword => keywords.includes(keyword))) return;\n\n      if (filterKeywords.length > 0 && !filterKeywords.some(keyword => keywords.includes(keyword))) return;\n\n      // Deep copy prevents logged objects from mutating after the call.\n      const copiedData = data.map(item => {\n          try {\n              return JSON.parse(JSON.stringify(item));\n          } catch {\n              return item;\n          }\n      });\n\n      const method = level === logLevels.error ? \"error\"\n                   : level === logLevels.warning ? \"warn\"\n                   : \"log\";\n\n      const timestamp = new Date().toISOString();\n      const keywordInfo = keywords.length > 0 ? ` [Keywords: ${keywords.join(\", \")}]` : \"\";\n\n      console[method](`[${timestamp}] ${message}\\n${keywordInfo}\\n`, ...copiedData);\n  }\n","export interface RingBuffer {\n  push(value: number): void\n  average(): number\n  sum(): number\n  size(): number\n  capacity(): number\n  clear(): void\n}\n\nexport function createRingBuffer(capacity: number): RingBuffer {\n  if (capacity <= 0) {\n    throw new Error(\"RingBuffer capacity must be > 0\")\n  }\n\n  const buffer = new Float64Array(capacity)\n  let head = 0        // points to oldest value\n  let length = 0\n  let total = 0\n\n  return {\n    push(value: number) {\n      if (length < capacity) {\n        // still filling\n        buffer[(head + length) % capacity] = value\n        total += value\n        length++\n      } else {\n        // overwrite oldest\n        const old = buffer[head]\n        total -= old\n        buffer[head] = value\n        total += value\n        head = (head + 1) % capacity\n      }\n    },\n\n    average() {\n      return length === 0 ? 0 : total / length\n    },\n\n    sum() {\n      return total\n    },\n\n    size() {\n      return length\n    },\n\n    capacity() {\n      return capacity\n    },\n\n    clear() {\n      head = 0\n      length = 0\n      total = 0\n    }\n  }\n}\n","import { log, logLevels } from \"./logging\";\n\nexport type ChillUpdateFn<TValue> = (value: TValue) => void;\n\nexport type ChillUpdaterSetParams<TValue> = {\n  updateKey: string;\n  updateFunction: ChillUpdateFn<TValue>;\n  value: TValue;\n  minMS?: number;\n};\n\nexport type ChillUpdater = {\n  check: () => boolean;\n  setUpdate: <TValue>(params: ChillUpdaterSetParams<TValue>) => void;\n};\n\ntype UpdateRecord = {\n  updateFunction: ChillUpdateFn<unknown>;\n  value: unknown;\n  minMS: number;\n  lastSentAt: number;\n};\n\nfunction createChillUpdater(): ChillUpdater {\n  const records = new Map<string, UpdateRecord>();\n  const pendingKeys = new Set<string>();\n  const getNow = (): number => {\n    if (typeof performance !== \"undefined\" && typeof performance.now === \"function\") {\n      return performance.now();\n    }\n    return Date.now();\n  };\n\n  const check = (): boolean => {\n    if (records.size === 0 || pendingKeys.size === 0) return false;\n\n    const now = getNow();\n    let didSend = false;\n\n    for (const updateKey of pendingKeys) {\n      const record = records.get(updateKey);\n      if (record === undefined) {\n        pendingKeys.delete(updateKey);\n        continue;\n      }\n      if (record.lastSentAt !== 0 && now - record.lastSentAt < record.minMS) continue;\n\n      record.lastSentAt = now;\n      pendingKeys.delete(updateKey);\n      try {\n        record.updateFunction(record.value);\n      }\n      catch (e) {\n        log(logLevels.error, \"chillUpdater update failed\", [\"chillUpdate\"], updateKey, e);\n      }\n\n      didSend = true;\n    }\n\n    return didSend;\n  };\n\n  const setUpdate = <TValue>({\n    updateKey,\n    updateFunction,\n    value,\n    minMS = 0,\n  }: ChillUpdaterSetParams<TValue>): void => {\n    const safeMinMS = minMS > 0 ? minMS : 0;\n    const existing = records.get(updateKey);\n\n    if (existing !== undefined) {\n      existing.updateFunction = updateFunction as ChillUpdateFn<unknown>;\n      existing.value = value;\n      if (safeMinMS !== 0) existing.minMS = safeMinMS;\n      pendingKeys.add(updateKey);\n      return;\n    }\n\n    pendingKeys.add(updateKey);\n    records.set(updateKey, {\n      updateFunction: updateFunction as ChillUpdateFn<unknown>,\n      value,\n      minMS: safeMinMS,\n      lastSentAt: 0\n    });\n  };\n\n  return {\n    check,\n    setUpdate\n  };\n}\n\nexport { createChillUpdater };\n","// ChronoTrigger Library (CT) using Factory Functions with FPS Tracking\nimport { log, logLevels } from './logging';\nimport { createRingBuffer } from './ringBuffer';\n\ninterface ScheduledTask {\n    id: number;\n    callback: (deltaMs: number) => void;\n    callbackName: string;\n    intervalMs: number;\n    accumulatorMs: number;\n    lastCatchupWarningMs: number;\n}\n\nexport interface ChronoTrigger {\n    Start: () => void;\n    Stop: () => void;\n    runAt: (options: { name?: string; callback: (deltaMs: number) => void; fpsTarget?: number }) => number;\n    dispose: (id: number) => boolean;\n    CurrentFPS: () => number;\n    AverageFPS: () => number;\n}\n\nexport function createChronoTrigger(): ChronoTrigger {\n    const scheduledTasks: ScheduledTask[] = [];\n    const taskIndexById = new Map<number, number>();\n    let nextTaskId = 1;\n    const maxTicks = 5;\n    const catchupWarningThrottleMs = 5000;\n    let running = false;\n    let rafId = 0;\n    let fps = 0; // Tracks the current running FPS\n    const fpsHist = createRingBuffer(100);\n    let lastFrameTime = 0;\n\n    const Start = (): void => {\n        if (running) return;\n        running = true;\n        const frame = (time: number): void => {\n            if (!running) return;\n\n            let delta = 0;\n            if (lastFrameTime > 0) {\n                delta = time - lastFrameTime;\n                if (delta > 0) {\n                    // using Math.max to avoid divide by 0\n                    const newFps = Math.round(1000 / Math.max(delta, 1));\n                    fps = newFps !== 1000 ? newFps : fps;\n                    fpsHist.push(fps);\n                }\n            }\n            lastFrameTime = time;\n\n            for (let i = 0; i < scheduledTasks.length; i++) {\n                const task = scheduledTasks[i];\n                if (task.intervalMs <= 0) {\n                    task.callback(delta);\n                    continue;\n                }\n\n                task.accumulatorMs += delta;\n                if (task.accumulatorMs > task.intervalMs * maxTicks) {\n                    task.accumulatorMs = task.intervalMs * maxTicks;\n                    if (time - task.lastCatchupWarningMs >= catchupWarningThrottleMs) {\n                        task.lastCatchupWarningMs = time;\n                        log(\n                            logLevels.warning,\n                            `${task.callbackName} fell behind and attempted catch-up ticks, but catch-up was capped at ${maxTicks}.`,\n                            [\"chronoTrigger\"],\n                        );\n                    }\n                }\n\n                const ticks = (task.accumulatorMs / task.intervalMs) | 0;\n                if (ticks <= 0) continue;\n\n                task.accumulatorMs -= ticks * task.intervalMs;\n                for (let t = 0; t < ticks; t++) {\n                    task.callback(task.intervalMs);\n                }\n            }\n\n            rafId = requestAnimationFrame(frame);\n        };\n        rafId = requestAnimationFrame(frame);\n    };\n\n    const Stop = (): void => {\n        running = false;\n        lastFrameTime = 0;\n        if (rafId) {\n            cancelAnimationFrame(rafId);\n            rafId = 0;\n        }\n    };\n\n    const dispose = (id: number): boolean => {\n        const index = taskIndexById.get(id);\n        if (index === undefined) return false;\n\n        const lastIndex = scheduledTasks.length - 1;\n        if (index !== lastIndex) {\n            const lastTask = scheduledTasks[lastIndex];\n            scheduledTasks[index] = lastTask;\n            taskIndexById.set(lastTask.id, index);\n        }\n\n        scheduledTasks.pop();\n        taskIndexById.delete(id);\n        return true;\n    };\n\n    const runAt = ({\n        name,\n        fpsTarget,\n        callback,\n    }: {\n        name?: string;\n        callback: (deltaMs: number) => void;\n        fpsTarget?: number;\n    }): number => {\n        if (typeof callback !== \"function\") {\n            throw new Error(\"runAt requires a callback function.\");\n        }\n\n        let intervalMs = 0;\n        if (fpsTarget !== undefined) {\n            if (!Number.isFinite(fpsTarget) || fpsTarget <= 0) {\n                throw new Error(\"fpsTarget must be a positive number when provided.\");\n            }\n\n            intervalMs = 1000 / fpsTarget;\n        }\n\n        const id = nextTaskId++;\n        const callbackName = name || callback.name || \"anonymous\";\n        const accumulatorMs = intervalMs > 0 ? intervalMs : 0;\n        scheduledTasks.push({\n            id,\n            callback,\n            callbackName,\n            intervalMs,\n            accumulatorMs,\n            lastCatchupWarningMs: -Infinity,\n        });\n        taskIndexById.set(id, scheduledTasks.length - 1);\n        return id;\n    };\n\n    const CurrentFPS = (): number => fps;\n    const AverageFPS = (): number => Math.round(fpsHist.average());\n\n    return { Start, Stop, runAt, dispose, CurrentFPS, AverageFPS };\n}\n\nexport const Crono = createChronoTrigger();\n","import { log, logLevels } from \"./logging\";\n\n/**\n * Generates a random number within the specified range, supporting precision.\n *\n * - If `decimals` is provided, the result is rounded to that many decimal places.\n * - If `decimals` is not provided, the precision is derived from the decimal places of the `low` and `high` inputs.\n *\n * @param {number} low - The minimum value (inclusive) of the range.\n * @param {number} high - The maximum value (exclusive) of the range.\n * @param {number | null} [decimals=null] - The number of decimal places to round to. If not provided, precision is derived automatically.\n * @returns {number} - A random number between `low` and `high`, rounded to the specified or derived precision.\n *\n * @example\n * // Example 1: Whole number output\n * rng(1, 10); // Could return 7\n *\n * @example\n * // Example 2: Fixed decimal places\n * rng(1.5, 3.5, 2); // Could return 2.78\n *\n * @example\n * // Example 3: Automatically derived precision\n * rng(0.001, 0.1); // Could return 0.023 (3 decimal places derived)\n */\n\nexport function rng(low: number, high: number, decimals: number | null = null): number {\n    const min = low < high ? low : high;\n    const max = low < high ? high : low;\n    const lowDecimals = (Math.abs(low).toString().split(\".\")[1] || \"\").length;\n    const highDecimals = (Math.abs(high).toString().split(\".\")[1] || \"\").length;\n    const derivedDecimals = Math.max(lowDecimals, highDecimals); // Derive max precision\n    const precision = decimals !== null ? decimals : derivedDecimals;\n    const factor = 10 ** precision;\n\n    const randomValue = Math.random() * (max - min) + min;\n\n    return Math.round(randomValue * factor) / factor;\n}\n\nexport function clamp(value: number, low: number, high: number) {\n    return Math.max(low, Math.min(high, value));\n}\n\n/**\n * Selects a random item from an array of a specific type.\n *\n * Utilizes the `rng` function to generate a random index within the bounds of the array.\n *\n * @template T - The type of elements in the array.\n * @param {T[]} collection - The array to select a random item from.\n * @returns {T} - A randomly selected item from the array.\n *\n * @throws {Error} Throws an error if the collection is empty.\n *\n * @example\n * // Example 1: Random item from a number array\n * const numbers = [1, 2, 3, 4, 5];\n * const randomNum = randomItem(numbers); // TypeScript infers: number\n *\n * @example\n * // Example 2: Random item from a string array\n * const fruits = [\"apple\", \"banana\", \"cherry\"];\n * const randomFruit = randomItem(fruits); // TypeScript infers: string\n */\nexport function randomItem<T>(collection: T[]): T {\n    if (collection.length === 0) {\n        log(logLevels.error, \"Cannot select a random item from an empty array.\", ['randomItem'], collection);\n    }\n    return collection[Math.floor(rng(0, collection.length-1))];\n}\n\nexport function getRndColor(){\n\n    const red = Math.round(Math.random() * (234)+10);\n\tconst green= Math.round(Math.random() * (234)+20);\n\tconst blue= Math.round(Math.random() * (234)+20);\n\n\tconst color =\"#\"+red.toString(16)+green.toString(16)+blue.toString(16);\n\n\treturn color;\n}\n\nexport function getColorPair() {\n\n    const red = Math.round(Math.random() * (234) + 10);\n    const antiRed = Math.abs(red - 234) + 20;\n    const green = Math.round(Math.random() * (234) + 20);\n    const antiGreen = Math.abs(green - 234) + 20;\n    const blue = Math.round(Math.random() * (234) + 20);\n    const antiblue = Math.abs(blue - 234) + 20;\n\n    const color = \"#\" + red.toString(16) + green.toString(16) + blue.toString(16);\n    const antiColor = \"#\" + antiRed.toString(16) + antiGreen.toString(16) + antiblue.toString(16);\n\n    return { c1: color, c2: antiColor };\n  }\n\n  export function colorFrmRange(c1: string, c2: string, percent: number) {\n    percent = percent / 100;\n\n    const c1R = parseInt(c1.slice(1, 3), 16);\n    const c1G = parseInt(c1.slice(3, 5), 16);\n    const c1B = parseInt(c1.slice(5, 7), 16);\n\n    const c2R = parseInt(c2.slice(1, 3), 16);\n    const c2G = parseInt(c2.slice(3, 5), 16);\n    const c2B = parseInt(c2.slice(5, 7), 16);\n\n    const rDif = c1R - c2R;\n    const gDif = c1G - c2G;\n    const bDif = c1B - c2B;\n\n    let red = Math.round(c1R - percent * rDif).toString(16);\n    let green = Math.round(c1G - percent * gDif).toString(16);\n    let blue = Math.round(c1B - percent * bDif).toString(16);\n\n    if (red.length < 2) { red = \"0\" + red; }\n    if (green.length < 2) { green = \"0\" + green; }\n    if (blue.length < 2) { blue = \"0\" + blue; }\n\n    const color = \"#\" + red + green + blue;\n\n    return color;\n  }\n\n  /**\n * Determines whether a hex color is light or dark and returns a contrasting color (black or white).\n * @param hexColor - The hex color string (e.g., \"#FFFFFF\" or \"FFFFFF\").\n * @returns A string representing the contrasting color (\"#000000\" for black or \"#FFFFFF\" for white).\n */\nexport function getContrastingColor(hexColor: string): string {\n    // Remove the '#' if present\n    const normalizedHex = hexColor.replace(/^#/, \"\");\n\n    // Parse the RGB values\n    const r = parseInt(normalizedHex.slice(0, 2), 16);\n    const g = parseInt(normalizedHex.slice(2, 4), 16);\n    const b = parseInt(normalizedHex.slice(4, 6), 16);\n\n    // Calculate the relative luminance (standard formula)\n    const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;\n\n    // Return black for light backgrounds, white for dark backgrounds\n    return luminance > 0.5 ? \"#000000\" : \"#FFFFFF\";\n  }\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,112 @@
+declare const logLevels: {
+    off: number;
+    error: number;
+    warning: number;
+    debug: number;
+};
+declare const currentLogLevel: {
+    value: number;
+};
+declare const filterKeywords: string[];
+declare const blockKeywords: string[];
+declare function log(level: number | undefined, message: string, keywords?: string[], ...data: unknown[]): void;
+
+interface RingBuffer {
+    push(value: number): void;
+    average(): number;
+    sum(): number;
+    size(): number;
+    capacity(): number;
+    clear(): void;
+}
+declare function createRingBuffer(capacity: number): RingBuffer;
+
+type ChillUpdateFn<TValue> = (value: TValue) => void;
+type ChillUpdaterSetParams<TValue> = {
+    updateKey: string;
+    updateFunction: ChillUpdateFn<TValue>;
+    value: TValue;
+    minMS?: number;
+};
+type ChillUpdater = {
+    check: () => boolean;
+    setUpdate: <TValue>(params: ChillUpdaterSetParams<TValue>) => void;
+};
+declare function createChillUpdater(): ChillUpdater;
+
+interface ChronoTrigger {
+    Start: () => void;
+    Stop: () => void;
+    runAt: (options: {
+        name?: string;
+        callback: (deltaMs: number) => void;
+        fpsTarget?: number;
+    }) => number;
+    dispose: (id: number) => boolean;
+    CurrentFPS: () => number;
+    AverageFPS: () => number;
+}
+declare function createChronoTrigger(): ChronoTrigger;
+declare const Crono: ChronoTrigger;
+
+/**
+ * Generates a random number within the specified range, supporting precision.
+ *
+ * - If `decimals` is provided, the result is rounded to that many decimal places.
+ * - If `decimals` is not provided, the precision is derived from the decimal places of the `low` and `high` inputs.
+ *
+ * @param {number} low - The minimum value (inclusive) of the range.
+ * @param {number} high - The maximum value (exclusive) of the range.
+ * @param {number | null} [decimals=null] - The number of decimal places to round to. If not provided, precision is derived automatically.
+ * @returns {number} - A random number between `low` and `high`, rounded to the specified or derived precision.
+ *
+ * @example
+ * // Example 1: Whole number output
+ * rng(1, 10); // Could return 7
+ *
+ * @example
+ * // Example 2: Fixed decimal places
+ * rng(1.5, 3.5, 2); // Could return 2.78
+ *
+ * @example
+ * // Example 3: Automatically derived precision
+ * rng(0.001, 0.1); // Could return 0.023 (3 decimal places derived)
+ */
+declare function rng(low: number, high: number, decimals?: number | null): number;
+declare function clamp(value: number, low: number, high: number): number;
+/**
+ * Selects a random item from an array of a specific type.
+ *
+ * Utilizes the `rng` function to generate a random index within the bounds of the array.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} collection - The array to select a random item from.
+ * @returns {T} - A randomly selected item from the array.
+ *
+ * @throws {Error} Throws an error if the collection is empty.
+ *
+ * @example
+ * // Example 1: Random item from a number array
+ * const numbers = [1, 2, 3, 4, 5];
+ * const randomNum = randomItem(numbers); // TypeScript infers: number
+ *
+ * @example
+ * // Example 2: Random item from a string array
+ * const fruits = ["apple", "banana", "cherry"];
+ * const randomFruit = randomItem(fruits); // TypeScript infers: string
+ */
+declare function randomItem<T>(collection: T[]): T;
+declare function getRndColor(): string;
+declare function getColorPair(): {
+    c1: string;
+    c2: string;
+};
+declare function colorFrmRange(c1: string, c2: string, percent: number): string;
+/**
+* Determines whether a hex color is light or dark and returns a contrasting color (black or white).
+* @param hexColor - The hex color string (e.g., "#FFFFFF" or "FFFFFF").
+* @returns A string representing the contrasting color ("#000000" for black or "#FFFFFF" for white).
+*/
+declare function getContrastingColor(hexColor: string): string;
+
+export { type ChillUpdateFn, type ChillUpdater, type ChillUpdaterSetParams, type ChronoTrigger, Crono, type RingBuffer, blockKeywords, clamp, colorFrmRange, createChillUpdater, createChronoTrigger, createRingBuffer, currentLogLevel, filterKeywords, getColorPair, getContrastingColor, getRndColor, log, logLevels, randomItem, rng };

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+declare const logLevels: {
+    off: number;
+    error: number;
+    warning: number;
+    debug: number;
+};
+declare const currentLogLevel: {
+    value: number;
+};
+declare const filterKeywords: string[];
+declare const blockKeywords: string[];
+declare function log(level: number | undefined, message: string, keywords?: string[], ...data: unknown[]): void;
+
+interface RingBuffer {
+    push(value: number): void;
+    average(): number;
+    sum(): number;
+    size(): number;
+    capacity(): number;
+    clear(): void;
+}
+declare function createRingBuffer(capacity: number): RingBuffer;
+
+type ChillUpdateFn<TValue> = (value: TValue) => void;
+type ChillUpdaterSetParams<TValue> = {
+    updateKey: string;
+    updateFunction: ChillUpdateFn<TValue>;
+    value: TValue;
+    minMS?: number;
+};
+type ChillUpdater = {
+    check: () => boolean;
+    setUpdate: <TValue>(params: ChillUpdaterSetParams<TValue>) => void;
+};
+declare function createChillUpdater(): ChillUpdater;
+
+interface ChronoTrigger {
+    Start: () => void;
+    Stop: () => void;
+    runAt: (options: {
+        name?: string;
+        callback: (deltaMs: number) => void;
+        fpsTarget?: number;
+    }) => number;
+    dispose: (id: number) => boolean;
+    CurrentFPS: () => number;
+    AverageFPS: () => number;
+}
+declare function createChronoTrigger(): ChronoTrigger;
+declare const Crono: ChronoTrigger;
+
+/**
+ * Generates a random number within the specified range, supporting precision.
+ *
+ * - If `decimals` is provided, the result is rounded to that many decimal places.
+ * - If `decimals` is not provided, the precision is derived from the decimal places of the `low` and `high` inputs.
+ *
+ * @param {number} low - The minimum value (inclusive) of the range.
+ * @param {number} high - The maximum value (exclusive) of the range.
+ * @param {number | null} [decimals=null] - The number of decimal places to round to. If not provided, precision is derived automatically.
+ * @returns {number} - A random number between `low` and `high`, rounded to the specified or derived precision.
+ *
+ * @example
+ * // Example 1: Whole number output
+ * rng(1, 10); // Could return 7
+ *
+ * @example
+ * // Example 2: Fixed decimal places
+ * rng(1.5, 3.5, 2); // Could return 2.78
+ *
+ * @example
+ * // Example 3: Automatically derived precision
+ * rng(0.001, 0.1); // Could return 0.023 (3 decimal places derived)
+ */
+declare function rng(low: number, high: number, decimals?: number | null): number;
+declare function clamp(value: number, low: number, high: number): number;
+/**
+ * Selects a random item from an array of a specific type.
+ *
+ * Utilizes the `rng` function to generate a random index within the bounds of the array.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} collection - The array to select a random item from.
+ * @returns {T} - A randomly selected item from the array.
+ *
+ * @throws {Error} Throws an error if the collection is empty.
+ *
+ * @example
+ * // Example 1: Random item from a number array
+ * const numbers = [1, 2, 3, 4, 5];
+ * const randomNum = randomItem(numbers); // TypeScript infers: number
+ *
+ * @example
+ * // Example 2: Random item from a string array
+ * const fruits = ["apple", "banana", "cherry"];
+ * const randomFruit = randomItem(fruits); // TypeScript infers: string
+ */
+declare function randomItem<T>(collection: T[]): T;
+declare function getRndColor(): string;
+declare function getColorPair(): {
+    c1: string;
+    c2: string;
+};
+declare function colorFrmRange(c1: string, c2: string, percent: number): string;
+/**
+* Determines whether a hex color is light or dark and returns a contrasting color (black or white).
+* @param hexColor - The hex color string (e.g., "#FFFFFF" or "FFFFFF").
+* @returns A string representing the contrasting color ("#000000" for black or "#FFFFFF" for white).
+*/
+declare function getContrastingColor(hexColor: string): string;
+
+export { type ChillUpdateFn, type ChillUpdater, type ChillUpdaterSetParams, type ChronoTrigger, Crono, type RingBuffer, blockKeywords, clamp, colorFrmRange, createChillUpdater, createChronoTrigger, createRingBuffer, currentLogLevel, filterKeywords, getColorPair, getContrastingColor, getRndColor, log, logLevels, randomItem, rng };

package/dist/index.js

@@ -0,0 +1,341 @@
+// src/logging.ts
+var logLevels = {
+  off: 0,
+  error: 1,
+  warning: 2,
+  debug: 3
+};
+var currentLogLevel = { value: logLevels.off };
+var filterKeywords = [];
+var blockKeywords = ["getRandomWord", "applyCooldowns", "calculateBoundingBox", "rollingAverage"];
+function log(level = logLevels.debug, message, keywords = [], ...data) {
+  if (!Object.values(logLevels).includes(level)) {
+    console.error(`[LOG ERROR] Invalid log level: ${level}`);
+    return;
+  }
+  if (currentLogLevel.value < level) return;
+  if (blockKeywords.some((keyword) => keywords.includes(keyword))) return;
+  if (filterKeywords.length > 0 && !filterKeywords.some((keyword) => keywords.includes(keyword))) return;
+  const copiedData = data.map((item) => {
+    try {
+      return JSON.parse(JSON.stringify(item));
+    } catch {
+      return item;
+    }
+  });
+  const method = level === logLevels.error ? "error" : level === logLevels.warning ? "warn" : "log";
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const keywordInfo = keywords.length > 0 ? ` [Keywords: ${keywords.join(", ")}]` : "";
+  console[method](`[${timestamp}] ${message}
+${keywordInfo}
+`, ...copiedData);
+}
+
+// src/ringBuffer.ts
+function createRingBuffer(capacity) {
+  if (capacity <= 0) {
+    throw new Error("RingBuffer capacity must be > 0");
+  }
+  const buffer = new Float64Array(capacity);
+  let head = 0;
+  let length = 0;
+  let total = 0;
+  return {
+    push(value) {
+      if (length < capacity) {
+        buffer[(head + length) % capacity] = value;
+        total += value;
+        length++;
+      } else {
+        const old = buffer[head];
+        total -= old;
+        buffer[head] = value;
+        total += value;
+        head = (head + 1) % capacity;
+      }
+    },
+    average() {
+      return length === 0 ? 0 : total / length;
+    },
+    sum() {
+      return total;
+    },
+    size() {
+      return length;
+    },
+    capacity() {
+      return capacity;
+    },
+    clear() {
+      head = 0;
+      length = 0;
+      total = 0;
+    }
+  };
+}
+
+// src/chillUpdate.ts
+function createChillUpdater() {
+  const records = /* @__PURE__ */ new Map();
+  const pendingKeys = /* @__PURE__ */ new Set();
+  const getNow = () => {
+    if (typeof performance !== "undefined" && typeof performance.now === "function") {
+      return performance.now();
+    }
+    return Date.now();
+  };
+  const check = () => {
+    if (records.size === 0 || pendingKeys.size === 0) return false;
+    const now = getNow();
+    let didSend = false;
+    for (const updateKey of pendingKeys) {
+      const record = records.get(updateKey);
+      if (record === void 0) {
+        pendingKeys.delete(updateKey);
+        continue;
+      }
+      if (record.lastSentAt !== 0 && now - record.lastSentAt < record.minMS) continue;
+      record.lastSentAt = now;
+      pendingKeys.delete(updateKey);
+      try {
+        record.updateFunction(record.value);
+      } catch (e) {
+        log(logLevels.error, "chillUpdater update failed", ["chillUpdate"], updateKey, e);
+      }
+      didSend = true;
+    }
+    return didSend;
+  };
+  const setUpdate = ({
+    updateKey,
+    updateFunction,
+    value,
+    minMS = 0
+  }) => {
+    const safeMinMS = minMS > 0 ? minMS : 0;
+    const existing = records.get(updateKey);
+    if (existing !== void 0) {
+      existing.updateFunction = updateFunction;
+      existing.value = value;
+      if (safeMinMS !== 0) existing.minMS = safeMinMS;
+      pendingKeys.add(updateKey);
+      return;
+    }
+    pendingKeys.add(updateKey);
+    records.set(updateKey, {
+      updateFunction,
+      value,
+      minMS: safeMinMS,
+      lastSentAt: 0
+    });
+  };
+  return {
+    check,
+    setUpdate
+  };
+}
+
+// src/chronoTrigger.ts
+function createChronoTrigger() {
+  const scheduledTasks = [];
+  const taskIndexById = /* @__PURE__ */ new Map();
+  let nextTaskId = 1;
+  const maxTicks = 5;
+  const catchupWarningThrottleMs = 5e3;
+  let running = false;
+  let rafId = 0;
+  let fps = 0;
+  const fpsHist = createRingBuffer(100);
+  let lastFrameTime = 0;
+  const Start = () => {
+    if (running) return;
+    running = true;
+    const frame = (time) => {
+      if (!running) return;
+      let delta = 0;
+      if (lastFrameTime > 0) {
+        delta = time - lastFrameTime;
+        if (delta > 0) {
+          const newFps = Math.round(1e3 / Math.max(delta, 1));
+          fps = newFps !== 1e3 ? newFps : fps;
+          fpsHist.push(fps);
+        }
+      }
+      lastFrameTime = time;
+      for (let i = 0; i < scheduledTasks.length; i++) {
+        const task = scheduledTasks[i];
+        if (task.intervalMs <= 0) {
+          task.callback(delta);
+          continue;
+        }
+        task.accumulatorMs += delta;
+        if (task.accumulatorMs > task.intervalMs * maxTicks) {
+          task.accumulatorMs = task.intervalMs * maxTicks;
+          if (time - task.lastCatchupWarningMs >= catchupWarningThrottleMs) {
+            task.lastCatchupWarningMs = time;
+            log(
+              logLevels.warning,
+              `${task.callbackName} fell behind and attempted catch-up ticks, but catch-up was capped at ${maxTicks}.`,
+              ["chronoTrigger"]
+            );
+          }
+        }
+        const ticks = task.accumulatorMs / task.intervalMs | 0;
+        if (ticks <= 0) continue;
+        task.accumulatorMs -= ticks * task.intervalMs;
+        for (let t = 0; t < ticks; t++) {
+          task.callback(task.intervalMs);
+        }
+      }
+      rafId = requestAnimationFrame(frame);
+    };
+    rafId = requestAnimationFrame(frame);
+  };
+  const Stop = () => {
+    running = false;
+    lastFrameTime = 0;
+    if (rafId) {
+      cancelAnimationFrame(rafId);
+      rafId = 0;
+    }
+  };
+  const dispose = (id) => {
+    const index = taskIndexById.get(id);
+    if (index === void 0) return false;
+    const lastIndex = scheduledTasks.length - 1;
+    if (index !== lastIndex) {
+      const lastTask = scheduledTasks[lastIndex];
+      scheduledTasks[index] = lastTask;
+      taskIndexById.set(lastTask.id, index);
+    }
+    scheduledTasks.pop();
+    taskIndexById.delete(id);
+    return true;
+  };
+  const runAt = ({
+    name,
+    fpsTarget,
+    callback
+  }) => {
+    if (typeof callback !== "function") {
+      throw new Error("runAt requires a callback function.");
+    }
+    let intervalMs = 0;
+    if (fpsTarget !== void 0) {
+      if (!Number.isFinite(fpsTarget) || fpsTarget <= 0) {
+        throw new Error("fpsTarget must be a positive number when provided.");
+      }
+      intervalMs = 1e3 / fpsTarget;
+    }
+    const id = nextTaskId++;
+    const callbackName = name || callback.name || "anonymous";
+    const accumulatorMs = intervalMs > 0 ? intervalMs : 0;
+    scheduledTasks.push({
+      id,
+      callback,
+      callbackName,
+      intervalMs,
+      accumulatorMs,
+      lastCatchupWarningMs: -Infinity
+    });
+    taskIndexById.set(id, scheduledTasks.length - 1);
+    return id;
+  };
+  const CurrentFPS = () => fps;
+  const AverageFPS = () => Math.round(fpsHist.average());
+  return { Start, Stop, runAt, dispose, CurrentFPS, AverageFPS };
+}
+var Crono = createChronoTrigger();
+
+// src/random.ts
+function rng(low, high, decimals = null) {
+  const min = low < high ? low : high;
+  const max = low < high ? high : low;
+  const lowDecimals = (Math.abs(low).toString().split(".")[1] || "").length;
+  const highDecimals = (Math.abs(high).toString().split(".")[1] || "").length;
+  const derivedDecimals = Math.max(lowDecimals, highDecimals);
+  const precision = decimals !== null ? decimals : derivedDecimals;
+  const factor = 10 ** precision;
+  const randomValue = Math.random() * (max - min) + min;
+  return Math.round(randomValue * factor) / factor;
+}
+function clamp(value, low, high) {
+  return Math.max(low, Math.min(high, value));
+}
+function randomItem(collection) {
+  if (collection.length === 0) {
+    log(logLevels.error, "Cannot select a random item from an empty array.", ["randomItem"], collection);
+  }
+  return collection[Math.floor(rng(0, collection.length - 1))];
+}
+function getRndColor() {
+  const red = Math.round(Math.random() * 234 + 10);
+  const green = Math.round(Math.random() * 234 + 20);
+  const blue = Math.round(Math.random() * 234 + 20);
+  const color = "#" + red.toString(16) + green.toString(16) + blue.toString(16);
+  return color;
+}
+function getColorPair() {
+  const red = Math.round(Math.random() * 234 + 10);
+  const antiRed = Math.abs(red - 234) + 20;
+  const green = Math.round(Math.random() * 234 + 20);
+  const antiGreen = Math.abs(green - 234) + 20;
+  const blue = Math.round(Math.random() * 234 + 20);
+  const antiblue = Math.abs(blue - 234) + 20;
+  const color = "#" + red.toString(16) + green.toString(16) + blue.toString(16);
+  const antiColor = "#" + antiRed.toString(16) + antiGreen.toString(16) + antiblue.toString(16);
+  return { c1: color, c2: antiColor };
+}
+function colorFrmRange(c1, c2, percent) {
+  percent = percent / 100;
+  const c1R = parseInt(c1.slice(1, 3), 16);
+  const c1G = parseInt(c1.slice(3, 5), 16);
+  const c1B = parseInt(c1.slice(5, 7), 16);
+  const c2R = parseInt(c2.slice(1, 3), 16);
+  const c2G = parseInt(c2.slice(3, 5), 16);
+  const c2B = parseInt(c2.slice(5, 7), 16);
+  const rDif = c1R - c2R;
+  const gDif = c1G - c2G;
+  const bDif = c1B - c2B;
+  let red = Math.round(c1R - percent * rDif).toString(16);
+  let green = Math.round(c1G - percent * gDif).toString(16);
+  let blue = Math.round(c1B - percent * bDif).toString(16);
+  if (red.length < 2) {
+    red = "0" + red;
+  }
+  if (green.length < 2) {
+    green = "0" + green;
+  }
+  if (blue.length < 2) {
+    blue = "0" + blue;
+  }
+  const color = "#" + red + green + blue;
+  return color;
+}
+function getContrastingColor(hexColor) {
+  const normalizedHex = hexColor.replace(/^#/, "");
+  const r = parseInt(normalizedHex.slice(0, 2), 16);
+  const g = parseInt(normalizedHex.slice(2, 4), 16);
+  const b = parseInt(normalizedHex.slice(4, 6), 16);
+  const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+  return luminance > 0.5 ? "#000000" : "#FFFFFF";
+}
+export {
+  Crono,
+  blockKeywords,
+  clamp,
+  colorFrmRange,
+  createChillUpdater,
+  createChronoTrigger,
+  createRingBuffer,
+  currentLogLevel,
+  filterKeywords,
+  getColorPair,
+  getContrastingColor,
+  getRndColor,
+  log,
+  logLevels,
+  randomItem,
+  rng
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging.ts","../src/ringBuffer.ts","../src/chillUpdate.ts","../src/chronoTrigger.ts","../src/random.ts"],"sourcesContent":["export const logLevels = {\n    off: 0,\n    error: 1,\n    warning: 2,\n    debug: 3,\n};\n\n// Mutable object so any module can update the level at runtime.\n// Off by default so production builds are quiet; set to logLevels.debug to enable.\nexport const currentLogLevel = { value: logLevels.off };\n\n// filterKeywords: when non-empty, only messages tagged with one of these pass through.\n// blockKeywords: messages tagged with any of these are always suppressed.\nexport const filterKeywords: string[] = [];\nexport const blockKeywords: string[] = [\"getRandomWord\", \"applyCooldowns\", \"calculateBoundingBox\", \"rollingAverage\"];\n\nexport function log(\n    level: number = logLevels.debug,\n    message: string,\n    keywords: string[] = [],\n    ...data: unknown[]\n  ): void {\n      if (!Object.values(logLevels).includes(level)) {\n          console.error(`[LOG ERROR] Invalid log level: ${level}`);\n          return;\n      }\n\n      if (currentLogLevel.value < level) return;\n\n      if (blockKeywords.some(keyword => keywords.includes(keyword))) return;\n\n      if (filterKeywords.length > 0 && !filterKeywords.some(keyword => keywords.includes(keyword))) return;\n\n      // Deep copy prevents logged objects from mutating after the call.\n      const copiedData = data.map(item => {\n          try {\n              return JSON.parse(JSON.stringify(item));\n          } catch {\n              return item;\n          }\n      });\n\n      const method = level === logLevels.error ? \"error\"\n                   : level === logLevels.warning ? \"warn\"\n                   : \"log\";\n\n      const timestamp = new Date().toISOString();\n      const keywordInfo = keywords.length > 0 ? ` [Keywords: ${keywords.join(\", \")}]` : \"\";\n\n      console[method](`[${timestamp}] ${message}\\n${keywordInfo}\\n`, ...copiedData);\n  }\n","export interface RingBuffer {\n  push(value: number): void\n  average(): number\n  sum(): number\n  size(): number\n  capacity(): number\n  clear(): void\n}\n\nexport function createRingBuffer(capacity: number): RingBuffer {\n  if (capacity <= 0) {\n    throw new Error(\"RingBuffer capacity must be > 0\")\n  }\n\n  const buffer = new Float64Array(capacity)\n  let head = 0        // points to oldest value\n  let length = 0\n  let total = 0\n\n  return {\n    push(value: number) {\n      if (length < capacity) {\n        // still filling\n        buffer[(head + length) % capacity] = value\n        total += value\n        length++\n      } else {\n        // overwrite oldest\n        const old = buffer[head]\n        total -= old\n        buffer[head] = value\n        total += value\n        head = (head + 1) % capacity\n      }\n    },\n\n    average() {\n      return length === 0 ? 0 : total / length\n    },\n\n    sum() {\n      return total\n    },\n\n    size() {\n      return length\n    },\n\n    capacity() {\n      return capacity\n    },\n\n    clear() {\n      head = 0\n      length = 0\n      total = 0\n    }\n  }\n}\n","import { log, logLevels } from \"./logging\";\n\nexport type ChillUpdateFn<TValue> = (value: TValue) => void;\n\nexport type ChillUpdaterSetParams<TValue> = {\n  updateKey: string;\n  updateFunction: ChillUpdateFn<TValue>;\n  value: TValue;\n  minMS?: number;\n};\n\nexport type ChillUpdater = {\n  check: () => boolean;\n  setUpdate: <TValue>(params: ChillUpdaterSetParams<TValue>) => void;\n};\n\ntype UpdateRecord = {\n  updateFunction: ChillUpdateFn<unknown>;\n  value: unknown;\n  minMS: number;\n  lastSentAt: number;\n};\n\nfunction createChillUpdater(): ChillUpdater {\n  const records = new Map<string, UpdateRecord>();\n  const pendingKeys = new Set<string>();\n  const getNow = (): number => {\n    if (typeof performance !== \"undefined\" && typeof performance.now === \"function\") {\n      return performance.now();\n    }\n    return Date.now();\n  };\n\n  const check = (): boolean => {\n    if (records.size === 0 || pendingKeys.size === 0) return false;\n\n    const now = getNow();\n    let didSend = false;\n\n    for (const updateKey of pendingKeys) {\n      const record = records.get(updateKey);\n      if (record === undefined) {\n        pendingKeys.delete(updateKey);\n        continue;\n      }\n      if (record.lastSentAt !== 0 && now - record.lastSentAt < record.minMS) continue;\n\n      record.lastSentAt = now;\n      pendingKeys.delete(updateKey);\n      try {\n        record.updateFunction(record.value);\n      }\n      catch (e) {\n        log(logLevels.error, \"chillUpdater update failed\", [\"chillUpdate\"], updateKey, e);\n      }\n\n      didSend = true;\n    }\n\n    return didSend;\n  };\n\n  const setUpdate = <TValue>({\n    updateKey,\n    updateFunction,\n    value,\n    minMS = 0,\n  }: ChillUpdaterSetParams<TValue>): void => {\n    const safeMinMS = minMS > 0 ? minMS : 0;\n    const existing = records.get(updateKey);\n\n    if (existing !== undefined) {\n      existing.updateFunction = updateFunction as ChillUpdateFn<unknown>;\n      existing.value = value;\n      if (safeMinMS !== 0) existing.minMS = safeMinMS;\n      pendingKeys.add(updateKey);\n      return;\n    }\n\n    pendingKeys.add(updateKey);\n    records.set(updateKey, {\n      updateFunction: updateFunction as ChillUpdateFn<unknown>,\n      value,\n      minMS: safeMinMS,\n      lastSentAt: 0\n    });\n  };\n\n  return {\n    check,\n    setUpdate\n  };\n}\n\nexport { createChillUpdater };\n","// ChronoTrigger Library (CT) using Factory Functions with FPS Tracking\nimport { log, logLevels } from './logging';\nimport { createRingBuffer } from './ringBuffer';\n\ninterface ScheduledTask {\n    id: number;\n    callback: (deltaMs: number) => void;\n    callbackName: string;\n    intervalMs: number;\n    accumulatorMs: number;\n    lastCatchupWarningMs: number;\n}\n\nexport interface ChronoTrigger {\n    Start: () => void;\n    Stop: () => void;\n    runAt: (options: { name?: string; callback: (deltaMs: number) => void; fpsTarget?: number }) => number;\n    dispose: (id: number) => boolean;\n    CurrentFPS: () => number;\n    AverageFPS: () => number;\n}\n\nexport function createChronoTrigger(): ChronoTrigger {\n    const scheduledTasks: ScheduledTask[] = [];\n    const taskIndexById = new Map<number, number>();\n    let nextTaskId = 1;\n    const maxTicks = 5;\n    const catchupWarningThrottleMs = 5000;\n    let running = false;\n    let rafId = 0;\n    let fps = 0; // Tracks the current running FPS\n    const fpsHist = createRingBuffer(100);\n    let lastFrameTime = 0;\n\n    const Start = (): void => {\n        if (running) return;\n        running = true;\n        const frame = (time: number): void => {\n            if (!running) return;\n\n            let delta = 0;\n            if (lastFrameTime > 0) {\n                delta = time - lastFrameTime;\n                if (delta > 0) {\n                    // using Math.max to avoid divide by 0\n                    const newFps = Math.round(1000 / Math.max(delta, 1));\n                    fps = newFps !== 1000 ? newFps : fps;\n                    fpsHist.push(fps);\n                }\n            }\n            lastFrameTime = time;\n\n            for (let i = 0; i < scheduledTasks.length; i++) {\n                const task = scheduledTasks[i];\n                if (task.intervalMs <= 0) {\n                    task.callback(delta);\n                    continue;\n                }\n\n                task.accumulatorMs += delta;\n                if (task.accumulatorMs > task.intervalMs * maxTicks) {\n                    task.accumulatorMs = task.intervalMs * maxTicks;\n                    if (time - task.lastCatchupWarningMs >= catchupWarningThrottleMs) {\n                        task.lastCatchupWarningMs = time;\n                        log(\n                            logLevels.warning,\n                            `${task.callbackName} fell behind and attempted catch-up ticks, but catch-up was capped at ${maxTicks}.`,\n                            [\"chronoTrigger\"],\n                        );\n                    }\n                }\n\n                const ticks = (task.accumulatorMs / task.intervalMs) | 0;\n                if (ticks <= 0) continue;\n\n                task.accumulatorMs -= ticks * task.intervalMs;\n                for (let t = 0; t < ticks; t++) {\n                    task.callback(task.intervalMs);\n                }\n            }\n\n            rafId = requestAnimationFrame(frame);\n        };\n        rafId = requestAnimationFrame(frame);\n    };\n\n    const Stop = (): void => {\n        running = false;\n        lastFrameTime = 0;\n        if (rafId) {\n            cancelAnimationFrame(rafId);\n            rafId = 0;\n        }\n    };\n\n    const dispose = (id: number): boolean => {\n        const index = taskIndexById.get(id);\n        if (index === undefined) return false;\n\n        const lastIndex = scheduledTasks.length - 1;\n        if (index !== lastIndex) {\n            const lastTask = scheduledTasks[lastIndex];\n            scheduledTasks[index] = lastTask;\n            taskIndexById.set(lastTask.id, index);\n        }\n\n        scheduledTasks.pop();\n        taskIndexById.delete(id);\n        return true;\n    };\n\n    const runAt = ({\n        name,\n        fpsTarget,\n        callback,\n    }: {\n        name?: string;\n        callback: (deltaMs: number) => void;\n        fpsTarget?: number;\n    }): number => {\n        if (typeof callback !== \"function\") {\n            throw new Error(\"runAt requires a callback function.\");\n        }\n\n        let intervalMs = 0;\n        if (fpsTarget !== undefined) {\n            if (!Number.isFinite(fpsTarget) || fpsTarget <= 0) {\n                throw new Error(\"fpsTarget must be a positive number when provided.\");\n            }\n\n            intervalMs = 1000 / fpsTarget;\n        }\n\n        const id = nextTaskId++;\n        const callbackName = name || callback.name || \"anonymous\";\n        const accumulatorMs = intervalMs > 0 ? intervalMs : 0;\n        scheduledTasks.push({\n            id,\n            callback,\n            callbackName,\n            intervalMs,\n            accumulatorMs,\n            lastCatchupWarningMs: -Infinity,\n        });\n        taskIndexById.set(id, scheduledTasks.length - 1);\n        return id;\n    };\n\n    const CurrentFPS = (): number => fps;\n    const AverageFPS = (): number => Math.round(fpsHist.average());\n\n    return { Start, Stop, runAt, dispose, CurrentFPS, AverageFPS };\n}\n\nexport const Crono = createChronoTrigger();\n","import { log, logLevels } from \"./logging\";\n\n/**\n * Generates a random number within the specified range, supporting precision.\n *\n * - If `decimals` is provided, the result is rounded to that many decimal places.\n * - If `decimals` is not provided, the precision is derived from the decimal places of the `low` and `high` inputs.\n *\n * @param {number} low - The minimum value (inclusive) of the range.\n * @param {number} high - The maximum value (exclusive) of the range.\n * @param {number | null} [decimals=null] - The number of decimal places to round to. If not provided, precision is derived automatically.\n * @returns {number} - A random number between `low` and `high`, rounded to the specified or derived precision.\n *\n * @example\n * // Example 1: Whole number output\n * rng(1, 10); // Could return 7\n *\n * @example\n * // Example 2: Fixed decimal places\n * rng(1.5, 3.5, 2); // Could return 2.78\n *\n * @example\n * // Example 3: Automatically derived precision\n * rng(0.001, 0.1); // Could return 0.023 (3 decimal places derived)\n */\n\nexport function rng(low: number, high: number, decimals: number | null = null): number {\n    const min = low < high ? low : high;\n    const max = low < high ? high : low;\n    const lowDecimals = (Math.abs(low).toString().split(\".\")[1] || \"\").length;\n    const highDecimals = (Math.abs(high).toString().split(\".\")[1] || \"\").length;\n    const derivedDecimals = Math.max(lowDecimals, highDecimals); // Derive max precision\n    const precision = decimals !== null ? decimals : derivedDecimals;\n    const factor = 10 ** precision;\n\n    const randomValue = Math.random() * (max - min) + min;\n\n    return Math.round(randomValue * factor) / factor;\n}\n\nexport function clamp(value: number, low: number, high: number) {\n    return Math.max(low, Math.min(high, value));\n}\n\n/**\n * Selects a random item from an array of a specific type.\n *\n * Utilizes the `rng` function to generate a random index within the bounds of the array.\n *\n * @template T - The type of elements in the array.\n * @param {T[]} collection - The array to select a random item from.\n * @returns {T} - A randomly selected item from the array.\n *\n * @throws {Error} Throws an error if the collection is empty.\n *\n * @example\n * // Example 1: Random item from a number array\n * const numbers = [1, 2, 3, 4, 5];\n * const randomNum = randomItem(numbers); // TypeScript infers: number\n *\n * @example\n * // Example 2: Random item from a string array\n * const fruits = [\"apple\", \"banana\", \"cherry\"];\n * const randomFruit = randomItem(fruits); // TypeScript infers: string\n */\nexport function randomItem<T>(collection: T[]): T {\n    if (collection.length === 0) {\n        log(logLevels.error, \"Cannot select a random item from an empty array.\", ['randomItem'], collection);\n    }\n    return collection[Math.floor(rng(0, collection.length-1))];\n}\n\nexport function getRndColor(){\n\n    const red = Math.round(Math.random() * (234)+10);\n\tconst green= Math.round(Math.random() * (234)+20);\n\tconst blue= Math.round(Math.random() * (234)+20);\n\n\tconst color =\"#\"+red.toString(16)+green.toString(16)+blue.toString(16);\n\n\treturn color;\n}\n\nexport function getColorPair() {\n\n    const red = Math.round(Math.random() * (234) + 10);\n    const antiRed = Math.abs(red - 234) + 20;\n    const green = Math.round(Math.random() * (234) + 20);\n    const antiGreen = Math.abs(green - 234) + 20;\n    const blue = Math.round(Math.random() * (234) + 20);\n    const antiblue = Math.abs(blue - 234) + 20;\n\n    const color = \"#\" + red.toString(16) + green.toString(16) + blue.toString(16);\n    const antiColor = \"#\" + antiRed.toString(16) + antiGreen.toString(16) + antiblue.toString(16);\n\n    return { c1: color, c2: antiColor };\n  }\n\n  export function colorFrmRange(c1: string, c2: string, percent: number) {\n    percent = percent / 100;\n\n    const c1R = parseInt(c1.slice(1, 3), 16);\n    const c1G = parseInt(c1.slice(3, 5), 16);\n    const c1B = parseInt(c1.slice(5, 7), 16);\n\n    const c2R = parseInt(c2.slice(1, 3), 16);\n    const c2G = parseInt(c2.slice(3, 5), 16);\n    const c2B = parseInt(c2.slice(5, 7), 16);\n\n    const rDif = c1R - c2R;\n    const gDif = c1G - c2G;\n    const bDif = c1B - c2B;\n\n    let red = Math.round(c1R - percent * rDif).toString(16);\n    let green = Math.round(c1G - percent * gDif).toString(16);\n    let blue = Math.round(c1B - percent * bDif).toString(16);\n\n    if (red.length < 2) { red = \"0\" + red; }\n    if (green.length < 2) { green = \"0\" + green; }\n    if (blue.length < 2) { blue = \"0\" + blue; }\n\n    const color = \"#\" + red + green + blue;\n\n    return color;\n  }\n\n  /**\n * Determines whether a hex color is light or dark and returns a contrasting color (black or white).\n * @param hexColor - The hex color string (e.g., \"#FFFFFF\" or \"FFFFFF\").\n * @returns A string representing the contrasting color (\"#000000\" for black or \"#FFFFFF\" for white).\n */\nexport function getContrastingColor(hexColor: string): string {\n    // Remove the '#' if present\n    const normalizedHex = hexColor.replace(/^#/, \"\");\n\n    // Parse the RGB values\n    const r = parseInt(normalizedHex.slice(0, 2), 16);\n    const g = parseInt(normalizedHex.slice(2, 4), 16);\n    const b = parseInt(normalizedHex.slice(4, 6), 16);\n\n    // Calculate the relative luminance (standard formula)\n    const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;\n\n    // Return black for light backgrounds, white for dark backgrounds\n    return luminance > 0.5 ? \"#000000\" : \"#FFFFFF\";\n  }\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@kikorin/util",
+  "version": "1.0.0",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsup": "^8",
+    "typescript": "^5",
+    "vitest": "^3.2.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}