@cccsaurora/howler-ui 2.19.0-dev.1151 → 2.19.0-dev.1260

package/components/routes/cases/detail/sidebar/CaseFolderContextMenu.js

@@ -0,0 +1,99 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Delete, DriveFileRenameOutline, OpenInNew } from '@mui/icons-material';
+import api from '@cccsaurora/howler-ui/api';
+import { ModalContext } from '@cccsaurora/howler-ui/components/app/providers/ModalProvider';
+import ContextMenu, {} from '@cccsaurora/howler-ui/components/elements/ContextMenu';
+import useMyApi from '@cccsaurora/howler-ui/components/hooks/useMyApi';
+import RenameItemModal from '@cccsaurora/howler-ui/components/routes/cases/modals/RenameItemModal';
+import { useContext, useMemo } from 'react';
+import { useTranslation } from 'react-i18next';
+/**
+ * Recursively collects all leaf items from a folder tree.
+ */
+export const collectAllLeaves = (tree) => {
+    const result = [...(tree.leaves ?? [])];
+    for (const subfolder of Object.values(tree.folders ?? {})) {
+        result.push(...collectAllLeaves(subfolder));
+    }
+    return result;
+};
+/**
+ * Returns the URL to open for a given leaf item, or null if no URL applies.
+ * - reference: the item's value (an external URL)
+ * - hit: /hits/<id>
+ * - event: /events/<id>
+ * - case: /cases/<id>
+ * - table / lead: null (no dedicated detail page)
+ */
+export const getOpenUrl = (leaf) => {
+    const type = leaf.type?.toLowerCase();
+    if (type === 'reference') {
+        return leaf.value ?? null;
+    }
+    if (type === 'hit') {
+        return leaf.value ? `/hits/${leaf.value}` : null;
+    }
+    if (type === 'event') {
+        return leaf.value ? `/events/${leaf.value}` : null;
+    }
+    if (type === 'case') {
+        return leaf.value ? `/cases/${leaf.value}` : null;
+    }
+    if (type === 'markdown') {
+        return null;
+    }
+    return null;
+};
+/**
+ * Wraps its children with a right-click context menu providing:
+ * - **Open item** – opens the item in a new tab (only for leaf items with a navigable URL).
+ * - **Remove item / Remove folder** – deletes the leaf item or all items under a folder.
+ */
+const CaseFolderContextMenu = ({ case: _case, item, onUpdate, children }) => {
+    const { dispatchApi } = useMyApi();
+    const { t } = useTranslation();
+    const { showModal } = useContext(ModalContext);
+    const items = useMemo(() => {
+        const entries = [];
+        const openUrl = getOpenUrl(item);
+        if (openUrl) {
+            entries.push({
+                kind: 'item',
+                id: 'open-item',
+                label: t('page.cases.sidebar.item.open'),
+                icon: _jsx(OpenInNew, { fontSize: "small" }),
+                onClick: () => window.open(openUrl, '_blank', 'noopener noreferrer')
+            });
+        }
+        if (entries.length > 0) {
+            entries.push({ kind: 'divider', id: 'divider-remove' });
+        }
+        const isFolder = item.type === 'folder';
+        entries.push({
+            kind: 'item',
+            id: 'rename-item',
+            label: isFolder ? t('page.cases.sidebar.folder.rename') : t('page.cases.sidebar.item.rename'),
+            icon: _jsx(DriveFileRenameOutline, { fontSize: "small" }),
+            onClick: () => showModal(_jsx(RenameItemModal, { _case: _case, item: item, onRenamed: onUpdate }), { height: null })
+        });
+        entries.push({
+            kind: 'item',
+            id: 'remove-item',
+            label: isFolder ? t('page.cases.sidebar.folder.remove') : t('page.cases.sidebar.item.remove'),
+            icon: _jsx(Delete, { fontSize: "small" }),
+            onClick: () => {
+                if (!_case.case_id) {
+                    return;
+                }
+                dispatchApi(api.v2.case.items.del(_case.case_id, [item.id], isFolder), { throwError: false }).then(updatedCase => {
+                    if (updatedCase) {
+                        onUpdate?.(updatedCase);
+                    }
+                });
+            }
+        });
+        return entries;
+    }, [_case, item, dispatchApi, onUpdate, showModal, t]);
+    return _jsx(ContextMenu, { items: items, children: children });
+};
+export default CaseFolderContextMenu;

