Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

9.2 KB
Raw Blame
import { useState, type CSSProperties } from "react";
import { createPortal } from "react-dom";
import type { ReadyShader, ReadyShaderCategory } from "../data/shaders";
import { READY_SHADER_CATEGORIES } from "../data/shaders";
import { COMMUNITY_NEWEST_SHADER_IDS } from "../data/communityOrder";
import { VISIBLE_READY_SHADERS } from "../data/publicShaders";
import { BrandMark } from "./BrandMark";
import { ChevronIcon, MaximizeIcon, SearchIcon } from "./icons";
import { GitHubStars } from "./GitHubStars";
import { RightRailPromos } from "./RightRailPromos";
import { ThemeButtons } from "./ThemeButtons";
import { UpgradeLink } from "./UpgradeLink";
import type { ThemeMode, ThemePalette } from "../theme";

type SidebarProps = {
  active: ReadyShader;
  browseActive: boolean;
  installationActive: boolean;
  mcpActive: boolean;
  open: boolean;
  theme: ThemeMode;
  palette: ThemePalette;
  onSelect: (id: ReadyShader["id"]) => void;
  onBrowse: () => void;
  onInstallation: () => void;
  onMcp: () => void;
  onPricing: () => void;
  onSearch: () => void;
  onTheme: (mode: ThemeMode) => void;
};

type SidebarCatalogSectionProps = Pick<SidebarProps, "active" | "installationActive" | "onSelect"> & {
  label: string;
  shaders: readonly ReadyShader[];
  onPreview: (shader: ReadyShader, target: HTMLButtonElement) => void;
  onPreviewEnd: () => void;
};

type SidebarPreview = {
  thumbnail: string;
  top: number;
  left: number;
};

function getSidebarPreviewThumbnail(shader: ReadyShader) {
  return shader.variants?.[0]?.thumbnail ?? shader.thumbnail;
}

const NEWEST_SHADER_RANK = new Map<ReadyShader["id"], number>(
  COMMUNITY_NEWEST_SHADER_IDS.map((id, index) => [id, index]),
);

function orderNewestFirst(shaders: readonly ReadyShader[]) {
  return shaders
    .map((shader, index) => ({ shader, index }))
    .sort((a, b) => (
      (NEWEST_SHADER_RANK.get(a.shader.id) ?? Number.MAX_SAFE_INTEGER)
      - (NEWEST_SHADER_RANK.get(b.shader.id) ?? Number.MAX_SAFE_INTEGER)
      || a.index - b.index
    ))
    .map(({ shader }) => shader);
}

const NEWEST_SHADER_ID_SET = new Set<ReadyShader["id"]>(COMMUNITY_NEWEST_SHADER_IDS);
export const RECENT_SHADERS = orderNewestFirst(VISIBLE_READY_SHADERS).filter((shader) => NEWEST_SHADER_ID_SET.has(shader.id));

const COMMUNITY_SHADERS = orderNewestFirst(VISIBLE_READY_SHADERS);

function SidebarCatalogSection({ label, shaders, active, installationActive, onSelect, onPreview, onPreviewEnd }: SidebarCatalogSectionProps) {
  const [expanded, setExpanded] = useState(true);
  const [openCategories, setOpenCategories] = useState<Set<ReadyShaderCategory>>(
    () => new Set(READY_SHADER_CATEGORIES),
  );
  const categories = READY_SHADER_CATEGORIES.filter((category) => (
    shaders.some((shader) => shader.category === category)
  ));

  return (
    <div className="nav-section">
      <h2 className="nav-label">
        <button
          className="nav-section-toggle"
          type="button"
          aria-expanded={expanded}
          onClick={() => setExpanded((current) => !current)}
        >
          <span>{label}</span>
          <MaximizeIcon className="maximize-icon" />
        </button>
      </h2>
      <div className={`nav-children${expanded ? " is-open" : ""}`}>
        <div>
          {categories.map((category) => {
            const categoryExpanded = openCategories.has(category);
            return (
              <div className="nav-block" key={category}>
                <button
                  className="nav-group"
                  aria-expanded={categoryExpanded}
                  onClick={() => setOpenCategories((current) => {
                    const next = new Set(current);
                    if (next.has(category)) next.delete(category);
                    else next.add(category);
                    return next;
                  })}
                >
                  {category}
                  <ChevronIcon className="chev" />
                </button>
                <div className={`nav-children${categoryExpanded ? " is-open" : ""}`}>
                  <div>
                    <div className="nav-list">
                      {shaders.filter((shader) => shader.category === category).map((shader) => (
                        <button
                          className={`nav-link${!installationActive && active.id === shader.id ? " active" : ""}`}
                          key={shader.id}
                          aria-current={!installationActive && active.id === shader.id ? "page" : undefined}
                          onPointerEnter={(event) => onPreview(shader, event.currentTarget)}
                          onPointerLeave={onPreviewEnd}
                          onFocus={(event) => onPreview(shader, event.currentTarget)}
                          onBlur={onPreviewEnd}
                          onClick={() => {
                            onPreviewEnd();
                            onSelect(shader.id);
                          }}
                        >
                          <span>{shader.label}</span>
                          <span className="nav-link-badges">
                            {shader.variants && shader.variants.length > 1 ? (
                              <span
                                className="variant-count"
                                aria-label={`${shader.variants.length} variants`}
                                title={`${shader.variants.length} variants`}
                              >
                                {shader.variants.length}
                              </span>
                            ) : null}
                          </span>
                        </button>
                      ))}
                    </div>
                  </div>
                </div>
              </div>
            );
          })}
        </div>
      </div>
    </div>
  );
}

