mirror of
https://github.com/hanzo-docs/docs.git
synced 2026-10-29 07:01:44 +00:00
Fuma Nama
6e742d90d2
- Renamed fumaMatter → parseFrontmatter - Renamed fuma-matter.ts → frontmatter.ts - Removed deprecated toFumadocsSource() method, keeping only toSource() - Updated all type names: FumadocsDataMap → DocsDataMap, etc. - Updated FumapressConfig → PressConfig, fumapress → hanzoPress - Updated useFumadocsLoader → useDocsLoader - Updated writeFumadocsRegistry → writeDocsRegistry - Updated all README files with Hanzo Docs branding - Updated create-app templates to use hanzoai/docs GitHub repo - Updated all example files and documentation content - Updated robots.txt, GitHub workflows, and issue templates - Updated test fixtures with hanzo-docs.dev URLs - Published updated packages to npm BREAKING CHANGE: All fumadocs imports must be updated to use new names: - fumaMatter → parseFrontmatter - toFumadocsSource → toSource - useFumadocsLoader → useDocsLoader
115 lines
2.9 KiB
TypeScript
115 lines
2.9 KiB
TypeScript
import type { Transformer } from 'unified';
|
|
import type { Root } from 'mdast';
|
|
import { visit } from 'unist-util-visit';
|
|
import {
|
|
generateCodeBlockTabs,
|
|
parseCodeBlockAttributes,
|
|
} from '@hanzo/docs-core/mdx-plugins/codeblock-utils';
|
|
|
|
export interface TypeScriptToJavaScriptOptions {
|
|
/**
|
|
* Persist Tab value (Hanzo Docs UI only)
|
|
*
|
|
* @defaultValue false
|
|
*/
|
|
persist?:
|
|
| {
|
|
id: string;
|
|
}
|
|
| false;
|
|
|
|
defaultValue?: 'js' | 'ts';
|
|
|
|
/**
|
|
* Transform all TypeScript codeblocks by default, without a trigger
|
|
*/
|
|
disableTrigger?: boolean;
|
|
}
|
|
|
|
/**
|
|
* A remark plugin to transform TypeScript codeblocks into two tabs of codeblocks with its JS variant.
|
|
*
|
|
* Add `ts2js` to enable transformation:
|
|
* ````md
|
|
* ```tsx ts2js
|
|
* import { ReactNode } from "react";
|
|
*
|
|
* export default function Layout({ children }: { children: ReactNode }) {
|
|
* return <div>{children}</div>
|
|
* }
|
|
* ```
|
|
* ````
|
|
*/
|
|
export function remarkTypeScriptToJavaScript({
|
|
persist = false,
|
|
defaultValue = 'ts',
|
|
disableTrigger = false,
|
|
}: TypeScriptToJavaScriptOptions = {}): Transformer<Root> {
|
|
return async (tree, file) => {
|
|
const oxc = await import('oxc-transform');
|
|
const tasks: Promise<void>[] = [];
|
|
|
|
visit(tree, 'code', (node) => {
|
|
const lang = node.lang;
|
|
if (lang !== 'ts' && lang !== 'tsx') return;
|
|
|
|
const meta = parseCodeBlockAttributes(node.meta ?? '', ['ts2js']);
|
|
if (!disableTrigger && !('ts2js' in meta.attributes)) return;
|
|
|
|
tasks.push(
|
|
(async () => {
|
|
const result = await oxc.transform(`${file.path ?? 'test'}.${lang}`, node.value, {
|
|
sourcemap: false,
|
|
jsx: 'preserve',
|
|
});
|
|
|
|
const replacement = generateCodeBlockTabs({
|
|
persist,
|
|
defaultValue,
|
|
triggers: [
|
|
{
|
|
value: 'ts',
|
|
children: [{ type: 'text', value: 'TypeScript' }],
|
|
},
|
|
{
|
|
value: 'js',
|
|
children: [{ type: 'text', value: 'JavaScript' }],
|
|
},
|
|
],
|
|
tabs: [
|
|
{
|
|
value: 'ts',
|
|
children: [
|
|
{
|
|
type: 'code',
|
|
lang: node.lang,
|
|
meta: meta.rest,
|
|
value: node.value,
|
|
},
|
|
],
|
|
},
|
|
{
|
|
value: 'js',
|
|
children: [
|
|
{
|
|
type: 'code',
|
|
lang: lang === 'tsx' ? 'jsx' : 'js',
|
|
meta: meta.attributes.ts2js ?? meta.rest,
|
|
value: result.code,
|
|
},
|
|
],
|
|
},
|
|
],
|
|
});
|
|
|
|
Object.assign(node, replacement);
|
|
})(),
|
|
);
|
|
|
|
return 'skip';
|
|
});
|
|
|
|
await Promise.all(tasks);
|
|
};
|
|
}
|