@sp-days-framework/docusaurus-frontpage-collection 1.0.0

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;AAEH,kBAAkB;AAClB,mDAAkD;AAAzC,0GAAA,WAAW,OAAA;AACpB,iDAAgD;AAAvC,wGAAA,UAAU,OAAA;AACnB,yCAA4D;AAAnD,iGAAA,OAAO,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,iGAAA,OAAO,OAAA;AACnC,+CAI2B;AAHzB,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,iHAAA,oBAAoB,OAAA;AAgBtB,kBAAkB;AAClB,4CAA2C;AAAlC,8FAAA,KAAK,OAAA;AACd,4CAA6D;AAApD,sHAAA,OAAO,OAAgB;AAGhC,uCAAuC;AACvC,gDAA4D;AAAnD,kGAAA,OAAO,OAAA;AAAE,+FAAA,IAAI,OAAA;AAAE,gGAAA,KAAK,OAAA;AAC7B,gDAAiE;AAAxD,0HAAA,OAAO,OAAkB;AAGlC,6CAA6C;AAC7C,4DAIoC;AAHlC,8GAAA,aAAa,OAAA;AACb,yGAAA,QAAQ,OAAA;AACR,4GAAA,WAAW,OAAA;AAEb,4DAA6E;AAApE,sIAAA,OAAO,OAAwB;AAOxC,wBAAwB;AACxB,wDAAuD;AAA9C,0GAAA,WAAW,OAAA;AACpB,wDAAyE;AAAhE,kIAAA,OAAO,OAAsB;AAGtC,0CAA0C;AAC1C,sDAA2E;AAAlE,wGAAA,UAAU,OAAA;AAAE,qGAAA,OAAO,OAAA;AAAE,yGAAA,WAAW,OAAA;AACzC,sDAAuE;AAA9D,gIAAA,OAAO,OAAqB;AAOrC,uBAAuB;AACvB,sDAAqD;AAA5C,wGAAA,UAAU,OAAA;AACnB,sDAAuE;AAA9D,gIAAA,OAAO,OAAqB;AAGrC,qDAAqD;AACrD,4DAGoC;AAFlC,sHAAA,qBAAqB,OAAA;AACrB,mHAAA,kBAAkB,OAAA;AAEpB,4DAAqF;AAA5E,8IAAA,OAAO,OAAgC;AAMhD,oBAAoB;AACpB,gDAA+C;AAAtC,kGAAA,OAAO,OAAA;AAChB,gDAAiE;AAAxD,0HAAA,OAAO,OAAkB"}

package/lib/utils/IconifyIcon.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { IconifyIconProps } from './types';
+/**
+ * IconifyIcon Component
+ *
+ * A wrapper around @iconify/react Icon component with sensible defaults.
+ * Supports rendering any icon from Iconify's vast collection.
+ *
+ * @example
+ * ```tsx
+ * <IconifyIcon icon="mdi-light:home" color="#1976d2" width={24} height={24} />
+ * <IconifyIcon icon="simple-icons:github" />
+ * ```
+ */
+export declare const IconifyIcon: React.FC<IconifyIconProps>;
+export default IconifyIcon;
+//# sourceMappingURL=IconifyIcon.d.ts.map

package/lib/utils/IconifyIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconifyIcon.d.ts","sourceRoot":"","sources":["../../src/utils/IconifyIcon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAkBlD,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/lib/utils/IconifyIcon.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IconifyIcon = void 0;
+const react_1 = __importDefault(require("react"));
+const react_2 = require("@iconify/react");
+/**
+ * IconifyIcon Component
+ *
+ * A wrapper around @iconify/react Icon component with sensible defaults.
+ * Supports rendering any icon from Iconify's vast collection.
+ *
+ * @example
+ * ```tsx
+ * <IconifyIcon icon="mdi-light:home" color="#1976d2" width={24} height={24} />
+ * <IconifyIcon icon="simple-icons:github" />
+ * ```
+ */
+const IconifyIcon = ({ icon, color, width = 24, height = 24, className, style, }) => {
+    return (react_1.default.createElement(react_2.Icon, { icon: icon, color: color, width: width, height: height, className: className, style: style }));
+};
+exports.IconifyIcon = IconifyIcon;
+exports.default = exports.IconifyIcon;
+//# sourceMappingURL=IconifyIcon.js.map

