WORK IN PROGRESS - init nextjs UI renewal

[kevincobain2000]

DONEs

• Initiated Nextjs as npx create-next-app@latest --ts ui
• Investigated Nextjs --turbo, unable to use, because basePath: is not supported inside next.config.js.
• Updated Nextjs's base path in next.config.js to /vendor/request-docs/ for UI and /vendor/request-docs/api/sample for sample API. Dev environment available via npm run dev on http://localhost:3000/vendor/request-docs/. Also added sample response inside sample.ts for development of UI.
• Updated Nextjs's export path in package.json to next export -o ../resources/dist/", which is Laravel's resource dir
• Updated composer.json to publish static site of Nextjs to Laravel's vendor public as php artisan vendor:publish --tag=request-docs-assets --force. This step is important so that Nextjs's static js is available publicly for Laravel for the base path.
• Added .github/nextjs.yml.
• Updated index.blade, to render the Nextjs's static site from Laravel's public/vendor/request-docs/index.html. No impact on middleware for LRD, as everything goes through Laravel.
• Updated LaravelRequestDocsController to have json response on json=true for Laravel. Since blade is not only going to render Nextjs.

TODOs

• Add .github/release.yml, so that upon merging to master branch, npm run export can git push the generated static site to the resources/dist/ folder to master.

Backend

@kevincobain2000 and @kitloong

• Revisit sorting and grouping grouping apis matching a certain pattern for readability #102
• Revisit config and remove unwanted configs
• update README screenshots #53
• Read and Identity Enums #80
• Replace current pngs in README with mermaid #75
• Add new command php artisan lrd:install that can force publish the --tag=request-docs-assets --force resources/dist to vendor/public/request-docs how to guide
• Support response type base on returned Resource #71 (comment)
• Question: How to activate SQL debugging? #109 seperate the gzip and sql logging middlewares
• integration with liveware #112 livewire needs attention

Frontend

@truongns

• Develop modern UI Modernise UI - make UI similar to other Laravel dashboards such as Nova, Filament etc. #77 #
• Update README for frontend
• highlight card and dim others on select? #52
• Ignoring of request headers #67
• sample.ts is the first response for LRD information. Add 200-response.ts etc..for development purposes, since LRD returns sql queries and response time as well.
• Add loading bar & notification when API calls finished

Features

• Dark mode

Also fixes

• Route list doesn't display correctly in Safari #107

[kevincobain2000]

We started this pull req using Nextjs 13, but it gave us hard time with the export to static as it was still under work in progress by Vercel team.

Since much of development was done on Nextjs 13's norm, it was hard to go back to Next 12 to just be able to export.

Using Astro.js and react instead.
This pull req spent time on design and layouts, which is taken over to Astro.js here #124

Plus with Astro the exported static has much more manageable assets, which we can serve via Laravel behind middlewares, so that users don't need to do a vendor:publish and continue to work with the base path.

PS: Will keep this branch as it is, in case we migrate from Astrojs to Nextjs, because Javascript world is the world I can never predict.

[kevincobain2000]

Major changes in #124

Change 1: The reason to choose Ace in #124 instead of monaco editor as this pull req has, is because of the bundle size was over 1MB for monaco editor alone. Therefore, choosing a light weight.
Change 2: Instead of multiple themes, just providing light and dark should be enough