package/components/routes/cases/detail/sidebar/CaseFolderContextMenu.test.d.ts

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

package/components/routes/cases/detail/sidebar/CaseFolderContextMenu.test.js

@@ -0,0 +1,117 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { act } from 'react';
+import { createMockCase } from '@cccsaurora/howler-ui/tests/utils';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('components/elements/ContextMenu', () => ({
+    default: ({ items, children }) => (_jsxs("div", { children: [children, items.map((item) => {
+                if (item.kind === 'item') {
+                    return (_jsx("button", { id: item.id, onClick: item.onClick, children: item.label }, item.id));
+                }
+                if (item.kind === 'divider') {
+                    return _jsx("hr", {}, item.id);
+                }
+                return null;
+            })] }))
+}));
+const mockDispatchApi = vi.hoisted(() => vi.fn());
+vi.mock('components/hooks/useMyApi', () => ({
+    default: () => ({ dispatchApi: mockDispatchApi })
+}));
+const mockDel = vi.hoisted(() => vi.fn());
+vi.mock('api', () => ({
+    default: {
+        v2: {
+            case: {
+                items: {
+                    del: (...args) => mockDel(...args)
+                }
+            }
+        }
+    }
+}));
+const mockShowModal = vi.hoisted(() => vi.fn());
+vi.mock('components/app/providers/ModalProvider', async () => {
+    const { createContext } = await import('react');
+    return {
+        ModalContext: createContext({ showModal: mockShowModal, close: vi.fn(), setContent: vi.fn() })
+    };
+});
+vi.mock('components/routes/cases/modals/RenameItemModal', () => ({
+    default: () => _jsx("div", { id: "rename-item-modal" })
+}));
+import CaseFolderContextMenu, { getOpenUrl } from './CaseFolderContextMenu';
+const mockCase = createMockCase({ case_id: 'case-1' });
+const hitLeaf = { id: 'id-hit', type: 'hit', value: 'hit-123', name: 'hit-item' };
+const folderItem = { id: 'folder-id', type: 'folder', value: 'Folder', name: 'Folder' };
+const renderMenu = (props) => render(_jsx(CaseFolderContextMenu, { case: mockCase, item: hitLeaf, ...props, children: _jsx("div", { id: "child", children: "child" }) }));
+beforeEach(() => {
+    mockDel.mockClear();
+    mockDispatchApi.mockClear();
+    mockShowModal.mockClear();
+    mockDispatchApi.mockImplementation((p) => p);
+    mockDel.mockResolvedValue(mockCase);
+    vi.spyOn(window, 'open').mockReturnValue(null);
+});
+describe('getOpenUrl', () => {
+    it('resolves known leaf links and returns null for folders', () => {
+        expect(getOpenUrl({ type: 'reference', value: 'https://example.com' })).toBe('https://example.com');
+        expect(getOpenUrl({ type: 'hit', value: 'h1' })).toBe('/hits/h1');
+        expect(getOpenUrl({ type: 'event', value: 'e1' })).toBe('/events/e1');
+        expect(getOpenUrl({ type: 'case', value: 'c1' })).toBe('/cases/c1');
+        expect(getOpenUrl({ type: 'folder', value: 'Folder' })).toBeNull();
+    });
+});
+describe('CaseFolderContextMenu', () => {
+    it('shows open, rename, and remove for leaf items with open URL', () => {
+        renderMenu({ item: hitLeaf });
+        expect(screen.getByText('page.cases.sidebar.item.open')).toBeInTheDocument();
+        expect(screen.getByText('page.cases.sidebar.item.rename')).toBeInTheDocument();
+        expect(screen.getByText('page.cases.sidebar.item.remove')).toBeInTheDocument();
+        expect(document.querySelector('hr')).toBeInTheDocument();
+    });
+    it('shows rename/remove folder actions and no open action for folders', () => {
+        renderMenu({ item: folderItem });
+        expect(screen.queryByText('page.cases.sidebar.item.open')).not.toBeInTheDocument();
+        expect(screen.getByText('page.cases.sidebar.folder.rename')).toBeInTheDocument();
+        expect(screen.getByText('page.cases.sidebar.folder.remove')).toBeInTheDocument();
+    });
+    it('opens resolved URL in new tab', () => {
+        renderMenu({ item: hitLeaf });
+        act(() => {
+            fireEvent.click(screen.getByText('page.cases.sidebar.item.open'));
+        });
+        expect(window.open).toHaveBeenCalledWith('/hits/hit-123', '_blank', 'noopener noreferrer');
+    });
+    it('calls showModal for rename action', () => {
+        renderMenu({ item: hitLeaf });
+        act(() => {
+            fireEvent.click(screen.getByText('page.cases.sidebar.item.rename'));
+        });
+        expect(mockShowModal).toHaveBeenCalledTimes(1);
+    });
+    it('calls delete API with force=true for folders', async () => {
+        renderMenu({ item: folderItem });
+        act(() => {
+            fireEvent.click(screen.getByText('page.cases.sidebar.folder.remove'));
+        });
+        await waitFor(() => {
+            expect(mockDel).toHaveBeenCalledWith('case-1', ['folder-id'], true);
+        });
+    });
+    it('passes undefined item id through to delete API when id is missing', () => {
+        renderMenu({ item: { type: 'hit', value: 'h1', name: 'hit' } });
+        act(() => {
+            fireEvent.click(screen.getByText('page.cases.sidebar.item.remove'));
+        });
+        expect(mockDel).toHaveBeenCalledWith('case-1', [undefined], false);
+    });
+    it('passes updated case to onUpdate after delete', async () => {
+        const onUpdate = vi.fn();
+        renderMenu({ item: hitLeaf, onUpdate });
+        act(() => {
+            fireEvent.click(screen.getByText('page.cases.sidebar.item.remove'));
+        });
+        await waitFor(() => expect(onUpdate).toHaveBeenCalledWith(mockCase));
+    });
+});