package/lib/utils/IconifyIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconifyIcon.js","sourceRoot":"","sources":["../../src/utils/IconifyIcon.tsx"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,0CAAsC;AAGtC;;;;;;;;;;;GAWG;AACI,MAAM,WAAW,GAA+B,CAAC,EACtD,IAAI,EACJ,KAAK,EACL,KAAK,GAAG,EAAE,EACV,MAAM,GAAG,EAAE,EACX,SAAS,EACT,KAAK,GACN,EAAE,EAAE;IACH,OAAO,CACL,8BAAC,YAAI,IACH,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,GACZ,CACH,CAAC;AACJ,CAAC,CAAC;AAlBW,QAAA,WAAW,eAkBtB;AAEF,kBAAe,mBAAW,CAAC"}

package/lib/utils/InlineSvg.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+export interface InlineSvgProps {
+    /** Path to the SVG file */
+    src: string;
+    /** Alt text for accessibility */
+    alt?: string;
+    /** Additional CSS class */
+    className?: string;
+    /** Additional inline styles */
+    style?: React.CSSProperties;
+}
+/**
+ * InlineSvg Component
+ *
+ * Fetches an SVG file and renders it inline as HTML.
+ * This allows CSS color properties (like currentColor) to work properly.
+ *
+ * @example
+ * ```tsx
+ * <InlineSvg
+ *   src="/img/icon.svg"
+ *   alt="My Icon"
+ *   className="my-icon"
+ * />
+ * ```
+ */
+export declare const InlineSvg: React.FC<InlineSvgProps>;
+export default InlineSvg;
+//# sourceMappingURL=InlineSvg.d.ts.map

package/lib/utils/InlineSvg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineSvg.d.ts","sourceRoot":"","sources":["../../src/utils/InlineSvg.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CA2D9C,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/lib/utils/InlineSvg.js

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InlineSvg = void 0;
+const react_1 = __importStar(require("react"));
+const logger_1 = require("./logger");
+/**
+ * InlineSvg Component
+ *
+ * Fetches an SVG file and renders it inline as HTML.
+ * This allows CSS color properties (like currentColor) to work properly.
+ *
+ * @example
+ * ```tsx
+ * <InlineSvg
+ *   src="/img/icon.svg"
+ *   alt="My Icon"
+ *   className="my-icon"
+ * />
+ * ```
+ */
+const InlineSvg = ({ src, alt = '', className, style, }) => {
+    const [svgContent, setSvgContent] = (0, react_1.useState)('');
+    const [error, setError] = (0, react_1.useState)(false);
+    (0, react_1.useEffect)(() => {
+        const fetchSvg = async () => {
+            try {
+                const response = await fetch(src);
+                if (!response.ok) {
+                    throw new Error(`Failed to fetch SVG: ${response.statusText}`);
+                }
+                const text = await response.text();
+                // Basic validation: check if it's actually SVG content
+                if (!text.trim().startsWith('<svg')) {
+                    throw new Error('Fetched content is not a valid SVG');
+                }
+                setSvgContent(text);
+            }
+            catch (err) {
+                (0, logger_1.logWarn)(`Failed to load inline SVG from "${src}": ${err instanceof Error ? err.message : 'Unknown error'}`);
+                setError(true);
+            }
+        };
+        fetchSvg();
+    }, [src]);
+    if (error) {
+        // Fallback to regular img tag if SVG fetch fails
+        return (react_1.default.createElement("img", { src: src, alt: alt, className: className, style: style }));
+    }
+    if (!svgContent) {
+        // Loading state - render empty div with same dimensions
+        return react_1.default.createElement("div", { className: className, style: style });
+    }
+    return (react_1.default.createElement("div", { className: className, style: style, dangerouslySetInnerHTML: { __html: svgContent }, role: "img", "aria-label": alt }));
+};
+exports.InlineSvg = InlineSvg;
+exports.default = exports.InlineSvg;
+//# sourceMappingURL=InlineSvg.js.map

