nextjs-cms 0.9.21 → 0.9.23

package/dist/core/types/index.d.ts

@@ -13,6 +13,23 @@ export type SidebarItemProps = {
     item: NavItem;
     closeSideBar?: () => void;
 };
+export type SidebarPluginLeaf = {
+    kind: 'leaf';
+    title: string;
+    path: string;
+    icon?: string;
+};
+export type SidebarPluginGroup = {
+    kind: 'group';
+    title: string;
+    icon?: string;
+    children: NavItem[];
+};
+export type SidebarPluginItem = SidebarPluginLeaf | SidebarPluginGroup;
+export type SidebarPluginGroupProps = {
+    group: SidebarPluginGroup;
+    closeSideBar?: () => void;
+};
 export type EmailItem = {
     email: string;
     domain: string;

package/dist/core/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export * from './api/index.js';
 export * from './auth/index.js';
 export * from './core/index.js';
 export * from './db/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA"}

package/dist/index.js

@@ -1,4 +1,3 @@
-export * from './api/index.js';
 export * from './auth/index.js';
 export * from './core/index.js';
 export * from './db/index.js';

package/dist/plugins/client.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+export declare function PluginTRPCProvider({ trpc, children }: {
+    trpc: unknown;
+    children: ReactNode;
+}): React.JSX.Element;
+/**
+ * Read the host app's tRPC React client from inside a plugin client component.
+ *
+ * Must be rendered under `NextjsCmsProvider` (the host app's `<NextjsCmsProvider>` does this automatically).
+ * Plugins pass a structural type describing the procedures they call, e.g.:
+ *
+ * ```ts
+ * type TrpcLike = { myPlugin?: { getData: { useQuery: () => { data?: unknown } } } }
+ * const trpc = usePluginTRPC<TrpcLike>()
+ * ```
+ */
+export declare function usePluginTRPC<TTRPC>(): TTRPC;
+//# sourceMappingURL=client.d.ts.map

package/dist/plugins/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/plugins/client.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAoC,MAAM,OAAO,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,wBAAgB,kBAAkB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,qBAE5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,KAOhB,KAAK,CACvB"}

package/dist/plugins/client.js

@@ -0,0 +1,24 @@
+'use client';
+import React, { createContext, useContext } from 'react';
+const PluginTRPCContext = createContext(null);
+export function PluginTRPCProvider({ trpc, children }) {
+    return React.createElement(PluginTRPCContext.Provider, { value: trpc }, children);
+}
+/**
+ * Read the host app's tRPC React client from inside a plugin client component.
+ *
+ * Must be rendered under `NextjsCmsProvider` (the host app's `<NextjsCmsProvider>` does this automatically).
+ * Plugins pass a structural type describing the procedures they call, e.g.:
+ *
+ * ```ts
+ * type TrpcLike = { myPlugin?: { getData: { useQuery: () => { data?: unknown } } } }
+ * const trpc = usePluginTRPC<TrpcLike>()
+ * ```
+ */
+export function usePluginTRPC() {
+    const trpc = useContext(PluginTRPCContext);
+    if (!trpc) {
+        throw new Error('usePluginTRPC must be used inside NextjsCmsProvider.');
+    }
+    return trpc;
+}

package/dist/plugins/define.d.ts

@@ -0,0 +1,4 @@
+import type { CMSPluginMultiRoute, CMSPluginSingleRoute } from './loader.js';
+export declare function definePlugin(plugin: CMSPluginSingleRoute): CMSPluginSingleRoute;
+export declare function definePlugin(plugin: CMSPluginMultiRoute): CMSPluginMultiRoute;
+//# sourceMappingURL=define.d.ts.map

package/dist/plugins/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/plugins/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvF,wBAAgB,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAAA;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAAA"}

package/dist/plugins/define.js

@@ -0,0 +1,3 @@
+export function definePlugin(plugin) {
+    return plugin;
+}

package/dist/plugins/derive.d.ts

@@ -0,0 +1,32 @@
+export declare const PLUGIN_PACKAGE_PREFIX = "@nextjscms/plugin-";
+/**
+ * Derive a plugin's canonical internal name from its npm package name.
+ *
+ * Convention: every plugin package MUST be named "@nextjscms/plugin-<slug>"
+ * (kebab-case slug). The derived name is "plugin_<slug_in_snake_case>".
+ *
+ * Examples:
+ *   "@nextjscms/plugin-cpanel-dashboard"  → "plugin_cpanel_dashboard"
+ *   "@nextjscms/plugin-google-analytics"  → "plugin_google_analytics"
+ *
+ * Throws on packages that do not follow the convention.
+ */
+export declare function derivePluginName(pluginPackage: string): string;
+/**
+ * Derive a plugin's tRPC router key (camelCase) from its npm package name.
+ * Used as the key in the merged tRPC router (e.g. `trpc.cpanelDashboard.*`).
+ *
+ * Examples:
+ *   "@nextjscms/plugin-cpanel-dashboard"  → "cpanelDashboard"
+ *   "@nextjscms/plugin-google-analytics"  → "googleAnalytics"
+ */
+export declare function derivePluginRouterKey(pluginPackage: string): string;
+/**
+ * Helper for plugin routers: derive the plugin's canonical name by reading
+ * its own package.json. Pass `import.meta.url` from the plugin's router file.
+ *
+ * Walks up from the calling module's directory until it finds a package.json
+ * with a "name" field, then applies {@link derivePluginName}.
+ */
+export declare function extractPluginName(importMetaUrl: string): string;
+//# sourceMappingURL=derive.d.ts.map

package/dist/plugins/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/plugins/derive.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,uBAAuB,CAAA;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAe9D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAanE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAmB/D"}

package/dist/plugins/derive.js

@@ -0,0 +1,77 @@
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+export const PLUGIN_PACKAGE_PREFIX = '@nextjscms/plugin-';
+/**
+ * Derive a plugin's canonical internal name from its npm package name.
+ *
+ * Convention: every plugin package MUST be named "@nextjscms/plugin-<slug>"
+ * (kebab-case slug). The derived name is "plugin_<slug_in_snake_case>".
+ *
+ * Examples:
+ *   "@nextjscms/plugin-cpanel-dashboard"  → "plugin_cpanel_dashboard"
+ *   "@nextjscms/plugin-google-analytics"  → "plugin_google_analytics"
+ *
+ * Throws on packages that do not follow the convention.
+ */
+export function derivePluginName(pluginPackage) {
+    if (!pluginPackage.startsWith(PLUGIN_PACKAGE_PREFIX)) {
+        throw new Error(`[plugins] Invalid plugin package "${pluginPackage}". ` +
+            `Plugin packages must be named "${PLUGIN_PACKAGE_PREFIX}<slug>".`);
+    }
+    const slug = pluginPackage.slice(PLUGIN_PACKAGE_PREFIX.length);
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug)) {
+        throw new Error(`[plugins] Invalid plugin slug in "${pluginPackage}". ` +
+            `Slug must be lowercase kebab-case (a-z, 0-9, hyphen).`);
+    }
+    return `plugin_${slug.replace(/-/g, '_')}`;
+}
+/**
+ * Derive a plugin's tRPC router key (camelCase) from its npm package name.
+ * Used as the key in the merged tRPC router (e.g. `trpc.cpanelDashboard.*`).
+ *
+ * Examples:
+ *   "@nextjscms/plugin-cpanel-dashboard"  → "cpanelDashboard"
+ *   "@nextjscms/plugin-google-analytics"  → "googleAnalytics"
+ */
+export function derivePluginRouterKey(pluginPackage) {
+    if (!pluginPackage.startsWith(PLUGIN_PACKAGE_PREFIX)) {
+        throw new Error(`[plugins] Invalid plugin package "${pluginPackage}". ` +
+            `Plugin packages must be named "${PLUGIN_PACKAGE_PREFIX}<slug>".`);
+    }
+    const slug = pluginPackage.slice(PLUGIN_PACKAGE_PREFIX.length);
+    const [first, ...rest] = slug.split('-').filter(Boolean);
+    if (!first) {
+        throw new Error(`[plugins] Invalid plugin slug in "${pluginPackage}".`);
+    }
+    return first + rest.map((part) => part[0]?.toUpperCase() + part.slice(1)).join('');
+}
+/**
+ * Helper for plugin routers: derive the plugin's canonical name by reading
+ * its own package.json. Pass `import.meta.url` from the plugin's router file.
+ *
+ * Walks up from the calling module's directory until it finds a package.json
+ * with a "name" field, then applies {@link derivePluginName}.
+ */
+export function extractPluginName(importMetaUrl) {
+    const startDir = path.dirname(fileURLToPath(importMetaUrl));
+    let dir = startDir;
+    while (true) {
+        const candidate = path.join(dir, 'package.json');
+        if (fs.existsSync(candidate)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(candidate, 'utf8'));
+                if (parsed.name)
+                    return derivePluginName(parsed.name);
+            }
+            catch {
+                // continue walking
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            throw new Error(`[plugins] extractPluginName: could not find package.json starting from "${startDir}".`);
+        }
+        dir = parent;
+    }
+}

