qstd 0.2.11 → 0.2.12

package/dist/client/index.cjs

@@ -547,11 +547,18 @@ var hexColor = () => {
 var log_exports = {};
 __export(log_exports, {
   error: () => error,
+  header: () => header,
   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));
 };
@@ -564,6 +571,27 @@ var warn = (...values) => {
 var error = (...values) => {
   console.log("[error]", ...values.map(stringify));
 };
+var header = (message) => {
+  console.log(`========== ${message} ==========`);
+};
+var label = (name) => ({
+  /** Logs values with [label] prefix. Output: `[label] "value"` */
+  info: (...values) => {
+    console.log(`[${name}]`, ...values.map(stringify));
+  },
+  /** Logs values with [label] [warn] prefix. Output: `[label] [warn] "value"` */
+  warn: (...values) => {
+    console.log(`[${name}]`, "[warn]", ...values.map(stringify));
+  },
+  /** Logs values with [label] [error] prefix. Output: `[label] [error] "value"` */
+  error: (...values) => {
+    console.log(`[${name}]`, "[error]", ...values.map(stringify));
+  },
+  /** Logs a header message with [label] prefix. Output: `[label] ========== MESSAGE ==========` */
+  header: (message) => {
+    console.log(`[${name}] ========== ${message} ==========`);
+  }
+});
 
 // src/client/dom.ts
 var dom_exports = {};

package/dist/client/index.js

@@ -545,11 +545,18 @@ var hexColor = () => {
 var log_exports = {};
 __export(log_exports, {
   error: () => error,
+  header: () => header,
   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));
 };
@@ -562,6 +569,27 @@ var warn = (...values) => {
 var error = (...values) => {
   console.log("[error]", ...values.map(stringify));
 };
+var header = (message) => {
+  console.log(`========== ${message} ==========`);
+};
+var label = (name) => ({
+  /** Logs values with [label] prefix. Output: `[label] "value"` */
+  info: (...values) => {
+    console.log(`[${name}]`, ...values.map(stringify));
+  },
+  /** Logs values with [label] [warn] prefix. Output: `[label] [warn] "value"` */
+  warn: (...values) => {
+    console.log(`[${name}]`, "[warn]", ...values.map(stringify));
+  },
+  /** Logs values with [label] [error] prefix. Output: `[label] [error] "value"` */
+  error: (...values) => {
+    console.log(`[${name}]`, "[error]", ...values.map(stringify));
+  },
+  /** Logs a header message with [label] prefix. Output: `[label] ========== MESSAGE ==========` */
+  header: (message) => {
+    console.log(`[${name}] ========== ${message} ==========`);
+  }
+});
 
 // src/client/dom.ts
 var dom_exports = {};

package/dist/server/index.cjs

@@ -552,11 +552,18 @@ var hexColor = () => {
 var log_exports = {};
 __export(log_exports, {
   error: () => error,
+  header: () => header,
   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));
 };
@@ -569,6 +576,27 @@ var warn = (...values) => {
 var error = (...values) => {
   console.log("[error]", ...values.map(stringify));
 };
+var header = (message) => {
+  console.log(`========== ${message} ==========`);
+};
+var label = (name) => ({
+  /** Logs values with [label] prefix. Output: `[label] "value"` */
+  info: (...values) => {
+    console.log(`[${name}]`, ...values.map(stringify));
+  },
+  /** Logs values with [label] [warn] prefix. Output: `[label] [warn] "value"` */
+  warn: (...values) => {
+    console.log(`[${name}]`, "[warn]", ...values.map(stringify));
+  },
+  /** Logs values with [label] [error] prefix. Output: `[label] [error] "value"` */
+  error: (...values) => {
+    console.log(`[${name}]`, "[error]", ...values.map(stringify));
+  },
+  /** Logs a header message with [label] prefix. Output: `[label] ========== MESSAGE ==========` */
+  header: (message) => {
+    console.log(`[${name}] ========== ${message} ==========`);
+  }
+});
 
 // src/server/file.ts
 var file_exports = {};

package/dist/server/index.js

@@ -546,11 +546,18 @@ var hexColor = () => {
 var log_exports = {};
 __export(log_exports, {
   error: () => error,
+  header: () => header,
   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));
 };
@@ -563,6 +570,27 @@ var warn = (...values) => {
 var error = (...values) => {
   console.log("[error]", ...values.map(stringify));
 };
+var header = (message) => {
+  console.log(`========== ${message} ==========`);
+};
+var label = (name) => ({
+  /** Logs values with [label] prefix. Output: `[label] "value"` */
+  info: (...values) => {
+    console.log(`[${name}]`, ...values.map(stringify));
+  },
+  /** Logs values with [label] [warn] prefix. Output: `[label] [warn] "value"` */
+  warn: (...values) => {
+    console.log(`[${name}]`, "[warn]", ...values.map(stringify));
+  },
+  /** Logs values with [label] [error] prefix. Output: `[label] [error] "value"` */
+  error: (...values) => {
+    console.log(`[${name}]`, "[error]", ...values.map(stringify));
+  },
+  /** Logs a header message with [label] prefix. Output: `[label] ========== MESSAGE ==========` */
+  header: (message) => {
+    console.log(`[${name}] ========== ${message} ==========`);
+  }
+});
 
 // src/server/file.ts
 var file_exports = {};

package/dist/shared/log.d.ts

@@ -1,5 +1,98 @@
+/**
+ * Usage Examples:
+ *
+ * ```typescript // Basic logging
+ * Log.info("stuff");              // [info] "stuff"
+ * Log.warn("uh oh");              // [warn] "uh oh"
+ * Log.error("bad");               // [error] "bad"
+ *
+ * // Standalone header
+ * Log.header("STARTING");         // ========== STARTING ==========
+ *
+ * // Scoped logger
+ * const log = Log.label("audio-processor");
+ * log.info("something");          // [audio-processor] "something"
+ * log.warn("hmm");                // [audio-processor] [warn] "hmm"
+ * log.error("failed");            // [audio-processor] [error] "failed"
+ * 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)
+ * @example
+ * ```typescript
+ * log("hello"); // "hello"
+ * ```
+ */
 export declare const log: (...values: unknown[]) => void;
+/**
+ * Logs values with [info] prefix.
+ * @param values - Values to log (will be JSON stringified)
+ * @example
+ * ```typescript
+ * info("stuff"); // [info] "stuff"
+ * ```
+ */
 export declare const info: (...values: unknown[]) => void;
+/**
+ * Logs values with [warn] prefix.
+ * @param values - Values to log (will be JSON stringified)
+ * @example
+ * ```typescript
+ * warn("uh oh"); // [warn] "uh oh"
+ * ```
+ */
 export declare const warn: (...values: unknown[]) => void;
+/**
+ * Logs values with [error] prefix.
+ * @param values - Values to log (will be JSON stringified)
+ * @example
+ * ```typescript
+ * error("bad"); // [error] "bad"
+ * ```
+ */
 export declare const error: (...values: unknown[]) => void;
+/**
+ * Logs a message wrapped in header decoration.
+ * @param message - The header message
+ * @example
+ * ```typescript
+ * header("STARTING"); // ========== STARTING ==========
+ * ```
+ */
+export declare const header: (message: string) => void;
+/**
+ * Creates a scoped logger with a label prefix.
+ * @param name - The label to prefix all log messages with
+ * @returns A logger object with info, warn, error, and header methods
+ * @example
+ * ```typescript
+ * const log = label("audio-processor");
+ * log.info("something");        // [audio-processor] "something"
+ * log.warn("hmm");              // [audio-processor] [warn] "hmm"
+ * log.error("failed");          // [audio-processor] [error] "failed"
+ * log.header("HANDLER START");  // [audio-processor] ========== HANDLER START ==========
+ * ```
+ */
+export declare const label: (name: string) => {
+    /** Logs values with [label] prefix. Output: `[label] "value"` */
+    info: (...values: unknown[]) => void;
+    /** Logs values with [label] [warn] prefix. Output: `[label] [warn] "value"` */
+    warn: (...values: unknown[]) => void;
+    /** Logs values with [label] [error] prefix. Output: `[label] [error] "value"` */
+    error: (...values: unknown[]) => void;
+    /** Logs a header message with [label] prefix. Output: `[label] ========== MESSAGE ==========` */
+    header: (message: string) => void;
+};
 //# sourceMappingURL=log.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/shared/log.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,GAAI,GAAG,QAAQ,OAAO,EAAE,SAEvC,CAAC;AAEF,eAAO,MAAM,IAAI,GAAI,GAAG,QAAQ,OAAO,EAAE,SAExC,CAAC;AAEF,eAAO,MAAM,IAAI,GAAI,GAAG,QAAQ,OAAO,EAAE,SAExC,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,GAAG,QAAQ,OAAO,EAAE,SAEzC,CAAC"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/shared/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,oBAGtB,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"}

package/package.json

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