Mark OpenAPI properties as optional if not required (#3021)

.changeset/new-squids-approve.md

@@ -0,0 +1,6 @@
+---
+"@gitbook/react-openapi": patch
+"gitbook": patch
+---
+
+Mark properties as optional if not required

packages/gitbook/src/components/DocumentView/OpenAPI/style.css

@@ -201,6 +201,10 @@
     @apply text-warning-subtle text-[0.813rem];
 }
 
+.openapi-schema-optional {
+    @apply text-info-subtle text-[0.813rem];
+}
+
 .openapi-schema-readonly {
     @apply text-primary-subtle/9 text-[0.813rem];
 }

packages/react-openapi/src/OpenAPISchemaName.tsx

@@ -32,7 +32,11 @@ export function OpenAPISchemaName(props: OpenAPISchemaNameProps) {
                 ) : null}
             </span>
             {schema?.readOnly ? <span className="openapi-schema-readonly">read-only</span> : null}
-            {required ? <span className="openapi-schema-required">required</span> : null}
+            {required ? (
+                <span className="openapi-schema-required">required</span>
+            ) : (
+                <span className="openapi-schema-optional">optional</span>
+            )}
             {schema?.deprecated ? <span className="openapi-deprecated">Deprecated</span> : null}
         </div>
     );