@lcap/nasl 3.7.0-beta.4 → 3.7.0-beta.6

package/dist/src/translator/types.d.ts

@@ -0,0 +1,85 @@
+import type { BaseNode } from '../concepts';
+export interface PositionWithoutOffset {
+    line: number;
+    character: number;
+}
+export interface Position extends PositionWithoutOffset {
+    offset: number;
+}
+export interface Range {
+    start: Position;
+    end: Position;
+}
+export interface RangeOffsetOnly {
+    start: number;
+    end: number;
+}
+export interface TSPPosition {
+    line: number;
+    offset: number;
+}
+export interface TSPRange {
+    start: TSPPosition;
+    end: TSPPosition;
+}
+export interface TSP1DRange {
+    start: number;
+    length: number;
+}
+/**
+ * 翻译上下文状态
+ */
+export interface TranslatorState {
+    position?: Position;
+    tabSize?: number;
+    inline?: boolean;
+    preferQuote?: 'single' | 'double' | 'backtick';
+    sourceMap?: SourceMap;
+    finalCode?: boolean;
+    /**
+     * 当前用户聚焦的位置
+     * 目前会自动标记一个`/* 当前位置 *\/`的注释信息
+     * @example 逻辑生成
+     */
+    focusedNodePath?: string;
+    /**
+     * toNaturalTS 使用，是否需要带 typeNamespace
+     */
+    needNamespace?: boolean;
+    /**
+     * 生成时带上`// nodePath`注释信息
+     * 目前只会在语句前带注释
+     * @example 逻辑解读
+     * @example 修改逻辑节点
+     */
+    nodePathComment?: boolean;
+    /**
+     * 只生成对应节点的声明信息
+     */
+    declaration?: boolean;
+    /**
+     * 该节点包含子节点，转换当前节点时是否需要转换子节点
+     */
+    convertChildren?: boolean;
+    /**
+     * 在局部场景中使用外部传入的名称
+     */
+    rename?: string;
+    /**
+     * 在局部场景中添加名字前缀
+     */
+    autoPrefixName?: boolean;
+    /**
+     * 将某个节点挖空，用于生成 AI 补全训练数据
+     * @example 自动补全
+     */
+    blankNodePath?: string;
+    getVuePrototype?: boolean;
+    noNeedParams?: boolean;
+    inElementsRefTree?: boolean;
+    callLogicNoIife?: boolean;
+}
+export declare type SourceMapItem = Range;
+export declare type SourceMap = Map<BaseNode, SourceMapItem>;
+export declare type TranslatorGenerator = Generator<any, string, string>;
+export declare type TranslatorMethod = (state: TranslatorState) => TranslatorGenerator;

package/dist/src/translator/utils.d.ts

@@ -0,0 +1,47 @@
+import type { Position, Range, TranslatorState } from './types';
+import type TypeAnnotation from '../concepts/TypeAnnotation__';
+import type App from '../concepts/App__';
+export declare function lsp2tspNumber(num: number): number;
+export declare const indent: (tabSize: number) => string;
+/**
+ * 创建编译器状态
+ */
+export declare function createCompilerState(startCode?: string, options?: Partial<TranslatorState>): TranslatorState;
+/**
+ * 根据代码移动位置
+ */
+export declare function shiftPosition(pos: Position, code?: string): Position;
+/**
+ * 根据代码移动状态
+ */
+export declare function shiftState(state: TranslatorState, code?: string, options?: Partial<TranslatorState>): TranslatorState;
+export declare function isSameRange(rangeA: Range, rangeB: Range): boolean;
+/**
+ * 翻译方法修饰器
+ *
+ * 只为 toNaturalTS 用
+ * @description 旧的翻译方法修饰器，现在用`withSourceMapGenerator`
+ */
+export declare function withSourceMap(): (target: any, key: string | number | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * 翻译方法修饰器
+ *
+ * @description 翻译方法修饰器，会将翻译方法包装为生成器
+ */
+export declare function withSourceMapGenerator(target: any, key: string, descriptor: PropertyDescriptor): PropertyDescriptor;
+/**
+ * 生成器方法修饰器
+ *
+ * @description 翻译方法修饰器，只有停顿，没有源码映射表
+ */
+export declare function withGenerator(target: any, key: string, descriptor: PropertyDescriptor): PropertyDescriptor;
+export declare function transfromMetadataType(expTypeAnnotation: TypeAnnotation, app: App): {
+    typeKind: "function" | "primitive" | "reference" | "generic" | "typeParam" | "union" | "anonymousStructure";
+    typeNamespace: string;
+    typeName: string;
+    sortedTypeKey: string;
+};
+export declare function transfromUnionTypeAnnotation(expTypeAnnotation: TypeAnnotation, app: App): void;
+export declare function createDecoratorCode<T>(state: TranslatorState, node: T, properties: Array<keyof T>): string;
+export declare function createIdentifierCode(name: string): string;
+export declare function textualNamespace(name: string): string;

package/dist/src/utils/cookie.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    set(data?: {
+        [key: string]: string;
+    }, exdays?: number, exseconds?: number, isRoot?: boolean): void;
+    get(name: string): string | null;
+    erase(name: string): void;
+    eraseAll(): void;
+};
+export default _default;

