qstd 0.2.28 → 0.3.0

package/dist/client/index.cjs

@@ -260,6 +260,7 @@ __export(time_exports, {
   formatThreadDateRange: () => formatThreadDateRange,
   now: () => now,
   sleep: () => sleep,
+  startTimer: () => startTimer,
   toMs: () => toMs
 });
 var formatDuration = (ms, options = {}) => {
@@ -454,6 +455,27 @@ var toMs = (value, unit = "seconds") => {
   };
   return value * multipliers[unit];
 };
+function startTimer(options = {}) {
+  const start = Date.now();
+  const fmt = options.format ?? "ms";
+  const getElapsed = () => {
+    const elapsed = Date.now() - start;
+    if (fmt === "compact") {
+      const hours = Math.floor(elapsed / 36e5);
+      const minutes = Math.floor(elapsed % 36e5 / 6e4);
+      const seconds = Math.floor(elapsed % 6e4 / 1e3);
+      const milliseconds = elapsed % 1e3;
+      let result = "";
+      if (hours > 0) result += `${hours}h`;
+      if (minutes > 0) result += `${minutes}m`;
+      if (seconds > 0) result += `${seconds}s`;
+      if (milliseconds > 0 || result === "") result += `${milliseconds}ms`;
+      return result;
+    }
+    return elapsed;
+  };
+  return { stop: getElapsed, elapsed: getElapsed };
+}
 
 // src/shared/flow.ts
 var flow_exports = {};
@@ -551,14 +573,9 @@ __export(log_exports, {
   info: () => info,
   label: () => label,
   log: () => log,
-  startTimer: () => startTimer,
   warn: () => warn
 });
 var stringify = (value) => JSON.stringify(value, null, 2);
-var startTimer = () => {
-  const start = Date.now();
-  return () => Date.now() - start;
-};
 var log = (...values) => {
   console.log(...values.map(stringify));
 };

package/dist/client/index.js

@@ -258,6 +258,7 @@ __export(time_exports, {
   formatThreadDateRange: () => formatThreadDateRange,
   now: () => now,
   sleep: () => sleep,
+  startTimer: () => startTimer,
   toMs: () => toMs
 });
 var formatDuration = (ms, options = {}) => {
@@ -452,6 +453,27 @@ var toMs = (value, unit = "seconds") => {
   };
   return value * multipliers[unit];
 };
+function startTimer(options = {}) {
+  const start = Date.now();
+  const fmt = options.format ?? "ms";
+  const getElapsed = () => {
+    const elapsed = Date.now() - start;
+    if (fmt === "compact") {
+      const hours = Math.floor(elapsed / 36e5);
+      const minutes = Math.floor(elapsed % 36e5 / 6e4);
+      const seconds = Math.floor(elapsed % 6e4 / 1e3);
+      const milliseconds = elapsed % 1e3;
+      let result = "";
+      if (hours > 0) result += `${hours}h`;
+      if (minutes > 0) result += `${minutes}m`;
+      if (seconds > 0) result += `${seconds}s`;
+      if (milliseconds > 0 || result === "") result += `${milliseconds}ms`;
+      return result;
+    }
+    return elapsed;
+  };
+  return { stop: getElapsed, elapsed: getElapsed };
+}
 
 // src/shared/flow.ts
 var flow_exports = {};
@@ -549,14 +571,9 @@ __export(log_exports, {
   info: () => info,
   label: () => label,
   log: () => log,
-  startTimer: () => startTimer,
   warn: () => warn
 });
 var stringify = (value) => JSON.stringify(value, null, 2);
-var startTimer = () => {
-  const start = Date.now();
-  return () => Date.now() - start;
-};
 var log = (...values) => {
   console.log(...values.map(stringify));
 };

package/dist/server/index.cjs

@@ -263,6 +263,7 @@ __export(time_exports, {
   formatThreadDateRange: () => formatThreadDateRange,
   now: () => now,
   sleep: () => sleep,
+  startTimer: () => startTimer,
   toMs: () => toMs
 });
 var formatDuration = (ms, options = {}) => {
@@ -457,6 +458,27 @@ var toMs = (value, unit = "seconds") => {
   };
   return value * multipliers[unit];
 };
