@vellum-docs/profile-markdown 0.1.0
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/dist/index.d.mts +15 -0
- package/dist/index.d.mts.map +1 -0
- package/dist/index.mjs +34 -0
- package/dist/index.mjs.map +1 -0
- package/package.json +32 -0
package/dist/index.d.mts
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { RenderContext, RendererProfile, Symbol, TypeString } from "@vellum-docs/core";
|
|
2
|
+
|
|
3
|
+
//#region src/index.d.ts
|
|
4
|
+
declare class MarkdownProfile implements RendererProfile {
|
|
5
|
+
readonly name = "markdown";
|
|
6
|
+
readonly targetExtensions: readonly [".md", ".mdx"];
|
|
7
|
+
typeRef(sym: Symbol, _ctx: RenderContext): string;
|
|
8
|
+
signature(sym: Symbol, _ctx: RenderContext): string;
|
|
9
|
+
typeString(ts: TypeString, _ctx: RenderContext): string;
|
|
10
|
+
typeCard(sym: Symbol, ctx: RenderContext): string;
|
|
11
|
+
link(sym: Symbol, _ctx: RenderContext): string;
|
|
12
|
+
}
|
|
13
|
+
//#endregion
|
|
14
|
+
export { MarkdownProfile };
|
|
15
|
+
//# sourceMappingURL=index.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAaa,eAAA,YAA2B,eAAA;EAAA,SAC7B,IAAA;EAAA,SACA,gBAAA;EAET,OAAA,CAAQ,GAAA,EAAK,MAAA,EAAQ,IAAA,EAAM,aAAA;EAK3B,SAAA,CAAU,GAAA,EAAK,MAAA,EAAQ,IAAA,EAAM,aAAA;EAI7B,UAAA,CAAW,EAAA,EAAI,UAAA,EAAY,IAAA,EAAM,aAAA;EAIjC,QAAA,CAAS,GAAA,EAAK,MAAA,EAAQ,GAAA,EAAK,aAAA;EAc3B,IAAA,CAAK,GAAA,EAAK,MAAA,EAAQ,IAAA,EAAM,aAAA;AAAA"}
|
package/dist/index.mjs
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
//#region src/index.ts
|
|
2
|
+
const RE_TRAILING_WHITESPACE = /\s*$/;
|
|
3
|
+
function codeFence(lang, body) {
|
|
4
|
+
return `\`\`\`${lang}\n${body.replace(RE_TRAILING_WHITESPACE, "")}\n\`\`\``;
|
|
5
|
+
}
|
|
6
|
+
var MarkdownProfile = class {
|
|
7
|
+
name = "markdown";
|
|
8
|
+
targetExtensions = [".md", ".mdx"];
|
|
9
|
+
typeRef(sym, _ctx) {
|
|
10
|
+
return `\`${sym.name}\``;
|
|
11
|
+
}
|
|
12
|
+
signature(sym, _ctx) {
|
|
13
|
+
return codeFence("ts", sym.signature);
|
|
14
|
+
}
|
|
15
|
+
typeString(ts, _ctx) {
|
|
16
|
+
return `\`${ts.text}\``;
|
|
17
|
+
}
|
|
18
|
+
typeCard(sym, ctx) {
|
|
19
|
+
const parts = [];
|
|
20
|
+
parts.push(`### ${sym.name}`);
|
|
21
|
+
if (sym.doc.summary) parts.push(sym.doc.summary);
|
|
22
|
+
parts.push(this.signature(sym, ctx));
|
|
23
|
+
if (sym.doc.description) parts.push(sym.doc.description);
|
|
24
|
+
for (const ex of sym.doc.examples) parts.push(codeFence(ex.lang || "ts", ex.code));
|
|
25
|
+
return parts.join("\n\n");
|
|
26
|
+
}
|
|
27
|
+
link(sym, _ctx) {
|
|
28
|
+
return `\`${sym.name}\``;
|
|
29
|
+
}
|
|
30
|
+
};
|
|
31
|
+
//#endregion
|
|
32
|
+
export { MarkdownProfile };
|
|
33
|
+
|
|
34
|
+
//# sourceMappingURL=index.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type {\n RenderContext,\n RendererProfile,\n Symbol,\n TypeString,\n} from '@vellum-docs/core'\n\nconst RE_TRAILING_WHITESPACE = /\\s*$/\n\nfunction codeFence(lang: string, body: string): string {\n return `\\`\\`\\`${lang}\\n${body.replace(RE_TRAILING_WHITESPACE, '')}\\n\\`\\`\\``\n}\n\nexport class MarkdownProfile implements RendererProfile {\n readonly name = 'markdown'\n readonly targetExtensions = ['.md', '.mdx'] as const\n\n typeRef(sym: Symbol, _ctx: RenderContext): string {\n // Plain markdown has no hover — just render the name as inline code.\n return `\\`${sym.name}\\``\n }\n\n signature(sym: Symbol, _ctx: RenderContext): string {\n return codeFence('ts', sym.signature)\n }\n\n typeString(ts: TypeString, _ctx: RenderContext): string {\n return `\\`${ts.text}\\``\n }\n\n typeCard(sym: Symbol, ctx: RenderContext): string {\n const parts: string[] = []\n parts.push(`### ${sym.name}`)\n if (sym.doc.summary)\n parts.push(sym.doc.summary)\n parts.push(this.signature(sym, ctx))\n if (sym.doc.description)\n parts.push(sym.doc.description)\n for (const ex of sym.doc.examples) {\n parts.push(codeFence(ex.lang || 'ts', ex.code))\n }\n return parts.join('\\n\\n')\n }\n\n link(sym: Symbol, _ctx: RenderContext): string {\n return `\\`${sym.name}\\``\n }\n}\n"],"mappings":";AAOA,MAAM,yBAAyB;AAE/B,SAAS,UAAU,MAAc,MAAsB;AACrD,QAAO,SAAS,KAAK,IAAI,KAAK,QAAQ,wBAAwB,GAAG,CAAC;;AAGpE,IAAa,kBAAb,MAAwD;CACtD,OAAgB;CAChB,mBAA4B,CAAC,OAAO,OAAO;CAE3C,QAAQ,KAAa,MAA6B;AAEhD,SAAO,KAAK,IAAI,KAAK;;CAGvB,UAAU,KAAa,MAA6B;AAClD,SAAO,UAAU,MAAM,IAAI,UAAU;;CAGvC,WAAW,IAAgB,MAA6B;AACtD,SAAO,KAAK,GAAG,KAAK;;CAGtB,SAAS,KAAa,KAA4B;EAChD,MAAM,QAAkB,EAAE;AAC1B,QAAM,KAAK,OAAO,IAAI,OAAO;AAC7B,MAAI,IAAI,IAAI,QACV,OAAM,KAAK,IAAI,IAAI,QAAQ;AAC7B,QAAM,KAAK,KAAK,UAAU,KAAK,IAAI,CAAC;AACpC,MAAI,IAAI,IAAI,YACV,OAAM,KAAK,IAAI,IAAI,YAAY;AACjC,OAAK,MAAM,MAAM,IAAI,IAAI,SACvB,OAAM,KAAK,UAAU,GAAG,QAAQ,MAAM,GAAG,KAAK,CAAC;AAEjD,SAAO,MAAM,KAAK,OAAO;;CAG3B,KAAK,KAAa,MAA6B;AAC7C,SAAO,KAAK,IAAI,KAAK"}
|
package/package.json
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@vellum-docs/profile-markdown",
|
|
3
|
+
"type": "module",
|
|
4
|
+
"version": "0.1.0",
|
|
5
|
+
"repository": {
|
|
6
|
+
"type": "git",
|
|
7
|
+
"url": "https://github.com/photon-hq/vellum.git",
|
|
8
|
+
"directory": "packages/profile-markdown"
|
|
9
|
+
},
|
|
10
|
+
"exports": {
|
|
11
|
+
".": {
|
|
12
|
+
"types": "./dist/index.d.mts",
|
|
13
|
+
"import": "./dist/index.mjs"
|
|
14
|
+
}
|
|
15
|
+
},
|
|
16
|
+
"main": "./dist/index.mjs",
|
|
17
|
+
"types": "./dist/index.d.mts",
|
|
18
|
+
"files": [
|
|
19
|
+
"dist"
|
|
20
|
+
],
|
|
21
|
+
"dependencies": {
|
|
22
|
+
"@vellum-docs/core": "0.1.0"
|
|
23
|
+
},
|
|
24
|
+
"devDependencies": {
|
|
25
|
+
"typescript": "^5.6.3"
|
|
26
|
+
},
|
|
27
|
+
"scripts": {
|
|
28
|
+
"build": "tsdown src/index.ts --format esm --out-dir dist --dts",
|
|
29
|
+
"clean": "rm -rf dist",
|
|
30
|
+
"typecheck": "tsc -p tsconfig.json --noEmit"
|
|
31
|
+
}
|
|
32
|
+
}
|