chore(examples): add React and Node.js examples

examples/express-plugin/README.md

@@ -0,0 +1,3 @@
+# @examples/express-plugin
+
+This example demonstrates how to use Rslib to build a simple Node.js package.

examples/express-plugin/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@examples/express-plugin",
+  "private": true,
+  "scripts": {
+    "build": "rslib build"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@rslib/core": "workspace:*",
+    "@types/express": "^4.17.21",
+    "express": "^4.19.2",
+    "typescript": "^5.5.3"
+  },
+  "peerDependencies": {
+    "express": "^4"
+  }
+}

examples/basic/rslib.config.ts → examples/express-plugin/rslib.config.ts

@@ -1,8 +1,16 @@
 import { defineConfig } from '@rslib/core';
 
+const shared = {
+  autoExtension: true,
+  dts: {
+    bundle: false,
+  },
+};
+
 export default defineConfig({
   lib: [
     {
+      ...shared,
       format: 'esm',
       output: {
         distPath: {
@@ -11,6 +19,7 @@ export default defineConfig({
       },
     },
     {
+      ...shared,
       format: 'cjs',
       output: {
         distPath: {
@@ -24,4 +33,10 @@ export default defineConfig({
       main: './src/index.ts',
     },
   },
+  output: {
+    externals: {
+      express: 'express',
+    },
+    target: 'node',
+  },
 });

examples/express-plugin/src/index.ts

@@ -0,0 +1,15 @@
+import type { RequestHandler } from 'express';
+import { logRequest } from './logger';
+import { type LoggerOptions, defaultOptions } from './types';
+
+export function expressLogger(
+  options: Partial<LoggerOptions> = {},
+): RequestHandler {
+  const mergedOptions = { ...defaultOptions, ...options };
+  return (req, res, next) => {
+    logRequest(req, mergedOptions);
+    next();
+  };
+}
+
+export * from './types';

examples/express-plugin/src/logger.ts

@@ -0,0 +1,25 @@
+import type { Request } from 'express';
+import type { LoggerOptions } from './types';
+
+export function logRequest(req: Request, options: LoggerOptions): void {
+  const { method, url } = req;
+  const logMessage = `${method} ${url}`;
+
+  switch (options.logLevel) {
+    case 'debug':
+      console.debug(logMessage);
+      break;
+    case 'warn':
+      console.warn(logMessage);
+      break;
+    case 'error':
+      console.error(logMessage);
+      break;
+    default:
+      console.log(logMessage);
+  }
+
+  if (options.logBody && req.body) {
+    console.log('Request body:', req.body);
+  }
+}

examples/express-plugin/src/types.ts

@@ -0,0 +1,9 @@
+export interface LoggerOptions {
+  logLevel: 'info' | 'debug' | 'warn' | 'error';
+  logBody: boolean;
+}
+
+export const defaultOptions: LoggerOptions = {
+  logLevel: 'info',
+  logBody: false,
+};

examples/express-plugin/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "compilerOptions": {
+    "strict": true
+  },
+  "include": ["src/**/*"]
+}

examples/react-component/README.md

@@ -0,0 +1,3 @@
+# @examples/react-component
+
+This example demonstrates how to use Rslib to build a simple React component.

examples/react-component/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@examples/react-component",
+  "private": true,
+  "scripts": {
+    "build": "rslib build"
+  },
+  "devDependencies": {
+    "@rsbuild/plugin-react": "1.0.1-beta.9",
+    "@rslib/core": "workspace:*",
+    "@types/react": "^18.3.3",
+    "react": "^18.3.1"
+  },
+  "peerDependencies": {
+    "react": "*"
+  }
+}

examples/react-component/rslib.config.ts

@@ -0,0 +1,44 @@
+import { pluginReact } from '@rsbuild/plugin-react';
+import { defineConfig } from '@rslib/core';
+
+const shared = {
+  autoExtension: true,
+  dts: {
+    bundle: false,
+  },
+};
+
+export default defineConfig({
+  lib: [
+    {
+      ...shared,
+      format: 'esm',
+      output: {
+        distPath: {
+          root: './dist/esm',
+        },
+      },
+    },
+    {
+      ...shared,
+      format: 'cjs',
+      output: {
+        distPath: {
+          root: './dist/cjs',
+        },
+      },
+    },
+  ],
+  source: {
+    entry: {
+      main: './src/index.tsx',
+    },
+  },
+  output: {
+    externals: {
+      react: 'react',
+      'react/jsx-runtime': 'react/jsx-runtime',
+    },
+  },
+  plugins: [pluginReact()],
+});

examples/react-component/src/CounterButton.tsx

@@ -0,0 +1,13 @@
+interface CounterButtonProps {
+  onClick: () => void;
+  label: string;
+}
+
+export const CounterButton: React.FC<CounterButtonProps> = ({
+  onClick,
+  label,
+}) => (
+  <button type="button" onClick={onClick}>
+    {label}
+  </button>
+);

examples/react-component/src/index.tsx

@@ -0,0 +1,14 @@
+import { CounterButton } from './CounterButton';
+import { useCounter } from './useCounter';
+
+export const Counter: React.FC = () => {
+  const { count, increment, decrement } = useCounter();
+
+  return (
+    <div>
+      <h2>Counter: {count}</h2>
+      <CounterButton onClick={decrement} label="-" />
+      <CounterButton onClick={increment} label="+" />
+    </div>
+  );
+};

examples/react-component/src/useCounter.tsx

@@ -0,0 +1,10 @@
+import { useState } from 'react';
+
+export const useCounter = (initialValue = 0) => {
+  const [count, setCount] = useState(initialValue);
+
+  const increment = () => setCount((prev) => prev + 1);
+  const decrement = () => setCount((prev) => prev - 1);
+
+  return { count, increment, decrement };
+};

examples/react-component/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "strict": true
+  },
+  "include": ["src/**/*"]
+}