+function startTimer(options = {}) {
+  const start = Date.now();
+  const fmt = options.format ?? "ms";
+  const getElapsed = () => {
+    const elapsed = Date.now() - start;
+    if (fmt === "compact") {
+      const hours = Math.floor(elapsed / 36e5);
+      const minutes = Math.floor(elapsed % 36e5 / 6e4);
+      const seconds = Math.floor(elapsed % 6e4 / 1e3);
+      const milliseconds = elapsed % 1e3;
+      let result = "";
+      if (hours > 0) result += `${hours}h`;
+      if (minutes > 0) result += `${minutes}m`;
+      if (seconds > 0) result += `${seconds}s`;
+      if (milliseconds > 0 || result === "") result += `${milliseconds}ms`;
+      return result;
+    }
+    return elapsed;
+  };
+  return { stop: getElapsed, elapsed: getElapsed };
+}
 
 // src/shared/flow.ts
 var flow_exports = {};
@@ -554,14 +576,9 @@ __export(log_exports, {
   info: () => info,
   label: () => label,
   log: () => log,
-  startTimer: () => startTimer,
   warn: () => warn
 });
 var stringify = (value) => JSON.stringify(value, null, 2);
-var startTimer = () => {
-  const start = Date.now();
-  return () => Date.now() - start;
-};
 var log = (...values) => {
   console.log(...values.map(stringify));
 };

package/dist/server/index.js

@@ -261,6 +261,7 @@ __export(time_exports, {
   formatThreadDateRange: () => formatThreadDateRange,
   now: () => now,
   sleep: () => sleep,
+  startTimer: () => startTimer,
   toMs: () => toMs
 });
 var formatDuration = (ms, options = {}) => {
@@ -455,6 +456,27 @@ var toMs = (value, unit = "seconds") => {
   };
   return value * multipliers[unit];
 };
+function startTimer(options = {}) {
+  const start = Date.now();
+  const fmt = options.format ?? "ms";
+  const getElapsed = () => {
+    const elapsed = Date.now() - start;
+    if (fmt === "compact") {
+      const hours = Math.floor(elapsed / 36e5);
+      const minutes = Math.floor(elapsed % 36e5 / 6e4);
+      const seconds = Math.floor(elapsed % 6e4 / 1e3);
+      const milliseconds = elapsed % 1e3;
+      let result = "";
+      if (hours > 0) result += `${hours}h`;
+      if (minutes > 0) result += `${minutes}m`;
+      if (seconds > 0) result += `${seconds}s`;
+      if (milliseconds > 0 || result === "") result += `${milliseconds}ms`;
+      return result;
+    }
+    return elapsed;
+  };
+  return { stop: getElapsed, elapsed: getElapsed };
+}
 
 // src/shared/flow.ts
 var flow_exports = {};
@@ -552,14 +574,9 @@ __export(log_exports, {
   info: () => info,
   label: () => label,
   log: () => log,
-  startTimer: () => startTimer,
   warn: () => warn
 });
 var stringify = (value) => JSON.stringify(value, null, 2);
-var startTimer = () => {
-  const start = Date.now();
-  return () => Date.now() - start;
-};
 var log = (...values) => {
   console.log(...values.map(stringify));
 };

package/dist/shared/log.d.ts

@@ -17,16 +17,6 @@
  * log.header("HANDLER START");    // [audio-processor] ========== HANDLER START ==========
  *
  */
