@clarify-labs/cli 0.10.1 → 0.10.3

package/output/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_engine = require("./engine-5bdNX2Oo.cjs");
+const require_engine = require("./engine-BDdPszs2.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 { c as defineConfig, n as createClarifyEngine, s as createViteAdapter, t as ClarifyEngine } from "./engine-Ca_2MCj9.js";
+import { c as defineConfig, n as createClarifyEngine, s as createViteAdapter, t as ClarifyEngine } from "./engine-CyFtr8Pz.js";
 export { ClarifyEngine, createClarifyEngine, createViteAdapter, defineConfig };

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

@@ -0,0 +1,12 @@
+import { ContentDiagnostic } from '@clarify-labs/renderer';
+type CreateContentDiagnosticOptions = {
+    kind: ContentDiagnostic['kind'];
+    title: string;
+    message: string;
+    error: unknown;
+    filePath?: string;
+    projectRoot?: string;
+    includeStack?: boolean;
+};
+export declare function createContentDiagnostic(options: CreateContentDiagnosticOptions): ContentDiagnostic;
+export {};

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

@@ -1,3 +1,4 @@
+import { CompileOptions } from '@mdx-js/mdx';
 import { ContentDiagnostic } from '../../types.js';
 type HastNode = {
     type: string;
@@ -7,17 +8,24 @@ type HastNode = {
     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: unknown[];
-export declare const rehypePlugins: (typeof rehypeSlugSections)[];
+export declare const rehypePlugins: NonNullable<CompileOptions['rehypePlugins']>;
+type ContentCompileDiagnosticOptions = {
+    format: 'markdown' | 'mdx';
+    phase: 'syntax' | 'compilation';
+    error: unknown;
+    filePath?: string;
+    projectRoot?: string;
+};
+export declare function createContentCompileDiagnostic(options: ContentCompileDiagnosticOptions): ContentDiagnostic;
 /**
  * Validate MDX content for diagnostics WITHOUT running the build-time rehype
  * pipeline (Shiki highlighting, slug injection, code-block parsing).
  *
  * `rehypePlugins` includes `rehypeShiki`, which loads grammar/WASM assets and
  * is expensive. The real highlighting happens at Vite build time via the
- * `@mdx-js/rollup` plugin (see `createMdxPlugin` in `core/adapters.ts`), which
+ * `@mdx-js/rollup` plugins (see `createMarkdownPlugin` and `createMdxPlugin`
+ * in `core/adapters.ts`), which
  * runs the full remark + rehype pipeline. Re-running it here, during route
  * discovery (Phase 3), would compile every `.mdx` file twice and invoke Shiki
  * once per file per `engine.refresh()` — see ARCHITECTURE.md §2.2 which states

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

@@ -13,4 +13,4 @@ export declare function normalizeOpenAPISpecSectionIds(spec: OpenAPISpec): OpenA
 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 readOpenAPISpec(filePath: string, contentProcessor?: ContentProcessor): Promise<OpenAPIParseResult>;
+export declare function readOpenAPISpec(filePath: string, contentProcessor?: ContentProcessor, projectRoot?: string): Promise<OpenAPIParseResult>;

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

@@ -1,4 +1,4 @@
-import { ContentDiagnostic, OpenAPISpec } from '../../types.js';
+import { OpenAPISpec } from '../../types.js';
 export declare const openApiRegistryModuleId = "virtual:clarify/openapi";
 export declare const openApiServerRegistryModuleId = "virtual:clarify/openapi/server";
 export declare const OPENAPI_SPEC_PREFIX = "virtual:clarify/openapi-spec/";
@@ -11,5 +11,4 @@ type OpenAPIPageModuleOptions = {
     specModuleId: string;
 };
 export declare function generateOpenAPIPageModule(opts: OpenAPIPageModuleOptions): string;
-export declare function generateOpenAPIErrorModule(diagnostic: ContentDiagnostic): string;
 export {};

package/output/types.d.ts

@@ -1,8 +1,9 @@
 import { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
 import { HtmlTagDescriptor, ViteDevServer } from 'vite';
-import { UISlotRegistration } from '@clarify-labs/renderer';
+import { ContentDiagnostic, UISlotRegistration } from '@clarify-labs/renderer';
 import { ResolvedBuildOptions } from './core/config/options.js';
 export type { ClarifyBuildOptions, ResolvedBuildOptions, } from './core/config/options.js';
+export type { ContentDiagnostic } from '@clarify-labs/renderer';
 export type OpenAPISpec = OpenAPIV3.Document | OpenAPIV3_1.Document;
 export type ClarifyLogoConfig = string | {
     light?: string;
@@ -115,7 +116,7 @@ export type ResolvedClarifyThemeConfig = {
     layout: ResolvedClarifyThemeLayoutConfig;
     editor: boolean;
 };
-export type ClarifyPagesItem = string | {
+export type ClarifyPagesItem = string | ClarifyPagesGroup | {
     page: string;
     /** Explicit route path. Defaults to the path generated from page. */
     path?: string;
@@ -144,6 +145,7 @@ export type ClarifyPagesGroup = {
     group: ClarifyLocalizedText;
     /** Icon name from lucide-react, e.g. "BookOpen". */
     icon?: string;
+    /** Pages or nested groups within this section. */
     pages: ClarifyPagesItem[];
 };
 /** Use the string "FileTree" to auto-generate pages from the file system. */
@@ -236,13 +238,6 @@ export type ContentSection = {
     badge?: string;
     tags?: string[];
 };
-export type ContentDiagnostic = {
-    kind: string;
-    title: string;
-    message: string;
-    details?: string;
-    filePath?: string;
-};
 export type ContentRouteMeta = {
     title: string;
     description?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clarify-labs/cli",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "license": "AGPL-3.0-only",
   "type": "module",
   "repository": {
@@ -39,10 +39,11 @@
   },
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",
-    "@clarify-labs/renderer": "0.10.1",
-    "@clarify-labs/templates": "0.10.1",
+    "@clarify-labs/renderer": "0.10.3",
+    "@clarify-labs/templates": "0.10.3",
     "@mdx-js/mdx": "^3.1.1",
     "@mdx-js/rollup": "^3.1.1",
+    "@shikijs/rehype": "^4.3.0",
     "@tailwindcss/vite": "^4.3.2",
     "@vitejs/plugin-react": "^6.0.3",
     "cac": "^7.0.0",
@@ -57,6 +58,8 @@
     "react-router": "^7.0.0",
     "react-router-dom": "^7.0.0",
     "react-zoom-pan-pinch": "^4.0.3",
+    "rehype-raw": "^7.0.0",
+    "rehype-slug": "^6.0.0",
     "remark": "^15.0.1",
     "remark-gfm": "^4.0.1",
     "shiki": "4.3.0",