@shijiu/jsview-vue 2.2.201 → 2.2.426-test.0

package/bin/types/{JsViewVueWidget/JsvPreload/BrowserPreload.vue.d.ts → utils/JsViewVueWidget/JsvInput/JsvInput.vue.d.ts}

@@ -1,10 +1,12 @@
+export { InputType };
 declare const _default: import("vue").DefineComponent<{}, {
+    add: (text: any) => void;
+    delete: () => void;
+    clear: () => void;
+    replace: (text: any) => void;
     $props: {
-        readonly preloadList?: unknown[] | undefined;
-        readonly downloadList?: unknown[] | undefined;
-        readonly onPreloading?: Function | undefined;
-        readonly onPreloadDone?: Function | undefined;
-        readonly onDownloadDone?: Function | undefined;
+        [x: string]: any;
     };
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;
+import { InputType } from "./SharedDefine";

package/bin/types/utils/JsViewVueWidget/JsvInput/SharedDefine.d.ts

@@ -0,0 +1,13 @@
+export declare const InputType: {
+    TEXT: any;
+    NUMBER: any;
+    PASSWORD: any;
+};
+export declare interface FontStyleDefine {
+    fontSize: number;
+    fontFamily: string;
+    textAlign: string;
+    fontStyle: string;
+    fontWeight: string;
+}
+export declare const MAX_WIDTH = 2000;

package/bin/types/utils/JsViewVueWidget/JsvInput/SystemTextTools.d.ts

@@ -0,0 +1,16 @@
+declare interface FontStyleDefine {
+    fontSize: number;
+    fontFamily: string;
+    textAlign: string;
+    fontStyle: string;
+    fontWeight: string;
+}
+export interface CursorResult {
+    x: number;
+    cachedId: number;
+}
+export declare function calculateCursorPosition(display_text: string, cursor_offset: number, rect_width: number, rect_height: number, line_height: number, font_style: FontStyleDefine): CursorResult;
+export declare function calculateCursorPositionCached(cursor_offset: number, cached_id: number): number;
+export declare function recycleCursorMeasureCache(cached_id: any): void;
+export declare function getTextDisplayWidth(text: string, font_style: FontStyleDefine): any;
+export {};

package/bin/types/{JsViewVueWidget → utils/JsViewVueWidget}/JsvMaskClipDiv.vue.d.ts

@@ -33,7 +33,6 @@ declare const _default: import("vue").DefineComponent<{
     innerView: null;
     innerViewId: number;
     styleDetail: null;
-    html: boolean;
     cache: {
         viewSrc: null;
         maskSrc: null;
@@ -46,7 +45,6 @@ declare const _default: import("vue").DefineComponent<{
 }, any, {}, {
     _drawClip(canvas: any, clip_image: any, clip_ready: any, bg_image: any, bg_ready: any): void;
     updateMainTexturePosition(): void;
-    _initForHtml(): void;
     _updateInnerView(): void;
 }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
     class: {

package/bin/types/{JsViewVueWidget → utils/JsViewVueWidget}/JsvMindMap/DataTree.d.ts

@@ -13,7 +13,7 @@ export declare class DataNode {
     moveType: MoveType;
     private lineList;
     private moveInfoCache;
-    constructor(rect: Rect, depth: number, id: string, data: any, moveType?: MoveType);
+    constructor(rect: Rect, depth: number, id: string, data: any, moveType?: MoveType, enableTap?: boolean);
     get minX(): number;
     get maxX(): number;
     get minY(): number;
@@ -56,6 +56,8 @@ export declare class DataNode {
     private focused;
     private divRef;
     private lineStyle;
+    enableTap: boolean;
+    onTap: import("vue").ComputedRef<(() => void) | null>;
     setLineStyle(style: any): void;
     getLineStyle(): any;
     onFocus(): void;

package/bin/types/{JsViewVueWidget → utils/JsViewVueWidget}/JsvMindMap/Geometry.d.ts

@@ -10,7 +10,7 @@ export declare class Point {
      * @param p
      * @returns
      */
-    relativeTo(p: Point): "left" | "right" | "bottom" | "top";
+    relativeTo(p: Point): "left" | "right" | "top" | "bottom";
     clone(): Point;
 }
 export declare class Line {
@@ -39,7 +39,7 @@ export declare class Rect {
      */
     relativeTo(rect: Rect, eightDirInfo?: {
         value: number;
-    } | null): "left" | "right" | "bottom" | "top";
+    } | null): "left" | "right" | "top" | "bottom";
     getEdge(dir: Direction): Line;
     containPoint(point: Point): boolean;
     containRect(rect: Rect): boolean;

package/bin/types/{JsViewVueWidget → utils/JsViewVueWidget}/JsvMindMap/JsvMindMap.vue.d.ts

@@ -29,13 +29,15 @@ declare const _default: {
                 height: number;
             };
             refreshData: () => void;
+            setSensor: (callback: any, sensitivity?: number) => void;
             $props: {
-                readonly height?: number | undefined;
-                readonly width?: number | undefined;
+                readonly name?: string | undefined;
                 readonly left?: number | undefined;
                 readonly top?: number | undefined;
-                readonly name?: string | undefined;
+                readonly width?: number | undefined;
+                readonly height?: number | undefined;
                 readonly provideData?: Function | undefined;
+                readonly touchFlag?: number | undefined;
                 readonly formatNode?: Function | undefined;
                 readonly focusRectPadding?: number | undefined;
                 readonly renderRectMargin?: number | undefined;
@@ -75,13 +77,15 @@ declare const _default: {
             height: number;
         };
         refreshData: () => void;
+        setSensor: (callback: any, sensitivity?: number) => void;
         $props: {
-            readonly height?: number | undefined;
-            readonly width?: number | undefined;
+            readonly name?: string | undefined;
             readonly left?: number | undefined;
             readonly top?: number | undefined;
-            readonly name?: string | undefined;
+            readonly width?: number | undefined;
+            readonly height?: number | undefined;
             readonly provideData?: Function | undefined;
+            readonly touchFlag?: number | undefined;
             readonly formatNode?: Function | undefined;
             readonly focusRectPadding?: number | undefined;
             readonly renderRectMargin?: number | undefined;
@@ -105,13 +109,15 @@ declare const _default: {
         height: number;
     };
     refreshData: () => void;
+    setSensor: (callback: any, sensitivity?: number) => void;
     $props: {
-        readonly height?: number | undefined;
-        readonly width?: number | undefined;
+        readonly name?: string | undefined;
         readonly left?: number | undefined;
         readonly top?: number | undefined;
-        readonly name?: string | undefined;
+        readonly width?: number | undefined;
+        readonly height?: number | undefined;
         readonly provideData?: Function | undefined;
+        readonly touchFlag?: number | undefined;
         readonly formatNode?: Function | undefined;
         readonly focusRectPadding?: number | undefined;
         readonly renderRectMargin?: number | undefined;
@@ -136,6 +142,7 @@ declare const _default: {
                     height: number;
                 };
                 refreshData: () => void;
+                setSensor: (callback: any, sensitivity?: number) => void;
             };
             onAction: any;
         }) => any;

package/bin/types/{JsViewVueWidget → utils/JsViewVueWidget}/JsvNativeSharedDiv.vue.d.ts

@@ -20,6 +20,8 @@ declare const _default: {
             $props: {
                 readonly style?: Record<string, any> | undefined;
                 readonly corner?: number | undefined;
+                readonly oversize?: number | undefined;
+                readonly frontLayer?: boolean | undefined;
                 readonly getId?: Function | undefined;
                 readonly setId?: string | undefined;
             };
@@ -47,6 +49,8 @@ declare const _default: {
         $props: {
             readonly style?: Record<string, any> | undefined;
             readonly corner?: number | undefined;
+            readonly oversize?: number | undefined;
+            readonly frontLayer?: boolean | undefined;
             readonly getId?: Function | undefined;
             readonly setId?: string | undefined;
         };
@@ -58,6 +62,8 @@ declare const _default: {
     $props: {
         readonly style?: Record<string, any> | undefined;
         readonly corner?: number | undefined;
+        readonly oversize?: number | undefined;
+        readonly frontLayer?: boolean | undefined;
         readonly getId?: Function | undefined;
         readonly setId?: string | undefined;
     };

package/bin/types/{JsViewVueWidget → utils/JsViewVueWidget}/JsvNinePatch.vue.d.ts

@@ -1,8 +1,8 @@
 declare const _default: import("vue").DefineComponent<{}, {
     $props: {
+        readonly style?: Record<string, any> | undefined;
         readonly left?: number | undefined;
         readonly top?: number | undefined;
-        readonly style?: Record<string, any> | undefined;
         readonly imageUrl?: string | undefined;
         readonly waitForInit?: boolean | undefined;
         readonly imageWidth?: number | undefined;
@@ -14,6 +14,7 @@ declare const _default: import("vue").DefineComponent<{}, {
         readonly imageBlendType?: string | undefined;
         readonly onDivRef?: Function | undefined;
         readonly animation?: string | undefined;
+        readonly onAnimationEnd?: Function | undefined;
         readonly onTransitionEnd?: Function | undefined;
     };
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;

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

@@ -0,0 +1,2 @@
+export * from "./JsvPreload.vue";
+export { default } from "./JsvPreload.vue";

package/bin/types/utils/JsViewVueWidget/JsvSwiper/Indicator.vue.d.ts

@@ -0,0 +1,16 @@
+declare const _default: import("vue").DefineComponent<{
+    number: NumberConstructor;
+    vertical: BooleanConstructor;
+    itemSize: NumberConstructor;
+    current: NumberConstructor;
+}, any, any, {
+    indexList(): number[];
+}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    number: NumberConstructor;
+    vertical: BooleanConstructor;
+    itemSize: NumberConstructor;
+    current: NumberConstructor;
+}>>, {
+    vertical: boolean;
+}>;
+export default _default;

package/bin/types/utils/JsViewVueWidget/JsvSwiper3D/Indicator.vue.d.ts

@@ -0,0 +1,16 @@
+declare const _default: import("vue").DefineComponent<{
+    number: NumberConstructor;
+    vertical: BooleanConstructor;
+    itemSize: NumberConstructor;
+    current: NumberConstructor;
+}, any, any, {
+    indexList(): number[];
+}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    number: NumberConstructor;
+    vertical: BooleanConstructor;
+    itemSize: NumberConstructor;
+    current: NumberConstructor;
+}>>, {
+    vertical: boolean;
+}>;
+export default _default;

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

@@ -0,0 +1,4 @@
+export * from "./CommonType";
+export default JsvTextureAnim;
+import JsvTextureAnim from "./JsvTextureAnim.vue";
+export const TexAlignAnchor: any;

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

@@ -0,0 +1,75 @@
+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 width?: number | undefined;
+                readonly height?: 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 width?: number | undefined;
+            readonly height?: 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 width?: number | undefined;
+        readonly height?: 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/utils/JsViewVueWidget/JsvVideo.vue.d.ts

@@ -0,0 +1,23 @@
+declare const _default: import("vue").DefineComponent<{
+    onRef: {
+        type: FunctionConstructor;
+        default: () => void;
+    };
+    useTexture: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}, any, any, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    onRef: {
+        type: FunctionConstructor;
+        default: () => void;
+    };
+    useTexture: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>>, {
+    onRef: Function;
+    useTexture: boolean;
+}>;
+export default _default;

package/bin/types/{JsViewVueWidget → utils/JsViewVueWidget}/index.d.ts

@@ -6,8 +6,8 @@ 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";
-export { default as JsvSpray } from "./JsvSpray";
+export { default as JsvQrcode } from "./JsvQrcode/JsvQrcode.vue";
+export { default as JsvSpray } from "./JsvSpray/JsvSpray.vue";
 export { default as JsvSwiper } from "./JsvSwiper";
 export { default as JsvSwiper3D } from "./JsvSwiper3D";
 export { default as JsvVisibleSensor } from "./JsvVisibleSensor";
@@ -30,6 +30,8 @@ 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/index.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shijiu/jsview-vue",
-  "version": "2.2.201",
+  "version": "2.2.426-test.0",
   "license": "MIT",
   "repository": "system/jsview-framework",
   "author": "mengxk",

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/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;