react-lib-tools 0.0.34 → 0.0.36

package/dist/react-lib-tools.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./index-8LP1ujuh.cjs");exports.AppRoot=o.AppRoot;exports.Block=o.Block;exports.Box=o.Box;exports.Button=o.Button;exports.Callout=o.Callout;exports.Checkbox=o.Checkbox;exports.Code=o.Code;exports.ComponentProps=o.ComponentProps;exports.ComponentPropsSection=o.ComponentPropsSection;exports.DocsSection=o.DocsSection;exports.ErrorBoundary=o.ErrorBoundary;exports.ExternalLink=o.ExternalLink;exports.Header=o.Header;exports.ImperativeHandle=o.ImperativeHandle;exports.Input=o.Input;exports.Link=o.Link;exports.LoadingSpinner=o.LoadingSpinner;exports.NavLink=o.NavLink;exports.NavSection=o.NavSection;exports.Radio=o.Radio;exports.Select=o.Select;exports.Tooltip=o.Tooltip;exports.assert=o.assert;exports.cn=o.cn;exports.getIntentClassNames=o.getIntentClassNames;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./index-D_pov2Kn.cjs");exports.AppRoot=o.AppRoot;exports.Block=o.Block;exports.Box=o.Box;exports.Button=o.Button;exports.Callout=o.Callout;exports.Checkbox=o.Checkbox;exports.Code=o.Code;exports.ComponentProps=o.ComponentProps;exports.ComponentPropsSection=o.ComponentPropsSection;exports.DocsSection=o.DocsSection;exports.ErrorBoundary=o.ErrorBoundary;exports.ExternalLink=o.ExternalLink;exports.Header=o.Header;exports.ImperativeHandle=o.ImperativeHandle;exports.Input=o.Input;exports.Link=o.Link;exports.LoadingSpinner=o.LoadingSpinner;exports.NavLink=o.NavLink;exports.NavSection=o.NavSection;exports.Radio=o.Radio;exports.Select=o.Select;exports.Tooltip=o.Tooltip;exports.assert=o.assert;exports.cn=o.cn;exports.getIntentClassNames=o.getIntentClassNames;
 //# sourceMappingURL=react-lib-tools.cjs.map

package/dist/react-lib-tools.d.ts

@@ -8,13 +8,14 @@ import { JSX } from 'react/jsx-runtime';
 import { KeyboardEvent as KeyboardEvent_2 } from 'react';
 import { LazyExoticComponent } from 'react';
 import { MouseEvent as MouseEvent_2 } from 'react';
+import { Placement } from '@floating-ui/react';
 import { PropsWithChildren } from 'react';
 import { ReactNode } from 'react';
 
 /**
  * Displays an application shell with desktop and mobile layouts.
  */