package/dist/src/utils/create.d.ts

@@ -0,0 +1,2 @@
+export declare function createUUID(): string;
+export declare function createUniqueKey(): string;

package/dist/src/utils/env.d.ts

@@ -0,0 +1,2 @@
+/** Node 环境 */
+export declare const isNode: boolean;

package/dist/src/utils/file.d.ts

@@ -0,0 +1,33 @@
+export declare class WebFile extends Blob {
+    private _name;
+    private _lastModified;
+    /**
+     *
+     * @param {BlobPart[]} init
+     * @param {string} name - A USVString representing the file name or the path
+     * to the file.
+     * @param {FilePropertyBag} [options]
+     */
+    constructor(init: BlobPart[], name: string, options?: FilePropertyBag);
+    /**
+     * The name of the file referenced by the File object.
+     * @type {string}
+     */
+    get name(): string;
+    /**
+     * The path the URL of the File is relative to.
+     * @type {string}
+     */
+    get webkitRelativePath(): string;
+    /**
+     * Returns the last modified time of the file, in millisecond since the UNIX
+     * epoch (January 1st, 1970 at Midnight).
+     * @returns {number}
+     */
+    get lastModified(): number;
+    get [Symbol.toStringTag](): string;
+}
+export declare const File: {
+    new (fileBits: BlobPart[], fileName: string, options?: FilePropertyBag): File;
+    prototype: File;
+};

package/dist/src/utils/i18nInfo.d.ts

@@ -0,0 +1,5 @@
+export declare const languageList: {
+    id: string;
+    name: string;
+    title: string;
+}[];

package/dist/src/utils/index.d.ts

