.editorconfig

@@ -12,8 +12,5 @@ trim_trailing_whitespace = true
 indent_style = tab
 indent_size = 4
 
-[*.sln]
-indent_style = tab
-
 [*.{md,mdx}]
 trim_trailing_whitespace = false

.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      major:
+        update-types: [ "major" ]
+      prod-deps:
+        dependency-type: "production"
+      dev-deps:
+        dependency-type: "development"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/create-pullrequest-prerelease.yml

@@ -0,0 +1,47 @@
+name: Create Pull Request Prerelease
+
+on: pull_request
+
+jobs:
+  build:
+    if: ${{ github.repository_owner == 'cloudflare' }}
+    name: Build & Publish a Prerelease to the Adhoc Registry
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: "npm"
+
+      - run: npm install --frozen-lockfile
+      - run: npm run build
+
+      - name: Create package
+        run: npm pack
+
+      - name: Upload packaged chanfana artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: npm-package-chanfana-${{ github.event.number }} # encode the PR number into the artifact name
+          path: chanfana-*.tgz
+
+      - name: 'Comment on PR with Link'
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          number: ${{ env.WORKFLOW_RUN_PR }}
+          message: |
+            🧪 A prerelease is available for testing 🧪
+
+            You can install this latest build in your project with:
+
+            ```sh
+            npm install --save https://prerelease-registry.devprod.cloudflare.dev/chanfana/runs/${{ github.run_id }}/npm-package-chanfana-${{ github.event.number }}
+            ```
+
+            Or you can immediately run this with `npx`:
+
+            ```sh
+            npx https://prerelease-registry.devprod.cloudflare.dev/chanfana/runs/${{ github.run_id }}/npm-package-chanfana-${{ github.event.number }}
+            ```

.github/workflows/publish.yml

@@ -1,40 +1,29 @@
-name: Release & Publish
-
+name: Publish
 on:
+  workflow_dispatch:
   push:
     tags:
       - 'v*'
 
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
 jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - name: Setup .npmrc file to publish to npm
-        uses: actions/setup-node@v1
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: '14.x'
+          node-version: 22.x
+          cache: 'npm'
           registry-url: 'https://registry.npmjs.org'
-      - name: Set RELEASE_VERSION
-        run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
-      - name: Apply new version
-        run: node config/preparePublish.js
       - name: Install modules
         run: npm install
-      - name: Build
-        run: npm run build
+      - name: Run build
+        run: npm run lint && npm run build
+      - name: Run tests
+        run: npm run test
       - name: Publish to npm
         run: npm publish --access public
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}
-      - name: Setup .npmrc file to publish to GitHub Packages
-        uses: actions/setup-node@v1
-        with:
-          node-version: '14.x'
-          registry-url: 'https://npm.pkg.github.com'
-          scope: '@cloudflare'
-#      - run: npm run addscope
-#      - name: Publish to GitHub Packages
-#        run: npm publish
-#        env:
-#          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.WRANGLER_PUBLISHER_NPM_TOKEN }}

.github/workflows/semgrep.yml

@@ -0,0 +1,24 @@
+on:
+  pull_request: {}
+  workflow_dispatch: {}
+  push: 
+    branches:
+      - main
+      - master
+  schedule:
+    - cron: '0 0 * * *'
+name: Semgrep config
+jobs:
+  semgrep:
+    name: semgrep/ci
+    runs-on: ubuntu-latest
+    env:
+      SEMGREP_APP_TOKEN: ${{ secrets.SEMGREP_APP_TOKEN }}
+      SEMGREP_URL: https://cloudflare.semgrep.dev
+      SEMGREP_APP_URL: https://cloudflare.semgrep.dev
+      SEMGREP_VERSION_CHECK_URL: https://cloudflare.semgrep.dev/api/check-version
+    container:
+      image: semgrep/semgrep
+    steps:
+      - uses: actions/checkout@v4
+      - run: semgrep ci

.github/workflows/test.yml

