@bridgeline-digital/hawksearch-handlebars-ui 5.0.0-beta.5 → 5.0.0

package/changelog.md

@@ -15,6 +15,13 @@
 1. Modified JSON structure for field mapping configuration
 2. The `attributes` collection on recommendation items now consists of the data in `customDict` from the API response rather than preserving `customDict` as a nested property
 
+# 4.0.4
+
+1. Modified RecommendationsService to transform response properties into arrays to be consistent with search results and autocomplete
+2. Modified `attributes` property on `RecommendationsItem` to include only the properties from `customDict` on the API response. The other properties from the response are standard so repeating them under `attributes` does not make sense.
+3. Fixed bug with autocomplete top categories links not working when not on search results page
+4. Fixed parameter name in order tracking event data
+
 # 4.0.3
 
 1. Fixed URL parsing logic to avoid prepending domain when API returns a value starting with `//`

package/dist/components/base.component.d.ts

@@ -1,139 +1,139 @@
-import { BaseComponentConfig, HawkSearchComponents } from '@configuration';
-import { BaseComponentModel } from '@models';
-/**
- * @typeParam TConfig Component configuration
- * @typeParam TData Component data
- * @typeParam TModel Data bound to Handlebars template
- *
- * @noInheritDoc
- * @category Base
- */
-export declare abstract class BaseComponent<TConfig extends BaseComponentConfig, TData, TModel extends BaseComponentModel> extends HTMLElement {
-    /**
-     * Optional instance-level configuration to override the global configuration
-     */
-    configOverride?: TConfig;
-    /**
-     * The data bound to the component.
-     */
-    data?: TData;
-    /**
-     * The Handlebars reference shared by all HawkSearch components.
-     */
-    protected handlebars: typeof Handlebars;
-    /**
-     * For components that may have multiple instances with different data sources, this property is used to identify the subset of data used for binding.
-     *
-     * @internal
-     */
-    protected eventFilter?: string;
-    /**
-     * The data bound to the Handlebars template.
-     */
-    protected contentModel?: TModel;
-    /**
-     * The name of the component. This value is appended to `hawksearch-` to determine the tag name. For example, a value of `search-results` would be rendered by `<hawksearch-search-results>`.
-     *
-     * @internal
-     */
-    protected abstract componentName: keyof HawkSearchComponents;
-    /**
-     * The default Handlebars template.
-     *
-     * @internal
-     */
-    protected abstract defaultHtml: string;
-    /**
-     * Determines whether the component is bound by an event. If `false`, binding is performed by the parent component.
-     *
-     * @internal
-     */
-    protected abstract bindFromEvent: boolean;
-    /**
-     * The optional configuration object for this component.
-     */
-    protected get configuration(): TConfig | undefined;
-    /**
-     * Whether or not the component is rendered within the Shadow DOM. In order of preference, this is specified by {@link configuration} or {@link Models.HawkSearchConfig.shadowDom}.
-     *
-     * @internal
-     * @defaultValue `true`
-     */
-    protected get shadowDom(): boolean;
-    /**
-     * The root element which should be used for querying any child elements. This resolves to `this.shadowRoot` if the Shadow DOM is enabled, otherwise `this`.
-     */
-    get rootElement(): ParentNode;
-    /**
-     * The name of the event that this component listens to for data binding. if {@link bindFromEvent} is `true`, this prepends `hawksearch:bind-` to {@link componentName} and appends :{@link eventFilter}, if specified.
-     *
-     * @internal
-     */
-    private get eventName();
-    /**
-     * @internal
-     */
-    private bindEventHandler?;
-    /**
-     * @internal
-     */
-    private template;
-    /**
-     * @ignore
-     */
-    connectedCallback(): void;
-    /**
-     * @ignore
-     */
-    disconnectedCallback(): void;
-    /**
-     * Optional method that can be overwritten to register Handlebars helper functions which can be accessed from the template. For more information, see [Custom Helpers](https://handlebarsjs.com/guide/#custom-helpers).
-     *
-     * @virtual
-     */
-    protected registerHelpers(): void;
-    /**
-     * Binds {@link contentModel} to the Handlebars template and renders the resulting HTML content.
-     */
-    render(): void;
-    /**
-     * Determines whether the {@link data} meets the necessary conditions to perform data binding and render content.
-     *
-     * @virtual
-     * @returns Whether the component should be rendered. If `false`, the component will have empty contents and be set to `display: none;`.
-     */
-    protected renderContent(): boolean;
-    /**
-     * Gets the data to be bound to the Handlebars template.
-     *
-     * @internal
-     * @returns The data bound to the Handlebars template.
-     */
-    protected abstract getContentModel(): TModel;
-    /**
-     * After the component is rendered, this method is called to bind any child components.
-     *
-     * @virtual
-     */
-    protected bindChildElements(): void;
-    /**
-     * After the component is rendered, this method is called for any additional processing (such as attaching event listeners) which needs to occur.
-     *
-     * @virtual
-     */
-    protected onRender(): void;
-    /**
-     * @returns The Handlebars template HTML. In order of preference, this is specified by the child contents of the HTML element, the template specified by {@link configuration}, or the default template for the component.
-     *
-     * @internal
-     */
-    private getCustomTemplateHtml;
-    /**
-     * Replaces placeholders in a given string with values from a data object.
-     *
-     * @param template The template string.
-     * @param values The object containing properties which will be bound to `template`.
-     * @returns The `template` string with all placeholders replaced by the values specified in `values`.
-     */
-    protected interpolate(template: string, values: Record<string, string>): string;
-}
+import { BaseComponentConfig, HawkSearchComponents } from '@configuration';
+import { BaseComponentModel } from '@models';
+/**
+ * @typeParam TConfig Component configuration
+ * @typeParam TData Component data
+ * @typeParam TModel Data bound to Handlebars template
+ *
+ * @noInheritDoc
+ * @category Base
+ */
+export declare abstract class BaseComponent<TConfig extends BaseComponentConfig, TData, TModel extends BaseComponentModel> extends HTMLElement {
+    /**
+     * Optional instance-level configuration to override the global configuration
+     */
+    configOverride?: TConfig;
+    /**
+     * The data bound to the component.
+     */
+    data?: TData;
+    /**
+     * The Handlebars reference shared by all HawkSearch components.
+     */
+    protected handlebars: typeof Handlebars;
+    /**
+     * For components that may have multiple instances with different data sources, this property is used to identify the subset of data used for binding.
+     *
+     * @internal
+     */
+    protected eventFilter?: string;
+    /**
+     * The data bound to the Handlebars template.
+     */
+    protected contentModel?: TModel;
+    /**
+     * The name of the component. This value is appended to `hawksearch-` to determine the tag name. For example, a value of `search-results` would be rendered by `<hawksearch-search-results>`.
+     *
+     * @internal
+     */
+    protected abstract componentName: keyof HawkSearchComponents;
+    /**
+     * The default Handlebars template.
+     *
+     * @internal
+     */
+    protected abstract defaultHtml: string;
+    /**
+     * Determines whether the component is bound by an event. If `false`, binding is performed by the parent component.
+     *
+     * @internal
+     */
+    protected abstract bindFromEvent: boolean;
+    /**
+     * The optional configuration object for this component.
+     */
+    protected get configuration(): TConfig | undefined;
+    /**
+     * Whether or not the component is rendered within the Shadow DOM. In order of preference, this is specified by {@link configuration} or {@link Models.HawkSearchConfig.shadowDom}.
+     *
+     * @internal
+     * @defaultValue `true`
+     */
+    protected get shadowDom(): boolean;
+    /**
+     * The root element which should be used for querying any child elements. This resolves to `this.shadowRoot` if the Shadow DOM is enabled, otherwise `this`.
+     */
+    get rootElement(): ParentNode;
+    /**
+     * The name of the event that this component listens to for data binding. if {@link bindFromEvent} is `true`, this prepends `hawksearch:bind-` to {@link componentName} and appends :{@link eventFilter}, if specified.
+     *
+     * @internal
+     */
+    private get eventName();
+    /**
+     * @internal
+     */
+    private bindEventHandler?;
+    /**
+     * @internal
+     */
+    private template;
+    /**
+     * @ignore
+     */
+    connectedCallback(): void;
+    /**
+     * @ignore
+     */
+    disconnectedCallback(): void;
+    /**
+     * Optional method that can be overwritten to register Handlebars helper functions which can be accessed from the template. For more information, see [Custom Helpers](https://handlebarsjs.com/guide/#custom-helpers).
+     *
+     * @virtual
+     */
+    protected registerHelpers(): void;
+    /**
+     * Binds {@link contentModel} to the Handlebars template and renders the resulting HTML content.
+     */
+    render(): void;
+    /**
+     * Determines whether the {@link data} meets the necessary conditions to perform data binding and render content.
+     *
+     * @virtual
+     * @returns Whether the component should be rendered. If `false`, the component will have empty contents and be set to `display: none;`.
+     */
+    protected renderContent(): boolean;
+    /**
+     * Gets the data to be bound to the Handlebars template.
+     *
+     * @internal
+     * @returns The data bound to the Handlebars template.
+     */
+    protected abstract getContentModel(): TModel;
+    /**
+     * After the component is rendered, this method is called to bind any child components.
+     *
+     * @virtual
+     */
+    protected bindChildElements(): void;
+    /**
+     * After the component is rendered, this method is called for any additional processing (such as attaching event listeners) which needs to occur.
+     *
+     * @virtual
+     */
+    protected onRender(): void;
+    /**
+     * @returns The Handlebars template HTML. In order of preference, this is specified by the child contents of the HTML element, the template specified by {@link configuration}, or the default template for the component.
+     *
+     * @internal
+     */
+    private getCustomTemplateHtml;
+    /**
+     * Replaces placeholders in a given string with values from a data object.
+     *
+     * @param template The template string.
+     * @param values The object containing properties which will be bound to `template`.
+     * @returns The `template` string with all placeholders replaced by the values specified in `values`.
+     */
+    protected interpolate(template: string, values: Record<string, string>): string;
+}

