From 7f5d307c0ff0bcdfde8294684d70039cf92f5bff Mon Sep 17 00:00:00 2001 From: Ajax Davis Date: Sat, 29 Nov 2025 19:59:21 +1000 Subject: [PATCH 001/106] fix(api): remove conflicting [id] route causing build error MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Next.js error: "You cannot use different slug names for the same dynamic path ('id' !== 'slug')" Removed /api/tools/[id]/route.ts to resolve conflict with /api/tools/[slug]/route.ts The [slug] route already handles fetching tools by package name ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .env.vercel.production | 41 ++ HOW_TO_PUBLISH_A_TOOL.md | 464 +++++++++++++++++++++++ apps/web/src/app/api/tools/[id]/route.ts | 63 --- 3 files changed, 505 insertions(+), 63 deletions(-) create mode 100644 .env.vercel.production create mode 100644 HOW_TO_PUBLISH_A_TOOL.md delete mode 100644 apps/web/src/app/api/tools/[id]/route.ts diff --git a/.env.vercel.production b/.env.vercel.production new file mode 100644 index 0000000..bf0ac19 --- /dev/null +++ b/.env.vercel.production @@ -0,0 +1,41 @@ +# Created by Vercel CLI +CRON_SECRET="CRON_SECRET=6c806d35cf6212f489c76414d38d2b6acbc44590ac78bb08aadea28dd04a29d0\n" +DATABASE_URL="postgresql://neondb_owner:npg_euvYo4OTi1lX@ep-broad-darkness-a4lml85k-pooler.us-east-1.aws.neon.tech/neondb?sslmode=require" +DATABASE_URL_UNPOOLED="postgresql://neondb_owner:npg_euvYo4OTi1lX@ep-broad-darkness-a4lml85k.us-east-1.aws.neon.tech/neondb?sslmode=require" +NEXT_PUBLIC_STACK_PROJECT_ID="d786bd3a-a31d-4c6b-9497-5d6803dd9d86" +NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY="pck_hafmpkaj047z331x5azv8bk5zggfnbgdedbj9pfqh1rn0" +NX_DAEMON="false" +PGDATABASE="neondb" +PGHOST="ep-broad-darkness-a4lml85k-pooler.us-east-1.aws.neon.tech" +PGHOST_UNPOOLED="ep-broad-darkness-a4lml85k.us-east-1.aws.neon.tech" +PGPASSWORD="npg_euvYo4OTi1lX" +PGUSER="neondb_owner" +POSTGRES_DATABASE="neondb" +POSTGRES_HOST="ep-broad-darkness-a4lml85k-pooler.us-east-1.aws.neon.tech" +POSTGRES_PASSWORD="npg_euvYo4OTi1lX" +POSTGRES_PRISMA_URL="postgresql://neondb_owner:npg_euvYo4OTi1lX@ep-broad-darkness-a4lml85k-pooler.us-east-1.aws.neon.tech/neondb?connect_timeout=15&sslmode=require" +POSTGRES_URL="postgresql://neondb_owner:npg_euvYo4OTi1lX@ep-broad-darkness-a4lml85k-pooler.us-east-1.aws.neon.tech/neondb?sslmode=require" +POSTGRES_URL_NON_POOLING="postgresql://neondb_owner:npg_euvYo4OTi1lX@ep-broad-darkness-a4lml85k.us-east-1.aws.neon.tech/neondb?sslmode=require" +POSTGRES_URL_NO_SSL="postgresql://neondb_owner:npg_euvYo4OTi1lX@ep-broad-darkness-a4lml85k-pooler.us-east-1.aws.neon.tech/neondb" +POSTGRES_USER="neondb_owner" +STACK_SECRET_SERVER_KEY="ssk_p05kwe938wx13rpera9xf1fewc816dwkbq658xcsbwj1g" +TURBO_CACHE="remote:rw" +TURBO_DOWNLOAD_LOCAL_ENABLED="true" +TURBO_REMOTE_ONLY="true" +TURBO_RUN_SUMMARY="true" +VERCEL="1" +VERCEL_ENV="production" +VERCEL_GIT_COMMIT_AUTHOR_LOGIN="" +VERCEL_GIT_COMMIT_AUTHOR_NAME="" +VERCEL_GIT_COMMIT_MESSAGE="" +VERCEL_GIT_COMMIT_REF="" +VERCEL_GIT_COMMIT_SHA="" +VERCEL_GIT_PREVIOUS_SHA="" +VERCEL_GIT_PROVIDER="" +VERCEL_GIT_PULL_REQUEST_ID="" +VERCEL_GIT_REPO_ID="" +VERCEL_GIT_REPO_OWNER="" +VERCEL_GIT_REPO_SLUG="" +VERCEL_OIDC_TOKEN="eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Im1yay00MzAyZWMxYjY3MGY0OGE5OGFkNjFkYWRlNGEyM2JlNyJ9.eyJpc3MiOiJodHRwczovL29pZGMudmVyY2VsLmNvbS90cG1qcyIsInN1YiI6Im93bmVyOnRwbWpzOnByb2plY3Q6dHBtanMtd2ViOmVudmlyb25tZW50OmRldmVsb3BtZW50Iiwic2NvcGUiOiJvd25lcjp0cG1qczpwcm9qZWN0OnRwbWpzLXdlYjplbnZpcm9ubWVudDpkZXZlbG9wbWVudCIsImF1ZCI6Imh0dHBzOi8vdmVyY2VsLmNvbS90cG1qcyIsIm93bmVyIjoidHBtanMiLCJvd25lcl9pZCI6InRlYW1femtHV0NXYjdWakhvbmk2VmJ5ZmQyc3c4IiwicHJvamVjdCI6InRwbWpzLXdlYiIsInByb2plY3RfaWQiOiJwcmpfNWd1MEkwVzFjUFhkQ3ozd1RjQ0ZIejQzNUJ0MCIsImVudmlyb25tZW50IjoiZGV2ZWxvcG1lbnQiLCJwbGFuIjoicHJvIiwidXNlcl9pZCI6IkxKZk05VzdIdlljb2gyclVCaXRWd283ViIsIm5iZiI6MTc2NDM4OTAxMiwiaWF0IjoxNzY0Mzg5MDEyLCJleHAiOjE3NjQ0MzIyMTJ9.OF4IHrcmteA2lU1tkqHO1a9ITGGrCjCo29G8jI991q8_SQjgHZHVqcBj3AYVKZJDh6BjHib4HyNKdjO8nwUblF2dCFbYDv6y4hwB6jHNpsz32BE1JDKcXEJOKPtg_tBOFUDKtzMkPk7VOPWDVYw8Tz4_HZ_MR3SNoy1Pk9AFL-hEl3E-zR3bAYMDB8tKrIm9y9K4sZF6efMU7BR_J6Bf-i3IsbbrH-Axgq5dewlpogf-xHWmWaTXoUp6UFejNKhSMXqg3sAWTnizYeSGc2Ut6zNuAYPumUPBdQ37Kk7vuRNwS1h7RJz3vtEg6aOuw0-Ld0LdF-tWkfDGsVqanR_sxw" +VERCEL_TARGET_ENV="production" +VERCEL_URL="" diff --git a/HOW_TO_PUBLISH_A_TOOL.md b/HOW_TO_PUBLISH_A_TOOL.md new file mode 100644 index 0000000..ba6828c --- /dev/null +++ b/HOW_TO_PUBLISH_A_TOOL.md @@ -0,0 +1,464 @@ +# How to Publish a TPMJS Tool + +This guide shows you how to create and publish an AI tool that will be automatically discovered and listed on tpmjs.com. + +## Quick Start + +1. Create a new NPM package +2. Add `"tpmjs-tool"` to the `keywords` array in package.json +3. Add a `tpmjs` field with your tool's metadata +4. Publish to NPM +5. Your tool will automatically appear on tpmjs.com within 15 minutes + +## Step-by-Step Guide + +### 1. Create Your NPM Package + +Create a standard NPM package with your tool implementation: + +```bash +mkdir my-awesome-tool +cd my-awesome-tool +npm init -y +``` + +### 2. Add the Required Keyword + +In your `package.json`, add `"tpmjs-tool"` to the keywords array: + +```json +{ + "name": "@yourname/my-awesome-tool", + "version": "1.0.0", + "keywords": ["tpmjs-tool", "ai", "other-keywords"], + ... +} +``` + +**Important:** The `"tpmjs-tool"` keyword is REQUIRED for automatic discovery! + +### 3. Add TPMJS Metadata + +Add a `tpmjs` field to your `package.json` with your tool's metadata. There are three tiers: + +#### Tier 1: Minimal (Required Fields Only) + +The bare minimum to get listed: + +```json +{ + "tpmjs": { + "category": "text-analysis", + "description": "A concise description of what your tool does", + "example": "const result = await myTool({ input: 'hello' });" + } +} +``` + +**Required fields:** +- `category` - One of: `text-analysis`, `code-generation`, `data-processing`, `image-generation`, `audio-processing`, `search`, `integration`, `other` +- `description` - Clear description of what the tool does (1-3 sentences) +- `example` - Simple code example showing how to use the tool + +#### Tier 2: Basic (Recommended) + +Add parameter and return type information: + +```json +{ + "tpmjs": { + "category": "text-analysis", + "description": "Analyzes sentiment in text and returns a score", + "example": "const result = await analyzeSentiment({ text: 'I love this!' });", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The text to analyze", + "required": true + }, + { + "name": "language", + "type": "string", + "description": "Language code (e.g., 'en', 'es')", + "required": false, + "default": "en" + } + ], + "returns": { + "type": "SentimentResult", + "description": "Object containing score (-1 to 1) and label (positive/negative/neutral)" + } + } +} +``` + +#### Tier 3: Rich (Full Documentation) + +Complete metadata for maximum visibility: + +```json +{ + "tpmjs": { + "category": "text-analysis", + "description": "Advanced sentiment analysis with emotion detection", + "example": "const result = await analyzeSentiment({ text: 'I love this!', includeEmotions: true });", + "parameters": [ + { + "name": "text", + "type": "string", + "description": "The text to analyze", + "required": true + }, + { + "name": "language", + "type": "string", + "description": "Language code", + "required": false, + "default": "en" + }, + { + "name": "includeEmotions", + "type": "boolean", + "description": "Whether to include emotion breakdown", + "required": false, + "default": false + } + ], + "returns": { + "type": "SentimentResult", + "description": "Object with score, label, and optional emotions array" + }, + "authentication": { + "type": "api-key", + "required": true + }, + "pricing": { + "model": "pay-per-use", + "cost": "$0.001 per request" + }, + "frameworks": ["vercel-ai", "langchain"], + "links": { + "documentation": "https://docs.example.com", + "repository": "https://github.com/yourname/tool", + "homepage": "https://yourwebsite.com" + }, + "tags": ["sentiment", "nlp", "emotions", "ai"], + "status": "stable", + "aiAgent": { + "useCase": "Use this tool when users need to analyze sentiment in text, detect emotions, or understand the tone of customer feedback, reviews, or social media posts.", + "limitations": "Only supports English and Spanish. Maximum 10,000 characters per request.", + "examples": [ + "Analyze customer review sentiment", + "Detect emotions in user feedback", + "Monitor social media sentiment" + ] + } + } +} +``` + +### 4. Implement Your Tool + +Write your tool's implementation. Here's the example from `@tpmjs/createblogpost`: + +```typescript +// src/index.ts +export interface BlogPostOptions { + title: string; + author: string; + content: string; + tags?: string[]; + format?: 'markdown' | 'mdx'; + excerpt?: string; +} + +export interface BlogPost { + frontmatter: { + title: string; + author: string; + date: string; + tags: string[]; + excerpt?: string; + slug: string; + wordCount: number; + readingTime: number; + }; + content: string; + formattedOutput: string; +} + +export async function createBlogPost(options: BlogPostOptions): Promise { + // Your implementation here + const { title, author, content, tags = [], format = 'markdown', excerpt } = options; + + // Validate inputs + if (!title || !author || !content) { + throw new Error('Title, author, and content are required'); + } + + // Process and return result + return { + frontmatter: { /* ... */ }, + content, + formattedOutput: '...' + }; +} + +export default createBlogPost; +``` + +### 5. Build and Publish + +Build your package and publish to NPM: + +```bash +# Build your package +npm run build + +# Publish to NPM +npm publish --access public +``` + +### 6. Verification + +Your tool will be automatically discovered through: + +1. **Keyword Search** - Runs every 15 minutes, searches NPM for `"tpmjs-tool"` +2. **Changes Feed** - Monitors NPM publishes in real-time (every 2 minutes) + +After publishing, your tool should appear on https://tpmjs.com within 15 minutes! + +You can verify by searching: https://tpmjs.com/api/tools?q=yourpackagename + +## Real Example: @tpmjs/createblogpost + +Here's the complete `package.json` from the published example: + +```json +{ + "name": "@tpmjs/createblogpost", + "version": "0.2.0", + "description": "A tool for creating structured blog posts with AI-generated content", + "type": "module", + "keywords": ["tpmjs-tool", "blog", "content", "ai", "writing"], + "exports": { + ".": { + "types": "./dist/index.d.ts", + "default": "./dist/index.js" + } + }, + "files": ["dist"], + "scripts": { + "build": "tsup", + "dev": "tsup --watch", + "type-check": "tsc --noEmit" + }, + "publishConfig": { + "access": "public" + }, + "repository": { + "type": "git", + "url": "https://github.com/ajaxdavis/tpmjs.git", + "directory": "packages/tools/createBlogPost" + }, + "homepage": "https://tpmjs.com", + "license": "MIT", + "tpmjs": { + "category": "text-analysis", + "description": "Creates structured blog posts with customizable frontmatter, content sections, and SEO metadata. Supports multiple output formats including Markdown and MDX.", + "example": "const post = await createBlogPost({ title: 'My First Post', author: 'John Doe', content: 'Hello World!', tags: ['intro', 'blog'] });", + "parameters": [ + { + "name": "title", + "type": "string", + "description": "The title of the blog post", + "required": true + }, + { + "name": "author", + "type": "string", + "description": "The author of the blog post", + "required": true + }, + { + "name": "content", + "type": "string", + "description": "The main content of the blog post", + "required": true + }, + { + "name": "tags", + "type": "string[]", + "description": "Array of tags for categorization", + "required": false, + "default": [] + }, + { + "name": "format", + "type": "'markdown' | 'mdx'", + "description": "Output format for the blog post", + "required": false, + "default": "markdown" + }, + { + "name": "excerpt", + "type": "string", + "description": "Short excerpt or summary of the post", + "required": false + } + ], + "returns": { + "type": "BlogPost", + "description": "A structured blog post object with frontmatter, content, and metadata including slug, wordCount, readingTime, and formattedOutput" + }, + "authentication": { + "required": false, + "type": "api-key" + }, + "pricing": { + "model": "free" + }, + "frameworks": ["vercel-ai", "langchain"], + "links": { + "documentation": "https://tpmjs.com/tools/createblogpost", + "repository": "https://github.com/ajaxdavis/tpmjs/tree/main/packages/tools/createBlogPost", + "homepage": "https://tpmjs.com" + }, + "tags": ["blog", "content", "markdown", "mdx", "writing", "seo"], + "status": "stable", + "aiAgent": { + "useCase": "Use this tool when users need to generate blog posts, articles, or structured content with proper frontmatter and metadata. Ideal for content management systems, static site generators, and documentation sites.", + "limitations": "Does not include AI content generation - you must provide the content. Only formats and structures existing content.", + "examples": [ + "Create a blog post about TypeScript best practices", + "Generate a tutorial post with code examples", + "Format an article with SEO metadata" + ] + } + } +} +``` + +## Field Reference + +### Required Fields (Tier 1 - Minimal) + +| Field | Type | Description | +|-------|------|-------------| +| `category` | string | Tool category (see categories below) | +| `description` | string | Clear description (1-3 sentences) | +| `example` | string | Code example showing usage | + +### Optional Fields (Tier 2 - Basic) + +| Field | Type | Description | +|-------|------|-------------| +| `parameters` | array | Array of parameter objects | +| `returns` | object | Return type information | + +### Optional Fields (Tier 3 - Rich) + +| Field | Type | Description | +|-------|------|-------------| +| `authentication` | object | Auth requirements | +| `pricing` | object | Pricing information | +| `frameworks` | array | Compatible frameworks | +| `links` | object | Related URLs | +| `tags` | array | Additional tags | +| `status` | string | `stable`, `beta`, or `experimental` | +| `aiAgent` | object | AI agent integration info | + +### Categories + +Choose one of these for the `category` field: + +- `text-analysis` - NLP, sentiment, summarization +- `code-generation` - Code generation and transformation +- `data-processing` - Data manipulation and transformation +- `image-generation` - Image creation and editing +- `audio-processing` - Audio/speech processing +- `search` - Search and retrieval +- `integration` - Third-party integrations +- `other` - Anything else + +### Authentication Types + +If your tool requires authentication: + +```json +"authentication": { + "type": "api-key", // or "oauth", "bearer-token", "basic" + "required": true +} +``` + +### Pricing Models + +```json +"pricing": { + "model": "free" // or "pay-per-use", "subscription", "freemium" +} +``` + +For paid tools, add cost information: + +```json +"pricing": { + "model": "pay-per-use", + "cost": "$0.001 per request" +} +``` + +## Quality Score + +Your tool gets a quality score based on: + +- **Tier**: Rich (1.0) > Basic (0.5) > Minimal (0.25) +- **Downloads**: Logarithmic scale based on monthly NPM downloads +- **GitHub Stars**: Logarithmic scale based on repository stars + +Higher scores = better visibility on tpmjs.com! + +## Tips for Success + +1. **Use descriptive names** - Make your package name clear and searchable +2. **Complete metadata** - Tier 3 (Rich) tools get 4x the base score +3. **Good documentation** - Link to docs in the `links.documentation` field +4. **Active maintenance** - Regular updates boost download counts +5. **AI-friendly descriptions** - Write the `aiAgent.useCase` field as guidance for AI agents + +## Testing Locally + +Before publishing, you can validate your `tpmjs` field using the validation schema: + +```bash +# In the tpmjs monorepo +pnpm --filter=@tpmjs/types test +``` + +Or manually check the structure matches the examples above. + +## Troubleshooting + +**Tool not appearing after 15 minutes?** +- Check that you added `"tpmjs-tool"` to keywords +- Verify your `tpmjs` field has required fields (category, description, example) +- Check the NPM package is public: `npm view yourpackage` + +**Tool showing as "minimal" tier?** +- Add `parameters` and `returns` fields for Basic tier +- Add all Rich tier fields for maximum visibility + +**Want to force a sync?** +You can manually trigger a sync (requires auth): +```bash +curl -X POST "https://tpmjs.com/api/sync/keyword" \ + -H "Authorization: Bearer YOUR_CRON_SECRET" +``` + +## Support + +Questions or issues? +- File an issue: https://github.com/ajaxdavis/tpmjs/issues +- Check the API: https://tpmjs.com/api/tools diff --git a/apps/web/src/app/api/tools/[id]/route.ts b/apps/web/src/app/api/tools/[id]/route.ts deleted file mode 100644 index b9e38e4..0000000 --- a/apps/web/src/app/api/tools/[id]/route.ts +++ /dev/null @@ -1,63 +0,0 @@ -import { prisma } from '@tpmjs/db'; -import { type NextRequest, NextResponse } from 'next/server'; - -export const runtime = 'nodejs'; -export const dynamic = 'force-dynamic'; -export const maxDuration = 60; - -/** - * GET /api/tools/[id] - * Get tool details by ID or package name - * - * Params: - * - id: Tool ID (number) or NPM package name (string) - */ -export async function GET(_request: NextRequest, { params }: { params: Promise<{ id: string }> }) { - try { - const { id } = await params; - - if (!id) { - return NextResponse.json( - { - success: false, - error: 'Missing ID parameter', - }, - { status: 400 } - ); - } - - // Try to find by ID first (cuid), then by package name - const tool = await prisma.tool.findFirst({ - where: { - OR: [{ id }, { npmPackageName: id }], - }, - }); - - if (!tool) { - return NextResponse.json( - { - success: false, - error: 'Tool not found', - message: `No tool found with ID or package name: ${id}`, - }, - { status: 404 } - ); - } - - return NextResponse.json({ - success: true, - data: tool, - }); - } catch (error) { - console.error('Error fetching tool details:', error); - - return NextResponse.json( - { - success: false, - error: 'Failed to fetch tool details', - message: error instanceof Error ? error.message : 'Unknown error', - }, - { status: 500 } - ); - } -} From e38e627a07c8d440e47704e0cb6f7b1ab2031b33 Mon Sep 17 00:00:00 2001 From: Ajax Davis Date: Sat, 29 Nov 2025 22:19:43 +1000 Subject: [PATCH 002/106] feat(web): add comprehensive /publish page with full publishing guide MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Create new /publish page with step-by-step instructions - Show all 3 metadata tiers (Minimal, Basic, Rich) with examples - Include quality score explanation and real-world examples - Add category reference and tips for success - Update homepage with Publish navigation link - Add Publish Your Tool promotional section to homepage ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- apps/web/src/app/page.tsx | 51 +++- apps/web/src/app/publish/page.tsx | 441 ++++++++++++++++++++++++++++++ 2 files changed, 489 insertions(+), 3 deletions(-) create mode 100644 apps/web/src/app/publish/page.tsx diff --git a/apps/web/src/app/page.tsx b/apps/web/src/app/page.tsx index 2de9467..e4b46b6 100644 --- a/apps/web/src/app/page.tsx +++ b/apps/web/src/app/page.tsx @@ -32,9 +32,11 @@ export default function HomePage(): React.ReactElement { Playground - + + + @@ -104,6 +106,49 @@ export default function HomePage(): React.ReactElement { + + {/* Publish Your Tool Section */} +
+ +
+

