@arbor-education/design-system.components 0.25.8 → 1.0.0

package/dist/components/widgetCalendar/WidgetCalendar.stories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetCalendar.stories.js","sourceRoot":"","sources":["../../../src/components/widgetCalendar/WidgetCalendar.stories.tsx"],"names":[],"mappings":"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"}

package/dist/components/widgetCalendar/WidgetCalendar.test.d.ts

@@ -0,0 +1,2 @@
+import '@testing-library/jest-dom/vitest';
+//# sourceMappingURL=WidgetCalendar.test.d.ts.map

package/dist/components/widgetCalendar/WidgetCalendar.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetCalendar.test.d.ts","sourceRoot":"","sources":["../../../src/components/widgetCalendar/WidgetCalendar.test.tsx"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC"}

package/dist/components/widgetCalendar/WidgetCalendar.test.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import '@testing-library/jest-dom/vitest';
+import { fireEvent, render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { describe, expect, test, vi } from 'vitest';
+import { WidgetCalendar } from './WidgetCalendar.js';
+const mockItems = [
+    {
+        id: 'year-10',
+        eventType: 'primary',
+        eventPrimaryTerm: 'Class',
+        eventPrimaryDefinition: 'Year 10: 10G',
+        eventSecondaryTerm: 'Time and location',
+        eventDateTime: '2026-06-08T08:45/2026-06-08T09:00',
+        eventTimeLabel: '08:45 – 09:00',
+        eventLocation: 'Classroom 102',
+    },
+    {
+        id: 'class-label',
+        eventType: 'secondary',
+        eventPrimaryTerm: 'Class',
+        eventPrimaryDefinition: 'Class',
+        eventSecondaryTerm: 'Time and location',
+        eventDateTime: '2026-06-08T10:00/2026-06-08T10:45',
+        eventTimeLabel: '10:00 – 10:45',
+        eventLocation: 'Hall',
+    },
+];
+describe('WidgetCalendar', () => {
+    test('renders calendar items with primary and secondary definitions', () => {
+        render(_jsx(WidgetCalendar, { heading: "Calendar", items: mockItems }));
+        expect(screen.getByRole('heading', { name: 'Calendar' })).toBeInTheDocument();
+        expect(screen.getByText('Year 10: 10G')).toBeInTheDocument();
+        expect(screen.getAllByText('Class').length).toBeGreaterThan(0);
+        expect(screen.getByText('08:45 – 09:00')).toBeInTheDocument();
+        expect(screen.getByText(/Classroom 102/)).toBeInTheDocument();
+    });
+    test('renders semantic time element with ISO dateTime', () => {
+        render(_jsx(WidgetCalendar, { heading: "Calendar", items: mockItems }));
+        const time = screen.getByText('08:45 – 09:00').closest('time');
+        expect(time).toHaveAttribute('datetime', '2026-06-08T08:45/2026-06-08T09:00');
+        expect(time).toHaveClass('ds-widget-calendar__time');
+    });
+    test('applies primary and secondary modifier classes', () => {
+        const { container } = render(_jsx(WidgetCalendar, { heading: "Calendar", items: mockItems }));
+        expect(container.querySelector('.ds-widget-calendar__item--primary')).toBeInTheDocument();
+        expect(container.querySelector('.ds-widget-calendar__item--secondary')).toBeInTheDocument();
+    });
+    test('calls onItemClick with item id', async () => {
+        const user = userEvent.setup();
+        const onItemClick = vi.fn();
+        render(_jsx(WidgetCalendar, { heading: "Calendar", items: mockItems, onItemClick: onItemClick }));
+        await user.click(screen.getByRole('button', { name: 'Open Year 10: 10G' }));
+        expect(onItemClick).toHaveBeenCalledWith('year-10');
+    });
+    test('uses custom buttonA11yText for item label', () => {
+        render(_jsx(WidgetCalendar, { heading: "Calendar", items: [
+                {
+                    id: 'year-10',
+                    eventType: 'primary',
+                    eventPrimaryTerm: 'Class',
+                    eventPrimaryDefinition: 'Year 10: 10G',
+                    eventSecondaryTerm: 'Time and location',
+                    eventDateTime: '2026-06-08T08:45/2026-06-08T09:00',
+                    eventTimeLabel: '08:45 – 09:00',
+                    eventLocation: 'Classroom 102',
+                    buttonA11yText: 'View Year 10 timetable',
+                },
+            ], onItemClick: vi.fn() }));
+        expect(screen.getByRole('button', { name: 'View Year 10 timetable' })).toBeInTheDocument();
+    });
+    test('activates item on Enter key', () => {
+        const onItemClick = vi.fn();
+        render(_jsx(WidgetCalendar, { heading: "Calendar", items: mockItems, onItemClick: onItemClick }));
+        const item = screen.getByRole('button', { name: 'Open Year 10: 10G' });
+        fireEvent.keyDown(item, { key: 'Enter' });
+        expect(onItemClick).toHaveBeenCalledWith('year-10');
+    });
+    test('renders linked header when headingHref is set', () => {
+        render(_jsx(WidgetCalendar, { heading: "Calendar", headingHref: "/calendar", items: mockItems }));
+        expect(screen.getByRole('link', { name: 'Calendar' })).toHaveAttribute('href', '/calendar');
+    });
+    test('renders empty state when items is empty', () => {
+        render(_jsx(WidgetCalendar, { heading: "Calendar", items: [] }));
+        expect(screen.getByRole('heading', { name: 'Nothing scheduled' })).toBeInTheDocument();
+    });
+});
+//# sourceMappingURL=WidgetCalendar.test.js.map

package/dist/components/widgetCalendar/WidgetCalendar.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetCalendar.test.js","sourceRoot":"","sources":["../../../src/components/widgetCalendar/WidgetCalendar.test.tsx"],"names":[],"mappings":"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"}

package/dist/components/widgetCalendar/WidgetCalendarItem.d.ts

@@ -0,0 +1,17 @@
+export type WidgetCalendarEventType = 'primary' | 'secondary';
+export type WidgetCalendarItemProps = {
+    id: string;
+    eventType?: WidgetCalendarEventType;
+    eventPrimaryTerm: React.ReactNode;
+    eventPrimaryDefinition: React.ReactNode;
+    eventSecondaryTerm: React.ReactNode;
+    eventDateTime: string;
+    eventTimeLabel: string;
+    eventLocation?: string;
+    eventSecondaryDefinition?: React.ReactNode;
+    buttonA11yText?: string;
+    onItemClick?: () => void;
+    className?: string;
+};
+export declare const WidgetCalendarItem: (props: WidgetCalendarItemProps) => React.JSX.Element;
+//# sourceMappingURL=WidgetCalendarItem.d.ts.map

package/dist/components/widgetCalendar/WidgetCalendarItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetCalendarItem.d.ts","sourceRoot":"","sources":["../../../src/components/widgetCalendar/WidgetCalendarItem.tsx"],"names":[],"mappings":"AAIA,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,WAAW,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,sBAAsB,EAAE,KAAK,CAAC,SAAS,CAAC;IACxC,kBAAkB,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,uBAAuB,KAAG,KAAK,CAAC,GAAG,CAAC,OAmF7E,CAAC"}

package/dist/components/widgetCalendar/WidgetCalendarItem.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import classNames from 'classnames';
+import { Icon } from '../icon/Icon.js';
+import { ENTER_KEY, SPACE_KEY } from '../../utils/keyboardConstants.js';
+export const WidgetCalendarItem = (props) => {
+    const { id, eventType = 'primary', eventPrimaryTerm, eventPrimaryDefinition, eventSecondaryTerm, eventDateTime, eventTimeLabel, eventLocation, eventSecondaryDefinition, buttonA11yText, onItemClick, className, } = props;
+    const isInteractive = Boolean(onItemClick);
+    const defaultA11yLabel = typeof eventPrimaryDefinition === 'string'
+        ? `Open ${eventPrimaryDefinition}`
+        : 'Open event';
+    const secondaryContent = eventSecondaryDefinition ?? (_jsxs(_Fragment, { children: [_jsx("time", { dateTime: eventDateTime, className: "ds-widget-calendar__time", children: eventTimeLabel }), eventLocation ? `, ${eventLocation}` : null] }));
+    const handleKeyDown = (event) => {
+        if (!isInteractive) {
+            return;
+        }
+        if ([SPACE_KEY, ENTER_KEY].includes(event.key)) {
+            event.preventDefault();
+            onItemClick?.();
+        }
+    };
+    return (_jsxs("li", { className: classNames('ds-widget-calendar__item', eventType === 'secondary'
+            ? 'ds-widget-calendar__item--secondary'
+            : 'ds-widget-calendar__item--primary', isInteractive && 'ds-widget-calendar__item--interactive', className), "data-testid": `widget-calendar-item-${id}`, role: isInteractive ? 'button' : undefined, tabIndex: isInteractive ? 0 : undefined, "aria-label": isInteractive ? (buttonA11yText ?? defaultA11yLabel) : undefined, onClick: isInteractive ? onItemClick : undefined, onKeyDown: handleKeyDown, children: [_jsx("div", { className: "ds-widget-calendar__content", children: _jsxs("dl", { className: "ds-widget-calendar__details", children: [_jsx("dt", { className: "sr-only", children: eventPrimaryTerm }), _jsx("dd", { className: "ds-widget-calendar__primary-definition", children: eventPrimaryDefinition }), _jsx("dt", { className: "sr-only", children: eventSecondaryTerm }), _jsx("dd", { className: "ds-widget-calendar__secondary-definition", children: secondaryContent })] }) }), isInteractive && (_jsxs("div", { className: "ds-widget-calendar__action", "aria-hidden": "true", children: [_jsx(Icon, { name: "chevron-right", size: 16, className: "ds-widget-calendar__icon-chevron" }), _jsx(Icon, { name: "arrow-right", size: 16, className: "ds-widget-calendar__icon-arrow" })] }))] }));
+};
+//# sourceMappingURL=WidgetCalendarItem.js.map

package/dist/components/widgetCalendar/WidgetCalendarItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetCalendarItem.js","sourceRoot":"","sources":["../../../src/components/widgetCalendar/WidgetCalendarItem.tsx"],"names":[],"mappings":";AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAmB/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAA8B,EAAqB,EAAE;IACtF,MAAM,EACJ,EAAE,EACF,SAAS,GAAG,SAAS,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,SAAS,GACV,GAAG,KAAK,CAAC;IAEV,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3C,MAAM,gBAAgB,GAAG,OAAO,sBAAsB,KAAK,QAAQ;QACjE,CAAC,CAAC,QAAQ,sBAAsB,EAAE;QAClC,CAAC,CAAC,YAAY,CAAC;IAEjB,MAAM,gBAAgB,GAAG,wBAAwB,IAAI,CACnD,8BACE,eAAM,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAC,0BAA0B,YAChE,cAAc,GACV,EACN,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,IAC3C,CACJ,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,KAAyC,EAAE,EAAE;QAClE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,cACE,SAAS,EAAE,UAAU,CACnB,0BAA0B,EAC1B,SAAS,KAAK,WAAW;YACvB,CAAC,CAAC,qCAAqC;YACvC,CAAC,CAAC,mCAAmC,EACvC,aAAa,IAAI,uCAAuC,EACxD,SAAS,CACV,iBACY,wBAAwB,EAAE,EAAE,EACzC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAC1C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,gBAC3B,aAAa,CAAC,CAAC,CAAC,CAAC,cAAc,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,EAC5E,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,EAChD,SAAS,EAAE,aAAa,aAExB,cAAK,SAAS,EAAC,6BAA6B,YAC1C,cAAI,SAAS,EAAC,6BAA6B,aACzC,aAAI,SAAS,EAAC,SAAS,YAAE,gBAAgB,GAAM,EAC/C,aAAI,SAAS,EAAC,wCAAwC,YAAE,sBAAsB,GAAM,EACpF,aAAI,SAAS,EAAC,SAAS,YAAE,kBAAkB,GAAM,EACjD,aAAI,SAAS,EAAC,0CAA0C,YAAE,gBAAgB,GAAM,IAC7E,GACD,EACL,aAAa,IAAI,CAChB,eAAK,SAAS,EAAC,4BAA4B,iBAAa,MAAM,aAC5D,KAAC,IAAI,IACH,IAAI,EAAC,eAAe,EACpB,IAAI,EAAE,EAAE,EACR,SAAS,EAAC,kCAAkC,GAC5C,EACF,KAAC,IAAI,IACH,IAAI,EAAC,aAAa,EAClB,IAAI,EAAE,EAAE,EACR,SAAS,EAAC,gCAAgC,GAC1C,IACE,CACP,IACE,CACN,CAAC;AACJ,CAAC,CAAC"}

package/dist/components/widgetFavourites/WidgetFavourites.d.ts

@@ -0,0 +1,12 @@
+import type { WidgetFavouritesItemProps, WidgetFavouritesProps } from './types.js';
+export declare const WidgetFavourites: {
+    (props: WidgetFavouritesProps): React.JSX.Element;
+    Item: (props: WidgetFavouritesItemProps) => React.JSX.Element;
+};
+export declare namespace WidgetFavourites {
+    type Props = WidgetFavouritesProps;
+    type ItemProps = WidgetFavouritesItemProps;
+    type ItemData = import('./types.js').WidgetFavouritesItemData;
+}
+export type { WidgetFavouritesItemData, WidgetFavouritesItemProps, WidgetFavouritesProps, } from './types.js';
+//# sourceMappingURL=WidgetFavourites.d.ts.map

package/dist/components/widgetFavourites/WidgetFavourites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetFavourites.d.ts","sourceRoot":"","sources":["../../../src/components/widgetFavourites/WidgetFavourites.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAWnF,eAAO,MAAM,gBAAgB;YAAW,qBAAqB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO;;CAsDhF,CAAC;AAIF,yBAAiB,gBAAgB,CAAC;IAChC,KAAY,KAAK,GAAG,qBAAqB,CAAC;IAC1C,KAAY,SAAS,GAAG,yBAAyB,CAAC;IAClD,KAAY,QAAQ,GAAG,OAAO,YAAY,EAAE,wBAAwB,CAAC;CACtE;AAED,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/components/widgetFavourites/WidgetFavourites.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { EmptyState } from '../emptyState/EmptyState.js';
+import { Widget } from '../widget/Widget.js';
+import { WidgetFavouritesItem } from './WidgetFavouritesItem.js';
+const defaultEmptyState = (_jsx(EmptyState, { padding: "md", heading: "No favourites yet", subHeading: "Star pages from the sidebar to see them here." }));
+export const WidgetFavourites = (props) => {
+    const { heading, tooltip, items, headingHref, isFloating = false, onRemoveItem, emptyState = defaultEmptyState, className, } = props;
+    const isEmpty = items.length === 0;
+    const widgetCommonProps = {
+        tooltip,
+        isFloating,
+        isEmpty,
+        emptyState,
+        className,
+    };
+    const body = (_jsxs(_Fragment, { children: [_jsx(Widget.Header, { children: heading }), _jsx(Widget.Body, { children: !isEmpty && (_jsx("ul", { className: "ds-widget-favourites__list", children: items.map(item => (_jsx(WidgetFavouritesItem, { id: item.id, label: item.label, href: item.href, removeLabel: item.removeLabel, onRemove: onRemoveItem ? () => onRemoveItem(item.id) : undefined }, item.id))) })) })] }));
+    return (_jsx(Widget, { ...{
+            ...widgetCommonProps,
+            ...(headingHref ? { href: headingHref } : {}),
+        }, children: body }));
+};
+WidgetFavourites.Item = WidgetFavouritesItem;
+//# sourceMappingURL=WidgetFavourites.js.map

package/dist/components/widgetFavourites/WidgetFavourites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetFavourites.js","sourceRoot":"","sources":["../../../src/components/widgetFavourites/WidgetFavourites.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,iBAAiB,GAAG,CACxB,KAAC,UAAU,IACT,OAAO,EAAC,IAAI,EACZ,OAAO,EAAC,mBAAmB,EAC3B,UAAU,EAAC,+CAA+C,GAC1D,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAA4B,EAAqB,EAAE;IAClF,MAAM,EACJ,OAAO,EACP,OAAO,EACP,KAAK,EACL,WAAW,EACX,UAAU,GAAG,KAAK,EAClB,YAAY,EACZ,UAAU,GAAG,iBAAiB,EAC9B,SAAS,GACV,GAAG,KAAK,CAAC;IAEV,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAEnC,MAAM,iBAAiB,GAAG;QACxB,OAAO;QACP,UAAU;QACV,OAAO;QACP,UAAU;QACV,SAAS;KACV,CAAC;IAEF,MAAM,IAAI,GAAG,CACX,8BACE,KAAC,MAAM,CAAC,MAAM,cAAE,OAAO,GAAiB,EACxC,KAAC,MAAM,CAAC,IAAI,cACT,CAAC,OAAO,IAAI,CACX,aAAI,SAAS,EAAC,4BAA4B,YACvC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CACjB,KAAC,oBAAoB,IAEnB,EAAE,EAAE,IAAI,CAAC,EAAE,EACX,KAAK,EAAE,IAAI,CAAC,KAAK,EACjB,IAAI,EAAE,IAAI,CAAC,IAAI,EACf,WAAW,EAAE,IAAI,CAAC,WAAW,EAC7B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAL3D,IAAI,CAAC,EAAE,CAMZ,CACH,CAAC,GACC,CACN,GACW,IACb,CACJ,CAAC;IAEF,OAAO,CACL,KAAC,MAAM,OACA;YACH,GAAG,iBAAiB;YACpB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpB,YAE1B,IAAI,GACE,CACV,CAAC;AACJ,CAAC,CAAC;AAEF,gBAAgB,CAAC,IAAI,GAAG,oBAAoB,CAAC"}

package/dist/components/widgetFavourites/WidgetFavourites.stories.d.ts

@@ -0,0 +1,84 @@
+import type { StoryObj } from '@storybook/react-vite';
+import type { WidgetFavouritesItemData } from './types.js';
+declare function WidgetFavouritesDocsPage(): import("react/jsx-runtime").JSX.Element;
+declare const meta: {
+    title: string;
+    component: {
+        (props: import("./types.js").WidgetFavouritesProps): React.JSX.Element;
+        Item: (props: import("./types.js").WidgetFavouritesItemProps) => React.JSX.Element;
+    };
+    parameters: {
+        layout: string;
+        docs: {
+            page: typeof WidgetFavouritesDocsPage;
+        };
+    };
+    tags: string[];
+    args: {
+        heading: string;
+        tooltip: string;
+        headingHref: string;
+        isFloating: true;
+        items: WidgetFavouritesItemData[];
+        onRemoveItem: import("vitest").Mock<(...args: any[]) => any>;
+    };
+    argTypes: {
+        heading: {
+            control: "text";
+            description: string;
+            table: {
+                type: {
+                    summary: string;
+                };
+            };
+        };
+        tooltip: {
+            control: "text";
+            description: string;
+            table: {
+                type: {
+                    summary: string;
+                };
+            };
+        };
+        headingHref: {
+            control: "text";
+            description: string;
+            table: {
+                type: {
+                    summary: string;
+                };
+            };
+        };
+        isFloating: {
+            control: "boolean";
+            description: string;
+            table: {
+                type: {
+                    summary: string;
+                };
+                defaultValue: {
+                    summary: string;
+                };
+            };
+        };
+        items: {
+            control: false;
+        };
+        onRemoveItem: {
+            control: false;
+        };
+        emptyState: {
+            control: false;
+        };
+        className: {
+            control: false;
+        };
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+export declare const WithConfirmRemove: Story;
+export declare const Empty: Story;
+//# sourceMappingURL=WidgetFavourites.stories.d.ts.map

package/dist/components/widgetFavourites/WidgetFavourites.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetFavourites.stories.d.ts","sourceRoot":"","sources":["../../../src/components/widgetFavourites/WidgetFavourites.stories.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AA8E3D,iBAAS,wBAAwB,4CAmBhC;AAED,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+C+B,CAAC;AAE1C,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAkJnC,eAAO,MAAM,OAAO,EAAE,KAQrB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,KAQ/B,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAQnB,CAAC"}

package/dist/components/widgetFavourites/WidgetFavourites.stories.js

@@ -0,0 +1,210 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Controls, Heading as DocHeading, Primary as DocPrimary, Markdown, Stories, Subtitle, Title, } from '@storybook/addon-docs/blocks';
+import { Button } from '../button/Button.js';
+import { Modal } from '../modal/Modal.js';
+import { Toast } from '../toast/Toast.js';
+import { useCallback, useState } from 'react';
+import { createPortal } from 'react-dom';
+import { fn } from 'storybook/test';
+import { getFavouriteRemovedToastMessage } from '../../utils/favourites/favouriteConstants.js';
+import { WidgetFavourites } from './WidgetFavourites.js';
+const initialItems = [
+    { id: 'daily', label: 'Daily Attendance', href: '/attendance/daily' },
+    { id: 'reports', label: 'Assessment Reports', href: '/reports/assessment' },
+    { id: 'behaviour', label: 'Behaviour Incidents', href: '/behaviour/incidents' },
+    { id: 'calendar', label: 'School Calendar', href: '/calendar' },
+];
+const DESCRIPTION_INTRO = [
+    '`WidgetFavourites` is a pre-composed dashboard widget for starred pages.',
+    'It wraps [`Widget`](?path=/docs/components-widget--docs) with a linked header and a list of favourite rows —',
+    'each row navigates via `href` and exposes a remove button when `onRemoveItem` is provided.',
+].join(' ');
+const USAGE_GUIDANCE = [
+    '### When to use',
+    '',
+    '- Dashboard home panels showing a user\'s starred sidebar pages',
+    '- A compact favourites summary with a linked header to the full favourites page',
+    '- Lists where removal should offer undo via [`Toast`](?path=/docs/components-toast--docs)',
+    '',
+    '---',
+    '',
+    '### When NOT to use',
+    '',
+    '| Situation | Use instead |',
+    '|---|---|',
+    '| Editing favourites inside the sidebar itself | [`SidebarNav`](?path=/docs/components-sidebarnav--docs) panel items with `canFavourite` |',
+    '| A generic linked list without remove affordance | [`Widget`](?path=/docs/components-widget--docs) with custom body content |',
+    '| Destructive removal that must be confirmed first | Pair with [`Modal`](?path=/docs/components-modal--docs) before mutating state |',
+].join('\n');
+const DEVELOPER_NOTES = [
+    '### Critical usage patterns',
+    '',
+    '**Remove buttons are opt-in.** Pass `onRemoveItem` to show the star remove control on each row.',
+    'The parent owns persistence, confirmation, and undo behaviour. Remove buttons use shared',
+    '`FAVOURITE_TOOLTIP.remove` for tooltip and `aria-label` by default.',
+    '',
+    '**Row link and remove are siblings.** The remove button is not nested inside the row anchor —',
+    'same pattern as sidebar favourites. Click handlers call `event.stopPropagation()`.',
+    '',
+    '**Empty list uses Widget empty state.** When `items` is empty, `WidgetFavourites` sets `isEmpty` on the',
+    'underlying `Widget` and renders the default or custom `emptyState`.',
+    '',
+    '**Undo removal.** Wire removal in the parent and pass a foreground toast with `toastActions` for the recommended product flow.',
+    '',
+    '---',
+    '',
+    '### Accessibility',
+    '',
+    '- Each remove button has a tooltip and `aria-label` — defaults to **Remove from favourites**; override per row via `items[].removeLabel`',
+    '- Remove controls are always visible when `onRemoveItem` is provided',
+    '- Linked header follows the same stretched-link overlay pattern as `Widget`',
+    '',
+    '---',
+    '',
+    '### TypeScript types',
+    '',
+    '```ts',
+    "import { WidgetFavourites } from '@arbor-education/design-system.components';",
+    '',
+    'function FavouritesWidget(props: WidgetFavourites.Props) {',
+    '  return <WidgetFavourites {...props} />;',
+    '}',
+    '```',
+].join('\n');
+const RELATED_COMPONENTS = [
+    '## Related components',
+    '',
+    '[Widget](?path=/docs/components-widget--docs) · [EmptyState](?path=/docs/components-emptystate--docs) · [Toast](?path=/docs/components-toast--docs) · [Modal](?path=/docs/components-modal--docs)',
+].join('\n');
+const PROPS_INTRO = 'The preview below demonstrates the recommended undo-toast removal flow. Use the named stories to explore confirmation and empty states.';
+function WidgetFavouritesDocsPage() {
+    return (_jsxs(_Fragment, { children: [_jsx(Title, {}), _jsx(Subtitle, {}), _jsx(Markdown, { children: DESCRIPTION_INTRO }), _jsx(DocHeading, { children: "Interactive example" }), _jsx(Markdown, { children: PROPS_INTRO }), _jsx(DocPrimary, {}), _jsx(Controls, {}), _jsx(DocHeading, { children: "Usage guidance" }), _jsx(Markdown, { children: USAGE_GUIDANCE }), _jsx(DocHeading, { children: "Developer notes" }), _jsx(Markdown, { children: DEVELOPER_NOTES }), _jsx(DocHeading, { children: "Examples" }), _jsx(Stories, { title: "" }), _jsx(Markdown, { children: RELATED_COMPONENTS })] }));
+}
+const meta = {
+    title: 'Components/Widget/WidgetFavourites',
+    component: WidgetFavourites,
+    parameters: {
+        layout: 'padded',
+        docs: {
+            page: WidgetFavouritesDocsPage,
+        },
+    },
+    tags: ['autodocs'],
+    args: {
+        heading: 'Favourites',
+        tooltip: 'Your starred pages appear here',
+        headingHref: '/favourites',
+        isFloating: true,
+        items: initialItems,
+        onRemoveItem: fn(),
+    },
+    argTypes: {
+        heading: {
+            control: 'text',
+            description: 'Widget header title — often includes a live count.',
+            table: { type: { summary: 'ReactNode' } },
+        },
+        tooltip: {
+            control: 'text',
+            description: 'Info tooltip beside the header title.',
+            table: { type: { summary: 'string' } },
+        },
+        headingHref: {
+            control: 'text',
+            description: 'Linked header URL for the full favourites page.',
+            table: { type: { summary: 'string' } },
+        },
+        isFloating: {
+            control: 'boolean',
+            description: 'Applies permanent elevation shadow on the underlying Widget.',
+            table: {
+                type: { summary: 'boolean' },
+                defaultValue: { summary: 'false' },
+            },
+        },
+        items: { control: false },
+        onRemoveItem: { control: false },
+        emptyState: { control: false },
+        className: { control: false },
+    },
+};
+export default meta;
+const withDescription = (story, description) => ({
+    ...story,
+    parameters: {
+        ...story.parameters,
+        docs: {
+            ...story.parameters?.docs,
+            description: { story: description },
+        },
+    },
+});
+const ToastStoryWrapper = ({ children }) => (_jsxs(Toast.Provider, { children: [children, createPortal(_jsx(Toast.Viewport, {}), document.body)] }));
+const UndoableFavouritesTemplate = () => {
+    const [items, setItems] = useState(initialItems);
+    const [removedItem, setRemovedItem] = useState(null);
+    const [removedItemIndex, setRemovedItemIndex] = useState(null);
+    const [toastOpen, setToastOpen] = useState(false);
+    const removeItem = useCallback((id) => {
+        setItems((current) => {
+            const index = current.findIndex(entry => entry.id === id);
+            if (index === -1) {
+                return current;
+            }
+            const item = current[index];
+            if (item === undefined) {
+                return current;
+            }
+            setRemovedItem(item);
+            setRemovedItemIndex(index);
+            setToastOpen(false);
+            requestAnimationFrame(() => setToastOpen(true));
+            return current.filter(entry => entry.id !== id);
+        });
+    }, []);
+    const undoRemove = useCallback(() => {
+        if (removedItem !== null && removedItemIndex !== null) {
+            setItems((current) => {
+                const next = [...current];
+                next.splice(removedItemIndex, 0, removedItem);
+                return next;
+            });
+            setRemovedItem(null);
+            setRemovedItemIndex(null);
+        }
+        setToastOpen(false);
+    }, [removedItem, removedItemIndex]);
+    return (_jsxs(ToastStoryWrapper, { children: [_jsx(WidgetFavourites, { heading: `Favourites (${items.length})`, tooltip: "Your starred pages appear here", headingHref: "/favourites", isFloating: true, items: items, onRemoveItem: removeItem }), _jsx(Toast, { open: toastOpen, onOpenChange: setToastOpen, type: "foreground", duration: 10000, variant: "information", toastContent: removedItem ? getFavouriteRemovedToastMessage(removedItem.label) : '', toastActions: (_jsx(Toast.Action, { altText: "Undo removal", onClick: undoRemove, asChild: true, children: _jsx(Button, { variant: "text-link", type: "button", hasHorizontalPadding: false, children: "Undo" }) })) })] }));
+};
+const WithConfirmRemoveTemplate = () => {
+    const [items, setItems] = useState(initialItems);
+    const [pendingRemoveId, setPendingRemoveId] = useState(null);
+    const pendingItem = items.find(item => item.id === pendingRemoveId);
+    const handleConfirmRemove = () => {
+        if (pendingRemoveId) {
+            setItems(current => current.filter(item => item.id !== pendingRemoveId));
+            setPendingRemoveId(null);
+        }
+    };
+    return (_jsxs(_Fragment, { children: [_jsx(WidgetFavourites, { heading: `Favourites (${items.length})`, tooltip: "Your starred pages appear here", headingHref: "/favourites", isFloating: true, items: items, onRemoveItem: setPendingRemoveId }), _jsxs(Modal, { open: pendingRemoveId !== null, title: pendingItem ? `Remove ${pendingItem.label}?` : 'Remove favourite?', children: [_jsx(Modal.Body, { children: _jsxs("p", { style: { margin: 0 }, children: ["Are you sure you want to remove", ' ', _jsx("strong", { children: pendingItem?.label }), ' ', "from your favourites?"] }) }), _jsxs(Modal.Footer, { children: [_jsx(Button, { variant: "secondary", onClick: () => setPendingRemoveId(null), children: "Cancel" }), _jsx(Button, { variant: "primary-destructive", onClick: handleConfirmRemove, children: "Yes, remove" })] })] })] }));
+};
+const EmptyTemplate = () => (_jsx(WidgetFavourites, { heading: "Favourites (0)", tooltip: "Your starred pages appear here", headingHref: "/favourites", isFloating: true, items: [] }));
+export const Default = withDescription({
+    render: UndoableFavouritesTemplate,
+    parameters: {
+        controls: { disable: true },
+    },
+}, 'Recommended product flow: remove a favourite, then undo via a foreground toast. Each row shows the remove button when `onRemoveItem` is wired.');
+export const WithConfirmRemove = withDescription({
+    render: WithConfirmRemoveTemplate,
+    parameters: {
+        controls: { disable: true },
+    },
+}, 'Alternative flow when removal must be confirmed before mutating state. The remove button opens a destructive modal.');
+export const Empty = withDescription({
+    render: EmptyTemplate,
+    parameters: {
+        controls: { disable: true },
+    },
+}, 'Empty `items` array enables the built-in empty state inside the Widget body.');
+//# sourceMappingURL=WidgetFavourites.stories.js.map

package/dist/components/widgetFavourites/WidgetFavourites.stories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetFavourites.stories.js","sourceRoot":"","sources":["../../../src/components/widgetFavourites/WidgetFavourites.stories.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,QAAQ,EACR,OAAO,IAAI,UAAU,EACrB,OAAO,IAAI,UAAU,EACrB,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,KAAK,GACN,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAC;AAEtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,YAAY,GAA+B;IAC/C,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,mBAAmB,EAAE;IACrE,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC3E,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,sBAAsB,EAAE;IAC/E,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE;CAChE,CAAC;AAEF,MAAM,iBAAiB,GAAG;IACxB,0EAA0E;IAC1E,8GAA8G;IAC9G,4FAA4F;CAC7F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,cAAc,GAAG;IACrB,iBAAiB;IACjB,EAAE;IACF,iEAAiE;IACjE,iFAAiF;IACjF,2FAA2F;IAC3F,EAAE;IACF,KAAK;IACL,EAAE;IACF,qBAAqB;IACrB,EAAE;IACF,6BAA6B;IAC7B,WAAW;IACX,4IAA4I;IAC5I,gIAAgI;IAChI,sIAAsI;CACvI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,eAAe,GAAG;IACtB,6BAA6B;IAC7B,EAAE;IACF,iGAAiG;IACjG,0FAA0F;IAC1F,qEAAqE;IACrE,EAAE;IACF,+FAA+F;IAC/F,oFAAoF;IACpF,EAAE;IACF,yGAAyG;IACzG,qEAAqE;IACrE,EAAE;IACF,gIAAgI;IAChI,EAAE;IACF,KAAK;IACL,EAAE;IACF,mBAAmB;IACnB,EAAE;IACF,0IAA0I;IAC1I,sEAAsE;IACtE,6EAA6E;IAC7E,EAAE;IACF,KAAK;IACL,EAAE;IACF,sBAAsB;IACtB,EAAE;IACF,OAAO;IACP,+EAA+E;IAC/E,EAAE;IACF,4DAA4D;IAC5D,2CAA2C;IAC3C,GAAG;IACH,KAAK;CACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,kBAAkB,GAAG;IACzB,uBAAuB;IACvB,EAAE;IACF,mMAAmM;CACpM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,WAAW,GAAG,yIAAyI,CAAC;AAE9J,SAAS,wBAAwB;IAC/B,OAAO,CACL,8BACE,KAAC,KAAK,KAAG,EACT,KAAC,QAAQ,KAAG,EACZ,KAAC,QAAQ,cAAE,iBAAiB,GAAY,EACxC,KAAC,UAAU,sCAAiC,EAC5C,KAAC,QAAQ,cAAE,WAAW,GAAY,EAClC,KAAC,UAAU,KAAG,EACd,KAAC,QAAQ,KAAG,EACZ,KAAC,UAAU,iCAA4B,EACvC,KAAC,QAAQ,cAAE,cAAc,GAAY,EACrC,KAAC,UAAU,kCAA6B,EACxC,KAAC,QAAQ,cAAE,eAAe,GAAY,EACtC,KAAC,UAAU,2BAAsB,EACjC,KAAC,OAAO,IAAC,KAAK,EAAC,EAAE,GAAG,EACpB,KAAC,QAAQ,cAAE,kBAAkB,GAAY,IACxC,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,IAAI,GAAG;IACX,KAAK,EAAE,oCAAoC;IAC3C,SAAS,EAAE,gBAAgB;IAC3B,UAAU,EAAE;QACV,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,wBAAwB;SAC/B;KACF;IACD,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,IAAI,EAAE;QACJ,OAAO,EAAE,YAAY;QACrB,OAAO,EAAE,gCAAgC;QACzC,WAAW,EAAE,aAAa;QAC1B,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,YAAY;QACnB,YAAY,EAAE,EAAE,EAAE;KACnB;IACD,QAAQ,EAAE;QACR,OAAO,EAAE;YACP,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,oDAAoD;YACjE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE;SAC1C;QACD,OAAO,EAAE;YACP,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,uCAAuC;YACpD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;SACvC;QACD,WAAW,EAAE;YACX,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,iDAAiD;YAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;SACvC;QACD,UAAU,EAAE;YACV,OAAO,EAAE,SAAS;YAClB,WAAW,EAAE,8DAA8D;YAC3E,KAAK,EAAE;gBACL,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;gBAC5B,YAAY,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;aACnC;SACF;QACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QACzB,YAAY,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QAChC,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QAC9B,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;KAC9B;CACsC,CAAC;AAE1C,eAAe,IAAI,CAAC;AAGpB,MAAM,eAAe,GAAG,CAAC,KAAY,EAAE,WAAmB,EAAS,EAAE,CAAC,CAAC;IACrE,GAAG,KAAK;IACR,UAAU,EAAE;QACV,GAAG,KAAK,CAAC,UAAU;QACnB,IAAI,EAAE;YACJ,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI;YACzB,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;SACpC;KACF;CACF,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CACzE,MAAC,KAAK,CAAC,QAAQ,eACZ,QAAQ,EACR,YAAY,CAAC,KAAC,KAAK,CAAC,QAAQ,KAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,IACjC,CAClB,CAAC;AAEF,MAAM,0BAA0B,GAAG,GAAG,EAAE;IACtC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAkC,IAAI,CAAC,CAAC;IACtF,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAC9E,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,EAAU,EAAE,EAAE;QAC5C,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;YACnB,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAE1D,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAE5B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,cAAc,CAAC,IAAI,CAAC,CAAC;YACrB,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC3B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,qBAAqB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;YAEhD,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;QAClC,IAAI,WAAW,KAAK,IAAI,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;YACtD,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;gBACnB,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;gBAC9C,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YACH,cAAc,CAAC,IAAI,CAAC,CAAC;YACrB,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEpC,OAAO,CACL,MAAC,iBAAiB,eAChB,KAAC,gBAAgB,IACf,OAAO,EAAE,eAAe,KAAK,CAAC,MAAM,GAAG,EACvC,OAAO,EAAC,gCAAgC,EACxC,WAAW,EAAC,aAAa,EACzB,UAAU,QACV,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,UAAU,GACxB,EACF,KAAC,KAAK,IACJ,IAAI,EAAE,SAAS,EACf,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAC,YAAY,EACjB,QAAQ,EAAE,KAAK,EACf,OAAO,EAAC,aAAa,EACrB,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,+BAA+B,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EACnF,YAAY,EAAE,CACZ,KAAC,KAAK,CAAC,MAAM,IAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAE,UAAU,EAAE,OAAO,kBAC/D,KAAC,MAAM,IAAC,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,QAAQ,EAAC,oBAAoB,EAAE,KAAK,qBAAe,GACvE,CAChB,GACD,IACgB,CACrB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,yBAAyB,GAAG,GAAG,EAAE;IACrC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE5E,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC;IAEpE,MAAM,mBAAmB,GAAG,GAAG,EAAE;QAC/B,IAAI,eAAe,EAAE,CAAC;YACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC,CAAC;YACzE,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,8BACE,KAAC,gBAAgB,IACf,OAAO,EAAE,eAAe,KAAK,CAAC,MAAM,GAAG,EACvC,OAAO,EAAC,gCAAgC,EACxC,WAAW,EAAC,aAAa,EACzB,UAAU,QACV,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,kBAAkB,GAChC,EACF,MAAC,KAAK,IAAC,IAAI,EAAE,eAAe,KAAK,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,UAAU,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,mBAAmB,aAC9G,KAAC,KAAK,CAAC,IAAI,cACT,aAAG,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,gDAEpB,GAAG,EACJ,2BAAS,WAAW,EAAE,KAAK,GAAU,EACpC,GAAG,6BAEF,GACO,EACb,MAAC,KAAK,CAAC,MAAM,eACX,KAAC,MAAM,IAAC,OAAO,EAAC,WAAW,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,uBAE1D,EACT,KAAC,MAAM,IAAC,OAAO,EAAC,qBAAqB,EAAC,OAAO,EAAE,mBAAmB,4BAEzD,IACI,IACT,IACP,CACJ,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,CAC1B,KAAC,gBAAgB,IACf,OAAO,EAAC,gBAAgB,EACxB,OAAO,EAAC,gCAAgC,EACxC,WAAW,EAAC,aAAa,EACzB,UAAU,QACV,KAAK,EAAE,EAAE,GACT,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAU,eAAe,CAC3C;IACE,MAAM,EAAE,0BAA0B;IAClC,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;KAC5B;CACF,EACD,gJAAgJ,CACjJ,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAU,eAAe,CACrD;IACE,MAAM,EAAE,yBAAyB;IACjC,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;KAC5B;CACF,EACD,qHAAqH,CACtH,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAU,eAAe,CACzC;IACE,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;KAC5B;CACF,EACD,8EAA8E,CAC/E,CAAC"}

package/dist/components/widgetFavourites/WidgetFavourites.test.d.ts

@@ -0,0 +1,2 @@
+import '@testing-library/jest-dom/vitest';
+//# sourceMappingURL=WidgetFavourites.test.d.ts.map

package/dist/components/widgetFavourites/WidgetFavourites.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetFavourites.test.d.ts","sourceRoot":"","sources":["../../../src/components/widgetFavourites/WidgetFavourites.test.tsx"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC"}

package/dist/components/widgetFavourites/WidgetFavourites.test.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import '@testing-library/jest-dom/vitest';
+import { fireEvent, render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { Tooltip as TooltipPrimitive } from 'radix-ui';
+import { describe, expect, test, vi } from 'vitest';
+import { WidgetFavourites } from './WidgetFavourites.js';
+const mockItems = [
+    { id: 'daily', label: 'Daily Attendance', href: '/attendance/daily' },
+    { id: 'reports', label: 'Assessment Reports', href: '/reports' },
+];
+describe('WidgetFavourites', () => {
+    test('renders list items with links', () => {
+        render(_jsx(WidgetFavourites, { heading: "Favourites", items: mockItems }));
+        expect(screen.getByRole('heading', { name: 'Favourites' })).toBeInTheDocument();
+        expect(screen.getByRole('link', { name: 'Daily Attendance' })).toHaveAttribute('href', '/attendance/daily');
+        expect(screen.getByRole('link', { name: 'Assessment Reports' })).toHaveAttribute('href', '/reports');
+    });
+    test('remove button is sibling of link, not nested inside it', () => {
+        render(_jsx(WidgetFavourites, { heading: "Favourites", items: mockItems, onRemoveItem: vi.fn() }));
+        const link = screen.getByRole('link', { name: 'Daily Attendance' });
+        const removeButton = screen.getByTestId('widget-favourites-remove-daily');
+        expect(link.contains(removeButton)).toBe(false);
+        expect(removeButton).toHaveClass('ds-favourite-button', 'ds-favourite-button--remove');
+        expect(link.closest('.ds-widget-favourites__item')).toContainElement(removeButton);
+    });
+    test('calls onRemoveItem with item id when remove is clicked', () => {
+        const onRemoveItem = vi.fn();
+        render(_jsx(WidgetFavourites, { heading: "Favourites", items: mockItems, onRemoveItem: onRemoveItem }));
+        fireEvent.click(screen.getByTestId('widget-favourites-remove-daily'));
+        expect(onRemoveItem).toHaveBeenCalledWith('daily');
+    });
+    test('renders empty state when items is empty', () => {
+        render(_jsx(WidgetFavourites, { heading: "Favourites", items: [] }));
+        expect(screen.getByRole('heading', { name: 'No favourites yet' })).toBeInTheDocument();
+        expect(screen.queryByRole('listitem')).not.toBeInTheDocument();
+    });
+    test('applies floating modifier when isFloating is true', () => {
+        const { container } = render(_jsx(WidgetFavourites, { heading: "Favourites", items: mockItems, isFloating: true }));
+        expect(container.querySelector('.ds-widget--floating')).toBeInTheDocument();
+    });
+    test('renders linked widget header when headingHref is provided', () => {
+        render(_jsx(WidgetFavourites, { heading: "Favourites (2)", headingHref: "/favourites", items: mockItems }));
+        expect(screen.getByRole('link', { name: 'Favourites (2)' })).toHaveAttribute('href', '/favourites');
+    });
+    test('uses default remove label on remove button', () => {
+        render(_jsx(WidgetFavourites, { heading: "Favourites", items: mockItems, onRemoveItem: vi.fn() }));
+        expect(screen.getByTestId('widget-favourites-remove-daily')).toHaveAttribute('aria-label', 'Remove from favourites');
+    });
+    test('uses custom removeLabel on item', () => {
+        render(_jsx(WidgetFavourites, { heading: "Favourites", items: [{
+                    id: 'daily',
+                    label: 'Daily Attendance',
+                    href: '/attendance/daily',
+                    removeLabel: 'Unstar Daily Attendance',
+                }], onRemoveItem: vi.fn() }));
+        expect(screen.getByRole('button', { name: 'Unstar Daily Attendance' })).toBeInTheDocument();
+    });
+    test('WidgetFavourites.Item renders standalone list item', async () => {
+        const onRemove = vi.fn();
+        const user = userEvent.setup();
+        render(_jsx(TooltipPrimitive.Provider, { delayDuration: 400, children: _jsx("ul", { children: _jsx(WidgetFavourites.Item, { id: "daily", label: "Daily Attendance", href: "/attendance/daily", onRemove: onRemove }) }) }));
+        await user.click(screen.getByTestId('widget-favourites-remove-daily'));
+        expect(onRemove).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=WidgetFavourites.test.js.map

package/dist/components/widgetFavourites/WidgetFavourites.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetFavourites.test.js","sourceRoot":"","sources":["../../../src/components/widgetFavourites/WidgetFavourites.test.tsx"],"names":[],"mappings":"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"}