qstd 0.2.11 → 0.2.13

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/file.d.ts

@@ -1,8 +1,15 @@
+import type { Readable } from "node:stream";
 /**
  * Read file contents as string
  * @param filePath
  * @param encoding
  * @returns
  */
-export declare const readFile: (filePath: string, encoding?: BufferEncoding) => string;
+export declare const readFile: (filePath: string, encoding?: BufferEncoding) => Promise<string>;
+/**
+ * Write a readable stream to a file
+ * @param filepath - Path to write the file to
+ * @param buffer - Readable stream to write
+ */
+export declare const writeBufferToFile: (filepath: string, buffer: Readable | undefined) => Promise<void>;
 //# sourceMappingURL=file.d.ts.map

package/dist/server/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/server/file.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GACnB,UAAU,MAAM,EAChB,WAAU,cAAwB,KACjC,MAEF,CAAC"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/server/file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GACnB,UAAU,MAAM,EAChB,WAAU,cAAwB,KACjC,OAAO,CAAC,MAAM,CAEhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,MAAM,EAChB,QAAQ,QAAQ,GAAG,SAAS,kBAO7B,CAAC"}

package/dist/server/index.cjs

@@ -3,10 +3,6 @@
 var dateFns = require('date-fns');
 var fs = require('fs');
 
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var fs__default = /*#__PURE__*/_interopDefault(fs);
-
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -552,11 +548,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,14 +572,43 @@ 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 = {};
 __export(file_exports, {
-  readFile: () => readFile
+  readFile: () => readFile,
+  writeBufferToFile: () => writeBufferToFile
 });
-var readFile = (filePath, encoding = "utf-8") => {
-  return fs__default.default.readFileSync(filePath, encoding);
+var readFile = async (filePath, encoding = "utf-8") => {
+  return fs.promises.readFile(filePath, encoding);
+};
+var writeBufferToFile = async (filepath, buffer) => {
+  const chunks = [];
+  for await (const chunk2 of buffer) {
+    chunks.push(chunk2);
+  }
+  await fs.promises.writeFile(filepath, Buffer.concat(chunks));
 };
 
 exports.Dict = dict_exports;

package/dist/server/index.js

@@ -1,5 +1,5 @@
 import { format, formatDistanceToNow, formatISO, isSameYear, isSameMonth, isSameDay, addSeconds, addMinutes, addHours, addDays, addWeeks, addBusinessDays, addMonths, addYears } from 'date-fns';
-import fs from 'fs';
+import { promises } from 'fs';
 
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
@@ -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,14 +570,43 @@ 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 = {};
 __export(file_exports, {
-  readFile: () => readFile
+  readFile: () => readFile,
+  writeBufferToFile: () => writeBufferToFile
 });
-var readFile = (filePath, encoding = "utf-8") => {
-  return fs.readFileSync(filePath, encoding);
+var readFile = async (filePath, encoding = "utf-8") => {
+  return promises.readFile(filePath, encoding);
+};
+var writeBufferToFile = async (filepath, buffer) => {
+  const chunks = [];
+  for await (const chunk2 of buffer) {
+    chunks.push(chunk2);
+  }
+  await promises.writeFile(filepath, Buffer.concat(chunks));
 };
 
 export { dict_exports as Dict, file_exports as File, flow_exports as Flow, int_exports as Int, list_exports as List, log_exports as Log, money_exports as Money, random_exports as Random, str_exports as Str, time_exports as Time };

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,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qstd",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "Standard Block component and utilities library with Panda CSS",
   "author": "malin1",
   "license": "MIT",
@@ -41,6 +41,24 @@
   "sideEffects": [
     "dist/react/index.css"
   ],
+  "scripts": {
+    "build": "panda codegen && panda cssgen && tsup && tsc -p tsconfig.build.json && node scripts/inject-css-import.js",
+    "build:js": "tsup",
+    "build:types": "tsc -p tsconfig.build.json",
+    "dev": "tsup --watch",
+    "prepublishOnly": "pnpm build",
+    "prepare:local": "pnpm build && cd playground && pnpm prepare",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:all": "pnpx tsx tests/test-all.ts",
+    "test:block": "node tests/test-block.tsx",
+    "test:playground": "node tests/playground-e2e.mjs",
+    "typecheck": "tsc --noEmit",
+    "typecheck:perf": "tsc --noEmit --extendedDiagnostics",
+    "typecheck:trace": "tsc --noEmit --generateTrace ./performance/ts-trace",
+    "analyze:tsserver": "bash performance/analyze-tsserver.sh",
+    "lint": "eslint ."
+  },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
@@ -96,22 +114,5 @@
   "bugs": {
     "url": "https://github.com/55cancri/qstd/issues"
   },
-  "homepage": "https://github.com/55cancri/qstd#readme",
-  "scripts": {
-    "build": "panda codegen && panda cssgen && tsup && tsc -p tsconfig.build.json && node scripts/inject-css-import.js",
-    "build:js": "tsup",
-    "build:types": "tsc -p tsconfig.build.json",
-    "dev": "tsup --watch",
-    "prepare:local": "pnpm build && cd playground && pnpm prepare",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:all": "pnpx tsx tests/test-all.ts",
-    "test:block": "node tests/test-block.tsx",
-    "test:playground": "node tests/playground-e2e.mjs",
-    "typecheck": "tsc --noEmit",
-    "typecheck:perf": "tsc --noEmit --extendedDiagnostics",
-    "typecheck:trace": "tsc --noEmit --generateTrace ./performance/ts-trace",
-    "analyze:tsserver": "bash performance/analyze-tsserver.sh",
-    "lint": "eslint ."
-  }
-}
+  "homepage": "https://github.com/55cancri/qstd#readme"
+}