export function Sidebar({ active, browseActive, installationActive, mcpActive, open, theme, palette, onSelect, onBrowse, onInstallation, onMcp, onPricing, onSearch, onTheme }: SidebarProps) {
  const [preview, setPreview] = useState<SidebarPreview | null>(null);

  const showPreview = (shader: ReadyShader, target: HTMLButtonElement) => {
    const bounds = target.getBoundingClientRect();
    const width = 240;
    const height = 135;
    const viewportPadding = 12;
    const top = Math.min(
      window.innerHeight - height - viewportPadding,
      Math.max(viewportPadding, bounds.top + bounds.height / 2 - height / 2),
    );
    const left = Math.min(window.innerWidth - width - viewportPadding, bounds.right + 12);
    setPreview({ thumbnail: getSidebarPreviewThumbnail(shader), top, left });
  };

  return (
    <aside className={`sidebar${open ? " open" : ""}`} id="sidebar">
      <div className="sb-head">
        <div className="sb-brand-row">
          <button className="brand-button" aria-label="Browse ThreeUI" onClick={onBrowse}>
            <BrandMark />
          </button>
          <GitHubStars />
        </div>
        <button className="search inset-shadow" onClick={onSearch}>
          <SearchIcon style={{ opacity: 0.7 }} />
          <span className="ph">Search...</span>
          <kbd>⌘ K</kbd>
        </button>
      </div>
      <div className="sb-scroll scroll-area" onScroll={() => setPreview(null)}>
        <nav className="sb-nav" aria-label="ThreeUI documentation">
          <div className="nav-section">
            <h2 className="nav-label">Documentation</h2>
            <div className="nav-list nav-list-root">
              <button
                className={`nav-link${browseActive ? " active" : ""}`}
                aria-current={browseActive ? "page" : undefined}
                onClick={onBrowse}
              >
                <span>Browse</span>
              </button>
              <button
                className={`nav-link${installationActive ? " active" : ""}`}
                aria-current={installationActive ? "page" : undefined}
                onClick={onInstallation}
              >
                <span>Installation</span>
              </button>
              <button
                className={`nav-link${mcpActive ? " active" : ""}`}
                aria-current={mcpActive ? "page" : undefined}
                onClick={onMcp}
              >
                <span>MCP</span>
              </button>
            </div>
          </div>
          <SidebarCatalogSection
            label="ThreeUI"
            shaders={COMMUNITY_SHADERS}
            active={active}
            installationActive={installationActive || mcpActive || browseActive}
            onSelect={onSelect}
            onPreview={showPreview}
            onPreviewEnd={() => setPreview(null)}
          />
        </nav>
        <div className="sidebar-promos-mobile">
          <RightRailPromos onPricing={onPricing} />
        </div>
      </div>
      <div className="sb-foot">
        <UpgradeLink />
        <ThemeButtons mode={theme} palette={palette} onChange={onTheme} />
      </div>
      {preview && typeof document !== "undefined" ? createPortal(
        <div
          className="sidebar-preview-tooltip"
          style={{ "--sidebar-preview-top": `${preview.top}px`, "--sidebar-preview-left": `${preview.left}px` } as CSSProperties}
          aria-hidden="true"
        >
          <img src={preview.thumbnail} alt="" />
        </div>,
        document.body,
      ) : null}
    </aside>
  );
}