package/components/routes/cases/detail/sidebar/FolderEntry.d.ts

@@ -0,0 +1,25 @@
+import type { SvgIconProps } from '@mui/material';
+import type { Item } from '@cccsaurora/howler-ui/models/entities/generated/Item';
+import type { FC } from 'react';
+interface FolderEntryProps {
+    /** The corresponding case ID for this entry */
+    caseId?: string | null;
+    /** MUI `pl` value for indentation */
+    indent: number;
+    /** Text displayed as the entry label */
+    label: string;
+    /** MUI icon color token applied to the entry icon (default: 'inherit') */
+    iconColor?: SvgIconProps['color'];
+    /** MUI color token for the label Typography (default: 'text.secondary') */
+    labelColor?: string;
+    /** Whether the chevron is rotated 90° (expanded state) */
+    chevronOpen?: boolean;
+    /** When provided the entry renders as a react-router Link */
+    to?: string;
+    /** Callback fired when the entry is clicked */
+    onClick?: () => void;
+    /** The item entity associated with this entry */
+    entry?: Item;
+}
+declare const FolderEntry: FC<FolderEntryProps>;
+export default FolderEntry;

package/components/routes/cases/detail/sidebar/FolderEntry.js

@@ -0,0 +1,89 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useDraggable, useDroppable } from '@dnd-kit/core';
+import { CSS } from '@dnd-kit/utilities';
+import { BookRounded, CheckCircle, ChevronRight, Description, Folder, Lightbulb, Link as LinkIcon, TableChart, Visibility } from '@mui/icons-material';
+import { alpha, Box, Stack, Typography, useTheme } from '@mui/material';
+import { Link, useLocation } from 'react-router-dom';
+// Static map: item type → MUI icon component (avoids re-creating closures on each render)
+const ICON_FOR_TYPE = {
+    folder: Folder,
+    case: BookRounded,
+    event: Visibility,
+    hit: CheckCircle,
+    table: TableChart,
+    lead: Lightbulb,
+    reference: LinkIcon,
+    markdown: Description
+};
+const FolderEntry = ({ caseId, indent, label, iconColor = 'disabled', labelColor = 'text.secondary', chevronOpen = false, to, onClick, entry }) => {
+    const location = useLocation();
+    const theme = useTheme();
+    const isCase = entry?.type === 'case';
+    const isFolder = entry?.type === 'folder';
+    const entryId = entry?.id;
+    const dndId = `${caseId ?? ''}:${entry?.type}:${entryId}`;
+    const { attributes, listeners, setNodeRef: setDraggableNodeRef, transform, isDragging } = useDraggable({
+        id: dndId,
+        data: {
+            type: entry?.type,
+            label,
+            entry,
+            caseId
+        },
+        disabled: !caseId
+    });
+    const { setNodeRef: setDroppableNodeRef, isOver } = useDroppable({
+        id: dndId,
+        disabled: !isFolder || isDragging || !caseId,
+        data: {
+            caseId,
+            folderId: entry?.id ?? null
+        }
+    });
+    const isLink = to != null && !isDragging;
+    const active = decodeURIComponent(location.pathname) === to;
+    const Icon = ICON_FOR_TYPE[entry?.type] ?? Folder;
+    return (_jsxs(Stack, { ref: el => {
+            setDroppableNodeRef(el);
+            setDraggableNodeRef(el);
+        }, direction: "row", pl: indent, style: { transform: CSS.Transform.toString(transform), opacity: isDragging ? 0 : undefined }, sx: [
+            {
+                cursor: 'pointer',
+                overflow: 'visible',
+                color: `${theme.palette.text.secondary} !important`,
+                textDecoration: 'none',
+                background: 'transparent',
+                position: 'relative',
+                ...(isLink && { borderRight: '3px solid transparent' })
+            },
+            isLink &&
+                active && {
+                background: alpha(theme.palette.grey[600], 0.15),
+                borderRightColor: theme.palette.primary.main
+            }
+        ], onClick: onClick, ...attributes, ...listeners, ...(isLink && {
+            component: Link,
+            to,
+            target: entry?.type === 'reference' ? '_blank' : undefined,
+            rel: entry?.type === 'reference' ? 'noopener noreferrer' : undefined
+        }), children: [_jsx(Box, { sx: [
+                    {
+                        position: 'absolute',
+                        top: 0,
+                        bottom: 0,
+                        left: 0,
+                        right: 0,
+                        border: '2px dashed transparent',
+                        borderRadius: '5px',
+                        transition: theme.transitions.create('border-color')
+                    },
+                    isOver && caseId && { borderColor: theme.palette.primary.main }
+                ] }), _jsx(ChevronRight, { fontSize: "small", color: "disabled", sx: [
+                    !(isCase || isFolder) && { opacity: 0 },
+                    {
+                        transition: theme.transitions.create('transform', { duration: 100 }),
+                        transform: chevronOpen ? 'rotate(90deg)' : 'rotate(0deg)'
+                    }
+                ] }), _jsx(Icon, { fontSize: "small", color: iconColor }), _jsx(Typography, { variant: "caption", color: labelColor, sx: { userSelect: 'none', pl: 0.5, textWrap: 'nowrap' }, children: label })] }));
+};
+export default FolderEntry;

