docusaurus-theme-openapi-docs 1.1.1 → 1.1.4
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/markdown/utils.js +4 -0
- package/lib/theme/ApiDemoPanel/Server/index.js +2 -2
- package/lib/theme/ApiItem/Layout/styles.module.css +12 -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/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 +8 -0
- package/lib/theme/SchemaTabs/styles.module.css +0 -8
- package/lib-next/markdown/schema.js +88 -22
- package/lib-next/markdown/utils.js +4 -0
- package/lib-next/theme/ApiDemoPanel/Server/index.js +2 -2
- package/lib-next/theme/ApiItem/Layout/styles.module.css +12 -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/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 +8 -0
- 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 +5 -2
- package/src/theme/ApiDemoPanel/Server/index.tsx +2 -2
- package/src/theme/ApiItem/Layout/styles.module.css +12 -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/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 +8 -0
- package/src/theme/SchemaTabs/styles.module.css +0 -8
|
@@ -0,0 +1,111 @@
|
|
|
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: 1.8rem;
|
|
13
|
+
margin-top: 0 !important;
|
|
14
|
+
margin-right: 0.5rem;
|
|
15
|
+
border: 1px solid var(--openapi-code-dim-dark);
|
|
16
|
+
border-radius: var(--ifm-global-radius);
|
|
17
|
+
color: var(--openapi-code-dim-dark);
|
|
18
|
+
font-size: 12px;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
.tabItem:hover {
|
|
22
|
+
color: var(--ifm-color-emphasis-500) !important;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
.tabItem:last-child {
|
|
26
|
+
margin-right: 0 !important;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/* Open API Schema Tabs */
|
|
30
|
+
.discriminatorTabsTopSection {
|
|
31
|
+
margin-top: 1rem;
|
|
32
|
+
margin-left: 0.9rem;
|
|
33
|
+
display: flex;
|
|
34
|
+
justify-content: space-between;
|
|
35
|
+
align-items: center;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
.discriminatorTabsTopSection + hr {
|
|
39
|
+
display: none;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
.discriminatorTabsContainer {
|
|
43
|
+
display: flex;
|
|
44
|
+
align-items: center;
|
|
45
|
+
max-width: 390px;
|
|
46
|
+
padding-left: 3px;
|
|
47
|
+
overflow: hidden;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
.discriminatorTabsListContainer {
|
|
51
|
+
padding: 0 0.25rem;
|
|
52
|
+
overflow-y: hidden;
|
|
53
|
+
overflow-x: scroll;
|
|
54
|
+
scroll-behavior: smooth;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
.discriminatorTabsListContainer::-webkit-scrollbar {
|
|
58
|
+
display: none;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
.tabItem.discriminatorTabActive {
|
|
62
|
+
border: 1px solid var(--ifm-color-primary);
|
|
63
|
+
color: var(--ifm-color-primary);
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
.discriminatorTabLabel {
|
|
67
|
+
white-space: nowrap;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
.discriminatorTabsContainer {
|
|
71
|
+
max-width: 600px;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/* Tab Arrows */
|
|
75
|
+
.tabArrow {
|
|
76
|
+
content: "";
|
|
77
|
+
height: 1.25rem;
|
|
78
|
+
width: 1.25rem;
|
|
79
|
+
padding: 0 0.75rem;
|
|
80
|
+
border: none;
|
|
81
|
+
min-width: 1.25rem;
|
|
82
|
+
background: var(--ifm-menu-link-sublist-icon) 50% / 2rem 2rem;
|
|
83
|
+
filter: var(--ifm-menu-link-sublist-icon-filter);
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
.tabArrow:hover {
|
|
87
|
+
cursor: pointer;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
.tabArrowLeft {
|
|
91
|
+
transform: rotate(270deg);
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
.tabArrowRight {
|
|
95
|
+
transform: rotate(90deg);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
@media screen and (max-width: 500px) {
|
|
99
|
+
.discriminatorTabsTopSection {
|
|
100
|
+
flex-direction: column;
|
|
101
|
+
align-items: flex-start;
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
.discriminatorTabsContainer {
|
|
105
|
+
width: 100%;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
.tabItem {
|
|
109
|
+
height: 100%;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
@@ -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,6 +21,7 @@ function SchemaItem({
|
|
|
21
21
|
required,
|
|
22
22
|
schemaDescription,
|
|
23
23
|
schemaName,
|
|
24
|
+
defaultValue,
|
|
24
25
|
}) {
|
|
25
26
|
const renderRequired = guard(required, () => (
|
|
26
27
|
<strong className={styles.required}> required</strong>
|
|
@@ -38,12 +39,19 @@ function SchemaItem({
|
|
|
38
39
|
</div>
|
|
39
40
|
));
|
|
40
41
|
|
|
42
|
+
const renderDefaultValue = guard(defaultValue, (value) => (
|
|
43
|
+
<div className={styles.schemaQualifierMessage}>
|
|
44
|
+
<ReactMarkdown children={`**Default value:** \`${value}\``} />
|
|
45
|
+
</div>
|
|
46
|
+
));
|
|
47
|
+
|
|
41
48
|
const schemaContent = (
|
|
42
49
|
<div>
|
|
43
50
|
<strong>{name}</strong>
|
|
44
51
|
<span className={styles.schemaName}> {schemaName}</span>
|
|
45
52
|
{renderRequired}
|
|
46
53
|
{renderQualifierMessage}
|
|
54
|
+
{renderDefaultValue}
|
|
47
55
|
{renderSchemaDescription}
|
|
48
56
|
</div>
|
|
49
57
|
);
|