@elizaos/ui 2.0.0-alpha.85 → 2.0.0-beta.2

package/components/apps/extensions/surface.js

@@ -0,0 +1,96 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function toTimestamp(value) {
+    if (!value)
+        return 0;
+    const parsed = new Date(value).getTime();
+    return Number.isNaN(parsed) ? 0 : parsed;
+}
+export function selectLatestRunForApp(appName, runs) {
+    const matchingRuns = (Array.isArray(runs) ? runs : [])
+        .filter((run) => run.appName === appName)
+        .slice()
+        .sort((left, right) => {
+        const rightTime = Math.max(toTimestamp(right.updatedAt), toTimestamp(right.startedAt));
+        const leftTime = Math.max(toTimestamp(left.updatedAt), toTimestamp(left.startedAt));
+        return rightTime - leftTime;
+    });
+    return {
+        run: matchingRuns[0] ?? null,
+        matchingRuns,
+    };
+}
+export function formatDetailTimestamp(value) {
+    if (typeof value === "number") {
+        const date = new Date(value);
+        return Number.isNaN(date.getTime())
+            ? "Not yet verified"
+            : date.toLocaleString();
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        const date = new Date(value);
+        return Number.isNaN(date.getTime())
+            ? "Not yet verified"
+            : date.toLocaleString();
+    }
+    return "Not yet verified";
+}
+export function toneForHealthState(state) {
+    if (state === "healthy")
+        return "success";
+    if (state === "degraded")
+        return "warn";
+    if (state === "offline")
+        return "danger";
+    return "neutral";
+}
+export function toneForViewerAttachment(attachment) {
+    if (attachment === "attached")
+        return "success";
+    if (attachment === "detached")
+        return "warn";
+    return "neutral";
+}
+export function toneForStatusText(status) {
+    if (!status)
+        return "neutral";
+    const normalized = status.toLowerCase();
+    if (normalized.includes("running") || normalized.includes("ready")) {
+        return "success";
+    }
+    if (normalized.includes("warn") || normalized.includes("waiting")) {
+        return "warn";
+    }
+    if (normalized.includes("error") || normalized.includes("fail")) {
+        return "danger";
+    }
+    return "neutral";
+}
+function toneClassName(tone) {
+    switch (tone) {
+        case "success":
+            return "border-ok/30 bg-ok/10 text-ok";
+        case "accent":
+            return "border-accent/25 bg-accent/10 text-accent";
+        case "warn":
+            return "border-warn/30 bg-warn/10 text-warn";
+        case "danger":
+            return "border-danger/30 bg-danger/10 text-danger";
+        default:
+            return "border-border/35 bg-bg-hover/70 text-muted-strong";
+    }
+}
+export function SurfaceBadge({ children, tone = "neutral", }) {
+    return (_jsx("span", { className: `inline-flex min-h-6 items-center rounded-full border px-2.5 py-1 text-2xs font-medium uppercase tracking-[0.14em] ${toneClassName(tone)}`, children: children }));
+}
+export function SurfaceCard({ label, value, tone = "neutral", subtitle, }) {
+    return (_jsxs("div", { className: "rounded-2xl border border-border/35 bg-card/74 px-4 py-3 shadow-sm", children: [_jsx("div", { className: "text-xs-tight font-medium uppercase tracking-[0.16em] text-muted", children: label }), _jsx("div", { className: `mt-1 text-xs leading-5 ${toneClassName(tone)}`, children: value }), subtitle ? (_jsx("div", { className: "mt-1 text-xs-tight leading-5 text-muted-strong", children: subtitle })) : null] }));
+}
+export function SurfaceGrid({ children }) {
+    return _jsx("div", { className: "grid gap-2 md:grid-cols-2", children: children });
+}
+export function SurfaceSection({ title, children, }) {
+    return (_jsxs("section", { className: "space-y-3 rounded-[1.4rem] border border-border/35 bg-card/74 p-4 shadow-sm", children: [_jsx("div", { className: "text-xs-tight font-semibold uppercase tracking-[0.18em] text-muted", children: title }), children] }));
+}
+export function SurfaceEmptyState({ title, body, }) {
+    return (_jsxs("div", { className: "rounded-[1.4rem] border border-border/35 bg-card/74 p-4 shadow-sm", children: [_jsx("div", { className: "text-xs-tight font-semibold uppercase tracking-[0.18em] text-muted", children: title }), _jsx("p", { className: "mt-2 text-xs leading-6 text-muted-strong", children: body })] }));
+}