package/components/routes/cases/detail/sidebar/FolderEntry.test.d.ts

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

package/components/routes/cases/detail/sidebar/FolderEntry.test.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { MemoryRouter } from 'react-router-dom';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('react-router-dom', async () => {
+    const actual = await vi.importActual('react-router-dom');
+    return {
+        ...actual,
+        Link: ({ to, children, ...props }) => (_jsx("a", { href: to, ...props, children: children })),
+        useLocation: vi.fn(() => ({ pathname: '/', search: '' }))
+    };
+});
+const mockDraggable = vi.hoisted(() => ({
+    isDragging: false,
+    transform: null
+}));
+vi.mock('@dnd-kit/core', () => ({
+    useDraggable: vi.fn(() => ({
+        attributes: {},
+        listeners: {},
+        setNodeRef: vi.fn(),
+        transform: mockDraggable.transform,
+        isDragging: mockDraggable.isDragging,
+        active: null
+    })),
+    useDroppable: vi.fn(() => ({
+        setNodeRef: vi.fn(),
+        isOver: false
+    }))
+}));
+vi.mock('@dnd-kit/utilities', () => ({
+    CSS: { Transform: { toString: (t) => (t ? `translate3d(${t.x}px,${t.y}px,0)` : '') } }
+}));
+import { useDraggable, useDroppable } from '@dnd-kit/core';
+import FolderEntry from './FolderEntry';
+const hitItem = (value, id = value) => ({ type: 'hit', value, id, name: value });
+const renderEntry = (props = {}) => {
+    const entry = props.entry ?? hitItem('my-hit', 'item-1');
+    return render(_jsx(MemoryRouter, { children: _jsx(FolderEntry, { caseId: "case-1", indent: 1, label: "my label", entry: entry, ...props }) }));
+};
+beforeEach(() => {
+    mockDraggable.isDragging = false;
+    mockDraggable.transform = null;
+    vi.mocked(useDroppable).mockReturnValue({ setNodeRef: vi.fn(), isOver: false });
+});
+describe('FolderEntry', () => {
+    it('opens reference links in a new tab', () => {
+        renderEntry({
+            entry: { id: 'ref-1', type: 'reference', value: 'https://example.com', name: 'ext' },
+            to: 'https://example.com',
+            label: 'ext'
+        });
+        const el = screen.getByText('ext').closest('a');
+        expect(el).toHaveAttribute('target', '_blank');
+        expect(el).toHaveAttribute('rel', 'noopener noreferrer');
+    });
+    it('shows chevron for folder entries', () => {
+        const { container } = renderEntry({ entry: { id: 'f1', type: 'folder', value: 'Folder', name: 'Folder' } });
+        const chevron = container.querySelector('svg');
+        expect(chevron).toBeInTheDocument();
+    });
+    it('enables folder droppable when not dragging and caseId is set', () => {
+        renderEntry({ caseId: 'case-1', entry: { id: 'f1', type: 'folder', value: 'Folder', name: 'Folder' } });
+        expect(vi.mocked(useDroppable)).toHaveBeenCalledWith(expect.objectContaining({ id: 'case-1:folder:f1', disabled: false }));
+    });
+    it('passes namespaced id to useDroppable', () => {
+        renderEntry({ caseId: 'case-1', entry: { id: 'folder-id', type: 'folder', value: 'Folder', name: 'Folder' } });
+        expect(vi.mocked(useDroppable)).toHaveBeenCalledWith(expect.objectContaining({ id: 'case-1:folder:folder-id' }));
+    });
+    it('falls back to undefined id segment when entry has no id', async () => {
+        renderEntry({ caseId: null, label: 'my label', entry: { type: 'hit', value: 'v1', name: 'my label' } });
+        expect(vi.mocked(useDraggable)).toHaveBeenCalledWith(expect.objectContaining({ id: ':hit:undefined' }));
+    });
+    it('calls onClick when clicked', async () => {
+        const onClick = vi.fn();
+        renderEntry({ onClick });
+        await userEvent.click(screen.getByText('my label'));
+        expect(onClick).toHaveBeenCalledTimes(1);
+    });
+});

