@shijiu/jsview-vue 2.2.128 → 2.2.373

package/bin/types/JsViewVueWidget/JsvTextBox.vue.d.ts

@@ -1,3 +1,29 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvTextBox.vue}
+ */
+
+/**
+ * @file
+ *
+ * JsvTextBox：Vue高阶组件，用于文字绘制要精细调整的场景，
+ *            注意: 其中Jsv打头的属性为内部属性，不要在组件外直接使用，规避后续调整时进行变名等调整导致使用不了。
+ *      props说明:
+ *          verticalAlign {string}  垂直对齐方式 (必需) top、middle、bottom
+ *          style {object}          样式(必需)
+ *          enableLatex {bool}     是否启用Latex文字描画模式
+ *          textDirection {string}  文字方向，主要考虑阿拉伯语的方向场景
+ *          syncDraw {string}  文字较长时，是强制同步绘制还是自动的进入异步绘制，可选"auto","sync","async"
+ *                             其中"async"为强制包含短文字的场景也异步绘制
+ * latex语法样例
+ *    1. 颜色:     "测试\\textcolor{#FF0000}{红色}文字"
+ *    2. 加粗:     "测试\\textb{加粗}文字"
+ *    3. 斜体:     "测试\\texti{斜体}文字"
+ *    4. 下划线:   "测试\\textdecoration{underline}{下划线}文字"
+ *    5. 删除线:   "测试\\textdecoration{line-through}{删除线}文字"
+ * latex混合样式样例
+ *    "测试\\textcolor{#FF0000}{红色并且\\textb{加粗}}文字"
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvTextureAnim/BrowserTextureAnim.vue.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvTextureAnim/BrowserTextureAnim.vue}
+ */
+
 declare const _default: import("vue").DefineComponent<{
     src: StringConstructor;
     top: NumberConstructor;

package/bin/types/JsViewVueWidget/JsvTextureAnim/CommonType.d.ts

@@ -1,2 +1,6 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvTextureAnim/CommonType.js}
+ */
+
 export const DECORATE_BORDER_RADIUS: "BroderRaidus";
 export const DECORATE_NINEPATCH_ALPHA_MIX: "NinePatchAlphaMix";

