@universityofmaryland/web-feeds-library 1.2.3 → 1.3.0-beta.0

package/README.md

@@ -1,6 +1,6 @@
 # University of Maryland Feeds Library
 
-[![Feeds Version](https://img.shields.io/badge/Feeds-v1.2.3-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");
+const slider = require("./feeds/academic/slider.js");
 exports.slider = slider;
 //# sourceMappingURL=academic.js.map

package/dist/academic.mjs

@@ -1,4 +1,4 @@
-import { default as default2 } from "./composite/academic/slider.mjs";
+import { default as default2 } from "./feeds/academic/slider.mjs";
 export {
   default2 as slider
 };

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,9 +1,9 @@
 "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");
+const grid = require("./feeds/events/grid.js");
+const list = require("./feeds/events/list.js");
+const slider = require("./feeds/events/slider.js");
+const grouped = require("./feeds/events/grouped.js");
 exports.grid = grid;
 exports.list = list;
 exports.slider = slider;

package/dist/events.mjs

@@ -1,7 +1,7 @@
-import { default as default2 } from "./composite/events/grid.mjs";
-import { default as default3 } from "./composite/events/list.mjs";
-import { default as default4 } from "./composite/events/slider.mjs";
-import { default as default5 } from "./composite/events/grouped.mjs";
+import { default as default2 } from "./feeds/events/grid.mjs";
+import { default as default3 } from "./feeds/events/list.mjs";
+import { default as default4 } from "./feeds/events/slider.mjs";
+import { default as default5 } from "./feeds/events/grouped.mjs";
 export {
   default2 as grid,
   default5 as grouped,

package/dist/experts.d.ts

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

package/dist/experts.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const grid = require("./feeds/experts/grid.js");
+const list = require("./feeds/experts/list.js");
+const bio = require("./feeds/experts/bio.js");
+exports.grid = grid;
+exports.list = list;
+exports.bio = bio;
+//# sourceMappingURL=experts.js.map

package/dist/experts.js.map

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

package/dist/experts.mjs

@@ -0,0 +1,9 @@
+import { default as default2 } from "./feeds/experts/grid.mjs";
+import { default as default3 } from "./feeds/experts/list.mjs";
+import { default as default4 } from "./feeds/experts/bio.mjs";
+export {
+  default4 as bio,
+  default2 as grid,
+  default3 as list
+};
+//# sourceMappingURL=experts.mjs.map

package/dist/experts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"experts.mjs","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,CAkInB"}

package/dist/factory/core/createBaseFeed.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const loading = require("../../states/loading.js");
+require("@universityofmaryland/web-builder-library");
+require("@universityofmaryland/web-elements-library");
+require("@universityofmaryland/web-styles-library");
+require("@universityofmaryland/web-utilities-library/theme");
+const feedHelpers = require("../helpers/feedHelpers.js");
+const displayHandler = require("../helpers/displayHandler.js");
+const fetchHandler = require("../helpers/fetchHandler.js");
+function createBaseFeed(config) {
+  const {
+    token,
+    isThemeDark = false,
+    isTransparent = false,
+    isOverlay = false,
+    isAligned = false,
+    cardType,
+    numberOfColumnsToShow = 1,
+    numberOfRowsToStart,
+    isLazyLoad = false,
+    enableCategoryFallback = false,
+    categories,
+    entriesToRemove,
+    fetchStrategy,
+    displayStrategy,
+    layoutStrategy,
+    noResultsConfig,
+    imageConfig
+  } = config;
+  const container = document.createElement("div");
+  const loading$1 = new loading.LoadingState({ isThemeDark });
+  let styles = loading$1.styles;
+  const helpers = feedHelpers.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,
+    getOffset: helpers.getOffset
+  };
+  const lazyLoadCallbackRef = {
+    current: void 0
+  };
+  const displayHandlers = displayHandler.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 = fetchHandler.createFetchHandlers({
+    fetchStrategy,
+    helpers,
+    baseProps,
+    displayHandlers,
+    layoutElement,
+    isThemeDark,
+    enableCategoryFallback
+  });
+  lazyLoadCallbackRef.current = fetchHandlers.loadMore;
+  container.appendChild(loading$1.element);
+  fetchHandlers.start();
+  return {
+    element: container,
+    get styles() {
+      return styles;
+    },
+    events: {
+      callback: shadowRootCallback
+    }
+  };
+}
+exports.createBaseFeed = 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    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    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":["loading","LoadingState","createFeedHelpers","createDisplayHandlers","createFetchHandlers"],"mappings":";;;;;;;;;;AAwDO,SAAS,eACd,QACmB;AACnB,QAAM;AAAA,IACJ;AAAA,IACA,cAAc;AAAA,IACd,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ;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,QAAMA,YAAU,IAAIC,qBAAa,EAAE,aAAa;AAChD,MAAI,SAASD,UAAQ;AAGrB,QAAM,UAAUE,YAAAA,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,WAAW,QAAQ;AAAA,EAAA;AAKrB,QAAM,sBAAsB;AAAA,IAC1B,SAAS;AAAA,EAAA;AAIX,QAAM,kBAAkBC,eAAAA,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,gBAAgBC,aAAAA,oBAAoB;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,CACD;AAGD,sBAAoB,UAAU,cAAc;AAG5C,YAAU,YAAYJ,UAAQ,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/createBaseFeed.mjs

