@barodoc/core 7.0.0 → 8.0.0

package/dist/{chunk-RPBSSV23.js → chunk-AWCA5ON6.js}

@@ -85,6 +85,11 @@ var tabSchema = z.object({
   label: z.string(),
   href: z.string()
 });
+var sectionSchema = z.object({
+  slug: z.string(),
+  label: z.string().optional(),
+  navigation: z.array(navItemSchema)
+});
 var barodocConfigSchema = z.object({
   name: z.string(),
   logo: z.string().optional(),
@@ -94,6 +99,7 @@ var barodocConfigSchema = z.object({
   theme: themeConfigSchema,
   i18n: i18nConfigSchema,
   navigation: z.array(navItemSchema),
+  sections: z.array(sectionSchema).optional(),
   tabs: z.array(tabSchema).optional(),
   topbar: topbarSchema,
   search: searchSchema,

package/dist/config/index.d.ts

@@ -1,4 +1,4 @@
-export { B as BarodocConfigInput, a as BarodocConfigOutput, D as DocsFrontmatter, b as barodocConfigSchema, d as docsFrontmatterSchema, c as getConfigDefaults, l as loadConfig } from '../index-C7DDzFCv.js';
+export { B as BarodocConfigInput, a as BarodocConfigOutput, D as DocsFrontmatter, b as barodocConfigSchema, d as docsFrontmatterSchema, c as getConfigDefaults, l as loadConfig } from '../index-BJ7u7rXv.js';
 import 'zod';
-import '../types-C59QVIss.js';
+import '../types-C0xL7b0Y.js';
 import 'astro';

package/dist/config/index.js

@@ -3,7 +3,7 @@ import {
   docsFrontmatterSchema,
   getConfigDefaults,
   loadConfig
-} from "../chunk-RPBSSV23.js";
+} from "../chunk-AWCA5ON6.js";
 export {
   barodocConfigSchema,
   docsFrontmatterSchema,

package/dist/i18n/index.d.ts

@@ -1,4 +1,4 @@
-import { b as BarodocI18nConfig, c as BarodocNavItem } from '../types-C59QVIss.js';
+import { b as BarodocI18nConfig, c as BarodocNavItem } from '../types-C0xL7b0Y.js';
 import 'astro';
 
 declare function getLocaleFromPath(path: string, i18n: BarodocI18nConfig): string;

package/dist/{index-C7DDzFCv.d.ts → index-BJ7u7rXv.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { R as ResolvedBarodocConfig, a as BarodocConfig } from './types-C59QVIss.js';
+import { R as ResolvedBarodocConfig, a as BarodocConfig } from './types-C0xL7b0Y.js';
 
 declare const grayPresets: readonly ["zinc", "slate", "neutral", "stone", "gray"];
 type GrayPreset = (typeof grayPresets)[number];
@@ -148,6 +148,34 @@ declare const barodocConfigSchema: z.ZodObject<{
         group: z.ZodString;
         pages: z.ZodArray<z.ZodString, "many">;
     }, z.ZodTypeAny, "passthrough">>, "many">;
+    sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        navigation: z.ZodArray<z.ZodObject<{
+            group: z.ZodString;
+            pages: z.ZodArray<z.ZodString, "many">;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            group: z.ZodString;
+            pages: z.ZodArray<z.ZodString, "many">;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            group: z.ZodString;
+            pages: z.ZodArray<z.ZodString, "many">;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        navigation: z.objectOutputType<{
+            group: z.ZodString;
+            pages: z.ZodArray<z.ZodString, "many">;
+        }, z.ZodTypeAny, "passthrough">[];
+        label?: string | undefined;
+    }, {
+        slug: string;
+        navigation: z.objectInputType<{
+            group: z.ZodString;
+            pages: z.ZodArray<z.ZodString, "many">;
+        }, z.ZodTypeAny, "passthrough">[];
+        label?: string | undefined;
+    }>, "many">>;
     tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         href: z.ZodString;
@@ -230,11 +258,11 @@ declare const barodocConfigSchema: z.ZodObject<{
     plugins: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>], null>]>, "many">>;
     customCss: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     navigation: z.objectOutputType<{
         group: z.ZodString;
         pages: z.ZodArray<z.ZodString, "many">;
     }, z.ZodTypeAny, "passthrough">[];
+    name: string;
     lastUpdated?: boolean | undefined;
     logo?: string | undefined;
     favicon?: string | undefined;
@@ -263,6 +291,14 @@ declare const barodocConfigSchema: z.ZodObject<{
         locales: string[];
         labels?: Record<string, string> | undefined;
     } | undefined;
+    sections?: {
+        slug: string;
+        navigation: z.objectOutputType<{
+            group: z.ZodString;
+            pages: z.ZodArray<z.ZodString, "many">;
+        }, z.ZodTypeAny, "passthrough">[];
+        label?: string | undefined;
+    }[] | undefined;
     tabs?: {
         label: string;
         href: string;
@@ -298,11 +334,11 @@ declare const barodocConfigSchema: z.ZodObject<{
     plugins?: (string | [string, Record<string, unknown>])[] | undefined;
     customCss?: string[] | undefined;
 }, {
-    name: string;
     navigation: z.objectInputType<{
         group: z.ZodString;
         pages: z.ZodArray<z.ZodString, "many">;
     }, z.ZodTypeAny, "passthrough">[];
+    name: string;
     lastUpdated?: boolean | undefined;
     logo?: string | undefined;
     favicon?: string | undefined;
@@ -331,6 +367,14 @@ declare const barodocConfigSchema: z.ZodObject<{
         locales: string[];
         labels?: Record<string, string> | undefined;
     } | undefined;
+    sections?: {
+        slug: string;
+        navigation: z.objectInputType<{
+            group: z.ZodString;
+            pages: z.ZodArray<z.ZodString, "many">;
+        }, z.ZodTypeAny, "passthrough">[];
+        label?: string | undefined;
+    }[] | undefined;
     tabs?: {
         label: string;
         href: string;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { AstroIntegration } from 'astro';
-import { B as BarodocOptions } from './types-C59QVIss.js';
-export { a as BarodocConfig, b as BarodocI18nConfig, c as BarodocNavItem, d as BarodocPlugin, e as BarodocPluginFactory, f as BarodocPluginHooks, g as BarodocThemeColors, h as BarodocThemeConfig, i as BuildContext, C as ContentContext, P as PluginConfig, j as PluginContext, R as ResolvedBarodocConfig, k as ResolvedPlugin, T as ThemeExport } from './types-C59QVIss.js';
-export { D as DocsFrontmatter, G as GrayPreset, b as barodocConfigSchema, d as docsFrontmatterSchema, g as grayPresets, l as loadConfig } from './index-C7DDzFCv.js';
+import { B as BarodocOptions } from './types-C0xL7b0Y.js';
+export { a as BarodocConfig, b as BarodocI18nConfig, c as BarodocNavItem, d as BarodocPlugin, e as BarodocPluginFactory, f as BarodocPluginHooks, g as BarodocSection, h as BarodocThemeColors, i as BarodocThemeConfig, j as BuildContext, C as ContentContext, P as PluginConfig, k as PluginContext, R as ResolvedBarodocConfig, l as ResolvedPlugin, T as ThemeExport } from './types-C0xL7b0Y.js';
+export { D as DocsFrontmatter, G as GrayPreset, b as barodocConfigSchema, d as docsFrontmatterSchema, g as grayPresets, l as loadConfig } from './index-BJ7u7rXv.js';
 export { getLocaleFromPath, getLocaleLabel, getLocalizedNavGroup, getLocalizedPath, removeLocaleFromPath } from './i18n/index.js';
 export { definePlugin, getPluginIntegrations, loadPlugins, runConfigHook, runHook } from './plugins/index.js';
 import 'zod';

package/dist/index.js

@@ -1,3 +1,9 @@
+import {
+  barodocConfigSchema,
+  docsFrontmatterSchema,
+  grayPresets,
+  loadConfig
+} from "./chunk-AWCA5ON6.js";
 import {
   getLocaleFromPath,
   getLocaleLabel,
@@ -12,16 +18,11 @@ import {
   runConfigHook,
   runHook
 } from "./chunk-UICDSNBG.js";
-import {
-  barodocConfigSchema,
-  docsFrontmatterSchema,
-  grayPresets,
-  loadConfig
-} from "./chunk-RPBSSV23.js";
 
 // src/integration.ts
 import { existsSync } from "fs";
 import { join } from "path";
+import { fileURLToPath } from "url";
 var VIRTUAL_CONFIG_ID = "virtual:barodoc/config";
 var VIRTUAL_I18N_ID = "virtual:barodoc/i18n";
 function resolveVirtualId(id) {
@@ -54,6 +55,8 @@ function createVirtualModulesPlugin(config) {
 function barodoc(options) {
   const configPath = options.config || "barodoc.config.json";
   let resolvedConfig;
+  let resolvedPlugins = [];
+  let pluginCtx;
   return {
     name: "@barodoc/core",
     hooks: {
@@ -68,28 +71,28 @@ function barodoc(options) {
         resolvedConfig = await loadConfig(configPath, rootPath);
         logger.info(`Loaded config: ${resolvedConfig.name}`);
         const mode = command === "dev" ? "development" : "production";
-        const pluginContext = {
+        pluginCtx = {
           config: resolvedConfig,
           root: rootPath,
           mode
         };
         const pluginConfigs = resolvedConfig.plugins ?? [];
-        const plugins = await loadPlugins(pluginConfigs, pluginContext);
+        resolvedPlugins = await loadPlugins(pluginConfigs, pluginCtx);
         resolvedConfig = await runConfigHook(
-          plugins,
+          resolvedPlugins,
           resolvedConfig,
-          pluginContext
+          pluginCtx
         );
-        pluginContext.config = resolvedConfig;
-        if (plugins.length > 0) {
-          logger.info(`Loaded ${plugins.length} plugin(s)`);
+        pluginCtx.config = resolvedConfig;
+        if (resolvedPlugins.length > 0) {
+          logger.info(`Loaded ${resolvedPlugins.length} plugin(s)`);
         }
         const i18nConfig = resolvedConfig.i18n || {
           defaultLocale: "en",
           locales: ["en"]
         };
         const themeIntegration = options.theme.integration(resolvedConfig);
-        const pluginIntegrations = getPluginIntegrations(plugins, pluginContext);
+        const pluginIntegrations = getPluginIntegrations(resolvedPlugins, pluginCtx);
         const overridesDir = join(rootPath, "overrides");
         const overridesAlias = {};
         if (existsSync(join(overridesDir, "components"))) {
@@ -113,6 +116,23 @@ function barodoc(options) {
       },
       "astro:config:done": ({ logger }) => {
         logger.info("Barodoc setup complete");
+      },
+      "astro:build:start": async ({ logger }) => {
+        if (resolvedPlugins.length > 0) {
+          await runHook(resolvedPlugins, "build:start", pluginCtx);
+          logger.info("Plugin build:start hooks executed");
+        }
+      },
+      "astro:build:done": async ({ dir, pages, logger }) => {
+        if (resolvedPlugins.length > 0) {
+          const outDir = dir instanceof URL ? fileURLToPath(dir) : String(dir);
+          const buildContext = {
+            outDir,
+            pages: pages.map((p) => p.pathname)
+          };
+          await runHook(resolvedPlugins, "build:done", buildContext, pluginCtx);
+          logger.info("Plugin build:done hooks executed");
+        }
       }
     }
   };

package/dist/plugins/index.d.ts

@@ -1,5 +1,5 @@
-import { k as ResolvedPlugin, j as PluginContext, P as PluginConfig, R as ResolvedBarodocConfig, f as BarodocPluginHooks, d as BarodocPlugin } from '../types-C59QVIss.js';
-export { e as BarodocPluginFactory, i as BuildContext, C as ContentContext } from '../types-C59QVIss.js';
+import { l as ResolvedPlugin, k as PluginContext, P as PluginConfig, R as ResolvedBarodocConfig, f as BarodocPluginHooks, d as BarodocPlugin } from '../types-C0xL7b0Y.js';
+export { e as BarodocPluginFactory, j as BuildContext, C as ContentContext } from '../types-C0xL7b0Y.js';
 import * as astro from 'astro';
 
 /**

package/dist/{types-C59QVIss.d.ts → types-C0xL7b0Y.d.ts}

@@ -114,6 +114,11 @@ interface BarodocThemeConfig {
     };
     radius?: string;
 }
+interface BarodocSection {
+    slug: string;
+    label?: string;
+    navigation: BarodocNavItem[];
+}
 interface BarodocConfig {
     name: string;
     logo?: string;
@@ -123,6 +128,8 @@ interface BarodocConfig {
     theme?: BarodocThemeConfig;
     i18n?: BarodocI18nConfig;
     navigation: BarodocNavItem[];
+    /** Additional doc sections beyond the default "docs" (e.g. help, guides). */
+    sections?: BarodocSection[];
     tabs?: {
         label: string;
         href: string;
@@ -181,4 +188,4 @@ interface ResolvedBarodocConfig extends BarodocConfig {
     _configPath: string;
 }
 
-export type { BarodocOptions as B, ContentContext as C, PluginConfig as P, ResolvedBarodocConfig as R, ThemeExport as T, BarodocConfig as a, BarodocI18nConfig as b, BarodocNavItem as c, BarodocPlugin as d, BarodocPluginFactory as e, BarodocPluginHooks as f, BarodocThemeColors as g, BarodocThemeConfig as h, BuildContext as i, PluginContext as j, ResolvedPlugin as k };
+export type { BarodocOptions as B, ContentContext as C, PluginConfig as P, ResolvedBarodocConfig as R, ThemeExport as T, BarodocConfig as a, BarodocI18nConfig as b, BarodocNavItem as c, BarodocPlugin as d, BarodocPluginFactory as e, BarodocPluginHooks as f, BarodocSection as g, BarodocThemeColors as h, BarodocThemeConfig as i, BuildContext as j, PluginContext as k, ResolvedPlugin as l };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barodoc/core",
-  "version": "7.0.0",
+  "version": "8.0.0",
   "description": "Core integration for Barodoc documentation framework",
   "type": "module",
   "main": "./dist/index.js",