feat: add license files for JavaScript assets and implement DocItem component

- Added LICENSE.txt file for JavaScript assets in the build directory, including licenses for NProgress and React libraries.
- Introduced a new runtime JavaScript file for handling module loading.
- Created a new DocItem component to manage document rendering and metadata handling in the Docusaurus theme.
- Implemented tests for the docs proxy server to ensure proper routing to the configured docsPort.
This commit is contained in:
catlog22
2026-02-06 10:25:24 +08:00
parent f9188eb0b6
commit a9b9ec48f1
91 changed files with 780 additions and 217 deletions

View File

@@ -25,6 +25,10 @@ export async function serveCommand(options: ServeOptions): Promise<void> {
// --new flag is shorthand for --frontend react
const frontend = options.new ? 'react' : (options.frontend || 'js');
// Keep Vite dev-server proxy aligned with the dashboard server port for direct access
// (e.g. when opening http://localhost:{reactPort} instead of the proxied /react/ path).
process.env.VITE_BACKEND_PORT = port.toString();
// Validate project path
let initialPath = process.cwd();
if (options.path) {
@@ -55,14 +59,17 @@ export async function serveCommand(options: ServeOptions): Promise<void> {
}
// Start Docusaurus docs site if React frontend is enabled
// The docs site is proxied through Vite at /docs endpoint
// The docs site is proxied at /docs (via the CCW dashboard server and also via Vite in dev)
let docsPort: number | undefined;
if (frontend === 'react' || frontend === 'both') {
const preferredDocsPort = Number(process.env.CCW_DOCS_PORT) || 3001;
try {
await startDocsSite(3001);
docsPort = await startDocsSite(preferredDocsPort);
} catch (error) {
console.log(chalk.yellow(`\n Warning: Failed to start docs site: ${error}`));
console.log(chalk.gray(` The /docs endpoint will not be available.`));
console.log(chalk.gray(` You can start it manually: cd ccw/docs-site && npm run serve -- --build --port 3001 --no-open\n`));
console.log(chalk.gray(` You can start it manually: cd ccw/docs-site && npm run serve -- --build --port ${preferredDocsPort} --no-open\n`));
docsPort = preferredDocsPort;
}
}
@@ -74,7 +81,8 @@ export async function serveCommand(options: ServeOptions): Promise<void> {
host,
initialPath,
frontend,
reactPort
reactPort,
docsPort
});
const boundUrl = `http://${host}:${port}`;
@@ -91,10 +99,18 @@ export async function serveCommand(options: ServeOptions): Promise<void> {
if (frontend === 'both') {
console.log(chalk.gray(` JS Frontend: ${boundUrl}`));
console.log(chalk.gray(` React Frontend: http://${host}:${reactPort}`));
console.log(chalk.gray(` Docs: http://${host}:${reactPort}/docs/`));
console.log(chalk.gray(` Docs: ${browserUrl}/docs/`));
console.log(chalk.gray(` Docs (zh): ${browserUrl}/docs/zh/`));
if (docsPort) {
console.log(chalk.gray(` Docs server: http://localhost:${docsPort}/docs/`));
}
} else if (frontend === 'react') {
console.log(chalk.gray(` React Frontend: http://${host}:${reactPort}`));
console.log(chalk.gray(` Docs: http://${host}:${reactPort}/docs/`));
console.log(chalk.gray(` Docs: ${browserUrl}/docs/`));
console.log(chalk.gray(` Docs (zh): ${browserUrl}/docs/zh/`));
if (docsPort) {
console.log(chalk.gray(` Docs server: http://localhost:${docsPort}/docs/`));
}
}
// Open browser