package/dist/components/content/content-types/base-content.component.d.ts

@@ -1,9 +1,9 @@
-import { BaseComponent } from '@components';
-import { BaseComponentConfig } from '@configuration';
-import { BaseComponentModel, ContentType } from '@models';
-/**
- * @category Content
- */
-export declare abstract class BaseContentComponent<TConfig extends BaseComponentConfig, TData extends ContentType, TModel extends BaseComponentModel> extends BaseComponent<TConfig, TData, TModel> {
-    protected bindFromEvent: boolean;
-}
+import { BaseComponent } from '@components';
+import { BaseComponentConfig } from '@configuration';
+import { BaseComponentModel, ContentType } from '@models';
+/**
+ * @category Content
+ */
+export declare abstract class BaseContentComponent<TConfig extends BaseComponentConfig, TData extends ContentType, TModel extends BaseComponentModel> extends BaseComponent<TConfig, TData, TModel> {
+    protected bindFromEvent: boolean;
+}

package/dist/components/content/content-types/custom-content/custom-content.component.d.ts

@@ -1,21 +1,21 @@
-import { CustomContentComponentConfig, HawkSearchComponents } from '@configuration';
-import { CustomContent, CustomContentComponentModel } from '@models';
-import { BaseContentComponent } from '../base-content.component';
-/**
- * The Custom Content component renders HTML defined in HawkSearch.
- *
- * ## Tag
- * The tag for this component is `<hawksearch-custom-content>`.
- *
- * ## Default Template
- * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
- * {@embed ./custom-content.component.hbs}
- *
- * @category Content
- */
-export declare class CustomContentComponent extends BaseContentComponent<CustomContentComponentConfig, CustomContent, CustomContentComponentModel> {
-    protected componentName: keyof HawkSearchComponents;
-    protected defaultHtml: any;
-    protected renderContent(): boolean;
-    protected getContentModel(): CustomContentComponentModel;
-}
+import { CustomContentComponentConfig, HawkSearchComponents } from '@configuration';
+import { CustomContent, CustomContentComponentModel } from '@models';
+import { BaseContentComponent } from '../base-content.component';
+/**
+ * The Custom Content component renders HTML defined in HawkSearch.
+ *
+ * ## Tag
+ * The tag for this component is `<hawksearch-custom-content>`.
+ *
+ * ## Default Template
+ * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
+ * {@embed ./custom-content.component.hbs}
+ *
+ * @category Content
+ */
+export declare class CustomContentComponent extends BaseContentComponent<CustomContentComponentConfig, CustomContent, CustomContentComponentModel> {
+    protected componentName: keyof HawkSearchComponents;
+    protected defaultHtml: any;
+    protected renderContent(): boolean;
+    protected getContentModel(): CustomContentComponentModel;
+}

