import { fileBasename } from "@t3tools/shared/path";
import { fileLinkLabel } from "@t3tools/shared/fileLinks";
import {
inlineCodeFilePathCandidate,
normalizeMarkdownLinkDestination,
parseMarkdownFileLink,
} from "@t3tools/shared/markdownLinks";
import { parseThreadLinkHref } from "@t3tools/shared/threadLinks";
import { videoMimeType } from "@t3tools/shared/video";
import type { MARKDOWN_FILE_ICON_SOURCES } from "./markdownFileIcons.generated";
const POSITION_SUFFIX_PATTERN = /:\d+(?::\d+)?$/;
export type MarkdownLinkPresentation =
| {
readonly kind: "external";
readonly href: string;
readonly host: string;
}
| {
readonly kind: "file";
readonly href: string;
readonly icon: MarkdownFileIcon;
readonly label: string;
readonly path: string;
readonly line?: number;
readonly column?: number;
}
| {
readonly kind: "link";
readonly href: string | null;
};
export type MarkdownFileIcon = keyof typeof MARKDOWN_FILE_ICON_SOURCES;
const FILE_ICON_BY_NAME: Readonly<Record<string, MarkdownFileIcon>> = {
".babelrc": "babel",
".babelrc.json": "babel",
".bash_profile": "bash",
".bashrc": "bash",
".browserslistrc": "browserslist",
".dockerignore": "docker",
".eslintignore": "eslint",
".eslintrc": "eslint",
".eslintrc.cjs": "eslint",
".eslintrc.js": "eslint",
".eslintrc.json": "eslint",
".eslintrc.yaml": "eslint",
".eslintrc.yml": "eslint",
".gitattributes": "git",
".gitignore": "git",
".gitkeep": "git",
".gitmodules": "git",
".oxlintrc.json": "oxc",
".postcssrc": "postcss",
".postcssrc.json": "postcss",
".postcssrc.yaml": "postcss",
".postcssrc.yml": "postcss",
".prettierignore": "prettier",
".prettierrc": "prettier",
".prettierrc.json": "prettier",
".prettierrc.cjs": "prettier",
".prettierrc.js": "prettier",
".prettierrc.mjs": "prettier",
".prettierrc.toml": "prettier",
".prettierrc.yaml": "prettier",
".prettierrc.yml": "prettier",
".stylelintignore": "stylelint",
".stylelintrc": "stylelint",
".stylelintrc.cjs": "stylelint",
".stylelintrc.js": "stylelint",
".stylelintrc.json": "stylelint",
".stylelintrc.mjs": "stylelint",
".stylelintrc.yaml": "stylelint",
".stylelintrc.yml": "stylelint",
".terraform.lock.hcl": "terraform",
".zprofile": "bash",
".zshenv": "bash",
".zshrc": "bash",
"agents.md": "agents",
"babel.config.js": "babel",
"babel.config.cjs": "babel",
"babel.config.json": "babel",
"babel.config.mjs": "babel",
"biome.json": "biome",
"biome.jsonc": "biome",
"bun.lock": "bun",
"bun.lockb": "bun",
"bunfig.toml": "bun",
"claude.md": "claude",
"compose.yaml": "docker",
"compose.yml": "docker",
"docker-compose.yaml": "docker",
"docker-compose.yml": "docker",
"docker-compose.override.yml": "docker",
dockerfile: "docker",
"eslint.config.js": "eslint",
"eslint.config.cjs": "eslint",
"eslint.config.mjs": "eslint",
"eslint.config.mts": "eslint",
"eslint.config.ts": "eslint",
gemfile: "ruby",
"next.config.js": "nextjs",
"next.config.mjs": "nextjs",
"next.config.mts": "nextjs",
"next.config.ts": "nextjs",
"package.json": "npm",
"pnpm-lock.yaml": "pnpm",
"pnpm-workspace.yaml": "pnpm",
"postcss.config.js": "postcss",
"postcss.config.cjs": "postcss",
"postcss.config.mjs": "postcss",
"postcss.config.ts": "postcss",
"prettier.config.js": "prettier",
"prettier.config.cjs": "prettier",
"prettier.config.mjs": "prettier",
rakefile: "ruby",
"readme.md": "markdown",
"stylelint.config.js": "stylelint",
"stylelint.config.cjs": "stylelint",
"stylelint.config.mjs": "stylelint",
"svgo.config.js": "svgo",
"svgo.config.cjs": "svgo",
"svgo.config.mjs": "svgo",
"svgo.config.ts": "svgo",
"tailwind.config.js": "tailwind",
"tailwind.config.cjs": "tailwind",
"tailwind.config.mjs": "tailwind",
"tailwind.config.ts": "tailwind",
"tsconfig.json": "typescript",
"vite.config.js": "vite",
"vite.config.mjs": "vite",
"vite.config.mts": "vite",
"vite.config.ts": "vite",
"webpack.config.js": "webpack",
"webpack.config.babel.js": "webpack",
"webpack.config.cjs": "webpack",
"webpack.config.mjs": "webpack",
"webpack.config.ts": "webpack",
};
const FILE_ICON_BY_EXTENSION: Readonly<Record<string, MarkdownFileIcon>> = {
"7z": "zip",
astro: "astro",
avif: "image",
"code-workspace": "vscode",
bash: "bash",
bmp: "image",
bz2: "zip",
c: "c",
cc: "cpp",
cpp: "cpp",
cxx: "cpp",
css: "css",
csv: "table",
cts: "typescript",
db: "database",
env: "text",
"env.development": "text",
"env.local": "text",
"env.production": "text",
eot: "font",
erb: "ruby",
fish: "bash",
gif: "image",
go: "go",
gql: "graphql",
graphql: "graphql",
gz: "zip",
h: "c",
hh: "cpp",
hpp: "cpp",
hxx: "cpp",
htm: "html",
html: "html",
ico: "image",
icns: "image",
ini: "text",
inl: "cpp",
jar: "zip",
jpeg: "image",
jpg: "image",
js: "javascript",
jsx: "react",
json: "json",
jsonc: "json",
less: "css",
md: "markdown",
mdx: "markdown",
"mdx.tsx": "markdown",
mjs: "javascript",
mts: "typescript",
png: "image",
postcss: "css",
py: "python",
pyi: "python",
pyw: "python",
pyx: "python",
rake: "ruby",
rar: "zip",
rb: "ruby",
rs: "rust",
sass: "sass",
scss: "sass",
sh: "bash",
sql: "database",
sqlite: "database",
sqlite3: "database",
svelte: "svelte",
svg: "svg",
swift: "swift",
tar: "zip",
tf: "terraform",
tfstate: "terraform",
tfvars: "terraform",
tgz: "zip",
ts: "typescript",
tsv: "table",
tsx: "react",
txt: "text",
woff: "font",
woff2: "font",
vue: "vue",
wasm: "wasm",
webp: "image",
yml: "yml",
yaml: "yml",
zig: "zig",
zip: "zip",
zsh: "bash",
};
/** Native link and media APIs have no document scheme to inherit from protocol-relative URLs. */
export function normalizeNativeMarkdownUrl(value: string): string {
return value.startsWith("//") ? `https:${value}` : value;
}
export function resolveMarkdownFileIcon(value: string): MarkdownFileIcon {
const basename = fileBasename(value).replace(POSITION_SUFFIX_PATTERN, "").toLowerCase();
if (videoMimeType({ name: basename, mimeType: "" }) !== null) return "video";
const exactIcon = FILE_ICON_BY_NAME[basename];
if (exactIcon) return exactIcon;
if (basename.startsWith("tsconfig.") && basename.endsWith(".json")) {
return "typescript";
}
const segments = basename.split(".");
for (let index = 1; index < segments.length; index += 1) {
const icon = FILE_ICON_BY_EXTENSION[segments.slice(index).join(".")];
if (icon) return icon;
}
return "default";
}
export function resolveMarkdownLinkPresentation(href: string): MarkdownLinkPresentation {
const normalized = normalizeMarkdownLinkDestination(href);
try {
const parsed = new URL(normalizeNativeMarkdownUrl(normalized));
if (parsed.protocol === "http:" || parsed.protocol === "https:") {
return {
kind: "external",
href: parsed.toString(),
host: parsed.hostname,
};
}
} catch {}
const target = parseMarkdownFileLink(normalized);
if (target) {
return {
kind: "file",
href: normalized,
icon: resolveMarkdownFileIcon(target.path),
label: fileLinkLabel(target, new Map()),
path: target.path,
...(target.line ? { line: target.line } : {}),
...(target.column ? { column: target.column } : {}),
};
}
return {
kind: "link",
href:
/^(?:mailto|tel):/i.test(normalized) || parseThreadLinkHref(normalized) !== null
? normalized
: null,
};
}
export function resolveMarkdownInlineCodePresentation(
content: string,
): Extract<MarkdownLinkPresentation, { readonly kind: "file" }> | null {
const candidate = inlineCodeFilePathCandidate(content);
if (candidate === null) return null;
const presentation = resolveMarkdownLinkPresentation(candidate);
return presentation.kind === "file" ? presentation : null;
}