@@ -0,0 +1,72 @@
+import { BaseNode, LogicItem } from '..';
+import type { TypeAnnotation } from '..';
+import * as types from '../concepts/utils/types';
+export * from './string';
+export * from './traverse';
+export * from './logger';
+export * from './types';
+export * from './window';
+export * from './env';
+export * from './file';
+export * from './time-slicing';
+export declare function findClosestModule(node: BaseNode): BaseNode;
+export declare function findConceptKeyWordByNamespace(namespace: string): string;
+export declare function findConceptKeyWordIndexFromNamespace(namespace: string, keyword: string): number;
+export declare function findConceptValueFromNamespace(namespace: string, keyword: string): string;
+export declare function getGlobalEnv(): any;
+/**
+ * 用 lodash 的 throttle 好像有点问题，先临时做个处理
+ * @param func
+ * @param wait
+ * @param options
+ */
+export declare const throttle: (func: Function, wait: number, options: any) => Function;
+export declare function clearObject(obj: any): void;
+export declare function clearObjectDeep(obj: any): void;
+export declare const waitPromise: (wait: number) => Promise<unknown>;
+export declare const officialCustoms: string[];
+export declare const specialOfficialCustoms: {
+    name: string;
+    version: string;
+}[];
+export declare const shouldLoadCss: (name: string, version: string) => boolean;
+export declare type IfEquals<X, Y, A, B> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? A : B;
+export declare type WritableKeysOf<T> = {
+    [P in keyof T]: IfEquals<{
+        [Q in P]: T[P];
+    }, {
+        -readonly [Q in P]: T[P];
+    }, P, never>;
+}[keyof T];
+export declare type WritablePart<T> = Pick<T, WritableKeysOf<T>>;
+export declare type NoReadonly<T> = {
+    -readonly [P in keyof T]: T[P];
+};
+export declare function toBriefExpr(expression: LogicItem): string;
+export declare function replaceNode(oldNode: any, newNode: any): void;
+export declare function attrConvertCamelCase(str: string): string;
+export declare class AnonymousFnNode {
+    node: types.SyntaxNode;
+    descendants: AnonymousFnNode[];
+}
+/**
+ * 父链上存在的参数名字
+ * @returns
+ */
+export declare function getAncestorExistingParamNames(baseNode: types.SyntaxNode): Set<string>;
+/**
+ * 校验匿名函数的局部变量是否重名
+ */
+export declare function checkParamNameOfAnonymousFunction(node: types.SyntaxNode): void;
+/**
+ * 新的参数名是否存在同名
+ * @param param0
+ */
+export declare function hasParamNameOfAnonymousFunction({ node, newName, }: {
+    node: types.SyntaxNode;
+    newName: string;
+}): boolean;
+/**
+ * 目标类型列表是否和源类型列表一致
+ */
+export declare function isSameInType(source: TypeAnnotation[], target: TypeAnnotation[]): boolean;

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,8 @@
+export interface Logger {
+    info(...tests: any[]): void;
+    warn(...tests: any[]): void;
+    error(...tests: any[]): void;
+    time(name: string): void;
+    timeEnd(name: string): void;
+}
+export declare const internalLogger: Logger;

package/dist/src/utils/sortTsString.d.ts

@@ -0,0 +1 @@
+export declare function sortTsString(tsString: string): string;

package/dist/src/utils/string.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 中划线格式 转 驼峰格式  kebab-case -> camelCase
+ * @param name 原名称
+ * @return 转换后的名称
+ */
+export declare const kebab2Camel: (name: string) => string;
+/**
+ * 中划线格式 转 驼峰格式  kebab-case -> CamelCase
+ * @param name 原名称
+ * @return 转换后的名称
+ */
+export declare const kebab2Pascal: (name: string) => string;
+/**
+ * 中划线格式 转 驼峰格式  ab-cd -> abCd
+ * @param name 原名称
+ * @return 转换后的名称
+ */
+export declare const kebab2Camel2: (name: string) => string;
+/**
+ * 下划线格式 转 驼峰格式  snake_case -> camelCase
+ * @param name 原名称
+ * @param notPascalCase = false 首字母是否小写
+ * @return 转换后的名称
+ */
+export declare const snake2Camel: (name: string, notPascalCase?: boolean) => string;
+/**
+ * 驼峰格式 转 中划线格式  camelCase -> kebab-case
+ * @param name 原名称
+ * @return 转换后的名称
+ */
+export declare const Camel2kebab: (name: string) => string;
+/**
+ * 驼峰格式 转 下划线格式  camelCase -> snake_case
+ * @param name 原名称
+ * @return 转换后的名称
+ */
+export declare const Camel2Snake: (name: string) => string;
+/**
+ * 首字母大写
+ * @param value 字符串
+ */
+export declare const firstUpperCase: (value: string) => string;
+/**
+ * 首字母小写
+ * @param value 字符串
+ */
+export declare const firstLowerCase: (value: string) => string;
+/**
+ * @param key 键
+ * @param set 数据集合，Array | Map | Set
+ * @param start 数字起始
+ */
+export declare function unique(key: string, set: Set<string> | Map<string, any> | Array<string> | {
+    [name: string]: string;
+}, start?: number, insensitive?: boolean): string;
+export declare function uniqueMax(key: string, set: Set<string>, start?: number | BigInt): string;
+export declare const getLastOfPath: (path: string) => string;
+/**
+ * 切出标签内的内容
+ * @param source 原始内容
+ * @param tag 标签
+ * @param attrs 属性匹配
+ */
+export declare const sliceTagContent: (source: string, tag: string, attrs?: string) => string;

