@universityofmaryland/web-feeds-library 1.2.6 → 1.3.0-beta.1

package/README.md

@@ -1,6 +1,6 @@
 # University of Maryland Feeds Library
 
-[![Feeds Version](https://img.shields.io/badge/Feeds-v1.2.6-blue)](https://www.npmjs.com/package/@universityofmaryland/web-feeds-library)
+[![Feeds Version](https://img.shields.io/badge/Feeds-v1.3.0-blue)](https://www.npmjs.com/package/@universityofmaryland/web-feeds-library)
 
 Dynamic content feed components for displaying University of Maryland news, events, and academic information with automatic updates, caching, and brand-compliant styling.
 

package/dist/academic.d.ts

@@ -1,2 +1,2 @@
-export * from './composite/academic/index'
+export * from './feeds/academic/index'
 export {}

package/dist/academic.js

@@ -1,5 +1,5 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const slider = require("./composite/academic/slider.js");
-exports.slider = slider;
+import { academicSlider } from "./feeds/academic/slider.js";
+export {
+  academicSlider as slider
+};
 //# sourceMappingURL=academic.js.map

package/dist/academic.js.map

@@ -1 +1 @@
-{"version":3,"file":"academic.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}
+{"version":3,"file":"academic.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/events.d.ts

@@ -1,2 +1,2 @@
-export * from './composite/events/index'
+export * from './feeds/events/index'
 export {}

package/dist/events.js

@@ -1,11 +1,11 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const grid = require("./composite/events/grid.js");
-const list = require("./composite/events/list.js");
-const slider = require("./composite/events/slider.js");
-const grouped = require("./composite/events/grouped.js");
-exports.grid = grid;
-exports.list = list;
-exports.slider = slider;
-exports.grouped = grouped;
+import { eventsGrid } from "./feeds/events/grid.js";
+import { eventsList } from "./feeds/events/list.js";
+import { eventsSlider } from "./feeds/events/slider.js";
+import { eventsGrouped } from "./feeds/events/grouped.js";
+export {
+  eventsGrid as grid,
+  eventsGrouped as grouped,
+  eventsList as list,
+  eventsSlider as slider
+};
 //# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}
+{"version":3,"file":"events.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/experts.d.ts

@@ -0,0 +1,2 @@
+export * from './feeds/experts/index'
+export {}

package/dist/experts.js

@@ -0,0 +1,9 @@
+import { expertsGrid } from "./feeds/experts/grid.js";
+import { expertsList } from "./feeds/experts/list.js";
+import { expertsBio } from "./feeds/experts/bio.js";
+export {
+  expertsBio as bio,
+  expertsGrid as grid,
+  expertsList as list
+};
+//# sourceMappingURL=experts.js.map

package/dist/experts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experts.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/factory/core/createBaseFeed.d.ts

@@ -0,0 +1,3 @@
+import { BaseFeedConfig, FeedFactoryResult } from './types';
+export declare function createBaseFeed<TData, TVariables = any>(config: BaseFeedConfig<TData, TVariables>): FeedFactoryResult;
+//# sourceMappingURL=createBaseFeed.d.ts.map

package/dist/factory/core/createBaseFeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBaseFeed.d.ts","sourceRoot":"","sources":["../../../source/factory/core/createBaseFeed.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAsB,MAAM,SAAS,CAAC;AAyChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,EACpD,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,GACxC,iBAAiB,CAoInB"}

package/dist/factory/core/createBaseFeed.js

@@ -0,0 +1,116 @@
+import { LoadingState } from "../../states/loading.js";
+import "@universityofmaryland/web-builder-library";
+import "@universityofmaryland/web-elements-library";
+import "@universityofmaryland/web-styles-library";
+import "@universityofmaryland/web-utilities-library/theme";
+import { createFeedHelpers } from "../helpers/feedHelpers.js";
+import { createDisplayHandlers } from "../helpers/displayHandler.js";
+import { createFetchHandlers } from "../helpers/fetchHandler.js";
+function createBaseFeed(config) {
+  const {
+    token,
+    isThemeDark = false,
+    isTransparent = false,
+    isOverlay = false,
+    isAligned = false,
+    isMediaTrained = null,
+    cardType,
+    numberOfColumnsToShow = 1,
+    numberOfRowsToStart,
+    isLazyLoad = false,
+    enableCategoryFallback = false,
+    categories,
+    entriesToRemove,
+    fetchStrategy,
+    displayStrategy,
+    layoutStrategy,
+    noResultsConfig,
+    imageConfig
+  } = config;
+  const container = document.createElement("div");
+  const loading = new LoadingState({ isThemeDark });
+  let styles = loading.styles;
+  const helpers = createFeedHelpers({
+    container,
+    initialStyles: styles
+  });
+  const originalSetStyles = helpers.setStyles;
+  helpers.setStyles = (additionalStyles) => {
+    styles += additionalStyles;
+    originalSetStyles(additionalStyles);
+  };
+  const shadowRootCallback = (shadow) => {
+    helpers.setShadowRoot(shadow);
+  };
+  const cardMappingOptions = {
+    isThemeDark,
+    isTransparent,
+    isOverlay,
+    isAligned,
+    imageConfig,
+    ...cardType && { cardType }
+  };
+  const layoutElement = layoutStrategy.create({
+    columns: numberOfColumnsToShow,
+    isThemeDark
+  });
+  helpers.setStyles(layoutElement.styles);
+  const baseProps = {
+    token,
+    categories,
+    entriesToRemove,
+    numberOfColumnsToShow,
+    numberOfRowsToStart,
+    isLazyLoad,
+    isMediaTrained,
+    getOffset: helpers.getOffset
+  };
+  const lazyLoadCallbackRef = {
+    current: void 0
+  };
+  const displayHandlers = createDisplayHandlers({
+    displayStrategy,
+    layoutStrategy,
+    helpers,
+    cardMappingOptions,
+    isLazyLoad,
+    numberOfColumnsToShow,
+    numberOfRowsToStart,
+    noResultsConfig: {
+      ...noResultsConfig,
+      isThemeDark
+      // Ensure theme is passed to EmptyState
+    },
+    // Pass a function that calls the current callback
+    lazyLoadCallback: isLazyLoad ? async () => {
+      if (lazyLoadCallbackRef.current) {
+        await lazyLoadCallbackRef.current();
+      }
+    } : void 0
+  });
+  const fetchHandlers = createFetchHandlers({
+    fetchStrategy,
+    helpers,
+    baseProps,
+    displayHandlers,
+    layoutElement,
+    isThemeDark,
+    enableCategoryFallback
+  });
+  lazyLoadCallbackRef.current = fetchHandlers.loadMore;
+  container.appendChild(loading.element);
+  fetchHandlers.start();
+  return {
+    element: container,
+    get styles() {
+      return styles;
+    },
+    events: {
+      callback: shadowRootCallback
+    }
+  };
+}
+export {
+  createBaseFeed
+};
+//# sourceMappingURL=createBaseFeed.js.map

package/dist/factory/core/createBaseFeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBaseFeed.js","sources":["../../../source/factory/core/createBaseFeed.ts"],"sourcesContent":["/**\n * Base Feed Factory\n *\n * Creates a complete feed with initialization, data fetching, and display logic.\n * Uses strategy pattern to allow customization of fetch, display, and layout.\n *\n * @module factory/core/createBaseFeed\n */\n\nimport { LoadingState } from '../../states';\nimport {\n  createFeedHelpers,\n  createDisplayHandlers,\n  createFetchHandlers,\n} from '../helpers';\nimport { BaseFeedConfig, FeedFactoryResult, CardMappingOptions } from './types';\n\n/**\n * Create a base feed using the factory pattern\n *\n * This factory eliminates ~70% of boilerplate code by handling:\n * - Feed initialization (container, loading, state)\n * - Strategy composition (fetch, display, layout)\n * - Lifecycle management (start, load more, no results)\n * - Shadow DOM support\n * - Event system\n *\n * @template TData - The type of entry data from the API\n * @template TVariables - The type of API variables\n *\n * @param config - Configuration for the feed\n * @returns ElementModel with feed element and styles\n *\n * @example\n * ```typescript\n * // Simple grid feed\n * const eventsFeed = createBaseFeed({\n *   token: 'my-token',\n *   isThemeDark: false,\n *   numberOfColumnsToShow: 3,\n *   numberOfRowsToStart: 2,\n *   isLazyLoad: true,\n *   fetchStrategy: eventsFetchStrategy,\n *   displayStrategy: eventsDisplayStrategy,\n *   layoutStrategy: gridGapLayout,\n *   imageConfig: (entry) => ({\n *     imageUrl: entry.image[0].url,\n *     altText: entry.image[0].altText,\n *     linkUrl: entry.url,\n *   }),\n * });\n *\n * // Use the feed\n * document.body.appendChild(eventsFeed.element);\n * ```\n */\nexport function createBaseFeed<TData, TVariables = any>(\n  config: BaseFeedConfig<TData, TVariables>,\n): FeedFactoryResult {\n  const {\n    token,\n    isThemeDark = false,\n    isTransparent = false,\n    isOverlay = false,\n    isAligned = false,\n    isMediaTrained = null,\n    cardType,\n    numberOfColumnsToShow = 1,\n    numberOfRowsToStart,\n    isLazyLoad = false,\n    enableCategoryFallback = false,\n    categories,\n    entriesToRemove,\n    fetchStrategy,\n    displayStrategy,\n    layoutStrategy,\n    noResultsConfig,\n    imageConfig,\n  } = config;\n\n  const container = document.createElement('div');\n  const loading = new LoadingState({ isThemeDark });\n  let styles = loading.styles;\n\n  // Create helpers for state management\n  const helpers = createFeedHelpers({\n    container,\n    initialStyles: styles,\n  });\n\n  // Override setStyles to also update the local styles variable\n  const originalSetStyles = helpers.setStyles;\n  helpers.setStyles = (additionalStyles: string) => {\n    styles += additionalStyles;\n    originalSetStyles(additionalStyles);\n  };\n\n  // Shadow root support\n  let shadowRoot: ShadowRoot | null = null;\n  const shadowRootCallback = (shadow: ShadowRoot) => {\n    shadowRoot = shadow;\n\n    helpers.setShadowRoot(shadow);\n  };\n\n  const cardMappingOptions: CardMappingOptions = {\n    isThemeDark,\n    isTransparent,\n    isOverlay,\n    isAligned,\n    imageConfig,\n    ...(cardType && { cardType }),\n  };\n\n  const layoutElement = layoutStrategy.create({\n    columns: numberOfColumnsToShow as 2 | 3 | 4,\n    isThemeDark,\n  });\n  helpers.setStyles(layoutElement.styles);\n\n  const baseProps = {\n    token,\n    categories,\n    entriesToRemove,\n    numberOfColumnsToShow,\n    numberOfRowsToStart,\n    isLazyLoad,\n    isMediaTrained,\n    getOffset: helpers.getOffset,\n  };\n\n  // Create a mutable reference for lazy load callback\n  // This allows us to set it after fetchHandlers are created\n  const lazyLoadCallbackRef = {\n    current: undefined as (() => Promise<void>) | undefined,\n  };\n\n  // Create display handlers with callback reference\n  const displayHandlers = createDisplayHandlers({\n    displayStrategy,\n    layoutStrategy,\n    helpers,\n    cardMappingOptions,\n    isLazyLoad,\n    numberOfColumnsToShow,\n    numberOfRowsToStart,\n    noResultsConfig: {\n      ...noResultsConfig,\n      isThemeDark, // Ensure theme is passed to EmptyState\n    },\n    // Pass a function that calls the current callback\n    lazyLoadCallback: isLazyLoad\n      ? async () => {\n          if (lazyLoadCallbackRef.current) {\n            await lazyLoadCallbackRef.current();\n          }\n        }\n      : undefined,\n  });\n\n  // Create fetch handlers\n  const fetchHandlers = createFetchHandlers({\n    fetchStrategy,\n    helpers,\n    baseProps,\n    displayHandlers,\n    layoutElement,\n    isThemeDark,\n    enableCategoryFallback,\n  });\n\n  // Set the lazy load callback reference now that fetch handlers exist\n  lazyLoadCallbackRef.current = fetchHandlers.loadMore;\n\n  // Append loading indicator to container\n  container.appendChild(loading.element);\n\n  // Start fetching data\n  fetchHandlers.start();\n\n  // Return feed with getter for styles to ensure dynamic access\n  return {\n    element: container,\n    get styles() {\n      return styles;\n    },\n    events: {\n      callback: shadowRootCallback,\n    },\n  };\n}\n"],"names":[],"mappings":";;;;;;;;AAwDO,SAAS,eACd,QACmB;AACnB,QAAM;AAAA,IACJ;AAAA,IACA,cAAc;AAAA,IACd,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,iBAAiB;AAAA,IACjB;AAAA,IACA,wBAAwB;AAAA,IACxB;AAAA,IACA,aAAa;AAAA,IACb,yBAAyB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IACE;AAEJ,QAAM,YAAY,SAAS,cAAc,KAAK;AAC9C,QAAM,UAAU,IAAI,aAAa,EAAE,aAAa;AAChD,MAAI,SAAS,QAAQ;AAGrB,QAAM,UAAU,kBAAkB;AAAA,IAChC;AAAA,IACA,eAAe;AAAA,EAAA,CAChB;AAGD,QAAM,oBAAoB,QAAQ;AAClC,UAAQ,YAAY,CAAC,qBAA6B;AAChD,cAAU;AACV,sBAAkB,gBAAgB;AAAA,EACpC;AAIA,QAAM,qBAAqB,CAAC,WAAuB;AAGjD,YAAQ,cAAc,MAAM;AAAA,EAC9B;AAEA,QAAM,qBAAyC;AAAA,IAC7C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,YAAY,EAAE,SAAA;AAAA,EAAS;AAG7B,QAAM,gBAAgB,eAAe,OAAO;AAAA,IAC1C,SAAS;AAAA,IACT;AAAA,EAAA,CACD;AACD,UAAQ,UAAU,cAAc,MAAM;AAEtC,QAAM,YAAY;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,QAAQ;AAAA,EAAA;AAKrB,QAAM,sBAAsB;AAAA,IAC1B,SAAS;AAAA,EAAA;AAIX,QAAM,kBAAkB,sBAAsB;AAAA,IAC5C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,iBAAiB;AAAA,MACf,GAAG;AAAA,MACH;AAAA;AAAA,IAAA;AAAA;AAAA,IAGF,kBAAkB,aACd,YAAY;AACV,UAAI,oBAAoB,SAAS;AAC/B,cAAM,oBAAoB,QAAA;AAAA,MAC5B;AAAA,IACF,IACA;AAAA,EAAA,CACL;AAGD,QAAM,gBAAgB,oBAAoB;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,CACD;AAGD,sBAAoB,UAAU,cAAc;AAG5C,YAAU,YAAY,QAAQ,OAAO;AAGrC,gBAAc,MAAA;AAGd,SAAO;AAAA,IACL,SAAS;AAAA,IACT,IAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,IAAA;AAAA,EACZ;AAEJ;"}

package/dist/factory/core/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export { createBaseFeed } from './createBaseFeed';
+//# sourceMappingURL=index.d.ts.map

package/dist/factory/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/factory/core/index.ts"],"names":[],"mappings":"AAMA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/factory/core/types.d.ts

@@ -0,0 +1,92 @@
+import { ElementModel } from '../../_types';
+export interface FeedHelpers {
+    setTotalEntries: (count: number) => void;
+    setOffset: (count: number) => void;
+    setStyles: (styles: string) => void;
+    setShadowRoot: (shadowRoot: ShadowRoot) => void;
+    getContainer: () => HTMLElement;
+    getOffset: () => number;
+    getTotalEntries: () => number;
+    getStyles: () => string;
+    getShadowRoot: () => ShadowRoot | null;
+}
+export interface FetchStrategy<TData, TVariables = any> {
+    fetchCount: (variables: TVariables) => Promise<number | null>;
+    fetchEntries: (variables: TVariables) => Promise<TData[] | null>;
+    composeApiVariables: (props: any) => TVariables;
+    fetchCategoryNames?: (categoryIds: string[], token?: string) => Promise<string[] | null>;
+}
+export interface CardMappingOptions {
+    isThemeDark?: boolean;
+    isTransparent?: boolean;
+    isFeatured?: boolean;
+    isOverlay?: boolean;
+    isAligned?: boolean;
+    cardType?: 'block' | 'list' | 'tabular' | 'overlay';
+    imageConfig?: (entry: any) => ImageConfig;
+    [key: string]: any;
+}
+export interface ImageConfig {
+    imageUrl: string;
+    altText: string;
+    linkUrl?: string;
+    linkLabel?: string;
+}
+export interface DisplayStrategy<TData> {
+    mapEntryToCard: (entry: TData, options: CardMappingOptions) => ElementModel;
+    layoutType: 'grid' | 'list' | 'stacked' | 'custom';
+}
+export interface LayoutOptions {
+    columns?: 2 | 3 | 4;
+    isThemeDark?: boolean;
+    gap?: string;
+    showDividers?: boolean;
+    [key: string]: any;
+}
+export interface LayoutStrategy {
+    create: (options: LayoutOptions) => ElementModel;
+    getId: () => string;
+}
+export interface NoResultsConfig {
+    message?: string;
+    linkUrl?: string;
+    linkText?: string;
+    isThemeDark?: boolean;
+}
+export interface BaseFeedConfig<TData, TVariables = any> {
+    token: string | null;
+    isThemeDark?: boolean;
+    isTransparent?: boolean;
+    isOverlay?: boolean;
+    isAligned?: boolean;
+    cardType?: 'block' | 'list' | 'tabular' | 'overlay';
+    numberOfColumnsToShow?: number;
+    numberOfRowsToStart: number;
+    isLazyLoad?: boolean;
+    enableCategoryFallback?: boolean;
+    isMediaTrained?: boolean | null;
+    categories?: string[];
+    entriesToRemove?: Array<string | number>;
+    fetchStrategy: FetchStrategy<TData, TVariables>;
+    displayStrategy: DisplayStrategy<TData>;
+    layoutStrategy: LayoutStrategy;
+    noResultsConfig?: NoResultsConfig;
+    imageConfig?: (entry: TData) => ImageConfig;
+    getOffset?: () => number;
+}
+export interface DisplayResultsProps<TData> {
+    feedData: TData[];
+}
+export interface FeedLifecycle<TData> {
+    displayResultStart: (props: any) => void;
+    displayResults: (props: DisplayResultsProps<TData>) => Promise<void>;
+    displayNoResults: (props: any) => void;
+}
+export interface FeedEvents {
+    callback?: (shadowRoot: ShadowRoot) => void;
+    [key: string]: any;
+}
+export interface FeedFactoryResult extends ElementModel {
+    events?: FeedEvents;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/factory/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../source/factory/core/types.ts"],"names":[],"mappings":"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"}

package/dist/factory/helpers/displayHandler.d.ts

@@ -0,0 +1,29 @@
+import { DisplayStrategy, FeedHelpers, LayoutStrategy, CardMappingOptions, DisplayResultsProps, NoResultsConfig } from '../core/types';
+import { ElementModel } from '../../_types';
+interface DisplayHandlerConfig<TData> {
+    displayStrategy: DisplayStrategy<TData>;
+    layoutStrategy: LayoutStrategy;
+    helpers: FeedHelpers;
+    cardMappingOptions: CardMappingOptions;
+    isLazyLoad?: boolean;
+    numberOfColumnsToShow?: number;
+    numberOfRowsToStart: number;
+    noResultsConfig?: NoResultsConfig;
+    lazyLoadCallback?: () => Promise<void>;
+}
+export declare function setShadowStyles({ shadowRoot, styles, }: {
+    shadowRoot: ShadowRoot;
+    styles: string;
+}): Promise<void>;
+export declare function createDisplayHandlers<TData>(config: DisplayHandlerConfig<TData>): {
+    displayNoResults: (props: any) => void;
+    displayResults: (props: DisplayResultsProps<TData>) => Promise<void>;
+    displayResultStart: (props: {
+        feedData: TData[];
+        layoutElement: ElementModel;
+        isFallback?: boolean;
+        categoryNames?: string[];
+    }) => Promise<void>;
+};
+export {};
+//# sourceMappingURL=displayHandler.d.ts.map

package/dist/factory/helpers/displayHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayHandler.d.ts","sourceRoot":"","sources":["../../../source/factory/helpers/displayHandler.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,eAAe,EACf,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAK5C,UAAU,oBAAoB,CAAC,KAAK;IAElC,eAAe,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAExC,cAAc,EAAE,cAAc,CAAC;IAE/B,OAAO,EAAE,WAAW,CAAC;IAErB,kBAAkB,EAAE,kBAAkB,CAAC;IAEvC,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,mBAAmB,EAAE,MAAM,CAAC;IAE5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAKD,wBAAsB,eAAe,CAAC,EACpC,UAAU,EACV,MAAM,GACP,EAAE;IACD,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhB;AAsED,wBAAgB,qBAAqB,CAAC,KAAK,EACzC,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC;8BAiBF,GAAG;4BAwC3B,mBAAmB,CAAC,KAAK,CAAC,KAChC,OAAO,CAAC,IAAI,CAAC;gCAyDyB;QACvC,QAAQ,EAAE,KAAK,EAAE,CAAC;QAClB,aAAa,EAAE,YAAY,CAAC;QAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,KAAG,OAAO,CAAC,IAAI,CAAC;EAuDlB"}

package/dist/factory/helpers/displayHandler.js

@@ -0,0 +1,169 @@
+import { ElementBuilder } from "@universityofmaryland/web-builder-library";
+import * as Styles from "@universityofmaryland/web-styles-library";
+import * as typography from "@universityofmaryland/web-styles-library/typography";
+import { theme } from "@universityofmaryland/web-utilities-library/theme";
+import { EmptyState } from "../../states/empty.js";
+import { PaginationState } from "../../states/pagination.js";
+import { Announcer } from "../../states/announcer.js";
+import { dispatch, eventNames } from "../../helpers/events/index.js";
+async function setShadowStyles({
+  shadowRoot,
+  styles
+}) {
+  const styleElement = document.createElement("style");
+  const optimizedCss = await Styles.utilities.transform.css.removeDuplicates(
+    styles
+  );
+  styleElement.textContent = optimizedCss;
+  shadowRoot.appendChild(styleElement);
+}
+function createFallbackMessage(categoryNames, isThemeDark = false) {
+  const formattedNames = categoryNames.join(", ");
+  const message = `No events found for "${formattedNames}" <span> Other upcoming events:</span>`;
+  const messageElement = new ElementBuilder(document.createElement("p")).styled(
+    typography.sans.compose("extralarge", {
+      theme: theme.fontColor(isThemeDark)
+    })
+  ).withStyles({
+    textAlign: "center",
+    margin: "0 auto",
+    ["& span"]: {
+      display: "block"
+    }
+  }).withHTML(message);
+  const container = new ElementBuilder(document.createElement("div")).withClassName("feed-events-fallback-message").withChild(messageElement).withStyles({
+    element: {
+      marginBottom: Styles.token.spacing.lg,
+      padding: `${Styles.token.spacing.md} ${Styles.token.spacing.lg}`
+    }
+  }).build();
+  return container;
+}
+function createDisplayHandlers(config) {
+  const {
+    displayStrategy,
+    layoutStrategy,
+    helpers,
+    cardMappingOptions,
+    isLazyLoad,
+    numberOfColumnsToShow = 1,
+    numberOfRowsToStart,
+    noResultsConfig = {},
+    lazyLoadCallback
+  } = config;
+  const displayNoResults = (props) => {
+    const container = helpers.getContainer();
+    const shadowRoot = helpers.getShadowRoot();
+    const { message, linkUrl, linkText, isThemeDark } = {
+      ...noResultsConfig,
+      ...props
+    };
+    const emptyState = new EmptyState({
+      message,
+      linkUrl,
+      linkText,
+      isThemeDark
+    });
+    const announcer = new Announcer({ message: message || "No results found" });
+    container.innerHTML = "";
+    emptyState.render(container);
+    container.appendChild(announcer.getElement());
+    helpers.setStyles(emptyState.styles);
+    dispatch(container, eventNames.FEED_ERROR, {
+      error: "No results found",
+      message,
+      isThemeDark
+    });
+    setTimeout(() => {
+      const styles = helpers.getStyles();
+      if (shadowRoot) {
+        setShadowStyles({ shadowRoot, styles });
+      }
+    }, 100);
+  };
+  const displayResults = async (props) => {
+    const { feedData } = props;
+    const container = helpers.getContainer();
+    const grid = container.querySelector(
+      `#${layoutStrategy.getId()}`
+    );
+    const existingLoader = container.querySelector(".umd-loader-container");
+    existingLoader?.remove();
+    const existingPagination = container.querySelector(
+      `.${Styles.layout.alignment.block.center.className}`
+    );
+    existingPagination?.remove();
+    helpers.setOffset(feedData.length);
+    const entries = feedData.map(
+      (entry) => displayStrategy.mapEntryToCard(entry, cardMappingOptions)
+    );
+    entries.forEach((entry) => {
+      grid.appendChild(entry.element);
+      helpers.setStyles(entry.styles);
+    });
+    if (isLazyLoad && lazyLoadCallback) {
+      const pagination = new PaginationState({
+        totalEntries: helpers.getTotalEntries(),
+        offset: helpers.getOffset(),
+        isLazyLoad: true,
+        callback: lazyLoadCallback
+      });
+      const paginationElement = pagination.render(container);
+      if (paginationElement) {
+        helpers.setStyles(paginationElement.styles);
+      }
+    }
+    const shadowRoot = helpers.getShadowRoot();
+    if (shadowRoot) {
+      await setShadowStyles({
+        shadowRoot,
+        styles: helpers.getStyles()
+      });
+    }
+  };
+  const displayResultStart = async (props) => {
+    const { feedData, layoutElement, isFallback, categoryNames } = props;
+    const container = helpers.getContainer();
+    const totalEntries = helpers.getTotalEntries();
+    const showAmount = numberOfColumnsToShow * numberOfRowsToStart;
+    const message = isLazyLoad ? `Showing ${showAmount} of ${totalEntries} articles` : `Showing ${showAmount} articles`;
+    if (isFallback && categoryNames && categoryNames.length > 0) {
+      const fallbackMessage = createFallbackMessage(
+        categoryNames,
+        cardMappingOptions.isThemeDark || false
+      );
+      container.appendChild(fallbackMessage.element);
+      helpers.setStyles(fallbackMessage.styles);
+      const shadowRoot = helpers.getShadowRoot();
+      if (shadowRoot) {
+        await setShadowStyles({
+          shadowRoot,
+          styles: helpers.getStyles()
+        });
+      }
+    }
+    layoutElement.element.setAttribute("id", layoutStrategy.getId());
+    container.appendChild(layoutElement.element);
+    helpers.setStyles(layoutElement.styles);
+    dispatch(container, eventNames.FEED_LOADED, {
+      items: feedData,
+      count: feedData.length,
+      total: totalEntries || feedData.length,
+      isFallback,
+      categoryNames
+    });
+    await displayResults({ feedData });
+    const announcer = new Announcer({ message });
+    container.appendChild(announcer.getElement());
+  };
+  return {
+    displayNoResults,
+    displayResults,
+    displayResultStart
+  };
+}
+export {
+  createDisplayHandlers,
+  setShadowStyles
+};
+//# sourceMappingURL=displayHandler.js.map

package/dist/factory/helpers/displayHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayHandler.js","sources":["../../../source/factory/helpers/displayHandler.ts"],"sourcesContent":["/**\n * Display Handler Utilities\n *\n * Creates handlers for displaying feed results using a display strategy.\n * Handles both initial display and lazy-loaded results.\n *\n * @module factory/helpers/displayHandler\n */\n\nimport { ElementBuilder } from '@universityofmaryland/web-builder-library';\nimport * as Styles from '@universityofmaryland/web-styles-library';\nimport * as typography from '@universityofmaryland/web-styles-library/typography';\nimport { theme } from '@universityofmaryland/web-utilities-library/theme';\nimport { PaginationState, EmptyState, Announcer } from '../../states';\nimport { events } from '../../helpers';\nimport {\n  DisplayStrategy,\n  FeedHelpers,\n  LayoutStrategy,\n  CardMappingOptions,\n  DisplayResultsProps,\n  NoResultsConfig,\n} from '../core/types';\nimport { ElementModel } from '../../_types';\n\n/**\n * Configuration for creating display handlers\n */\ninterface DisplayHandlerConfig<TData> {\n  /** Strategy for displaying entries */\n  displayStrategy: DisplayStrategy<TData>;\n  /** Strategy for creating layout */\n  layoutStrategy: LayoutStrategy;\n  /** Feed helper functions */\n  helpers: FeedHelpers;\n  /** Options for card mapping */\n  cardMappingOptions: CardMappingOptions;\n  /** Whether lazy loading is enabled */\n  isLazyLoad?: boolean;\n  /** Number of columns to show */\n  numberOfColumnsToShow?: number;\n  /** Number of rows to start with */\n  numberOfRowsToStart: number;\n  /** Configuration for no results state */\n  noResultsConfig?: NoResultsConfig;\n  /** Callback for lazy load */\n  lazyLoadCallback?: () => Promise<void>;\n}\n\n/**\n * Set shadow root styles with CSS optimization\n */\nexport async function setShadowStyles({\n  shadowRoot,\n  styles,\n}: {\n  shadowRoot: ShadowRoot;\n  styles: string;\n}): Promise<void> {\n  const styleElement = document.createElement('style');\n  const optimizedCss = await Styles.utilities.transform.css.removeDuplicates(\n    styles,\n  );\n  styleElement.textContent = optimizedCss;\n  shadowRoot.appendChild(styleElement);\n}\n\n/**\n * Create fallback message for category-filtered feeds with no results\n */\nfunction createFallbackMessage(\n  categoryNames: string[],\n  isThemeDark: boolean = false,\n): ElementModel {\n  const formattedNames = categoryNames.join(', ');\n  const message = `No events found for \"${formattedNames}\" <span> Other upcoming events:</span>`;\n\n  const messageElement = new ElementBuilder(document.createElement('p'))\n    .styled(\n      typography.sans.compose('extralarge', {\n        theme: theme.fontColor(isThemeDark),\n      }),\n    )\n    .withStyles({\n      textAlign: 'center',\n      margin: '0 auto',\n\n      ['& span']: {\n        display: 'block',\n      },\n    })\n    .withHTML(message);\n\n  const container = new ElementBuilder(document.createElement('div'))\n    .withClassName('feed-events-fallback-message')\n    .withChild(messageElement)\n    .withStyles({\n      element: {\n        marginBottom: Styles.token.spacing.lg,\n        padding: `${Styles.token.spacing.md} ${Styles.token.spacing.lg}`,\n      },\n    })\n    .build();\n\n  return container;\n}\n\n/**\n * Create display handlers for a feed\n *\n * Returns handlers for:\n * - Displaying initial results\n * - Displaying lazy-loaded results\n * - Displaying no results state\n *\n * @param config - Configuration for the display handlers\n * @returns Display handler functions\n *\n * @example\n * ```typescript\n * const handlers = createDisplayHandlers({\n *   displayStrategy: eventsDisplayStrategy,\n *   layoutStrategy: gridGapLayout,\n *   helpers: feedHelpers,\n *   cardMappingOptions: { isThemeDark: false },\n *   isLazyLoad: true,\n *   numberOfColumnsToShow: 3,\n *   numberOfRowsToStart: 2,\n * });\n *\n * // Use handlers\n * handlers.displayResultStart({ feedData, layoutElement });\n * await handlers.displayResults({ feedData });\n * ```\n */\nexport function createDisplayHandlers<TData>(\n  config: DisplayHandlerConfig<TData>,\n) {\n  const {\n    displayStrategy,\n    layoutStrategy,\n    helpers,\n    cardMappingOptions,\n    isLazyLoad,\n    numberOfColumnsToShow = 1,\n    numberOfRowsToStart,\n    noResultsConfig = {},\n    lazyLoadCallback,\n  } = config;\n\n  /**\n   * Handle displaying no results\n   */\n  const displayNoResults = (props: any) => {\n    const container = helpers.getContainer();\n    const shadowRoot = helpers.getShadowRoot();\n    const { message, linkUrl, linkText, isThemeDark } = {\n      ...noResultsConfig,\n      ...props,\n    };\n\n    const emptyState = new EmptyState({\n      message,\n      linkUrl,\n      linkText,\n      isThemeDark,\n    });\n\n    const announcer = new Announcer({ message: message || 'No results found' });\n\n    container.innerHTML = '';\n    emptyState.render(container);\n    container.appendChild(announcer.getElement());\n    helpers.setStyles(emptyState.styles);\n\n    events.dispatch(container, events.eventNames.FEED_ERROR, {\n      error: 'No results found',\n      message,\n      isThemeDark,\n    });\n\n    setTimeout(() => {\n      const styles = helpers.getStyles();\n      if (shadowRoot) {\n        setShadowStyles({ shadowRoot, styles });\n      }\n    }, 100);\n  };\n\n  /**\n   * Handle displaying lazy-loaded results\n   */\n  const displayResults = async (\n    props: DisplayResultsProps<TData>,\n  ): Promise<void> => {\n    const { feedData } = props;\n    const container = helpers.getContainer();\n    const grid = container.querySelector(\n      `#${layoutStrategy.getId()}`,\n    ) as HTMLDivElement;\n\n    // Remove existing loading and pagination states\n    const existingLoader = container.querySelector('.umd-loader-container');\n    existingLoader?.remove();\n\n    const existingPagination = container.querySelector(\n      `.${Styles.layout.alignment.block.center.className}`,\n    );\n    existingPagination?.remove();\n\n    helpers.setOffset(feedData.length);\n\n    // Map entries to cards using display strategy\n    const entries = feedData.map((entry) =>\n      displayStrategy.mapEntryToCard(entry, cardMappingOptions),\n    );\n\n    // Append entries to grid\n    entries.forEach((entry) => {\n      grid.appendChild(entry.element);\n      helpers.setStyles(entry.styles);\n    });\n\n    // Add pagination if lazy load is enabled\n    if (isLazyLoad && lazyLoadCallback) {\n      const pagination = new PaginationState({\n        totalEntries: helpers.getTotalEntries(),\n        offset: helpers.getOffset(),\n        isLazyLoad: true,\n        callback: lazyLoadCallback,\n      });\n\n      const paginationElement = pagination.render(container);\n      if (paginationElement) {\n        helpers.setStyles(paginationElement.styles);\n      }\n    }\n\n    // Update shadow root styles if needed\n    const shadowRoot = helpers.getShadowRoot();\n    if (shadowRoot) {\n      await setShadowStyles({\n        shadowRoot,\n        styles: helpers.getStyles(),\n      });\n    }\n  };\n\n  /**\n   * Handle displaying initial results\n   */\n  const displayResultStart = async (props: {\n    feedData: TData[];\n    layoutElement: ElementModel;\n    isFallback?: boolean;\n    categoryNames?: string[];\n  }): Promise<void> => {\n    const { feedData, layoutElement, isFallback, categoryNames } = props;\n    const container = helpers.getContainer();\n    const totalEntries = helpers.getTotalEntries();\n    const showAmount = numberOfColumnsToShow * numberOfRowsToStart;\n    const message = isLazyLoad\n      ? `Showing ${showAmount} of ${totalEntries} articles`\n      : `Showing ${showAmount} articles`;\n\n    // If this is a fallback, add a message about the category FIRST\n    if (isFallback && categoryNames && categoryNames.length > 0) {\n      const fallbackMessage = createFallbackMessage(\n        categoryNames,\n        cardMappingOptions.isThemeDark || false,\n      );\n      container.appendChild(fallbackMessage.element);\n      helpers.setStyles(fallbackMessage.styles);\n\n      // Inject fallback message styles into shadow DOM immediately\n      const shadowRoot = helpers.getShadowRoot();\n      if (shadowRoot) {\n        await setShadowStyles({\n          shadowRoot,\n          styles: helpers.getStyles(),\n        });\n      }\n    }\n\n    // Set layout ID and append to container\n    layoutElement.element.setAttribute('id', layoutStrategy.getId());\n    container.appendChild(layoutElement.element);\n    helpers.setStyles(layoutElement.styles);\n\n    // Dispatch feed loaded event\n    events.dispatch(container, events.eventNames.FEED_LOADED, {\n      items: feedData,\n      count: feedData.length,\n      total: totalEntries || feedData.length,\n      isFallback,\n      categoryNames,\n    });\n\n    // Display the results\n    await displayResults({ feedData });\n\n    // Add announcer\n    const announcer = new Announcer({ message });\n    container.appendChild(announcer.getElement());\n  };\n\n  return {\n    displayNoResults,\n    displayResults,\n    displayResultStart,\n  };\n}\n"],"names":["events.dispatch","events.eventNames"],"mappings":"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"}

package/dist/factory/helpers/feedHelpers.d.ts

@@ -0,0 +1,10 @@
+import { FeedHelpers } from '../core/types';
+interface FeedHelpersConfig {
+    container: HTMLElement;
+    initialStyles?: string;
+    shadowRoot?: ShadowRoot | null;
+}
+export declare function createFeedHelpers(config: FeedHelpersConfig): FeedHelpers;
+export declare function updateShadowRoot(helpers: FeedHelpers, shadowRoot: ShadowRoot): void;
+export {};
+//# sourceMappingURL=feedHelpers.d.ts.map

package/dist/factory/helpers/feedHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedHelpers.d.ts","sourceRoot":"","sources":["../../../source/factory/helpers/feedHelpers.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5C,UAAU,iBAAiB;IAEzB,SAAS,EAAE,WAAW,CAAC;IAEvB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC;AAgCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAsCxE;AAaD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,UAAU,GACrB,IAAI,CAKN"}

package/dist/factory/helpers/feedHelpers.js

@@ -0,0 +1,32 @@
+function createFeedHelpers(config) {
+  const { container, initialStyles = "", shadowRoot: initialShadowRoot = null } = config;
+  const state = {
+    totalEntries: 0,
+    offset: 0,
+    styles: initialStyles,
+    shadowRoot: initialShadowRoot
+  };
+  return {
+    setTotalEntries: (count) => {
+      state.totalEntries = count;
+    },
+    setOffset: (count) => {
+      state.offset = state.offset + count;
+    },
+    setStyles: (additionalStyles) => {
+      state.styles += additionalStyles;
+    },
+    setShadowRoot: (shadow) => {
+      state.shadowRoot = shadow;
+    },
+    getContainer: () => container,
+    getOffset: () => state.offset,
+    getTotalEntries: () => state.totalEntries,
+    getStyles: () => state.styles,
+    getShadowRoot: () => state.shadowRoot
+  };
+}
+export {
+  createFeedHelpers
+};
+//# sourceMappingURL=feedHelpers.js.map

package/dist/factory/helpers/feedHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedHelpers.js","sources":["../../../source/factory/helpers/feedHelpers.ts"],"sourcesContent":["/**\n * Feed Helper Utilities\n *\n * Creates standard helper functions for managing feed state.\n * These helpers are passed to all strategies and lifecycle handlers.\n *\n * @module factory/helpers/feedHelpers\n */\n\nimport { FeedHelpers } from '../core/types';\n\n/**\n * Configuration for creating feed helpers\n */\ninterface FeedHelpersConfig {\n  /** The feed container element */\n  container: HTMLElement;\n  /** Initial styles */\n  initialStyles?: string;\n  /** Shadow root if available */\n  shadowRoot?: ShadowRoot | null;\n}\n\n/**\n * Internal state managed by the helpers\n */\ninterface FeedState {\n  totalEntries: number;\n  offset: number;\n  styles: string;\n  shadowRoot: ShadowRoot | null;\n}\n\n/**\n * Create feed helper functions\n *\n * These helpers provide a consistent API for managing feed state\n * across different feed types and layouts.\n *\n * @param config - Configuration for the helpers\n * @returns Feed helper functions\n *\n * @example\n * ```typescript\n * const container = document.createElement('div');\n * const helpers = createFeedHelpers({ container });\n *\n * helpers.setTotalEntries(100);\n * helpers.setOffset(10);\n * console.log(helpers.getTotalEntries()); // 100\n * console.log(helpers.getOffset()); // 10\n * ```\n */\nexport function createFeedHelpers(config: FeedHelpersConfig): FeedHelpers {\n  const { container, initialStyles = '', shadowRoot: initialShadowRoot = null } = config;\n\n  // Internal state\n  const state: FeedState = {\n    totalEntries: 0,\n    offset: 0,\n    styles: initialStyles,\n    shadowRoot: initialShadowRoot,\n  };\n\n  return {\n    setTotalEntries: (count: number) => {\n      state.totalEntries = count;\n    },\n\n    setOffset: (count: number) => {\n      state.offset = state.offset + count;\n    },\n\n    setStyles: (additionalStyles: string) => {\n      state.styles += additionalStyles;\n    },\n\n    setShadowRoot: (shadow: ShadowRoot) => {\n      state.shadowRoot = shadow;\n    },\n\n    getContainer: () => container,\n\n    getOffset: () => state.offset,\n\n    getTotalEntries: () => state.totalEntries,\n\n    getStyles: () => state.styles,\n\n    getShadowRoot: () => state.shadowRoot,\n  };\n}\n\n/**\n * Update the shadow root reference in helpers\n *\n * This is called when a shadow root becomes available\n * (typically from a web component callback)\n *\n * @param helpers - The feed helpers\n * @param shadowRoot - The shadow root to set\n *\n * @internal\n */\nexport function updateShadowRoot(\n  helpers: FeedHelpers,\n  shadowRoot: ShadowRoot\n): void {\n  // We need to mutate the internal state\n  // This is safe because helpers is always created fresh per feed instance\n  const state = (helpers as any).state || {};\n  state.shadowRoot = shadowRoot;\n}\n"],"names":[],"mappings":"AAqDO,SAAS,kBAAkB,QAAwC;AACxE,QAAM,EAAE,WAAW,gBAAgB,IAAI,YAAY,oBAAoB,SAAS;AAGhF,QAAM,QAAmB;AAAA,IACvB,cAAc;AAAA,IACd,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,YAAY;AAAA,EAAA;AAGd,SAAO;AAAA,IACL,iBAAiB,CAAC,UAAkB;AAClC,YAAM,eAAe;AAAA,IACvB;AAAA,IAEA,WAAW,CAAC,UAAkB;AAC5B,YAAM,SAAS,MAAM,SAAS;AAAA,IAChC;AAAA,IAEA,WAAW,CAAC,qBAA6B;AACvC,YAAM,UAAU;AAAA,IAClB;AAAA,IAEA,eAAe,CAAC,WAAuB;AACrC,YAAM,aAAa;AAAA,IACrB;AAAA,IAEA,cAAc,MAAM;AAAA,IAEpB,WAAW,MAAM,MAAM;AAAA,IAEvB,iBAAiB,MAAM,MAAM;AAAA,IAE7B,WAAW,MAAM,MAAM;AAAA,IAEvB,eAAe,MAAM,MAAM;AAAA,EAAA;AAE/B;"}

package/dist/factory/helpers/fetchHandler.d.ts

@@ -0,0 +1,22 @@
+import { FetchStrategy, FeedHelpers } from '../core/types';
+interface FetchHandlerConfig<TData, TVariables> {
+    fetchStrategy: FetchStrategy<TData, TVariables>;
+    helpers: FeedHelpers;
+    baseProps: any;
+    displayHandlers: {
+        displayResultStart: (props: any) => Promise<void>;
+        displayResults: (props: {
+            feedData: TData[];
+        }) => Promise<void>;
+        displayNoResults: (props: any) => void;
+    };
+    layoutElement: any;
+    isThemeDark?: boolean;
+    enableCategoryFallback?: boolean;
+}
+export declare function createFetchHandlers<TData, TVariables>(config: FetchHandlerConfig<TData, TVariables>): {
+    start: () => Promise<void>;
+    loadMore: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=fetchHandler.d.ts.map