feat: support const for OAS 3.1.1

demo/examples/tests/const.yaml

@@ -0,0 +1,93 @@
+openapi: 3.1.1
+info:
+  title: Const
+  description: Demonstrates various const.
+  version: 1.0.0
+tags:
+  - name: const
+    description: const tests
+paths:
+  /const:
+    get:
+      tags:
+        - const
+      summary: const with primitives
+      description: |
+        Schema:
+        ```yaml
+        type: object
+        properties:
+          type:
+            type: string
+            const: example
+            title: Example
+            description: |
+              This is an example
+          quality:
+            type: string
+            oneOf:
+              - const: good
+                title: Good
+                description: |
+                  This is a good example
+              - const: bad
+                title: Bad
+                description: |
+                  This is a bad example
+          tags:
+            type: array
+            items:
+              anyOf:
+                - const: dog
+                  title: Dog
+                  description: |
+                    This is a dog
+                - const: cat
+                  title: Cat
+                  description: |
+                    This is a cat
+        required:
+          - type
+          - quality
+        ```
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  type:
+                    type: string
+                    const: constExample
+                    title: Const Example
+                    description: |
+                      Const example description
+                  quality:
+                    type: string
+                    oneOf:
+                      - const: good
+                        title: Good
+                        description: |
+                          This is a good example
+                      - const: bad
+                        title: Bad
+                        description: |
+                          This is a bad example
+                  tags:
+                    type: array
+                    items:
+                      type: string
+                      anyOf:
+                        - const: dog
+                          title: Dog
+                          description: |
+                            This is a dog
+                        - const: cat
+                          title: Cat
+                          description: |
+                            This is a cat
+                required:
+                  - type
+                  - quality

packages/docusaurus-theme-openapi-docs/src/theme/Schema/index.tsx

@@ -122,9 +122,10 @@ const AnyOneOf: React.FC<SchemaProps> = ({ schema, schemaType }) => {
               value={`${index}-item-properties`}
             >
               {/* Handle primitive types directly */}
-              {["string", "number", "integer", "boolean"].includes(
+              {(["string", "number", "integer", "boolean"].includes(
                 anyOneSchema.type
-              ) && (
+              ) ||
+                anyOneSchema.const) && (
                 <SchemaItem
                   collapsible={false}
                   name={undefined}

packages/docusaurus-theme-openapi-docs/src/theme/SchemaItem/index.tsx

@@ -65,6 +65,7 @@ export default function SchemaItem(props: Props) {
   let example: string | undefined;
   let nullable;
   let enumDescriptions: [string, string][] = [];
+  let constValue: string | undefined;
 
   if (schema) {
     deprecated = schema.deprecated;
@@ -75,6 +76,7 @@ export default function SchemaItem(props: Props) {
     nullable =
       schema.nullable ||
       (Array.isArray(schema.type) && schema.type.includes("null")); // support JSON Schema nullable
+    constValue = schema.const;
   }
 
   const renderRequired = guard(
@@ -161,6 +163,30 @@ export default function SchemaItem(props: Props) {
     return undefined;
   }
 
+  function renderConstValue() {
+    if (constValue !== undefined) {
+      if (typeof constValue === "string") {
+        return (
+          <div>
+            <strong>Constant value: </strong>
+            <span>
+              <code>{constValue}</code>
+            </span>
+          </div>
+        );
+      }
+      return (
+        <div>
+          <strong>Constant value: </strong>
+          <span>
+            <code>{JSON.stringify(constValue)}</code>
+          </span>
+        </div>
+      );
+    }
+    return undefined;
+  }
+
   const schemaContent = (
     <div>
       <span className="openapi-schema__container">
@@ -184,6 +210,7 @@ export default function SchemaItem(props: Props) {
       {renderSchemaDescription}
       {renderEnumDescriptions}
       {renderQualifierMessage}
+      {renderConstValue()}
       {renderDefaultValue()}
       {renderExample()}
       {collapsibleSchemaContent ?? collapsibleSchemaContent}