feat(json-schema): expose API that generates examples from JSON Schema (#9190)

This allows to use the samples API in a static way
without fully instantiating SwaggerUI.

Refs #9188

src/core/plugins/json-schema-2020-12-samples/fn/api/encoderAPI.js

@@ -2,7 +2,7 @@
  * @prettier
  */
 
-import EncoderRegistry from "core/plugins/json-schema-2020-12/samples-extensions/fn/class/EncoderRegistry"
+import EncoderRegistry from "../class/EncoderRegistry"
 
 const registry = new EncoderRegistry()
 

src/core/plugins/json-schema-2020-12-samples/fn/get-json-sample-schema.js

@@ -0,0 +1,36 @@
+/**
+ * @prettier
+ */
+import some from "lodash/some"
+
+const shouldStringifyTypesConfig = [
+  {
+    when: /json/,
+    shouldStringifyTypes: ["string"],
+  },
+]
+const defaultStringifyTypes = ["object"]
+const makeGetJsonSampleSchema =
+  (getSystem) => (schema, config, contentType, exampleOverride) => {
+    const { fn } = getSystem()
+    const res = fn.jsonSchema202012.memoizedSampleFromSchema(
+      schema,
+      config,
+      exampleOverride
+    )
+    const resType = typeof res
+
+    const typesToStringify = shouldStringifyTypesConfig.reduce(
+      (types, nextConfig) =>
+        nextConfig.when.test(contentType)
+          ? [...types, ...nextConfig.shouldStringifyTypes]
+          : types,
+      defaultStringifyTypes
+    )
+
+    return some(typesToStringify, (x) => x === resType)
+      ? JSON.stringify(res, null, 2)
+      : res
+  }
+
+export default makeGetJsonSampleSchema

src/core/plugins/json-schema-2020-12-samples/fn/get-sample-schema.js

@@ -0,0 +1,39 @@
+/**
+ * @prettier
+ */
+const makeGetSampleSchema =
+  (getSystem) =>
+  (schema, contentType = "", config = {}, exampleOverride = undefined) => {
+    const { fn } = getSystem()
+
+    if (typeof schema?.toJS === "function") {
+      schema = schema.toJS()
+    }
+    if (typeof exampleOverride?.toJS === "function") {
+      exampleOverride = exampleOverride.toJS()
+    }
+
+    if (/xml/.test(contentType)) {
+      return fn.jsonSchema202012.getXmlSampleSchema(
+        schema,
+        config,
+        exampleOverride
+      )
+    }
+    if (/(yaml|yml)/.test(contentType)) {
+      return fn.jsonSchema202012.getYamlSampleSchema(
+        schema,
+        config,
+        contentType,
+        exampleOverride
+      )
+    }
+    return fn.jsonSchema202012.getJsonSampleSchema(
+      schema,
+      config,
+      contentType,
+      exampleOverride
+    )
+  }
+
+export default makeGetSampleSchema

src/core/plugins/json-schema-2020-12-samples/fn/get-xml-sample-schema.js

@@ -0,0 +1,35 @@
+/**
+ * @prettier
+ */
+const makeGetXmlSampleSchema =
+  (getSystem) => (schema, config, exampleOverride) => {
+    const { fn } = getSystem()
+
+    if (schema && !schema.xml) {
+      schema.xml = {}
+    }
+    if (schema && !schema.xml.name) {
+      if (
+        !schema.$$ref &&
+        (schema.type ||
+          schema.items ||
+          schema.properties ||
+          schema.additionalProperties)
+      ) {
+        // eslint-disable-next-line quotes
+        return '<?xml version="1.0" encoding="UTF-8"?>\n<!-- XML example cannot be generated; root element name is undefined -->'
+      }
+      if (schema.$$ref) {
+        let match = schema.$$ref.match(/\S*\/(\S+)$/)
+        schema.xml.name = match[1]
+      }
+    }
+
+    return fn.jsonSchema202012.memoizedCreateXMLExample(
+      schema,
+      config,
+      exampleOverride
+    )
+  }
+
+export default makeGetXmlSampleSchema

src/core/plugins/json-schema-2020-12-samples/fn/get-yaml-sample-schema.js

@@ -0,0 +1,34 @@
+/**
+ * @prettier
+ */
+import YAML, { JSON_SCHEMA } from "js-yaml"
+
+const makeGetYamlSampleSchema =
+  (getSystem) => (schema, config, contentType, exampleOverride) => {
+    const { fn } = getSystem()
+    const jsonExample = fn.jsonSchema202012.getJsonSampleSchema(
+      schema,
+      config,
+      contentType,
+      exampleOverride
+    )
+    let yamlString
+    try {
+      yamlString = YAML.dump(
+        YAML.load(jsonExample),
+        {
+          lineWidth: -1, // don't generate line folds
+        },
+        { schema: JSON_SCHEMA }
+      )
+      if (yamlString[yamlString.length - 1] === "\n") {
+        yamlString = yamlString.slice(0, yamlString.length - 1)
+      }
+    } catch (e) {
+      console.error(e)
+      return "error: could not generate yaml example"
+    }
+    return yamlString.replace(/\t/g, "  ")
+  }
+
+export default makeGetYamlSampleSchema

src/core/plugins/json-schema-2020-12-samples/index.js

@@ -0,0 +1,45 @@
+/**
+ * @prettier
+ */
+import {
+  sampleFromSchema,
+  sampleFromSchemaGeneric,
+  createXMLExample,
+  memoizedSampleFromSchema,
+  memoizedCreateXMLExample,
+  encoderAPI,
+  mediaTypeAPI,
+  formatAPI,
+} from "./fn/index"
+import makeGetJsonSampleSchema from "./fn/get-json-sample-schema"
+import makeGetYamlSampleSchema from "./fn/get-yaml-sample-schema"
+import makeGetXmlSampleSchema from "./fn/get-xml-sample-schema"
+import makeGetSampleSchema from "./fn/get-sample-schema"
+
+const JSONSchema202012SamplesPlugin = ({ getSystem }) => {
+  const getJsonSampleSchema = makeGetJsonSampleSchema(getSystem)
+  const getYamlSampleSchema = makeGetYamlSampleSchema(getSystem)
+  const getXmlSampleSchema = makeGetXmlSampleSchema(getSystem)
+  const getSampleSchema = makeGetSampleSchema(getSystem)
+
+  return {
+    fn: {
+      jsonSchema202012: {
+        sampleFromSchema,
+        sampleFromSchemaGeneric,
+        sampleEncoderAPI: encoderAPI,
+        sampleFormatAPI: formatAPI,
+        sampleMediaTypeAPI: mediaTypeAPI,
+        createXMLExample,
+        memoizedSampleFromSchema,
+        memoizedCreateXMLExample,
+        getJsonSampleSchema,
+        getYamlSampleSchema,
+        getXmlSampleSchema,
+        getSampleSchema,
+      },
+    },
+  }
+}
+
+export default JSONSchema202012SamplesPlugin

src/core/plugins/json-schema-2020-12/index.js

@@ -44,16 +44,6 @@ import Accordion from "./components/Accordion/Accordion"
 import ExpandDeepButton from "./components/ExpandDeepButton/ExpandDeepButton"
 import ChevronRightIcon from "./components/icons/ChevronRight"
 import { upperFirst, hasKeyword, isExpandable } from "./fn"
-import {
-  sampleFromSchema,
-  sampleFromSchemaGeneric,
-  createXMLExample,
-  memoizedSampleFromSchema,
-  memoizedCreateXMLExample,
-  encoderAPI,
-  mediaTypeAPI,
-  formatAPI,
-} from "./samples-extensions/fn/index"
 import { JSONSchemaDeepExpansionContext } from "./context"
 import { useFn, useConfig, useComponent, useIsExpandedDeeply } from "./hooks"
 import { withJSONSchemaContext } from "./hoc"
@@ -114,14 +104,6 @@ const JSONSchema202012Plugin = () => ({
       useConfig,
       useComponent,
       useIsExpandedDeeply,
-      sampleFromSchema,
-      sampleFromSchemaGeneric,
-      sampleEncoderAPI: encoderAPI,
-      sampleFormatAPI: formatAPI,
-      sampleMediaTypeAPI: mediaTypeAPI,
-      createXMLExample,
-      memoizedSampleFromSchema,
-      memoizedCreateXMLExample,
     },
   },
 })

