\n \n {doc.name}\n \n

\n \n source\n \n

\n\n {doc.signature && (\n

\n          {doc.signature}\n

\n )}\n\n

\n {doc.description}\n

\n\n {doc.tags.param && doc.tags.param.length > 0 && (\n

\n Parameters\n

\n {param.name} – {param.description.replace(/^ *-/, \"\")}\n

\n )}\n\n {(doc.tags.returns || doc.tags.return) &&\n (doc.tags.returns || doc.tags.return).length > 0 && (\n

Returns

{(doc.tags.returns || doc.tags.return)[0]}

\n )}\n\n {doc.tags.example && doc.tags.example.length > 0 && (\n

Example

\n            {doc.tags.example.join('\\n\\n').replace(\"```ts\\n\", \"\").replace(\"```\", \"\")}\n

\n )}\n

\n );\n}\n\napp.get(\"/\", async (c) => {\n // Extract docs from all utility files\n const files = [\n \"file.ts\",\n \"serve-file.ts\",\n \"parseImportMeta.ts\",\n \"is-main.ts\",\n \"test.tsx\",\n \"static.tsx\",\n \"import-latest.ts\",\n ];\n const allDocs = await Promise.all(files.map((file) => extractDocs(file)));\n const docs = allDocs.flat();\n\n // Filter to only documented functions\n const documentedFunctions = docs.filter((d) => d.description);\n\n // Group functions by category\n const categories = {\n \"File Operations\": [\n \"readFile\",\n \"listFiles\",\n \"listFilesByPath\",\n \"httpEndpoint\",\n \"emailAddress\",\n \"getValId\",\n \"fetchTranspiledJavaScript\",\n ],\n \"HTTP Utilities\": [\"serveFile\", \"getContentType\", \"staticHTTPServer\"],\n \"Val Metadata\": [\"parseVal\", \"isMain\"],\n \"Module Utilities\": [\"importLatest\"],\n \"Testing\": [\"testServer\"],\n };\n\n return c.render(\n \n \n \n Val Town Utils Documentation\n \n \n \n \n \n \n \n

\n \n

\n Val Town Utils Documentation\n

\n \n View val on Val Town\n \n \n

\n @std/utils is a collection of utilities Val Town, including\n reading files, serving static content, getting Val Town metadata,\n and more.\n

\n\n

\n\n {documentedFunctions.map((doc) => (\n \n ))}\n

\n \n ,\n );\n});\n\napp.onError((err) => Promise.reject(err));\n\nexport default app.fetch;","deleted","label",[100],"permalink","https://www.val.town/x/pql/utils/code/_docs.tsx","extension","actionData","errors"]