@clarify-labs/cli 0.2.0 → 0.5.0

package/output/core/ssg.d.ts

@@ -2,7 +2,7 @@ import { Plugin } from 'vite';
 import { ResolvedProjectConfig, ContentRoute } from '../types.js';
 export declare function readIndexHtml(outputDirectory: string): string | undefined;
 export declare function injectSSRIntoTemplate(template: string, appHtml: string, projectConfig: ResolvedProjectConfig, route?: ContentRoute): string;
-export declare const SSR_ENTRY_CODE = "import { renderToHTML } from '@clarify-labs/renderer/server';\nimport { routes, navigation } from 'virtual:clarify-routes';\nimport { config } from 'virtual:clarify-config';\nimport { openApis } from 'virtual:clarify-openapi-registry';\n\nexport function render(url) {\n  return renderToHTML({ config, routes, navigation, openApis, url });\n}";
+export declare const SSR_ENTRY_CODE = "import { renderToHTML } from '@clarify-labs/renderer/server';\nimport { routes, navigation } from 'virtual:clarify-routes/server';\nimport { config } from 'virtual:clarify-config';\nimport { openApis } from 'virtual:clarify-openapi-registry';\n\nexport function render(url) {\n  return renderToHTML({ config, routes, navigation, openApis, url });\n}";
 export declare function createTempEntryFile(content: string): string;
 export declare function buildSSRBundle(root: string, ssrEntry: string, ssrOutDir: string, plugins: Plugin[]): Promise<void>;
 export declare function renderSSGRoutes(routes: ContentRoute[], projectConfig: ResolvedProjectConfig, outputDirectory: string, ssrBundlePath: string, failOnError?: boolean): Promise<void>;

package/output/core/theme.d.ts

@@ -0,0 +1,52 @@
+import { ClarifyThemeConfig, ResolvedClarifyThemeConfig } from '../types.js';
+export declare const clarifyThemePresets: {
+    readonly default: {
+        readonly preset: "default";
+        readonly tokens: {
+            readonly colors: {
+                readonly primary: "#00D492";
+                readonly accent: "#00F6C9";
+                readonly background: "#ffffff";
+                readonly foreground: "#111827";
+                readonly surface: "#ffffff";
+                readonly muted: "#64748b";
+                readonly border: "rgb(15 23 42 / 0.12)";
+                readonly codeBackground: "#f7fefb";
+            };
+            readonly radius: {
+                readonly sm: "6px";
+                readonly md: "10px";
+                readonly lg: "14px";
+                readonly xl: "18px";
+            };
+        };
+        readonly layout: {
+            readonly maxWidth: "82rem";
+        };
+    };
+    readonly base: {
+        readonly preset: "base";
+        readonly tokens: {
+            readonly colors: {
+                readonly primary: "#18181b";
+                readonly accent: "#52525b";
+                readonly background: "#ffffff";
+                readonly foreground: "#18181b";
+                readonly surface: "#ffffff";
+                readonly muted: "#71717a";
+                readonly border: "rgb(24 24 27 / 0.12)";
+                readonly codeBackground: "#f4f4f5";
+            };
+            readonly radius: {
+                readonly sm: "6px";
+                readonly md: "8px";
+                readonly lg: "12px";
+                readonly xl: "16px";
+            };
+        };
+        readonly layout: {
+            readonly maxWidth: "80rem";
+        };
+    };
+};
+export declare function resolveThemeConfig(theme?: ClarifyThemeConfig): ResolvedClarifyThemeConfig;

package/output/core/virtual-modules.d.ts

@@ -1,18 +1,21 @@
-import { ClarifyPagesConfig, ContentRoute, NavigationTree, ResolvedBuildOptions, ResolvedProjectConfig } from '../types.js';
+import { ContentRoute, NavigationTree, ResolvedBuildOptions, ResolvedProjectConfig } from '../types.js';
 export declare const VIRTUAL_CONFIG = "virtual:clarify-config";
 export declare const VIRTUAL_ROUTES = "virtual:clarify-routes";
+export declare const VIRTUAL_SERVER_ROUTES = "virtual:clarify-routes/server";
 export declare const VIRTUAL_OPENAPI_REGISTRY = "virtual:clarify-openapi-registry";
 export declare const VIRTUAL_CLIENT_ENTRY = "virtual:clarify-entry-client";
 export declare const RESOLVED_CLIENT_ENTRY: string;
 export type VirtualModules = Map<string, string>;
-export declare function resolveVirtualId(id: string): string;
-export declare function stripVirtualPrefix(id: string): string;
-export declare function generateConfigModule(projectConfig: ResolvedProjectConfig, buildOptions: ResolvedBuildOptions): string;
-export declare function generateRoutesModule(routes: ContentRoute[], pagesConfig?: ClarifyPagesConfig, resolvedNavigation?: NavigationTree, projectConfig?: ResolvedProjectConfig): string;
-export declare function createClientEntryModule(): string;
-export declare function buildVirtualModules(args: {
+type BuildVirtualModulesArgs = {
     projectConfig: ResolvedProjectConfig;
     generateOptions: ResolvedBuildOptions;
     routes: ContentRoute[];
     navigation?: NavigationTree;
-}): VirtualModules;
+};
+export declare function resolveVirtualId(id: string): string;
+export declare function stripVirtualPrefix(id: string): string;
+export declare function generateConfigModule(projectConfig: ResolvedProjectConfig, buildOptions: ResolvedBuildOptions): string;
+export declare function generateRoutesModule(routes: ContentRoute[], resolvedNavigation?: NavigationTree, projectConfig?: ResolvedProjectConfig, mode?: 'client' | 'server'): string;
+export declare function createClientEntryModule(): string;
+export declare function buildVirtualModules(args: BuildVirtualModulesArgs): VirtualModules;
+export {};