package/components/routes/cases/detail/sidebar/RootDropZone.d.ts

@@ -0,0 +1,5 @@
+import type { FC } from 'react';
+declare const RootDropZone: FC<{
+    caseId: string;
+}>;
+export default RootDropZone;

package/components/routes/cases/detail/sidebar/RootDropZone.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useDndContext, useDroppable } from '@dnd-kit/core';
+import { Inbox } from '@mui/icons-material';
+import { alpha, Box, Typography } from '@mui/material';
+import { useTranslation } from 'react-i18next';
+const RootDropZone = ({ caseId }) => {
+    const { t } = useTranslation();
+    const { active } = useDndContext();
+    const { setNodeRef, isOver } = useDroppable({
+        id: `${caseId}:folder:__root__`,
+        data: { path: '', caseId, folderId: null }
+    });
+    if (!active) {
+        return null;
+    }
+    return (_jsxs(Box, { ref: setNodeRef, sx: theme => ({
+            minHeight: '250px',
+            display: 'flex',
+            flexDirection: 'column',
+            alignItems: 'center',
+            justifyContent: 'center',
+            gap: 1,
+            border: '2px dashed',
+            borderColor: isOver ? theme.palette.primary.main : theme.palette.divider,
+            borderRadius: 1,
+            mx: 1,
+            mt: 1,
+            transition: theme.transitions.create(['border-color', 'background-color']),
+            bgcolor: isOver ? alpha(theme.palette.primary.main, 0.08) : 'transparent',
+            color: isOver ? theme.palette.primary.main : theme.palette.text.secondary
+        }), children: [_jsx(Inbox, { fontSize: "large", sx: { opacity: 0.6 } }), _jsx(Typography, { variant: "caption", children: t('page.cases.folder.drop.root') })] }));
+};
+export default RootDropZone;

