feat(common): add compress and crypto utilities

Introduce new functions for string compression and encryption:
- compress() / decompress() for Base64 URI-safe string compression
- encrypt() / decrypt() for XOR-based encryption with Base64 and URI encoding
- xor() for XOR encryption/decryption transformation

These functions are exported from the new 'secret' module in common and
are documented in the API reference. The README and guide files are
updated to include the new functions in the Common module listing.
The typedoc sidebar is also updated to reflect the new categories.

Author: ryanuo

README.md

@@ -74,7 +74,7 @@ Below are the module categories available in the utility library:
 | [Ai](https://utils.ryanuo.cc/api/ai/) | [linearRegression()](https://utils.ryanuo.cc/api/ai/functions/linearRegression.html)；[normalizeData()](https://utils.ryanuo.cc/api/ai/functions/normalizeData.html)；[normalizeMinMax()](https://utils.ryanuo.cc/api/ai/functions/normalizeMinMax.html) |
 | [Algorithm](https://utils.ryanuo.cc/api/algorithm/) | [binarySearch()](https://utils.ryanuo.cc/api/algorithm/functions/binarySearch.html)；[bubbleSort()](https://utils.ryanuo.cc/api/algorithm/functions/bubbleSort.html)；[fibonacciDP()](https://utils.ryanuo.cc/api/algorithm/functions/fibonacciDP.html)；[fibonacciRecursive()](https://utils.ryanuo.cc/api/algorithm/functions/fibonacciRecursive.html)；[isPrime()](https://utils.ryanuo.cc/api/algorithm/functions/isPrime.html)；[quickSort()](https://utils.ryanuo.cc/api/algorithm/functions/quickSort.html) |
 | [Browser](https://utils.ryanuo.cc/api/browser/) | [copyToClipboard()](https://utils.ryanuo.cc/api/browser/functions/copyToClipboard.html)；[enterFullScreen()](https://utils.ryanuo.cc/api/browser/functions/enterFullScreen.html)；[isMobile()](https://utils.ryanuo.cc/api/browser/functions/isMobile.html)；[manageClasses()](https://utils.ryanuo.cc/api/browser/functions/manageClasses.html)；[onceEventListener()](https://utils.ryanuo.cc/api/browser/functions/onceEventListener.html)；[downloadFile()](https://utils.ryanuo.cc/api/browser/functions/downloadFile.html)；[safeStorage()](https://utils.ryanuo.cc/api/browser/variables/safeStorage.html)；[getUrlParams()](https://utils.ryanuo.cc/api/browser/functions/getUrlParams.html)；[getUrlParamsString()](https://utils.ryanuo.cc/api/browser/functions/getUrlParamsString.html) |
-| [Common](https://utils.ryanuo.cc/api/common/) | [dateFormat()](https://utils.ryanuo.cc/api/common/functions/dateFormat.html)；[dayjs()](https://utils.ryanuo.cc/api/common/variables/dayjs.html)；[curry()](https://utils.ryanuo.cc/api/common/functions/curry.html)；[debounce()](https://utils.ryanuo.cc/api/common/functions/debounce.html)；[getUuid()](https://utils.ryanuo.cc/api/common/functions/getUuid.html)；[safeJSONParse()](https://utils.ryanuo.cc/api/common/functions/safeJSONParse.html)；[throttle()](https://utils.ryanuo.cc/api/common/functions/throttle.html)；[isBoolean()](https://utils.ryanuo.cc/api/common/functions/isBoolean.html)；[isBrowser()](https://utils.ryanuo.cc/api/common/functions/isBrowser.html)；[isDate()](https://utils.ryanuo.cc/api/common/functions/isDate.html)；[isEmptyObject()](https://utils.ryanuo.cc/api/common/functions/isEmptyObject.html)；[isFunction()](https://utils.ryanuo.cc/api/common/functions/isFunction.html)；[isNull()](https://utils.ryanuo.cc/api/common/functions/isNull.html)；[isNumber()](https://utils.ryanuo.cc/api/common/functions/isNumber.html)；[isObject()](https://utils.ryanuo.cc/api/common/functions/isObject.html)；[isRegExp()](https://utils.ryanuo.cc/api/common/functions/isRegExp.html)；[isString()](https://utils.ryanuo.cc/api/common/functions/isString.html)；[isUndefined()](https://utils.ryanuo.cc/api/common/functions/isUndefined.html)；[deepClone()](https://utils.ryanuo.cc/api/common/functions/deepClone.html)；[getTypeName()](https://utils.ryanuo.cc/api/common/functions/getTypeName.html)；[numberToFixed()](https://utils.ryanuo.cc/api/common/functions/numberToFixed.html)；[toString()](https://utils.ryanuo.cc/api/common/functions/toString.html) |
+| [Common](https://utils.ryanuo.cc/api/common/) | [dateFormat()](https://utils.ryanuo.cc/api/common/functions/dateFormat.html)；[dayjs()](https://utils.ryanuo.cc/api/common/variables/dayjs.html)；[curry()](https://utils.ryanuo.cc/api/common/functions/curry.html)；[debounce()](https://utils.ryanuo.cc/api/common/functions/debounce.html)；[getUuid()](https://utils.ryanuo.cc/api/common/functions/getUuid.html)；[safeJSONParse()](https://utils.ryanuo.cc/api/common/functions/safeJSONParse.html)；[throttle()](https://utils.ryanuo.cc/api/common/functions/throttle.html)；[compress()](https://utils.ryanuo.cc/api/common/functions/compress.html)；[decompress()](https://utils.ryanuo.cc/api/common/functions/decompress.html)；[decrypt()](https://utils.ryanuo.cc/api/common/functions/decrypt.html)；[encrypt()](https://utils.ryanuo.cc/api/common/functions/encrypt.html)；[xor()](https://utils.ryanuo.cc/api/common/functions/xor.html)；[isBoolean()](https://utils.ryanuo.cc/api/common/functions/isBoolean.html)；[isBrowser()](https://utils.ryanuo.cc/api/common/functions/isBrowser.html)；[isDate()](https://utils.ryanuo.cc/api/common/functions/isDate.html)；[isEmptyObject()](https://utils.ryanuo.cc/api/common/functions/isEmptyObject.html)；[isFunction()](https://utils.ryanuo.cc/api/common/functions/isFunction.html)；[isNull()](https://utils.ryanuo.cc/api/common/functions/isNull.html)；[isNumber()](https://utils.ryanuo.cc/api/common/functions/isNumber.html)；[isObject()](https://utils.ryanuo.cc/api/common/functions/isObject.html)；[isRegExp()](https://utils.ryanuo.cc/api/common/functions/isRegExp.html)；[isString()](https://utils.ryanuo.cc/api/common/functions/isString.html)；[isUndefined()](https://utils.ryanuo.cc/api/common/functions/isUndefined.html)；[deepClone()](https://utils.ryanuo.cc/api/common/functions/deepClone.html)；[getTypeName()](https://utils.ryanuo.cc/api/common/functions/getTypeName.html)；[numberToFixed()](https://utils.ryanuo.cc/api/common/functions/numberToFixed.html)；[toString()](https://utils.ryanuo.cc/api/common/functions/toString.html) |
 | [Finance](https://utils.ryanuo.cc/api/finance/) | [formatCurrency()](https://utils.ryanuo.cc/api/finance/functions/formatCurrency.html)；[calculatePercentage()](https://utils.ryanuo.cc/api/finance/functions/calculatePercentage.html)；[compare()](https://utils.ryanuo.cc/api/finance/functions/compare.html)；[preciseAdd()](https://utils.ryanuo.cc/api/finance/functions/preciseAdd.html)；[preciseDiv()](https://utils.ryanuo.cc/api/finance/functions/preciseDiv.html)；[preciseMul()](https://utils.ryanuo.cc/api/finance/functions/preciseMul.html)；[preciseSub()](https://utils.ryanuo.cc/api/finance/functions/preciseSub.html)；[roundTo()](https://utils.ryanuo.cc/api/finance/functions/roundTo.html)；[decimal()](https://utils.ryanuo.cc/api/finance/variables/decimal.html) |
 | [Graphics](https://utils.ryanuo.cc/api/graphics/) | [hexToRgba()](https://utils.ryanuo.cc/api/graphics/functions/hexToRgba.html)；[lerpColor()](https://utils.ryanuo.cc/api/graphics/functions/lerpColor.html)；[rgbaToHex()](https://utils.ryanuo.cc/api/graphics/functions/rgbaToHex.html) |
 | [Network](https://utils.ryanuo.cc/api/network/) | [checkNetworkStatus()](https://utils.ryanuo.cc/api/network/functions/checkNetworkStatus.html)；[fetchWithTimeout()](https://utils.ryanuo.cc/api/network/functions/fetchWithTimeout.html)；[getClientIP()](https://utils.ryanuo.cc/api/network/functions/getClientIP.html)；[getIndexedDBCache()](https://utils.ryanuo.cc/api/network/functions/getIndexedDBCache.html)；[parallelRequests()](https://utils.ryanuo.cc/api/network/functions/parallelRequests.html)；[request()](https://utils.ryanuo.cc/api/network/functions/request.html) |

docs/api/common/functions/compress.md

@@ -0,0 +1,30 @@
+[@ryanuo/utils](../../index.md) / [common](../index.md) / compress
+
+# Function: compress()
+
+```ts
+function compress(str): string;
+```
+
+Compresses a UTF-8 string into a Base64 URI-safe format.
+
+## Parameters
+
+### str
+
+`string`
+
+The string to compress.
+
+## Returns
+
+`string`
+
+The compressed, Base64-encoded string.
+
+## Example
+
+```ts twoslash
+import { compress } from '@ryanuo/utils'
+compress('hello world') // => 'aGVsbG8lMjB3b3JsZA%3D%3D'
+```

docs/api/common/functions/decompress.md

@@ -0,0 +1,30 @@
+[@ryanuo/utils](../../index.md) / [common](../index.md) / decompress
+
+# Function: decompress()
+
+```ts
+function decompress(str): string;
+```
+
+Decompresses a string produced by [compress](compress.md).
+
+## Parameters
+
+### str
+
+`string`
+
+The compressed Base64 string.
+
+## Returns
+
+`string`
+
+The original decompressed string.
+
+## Example
+
+```ts twoslash
+import { decompress } from '@ryanuo/utils'
+decompress(compress('hello world')) // => 'hello world'
+```

docs/api/common/functions/decrypt.md

@@ -0,0 +1,38 @@
+[@ryanuo/utils](../../index.md) / [common](../index.md) / decrypt
+
+# Function: decrypt()
+
+```ts
+function decrypt(str, key?): string;
+```
+
+Decrypts a string previously encrypted with [encrypt](encrypt.md).
+Applies URI decoding, Base64 decoding, and XOR decryption.
+
+## Parameters
+
+### str
+
+`string`
+
+The encrypted string.
+
+### key?
+
+`string`
+
+Optional decryption key (must match the encryption key).
+
+## Returns
+
+`string`
+
+The decrypted plain text string.
+
+## Example
+
+```ts twoslash
+import { encrypt, decrypt } from '@ryanuo/utils'
+const enc = encrypt('hello world', 'key')
+decrypt(enc, 'key') // => 'hello world'
+```

docs/api/common/functions/encrypt.md

@@ -0,0 +1,36 @@
+[@ryanuo/utils](../../index.md) / [common](../index.md) / encrypt
+
+# Function: encrypt()
+
+```ts
+function encrypt(str, key?): string;
+```
+
+Encrypts a string using XOR, Base64, and URI encoding for safe transmission.
+
+## Parameters
+
+### str
+
+`string`
+
+The plain text to encrypt.
+
+### key?
+
+`string`
+
+Optional encryption key, defaults to `'ryanuo'`.
+
+## Returns
+
+`string`
+
+The encrypted, URI-safe string.
+
+## Example
+
+```ts twoslash
+import { encrypt } from '@ryanuo/utils'
+encrypt('hello world', 'key') // => '%4D%0A...'
+```

docs/api/common/functions/xor.md

@@ -0,0 +1,37 @@
+[@ryanuo/utils](../../index.md) / [common](../index.md) / xor
+
+# Function: xor()
+
+```ts
+function xor(str, key): string;
+```
+
+Performs XOR encryption or decryption on a string using a given key.
+
+## Parameters
+
+### str
+
+`string`
+
+The string to process.
+
+### key
+
+`string` = `'ryanuo'`
+
+The encryption key, defaults to `'ryanuo'`.
+
+## Returns
+
+`string`
+
+The XOR-transformed string.
+
+## Example
+
+```ts twoslash
+import { xor } from '@ryanuo/utils'
+xor('abc', 'key') // Encrypt
+xor(xor('abc', 'key'), 'key') // Decrypt (reversible)
+```

docs/api/common/index.md

@@ -21,6 +21,21 @@
 | [safeJSONParse](functions/safeJSONParse.md) | Safely parses a JSON string |
 | [throttle](functions/throttle.md) | Creates a throttled function that only executes the original function at most once per `delay` milliseconds. If `immediate` is true, the original function will be executed immediately upon the first call within the `delay` period. |
 
+## compress
+
+| Function | Description |
+| ------ | ------ |
+| [compress](functions/compress.md) | Compresses a UTF-8 string into a Base64 URI-safe format. |
+| [decompress](functions/decompress.md) | Decompresses a string produced by [compress](functions/compress.md). |
+
+## crypto
+
+| Function | Description |
+| ------ | ------ |
+| [decrypt](functions/decrypt.md) | Decrypts a string previously encrypted with [encrypt](functions/encrypt.md). Applies URI decoding, Base64 decoding, and XOR decryption. |
+| [encrypt](functions/encrypt.md) | Encrypts a string using XOR, Base64, and URI encoding for safe transmission. |
+| [xor](functions/xor.md) | Performs XOR encryption or decryption on a string using a given key. |
+
 ## is
 
 | Function | Description |