docs(vrl): Add xxhash vrl function documentation (#23576)

* docs(vrl): Add xxhash vrl function documentation

Relates to vectordotdev/vrl#1472

* Fix Documentation Category

* update vrl

* Fix ThirdParty Licenses And Cue File Correctness

---------

Co-authored-by: Pavlos Rontidis <pavlos.rontidis@gmail.com>

Author: stigglor

.github/actions/spelling/expect.txt

@@ -672,6 +672,7 @@ wtimeout
 WTS
 xact
 xlarge
+XXH
 xxs
 YAMLs
 YBv

Cargo.lock

@@ -764,6 +764,7 @@ write16,https://github.com/hsivonen/write16,Apache-2.0 OR MIT,The write16 Author
 writeable,https://github.com/unicode-org/icu4x,Unicode-3.0,The ICU4X Project Developers
 wyz,https://github.com/myrrlyn/wyz,MIT,myrrlyn <self@myrrlyn.dev>
 xmlparser,https://github.com/RazrFalcon/xmlparser,MIT OR Apache-2.0,Yevhenii Reizner <razrfalcon@gmail.com>
+xxhash-rust,https://github.com/DoumanAsh/xxhash-rust,BSL-1.0,Douman <douman@gmx.se>
 yoke,https://github.com/unicode-org/icu4x,Unicode-3.0,Manish Goregaokar <manishsmail@gmail.com>
 yoke-derive,https://github.com/unicode-org/icu4x,Unicode-3.0,Manish Goregaokar <manishsmail@gmail.com>
 zerocopy,https://github.com/google/zerocopy,BSD-2-Clause OR Apache-2.0 OR MIT,Joshua Liebow-Feeser <joshlf@google.com>

LICENSE-3rdparty.csv

@@ -0,0 +1,65 @@
+package metadata
+
+remap: functions: xxhash: {
+	category:    "Checksum"
+	description: """
+		Calculates a [xxHash](\(urls.xxhash_rust)) hash of the `value`.
+		**Note**: Due to limitations in the underlying VRL data types, this function converts the unsigned 64-bit integer hash result to a signed 64-bit integer. Results higher than the signed 64-bit integer maximum value wrap around to negative values. For the XXH3-128 hash algorithm, values are returned as a string.
+		"""
+
+	arguments: [
+		{
+			name:        "value"
+			description: "The string to calculate the hash for."
+			required:    true
+			type: ["string"]
+		},
+		{
+			name:        "variant"
+			description: "The xxHash hashing algorithm to use."
+			required:    false
+			type: ["string"]
+			default: "XXH32"
+		},
+	]
+	internal_failure_reasons: []
+	return: types: ["integer", "string"]
+
+	examples: [
+		{
+			title: "Calculate a hash using the default (XXH32) algorithm"
+			source: #"""
+				xxhash("foo")
+				"""#
+			return: 3792637401
+		},
+		{
+			title: "Calculate a hash using the XXH32 algorithm"
+			source: #"""
+				xxhash("foo", "XXH32")
+				"""#
+			return: 3792637401
+		},
+		{
+			title: "Calculate a hash using the XXH64 algorithm"
+			source: #"""
+				xxhash("foo", "XXH64")
+				"""#
+			return: -3728699739546630719
+		},
+		{
+			title: "Calculate a hash using the XXH3-64 algorithm"
+			source: #"""
+				xxhash("foo", "XXH3-64)
+				"""#
+			return: -6093828362558603894
+		},
+		{
+			title: "Calculate a hash using the XXH3-128 algorithm"
+			source: #"""
+				xxhash("foo", "XXH3-128)
+				"""#
+			return: "161745101148472925293886522910304009610"
+		},
+	]
+}

website/cue/reference/remap/functions/xxhash.cue

@@ -678,6 +678,7 @@ urls: {
 	windows_installer:                          "\(wikipedia)/wiki/Windows_Installer"
 	windows_service:                            "https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.management/new-service"
 	woothee:                                    "https://github.com/woothee/woothee"
+	xxhash_rust:                                "https://github.com/DoumanAsh/xxhash-rust"
 	yaml:                                       "https://yaml.org/"
 	ytt:                                        "https://carvel.dev/ytt/"
 	yum:                                        "\(wikipedia)/wiki/Yum_(software)"