package/dist/components/content/content-types/featured-items-content/featured-items-content.component.d.ts

@@ -1,22 +1,22 @@
-import { FeaturedItemsContentComponentConfig, HawkSearchComponents } from '@configuration';
-import { FeaturedItemsContent, FeaturedItemsContentComponentModel } from '@models';
-import { BaseContentComponent } from '../base-content.component';
-/**
- * The Featured Items Content component renders a custom list of search results (typically products) defined as Spotlights in HawkSearch. This is commonly used to display a default set of products when a query returns no results.
- *
- * ## Tag
- * The tag for this component is `<hawksearch-featured-items-content>`.
- *
- * ## Default Template
- * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
- * {@embed ./featured-items-content.component.hbs}
- *
- * @category Content
- */
-export declare class FeaturedItemsContentComponent extends BaseContentComponent<FeaturedItemsContentComponentConfig, FeaturedItemsContent, FeaturedItemsContentComponentModel> {
-    protected componentName: keyof HawkSearchComponents;
-    protected defaultHtml: any;
-    protected renderContent(): boolean;
-    protected getContentModel(): FeaturedItemsContentComponentModel;
-    protected bindChildElements(): void;
-}
+import { FeaturedItemsContentComponentConfig, HawkSearchComponents } from '@configuration';
+import { FeaturedItemsContent, FeaturedItemsContentComponentModel } from '@models';
+import { BaseContentComponent } from '../base-content.component';
+/**
+ * The Featured Items Content component renders a custom list of search results (typically products) defined as Spotlights in HawkSearch. This is commonly used to display a default set of products when a query returns no results.
+ *
+ * ## Tag
+ * The tag for this component is `<hawksearch-featured-items-content>`.
+ *
+ * ## Default Template
+ * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
+ * {@embed ./featured-items-content.component.hbs}
+ *
+ * @category Content
+ */
+export declare class FeaturedItemsContentComponent extends BaseContentComponent<FeaturedItemsContentComponentConfig, FeaturedItemsContent, FeaturedItemsContentComponentModel> {
+    protected componentName: keyof HawkSearchComponents;
+    protected defaultHtml: any;
+    protected renderContent(): boolean;
+    protected getContentModel(): FeaturedItemsContentComponentModel;
+    protected bindChildElements(): void;
+}

