@clarify-labs/cli 0.1.0

package/output/core/runtime-deps.d.ts

@@ -0,0 +1,7 @@
+import { AliasOptions } from 'vite';
+/**
+ * Resolve Clarify's framework/runtime dependencies from the CLI package instead
+ * of from the user's documentation project. This keeps content-only projects
+ * free from React, renderer, and tsconfig requirements.
+ */
+export declare function createClarifyRuntimeAliases(): AliasOptions;

package/output/core/ssg.d.ts

@@ -0,0 +1,8 @@
+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 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/user-config.d.ts

@@ -0,0 +1,7 @@
+import { ConfigEnv } from 'vite';
+import { ClarifyProjectConfig } from '../types.js';
+import { ClarifyBuildOptions } from './options.js';
+export type ClarifyConfig = ClarifyProjectConfig & Pick<ClarifyBuildOptions, 'plugins' | 'ssg'>;
+export declare function defineConfig(config: ClarifyConfig): ClarifyConfig;
+export declare function findClarifyConfigFile(root: string): string | undefined;
+export declare function loadClarifyConfig(root: string, env: ConfigEnv): Promise<ClarifyConfig>;

package/output/core/utils.d.ts

@@ -0,0 +1 @@
+export declare function escapeHtml(text: string): string;

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

@@ -0,0 +1,18 @@
+import { ClarifyPagesConfig, 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_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: {
+    projectConfig: ResolvedProjectConfig;
+    generateOptions: ResolvedBuildOptions;
+    routes: ContentRoute[];
+    navigation?: NavigationTree;
+}): VirtualModules;

package/output/core/vite-config.d.ts

@@ -0,0 +1,10 @@
+import { ConfigEnv, InlineConfig } from 'vite';
+export type ClarifyViteConfigOptions = {
+    root: string;
+    content: string;
+    output: string;
+    host?: string | boolean;
+    port?: number;
+    open?: boolean | string;
+};
+export declare function createViteConfig(options: ClarifyViteConfigOptions, env: ConfigEnv): Promise<InlineConfig>;

package/output/index.cjs

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

package/output/index.d.ts

@@ -0,0 +1,5 @@
+export { clarifyPlugin } from './core/plugin.js';
+export { defineConfig } from './core/user-config.js';
+export type { Plugin } from 'vite';
+export * from './types.js';
+export type { ClarifyConfig } from './core/user-config.js';

package/output/index.js

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

package/output/parsers/frontmatter.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 从 MDX 文件内容中提取 frontmatter。
+ * 使用 gray-matter 支持 YAML frontmatter 的标准语法和类型解析。
+ */
+export declare function extractFrontmatter(content: string): Record<string, unknown>;

package/output/parsers/mdx.d.ts

@@ -0,0 +1,14 @@
+import { default as remarkGfm } from 'remark-gfm';
+type HastNode = {
+    type: string;
+    tagName?: string;
+    value?: string;
+    properties?: Record<string, unknown>;
+    children?: 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 rehypePlugins: (typeof rehypeSlugSections)[];
+export {};

package/output/parsers/routes.d.ts

@@ -0,0 +1,13 @@
+import { ContentRoute, ContentSection, ClarifyNavigationNode, ClarifyPagesGroup, ClarifyLocalizedText, LocalizedNavigation, ResolvedClarifyI18nConfig } from '../types.js';
+/** 从 MDX/Markdown 内容中提取 H2/H3 章节 */
+export declare function extractMdxSections(content: string): ContentSection[];
+export declare function basePathFromRef(ref: string): string;
+export declare function routePathFromRef(ref: string): string;
+export declare function virtualModuleIdFromRef(ref: string): string;
+export declare function localizedRoutePath(basePath: string, locale: string, i18n: ResolvedClarifyI18nConfig): string;
+export declare function resolveLocalizedText(text: ClarifyLocalizedText | undefined, locale: string, fallbackLocale?: string): string | undefined;
+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 buildNavigationFromConfig(routes: ContentRoute[], config: ClarifyPagesGroup[]): ClarifyNavigationNode[];
+export declare function buildLocalizedNavigation(routes: ContentRoute[], config: ClarifyPagesGroup[] | 'FileTree' | undefined, i18n?: ResolvedClarifyI18nConfig): LocalizedNavigation | undefined;