package/output/index.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_plugin = require("./plugin-CEyCiD5r.cjs");
+const require_plugin = require("./plugin-DnD0L83F.cjs");
 exports.clarifyPlugin = require_plugin.clarifyPlugin;
 exports.defineConfig = require_plugin.defineConfig;

package/output/index.js

@@ -1,2 +1,2 @@
-import { n as defineConfig, t as clarifyPlugin } from "./plugin-BUWojlPv.js";
+import { n as defineConfig, t as clarifyPlugin } from "./plugin-PEEknlAO.js";
 export { clarifyPlugin, defineConfig };

package/output/parsers/frontmatter.d.ts

@@ -1,5 +1,17 @@
+export type ParsedFrontmatter = {
+    frontmatter: Record<string, unknown>;
+    content: string;
+};
+/**
+ * 在内容入口统一解析 MDX frontmatter，并返回可供后续流程复用的标准化正文。
+ */
+export declare function parseFrontmatter(content: string): ParsedFrontmatter;
 /**
  * 从 MDX 文件内容中提取 frontmatter。
  * 使用 gray-matter 支持 YAML frontmatter 的标准语法和类型解析。
  */
 export declare function extractFrontmatter(content: string): Record<string, unknown>;
+/**
+ * 移除 MDX 文件开头的 YAML frontmatter，保留页面正文。
+ */
+export declare function stripFrontmatter(content: string): string;

package/output/parsers/mdx.d.ts

@@ -1,4 +1,3 @@
-import { default as remarkGfm } from 'remark-gfm';
 type HastNode = {
     type: string;
     tagName?: string;
@@ -9,6 +8,6 @@ type HastNode = {
 export declare function rehypeParseCodeBlocks(): (tree: HastNode) => void;
 export declare function rehypeShiki(): (tree: HastNode) => Promise<void>;
 export declare function rehypeSlugSections(): (tree: HastNode) => void;
-export declare const remarkPlugins: (typeof remarkGfm)[];
+export declare const remarkPlugins: typeof import('remark-gfm').default[];
 export declare const rehypePlugins: (typeof rehypeSlugSections)[];
 export {};

package/output/parsers/routes.d.ts

@@ -1,4 +1,4 @@
-import { ContentRoute, ContentSection, ClarifyNavigationNode, ClarifyPagesGroup, ClarifyLocalizedText, LocalizedNavigation, ResolvedClarifyI18nConfig } from '../types.js';
+import { ContentRoute, ContentSection, ClarifyNavigationNode, ClarifyPagesConfig, ClarifyPagesGroup, ClarifyLocalizedText, ClarifyTabsConfig, LocalizedNavigation, LocalizedTabbedNavigation, ResolvedClarifyI18nConfig, TabbedNavigation } from '../types.js';
 /** 从 MDX/Markdown 内容中提取 H2/H3 章节 */
 export declare function extractMdxSections(content: string): ContentSection[];
 export declare function basePathFromRef(ref: string): string;
@@ -9,5 +9,7 @@ export declare function resolveLocalizedText(text: ClarifyLocalizedText | undefi
 export declare function findContentRoutes(dir: string, base?: string): ContentRoute[];
 export declare function findLocalizedContentRoutes(contentRoot: string, i18n?: ResolvedClarifyI18nConfig): ContentRoute[];
 export declare function buildNavigation(routes: ContentRoute[]): ClarifyNavigationNode[];
+export declare function buildNavigationFromTabsConfig(routes: ContentRoute[], tabs: ClarifyTabsConfig): TabbedNavigation;
 export declare function buildNavigationFromConfig(routes: ContentRoute[], config: ClarifyPagesGroup[]): ClarifyNavigationNode[];
-export declare function buildLocalizedNavigation(routes: ContentRoute[], config: ClarifyPagesGroup[] | 'FileTree' | undefined, i18n?: ResolvedClarifyI18nConfig): LocalizedNavigation | undefined;
+export declare function buildLocalizedNavigation(routes: ContentRoute[], config: ClarifyPagesConfig | undefined, i18n?: ResolvedClarifyI18nConfig): LocalizedNavigation | undefined;
+export declare function buildLocalizedNavigationFromTabsConfig(routes: ContentRoute[], tabs: ClarifyTabsConfig, i18n?: ResolvedClarifyI18nConfig): LocalizedTabbedNavigation | undefined;

package/output/parsers/routes.test-utils.d.ts

@@ -0,0 +1,3 @@
+import { ContentRoute, ResolvedClarifyI18nConfig } from '../types.js';
+export declare function mdxRoute(route: Omit<ContentRoute, 'kind'>): ContentRoute;
+export declare const testI18n: ResolvedClarifyI18nConfig;