@yelon/util 19.1.0 → 20.0.0-beta.0

package/array/array.service.d.ts

@@ -1,78 +0,0 @@
-import { YunzaiConfigService } from '@yelon/util/config';
-import { NzTreeNode } from 'ng-zorro-antd/core/tree';
-import { ArrayServiceArrToTreeNodeOptions, ArrayServiceArrToTreeOptions, ArrayServiceGetKeysByTreeNodeOptions, ArrayServiceGroupByResult, ArrayServiceTreeToArrOptions } from './array-type.service';
-import * as i0 from "@angular/core";
-export declare class ArrayService {
-    private c;
-    constructor(cog: YunzaiConfigService);
-    /**
-     * Convert tree structure to array structure
-     *
-     * 将树结构转换成数组结构
-     */
-    treeToArr<T extends object = any>(tree: readonly T[], options?: ArrayServiceTreeToArrOptions<T>): T[];
-    /**
-     * Convert array structure to tree structure
-     *
-     * 数组转换成树数据
-     */
-    arrToTree<T extends object = any>(arr: readonly T[], options?: ArrayServiceArrToTreeOptions<T>): T[];
-    /**
-     * 数组转换成 `nz-tree` 数据源，通过 `options` 转化项名，也可以使用 `options.cb` 更高级决定数据项
-     */
-    arrToTreeNode<T extends object = any>(arr: readonly T[], options?: ArrayServiceArrToTreeNodeOptions): NzTreeNode[];
-    /**
-     * 递归访问整个树
-     */
-    visitTree<T extends object = any>(tree: readonly T[], cb: (item: T, parent: T | null, deep: number) => void, options?: {
-        /** 子项名，默认：`'children'` */
-        childrenMapName?: string;
-    }): void;
-    /**
-     * Return the value of the first tree value in the tree where predicate is true, and `undefined` otherwise
-     *
-     * 根据条件返回树的第一个值，否则返回 `undefined`
-     */
-    findTree<T extends object = any>(tree: readonly T[], predicate: (item: T) => boolean, options?: {
-        /** 子项名，默认：`'children'` */
-        childrenMapName?: string;
-    }): T | undefined;
-    /**
-     * 获取所有已经选中的 `key` 值
-     */
-    getKeysByTreeNode(tree: NzTreeNode[], options?: ArrayServiceGetKeysByTreeNodeOptions): any[];
-    private baseFlat;
-    /**
-     * Recursively flattens array
-     *
-     * 递归扁平数组
-     * ```ts
-     * srv.flat([1, [2, 3, [4, 5, [6]]]]) => [1,2,3,4,5,6]
-     * srv.flat([1, [2, 3, [4, 5, [6]]]], 1) => [1,2,3,[4, 5, [6]]]
-     * ```
-     */
-    flat<T>(array: readonly T[], depth?: number): T[];
-    /**
-     * Group the array
-     *
-     * 对数组进行分组
-     * ```ts
-     * srv.groupBy([6.1, 4.2, 6.3], Math.floor) => {"4":[4.2],"6":[6.1,6.3]}
-     * srv.groupBy(['one', 'two', 'three'], v => v.length) => {"3":["one","two"],"5":["three"]}
-     * ```
-     */
-    groupBy<T>(array: readonly T[], iteratee: (value: T) => string | number): ArrayServiceGroupByResult;
-    /**
-     * Creates a duplicate-free version of an array
-     *
-     * 创建去重后的数组
-     * ```ts
-     * uniq([1, 2, 2, 3, 1]) => [1,2,3]
-     * uniq([{ a: 1 }, { a: 1 }, { a: 2 }], 'a') => [{"a":1},{"a":2}]
-     * uniq([{ a: 1 }, { a: 1 }, { a: 2 }], i => (i.a === 1 ? 'a' : 'b')) => [{"a":1},{"a":2}]
-     * ```
-     */
-    uniq<T>(array: readonly T[], predicate?: string | ((value: T) => string | number | boolean)): T[];
-    static ɵfac: i0.ɵɵFactoryDeclaration<ArrayService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ArrayService>;
-}

package/browser/cookie.service.d.ts

