@unicom-cloud/utils 0.1.16 → 0.1.17

package/types/js-cookie/index.d.ts

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

package/types/js-cookie/src/api.d.mts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/types/js-cookie/src/assign.d.mts

@@ -0,0 +1 @@
+export default function _default(target: any, ...args: any[]): any;

package/types/js-cookie/src/converter.d.mts

@@ -0,0 +1,5 @@
+declare namespace _default {
+    function read(value: any): any;
+    function write(value: any): string;
+}
+export default _default;

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;