-/**
- * Starts a timer and returns a function that returns elapsed milliseconds.
- * @returns A function that returns the elapsed time in ms since the timer started
- * @example
- * ```typescript // Timer
- * const elapsed = Log.startTimer();
- * // ... do work ...
- * log.header(`COMPLETE (${elapsed()}ms)`);  // ========== COMPLETE (123ms) ==========```
- */
-export declare const startTimer: () => () => number;
 /**
  * Logs values to the console (no prefix).
  * @param values - Values to log (will be JSON stringified)

package/dist/shared/log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/shared/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,oBAWtB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,GAAI,GAAG,QAAQ,OAAO,EAAE,SAEvC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,GAAG,QAAQ,OAAO,EAAE,SAExC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,GAAG,QAAQ,OAAO,EAAE,SAExC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,QAAQ,OAAO,EAAE,SAEzC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,SAAS,MAAM,SAErC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM;IAChC,iEAAiE;sBAC/C,OAAO,EAAE;IAG3B,+EAA+E;sBAC7D,OAAO,EAAE;IAG3B,iFAAiF;uBAC9D,OAAO,EAAE;IAG5B,iGAAiG;sBAC/E,MAAM;CAGxB,CAAC"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/shared/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,GAAI,GAAG,QAAQ,OAAO,EAAE,SAEvC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,GAAG,QAAQ,OAAO,EAAE,SAExC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,GAAG,QAAQ,OAAO,EAAE,SAExC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,QAAQ,OAAO,EAAE,SAEzC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,SAAS,MAAM,SAErC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM;IAChC,iEAAiE;sBAC/C,OAAO,EAAE;IAG3B,+EAA+E;sBAC7D,OAAO,EAAE;IAG3B,iFAAiF;uBAC9D,OAAO,EAAE;IAG5B,iGAAiG;sBAC/E,MAAM;CAGxB,CAAC"}

package/dist/shared/time.d.ts

@@ -108,5 +108,41 @@ export declare const now: () => number;
  * const ms = toMs(5, "minutes") // Convert 5 minutes to milliseconds
  */
 export declare const toMs: (value: number, unit?: Exclude<TimeUnit, "businessDays">) => number;
+type TimerFormat = "ms" | "compact";
+type TimerOptions<T extends TimerFormat = "ms"> = {
+    format?: T;
+};
+type Timer<T extends TimerFormat> = {
+    /** Returns elapsed time since timer started. For "ms" format returns number, for "compact" returns string like "1m3s440ms" */
+    stop: () => T extends "compact" ? string : number;
+    /** Returns current elapsed time without stopping (same as stop, but semantically for intermediate checks) */
+    elapsed: () => T extends "compact" ? string : number;
+};
+/**
+ * Starts a timer and returns an object with stop/elapsed methods.
+ * @param options - Optional configuration. `format: "ms"` (default) returns numbers, `format: "compact"` returns strings like "1m3s440ms"
+ * @returns Timer object with stop() and elapsed() methods
+ *
+ * @example
+ * ```typescript
+ * // Default (returns milliseconds as number)
+ * const timer = Time.startTimer();
+ * // ... do work ...
+ * const ms = timer.stop(); // 1234
+ *
+ * // Compact format (returns string)
+ * const timer = Time.startTimer({ format: "compact" });
+ * // ... do work ...
+ * const formatted = timer.stop(); // "1s234ms"
+ *
+ * // Check elapsed time without "stopping"
+ * const timer = Time.startTimer();
+ * console.log(timer.elapsed()); // 500
+ * // ... more work ...
+ * console.log(timer.stop()); // 1234
+ * ```
+ */
+export declare function startTimer(): Timer<"ms">;
+export declare function startTimer<T extends TimerFormat>(options: TimerOptions<T>): Timer<T>;
 export {};
 //# sourceMappingURL=time.d.ts.map

package/dist/shared/time.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/shared/time.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMvC,KAAK,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;AAElE,KAAK,eAAe,GAAG;IACrB,kHAAkH;IAClH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,GACzB,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7B,UAAS,eAAoB,WA0F9B,CAAC;AAMF,KAAK,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC,KAAK,eAAe,GAChB,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,UAAU,GACV,MAAM,CAAC;AAEX,KAAK,WAAW,GAAG;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,EAAE,UAAS,WAAgB,WAgDrE,CAAC;AAMF,KAAK,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7C,KAAK,gBAAgB,GAAG;IACtB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAOF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,cAAc,EAC1B,UAAU,cAAc,EACxB,UAAS,gBAAqB,WAiF/B,CAAC;AAGF,eAAO,MAAM,qBAAqB,GAChC,YAAY,cAAc,EAC1B,UAAU,cAAc,EACxB,UAAS,gBAAqB,WACmB,CAAC;AAMpD,KAAK,QAAQ,GACT,SAAS,GACT,SAAS,GACT,OAAO,GACP,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,GACP,cAAc,CAAC;AAEnB,KAAK,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GACrB,YAAY,cAAc,EAC1B,WAAU,IAAiB,SAe5B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACI,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,GAAG,cAAmB,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,IAAI,GACf,OAAO,MAAM,EACb,OAAM,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAa,WAapD,CAAC"}
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/shared/time.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qstd",
-  "version": "0.2.28",
+  "version": "0.3.0",
   "description": "Standard Block component and utilities library with Panda CSS",
   "author": "malin1",
   "license": "MIT",