@vef-framework/dev 2.0.11 → 2.1.0

package/dist/types/src/vite/plugin-auto-enhance/index.d.ts

@@ -0,0 +1,10 @@
+import { Plugin } from 'vite';
+import { AutoEnhanceOptions } from './types';
+/**
+ * Create auto-enhance plugin for AST transformations.
+ * Supports registering multiple sub-plugins to handle different code enhancement needs.
+ */
+export declare function createAutoEnhancePlugin({ plugins, ...options }?: AutoEnhanceOptions): Plugin;
+export * from './plugins';
+export type * from './types';
+export { types } from 'recast';

package/dist/types/src/vite/plugin-auto-enhance/plugins/operation-column-width.d.ts

@@ -0,0 +1,5 @@
+import { AutoEnhancePlugin } from '../types';
+/**
+ * Auto-calculate optimal width for operationColumn based on OperationButton components
+ */
+export declare const operationColumnWidthPlugin: AutoEnhancePlugin;

package/dist/types/{vite → src/vite}/plugin-auto-enhance/types.d.ts

@@ -4,7 +4,7 @@ import { types } from 'recast';
  */
 export interface AutoEnhanceContext {
     /**
-     * File ID
+     * File ID (full path)
      */
     id: string;
     /**
@@ -47,19 +47,17 @@ export interface AutoEnhancePlugin {
     description?: string;
     /**
      * Whether this file should be processed
-     *
-     * @param context Context information
-     * @returns Whether to process
      */
     shouldProcess?: (context: AutoEnhanceContext) => boolean;
     /**
      * Execute transformation
-     *
-     * @param context Context information
-     * @returns Transform result
      */
     transform: (context: AutoEnhanceContext) => TransformResult;
 }
+/**
+ * File pattern type for include/exclude options
+ */
+export type FilePattern = string | RegExp | Array<string | RegExp>;
 /**
  * Auto-enhance plugin configuration
  */