package/dist/src/utils/time-slicing/constant.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 理论上限的计算系数
+ *
+ * @description 因为这里的时间分片需要让出部分给别的微任务，所以这里的理论上限需要乘以小于 1 的系数来保证不超过限制。
+ */
+export declare const TheoreticalLimitCalculationCoefficient = 0.4;
+/**
+ * 最小帧剩余时间
+ *
+ * @description 在计算是否在下一帧运行时，空闲时间的阈值，单位“毫秒”
+ */
+export declare const FrameIdleTime = 2;
+/**
+ * 资源不足的帧数限制
+ *
+ * @description 资源不足的帧数超过总帧数的比例超过此值时，将会强行抢占进程运行后面的所有流程
+ */
+export declare const LowResourceFrame = 0.8;
+/**
+ * 资源不足的判定限制
+ *
+ * @description 当前帧中，微任务运行的时间占帧总时长的比例
+ */
+export declare const LowResourceRatio = 0.1;
+/**
+ * 最小帧时间
+ *
+ * @description 最大帧率 60Hz，单位“毫秒”
+ */
+export declare const FrameMinTime: number;
+/** 任务组状态 */
+export declare enum NextState {
+    MicroTask = 0,
+    NextFrame = 1
+}

package/dist/src/utils/time-slicing/controller.d.ts

@@ -0,0 +1,53 @@
+/** 时间分片控制器 */
+export declare class TimeSlicingController {
+    /** 控制器编号 */
+    private id;
+    /** 已处理的任务数量 */
+    private allTaskNumber;
+    /**
+     * 已处理任务消耗的总时间
+     *
+     * @description 单位“毫秒”
+     */
+    private allTaskTime;
+    /**
+     * 单个任务平均执行时间
+     *
+     * @description 单位“毫秒”，初始化为`1`微秒
+     */
+    private averageTaskTime;
+    /** 资源不足帧的数量 */
+    private lowResourceFrame;
+    /** 帧数据 */
+    private readonly frame;
+    /** 任务组数据 */
+    private readonly group;
+    /** 异步等待数据 */
+    private readonly async;
+    /** 性能检测包装器 */
+    private readonly performance;
+    private groupList;
+    private frameList;
+    private asyncList;
+    /** 任务增长系数 */
+    private increaseRatio;
+    /** 下组任务状态 */
+    private getNextData;
+    /** 清除状态 */
+    private clearState;
+    /** 展示信息 */
+    private displayInfo;
+    /** 当前组运行开始 */
+    private setGroupStart;
+    /** 当前组运行结束 */
+    private setGroupEnd;
+    /** 动画帧开始 */
+    private setFrameStart;
+    /** 动画帧结束 */
+    private setFrameEnd;
+    /** 异步等待开始 */
+    private setAsyncStart;
+    /** 异步等待结束 */
+    private setAsyncEnd;
+    run<T = void>(generator: Generator<any, T, any>): T extends Promise<any> ? T : Promise<T>;
+}

package/dist/src/utils/time-slicing/index.d.ts

@@ -0,0 +1,5 @@
+export { delay, isGenerator, returnOrigin } from './utils';
+export * from './runner';
+export * from './wrapper';
+export * from './tool';
+export * from './controller';

package/dist/src/utils/time-slicing/page-state.d.ts

@@ -0,0 +1,2 @@
+/** 页面活动状态 */
+export declare let pageIsActive: boolean;

package/dist/src/utils/time-slicing/performance.d.ts

