qstd 0.2.8 → 0.2.10

package/dist/client/index.cjs

@@ -133,8 +133,35 @@ __export(str_exports, {
   concat: () => concat,
   countChar: () => countChar,
   countWords: () => countWords,
-  createSentences: () => createSentences
+  createSentences: () => createSentences,
+  parseJson: () => parseJson
 });
+function parseJson(input, opts) {
+  const strict = opts?.strict ?? false;
+  if (input === null || input === void 0) {
+    const error2 = new Error("[parseJson] input is null or undefined");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+  if (input === "") {
+    const error2 = new Error("[parseJson] input is empty string");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+  if (typeof input === "object") {
+    if (strict) return input;
+    return { ok: true, data: input };
+  }
+  try {
+    const data = JSON.parse(input);
+    if (strict) return data;
+    return { ok: true, data };
+  } catch (e) {
+    const error2 = e instanceof Error ? e : new Error("[parseJson] failed to parse JSON");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+}
 var createSentences = (text) => {
   if (!text) return [];
   return text?.replace(/([.?!])\s*(?=[A-Z])/g, "$1|").split("|");

package/dist/client/index.d.cts

@@ -1,4 +1,4 @@
-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-TRYALTmf.cjs';
+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';
 
 /**

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-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-TRYALTmf.js';
+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.js';
 import 'date-fns';
 
 /**

package/dist/client/index.js

@@ -131,8 +131,35 @@ __export(str_exports, {
   concat: () => concat,
   countChar: () => countChar,
   countWords: () => countWords,
-  createSentences: () => createSentences
+  createSentences: () => createSentences,
+  parseJson: () => parseJson
 });
+function parseJson(input, opts) {
+  const strict = opts?.strict ?? false;
+  if (input === null || input === void 0) {
+    const error2 = new Error("[parseJson] input is null or undefined");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+  if (input === "") {
+    const error2 = new Error("[parseJson] input is empty string");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+  if (typeof input === "object") {
+    if (strict) return input;
+    return { ok: true, data: input };
+  }
+  try {
+    const data = JSON.parse(input);
+    if (strict) return data;
+    return { ok: true, data };
+  } catch (e) {
+    const error2 = e instanceof Error ? e : new Error("[parseJson] failed to parse JSON");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+}
 var createSentences = (text) => {
   if (!text) return [];
   return text?.replace(/([.?!])\s*(?=[A-Z])/g, "$1|").split("|");

package/dist/{log-TRYALTmf.d.cts → log-DlaF8tUZ.d.cts}

@@ -104,6 +104,41 @@ declare namespace dict {
   export { dict_byteSizeOfObj as byteSizeOfObj, dict_exists as exists, dict_filter as filter, dict_isEmpty as isEmpty, dict_omit as omit, dict_partition as partition, dict_pick as pick, dict_transform as transform };
 }
 
+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 });
+ */
+declare function parseJson<T = Record<string, unknown>>(input: string | object | null | undefined, opts: {
+    strict: true;
+}): T;
+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;
@@ -147,8 +182,9 @@ declare const str_concat: typeof concat;
 declare const str_countChar: typeof countChar;
 declare const str_countWords: typeof countWords;
 declare const str_createSentences: typeof createSentences;
+declare const str_parseJson: typeof parseJson;
 declare namespace str {
-  export { str_changeCase as changeCase, str_concat as concat, str_countChar as countChar, str_countWords as countWords, str_createSentences as createSentences };
+  export { str_changeCase as changeCase, str_concat as concat, str_countChar as countChar, str_countWords as countWords, str_createSentences as createSentences, str_parseJson as parseJson };
 }
 
 type Range = {
@@ -256,7 +292,7 @@ type DurationOptions = {
  * formatDuration(45300, { format: "fractional" }) // "45.3s"
  * formatDuration(64400, { format: "fractional" }) // "1m 4.4s"
  */
-declare const formatDuration: (ms: number | null, options?: DurationOptions) => string;
+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 = {

package/dist/{log-TRYALTmf.d.ts → log-DlaF8tUZ.d.ts}

@@ -104,6 +104,41 @@ declare namespace dict {
   export { dict_byteSizeOfObj as byteSizeOfObj, dict_exists as exists, dict_filter as filter, dict_isEmpty as isEmpty, dict_omit as omit, dict_partition as partition, dict_pick as pick, dict_transform as transform };
 }
 
+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 });
+ */
+declare function parseJson<T = Record<string, unknown>>(input: string | object | null | undefined, opts: {
+    strict: true;
+}): T;
+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;
@@ -147,8 +182,9 @@ declare const str_concat: typeof concat;
 declare const str_countChar: typeof countChar;
 declare const str_countWords: typeof countWords;
 declare const str_createSentences: typeof createSentences;
+declare const str_parseJson: typeof parseJson;
 declare namespace str {
-  export { str_changeCase as changeCase, str_concat as concat, str_countChar as countChar, str_countWords as countWords, str_createSentences as createSentences };
+  export { str_changeCase as changeCase, str_concat as concat, str_countChar as countChar, str_countWords as countWords, str_createSentences as createSentences, str_parseJson as parseJson };
 }
 
 type Range = {
@@ -256,7 +292,7 @@ type DurationOptions = {
  * formatDuration(45300, { format: "fractional" }) // "45.3s"
  * formatDuration(64400, { format: "fractional" }) // "1m 4.4s"
  */
-declare const formatDuration: (ms: number | null, options?: DurationOptions) => string;
+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 = {

package/dist/react/index.d.cts

@@ -20747,20 +20747,20 @@ type BlockquoteBlockProps = SharedBlockProps & HTMLProps<"blockquote"> & {
 type PreBlockProps = SharedBlockProps & HTMLProps<"pre"> & {
     is: "pre";
 };
-type FormBlockProps = SharedBlockProps & HTMLProps<"form"> & (({
+type FormBlockProps = SharedBlockProps & HTMLProps<"form"> & ({
     is: "form";
     as?: undefined;
-}) | ({
+} | ({
     is: "form";
     as: "label";
 } & HTMLProps<"label">) | ({
     is: "form";
     as: "legend";
 } & HTMLProps<"legend">));
-type TableBlockProps = SharedBlockProps & HTMLProps<"table"> & (({
+type TableBlockProps = SharedBlockProps & HTMLProps<"table"> & ({
     is: "table";
     as?: undefined;
-}) | ({
+} | ({
     is: "table";
     as: "tr";
 } & HTMLProps<"tr">) | ({

package/dist/react/index.d.ts

@@ -20747,20 +20747,20 @@ type BlockquoteBlockProps = SharedBlockProps & HTMLProps<"blockquote"> & {
 type PreBlockProps = SharedBlockProps & HTMLProps<"pre"> & {
     is: "pre";
 };
-type FormBlockProps = SharedBlockProps & HTMLProps<"form"> & (({
+type FormBlockProps = SharedBlockProps & HTMLProps<"form"> & ({
     is: "form";
     as?: undefined;
-}) | ({
+} | ({
     is: "form";
     as: "label";
 } & HTMLProps<"label">) | ({
     is: "form";
     as: "legend";
 } & HTMLProps<"legend">));
-type TableBlockProps = SharedBlockProps & HTMLProps<"table"> & (({
+type TableBlockProps = SharedBlockProps & HTMLProps<"table"> & ({
     is: "table";
     as?: undefined;
-}) | ({
+} | ({
     is: "table";
     as: "tr";
 } & HTMLProps<"tr">) | ({

package/dist/server/index.cjs

@@ -138,8 +138,35 @@ __export(str_exports, {
   concat: () => concat,
   countChar: () => countChar,
   countWords: () => countWords,
-  createSentences: () => createSentences
+  createSentences: () => createSentences,
+  parseJson: () => parseJson
 });
+function parseJson(input, opts) {
+  const strict = opts?.strict ?? false;
+  if (input === null || input === void 0) {
+    const error2 = new Error("[parseJson] input is null or undefined");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+  if (input === "") {
+    const error2 = new Error("[parseJson] input is empty string");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+  if (typeof input === "object") {
+    if (strict) return input;
+    return { ok: true, data: input };
+  }
+  try {
+    const data = JSON.parse(input);
+    if (strict) return data;
+    return { ok: true, data };
+  } catch (e) {
+    const error2 = e instanceof Error ? e : new Error("[parseJson] failed to parse JSON");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+}
 var createSentences = (text) => {
   if (!text) return [];
   return text?.replace(/([.?!])\s*(?=[A-Z])/g, "$1|").split("|");

package/dist/server/index.d.cts

@@ -1,4 +1,4 @@
-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-TRYALTmf.cjs';
+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';
 
 /**

package/dist/server/index.d.ts

@@ -1,4 +1,4 @@
-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-TRYALTmf.js';
+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.js';
 import 'date-fns';
 
 /**

package/dist/server/index.js

@@ -132,8 +132,35 @@ __export(str_exports, {
   concat: () => concat,
   countChar: () => countChar,
   countWords: () => countWords,
-  createSentences: () => createSentences
+  createSentences: () => createSentences,
+  parseJson: () => parseJson
 });
+function parseJson(input, opts) {
+  const strict = opts?.strict ?? false;
+  if (input === null || input === void 0) {
+    const error2 = new Error("[parseJson] input is null or undefined");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+  if (input === "") {
+    const error2 = new Error("[parseJson] input is empty string");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+  if (typeof input === "object") {
+    if (strict) return input;
+    return { ok: true, data: input };
+  }
+  try {
+    const data = JSON.parse(input);
+    if (strict) return data;
+    return { ok: true, data };
+  } catch (e) {
+    const error2 = e instanceof Error ? e : new Error("[parseJson] failed to parse JSON");
+    if (strict) throw error2;
+    return { ok: false, error: error2 };
+  }
+}
 var createSentences = (text) => {
   if (!text) return [];
   return text?.replace(/([.?!])\s*(?=[A-Z])/g, "$1|").split("|");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qstd",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "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,20 @@
   "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 && node scripts/inject-css-import.js",
+    "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 ."
+  }
+}