qstd 0.2.9 → 0.2.11

package/dist/shared/time.d.ts

@@ -0,0 +1,112 @@
+import type { Locale } from "date-fns";
+type DurationFormat = "compact" | "full" | "clock" | "fractional";
+type DurationOptions = {
+    /** Format style: 'compact' (1h 2m), 'full' (1 hour 2 minutes), 'clock' (01:02:03), 'fractional' (1.4s, 1m4.4s) */
+    format?: DurationFormat;
+    /** Show zero values for intermediate units (e.g., "1h 0m 30s" vs "1h 30s") */
+    showZero?: boolean;
+};
+/**
+ * Formats milliseconds into human-readable duration strings
+ * Supports compact (1h 2m), full (`1 hour 2 minutes`), clock (`01:02:03`), and fractional (1.4s, 1m4.4s) formats
+ *
+ * @param {Object} [options={}] - Configuration options
+ * @param {string} [options.format="clock"] - format
+ * @param {boolean} [options.showZero=false] - show zero prefix
+ *
+ * @example
+ * formatDuration(90000) // "1:30"
+ * formatDuration(3661000) // "1:01:01"
+ * formatDuration(90000, { format: "compact" }) // "1m 30s"
+ * formatDuration(90000, { format: "full" }) // "1 minute 30 seconds"
+ * formatDuration(3600000, { format: "compact" }) // "1h"
+ * formatDuration(3600000, { format: "compact", showZero: true }) // "1h 0m 0s"
+ * formatDuration(3660000, { format: "full", showZero: true }) // "1 hour 1 minute 0 seconds"
+ * formatDuration(1400, { format: "fractional" }) // "1.4s"
+ * formatDuration(45300, { format: "fractional" }) // "45.3s"
+ * formatDuration(64400, { format: "fractional" }) // "1m 4.4s"
+ */
+export declare const formatDuration: (ms: number | null | undefined, options?: DurationOptions) => string;
+type DateInput = Date | string | number;
+type DateFormatStyle = "iso" | "short" | "medium" | "long" | "relative" | "year";
+type DateOptions = {
+    /** Predefined format style */
+    style?: DateFormatStyle;
+    /** Custom date-fns format string (overrides style) */
+    pattern?: string;
+    /** Include time component */
+    includeTime?: boolean;
+};
+/**
+ * Flexible date formatter that handles multiple input types and format styles
+ * Supports ISO strings, timestamps, and Date objects with intelligent defaults
+ * @example
+ * // Date formatting with smart input handling
+ * formatDate(new Date()) // "Dec 1, 2023"
+ * formatDate("2023-12-01") // "Dec 1, 2023"
+ * formatDate(1701388800000) // "Dec 1, 2023"
+ * formatDate(date, { style: "short" }) // "12/1/23"
+ * formatDate(date, { style: "long" }) // "December 1, 2023"
+ * formatDate(date, { includeTime: true }) // "Dec 1, 2023 3:30 PM"
+ * formatDate(date, { pattern: "yyyy-MM-dd" }) // Custom format
+ */
+export declare const formatDate: (input: DateInput, options?: DateOptions) => string;
+type DateRangeInput = Date | string | number;
+type DateRangeOptions = {
+    /** Reference date for today checks (defaults to new Date()) */
+    now?: Date;
+    /** Show time segment when start and end are the same day (default: true) */
+    showTimeWhenSameDay?: boolean;
+    /** If true, appends (today) next to whichever date equals today (default: true) */
+    markToday?: boolean;
+    /** Custom label for today marker (default: "today") */
+    todayLabel?: string;
+    /** Separator between start and end segments (default: " - ") */
+    separator?: string;
+    /** Month text style (default: "short") */
+    monthFormat?: "short" | "long";
+    /** Lowercase am/pm in time output (default: true) */
+    lowercaseAmPm?: boolean;
+    /** Locale for date-fns formatter */
+    locale?: Locale;
+};
+/**
+ * Formats a date range according to thread rules:
+ * - Same day: "MMM d (today), h:mma - h:mma" (am/pm lowercase, hyphen between times)
+ * - Different day, same month/year: "MMM d - d (today), yyyy"
+ * - Different month, same year: "MMM d - MMM d (today), yyyy"
+ * - Different year: "MMM d, yyyy - MMM d, yyyy" (append (today) next to the correct day if applicable)
+ *
+ * Notes:
+ * - "(today)" is appended next to whichever date matches today.
+ * - Times are shown only when start and end are the same calendar day.
+ */
+export declare const formatDateRange: (startInput: DateRangeInput, endInput: DateRangeInput, options?: DateRangeOptions) => string;
+export declare const formatThreadDateRange: (startInput: DateRangeInput, endInput: DateRangeInput, options?: DateRangeOptions) => string;
+type TimeUnit = "seconds" | "minutes" | "hours" | "days" | "weeks" | "months" | "years" | "businessDays";
+type TimeAdjustment = Partial<Record<TimeUnit, number>>;
+/**
+ * Creates a new date by adding specified time units to a base date
+ * Defaults to current date if no base date provided
+ * @example
+ * // Date manipulation
+ * adjustDate({ hours: 2 }) // 2 hours from now
+ * adjustDate({ days: -7, hours: 3 }, someDate) // (7 days ago + 3 hours) from someDate
+ */
+export declare const adjustDate: (adjustment: TimeAdjustment, baseDate?: Date) => Date;
+/**
+ * Promise-based delay utility for async operations
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+/**
+ * Gets the current timestamp in milliseconds
+ */
+export declare const now: () => number;
+/**
+ * Converts various time units to milliseconds
+ * @example
+ * const ms = toMs(5, "minutes") // Convert 5 minutes to milliseconds
+ */
+export declare const toMs: (value: number, unit?: Exclude<TimeUnit, "businessDays">) => number;
+export {};
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qstd",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Standard Block component and utilities library with Panda CSS",
   "author": "malin1",
   "license": "MIT",
