@clarify-labs/cli 0.10.2 → 0.11.0

package/output/index.cjs

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

@@ -10,6 +10,14 @@ type HastNode = {
 export declare function rehypeParseCodeBlocks(): (tree: HastNode) => void;
 export declare const remarkPlugins: unknown[];
 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).

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

@@ -1,4 +1,4 @@
-import { ContentRoute, ContentSection, ClarifyNavigationNode, ClarifyPagesConfig, ClarifyPagesGroup, ClarifyPagesItem, ClarifyRouteIntent, ClarifyLocalizedText, ClarifyTabsConfig, LocalizedNavigation, LocalizedTabbedNavigation, ResolvedClarifyI18nConfig, TabbedNavigation } from '../../types.js';
+import { ContentRoute, ContentSection, ClarifyNavigationNode, ClarifyPagesConfig, ClarifyPagesGroup, ClarifyPagesItem, ClarifyRouteIntent, ClarifyLocalizedText, ClarifyTabsConfig, LocalizedNavigation, LocalizedTabbedNavigation, ResolvedClarifyLocalesConfig, TabbedNavigation } from '../../types.js';
 import { ContentProcessor } from '../content/content.js';
 export type FindContentRoutesOptions = {
     contentProcessor?: ContentProcessor;
@@ -12,15 +12,15 @@ export declare function basePathFromRef(ref: string): string;
 export declare function openAPIPagePathFromRef(ref: string, tagFilter?: string[], explicitPath?: string): string;
 export declare function routePathFromRef(ref: string, explicitPath?: string): string;
 export declare function virtualModuleIdFromRef(ref: string): string;
-export declare function localizedRoutePath(basePath: string, locale: string, _i18n: ResolvedClarifyI18nConfig): string;
+export declare function localizedRoutePath(basePath: string, locale: string, _i18n: ResolvedClarifyLocalesConfig): string;
 export declare function resolveLocalizedText(text: ClarifyLocalizedText | undefined, locale: string, fallbackLocale?: string): string | undefined;
 export declare function findContentRoutes(dir: string, base?: string, options?: FindContentRoutesOptions): Promise<ContentRoute[]>;
-export declare function withAlternates(route: ContentRoute, routes: ContentRoute[], i18n: ResolvedClarifyI18nConfig): ContentRoute;
-export declare function findLocalizedContentRoutes(contentRoot: string, i18n?: ResolvedClarifyI18nConfig, options?: FindContentRoutesOptions): Promise<ContentRoute[]>;
+export declare function withAlternates(route: ContentRoute, routes: ContentRoute[], locales: ResolvedClarifyLocalesConfig): ContentRoute;
+export declare function findLocalizedContentRoutes(contentRoot: string, locales?: ResolvedClarifyLocalesConfig, options?: FindContentRoutesOptions): Promise<ContentRoute[]>;
 export declare function buildNavigation(routes: ContentRoute[]): ClarifyNavigationNode[];
 export declare function routeIntentFromPagesItem(item: ClarifyPagesItem): ClarifyRouteIntent;
-export declare function applyConfiguredPageRoutePaths(routes: ContentRoute[], tabs?: ClarifyTabsConfig, i18n?: ResolvedClarifyI18nConfig): ContentRoute[];
+export declare function applyConfiguredPageRoutePaths(routes: ContentRoute[], tabs?: ClarifyTabsConfig, locales?: ResolvedClarifyLocalesConfig): ContentRoute[];
 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: ClarifyPagesConfig | undefined, i18n?: ResolvedClarifyI18nConfig): LocalizedNavigation | undefined;
-export declare function buildLocalizedNavigationFromTabsConfig(routes: ContentRoute[], tabs: ClarifyTabsConfig, i18n?: ResolvedClarifyI18nConfig): LocalizedTabbedNavigation | undefined;
+export declare function buildLocalizedNavigation(routes: ContentRoute[], config: ClarifyPagesConfig | undefined, localesConfig?: ResolvedClarifyLocalesConfig): LocalizedNavigation | undefined;
+export declare function buildLocalizedNavigationFromTabsConfig(routes: ContentRoute[], tabs: ClarifyTabsConfig, localesConfig?: ResolvedClarifyLocalesConfig): LocalizedTabbedNavigation | undefined;

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