package/lib/utils/InlineSvg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineSvg.js","sourceRoot":"","sources":["../../src/utils/InlineSvg.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAAmD;AACnD,qCAAmC;AAanC;;;;;;;;;;;;;;GAcG;AACI,MAAM,SAAS,GAA6B,CAAC,EAClD,GAAG,EACH,GAAG,GAAG,EAAE,EACR,SAAS,EACT,KAAK,GACN,EAAE,EAAE;IACH,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,IAAA,gBAAQ,EAAS,EAAE,CAAC,CAAC;IACzD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAU,KAAK,CAAC,CAAC;IAEnD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;YAC1B,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBACjE,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAEnC,uDAAuD;gBACvD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;gBACxD,CAAC;gBAED,aAAa,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAA,gBAAO,EAAC,mCAAmC,GAAG,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;gBAC5G,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;QACH,CAAC,CAAC;QAEF,QAAQ,EAAE,CAAC;IACb,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,IAAI,KAAK,EAAE,CAAC;QACV,iDAAiD;QACjD,OAAO,CACL,uCACE,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,GACZ,CACH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,wDAAwD;QACxD,OAAO,uCAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAI,CAAC;IACrD,CAAC;IAED,OAAO,CACL,uCACE,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,uBAAuB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAC/C,IAAI,EAAC,KAAK,gBACE,GAAG,GACf,CACH,CAAC;AACJ,CAAC,CAAC;AA3DW,QAAA,SAAS,aA2DpB;AAEF,kBAAe,iBAAS,CAAC"}

package/lib/utils/ThemedIcon.d.ts

@@ -0,0 +1,61 @@
+import React from 'react';
+import type { ThemedIconProps } from './types';
+/**
+ * ThemedIcon Component
+ *
+ * A flexible icon component that supports:
+ * - Iconify icons with theme-aware colors and hover states
+ * - Custom SVG files (inline rendering with color support via currentColor)
+ * - Custom images (PNG/JPEG with theme variants, no color override)
+ * - Auto-detection of theme mode
+ * - Validation and fallback rendering
+ *
+ * Priority: iconify > customSvg > customImage
+ *
+ * @example
+ * ```tsx
+ * // Using Iconify icon (string shorthand)
+ * <ThemedIcon iconify="mdi:check-circle" />
+ *
+ * // Using Iconify with custom config
+ * <ThemedIcon
+ *   iconify={{
+ *     icon: "mdi:home",
+ *     width: 32,
+ *     height: 32,
+ *     colors: {
+ *       light: "#1976d2",
+ *       lightHover: "#115293",
+ *       dark: "#90caf9",
+ *       darkHover: "#b3d9ff"
+ *     }
+ *   }}
+ *   supportsHover={true}
+ * />
+ *
+ * // Using custom SVG (inline, supports currentColor)
+ * <ThemedIcon customSvg="/img/icon.svg" />
+ *
+ * // Using custom SVG with theme variants
+ * <ThemedIcon
+ *   customSvg={{
+ *     light: "/img/icon-light.svg",
+ *     dark: "/img/icon-dark.svg"
+ *   }}
+ * />
+ *
+ * // Using custom image (no color override)
+ * <ThemedIcon customImage="/img/icon.png" />
+ *
+ * // Using custom image with theme variants
+ * <ThemedIcon
+ *   customImage={{
+ *     light: "/img/icon-light.png",
+ *     dark: "/img/icon-dark.png"
+ *   }}
+ * />
+ * ```
+ */
+export declare const ThemedIcon: React.FC<ThemedIconProps>;
+export default ThemedIcon;
+//# sourceMappingURL=ThemedIcon.d.ts.map