src/core/plugins/json-schema-5-samples/index.js

@@ -0,0 +1,51 @@
+/**
+ * @prettier
+ */
+import {
+  sampleFromSchema,
+  inferSchema,
+  sampleFromSchemaGeneric,
+  createXMLExample,
+  memoizedCreateXMLExample,
+  memoizedSampleFromSchema,
+} from "./fn/index"
+import makeGetJsonSampleSchema from "./fn/get-json-sample-schema"
+import makeGetYamlSampleSchema from "./fn/get-yaml-sample-schema"
+import makeGetXmlSampleSchema from "./fn/get-xml-sample-schema"
+import makeGetSampleSchema from "./fn/get-sample-schema"
+
+const JSONSchema5SamplesPlugin = ({ getSystem }) => {
+  const getJsonSampleSchema = makeGetJsonSampleSchema(getSystem)
+  const getYamlSampleSchema = makeGetYamlSampleSchema(getSystem)
+  const getXmlSampleSchema = makeGetXmlSampleSchema(getSystem)
+  const getSampleSchema = makeGetSampleSchema(getSystem)
+
+  return {
+    fn: {
+      jsonSchema5: {
+        inferSchema,
+        sampleFromSchema,
+        sampleFromSchemaGeneric,
+        createXMLExample,
+        memoizedSampleFromSchema,
+        memoizedCreateXMLExample,
+        getJsonSampleSchema,
+        getYamlSampleSchema,
+        getXmlSampleSchema,
+        getSampleSchema,
+      },
+      inferSchema,
+      sampleFromSchema,
+      sampleFromSchemaGeneric,
+      createXMLExample,
+      memoizedSampleFromSchema,
+      memoizedCreateXMLExample,
+      getJsonSampleSchema,
+      getYamlSampleSchema,
+      getXmlSampleSchema,
+      getSampleSchema,
+    },
+  }
+}
+
+export default JSONSchema5SamplesPlugin

