chore(oas): [16/n] improve oas schemas (#9272)

- Improve OAS schemas [16/n]
- fixes and improvements to docs-generator tool

www/utils/packages/docs-generator/src/utils/level-utils.ts

@@ -0,0 +1,16 @@
+type IncrementType = "array" | "allOf" | "anyOf" | "oneOf" | "object"
+
+export function maybeIncrementLevel(
+  level: number,
+  type: IncrementType
+): number {
+  if (type !== "object") {
+    return level
+  }
+
+  return level + 1
+}
+
+export function isLevelExceeded(level: number, maxLevel: number) {
+  return level > maxLevel
+}