package/lib/utils/ThemedIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemedIcon.d.ts","sourceRoot":"","sources":["../../src/utils/ThemedIcon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,OAAO,KAAK,EAAE,eAAe,EAAkC,MAAM,SAAS,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAmHhD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/lib/utils/ThemedIcon.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemedIcon = void 0;
+const react_1 = __importDefault(require("react"));
+const useIsBrowser_1 = __importDefault(require("@docusaurus/useIsBrowser"));
+const theme_common_1 = require("@docusaurus/theme-common");
+const IconifyIcon_1 = require("./IconifyIcon");
+const InlineSvg_1 = require("./InlineSvg");
+const constants_1 = require("./constants");
+const logger_1 = require("./logger");
+/**
+ * ThemedIcon Component
+ *
+ * A flexible icon component that supports:
+ * - Iconify icons with theme-aware colors and hover states
+ * - Custom SVG files (inline rendering with color support via currentColor)
+ * - Custom images (PNG/JPEG with theme variants, no color override)
+ * - Auto-detection of theme mode
+ * - Validation and fallback rendering
+ *
+ * Priority: iconify > customSvg > customImage
+ *
+ * @example
+ * ```tsx
+ * // Using Iconify icon (string shorthand)
+ * <ThemedIcon iconify="mdi:check-circle" />
+ *
+ * // Using Iconify with custom config
+ * <ThemedIcon
+ *   iconify={{
+ *     icon: "mdi:home",
+ *     width: 32,
+ *     height: 32,
+ *     colors: {
+ *       light: "#1976d2",
+ *       lightHover: "#115293",
+ *       dark: "#90caf9",
+ *       darkHover: "#b3d9ff"
+ *     }
+ *   }}
+ *   supportsHover={true}
+ * />
+ *
+ * // Using custom SVG (inline, supports currentColor)
+ * <ThemedIcon customSvg="/img/icon.svg" />
+ *
+ * // Using custom SVG with theme variants
+ * <ThemedIcon
+ *   customSvg={{
+ *     light: "/img/icon-light.svg",
+ *     dark: "/img/icon-dark.svg"
+ *   }}
+ * />
+ *
+ * // Using custom image (no color override)
+ * <ThemedIcon customImage="/img/icon.png" />
+ *
+ * // Using custom image with theme variants
+ * <ThemedIcon
+ *   customImage={{
+ *     light: "/img/icon-light.png",
+ *     dark: "/img/icon-dark.png"
+ *   }}
+ * />
+ * ```
+ */
+const ThemedIcon = ({ iconify, customSvg, customImage, alt = '', className, style, disableAnimation = false, supportsHover = false, }) => {
+    const isBrowser = (0, useIsBrowser_1.default)();
+    const { colorMode } = (0, theme_common_1.useColorMode)();
+    const isDarkTheme = isBrowser ? colorMode === 'dark' : false;
+    // Validation: Check mutual exclusivity and priority
+    const providedProps = [iconify, customSvg, customImage].filter(Boolean);
+    if (providedProps.length > 1) {
+        (0, logger_1.logWarn)('Multiple icon props provided (iconify, customSvg, customImage). Using priority: iconify > customSvg > customImage.');
+    }
+    else if (providedProps.length === 0) {
+        (0, logger_1.logWarn)('No icon props provided (iconify, customSvg, customImage). Rendering fallback image-not-found icon.');
+        return (react_1.default.createElement("div", { className: className, style: style, dangerouslySetInnerHTML: { __html: constants_1.IMAGE_NOT_FOUND_SVG } }));
+    }
+    // Priority 1: Iconify icon
+    if (iconify) {
+        // Normalize iconify to IconifyConfig
+        const iconifyConfig = typeof iconify === 'string'
+            ? { icon: iconify }
+            : iconify;
+        // Build color configuration
+        const colors = iconifyConfig.colors || {};
+        const lightColor = colors.light || constants_1.DEFAULT_ICON_COLORS.light;
+        const lightHoverColor = colors.lightHover || constants_1.DEFAULT_ICON_COLORS.lightHover;
+        const darkColor = colors.dark || colors.light || constants_1.DEFAULT_ICON_COLORS.light;
+        const darkHoverColor = colors.darkHover || colors.lightHover || constants_1.DEFAULT_ICON_COLORS.lightHover;
+        // Determine current color (non-hover)
+        const currentColor = isDarkTheme ? darkColor : lightColor;
+        // If hover is supported, wrap in div with CSS custom properties
+        if (supportsHover) {
+            const cssVars = {
+                '--icon-color': isDarkTheme ? darkColor : lightColor,
+                '--icon-color-hover': isDarkTheme ? darkHoverColor : lightHoverColor,
+            };
+            return (react_1.default.createElement("div", { className: `${className || ''} ${disableAnimation ? 'disable-animation' : ''}`.trim(), style: { ...cssVars, ...style } },
+                react_1.default.createElement(IconifyIcon_1.IconifyIcon, { icon: iconifyConfig.icon, color: "currentColor", width: iconifyConfig.width, height: iconifyConfig.height })));
+        }
+        // No hover support - just render the icon directly
+        return (react_1.default.createElement(IconifyIcon_1.IconifyIcon, { icon: iconifyConfig.icon, color: currentColor, width: iconifyConfig.width, height: iconifyConfig.height, className: className, style: style }));
+    }
+    // Priority 2: Custom SVG (inline rendering with color support)
+    if (customSvg) {
+        const svgSrc = typeof customSvg === 'string'
+            ? customSvg
+            : (isDarkTheme ? customSvg.dark : customSvg.light);
+        return (react_1.default.createElement(InlineSvg_1.InlineSvg, { src: svgSrc, alt: alt, className: className, style: style }));
+    }
+    // Priority 3: Custom Image (img tag, no color override)
+    if (customImage) {
+        const imageSrc = typeof customImage === 'string'
+            ? customImage
+            : (isDarkTheme ? customImage.dark : customImage.light);
+        return (react_1.default.createElement("img", { src: imageSrc, alt: alt, className: className, style: style }));
+    }
+    // Should never reach here due to validation above
+    return null;
+};
+exports.ThemedIcon = ThemedIcon;
+exports.default = exports.ThemedIcon;
+//# sourceMappingURL=ThemedIcon.js.map