package/dist/components/content/content-types/featured-items-content-item/featured-items-content-item.component.d.ts

@@ -1,39 +1,39 @@
-import { BaseComponent } from '@components';
-import { FeaturedItemsContentItemComponentConfig, HawkSearchComponents } from '@configuration';
-import { FeaturedItemsContentItem, FeaturedItemsContentItemComponentModel } from '@models';
-/**
- * The Featured Items Content Item component displays information for an individual product or page.
- *
- * ## Tag
- * The tag for this component is `<hawksearch-featured-items-content>`.
- *
- * ## Event-Binding Attributes
- * ### Images
- * | Name | Value |
- * | :- | :- |
- * | hawksearch-image | |
- *
- * Image elements with this attribute will have their src value replaced with a placeholder image URL if the image fails to load.
- *
- * ### Links
- * | Name | Value |
- * | :- | :- |
- * | hawksearch-link | |
- *
- * Anchor elements with this attribute will be tracked when clicked.
- *
- * ## Default Template
- * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
- * {@embed ./featured-items-content-item.component.hbs}
- *
- * @category Content
- */
-export declare class FeaturedItemsContentItemComponent extends BaseComponent<FeaturedItemsContentItemComponentConfig, FeaturedItemsContentItem, FeaturedItemsContentItemComponentModel> {
-    trackingEnabled: boolean;
-    protected componentName: keyof HawkSearchComponents;
-    protected defaultHtml: any;
-    protected bindFromEvent: boolean;
-    protected renderContent(): boolean;
-    protected getContentModel(): FeaturedItemsContentItemComponentModel;
-    protected onRender(): void;
-}
+import { BaseComponent } from '@components';
+import { FeaturedItemsContentItemComponentConfig, HawkSearchComponents } from '@configuration';
+import { FeaturedItemsContentItem, FeaturedItemsContentItemComponentModel } from '@models';
+/**
+ * The Featured Items Content Item component displays information for an individual product or page.
+ *
+ * ## Tag
+ * The tag for this component is `<hawksearch-featured-items-content>`.
+ *
+ * ## Event-Binding Attributes
+ * ### Images
+ * | Name | Value |
+ * | :- | :- |
+ * | hawksearch-image | |
+ *
+ * Image elements with this attribute will have their src value replaced with a placeholder image URL if the image fails to load.
+ *
+ * ### Links
+ * | Name | Value |
+ * | :- | :- |
+ * | hawksearch-link | |
+ *
+ * Anchor elements with this attribute will be tracked when clicked.
+ *
+ * ## Default Template
+ * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
+ * {@embed ./featured-items-content-item.component.hbs}
+ *
+ * @category Content
+ */
+export declare class FeaturedItemsContentItemComponent extends BaseComponent<FeaturedItemsContentItemComponentConfig, FeaturedItemsContentItem, FeaturedItemsContentItemComponentModel> {
+    trackingEnabled: boolean;
+    protected componentName: keyof HawkSearchComponents;
+    protected defaultHtml: any;
+    protected bindFromEvent: boolean;
+    protected renderContent(): boolean;
+    protected getContentModel(): FeaturedItemsContentItemComponentModel;
+    protected onRender(): void;
+}