@@ -71,11 +69,11 @@ export interface AutoEnhanceOptions {
     /**
      * File filter, only process matching files
      */
-    include?: string | RegExp | Array<string | RegExp>;
+    include?: FilePattern;
     /**
      * File excluder, skip matching files
      */
-    exclude?: string | RegExp | Array<string | RegExp>;
+    exclude?: FilePattern;
     /**
      * Custom log prefix
      */

package/dist/types/{vite → src/vite}/plugin-conventional-config.d.ts

@@ -1,7 +1,4 @@
 import { Plugin, ProxyOptions } from 'vite';
-/**
- * The options of the vite plugin for the conventional config
- */
 export interface PluginConventionalConfigOptions {
     /**
      * The name of the app
@@ -33,16 +30,6 @@ export interface PluginConventionalConfigOptions {
     proxies?: Record<string, string | ProxyOptions>;
 }
 /**
- * The plugin for the conventional config
- *
- * @param options - The options of the plugin
- * @param options.appName - The name of the app
- * @param options.appVersion - The version of the app
- * @param options.basePublicPath - The base public path
- * @param options.projectDir - The directory of the project
- * @param options.outputDir - The output directory of the build
- * @param options.serverPort - The port of the server
- * @param options.proxies - The proxies of the server
- * @returns The plugin
+ * Create the conventional config plugin with VEF Framework defaults
  */
 export declare function createConventionalConfigPlugin({ appName, appVersion, basePublicPath, projectDir, outputDir, serverPort, proxies }: PluginConventionalConfigOptions): Plugin;

package/dist/types/src/vite/plugin-eslint.d.ts

@@ -0,0 +1,7 @@
+import { PluginOption } from 'vite';
+/**
+ * Create the ESLint plugin for development-time linting
+ *
+ * @returns The eslint plugin
+ */
+export declare function createEslintPlugin(): PluginOption;

package/dist/types/src/vite/plugin-html.d.ts

@@ -0,0 +1,7 @@
+import { PluginOption } from 'vite';
+/**
+ * Create the HTML virtual module plugin
+ *
+ * @returns The HTML plugin array
+ */
+export declare function createHtmlPlugin(): PluginOption;

package/dist/types/{vite → src/vite}/plugin-icons.d.ts

@@ -1,8 +1,8 @@
-import { Plugin } from 'vite';
+import { PluginOption } from 'vite';
 /**
- * Create the icons plugin
+ * Create the icons plugin for loading icon sets as React components
  *
  * @param projectDir - The project directory
  * @returns The icons plugin
  */
-export declare function createIconsPlugin(projectDir: string): Plugin<any> | Plugin<any>[];
+export declare function createIconsPlugin(projectDir: string): PluginOption;

package/dist/types/src/vite/plugin-injection.d.ts

@@ -0,0 +1,5 @@
+import { PluginOption } from 'vite';
+/**
+ * Create the injection plugin for code injection into entry files
+ */
+export declare function createInjectionPlugin(): PluginOption;

package/dist/types/src/vite/plugin-inspect.d.ts

@@ -0,0 +1,5 @@
+import { PluginOption } from 'vite';
+/**
+ * Create the inspect plugin for debugging Vite plugin transformations
+ */
+export declare function createInspectPlugin(): PluginOption;

package/dist/types/{vite → src/vite}/plugin-react.d.ts

@@ -1,5 +1,8 @@
-import { Options } from '@vitejs/plugin-react';
-import { Plugin } from 'vite';
+import { PluginOption } from 'vite';
+/**
+ * Babel plugin configuration type
+ */
+type BabelPlugin = string | [string, Record<string, unknown>];
 /**
  * The react plugin options
  */
@@ -15,11 +18,13 @@ export interface ReactPluginOptions {
     /**
      * The babel plugins to use
      */
-    babelPlugins?: NonNullable<Exclude<Options["babel"], (...args: any[]) => any>>["plugins"];
+    babelPlugins?: BabelPlugin[];
 }
 /**
- * The plugin to use react
+ * Create the React Vite plugin
  *
+ * @param options - Plugin configuration options
  * @returns The react plugin
  */
-export declare function createReactPlugin({ useEmotion, useCompiler, babelPlugins }?: ReactPluginOptions): Plugin<any>[];
+export declare function createReactPlugin({ useEmotion, useCompiler, babelPlugins }?: ReactPluginOptions): PluginOption;
+export {};

package/dist/types/src/vite/plugin-router.d.ts

@@ -0,0 +1,14 @@
+import { PluginOption } from 'vite';
+/**
+ * Router history mode type
+ */
+type HistoryMode = "hash" | "browser";
+/**
+ * Create the TanStack Router plugin for file-based routing
+ *
+ * @param projectDir - The project directory
+ * @param history - The history mode to use (hash or browser)
+ * @returns The router plugin
+ */
+export declare function createRouterPlugin(projectDir: string, history?: HistoryMode): PluginOption;
+export {};

package/dist/types/src/vite/plugin-stylelint.d.ts

@@ -0,0 +1,7 @@
+import { PluginOption } from 'vite';
+/**
+ * Create the Stylelint plugin for development-time style linting
+ *
+ * @returns The stylelint plugin
+ */
+export declare function createStylelintPlugin(): PluginOption;

package/dist/types/src/vite/plugin-svgr.d.ts

@@ -0,0 +1,7 @@
+import { PluginOption } from 'vite';
+/**
+ * Create the SVGR plugin for converting SVG files to React components
+ *
+ * @returns The svgr plugin
+ */
+export declare function createSvgrPlugin(): PluginOption;

package/dist/types/src/vite/plugin-tsconfig-paths.d.ts

@@ -0,0 +1,8 @@
+import { UserConfig } from 'vite';
+/**
+ * Vite 8 supports tsconfig path resolution natively via `resolve.tsconfigPaths`.
+ *
+ * This helper keeps the migration logic in one place without relying on the
+ * deprecated external plugin.
+ */
+export declare function createTsconfigPathsResolveConfig(): Pick<NonNullable<UserConfig["resolve"]>, "tsconfigPaths">;

package/dist/types/{vite → src/vite}/postcss.d.ts

@@ -1,9 +1,4 @@
 import { UserConfig } from 'vite';
 type PostcssConfig = Exclude<NonNullable<UserConfig["css"]>["postcss"], string | undefined>;
-/**
- * Create the postcss config
- *
- * @returns The postcss config
- */
 export declare function createPostcssConfig(): PostcssConfig;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vef-framework/dev",
   "type": "module",
-  "version": "2.0.11",
+  "version": "2.1.0",
   "private": false,
   "description": "Dev tools for VEF framework",
   "author": {
@@ -20,15 +20,10 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "source": "./src/index.ts",
-      "import": {
-        "types": "./dist/types/index.d.ts",
-        "default": "./dist/es/index.js"
-      },
-      "require": {
-        "types": "./dist/types/index.d.ts",
-        "default": "./dist/cjs/index.cjs"
-      }
+      "vef": "./src/index.ts",
+      "types": "./dist/types/src/index.d.ts",
+      "import": "./dist/es/index.js",
+      "require": "./dist/cjs/index.cjs"
     },
     "./types": {
       "types": "./types.d.ts"
@@ -38,7 +33,7 @@
   },
   "main": "dist/cjs/index.cjs",
   "module": "dist/es/index.js",
-  "types": "dist/types/index.d.ts",
+  "types": "dist/types/src/index.d.ts",
   "bin": {
     "vef": "bin/vef.js"
   },
@@ -55,81 +50,86 @@
   },
   "peerDependencies": {
     "@commitlint/cli": "^20.1.0",
-    "@stylistic/stylelint-config": "^3.0.1",
-    "eslint": "^9.39.1",
+    "@stylistic/stylelint-config": "^4.0.0",
+    "eslint": "^10.0.0",
     "husky": "^9.1.7",
-    "lint-staged": "^16.2.7",
-    "stylelint": "^16.26.0",
-    "stylelint-config-recess-order": "^7.4.0",
-    "stylelint-config-recommended": "^17.0.0",
-    "stylelint-config-standard-scss": "^16.0.0",
-    "stylelint-order": "^7.0.0",
-    "vite": "^7.2.4"
+    "lint-staged": "^16.0.0",
+    "stylelint": "^17.0.0",
+    "stylelint-config-recess-order": "^7.0.0",
+    "stylelint-config-recommended": "^18.0.0",
+    "stylelint-config-standard-scss": "^17.0.0",
+    "stylelint-order": "^8.0.0",
+    "vite": "^8.0.0"
   },
   "dependencies": {
-    "@babel/core": "^7.28.5",
-    "@babel/parser": "^7.28.5",
-    "@babel/traverse": "^7.28.5",
-    "@commitlint/config-conventional": "^20.0.0",
+    "@babel/core": "^7.29.0",
+    "@babel/parser": "^7.29.2",
+    "@babel/traverse": "^7.29.0",
+    "@commitlint/config-conventional": "^20.5.0",
     "@emotion/babel-plugin": "^11.13.5",
-    "@eslint-community/eslint-plugin-eslint-comments": "^4.5.0",
-    "@eslint-react/eslint-plugin": "^2.3.12",
-    "@eslint/js": "^9.39.1",
-    "@stylistic/eslint-plugin": "^5.6.1",
+    "@eslint-community/eslint-plugin-eslint-comments": "^4.7.1",
+    "@eslint-react/eslint-plugin": "^3.0.0",
+    "@eslint/js": "^10.0.1",
+    "@rolldown/plugin-babel": "^0.2.2",
+    "@stylistic/eslint-plugin": "^5.10.0",
     "@svgr/plugin-svgo": "^8.1.0",
-    "@tanstack/eslint-plugin-query": "^5.91.2",
-    "@tanstack/eslint-plugin-router": "^1.139.0",
-    "@tanstack/router-plugin": "^1.139.14",
-    "@vitejs/plugin-react": "^5.1.1",
+    "@tanstack/eslint-plugin-query": "^5.95.2",
+    "@tanstack/eslint-plugin-router": "^1.161.6",
+    "@tanstack/router-plugin": "^1.167.4",
+    "@typescript-eslint/utils": "^8.57.2",
+    "@vitejs/plugin-react": "^6.0.1",
     "babel-plugin-react-compiler": "1.0.0",
     "chalk": "^5.6.2",
-    "commander": "^14.0.2",
+    "commander": "^14.0.3",
     "consola": "^3.4.2",
-    "dotenv": "^17.2.3",
-    "eslint-config-flat-gitignore": "^2.1.0",
-    "eslint-plugin-antfu": "^3.1.1",
-    "eslint-plugin-format": "^1.1.0",
-    "eslint-plugin-import-lite": "^0.3.0",
-    "eslint-plugin-perfectionist": "^4.15.1",
+    "dotenv": "^17.3.1",
+    "eslint-config-flat-gitignore": "^2.3.0",
+    "eslint-plugin-antfu": "^3.2.2",
+    "eslint-plugin-format": "^2.0.1",
+    "eslint-plugin-import-lite": "^0.6.0",
+    "eslint-plugin-perfectionist": "^5.7.0",
+    "eslint-plugin-react-dom": "^3.0.0",
     "eslint-plugin-react-hooks": "7.0.1",
-    "eslint-plugin-react-refresh": "^0.4.24",
-    "eslint-plugin-regexp": "^2.10.0",
-    "eslint-plugin-unicorn": "^62.0.0",
-    "eslint-plugin-unused-imports": "^4.3.0",
+    "eslint-plugin-react-naming-convention": "^3.0.0",
+    "eslint-plugin-react-web-api": "^3.0.0",
+    "eslint-plugin-regexp": "^3.1.0",
+    "eslint-plugin-unicorn": "^63.0.0",
+    "eslint-plugin-unused-imports": "^4.4.1",
     "execa": "^9.6.1",
-    "fs-extra": "^11.3.2",
+    "fs-extra": "^11.3.4",
     "html-minifier-terser": "^7.2.0",
-    "ora": "^9.0.0",
+    "jotai-babel": "^0.1.0",
+    "ora": "^9.3.0",
     "prompts": "^2.4.2",
-    "radashi": "^12.7.1",
+    "radashi": "^12.7.2",
     "recast": "^0.23.11",
-    "sass-embedded": "^1.93.3",
-    "typescript-eslint": "^8.48.1",
+    "sass-embedded": "^1.98.0",
+    "typescript-eslint": "^8.57.2",
     "unplugin-config": "^0.1.5",
-    "unplugin-icons": "^22.5.0",
-    "vite-plugin-eslint2": "^5.0.4",
+    "unplugin-icons": "^23.0.1",
+    "vite-plugin-eslint2": "^5.1.0",
     "vite-plugin-inspect": "^11.3.3",
-    "vite-plugin-stylelint": "^6.0.2",
-    "vite-plugin-svgr": "^4.5.0",
-    "vite-tsconfig-paths": "^5.1.4"
+    "vite-plugin-stylelint": "^6.1.0",
+    "vite-plugin-svgr": "^4.5.0"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.1.0",
-    "@commitlint/types": "^20.0.0",
-    "@stylistic/stylelint-config": "^3.0.1",
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/types": "^20.5.0",
+    "@stylistic/stylelint-config": "^4.0.0",
     "@types/html-minifier-terser": "^7.0.2",
     "@types/prompts": "^2.4.9",
-    "eslint": "^9.39.1",
+    "eslint": "^10.1.0",
+    "eslint-plugin-jsdoc": "^62.8.0",
     "husky": "^9.1.7",
-    "lint-staged": "^16.2.7",
-    "stylelint": "^16.26.1",
-    "stylelint-config-recess-order": "^7.4.0",
-    "stylelint-config-recommended": "^17.0.0",
-    "stylelint-config-standard-scss": "^16.0.0",
-    "stylelint-order": "^7.0.0",
+    "lint-staged": "^16.4.0",
+    "stylelint": "^17.5.0",
+    "stylelint-config-recess-order": "^7.7.0",
+    "stylelint-config-recommended": "^18.0.0",
+    "stylelint-config-standard-scss": "^17.0.0",
+    "stylelint-order": "^8.1.1",
     "tsup": "^8.5.1",
-    "type-fest": "^5.3.0",
-    "vite": "^7.2.6"
+    "type-fest": "^5.5.0",
+    "vite": "^8.0.2"
   },
   "scripts": {
     "clean": "rimraf dist",

package/tsconfig.base.json

@@ -22,7 +22,6 @@
     "noErrorTruncation": true,
     "noEmit": true,
     "allowSyntheticDefaultImports": true,
-    "esModuleInterop": false,
     "forceConsistentCasingInFileNames": true,
     "isolatedModules": true,
     "verbatimModuleSyntax": true,

package/dist/types/lint/commitlint.d.ts

@@ -1,8 +0,0 @@
-import { UserConfig } from '@commitlint/types';
-/**
- * Defines a commitlint configuration that extends the conventional commit format.
- * This configuration ensures that commit messages follow the conventional commit specification.
- *
- * @returns A commitlint configuration object
- */
-export declare function defineCommitlintConfig(): UserConfig;

package/dist/types/lint/stylelint.d.ts

@@ -1,7 +0,0 @@
-import { Config } from 'stylelint';
-/**
- * Defines a stylelint configuration that extends the recommended configuration and uses the stylelint-order plugin.
- *
- * @returns The stylelint configuration object
- */
-export declare function defineStylelintConfig(): Config;

package/dist/types/vite/config.d.ts

@@ -1,39 +0,0 @@
-import { PluginOption, ProxyOptions, UserConfig, UserConfigExport } from 'vite';
-import { AutoEnhancePlugin } from './plugin-auto-enhance';
-import { ReactPluginOptions } from './plugin-react';
-/**
- * The options to define the vef config
- */
-export interface DefineConfigOptions {
-    /**
-     * The resolve config
-     */
-    resolve?: Pick<NonNullable<UserConfig["resolve"]>, "alias" | "conditions">;
-    /**
-     * The plugins to use
-     */
-    plugins?: PluginOption[];
-    /**
-     * The auto enhance plugins to use
-     */
-    autoEnhancePlugins?: AutoEnhancePlugin[];
-    /**
-     * The history mode to use for the router
-     */
-    routerHistory?: "hash" | "browser";
-    /**
-     * The react plugin options
-     */
-    react?: ReactPluginOptions;
-    /**
-     * The proxies of the dev server
-     */
-    proxies?: Record<string, string | ProxyOptions>;
-}
-/**
- * Define the vite config
- *
- * @param options - The options to define the vite config
- * @returns The vite config
- */
-export declare function defineViteConfig({ resolve, plugins, autoEnhancePlugins, routerHistory, react, proxies }?: DefineConfigOptions): UserConfigExport;

package/dist/types/vite/constants.d.ts

@@ -1,48 +0,0 @@
-/**
- * The version of the framework
- */
-export declare const VEF_FRAMEWORK_VERSION = "1.0.0";
-/**
- * The directory of the public files
- */
-export declare const PUBLIC_DIR = "public";
-/**
- * The directory of the environment files
- */
-export declare const ENV_DIR = "env";
-/**
- * The directory of the assets
- */
-export declare const ASSETS_DIR = "assets";
-/**
- * The prefix of the environment variables for the app
- */
-export declare const ENV_APP_PREFIX = "VEF_APP_";
-/**
- * The prefix of the environment variables for the build tools
- */
-export declare const ENV_BUILD_PREFIX = "VEF_BUILD_";
-/**
- * The directory of the source files
- */
-export declare const SRC_DIR = "src";
-/**
- * The default output directory of the build
- */
-export declare const DEFAULT_OUTPUT_DIR = "dist";
-/**
- * The default port of the dev server
- */
-export declare const DEFAULT_SERVER_PORT = 3833;
-/**
- * The default name of the app
- */
-export declare const DEFAULT_APP_NAME = "APP";
-/**
- * The directory of the pages
- */
-export declare const PAGES_DIR = "pages";
-/**
- * The directory of the router
- */
-export declare const ROUTER_DIR = "router";

package/dist/types/vite/define.d.ts

@@ -1,12 +0,0 @@
-/**
- * Define the constants
- *
- * @param appName - The name of the app
- * @param appVersion - The version of the app
- * @param isDev - Whether the app is in development mode
- */
-export declare function defineConstants(appName: string | undefined, appVersion: string, isDev: boolean): {
-    __VEF_FRAMEWORK_VERSION__: string;
-    __VEF_APP_VERSION__: string;
-    __VEF_APP_CONFIG__: string;
-};

package/dist/types/vite/plugin-app-config.d.ts

@@ -1,28 +0,0 @@
-import { Plugin } from 'vite';
-/**
- * The options for the app config plugin
- */
-export interface PluginAppConfigOptions {
-    /**
-     * The base public path
-     */
-    basePublicPath?: string;
-    /**
-     * The output directory of the build
-     */
-    outputDir?: string;
-    /**
-     * The name of the app
-     */
-    appName?: string;
-}
-/**
- * The plugin for the app config
- *
- * @param options - The options of the plugin
- * @param options.basePublicPath - The base public path
- * @param options.outputDir - The output directory of the build
- * @param options.appName - The name of the app
- * @returns The plugin
- */
-export declare function createAppConfigPlugin({ basePublicPath, outputDir, appName }: PluginAppConfigOptions): Plugin<any> | Plugin<any>[];

package/dist/types/vite/plugin-auto-enhance/index.d.ts

@@ -1,30 +0,0 @@
-import { Plugin } from 'vite';
-import { AutoEnhanceOptions } from './types';
-/**
- * Create auto-enhance plugin
- *
- * This is a micro-kernel architecture generic AST transformation plugin that supports
- * registering multiple sub-plugins to handle different code enhancement needs.
- *
- * @param options Plugin configuration options
- * @returns Vite plugin
- *
- * @example
- * ```typescript
- * import { createAutoEnhancePlugin } from "@vef-framework/dev";
- * import { operationColumnWidthPlugin } from "@vef-framework/dev";
- *
- * export default defineConfig({
- *   plugins: [
- *     createAutoEnhancePlugin({
- *       plugins: [operationColumnWidthPlugin],
- *       verbose: true
- *     })
- *   ]
- * });
- * ```
- */
-export declare function createAutoEnhancePlugin({ plugins, ...options }?: AutoEnhanceOptions): Plugin;
-export * from './plugins';
-export type * from './types';
-export { types } from 'recast';

package/dist/types/vite/plugin-auto-enhance/plugins/operation-column-width.d.ts

@@ -1,14 +0,0 @@
-import { AutoEnhancePlugin } from '../types';
-/**
- * Operation column width auto-calculation plugin
- *
- * Automatically calculates optimal width for operationColumn based on OperationButton components.
- * Works with any component using: operationColumn={{ render: () => <OperationButton>...</OperationButton> }}
- *
- * Validation rules:
- * 1. OperationButton must be imported from @vef-framework/components or @vef-framework/starter
- * 2. operationColumn value must be an ObjectExpression with render property
- * 3. render function must contain valid OperationButton components
- * 4. width must not already be defined
- */
-export declare const operationColumnWidthPlugin: AutoEnhancePlugin;

package/dist/types/vite/plugin-eslint.d.ts

@@ -1,7 +0,0 @@
-import { Plugin } from 'vite';
-/**
- * Create the eslint plugin
- *
- * @returns The eslint plugin
- */
-export declare function createEslintPlugin(): Plugin<any>;

package/dist/types/vite/plugin-html.d.ts

@@ -1,7 +0,0 @@
-import { Plugin } from 'vite';
-/**
- * The plugin to generate the html file
- *
- * @returns The plugin
- */
-export declare function createHtmlPlugin(): Plugin[];

package/dist/types/vite/plugin-injection.d.ts

@@ -1,7 +0,0 @@
-import { Plugin } from 'vite';
-/**
- * The plugin to inject the code into the main.ts file
- *
- * @returns The plugin
- */
-export declare function createInjectionPlugin(): Plugin;

package/dist/types/vite/plugin-inspect.d.ts

@@ -1,7 +0,0 @@
-import { Plugin } from 'vite';
-/**
- * Create the inspect plugin for inspecting the plugin modules
- *
- * @returns The inspect plugin
- */
-export declare function createInspectPlugin(): Plugin<any>;

package/dist/types/vite/plugin-router.d.ts

@@ -1,9 +0,0 @@
-import { Plugin } from 'vite';
-/**
- * Create the router plugin
- *
- * @param projectDir - The project directory
- * @param history - The history mode to use
- * @returns The router plugin
- */
-export declare function createRouterPlugin(projectDir: string, history?: "hash" | "browser"): Plugin<any> | Plugin<any>[];