@wildo-ai/presets-components 1.0.1

package/dist/esm/config/preset-shell.js

@@ -0,0 +1,244 @@
+/**
+ * App Shell Presets — `APP_SHELL_*`
+ *
+ * App chrome configuration constants. Ready-to-spread into `appComponentsConfiguration`.
+ */
+import { ApplicationLevelComponentType, SidebarSectionBehavior, SidebarSectionContentKind, CommandBarPolicy, UserDropdownAvatarDisplay, UserDropdownSection, SidebarResponsivePolicy, } from '@wildo-ai/saas-frontend-lib';
+import { HorizontalPlacement } from '@wildo-ai/presets-components-models';
+import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Sidebar Section Helpers
+// ═══════════════════════════════════════════════════════════════════════════════
+/** Helper to build a NAVIGATION_LIST section with sensible defaults. */
+export function navSection(ref, overrides) {
+    return {
+        contentKind: SidebarSectionContentKind.NAVIGATION_LIST,
+        ref,
+        behavior: SidebarSectionBehavior.STATIC,
+        collapsible: true,
+        defaultCollapsed: false,
+        children: [],
+        ...overrides,
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Shell Presets — APP_SHELL_*
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Sidebar shell — full sidebar + fixed menubar, toolbar, command menu, user dropdown.
+ *
+ * Best for: typical SaaS apps with sidebar navigation.
+ * Includes favorites section in the sidebar.
+ */
+export const APP_SHELL_SIDEBAR = {
+    [ApplicationLevelComponentType.MENUBAR]: {
+        displayPolicy: "FIXED",
+        hostedComponents: [
+            { componentType: ApplicationLevelComponentType.NAVIGATION_CONTROL, placement: HorizontalPlacement.START },
+            { componentType: ApplicationLevelComponentType.COMMAND_MENU, placement: HorizontalPlacement.START },
+            { componentType: ApplicationLevelComponentType.QUICK_ACTION_BUTTON, placement: HorizontalPlacement.END, breakpoint: ViewportBreakpoint.DESKTOP },
+            { componentType: ApplicationLevelComponentType.NOTIFICATION_CENTER, placement: HorizontalPlacement.END },
+            { componentType: ApplicationLevelComponentType.USER_DROPDOWN, placement: HorizontalPlacement.END },
+        ],
+    },
+    [ApplicationLevelComponentType.TOOLBAR]: true,
+    [ApplicationLevelComponentType.HOTKEY]: true,
+    [ApplicationLevelComponentType.NOTIFICATION_CENTER]: true,
+    [ApplicationLevelComponentType.SIDEBAR]: {
+        placement: HorizontalPlacement.START,
+        collapsible: true,
+        responsiveBreakpoint: ViewportBreakpoint.MOBILE,
+        responsivePolicy: SidebarResponsivePolicy.BURGER,
+        contentSections: [
+            navSection('favorites', { behavior: SidebarSectionBehavior.FAVORITES }),
+            navSection('main', { showLabel: false, collapsible: false, nested: true, maxNestingDepth: 2 }),
+            navSection('tools'),
+            navSection('settings', { defaultCollapsed: true }),
+        ],
+        defaultSection: "main",
+        showUncategorized: true,
+    },
+    [ApplicationLevelComponentType.COMMAND_MENU]: {
+        policy: CommandBarPolicy.COMMAND_ONLY,
+        showRecent: true,
+        maxRecentItems: 5,
+        showShortcuts: true,
+        openShortcut: 'Cmd+K',
+    },
+    [ApplicationLevelComponentType.QUICK_ACTION_BUTTON]: true,
+    [ApplicationLevelComponentType.QUICK_SWITCHER]: true,
+    [ApplicationLevelComponentType.CONTROL_PANEL]: false,
+    [ApplicationLevelComponentType.STATUS_BAR]: {
+        showMemoryUsage: false,
+        showNotificationCount: true,
+        showConnectionStatus: true,
+    },
+    [ApplicationLevelComponentType.USER_DROPDOWN]: {
+        avatarDisplay: UserDropdownAvatarDisplay.AVATAR_ONLY,
+        sections: [
+            UserDropdownSection.USER_INFO,
+            UserDropdownSection.ORG_SWITCHER,
+            UserDropdownSection.PREFERENCES,
+            UserDropdownSection.SETTINGS,
+            UserDropdownSection.LOGOUT,
+        ],
+        showOrgSwitcher: true,
+        showLogout: true,
+        mergeSettings: false,
+    },
+    [ApplicationLevelComponentType.SETTINGS_DROPDOWN]: {
+        mergedWith: ApplicationLevelComponentType.USER_DROPDOWN,
+    },
+    [ApplicationLevelComponentType.NAVIGATION_CONTROL]: true,
+    [ApplicationLevelComponentType.ACTIVITY_BAR]: false,
+    [ApplicationLevelComponentType.UTILITY_PANEL]: false,
+};
+/**
+ * Dense shell — nav rail + sidebar with drawer policy, vertical tablet breakpoint.
+ *
+ * Best for: data-heavy admin panels, list-detail layouts, CRM tools.
+ * No favorites section — admin UIs typically don't use favorites.
+ */
+export const APP_SHELL_DENSE = {
+    ...APP_SHELL_SIDEBAR,
+    [ApplicationLevelComponentType.SIDEBAR]: {
+        placement: HorizontalPlacement.START,
+        collapsible: true,
+        responsiveBreakpoint: ViewportBreakpoint.VERT_TABLET,
+        responsivePolicy: SidebarResponsivePolicy.DRAWER,
+        contentSections: [
+            navSection('main', { showLabel: false, collapsible: false, nested: true, maxNestingDepth: 2 }),
+            navSection('tools'),
+            navSection('settings', { defaultCollapsed: true }),
+        ],
+        defaultSection: "main",
+        showUncategorized: true,
+    },
+    [ApplicationLevelComponentType.ACTIVITY_BAR]: true,
+    [ApplicationLevelComponentType.STATUS_BAR]: {
+        showMemoryUsage: false,
+        showNotificationCount: true,
+        showConnectionStatus: true,
+    },
+};
+/**
+ * Minimal shell — no sidebar, just a menubar with essential controls.
+ *
+ * Best for: landing pages, single-purpose tools, wizard-style flows,
+ * public-facing apps with minimal navigation.
+ */
+export const APP_SHELL_MINIMAL = {
+    ...APP_SHELL_SIDEBAR,
+    [ApplicationLevelComponentType.SIDEBAR]: false,
+    [ApplicationLevelComponentType.TOOLBAR]: false,
+    [ApplicationLevelComponentType.QUICK_ACTION_BUTTON]: false,
+    [ApplicationLevelComponentType.QUICK_SWITCHER]: false,
+    [ApplicationLevelComponentType.STATUS_BAR]: false,
+};
+/**
+ * Mobile shell — FAB, no sidebar.
+ *
+ * Best for: PWAs, mobile-first apps, bottom tabs.
+ */
+export const APP_SHELL_MOBILE = {
+    ...APP_SHELL_SIDEBAR,
+    [ApplicationLevelComponentType.SIDEBAR]: false,
+    [ApplicationLevelComponentType.TOOLBAR]: false,
+    [ApplicationLevelComponentType.QUICK_ACTION_BUTTON]: "FLOATING",
+    [ApplicationLevelComponentType.STATUS_BAR]: false,
+};
+/**
+ * Centered shell — command menu only, no sidebar.
+ *
+ * Best for: CMS editors, docs platforms, content-first apps.
+ */
+export const APP_SHELL_CENTERED = {
+    ...APP_SHELL_SIDEBAR,
+    [ApplicationLevelComponentType.SIDEBAR]: false,
+    [ApplicationLevelComponentType.TOOLBAR]: false,
+    [ApplicationLevelComponentType.QUICK_ACTION_BUTTON]: false,
+    [ApplicationLevelComponentType.QUICK_SWITCHER]: true,
+};
+/**
+ * Rail shell — activity bar only, no sidebar.
+ *
+ * Best for: monitoring tools, dense apps with many top-level sections.
+ */
+export const APP_SHELL_RAIL = {
+    ...APP_SHELL_SIDEBAR,
+    [ApplicationLevelComponentType.SIDEBAR]: false,
+    [ApplicationLevelComponentType.ACTIVITY_BAR]: true,
+    [ApplicationLevelComponentType.TOOLBAR]: true,
+};
+/**
+ * Studio shell — sidebar + inspector (control panel) as secondary panel.
+ *
+ * Best for: IDE-like tools, design tools, CRM with property panels.
+ */
+export const APP_SHELL_STUDIO = {
+    ...APP_SHELL_SIDEBAR,
+    [ApplicationLevelComponentType.SIDEBAR]: {
+        placement: HorizontalPlacement.START,
+        collapsible: true,
+        responsiveBreakpoint: ViewportBreakpoint.VERT_TABLET,
+        responsivePolicy: SidebarResponsivePolicy.DRAWER,
+        contentSections: [
+            navSection('main', { showLabel: false, collapsible: false, nested: true, maxNestingDepth: 2 }),
+            navSection('tools'),
+            navSection('settings', { defaultCollapsed: true }),
+        ],
+        defaultSection: "main",
+        showUncategorized: true,
+    },
+    [ApplicationLevelComponentType.CONTROL_PANEL]: true,
+    [ApplicationLevelComponentType.TOOLBAR]: true,
+};
+/**
+ * Kiosk shell — no chrome. Content only.
+ *
+ * Best for: POS, public displays, embedded widgets.
+ */
+export const APP_SHELL_KIOSK = {
+    ...APP_SHELL_SIDEBAR,
+    [ApplicationLevelComponentType.MENUBAR]: false,
+    [ApplicationLevelComponentType.TOOLBAR]: false,
+    [ApplicationLevelComponentType.SIDEBAR]: false,
+    [ApplicationLevelComponentType.COMMAND_MENU]: false,
+    [ApplicationLevelComponentType.QUICK_ACTION_BUTTON]: false,
+    [ApplicationLevelComponentType.QUICK_SWITCHER]: false,
+    [ApplicationLevelComponentType.CONTROL_PANEL]: false,
+    [ApplicationLevelComponentType.STATUS_BAR]: false,
+    [ApplicationLevelComponentType.USER_DROPDOWN]: false,
+    [ApplicationLevelComponentType.SETTINGS_DROPDOWN]: false,
+    [ApplicationLevelComponentType.NAVIGATION_CONTROL]: false,
+    [ApplicationLevelComponentType.NOTIFICATION_CENTER]: false,
+};
+/**
+ * Cockpit shell — rail + sidebar, workspace switcher prominent.
+ *
+ * Best for: multi-workspace apps (Slack, project mgmt with many projects).
+ */
+export const APP_SHELL_COCKPIT = {
+    ...APP_SHELL_DENSE,
+    [ApplicationLevelComponentType.SIDEBAR]: {
+        placement: HorizontalPlacement.START,
+        collapsible: true,
+        responsiveBreakpoint: ViewportBreakpoint.VERT_TABLET,
+        responsivePolicy: SidebarResponsivePolicy.DRAWER,
+        contentSections: [
+            navSection('projects', { behavior: SidebarSectionBehavior.DYNAMIC, nested: true, maxNestingDepth: 2 }),
+            navSection('main', { showLabel: false, collapsible: false, nested: true, maxNestingDepth: 2 }),
+            navSection('tools'),
+            navSection('settings', { defaultCollapsed: true }),
+        ],
+        defaultSection: "main",
+        showUncategorized: true,
+    },
+    [ApplicationLevelComponentType.QUICK_SWITCHER]: true,
+    [ApplicationLevelComponentType.STATUS_BAR]: {
+        showMemoryUsage: false,
+        showNotificationCount: true,
+        showConnectionStatus: true,
+    },
+};
+//# sourceMappingURL=preset-shell.js.map

package/dist/esm/config/preset-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-shell.js","sourceRoot":"","sources":["../../../src/config/preset-shell.ts"],"names":[],"mappings":"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"}

package/dist/esm/config/preset-utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Preset Composition Utilities
+ *
+ * Deep-merge helpers that apply partial overrides to a single concern
+ * within an `AppConfiguration_Frontend`. These stay as functions because
+ * they compute a merge.
+ *
+ * Usage:
+ * ```
+ * const config = withSidebar(APP_STANDARD, { collapsible: false });
+ * ```
+ */
+import type { AppConfiguration_Frontend } from '@wildo-ai/saas-frontend-lib';
+import type { TypographyConfiguration, DesignTokenConfiguration } from '@wildo-ai/presets-components-models';
+import type { NavigationLayout } from '@wildo-ai/saas-models';
+/**
+ * Override sidebar configuration within an app config.
+ * Only merges if the existing sidebar value is an object (not `false`).
+ */
+export declare function withSidebar(config: AppConfiguration_Frontend, sidebarOverrides: Record<string, unknown>): AppConfiguration_Frontend;
+/**
+ * Override command menu configuration within an app config.
+ * Only merges if the existing command menu value is an object.
+ */
+export declare function withCommandMenu(config: AppConfiguration_Frontend, commandMenuOverrides: Record<string, unknown>): AppConfiguration_Frontend;
+/**
+ * Override user dropdown configuration within an app config.
+ * Only merges if the existing user dropdown value is an object.
+ */
+export declare function withUserDropdown(config: AppConfiguration_Frontend, dropdownOverrides: Record<string, unknown>): AppConfiguration_Frontend;
+/**
+ * Override status bar configuration within an app config.
+ * Only merges if the existing status bar value is an object.
+ */
+export declare function withStatusBar(config: AppConfiguration_Frontend, statusBarOverrides: Record<string, unknown>): AppConfiguration_Frontend;
+/**
+ * Override design tokens within an app config.
+ * Merges token overrides into the existing token map.
+ */
+export declare function withDesignTokens(config: AppConfiguration_Frontend, tokenOverrides: Record<string, DesignTokenConfiguration>): AppConfiguration_Frontend;
+/**
+ * Override typography configuration within an app config.
+ * Shallow-merges at the typography level (replaces individual font roles).
+ */
+export declare function withTypography(config: AppConfiguration_Frontend, typographyOverrides: Partial<TypographyConfiguration>): AppConfiguration_Frontend;
+/**
+ * Override navigation layout within an app config.
+ * Shallow-merges at the layout level.
+ */
+export declare function withNavigationLayout(config: AppConfiguration_Frontend, layoutOverrides: Partial<NavigationLayout>): AppConfiguration_Frontend;
+//# sourceMappingURL=preset-utils.d.ts.map

package/dist/esm/config/preset-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-utils.d.ts","sourceRoot":"","sources":["../../../src/config/preset-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAA6B,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AACxI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,yBAAyB,EACjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,yBAAyB,CAW3B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,yBAAyB,EACjC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5C,yBAAyB,CAW3B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,yBAAyB,EACjC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,yBAAyB,CAW3B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,yBAAyB,EACjC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,yBAAyB,CAW3B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GACvD,yBAAyB,CAW3B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,yBAAyB,EACjC,mBAAmB,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACpD,yBAAyB,CAe3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,yBAAyB,EACjC,eAAe,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACzC,yBAAyB,CAQ3B"}

package/dist/esm/config/preset-utils.js

@@ -0,0 +1,127 @@
+/**
+ * Preset Composition Utilities
+ *
+ * Deep-merge helpers that apply partial overrides to a single concern
+ * within an `AppConfiguration_Frontend`. These stay as functions because
+ * they compute a merge.
+ *
+ * Usage:
+ * ```
+ * const config = withSidebar(APP_STANDARD, { collapsible: false });
+ * ```
+ */
+import { ApplicationLevelComponentType } from '@wildo-ai/saas-frontend-lib';
+/**
+ * Override sidebar configuration within an app config.
+ * Only merges if the existing sidebar value is an object (not `false`).
+ */
+export function withSidebar(config, sidebarOverrides) {
+    const current = config.appComponentsConfiguration?.[ApplicationLevelComponentType.SIDEBAR];
+    if (!current || typeof current !== 'object')
+        return config;
+    return {
+        ...config,
+        appComponentsConfiguration: {
+            ...config.appComponentsConfiguration,
+            [ApplicationLevelComponentType.SIDEBAR]: { ...current, ...sidebarOverrides },
+        },
+    };
+}
+/**
+ * Override command menu configuration within an app config.
+ * Only merges if the existing command menu value is an object.
+ */
+export function withCommandMenu(config, commandMenuOverrides) {
+    const current = config.appComponentsConfiguration?.[ApplicationLevelComponentType.COMMAND_MENU];
+    if (!current || typeof current !== 'object')
+        return config;
+    return {
+        ...config,
+        appComponentsConfiguration: {
+            ...config.appComponentsConfiguration,
+            [ApplicationLevelComponentType.COMMAND_MENU]: { ...current, ...commandMenuOverrides },
+        },
+    };
+}
+/**
+ * Override user dropdown configuration within an app config.
+ * Only merges if the existing user dropdown value is an object.
+ */
+export function withUserDropdown(config, dropdownOverrides) {
+    const current = config.appComponentsConfiguration?.[ApplicationLevelComponentType.USER_DROPDOWN];
+    if (!current || typeof current !== 'object')
+        return config;
+    return {
+        ...config,
+        appComponentsConfiguration: {
+            ...config.appComponentsConfiguration,
+            [ApplicationLevelComponentType.USER_DROPDOWN]: { ...current, ...dropdownOverrides },
+        },
+    };
+}
+/**
+ * Override status bar configuration within an app config.
+ * Only merges if the existing status bar value is an object.
+ */
+export function withStatusBar(config, statusBarOverrides) {
+    const current = config.appComponentsConfiguration?.[ApplicationLevelComponentType.STATUS_BAR];
+    if (!current || typeof current !== 'object')
+        return config;
+    return {
+        ...config,
+        appComponentsConfiguration: {
+            ...config.appComponentsConfiguration,
+            [ApplicationLevelComponentType.STATUS_BAR]: { ...current, ...statusBarOverrides },
+        },
+    };
+}
+/**
+ * Override design tokens within an app config.
+ * Merges token overrides into the existing token map.
+ */
+export function withDesignTokens(config, tokenOverrides) {
+    return {
+        ...config,
+        designSystemConfiguration: {
+            ...config.designSystemConfiguration,
+            tokens: {
+                ...config.designSystemConfiguration?.tokens,
+                ...tokenOverrides,
+            },
+        },
+    };
+}
+/**
+ * Override typography configuration within an app config.
+ * Shallow-merges at the typography level (replaces individual font roles).
+ */
+export function withTypography(config, typographyOverrides) {
+    return {
+        ...config,
+        designSystemConfiguration: {
+            ...config.designSystemConfiguration,
+            typography: {
+                ...config.designSystemConfiguration?.typography,
+                ...typographyOverrides,
+                fonts: {
+                    ...config.designSystemConfiguration?.typography?.fonts,
+                    ...typographyOverrides.fonts,
+                },
+            },
+        },
+    };
+}
+/**
+ * Override navigation layout within an app config.
+ * Shallow-merges at the layout level.
+ */
+export function withNavigationLayout(config, layoutOverrides) {
+    return {
+        ...config,
+        navigationLayout: {
+            ...config.navigationLayout,
+            ...layoutOverrides,
+        },
+    };
+}
+//# sourceMappingURL=preset-utils.js.map

package/dist/esm/config/preset-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-utils.js","sourceRoot":"","sources":["../../../src/config/preset-utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/config/presets.d.ts

@@ -0,0 +1,111 @@
+/**
+ * App Presets — `APP_*`
+ *
+ * Complete `AppConfiguration_Frontend` constants. Ready-to-use entry points.
+ *
+ * Usage:
+ * ```
+ * <ApplicationMainProvider options={{ baseFrontendConfig: APP_STANDARD }} />
+ * ```
+ */
+import type { AppConfiguration_Frontend } from '@wildo-ai/saas-frontend-lib';
+/**
+ * Standard SaaS application — stack layout, sidebar, ocean design.
+ *
+ * Best for: task managers, project tools, CRMs, SaaS dashboards, collaboration apps.
+ */
+export declare const APP_STANDARD: AppConfiguration_Frontend;
+/**
+ * List-detail pattern — split panel, dense shell, nav rail.
+ *
+ * Best for: admin panels, email clients, data-heavy management tools.
+ */
+export declare const APP_LIST_DETAIL: AppConfiguration_Frontend;
+/**
+ * Dashboard-first — stack layout, minimal shell, home is a blank slate.
+ *
+ * Best for: analytics dashboards, monitoring tools, reporting apps.
+ */
+export declare const APP_DASHBOARD: AppConfiguration_Frontend;
+/**
+ * CRM archetype — split layout, dense shell, corporate design, bulk ops.
+ *
+ * Best for: sales CRMs, contact management, deal pipelines.
+ */
+export declare const APP_CRM: AppConfiguration_Frontend;
+/**
+ * Mobile-first — paged layout, mobile shell, warm design.
+ *
+ * Best for: PWAs, consumer mobile apps, field tools.
+ */
+export declare const APP_MOBILE: AppConfiguration_Frontend;
+/**
+ * Project management — cockpit shell with workspace switcher, team awareness,
+ * project groups, and collaboration-ready sidebar.
+ *
+ * Best for: Asana, Linear, Notion-like project tools.
+ */
+export declare const APP_PROJECT: AppConfiguration_Frontend;
+/**
+ * Wizard flow — step-by-step forms, minimal shell with progress toolbar.
+ *
+ * Best for: forms, surveys, insurance, onboarding.
+ */
+export declare const APP_WIZARD: AppConfiguration_Frontend;
+/**
+ * Email client — triple layout, dense shell.
+ *
+ * Best for: Gmail-like, Outlook-like.
+ */
+export declare const APP_EMAIL: AppConfiguration_Frontend;
+/**
+ * AI copilot — companion layout with persistent AI panel, assistant sidebar
+ * entry point, neon design.
+ *
+ * Best for: AI chat, co-pilot, ChatGPT-like.
+ */
+export declare const APP_AI_COPILOT: AppConfiguration_Frontend;
+/**
+ * Helpdesk — split layout, sidebar with team section, warm design.
+ *
+ * Best for: Zendesk-like, Intercom-like, customer support tools.
+ */
+export declare const APP_HELPDESK: AppConfiguration_Frontend;
+/**
+ * Developer tool — tabbed layout, cockpit shell with control panel +
+ * memory display, hacker design.
+ *
+ * Best for: API platforms, internal tools, developer portals.
+ */
+export declare const APP_DEV_TOOL: AppConfiguration_Frontend;
+/**
+ * CMS — tabbed multi-document, centered shell, editorial design.
+ *
+ * Best for: blog platforms, documentation sites, content management.
+ */
+export declare const APP_CMS: AppConfiguration_Frontend;
+/**
+ * Analytics — stack layout, rail shell, corporate design, control panel.
+ *
+ * Best for: BI dashboards, Mixpanel-like, monitoring and reporting.
+ */
+export declare const APP_ANALYTICS: AppConfiguration_Frontend;
+/**
+ * Marketplace — stack layout, sidebar with omnibox search, warm design.
+ *
+ * Best for: directories, catalogs, Airbnb-like.
+ */
+export declare const APP_MARKETPLACE: AppConfiguration_Frontend;
+/**
+ * Kiosk — paged layout, no chrome. Content only.
+ *
+ * Best for: POS, public displays, embedded widgets.
+ */
+export declare const APP_KIOSK: AppConfiguration_Frontend;
+/**
+ * ERP — triple layout, studio shell with inspector panel, corporate design.
+ *
+ * Best for: SAP-like, NetSuite-like, enterprise resource planning.
+ */
+export declare const APP_ERP: AppConfiguration_Frontend;
+//# sourceMappingURL=presets.d.ts.map

package/dist/esm/config/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/config/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAoD7E;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,yBAW1B,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,yBAmB7B,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,yBAW3B,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,yBAKrB,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,yBAKxB,CAAC;AAGF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,yBAoCzB,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,yBAKxB,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,yBAWvB,CAAC;AAGF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,yBAI5B,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,yBAK1B,CAAC;AAGF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,yBAmB1B,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,yBAIrB,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,yBAI3B,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,yBAI7B,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,yBAIvB,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,yBAmBrB,CAAC"}