package/components/routes/cases/detail/sidebar/types.d.ts

@@ -0,0 +1,9 @@
+import type { Item } from 'models/entities/generated/Item';
+
+export type Tree = {
+  item: Item;
+  leaves?: Item[];
+  folders?: {
+    [key: string]: Tree;
+  };
+};

package/components/routes/cases/detail/sidebar/utils.d.ts

@@ -0,0 +1,10 @@
+import type { Item } from '@cccsaurora/howler-ui/models/entities/generated/Item';
+import type { Tree } from './types';
+/**
+ * Build a tree from a flat array of items using parent-based relationships.
+ *
+ * Folder items (type=folder) become tree nodes whose children are items
+ * referencing the folder's `id` as their `parent`.
+ * Items with `parent=null` or `parent=undefined` are root-level.
+ */
+export declare const buildTree: (items?: Item[]) => Tree;

package/components/routes/cases/detail/sidebar/utils.js

@@ -0,0 +1,51 @@
+import { sortBy } from 'lodash-es';
+/**
+ * Build a tree from a flat array of items using parent-based relationships.
+ *
+ * Folder items (type=folder) become tree nodes whose children are items
+ * referencing the folder's `id` as their `parent`.
+ * Items with `parent=null` or `parent=undefined` are root-level.
+ */
+export const buildTree = (items = []) => {
+    const root = { item: null, leaves: [], folders: {} };
+    // Index folders by id
+    const folderNodes = {};
+    const folderItems = items.filter(item => item.type === 'folder');
+    for (const folder of folderItems) {
+        if (folder.id) {
+            folderNodes[folder.id] = {
+                leaves: [],
+                folders: {},
+                item: folder
+            };
+        }
+    }
+    // Build folder hierarchy
+    for (const folder of folderItems) {
+        if (!folder.id) {
+            continue;
+        }
+        const node = folderNodes[folder.id];
+        const folderName = folder.name ?? folder.value ?? folder.id;
+        if (!folderName) {
+            continue;
+        }
+        if (folder.parent && folderNodes[folder.parent]) {
+            folderNodes[folder.parent].folders[folderName] = node;
+        }
+        else {
+            root.folders[folderName] = node;
+        }
+    }
+    // Place non-folder items
+    const nonFolderItems = items.filter(item => item.type !== 'folder');
+    for (const item of sortBy(nonFolderItems, 'value')) {
+        if (item.parent && folderNodes[item.parent]) {
+            folderNodes[item.parent].leaves.push(item);
+        }
+        else {
+            root.leaves.push(item);
+        }
+    }
+    return root;
+};

package/components/routes/cases/detail/sidebar/utils.test.d.ts

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

package/components/routes/cases/detail/sidebar/utils.test.js

