@unicom-cloud/utils 0.1.16 → 0.1.18

package/types/pinyin/src/traditional_dict.d.ts

@@ -0,0 +1,401 @@
+export namespace dict {
+    let yi: string;
+    let ding: string;
+    let zheng: string;
+    let kao: string;
+    let yu: string;
+    let qi: string;
+    let shang: string;
+    let xia: string;
+    let mo: string;
+    let wan: string;
+    let zhang: string;
+    let san: string;
+    let ji: string;
+    let bu: string;
+    let dun: string;
+    let fou: string;
+    let fu: string;
+    let mian: string;
+    let gai: string;
+    let chou: string;
+    let zhuan: string;
+    let cu: string;
+    let ju: string;
+    let qie: string;
+    let pi: string;
+    let shi: string;
+    let qiu: string;
+    let bing: string;
+    let ye: string;
+    let cong: string;
+    let dong: string;
+    let si: string;
+    let cheng: string;
+    let sheng: string;
+    let diu: string;
+    let liang: string;
+    let you: string;
+    let yan: string;
+    let ban: string;
+    let bang: string;
+    let sang: string;
+    let gun: string;
+    let shu: string;
+    let jiu: string;
+    let gan: string;
+    let ge: string;
+    let ya: string;
+    let zhuang: string;
+    let zhong: string;
+    let jie: string;
+    let feng: string;
+    let guan: string;
+    let kuang: string;
+    let chuan: string;
+    let chan: string;
+    let lin: string;
+    let zhuo: string;
+    let dian: string;
+    let zhu: string;
+    let ha: string;
+    let dan: string;
+    let wei: string;
+    let jing: string;
+    let li: string;
+    let pie: string;
+    let ai: string;
+    let nai: string;
+    let wu: string;
+    let tuo: string;
+    let zhe: string;
+    let ma: string;
+    let me: string;
+    let yao: string;
+    let xi: string;
+    let zhi: string;
+    let zha: string;
+    let zuo: string;
+    let hu: string;
+    let fa: string;
+    let le: string;
+    let luo: string;
+    let yue: string;
+    let pan: string;
+    let yin: string;
+    let ping: string;
+    let pang: string;
+    let jiao: string;
+    let qiao: string;
+    let guai: string;
+    let jue: string;
+    let mie: string;
+    let nie: string;
+    let xiang: string;
+    let dou: string;
+    let nang: string;
+    let mai: string;
+    let luan: string;
+    let ru: string;
+    let xue: string;
+    let sha: string;
+    let na: string;
+    let qian: string;
+    let cui: string;
+    let gui: string;
+    let liao: string;
+    let zi: string;
+    let er: string;
+    let chu: string;
+    let xu: string;
+    let kui: string;
+    let yun: string;
+    let sui: string;
+    let gen: string;
+    let xuan: string;
+    let geng: string;
+    let e: string;
+    let suo: string;
+    let xie: string;
+    let zhai: string;
+    let tou: string;
+    let wen: string;
+    let wang: string;
+    let gang: string;
+    let kang: string;
+    let da: string;
+    let hai: string;
+    let heng: string;
+    let peng: string;
+    let mu: string;
+    let ting: string;
+    let qin: string;
+    let qing: string;
+    let bo: string;
+    let zhan: string;
+    let lian: string;
+    let duo: string;
+    let men: string;
+    let ren: string;
+    let shen: string;
+    let ze: string;
+    let jin: string;
+    let nu: string;
+    let pu: string;
+    let ba: string;
+    let fo: string;
+    let tao: string;
+    let lun: string;
+    let cang: string;
+    let chuang: string;
+    let zai: string;
+    let ta: string;
+    let xian: string;
+    let cha: string;
+    let hong: string;
+    let tong: string;
+    let han: string;
+    let dai: string;
+    let ling: string;
+    let chao: string;
+    let chang: string;
+    let sa: string;
+    let fan: string;
+    let miao: string;
+    let ang: string;
+    let yang: string;
+    let bi: string;
+    let wo: string;
+    let jian: string;
+    let mou: string;
+    let jia: string;
+    let bin: string;
+    let fen: string;
+    let di: string;
+    let fang: string;
+    let pei: string;
+    let diao: string;
+    let xin: string;
+    let xiu: string;
+    let tang: string;
+    let huo: string;
+    let hui: string;
+    let kuai: string;
+    let kuo: string;
+    let zu: string;
+    let che: string;
+    let chen: string;
+    let xun: string;
+    let bai: string;
+    let gu: string;
+    let ni: string;
+    let zhou: string;
+    let qu: string;
+    let ci: string;
+    let beng: string;
+    let ga: string;
+    let chi: string;
+    let tian: string;
+    let tan: string;
+    let qia: string;
+    let shao: string;
+    let zhao: string;
+    let ben: string;
+    let ti: string;
+    let he: string;
+    let she: string;
+    let tu: string;
+    let die: string;
+    let gou: string;
+    let kou: string;
+    let ning: string;
+    let yong: string;
+    let wa: string;
+    let ka: string;
+    let bao: string;
+    let huai: string;
+    let lao: string;
+    let ming: string;
+    let hen: string;
+    let quan: string;
+    let tiao: string;
+    let xiao: string;
+    let xing: string;
+    let kan: string;
+    let lai: string;
+    let hua: string;
+    let kua: string;
+    let guang: string;
+    let lie: string;
+    let mi: string;
+    let an: string;
+    let lu: string;
+    let mao: string;
+    let gong: string;
+    let cun: string;
+    let lv: string;
+    let zhen: string;
+    let ce: string;
+    let chai: string;
+    let nong: string;
+    let hou: string;
+    let jiong: string;
+    let tui: string;
+    let nan: string;
+    let bian: string;
+    let pian: string;
+    let chuo: string;
+    let ku: string;
+    let jun: string;
+    let shun: string;
+    let lang: string;
+    let hun: string;
+    let ying: string;
+    let su: string;
+    let dao: string;
+    let lia: string;
+    let pai: string;
+    let biao: string;
+    let fei: string;
+    let bei: string;
+    let zong: string;
+    let chui: string;
+    let zhui: string;
+    let kong: string;
+    let juan: string;
+    let song: string;
+    let cai: string;
+    let ruan: string;
+    let chong: string;
+    let chun: string;
+    let re: string;
+    let ruo: string;
+    let dang: string;
+    let huang: string;
+    let zou: string;
+    let duan: string;
+    let ou: string;
+    let zan: string;
+    let liu: string;
+    let lou: string;
+    let sou: string;
+    let yuan: string;
+    let rong: string;
+    let jiang: string;
+    let hao: string;
+    let shan: string;
+    let que: string;
+    let nuo: string;
+    let ca: string;
+    let can: string;
+    let lei: string;
+    let cao: string;
+    let zao: string;
+    let shuang: string;
+    let ao: string;
+    let piao: string;
+    let man: string;
+    let lan: string;
+    let zun: string;
+    let cuan: string;
+    let deng: string;
+    let teng: string;
+    let tie: string;
+    let ceng: string;
+    let seng: string;
+    let zen: string;
+    let min: string;
+    let sai: string;
+    let tai: string;
+    let meng: string;
+    let qiong: string;
+    let la: string;
+    let du: string;
+    let long: string;
+    let rang: string;
+    let xiong: string;
+    let dui: string;
+    let rui: string;
+    let ke: string;
+    let nei: string;
+    let shou: string;
+    let ran: string;
+    let gua: string;
+    let mei: string;
+    let zhun: string;
+    let cou: string;
+    let kai: string;
+    let guo: string;
+    let bie: string;
+    let pao: string;
+    let shua: string;
+    let cuo: string;
+    let pou: string;
+    let tuan: string;
+    let qiang: string;
+    let zuan: string;
+    let keng: string;
+    let gao: string;
+    let weng: string;
+    let pin: string;
+    let nao: string;
+    let za: string;
+    let zang: string;
+    let suan: string;
+    let nian: string;
+    let shuai: string;
+    let kun: string;
+    let mang: string;
+    let zui: string;
+    let rou: string;
+    let cen: string;
+    let pa: string;
+    let po: string;
+    let a: string;
+    let tun: string;
+    let pen: string;
+    let hang: string;
+    let ne: string;
+    let wai: string;
+    let n: string;
+    let dei: string;
+    let yo: string;
+    let o: string;
+    let sao: string;
+    let shuo: string;
+    let en: string;
+    let huan: string;
+    let nou: string;
+    let ken: string;
+    let chuai: string;
+    let se: string;
+    let sun: string;
+    let hei: string;
+    let dia: string;
+    let de: string;
+    let zhuai: string;
+    let nin: string;
+    let qun: string;
+    let ri: string;
+    let zeng: string;
+    let nv: string;
+    let nuan: string;
+    let niu: string;
+    let rao: string;
+    let shui: string;
+    let nve: string;
+    let nen: string;
+    let niao: string;
+    let kuan: string;
+    let shuan: string;
+    let zhua: string;
+    let sen: string;
+    let shai: string;
+    let run: string;
+    let neng: string;
+    let miu: string;
+    let gei: string;
+    let zei: string;
+}
+export default traditional;
+declare namespace traditional { }

