@opencxh/domain 1.196.0 → 1.198.0

package/dist/platform/manifest.d.ts

@@ -37,6 +37,21 @@ export type ResourceDefinition<T = any> = T;
  * It defines the app's identity, its components, its UI contributions,
  * and most importantly, its security sandbox via the permissions block.
  */
+/** The two groups of the app switcher: the product itself, and what extends it. */
+export type AppSwitcherGroup = "core" | "apps";
+/**
+ * Where an app sits in the shell's app switcher. Declaring this — not having an
+ * `icon` — is what puts an app in the switcher; settings-only and provider apps
+ * leave it out and stay reachable through settings, panels and docks.
+ */
+export interface AppSwitcherPlacement {
+    /** `core` is reserved for first-party product apps; everything else is `apps`. */
+    group: AppSwitcherGroup;
+    /** Position within `core` — a fixed reading order, not alphabetical. Ignored for `apps`. */
+    order?: number;
+    /** Also offer the app in the mobile tab bar. Core apps are there by default. */
+    mobile?: boolean;
+}
 export interface AppManifest<_TSDK = any> {
     /**
      * The namespace of the application.
@@ -63,9 +78,12 @@ export interface AppManifest<_TSDK = any> {
      */
     description?: string;
     /**
-     * Optional icon for the application.
+     * Optional icon for the application. Shown wherever the app is listed; on its own
+     * it does not place the app in the switcher — see `switcher`.
      */
     icon?: IconDefinition;
+    /** Placement in the app switcher and the mobile tab bar. Absent = not listed. */
+    switcher?: AppSwitcherPlacement;
     /**
      * Optional default route for the application.
      */

package/dist/platform/ui.d.ts

@@ -72,6 +72,14 @@ export interface DockControls {
  * Which settings-panel tab a page appears under. A page may belong to both.
  */
 export type SettingsScope = "personal" | "company";
+/**
+ * The heading a settings page sits under. The overlay groups on this, not on the
+ * app that registered the page, so a mailbox, a PBX and an MCP server all land
+ * under "connections" whichever app owns them.
+ */
+export type SettingsCategory = "personal" | "workspace" | "connections" | "work" | "ai";
+/** Reading order of the categories in the settings nav. */
+export declare const SETTINGS_CATEGORIES: readonly SettingsCategory[];
 export interface SettingsPageConfig {
     id: string;
     displayName: string;
@@ -86,6 +94,12 @@ export interface SettingsPageConfig {
      * the group itself.
      */
     group?: string;
+    /**
+     * Heading in the settings nav. Absent = `personal` for a personal-only page,
+     * otherwise `workspace`; declare it, the fallback is only there for apps
+     * that have not caught up.
+     */
+    category?: SettingsCategory;
     icon?: string;
     resource: string;
     order?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencxh/domain",
-  "version": "1.196.0",
+  "version": "1.198.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",