@universityofmaryland/web-components-library 1.15.2 → 1.15.4

package/README.md

@@ -1,6 +1,6 @@
 # University of Maryland Web Components Library
 
-[![Components Version](https://img.shields.io/badge/Components-v1.15.2-blue)](https://www.npmjs.com/package/@universityofmaryland/web-components-library)
+[![Components Version](https://img.shields.io/badge/Components-v1.15.4-blue)](https://www.npmjs.com/package/@universityofmaryland/web-components-library)
 
 High-level web components built on the UMD Elements Library, providing feature-rich, accessible, and brand-compliant UI components for University of Maryland digital experiences.
 
@@ -254,10 +254,10 @@ if (card) {
 
 ## Documentation
 
-- **[Component Reference](./)** - Complete API documentation
-- **[Usage Examples](./usage.html)** - Practical implementation guide with real-world examples
-- **[Advanced Guide](./advanced-usage.html)** - TypeScript, testing, reactive components, and custom development
-- **[Advanced Bundling](./advanced-bundling.html)** - Bundle optimization, tree-shaking, and production build strategies
+- **[Component Reference](index.html)** - Complete API documentation
+- **[Usage Examples](usage.html)** - Practical implementation guide with real-world examples
+- **[Advanced Guide](advanced-usage.html)** - TypeScript, testing, reactive components, and custom development
+- **[Advanced Bundling](advanced-bundling.html)** - Bundle optimization, tree-shaking, and production build strategies
 - **[Design System](https://designsystem.umd.edu)** - Full design system docs
 
 ## Testing

package/dist/{_event-CAoIFfdx.js → _event-DhP9w0Ua.js}

@@ -1,7 +1,7 @@
 import { events as i } from "@universityofmaryland/web-elements-library/atomic";
 import * as s from "@universityofmaryland/web-utilities-library/date";
-import { i as m, a as c, s as r } from "./shared/model-CT9T0AFq.js";
-import "./shared/utilities-Cykos7qZ.js";
+import { i as m, a as c, s as r } from "./shared/model-ThkSRfd8.js";
+import "./shared/utilities-BsQFBpVx.js";
 const D = (t) => ({
   startDate: t.querySelector(`[slot="${r.name.DATE_START_ISO}"]`),
   endDate: t.querySelector(`[slot="${r.name.DATE_END_ISO}"]`),
@@ -56,4 +56,4 @@ const D = (t) => ({
 export {
   p as e
 };
-//# sourceMappingURL=_event-CAoIFfdx.js.map
+//# sourceMappingURL=_event-DhP9w0Ua.js.map

package/dist/{_event-CAoIFfdx.js.map → _event-DhP9w0Ua.js.map}

@@ -1 +1 @@
-{"version":3,"file":"_event-CAoIFfdx.js","sources":["../source/api/_event.ts"],"sourcesContent":["import { events } from '@universityofmaryland/web-elements-library/atomic';\nimport * as date from '@universityofmaryland/web-utilities-library/date';\nimport { Attributes, Slots } from 'model';\n\n/**\n * Configuration options for creating event components\n */\ninterface EventComponentOptions {\n  /** Whether to use dark theme for event details */\n  isThemeDark?: boolean;\n  /** Whether to show time in event details */\n  showTime?: boolean;\n  /** Whether to use large size for date sign */\n  isLargeSize?: boolean;\n  /** Whether to use dark theme for date sign (separate from event details) */\n  isDateSignDark?: boolean;\n}\n\n/**\n * Parsed event data ready for component creation\n */\ninterface ParsedEventData {\n  /** Processed date and location data from Markup.event.createDetailsData */\n  detailsData: ReturnType<typeof date.createEventDetails>;\n  /** Parsed start date object */\n  startDate: ReturnType<typeof date.parseDateFromElement>;\n  /** Parsed end date object (optional) */\n  endDate: ReturnType<typeof date.parseDateFromElement>;\n  /** Location element (optional) */\n  locationElement: Element | null;\n}\n\n/**\n * Element visual structure matching the return type from elements library\n */\ninterface ElementVisualComponent {\n  element: HTMLElement;\n  className: string;\n  styles: string;\n}\n\n/**\n * Result containing created event components\n */\ninterface EventComponents {\n  /** Event details/meta component */\n  eventMeta: ElementVisualComponent;\n  /** Date sign component */\n  dateSign: ElementVisualComponent;\n}\n\n/**\n * Raw event slot elements extracted from the host element\n */\ninterface EventSlots {\n  startDate: Element | null;\n  endDate: Element | null;\n  location: Element | null;\n}\n\n/**\n * Extracts event-related slot elements from the host element\n *\n * @param element - The host HTML element containing slotted content\n * @returns Object containing the extracted slot elements\n */\nconst extractEventSlots = (element: HTMLElement): EventSlots => ({\n  startDate: element.querySelector(`[slot=\"${Slots.name.DATE_START_ISO}\"]`),\n  endDate: element.querySelector(`[slot=\"${Slots.name.DATE_END_ISO}\"]`),\n  location: element.querySelector(`[slot=\"${Slots.name.contact.location}\"]`),\n});\n\n/**\n * Parses event data from slot elements\n *\n * @param slots - The extracted slot elements\n * @returns Parsed event data or null if start date is missing\n */\nconst parseEventData = (slots: EventSlots): ParsedEventData | null => {\n  const startDate = date.parseDateFromElement({ element: slots.startDate });\n\n  if (!startDate) {\n    return null;\n  }\n\n  const endDate = date.parseDateFromElement({ element: slots.endDate });\n\n  const detailsData = date.createEventDetails({\n    locationElement: slots.location,\n    startDate,\n    endDate,\n  });\n\n  return {\n    detailsData,\n    startDate,\n    endDate,\n    locationElement: slots.location,\n  };\n};\n\n/**\n * Extracts event configuration from element attributes\n *\n * @param element - The host HTML element\n * @returns Configuration options for event components\n */\nconst extractEventConfig = (element: HTMLElement): EventComponentOptions => ({\n  isThemeDark:\n    Attributes.isTheme.dark({ element }) ||\n    Attributes.isTheme.maryland({ element }),\n  showTime: Attributes.isVisual.showTime({ element }),\n});\n\n/**\n * Creates event meta and date sign components\n *\n * @param eventData - Parsed event data\n * @param options - Configuration options for the components\n * @returns Object containing the created components\n */\nexport const createEventComponents = (\n  eventData: ParsedEventData,\n  options: EventComponentOptions = {},\n): EventComponents => {\n  const {\n    isThemeDark = false,\n    showTime = false,\n    isLargeSize = false,\n    isDateSignDark,\n  } = options;\n\n  return {\n    eventMeta: events.meta({\n      ...eventData.detailsData,\n      isThemeDark,\n      showTime,\n    }),\n    dateSign: events.sign({\n      ...eventData.detailsData,\n      isThemeDark: isDateSignDark ?? isThemeDark,\n      isLargeSize,\n    }),\n  };\n};\n\n/**\n * Main function to extract and process event data from an element\n *\n * This is the primary API for working with event components. It:\n * 1. Extracts event slots from the element\n * 2. Parses the event data\n * 3. Creates configured event components\n *\n * @param element - The host HTML element containing event data\n * @param options - Optional configuration overrides\n * @returns Event components or null if required data is missing\n *\n * @example\n * ```typescript\n * // Basic usage - extracts everything from element\n * const eventData = extractEventData(element);\n * if (eventData) {\n *   const { eventMeta, dateSign } = eventData;\n *   // Use components...\n * }\n *\n * // With custom options\n * const eventData = extractEventData(element, {\n *   isLargeSize: true,\n *   isDateSignDark: false\n * });\n * ```\n */\nexport const extractEventData = (\n  element: HTMLElement,\n  options?: Partial<EventComponentOptions>,\n): EventComponents | null => {\n  const slots = extractEventSlots(element);\n  const eventData = parseEventData(slots);\n\n  if (!eventData) {\n    return null;\n  }\n\n  const config = {\n    ...extractEventConfig(element),\n    ...options,\n  };\n\n  return createEventComponents(eventData, config);\n};\n"],"names":["extractEventSlots","element","Slots","parseEventData","slots","startDate","date","endDate","extractEventConfig","Attributes.isTheme","Attributes.isVisual","createEventComponents","eventData","options","isThemeDark","showTime","isLargeSize","isDateSignDark","events","extractEventData","config"],"mappings":";;;;AAkEA,MAAMA,IAAoB,CAACC,OAAsC;AAAA,EAC/D,WAAWA,EAAQ,cAAc,UAAUC,EAAM,KAAK,cAAc,IAAI;AAAA,EACxE,SAASD,EAAQ,cAAc,UAAUC,EAAM,KAAK,YAAY,IAAI;AAAA,EACpE,UAAUD,EAAQ,cAAc,UAAUC,EAAM,KAAK,QAAQ,QAAQ,IAAI;AAC3E,IAQMC,IAAiB,CAACC,MAA8C;AACpE,QAAMC,IAAYC,EAAK,qBAAqB,EAAE,SAASF,EAAM,WAAW;AAExE,MAAI,CAACC;AACH,WAAO;AAGT,QAAME,IAAUD,EAAK,qBAAqB,EAAE,SAASF,EAAM,SAAS;AAQpE,SAAO;AAAA,IACL,aAPkBE,EAAK,mBAAmB;AAAA,MAC1C,iBAAiBF,EAAM;AAAA,MACvB,WAAAC;AAAA,MACA,SAAAE;AAAA,IAAA,CACD;AAAA,IAIC,WAAAF;AAAA,IACA,SAAAE;AAAA,IACA,iBAAiBH,EAAM;AAAA,EAAA;AAE3B,GAQMI,IAAqB,CAACP,OAAiD;AAAA,EAC3E,aACEQ,EAAmB,KAAK,EAAE,SAAAR,EAAA,CAAS,KACnCQ,EAAmB,SAAS,EAAE,SAAAR,GAAS;AAAA,EACzC,UAAUS,EAAoB,SAAS,EAAE,SAAAT,GAAS;AACpD,IASaU,IAAwB,CACnCC,GACAC,IAAiC,OACb;AACpB,QAAM;AAAA,IACJ,aAAAC,IAAc;AAAA,IACd,UAAAC,IAAW;AAAA,IACX,aAAAC,IAAc;AAAA,IACd,gBAAAC;AAAA,EAAA,IACEJ;AAEJ,SAAO;AAAA,IACL,WAAWK,EAAO,KAAK;AAAA,MACrB,GAAGN,EAAU;AAAA,MACb,aAAAE;AAAA,MACA,UAAAC;AAAA,IAAA,CACD;AAAA,IACD,UAAUG,EAAO,KAAK;AAAA,MACpB,GAAGN,EAAU;AAAA,MACb,aAAaK,KAAkBH;AAAA,MAC/B,aAAAE;AAAA,IAAA,CACD;AAAA,EAAA;AAEL,GA8BaG,IAAmB,CAC9BlB,GACAY,MAC2B;AAC3B,QAAMT,IAAQJ,EAAkBC,CAAO,GACjCW,IAAYT,EAAeC,CAAK;AAEtC,MAAI,CAACQ;AACH,WAAO;AAGT,QAAMQ,IAAS;AAAA,IACb,GAAGZ,EAAmBP,CAAO;AAAA,IAC7B,GAAGY;AAAA,EAAA;AAGL,SAAOF,EAAsBC,GAAWQ,CAAM;AAChD;"}
+{"version":3,"file":"_event-DhP9w0Ua.js","sources":["../source/api/_event.ts"],"sourcesContent":["import { events } from '@universityofmaryland/web-elements-library/atomic';\nimport * as date from '@universityofmaryland/web-utilities-library/date';\nimport { Attributes, Slots } from 'model';\n\n/**\n * Configuration options for creating event components\n */\ninterface EventComponentOptions {\n  /** Whether to use dark theme for event details */\n  isThemeDark?: boolean;\n  /** Whether to show time in event details */\n  showTime?: boolean;\n  /** Whether to use large size for date sign */\n  isLargeSize?: boolean;\n  /** Whether to use dark theme for date sign (separate from event details) */\n  isDateSignDark?: boolean;\n}\n\n/**\n * Parsed event data ready for component creation\n */\ninterface ParsedEventData {\n  /** Processed date and location data from Markup.event.createDetailsData */\n  detailsData: ReturnType<typeof date.createEventDetails>;\n  /** Parsed start date object */\n  startDate: ReturnType<typeof date.parseDateFromElement>;\n  /** Parsed end date object (optional) */\n  endDate: ReturnType<typeof date.parseDateFromElement>;\n  /** Location element (optional) */\n  locationElement: Element | null;\n}\n\n/**\n * Element visual structure matching the return type from elements library\n */\ninterface ElementVisualComponent {\n  element: HTMLElement;\n  className: string;\n  styles: string;\n}\n\n/**\n * Result containing created event components\n */\ninterface EventComponents {\n  /** Event details/meta component */\n  eventMeta: ElementVisualComponent;\n  /** Date sign component */\n  dateSign: ElementVisualComponent;\n}\n\n/**\n * Raw event slot elements extracted from the host element\n */\ninterface EventSlots {\n  startDate: Element | null;\n  endDate: Element | null;\n  location: Element | null;\n}\n\n/**\n * Extracts event-related slot elements from the host element\n *\n * @param element - The host HTML element containing slotted content\n * @returns Object containing the extracted slot elements\n */\nconst extractEventSlots = (element: HTMLElement): EventSlots => ({\n  startDate: element.querySelector(`[slot=\"${Slots.name.DATE_START_ISO}\"]`),\n  endDate: element.querySelector(`[slot=\"${Slots.name.DATE_END_ISO}\"]`),\n  location: element.querySelector(`[slot=\"${Slots.name.contact.location}\"]`),\n});\n\n/**\n * Parses event data from slot elements\n *\n * @param slots - The extracted slot elements\n * @returns Parsed event data or null if start date is missing\n */\nconst parseEventData = (slots: EventSlots): ParsedEventData | null => {\n  const startDate = date.parseDateFromElement({ element: slots.startDate });\n\n  if (!startDate) {\n    return null;\n  }\n\n  const endDate = date.parseDateFromElement({ element: slots.endDate });\n\n  const detailsData = date.createEventDetails({\n    locationElement: slots.location,\n    startDate,\n    endDate,\n  });\n\n  return {\n    detailsData,\n    startDate,\n    endDate,\n    locationElement: slots.location,\n  };\n};\n\n/**\n * Extracts event configuration from element attributes\n *\n * @param element - The host HTML element\n * @returns Configuration options for event components\n */\nconst extractEventConfig = (element: HTMLElement): EventComponentOptions => ({\n  isThemeDark:\n    Attributes.isTheme.dark({ element }) ||\n    Attributes.isTheme.maryland({ element }),\n  showTime: Attributes.isVisual.showTime({ element }),\n});\n\n/**\n * Creates event meta and date sign components\n *\n * @param eventData - Parsed event data\n * @param options - Configuration options for the components\n * @returns Object containing the created components\n */\nexport const createEventComponents = (\n  eventData: ParsedEventData,\n  options: EventComponentOptions = {},\n): EventComponents => {\n  const {\n    isThemeDark = false,\n    showTime = false,\n    isLargeSize = false,\n    isDateSignDark,\n  } = options;\n\n  return {\n    eventMeta: events.meta({\n      ...eventData.detailsData,\n      isThemeDark,\n      showTime,\n    }),\n    dateSign: events.sign({\n      ...eventData.detailsData,\n      isThemeDark: isDateSignDark ?? isThemeDark,\n      isLargeSize,\n    }),\n  };\n};\n\n/**\n * Main function to extract and process event data from an element\n *\n * This is the primary API for working with event components. It:\n * 1. Extracts event slots from the element\n * 2. Parses the event data\n * 3. Creates configured event components\n *\n * @param element - The host HTML element containing event data\n * @param options - Optional configuration overrides\n * @returns Event components or null if required data is missing\n *\n * @example\n * ```typescript\n * // Basic usage - extracts everything from element\n * const eventData = extractEventData(element);\n * if (eventData) {\n *   const { eventMeta, dateSign } = eventData;\n *   // Use components...\n * }\n *\n * // With custom options\n * const eventData = extractEventData(element, {\n *   isLargeSize: true,\n *   isDateSignDark: false\n * });\n * ```\n */\nexport const extractEventData = (\n  element: HTMLElement,\n  options?: Partial<EventComponentOptions>,\n): EventComponents | null => {\n  const slots = extractEventSlots(element);\n  const eventData = parseEventData(slots);\n\n  if (!eventData) {\n    return null;\n  }\n\n  const config = {\n    ...extractEventConfig(element),\n    ...options,\n  };\n\n  return createEventComponents(eventData, config);\n};\n"],"names":["extractEventSlots","element","Slots","parseEventData","slots","startDate","date","endDate","extractEventConfig","Attributes.isTheme","Attributes.isVisual","createEventComponents","eventData","options","isThemeDark","showTime","isLargeSize","isDateSignDark","events","extractEventData","config"],"mappings":";;;;AAkEA,MAAMA,IAAoB,CAACC,OAAsC;AAAA,EAC/D,WAAWA,EAAQ,cAAc,UAAUC,EAAM,KAAK,cAAc,IAAI;AAAA,EACxE,SAASD,EAAQ,cAAc,UAAUC,EAAM,KAAK,YAAY,IAAI;AAAA,EACpE,UAAUD,EAAQ,cAAc,UAAUC,EAAM,KAAK,QAAQ,QAAQ,IAAI;AAC3E,IAQMC,IAAiB,CAACC,MAA8C;AACpE,QAAMC,IAAYC,EAAK,qBAAqB,EAAE,SAASF,EAAM,WAAW;AAExE,MAAI,CAACC;AACH,WAAO;AAGT,QAAME,IAAUD,EAAK,qBAAqB,EAAE,SAASF,EAAM,SAAS;AAQpE,SAAO;AAAA,IACL,aAPkBE,EAAK,mBAAmB;AAAA,MAC1C,iBAAiBF,EAAM;AAAA,MACvB,WAAAC;AAAA,MACA,SAAAE;AAAA,IAAA,CACD;AAAA,IAIC,WAAAF;AAAA,IACA,SAAAE;AAAA,IACA,iBAAiBH,EAAM;AAAA,EAAA;AAE3B,GAQMI,IAAqB,CAACP,OAAiD;AAAA,EAC3E,aACEQ,EAAmB,KAAK,EAAE,SAAAR,EAAA,CAAS,KACnCQ,EAAmB,SAAS,EAAE,SAAAR,GAAS;AAAA,EACzC,UAAUS,EAAoB,SAAS,EAAE,SAAAT,GAAS;AACpD,IASaU,IAAwB,CACnCC,GACAC,IAAiC,OACb;AACpB,QAAM;AAAA,IACJ,aAAAC,IAAc;AAAA,IACd,UAAAC,IAAW;AAAA,IACX,aAAAC,IAAc;AAAA,IACd,gBAAAC;AAAA,EAAA,IACEJ;AAEJ,SAAO;AAAA,IACL,WAAWK,EAAO,KAAK;AAAA,MACrB,GAAGN,EAAU;AAAA,MACb,aAAAE;AAAA,MACA,UAAAC;AAAA,IAAA,CACD;AAAA,IACD,UAAUG,EAAO,KAAK;AAAA,MACpB,GAAGN,EAAU;AAAA,MACb,aAAaK,KAAkBH;AAAA,MAC/B,aAAAE;AAAA,IAAA,CACD;AAAA,EAAA;AAEL,GA8BaG,IAAmB,CAC9BlB,GACAY,MAC2B;AAC3B,QAAMT,IAAQJ,EAAkBC,CAAO,GACjCW,IAAYT,EAAeC,CAAK;AAEtC,MAAI,CAACQ;AACH,WAAO;AAGT,QAAMQ,IAAS;AAAA,IACb,GAAGZ,EAAmBP,CAAO;AAAA,IAC7B,GAAGY;AAAA,EAAA;AAGL,SAAOF,EAAsBC,GAAWQ,CAAM;AAChD;"}

package/dist/api/footer/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../source/api/footer/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,cAAc,CAAC;AAQtB,eAAO,MAAM,KAAK;;;;;;;;;;;;CAYjB,CAAC;AA8LF,QAAA,MAAM,aAAa,EAAE,qBAInB,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../source/api/footer/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,cAAc,CAAC;AAQtB,eAAO,MAAM,KAAK;;;;;;;;;;;;CAYjB,CAAC;AAgMF,QAAA,MAAM,aAAa,EAAE,qBAInB,CAAC;AAEH,eAAe,aAAa,CAAC"}