portosaurus 3.0.2 → 4.0.0

package/src/theme/components/ProjectsSection/styles.module.css

@@ -11,7 +11,7 @@
 @keyframes slideUp {
   from {
     opacity: 0;
-    transform: translateY(20px);
+    transform: translateY(30px);
   }
   to {
     opacity: 1;
@@ -24,19 +24,31 @@
   min-height: calc(100vh - 60px);
   margin-bottom: 0;
   width: 100%;
-  padding: 1.5rem 0 5rem;
-  background-color: var(--ifm-background-color);
+  padding: 3rem 0 7rem;
+  position: relative;
+  overflow: visible !important;
+  z-index: 100;
+  background-color: var(--ifm-background-color) !important;
+  box-shadow: none !important;
+  border: none !important;
 }
 
 .projectsContainer {
   max-width: 1200px;
   margin: 0 auto;
   padding: 0 1.5rem 2rem;
+  overflow: visible !important;
+}
+
+.projectsCarousel {
+  width: 100%;
+  margin: 0;
+  padding: 0;
 }
 
 .projectsHeader {
   text-align: center;
-  margin-bottom: 1.5rem;
+  margin-bottom: 3.5rem;
 }
 
 .projectsTitle {
@@ -44,43 +56,117 @@
   font-weight: 600;
   color: var(--ifm-color-primary);
   margin-bottom: 0.6rem;
-  animation: slideUp 0.5s ease-out forwards;
+  opacity: 0;
   position: relative;
   display: inline-block;
 }
 
+:global(.is-visible) .projectsTitle::after {
+  width: 60px;
+  transition: width 0.4s ease-out 0.2s;
+}
+
+:global(.is-visible) .projectsTitle {
+  animation: slideUp 0.4s ease-out forwards;
+}
+
 .projectsSubtitle {
   font-size: 0.95rem;
   color: var(--ifm-font-color-tertiary);
   max-width: 600px;
   margin: 0.4rem auto 0;
-  animation: slideUp 0.5s ease-out 0.2s forwards;
+  opacity: 0;
+}
+
+:global(.is-visible) .projectsSubtitle {
+  animation: slideUp 0.4s ease-out 0.1s forwards;
 }
 
 /* Carousel Styles */
 .carouselContainer {
   position: relative;
-  width: 100%;
-  margin: 0 auto;
-  padding: 0.75rem 2rem 0;
   display: flex;
   align-items: center;
+  justify-content: center;
+  gap: 2rem;
+  width: 100%;
 }
 
 .carouselWrapper {
-  width: 100%;
+  flex: 1;
+  min-width: 0;
   overflow: hidden;
-  margin-bottom: 35px;
+  position: relative;
+  padding: 1rem 0;
+}
+
+.carouselControl {
+  background: var(--ifm-color-primary);
+  border: none;
+  border-radius: 50%;
+  width: 44px;
+  height: 44px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  color: var(--ifm-color-emphasis-900);
+  box-shadow: var(--ifm-global-shadow-md);
+  z-index: 10;
+  flex-shrink: 0;
+  position: relative;
+}
+
+.carouselControl:hover:not(:disabled) {
+  background: var(--ifm-color-primary-darker);
+  color: var(--ifm-color-emphasis-900);
+  transform: scale(1.1);
+  box-shadow: var(--ifm-global-shadow-lw);
+}
+
+.carouselControl:disabled {
+  opacity: 0.3;
+  cursor: not-allowed;
 }
 
 .projectsCarousel {
   width: 100%;
-  margin: 0 auto;
+  margin: 0;
+  padding: 0;
+}
+
+.projectsCarousel :global(.slick-list) {
+  margin: 0 !important;
+}
+
+.carouselArrow {
+  position: absolute;
+  top: 50%;
+  transform: translateY(-50%);
+  z-index: 1000;
+  cursor: pointer;
+  border: none;
+  background: none;
+}
+
+.prevArrow {
+  left: -40px !important;
+}
+
+.nextArrow {
+  right: -40px !important;
 }
 
 .carouselSlide {
-  padding: 4px 8px;
+  padding: 10px 12px;
   height: 100%;
+  position: relative;
+  z-index: 1;
+}
+
+.carouselSlide:hover {
+  z-index: 999;
 }
 
 .carouselCard {
@@ -92,7 +178,6 @@
   overflow: hidden;
   box-shadow: var(--ifm-global-shadow-md);
   opacity: 0;
-  animation: fadeIn 0.5s ease-out forwards;
   height: 100%;
   transition:
     transform 0.3s ease,
@@ -100,10 +185,20 @@
     border-color 0.3s ease;
   border: 1px solid var(--ifm-shadow-color);
   width: 100%;
+  transform: translate3d(0, 0, 0);
+}
+
+:global(.is-visible) .carouselCard {
+  animation: slideUp 0.8s ease-out forwards;
+  animation-delay: calc(0.3s + (var(--card-index) * 0.1s));
+}
+
+.carouselSlide:hover .carouselCard {
+  transform: scale(1.02) translate3d(0, 0, 0);
 }
 
 .featuredCard {
-  border: 1.5px solid rgba(var(--ifm-color-primary-rgb), 0.7);
+  /* Just the star is enough now */
   box-shadow: var(--ifm-global-shadow-md);
 }
 
@@ -112,17 +207,16 @@
   bottom: 10px;
   right: 10px;
   background-color: var(--ifm-color-primary);
-  color: var(--ifm-color-white);
-  width: 20px;
-  height: 20px;
+  color: var(--ifm-color-emphasis-900);
+  width: 24px;
+  height: 24px;
   border-radius: 50%;
   display: flex;
   align-items: center;
   justify-content: center;
-  font-size: 0.65rem;
+  font-size: 0.75rem;
   z-index: 5;
   box-shadow: var(--ifm-global-shadow-lw);
-  top: auto;
 }
 
 .featuredBadge svg {
@@ -130,12 +224,9 @@
 }
 
 .carouselCard:hover {
-  transform: scale(1.02);
-  border-color: var(--ifm-color-primary);
-}
-
-.featuredCard:hover {
-  border-width: 1.5px;
+  transform: scale(1.02) translate3d(0, 0, 0);
+  border: 2px solid var(--ifm-color-primary);
+  z-index: 999;
 }
 
 .projectImageContainer {
@@ -143,29 +234,40 @@
   width: 100%;
   padding-top: 62%;
   overflow: hidden;
-  background-color: var(--ifm-shadow-color);
-  border-bottom-left-radius: var(--ifm-card-border-radius);
-  border-bottom-right-radius: var(--ifm-card-border-radius);
+  background-color: rgba(var(--ifm-color-primary-rgb), 0.05);
+  border-top-left-radius: var(--ifm-card-border-radius);
+  border-top-right-radius: var(--ifm-card-border-radius);
+  clip-path: inset(
+    0 round var(--ifm-card-border-radius) var(--ifm-card-border-radius) 0 0
+  );
+  border-bottom: 1px solid var(--ifm-hr-border-color);
 }
 
 .projectImage {
   position: absolute;
-  top: 0;
-  left: 0;
-  width: 100%;
-  height: 100%;
-  object-fit: cover;
-  transform: scale(1.05);
+  top: 1rem;
+  left: 1rem;
+  right: 1rem;
+  bottom: 1rem;
+  width: calc(100% - 2rem);
+  height: calc(100% - 2rem);
+  object-fit: contain;
+  object-position: center;
+  transform: scale(1.05) translate3d(0, 0, 0);
   transition: transform 0.5s ease;
+  color: transparent;
+  font-size: 0;
+  text-indent: -9999px;
+  backface-visibility: hidden;
 }
 