+ Publish Your AI Tool +

+

+ Share your tool with the AI community. Automatic discovery, quality scoring, and + seamless integration with popular AI frameworks. +

+
+
+
๐Ÿš€
+

Quick Setup

+

+ Add one keyword to package.json and publish to NPM +

+
+
+
โšก
+

Auto Discovery

+

+ Your tool appears on tpmjs.com within 15 minutes +

+
+
+
๐Ÿ“Š
+

Quality Metrics

+

+ Automatic scoring based on docs, downloads, and stars +

+
+
+ + + +
+ +
{/* Footer */} diff --git a/apps/web/src/app/publish/page.tsx b/apps/web/src/app/publish/page.tsx new file mode 100644 index 0000000..a2c9ca7 --- /dev/null +++ b/apps/web/src/app/publish/page.tsx @@ -0,0 +1,441 @@ +import { Button } from '@tpmjs/ui/Button/Button'; +import { CodeBlock } from '@tpmjs/ui/CodeBlock/CodeBlock'; +import { Container } from '@tpmjs/ui/Container/Container'; +import { Header } from '@tpmjs/ui/Header/Header'; +import Link from 'next/link'; +import { ThemeToggle } from '../../components/ThemeToggle'; + +export const metadata = { + title: 'Publish a Tool | TPMJS', + description: 'Learn how to publish your AI tool to the TPMJS registry', +}; + +export default function PublishPage(): React.ReactElement { + return ( +
+ {/* Header */} +
+ TPMJS + + } + size="md" + sticky={true} + actions={ +
+ + + + + + + + + + +
+ } + /> + +
+ + {/* Hero */} +
+

+ Publish Your AI Tool +

+

+ Share your tool with the world. Automatic discovery, quality scoring, and AI agent + integration. +

+
+ + {/* Quick Start */} +
+

Quick Start

+
+
    +
  1. Create a new NPM package
    2. +
  2. + Add{' '} + tpmjs-tool{' '} + to keywords +
    3. +
  3. + Add a tpmjs{' '} + field with metadata +
    4. +
  4. Publish to NPM
    5. +
  5. + Your tool appears on{' '} + + tpmjs.com + {' '} + within 15 minutes! +
    6. +
+
+
+ + {/* Step 1: Package.json Setup */} +
+

+ Step 1: Add Required Keyword +

+

+ Add the{' '} + tpmjs-tool{' '} + keyword to your package.json. This is required for automatic discovery. +

+ +
+ + {/* Step 2: Metadata Tiers */} +
+

Step 2: Add TPMJS Metadata

+

+ There are three tiers of metadata. Higher tiers get better visibility and quality + scores. +

+ + {/* Tier 1: Minimal */} +
+
+ + Tier 1: Minimal + + Required fields only +
+ +

+ Quality Score: 1x base multiplier +

+
+ + {/* Tier 2: Basic */} +
+
+ + Tier 2: Basic + + Add parameter & return info +
+ +

+ Quality Score: 2x base multiplier +

+
+ + {/* Tier 3: Rich */} +
+
+ + Tier 3: Rich + + Full documentation +
+ +

+ Quality Score: 4x base multiplier ๐Ÿš€ +

+
+
+ + {/* Categories */} +
+

Available Categories

+
+ {[ + { name: 'text-analysis', desc: 'NLP, sentiment, summarization' }, + { name: 'code-generation', desc: 'Code generation and transformation' }, + { name: 'data-processing', desc: 'Data manipulation and transformation' }, + { name: 'image-generation', desc: 'Image creation and editing' }, + { name: 'audio-processing', desc: 'Audio/speech processing' }, + { name: 'search', desc: 'Search and retrieval' }, + { name: 'integration', desc: 'Third-party integrations' }, + { name: 'other', desc: 'Anything else' }, + ].map((cat) => ( +
+ {cat.name} +

{cat.desc}

+
+ ))} +
+
+ + {/* Step 3: Publish */} +
+

Step 3: Publish to NPM

+

+ Build your package and publish it to NPM. Your tool will be automatically discovered + within 15 minutes. +

+ +
+ + {/* Quality Score */} +
+

Quality Score

+

+ Your tool gets a quality score based on three factors: +

+
+
+

Tier

+
    +
  • Rich: 4x multiplier
    • +
  • Basic: 2x multiplier
    • +
  • Minimal: 1x multiplier
    • +
+
+
+

Downloads

+

+ Logarithmic scale based on monthly NPM downloads +

+
+
+

GitHub Stars

+

+ Logarithmic scale based on repository stars +

+
+
+
+ + {/* Real Example */} +
+

Real Example

+

+ Here is a complete example from{' '} + + @tpmjs/createblogpost + + : +

+ +
+ + {/* Tips */} +
+

Tips for Success

+
+ {[ + { + icon: '๐Ÿ“', + title: 'Use descriptive names', + desc: 'Make your package name clear and searchable', + }, + { + icon: '๐Ÿ“Š', + title: 'Complete metadata', + desc: 'Rich tier tools get 4x better visibility', + }, + { + icon: '๐Ÿ“š', + title: 'Good documentation', + desc: 'Link to docs in the links.documentation field', + }, + { + icon: '๐Ÿ”„', + title: 'Active maintenance', + desc: 'Regular updates boost download counts', + }, + { + icon: '๐Ÿค–', + title: 'AI-friendly descriptions', + desc: 'Write aiAgent.useCase as guidance for AI agents', + }, + ].map((tip) => ( +
+
{tip.icon}
+
+

{tip.title}

+

{tip.desc}

+
+
+ ))} +
+
+ + {/* CTA */} +
+

Ready to Publish?

+

+ Follow the steps above and your tool will be live on TPMJS within 15 minutes. +

+
+ + + + + + +
+
+ +
+ + {/* Footer */} + +
+ ); +} From f9ba1c094ee8a87802405969f8da56ce6d4e29fd Mon Sep 17 00:00:00 2001 From: Ajax Davis Date: Sat, 29 Nov 2025 22:41:50 +1000 Subject: [PATCH 003/106] feat: add README rendering and enhanced package metadata display MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit **Database Schema:** - Add npmReadme, npmKeywords, npmAuthor, npmMaintainers fields to Tool model **NPM Client:** - Add fetchLatestPackageWithMetadata() function to fetch README and top-level metadata - Export new PackageVersionWithReadme type **Sync Workers:** - Update keyword and changes sync to fetch and store README content - Store author, maintainers, and keywords from package.json **UI Components:** - Create Markdown component using react-markdown with GitHub Flavored Markdown - Add rehype-sanitize for security and remark-gfm for tables/strikethrough support **Tool Detail Page:** - Convert from createElement to JSX for better maintainability - Display README in a dedicated card with proper markdown rendering - Show NPM keywords, author, and maintainers in sidebar - Add ThemeToggle to header - Improve layout with better spacing and organization This brings the tool detail pages much closer to NPM's package pages, providing users with comprehensive information about each tool including the full README documentation. ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- apps/web/package.json | 4 + apps/web/src/app/api/sync/changes/route.ts | 10 +- apps/web/src/app/api/sync/keyword/route.ts | 10 +- apps/web/src/app/tool/[slug]/page.tsx | 986 +++++++++---------- apps/web/src/components/Markdown.tsx | 85 ++ packages/db/prisma/schema.prisma | 4 + packages/npm-client/src/index.ts | 2 + packages/npm-client/src/package.ts | 42 + pnpm-lock.yaml | 1000 ++++++++++++++++++++ 9 files changed, 1583 insertions(+), 560 deletions(-) create mode 100644 apps/web/src/components/Markdown.tsx diff --git a/apps/web/package.json b/apps/web/package.json index 44caf7b..72ec1b3 100644 --- a/apps/web/package.json +++ b/apps/web/package.json @@ -21,6 +21,10 @@ "next-themes": "^0.4.6", "react": "^19.0.0", "react-dom": "^19.0.0", + "react-markdown": "^10.1.0", + "rehype-raw": "^7.0.0", + "rehype-sanitize": "^6.0.0", + "remark-gfm": "^4.0.1", "zod": "^3.24.1" }, "devDependencies": { diff --git a/apps/web/src/app/api/sync/changes/route.ts b/apps/web/src/app/api/sync/changes/route.ts index 77b04c0..2889b9b 100644 --- a/apps/web/src/app/api/sync/changes/route.ts +++ b/apps/web/src/app/api/sync/changes/route.ts @@ -1,5 +1,5 @@ import { prisma } from '@tpmjs/db'; -import { fetchChanges, fetchLatestPackageVersion } from '@tpmjs/npm-client'; +import { fetchChanges, fetchLatestPackageWithMetadata } from '@tpmjs/npm-client'; import { validateTpmjsField } from '@tpmjs/types/tpmjs'; import { type NextRequest, NextResponse } from 'next/server'; import { env } from '~/env'; @@ -51,8 +51,8 @@ export async function POST(request: NextRequest) { // Process each change for (const change of changesResult.results) { try { - // Fetch full package metadata - const pkg = await fetchLatestPackageVersion(change.id); + // Fetch full package metadata with README + const pkg = await fetchLatestPackageWithMetadata(change.id); // Skip if package not found if (!pkg) { @@ -100,6 +100,10 @@ export async function POST(request: NextRequest) { npmRepository: pkg.repository ?? undefined, npmHomepage: pkg.homepage ?? undefined, npmLicense: pkg.license ?? undefined, + npmKeywords: pkg.topLevelKeywords || pkg.keywords || [], + npmReadme: pkg.readme ?? undefined, + npmAuthor: pkg.author ?? undefined, + npmMaintainers: pkg.maintainers ?? undefined, category: tpmjsData.category, description: tpmjsData.description, example: tpmjsData.example, diff --git a/apps/web/src/app/api/sync/keyword/route.ts b/apps/web/src/app/api/sync/keyword/route.ts index 55f50a5..09a64b7 100644 --- a/apps/web/src/app/api/sync/keyword/route.ts +++ b/apps/web/src/app/api/sync/keyword/route.ts @@ -1,5 +1,5 @@ import { prisma } from '@tpmjs/db'; -import { fetchLatestPackageVersion, searchByKeyword } from '@tpmjs/npm-client'; +import { fetchLatestPackageWithMetadata, searchByKeyword } from '@tpmjs/npm-client'; import { validateTpmjsField } from '@tpmjs/types/tpmjs'; import { type NextRequest, NextResponse } from 'next/server'; import { env } from '~/env'; @@ -41,8 +41,8 @@ export async function POST(request: NextRequest) { // Process each package for (const result of searchResults) { try { - // Fetch full package metadata - const pkg = await fetchLatestPackageVersion(result.package.name); + // Fetch full package metadata with README + const pkg = await fetchLatestPackageWithMetadata(result.package.name); // Skip if package not found if (!pkg) { @@ -90,6 +90,10 @@ export async function POST(request: NextRequest) { npmRepository: pkg.repository ?? undefined, npmHomepage: pkg.homepage ?? undefined, npmLicense: pkg.license ?? undefined, + npmKeywords: pkg.topLevelKeywords || pkg.keywords || [], + npmReadme: pkg.readme ?? undefined, + npmAuthor: pkg.author ?? undefined, + npmMaintainers: pkg.maintainers ?? undefined, category: tpmjsData.category, description: tpmjsData.description, example: tpmjsData.example, diff --git a/apps/web/src/app/tool/[slug]/page.tsx b/apps/web/src/app/tool/[slug]/page.tsx index 4ee21ca..9a8a9f2 100644 --- a/apps/web/src/app/tool/[slug]/page.tsx +++ b/apps/web/src/app/tool/[slug]/page.tsx @@ -9,7 +9,9 @@ import { Header } from '@tpmjs/ui/Header/Header'; import { Icon } from '@tpmjs/ui/Icon/Icon'; import { ProgressBar } from '@tpmjs/ui/ProgressBar/ProgressBar'; import Link from 'next/link'; -import { createElement, useEffect, useState } from 'react'; +import { useEffect, useState } from 'react'; +import { Markdown } from '../../../components/Markdown'; +import { ThemeToggle } from '../../../components/ThemeToggle'; interface Tool { id: string; @@ -23,6 +25,10 @@ interface Tool { isOfficial: boolean; npmDownloadsLastMonth: number; npmDownloadsLastWeek: number; + npmKeywords: string[]; + npmReadme: string | null; + npmAuthor: { name: string; email?: string; url?: string } | string | null; + npmMaintainers: Array<{ name: string; email?: string }> | null; tpmjsMetadata: { example?: string; parameters?: Array<{ @@ -57,11 +63,11 @@ interface Tool { } | null; githubStars: number | null; npmLicense: string | null; - npmKeywords: string[]; createdAt: string; updatedAt: string; } +// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Complex UI component with many conditional renders export default function ToolDetailPage({ params, }: { @@ -102,575 +108,447 @@ export default function ToolDetailPage({ }, [slug]); if (loading) { - return createElement('div', { className: 'min-h-screen bg-background' }, [ - createElement(Header, { - key: 'header', - title: createElement('div', { className: 'flex items-center gap-2' }, [ - createElement(Link, { key: 'link', href: '/', className: 'flex items-center gap-2' }, [ - createElement('span', { key: 'title', className: 'text-2xl font-bold' }, 'TPMJS'), - createElement(Badge, { key: 'badge', variant: 'outline', size: 'sm' }, 'Beta'), - ]), - ]), - sticky: true, - size: 'md', - }), - createElement( - Container, - { key: 'container', size: 'xl', padding: 'md', className: 'py-12' }, - createElement( - 'div', - { className: 'text-center text-foreground-secondary' }, - 'Loading tool...' - ) - ), - ]); + return ( +
+
+ TPMJS + + } + actions={} + sticky={true} + size="md" + /> + +
Loading tool...
+ +
+ ); } if (error || !tool) { - return createElement('div', { className: 'min-h-screen bg-background' }, [ - createElement(Header, { - key: 'header', - title: createElement('div', { className: 'flex items-center gap-2' }, [ - createElement(Link, { key: 'link', href: '/', className: 'flex items-center gap-2' }, [ - createElement('span', { key: 'title', className: 'text-2xl font-bold' }, 'TPMJS'), - createElement(Badge, { key: 'badge', variant: 'outline', size: 'sm' }, 'Beta'), - ]), - ]), - sticky: true, - size: 'md', - }), - createElement( - Container, - { key: 'container', size: 'xl', padding: 'md', className: 'py-12' }, - createElement( - 'div', - { className: 'text-center' }, - createElement('p', { className: 'text-red-500 text-lg mb-4' }, error || 'Tool not found'), - createElement( - Link, - { href: '/tool/tool-search' }, - createElement(Button, { variant: 'default' }, 'Browse All Tools') - ) - ) - ), - ]); + return ( +
+
+ TPMJS + + } + actions={} + sticky={true} + size="md" + /> + +
+

{error || 'Tool not found'}

+ + + +
+ +
+ ); } - return createElement('div', { className: 'min-h-screen bg-background' }, [ - // Header - createElement(Header, { - key: 'header', - title: createElement('div', { className: 'flex items-center gap-2' }, [ - createElement(Link, { key: 'link', href: '/', className: 'flex items-center gap-2' }, [ - createElement('span', { key: 'title', className: 'text-2xl font-bold' }, 'TPMJS'), - createElement(Badge, { key: 'badge', variant: 'outline', size: 'sm' }, 'Beta'), - ]), - ]), - actions: createElement('div', { className: 'flex items-center gap-3' }, [ - createElement( - Link, - { key: 'browse', href: '/tool/tool-search' }, - createElement(Button, { variant: 'ghost', size: 'sm' }, 'Browse Tools') - ), - tool.npmRepository - ? createElement( - 'a', - { - key: 'github', - href: tool.npmRepository.url.replace('git+', '').replace('.git', ''), - target: '_blank', - rel: 'noopener noreferrer', - className: 'text-foreground-secondary hover:text-foreground transition-colors', - }, - createElement(Icon, { icon: 'github', size: 'md' }) - ) - : null, - ]), - sticky: true, - size: 'md', - }), + const authorName = typeof tool.npmAuthor === 'string' ? tool.npmAuthor : tool.npmAuthor?.name; - // Main content - createElement(Container, { key: 'container', size: 'xl', padding: 'md', className: 'py-8' }, [ - // Breadcrumb - createElement( - 'div', - { - key: 'breadcrumb', - className: 'flex items-center gap-2 text-sm text-foreground-secondary mb-6', - }, - [ - createElement( - Link, - { key: 'home', href: '/', className: 'hover:text-foreground' }, - 'Home' - ), - createElement('span', { key: 'sep1' }, '/'), - createElement( - Link, - { key: 'tools', href: '/tool/tool-search', className: 'hover:text-foreground' }, - 'Tools' - ), - createElement('span', { key: 'sep2' }, '/'), - createElement( - 'span', - { key: 'current', className: 'text-foreground' }, - tool.npmPackageName - ), - ] - ), + return ( +
+ {/* Header */} +
+ TPMJS + + } + actions={ +
+ + + + {tool.npmRepository && ( + + + + )} + +
+ } + sticky={true} + size="md" + /> - // Title section - createElement('div', { key: 'title-section', className: 'mb-8' }, [ - createElement( - 'div', - { key: 'title-row', className: 'flex items-start justify-between mb-4' }, - [ - createElement('div', { key: 'title-content' }, [ - createElement( - 'h1', - { key: 'title', className: 'text-4xl font-bold text-foreground mb-2' }, - tool.npmPackageName - ), - createElement( - 'p', - { key: 'description', className: 'text-lg text-foreground-secondary' }, - tool.description - ), - ]), - tool.isOfficial - ? createElement( - Badge, - { key: 'official', variant: 'default', size: 'lg' }, - 'Official' - ) - : null, - ] - ), - createElement('div', { key: 'badges', className: 'flex flex-wrap gap-2' }, [ - createElement(Badge, { key: 'category', variant: 'secondary' }, tool.category), - createElement(Badge, { key: 'version', variant: 'outline' }, `v${tool.npmVersion}`), - tool.npmLicense - ? createElement(Badge, { key: 'license', variant: 'outline' }, tool.npmLicense) - : null, - ]), - ]), + {/* Main content */} + + {/* Breadcrumb */} +
+ + Home + + / + + Tools + + / + {tool.npmPackageName} +
- // Main grid - createElement( - 'div', - { key: 'main-grid', className: 'grid grid-cols-1 lg:grid-cols-3 gap-6' }, - [ - // Left column - Main content - createElement('div', { key: 'left-col', className: 'lg:col-span-2 space-y-6' }, [ - // Installation - createElement(Card, { key: 'installation' }, [ - createElement(CardHeader, { key: 'header' }, [ - createElement(CardTitle, { key: 'title' }, 'Installation'), - createElement( - CardDescription, - { key: 'desc' }, - 'Install this tool using your preferred package manager' - ), - ]), - createElement(CardContent, { key: 'content', className: 'space-y-4' }, [ - createElement(CodeBlock, { - key: 'npm', - code: `npm install ${tool.npmPackageName}`, - language: 'bash', - showCopy: true, - }), - createElement(CodeBlock, { - key: 'yarn', - code: `yarn add ${tool.npmPackageName}`, - language: 'bash', - showCopy: true, - }), - createElement(CodeBlock, { - key: 'pnpm', - code: `pnpm add ${tool.npmPackageName}`, - language: 'bash', - showCopy: true, - }), - ]), - ]), + {/* Title section */} +
+
+
+

{tool.npmPackageName}

+

{tool.description}

+ {authorName && ( +

+ by {authorName} +

+ )} +
+ {tool.isOfficial && ( + + Official + + )} +
+
+ {tool.category} + v{tool.npmVersion} + {tool.npmLicense && {tool.npmLicense}} +
+
- // Usage Example - tool.tpmjsMetadata?.example - ? createElement(Card, { key: 'example' }, [ - createElement(CardHeader, { key: 'header' }, [ - createElement(CardTitle, { key: 'title' }, 'Usage Example'), - createElement(CardDescription, { key: 'desc' }, 'Quick start example'), - ]), - createElement( - CardContent, - { key: 'content' }, - createElement(CodeBlock, { - code: tool.tpmjsMetadata.example, - language: 'typescript', - showCopy: true, - }) - ), - ]) - : null, + {/* Main grid */} +
+ {/* Left column - Main content */} +
+ {/* Installation */} + + + Installation + + Install this tool using your preferred package manager + + + + + + + + - // AI Agent Information - tool.tpmjsMetadata?.aiAgent - ? createElement(Card, { key: 'ai-agent' }, [ - createElement(CardHeader, { key: 'header' }, [ - createElement(CardTitle, { key: 'title' }, 'AI Agent Integration'), - createElement( - CardDescription, - { key: 'desc' }, - 'How AI agents can use this tool' - ), - ]), - createElement(CardContent, { key: 'content', className: 'space-y-4' }, [ - tool.tpmjsMetadata.aiAgent.useCase - ? createElement('div', { key: 'usecase' }, [ - createElement( - 'h4', - { - key: 'title', - className: 'text-sm font-semibold text-foreground mb-2', - }, - 'Use Case' - ), - createElement( - 'p', - { key: 'text', className: 'text-sm text-foreground-secondary' }, - tool.tpmjsMetadata.aiAgent.useCase - ), - ]) - : null, - tool.tpmjsMetadata.aiAgent.limitations - ? createElement('div', { key: 'limitations' }, [ - createElement( - 'h4', - { - key: 'title', - className: 'text-sm font-semibold text-foreground mb-2', - }, - 'Limitations' - ), - createElement( - 'p', - { key: 'text', className: 'text-sm text-foreground-secondary' }, - tool.tpmjsMetadata.aiAgent.limitations - ), - ]) - : null, - tool.tpmjsMetadata.aiAgent.examples && - tool.tpmjsMetadata.aiAgent.examples.length > 0 - ? createElement('div', { key: 'examples' }, [ - createElement( - 'h4', - { - key: 'title', - className: 'text-sm font-semibold text-foreground mb-2', - }, - 'Examples' - ), - createElement( - 'ul', - { key: 'list', className: 'list-disc list-inside space-y-1' }, - tool.tpmjsMetadata.aiAgent.examples.map((example, i) => - createElement( - 'li', - { key: i, className: 'text-sm text-foreground-secondary' }, - example - ) - ) - ), - ]) - : null, - ]), - ]) - : null, + {/* README */} + {tool.npmReadme && ( + + + README + + + + + + )} - // Parameters - tool.tpmjsMetadata?.parameters && tool.tpmjsMetadata.parameters.length > 0 - ? createElement(Card, { key: 'parameters' }, [ - createElement(CardHeader, { key: 'header' }, [ - createElement(CardTitle, { key: 'title' }, 'Parameters'), - createElement( - CardDescription, - { key: 'desc' }, - 'Available configuration options' - ), - ]), - createElement( - CardContent, - { key: 'content' }, - createElement( - 'div', - { className: 'space-y-4' }, - tool.tpmjsMetadata.parameters.map((param) => - createElement( - 'div', - { - key: param.name, - className: 'border-b border-border pb-4 last:border-0', - }, - [ - createElement( - 'div', - { key: 'header', className: 'flex items-start justify-between mb-2' }, - [ - createElement( - 'code', - { key: 'name', className: 'text-sm font-mono text-foreground' }, - param.name - ), - param.required - ? createElement( - Badge, - { key: 'required', variant: 'error', size: 'sm' }, - 'Required' - ) - : createElement( - Badge, - { key: 'optional', variant: 'outline', size: 'sm' }, - 'Optional' - ), - ] - ), - createElement( - 'div', - { key: 'type', className: 'text-sm text-foreground-secondary mb-1' }, - [ - createElement( - 'span', - { key: 'label', className: 'font-semibold' }, - 'Type: ' - ), - createElement( - 'code', - { key: 'value', className: 'font-mono' }, - param.type - ), - ] - ), - createElement( - 'p', - { key: 'desc', className: 'text-sm text-foreground-secondary' }, - param.description - ), - param.default !== undefined - ? createElement( - 'div', - { - key: 'default', - className: 'text-sm text-foreground-tertiary mt-1', - }, - [ - createElement( - 'span', - { key: 'label', className: 'font-semibold' }, - 'Default: ' - ), - createElement( - 'code', - { key: 'value', className: 'font-mono' }, - JSON.stringify(param.default) - ), - ] - ) - : null, - ] - ) - ) - ) - ), - ]) - : null, - ]), + {/* Usage Example */} + {tool.tpmjsMetadata?.example && ( + + + Usage Example + Quick start example + + + + + + )} - // Right column - Sidebar - createElement('div', { key: 'right-col', className: 'space-y-6' }, [ - // Stats - createElement(Card, { key: 'stats' }, [ - createElement( - CardHeader, - { key: 'header' }, - createElement(CardTitle, { key: 'title' }, 'Statistics') - ), - createElement(CardContent, { key: 'content', className: 'space-y-4' }, [ - createElement('div', { key: 'downloads' }, [ - createElement( - 'p', - { key: 'label', className: 'text-sm text-foreground-secondary mb-1' }, - 'Downloads/month' - ), - createElement( - 'p', - { key: 'value', className: 'text-2xl font-bold text-foreground' }, - tool.npmDownloadsLastMonth.toLocaleString() - ), - ]), - tool.githubStars !== null - ? createElement('div', { key: 'stars' }, [ - createElement( - 'p', - { key: 'label', className: 'text-sm text-foreground-secondary mb-1' }, - 'GitHub Stars' - ), - createElement( - 'p', - { key: 'value', className: 'text-2xl font-bold text-foreground' }, - tool.githubStars.toLocaleString() - ), - ]) - : null, - createElement('div', { key: 'quality' }, [ - createElement( - 'p', - { key: 'label', className: 'text-sm text-foreground-secondary mb-2' }, - 'Quality Score' - ), - createElement(ProgressBar, { - key: 'bar', - value: Number.parseFloat(tool.qualityScore) * 100, - variant: + {/* AI Agent Information */} + {tool.tpmjsMetadata?.aiAgent && ( + + + AI Agent Integration + How AI agents can use this tool + + + {tool.tpmjsMetadata.aiAgent.useCase && ( +
+

Use Case

+

+ {tool.tpmjsMetadata.aiAgent.useCase} +

+
+ )} + {tool.tpmjsMetadata.aiAgent.limitations && ( +
+

Limitations

+

+ {tool.tpmjsMetadata.aiAgent.limitations} +

+
+ )} + {tool.tpmjsMetadata.aiAgent.examples && + tool.tpmjsMetadata.aiAgent.examples.length > 0 && ( +
+

Examples

+
    + {tool.tpmjsMetadata.aiAgent.examples.map((example) => ( +
  • + {example} +
    • + ))} +
+
+ )} + + + )} + + {/* Parameters */} + {tool.tpmjsMetadata?.parameters && tool.tpmjsMetadata.parameters.length > 0 && ( + + + Parameters + Available configuration options + + +
+ {tool.tpmjsMetadata.parameters.map((param) => ( +
+
+ {param.name} + {param.required ? ( + + Required + + ) : ( + + Optional + + )} +
+
+ Type: + {param.type} +
+

{param.description}

+ {param.default !== undefined && ( +
+ Default: + {JSON.stringify(param.default)} +
+ )} +
+ ))} +
+ + + )} +
+ + {/* Right column - Sidebar */} +
+ {/* Stats */} + + + Statistics + + +
+

