@brandsync/wc 1.15.0 → 1.17.0

package/dist/types/components/bs-tree/bs-tree.d.ts

@@ -0,0 +1,53 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * A hierarchical list of `bs-tree-item` rows with single selection, expand/collapse and the
+ * WAI-ARIA tree keyboard pattern.
+ *
+ * The tree owns `role="tree"`, the roving `tabindex` (exactly one enabled, visible item is
+ * tabbable: the selected one, otherwise the first), selection (kept in sync with each item's
+ * `selected`) and keyboard navigation over the visible (rendered, non-disabled) items. Items own
+ * their expansion state and emit `bsSelect` / `bsToggle`.
+ *
+ * Built from: `bs-tree-item` rows.
+ *
+ * @slot - Default slot: top-level `bs-tree-item` elements (nested ones go inside their parent item).
+ * @part container - The `role="tree"` wrapper.
+ */
+export declare class BsTree {
+    el: HTMLElement;
+    /** Accessible name of the tree. Bound onto the internal `role="tree"` element (an `aria-label`
+     * on the host would not reach it). */
+    ariaLabel: string | null;
+    /** The `value` (or, when empty, the `label`) of the selected item. Two-way synced with each
+     * item's `selected` (single selection). Setting it from code does not emit `bsChange`. */
+    value: string;
+    /** When `false`, rows do not select (clicks and Enter/Space do nothing) but parents still
+     * expand and collapse. */
+    selectable: boolean;
+    /** Emitted when the user changes the selection (click, Enter/Space), with the new value. Not
+     * emitted when `value` is set from code. */
+    bsChange: EventEmitter<string>;
+    private observer?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    componentDidLoad(): void;
+    onValueChange(): void;
+    /** Expands every parent item. */
+    expandAll(): Promise<void>;
+    /** Collapses every parent item. */
+    collapseAll(): Promise<void>;
+    private items;
+    private keyOf;
+    private isParent;
+    private isRendered;
+    private navigable;
+    private syncSelection;
+    /** Roving tabindex: one tabbable item (selected if navigable, else the first). */
+    private refresh;
+    private focusItem;
+    private select;
+    onItemSelect(e: CustomEvent<string>): void;
+    onFocusIn(e: FocusEvent): void;
+    onKeyDown(e: KeyboardEvent): void;
+    render(): any;
+}

package/dist/types/components/bs-tree/bs-tree.stories.d.ts

@@ -0,0 +1,11 @@
+import type { Meta, StoryObj } from '@storybook/web-components-vite';
+interface BsTreeArgs {
+    value: string;
+    selectable: boolean;
+}
+declare const meta: Meta<BsTreeArgs>;
+export default meta;
+type Story = StoryObj<BsTreeArgs>;
+export declare const Default: Story;
+export declare const ControlledValue: Story;
+export declare const NonSelectable: Story;

package/dist/types/components/bs-tree-item/bs-tree-item.cmp.test.d.ts

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

package/dist/types/components/bs-tree-item/bs-tree-item.d.ts

@@ -0,0 +1,60 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * A single row of a `bs-tree`. An item that contains child `bs-tree-item` elements is a parent
+ * (it gets an expand/collapse caret and a folder icon); an item without children is a leaf (no
+ * caret, file icon).
+ *
+ * The host carries `role="treeitem"` and the `aria-*` state; the owning `bs-tree` manages the
+ * roving `tabindex`, selection and keyboard navigation. Nesting depth is computed automatically
+ * from the number of ancestor `bs-tree-item` elements and exposed as `aria-level` -- it is not a
+ * prop. Clicking the row selects it; clicking the caret (or pressing Right/Left in a tree) toggles
+ * expansion -- the two are deliberately separate.
+ *
+ * Built from: inline SVG icons only (no existing `bs-*` component covers a tree row).
+ *
+ * @slot - Default slot: child `bs-tree-item` elements (the subtree). Only rendered, inside a
+ * `role="group"` wrapper, while the item is expanded; collapsed children are not accessible.
+ * @slot label - Overrides the `label` text.
+ * @slot icon - Overrides the default folder / file icon. Only used when `showIcon` is `true`.
+ * @part container - The highlighted row pill (carries the hover / selected / focus states).
+ * @part caret - The expand/collapse caret (parents only).
+ * @part icon - The icon wrapper.
+ * @part label - The label wrapper.
+ * @part group - The `role="group"` wrapper around the child items (while expanded).
+ */
+export declare class BsTreeItem {
+    el: HTMLElement;
+    /** The row's text. Use the `label` slot for rich content. */
+    label: string;
+    /** Whether the child items are shown. Only meaningful for parents. Mutable: the caret, the
+     * keyboard and the owning tree toggle it. Reflected. */
+    expanded: boolean;
+    /** Marks the row as selected. Owned by the tree (single selection, synced with its `value`).
+     * Reflected. */
+    selected: boolean;
+    /** Disables the row: not focusable, ignores clicks, dimmed. Reflected. */
+    disabled: boolean;
+    /** Shows the leading icon (default folder / file, or the `icon` slot). */
+    showIcon: boolean;
+    /** Identifier used in events and for the tree's `value`. Falls back to `label` when empty. */
+    value: string;
+    /** Emitted when the user toggles expansion (caret click or keyboard), with the new `expanded`
+     * value. Not emitted when `expanded` is set from code. */
+    bsToggle: EventEmitter<boolean>;
+    /** Emitted (bubbling, composed) when the user activates the row, with the item's value. The
+     * owning `bs-tree` listens and updates the selection. */
+    bsSelect: EventEmitter<string>;
+    level: number;
+    hasChildren: boolean;
+    private observer?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private computeLevel;
+    private computeHasChildren;
+    /** Sets `expanded` as a user action: updates the prop and emits `bsToggle`. No-op for leaves,
+     * disabled items, or when the value would not change. */
+    setExpanded(next: boolean): Promise<void>;
+    private onCaretClick;
+    private onRowClick;
+    render(): any;
+}

package/dist/types/components/bs-tree-item/bs-tree-item.stories.d.ts

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from '@storybook/web-components-vite';
+interface BsTreeItemArgs {
+    label: string;
+    expanded: boolean;
+    selected: boolean;
+    disabled: boolean;
+    showIcon: boolean;
+}
+declare const meta: Meta<BsTreeItemArgs>;
+export default meta;
+type Story = StoryObj<BsTreeItemArgs>;
+export declare const Default: Story;
+export declare const Open: Story;
+export declare const Selected: Story;
+export declare const Disabled: Story;
+export declare const WithoutIcon: Story;
+export declare const Child: Story;
+export declare const Levels: Story;
+export declare const CustomIcon: Story;