qstd 0.2.10 → 0.2.12

package/dist/shared/str.d.ts

@@ -0,0 +1,74 @@
+type ParseJsonResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: Error;
+};
+/**
+ * Parse a JSON string into an object
+ * - Safe by default: returns { ok, data/error }
+ * - Strict mode: throws on error, returns data directly
+ * - If input is already an object, returns it as-is
+ * - If input is null/undefined/empty string, returns error (or throws if strict)
+ * - Optional generic for typed output (no runtime validation)
+ *
+ * @example
+ * // Safe mode (default)
+ * const result = parseJson(event.body);
+ * if (result.ok) console.log(result.data);
+ *
+ * @example
+ * // Safe mode with type
+ * const result = parseJson<{ name: string }>(event.body);
+ * if (result.ok) console.log(result.data.name);
+ *
+ * @example
+ * // Strict mode - throws on error
+ * const data = parseJson<MyType>(event.body, { strict: true });
+ */
+export declare function parseJson<T = Record<string, unknown>>(input: string | object | null | undefined, opts: {
+    strict: true;
+}): T;
+export declare function parseJson<T = Record<string, unknown>>(input: string | object | null | undefined, opts?: {
+    strict?: false;
+}): ParseJsonResult<T>;
+type CaseOpts = {
+    to: "title" | "snake" | "kebab";
+    clean?: boolean;
+};
+/**
+ * Split text into sentences
+ * @param text
+ * @returns
+ */
+export declare const createSentences: (text?: string) => string[];
+/**
+ * Count words in text
+ * @param text
+ * @returns
+ */
+export declare const countWords: (text: string) => number;
+/**
+ * Concatenate strings with optional delimiter
+ * @param xs
+ * @param delimiter
+ * @returns
+ */
+export declare const concat: (xs: (string | undefined)[], delimiter?: string) => string;
+/**
+ * The number of times a character appears in a string
+ * @param str
+ * @param ch
+ * @returns
+ */
+export declare const countChar: (str: string, ch: string) => number;
+/**
+ * Convert a str to specific casing
+ * @param text
+ * @param opts
+ * @returns
+ */
+export declare const changeCase: <T extends string>(text: string, opts: CaseOpts) => string;
+export {};
+//# sourceMappingURL=str.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"str.d.ts","sourceRoot":"","sources":["../../src/shared/str.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,IAAI,EAAE;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GACrB,CAAC,CAAC;AACL,wBAAgB,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GACxB,eAAe,CAAC,CAAC,CAAC,CAAC;AAwCtB,KAAK,QAAQ,GAAG;IACd,EAAE,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,aAG5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,WAStC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,EAAE,YAAY,MAAM,WAEpE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,IAAI,MAAM,WAEhD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,EAAE,MAAM,MAAM,EAAE,MAAM,QAAQ,WAmBxE,CAAC"}

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.10",
+  "version": "0.2.12",
   "description": "Standard Block component and utilities library with Panda CSS",
   "author": "malin1",
   "license": "MIT",
@@ -98,7 +98,9 @@
   },
   "homepage": "https://github.com/55cancri/qstd#readme",
   "scripts": {
-    "build": "panda codegen && panda cssgen && tsup && node scripts/inject-css-import.js",
+    "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",

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-DlaF8tUZ.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 };