git0 0.3.17 → 0.3.19

package/docs/components/ui/collapsible.tsx

@@ -0,0 +1,44 @@
+/**
+ * @file collapsible.tsx
+ * @description Collapsible component for hiding/showing content, built with Radix UI.
+ */
+// @ts-nocheck - Radix UI types incompatible with React 19 children prop
+'use client';
+import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
+import React, { forwardRef, useEffect, useState } from 'react';
+import { cn } from '@/lib/utils';
+
+const Collapsible = CollapsiblePrimitive.Root as any;
+
+const CollapsibleTrigger = CollapsiblePrimitive.CollapsibleTrigger as any;
+
+const CollapsibleContent = forwardRef<
+  HTMLDivElement,
+  React.ComponentPropsWithoutRef<typeof CollapsiblePrimitive.CollapsibleContent>
+>(({ children, ...props }, ref) => {
+  const [mounted, setMounted] = useState(false);
+
+  useEffect(() => {
+    setMounted(true);
+  }, []);
+
+  return (
+    <CollapsiblePrimitive.CollapsibleContent
+      ref={ref}
+      {...props}
+      className={cn(
+        'overflow-hidden',
+        mounted &&
+        'data-[state=closed]:animate-fd-collapsible-up data-[state=open]:animate-fd-collapsible-down',
+        props.className,
+      )}
+    >
+      {children}
+    </CollapsiblePrimitive.CollapsibleContent>
+  );
+});
+
+CollapsibleContent.displayName =
+  CollapsiblePrimitive.CollapsibleContent.displayName;
+
+export { Collapsible, CollapsibleTrigger, CollapsibleContent };

package/docs/components/ui/slider.tsx

@@ -0,0 +1,36 @@
+"use client"
+
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+type SliderProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "onChange" | "value"> & {
+  value?: number[]
+  onValueChange?: (value: number[]) => void
+}
+
+const Slider = React.forwardRef<HTMLInputElement, SliderProps>(
+  ({ className, value = [0], onValueChange, min = 0, max = 100, step = 1, ...props }, ref) => {
+    return (
+      <input
+        ref={ref}
+        type="range"
+        min={min}
+        max={max}
+        step={step}
+        value={value[0] ?? 0}
+        onChange={(event) => onValueChange?.([Number(event.target.value)])}
+        className={cn(
+          "h-2 w-full cursor-pointer appearance-none rounded-full bg-slate-800 accent-sky-400",
+          "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-sky-400 focus-visible:ring-offset-2 focus-visible:ring-offset-slate-950",
+          className,
+        )}
+        {...props}
+      />
+    )
+  },
+)
+
+Slider.displayName = "Slider"
+
+export { Slider }

package/docs/components/ui/tooltip.tsx