package/components/apps/extensions/types.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentType } from "react";
+import type { RegistryAppInfo } from "../../../api";
+export interface AppDetailExtensionProps {
+    app: RegistryAppInfo;
+}
+export type AppDetailExtensionComponent = ComponentType<AppDetailExtensionProps>;
+//# sourceMappingURL=types.d.ts.map

package/components/apps/extensions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/apps/extensions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,eAAe,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GACrC,aAAa,CAAC,uBAAuB,CAAC,CAAC"}

package/components/apps/extensions/types.js

@@ -0,0 +1 @@
+export {};

package/components/apps/helpers.d.ts

@@ -0,0 +1,58 @@
+import type { RegistryAppInfo } from "../../api";
+export declare const DEFAULT_VIEWER_SANDBOX = "allow-scripts allow-same-origin allow-popups";
+export declare const CATEGORY_LABELS: Record<string, string>;
+export type AppCatalogSectionKey = "featured" | "favorites" | "games" | "developerUtilities" | "finance" | "other";
+export declare const APP_CATALOG_SECTION_LABELS: Record<AppCatalogSectionKey, string>;
+export declare const APPS_VIEW_HIDDEN_APP_NAMES: readonly ["@elizaos/app", "@elizaos/browser-bridge-extension", "app-counter", "@elizaos/plugin-form", "@elizaos/app-documents", "@elizaos/app-screenshare", "@elizaos/app-task-coordinator", "@elizaos/app-wallet"];
+export interface AppCatalogSection {
+    key: AppCatalogSectionKey;
+    label: string;
+    apps: RegistryAppInfo[];
+}
+interface AppsCatalogFilterOptions {
+    activeAppNames?: ReadonlySet<string>;
+    isProd?: boolean;
+    searchQuery?: string;
+    showAllApps?: boolean;
+    showActiveOnly?: boolean;
+    walletEnabled?: boolean;
+    /**
+     * When false (or omitted), apps marked `developerOnly: true` are hidden.
+     * Pass the current value from `useIsDeveloperMode()` to opt in.
+     */
+    developerMode?: boolean;
+}
+export declare function isHiddenFromAppsView(appName: string): boolean;
+export declare function isCuratedGameApp(app: Pick<RegistryAppInfo, "category" | "name">): boolean;
+export declare function shouldShowAppInAppsView(app: Pick<RegistryAppInfo, "category" | "name">, options?: {
+    isProd?: boolean;
+    showAllApps?: boolean;
+    walletEnabled?: boolean;
+}): boolean;
+export declare function filterAppsForCatalog(apps: RegistryAppInfo[], { activeAppNames, isProd, searchQuery, showAllApps, showActiveOnly, walletEnabled, developerMode, }?: AppsCatalogFilterOptions): RegistryAppInfo[];
+export declare function getDefaultAppsCatalogSelection(apps: RegistryAppInfo[], options?: {
+    isProd?: boolean;
+    showAllApps?: boolean;
+    walletEnabled?: boolean;
+}): string | null;
+export declare function getAppCatalogSectionKey(app: Pick<RegistryAppInfo, "name" | "displayName" | "description" | "category">): AppCatalogSectionKey;
+export declare function getAppCatalogSectionLabel(app: Pick<RegistryAppInfo, "name" | "displayName" | "description" | "category">): string;
+export declare function groupAppsForCatalog(apps: RegistryAppInfo[], { favoriteAppNames, }?: {
+    favoriteAppNames?: ReadonlySet<string>;
+}): AppCatalogSection[];
+export declare function getAppShortName(app: RegistryAppInfo): string;
+export declare function getAppEmoji(app: RegistryAppInfo): string;
+export declare function getAppSessionModeLabel(app: Pick<RegistryAppInfo, "session">): string | null;
+export declare function getAppSessionFeatureLabels(app: Pick<RegistryAppInfo, "session">): string[];
+/**
+ * Derive a URL slug from an app's package name.
+ *
+ * Uses the existing `packageNameToAppRouteSlug` for scoped packages
+ * (`@scope/app-foo` → `foo`, `@scope/plugin-bar` → `bar`).
+ * Falls back to a sanitised form of the raw name.
+ */
+export declare function getAppSlug(appName: string): string;
+/** Find an app by its URL slug. */
+export declare function findAppBySlug(apps: readonly RegistryAppInfo[], slug: string): RegistryAppInfo | undefined;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/components/apps/helpers.d.ts.map

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