package/dist/plugins/loader.d.ts

@@ -10,12 +10,10 @@ export interface CMSPlugin {
      */
     title: MultilingualString;
     /**
-     * The internal name of the plugin.
-     * It should start with 'plugin_' and be in snake_case.
-     * @example 'plugin_cpanel_emails'
+     * Optional sidebar icon for the plugin group (multi-route, when `groupRoutes !== false`).
+     * Single-route plugins use the route's own `icon` instead.
      */
-    name: string;
-    registryName: string;
+    icon?: IconName;
     version?: string;
     router?: any;
     routes?: PluginRoute[];
@@ -24,9 +22,16 @@ export interface CMSPlugin {
 export interface PluginInitContext {
     config: PluginConfigEntry;
 }
+/**
+ * A plugin instance after loading. The canonical "name" is derived from the
+ * plugin's npm package name (see {@link derivePluginName}), not authored.
+ */
+export interface ResolvedPlugin extends CMSPlugin {
+    name: string;
+}
 export interface LoadedPlugin {
     config: PluginConfigEntry;
-    plugin: CMSPlugin;
+    plugin: ResolvedPlugin;
     moduleName: string;
     routerKey: string;
 }
@@ -44,6 +49,13 @@ export interface PluginRoute {
     title: MultilingualString;
     icon?: IconName | undefined;
     component?: string;
+    /**
+     * Dot-paths into the host's tRPC router (e.g. `'cpanelEmails.getEmails'`) that the
+     * host should prefetch on the server before rendering the plugin's component. The
+     * results are placed into the React Query cache and hydrated into the client tree
+     * via the host-rendered `<HydrateClient>` boundary.
+     */
+    prefetch?: string | string[];
 }
 export type PluginRouteWithoutComponent = Omit<PluginRoute, 'component'> & {
     component?: never;
@@ -54,7 +66,6 @@ export type PluginRouteWithComponent = PluginRoute & {
 export interface LoadedPluginRoute extends PluginRoute {
     pluginId: string;
     pluginName: string;
-    pluginRegistryName: string;
 }
 type CMSPluginBase = Omit<CMSPlugin, 'routes'>;
 export type CMSPluginSingleRoute = CMSPluginBase & {
@@ -69,6 +80,39 @@ export declare const loadPluginModule: (pluginPackage: string) => Promise<unknow
 export declare function loadPlugins(): Promise<LoadedPlugin[]>;
 export declare function getPluginRoutes(): Promise<LoadedPluginRoute[]>;
 export declare function findPluginRouteByPath(path: string): Promise<LoadedPluginRoute | null>;
+/**
+ * Sidebar entry for a plugin: either a single leaf (single-route plugin or
+ * multi-route with `groupRoutes: false`) or a collapsible group containing the
+ * plugin's routes as children (multi-route, `groupRoutes !== false`).
+ */
+export type PluginNavLeaf = {
+    kind: 'leaf';
+    title: MultilingualString;
+    path: string;
+    icon?: IconName;
+    pluginName: string;
+};
+export type PluginNavGroup = {
+    kind: 'group';
+    title: MultilingualString;
+    icon?: IconName;
+    pluginName: string;
+    children: {
+        title: MultilingualString;
+        path: string;
+        icon?: IconName;
+    }[];
+};
+export type PluginNavItem = PluginNavLeaf | PluginNavGroup;
+/**
+ * Returns the navigation structure for all loaded plugins, accounting for
+ * `groupRoutes` and per-plugin `override` resolution. Single-route plugins emit
+ * one leaf. Multi-route plugins emit a group (default) or one leaf per route
+ * when `groupRoutes: false`.
+ *
+ * Pure data — does not filter by privilege. The sidebar layer applies that.
+ */
+export declare function getPluginNavigation(): Promise<PluginNavItem[]>;
 /**
  * Gets the dashboard override plugin route if configured.
  * @returns The LoadedPluginRoute for the dashboard override, or null if not configured

package/dist/plugins/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"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"}

package/dist/plugins/loader.js

@@ -5,30 +5,24 @@ if (typeof window !== 'undefined') {
 import { createRequire } from 'module';
 import path from 'path';
 import { getCMSConfig, getConfigImportVersion } from '../core/config/index.js';
-import chalk from 'chalk';
+import { derivePluginName, derivePluginRouterKey } from './derive.js';
+import { logWarn, logError, logInfo } from '../utils/console-log.js';
 export function definePlugin(plugin) {
     return plugin;
 }
-const deriveRouterKey = (packageName) => {
-    const baseName = packageName.split('/').pop() ?? packageName;
-    const withoutPrefix = baseName.startsWith('plugin-') ? baseName.slice('plugin-'.length) : baseName;
-    const parts = withoutPrefix.split(/[-_]/g).filter(Boolean);
-    const [first, ...rest] = parts;
-    let key = first ? first + rest.map((part) => part[0]?.toUpperCase() + part.slice(1)).join('') : withoutPrefix;
-    if (!key) {
-        key = baseName.replace(/[^A-Za-z0-9_]/g, '_');
-    }
-    if (!/^[A-Za-z_]/.test(key)) {
-        key = `plugin${key ? key[0]?.toUpperCase() + key.slice(1) : ''}`;
-    }
-    return key;
-};
 let cachedPlugins = null;
 let cachedConfigVersion = -1;
 let loadPromise = null;
 let jitiInstance = null;
 const appRequire = createRequire(path.join(process.cwd(), 'package.json'));
 const pkgRequire = createRequire(import.meta.url);
+let serverOnlyEmptyPath = null;
+const getServerOnlyEmptyPath = () => {
+    if (!serverOnlyEmptyPath) {
+        serverOnlyEmptyPath = path.join(path.dirname(pkgRequire.resolve('server-only')), 'empty.js');
+    }
+    return serverOnlyEmptyPath;
+};
 const resolvePluginPath = (pluginPackage) => {
     try {
         return appRequire.resolve(pluginPackage);
@@ -54,6 +48,9 @@ export const loadPluginModule = async (pluginPackage) => {
             fsCache: true,
             moduleCache: true,
             rebuildFsCache: true,
+            alias: {
+                'server-only': getServerOnlyEmptyPath(),
+            },
             // Optional: nicer debugging in stack traces (off by default in jiti)
             // sourceMaps: true,
         });
@@ -70,31 +67,59 @@ function resolvePluginInstance(registration, mod) {
             ? mod.default()
             : (mod.default ?? mod.plugin);
     if (!candidate) {
-        console.warn(`[plugins] Plugin "${registration.package}" did not return a plugin instance`);
+        logWarn('plugins', `Plugin "${registration.package}" did not return a plugin instance.`);
         return null;
     }
-    if (!candidate.name || !candidate.title) {
-        console.warn(`[plugins] Plugin "${registration.package}" is missing required "name" or "title". Skipping.`);
+    if (!candidate.title) {
+        logWarn('plugins', `Plugin "${registration.package}" is missing required "title". Skipping.`);
         return null;
     }
-    // Apply config-level title override if provided
-    const resolvedTitle = registration.title ?? candidate.title;
-    // Apply route-level title overrides if provided
-    // For single-route plugins, the config-level title also applies to the route
-    const isSingleRoute = (candidate.routes?.length ?? 0) <= 1;
-    const resolvedRoutes = (candidate.routes ?? []).map((route) => {
-        const routeOverride = registration.routes?.[route.path];
-        // Priority: route-specific override > config title (single-route only) > route default
-        const effectiveTitle = routeOverride?.title ?? (isSingleRoute ? registration.title : undefined) ?? route.title;
-        return {
-            ...route,
-            title: effectiveTitle,
-        };
+    const name = derivePluginName(registration.package);
+    const pkg = registration.package;
+    const override = registration.override;
+    const declaredRoutes = candidate.routes ?? [];
+    const isSingleRoute = declaredRoutes.length <= 1;
+    const groupRoutes = registration.groupRoutes ?? true;
+    // Validate override.routes keys against declared paths
+    if (override?.routes) {
+        const declaredPaths = new Set(declaredRoutes.map((r) => r.path));
+        for (const path of Object.keys(override.routes)) {
+            if (!declaredPaths.has(path)) {
+                const known = Array.from(declaredPaths).join(', ') || '(none)';
+                logWarn('plugins', `override.routes["${path}"] in "${pkg}" does not match any declared route. Known paths: ${known}`);
+            }
+        }
+    }
+    // Warn on ineffective override shapes
+    if (!isSingleRoute && groupRoutes === false && (override?.title || override?.icon)) {
+        logWarn('plugins', `override.title / override.icon set for "${pkg}" but groupRoutes is false — group label is not rendered, so these have no effect.`);
+    }
+    // Resolve route titles/icons
+    const resolvedRoutes = declaredRoutes.map((route) => {
+        let title = route.title;
+        let icon = route.icon;
+        // Single-route: plugin-level override applies to the route itself.
+        if (isSingleRoute) {
+            if (override?.title)
+                title = override.title;
+            if (override?.icon)
+                icon = override.icon;
+        }
+        // Per-route override always wins over plugin-level.
+        const routeOverride = override?.routes?.[route.path];
+        if (routeOverride?.title)
+            title = routeOverride.title;
+        if (routeOverride?.icon)
+            icon = routeOverride.icon;
+        return { ...route, title, icon };
     });
+    // Resolve plugin-level title/icon — only used as group label for multi-route grouped plugins.
+    const resolvedPluginTitle = !isSingleRoute && override?.title ? override.title : candidate.title;
+    const resolvedPluginIcon = !isSingleRoute && override?.icon ? override.icon : candidate.icon;
     return {
-        title: resolvedTitle,
-        name: candidate.name,
-        registryName: candidate.registryName,
+        title: resolvedPluginTitle,
+        icon: resolvedPluginIcon,
+        name,
         version: candidate.version,
         router: candidate.router,
         routes: resolvedRoutes,
@@ -113,13 +138,15 @@ export async function loadPlugins() {
         const config = await getCMSConfig();
         const registrations = config.plugins ?? [];
         const seenPackages = new Set();
-        const seenRouterKeys = new Set();
+        const seenNames = new Set();
         const loaded = [];
         for (const registration of registrations) {
             if (!registration.package) {
-                console.warn(`[plugins] Plugin registration is missing "package" field.`);
-                console.warn(`[plugins] Please check your cms.config.ts file.`);
-                console.warn(`[plugins] Skipping this plugin registration.`);
+                logWarn('plugins', 'Plugin registration is missing "package" field — check your cms.config.ts. Skipping.');
+                continue;
+            }
+            if (seenPackages.has(registration.package)) {
+                logError('plugins', `Duplicate plugin package "${registration.package}" registered. Skipping duplicate.`);
                 continue;
             }
             const mod = await loadPluginModule(registration.package);
@@ -128,30 +155,25 @@ export async function loadPlugins() {
             const plugin = resolvePluginInstance(registration, mod);
             if (!plugin)
                 continue;
-            const routerKey = deriveRouterKey(registration.package);
-            if (seenPackages.has(registration.package)) {
-                console.error(`[plugins] Duplicate plugin package "${registration.package}" registered. Skipping duplicate.`);
-                continue;
-            }
-            if (seenRouterKeys.has(routerKey)) {
-                console.error(`[plugins] Duplicate plugin router key "${routerKey}" derived from "${registration.package}". Skipping.`);
+            if (seenNames.has(plugin.name)) {
+                logError('plugins', `Duplicate plugin name "${plugin.name}" derived from "${registration.package}". Skipping.`);
                 continue;
             }
             seenPackages.add(registration.package);
-            seenRouterKeys.add(routerKey);
+            seenNames.add(plugin.name);
             if (typeof plugin.init === 'function') {
                 try {
                     await plugin.init({ config: registration });
                 }
                 catch (error) {
-                    console.error(`[plugins] Plugin "${registration.package}" init failed:`, error);
+                    logError('plugins', `Plugin "${registration.package}" init failed.`, error);
                 }
             }
             loaded.push({
                 config: registration,
                 plugin,
                 moduleName: registration.package,
-                routerKey,
+                routerKey: derivePluginRouterKey(registration.package),
             });
         }
         cachedPlugins = loaded;
@@ -172,17 +194,16 @@ export async function getPluginRoutes() {
         const requireComponent = routes.length > 1;
         return routes.map((route) => {
             if (requireComponent && !route.component) {
-                console.warn(chalk.red(`[plugins] Route "${route.path}" from "${entry.config.package}" should set "component" because the plugin defines multiple routes.`));
+                logWarn('plugins', `Route "${route.path}" from "${entry.config.package}" should set "component" because the plugin defines multiple routes.`);
             }
             if (!requireComponent && route.component) {
-                console.warn(chalk.gray(`[plugins] Route "${route.path}" from "${entry.config.package}" should omit "component" and export a default component, because the plugin defines a single route.`));
+                logInfo('plugins', `Route "${route.path}" from "${entry.config.package}" should omit "component" and export a default component, because the plugin defines a single route.`);
             }
             return {
                 ...route,
                 title: route.title,
                 pluginId: entry.config.package,
                 pluginName: entry.plugin.name,
-                pluginRegistryName: entry.plugin.registryName,
             };
         });
     });
@@ -192,6 +213,45 @@ export async function findPluginRouteByPath(path) {
     const routes = await getPluginRoutes();
     return routes.find((route) => route.path === normalized) ?? null;
 }
+/**
+ * Returns the navigation structure for all loaded plugins, accounting for
+ * `groupRoutes` and per-plugin `override` resolution. Single-route plugins emit
+ * one leaf. Multi-route plugins emit a group (default) or one leaf per route
+ * when `groupRoutes: false`.
+ *
+ * Pure data — does not filter by privilege. The sidebar layer applies that.
+ */
+export async function getPluginNavigation() {
+    const loaded = await loadPlugins();
+    const items = [];
+    for (const entry of loaded) {
+        const routes = entry.plugin.routes ?? [];
+        if (routes.length === 0)
+            continue;
+        const isSingleRoute = routes.length === 1;
+        const groupRoutes = entry.config.groupRoutes ?? true;
+        if (isSingleRoute || !groupRoutes) {
+            for (const route of routes) {
+                items.push({
+                    kind: 'leaf',
+                    title: route.title,
+                    path: route.path,
+                    icon: route.icon,
+                    pluginName: entry.plugin.name,
+                });
+            }
+            continue;
+        }
+        items.push({
+            kind: 'group',
+            title: entry.plugin.title,
+            icon: entry.plugin.icon,
+            pluginName: entry.plugin.name,
+            children: routes.map((r) => ({ title: r.title, path: r.path, icon: r.icon })),
+        });
+    }
+    return items;
+}
 /**
  * Gets the dashboard override plugin route if configured.
  * @returns The LoadedPluginRoute for the dashboard override, or null if not configured

package/dist/plugins/manifest.d.ts

@@ -0,0 +1,28 @@
+import type { PluginConfigEntry } from '../core/config/config-loader.js';
+import type { MultilingualString } from '../translations/language-utils.js';
+import type { IconName } from 'lucide-react/dynamic';
+export interface PluginManifestRoute {
+    path: string;
+    title: MultilingualString;
+    icon?: IconName;
+    component?: string;
+}
+export interface PluginManifest {
+    name: string;
+    registryName: string;
+    title: MultilingualString;
+    routes?: PluginManifestRoute[];
+}
+export interface LoadedPluginManifestRoute extends PluginManifestRoute {
+    pluginId: string;
+    pluginName: string;
+    pluginRegistryName: string;
+}
+export interface LoadedPluginManifest {
+    config: PluginConfigEntry;
+    manifest: PluginManifest;
+    moduleName: string;
+}
+export declare function getPluginManifests(): Promise<LoadedPluginManifest[]>;
+export declare function getPluginRouteManifests(): Promise<LoadedPluginManifestRoute[]>;
+//# sourceMappingURL=manifest.d.ts.map