@coworkee/airworks 0.0.1035 → 0.0.1037

package/dist/apps/admin/index.d.ts

@@ -1,4 +1,4 @@
-import type { AppFactory, Coworkee, CoworkeeApp } from '../../coworkee.ts';
+import { type AppFactory, type Coworkee, type CoworkeeApp } from '../../coworkee.ts';
 export declare const administrationAppId = "coworkee.administration";
 /** Every administration app the user may open, grouped like the administration menu of the web app. */
 export declare const administrationApp: (coworkee: Coworkee) => CoworkeeApp;

package/dist/apps/admin/index.js

@@ -1,3 +1,4 @@
+import { launcherApp } from "../../coworkee.js";
 import { esc } from "../../dom.js";
 import { icons } from "../../icons.js";
 import { aiSettingsApp } from "../assistant.js";
@@ -12,7 +13,7 @@ const allowed = (coworkee) => coworkee.apps.filter((app) => app.group && !app.hi
 /** Every administration app the user may open, grouped like the administration menu of the web app. */
 export const administrationApp = (coworkee) => {
     const definition = (visible) => ({
-        id: administrationAppId, title: coworkee.t('Administration'), icon: icons.adminPanel, accent: '#35496b', width: 760, height: 560, singleInstance: true,
+        id: administrationAppId, title: coworkee.t('Administration'), icon: icons.adminPanel, accent: '#35496b', width: 760, height: 560, singleInstance: true, launcherGroup: coworkee.t('Administration'),
         requiredPermissions: visible ? [] : [nobody],
         render: ({ host }) => {
             const { t } = coworkee;
@@ -37,7 +38,7 @@ export const administrationApp = (coworkee) => {
             return;
         visible = now;
         coworkee.airWorks.unregisterApp(administrationAppId);
-        coworkee.airWorks.registerApp(definition(now));
+        coworkee.airWorks.registerApp(launcherApp(definition(now), coworkee.t));
     };
     coworkee.airWorks.on('access-changed', update);
     return definition(false);

package/dist/apps/data.d.ts

@@ -9,6 +9,8 @@ export type EntityAppOptions = EntityTableOptions & {
     icon?: string;
     accent?: string;
     requiredPermissions?: string[];
+    /** Heading in the full-screen launcher, e.g. the nav group of the set's page. */
+    launcherGroup?: string;
 };
 /** One entity set as its own desktop app, e.g. entityApp({ entitySet: 'Products', requiredPermissions: ['Catalog.Products.View'] }). */
 export declare const entityApp: (options: EntityAppOptions) => (coworkee: Coworkee) => CoworkeeApp;

package/dist/apps/data.js

@@ -82,6 +82,7 @@ export const entityApp = (options) => (coworkee) => ({
     width: 900,
     height: 580,
     requiredPermissions: options.requiredPermissions,
+    launcherGroup: options.launcherGroup,
     render: ({ host, onClose }) => {
         host.classList.add('cw-host');
         host.innerHTML = '<div class="cw-app"></div>';

package/dist/apps/web.d.ts

@@ -17,6 +17,8 @@ export type EmbedOptions = {
     height?: number;
     requiredPermissions?: string[];
     group?: string;
+    launcherGroup?: string;
+    shortcut?: boolean;
 };
 /** The page of the web client (the full editor) while the BFF knows the web client, otherwise the lighter app built here. */
 export declare const embedOr: (options: EmbedOptions, fallback: AppFactory) => AppFactory;

package/dist/apps/web.js

@@ -22,7 +22,7 @@ function frame(coworkee, host, path, title) {
  */
 export const embedApp = (options) => (coworkee) => coworkee.user.appUrl ? [{
         id: options.id, title: coworkee.t(options.title), icon: options.icon ?? icons.web, accent: options.accent ?? '#35496b',
-        width: options.width ?? 1100, height: options.height ?? 700, requiredPermissions: options.requiredPermissions, group: options.group,
+        width: options.width ?? 1100, height: options.height ?? 700, requiredPermissions: options.requiredPermissions, group: options.group, launcherGroup: options.launcherGroup, shortcut: options.shortcut,
         render: ({ host }) => frame(coworkee, host, options.path, coworkee.t(options.title)),
     }] : [];
 /** The page of the web client (the full editor) while the BFF knows the web client, otherwise the lighter app built here. */

package/dist/coworkee.d.ts

@@ -8,11 +8,15 @@ export type AirWorksApi = typeof AirWorks;
 export type CoworkeeApp = AppDefinition & {
     probe?: string;
     hostOnly?: boolean;
-    /** Section of the administration app (Identity, System, ...); such apps get no desktop shortcut of their own. */
+    /** Section of the administration app (Identity, System, ...); such apps get no desktop shortcut of their own and are listed under Administration in the full-screen launcher. */
     group?: string;
+    /** Heading of the app in the full-screen launcher (AirWorks `group`), e.g. People; wins over Administration. */
+    launcherGroup?: string;
     /** false: no desktop shortcut at the start (the app stays in the start menu). */
     shortcut?: boolean;
 };
+/** The AirWorks app of a Coworkee app: launcherGroup, or Administration for a section of the administration, becomes the launcher heading. */
+export declare function launcherApp({ probe, hostOnly, group, shortcut, launcherGroup, ...app }: CoworkeeApp, t: Translate): AppDefinition;
 export type AppFactory = (coworkee: Coworkee) => CoworkeeApp | CoworkeeApp[];
 export type CoworkeeOptions = {
     /** Shown in the start menu, on the sign-in card and in the browser tab. */

package/dist/coworkee.js

@@ -3,6 +3,11 @@ import { bffAuthProvider } from "./auth.js";
 import { toast } from "./dom.js";
 import { defaultMudExFrameUrl, defaultMudExUrl } from "./mudex.js";
 import { globalSearchProvider } from "./search.js";
+/** The AirWorks app of a Coworkee app: launcherGroup, or Administration for a section of the administration, becomes the launcher heading. */
+export function launcherApp({ probe, hostOnly, group, shortcut, launcherGroup, ...app }, t) {
+    const heading = launcherGroup ?? (group ? t('Administration') : undefined);
+    return heading ? { ...app, group: heading } : app;
+}
 /** English of the MudBlazor keys the apps borrow; the API serves them only for other languages. */
 const mudTexts = {
     MudDataGridPager_InfoFormat: '{0}-{1} of {2}', MudTablePager_PreviousPage: 'Previous page', MudTablePager_NextPage: 'Next page', MudDataGrid_Loading: 'Loading...',
@@ -100,11 +105,12 @@ export async function useCoworkee(airWorks, options) {
     };
     const shortcuts = [];
     async function add(definition) {
-        const { probe, hostOnly, group, shortcut, ...app } = definition;
+        const { probe, hostOnly } = definition;
         if (hostOnly && !user.systemTenant)
             return undefined;
         if (probe && !(user.isAuthenticated && await quietly(() => apiRequest(probe).then(() => true), false)))
             return undefined;
+        const app = launcherApp(definition, coworkee.t);
         airWorks.unregisterApp(app.id);
         airWorks.registerApp(app);
         const known = coworkee.apps.findIndex((item) => item.id === app.id);
@@ -125,6 +131,7 @@ export async function useCoworkee(airWorks, options) {
         defaults: { systemColor: palette(theme, mode).primary },
         storageKey: `coworkee.airworks.${location.host}`,
         webLinks: true,
+        ...(user.launcher === 'menu' || user.launcher === 'overlay' ? { launcher: user.launcher } : {}),
         ...options.airWorks,
     });
     if (user.isAuthenticated && user.userId)

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { AppFactory } from './coworkee.ts';
-export { useCoworkee, type AirWorksApi, type AppFactory, type Coworkee, type CoworkeeApp, type CoworkeeOptions } from './coworkee.ts';
+export { launcherApp, useCoworkee, type AirWorksApi, type AppFactory, type Coworkee, type CoworkeeApp, type CoworkeeOptions } from './coworkee.ts';
 export { bffAuthProvider, sessionOf } from './auth.ts';
 export { loadMudEx, defaultMudExFrameUrl, defaultMudExUrl, mudExFrame } from './mudex.ts';
 export { icons } from './icons.ts';

package/dist/index.js

@@ -9,7 +9,7 @@ import { webPageApp } from "./apps/web.js";
 import { reportDesignerApp } from "./apps/report-designer.js";
 import { reportApp, reportsApp } from "./apps/reports.js";
 import { settingsApp } from "./apps/settings.js";
-export { useCoworkee } from "./coworkee.js";
+export { launcherApp, useCoworkee } from "./coworkee.js";
 export { bffAuthProvider, sessionOf } from "./auth.js";
 export { loadMudEx, defaultMudExFrameUrl, defaultMudExUrl, mudExFrame } from "./mudex.js";
 export { icons } from "./icons.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coworkee/airworks",
-  "version": "0.0.1035",
+  "version": "0.0.1037",
   "description": "AirWorks web desktop for Coworkee apps: sign-in through the app's BFF, theme, texts, realtime and apps for settings, files, data, chat, reports, the assistant and the administration",
   "license": "MIT",
   "homepage": "https://fgilde.github.io/CoworkeeLib/web/airworks/",
@@ -40,13 +40,13 @@
     "test": "node --test \"test/**/*.test.ts\""
   },
   "dependencies": {
-    "@coworkee/client": "0.0.1035"
+    "@coworkee/client": "0.0.1037"
   },
   "peerDependencies": {
     "@fgilde/airworks": ">=0.4.0"
   },
   "devDependencies": {
-    "@fgilde/airworks": "git+https://github.com/fgilde/AirWorks.git#12e8507b22f11f99bba2c093fb81f617e751ff1f",
+    "@fgilde/airworks": "git+https://github.com/fgilde/AirWorks.git#9657ff3967a9dd8fa5dc2b7502c2b2e3d4e20d72",
     "typescript": "^5.9.3"
   }
 }