@livon/config 0.27.0-rc.1

package/README.md

@@ -0,0 +1,8 @@
+# @livon/config Redirect
+
+Canonical source moved to Docusaurus:
+
+- `/docs/packages/config`
+- File source: `website/docs/packages/config.md`
+
+This file is a compatibility redirect only.

package/eslint/README.md

@@ -0,0 +1,7 @@
+# @livon/config/eslint Redirect
+
+Canonical source moved to Docusaurus:
+
+- `/docs/packages/config`
+
+This file is a compatibility redirect only.

package/eslint/base.cjs

@@ -0,0 +1,68 @@
+/**
+ * Shared ESLint base config exported by `@livon/config/eslint/base.cjs`.
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+module.exports = [
+  {
+    ignores: ["dist", "build", "coverage", "node_modules"],
+  },
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    languageOptions: {
+      parser: require("@typescript-eslint/parser"),
+      parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "module",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": require("@typescript-eslint/eslint-plugin"),
+    },
+    rules: {
+      "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+      "@typescript-eslint/no-explicit-any": "error",
+      "@typescript-eslint/consistent-type-definitions": ["warn", "interface"],
+      "no-var": "error",
+      "prefer-const": "error",
+      "prefer-object-spread": "error",
+      "max-params": ["warn", 2],
+      "func-style": ["warn", "expression", { "allowArrowFunctions": true }],
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector: "ForStatement",
+          message: "Use declarative array methods instead of for-loops.",
+        },
+        {
+          selector: "ForInStatement",
+          message: "Use Object.entries/keys with declarative methods instead of for..in.",
+        },
+        {
+          selector: "ForOfStatement",
+          message: "Use declarative array methods instead of for..of.",
+        },
+        {
+          selector: "WhileStatement",
+          message: "Use recursion or declarative iteration instead of while.",
+        },
+        {
+          selector: "DoWhileStatement",
+          message: "Use recursion or declarative iteration instead of do..while.",
+        },
+        {
+          selector: "ClassDeclaration",
+          message: "Use functional modules and data, not classes.",
+        },
+        {
+          selector: "ClassExpression",
+          message: "Use functional modules and data, not classes.",
+        },
+        {
+          selector: "ThisExpression",
+          message: "Do not use this; pass explicit inputs through parameters/closures.",
+        },
+      ]
+    }
+  }
+];

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@livon/config",
+  "version": "0.27.0-rc.1",
+  "private": false,
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    "eslint",
+    "rsbuild",
+    "rslib",
+    "rspack",
+    "swc",
+    "tsconfig",
+    "vitest"
+  ],
+  "exports": {
+    "./tsconfig/base.json": "./tsconfig/base.json",
+    "./tsconfig/library.json": "./tsconfig/library.json",
+    "./tsconfig/app.json": "./tsconfig/app.json",
+    "./eslint/base.cjs": "./eslint/base.cjs",
+    "./swc/base.json": "./swc/base.json",
+    "./rspack/base": "./rspack/base.ts",
+    "./rsbuild/base": "./rsbuild/base.ts",
+    "./rslib/base": "./rslib/base.ts",
+    "./vitest/base": "./vitest/base.ts",
+    "./vitest/base.cjs": "./vitest/base.cjs"
+  },
+  "scripts": {
+    "build": "true",
+    "build:watch": "true",
+    "dev": "true",
+    "lint": "true",
+    "typecheck": "true",
+    "test": "true",
+    "test:unit": "true",
+    "test:integration": "true"
+  }
+}

package/rsbuild/README.md

@@ -0,0 +1,7 @@
+# @livon/config/rsbuild Redirect
+
+Canonical source moved to Docusaurus:
+
+- `/docs/packages/config`
+
+This file is a compatibility redirect only.

package/rsbuild/base.ts

@@ -0,0 +1,50 @@
+/**
+ * Shared Rsbuild base config helpers exported by `@livon/config`.
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+import { defineConfig } from '@rsbuild/core';
+import { pluginReact } from '@rsbuild/plugin-react';
+
+/**
+ * Creates a reusable React-focused Rsbuild configuration.
+ *
+ * @example
+ * ```ts
+ * import { createRsbuildReactConfig } from '@livon/config/rsbuild';
+ *
+ * export default createRsbuildReactConfig({
+ *   entry: './src/index.tsx',
+ *   template: './public/index.html',
+ * });
+ * ```
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+export const createRsbuildReactConfig = ({
+  entry,
+  template,
+}: {
+  entry: string;
+  template: string;
+}) => {
+  return defineConfig({
+    dev: {
+      clearScreen: false,
+    },
+    plugins: [pluginReact()],
+    html: {
+      template,
+    },
+    source: {
+      entry: {
+        index: entry,
+      },
+    },
+    output: {
+      distPath: {
+        root: 'dist',
+      },
+    },
+  });
+};

package/rslib/README.md

@@ -0,0 +1,7 @@
+# @livon/config/rslib Redirect
+
+Canonical source moved to Docusaurus:
+
+- `/docs/packages/config`
+
+This file is a compatibility redirect only.

package/rslib/base.ts

@@ -0,0 +1,68 @@
+/**
+ * Shared Rslib base config helpers exported by `@livon/config`.
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+import { defineConfig, type ConfigParams } from '@rslib/core';
+
+type RslibTarget = 'node' | 'web';
+type RslibFormat = 'esm' | 'cjs';
+
+interface CreateRslibConfigInput {
+  target: RslibTarget;
+  formats: ReadonlyArray<RslibFormat>;
+}
+
+interface ResolveFormatsInput {
+  command: ConfigParams['command'];
+  formats: ReadonlyArray<RslibFormat>;
+}
+
+const resolveFormats = ({ command, formats }: ResolveFormatsInput): ReadonlyArray<RslibFormat> => {
+  if (command !== 'dev') {
+    return formats;
+  }
+
+  const devFormats = formats.filter((format) => format === 'esm');
+  return devFormats.length > 0 ? devFormats : formats;
+};
+
+/**
+ * Creates a reusable Rslib configuration with deterministic dev format selection.
+ *
+ * @example
+ * ```ts
+ * import { createRslibConfig } from '@livon/config/rslib';
+ *
+ * export default createRslibConfig({
+ *   target: 'node',
+ *   formats: ['esm', 'cjs'],
+ * });
+ * ```
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+export const createRslibConfig = ({ target, formats }: CreateRslibConfigInput) => {
+  return defineConfig(({ command }) => {
+    const selectedFormats = resolveFormats({ command, formats });
+
+    return {
+      dev: {
+        clearScreen: false,
+      },
+      lib: selectedFormats.map((format) => {
+        return {
+          format,
+          syntax: 'es2021',
+          dts: true,
+          bundle: false,
+        };
+      }),
+      output: {
+        target,
+        distPath: 'dist',
+        cleanDistPath: false,
+      },
+    };
+  });
+};

package/rspack/README.md

@@ -0,0 +1,7 @@
+# @livon/config/rspack Redirect
+
+Canonical source moved to Docusaurus:
+
+- `/docs/packages/config`
+
+This file is a compatibility redirect only.

package/rspack/base.ts

@@ -0,0 +1,92 @@
+/**
+ * Shared Rspack base config helpers exported by `@livon/config`.
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+import { type Configuration, HtmlRspackPlugin } from '@rspack/core';
+import ReactRefreshRspackPlugin from '@rspack/plugin-react-refresh';
+import path from 'node:path';
+
+/**
+ * Creates a reusable React-focused Rspack configuration.
+ *
+ * @example
+ * ```ts
+ * import { createRspackReactConfig } from '@livon/config/rspack';
+ *
+ * export default createRspackReactConfig({
+ *   entry: './src/index.tsx',
+ *   template: './public/index.html',
+ *   port: 3000,
+ * });
+ * ```
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+export const createRspackReactConfig = ({
+  entry,
+  template,
+  port = 3000,
+}: {
+  entry: string;
+  template: string;
+  port?: number;
+}): Configuration => {
+  return {
+    mode: 'development',
+    entry: {
+      index: entry,
+    },
+    output: {
+      path: path.resolve(process.cwd(), 'dist'),
+    },
+    module: {
+      rules: [
+        {
+          test: /\.(t|j)sx?$/,
+          use: [
+            {
+              loader: 'builtin:swc-loader',
+              options: {
+                jsc: {
+                  parser: {
+                    syntax: 'typescript',
+                    tsx: true,
+                  },
+                  transform: {
+                    react: {
+                      runtime: 'automatic',
+                      refresh: true,
+                    },
+                  },
+                },
+              },
+            },
+          ],
+        },
+        {
+          test: /\.css$/,
+          type: 'css',
+        },
+      ],
+    },
+    resolve: {
+      extensions: ['.ts', '.tsx', '.js'],
+    },
+    plugins: [
+      new HtmlRspackPlugin({ template }),
+      new ReactRefreshRspackPlugin(),
+    ],
+    stats: {
+      logging: 'info',
+    },
+    devServer: {
+      port,
+      open: false,
+      hot: true,
+      client: {
+        logging: 'info',
+      },
+    },
+  };
+};

package/swc/README.md

@@ -0,0 +1,7 @@
+# @livon/config/swc Redirect
+
+Canonical source moved to Docusaurus:
+
+- `/docs/packages/config`
+
+This file is a compatibility redirect only.

package/swc/base.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://swc.rs/schema.json",
+  "jsc": {
+    "parser": {
+      "syntax": "typescript",
+      "tsx": true,
+      "decorators": false
+    },
+    "target": "es2021",
+    "minify": {
+      "compress": false,
+      "mangle": false
+    }
+  },
+  "module": {
+    "type": "nodenext"
+  },
+  "sourceMaps": true
+}

package/tsconfig/README.md

@@ -0,0 +1,7 @@
+# @livon/config/tsconfig Redirect
+
+Canonical source moved to Docusaurus:
+
+- `/docs/packages/config`
+
+This file is a compatibility redirect only.

package/tsconfig/app.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "types": [],
+    "noEmit": true
+  }
+}

package/tsconfig/base.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler", 
+    "strict": true,
+    "noImplicitAny": true,
+    "noUncheckedIndexedAccess": true,
+    "noFallthroughCasesInSwitch": true,
+    "useDefineForClassFields": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "skipLibCheck": true
+  }
+}

package/tsconfig/library.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["ES2022"],
+    "types": [],
+    "noEmit": true
+  }
+}

package/vitest/README.md

@@ -0,0 +1,7 @@
+# @livon/config/vitest Redirect
+
+Canonical source moved to Docusaurus:
+
+- `/docs/packages/config`
+
+This file is a compatibility redirect only.

package/vitest/base.cjs

@@ -0,0 +1,54 @@
+/**
+ * Shared Vitest base config helpers exported by `@livon/config/vitest/base.cjs`.
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+
+/**
+ * Creates a reusable Vitest config for unit or integration projects.
+ *
+ * @example
+ * ```js
+ * const { createVitestConfig } = require('@livon/config/vitest/base.cjs');
+ *
+ * module.exports = createVitestConfig({ type: 'unit' });
+ * ```
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ *
+ * @param {{ type: 'unit' | 'integration' }} input
+ * @returns {{
+ *   test: {
+ *     include: string[];
+ *     exclude: string[];
+ *     environment: string;
+ *     globals: boolean;
+ *     coverage: {
+ *       provider: string;
+ *       reporter: string[];
+ *       exclude: string[];
+ *     };
+ *   };
+ * }}
+ */
+const createVitestConfig = (input) => {
+  const mockExcludes = ['**/testing/mocks/**', '**/__mocks__/**'];
+
+  return {
+    test: {
+      include: input.type === 'unit' ? ['src/**/*.spec.ts'] : ['tests/**/*.spec.ts'],
+      exclude: mockExcludes,
+      environment: 'node',
+      globals: false,
+      coverage: {
+        provider: 'v8',
+        reporter: ['text', 'html'],
+        exclude: mockExcludes,
+      },
+    },
+  };
+};
+
+module.exports = {
+  createVitestConfig,
+};

