zcw-shared 2.24.0 → 2.26.0

package/dist/functions/dom/createTooltipLongPressHandlers.js

@@ -0,0 +1,84 @@
+import { readBrowserDomTimerDeps, } from './readBrowserDomDeps.js';
+export const TOOLTIP_LONG_PRESS_MS = 450;
+const MOVE_CANCEL_PX = 10;
+export function createTooltipLongPressHandlers(options, deps) {
+    const resolved = deps ?? readBrowserDomTimerDeps();
+    const scheduleTimeout = resolved.setTimeout;
+    const cancelScheduledTimeout = resolved.clearTimeout;
+    let timer = null;
+    let touchStartX = 0;
+    let touchStartY = 0;
+    let suppressNextClick = false;
+    let deferredLongPressPending = false;
+    const clearTimer = () => {
+        if (timer) {
+            cancelScheduledTimeout(timer);
+            timer = null;
+        }
+    };
+    const onTouchStart = (e) => {
+        if (!options.enabled())
+            return;
+        const t = e.touches[0];
+        if (t) {
+            touchStartX = t.clientX;
+            touchStartY = t.clientY;
+        }
+        clearTimer();
+        deferredLongPressPending = false;
+        timer = scheduleTimeout(() => {
+            timer = null;
+            suppressNextClick = true;
+            if (options.deferCallbackUntilTouchEnd) {
+                deferredLongPressPending = true;
+            }
+            else {
+                options.onLongPress();
+            }
+        }, TOOLTIP_LONG_PRESS_MS);
+    };
+    const onTouchMove = (e) => {
+        const t = e.touches[0];
+        if (!t)
+            return;
+        const movedTooFar = Math.abs(t.clientX - touchStartX) > MOVE_CANCEL_PX ||
+            Math.abs(t.clientY - touchStartY) > MOVE_CANCEL_PX;
+        if (!movedTooFar)
+            return;
+        if (timer)
+            clearTimer();
+        if (deferredLongPressPending) {
+            deferredLongPressPending = false;
+            suppressNextClick = false;
+        }
+    };
+    const flushDeferredLongPress = () => {
+        if (!deferredLongPressPending)
+            return;
+        deferredLongPressPending = false;
+        options.onLongPress();
+    };
+    const onTouchEnd = () => {
+        clearTimer();
+        flushDeferredLongPress();
+    };
+    const onTouchEndCancel = () => {
+        clearTimer();
+        deferredLongPressPending = false;
+    };
+    const consumeSuppressClick = () => {
+        if (!suppressNextClick)
+            return false;
+        suppressNextClick = false;
+        return true;
+    };
+    return {
+        onTouchStart,
+        onTouchMove,
+        onTouchEnd,
+        onTouchCancel: onTouchEndCancel,
+        consumeSuppressClick,
+        clearTimer,
+    };
+}
+//# sourceMappingURL=createTooltipLongPressHandlers.js.map

package/dist/functions/dom/createTooltipLongPressHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTooltipLongPressHandlers.js","sourceRoot":"","sources":["../../../src/functions/dom/createTooltipLongPressHandlers.ts"],"names":[],"mappings":"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"}

package/dist/functions/dom/domDocumentSelection.d.ts

@@ -0,0 +1,4 @@
+import type { HTMLElement } from '../../../references/dom.d';
+import { type DomSelectionDeps } from './readBrowserDomDeps';
+export declare function clearDocumentSelection(deps?: DomSelectionDeps): void;
+export declare function selectElementTextContent(root: HTMLElement, deps?: DomSelectionDeps): boolean;

package/dist/functions/dom/domDocumentSelection.js