@@ -0,0 +1,114 @@
+import { LoadingState } from "../../states/loading.mjs";
+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.mjs";
+import { createDisplayHandlers } from "../helpers/displayHandler.mjs";
+import { createFetchHandlers } from "../helpers/fetchHandler.mjs";
+function createBaseFeed(config) {
+  const {
+    token,
+    isThemeDark = false,
+    isTransparent = false,
+    isOverlay = false,
+    isAligned = false,
+    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,
+    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.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createBaseFeed.mjs","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    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    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;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,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,91 @@
+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;
+    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":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,WAAW,WAAW;IAE1B,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAEhD,YAAY,EAAE,MAAM,WAAW,CAAC;IAEhC,SAAS,EAAE,MAAM,MAAM,CAAC;IAExB,eAAe,EAAE,MAAM,MAAM,CAAC;IAE9B,SAAS,EAAE,MAAM,MAAM,CAAC;IAExB,aAAa,EAAE,MAAM,UAAU,GAAG,IAAI,CAAC;CACxC;AAQD,MAAM,WAAW,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG;IAKpD,UAAU,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAK9D,YAAY,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAMjE,mBAAmB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,UAAU,CAAC;IAMhD,kBAAkB,CAAC,EAAE,CACnB,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,CAAC,EAAE,MAAM,KACX,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;CAC/B;AAKD,MAAM,WAAW,kBAAkB;IAEjC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAEpD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,WAAW,CAAC;IAE1C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAKD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,MAAM,WAAW,eAAe,CAAC,KAAK;IAIpC,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,KAAK,YAAY,CAAC;IAM5E,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;CACpD;AAKD,MAAM,WAAW,aAAa;IAE5B,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEpB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAKD,MAAM,WAAW,cAAc;IAI7B,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,YAAY,CAAC;IAMjD,KAAK,EAAE,MAAM,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAQD,MAAM,WAAW,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG;IAGrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAIrB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAEpD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,mBAAmB,EAAE,MAAM,CAAC;IAI5B,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAIjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAIzC,aAAa,EAAE,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAEhD,eAAe,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAExC,cAAc,EAAE,cAAc,CAAC;IAI/B,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,WAAW,CAAC;IAG5C,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAKD,MAAM,WAAW,mBAAmB,CAAC,KAAK;IACxC,QAAQ,EAAE,KAAK,EAAE,CAAC;CACnB;AAMD,MAAM,WAAW,aAAa,CAAC,KAAK;IAElC,kBAAkB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAEzC,cAAc,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACxC;AAKD,MAAM,WAAW,UAAU;IAEzB,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAE5C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAKD,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IAErD,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB"}

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"}