22 |
35 |
36 | }
37 | />
38 | );
39 | }
40 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2020 the Deno authors
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/public/styles/hljs/atom-one-dark.min.css:
--------------------------------------------------------------------------------
1 | /**
2 | * Minified by jsDelivr using clean-css v4.2.3.
3 | * Original file: /npm/highlight.js@10.7.2/styles/atom-one-dark.css
4 | *
5 | * Do NOT use SRI with dynamically generated files! More information: https://www.jsdelivr.com/using-sri-with-dynamic-files
6 | */
7 | .hljs{display:block;overflow-x:auto;padding:.5em;color:#abb2bf;background:#282c34}.hljs-comment,.hljs-quote{color:#5c6370;font-style:italic}.hljs-doctag,.hljs-formula,.hljs-keyword{color:#c678dd}.hljs-deletion,.hljs-name,.hljs-section,.hljs-selector-tag,.hljs-subst{color:#e06c75}.hljs-literal{color:#56b6c2}.hljs-addition,.hljs-attribute,.hljs-meta-string,.hljs-regexp,.hljs-string{color:#98c379}.hljs-built_in,.hljs-class .hljs-title{color:#e6c07b}.hljs-attr,.hljs-number,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-pseudo,.hljs-template-variable,.hljs-type,.hljs-variable{color:#d19a66}.hljs-bullet,.hljs-link,.hljs-meta,.hljs-selector-id,.hljs-symbol,.hljs-title{color:#61aeee}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:700}.hljs-link{text-decoration:underline}
8 | /*# sourceMappingURL=/sm/f7543874fd85ac54022e92bff1f3e54326ad7a136685439729114cd42b44ed2c.map */
--------------------------------------------------------------------------------
/public/styles/hljs/atom-one-light.min.css:
--------------------------------------------------------------------------------
1 | /**
2 | * Minified by jsDelivr using clean-css v4.2.3.
3 | * Original file: /npm/highlight.js@10.7.2/styles/atom-one-light.css
4 | *
5 | * Do NOT use SRI with dynamically generated files! More information: https://www.jsdelivr.com/using-sri-with-dynamic-files
6 | */
7 | .hljs{display:block;overflow-x:auto;padding:.5em;color:#383a42;background:#fafafa}.hljs-comment,.hljs-quote{color:#a0a1a7;font-style:italic}.hljs-doctag,.hljs-formula,.hljs-keyword{color:#a626a4}.hljs-deletion,.hljs-name,.hljs-section,.hljs-selector-tag,.hljs-subst{color:#e45649}.hljs-literal{color:#0184bb}.hljs-addition,.hljs-attribute,.hljs-meta-string,.hljs-regexp,.hljs-string{color:#50a14f}.hljs-built_in,.hljs-class .hljs-title{color:#c18401}.hljs-attr,.hljs-number,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-pseudo,.hljs-template-variable,.hljs-type,.hljs-variable{color:#986801}.hljs-bullet,.hljs-link,.hljs-meta,.hljs-selector-id,.hljs-symbol,.hljs-title{color:#4078f2}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:700}.hljs-link{text-decoration:underline}
8 | /*# sourceMappingURL=/sm/d76652e02644cc28bcf6e449c522da2442dcd1b6da7571da0fe4c284282c557e.map */
--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "deno-doc",
3 | "version": "0.1.0",
4 | "private": true,
5 | "scripts": {
6 | "dev": "next dev",
7 | "build": "next build",
8 | "start": "next start",
9 | "format": "prettier --write **.tsx **.ts **.js **.json"
10 | },
11 | "dependencies": {
12 | "@tailwindcss/ui": "^0.4.0",
13 | "isomorphic-unfetch": "^3.0.0",
14 | "next": "^12.0.4",
15 | "next-plugin-preact": "^3.0.6",
16 | "preact": "^10.5.15",
17 | "preact-render-to-string": "^5.1.19",
18 | "react": "npm:@preact/compat",
19 | "react-dom": "npm:@preact/compat",
20 | "react-markdown": "^4.3.1",
21 | "react-syntax-highlighter": "^13.0.0",
22 | "react-transition-group": "^4.4.1",
23 | "swr": "^0.2.3",
24 | "tailwindcss": "^1.5.2",
25 | "tailwindcss-prefers-dark-mode": "^1.2.0"
26 | },
27 | "devDependencies": {
28 | "@types/node": "^14.0.26",
29 | "@types/react": "^16.9.43",
30 | "@types/react-syntax-highlighter": "^11.0.4",
31 | "@types/react-transition-group": "^4.4.0",
32 | "autoprefixer": "^9.8.5",
33 | "prettier": "^2.0.5",
34 | "scheduler": "^0.20.2",
35 | "typescript": "^4.4.4",
36 | "webpack": "^5.64.1"
37 | }
38 | }
39 |
--------------------------------------------------------------------------------
/deploy/main.ts:
--------------------------------------------------------------------------------
1 | import { serve } from "https://deno.land/x/sift@0.2.0/mod.ts";
2 |
3 | const EXAMPLE_VERSION = "v1.9.0";
4 |
5 | serve({
6 | "/": () =>
7 | new Response(
8 | `
9 | serving lib.deno.d.ts23 | Members 24 |
25 | {node.enumDef.members.length > 0 ? ( 26 | node.enumDef.members.map((member) => { 27 | return
31 | This enum has no members.
32 |
33 | )}
34 | 10 | visit 11 | /builtin/stable, 12 | /builtin/${EXAMPLE_VERSION}, for example
13 |
14 | GitHub 15 | `, 16 | { status: 200, headers: { "content-type": "text/html" } }, 17 | ), 18 | "/builtin/:version": async (request, params) => { 19 | if (!params) { 20 | return notFound(); 21 | } 22 | const { version } = params; 23 | if (!version) { 24 | return notFound(); 25 | } 26 | // Handles "stable" version differently 27 | const dtsUrl = version === "stable" 28 | ? "https://github.com/denoland/deno/releases/latest/download/lib.deno.d.ts" 29 | : `https://github.com/denoland/deno/releases/download/${version}/lib.deno.d.ts`; 30 | const resp = await fetch(dtsUrl); 31 | if (resp.status !== 200) { 32 | return notFound(); 33 | } 34 | const isBrowser = request.headers.get("accept")?.includes("text/html"); 35 | // The headers on a `Response` are immutable 36 | const headers = new Headers(resp.headers); 37 | // Responses as plain text to browsers 38 | headers.set( 39 | "content-type", 40 | isBrowser ? "text/plain" : "application/typescript; charset=utf-8", 41 | ); 42 | // Prevents downloading the file 43 | headers.delete("content-disposition"); 44 | return new Response(resp.body, { ...resp, headers }); 45 | }, 46 | 404: () => notFound(), 47 | }); 48 | 49 | function notFound(): Response { 50 | return new Response(`not found
Back to Top`, { 51 | status: 404, 52 | headers: { "content-type": "text/html" }, 53 | }); 54 | } 55 | -------------------------------------------------------------------------------- /components/Variable.tsx: -------------------------------------------------------------------------------- 1 | // Copyright 2020 the Deno authors. All rights reserved. MIT license. 2 | 3 | import React from "react"; 4 | import { 5 | DocNodeVariable, 6 | TsTypeDefKind, 7 | TsTypeDefTypeLiteral, 8 | } from "../util/docs"; 9 | import { SimpleCard, SimpleSubCard } from "./SinglePage"; 10 | 11 | export function VariableCard({ 12 | node, 13 | nested, 14 | }: { 15 | node: DocNodeVariable; 16 | nested: boolean; 17 | }) { 18 | const type = node.variableDef.tsType; 19 | const isNamespace = 20 | node.variableDef.kind === "const" && 21 | type && 22 | type.kind === TsTypeDefKind.TypeLiteral && 23 | type.typeLiteral.properties.length > 0 && 24 | type.typeLiteral.methods.length === 0 && 25 | type.typeLiteral.callSignatures.length === 0; 26 | 27 | return isNamespace ? ( 28 |
56 | Properties 57 |
58 | {type.typeLiteral.properties.map((node) => { 59 | return ( 60 |
13 |
33 | ) : null;
34 | };
35 |
36 | export const Sidebar = ({ groups }: { groups: GroupedNodes }) => {
37 | return (
38 |
14 | {props.title}
15 |
16 |
17 | {props.nodes.map((node, i) => {
18 | const scope = node.scope ? node.scope.join(".") + "." : "";
19 | return (
20 |
32 | 24 | {scope} 25 | 26 | {node.name} 27 | 28 |
29 | ); 30 | })} 31 |
39 |
70 |
71 | );
72 | };
73 |
--------------------------------------------------------------------------------
/components/JSDoc.tsx:
--------------------------------------------------------------------------------
1 | // Copyright 2020 the Deno authors. All rights reserved. MIT license.
2 |
3 | import React from "react";
4 | import ReactMarkdown from "react-markdown";
5 | import { Light as SyntaxHighlighter } from "react-syntax-highlighter";
6 | import javascript from "react-syntax-highlighter/dist/cjs/languages/hljs/javascript";
7 | import typescript from "react-syntax-highlighter/dist/cjs/languages/hljs/typescript";
8 | SyntaxHighlighter.registerLanguage("js", javascript);
9 | SyntaxHighlighter.registerLanguage("ts", typescript);
10 |
11 | export function JSDoc(props: { jsdoc: string }) {
12 | let jsdoc = props.jsdoc
13 | .replace(/\n@param/g, "\n\n __param__")
14 | .replace(/\n@return/g, "\n\n __return__")
15 | // [link text]{@link https://www.link.com}
16 | .replace(/\[(.*?)\]{@link (.*?)}/g, (match, text, link): string => {
17 | return `[${text}](${link})`;
18 | })
19 | // {@link https://www.link.com|link text}
20 | .replace(/{@link (.*?)\|(.*?)}/g, (match, link, text): string => {
21 | return `[${text}](${link})`;
22 | })
23 | // {@link https://www.link.com link text}
24 | .replace(/{@link ([^}]*?) ([^}]*?)}/g, (match, link, text): string => {
25 | return `[${text}](${link})`
26 | })
27 | // {@link https://www.link.com}
28 | .replace(/{@link (.*?)}/g, (match, link): string => {
29 | return `[${link}](${link})`
30 | })
31 | // @deprecated reason
32 | .replace(/@deprecated/g, "__deprecated__");
33 |
34 | return (
35 |
47 |
51 |
52 | ),
53 | tableCell: (props) => (
54 |
70 | {props.children}
71 |
72 | );
73 | }
74 |
75 | export function CodeBlock(props: { value: string; language: string }) {
76 | return (
77 |
78 |
92 | {props.value}
93 |
94 |
95 | );
96 | }
97 |
--------------------------------------------------------------------------------
/components/Documentation.tsx:
--------------------------------------------------------------------------------
1 | // Copyright 2020 the Deno authors. All rights reserved. MIT license.
2 |
3 | import React, { useReducer, useEffect } from "react";
4 | import Link from "next/link";
5 | import Head from "next/head";
6 | import useSWR from "swr";
7 | import { getData, DocsData } from "../util/data";
8 | import { SinglePage } from "./SinglePage";
9 |
10 | export const Documentation = ({
11 | entrypoint,
12 | name,
13 | }: {
14 | entrypoint: string;
15 | name: string;
16 | }) => {
17 | const [loadCount, forceReload] = useReducer((i) => ++i, 0);
18 | const { data, error } = useSWR
50 |
63 | ) : null}
64 | {node.interfaceDef.properties.length > 0 ? (
65 | 51 | Call Signatures 52 |
53 | {node.interfaceDef.callSignatures.map((node) => { 54 | return ( 55 |
66 |
79 | ) : null}
80 | {node.interfaceDef.methods.length > 0 ? (
81 | 67 | Properties 68 |
69 | {node.interfaceDef.properties.map((node) => { 70 | return ( 71 |
82 |
96 | ) : null}
97 | {node.interfaceDef.indexSignatures.length > 0 ? (
98 | 83 | Methods 84 |
85 | {node.interfaceDef.methods.map((node) => { 86 | return ( 87 |
99 |
114 | ) : null}
115 |
116 | }
117 | />
118 | );
119 | }
120 |
--------------------------------------------------------------------------------
/public/logo.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/public/favicon.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/public/fonts/inter/inter.css:
--------------------------------------------------------------------------------
1 | @font-face {
2 | font-family: 'Inter';
3 | font-style: normal;
4 | font-weight: 100;
5 | font-display: swap;
6 | src: url("Inter-Thin.woff2?v=3.13") format("woff2"),
7 | url("Inter-Thin.woff?v=3.13") format("woff");
8 | }
9 | @font-face {
10 | font-family: 'Inter';
11 | font-style: italic;
12 | font-weight: 100;
13 | font-display: swap;
14 | src: url("Inter-ThinItalic.woff2?v=3.13") format("woff2"),
15 | url("Inter-ThinItalic.woff?v=3.13") format("woff");
16 | }
17 |
18 | @font-face {
19 | font-family: 'Inter';
20 | font-style: normal;
21 | font-weight: 200;
22 | font-display: swap;
23 | src: url("Inter-ExtraLight.woff2?v=3.13") format("woff2"),
24 | url("Inter-ExtraLight.woff?v=3.13") format("woff");
25 | }
26 | @font-face {
27 | font-family: 'Inter';
28 | font-style: italic;
29 | font-weight: 200;
30 | font-display: swap;
31 | src: url("Inter-ExtraLightItalic.woff2?v=3.13") format("woff2"),
32 | url("Inter-ExtraLightItalic.woff?v=3.13") format("woff");
33 | }
34 |
35 | @font-face {
36 | font-family: 'Inter';
37 | font-style: normal;
38 | font-weight: 300;
39 | font-display: swap;
40 | src: url("Inter-Light.woff2?v=3.13") format("woff2"),
41 | url("Inter-Light.woff?v=3.13") format("woff");
42 | }
43 | @font-face {
44 | font-family: 'Inter';
45 | font-style: italic;
46 | font-weight: 300;
47 | font-display: swap;
48 | src: url("Inter-LightItalic.woff2?v=3.13") format("woff2"),
49 | url("Inter-LightItalic.woff?v=3.13") format("woff");
50 | }
51 |
52 | @font-face {
53 | font-family: 'Inter';
54 | font-style: normal;
55 | font-weight: 400;
56 | font-display: swap;
57 | src: url("Inter-Regular.woff2?v=3.13") format("woff2"),
58 | url("Inter-Regular.woff?v=3.13") format("woff");
59 | }
60 | @font-face {
61 | font-family: 'Inter';
62 | font-style: italic;
63 | font-weight: 400;
64 | font-display: swap;
65 | src: url("Inter-Italic.woff2?v=3.13") format("woff2"),
66 | url("Inter-Italic.woff?v=3.13") format("woff");
67 | }
68 |
69 | @font-face {
70 | font-family: 'Inter';
71 | font-style: normal;
72 | font-weight: 500;
73 | font-display: swap;
74 | src: url("Inter-Medium.woff2?v=3.13") format("woff2"),
75 | url("Inter-Medium.woff?v=3.13") format("woff");
76 | }
77 | @font-face {
78 | font-family: 'Inter';
79 | font-style: italic;
80 | font-weight: 500;
81 | font-display: swap;
82 | src: url("Inter-MediumItalic.woff2?v=3.13") format("woff2"),
83 | url("Inter-MediumItalic.woff?v=3.13") format("woff");
84 | }
85 |
86 | @font-face {
87 | font-family: 'Inter';
88 | font-style: normal;
89 | font-weight: 600;
90 | font-display: swap;
91 | src: url("Inter-SemiBold.woff2?v=3.13") format("woff2"),
92 | url("Inter-SemiBold.woff?v=3.13") format("woff");
93 | }
94 | @font-face {
95 | font-family: 'Inter';
96 | font-style: italic;
97 | font-weight: 600;
98 | font-display: swap;
99 | src: url("Inter-SemiBoldItalic.woff2?v=3.13") format("woff2"),
100 | url("Inter-SemiBoldItalic.woff?v=3.13") format("woff");
101 | }
102 |
103 | @font-face {
104 | font-family: 'Inter';
105 | font-style: normal;
106 | font-weight: 700;
107 | font-display: swap;
108 | src: url("Inter-Bold.woff2?v=3.13") format("woff2"),
109 | url("Inter-Bold.woff?v=3.13") format("woff");
110 | }
111 | @font-face {
112 | font-family: 'Inter';
113 | font-style: italic;
114 | font-weight: 700;
115 | font-display: swap;
116 | src: url("Inter-BoldItalic.woff2?v=3.13") format("woff2"),
117 | url("Inter-BoldItalic.woff?v=3.13") format("woff");
118 | }
119 |
120 | @font-face {
121 | font-family: 'Inter';
122 | font-style: normal;
123 | font-weight: 800;
124 | font-display: swap;
125 | src: url("Inter-ExtraBold.woff2?v=3.13") format("woff2"),
126 | url("Inter-ExtraBold.woff?v=3.13") format("woff");
127 | }
128 | @font-face {
129 | font-family: 'Inter';
130 | font-style: italic;
131 | font-weight: 800;
132 | font-display: swap;
133 | src: url("Inter-ExtraBoldItalic.woff2?v=3.13") format("woff2"),
134 | url("Inter-ExtraBoldItalic.woff?v=3.13") format("woff");
135 | }
136 |
137 | @font-face {
138 | font-family: 'Inter';
139 | font-style: normal;
140 | font-weight: 900;
141 | font-display: swap;
142 | src: url("Inter-Black.woff2?v=3.13") format("woff2"),
143 | url("Inter-Black.woff?v=3.13") format("woff");
144 | }
145 | @font-face {
146 | font-family: 'Inter';
147 | font-style: italic;
148 | font-weight: 900;
149 | font-display: swap;
150 | src: url("Inter-BlackItalic.woff2?v=3.13") format("woff2"),
151 | url("Inter-BlackItalic.woff?v=3.13") format("woff");
152 | }
153 |
154 | /* -------------------------------------------------------
155 | Variable font.
156 | Usage:
157 |
158 | html { font-family: 'Inter', sans-serif; }
159 | @supports (font-variation-settings: normal) {
160 | html { font-family: 'Inter var', sans-serif; }
161 | }
162 | */
163 | @font-face {
164 | font-family: 'Inter var';
165 | font-weight: 100 900;
166 | font-display: swap;
167 | font-style: normal;
168 | font-named-instance: 'Regular';
169 | src: url("Inter-roman.var.woff2?v=3.13") format("woff2");
170 | }
171 | @font-face {
172 | font-family: 'Inter var';
173 | font-weight: 100 900;
174 | font-display: swap;
175 | font-style: italic;
176 | font-named-instance: 'Italic';
177 | src: url("Inter-italic.var.woff2?v=3.13") format("woff2");
178 | }
179 |
180 |
181 | /* --------------------------------------------------------------------------
182 | [EXPERIMENTAL] Multi-axis, single variable font.
183 |
184 | Slant axis is not yet widely supported (as of February 2019) and thus this
185 | multi-axis single variable font is opt-in rather than the default.
186 |
187 | When using this, you will probably need to set font-variation-settings
188 | explicitly, e.g.
189 |
190 | * { font-variation-settings: "slnt" 0deg }
191 | .italic { font-variation-settings: "slnt" 10deg }
192 |
193 | */
194 | @font-face {
195 | font-family: 'Inter var experimental';
196 | font-weight: 100 900;
197 | font-display: swap;
198 | font-style: oblique 0deg 10deg;
199 | src: url("Inter.var.woff2?v=3.13") format("woff2");
200 | }
201 |
--------------------------------------------------------------------------------
/pages/index.tsx:
--------------------------------------------------------------------------------
1 | // Copyright 2020 the Deno authors. All rights reserved. MIT license.
2 |
3 | import Head from "next/head";
4 | import { useRouter } from "next/router";
5 | import Link from "next/link";
6 | import { useState } from "react";
7 | import Header from "../components/Header";
8 | import Footer from "../components/Footer";
9 |
10 | const examples = [
11 | "deno.land/std/http/mod.ts",
12 | "deno.land/std/fs/mod.ts",
13 | "deno.land/x/oak/mod.ts",
14 | "deno.land/x/redis/mod.ts",
15 | "deno.land/x/amqp/mod.ts",
16 | "cdn.pika.dev/lodash-es",
17 | "deno.land/std/archive/tar.ts",
18 | "deno.land/std/node/module.ts",
19 | ];
20 |
21 | function Home() {
22 | const router = useRouter();
23 | const [url, setUrl] = useState("");
24 | function navigate() {
25 | router.push(
26 | "/https/[...url]",
27 | "/https/" +
28 | encodeURIComponent(url.replace("https://", "").replace("http://", ""))
29 | );
30 | }
31 | return (
32 | <>
33 |
34 | 100 | Index Signatures 101 |
102 | {node.interfaceDef.indexSignatures.map((node) => { 103 | return ( 104 |
42 |
122 |
123 | );
124 | }
125 |
126 | export default Home;
127 |
--------------------------------------------------------------------------------
/pages/about.tsx:
--------------------------------------------------------------------------------
1 | import Head from "next/head";
2 | import Link from "next/link";
3 | import { CodeBlock, InlineCode } from "../components/JSDoc";
4 | import Header from "../components/Header";
5 | import Footer from "../components/Footer";
6 |
7 | function About() {
8 | return (
9 |
43 |
97 |
45 |
46 |
47 |
53 |
54 |
55 |
58 |
96 |
59 |
95 |
60 |
63 | setUrl(e.target.value)}
70 | onKeyDown={(e) => {
71 | if (e.key === "Enter" && url.length > 0) navigate();
72 | }}
73 | />
74 |
75 |
94 |
98 |
120 |
121 |
99 | View{" "}
100 |
109 |
101 | --unstable
102 | {" "}
103 | runtime documentation{" "}
104 |
105 | here
106 |
107 | .
108 | Some examples:
110 | -
111 | {examples.map((example) => (
112 |
- 113 | 114 | https://{example} 115 | 116 | 117 | ))} 118 |
10 |
11 | About deno doc
12 |
16 |
17 |
148 | );
149 | }
150 |
151 | export default About;
152 |
--------------------------------------------------------------------------------
/components/Footer.tsx:
--------------------------------------------------------------------------------
1 | /* Copyright 2020 the Deno authors. All rights reserved. MIT license. */
2 |
3 | import React from "react";
4 | import Link from "next/link";
5 |
6 | const Footer = (props: { simple?: boolean }) => (
7 |
19 |
146 |
147 | About
20 |
21 |
34 | 22 | doc.deno.land hosts documentation for TypeScript and ES module files 23 | available on the public internet that use ES module import syntax 24 | with URLs. 25 |
26 |27 | The source code is available on{" "} 28 | 29 | GitHub 30 | 31 | . 32 |
33 |
35 |
53 | 39 | Adding a module to deno doc 40 |
41 |42 | doc.deno.land dynamically pulls a module from the specified URL and 43 | generates documentation for it when it is first viewed. You do not 44 | need to manually register a module on doc.deno.land to make it 45 | available. 46 |
47 |48 | doc.deno.land caches generated documentation for 24 hours. After 49 | this time the generated documentation is removed from the cache and 50 | the module is treated as if it had never been requested before. 51 |
52 |
54 |
71 | 58 | Removing a module from deno doc 59 |
60 |61 | You can not manually remove modules from doc.deno.land as they 62 | expire automatically after 24 hours. If there is an urgent reason to 63 | remove a module from the cache, please reach out to one of the Deno 64 | maintainers on the{" "} 65 | 66 | Deno discord 67 | 68 | . 69 |
70 |
72 | 
84 |
99 | 73 | Badges 74 |
75 |76 | Below are examples of some snippets that you can use to link to 77 | doc.deno.land from your project website or README.{" "} 78 | 79 | Don't forget to replace the doc.deno.land url with the one for 80 | your module. 81 | 82 |
83 |
84 |
85 | HTML
86 | 
`}
89 | />
90 |
91 | `}
89 | />
90 |
92 | Markdown
93 |
98 |
100 |
127 | 104 | Limitations 105 |
106 |
107 |
126 | 108 | doc.deno.land currently has some limitations that you should be 109 | aware of: 110 |
111 |-
112 |
- 113 | The time to pull source files and generate documentation from 114 | these may not exceed 58 seconds. If you are running into a 115 | timeout issue because of this, please open an issue on{" "} 116 | 120 | GitHub 121 | {" "} 122 | with a link to the module that is timing out. 123 | 124 |
128 |
145 | 129 | Feedback 130 |
131 |132 | On our{" "} 133 | 134 | GitHub 135 | {" "} 136 | you can open an issue to share any ideas, feature requests, 137 | questions, or issues you are having. For general discussion about 138 | Deno or doc.deno.land, please use our{" "} 139 | 140 | Discord server 141 | 142 | . 143 |
144 |
14 |
112 | );
113 |
114 | export default Footer;
115 |
--------------------------------------------------------------------------------
/components/Loading.tsx:
--------------------------------------------------------------------------------
1 | export const Loading = () => (
2 |
210 | );
211 |
--------------------------------------------------------------------------------
/components/Header.tsx:
--------------------------------------------------------------------------------
1 | /* Copyright 2020 the Deno authors. All rights reserved. MIT license. */
2 |
3 | import React, { useState } from "react";
4 | import Link from "next/link";
5 | import Transition from "./Transition";
6 |
7 | const Header = () => {
8 | const [menuOpen, setMenuOpen] = useState(false);
9 |
10 | return (
11 |
15 |
40 |
73 |
110 |
111 | 
80 | 
87 | 
94 | 
101 | 
108 |
12 |
90 |
91 |
100 |
166 |
167 | );
168 | };
169 |
170 | export default Header;
171 |
--------------------------------------------------------------------------------
/components/Class.tsx:
--------------------------------------------------------------------------------
1 | // Copyright 2020 the Deno authors. All rights reserved. MIT license.
2 |
3 | import React from "react";
4 | import {
5 | DocNodeClass,
6 | getLinkByScopedName,
7 | getFieldsForClassRecursive,
8 | TsTypeParamDef,
9 | } from "../util/docs";
10 | import { SimpleCard, SimpleSubCard } from "./SinglePage";
11 | import { useFlattend, useRuntimeBuiltins } from "../util/data";
12 | import Link from "next/link";
13 | import { TsType, LinkRef } from "./TsType";
14 |
15 | export function ClassCard({
16 | node,
17 | nested,
18 | }: {
19 | node: DocNodeClass;
20 | nested: boolean;
21 | }) {
22 | const constructors = node.classDef.constructors;
23 | const indexSignatures = node.classDef.indexSignatures;
24 |
25 | const flattend = useFlattend();
26 | const fullClass = getFieldsForClassRecursive(flattend, node);
27 |
28 | const properties = fullClass.properties.filter(
29 | (node) => node.accessibility !== "private"
30 | );
31 | const realProperties = properties.filter((node) => !node.isStatic);
32 | const staticProperties = properties.filter((node) => node.isStatic);
33 | const methods = fullClass.methods.filter(
34 | (node) => node.accessibility !== "private"
35 | );
36 | const realMethods = methods.filter((node) => !node.isStatic);
37 | const staticMethods = methods.filter((node) => node.isStatic);
38 |
39 | const parent = node;
40 |
41 | const { extends: extends_ } = node.classDef;
42 | const runtimeBuiltins = useRuntimeBuiltins();
43 | const extendsLink = extends_
44 | ? getLinkByScopedName(flattend, runtimeBuiltins, extends_, node.scope ?? [])
45 | : undefined;
46 |
47 | return (
48 |
101 |
165 |
102 |
164 |
103 |
163 |
104 |
105 |
106 | 
111 |
143 |
162 |
111 |
112 |
119 |
120 | {" "}
121 |
113 | deno doc
114 |
115 |
116 | Documentation Generator
117 |
118 |
122 |
141 |
142 |
107 |
119 | ) : null}
120 | {realProperties.length > 0 ? (
121 | 108 | Constructors 109 |
110 | {constructors.map((node) => { 111 | return ( 112 |
122 |
140 | ) : null}
141 | {realMethods.length > 0 ? (
142 | 123 | Properties 124 |
125 | {realProperties.map((node) => { 126 | return ( 127 |
143 |
166 | ) : null}
167 | {indexSignatures.length > 0 ? (
168 | 144 | Methods 145 |
146 | {realMethods.map((node) => { 147 | return ( 148 |
169 |
183 | ) : null}
184 | {staticProperties.length > 0 ? (
185 | 170 | Index Signatures 171 |
172 | {indexSignatures.map((node) => { 173 | return ( 174 |
186 |
204 | ) : null}
205 | {staticMethods.length > 0 ? (
206 | 187 | Static Properties 188 |
189 | {staticProperties.map((node) => { 190 | return ( 191 |
207 |
230 | ) : null}
231 |
232 | }
233 | />
234 | );
235 | }
236 |
237 | export function TypeParams({
238 | params,
239 | scope,
240 | }: {
241 | params: TsTypeParamDef[];
242 | scope: string[];
243 | }) {
244 | return (
245 | <>
246 | {params
247 | .map((p) => {
248 | return (
249 | <>
250 | {p.name}
251 | {p.constraint ? (
252 | <>
253 | {" "}
254 | extends 208 | Static Methods 209 |
210 | {staticMethods.map((node) => { 211 | return ( 212 |
22 |
23 |
117 |
220 | );
221 | }
222 |
--------------------------------------------------------------------------------
/components/SinglePage.tsx:
--------------------------------------------------------------------------------
1 | // Copyright 2020 the Deno authors. All rights reserved. MIT license.
2 |
3 | import React, { useMemo, memo } from "react";
4 | import {
5 | DocsData,
6 | FlattendProvider,
7 | RuntimeBuiltinsProvider,
8 | } from "../util/data";
9 | import {
10 | DocNodeShared,
11 | ParamDef,
12 | TsTypeDef,
13 | DocNodeLocation,
14 | expandNamespaces,
15 | flattenNamespaces,
16 | GroupedNodes,
17 | groupNodes,
18 | sortByAlphabet,
19 | normalizeFilename,
20 | } from "../util/docs";
21 | import { JSDoc } from "./JSDoc";
22 | import { ClassCard } from "./Class";
23 | import { TsType } from "./TsType";
24 | import { FunctionCard, Params } from "./Function";
25 | import { EnumCard } from "./Enum";
26 | import { InterfaceCard } from "./Interface";
27 | import { VariableCard } from "./Variable";
28 | import { TypeAliasCard } from "./TypeAlias";
29 | import { Wrapper } from "./Wrapper";
30 | import { NamespaceCard } from "./Namespace";
31 | import { Loading } from "./Loading";
32 |
33 | export const SinglePage = memo(
34 | (props: {
35 | forceReload: () => void;
36 | entrypoint: string;
37 | data: DocsData | undefined;
38 | runtimeBuiltinsData: DocsData | undefined;
39 | }) => {
40 | if (!props.data) {
41 | return (
42 |
24 |
116 |
25 |
33 |
40 |
48 |
111 |
115 |
34 |
38 |
39 |
49 |
110 |
50 |
70 |
71 |
72 |
73 |
74 |
79 |
88 | {props.timestamp ? (
89 |
106 | ) : null}
107 |
108 | {props.groups ?
79 |
80 |
84 |
85 |
86 | {props.groups ? (
87 |
81 | deno doc
82 |
83 |
90 | Last refreshed{" "}
91 | {new Date(props.timestamp).toLocaleString()}.{" "}
92 |
96 | Refresh now
97 |
98 |
99 | ) : null}
100 | 101 | 102 | About doc.deno.land 103 | 104 |
105 |
112 | {/**/}
113 |
114 |
118 |
154 |
119 |
153 |
120 |
121 |
122 |
123 |
132 | {props.timestamp ? (
133 |
149 | ) : null}
150 |
151 | {props.groups ?
123 |
124 |
128 |
129 |
130 | {props.groups ? (
131 |
125 | deno doc
126 |
127 |
134 | Last refreshed {new Date(props.timestamp).toLocaleString()}.{" "}
135 |
139 | Refresh now
140 |
141 |
142 | ) : null}
143 | 144 | 145 | About doc.deno.land 146 | 147 |
148 |
155 |
216 | {props.children}
217 |
218 |
219 |
156 |
157 |
158 |
159 |
160 |
161 |
211 |
212 |
159 |
160 |
161 |
162 |
191 |
210 |
163 | {/*
190 |
164 |
167 |
*/}
189 |
168 |
188 |
169 |
180 |
181 |
187 |
49 |
54 |
51 | It can take a few seconds for documentation to be generated.
52 |
53 |
84 |
100 |
85 |
89 | {props.entrypoint}
90 |
91 | {hasNone ? (
92 |
99 | 93 | This module has no exports that are recognized by deno doc. 94 |
95 | ) : ( 96 |
113 | {!nested && (
114 |
128 | ) : null}
129 | {groups.variables.length > 0 ? (
130 |
115 | Functions
116 |
117 | )}
118 |
119 | {groups.functions.map((node, i) => (
120 |
127 |
131 | {!nested && (
132 |
146 | ) : null}
147 | {groups.classes.length > 0 ? (
148 |
133 | Variables
134 |
135 | )}
136 |
137 | {groups.variables.map((node, i) => (
138 |
145 |
149 | {!nested && (
150 |
164 | ) : null}
165 | {groups.enums.length > 0 ? (
166 |
151 | Classes
152 |
153 | )}
154 |
155 | {groups.classes.map((node, i) => (
156 |
163 |
167 | {!nested && (
168 |
182 | ) : null}
183 | {groups.interfaces.length > 0 ? (
184 |
169 | Enums
170 |
171 | )}
172 |
173 | {groups.enums.map((node, i) => (
174 |
181 |
185 | {!nested && (
186 |
200 | ) : null}
201 | {groups.typeAliases.length > 0 ? (
202 |
187 | Interfaces
188 |
189 | )}
190 |
191 | {groups.interfaces.map((node, i) => (
192 |
199 |
203 | {!nested && (
204 |
218 | ) : null}
219 | {groups.namespaces.length > 0 ? (
220 |
205 | Type Aliases
206 |
207 | )}
208 |
209 | {groups.typeAliases.map((node, i) => (
210 |
217 |
221 | {!nested && (
222 |
236 | ) : null}
237 |
238 | );
239 | }
240 | );
241 |
242 | export function SimpleCard({
243 | node,
244 | prefix,
245 | details,
246 | suffix,
247 | params,
248 | returnType,
249 | nested,
250 | }: {
251 | node: DocNodeShared & { kind?: string };
252 | prefix?: string;
253 | details?: React.ReactNode;
254 | suffix?: React.ReactNode;
255 | params?: ParamDef[];
256 | returnType?: TsTypeDef;
257 | nested: boolean;
258 | }) {
259 | const id = (node.scope ?? []).concat(node.name).join(".");
260 | return (
261 |
223 | Namespaces
224 |
225 | )}
226 |
227 | {groups.namespaces.map((node, i) => (
228 |
235 |
268 |
318 | );
319 | }
320 |
321 | export function SimpleSubCard({
322 | node,
323 | prefix,
324 | optional,
325 | computedParams,
326 | params,
327 | returnType,
328 | }: {
329 | node: Omit
269 |
309 |
310 | {node.jsDoc ? (
311 |
270 | {prefix ? {prefix} : null}
271 | {node.scope?.map((s, i) => (
272 | <>
273 |
277 | {s}
278 |
279 | .
280 |
281 | ))}
282 |
283 | {node.name}
284 |
285 | {params ? (
286 |
287 | (
298 |
306 | [src]
307 |
308 |
312 |
314 | ) : null}
315 |
316 | {details}
317 |
344 |
393 | );
394 | }
395 |
--------------------------------------------------------------------------------
/util/docs.ts:
--------------------------------------------------------------------------------
1 | // Copyright 2020 the Deno authors. All rights reserved. MIT license.
2 |
3 | import { schoolBook } from "react-syntax-highlighter/dist/esm/styles/hljs";
4 |
5 | export enum DocNodeKind {
6 | Function = "function",
7 | Variable = "variable",
8 | Class = "class",
9 | Enum = "enum",
10 | Interface = "interface",
11 | TypeAlias = "typeAlias",
12 | Namespace = "namespace",
13 | Import = "import",
14 | }
15 | export interface DocNodeLocation {
16 | filename: string;
17 | line: number;
18 | col: number;
19 | }
20 | export interface DocNodeShared {
21 | name: string;
22 | scope?: string[];
23 | location: DocNodeLocation;
24 | jsDoc?: string;
25 | }
26 | export interface TsTypeParamDef {
27 | name: string;
28 | constraint?: TsTypeDef;
29 | default?: TsTypeDef;
30 | }
31 | export interface TsTypeRefDef {
32 | typeName: string;
33 | typeParams?: TsTypeDef[];
34 | }
35 | export interface TsTypeOperatorDef {
36 | operator: string;
37 | tsType: TsTypeDef;
38 | }
39 | export interface TsFnOrConstructorDef {
40 | constructor: boolean;
41 | tsType: TsTypeDef;
42 | params: ParamDef[];
43 | }
44 | export interface TsConditionalDef {
45 | checkType: TsTypeDef;
46 | extendsType: TsTypeDef;
47 | trueType: TsTypeDef;
48 | falseType: TsTypeDef;
49 | }
50 | export interface TsIndexedAccessDef {
51 | readonly: boolean;
52 | objType: TsTypeDef;
53 | indexType: TsTypeDef;
54 | }
55 | export interface TsTypeLiteralDef {
56 | methods: LiteralMethodDef[];
57 | properties: LiteralPropertyDef[];
58 | callSignatures: LiteralCallSignatureDef[];
59 | indexSignatures: LiteralIndexSignatureDef[];
60 | }
61 | export interface TsTypePredicateDef {
62 | asserts: boolean;
63 | param: {
64 | type: "this";
65 | } | {
66 | type: "identifier";
67 | name: string;
68 | };
69 | type: TsTypeDef | null;
70 | }
71 | export interface LiteralMethodDef {
72 | name: string;
73 | params: ParamDef[];
74 | returnType?: TsTypeDef;
75 | }
76 | export interface LiteralPropertyDef {
77 | name: string;
78 | computed: boolean;
79 | optional: boolean;
80 | tsType?: TsTypeDef;
81 | }
82 | export interface LiteralCallSignatureDef {
83 | params: ParamDef[];
84 | tsType?: TsTypeDef;
85 | }
86 | export interface LiteralIndexSignatureDef {
87 | readonly: boolean;
88 | params: ParamDef[];
89 | tsType?: TsTypeDef;
90 | }
91 | export interface LiteralMethodDef {
92 | params: ParamDef[];
93 | returnType?: TsTypeDef;
94 | }
95 | export enum LiteralDefKind {
96 | Number = "number",
97 | String = "string",
98 | Boolean = "boolean",
99 | }
100 | export type LiteralDef =
101 | | {
102 | kind: LiteralDefKind.Number;
103 | number: number;
104 | }
105 | | {
106 | kind: LiteralDefKind.String;
107 | string: string;
108 | }
109 | | {
110 | kind: LiteralDefKind.Boolean;
111 | boolean: boolean;
112 | };
113 | export enum TsTypeDefKind {
114 | Keyword = "keyword",
115 | Literal = "literal",
116 | TypeRef = "typeRef",
117 | Union = "union",
118 | Intersection = "intersection",
119 | Array = "array",
120 | Tuple = "tuple",
121 | TypeOperator = "typeOperator",
122 | Parenthesized = "parenthesized",
123 | Rest = "rest",
124 | Optional = "optional",
125 | TypeQuery = "typeQuery",
126 | This = "this",
127 | FnOrConstructor = "fnOrConstructor",
128 | Conditional = "conditional",
129 | IndexedAccess = "indexedAccess",
130 | TypeLiteral = "typeLiteral",
131 | TypePredicate = "typePredicate",
132 | }
133 | export interface TsTypeDefShared {
134 | repr: string;
135 | }
136 | export interface TsTypeDefArray extends TsTypeDefShared {
137 | kind: TsTypeDefKind.Array;
138 | array: TsTypeDef;
139 | }
140 | export interface TsTypeDefConditional extends TsTypeDefShared {
141 | kind: TsTypeDefKind.Conditional;
142 | conditionalType: TsConditionalDef;
143 | }
144 | export interface TsTypeDefFnOrConstructor extends TsTypeDefShared {
145 | kind: TsTypeDefKind.FnOrConstructor;
146 | fnOrConstructor: TsFnOrConstructorDef;
147 | }
148 | export interface TsTypeDefIndexedAccess extends TsTypeDefShared {
149 | kind: TsTypeDefKind.IndexedAccess;
150 | indexedAccess: TsIndexedAccessDef;
151 | }
152 | export interface TsTypeDefIntersection extends TsTypeDefShared {
153 | kind: TsTypeDefKind.Intersection;
154 | intersection: TsTypeDef[];
155 | }
156 | export interface TsTypeDefKeyword extends TsTypeDefShared {
157 | kind: TsTypeDefKind.Keyword;
158 | keyword: string;
159 | }
160 | export interface TsTypeDefLiteral extends TsTypeDefShared {
161 | kind: TsTypeDefKind.Literal;
162 | literal: LiteralDef;
163 | }
164 | export interface TsTypeDefOptional extends TsTypeDefShared {
165 | kind: TsTypeDefKind.Optional;
166 | optional: TsTypeDef;
167 | }
168 | export interface TsTypeDefParenthesized extends TsTypeDefShared {
169 | kind: TsTypeDefKind.Parenthesized;
170 | parenthesized: TsTypeDef;
171 | }
172 | export interface TsTypeDefTypePredicate extends TsTypeDefShared {
173 | kind: TsTypeDefKind.TypePredicate;
174 | typePredicate: TsTypePredicateDef;
175 | }
176 | export interface TsTypeDefRest extends TsTypeDefShared {
177 | kind: TsTypeDefKind.Rest;
178 | rest: TsTypeDef;
179 | }
180 | export interface TsTypeDefThis extends TsTypeDefShared {
181 | kind: TsTypeDefKind.This;
182 | this: boolean;
183 | }
184 | export interface TsTypeDefTuple extends TsTypeDefShared {
185 | kind: TsTypeDefKind.Tuple;
186 | tuple: TsTypeDef[];
187 | }
188 | export interface TsTypeDefTypeLiteral extends TsTypeDefShared {
189 | kind: TsTypeDefKind.TypeLiteral;
190 | typeLiteral: TsTypeLiteralDef;
191 | }
192 | export interface TsTypeDefTypeOperator extends TsTypeDefShared {
193 | kind: TsTypeDefKind.TypeOperator;
194 | typeOperator: TsTypeOperatorDef;
195 | }
196 | export interface TsTypeDefTypeQuery extends TsTypeDefShared {
197 | kind: TsTypeDefKind.TypeQuery;
198 | typeQuery: string;
199 | }
200 | export interface TsTypeDefTypeRef extends TsTypeDefShared {
201 | kind: TsTypeDefKind.TypeRef;
202 | typeRef: TsTypeRefDef;
203 | }
204 | export interface TsTypeDefUnion extends TsTypeDefShared {
205 | kind: TsTypeDefKind.Union;
206 | union: TsTypeDef[];
207 | }
208 | export type TsTypeDef =
209 | | TsTypeDefArray
210 | | TsTypeDefConditional
211 | | TsTypeDefFnOrConstructor
212 | | TsTypeDefIndexedAccess
213 | | TsTypeDefIntersection
214 | | TsTypeDefKeyword
215 | | TsTypeDefLiteral
216 | | TsTypeDefOptional
217 | | TsTypeDefParenthesized
218 | | TsTypeDefRest
219 | | TsTypeDefThis
220 | | TsTypeDefTuple
221 | | TsTypeDefTypeLiteral
222 | | TsTypeDefTypeOperator
223 | | TsTypeDefTypePredicate
224 | | TsTypeDefTypeQuery
225 | | TsTypeDefTypeRef
226 | | TsTypeDefUnion;
227 |
228 | export type ParamDef =
229 | | {
230 | kind: "array";
231 | elements: (ParamDef | null)[];
232 | optional: boolean;
233 | tsType?: TsTypeDef;
234 | }
235 | | {
236 | kind: "assign";
237 | left: ParamDef;
238 | right: string;
239 | tsType?: TsTypeDef;
240 | }
241 | | {
242 | kind: "identifier";
243 | name: string;
244 | optional: boolean;
245 | tsType?: TsTypeDef;
246 | }
247 | | {
248 | kind: "object";
249 | props: ObjectPatPropDef[];
250 | optional: boolean;
251 | tsType?: TsTypeDef;
252 | }
253 | | {
254 | kind: "rest";
255 | arg: ParamDef;
256 | tsType?: TsTypeDef;
257 | };
258 | export type ObjectPatPropDef =
259 | | {
260 | kind: "assign";
261 | key: string;
262 | value?: string;
263 | }
264 | | {
265 | kind: "keyValue";
266 | key: string;
267 | value: ParamDef;
268 | }
269 | | {
270 | kind: "rest";
271 | arg: ParamDef;
272 | };
273 | export interface FunctionDef {
274 | params: ParamDef[];
275 | returnType?: TsTypeDef;
276 | isAsync: boolean;
277 | isGenerator: boolean;
278 | }
279 | export interface VariableDef {
280 | tsType: TsTypeDef;
281 | kind: "var" | "let" | "const";
282 | }
283 | export type Accessibility = "public" | "protected" | "private";
284 | export interface ClassConstructorDef extends DocNodeShared {
285 | accessibility?: Accessibility;
286 | params: ParamDef[];
287 | }
288 | export interface ClassPropertyDef extends DocNodeShared {
289 | tsType: TsTypeDef;
290 | readonly: boolean;
291 | accessibility?: Accessibility;
292 | optional: boolean;
293 | isAbstract: boolean;
294 | isStatic: boolean;
295 | }
296 | export interface ClassMethodDef extends DocNodeShared {
297 | accessibility?: Accessibility;
298 | optional: boolean;
299 | isAbstract: boolean;
300 | isStatic: boolean;
301 | kind: "method" | "getter" | "setter";
302 | functionDef: FunctionDef;
303 | }
304 | export interface ClassDef {
305 | isAbstract: boolean;
306 | constructors: ClassConstructorDef[];
307 | properties: ClassPropertyDef[];
308 | indexSignatures: ClassIndexSignatureDef[];
309 | methods: ClassMethodDef[];
310 | extends?: string;
311 | implements: TsTypeDef[];
312 | typeParams: TsTypeParamDef[];
313 | superTypeParams: TsTypeDef[];
314 | }
315 | export interface ClassIndexSignatureDef {
316 | readonly: boolean;
317 | params: ParamDef[];
318 | tsType?: TsTypeDef;
319 | }
320 | export interface EnumMemberDef {
321 | name: string;
322 | }
323 | export interface EnumDef {
324 | members: EnumMemberDef[];
325 | }
326 |
327 | export interface InterfaceMethodDef extends DocNodeShared {
328 | params: ParamDef[];
329 | optional: boolean;
330 | returnType?: TsTypeDef;
331 | }
332 |
333 | export interface InterfacePropertyDef extends DocNodeShared {
334 | computed: boolean;
335 | optional: boolean;
336 | tsType?: TsTypeDef;
337 | }
338 |
339 | export interface InterfaceCallSignatureDef extends Omit
345 |
387 | {node.jsDoc ? (
388 |
351 | {node.inherited ? (
352 | inherited
353 | ) : null}
354 | {prefix ? {prefix} : null}
355 | {node.name}
356 | {optional ? "?" : ""}
357 | {computedParams ? (
358 | <>
359 | [
374 | {node.location ? (
375 |
383 | [src]
384 |
385 | ) : null}
386 |
389 |
391 | ) : null}
392 |