package/lib/utils/ThemedIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemedIcon.js","sourceRoot":"","sources":["../../src/utils/ThemedIcon.tsx"],"names":[],"mappings":"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"}

package/lib/utils/constants.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared constants for the component collection
+ */
+/**
+ * Fallback SVG for when icon configuration is invalid
+ * (e.g., both iconify and customIcon provided, or neither)
+ */
+export declare const IMAGE_NOT_FOUND_SVG: string;
+/**
+ * Default icon color configuration
+ */
+export declare const DEFAULT_ICON_COLORS: {
+    readonly light: "var(--ifm-color-emphasis-600)";
+    readonly lightHover: "var(--ifm-color-primary)";
+};
+/**
+ * Default title color configuration (same as icon colors)
+ */
+export declare const DEFAULT_TITLE_COLORS: {
+    readonly light: "var(--ifm-color-emphasis-600)";
+    readonly lightHover: "var(--ifm-color-primary)";
+};
+//# sourceMappingURL=constants.d.ts.map

package/lib/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAQxB,CAAC;AAET;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAItB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;CAIvB,CAAC"}

package/lib/utils/constants.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Shared constants for the component collection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TITLE_COLORS = exports.DEFAULT_ICON_COLORS = exports.IMAGE_NOT_FOUND_SVG = void 0;
+/**
+ * Fallback SVG for when icon configuration is invalid
+ * (e.g., both iconify and customIcon provided, or neither)
+ */
+exports.IMAGE_NOT_FOUND_SVG = `
+  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" style="color: var(--ifm-color-warning)">
+    <g fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5">
+      <path d="M15.5 8a.5.5 0 0 0 0-1m0 1a.5.5 0 0 1 0-1m0 1V7M2 2l20 20"/>
+      <path d="M17.3 21.3c-1.281.2-2.97.2-5.3.2c-4.23 0-6.345 0-7.747-1.198q-.3-.256-.555-.555C2.5 18.345 2.5 16.23 2.5 12c0-2.33 0-4.019.2-5.3m17.335 13.335q.14-.138.267-.288C21.5 18.345 21.5 16.23 21.5 12s0-6.345-1.198-7.747q-.256-.3-.555-.555C18.345 2.5 16.23 2.5 12 2.5s-6.345 0-7.747 1.198q-.15.128-.289.266"/>
+      <path d="m3 16l4.5-4.5M21 16l-2.47-2.47a1.81 1.81 0 0 0-2.56 0l-1.22 1.22"/>
+    </g>
+  </svg>
+`.trim();
+/**
+ * Default icon color configuration
+ */
+exports.DEFAULT_ICON_COLORS = {
+    light: "var(--ifm-color-emphasis-600)",
+    lightHover: "var(--ifm-color-primary)",
+    // dark and darkHover default to light values if not specified
+};
+/**
+ * Default title color configuration (same as icon colors)
+ */
+exports.DEFAULT_TITLE_COLORS = {
+    light: "var(--ifm-color-emphasis-600)",
+    lightHover: "var(--ifm-color-primary)",
+    // dark and darkHover default to light values if not specified
+};
+//# sourceMappingURL=constants.js.map

package/lib/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;;GAGG;AACU,QAAA,mBAAmB,GAAG;;;;;;;;CAQlC,CAAC,IAAI,EAAE,CAAC;AAET;;GAEG;AACU,QAAA,mBAAmB,GAAG;IACjC,KAAK,EAAE,+BAA+B;IACtC,UAAU,EAAE,0BAA0B;IACtC,8DAA8D;CACtD,CAAC;AAEX;;GAEG;AACU,QAAA,oBAAoB,GAAG;IAClC,KAAK,EAAE,+BAA+B;IACtC,UAAU,EAAE,0BAA0B;IACtC,8DAA8D;CACtD,CAAC"}