package/types/pinyin/traditional.d.ts

@@ -0,0 +1 @@
+export { default } from "./src/traditional";

package/types/query-string/base.d.ts

@@ -0,0 +1,11 @@
+export function extract(input: any): any;
+export function parse(query: any, options: any): any;
+export function stringify(object: any, options: any): string;
+export function parseUrl(url: any, options: any): {
+    fragmentIdentifier?: any;
+    url: string;
+    query: any;
+};
+export function stringifyUrl(object: any, options: any): string;
+export function pick(input: any, filter: any, options: any): string;
+export function exclude(input: any, filter: any, options: any): string;

package/types/query-string/index.d.ts

@@ -0,0 +1,2 @@
+export default queryString;
+import * as queryString from './base.js';

package/types/query-string/splitOnFirst.d.ts

@@ -0,0 +1 @@
+export default function splitOnFirst(string: any, separator: any): string[];

package/types/random/index.d.ts

@@ -1,21 +1,4 @@
 declare namespace _default {
-    export { number };
-    export let natural: (min?: number, max?: number) => number;
-    export let integer: (min?: number, max?: number) => number;
-    export let float: (min: any, max: any) => number;
-    export function boolean(): boolean;
-    export function sex(): string;
-    export { sample as pick };
-    export { text };
-    export let ctitle: (min: any, max: any) => string;
-    export let cparagraph: (min: any, max: any) => string;
-    export let csentence: (min: any, max: any) => string;
-    export let cword: (pool: any, min: any, max: any, ...args: any[]) => string;
-    export { name };
-    export let cname: () => string;
-    export { web };
-    export let phone: () => string;
-    export { address };
     export function county(p: any): string;
     export function company(): string;
     export function project(): string;
@@ -26,15 +9,23 @@ declare namespace _default {
     export function id(): number;
     export function increment(step: any): number;
     export { image };
+    export { address };
+    export { web };
+    export { name };
+    export { text };
+    export function boolean(): boolean;
+    export function sex(): string;
+    export { sample as pick };
+    export { number };
 }
 export default _default;
-import number from './number';
-import sample from 'lodash/sample';
-import text from './text';
-import name from './name';
-import web from './web';
-import address from './address';
 import time from './time';
 import constellation from './constellation';
 import licensePlate from './licensePlate';
 import image from './image';
+import address from './address';
+import web from './web';
+import name from './name';
+import text from './text';
+import sample from 'lodash/sample';
+import number from './number';

package/types/snapdom/src/api/preCache.d.ts

@@ -1,8 +1,5 @@
 /**
  * Preloads images, background images, and optionally fonts into cache before DOM capture.
- *
- * @param {Document|Element} [root=document] - The root node to search for resources
- * @param {Object} [options={}] - Pre-caching options
- * @returns {Promise<void>} Resolves when all resources are pre-cached
+ * Nunca deja promesas rechazadas sin manejar (evita unhandled rejections).
  */
-export function preCache(root?: Document | Element, options?: Object): Promise<void>;
+export function preCache(root?: Document, options?: {}): Promise<void>;

package/types/snapdom/src/core/cache.d.ts

@@ -8,9 +8,6 @@ export namespace cache {
     export let font: Set<any>;
     export let snapshot: WeakMap<WeakKey, any>;
     export let snapshotKey: Map<any, any>;
-    export let preStyleMap: Map<any, any>;
-    export let preStyle: WeakMap<WeakKey, any>;
-    export let preNodeMap: Map<any, any>;
     export { resetCache as reset };
 }
 declare function resetCache(): void;

package/types/snapdom/src/core/clone.d.ts

@@ -7,4 +7,4 @@
  * @param {Node} [originalRoot] - Original root element being captured
  * @returns {Node|null} Cloned node with styles and shadow DOM content, or null for empty text nodes or filtered elements
  */
-export function deepClone(node: Node, compress: boolean, options?: Object, originalRoot?: Node): Node | null;
+export function deepClone(node: Node, styleMap: any, styleCache: any, nodeMap: any, compress: boolean, options?: Object, originalRoot?: Node): Node | null;

package/types/snapdom/src/modules/background.d.ts

@@ -1,9 +1,19 @@
 /**
- * Converts all background images in the cloned element tree to data URLs.
+ * Recursively inlines background-related images and masks from the source element to its clone.
  *
- * @param {Element} source - Original element
- * @param {Element} clone - Cloned element
- * @param {Object} [options={}] - Options for image processing
- * @returns {Promise<void>} Promise that resolves when all background images are processed
+ * This function walks through the source DOM tree and its clone, copying inline styles for
+ * background images, masks, and border images to ensure the clone retains all visual image
+ * resources inline (e.g., data URLs), avoiding external dependencies.
+ *
+ * It also preserves the `background-color` property if it is not transparent.
+ *
+ * Special handling is done for `border-image` related properties: the
+ * `border-image-slice`, `border-image-width`, `border-image-outset`, and `border-image-repeat`
+ * are only copied if `border-image` or `border-image-source` are present and active.
+ *
+ * @param {HTMLElement} source The original source element from which styles are read.
+ * @param {HTMLElement} clone The cloned element to which inline styles are applied.
+ * @param {Object} [options={}] Optional parameters passed to image inlining functions.
+ * @returns {Promise<void>} Resolves when all inlining operations (including async image fetches) complete.
  */
-export function inlineBackgroundImages(source: Element, clone: Element, options?: Object): Promise<void>;
+export function inlineBackgroundImages(source: HTMLElement, clone: HTMLElement, styleCache: any, options?: Object): Promise<void>;

package/types/snapdom/src/modules/fonts.d.ts

@@ -16,8 +16,12 @@ export function iconToImage(unicodeChar: string, fontFamily: string, fontWeight:
  * @export
  * @param {Object} options
  * @param {boolean} [options.preCached=false] - Whether to use pre-cached resources
+ * @param {Object} [options.localFonts=[]] - Additional local fonts to embed
+ * @param {string} [options.useProxy=''] - Optional proxy for font fetching
  * @returns {Promise<string>} The inlined CSS for custom fonts
  */
-export function embedCustomFonts({ preCached }?: {
+export function embedCustomFonts({ preCached, localFonts, useProxy, }?: {
     preCached?: boolean | undefined;
+    localFonts?: Object | undefined;
+    useProxy?: string | undefined;
 }): Promise<string>;

package/types/snapdom/src/modules/pseudo.d.ts

@@ -7,4 +7,4 @@
  * @param {boolean} embedFonts - Whether to embed icon fonts as images
  * @returns {Promise} Promise that resolves when all pseudo-elements are processed
  */
-export function inlinePseudoElements(source: Element, clone: Element, options: any): Promise<any>;
+export function inlinePseudoElements(source: Element, clone: Element, styleMap: any, styleCache: any, options: any): Promise<any>;

package/types/snapdom/src/modules/styles.d.ts

@@ -1 +1 @@
-export function inlineAllStyles(source: any, clone: any, compress: any): void;
+export function inlineAllStyles(source: any, clone: any, styleMap: any, cache: any, compress: any): void;

package/types/snapdom/src/modules/svgDefs.d.ts

@@ -1,19 +1,19 @@
 /**
- * Inlines external `<defs>` used by `<use xlink:href="#...">` or `<use href="#...">` inside SVGs,
- * copying only the necessary definitions into each individual cloned SVG.
+ * Ensures that all external <symbol> or <defs> elements referenced by <use>
+ * inside the given root element are inlined into it.
  *
- * This is needed because cloned SVGs using `<use>` may reference elements like `<symbol>`, `<path>`, etc.,
- * defined elsewhere in the document (e.g., in a shared `<defs>` block that is not part of the cloned subtree).
+ * This is necessary when capturing or exporting an SVG fragment that relies on
+ * definitions existing elsewhere in the document, ensuring it remains
+ * self-contained and renders correctly.
  *
- * The function finds all `<use>` elements within `root`, extracts the referenced IDs,
- * and embeds the required definitions at the top of each SVG.
+ * Process:
+ * 1. Collect all IDs referenced by <use> elements in the root.
+ * 2. Look up those IDs in the global document (outside the root).
+ * 3. Create or reuse a hidden <svg> container inside the root to hold inlined defs.
+ * 4. Only insert missing <symbol>/<defs> elements that are not already present.
  *
- * @function inlineExternalDef
- * @param {ParentNode} root - The root node containing cloned SVGs (usually the result of a DOM snapshot).
- * @returns {void}
+ * Existing definitions in the root are never modified or removed.
  *
- * @example
- * const { clone } = await prepareClone(element);
- * inlineExternalDef(clone);
+ * @param {HTMLElement} rootElement - The root element being processed (typically the cloned DOM fragment).
  */
-export function inlineExternalDef(root: ParentNode): void;
+export function inlineExternalDefsAndSymbols(rootElement: HTMLElement): void;

package/types/snapdom/src/utils/cssTools.d.ts

@@ -6,15 +6,7 @@ export function precacheCommonTags(): void;
  * @returns {Object} Object containing default values for all CSS properties
  */
 export function getDefaultStyleForTag(tagName: string): Object;
-/**
- * Creates a unique key from an element's computed style that differs from defaults.
- *
- * @param {Object} snapshot - Computed style snapshot
- * @param {string} tagName - The tag name of the element
- * @param {boolean} [compress=false] - Whether to compress style keys
- * @returns {string} Semi-colon separated list of non-default properties
- */
-export function getStyleKey(snapshot: Object, tagName: string, compress?: boolean): string;
+export function getStyleKey(snapshot: any, tagName: any, compress?: boolean): string;
 /**
  * Collects all unique tag names used in the DOM tree rooted at the given node.
  *
@@ -34,4 +26,4 @@ export function generateDedupedBaseCSS(usedTagNames: string[]): string;
  *
  * @returns {Map} Map of style keys to class names
  */
-export function generateCSSClasses(): Map<any, any>;
+export function generateCSSClasses(styleMap: any): Map<any, any>;

package/types/snapdom/src/utils/helpers.d.ts

@@ -49,14 +49,20 @@ export function extractURL(value: string): string | null;
  */
 export function isIconFont(familyOrUrl: string): boolean;
 /**
- *
- *
- * @export
- * @param {*} src
- * @param {number} [timeout=3000]
- * @return {*}
+ * Fetch a resource with optional proxy fallback.
+ * @param {string} url - Resource URL
+ * @param {Object} [options]
+ * @param {string} [options.useProxy=''] - Proxy prefix
+ * @returns {Promise<Response>} The fetched response
  */
-export function fetchImage(src: any, { timeout, useProxy }?: number): any;
+export function fetchResource(url: string, { useProxy }?: {
+    useProxy?: string | undefined;
+}): Promise<Response>;
+export function fetchImage(src: any, { timeout, useProxy, errorTTL }?: {
+    timeout?: number | undefined;
+    useProxy?: string | undefined;
+    errorTTL?: number | undefined;
+}): any;
 /**
  *
  *

package/types/turbo-stream/src/shared.d.ts

@@ -80,11 +80,11 @@ export declare class TurboBlob extends Blob {
     text(): Promise<string>;
 }
 declare const FileBaseClass: {
-    new (fileBits: BlobPart[], fileName: string, options?: FilePropertyBag): File;
-    prototype: File;
-} | {
     new (blobParts?: BlobPart[], options?: BlobPropertyBag): Blob;
     prototype: Blob;
+} | {
+    new (fileBits: BlobPart[], fileName: string, options?: FilePropertyBag): File;
+    prototype: File;
 };
 export declare class TurboFile extends FileBaseClass {
     #private;

package/url-toolkit/src/url-toolkit.d.ts

@@ -0,0 +1,22 @@
+export as namespace URLToolkit;
+
+export type URLParts = {
+  scheme: string;
+  netLoc: string;
+  path: string;
+  params: string;
+  query: string;
+  fragment: string;
+};
+
+export function buildAbsoluteURL(
+  baseURL: string,
+  relativeURL: string,
+  opts?: { alwaysNormalize?: boolean },
+): string;
+
+export function parseURL(url: string): URLParts | null;
+
+export function normalizePath(path: string): string;
+
+export function buildURLFromParts(parts: URLParts): string;