@@ -0,0 +1,39 @@
+import { readBrowserDomSelectionDeps, } from './readBrowserDomDeps.js';
+function getWindowSelection(deps) {
+    return deps.getSelection?.() ?? null;
+}
+export function clearDocumentSelection(deps) {
+    getWindowSelection(deps ?? readBrowserDomSelectionDeps())?.removeAllRanges();
+}
+export function selectElementTextContent(root, deps) {
+    const resolved = deps ?? readBrowserDomSelectionDeps();
+    const sel = getWindowSelection(resolved);
+    if (!sel)
+        return false;
+    sel.removeAllRanges();
+    const doc = resolved.document;
+    if (!doc?.createRange || !doc.createTreeWalker)
+        return false;
+    const range = doc.createRange();
+    const walker = doc.createTreeWalker(root, 4);
+    let first = null;
+    let last = null;
+    while (walker.nextNode()) {
+        const node = walker.currentNode;
+        if (!node.textContent?.trim())
+            continue;
+        if (!first)
+            first = node;
+        last = node;
+    }
+    if (first && last) {
+        range.setStart(first, 0);
+        range.setEnd(last, last.textContent?.length ?? 0);
+    }
+    else {
+        range.selectNodeContents(root);
+    }
+    sel.addRange(range);
+    return true;
+}
+//# sourceMappingURL=domDocumentSelection.js.map

package/dist/functions/dom/domDocumentSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domDocumentSelection.js","sourceRoot":"","sources":["../../../src/functions/dom/domDocumentSelection.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,GAG5B,MAAM,sBAAsB,CAAA;AAQ7B,SAAS,kBAAkB,CAAC,IAAsB;IAChD,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,IAAI,CAAA;AACtC,CAAC;AAGD,MAAM,UAAU,sBAAsB,CAAC,IAAuB;IAC5D,kBAAkB,CAAC,IAAI,IAAI,2BAA2B,EAAE,CAAC,EAAE,eAAe,EAAE,CAAA;AAC9E,CAAC;AAGD,MAAM,UAAU,wBAAwB,CACtC,IAAiB,EACjB,IAAuB;IAEvB,MAAM,QAAQ,GAAG,IAAI,IAAI,2BAA2B,EAAE,CAAA;IACtD,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAA;IACtB,GAAG,CAAC,eAAe,EAAE,CAAA;IAErB,MAAM,GAAG,GAAG,QAAQ,CAAC,QAIR,CAAA;IACb,IAAI,CAAC,GAAG,EAAE,WAAW,IAAI,CAAC,GAAG,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAA;IAE5D,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAqB,CAAA;IAClD,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAC5C,IAAI,KAAK,GAAoB,IAAI,CAAA;IACjC,IAAI,IAAI,GAAoB,IAAI,CAAA;IAChC,OAAO,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAuB,CAAA;QAC3C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE;YAAE,SAAQ;QACvC,IAAI,CAAC,KAAK;YAAE,KAAK,GAAG,IAAI,CAAA;QACxB,IAAI,GAAG,IAAI,CAAA;IACb,CAAC;IACD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QACxB,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,CAAA;IACnD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IACD,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACnB,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/functions/dom/domSelectionInElement.d.ts

@@ -0,0 +1,5 @@
+import type { HTMLElement, Range } from '../../../references/dom.d';
+import { type DomSelectionDeps } from './readBrowserDomDeps';
+export declare function cloneDomSelectionRangesInElement(el: HTMLElement, deps?: DomSelectionDeps): Range[];
+export declare function snapshotDomBubbleCopyRanges(el: HTMLElement, deps?: DomSelectionDeps): Range[];
+export declare function readDomSelectionTextInElement(el: HTMLElement, deps?: DomSelectionDeps): string;

package/dist/functions/dom/domSelectionInElement.js

@@ -0,0 +1,39 @@
+import { readBrowserDomSelectionDeps, } from './readBrowserDomDeps.js';
+function getWindowSelection(deps) {
+    return deps.getSelection?.() ?? null;
+}
+export function cloneDomSelectionRangesInElement(el, deps) {
+    const sel = getWindowSelection(deps ?? readBrowserDomSelectionDeps());
+    if (!sel || sel.rangeCount === 0 || sel.isCollapsed)
+        return [];
+    const out = [];
+    for (let i = 0; i < sel.rangeCount; i++) {
+        const r = sel.getRangeAt(i);
+        if (!el.contains(r.startContainer) || !el.contains(r.endContainer))
+            return [];
+        out.push(r.cloneRange());
+    }
+    return out;
+}
+export function snapshotDomBubbleCopyRanges(el, deps) {
+    const fromSelection = cloneDomSelectionRangesInElement(el, deps);
+    if (fromSelection.length > 0)
+        return fromSelection;
+    const doc = (deps ?? readBrowserDomSelectionDeps()).document;
+    if (!doc?.createRange)
+        return [];
+    try {
+        const range = doc.createRange();
+        range.selectNodeContents(el);
+        return [range];
+    }
+    catch {
+        return [];
+    }
+}
+export function readDomSelectionTextInElement(el, deps) {
+    const ranges = cloneDomSelectionRangesInElement(el, deps);
+    const raw = ranges.map((r) => r.toString()).join('');
+    return raw.trim() ? raw : '';
+}
+//# sourceMappingURL=domSelectionInElement.js.map

