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

package/package.json

@@ -1,35 +1,36 @@
 {
   "name": "@universityofmaryland/web-feeds-library",
-  "version": "1.3.0-beta.0",
+  "version": "1.3.0-beta.1",
   "description": "UMD Feed Elements",
+  "type": "module",
   "main": "dist/index.js",
-  "module": "dist/index.mjs",
+  "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./academic": {
       "types": "./dist/academic.d.ts",
-      "import": "./dist/academic.mjs",
-      "require": "./dist/academic.js"
+      "import": "./dist/academic.js",
+      "default": "./dist/academic.js"
     },
     "./events": {
       "types": "./dist/events.d.ts",
-      "import": "./dist/events.mjs",
-      "require": "./dist/events.js"
+      "import": "./dist/events.js",
+      "default": "./dist/events.js"
     },
     "./experts": {
       "types": "./dist/experts.d.ts",
-      "import": "./dist/experts.mjs",
-      "require": "./dist/experts.js"
+      "import": "./dist/experts.js",
+      "default": "./dist/experts.js"
     },
     "./news": {
       "types": "./dist/news.d.ts",
-      "import": "./dist/news.mjs",
-      "require": "./dist/news.js"
+      "import": "./dist/news.js",
+      "default": "./dist/news.js"
     }
   },
   "license": "MIT",
@@ -56,10 +57,10 @@
   },
   "dependencies": {
     "@types/postcss-js": "^4.0.4",
-    "@universityofmaryland/web-token-library": "^1.0.0",
-    "@universityofmaryland/web-styles-library": "^1.0.0",
     "@universityofmaryland/web-builder-library": "^1.0.0",
     "@universityofmaryland/web-elements-library": "^1.0.0",
+    "@universityofmaryland/web-styles-library": "^1.0.0",
+    "@universityofmaryland/web-token-library": "^1.0.0",
     "@universityofmaryland/web-utilities-library": "^1.0.0"
   },
   "devDependencies": {

package/dist/academic.mjs

@@ -1,5 +0,0 @@
-import { default as default2 } from "./feeds/academic/slider.mjs";
-export {
-  default2 as slider
-};
-//# sourceMappingURL=academic.mjs.map

package/dist/academic.mjs.map

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

package/dist/events.mjs

@@ -1,11 +0,0 @@
-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,
-  default3 as list,
-  default4 as slider
-};
-//# sourceMappingURL=events.mjs.map

package/dist/events.mjs.map

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

package/dist/experts.mjs

@@ -1,9 +0,0 @@
-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

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

package/dist/factory/core/createBaseFeed.mjs

@@ -1,114 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/helpers/displayHandler.mjs

@@ -1,169 +0,0 @@
-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.mjs";
-import { PaginationState } from "../../states/pagination.mjs";
-import { Announcer } from "../../states/announcer.mjs";
-import { dispatch, eventNames } from "../../helpers/events/index.mjs";
-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.mjs.map

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

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

@@ -1,32 +0,0 @@
-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.mjs.map

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

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

