docs(vrl): add casing functions (vectordotdev/vrl#973)

website/cue/reference/remap/functions/camelcase.cue

@@ -0,0 +1,43 @@
+package metadata
+
+remap: functions: camelcase: {
+	category: "String"
+	description: """
+		Takes the `value` string, and turns it into camelCase. Optionally, you can
+		pass in the existing case of the function, or else we will try to figure out the case automatically.
+		"""
+
+	arguments: [
+		{
+			name:        "value"
+			description: "The string to convert to camelCase."
+			required:    true
+			type: ["string"]
+		},
+		{
+			name:        "original_case"
+			description: "Optional hint on the original case type. Must be one of: kebab-case, camelCase, PascalCase, SCREAMING_SNAKE, snake_case"
+			required:    false
+			type: ["string"]
+		},
+	]
+	internal_failure_reasons: []
+	return: types: ["string"]
+
+	examples: [
+		{
+			title: "camelCase a string"
+			source: #"""
+				camelcase("input-string")
+				"""#
+			return: "inputString"
+		},
+		{
+			title: "camelCase a string"
+			source: #"""
+				camelcase("input-string", "kebab-case")
+				"""#
+			return: "inputString"
+		},
+	]
+}

website/cue/reference/remap/functions/kebabcase.cue

@@ -0,0 +1,43 @@
+package metadata
+
+remap: functions: kebabcase: {
+	category: "String"
+	description: """
+		Takes the `value` string, and turns it into kebab-case. Optionally, you can
+		pass in the existing case of the function, or else we will try to figure out the case automatically.
+		"""
+
+	arguments: [
+		{
+			name:        "value"
+			description: "The string to convert to kebab-case."
+			required:    true
+			type: ["string"]
+		},
+		{
+			name:        "original_case"
+			description: "Optional hint on the original case type. Must be one of: kebab-case, camelCase, PascalCase, SCREAMING_SNAKE, snake_case"
+			required:    false
+			type: ["string"]
+		},
+	]
+	internal_failure_reasons: []
+	return: types: ["string"]
+
+	examples: [
+		{
+			title: "kebab-case a string"
+			source: #"""
+				kebabcase("InputString")
+				"""#
+			return: "input-string"
+		},
+		{
+			title: "kebab-case a string"
+			source: #"""
+				kebabcase("InputString", "PascalCase")
+				"""#
+			return: "input-string"
+		},
+	]
+}

website/cue/reference/remap/functions/pascalcase.cue

@@ -0,0 +1,43 @@
+package metadata
+
+remap: functions: pascalcase: {
+	category: "String"
+	description: """
+		Takes the `value` string, and turns it into PascalCase. Optionally, you can
+		pass in the existing case of the function, or else we will try to figure out the case automatically.
+		"""
+
+	arguments: [
+		{
+			name:        "value"
+			description: "The string to convert to PascalCase."
+			required:    true
+			type: ["string"]
+		},
+		{
+			name:        "original_case"
+			description: "Optional hint on the original case type. Must be one of: kebab-case, camelCase, PascalCase, SCREAMING_SNAKE, snake_case"
+			required:    false
+			type: ["string"]
+		},
+	]
+	internal_failure_reasons: []
+	return: types: ["string"]
+
+	examples: [
+		{
+			title: "PascalCase a string"
+			source: #"""
+				pascalcase("input-string")
+				"""#
+			return: "InputString"
+		},
+		{
+			title: "PascalCase a string"
+			source: #"""
+				pascalcase("input-string", "kebab-case")
+				"""#
+			return: "InputString"
+		},
+	]
+}

website/cue/reference/remap/functions/screamingsnakecase.cue

@@ -0,0 +1,43 @@
+package metadata
+
+remap: functions: screamingsnakecase: {
+	category: "String"
+	description: """
+		Takes the `value` string, and turns it into SCREAMING_SNAKE case. Optionally, you can
+		pass in the existing case of the function, or else we will try to figure out the case automatically.
+		"""
+
+	arguments: [
+		{
+			name:        "value"
+			description: "The string to convert to SCREAMING_SNAKE case."
+			required:    true
+			type: ["string"]
+		},
+		{
+			name:        "original_case"
+			description: "Optional hint on the original case type. Must be one of: kebab-case, camelCase, PascalCase, SCREAMING_SNAKE, snake_case"
+			required:    false
+			type: ["string"]
+		},
+	]
+	internal_failure_reasons: []
+	return: types: ["string"]
+
+	examples: [
+		{
+			title: "SCREAMING_SNAKE a string"
+			source: #"""
+				screamingsnakecase("input-string")
+				"""#
+			return: "INPUT_STRING"
+		},
+		{
+			title: "SCREAMING_SNAKE a string"
+			source: #"""
+				screamingsnakecase("input-string", "kebab-case")
+				"""#
+			return: "INPUT_STRING"
+		},
+	]
+}

website/cue/reference/remap/functions/snakecase.cue

@@ -0,0 +1,43 @@
+package metadata
+
+remap: functions: snakecase: {
+	category: "String"
+	description: """
+		Takes the `value` string, and turns it into snake-case. Optionally, you can
+		pass in the existing case of the function, or else we will try to figure out the case automatically.
+		"""
+
+	arguments: [
+		{
+			name:        "value"
+			description: "The string to convert to snake-case."
+			required:    true
+			type: ["string"]
+		},
+		{
+			name:        "original_case"
+			description: "Optional hint on the original case type. Must be one of: kebab-case, camelCase, PascalCase, SCREAMING_SNAKE, snake_case"
+			required:    false
+			type: ["string"]
+		},
+	]
+	internal_failure_reasons: []
+	return: types: ["string"]
+
+	examples: [
+		{
+			title: "snake-case a string"
+			source: #"""
+				snakecase("input-string")
+				"""#
+			return: "input_string"
+		},
+		{
+			title: "snake-case a string"
+			source: #"""
+				snakecase("input-string", "kebab-case")
+				"""#
+			return: "input_string"
+		},
+	]
+}