-export declare function AppRoot({ commonQuestions, navLinks, overview, packageDescription, packageName, repositoryUrl, routes, showOpenCollectLink, versions }: {
+export declare function AppRoot({ navLinks, routes, ...context }: {
     commonQuestions?: CommonQuestion[];
     navLinks: ReactNode;
     overview?: ReactNode | undefined;
@@ -162,9 +163,9 @@ export declare function Link({ children, onClick, to, ...rest }: Omit<HTMLAttrib
 
 export declare function LoadingSpinner(): JSX.Element;
 
-export declare function NavLink({ children, className, path }: PropsWithChildren<{
+export declare function NavLink<Path extends string = DefaultPath>({ children, className, path }: PropsWithChildren<{
     className?: string | undefined;
-    path: string;
+    path: Path;
 }>): JSX.Element;
 
 export declare function NavSection({ children, label }: PropsWithChildren<{
@@ -217,13 +218,21 @@ export declare function Select<Value extends string>({ className, defaultValue,
     value: Option_2<Value> | undefined;
 }): JSX.Element;
 
+export declare type SiteSearchRecord = {
+    path: string;
+    section?: string | undefined;
+    title: string;
+};
+
 declare function SupportRoute(): JSX.Element;
 
-export declare function Tooltip({ children, className, content, showOnFocus, showOnHover }: PropsWithChildren<{
+export declare function Tooltip({ children, className, content, positions, showOnFocus, showOnHover, usePortal }: PropsWithChildren<{
     className?: string;
     content: ReactNode;
+    positions?: Array<Placement> | undefined;
     showOnFocus?: boolean;
     showOnHover?: boolean;
+    usePortal?: boolean;
 }>): JSX.Element;
 
 declare type Versions = {

package/dist/react-lib-tools.js

@@ -1,4 +1,4 @@
-import { A as o, a as e, B as n, b as t, C as r, c as i, d as p, i as c, j as l, D as d, e as C, E as k, H as m, I as B, f as L, L as S, g as u, N as x, h as I, R as N, k as g, T as v, l as E, m as H, n as R } from "./index-BeyKcpAG.js";
+import { A as o, a as e, B as n, b as t, C as r, c as i, d as p, i as c, j as l, D as d, e as C, E as k, H as m, I as B, f as L, L as S, g as u, N as x, h as I, R as N, k as g, T as v, l as E, m as H, n as R } from "./index-DbkaDE2f.js";
 export {
   o as AppRoot,
   e as Block,

package/lib/types.ts

@@ -1,5 +1,11 @@
 import type { ReactNode } from "react";
 
+export type SiteSearchRecord = {
+  path: string;
+  section?: string | undefined;
+  title: string;
+};
+
 export type Intent = "danger" | "none" | "primary" | "success" | "warning";
 
 export type Section = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-lib-tools",
-  "version": "0.0.34",
+  "version": "0.0.36",
   "type": "module",
   "author": "Brian Vaughn <brian.david.vaughn@gmail.com> (https://github.com/bvaughn/)",
   "contributors": [
@@ -51,7 +51,8 @@
     "@codemirror/language": "^6.12.1",
     "@codemirror/state": "^6.5.3",
     "@lezer/highlight": "^1.2.3",
-    "@ts-ast-parser/core": "^0.8.0"
+    "@ts-ast-parser/core": "^0.8.0",
+    "fuse.js": "^7.1.0"
   },
   "devDependencies": {
     "@csstools/postcss-oklab-function": "^4.0.11",
@@ -91,6 +92,7 @@
     "postcss": "^8.5.6",
     "prettier": "3.6.2",
     "prettier-plugin-tailwindcss": "^0.7.1",
+    "puppeteer": "^24.38.0",
     "react": "^19.2.3",
     "react-docgen-typescript": "^2.4.0",
     "react-dom": "^19.2.3",
@@ -113,7 +115,6 @@
     "vite-plugin-dts": "^4.5.4",
     "vite-plugin-svgr": "^4.3.0",
     "vitest": "^3.2.4",
-    "vitest-fail-on-console": "^0.10.1",
-    "zustand": "^5.0.7"
+    "vitest-fail-on-console": "^0.10.1"
   }
 }

package/scripts/compile-search-index.ts

@@ -0,0 +1,39 @@
+import Fuse from "fuse.js";
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import type { SiteSearchRecord } from "react-lib-tools";
+import { crawlPage } from "./utils/search/crawlPage";
+import type { SiteSearchPage } from "./utils/search/types";
+
+export async function compileSearchIndex({
+  host = "http://localhost:3000",
+  outputPath = ["public", "generated"]
+}: {
+  host?: string;
+  outputPath?: string[];
+} = {}) {
+  const recordsMap: Record<string, SiteSearchPage> = {};
+
+  await crawlPage({
+    host,
+    path: "/",
+    records: recordsMap
+  });
+
+  const records = Object.values(recordsMap);
+
+  const searchIndex = Fuse.createIndex<SiteSearchRecord>(
+    ["title", "section", "text"],
+    records
+  );
+
+  await writeFile(
+    join(...outputPath, `search-records.json`),
+    JSON.stringify(records, null, 2)
+  );
+
+  await writeFile(
+    join(...outputPath, `search-index.json`),
+    JSON.stringify(searchIndex, null, 2)
+  );
+}

package/scripts/utils/search/crawlPage.ts

@@ -0,0 +1,103 @@
+import puppeteer from "puppeteer";
+import { stopWords } from "./stopWords";
+import type { SiteSearchPage } from "./types";
+
+export async function crawlPage({
+  host,
+  path,
+  records
+}: {
+  host: string;
+  path: string;
+  records: Record<string, SiteSearchPage>;
+}) {
+  console.log(`Crawling ${host}${path} ...`);
+
+  const browser = await puppeteer.launch({
+    headless: true
+  });
+
+  const page = await browser.newPage();
+
+  // Navigate the page to a URL.
+  await page.goto(`${host}${path}`);
+  await page.waitForSelector("main");
+
+  const result = await page.evaluate(
+    async ([stopWords]) => {
+      const paths: string[] = [];
+      for (const element of document.body.querySelectorAll("[data-link]")) {
+        const to = element.getAttribute("data-link");
+        if (to) {
+          paths.push(to.split("#")[0]);
+        }
+      }
+
+      const section =
+        document.body.querySelector("header [data-section]")?.textContent ||
+        undefined;
+      const title =
+        document.body.querySelector("header [data-title]")?.textContent ?? "";
+
+      const words = new Set<string>();
+
+      const main = document.body.querySelector("header")?.parentElement;
+      if (main) {
+        for (const child of main.children) {
+          switch (child.tagName) {
+            case "CODE":
+            case "HEADER": {
+              continue;
+            }
+          }
+
+          if (child.hasAttribute("data-demo")) {
+            continue;
+          }
+
+          child.textContent?.split(/[\s.:]/).forEach((word) => {
+            word = word.trim().toLowerCase();
+            if (word && !stopWords.includes(word)) {
+              words.add(word);
+            }
+          });
+        }
+      }
+
+      return {
+        paths,
+        section,
+        title,
+        words: Array.from(words)
+      };
+    },
+    [stopWords]
+  );
+
+  records[path] = {
+    path,
+    section: result.section,
+    text: result.words.join(" "),
+    title: result.title
+  };
+
+  await Promise.all(
+    result.paths
+      .filter((current) => !records[current])
+      .map((current) => {
+        records[current] = {
+          path: current,
+          text: "",
+          title: ""
+        };
+
+        return crawlPage({
+          host,
+          path: current,
+          records
+        });
+      })
+  );
+
+  await browser.close();
+}

package/scripts/utils/search/stopWords.ts

@@ -0,0 +1,129 @@
+export const stopWords = [
+  "a",
+  "about",
+  "above",
+  "after",
+  "again",
+  "against",
+  "all",
+  "am",
+  "an",
+  "and",
+  "any",
+  "are",
+  "as",
+  "at",
+  "be",
+  "because",
+  "been",
+  "before",
+  "being",
+  "below",
+  "between",
+  "both",
+  "but",
+  "by",
+  "can",
+  "did",
+  "do",
+  "does",
+  "doing",
+  "don",
+  "down",
+  "during",
+  "each",
+  "few",
+  "for",
+  "from",
+  "further",
+  "had",
+  "has",
+  "have",
+  "having",
+  "he",
+  "her",
+  "here",
+  "hers",
+  "herself",
+  "him",
+  "himself",
+  "his",
+  "how",
+  "i",
+  "if",
+  "in",
+  "into",
+  "is",
+  "it",
+  "its",
+  "itself",
+  "just",
+  "me",
+  "more",
+  "most",
+  "my",
+  "myself",
+  "no",
+  "nor",
+  "not",
+  "now",
+  "of",
+  "off",
+  "on",
+  "once",
+  "only",
+  "or",
+  "other",
+  "our",
+  "ours",
+  "ourselves",
+  "out",
+  "over",
+  "own",
+  "s",
+  "same",
+  "she",
+  "should",
+  "so",
+  "some",
+  "such",
+  "t",
+  "than",
+  "that",
+  "the",
+  "their",
+  "theirs",
+  "them",
+  "themselves",
+  "then",
+  "there",
+  "these",
+  "they",
+  "this",
+  "those",
+  "through",
+  "to",
+  "too",
+  "under",
+  "until",
+  "up",
+  "very",
+  "was",
+  "we",
+  "were",
+  "what",
+  "when",
+  "where",
+  "which",
+  "while",
+  "who",
+  "whom",
+  "why",
+  "will",
+  "with",
+  "you",
+  "your",
+  "yours",
+  "yourself",
+  "yourselves"
+];

package/scripts/utils/search/types.ts

@@ -0,0 +1,6 @@
+export type SiteSearchPage = {
+  path: string;
+  section?: string | undefined;
+  text: string;
+  title: string;
+};