@@ -41,22 +41,6 @@
   "sideEffects": [
     "dist/react/index.css"
   ],
-  "scripts": {
-    "build": "panda codegen && panda cssgen && tsup && node scripts/inject-css-import.js",
-    "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"
@@ -112,5 +96,22 @@
   "bugs": {
     "url": "https://github.com/55cancri/qstd/issues"
   },
-  "homepage": "https://github.com/55cancri/qstd#readme"
-}
+  "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 ."
+  }
+}

package/dist/client/index.d.cts

@@ -1,75 +0,0 @@
-export { d as Dict, f as Flow, i as Int, l as List, a as Log, m as Money, r as Random, s as Str, t as Time } from '../log-ERvLs2Dx.cjs';
-import 'date-fns';
-
-/**
- * DOM manipulation utilities
- */
-/**
- * Get element by ID
- * @param id
- * @returns
- */
-declare const getElement: (id: string) => HTMLElement | null;
-/**
- * Query selector
- * @param selector
- * @returns
- */
-declare const querySelector: (selector: string) => Element | null;
-/**
- * Query selector all
- * @param selector
- * @returns
- */
-declare const querySelectorAll: (selector: string) => NodeListOf<Element>;
-/**
- * Scroll to top of page
- */
-declare const scrollToTop: () => void;
-/**
- * Scroll to coordinates
- * @param x
- * @param y
- */
-declare const scrollTo: (x: number, y: number) => void;
-/**
- * Get current scroll position
- * @returns
- */
-declare const getScrollPosition: () => {
-    x: number;
-    y: number;
-};
-/**
- * Check if element is in viewport
- * @param el
- * @returns
- */
-declare const isInViewport: (el: HTMLElement) => boolean;
-/**
- * Scroll element into view
- * @param el
- * @param options
- */
-declare const scrollIntoView: (el: HTMLElement, options?: ScrollIntoViewOptions) => void;
-/**
- * Copy text to clipboard
- * @param text
- * @returns
- */
-declare const copy: (text: string) => Promise<void>;
-
-declare const dom_copy: typeof copy;
-declare const dom_getElement: typeof getElement;
-declare const dom_getScrollPosition: typeof getScrollPosition;
-declare const dom_isInViewport: typeof isInViewport;
-declare const dom_querySelector: typeof querySelector;
-declare const dom_querySelectorAll: typeof querySelectorAll;
-declare const dom_scrollIntoView: typeof scrollIntoView;
-declare const dom_scrollTo: typeof scrollTo;
-declare const dom_scrollToTop: typeof scrollToTop;
-declare namespace dom {
-  export { dom_copy as copy, dom_getElement as getElement, dom_getScrollPosition as getScrollPosition, dom_isInViewport as isInViewport, dom_querySelector as querySelector, dom_querySelectorAll as querySelectorAll, dom_scrollIntoView as scrollIntoView, dom_scrollTo as scrollTo, dom_scrollToTop as scrollToTop };
-}
-
-export { dom as Dom };