npm - docs-i18n - Versions diffs - 0.6.3 → 0.7.0 - Mend

docs-i18n 0.6.3 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (169) hide show

package/{src/admin/ui → admin/app}/components/JobDialog.tsx +21 -2
package/{src/admin/ui → admin/app}/components/JobPanel.tsx +1 -1
package/{src/admin/ui → admin/app}/components/Preview.tsx +2 -5
package/{src/admin/ui → admin/app}/lib/api.ts +18 -39
package/admin/app/routeTree.gen.ts +68 -0
package/admin/app/router.tsx +23 -0
package/admin/app/routes/__root.tsx +55 -0
package/admin/app/routes/index.tsx +416 -0
package/{src/admin/ui → admin/app}/styles.css +36 -3
package/admin/package.json +27 -0
package/admin/server/functions/jobs.ts +53 -0
package/admin/server/functions/misc.ts +84 -0
package/{src/admin/server/routes → admin/server/functions}/models.ts +16 -29
package/admin/server/functions/status.ts +61 -0
package/admin/server/index.ts +35 -0
package/admin/server/init.ts +46 -0
package/{src/admin → admin}/server/services/job-manager.ts +39 -10
package/{src/admin → admin}/server/services/status.ts +6 -6
package/admin/tsconfig.json +19 -0
package/{src/admin → admin}/vite.config.ts +8 -2
package/dist/{assemble-7H4QCW35.js → assemble-CP2BRYQJ.js} +6 -4
package/dist/{chunk-A3YQNPKZ.js → chunk-CLYUAWZE.js} +1 -1
package/dist/{chunk-YN4VJHCQ.js → chunk-JHBSHTXC.js} +1 -1
package/dist/chunk-L64GJ4OB.js +32 -0
package/dist/{chunk-SKKZIV3L.js → chunk-PNKVD2UK.js} +1 -29
package/dist/{chunk-XEOYZUHS.js → chunk-QKIR7RKQ.js} +4 -31
package/dist/chunk-TRURQFP4.js +31 -0
package/dist/cli.js +108 -7
package/dist/index.d.ts +41 -1
package/dist/index.js +92 -3
package/dist/{rescan-O5D3CYC2.js → rescan-HXMWFAOC.js} +5 -3
package/dist/{status-F4MYIAAY.js → status-AGZDXOTZ.js} +4 -2
package/dist/{translate-ZIVKNAC4.js → translate-A5X6MX4Y.js} +14 -7
package/dist/upload-XL6KG6S2.js +132 -0
package/package.json +17 -15
package/template/app/components/BlogArticle.tsx +159 -0
package/template/app/components/BlogList.tsx +88 -0
package/template/app/components/Breadcrumbs.tsx +81 -0
package/template/app/components/Card.tsx +31 -0
package/template/app/components/Doc.tsx +191 -0
package/template/app/components/DocBreadcrumb.tsx +60 -0
package/template/app/components/DocContainer.tsx +13 -0
package/template/app/components/DocTitle.tsx +11 -0
package/template/app/components/DocsLayout.tsx +715 -0
package/template/app/components/Dropdown.tsx +116 -0
package/template/app/components/FallbackBanner.tsx +36 -0
package/template/app/components/Footer.tsx +29 -0
package/template/app/components/FrameworkSelect.tsx +150 -0
package/template/app/components/LibraryCard.tsx +178 -0
package/template/app/components/LocaleSwitcher.tsx +43 -0
package/template/app/components/Navbar.tsx +430 -0
package/template/app/components/PostNotFound.tsx +20 -0
package/template/app/components/SearchButton.tsx +32 -0
package/template/app/components/Select.tsx +103 -0
package/template/app/components/Spinner.tsx +18 -0
package/template/app/components/ThemeProvider.tsx +141 -0
package/template/app/components/ThemeToggle.tsx +31 -0
package/template/app/components/Toc.tsx +86 -0
package/template/app/components/VersionSelect.tsx +118 -0
package/template/app/components/icons/BSkyIcon.tsx +27 -0
package/template/app/components/icons/BaseballCapIcon.tsx +25 -0
package/template/app/components/icons/BrandXIcon.tsx +28 -0
package/template/app/components/icons/CheckCircleIcon.tsx +28 -0
package/template/app/components/icons/CogsIcon.tsx +25 -0
package/template/app/components/icons/DiscordIcon.tsx +24 -0
package/template/app/components/icons/GithubIcon.tsx +24 -0
package/template/app/components/icons/GoogleIcon.tsx +24 -0
package/template/app/components/icons/InstagramIcon.tsx +24 -0
package/template/app/components/icons/NpmIcon.tsx +26 -0
package/template/app/components/icons/YinYangIcon.tsx +26 -0
package/template/app/components/icons/YouTubeIcon.tsx +24 -0
package/template/app/components/markdown/CodeBlock.tsx +254 -0
package/template/app/components/markdown/FileTabs.tsx +58 -0
package/template/app/components/markdown/FrameworkContent.tsx +76 -0
package/template/app/components/markdown/Markdown.tsx +216 -0
package/template/app/components/markdown/MarkdownContent.tsx +89 -0
package/template/app/components/markdown/MarkdownFrameworkHandler.tsx +66 -0
package/template/app/components/markdown/MarkdownHeadingContext.tsx +35 -0
package/template/app/components/markdown/MarkdownLink.tsx +46 -0
package/template/app/components/markdown/MarkdownTabsHandler.tsx +109 -0
package/template/app/components/markdown/PackageManagerTabs.tsx +95 -0
package/template/app/components/markdown/Tabs.tsx +139 -0
package/template/app/components/markdown/index.ts +15 -0
package/template/app/components/ui/Button.tsx +141 -0
package/template/app/components/ui/InlineCode.tsx +16 -0
package/template/app/components/ui/MarkdownImg.tsx +21 -0
package/template/app/config/frameworks.ts +93 -0
package/template/app/contexts/SearchContext.tsx +36 -0
package/template/app/db/index.ts +17 -0
package/template/app/db/schema.ts +74 -0
package/template/app/hooks/useClickOutside.ts +106 -0
package/template/app/routeTree.gen.ts +584 -0
package/template/app/router.tsx +29 -0
package/template/app/routes/$lang.$project.$version.docs.$.tsx +128 -0
package/template/app/routes/$lang.$project.$version.docs.framework.$framework.$.tsx +106 -0
package/template/app/routes/$lang.$project.$version.docs.framework.$framework.index.tsx +27 -0
package/template/app/routes/$lang.$project.$version.docs.framework.index.tsx +44 -0
package/template/app/routes/$lang.$project.$version.docs.index.tsx +27 -0
package/template/app/routes/$lang.$project.$version.docs.tsx +70 -0
package/template/app/routes/$lang.$project.$version.tsx +69 -0
package/template/app/routes/$lang.$project.docs.$.tsx +104 -0
package/template/app/routes/$lang.$project.docs.index.tsx +20 -0
package/template/app/routes/$lang.$project.docs.tsx +79 -0
package/template/app/routes/$lang.$project.tsx +89 -0
package/template/app/routes/$lang.blog.$.tsx +82 -0
package/template/app/routes/$lang.blog.index.tsx +56 -0
package/template/app/routes/$lang.blog.tsx +26 -0
package/template/app/routes/$lang.docs.$.tsx +100 -0
package/template/app/routes/$lang.docs.framework.$framework.$.tsx +104 -0
package/template/app/routes/$lang.docs.framework.$framework.index.tsx +32 -0
package/template/app/routes/$lang.docs.framework.index.tsx +47 -0
package/template/app/routes/$lang.docs.index.tsx +20 -0
package/template/app/routes/$lang.docs.tsx +90 -0
package/template/app/routes/$lang.tsx +16 -0
package/template/app/routes/__root.tsx +180 -0
package/template/app/routes/index.tsx +89 -0
package/template/app/site.config.ts +182 -0
package/template/app/styles/app.css +1029 -0
package/template/app/types/index.ts +77 -0
package/template/app/utils/blog.server.ts +193 -0
package/template/app/utils/blog.ts +42 -0
package/template/app/utils/config.ts +120 -0
package/template/app/utils/content-loader.ts +400 -0
package/template/app/utils/dates.ts +29 -0
package/template/app/utils/docs.server.ts +150 -0
package/template/app/utils/markdown/filterFrameworkContent.ts +233 -0
package/template/app/utils/markdown/index.ts +2 -0
package/template/app/utils/markdown/installCommand.ts +143 -0
package/template/app/utils/markdown/plugins/collectHeadings.ts +104 -0
package/template/app/utils/markdown/plugins/extractCodeMeta.ts +57 -0
package/template/app/utils/markdown/plugins/helpers.ts +33 -0
package/template/app/utils/markdown/plugins/index.ts +8 -0
package/template/app/utils/markdown/plugins/parseCommentComponents.ts +103 -0
package/template/app/utils/markdown/plugins/transformCommentComponents.ts +23 -0
package/template/app/utils/markdown/plugins/transformFrameworkComponent.ts +217 -0
package/template/app/utils/markdown/plugins/transformTabsComponent.ts +359 -0
package/template/app/utils/markdown/processor.ts +75 -0
package/template/app/utils/site-config.tsx +11 -0
package/template/app/utils/upload.ts +232 -0
package/template/app/utils/useLocalStorage.ts +65 -0
package/template/app/utils/utils.ts +23 -0
package/template/package.json +54 -0
package/template/public/favicon.svg +1 -0
package/template/public/fonts/Inter-latin-ext.woff2 +0 -0
package/template/public/fonts/Inter-latin.woff2 +0 -0
package/template/public/images/frameworks/angular-logo.svg +1 -0
package/template/public/images/frameworks/js-logo.svg +1 -0
package/template/public/images/frameworks/lit-logo.svg +1 -0
package/template/public/images/frameworks/preact-logo.svg +6 -0
package/template/public/images/frameworks/qwik-logo.svg +1 -0
package/template/public/images/frameworks/react-logo.svg +1 -0
package/template/public/images/frameworks/solid-logo.svg +1 -0
package/template/public/images/frameworks/svelte-logo.svg +1 -0
package/template/public/images/frameworks/vue-logo.svg +4 -0
package/template/tsconfig.json +24 -0
package/template/vite.config.ts +43 -0
package/template/wrangler.jsonc +16 -0
package/README.md +0 -161
package/dist/server-73AVSOL5.js +0 -598
package/src/admin/index.html +0 -13
package/src/admin/server/index.ts +0 -138
package/src/admin/server/routes/jobs.ts +0 -113
package/src/admin/server/routes/status.ts +0 -57
package/src/admin/ui/App.tsx +0 -332
package/src/admin/ui/main.tsx +0 -19
/package/{src/admin/ui → admin/app}/components/FileList.tsx +0 -0
/package/{src/admin/ui → admin/app}/components/LangGrid.tsx +0 -0
/package/{src/admin/ui → admin/app}/components/ProgressBar.tsx +0 -0
/package/{src/admin/ui → admin/app}/lib/flags.ts +0 -0

