@farming-labs/astro-theme 0.0.50 → 0.0.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/astro-theme",
-  "version": "0.0.50",
+  "version": "0.0.51",
   "description": "Astro UI components for @farming-labs/docs — layout, sidebar, TOC, search, and theme toggle",
   "keywords": [
     "astro",
@@ -79,8 +79,8 @@
   },
   "dependencies": {
     "sugar-high": "^0.9.5",
-    "@farming-labs/astro": "0.0.50",
-    "@farming-labs/docs": "0.0.50"
+    "@farming-labs/astro": "0.0.51",
+    "@farming-labs/docs": "0.0.51"
   },
   "peerDependencies": {
     "astro": ">=4.0.0"

package/src/components/DocsPage.astro

@@ -127,6 +127,104 @@ const localizedParentUrl = withLang(parentUrl);
 </div>
 
 <script>
+  let hoverLinkGlobalsBound = false;
+
+  function setHoverLinkOpen(root, open) {
+    if (!(root instanceof HTMLElement)) return;
+    const trigger = root.querySelector('.fd-hover-link-trigger');
+    const popover = root.querySelector('.fd-hover-link-popover');
+    if (!(trigger instanceof HTMLElement) || !(popover instanceof HTMLElement)) return;
+
+    root.classList.toggle('fd-hover-link-open', open);
+    trigger.setAttribute('aria-expanded', String(open));
+    popover.setAttribute('aria-hidden', String(!open));
+  }
+
+  function closeOpenHoverLinks(event) {
+    document.querySelectorAll('[data-hover-link].fd-hover-link-open').forEach((root) => {
+      if (!(root instanceof HTMLElement)) return;
+      if (event.target instanceof Node && root.contains(event.target)) return;
+      setHoverLinkOpen(root, false);
+    });
+  }
+
+  function bindHoverLinks() {
+    document.querySelectorAll('[data-hover-link]').forEach((root) => {
+      if (!(root instanceof HTMLElement)) return;
+      if (root.dataset.fdHoverLinkBound === 'true') return;
+      root.dataset.fdHoverLinkBound = 'true';
+
+      const trigger = root.querySelector('.fd-hover-link-trigger');
+      const popover = root.querySelector('.fd-hover-link-popover');
+      if (!(trigger instanceof HTMLElement) || !(popover instanceof HTMLElement)) return;
+
+      let closeTimer = 0;
+      const containsTarget = (target) => target instanceof Node && root.contains(target);
+      const clearCloseTimer = () => {
+        if (closeTimer !== 0) {
+          window.clearTimeout(closeTimer);
+          closeTimer = 0;
+        }
+      };
+
+      const openPopover = () => {
+        clearCloseTimer();
+        setHoverLinkOpen(root, true);
+      };
+      const closePopover = () => {
+        clearCloseTimer();
+        setHoverLinkOpen(root, false);
+      };
+      const closePopoverSoon = () => {
+        clearCloseTimer();
+        closeTimer = window.setTimeout(closePopover, 90);
+      };
+
+      trigger.addEventListener('pointerenter', openPopover);
+      trigger.addEventListener('pointerleave', (event) => {
+        if (containsTarget(event.relatedTarget)) return;
+        closePopoverSoon();
+      });
+      trigger.addEventListener('focus', (event) => {
+        if (!(event.currentTarget instanceof HTMLElement)) return;
+        if (typeof event.currentTarget.matches === 'function' && !event.currentTarget.matches(':focus-visible')) {
+          return;
+        }
+        openPopover();
+      });
+      trigger.addEventListener('blur', (event) => {
+        if (containsTarget(event.relatedTarget)) return;
+        closePopoverSoon();
+      });
+      trigger.addEventListener('click', (event) => {
+        event.preventDefault();
+        openPopover();
+      });
+
+      popover.addEventListener('pointerenter', openPopover);
+      popover.addEventListener('pointerleave', (event) => {
+        if (containsTarget(event.relatedTarget)) return;
+        closePopoverSoon();
+      });
+      popover.addEventListener('focusin', openPopover);
+      popover.addEventListener('focusout', (event) => {
+        if (containsTarget(event.relatedTarget)) return;
+        closePopoverSoon();
+      });
+
+      root.addEventListener('keydown', (event) => {
+        if (event.key !== 'Escape') return;
+        closePopover();
+      });
+    });
+
+    if (hoverLinkGlobalsBound) return;
+    hoverLinkGlobalsBound = true;
+
+    document.addEventListener('pointerdown', closeOpenHoverLinks);
+    document.addEventListener('focusin', closeOpenHoverLinks);
+  }
+
   function getItemOffset(depth) {
     if (depth <= 2) return 14;
     if (depth === 3) return 26;
@@ -457,6 +555,8 @@ const localizedParentUrl = withLang(parentUrl);
         });
       });
     });