@@ -0,0 +1,63 @@
+// @ts-nocheck - Radix UI types incompatible with React 19 children prop
+"use client"
+
+import * as React from "react"
+import * as TooltipPrimitive from "@radix-ui/react-tooltip"
+
+import { cn } from "@/lib/utils"
+
+function TooltipProvider({
+  delayDuration = 0,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
+  return (
+    <TooltipPrimitive.Provider
+      data-slot="tooltip-provider"
+      delayDuration={delayDuration}
+      {...props}
+    />
+  )
+}
+
+function Tooltip({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
+  return (
+    <TooltipProvider>
+      <TooltipPrimitive.Root data-slot="tooltip" {...props} />
+    </TooltipProvider>
+  )
+}
+
+function TooltipTrigger({
+  children,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Trigger> & { children?: React.ReactNode }) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props}>{children}</TooltipPrimitive.Trigger>
+}
+
+function TooltipContent({
+  className,
+  sideOffset = 4,
+  children,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Content>) {
+  return (
+    <TooltipPrimitive.Portal>
+      <TooltipPrimitive.Content
+        data-slot="tooltip-content"
+        sideOffset={sideOffset}
+        className={cn(
+          "bg-slate-950 border-slate-800 text-slate-100 z-50 overflow-hidden rounded-md border px-3 py-1.5 text-xs shadow-md animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
+          className
+        )}
+        {...props}
+      >
+        {children}
+        <TooltipPrimitive.Arrow className="fill-slate-950" />
+      </TooltipPrimitive.Content>
+    </TooltipPrimitive.Portal>
+  )
+}
+
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }

package/docs/components/ui/video-modal.tsx

@@ -0,0 +1,238 @@
+/**
+ * @file video-modal.tsx
+ * @description Modal component specifically designed for playing video content.
+ */
+// @ts-nocheck - Radix UI types incompatible with React 19 children prop
+'use client'
+
+import * as React from 'react'
+import * as DialogPrimitive from '@radix-ui/react-dialog'
+import { cn } from "@/lib/utils"
+
+function VideoModal({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Root>) {
+  return <DialogPrimitive.Root data-slot="video-modal" {...props} />
+}
+
+function VideoModalTrigger({
+  children,
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Trigger> & { children?: React.ReactNode }) {
+  return <DialogPrimitive.Trigger data-slot="video-modal-trigger" {...props}>{children}</DialogPrimitive.Trigger>
+}
+
+function VideoModalPortal({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Portal>) {
+  return <DialogPrimitive.Portal data-slot="video-modal-portal" {...props} />
+}
+
+function VideoModalClose({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Close>) {
+  return <DialogPrimitive.Close data-slot="video-modal-close" {...props} />
+}
+
+const VideoModalOverlay = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Overlay>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>
+>(({ className, ...props }, ref) => (
+  <DialogPrimitive.Overlay
+    ref={ref}
+    className={cn(
+      'data-[state=closed]:animate-modal-fade-out data-[state=open]:animate-modal-fade-in fixed inset-0 z-50 backdrop-blur-xl',
+      className,
+    )}
+    {...props}
+  />
+))
+VideoModalOverlay.displayName = DialogPrimitive.Overlay.displayName
+
+const VideoModalContent = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content>
+>(({ className, children, ...props }, ref) => (
+  <VideoModalPortal>
+    <VideoModalOverlay />
+    <DialogPrimitive.Content
+      ref={ref}
+      className={cn(
+        'fixed left-1/2 top-1/2 z-50 flex h-screen w-screen -translate-x-1/2 -translate-y-1/2 items-center justify-center p-3',
+        'data-[state=closed]:animate-modal-fade-out data-[state=open]:animate-modal-fade-in data-[state=closed]:slide-out-to-left-1/2 data-[state=closed]:slide-out-to-top-[50%] data-[state=open]:slide-in-from-left-1/2 data-[state=open]:slide-in-from-top-[50%] transition-all',
+        className,
+      )}
+      {...props}
+    >
+      <div className="relative mx-auto flex size-full items-center justify-center rounded-2xl border border-gray-950/[.1] bg-gray-50/[.2] dark:border-gray-50/[.1] dark:bg-gray-950/[.5]">
+        {/* Mobile close button */}
+        <CloseIcon isMobile />
+
+        <div className="flex h-4/5 w-full max-w-5xl gap-6">
+          {/* Desktop close button */}
+          <CloseIcon />
+          <div className="flex w-full flex-col max-lg:p-4 max-lg:text-center">
+            {children}
+          </div>
+        </div>
+      </div>
+    </DialogPrimitive.Content>
+  </VideoModalPortal>
+))
+
+VideoModalContent.displayName = DialogPrimitive.Content.displayName
+
+const VideoModalTitle = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Title>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>
+>(({ className, ...props }, ref) => (
+  <DialogPrimitive.Title
+    ref={ref}
+    className={cn(
+      'mb-4 text-4xl font-bold text-gray-950 dark:text-gray-50',
+      className,
+    )}
+    {...props}
+  />
+))
+VideoModalTitle.displayName = DialogPrimitive.Title.displayName
+
+const VideoModalDescription = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Description>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>
+>(({ className, ...props }, ref) => (
+  <DialogPrimitive.Description
+    ref={ref}
+    className={cn(
+      'mb-6 text-xl text-gray-950/80 dark:text-gray-50/70',
+      className,
+    )}
+    {...props}
+  />
+))
+VideoModalDescription.displayName = DialogPrimitive.Description.displayName
+
+const VideoPreview = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, children, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      'absolute inset-0 z-10 transition-opacity duration-500 group-[.playing]:pointer-events-none group-[.playing]:opacity-0',
+      className,
+    )}
+    {...props}
+  >
+    {children}
+  </div>
+))
+VideoPreview.displayName = 'VideoPreview'
+
+const VideoPlayButton = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, children, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      'absolute inset-0 z-20 flex items-center justify-center transition-opacity duration-300 group-[.playing]:pointer-events-none group-[.playing]:opacity-0',
+      className,
+    )}
+    {...props}
+  >
+    {children}
+  </div>
+))
+VideoPlayButton.displayName = 'VideoPlayButton'
+
+const VideoPlayer = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, children, ...props }, ref) => {
+  const [isPlaying, setIsPlaying] = React.useState(false)
+
+  return (
+    <div
+      ref={ref}
+      className={cn(
+        'group relative aspect-video max-w-4xl overflow-hidden rounded-xl border border-gray-950/[.1] object-cover dark:border-gray-50/[.1]',
+        isPlaying && 'playing',
+        className,
+      )}
+      onClick={() => setIsPlaying(true)}
+      {...props}
+    >
+      {children}
+    </div>
+  )
+})
+VideoPlayer.displayName = 'VideoPlayer'
+
+const VideoModalVideo = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, children, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      'aspect-video max-w-4xl overflow-hidden rounded-xl border border-gray-950/[.1] object-cover shadow-xl dark:border-gray-50/[.1]',
+      className,
+    )}
+    {...props}
+  >
+    {children}
+  </div>
+))
+VideoModalVideo.displayName = 'VideoModalVideo'
+
+const CloseIcon = React.forwardRef<
+  React.ElementRef<typeof VideoModalClose>,
+  React.ComponentPropsWithoutRef<typeof VideoModalClose> & {
+    isMobile?: boolean
+  }
+>(({ className, isMobile = false, ...props }, ref) => (
+  <VideoModalClose
+    ref={ref}
+    className={cn(
+      'rounded-full border border-gray-950/[.1] bg-gray-950/[.01] p-2 transition duration-300 hover:bg-gray-950/[.05] dark:border-gray-50/[.1] dark:bg-gray-50/[.10] dark:hover:bg-gray-50/[.15]',
+      isMobile
+        ? 'absolute right-4 top-4 lg:hidden'
+        : 'hidden self-start lg:block',
+      className,
+    )}
+    {...props}
+  >
+    <svg
+      fill="none"
+      height="12"
+      viewBox="0 0 12 12"
+      width="12"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path
+        d="M1 1L11 11M11 1L1 11"
+        className="stroke-current"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+        strokeWidth="1.5"
+      >
+      </path>
+    </svg>
+    <span className="sr-only">Close</span>
+  </VideoModalClose>
+))
+
+CloseIcon.displayName = 'CloseIcon'
+
+export {
+  VideoModal,
+  VideoModalTrigger,
+  VideoModalContent,
+  VideoModalTitle,
+  VideoModalDescription,
+  VideoModalVideo,
+  VideoPreview,
+  VideoPlayButton,
+  VideoPlayer,
+}

