nhanh-pure-function 4.1.0 → 4.2.1

package/dist/Canvas/Axis/LayerGroup/index.d.ts

@@ -23,7 +23,7 @@ export default class LayerGroup extends EventController {
     /** 删除图层 */
     removeLayer(layers: Layer | Layer[]): void;
     /** 清空图层 */
-    clearLayers(): void;
+    clearLayer(): void;
     /** 收集图层的 canvas */
     fetchCanvas(): [number, HTMLCanvasElement, [[number, number], OverlayType][]][];
 }

package/dist/Canvas/Axis/OverlayCreator/index.d.ts

@@ -24,17 +24,15 @@ export default class OverlayCreator {
      */
     axisValueLimiter?: (value: [number, number]) => [number, number];
     constructor(canvas: _Canvas_Axis);
-    /** 按类型开始创建：多边形或线 */
-    create(type: "polygon" | "line"): Line | Polygon | undefined;
     /** 禁用除创建层外的其他图层群组交互，并记录原始 isInteractive 以便复原 */
     private disableOtherLayerGroups;
     /** 复原此前禁用的图层群组的 isInteractive */
     private restoreLayerGroupsInteractive;
-    createLine(): Line;
-    createPolygon(): Polygon;
+    createLine(options?: ConstructorParameters<typeof _Canvas_Axis.Line>[0]): Line;
+    createPolygon(options?: ConstructorParameters<typeof _Canvas_Axis.Polygon>[0]): Polygon;
     finish?: (overlay?: Polygon | Line) => void;
     /** 从创建层中移除指定覆盖物，不传则清空该层全部 */
-    removeOverlays(overlay?: Polygon | Line): void;
+    removeOverlay(overlay?: Polygon | Line): void;
     /** 清空创建层并重置当前创建状态 */
     clear(): void;
     /** 销毁实例：清空覆盖物并移除所有事件监听 */

package/dist/Canvas/Axis/OverlayGroup/billboard.d.ts

@@ -0,0 +1,50 @@
+import { default as Overlay } from './public/overlay';
+import { OverlayType } from './index';
+import { EventHandler } from '../public/eventController';
+import { BillboardStyleType } from '../common.type';
+type ObjectFit = "fill" | "contain" | "cover" | "scale-down";
+type ConstructorOption = ConstructorParameters<typeof Overlay<BillboardStyleType, [number, number][]>>[0] & {
+    url?: string;
+    objectFit?: ObjectFit;
+};
+declare abstract class BillboardBase extends Overlay<BillboardStyleType, [
+    number,
+    number
+][]> {
+    private _ready;
+    get ready(): boolean;
+    set ready(value: boolean);
+    protected image: HTMLImageElement;
+    private _url?;
+    get url(): string | undefined;
+    set url(url: string | undefined);
+    private _objectFit;
+    get objectFit(): ObjectFit;
+    set objectFit(value: ObjectFit);
+    /** 当前广告牌绘制矩形（左上角坐标 + 宽高） */
+    protected get drawRect(): {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        sx?: number;
+        sy?: number;
+        sw?: number;
+        sh?: number;
+    };
+    private loadImage;
+    protected updateBaseData(): void;
+}
+export default class Billboard extends BillboardBase {
+    constructor(option: ConstructorOption);
+    defaultDragg: EventHandler<"dragg">;
+    protected updateValueScope(): void;
+    isPointInPath(x: number, y: number): boolean;
+    isPointInStroke(x: number, y: number): boolean;
+    /** 设置样式 */
+    protected setOverlayStyles(ctx: CanvasRenderingContext2D): BillboardStyleType;
+    protected get computedValueScopeStyles(): {};
+    draw(ctx: CanvasRenderingContext2D): void;
+    getDraw(): [(ctx: CanvasRenderingContext2D) => void, OverlayType] | void;
+}
+export {};

package/dist/Canvas/Axis/OverlayGroup/index.d.ts

@@ -7,8 +7,9 @@ import { default as Polygon } from './polygon';
 import { default as Custom } from './custom';
 import { default as Arc } from './arc';
 import { default as ArcTo } from './arcTo';
+import { default as Billboard } from './billboard';
 type ConstructorOption = ConstructorParameters<typeof EventController>[0];
-export type OverlayType = Text | Point | Line | Arc | ArcTo | Polygon | Custom<any>;
+export type OverlayType = Text | Point | Line | Arc | ArcTo | Polygon | Billboard | Custom<any>;
 export default class OverlayGroup extends EventController {
     /** 覆盖物集合 */
     overlays: Set<OverlayType>;
@@ -18,13 +19,13 @@ export default class OverlayGroup extends EventController {
     /** 设置覆盖物重新绘制方法 */
     setNotifyReload(notifyReload?: () => void): void;
     /** 添加覆盖物 */
-    addOverlays(overlays: OverlayType[] | OverlayType): void;
+    addOverlay(overlays: OverlayType[] | OverlayType): void;
     /** 是否包含覆盖物 */
     hasOverlay(overlay: OverlayType): boolean;
     /** 移除覆盖物 */
-    removeOverlays(overlays: OverlayType[] | OverlayType): void;
+    removeOverlay(overlays: OverlayType[] | OverlayType): void;
     /** 清空覆盖物 */
-    clearOverlays(): void;
+    clearOverlay(): void;
     /** 获取覆盖物的绘制方法 */
     getOverlaysDrawingMethod(): [number, [(ctx: CanvasRenderingContext2D) => void, OverlayType]][];
 }

package/dist/Canvas/Axis/common.type.d.ts

@@ -93,6 +93,11 @@ export type PolygonStyleType = {
     /** 点位样式 */
     point: PointStyleType;
 };
+/** 广告牌样式 */
+export type BillboardStyleType = {
+    /** 描边 */
+    stroke: BaseLineStyle;
+};
 /** 主题样式 */
 export type StyleItemType = {
     /** 背景色 */
@@ -111,6 +116,8 @@ export type StyleItemType = {
     arcTo: ArcToStyleType;
     /** 面样式 */
     polygon: PolygonStyleType;
+    /** 广告牌样式 */
+    billboard: BillboardStyleType;
 };
 /** 主题样式 */
 export type StyleType = Record<KnownStyleKeys, StyleItemType> & Record<string, StyleItemType>;

package/dist/Canvas/Axis/core/quikmethod.d.ts

@@ -15,6 +15,8 @@ declare class QuickMethod_Get extends Event {
         overlays_line: OverlayGroup | undefined;
         overlays_polygon: OverlayGroup | undefined;
         overlays_custom: OverlayGroup | undefined;
+        overlays_billboard: OverlayGroup | undefined;
+        overlays_other: OverlayGroup | undefined;
     } | undefined;
     /**
      * 获取所有可见的覆盖层（Overlay）

package/dist/Canvas/Axis/index.d.ts

@@ -12,6 +12,7 @@ import { default as ArcTo } from './OverlayGroup/arcTo';
 import { default as OverlayCreator } from './OverlayCreator';
 import { default as ViewFit } from './public/viewFit';
 import { DeepArray } from './common.type';
+import { default as Billboard } from './OverlayGroup/billboard';
 export type * from './index.types';
 type ConstructorOption = ConstructorParameters<typeof QuickMethod>[0] & {
     /** 轴线显示属性 */
@@ -49,6 +50,8 @@ export declare class _Canvas_Axis extends QuickMethod {
     static Arc: typeof Arc;
     /** 圆角 */
     static ArcTo: typeof ArcTo;
+    /** 图片 */
+    static Billboard: typeof Billboard;
     /** 按坐标轴值创建覆盖物（多边形/线）的交互管理 */
     overlayCreator: OverlayCreator;
     constructor(option: ConstructorOption);

package/dist/Canvas/Axis/index.types.d.ts

@@ -13,4 +13,5 @@ import { default as OverlayCreatorByAxisValue } from './OverlayCreator';
 import { default as ViewFit } from './public/viewFit';
 import { EventHandler } from './public/eventController';
 import { default as Overlay } from './OverlayGroup/public/overlay';
-export type { LayerGroup, OverlayGroup, Layer, OverlayType, Overlay, Point, Text, Line, Polygon, Axis, Custom, Arc, ArcTo, OverlayCreatorByAxisValue, ViewFit, EventHandler, };
+import { default as Billboard } from './OverlayGroup/billboard';
+export type { LayerGroup, OverlayGroup, Layer, OverlayType, Overlay, Point, Text, Line, Polygon, Axis, Custom, Arc, ArcTo, Billboard, OverlayCreatorByAxisValue, ViewFit, EventHandler, };

package/dist/Element/Runtime/fullscreen.d.ts

@@ -0,0 +1,48 @@
+/** 进入全屏模式 */
+export declare function _Element_EnterFullscreen(element?: HTMLElement | string): Promise<void>;
+/** 退出全屏模式 */
+export declare function _Element_ExitFullscreen(): Promise<void>;
+/** 判断是否处于全屏模式 */
+export declare function _Element_IsFullscreen(element?: HTMLElement | string): boolean;
+/**
+ * 返回一个用于切换全屏模式的函数
+ * @param {HTMLElement} content - 需要进入全屏的元素
+ * 该函数通过检查不同浏览器的特定方法来实现全屏切换
+ */
+export declare function _Element_Fullscreen(element?: HTMLElement | string): (() => void) | undefined;
+/**
+ * 元素全屏状态观察器
+ * 监听元素的全屏状态变化，并通过回调函数通知状态改变
+ * @param notify - 全屏状态变化回调函数，接收一个布尔值参数表示当前是否为全屏状态
+ * @param selectors - 要观察的元素或元素选择器，默认为document.documentElement
+ * @returns 返回一个清理函数，调用后可移除所有事件监听器
+ */
+export declare function _Element_FullscreenObserver(notify: (isFull: boolean) => void, selectors?: HTMLElement | string): (() => void) | undefined;
+/**
+ * 全屏控制：绑定目标元素，提供进入 / 退出 / 切换；在 document 上监听各厂商全屏事件并回调当前是否以该元素全屏。
+ * 构造时即注册监听；务必在不再使用时调用 {@link destroy}，避免泄漏。
+ */
+export declare class _Element_FullscreenController {
+    /** 要全屏展示的目标元素 */
+    private targetElement?;
+    /**
+     * 全屏状态变化回调。参数为 `true` 表示当前全屏元素为本实例的目标元素。
+     */
+    onFullscreenChange?: (isFullscreen: boolean) => void;
+    /** 解除 {@link attachFullscreenChangeListeners} 注册的 document 监听 */
+    private detachFullscreenListeners?;
+    constructor(targetOrSelector?: HTMLElement | string, onFullscreenChange?: (isFullscreen: boolean) => void);
+    /**
+     * 设置或更新目标元素（`HTMLElement` 或 CSS 选择器；未传时内部会回退到 `document.documentElement`）
+     */
+    init(targetOrSelector?: HTMLElement | string): void;
+    /** 使目标元素进入浏览器全屏 */
+    enter(): void;
+    /** 退出浏览器全屏（不区分由哪个元素进入） */
+    exit(): void;
+    /** 若当前已为该目标全屏则退出，否则进入全屏 */
+    toggle(): void;
+    private attachFullscreenChangeListeners;
+    /** 移除全屏事件监听，实例不应再使用 */
+    destroy(): void;
+}

package/dist/Element/Runtime/index.d.ts

@@ -0,0 +1,2 @@
+/** Element 模块内依赖 DOM / 运行时的工具集合（全屏等）；新文件在此 `export *` 即可。 */
+export * from './fullscreen';

package/dist/Element/index.d.ts

@@ -1,4 +1,5 @@
 import { DragOption, LocalDragOptions, UiLibrary } from './type';
+export * from './Runtime';
 /**
  * 滚动结束监听器
  * @param {(trigger: "vertical" | "horizontal") => void} callback
@@ -47,26 +48,6 @@ export declare class _Element_LocalDrag {
     mousemove(event: Event): void;
     mouseup(): void;
 }
-/** 进入全屏模式 */
-export declare function _Element_EnterFullscreen(element?: HTMLElement | string): Promise<void>;
-/** 退出全屏模式 */
-export declare function _Element_ExitFullscreen(): Promise<void>;
-/** 判断是否处于全屏模式 */
-export declare function _Element_IsFullscreen(element?: HTMLElement | string): boolean;
-/**
- * 返回一个用于切换全屏模式的函数
- * @param {HTMLElement} content - 需要进入全屏的元素
- * 该函数通过检查不同浏览器的特定方法来实现全屏切换
- */
-export declare function _Element_Fullscreen(element?: HTMLElement | string): (() => void) | undefined;
-/**
- * 元素全屏状态观察器
- * 监听元素的全屏状态变化，并通过回调函数通知状态改变
- * @param notify - 全屏状态变化回调函数，接收一个布尔值参数表示当前是否为全屏状态
- * @param selectors - 要观察的元素或元素选择器，默认为document.documentElement
- * @returns 返回一个清理函数，调用后可移除所有事件监听器
- */
-export declare function _Element_FullscreenObserver(notify: (isFull: boolean) => void, selectors?: HTMLElement | string): (() => void) | undefined;
 /**
  * 单位转换 12** -> **px
  * @param {string} width