@@ -0,0 +1,82 @@
+import { describe, expect, it } from 'vitest';
+import { buildTree } from './utils';
+describe('buildTree', () => {
+    it('returns an empty tree for no items', () => {
+        const result = buildTree();
+        expect(result.leaves).toEqual([]);
+        expect(result.folders).toEqual({});
+    });
+    it('returns an empty tree for an empty array', () => {
+        const result = buildTree([]);
+        expect(result.leaves).toEqual([]);
+        expect(result.folders).toEqual({});
+    });
+    it('places items at root when parent is null', () => {
+        const item = { id: 'item-1', type: 'hit', value: 'hit-001', parent: null };
+        const result = buildTree([item]);
+        expect(result.leaves).toEqual([item]);
+    });
+    it('places items at root when parent is undefined', () => {
+        const item = { id: 'item-1', type: 'hit', value: 'hit-001' };
+        const result = buildTree([item]);
+        expect(result.leaves).toEqual([item]);
+    });
+    it('places items inside a folder by parent reference', () => {
+        const folder = { id: 'folder-1', type: 'folder', value: 'My Folder', name: 'My Folder', parent: null };
+        const item = { id: 'item-1', type: 'hit', value: 'hit-001', parent: 'folder-1' };
+        const result = buildTree([folder, item]);
+        expect(result.folders?.['My Folder']).toBeDefined();
+        expect(result.folders?.['My Folder'].leaves).toEqual([item]);
+    });
+    it('renders empty folders', () => {
+        const folder = { id: 'folder-1', type: 'folder', value: 'Empty', name: 'Empty', parent: null };
+        const result = buildTree([folder]);
+        expect(result.folders?.Empty).toBeDefined();
+        expect(result.folders?.Empty.leaves).toEqual([]);
+    });
+    it('nests folders inside other folders', () => {
+        const parent = { id: 'f1', type: 'folder', value: 'Parent', name: 'Parent', parent: null };
+        const child = { id: 'f2', type: 'folder', value: 'Child', name: 'Child', parent: 'f1' };
+        const item = { id: 'i1', type: 'hit', value: 'hit-1', parent: 'f2' };
+        const result = buildTree([parent, child, item]);
+        expect(result.folders?.Parent.folders?.Child.leaves).toEqual([item]);
+    });
+    it('includes folder id in tree nodes', () => {
+        const folder = { id: 'folder-1', type: 'folder', value: 'Folder', name: 'Folder', parent: null };
+        const result = buildTree([folder]);
+        expect(result.folders?.Folder.item?.id).toBe('folder-1');
+    });
+    it('places orphaned items at root when parent folder is missing', () => {
+        const item = { id: 'i1', type: 'hit', value: 'hit-1', parent: 'missing-folder' };
+        const result = buildTree([item]);
+        expect(result.leaves).toEqual([item]);
+    });
+    it('handles markdown items', () => {
+        const markdown = { id: 'md-1', type: 'markdown', value: '# Hello', parent: null };
+        const result = buildTree([markdown]);
+        expect(result.leaves).toEqual([markdown]);
+    });
+    it('handles multiple root-level items', () => {
+        const a = { id: 'a', type: 'hit', value: 'hit-a' };
+        const b = { id: 'b', type: 'event', value: 'event-b' };
+        const result = buildTree([a, b]);
+        expect(result.leaves).toHaveLength(2);
+    });
+    it('handles multiple items in the same folder', () => {
+        const folder = { id: 'f1', type: 'folder', value: 'Alerts', name: 'Alerts', parent: null };
+        const a = { id: 'a', type: 'hit', value: 'hit-a', parent: 'f1' };
+        const b = { id: 'b', type: 'hit', value: 'hit-b', parent: 'f1' };
+        const result = buildTree([folder, a, b]);
+        expect(result.folders?.Alerts.leaves).toHaveLength(2);
+    });
+    it('handles items with name field', () => {
+        const item = { id: 'i1', type: 'hit', value: 'hit-1', name: 'My Hit' };
+        const result = buildTree([item]);
+        expect(result.leaves?.[0].name).toBe('My Hit');
+    });
+    it('preserves all item fields on leaves', () => {
+        const rich = { id: 'r1', type: 'reference', value: 'https://example.com', name: 'Example', parent: null };
+        const result = buildTree([rich]);
+        expect(result.leaves?.[0]).toEqual(rich);
+    });
+});

package/components/routes/cases/detail/types.d.ts

@@ -0,0 +1,24 @@
+export type ObservableType = 'hash' | 'hosts' | 'ip' | 'user' | 'ids' | 'id' | 'uri' | 'signature';
+
+export type ObservableRole = 'threat' | 'target' | 'indicator';
+
+export interface ObservableSource {
+  id: string;
+  type: 'hit' | 'observable' | 'case';
+  path?: string;
+  label?: string;
+  escalation?: string;
+}
+
+export interface ObservableEntry {
+  type: ObservableType;
+  value: string;
+  /** IDs of the hits/observables this observable was seen in */
+  seenIn: string[];
+  /** Resolved source metadata for each seenIn item */
+  sources?: ObservableSource[];
+  /** Classified role of this observable */
+  role?: ObservableRole;
+}
+
+export type OriginType = 'hit' | 'observable';