@nnc-digital/nnc-design-system 1.0.0-beta2 → 1.0.0-beta21

package/build/library/components/NoResultsTemplate/NoResultsTemplate.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { NoResultsTemplateProps } from './NoResultsTemplate.types';
+declare const NoResultsTemplate: React.FunctionComponent<NoResultsTemplateProps>;
+export default NoResultsTemplate;

package/build/library/components/NoResultsTemplate/NoResultsTemplate.types.d.ts

@@ -0,0 +1,6 @@
+export interface NoResultsTemplateProps {
+    /**
+     * The type of content being searched (e.g., 'events', 'results')
+     */
+    contentType?: string;
+}

package/build/library/components/NoResultsTemplate/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './NoResultsTemplate';
+export * from './NoResultsTemplate.types';

package/build/library/components/PromotedLinks/PromotedLinks.types.d.ts

@@ -17,4 +17,8 @@ export interface PromotedLinkProp {
      * The url of the link
      */
     url: string;
+    /**
+     * The key of the icon (optional)
+     */
+    iconKey?: string;
 }

package/build/library/components/StaticMap/StaticMap.types.d.ts

@@ -23,6 +23,10 @@ export interface StaticMapProps {
      * The optional zoom level, between 1 and 20. 1 = world, 20 = buildings
      */
     zoom?: number;
+    /**
+     * Optional Google Maps API key. Falls back to config if not provided.
+     */
+    apiKey?: string;
 }
 export interface MapMarkerProps {
     /**

package/build/library/components/SummaryList/SummaryList.types.d.ts

@@ -8,6 +8,14 @@ export interface SummaryListProps {
      * Option to remove margin (default is true)
      */
     hasMargin?: boolean;
+    /**
+     * Option to show borders (default is true)
+     */
+    hasBorders?: boolean;
+    /**
+     * Optional heading for the summary list
+     */
+    heading?: string;
 }
 export interface SummaryRowProps {
     /**

package/build/library/contexts/ConfigContext/ConfigContext.d.ts

@@ -0,0 +1,7 @@
+import React, { ReactNode } from 'react';
+import { DesignSystemConfig } from '../../../types/config';
+export declare const DesignSystemProvider: React.FC<{
+    config: DesignSystemConfig;
+    children: ReactNode;
+}>;
+export declare const useConfig: () => DesignSystemConfig;

package/build/library/directory/DirectoryServiceList/DirectoryServiceList.types.d.ts

@@ -105,6 +105,11 @@ export interface DirectoryServiceListProps {
      * Is the component in error state
      */
     isError?: boolean;
+    /**
+     * Custom HTML content to display when no results are found.
+     * If not provided, defaults to "No results found" message.
+     */
+    noResultsContent?: string;
 }
 export interface DirectoryCategory {
     /**

package/build/library/events/Event/Event.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { EventProps } from './Event.types';
+declare const Event: React.FunctionComponent<EventProps>;
+export default Event;

package/build/library/events/Event/Event.storydata.d.ts

@@ -0,0 +1,4 @@
+import { EventProps } from './Event.types';
+export declare const ExampleEvent: EventProps;
+export declare const ExampleVirtualEvent: EventProps;
+export declare const ExampleEvents: EventProps[];

package/build/library/events/Event/Event.types.d.ts

@@ -0,0 +1,206 @@
+import React from 'react';
+import { FileDownloadProps } from '../../components/FileDownload/FileDownload.types';
+import { SocialProfile } from '../../directory/ServiceSocialLinks/ServiceSocialLinks.types';
+import { ServiceContactProps } from '../../directory/ServiceContact/ServiceContact.types';
+export interface EventProps {
+    /**
+     * The unique event id
+     */
+    id: string;
+    /**
+     * The event name/title
+     */
+    name: string;
+    /**
+     * The description as a plain HTML string
+     */
+    description: string;
+    /**
+     * The description as a react node
+     */
+    descriptionElement?: React.ReactNode;
+    /**
+     * The event start date and time in ISO format
+     */
+    startDateTime: string;
+    /**
+     * The event end date and time in ISO format
+     */
+    endDateTime?: string;
+    /**
+     * The event type/category
+     */
+    eventType?: string;
+    /**
+     * The target audience for the event
+     */
+    audience?: string[];
+    /**
+     * The organization hosting the event
+     */
+    organization: EventOrganizationProps;
+    /**
+     * Event location information
+     */
+    location?: EventLocationProps;
+    /**
+     * The optional service email address
+     */
+    email?: string;
+    /**
+     * The optional costs of the event
+     */
+    fees?: string;
+    /**
+     * The event website address
+     */
+    url?: string;
+    /**
+     * The event website url title
+     */
+    websiteUrlTitle?: string;
+    /**
+     * An array of contacts with phone numbers
+     */
+    contacts?: ServiceContactProps[];
+    /**
+     * An optional array of files/links belonging to the event
+     */
+    uploads?: FileDownloadProps[];
+    /**
+     * An optional array of social profile links
+     */
+    socialProfiles?: SocialProfile[];
+    /**
+     * When the event was updated. Expected format YYYY-MM-DD
+     */
+    updatedAt?: string;
+    /**
+     * The url to the shortlist
+     */
+    shortListPath?: string;
+    /**
+     * Is this event recurring?
+     */
+    isRecurring?: boolean;
+    /**
+     * Recurrence pattern information
+     */
+    recurrencePattern?: string;
+    /**
+     * Registration deadline
+     */
+    registrationDeadline?: string;
+    /**
+     * Maximum capacity for the event
+     */
+    capacity?: number;
+    /**
+     * Current number of registered attendees
+     */
+    currentAttendees?: number;
+}
+export interface EventOrganizationProps {
+    /**
+     * The unique identifier for the organization
+     */
+    id: string;
+    /**
+     * The name of the organization
+     */
+    name: string;
+    /**
+     * The description of the organization
+     */
+    description?: string;
+    /**
+     * The full path to the organization logo
+     */
+    logo?: string;
+    /**
+     * The organization website address
+     */
+    url?: string;
+}
+export interface EventLocationProps {
+    /**
+     * The unique identifier for the location
+     */
+    id: number;
+    /**
+     * The name of the location
+     */
+    name: string;
+    /**
+     * The optional description
+     */
+    description?: string;
+    /**
+     * Is the location visitable by the public?
+     */
+    isVisitable?: boolean;
+    /**
+     * The latitude of the location
+     */
+    latitude?: string;
+    /**
+     * The longitude of the location
+     */
+    longitude?: string;
+    /**
+     * The address information
+     */
+    address?: EventAddressProps;
+    /**
+     * An array of facilities that the location offers
+     */
+    accessibility?: EventAccessibilityProps[];
+    /**
+     * Is this a virtual/online event?
+     */
+    isVirtual?: boolean;
+    /**
+     * Virtual meeting link/information
+     */
+    virtualMeetingInfo?: string;
+}
+export interface EventAddressProps {
+    /**
+     * The unique identifier
+     */
+    id: number;
+    /**
+     * The street number and address line 1
+     */
+    address1: string;
+    /**
+     * Address line 2
+     */
+    address2?: string;
+    /**
+     * The city
+     */
+    city: string;
+    /**
+     * The county
+     */
+    county: string;
+    /**
+     * The postcode
+     */
+    postcode: string;
+    /**
+     * The country
+     */
+    country: string;
+}
+export interface EventAccessibilityProps {
+    /**
+     * The unique identifier
+     */
+    id: number;
+    /**
+     * The name of the facility offered by the location
+     */
+    accessibility: string;
+}