+
+    bindHoverLinks();
   }
 
   function runTocWhenIdle() {

package/src/themes/colorful.js

@@ -30,6 +30,7 @@ const ColorfulUIDefaults = {
   components: {
     Callout: { variant: "soft", icon: true },
     CodeBlock: { showCopyButton: true },
+    HoverLink: { linkLabel: "Open page", showIndicator: false },
     Tabs: { style: "default" },
   },
 };

package/src/themes/darksharp.js

@@ -30,6 +30,7 @@ const DarksharpUIDefaults = {
   components: {
     Callout: { variant: "soft", icon: true },
     CodeBlock: { showCopyButton: true },
+    HoverLink: { linkLabel: "Open page", showIndicator: false },
     Tabs: { style: "default" },
   },
 };

package/src/themes/default.js

@@ -30,6 +30,7 @@ const DefaultUIDefaults = {
   components: {
     Callout: { variant: "soft", icon: true },
     CodeBlock: { showCopyButton: true },
+    HoverLink: { linkLabel: "Open page", showIndicator: false },
     Tabs: { style: "default" },
   },
 };

package/src/themes/greentree.js

@@ -30,6 +30,7 @@ const GreenTreeUIDefaults = {
   components: {
     Callout: { variant: "soft", icon: true },
     CodeBlock: { showCopyButton: true },
+    HoverLink: { linkLabel: "Open page", showIndicator: false },
     Tabs: { style: "default" },
   },
 };

package/src/themes/pixel-border.js

@@ -27,7 +27,9 @@ const PixelBorderUIDefaults = {
     toc: { enabled: true, depth: 3 },
     header: { height: 56, sticky: true },
   },
-  components: {},
+  components: {
+    HoverLink: { linkLabel: "Open page", showIndicator: false },
+  },
 };
 
 export const pixelBorder = createTheme({

package/styles/docs.css

@@ -918,6 +918,206 @@ samp {
   opacity: 0.8;
 }
 
+.fd-hover-link {
+  position: relative;
+  display: inline-block;
+  vertical-align: baseline;
+  max-width: 100%;
+}
+
+.fd-hover-link-trigger {
+  display: inline !important;
+  border: none;
+  background: transparent;
+  padding: 0;
+  margin: 0;
+  color: var(--color-fd-foreground);
+  cursor: pointer;
+  text-decoration: underline;
+  text-decoration-style: dashed;
+  text-decoration-thickness: 0.08em;
+  text-underline-offset: 0.22em;
+  text-decoration-color: color-mix(in srgb, var(--color-fd-foreground) 46%, transparent);
+  font: inherit;
+  line-height: inherit;
+  vertical-align: baseline;
+  appearance: none;
+  transition: text-decoration-color 180ms ease, opacity 180ms ease;
+}
+
+.fd-hover-link-trigger:hover,
+.fd-hover-link-trigger:focus-visible,
+.fd-hover-link-open > .fd-hover-link-trigger {
+  text-decoration-color: color-mix(in srgb, var(--color-fd-foreground) 68%, transparent);
+}
+
+.fd-hover-link-trigger:focus-visible {
+  outline: none;
+}
+
+.fd-hover-link-popover {
+  --fd-hover-link-rest-x: -50%;
+  --fd-hover-link-rest-y: 8px;
+  --fd-hover-link-open-x: -50%;
+  --fd-hover-link-open-y: 0;
+  position: absolute;
+  top: calc(100% + var(--fd-hover-link-side-offset, 12px));
+  left: 50%;
+  z-index: 40;
+  width: min(22rem, calc(100vw - 2rem));
+  max-width: min(22rem, calc(100vw - 2rem));
+  opacity: 0;
+  visibility: hidden;
+  pointer-events: none;
+  transform: translate3d(var(--fd-hover-link-rest-x), var(--fd-hover-link-rest-y), 0);
+  transition: opacity 180ms ease, transform 180ms ease, visibility 180ms linear;
+}
+
+.fd-hover-link[data-align="start"] > .fd-hover-link-popover {
+  left: 0;
+  --fd-hover-link-rest-x: 0;
+  --fd-hover-link-open-x: 0;
+}
+
+.fd-hover-link[data-align="end"] > .fd-hover-link-popover {
+  left: auto;
+  right: 0;
+  --fd-hover-link-rest-x: 0;
+  --fd-hover-link-open-x: 0;
+}
+
+.fd-hover-link[data-side="top"] > .fd-hover-link-popover {
+  top: auto;
+  bottom: calc(100% + var(--fd-hover-link-side-offset, 12px));
+  --fd-hover-link-rest-y: -8px;
+  --fd-hover-link-open-y: 0;
+}
+
+.fd-hover-link[data-side="right"] > .fd-hover-link-popover {
+  top: 50%;
+  left: calc(100% + var(--fd-hover-link-side-offset, 12px));
+  right: auto;
+  --fd-hover-link-rest-x: 8px;
+  --fd-hover-link-rest-y: -50%;
+  --fd-hover-link-open-x: 0;
+  --fd-hover-link-open-y: -50%;
+}
+
+.fd-hover-link[data-side="right"][data-align="start"] > .fd-hover-link-popover {
+  top: 0;
+  --fd-hover-link-rest-y: 0;
+  --fd-hover-link-open-y: 0;
+}
+
+.fd-hover-link[data-side="right"][data-align="end"] > .fd-hover-link-popover {
+  top: auto;
+  bottom: 0;
+  --fd-hover-link-rest-y: 0;
+  --fd-hover-link-open-y: 0;
+}
+
+.fd-hover-link[data-side="left"] > .fd-hover-link-popover {
+  top: 50%;
+  left: auto;
+  right: calc(100% + var(--fd-hover-link-side-offset, 12px));
+  --fd-hover-link-rest-x: -8px;
+  --fd-hover-link-rest-y: -50%;
+  --fd-hover-link-open-x: 0;
+  --fd-hover-link-open-y: -50%;
+}
+
+.fd-hover-link[data-side="left"][data-align="start"] > .fd-hover-link-popover {
+  top: 0;
+  --fd-hover-link-rest-y: 0;
+  --fd-hover-link-open-y: 0;
+}
+
+.fd-hover-link[data-side="left"][data-align="end"] > .fd-hover-link-popover {
+  top: auto;
+  bottom: 0;
+  --fd-hover-link-rest-y: 0;
+  --fd-hover-link-open-y: 0;
+}
+
+.fd-hover-link-open > .fd-hover-link-popover {
+  opacity: 1;
+  visibility: visible;
+  pointer-events: auto;
+  transform: translate3d(var(--fd-hover-link-open-x), var(--fd-hover-link-open-y), 0);
+}
+
+.fd-hover-link-card {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  width: 100%;
+  border-radius: calc(var(--radius, 0.75rem) + 2px);
+  border: 1px solid color-mix(in srgb, var(--color-fd-border) 88%, transparent);
+  background: var(--color-fd-popover, var(--color-fd-background));
+  color: var(--color-fd-popover-foreground, var(--color-fd-foreground));
+  padding: 0.95rem 1rem;
+  box-shadow: 0 20px 45px color-mix(in srgb, var(--color-fd-background) 78%, transparent);
+  backdrop-filter: blur(14px);
+}
+
+.fd-hover-link-body {
+  display: flex;
+  flex-direction: column;
+  gap: 0.35rem;
+}
+
+.fd-hover-link-preview-label {
+  font-size: 0.68rem;
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  font-family: var(--fd-font-mono, var(--font-geist-mono, ui-monospace, monospace));
+  color: color-mix(in srgb, var(--color-fd-popover-foreground, var(--color-fd-foreground)) 55%, transparent);
+}
+
+.fd-hover-link-title,
+.fd-hover-link-cta {
+  text-decoration: none !important;
+}
+
+.fd-hover-link-title {
+  color: var(--color-fd-popover-foreground, var(--color-fd-foreground));
+  font-size: 1rem;
+  font-weight: 600 !important;
+  line-height: 1.3;
+}
+
+.fd-hover-link-title:hover,
+.fd-hover-link-cta:hover {
+  opacity: 1;
+}
+
+.fd-hover-link-description {
+  font-size: 0.92rem;
+  line-height: 1.6;
+  color: color-mix(in srgb, var(--color-fd-popover-foreground, var(--color-fd-foreground)) 74%, transparent);
+}
+
+.fd-hover-link-footer {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  padding-top: 0.25rem;
+  border-top: 1px solid color-mix(in srgb, var(--color-fd-border) 72%, transparent);
+}
+
+.fd-hover-link-cta {
+  display: inline-flex !important;
+  align-items: center;
+  gap: 0.4rem;
+  color: var(--color-fd-primary);
+  font-size: 0.8rem;
+  font-weight: 600 !important;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  font-family: var(--fd-font-mono, var(--font-geist-mono, ui-monospace, monospace));
+}
+
 .fd-page-body h1 {
   font-size: var(--fd-h1-size, 2.25rem);
   font-weight: var(--fd-h1-weight, 700);