@@ -1,123 +0,0 @@
-import * as Styles from "@universityofmaryland/web-styles-library";
-import { LoadingState } from "../../states/loading.mjs";
-import "@universityofmaryland/web-builder-library";
-import "@universityofmaryland/web-elements-library";
-import "@universityofmaryland/web-utilities-library/theme";
-import { Announcer } from "../../states/announcer.mjs";
-function createFetchHandlers(config) {
-  const {
-    fetchStrategy,
-    helpers,
-    baseProps,
-    displayHandlers,
-    layoutElement,
-    isThemeDark,
-    enableCategoryFallback = false
-  } = config;
-  const loadMore = async () => {
-    const container = helpers.getContainer();
-    const currentCount = helpers.getOffset();
-    const totalEntries = helpers.getTotalEntries();
-    const existingPagination = container.querySelector(
-      `.${Styles.layout.alignment.block.center.className}`
-    );
-    existingPagination?.remove();
-    const loading = new LoadingState({ isThemeDark });
-    loading.show(container);
-    const variables = fetchStrategy.composeApiVariables({
-      ...baseProps,
-      getOffset: helpers.getOffset
-    });
-    const feedData = await fetchStrategy.fetchEntries(variables);
-    if (feedData) {
-      loading.hide();
-      await displayHandlers.displayResults({ feedData });
-      const message = `Showing ${currentCount + feedData.length} of ${totalEntries} articles`;
-      const existingAnnouncer = container.querySelector(
-        '[role="status"]'
-      );
-      if (existingAnnouncer) {
-        existingAnnouncer.textContent = message;
-      } else {
-        const announcer = new Announcer({ message });
-        container.appendChild(announcer.getElement());
-      }
-    } else {
-      loading.hide();
-      displayHandlers.displayNoResults({
-        message: "An error occurred while loading more results."
-      });
-    }
-  };
-  const start = async () => {
-    const variables = fetchStrategy.composeApiVariables({
-      ...baseProps,
-      getOffset: helpers.getOffset
-    });
-    const count = await fetchStrategy.fetchCount(variables);
-    if (count === 0) {
-      if (enableCategoryFallback && baseProps.categories && baseProps.categories.length > 0) {
-        const fallbackVariables = fetchStrategy.composeApiVariables({
-          ...baseProps,
-          categories: void 0,
-          getOffset: helpers.getOffset
-        });
-        const fallbackCount = await fetchStrategy.fetchCount(fallbackVariables);
-        if (fallbackCount && fallbackCount > 0) {
-          helpers.setTotalEntries(fallbackCount);
-          const fallbackData = await fetchStrategy.fetchEntries(
-            fallbackVariables
-          );
-          if (fallbackData && fallbackData.length > 0) {
-            let categoryNames = await fetchStrategy.fetchCategoryNames?.(
-              baseProps.categories,
-              baseProps.token
-            );
-            if (!categoryNames || categoryNames.length === 0) {
-              categoryNames = baseProps.categories.map(
-                (id) => id.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ")
-              );
-            }
-            await displayHandlers.displayResultStart({
-              feedData: fallbackData,
-              layoutElement,
-              isFallback: true,
-              categoryNames
-            });
-            return;
-          }
-        }
-      }
-      displayHandlers.displayNoResults({});
-      return;
-    }
-    if (count === null) {
-      displayHandlers.displayNoResults({
-        message: "An error occurred while fetching the data."
-      });
-      return;
-    }
-    if (count) {
-      helpers.setTotalEntries(count);
-    }
-    const feedData = await fetchStrategy.fetchEntries(variables);
-    if (feedData && feedData.length > 0) {
-      await displayHandlers.displayResultStart({
-        feedData,
-        layoutElement
-      });
-    } else {
-      displayHandlers.displayNoResults({
-        message: "An error occurred while fetching the data."
-      });
-    }
-  };
-  return {
-    start,
-    loadMore
-  };
-}
-export {
-  createFetchHandlers
-};
-//# sourceMappingURL=fetchHandler.mjs.map

