fix some doc comments

Author: ryanatkn

src/lib/path.ts

@@ -37,7 +37,10 @@ export const to_file_path = (path_or_url: string | URL): string =>
 	typeof path_or_url === 'string' ? path_or_url : decodeURIComponent(path_or_url.pathname);
 
 /**
- * @example parse_path_parts('./foo/bar/baz.ts') => ['foo', 'foo/bar', 'foo/bar/baz.ts']
+ * @example
+ * ```ts
+ * parse_path_parts('./foo/bar/baz.ts') // => ['foo', 'foo/bar', 'foo/bar/baz.ts']
+ * ```
  */
 export const parse_path_parts = (path: string): Array<string> => {
 	const segments = parse_path_segments(path);
@@ -53,7 +56,10 @@ export const parse_path_parts = (path: string): Array<string> => {
 
 /**
  * Gets the individual parts of a path, ignoring dots and separators.
- * @example parse_path_segments('/foo/bar/baz.ts') => ['foo', 'bar', 'baz.ts']
+ * @example
+ * ```ts
+ * parse_path_segments('/foo/bar/baz.ts') // => ['foo', 'bar', 'baz.ts']
+ * ```
  */
 export const parse_path_segments = (path: string): Array<string> =>
 	path.split('/').filter((s) => s && s !== '.' && s !== '..');

src/lib/process.ts

@@ -616,7 +616,10 @@ export const spawn_detached = (
 /**
  * Formats a child process for display.
  *
- * @example `pid(1234) <- node server.js`
+ * @example
+ * ```ts
+ * `pid(1234) <- node server.js`
+ * ```
  */
 export const print_child_process = (child: ChildProcess): string =>
 	`${st('gray', 'pid(')}${child.pid ?? 'none'}${st('gray', ')')} ← ${st('green', child.spawnargs.join(' '))}`;

src/lib/source_json.ts

@@ -174,8 +174,11 @@ export type SourceJson = z.infer<typeof SourceJson>;
 
 /**
  * Format declaration name with generic parameters for display.
- * @example declaration_get_display_name({name: 'Map', kind: 'type', generic_params: [{name: 'K'}, {name: 'V'}]})
+ * @example
+ * ```ts
+ * declaration_get_display_name({name: 'Map', kind: 'type', generic_params: [{name: 'K'}, {name: 'V'}]})
  * // => 'Map<K, V>'
+ * ```
  */
 export const declaration_get_display_name = (declaration: DeclarationJson): string => {
 	if (!declaration.generic_params?.length) return declaration.name;
@@ -190,8 +193,11 @@ export const declaration_get_display_name = (declaration: DeclarationJson): stri
 
 /**
  * Generate TypeScript import statement for a declaration.
- * @example declaration_generate_import({name: 'Foo', kind: 'type'}, 'foo.ts', '@pkg/lib')
+ * @example
+ * ```ts
+ * declaration_generate_import({name: 'Foo', kind: 'type'}, 'foo.ts', '@pkg/lib')
  * // => "import type {Foo} from '@pkg/lib/foo.js';"
+ * ```
  */
 export const declaration_generate_import = (
 	declaration: DeclarationJson,