@actabldesign/bellhop-core 0.3.0 → 0.3.1

package/dist/locales/bh-command-bar/ja.json

@@ -0,0 +1,13 @@
+{
+  "locale": "ja",
+  "tag": "bh-command-bar",
+  "messages": {
+    "placeholder": "コマンドを入力または検索",
+    "emptyMessage": "結果が見つかりません",
+    "navigateLabel": "移動",
+    "selectLabel": "選択",
+    "closeLabel": "閉じる",
+    "backLabel": "親に戻る",
+    "settingsAriaLabel": "コマンドバー設定"
+  }
+}

package/dist/locales/bh-command-bar/pt.json

@@ -0,0 +1,13 @@
+{
+  "locale": "pt",
+  "tag": "bh-command-bar",
+  "messages": {
+    "placeholder": "Digite um comando ou pesquise",
+    "emptyMessage": "Nenhum resultado encontrado",
+    "navigateLabel": "Navegar",
+    "selectLabel": "Selecionar",
+    "closeLabel": "Fechar",
+    "backLabel": "Voltar ao nível anterior",
+    "settingsAriaLabel": "Configurações da barra de comandos"
+  }
+}

package/dist/locales/bh-command-bar/ru.json

@@ -0,0 +1,13 @@
+{
+  "locale": "ru",
+  "tag": "bh-command-bar",
+  "messages": {
+    "placeholder": "Введите команду или выполните поиск",
+    "emptyMessage": "Ничего не найдено",
+    "navigateLabel": "Навигация",
+    "selectLabel": "Выбрать",
+    "closeLabel": "Закрыть",
+    "backLabel": "Вернуться к родителю",
+    "settingsAriaLabel": "Настройки командной строки"
+  }
+}

package/dist/locales/bh-command-bar/zh.json

@@ -0,0 +1,13 @@
+{
+  "locale": "zh",
+  "tag": "bh-command-bar",
+  "messages": {
+    "placeholder": "输入命令或搜索",
+    "emptyMessage": "未找到结果",
+    "navigateLabel": "导航",
+    "selectLabel": "选择",
+    "closeLabel": "关闭",
+    "backLabel": "返回上级",
+    "settingsAriaLabel": "命令栏设置"
+  }
+}

package/dist/types/components/bh-activity-feed/bh-activity-feed.d.ts

@@ -17,6 +17,12 @@ export declare class BhActivityFeed {
     headerIcon: string;
     /** Maximum height for the scrollable feed area (CSS value, e.g. "400px") */
     maxHeight: string;
+    /**
+     * Edge-to-edge list: removes the list padding and inter-item margins so
+     * item backgrounds and dividers span the full container width — for
+     * panel-style surfaces like notification centers.
+     */
+    flush: boolean;
     /** Accessible label for the close button. Allows i18n. */
     closeAriaLabel: string;
     /** Emitted when the close button is clicked */

package/dist/types/components/bh-appbar/bh-appbar.d.ts

@@ -1,5 +1,6 @@
 import { type EventEmitter } from "../../stencil-public-runtime";
 import type { BreadcrumbItem } from "../bh-breadcrumbs/bh-breadcrumbs";
+import type { BhNotification } from "./bh-notification-center/bh-notification-center";
 export declare class BhAppbar {
     private logger;
     private i18nUnsubscribe?;
@@ -37,6 +38,42 @@ export declare class BhAppbar {
      * Show the home icon in the breadcrumb trail
      */
     showBreadcrumbHome: boolean;
+    /**
+     * Show the built-in calendar action button
+     */
+    showCalendar: boolean;
+    /**
+     * Show the built-in settings action button
+     */
+    showSettings: boolean;
+    /**
+     * Show the built-in notifications action button
+     */
+    showNotifications: boolean;
+    /**
+     * Unread-notification indicator style: badge dot or count badge
+     */
+    notificationBadge: "dot" | "count";
+    /**
+     * Notification data (array or JSON string). When provided, the built-in
+     * bell becomes a full bh-notification-center (popover panel, read state,
+     * mark-read) and `notificationCount` is ignored. Without it, the plain
+     * bell renders and clicking it emits bhAction only.
+     */
+    notifications?: BhNotification[] | string;
+    /**
+     * Accessible label for the notifications button. Allows i18n.
+     */
+    notificationsAriaLabel: string;
+    /**
+     * Screen-reader announcement template when notifications exist.
+     * `{{count}}` is replaced with the notification count. Allows i18n.
+     */
+    notificationsAnnouncement: string;
+    /**
+     * Screen-reader announcement when there are no notifications. Allows i18n.
+     */
+    noNotificationsAnnouncement: string;
     /**
      * Event emitted when menu toggle is clicked
      */
@@ -61,5 +98,6 @@ export declare class BhAppbar {
     private handleNotificationClick;
     private handleCalendarClick;
     private handleSettingsClick;
+    private notificationAnnouncement;
     render(): any;
 }

package/dist/types/components/bh-appbar/bh-notification-center/bh-notification-center.d.ts

@@ -0,0 +1,108 @@
+import { type EventEmitter } from "../../../stencil-public-runtime";
+export type BhNotification = {
+    id: string;
+    title: string;
+    body?: string;
+    /** Pre-formatted display string; the component does no date math. */
+    timestamp?: string;
+    read?: boolean;
+    /** Material Symbols icon for system notifications (no author) */
+    icon?: string;
+    /**
+     * Sender name. When set the item renders as a user message (avatar
+     * from initials); when absent it renders as a system message (icon).
+     */
+    author?: string;
+};
+export declare class BhNotificationCenter {
+    private logger;
+    private dismissalManager?;
+    private i18nUnsubscribe?;
+    private _i18nVersion;
+    el: HTMLElement;
+    /**
+     * Notifications to display (array or JSON string). Read/unread state is
+     * held internally after load; re-assigning the prop re-syncs it.
+     */
+    notifications: BhNotification[] | string;
+    /**
+     * Whether the panel is open. Reflects so consumers can read/drive it.
+     * Ignored in inline display, where the panel always renders in place.
+     */
+    open: boolean;
+    /**
+     * Presentation: "popover" renders the bell trigger with a floating,
+     * dismissable panel; "inline" renders the panel in place (no bell,
+     * no dismissal) for pages and side panels.
+     */
+    display: "popover" | "inline";
+    /**
+     * Panel header title. Allows i18n.
+     */
+    headerTitle: string;
+    /**
+     * Mark-all-read button label. Allows i18n.
+     */
+    markAllLabel: string;
+    /**
+     * Empty-state message. Allows i18n.
+     */
+    emptyMessage: string;
+    /**
+     * "All" filter tab label. Allows i18n.
+     */
+    filterAllLabel: string;
+    /**
+     * "Unread" filter tab label. Allows i18n.
+     */
+    filterUnreadLabel: string;
+    /**
+     * Accessible label for the bell trigger. Allows i18n.
+     */
+    bellAriaLabel: string;
+    private items;
+    private filter;
+    /**
+     * Emitted when the panel opens.
+     */
+    bhOpen: EventEmitter<void>;
+    /**
+     * Emitted when the panel closes.
+     */
+    bhClose: EventEmitter<void>;
+    /**
+     * Emitted when read state changes. Detail carries the ids marked read in
+     * this change and the remaining unread count.
+     */
+    bhChange: EventEmitter<{
+        readIds: string[];
+        unreadCount: number;
+    }>;
+    /**
+     * Emitted when a notification is clicked.
+     */
+    bhItemClick: EventEmitter<BhNotification>;
+    syncFromProp(): void;
+    handleOpenChange(isOpen: boolean): void;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    /**
+     * Mark a single notification as read.
+     */
+    markRead(id: string): Promise<void>;
+    /**
+     * Mark every notification as read.
+     */
+    markAllRead(): Promise<void>;
+    private parseNotifications;
+    private applyRead;
+    private unreadCount;
+    private visibleItems;
+    private setOpen;
+    private handleBellClick;
+    private handleItemClick;
+    private t;
+    private renderTrigger;
+    render(): any;
+}

package/dist/types/components/bh-breadcrumbs/bh-breadcrumbs.d.ts

@@ -13,6 +13,12 @@ export type BreadcrumbItem = {
     dropdown?: BreadcrumbDropdownOption[];
     /** Render a search input inside the dropdown menu */
     dropdownSearchable?: boolean;
+    /**
+     * Render slotted content at this trail position instead of a label —
+     * e.g. a bh-property-switcher as one of the segments. The consumer
+     * provides matching light-DOM content: `<x slot="{slotName}">`.
+     */
+    slotName?: string;
 };
 export declare class BhBreadcrumbs {
     el: HTMLElement;
@@ -60,6 +66,7 @@ export declare class BhBreadcrumbs {
         option: BreadcrumbDropdownOption;
     }>;
     private openDropdownIndex;
+    private hasStartContent;
     private dropdownQuery;
     /** Last-selected option id per item index, so selection sticks without a re-render from the consumer */
     private dropdownSelections;
@@ -69,6 +76,7 @@ export declare class BhBreadcrumbs {
     private get parsedItems();
     private get displayData();
     private handleItemClick;
+    private handleStartSlotChange;
     private handleHomeClick;
     private handleEllipsisClick;
     private handleEllipsisKeyDown;

package/dist/types/components/bh-command-bar/bh-command-bar.d.ts

@@ -0,0 +1,131 @@
+import { type EventEmitter } from "../../stencil-public-runtime";
+export type BhCommandItem = {
+    id: string;
+    label: string;
+    /** Second, stacked text line */
+    description?: string;
+    /** Trailing breadcrumb text, rendered as "/ {path}" */
+    path?: string;
+    /** Material Symbols icon (icon-leading flavor) */
+    icon?: string;
+    /** Sender/person name (avatar-leading flavor) */
+    author?: string;
+    avatarSrc?: string;
+    /** Trailing shortcut chip, bh-kbd keys syntax (e.g. "cmd+p") */
+    shortcut?: string;
+    /** Child level — selecting the item drills in instead of emitting */
+    children?: BhCommandItem[];
+};
+export type BhCommandSection = {
+    id: string;
+    heading?: string;
+    items: BhCommandItem[];
+};
+export declare class BhCommandBar {
+    private logger;
+    private dismissalManager?;
+    private i18nUnsubscribe?;
+    private inputRef?;
+    private pendingFocus;
+    private _i18nVersion;
+    el: HTMLElement;
+    /**
+     * Command sections (array or JSON string).
+     */
+    sections: BhCommandSection[] | string;
+    /**
+     * Whether the palette is open. Reflects so consumers can read/drive it.
+     */
+    open: boolean;
+    /**
+     * Global shortcut that toggles the palette (e.g. "cmd+k"). When set, a
+     * document-level listener is registered; "cmd" matches ⌘ on macOS and
+     * Ctrl elsewhere. Omit to control the palette programmatically only.
+     */
+    hotkey?: string;
+    /**
+     * Search input placeholder. Allows i18n.
+     */
+    placeholder: string;
+    /**
+     * Empty-state message. Allows i18n.
+     */
+    emptyMessage: string;
+    /**
+     * List density
+     */
+    size: "sm" | "md";
+    /**
+     * Footer hint labels. Allow i18n.
+     */
+    navigateLabel: string;
+    selectLabel: string;
+    closeLabel: string;
+    backLabel: string;
+    /**
+     * Accessible label for the footer settings button. Allows i18n.
+     */
+    settingsAriaLabel: string;
+    private query;
+    private activeIndex;
+    private levelStack;
+    /**
+     * Emitted when the palette opens.
+     */
+    bhOpen: EventEmitter<void>;
+    /**
+     * Emitted when the palette closes.
+     */
+    bhClose: EventEmitter<void>;
+    /**
+     * Emitted when the search query changes. Detail carries the query.
+     */
+    bhChange: EventEmitter<{
+        query: string;
+    }>;
+    /**
+     * Emitted when a leaf item is selected. Detail carries the item and its
+     * ancestor chain (outermost first).
+     */
+    bhItemClick: EventEmitter<{
+        item: BhCommandItem;
+        parents: BhCommandItem[];
+    }>;
+    /**
+     * Emitted for auxiliary actions (footer settings gear).
+     */
+    bhAction: EventEmitter<{
+        action: "settings";
+    }>;
+    handleOpenChange(isOpen: boolean): void;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    componentDidRender(): void;
+    disconnectedCallback(): void;
+    /**
+     * Open the palette.
+     */
+    show(): Promise<void>;
+    /**
+     * Close the palette.
+     */
+    hide(): Promise<void>;
+    private parseSections;
+    /** Sections for the current drill-down level */
+    private currentSections;
+    private matchesQuery;
+    private visibleSections;
+    private flatItems;
+    private setOpen;
+    private resetNavigation;
+    private focusPendingInput;
+    private selectItem;
+    private popLevel;
+    private handleGlobalKeyDown;
+    private handleInput;
+    private handleInputKeyDown;
+    private t;
+    private renderLeading;
+    private renderItem;
+    render(): any;
+}

package/dist/types/components/bh-command-bar/bh-command-bar.figma.d.ts

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

package/dist/types/components/bh-dropdown/bh-dropdown.d.ts

@@ -54,6 +54,10 @@ export declare class BhDropdown {
      * Avatar alt text
      */
     avatarAlt: string;
+    /**
+     * Initials shown when no avatar image is set (avatar variant)
+     */
+    avatarInitials: string;
     /**
      * Avatar size for avatar variant
      */

package/dist/types/components/bh-feed-item/bh-feed-item.d.ts

@@ -24,6 +24,21 @@ export declare class BhFeedItem {
     showSubtext: boolean;
     /** Type of supporting content below the main text */
     supportingContent: FeedItemSupportingContent;
+    /**
+     * Item flavor: "user" renders the avatar/author column; "system" is a
+     * sender-less message (notifications, audit events) with an optional
+     * icon column instead.
+     */
+    variant: "user" | "system";
+    /** Material Symbols icon shown in place of the avatar (system variant) */
+    icon?: string;
+    /**
+     * Bold heading text rendered where the author name sits. When set it
+     * wins over `author` (which still drives the avatar) — e.g. a user
+     * notification titled "New comment" sent by Chris. Required for
+     * system items, which have no author.
+     */
+    itemTitle?: string;
     /** Emitted when the feed item is clicked */
     bhClick: EventEmitter<void>;
     componentDidCatch(error: unknown): void;

package/dist/types/components/bh-kbd/bh-kbd.d.ts

@@ -0,0 +1,13 @@
+export declare class BhKbd {
+    /**
+     * Key combination, "+"-separated (e.g. "cmd+k", "ctrl+shift+p").
+     * When omitted, slotted content renders inside a single key cap.
+     */
+    keys?: string;
+    /**
+     * Key cap size
+     */
+    size: "sm" | "md";
+    private parseKeys;
+    render(): any;
+}

package/dist/types/components/bh-kbd/bh-kbd.figma.d.ts

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

package/dist/types/components/bh-property-switcher/bh-property-switcher.d.ts

@@ -69,6 +69,8 @@ export declare class BhPropertySwitcher {
     private getParsedProperties;
     componentWillLoad(): void;
     private dismissalManager?;
+    handlePropertiesChange(): void;
+    handleSelectedPropertyChange(value: string): void;
     handleExpandedChange(newValue: boolean): void;
     componentDidLoad(): void;
     handleKeyDown(event: KeyboardEvent): void;

package/dist/types/components/bh-sidebar/bh-sidebar.d.ts

@@ -1,6 +1,6 @@
 import { type EventEmitter } from "../../stencil-public-runtime";
 import type { LogoType } from "../bh-logo-box/bh-logo-box";
-import type { MenuItemData } from "../bh-menu/bh-menu";
+import type { MenuHeader, MenuItemData } from "../bh-menu/bh-menu";
 import type { BhProduct } from "../bh-product-switcher/bh-product-switcher";
 import type { FooterItem, MenuItem, SidebarStyle } from "./bh-sidebar.types";
 export declare class BhSidebar {
@@ -90,6 +90,19 @@ export declare class BhSidebar {
      * Avatar menu items override
      */
     avatarMenuItems?: MenuItemData[];
+    /**
+     * Avatar image alt text
+     */
+    avatarAlt: string;
+    /**
+     * Keyboard shortcut hint shown next to search (e.g. "cmd+k").
+     * Display only — the consumer binds the actual hotkey.
+     */
+    searchHotkey?: string;
+    /**
+     * Header shown at the top of the avatar dropdown menu
+     */
+    avatarMenuHeader?: MenuHeader;
     /**
      * Event emitted when a menu item is clicked
      */

package/dist/types/components/index.d.ts

@@ -17,6 +17,7 @@ export * from "./bh-accordion/bh-accordion-item/bh-accordion-item";
 export * from "./bh-activity-feed/bh-activity-feed";
 export * from "./bh-alert/bh-alert";
 export * from "./bh-appbar/bh-appbar";
+export * from "./bh-appbar/bh-notification-center/bh-notification-center";
 export * from "./bh-avatar/bh-avatar";
 export * from "./bh-avatar/bh-avatar-add/bh-avatar-add";
 export * from "./bh-avatar/bh-avatar-stacked/bh-avatar-stacked";
@@ -40,6 +41,7 @@ export * from "./bh-chart/bh-trend-chart/bh-trend-chart";
 export * from "./bh-chat/bh-chat-message/bh-chat-message";
 export * from "./bh-chat/bh-chat-reaction/bh-chat-reaction";
 export * from "./bh-checkbox/bh-checkbox";
+export * from "./bh-command-bar/bh-command-bar";
 export * from "./bh-container/bh-container";
 export * from "./bh-container/bh-container-footer/bh-container-footer";
 export * from "./bh-credit-card/bh-credit-card";
@@ -64,6 +66,7 @@ export * from "./bh-input/bh-input-text/bh-input-text";
 export * from "./bh-input/bh-input-verification/bh-input-verification";
 export * from "./bh-input/bh-tag-input/bh-tag-input";
 export * from "./bh-input/bh-textarea/bh-textarea";
+export * from "./bh-kbd/bh-kbd";
 export * from "./bh-label/bh-label";
 export * from "./bh-loader-spinner/bh-loader-spinner";
 export * from "./bh-logo-box/bh-logo-box";