@next-library/theme 1.0.12 → 1.0.13

package/dist/components/navigation/navbar/github-star.d.ts

@@ -7,9 +7,11 @@ export declare function parseGithubRepo(repoUrl: string): string | null;
 export declare function formatStarCount(count: number): string;
 /**
  * "Star on GitHub" control for the navbar, styled like the other navbar
- * controls (32px tall, bordered, design tokens) instead of GitHub's embedded
- * iframe button, which was 20px tall, used GitHub's own typography and never
- * lined up with its neighbours. The star count is fetched once per session.
+ * controls (32px tall, bordered, design tokens). The star count is fetched once
+ * per session. A gentle nudge invites a star: once per session, shortly after
+ * load, a gold star flies up into the button (the "star given" moment), and the
+ * mark twinkles periodically until the visitor clicks through. Both respect
+ * prefers-reduced-motion and stop for good once the visitor has engaged.
  */
 export declare function GithubStar({ repoUrl }: GithubStarProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/components/navigation/navbar/github-star.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-star.d.ts","sourceRoot":"","sources":["../../../../src/components/navigation/navbar/github-star.tsx"],"names":[],"mappings":"AAKA,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9D;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrD;AAqBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,eAAe,kDAsDtD"}
+{"version":3,"file":"github-star.d.ts","sourceRoot":"","sources":["../../../../src/components/navigation/navbar/github-star.tsx"],"names":[],"mappings":"AAKA,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9D;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrD;AA6BD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,eAAe,kDA2GtD"}

package/dist/index.js

@@ -5153,9 +5153,18 @@ function writeCachedCount(repo, count) {
   } catch {
   }
 }
+function hasEngaged() {
+  try {
+    return localStorage.getItem("nl-star-engaged") === "1";
+  } catch {
+    return false;
+  }
+}
 function GithubStar2({ repoUrl }) {
   const repo = repoUrl ? parseGithubRepo(repoUrl) : null;
   const [count, setCount] = useState(null);
+  const [nudge, setNudge] = useState(false);
+  const [engaged, setEngaged] = useState(true);
   useEffect(() => {
     if (!repo) return;
     const cached = readCachedCount(repo);
@@ -5176,9 +5185,34 @@ function GithubStar2({ repoUrl }) {
     });
     return () => controller.abort();
   }, [repo]);
+  useEffect(() => {
+    if (!repoUrl) return;
+    const already = hasEngaged();
+    setEngaged(already);
+    if (already) return;
+    const reduce = typeof window !== "undefined" && typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+    let nudgedThisSession = false;
+    try {
+      nudgedThisSession = sessionStorage.getItem("nl-star-nudged") === "1";
+    } catch {
+    }
+    if (reduce || nudgedThisSession) return;
+    const start = setTimeout(() => {
+      setNudge(true);
+      try {
+        sessionStorage.setItem("nl-star-nudged", "1");
+      } catch {
+      }
+      const stop = setTimeout(() => setNudge(false), 2400);
+      cleanups.push(() => clearTimeout(stop));
+    }, 1800);
+    const cleanups = [() => clearTimeout(start)];
+    return () => cleanups.forEach((fn) => fn());
+  }, [repoUrl]);
   if (!repoUrl) {
     return null;
   }
+  const markTwinkle = !engaged;
   return /* @__PURE__ */ jsxs(
     "a",
     {
@@ -5187,9 +5221,26 @@ function GithubStar2({ repoUrl }) {
       rel: "noopener noreferrer",
       "aria-label": "Star on GitHub",
       "data-testid": "github-star-link",
-      className: "ml-1 inline-flex h-8 items-center gap-1.5 rounded-md border px-2.5 text-[13px] font-medium text-foreground transition-colors hover:bg-accent",
+      onClick: () => {
+        try {
+          localStorage.setItem("nl-star-engaged", "1");
+        } catch {
+        }
+        setEngaged(true);
+        setNudge(false);
+      },
+      className: `nl-star-btn ml-1 inline-flex h-8 items-center gap-1.5 rounded-md border px-2.5 text-[13px] font-medium text-foreground transition-colors hover:bg-accent${nudge ? " nl-star-btn--nudge" : ""}`,
       children: [
-        /* @__PURE__ */ jsx(Star, { className: "size-3.5", "aria-hidden": "true" }),
+        /* @__PURE__ */ jsxs("span", { className: "nl-star-ico relative inline-flex", children: [
+          /* @__PURE__ */ jsx(
+            Star,
+            {
+              className: `size-3.5 nl-star-mark${markTwinkle ? " nl-star-mark--twinkle" : ""}`,
+              "aria-hidden": "true"
+            }
+          ),
+          nudge && /* @__PURE__ */ jsx(Star, { className: "nl-star-fly size-3.5", "aria-hidden": "true" })
+        ] }),
         /* @__PURE__ */ jsx("span", { children: "Star" }),
         count !== null && /* @__PURE__ */ jsx(
           "span",