@mercurjs/dashboard-sdk 2.3.6-canary.8 → 2.3.6

package/dist/index.d.cts

@@ -1,65 +1,6 @@
-import { a as Permission } from './types-Cziny1v0.cjs';
-export { B as BuiltMercurConfig, M as MercurConfig, P as PERMISSION_RIGHT_RANK, b as PermissionKey, c as PermissionKeys, d as PermissionMap, e as PermissionRight, f as PermissionsContextValue, R as RouteConfig, g as RouteHandle, h as buildPermission, p as parsePermission, s as satisfiesPermission } from './types-Cziny1v0.cjs';
-import { ComponentType, ReactNode } from 'react';
-
-/**
- * Open registry interfaces. Each panel package ships a generated
- * `extension-targets.d.ts` that seeds the built-in ids into these interfaces
- * (declaration merging), and a developer augments them by hand to register a
- * zone their own page renders. The helper unions read off the interface keys.
- *
- * @example
- * declare module "@mercurjs/dashboard-sdk" {
- *   interface WidgetZoneRegistry {
- *     "erp.dashboard.before": true
- *   }
- * }
- */
-interface WidgetZoneRegistry {
-}
-interface NavItemRegistry {
-}
-interface NavParentRegistry {
-}
-type WidgetZoneId = keyof WidgetZoneRegistry extends never ? string : keyof WidgetZoneRegistry;
-type NavItemId = keyof NavItemRegistry extends never ? string : keyof NavItemRegistry;
-type NavParentId = keyof NavParentRegistry extends never ? string : keyof NavParentRegistry;
-/**
- * A widget is a React component attached to a named zone on a page. The
- * placement (`before | after`) is encoded as the zone-id suffix, so there is no
- * separate rank field — multiple `before`/`after` widgets stack in registration
- * order.
- */
-interface WidgetConfig {
-    zone: WidgetZoneId | WidgetZoneId[];
-    /** Stable id; derived from the file path at build time when omitted. */
-    id?: string;
-    /**
-     * Permission(s) the actor needs for the widget to render. With several, any
-     * one is enough.
-     */
-    permission?: Permission | Permission[];
-}
-/** Override for a single built-in navigation item. */
-interface NavItemOverride {
-    id: NavItemId;
-    /** Order within the item's parent (or among top-level items). */
-    rank?: number;
-    /** Remove from the sidebar (route may still be reachable directly). */
-    hidden?: boolean;
-    /** i18n key or literal replacing the item's label. */
-    label?: string;
-    /** Icon component replacing the item's icon. */
-    icon?: ComponentType;
-    /**
-     * Re-parent the item: a built-in parent id moves it under that parent's
-     * children; `null` promotes a nested item to the top level.
-     */
-    nested?: NavParentId | null;
-}
-interface NavigationConfig {
-    items: NavItemOverride[];
-}
+import { h as NavigationConfig, W as WidgetConfig } from './types-BTgTMD_t.cjs';
+export { B as BuiltMercurConfig, M as MercurConfig, N as NavGroupConfig, a as NavGroupId, b as NavGroupRegistry, c as NavItemId, d as NavItemOverride, e as NavItemRegistry, f as NavParentId, g as NavParentRegistry, P as PERMISSION_RIGHT_RANK, i as Permission, j as PermissionKey, k as PermissionKeys, l as PermissionMap, m as PermissionRight, n as PermissionsContextValue, R as RouteConfig, o as RouteHandle, p as WidgetZoneId, q as WidgetZoneRegistry, r as buildPermission, s as parsePermission, t as satisfiesPermission } from './types-BTgTMD_t.cjs';
+import { ReactNode, ComponentType } from 'react';
 
 /**
  * Minimal structural stand-in for a Zod schema, so the SDK stays free of a zod
@@ -154,10 +95,35 @@ type CustomColumn = {
         value?: unknown;
     }>;
 };
+type CustomListFilterOption = {
+    label: string;
+    value: unknown;
+};
+/**
+ * ADD (unknown key), REPLACE (built-in key + a full filter definition), or
+ * REMOVE (built-in key + `remove: true`) a list filter. Mirrors
+ * `CustomDisplayField`: the `key` is the query param the filter writes.
+ */
+type CustomListFilter = ({
+    key: string;
+    label: string;
+    remove?: never;
+} & ({
+    type: "select";
+    options: CustomListFilterOption[];
+    multiple?: boolean;
+    searchable?: boolean;
+} | {
+    type: "date" | "string" | "number";
+    options?: never;
+})) | {
+    key: string;
+    remove: true;
+};
 type CustomListExtension = {
     columns?: CustomColumn[];
     bulkActions?: SectionAction[];
-    filters?: unknown[];
+    filters?: CustomListFilter[];
     viewDefaults?: {
         columnVisibility?: Record<string, boolean>;
         columnOrder?: string[];
@@ -195,7 +161,7 @@ interface CustomFieldsConfig<TModel extends CustomFieldModel = CustomFieldModel>
 }
 
 declare function defineWidgetConfig(config: WidgetConfig): WidgetConfig;
-declare function defineNavigationConfig(config: NavigationConfig): NavigationConfig;
+declare function defineNavigationConfig<TGroup extends string = never>(config: NavigationConfig<TGroup>): NavigationConfig<TGroup>;
 declare function defineCustomFieldsConfig<TModel extends CustomFieldModel>(config: CustomFieldsConfig<TModel>): CustomFieldsConfig<TModel>;
 
-export { type ActivityEntry, type CustomColumn, type CustomDisplayEntry, type CustomDisplayField, type CustomFieldAction, type CustomFieldActionRegistry, type CustomFieldModel, type CustomFieldsConfig, type CustomFieldsRegistry, type CustomFormEntry, type CustomFormField, type CustomFormTab, type CustomFormZone, type CustomListExtension, type FieldValidation, type NavItemId, type NavItemOverride, type NavItemRegistry, type NavParentId, type NavParentRegistry, type NavigationConfig, Permission, type SectionAction, type WidgetConfig, type WidgetZoneId, type WidgetZoneRegistry, defineCustomFieldsConfig, defineNavigationConfig, defineWidgetConfig };
+export { type ActivityEntry, type CustomColumn, type CustomDisplayEntry, type CustomDisplayField, type CustomFieldAction, type CustomFieldActionRegistry, type CustomFieldModel, type CustomFieldsConfig, type CustomFieldsRegistry, type CustomFormEntry, type CustomFormField, type CustomFormTab, type CustomFormZone, type CustomListExtension, type CustomListFilter, type CustomListFilterOption, type FieldValidation, NavigationConfig, type SectionAction, WidgetConfig, defineCustomFieldsConfig, defineNavigationConfig, defineWidgetConfig };

package/dist/index.d.ts

@@ -1,65 +1,6 @@
-import { a as Permission } from './types-Cziny1v0.js';
-export { B as BuiltMercurConfig, M as MercurConfig, P as PERMISSION_RIGHT_RANK, b as PermissionKey, c as PermissionKeys, d as PermissionMap, e as PermissionRight, f as PermissionsContextValue, R as RouteConfig, g as RouteHandle, h as buildPermission, p as parsePermission, s as satisfiesPermission } from './types-Cziny1v0.js';
-import { ComponentType, ReactNode } from 'react';
-
-/**
- * Open registry interfaces. Each panel package ships a generated
- * `extension-targets.d.ts` that seeds the built-in ids into these interfaces
- * (declaration merging), and a developer augments them by hand to register a
- * zone their own page renders. The helper unions read off the interface keys.
- *
- * @example
- * declare module "@mercurjs/dashboard-sdk" {
- *   interface WidgetZoneRegistry {
- *     "erp.dashboard.before": true
- *   }
- * }
- */
-interface WidgetZoneRegistry {
-}
-interface NavItemRegistry {
-}
-interface NavParentRegistry {
-}
-type WidgetZoneId = keyof WidgetZoneRegistry extends never ? string : keyof WidgetZoneRegistry;
-type NavItemId = keyof NavItemRegistry extends never ? string : keyof NavItemRegistry;
-type NavParentId = keyof NavParentRegistry extends never ? string : keyof NavParentRegistry;
-/**
- * A widget is a React component attached to a named zone on a page. The
- * placement (`before | after`) is encoded as the zone-id suffix, so there is no
- * separate rank field — multiple `before`/`after` widgets stack in registration
- * order.
- */
-interface WidgetConfig {
-    zone: WidgetZoneId | WidgetZoneId[];
-    /** Stable id; derived from the file path at build time when omitted. */
-    id?: string;
-    /**
-     * Permission(s) the actor needs for the widget to render. With several, any
-     * one is enough.
-     */
-    permission?: Permission | Permission[];
-}
-/** Override for a single built-in navigation item. */
-interface NavItemOverride {
-    id: NavItemId;
-    /** Order within the item's parent (or among top-level items). */
-    rank?: number;
-    /** Remove from the sidebar (route may still be reachable directly). */
-    hidden?: boolean;
-    /** i18n key or literal replacing the item's label. */
-    label?: string;
-    /** Icon component replacing the item's icon. */
-    icon?: ComponentType;
-    /**
-     * Re-parent the item: a built-in parent id moves it under that parent's
-     * children; `null` promotes a nested item to the top level.
-     */
-    nested?: NavParentId | null;
-}
-interface NavigationConfig {
-    items: NavItemOverride[];
-}
+import { h as NavigationConfig, W as WidgetConfig } from './types-BTgTMD_t.js';
+export { B as BuiltMercurConfig, M as MercurConfig, N as NavGroupConfig, a as NavGroupId, b as NavGroupRegistry, c as NavItemId, d as NavItemOverride, e as NavItemRegistry, f as NavParentId, g as NavParentRegistry, P as PERMISSION_RIGHT_RANK, i as Permission, j as PermissionKey, k as PermissionKeys, l as PermissionMap, m as PermissionRight, n as PermissionsContextValue, R as RouteConfig, o as RouteHandle, p as WidgetZoneId, q as WidgetZoneRegistry, r as buildPermission, s as parsePermission, t as satisfiesPermission } from './types-BTgTMD_t.js';
+import { ReactNode, ComponentType } from 'react';
 
 /**
  * Minimal structural stand-in for a Zod schema, so the SDK stays free of a zod
@@ -154,10 +95,35 @@ type CustomColumn = {
         value?: unknown;
     }>;
 };
+type CustomListFilterOption = {
+    label: string;
+    value: unknown;
+};
+/**
+ * ADD (unknown key), REPLACE (built-in key + a full filter definition), or
+ * REMOVE (built-in key + `remove: true`) a list filter. Mirrors
+ * `CustomDisplayField`: the `key` is the query param the filter writes.
+ */
+type CustomListFilter = ({
+    key: string;
+    label: string;
+    remove?: never;
+} & ({
+    type: "select";
+    options: CustomListFilterOption[];
+    multiple?: boolean;
+    searchable?: boolean;
+} | {
+    type: "date" | "string" | "number";
+    options?: never;
+})) | {
+    key: string;
+    remove: true;
+};
 type CustomListExtension = {
     columns?: CustomColumn[];
     bulkActions?: SectionAction[];
-    filters?: unknown[];
+    filters?: CustomListFilter[];
     viewDefaults?: {
         columnVisibility?: Record<string, boolean>;
         columnOrder?: string[];
@@ -195,7 +161,7 @@ interface CustomFieldsConfig<TModel extends CustomFieldModel = CustomFieldModel>
 }
 
 declare function defineWidgetConfig(config: WidgetConfig): WidgetConfig;
-declare function defineNavigationConfig(config: NavigationConfig): NavigationConfig;
+declare function defineNavigationConfig<TGroup extends string = never>(config: NavigationConfig<TGroup>): NavigationConfig<TGroup>;
 declare function defineCustomFieldsConfig<TModel extends CustomFieldModel>(config: CustomFieldsConfig<TModel>): CustomFieldsConfig<TModel>;
 
-export { type ActivityEntry, type CustomColumn, type CustomDisplayEntry, type CustomDisplayField, type CustomFieldAction, type CustomFieldActionRegistry, type CustomFieldModel, type CustomFieldsConfig, type CustomFieldsRegistry, type CustomFormEntry, type CustomFormField, type CustomFormTab, type CustomFormZone, type CustomListExtension, type FieldValidation, type NavItemId, type NavItemOverride, type NavItemRegistry, type NavParentId, type NavParentRegistry, type NavigationConfig, Permission, type SectionAction, type WidgetConfig, type WidgetZoneId, type WidgetZoneRegistry, defineCustomFieldsConfig, defineNavigationConfig, defineWidgetConfig };
+export { type ActivityEntry, type CustomColumn, type CustomDisplayEntry, type CustomDisplayField, type CustomFieldAction, type CustomFieldActionRegistry, type CustomFieldModel, type CustomFieldsConfig, type CustomFieldsRegistry, type CustomFormEntry, type CustomFormField, type CustomFormTab, type CustomFormZone, type CustomListExtension, type CustomListFilter, type CustomListFilterOption, type FieldValidation, NavigationConfig, type SectionAction, WidgetConfig, defineCustomFieldsConfig, defineNavigationConfig, defineWidgetConfig };

package/dist/{types-Cziny1v0.d.cts → types-BTgTMD_t.d.cts}

@@ -95,6 +95,93 @@ declare function parsePermission(permission: string): {
 declare function buildPermission(key: PermissionKey, right: PermissionRight): Permission;
 declare function satisfiesPermission(permissions: PermissionMap, key: string, right: PermissionRight): boolean;
 
+/**
+ * Open registry interfaces. Each panel package ships a generated
+ * `extension-targets.d.ts` that seeds the built-in ids into these interfaces
+ * (declaration merging), and a developer augments them by hand to register a
+ * zone their own page renders. The helper unions read off the interface keys.
+ *
+ * @example
+ * declare module "@mercurjs/dashboard-sdk" {
+ *   interface WidgetZoneRegistry {
+ *     "erp.dashboard.before": true
+ *   }
+ * }
+ */
+interface WidgetZoneRegistry {
+}
+interface NavItemRegistry {
+}
+interface NavParentRegistry {
+}
+interface NavGroupRegistry {
+}
+type WidgetZoneId = keyof WidgetZoneRegistry extends never ? string : keyof WidgetZoneRegistry;
+type NavItemId = keyof NavItemRegistry extends never ? string : keyof NavItemRegistry;
+type NavParentId = keyof NavParentRegistry extends never ? string : keyof NavParentRegistry;
+type NavGroupId = keyof NavGroupRegistry extends never ? string : keyof NavGroupRegistry;
+/**
+ * A widget is a React component attached to a named zone on a page. The
+ * placement (`before | after`) is encoded as the zone-id suffix, so there is no
+ * separate rank field — multiple `before`/`after` widgets stack in registration
+ * order.
+ */
+interface WidgetConfig {
+    zone: WidgetZoneId | WidgetZoneId[];
+    /** Stable id; derived from the file path at build time when omitted. */
+    id?: string;
+    /**
+     * Permission(s) the actor needs for the widget to render. With several, any
+     * one is enough.
+     */
+    permission?: Permission | Permission[];
+    /**
+     * i18n key or literal naming the tab. Required for a `*.tabs.*` zone, where
+     * the widget renders as a tab's panel; ignored elsewhere.
+     */
+    label?: string;
+}
+/** Override for a single built-in navigation item. */
+interface NavItemOverride<TGroup extends string = never> {
+    id: NavItemId;
+    /** Order within the item's parent (or among top-level items). */
+    rank?: number;
+    /** Remove from the sidebar (route may still be reachable directly). */
+    hidden?: boolean;
+    /** i18n key or literal replacing the item's label. */
+    label?: string;
+    /** Icon component replacing the item's icon. */
+    icon?: ComponentType;
+    /**
+     * Re-parent the item: a built-in parent id moves it under that parent's
+     * children; `null` promotes a nested item to the top level.
+     */
+    nested?: NavParentId | null;
+    /**
+     * List the item under a group heading: a built-in settings group id or one
+     * declared in `groups`. Main sidebar items only join declared groups.
+     */
+    group?: NavGroupId | TGroup;
+}
+/**
+ * Declares a sidebar group, or overrides a built-in settings group by id. A
+ * group renders in whichever sidebar its items live in.
+ */
+interface NavGroupConfig<TId extends string = string> {
+    id: NavGroupId | TId;
+    /** i18n key (with `translationNs`) or literal. Falls back to the id. */
+    label?: string;
+    translationNs?: string;
+    /** Order among groups, lower first. Built-in settings groups rank 0, 1, 2… */
+    rank?: number;
+    /** Remove the group and its items from the sidebar. */
+    hidden?: boolean;
+}
+interface NavigationConfig<TGroup extends string = never> {
+    groups?: NavGroupConfig<TGroup>[];
+    items?: NavItemOverride<NoInfer<TGroup>>[];
+}
+
 /**
  * Configuration for the Mercur dashboard plugin.
  *
@@ -162,6 +249,12 @@ type RouteConfig = {
     icon?: ComponentType;
     rank?: number;
     nested?: string;
+    /**
+     * Sidebar group to list the route under: one declared in `_navigation.ts`
+     * or, for a `/settings/*` route, a built-in settings group. Must be a
+     * string literal.
+     */
+    group?: NavGroupId | (string & {});
     translationNs?: string;
     public?: boolean;
     /**
@@ -186,4 +279,4 @@ type RouteHandle = {
     breadcrumb?: (match: never) => ReactNode;
 };
 
-export { type BuiltMercurConfig as B, type MercurConfig as M, PERMISSION_RIGHT_RANK as P, type RouteConfig as R, type Permission as a, type PermissionKey as b, type PermissionKeys as c, type PermissionMap as d, type PermissionRight as e, type PermissionsContextValue as f, type RouteHandle as g, buildPermission as h, parsePermission as p, satisfiesPermission as s };
+export { type BuiltMercurConfig as B, type MercurConfig as M, type NavGroupConfig as N, PERMISSION_RIGHT_RANK as P, type RouteConfig as R, type WidgetConfig as W, type NavGroupId as a, type NavGroupRegistry as b, type NavItemId as c, type NavItemOverride as d, type NavItemRegistry as e, type NavParentId as f, type NavParentRegistry as g, type NavigationConfig as h, type Permission as i, type PermissionKey as j, type PermissionKeys as k, type PermissionMap as l, type PermissionRight as m, type PermissionsContextValue as n, type RouteHandle as o, type WidgetZoneId as p, type WidgetZoneRegistry as q, buildPermission as r, parsePermission as s, satisfiesPermission as t };

package/dist/{types-Cziny1v0.d.ts → types-BTgTMD_t.d.ts}

@@ -95,6 +95,93 @@ declare function parsePermission(permission: string): {
 declare function buildPermission(key: PermissionKey, right: PermissionRight): Permission;
 declare function satisfiesPermission(permissions: PermissionMap, key: string, right: PermissionRight): boolean;
 
+/**
+ * Open registry interfaces. Each panel package ships a generated
+ * `extension-targets.d.ts` that seeds the built-in ids into these interfaces
+ * (declaration merging), and a developer augments them by hand to register a
+ * zone their own page renders. The helper unions read off the interface keys.
+ *
+ * @example
+ * declare module "@mercurjs/dashboard-sdk" {
+ *   interface WidgetZoneRegistry {
+ *     "erp.dashboard.before": true
+ *   }
+ * }
+ */
+interface WidgetZoneRegistry {
+}
+interface NavItemRegistry {
+}
+interface NavParentRegistry {
+}
+interface NavGroupRegistry {
+}
+type WidgetZoneId = keyof WidgetZoneRegistry extends never ? string : keyof WidgetZoneRegistry;
+type NavItemId = keyof NavItemRegistry extends never ? string : keyof NavItemRegistry;
+type NavParentId = keyof NavParentRegistry extends never ? string : keyof NavParentRegistry;
+type NavGroupId = keyof NavGroupRegistry extends never ? string : keyof NavGroupRegistry;
+/**
+ * A widget is a React component attached to a named zone on a page. The
+ * placement (`before | after`) is encoded as the zone-id suffix, so there is no
+ * separate rank field — multiple `before`/`after` widgets stack in registration
+ * order.
+ */
+interface WidgetConfig {
+    zone: WidgetZoneId | WidgetZoneId[];
+    /** Stable id; derived from the file path at build time when omitted. */
+    id?: string;
+    /**
+     * Permission(s) the actor needs for the widget to render. With several, any
+     * one is enough.
+     */
+    permission?: Permission | Permission[];
+    /**
+     * i18n key or literal naming the tab. Required for a `*.tabs.*` zone, where
+     * the widget renders as a tab's panel; ignored elsewhere.
+     */
+    label?: string;
+}
+/** Override for a single built-in navigation item. */
+interface NavItemOverride<TGroup extends string = never> {
+    id: NavItemId;
+    /** Order within the item's parent (or among top-level items). */
+    rank?: number;
+    /** Remove from the sidebar (route may still be reachable directly). */
+    hidden?: boolean;
+    /** i18n key or literal replacing the item's label. */
+    label?: string;
+    /** Icon component replacing the item's icon. */
+    icon?: ComponentType;
+    /**
+     * Re-parent the item: a built-in parent id moves it under that parent's
+     * children; `null` promotes a nested item to the top level.
+     */
+    nested?: NavParentId | null;
+    /**
+     * List the item under a group heading: a built-in settings group id or one
+     * declared in `groups`. Main sidebar items only join declared groups.
+     */
+    group?: NavGroupId | TGroup;
+}
+/**
+ * Declares a sidebar group, or overrides a built-in settings group by id. A
+ * group renders in whichever sidebar its items live in.
+ */
+interface NavGroupConfig<TId extends string = string> {
+    id: NavGroupId | TId;
+    /** i18n key (with `translationNs`) or literal. Falls back to the id. */
+    label?: string;
+    translationNs?: string;
+    /** Order among groups, lower first. Built-in settings groups rank 0, 1, 2… */
+    rank?: number;
+    /** Remove the group and its items from the sidebar. */
+    hidden?: boolean;
+}
+interface NavigationConfig<TGroup extends string = never> {
+    groups?: NavGroupConfig<TGroup>[];
+    items?: NavItemOverride<NoInfer<TGroup>>[];
+}
+
 /**
  * Configuration for the Mercur dashboard plugin.
  *
@@ -162,6 +249,12 @@ type RouteConfig = {
     icon?: ComponentType;
     rank?: number;
     nested?: string;
+    /**
+     * Sidebar group to list the route under: one declared in `_navigation.ts`
+     * or, for a `/settings/*` route, a built-in settings group. Must be a
+     * string literal.
+     */
+    group?: NavGroupId | (string & {});
     translationNs?: string;
     public?: boolean;
     /**
@@ -186,4 +279,4 @@ type RouteHandle = {
     breadcrumb?: (match: never) => ReactNode;
 };
 
-export { type BuiltMercurConfig as B, type MercurConfig as M, PERMISSION_RIGHT_RANK as P, type RouteConfig as R, type Permission as a, type PermissionKey as b, type PermissionKeys as c, type PermissionMap as d, type PermissionRight as e, type PermissionsContextValue as f, type RouteHandle as g, buildPermission as h, parsePermission as p, satisfiesPermission as s };
+export { type BuiltMercurConfig as B, type MercurConfig as M, type NavGroupConfig as N, PERMISSION_RIGHT_RANK as P, type RouteConfig as R, type WidgetConfig as W, type NavGroupId as a, type NavGroupRegistry as b, type NavItemId as c, type NavItemOverride as d, type NavItemRegistry as e, type NavParentId as f, type NavParentRegistry as g, type NavigationConfig as h, type Permission as i, type PermissionKey as j, type PermissionKeys as k, type PermissionMap as l, type PermissionRight as m, type PermissionsContextValue as n, type RouteHandle as o, type WidgetZoneId as p, type WidgetZoneRegistry as q, buildPermission as r, parsePermission as s, satisfiesPermission as t };

package/dist/vite.cjs

@@ -464,6 +464,13 @@ function processConfigProperties(properties) {
   if (nested && (0, import_types.isObjectProperty)(nested) && (0, import_types.isStringLiteral)(nested.value)) {
     nestedValue = nested.value.value;
   }
+  const group = properties.find(
+    (prop) => (0, import_types.isObjectProperty)(prop) && (0, import_types.isIdentifier)(prop.key, { name: "group" })
+  );
+  let groupValue;
+  if (group && (0, import_types.isObjectProperty)(group) && (0, import_types.isStringLiteral)(group.value)) {
+    groupValue = group.value.value;
+  }
   const translationNs = properties.find(
     (prop) => (0, import_types.isObjectProperty)(prop) && (0, import_types.isIdentifier)(prop.key, { name: "translationNs" })
   );
@@ -490,6 +497,7 @@ function processConfigProperties(properties) {
     icon: hasIcon,
     rank: rankValue,
     nested: nestedValue,
+    group: groupValue,
     translationNs: translationNsValue,
     // Referenced by identifier at runtime rather than extracted here, so
     // the array may be computed instead of a string-literal list.
@@ -539,6 +547,7 @@ function generateMenuItem(config, file, routesDir, index) {
     path: getRoute2(file, routesDir),
     rank: config.rank,
     nested: config.nested,
+    group: config.group,
     translationNs: config.translationNs ? `${configName}.translationNs` : void 0,
     permissions: config.permissions ? `${configName}.permissions` : void 0,
     requireAll: config.requireAll
@@ -551,6 +560,7 @@ function formatMenuItem(menuItem) {
     `        path: "${menuItem.path}"`,
     `        rank: ${menuItem.rank !== void 0 ? menuItem.rank : "undefined"}`,
     `        nested: ${menuItem.nested ? `"${menuItem.nested}"` : "undefined"}`,
+    `        group: ${menuItem.group ? JSON.stringify(menuItem.group) : "undefined"}`,
     `        translationNs: ${menuItem.translationNs || "undefined"}`,
     `        permissions: ${menuItem.permissions || "undefined"}`,
     `        requireAll: ${menuItem.requireAll !== void 0 ? menuItem.requireAll : "undefined"}`
@@ -678,6 +688,7 @@ function readWidgetConfig(properties) {
   const zones = [];
   const permissions = [];
   let id;
+  let label;
   for (const prop of properties) {
     if (!(0, import_types.isObjectProperty)(prop)) continue;
     if ((0, import_types.isIdentifier)(prop.key, { name: "zone" })) {
@@ -689,9 +700,12 @@ function readWidgetConfig(properties) {
     if ((0, import_types.isIdentifier)(prop.key, { name: "id" }) && (0, import_types.isStringLiteral)(prop.value)) {
       id = prop.value.value;
     }
+    if ((0, import_types.isIdentifier)(prop.key, { name: "label" }) && (0, import_types.isStringLiteral)(prop.value)) {
+      label = prop.value.value;
+    }
   }
   if (zones.length === 0) return null;
-  return { zones, id, permissions };
+  return { zones, id, label, permissions };
 }
 function getConfigProperties(node) {
   if ((0, import_types.isCallExpression)(node) && node.arguments.length > 0 && (0, import_types.isObjectExpression)(node.arguments[0])) {
@@ -755,7 +769,7 @@ function parseWidgetFile(file, widgetsDir, index) {
     import: `import ${name} from "${importPath}"`,
     entry: `    { Component: ${name}, zone: ${zonesLiteral}, widgetId: ${JSON.stringify(
       id
-    )}${info.permissions.length ? `, permission: ${JSON.stringify(info.permissions)}` : ""} }`
+    )}${info.label ? `, label: ${JSON.stringify(info.label)}` : ""}${info.permissions.length ? `, permission: ${JSON.stringify(info.permissions)}` : ""} }`
   };
 }
 function collectWidgets(srcDir, startIndex = 0) {

package/dist/vite.d.cts

@@ -1,5 +1,5 @@
 import * as Vite from 'vite';
-import { M as MercurConfig } from './types-Cziny1v0.cjs';
+import { M as MercurConfig } from './types-BTgTMD_t.cjs';
 import 'react';
 
 declare function mercurDashboardPlugin(pluginConfig: MercurConfig): Vite.Plugin;

package/dist/vite.d.ts

@@ -1,5 +1,5 @@
 import * as Vite from 'vite';
-import { M as MercurConfig } from './types-Cziny1v0.js';
+import { M as MercurConfig } from './types-BTgTMD_t.js';
 import 'react';
 
 declare function mercurDashboardPlugin(pluginConfig: MercurConfig): Vite.Plugin;

package/dist/vite.js

@@ -444,6 +444,13 @@ function processConfigProperties(properties) {
   if (nested && isObjectProperty(nested) && isStringLiteral(nested.value)) {
     nestedValue = nested.value.value;
   }
+  const group = properties.find(
+    (prop) => isObjectProperty(prop) && isIdentifier(prop.key, { name: "group" })
+  );
+  let groupValue;
+  if (group && isObjectProperty(group) && isStringLiteral(group.value)) {
+    groupValue = group.value.value;
+  }
   const translationNs = properties.find(
     (prop) => isObjectProperty(prop) && isIdentifier(prop.key, { name: "translationNs" })
   );
@@ -470,6 +477,7 @@ function processConfigProperties(properties) {
     icon: hasIcon,
     rank: rankValue,
     nested: nestedValue,
+    group: groupValue,
     translationNs: translationNsValue,
     // Referenced by identifier at runtime rather than extracted here, so
     // the array may be computed instead of a string-literal list.
@@ -519,6 +527,7 @@ function generateMenuItem(config, file, routesDir, index) {
     path: getRoute2(file, routesDir),
     rank: config.rank,
     nested: config.nested,
+    group: config.group,
     translationNs: config.translationNs ? `${configName}.translationNs` : void 0,
     permissions: config.permissions ? `${configName}.permissions` : void 0,
     requireAll: config.requireAll
@@ -531,6 +540,7 @@ function formatMenuItem(menuItem) {
     `        path: "${menuItem.path}"`,
     `        rank: ${menuItem.rank !== void 0 ? menuItem.rank : "undefined"}`,
     `        nested: ${menuItem.nested ? `"${menuItem.nested}"` : "undefined"}`,
+    `        group: ${menuItem.group ? JSON.stringify(menuItem.group) : "undefined"}`,
     `        translationNs: ${menuItem.translationNs || "undefined"}`,
     `        permissions: ${menuItem.permissions || "undefined"}`,
     `        requireAll: ${menuItem.requireAll !== void 0 ? menuItem.requireAll : "undefined"}`
@@ -658,6 +668,7 @@ function readWidgetConfig(properties) {
   const zones = [];
   const permissions = [];
   let id;
+  let label;
   for (const prop of properties) {
     if (!isObjectProperty(prop)) continue;
     if (isIdentifier(prop.key, { name: "zone" })) {
@@ -669,9 +680,12 @@ function readWidgetConfig(properties) {
     if (isIdentifier(prop.key, { name: "id" }) && isStringLiteral(prop.value)) {
       id = prop.value.value;
     }
+    if (isIdentifier(prop.key, { name: "label" }) && isStringLiteral(prop.value)) {
+      label = prop.value.value;
+    }
   }
   if (zones.length === 0) return null;
-  return { zones, id, permissions };
+  return { zones, id, label, permissions };
 }
 function getConfigProperties(node) {
   if (isCallExpression(node) && node.arguments.length > 0 && isObjectExpression(node.arguments[0])) {
@@ -735,7 +749,7 @@ function parseWidgetFile(file, widgetsDir, index) {
     import: `import ${name} from "${importPath}"`,
     entry: `    { Component: ${name}, zone: ${zonesLiteral}, widgetId: ${JSON.stringify(
       id
-    )}${info.permissions.length ? `, permission: ${JSON.stringify(info.permissions)}` : ""} }`
+    )}${info.label ? `, label: ${JSON.stringify(info.label)}` : ""}${info.permissions.length ? `, permission: ${JSON.stringify(info.permissions)}` : ""} }`
   };
 }
 function collectWidgets(srcDir, startIndex = 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mercurjs/dashboard-sdk",
-  "version": "2.3.6-canary.8",
+  "version": "2.3.6",
   "repository": {
     "type": "git",
     "url": "https://github.com/mercurjs/mercur",