package/vitest/base.ts

@@ -0,0 +1,58 @@
+/**
+ * Shared Vitest base config helpers exported by `@livon/config`.
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+type VitestProjectType = 'unit' | 'integration';
+
+export interface VitestConfigInput {
+  type: VitestProjectType;
+}
+
+export interface VitestCoverageConfig {
+  provider: string;
+  reporter: string[];
+  exclude: string[];
+}
+
+export interface VitestTestConfig {
+  include: string[];
+  exclude: string[];
+  environment: string;
+  globals: boolean;
+  coverage: VitestCoverageConfig;
+}
+
+export interface VitestConfig {
+  test: VitestTestConfig;
+}
+
+/**
+ * Creates a reusable Vitest config for unit or integration projects.
+ *
+ * @example
+ * ```ts
+ * import { createVitestConfig } from '@livon/config/vitest';
+ *
+ * export default createVitestConfig({ type: 'unit' });
+ * ```
+ *
+ * @see https://live-input-vector-output-node.github.io/livon-ts/docs/packages/config
+ */
+export const createVitestConfig = (input: VitestConfigInput): VitestConfig => {
+  const mockExcludes = ['**/testing/mocks/**', '**/__mocks__/**'];
+
+  return {
+    test: {
+      include: input.type === 'unit' ? ['src/**/*.spec.ts'] : ['tests/**/*.spec.ts'],
+      exclude: mockExcludes,
+      environment: 'node',
+      globals: false,
+      coverage: {
+        provider: 'v8',
+        reporter: ['text', 'html'],
+        exclude: mockExcludes,
+      },
+    },
+  };
+};