-.carouselCard:hover .projectImage {
-  transform: scale(1.12);
+.carouselSlide:hover .projectImage {
+  transform: scale(1.12) translate3d(0, 0, 0);
 }
 
 /* Card content styling */
 .projectContent {
-  padding: 0.8rem 1.5rem 0rem;
+  padding: 1.2rem 1.5rem 0.5rem;
   flex: 1;
   display: flex;
   flex-direction: column;
@@ -200,6 +302,7 @@
 
 .stateCompleted {
   background-color: var(--ifm-color-blue);
+  color: var(--ifm-color-black);
 }
 
 .stateMaintenance {
@@ -241,35 +344,46 @@
   line-height: 1.4;
 }
 
-/* Tags styling */
 .projectTags {
+  position: absolute;
+  bottom: 10px;
+  left: 10px;
+  z-index: 5;
   display: flex;
+  flex-direction: row;
   flex-wrap: wrap;
-  gap: 0.25rem;
-  margin: 0.5rem 0 0.8rem;
-  opacity: 0.85;
-  justify-content: center;
+  gap: 4px;
+  align-items: center;
 }
 
 .projectTag {
-  background-color: var(--ifm-shadow-color);
-  color: var(--ifm-font-color-secondary);
-  padding: 0.02rem 0.3rem;
-  padding-top: 0px;
-  border-radius: 40px;
-  font-size: 0.55rem;
-  font-weight: 400;
-  transition: background-color 0.2s ease;
-  border: 1px solid var(--ifm-color-gray-500);
-  margin: 0.05rem;
+  background-color: var(--ifm-background-surface-color);
+  backdrop-filter: blur(12px);
+  color: var(--ifm-font-color-tertiary);
+  padding: 0px 1px 1px 2px;
+  border-radius: 3px;
+  font-size: 0.5rem;
+  font-weight: 700;
+  text-transform: capitalize;
+  letter-spacing: 0.8px;
+  border: 1px solid var(--ifm-card-background-color);
+  box-shadow: var(--ifm-global-shadow-lw);
+}
+
+.extraTagBtn {
+  background-color: var(--ifm-color-primary) !important;
+  color: var(--ifm-color-emphasis-900) !important;
+  border: 0.1px solid var(--ifm-color-primary) !important;
+  cursor: help;
+  opacity: 0.7;
 }
 
 /* Links styling */
 .projectLinks {
   display: flex;
   justify-content: center;
-  padding: 1.05rem 1.5rem 1.3rem;
-  gap: 0.8rem;
+  padding: 1.2rem 1.5rem 1.8rem;
+  gap: 1rem;
   margin-top: auto;
 }
 
@@ -315,58 +429,6 @@
   color: var(--ifm-color-primary);
 }
 
-/* Carousel control buttons */
-.carouselControl {
-  position: absolute;
-  top: 50%;
-  transform: translateY(-50%);
-  width: 44px;
-  height: 44px;
-  border-radius: 50%;
-  background-color: var(--ifm-color-primary);
-  color: var(--ifm-color-white);
-  border: none;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  cursor: pointer;
-  z-index: 5;
-  transition:
-    opacity 0.2s ease,
-    background-color 0.2s ease;
-  padding: 0;
-  box-shadow: var(--ifm-global-shadow-md);
-}
-
-.carouselControl svg {
-  width: 20px;
-  height: 20px;
-  fill: var(--ifm-color-white);
-}
-
-.carouselControl:hover {
-  transform: translateY(-50%) scale(1.1);
-}
-
-/* Disabled button style */
-.disabledButton {
-  opacity: 0.5;
-  cursor: not-allowed;
-}
-
-.disabledButton:hover {
-  transform: translateY(-50%);
-  opacity: 0.5;
-}
-
-.prevButton {
-  left: -25px;
-}
-
-.nextButton {
-  right: -25px;
-}
-
 .noProjects {
   text-align: center;
   padding: 2rem;
@@ -378,8 +440,8 @@
 
 :global(.slick-track) {
   display: flex !important;
-  margin-left: 0 !important;
-  margin-right: 0 !important;
+  justify-content: center !important;
+  margin: 0 auto !important;
 }
 
 :global(.slick-slide) {
@@ -549,11 +611,15 @@
   .projectLinks {
     padding: 0.8rem 1.1rem 1.3rem;
     gap: 0.7rem;
+    flex-wrap: wrap;
+    justify-content: center;
   }
 
-  .projectLinks {
-    padding: 0.8rem 1.1rem 1.3rem;
-    gap: 0.7rem;
+  .projectLink {
+    padding: 0.35rem 0.6rem;
+    font-size: 0.75rem;
+    min-width: 80px;
+    justify-content: center;
   }
 
   .prevButton {

package/src/theme/components/SocialLinks/index.js

@@ -12,7 +12,7 @@ import { iconMap } from "../../config/iconMappings";
 const DEFAULT_ICON = FaQuestionCircle;
 const DEFAULT_COLOR = "var(--ifm-color-primary)";
 
-export default function SocialIcons({ showAll = false }) {
+export default function SocialIcons({ showAll = false, links = null }) {
   const { siteConfig } = useDocusaurusContext();
   const { customFields } = siteConfig;
   const isBrowser = useIsBrowser();
@@ -21,10 +21,11 @@ export default function SocialIcons({ showAll = false }) {
 
   const allSocialLinks = customFields.socialLinks.links || [];
 
-  // FIX: `to prevent unnecessary recalculations`
+  // If specific links are provided, use them. Otherwise, fallback to global logic.
   const socialLinks = useMemo(() => {
+    if (links) return links;
     return showAll ? allSocialLinks : allSocialLinks.filter((link) => link.pin);
-  }, [allSocialLinks, showAll]);
+  }, [allSocialLinks, showAll, links]);
 
   // Calculate delays based on screen size
   const calculateDelays = useCallback(() => {
@@ -91,7 +92,7 @@ export default function SocialIcons({ showAll = false }) {
     <div className={styles.socialIcons}>
       {socialLinks.map((social, index) => {
         const { icon: IconComponent, color: iconColor } = getIconDetails(
-          social.icon,
+          social.icon || social.name,
         );
         const href = social.url || "#";
         const displayColor = social.color || iconColor;
@@ -99,10 +100,11 @@ export default function SocialIcons({ showAll = false }) {
         return (
           <Tooltip
             key={index}
-            msg={social.desc || social.icon || "Link"}
+            msg={social.desc || social.name || social.icon || "Link"}
             position="top"
-            color={displayColor}
+            bg={displayColor}
             underline={false}
+            gap={17}
           >
             <a
               href={href}
@@ -113,7 +115,7 @@ export default function SocialIcons({ showAll = false }) {
                 "--hover-color": displayColor,
                 animationDelay: animationDelays[index] || "0s",
               }}
-              aria-label={social.icon || "social link"}
+              aria-label={social.name || social.icon || "social link"}
             >
               <IconComponent size={24} />
             </a>

package/src/theme/components/Tooltip/index.js

@@ -7,48 +7,60 @@ export default function Tooltip({
   msg,
   position = "top",
   color,
+  bg,
   underline = true,
+  gap = 5,
+  shadow,
+  className = "",
 }) {
+  if (!msg) {
+    throw new Error(
+      "Tooltip: 'msg' prop is required to display tooltip content.",
+    );
+  }
+
   const [isVisible, setIsVisible] = useState(false);
   const [coords, setCoords] = useState({ top: 0, left: 0 });
   const containerRef = useRef(null);
 
-  const tooltipStyle = color
-    ? {
-        "--tooltip-color": color,
-        "--tooltip-text-color": "var(--ifm-font-color-base-inverse)",
-      }
-    : {};
+  const tooltipStyle = {
+    ...(bg && { "--tooltip-color": bg }),
+    ...(color && { "--tooltip-text-color": color }),
+    // Auto-contrast: if bg is set but color is not, use inverse text
+    ...(!color &&
+      bg && { "--tooltip-text-color": "var(--ifm-font-color-base-inverse)" }),
+    ...(shadow && { "--tooltip-shadow": shadow }),
+  };
 
   const show = useCallback(() => {
-    if (!containerRef.current) return;
-    const rect = containerRef.current.getBoundingClientRect();
-    const gap = 8;
+    if (!containerRef.current || !containerRef.current.children[0]) return;
+    const rect = containerRef.current.children[0].getBoundingClientRect();
+    const tooltipGap = gap;
 
     let top, left;
     switch (position) {
       case "bottom":
-        top = rect.bottom + gap;
+        top = rect.bottom + tooltipGap;
         left = rect.left + rect.width / 2;
         break;
       case "left":
         top = rect.top + rect.height / 2;
-        left = rect.left - gap;
+        left = rect.left - tooltipGap;
         break;
       case "right":
         top = rect.top + rect.height / 2;
-        left = rect.right + gap;
+        left = rect.right + tooltipGap;
         break;
       case "top":
       default:
-        top = rect.top - gap;
+        top = rect.top - tooltipGap;
         left = rect.left + rect.width / 2;
         break;
     }
 
     setCoords({ top, left });
     setIsVisible(true);
-  }, [position]);
+  }, [position, gap]);
 
   const hide = useCallback(() => setIsVisible(false), []);
 
@@ -68,18 +80,17 @@ export default function Tooltip({
       : null;
 
   return (
-    <span
+    <div
       ref={containerRef}
-      className={`${styles.tooltipContainer} ${underline ? styles.hasUnderline : ""}`}
+      className={`${styles.tooltipContainer} ${underline ? styles.hasUnderline : ""} ${className}`}
       onMouseEnter={show}
       onMouseLeave={hide}
       onFocus={show}
       onBlur={hide}
+      style={{ display: "contents" }}
     >
-      {React.Children.map(children, (child) =>
-        typeof child === "string" ? child.trim() : child,
-      )}
+      {children}
       {tooltip}
-    </span>
+    </div>
   );
 }