src/core/plugins/samples/index.js

@@ -1,32 +0,0 @@
-/**
- * @prettier
- */
-import {
-  sampleFromSchema,
-  inferSchema,
-  sampleFromSchemaGeneric,
-  createXMLExample,
-  memoizedCreateXMLExample,
-  memoizedSampleFromSchema,
-} from "./fn/index"
-import makeGetJsonSampleSchema from "./fn/get-json-sample-schema"
-import makeGetYamlSampleSchema from "./fn/get-yaml-sample-schema"
-import makeGetXmlSampleSchema from "./fn/get-xml-sample-schema"
-import makeGetSampleSchema from "./fn/get-sample-schema"
-
-const SamplesPlugin = ({ getSystem }) => ({
-  fn: {
-    inferSchema,
-    sampleFromSchema,
-    sampleFromSchemaGeneric,
-    createXMLExample,
-    memoizedSampleFromSchema,
-    memoizedCreateXMLExample,
-    getJsonSampleSchema: makeGetJsonSampleSchema(getSystem),
-    getYamlSampleSchema: makeGetYamlSampleSchema(getSystem),
-    getXmlSampleSchema: makeGetXmlSampleSchema(getSystem),
-    getSampleSchema: makeGetSampleSchema(getSystem),
-  },
-})
-
-export default SamplesPlugin