@wtasnorg/node-lib 0.0.10 → 0.0.12

package/docs/functions/countOnes.md

@@ -0,0 +1,31 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / countOnes
+
+# Function: countOnes()
+
+> **countOnes**(`value`): `number`
+
+Defined in: [bits.ts:81](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/bits.ts#L81)
+
+Count set bits in a non-negative integer.
+
+## Parameters
+
+### value
+
+Input value.
+
+`number` | `bigint`
+
+## Returns
+
+`number`
+
+Number of set bits.
+
+## Throws
+
+If `value` is negative or an unsafe integer.

package/docs/functions/countZeroes.md

@@ -0,0 +1,32 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / countZeroes
+
+# Function: countZeroes()
+
+> **countZeroes**(`value`): `number`
+
+Defined in: [bits.ts:118](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/bits.ts#L118)
+
+Count zero bits from LSB up to and including the highest set bit.
+For zero input, returns 0.
+
+## Parameters
+
+### value
+
+Input value.
+
+`number` | `bigint`
+
+## Returns
+
+`number`
+
+Zero count up to the left-most set bit.
+
+## Throws
+
+If `value` is negative or an unsafe integer.

package/docs/functions/countZeroesWithWidth.md

@@ -0,0 +1,37 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / countZeroesWithWidth
+
+# Function: countZeroesWithWidth()
+
+> **countZeroesWithWidth**(`value`, `width`): `number`
+
+Defined in: [bits.ts:94](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/bits.ts#L94)
+
+Count zero bits within a fixed width, considering only low-order `width` bits.
+
+## Parameters
+
+### value
+
+Input value.
+
+`number` | `bigint`
+
+### width
+
+`number`
+
+Bit width to inspect.
+
+## Returns
+
+`number`
+
+Number of zero bits in the selected width.
+
+## Throws
+
+If `value` is negative/unsafe or `width` is negative/unsafe.

package/docs/functions/createFindDirectories.md

@@ -8,7 +8,7 @@
 
 > **createFindDirectories**(`deps`): (`root`, `options`) => `Promise`\<`string`[]\>
 
-Defined in: [find.ts:19](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/find.ts#L19)
+Defined in: [find.ts:19](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/find.ts#L19)
 
 Factory that produces an async findDirectories function with
 injected filesystem dependencies for full testability.
@@ -21,7 +21,7 @@ injected filesystem dependencies for full testability.
 
 ## Returns
 
-> (`root`, `options`): `Promise`\<`string`[]\>
+> (`root`, `options?`): `Promise`\<`string`[]\>
 
 ### Parameters
 
@@ -29,7 +29,7 @@ injected filesystem dependencies for full testability.
 
 `string`
 
-#### options
+#### options?
 
 [`FindDirectoriesOptions`](../interfaces/FindDirectoriesOptions.md) = `{}`
 

package/docs/functions/decode.md

@@ -6,9 +6,9 @@
 
 # Function: decode()
 
-> **decode**(`input`, `charset`): `string`
+> **decode**(`input`, `charset?`): `string`
 
-Defined in: [base64.ts:119](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/base64.ts#L119)
+Defined in: [base64.ts:119](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/base64.ts#L119)
 
 Decode a Base64 string.
 
@@ -20,7 +20,7 @@ Decode a Base64 string.
 
 The Base64 encoded string.
 
-### charset
+### charset?
 
 The charset variant to use (default: "standard").
 

package/docs/functions/decode32.md

@@ -0,0 +1,49 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / decode32
+
+# Function: decode32()
+
+> **decode32**(`input`, `charset?`): `string`
+
+Defined in: [base32.ts:136](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/base32.ts#L136)
+
+Decode a Base32 string.
+
+## Parameters
+
+### input
+
+`string`
+
+The Base32 encoded string.
+
+### charset?
+
+The charset variant to use (default: "rfc4648").
+
+`"rfc4648"` | `"hex"` | `"crockford"`
+
+## Returns
+
+`string`
+
+The decoded string.
+
+## Example
+
+```typescript
+import { decode32 } from "./base32.js";
+
+decode32("JBSWY3DP");
+// => "Hello"
+
+decode32("EHMP6SS=", "hex");
+// => "test"
+```
+
+## Throws
+
+Error if the input contains invalid characters.

package/docs/functions/decode58.md

@@ -0,0 +1,49 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / decode58
+
+# Function: decode58()
+
+> **decode58**(`input`, `charset?`): `string`
+
+Defined in: [base58.ts:132](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/base58.ts#L132)
+
+Decode a Base58 string.
+
+## Parameters
+
+### input
+
+`string`
+
+The Base58 encoded string.
+
+### charset?
+
+The charset variant to use (default: "bitcoin").
+
+`"bitcoin"` | `"flickr"` | `"ripple"`
+
+## Returns
+
+`string`
+
+The decoded string.
+
+## Example
+
+```typescript
+import { decode58 } from "./base58.js";
+
+decode58("JxF12TrwUP45BMd");
+// => "Hello World"
+
+decode58("jXf12sRWto45bmD", "flickr");
+// => "Hello World"
+```
+
+## Throws
+
+Error if the input contains invalid characters.

package/docs/functions/decode85.md

@@ -0,0 +1,49 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / decode85
+
+# Function: decode85()
+
+> **decode85**(`input`, `charset?`): `string`
+
+Defined in: [base85.ts:135](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/base85.ts#L135)
+
+Decode a Base85 string.
+
+## Parameters
+
+### input
+
+`string`
+
+The Base85 encoded string.
+
+### charset?
+
+The charset variant to use (default: "ascii85").
+
+`"ascii85"` | `"z85"` | `"rfc1924"`
+
+## Returns
+
+`string`
+
+The decoded string.
+
+## Example
+
+```typescript
+import { decode85 } from "./base85.js";
+
+decode85("87cURDZ");
+// => "Hello"
+
+decode85("wrx.P", "z85");
+// => "test"
+```
+
+## Throws
+
+Error if the input contains invalid characters.

package/docs/functions/encode.md

@@ -6,9 +6,9 @@
 
 # Function: encode()
 
-> **encode**(`input`, `charset`): `string`
+> **encode**(`input`, `charset?`): `string`
 
-Defined in: [base64.ts:79](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/base64.ts#L79)
+Defined in: [base64.ts:79](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/base64.ts#L79)
 
 Encode a string to Base64.
 
@@ -20,7 +20,7 @@ Encode a string to Base64.
 
 The string to encode.
 
-### charset
+### charset?
 
 The charset variant to use (default: "standard").
 

package/docs/functions/encode32.md

@@ -0,0 +1,45 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / encode32
+
+# Function: encode32()
+
+> **encode32**(`input`, `charset?`): `string`
+
+Defined in: [base32.ts:81](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/base32.ts#L81)
+
+Encode a string to Base32.
+
+## Parameters
+
+### input
+
+`string`
+
+The string to encode.
+
+### charset?
+
+The charset variant to use (default: "rfc4648").
+
+`"rfc4648"` | `"hex"` | `"crockford"`
+
+## Returns
+
+`string`
+
+The Base32 encoded string.
+
+## Example
+
+```typescript
+import { encode32 } from "./base32.js";
+
+encode32("Hello");
+// => "JBSWY3DP"
+
+encode32("test", "hex");
+// => "EHMP6SS="
+```

package/docs/functions/encode58.md

@@ -0,0 +1,45 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / encode58
+
+# Function: encode58()
+
+> **encode58**(`input`, `charset?`): `string`
+
+Defined in: [base58.ts:72](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/base58.ts#L72)
+
+Encode a string to Base58.
+
+## Parameters
+
+### input
+
+`string`
+
+The string to encode.
+
+### charset?
+
+The charset variant to use (default: "bitcoin").
+
+`"bitcoin"` | `"flickr"` | `"ripple"`
+
+## Returns
+
+`string`
+
+The Base58 encoded string.
+
+## Example
+
+```typescript
+import { encode58 } from "./base58.js";
+
+encode58("Hello World");
+// => "JxF12TrwUP45BMd"
+
+encode58("Hello World", "flickr");
+// => "jXf12sRWto45bmD"
+```

package/docs/functions/encode85.md

@@ -0,0 +1,45 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / encode85
+
+# Function: encode85()
+
+> **encode85**(`input`, `charset?`): `string`
+
+Defined in: [base85.ts:73](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/base85.ts#L73)
+
+Encode a string to Base85.
+
+## Parameters
+
+### input
+
+`string`
+
+The string to encode.
+
+### charset?
+
+The charset variant to use (default: "ascii85").
+
+`"ascii85"` | `"z85"` | `"rfc1924"`
+
+## Returns
+
+`string`
+
+The Base85 encoded string.
+
+## Example
+
+```typescript
+import { encode85 } from "./base85.js";
+
+encode85("Hello");
+// => "87cURDZ"
+
+encode85("test", "z85");
+// => "wrx.P"
+```

package/docs/functions/hello.md

@@ -8,7 +8,7 @@
 
 > **hello**(`konsole?`): `Promise`\<`string`\>
 
-Defined in: [hello.ts:31](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/hello.ts#L31)
+Defined in: [hello.ts:31](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/hello.ts#L31)
 
 A sample function that should work to test if lib is installed correctly.
 

package/docs/functions/parseUserAgent.md

@@ -8,7 +8,7 @@
 
 > **parseUserAgent**(`ua`): [`UserAgentInfo`](../interfaces/UserAgentInfo.md)
 
-Defined in: [user-agent.ts:48](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/user-agent.ts#L48)
+Defined in: [user-agent.ts:48](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/user-agent.ts#L48)
 
 Parses a user-agent string into a UserAgentInfo object.
 

package/docs/functions/pojo.md

@@ -8,7 +8,7 @@
 
 > **pojo**\<`T`\>(`instance`): `Record`\<`string`, `unknown`\>
 
-Defined in: [pojo.ts:10](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/pojo.ts#L10)
+Defined in: [pojo.ts:10](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/pojo.ts#L10)
 
 Convert a class instance into a plain JavaScript object.
 Copies only the instance's own enumerable data properties

package/docs/functions/popcount32.md

@@ -0,0 +1,27 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / popcount32
+
+# Function: popcount32()
+
+> **popcount32**(`value`): `number`
+
+Defined in: [bits.ts:52](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/bits.ts#L52)
+
+Count set bits in an unsigned 32-bit representation of a number.
+
+## Parameters
+
+### value
+
+`number`
+
+Number interpreted as uint32.
+
+## Returns
+
+`number`
+
+Number of set bits (0-32).

package/docs/functions/popcount64.md

@@ -0,0 +1,31 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / popcount64
+
+# Function: popcount64()
+
+> **popcount64**(`value`): `number`
+
+Defined in: [bits.ts:69](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/bits.ts#L69)
+
+Count set bits in the low 64 bits of a number or bigint.
+
+## Parameters
+
+### value
+
+Input value. For `number`, it must be a non-negative safe integer.
+
+`number` | `bigint`
+
+## Returns
+
+`number`
+
+Number of set bits (0-64).
+
+## Throws
+
+If `value` is negative or an unsafe integer.

package/docs/interfaces/FileSystemDependencies.md

@@ -6,7 +6,7 @@
 
 # Interface: FileSystemDependencies
 
-Defined in: [find.ts:3](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/find.ts#L3)
+Defined in: [find.ts:3](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/find.ts#L3)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [find.ts:3](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca5
 
 > **readdir**: (`_path`, `_opts`) => `Promise`\<`object`[]\>
 
-Defined in: [find.ts:4](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/find.ts#L4)
+Defined in: [find.ts:4](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/find.ts#L4)
 
 #### Parameters
 
@@ -38,7 +38,7 @@ Defined in: [find.ts:4](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca5
 
 > **stat**: (`_path`) => `Promise`\<\{ `isDirectory`: `boolean`; \}\>
 
-Defined in: [find.ts:5](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/find.ts#L5)
+Defined in: [find.ts:5](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/find.ts#L5)
 
 #### Parameters
 

package/docs/interfaces/FindDirectoriesOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: FindDirectoriesOptions
 
-Defined in: [find.ts:8](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/find.ts#L8)
+Defined in: [find.ts:8](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/find.ts#L8)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [find.ts:8](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca5
 
 > `optional` **allowlist**: `string`[] \| (`_absPath`, `_name`) => `boolean`
 
-Defined in: [find.ts:11](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/find.ts#L11)
+Defined in: [find.ts:11](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/find.ts#L11)
 
 ***
 
@@ -22,7 +22,7 @@ Defined in: [find.ts:11](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca
 
 > `optional` **blocklist**: `string`[] \| (`_absPath`, `_name`) => `boolean`
 
-Defined in: [find.ts:12](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/find.ts#L12)
+Defined in: [find.ts:12](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/find.ts#L12)
 
 ***
 
@@ -30,7 +30,7 @@ Defined in: [find.ts:12](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca
 
 > `optional` **followSymlinks**: `boolean`
 
-Defined in: [find.ts:10](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/find.ts#L10)
+Defined in: [find.ts:10](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/find.ts#L10)
 
 ***
 
@@ -38,4 +38,4 @@ Defined in: [find.ts:10](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca
 
 > `optional` **maxDepth**: `number`
 
-Defined in: [find.ts:9](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/find.ts#L9)
+Defined in: [find.ts:9](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/find.ts#L9)

package/docs/interfaces/UserAgentInfo.md

@@ -6,7 +6,7 @@
 
 # Interface: UserAgentInfo
 
-Defined in: [user-agent.ts:4](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/user-agent.ts#L4)
+Defined in: [user-agent.ts:4](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/user-agent.ts#L4)
 
 Information extracted from a user-agent string.
 
@@ -16,7 +16,7 @@ Information extracted from a user-agent string.
 
 > **browser**: `string`
 
-Defined in: [user-agent.ts:8](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/user-agent.ts#L8)
+Defined in: [user-agent.ts:8](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/user-agent.ts#L8)
 
 Browser name (e.g., Chrome, Firefox, Safari, Edge, Opera, Other).
 
@@ -26,7 +26,7 @@ Browser name (e.g., Chrome, Firefox, Safari, Edge, Opera, Other).
 
 > **device**: `string`
 
-Defined in: [user-agent.ts:20](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/user-agent.ts#L20)
+Defined in: [user-agent.ts:20](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/user-agent.ts#L20)
 
 Device type (e.g., Mobile, Tablet, Desktop, Other).
 
@@ -36,7 +36,7 @@ Device type (e.g., Mobile, Tablet, Desktop, Other).
 
 > **engine**: `string`
 
-Defined in: [user-agent.ts:24](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/user-agent.ts#L24)
+Defined in: [user-agent.ts:24](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/user-agent.ts#L24)
 
 Rendering engine (e.g., Blink, WebKit, Gecko, Presto, Other).
 
@@ -46,7 +46,7 @@ Rendering engine (e.g., Blink, WebKit, Gecko, Presto, Other).
 
 > **os**: `string`
 
-Defined in: [user-agent.ts:16](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/user-agent.ts#L16)
+Defined in: [user-agent.ts:16](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/user-agent.ts#L16)
 
 Operating system (e.g., Windows, macOS, Linux, iOS, Android, Other).
 
@@ -56,6 +56,6 @@ Operating system (e.g., Windows, macOS, Linux, iOS, Android, Other).
 
 > **version**: `string`
 
-Defined in: [user-agent.ts:12](https://github.com/wtasg/node-lib/blob/7baf8669b7042dca550ec8a4beb26526d3b538b4/src/user-agent.ts#L12)
+Defined in: [user-agent.ts:12](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/user-agent.ts#L12)
 
 Browser version (e.g., 120.0.0.0).

package/docs/type-aliases/Base32CharsetType.md

@@ -0,0 +1,13 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / Base32CharsetType
+
+# Type Alias: Base32CharsetType
+
+> **Base32CharsetType** = *typeof* [`Base32Charset`](../variables/Base32Charset.md)\[`number`\]
+
+Defined in: [base32.ts:18](https://github.com/wtasg/node-lib/blob/e8728afafd1c71a23332e0e226c750c68ec8ae80/src/base32.ts#L18)
+
+Base32 charset type.