@@ -1,4 +1,4 @@
-import { ContentRoute, ResolvedClarifyI18nConfig } from '../../types.js';
+import { ContentRoute, ResolvedClarifyLocalesConfig } from '../../types.js';
 type ContentRouteFixture = Partial<Omit<ContentRoute, 'kind' | 'meta' | 'module' | 'source'>> & {
     kind?: ContentRoute['kind'];
     title?: string;
@@ -16,5 +16,5 @@ type ContentRouteFixture = Partial<Omit<ContentRoute, 'kind' | 'meta' | 'module'
 };
 export declare function contentRoute(route?: ContentRouteFixture): ContentRoute;
 export declare function mdxRoute(route?: ContentRouteFixture): ContentRoute;
-export declare const testI18n: ResolvedClarifyI18nConfig;
+export declare const testI18n: ResolvedClarifyLocalesConfig;
 export {};

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/plugins/source-links/source-links.d.ts

@@ -1,3 +1,3 @@
-import { ClarifySourceConfig, ContentRoute } from '../../types.js';
-export declare function createSourceEditUrl(filePath: string, contentRoot: string, source: ClarifySourceConfig): string;
-export declare function attachSourceEditUrls(routes: ContentRoute[], contentRoot: string, source?: ClarifySourceConfig): void;
+import { ClarifyRepositoryConfig, ContentRoute } from '../../types.js';
+export declare function createSourceEditUrl(filePath: string, contentRoot: string, source: ClarifyRepositoryConfig): string;
+export declare function attachSourceEditUrls(routes: ContentRoute[], contentRoot: string, source?: ClarifyRepositoryConfig): void;

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;
@@ -18,14 +19,16 @@ export type ClarifyLocaleConfig = {
     label: string;
     dir?: 'ltr' | 'rtl';
 };
