@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/config/app-level-components.frontend.schemas.js

@@ -0,0 +1,127 @@
+/**
+ * App-Level Component Types & Display Policy Enums
+ *
+ * Canonical home for `ApplicationLevelComponentType`, display policy enums
+ * (SidebarItemDisplayPolicy, CommandMenuDisplayPolicy, etc.), and HotkeyScope.
+ *
+ * Extracted from app-configuration-frontend.schemas.ts to break circular
+ * dependencies — view definition schemas import from here, and
+ * app-configuration-frontend imports those view definitions.
+ *
+ * Consumers import from this module or from `@wildo-ai/saas-frontend-lib`.
+ */
+import { z } from 'zod';
+// ════════════════════════════════════════════════════════════════
+// App-Level Component Types (canonical definition)
+// ════════════════════════════════════════════════════════════════
+export var ApplicationLevelComponentType;
+(function (ApplicationLevelComponentType) {
+    ApplicationLevelComponentType["MENUBAR"] = "menubar";
+    ApplicationLevelComponentType["TOOLBAR"] = "toolbar";
+    ApplicationLevelComponentType["HOTKEY"] = "hotkey";
+    ApplicationLevelComponentType["NOTIFICATION_CENTER"] = "notification_center";
+    ApplicationLevelComponentType["SIDEBAR"] = "sidebar";
+    ApplicationLevelComponentType["COMMAND_MENU"] = "command_menu";
+    ApplicationLevelComponentType["QUICK_ACTION_BUTTON"] = "quick_action_button";
+    ApplicationLevelComponentType["QUICK_SWITCHER"] = "quick_switcher";
+    ApplicationLevelComponentType["CONTROL_PANEL"] = "control_panel";
+    ApplicationLevelComponentType["STATUS_BAR"] = "status_bar";
+    ApplicationLevelComponentType["USER_DROPDOWN"] = "user_dropdown";
+    /**
+     * Intentional alias of USER_DROPDOWN — maps to the same `FrontendComponentType` and
+     * renders the same preset. Exists to allow separate config entries while reusing
+     * the user dropdown component. For distinct UX, register a dedicated preset.
+     */
+    ApplicationLevelComponentType["SETTINGS_DROPDOWN"] = "settings_dropdown";
+    ApplicationLevelComponentType["NAVIGATION_CONTROL"] = "navigation_control";
+    /** Mode selector — renders available `AppMode`s as selectable icons. */
+    ApplicationLevelComponentType["ACTIVITY_BAR"] = "activity_bar";
+    /**
+     * Gmail-style right-side utility panel — references resource operations and
+     * renders views inside a collapsible side panel. Requires navigation zone
+     * containment (in-panel navigation that bypasses main zones).
+     *
+     * **Status:** Base app-level surface now renders custom components inside a
+     * side sheet. FE-5 remains deferred: in-panel navigation still needs its own
+     * dedicated navigation zone instead of reusing main navigation.
+     */
+    ApplicationLevelComponentType["UTILITY_PANEL"] = "utility_panel";
+})(ApplicationLevelComponentType || (ApplicationLevelComponentType = {}));
+// ════════════════════════════════════════════════════════════════
+// Per-Surface Display Policy Enums
+// ════════════════════════════════════════════════════════════════
+/** Sidebar item visibility policy */
+export var SidebarItemDisplayPolicy;
+(function (SidebarItemDisplayPolicy) {
+    SidebarItemDisplayPolicy["ALWAYS"] = "always";
+    SidebarItemDisplayPolicy["WHEN_BADGE"] = "when_badge";
+    SidebarItemDisplayPolicy["SECTION_MORE_MENU"] = "section_more_menu";
+})(SidebarItemDisplayPolicy || (SidebarItemDisplayPolicy = {}));
+/** Command menu command display policy */
+export var CommandMenuDisplayPolicy;
+(function (CommandMenuDisplayPolicy) {
+    CommandMenuDisplayPolicy["ALWAYS"] = "always";
+    CommandMenuDisplayPolicy["NEVER"] = "never";
+    CommandMenuDisplayPolicy["RECENT"] = "recent";
+    CommandMenuDisplayPolicy["CONTEXTUAL"] = "contextual";
+})(CommandMenuDisplayPolicy || (CommandMenuDisplayPolicy = {}));
+/** Quick action button display policy */
+export var QuickActionDisplayPolicy;
+(function (QuickActionDisplayPolicy) {
+    QuickActionDisplayPolicy["PRIMARY"] = "primary";
+    QuickActionDisplayPolicy["MENU"] = "menu";
+})(QuickActionDisplayPolicy || (QuickActionDisplayPolicy = {}));
+/** Hotkey scope — determines where the shortcut is active */
+export var HotkeyScope;
+(function (HotkeyScope) {
+    HotkeyScope["GLOBAL"] = "global";
+    HotkeyScope["PAGE"] = "page";
+    HotkeyScope["COMPONENT"] = "component";
+})(HotkeyScope || (HotkeyScope = {}));
+/** Hotkey grouping for the shortcuts help dialog. */
+export var HotkeyGroup;
+(function (HotkeyGroup) {
+    HotkeyGroup["NAVIGATION"] = "navigation";
+    HotkeyGroup["ACTIONS"] = "actions";
+    HotkeyGroup["HELP"] = "help";
+})(HotkeyGroup || (HotkeyGroup = {}));
+/** Status bar item discriminator for rendering branching. */
+export var StatusBarItemType;
+(function (StatusBarItemType) {
+    StatusBarItemType["LINK"] = "link";
+    StatusBarItemType["BUTTON"] = "button";
+    StatusBarItemType["TEXT"] = "text";
+})(StatusBarItemType || (StatusBarItemType = {}));
+// ════════════════════════════════════════════════════════════════
+// Badge Display
+// ════════════════════════════════════════════════════════════════
+/** Maximum numeric count shown on badges before truncation. */
+export const BADGE_DISPLAY_CAP = 99;
+/** Formats a badge count for display — truncates above `BADGE_DISPLAY_CAP`. */
+export function formatBadgeCount(count) {
+    return count > BADGE_DISPLAY_CAP ? `${BADGE_DISPLAY_CAP}+` : String(count);
+}
+/**
+ * Hotkey rows that only dispatch a `FrontendEvents` payload (no navigation target).
+ * String values MUST stay aligned with `FrontendEvents` in `events.frontend.schemas.ts`.
+ *
+ * Command palette open is NOT listed here: when the command menu surface is enabled,
+ * register `[COMMAND_MENU].openShortcut` from `useCommandMenuBehavior` instead.
+ */
+export var HotkeyDispatchableEvent;
+(function (HotkeyDispatchableEvent) {
+    HotkeyDispatchableEvent["HOTKEY_SIDEBAR_TOGGLE"] = "hotkey_sidebar_toggle";
+    HotkeyDispatchableEvent["HOTKEY_NOTIFICATIONS_OPEN"] = "hotkey_notifications_open";
+    HotkeyDispatchableEvent["HOTKEY_QUICK_SWITCHER_OPEN"] = "hotkey_quick_switcher_open";
+    HotkeyDispatchableEvent["HOTKEY_SHORTCUTS_HELP"] = "hotkey_shortcuts_help";
+})(HotkeyDispatchableEvent || (HotkeyDispatchableEvent = {}));
+export const HotkeyEmitShortcutSchema = z.object({
+    event: z.enum(HotkeyDispatchableEvent),
+    shortcut: z.string(),
+    enabled: z.boolean().optional(),
+    descriptionLabellingRef: z.string().optional(),
+    scope: z.enum(HotkeyScope).optional(),
+    group: z.enum(HotkeyGroup).optional(),
+    preventDefault: z.boolean().optional(),
+});
+//# sourceMappingURL=app-level-components.frontend.schemas.js.map

package/dist/esm/core/config/app-level-components.frontend.schemas.js.map

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