@unicom-cloud/utils 0.1.23 → 0.1.24

package/snapdom/types/snapdom.d.ts

@@ -1,101 +1,293 @@
-declare module '@zumer/snapdom' {
-  export interface SnapOptions {
-    compress?: boolean;
-    embedFonts?: boolean;
-    localFonts?: Array<{
-      family: string;
-      src: string;
-      weight?: string;
-      style?: string;
-    }>;
-    iconFonts?: string | RegExp | Array<string | RegExp>;
-    fast?: boolean;
-    scale?: number;
-    width?: number;
-    height?: number;
-    backgroundColor?: string;
-    format?: 'png' | 'jpeg' | 'jpg' | 'webp' | 'svg';
-    type?: 'png' | 'jpeg' | 'jpg' | 'webp' | 'svg';
-    filename?: string;
-    dpr?: number;
-    quality?: number;
-    useProxy?: string;
-    exclude?: string[];
-    filter?: (element: Element, originalElement: Element) => boolean;
-  }
-
-  export interface SnapResult {
-    url: string;
-    options: SnapOptions;
-    toRaw(): string;
-    toImg(): Promise<HTMLImageElement>;
-    toCanvas(): Promise<HTMLCanvasElement>;
-    toBlob(options?: SnapOptions): Promise<Blob>;
-    toPng(options?: SnapOptions): Promise<HTMLImageElement>;
-    toJpg(options?: SnapOptions): Promise<HTMLImageElement>;
-    toWebp(options?: SnapOptions): Promise<HTMLImageElement>;
-    download(options?: SnapOptions): Promise<void>;
-  }
-
-  /**
-   * Captura un elemento del DOM como imagen SVG + métodos de exportación.
-   */
-  export function snapdom(
-    element: HTMLElement,
-    options?: SnapOptions,
-  ): Promise<SnapResult>;
-
-  export namespace snapdom {
-    function capture(
-      element: HTMLElement,
-      options?: SnapOptions,
-    ): Promise<SnapResult>;
-    function toRaw(
-      element: HTMLElement,
-      options?: SnapOptions,
-    ): Promise<string>;
-    function toImg(
-      element: HTMLElement,
-      options?: SnapOptions,
-    ): Promise<HTMLImageElement>;
-    function toCanvas(
-      element: HTMLElement,
-      options?: SnapOptions,
-    ): Promise<HTMLCanvasElement>;
-    function toBlob(element: HTMLElement, options?: SnapOptions): Promise<Blob>;
-    function toPng(
-      element: HTMLElement,
-      options?: SnapOptions,
-    ): Promise<HTMLImageElement>;
-    function toJpg(
-      element: HTMLElement,
-      options?: SnapOptions,
-    ): Promise<HTMLImageElement>;
-    function toWebp(
-      element: HTMLElement,
-      options?: SnapOptions,
-    ): Promise<HTMLImageElement>;
-    function download(
-      element: HTMLElement,
-      options?: SnapOptions,
-    ): Promise<void>;
-  }
-
-  /**
-   * Precarga imágenes, fondos y fuentes para acelerar capturas posteriores.
-   */
-  export function preCache(
-    root?: Document | HTMLElement,
-    options?: {
-      embedFonts?: boolean;
-      useProxy?: string;
-      reset?: boolean;
-      localFonts?: Array<{
-        family: string;
-        src: string;
-        weight?: string;
-        style?: string;
-      }>;
-    },
+/**
+ * snapDOM – ultra-fast DOM-to-image capture
+ * TypeScript definitions (v1.9.10-dev.2)
+ *
+ * Notes:
+ * - Style compression is internal (no public option).
+ * - Icon fonts are always embedded; `embedFonts` controls non-icon fonts only.
+ */
+
+export type RasterMime = 'png' | 'jpg' | 'jpeg' | 'webp';
+export type BlobType = 'svg' | RasterMime;
+
+export type IconFontMatcher = string | RegExp;
+export type CachePolicy = 'disabled' | 'full' | 'auto' | 'soft';
+
+export type ExcludeMode = 'hide' | 'remove';
+export type FilterMode = 'hide' | 'remove';
+
+export interface LocalFontDescriptor {
+  /** CSS font-family name (e.g. "Inter"). */
+  family: string;
+  /** URL to the font source (woff2/woff/ttf). Data URLs allowed. */
+  src: string;
+  /** CSS font-weight value (e.g. 400, "bold"). */
+  weight?: string | number;
+  /** CSS font-style value (e.g. "normal", "italic"). */
+  style?: string;
+  /** CSS font-stretch as percentage (e.g. 100 for normal). */
+  stretchPct?: number;
+}
+
+export interface CaptureOptions {
+  /**
+   * Enable additional internal logs.
+   * Default: false
+   */
+  debug?: boolean;
+
+  /**
+   * Skip small idle delays for faster overall capture.
+   * Default: true
+   */
+  fast?: boolean;
+
+  /**
+   * Output scale multiplier. If set, takes precedence over width/height.
+   * Default: 1
+   */
+  scale?: number;
+
+  /**
+   * Device pixel ratio to use for raster exports.
+   * Default: `window.devicePixelRatio` at capture time.
+   */
+  dpr?: number;
+
+  /** Target width for the exported image. Ignored if `scale` is provided. */
+  width?: number;
+
+  /** Target height for the exported image. Ignored if `scale` is provided. */
+  height?: number;
+
+  /**
+   * Fallback color for lossy raster formats (JPG/WebP have no alpha).
+   * Default: "#ffffff" for JPG/JPEG/WebP, `null` otherwise.
+   */
+  backgroundColor?: string | null;
+
+  /**
+   * Quality for JPG/WebP (0..1).
+   * Default: 0.92
+   */
+  quality?: number;
+
+  /**
+   * Proxy base URL used as a fallback for CORS-restricted images/fonts.
+   * Example: "https://corsproxy.io/?url="
+   */
+  useProxy?: string;
+
+  /** Preferred Blob type for `toBlob`. Default: "svg". */
+  type?: BlobType;
+
+  /**
+   * Preferred export format used by convenience methods / download.
+   * Default: "png"
+   */
+  format?: BlobType;
+
+  /** CSS selectors removed from the cloned subtree before processing. */
+  exclude?: string[];
+
+  /**
+   * Mode applied to excluded nodes of the cloned tree.
+   * Default: "hide"
+   */
+  excludeMode?: ExcludeMode;
+
+  /**
+   * Advanced node filter; return false to exclude a node during traversal.
+   * Applied to the cloned subtree.
+   */
+  filter?: (el: Element) => boolean;
+
+  /**
+   * Mode applied to filtered nodes of the cloned tree.
+   * Default: "hide"
+   */
+  filterMode?: FilterMode;
+
+  /**
+   * Whether to synthesize placeholders for broken images, etc.
+   * Default: true
+   */
+  placeholders?: boolean;
+
+  /**
+   * Inline non-icon fonts used within the captured subtree.
+   * Icon fonts are always embedded.
+   * Default: false
+   */
+  embedFonts?: boolean;
+
+  /**
+   * Additional local fonts to be considered during embedding.
+   */
+  localFonts?: LocalFontDescriptor[];
+
+  /**
+   * Extra icon font family matchers (by name or regex).
+   */
+  iconFonts?: IconFontMatcher | IconFontMatcher[];
+
+  /**
+   * Font family matchers to explicitly exclude from embedding.
+   */
+  excludeFonts?: IconFontMatcher[];
+
+  /**
+   * Fallback image source when an <img> fails to load.
+   * - String: use as-is.
+   * - Callback: receives measured width/height and original src, returns a URL string.
+   */
+  fallbackURL?:
+    | string
+    | ((args: {
+        width?: number;
+        height?: number;
+        src?: string;
+        element: HTMLImageElement;
+      }) => string | Promise<string>);
+
+  /**
+   * Cache policy applied at capture start.
+   * Default: "soft"
+   */
+  cache?: CachePolicy;
+
+  /**
+   * Base filename used by `download`.
+   * Default: "snapDOM"
+   */
+  filename?: string;
+
+  /**
+   * Normalize only translate*rotate* on the cloned root (keeps scale/skew intact).
+   * Children are not modified.
+   * Default: false
+   */
+  straighten?: boolean;
+
+  /**
+   * Do not expand the root viewBox for shadows/blur/outline/drop-shadow.
+   * Children are not modified. The root may also have those visuals cleared to avoid clipping.
+   * Default: false
+   */
+  noShadows?: boolean;
+}
+
+export interface BlobOptions {
+  /** Blob type to export. Default: "svg". */
+  type?: BlobType;
+  /** JPG/WebP quality (0..1). */
+  quality?: number;
+  /** Background override for lossy formats. */
+  backgroundColor?: string | null;
+}
+
+export interface DownloadOptions {
+  /** File format. Default: "png". */
+  format?: 'svg' | RasterMime;
+  /** Base filename without extension. Default: "snapDOM". */
+  filename?: string;
+  /** Background override for lossy formats. */
+  backgroundColor?: string | null;
+  /** JPG/WebP quality (0..1). Default: 0.92. */
+  quality?: number;
+}
+
+export interface CaptureResult {
+  /** SVG data URL representing the captured element. */
+  url: string;
+  /** Returns the same SVG data URL string. */
+  toRaw(): string;
+  /** Creates an HTMLImageElement from the SVG (accepts options). */
+  toImg(options?: CaptureOptions): Promise<HTMLImageElement>;
+  /** Creates an HTMLImageElement from the SVG (accepts options). */
+  toSvg(options?: CaptureOptions): Promise<HTMLImageElement>;
+  /** Renders into a Canvas element (accepts options). */
+  toCanvas(options?: CaptureOptions): Promise<HTMLCanvasElement>;
+  /** Exports to a Blob (SVG/PNG/JPG/WebP). */
+  toBlob(options?: CaptureOptions & BlobOptions): Promise<Blob>;
+  /** Convenience PNG export (returns an <img>). */
+  toPng(options?: CaptureOptions): Promise<HTMLImageElement>;
+  /** Convenience JPG export (returns an <img>). */
+  toJpg(options?: CaptureOptions): Promise<HTMLImageElement>;
+  /** Convenience WebP export (returns an <img>). */
+  toWebp(options?: CaptureOptions): Promise<HTMLImageElement>;
+  /** Triggers a file download. */
+  download(options?: CaptureOptions & DownloadOptions): Promise<void>;
+}
+
+/**
+ * Capture an element and return reusable export helpers.
+ */
+export declare function snapdom(
+  el: Element,
+  options?: CaptureOptions,
+): Promise<CaptureResult>;
+
+export declare namespace snapdom {
+  function toImg(
+    el: Element,
+    options?: CaptureOptions,
+  ): Promise<HTMLImageElement>;
+  function toSvg(
+    el: Element,
+    options?: CaptureOptions,
+  ): Promise<HTMLImageElement>;
+  function toCanvas(
+    el: Element,
+    options?: CaptureOptions,
+  ): Promise<HTMLCanvasElement>;
+  function toBlob(
+    el: Element,
+    options?: CaptureOptions & BlobOptions,
+  ): Promise<Blob>;
+  function toPng(
+    el: Element,
+    options?: CaptureOptions,
+  ): Promise<HTMLImageElement>;
+  function toJpg(
+    el: Element,
+    options?: CaptureOptions,
+  ): Promise<HTMLImageElement>;
+  function toWebp(
+    el: Element,
+    options?: CaptureOptions,
+  ): Promise<HTMLImageElement>;
+  function download(
+    el: Element,
+    options?: CaptureOptions & DownloadOptions,
   ): Promise<void>;
 }
+
+/**
+ * Preload resources (images/fonts) to avoid first-capture stalls.
+ */
+export interface PreCacheOptions {
+  /** Inline non-icon fonts during preload. Default: true. */
+  embedFonts?: boolean;
+  /** Additional local fonts. */
+  localFonts?: LocalFontDescriptor[];
+  /** Proxy for CORS fallbacks. */
+  useProxy?: string;
+  /** Font family matchers to explicitly exclude from embedding. */
+  excludeFonts?: IconFontMatcher[];
+  /**
+   * Cache policy used during precache.
+   * Note: for `preCache` the option name in runtime is `cacheOpt`.
+   */
+  cacheOpt?: CachePolicy;
+}
+
+/**
+ * Preload resources rooted at `root` (defaults to `document`).
+ */
+export declare function preCache(
+  root?: Element | Document,
+  options?: PreCacheOptions,
+): Promise<void>;
+
+export {};

package/snapdom.js

@@ -1,3 +1,4 @@
+/* 2025-10-28 09:57:10 */
 import { preCache as e } from "./snapdom/src/api/preCache.js";
 import { snapdom as m } from "./snapdom/src/api/snapdom.js";
 export {

package/tinycolor/index.js

@@ -1,3 +1,4 @@
+/* 2025-10-28 09:57:10 */
 import { cmykToRgb as e, convertDecimalToHex as t, convertHexToDecimal as a, hslToRgb as n, hsvToRgb as b, numberInputToObject as m, parseIntFromHex as T, rgbToCmyk as i, rgbToHex as g, rgbToHsl as p, rgbToHsv as l, rgbToRgb as s, rgbaToArgbHex as x, rgbaToHex as c } from "./src/conversion.js";
 import { names as f } from "./src/css-color-names.js";
 import { inputToRGB as u, isValidCSSUnit as H, stringInputToObject as y } from "./src/format-input.js";
@@ -6,7 +7,7 @@ import { TinyColor as O, TinyColor as P } from "./src/index.js";
 import { bounds as k, random as A } from "./src/random.js";
 import { isReadable as F, mostReadable as S, readability as B } from "./src/readability.js";
 import { toMsFilter as M } from "./src/to-ms-filter.js";
-import { bound01 as V, boundAlpha as Z, clamp01 as q, convertToPercentage as w, isOnePointZero as z, isPercentage as E, pad2 as J } from "./src/util.js";
+import { bound01 as V, boundAlpha as Z, clamp01 as q, convertToPercentage as w, isOnePointZero as z, isPercentage as E, pad2 as J } from "./src/utils.js";
 export {
   O as TinyColor,
   V as bound01,

package/tinycolor/src/conversion.js

@@ -1,4 +1,5 @@
-import { bound01 as s, pad2 as h } from "./util.js";
+/* 2025-10-28 09:57:10 */
+import { bound01 as s, pad2 as h } from "./utils.js";
 function A(n, r, t) {
   return {
     r: s(n, 255) * 255,

package/tinycolor/src/css-color-names.js

@@ -1,3 +1,4 @@
+/* 2025-10-28 09:57:10 */
 const e = {
   aliceblue: "#f0f8ff",
   antiquewhite: "#faebd7",

package/tinycolor/src/format-input.js

@@ -1,6 +1,7 @@
+/* 2025-10-28 09:57:10 */
 import { rgbToRgb as S, hsvToRgb as v, hslToRgb as E, cmykToRgb as F, convertHexToDecimal as A, parseIntFromHex as s } from "./conversion.js";
 import { names as R } from "./css-color-names.js";
-import { convertToPercentage as g, boundAlpha as T } from "./util.js";
+import { convertToPercentage as g, boundAlpha as T } from "./utils.js";
 function N(t) {
   let a = { r: 0, g: 0, b: 0 }, e = 1, m = null, b = null, p = null, r = !1, i = !1;
   return typeof t == "string" && (t = w(t)), typeof t == "object" && (n(t.r) && n(t.g) && n(t.b) ? (a = S(t.r, t.g, t.b), r = !0, i = String(t.r).slice(-1) === "%" ? "prgb" : "rgb") : n(t.h) && n(t.s) && n(t.v) ? (m = g(t.s), b = g(t.v), a = v(t.h, m, b), r = !0, i = "hsv") : n(t.h) && n(t.s) && n(t.l) ? (m = g(t.s), p = g(t.l), a = E(t.h, m, p), r = !0, i = "hsl") : n(t.c) && n(t.m) && n(t.y) && n(t.k) && (a = F(t.c, t.m, t.y, t.k), r = !0, i = "cmyk"), Object.prototype.hasOwnProperty.call(t, "a") && (e = t.a)), e = T(e), {

package/tinycolor/src/from-ratio.js

@@ -1,5 +1,6 @@
+/* 2025-10-28 09:57:10 */
 import { TinyColor as e } from "./index.js";
-import { convertToPercentage as o } from "./util.js";
+import { convertToPercentage as o } from "./utils.js";
 function c(n, m) {
   const r = {
     r: o(n.r),

package/tinycolor/src/index.js

@@ -1,7 +1,8 @@
+/* 2025-10-28 09:57:10 */
 import { numberInputToObject as d, rgbToHsv as g, rgbToHsl as u, rgbToHex as b, rgbaToHex as m, rgbToCmyk as c } from "./conversion.js";
 import { names as $ } from "./css-color-names.js";
 import { inputToRGB as f } from "./format-input.js";
-import { boundAlpha as M, clamp01 as a, bound01 as l } from "./util.js";
+import { boundAlpha as M, clamp01 as a, bound01 as l } from "./utils.js";
 class n {
   constructor(t = "", s = {}) {
     if (t instanceof n)

package/tinycolor/src/random.js

@@ -1,3 +1,4 @@
+/* 2025-10-28 09:57:10 */
 import { TinyColor as l } from "./index.js";
 function g(e = {}) {
   if (e.count !== void 0 && e.count !== null) {

package/tinycolor/src/readability.js

@@ -1,3 +1,4 @@
+/* 2025-10-28 09:57:10 */
 import { TinyColor as a } from "./index.js";
 function i(n, t) {
   const l = new a(n), e = new a(t);

package/tinycolor/src/to-ms-filter.js

@@ -1,3 +1,4 @@
+/* 2025-10-28 09:57:10 */
 import { rgbaToArgbHex as i } from "./conversion.js";
 import { TinyColor as g } from "./index.js";
 function d(s, o) {

package/tinycolor/src/{util.js → utils.js}

@@ -1,3 +1,4 @@
+/* 2025-10-28 09:57:10 */
 function o(t, r) {
   i(t) && (t = "100%");
   const e = n(t);

package/tinycolor.js

@@ -1,3 +1,4 @@
+/* 2025-10-28 09:57:10 */
 import { cmykToRgb as e, convertDecimalToHex as t, convertHexToDecimal as a, hslToRgb as n, hsvToRgb as b, numberInputToObject as m, parseIntFromHex as T, rgbToCmyk as i, rgbToHex as g, rgbToHsl as p, rgbToHsv as l, rgbToRgb as s, rgbaToArgbHex as x, rgbaToHex as c } from "./tinycolor/src/conversion.js";
 import { names as f } from "./tinycolor/src/css-color-names.js";
 import { inputToRGB as u, isValidCSSUnit as H, stringInputToObject as y } from "./tinycolor/src/format-input.js";
@@ -6,7 +7,7 @@ import { TinyColor as O, TinyColor as P } from "./tinycolor/src/index.js";
 import { bounds as k, random as A } from "./tinycolor/src/random.js";
 import { isReadable as F, mostReadable as S, readability as B } from "./tinycolor/src/readability.js";
 import { toMsFilter as M } from "./tinycolor/src/to-ms-filter.js";
-import { bound01 as V, boundAlpha as Z, clamp01 as q, convertToPercentage as w, isOnePointZero as z, isPercentage as E, pad2 as J } from "./tinycolor/src/util.js";
+import { bound01 as V, boundAlpha as Z, clamp01 as q, convertToPercentage as w, isOnePointZero as z, isPercentage as E, pad2 as J } from "./tinycolor/src/utils.js";
 export {
   O as TinyColor,
   V as bound01,

package/tree/index.js

@@ -1,88 +1,92 @@
-import { default as I } from "./search/index.js";
-function a(e, r, f, l = "children") {
-  if (Array.isArray(e) && (e = {
-    [l]: e
-  }), !(e && typeof e == "object")) return null;
-  if (r in e && e[r] === f)
-    return e;
-  const t = e[l] ?? e.items ?? e.list;
-  if (Array.isArray(t))
-    for (let i of t) {
-      const n = a(i, r, f, l);
-      if (n)
-        return n;
+/* 2025-10-28 09:57:10 */
+import a from "lodash/castArray";
+import c from "lodash/isArray";
+import d from "lodash/isUndefined";
+import { default as A } from "./search/index.js";
+function g(t, n, r, l = "children") {
+  if (c(t) && (t = {
+    [l]: t
+  }), !(t && typeof t == "object")) return null;
+  if (n in t && t[n] === r)
+    return t;
+  const f = t[l] ?? t.items ?? t.list;
+  if (c(f))
+    for (let i of f) {
+      const e = g(i, n, r, l);
+      if (e)
+        return e;
     }
   return null;
 }
-function y(e, r, f, l = "children") {
-  if (!e) return;
-  let t = Array.isArray(e) ? [...e] : [e];
-  e: for (; t.length; ) {
-    let i = t.shift();
-    if (!i) continue e;
-    if (!Array.isArray(i)) {
-      if (i[r] === f)
-        return i;
-      let n = i[l] ?? i.items ?? i.list;
-      if (n === void 0)
+function h(t, n, r, l = "children", f = !0) {
+  if (!t) return;
+  let i = [...a(t)];
+  e: for (; i.length; ) {
+    let e = i.shift();
+    if (!e) continue e;
+    const u = e[n];
+    if (!c(e)) {
+      if (f ? u === r : u == r)
+        return e;
+      let s = e[l] ?? e.items ?? e.list;
+      if (d(s))
         continue e;
-      i = n;
+      e = s;
     }
-    t = t.concat(i);
+    i = i.concat(e);
   }
 }
-const d = a;
-function h(e, r, f, l = "children") {
-  if (!e) return;
-  const t = Array.isArray(e) ? [...e] : [e];
-  e: for (; t.length; ) {
-    let i = t.pop();
+function o(t, n, r, l = "children") {
+  if (!t) return;
+  const f = [...a(t)];
+  e: for (; f.length; ) {
+    let i = f.pop();
     if (!i) continue e;
-    if (!Array.isArray(i)) {
-      if (i[r] === f)
+    if (!c(i)) {
+      if (i[n] === r)
         return i;
-      let n = i[l] ?? i.items ?? i.list;
-      if (n === void 0)
+      let e = i[l] ?? i.items ?? i.list;
+      if (d(e))
         continue e;
-      i = n;
+      i = e;
     }
-    if (Array.isArray(i))
-      for (let n = 0, u = i.length; n < u; n++)
-        t.push(i[u - 1 - n]);
+    if (c(i))
+      for (let e = 0, u = i.length; e < u; e++)
+        f.push(i[u - 1 - e]);
   }
 }
-function A(e, r) {
-  return y(e, "id", r);
+function I(t, n) {
+  return h(t, "id", n);
 }
-function m(e, r, f = !0) {
-  let l = y(e, "value", r)?.label;
-  return !l && f && (l = r), l;
+function b(t, n, r = !0) {
+  let l = h(t, "value", n)?.label;
+  return !l && r && (l = n), l;
 }
-function g(e, r, f, l = "children") {
-  if (!e) return;
-  let t = null;
-  function i(n) {
-    if (!n) return;
-    let u = Array.isArray(n) ? n : n[l] ?? n.items ?? n.list ?? [];
+function x(t, n, r, l = "children") {
+  if (!t) return;
+  let f = null;
+  function i(e) {
+    if (!e) return;
+    let u = c(e) ? e : e[l] ?? e.items ?? e.list ?? [];
     for (let s = 0; s < u.length; s++) {
-      const c = u[s];
-      if (c?.[r] === f) {
-        t = { item: c, parent: n, index: s };
+      const m = u[s];
+      if (m?.[n] === r) {
+        f = { item: m, parent: e, index: s };
         return;
       }
-      i(c);
+      i(m);
     }
   }
-  return i(e), t;
+  return i(t), f;
 }
 export {
-  y as default,
-  a as findNodeBy,
-  g as getChildWithParentBy,
-  y as getItemBy,
-  d as getItemBy2,
-  h as getItemBy3,
-  A as getItemByID,
-  m as getLabelFromDictionaryByValue,
-  I as searchTree
+  h as default,
+  g as findNodeBy,
+  x as getChildWithParentBy,
+  h as getItemBy,
+  o as getItemBy2,
+  g as getItemBy3,
+  I as getItemByID,
+  b as getLabelFromDictionaryByValue,
+  A as searchTree
 };