@@ -0,0 +1,11 @@
+export declare class Performance {
+    private id;
+    constructor(id: number);
+    get prefix(): string;
+    private getPerformanceId;
+    private clearEntry;
+    mark(name: string): PerformanceMark;
+    measure(name: string, startMark: string, endMark: string): PerformanceMeasure;
+    clearByNames(...names: string[]): void;
+    clear(): void;
+}

package/dist/src/utils/time-slicing/runner.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 运行生成器
+ *
+ * @description 同步模式
+ */
+export declare function runGeneratorSync<T = void>(generator: Generator<any, T, any>): T;
+/**
+ * 运行生成器
+ *
+ * @description 异步模式
+ */
+export declare function runGeneratorAsync<T = void>(generator: Generator<any, T, any>): T extends Promise<any> ? T : Promise<T>;

package/dist/src/utils/time-slicing/tool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 时间分片
+ *
+ * @description 大型任务分片执行，保证不阻塞主线程
+ * @description 数组回调必须是同步的，若是想要使用异步回调，请使用`timeSlicingWithGenerator`方法
+ * @param {T[]} list - 项目列表
+ * @param {(val: T, index: number) => void} cb - 每个项目的回调
+ */
+export declare function timeSlicingWithList<T>(list: T[], cb: (val: T, index: number, arr: T[]) => void): Promise<void>;
+/**
+ * 生成器时间分片
+ *
+ * @description 大型任务的分片执行保证不阻塞主线程
+ * @description 生成器中允许使用异步操作，使用`yield [promise]`语句即可
+ * @example
+ * ```
+ * timeSlicingWithGenerator((function test() {
+ *   const result = yield axios.get('xxxxxx');
+ *   console.log(result);
+ * })());
+ * ```
+ * @param {Generator<any, T, any>} generator - 生成器
+ */
+export declare function timeSlicingWithGenerator<T = void>(generator: Generator<any, T, any>): T extends Promise<any> ? T : Promise<T>;

package/dist/src/utils/time-slicing/utils.d.ts

@@ -0,0 +1,62 @@
+export interface TaskDataInDebug {
+    count: number;
+    time: number;
+    avg: number;
+    frameId: number;
+}
+export interface GroupData {
+    /** 任务组编号 */
+    id: number;
+    /** 所属帧编号 */
+    frameId: number;
+    /** 任务组耗时 */
+    time: number;
+    /** 任务组数量 */
+    limit: number;
+    /** 任务组标签 */
+    mark: ReturnType<typeof getGroupMark>;
+}
+export interface FrameData {
+    /** 帧编号 */
+    id: number;
+    /** 帧耗时 */
+    time: number;
+    /** 任务组在当前帧的耗时 */
+    groupTime: number;
+    /** 帧标签 */
+    mark: ReturnType<typeof getFrameMark>;
+}
+export interface AsyncData {
+    /** 异步等待编号 */
+    id: number;
+    /** 异步等待耗时 */
+    time: number;
+    /** 异步结果 */
+    result: any;
+    /** 异步标签 */
+    mark: ReturnType<typeof getAsyncMark>;
+}
+export declare function getId(): number;
+/** 延迟 */
+export declare function delay(time?: number): Promise<void>;
+export declare function getAsyncMark(id: number): {
+    AsyncStart: string;
+    AsyncEnd: string;
+    AsyncMeasure: string;
+};
+export declare function getGroupMark(id: number): {
+    GroupStart: string;
+    GroupEnd: string;
+    GroupMeasure: string;
+};
+export declare function getFrameMark(id: number): {
+    FrameStart: string;
+    FrameEnd: string;
+    FrameMeasure: string;
+};
+export declare function isGenerator(value: unknown): value is Generator<any, any, any>;
+/**
+ * 空生成器
+ */
+export declare function returnOrigin(): Generator<any, void, any>;
+export declare function returnOrigin<T>(defaultVal: T): Generator<any, T, any>;

