@octanejs/docusaurus 0.0.1

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/types/mdx.d.ts ADDED
@@ -0,0 +1,60 @@
1
+ import type { CompileOptions } from '@mdx-js/mdx';
2
+ import type { CompileMdxOptions, CompileMdxResult } from '@octanejs/mdx/compile';
3
+
4
+ export interface DocusaurusTocItem {
5
+ value: string;
6
+ id: string;
7
+ level: number;
8
+ }
9
+
10
+ export interface DocusaurusMarkdownLinkInput {
11
+ linkPathname: string;
12
+ sourceFilePath: string;
13
+ }
14
+
15
+ export interface DocusaurusMdxImageTransformInput {
16
+ url: string;
17
+ sourceFilePath: string;
18
+ }
19
+
20
+ export interface DocusaurusMdxAssetInput {
21
+ frontMatter: Record<string, unknown>;
22
+ filePath: string;
23
+ }
24
+
25
+ export interface CompileDocusaurusMdxOptions extends Omit<
26
+ CompileMdxOptions,
27
+ 'remarkPlugins' | 'rehypePlugins' | 'recmaPlugins'
28
+ > {
29
+ metadata?: Record<string, any>;
30
+ createAssets?(input: DocusaurusMdxAssetInput): Record<string, any>;
31
+ resolveMarkdownLink?(input: DocusaurusMarkdownLinkInput): string | null;
32
+ resolveMarkdownImage?(input: DocusaurusMdxImageTransformInput): string;
33
+ removeContentTitle?: boolean;
34
+ anchorsMaintainCase?: boolean;
35
+ tocMinHeadingLevel?: number;
36
+ tocMaxHeadingLevel?: number;
37
+ beforeDefaultRemarkPlugins?: CompileOptions['remarkPlugins'];
38
+ remarkPlugins?: CompileOptions['remarkPlugins'];
39
+ beforeDefaultRehypePlugins?: CompileOptions['rehypePlugins'];
40
+ rehypePlugins?: CompileOptions['rehypePlugins'];
41
+ recmaPlugins?: CompileOptions['recmaPlugins'];
42
+ }
43
+
44
+ export declare function remarkDocusaurusPageData(
45
+ options?: CompileDocusaurusMdxOptions,
46
+ ): (tree: any, file: any) => void;
47
+
48
+ export declare function recmaDocusaurusPageExports(): (tree: any, file: any) => void;
49
+
50
+ export declare function compileDocusaurusMdx(
51
+ source: string,
52
+ id: string,
53
+ options?: CompileDocusaurusMdxOptions,
54
+ ): Promise<CompileMdxResult>;
55
+
56
+ export declare function compileDocusaurusMdxSync(
57
+ source: string,
58
+ id: string,
59
+ options?: CompileDocusaurusMdxOptions,
60
+ ): CompileMdxResult;
@@ -0,0 +1,66 @@
1
+ import type { CompileMdxResult } from '@octanejs/mdx/compile';
2
+ import type { DocusaurusManifest, LoadDocusaurusSiteOptions } from './index.js';
3
+ import type { CompileDocusaurusMdxOptions } from './mdx.js';
4
+
5
+ export declare const DOCUSAURUS_MANIFEST_ID = 'virtual:octane-docusaurus-manifest';
6
+
7
+ export interface DocusaurusMdxPluginOptions extends Omit<
8
+ CompileDocusaurusMdxOptions,
9
+ 'mode' | 'hmr' | 'dev' | 'metadata'
10
+ > {
11
+ ssr?: boolean;
12
+ md?: boolean;
13
+ hmr?: boolean;
14
+ profile?: boolean;
15
+ metadata?:
16
+ | Record<string, any>
17
+ | ((id: string) => Record<string, any> | undefined | Promise<Record<string, any> | undefined>);
18
+ }
19
+
20
+ export interface DocusaurusViteOptions extends LoadDocusaurusSiteOptions {
21
+ mdx?: DocusaurusMdxPluginOptions;
22
+ }
23
+
24
+ export interface DocusaurusBridgePlugin {
25
+ name: 'octane-docusaurus-bridge';
26
+ enforce: 'pre';
27
+ api: {
28
+ getManifest(): Promise<DocusaurusManifest>;
29
+ reload(): Promise<DocusaurusManifest>;
30
+ };
31
+ configResolved(config: { root?: string; command: string }): Promise<void>;
32
+ buildStart(this: { addWatchFile?(id: string): void }): Promise<void>;
33
+ watchChange(id: string): Promise<void>;
34
+ resolveId(id: string): Promise<string | null>;
35
+ load(id: string): Promise<string | null>;
36
+ }
37
+
38
+ export interface DocusaurusMdxPlugin {
39
+ name: 'octane-docusaurus-mdx';
40
+ enforce: 'pre';
41
+ configResolved(config: { root?: string; command: string }): void;
42
+ watchChange(id: string): void;
43
+ transform(
44
+ this: {
45
+ addWatchFile?(id: string): void;
46
+ warn?(warning: {
47
+ code: string;
48
+ message: string;
49
+ id: string;
50
+ loc: { file: string; line: number; column: number };
51
+ }): void;
52
+ environment?: { config?: { consumer?: string } };
53
+ },
54
+ code: string,
55
+ id: string,
56
+ options?: { ssr?: boolean },
57
+ ): Promise<CompileMdxResult | null>;
58
+ }
59
+
60
+ export declare function docusaurusBridge(options?: DocusaurusViteOptions): DocusaurusBridgePlugin;
61
+
62
+ export declare function docusaurusMdx(options?: DocusaurusMdxPluginOptions): DocusaurusMdxPlugin;
63
+
64
+ export declare function docusaurus(
65
+ options?: DocusaurusViteOptions,
66
+ ): [DocusaurusBridgePlugin, DocusaurusMdxPlugin];