easyjs-time 0.1.0

package/README.md

@@ -0,0 +1,26 @@
+# easyjs-time
+
+Time plugin for EasyJS.
+
+## Install
+
+```bash
+npm i easyjs-time
+```
+
+## Use
+
+```js
+const easy = require("easyjs-empty");
+const time = require("easyjs-time");
+
+easy.use(time); // loads basic
+console.log(easy.time()); // seconds since epoch
+```
+
+To load the advanced set:
+
+```js
+easy.use(time.advanced);
+```
+Refer to the `easyjs-empty` Readme for more info.

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "easyjs-time",
+  "version": "0.1.0",
+  "description": "EasyJS time plugin (Python-style time helpers).",
+  "license": "ISC",
+  "type": "commonjs",
+  "main": "src/index.js",
+  "keywords": [
+    "easyjs",
+    "plugin",
+    "time",
+    "date",
+    "timer",
+    "sleep",
+    "javascript"
+  ]
+}

package/src/index.js

@@ -0,0 +1,95 @@
+// easyjs-time
+const createSets = () => {
+  // --- basic time functions (Python-style) ---
+  const basic = {
+    now: () => new Date(),
+    time: () => Date.now() / 1000,
+    sleep: (seconds) => new Promise(resolve => setTimeout(resolve, Number(seconds) * 1000)),
+    ctime: (seconds) => {
+      const ms = seconds == null ? Date.now() : Number(seconds) * 1000;
+      return new Date(ms).toString();
+    },
+    localtime: (seconds) => {
+      const ms = seconds == null ? Date.now() : Number(seconds) * 1000;
+      return new Date(ms);
+    },
+    gmtime: (seconds) => {
+      const ms = seconds == null ? Date.now() : Number(seconds) * 1000;
+      return new Date(ms);
+    }
+  };
+
+  // --- advanced time functions ---
+  const advanced = {
+    timeMs: () => Date.now(),
+    timeNs: () => (typeof process !== "undefined" && process.hrtime && process.hrtime.bigint)
+      ? process.hrtime.bigint()
+      : Math.floor(Date.now() * 1e6),
+    monotonic: () => (typeof performance !== "undefined" && performance.now)
+      ? performance.now()
+      : Date.now(),
+    perfCounter: () => (typeof performance !== "undefined" && performance.now)
+      ? performance.now()
+      : Date.now(),
+    perfCounterNs: () => (typeof process !== "undefined" && process.hrtime && process.hrtime.bigint)
+      ? process.hrtime.bigint()
+      : Math.floor(Date.now() * 1e6),
+    sleepMs: (ms) => new Promise(resolve => setTimeout(resolve, Number(ms))),
+    timer: () => {
+      const start = (typeof performance !== "undefined" && performance.now) ? performance.now() : Date.now();
+      return () => {
+        const now = (typeof performance !== "undefined" && performance.now) ? performance.now() : Date.now();
+        return now - start;
+      };
+    },
+    elapsed: (startMs) => Date.now() - Number(startMs),
+    format: (date, pattern = "YYYY-MM-DD HH:mm:ss") => {
+      const d = date instanceof Date ? date : new Date(date);
+      const pad = (n, w = 2) => String(n).padStart(w, "0");
+      return pattern
+        .replace(/YYYY/g, String(d.getFullYear()))
+        .replace(/MM/g, pad(d.getMonth() + 1))
+        .replace(/DD/g, pad(d.getDate()))
+        .replace(/HH/g, pad(d.getHours()))
+        .replace(/mm/g, pad(d.getMinutes()))
+        .replace(/ss/g, pad(d.getSeconds()));
+    },
+    strftime: (fmt, date = new Date()) => {
+      const d = date instanceof Date ? date : new Date(date);
+      const pad = (n, w = 2) => String(n).padStart(w, "0");
+      return String(fmt)
+        .replace(/%Y/g, String(d.getFullYear()))
+        .replace(/%m/g, pad(d.getMonth() + 1))
+        .replace(/%d/g, pad(d.getDate()))
+        .replace(/%H/g, pad(d.getHours()))
+        .replace(/%M/g, pad(d.getMinutes()))
+        .replace(/%S/g, pad(d.getSeconds()));
+    },
+    timezoneOffsetMinutes: (date = new Date()) => -date.getTimezoneOffset()
+  };
+
+  // --- helper to add functions with override warnings ---
+  const addFuncs = (target, funcs) => {
+    for (const [name, fn] of Object.entries(funcs)) {
+      if (target[name]) {
+        console.log(`-- WARNING - overwriting ${name} - WARNING --`);
+      }
+      target[name] = fn;
+    }
+  };
+
+  return { basic, advanced, addFuncs };
+};
+
+const time = (easy) => {
+  const { basic, addFuncs } = createSets();
+  addFuncs(easy, basic);
+};
+
+// advanced plugin (function) for easy.use(time.advanced)
+time.advanced = (easy) => {
+  const { basic, advanced, addFuncs } = createSets();
+  addFuncs(easy, { ...basic, ...advanced });
+};
+
+module.exports = time;