package/dist/components/content/content-types/image-content/image-content.component.d.ts

@@ -1,22 +1,22 @@
-import { HawkSearchComponents, ImageContentComponentConfig } from '@configuration';
-import { ImageContent, ImageContentComponentModel } from '@models';
-import { BaseContentComponent } from '../base-content.component';
-/**
- * The Image Content component displays an image defined in HawkSearch.
- *
- * ## Tag
- * The tag for this component is `<hawksearch-image-content>`.
- *
- * ## Default Template
- * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
- * {@embed ./image-content.component.hbs}
- *
- * @category Content
- */
-export declare class ImageContentComponent extends BaseContentComponent<ImageContentComponentConfig, ImageContent, ImageContentComponentModel> {
-    protected componentName: keyof HawkSearchComponents;
-    protected defaultHtml: any;
-    protected renderContent(): boolean;
-    protected getContentModel(): ImageContentComponentModel;
-    protected onRender(): void;
-}
+import { HawkSearchComponents, ImageContentComponentConfig } from '@configuration';
+import { ImageContent, ImageContentComponentModel } from '@models';
+import { BaseContentComponent } from '../base-content.component';
+/**
+ * The Image Content component displays an image defined in HawkSearch.
+ *
+ * ## Tag
+ * The tag for this component is `<hawksearch-image-content>`.
+ *
+ * ## Default Template
+ * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
+ * {@embed ./image-content.component.hbs}
+ *
+ * @category Content
+ */
+export declare class ImageContentComponent extends BaseContentComponent<ImageContentComponentConfig, ImageContent, ImageContentComponentModel> {
+    protected componentName: keyof HawkSearchComponents;
+    protected defaultHtml: any;
+    protected renderContent(): boolean;
+    protected getContentModel(): ImageContentComponentModel;
+    protected onRender(): void;
+}

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