-export type ClarifyI18nConfig = {
-    /** Default visible locale. Content is read from rootDirectory/defaultLocale. */
-    defaultLocale?: string;
+export type ClarifyLocalesConfig = {
+    /** Default visible locale. Localized content is read from rootDirectory/<locale>. */
+    default?: string;
     /** Missing translation behavior. Fallback uses default locale content. */
     missing?: 'fallback' | '404' | 'hide';
     locales: ClarifyLocaleConfig[];
 };
-export type ResolvedClarifyI18nConfig = Required<Pick<ClarifyI18nConfig, 'defaultLocale' | 'missing'>> & {
+export type ResolvedClarifyLocalesConfig = {
+    default: string;
+    missing: 'fallback' | '404' | 'hide';
     locales: ClarifyLocaleConfig[];
 };
 export type ClarifyNavbarLink = {
@@ -48,10 +51,10 @@ export type ClarifyVariableValue = ClarifyVariablePrimitive | {
     [key: string]: ClarifyVariableValue;
 };
 export type ClarifyVariablesConfig = Record<string, ClarifyVariableValue>;
-export type ClarifySourceConfig = {
+export type ClarifyRepositoryConfig = {
     /** Repository web URL, for example https://github.com/owner/repo. */
-    repository: string;
-    /** Source branch used for edit links. Default: main. */
+    url?: string;
+    /** Source branch. Default: main. */
     branch?: string;
     /** Directory prefix inside the repository that maps to rootDirectory. */
     directory?: string;
@@ -101,8 +104,6 @@ export type ClarifyThemeConfig = {
     tokens?: ClarifyThemeTokensConfig;
     /** Documentation layout overrides applied on top of the selected preset. */
     layout?: ClarifyThemeLayoutConfig;
-    /** Expose the live theme editor in the built site. Dev mode enables it automatically. */
-    editor?: boolean;
 };
 export type ResolvedClarifyThemeTokensConfig = {
     colors: Required<ClarifyThemeColorTokensConfig>;
@@ -113,9 +114,8 @@ export type ResolvedClarifyThemeConfig = {
     preset: ClarifyThemePreset;
     tokens: ResolvedClarifyThemeTokensConfig;
     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 +144,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. */
@@ -173,6 +174,44 @@ export type ClarifyTabItem = {
     pages?: ClarifyPagesConfig;
 };
 export type ClarifyTabsConfig = ClarifyTabItem[];
+export type ClarifyNavigationConfig = {
+    /** Links displayed in the top navigation. */
+    links?: ClarifyNavbarLink[];
+    /** Top-level documentation tabs. Each tab owns its sidebar pages. */
+    tabs?: ClarifyTabsConfig;
+};
+export type ClarifyFeatureConfig<Options extends object = Record<never, never>> = boolean | ({
+    enabled?: boolean;
+} & Options);
+export type ClarifyFeaturesConfig = {
+    search?: ClarifyFeatureConfig<{
+        provider?: 'pagefind';
+    }>;
+    repository?: ClarifyFeatureConfig<ClarifyRepositoryConfig>;
+    themeEditor?: ClarifyFeatureConfig;
+    openapi?: ClarifyFeatureConfig<{
+        playground?: boolean;
+    }>;
+};
+export type ResolvedClarifyFeaturesConfig = {
+    search: {
+        enabled: boolean;
+        provider: 'pagefind';
+    };
+    repository: {
+        enabled: boolean;
+        url?: string;
+        branch?: string;
+        directory?: string;
+    };
+    themeEditor: {
+        enabled: boolean;
+    };
+    openapi: {
+        enabled: boolean;
+        playground: boolean;
+    };
+};
 export type ClarifyProjectConfig = {
     /** Site title. Used in Header and SEO meta tags. */
     title?: string;
@@ -180,54 +219,47 @@ export type ClarifyProjectConfig = {
     description?: string;
     /** Canonical public site URL. Enables sitemap.xml and robots.txt generation. */
     siteUrl?: string;
-    /** Source repository configuration for Edit this page links. */
-    source?: ClarifySourceConfig;
+    /** Route prefix where the site is mounted. Default: '/'. */
+    routePrefix?: string;
+    /** Path or URL prefix for emitted assets. Defaults to routePrefix. */
+    assetPrefix?: string;
     /** Path to site logo image (relative to rootDirectory or absolute). Supports light/dark mode. */
     logo?: ClarifyLogoConfig;
     /** URL used when clicking the top navigation logo. Defaults to '/'. */
     homeUrl?: string;
     /** Favicon path or light/dark variants. */
     favicon?: ClarifyFaviconConfig;
-    /** Theme preset, token overrides, and editor options. */
+    /** Theme preset, token overrides, and layout options. */
     theme?: ClarifyThemeConfig;
-    /** Base path for the docs site. Default: '/' */
-    routePrefix?: string;
-    /** Base path or URL for emitted static assets. Defaults to routePrefix. */
-    assetPrefix?: string;
-    /** Top navigation links. */
-    navbar?: {
-        links?: ClarifyNavbarLink[];
-    };
+    /** Top navigation links and documentation tabs. */
+    navigation?: ClarifyNavigationConfig;
     /** Announcement banner displayed at the top of the page. */
     banner?: ClarifyBannerConfig;
     /** Footer configuration. */
     footer?: ClarifyFooterConfig;
+    /** Localized content configuration. */
+    locales?: ClarifyLocalesConfig;
     /** Reusable constants available in supported content via {{ variableName }} placeholders. */
     variables?: ClarifyVariablesConfig;
-    /** Native multi-language support. Locale content lives under rootDirectory/{locale}. */
-    i18n?: ClarifyI18nConfig;
-    /** Top-level documentation tabs. Each tab owns its own sidebar pages. */
-    tabs?: ClarifyTabsConfig;
+    /** Optional product capabilities. All built-in features are enabled by default. */
+    features?: ClarifyFeaturesConfig;
 };
 export type ResolvedProjectConfig = {
     title: string;
-    logo?: ClarifyLogoConfig;
-    homeUrl?: string;
     description: string;
     siteUrl?: string;
-    source?: ClarifySourceConfig;
     routePrefix: string;
     assetPrefix: string;
+    logo?: ClarifyLogoConfig;
+    homeUrl?: string;
     favicon?: ClarifyFaviconConfig;
     theme: ResolvedClarifyThemeConfig;
-    navbar?: {
-        links?: ClarifyNavbarLink[];
-    };
+    navigation?: ClarifyNavigationConfig;
     banner?: ClarifyBannerConfig;
     footer?: ClarifyFooterConfig;
+    locales?: ResolvedClarifyLocalesConfig;
     variables: ClarifyVariablesConfig;
-    i18n?: ResolvedClarifyI18nConfig;
-    tabs?: ClarifyTabsConfig;
+    features: ResolvedClarifyFeaturesConfig;
 };
 export type ContentSection = {
     id: string;
@@ -236,13 +268,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.2",
+  "version": "0.11.0",
   "license": "AGPL-3.0-only",
   "type": "module",
   "repository": {
@@ -39,8 +39,8 @@
   },
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",
-    "@clarify-labs/renderer": "0.10.2",
-    "@clarify-labs/templates": "0.10.2",
+    "@clarify-labs/renderer": "0.11.0",
+    "@clarify-labs/templates": "0.11.0",
     "@mdx-js/mdx": "^3.1.1",
     "@mdx-js/rollup": "^3.1.1",
     "@shikijs/rehype": "^4.3.0",