@clarify-labs/cli 0.11.18 → 0.11.20

package/output/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_engine = require("./engine-CNnlt59g.cjs");
+const require_engine = require("./engine-CAis1rme.cjs");
 exports.ClarifyEngine = require_engine.ClarifyEngine;
 exports.createClarifyEngine = require_engine.createClarifyEngine;
 exports.createViteAdapter = require_engine.createViteAdapter;

package/output/index.js

@@ -1,2 +1,2 @@
-import { d as createViteAdapter, f as defineConfig, n as createClarifyEngine, t as ClarifyEngine } from "./engine-DeA6EGHW.js";
+import { d as createViteAdapter, f as defineConfig, n as createClarifyEngine, t as ClarifyEngine } from "./engine-BgfGFPKK.js";
 export { ClarifyEngine, createClarifyEngine, createViteAdapter, defineConfig };

package/output/parsers/content/content.d.ts

@@ -2,6 +2,7 @@ import { ClarifyContentKind, ClarifyContentTransformInput, ClarifyHookContext, C
 export type ProcessedMdxContent = {
     frontmatter: Record<string, unknown>;
     content: string;
+    lineOffset: number;
 };
 export type ContentTransform = (input: ClarifyContentTransformInput) => Promise<ClarifyContentTransformInput> | ClarifyContentTransformInput;
 export type ContentProcessor = {

package/output/parsers/markdown/frontmatter.d.ts

@@ -1,6 +1,7 @@
 export type ParsedFrontmatter = {
     frontmatter: Record<string, unknown>;
     content: string;
+    lineOffset: number;
 };
 /**
  * 在内容入口统一解析 MDX frontmatter，并返回可供后续流程复用的标准化正文。

package/output/parsers/markdown/headings.d.ts

@@ -0,0 +1,24 @@
+import { ContentDiagnostic } from '../../types.js';
+export declare const HEADING_ID_PATTERN: RegExp;
+export type AnalyzedHeading = {
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    title: string;
+    id: string;
+    position: {
+        line: number;
+        column: number;
+    };
+};
+export type AnalyzeHeadingsOptions = {
+    kind: 'markdown' | 'markdown+jsx';
+    filePath?: string;
+    projectRoot?: string;
+    lineOffset?: number;
+};
+export type HeadingAnalysis = {
+    headings: AnalyzedHeading[];
+    normalizedContent: string;
+    diagnostic?: ContentDiagnostic;
+};
+export declare function analyzeHeadings(content: string, options: AnalyzeHeadingsOptions): HeadingAnalysis;
+export declare function remarkApplyHeadingIds(): (tree: unknown) => void;

package/output/parsers/markdown/mdx.d.ts

@@ -8,6 +8,7 @@ type HastNode = {
     children?: HastNode[];
 };
 export declare function rehypeParseCodeBlocks(): (tree: HastNode) => void;
+export declare function rehypeAddMissingHeadingIds(): (tree: HastNode) => void;
 export declare const remarkPlugins: unknown[];
 export declare const rehypePlugins: NonNullable<CompileOptions['rehypePlugins']>;
 type ContentCompileDiagnosticOptions = {

package/output/parsers/routes/heading-metadata.d.ts

@@ -0,0 +1,7 @@
+import { ContentRoute } from '../../types.js';
+import { analyzeHeadings } from '../markdown/headings.js';
+type HeadingAnalysis = ReturnType<typeof analyzeHeadings>;
+export declare function kebabToTitle(str: string): string;
+export declare function headingMetadata(analysis: HeadingAnalysis): Pick<ContentRoute['meta'], 'sections'>;
+export declare function reanalyzeMarkdownRoute(route: ContentRoute, projectRoot: string): Promise<ContentRoute>;
+export {};

package/output/parsers/routes/routes.d.ts

@@ -1,9 +1,10 @@
 import { ContentRoute, ClarifyNavigationNode, ClarifyPagesConfig, ClarifyPagesGroup, ClarifyPagesItem, ClarifyRouteIntent, ClarifyTabsConfig, LocalizedNavigation, LocalizedTabbedNavigation, MarkdownContentRoute, ResolvedClarifyLocalesConfig, TabbedNavigation } from '../../types.js';
 import { ContentProcessor } from '../content/content.js';
+import { kebabToTitle } from './heading-metadata.js';
 export type FindContentRoutesOptions = {
     contentProcessor?: ContentProcessor;
 };
-export declare function kebabToTitle(str: string): string;
+export { kebabToTitle };
 export declare function normalizePath(path: string): string;
 export declare function basePathFromRef(ref: string): string;
 export declare function openAPIPagePathFromRef(ref: string, tagFilter?: string[], explicitPath?: string): string;

package/output/plugins/content-artifacts/provider.d.ts

@@ -0,0 +1,3 @@
+import { ClarifyArtifact, ContentRoute, ResolvedProjectConfig } from '../../types.js';
+export declare function createContentArtifacts(routes: ContentRoute[], projectConfig: ResolvedProjectConfig): ClarifyArtifact[];
+export declare function findContentArtifact(path: string, routes: ContentRoute[], projectConfig: ResolvedProjectConfig): ClarifyArtifact | undefined;

package/output/plugins/openapi/aggregation.d.ts

@@ -0,0 +1,12 @@
+import { OpenAPISpec } from '../../types.js';
+export type OpenAPISourceDocument = {
+    id: string;
+    filePath: string;
+    document: OpenAPISpec;
+};
+export type OpenAPIAggregationInfo = {
+    title: string;
+    description: string;
+    version?: string;
+};
+export declare function aggregateOpenAPISources(sources: OpenAPISourceDocument[], info: OpenAPIAggregationInfo): OpenAPISpec;

package/output/plugins/openapi/artifacts.d.ts

@@ -0,0 +1,6 @@
+import { ClarifyArtifact, ContentRoute, OpenAPISpec, ResolvedProjectConfig } from '../../types.js';
+import { OpenAPISourceDocument } from './aggregation.js';
+export declare function selectRootOpenAPISources(routes: ContentRoute[], projectConfig: ResolvedProjectConfig): OpenAPISourceDocument[];
+export declare function createRootOpenAPISpec(routes: ContentRoute[], projectConfig: ResolvedProjectConfig): OpenAPISpec;
+export declare function createOpenAPIRouteArtifacts(route: ContentRoute): ClarifyArtifact[];
+export declare function createRootOpenAPIArtifact(routes: ContentRoute[], projectConfig: ResolvedProjectConfig): ClarifyArtifact;

package/output/plugins/openapi/parser.d.ts

@@ -12,5 +12,5 @@ export declare function normalizeOpenAPISpecSectionIds(spec: OpenAPISpec): OpenA
 /** Filter an OpenAPI spec to only include paths that have at least one operation matching the given tags. */
 export declare function filterSpecByTags(spec: OpenAPISpec, tags: string[]): OpenAPISpec;
 /** Extract endpoint operations from an OpenAPI spec as page sections. */
-export declare function extractOpenAPISections(spec: OpenAPISpec, filterTags?: string[]): ContentSection[];
+export declare function extractOpenAPISections(spec: OpenAPISpec, filterTags?: string[], operationOrder?: string[]): ContentSection[];
 export declare function readOpenAPISpec(filePath: string, contentProcessor?: ContentProcessor, projectRoot?: string): Promise<OpenAPIParseResult>;

package/output/plugins/openapi/virtual-modules.d.ts

@@ -8,6 +8,7 @@ export declare function generateOpenAPIServerRegistryModule(openApiSpecs: Record
 export declare function generateOpenAPISpecModule(spec: OpenAPISpec): string;
 type OpenAPIPageModuleOptions = {
     specModuleId: string;
+    operationOrder?: string[];
 };
 export declare function generateOpenAPIPageModule(opts: OpenAPIPageModuleOptions): string;
 export {};

package/output/types.d.ts

@@ -146,6 +146,8 @@ export type ClarifyPagesItem = string | ClarifyPagesGroup | {
     openapi: string;
     /** Explicit route path. Defaults to the path generated from openapi and filter. */
     path?: string;
+    /** Operation IDs to render first, in the configured order. Unlisted operations keep their stable order after these. */
+    operationOrder?: string[];
     /** Icon name from lucide-react, e.g. "Webhook". */
     icon?: string;
     /** Override the page title. Defaults to spec.info.title. */
@@ -183,6 +185,7 @@ export type ClarifyOpenAPIRouteIntent = {
     kind: 'openapi';
     ref: string;
     path?: string;
+    operationOrder?: string[];
     tagFilter?: string[];
     title?: ClarifyLocalizedText;
     icon?: string;
@@ -319,6 +322,8 @@ export type ContentRouteModule = MarkdownRouteModule | OpenAPIRouteModule;
 export type OpenAPIContentRouteState = {
     /** Operation tag filter applied to this route. Undefined means all operations. */
     tagFilter?: string[];
+    /** Operation IDs to render first, in the configured order. */
+    operationOrder?: string[];
     /** Deduplicated id derived from the source OpenAPI spec file path. */
     sourceSpecId?: string;
     /** Spec virtual module id fragment used by this route after route-level filtering. */
@@ -331,8 +336,10 @@ export type ContentRouteArtifacts = {
 export type ContentRouteSource = {
     filePath: string;
     frontmatter?: Record<string, unknown>;
-    /** Normalized source content captured during route discovery. */
+    /** Original author content captured during route discovery. */
     content?: string;
+    /** Number of physical source lines removed before the stored body content. */
+    lineOffset?: number;
     /** Public edit URL for this route's source file. */
     sourceEditUrl?: string;
 };
@@ -455,6 +462,10 @@ export type ClarifyEmitAsset = {
     /** Asset content as a UTF-8 string or raw bytes. */
     source: string | Uint8Array;
 };
+export type ClarifyArtifact = ClarifyEmitAsset & {
+    /** MIME type used when the artifact is served in development. */
+    contentType: string;
+};
 export type MaybePromise<T> = T | Promise<T>;
 export type ClarifyTapHook = (ctx: ClarifyHookContext) => MaybePromise<void>;
 export type ClarifyInterceptHook = (ctx: ClarifyHookContext) => MaybePromise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clarify-labs/cli",
-  "version": "0.11.18",
+  "version": "0.11.20",
   "license": "AGPL-3.0-only",
   "type": "module",
   "repository": {
@@ -39,8 +39,8 @@
   },
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",
-    "@clarify-labs/renderer": "0.11.18",
-    "@clarify-labs/templates": "0.11.18",
+    "@clarify-labs/renderer": "0.11.20",
+    "@clarify-labs/templates": "0.11.20",
     "@mdx-js/mdx": "^3.1.1",
     "@mdx-js/rollup": "^3.1.1",
     "@modelcontextprotocol/sdk": "^1.29.0",