package/template/app/routes/__root.tsx ADDED Viewed

@@ -0,0 +1,180 @@
+import * as React from 'react'
+import {
+  createRootRouteWithContext,
+  useMatches,
+  useRouterState,
+  HeadContent,
+  Scripts,
+  Link,
+} from '@tanstack/react-router'
+import { QueryClient } from '@tanstack/react-query'
+import appCss from '~/styles/app.css?url'
+import { siteConfig } from '~/site.config'
+import { SearchProvider, useSearchContext } from '~/contexts/SearchContext'
+import { ThemeProvider, useHtmlClass } from '~/components/ThemeProvider'
+import { Spinner } from '~/components/Spinner'
+import { Navbar } from '~/components/Navbar'
+export const Route = createRootRouteWithContext<{
+  queryClient: QueryClient
+}>()({
+  head: () => ({
+    meta: [
+      {
+        charSet: 'utf-8',
+      },
+      {
+        name: 'viewport',
+        content: 'width=device-width, initial-scale=1',
+      },
+      {
+        title: `${siteConfig.name} - Documentation`,
+      },
+    ],
+    links: [
+      { rel: 'stylesheet', href: appCss },
+      { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
+    ],
+    scripts: [
+      // Theme detection script - must run before body renders to prevent flash
+      {
+        children: `(function(){try{var t=localStorage.getItem('theme')||'auto';var v=['light','dark','auto'].includes(t)?t:'auto';if(v==='auto'){var a=matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light';document.documentElement.classList.add(a,'auto')}else{document.documentElement.classList.add(v)}}catch(e){var a=matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light';document.documentElement.classList.add(a,'auto')}})()`,
+      },
+    ],
+  }),
+  staleTime: Infinity,
+  shellComponent: ({ children }) => {
+    return (
+      <ThemeProvider>
+        <SearchProvider>
+          <ShellComponent>{children}</ShellComponent>
+        </SearchProvider>
+      </ThemeProvider>
+    )
+  },
+  errorComponent: DefaultCatchBoundary,
+  notFoundComponent: () => <NotFound />,
+})
+function ShellComponent({ children }: { children: React.ReactNode }) {
+  const hasBaseParent = useMatches({
+    select: (matches) => matches.find((d) => d.staticData?.baseParent),
+  })
+  const isLoading = useRouterState({
+    select: (s) => s.status === 'pending',
+  })
+  const [canShowLoading, setShowLoading] = React.useState(false)
+  React.useEffect(() => {
+    const timeout = setTimeout(() => {
+      setShowLoading(true)
+    }, 2000)
+    return () => {
+      clearTimeout(timeout)
+    }
+  }, [])
+  const hideNavbar = useMatches({
+    select: (s) => s.some((d) => d.staticData?.showNavbar === false),
+  })
+  const htmlClass = useHtmlClass()
+  return (
+    <html lang="en" className={htmlClass} suppressHydrationWarning>
+      <head>
+        <HeadContent />
+        {hasBaseParent ? <base target="_parent" /> : null}
+      </head>
+      <body className="overflow-x-hidden">
+        {hideNavbar ? children : <Navbar>{children}</Navbar>}
+        {canShowLoading ? (
+          <div
+            className={`fixed top-0 left-0 h-[300px] w-full
+        transition-all duration-300 pointer-events-none
+        z-30 dark:h-[200px] dark:bg-white/10! dark:rounded-[100%] ${
+          isLoading
+            ? 'delay-500 opacity-1 -translate-y-1/2'
+            : 'delay-0 opacity-0 -translate-y-full'
+        }`}
+            style={{
+              background: `radial-gradient(closest-side, rgba(0,10,40,0.2) 0%, rgba(0,0,0,0) 100%)`,
+            }}
+          >
+            <div
+              className={`absolute top-1/2 left-1/2 -translate-x-1/2 translate-y-[30px] p-2 bg-white/80 dark:bg-gray-800
+        rounded-lg shadow-lg`}
+            >
+              <Spinner className="text-5xl" />
+            </div>
+          </div>
+        ) : null}
+        <SearchHotkeyController />
+        <Scripts />
+      </body>
+    </html>
+  )
+}
+function SearchHotkeyController() {
+  const { openSearch } = useSearchContext()
+  React.useEffect(() => {
+    const handleGlobalKeyDown = (event: KeyboardEvent) => {
+      if (event.defaultPrevented) return
+      if (!(event.metaKey || event.ctrlKey)) return
+      if (event.key.toLowerCase() !== 'k') return
+      event.preventDefault()
+      openSearch()
+    }
+    window.addEventListener('keydown', handleGlobalKeyDown)
+    return () => {
+      window.removeEventListener('keydown', handleGlobalKeyDown)
+    }
+  }, [openSearch])
+  return null
+}
+function NotFound() {
+  return (
+    <div className="flex-1 flex items-center justify-center py-20">
+      <div className="text-center">
+        <h1 className="text-4xl font-bold mb-4">404</h1>
+        <p className="text-lg text-gray-500 dark:text-gray-400 mb-6">
+          The page you are looking for does not exist.
+        </p>
+        <Link
+          to="/"
+          className="px-6 py-3 rounded-lg bg-gray-900 dark:bg-gray-100 text-white dark:text-gray-900 font-medium hover:opacity-90 transition-opacity"
+        >
+          Go Home
+        </Link>
+      </div>
+    </div>
+  )
+}
+function DefaultCatchBoundary({ error }: { error: Error }) {
+  return (
+    <div className="flex-1 flex items-center justify-center py-20">
+      <div className="text-center max-w-lg">
+        <h1 className="text-2xl font-bold mb-4">Something went wrong</h1>
+        <p className="text-gray-500 dark:text-gray-400 mb-4">
+          {error.message || 'An unexpected error occurred.'}
+        </p>
+        <Link
+          to="/"
+          className="px-6 py-3 rounded-lg bg-gray-900 dark:bg-gray-100 text-white dark:text-gray-900 font-medium hover:opacity-90 transition-opacity"
+        >
+          Go Home
+        </Link>
+      </div>
+    </div>
+  )
+}

package/template/app/routes/index.tsx ADDED Viewed

@@ -0,0 +1,89 @@
+import { createFileRoute, redirect } from '@tanstack/react-router'
+import { siteConfig, getProject, isSingleProject, getSingleProject } from '~/site.config'
+import LibraryCard from '~/components/LibraryCard'
+import { Footer } from '~/components/Footer'
+export const Route = createFileRoute('/')({
+  beforeLoad: () => {
+    // If only one project, redirect directly to its docs (simplified URL)
+    if (isSingleProject()) {
+      const project = getSingleProject()
+      throw redirect({
+        to: '/$lang/docs/$',
+        params: {
+          lang: siteConfig.defaultLocale,
+          _splat: project.defaultDocs || 'overview',
+        },
+      })
+    }
+  },
+  component: Index,
+})
+function Index() {
+  const projects = siteConfig.projects
+  return (
+    <div className="max-w-full z-10 space-y-24">
+      <div className="space-y-8">
+        <div className="flex flex-col items-center gap-6 text-center px-4 pt-12 xl:pt-24">
+          <div className="flex gap-2 lg:gap-4 items-center">
+            <h1
+              className={`inline-block
+            font-black text-5xl
+            md:text-6xl
+            lg:text-8xl`}
+            >
+              <span
+                className={`
+            inline-block text-black dark:text-white
+            mb-2 uppercase [letter-spacing:-.02em] pr-1.5
+            `}
+              >
+                {siteConfig.name}
+              </span>
+            </h1>
+          </div>
+          {siteConfig.description && (
+            <h2
+              className="font-bold text-2xl max-w-md
+            md:text-4xl md:max-w-2xl
+            2xl:text-5xl lg:max-w-2xl text-balance"
+            >
+              {siteConfig.description}
+            </h2>
+          )}
+        </div>
+      </div>
+      <div className="px-4 lg:max-w-(--breakpoint-lg) md:mx-auto">
+        <h3
+          id="libraries"
+          className={`text-4xl font-light mb-6 scroll-mt-24`}
+        >
+          <a
+            href="#libraries"
+            className="hover:underline decoration-gray-400 dark:decoration-gray-600"
+          >
+            Projects
+          </a>
+        </h3>
+        <div
+          className={`grid grid-cols-1 gap-6 gap-y-8 justify-center
+                sm:grid-cols-2 md:grid-cols-3 xl:grid-cols-3`}
+        >
+          {projects.map((project, i) => {
+            return (
+              <LibraryCard key={project.id} index={i} project={project} />
+            )
+          })}
+        </div>
+      </div>
+      <div className={`h-20`} />
+      <Footer />
+    </div>
+  )
+}

package/template/app/site.config.ts ADDED Viewed

@@ -0,0 +1,182 @@
+/**
+ * Site-wide configuration. Customize this for your project.
+ */
+import type { SiteConfig, ProjectConfig } from '~/types'
+export const siteConfig: SiteConfig = {
+  /** Displayed in the navbar and page title */
+  name: 'TanStack',
+  /** Project description shown on landing page */
+  description: 'High-quality open-source software for web developers',
+  /** Repository URL — used for "Edit on GitHub" links */
+  repo: 'https://github.com/nicepkg/docs-i18n',
+  /** Default locale (must exist in `supportedLocales`) */
+  defaultLocale: 'en',
+  /** All locales the site supports */
+  supportedLocales: {
+    en: 'English',
+    'zh-hans': '简体中文',
+    ja: '日本語',
+    es: 'Español',
+  },
+  /** Default project ID to redirect to from / */
+  defaultProject: 'query',
+  /** Projects configured for this site */
+  projects: [
+    {
+      id: 'query',
+      name: 'TanStack Query',
+      type: 'doc',
+      repo: 'tanstack/query',
+      latestVersion: 'v5',
+      latestBranch: 'main',
+      availableVersions: ['v5', 'v4', 'v3'],
+      docsRoot: 'content/query',
+      defaultDocs: 'overview',
+      frameworks: ['react', 'vue', 'solid', 'svelte', 'angular'],
+      colorFrom: 'from-red-500',
+      colorTo: 'to-amber-500',
+      textColor: 'text-amber-500',
+      bgStyle: 'bg-red-500',
+      borderStyle: 'border-red-500/50',
+      textStyle: 'text-red-500',
+      tagline:
+        'Powerful asynchronous state management, server-state utilities and data fetching',
+      description:
+        'Fetch, cache, update, and wrangle all forms of async data in your TS/JS, React, Vue, Solid, Svelte & Angular applications all without touching any "global state".',
+    },
+    {
+      id: 'router',
+      name: 'TanStack Router',
+      type: 'doc',
+      repo: 'tanstack/router',
+      latestVersion: 'v1',
+      latestBranch: 'main',
+      availableVersions: ['v1'],
+      docsRoot: 'content/router',
+      defaultDocs: 'overview',
+      frameworks: ['react'],
+      colorFrom: 'from-emerald-500',
+      colorTo: 'to-lime-600',
+      textColor: 'text-emerald-500',
+      bgStyle: 'bg-emerald-500',
+      borderStyle: 'border-emerald-500/50',
+      textStyle: 'text-emerald-500',
+      tagline: 'Type-safe routing for React applications',
+      description:
+        'A powerful React router for client-side and full-stack applications. Fully type-safe APIs, first-class search-params for managing state in the URL.',
+    },
+    {
+      id: 'table',
+      name: 'TanStack Table',
+      type: 'doc',
+      repo: 'tanstack/table',
+      latestVersion: 'v8',
+      latestBranch: 'main',
+      availableVersions: ['v8'],
+      docsRoot: 'content/table',
+      defaultDocs: 'overview',
+      frameworks: ['react', 'vue', 'solid', 'svelte'],
+      colorFrom: 'from-cyan-500',
+      colorTo: 'to-blue-600',
+      textColor: 'text-blue-600',
+      bgStyle: 'bg-blue-500',
+      borderStyle: 'border-blue-500/50',
+      textStyle: 'text-blue-500',
+      tagline: 'Headless UI for building powerful tables & datagrids',
+      description:
+        'Supercharge your tables or build a datagrid from scratch for TS/JS, React, Vue, Solid & Svelte while retaining 100% control over markup and styles.',
+    },
+    {
+      id: 'form',
+      name: 'TanStack Form',
+      type: 'doc',
+      repo: 'tanstack/form',
+      latestVersion: 'v1',
+      latestBranch: 'main',
+      availableVersions: ['v1'],
+      docsRoot: 'content/form',
+      defaultDocs: 'overview',
+      frameworks: ['react', 'vue', 'angular'],
+      colorFrom: 'from-yellow-500',
+      colorTo: 'to-yellow-600',
+      textColor: 'text-yellow-600',
+      bgStyle: 'bg-yellow-500',
+      borderStyle: 'border-yellow-500/50',
+      textStyle: 'text-yellow-500',
+      badge: 'NEW',
+      tagline: 'Headless UI for building performant and type-safe forms',
+      description:
+        'Headless, performant, and type-safe form state management for TS/JS, React, Vue & Angular.',
+    },
+    {
+      id: 'virtual',
+      name: 'TanStack Virtual',
+      type: 'doc',
+      repo: 'tanstack/virtual',
+      latestVersion: 'v3',
+      latestBranch: 'main',
+      availableVersions: ['v3'],
+      docsRoot: 'content/virtual',
+      defaultDocs: 'overview',
+      frameworks: ['react', 'vue', 'solid', 'svelte'],
+      colorFrom: 'from-purple-500',
+      colorTo: 'to-violet-600',
+      textColor: 'text-purple-600',
+      bgStyle: 'bg-purple-500',
+      borderStyle: 'border-purple-500/50',
+      textStyle: 'text-purple-500',
+      tagline: 'Headless UI for virtualizing large element lists',
+      description:
+        'Virtualize only the visible content for massive scrollable DOM nodes at 60FPS in TS/JS, React, Vue, Solid & Svelte while retaining 100% control over markup and styles.',
+    },
+  ],
+  features: {
+    frameworkSelector: true,
+    versionSelector: true,
+    editOnGithub: true,
+  },
+}
+/**
+ * Find a project by ID. Returns undefined if not found.
+ */
+export function findProject(id: string): ProjectConfig | undefined {
+  return siteConfig.projects.find((p) => p.id === id)
+}
+/**
+ * Get a project by ID. Throws if not found.
+ */
+export function getProject(id: string): ProjectConfig {
+  const project = findProject(id)
+  if (!project) {
+    throw new Error(`Project not found: ${id}`)
+  }
+  return project
+}
+/**
+ * Get all doc-type projects.
+ */
+export function getDocProjects(): ProjectConfig[] {
+  return siteConfig.projects.filter((p) => p.type === 'doc')
+}
+/**
+ * Whether this site has only one project (enables simplified URLs).
+ */
+export function isSingleProject(): boolean {
+  return siteConfig.projects.length <= 1
+}
+/**
+ * Get the single/default project. Throws if no projects configured.
+ */
+export function getSingleProject(): ProjectConfig {
+  const projectId = siteConfig.defaultProject || siteConfig.projects[0]?.id
+  if (!projectId) {
+    throw new Error('No projects configured in site.config.ts')
+  }
+  return getProject(projectId)
+}