qstd 0.2.9 → 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-ERvLs2Dx.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-ERvLs2Dx.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-ERvLs2Dx.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 = {

package/dist/{log-ERvLs2Dx.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 = {

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-ERvLs2Dx.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-ERvLs2Dx.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.9",
+  "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 ."
+  }
+}