@@ -1,41 +1,20 @@
 name: Test
-
 on:
   push:
-    paths-ignore:
-      - 'docs/**'
-      - 'README.md'
-      - 'LICENSE'
-      - '.editorconfig'
-    branches:
-      - main
-  pull_request:
-    paths-ignore:
-      - 'docs/**'
-      - 'README.md'
-      - 'LICENSE'
-      - '.editorconfig'
     branches:
-      - main
+      - "**"
 
 jobs:
-  test:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os:
-          - ubuntu-latest
-        node: [12.x, 14.x, 16.x]
-
+  build:
+    runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - name: Set up Node.js
-        uses: actions/setup-node@v1
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: ${{ matrix.node }}
-      - name: Install modules
-        run: yarn
-      - name: Run build
-        run: yarn build
-#      - name: Run tests
-#        run: yarn test
+          node-version: 20.x
+          cache: "npm"
+
+      - run: npm install --frozen-lockfile
+      - run: npm run build
+      - run: npm run lint
+      - run: npm run test

.gitignore

@@ -1,4 +1,3 @@
-
 # Logs
 logs
 *.log
@@ -121,3 +120,6 @@ dist
 .idea/
 
 .DS_Store
+docs/site
+.wrangler
+.vitepress/cache

.husky/pre-commit

@@ -1,6 +1,2 @@
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-. "$(dirname "$0")/common.sh"
-
-npm run prettify
-#npm run test
+npm run lint
+npm run test

.vitepress/config.mts

@@ -0,0 +1,63 @@
+import {defineConfig} from 'vitepress'
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+  srcDir: './docs',
+  title: "chanfana",
+  description: "OpenAPI 3 and 3.1 schema generator and validator for Hono, itty-router and more!",
+  cleanUrls: true,
+  head: [['link', {rel: 'icon', type: "image/png", href: '/images/logo-icon.png'}]],
+  themeConfig: {
+    // https://vitepress.dev/reference/default-theme-config
+    logo: '/images/logo-icon.png',
+    nav: [
+      {text: 'Home', link: '/'},
+      {text: 'Docs', link: '/introduction'},
+      {text: 'Examples', link: '/examples-and-recipes'}
+    ],
+    sidebar: [
+      {
+        text: 'The Basics',
+        items: [
+          {text: 'Introduction', link: '/introduction'},
+          {text: 'Getting Started', link: '/getting-started'},
+          {text: 'Core Concepts', link: '/core-concepts'},
+          {text: 'Router Adapters', link: '/router-adapters'},
+          {text: 'Recipies', link: '/examples-and-recipies'},
+        ]
+      },
+      {
+        text: 'Endpoints',
+        items: [
+          {text: 'Defining Endpoints', link: '/endpoints/defining-endpoints'},
+          {text: 'Request Validation', link: '/endpoints/request-validation'},
+          {text: 'Response Definition', link: '/endpoints/response-definition'},
+          {text: 'Parameters', link: '/endpoints/parameters'},
+        ]
+      },
+      {
+        text: 'Auto Endpoints',
+        items: [
+          {text: "Base Auto Endpoints", link: '/endpoints/auto/base'},
+          {text: 'D1 Auto Endpoints', link: '/endpoints/auto/d1'},
+        ]
+      },
+      {
+        text: 'Advanced Stuff',
+        items: [
+          {text: 'Error Handling', link: '/error-handling'},
+          {text: 'OpenAPI Customization', link: '/openapi-configuration-customization'},
+          {text: 'Advanced Patterns', link: '/advanced-topics-patterns'},
+          {text: 'Troubleshooting And FAQ', link: '/troubleshooting-and-faq'},
+        ]
+      },
+    ],
+    socialLinks: [
+      {icon: 'github', link: 'https://github.com/cloudflare/chanfana'}
+    ],
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © 2024-present Cloudflare'
+    }
+  }
+})

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 Cloudflare
+Copyright (c) 2024 Cloudflare
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal