@object-ui/app-shell 5.1.1 → 5.3.0

package/dist/chrome/toast-helpers.js

@@ -0,0 +1,59 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Toast helpers — convention-encoding wrappers around `sonner` so
+ * destructive flows (delete, archive, bulk-update) consistently expose
+ * an Undo affordance.
+ *
+ * Why a helper instead of raw `toast.success(...)` at call sites:
+ *   1. Most "delete OK" toasts in the codebase do not offer Undo, even
+ *      when the underlying API supports a reversal. The helper makes
+ *      adding Undo a one-line change.
+ *   2. The label, duration, and aria semantics stay consistent across
+ *      surfaces — recently-deleted records, archived comments, bulk
+ *      operations — so users don't have to relearn the affordance per
+ *      view.
+ *
+ * Usage:
+ *
+ *   import { toastWithUndo } from '@object-ui/app-shell';
+ *
+ *   toastWithUndo('Lead deleted', {
+ *     onUndo: () => dataSource.restore('lead', id),
+ *   });
+ */
+import { toast } from 'sonner';
+export function toastWithUndo(message, opts) {
+    const { onUndo, undoLabel = 'Undo', intent = 'success', duration = 6000, action: _ignoredAction, ...rest } = opts;
+    const emitter = intent === 'warning'
+        ? toast.warning
+        : intent === 'info'
+            ? toast.info
+            : toast.success;
+    return emitter(message, {
+        duration,
+        action: {
+            label: undoLabel,
+            onClick: async () => {
+                try {
+                    const result = onUndo();
+                    if (result && typeof result.then === 'function') {
+                        await result;
+                    }
+                    toast.success('Action undone');
+                }
+                catch (err) {
+                    toast.error('Could not undo', {
+                        description: err instanceof Error ? err.message : undefined,
+                    });
+                }
+            },
+        },
+        ...rest,
+    });
+}

package/dist/console/AppContent.js

@@ -30,6 +30,7 @@ import { LoadingScreen } from '../chrome/LoadingScreen';
 import { ObjectView } from '../views/ObjectView';
 import { KeyboardShortcutsDialog } from '../chrome/KeyboardShortcutsDialog';
 import { OnboardingWalkthrough } from '../chrome/OnboardingWalkthrough';
+import { RouteFader } from '../chrome/RouteFader';
 import { NavigationSyncEffect } from '../hooks/useNavigationSync';
 // Route-based code splitting — lazy-load less-frequently-used routes
 const RecordDetailView = lazy(() => import('../views/RecordDetailView').then(m => ({ default: m.RecordDetailView })));
@@ -44,6 +45,11 @@ const CreateAppPage = lazy(() => import('@object-ui/plugin-designer').then(m =>
 const EditAppPage = lazy(() => import('@object-ui/plugin-designer').then(m => ({ default: m.EditAppPage })));
 const PageDesignPage = lazy(() => import('@object-ui/plugin-designer').then(m => ({ default: m.PageDesignPage })));
 const DashboardDesignPage = lazy(() => import('@object-ui/plugin-designer').then(m => ({ default: m.DashboardDesignPage })));
+// Marketplace pages — first-class platform feature; mounted at `system/marketplace`
+// under any active app so admins can browse + install from inside the runtime.
+const MarketplacePage = lazy(() => import('./marketplace/MarketplacePage').then(m => ({ default: m.MarketplacePage })));
+const MarketplacePackagePage = lazy(() => import('./marketplace/MarketplacePackagePage').then(m => ({ default: m.MarketplacePackagePage })));
+const MarketplaceInstalledPage = lazy(() => import('./marketplace/MarketplaceInstalledPage').then(m => ({ default: m.MarketplaceInstalledPage })));
 export function AppContent({ extraRoutes, extraRoutesNoApp } = {}) {
     const [connectionState, setConnectionState] = useState('disconnected');
     const { user } = useAuth();
@@ -226,12 +232,12 @@ export function AppContent({ extraRoutes, extraRoutesNoApp } = {}) {
     if (!activeApp && !isCreateAppRoute && !isSystemRoute)
         return (_jsx("div", { className: "h-screen flex items-center justify-center", children: _jsxs(Empty, { children: [_jsx(EmptyTitle, { children: t('empty.noAppsConfigured') }), _jsx(EmptyDescription, { children: t('empty.noAppsConfiguredDescription') }), _jsxs("div", { className: "mt-4 flex flex-col sm:flex-row items-center gap-3", children: [_jsx(Button, { onClick: () => navigate('/create-app'), "data-testid": "create-first-app-btn", children: t('empty.createFirstApp') }), _jsx(Button, { variant: "outline", onClick: () => navigate('/apps/setup'), "data-testid": "go-to-settings-btn", children: t('empty.systemSettings') })] })] }) }));
     if (!activeApp && (isCreateAppRoute || isSystemRoute)) {
-        return (_jsx(Suspense, { fallback: _jsx(LoadingScreen, {}), children: _jsxs(Routes, { children: [_jsx(Route, { path: "create-app", element: _jsx(CreateAppPage, {}) }), extraRoutesNoApp] }) }));
+        return (_jsx(Suspense, { fallback: _jsx(LoadingScreen, {}), children: _jsxs(Routes, { children: [_jsx(Route, { path: "create-app", element: _jsx(CreateAppPage, {}) }), _jsx(Route, { path: "system/marketplace", element: _jsx(MarketplacePage, {}) }), _jsx(Route, { path: "system/marketplace/installed", element: _jsx(MarketplaceInstalledPage, {}) }), _jsx(Route, { path: "system/marketplace/:packageId", element: _jsx(MarketplacePackagePage, {}) }), extraRoutesNoApp] }) }));
     }
     const expressionUser = user
         ? { name: user.name, email: user.email, role: user.role ?? 'user' }
         : { name: 'Anonymous', email: '', role: 'guest' };
-    return (_jsxs(ExpressionProvider, { user: expressionUser, app: activeApp, data: {}, children: [_jsx(NavigationSyncEffect, {}), _jsxs(ConsoleLayout, { activeAppName: activeApp.name, activeApp: activeApp, onAppChange: handleAppChange, objects: allObjects, connectionState: connectionState, children: [_jsx(CommandPalette, { apps: apps, activeApp: activeApp, objects: allObjects, onAppChange: handleAppChange }), _jsx(KeyboardShortcutsDialog, {}), _jsx(OnboardingWalkthrough, {}), _jsx(ErrorBoundary, { children: _jsx(Suspense, { fallback: _jsx(LoadingScreen, {}), children: _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(Navigate, { to: findFirstRoute(activeApp.navigation || []), replace: true }) }), _jsx(Route, { path: ":objectName", element: _jsx(ObjectView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit, externalRefreshKey: refreshKey }) }), _jsx(Route, { path: ":objectName/new", element: _jsx(RecordFormPage, { mode: "create" }) }), _jsx(Route, { path: ":objectName/view/:viewId", element: _jsx(ObjectView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit, externalRefreshKey: refreshKey }) }), _jsx(Route, { path: ":objectName/record/:recordId", element: _jsx(RecordDetailView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit }, refreshKey) }), _jsx(Route, { path: ":objectName/record/:recordId/edit", element: _jsx(RecordFormPage, { mode: "edit" }) }), _jsx(Route, { path: "dashboard/:dashboardName", element: _jsx(DashboardView, { dataSource: dataSource }) }), _jsx(Route, { path: "report/:reportName", element: _jsx(ReportView, { dataSource: dataSource }) }), _jsx(Route, { path: "page/:pageName", element: _jsx(PageView, {}) }), _jsx(Route, { path: "design/page/:pageName", element: _jsx(PageDesignPage, {}) }), _jsx(Route, { path: "design/dashboard/:dashboardName", element: _jsx(DashboardDesignPage, {}) }), _jsx(Route, { path: "search", element: _jsx(SearchResultsPage, {}) }), _jsx(Route, { path: "create-app", element: _jsx(CreateAppPage, {}) }), _jsx(Route, { path: "edit-app/:editAppName", element: _jsx(EditAppPage, {}) }), extraRoutes] }) }) }), currentObjectDef && (_jsx(ModalForm, { schema: {
+    return (_jsxs(ExpressionProvider, { user: expressionUser, app: activeApp, data: {}, children: [_jsx(NavigationSyncEffect, {}), _jsxs(ConsoleLayout, { activeAppName: activeApp.name, activeApp: activeApp, onAppChange: handleAppChange, objects: allObjects, connectionState: connectionState, children: [_jsx(CommandPalette, { apps: apps, activeApp: activeApp, objects: allObjects, onAppChange: handleAppChange, dataSource: dataSource }), _jsx(KeyboardShortcutsDialog, {}), _jsx(OnboardingWalkthrough, {}), _jsx(ErrorBoundary, { children: _jsx(Suspense, { fallback: _jsx(LoadingScreen, {}), children: _jsx(RouteFader, { children: _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(Navigate, { to: resolveLandingRoute(activeApp), replace: true }) }), _jsx(Route, { path: ":objectName", element: _jsx(ObjectView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit, externalRefreshKey: refreshKey }) }), _jsx(Route, { path: ":objectName/new", element: _jsx(RecordFormPage, { mode: "create" }) }), _jsx(Route, { path: ":objectName/view/:viewId", element: _jsx(ObjectView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit, externalRefreshKey: refreshKey }) }), _jsx(Route, { path: ":objectName/record/:recordId", element: _jsx(RecordDetailView, { dataSource: dataSource, objects: allObjects, onEdit: handleEdit }, refreshKey) }), _jsx(Route, { path: ":objectName/record/:recordId/edit", element: _jsx(RecordFormPage, { mode: "edit" }) }), _jsx(Route, { path: "dashboard/:dashboardName", element: _jsx(DashboardView, { dataSource: dataSource }) }), _jsx(Route, { path: "report/:reportName", element: _jsx(ReportView, { dataSource: dataSource }) }), _jsx(Route, { path: "page/:pageName", element: _jsx(PageView, {}) }), _jsx(Route, { path: "design/page/:pageName", element: _jsx(PageDesignPage, {}) }), _jsx(Route, { path: "design/dashboard/:dashboardName", element: _jsx(DashboardDesignPage, {}) }), _jsx(Route, { path: "search", element: _jsx(SearchResultsPage, {}) }), _jsx(Route, { path: "create-app", element: _jsx(CreateAppPage, {}) }), _jsx(Route, { path: "edit-app/:editAppName", element: _jsx(EditAppPage, {}) }), _jsx(Route, { path: "system/marketplace", element: _jsx(MarketplacePage, {}) }), _jsx(Route, { path: "system/marketplace/installed", element: _jsx(MarketplaceInstalledPage, {}) }), _jsx(Route, { path: "system/marketplace/:packageId", element: _jsx(MarketplacePackagePage, {}) }), extraRoutes, _jsx(Route, { path: ":objectName/:maybeRecordId", element: _jsx(ShorthandRecordRedirect, {}) }), _jsx(Route, { path: "*", element: _jsx(RouteNotFound, {}) })] }) }) }) }), currentObjectDef && (_jsx(ModalForm, { schema: {
                             type: 'object-form',
                             formType: 'modal',
                             objectName: currentObjectDef.name,
@@ -289,3 +295,103 @@ function findFirstRoute(items) {
     }
     return '';
 }
+// Build the per-item route segment without recursing through groups —
+// used when `homePageId` resolved to an exact match and we just need to
+// know how to address it.
+function buildItemRoute(item) {
+    if (!item)
+        return '';
+    if (item.type === 'object')
+        return item.viewName ? `${item.objectName}/view/${item.viewName}` : `${item.objectName}`;
+    if (item.type === 'page')
+        return item.pageName ? `page/${item.pageName}` : '';
+    if (item.type === 'dashboard')
+        return item.dashboardName ? `dashboard/${item.dashboardName}` : '';
+    if (item.type === 'report')
+        return item.reportName ? `report/${item.reportName}` : '';
+    return '';
+}
+function findNavItemById(items, id) {
+    if (!items)
+        return undefined;
+    for (const item of items) {
+        if (item.id === id)
+            return item;
+        if (item.type === 'group' && item.children) {
+            const hit = findNavItemById(item.children, id);
+            if (hit)
+                return hit;
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolves the route to navigate to when the user lands on the bare
+ * `/console/apps/:appName` URL. Honors the app's explicit
+ * `homePageId` (Salesforce-style "Default Landing"); falls back to the
+ * first reachable nav item only when no homePageId is set or it points
+ * at something that doesn't yield a route. This is what lets the CRM
+ * example open on the Sales Dashboard instead of the Lead list.
+ */
+function resolveLandingRoute(activeApp) {
+    const homePageId = activeApp?.homePageId;
+    const navigation = activeApp?.navigation || [];
+    if (homePageId) {
+        const item = findNavItemById(navigation, homePageId);
+        const route = buildItemRoute(item);
+        if (route)
+            return route;
+    }
+    return findFirstRoute(navigation);
+}
+/**
+ * Heuristic: distinguish a record id from a route fragment.
+ *
+ * Record ids in this system are URL-safe slugs (alnum + `_` / `-`), typically
+ * 8+ chars (often 16+). They never collide with reserved second-segment
+ * keywords used by the route table (`new`, `view`, `record`, `dashboard`,
+ * `report`, `page`, `design`, `search`, `create-app`, `edit-app`).
+ */
+const RESERVED_SECOND_SEGMENTS = new Set([
+    'new', 'view', 'record', 'edit',
+    'dashboard', 'report', 'page',
+    'design', 'search', 'create-app', 'edit-app',
+]);
+function looksLikeRecordId(segment) {
+    if (!segment)
+        return false;
+    if (RESERVED_SECOND_SEGMENTS.has(segment))
+        return false;
+    // Allow URL-safe slug chars; reject anything with `/`, `?`, `#`, spaces.
+    if (!/^[A-Za-z0-9_-]+$/.test(segment))
+        return false;
+    // Most record ids are at least 6 chars (UUID, ULID, nanoid all >=8).
+    return segment.length >= 6;
+}
+/**
+ * Redirects `/apps/:appName/:objectName/:recordId` shorthand to the
+ * canonical `/apps/:appName/:objectName/record/:recordId` so externally
+ * shared / pasted links work, and legacy URL producers that built the
+ * shorthand keep functioning.
+ */
+function ShorthandRecordRedirect() {
+    const { objectName, maybeRecordId } = useParams();
+    const location = useLocation();
+    if (objectName && looksLikeRecordId(maybeRecordId)) {
+        const target = `${location.pathname.replace(/\/$/, '').replace(`/${maybeRecordId}`, `/record/${maybeRecordId}`)}${location.search}${location.hash}`;
+        return _jsx(Navigate, { to: target, replace: true });
+    }
+    return _jsx(RouteNotFound, {});
+}
+/**
+ * Visible "not found" fallback rendered for any unmatched URL inside the
+ * console app shell. Previously these URLs produced a fully blank content
+ * area with no indication that anything had gone wrong — users would think
+ * the app had crashed. An explicit Empty state with a "back to app home"
+ * action turns an opaque failure into a recoverable one.
+ */
+function RouteNotFound() {
+    const navigate = useNavigate();
+    const { t } = useObjectTranslation();
+    return (_jsx("div", { className: "flex h-full w-full items-center justify-center p-8", children: _jsxs(Empty, { children: [_jsx(EmptyTitle, { children: t('console.notFound.title', { defaultValue: 'Page not found' }) }), _jsx(EmptyDescription, { children: t('console.notFound.description', { defaultValue: 'The URL you followed does not match any view in this app.' }) }), _jsx("div", { className: "mt-4", children: _jsx(Button, { variant: "outline", onClick: () => navigate(-1), children: t('console.notFound.back', { defaultValue: 'Go back' }) }) })] }) }));
+}

package/dist/console/home/HomePage.js

@@ -22,12 +22,12 @@ import { useMetadata } from '../../providers/MetadataProvider';
 import { useRecentItems } from '../../hooks/useRecentItems';
 import { useFavorites } from '../../hooks/useFavorites';
 import { useObjectTranslation } from '@object-ui/i18n';
-import { useAuth } from '@object-ui/auth';
+import { useAuth, useIsWorkspaceAdmin } from '@object-ui/auth';
 import { AppCard } from './AppCard';
 import { RecentApps } from './RecentApps';
 import { StarredApps } from './StarredApps';
 import { Empty, EmptyTitle, EmptyDescription, Button } from '@object-ui/components';
-import { Plus, Settings, Sparkles, Star, Clock, ArrowDown } from 'lucide-react';
+import { Plus, Settings, Sparkles, Star, Clock, ArrowDown, Store } from 'lucide-react';
 function pickGreetingKey(hour) {
     if (hour < 5)
         return 'home.greetingNight';
@@ -56,6 +56,7 @@ export function HomePage() {
     const { recentItems } = useRecentItems();
     const { favorites } = useFavorites();
     const { user } = useAuth();
+    const isAdmin = useIsWorkspaceAdmin();
     const activeApps = apps.filter((a) => a.active !== false);
     const recentApps = recentItems
         .filter(item => item.type === 'object' || item.type === 'dashboard' || item.type === 'page' || item.type === 'record')
@@ -71,7 +72,7 @@ export function HomePage() {
     if (activeApps.length === 0) {
         return (_jsx("div", { className: "flex flex-1 items-center justify-center p-6", children: _jsxs(Empty, { children: [_jsx(EmptyTitle, { children: t('home.welcome', { defaultValue: 'Welcome to ObjectUI' }) }), _jsx(EmptyDescription, { children: t('home.welcomeDescription', {
                             defaultValue: 'Get started by creating your first application or configure your system settings.',
-                        }) }), _jsxs("div", { className: "mt-6 flex flex-col sm:flex-row items-center gap-3", children: [_jsxs(Button, { onClick: () => navigate('/create-app'), "data-testid": "create-first-app-btn", children: [_jsx(Plus, { className: "mr-2 h-4 w-4" }), t('home.createFirstApp', { defaultValue: 'Create Your First App' })] }), _jsxs(Button, { variant: "outline", onClick: () => navigate('/apps/setup'), "data-testid": "go-to-settings-btn", children: [_jsx(Settings, { className: "mr-2 h-4 w-4" }), t('home.systemSettings', { defaultValue: 'System Settings' })] })] })] }) }));
+                        }) }), _jsxs("div", { className: "mt-6 flex flex-col sm:flex-row items-center gap-3", children: [_jsxs(Button, { onClick: () => navigate('/create-app'), "data-testid": "create-first-app-btn", children: [_jsx(Plus, { className: "mr-2 h-4 w-4" }), t('home.createFirstApp', { defaultValue: 'Create Your First App' })] }), isAdmin && (_jsxs(Button, { variant: "outline", onClick: () => navigate('/apps/setup/system/marketplace'), "data-testid": "browse-marketplace-empty-btn", children: [_jsx(Store, { className: "mr-2 h-4 w-4" }), t('home.browseMarketplace', { defaultValue: 'Browse App Marketplace' })] })), _jsxs(Button, { variant: "outline", onClick: () => navigate('/apps/setup'), "data-testid": "go-to-settings-btn", children: [_jsx(Settings, { className: "mr-2 h-4 w-4" }), t('home.systemSettings', { defaultValue: 'System Settings' })] })] })] }) }));
     }
-    return (_jsxs("div", { className: "relative isolate min-h-full bg-gradient-to-b from-background via-background to-muted/40", children: [_jsxs("div", { "aria-hidden": true, className: "pointer-events-none absolute inset-x-0 top-0 -z-10 h-[28rem] overflow-hidden", children: [_jsx("div", { className: "absolute -top-32 -left-24 h-[28rem] w-[28rem] rounded-full bg-primary/30 blur-3xl opacity-70 dark:opacity-40" }), _jsx("div", { className: "absolute -top-20 right-[-6rem] h-[26rem] w-[36rem] rounded-full bg-sky-400/30 blur-3xl opacity-70 dark:opacity-35" }), _jsx("div", { className: "absolute top-32 left-1/3 h-[18rem] w-[24rem] rounded-full bg-fuchsia-400/25 blur-3xl opacity-60 dark:opacity-25" }), _jsx("div", { className: "absolute inset-0 bg-gradient-to-b from-transparent via-background/40 to-background" })] }), _jsx("section", { className: "px-4 sm:px-6 lg:px-8 pt-10 pb-6", children: _jsxs("div", { className: "max-w-7xl mx-auto", children: [_jsxs("div", { className: "flex items-center gap-2 text-xs font-medium text-muted-foreground mb-3", children: [_jsx(Sparkles, { className: "h-3.5 w-3.5 text-primary" }), _jsx("span", { className: "uppercase tracking-wider", children: t('home.title', { defaultValue: 'Home' }) })] }), _jsxs("h1", { className: "text-3xl sm:text-4xl lg:text-5xl font-bold tracking-tight text-pretty", children: [_jsxs("span", { className: "bg-gradient-to-r from-foreground via-foreground to-foreground/70 bg-clip-text text-transparent", children: [greeting, displayName ? `, ${displayName}` : ''] }), _jsx("span", { className: "text-foreground/40", children: "." })] }), _jsx("p", { className: "text-base sm:text-lg text-muted-foreground mt-2 max-w-2xl", children: t('home.heroTagline', { defaultValue: 'Pick up where you left off, or explore something new.' }) })] }) }), _jsx("div", { className: "px-4 sm:px-6 lg:px-8 pb-16", children: _jsxs("div", { className: "max-w-7xl mx-auto space-y-10", children: [starredApps.length === 0 && recentApps.length === 0 && (_jsx(GettingStartedHint, { t: t })), starredApps.length > 0 && _jsx(StarredApps, { items: starredApps }), recentApps.length > 0 && _jsx(RecentApps, { items: recentApps }), _jsxs("section", { children: [_jsx("div", { className: "flex items-end justify-between mb-5", children: _jsxs("div", { children: [_jsx("h2", { className: "text-2xl font-semibold tracking-tight", children: t('home.allApps', { defaultValue: 'All Applications' }) }), _jsxs("p", { className: "text-sm text-muted-foreground mt-1", children: [activeApps.length, ' · ', t('home.stats.apps', { defaultValue: 'Applications' })] })] }) }), _jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-4", children: activeApps.map((app, idx) => (_jsx(AppCard, { app: app, index: idx, onClick: () => navigate(`/apps/${app.name}`), isFavorite: favorites.some(f => f.id === `app:${app.name}`) }, app.name))) })] })] }) })] }));
+    return (_jsxs("div", { className: "relative isolate min-h-full bg-gradient-to-b from-background via-background to-muted/40", children: [_jsxs("div", { "aria-hidden": true, className: "pointer-events-none absolute inset-x-0 top-0 -z-10 h-[28rem] overflow-hidden", children: [_jsx("div", { className: "absolute -top-32 -left-24 h-[28rem] w-[28rem] rounded-full bg-primary/30 blur-3xl opacity-70 dark:opacity-40" }), _jsx("div", { className: "absolute -top-20 right-[-6rem] h-[26rem] w-[36rem] rounded-full bg-sky-400/30 blur-3xl opacity-70 dark:opacity-35" }), _jsx("div", { className: "absolute top-32 left-1/3 h-[18rem] w-[24rem] rounded-full bg-fuchsia-400/25 blur-3xl opacity-60 dark:opacity-25" }), _jsx("div", { className: "absolute inset-0 bg-gradient-to-b from-transparent via-background/40 to-background" })] }), _jsx("section", { className: "px-4 sm:px-6 lg:px-8 pt-10 pb-6", children: _jsxs("div", { className: "max-w-7xl mx-auto", children: [_jsxs("div", { className: "flex items-center gap-2 text-xs font-medium text-muted-foreground mb-3", children: [_jsx(Sparkles, { className: "h-3.5 w-3.5 text-primary" }), _jsx("span", { className: "uppercase tracking-wider", children: t('home.title', { defaultValue: 'Home' }) })] }), _jsxs("h1", { className: "text-3xl sm:text-4xl lg:text-5xl font-bold tracking-tight text-pretty", children: [_jsxs("span", { className: "bg-gradient-to-r from-foreground via-foreground to-foreground/70 bg-clip-text text-transparent", children: [greeting, displayName ? `, ${displayName}` : ''] }), _jsx("span", { className: "text-foreground/40", children: "." })] }), _jsx("p", { className: "text-base sm:text-lg text-muted-foreground mt-2 max-w-2xl", children: t('home.heroTagline', { defaultValue: 'Pick up where you left off, or explore something new.' }) })] }) }), _jsx("div", { className: "px-4 sm:px-6 lg:px-8 pb-16", children: _jsxs("div", { className: "max-w-7xl mx-auto space-y-10", children: [starredApps.length === 0 && recentApps.length === 0 && (_jsx(GettingStartedHint, { t: t })), starredApps.length > 0 && _jsx(StarredApps, { items: starredApps }), recentApps.length > 0 && _jsx(RecentApps, { items: recentApps }), _jsxs("section", { children: [_jsxs("div", { className: "flex items-end justify-between mb-5", children: [_jsxs("div", { children: [_jsx("h2", { className: "text-2xl font-semibold tracking-tight", children: t('home.allApps', { defaultValue: 'All Applications' }) }), _jsxs("p", { className: "text-sm text-muted-foreground mt-1", children: [activeApps.length, ' · ', t('home.stats.apps', { defaultValue: 'Applications' })] })] }), isAdmin && (_jsxs(Button, { variant: "outline", onClick: () => navigate('/apps/setup/system/marketplace'), "data-testid": "browse-marketplace-btn", children: [_jsx(Store, { className: "mr-2 h-4 w-4" }), t('home.browseMarketplace', { defaultValue: 'Browse App Marketplace' })] }))] }), _jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-4", children: activeApps.map((app, idx) => (_jsx(AppCard, { app: app, index: idx, onClick: () => navigate(`/apps/${app.name}`), isFavorite: favorites.some(f => f.id === `app:${app.name}`) }, app.name))) })] })] }) })] }));
 }

package/dist/console/marketplace/MarkdownText.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tiny CommonMark-subset renderer for marketplace READMEs.
+ *
+ * Covers what app authors actually write in their README field:
+ *   • `#`, `##`, `###` headings
+ *   • Blank-line-separated paragraphs
+ *   • `- ` / `* ` bulleted lists (single level)
+ *   • `1. ` numbered lists (single level)
+ *   • `**bold**`, `*italic*`, `` `code` ``, `[text](url)` inline
+ *   • Triple-backtick fenced code blocks
+ *
+ * Deliberately NOT a full Markdown engine — we want zero new deps and
+ * predictable output. If a README really needs tables or images, the
+ * publisher can host their own docs and link via `homepage_url`.
+ */
+export declare function MarkdownText({ source, className }: {
+    source: string;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/console/marketplace/MarkdownText.js

@@ -0,0 +1,141 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Tiny CommonMark-subset renderer for marketplace READMEs.
+ *
+ * Covers what app authors actually write in their README field:
+ *   • `#`, `##`, `###` headings
+ *   • Blank-line-separated paragraphs
+ *   • `- ` / `* ` bulleted lists (single level)
+ *   • `1. ` numbered lists (single level)
+ *   • `**bold**`, `*italic*`, `` `code` ``, `[text](url)` inline
+ *   • Triple-backtick fenced code blocks
+ *
+ * Deliberately NOT a full Markdown engine — we want zero new deps and
+ * predictable output. If a README really needs tables or images, the
+ * publisher can host their own docs and link via `homepage_url`.
+ */
+import { Fragment } from 'react';
+function parseBlocks(src) {
+    const lines = src.replace(/\r\n/g, '\n').split('\n');
+    const blocks = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Fenced code block
+        if (line.startsWith('```')) {
+            const lang = line.slice(3).trim();
+            i++;
+            const buf = [];
+            while (i < lines.length && !lines[i].startsWith('```')) {
+                buf.push(lines[i]);
+                i++;
+            }
+            i++; // closing fence
+            blocks.push({ type: 'code', text: buf.join('\n'), lang });
+            continue;
+        }
+        // Headings
+        const h = /^(#{1,3})\s+(.*)$/.exec(line);
+        if (h) {
+            const level = h[1].length;
+            blocks.push({ type: `h${level}`, text: h[2].trim() });
+            i++;
+            continue;
+        }
+        // Bullet list
+        if (/^[-*]\s+/.test(line)) {
+            const items = [];
+            while (i < lines.length && /^[-*]\s+/.test(lines[i])) {
+                items.push(lines[i].replace(/^[-*]\s+/, ''));
+                i++;
+            }
+            blocks.push({ type: 'ul', items });
+            continue;
+        }
+        // Numbered list
+        if (/^\d+\.\s+/.test(line)) {
+            const items = [];
+            while (i < lines.length && /^\d+\.\s+/.test(lines[i])) {
+                items.push(lines[i].replace(/^\d+\.\s+/, ''));
+                i++;
+            }
+            blocks.push({ type: 'ol', items });
+            continue;
+        }
+        // Blank line → flush
+        if (!line.trim()) {
+            i++;
+            continue;
+        }
+        // Paragraph (collect until blank / heading / list)
+        const buf = [];
+        while (i < lines.length &&
+            lines[i].trim() &&
+            !/^#{1,3}\s+/.test(lines[i]) &&
+            !/^[-*]\s+/.test(lines[i]) &&
+            !/^\d+\.\s+/.test(lines[i]) &&
+            !lines[i].startsWith('```')) {
+            buf.push(lines[i]);
+            i++;
+        }
+        blocks.push({ type: 'p', text: buf.join(' ') });
+    }
+    return blocks;
+}
+// Inline pass: **bold**, *italic*, `code`, [text](url). Order matters
+// so we tokenize once and replace by position.
+function renderInline(input) {
+    const out = [];
+    let remaining = input;
+    let key = 0;
+    const patterns = [
+        { re: /`([^`]+)`/, render: (m) => _jsx("code", { className: "rounded bg-muted px-1.5 py-0.5 font-mono text-[0.85em]", children: m[1] }, `k${key++}`) },
+        { re: /\*\*([^*]+)\*\*/, render: (m) => _jsx("strong", { className: "font-semibold text-foreground", children: m[1] }, `k${key++}`) },
+        { re: /\*([^*]+)\*/, render: (m) => _jsx("em", { children: m[1] }, `k${key++}`) },
+        { re: /\[([^\]]+)\]\(([^)]+)\)/, render: (m) => (_jsx("a", { href: m[2], target: "_blank", rel: "noopener noreferrer", className: "text-violet-600 underline-offset-2 hover:underline dark:text-violet-400", children: m[1] }, `k${key++}`)) },
+    ];
+    while (remaining) {
+        let bestIdx = -1;
+        let bestMatch = null;
+        let bestPattern = null;
+        for (const p of patterns) {
+            const m = p.re.exec(remaining);
+            if (m && (bestIdx === -1 || m.index < bestIdx)) {
+                bestIdx = m.index;
+                bestMatch = m;
+                bestPattern = p;
+            }
+        }
+        if (!bestMatch || !bestPattern) {
+            out.push(remaining);
+            break;
+        }
+        if (bestIdx > 0)
+            out.push(remaining.slice(0, bestIdx));
+        out.push(bestPattern.render(bestMatch));
+        remaining = remaining.slice(bestIdx + bestMatch[0].length);
+    }
+    return _jsx(_Fragment, { children: out.map((n, i) => _jsx(Fragment, { children: n }, i)) });
+}
+export function MarkdownText({ source, className }) {
+    const blocks = parseBlocks(source);
+    return (_jsx("div", { className: `flex flex-col gap-4 text-sm leading-relaxed text-foreground/90 ${className ?? ''}`, children: blocks.map((b, i) => {
+            switch (b.type) {
+                case 'h1':
+                    return _jsx("h2", { className: "mt-2 text-xl font-bold tracking-tight", children: renderInline(b.text ?? '') }, i);
+                case 'h2':
+                    return _jsx("h3", { className: "mt-3 text-base font-semibold tracking-tight", children: renderInline(b.text ?? '') }, i);
+                case 'h3':
+                    return _jsx("h4", { className: "mt-2 text-sm font-semibold tracking-tight text-foreground/80", children: renderInline(b.text ?? '') }, i);
+                case 'p':
+                    return _jsx("p", { children: renderInline(b.text ?? '') }, i);
+                case 'ul':
+                    return (_jsx("ul", { className: "ml-1 flex list-none flex-col gap-1.5", children: (b.items ?? []).map((it, j) => (_jsxs("li", { className: "flex gap-2", children: [_jsx("span", { "aria-hidden": "true", className: "mt-1.5 inline-block h-1.5 w-1.5 shrink-0 rounded-full bg-violet-500/70" }), _jsx("span", { children: renderInline(it) })] }, j))) }, i));
+                case 'ol':
+                    return (_jsx("ol", { className: "ml-5 flex list-decimal flex-col gap-1.5 marker:text-muted-foreground", children: (b.items ?? []).map((it, j) => (_jsx("li", { className: "pl-1", children: renderInline(it) }, j))) }, i));
+                case 'code':
+                    return (_jsx("pre", { className: "overflow-x-auto rounded-lg border bg-muted/40 p-3 text-xs leading-relaxed", children: _jsx("code", { className: "font-mono", children: b.text }) }, i));
+            }
+            return null;
+        }) }));
+}

package/dist/console/marketplace/MarketplaceInstalledPage.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Marketplace Installed Apps Page.
+ *
+ * Lists packages currently installed into THIS runtime's kernel (the
+ * `install-local` path, not cloud environments). Each row has an
+ * Uninstall action that removes the cached manifest from
+ * `<cwd>/.objectstack/installed-packages/<id>.json`.
+ *
+ * Note the explicit caveat: the framework kernel API is additive only
+ * (`engine.registerApp(manifest)`) — there is no `unregisterApp`. So
+ * uninstall removes the on-disk cache (preventing the package from
+ * re-loading on next boot) but the app remains live in the running
+ * kernel until the runtime is restarted. We show this in the UI so a
+ * developer doesn't get confused when the app stays visible in the
+ * switcher after clicking Uninstall.
+ */
+export declare function MarketplaceInstalledPage(): import("react/jsx-runtime").JSX.Element;

package/dist/console/marketplace/MarketplaceInstalledPage.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Marketplace Installed Apps Page.
+ *
+ * Lists packages currently installed into THIS runtime's kernel (the
+ * `install-local` path, not cloud environments). Each row has an
+ * Uninstall action that removes the cached manifest from
+ * `<cwd>/.objectstack/installed-packages/<id>.json`.
+ *
+ * Note the explicit caveat: the framework kernel API is additive only
+ * (`engine.registerApp(manifest)`) — there is no `unregisterApp`. So
+ * uninstall removes the on-disk cache (preventing the package from
+ * re-loading on next boot) but the app remains live in the running
+ * kernel until the runtime is restarted. We show this in the UI so a
+ * developer doesn't get confused when the app stays visible in the
+ * switcher after clicking Uninstall.
+ */
+import { useEffect, useState } from 'react';
+import { useNavigate, useParams } from 'react-router-dom';
+import { Card, CardContent, CardHeader, CardTitle, Badge, Button, Skeleton, } from '@object-ui/components';
+import { ArrowLeft, RefreshCcw, Store, Trash2, AlertCircle, ExternalLink } from 'lucide-react';
+import { listLocalInstalls, uninstallLocal, } from './marketplaceApi';
+export function MarketplaceInstalledPage() {
+    const navigate = useNavigate();
+    const { appName } = useParams();
+    const basePath = appName ? `/apps/${appName}` : '';
+    const [items, setItems] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [working, setWorking] = useState(null);
+    const [result, setResult] = useState(null);
+    const load = async () => {
+        setLoading(true);
+        try {
+            const list = await listLocalInstalls();
+            setItems(list);
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    useEffect(() => { void load(); }, []);
+    const doUninstall = async (entry) => {
+        if (!confirm(`Uninstall ${entry.manifestId} v${entry.version} from this runtime?\n\nThe cached manifest will be removed. The app will remain loaded in the running kernel until the next restart.`)) {
+            return;
+        }
+        setWorking(entry.manifestId);
+        setResult(null);
+        try {
+            await uninstallLocal(entry.manifestId);
+            setResult({
+                ok: true,
+                message: `Removed ${entry.manifestId}. Restart the runtime to fully unload it from the running kernel.`,
+            });
+            await load();
+        }
+        catch (e) {
+            setResult({ ok: false, message: e?.message ?? String(e) });
+        }
+        finally {
+            setWorking(null);
+        }
+    };
+    return (_jsxs("div", { className: "flex flex-col gap-6 p-4 sm:p-6 max-w-5xl", children: [_jsxs(Button, { variant: "ghost", size: "sm", className: "self-start", onClick: () => navigate(`${basePath}/system/marketplace`), children: [_jsx(ArrowLeft, { className: "h-4 w-4 mr-1.5", "aria-hidden": "true" }), "Back to marketplace"] }), _jsxs("div", { className: "flex items-start justify-between gap-4 flex-wrap", children: [_jsxs("div", { children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Store, { className: "h-6 w-6 text-primary", "aria-hidden": "true" }), _jsx("h1", { className: "text-xl sm:text-2xl font-bold tracking-tight", children: "Installed Apps" })] }), _jsxs("p", { className: "text-sm text-muted-foreground mt-1", children: ["Marketplace packages currently installed into this runtime's kernel. Cached manifests live in ", _jsx("code", { className: "font-mono text-xs", children: ".objectstack/installed-packages/" }), " and survive restarts."] })] }), _jsxs(Button, { variant: "outline", size: "sm", onClick: () => void load(), disabled: loading, children: [_jsx(RefreshCcw, { className: "h-4 w-4 mr-1.5", "aria-hidden": "true" }), "Refresh"] })] }), result && (_jsx("div", { className: `rounded-md border p-3 text-sm ${result.ok ? 'border-green-500/30 bg-green-500/5 text-green-700 dark:text-green-400' : 'border-destructive/30 bg-destructive/5 text-destructive'}`, children: _jsxs("div", { className: "flex items-start gap-2", children: [_jsx(AlertCircle, { className: "h-4 w-4 mt-0.5 shrink-0", "aria-hidden": "true" }), _jsx("div", { children: result.message })] }) })), loading && items.length === 0 ? (_jsx("div", { className: "grid gap-3", children: Array.from({ length: 3 }).map((_, i) => (_jsx(Skeleton, { className: "h-20 w-full" }, i))) })) : items.length === 0 ? (_jsxs("div", { className: "text-center py-12 text-sm text-muted-foreground border rounded-md", children: [_jsx("p", { children: "No marketplace apps installed in this runtime yet." }), _jsx(Button, { variant: "link", className: "mt-2", onClick: () => navigate(`${basePath}/system/marketplace`), children: "Browse the marketplace \u2192" })] })) : (_jsx("div", { className: "grid gap-3", children: items.map((entry) => (_jsxs(Card, { children: [_jsxs(CardHeader, { className: "flex flex-row items-start justify-between gap-3 pb-2", children: [_jsxs("div", { className: "min-w-0", children: [_jsxs(CardTitle, { className: "text-base truncate flex items-center gap-2", children: [entry.manifestId, _jsxs(Badge, { variant: "outline", children: ["v", entry.version] })] }), _jsxs("div", { className: "text-xs text-muted-foreground mt-1 flex flex-wrap gap-x-3 gap-y-1", children: [_jsxs("span", { children: ["Installed ", new Date(entry.installedAt).toLocaleString()] }), entry.installedBy && _jsxs("span", { children: ["by ", entry.installedBy] }), _jsxs("span", { children: ["package ", _jsx("code", { className: "font-mono", children: entry.packageId })] })] })] }), _jsxs("div", { className: "flex items-center gap-2 shrink-0", children: [_jsxs(Button, { variant: "ghost", size: "sm", onClick: () => navigate(`${basePath}/system/marketplace/${entry.packageId}`), children: [_jsx(ExternalLink, { className: "h-4 w-4 mr-1.5", "aria-hidden": "true" }), "Details"] }), _jsxs(Button, { variant: "outline", size: "sm", onClick: () => void doUninstall(entry), disabled: working === entry.manifestId, children: [_jsx(Trash2, { className: "h-4 w-4 mr-1.5", "aria-hidden": "true" }), working === entry.manifestId ? 'Uninstalling…' : 'Uninstall'] })] })] }), _jsxs(CardContent, { className: "pt-0 text-xs text-muted-foreground", children: ["Cached as ", _jsxs("code", { className: "font-mono", children: [".objectstack/installed-packages/", entry.manifestId.replace(/[^a-zA-Z0-9._-]/g, '_'), ".json"] })] })] }, entry.manifestId))) })), _jsxs("p", { className: "text-xs text-muted-foreground border-t pt-4", children: [_jsx("strong", { children: "Note:" }), " The kernel API is additive only \u2014 uninstall removes the on-disk manifest so the package won't load on next boot, but the running kernel keeps the app registered until you restart the runtime."] })] }));
+}

package/dist/console/marketplace/MarketplacePackagePage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Marketplace Package Detail Page.
+ *
+ * Shows full package metadata + readme + approved version list. Provides
+ * an "Install" button that opens a dialog with environment picker.
+ */
+export declare function MarketplacePackagePage(): import("react/jsx-runtime").JSX.Element;