package/dist/functions/dom/domSelectionInElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domSelectionInElement.js","sourceRoot":"","sources":["../../../src/functions/dom/domSelectionInElement.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,GAG5B,MAAM,sBAAsB,CAAA;AAE7B,SAAS,kBAAkB,CAAC,IAAsB;IAChD,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,IAAI,CAAA;AACtC,CAAC;AAMD,MAAM,UAAU,gCAAgC,CAC9C,EAAe,EACf,IAAuB;IAEvB,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,IAAI,2BAA2B,EAAE,CAAC,CAAA;IACrE,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,GAAG,CAAC,WAAW;QAAE,OAAO,EAAE,CAAA;IAC9D,MAAM,GAAG,GAAY,EAAE,CAAA;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC3B,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;YAAE,OAAO,EAAE,CAAA;QAC7E,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAA;IAC1B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAGD,MAAM,UAAU,2BAA2B,CACzC,EAAe,EACf,IAAuB;IAEvB,MAAM,aAAa,GAAG,gCAAgC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IAChE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,aAAa,CAAA;IAClD,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,2BAA2B,EAAE,CAAC,CAAC,QAAQ,CAAA;IAC5D,IAAI,CAAC,GAAG,EAAE,WAAW;QAAE,OAAO,EAAE,CAAA;IAChC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAA;QAC/B,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAA;QAC5B,OAAO,CAAC,KAAK,CAAC,CAAA;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,6BAA6B,CAC3C,EAAe,EACf,IAAuB;IAEvB,MAAM,MAAM,GAAG,gCAAgC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IACzD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACpD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;AAC9B,CAAC"}

package/dist/functions/dom/executeCopyTextToClipboard.d.ts

@@ -0,0 +1,18 @@
+export type ExecuteCopyTextToClipboardOptions = {
+    resolveAbsoluteUrl?: boolean;
+    baseUrl?: string;
+    origin?: string;
+};
+export type ExecuteCopyTextToClipboardResult = {
+    ok: boolean;
+    empty: boolean;
+    payload: string;
+};
+export declare function executeCopyTextToClipboard(text: string, options?: ExecuteCopyTextToClipboardOptions): Promise<ExecuteCopyTextToClipboardResult>;
+export type CopyTextFeedbackMessages = {
+    emptyMessage: string;
+    successMessage: string;
+    failMessage: string;
+};
+export declare const DEFAULT_COPY_TEXT_FEEDBACK_MESSAGES: CopyTextFeedbackMessages;
+export declare function resolveCopyTextFeedbackMessages(overrides?: Partial<CopyTextFeedbackMessages>): CopyTextFeedbackMessages;

package/dist/functions/dom/executeCopyTextToClipboard.js