package/lib/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Utility exports for the component collection
+ */
+export { IconifyIcon } from "./IconifyIcon";
+export { ThemedIcon } from "./ThemedIcon";
+export { logWarn, logError, logInfo } from "./logger";
+export { IMAGE_NOT_FOUND_SVG, DEFAULT_ICON_COLORS, DEFAULT_TITLE_COLORS, } from "./constants";
+export type { IconifyConfig, CustomSvgConfig, CustomImageConfig, IconColorConfig, TitleColorConfig, IconifyImageColorConfig, IconifyIconProps, ThemedIconProps, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/lib/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/lib/utils/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Utility exports for the component collection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TITLE_COLORS = exports.DEFAULT_ICON_COLORS = exports.IMAGE_NOT_FOUND_SVG = exports.logInfo = exports.logError = exports.logWarn = exports.ThemedIcon = exports.IconifyIcon = void 0;
+var IconifyIcon_1 = require("./IconifyIcon");
+Object.defineProperty(exports, "IconifyIcon", { enumerable: true, get: function () { return IconifyIcon_1.IconifyIcon; } });
+var ThemedIcon_1 = require("./ThemedIcon");
+Object.defineProperty(exports, "ThemedIcon", { enumerable: true, get: function () { return ThemedIcon_1.ThemedIcon; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logWarn", { enumerable: true, get: function () { return logger_1.logWarn; } });
+Object.defineProperty(exports, "logError", { enumerable: true, get: function () { return logger_1.logError; } });
+Object.defineProperty(exports, "logInfo", { enumerable: true, get: function () { return logger_1.logInfo; } });
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "IMAGE_NOT_FOUND_SVG", { enumerable: true, get: function () { return constants_1.IMAGE_NOT_FOUND_SVG; } });
+Object.defineProperty(exports, "DEFAULT_ICON_COLORS", { enumerable: true, get: function () { return constants_1.DEFAULT_ICON_COLORS; } });
+Object.defineProperty(exports, "DEFAULT_TITLE_COLORS", { enumerable: true, get: function () { return constants_1.DEFAULT_TITLE_COLORS; } });
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,mCAAsD;AAA7C,iGAAA,OAAO,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,iGAAA,OAAO,OAAA;AACnC,yCAIqB;AAHnB,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,iHAAA,oBAAoB,OAAA"}

package/lib/utils/logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Component Collection Logger
+ * Browser-compatible logger for consistent runtime warnings and errors
+ * (This runs in the browser, not Node.js build time)
+ */
+/**
+ * Log warning message to browser console
+ * Format: [Frontpage] [WARN] message
+ */
+export declare function logWarn(message: string): void;
+/**
+ * Log error message to browser console
+ * Format: [Frontpage] [ERROR] message
+ */
+export declare function logError(message: string, error?: any): void;
+/**
+ * Log info message to browser console (for development)
+ * Format: [Frontpage] [INFO] message
+ */
+export declare function logInfo(message: string): void;
+//# sourceMappingURL=logger.d.ts.map

package/lib/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI,CAK3D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI7C"}

package/lib/utils/logger.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Component Collection Logger
+ * Browser-compatible logger for consistent runtime warnings and errors
+ * (This runs in the browser, not Node.js build time)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logWarn = logWarn;
+exports.logError = logError;
+exports.logInfo = logInfo;
+const COMPONENT_PREFIX = "[Frontpage]";
+/**
+ * Log warning message to browser console
+ * Format: [Frontpage] [WARN] message
+ */
+function logWarn(message) {
+    console.warn(`${COMPONENT_PREFIX} [WARN]`, message);
+}
+/**
+ * Log error message to browser console
+ * Format: [Frontpage] [ERROR] message
+ */
+function logError(message, error) {
+    console.error(`${COMPONENT_PREFIX} [ERROR]`, message);
+    if (error) {
+        console.error(error);
+    }
+}
+/**
+ * Log info message to browser console (for development)
+ * Format: [Frontpage] [INFO] message
+ */
+function logInfo(message) {
+    if (process.env.NODE_ENV === "development") {
+        console.info(`${COMPONENT_PREFIX} [INFO]`, message);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/lib/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAQH,0BAEC;AAMD,4BAKC;AAMD,0BAIC;AA7BD,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAEvC;;;GAGG;AACH,SAAgB,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,SAAS,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,SAAgB,QAAQ,CAAC,OAAe,EAAE,KAAW;IACnD,OAAO,CAAC,KAAK,CAAC,GAAG,gBAAgB,UAAU,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,OAAO,CAAC,OAAe;IACrC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,SAAS,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}