package/dist/src/utils/time-slicing/wrapper.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 迭代器包装为生成器
+ *
+ * @description 回调中允许使用生成器
+ */
+export declare function wrapIteratorToGenerator<T>(list: IterableIterator<T>, forEach: (item: T, index: number, arr: T[]) => (any | Generator<any, any, any>)): Generator<any, any, any>;
+/**
+ * 数组 forEach 回调包装为生成器
+ *
+ * @description 回调中允许使用生成器
+ */
+export declare function wrapForEachToGenerator<T>(list: T[], forEach: (item: T, index: number, arr: T[]) => (any | Generator<any, any, any>)): Generator<any, any, any>;
+/**
+ * 数组 map 回调包装为生成器
+ *
+ * @description 回调中允许使用生成器
+ */
+export declare function wrapMapToGenerator<T, U>(list: T[], map: (item: T, index: number, arr: T[]) => (U | Generator<any, U, any>)): Generator<any, U[], any>;

package/dist/src/utils/traverse.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 用于遍历的节点接口
+ */
+export interface INode {
+    children?: Array<INode>;
+    [prop: string]: any;
+}
+/**
+ * 用于遍历的节点信息
+ */
+export interface INodeInfo<T extends INode> {
+    node: T;
+    parent?: T;
+    stack?: Array<T>;
+    nodePath?: string;
+    jsonPath?: string;
+    index?: number;
+    key?: string | number;
+}
+export interface TraverseOptions {
+    mode?: 'onlyChildren' | 'onlyArray' | 'anyObject';
+    depthFirst?: boolean;
+    backTracking?: boolean;
+    excludedKeySet?: Set<string>;
+}
+/**
+ * 遍历树
+ * @param func
+ * @param init 初始点信息
+ * @param options.mode 'onlyChildren' 表示只向下遍历 children 的元素（默认）；'onlyArray' 表示只向下遍历 Array 的元素；'anyObject' 表示只要属性为 Object 类型都会遍历
+ * @param options.depthFirst 默认广度优先搜索，是否深度优先搜索
+ * @example traverse((current) => console.log(current.node.name), { init: rootNode });
+ * @example traverse((current) => console.log(current.jsonPath), { init: ast }, { mode: 'anyObject' });
+ */
+export declare function traverse<T extends INode>(func: (current: INodeInfo<T>) => any, init: INodeInfo<T>, options?: TraverseOptions): any;
+export default traverse;

package/dist/src/utils/types.d.ts

@@ -0,0 +1,13 @@
+import type { SourceMap } from '../translator';
+import type { BaseNode } from '../common/BaseNode';
+export declare type GetPromise<T> = T extends Promise<infer R> ? R : never;
+export interface EmbeddedTSFileResult {
+    code: string;
+    filePath: string;
+    sourceMap: SourceMap;
+}
+export interface FileNode extends BaseNode {
+    getEmbeddedFilePath(name?: string): string;
+    toEmbeddedTSFile(): EmbeddedTSFileGenerator;
+}
+export declare type EmbeddedTSFileGenerator = Generator<void, EmbeddedTSFileResult, string>;

package/dist/src/utils/window.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 强制 gc
+ *
+ * @description Chrome 浏览器使用命令`open -a "Google Chrome" --args --js-flags="--expose-gc"`打开有效
+ * @description Nodejs 运行时加入参数`--expose-gc`有效
+ */
+export declare function gc(): void;

package/dist/test/concepts/anonymous-function/constant.d.ts

@@ -0,0 +1,2 @@
+export declare const ConceptName: string;
+export declare const cases: string[];

package/dist/test/concepts/anonymous-function/toEmbeddedTS.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/concepts/anonymous-function/toJS.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/concepts/anonymous-function/toVue.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/concepts/assignment/constant.d.ts

@@ -0,0 +1,2 @@
+export declare const ConceptName: string;
+export declare const cases: string[];

package/dist/test/concepts/assignment/toEmbeddedTS.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/concepts/assignment/toJS.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/concepts/assignment/toVue.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/concepts/batch-assignment/constant.d.ts

@@ -0,0 +1,2 @@
+export declare const ConceptName: string;
+export declare const cases: string[];

package/dist/test/concepts/batch-assignment/toEmbeddedTS.spec.d.ts

@@ -0,0 +1 @@
+export {};