package/components/apps/helpers.js

@@ -0,0 +1,379 @@
+import { getElizaCuratedAppCatalogOrder, isElizaCuratedAppName, normalizeElizaCuratedAppName, packageNameToAppRouteSlug, } from "@elizaos/shared";
+import { getBootConfig } from "../../config/boot-config-store.js";
+import { getInternalToolAppCatalogOrder, isInternalToolApp, } from "./internal-tool-apps.js";
+export const DEFAULT_VIEWER_SANDBOX = "allow-scripts allow-same-origin allow-popups";
+export const CATEGORY_LABELS = {
+    game: "Game",
+    social: "Social",
+    platform: "Platform",
+    world: "World",
+    utility: "Utility",
+};
+export const APP_CATALOG_SECTION_LABELS = {
+    featured: "Featured",
+    favorites: "Starred",
+    games: "Games & Entertainment",
+    developerUtilities: "Developer Utilities",
+    finance: "Finance",
+    other: "Other",
+};
+export const APPS_VIEW_HIDDEN_APP_NAMES = [
+    "@elizaos/app",
+    "@elizaos/browser-bridge-extension",
+    "app-counter",
+    "@elizaos/plugin-form",
+    "@elizaos/app-documents",
+    "@elizaos/app-screenshare",
+    "@elizaos/app-task-coordinator",
+    // Shared wallet/inventory system package — provides components used by the
+    // app shell, not a standalone installable app.
+    "@elizaos/app-wallet",
+];
+const APPS_VIEW_HIDDEN_APP_NAME_SET = new Set(APPS_VIEW_HIDDEN_APP_NAMES);
+const FEATURED_APP_NAMES = new Set([
+    "@elizaos/app-lifeops",
+    "@elizaos/app-companion",
+    "@elizaos/app-defense-of-the-agents",
+    "@clawville/app-clawville",
+]);
+const DEFAULT_VISIBLE_GAME_APP_NAMES = new Set([
+    "@elizaos/app-companion",
+    "@elizaos/app-defense-of-the-agents",
+    "@clawville/app-clawville",
+]);
+const DEFAULT_HIDDEN_APP_NAMES = new Set([
+    "@elizaos/app-elizamaker",
+    "@elizaos/app-hyperliquid",
+    "@elizaos/app-polymarket",
+    "@elizaos/app-shopify",
+    "@elizaos/app-steward",
+    "@elizaos/app-vincent",
+]);
+const WALLET_SCOPED_APP_NAMES = new Set([
+    "@elizaos/app-hyperliquid",
+    "@elizaos/app-polymarket",
+    "@elizaos/app-vincent",
+]);
+const APP_CATALOG_SECTION_ORDER = [
+    "featured",
+    "favorites",
+    "games",
+    "finance",
+    "developerUtilities",
+    "other",
+];
+function getConfiguredDefaultAppNames() {
+    return new Set((getBootConfig().defaultApps ?? []).filter((name) => typeof name === "string" && name.length > 0));
+}
+function isFeaturedAppName(name) {
+    return (FEATURED_APP_NAMES.has(name) || getConfiguredDefaultAppNames().has(name));
+}
+const SESSION_MODE_LABELS = {
+    "spectate-and-steer": "Spectate + steer",
+};
+const SESSION_FEATURE_LABELS = {
+    commands: "Commands",
+    telemetry: "Telemetry",
+    pause: "Pause",
+    resume: "Resume",
+    suggestions: "Suggestions",
+};
+function parseBooleanEnvValue(value) {
+    const normalized = String(value ?? "")
+        .trim()
+        .toLowerCase();
+    return (normalized === "1" ||
+        normalized === "true" ||
+        normalized === "yes" ||
+        normalized === "on");
+}
+function shouldShowAllApps(showAllApps) {
+    if (typeof showAllApps === "boolean") {
+        return showAllApps;
+    }
+    return parseBooleanEnvValue(import.meta.env.VITE_PUBLIC_SHOW_ALL_APPS);
+}
+export function isHiddenFromAppsView(appName) {
+    return APPS_VIEW_HIDDEN_APP_NAME_SET.has(appName);
+}
+export function isCuratedGameApp(app) {
+    void app.category;
+    return isElizaCuratedAppName(app.name);
+}
+export function shouldShowAppInAppsView(app, options = {}) {
+    const { isProd = typeof import.meta.env.PROD === "boolean"
+        ? import.meta.env.PROD
+        : Boolean(import.meta.env.PROD), showAllApps, walletEnabled = false, } = options;
+    void isProd;
+    if (isHiddenFromAppsView(app.name)) {
+        return false;
+    }
+    const configuredDefaultAppNames = getConfiguredDefaultAppNames();
+    if (!configuredDefaultAppNames.has(app.name) &&
+        !isInternalToolApp(app.name) &&
+        !isCuratedGameApp(app)) {
+        return false;
+    }
+    if (shouldShowAllApps(showAllApps)) {
+        return true;
+    }
+    const canonicalName = isInternalToolApp(app.name)
+        ? app.name
+        : (normalizeElizaCuratedAppName(app.name) ?? app.name);
+    const sectionKey = getAppCatalogSectionKey({
+        name: app.name,
+        category: app.category,
+        displayName: "",
+        description: "",
+    });
+    if (DEFAULT_HIDDEN_APP_NAMES.has(canonicalName) &&
+        !(walletEnabled && WALLET_SCOPED_APP_NAMES.has(canonicalName)) &&
+        !configuredDefaultAppNames.has(app.name) &&
+        !configuredDefaultAppNames.has(canonicalName)) {
+        return false;
+    }
+    if (sectionKey === "games") {
+        return (DEFAULT_VISIBLE_GAME_APP_NAMES.has(canonicalName) ||
+            configuredDefaultAppNames.has(app.name) ||
+            configuredDefaultAppNames.has(canonicalName));
+    }
+    return true;
+}
+export function filterAppsForCatalog(apps, { activeAppNames = new Set(), isProd, searchQuery = "", showAllApps, showActiveOnly = false, walletEnabled, developerMode = false, } = {}) {
+    const normalizedSearch = searchQuery.trim().toLowerCase();
+    const seenCanonicalNames = new Set();
+    const sortedApps = [...apps].sort((left, right) => {
+        const toolOrderDiff = getInternalToolAppCatalogOrder(left.name) -
+            getInternalToolAppCatalogOrder(right.name);
+        if (toolOrderDiff !== 0) {
+            return toolOrderDiff;
+        }
+        const orderDiff = getElizaCuratedAppCatalogOrder(left.name) -
+            getElizaCuratedAppCatalogOrder(right.name);
+        if (orderDiff !== 0) {
+            return orderDiff;
+        }
+        const leftCanonicalName = normalizeElizaCuratedAppName(left.name);
+        const rightCanonicalName = normalizeElizaCuratedAppName(right.name);
+        const leftCanonicalPenalty = left.name === leftCanonicalName ? 0 : 1;
+        const rightCanonicalPenalty = right.name === rightCanonicalName ? 0 : 1;
+        if (leftCanonicalPenalty !== rightCanonicalPenalty) {
+            return leftCanonicalPenalty - rightCanonicalPenalty;
+        }
+        return (right.stars ?? 0) - (left.stars ?? 0);
+    });
+    return sortedApps.filter((app) => {
+        if (!shouldShowAppInAppsView(app, { isProd, showAllApps, walletEnabled })) {
+            return false;
+        }
+        // Developer-only apps are hidden unless Developer Mode is on.
+        // TODO: server-side population pending — `developerOnly` is declared in
+        // PluginApp but not yet plumbed through `RegistryAppInfo` API responses.
+        if (app.developerOnly && !developerMode) {
+            return false;
+        }
+        // Apps that opt out of the catalog are always hidden, regardless of
+        // Developer Mode (use deep-link / auto-install paths instead).
+        // TODO: server-side population pending — see `developerOnly` note above.
+        if (app.visibleInAppStore === false) {
+            return false;
+        }
+        const sectionLabel = getAppCatalogSectionLabel(app).toLowerCase();
+        if (normalizedSearch &&
+            !app.name.toLowerCase().includes(normalizedSearch) &&
+            !(app.displayName ?? "").toLowerCase().includes(normalizedSearch) &&
+            !(app.description ?? "").toLowerCase().includes(normalizedSearch) &&
+            !(app.category ?? "").toLowerCase().includes(normalizedSearch) &&
+            !sectionLabel.includes(normalizedSearch)) {
+            return false;
+        }
+        if (showActiveOnly && !activeAppNames.has(app.name)) {
+            return false;
+        }
+        const canonicalName = isInternalToolApp(app.name)
+            ? app.name
+            : (normalizeElizaCuratedAppName(app.name) ?? app.name);
+        if (seenCanonicalNames.has(canonicalName)) {
+            return false;
+        }
+        seenCanonicalNames.add(canonicalName);
+        return true;
+    });
+}
+export function getDefaultAppsCatalogSelection(apps, options = {}) {
+    return (filterAppsForCatalog(apps, {
+        ...options,
+    })[0]?.name ?? null);
+}
+export function getAppCatalogSectionKey(app) {
+    if (isFeaturedAppName(app.name)) {
+        return "featured";
+    }
+    if (app.name === "@elizaos/app-steward" ||
+        app.name === "@elizaos/app-elizamaker") {
+        return "finance";
+    }
+    if (isInternalToolApp(app.name)) {
+        return "developerUtilities";
+    }
+    const canonicalName = normalizeElizaCuratedAppName(app.name) ?? app.name;
+    switch (canonicalName) {
+        case "@elizaos/app-companion":
+            return "games";
+        case "@elizaos/app-vincent":
+        case "@elizaos/app-shopify":
+        case "@elizaos/app-hyperliquid":
+        case "@elizaos/app-polymarket":
+            return "finance";
+        case "@elizaos/app-babylon":
+            return "games";
+        case "@hyperscape/plugin-hyperscape":
+        case "@elizaos/app-hyperscape":
+        case "@elizaos/app-2004scape":
+        case "@elizaos/app-scape":
+        case "@elizaos/app-defense-of-the-agents":
+        case "@clawville/app-clawville":
+            return "games";
+    }
+    const normalizedCategory = app.category.trim().toLowerCase();
+    if (normalizedCategory === "game") {
+        return "games";
+    }
+    if (normalizedCategory === "utility") {
+        return "developerUtilities";
+    }
+    if (normalizedCategory === "social" || normalizedCategory === "world") {
+        return "games";
+    }
+    if (normalizedCategory === "platform") {
+        return "finance";
+    }
+    const searchBlob = [
+        app.name,
+        app.displayName ?? "",
+        app.description ?? "",
+        app.category,
+    ]
+        .join(" ")
+        .toLowerCase();
+    if (/companion|avatar|assistant|friend|chat|social/.test(searchBlob)) {
+        return "games";
+    }
+    if (/commerce|shop|store|finance|wallet|market|trade|sales|business|team/.test(searchBlob)) {
+        return "finance";
+    }
+    if (/debug|viewer|plugin|skill|memory|trajectory|runtime|database|log|sql/.test(searchBlob)) {
+        return "developerUtilities";
+    }
+    return "other";
+}
+export function getAppCatalogSectionLabel(app) {
+    return APP_CATALOG_SECTION_LABELS[getAppCatalogSectionKey(app)];
+}
+export function groupAppsForCatalog(apps, { favoriteAppNames = new Set(), } = {}) {
+    const sections = [];
+    const groupedApps = new Map();
+    const surfacedAppNames = new Set();
+    const favoriteApps = apps.filter((app) => favoriteAppNames.has(app.name));
+    if (favoriteApps.length > 0) {
+        sections.push({
+            key: "favorites",
+            label: APP_CATALOG_SECTION_LABELS.favorites,
+            apps: favoriteApps,
+        });
+        for (const app of favoriteApps) {
+            surfacedAppNames.add(app.name);
+        }
+    }
+    const featuredApps = apps.filter((app) => isFeaturedAppName(app.name) && !favoriteAppNames.has(app.name));
+    if (featuredApps.length > 0) {
+        sections.push({
+            key: "featured",
+            label: APP_CATALOG_SECTION_LABELS.featured,
+            apps: featuredApps,
+        });
+        for (const app of featuredApps) {
+            surfacedAppNames.add(app.name);
+        }
+    }
+    for (const app of apps) {
+        if (surfacedAppNames.has(app.name)) {
+            continue;
+        }
+        const sectionKey = getAppCatalogSectionKey(app);
+        const sectionApps = groupedApps.get(sectionKey) ?? [];
+        sectionApps.push(app);
+        groupedApps.set(sectionKey, sectionApps);
+    }
+    return [
+        ...sections,
+        ...APP_CATALOG_SECTION_ORDER.flatMap((key) => {
+            if (key === "featured" || key === "favorites") {
+                return [];
+            }
+            const sectionApps = groupedApps.get(key) ?? [];
+            if (sectionApps.length === 0) {
+                return [];
+            }
+            return [
+                {
+                    key,
+                    label: APP_CATALOG_SECTION_LABELS[key],
+                    apps: sectionApps,
+                },
+            ];
+        }),
+    ];
+}
+export function getAppShortName(app) {
+    const display = app.displayName ?? app.name;
+    const clean = display.replace(/^@[^/]+\/app-/, "");
+    return clean.charAt(0).toUpperCase() + clean.slice(1);
+}
+export function getAppEmoji(app) {
+    const sectionKey = getAppCatalogSectionKey(app);
+    if (sectionKey === "featured")
+        return "⭐";
+    if (sectionKey === "games")
+        return "🎮";
+    if (sectionKey === "developerUtilities")
+        return "🛠️";
+    if (sectionKey === "finance")
+        return "💰";
+    return "📦";
+}
+export function getAppSessionModeLabel(app) {
+    const mode = app.session?.mode;
+    if (!mode)
+        return null;
+    return SESSION_MODE_LABELS[mode] ?? mode;
+}
+export function getAppSessionFeatureLabels(app) {
+    return (app.session?.features ?? []).map((feature) => SESSION_FEATURE_LABELS[feature] ?? feature);
+}
+/* ── App URL slugs ──────────────────────────────────────────────────── */
+/**
+ * Derive a URL slug from an app's package name.
+ *
+ * Uses the existing `packageNameToAppRouteSlug` for scoped packages
+ * (`@scope/app-foo` → `foo`, `@scope/plugin-bar` → `bar`).
+ * Falls back to a sanitised form of the raw name.
+ */
+export function getAppSlug(appName) {
+    const slug = packageNameToAppRouteSlug(appName);
+    if (slug)
+        return slug;
+    // Fallback: strip leading scope, common prefixes, then sanitise
+    return (appName
+        .replace(/^@[^/]+\//, "")
+        .replace(/^(app|plugin)-/, "")
+        .replace(/[^a-z0-9-]/gi, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "")
+        .toLowerCase() || appName);
+}
+/** Find an app by its URL slug. */
+export function findAppBySlug(apps, slug) {
+    const normalizedSlug = slug.toLowerCase();
+    return apps.find((app) => getAppSlug(app.name).toLowerCase() === normalizedSlug);
+}

package/components/apps/internal-tool-apps.d.ts

@@ -0,0 +1,18 @@
+import type { RegistryAppInfo } from "../../api";
+import type { Tab } from "../../navigation";
+export declare function getInternalToolApps(): RegistryAppInfo[];
+export declare function isInternalToolApp(name: string): boolean;
+export declare function getInternalToolAppTargetTab(name: string): Tab | null;
+export declare function getInternalToolAppCatalogOrder(name: string): number;
+export declare function getInternalToolAppWindowPath(name: string): string | null;
+export declare function getInternalToolAppHasDetailsPage(name: string): boolean;
+/** Plain descriptor used by the desktop application/tray menus. */
+export interface InternalToolAppDescriptor {
+    readonly name: string;
+    readonly displayName: string;
+    readonly windowPath: string | null;
+    readonly hasDetailsPage: boolean;
+    readonly order: number;
+}
+export declare function getInternalToolAppDescriptors(): readonly InternalToolAppDescriptor[];
+//# sourceMappingURL=internal-tool-apps.d.ts.map

package/components/apps/internal-tool-apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-tool-apps.d.ts","sourceRoot":"","sources":["../../../../../../src/components/apps/internal-tool-apps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AA6J5C,wBAAgB,mBAAmB,IAAI,eAAe,EAAE,CAsBvD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAEpE;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExE;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,mEAAmE;AACnE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,6BAA6B,IAAI,SAAS,yBAAyB,EAAE,CAQpF"}