package/docs/content/docs/fm.mdx

@@ -0,0 +1,11 @@
+---
+title: fm
+description: Terminal file manager bundled with git0.
+---
+
+`fm` is a keyboard-driven terminal file manager that ships as one of git0's bins.
+It is not built — the bin points straight at `src/fm.js`.
+
+```bash
+fm
+```

package/{docs-config/src/functions/git0.md → docs/content/docs/git0.mdx}

@@ -1,4 +1,7 @@
-[Documentation](modules.md) / git0
+---
+title: git0
+description: Project setup functions — dependency installation and IDE launching.
+---
 
 ## installDependencies()
 

package/{docs-config/src/functions/github-api.md → docs/content/docs/github-api.mdx}

@@ -1,4 +1,7 @@
-[Documentation](modules.md) / github-api
+---
+title: github-api
+description: GitHub API helpers for searching repositories and downloading source and releases.
+---
 
 ## default
 

package/{docs-config/src/functions/index.md → docs/content/docs/index.mdx}

@@ -1,17 +1,12 @@
-<p align="center">
-    <img  src="https://i.imgur.com/RLXLAzY.png" />
-</p>
-<p align="center">
-    <a href="https://discord.gg/SJdBqBz3tV"><img src="https://img.shields.io/discord/1110227955554209923.svg?label=Chat&logo=Discord&colorB=7289da&style=flat"/></a>
-    <a href="https://github.com/vtempest/git0/discussions"><img alt="GitHub Stars" src="https://img.shields.io/github/stars/vtempest/git0" /></a>
-    <a href="https://github.com/vtempest/git0/discussions"><img alt="GitHub Discussions" src="https://img.shields.io/github/discussions/vtempest/git0" /></a>
-    <a href="https://github.com/vtempest/git0/pulse" alt="Activity"><img src="https://img.shields.io/github/commit-activity/m/vtempest/git0" /></a>
-    <img src="https://img.shields.io/github/last-commit/vtempest/git0.svg" alt="GitHub last commit" />
-    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" />
-    <a href="https://codespaces.new/vtempest/git0"><img src="https://github.com/codespaces/badge.svg" width="150" height="20" /></a>
-</p>  
-
-# Git0: Download Git Repo on Step Zero 
+---
+title: Introduction
+description: Download Git Repo on Step Zero — search GitHub, download source & releases, install dependencies and open your editor.
+---
+
+![git0](https://i.imgur.com/RLXLAzY.png)
+
+[![npm version](https://img.shields.io/npm/v/git0.svg)](https://www.npmjs.com/package/git0) [![Discord](https://img.shields.io/discord/1110227955554209923.svg?label=Chat&logo=Discord&colorB=7289da&style=flat)](https://discord.gg/SJdBqBz3tV) [![GitHub Stars](https://img.shields.io/github/stars/OpenSourceAGI/dev-tools-starter-agent)](https://github.com/OpenSourceAGI/dev-tools-starter-agent) [![GitHub Discussions](https://img.shields.io/github/discussions/OpenSourceAGI/dev-tools-starter-agent)](https://github.com/OpenSourceAGI/dev-tools-starter-agent/discussions) ![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)  
+
 CLI tool to search GitHub repositories, download source & releases for your system, and instantly set up, then install dependencies and open code editor.
 
 ## 🚀 Installation

package/docs/content/docs/meta.json

@@ -0,0 +1,15 @@
+{
+  "title": "git0",
+  "description": "Download Git Repo on Step Zero",
+  "icon": "Book",
+  "root": true,
+  "pages": [
+    "---Getting Started---",
+    "index",
+    "---API Reference---",
+    "modules",
+    "git0",
+    "github-api",
+    "fm"
+  ]
+}

package/docs/content/docs/modules.mdx

@@ -0,0 +1,10 @@
+---
+title: Modules
+description: Index of the git0 source modules.
+---
+
+## Modules
+
+- [fm](/docs/fm)
+- [git0](/docs/git0)
+- [github-api](/docs/github-api)

package/docs/lib/fumadocs/customize-docs.ts

@@ -0,0 +1,47 @@
+/**
+ * @file customize-docs.ts
+ * @description Documentation configuration object and types.
+ */
+export const docsConfig: DocsConfig = {
+  title: "git0",
+  description: "Download Git Repo on Step Zero — search GitHub, download source & releases, install and open in your editor.",
+  github: "https://github.com/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages/git0-repo-downloader",
+  githubPackages: "https://github.com/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages",
+  githubDocs:
+    "https://github.com/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages/git0-repo-downloader/docs/content/docs",
+  favicon: "/favicon.ico",
+  topLinks: [
+    {
+      text: "Docs",
+      url: "/docs",
+    },
+    {
+      text: "GitHub",
+      url: "https://github.com/OpenSourceAGI/dev-tools-starter-agent/tree/master/packages/git0-repo-downloader",
+      external: true,
+    },
+  ],
+};
+
+export interface DocsConfig {
+  /** The title of the documentation site */
+  title?: string;
+  /** A short description of the project */
+  description?: string;
+  /** URL to the GitHub repository */
+  github?: string;
+  /** Base URL for editing the docs pages on GitHub */
+  githubDocs?: string;
+  /** Base URL for the packages directory on GitHub */
+  githubPackages?: string;
+  /** Path to the favicon */
+  favicon?: string;
+  /** Path to the OpenAPI specification file */
+  apiDocsPath?: string;
+  /** Links to be displayed in the navigation bar */
+  topLinks?: {
+    text: string;
+    url: string;
+    external?: boolean;
+  }[];
+}

package/docs/lib/fumadocs/generate-api-docs.ts

@@ -0,0 +1,73 @@
+/**
+ * @file generate-api-docs.ts
+ * @description Script to generate API documentation files from an OpenAPI specification.
+ */
+import { generateFiles } from 'fumadocs-openapi';
+import { createOpenAPI } from 'fumadocs-openapi/server';
+import { rimraf } from 'rimraf';
+import { existsSync } from 'fs';
+import { docsConfig } from './customize-docs'
+
+const out = 'content/docs/(api)';
+
+
+async function generate(openapiPath: string | undefined) {
+  // Validate file exists
+  if (!openapiPath || !existsSync(openapiPath)) {
+    console.error(`Error: OpenAPI file not found${openapiPath ? ` at "${openapiPath}"` : ''}`);
+    process.exit(1);
+  }
+
+  // Use relative path for glob resolution
+  console.log(`Generating API docs from: ${openapiPath}`);
+
+  // clean generated files
+  await rimraf(out, {
+    filter(v) {
+      return !v.endsWith('index.mdx') && !v.endsWith('meta.json');
+    },
+  });
+
+  // Create OpenAPI instance (required for fumadocs-openapi v10+)
+  const openapi = createOpenAPI({
+    input: [openapiPath],
+  });
+
+  await generateFiles({
+    input: openapi,
+    output: out,
+    includeDescription: true,
+
+    // Or disable comments
+    addGeneratedComment: false,
+    frontmatter: (title, description) => ({
+      description: ''
+    }),
+    // index: {
+    //   // for generating `href`
+    //   url: {
+    //     baseUrl: '/docs/api',
+    //     contentDir: './content/docs/api',
+    //   },
+    //   items: [
+    //     {
+    //       path: 'api.mdx',
+    //       description: 'All available pages',
+    //     },
+    //   ],
+    // },
+
+  });
+
+  console.log(`API documentation generated successfully in: ${out}`);
+}
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+
+const openapiPath = args[0] || docsConfig.apiDocsPath;
+if (!openapiPath) {
+    console.error('Error: OpenAPI file path not provided');
+    process.exit(1);
+}
+void generate(openapiPath);

package/docs/lib/fumadocs/source.tsx

@@ -0,0 +1,50 @@
+/**
+ * @file source.tsx
+ * @description Fumadocs source loader configuration and page structure.
+ */
+import { docs } from 'fumadocs-mdx:collections/server'
+import {
+  type InferMetaType,
+  type InferPageType,
+  type LoaderPlugin,
+  loader,
+} from 'fumadocs-core/source'
+import { lucideIconsPlugin } from 'fumadocs-core/source/lucide-icons'
+import { openapiPlugin } from 'fumadocs-openapi/server'
+
+export const source = loader({
+  baseUrl: '/docs',
+  plugins: [pageTreeCodeTitles(), lucideIconsPlugin(), openapiPlugin()],
+  source: docs.toFumadocsSource(),
+})
+
+function pageTreeCodeTitles(): LoaderPlugin {
+  return {
+    transformPageTree: {
+      file(node) {
+        if (
+          typeof node.name === 'string' &&
+          (node.name.endsWith('()') || node.name.match(/^<\w+ \/>$/))
+        ) {
+          return {
+            ...node,
+            name: <code className='text-[0.8125rem]'>{node.name}</code>,
+          }
+        }
+        return node
+      },
+    },
+  }
+}
+
+
+export async function getLLMText(page: InferPageType<typeof source>) {
+  const processed = await page.data.getText('processed');
+
+  return `# ${page.data.title} (${page.url})
+
+${processed}`;
+}
+
+export type Page = InferPageType<typeof source>
+export type Meta = InferMetaType<typeof source>

package/docs/lib/utils.ts

@@ -0,0 +1,10 @@
+/**
+ * @file utils.ts
+ * @description General utility functions for the documentation site.
+ */
+import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/docs/mdx-components.tsx

@@ -0,0 +1,21 @@
+
+import * as TabsComponents from 'fumadocs-ui/components/tabs';
+import { File, Folder, Files } from 'fumadocs-ui/components/files';
+import defaultComponents from 'fumadocs-ui/mdx';
+import { APIPage } from '@/components/fumadocs/api/api-page';
+import type { MDXComponents } from 'mdx/types';
+// make sure you can use it in MDX files
+
+
+export function getMDXComponents(components?: MDXComponents): MDXComponents {
+  return {
+    ...TabsComponents,
+    ...defaultComponents,
+    // @ts-ignore
+    APIPage,
+    File,
+    Folder,
+    Files,
+    ...components,
+  };
+}

package/docs/next-env.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+import "./.next/types/root-params.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.