/**
 * 安全地将 JSON 字符串解析为对象
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @param str - 需要解析的 JSON 字符串
 * @returns 解析后的对象；若解析失败则返回原始字符串；若输入为 undefined 则返回空对象
 * @remarks 该函数不会抛出异常，解析失败时会静默返回原始字符串。适用于不确定输入是否为合法 JSON 的场景。
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { parseJSON } = utils;
 *
 * parseJSON('{"a":1}');  // { a: 1 }
 * parseJSON('not json'); // 'not json'
 * parseJSON(undefined);  // {}
 * ```
 */
export declare const parseJSON: (str: string) => string | Record<string, never>;
/**
 * 将给定数据安全地序列化为 JSON 字符串
 * @public
 * @since @ray-js/panel-sdk 1.0.0
 * @param data - 要序列化的数据，可以是任意类型
 * @returns JSON 字符串表示；若输入为 null 或 undefined 则返回空字符串；若输入已是字符串则原样返回
 * @remarks 该函数不会抛出异常，序列化失败时会返回原始数据的字符串形式。
 * @example 基础用法
 * ```ts
 * import { utils } from '@ray-js/panel-sdk';
 *
 * const { stringifyJSON } = utils;
 *
 * stringifyJSON({ a: 1 }); // '{"a":1}'
 * stringifyJSON('hello');  // 'hello'
 * stringifyJSON(null);     // ''
 * stringifyJSON(undefined); // ''
 * ```
 */
export declare const stringifyJSON: (data: any) => string;