package/build/library/events/Event/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from './Event';
+export * from './Event.types';
+export * from './Event.storydata';

package/build/library/events/EventList/EventList.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { EventListProps } from './EventList.types';
+declare const EventList: React.FunctionComponent<EventListProps>;
+export default EventList;

package/build/library/events/EventList/EventList.storydata.d.ts

@@ -0,0 +1,3 @@
+import { EventCategory } from './EventList.types';
+export declare const ExampleEventTypes: EventCategory[];
+export declare const ExampleAudiences: EventCategory[];

package/build/{src/library/directory/DirectoryServiceList/DirectoryServiceList.types.d.ts → library/events/EventList/EventList.types.d.ts}

@@ -1,22 +1,18 @@
 import { Dispatch, SetStateAction } from 'react';
-import { DirectoryServiceProps } from '../DirectoryService/DirectoryService.types';
-export interface DirectoryServiceListProps {
+import { EventProps } from '../Event/Event.types';
+export interface EventListProps {
     /**
-     * Are the ages in months? Defaults to false
+     * The base url for the events directory
      */
-    ageInMonths?: boolean;
-    /**
-     * The base url for the directory
-     */
-    directoryPath: string;
+    eventsPath: string;
     /**
      * The url to the shortlist
      */
     shortListPath: string;
     /**
-     * An array of Directory Services
+     * An array of Events
      */
-    services: DirectoryServiceProps[];
+    events: EventProps[];
     /**
      * The search term string
      */
@@ -46,7 +42,7 @@ export interface DirectoryServiceListProps {
      */
     totalResults?: number;
     /**
-     * The total amount of pages
+     * The current page number
      */
     pageNumber?: number;
     /**
@@ -58,35 +54,43 @@ export interface DirectoryServiceListProps {
      */
     perPage?: number;
     /**
-     * The max length of each service description extract
+     * The max length of each event description extract
      */
     extractLength?: number;
     /**
-     * The filter categories
+     * The event type categories
+     */
+    eventTypes?: EventCategory[];
+    /**
+     * Function prop passed in to handle updating event types
+     */
+    setEventTypes: Dispatch<SetStateAction<EventCategory[]>>;
+    /**
+     * The audience categories
      */
-    categories?: DirectoryCategory[];
+    audiences?: EventCategory[];
     /**
-     * Function prop passed in to handle updating categories
+     * Function prop passed in to handle updating audiences
      */
-    setCategories: Dispatch<SetStateAction<DirectoryCategory[]>>;
+    setAudiences: Dispatch<SetStateAction<EventCategory[]>>;
     /**
-     * The minimum age filter
+     * The selected month filter (1-12)
      */
-    minimumAge?: number | string;
+    selectedMonth?: number;
     /**
-     * Function prop passed in to handle updating minimumAge
+     * Function prop passed in to handle updating selected month
      */
-    setMinimumAge: Dispatch<SetStateAction<number | string | undefined>>;
+    setSelectedMonth: Dispatch<SetStateAction<number | undefined>>;
     /**
-     * The maximum age filter
+     * The selected year filter
      */
-    maximumAge?: number | string;
+    selectedYear?: number;
     /**
-     * Function prop passed in to handle updating maximumAge
+     * Function prop passed in to handle updating selected year
      */
-    setMaximumAge: Dispatch<SetStateAction<number | string | undefined>>;
+    setSelectedYear: Dispatch<SetStateAction<number | undefined>>;
     /**
-     *  Where to centre the map, in the format 'lat,lng'
+     * Where to centre the map, in the format 'lat,lng'
      */
     mapCenter?: string;
     /**
@@ -97,16 +101,21 @@ export interface DirectoryServiceListProps {
      * Is the data loading
      */
     isLoading: boolean;
-    /**
-     * Does the directory have documents?
-     */
-    hasDocuments?: boolean;
     /**
      * Is the component in error state
      */
     isError?: boolean;
+    /**
+     * Should old events be hidden automatically? Defaults to true.
+     */
+    hideOldEvents?: boolean;
+    /**
+     * Custom HTML content to display when no events are found.
+     * If not provided, defaults to "No events found" message.
+     */
+    noResultsContent?: string;
 }
-export interface DirectoryCategory {
+export interface EventCategory {
     /**
      * The category label
      */
@@ -118,15 +127,15 @@ export interface DirectoryCategory {
     /**
      * An array of taxonomies
      */
-    options: DirectoryTaxonomy[];
+    options: EventTaxonomy[];
     /**
      * Should multiple options be allowed
      */
     singleSelection: boolean;
 }
-export interface DirectoryTaxonomy {
+export interface EventTaxonomy {
     /**
-     * Unique taxonomy identifier in curie format (e.g. localOffer1)
+     * Unique taxonomy identifier in curie format (e.g. eventType1)
      */
     id: string;
     /**

package/build/library/events/EventList/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from './EventList';
+export * from './EventList.types';
+export * from './EventList.storydata';

package/build/library/events/index.d.ts

@@ -0,0 +1,5 @@
+export { default as Event } from './Event';
+export { default as EventList } from './EventList';
+export * from './Event/Event.types';
+export * from './EventList/EventList.types';
+export * from './utils';

package/build/library/events/utils/EventFilters.d.ts

@@ -0,0 +1,57 @@
+import { EventProps } from '../Event/Event.types';
+/**
+ * Filters out events that have already ended based on their end date/time
+ * @param events Array of events to filter
+ * @param hideOldEvents Whether to hide old events (defaults to true)
+ * @returns Filtered array of events
+ */
+export declare const filterOldEvents: (events: EventProps[], hideOldEvents?: boolean) => EventProps[];
+/**
+ * Filters events by month and year
+ * @param events Array of events to filter
+ * @param selectedMonth Month (1-12) or undefined for all months
+ * @param selectedYear Year or undefined for all years
+ * @returns Filtered array of events
+ */
+export declare const filterEventsByDate: (events: EventProps[], selectedMonth?: number, selectedYear?: number) => EventProps[];
+/**
+ * Filters events by event type
+ * @param events Array of events to filter
+ * @param selectedEventTypes Array of selected event type IDs
+ * @returns Filtered array of events
+ */
+export declare const filterEventsByType: (events: EventProps[], selectedEventTypes: string[]) => EventProps[];
+/**
+ * Filters events by audience
+ * @param events Array of events to filter
+ * @param selectedAudiences Array of selected audience IDs
+ * @returns Filtered array of events
+ */
+export declare const filterEventsByAudience: (events: EventProps[], selectedAudiences: string[]) => EventProps[];
+/**
+ * Filters events by search term (searches in name and description)
+ * @param events Array of events to filter
+ * @param searchTerm Search term to look for
+ * @returns Filtered array of events
+ */
+export declare const filterEventsBySearch: (events: EventProps[], searchTerm: string) => EventProps[];
+/**
+ * Sorts events by date (earliest first)
+ * @param events Array of events to sort
+ * @returns Sorted array of events
+ */
+export declare const sortEventsByDate: (events: EventProps[]) => EventProps[];
+/**
+ * Comprehensive filter function that applies all filters
+ * @param events Array of events to filter
+ * @param filters Object containing all filter criteria
+ * @returns Filtered and sorted array of events
+ */
+export declare const applyAllEventFilters: (events: EventProps[], filters: {
+    hideOldEvents?: boolean;
+    selectedMonth?: number;
+    selectedYear?: number;
+    selectedEventTypes?: string[];
+    selectedAudiences?: string[];
+    searchTerm?: string;
+}) => EventProps[];

package/build/library/events/utils/index.d.ts

@@ -0,0 +1 @@
+export * from './EventFilters';

package/build/library/helpers/LazyImage.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+type VisibilitySensorProps = {
+    partialVisibility?: boolean;
+};
+type LazyImageProps = {
+    src: string;
+    placeholder?: string;
+    visibilitySensorProps?: VisibilitySensorProps;
+    children: (src: string) => React.ReactNode;
+};
+declare const LazyImage: React.FunctionComponent<LazyImageProps>;
+export default LazyImage;

package/build/library/helpers/api-helpers.d.ts

@@ -1,4 +1,5 @@
-export declare const PostcodeSearchApiUrl: string;
+import { DesignSystemConfig } from '../../types/config';
+export declare function getPostcodeSearchApiUrl(config?: DesignSystemConfig): string;
 export interface PostcodeResultsProps {
     /**
      * An array of addresses

package/build/library/pages/EventPage/EventPage.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { EventProps } from '../../events/Event/Event.types';
+import { BreadcrumbProp } from '../../structure/Breadcrumbs/Breadcrumbs.types';
+interface EventPageProps {
+    event: EventProps;
+    breadcrumbs?: BreadcrumbProp[];
+    footerLinks?: Array<{
+        title: string;
+        url: string;
+    }>;
+}
+export declare const EventPage: React.FunctionComponent<EventPageProps>;
+export {};

package/build/library/pages/EventPage/index.d.ts

@@ -0,0 +1 @@
+export { EventPage } from './EventPage';

package/build/library/pages/ServiceLandingPageExample/ServiceLandingPageExample.types.d.ts

@@ -4,6 +4,7 @@ import { HeroImageProps } from '../../structure/HeroImage/HeroImage.types';
 import { SectionLinksProps } from '../../structure/SectionLinks/SectionLinks.types';
 import { ServicesLinksListProps } from '../../structure/ServicesLinksList/ServicesLinksList.types';
 import { AlertBannerServiceProps } from '../../structure/AlertBannerService/AlertBannerService.types';
+import { AlertBannerProps } from '../../structure/AlertBanner/AlertBanner.types';
 export interface ServiceLandingPageExampleProps {
     /**
      * The Service landing page title
@@ -45,6 +46,10 @@ export interface ServiceLandingPageExampleProps {
      * Optional service alert banner
      */
     serviceAlert?: AlertBannerServiceProps;
+    /**
+     * Optional site-wide alert banner
+     */
+    siteAlert?: AlertBannerProps;
     /**
      * Optional heading icon
      */

package/build/library/slices/InquestSchedule/InquestSchedule.types.d.ts

@@ -21,9 +21,12 @@ export interface CaseAppointmentProps {
     courtroomFullAddress: string;
     appointmentType: string;
     startDateTime: string;
+    endDateTime?: string | null;
 }
 export declare enum CaseAppointmentType {
-    Hearing = "hearing",
+    Formal = "formal",
+    Hearing = "inquest hearing",
     Opening = "opening",
+    PreInquest = "pre-inquest review",
     Writing = "writing"
 }

package/build/library/slices/RoadworksList/RoadworksList.types.d.ts

@@ -45,4 +45,8 @@ export interface Roadwork {
      * The responsible organisation
      */
     responsibility: string;
+    /**
+     * Optional URL link for more information about the roadworks
+     */
+    urlLinkAddress?: string;
 }

package/build/library/structure/HomeHero/HomeHero.storydata.d.ts

@@ -12,3 +12,8 @@ export declare const HomeHeroPromotedLinks: {
     title: string;
     url: string;
 }[];
+export declare const HomeHeroMemorialPromotedLinks: {
+    title: string;
+    url: string;
+    iconKey: string;
+}[];

package/build/library/structure/MemorialHero/MemorialHero.types.d.ts

@@ -13,15 +13,15 @@ export interface MemorialHeroProps {
      */
     alt: string;
     /**
-     * The name of the sites theme
-     */
-    theme: object;
-    /**
-     * Pass through any children to be shown
+     * Pass through any children to be shown (condolence links)
      */
     children: React.ReactNode;
     /**
-     * Anthing in this section will be themed as defined
+     * Council services links section
      */
     councilServices: React.ReactNode;
+    /**
+     * Search suggestions for the search bar
+     */
+    searchSuggestions?: string[];
 }

package/build/types/config.d.ts

@@ -0,0 +1,10 @@
+export interface DesignSystemConfig {
+    postcodeSearchApiUrl?: string;
+    binCollectionApiBaseUrl?: string;
+    googleMapsApiKey?: string;
+    drupalAppApiBaseUrl?: string;
+    nextPublicPostcodeSearchApiUrl?: string;
+    nextPublicBinCollectionApiBaseUrl?: string;
+    nextPublicGoogleMapsApiKey?: string;
+    [key: string]: any;
+}