@@ -0,0 +1,28 @@
+import { copyTextToClipboard } from './copyTextToClipboard.js';
+import { resolveCopyableAbsoluteUrl } from '../url/resolveCopyableAbsoluteUrl.js';
+export async function executeCopyTextToClipboard(text, options) {
+    const raw = text.trim();
+    const payload = options?.resolveAbsoluteUrl
+        ? (resolveCopyableAbsoluteUrl(raw, {
+            baseUrl: options.baseUrl,
+            origin: options.origin,
+        }) ?? '')
+        : raw;
+    if (!payload) {
+        return { ok: false, empty: true, payload: '' };
+    }
+    const ok = await copyTextToClipboard(payload);
+    return { ok, empty: false, payload };
+}
+export const DEFAULT_COPY_TEXT_FEEDBACK_MESSAGES = {
+    emptyMessage: '暂无可复制内容',
+    successMessage: '已复制',
+    failMessage: '复制失败',
+};
+export function resolveCopyTextFeedbackMessages(overrides) {
+    return {
+        ...DEFAULT_COPY_TEXT_FEEDBACK_MESSAGES,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=executeCopyTextToClipboard.js.map

package/dist/functions/dom/executeCopyTextToClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeCopyTextToClipboard.js","sourceRoot":"","sources":["../../../src/functions/dom/executeCopyTextToClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AAgB9E,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAY,EACZ,OAA2C;IAE3C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,OAAO,EAAE,kBAAkB;QACzC,CAAC,CAAC,CAAC,0BAA0B,CAAC,GAAG,EAAE;YAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,IAAI,EAAE,CAAC;QACX,CAAC,CAAC,GAAG,CAAA;IACP,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;IAChD,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAC7C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AACtC,CAAC;AAQD,MAAM,CAAC,MAAM,mCAAmC,GAA6B;IAC3E,YAAY,EAAE,SAAS;IACvB,cAAc,EAAE,KAAK;IACrB,WAAW,EAAE,MAAM;CACpB,CAAA;AAED,MAAM,UAAU,+BAA+B,CAC7C,SAA6C;IAE7C,OAAO;QACL,GAAG,mCAAmC;QACtC,GAAG,SAAS;KACb,CAAA;AACH,CAAC"}

package/dist/functions/dom/fetchBlobFromUrl.d.ts

@@ -0,0 +1,12 @@
+import type { FetchFunction } from '../../../references/fetch.d';
+import type { Blob } from '../../../references/blob.d';
+import type { URL as URLConstructor } from '../../../references/url.d';
+export interface FetchBlobFromUrlDeps {
+    fetch: FetchFunction;
+    URLConstructor?: typeof URLConstructor;
+}
+export declare function fetchBlobFromUrl(url: string, options?: {
+    pageHref?: string;
+    fetchFn?: FetchFunction;
+    URLConstructor?: typeof URLConstructor;
+}, deps?: FetchBlobFromUrlDeps): Promise<Blob | null>;

package/dist/functions/dom/fetchBlobFromUrl.js

@@ -0,0 +1,29 @@
+import { readBrowserDomFetchBlobDeps, } from './readBrowserDomDeps.js';
+export async function fetchBlobFromUrl(url, options, deps) {
+    const resolved = deps ?? readBrowserDomFetchBlobDeps();
+    const fetchFn = options?.fetchFn ?? resolved?.fetch;
+    if (!fetchFn)
+        return null;
+    try {
+        let credentials;
+        const pageHref = options?.pageHref;
+        const URLCtor = options?.URLConstructor ?? resolved?.URLConstructor;
+        if (pageHref && URLCtor) {
+            try {
+                if (new URLCtor(url, pageHref).origin === new URLCtor(pageHref).origin) {
+                    credentials = 'include';
+                }
+            }
+            catch {
+            }
+        }
+        const res = await fetchFn(url, credentials ? { credentials: 'include' } : undefined);
+        if (!res.ok)
+            return null;
+        return await res.blob();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=fetchBlobFromUrl.js.map

package/dist/functions/dom/fetchBlobFromUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchBlobFromUrl.js","sourceRoot":"","sources":["../../../src/functions/dom/fetchBlobFromUrl.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,2BAA2B,GAE5B,MAAM,sBAAsB,CAAA;AAO7B,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,OAIC,EACD,IAA2B;IAE3B,MAAM,QAAQ,GAAG,IAAI,IAAI,2BAA2B,EAAE,CAAA;IACtD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,KAAK,CAAA;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACzB,IAAI,CAAC;QACH,IAAI,WAAkC,CAAA;QACtC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAA;QAClC,MAAM,OAAO,GAAG,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,cAAc,CAAA;QACnE,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;oBACvE,WAAW,GAAG,SAAS,CAAA;gBACzB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;YAET,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,OAAO,CACvB,GAAG,EACH,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CACrD,CAAA;QACD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QACxB,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/functions/dom/fileDrag.d.ts

@@ -0,0 +1,11 @@
+type ExternalFileDragTransfer = {
+    types: readonly string[];
+    items?: {
+        length: number;
+        [index: number]: {
+            kind: string;
+        };
+    };
+};
+export declare function hasExternalFileDrag(dt: ExternalFileDragTransfer | null | undefined): boolean;
+export {};

package/dist/functions/dom/fileDrag.js

@@ -0,0 +1,14 @@
+export function hasExternalFileDrag(dt) {
+    if (!dt)
+        return false;
+    if (Array.from(dt.types).includes('Files'))
+        return true;
+    if (dt.items?.length) {
+        for (const item of Array.from(dt.items)) {
+            if (item.kind === 'file')
+                return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=fileDrag.js.map

package/dist/functions/dom/fileDrag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileDrag.js","sourceRoot":"","sources":["../../../src/functions/dom/fileDrag.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,mBAAmB,CAAC,EAA+C;IACjF,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAA;IACrB,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IACvD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAA;QACvC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/functions/dom/imageBlobToPng.d.ts

@@ -0,0 +1,7 @@
+import type { Blob } from '../../../references/blob.d';
+import type { HTMLImageElement } from '../../../references/dom.d';
+import { type DomImageCanvasDeps } from './readBrowserDomDeps';
+export declare function imageElementToPngBlob(img: HTMLImageElement, deps?: DomImageCanvasDeps): Promise<Blob>;
+export declare function imageUrlToPngBlob(url: string, crossOrigin?: boolean, deps?: DomImageCanvasDeps): Promise<Blob>;
+export declare function blobToPngBlob(blob: Blob, deps?: DomImageCanvasDeps): Promise<Blob>;
+export declare function normalizeImageBlobForClipboard(blob: Blob, deps?: DomImageCanvasDeps): Promise<Blob>;

package/dist/functions/dom/imageBlobToPng.js

@@ -0,0 +1,75 @@
+import { readBrowserDomImageCanvasDeps, } from './readBrowserDomDeps.js';
+function canvasToPngBlob(canvas) {
+    return new Promise((resolve, reject) => {
+        canvas.toBlob((blob) => (blob ? resolve(blob) : reject(new Error('toBlob failed'))), 'image/png');
+    });
+}
+function drawImageToCanvas(img, deps) {
+    if (!img.complete || img.naturalWidth <= 0) {
+        throw new Error('image not ready');
+    }
+    const canvas = deps.document.createElement('canvas');
+    canvas.width = img.naturalWidth;
+    canvas.height = img.naturalHeight;
+    const ctx = canvas.getContext('2d');
+    if (!ctx)
+        throw new Error('canvas 2d unavailable');
+    try {
+        ctx.drawImage(img, 0, 0, img.naturalWidth, img.naturalHeight);
+    }
+    catch {
+        throw new Error('drawImage failed');
+    }
+    return canvas;
+}
+export function imageElementToPngBlob(img, deps) {
+    const resolved = deps ?? readBrowserDomImageCanvasDeps();
+    if (!resolved)
+        return Promise.reject(new Error('browser image deps unavailable'));
+    return canvasToPngBlob(drawImageToCanvas(img, resolved));
+}
+export function imageUrlToPngBlob(url, crossOrigin = true, deps) {
+    const resolved = deps ?? readBrowserDomImageCanvasDeps();
+    if (!resolved)
+        return Promise.reject(new Error('browser image deps unavailable'));
+    return new Promise((resolve, reject) => {
+        const img = new resolved.Image();
+        if (crossOrigin)
+            img.crossOrigin = 'anonymous';
+        img.onload = () => {
+            try {
+                void canvasToPngBlob(drawImageToCanvas(img, resolved)).then(resolve, reject);
+            }
+            catch (e) {
+                reject(e);
+            }
+        };
+        img.onerror = () => reject(new Error('image load failed'));
+        img.src = url;
+    });
+}
+export async function blobToPngBlob(blob, deps) {
+    if (blob.type === 'image/png')
+        return blob;
+    const resolved = deps ?? readBrowserDomImageCanvasDeps();
+    if (!resolved)
+        throw new Error('browser image deps unavailable');
+    const objectUrl = resolved.URL.createObjectURL(blob);
+    try {
+        return await imageUrlToPngBlob(objectUrl, false, resolved);
+    }
+    finally {
+        resolved.URL.revokeObjectURL(objectUrl);
+    }
+}
+export async function normalizeImageBlobForClipboard(blob, deps) {
+    if (blob.type === 'image/png')
+        return blob;
+    try {
+        return await blobToPngBlob(blob, deps);
+    }
+    catch {
+        return blob;
+    }
+}
+//# sourceMappingURL=imageBlobToPng.js.map

package/dist/functions/dom/imageBlobToPng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageBlobToPng.js","sourceRoot":"","sources":["../../../src/functions/dom/imageBlobToPng.ts"],"names":[],"mappings":"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"}

package/dist/functions/dom/lassoSelection.d.ts

@@ -0,0 +1,84 @@
+export type LassoBoxRect = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+type ClientRectLike = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    right: number;
+    bottom: number;
+};
+type LassoScrollViewport = {
+    scrollLeft: number;
+    scrollTop: number;
+    scrollWidth: number;
+    scrollHeight: number;
+    clientHeight: number;
+    getBoundingClientRect(): {
+        top: number;
+        left: number;
+        height: number;
+    };
+};
+type LassoRowElement = {
+    getAttribute(name: string): string | null;
+    getBoundingClientRect(): ClientRectLike;
+};
+type LassoContentRoot = {
+    querySelectorAll(selectors: string): Iterable<LassoRowElement>;
+};
+export declare const DEFAULT_DRAG_ENTER_MIN_PX = 32;
+export declare const LASSO_STROKE_PAD_PX = 4;
+export declare const EDGE_SCROLL_ZONE_PX = 56;
+export declare const EDGE_SCROLL_MAX_PX_PER_FRAME = 18;
+export declare const LASSO_INTERACTIVE_SELECTOR = "a[href],button,input,textarea,select,[contenteditable=\"true\"],[role=\"checkbox\"]";
+export declare const defaultLassoBoxClass = "pointer-events-none absolute z-[var(--z-index-float)] box-border border border-[var(--brand-color-6)] bg-[color-mix(in_srgb,var(--brand-color-6)_20%,transparent)]";
+type AxisRect = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    right: number;
+    bottom: number;
+};
+export declare function rectsOverlap(a: LassoBoxRect | ClientRectLike | AxisRect, b: LassoBoxRect | ClientRectLike | AxisRect): boolean;
+export declare function isPrimaryPointer(e: {
+    button: number;
+    isPrimary: boolean;
+}): boolean;
+export declare function meetsDragEnterThreshold(dx: number, dy: number, minPx: number): boolean;
+export declare function strokeBounds(x1: number, y1: number, x2: number, y2: number, strokePadPx?: number): ClientRectLike;
+export declare function clientPointToContent(clientX: number, clientY: number, viewport: LassoScrollViewport): {
+    x: number;
+    y: number;
+};
+export declare function startContentPoint(startClientX: number, startClientY: number, startScrollLeft: number, startScrollTop: number, viewport: LassoScrollViewport): {
+    x: number;
+    y: number;
+};
+export declare function clipContentRectToScrollable(rect: ClientRectLike, viewport: LassoScrollViewport): ClientRectLike;
+export declare function lassoBoxInScrollContent(contentRect: ClientRectLike, viewport: LassoScrollViewport): LassoBoxRect | null;
+export declare function collectRowElByItemId(root: LassoContentRoot, rowIdAttribute: string): Map<string, LassoRowElement>;
+export declare function nearestItemByPoint<T extends {
+    id: string;
+}>(items: readonly T[], rowElByItemId: Map<string, LassoRowElement>, clientX: number, clientY: number): T | null;
+export declare function pointerHitsInteractive(target: unknown, selector?: string): boolean;
+export declare function resolveLassoSeed<T extends {
+    id: string;
+}>(items: readonly T[], rowElByItemId: Map<string, LassoRowElement>, rowIdAttribute: string, target: unknown, clientX: number, clientY: number): {
+    item: T;
+    rowEl: LassoRowElement;
+} | null;
+export declare function computeViewportEdgeScrollDelta(clientY: number, viewport: LassoScrollViewport, edgeScrollZonePx?: number, edgeScrollMaxPxPerFrame?: number): number;
+export declare function collectElementIdsInContentLassoBox(box: LassoBoxRect, viewport: LassoScrollViewport, contentRoot: LassoContentRoot, idAttribute: string): string[];
+export declare function mapItemsByRowIds<T extends {
+    id: string | number;
+}>(items: readonly T[], rowIds: readonly string[]): T[];
+export declare function idsInClientLasso<T extends {
+    id: string;
+}>(items: readonly T[], rowElByItemId: Map<string, LassoRowElement>, startClientX: number, startClientY: number, endClientX: number, endClientY: number, itemSelectable?: (item: T) => boolean): string[];
+export {};