Downloads/month

+

+ {tool.npmDownloadsLastMonth.toLocaleString()} +

+
+ {tool.githubStars !== null && ( +
+

GitHub Stars

+

+ {tool.githubStars.toLocaleString()} +

+
+ )} +
+

Quality Score

+ = 0.7 ? 'success' : Number.parseFloat(tool.qualityScore) >= 0.5 ? 'primary' - : 'warning', - size: 'md', - showLabel: true, - }), - ]), - ]), - ]), + : 'warning' + } + size="md" + showLabel={true} + /> +
+ + - // Tags - tool.tags.length > 0 - ? createElement(Card, { key: 'tags' }, [ - createElement( - CardHeader, - { key: 'header' }, - createElement(CardTitle, { key: 'title' }, 'Tags') - ), - createElement( - CardContent, - { key: 'content' }, - createElement( - 'div', - { className: 'flex flex-wrap gap-2' }, - tool.tags.map((tag) => - createElement(Badge, { key: tag, variant: 'outline', size: 'sm' }, tag) - ) - ) - ), - ]) - : null, + {/* NPM Keywords */} + {tool.npmKeywords.length > 0 && ( + + + NPM Keywords + + +
+ {tool.npmKeywords.map((keyword) => ( + + {keyword} + + ))} +
+ + + )} - // Links - createElement(Card, { key: 'links' }, [ - createElement( - CardHeader, - { key: 'header' }, - createElement(CardTitle, { key: 'title' }, 'Links') - ), - createElement(CardContent, { key: 'content', className: 'space-y-2' }, [ - createElement( - 'a', - { - key: 'npm', - href: `https://www.npmjs.com/package/${tool.npmPackageName}`, - target: '_blank', - rel: 'noopener noreferrer', - className: - 'flex items-center gap-2 text-sm text-foreground-secondary hover:text-foreground', - }, - [ - createElement(Icon, { key: 'icon', icon: 'externalLink', size: 'sm' }), - createElement('span', { key: 'text' }, 'View on NPM'), - ] - ), - tool.tpmjsMetadata?.links?.documentation - ? createElement( - 'a', - { - key: 'docs', - href: tool.tpmjsMetadata.links.documentation, - target: '_blank', - rel: 'noopener noreferrer', - className: - 'flex items-center gap-2 text-sm text-foreground-secondary hover:text-foreground', - }, - [ - createElement(Icon, { key: 'icon', icon: 'externalLink', size: 'sm' }), - createElement('span', { key: 'text' }, 'Documentation'), - ] - ) - : null, - tool.tpmjsMetadata?.links?.repository - ? createElement( - 'a', - { - key: 'repo', - href: tool.tpmjsMetadata.links.repository, - target: '_blank', - rel: 'noopener noreferrer', - className: - 'flex items-center gap-2 text-sm text-foreground-secondary hover:text-foreground', - }, - [ - createElement(Icon, { key: 'icon', icon: 'github', size: 'sm' }), - createElement('span', { key: 'text' }, 'Repository'), - ] - ) - : null, - tool.tpmjsMetadata?.links?.homepage - ? createElement( - 'a', - { - key: 'home', - href: tool.tpmjsMetadata.links.homepage, - target: '_blank', - rel: 'noopener noreferrer', - className: - 'flex items-center gap-2 text-sm text-foreground-secondary hover:text-foreground', - }, - [ - createElement(Icon, { key: 'icon', icon: 'externalLink', size: 'sm' }), - createElement('span', { key: 'text' }, 'Homepage'), - ] - ) - : null, - ]), - ]), + {/* Tags */} + {tool.tags.length > 0 && ( + + + Tags + + +
+ {tool.tags.map((tag) => ( + + {tag} + + ))} +
+ + + )} - // Frameworks - tool.tpmjsMetadata?.frameworks && tool.tpmjsMetadata.frameworks.length > 0 - ? createElement(Card, { key: 'frameworks' }, [ - createElement( - CardHeader, - { key: 'header' }, - createElement(CardTitle, { key: 'title' }, 'Frameworks') - ), - createElement( - CardContent, - { key: 'content' }, - createElement( - 'div', - { className: 'flex flex-wrap gap-2' }, - tool.tpmjsMetadata.frameworks.map((framework) => - createElement( - Badge, - { key: framework, variant: 'secondary', size: 'sm' }, - framework - ) - ) - ) - ), - ]) - : null, - ]), - ] - ), - ]), - ]); + {/* Maintainers */} + {tool.npmMaintainers && tool.npmMaintainers.length > 0 && ( + + + Maintainers + + +
+ {tool.npmMaintainers.map((maintainer) => ( +
+ {maintainer.name} + {maintainer.email && ( + + ({maintainer.email}) + + )} +
+ ))} +
+ + + )} + + {/* Links */} + + + Links + + + + + View on NPM + + {tool.tpmjsMetadata?.links?.documentation && ( + + + Documentation + + )} + {tool.tpmjsMetadata?.links?.repository && ( + + + Repository + + )} + {tool.tpmjsMetadata?.links?.homepage && ( + + + Homepage + + )} + + + + {/* Frameworks */} + {tool.tpmjsMetadata?.frameworks && tool.tpmjsMetadata.frameworks.length > 0 && ( + + + Frameworks + + +
+ {tool.tpmjsMetadata.frameworks.map((framework) => ( + + {framework} + + ))} +
+ + + )} +
+
+ +
+ ); } diff --git a/apps/web/src/components/Markdown.tsx b/apps/web/src/components/Markdown.tsx new file mode 100644 index 0000000..8f6f1e0 --- /dev/null +++ b/apps/web/src/components/Markdown.tsx @@ -0,0 +1,85 @@ +'use client'; + +import ReactMarkdown from 'react-markdown'; +import rehypeRaw from 'rehype-raw'; +import rehypeSanitize from 'rehype-sanitize'; +import remarkGfm from 'remark-gfm'; + +interface MarkdownProps { + content: string; + className?: string; +} + +/** + * Markdown renderer component + * Safely renders markdown content with GitHub Flavored Markdown support + */ +export function Markdown({ content, className = '' }: MarkdownProps): React.ReactElement { + return ( +
+ { + const isInline = !className; + if (isInline) { + return ( + + {children} + + ); + } + return ( + + {children} + + ); + }, + // Make links open in new tab + a: ({ href, children, ...props }) => { + const isExternal = href?.startsWith('http'); + return ( + + {children} + + ); + }, + }} + > + {content} + +
+ ); +} diff --git a/packages/db/prisma/schema.prisma b/packages/db/prisma/schema.prisma index 60233b2..c98322c 100644 --- a/packages/db/prisma/schema.prisma +++ b/packages/db/prisma/schema.prisma @@ -22,6 +22,10 @@ model Tool { npmRepository Json? @map("npm_repository") @db.JsonB npmHomepage String? @map("npm_homepage") @db.Text npmLicense String? @map("npm_license") @db.VarChar(50) + npmKeywords String[] @default([]) @map("npm_keywords") @db.Text + npmReadme String? @map("npm_readme") @db.Text + npmAuthor Json? @map("npm_author") @db.JsonB + npmMaintainers Json? @map("npm_maintainers") @db.JsonB // TPMJS Metadata (from package.json tpmjs field) category String @db.VarChar(50) diff --git a/packages/npm-client/src/index.ts b/packages/npm-client/src/index.ts index 0e74a9c..a6fed3e 100644 --- a/packages/npm-client/src/index.ts +++ b/packages/npm-client/src/index.ts @@ -26,9 +26,11 @@ export { export { fetchPackageMetadata, fetchLatestPackageVersion, + fetchLatestPackageWithMetadata, fetchPackageTpmjsField, type PackageVersion, type PackageMetadata, + type PackageVersionWithReadme, } from './package'; // Download statistics diff --git a/packages/npm-client/src/package.ts b/packages/npm-client/src/package.ts index 338bb32..90761c2 100644 --- a/packages/npm-client/src/package.ts +++ b/packages/npm-client/src/package.ts @@ -160,6 +160,48 @@ export async function fetchLatestPackageVersion( }; } +export type PackageVersionWithReadme = PackageVersion & { + readme?: string; + topLevelKeywords?: string[]; + topLevelDescription?: string; +}; + +/** + * Gets the latest version of a package with additional top-level metadata + * @param packageName - The name of the package + * @returns The latest package version with README and top-level metadata, or null if not found + */ +export async function fetchLatestPackageWithMetadata( + packageName: string +): Promise { + const metadata = await fetchPackageMetadata(packageName); + + if (!metadata) { + return null; + } + + const latestTag = metadata['dist-tags'].latest; + if (!latestTag) { + return null; + } + + const version = metadata.versions[latestTag]; + if (!version) { + return null; + } + + // Add publishedAt from metadata.time + const publishedAt = metadata.time?.[latestTag]; + + return { + ...version, + publishedAt, + readme: metadata.readme, + topLevelKeywords: metadata.keywords, + topLevelDescription: metadata.description, + }; +} + /** * Checks if a package has a tpmjs field in its latest version * @param packageName - The name of the package diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index b7915e3..0b7e802 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -71,6 +71,18 @@ importers: react-dom: specifier: ^19.0.0 version: 19.2.0(react@19.2.0) + react-markdown: + specifier: ^10.1.0 + version: 10.1.0(@types/react@19.2.7)(react@19.2.0) + rehype-raw: + specifier: ^7.0.0 + version: 7.0.0 + rehype-sanitize: + specifier: ^6.0.0 + version: 6.0.0 + remark-gfm: + specifier: ^4.0.1 + version: 4.0.1 zod: specifier: ^3.24.1 version: 3.25.76 @@ -1902,21 +1914,36 @@ packages: '@types/babel__traverse@7.28.0': resolution: {integrity: sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==} + '@types/debug@4.1.12': + resolution: {integrity: sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ==} + '@types/doctrine@0.0.9': resolution: {integrity: sha512-eOIHzCUSH7SMfonMG1LsC2f8vxBFtho6NGBznK41R84YzPuvSBzrhEps33IsQiOW9+VL6NQ9DbjQJznk/S4uRA==} + '@types/estree-jsx@1.0.5': + resolution: {integrity: sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==} + '@types/estree@1.0.8': resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==} + '@types/hast@3.0.4': + resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==} + '@types/json-schema@7.0.15': resolution: {integrity: sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==} '@types/json5@0.0.29': resolution: {integrity: sha512-dRLjCWHYg4oaA77cxO64oO+7JwCwnIzkZPdrrC71jQmQtlhM556pwKo5bUzqvZndkVbeFLIIi+9TC40JNF5hNQ==} + '@types/mdast@4.0.4': + resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==} + '@types/mdx@2.0.13': resolution: {integrity: sha512-+OWZQfAYyio6YkJb3HLxDrvnx6SWWDbC0zVPfBRzUk0/nqoDyf6dNxQi3eArPe8rJ473nobTMQ/8Zk+LxJ+Yuw==} + '@types/ms@2.1.0': + resolution: {integrity: sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==} + '@types/node@12.20.55': resolution: {integrity: sha512-J8xLz7q2OFulZ2cyGTLE1TbbZcjpno7FaN6zdJNrgAdrJ+DZzh/uFR6YrTb4C+nXakvud8Q4+rbhoIWlYQbUFQ==} @@ -1937,6 +1964,12 @@ packages: '@types/statuses@2.0.6': resolution: {integrity: sha512-xMAgYwceFhRA2zY+XbEA7mxYbA093wdiW8Vu6gZPGWy9cmOyU9XesH1tNcEWsKFd5Vzrqx5T3D38PWx1FIIXkA==} + '@types/unist@2.0.11': + resolution: {integrity: sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==} + + '@types/unist@3.0.3': + resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==} + '@types/uuid@9.0.8': resolution: {integrity: sha512-jg+97EGIcY9AGHJJRaaPVgetKDsrTgbRjQ5Msgjh/DQKEFl0DtyRr/VCOyD1T2R1MNeWPK/u7JoGhlDZnKBAfA==} @@ -1999,6 +2032,9 @@ packages: resolution: {integrity: sha512-T0XJMaRPOH3+LBbAfzR2jalckP1MSG/L9eUtY0DEzUyVaXJ/t6zN0nR7co5kz0Jko/nkSYCBRkz1djvjajVTTg==} engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + '@ungap/structured-clone@1.3.0': + resolution: {integrity: sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==} + '@unrs/resolver-binding-android-arm-eabi@1.11.1': resolution: {integrity: sha512-ppLRUgHVaGRWUx0R0Ut06Mjo9gBaBkg3v/8AxusGLhsIotbBLuRk51rAzqLC8gq6NyyAojEXglNjzf6R948DNw==} cpu: [arm] @@ -2279,6 +2315,9 @@ packages: resolution: {integrity: sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==} engines: {node: '>= 0.4'} + bail@2.0.2: + resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==} + balanced-match@1.0.2: resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==} @@ -2357,6 +2396,9 @@ packages: caniuse-lite@1.0.30001757: resolution: {integrity: sha512-r0nnL/I28Zi/yjk1el6ilj27tKcdjLsNqAOZr0yVjWPrSQyHgKI2INaEWw21bAQSv2LXRt1XuCS/GomNpWOxsQ==} + ccount@2.0.1: + resolution: {integrity: sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==} + chai@5.3.3: resolution: {integrity: sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==} engines: {node: '>=18'} @@ -2369,6 +2411,18 @@ packages: resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==} engines: {node: '>=10'} + character-entities-html4@2.1.0: + resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==} + + character-entities-legacy@3.0.0: + resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==} + + character-entities@2.0.2: + resolution: {integrity: sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==} + + character-reference-invalid@2.0.1: + resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==} + chardet@2.1.1: resolution: {integrity: sha512-PsezH1rqdV9VvyNhxxOW32/d75r01NY7TQCmOqomRo15ZSOKbpTFVsfjghxo6JloQUCGnH4k1LGu0R4yCLlWQQ==} @@ -2413,6 +2467,9 @@ packages: color-name@1.1.4: resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==} + comma-separated-tokens@2.0.3: + resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==} + commander@14.0.2: resolution: {integrity: sha512-TywoWNNRbhoD0BXs1P3ZEScW8W5iKrnbithIl0YH+uCmBd0QpPOA8yc82DS3BIE5Ma6FnBVUsJ7wVUDz4dvOWQ==} engines: {node: '>=20'} @@ -2488,6 +2545,9 @@ packages: supports-color: optional: true + decode-named-character-reference@1.2.0: + resolution: {integrity: sha512-c6fcElNV6ShtZXmsgNgFFV5tVX2PaV4g+MOAkb8eXHvn6sryJBrZa9r0zV6+dtTyoCKxtDy5tyQ5ZwQuidtd+Q==} + deep-eql@5.0.2: resolution: {integrity: sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==} engines: {node: '>=6'} @@ -2534,6 +2594,9 @@ packages: resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==} engines: {node: '>=8'} + devlop@1.1.0: + resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==} + didyoumean@1.2.2: resolution: {integrity: sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==} @@ -2597,6 +2660,10 @@ packages: resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==} engines: {node: '>=0.12'} + entities@6.0.1: + resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==} + engines: {node: '>=0.12'} + es-abstract@1.24.0: resolution: {integrity: sha512-WSzPgsdLtTcQwm4CROfS5ju2Wa1QQcVeT37jFjYzdFz1r9ahadC8B8/a4qxJxM+09F18iumCdRmlr96ZYkQvEg==} engines: {node: '>= 0.4'} @@ -2660,6 +2727,10 @@ packages: resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==} engines: {node: '>=10'} + escape-string-regexp@5.0.0: + resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==} + engines: {node: '>=12'} + eslint-config-next@16.0.4: resolution: {integrity: sha512-FknAsm/uexYriO6UXzV2QEm4Yz/5DVQCtMUHx0FRYAKqqf5ia8xPqdyoqXzoCc45nRF5brkFpBYMvtciavzD4g==} peerDependencies: @@ -2783,6 +2854,9 @@ packages: resolution: {integrity: sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==} engines: {node: '>=4.0'} + estree-util-is-identifier-name@3.0.0: + resolution: {integrity: sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==} + estree-walker@2.0.2: resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==} @@ -2800,6 +2874,9 @@ packages: exsolve@1.0.8: resolution: {integrity: sha512-LmDxfWXwcTArk8fUEnOfSZpHOJ6zOMUJKOtFLFqJLoKJetuQG874Uc7/Kki7zFLzYybmZhp1M7+98pfMqeX8yA==} + extend@3.0.2: + resolution: {integrity: sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==} + extendable-error@0.1.7: resolution: {integrity: sha512-UOiS2in6/Q0FK0R0q6UY9vYpQ21mr/Qn1KOnte7vsACuNJf514WvCCUHSRCPcgjPT2bAhNIJdlE6bVap1GKmeg==} @@ -3019,6 +3096,30 @@ packages: resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==} engines: {node: '>= 0.4'} + hast-util-from-parse5@8.0.3: + resolution: {integrity: sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==} + + hast-util-parse-selector@4.0.0: + resolution: {integrity: sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==} + + hast-util-raw@9.1.0: + resolution: {integrity: sha512-Y8/SBAHkZGoNkpzqqfCldijcuUKh7/su31kEBp67cFY09Wy0mTRgtsLYsiIxMJxlu0f6AA5SUTbDR8K0rxnbUw==} + + hast-util-sanitize@5.0.2: + resolution: {integrity: sha512-3yTWghByc50aGS7JlGhk61SPenfE/p1oaFeNwkOOyrscaOkMGrcW9+Cy/QAIOBpZxP1yqDIzFMR0+Np0i0+usg==} + + hast-util-to-jsx-runtime@2.3.6: + resolution: {integrity: sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==} + + hast-util-to-parse5@8.0.0: + resolution: {integrity: sha512-3KKrV5ZVI8if87DVSi1vDeByYrkGzg4mEfeu4alwgmmIeARiBLKCZS2uw5Gb6nU9x9Yufyj3iudm6i7nl52PFw==} + + hast-util-whitespace@3.0.0: + resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==} + + hastscript@9.0.1: + resolution: {integrity: sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==} + headers-polyfill@4.0.3: resolution: {integrity: sha512-IScLbePpkvO846sIwOtOTDjutRMWdXdJmXdMvk6gCBHxFO8d+QKOQedyZSxFTTFYRSmlgSTDtXqqq4pcenBXLQ==} @@ -3028,6 +3129,12 @@ packages: hermes-parser@0.25.1: resolution: {integrity: sha512-6pEjquH3rqaI6cYAXYPcz9MS4rY6R4ngRgrgfDshRptUZIc3lw0MCIJIGDj9++mfySOuPTHB4nrSW99BCvOPIA==} + html-url-attributes@3.0.1: + resolution: {integrity: sha512-ol6UPyBWqsrO6EJySPz2O7ZSr856WDrEzM5zMqp+FJJLGMW35cLYmmZnl0vztAZxRUoNZJFTCohfjuIJ8I4QBQ==} + + html-void-elements@3.0.0: + resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==} + human-id@4.1.2: resolution: {integrity: sha512-v/J+4Z/1eIJovEBdlV5TYj1IR+ZiohcYGRY+qN/oC9dAfKzVT023N/Bgw37hrKCoVRBvk3bqyzpr2PP5YeTMSg==} hasBin: true @@ -3063,6 +3170,9 @@ packages: resolution: {integrity: sha512-QQnnxNyfvmHFIsj7gkPcYymR8Jdw/o7mp5ZFihxn6h8Ci6fh3Dx4E1gPjpQEpIuPo9XVNY/ZUwh4BPMjGyL01g==} engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0} + inline-style-parser@0.2.7: + resolution: {integrity: sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==} + internal-slot@1.1.0: resolution: {integrity: sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==} engines: {node: '>= 0.4'} @@ -3071,6 +3181,12 @@ packages: resolution: {integrity: sha512-6xwYfHbajpoF0xLW+iwLkhwgvLoZDfjYfoFNu8ftMoXINzwuymNLd9u/KmwtdT2GbR+/Cz66otEGEVVUHX9QLQ==} engines: {node: '>=10.13.0'} + is-alphabetical@2.0.1: + resolution: {integrity: sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==} + + is-alphanumerical@2.0.1: + resolution: {integrity: sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==} + is-arguments@1.2.0: resolution: {integrity: sha512-7bVbi0huj/wrIAOzb8U1aszg9kdi3KN/CyU19CTI7tAoZYEZoL9yCDXpbXN+uPsuWnP02cyug1gleqq+TU+YCA==} engines: {node: '>= 0.4'} @@ -3114,6 +3230,9 @@ packages: resolution: {integrity: sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==} engines: {node: '>= 0.4'} + is-decimal@2.0.1: + resolution: {integrity: sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==} + is-docker@2.2.1: resolution: {integrity: sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==} engines: {node: '>=8'} @@ -3139,6 +3258,9 @@ packages: resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==} engines: {node: '>=0.10.0'} + is-hexadecimal@2.0.1: + resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==} + is-installed-globally@1.0.0: resolution: {integrity: sha512-K55T22lfpQ63N4KEN57jZUAaAYqYHEe8veb/TycJRk9DdSCLLcovXz/mL6mOnhQaZsQGwPhuFopdQIlqGSEjiQ==} engines: {node: '>=18'} @@ -3166,6 +3288,10 @@ packages: resolution: {integrity: sha512-lJJV/5dYS+RcL8uQdBDW9c9uWFLLBNRyFhnAKXw5tVqLlKZ4RMGZKv+YQ/IA3OhD+RpbJa1LLFM1FQPGyIXvOA==} engines: {node: '>=12'} + is-plain-obj@4.1.0: + resolution: {integrity: sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==} + engines: {node: '>=12'} + is-regex@1.2.1: resolution: {integrity: sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g==} engines: {node: '>= 0.4'} @@ -3395,6 +3521,9 @@ packages: lodash@4.17.21: resolution: {integrity: sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==} + longest-streak@3.1.0: + resolution: {integrity: sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==} + loose-envify@1.4.0: resolution: {integrity: sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==} hasBin: true @@ -3426,10 +3555,58 @@ packages: map-or-similar@1.5.0: resolution: {integrity: sha512-0aF7ZmVon1igznGI4VS30yugpduQW3y3GkcgGJOp7d8x8QrizhigUxjI/m2UojsXXto+jLAH3KSz+xOJTiORjg==} + markdown-table@3.0.4: + resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==} + math-intrinsics@1.1.0: resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==} engines: {node: '>= 0.4'} + mdast-util-find-and-replace@3.0.2: + resolution: {integrity: sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg==} + + mdast-util-from-markdown@2.0.2: + resolution: {integrity: sha512-uZhTV/8NBuw0WHkPTrCqDOl0zVe1BIng5ZtHoDk49ME1qqcjYmmLmOf0gELgcRMxN4w2iuIeVso5/6QymSrgmA==} + + mdast-util-gfm-autolink-literal@2.0.1: + resolution: {integrity: sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==} + + mdast-util-gfm-footnote@2.1.0: + resolution: {integrity: sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==} + + mdast-util-gfm-strikethrough@2.0.0: + resolution: {integrity: sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==} + + mdast-util-gfm-table@2.0.0: + resolution: {integrity: sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==} + + mdast-util-gfm-task-list-item@2.0.0: + resolution: {integrity: sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==} + + mdast-util-gfm@3.1.0: + resolution: {integrity: sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==} + + mdast-util-mdx-expression@2.0.1: + resolution: {integrity: sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==} + + mdast-util-mdx-jsx@3.2.0: + resolution: {integrity: sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==} + + mdast-util-mdxjs-esm@2.0.1: + resolution: {integrity: sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==} + + mdast-util-phrasing@4.1.0: + resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==} + + mdast-util-to-hast@13.2.1: + resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==} + + mdast-util-to-markdown@2.1.2: + resolution: {integrity: sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==} + + mdast-util-to-string@4.0.0: + resolution: {integrity: sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==} + memoize@10.2.0: resolution: {integrity: sha512-DeC6b7QBrZsRs3Y02A6A7lQyzFbsQbqgjI6UW0GigGWV+u1s25TycMr0XHZE4cJce7rY/vyw2ctMQqfDkIhUEA==} engines: {node: '>=18'} @@ -3441,6 +3618,90 @@ packages: resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==} engines: {node: '>= 8'} + micromark-core-commonmark@2.0.3: + resolution: {integrity: sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==} + + micromark-extension-gfm-autolink-literal@2.1.0: + resolution: {integrity: sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==} + + micromark-extension-gfm-footnote@2.1.0: + resolution: {integrity: sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==} + + micromark-extension-gfm-strikethrough@2.1.0: + resolution: {integrity: sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==} + + micromark-extension-gfm-table@2.1.1: + resolution: {integrity: sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==} + + micromark-extension-gfm-tagfilter@2.0.0: + resolution: {integrity: sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==} + + micromark-extension-gfm-task-list-item@2.1.0: + resolution: {integrity: sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==} + + micromark-extension-gfm@3.0.0: + resolution: {integrity: sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==} + + micromark-factory-destination@2.0.1: + resolution: {integrity: sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==} + + micromark-factory-label@2.0.1: + resolution: {integrity: sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==} + + micromark-factory-space@2.0.1: + resolution: {integrity: sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==} + + micromark-factory-title@2.0.1: + resolution: {integrity: sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==} + + micromark-factory-whitespace@2.0.1: + resolution: {integrity: sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==} + + micromark-util-character@2.1.1: + resolution: {integrity: sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==} + + micromark-util-chunked@2.0.1: + resolution: {integrity: sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==} + + micromark-util-classify-character@2.0.1: + resolution: {integrity: sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==} + + micromark-util-combine-extensions@2.0.1: + resolution: {integrity: sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==} + + micromark-util-decode-numeric-character-reference@2.0.2: + resolution: {integrity: sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==} + + micromark-util-decode-string@2.0.1: + resolution: {integrity: sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==} + + micromark-util-encode@2.0.1: + resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==} + + micromark-util-html-tag-name@2.0.1: + resolution: {integrity: sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==} + + micromark-util-normalize-identifier@2.0.1: + resolution: {integrity: sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==} + + micromark-util-resolve-all@2.0.1: + resolution: {integrity: sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==} + + micromark-util-sanitize-uri@2.0.1: + resolution: {integrity: sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==} + + micromark-util-subtokenize@2.1.0: + resolution: {integrity: sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==} + + micromark-util-symbol@2.0.1: + resolution: {integrity: sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==} + + micromark-util-types@2.0.2: + resolution: {integrity: sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==} + + micromark@4.0.2: + resolution: {integrity: sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==} + micromatch@4.0.8: resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==} engines: {node: '>=8.6'} @@ -3655,6 +3916,12 @@ packages: resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==} engines: {node: '>=6'} + parse-entities@4.0.2: + resolution: {integrity: sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==} + + parse5@7.3.0: + resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==} + path-exists@4.0.0: resolution: {integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==} engines: {node: '>=8'} @@ -3816,6 +4083,12 @@ packages: prop-types@15.8.1: resolution: {integrity: sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==} + property-information@6.5.0: + resolution: {integrity: sha512-PgTgs/BlvHxOu8QuEN7wi5A0OmXaBcHpmCSTehcs6Uuu9IkDIEo13Hy7n898RHfrQ49vKCoGeWZSaAK01nwVig==} + + property-information@7.1.0: + resolution: {integrity: sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ==} + punycode@2.3.1: resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==} engines: {node: '>=6'} @@ -3852,6 +4125,12 @@ packages: react-is@17.0.2: resolution: {integrity: sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==} + react-markdown@10.1.0: + resolution: {integrity: sha512-qKxVopLT/TyA6BX3Ue5NwabOsAzm0Q7kAPwq6L+wWDwisYs7R8vZ0nRXqq6rkueboxpkjvLGU9fWifiX/ZZFxQ==} + peerDependencies: + '@types/react': '>=18' + react: '>=18' + react@19.2.0: resolution: {integrity: sha512-tmbWg6W31tQLeB5cdIBOicJDJRR2KzXsV7uSK9iNfLWQ5bIZfxuPEHp7M8wiHyHnn0DD1i7w3Zmin0FtkrwoCQ==} engines: {node: '>=0.10.0'} @@ -3895,6 +4174,24 @@ packages: resolution: {integrity: sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==} engines: {node: '>= 0.4'} + rehype-raw@7.0.0: + resolution: {integrity: sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==} + + rehype-sanitize@6.0.0: + resolution: {integrity: sha512-CsnhKNsyI8Tub6L4sm5ZFsme4puGfc6pYylvXo1AeqaGbjOYyzNv3qZPwvs0oMJ39eryyeOdmxwUIo94IpEhqg==} + + remark-gfm@4.0.1: + resolution: {integrity: sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==} + + remark-parse@11.0.0: + resolution: {integrity: sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==} + + remark-rehype@11.1.2: + resolution: {integrity: sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==} + + remark-stringify@11.0.0: + resolution: {integrity: sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==} + require-directory@2.1.1: resolution: {integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==} engines: {node: '>=0.10.0'} @@ -4038,6 +4335,9 @@ packages: resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==} engines: {node: '>= 12'} + space-separated-tokens@2.0.2: + resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==} + spawndamnit@3.0.1: resolution: {integrity: sha512-MmnduQUuHCoFckZoWnXsTg7JaiLBJrKFj9UI2MbRPGaJeVpsLcVBu6P/IGZovziM/YBsellCmsprgNA+w0CzVg==} @@ -4104,6 +4404,9 @@ packages: resolution: {integrity: sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg==} engines: {node: '>= 0.4'} + stringify-entities@4.0.4: + resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==} + strip-ansi@6.0.1: resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==} engines: {node: '>=8'} @@ -4132,6 +4435,12 @@ packages: resolution: {integrity: sha512-1tB5mhVo7U+ETBKNf92xT4hrQa3pm0MZ0PQvuDnWgAAGHDsfp4lPSpiS6psrSiet87wyGPh9ft6wmhOMQ0hDiw==} engines: {node: '>=14.16'} + style-to-js@1.1.21: + resolution: {integrity: sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==} + + style-to-object@1.0.14: + resolution: {integrity: sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==} + styled-jsx@5.1.6: resolution: {integrity: sha512-qSVyDTeMotdvQYoHWLNGwRFJHC+i+ZvdBRYosOFgC+Wg1vx4frN2/RG/NA7SYqqvKNLf39P2LSRA2pu6n0XYZA==} engines: {node: '>= 12.0.0'} @@ -4233,6 +4542,12 @@ packages: resolution: {integrity: sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==} hasBin: true + trim-lines@3.0.1: + resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==} + + trough@2.2.0: + resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==} + ts-api-utils@2.1.0: resolution: {integrity: sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==} engines: {node: '>=18.12'} @@ -4382,6 +4697,24 @@ packages: undici-types@6.21.0: resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==} + unified@11.0.5: + resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==} + + unist-util-is@6.0.1: + resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==} + + unist-util-position@5.0.0: + resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==} + + unist-util-stringify-position@4.0.0: + resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==} + + unist-util-visit-parents@6.0.2: + resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==} + + unist-util-visit@5.0.0: + resolution: {integrity: sha512-MR04uvD+07cwl/yhVuVWAtw+3GOR/knlL55Nd/wAdblk27GCVt3lqpTivy/tkJcZoNPzTwS1Y+KMojlLDhoTzg==} + universalify@0.1.2: resolution: {integrity: sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==} engines: {node: '>= 4.0.0'} @@ -4415,6 +4748,15 @@ packages: resolution: {integrity: sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA==} hasBin: true + vfile-location@5.0.3: + resolution: {integrity: sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==} + + vfile-message@4.0.3: + resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==} + + vfile@6.0.3: + resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==} + vite-node@2.1.9: resolution: {integrity: sha512-AM9aQ/IPrW/6ENLQg3AGY4K1N2TGZdR5e4gu/MmmR2xR3Ll1+dib+nook92g4TV3PXVyeyxdWwtaCAiUL0hMxA==} engines: {node: ^18.0.0 || >=20.0.0} @@ -4525,6 +4867,9 @@ packages: engines: {node: ^20.12||^22.13||>=24.0} hasBin: true + web-namespaces@2.0.1: + resolution: {integrity: sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==} + webidl-conversions@7.0.0: resolution: {integrity: sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==} engines: {node: '>=12'} @@ -4625,6 +4970,9 @@ packages: zod@4.1.13: resolution: {integrity: sha512-AvvthqfqrAhNH9dnfmrfKzX5upOdjUVJYFqNSlkmGf64gRaTzlPwz99IHYnVs28qYAybvAlBV+H7pn0saFY4Ig==} + zwitch@2.0.4: + resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==} + snapshots: '@adobe/css-tools@4.4.4': {} @@ -5966,16 +6314,34 @@ snapshots: dependencies: '@babel/types': 7.28.5 + '@types/debug@4.1.12': + dependencies: + '@types/ms': 2.1.0 + '@types/doctrine@0.0.9': {} + '@types/estree-jsx@1.0.5': + dependencies: + '@types/estree': 1.0.8 + '@types/estree@1.0.8': {} + '@types/hast@3.0.4': + dependencies: + '@types/unist': 3.0.3 + '@types/json-schema@7.0.15': {} '@types/json5@0.0.29': {} + '@types/mdast@4.0.4': + dependencies: + '@types/unist': 3.0.3 + '@types/mdx@2.0.13': {} + '@types/ms@2.1.0': {} + '@types/node@12.20.55': {} '@types/node@22.19.1': @@ -5994,6 +6360,10 @@ snapshots: '@types/statuses@2.0.6': {} + '@types/unist@2.0.11': {} + + '@types/unist@3.0.3': {} + '@types/uuid@9.0.8': {} '@typescript-eslint/eslint-plugin@8.48.0(@typescript-eslint/parser@8.48.0(eslint@9.39.1(jiti@1.21.7))(typescript@5.9.3))(eslint@9.39.1(jiti@1.21.7))(typescript@5.9.3)': @@ -6140,6 +6510,8 @@ snapshots: '@typescript-eslint/types': 8.48.0 eslint-visitor-keys: 4.2.1 + '@ungap/structured-clone@1.3.0': {} + '@unrs/resolver-binding-android-arm-eabi@1.11.1': optional: true @@ -6424,6 +6796,8 @@ snapshots: axobject-query@4.1.0: {} + bail@2.0.2: {} + balanced-match@1.0.2: {} baseline-browser-mapping@2.8.31: {} @@ -6506,6 +6880,8 @@ snapshots: caniuse-lite@1.0.30001757: {} + ccount@2.0.1: {} + chai@5.3.3: dependencies: assertion-error: 2.0.1 @@ -6524,6 +6900,14 @@ snapshots: ansi-styles: 4.3.0 supports-color: 7.2.0 + character-entities-html4@2.1.0: {} + + character-entities-legacy@3.0.0: {} + + character-entities@2.0.2: {} + + character-reference-invalid@2.0.1: {} + chardet@2.1.1: {} check-error@2.1.1: {} @@ -6568,6 +6952,8 @@ snapshots: color-name@1.1.4: {} + comma-separated-tokens@2.0.3: {} + commander@14.0.2: {} commander@4.1.1: {} @@ -6624,6 +7010,10 @@ snapshots: dependencies: ms: 2.1.3 + decode-named-character-reference@1.2.0: + dependencies: + character-entities: 2.0.2 + deep-eql@5.0.2: {} deep-is@0.1.4: {} @@ -6678,6 +7068,10 @@ snapshots: detect-libc@2.1.2: optional: true + devlop@1.1.0: + dependencies: + dequal: 2.0.3 + didyoumean@1.2.2: {} dir-glob@3.0.1: @@ -6733,6 +7127,8 @@ snapshots: entities@4.5.0: {} + entities@6.0.1: {} + es-abstract@1.24.0: dependencies: array-buffer-byte-length: 1.0.2 @@ -6931,6 +7327,8 @@ snapshots: escape-string-regexp@4.0.0: {} + escape-string-regexp@5.0.0: {} + eslint-config-next@16.0.4(eslint@9.39.1(jiti@1.21.7))(typescript@5.9.3): dependencies: '@next/eslint-plugin-next': 16.0.4 @@ -7256,6 +7654,8 @@ snapshots: estraverse@5.3.0: {} + estree-util-is-identifier-name@3.0.0: {} + estree-walker@2.0.2: {} estree-walker@3.0.3: @@ -7268,6 +7668,8 @@ snapshots: exsolve@1.0.8: {} + extend@3.0.2: {} + extendable-error@0.1.7: {} fast-check@3.23.2: @@ -7508,6 +7910,85 @@ snapshots: dependencies: function-bind: 1.1.2 + hast-util-from-parse5@8.0.3: + dependencies: + '@types/hast': 3.0.4 + '@types/unist': 3.0.3 + devlop: 1.1.0 + hastscript: 9.0.1 + property-information: 7.1.0 + vfile: 6.0.3 + vfile-location: 5.0.3 + web-namespaces: 2.0.1 + + hast-util-parse-selector@4.0.0: + dependencies: + '@types/hast': 3.0.4 + + hast-util-raw@9.1.0: + dependencies: + '@types/hast': 3.0.4 + '@types/unist': 3.0.3 + '@ungap/structured-clone': 1.3.0 + hast-util-from-parse5: 8.0.3 + hast-util-to-parse5: 8.0.0 + html-void-elements: 3.0.0 + mdast-util-to-hast: 13.2.1 + parse5: 7.3.0 + unist-util-position: 5.0.0 + unist-util-visit: 5.0.0 + vfile: 6.0.3 + web-namespaces: 2.0.1 + zwitch: 2.0.4 + + hast-util-sanitize@5.0.2: + dependencies: + '@types/hast': 3.0.4 + '@ungap/structured-clone': 1.3.0 + unist-util-position: 5.0.0 + + hast-util-to-jsx-runtime@2.3.6: + dependencies: + '@types/estree': 1.0.8 + '@types/hast': 3.0.4 + '@types/unist': 3.0.3 + comma-separated-tokens: 2.0.3 + devlop: 1.1.0 + estree-util-is-identifier-name: 3.0.0 + hast-util-whitespace: 3.0.0 + mdast-util-mdx-expression: 2.0.1 + mdast-util-mdx-jsx: 3.2.0 + mdast-util-mdxjs-esm: 2.0.1 + property-information: 7.1.0 + space-separated-tokens: 2.0.2 + style-to-js: 1.1.21 + unist-util-position: 5.0.0 + vfile-message: 4.0.3 + transitivePeerDependencies: + - supports-color + + hast-util-to-parse5@8.0.0: + dependencies: + '@types/hast': 3.0.4 + comma-separated-tokens: 2.0.3 + devlop: 1.1.0 + property-information: 6.5.0 + space-separated-tokens: 2.0.2 + web-namespaces: 2.0.1 + zwitch: 2.0.4 + + hast-util-whitespace@3.0.0: + dependencies: + '@types/hast': 3.0.4 + + hastscript@9.0.1: + dependencies: + '@types/hast': 3.0.4 + comma-separated-tokens: 2.0.3 + hast-util-parse-selector: 4.0.0 + property-information: 7.1.0 + space-separated-tokens: 2.0.2 + headers-polyfill@4.0.3: {} hermes-estree@0.25.1: {} @@ -7516,6 +7997,10 @@ snapshots: dependencies: hermes-estree: 0.25.1 + html-url-attributes@3.0.1: {} + + html-void-elements@3.0.0: {} + human-id@4.1.2: {} iconv-lite@0.7.0: @@ -7539,6 +8024,8 @@ snapshots: ini@4.1.1: {} + inline-style-parser@0.2.7: {} + internal-slot@1.1.0: dependencies: es-errors: 1.3.0 @@ -7547,6 +8034,13 @@ snapshots: interpret@3.1.1: {} + is-alphabetical@2.0.1: {} + + is-alphanumerical@2.0.1: + dependencies: + is-alphabetical: 2.0.1 + is-decimal: 2.0.1 + is-arguments@1.2.0: dependencies: call-bound: 1.0.4 @@ -7600,6 +8094,8 @@ snapshots: call-bound: 1.0.4 has-tostringtag: 1.0.2 + is-decimal@2.0.1: {} + is-docker@2.2.1: {} is-extglob@2.1.1: {} @@ -7622,6 +8118,8 @@ snapshots: dependencies: is-extglob: 2.1.1 + is-hexadecimal@2.0.1: {} + is-installed-globally@1.0.0: dependencies: global-directory: 4.0.1 @@ -7642,6 +8140,8 @@ snapshots: is-path-inside@4.0.0: {} + is-plain-obj@4.1.0: {} + is-regex@1.2.1: dependencies: call-bound: 1.0.4 @@ -7853,6 +8353,8 @@ snapshots: lodash@4.17.21: {} + longest-streak@3.1.0: {} + loose-envify@1.4.0: dependencies: js-tokens: 4.0.0 @@ -7879,8 +8381,163 @@ snapshots: map-or-similar@1.5.0: {} + markdown-table@3.0.4: {} + math-intrinsics@1.1.0: {} + mdast-util-find-and-replace@3.0.2: + dependencies: + '@types/mdast': 4.0.4 + escape-string-regexp: 5.0.0 + unist-util-is: 6.0.1 + unist-util-visit-parents: 6.0.2 + + mdast-util-from-markdown@2.0.2: + dependencies: + '@types/mdast': 4.0.4 + '@types/unist': 3.0.3 + decode-named-character-reference: 1.2.0 + devlop: 1.1.0 + mdast-util-to-string: 4.0.0 + micromark: 4.0.2 + micromark-util-decode-numeric-character-reference: 2.0.2 + micromark-util-decode-string: 2.0.1 + micromark-util-normalize-identifier: 2.0.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + unist-util-stringify-position: 4.0.0 + transitivePeerDependencies: + - supports-color + + mdast-util-gfm-autolink-literal@2.0.1: + dependencies: + '@types/mdast': 4.0.4 + ccount: 2.0.1 + devlop: 1.1.0 + mdast-util-find-and-replace: 3.0.2 + micromark-util-character: 2.1.1 + + mdast-util-gfm-footnote@2.1.0: + dependencies: + '@types/mdast': 4.0.4 + devlop: 1.1.0 + mdast-util-from-markdown: 2.0.2 + mdast-util-to-markdown: 2.1.2 + micromark-util-normalize-identifier: 2.0.1 + transitivePeerDependencies: + - supports-color + + mdast-util-gfm-strikethrough@2.0.0: + dependencies: + '@types/mdast': 4.0.4 + mdast-util-from-markdown: 2.0.2 + mdast-util-to-markdown: 2.1.2 + transitivePeerDependencies: + - supports-color + + mdast-util-gfm-table@2.0.0: + dependencies: + '@types/mdast': 4.0.4 + devlop: 1.1.0 + markdown-table: 3.0.4 + mdast-util-from-markdown: 2.0.2 + mdast-util-to-markdown: 2.1.2 + transitivePeerDependencies: + - supports-color + + mdast-util-gfm-task-list-item@2.0.0: + dependencies: + '@types/mdast': 4.0.4 + devlop: 1.1.0 + mdast-util-from-markdown: 2.0.2 + mdast-util-to-markdown: 2.1.2 + transitivePeerDependencies: + - supports-color + + mdast-util-gfm@3.1.0: + dependencies: + mdast-util-from-markdown: 2.0.2 + mdast-util-gfm-autolink-literal: 2.0.1 + mdast-util-gfm-footnote: 2.1.0 + mdast-util-gfm-strikethrough: 2.0.0 + mdast-util-gfm-table: 2.0.0 + mdast-util-gfm-task-list-item: 2.0.0 + mdast-util-to-markdown: 2.1.2 + transitivePeerDependencies: + - supports-color + + mdast-util-mdx-expression@2.0.1: + dependencies: + '@types/estree-jsx': 1.0.5 + '@types/hast': 3.0.4 + '@types/mdast': 4.0.4 + devlop: 1.1.0 + mdast-util-from-markdown: 2.0.2 + mdast-util-to-markdown: 2.1.2 + transitivePeerDependencies: + - supports-color + + mdast-util-mdx-jsx@3.2.0: + dependencies: + '@types/estree-jsx': 1.0.5 + '@types/hast': 3.0.4 + '@types/mdast': 4.0.4 + '@types/unist': 3.0.3 + ccount: 2.0.1 + devlop: 1.1.0 + mdast-util-from-markdown: 2.0.2 + mdast-util-to-markdown: 2.1.2 + parse-entities: 4.0.2 + stringify-entities: 4.0.4 + unist-util-stringify-position: 4.0.0 + vfile-message: 4.0.3 + transitivePeerDependencies: + - supports-color + + mdast-util-mdxjs-esm@2.0.1: + dependencies: + '@types/estree-jsx': 1.0.5 + '@types/hast': 3.0.4 + '@types/mdast': 4.0.4 + devlop: 1.1.0 + mdast-util-from-markdown: 2.0.2 + mdast-util-to-markdown: 2.1.2 + transitivePeerDependencies: + - supports-color + + mdast-util-phrasing@4.1.0: + dependencies: + '@types/mdast': 4.0.4 + unist-util-is: 6.0.1 + + mdast-util-to-hast@13.2.1: + dependencies: + '@types/hast': 3.0.4 + '@types/mdast': 4.0.4 + '@ungap/structured-clone': 1.3.0 + devlop: 1.1.0 + micromark-util-sanitize-uri: 2.0.1 + trim-lines: 3.0.1 + unist-util-position: 5.0.0 + unist-util-visit: 5.0.0 + vfile: 6.0.3 + + mdast-util-to-markdown@2.1.2: + dependencies: + '@types/mdast': 4.0.4 + '@types/unist': 3.0.3 + longest-streak: 3.1.0 + mdast-util-phrasing: 4.1.0 + mdast-util-to-string: 4.0.0 + micromark-util-classify-character: 2.0.1 + micromark-util-decode-string: 2.0.1 + unist-util-visit: 5.0.0 + zwitch: 2.0.4 + + mdast-util-to-string@4.0.0: + dependencies: + '@types/mdast': 4.0.4 + memoize@10.2.0: dependencies: mimic-function: 5.0.1 @@ -7891,6 +8548,197 @@ snapshots: merge2@1.4.1: {} + micromark-core-commonmark@2.0.3: + dependencies: + decode-named-character-reference: 1.2.0 + devlop: 1.1.0 + micromark-factory-destination: 2.0.1 + micromark-factory-label: 2.0.1 + micromark-factory-space: 2.0.1 + micromark-factory-title: 2.0.1 + micromark-factory-whitespace: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-chunked: 2.0.1 + micromark-util-classify-character: 2.0.1 + micromark-util-html-tag-name: 2.0.1 + micromark-util-normalize-identifier: 2.0.1 + micromark-util-resolve-all: 2.0.1 + micromark-util-subtokenize: 2.1.0 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-extension-gfm-autolink-literal@2.1.0: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-sanitize-uri: 2.0.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-extension-gfm-footnote@2.1.0: + dependencies: + devlop: 1.1.0 + micromark-core-commonmark: 2.0.3 + micromark-factory-space: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-normalize-identifier: 2.0.1 + micromark-util-sanitize-uri: 2.0.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-extension-gfm-strikethrough@2.1.0: + dependencies: + devlop: 1.1.0 + micromark-util-chunked: 2.0.1 + micromark-util-classify-character: 2.0.1 + micromark-util-resolve-all: 2.0.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-extension-gfm-table@2.1.1: + dependencies: + devlop: 1.1.0 + micromark-factory-space: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-extension-gfm-tagfilter@2.0.0: + dependencies: + micromark-util-types: 2.0.2 + + micromark-extension-gfm-task-list-item@2.1.0: + dependencies: + devlop: 1.1.0 + micromark-factory-space: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-extension-gfm@3.0.0: + dependencies: + micromark-extension-gfm-autolink-literal: 2.1.0 + micromark-extension-gfm-footnote: 2.1.0 + micromark-extension-gfm-strikethrough: 2.1.0 + micromark-extension-gfm-table: 2.1.1 + micromark-extension-gfm-tagfilter: 2.0.0 + micromark-extension-gfm-task-list-item: 2.1.0 + micromark-util-combine-extensions: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-factory-destination@2.0.1: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-factory-label@2.0.1: + dependencies: + devlop: 1.1.0 + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-factory-space@2.0.1: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-types: 2.0.2 + + micromark-factory-title@2.0.1: + dependencies: + micromark-factory-space: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-factory-whitespace@2.0.1: + dependencies: + micromark-factory-space: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-character@2.1.1: + dependencies: + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-chunked@2.0.1: + dependencies: + micromark-util-symbol: 2.0.1 + + micromark-util-classify-character@2.0.1: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-combine-extensions@2.0.1: + dependencies: + micromark-util-chunked: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-decode-numeric-character-reference@2.0.2: + dependencies: + micromark-util-symbol: 2.0.1 + + micromark-util-decode-string@2.0.1: + dependencies: + decode-named-character-reference: 1.2.0 + micromark-util-character: 2.1.1 + micromark-util-decode-numeric-character-reference: 2.0.2 + micromark-util-symbol: 2.0.1 + + micromark-util-encode@2.0.1: {} + + micromark-util-html-tag-name@2.0.1: {} + + micromark-util-normalize-identifier@2.0.1: + dependencies: + micromark-util-symbol: 2.0.1 + + micromark-util-resolve-all@2.0.1: + dependencies: + micromark-util-types: 2.0.2 + + micromark-util-sanitize-uri@2.0.1: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-encode: 2.0.1 + micromark-util-symbol: 2.0.1 + + micromark-util-subtokenize@2.1.0: + dependencies: + devlop: 1.1.0 + micromark-util-chunked: 2.0.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-symbol@2.0.1: {} + + micromark-util-types@2.0.2: {} + + micromark@4.0.2: + dependencies: + '@types/debug': 4.1.12 + debug: 4.4.3 + decode-named-character-reference: 1.2.0 + devlop: 1.1.0 + micromark-core-commonmark: 2.0.3 + micromark-factory-space: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-chunked: 2.0.1 + micromark-util-combine-extensions: 2.0.1 + micromark-util-decode-numeric-character-reference: 2.0.2 + micromark-util-encode: 2.0.1 + micromark-util-normalize-identifier: 2.0.1 + micromark-util-resolve-all: 2.0.1 + micromark-util-sanitize-uri: 2.0.1 + micromark-util-subtokenize: 2.1.0 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + transitivePeerDependencies: + - supports-color + micromatch@4.0.8: dependencies: braces: 3.0.3 @@ -8137,6 +8985,20 @@ snapshots: dependencies: callsites: 3.1.0 + parse-entities@4.0.2: + dependencies: + '@types/unist': 2.0.11 + character-entities-legacy: 3.0.0 + character-reference-invalid: 2.0.1 + decode-named-character-reference: 1.2.0 + is-alphanumerical: 2.0.1 + is-decimal: 2.0.1 + is-hexadecimal: 2.0.1 + + parse5@7.3.0: + dependencies: + entities: 6.0.1 + path-exists@4.0.0: {} path-key@3.1.1: {} @@ -8279,6 +9141,10 @@ snapshots: object-assign: 4.1.1 react-is: 16.13.1 + property-information@6.5.0: {} + + property-information@7.1.0: {} + punycode@2.3.1: {} pure-rand@6.1.0: {} @@ -8320,6 +9186,24 @@ snapshots: react-is@17.0.2: {} + react-markdown@10.1.0(@types/react@19.2.7)(react@19.2.0): + dependencies: + '@types/hast': 3.0.4 + '@types/mdast': 4.0.4 + '@types/react': 19.2.7 + devlop: 1.1.0 + hast-util-to-jsx-runtime: 2.3.6 + html-url-attributes: 3.0.1 + mdast-util-to-hast: 13.2.1 + react: 19.2.0 + remark-parse: 11.0.0 + remark-rehype: 11.1.2 + unified: 11.0.5 + unist-util-visit: 5.0.0 + vfile: 6.0.3 + transitivePeerDependencies: + - supports-color + react@19.2.0: {} read-cache@1.0.0: @@ -8378,6 +9262,51 @@ snapshots: gopd: 1.2.0 set-function-name: 2.0.2 + rehype-raw@7.0.0: + dependencies: + '@types/hast': 3.0.4 + hast-util-raw: 9.1.0 + vfile: 6.0.3 + + rehype-sanitize@6.0.0: + dependencies: + '@types/hast': 3.0.4 + hast-util-sanitize: 5.0.2 + + remark-gfm@4.0.1: + dependencies: + '@types/mdast': 4.0.4 + mdast-util-gfm: 3.1.0 + micromark-extension-gfm: 3.0.0 + remark-parse: 11.0.0 + remark-stringify: 11.0.0 + unified: 11.0.5 + transitivePeerDependencies: + - supports-color + + remark-parse@11.0.0: + dependencies: + '@types/mdast': 4.0.4 + mdast-util-from-markdown: 2.0.2 + micromark-util-types: 2.0.2 + unified: 11.0.5 + transitivePeerDependencies: + - supports-color + + remark-rehype@11.1.2: + dependencies: + '@types/hast': 3.0.4 + '@types/mdast': 4.0.4 + mdast-util-to-hast: 13.2.1 + unified: 11.0.5 + vfile: 6.0.3 + + remark-stringify@11.0.0: + dependencies: + '@types/mdast': 4.0.4 + mdast-util-to-markdown: 2.1.2 + unified: 11.0.5 + require-directory@2.1.1: {} require-from-string@2.0.2: {} @@ -8571,6 +9500,8 @@ snapshots: source-map@0.7.6: {} + space-separated-tokens@2.0.2: {} + spawndamnit@3.0.1: dependencies: cross-spawn: 7.0.6 @@ -8665,6 +9596,11 @@ snapshots: define-properties: 1.2.1 es-object-atoms: 1.1.1 + stringify-entities@4.0.4: + dependencies: + character-entities-html4: 2.1.0 + character-entities-legacy: 3.0.0 + strip-ansi@6.0.1: dependencies: ansi-regex: 5.0.1 @@ -8685,6 +9621,14 @@ snapshots: strip-json-comments@5.0.3: {} + style-to-js@1.1.21: + dependencies: + style-to-object: 1.0.14 + + style-to-object@1.0.14: + dependencies: + inline-style-parser: 0.2.7 + styled-jsx@5.1.6(@babel/core@7.28.5)(react@19.2.0): dependencies: client-only: 0.0.1 @@ -8787,6 +9731,10 @@ snapshots: tree-kill@1.2.2: {} + trim-lines@3.0.1: {} + + trough@2.2.0: {} + ts-api-utils@2.1.0(typescript@5.9.3): dependencies: typescript: 5.9.3 @@ -8979,6 +9927,39 @@ snapshots: undici-types@6.21.0: {} + unified@11.0.5: + dependencies: + '@types/unist': 3.0.3 + bail: 2.0.2 + devlop: 1.1.0 + extend: 3.0.2 + is-plain-obj: 4.1.0 + trough: 2.2.0 + vfile: 6.0.3 + + unist-util-is@6.0.1: + dependencies: + '@types/unist': 3.0.3 + + unist-util-position@5.0.0: + dependencies: + '@types/unist': 3.0.3 + + unist-util-stringify-position@4.0.0: + dependencies: + '@types/unist': 3.0.3 + + unist-util-visit-parents@6.0.2: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.1 + + unist-util-visit@5.0.0: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.1 + unist-util-visit-parents: 6.0.2 + universalify@0.1.2: {} unplugin@1.16.1: @@ -9034,6 +10015,21 @@ snapshots: uuid@9.0.1: {} + vfile-location@5.0.3: + dependencies: + '@types/unist': 3.0.3 + vfile: 6.0.3 + + vfile-message@4.0.3: + dependencies: + '@types/unist': 3.0.3 + unist-util-stringify-position: 4.0.0 + + vfile@6.0.3: + dependencies: + '@types/unist': 3.0.3 + vfile-message: 4.0.3 + vite-node@2.1.9(@types/node@22.19.1): dependencies: cac: 6.7.14 @@ -9115,6 +10111,8 @@ snapshots: watskeburt@5.0.0: {} + web-namespaces@2.0.1: {} + webidl-conversions@7.0.0: {} webpack-virtual-modules@0.6.2: {} @@ -9220,3 +10218,5 @@ snapshots: zod@3.25.76: {} zod@4.1.13: {} + + zwitch@2.0.4: {} From c52a044b47305a9275b0ba24535dbc63987de8cb Mon Sep 17 00:00:00 2001 From: Ajax Davis Date: Sat, 29 Nov 2025 22:49:44 +1000 Subject: [PATCH 004/106] fix: use catch-all route for clean URLs with scoped package names MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Rename [slug] to [...slug] for catch-all routing - Update tool detail page to join slug segments (e.g., ['@tpmjs', 'text-transformer'] -> '@tpmjs/text-transformer') - Remove encodeURIComponent from tool search links - URLs now display as /tool/@tpmjs/text-transformer instead of /tool/%40tpmjs%2Ftext-transformer This makes URLs cleaner and more readable while maintaining full compatibility with scoped npm package names. ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- apps/web/src/app/tool/{[slug] => [...slug]}/page.tsx | 5 +++-- apps/web/src/app/tool/tool-search/page.tsx | 2 +- 2 files changed, 4 insertions(+), 3 deletions(-) rename apps/web/src/app/tool/{[slug] => [...slug]}/page.tsx (98%) diff --git a/apps/web/src/app/tool/[slug]/page.tsx b/apps/web/src/app/tool/[...slug]/page.tsx similarity index 98% rename from apps/web/src/app/tool/[slug]/page.tsx rename to apps/web/src/app/tool/[...slug]/page.tsx index 9a8a9f2..4bf5528 100644 --- a/apps/web/src/app/tool/[slug]/page.tsx +++ b/apps/web/src/app/tool/[...slug]/page.tsx @@ -71,7 +71,7 @@ interface Tool { export default function ToolDetailPage({ params, }: { - params: Promise<{ slug: string }>; + params: Promise<{ slug: string[] }>; }): React.ReactElement { const [tool, setTool] = useState(null); const [loading, setLoading] = useState(true); @@ -79,7 +79,8 @@ export default function ToolDetailPage({ const [slug, setSlug] = useState(''); useEffect(() => { - params.then((p) => setSlug(p.slug)); + // Join slug array to reconstruct package name (e.g., ['@tpmjs', 'text-transformer'] -> '@tpmjs/text-transformer') + params.then((p) => setSlug(p.slug.join('/'))); }, [params]); useEffect(() => { diff --git a/apps/web/src/app/tool/tool-search/page.tsx b/apps/web/src/app/tool/tool-search/page.tsx index c9f9234..f54c41b 100644 --- a/apps/web/src/app/tool/tool-search/page.tsx +++ b/apps/web/src/app/tool/tool-search/page.tsx @@ -327,7 +327,7 @@ export default function ToolSearchPage(): React.ReactElement { - + From 5feac0d2db998f266c243124f9c9d83474445257 Mon Sep 17 00:00:00 2001 From: Ajax Davis Date: Sat, 29 Nov 2025 22:57:54 +1000 Subject: [PATCH 005/106] fix: update API route to use catch-all pattern for clean URLs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Rename API route from [slug] to [...slug] for catch-all routing - Update API handler to join slug segments for scoped packages - Remove encodeURIComponent from frontend API call This fixes the 404 error when accessing tool pages with scoped package names. The sync workers will need to run to populate README data for existing tools. ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../api/tools/{[slug] => [...slug]}/route.ts | 10 +++++-- apps/web/src/app/tool/[...slug]/page.tsx | 2 +- packages/db/check-tool.js | 30 +++++++++++++++++++ packages/db/check-tool.mjs | 30 +++++++++++++++++++ 4 files changed, 68 insertions(+), 4 deletions(-) rename apps/web/src/app/api/tools/{[slug] => [...slug]}/route.ts (73%) create mode 100644 packages/db/check-tool.js create mode 100644 packages/db/check-tool.mjs diff --git a/apps/web/src/app/api/tools/[slug]/route.ts b/apps/web/src/app/api/tools/[...slug]/route.ts similarity index 73% rename from apps/web/src/app/api/tools/[slug]/route.ts rename to apps/web/src/app/api/tools/[...slug]/route.ts index 759cdea..964e639 100644 --- a/apps/web/src/app/api/tools/[slug]/route.ts +++ b/apps/web/src/app/api/tools/[...slug]/route.ts @@ -6,21 +6,25 @@ export const dynamic = 'force-dynamic'; export const maxDuration = 60; /** - * GET /api/tools/[slug] + * GET /api/tools/[...slug] * * Fetch a single tool by its NPM package name (slug) + * Supports catch-all routing for scoped packages like @tpmjs/text-transformer */ export async function GET( _request: NextRequest, - { params }: { params: Promise<{ slug: string }> } + { params }: { params: Promise<{ slug: string[] }> } ): Promise { try { const { slug } = await params; + // Join slug array to reconstruct package name (e.g., ['@tpmjs', 'text-transformer'] -> '@tpmjs/text-transformer') + const packageName = slug.join('/'); + // Find the tool by npmPackageName const tool = await prisma.tool.findUnique({ where: { - npmPackageName: decodeURIComponent(slug), + npmPackageName: packageName, }, }); diff --git a/apps/web/src/app/tool/[...slug]/page.tsx b/apps/web/src/app/tool/[...slug]/page.tsx index 4bf5528..df763fb 100644 --- a/apps/web/src/app/tool/[...slug]/page.tsx +++ b/apps/web/src/app/tool/[...slug]/page.tsx @@ -89,7 +89,7 @@ export default function ToolDetailPage({ const fetchTool = async () => { try { setLoading(true); - const response = await fetch(`/api/tools/${encodeURIComponent(slug)}`); + const response = await fetch(`/api/tools/${slug}`); const data = await response.json(); if (data.success) { diff --git a/packages/db/check-tool.js b/packages/db/check-tool.js new file mode 100644 index 0000000..a358ce4 --- /dev/null +++ b/packages/db/check-tool.js @@ -0,0 +1,30 @@ +const { PrismaClient } = require('@prisma/client'); +const prisma = new PrismaClient(); + +async function main() { + const tool = await prisma.tool.findUnique({ + where: { npmPackageName: '@tpmjs/text-transformer' }, + select: { + npmPackageName: true, + npmVersion: true, + npmReadme: true, + }, + }); + + if (tool) { + console.log('Tool found:', tool.npmPackageName, tool.npmVersion); + console.log('Has README:', tool.npmReadme ? `Yes (${tool.npmReadme.length} chars)` : 'No'); + } else { + console.log('Tool @tpmjs/text-transformer not found in database'); + + // List all tools to see what's available + const allTools = await prisma.tool.findMany({ + select: { npmPackageName: true }, + take: 10, + }); + console.log('\nAvailable tools:'); + allTools.forEach((t) => console.log(' -', t.npmPackageName)); + } +} + +main().finally(() => prisma.$disconnect()); diff --git a/packages/db/check-tool.mjs b/packages/db/check-tool.mjs new file mode 100644 index 0000000..4fd8e43 --- /dev/null +++ b/packages/db/check-tool.mjs @@ -0,0 +1,30 @@ +import { PrismaClient } from '@prisma/client'; +const prisma = new PrismaClient(); + +async function main() { + const tool = await prisma.tool.findUnique({ + where: { npmPackageName: '@tpmjs/text-transformer' }, + select: { + npmPackageName: true, + npmVersion: true, + npmReadme: true, + } + }); + + if (tool) { + console.log('Tool found:', tool.npmPackageName, tool.npmVersion); + console.log('Has README:', tool.npmReadme ? `Yes (${tool.npmReadme.length} chars)` : 'No'); + } else { + console.log('Tool @tpmjs/text-transformer not found in database'); + + // List all tools to see what's available + const allTools = await prisma.tool.findMany({ + select: { npmPackageName: true }, + take: 10 + }); + console.log('\nAvailable tools:'); + allTools.forEach(t => console.log(' -', t.npmPackageName)); + } +} + +main().finally(() => prisma.$disconnect()); From 48c8775acf94707309f965cccba726b5d1b46b9b Mon Sep 17 00:00:00 2001 From: Ajax Davis Date: Sat, 29 Nov 2025 23:08:00 +1000 Subject: [PATCH 006/106] feat: improve README markdown styling to match npm.com quality MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit **Enhanced Markdown Rendering:** - Use prose-slate for better default typography - Add proper heading hierarchy with bottom borders on h1/h2 - Improve code block styling with better backgrounds and shadows - Style inline code with pink/red accent colors like npm - Better table styling with proper borders and rounded corners - Improve link colors (blue) with hover effects - Add better spacing throughout (margins, padding, line-height) - Enhance blockquote styling with background colors - Better list spacing with space-y-2 - Add proper light/dark mode support with zinc color palette **Component Updates:** - Custom pre component with better background and border - Custom table wrapper with overflow handling - Improved link component with external link detection - Better inline code styling The README now renders beautifully like npm.com instead of looking plain. ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- apps/web/src/components/Markdown.tsx | 81 +++++++++++++++++++--------- packages/db/sync-single-tool.mjs | 35 ++++++++++++ 2 files changed, 90 insertions(+), 26 deletions(-) create mode 100644 packages/db/sync-single-tool.mjs diff --git a/apps/web/src/components/Markdown.tsx b/apps/web/src/components/Markdown.tsx index 8f6f1e0..8caef0a 100644 --- a/apps/web/src/components/Markdown.tsx +++ b/apps/web/src/components/Markdown.tsx @@ -13,44 +13,49 @@ interface MarkdownProps { /** * Markdown renderer component * Safely renders markdown content with GitHub Flavored Markdown support + * Styled to match npm.com's beautiful README rendering */ export function Markdown({ content, className = '' }: MarkdownProps): React.ReactElement { return (
{ const isInline = !className; if (isInline) { return ( - + {children} ); @@ -61,7 +66,18 @@ export function Markdown({ content, className = '' }: MarkdownProps): React.Reac ); }, - // Make links open in new tab + // Better styled pre blocks + pre: ({ children, ...props }) => { + return ( + 
+                {children}
+
+ ); + }, + // Make links open in new tab with better styling a: ({ href, children, ...props }) => { const isExternal = href?.startsWith('http'); return ( @@ -69,13 +85,26 @@ export function Markdown({ content, className = '' }: MarkdownProps): React.Reac href={href} target={isExternal ? '_blank' : undefined} rel={isExternal ? 'noopener noreferrer' : undefined} - className="text-primary hover:underline" + className="text-blue-600 dark:text-blue-400 hover:underline font-medium" {...props} > {children} ); }, + // Better table styling + table: ({ children, ...props }) => { + return ( +
+ + {children} +
+
+ ); + }, }} > {content} diff --git a/packages/db/sync-single-tool.mjs b/packages/db/sync-single-tool.mjs new file mode 100644 index 0000000..e7decfc --- /dev/null +++ b/packages/db/sync-single-tool.mjs @@ -0,0 +1,35 @@ +import { PrismaClient } from '@prisma/client'; +import { fetchLatestPackageWithMetadata } from '@tpmjs/npm-client'; + +const prisma = new PrismaClient(); + +async function main() { + const packageName = '@tpmjs/text-transformer'; + + console.log(`Fetching metadata for ${packageName}...`); + const pkg = await fetchLatestPackageWithMetadata(packageName); + + if (!pkg) { + console.error('Package not found!'); + return; + } + + console.log(`Found ${packageName} v${pkg.version}`); + console.log(`README length: ${pkg.readme ? pkg.readme.length : 0} chars`); + console.log(`Keywords: ${(pkg.topLevelKeywords || pkg.keywords || []).join(', ')}`); + + // Update the tool in the database + await prisma.tool.update({ + where: { npmPackageName: packageName }, + data: { + npmReadme: pkg.readme || null, + npmKeywords: pkg.topLevelKeywords || pkg.keywords || [], + npmAuthor: pkg.author || null, + npmMaintainers: pkg.maintainers || null, + } + }); + + console.log('\nโœ… Tool updated successfully!'); +} + +main().finally(() => prisma.$disconnect()); From 91f950d45380da79b6caec174e3ad5c851bd9272 Mon Sep 17 00:00:00 2001 From: Ajax Davis Date: Sat, 29 Nov 2025 23:21:40 +1000 Subject: [PATCH 007/106] feat: add syntax highlighting and improve README readability MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit **Syntax Highlighting:** - Add react-syntax-highlighter with Solarized Light theme - Proper language detection from markdown code blocks - Beautiful syntax highlighting for all code examples - Improved inline code styling with subtle borders **Enhanced Readability:** - Larger base typography with prose-lg - Better contrast for text colors (zinc-700/zinc-300) - Improved heading spacing and hierarchy - Enhanced table styling with hover effects and better spacing - Table headers with uppercase, bold styling - Table cells with generous padding (px-6 py-4/py-3) - Row hover effects for better interaction - Better blockquote styling with blue accents - Improved list spacing with leading-relaxed - Enhanced image borders and shadows **Table Improvements:** - Professional header styling with background colors - Better cell padding and spacing - Hover effects on rows - Improved borders and shadows - Responsive overflow handling All code blocks now have beautiful Solarized Light syntax highlighting, and the overall typography is more readable and professional. ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- apps/web/package.json | 2 + apps/web/src/components/Markdown.tsx | 129 ++++++++++++++++++--------- pnpm-lock.yaml | 81 +++++++++++++++++ 3 files changed, 172 insertions(+), 40 deletions(-) diff --git a/apps/web/package.json b/apps/web/package.json index 72ec1b3..cb5c089 100644 --- a/apps/web/package.json +++ b/apps/web/package.json @@ -17,11 +17,13 @@ "@tpmjs/types": "workspace:*", "@tpmjs/ui": "workspace:*", "@tpmjs/utils": "workspace:*", + "@types/react-syntax-highlighter": "^15.5.13", "next": "^16.0.4", "next-themes": "^0.4.6", "react": "^19.0.0", "react-dom": "^19.0.0", "react-markdown": "^10.1.0", + "react-syntax-highlighter": "^16.1.0", "rehype-raw": "^7.0.0", "rehype-sanitize": "^6.0.0", "remark-gfm": "^4.0.1", diff --git a/apps/web/src/components/Markdown.tsx b/apps/web/src/components/Markdown.tsx index 8caef0a..a6bc1cc 100644 --- a/apps/web/src/components/Markdown.tsx +++ b/apps/web/src/components/Markdown.tsx @@ -1,6 +1,9 @@ 'use client'; import ReactMarkdown from 'react-markdown'; +import { Prism as SyntaxHighlighter } from 'react-syntax-highlighter'; +// eslint-disable-next-line import/no-internal-modules +import { solarizedlight } from 'react-syntax-highlighter/dist/esm/styles/prism'; import rehypeRaw from 'rehype-raw'; import rehypeSanitize from 'rehype-sanitize'; import remarkGfm from 'remark-gfm'; @@ -18,63 +21,71 @@ interface MarkdownProps { export function Markdown({ content, className = '' }: MarkdownProps): React.ReactElement { return (
{ + const match = /language-(\w+)/.exec(className || ''); + const language = match ? match[1] : ''; const isInline = !className; + if (isInline) { return ( {children} ); } + return ( - - {children} - - ); - }, - // Better styled pre blocks - pre: ({ children, ...props }) => { - return ( - 
-                {children}
-
+ {String(children).replace(/\n$/, '')} + + ); + }, + // Pre wrapper for code blocks (SyntaxHighlighter handles its own styling) + pre: ({ children, ...props }) => { + return ( +
+ 
{children}
+
); }, // Make links open in new tab with better styling @@ -92,12 +103,12 @@ export function Markdown({ content, className = '' }: MarkdownProps): React.Reac ); }, - // Better table styling + // Better table styling with improved readability table: ({ children, ...props }) => { return ( -
+
{children} @@ -105,6 +116,44 @@ export function Markdown({ content, className = '' }: MarkdownProps): React.Reac ); }, + // Table header with better styling + thead: ({ children, ...props }) => { + return ( + + {children} + + ); + }, + // Table header cells with better spacing + th: ({ children, ...props }) => { + return ( + + ); + }, + // Table data cells with better spacing + td: ({ children, ...props }) => { + return ( + + ); + }, + // Table rows with hover effect + tr: ({ children, ...props }) => { + return ( + + {children} + + ); + }, }} > {content} diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 0b7e802..f3ca6fa 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -59,6 +59,9 @@ importers: '@tpmjs/utils': specifier: workspace:* version: link:../../packages/utils + '@types/react-syntax-highlighter': + specifier: ^15.5.13 + version: 15.5.13 next: specifier: ^16.0.4 version: 16.0.4(@babel/core@7.28.5)(react-dom@19.2.0(react@19.2.0))(react@19.2.0) @@ -74,6 +77,9 @@ importers: react-markdown: specifier: ^10.1.0 version: 10.1.0(@types/react@19.2.7)(react@19.2.0) + react-syntax-highlighter: + specifier: ^16.1.0 + version: 16.1.0(react@19.2.0) rehype-raw: specifier: ^7.0.0 version: 7.0.0 @@ -1950,11 +1956,17 @@ packages: '@types/node@22.19.1': resolution: {integrity: sha512-LCCV0HdSZZZb34qifBsyWlUmok6W7ouER+oQIGBScS8EsZsQbrtFTUrDX4hOl+CS6p7cnNC4td+qrSVGSCTUfQ==} + '@types/prismjs@1.26.5': + resolution: {integrity: sha512-AUZTa7hQ2KY5L7AmtSiqxlhWxb4ina0yd8hNbl4TWuqnv/pFP0nDMb3YrfSBf4hJVGLh2YEIBfKaBW/9UEl6IQ==} + '@types/react-dom@19.2.3': resolution: {integrity: sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==} peerDependencies: '@types/react': ^19.2.0 + '@types/react-syntax-highlighter@15.5.13': + resolution: {integrity: sha512-uLGJ87j6Sz8UaBAooU0T6lWJ0dBmjZgN1PZTrj05TNql2/XpC6+4HhMT5syIdFUUt+FASfCeLLv4kBygNU+8qA==} + '@types/react@19.2.7': resolution: {integrity: sha512-MWtvHrGZLFttgeEj28VXHxpmwYbor/ATPYbBfSFZEIRK0ecCFLl2Qo55z52Hss+UV9CRN7trSeq1zbgx7YDWWg==} @@ -2907,6 +2919,9 @@ packages: fastq@1.19.1: resolution: {integrity: sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==} + fault@1.0.4: + resolution: {integrity: sha512-CJ0HCB5tL5fYTEA7ToAq5+kTwd++Borf1/bifxd9iT70QcXr4MRrO3Llf8Ifs70q+SJcGHFtnIE/Nw6giCtECA==} + fd-package-json@2.0.0: resolution: {integrity: sha512-jKmm9YtsNXN789RS/0mSzOC1NUq9mkVd65vbSSVsKdjGvYXBuE4oWe2QOEoFeRmJg+lPuZxpmrfFclNhoRMneQ==} @@ -2953,6 +2968,10 @@ packages: resolution: {integrity: sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==} engines: {node: '>=14'} + format@0.2.2: + resolution: {integrity: sha512-wzsgA6WOq+09wrU1tsJ09udeR/YZRaeArL9e1wPbFg3GG2yDnC2ldKpxs4xunpFF9DgqCqOIra3bc1HWrJ37Ww==} + engines: {node: '>=0.4.x'} + formatly@0.3.0: resolution: {integrity: sha512-9XNj/o4wrRFyhSMJOvsuyMwy8aUfBaZ1VrqHVfohyXf0Sw0e+yfKG+xZaY3arGCOMdwFsqObtzVOc1gU9KiT9w==} engines: {node: '>=18.3.0'} @@ -3129,6 +3148,12 @@ packages: hermes-parser@0.25.1: resolution: {integrity: sha512-6pEjquH3rqaI6cYAXYPcz9MS4rY6R4ngRgrgfDshRptUZIc3lw0MCIJIGDj9++mfySOuPTHB4nrSW99BCvOPIA==} + highlight.js@10.7.3: + resolution: {integrity: sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A==} + + highlightjs-vue@1.0.0: + resolution: {integrity: sha512-PDEfEF102G23vHmPhLyPboFCD+BkMGu+GuJe2d9/eH4FsCwvgBpnc9n0pGE+ffKdph38s6foEZiEjdgHdzp+IA==} + html-url-attributes@3.0.1: resolution: {integrity: sha512-ol6UPyBWqsrO6EJySPz2O7ZSr856WDrEzM5zMqp+FJJLGMW35cLYmmZnl0vztAZxRUoNZJFTCohfjuIJ8I4QBQ==} @@ -3531,6 +3556,9 @@ packages: loupe@3.2.1: resolution: {integrity: sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ==} + lowlight@1.20.0: + resolution: {integrity: sha512-8Ktj+prEb1RoCPkEOrPMYUN/nCggB7qAWe3a7OpMjWQkh3l2RD5wKRQ+o8Q8YuI9RG/xs95waaI/E6ym/7NsTw==} + lru-cache@10.4.3: resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==} @@ -4072,6 +4100,10 @@ packages: typescript: optional: true + prismjs@1.30.0: + resolution: {integrity: sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==} + engines: {node: '>=6'} + process@0.11.10: resolution: {integrity: sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==} engines: {node: '>= 0.6.0'} @@ -4131,6 +4163,12 @@ packages: '@types/react': '>=18' react: '>=18' + react-syntax-highlighter@16.1.0: + resolution: {integrity: sha512-E40/hBiP5rCNwkeBN1vRP+xow1X0pndinO+z3h7HLsHyjztbyjfzNWNKuAsJj+7DLam9iT4AaaOZnueCU+Nplg==} + engines: {node: '>= 16.20.2'} + peerDependencies: + react: '>= 0.14.0' + react@19.2.0: resolution: {integrity: sha512-tmbWg6W31tQLeB5cdIBOicJDJRR2KzXsV7uSK9iNfLWQ5bIZfxuPEHp7M8wiHyHnn0DD1i7w3Zmin0FtkrwoCQ==} engines: {node: '>=0.10.0'} @@ -4166,6 +4204,9 @@ packages: resolution: {integrity: sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw==} engines: {node: '>= 0.4'} + refractor@5.0.0: + resolution: {integrity: sha512-QXOrHQF5jOpjjLfiNk5GFnWhRXvxjUVnlFxkeDmewR5sXkr3iM46Zo+CnRR8B+MDVqkULW4EcLVcRBNOPXHosw==} + regexp-tree@0.1.27: resolution: {integrity: sha512-iETxpjK6YoRWJG5o6hXLwvjYAoW+FEZn9os0PD/b6AP6xQwsa/Y7lCVgIixBbUPMfhu+i2LtdeAqVTgGlQarfA==} hasBin: true @@ -6348,10 +6389,16 @@ snapshots: dependencies: undici-types: 6.21.0 + '@types/prismjs@1.26.5': {} + '@types/react-dom@19.2.3(@types/react@19.2.7)': dependencies: '@types/react': 19.2.7 + '@types/react-syntax-highlighter@15.5.13': + dependencies: + '@types/react': 19.2.7 + '@types/react@19.2.7': dependencies: csstype: 3.2.3 @@ -7704,6 +7751,10 @@ snapshots: dependencies: reusify: 1.1.0 + fault@1.0.4: + dependencies: + format: 0.2.2 + fd-package-json@2.0.0: dependencies: walk-up-path: 4.0.0 @@ -7752,6 +7803,8 @@ snapshots: cross-spawn: 7.0.6 signal-exit: 4.1.0 + format@0.2.2: {} + formatly@0.3.0: dependencies: fd-package-json: 2.0.0 @@ -7997,6 +8050,10 @@ snapshots: dependencies: hermes-estree: 0.25.1 + highlight.js@10.7.3: {} + + highlightjs-vue@1.0.0: {} + html-url-attributes@3.0.1: {} html-void-elements@3.0.0: {} @@ -8361,6 +8418,11 @@ snapshots: loupe@3.2.1: {} + lowlight@1.20.0: + dependencies: + fault: 1.0.4 + highlight.js: 10.7.3 + lru-cache@10.4.3: {} lru-cache@11.2.2: {} @@ -9128,6 +9190,8 @@ snapshots: transitivePeerDependencies: - magicast + prismjs@1.30.0: {} + process@0.11.10: {} prompts@2.4.2: @@ -9204,6 +9268,16 @@ snapshots: transitivePeerDependencies: - supports-color + react-syntax-highlighter@16.1.0(react@19.2.0): + dependencies: + '@babel/runtime': 7.28.4 + highlight.js: 10.7.3 + highlightjs-vue: 1.0.0 + lowlight: 1.20.0 + prismjs: 1.30.0 + react: 19.2.0 + refractor: 5.0.0 + react@19.2.0: {} read-cache@1.0.0: @@ -9251,6 +9325,13 @@ snapshots: get-proto: 1.0.1 which-builtin-type: 1.2.1 + refractor@5.0.0: + dependencies: + '@types/hast': 3.0.4 + '@types/prismjs': 1.26.5 + hastscript: 9.0.1 + parse-entities: 4.0.2 + regexp-tree@0.1.27: {} regexp.prototype.flags@1.5.4: From 6eb51d1371ab7494f5f5c9055addc1d9e1f85f3e Mon Sep 17 00:00:00 2001 From: Ajax Davis Date: Sun, 30 Nov 2025 00:36:05 +1000 Subject: [PATCH 008/106] feat: add interactive tool playground with AI-powered execution MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Implement comprehensive tool testing environment with real package execution, AI agents, and token tracking. **New Features:** - Interactive playground UI with 4 tabs (Input, Output, Logs, Token Usage) - Real npm package execution in VM2 sandbox with security constraints - AI-powered tool execution using AI SDK v5 and GPT-4 Turbo - Server-Sent Events (SSE) streaming for real-time progress updates - Comprehensive 4-category token tracking (Input, Tool Description, Schema, Output) - Visual token breakdown with colored progress bars - IP-based rate limiting (10 executions/hour per IP) - Database persistence of all simulations with full metadata **Database Schema:** - New `Simulation` model for execution records - New `TokenUsage` model for detailed token metrics - New `ExecutionLog` model for execution event tracking - Added simulations relation to Tool model **Package Executor (@tpmjs/package-executor):** - VM2 sandbox with 5-second timeout - Blocked dangerous modules (fs, net, http, https, child_process) - LRU file system cache in /tmp/.tpmjs-cache - Package installation and caching strategy **AI Agent Service:** - TPMJS parameter to Zod schema conversion - AI SDK tool definition generation - Token counting using tiktoken library - GPT-4 Turbo pricing estimation - Streaming text execution with callbacks **API Endpoints:** - POST /api/tools/[...slug]/execute - SSE streaming execution - GET /api/tools/[...slug]/simulations - Execution history - Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) **Frontend Components:** - ToolPlayground - Main playground UI with tabs - TokenBreakdown - Visual token metrics with colored bars - Integrated above README section on tool detail pages **Security:** - VM2 sandboxing prevents filesystem/network access - Rate limiting prevents abuse - IP tracking for usage monitoring - Timeout protection (60s max API duration, 5s VM timeout) ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- apps/web/package.json | 7 +- .../app/api/tools/[...slug]/execute/route.ts | 190 +++++++++ .../api/tools/[...slug]/simulations/route.ts | 51 +++ apps/web/src/app/tool/[...slug]/page.tsx | 5 + apps/web/src/components/TokenBreakdown.tsx | 93 +++++ apps/web/src/components/ToolPlayground.tsx | 380 ++++++++++++++++++ .../src/lib/ai-agent/tool-executor-agent.ts | 233 +++++++++++ apps/web/src/lib/rate-limiter.ts | 68 ++++ packages/db/prisma/schema.prisma | 75 ++++ packages/package-executor/package.json | 22 + packages/package-executor/src/executor.ts | 141 +++++++ packages/package-executor/src/index.ts | 7 + packages/package-executor/src/types.ts | 21 + packages/package-executor/tsconfig.json | 9 + pnpm-lock.yaml | 164 +++++++- 15 files changed, 1462 insertions(+), 4 deletions(-) create mode 100644 apps/web/src/app/api/tools/[...slug]/execute/route.ts create mode 100644 apps/web/src/app/api/tools/[...slug]/simulations/route.ts create mode 100644 apps/web/src/components/TokenBreakdown.tsx create mode 100644 apps/web/src/components/ToolPlayground.tsx create mode 100644 apps/web/src/lib/ai-agent/tool-executor-agent.ts create mode 100644 apps/web/src/lib/rate-limiter.ts create mode 100644 packages/package-executor/package.json create mode 100644 packages/package-executor/src/executor.ts create mode 100644 packages/package-executor/src/index.ts create mode 100644 packages/package-executor/src/types.ts create mode 100644 packages/package-executor/tsconfig.json diff --git a/apps/web/package.json b/apps/web/package.json index cb5c089..d61372d 100644 --- a/apps/web/package.json +++ b/apps/web/package.json @@ -11,15 +11,19 @@ "clean": "rm -rf .next .turbo" }, "dependencies": { + "@ai-sdk/openai": "^2.0.74", "@tpmjs/db": "workspace:*", "@tpmjs/env": "workspace:*", "@tpmjs/npm-client": "workspace:*", + "@tpmjs/package-executor": "workspace:*", "@tpmjs/types": "workspace:*", "@tpmjs/ui": "workspace:*", "@tpmjs/utils": "workspace:*", "@types/react-syntax-highlighter": "^15.5.13", + "ai": "^5.0.104", "next": "^16.0.4", "next-themes": "^0.4.6", + "openai": "^6.9.1", "react": "^19.0.0", "react-dom": "^19.0.0", "react-markdown": "^10.1.0", @@ -27,7 +31,8 @@ "rehype-raw": "^7.0.0", "rehype-sanitize": "^6.0.0", "remark-gfm": "^4.0.1", - "zod": "^3.24.1" + "tiktoken": "^1.0.22", + "zod": "^3.25.76" }, "devDependencies": { "@tpmjs/eslint-config": "workspace:*", diff --git a/apps/web/src/app/api/tools/[...slug]/execute/route.ts b/apps/web/src/app/api/tools/[...slug]/execute/route.ts new file mode 100644 index 0000000..a56942c --- /dev/null +++ b/apps/web/src/app/api/tools/[...slug]/execute/route.ts @@ -0,0 +1,190 @@ +/** + * Tool execution endpoint with SSE streaming + * Executes TPMJS tools with AI agents and streams real-time progress + */ + +import { executeToolWithAgent } from '@/lib/ai-agent/tool-executor-agent'; +import { checkRateLimit, getClientIP } from '@/lib/rate-limiter'; +import { prisma } from '@tpmjs/db'; +import { type NextRequest, NextResponse } from 'next/server'; + +// Use Node.js runtime for SSE streaming +export const runtime = 'nodejs'; +export const maxDuration = 60; // 60 seconds timeout + +interface ExecuteRequest { + prompt: string; + parameters?: Record; +} + +/** + * POST /api/tools/[...slug]/execute + * Executes a tool with an AI agent and streams the response via SSE + */ +export async function POST( + request: NextRequest, + { params }: { params: Promise<{ slug: string[] }> } +) { + const { slug } = await params; + const packageName = decodeURIComponent(slug.join('/')); + + try { + // Parse request body + const body = (await request.json()) as ExecuteRequest; + const { prompt, parameters } = body; + + if (!prompt || prompt.length === 0) { + return NextResponse.json({ error: 'Prompt is required' }, { status: 400 }); + } + + if (prompt.length > 2000) { + return NextResponse.json({ error: 'Prompt too long (max 2000 characters)' }, { status: 400 }); + } + + // Get client IP and check rate limit + const ipAddress = getClientIP(request); + const rateLimit = await checkRateLimit(ipAddress); + + if (!rateLimit.allowed) { + return NextResponse.json( + { + error: 'Rate limit exceeded', + resetAt: rateLimit.resetAt, + remaining: 0, + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': '10', + 'X-RateLimit-Remaining': '0', + 'X-RateLimit-Reset': rateLimit.resetAt.toISOString(), + }, + } + ); + } + + // Fetch tool from database + const tool = await prisma.tool.findUnique({ + where: { npmPackageName: packageName }, + }); + + if (!tool) { + return NextResponse.json({ error: 'Tool not found' }, { status: 404 }); + } + + // Create simulation record + const simulation = await prisma.simulation.create({ + data: { + toolId: tool.id, + userPrompt: prompt, + // biome-ignore lint/suspicious/noExplicitAny: Prisma Json type compatibility workaround + parameters: parameters ? (parameters as any) : undefined, + ipAddress, + userAgent: request.headers.get('user-agent') || null, + status: 'running', + model: 'gpt-4-turbo', + }, + }); + + // Create readable stream for SSE + const stream = new ReadableStream({ + async start(controller) { + const encoder = new TextEncoder(); + + const sendEvent = (event: string, data: unknown) => { + const message = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`; + controller.enqueue(encoder.encode(message)); + }; + + try { + const startTime = Date.now(); + + // Execute tool with AI agent + const result = await executeToolWithAgent( + tool, + prompt, + (chunk) => { + // Stream text chunks + sendEvent('chunk', { text: chunk }); + }, + (tokens) => { + // Stream token updates + sendEvent('tokens', tokens); + } + ); + + const executionTimeMs = Date.now() - startTime; + + // Update simulation with results + await prisma.simulation.update({ + where: { id: simulation.id }, + data: { + status: 'success', + output: { result: result.output }, + agentSteps: result.agentSteps, + executionTimeMs, + completedAt: new Date(), + }, + }); + + // Create token usage record + await prisma.tokenUsage.create({ + data: { + simulationId: simulation.id, + inputTokens: result.tokenBreakdown.inputTokens, + toolDescTokens: result.tokenBreakdown.toolDescTokens, + schemaTokens: result.tokenBreakdown.schemaTokens, + outputTokens: result.tokenBreakdown.outputTokens, + totalTokens: result.tokenBreakdown.totalTokens, + estimatedCost: result.tokenBreakdown.estimatedCost, + }, + }); + + // Send completion event + sendEvent('complete', { + output: result.output, + tokenBreakdown: result.tokenBreakdown, + executionTimeMs, + agentSteps: result.agentSteps, + }); + } catch (error) { + // Update simulation with error + await prisma.simulation.update({ + where: { id: simulation.id }, + data: { + status: 'error', + error: error instanceof Error ? error.message : 'Unknown error', + completedAt: new Date(), + }, + }); + + // Send error event + sendEvent('error', { + message: error instanceof Error ? error.message : 'Unknown error', + }); + } finally { + controller.close(); + } + }, + }); + + // Return SSE stream + return new NextResponse(stream, { + headers: { + 'Content-Type': 'text/event-stream', + 'Cache-Control': 'no-cache', + Connection: 'keep-alive', + 'X-RateLimit-Limit': '10', + 'X-RateLimit-Remaining': rateLimit.remaining.toString(), + }, + }); + } catch (error) { + console.error('Execute endpoint error:', error); + return NextResponse.json( + { + error: error instanceof Error ? error.message : 'Internal server error', + }, + { status: 500 } + ); + } +} diff --git a/apps/web/src/app/api/tools/[...slug]/simulations/route.ts b/apps/web/src/app/api/tools/[...slug]/simulations/route.ts new file mode 100644 index 0000000..d2748c8 --- /dev/null +++ b/apps/web/src/app/api/tools/[...slug]/simulations/route.ts @@ -0,0 +1,51 @@ +/** + * Simulation history endpoint + * Returns recent simulations for a tool with token usage data + */ + +import { prisma } from '@tpmjs/db'; +import { type NextRequest, NextResponse } from 'next/server'; + +/** + * GET /api/tools/[...slug]/simulations + * Returns the last 10 simulations for a tool + */ +export async function GET( + _request: NextRequest, + { params }: { params: Promise<{ slug: string[] }> } +) { + const { slug } = await params; + const packageName = decodeURIComponent(slug.join('/')); + + try { + // Fetch tool + const tool = await prisma.tool.findUnique({ + where: { npmPackageName: packageName }, + select: { id: true }, + }); + + if (!tool) { + return NextResponse.json({ error: 'Tool not found' }, { status: 404 }); + } + + // Fetch recent simulations with token usage + const simulations = await prisma.simulation.findMany({ + where: { toolId: tool.id }, + include: { + tokenUsage: true, + }, + orderBy: { createdAt: 'desc' }, + take: 10, + }); + + return NextResponse.json({ simulations }); + } catch (error) { + console.error('Simulations endpoint error:', error); + return NextResponse.json( + { + error: error instanceof Error ? error.message : 'Internal server error', + }, + { status: 500 } + ); + } +} diff --git a/apps/web/src/app/tool/[...slug]/page.tsx b/apps/web/src/app/tool/[...slug]/page.tsx index df763fb..37f9d5c 100644 --- a/apps/web/src/app/tool/[...slug]/page.tsx +++ b/apps/web/src/app/tool/[...slug]/page.tsx @@ -12,6 +12,7 @@ import Link from 'next/link'; import { useEffect, useState } from 'react'; import { Markdown } from '../../../components/Markdown'; import { ThemeToggle } from '../../../components/ThemeToggle'; +import { ToolPlayground } from '../../../components/ToolPlayground'; interface Tool { id: string; @@ -241,6 +242,10 @@ export default function ToolDetailPage({
{/* Left column - Main content */}
+ {/* Interactive Playground */} + {/* biome-ignore lint/suspicious/noExplicitAny: Prisma Tool type compatibility with component props */} + + {/* Installation */} diff --git a/apps/web/src/components/TokenBreakdown.tsx b/apps/web/src/components/TokenBreakdown.tsx new file mode 100644 index 0000000..93aa84f --- /dev/null +++ b/apps/web/src/components/TokenBreakdown.tsx @@ -0,0 +1,93 @@ +'use client'; + +/** + * TokenBreakdown component + * Visualizes token usage breakdown with horizontal bars + */ + +import type { TokenBreakdown as TokenData } from '@/lib/ai-agent/tool-executor-agent'; + +interface TokenBreakdownProps { + tokens: TokenData; +} + +interface TokenBar { + label: string; + tokens: number; + color: string; + bgColor: string; +} + +export function TokenBreakdown({ tokens }: TokenBreakdownProps): React.ReactElement { + const { inputTokens, toolDescTokens, schemaTokens, outputTokens, totalTokens, estimatedCost } = + tokens; + + const bars: TokenBar[] = [ + { + label: 'Input', + tokens: inputTokens, + color: 'bg-blue-500', + bgColor: 'bg-blue-100 dark:bg-blue-950', + }, + { + label: 'Tool Description', + tokens: toolDescTokens, + color: 'bg-purple-500', + bgColor: 'bg-purple-100 dark:bg-purple-950', + }, + { + label: 'Schema', + tokens: schemaTokens, + color: 'bg-green-500', + bgColor: 'bg-green-100 dark:bg-green-950', + }, + { + label: 'Output', + tokens: outputTokens, + color: 'bg-orange-500', + bgColor: 'bg-orange-100 dark:bg-orange-950', + }, + ]; + + const getPercentage = (value: number): number => { + if (totalTokens === 0) return 0; + return (value / totalTokens) * 100; + }; + + return ( +
+
+ {bars.map((bar) => { + const percentage = getPercentage(bar.tokens); + return ( +
+
+ {bar.label} + + {bar.tokens.toLocaleString()} tokens ({percentage.toFixed(1)}%) + +
+
+
+
+
+ ); + })} +
+ +
+
+ Total Tokens + {totalTokens.toLocaleString()} +
+
+ Estimated Cost + ${estimatedCost.toFixed(4)} +
+
+
+ ); +} diff --git a/apps/web/src/components/ToolPlayground.tsx b/apps/web/src/components/ToolPlayground.tsx new file mode 100644 index 0000000..a04685f --- /dev/null +++ b/apps/web/src/components/ToolPlayground.tsx @@ -0,0 +1,380 @@ +'use client'; + +/** + * ToolPlayground component + * Interactive playground for executing TPMJS tools with AI agents + */ + +import type { TokenBreakdown as TokenData } from '@/lib/ai-agent/tool-executor-agent'; +import type { Tool } from '@tpmjs/db'; +import { useState } from 'react'; +import { TokenBreakdown } from './TokenBreakdown'; + +interface ToolPlaygroundProps { + tool: Tool; +} + +type Tab = 'input' | 'output' | 'logs' | 'tokens'; + +interface ExecutionLog { + level: 'info' | 'warning' | 'error' | 'debug'; + message: string; + timestamp: Date; +} + +export function ToolPlayground({ tool }: ToolPlaygroundProps): React.ReactElement { + const [activeTab, setActiveTab] = useState('input'); + const [prompt, setPrompt] = useState(''); + const [isExecuting, setIsExecuting] = useState(false); + const [output, setOutput] = useState(''); + const [logs, setLogs] = useState([]); + const [tokens, setTokens] = useState(null); + const [error, setError] = useState(null); + const [rateLimitInfo, setRateLimitInfo] = useState<{ remaining: number } | null>(null); + + const handleExecute = async () => { + if (!prompt.trim() || isExecuting) return; + + setIsExecuting(true); + setOutput(''); + setError(null); + setLogs([]); + setTokens(null); + setActiveTab('output'); + + try { + const response = await fetch( + `/api/tools/${encodeURIComponent(tool.npmPackageName)}/execute`, + { + method: 'POST', + headers: { + 'Content-Type': 'application/json', + }, + body: JSON.stringify({ prompt }), + } + ); + + // Check rate limit headers + const remaining = response.headers.get('X-RateLimit-Remaining'); + if (remaining) { + setRateLimitInfo({ remaining: Number.parseInt(remaining, 10) }); + } + + if (!response.ok) { + const errorData = await response.json(); + throw new Error(errorData.error || 'Execution failed'); + } + + // Handle SSE stream + const reader = response.body?.getReader(); + const decoder = new TextDecoder(); + + if (!reader) { + throw new Error('No response body'); + } + + let buffer = ''; + + while (true) { + const { done, value } = await reader.read(); + + if (done) break; + + buffer += decoder.decode(value, { stream: true }); + const lines = buffer.split('\n'); + buffer = lines.pop() || ''; + + for (const line of lines) { + if (line.startsWith('event:')) { + const event = line.slice(6).trim(); + const nextLine = lines.shift(); + + if (nextLine?.startsWith('data:')) { + const data = JSON.parse(nextLine.slice(5).trim()); + + switch (event) { + case 'chunk': + setOutput((prev) => prev + data.text); + setLogs((prev) => [ + ...prev, + { + level: 'info', + message: `Streaming: ${data.text.slice(0, 50)}${data.text.length > 50 ? '...' : ''}`, + timestamp: new Date(), + }, + ]); + break; + + case 'tokens': + setTokens(data as TokenData); + setLogs((prev) => [ + ...prev, + { + level: 'debug', + message: `Token update: ${data.totalTokens || 0} total tokens`, + timestamp: new Date(), + }, + ]); + break; + + case 'complete': + setOutput(data.output); + setTokens(data.tokenBreakdown); + setLogs((prev) => [ + ...prev, + { + level: 'info', + message: `Execution completed in ${data.executionTimeMs}ms with ${data.agentSteps} agent steps`, + timestamp: new Date(), + }, + ]); + break; + + case 'error': + setError(data.message); + setLogs((prev) => [ + ...prev, + { + level: 'error', + message: data.message, + timestamp: new Date(), + }, + ]); + break; + } + } + } + } + } + } catch (err) { + const message = err instanceof Error ? err.message : 'Unknown error'; + setError(message); + setLogs((prev) => [ + ...prev, + { + level: 'error', + message, + timestamp: new Date(), + }, + ]); + } finally { + setIsExecuting(false); + } + }; + + const tabs: { id: Tab; label: string; badge?: string }[] = [ + { id: 'input', label: 'Input' }, + { id: 'output', label: 'Output', badge: output ? 'โœ“' : undefined }, + { id: 'logs', label: 'Logs', badge: logs.length > 0 ? logs.length.toString() : undefined }, + { id: 'tokens', label: 'Token Usage', badge: tokens ? 'โœ“' : undefined }, + ]; + + const getLevelBadgeColor = (level: ExecutionLog['level']) => { + switch (level) { + case 'info': + return 'bg-blue-100 text-blue-700 dark:bg-blue-950 dark:text-blue-400'; + case 'warning': + return 'bg-yellow-100 text-yellow-700 dark:bg-yellow-950 dark:text-yellow-400'; + case 'error': + return 'bg-red-100 text-red-700 dark:bg-red-950 dark:text-red-400'; + case 'debug': + return 'bg-gray-100 text-gray-700 dark:bg-gray-800 dark:text-gray-400'; + } + }; + + return ( +
+ {/* Header */} +
+
+
+

Interactive Playground

+

+ Test {tool.npmPackageName} with AI-powered execution +

+
+ {rateLimitInfo && ( +
+ {rateLimitInfo.remaining} executions remaining +
+ )} +
+
+ + {/* Tabs */} +
+
+ {tabs.map((tab) => ( + + ))} +
+
+ + {/* Tab Content */} +
+ {activeTab === 'input' && ( +
+
+ +
+ {children} + + {children} +