@lcap/nasl 3.6.0-alpha.7 → 3.6.0-alpha.8

package/out/concepts/View__.d.ts

@@ -0,0 +1,747 @@
+import type { EmbeddedTSFileGenerator } from '../utils';
+import { TranslatorState, TranslatorGenerator } from '../translator';
+import { ElementToVueOptions } from './ViewElement__';
+import type Assignment from './Assignment__';
+import type BatchAssignment from './BatchAssignment__';
+import { EventPayload, Params } from '../common/EventEmitter';
+import BaseNode from '../common/BaseNode';
+import type StaticString from './StaticString__';
+import type ViewElement from './ViewElement__';
+import type Param from './Param__';
+import type Variable from './Variable__';
+import type Logic from './Logic__';
+import type BindEvent from './BindEvent__';
+import type Module from './Module__';
+import type Frontend from './Frontend__';
+import type App from './App__';
+/**
+ * 页面
+ */
+export declare class View extends BaseNode {
+    /** 类名 */
+    static readonly ConceptName: string;
+    /** 继承链 */
+    static readonly inheritanceChain: string[];
+    /**
+     * 产品概念
+     */
+    readonly concept: 'View';
+    /**
+     * 页面模板 Id
+     */
+    pageTemplateId: string;
+    /**
+     * 页面名称
+     */
+    name: string;
+    /**
+     * 唯一标识
+     */
+    uuid: string;
+    /**
+     * 页面标题
+     */
+    title: string;
+    /**
+     * 面包屑
+     */
+    crumb: StaticString;
+    /**
+     * 权限控制
+     */
+    auth: boolean;
+    /**
+     * 权限资源描述
+     */
+    authDescription: string;
+    /**
+     * 是否是默认跳转的页面
+     */
+    isIndex: boolean;
+    /**
+     * 未解析的模板代码
+     */
+    template: string;
+    /**
+     * 未解析的逻辑代码
+     */
+    script: string;
+    /**
+     * 未解析的样式代码
+     */
+    style: string;
+    /**
+     * 页面元素列表
+     */
+    elements: Array<ViewElement>;
+    /**
+     * 输入参数列表
+     */
+    params: Array<Param>;
+    /**
+     * 变量列表
+     */
+    variables: Array<Variable>;
+    /**
+     * 逻辑列表
+     */
+    logics: Array<Logic>;
+    /**
+     * 元素绑定事件列表
+     */
+    bindEvents: Array<BindEvent>;
+    /**
+     * 绑定的角色
+     */
+    bindRoles: Array<string>;
+    /**
+     * 页面列表
+     */
+    children: Array<View>;
+    /**
+     * 祖先 Module
+     */
+    get module(): Module;
+    /**
+     * 祖先 App
+     */
+    get app(): App;
+    /**
+     * 祖先 Frontend
+     */
+    get frontend(): Frontend;
+    /**
+     * @param source 需要合并的部分参数
+     */
+    constructor(source?: Partial<View>);
+    static from(source: any, parentNode?: any, parentKey?: string): View;
+    /**
+     * 从父级删除该节点
+     * @internal
+     */
+    _delete(): Params;
+    /**
+     * 设置页面名称
+     */
+    setName(name: string): void;
+    /**
+     * 设置页面标题
+     */
+    setTitle(title: string): void;
+    /**
+     * 设置面包屑
+     */
+    setCrumb(crumb: StaticString): void;
+    /**
+     * 设置权限控制
+     */
+    setAuth(auth: boolean): void;
+    /**
+     * 设置权限资源描述
+     */
+    setAuthDescription(authDescription: string): void;
+    /**
+     * 设置是否是默认跳转的页面
+     */
+    setIsIndex(isIndex: boolean): void;
+    /**
+     * 插入页面元素
+     * @internal
+     * @param name 页面元素名称，如果不填会自动生成一个唯一名称
+     */
+    _insertViewElementAt(name: string, index: number): ViewElement;
+    /**
+     * 插入页面元素
+     * @internal
+     * @param viewElementOptions 页面元素参数
+     */
+    _insertViewElementAt(viewElementOptions: Partial<ViewElement>, index: number): ViewElement;
+    /**
+     * 插入页面元素
+     * @internal
+     * @param viewElement 已有的页面元素实例
+     */
+    _insertViewElementAt(viewElement: ViewElement, index: number): ViewElement;
+    /**
+     * 插入页面元素
+     * @param name 页面元素名称，如果不填会自动生成一个唯一名称
+     */
+    insertViewElementAt(name: string, index: number): ViewElement;
+    /**
+     * 插入页面元素
+     * @param viewElementOptions 页面元素参数
+     */
+    insertViewElementAt(viewElementOptions: Partial<ViewElement>, index: number): ViewElement;
+    /**
+     * 插入页面元素
+     * @param viewElement 已有的页面元素实例
+     */
+    insertViewElementAt(viewElement: ViewElement, index: number): ViewElement;
+    /**
+     * 添加页面元素
+     * @internal
+     * @param name 页面元素名称，如果不填会自动生成一个唯一名称
+     */
+    _addViewElement(name?: string): ViewElement;
+    /**
+     * 添加页面元素
+     * @internal
+     * @param viewElementOptions 页面元素参数
+     */
+    _addViewElement(viewElementOptions: Partial<ViewElement>): ViewElement;
+    /**
+     * 添加页面元素
+     * @internal
+     * @param viewElement 已有的页面元素实例
+     */
+    _addViewElement(viewElement: ViewElement): ViewElement;
+    /**
+     * 添加页面元素
+     * @internal
+     * @param name 页面元素名称，如果不填会自动生成一个唯一名称
+     */
+    addViewElement(name?: string): ViewElement;
+    /**
+     * 添加页面元素
+     * @param viewElementOptions 页面元素参数
+     */
+    addViewElement(viewElementOptions: Partial<ViewElement>): ViewElement;
+    /**
+     * 添加页面元素
+     * @param viewElement 已有的页面元素实例
+     */
+    addViewElement(viewElement: ViewElement): ViewElement;
+    getParamUniqueName(name?: string): string;
+    /**
+     * 插入输入参数
+     * @internal
+     * @param name 输入参数名称，如果不填会自动生成一个唯一名称
+     */
+    _insertParamAt(name: string, index: number): Param;
+    /**
+     * 插入输入参数
+     * @internal
+     * @param paramOptions 输入参数参数
+     */
+    _insertParamAt(paramOptions: Partial<Param>, index: number): Param;
+    /**
+     * 插入输入参数
+     * @internal
+     * @param param 已有的输入参数实例
+     */
+    _insertParamAt(param: Param, index: number): Param;
+    /**
+     * 插入输入参数
+     * @param name 输入参数名称，如果不填会自动生成一个唯一名称
+     */
+    insertParamAt(name: string, index: number): Param;
+    /**
+     * 插入输入参数
+     * @param paramOptions 输入参数参数
+     */
+    insertParamAt(paramOptions: Partial<Param>, index: number): Param;
+    /**
+     * 插入输入参数
+     * @param param 已有的输入参数实例
+     */
+    insertParamAt(param: Param, index: number): Param;
+    /**
+     * 添加输入参数
+     * @internal
+     * @param name 输入参数名称，如果不填会自动生成一个唯一名称
+     */
+    _addParam(name?: string): Param;
+    /**
+     * 添加输入参数
+     * @internal
+     * @param paramOptions 输入参数参数
+     */
+    _addParam(paramOptions: Partial<Param>): Param;
+    /**
+     * 添加输入参数
+     * @internal
+     * @param param 已有的输入参数实例
+     */
+    _addParam(param: Param): Param;
+    /**
+     * 添加输入参数
+     * @internal
+     * @param name 输入参数名称，如果不填会自动生成一个唯一名称
+     */
+    addParam(name?: string): Param;
+    /**
+     * 添加输入参数
+     * @param paramOptions 输入参数参数
+     */
+    addParam(paramOptions: Partial<Param>): Param;
+    /**
+     * 添加输入参数
+     * @param param 已有的输入参数实例
+     */
+    addParam(param: Param): Param;
+    getVariableUniqueName(name?: string): string;
+    /**
+     * 插入变量
+     * @internal
+     * @param name 变量名称，如果不填会自动生成一个唯一名称
+     */
+    _insertVariableAt(name: string, index: number): Variable;
+    /**
+     * 插入变量
+     * @internal
+     * @param variableOptions 变量参数
+     */
+    _insertVariableAt(variableOptions: Partial<Variable>, index: number): Variable;
+    /**
+     * 插入变量
+     * @internal
+     * @param variable 已有的变量实例
+     */
+    _insertVariableAt(variable: Variable, index: number): Variable;
+    /**
+     * 插入变量
+     * @param name 变量名称，如果不填会自动生成一个唯一名称
+     */
+    insertVariableAt(name: string, index: number): Variable;
+    /**
+     * 插入变量
+     * @param variableOptions 变量参数
+     */
+    insertVariableAt(variableOptions: Partial<Variable>, index: number): Variable;
+    /**
+     * 插入变量
+     * @param variable 已有的变量实例
+     */
+    insertVariableAt(variable: Variable, index: number): Variable;
+    /**
+     * 添加变量
+     * @internal
+     * @param name 变量名称，如果不填会自动生成一个唯一名称
+     */
+    _addVariable(name?: string): Variable;
+    /**
+     * 添加变量
+     * @internal
+     * @param variableOptions 变量参数
+     */
+    _addVariable(variableOptions: Partial<Variable>): Variable;
+    /**
+     * 添加变量
+     * @internal
+     * @param variable 已有的变量实例
+     */
+    _addVariable(variable: Variable): Variable;
+    /**
+     * 添加变量
+     * @internal
+     * @param name 变量名称，如果不填会自动生成一个唯一名称
+     */
+    addVariable(name?: string): Variable;
+    /**
+     * 添加变量
+     * @param variableOptions 变量参数
+     */
+    addVariable(variableOptions: Partial<Variable>): Variable;
+    /**
+     * 添加变量
+     * @param variable 已有的变量实例
+     */
+    addVariable(variable: Variable): Variable;
+    getLogicUniqueName(name?: string): string;
+    /**
+     * 插入逻辑
+     * @internal
+     * @param name 逻辑名称，如果不填会自动生成一个唯一名称
+     */
+    _insertLogicAt(name: string, index: number): Logic;
+    /**
+     * 插入逻辑
+     * @internal
+     * @param logicOptions 逻辑参数
+     */
+    _insertLogicAt(logicOptions: Partial<Logic>, index: number): Logic;
+    /**
+     * 插入逻辑
+     * @internal
+     * @param logic 已有的逻辑实例
+     */
+    _insertLogicAt(logic: Logic, index: number): Logic;
+    /**
+     * 插入逻辑
+     * @param name 逻辑名称，如果不填会自动生成一个唯一名称
+     */
+    insertLogicAt(name: string, index: number): Logic;
+    /**
+     * 插入逻辑
+     * @param logicOptions 逻辑参数
+     */
+    insertLogicAt(logicOptions: Partial<Logic>, index: number): Logic;
+    /**
+     * 插入逻辑
+     * @param logic 已有的逻辑实例
+     */
+    insertLogicAt(logic: Logic, index: number): Logic;
+    /**
+     * 添加逻辑
+     * @internal
+     * @param name 逻辑名称，如果不填会自动生成一个唯一名称
+     */
+    _addLogic(name?: string): Logic;
+    /**
+     * 添加逻辑
+     * @internal
+     * @param logicOptions 逻辑参数
+     */
+    _addLogic(logicOptions: Partial<Logic>): Logic;
+    /**
+     * 添加逻辑
+     * @internal
+     * @param logic 已有的逻辑实例
+     */
+    _addLogic(logic: Logic): Logic;
+    /**
+     * 添加逻辑
+     * @internal
+     * @param name 逻辑名称，如果不填会自动生成一个唯一名称
+     */
+    addLogic(name?: string): Logic;
+    /**
+     * 添加逻辑
+     * @param logicOptions 逻辑参数
+     */
+    addLogic(logicOptions: Partial<Logic>): Logic;
+    /**
+     * 添加逻辑
+     * @param logic 已有的逻辑实例
+     */
+    addLogic(logic: Logic): Logic;
+    getBindEventExistingNames(excludedList?: Array<BindEvent>): string[];
+    getBindEventUniqueName(name?: string): string;
+    /**
+     * 插入元素绑定事件
+     * @internal
+     * @param name 元素绑定事件名称，如果不填会自动生成一个唯一名称
+     */
+    _insertBindEventAt(name: string, index: number): BindEvent;
+    /**
+     * 插入元素绑定事件
+     * @internal
+     * @param bindEventOptions 元素绑定事件参数
+     */
+    _insertBindEventAt(bindEventOptions: Partial<BindEvent>, index: number): BindEvent;
+    /**
+     * 插入元素绑定事件
+     * @internal
+     * @param bindEvent 已有的元素绑定事件实例
+     */
+    _insertBindEventAt(bindEvent: BindEvent, index: number): BindEvent;
+    /**
+     * 插入元素绑定事件
+     * @param name 元素绑定事件名称，如果不填会自动生成一个唯一名称
+     */
+    insertBindEventAt(name: string, index: number): BindEvent;
+    /**
+     * 插入元素绑定事件
+     * @param bindEventOptions 元素绑定事件参数
+     */
+    insertBindEventAt(bindEventOptions: Partial<BindEvent>, index: number): BindEvent;
+    /**
+     * 插入元素绑定事件
+     * @param bindEvent 已有的元素绑定事件实例
+     */
+    insertBindEventAt(bindEvent: BindEvent, index: number): BindEvent;
+    /**
+     * 添加元素绑定事件
+     * @internal
+     * @param name 元素绑定事件名称，如果不填会自动生成一个唯一名称
+     */
+    _addBindEvent(name?: string): BindEvent;
+    /**
+     * 添加元素绑定事件
+     * @internal
+     * @param bindEventOptions 元素绑定事件参数
+     */
+    _addBindEvent(bindEventOptions: Partial<BindEvent>): BindEvent;
+    /**
+     * 添加元素绑定事件
+     * @internal
+     * @param bindEvent 已有的元素绑定事件实例
+     */
+    _addBindEvent(bindEvent: BindEvent): BindEvent;
+    /**
+     * 添加元素绑定事件
+     * @internal
+     * @param name 元素绑定事件名称，如果不填会自动生成一个唯一名称
+     */
+    addBindEvent(name?: string): BindEvent;
+    /**
+     * 添加元素绑定事件
+     * @param bindEventOptions 元素绑定事件参数
+     */
+    addBindEvent(bindEventOptions: Partial<BindEvent>): BindEvent;
+    /**
+     * 添加元素绑定事件
+     * @param bindEvent 已有的元素绑定事件实例
+     */
+    addBindEvent(bindEvent: BindEvent): BindEvent;
+    getViewExistingNames(excludedList?: Array<View>): string[];
+    getViewUniqueName(name?: string): string;
+    /**
+     * 插入页面
+     * @internal
+     * @param name 页面名称，如果不填会自动生成一个唯一名称
+     */
+    _insertViewAt(name: string, index: number): View;
+    /**
+     * 插入页面
+     * @internal
+     * @param viewOptions 页面参数
+     */
+    _insertViewAt(viewOptions: Partial<View>, index: number): View;
+    /**
+     * 插入页面
+     * @internal
+     * @param view 已有的页面实例
+     */
+    _insertViewAt(view: View, index: number): View;
+    /**
+     * 插入页面
+     * @param name 页面名称，如果不填会自动生成一个唯一名称
+     */
+    insertViewAt(name: string, index: number): View;
+    /**
+     * 插入页面
+     * @param viewOptions 页面参数
+     */
+    insertViewAt(viewOptions: Partial<View>, index: number): View;
+    /**
+     * 插入页面
+     * @param view 已有的页面实例
+     */
+    insertViewAt(view: View, index: number): View;
+    /**
+     * 添加页面
+     * @internal
+     * @param name 页面名称，如果不填会自动生成一个唯一名称
+     */
+    _addView(name?: string): View;
+    /**
+     * 添加页面
+     * @internal
+     * @param viewOptions 页面参数
+     */
+    _addView(viewOptions: Partial<View>): View;
+    /**
+     * 添加页面
+     * @internal
+     * @param view 已有的页面实例
+     */
+    _addView(view: View): View;
+    /**
+     * 添加页面
+     * @internal
+     * @param name 页面名称，如果不填会自动生成一个唯一名称
+     */
+    addView(name?: string): View;
+    /**
+     * 添加页面
+     * @param viewOptions 页面参数
+     */
+    addView(viewOptions: Partial<View>): View;
+    /**
+     * 添加页面
+     * @param view 已有的页面实例
+     */
+    addView(view: View): View;
+    /**
+     * 删除静态字符串
+     * @param name 静态字符串名称
+     */
+    removeCrumb(name: string): void;
+    /**
+     * 删除静态字符串
+     * @param crumb 已有的静态字符串实例
+     */
+    removeCrumb(crumb: StaticString): void;
+    __removeStaticString(staticString: StaticString): Params;
+    /**
+     * 删除页面元素
+     * @param name 页面元素名称
+     */
+    removeViewElement(name: string): void;
+    /**
+     * 删除页面元素
+     * @param viewElement 已有的页面元素实例
+     */
+    removeViewElement(viewElement: ViewElement): void;
+    __removeViewElement(viewElement: ViewElement): Params;
+    /**
+     * 删除输入参数
+     * @param name 输入参数名称
+     */
+    removeParam(name: string): void;
+    /**
+     * 删除输入参数
+     * @param param 已有的输入参数实例
+     */
+    removeParam(param: Param): void;
+    __removeParam(param: Param): Params;
+    /**
+     * 删除变量
+     * @param name 变量名称
+     */
+    removeVariable(name: string): void;
+    /**
+     * 删除变量
+     * @param variable 已有的变量实例
+     */
+    removeVariable(variable: Variable): void;
+    __removeVariable(variable: Variable): Params;
+    /**
+     * 删除逻辑
+     * @param name 逻辑名称
+     */
+    removeLogic(name: string): void;
+    /**
+     * 删除逻辑
+     * @param logic 已有的逻辑实例
+     */
+    removeLogic(logic: Logic): void;
+    __removeLogic(logic: Logic): Params;
+    /**
+     * 删除元素绑定事件
+     * @param name 元素绑定事件名称
+     */
+    removeBindEvent(name: string): void;
+    /**
+     * 删除元素绑定事件
+     * @param bindEvent 已有的元素绑定事件实例
+     */
+    removeBindEvent(bindEvent: BindEvent): void;
+    __removeBindEvent(bindEvent: BindEvent): Params;
+    /**
+     * 删除页面
+     * @param name 页面名称
+     */
+    removeView(name: string): void;
+    /**
+     * 删除页面
+     * @param view 已有的页面实例
+     */
+    removeView(view: View): void;
+    __removeView(view: View): Params;
+    get parentAuth(): boolean;
+    /**
+     * 设置页面权限
+     */
+    setBindRoles(bindRoles: string[]): void;
+    findLogicByName(name: string): Logic;
+    existingViewElement: Set<string>;
+    collectExistingViewElementName(excludedList?: Array<ViewElement>): void;
+    getViewElementExistingNames(excludedList?: Array<ViewElement>): string[];
+    getViewElementUniqueName(name?: string): string;
+    getViewElementUniqueNameOld(name?: string): string;
+    getAllViewElementNames(excludeName: string): string[];
+    isValidElementName(name: string): boolean;
+    static readonly TAG_NAME_PREFIX_REG?: RegExp;
+    mergeBlock({ code, nodePath, position, cb }: {
+        code: string;
+        nodePath: string;
+        position: string;
+        cb?: Function;
+    }): ViewElement;
+    onChange($event?: EventPayload): void;
+    getLogicExistingNames(excludedList?: Array<Logic>): any[];
+    getVarExistingNames(excludedList?: Array<Param | Variable>): any[];
+    /**
+     * 生成 Vue 中需要的 JS 代码
+     * @TODO 这一版先做成 componentOptions 式的，后面再美化
+     */
+    genScript(): string;
+    genVueTemplate(options?: ElementToVueOptions): string;
+    /**
+     * 转换成 Vue 文件
+     */
+    toVue(options?: ElementToVueOptions): string;
+    /**
+     * 转换成设计器中使用的 Vue template 内容
+     * @param options
+     */
+    genDesignerVueTemplate(): string;
+    /**
+     * 转换成设计器中使用的 Vue 文件
+     * 目前不需要 script 和 style
+     * @param options
+     */
+    toDesignerVue(): string;
+    /**
+     * 转换成 VueOptions
+     * @TODO 后面 template 可以优化成 render 函数
+     */
+    toVueOptions(options?: ElementToVueOptions): {
+        template: string;
+        script: string;
+    };
+    /**
+     * 生成宿主语言的文件路径
+     * @param name 一般不用传，用于 rename
+     */
+    getEmbeddedFilePath(name?: string): string;
+    getNamespace(): string;
+    getTsNamespace(): string;
+    elementsMethods(elements: Array<ViewElement>, allMethods: Array<ViewElement>, parentNodeNames: Array<string>): void;
+    elementsAttrs(elements: Array<ViewElement>, componentList: Array<ViewElement>): void;
+    elementsAttrsAll(elements: Array<ViewElement>, componentListExtra: Array<ViewElement>): void;
+    toEmbeddedTS(state?: TranslatorState): TranslatorGenerator;
+    toNaturalTS(state?: TranslatorState, currentNode?: BaseNode, declaration?: boolean): string;
+    toEmbeddedTSFile(): EmbeddedTSFileGenerator;
+    get uiPath(): string;
+    get path(): string;
+    /**
+     * 权限领域的资源路径
+     */
+    get authPath(): string;
+    /**
+     * 获取当前页面下所有elements上bindEvents下的logic
+     */
+    elementLogicRoot: any[];
+    getElementLogicRoot(): void;
+    getViewBindEvents(): BindEvent[];
+    getViewExpressions(): any[];
+    /**
+     * @param path 子路径
+     * 比如当前页面路径为：/dashboard
+     * path 为要查找子路径：如 /student/list、student/list
+     */
+    findViewByPath(path: string): View;
+    findViewByName(name: string): View;
+    findElementByName(name: string): ViewElement;
+    findElementByTag(tag: string): ViewElement;
+    findElementByAttr(name: string, value: string): ViewElement;
+    _setAsIndexView(isIndex: boolean): void;
+    setAsIndexView(isIndex: boolean): void;
+    removeExistingViewElement(viewElement: ViewElement): void;
+    getRightCode(code: string, assignment: Assignment | BatchAssignment, rightNode: any): Generator<any, string, any>;
+    handleReplaceCode(code: string, variable: string, replaceCode: string): string;
+    getAncestorViewElementsWithDataSource(logic: Logic): ViewElement[];
+    handleCurrentItemCode(code: string, logic: Logic): Generator<any, string, any>;
+    /**
+     * 该视图是否有子页面容器
+     */
+    hasRouterView(): boolean;
+    getViewCallLogics(): string[];
+}
+export default View;
+declare type AttrObject = {
+    value: string;
+    label: string;
+};
+export declare const PAGE_COMPONENT_INCLUDE_TAG_MAP: Record<string, Record<string, AttrObject>>;
+/**
+ * 组件支持补全取值的属性映射
+ * prop 组件属性
+ * state 组件内部状态
+ */
+export declare const ComponentCompletionPropertyMap: Record<string, any>;
+export declare const FrontendTypeComponentNamePerfixMap: Record<string, string>;
+export declare function getComponentNameFromElementName(name: string, frontendType?: string): string;