@@ -1,6 +1,6 @@
-export * from './base-content.component';
-export * from './custom-content/custom-content.component';
-export * from './featured-items-content/featured-items-content.component';
-export * from './featured-items-content-item/featured-items-content-item.component';
-export * from './image-content/image-content.component';
-export * from './popular-queries-content/popular-queries-content.component';
+export * from './base-content.component';
+export * from './custom-content/custom-content.component';
+export * from './featured-items-content/featured-items-content.component';
+export * from './featured-items-content-item/featured-items-content-item.component';
+export * from './image-content/image-content.component';
+export * from './popular-queries-content/popular-queries-content.component';

package/dist/components/content/content-types/popular-queries-content/popular-queries-content.component.d.ts

@@ -1,22 +1,22 @@
-import { HawkSearchComponents, PopularQueriesContentComponentConfig } from '@configuration';
-import { PopularQueriesContent, PopularQueriesContentComponentModel } from '@models';
-import { BaseContentComponent } from '../base-content.component';
-/**
- * The Popular Queries Content component renders a tag cloud of popular queries relating to the current query. Each link is weighted according to its search frequency, with the most popular queries displayed in the largest font size.
- *
- * ## Tag
- * The tag for this component is `<hawksearch-popular-queries-content>`.
- *
- * ## Default Template
- * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
- * {@embed ./popular-queries-content.component.hbs}
- *
- * @category Content
- */
-export declare class PopularQueriesContentComponent extends BaseContentComponent<PopularQueriesContentComponentConfig, PopularQueriesContent, PopularQueriesContentComponentModel> {
-    protected componentName: keyof HawkSearchComponents;
-    protected defaultHtml: any;
-    protected renderContent(): boolean;
-    protected getContentModel(): PopularQueriesContentComponentModel;
-    protected onRender(): void;
-}
+import { HawkSearchComponents, PopularQueriesContentComponentConfig } from '@configuration';
+import { PopularQueriesContent, PopularQueriesContentComponentModel } from '@models';
+import { BaseContentComponent } from '../base-content.component';
+/**
+ * The Popular Queries Content component renders a tag cloud of popular queries relating to the current query. Each link is weighted according to its search frequency, with the most popular queries displayed in the largest font size.
+ *
+ * ## Tag
+ * The tag for this component is `<hawksearch-popular-queries-content>`.
+ *
+ * ## Default Template
+ * The following is the default Handlebars template for this component. To create a custom template, it is recommended to use this as a starting point.
+ * {@embed ./popular-queries-content.component.hbs}
+ *
+ * @category Content
+ */
+export declare class PopularQueriesContentComponent extends BaseContentComponent<PopularQueriesContentComponentConfig, PopularQueriesContent, PopularQueriesContentComponentModel> {
+    protected componentName: keyof HawkSearchComponents;
+    protected defaultHtml: any;
+    protected renderContent(): boolean;
+    protected getContentModel(): PopularQueriesContentComponentModel;
+    protected onRender(): void;
+}