docusaurus-theme-openapi-docs 1.1.2 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/markdown/schema.js +85 -20
- package/lib/theme/ApiDemoPanel/Body/index.js +1 -1
- package/lib/theme/ApiItem/Layout/styles.module.css +16 -0
- package/lib/theme/ApiLogo/index.js +29 -0
- package/lib/theme/DiscriminatorTabs/index.js +263 -0
- package/lib/theme/DiscriminatorTabs/styles.module.css +111 -0
- package/lib/theme/MimeTabs/index.js +260 -0
- package/lib/theme/MimeTabs/styles.module.css +125 -0
- package/lib/theme/ParamsItem/index.js +10 -0
- package/lib/theme/ResponseSamples/index.js +27 -0
- package/lib/theme/ResponseSamples/styles.module.css +7 -0
- package/lib/theme/SchemaItem/index.js +15 -3
- package/lib/theme/SchemaTabs/styles.module.css +0 -8
- package/lib-next/markdown/schema.js +88 -22
- package/lib-next/theme/ApiDemoPanel/Body/index.js +1 -1
- package/lib-next/theme/ApiItem/Layout/styles.module.css +16 -0
- package/lib-next/theme/ApiLogo/index.js +21 -0
- package/lib-next/theme/DiscriminatorTabs/index.js +263 -0
- package/lib-next/theme/DiscriminatorTabs/styles.module.css +111 -0
- package/lib-next/theme/MimeTabs/index.js +260 -0
- package/lib-next/theme/MimeTabs/styles.module.css +125 -0
- package/lib-next/theme/ParamsItem/index.js +10 -0
- package/lib-next/theme/ResponseSamples/index.js +27 -0
- package/lib-next/theme/ResponseSamples/styles.module.css +7 -0
- package/lib-next/theme/SchemaItem/index.js +15 -3
- package/lib-next/theme/SchemaTabs/styles.module.css +0 -8
- package/package.json +6 -6
- package/src/markdown/schema.ts +86 -20
- package/src/markdown/utils.ts +2 -2
- package/src/theme/ApiDemoPanel/Body/index.tsx +1 -1
- package/src/theme/ApiItem/Layout/styles.module.css +16 -0
- package/src/theme/ApiLogo/index.tsx +25 -0
- package/src/theme/DiscriminatorTabs/index.js +263 -0
- package/src/theme/DiscriminatorTabs/styles.module.css +111 -0
- package/src/theme/MimeTabs/index.js +260 -0
- package/src/theme/MimeTabs/styles.module.css +125 -0
- package/src/theme/ParamsItem/index.js +10 -0
- package/src/theme/ResponseSamples/index.js +27 -0
- package/src/theme/ResponseSamples/styles.module.css +7 -0
- package/src/theme/SchemaItem/index.js +15 -3
- package/src/theme/SchemaTabs/styles.module.css +0 -8
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
3
|
+
*
|
|
4
|
+
* This source code is licensed under the MIT license found in the
|
|
5
|
+
* LICENSE file in the root directory of this source tree.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
.tabItem {
|
|
9
|
+
display: flex;
|
|
10
|
+
align-items: center;
|
|
11
|
+
justify-content: center;
|
|
12
|
+
height: 2rem;
|
|
13
|
+
margin-top: 0 !important;
|
|
14
|
+
margin-right: 0.5rem;
|
|
15
|
+
/* border: 1px solid var(--openapi-code-dim-dark);
|
|
16
|
+
border-radius: 0; */
|
|
17
|
+
font-weight: var(--ifm-font-weight-normal);
|
|
18
|
+
/* color: var(--openapi-code-dim-dark); */
|
|
19
|
+
font-size: 12px;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
.tabItem:active {
|
|
23
|
+
background-color: var(--ifm-color-emphasis-100);
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/* .tabItem:hover {
|
|
27
|
+
color: var(--ifm-color-emphasis-500) !important;
|
|
28
|
+
} */
|
|
29
|
+
|
|
30
|
+
.tabItem:last-child {
|
|
31
|
+
margin-right: 0 !important;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/* Open API Response Code Tabs */
|
|
35
|
+
.mimeTabsTopSection {
|
|
36
|
+
display: flex;
|
|
37
|
+
justify-content: space-between;
|
|
38
|
+
align-items: center;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
.mimeTabsContainer {
|
|
42
|
+
display: flex;
|
|
43
|
+
align-items: center;
|
|
44
|
+
max-width: 390px;
|
|
45
|
+
/* padding-left: 1rem; */
|
|
46
|
+
overflow: hidden;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
.mimeTabsListContainer {
|
|
50
|
+
overflow-y: hidden;
|
|
51
|
+
overflow-x: scroll;
|
|
52
|
+
scroll-behavior: smooth;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
.mimeTabsListContainer::-webkit-scrollbar {
|
|
56
|
+
display: none;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/* Response Code Tabs - Colored Dots */
|
|
60
|
+
.mimeTabDot {
|
|
61
|
+
width: 12.5px;
|
|
62
|
+
height: 12.5px;
|
|
63
|
+
margin-right: 5px;
|
|
64
|
+
border-radius: 50%;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
.mimeTabDotSuccess {
|
|
68
|
+
background-color: var(--ifm-color-success);
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
.mimeTabDotDanger {
|
|
72
|
+
background-color: var(--ifm-color-danger);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
.mimeTabDotInfo {
|
|
76
|
+
background-color: var(--ifm-color-info);
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
.mimeTabActive {
|
|
80
|
+
border-bottom-color: var(--ifm-tabs-color-active-border);
|
|
81
|
+
border-bottom-left-radius: 0;
|
|
82
|
+
border-bottom-right-radius: 0;
|
|
83
|
+
color: var(--ifm-tabs-color-active);
|
|
84
|
+
background-color: var(--ifm-color-emphasis-100);
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
.mimeSchemaContainer {
|
|
88
|
+
max-width: 600px;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/* Tab Arrows */
|
|
92
|
+
.tabArrow {
|
|
93
|
+
content: "";
|
|
94
|
+
height: 1.25rem;
|
|
95
|
+
width: 1.25rem;
|
|
96
|
+
border: none;
|
|
97
|
+
min-width: 1.25rem;
|
|
98
|
+
background: var(--ifm-menu-link-sublist-icon) 50% / 2rem 2rem;
|
|
99
|
+
filter: var(--ifm-menu-link-sublist-icon-filter);
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
.tabArrow:hover {
|
|
103
|
+
cursor: pointer;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
.tabArrowLeft {
|
|
107
|
+
transform: rotate(270deg);
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
.tabArrowRight {
|
|
111
|
+
transform: rotate(90deg);
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
@media screen and (max-width: 500px) {
|
|
115
|
+
.mimeTabsTopSection {
|
|
116
|
+
flex-direction: column;
|
|
117
|
+
align-items: flex-start;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
.mimeTabsContainer {
|
|
121
|
+
width: 100%;
|
|
122
|
+
margin-top: var(--ifm-spacing-vertical);
|
|
123
|
+
padding: 0;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
@@ -37,6 +37,15 @@ function ParamsItem({
|
|
|
37
37
|
</div>
|
|
38
38
|
));
|
|
39
39
|
|
|
40
|
+
const renderDefaultValue = guard(
|
|
41
|
+
schema.items ? schema.items.default : schema.default,
|
|
42
|
+
(value) => (
|
|
43
|
+
<div>
|
|
44
|
+
<ReactMarkdown children={`**Default value:** \`${value}\``} />
|
|
45
|
+
</div>
|
|
46
|
+
)
|
|
47
|
+
);
|
|
48
|
+
|
|
40
49
|
const renderExample = guard(example, (example) => (
|
|
41
50
|
<div>{`Example: ${example}`}</div>
|
|
42
51
|
));
|
|
@@ -58,6 +67,7 @@ function ParamsItem({
|
|
|
58
67
|
{renderSchemaName}
|
|
59
68
|
{renderSchemaRequired}
|
|
60
69
|
{renderSchema}
|
|
70
|
+
{renderDefaultValue}
|
|
61
71
|
{renderDescription}
|
|
62
72
|
{renderExample}
|
|
63
73
|
{renderExamples}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/* ============================================================================
|
|
2
|
+
* Copyright (c) Palo Alto Networks
|
|
3
|
+
*
|
|
4
|
+
* This source code is licensed under the MIT license found in the
|
|
5
|
+
* LICENSE file in the root directory of this source tree.
|
|
6
|
+
* ========================================================================== */
|
|
7
|
+
|
|
8
|
+
import React from "react";
|
|
9
|
+
|
|
10
|
+
import CodeBlock from "@theme/CodeBlock";
|
|
11
|
+
|
|
12
|
+
import styles from "./styles.module.css";
|
|
13
|
+
|
|
14
|
+
function ResponseSamples({ responseExample }) {
|
|
15
|
+
return (
|
|
16
|
+
<div className={styles.responseSamplesContainer}>
|
|
17
|
+
<CodeBlock
|
|
18
|
+
language="javascript"
|
|
19
|
+
className={styles.responseSamplesCodeBlock}
|
|
20
|
+
>
|
|
21
|
+
{responseExample}
|
|
22
|
+
</CodeBlock>
|
|
23
|
+
</div>
|
|
24
|
+
);
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export default ResponseSamples;
|
|
@@ -21,10 +21,12 @@ function SchemaItem({
|
|
|
21
21
|
required,
|
|
22
22
|
schemaDescription,
|
|
23
23
|
schemaName,
|
|
24
|
+
defaultValue,
|
|
24
25
|
}) {
|
|
25
|
-
const renderRequired = guard(
|
|
26
|
-
|
|
27
|
-
|
|
26
|
+
const renderRequired = guard(
|
|
27
|
+
Array.isArray(required) ? required.includes(name) : required,
|
|
28
|
+
() => <strong className={styles.required}> required</strong>
|
|
29
|
+
);
|
|
28
30
|
|
|
29
31
|
const renderSchemaDescription = guard(schemaDescription, (description) => (
|
|
30
32
|
<div className={styles.schemaDescription}>
|
|
@@ -38,12 +40,22 @@ function SchemaItem({
|
|
|
38
40
|
</div>
|
|
39
41
|
));
|
|
40
42
|
|
|
43
|
+
const renderDefaultValue = guard(
|
|
44
|
+
typeof defaultValue === "boolean" ? defaultValue.toString() : defaultValue,
|
|
45
|
+
(value) => (
|
|
46
|
+
<div className={styles.schemaQualifierMessage}>
|
|
47
|
+
<ReactMarkdown children={`**Default value:** \`${value}\``} />
|
|
48
|
+
</div>
|
|
49
|
+
)
|
|
50
|
+
);
|
|
51
|
+
|
|
41
52
|
const schemaContent = (
|
|
42
53
|
<div>
|
|
43
54
|
<strong>{name}</strong>
|
|
44
55
|
<span className={styles.schemaName}> {schemaName}</span>
|
|
45
56
|
{renderRequired}
|
|
46
57
|
{renderQualifierMessage}
|
|
58
|
+
{renderDefaultValue}
|
|
47
59
|
{renderSchemaDescription}
|
|
48
60
|
</div>
|
|
49
61
|
);
|