@@ -1,62 +0,0 @@
-import * as i0 from "@angular/core";
-export interface CookieOptions {
-    path?: string;
-    domain?: string;
-    /**
-     * Expiration time, `number` is seconds
-     *
-     * 过期时间，`number` 类型表示秒数
-     */
-    expires?: number | Date | string;
-    secure?: boolean;
-    HttpOnly?: boolean;
-    SameSite?: boolean | 'lax' | 'strict' | 'none';
-}
-/**
- * A set of simple Cookie manipulation classes.
- *
- * 一组简单的 Cookie 操作类。
- */
-export declare class CookieService {
-    private readonly _doc;
-    private readonly platform;
-    private get doc();
-    /**
-     * Original cookie value
-     *
-     * 原始Cookie值
-     */
-    get cookie(): string;
-    /**
-     * Get all cookie key-value pairs
-     *
-     * 获取所有Cookie键值对
-     */
-    getAll(): Record<string, string>;
-    /**
-     * Get the value of given cookie `key`
-     *
-     * 获取指定 `key` 的值
-     */
-    get(key: string): string | undefined;
-    /**
-     * Sets a value for given cookie key
-     *
-     * 设置指定 Cookie 键的值
-     */
-    put(key: string, value: string, options?: CookieOptions): void;
-    /**
-     * Remove given cookie
-     *
-     * 移除指定 Cookie
-     */
-    remove(key: string, options?: CookieOptions): void;
-    /**
-     * Remove all cookies
-     *
-     * 移除所有 Cookies
-     */
-    removeAll(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CookieService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<CookieService>;
-}

package/browser/copy.d.ts

@@ -1,6 +0,0 @@
-/**
- * Copy text to clipboard
- *
- * 复制字符串文档至剪贴板
- */
-export declare function copy(value: string): Promise<string>;

package/browser/is-empty.d.ts

@@ -1,6 +0,0 @@
-/**
- * Used to verify `<ng-content />` is empty, useful for custom components.
- *
- * 用于校验 `<ng-content />` 是否为空，自定义组件时蛮有用。
- */
-export declare function isEmpty(element: HTMLElement): boolean;

package/browser/scroll.service.d.ts

@@ -1,34 +0,0 @@
-import * as i0 from "@angular/core";
-export declare class ScrollService {
-    private readonly _doc;
-    private readonly platform;
-    private _getDoc;
-    private _getWin;
-    /**
-     * 获取滚动条位置
-     *
-     * @param element 指定元素，默认 `window`
-     */
-    getScrollPosition(element?: Element | Window | null): [number, number];
-    /**
-     * 设置滚动条位置
-     *
-     * @param element 指定元素
-     */
-    scrollToPosition(element: Element | Window | null | undefined, position: [number, number]): void;
-    /**
-     * 设置滚动条至指定元素
-     *
-     * @param element 指定元素，默认 `document.body`
-     * @param topOffset 偏移值，默认 `0`
-     */
-    scrollToElement(element?: Element | null, topOffset?: number): void;
-    /**
-     * 滚动至顶部
-     *
-     * @param topOffset 偏移值，默认 `0`
-     */
-    scrollToTop(topOffset?: number): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ScrollService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ScrollService>;
-}

package/browser/style.d.ts

@@ -1,19 +0,0 @@
-import { Renderer2 } from '@angular/core';
-/**
- * Update host component style `class`
- *
- * 更新宿主组件样式 `class`
- *
- * ```ts
- * updateHostClass(
- *  this.el.nativeElement,
- *  this.renderer,
- *  {
- *    [ 'classname' ]: true,
- *    [ 'classname' ]: this.type === '1',
- *    [ this.cls ]: true,
- *    [ `a-${this.cls}` ]: true
- *  })
- * ```
- */
-export declare function updateHostClass(el: HTMLElement, renderer: Renderer2, classMap: Record<string, unknown>, preClean?: boolean): void;

package/config/abc/cell.type.d.ts

@@ -1,118 +0,0 @@
-import type { NzImagePreviewOptions } from 'ng-zorro-antd/image';
-export interface YunzaiCellConfig {
-    /**
-     * Size
-     *
-     * 大小
-     */
-    size?: 'large' | 'small';
-    /**
-     * Default Text
-     *
-     * 默认文本
-     */
-    default?: {
-        text?: string;
-        condition?: unknown;
-    };
-    /**
-     * 日期
-     */
-    date?: {
-        /**
-         * 格式化字符，默认：`yyyy-MM-dd HH:mm:ss`
-         */
-        format?: string;
-    };
-    /**
-     * 货币
-     */
-    currency?: {
-        /**
-         * The starting unit of the value, `yuan` means 元, `cent` means 分, default: `yuan`
-         *
-         * 值的起始单位，`yuan` 元，`cent` 分，默认：`yuan`
-         */
-        startingUnit?: 'yuan' | 'cent';
-        /**
-         * Using `DEFAULT_CURRENCY_CODE` when value is `true
-         *
-         * 是否使用 `CurrencyPipe` 来替代
-         */
-        useAngular?: boolean;
-        /**
-         * 精度，默认：`2`
-         */
-        precision?: number;
-        /**
-         * 是否忽略精度 `.0` 或 `.00` 结尾的字符，默认：`true`
-         */
-        ignoreZeroPrecision?: boolean;
-        /**
-         * Use anguar `currency` pipe parse when is set, pls refer to [document](https://angular.io/api/common/CurrencyPipe)
-         *
-         * 若指定则表示使用 Angular 自带的 `currency` 管道来解析，见[文档](https://angular.cn/api/common/CurrencyPipe)
-         */
-        ngCurrency?: {
-            display: 'code' | 'symbol' | 'symbol-narrow';
-            currencyCode?: string;
-            digitsInfo?: string;
-            locale?: string;
-        };
-    };
-    /**
-     * Converted into RMB notation
-     *
-     * 转化成人民币表示法
-     */
-    cny?: {
-        /**
-         * The starting unit of the value, `yuan` means 元, `cent` means 分, default: `yuan`
-         *
-         * 值的起始单位，`yuan` 元，`cent` 分，默认：`yuan`
-         */
-        startingUnit?: 'yuan' | 'cent';
-        /**
-         * Whether to return to uppercase notation, default: `true`
-         *
-         * 是否返回大写表示法，默认：`true`
-         */
-        inWords?: boolean;
-        /**
-         * Specify negative sign, default: `negative`
-         *
-         * 指定负数符号，默认：`负`
-         */
-        minusSymbol?: string;
-    };
-    /**
-     * 布尔
-     */
-    boolean?: {
-        yes?: string;
-        no?: string;
-        mode?: 'full' | 'icon' | 'text';
-    };
-    /**
-     * Image config, support large image preview
-     *
-     * 图像配置，支持大图预览
-     */
-    img?: {
-        /**
-         * 大小，默认：`32`
-         */
-        size?: number;
-        /**
-         * 是否允许点击查看大图，默认：`true`
-         */
-        big?: boolean;
-        previewOptions?: NzImagePreviewOptions;
-    };
-    /**
-     * HTML 配置
-     */
-    html?: {
-        safe?: 'text' | 'html' | 'safeHtml';
-    };
-}

package/config/abc/date-picker.type.d.ts

@@ -1,49 +0,0 @@
-import type { DisabledTimeFn, NzDateMode, PresetRanges, SupportTimeOptions } from 'ng-zorro-antd/date-picker';
-export interface YunzaiDateRangePickerConfig {
-    /**
-     * 默认：`yyyy-MM-dd`
-     */
-    nzFormat?: string;
-    nzClassName?: string;
-    nzSize?: string;
-    nzStyle?: string;
-    /**
-     * 默认：`true`
-     */
-    nzAllowClear?: boolean;
-    /**
-     * 默认：`false`
-     */
-    nzAutoFocus?: boolean;
-    nzDisabledDate?: (d: Date) => boolean;
-    nzDisabledTime?: DisabledTimeFn;
-    /**
-     * 默认：`{ position: 'relative' }`
-     */
-    nzPopupStyle?: Record<string, unknown>;
-    nzDropdownClassName?: string;
-    nzRenderExtraFooter?: string;
-    nzShowTime?: SupportTimeOptions | boolean;
-    /**
-     * 默认：`true`
-     */
-    nzShowToday?: boolean;
-    nzMode?: NzDateMode | NzDateMode[];
-    nzRanges?: PresetRanges;
-    shortcuts?: YunzaiDateRangePickerShortcut;
-}
-export interface YunzaiDateRangePickerShortcut {
-    /** Whether to enable, default: `false` */
-    enabled?: boolean;
-    /** Whether to close the panel after clicking, default: `true` */
-    closed?: boolean;
-    /**
-     * Shortcut list, default: `今天`, `昨天`, `近3天`, `近7天`, `本周`, `本月`, `全年`
-     */
-    list?: YunzaiDateRangePickerShortcutItem[];
-}
-export interface YunzaiDateRangePickerShortcutItem {
-    [key: string]: any;
-    text: string;
-    fn: (value: Array<Date | null>) => [Date | null, Date | null];
-}

package/config/abc/error-collect.type.d.ts

@@ -1,10 +0,0 @@
-export interface YunzaiErrorCollectConfig {
-    /**
-     * 监听频率，默认：`500`
-     */
-    freq?: number;
-    /**
-     * 顶部偏移值，默认：`145`
-     */
-    offsetTop?: number;
-}

package/config/abc/exception.type.d.ts

@@ -1,7 +0,0 @@
-export interface YunzaiExceptionType {
-    typeDict?: Record<number | string, {
-        img: string;
-        title: string;
-        desc?: string;
-    }>;
-}

package/config/abc/image.type.d.ts

@@ -1,15 +0,0 @@
-import type { ModalOptions } from 'ng-zorro-antd/modal';
-export interface YunzaiImageConfig {
-    /**
-     * 默认大小，默认值：`64`，单位：px
-     */
-    size?: number;
-    /**
-     * 错误图片，默认：`./assets/img/logo.svg`
-     */
-    error?: string;
-    /**
-     * 预览大图对话框参数
-     */
-    previewModalOptions?: ModalOptions;
-}

package/config/abc/index.d.ts

@@ -1,17 +0,0 @@
-export * from './error-collect.type';
-export * from './image.type';
-export * from './date-picker.type';
-export * from './loading.type';
-export * from './lodop.type';
-export * from './page-header.type';
-export * from './se.type';
-export * from './sv.type';
-export * from './sg.type';
-export * from './st.type';
-export * from './xlsx.type';
-export * from './zip.type';
-export * from './media.type';
-export * from './pdf.type';
-export * from './onboarding.type';
-export * from './cell.type';
-export * from './exception.type';

package/config/abc/loading.type.d.ts

@@ -1,29 +0,0 @@
-import { SafeHtml } from '@angular/platform-browser';
-export interface YunzaiLoadingConfig {
-    /**
-     * 类型，默认：`spin`
-     */
-    type?: 'text' | 'icon' | 'spin' | 'custom';
-    /**
-     * 显示文本，默认：`加载中...`
-     */
-    text?: string;
-    icon?: {
-        /** `nz-icon.nzType`，默认：`loading` */
-        type?: string;
-        /** `nz-icon.nzTheme`，默认：`outline` */
-        theme?: 'fill' | 'outline' | 'twotone';
-        /** `nz-icon.nzSpin`，默认：`true` */
-        spin?: boolean;
-    };
-    custom?: {
-        html?: string | SafeHtml;
-        style?: Record<string, unknown>;
-    };
-    /**
-     * 延迟，默认：`0`
-     */
-    delay?: number;
-    /** 文字方向 */
-    direction?: 'ltr' | 'rtl';
-}

package/config/abc/lodop.type.d.ts

@@ -1,33 +0,0 @@
-export interface YunzaiLodopConfig {
-    /**
-     * 注册信息：主注册号
-     */
-    license?: string;
-    /**
-     * 注册信息：附加注册号A
-     */
-    licenseA?: string;
-    /**
-     * 注册信息：附加注册号B
-     */
-    licenseB?: string;
-    /**
-     * 注册信息：注册单位名称
-     */
-    companyName?: string;
-    /**
-     * Lodop 远程脚本URL地址，**注意**务必使用 `name` 属性指定变量值
-     *
-     * - http://localhost:18000/CLodopfuncs.js [默认]
-     * - https://localhost:8443/CLodopfuncs.js
-     */
-    url?: string;
-    /**
-     * Lodop 变量名，默认：`CLODOP`
-     */
-    name?: string;
-    /**
-     * 检查次数，默认 `100`，当检查超过时视为异常，这是因为 Lodop 需要连接 WebSocket
-     */
-    checkMaxCount?: number;
-}

package/config/abc/media.type.d.ts

@@ -1,10 +0,0 @@
-export interface YunzaiMediaConfig {
-    /**
-     * Plyr library path, default: `["https://cdn.bootcdn.net/ajax/libs/plyr/3.5.10/plyr.min.js", "https://cdn.bootcdn.net/ajax/libs/plyr/3.5.10/plyr.css"]`
-     */
-    urls?: string[];
-    /**
-     * Please refer to [plyr options](https://github.com/sampotts/plyr#options)
-     */
-    options?: any;
-}

package/config/abc/onboarding.type.d.ts

@@ -1,4 +0,0 @@
-export interface YunzaiOnboardingConfig {
-    /** 文字方向 */
-    direction?: 'ltr' | 'rtl';
-}

package/config/abc/page-header.type.d.ts

@@ -1,39 +0,0 @@
-export interface YunzaiPageHeaderConfig {
-    /**
-     * 首页文本，若指定空表示不显示，默认：`首页`
-     */
-    home?: string;
-    /**
-     * 首页链接，默认：`/`
-     */
-    homeLink?: string;
-    /**
-     * 首页链接国际化参数
-     */
-    homeI18n?: string;
-    /**
-     * 自动生成导航，以当前路由从主菜单中定位，默认：`true`
-     */
-    autoBreadcrumb?: boolean;
-    /**
-     * 自动向上递归查找，默认：`false`
-     *  - 菜单数据源包含 `/ware`，则 `/ware/1` 也视为 `/ware` 项
-     */
-    recursiveBreadcrumb?: boolean;
-    /**
-     * 自动生成标题，以当前路由从主菜单中定位，默认：`true`
-     */
-    autoTitle?: boolean;
-    /**
-     * 是否自动将标准信息同步至 `TitleService`、`ReuseService` 下，默认：`true`
-     */
-    syncTitle?: boolean;
-    /**
-     * 是否固定模式，默认：`false`
-     */
-    fixed?: boolean;
-    /**
-     * 固定偏移值，默认：`64`
-     */
-    fixedOffsetTop?: number;
-}

package/config/abc/pdf.type.d.ts

@@ -1,35 +0,0 @@
-export interface YunzaiPdfConfig {
-    /**
-     * [pdf.js](https://github.com/mozilla/pdf.js) library root url, Default: `https://cdn.jsdelivr.net/npm/pdfjs-dist@3.6.x/`
-     *
-     * **Note** That only the root path, muse be ending with `/`
-     */
-    lib?: string;
-    /**
-     * Show single or all pages altogether, Default: `true`
-     */
-    showAll?: boolean;
-    /**
-     * Enable text rendering, allows to select text, Default: `true`
-     */
-    renderText?: boolean;
-    /**
-     * Show page borders, Default: `false`
-     */
-    showBorders?: boolean;
-    /**
-     * Default: `true`
-     * - if set to `true` - size will be as same as original document
-     * - if set to `false` - size will be as same as container block
-     */
-    originalSize?: boolean;
-    /**
-     * You can show your document in original size, and make sure that it's not bigger then container block. Default: `false`
-     */
-    fitToPage?: boolean;
-    /**
-     * Turn on or off auto resize, Default: `true`
-     * **Important** To make work - make sure that `[originalSize]="false"` and pdf-viewer tag has `max-width` or `display` are set.
-     */
-    autoReSize?: boolean;
-}

package/config/abc/se.type.d.ts

@@ -1,32 +0,0 @@
-export interface YunzaiSEConfig {
-    /**
-     * 大小，默认：`default`
-     * - `compact` 紧凑型，强制忽略 `error`、`extra` 展示
-     */
-    size?: 'default' | 'compact';
-    /**
-     * 布局类型，等同 `nzLayout`，默认：`horizontal`
-     * - `inline` 时强制大小为 `compact`
-     */
-    nzLayout?: 'horizontal' | 'vertical' | 'inline';
-    /**
-     * 间距，当 `nzLayout:horizontal` 时有效，默认：`32`
-     */
-    gutter?: number;
-    /**
-     * 列数，默认：`2`
-     */
-    col?: number;
-    /**
-     * 标签文本宽度，单位：`px`，默认：`150`
-     */
-    labelWidth?: number;
-    /**
-     * 是否立即呈现错误视觉，默认：`false`
-     */
-    firstVisual?: boolean;
-    /**
-     * 是否忽略 `dirty` 校验，默认：`false`
-     */
-    ignoreDirty?: boolean;
-}

package/config/abc/sg.type.d.ts

@@ -1,10 +0,0 @@
-export interface YunzaiSGConfig {
-    /**
-     * 间距，默认：`32`
-     */
-    gutter?: number;
-    /**
-     * 列数，默认：`2`
-     */
-    col?: number;
-}