package/dist/factory/helpers/fetchHandler.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetchHandler.mjs","sources":["../../../source/factory/helpers/fetchHandler.ts"],"sourcesContent":["/**\n * Fetch Handler Utilities\n *\n * Creates handlers for fetching feed data using a fetch strategy.\n * Handles both initial fetch and lazy-loaded fetches.\n *\n * @module factory/helpers/fetchHandler\n */\n\nimport * as Styles from '@universityofmaryland/web-styles-library';\nimport { LoadingState, Announcer } from '../../states';\nimport { FetchStrategy, FeedHelpers } from '../core/types';\n\n/**\n * Configuration for creating fetch handlers\n */\ninterface FetchHandlerConfig<TData, TVariables> {\n  /** Strategy for fetching data */\n  fetchStrategy: FetchStrategy<TData, TVariables>;\n  /** Feed helper functions */\n  helpers: FeedHelpers;\n  /** Base props for composing API variables */\n  baseProps: any;\n  /** Display handlers */\n  displayHandlers: {\n    displayResultStart: (props: any) => Promise<void>;\n    displayResults: (props: { feedData: TData[] }) => Promise<void>;\n    displayNoResults: (props: any) => void;\n  };\n  /** Layout element */\n  layoutElement: any;\n  /** Whether theme is dark */\n  isThemeDark?: boolean;\n  /** Whether to enable category fallback (show all results when no category results found) */\n  enableCategoryFallback?: boolean;\n}\n\n/**\n * Create fetch handlers for a feed\n *\n * Returns handlers for:\n * - Initial data fetch (with count)\n * - Lazy load fetch (pagination)\n *\n * @param config - Configuration for the fetch handlers\n * @returns Fetch handler functions\n *\n * @example\n * ```typescript\n * const fetchHandlers = createFetchHandlers({\n *   fetchStrategy: eventsFetchStrategy,\n *   helpers: feedHelpers,\n *   baseProps: { token, categories },\n *   displayHandlers,\n *   layoutElement,\n *   isThemeDark: false,\n * });\n *\n * // Start initial fetch\n * await fetchHandlers.start();\n *\n * // Fetch more results\n * await fetchHandlers.loadMore();\n * ```\n */\nexport function createFetchHandlers<TData, TVariables>(\n  config: FetchHandlerConfig<TData, TVariables>,\n) {\n  const {\n    fetchStrategy,\n    helpers,\n    baseProps,\n    displayHandlers,\n    layoutElement,\n    isThemeDark,\n    enableCategoryFallback = false,\n  } = config;\n\n  /**\n   * Handle lazy loading more results\n   */\n  const loadMore = async (): Promise<void> => {\n    const container = helpers.getContainer();\n    const currentCount = helpers.getOffset();\n    const totalEntries = helpers.getTotalEntries();\n\n    // Remove existing pagination\n    const existingPagination = container.querySelector(\n      `.${Styles.layout.alignment.block.center.className}`,\n    );\n    existingPagination?.remove();\n\n    // Show loading state\n    const loading = new LoadingState({ isThemeDark });\n    loading.show(container);\n\n    // Compose API variables\n    const variables = fetchStrategy.composeApiVariables({\n      ...baseProps,\n      getOffset: helpers.getOffset,\n    });\n\n    // Fetch entries\n    const feedData = await fetchStrategy.fetchEntries(variables);\n\n    if (feedData) {\n      loading.hide();\n      await displayHandlers.displayResults({ feedData });\n\n      // Update announcer with new count\n      const message = `Showing ${\n        currentCount + feedData.length\n      } of ${totalEntries} articles`;\n\n      const existingAnnouncer = container.querySelector(\n        '[role=\"status\"]',\n      ) as HTMLElement;\n      if (existingAnnouncer) {\n        existingAnnouncer.textContent = message;\n      } else {\n        const announcer = new Announcer({ message });\n        container.appendChild(announcer.getElement());\n      }\n    } else {\n      loading.hide();\n      displayHandlers.displayNoResults({\n        message: 'An error occurred while loading more results.',\n      });\n    }\n  };\n\n  /**\n   * Handle initial fetch (with count)\n   */\n  const start = async (): Promise<void> => {\n    const variables = fetchStrategy.composeApiVariables({\n      ...baseProps,\n      getOffset: helpers.getOffset,\n    });\n\n    const count = await fetchStrategy.fetchCount(variables);\n\n    if (count === 0) {\n      // Only attempt category fallback if explicitly enabled (for events feeds)\n      if (enableCategoryFallback && baseProps.categories && baseProps.categories.length > 0) {\n        const fallbackVariables = fetchStrategy.composeApiVariables({\n          ...baseProps,\n          categories: undefined,\n          getOffset: helpers.getOffset,\n        });\n\n        const fallbackCount = await fetchStrategy.fetchCount(fallbackVariables);\n\n        if (fallbackCount && fallbackCount > 0) {\n          helpers.setTotalEntries(fallbackCount);\n\n          const fallbackData = await fetchStrategy.fetchEntries(\n            fallbackVariables,\n          );\n\n          if (fallbackData && fallbackData.length > 0) {\n            // Fetch category names from API\n            let categoryNames = await fetchStrategy.fetchCategoryNames?.(\n              baseProps.categories,\n              baseProps.token,\n            );\n\n            // If fetch fails, format IDs as fallback\n            if (!categoryNames || categoryNames.length === 0) {\n              categoryNames = baseProps.categories.map((id: string) =>\n                id\n                  .split('-')\n                  .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n                  .join(' '),\n              );\n            }\n\n            await displayHandlers.displayResultStart({\n              feedData: fallbackData,\n              layoutElement,\n              isFallback: true,\n              categoryNames,\n            });\n            return;\n          }\n        }\n      }\n\n      displayHandlers.displayNoResults({});\n      return;\n    }\n\n    if (count === null) {\n      displayHandlers.displayNoResults({\n        message: 'An error occurred while fetching the data.',\n      });\n      return;\n    }\n\n    if (count) {\n      helpers.setTotalEntries(count);\n    }\n\n    // Fetch entries\n    const feedData = await fetchStrategy.fetchEntries(variables);\n\n    if (feedData && feedData.length > 0) {\n      await displayHandlers.displayResultStart({\n        feedData,\n        layoutElement,\n      });\n    } else {\n      displayHandlers.displayNoResults({\n        message: 'An error occurred while fetching the data.',\n      });\n    }\n  };\n\n  return {\n    start,\n    loadMore,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/feeds/academic/slider.mjs

@@ -1,11 +0,0 @@
-import slider$1 from "../../widgets/slider.mjs";
-import { ACADEMIC_SLIDER_QUERY } from "../../strategies/fetch/academic.mjs";
-const slider = (props) => slider$1({
-  ...props,
-  query: ACADEMIC_SLIDER_QUERY,
-  url: "https://provost.umd.edu/graphql"
-});
-export {
-  slider as default
-};
-//# sourceMappingURL=slider.mjs.map

package/dist/feeds/academic/slider.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"slider.mjs","sources":["../../../source/feeds/academic/slider.ts"],"sourcesContent":["/**\n * Academic Slider Feed (Migrated)\n *\n * Displays academic events in a horizontal carousel layout.\n * Uses strategy pattern for GraphQL queries.\n *\n * @module composite/academic/slider-new\n */\n\nimport { slider } from '../../widgets';\nimport { ACADEMIC_SLIDER_QUERY } from '../../strategies/fetch/academic';\nimport { type AcademicSliderProps } from './_types';\nimport { type ElementModel } from '../../_types';\n\n/**\n * Creates an academic events slider feed\n *\n * @param props - Slider configuration options\n * @returns ElementModel with slider element and styles\n *\n * @example\n * ```typescript\n * const academicSlider = slider({\n *   token: 'your-token',\n *   categories: 'engineering,science',\n *   isThemeDark: false,\n * });\n * ```\n */\nexport default (props: AcademicSliderProps): ElementModel =>\n  slider({\n    ...props,\n    query: ACADEMIC_SLIDER_QUERY,\n    url: 'https://provost.umd.edu/graphql',\n  });\n"],"names":["slider"],"mappings":";;AA6BA,MAAA,SAAe,CAAC,UACdA,SAAO;AAAA,EACL,GAAG;AAAA,EACH,OAAO;AAAA,EACP,KAAK;AACP,CAAC;"}