package/bin/types/JsViewVueWidget/JsvTextureAnim/JsvTextureAnim.vue.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvTextureAnim/JsvTextureAnim.vue}
+ */
+
 declare const _default: import("vue").DefineComponent<{
     src: StringConstructor;
     top: NumberConstructor;
@@ -31,7 +35,7 @@ declare const _default: import("vue").DefineComponent<{
         type: ObjectConstructor;
     };
 }, {
-    forgeAnimation: null;
+    runningState: number;
     innerViewId: number;
 }, any, {}, {
     _createForgeView(view_texture: any, decorate_setting: any): any;
@@ -51,8 +55,9 @@ declare const _default: import("vue").DefineComponent<{
     _createLayoutViewWithDecorate(view_texture: any, decorate_setting: any): any;
     _createNinePatchAlphaMixView(view_texture: any, decorate_setting: any): any;
     _createBorderRadius(view_texture: any, decorate_setting: any): any;
-    _onAnimationEnd(): void;
+    _onAnimationEnd(normal_end: any): void;
     _updateTexCoord(): void;
+    _buildAnimation(): any;
     start(): void;
     getTransition(): string;
 }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{

package/bin/types/JsViewVueWidget/JsvTextureAnim/index.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvTextureAnim/index.js}
+ */
+
 export * from "./CommonType";
 export default _JsvTextureAnim;
 declare let _JsvTextureAnim: any;

package/bin/types/JsViewVueWidget/JsvTouchModeSwitcher.vue.d.ts

@@ -0,0 +1,100 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/JsvTouchModeSwitcher.vue}
+ */
+
+/**
+ * @file
+ *
+ * 【模块 export 内容】
+ * JsvTouchModeSwitcher：Vue高阶组件，监听交互模式的变更
+ *      props说明:
+ *          width       {number}   宽
+ *          height      {number}   高
+ *          initMode    {number}   初始模式, 1:按键, 2:触控, 默认为1
+ *      methods:
+ *          registerCallback: (callback: (mode: number) => void) => void
+              注册回调
+ *          unregisterCallback: (callback: (mode: number) => void) => void
+              注销回调
+ *          getInteractiveMode: () => number
+              获取当前的交互模式. 1:按键, 2:触控    
+ *      注意:
+ *          在MetroWidget的item中,如需监听交互模式变动, 为了避免过多回调, 一般在onFocus中注册, 在onBlur中注销          
+ * 
+*/
+
+declare const _default: {
+    new (...args: any[]): {
+        $: import("vue").ComponentInternalInstance;
+        $data: {};
+        $props: Partial<{}> & Omit<Readonly<import("vue").ExtractPropTypes<{}>> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>;
+        $attrs: {
+            [x: string]: unknown;
+        };
+        $refs: {
+            [x: string]: unknown;
+        };
+        $slots: Readonly<{
+            [name: string]: import("vue").Slot | undefined;
+        }>;
+        $root: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null;
+        $parent: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null;
+        $emit: (event: string, ...args: any[]) => void;
+        $el: any;
+        $options: import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{}>>, {
+            registerCallback: (callback: any) => void;
+            unregisterCallback: (callback: any) => void;
+            getInteractiveMode: () => number;
+            $props: {
+                readonly initMode?: number | undefined;
+                readonly height?: number | undefined;
+                readonly width?: number | undefined;
+            };
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {}, {}, string> & {
+            beforeCreate?: ((() => void) | (() => void)[]) | undefined;
+            created?: ((() => void) | (() => void)[]) | undefined;
+            beforeMount?: ((() => void) | (() => void)[]) | undefined;
+            mounted?: ((() => void) | (() => void)[]) | undefined;
+            beforeUpdate?: ((() => void) | (() => void)[]) | undefined;
+            updated?: ((() => void) | (() => void)[]) | undefined;
+            activated?: ((() => void) | (() => void)[]) | undefined;
+            deactivated?: ((() => void) | (() => void)[]) | undefined;
+            beforeDestroy?: ((() => void) | (() => void)[]) | undefined;
+            beforeUnmount?: ((() => void) | (() => void)[]) | undefined;
+            destroyed?: ((() => void) | (() => void)[]) | undefined;
+            unmounted?: ((() => void) | (() => void)[]) | undefined;
+            renderTracked?: (((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[]) | undefined;
+            renderTriggered?: (((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[]) | undefined;
+            errorCaptured?: (((err: unknown, instance: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null, info: string) => boolean | void) | ((err: unknown, instance: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string>, {}> | null, info: string) => boolean | void)[]) | undefined;
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import("vue").nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (args_0: R, args_1: R) => any : (...args: any) => any, options?: import("vue").WatchOptions<boolean> | undefined): import("vue").WatchStopHandle;
+    } & Readonly<import("vue").ExtractPropTypes<{}>> & import("vue").ShallowUnwrapRef<{
+        registerCallback: (callback: any) => void;
+        unregisterCallback: (callback: any) => void;
+        getInteractiveMode: () => number;
+        $props: {
+            readonly initMode?: number | undefined;
+            readonly height?: number | undefined;
+            readonly width?: number | undefined;
+        };
+    }> & {} & import("vue").ComponentCustomProperties & {};
+    __isFragment?: undefined;
+    __isTeleport?: undefined;
+    __isSuspense?: undefined;
+} & import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{}>>, {
+    registerCallback: (callback: any) => void;
+    unregisterCallback: (callback: any) => void;
+    getInteractiveMode: () => number;
+    $props: {
+        readonly initMode?: number | undefined;
+        readonly height?: number | undefined;
+        readonly width?: number | undefined;
+    };
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {}, {}, string> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
+    $slots: {
+        default: (_: {}) => any;
+    };
+});
+export default _default;

package/bin/types/JsViewVueWidget/JsvVisibleSensor/JsvVisibleSensor.vue.d.ts

@@ -1,3 +1,28 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvVisibleSensor/JsvVisibleSensor.vue}
+ */
+
+/**
+* @file
+*
+* 【模块 export 内容】
+* JsvVisibleSensor: 可视区域监控器
+* props说明:
+*     horizonShown  {number}  (可选, 可响应式, 默认1.0完全露出)横轴百分比区域完全显示时(左边或右边完全露出，仅中间段判断会失效),
+*                             横轴切换到显示状态，否则为不可视状态
+*     verticalShown  {number} (可选, 可响应式)纵轴百分比区域完全显示时(上边或下边完全露出，仅中间段判断会失效),
+*                             纵轴切换到显示状态，否则为不可视状态
+*     left   {number}  (可选, 可响应式)可视检测区域的left
+*     top   {number}  (可选, 可响应式)可视检测区域的top
+*     width   {number}  (可选, 可响应式)可视检测区域的width
+*     height   {number}  (可选, 可响应式)可视检测区域的height
+*
+*     container {div reference}  (可选, 可响应式)子区域参照，若为null，则认为检测可视区域为全屏幕
+*
+*     callback {function} (必须, 可响应式)可视变化时的回调处理, 参数
+*               (old_horizantal_visible, new_horizantal_visible, old_vertical_visible, new_vertical_visible)
+*/
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/JsvVisibleSensor/index.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../../../utils/JsViewVueWidget/JsvVisibleSensor/index.js}
+ */
+
 declare const _default: {
     new (...args: any[]): {
         $: import("vue").ComponentInternalInstance;

package/bin/types/JsViewVueWidget/index.d.ts

@@ -1,7 +1,13 @@
+/** 
+ + @file {@link file://./../../../utils/JsViewVueWidget/index.js}
+ */
+
 export * from "./JsvFreeMoveActor";
 export * from "./JsvFlexCell";
 export * from "./JsvSpriteAnim";
 export * from "./JsvScrollBox";
+export * from "./JsvClipDiv";
+export * from "./JsvDriftScope";
 export { default as JsvApic } from "./JsvApic/JsvApic";
 export { default as JsvApic2 } from "./JsvApic/JsvApic2";
 export { default as JsvQrcode } from "./JsvQrcode";
@@ -27,6 +33,9 @@ export { default as JsvConnectLine } from "./JsvConnectLine";
 export { default as JsvProgressBar } from "./JsvProgressBar.vue";
 export { default as JsvEnableRenderBreak } from "./JsvEnableRenderBreak.vue";
 export { JsvMindMap } from "./JsvMindMap";
+export { default as JsvFragShaderView } from "./JsvFragShaderView";
+export { default as JsvTouchModeSwitcher } from "./JsvTouchModeSwitcher.vue";
+export { default as JsvDragBox } from "./JsvDragBox/JsvDragBox.vue";
 import JsvNativeSharedDiv from "./JsvNativeSharedDiv.vue";
 export { JsvNativeSharedDiv as JsvTransparentDiv, JsvNativeSharedDiv };
 export { default as JsvActorMove, JsvActorMoveControl } from "./JsvActorMove";

package/bin/types/index.d.ts

@@ -1,3 +1,7 @@
+/** 
+ + @file {@link file://./../../utils/index.js}
+ */
+
 export * from "./JsViewEngineWidget";
 export * from "./JsViewPlugin";
 export * from "./JsViewVueTools";

package/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * @todo 添加jsview-vue/utils组件列表 
+ */
+
+export {
+  MetroWidget
+} from "./bin/types/index";
+
 // 二选一 "./bin" 用于执行打包的js，"./utils" 用于调试
 export * from "./bin/types/index";
 // export * from "./utils";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shijiu/jsview-vue",
-  "version": "2.2.128",
+  "version": "2.2.373",
   "license": "MIT",
   "repository": "system/jsview-framework",
   "author": "mengxk",

package/tools/config/rollup.config.mjs

@@ -7,6 +7,7 @@ export default {
     '@shijiu/jsview',
     '@shijiu/jsview/dom/*',
     '@shijiu/jsview/dom/jsv-forge-define',
+    '@shijiu/jsview/dom/jsv-forge-define.mjs',
     'plugin-vue:export-helper',
     'qr.js',
     'vue',

package/tools/config/toolkit.mjs

@@ -0,0 +1,81 @@
+import path from 'node:path';
+import url from 'node:url';
+
+function getFileComments(content, isVue, filePath)
+{
+  const keyword = '@file';
+
+  const contentLines = content.split('\n');
+  let fileCommentLines = [];
+  for (let idx = 0; idx < contentLines.length; idx++) {
+    const line = contentLines[idx];
+    const trimLine = line.trim();
+    // 空行 和 import, js文件会把import放在注释上面
+    if(!trimLine || trimLine.startsWith('import')) {
+      continue;
+
+    // 检查 /* comments */ 和 <!-- comments -->
+    } else if (trimLine.startsWith('/*')
+    || trimLine.startsWith('<!--')) {
+      const endFlag = trimLine.startsWith('/*') ? '*/' : '-->'
+      let multiCommentLines = [];
+      for(idx; idx < contentLines.length; idx++) {
+        const multiline = contentLines[idx];
+        multiCommentLines.push(multiline);
+        if(multiline.includes(endFlag)) {
+          multiCommentLines.push(''); // 添加一个空行
+          break;
+        }
+      }
+      if(multiCommentLines.join().includes(keyword)) {
+        fileCommentLines.push(...multiCommentLines);
+      }
+
+    // 检查 //
+    } else if (trimLine.startsWith('//')) {
+      if(line.includes(keyword)) {
+        fileCommentLines.push(line);
+      }
+
+    // 检查 vue 文件的 <script> 中的注释
+    } else if (isVue && trimLine.startsWith('<script')) {
+
+    // 出现代码，退出循环
+    } else {
+      break; 
+    }
+  }
+
+  return fileCommentLines.join('\n').trim();
+}
+
+/**************************************************
+ * jsview-framework/@shijiu/jsview-vue
+ * ├── bin
+ * │   └── types
+ * ├── tools
+ * │   └── config
+ * └── utls
+*************************************************/
+function getProjectPaths()
+{
+  const currJsFilePath = url.fileURLToPath(import.meta.url)
+  const jsviewVueDir = path.resolve(currJsFilePath, '../../../'); // jsview-framework/@shijiu/jsview-vue
+  const jsviewVueBinDir = path.resolve(jsviewVueDir, 'bin');
+  const jsviewVueBinTypesDir = path.resolve(jsviewVueBinDir, 'types');
+  const jsviewVueModulesCacheDir = path.resolve(jsviewVueDir, 'node_modules', '.cache');
+  const jsviewVueUtilsDir = path.resolve(jsviewVueDir, 'utils');
+
+  return {
+    jsviewVueDir,
+    jsviewVueBinDir,
+    jsviewVueBinTypesDir,
+    jsviewVueModulesCacheDir,
+    jsviewVueUtilsDir,
+  }
+}
+
+export {
+  getFileComments,
+  getProjectPaths,
+}

package/tools/config/tsconfig.json

@@ -1,6 +1,7 @@
 {
   "compilerOptions": {
     "allowJs": true,
+    // "checkJs": true,
     "declaration": true,
     "declarationDir": "../../bin/types",
     "emitDeclarationOnly": true,

package/tools/config/vite.config.ts

@@ -2,14 +2,18 @@ import { defineConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
 import fs from 'node:fs'
 import path from 'node:path'
+import {
+  getFileComments,
+  getProjectPaths
+} from './toolkit.mjs'
 
-const projectDir = process.cwd();
+const options = getProjectPaths();
 
 // https://vitejs.dev/config/
 export default defineConfig({
   build: {
     lib: {
-      entry: path.resolve(projectDir, 'utils/index.js'),
+      entry: path.resolve(options.jsviewVueUtilsDir, 'index.js'),
       formats: ["es"],
     },
     minify: false,
@@ -25,11 +29,11 @@ export default defineConfig({
       ],
       output: {
         banner: (chunkInfo) => getBanner(chunkInfo),
-        dir: path.resolve(projectDir, 'node_modules', '.cache'),
+        dir: options.jsviewVueModulesCacheDir,
         entryFileNames: '[name].mjs',
         format: 'esm',
         preserveModules: true,
-        preserveModulesRoot: projectDir,
+        preserveModulesRoot: options.jsviewVueDir,
         sourcemap: false,
       },
       treeshake: false,
@@ -41,20 +45,26 @@ export default defineConfig({
 })
 
 function getBanner(chunkInfo) {
-  let filePath = chunkInfo.facadeModuleId
-  filePath = filePath.replace(/^\x00/, '') // '\0plugin-vue:export-helper',
-  const modulePath = path.relative(projectDir, filePath)
+  let filePath = chunkInfo.facadeModuleId;
+  filePath = filePath.replace(/^\x00/, ''); // '\0plugin-vue:export-helper',
+  const modulePath = path.relative(options.jsviewVueUtilsDir, filePath);
+  const moduleDir = path.dirname(modulePath);
+  const dtsDir = path.resolve(options.jsviewVueBinTypesDir, moduleDir);
   let banner = `
- //!
- //! ${modulePath};
- //!
+ /*! 
+  + @file {@link file://./${path.relative(dtsDir, filePath)}}
+  */
  `;
 
   if(filePath.endsWith('.vue')) {
-    const regex = /<script.*?<\/script>|<style.*?<\/style>|<template.*?<\/template>/gs
-    const content = fs.readFileSync(filePath, 'utf-8')
-    const topLevelComments = content.replace(regex, '');
-    banner += `/*! ${topLevelComments} */`;
+    const content = fs.readFileSync(filePath, 'utf-8');
+
+    let fileComments = getFileComments(content, true, filePath);
+    fileComments = fileComments.replaceAll('/**', '/*!');
+    fileComments = fileComments.replaceAll('<!--', '/*!');
+    fileComments = fileComments.replaceAll('-->', '*/');
+
+    banner += fileComments;
   }
 
   return banner;

package/tools/jsview-vue-build.mjs

@@ -3,14 +3,51 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
-import url from 'node:url';
 import {
   checkNodeVersion,
   execCommand,
   getNpmRegistry,
+  Logger,
   parseArguments,
 } from '../../../@shijiu/jsview/tools/jsview-common.mjs';
 
+import {
+  getFileComments,
+  getProjectPaths,
+} from './config/toolkit.mjs'
+
+function checkTopLevelCommentsRecursive(relativeDir, baseDir, cacheDir)
+{
+  const fileNameList = fs.readdirSync(path.resolve(baseDir, relativeDir));
+  for(const fileName of fileNameList) {
+    const filePath = path.resolve(baseDir, relativeDir, fileName);
+    const stat = fs.statSync(filePath);
+    if(stat.isDirectory()) {
+      const relativeName = path.join(relativeDir, fileName);
+      checkTopLevelCommentsRecursive(relativeName, baseDir, cacheDir);
+    } else {
+      if(fileName.endsWith('.d.ts') == false) {
+        continue;
+      }
+
+      const refName = fileName.replace('.d.ts', '.mjs');
+      const refPath = path.resolve(cacheDir, relativeDir, refName);
+      if(fs.existsSync(refPath) == false) {
+        Logger.Tip('Ignore to check top-level comments: ' + filePath);
+        continue;
+      }
+      const refContent = fs.readFileSync(refPath, 'utf-8');
+      let fileComments = getFileComments(refContent, false, refPath);
+      fileComments = fileComments.replaceAll('/**!', '/**')
+      fileComments = fileComments.replaceAll('/*!', '/**')
+      
+      let content = fs.readFileSync(filePath, 'utf-8');
+      content = `${fileComments }\n\n${content}`;
+      fs.writeFileSync(filePath, content, 'utf-8');
+    }
+  }
+}
+
 function formatBannerRecursive(dir)
 {
   const fileNameList = fs.readdirSync(dir);
@@ -32,13 +69,11 @@ async function main(argv)
 {
   checkNodeVersion();
 
-  const currJsFilePath = url.fileURLToPath(import.meta.url)
-  const jsviewVueDir = path.resolve(currJsFilePath, '../../') // jsview-framework/@shijiu/jsview-vue
-  const jsviewVueBinDir = path.resolve(jsviewVueDir, 'bin') // jsview-framework/@shijiu/jsview-vue/bin
+  const options = getProjectPaths();
 
   const noSavePkgList = [
     // jsview
-    `${jsviewVueDir}/../jsview`,
+    `${options.jsviewVueDir}/../jsview`,
     'gifuct-js@2.1.2',
     'postcss-js@4.0.0',
 
@@ -58,42 +93,52 @@ async function main(argv)
   const noSavePackages = noSavePkgList.toString().replaceAll(',', ' ');
   const version = process.env['JSVIEW_VUE_VERSION'];
 
-  const npmInstalledFlag = path.resolve(jsviewVueDir, 'node_modules', '.cache', '.npm-installed');
+  const cacheDir = path.resolve(options.jsviewVueDir, 'node_modules', '.cache');
+  const npmInstalledFlag = path.resolve(cacheDir, '.npm-installed');
   let batchCommand = []
 
   if(!argv.withoutNpmInstall || fs.existsSync(npmInstalledFlag) == false) {
     const registry = getNpmRegistry();
-    fs.rmSync(`${jsviewVueDir}/node_modules`, { recursive: true, force: true });
+    fs.rmSync(`${options.jsviewVueDir}/node_modules`, { recursive: true, force: true });
     batchCommand = [
       `npm install --registry=${registry}`,
       `npm install --registry=${registry} --force --no-save ${noSavePackages}`,
-      `node ${jsviewVueDir}/node_modules/@shijiu/jsview/tools/jsview-post-install.mjs --framework=vue`,
+      `node ${options.jsviewVueDir}/node_modules/@shijiu/jsview/tools/jsview-post-install.mjs --framework=vue`,
     ];
   }
   batchCommand = [
     ...batchCommand,
-    `JSVIEW_DISABLE_MANUALCHUNKS=true ${jsviewVueDir}/node_modules/.bin/vite build --config ${jsviewVueDir}/tools/config/vite.config.ts`,
-    `${version ? 'JSVIEW_VUE_VERSION='+version : ''} ${jsviewVueDir}/node_modules/.bin/rollup  --config ${jsviewVueDir}/tools/config/rollup.config.mjs`,
+    `JSVIEW_DISABLE_MANUALCHUNKS=true ${options.jsviewVueDir}/node_modules/.bin/vite build --config ${options.jsviewVueDir}/tools/config/vite.config.ts`,
+    `${version ? 'JSVIEW_VUE_VERSION='+version : ''} ${options.jsviewVueDir}/node_modules/.bin/rollup  --config ${options.jsviewVueDir}/tools/config/rollup.config.mjs`,
   ];
   if(!argv.withoutTsDeclare) {
-    fs.rmSync(jsviewVueBinDir, { recursive: true, force: true });
-
-    batchCommand = [
-      ...batchCommand,
-      `${jsviewVueDir}/node_modules/.bin/vue-tsc --project ${jsviewVueDir}/tools/config/tsconfig.json`,
-    ];
+    fs.rmSync(options.jsviewVueBinDir, { recursive: true, force: true });
   }
   for(const command of batchCommand) {
-    execCommand(`cd ${jsviewVueDir} && ${command}`);
+    execCommand(`cd ${options.jsviewVueDir} && ${command}`);
   }
+  Logger.Info('Formatting banner ...');
+  formatBannerRecursive(options.jsviewVueBinDir);
 
-  formatBannerRecursive(jsviewVueBinDir);
+  if(!argv.withoutTsDeclare) {
+    batchCommand = [
+      `${options.jsviewVueDir}/node_modules/.bin/vue-tsc --project ${options.jsviewVueDir}/tools/config/tsconfig.json`,
+    ];
+    fs.rmSync(options.jsviewVueBinTypesDir, { recursive: true, force: true });
+    for(const command of batchCommand) {
+      execCommand(`cd ${options.jsviewVueDir} && ${command}`);
+    }
+
+    Logger.Info('Checking top-level comments ...');
+    const refUtilsDir = path.resolve(cacheDir, 'utils');
+    checkTopLevelCommentsRecursive('.', options.jsviewVueBinTypesDir, refUtilsDir);
+  }
 
   fs.mkdirSync(path.dirname(npmInstalledFlag), {recursive: true});
   fs.writeFileSync(npmInstalledFlag, '');
   if(!argv.withoutNpmInstall) {
-    fs.rmSync(`${jsviewVueDir}/node_modules`, { recursive: true, force: true });
-    fs.rmSync(`${jsviewVueDir}/package-lock.json`, { recursive: true, force: true });
+    fs.rmSync(`${options.jsviewVueDir}/node_modules`, { recursive: true, force: true });
+    fs.rmSync(`${options.jsviewVueDir}/package-lock.json`, { recursive: true, force: true });
   }
 
   console.info('Done...');
@@ -106,4 +151,4 @@ const optionalUsages = {
   '-n | --without-npm-install': 'Ignore to run npm install.',
 };
 const argv = parseArguments(requiredUsages, optionalUsages, false);
-main(argv);
+main(argv);

package/utils/JsViewEngineWidget/JsvFocus/JsvFocusBlock.vue

@@ -1,4 +1,6 @@
 <!--
+ * @file
+ *
  *  props:
  *    onKeyUp: 按键抬起回调
  *           @params keyEvent
@@ -41,9 +43,11 @@ import {
 import { HUB_NS_PROVIDE_NAME } from "./JsvFocusHub";
 
 const props = defineProps({
+  style: Object,
   name: String,
   namespace: String,
-  autoFocus: String,
+  autoFocus: String | Boolean,
+  focusable: Boolean | undefined,
   onAction: Object,
   onDispatchKeyUp: Function,
   onDispatchKeyDown: Function,
@@ -238,7 +242,7 @@ defineExpose(exportObject);
 </script>
 
 <template>
-  <fdiv ref="fDivRef" :fname="name" :new-namespace="namespace">
+  <fdiv ref="fDivRef" :fname="name" :new-namespace="namespace" :style="style" :data-jsv-focusable="focusable ?? !namespace">
     <slot></slot>
   </fdiv>
 </template>